@daiso-tech/core 0.23.0 → 0.25.0

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

@@ -0,0 +1,444 @@
+/**
+ * @module EventBus
+ */
+import { LazyPromise } from "../../../../async/_module-exports.js";
+import { UnableToDispatchEventBusError, UnableToRemoveListenerEventBusError, UnableToAddListenerEventBusError, } from "../../../../event-bus/contracts/_module-exports.js";
+import { getConstructorName, resolveOneOrMoreStr, } 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;
+    listenerObjectMap = new Map();
+    /**
+     * @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(resolveOneOrMoreStr(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();
+    }
+    ensureListenerObject(listener) {
+        let listenerFn = this.listenerObjectMap.get(listener);
+        if (listenerFn !== undefined) {
+            return listenerFn;
+        }
+        listenerFn = listener.handler.bind(listener);
+        this.listenerObjectMap.set(listener, listenerFn);
+        return listenerFn;
+    }
+    resolveListener(listener) {
+        if (typeof listener === "function") {
+            return listener;
+        }
+        return this.ensureListenerObject(listener);
+    }
+    deleteListener(listener) {
+        if (typeof listener === "function") {
+            return;
+        }
+        this.listenerObjectMap.delete(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, 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: EventListener<AddEvent> = event => {
+     *   console.log(event);
+     * }
+     * await eventBus.addListener(AddEvent, listener);
+     * await eventBus.dispatch(new AddEvent({ a: 1, b: 2,}));
+     * ```
+     */
+    addListener(event, listener) {
+        return this.createLayPromise(async () => {
+            const resolvedListener = this.resolveListener(listener);
+            try {
+                await this.adapter.addListener(event.name, resolvedListener);
+            }
+            catch (error) {
+                throw new UnableToAddListenerEventBusError(`A listener with name of "${resolvedListener.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: EventListener<AddEvent> = event => {
+     *   console.log(event);
+     * }
+     * await eventBus.addListener(AddEvent, listener);
+     * await eventBus.dispatch(new AddEvent({ a: 1, b: 2,}));
+     * await eventBus.removeListener(AddEvent, listener);
+     * ```
+     */
+    removeListener(event, listener) {
+        return this.createLayPromise(async () => {
+            const resolvedListener = this.resolveListener(listener);
+            try {
+                await this.adapter.removeListener(event.name, resolvedListener);
+                this.deleteListener(listener);
+            }
+            catch (error) {
+                throw new UnableToRemoveListenerEventBusError(`A listener with name of "${resolvedListener.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: EventListener<AddEvent | SubEvent> = event => {
+     *   console.log(event)
+     * }
+     * await eventBus.addListenerMany([AddEvent, SubEvent], listener);
+     * await eventBus.dispatchMany([
+     *   new AddEvent({ a: 1, b: 2 }),
+     *   new SubEvent({ c: 1, d: 2 }),
+     * ]);
+     * ```
+     */
+    addListenerMany(events, listener) {
+        return this.createLayPromise(async () => {
+            if (events.length === 0) {
+                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: EventListener<AddEvent | SubEvent> = event => {
+     *   console.log(event);
+     * }
+     * await eventBus.addListenerMany([AddEvent, SubEvent], listener);
+     * await eventBus.dispatchMany([
+     *   new AddEvent({ a: 1, b: 2 }),
+     *   new SubEvent({ c: 1, d: 2 }),
+     * ]);
+     * await eventBus.removeListenerMany([AddEvent, SubEvent], listener);
+     * ```
+     */
+    removeListenerMany(events, listener) {
+        return this.createLayPromise(async () => {
+            if (events.length === 0) {
+                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 }> {}
+     *
+     * await eventBus.listenOnce(AddEvent, event => {
+     *   console.log(event);
+     * });
+     *
+     * await eventBus.dispatch(new AddEvent({ a: 1, b: 2,}));
+     * ```
+     */
+    listenOnce(event, listener) {
+        return this.createLayPromise(async () => {
+            const wrappedListener = async (event_) => {
+                try {
+                    const resolvedListener = this.resolveListener(listener);
+                    await resolvedListener(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, 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 }> {}
+     *
+     * eventBus.asPromise(AddEvent).then(event => {
+     *   console.log(event);
+     * });
+     *
+     * await eventBus.dispatch(new AddEvent({ a: 1, b: 2,}));
+     * ```
+     */
+    asPromise(event) {
+        return new LazyPromise(() => new Promise((resolve, reject) => {
+            this.listenOnce(event, resolve).then((event) => event, 
+            // eslint-disable-next-line @typescript-eslint/use-unknown-in-catch-callback-variable
+            reject);
+        }));
+    }
+    /**
+     * @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 eventBus.dispatch(new AddEvent({ a: 1, b: 2,}));
+     * 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 eventBus.dispatchMany([
+     *   new AddEvent({ a: 1, b: 2 }),
+     *   new SubEvent({ c: 1, d: 2 }),
+     * ]);
+     * 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.dispatchMany([
+     *   new AddEvent({ a: 1, b: 2 }),
+     *   new SubEvent({ c: 1, d: 2 }),
+     * ]);
+     * ```
+     */
+    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 }> {}
+     *
+     * 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>;
+}