@daiso-tech/core 0.17.4 → 0.20.0

package/dist/types/cache/implementations/adapters/redis-cache-adapter/redis-cache-adapter-settings.d.ts

@@ -1,7 +1,7 @@
 /**
  * @module Cache
  */
-import type { IBuildable, OneOrMore } from "../../../../utilities/_module";
+import type { IBuildable } from "../../../../utilities/_module";
 import type { Redis } from "ioredis";
 import type { ISerde } from "../../../../serde/contracts/_module";
 /**
@@ -10,7 +10,7 @@ import type { ISerde } from "../../../../serde/contracts/_module";
 export type RedisCacheAdapterSettings = {
     database: Redis;
     serde: ISerde<string>;
-    rootGroup: OneOrMore<string>;
+    rootGroup: string;
 };
 /**
  * The <i>RedisCacheAdapterSettingsBuilder</i> is an immutable builder class, meaning that each method invocation creates a new instance.
@@ -25,8 +25,8 @@ export declare class RedisCacheAdapterSettingsBuilder<TSettings extends Partial<
     setSerde(serde: ISerde<string>): RedisCacheAdapterSettingsBuilder<TSettings & {
         serde: ISerde<string>;
     }>;
-    setRootGroup(group: OneOrMore<string>): RedisCacheAdapterSettingsBuilder<TSettings & {
-        rootGroup: OneOrMore<string>;
+    setRootGroup(group: string): RedisCacheAdapterSettingsBuilder<TSettings & {
+        rootGroup: string;
     }>;
     build(this: RedisCacheAdapterSettingsBuilder<RedisCacheAdapterSettings>): RedisCacheAdapterSettings;
 }

package/dist/types/cache/implementations/adapters/redis-cache-adapter/redis-cache-adapter.d.ts

@@ -2,7 +2,6 @@
  * @module Cache
  */
 import { type ICacheAdapter } from "../../../../cache/contracts/cache-adapter.contract";
-import type { OneOrMore } from "../../../../utilities/_module";
 import { type TimeSpan } from "../../../../utilities/_module";
 import { type Result } from "ioredis";
 import type { RedisCacheAdapterSettings } from "../../../../cache/implementations/adapters/redis-cache-adapter/redis-cache-adapter-settings";
@@ -67,5 +66,5 @@ export declare class RedisCacheAdapter<TType = unknown> implements ICacheAdapter
     increment(key: string, value: number): Promise<boolean>;
     clear(): Promise<void>;
     getGroup(): string;
-    withGroup(group: OneOrMore<string>): ICacheAdapter<TType>;
+    withGroup(group: string): ICacheAdapter<TType>;
 }

package/dist/types/cache/implementations/adapters/sqlite-cache-adapter/sqlite-cache-adapter-settings.d.ts

@@ -2,7 +2,7 @@
  * @module Cache
  */
 import type { ISerde } from "../../../../serde/contracts/_module";
-import type { TimeSpan, OneOrMore, IBuildable } from "../../../../utilities/_module";
+import type { TimeSpan, IBuildable } from "../../../../utilities/_module";
 import { type SqliteDatabase } from "kysely";
 /**
  * @group Adapters
@@ -14,7 +14,7 @@ export type SqliteCacheAdapterSettings = {
     enableTransactions?: boolean;
     expiredKeysRemovalInterval?: TimeSpan;
     shouldRemoveExpiredKeys?: boolean;
-    rootGroup: OneOrMore<string>;
+    rootGroup: string;
 };
 /**
  * The <i>SqliteCacheAdapterSettingsBuilder</i> is an immutable builder class, meaning that each method invocation creates a new instance.
@@ -41,8 +41,8 @@ export declare class SqliteCacheAdapterSettingsBuilder<TSettings extends Partial
     setShouldRemoveExpiredKeys(shouldRemove: boolean): SqliteCacheAdapterSettingsBuilder<TSettings & {
         shouldRemoveExpiredKeys: boolean;
     }>;
-    setRootGroup(group: OneOrMore<string>): SqliteCacheAdapterSettingsBuilder<TSettings & {
-        rootGroup: OneOrMore<string>;
+    setRootGroup(group: string): SqliteCacheAdapterSettingsBuilder<TSettings & {
+        rootGroup: string;
     }>;
     build(this: SqliteCacheAdapterSettingsBuilder<SqliteCacheAdapterSettings>): SqliteCacheAdapterSettings;
 }

package/dist/types/cache/implementations/adapters/sqlite-cache-adapter/sqlite-cache-adapter.d.ts

@@ -2,7 +2,7 @@
  * @module Cache
  */
 import { type ICacheAdapter } from "../../../../cache/contracts/cache-adapter.contract";
-import type { TimeSpan, IInitizable, IDeinitizable, OneOrMore } from "../../../../utilities/_module";
+import type { TimeSpan, IInitizable, IDeinitizable } from "../../../../utilities/_module";
 import type { SqliteCacheAdapterSettings } from "../../../../cache/implementations/adapters/sqlite-cache-adapter/sqlite-cache-adapter-settings";
 import { SqliteCacheAdapterSettingsBuilder } from "../../../../cache/implementations/adapters/sqlite-cache-adapter/sqlite-cache-adapter-settings";
 /**
@@ -51,7 +51,7 @@ export declare class SqliteCacheAdapter<TType = unknown> implements ICacheAdapte
      */
     constructor(settings: SqliteCacheAdapterSettings);
     getGroup(): string;
-    withGroup(group: OneOrMore<string>): ICacheAdapter<TType>;
+    withGroup(group: string): ICacheAdapter<TType>;
     removeExpiredKeys(): Promise<void>;
     /**
      * Removes the table where the cache values are stored and removes the table indexes.

package/dist/types/cache/implementations/derivables/_module.d.ts

@@ -1,4 +1,2 @@
-export * from "../../../cache/implementations/derivables/cache-factory-settings";
-export * from "../../../cache/implementations/derivables/cache-factory";
-export * from "../../../cache/implementations/derivables/cache-settings";
-export * from "../../../cache/implementations/derivables/cache";
+export * from "../../../cache/implementations/derivables/cache-factory/_module";
+export * from "../../../cache/implementations/derivables/cache/_module";

package/dist/types/cache/implementations/derivables/cache/_module.d.ts

@@ -0,0 +1,2 @@
+export * from "../../../../cache/implementations/derivables/cache/cache-settings";
+export * from "../../../../cache/implementations/derivables/cache/cache";

package/dist/types/cache/implementations/derivables/{cache-settings.d.ts → cache/cache-settings.d.ts}

@@ -1,15 +1,33 @@
 /**
  * @module Cache
  */
-import type { ICacheAdapter } from "../../../cache/contracts/_module";
-import type { IBuildable } from "../../../utilities/_module";
-import type { TimeSpan } from "../../../utilities/_module";
-import type { BackoffPolicy, RetryPolicy } from "../../../async/_module";
-import type { IGroupableEventBus } from "../../../event-bus/contracts/_module";
+import type { ICacheAdapter } from "../../../../cache/contracts/_module";
+import type { IBuildable, OneOrMore } from "../../../../utilities/_module";
+import type { TimeSpan } from "../../../../utilities/_module";
+import type { BackoffPolicy, RetryPolicy } from "../../../../async/_module";
+import type { IGroupableEventBus } from "../../../../event-bus/contracts/_module";
+import type { IFlexibleSerde } from "../../../../serde/contracts/_module";
 /**
  * @group Derivables
  */
 export type CacheSettings = {
+    /**
+     * You can pass one or more <i>{@link IFlexibleSerde}</i> that will be used to register all <i>{@link IGroupableCache}</i> related errors and events.
+     * @default {true}
+     */
+    serde: OneOrMore<IFlexibleSerde>;
+    /**
+     * If set to true, all <i>{@link IGroupableCache}</i> related errors will be registered with the specified <i>IFlexibleSerde</i> during constructor initialization.
+     * This ensures that all <i>{@link IGroupableCache}</i> related errors will be serialized correctly.
+     * @default {true}
+     */
+    shouldRegisterErrors?: boolean;
+    /**
+     * If set to true, all <i>{@link IGroupableCache}</i> related events will be registered with the specified <i>IFlexibleSerde</i> during constructor initialization.
+     * This ensures that all <i>{@link IGroupableCache}</i> related events will be serialized correctly.
+     * @default {true}
+     */
+    shouldRegisterEvents?: boolean;
     adapter: ICacheAdapter<any>;
     /**
      * In order to listen to events of <i>{@link Cache}</i> class you must pass in <i>{@link IGroupableEventBus}</i>.
@@ -17,22 +35,27 @@ export type CacheSettings = {
     eventBus?: IGroupableEventBus<any>;
     /**
      * You can decide the default ttl value. If null is passed then no ttl will be used by default.
+     * @default {null}
      */
     defaultTtl?: TimeSpan | null;
     /**
      * 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;
 };
@@ -43,6 +66,15 @@ export type CacheSettings = {
 export declare class CacheSettingsBuilder<TSettings extends Partial<CacheSettings>> implements IBuildable<CacheSettings> {
     private readonly settings;
     constructor(settings?: TSettings);
+    setShouldRegisterErrors(shouldRegisterErrors: boolean): CacheSettingsBuilder<TSettings & {
+        shouldRegisterErrors: boolean;
+    }>;
+    setShouldRegisterEvents(shouldRegisterEvents: boolean): CacheSettingsBuilder<TSettings & {
+        shouldRegisterEvents: boolean;
+    }>;
+    setSerde(serde: OneOrMore<IFlexibleSerde>): CacheSettingsBuilder<TSettings & {
+        serde: OneOrMore<IFlexibleSerde>;
+    }>;
     setAdapter(adapter: ICacheAdapter<any>): CacheSettingsBuilder<TSettings & {
         adapter: ICacheAdapter<any>;
     }>;

package/dist/types/cache/implementations/derivables/{cache.d.ts → cache/cache.d.ts}

@@ -1,28 +1,46 @@
 /**
  * @module Cache
  */
-import type { CacheEvents, WithTtlValue } from "../../../cache/contracts/_module";
-import { type ICache } from "../../../cache/contracts/_module";
-import { type IGroupableCache } from "../../../cache/contracts/_module";
-import type { AsyncLazyable, GetOrAddValue, OneOrMore } from "../../../utilities/_module";
-import type { TimeSpan } from "../../../utilities/_module";
-import { LazyPromise } from "../../../async/_module";
-import type { Listener, Unsubscribe, EventClass, EventInstance } from "../../../event-bus/contracts/_module";
-import type { CacheSettings } from "../../../cache/implementations/derivables/cache-settings";
-import { CacheSettingsBuilder } from "../../../cache/implementations/derivables/cache-settings";
+import type { CacheEvents, WithTtlValue } from "../../../../cache/contracts/_module";
+import { KeyFoundCacheEvent, KeyNotFoundCacheEvent, KeyAddedCacheEvent, KeyUpdatedCacheEvent, KeyRemovedCacheEvent, KeyIncrementedCacheEvent, KeyDecrementedCacheEvent, KeysClearedCacheEvent, type ICache } from "../../../../cache/contracts/_module";
+import { CacheError, KeyNotFoundCacheError, TypeCacheError, UnexpectedCacheError } from "../../../../cache/contracts/_module";
+import { type IGroupableCache } from "../../../../cache/contracts/_module";
+import type { AsyncLazyable, GetOrAddValue, OneOrMore } from "../../../../utilities/_module";
+import type { TimeSpan } from "../../../../utilities/_module";
+import { LazyPromise } from "../../../../async/_module";
+import type { Listener, Unsubscribe, EventClass, EventInstance } from "../../../../event-bus/contracts/_module";
+import type { CacheSettings } from "../../../../cache/implementations/derivables/cache/cache-settings";
+import { CacheSettingsBuilder } from "../../../../cache/implementations/derivables/cache/cache-settings";
 /**
  * <i>Cache</i> class can be derived from any <i>{@link ICacheAdapter}</i>.
  * @group Derivables
  */
 export declare class Cache<TType = unknown> implements IGroupableCache<TType> {
+    static readonly errors: {
+        readonly Error: typeof CacheError;
+        readonly Unexpected: typeof UnexpectedCacheError;
+        readonly Type: typeof TypeCacheError;
+        readonly KeyNotFound: typeof KeyNotFoundCacheError;
+    };
+    static readonly events: {
+        readonly KeyFound: typeof KeyFoundCacheEvent;
+        readonly KeyNotFound: typeof KeyNotFoundCacheEvent;
+        readonly KeyAdded: typeof KeyAddedCacheEvent;
+        readonly KeyUpdated: typeof KeyUpdatedCacheEvent;
+        readonly KeyRemoved: typeof KeyRemovedCacheEvent;
+        readonly KeyIncremented: typeof KeyIncrementedCacheEvent;
+        readonly KeyDecremented: typeof KeyDecrementedCacheEvent;
+        readonly KeysCleared: typeof KeysClearedCacheEvent;
+    };
     /**
      * @example
      * ```ts
-     * import { Cache, MemoryCacheAdapter, TimeSpan } from "@daiso-tech/core";
+     * import { Cache, MemoryCacheAdapter, TimeSpan, SuperJsonSerde } from "@daiso-tech/core";
      *
      * const cache = new Cache(
      *   Cache
      *     .settings()
+     *     .setSerde(new SuperJsonSerde())
      *     .setAdapter(new MemoryCacheAdapter({ rootGroup: "@global" }))
      *     .setEventBus(new EventBus(new MemoryEventBusAdapter({ rootGroup: "@global" })))
      *     .setDefaultTtl(TimeSpan.fromMinutes(2))
@@ -40,6 +58,9 @@ export declare class Cache<TType = unknown> implements IGroupableCache<TType> {
     private readonly backoffPolicy;
     private readonly retryPolicy;
     private readonly timeout;
+    private readonly serde;
+    private readonly shouldRegisterErrors;
+    private readonly shouldRegisterEvents;
     /**
      *@example
      * ```ts
@@ -49,6 +70,7 @@ export declare class Cache<TType = unknown> implements IGroupableCache<TType> {
      *   adapter: new MemoryEventBusAdapter({ rootGroup: "@global" })
      * });
      * const cache = new Cache({
+     *   serde: new SuperJsonSerde();
      *   adapter: new MemoryCacheAdapter({
      *     rootGroup: "@global"
      *   }),
@@ -57,6 +79,14 @@ export declare class Cache<TType = unknown> implements IGroupableCache<TType> {
      * ```
      */
     constructor(settings: CacheSettings);
+    /**
+     * Registers all cache-related events within the given <i>IFlexibleSerde</i> contract.
+     */
+    private registerEvents;
+    /**
+     * Registers all cache-related error within the given <i>IFlexibleSerde</i> contract.
+     */
+    private registerErrors;
     private createLayPromise;
     private createKeyFoundEvent;
     private createKeyNotFoundEvent;

package/dist/types/cache/implementations/derivables/cache-factory/_module.d.ts

@@ -0,0 +1,2 @@
+export * from "../../../../cache/implementations/derivables/cache-factory/cache-factory-settings";
+export * from "../../../../cache/implementations/derivables/cache-factory/cache-factory";

package/dist/types/cache/implementations/derivables/{cache-factory-settings.d.ts → cache-factory/cache-factory-settings.d.ts}

@@ -1,10 +1,11 @@
 /**
  * @module Cache
  */
-import type { IGroupableEventBus } from "../../../event-bus/contracts/_module";
-import type { ICacheAdapter } from "../../../cache/contracts/_module";
-import type { TimeSpan } from "../../../utilities/_module";
-import type { BackoffPolicy, RetryPolicy } from "../../../async/_module";
+import type { IGroupableEventBus } from "../../../../event-bus/contracts/_module";
+import type { ICacheAdapter } from "../../../../cache/contracts/_module";
+import type { OneOrMore, TimeSpan } from "../../../../utilities/_module";
+import type { BackoffPolicy, RetryPolicy } from "../../../../async/_module";
+import type { IFlexibleSerde } from "../../../../serde/contracts/_module";
 /**
  * @group Derivables
  */
@@ -13,6 +14,23 @@ export type CacheAdapters<TAdapters extends string> = Partial<Record<TAdapters,
  * @group Derivables
  */
 export type CacheFactorySettings<TAdapters extends string = string> = {
+    /**
+     * You can pass one or more <i>{@link IFlexibleSerde}</i> that will be used to register all <i>{@link IGroupableCache}</i> related errors and events.
+     * @default {true}
+     */
+    serde: OneOrMore<IFlexibleSerde>;
+    /**
+     * If set to true, all <i>{@link IGroupableCache}</i> related errors will be registered with the specified <i>IFlexibleSerde</i> during constructor initialization.
+     * This ensures that all <i>{@link IGroupableCache}</i> related errors will be serialized correctly.
+     * @default {true}
+     */
+    shouldRegisterErrors?: boolean;
+    /**
+     * If set to true, all <i>{@link IGroupableCache}</i> related events will be registered with the specified <i>IFlexibleSerde</i> during constructor initialization.
+     * This ensures that all <i>{@link IGroupableCache}</i> related events will be serialized correctly.
+     * @default {true}
+     */
+    shouldRegisterEvents?: boolean;
     adapters: CacheAdapters<TAdapters>;
     defaultAdapter?: NoInfer<TAdapters>;
     /**
@@ -25,18 +43,22 @@ export type CacheFactorySettings<TAdapters extends string = string> = {
     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;
 };
@@ -47,6 +69,15 @@ export type CacheFactorySettings<TAdapters extends string = string> = {
 export declare class CacheFactorySettingsBuilder<TSettings extends CacheFactorySettings> {
     private readonly settings;
     constructor(settings?: TSettings);
+    setShouldRegisterErrors(shouldRegisterErrors: boolean): CacheFactorySettingsBuilder<TSettings & {
+        shouldRegisterErrors: boolean;
+    }>;
+    setShouldRegisterEvents(shouldRegisterEvents: boolean): CacheFactorySettingsBuilder<TSettings & {
+        shouldRegisterEvents: boolean;
+    }>;
+    setSerde(serde: OneOrMore<IFlexibleSerde>): CacheFactorySettingsBuilder<TSettings & {
+        serde: OneOrMore<IFlexibleSerde>;
+    }>;
     setEventBus(eventBus: IGroupableEventBus<any>): CacheFactorySettingsBuilder<TSettings & {
         eventBus: IGroupableEventBus<any>;
     }>;

package/dist/types/cache/implementations/derivables/{cache-factory.d.ts → cache-factory/cache-factory.d.ts}

@@ -1,9 +1,9 @@
 /**
  * @module Cache
  */
-import type { ICacheFactory, IGroupableCache } from "../../../cache/contracts/_module";
-import type { CacheFactorySettings } from "../../../cache/implementations/derivables/cache-factory-settings";
-import { CacheFactorySettingsBuilder } from "../../../cache/implementations/derivables/cache-factory-settings";
+import type { ICacheFactory, IGroupableCache } from "../../../../cache/contracts/_module";
+import type { CacheFactorySettings } from "../../../../cache/implementations/derivables/cache-factory/cache-factory-settings";
+import { CacheFactorySettingsBuilder } from "../../../../cache/implementations/derivables/cache-factory/cache-factory-settings";
 /**
  * @group Derivables
  */
@@ -14,6 +14,7 @@ export declare class CacheFactory<TAdapters extends string = string> implements
      * import { CacheFactory, SuperJsonSerde. MemoryCacheAdapter, RedisCacheAdapter, EventBus, MemoryEventBusAdapter } from "@daiso-tech/core";
      * import Redis from "ioredis";
      *
+     * const serde = new SuperJsonSerde();
      * const cacheFactory = new CacheFactory(
      *   CacheFactory
      *     .settings()
@@ -23,7 +24,7 @@ export declare class CacheFactory<TAdapters extends string = string> implements
      *     }))
      *     .setAdapter("redis", new RedisCacheAdapter({
      *       client: new Redis("YOUR_REDIS_CONNECTION"),
-     *       serde: new SuperJsonSerde(),
+     *       serde,
      *       rootGroup: "@global"
      *     }))
      *     .setDefaultAdapter("memory")
@@ -32,6 +33,7 @@ export declare class CacheFactory<TAdapters extends string = string> implements
      * ```
      */
     static settings<TAdapters extends string, TSettings extends CacheFactorySettings<TAdapters>>(): CacheFactorySettingsBuilder<TSettings>;
+    private readonly caches;
     private readonly adapters;
     private readonly defaultAdapter?;
     private readonly eventBus?;
@@ -40,6 +42,9 @@ export declare class CacheFactory<TAdapters extends string = string> implements
     private readonly backoffPolicy?;
     private readonly retryPolicy?;
     private readonly timeout?;
+    private readonly serde;
+    private readonly shouldRegisterErrors?;
+    private readonly shouldRegisterEvents?;
     /**
      * @example
      * ```ts
@@ -49,14 +54,16 @@ export declare class CacheFactory<TAdapters extends string = string> implements
      * const eventBus = new EventBus({
      *   adapter: new MemoryEventBusAdapter({ rootGroup: "@global" })
      * });
+     * const serde = new SuperJsonSerde();
      * const cacheFactory = new CacheFactory({
+     *   serde,
      *   adapters: {
      *     memory: new MemoryCacheAdapter({
      *       rootGroup: "@global"
      *     }),
      *     redis: new RedisCacheAdapter({
      *       client: new Redis("YOUR_REDIS_CONNECTION"),
-     *       serde: new SuperJsonSerde(),
+     *       serde,
      *       rootGroup: "@global"
      *     }),
      *   },
@@ -66,5 +73,6 @@ export declare class CacheFactory<TAdapters extends string = string> implements
      * ```
      */
     constructor(settings: CacheFactorySettings<TAdapters>);
+    private initCaches;
     use<TType = unknown>(adapterName?: TAdapters | undefined): IGroupableCache<TType>;
 }

package/dist/types/event-bus/contracts/event-bus-adapter.contract.d.ts

@@ -2,7 +2,6 @@
  * @module EventBus
  */
 import type { Listener } from "../../event-bus/contracts/_shared";
-import type { OneOrMore } from "../../utilities/_module";
 import type { BaseEvent } from "../../event-bus/contracts/_shared";
 /**
  * The <i>IEventBusAdapter</i> contract defines a way for dispatching and listening to events independent of underlying technology.
@@ -23,5 +22,5 @@ export type IEventBusAdapter = {
      */
     dispatch(eventName: string, eventData: BaseEvent): PromiseLike<void>;
     getGroup(): string;
-    withGroup(group: OneOrMore<string>): IEventBusAdapter;
+    withGroup(group: string): IEventBusAdapter;
 };

package/dist/types/event-bus/contracts/event-bus.contract.d.ts

@@ -28,30 +28,30 @@ export type IEventListener<TEvents extends BaseEvent = BaseEvent> = {
     /**
      * The <i>addListener</i> method is used for adding <i>{@link Listener | listener}</i> for certain <i>event</i>.
      * A listener can only be added once for a specific event. Adding the same listener multiple times will have no effect and nothing will occur.
-     * @throws {AddListenerEventBusError} {@link AddListenerEventBusError}
+     * @throws {UnableToAddListenerEventBusError} {@link UnableToAddListenerEventBusError}
      */
     addListener<TEventClass extends EventClass<TEvents>>(event: TEventClass, listener: Listener<EventInstance<TEventClass>>): LazyPromise<void>;
     /**
      * The <i>addListenerMany</i> method is used for adding multiple <i>{@link Listener | listeners}</i> for certain <i>events</i>.
      * A listener can only be added once for a specific event. Adding the same listener multiple times will have no effect and nothing will occur.
-     * @throws {AddListenerEventBusError} {@link AddListenerEventBusError}
+     * @throws {UnableToAddListenerEventBusError} {@link UnableToAddListenerEventBusError}
      */
     addListenerMany<TEventClass extends EventClass<TEvents>>(events: TEventClass[], listener: Listener<EventInstance<TEventClass>>): LazyPromise<void>;
     /**
      * The <i>removeListener</i> method is used for removing <i>{@link Listener | listener}</i> for certain <i>event</i>.
      * Removing unadded listener will have no effect and nothing will occur.
-     * @throws {RemoveListenerEventBusError} {@link RemoveListenerEventBusError}
+     * @throws {UnableToRemoveListenerEventBusError} {@link UnableToRemoveListenerEventBusError}
      */
     removeListener<TEventClass extends EventClass<TEvents>>(event: TEventClass, listener: Listener<EventInstance<TEventClass>>): LazyPromise<void>;
     /**
      * The <i>removeListener</i> method is used for removing multiple <i>{@link Listener | listeners}</i> for certain <i>event</i>.
      * Removing unadded listener will have no effect and nothing will occur.
-     * @throws {RemoveListenerEventBusError} {@link RemoveListenerEventBusError}
+     * @throws {UnableToRemoveListenerEventBusError} {@link UnableToRemoveListenerEventBusError}
      */
     removeListenerMany<TEventClass extends EventClass<TEvents>>(events: TEventClass[], listener: Listener<EventInstance<TEventClass>>): LazyPromise<void>;
     /**
      * The <i>listenOnce</i> method is used for adding <i>{@link Listener | listener}</i> for certain <i>event</i> that is trigged only once.
-     * @throws {AddListenerEventBusError} {@link AddListenerEventBusError}
+     * @throws {UnableToAddListenerEventBusError} {@link UnableToAddListenerEventBusError}
      */
     listenOnce<TEventClass extends EventClass<TEvents>>(event: TEventClass, listener: Listener<EventInstance<TEventClass>>): LazyPromise<void>;
     /**
@@ -73,13 +73,13 @@ export type IEventDispatcher<TEvents extends BaseEvent = BaseEvent> = {
     /**
      * The <i>dispatch</i> method is used for dispatching a <i>event</i>.
 
-     * @throws {DispatchEventBusError} {@link DispatchEventBusError}
+     * @throws {UnableToDispatchEventBusError} {@link UnableToDispatchEventBusError}
      */
     dispatch(event: TEvents): LazyPromise<void>;
     /**
      * The <i>dispatchMany</i> method is used for dispatching multiple <i>event</i>.
 
-     * @throws {DispatchEventBusError} {@link DispatchEventBusError}
+     * @throws {UnableToDispatchEventBusError} {@link UnableToDispatchEventBusError}
      */
     dispatchMany(events: TEvents[]): LazyPromise<void>;
 };

package/dist/types/event-bus/contracts/event-bus.errors.d.ts

@@ -1,33 +1,40 @@
 /**
  * @module EventBus
  */
+import type { ISerializable } from "../../serde/contracts/_module";
+import type { ISerializedError } from "../../utilities/_module";
 /**
  * @group Errors
  */
-export declare class EventBusError extends Error {
+export declare class EventBusError extends Error implements ISerializable<ISerializedError> {
+    static deserialize(deserializedValue: ISerializedError): EventBusError;
     constructor(message: string, cause?: unknown);
+    serialize(): ISerializedError;
 }
 /**
  * @group Errors
  */
 export declare class UnexpectedEventBusError extends EventBusError {
+    static deserialize(deserializedValue: ISerializedError): EventBusError;
     constructor(message: string, cause?: unknown);
 }
 /**
  * @group Errors
  */
-export declare class RemoveListenerEventBusError extends UnexpectedEventBusError {
+export declare class UnableToRemoveListenerEventBusError extends UnexpectedEventBusError {
+    static deserialize(deserializedValue: ISerializedError): EventBusError;
     constructor(message: string, cause?: unknown);
 }
 /**
  * @group Errors
  */
-export declare class AddListenerEventBusError extends UnexpectedEventBusError {
+export declare class UnableToAddListenerEventBusError extends UnexpectedEventBusError {
+    static deserialize(deserializedValue: ISerializedError): EventBusError;
     constructor(message: string, cause?: unknown);
 }
 /**
  * @group Errors
  */
-export declare class DispatchEventBusError extends UnexpectedEventBusError {
+export declare class UnableToDispatchEventBusError extends UnexpectedEventBusError {
     constructor(message: string, cause?: unknown);
 }

package/dist/types/event-bus/implementations/adapters/memory-event-bus-adapter/memory-event-bus-adapter-settings.d.ts

@@ -2,13 +2,12 @@
  * @module EventBus
  */
 import type { IBuildable } from "../../../../utilities/_module";
-import type { OneOrMore } from "../../../../utilities/_module";
 import type { EventEmitter } from "node:events";
 /**
  * @group Adapters
  */
 export type MemoryEventBusAdapterSettings = {
-    rootGroup: OneOrMore<string>;
+    rootGroup: string;
     eventEmitter?: EventEmitter;
 };
 /**
@@ -21,8 +20,8 @@ export declare class MemoryEventBusAdapterSettingsBuilder<TSettings extends Part
     setEventEmitter(eventEmitter: EventEmitter): MemoryEventBusAdapterSettingsBuilder<TSettings & {
         eventEmitter: EventEmitter<[never]>;
     }>;
-    setRootGroup(group: OneOrMore<string>): MemoryEventBusAdapterSettingsBuilder<TSettings & {
-        rootGroup: OneOrMore<string>;
+    setRootGroup(group: string): MemoryEventBusAdapterSettingsBuilder<TSettings & {
+        rootGroup: string;
     }>;
     build(this: MemoryEventBusAdapterSettingsBuilder<MemoryEventBusAdapterSettings>): MemoryEventBusAdapterSettings;
 }

package/dist/types/event-bus/implementations/adapters/memory-event-bus-adapter/memory-event-bus-adapter.d.ts

@@ -1,7 +1,6 @@
 /**
  * @module EventBus
  */
-import { type OneOrMore } from "../../../../utilities/_module";
 import type { BaseEvent, IEventBusAdapter, Listener } from "../../../../event-bus/contracts/_module";
 import type { MemoryEventBusAdapterSettings } from "../../../../event-bus/implementations/adapters/memory-event-bus-adapter/memory-event-bus-adapter-settings";
 import { MemoryEventBusAdapterSettingsBuilder } from "../../../../event-bus/implementations/adapters/memory-event-bus-adapter/memory-event-bus-adapter-settings";
@@ -54,7 +53,7 @@ export declare class MemoryEventBusAdapter implements IEventBusAdapter {
      */
     constructor(settings: MemoryEventBusAdapterSettings);
     getGroup(): string;
-    withGroup(group: OneOrMore<string>): IEventBusAdapter;
+    withGroup(group: string): IEventBusAdapter;
     private withPrefix;
     addListener(eventName: string, listener: Listener<BaseEvent>): Promise<void>;
     removeListener(eventName: string, listener: Listener<BaseEvent>): Promise<void>;

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

@@ -1,7 +1,6 @@
 /**
  * @module EventBus
  */
-import type { OneOrMore } from "../../../../utilities/_module";
 import type { BaseEvent, Listener } from "../../../../event-bus/contracts/_module";
 import type { IEventBusAdapter } from "../../../../event-bus/contracts/_module";
 /**
@@ -10,7 +9,7 @@ import type { IEventBusAdapter } from "../../../../event-bus/contracts/_module";
  */
 export declare class NoOpEventBusAdapter implements IEventBusAdapter {
     getGroup(): string;
-    withGroup(_group: OneOrMore<string>): IEventBusAdapter;
+    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/types/event-bus/implementations/adapters/redis-pub-sub-event-bus-adapter/redis-pub-sub-event-bus-adapter-settings.d.ts

@@ -3,7 +3,7 @@
  */
 import { type ISerde } from "../../../../serde/contracts/_module";
 import type Redis from "ioredis";
-import type { IBuildable, OneOrMore } from "../../../../utilities/_module";
+import type { IBuildable } from "../../../../utilities/_module";
 /**
  * @group Adapters
  */
@@ -11,7 +11,7 @@ export type RedisPubSubEventBusAdapterSettings = {
     dispatcherClient: Redis;
     listenerClient: Redis;
     serde: ISerde<string>;
-    rootGroup: OneOrMore<string>;
+    rootGroup: string;
 };
 /**
  * The <i>RedisPubSubEventBusAdapterSettingsBuilder</i> is an immutable builder class, meaning that each method invocation creates a new instance.
@@ -29,8 +29,8 @@ export declare class RedisPubSubEventBusAdapterSettingsBuilder<TSettings extends
     setSerde(serde: ISerde<string>): RedisPubSubEventBusAdapterSettingsBuilder<TSettings & {
         serde: ISerde<string>;
     }>;
-    setRootGroup(group: OneOrMore<string>): RedisPubSubEventBusAdapterSettingsBuilder<TSettings & {
-        rootGroup: OneOrMore<string>;
+    setRootGroup(group: string): RedisPubSubEventBusAdapterSettingsBuilder<TSettings & {
+        rootGroup: string;
     }>;
     build(this: RedisPubSubEventBusAdapterSettingsBuilder<RedisPubSubEventBusAdapterSettings>): RedisPubSubEventBusAdapterSettings;
 }