@daiso-tech/core 0.20.0 → 0.21.1

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

@@ -1,7 +1,7 @@
 /**
  * @module Cache
  */
-import type { ICacheFactory, IGroupableCache } from "../../../../cache/contracts/_module";
+import { type ICacheFactory, type 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";
 /**
@@ -33,10 +33,9 @@ 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 cacheRecord;
     private readonly defaultAdapter?;
-    private readonly eventBus?;
+    private readonly eventBus;
     private readonly defaultTtl;
     private readonly retryAttempts?;
     private readonly backoffPolicy?;
@@ -73,6 +72,6 @@ export declare class CacheFactory<TAdapters extends string = string> implements
      * ```
      */
     constructor(settings: CacheFactorySettings<TAdapters>);
-    private initCaches;
+    private init;
     use<TType = unknown>(adapterName?: TAdapters | undefined): IGroupableCache<TType>;
 }

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

@@ -1,7 +1,6 @@
 /**
  * @module EventBus
  */
-import type { ISerializable } from "../../serde/contracts/_module";
 import type { Promisable } from "../../utilities/_module";
 /**
  * @group Contracts
@@ -10,7 +9,7 @@ export type Listener<TEvent> = (event: TEvent) => Promisable<void>;
 /**
  * @group Contracts
  */
-export declare abstract class BaseEvent<TData extends Record<string, unknown> = Record<string, unknown>> implements ISerializable<TData> {
-    static deserialize(_serializedEvent: any): BaseEvent;
-    abstract serialize(): TData;
+export declare abstract class BaseEvent<TFields extends Record<string, unknown> = Record<string, unknown>> {
+    readonly fields: TFields;
+    constructor(fields: TFields);
 }

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

@@ -17,29 +17,10 @@ export type IEventBusFactory<TAdapters extends string = string> = {
      * ```ts
      * import { type IEventBusFactory } from "@daiso-tech/core";
      *
-     * type SerializedAddEvent = {
+     * class AddEvent extends BaseEvent<{
      *   a: number;
      *   b: number;
-     * };
-     *
-     * class AddEvent extends BaseEvent<SerializedAddEvent> {
-     *   // This needed for adapters that need to deserialize like the redis dapter.
-     *   static override deserialize({ a, b }: SerializedAddEvent): AddEvent {
-     *     return new AddEvent(a, b);
-     *   }
-     *
-     *   constructor(public readonly a: number, public readonly b: number) {
-     *     super();
-     *   }
-     *
-     *   // This needed for adapters that need to serialize like the redis adapter.
-     *   override serialize(): SerializedAddEvent {
-     *     return {
-     *       a: this.a,
-     *       b: this.b
-     *     };
-     *   }
-     * }
+     * }> {}
      *
      * // Asume the inputed eventFactory has registered both a memory and Redis IEventBusAdapter.
      * // The memory IEventBusAdapter adapter is the default.
@@ -47,11 +28,11 @@ export type IEventBusFactory<TAdapters extends string = string> = {
      *   // Will dispatch envent using the default adapter
      *   await eventBusFactory
      *     .use()
-     *     .dispatch(new AddEvent(1, 2));
+     *     .dispatch(new AddEvent({ a: 1, b: 2 }));
      *   // Will dispatch envent using the redis addapter
      *   await eventBusFactory
      *     .use("redis")
-     *     .dispatch(new AddEvent(1, 2));
+     *     .dispatch(new AddEvent({ a: 1, b: 2 }));
      * }
      * ```
      */

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

@@ -1,8 +1,8 @@
 /**
  * @module EventBus
  */
-import type { ISerializable } from "../../serde/contracts/_module";
-import type { ISerializedError } from "../../utilities/_module";
+import type { IFlexibleSerde, ISerializable } from "../../serde/contracts/_module";
+import type { ISerializedError, OneOrMore } from "../../utilities/_module";
 /**
  * @group Errors
  */
@@ -38,3 +38,8 @@ export declare class UnableToAddListenerEventBusError extends UnexpectedEventBus
 export declare class UnableToDispatchEventBusError extends UnexpectedEventBusError {
     constructor(message: string, cause?: unknown);
 }
+/**
+ * The <i>registerEventBusErrors</i> function registers all <i>{@link IGroupableEventBus}</i> related errors with <i>IFlexibleSerde</i>, ensuring they will properly be serialized and deserialized.
+ * @group Errors
+ */
+export declare function registerEventBusErrors(serde: OneOrMore<IFlexibleSerde>): void;

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

@@ -3,23 +3,11 @@
  */
 import type { BackoffPolicy, RetryPolicy } from "../../../../async/_module";
 import { type IGroupableEventBus, type IEventBusAdapter } from "../../../../event-bus/contracts/_module";
-import type { IFlexibleSerde } from "../../../../serde/contracts/_module";
-import type { IBuildable, OneOrMore, TimeSpan } from "../../../../utilities/_module";
+import type { IBuildable, TimeSpan } from "../../../../utilities/_module";
 /**
  * @group Derivables
  */
 export type EventBusSettings = {
-    /**
-     * You can pass one or more <i>{@link IFlexibleSerde}</i> that will be used to register all <i>{@link IGroupableEventBus}</i> related errors.
-     * @default {true}
-     */
-    serde: OneOrMore<IFlexibleSerde>;
-    /**
-     * If set to true, all <i>{@link IGroupableEventBus}</i> related errors will be registered with the specified <i>IFlexibleSerde</i> during constructor initialization.
-     * This ensures that all <i>{@link IGroupableEventBus}</i> related errors will be serialized correctly.
-     * @default {true}
-     */
-    shouldRegisterErrors?: boolean;
     adapter: IEventBusAdapter;
     /**
      * The default retry attempt to use in the returned <i>LazyPromise</i>.
@@ -49,12 +37,6 @@ export type EventBusSettings = {
 export declare class EventBusSettingsBuilder<TSettings extends Partial<EventBusSettings>> implements IBuildable<EventBusSettings> {
     private readonly settings;
     constructor(settings?: TSettings);
-    setShouldRegisterErrors(shouldRegisterErrors: boolean): EventBusSettingsBuilder<TSettings & {
-        shouldRegisterErrors: boolean;
-    }>;
-    setSerde(serde: OneOrMore<IFlexibleSerde>): EventBusSettingsBuilder<TSettings & {
-        serde: OneOrMore<IFlexibleSerde>;
-    }>;
     setAdapter(adapter: IEventBusAdapter): EventBusSettingsBuilder<TSettings & {
         adapter: IEventBusAdapter;
     }>;

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

@@ -3,7 +3,7 @@
  */
 import { LazyPromise } from "../../../../async/_module";
 import type { EventClass, EventInstance, Unsubscribe } from "../../../../event-bus/contracts/_module";
-import { type IEventBus, type IGroupableEventBus, type Listener, type BaseEvent, UnableToRemoveListenerEventBusError, UnableToAddListenerEventBusError, UnexpectedEventBusError, EventBusError } from "../../../../event-bus/contracts/_module";
+import { type IEventBus, type IGroupableEventBus, type Listener, type BaseEvent } from "../../../../event-bus/contracts/_module";
 import type { OneOrMore } from "../../../../utilities/_module";
 import type { EventBusSettings } from "../../../../event-bus/implementations/derivables/event-bus/event-bus-settings";
 import { EventBusSettingsBuilder } from "../../../../event-bus/implementations/derivables/event-bus/event-bus-settings";
@@ -12,38 +12,40 @@ import { EventBusSettingsBuilder } from "../../../../event-bus/implementations/d
  * @group Derivables
  */
 export declare class EventBus<TEvents extends BaseEvent = BaseEvent> implements IGroupableEventBus<TEvents> {
-    static readonly errors: {
-        readonly Error: typeof EventBusError;
-        readonly Unexpected: typeof UnexpectedEventBusError;
-        readonly RemoveListener: typeof UnableToRemoveListenerEventBusError;
-        readonly AddListener: typeof UnableToAddListenerEventBusError;
-    };
     /**
      * @example
      * ```ts
-     * import { EventBus, MemoryEventBusAdapter } from "@daiso-tech/core";
+     * import { EventBus, MemoryEventBusAdapter, registerEventErrors, SuperJsonSerde } from "@daiso-tech/core";
      *
-     * const cache = new EventBus(
+     * const eventBus = new EventBus(
      *   EventBus
      *     .settings()
      *     .setAdapter(new MemoryEventBusAdapter({ rootGroup: "@global" }))
      *     .build()
      * );
+     * const serde = new SuperJsonSerde();
+     * registerEventErrors(serde)
      * ```
      */
     static settings<TSettings extends Partial<EventBusSettings>>(): EventBusSettingsBuilder<TSettings>;
-    private readonly serde;
     private readonly adapter;
     private readonly retryAttempts;
     private readonly backoffPolicy;
     private readonly retryPolicy;
     private readonly timeout;
-    private readonly shouldRegisterErrors;
-    constructor(settings: EventBusSettings);
     /**
-     * Registers all event bus related error within the given <i>IFlexibleSerde</i> contract.
+     * @example
+     * ```ts
+     * import { EventBus, MemoryEventBusAdapter, registerEventErrors, SuperJsonSerde } from "@daiso-tech/core";
+     *
+     * const eventBus = new EventBus({
+     *   adapter: new MemoryEventBusAdapter({ rootGroup: "@global" })
+     * });
+     * const serde = new SuperJsonSerde();
+     * registerEventErrors(serde)
+     * ```
      */
-    private registerErrors;
+    constructor(settings: EventBusSettings);
     private createLayPromise;
     withGroup(group: OneOrMore<string>): IEventBus<TEvents>;
     getGroup(): string;

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

@@ -1,7 +1,7 @@
 /**
  * @module EventBus
  */
-import type { IGroupableEventBus, IEventBusFactory, BaseEvent } from "../../../../event-bus/contracts/_module";
+import { type IGroupableEventBus, type IEventBusFactory, type BaseEvent } from "../../../../event-bus/contracts/_module";
 import { type EventBusFactorySettings, EventBusFactorySettingsBuilder } from "../../../../event-bus/implementations/derivables/event-bus-factory/event-bus-factory-settings";
 /**
  * @group Derivables
@@ -21,6 +21,7 @@ import { type EventBusFactorySettings, EventBusFactorySettingsBuilder } from "..
  *     }),
  *   },
  *   defaultAdapter: "memory",
+ *   serde: new SuperJsonSerde()
  * });
  * ```
  */
@@ -31,16 +32,18 @@ export declare class EventBusFactory<TAdapters extends string = string> implemen
      * import { EventBusFactory, SuperJsonSerde. MemoryEventBusAdapter, RedisPubSubEventBusAdapter, EventBus, MemoryEventBusAdapter } from "@daiso-tech/core";
      * import Redis from "ioredis";
      *
+     * const serde = new SuperJsonSerde();
      * const cacheFactory = new EventBusFactory(
      *   EventBusFactory
      *     .settings()
+     *     .setSerde(serde)
      *     .setAdapter("memory", new MemoryEventBusAdapter({
      *       rootGroup: "@global"
      *     }))
      *     .setAdapter("redis", new RedisPubSubEventBusAdapter({
      *       dispatcherClient: new Redis("YOUR_REDIS_CONNECTION"),
      *       listenerClient: new Redis("YOUR_REDIS_CONNECTION")
-     *       serde: new SuperJsonSerde(),
+     *       serde,
      *       rootGroup: "@global"
      *     }))
      *     .setDefaultAdapter("memory")
@@ -49,16 +52,38 @@ export declare class EventBusFactory<TAdapters extends string = string> implemen
      * ```
      */
     static settings<TAdapters extends string, TSettings extends EventBusFactorySettings<TAdapters>>(): EventBusFactorySettingsBuilder<TSettings>;
-    private readonly eventBuses;
+    private readonly eventBusRecord;
     private readonly serde;
-    private readonly adapters;
     private readonly defaultAdapter?;
     private readonly retryAttempts?;
     private readonly backoffPolicy?;
     private readonly retryPolicy?;
     private readonly timeout?;
     private readonly shouldRegisterErrors?;
+    /**
+     * @example
+     * ```ts
+     * import { EventBusFactory, SuperJsonSerde. MemoryEventBusAdapter, RedisPubSubEventBusAdapter, EventBus, MemoryEventBusAdapter } from "@daiso-tech/core";
+     * import Redis from "ioredis";
+     * const serde = new SuperJsonSerde();
+     * const cacheFactory = new EventBusFactory({
+     *   serde,
+     *   adapters: {
+     *     memory:new MemoryEventBusAdapter({
+     *       rootGroup: "@global"
+     *     }),
+     *     redis: new RedisPubSubEventBusAdapter({
+     *       dispatcherClient: new Redis("YOUR_REDIS_CONNECTION"),
+     *       listenerClient: new Redis("YOUR_REDIS_CONNECTION")
+     *       serde,
+     *       rootGroup: "@global"
+     *     }),
+     *     defaultAdapter: "memory"
+     *   }
+     * })
+     * ```
+     */
     constructor(settings: EventBusFactorySettings<TAdapters>);
-    private initCaches;
+    private init;
     use<TEvents extends BaseEvent = BaseEvent>(adapterName?: TAdapters | undefined): IGroupableEventBus<TEvents>;
 }

package/dist/types/serde/contracts/flexible-serde.contract.d.ts

@@ -3,6 +3,7 @@
  */
 import type { ISerializable } from "../../serde/contracts/serializable.contract";
 import type { ISerde } from "../../serde/contracts/serde.contract";
+import type { BaseEvent } from "../../_module";
 /**
  * The <i>SerializableClass</i> contract defines standard way to make a class instance serializable and deserializable.
  * @group Contracts
@@ -12,10 +13,9 @@ export type SerializableClass<TSerializedValue> = {
     deserialize(serializedValue: TSerializedValue): ISerializable<TSerializedValue>;
 };
 /**
- * The <i>SerializableClass</i> contract defines standard way to make a error class instance serializable and deserializable.
  * @group Contracts
  */
-export type ErrorClass = new (...args: any[]) => Error;
+export type SerializableEventClass<TFields extends Record<string, unknown>> = new (fields: any) => BaseEvent<TFields>;
 /**
  * @group Contracts
  */
@@ -30,6 +30,7 @@ export type ISerdeTransformer<TDeserializedValue, TSerializedValue> = {
  * @group Contracts
  */
 export type IFlexibleSerde<TSerializedValue = unknown> = ISerde<TSerializedValue> & {
+    registerEvent<TFields extends Record<string, unknown>>(eventClass: SerializableEventClass<TFields>): IFlexibleSerde<TSerializedValue>;
     /**
      * The <i>registerClass</i> method is used for registering custom class for serialization and deserialization.
      * The <i>class_</i> parameter must be of type <i>{@link SerializableClass}</i>.

package/dist/types/serde/implementations/no-op-serde/no-op-serde.d.ts

@@ -1,12 +1,13 @@
 /**
  * @module EventBus
  */
-import type { IFlexibleSerde, ISerdeTransformer, SerializableClass } from "../../../serde/contracts/_module";
+import type { SerializableEventClass, IFlexibleSerde, ISerdeTransformer, SerializableClass } from "../../../serde/contracts/_module";
 /**
  * This <i>NoOpSerde</i> will do nothing and is used for easily mocking {@link IFlexibleSerde} or {@link ISerde} for testing.
  * @group Adapters
  */
 export declare class NoOpSerde<TSerializedValue> implements IFlexibleSerde<TSerializedValue> {
+    registerEvent<TFields extends Record<string, unknown>>(_eventClass: SerializableEventClass<TFields>): IFlexibleSerde<TSerializedValue>;
     serialize<TValue>(value: TValue): TSerializedValue;
     deserialize<TValue>(serializedValue: TSerializedValue): TValue;
     registerClass<TSerializedClassInstance>(_class: SerializableClass<TSerializedClassInstance>): IFlexibleSerde<TSerializedValue>;

package/dist/types/serde/implementations/super-json-serde/super-json-serde.d.ts

@@ -1,7 +1,7 @@
 /**
  * @module Serde
  */
-import type { ISerdeTransformer, SerializableClass } from "../../../serde/contracts/_module";
+import type { SerializableEventClass, ISerdeTransformer, SerializableClass } from "../../../serde/contracts/_module";
 import { type IFlexibleSerde } from "../../../serde/contracts/_module";
 /**
  * The <i>SuperJsonSerde</i> class has direct support for the following values
@@ -41,6 +41,7 @@ export declare class SuperJsonSerde implements IFlexibleSerde<string> {
     private registerFloat64Array;
     private registerAll;
     registerClass<TSerializedClassInstance>(class_: SerializableClass<TSerializedClassInstance>): IFlexibleSerde<string>;
+    registerEvent<TFields extends Record<string, unknown>>(eventClass: SerializableEventClass<TFields>): IFlexibleSerde<string>;
     serialize<TValue>(value: TValue): string;
     deserialize<TValue>(value: string): TValue;
 }

package/package.json

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