@daiso-tech/core 0.26.1 → 0.28.0

package/dist/cache/contracts/cache-adapter.contract.js

@@ -1,5 +1,2 @@
-/**
- * @module Cache
- */
-import {} from "../../cache/contracts/cache.errors.js";
+export {};
 //# sourceMappingURL=cache-adapter.contract.js.map

package/dist/cache/contracts/cache-adapter.contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache-adapter.contract.js","sourceRoot":"","sources":["../../../src/cache/contracts/cache-adapter.contract.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAGN,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"cache-adapter.contract.js","sourceRoot":"","sources":["../../../src/cache/contracts/cache-adapter.contract.ts"],"names":[],"mappings":""}

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

@@ -11,7 +11,7 @@ import type { IGroupableCache } from "../../cache/contracts/cache.contract.js";
 export type ICacheFactory<TAdapters extends string = string> = {
     /**
      * The <i>use</i> method will throw an error if you provide it unregisted adapter.
-     * If no default adapter is defined an error will be thrown by <i>use</i> method.
+     * If no default adapter is defined an error will be thrown.
      * @throws {UnregisteredAdapterError} {@link UnregisteredAdapterError}
      * @throws {DefaultAdapterNotDefinedError} {@link DefaultAdapterNotDefinedError}
      */

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

@@ -1,147 +1,191 @@
 /**
  * @module Cache
  */
-import type { IEventListenable } from "../../event-bus/contracts/_module-exports.js";
-import type { OneOrMore } from "../../utilities/_module-exports.js";
-import { type AsyncLazyable, type GetOrAddValue } from "../../utilities/_module-exports.js";
-import type { CacheEvents } from "../../cache/contracts/_module-exports.js";
-import type { TimeSpan } from "../../utilities/_module-exports.js";
 import type { LazyPromise } from "../../async/_module-exports.js";
+import type { TimeSpan } from "../../utilities/_module-exports.js";
+import type { AsyncLazyable, NoneFunction, OneOrMore } from "../../utilities/types.js";
+import type { CacheEvents } from "../../cache/contracts/cache.events.js";
+import type { IEventListenable } from "../../event-bus/contracts/_module-exports.js";
 /**
- * The <i>ICacheListenable</i> contract defines a way for listening <i>{@link ICache}</i> operations.
+ * The <i>ICacheListenable</i> contract defines a way for listening <i>{@link ICache}</i> operation events.
  *
  * IMPORT_PATH: ```"@daiso-tech/core/cache/contracts"```
  * @group Contracts
  */
 export type ICacheListenable<TType = unknown> = IEventListenable<CacheEvents<TType>>;
 /**
+ * The <i>ICacheBase</i> contract defines a way for as key-value pairs independent of data storage.
  *
  * IMPORT_PATH: ```"@daiso-tech/core/cache/contracts"```
  * @group Contracts
  */
-export type WithTtlValue<TType> = {
-    value: TType;
-    /**
-     * You can provide a <i>ttl</i> value. If null is passed, the item will not expire.
-     */
-    ttl?: TimeSpan | null;
-};
-/**
- * The <i>ICache</i> contract defines a way for storing data as key-value pairs independent of data storage.
- * It commes with more convient methods compared to <i>ICacheAdapter</i>.
- *
- * IMPORT_PATH: ```"@daiso-tech/core/cache/contracts"```
- * @group Contracts
- */
-export type ICache<TType = unknown> = ICacheListenable & {
+export type ICacheBase<TType = unknown> = {
     /**
      * The <i>exists</i> method returns true when <i>key</i> is found otherwise false will be returned.
+     *
+     * @param key - can be a string or an <i>Iterable</i> of strings.
+     * If it's an <i>Iterable</i>, it will be joined into a single string.
+     * Think of an <i>Iterable</i> as representing a path.
      */
-    exists(key: string): LazyPromise<boolean>;
-    /**
-     * The <i>existsMany</i> method returns true for the <i>keys</i> that are found otherwise false will be returned.
-     */
-    existsMany<TKeys extends string>(keys: TKeys[]): LazyPromise<Record<TKeys, boolean>>;
+    exists(key: OneOrMore<string>): LazyPromise<boolean>;
     /**
      * The <i>missing</i> method returns true when <i>key</i> is not found otherwise false will be returned.
+     *
+     * @param key - can be a string or an <i>Iterable</i> of strings.
+     * If it's an <i>Iterable</i>, it will be joined into a single string.
+     * Think of an <i>Iterable</i> as representing a path.
      */
-    missing(key: string): LazyPromise<boolean>;
-    /**
-     * The <i>missingMany</i> method returns true for the <i>keys</i> that are not found otherwise false will be returned.
-     */
-    missingMany<TKeys extends string>(keys: TKeys[]): LazyPromise<Record<TKeys, boolean>>;
+    missing(key: OneOrMore<string>): LazyPromise<boolean>;
     /**
      * The <i>get</i> method returns the value when <i>key</i> is found otherwise null will be returned.
+     *
+     * @param key - can be a string or an <i>Iterable</i> of strings.
+     * If it's an <i>Iterable</i>, it will be joined into a single string.
+     * Think of an <i>Iterable</i> as representing a path.
      */
-    get(key: string): LazyPromise<TType | null>;
-    /**
-     * The <i>getMany</i> returns the value for the <i>keys</i> that are found otherwise null will be returned.
-     */
-    getMany<TKeys extends string>(keys: TKeys[]): LazyPromise<Record<TKeys, TType | null>>;
-    /**
-     * The <i>getOr</i> method returns the value when <i>key</i> is found otherwise <i>defaultValue</i> will be returned.
-     */
-    getOr(key: string, defaultValue: AsyncLazyable<TType>): LazyPromise<TType>;
-    /**
-     * The <i>getOrMany</i> method returns the value for the keys that are found otherwise defaultValue will be returned.
-     */
-    getOrMany<TKeys extends string>(keysWithDefaults: Record<TKeys, AsyncLazyable<TType>>): LazyPromise<Record<TKeys, TType>>;
+    get(key: OneOrMore<string>): LazyPromise<TType | null>;
     /**
      * The <i>getOrFail</i> method returns the value when <i>key</i> is found otherwise an error will be thrown.
+     *
+     * @param key - can be a string or an <i>Iterable</i> of strings.
+     * If it's an <i>Iterable</i>, it will be joined into a single string.
+     * Think of an <i>Iterable</i> as representing a path.
+     *
      * @throws {KeyNotFoundCacheError} {@link KeyNotFoundCacheError}
      */
-    getOrFail(key: string): LazyPromise<TType>;
-    /**
-     * The <i>add</i> method adds a <i>key</i> with given <i>value</i> when key doesn't exists. Returns true when key doesn't exists otherwise false will be returned.
-     * You can provide a <i>ttl</i> value. If null is passed, the item will not expire.
-     */
-    add(key: string, value: TType, ttl?: TimeSpan | null): LazyPromise<boolean>;
+    getOrFail(key: OneOrMore<string>): LazyPromise<TType>;
     /**
-     * The <i>addMany</i> method adds new keys. Returns true for the keys that where added otherwise false will be returned.
+     * The <i>getAndRemove</i> method returns the value when <i>key</i> is found otherwise null will be returned.
+     * The key will be removed after it is returned.
+     *
+     * @param key - can be a string or an <i>Iterable</i> of strings.
+     * If it's an <i>Iterable</i>, it will be joined into a single string.
+     * Think of an <i>Iterable</i> as representing a path.
      */
-    addMany<TKeys extends string>(values: Record<TKeys, WithTtlValue<TType>>): LazyPromise<Record<TKeys, boolean>>;
+    getAndRemove(key: OneOrMore<string>): LazyPromise<TType | null>;
     /**
-     * The <i>update</i> method updates the given <i>key</i> with given <i>value</i>. Returns true when key otherwise false will be returned.
+     * The <i>getOr</i> method will retrieve the given <i>key</i> if found otherwise <i>defaultValue</i> will be returned.
+     *
+     * @param key - can be a string or an <i>Iterable</i> of strings.
+     * If it's an <i>Iterable</i>, it will be joined into a single string.
+     * Think of an <i>Iterable</i> as representing a path.
+     *
+     * @param defaultValue - can be sync function, async function or <i>{@link LazyPromise}</i>.
      */
-    update(key: string, value: TType): LazyPromise<boolean>;
-    /**
-     * The <i>updateMany</i> method updates the given keys. Returns true for the keys that where updated otherwise false will be returned.
-     */
-    updateMany<TKeys extends string>(values: Record<TKeys, TType>): LazyPromise<Record<TKeys, boolean>>;
-    /**
-     * The <i>put</i> method replaces a <i>key</i> if the <i>key</i> exists including the ttl value or adds <i>key</i> that do not exists with a given <i>ttl</i>.
-     * Returns true if the <i>key</i> where replaced otherwise false is returned.
-     * You can provide a <i>ttl</i> value for the replaced key. If <i>null</i> is passed, the item will not expires and <i>null</i> is the default value.
-     */
-    put(key: string, value: TType, ttl?: TimeSpan | null): LazyPromise<boolean>;
-    /**
-     * The <i>putMany</i> method replaces the keys that exists including their ttl values or adds keys that do not exists.
-     * Returns true for all the keys that where replaced otherwise false is returned.
-     */
-    putMany<TKeys extends string>(values: Record<TKeys, WithTtlValue<TType>>): LazyPromise<Record<TKeys, boolean>>;
-    /**
-     * The <i>remove</i> method removes the given <i>key</i> when found. Returns true if the key is found otherwise false is returned.
-     */
-    remove(key: string): LazyPromise<boolean>;
-    /**
-     * The <i>removeMany</i> method removes keys. Returns true for the keys that are removed otherwise false is returned.
-     */
-    removeMany<TKeys extends string>(keys: TKeys[]): LazyPromise<Record<TKeys, boolean>>;
-    /**
-     * The <i>getAndRemove</i> method removes the given <i>key</i> and returns it when found otherwise null will be returned.
-     */
-    getAndRemove(key: string): LazyPromise<TType | null>;
+    getOr(key: OneOrMore<string>, defaultValue: AsyncLazyable<NoneFunction<TType>>): LazyPromise<TType>;
     /**
      * The <i>getOrAdd</i> method will retrieve the given <i>key</i> if found otherwise <i>valueToAdd</i> will be added and returned.
-     * The <i>valueToAdd<i> can be async or sync function.
-     */
-    getOrAdd(key: string, valueToAdd: AsyncLazyable<GetOrAddValue<TType>>, ttl?: TimeSpan | null): LazyPromise<TType>;
-    /**
-     * The <i>increment</i> method will increment the given <i>key</i> if found otherwise nonthing will occur.
-     * Returns true if key is incremented otherwise false will be returned.
+     *
+     * @param key - can be a string or an <i>Iterable</i> of strings.
+     * If it's an <i>Iterable</i>, it will be joined into a single string.
+     * Think of an <i>Iterable</i> as representing a path.
+     *
+     * @param valueToAdd - can be sync function, async function or <i>{@link LazyPromise}</i>.
+     */
+    getOrAdd(key: OneOrMore<string>, valueToAdd: AsyncLazyable<NoneFunction<TType>>, ttl?: TimeSpan | null): LazyPromise<TType>;
+    /**
+     * The <i>add</i> method adds a <i>key</i> with given <i>value</i> when key doesn't exists.
+     *
+     * @param key - can be a string or an <i>Iterable</i> of strings.
+     * If it's an <i>Iterable</i>, it will be joined into a single string.
+     * Think of an <i>Iterable</i> as representing a path.
+     *
+     * @param ttl - If null is passed, the item will not expire.
+     *
+     * @returns true when key doesn't exists otherwise false will be returned.
+     */
+    add(key: OneOrMore<string>, value: TType, ttl?: TimeSpan | null): LazyPromise<boolean>;
+    /**
+     * The <i>put</i> method replaces th given <i>key</i> with the given <i>value</i> and <i>ttl</i> if the <i>key</i> exists
+     * othwerwise it will add the given <i>value</i> with the given <i>ttl</i>.
+     *
+     * @param key - can be a string or an <i>Iterable</i> of strings.
+     * If it's an <i>Iterable</i>, it will be joined into a single string.
+     * Think of an <i>Iterable</i> as representing a path.
+     *
+     * @param ttl - If null is passed, the item will not expire.
+     *
+     * @returns true if the <i>key</i> where replaced otherwise false is returned.
+     */
+    put(key: OneOrMore<string>, value: TType, ttl?: TimeSpan | null): LazyPromise<boolean>;
+    /**
+     * The <i>update</i> method updates the given <i>key</i> with given <i>value</i>.
+     *
+     * @param key - can be a string or an <i>Iterable</i> of strings.
+     * If it's an <i>Iterable</i>, it will be joined into a single string.
+     * Think of an <i>Iterable</i> as representing a path.
+     *
+     * @returns true if the <i>key</i> where updated otherwise false will be returned.
+     */
+    update(key: OneOrMore<string>, value: TType): LazyPromise<boolean>;
+    /**
+     * The <i>increment</i> method increments the given <i>key</i> with given <i>value</i>.
      * An error will thrown if the key is not a number.
+     *
+     * @param key - can be a string or an <i>Iterable</i> of strings.
+     * If it's an <i>Iterable</i>, it will be joined into a single string.
+     * Think of an <i>Iterable</i> as representing a path.
+     *
+     * @param value - If not defined then it will be defaulted to 1.
+     *
+     * @returns true if the <i>key</i> where incremented otherwise false will be returned.
+     *
      * @throws {TypeCacheError} {@link TypeCacheError}
      */
-    increment(key: string, value?: Extract<TType, number>): LazyPromise<boolean>;
+    increment(key: OneOrMore<string>, value?: Extract<TType, number>): LazyPromise<boolean>;
     /**
-     * The <i>decrement</i> method will decrement the given <i>key</i> if found otherwise nonthing will occur.
-     * Returns true if key exists otherwise false will be returned.
+     * The <i>decrement</i> method decrements the given <i>key</i> with given <i>value</i>.
      * An error will thrown if the key is not a number.
+     *
+     * @param key - can be a string or an <i>Iterable</i> of strings.
+     * If it's an <i>Iterable</i>, it will be joined into a single string.
+     * Think of an <i>Iterable</i> as representing a path.
+     *
+     * @param value - If not defined then it will be defaulted to 1.
+     *
+     * @returns true if the <i>key</i> where decremented otherwise false will be returned.
+     *
      * @throws {TypeCacheError} {@link TypeCacheError}
      */
-    decrement(key: string, value?: Extract<TType, number>): LazyPromise<boolean>;
+    decrement(key: OneOrMore<string>, value?: Extract<TType, number>): LazyPromise<boolean>;
+    /**
+     * The <i>remove</i> method removes the given <i>key</i>.
+     *
+     * @param key - can be a string or an <i>Iterable</i> of strings.
+     * If it's an <i>Iterable</i>, it will be joined into a single string.
+     * Think of an <i>Iterable</i> as representing a path.
+     *
+     * @returns true if the key is found otherwise false is returned.
+     */
+    remove(key: OneOrMore<string>): LazyPromise<boolean>;
+    /**
+     * The <i>removeMany</i> method removes many keys.
+     *
+     * @param keys - The param items can be a string or an <i>Iterable</i> of strings.
+     * If the param items are an <i>Iterable</i>, it will be joined into a single string.
+     * Think of an <i>Iterable</i> as representing a path.
+     *
+     * @returns true if one of the keys where deleted otherwise false is returned.
+     */
+    removeMany(keys: Iterable<OneOrMore<string>>): PromiseLike<boolean>;
     /**
-     * The <i>clear</i> method removes all the keys in the cache.
+     * The <i>clear</i> method removes all the keys in the cache. If a cache is in a group then only the keys part of the group will be removed.
      */
     clear(): LazyPromise<void>;
     /**
-     * The <i>getGroup</i> method returns the group name.
+     * The <i>getGroup</i> method returns the group name of the cache. If the cache is not part of a group then null is returned.
      */
-    getGroup(): string;
+    getGroup(): string | null;
 };
 /**
- * The <i>IGroupableCache</i> contract defines a way for storing data as key-value pairs independent of data storage.
- * It commes with one extra method which is useful for multitennat applications compared to <i>{@link ICache}</i>.
+ * The <i>ICache</i> contract defines a way for as key-value pairs independent of data storage and listening to operation events.
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/cache/contracts"```
+ * @group Contracts
+ */
+export type ICache<TType = unknown> = ICacheListenable<TType> & ICacheBase<TType>;
+/**
+ * The <i>IGroupableCache</i> contract defines a way for storing and grouping data as key-value pairs independent of data storage.
  *
  * IMPORT_PATH: ```"@daiso-tech/core/cache/contracts"```
  * @group Contracts
@@ -151,6 +195,10 @@ export type IGroupableCache<TType = unknown> = ICache<TType> & {
      * The <i>withGroup</i> method returns a new <i>{@link ICache}</i> instance that groups keys together.
      * Only keys in the same group will be updated, removed, or retrieved, leaving keys outside the group unaffected.
      * This useful for multitennat applications.
+     *
+     * @param group - can be a string or an <i>Iterable</i> of strings.
+     * If it's an <i>Iterable</i>, it will be joined into a single string.
+     * Think of an <i>Iterable</i> as representing a path.
      */
     withGroup(group: OneOrMore<string>): ICache<TType>;
 };

package/dist/cache/contracts/cache.contract.js

@@ -1,6 +1,5 @@
 /**
  * @module Cache
  */
-import {} from "../../utilities/_module-exports.js";
-import {} from "../../cache/contracts/_module-exports.js";
+export {};
 //# sourceMappingURL=cache.contract.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"cache.contract.js","sourceRoot":"","sources":["../../../src/cache/contracts/cache.contract.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAGN,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAON,MAAM,sCAAsC,CAAC"}
+{"version":3,"file":"cache.contract.js","sourceRoot":"","sources":["../../../src/cache/contracts/cache.contract.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/cache/contracts/cache.errors.js

@@ -1,7 +1,7 @@
 /**
  * @module Cache
  */
-import { CORE, } from "../../utilities/_module-exports.js";
+import { CORE, resolveOneOrMore, } from "../../utilities/_module-exports.js";
 /**
  *
  * IMPORT_PATH: ```"@daiso-tech/core/cache/contracts"```
@@ -72,10 +72,7 @@ export class KeyNotFoundCacheError extends CacheError {
  * @group Errors
  */
 export function registerCacheErrorsToSerde(serde) {
-    if (!Array.isArray(serde)) {
-        serde = [serde];
-    }
-    for (const serde_ of serde) {
+    for (const serde_ of resolveOneOrMore(serde)) {
         serde_
             .registerClass(CacheError, CORE)
             .registerClass(UnexpectedCacheError, CORE)

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

@@ -1 +1 @@
-{"version":3,"file":"cache.errors.js","sourceRoot":"","sources":["../../../src/cache/contracts/cache.errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,OAAO,EACH,IAAI,GAGP,MAAM,gCAAgC,CAAC;AAExC;;;;GAIG;AACH,MAAM,OAAO,UACT,SAAQ,KAAK;IAGb,MAAM,CAAC,WAAW,CAAC,iBAAmC;QAClD,OAAO,IAAI,UAAU,CACjB,iBAAiB,CAAC,OAAO,EACzB,iBAAiB,CAAC,KAAK,CAC1B,CAAC;IACN,CAAC;IAED,YAAY,OAAe,EAAE,KAAe;QACxC,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;IAChC,CAAC;IAED,SAAS;QACL,OAAO;YACH,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;SACpB,CAAC;IACN,CAAC;CACJ;AAED;;;;GAIG;AACH,MAAM,OAAO,oBACT,SAAQ,UAAU;IAGlB,MAAM,CAAU,WAAW,CACvB,iBAAmC;QAEnC,OAAO,IAAI,oBAAoB,CAC3B,iBAAiB,CAAC,OAAO,EACzB,iBAAiB,CAAC,KAAK,CAC1B,CAAC;IACN,CAAC;IAED,YAAY,OAAe,EAAE,KAAe;QACxC,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC,IAAI,CAAC;IAC1C,CAAC;CACJ;AAED;;;;GAIG;AACH,MAAM,OAAO,cACT,SAAQ,UAAU;IAGlB,MAAM,CAAU,WAAW,CACvB,iBAAmC;QAEnC,OAAO,IAAI,cAAc,CACrB,iBAAiB,CAAC,OAAO,EACzB,iBAAiB,CAAC,KAAK,CAC1B,CAAC;IACN,CAAC;IAED,YAAY,OAAe,EAAE,KAAe;QACxC,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC;IACpC,CAAC;CACJ;AAED;;;;GAIG;AACH,MAAM,OAAO,qBACT,SAAQ,UAAU;IAGlB,MAAM,CAAU,WAAW,CACvB,iBAAmC;QAEnC,OAAO,IAAI,qBAAqB,CAC5B,iBAAiB,CAAC,OAAO,EACzB,iBAAiB,CAAC,KAAK,CAC1B,CAAC;IACN,CAAC;IAED,YAAY,OAAe,EAAE,KAAe;QACxC,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC,IAAI,CAAC;IAC3C,CAAC;CACJ;AAED;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CACtC,KAAgC;IAEhC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM;aACD,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC;aAC/B,aAAa,CAAC,oBAAoB,EAAE,IAAI,CAAC;aACzC,aAAa,CAAC,cAAc,EAAE,IAAI,CAAC;aACnC,aAAa,CAAC,qBAAqB,EAAE,IAAI,CAAC,CAAC;IACpD,CAAC;AACL,CAAC"}
+{"version":3,"file":"cache.errors.js","sourceRoot":"","sources":["../../../src/cache/contracts/cache.errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,OAAO,EACH,IAAI,EACJ,gBAAgB,GAGnB,MAAM,gCAAgC,CAAC;AAExC;;;;GAIG;AACH,MAAM,OAAO,UACT,SAAQ,KAAK;IAGb,MAAM,CAAC,WAAW,CAAC,iBAAmC;QAClD,OAAO,IAAI,UAAU,CACjB,iBAAiB,CAAC,OAAO,EACzB,iBAAiB,CAAC,KAAK,CAC1B,CAAC;IACN,CAAC;IAED,YAAY,OAAe,EAAE,KAAe;QACxC,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;IAChC,CAAC;IAED,SAAS;QACL,OAAO;YACH,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;SACpB,CAAC;IACN,CAAC;CACJ;AAED;;;;GAIG;AACH,MAAM,OAAO,oBACT,SAAQ,UAAU;IAGlB,MAAM,CAAU,WAAW,CACvB,iBAAmC;QAEnC,OAAO,IAAI,oBAAoB,CAC3B,iBAAiB,CAAC,OAAO,EACzB,iBAAiB,CAAC,KAAK,CAC1B,CAAC;IACN,CAAC;IAED,YAAY,OAAe,EAAE,KAAe;QACxC,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC,IAAI,CAAC;IAC1C,CAAC;CACJ;AAED;;;;GAIG;AACH,MAAM,OAAO,cACT,SAAQ,UAAU;IAGlB,MAAM,CAAU,WAAW,CACvB,iBAAmC;QAEnC,OAAO,IAAI,cAAc,CACrB,iBAAiB,CAAC,OAAO,EACzB,iBAAiB,CAAC,KAAK,CAC1B,CAAC;IACN,CAAC;IAED,YAAY,OAAe,EAAE,KAAe;QACxC,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC;IACpC,CAAC;CACJ;AAED;;;;GAIG;AACH,MAAM,OAAO,qBACT,SAAQ,UAAU;IAGlB,MAAM,CAAU,WAAW,CACvB,iBAAmC;QAEnC,OAAO,IAAI,qBAAqB,CAC5B,iBAAiB,CAAC,OAAO,EACzB,iBAAiB,CAAC,KAAK,CAC1B,CAAC;IACN,CAAC;IAED,YAAY,OAAe,EAAE,KAAe;QACxC,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC,IAAI,CAAC;IAC3C,CAAC;CACJ;AAED;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CACtC,KAAgC;IAEhC,KAAK,MAAM,MAAM,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3C,MAAM;aACD,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC;aAC/B,aAAa,CAAC,oBAAoB,EAAE,IAAI,CAAC;aACzC,aAAa,CAAC,cAAc,EAAE,IAAI,CAAC;aACnC,aAAa,CAAC,qBAAqB,EAAE,IAAI,CAAC,CAAC;IACpD,CAAC;AACL,CAAC"}

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

@@ -10,7 +10,7 @@ import { type OneOrMore, type TimeSpan } from "../../utilities/_module-exports.j
  * @group Events
  */
 export declare class KeyFoundCacheEvent<TType = unknown> extends BaseEvent<{
-    group: string;
+    group: string | null;
     key: string;
     value: TType;
 }> {
@@ -21,7 +21,7 @@ export declare class KeyFoundCacheEvent<TType = unknown> extends BaseEvent<{
  * @group Events
  */
 export declare class KeyNotFoundCacheEvent extends BaseEvent<{
-    group: string;
+    group: string | null;
     key: string;
 }> {
 }
@@ -31,7 +31,7 @@ export declare class KeyNotFoundCacheEvent extends BaseEvent<{
  * @group Events
  */
 export declare class KeyAddedCacheEvent<TType = unknown> extends BaseEvent<{
-    group: string;
+    group: string | null;
     key: string;
     value: TType;
     ttl: TimeSpan | null;
@@ -43,7 +43,7 @@ export declare class KeyAddedCacheEvent<TType = unknown> extends BaseEvent<{
  * @group Events
  */
 export declare class KeyUpdatedCacheEvent<TType = unknown> extends BaseEvent<{
-    group: string;
+    group: string | null;
     key: string;
     value: TType;
 }> {
@@ -54,7 +54,7 @@ export declare class KeyUpdatedCacheEvent<TType = unknown> extends BaseEvent<{
  * @group Events
  */
 export declare class KeyRemovedCacheEvent extends BaseEvent<{
-    group: string;
+    group: string | null;
     key: string;
 }> {
 }
@@ -64,7 +64,7 @@ export declare class KeyRemovedCacheEvent extends BaseEvent<{
  * @group Events
  */
 export declare class KeyIncrementedCacheEvent extends BaseEvent<{
-    group: string;
+    group: string | null;
     key: string;
     value: number;
 }> {
@@ -75,7 +75,7 @@ export declare class KeyIncrementedCacheEvent extends BaseEvent<{
  * @group Events
  */
 export declare class KeyDecrementedCacheEvent extends BaseEvent<{
-    group: string;
+    group: string | null;
     key: string;
     value: number;
 }> {
@@ -86,7 +86,7 @@ export declare class KeyDecrementedCacheEvent extends BaseEvent<{
  * @group Events
  */
 export declare class KeysClearedCacheEvent extends BaseEvent<{
-    group: string;
+    group: string | null;
 }> {
 }
 /**
@@ -95,8 +95,8 @@ export declare class KeysClearedCacheEvent extends BaseEvent<{
  * @group Events
  */
 export declare class UnexpectedCacheErrorEvent extends BaseEvent<{
-    group: string;
-    key?: string;
+    group: string | null;
+    keys?: string[];
     value?: unknown;
     method: string;
     error: unknown;

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

@@ -2,7 +2,7 @@
  * @module Cache
  */
 import { BaseEvent } from "../../event-bus/contracts/_module-exports.js";
-import { CORE, } from "../../utilities/_module-exports.js";
+import { CORE, resolveOneOrMore, } from "../../utilities/_module-exports.js";
 /**
  *
  * IMPORT_PATH: ```"@daiso-tech/core/cache/contracts"```
@@ -73,10 +73,7 @@ export class UnexpectedCacheErrorEvent extends BaseEvent {
  * @group Events
  */
 export function registerCacheEventsToSerde(serde) {
-    if (!Array.isArray(serde)) {
-        serde = [serde];
-    }
-    for (const serde_ of serde) {
+    for (const serde_ of resolveOneOrMore(serde)) {
         serde_
             .registerEvent(KeyFoundCacheEvent, CORE)
             .registerEvent(KeyNotFoundCacheEvent, CORE)

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,GAGP,MAAM,gCAAgC,CAAC;AAExC;;;;GAIG;AACH,MAAM,OAAO,kBAAoC,SAAQ,SAIvD;CAAG;AAEL;;;;GAIG;AACH,MAAM,OAAO,qBAAsB,SAAQ,SAGzC;CAAG;AAEL;;;;GAIG;AACH,MAAM,OAAO,kBAAoC,SAAQ,SAKvD;CAAG;AAEL;;;;GAIG;AACH,MAAM,OAAO,oBAAsC,SAAQ,SAIzD;CAAG;AAEL;;;;GAIG;AACH,MAAM,OAAO,oBAAqB,SAAQ,SAGxC;CAAG;AAEL;;;;GAIG;AACH,MAAM,OAAO,wBAAyB,SAAQ,SAI5C;CAAG;AAEL;;;;GAIG;AACH,MAAM,OAAO,wBAAyB,SAAQ,SAI5C;CAAG;AAEL;;;;GAIG;AACH,MAAM,OAAO,qBAAsB,SAAQ,SAEzC;CAAG;AAEL;;;;GAIG;AACH,MAAM,OAAO,yBAA0B,SAAQ,SAM7C;CAAG;AAkBL;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CACtC,KAAgC;IAEhC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,KAAK,EAAE,CAAC;QACzB,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;AAIH,OAAO,EAAE,SAAS,EAAE,MAAM,0CAA0C,CAAC;AAErE,OAAO,EACH,IAAI,EACJ,gBAAgB,GAGnB,MAAM,gCAAgC,CAAC;AAExC;;;;GAIG;AACH,MAAM,OAAO,kBAAoC,SAAQ,SAIvD;CAAG;AAEL;;;;GAIG;AACH,MAAM,OAAO,qBAAsB,SAAQ,SAGzC;CAAG;AAEL;;;;GAIG;AACH,MAAM,OAAO,kBAAoC,SAAQ,SAKvD;CAAG;AAEL;;;;GAIG;AACH,MAAM,OAAO,oBAAsC,SAAQ,SAIzD;CAAG;AAEL;;;;GAIG;AACH,MAAM,OAAO,oBAAqB,SAAQ,SAGxC;CAAG;AAEL;;;;GAIG;AACH,MAAM,OAAO,wBAAyB,SAAQ,SAI5C;CAAG;AAEL;;;;GAIG;AACH,MAAM,OAAO,wBAAyB,SAAQ,SAI5C;CAAG;AAEL;;;;GAIG;AACH,MAAM,OAAO,qBAAsB,SAAQ,SAEzC;CAAG;AAEL;;;;GAIG;AACH,MAAM,OAAO,yBAA0B,SAAQ,SAM7C;CAAG;AAkBL;;;;;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"}

package/dist/cache/contracts/database-cache-adapter.contract.d.ts

@@ -0,0 +1,89 @@
+/**
+ * @module Cache
+ */
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/cache/contracts"```
+ * @group Contracts
+ */
+export type ICacheData<TType = unknown> = {
+    value: TType;
+    expiration: Date | null;
+};
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/cache/contracts"```
+ * @group Contracts
+ */
+export type ICacheDataExpiration = {
+    expiration: Date | null;
+};
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/cache/contracts"```
+ * @group Contracts
+ */
+export type ICacheInsert<TType = unknown> = {
+    key: string;
+    value: TType;
+    expiration: Date | null;
+};
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/cache/contracts"```
+ * @group Contracts
+ */
+export type ICacheUpdate<TType = unknown> = {
+    key: string;
+    value: TType;
+};
+/**
+ * The <i>IDatabaseCacheAdapter</i> contract defines a way for as key-value pairs independent of data storage.
+ * This contract simplifies the implementation of cache adapters with CRUD-based databases, such as SQL databases and ORMs like TypeOrm and MikroOrm.
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/cache/contracts"```
+ * @group Contracts
+ */
+export type IDatabaseCacheAdapter<TType = unknown> = {
+    /**
+     * The <i>find</i> method returns the the <i>key</i> data which includs <i>{@link ICacheData}.value</i> and <i>{@link ICacheData}.expiration</i>.
+     */
+    find(key: string): PromiseLike<ICacheData<TType> | null>;
+    /**
+     * The <i>insert</i> method inserts the given cache <i>data</i>.
+     */
+    insert(data: ICacheInsert<TType>): PromiseLike<void>;
+    /**
+     * The <i>upsert</i> method inserts a key and if the key already exists then key will be updated with new <i>data.value</i> and <i>data.expiration</i>.
+     * The method always returns the old cache data if it exists otherwise null will be returned.
+     */
+    upsert(data: ICacheInsert<TType>): PromiseLike<ICacheDataExpiration | null>;
+    /**
+     * The <i>removeExpiredMany</i> method updates a expired <i>key</i>.
+     */
+    updateExpired(data: ICacheInsert<TType>): PromiseLike<number>;
+    /**
+     * The <i>removeExpiredMany</i> method updates a unexpired <i>key</i>.
+     */
+    updateUnexpired(data: ICacheUpdate<TType>): PromiseLike<number>;
+    /**
+     * The <i>incrementUnexpired</i> should always throw an error if the existing item is not a number type.
+     */
+    incrementUnexpired(data: ICacheUpdate<number>): PromiseLike<number>;
+    /**
+     * The <i>removeExpiredMany</i> method removes multiple expired <i>keys</i>.
+     */
+    removeExpiredMany(keys: string[]): PromiseLike<number>;
+    /**
+     * The <i>removeExpiredMany</i> method removes multiple unexpired <i>keys</i>.
+     */
+    removeUnexpiredMany(keys: string[]): PromiseLike<number>;
+    /**
+     * The <i>removeAll</i> method removes all keys from the cache.
+     */
+    removeAll(): PromiseLike<void>;
+    /**
+     * The <i>removeByKeyPrefix</i> method removes all the keys in the cache that starts with the given <i>prefix</i>.
+     */
+    removeByKeyPrefix(prefix: string): PromiseLike<void>;
+};

package/dist/cache/contracts/database-cache-adapter.contract.js

@@ -0,0 +1,5 @@
+/**
+ * @module Cache
+ */
+export {};
+//# sourceMappingURL=database-cache-adapter.contract.js.map

package/dist/cache/contracts/database-cache-adapter.contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-cache-adapter.contract.js","sourceRoot":"","sources":["../../../src/cache/contracts/database-cache-adapter.contract.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/cache/implementations/adapters/{kysely-sqlite-cache-adapter → kysely-cache-adapter}/_module.d.ts

@@ -1 +1 @@
-export * from "../../../../cache/implementations/adapters/kysely-sqlite-cache-adapter/kysely-sqlite-cache-adapter.js";
+export * from "../../../../cache/implementations/adapters/kysely-cache-adapter/kysely-cache-adapter.js";

package/dist/cache/implementations/adapters/kysely-cache-adapter/_module.js

@@ -0,0 +1,2 @@
+export * from "../../../../cache/implementations/adapters/kysely-cache-adapter/kysely-cache-adapter.js";
+//# sourceMappingURL=_module.js.map

package/dist/cache/implementations/adapters/kysely-cache-adapter/_module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../../../src/cache/implementations/adapters/kysely-cache-adapter/_module.ts"],"names":[],"mappings":"AAAA,cAAc,+EAA+E,CAAC"}