{"version":3,"file":"eventBus-TFTcHo0F.mjs","names":["_on: InternalOn","_dispatch: InternalDispatch","_off: InternalOff","emit: EventBus['emit']"],"sources":["../../src/eventBus.ts"],"sourcesContent":["/**\n * Type definition for event handler functions\n */\ntype EventHandler, Key extends keyof Events> = (payload: Events[Key]) => void;\n\n/**\n * @interface\n * Strongly-typed event bus interface that enables type-safe publish/subscribe patterns\n */\ntype EventBus> = {\n /**\n * Subscribe to an event\n *\n * @param event - The event name to subscribe to\n * @param handler - The callback function to execute when the event is dispatched\n * @param opts - Optional configuration\n * @param opts.notify - If true and the event was previously dispatched, handler will be called immediately with the latest payload\n * @returns void\n */\n on: (\n event: Event,\n handler: EventHandler,\n opts?: { notify?: boolean },\n ) => void;\n\n /**\n * Subscribe to an event with pre-dispatch priority\n * Pre-dispatch handlers are called before regular event handlers when an event is dispatched\n *\n * @param event - The event name to subscribe to\n * @param handler - The callback function to execute when the event is dispatched\n * @returns void\n */\n prioritizedOn: (event: Event, handler: EventHandler) => void;\n\n /**\n * Publish an event with a payload\n * Triggers all registered handlers for the event\n *\n * @param event - The event name to publish\n * @param payload - The data to pass to event handlers\n * @returns void\n */\n emit: (event: Event, payload: Events[Event]) => void;\n\n /**\n * Unsubscribe from an event\n *\n * @param event - The event name to unsubscribe from\n * @param handler - Optional specific handler to remove. If omitted, all handlers for the event are removed\n * @returns void\n */\n off: (event: Event, handler?: EventHandler) => void;\n\n /**\n * Unsubscribe from a pre-dispatch event\n *\n * @param event - The event name to unsubscribe from\n * @param handler - Optional specific handler to remove. If omitted, all pre-dispatch handlers for the event are removed\n * @returns void\n */\n prioritizedOff: (event: Event, handler?: EventHandler) => void;\n\n /**\n * Internal utilities for the event bus\n */\n internal: {\n /**\n * Retrieve all listeners for a specific event\n *\n * @param event - The event name to get listeners for\n * @returns Array of handler functions\n */\n retrieveListeners: (event: Event) => Array<(...args: any[]) => void>;\n };\n};\n\n/**\n * @internal\n */\ntype InternalOn = , Event extends keyof Events>(\n eventToHandlersMap: Map void>>,\n latestPayloadMap: Map,\n event: Event,\n handler: EventHandler,\n opts?: { notify?: boolean },\n) => void;\n\n/**\n * @internal\n */\ntype InternalOff = , Event extends keyof Events>(\n eventToHandlersMap: Map void>>,\n event: Event,\n handler?: EventHandler,\n) => void;\n\n/**\n * @internal\n */\ntype InternalDispatch = , Event extends keyof Events>(\n eventToHandlersMap: Map void>>,\n event: Event,\n payload: Events[Event],\n) => void;\n\n/**\n * @internal\n */\nconst _on: InternalOn = (eventToHandlersMap, latestPayloadMap, event, handler, opts) => {\n const { notify } = opts || {};\n let handlers = eventToHandlersMap.get(event);\n\n if (!handlers) {\n handlers = [];\n eventToHandlersMap.set(event, handlers);\n }\n\n handlers.push(handler);\n\n if (notify && latestPayloadMap.has(event)) {\n handler(latestPayloadMap.get(event));\n }\n};\n\n/**\n * @internal\n */\nconst _dispatch: InternalDispatch = (eventToHandlersMap, event, payload) =>\n (eventToHandlersMap.get(event) || []).map(h => h(payload));\n\n/**\n * @internal\n */\nconst _off: InternalOff = (eventToHandlersMap, event, handler) => {\n const handlers = eventToHandlersMap.get(event);\n if (handlers) {\n if (handler) {\n handlers.splice(handlers.indexOf(handler) >>> 0, 1);\n } else {\n eventToHandlersMap.set(event, []);\n }\n }\n};\n\n/**\n * A ES6/2015 compatible 300 byte event bus\n *\n * Creates a strongly-typed event bus that enables publish/subscribe communication between components.\n *\n * @template Events - A record type that maps event names to their payload types\n *\n * @returns An EventBus instance with the following methods:\n * - `on`: Subscribe to an event\n * - `onPreDispatch`: Subscribe to an event, triggered before regular subscribers\n * - `emit`: Publish an event with payload\n * - `off`: Unsubscribe from an event\n * - `offPreDispatch`: Unsubscribe from a pre-dispatch event\n *\n * @example\n * // Define event types\n * const eventBus = createEventBus<{\n * 'user-login': { userId: string; timestamp: number };\n * 'data-updated': { records: any[] };\n * 'error': Error;\n * }>();\n *\n * // Subscribe to events\n * eventBus.on('user-login', ({ userId, timestamp }) => {\n * console.log(`User ${userId} logged in at ${timestamp}`);\n * });\n *\n * // Subscribe with immediate notification if event was already dispatched\n * eventBus.on('user-login', (payload) => {\n * // This will be called immediately if 'user-login' was previously dispatched\n * }, { notify: true });\n *\n * // Publish an event\n * eventBus.emit('user-login', { userId: 'abc123', timestamp: Date.now() });\n *\n * // Unsubscribe from event\n * const handler = (payload) => console.log(payload);\n * eventBus.on('error', handler);\n * // Later...\n * eventBus.off('error', handler);\n *\n * // Unsubscribe all handlers for an event\n * eventBus.off('data-updated');\n */\nexport const createEventBus = >(): EventBus => {\n const eventToHandlersMap = new Map void>>();\n const latestPayloadMap = new Map();\n const eventToPredispatchHandlersMap = new Map void>>();\n\n const emit: EventBus['emit'] = (event, payload) => {\n latestPayloadMap.set(event, payload);\n _dispatch(eventToPredispatchHandlersMap, event, payload);\n _dispatch(eventToHandlersMap, event, payload);\n };\n\n return {\n // Subscribe to an event\n on: (...args) => _on(eventToHandlersMap, latestPayloadMap, ...args),\n // Subscribe to an event with priority\n // Registered handlers with `prioritizedOn` will be called before handlers registered with `on`\n prioritizedOn: (...args) => _on(eventToPredispatchHandlersMap, latestPayloadMap, ...args),\n // Dispatch an event\n emit,\n // Unsubscribe from an event\n off: (...args) => _off(eventToHandlersMap, ...args),\n // Unsubscribe from an event with priority\n // Unsubscribes handlers only registered with `prioritizedOn`\n prioritizedOff: (...args) => _off(eventToPredispatchHandlersMap, ...args),\n\n // Internal utilities\n internal: {\n retrieveListeners: event => eventToHandlersMap.get(event) || [],\n },\n };\n};\n"],"mappings":";;;;AA6GA,MAAMA,OAAmB,oBAAoB,kBAAkB,OAAO,SAAS,SAAS;CACtF,MAAM,EAAE,WAAW,QAAQ,EAAE;CAC7B,IAAI,WAAW,mBAAmB,IAAI,MAAM;AAE5C,KAAI,CAAC,UAAU;AACb,aAAW,EAAE;AACb,qBAAmB,IAAI,OAAO,SAAS;;AAGzC,UAAS,KAAK,QAAQ;AAEtB,KAAI,UAAU,iBAAiB,IAAI,MAAM,CACvC,SAAQ,iBAAiB,IAAI,MAAM,CAAC;;;;;AAOxC,MAAMC,aAA+B,oBAAoB,OAAO,aAC7D,mBAAmB,IAAI,MAAM,IAAI,EAAE,EAAE,KAAI,MAAK,EAAE,QAAQ,CAAC;;;;AAK5D,MAAMC,QAAqB,oBAAoB,OAAO,YAAY;CAChE,MAAM,WAAW,mBAAmB,IAAI,MAAM;AAC9C,KAAI,SACF,KAAI,QACF,UAAS,OAAO,SAAS,QAAQ,QAAQ,KAAK,GAAG,EAAE;KAEnD,oBAAmB,IAAI,OAAO,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiDvC,MAAa,uBAAiF;CAC5F,MAAM,qCAAqB,IAAI,KAAoD;CACnF,MAAM,mCAAmB,IAAI,KAAwB;CACrD,MAAM,gDAAgC,IAAI,KAAoD;CAE9F,MAAMC,QAAkC,OAAO,YAAY;AACzD,mBAAiB,IAAI,OAAO,QAAQ;AACpC,YAAU,+BAA+B,OAAO,QAAQ;AACxD,YAAU,oBAAoB,OAAO,QAAQ;;AAG/C,QAAO;EAEL,KAAK,GAAG,SAAS,IAAI,oBAAoB,kBAAkB,GAAG,KAAK;EAGnE,gBAAgB,GAAG,SAAS,IAAI,+BAA+B,kBAAkB,GAAG,KAAK;EAEzF;EAEA,MAAM,GAAG,SAAS,KAAK,oBAAoB,GAAG,KAAK;EAGnD,iBAAiB,GAAG,SAAS,KAAK,+BAA+B,GAAG,KAAK;EAGzE,UAAU,EACR,oBAAmB,UAAS,mBAAmB,IAAI,MAAM,IAAI,EAAE,EAChE;EACF"}