@daiso-tech/core 0.7.0 → 0.8.0

package/dist/types/collection/implementations/async-iterable-collection/_shared/async-update-iterable.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Collection
+ */
 import { type AsyncPredicate, type AsyncMap, type IAsyncCollection, type ChangendItem } from "../../../../collection/contracts/_module";
 /**
  * @internal

package/dist/types/collection/implementations/async-iterable-collection/_shared/async-when-iterable.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Collection
+ */
 import { type AsyncModifier, type IAsyncCollection } from "../../../../collection/contracts/_module";
 /**
  * @internal

package/dist/types/collection/implementations/async-iterable-collection/_shared/async-zip-iterable.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Collection
+ */
 import { type AsyncIterableValue } from "../../../../_shared/types";
 import { type RecordItem } from "../../../../_shared/types";
 /**

package/dist/types/collection/implementations/async-iterable-collection/async-iterable-collection.d.ts

@@ -2,13 +2,14 @@
  * @module Collection
  */
 import { type AsyncCollapse, type AsyncPredicate, type AsyncForEach, type AsyncMap, type AsyncModifier, type AsyncTap, type AsyncTransform, type Comparator, type IAsyncCollection, type ChangendItem, type AsyncReduce, type CrossJoinResult } from "../../../collection/contracts/_module";
-import { type AsyncIterableValue, type AsyncLazyable, type EnsureType } from "../../../_shared/types";
+import { type AsyncIterableValue, type AsyncLazyable } from "../../../_shared/types";
 import { type RecordItem } from "../../../_shared/types";
 import type { TimeSpan } from "../../../utilities/_module";
 import { LazyPromise } from "../../../utilities/_module";
 /**
- * All methods that return <i>{@link IAsyncCollection}</i> are executed lazly which means they will be executed when the <i>AsyncIterableCollection</i> is iterated with <i>forEach</i> method or "for await of" loop.
- * The rest of the methods are executed eagerly.
+ * All methods that return <i>{@link IAsyncCollection}</i> are executed lazly.
+ * The methods that return <i>{@link IAsyncCollection}</i> will only be executed when <i>forEach</i> method is called or <i>for await</i> loop.
+ * The methods that return <i>{@link PromiseLike}</i> object will execute only when awaited or <i>then</i> method is called.
  * @group Adapters
  */
 export declare class AsyncIterableCollection<TInput> implements IAsyncCollection<TInput> {
@@ -30,16 +31,16 @@ export declare class AsyncIterableCollection<TInput> implements IAsyncCollection
     reduce(reduceFn: AsyncReduce<TInput, IAsyncCollection<TInput>, TInput>): LazyPromise<TInput>;
     reduce(reduceFn: AsyncReduce<TInput, IAsyncCollection<TInput>, TInput>, initialValue: TInput): LazyPromise<TInput>;
     reduce<TOutput>(reduceFn: AsyncReduce<TInput, IAsyncCollection<TInput>, TOutput>, initialValue: TOutput): LazyPromise<TOutput>;
-    join(separator?: string): LazyPromise<EnsureType<TInput, string>>;
+    join(separator?: string): LazyPromise<Extract<TInput, string>>;
     collapse(): IAsyncCollection<AsyncCollapse<TInput>>;
     flatMap<TOutput>(mapFn: AsyncMap<TInput, IAsyncCollection<TInput>, Iterable<TOutput>>): IAsyncCollection<TOutput>;
     change<TFilterOutput extends TInput, TMapOutput>(predicateFn: AsyncPredicate<TInput, IAsyncCollection<TInput>, TFilterOutput>, mapFn: AsyncMap<TFilterOutput, IAsyncCollection<TInput>, TMapOutput>): IAsyncCollection<ChangendItem<TInput, TFilterOutput, TMapOutput>>;
     page(page: number, pageSize: number): IAsyncCollection<TInput>;
-    sum(): LazyPromise<EnsureType<TInput, number>>;
-    average(): LazyPromise<EnsureType<TInput, number>>;
-    median(): LazyPromise<EnsureType<TInput, number>>;
-    min(): LazyPromise<EnsureType<TInput, number>>;
-    max(): LazyPromise<EnsureType<TInput, number>>;
+    sum(): LazyPromise<Extract<TInput, number>>;
+    average(): LazyPromise<Extract<TInput, number>>;
+    median(): LazyPromise<Extract<TInput, number>>;
+    min(): LazyPromise<Extract<TInput, number>>;
+    max(): LazyPromise<Extract<TInput, number>>;
     percentage(predicateFn: AsyncPredicate<TInput, IAsyncCollection<TInput>>): LazyPromise<number>;
     some<TOutput extends TInput>(predicateFn: AsyncPredicate<TInput, IAsyncCollection<TInput>, TOutput>): LazyPromise<boolean>;
     every<TOutput extends TInput>(predicateFn: AsyncPredicate<TInput, IAsyncCollection<TInput>, TOutput>): LazyPromise<boolean>;

package/dist/types/collection/implementations/iterable-collection/_shared/chunk-iterable.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Collection
+ */
 import { type ICollection } from "../../../../collection/contracts/_module";
 /**
  * @internal

package/dist/types/collection/implementations/iterable-collection/_shared/chunk-while-iterable.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Collection
+ */
 import { type Predicate, type ICollection } from "../../../../collection/contracts/_module";
 /**
  * @internal

package/dist/types/collection/implementations/iterable-collection/_shared/collapse-iterable.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Collection
+ */
 import { type Collapse, type ICollection } from "../../../../collection/contracts/_module";
 /**
  * @internal

package/dist/types/collection/implementations/iterable-collection/_shared/count-by-iterable.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Collection
+ */
 import { type ICollection, type Map } from "../../../../collection/contracts/_module";
 import { type RecordItem } from "../../../../_shared/types";
 /**

package/dist/types/collection/implementations/iterable-collection/_shared/cross-join-iterable.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Collection
+ */
 import type { CrossJoinResult, ICollection } from "../../../../collection/contracts/_module";
 export declare class CrossJoinIterable<TInput, TExtended = TInput> implements Iterable<CrossJoinResult<TInput, TExtended>> {
     private collection;

package/dist/types/collection/implementations/iterable-collection/_shared/entries-iterable.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Collection
+ */
 import { type RecordItem } from "../../../../_shared/types";
 /**
  * @internal

package/dist/types/collection/implementations/iterable-collection/_shared/filter-iterable.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Collection
+ */
 import { type Predicate, type ICollection } from "../../../../collection/contracts/_module";
 /**
  * @internal

package/dist/types/collection/implementations/iterable-collection/_shared/flat-map-iterable.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Collection
+ */
 import { type ICollection, type Map } from "../../../../collection/contracts/_module";
 /**
  * @internal

package/dist/types/collection/implementations/iterable-collection/_shared/group-by-iterable.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Collection
+ */
 import { type ICollection, type Map } from "../../../../collection/contracts/_module";
 import { type RecordItem } from "../../../../_shared/types";
 /**

package/dist/types/collection/implementations/iterable-collection/_shared/insert-after-iterable.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Collection
+ */
 import { type Predicate, type ICollection } from "../../../../collection/contracts/_module";
 /**
  * @internal

package/dist/types/collection/implementations/iterable-collection/_shared/insert-before-iterable.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Collection
+ */
 import { type Predicate, type ICollection } from "../../../../collection/contracts/_module";
 /**
  * @internal

package/dist/types/collection/implementations/iterable-collection/_shared/map-iterable.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Collection
+ */
 import { type ICollection, type Map } from "../../../../collection/contracts/_module";
 /**
  * @internal

package/dist/types/collection/implementations/iterable-collection/_shared/merge-iterable.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Collection
+ */
 /**
  * @internal
  */

package/dist/types/collection/implementations/iterable-collection/_shared/pad-end-iterable.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Collection
+ */
 import { type ICollection } from "../../../../collection/contracts/_module";
 /**
  * @internal

package/dist/types/collection/implementations/iterable-collection/_shared/pad-start-iterable.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Collection
+ */
 import { type ICollection } from "../../../../collection/contracts/_module";
 /**
  * @internal

package/dist/types/collection/implementations/iterable-collection/_shared/partion-iterable.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Collection
+ */
 import { type Predicate, type ICollection } from "../../../../collection/contracts/_module";
 /**
  * @internal

package/dist/types/collection/implementations/iterable-collection/_shared/repeat-iterable.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Collection
+ */
 import { type ICollection } from "../../../../collection/contracts/_module";
 /**
  * @internal

package/dist/types/collection/implementations/iterable-collection/_shared/reverse-iterable.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Collection
+ */
 import { type ICollection } from "../../../../collection/contracts/_module";
 /**
  * @internal

package/dist/types/collection/implementations/iterable-collection/_shared/shuffle-iterable.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Collection
+ */
 /**
  * @internal
  */

package/dist/types/collection/implementations/iterable-collection/_shared/skip-iterable.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Collection
+ */
 import { type ICollection } from "../../../../collection/contracts/_module";
 /**
  * @internal

package/dist/types/collection/implementations/iterable-collection/_shared/skip-until-iterable.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Collection
+ */
 import { type Predicate, type ICollection } from "../../../../collection/contracts/_module";
 /**
  * @internal

package/dist/types/collection/implementations/iterable-collection/_shared/slice-iterable.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Collection
+ */
 import { type ICollection } from "../../../../collection/contracts/_module";
 /**
  * @internal

package/dist/types/collection/implementations/iterable-collection/_shared/sliding-iterable.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Collection
+ */
 import { type ICollection } from "../../../../collection/contracts/_module";
 /**
  * @internal

package/dist/types/collection/implementations/iterable-collection/_shared/sort-iterable.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Collection
+ */
 import { type Comparator } from "../../../../collection/contracts/_module";
 /**
  * @internal

package/dist/types/collection/implementations/iterable-collection/_shared/split-iterable.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Collection
+ */
 import { type ICollection } from "../../../../collection/contracts/_module";
 /**
  * @internal

package/dist/types/collection/implementations/iterable-collection/_shared/take-iterable.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Collection
+ */
 import { type ICollection } from "../../../../collection/contracts/_module";
 /**
  * @internal

package/dist/types/collection/implementations/iterable-collection/_shared/take-until-iterable.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Collection
+ */
 import { type Predicate, type ICollection } from "../../../../collection/contracts/_module";
 /**
  * @internal

package/dist/types/collection/implementations/iterable-collection/_shared/tap-iterable.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Collection
+ */
 import { type ICollection, type Tap } from "../../../../collection/contracts/_module";
 /**
  * @internal

package/dist/types/collection/implementations/iterable-collection/_shared/unique-iterable.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Collection
+ */
 import { type ICollection, type Map } from "../../../../collection/contracts/_module";
 /**
  * @internal

package/dist/types/collection/implementations/iterable-collection/_shared/update-iterable.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Collection
+ */
 import { type Predicate, type ICollection, type Map, type ChangendItem } from "../../../../collection/contracts/_module";
 /**
  * @internal

package/dist/types/collection/implementations/iterable-collection/_shared/when-iterable.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Collection
+ */
 import { type ICollection, type Modifier } from "../../../../collection/contracts/_module";
 /**
  * @internal

package/dist/types/collection/implementations/iterable-collection/_shared/zip-iterable.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Collection
+ */
 import { type RecordItem } from "../../../../_shared/types";
 /**
  * @internal

package/dist/types/collection/implementations/iterable-collection/iterable-collection.d.ts

@@ -2,7 +2,7 @@
  * @module Collection
  */
 import { type Collapse, type Comparator, type Predicate, type ForEach, type ICollection, type Map, type Modifier, type Tap, type Transform, type ChangendItem, type Reduce, type CrossJoinResult } from "../../../collection/contracts/_module";
-import { type Lazyable, type EnsureType } from "../../../_shared/types";
+import { type Lazyable } from "../../../_shared/types";
 import { type RecordItem } from "../../../_shared/types";
 /**
  * All methods that return <i>{@link ICollection}</i> are executed lazly which means they will be executed when the <i>IterableCollection</i> is iterated with <i>forEach</i> method or "for of" loop.
@@ -28,16 +28,16 @@ export declare class IterableCollection<TInput> implements ICollection<TInput> {
     reduce(reduceFn: Reduce<TInput, ICollection<TInput>, TInput>): TInput;
     reduce(reduceFn: Reduce<TInput, ICollection<TInput>, TInput>, initialValue: TInput): TInput;
     reduce<TOutput>(reduceFn: Reduce<TInput, ICollection<TInput>, TOutput>, initialValue: TOutput): TOutput;
-    join(separator?: string): EnsureType<TInput, string>;
+    join(separator?: string): Extract<TInput, string>;
     collapse(): ICollection<Collapse<TInput>>;
     flatMap<TOutput>(mapFn: Map<TInput, ICollection<TInput>, Iterable<TOutput>>): ICollection<TOutput>;
     change<TFilterOutput extends TInput, TMapOutput>(predicateFn: Predicate<TInput, ICollection<TInput>, TFilterOutput>, mapFn: Map<TFilterOutput, ICollection<TInput>, TMapOutput>): ICollection<ChangendItem<TInput, TFilterOutput, TMapOutput>>;
     page(page: number, pageSize: number): ICollection<TInput>;
-    sum(): EnsureType<TInput, number>;
-    average(): EnsureType<TInput, number>;
-    median(): EnsureType<TInput, number>;
-    min(): EnsureType<TInput, number>;
-    max(): EnsureType<TInput, number>;
+    sum(): Extract<TInput, number>;
+    average(): Extract<TInput, number>;
+    median(): Extract<TInput, number>;
+    min(): Extract<TInput, number>;
+    max(): Extract<TInput, number>;
     percentage(predicateFn: Predicate<TInput, ICollection<TInput>>): number;
     some<TOutput extends TInput>(predicateFn: Predicate<TInput, ICollection<TInput>, TOutput>): boolean;
     every<TOutput extends TInput>(predicateFn: Predicate<TInput, ICollection<TInput>, TOutput>): boolean;

package/dist/types/collection/implementations/list-collection/list-collection.d.ts

@@ -2,7 +2,7 @@
  * @module Collection
  */
 import { type Collapse, type Comparator, type Predicate, type ICollection, type Map, type Modifier, type Tap, type Transform, type ChangendItem, type Reduce, type ForEach, type CrossJoinResult } from "../../../collection/contracts/_module";
-import { type EnsureType, type Lazyable } from "../../../_shared/types";
+import { type Lazyable } from "../../../_shared/types";
 import { type RecordItem } from "../../../_shared/types";
 /**
  * All methods in <i>ListCollection</i> are executed eagerly.
@@ -25,16 +25,16 @@ export declare class ListCollection<TInput> implements ICollection<TInput> {
     reduce(reduceFn: Reduce<TInput, ICollection<TInput>, TInput>): TInput;
     reduce(reduceFn: Reduce<TInput, ICollection<TInput>, TInput>, initialValue: TInput): TInput;
     reduce<TOutput>(reduceFn: Reduce<TInput, ICollection<TInput>, TOutput>, initialValue: TOutput): TOutput;
-    join(separator?: string): EnsureType<TInput, string>;
+    join(separator?: string): Extract<TInput, string>;
     collapse(): ICollection<Collapse<TInput>>;
     flatMap<TOutput>(mapFn: Map<TInput, ICollection<TInput>, Iterable<TOutput>>): ICollection<TOutput>;
     change<TFilterOutput extends TInput, TMapOutput>(predicateFn: Predicate<TInput, ICollection<TInput>, TFilterOutput>, mapFn: Map<TFilterOutput, ICollection<TInput>, TMapOutput>): ICollection<ChangendItem<TInput, TFilterOutput, TMapOutput>>;
     page(page: number, pageSize: number): ICollection<TInput>;
-    sum(): EnsureType<TInput, number>;
-    average(): EnsureType<TInput, number>;
-    median(): EnsureType<TInput, number>;
-    min(): EnsureType<TInput, number>;
-    max(): EnsureType<TInput, number>;
+    sum(): Extract<TInput, number>;
+    average(): Extract<TInput, number>;
+    median(): Extract<TInput, number>;
+    min(): Extract<TInput, number>;
+    max(): Extract<TInput, number>;
     percentage(predicateFn: Predicate<TInput, ICollection<TInput>>): number;
     some<TOutput extends TInput>(predicateFn: Predicate<TInput, ICollection<TInput>, TOutput>): boolean;
     every<TOutput extends TInput>(predicateFn: Predicate<TInput, ICollection<TInput>, TOutput>): boolean;

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

@@ -0,0 +1,4 @@
+export * from "../../event-bus/contracts/_shared";
+export * from "../../event-bus/contracts/event-bus.contract";
+export * from "../../event-bus/contracts/event-bus-adapter.contract";
+export * from "../../event-bus/contracts/event-bus-manager.contract";

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

@@ -0,0 +1,32 @@
+/**
+ * @module EventBus
+ */
+import type { Promisable } from "../../_shared/types";
+export type IBaseEvent = {
+    type: string;
+};
+export type Listener<TEvent extends IBaseEvent> = (event: TEvent) => Promisable<void>;
+/**
+ * @group Errors
+ */
+export declare class EventBusError extends Error {
+    constructor(message: string, cause?: unknown);
+}
+/**
+ * @group Errors
+ */
+export declare class RemoveListenerEventBusError extends Error {
+    constructor(message: string, cause?: unknown);
+}
+/**
+ * @group Errors
+ */
+export declare class AddListenerEventBusError extends Error {
+    constructor(message: string, cause?: unknown);
+}
+/**
+ * @group Errors
+ */
+export declare class DispatchEventBusError extends Error {
+    constructor(message: string, cause?: unknown);
+}

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

@@ -0,0 +1,23 @@
+/**
+ * @module EventBus
+ */
+import type { IBaseEvent, Listener } from "../../event-bus/contracts/_shared";
+/**
+ * The <i>IEventBusAdapter</i> contract defines a way for dispatching and listening to events independent of underlying technology.
+ * This interface is not meant to be used directly, instead you should use <i>IEventBus</i>
+ * @group Contracts
+ */
+export type IEventBusAdapter = {
+    /**
+     * The <i>addListener</i> method is used for adding <i>{@link Listener | listener}</i> for certain <i>event</i>.
+     */
+    addListener(event: string, listener: Listener<IBaseEvent>): PromiseLike<void>;
+    /**
+     * The <i>removeListener</i> method is used for removing <i>{@link Listener | listener}</i> for certain <i>event</i>.
+     */
+    removeListener(event: string, listener: Listener<IBaseEvent>): PromiseLike<void>;
+    /**
+     * The <i>dispatch</i> method is used for dispatching one or multiple <i>events</i>.
+     */
+    dispatch(events: IBaseEvent[]): PromiseLike<void>;
+};

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

@@ -0,0 +1,20 @@
+/**
+ * @module EventBus
+ */
+import type { Validator } from "../../utilities/_module";
+import type { INamespacedEventBus } from "../../event-bus/contracts/event-bus.contract";
+import type { IBaseEvent } from "../../event-bus/contracts/_shared";
+/**
+ * @group Contracts
+ */
+export type EventBusManagerUseSettings<TType, TAdapters extends string = string> = {
+    adapter?: TAdapters;
+    validator?: Validator<TType>;
+};
+/**
+ * The <i>IEventBusManager</i> contract makes it easy to switch between different <i>{@link IEventBusAdapter | event bus adapters}</i> dynamically.
+ * @group Contracts
+ */
+export type IEventBusManager<TAdapters extends string = string> = {
+    use<TEvents extends IBaseEvent = IBaseEvent>(settings?: EventBusManagerUseSettings<TEvents, TAdapters>): INamespacedEventBus<TEvents>;
+};

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

@@ -0,0 +1,91 @@
+/**
+ * @module EventBus
+ */
+import type { OneOrMore } from "../../_shared/types";
+import type { IBaseEvent, Listener } from "../../event-bus/contracts/_shared";
+export type SelectEvent<TEvents extends IBaseEvent, TEventType extends TEvents["type"]> = Extract<TEvents, {
+    type: IBaseEvent extends TEvents ? string : TEventType;
+}>;
+export type Unsubscribe = () => PromiseLike<void>;
+/**
+ * The <i>IListenable</i> contract defines a way listening to events independent of underlying technology
+ * @throws {EventBusError} {@link EventBusError}
+ * @throws {AddListenerEventBusError} {@link AddListenerEventBusError}
+ * @throws {RemoveListenerEventBusError} {@link RemoveListenerEventBusError}
+ * @group Contracts
+ */
+export type IListenable<TEvents extends IBaseEvent = IBaseEvent> = {
+    /**
+     * 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 {EventBusError} {@link EventBusError}
+     * @throws {AddListenerEventBusError} {@link AddListenerEventBusError}
+     */
+    addListener<TEventType extends TEvents["type"]>(event: TEventType, listener: Listener<SelectEvent<TEvents, TEventType>>): PromiseLike<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 {EventBusError} {@link EventBusError}
+     * @throws {AddListenerEventBusError} {@link AddListenerEventBusError}
+     */
+    addListenerMany<TEventType extends TEvents["type"]>(events: TEventType[], listener: Listener<SelectEvent<TEvents, TEventType>>): PromiseLike<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 {EventBusError} {@link EventBusError}
+     * @throws {RemoveListenerEventBusError} {@link RemoveListenerEventBusError}
+     */
+    removeListener<TEventType extends TEvents["type"]>(event: TEventType, listener: Listener<SelectEvent<TEvents, TEventType>>): PromiseLike<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 {EventBusError} {@link EventBusError}
+     * @throws {RemoveListenerEventBusError} {@link RemoveListenerEventBusError}
+     */
+    removeListenerMany<TEventType extends TEvents["type"]>(events: TEventType[], listener: Listener<SelectEvent<TEvents, TEventType>>): PromiseLike<void>;
+    /**
+     * The <i>subscribe</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 {EventBusError} {@link EventBusError}
+     * @throws {RemoveListenerEventBusError} {@link RemoveListenerEventBusError}
+     */
+    subscribe<TEventType extends TEvents["type"]>(event: TEventType, listener: Listener<SelectEvent<TEvents, TEventType>>): PromiseLike<Unsubscribe>;
+    subscribeMany<TEventType extends TEvents["type"]>(events: TEventType[], listener: Listener<SelectEvent<TEvents, TEventType>>): PromiseLike<Unsubscribe>;
+};
+/**
+ * The <i>IEventBus</i> contract defines a way for dispatching and listening to events independent of underlying technology.
+ * It commes with more convient methods compared to <i>IEventBusAdapter</i>.
+ * @throws {EventBusError} {@link EventBusError}
+ * @throws {DispatchEventBusError} {@link DispatchEventBusError}
+ * @throws {AddListenerEventBusError} {@link AddListenerEventBusError}
+ * @throws {RemoveListenerEventBusError} {@link RemoveListenerEventBusError}
+ * @group Contracts
+ */
+export type IEventBus<TEvents extends IBaseEvent = IBaseEvent> = IListenable<TEvents> & {
+    /**
+     * The <i>dispatch</i> method is used for dispatching one or multiple <i>events</i>.
+     * @throws {EventBusError} {@link EventBusError}
+     * @throws {DispatchEventBusError} {@link DispatchEventBusError}
+     */
+    dispatch(events: OneOrMore<TEvents>): PromiseLike<void>;
+};
+/**
+ * The <i>INamespacedEventBus</i> contract defines a way for dispatching and listening to events independent of underlying technology.
+ * It commes with one extra method which is useful for multitennat applications compared to <i>IEventBus</i>.
+ * @throws {EventBusError} {@link EventBusError}
+ * @throws {DispatchEventBusError} {@link DispatchEventBusError}
+ * @throws {AddListenerEventBusError} {@link AddListenerEventBusError}
+ * @throws {RemoveListenerEventBusError} {@link RemoveListenerEventBusError}
+ * @group Contracts
+ */
+export type INamespacedEventBus<TEvents extends IBaseEvent = IBaseEvent> = IEventBus<TEvents> & {
+    /**
+     * The <i>withNamespace</i> method returns new instance of <i>{@link IEventBus}</i> where all the events names will be prefixed with a given <i>namespace</i>.
+     * This useful for multitennat applications.
+     */
+    withNamespace(namespace: string): IEventBus<TEvents>;
+    /**
+     * The <i>getNamespace</i> method return the complete namespace.
+     */
+    getNamespace(): string;
+};

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

@@ -0,0 +1,5 @@
+export * from "../../event-bus/implementations/_shared/test-utilities/_module";
+export * from "../../event-bus/implementations/event-bus/_module";
+export * from "../../event-bus/implementations/memory-event-bus-adapter/_module";
+export * from "../../event-bus/implementations/redis-event-bus-adapter/_module";
+export * from "../../event-bus/implementations/no-op-event-bus-adapter/_module";

package/dist/types/event-bus/implementations/_shared/test-utilities/_module.d.ts

@@ -0,0 +1 @@
+export * from "../../../../event-bus/implementations/_shared/test-utilities/event-bus-adapter.test-suite";

package/dist/types/event-bus/implementations/_shared/test-utilities/event-bus-adapter.test-suite.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @module EventBus
+ */
+import { type TestAPI, type SuiteAPI, type ExpectStatic, type beforeEach } from "vitest";
+import type { IEventBusAdapter } from "../../../../event-bus/contracts/_module";
+import { type Promisable } from "../../../../_shared/types";
+/**
+ * @group Utilities
+ */
+export type EventBusTestSuiteSettings = {
+    expect: ExpectStatic;
+    test: TestAPI;
+    describe: SuiteAPI;
+    beforeEach: typeof beforeEach;
+    createAdapter: () => Promisable<IEventBusAdapter>;
+};
+/**
+ * @group Utilities
+ */
+export declare function eventBusTestSuite(settings: EventBusTestSuiteSettings): void;

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

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