@daiso-tech/core 0.22.2 → 0.24.0

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

@@ -0,0 +1,385 @@
+/**
+ * @module EventBus
+ */
+import { LazyPromise } from "../../../../async/_module-exports.js";
+import { UnableToDispatchEventBusError, UnableToRemoveListenerEventBusError, UnableToAddListenerEventBusError, } from "../../../../event-bus/contracts/_module-exports.js";
+import { getConstructorName, isArrayEmpty, simplifyOneOrMoreStr, } from "../../../../utilities/_module-exports.js";
+/**
+ * <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 class EventBus {
+    adapter;
+    retryAttempts;
+    backoffPolicy;
+    retryPolicy;
+    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) {
+        const { adapter, retryAttempts = null, backoffPolicy = null, retryPolicy = null, timeout = null, } = settings;
+        this.retryAttempts = retryAttempts;
+        this.backoffPolicy = backoffPolicy;
+        this.retryPolicy = retryPolicy;
+        this.timeout = timeout;
+        this.adapter = adapter;
+    }
+    createLayPromise(asyncFn) {
+        return new LazyPromise(asyncFn)
+            .setRetryAttempts(this.retryAttempts)
+            .setBackoffPolicy(this.backoffPolicy)
+            .setRetryPolicy(this.retryPolicy)
+            .setTimeout(this.timeout);
+    }
+    /**
+     * @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) {
+        return new EventBus({
+            adapter: this.adapter.withGroup(simplifyOneOrMoreStr(group)),
+            retryAttempts: this.retryAttempts,
+            backoffPolicy: this.backoffPolicy,
+            retryPolicy: this.retryPolicy,
+            timeout: this.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";
+     * 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() {
+        return this.adapter.getGroup();
+    }
+    /**
+     * @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(event, listener) {
+        return this.createLayPromise(async () => {
+            try {
+                await this.adapter.addListener(event.name, listener);
+            }
+            catch (error) {
+                throw new UnableToAddListenerEventBusError(`A listener with name of "${listener.name}" could not added for "${String(event)}" event`, error);
+            }
+        });
+    }
+    /**
+     * @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(event, listener) {
+        return this.createLayPromise(async () => {
+            try {
+                await this.adapter.removeListener(event.name, listener);
+            }
+            catch (error) {
+                throw new UnableToRemoveListenerEventBusError(`A listener with name of "${listener.name}" could not removed of "${String(event)}" event`, error);
+            }
+        });
+    }
+    /**
+     * @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(events, listener) {
+        return this.createLayPromise(async () => {
+            if (isArrayEmpty(events)) {
+                return;
+            }
+            const promises = [];
+            for (const event of events) {
+                promises.push(this.addListener(event, listener));
+            }
+            await Promise.all(promises);
+        });
+    }
+    /**
+     * @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(events, listener) {
+        return this.createLayPromise(async () => {
+            if (isArrayEmpty(events)) {
+                return;
+            }
+            const promises = [];
+            for (const event of events) {
+                promises.push(this.removeListener(event, listener));
+            }
+            await Promise.all(promises);
+        });
+    }
+    /**
+     * @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(event, listener) {
+        return this.createLayPromise(async () => {
+            const wrappedListener = async (event_) => {
+                try {
+                    await listener(event_);
+                }
+                finally {
+                    await this.removeListener(event, wrappedListener);
+                }
+            };
+            await this.addListener(event, wrappedListener);
+        });
+    }
+    /**
+     * @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(event, listener) {
+        return this.subscribeMany([event], listener);
+    }
+    /**
+     * @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(events, listener) {
+        return this.createLayPromise(async () => {
+            await this.addListenerMany(events, listener);
+            const unsubscribe = () => {
+                return this.createLayPromise(async () => {
+                    await this.removeListenerMany(events, listener);
+                });
+            };
+            return 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) {
+        return this.createLayPromise(async () => {
+            try {
+                const promises = [];
+                for (const event of events) {
+                    promises.push(this.adapter.dispatch(getConstructorName(event), event));
+                }
+                await Promise.all(promises);
+            }
+            catch (error) {
+                throw new UnableToDispatchEventBusError(`Events of types "${events.map((event) => getConstructorName(event)).join(", ")}" could not be dispatched`, error);
+            }
+        });
+    }
+    /**
+     * @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) {
+        return this.createLayPromise(async () => {
+            try {
+                await this.adapter.dispatch(getConstructorName(event), event);
+            }
+            catch (error) {
+                throw new UnableToDispatchEventBusError(`Event of type "${String(getConstructorName(event))}" could not be dispatched`, error);
+            }
+        });
+    }
+}
+//# sourceMappingURL=event-bus.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.js","sourceRoot":"","sources":["../../../../../src/event-bus/implementations/derivables/event-bus/event-bus.ts"],"names":[],"mappings":"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"}

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

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

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

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

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

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

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

@@ -0,0 +1,139 @@
+/**
+ * @module EventBus
+ */
+import type { BackoffPolicy, RetryPolicy } from "../../../../async/_module-exports.js";
+import { type IEventBusAdapter, type IGroupableEventBus, type IEventBusFactory, type BaseEvent } from "../../../../event-bus/contracts/_module-exports.js";
+import type { OneOrMore, TimeSpan } from "../../../../utilities/_module-exports.js";
+import type { IFlexibleSerde } from "../../../../serde/contracts/_module-exports.js";
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/event-bus/implementations/derivables"```
+ * @group Derivables
+ */
+export type EventBusAdapters<TAdapters extends string = string> = Partial<Record<TAdapters, IEventBusAdapter>>;
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/event-bus/implementations/derivables"```
+ * @group Derivables
+ */
+export type EventBusFactorySettings<TAdapters extends string = string> = {
+    /**
+     * You can pass one or more <i>{@link IFlexibleSerde}</i> that will be used to register all <i>{@link IGroupableEventBus}</i> related errors.
+     * @default {true}
+     */
+    serde: OneOrMore<IFlexibleSerde>;
+    /**
+     * If set to true, all <i>{@link IGroupableEventBus}</i> related errors will be registered with the specified <i>IFlexibleSerde</i> during constructor initialization.
+     * This ensures that all <i>{@link IGroupableEventBus}</i> related errors will be serialized correctly.
+     * @default {true}
+     */
+    shouldRegisterErrors?: boolean;
+    adapters: EventBusAdapters<TAdapters>;
+    defaultAdapter?: NoInfer<TAdapters>;
+    /**
+     * In order to listen to events of <i>{@link Cache}</i> class you must pass in <i>{@link IGroupableEventBus}</i>.
+     */
+    eventBus?: IGroupableEventBus<any>;
+    /**
+     * 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;
+};
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/event-bus/implementations/derivables"```
+ * @group Derivables
+ */
+export declare class EventBusFactory<TAdapters extends string = string> implements IEventBusFactory<TAdapters> {
+    private readonly eventBusRecord;
+    private readonly serde;
+    private readonly defaultAdapter?;
+    private readonly retryAttempts?;
+    private readonly backoffPolicy?;
+    private readonly retryPolicy?;
+    private readonly timeout?;
+    private readonly shouldRegisterErrors?;
+    /**
+     * @example
+     * ```ts
+     * import { EventBusFactory } from "@daiso-tech/core/event-bus/implementations/derivables";
+     * import { MemoryEventBusAdapter, 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 serde = new Serde(new SuperJsonSerdeAdapter());
+     * const cacheFactory = new EventBusFactory({
+     *   serde,
+     *   adapters: {
+     *     memory:new MemoryEventBusAdapter({
+     *       rootGroup: "@global"
+     *     }),
+     *     redis: new RedisPubSubEventBusAdapter({
+     *       dispatcherClient: new Redis("YOUR_REDIS_CONNECTION"),
+     *       listenerClient: new Redis("YOUR_REDIS_CONNECTION")
+     *       serde,
+     *       rootGroup: "@global"
+     *     }),
+     *     defaultAdapter: "memory"
+     *   }
+     * });
+     * ```
+     */
+    constructor(settings: EventBusFactorySettings<TAdapters>);
+    private init;
+    /**
+     * @example
+     * ```ts
+     * import { BaseEvent } from "@daiso-tech/core/event-bus/contracts";
+     * import { EventBusFactory } from "@daiso-tech/core/event-bus/implementations/derivables";
+     * import { MemoryEventBusAdapter, 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 serde = new Serde(new SuperJsonSerdeAdapter());
+     * const cacheFactory = new EventBusFactory({
+     *   serde,
+     *   adapters: {
+     *     memory:new MemoryEventBusAdapter({
+     *       rootGroup: "@global"
+     *     }),
+     *     redis: new RedisPubSubEventBusAdapter({
+     *       dispatcherClient: new Redis("YOUR_REDIS_CONNECTION"),
+     *       listenerClient: new Redis("YOUR_REDIS_CONNECTION")
+     *       serde,
+     *       rootGroup: "@global"
+     *     }),
+     *     defaultAdapter: "memory"
+     *   }
+     * });
+     *
+     * class AddEvent extends BaseEvent<{ a: number, b: number }> {}
+     * serde.registerEvent(AddEvent);
+     *
+     * // Will use the default adapter which is MemoryEventBusAdapter
+     * await cacheFactory.use().dispatch(new AddEvent({ a: 1, b: 2 }));
+     *
+     * // Will use the redis dapter which is RedisPubSubEventBusAdapter
+     * await cacheFactory.use("redis").dispatch(new AddEvent({ a: 1, b: 2 }));
+     * ```
+     */
+    use<TEvents extends BaseEvent = BaseEvent>(adapterName?: TAdapters | undefined): IGroupableEventBus<TEvents>;
+}

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

@@ -0,0 +1,127 @@
+/**
+ * @module EventBus
+ */
+import { registerEventBusErrorsToSerde, } from "../../../../event-bus/contracts/_module-exports.js";
+import { EventBus } from "../../../../event-bus/implementations/derivables/event-bus/event-bus.js";
+import { DefaultAdapterNotDefinedError, UnregisteredAdapterError, } from "../../../../utilities/_module-exports.js";
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/event-bus/implementations/derivables"```
+ * @group Derivables
+ */
+export class EventBusFactory {
+    eventBusRecord = {};
+    serde;
+    defaultAdapter;
+    retryAttempts;
+    backoffPolicy;
+    retryPolicy;
+    timeout;
+    shouldRegisterErrors;
+    /**
+     * @example
+     * ```ts
+     * import { EventBusFactory } from "@daiso-tech/core/event-bus/implementations/derivables";
+     * import { MemoryEventBusAdapter, 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 serde = new Serde(new SuperJsonSerdeAdapter());
+     * const cacheFactory = new EventBusFactory({
+     *   serde,
+     *   adapters: {
+     *     memory:new MemoryEventBusAdapter({
+     *       rootGroup: "@global"
+     *     }),
+     *     redis: new RedisPubSubEventBusAdapter({
+     *       dispatcherClient: new Redis("YOUR_REDIS_CONNECTION"),
+     *       listenerClient: new Redis("YOUR_REDIS_CONNECTION")
+     *       serde,
+     *       rootGroup: "@global"
+     *     }),
+     *     defaultAdapter: "memory"
+     *   }
+     * });
+     * ```
+     */
+    constructor(settings) {
+        const { adapters, shouldRegisterErrors = true, serde, defaultAdapter, retryAttempts, backoffPolicy, retryPolicy, timeout, } = settings;
+        this.shouldRegisterErrors = shouldRegisterErrors;
+        this.serde = serde;
+        this.retryAttempts = retryAttempts;
+        this.backoffPolicy = backoffPolicy;
+        this.retryPolicy = retryPolicy;
+        this.timeout = timeout;
+        this.defaultAdapter = defaultAdapter;
+        this.eventBusRecord = this.init(adapters);
+    }
+    init(adapters) {
+        if (this.shouldRegisterErrors) {
+            registerEventBusErrorsToSerde(this.serde);
+        }
+        const eventBusRecord = {};
+        for (const key in adapters) {
+            const { [key]: adapter } = adapters;
+            if (adapter === undefined) {
+                continue;
+            }
+            eventBusRecord[key] = new EventBus({
+                adapter,
+                retryAttempts: this.retryAttempts,
+                backoffPolicy: this.backoffPolicy,
+                retryPolicy: this.retryPolicy,
+                timeout: this.timeout,
+            });
+        }
+        return eventBusRecord;
+    }
+    /**
+     * @example
+     * ```ts
+     * import { BaseEvent } from "@daiso-tech/core/event-bus/contracts";
+     * import { EventBusFactory } from "@daiso-tech/core/event-bus/implementations/derivables";
+     * import { MemoryEventBusAdapter, 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 serde = new Serde(new SuperJsonSerdeAdapter());
+     * const cacheFactory = new EventBusFactory({
+     *   serde,
+     *   adapters: {
+     *     memory:new MemoryEventBusAdapter({
+     *       rootGroup: "@global"
+     *     }),
+     *     redis: new RedisPubSubEventBusAdapter({
+     *       dispatcherClient: new Redis("YOUR_REDIS_CONNECTION"),
+     *       listenerClient: new Redis("YOUR_REDIS_CONNECTION")
+     *       serde,
+     *       rootGroup: "@global"
+     *     }),
+     *     defaultAdapter: "memory"
+     *   }
+     * });
+     *
+     * class AddEvent extends BaseEvent<{ a: number, b: number }> {}
+     * serde.registerEvent(AddEvent);
+     *
+     * // Will use the default adapter which is MemoryEventBusAdapter
+     * await cacheFactory.use().dispatch(new AddEvent({ a: 1, b: 2 }));
+     *
+     * // Will use the redis dapter which is RedisPubSubEventBusAdapter
+     * await cacheFactory.use("redis").dispatch(new AddEvent({ a: 1, b: 2 }));
+     * ```
+     */
+    use(adapterName = this.defaultAdapter) {
+        if (adapterName === undefined) {
+            throw new DefaultAdapterNotDefinedError(EventBusFactory.name);
+        }
+        const eventBus = this.eventBusRecord[adapterName];
+        if (eventBus === undefined) {
+            throw new UnregisteredAdapterError(adapterName);
+        }
+        return eventBus;
+    }
+}
+//# sourceMappingURL=event-bus-factory.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus-factory.js","sourceRoot":"","sources":["../../../../../src/event-bus/implementations/derivables/event-bus-factory/event-bus-factory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAKH,6BAA6B,GAChC,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,+DAA+D,CAAC;AAEzF,OAAO,EACH,6BAA6B,EAC7B,wBAAwB,GAC3B,MAAM,gCAAgC,CAAC;AAwExC;;;;GAIG;AACH,MAAM,OAAO,eAAe;IAGP,cAAc,GAAG,EAA+B,CAAC;IACjD,KAAK,CAA4B;IACjC,cAAc,CAAa;IAC3B,aAAa,CAAiB;IAC9B,aAAa,CAAwB;IACrC,WAAW,CAAsB;IACjC,OAAO,CAAmB;IAC1B,oBAAoB,CAAW;IAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,YAAY,QAA4C;QACpD,MAAM,EACF,QAAQ,EACR,oBAAoB,GAAG,IAAI,EAC3B,KAAK,EACL,cAAc,EACd,aAAa,EACb,aAAa,EACb,WAAW,EACX,OAAO,GACV,GAAG,QAAQ,CAAC;QACb,IAAI,CAAC,oBAAoB,GAAG,oBAAoB,CAAC;QACjD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAEO,IAAI,CACR,QAAqC;QAErC,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC5B,6BAA6B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9C,CAAC;QACD,MAAM,cAAc,GAA8B,EAAE,CAAC;QACrD,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YACzB,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC;YACpC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBACxB,SAAS;YACb,CAAC;YACD,cAAc,CAAC,GAAG,CAAC,GAAG,IAAI,QAAQ,CAAC;gBAC/B,OAAO;gBACP,aAAa,EAAE,IAAI,CAAC,aAAa;gBACjC,aAAa,EAAE,IAAI,CAAC,aAAa;gBACjC,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;aACxB,CAAC,CAAC;QACP,CAAC;QACD,OAAO,cAAc,CAAC;IAC1B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACH,GAAG,CACC,cAAqC,IAAI,CAAC,cAAc;QAExD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,IAAI,6BAA6B,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAClE,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;QAClD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,IAAI,wBAAwB,CAAC,WAAW,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,QAAQ,CAAC;IACpB,CAAC;CACJ"}