@daiso-tech/core 0.34.0 → 0.35.0

package/dist/async/utilities/timeout-and-fail/timeout-and-fail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout-and-fail.js","sourceRoot":"","sources":["../../../../src/async/utilities/timeout-and-fail/timeout-and-fail.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,OAAO,EAAE,YAAY,EAAE,MAAM,6CAA6C,CAAC;AAE3E;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAChC,OAA4B,EAC5B,IAAc,EACd,KAAmC,EACnC,MAAmB;IAEnB,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;QAC9B,KAAK,CAAC,IAAI,iBAAiB,CAAC,0BAA0B,CAAC,CAAC,CAAC;IAC7D,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;IAC1B,IAAI,CAAC;QACD,OAAO,MAAM,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC/C,CAAC;YAAS,CAAC;QACP,YAAY,CAAC,SAAS,CAAC,CAAC;IAC5B,CAAC;AACL,CAAC"}

package/dist/cache/contracts/cache.contract.d.ts

@@ -4,7 +4,7 @@
 import type { LazyPromise } from "../../async/_module-exports.js";
 import type { TimeSpan } from "../../utilities/_module-exports.js";
 import type { AsyncLazyable, NoneFunc, OneOrMore } from "../../utilities/_module-exports.js";
-import type { CacheEvents } from "../../cache/contracts/cache.events.js";
+import type { CacheEventMap } from "../../cache/contracts/cache.events.js";
 import type { IEventListenable } from "../../event-bus/contracts/_module-exports.js";
 /**
  * The `ICacheListenable` contract defines a way for listening {@link ICache | `ICache`} operation events.
@@ -12,7 +12,7 @@ import type { IEventListenable } from "../../event-bus/contracts/_module-exports
  * IMPORT_PATH: `"@daiso-tech/core/cache/contracts"`
  * @group Contracts
  */
-export type ICacheListenable<TType = unknown> = IEventListenable<CacheEvents<TType>>;
+export type ICacheListenable<TType = unknown> = IEventListenable<CacheEventMap<TType>>;
 /**
  * The `ICacheBase` contract defines a way for as key-value pairs independent of data storage.
  *

package/dist/cache/contracts/cache.events.d.ts

@@ -1,131 +1,127 @@
 /**
  * @module Cache
  */
-import { BaseEvent } from "../../event-bus/contracts/_module-exports.js";
-import type { IFlexibleSerde } from "../../serde/contracts/_module-exports.js";
-import { type OneOrMore, type TimeSpan } from "../../utilities/_module-exports.js";
+import type { TimeSpan } from "../../utilities/_module-exports.js";
 /**
  * The event is dispatched when key is found.
  *
  * IMPORT_PATH: `"@daiso-tech/core/cache/contracts"`
  * @group Events
  */
-export declare class KeyFoundCacheEvent<TType = unknown> extends BaseEvent<{
+export type FoundCacheEventt<TType = unknown> = {
     key: string;
     value: TType;
-}> {
-}
+};
 /**
  * The event is dispatched when key is not found.
  *
  * IMPORT_PATH: `"@daiso-tech/core/cache/contracts"`
  * @group Events
  */
-export declare class KeyNotFoundCacheEvent extends BaseEvent<{
+export type NotFoundCacheEvent = {
     key: string;
-}> {
-}
+};
 /**
  * The event is dispatched when key is added.
  *
  * IMPORT_PATH: `"@daiso-tech/core/cache/contracts"`
  * @group Events
  */
-export declare class KeyAddedCacheEvent<TType = unknown> extends BaseEvent<{
+export type AddedCacheEvent<TType = unknown> = {
+    type: "added";
     key: string;
     value: TType;
     ttl: TimeSpan | null;
-}> {
-}
+};
 /**
  * The event is dispatched when key is updated.
  *
  * IMPORT_PATH: `"@daiso-tech/core/cache/contracts"`
  * @group Events
  */
-export declare class KeyUpdatedCacheEvent<TType = unknown> extends BaseEvent<{
+export type UpdatedCacheEvent<TType = unknown> = {
+    type: "updated";
     key: string;
     value: TType;
-}> {
-}
+};
 /**
  * The event is dispatched when key is removed.
  *
  * IMPORT_PATH: `"@daiso-tech/core/cache/contracts"`
  * @group Events
  */
-export declare class KeyRemovedCacheEvent extends BaseEvent<{
+export type RemovedCacheEvent = {
+    type: "removed";
     key: string;
-}> {
-}
+};
 /**
  * The event is dispatched when key is incremented.
  *
  * IMPORT_PATH: `"@daiso-tech/core/cache/contracts"`
  * @group Events
  */
-export declare class KeyIncrementedCacheEvent extends BaseEvent<{
+export type IncrementedCacheEvent = {
+    type: "incremented";
     key: string;
     value: number;
-}> {
-}
+};
 /**
  * The event is dispatched when key is decremented.
  *
  * IMPORT_PATH: `"@daiso-tech/core/cache/contracts"`
  * @group Events
  */
-export declare class KeyDecrementedCacheEvent extends BaseEvent<{
+export type DecrementedCacheEvent = {
+    type: "decremented";
     key: string;
     value: number;
-}> {
-}
+};
 /**
- * The event is dispatched when all keys all cleared.
+ * The event is dispatched when key is updated or added.
  *
  * IMPORT_PATH: `"@daiso-tech/core/cache/contracts"`
  * @group Events
  */
-export declare class KeysClearedCacheEvent extends BaseEvent<{}> {
-}
+export type WrittenCacheEvent<TType = unknown> = AddedCacheEvent<TType> | UpdatedCacheEvent<TType> | RemovedCacheEvent | IncrementedCacheEvent | DecrementedCacheEvent;
 /**
+ * The event is dispatched when all keys all cleared of the cache.
  *
  * IMPORT_PATH: `"@daiso-tech/core/cache/contracts"`
  * @group Events
  */
-export declare class UnexpectedErrorCacheEvent extends BaseEvent<{
-    keys?: string[];
-    value?: unknown;
-    method: string;
-    error: unknown;
-}> {
-}
+export type ClearedCacheEvent = {};
 /**
  *
  * IMPORT_PATH: `"@daiso-tech/core/cache/contracts"`
  * @group Events
  */
-export declare const CACHE_EVENTS: {
-    KeyFound: typeof KeyFoundCacheEvent;
-    KeyNotFound: typeof KeyNotFoundCacheEvent;
-    KeyAdded: typeof KeyAddedCacheEvent;
-    KeyUpdated: typeof KeyUpdatedCacheEvent;
-    KeyRemoved: typeof KeyRemovedCacheEvent;
-    KeyIncremented: typeof KeyIncrementedCacheEvent;
-    KeyDecremented: typeof KeyDecrementedCacheEvent;
-    KeysCleared: typeof KeysClearedCacheEvent;
-    UnexpectedError: typeof UnexpectedErrorCacheEvent;
+export type UnexpectedErrorCacheEvent = {
+    keys?: string[];
+    value?: unknown;
+    method: string;
+    error: unknown;
 };
 /**
  *
  * IMPORT_PATH: `"@daiso-tech/core/cache/contracts"`
  * @group Events
  */
-export type CacheEvents<TType = unknown> = KeyFoundCacheEvent<TType> | KeyNotFoundCacheEvent | KeyAddedCacheEvent<TType> | KeyUpdatedCacheEvent<TType> | KeyRemovedCacheEvent | KeyIncrementedCacheEvent | KeyDecrementedCacheEvent | KeysClearedCacheEvent | UnexpectedErrorCacheEvent;
+export declare const CACHE_EVENTS: {
+    readonly FOUND: "FOUND";
+    readonly NOT_FOUND: "NOT_FOUND";
+    readonly WRITTEN: "WRITTEN";
+    readonly CLEARED: "CLEARED";
+    readonly UNEXPECTED_ERROR: "UNEXPECTED_ERROR";
+};
 /**
- * The `registerCacheEventsToSerde` function registers all {@link ICache | `ICache`} related events with `IFlexibleSerde`, ensuring they will properly be serialized and deserialized.
  *
  * IMPORT_PATH: `"@daiso-tech/core/cache/contracts"`
  * @group Events
  */
-export declare function registerCacheEventsToSerde(serde: OneOrMore<IFlexibleSerde>): void;
+export type CacheEventMap<TType = unknown> = {
+    [CACHE_EVENTS.FOUND]: FoundCacheEventt<TType>;
+    [CACHE_EVENTS.NOT_FOUND]: NotFoundCacheEvent;
+    [CACHE_EVENTS.WRITTEN]: WrittenCacheEvent<TType>;
+    [CACHE_EVENTS.CLEARED]: ClearedCacheEvent;
+    [CACHE_EVENTS.UNEXPECTED_ERROR]: UnexpectedErrorCacheEvent;
+};

package/dist/cache/contracts/cache.events.js

@@ -1,114 +1,16 @@
 /**
  * @module Cache
  */
-import { BaseEvent } from "../../event-bus/contracts/_module-exports.js";
-import { CORE, resolveOneOrMore, } from "../../utilities/_module-exports.js";
-/**
- * The event is dispatched when key is found.
- *
- * IMPORT_PATH: `"@daiso-tech/core/cache/contracts"`
- * @group Events
- */
-export class KeyFoundCacheEvent extends BaseEvent {
-}
-/**
- * The event is dispatched when key is not found.
- *
- * IMPORT_PATH: `"@daiso-tech/core/cache/contracts"`
- * @group Events
- */
-export class KeyNotFoundCacheEvent extends BaseEvent {
-}
-/**
- * The event is dispatched when key is added.
- *
- * IMPORT_PATH: `"@daiso-tech/core/cache/contracts"`
- * @group Events
- */
-export class KeyAddedCacheEvent extends BaseEvent {
-}
-/**
- * The event is dispatched when key is updated.
- *
- * IMPORT_PATH: `"@daiso-tech/core/cache/contracts"`
- * @group Events
- */
-export class KeyUpdatedCacheEvent extends BaseEvent {
-}
-/**
- * The event is dispatched when key is removed.
- *
- * IMPORT_PATH: `"@daiso-tech/core/cache/contracts"`
- * @group Events
- */
-export class KeyRemovedCacheEvent extends BaseEvent {
-}
-/**
- * The event is dispatched when key is incremented.
- *
- * IMPORT_PATH: `"@daiso-tech/core/cache/contracts"`
- * @group Events
- */
-export class KeyIncrementedCacheEvent extends BaseEvent {
-}
-/**
- * The event is dispatched when key is decremented.
- *
- * IMPORT_PATH: `"@daiso-tech/core/cache/contracts"`
- * @group Events
- */
-export class KeyDecrementedCacheEvent extends BaseEvent {
-}
-/**
- * The event is dispatched when all keys all cleared.
- *
- * IMPORT_PATH: `"@daiso-tech/core/cache/contracts"`
- * @group Events
- */
-// eslint-disable-next-line @typescript-eslint/no-empty-object-type
-export class KeysClearedCacheEvent extends BaseEvent {
-}
-/**
- *
- * IMPORT_PATH: `"@daiso-tech/core/cache/contracts"`
- * @group Events
- */
-export class UnexpectedErrorCacheEvent extends BaseEvent {
-}
 /**
  *
  * IMPORT_PATH: `"@daiso-tech/core/cache/contracts"`
  * @group Events
  */
 export const CACHE_EVENTS = {
-    KeyFound: KeyFoundCacheEvent,
-    KeyNotFound: KeyNotFoundCacheEvent,
-    KeyAdded: KeyAddedCacheEvent,
-    KeyUpdated: KeyUpdatedCacheEvent,
-    KeyRemoved: KeyRemovedCacheEvent,
-    KeyIncremented: KeyIncrementedCacheEvent,
-    KeyDecremented: KeyDecrementedCacheEvent,
-    KeysCleared: KeysClearedCacheEvent,
-    UnexpectedError: UnexpectedErrorCacheEvent,
+    FOUND: "FOUND",
+    NOT_FOUND: "NOT_FOUND",
+    WRITTEN: "WRITTEN",
+    CLEARED: "CLEARED",
+    UNEXPECTED_ERROR: "UNEXPECTED_ERROR",
 };
-/**
- * The `registerCacheEventsToSerde` function registers all {@link ICache | `ICache`} related events with `IFlexibleSerde`, ensuring they will properly be serialized and deserialized.
- *
- * IMPORT_PATH: `"@daiso-tech/core/cache/contracts"`
- * @group Events
- */
-export function registerCacheEventsToSerde(serde) {
-    for (const serde_ of resolveOneOrMore(serde)) {
-        serde_
-            .registerEvent(KeyFoundCacheEvent, CORE)
-            .registerEvent(KeyNotFoundCacheEvent, CORE)
-            .registerEvent(KeyAddedCacheEvent, CORE)
-            .registerEvent(KeyUpdatedCacheEvent, CORE)
-            .registerEvent(KeyRemovedCacheEvent, CORE)
-            .registerEvent(KeyIncrementedCacheEvent, CORE)
-            .registerEvent(KeyDecrementedCacheEvent, CORE)
-            .registerEvent(KeysClearedCacheEvent, CORE)
-            .registerEvent(UnexpectedErrorCacheEvent, CORE);
-    }
-}
 //# sourceMappingURL=cache.events.js.map

package/dist/cache/contracts/cache.events.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache.events.js","sourceRoot":"","sources":["../../../src/cache/contracts/cache.events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,SAAS,EAAE,MAAM,0CAA0C,CAAC;AAErE,OAAO,EACH,IAAI,EACJ,gBAAgB,GAGnB,MAAM,gCAAgC,CAAC;AAExC;;;;;GAKG;AACH,MAAM,OAAO,kBAAoC,SAAQ,SAGvD;CAAG;AAEL;;;;;GAKG;AACH,MAAM,OAAO,qBAAsB,SAAQ,SAEzC;CAAG;AAEL;;;;;GAKG;AACH,MAAM,OAAO,kBAAoC,SAAQ,SAIvD;CAAG;AAEL;;;;;GAKG;AACH,MAAM,OAAO,oBAAsC,SAAQ,SAGzD;CAAG;AAEL;;;;;GAKG;AACH,MAAM,OAAO,oBAAqB,SAAQ,SAExC;CAAG;AAEL;;;;;GAKG;AACH,MAAM,OAAO,wBAAyB,SAAQ,SAG5C;CAAG;AAEL;;;;;GAKG;AACH,MAAM,OAAO,wBAAyB,SAAQ,SAG5C;CAAG;AAEL;;;;;GAKG;AACH,mEAAmE;AACnE,MAAM,OAAO,qBAAsB,SAAQ,SAAa;CAAG;AAE3D;;;;GAIG;AACH,MAAM,OAAO,yBAA0B,SAAQ,SAK7C;CAAG;AAEL;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IACxB,QAAQ,EAAE,kBAAkB;IAC5B,WAAW,EAAE,qBAAqB;IAClC,QAAQ,EAAE,kBAAkB;IAC5B,UAAU,EAAE,oBAAoB;IAChC,UAAU,EAAE,oBAAoB;IAChC,cAAc,EAAE,wBAAwB;IACxC,cAAc,EAAE,wBAAwB;IACxC,WAAW,EAAE,qBAAqB;IAClC,eAAe,EAAE,yBAAyB;CAC7C,CAAC;AAkBF;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CACtC,KAAgC;IAEhC,KAAK,MAAM,MAAM,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3C,MAAM;aACD,aAAa,CAAC,kBAAkB,EAAE,IAAI,CAAC;aACvC,aAAa,CAAC,qBAAqB,EAAE,IAAI,CAAC;aAC1C,aAAa,CAAC,kBAAkB,EAAE,IAAI,CAAC;aACvC,aAAa,CAAC,oBAAoB,EAAE,IAAI,CAAC;aACzC,aAAa,CAAC,oBAAoB,EAAE,IAAI,CAAC;aACzC,aAAa,CAAC,wBAAwB,EAAE,IAAI,CAAC;aAC7C,aAAa,CAAC,wBAAwB,EAAE,IAAI,CAAC;aAC7C,aAAa,CAAC,qBAAqB,EAAE,IAAI,CAAC;aAC1C,aAAa,CAAC,yBAAyB,EAAE,IAAI,CAAC,CAAC;IACxD,CAAC;AACL,CAAC"}
+{"version":3,"file":"cache.events.js","sourceRoot":"","sources":["../../../src/cache/contracts/cache.events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAwHH;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IACxB,KAAK,EAAE,OAAO;IACd,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,gBAAgB,EAAE,kBAAkB;CAC9B,CAAC"}

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

@@ -1,12 +1,12 @@
 /**
  * @module Cache
  */
-import type { CacheEvents, IDatabaseCacheAdapter } from "../../../../cache/contracts/_module-exports.js";
+import type { CacheEventMap, IDatabaseCacheAdapter } from "../../../../cache/contracts/_module-exports.js";
 import { type ICache, type ICacheAdapter } from "../../../../cache/contracts/_module-exports.js";
 import { type AsyncLazyable, type OneOrMore } from "../../../../utilities/_module-exports.js";
 import { type NoneFunc, type TimeSpan, KeyPrefixer } from "../../../../utilities/_module-exports.js";
 import { LazyPromise } from "../../../../async/_module-exports.js";
-import type { IEventBus, Unsubscribe, EventClass, EventInstance, EventListener } from "../../../../event-bus/contracts/_module-exports.js";
+import type { IEventBus, Unsubscribe, EventListener } from "../../../../event-bus/contracts/_module-exports.js";
 import type { AsyncLazy, Factory } from "../../../../utilities/_module-exports.js";
 /**
  *
@@ -38,7 +38,7 @@ export type CacheSettingsBase = {
      * })
      * ```
      */
-    eventBus?: IEventBus<any>;
+    eventBus?: IEventBus;
     /**
      * You can decide the default ttl value. If null is passed then no ttl will be used by default.
      * @default {null}
@@ -99,35 +99,35 @@ export declare class Cache<TType = unknown> implements ICache<TType> {
      */
     constructor(settings: CacheSettings);
     /**
-     * You can listen to the following {@link CacheEvents | `CacheEvents`} of the {@link ICache | `ICache`} instance.
+     * You can listen to the following {@link CacheEventMap | `CacheEventMap`} of the {@link ICache | `ICache`} instance.
      * To understand how this method works, refer to {@link IEventListenable | `IEventListenable `}.
      */
-    addListener<TEventClass extends EventClass<CacheEvents<TType>>>(event: TEventClass, listener: EventListener<EventInstance<TEventClass>>): LazyPromise<void>;
+    addListener<TEventName extends keyof CacheEventMap<TType>>(eventName: TEventName, listener: EventListener<CacheEventMap<TType>[TEventName]>): LazyPromise<void>;
     /**
-     * You can listen to the following {@link CacheEvents | `CacheEvents`} of the {@link ICache | `ICache`} instance.
+     * You can listen to the following {@link CacheEventMap | `CacheEventMap`} of the {@link ICache | `ICache`} instance.
      * To understand how this method works, refer to {@link IEventListenable | `IEventListenable `}.
      */
-    removeListener<TEventClass extends EventClass<CacheEvents<TType>>>(event: TEventClass, listener: EventListener<EventInstance<TEventClass>>): LazyPromise<void>;
+    removeListener<TEventName extends keyof CacheEventMap<TType>>(eventName: TEventName, listener: EventListener<CacheEventMap<TType>[TEventName]>): LazyPromise<void>;
     /**
-     * You can listen to the following {@link CacheEvents | `CacheEvents`} of the {@link ICache | `ICache`} instance.
+     * You can listen to the following {@link CacheEventMap | `CacheEventMap`} of the {@link ICache | `ICache`} instance.
      * To understand how this method works, refer to {@link IEventListenable | `IEventListenable `}.
      */
-    listenOnce<TEventClass extends EventClass<CacheEvents<TType>>>(event: TEventClass, listener: EventListener<EventInstance<TEventClass>>): LazyPromise<void>;
+    listenOnce<TEventName extends keyof CacheEventMap<TType>>(eventName: TEventName, listener: EventListener<CacheEventMap<TType>[TEventName]>): LazyPromise<void>;
     /**
-     * You can listen to the following {@link CacheEvents | `CacheEvents`} of the {@link ICache | `ICache`} instance.
+     * You can listen to the following {@link CacheEventMap | `CacheEventMap`} of the {@link ICache | `ICache`} instance.
      * To understand how this method works, refer to {@link IEventListenable | `IEventListenable `}.
      */
-    asPromise<TEventClass extends EventClass<CacheEvents<TType>>>(event: TEventClass): LazyPromise<EventInstance<TEventClass>>;
+    asPromise<TEventName extends keyof CacheEventMap<TType>>(eventName: TEventName): LazyPromise<CacheEventMap<TType>[TEventName]>;
     /**
-     * You can listen to the following {@link CacheEvents | `CacheEvents`} of the {@link ICache | `ICache`} instance.
+     * You can listen to the following {@link CacheEventMap | `CacheEventMap`} of the {@link ICache | `ICache`} instance.
      * To understand how this method works, refer to {@link IEventListenable | `IEventListenable `}.
      */
-    subscribeOnce<TEventClass extends EventClass<CacheEvents<TType>>>(event: TEventClass, listener: EventListener<EventInstance<TEventClass>>): LazyPromise<Unsubscribe>;
+    subscribeOnce<TEventName extends keyof CacheEventMap<TType>>(eventName: TEventName, listener: EventListener<CacheEventMap<TType>[TEventName]>): LazyPromise<Unsubscribe>;
     /**
-     * You can listen to the following {@link CacheEvents | `CacheEvents`} of the {@link ICache | `ICache`} instance.
+     * You can listen to the following {@link CacheEventMap | `CacheEventMap`} of the {@link ICache | `ICache`} instance.
      * To understand how this method works, refer to {@link IEventListenable | `IEventListenable `}.
      */
-    subscribe<TEventClass extends EventClass<CacheEvents<TType>>>(event: TEventClass, listener: EventListener<EventInstance<TEventClass>>): LazyPromise<Unsubscribe>;
+    subscribe<TEventName extends keyof CacheEventMap<TType>>(eventName: TEventName, listener: EventListener<CacheEventMap<TType>[TEventName]>): LazyPromise<Unsubscribe>;
     private createLazyPromise;
     exists(key: OneOrMore<string>): LazyPromise<boolean>;
     missing(key: OneOrMore<string>): LazyPromise<boolean>;