@daiso-tech/core 0.14.0 → 0.15.0

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

@@ -1,7 +1,7 @@
 /**
  * @module Collection
  */
-import { type AsyncIterableValue } from "../../../../_shared/types";
+import { type AsyncIterableValue } from "../../../../utilities/_module";
 /**
  * @internal
  */

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

@@ -3,9 +3,9 @@
  */
 import type { EnsureMap, EnsureRecord } from "../../../collection/contracts/_module";
 import { type AsyncCollapse, type AsyncPredicate, type AsyncForEach, type AsyncMap, type AsyncModifier, type AsyncTap, type AsyncTransform, type Comparator, type IAsyncCollection, type AsyncReduce, type CrossJoinResult } from "../../../collection/contracts/_module";
-import { type AsyncIterableValue, type AsyncLazyable } from "../../../_shared/types";
+import { type AsyncIterableValue, type AsyncLazyable } from "../../../utilities/_module";
 import type { TimeSpan } from "../../../utilities/_module";
-import { LazyPromise } from "../../../utilities/_module";
+import { LazyPromise } from "../../../async/_module";
 /**
  * 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.
@@ -14,6 +14,7 @@ import { LazyPromise } from "../../../utilities/_module";
  */
 export declare class AsyncIterableCollection<TInput> implements IAsyncCollection<TInput> {
     private readonly iterable;
+    private static createLazyPromise;
     private static DEFAULT_CHUNK_SIZE;
     private static makeCollection;
     /**
@@ -97,7 +98,7 @@ export declare class AsyncIterableCollection<TInput> implements IAsyncCollection
     nth(step: number): IAsyncCollection<TInput>;
     delay(time: TimeSpan): IAsyncCollection<TInput>;
     takeUntilAbort(abortSignal: AbortSignal): IAsyncCollection<TInput>;
-    takeUntilTimeout(timeInMs: TimeSpan): IAsyncCollection<TInput>;
+    takeUntilTimeout(time: TimeSpan): IAsyncCollection<TInput>;
     count(predicateFn: AsyncPredicate<TInput, IAsyncCollection<TInput>>): LazyPromise<number>;
     size(): LazyPromise<number>;
     isEmpty(): LazyPromise<boolean>;

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

@@ -3,7 +3,7 @@
  */
 import type { EnsureMap, EnsureRecord } from "../../../collection/contracts/_module";
 import { type Collapse, type Comparator, type Predicate, type ForEach, type ICollection, type Map, type Modifier, type Tap, type Transform, type Reduce, type CrossJoinResult } from "../../../collection/contracts/_module";
-import { type Lazyable } from "../../../_shared/types";
+import { type Lazyable } from "../../../utilities/_module";
 /**
  * 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.
  * The rest of the methods are executed eagerly.

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

@@ -3,7 +3,7 @@
  */
 import type { EnsureMap, EnsureRecord } from "../../../collection/contracts/_module";
 import { type Collapse, type Comparator, type Predicate, type ICollection, type Map, type Modifier, type Tap, type Transform, type Reduce, type ForEach, type CrossJoinResult } from "../../../collection/contracts/_module";
-import { type Lazyable } from "../../../_shared/types";
+import { type Lazyable } from "../../../utilities/_module";
 /**
  * All methods in <i>ListCollection</i> are executed eagerly.
  * @group Adapters

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

@@ -1,8 +1,5 @@
 /**
  * @module EventBus
  */
-import type { Promisable } from "../../_shared/types";
-export type IBaseEvent = {
-    type: string;
-};
-export type Listener<TEvent extends IBaseEvent> = (event: TEvent) => Promisable<void>;
+import type { Promisable } from "../../utilities/_module";
+export type Listener<TEvent> = (event: TEvent) => Promisable<void>;

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

@@ -1,7 +1,10 @@
 /**
  * @module EventBus
  */
-import type { IBaseEvent, Listener } from "../../event-bus/contracts/_shared";
+import type { Listener } from "../../event-bus/contracts/_shared";
+export type IBaseEvent = {
+    type: string;
+};
 /**
  * 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>

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

@@ -1,13 +1,12 @@
 /**
  * @module EventBus
  */
-import type { INamespacedEventBus } from "../../event-bus/contracts/event-bus.contract";
-import type { IBaseEvent } from "../../event-bus/contracts/_shared";
+import type { BaseEvents, INamespacedEventBus } from "../../event-bus/contracts/event-bus.contract";
 /**
  * The <i>IEventBusFactory</i> contract makes it easy to configure and switch between different <i>{@link INamespacedEventBus}</i> dynamically.
  * @group Contracts
  */
-export type IEventBusFactory<TDrivers extends string = string, TEvents extends IBaseEvent = IBaseEvent> = {
+export type IEventBusFactory<TDrivers extends string = string, TEvents extends BaseEvents = BaseEvents> = {
     /**
      * The <i>use</i> method will throw an error if you provide it unregisted driver.
      * If no default driver is defined an error will be thrown by <i>use</i> method.

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

@@ -1,71 +1,79 @@
 /**
  * @module EventBus
  */
-import type { LazyPromise } from "../../utilities/_module";
-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;
+import type { OneOrMore, Values } from "../../utilities/_module";
+import type { LazyPromise } from "../../async/_module";
+import type { Listener } from "../../event-bus/contracts/_shared";
+export type BaseEvents = Record<string, Record<string, unknown>>;
+export type AllEvents<TEvents extends BaseEvents> = Values<{
+    [TEventName in keyof TEvents]: TEvents[TEventName] & {
+        type: TEventName;
+    };
 }>;
+export type SelectEvent<TEvents extends BaseEvents, TEventName extends keyof TEvents> = {
+    [TEventName in keyof TEvents]: TEvents[TEventName] & {
+        type: TEventName;
+    };
+}[TEventName];
 export type Unsubscribe = () => LazyPromise<void>;
 /**
  * The <i>IListenable</i> contract defines a way listening to events independent of underlying technology
  * @group Contracts
  */
-export type IListenable<TEvents extends IBaseEvent = IBaseEvent> = {
+export type IListenable<TEvents extends BaseEvents = BaseEvents> = {
     /**
      * 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}
      */
-    addListener<TEventType extends TEvents["type"]>(event: TEventType, listener: Listener<SelectEvent<TEvents, TEventType>>): LazyPromise<void>;
+    addListener<TEventName extends keyof TEvents>(eventName: TEventName, listener: Listener<SelectEvent<TEvents, TEventName>>): 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}
      */
-    addListenerMany<TEventType extends TEvents["type"]>(events: TEventType[], listener: Listener<SelectEvent<TEvents, TEventType>>): LazyPromise<void>;
+    addListenerMany<TEventName extends keyof TEvents>(eventNames: TEventName[], listener: Listener<SelectEvent<TEvents, TEventName>>): 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}
      */
-    removeListener<TEventType extends TEvents["type"]>(event: TEventType, listener: Listener<SelectEvent<TEvents, TEventType>>): LazyPromise<void>;
+    removeListener<TEventName extends keyof TEvents>(eventName: TEventName, listener: Listener<SelectEvent<TEvents, TEventName>>): 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}
      */
-    removeListenerMany<TEventType extends TEvents["type"]>(events: TEventType[], listener: Listener<SelectEvent<TEvents, TEventType>>): LazyPromise<void>;
+    removeListenerMany<TEventName extends keyof TEvents>(eventNames: TEventName[], listener: Listener<SelectEvent<TEvents, TEventName>>): LazyPromise<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.
      */
-    subscribe<TEventType extends TEvents["type"]>(event: TEventType, listener: Listener<SelectEvent<TEvents, TEventType>>): LazyPromise<Unsubscribe>;
+    subscribe<TEventName extends keyof TEvents>(eventName: TEventName, listener: Listener<SelectEvent<TEvents, TEventName>>): LazyPromise<Unsubscribe>;
     /**
      * The <i>subscribeMany</i> method is used for adding <i>{@link Listener | listener}</i> for multiple <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.
      */
-    subscribeMany<TEventType extends TEvents["type"]>(events: TEventType[], listener: Listener<SelectEvent<TEvents, TEventType>>): LazyPromise<Unsubscribe>;
+    subscribeMany<TEventName extends keyof TEvents>(eventNames: TEventName[], listener: Listener<SelectEvent<TEvents, TEventName>>): LazyPromise<Unsubscribe>;
 };
 /**
  * The <i>IDispatcher</i> contract defines a way for dispatching to events independent of underlying technology.
  * @group Contracts
  */
-export type IDispatcher<TEvents extends IBaseEvent = IBaseEvent> = {
+export type IDispatcher<TEvents extends BaseEvents = BaseEvents> = {
     /**
      * The <i>dispatch</i> method is used for dispatching one or multiple <i>events</i>.
 
      * @throws {DispatchEventBusError} {@link DispatchEventBusError}
      */
-    dispatch(events: OneOrMore<TEvents>): LazyPromise<void>;
+    dispatch(events: OneOrMore<AllEvents<TEvents>>): LazyPromise<void>;
 };
 /**
  * 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>.
  * @group Contracts
  */
-export type IEventBus<TEvents extends IBaseEvent = IBaseEvent> = IListenable<TEvents> & IDispatcher<TEvents> & {
+export type IEventBus<TEvents extends BaseEvents = BaseEvents> = IListenable<TEvents> & IDispatcher<TEvents> & {
     /**
      * The <i>getNamespace</i> method returns the complete namespace.
      * @example
@@ -90,7 +98,7 @@ export type IEventBus<TEvents extends IBaseEvent = IBaseEvent> = IListenable<TEv
  * It commes with one extra method which is useful for multitennat applications compared to <i>IEventBus</i>.
  * @group Contracts
  */
-export type INamespacedEventBus<TEvents extends IBaseEvent = IBaseEvent> = IEventBus<TEvents> & {
+export type INamespacedEventBus<TEvents extends BaseEvents = BaseEvents> = 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.

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

@@ -16,18 +16,18 @@ export declare class UnexpectedEventBusError extends EventBusError {
 /**
  * @group Errors
  */
-export declare class RemoveListenerEventBusError extends Error {
+export declare class RemoveListenerEventBusError extends UnexpectedEventBusError {
     constructor(message: string, cause?: unknown);
 }
 /**
  * @group Errors
  */
-export declare class AddListenerEventBusError extends Error {
+export declare class AddListenerEventBusError extends UnexpectedEventBusError {
     constructor(message: string, cause?: unknown);
 }
 /**
  * @group Errors
  */
-export declare class DispatchEventBusError extends Error {
+export declare class DispatchEventBusError extends UnexpectedEventBusError {
     constructor(message: string, cause?: unknown);
 }

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

@@ -1,3 +1,3 @@
-export * from "../../event-bus/implementations/_shared/test-utilities/_module";
+export * from "../../event-bus/implementations/_shared/_module";
 export * from "../../event-bus/implementations/derivables/_module";
 export * from "../../event-bus/implementations/adapters/_module";

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

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

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

@@ -0,0 +1,59 @@
+/**
+ * @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 "../../../utilities/_module";
+/**
+ * @group Utilities
+ */
+export type EventBusAdapterTestSuiteSettings = {
+    expect: ExpectStatic;
+    test: TestAPI;
+    describe: SuiteAPI;
+    beforeEach: typeof beforeEach;
+    createAdapter: () => Promisable<IEventBusAdapter>;
+};
+/**
+ * The <i>eventBusAdapterTestSuite</i> function simplifies the process of testing your custom implementation of <i>{@link IEventBusAdapter}</i> with vitest.
+ * @group Utilities
+ * @example
+ * ```ts
+ * import { describe, test, beforeEach, expect, afterEach } from "vitest";
+ * import type { StartedRedisContainer } from "@testcontainers/redis";
+ * import { RedisContainer } from "@testcontainers/redis";
+ * import Redis from "ioredis";
+ * import { SuperJsonSerializer, TimeSpan, RedisEventBusAdapter, eventBusAdapterTestSuite } from "@daiso-tech/core";
+ *
+ * const timeout = TimeSpan.fromMinutes(2);
+ * describe("class: RedisEventBusAdapter", () => {
+ *   let dispatcherClient: Redis;
+ *   let listenerClient: Redis;
+ *   let startedContainer: StartedRedisContainer;
+ *   const serializer = new SuperJsonSerializer();
+ *   beforeEach(async () => {
+ *     startedContainer = await new RedisContainer().start();
+ *     dispatcherClient = new Redis(startedContainer.getConnectionUrl());
+ *     listenerClient = new Redis(startedContainer.getConnectionUrl());
+ *   }, timeout.toMilliseconds());
+ *   afterEach(async () => {
+ *     await dispatcherClient.quit();
+ *     await listenerClient.quit();
+ *     await startedContainer.stop();
+ *   }, timeout.toMilliseconds());
+ *    eventBusAdapterTestSuite({
+ *      createAdapter: () =>
+ *        new RedisEventBusAdapter({
+ *          dispatcherClient,
+ *          listenerClient,
+ *          serializer,
+ *        }),
+ *      test,
+ *      beforeEach,
+ *      expect,
+ *      describe,
+ *   });
+ * });
+ * ```
+ */
+export declare function eventBusAdapterTestSuite(settings: EventBusAdapterTestSuiteSettings): void;

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

@@ -0,0 +1,72 @@
+/**
+ * @module EventBus
+ */
+import { type TestAPI, type SuiteAPI, type ExpectStatic, type beforeEach } from "vitest";
+import type { IEventBus } from "../../../event-bus/contracts/_module";
+import { type Promisable } from "../../../utilities/_module";
+/**
+ * @group Utilities
+ */
+export type EventBusTestSuiteSettings = {
+    expect: ExpectStatic;
+    test: TestAPI;
+    describe: SuiteAPI;
+    beforeEach: typeof beforeEach;
+    createEventBusA: () => Promisable<IEventBus>;
+    createEventBusB: () => Promisable<IEventBus>;
+};
+/**
+ * The <i>eventBusTestSuite</i> function simplifies the process of testing your custom implementation of <i>{@link IEventBus}</i> with vitest.
+ * @group Utilities
+ * @example
+ * ```ts
+ * import { describe, test, beforeEach, expect, afterEach } from "vitest";
+ * import type { StartedRedisContainer } from "@testcontainers/redis";
+ * import { RedisContainer } from "@testcontainers/redis";
+ * import Redis from "ioredis";
+ * import { SuperJsonSerializer, TimeSpan, RedisEventBusAdapter, eventBusTestSuite } from "@daiso-tech/core";
+ *
+ * const timeout = TimeSpan.fromMinutes(2);
+ * describe("class: EventBus", () => {
+ *   let dispatcherClient: Redis;
+ *   let listenerClient: Redis;
+ *   let startedContainer: StartedRedisContainer;
+ *   const serializer = new SuperJsonSerializer();
+ *   beforeEach(async () => {
+ *     startedContainer = await new RedisContainer().start();
+ *     dispatcherClient = new Redis(startedContainer.getConnectionUrl());
+ *     listenerClient = new Redis(startedContainer.getConnectionUrl());
+ *   }, timeout.toMilliseconds());
+ *   afterEach(async () => {
+ *     await dispatcherClient.quit();
+ *     await listenerClient.quit();
+ *     await startedContainer.stop();
+ *   }, timeout.toMilliseconds());
+ *    eventBusTestSuite({
+ *      createEventBusA: () =>
+ *        new EventBus(
+ *          new RedisEventBusAdapter({
+ *            dispatcherClient,
+ *            listenerClient,
+ *            serializer,
+ *          }),
+ *          { rootNamespace: "@a" }
+ *        ),
+ *      createEventBusB: () =>
+ *        new EventBus(
+ *          new RedisEventBusAdapter({
+ *            dispatcherClient,
+ *            listenerClient,
+ *            serializer,
+ *          }),
+ *          { rootNamespace: "@b" }
+ *        ),
+ *      test,
+ *      beforeEach,
+ *      expect,
+ *      describe,
+ *   });
+ * });
+ * ```
+ */
+export declare function eventBusTestSuite(settings: EventBusTestSuiteSettings): void;

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

@@ -1,23 +1,23 @@
 /**
  * @module EventBus
  */
-import { LazyPromise } from "../../../utilities/_module";
-import type { SelectEvent, Unsubscribe } from "../../../event-bus/contracts/_module";
-import { type IEventBus, type INamespacedEventBus, type Listener, type IBaseEvent } from "../../../event-bus/contracts/_module";
-import type { OneOrMore } from "../../../_shared/types";
+import { LazyPromise } from "../../../async/_module";
+import type { SelectEvent, BaseEvents, Unsubscribe, AllEvents } from "../../../event-bus/contracts/_module";
+import { type IEventBus, type INamespacedEventBus, type Listener } from "../../../event-bus/contracts/_module";
+import type { OneOrMore } from "../../../utilities/_module";
 /**
  * The BaseEventBus class serves as an abstract base class that provides implementations for redundant methods.
  * It simplifies implementing the {@link INamespacedEventBus} interface without using an {@link IEventBusAdapter}.
  * @group Derivables
  */
-export declare abstract class BaseEventBus<TEvents extends IBaseEvent> implements INamespacedEventBus<TEvents> {
+export declare abstract class BaseEventBus<TEvents extends BaseEvents = BaseEvents> implements INamespacedEventBus<TEvents> {
     abstract withNamespace(namespace: OneOrMore<string>): IEventBus<TEvents>;
     abstract getNamespace(): string;
-    abstract addListener<TEventType extends TEvents["type"]>(event: TEventType, listener: Listener<SelectEvent<TEvents, TEventType>>): LazyPromise<void>;
-    addListenerMany<TEventType extends TEvents["type"]>(events: TEventType[], listener: Listener<SelectEvent<TEvents, TEventType>>): LazyPromise<void>;
-    abstract removeListener<TEventType extends TEvents["type"]>(event: TEventType, listener: Listener<SelectEvent<TEvents, TEventType>>): LazyPromise<void>;
-    removeListenerMany<TEventType extends TEvents["type"]>(events: TEventType[], listener: Listener<SelectEvent<TEvents, TEventType>>): LazyPromise<void>;
-    subscribe<TEventType extends TEvents["type"]>(event: TEventType, listener: Listener<SelectEvent<TEvents, TEventType>>): LazyPromise<Unsubscribe>;
-    subscribeMany<TEventType extends TEvents["type"]>(events: TEventType[], listener: Listener<SelectEvent<TEvents, TEventType>>): LazyPromise<Unsubscribe>;
-    abstract dispatch(events: OneOrMore<TEvents>): LazyPromise<void>;
+    abstract addListener<TEventName extends keyof TEvents>(eventName: TEventName, listener: Listener<SelectEvent<TEvents, TEventName>>): LazyPromise<void>;
+    addListenerMany<TEventName extends keyof TEvents>(eventNames: TEventName[], listener: Listener<SelectEvent<TEvents, TEventName>>): LazyPromise<void>;
+    abstract removeListener<TEventName extends keyof TEvents>(eventName: TEventName, listener: Listener<SelectEvent<TEvents, TEventName>>): LazyPromise<void>;
+    removeListenerMany<TEventName extends keyof TEvents>(eventNames: TEventName[], listener: Listener<SelectEvent<TEvents, TEventName>>): LazyPromise<void>;
+    subscribe<TEventName extends keyof TEvents>(eventName: TEventName, listener: Listener<SelectEvent<TEvents, TEventName>>): LazyPromise<Unsubscribe>;
+    subscribeMany<TEventName extends keyof TEvents>(eventNames: TEventName[], listener: Listener<SelectEvent<TEvents, TEventName>>): LazyPromise<Unsubscribe>;
+    abstract dispatch(events: OneOrMore<AllEvents<TEvents>>): LazyPromise<void>;
 }

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

@@ -1,7 +1,7 @@
 /**
  * @module EventBus
  */
-import type { INamespacedEventBus, IEventBusAdapter, IBaseEvent, IEventBusFactory } from "../../../event-bus/contracts/_module";
+import type { INamespacedEventBus, IEventBusAdapter, IEventBusFactory, BaseEvents } from "../../../event-bus/contracts/_module";
 /**
  * @group Derivables
  */
@@ -34,11 +34,11 @@ export type EventBusFactorySettings<TAdapters extends string = string> = {
  * });
  * ```
  */
-export declare class EventBusFactory<TAdapters extends string = string, TEvent extends IBaseEvent = IBaseEvent> implements IEventBusFactory<TAdapters> {
+export declare class EventBusFactory<TAdapters extends string = string, TEvents extends BaseEvents = BaseEvents> implements IEventBusFactory<TAdapters, TEvents> {
     private readonly drivers;
     private readonly defaultDriver?;
     private readonly rootNamespace?;
     constructor(settings: EventBusFactorySettings<TAdapters>);
-    use(driverName?: TAdapters | undefined): INamespacedEventBus<TEvent>;
-    withType<TOutput extends IBaseEvent = IBaseEvent>(): IEventBusFactory<TAdapters, TOutput>;
+    use(driverName?: TAdapters | undefined): INamespacedEventBus<TEvents>;
+    withType<TOutput extends BaseEvents = TEvents>(): IEventBusFactory<TAdapters, TOutput>;
 }

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

@@ -1,10 +1,10 @@
 /**
  * @module EventBus
  */
-import { LazyPromise } from "../../../utilities/_module";
-import type { SelectEvent } from "../../../event-bus/contracts/_module";
-import { type IEventBus, type INamespacedEventBus, type IEventBusAdapter, type Listener, type IBaseEvent } from "../../../event-bus/contracts/_module";
-import type { OneOrMore } from "../../../_shared/types";
+import { LazyPromise } from "../../../async/_module";
+import type { SelectEvent, AllEvents, BaseEvents } from "../../../event-bus/contracts/_module";
+import { type IEventBus, type INamespacedEventBus, type IEventBusAdapter, type Listener } from "../../../event-bus/contracts/_module";
+import type { OneOrMore } from "../../../utilities/_module";
 import { BaseEventBus } from "../../../event-bus/implementations/derivables/base-event-bus";
 /**
  * @group Derivables
@@ -49,13 +49,13 @@ export type EventBusSettings = {
  * <i>EventBus</i> class can be derived from any <i>{@link IEventBusAdapter}</i>.
  * @group Derivables
  */
-export declare class EventBus<TEvents extends IBaseEvent = IBaseEvent> extends BaseEventBus<TEvents> implements INamespacedEventBus<TEvents> {
+export declare class EventBus<TEvents extends BaseEvents = BaseEvents> extends BaseEventBus<TEvents> implements INamespacedEventBus<TEvents> {
     private readonly eventBusAdapter;
     private readonly namespace;
     constructor(eventBusAdapter: IEventBusAdapter, settings?: EventBusSettings);
     withNamespace(namespace: OneOrMore<string>): IEventBus<TEvents>;
     getNamespace(): string;
-    addListener<TEventType extends TEvents["type"]>(event: TEventType, listener: Listener<SelectEvent<TEvents, TEventType>>): LazyPromise<void>;
-    removeListener<TEventType extends TEvents["type"]>(event: TEventType, listener: Listener<SelectEvent<TEvents, TEventType>>): LazyPromise<void>;
-    dispatch(events: OneOrMore<TEvents>): LazyPromise<void>;
+    addListener<TEventName extends keyof TEvents>(eventName: TEventName, listener: Listener<SelectEvent<TEvents, TEventName>>): LazyPromise<void>;
+    removeListener<TEventName extends keyof TEvents>(eventName: TEventName, listener: Listener<SelectEvent<TEvents, TEventName>>): LazyPromise<void>;
+    dispatch(events: OneOrMore<AllEvents<TEvents>>): LazyPromise<void>;
 }

package/dist/types/serializer/implementations/_shared/test-utilities/serializer.test-suite.d.ts

@@ -3,7 +3,7 @@
  */
 import { type TestAPI, type ExpectStatic } from "vitest";
 import { type ISerializer } from "../../../../serializer/contracts/_module";
-import { type Promisable } from "../../../../_shared/types";
+import { type Promisable } from "../../../../utilities/_module";
 /**
  * @group Utilities
  */

package/dist/types/utilities/_module.d.ts

@@ -1,5 +1,6 @@
-export * from "../utilities/async/_module";
-export * from "../utilities/backof-policies/_module";
+export * from "../utilities/contracts/_module";
+export * from "../utilities/kysely/_module";
 export * from "../utilities/time-span/_module";
-export * from "../utilities/validation/_module";
-export * from "../utilities/global-errors";
+export * from "../utilities/errors";
+export * from "../utilities/types";
+export * from "../utilities/functions";

package/dist/types/utilities/contracts/_module.d.ts

@@ -0,0 +1,2 @@
+export * from "../../utilities/contracts/deinitizable.contract";
+export * from "../../utilities/contracts/initizable.contract";

package/dist/types/utilities/contracts/deinitizable.contract.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @module Utilities
+ */
+/**
+ * @group Contracts
+ */
+export type IDeinitizable = {
+    deInit(): PromiseLike<void>;
+};

package/dist/types/utilities/contracts/initizable.contract.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @module Utilities
+ */
+/**
+ * @group Contracts
+ */
+export type IInitizable = {
+    init(): PromiseLike<void>;
+};

package/dist/types/utilities/{global-errors.d.ts → errors.d.ts}

@@ -1,12 +1,21 @@
 /**
- * @module Global Errors
+ * @module Utilities
+ */
+/**
+ * @group Errors
  */
 export declare class FactoryError extends Error {
     constructor(message: string, cause?: unknown);
 }
+/**
+ * @group Errors
+ */
 export declare class DefaultDriverNotDefinedError extends FactoryError {
     constructor(factoryName: string);
 }
+/**
+ * @group Errors
+ */
 export declare class UnregisteredDriverError extends FactoryError {
     constructor(driverName: string);
 }

package/dist/types/{_shared/utilities.d.ts → utilities/functions.d.ts}

@@ -1,8 +1,8 @@
 /**
- * @module Shared
+ * @module Utilities
  */
-import type { Lazyable, OneOrMore } from "../_shared/types";
-import { type AsyncLazyable } from "../_shared/types";
+import type { Lazyable, OneOrMore } from "../utilities/types";
+import { type AsyncLazyable } from "../utilities/types";
 /**
  * @internal
  */

package/dist/types/utilities/kysely/_module.d.ts

@@ -0,0 +1 @@
+export * from "../../utilities/kysely/kysely-table-name-transformer-plugin";

package/dist/types/{_shared → utilities}/kysely/kysely-table-name-transformer-plugin.d.ts

@@ -1,5 +1,5 @@
 /**
- * @module Shared
+ * @module Utilities
  */
 import type { KyselyPlugin, PluginTransformQueryArgs, PluginTransformResultArgs, QueryResult, RootOperationNode, UnknownRow } from "kysely";
 /**

package/dist/types/{_shared → utilities}/types.d.ts

@@ -1,18 +1,13 @@
 /**
- * @module Shared
+ * @module Utilities
  */
+export type Values<TValue> = TValue[keyof TValue];
 export type OneOrMore<TItem> = TItem | TItem[];
 export type Lazyable<TValue> = TValue | (() => TValue);
 export type Promisable<TValue> = TValue | PromiseLike<TValue>;
 export type AsyncLazyable<TValue> = TValue | (() => Promisable<TValue>);
+export type Result<TValue, TError> = [TValue, null] | [null, TError];
 export type AsyncIterableValue<TInput> = Iterable<TInput> | AsyncIterable<TInput>;
 export type AnyFunction = (...parameters: unknown[]) => unknown;
-export type IInitizable = {
-    init(): PromiseLike<void>;
-};
-export type IDeinitizable = {
-    deInit(): PromiseLike<void>;
-};
 export type Func<TArgs extends unknown[], TReturn> = (...args_: TArgs) => TReturn;
 export type GetOrAddValue<TValue> = Awaited<TValue extends AnyFunction ? ReturnType<TValue> : TValue>;
-export type Result<TValue> = [true, TValue] | [false];

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@daiso-tech/core",
     "private": false,
-    "version": "0.14.0",
+    "version": "0.15.0",
     "author": "Yousif Abdulkarim",
     "license": "Apache-2.0",
     "main": "./dist/cjs/_module.js",

package/dist/cjs/_shared/kysely/_module.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../../src/_shared/kysely/_module.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wFAAsE"}

package/dist/cjs/_shared/kysely/kysely-table-name-transformer-plugin.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"kysely-table-name-transformer-plugin.js","sourceRoot":"","sources":["../../../../src/_shared/kysely/kysely-table-name-transformer-plugin.ts"],"names":[],"mappings":";;;AAaA,mCAAkD;AAKlD,MAAM,oBAAqB,SAAQ,iCAAwB;IAC1B;IAA7B,YAA6B,YAAoC;QAC7D,KAAK,EAAE,CAAC;QADiB,iBAAY,GAAZ,YAAY,CAAwB;IAEjE,CAAC;IAEkB,cAAc,CAAC,IAAe;QAC7C,MAAM,eAAe,GAAG,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QACnD,OAAO;YACH,GAAG,eAAe;YAClB,KAAK,EAAE;gBACH,GAAG,eAAe,CAAC,KAAK;gBACxB,UAAU,EAAE;oBACR,GAAG,eAAe,CAAC,KAAK,CAAC,UAAU;oBACnC,IAAI,EAAE,CAAC,GAAG,EAAE;wBACR,MAAM,YAAY,GACd,eAAe,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;wBAC1C,MAAM,cAAc,GAAG,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;wBACvD,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;4BAC/B,MAAM,IAAI,KAAK,CACX,yBAAyB,YAAY,GAAG,CAC3C,CAAC;wBACN,CAAC;wBACD,OAAO,cAAc,CAAC;oBAC1B,CAAC,CAAC,EAAE;iBACP;aACJ;SACJ,CAAC;IACN,CAAC;CACJ;AAKD,MAAa,gCAAgC;IACxB,WAAW,CAAuB;IAEnD,YAAY,YAAoC;QAC5C,IAAI,CAAC,WAAW,GAAG,IAAI,oBAAoB,CAAC,YAAY,CAAC,CAAC;IAC9D,CAAC;IAED,cAAc,CAAC,IAA8B;QACzC,OAAO,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrD,CAAC;IAED,eAAe,CACX,IAA+B;QAE/B,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;CACJ;AAhBD,4EAgBC"}