@daiso-tech/core 0.22.2 → 0.24.0

package/dist/event-bus/implementations/adapters/memory-event-bus-adapter/memory-event-bus-adapter.js

@@ -0,0 +1,71 @@
+/**
+ * @module EventBus
+ */
+import { simplifyOneOrMoreStr } from "../../../../utilities/_module-exports.js";
+import { EventEmitter } from "node:events";
+/**
+ * To utilize the <i>MemoryEventBusAdapter</i>, you must create instance of it.
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/event-bus/implementations/adapters"```
+ * @group Adapters
+ */
+export class MemoryEventBusAdapter {
+    group;
+    eventEmitter;
+    /**
+     * @example
+     * ```ts
+     * import { MemoryEventBusAdapter } from "@daiso-tech/core/event-bus/implementations/adapters";
+     * import { EventEmitter } from "node:events";
+     *
+     * const eventEmitter = new EventEmitter();
+     * const eventBusAdapter = new MemoryEventBusAdapter({
+     *   eventEmitter
+     * });
+     * ```
+     * You can also provide an <i>EVentEmitter</i>.
+     * @example
+     * ```ts
+     * import { MemoryEventBusAdapter } from "@daiso-tech/core/event-bus/implementations/adapters";
+     * import { EventEmitter } from "node:events";
+     *
+     * const eventEmitter = new EventEmitter();
+     * const eventBusAdapter = new MemoryEventBusAdapter({
+     *   rootGroup: "@global",
+     *   eventEmitter
+     * });
+     * ```
+     */
+    constructor(settings) {
+        const { rootGroup, eventEmitter = new EventEmitter() } = settings;
+        this.eventEmitter = eventEmitter;
+        this.group = rootGroup;
+    }
+    getGroup() {
+        return this.group;
+    }
+    withGroup(group) {
+        return new MemoryEventBusAdapter({
+            rootGroup: simplifyOneOrMoreStr([this.group, group]),
+            eventEmitter: this.eventEmitter,
+        });
+    }
+    withPrefix(event) {
+        return simplifyOneOrMoreStr([this.group, event]);
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async addListener(eventName, listener) {
+        // eslint-disable-next-line @typescript-eslint/no-misused-promises
+        this.eventEmitter.on(this.withPrefix(eventName), listener);
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async removeListener(eventName, listener) {
+        // eslint-disable-next-line @typescript-eslint/no-misused-promises
+        this.eventEmitter.off(this.withPrefix(eventName), listener);
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async dispatch(eventName, eventData) {
+        this.eventEmitter.emit(this.withPrefix(eventName), eventData);
+    }
+}
+//# sourceMappingURL=memory-event-bus-adapter.js.map

package/dist/event-bus/implementations/adapters/memory-event-bus-adapter/memory-event-bus-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-event-bus-adapter.js","sourceRoot":"","sources":["../../../../../src/event-bus/implementations/adapters/memory-event-bus-adapter/memory-event-bus-adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAMtE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAY3C;;;;;GAKG;AACH,MAAM,OAAO,qBAAqB;IACb,KAAK,CAAS;IACd,YAAY,CAAe;IAE5C;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,YAAY,QAAuC;QAC/C,MAAM,EAAE,SAAS,EAAE,YAAY,GAAG,IAAI,YAAY,EAAE,EAAE,GAAG,QAAQ,CAAC;QAClE,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;IAC3B,CAAC;IAED,QAAQ;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,SAAS,CAAC,KAAa;QACnB,OAAO,IAAI,qBAAqB,CAAC;YAC7B,SAAS,EAAE,oBAAoB,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YACpD,YAAY,EAAE,IAAI,CAAC,YAAY;SAClC,CAAC,CAAC;IACP,CAAC;IAEO,UAAU,CAAC,KAAa;QAC5B,OAAO,oBAAoB,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,4DAA4D;IAC5D,KAAK,CAAC,WAAW,CACb,SAAiB,EACjB,QAA6B;QAE7B,kEAAkE;QAClE,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC/D,CAAC;IAED,4DAA4D;IAC5D,KAAK,CAAC,cAAc,CAChB,SAAiB,EACjB,QAA6B;QAE7B,kEAAkE;QAClE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,CAAC;IAChE,CAAC;IAED,4DAA4D;IAC5D,KAAK,CAAC,QAAQ,CAAC,SAAiB,EAAE,SAAoB;QAClD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC;IAClE,CAAC;CACJ"}

package/dist/event-bus/implementations/adapters/no-op-event-bus-adapter/_module.d.ts

@@ -0,0 +1 @@
+export * from "../../../../event-bus/implementations/adapters/no-op-event-bus-adapter/no-op-event-bus-adapter.js";

package/dist/event-bus/implementations/adapters/no-op-event-bus-adapter/_module.js

@@ -0,0 +1,2 @@
+export * from "../../../../event-bus/implementations/adapters/no-op-event-bus-adapter/no-op-event-bus-adapter.js";
+//# sourceMappingURL=_module.js.map

package/dist/event-bus/implementations/adapters/no-op-event-bus-adapter/_module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../../../src/event-bus/implementations/adapters/no-op-event-bus-adapter/_module.ts"],"names":[],"mappings":"AAAA,cAAc,yFAAyF,CAAC"}

package/dist/event-bus/implementations/adapters/no-op-event-bus-adapter/no-op-event-bus-adapter.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @module EventBus
+ */
+import type { BaseEvent, Listener } from "../../../../event-bus/contracts/_module-exports.js";
+import type { IEventBusAdapter } from "../../../../event-bus/contracts/_module-exports.js";
+/**
+ * This <i>NoOpEventBusAdapter</i> will do nothing and is used for easily mocking {@link IEventBus} for testing.
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/event-bus/implementations/adapters"```
+ * @group Adapters
+ */
+export declare class NoOpEventBusAdapter implements IEventBusAdapter {
+    getGroup(): string;
+    withGroup(_group: string): IEventBusAdapter;
+    addListener(_eventName: string, _listener: Listener<BaseEvent>): PromiseLike<void>;
+    removeListener(_eventName: string, _listener: Listener<BaseEvent>): PromiseLike<void>;
+    dispatch(_eventName: string, _eventData: BaseEvent): PromiseLike<void>;
+}

package/dist/event-bus/implementations/adapters/no-op-event-bus-adapter/no-op-event-bus-adapter.js

@@ -0,0 +1,27 @@
+/**
+ * @module EventBus
+ */
+/**
+ * This <i>NoOpEventBusAdapter</i> will do nothing and is used for easily mocking {@link IEventBus} for testing.
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/event-bus/implementations/adapters"```
+ * @group Adapters
+ */
+export class NoOpEventBusAdapter {
+    getGroup() {
+        return "";
+    }
+    withGroup(_group) {
+        return new NoOpEventBusAdapter();
+    }
+    addListener(_eventName, _listener) {
+        return Promise.resolve();
+    }
+    removeListener(_eventName, _listener) {
+        return Promise.resolve();
+    }
+    dispatch(_eventName, _eventData) {
+        return Promise.resolve();
+    }
+}
+//# sourceMappingURL=no-op-event-bus-adapter.js.map

package/dist/event-bus/implementations/adapters/no-op-event-bus-adapter/no-op-event-bus-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-op-event-bus-adapter.js","sourceRoot":"","sources":["../../../../../src/event-bus/implementations/adapters/no-op-event-bus-adapter/no-op-event-bus-adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH;;;;;GAKG;AACH,MAAM,OAAO,mBAAmB;IAC5B,QAAQ;QACJ,OAAO,EAAE,CAAC;IACd,CAAC;IAED,SAAS,CAAC,MAAc;QACpB,OAAO,IAAI,mBAAmB,EAAE,CAAC;IACrC,CAAC;IAED,WAAW,CACP,UAAkB,EAClB,SAA8B;QAE9B,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC;IAED,cAAc,CACV,UAAkB,EAClB,SAA8B;QAE9B,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC;IAED,QAAQ,CAAC,UAAkB,EAAE,UAAqB;QAC9C,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC;CACJ"}

package/dist/event-bus/implementations/adapters/redis-pub-sub-event-bus-adapter/_module.d.ts

@@ -0,0 +1 @@
+export * from "../../../../event-bus/implementations/adapters/redis-pub-sub-event-bus-adapter/redis-pub-sub-event-bus-adapter.js";

package/dist/event-bus/implementations/adapters/redis-pub-sub-event-bus-adapter/_module.js

@@ -0,0 +1,2 @@
+export * from "../../../../event-bus/implementations/adapters/redis-pub-sub-event-bus-adapter/redis-pub-sub-event-bus-adapter.js";
+//# sourceMappingURL=_module.js.map

package/dist/event-bus/implementations/adapters/redis-pub-sub-event-bus-adapter/_module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../../../src/event-bus/implementations/adapters/redis-pub-sub-event-bus-adapter/_module.ts"],"names":[],"mappings":"AAAA,cAAc,yGAAyG,CAAC"}

package/dist/event-bus/implementations/adapters/redis-pub-sub-event-bus-adapter/redis-pub-sub-event-bus-adapter.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @module EventBus
+ */
+import { type ISerde } from "../../../../serde/contracts/_module-exports.js";
+import type { BaseEvent, IEventBusAdapter, Listener } from "../../../../event-bus/contracts/_module-exports.js";
+import type { Redis } from "ioredis";
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/event-bus/implementations/adapters"```
+ * @group Adapters
+ */
+export type RedisPubSubEventBusAdapterSettings = {
+    dispatcherClient: Redis;
+    listenerClient: Redis;
+    serde: ISerde<string>;
+    rootGroup: string;
+};
+/**
+ * To utilize the <i>RedisPubSubEventBusAdapter</i>, you must install the <i>"ioredis"</i> package and supply a <i>{@link ISerde | ISerde<string> }</i>, with a <i>{@link SuperJsonSerdeAdapter}</i>.
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/event-bus/implementations/adapters"```
+ * @group Adapters
+ */
+export declare class RedisPubSubEventBusAdapter implements IEventBusAdapter {
+    private readonly group;
+    private readonly baseSerde;
+    private readonly redisSerde;
+    private readonly dispatcherClient;
+    private readonly listenerClient;
+    private readonly eventEmitter;
+    /**
+     * @example
+     * ```ts
+     * import { RedisPubSubEventBusAdapter } from "@daiso-tech/core/event-bus/implementations/adapters";
+     * import { Serde } from "@daiso-tech/core/serde/implementations/derivables";
+     * import { SuperJsonSerdeAdapter } from "@daiso-tech/core/serde/implementations/adapters";
+     * import Redis from "ioredis";
+     *
+     * const dispatcherClient = new Redis("YOUR_REDIS_CONNECTION_STRING");
+     * const listenerClient = new Redis("YOUR_REDIS_CONNECTION_STRING");
+     * const serde = new Serde(new SuperJsonSerdeAdapter());
+     * const eventBusAdapter = new RedisPubSubEventBusAdapter({
+     *   dispatcherClient,
+     *   listenerClient,
+     *   serde,
+     *   rootGroup: "@global"
+     * });
+     * ```
+     */
+    constructor({ dispatcherClient, listenerClient, serde, rootGroup, }: RedisPubSubEventBusAdapterSettings);
+    getGroup(): string;
+    withGroup(group: string): IEventBusAdapter;
+    private withPrefix;
+    private redisListener;
+    addListener(eventName: string, listener: Listener<BaseEvent>): Promise<void>;
+    removeListener(eventName: string, listener: Listener<BaseEvent>): Promise<void>;
+    dispatch(eventName: string, eventData: BaseEvent): Promise<void>;
+}

package/dist/event-bus/implementations/adapters/redis-pub-sub-event-bus-adapter/redis-pub-sub-event-bus-adapter.js

@@ -0,0 +1,82 @@
+/**
+ * @module EventBus
+ */
+import {} from "../../../../serde/contracts/_module-exports.js";
+import { RedisSerde, 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+SuperJsonSerdeAdapter, } from "../../../../serde/implementations/adapters/_module-exports.js";
+import { EventEmitter } from "node:events";
+import { simplifyOneOrMoreStr } from "../../../../utilities/_module-exports.js";
+/**
+ * To utilize the <i>RedisPubSubEventBusAdapter</i>, you must install the <i>"ioredis"</i> package and supply a <i>{@link ISerde | ISerde<string> }</i>, with a <i>{@link SuperJsonSerdeAdapter}</i>.
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/event-bus/implementations/adapters"```
+ * @group Adapters
+ */
+export class RedisPubSubEventBusAdapter {
+    group;
+    baseSerde;
+    redisSerde;
+    dispatcherClient;
+    listenerClient;
+    eventEmitter = new EventEmitter();
+    /**
+     * @example
+     * ```ts
+     * import { RedisPubSubEventBusAdapter } from "@daiso-tech/core/event-bus/implementations/adapters";
+     * import { Serde } from "@daiso-tech/core/serde/implementations/derivables";
+     * import { SuperJsonSerdeAdapter } from "@daiso-tech/core/serde/implementations/adapters";
+     * import Redis from "ioredis";
+     *
+     * const dispatcherClient = new Redis("YOUR_REDIS_CONNECTION_STRING");
+     * const listenerClient = new Redis("YOUR_REDIS_CONNECTION_STRING");
+     * const serde = new Serde(new SuperJsonSerdeAdapter());
+     * const eventBusAdapter = new RedisPubSubEventBusAdapter({
+     *   dispatcherClient,
+     *   listenerClient,
+     *   serde,
+     *   rootGroup: "@global"
+     * });
+     * ```
+     */
+    constructor({ dispatcherClient, listenerClient, serde, rootGroup, }) {
+        this.group = rootGroup;
+        this.dispatcherClient = dispatcherClient;
+        this.listenerClient = listenerClient;
+        this.baseSerde = serde;
+        this.redisSerde = new RedisSerde(serde);
+    }
+    getGroup() {
+        return this.group;
+    }
+    withGroup(group) {
+        return new RedisPubSubEventBusAdapter({
+            listenerClient: this.listenerClient,
+            dispatcherClient: this.dispatcherClient,
+            serde: this.baseSerde,
+            rootGroup: simplifyOneOrMoreStr([this.group, group]),
+        });
+    }
+    withPrefix(eventName) {
+        return simplifyOneOrMoreStr([this.group, eventName]);
+    }
+    redisListener = (channel, message) => {
+        this.eventEmitter.emit(channel, this.redisSerde.deserialize(message));
+    };
+    async addListener(eventName, listener) {
+        // eslint-disable-next-line @typescript-eslint/no-misused-promises
+        this.eventEmitter.on(this.withPrefix(eventName), listener);
+        await this.listenerClient.subscribe(this.withPrefix(eventName));
+        // eslint-disable-next-line @typescript-eslint/no-misused-promises
+        this.listenerClient.on("message", this.redisListener);
+    }
+    async removeListener(eventName, listener) {
+        // eslint-disable-next-line @typescript-eslint/no-misused-promises
+        this.eventEmitter.off(this.withPrefix(eventName), listener);
+        await this.listenerClient.unsubscribe(this.withPrefix(eventName));
+    }
+    async dispatch(eventName, eventData) {
+        await this.dispatcherClient.publish(this.withPrefix(eventName), this.redisSerde.serialize(eventData));
+    }
+}
+//# sourceMappingURL=redis-pub-sub-event-bus-adapter.js.map

package/dist/event-bus/implementations/adapters/redis-pub-sub-event-bus-adapter/redis-pub-sub-event-bus-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-pub-sub-event-bus-adapter.js","sourceRoot":"","sources":["../../../../../src/event-bus/implementations/adapters/redis-pub-sub-event-bus-adapter/redis-pub-sub-event-bus-adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAe,MAAM,sCAAsC,CAAC;AACnE,OAAO,EACH,UAAU;AACV,6DAA6D;AAC7D,qBAAqB,GACxB,MAAM,qDAAqD,CAAC;AAO7D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AActE;;;;;GAKG;AACH,MAAM,OAAO,0BAA0B;IAClB,KAAK,CAAS;IACd,SAAS,CAAiB;IAC1B,UAAU,CAAiB;IAC3B,gBAAgB,CAAQ;IACxB,cAAc,CAAQ;IACtB,YAAY,GAAG,IAAI,YAAY,EAAE,CAAC;IAEnD;;;;;;;;;;;;;;;;;;OAkBG;IACH,YAAY,EACR,gBAAgB,EAChB,cAAc,EACd,KAAK,EACL,SAAS,GACwB;QACjC,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACvB,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;QACzC,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC;IAED,QAAQ;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,SAAS,CAAC,KAAa;QACnB,OAAO,IAAI,0BAA0B,CAAC;YAClC,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,KAAK,EAAE,IAAI,CAAC,SAAS;YACrB,SAAS,EAAE,oBAAoB,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;SACvD,CAAC,CAAC;IACP,CAAC;IAEO,UAAU,CAAC,SAAiB;QAChC,OAAO,oBAAoB,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;IACzD,CAAC;IAEO,aAAa,GAAG,CAAC,OAAe,EAAE,OAAe,EAAQ,EAAE;QAC/D,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1E,CAAC,CAAC;IAEF,KAAK,CAAC,WAAW,CACb,SAAiB,EACjB,QAA6B;QAE7B,kEAAkE;QAClE,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,CAAC;QAE3D,MAAM,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;QAEhE,kEAAkE;QAClE,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,cAAc,CAChB,SAAiB,EACjB,QAA6B;QAE7B,kEAAkE;QAClE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,CAAC;QAE5D,MAAM,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,SAAiB,EAAE,SAAoB;QAClD,MAAM,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAC/B,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAC1B,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC,CACvC,CAAC;IACN,CAAC;CACJ"}

package/dist/event-bus/implementations/derivables/_module-exports.d.ts

@@ -0,0 +1,2 @@
+export * from "../../../event-bus/implementations/derivables/event-bus-factory/_module.js";
+export * from "../../../event-bus/implementations/derivables/event-bus/_module.js";

package/dist/event-bus/implementations/derivables/_module-exports.js

@@ -0,0 +1,3 @@
+export * from "../../../event-bus/implementations/derivables/event-bus-factory/_module.js";
+export * from "../../../event-bus/implementations/derivables/event-bus/_module.js";
+//# sourceMappingURL=_module-exports.js.map

package/dist/event-bus/implementations/derivables/_module-exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_module-exports.js","sourceRoot":"","sources":["../../../../src/event-bus/implementations/derivables/_module-exports.ts"],"names":[],"mappings":"AAAA,cAAc,qEAAqE,CAAC;AACpF,cAAc,6DAA6D,CAAC"}

package/dist/event-bus/implementations/derivables/event-bus/_module.d.ts

@@ -0,0 +1 @@
+export * from "../../../../event-bus/implementations/derivables/event-bus/event-bus.js";

package/dist/event-bus/implementations/derivables/event-bus/_module.js

@@ -0,0 +1,2 @@
+export * from "../../../../event-bus/implementations/derivables/event-bus/event-bus.js";
+//# sourceMappingURL=_module.js.map

package/dist/event-bus/implementations/derivables/event-bus/_module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../../../src/event-bus/implementations/derivables/event-bus/_module.ts"],"names":[],"mappings":"AAAA,cAAc,+DAA+D,CAAC"}

package/dist/event-bus/implementations/derivables/event-bus/event-bus.d.ts

@@ -0,0 +1,305 @@
+/**
+ * @module EventBus
+ */
+import type { BackoffPolicy, RetryPolicy } from "../../../../async/_module-exports.js";
+import { LazyPromise } from "../../../../async/_module-exports.js";
+import type { EventClass, EventInstance, Unsubscribe } from "../../../../event-bus/contracts/_module-exports.js";
+import { type IEventBus, type IGroupableEventBus, type IEventBusAdapter, type Listener, type BaseEvent } from "../../../../event-bus/contracts/_module-exports.js";
+import type { OneOrMore, TimeSpan } from "../../../../utilities/_module-exports.js";
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/event-bus/implementations/derivables"```
+ * @group Derivables
+ */
+export type EventBusSettings = {
+    adapter: IEventBusAdapter;
+    /**
+     * The default retry attempt to use in the returned <i>LazyPromise</i>.
+     * @default {null}
+     */
+    retryAttempts?: number | null;
+    /**
+     * The default backof policy to use in the returned <i>LazyPromise</i>.
+     * @default {null}
+     */
+    backoffPolicy?: BackoffPolicy | null;
+    /**
+     * The default retry policy to use in the returned <i>LazyPromise</i>.
+     * @default {null}
+     */
+    retryPolicy?: RetryPolicy | null;
+    /**
+     * The default timeout to use in the returned <i>LazyPromise</i>.
+     * @default {null}
+     */
+    timeout?: TimeSpan | null;
+};
+/**
+ * <i>EventBus</i> class can be derived from any <i>{@link IEventBusAdapter}</i>.
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/event-bus/implementations/derivables"```
+ * @group Derivables
+ */
+export declare class EventBus<TEvents extends BaseEvent = BaseEvent> implements IGroupableEventBus<TEvents> {
+    private readonly adapter;
+    private readonly retryAttempts;
+    private readonly backoffPolicy;
+    private readonly retryPolicy;
+    private readonly timeout;
+    /**
+     * @example
+     * ```ts
+     * import type { IGroupableEventBus } from "@daiso-tech/core/event-bus/contracts";
+     * import { EventBus } from "@daiso-tech/core/event-bus/implementations/derivables";
+     * import { MemoryEventBusAdapter } from "@daiso-tech/core/event-bus/implementations/adapters";
+     *
+     * const eventBus: IGroupableEventBus = new EventBus({
+     *   adapter: new MemoryEventBusAdapter({ rootGroup: "@global" })
+     * });
+     * ```
+     */
+    constructor(settings: EventBusSettings);
+    private createLayPromise;
+    /**
+     * @example
+     * ```ts
+     * import type { IGroupableEventBus, IEventBus } from "@daiso-tech/core/event-bus/contracts";
+     * import { EventBus } from "@daiso-tech/core/event-bus/implementations/derivables";
+     * import { MemoryEventBusAdapter } from "@daiso-tech/core/event-bus/implementations/adapters";
+     * import { BaseEvent } from "@daiso-tech/core/event-bus/contracts";
+     *
+     * const eventBus: IGroupableEventBus = new EventBus({
+     *   adapter: new MemoryEventBusAdapter({ rootGroup: "@global" })
+     * });
+     *
+     * // Will print "@global"
+     * console.log(eventBus.getGroup());
+     *
+     * const groupedEventBus: IEventBus = eventBus.withGroup("company-1");
+     *
+     * // Will print "@global/company-1"
+     * console.log(groupedEventBus.getGroup());
+     * ```
+     */
+    withGroup(group: OneOrMore<string>): IEventBus<TEvents>;
+    /**
+     * @example
+     * ```ts
+     * import type { IGroupableEventBus } from "@daiso-tech/core/event-bus/contracts";
+     * import { EventBus } from "@daiso-tech/core/event-bus/implementations/derivables";
+     * import { MemoryEventBusAdapter } from "@daiso-tech/core/event-bus/implementations/adapters";
+     * import { BaseEvent } from "@daiso-tech/core/event-bus/contracts";
+     *
+     * const eventBus: IGroupableEventBus = new EventBus({
+     *   adapter: new MemoryEventBusAdapter({ rootGroup: "@global" })
+     * });
+     *
+     * // Will print "@global"
+     * console.log(eventBus.getGroup());
+     * ```
+     */
+    getGroup(): string;
+    /**
+     * @example
+     * ```ts
+     * import type { IGroupableEventBus } from "@daiso-tech/core/event-bus/contracts";
+     * import { EventBus } from "@daiso-tech/core/event-bus/implementations/derivables";
+     * import { MemoryEventBusAdapter } from "@daiso-tech/core/event-bus/implementations/adapters";
+     * import { BaseEvent, type Listener } from "@daiso-tech/core/event-bus/contracts";
+     *
+     * const eventBus: IGroupableEventBus = new EventBus({
+     *   adapter: new MemoryEventBusAdapter({ rootGroup: "@global" })
+     * });
+     *
+     * class AddEvent extends BaseEvent<{ a: number, b: number }> {}
+     *
+     * const listener: Listener<AddEvent> = event => {
+     *   console.log(event);
+     * }
+     * await eventBus.addListener(AddEvent, listener);
+     * ```
+     */
+    addListener<TEventClass extends EventClass<TEvents>>(event: TEventClass, listener: Listener<EventInstance<TEventClass>>): LazyPromise<void>;
+    /**
+     * @example
+     * ```ts
+     * import type { IGroupableEventBus } from "@daiso-tech/core/event-bus/contracts";
+     * import { EventBus } from "@daiso-tech/core/event-bus/implementations/derivables";
+     * import { MemoryEventBusAdapter } from "@daiso-tech/core/event-bus/implementations/adapters";
+     * import { BaseEvent, type Listener } from "@daiso-tech/core/event-bus/contracts";
+     *
+     * const eventBus: IGroupableEventBus = new EventBus({
+     *   adapter: new MemoryEventBusAdapter({ rootGroup: "@global" })
+     * });
+     *
+     * class AddEvent extends BaseEvent<{ a: number, b: number }> {}
+     *
+     * const listener: Listener<AddEvent> = event => {
+     *   console.log(event);
+     * }
+     * await eventBus.removeListener(AddEvent, listener);
+     * ```
+     */
+    removeListener<TEventClass extends EventClass<TEvents>>(event: TEventClass, listener: Listener<EventInstance<TEventClass>>): LazyPromise<void>;
+    /**
+     * @example
+     * ```ts
+     * import type { IGroupableEventBus } from "@daiso-tech/core/event-bus/contracts";
+     * import { EventBus } from "@daiso-tech/core/event-bus/implementations/derivables";
+     * import { MemoryEventBusAdapter } from "@daiso-tech/core/event-bus/implementations/adapters";
+     * import { BaseEvent, type Listener } from "@daiso-tech/core/event-bus/contracts";
+     *
+     * const eventBus: IGroupableEventBus = new EventBus({
+     *   adapter: new MemoryEventBusAdapter({ rootGroup: "@global" })
+     * });
+     *
+     * class AddEvent extends BaseEvent<{ a: number, b: number }> {}
+     * class SubEvent extends BaseEvent<{ c: number, d: number }> {}
+     *
+     * const listener: Listener<AddEvent | SubEvent> = event => {
+     *   console.log(event)
+     * }
+     * await eventBus.addListenerMany([AddEvent, SubEvent], listener);
+     * ```
+     */
+    addListenerMany<TEventClass extends EventClass<TEvents>>(events: TEventClass[], listener: Listener<EventInstance<TEventClass>>): LazyPromise<void>;
+    /**
+     * @example
+     * ```ts
+     * import type { IGroupableEventBus } from "@daiso-tech/core/event-bus/contracts";
+     * import { EventBus } from "@daiso-tech/core/event-bus/implementations/derivables";
+     * import { MemoryEventBusAdapter } from "@daiso-tech/core/event-bus/implementations/adapters";
+     * import { BaseEvent, type Listener } from "@daiso-tech/core/event-bus/contracts";
+     *
+     * const eventBus: IGroupableEventBus = new EventBus({
+     *   adapter: new MemoryEventBusAdapter({ rootGroup: "@global" })
+     * });
+     *
+     * class AddEvent extends BaseEvent<{ a: number, b: number }> {}
+     * class SubEvent extends BaseEvent<{ c: number, d: number }> {}
+     *
+     * const listener: Listener<AddEvent | SubEvent> = event => {
+     *   console.log(event);
+     * }
+     * await eventBus.removeListenerMany([AddEvent, SubEvent], listener);
+     * ```
+     */
+    removeListenerMany<TEventClass extends EventClass<TEvents>>(events: TEventClass[], listener: Listener<EventInstance<TEventClass>>): LazyPromise<void>;
+    /**
+     * @example
+     * ```ts
+     * import type { IGroupableEventBus } from "@daiso-tech/core/event-bus/contracts";
+     * import { EventBus } from "@daiso-tech/core/event-bus/implementations/derivables";
+     * import { MemoryEventBusAdapter } from "@daiso-tech/core/event-bus/implementations/adapters";
+     * import { BaseEvent, type Listener } from "@daiso-tech/core/event-bus/contracts";
+     *
+     * const eventBus: IGroupableEventBus = new EventBus({
+     *   adapter: new MemoryEventBusAdapter({ rootGroup: "@global" })
+     * });
+     *
+     * class AddEvent extends BaseEvent<{ a: number, b: number }> {}
+     *
+     * const listener: Listener<AddEvent> = event => {
+     *   console.log(event);
+     * }
+     * await eventBus.listenOnce(AddEvent, listener);
+     * ```
+     */
+    listenOnce<TEventClass extends EventClass<TEvents>>(event: TEventClass, listener: Listener<EventInstance<TEventClass>>): LazyPromise<void>;
+    /**
+     * @example
+     * ```ts
+     * import type { IGroupableEventBus } from "@daiso-tech/core/event-bus/contracts";
+     * import { EventBus } from "@daiso-tech/core/event-bus/implementations/derivables";
+     * import { MemoryEventBusAdapter } from "@daiso-tech/core/event-bus/implementations/adapters";
+     * import { BaseEvent } from "@daiso-tech/core/event-bus/contracts";
+     *
+     * const eventBus: IGroupableEventBus = new EventBus({
+     *   adapter: new MemoryEventBusAdapter({ rootGroup: "@global" })
+     * });
+     *
+     * class AddEvent extends BaseEvent<{ a: number, b: number }> {}
+     *
+     * const unsubscribe = await eventBus.subscribe(AddEvent, event => {
+     *   console.log(event);
+     * });
+     * await unsubscribe();
+     * ```
+     */
+    subscribe<TEventClass extends EventClass<TEvents>>(event: TEventClass, listener: Listener<EventInstance<TEventClass>>): LazyPromise<Unsubscribe>;
+    /**
+     * @example
+     * ```ts
+     * import type { IGroupableEventBus } from "@daiso-tech/core/event-bus/contracts";
+     * import { EventBus } from "@daiso-tech/core/event-bus/implementations/derivables";
+     * import { MemoryEventBusAdapter } from "@daiso-tech/core/event-bus/implementations/adapters";
+     * import { BaseEvent } from "@daiso-tech/core/event-bus/contracts";
+     *
+     * const eventBus: IGroupableEventBus = new EventBus({
+     *   adapter: new MemoryEventBusAdapter({ rootGroup: "@global" })
+     * });
+     *
+     * class AddEvent extends BaseEvent<{ a: number, b: number }> {}
+     * class SubEvent extends BaseEvent<{ c: number, d: number }> {}
+     *
+     * const unsubscribe = await eventBus.subscribeMany([AddEvent, SubEvent], event => {
+     *   console.log(event);
+     * });
+     * await unsubscribe();
+     * ```
+     */
+    subscribeMany<TEventClass extends EventClass<TEvents>>(events: TEventClass[], listener: Listener<EventInstance<TEventClass>>): LazyPromise<Unsubscribe>;
+    /**
+     * @example
+     * ```ts
+     * import type { IGroupableEventBus } from "@daiso-tech/core/event-bus/contracts";
+     * import { EventBus } from "@daiso-tech/core/event-bus/implementations/derivables";
+     * import { MemoryEventBusAdapter } from "@daiso-tech/core/event-bus/implementations/adapters";
+     * import { BaseEvent } from "@daiso-tech/core/event-bus/contracts";
+     *
+     * const eventBus: IGroupableEventBus = new EventBus({
+     *   adapter: new MemoryEventBusAdapter({ rootGroup: "@global" })
+     * });
+     *
+     * class AddEvent extends BaseEvent<{ a: number, b: number }> {}
+     * class SubEvent extends BaseEvent<{ c: number, d: number }> {}
+     *
+     * await eventBus.dispatch([
+     *   new AddEvent({
+     *     a: 1,
+     *     b: 2,
+     *   }),
+     *   new SubEvent({
+     *     c: 4,
+     *     d: 3
+     *   })
+     * ]);
+     * ```
+     */
+    dispatchMany(events: TEvents[]): LazyPromise<void>;
+    /**
+     * @example
+     * ```ts
+     * import type { IGroupableEventBus } from "@daiso-tech/core/event-bus/contracts";
+     * import { EventBus } from "@daiso-tech/core/event-bus/implementations/derivables";
+     * import { MemoryEventBusAdapter } from "@daiso-tech/core/event-bus/implementations/adapters";
+     * import { BaseEvent } from "@daiso-tech/core/event-bus/contracts";
+     *
+     * const eventBus: IGroupableEventBus = new EventBus({
+     *   adapter: new MemoryEventBusAdapter({ rootGroup: "@global" })
+     * });
+     *
+     * class AddEvent extends BaseEvent<{ a: number, b: number }> {}
+     * class SubEvent extends BaseEvent<{ c: number, d: number }> {}
+     *
+     * await eventBus.dispatch(
+     *   new AddEvent({
+     *     a: 1,
+     *     b: 2,
+     *   })
+     * );
+     * ```
+     * ```
+     */
+    dispatch(event: TEvents): LazyPromise<void>;
+}