smart-lifecycle 0.1.1

package/dist/events/action-publisher.interface.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Defines the responsibility of carrying action event data through publisher channels.
+ *
+ * @description
+ * Standardized payload sent through action channels when actions are triggered.
+ * Contains source element, unique identifier, and optional data attributes.
+ */
+export interface ActionEvent {
+    /** The HTML element that published the action */
+    source: HTMLElement;
+    /** Unique identifier for the action publisher */
+    actionId: string;
+    /** Event name/type being published */
+    eventName: string;
+    /** Additional data from data-* attributes or custom payload */
+    data: Record<string, unknown>;
+    /** Timestamp when action was triggered */
+    timestamp: number;
+}
+/**
+ * Defines the responsibility of publishing actions to dedicated channels.
+ *
+ * @description
+ * Publishers have their own isolated channel for event emission via EventBus.
+ * Lifecycle is automatically managed - channels are cleaned up via WeakMap
+ * when the publisher instance is garbage collected.
+ *
+ * Each publisher instance registers a callback with EventBus.
+ * Publishers emit events via EventBus.emitChannel().
+ * Subscribers register listeners via EventBus.registerChannel().
+ * No global broadcast - only targeted channel communication.
+ * WeakMap ensures automatic cleanup when publisher is destroyed.
+ *
+ * @example
+ * ```typescript
+ * // Publisher (SmartAction component):
+ * class SmartAction implements IActionPublisher {
+ *   publishAction(eventName: string, data?: unknown): void {
+ *     eventBus.emitChannel(this.actionId, {
+ *       source: this.hostElement,
+ *       actionId: this.actionId,
+ *       eventName,
+ *       data,
+ *       timestamp: Date.now()
+ *     });
+ *   }
+ * }
+ *
+ * // Subscriber (Lifecycle Manager):
+ * const unsub = eventBus.registerChannel<ActionEvent>(actionId, (event) => {
+ *   console.log('Action triggered:', event.eventName);
+ * });
+ * ```
+ */
+export interface IActionPublisher {
+    /**
+     * Unique identifier for this action publisher
+     * Used as channel key in EventBus routing
+     */
+    readonly actionId: string;
+    /**
+     * Publishes an action event to the channel
+     *
+     * @param eventName - Name of the event being published
+     * @param data - Optional payload data
+     */
+    publishAction(eventName: string, data?: unknown): void;
+}
+//# sourceMappingURL=action-publisher.interface.d.ts.map

package/dist/events/action-publisher.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-publisher.interface.d.ts","sourceRoot":"","sources":["../../src/events/action-publisher.interface.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,MAAM,EAAE,WAAW,CAAC;IACpB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;;;;OAKG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CACxD"}

package/dist/events/action-publisher.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=action-publisher.interface.js.map

package/dist/events/action-publisher.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-publisher.interface.js","sourceRoot":"","sources":["../../src/events/action-publisher.interface.ts"],"names":[],"mappings":""}

package/dist/events/event-bus.d.ts

@@ -0,0 +1,11 @@
+import type { IEventBus } from './event-bus.interface.js';
+/**
+ * Default EventBus singleton instance for convenience.
+ *
+ * @description
+ * Provides a ready-to-use IEventBus for consumers that do not use dependency injection.
+ * For DI-based architectures, prefer registering IEventBus through the Services container
+ * and resolving it via constructor injection.
+ */
+export declare const eventBus: IEventBus;
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/events/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/events/event-bus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAG1D;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,EAAE,SAA4B,CAAC"}

package/dist/events/event-bus.interface.d.ts

@@ -0,0 +1,66 @@
+import type { Unsubscribe } from '../reactive/signal.js';
+import { EventPayload } from './event-payload.js';
+/**
+ * Defines the responsibility of routing events through pub/sub and isolated channels.
+ *
+ * @description
+ * Minimal event emitter for pub/sub and isolated channels.
+ * Channels enable targeted communication between specific publishers and subscribers
+ * without global broadcast noise.
+ *
+ * Global events use traditional pub/sub via publish()/on().
+ * Channels provide isolated communication via registerChannel()/emitChannel().
+ * Object-keyed channels use WeakMap for automatic garbage collection.
+ * String-keyed channels use Map and require manual cleanup.
+ */
+export interface IEventBus {
+    /**
+     * Publishes a global event with payload
+     * @param type - Event type identifier
+     * @param data - Event payload data
+     */
+    publish<T = unknown>(type: string, data: T): void;
+    /**
+     * Subscribes to global events of a specific type
+     * @param type - Event type identifier
+     * @param listener - Callback invoked with event payload
+     * @returns Unsubscribe function to remove the listener
+     */
+    on<T = unknown>(type: string, listener: (payload: EventPayload<T>) => void): Unsubscribe;
+    /**
+     * Subscribes to all global events (debugging)
+     * @param listener - Callback invoked with all events
+     * @returns Unsubscribe function
+     */
+    all(listener: (payload: EventPayload) => void): Unsubscribe;
+    /**
+     * Registers a channel for isolated communication
+     * @param channelId - Unique identifier (string or object for WeakMap)
+     * @param listener - Callback invoked when channel emits
+     * @returns Unsubscribe function
+     */
+    registerChannel<T = unknown>(channelId: string | object, listener: (event: T) => void): Unsubscribe;
+    /**
+     * Emits on a channel (publish to specific channel)
+     * @param channelId - Unique identifier
+     * @param event - Event payload
+     */
+    emitChannel<T = unknown>(channelId: string | object, event: T): void;
+    /**
+     * Checks if a channel has listeners
+     * @param channelId - Unique identifier
+     * @returns True if channel has listeners
+     */
+    hasChannel(channelId: string | object): boolean;
+    /**
+     * Unregisters all listeners on a channel (cleanup for string-keyed channels)
+     * @param channelId - Unique identifier
+     */
+    unregisterChannel(channelId: string | object): void;
+    /**
+     * Disposes of the event bus (clears all listeners)
+     */
+    dispose(): void;
+}
+export declare const EVENT_BUS_TOKEN: "IEventBus";
+//# sourceMappingURL=event-bus.interface.d.ts.map

package/dist/events/event-bus.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.interface.d.ts","sourceRoot":"","sources":["../../src/events/event-bus.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,SAAS;IACxB;;;;OAIG;IACH,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IAElD;;;;;OAKG;IACH,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,WAAW,CAAC;IAEzF;;;;OAIG;IACH,GAAG,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,GAAG,WAAW,CAAC;IAE5D;;;;;OAKG;IACH,eAAe,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,WAAW,CAAC;IAEpG;;;;OAIG;IACH,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IAErE;;;;OAIG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAEhD;;;OAGG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAEpD;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,eAAO,MAAM,eAAe,EAAG,WAAoB,CAAC"}

package/dist/events/event-bus.interface.js

@@ -0,0 +1,2 @@
+export const EVENT_BUS_TOKEN = 'IEventBus';
+//# sourceMappingURL=event-bus.interface.js.map

package/dist/events/event-bus.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.interface.js","sourceRoot":"","sources":["../../src/events/event-bus.interface.ts"],"names":[],"mappings":"AAyEA,MAAM,CAAC,MAAM,eAAe,GAAG,WAAoB,CAAC"}

package/dist/events/event-bus.js

@@ -0,0 +1,11 @@
+import { RxEventBus } from './rx-event-bus.js';
+/**
+ * Default EventBus singleton instance for convenience.
+ *
+ * @description
+ * Provides a ready-to-use IEventBus for consumers that do not use dependency injection.
+ * For DI-based architectures, prefer registering IEventBus through the Services container
+ * and resolving it via constructor injection.
+ */
+export const eventBus = new RxEventBus();
+//# sourceMappingURL=event-bus.js.map

package/dist/events/event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.js","sourceRoot":"","sources":["../../src/events/event-bus.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAc,IAAI,UAAU,EAAE,CAAC"}

package/dist/events/event-object.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Implements the responsibility of providing a base event record for the EventStore.
+ *
+ * @description
+ * Events are immutable records of things that happened.
+ * Each event has a unique identifier, a type, a timestamp, and a typed payload.
+ */
+export declare abstract class EventObject<T = unknown> {
+    /**
+     * Unique identifier for this event
+     */
+    readonly id: string;
+    /**
+     * Event type identifier
+     */
+    abstract readonly type: string;
+    /**
+     * Timestamp when event was created
+     */
+    readonly timestamp: number;
+    /**
+     * Event payload data
+     */
+    readonly payload: T;
+    /**
+     * Initializes a new EventObject with the given payload.
+     *
+     * @param payload - Event data to store
+     * @throws Error if payload is null or undefined
+     */
+    constructor(payload: T);
+}
+//# sourceMappingURL=event-object.d.ts.map

package/dist/events/event-object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-object.d.ts","sourceRoot":"","sources":["../../src/events/event-object.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,8BAAsB,WAAW,CAAC,CAAC,GAAG,OAAO;IAC3C;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IAEpB;;;;;OAKG;gBACS,OAAO,EAAE,CAAC;CAOvB"}

package/dist/events/event-object.js

@@ -0,0 +1,35 @@
+/**
+ * Implements the responsibility of providing a base event record for the EventStore.
+ *
+ * @description
+ * Events are immutable records of things that happened.
+ * Each event has a unique identifier, a type, a timestamp, and a typed payload.
+ */
+export class EventObject {
+    /**
+     * Unique identifier for this event
+     */
+    id;
+    /**
+     * Timestamp when event was created
+     */
+    timestamp;
+    /**
+     * Event payload data
+     */
+    payload;
+    /**
+     * Initializes a new EventObject with the given payload.
+     *
+     * @param payload - Event data to store
+     * @throws Error if payload is null or undefined
+     */
+    constructor(payload) {
+        if (payload === null || payload === undefined)
+            throw new Error('payload is required');
+        this.id = `${Date.now()}-${Math.random().toString(36).substring(2, 11)}`;
+        this.timestamp = Date.now();
+        this.payload = payload;
+    }
+}
+//# sourceMappingURL=event-object.js.map

package/dist/events/event-object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-object.js","sourceRoot":"","sources":["../../src/events/event-object.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,OAAgB,WAAW;IAC/B;;OAEG;IACM,EAAE,CAAS;IAOpB;;OAEG;IACM,SAAS,CAAS;IAE3B;;OAEG;IACM,OAAO,CAAI;IAEpB;;;;;OAKG;IACH,YAAY,OAAU;QACpB,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QAEtF,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QACzE,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF"}

package/dist/events/event-payload.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Defines the responsibility of carrying typed event data through the EventBus system.
+ *
+ * @description
+ * Standardized structure for events in the EventBus system.
+ * Contains event type, data payload, and timestamp for debugging.
+ */
+export interface EventPayload<T = unknown> {
+    /** Event type identifier (e.g., 'user:login', 'task:created') */
+    type: string;
+    /** Event data payload */
+    data: T;
+    /** Timestamp when event was created (Date.now()) */
+    timestamp: number;
+}
+//# sourceMappingURL=event-payload.d.ts.map

package/dist/events/event-payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-payload.d.ts","sourceRoot":"","sources":["../../src/events/event-payload.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACvC,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,IAAI,EAAE,CAAC,CAAC;IACR,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/events/event-payload.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=event-payload.js.map

package/dist/events/event-payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-payload.js","sourceRoot":"","sources":["../../src/events/event-payload.ts"],"names":[],"mappings":""}

package/dist/events/event-store.d.ts

@@ -0,0 +1,99 @@
+import { type Unsubscribe } from '../reactive/signal.js';
+import type { IEventBus } from './event-bus.interface.js';
+import { EventObject } from './event-object.js';
+/**
+ * Defines the responsibility of publishing events (write-only).
+ */
+export interface EventPublisher {
+    /**
+     * Publishes an event to the store.
+     *
+     * @param event - Domain event to publish
+     */
+    publish(event: EventObject): void;
+}
+/**
+ * Defines the responsibility of subscribing to events (read-only).
+ */
+export interface EventSubscriber {
+    /**
+     * Subscribes to events of a specific type.
+     *
+     * @param eventType - Event type identifier
+     * @param listener - Callback invoked with typed events
+     * @returns Unsubscribe function
+     */
+    on<T extends EventObject>(eventType: string, listener: (event: T) => void): Unsubscribe;
+    /**
+     * Gets all events from history.
+     *
+     * @returns Readonly array of stored events
+     */
+    getHistory(): ReadonlyArray<EventObject>;
+}
+/**
+ * Implements the responsibility of storing and broadcasting domain events.
+ *
+ * @description
+ * Single source of truth for all events in the application.
+ * Events are immutable and append-only, enabling replay and time-travel debugging.
+ *
+ * @example
+ * ```typescript
+ * serviceProvider.register(EventStore, () =>
+ *   new EventStore(serviceProvider.get(EVENT_BUS_TOKEN))
+ * );
+ * ```
+ */
+export declare class EventStore implements EventPublisher, EventSubscriber {
+    private readonly eventBus?;
+    private events;
+    constructor(eventBus?: IEventBus | undefined);
+    /**
+     * Publishes an event to the store and broadcasts to all subscribers.
+     *
+     * @param event - Domain event to publish
+     * @throws Error if event is null or undefined
+     */
+    publish(event: EventObject): void;
+    /**
+     * Subscribes to events of a specific type with a callback listener.
+     *
+     * @param eventType - Event type identifier
+     * @param listener - Callback invoked with typed events
+     * @returns Unsubscribe function
+     * @throws Error if eventType or listener is null or undefined
+     * @throws Error if IEventBus was not injected
+     */
+    on<T extends EventObject>(eventType: string, listener: (event: T) => void): Unsubscribe;
+    /**
+     * Get complete event history.
+     * Useful for debugging, time-travel, and DevTools.
+     */
+    getHistory(): ReadonlyArray<EventObject>;
+    /**
+     * Replay events from a specific timestamp.
+     * Returns events that occurred after the given timestamp.
+     * Useful for time-travel debugging.
+     */
+    replay(fromTimestamp?: number): ReadonlyArray<EventObject>;
+    /**
+     * Get count of stored events.
+     */
+    get size(): number;
+    /**
+     * Clear all events (testing only).
+     * @internal
+     */
+    clear(): void;
+}
+/**
+ * Default EventStore singleton instance for convenience.
+ *
+ * @description
+ * Provides a ready-to-use EventStore for consumers that do not use dependency injection.
+ * For DI-based architectures, prefer registering EventStore through the Services container
+ * and injecting IEventBus via the constructor.
+ */
+export declare const eventStore: EventStore;
+//# sourceMappingURL=event-store.d.ts.map

package/dist/events/event-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-store.d.ts","sourceRoot":"","sources":["../../src/events/event-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;OAMG;IACH,EAAE,CAAC,CAAC,SAAS,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,WAAW,CAAC;IAExF;;;;OAIG;IACH,UAAU,IAAI,aAAa,CAAC,WAAW,CAAC,CAAC;CAC1C;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,UAAW,YAAW,cAAc,EAAE,eAAe;IAGpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAFtC,OAAO,CAAC,MAAM,CAAqB;gBAEN,QAAQ,CAAC,EAAE,SAAS,YAAA;IAEjD;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAOjC;;;;;;;;OAQG;IACH,EAAE,CAAC,CAAC,SAAS,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,WAAW;IAWvF;;;OAGG;IACH,UAAU,IAAI,aAAa,CAAC,WAAW,CAAC;IAIxC;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC,WAAW,CAAC;IAO1D;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;OAGG;IACH,KAAK,IAAI,IAAI;CAGd;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,YAAmB,CAAC"}

package/dist/events/event-store.js

@@ -0,0 +1,95 @@
+/**
+ * Implements the responsibility of storing and broadcasting domain events.
+ *
+ * @description
+ * Single source of truth for all events in the application.
+ * Events are immutable and append-only, enabling replay and time-travel debugging.
+ *
+ * @example
+ * ```typescript
+ * serviceProvider.register(EventStore, () =>
+ *   new EventStore(serviceProvider.get(EVENT_BUS_TOKEN))
+ * );
+ * ```
+ */
+export class EventStore {
+    eventBus;
+    events = [];
+    constructor(eventBus) {
+        this.eventBus = eventBus;
+    }
+    /**
+     * Publishes an event to the store and broadcasts to all subscribers.
+     *
+     * @param event - Domain event to publish
+     * @throws Error if event is null or undefined
+     */
+    publish(event) {
+        if (!event)
+            throw new Error('event is required');
+        this.events.push(event);
+        this.eventBus?.publish(event.type, event);
+    }
+    /**
+     * Subscribes to events of a specific type with a callback listener.
+     *
+     * @param eventType - Event type identifier
+     * @param listener - Callback invoked with typed events
+     * @returns Unsubscribe function
+     * @throws Error if eventType or listener is null or undefined
+     * @throws Error if IEventBus was not injected
+     */
+    on(eventType, listener) {
+        if (!eventType)
+            throw new Error('eventType is required');
+        if (!listener)
+            throw new Error('listener is required');
+        if (!this.eventBus) {
+            throw new Error('[EventStore] IEventBus not injected. Register EventStore with an IEventBus in the composition root.');
+        }
+        return this.eventBus.on(eventType, (payload) => {
+            listener(payload.data);
+        });
+    }
+    /**
+     * Get complete event history.
+     * Useful for debugging, time-travel, and DevTools.
+     */
+    getHistory() {
+        return [...this.events];
+    }
+    /**
+     * Replay events from a specific timestamp.
+     * Returns events that occurred after the given timestamp.
+     * Useful for time-travel debugging.
+     */
+    replay(fromTimestamp) {
+        if (!fromTimestamp) {
+            return this.getHistory();
+        }
+        return this.events.filter(event => event.timestamp >= fromTimestamp);
+    }
+    /**
+     * Get count of stored events.
+     */
+    get size() {
+        return this.events.length;
+    }
+    /**
+     * Clear all events (testing only).
+     * @internal
+     */
+    clear() {
+        this.events = [];
+    }
+}
+/**
+ * Default EventStore singleton instance for convenience.
+ *
+ * @description
+ * Provides a ready-to-use EventStore for consumers that do not use dependency injection.
+ * For DI-based architectures, prefer registering EventStore through the Services container
+ * and injecting IEventBus via the constructor.
+ */
+export const eventStore = new EventStore();
+//# sourceMappingURL=event-store.js.map

package/dist/events/event-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-store.js","sourceRoot":"","sources":["../../src/events/event-store.ts"],"names":[],"mappings":"AAqCA;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,UAAU;IAGQ;IAFrB,MAAM,GAAkB,EAAE,CAAC;IAEnC,YAA6B,QAAoB;QAApB,aAAQ,GAAR,QAAQ,CAAY;IAAG,CAAC;IAErD;;;;;OAKG;IACH,OAAO,CAAC,KAAkB;QACxB,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAEjD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;;;;OAQG;IACH,EAAE,CAAwB,SAAiB,EAAE,QAA4B;QACvE,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QACzD,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QACvD,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,qGAAqG,CAAC,CAAC;QACzH,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;YAC7C,QAAQ,CAAC,OAAO,CAAC,IAAS,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,UAAU;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,aAAsB;QAC3B,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;QAC3B,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,IAAI,aAAa,CAAC,CAAC;IACvE,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED;;;OAGG;IACH,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,UAAU,EAAE,CAAC"}

package/dist/events/rx-event-bus.d.ts

@@ -0,0 +1,109 @@
+import { type Unsubscribe } from '../reactive/signal.js';
+import { IEventBus } from './event-bus.interface.js';
+import { EventPayload } from './event-payload.js';
+/**
+ * Implements the responsibility of routing events through pub/sub and isolated channels.
+ *
+ * @description
+ * Supports two communication patterns:
+ * 1. Global pub/sub: publish()/on() for broadcast communication
+ * 2. Isolated channels: registerChannel()/emitChannel() for targeted communication
+ *
+ * Channel lifecycle management:
+ * - Object keys: Stored in WeakMap, automatically garbage collected
+ * - String keys: Stored in Map, require manual unregistration
+ *
+ * @example
+ * ```typescript
+ * // Global pub/sub
+ * eventBus.publish('user:login', { userId: 123 });
+ * const unsub = eventBus.on<{ userId: number }>('user:login', (payload) => {
+ *   console.log('User logged in:', payload.data.userId);
+ * });
+ *
+ * // Isolated channels (object key - auto cleanup)
+ * const publisher = { id: 'action-1' };
+ * const unsub = eventBus.registerChannel(publisher, (event: ActionEvent) => {
+ *   console.log('Action from specific publisher:', event);
+ * });
+ * eventBus.emitChannel(publisher, actionEvent);
+ * unsub(); // Cleanup
+ *
+ * // String-keyed channels (manual cleanup)
+ * const unsub = eventBus.registerChannel('todo-actions', (action: TodoAction) => {
+ *   console.log('Action:', action);
+ * });
+ * eventBus.emitChannel('todo-actions', todoAction);
+ * eventBus.unregisterChannel('todo-actions'); // Manual cleanup
+ * ```
+ */
+export declare class RxEventBus implements IEventBus {
+    private readonly globalListeners;
+    private readonly allListeners;
+    private readonly stringChannels;
+    private readonly objectChannels;
+    /**
+     * Publishes a global event with payload
+     * @param type - Event type identifier
+     * @param data - Event payload data
+     */
+    publish<T = unknown>(type: string, data: T): void;
+    /**
+     * Subscribes to global events of a specific type
+     * @param type - Event type identifier
+     * @param listener - Callback invoked with event payload
+     * @returns Unsubscribe function
+     */
+    on<T = unknown>(type: string, listener: (payload: EventPayload<T>) => void): Unsubscribe;
+    /**
+     * Subscribes to all global events (useful for debugging)
+     * @param listener - Callback invoked with all events
+     * @returns Unsubscribe function
+     */
+    all(listener: (payload: EventPayload) => void): Unsubscribe;
+    /**
+     * Registers a listener on an isolated channel
+     *
+     * @param channelId - Unique identifier (string or object)
+     * @param listener - Callback invoked when channel emits
+     * @returns Unsubscribe function
+     *
+     * @remarks
+     * - Object keys are stored in WeakMap (automatic GC cleanup)
+     * - String keys are stored in Map (requires manual unregisterChannel)
+     */
+    registerChannel<T = unknown>(channelId: string | object, listener: (event: T) => void): Unsubscribe;
+    /**
+     * Emits an event on an isolated channel
+     *
+     * @param channelId - Unique identifier (string or object)
+     * @param event - Event payload
+     */
+    emitChannel<T = unknown>(channelId: string | object, event: T): void;
+    /**
+     * Checks if a channel has listeners
+     *
+     * @param channelId - Unique identifier
+     * @returns True if channel has listeners
+     */
+    hasChannel(channelId: string | object): boolean;
+    /**
+     * Unregisters all listeners on a channel (cleanup for string-keyed channels)
+     *
+     * @param channelId - Unique identifier
+     *
+     * @remarks
+     * Only needed for string-keyed channels. Object-keyed channels
+     * are automatically cleaned up by garbage collection.
+     */
+    unregisterChannel(channelId: string | object): void;
+    /**
+     * Disposes of the event bus (clears all listeners)
+     *
+     * @remarks
+     * Clears all string-keyed channels and all listeners.
+     * Object-keyed channels are automatically cleaned by WeakMap GC.
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=rx-event-bus.d.ts.map

package/dist/events/rx-event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rx-event-bus.d.ts","sourceRoot":"","sources":["../../src/events/rx-event-bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBAAa,UAAW,YAAW,SAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA2D;IAC3F,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA8C;IAC3E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAoD;IACnF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwD;IAEvF;;;;OAIG;IACH,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI;IAmBjD;;;;;OAKG;IACH,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,WAAW;IAYxF;;;;OAIG;IACH,GAAG,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,GAAG,WAAW;IAO3D;;;;;;;;;;OAUG;IACH,eAAe,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,WAAW;IAsBnG;;;;;OAKG;IACH,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAkBpE;;;;;OAKG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO;IAU/C;;;;;;;;OAQG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAMnD;;;;;;OAMG;IACH,OAAO,IAAI,IAAI;CAKhB"}