@daiso-tech/core 0.30.0 → 0.31.1

package/dist/async/utilities/lazy-promise/lazy-promise.d.ts

@@ -2,7 +2,7 @@
  * @module Async
  */
 import type { BackoffPolicy } from "../../../async/backof-policies/_module.js";
-import type { AsyncLazy, Promisable, TimeSpan } from "../../../utilities/_module-exports.js";
+import type { AsyncLazy, Invokable, InvokableFn, Promisable, TimeSpan } from "../../../utilities/_module-exports.js";
 import type { RetryPolicy } from "../../../async/utilities/retry/_module.js";
 /**
  *
@@ -56,16 +56,18 @@ export type LazyPromiseSettings<TValue = unknown> = LazyPromiseCallbacks<TValue>
  * The <i>LazyPromise</i> class is used for creating lazy <i>{@link PromiseLike}<i> object that will only execute when awaited or when then method is called.
  * The class includes helpful methods
  * - <i>defer</i>
- * - <i>retryAttempts</i>
- * - <i>retryPolicy</i>
+ * - <i>setRetryAttempts</i>
+ * - <i>setRetryTimeout</i>
+ * - <i>setRetryPolicy</i>
  * - <i>backoffPolicy</i>
- * - <i>abort</i>
- * - <i>timeout</i>
+ * - <i>setTotalTimeout</i>
+ * - <i>setAbortSignal</i>
  *
  * The order in which these methods are called does not affect their methodality. Internally, the following execution order is applied:
- * 1. <i>timeout</i>
- * 2. <i>retryAttempts</i>
- * 3. <i>abort</i>
+ * 1. <i>setRetryTimeout</i>
+ * 2. <i>setRetryAttempts</i>
+ * 3. <i>setTotalTimeout</i>
+ * 4. <i>setAbortSignal</i>
  *
  * This means that combining all methods ensures the <i>retryAttempts</i> method will continue retrying even if the timeout is triggered,
  * while the <i>abort</i> method takes priority to cancel all operations if activated.
@@ -75,7 +77,7 @@ export type LazyPromiseSettings<TValue = unknown> = LazyPromiseCallbacks<TValue>
  */
 export declare class LazyPromise<TValue> implements PromiseLike<TValue> {
     /**
-     * The <i>wrapFn</i> is convience method used for wrapping a async method with a <i>LazyPromise</i>.
+     * The <i>wrapFn</i> is convience method used for wrapping async <i>{@link Invokable}</i> with a <i>LazyPromise</i>.
      * @example
      * ```ts
      * import { LazyPromise } from "@daiso-tech/core/async";
@@ -86,10 +88,10 @@ export declare class LazyPromise<TValue> implements PromiseLike<TValue> {
      *
      * const file = await readFile("none_existing_file.txt")
      *   .setRetryAttempts(4)
-     *   .timeout(TimeSpan.fromMinutes(1));
+     *   .setRetryTimeout(TimeSpan.fromMinutes(1));
      * ```
      */
-    static wrapFn<TArgs extends unknown[], TReturn>(fn: (...args: TArgs) => PromiseLike<TReturn>, settings?: LazyPromiseSettings<TReturn>): (...parameters: TArgs) => PromiseLike<TReturn>;
+    static wrapFn<TArgs extends unknown[], TReturn>(fn: Invokable<TArgs, Promisable<TReturn>>, settings?: LazyPromiseSettings<TReturn>): InvokableFn<TArgs, LazyPromise<TReturn>>;
     /**
      * The <i>delay</i> method creates a <i>{@link LazyPromise}</i> that will be fulfilled after given <i>time</i>.
      *
@@ -103,6 +105,7 @@ export declare class LazyPromise<TValue> implements PromiseLike<TValue> {
      * console.log("a");
      * await LazyPromise.delay(TimeSpan.fromSeconds(2));
      * console.log("b");
+     * ```
      */
     static delay(time: TimeSpan): LazyPromise<void>;
     /**
@@ -135,6 +138,7 @@ export declare class LazyPromise<TValue> implements PromiseLike<TValue> {
      *
      * // "I am lazy" will only logged when awaited or then method i called.
      * await promise;
+     * ```
      */
     constructor(asyncFn: AsyncLazy<TValue>, settings?: LazyPromiseSettings<TValue>);
     private applyRetryTimeout;
@@ -273,7 +277,7 @@ export declare class LazyPromise<TValue> implements PromiseLike<TValue> {
      * The <i>defer</i> method executes the <i>LazyPromise</i> without awaiting it.
      * @example
      * ```ts
-     * import { LazyPromise } from "@daiso-tech/core";
+     * import { LazyPromise } from "@daiso-tech/core/async";
      * import { TimeSpan } from "@daiso-tech/core/utilities";
      *
      * const promise =

package/dist/async/utilities/lazy-promise/lazy-promise.js

@@ -11,22 +11,24 @@ AbortAsyncError,
 TimeoutAsyncError, 
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
 RetryAsyncError, } from "../../../async/async.errors.js";
-import { removeUndefinedProperties, resolveAsyncLazyable, } from "../../../utilities/_module-exports.js";
+import { removeUndefinedProperties, resolveAsyncLazyable, resolveInvokable, } from "../../../utilities/_module-exports.js";
 import { delay } from "../../../async/utilities/_module.js";
 /**
  * The <i>LazyPromise</i> class is used for creating lazy <i>{@link PromiseLike}<i> object that will only execute when awaited or when then method is called.
  * The class includes helpful methods
  * - <i>defer</i>
- * - <i>retryAttempts</i>
- * - <i>retryPolicy</i>
+ * - <i>setRetryAttempts</i>
+ * - <i>setRetryTimeout</i>
+ * - <i>setRetryPolicy</i>
  * - <i>backoffPolicy</i>
- * - <i>abort</i>
- * - <i>timeout</i>
+ * - <i>setTotalTimeout</i>
+ * - <i>setAbortSignal</i>
  *
  * The order in which these methods are called does not affect their methodality. Internally, the following execution order is applied:
- * 1. <i>timeout</i>
- * 2. <i>retryAttempts</i>
- * 3. <i>abort</i>
+ * 1. <i>setRetryTimeout</i>
+ * 2. <i>setRetryAttempts</i>
+ * 3. <i>setTotalTimeout</i>
+ * 4. <i>setAbortSignal</i>
  *
  * This means that combining all methods ensures the <i>retryAttempts</i> method will continue retrying even if the timeout is triggered,
  * while the <i>abort</i> method takes priority to cancel all operations if activated.
@@ -36,7 +38,7 @@ import { delay } from "../../../async/utilities/_module.js";
  */
 export class LazyPromise {
     /**
-     * The <i>wrapFn</i> is convience method used for wrapping a async method with a <i>LazyPromise</i>.
+     * The <i>wrapFn</i> is convience method used for wrapping async <i>{@link Invokable}</i> with a <i>LazyPromise</i>.
      * @example
      * ```ts
      * import { LazyPromise } from "@daiso-tech/core/async";
@@ -47,11 +49,11 @@ export class LazyPromise {
      *
      * const file = await readFile("none_existing_file.txt")
      *   .setRetryAttempts(4)
-     *   .timeout(TimeSpan.fromMinutes(1));
+     *   .setRetryTimeout(TimeSpan.fromMinutes(1));
      * ```
      */
     static wrapFn(fn, settings) {
-        return (...parameters) => new LazyPromise(() => fn(...parameters), settings);
+        return (...parameters) => new LazyPromise(() => resolveInvokable(fn)(...parameters), settings);
     }
     /**
      * The <i>delay</i> method creates a <i>{@link LazyPromise}</i> that will be fulfilled after given <i>time</i>.
@@ -66,6 +68,7 @@ export class LazyPromise {
      * console.log("a");
      * await LazyPromise.delay(TimeSpan.fromSeconds(2));
      * console.log("b");
+     * ```
      */
     static delay(time) {
         return new LazyPromise(async () => {
@@ -110,6 +113,7 @@ export class LazyPromise {
      *
      * // "I am lazy" will only logged when awaited or then method i called.
      * await promise;
+     * ```
      */
     constructor(asyncFn, settings = {}) {
         this.asyncFn = () => resolveAsyncLazyable(asyncFn);
@@ -373,7 +377,7 @@ export class LazyPromise {
      * The <i>defer</i> method executes the <i>LazyPromise</i> without awaiting it.
      * @example
      * ```ts
-     * import { LazyPromise } from "@daiso-tech/core";
+     * import { LazyPromise } from "@daiso-tech/core/async";
      * import { TimeSpan } from "@daiso-tech/core/utilities";
      *
      * const promise =

package/dist/async/utilities/lazy-promise/lazy-promise.js.map

@@ -1 +1 @@
-{"version":3,"file":"lazy-promise.js","sourceRoot":"","sources":["../../../../src/async/utilities/lazy-promise/lazy-promise.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO;AACH,6DAA6D;AAC7D,eAAe;AACf,6DAA6D;AAC7D,iBAAiB;AACjB,6DAA6D;AAC7D,eAAe,GAClB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACH,yBAAyB,EACzB,oBAAoB,GACvB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,8BAA8B,CAAC;AA0DrD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,WAAW;IACpB;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,MAAM,CACT,EAA4C,EAC5C,QAAuC;QAEvC,OAAO,CAAC,GAAG,UAAiB,EAAwB,EAAE,CAClD,IAAI,WAAW,CAAU,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,EAAE,QAAQ,CAAC,CAAC;IACpE,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,KAAK,CAAC,IAAc;QACvB,OAAO,IAAI,WAAW,CAAC,KAAK,IAAI,EAAE;YAC9B,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,GAAG,CAAS,QAA+B;QAC9C,OAAO,IAAI,WAAW,CAAW,KAAK,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,UAAU,CACb,QAA+B;QAE/B,OAAO,IAAI,WAAW,CAAiC,KAAK,IAAI,EAAE,CAC9D,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAC/B,CAAC;IACN,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAI,CAAS,QAA+B;QAC/C,OAAO,IAAI,WAAW,CAAC,KAAK,IAAI,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,GAAG,CAAS,QAA+B;QAC9C,OAAO,IAAI,WAAW,CAAC,KAAK,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC9D,CAAC;IAEO,OAAO,GAA+B,IAAI,CAAC;IAC3C,OAAO,CAA4B;IAC1B,QAAQ,CAAwC;IAEjE;;;;;;;;;;;OAWG;IACH,YACI,OAA0B,EAC1B,WAAwC,EAAE;QAE1C,IAAI,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACnD,IAAI,CAAC,QAAQ,GAAG,yBAAyB,CAAC;YACtC,aAAa,EAAE,IAAI;YACnB,aAAa,EAAE,IAAI;YACnB,WAAW,EAAE,IAAI;YACjB,YAAY,EAAE,IAAI;YAClB,YAAY,EAAE,IAAI;YAClB,WAAW,EAAE,IAAI;YACjB,SAAS,EAAE,GAAG,EAAE,GAAE,CAAC;YACnB,SAAS,EAAE,CAAC,MAAc,EAAE,EAAE,GAAE,CAAC;YACjC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC;YACjB,GAAG,QAAQ;SACd,CAAC,CAAC;IACP,CAAC;IAEO,iBAAiB;QACrB,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;YACtC,OAAO;QACX,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC;QAChC,MAAM,UAAU,GAAG,GAAG,EAAE;YACpB,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;gBACtC,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;YACzD,CAAC;YACD,OAAO,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QAClE,CAAC,CAAC;QACF,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC;IAC9B,CAAC;IAEO,UAAU;QACd,IAAI,IAAI,CAAC,QAAQ,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;YACvC,OAAO;QACX,CAAC;QAED,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEzB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC;QAChC,MAAM,UAAU,GAAG,GAAG,EAAE;YACpB,IAAI,IAAI,CAAC,QAAQ,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;gBACvC,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;YAC7D,CAAC;YACD,OAAO,WAAW,CAAC,UAAU,EAAE;gBAC3B,aAAa,EAAE,IAAI,CAAC,QAAQ,CAAC,aAAa,IAAI,SAAS;gBACvD,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,IAAI,SAAS;gBACnD,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,aAAa;aAC3C,CAAC,CAAC;QACP,CAAC,CAAC;QACF,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC;IAC9B,CAAC;IAEO,iBAAiB;QACrB,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;YACtC,OAAO;QACX,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC;QAChC,MAAM,UAAU,GAAG,GAAG,EAAE;YACpB,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;gBACtC,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;YACzD,CAAC;YACD,OAAO,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QAClE,CAAC,CAAC;QACF,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC;IAC9B,CAAC;IAEO,UAAU;QACd,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;YACrC,OAAO;QACX,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC;QAChC,MAAM,UAAU,GAAG,GAAG,EAAE;YACpB,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;gBACrC,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;YAChE,CAAC;YACD,OAAO,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QAC/D,CAAC,CAAC;QACF,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC;IAC9B,CAAC;IAEO,aAAa;QACjB,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,IAAI,CAAC,UAAU,EAAE,CAAC;IACtB,CAAC;IAED;;;;OAIG;IACH,IAAI,CACA,WAEU;IACV,8DAA8D;IAC9D,UAAuE;QAEvE,IAAI,CAAC,aAAa,EAAE,CAAC;QAErB,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YACxB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAClC,CAAC;QACD,qFAAqF;QACrF,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IACtD,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,gBAAgB,CAAC,MAA4B;QACzC,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE;YACjC,GAAG,IAAI,CAAC,QAAQ;YAChB,aAAa,EAAE,MAAM;SACxB,CAAC,CAAC;IACP,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,gBAAgB,CAAC,QAAuB;QACpC,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE;YACjC,GAAG,IAAI,CAAC,QAAQ;YAChB,aAAa,EAAE,QAAQ;SAC1B,CAAC,CAAC;IACP,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,cAAc,CAAC,MAA0B;QACrC,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE;YACjC,GAAG,IAAI,CAAC,QAAQ;YAChB,WAAW,EAAE,MAAM;SACtB,CAAC,CAAC;IACP,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,eAAe,CAAC,IAAqB;QACjC,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE;YACjC,GAAG,IAAI,CAAC,QAAQ;YAChB,YAAY,EAAE,IAAI;SACrB,CAAC,CAAC;IACP,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,eAAe,CAAC,IAAqB;QACjC,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE;YACjC,GAAG,IAAI,CAAC,QAAQ;YAChB,YAAY,EAAE,IAAI;SACrB,CAAC,CAAC;IACP,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,cAAc,CAAC,WAA+B;QAC1C,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE;YACjC,GAAG,IAAI,CAAC,QAAQ;YAChB,WAAW;SACd,CAAC,CAAC;IACP,CAAC;IAED,SAAS,CAAC,EAAwB;QAC9B,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE;YACjC,GAAG,IAAI,CAAC,QAAQ;YAChB,SAAS,EAAE,EAAE;SAChB,CAAC,CAAC;IACP,CAAC;IAED,SAAS,CAAC,EAAgC;QACtC,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE;YACjC,GAAG,IAAI,CAAC,QAAQ;YAChB,SAAS,EAAE,EAAE;SAChB,CAAC,CAAC;IACP,CAAC;IAED,OAAO,CAAC,EAAsB;QAC1B,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE;YACjC,GAAG,IAAI,CAAC,QAAQ;YAChB,OAAO,EAAE,EAAE;SACd,CAAC,CAAC;IACP,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,KAAK;QACD,MAAM,eAAe,GAAG,KAAK,EAAE,KAAa,EAAmB,EAAE;YAC7D,IAAI,CAAC;gBACD,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;gBACrC,OAAO,KAAK,CAAC;YACjB,CAAC;oBAAS,CAAC;gBACP,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;YACpC,CAAC;QACL,CAAC,CAAC;QAEF,MAAM,cAAc,GAAG,KAAK,EAAE,KAAc,EAAoB,EAAE;YAC9D,IAAI,CAAC;gBACD,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBACnC,OAAO,KAAK,CAAC;YACjB,CAAC;oBAAS,CAAC;gBACP,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;YACpC,CAAC;QACL,CAAC,CAAC;QAEF,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC;IAC/C,CAAC;CACJ"}
+{"version":3,"file":"lazy-promise.js","sourceRoot":"","sources":["../../../../src/async/utilities/lazy-promise/lazy-promise.ts"],"names":[],"mappings":"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"}

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

@@ -70,7 +70,7 @@ export type ICacheBase<TType = unknown> = {
      * 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>.
+     * @param defaultValue - can be regular value, sync or async <i>{@link Invokable}</i> value and <i>{@link LazyPromise}</i> value.
      */
     getOr(key: OneOrMore<string>, defaultValue: AsyncLazyable<NoneFunc<TType>>): LazyPromise<TType>;
     /**
@@ -80,7 +80,7 @@ export type ICacheBase<TType = unknown> = {
      * 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>.
+     * @param valueToAdd - can be regular value, sync or async <i>{@link Invokable}</i> value and <i>{@link LazyPromise}</i> value.
      */
     getOrAdd(key: OneOrMore<string>, valueToAdd: AsyncLazyable<NoneFunc<TType>>, ttl?: TimeSpan | null): LazyPromise<TType>;
     /**

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

@@ -101,15 +101,15 @@ export declare class Cache<TType = unknown> implements IGroupableCache<TType> {
      * @example
      * ```ts
      * import { SqliteCacheAdapter } from "@daiso-tech/core/cache/adapters";
-     * import type { ICacheAdapter } from "@daiso-tech/core/cache/contracts";
+     * import type { IDatabaseCacheAdapter } from "@daiso-tech/core/cache/contracts";
      * import { Serde } from "@daiso-tech/core/serde";
      * import type { ISerde } from "@daiso-tech/core/serde/contracts";
      * import { SuperJsonSerdeAdapter } from "@daiso-tech/core/serde/adapters"
      * import Sqlite from "better-sqlite3";
      * import { Cache } from "@daiso-tech/core/cache";
-     * import { KeyPrefixer, type ISqliteDatabase, type FactoryFn } from "@daiso-tech/core/utilities";
+     * import { KeyPrefixer, type ISqliteDatabase, type AsyncFactoryFn } from "@daiso-tech/core/utilities";
      *
-     * function cahceAdapterFactory(database: ISqliteDatabase, serde: ISerde<string>): FactoryFn<string, ICacheAdapter> {
+     * function cahceAdapterFactory(database: ISqliteDatabase, serde: ISerde<string>): AsyncFactoryFn<string, IDatabaseCacheAdapter> {
      *   return async (prefix) => {
      *     const cacheAdapter = new SqliteCacheAdapter({
      *       database,
@@ -133,18 +133,18 @@ export declare class Cache<TType = unknown> implements IGroupableCache<TType> {
      * @example
      * ```ts
      * import { SqliteCacheAdapter } from "@daiso-tech/core/cache/adapters";
-     * import type { ICacheAdapter } from "@daiso-tech/core/cache/contracts";
+     * import type { IDatabaseCacheAdapter } from "@daiso-tech/core/cache/contracts";
      * import { Serde } from "@daiso-tech/core/serde";
      * import type { ISerde } from "@daiso-tech/core/serde/contracts";
      * import { SuperJsonSerdeAdapter } from "@daiso-tech/core/serde/adapters"
      * import Sqlite from "better-sqlite3";
      * import { Cache } from "@daiso-tech/core/cache";
-     * import { KeyPrefixer, type ISqliteDatabase, type IFactoryObject, type Promiseable } from "@daiso-tech/core/utilities";
+     * import { KeyPrefixer, type ISqliteDatabase, type IAsyncFactoryObject } from "@daiso-tech/core/utilities";
      *
-     * class CahceAdapterFactory implements IFactoryObject<string, ICacheAdapter> {
+     * class CahceAdapterFactory implements IAsyncFactoryObject<string, IDatabaseCacheAdapter> {
      *   constructor(private readonly database: ISqliteDatabase, private readonly serde: ISerde<string>) {}
      *
-     *   async use(prefix: string): Promiseable<ICacheAdapter> {
+     *   async use(prefix: string): Promise<IDatabaseCacheAdapter> {
      *     const cacheAdapter = new SqliteCacheAdapter({
      *       database: this.database,
      *       serde: this.serde,
@@ -215,151 +215,7 @@ export declare class Cache<TType = unknown> implements IGroupableCache<TType> {
     get(key: OneOrMore<string>): LazyPromise<TType | null>;
     getOrFail(key: OneOrMore<string>): LazyPromise<TType>;
     getAndRemove(key: OneOrMore<string>): LazyPromise<TType | null>;
-    /**
-     * @example
-     * ```ts
-     * import { Cache } from "@daiso-tech/core/cache";
-     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/adapters";
-     * import { KeyPrefixer } from "@daiso-tech/core/utilities";
-     *
-     * const cache = new Cache({
-     *   adapter: new MemoryCacheAdapter(),
-     *   keyPrefixer: new KeyPrefixer("cache")
-     * });
-     *
-     * const value = await cache.getOr("a", 1);
-     *
-     * // Will be 1
-     * console.log(value);
-     * ```
-     *
-     * You can also pass in a function
-     * @example
-     * ```ts
-     * import { Cache } from "@daiso-tech/core/cache";
-     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/adapters";
-     * import { KeyPrefixer } from "@daiso-tech/core/utilities";
-     *
-     * const cache = new Cache({
-     *   adapter: new MemoryCacheAdapter(),
-     *   keyPrefixer: new KeyPrefixer("cache")
-     * });
-     *
-     * const value = await cache.getOr("a", () => 1);
-     *
-     * // Will be 1
-     * console.log(value);
-     * ```
-     *
-     * You can also pass in a async function. This is useful because it allows for retrieval of external data if the key doesnt't.
-     * @example
-     * ```ts
-     * import { Cache } from "@daiso-tech/core/cache";
-     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/adapters";
-     * import { KeyPrefixer } from "@daiso-tech/core/utilities";
-     *
-     * const cache = new Cache({
-     *   adapter: new MemoryCacheAdapter(),
-     *   keyPrefixer: new KeyPrefixer("cache")
-     * });
-     *
-     * const value = await cache.getOr("a", async () => 1);
-     *
-     * // Will be 1
-     * console.log(value);
-     * ```
-     *
-     * You can also pass in a <i>{@link LazyPromise}</i>. This is useful because all other components in this library returns <i>{@link LazyPromise}</i>.
-     * @example
-     * ```ts
-     * import { Cache } from "@daiso-tech/core/cache";
-     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/adapters";
-     * import { KeyPrefixer, LazyPromise } from "@daiso-tech/core/utilities";
-     *
-     * const cache = new Cache({
-     *   adapter: new MemoryCacheAdapter(),
-     *   keyPrefixer: new KeyPrefixer("cache")
-     * });
-     *
-     * const value = await cache.getOr("a", new LazyPromise(async () => 1));
-     *
-     * // Will be 1
-     * console.log(value);
-     * ```
-     */
     getOr(key: OneOrMore<string>, defaultValue: AsyncLazyable<NoneFunc<TType>>): LazyPromise<TType>;
-    /**
-     * @example
-     * ```ts
-     * import { Cache } from "@daiso-tech/core/cache";
-     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/adapters";
-     * import { KeyPrefixer } from "@daiso-tech/core/utilities";
-     *
-     * const cache = new Cache({
-     *   adapter: new MemoryCacheAdapter(),
-     *   keyPrefixer: new KeyPrefixer("cache")
-     * });
-     *
-     * const value = await cache.getOrAdd("a", 1);
-     *
-     * // Will be 1
-     * console.log(value);
-     * ```
-     *
-     * You can also pass in a function
-     * @example
-     * ```ts
-     * import { Cache } from "@daiso-tech/core/cache";
-     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/adapters";
-     * import { KeyPrefixer } from "@daiso-tech/core/utilities";
-     *
-     * const cache = new Cache({
-     *   adapter: new MemoryCacheAdapter(),
-     *   keyPrefixer: new KeyPrefixer("cache")
-     * });
-     *
-     * const value = await cache.getOrAdd("a", () => 1);
-     *
-     * // Will be 1
-     * console.log(value);
-     * ```
-     *
-     * You can also pass in a async function. This is useful because it allows for retrieval of external data if the key doesnt't.
-     * @example
-     * ```ts
-     * import { Cache } from "@daiso-tech/core/cache";
-     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/adapters";
-     * import { KeyPrefixer } from "@daiso-tech/core/utilities";
-     *
-     * const cache = new Cache({
-     *   adapter: new MemoryCacheAdapter(),
-     *   keyPrefixer: new KeyPrefixer("cache")
-     * });
-     *
-     * const value = await cache.getOrAdd("a", async () => 1);
-     *
-     * // Will be 1
-     * console.log(value);
-     * ```
-     *
-     * You can also pass in a <i>{@link LazyPromise}</i>. This is useful because all other components in this library returns <i>{@link LazyPromise}</i>.
-     * @example
-     * ```ts
-     * import { Cache } from "@daiso-tech/core/cache";
-     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/adapters";
-     * import { KeyPrefixer, LazyPromise } from "@daiso-tech/core/utilities";
-     *
-     * const cache = new Cache({
-     *   adapter: new MemoryCacheAdapter(),
-     *   keyPrefixer: new KeyPrefixer("cache")
-     * });
-     *
-     * const value = await cache.getOrAdd("a", new LazyPromise(async () => 1));
-     *
-     * // Will be 1
-     * console.log(value);
-     * ```
-     */
     getOrAdd(key: OneOrMore<string>, valueToAdd: AsyncLazyable<NoneFunc<TType>>, ttl?: TimeSpan | null): LazyPromise<TType>;
     add(key: OneOrMore<string>, value: TType, ttl?: TimeSpan | null): LazyPromise<boolean>;
     put(key: OneOrMore<string>, value: TType, ttl?: TimeSpan | null): LazyPromise<boolean>;

package/dist/cache/implementations/derivables/cache/cache.js

@@ -73,15 +73,15 @@ export class Cache {
      * @example
      * ```ts
      * import { SqliteCacheAdapter } from "@daiso-tech/core/cache/adapters";
-     * import type { ICacheAdapter } from "@daiso-tech/core/cache/contracts";
+     * import type { IDatabaseCacheAdapter } from "@daiso-tech/core/cache/contracts";
      * import { Serde } from "@daiso-tech/core/serde";
      * import type { ISerde } from "@daiso-tech/core/serde/contracts";
      * import { SuperJsonSerdeAdapter } from "@daiso-tech/core/serde/adapters"
      * import Sqlite from "better-sqlite3";
      * import { Cache } from "@daiso-tech/core/cache";
-     * import { KeyPrefixer, type ISqliteDatabase, type FactoryFn } from "@daiso-tech/core/utilities";
+     * import { KeyPrefixer, type ISqliteDatabase, type AsyncFactoryFn } from "@daiso-tech/core/utilities";
      *
-     * function cahceAdapterFactory(database: ISqliteDatabase, serde: ISerde<string>): FactoryFn<string, ICacheAdapter> {
+     * function cahceAdapterFactory(database: ISqliteDatabase, serde: ISerde<string>): AsyncFactoryFn<string, IDatabaseCacheAdapter> {
      *   return async (prefix) => {
      *     const cacheAdapter = new SqliteCacheAdapter({
      *       database,
@@ -105,18 +105,18 @@ export class Cache {
      * @example
      * ```ts
      * import { SqliteCacheAdapter } from "@daiso-tech/core/cache/adapters";
-     * import type { ICacheAdapter } from "@daiso-tech/core/cache/contracts";
+     * import type { IDatabaseCacheAdapter } from "@daiso-tech/core/cache/contracts";
      * import { Serde } from "@daiso-tech/core/serde";
      * import type { ISerde } from "@daiso-tech/core/serde/contracts";
      * import { SuperJsonSerdeAdapter } from "@daiso-tech/core/serde/adapters"
      * import Sqlite from "better-sqlite3";
      * import { Cache } from "@daiso-tech/core/cache";
-     * import { KeyPrefixer, type ISqliteDatabase, type IFactoryObject, type Promiseable } from "@daiso-tech/core/utilities";
+     * import { KeyPrefixer, type ISqliteDatabase, type IAsyncFactoryObject } from "@daiso-tech/core/utilities";
      *
-     * class CahceAdapterFactory implements IFactoryObject<string, ICacheAdapter> {
+     * class CahceAdapterFactory implements IAsyncFactoryObject<string, IDatabaseCacheAdapter> {
      *   constructor(private readonly database: ISqliteDatabase, private readonly serde: ISerde<string>) {}
      *
-     *   async use(prefix: string): Promiseable<ICacheAdapter> {
+     *   async use(prefix: string): Promise<IDatabaseCacheAdapter> {
      *     const cacheAdapter = new SqliteCacheAdapter({
      *       database: this.database,
      *       serde: this.serde,
@@ -333,78 +333,6 @@ export class Cache {
             }
         });
     }
-    /**
-     * @example
-     * ```ts
-     * import { Cache } from "@daiso-tech/core/cache";
-     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/adapters";
-     * import { KeyPrefixer } from "@daiso-tech/core/utilities";
-     *
-     * const cache = new Cache({
-     *   adapter: new MemoryCacheAdapter(),
-     *   keyPrefixer: new KeyPrefixer("cache")
-     * });
-     *
-     * const value = await cache.getOr("a", 1);
-     *
-     * // Will be 1
-     * console.log(value);
-     * ```
-     *
-     * You can also pass in a function
-     * @example
-     * ```ts
-     * import { Cache } from "@daiso-tech/core/cache";
-     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/adapters";
-     * import { KeyPrefixer } from "@daiso-tech/core/utilities";
-     *
-     * const cache = new Cache({
-     *   adapter: new MemoryCacheAdapter(),
-     *   keyPrefixer: new KeyPrefixer("cache")
-     * });
-     *
-     * const value = await cache.getOr("a", () => 1);
-     *
-     * // Will be 1
-     * console.log(value);
-     * ```
-     *
-     * You can also pass in a async function. This is useful because it allows for retrieval of external data if the key doesnt't.
-     * @example
-     * ```ts
-     * import { Cache } from "@daiso-tech/core/cache";
-     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/adapters";
-     * import { KeyPrefixer } from "@daiso-tech/core/utilities";
-     *
-     * const cache = new Cache({
-     *   adapter: new MemoryCacheAdapter(),
-     *   keyPrefixer: new KeyPrefixer("cache")
-     * });
-     *
-     * const value = await cache.getOr("a", async () => 1);
-     *
-     * // Will be 1
-     * console.log(value);
-     * ```
-     *
-     * You can also pass in a <i>{@link LazyPromise}</i>. This is useful because all other components in this library returns <i>{@link LazyPromise}</i>.
-     * @example
-     * ```ts
-     * import { Cache } from "@daiso-tech/core/cache";
-     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/adapters";
-     * import { KeyPrefixer, LazyPromise } from "@daiso-tech/core/utilities";
-     *
-     * const cache = new Cache({
-     *   adapter: new MemoryCacheAdapter(),
-     *   keyPrefixer: new KeyPrefixer("cache")
-     * });
-     *
-     * const value = await cache.getOr("a", new LazyPromise(async () => 1));
-     *
-     * // Will be 1
-     * console.log(value);
-     * ```
-     */
     getOr(key, defaultValue) {
         return this.createLazyPromise(async () => {
             const value = await this.get(key);
@@ -415,78 +343,6 @@ export class Cache {
             return value;
         });
     }
-    /**
-     * @example
-     * ```ts
-     * import { Cache } from "@daiso-tech/core/cache";
-     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/adapters";
-     * import { KeyPrefixer } from "@daiso-tech/core/utilities";
-     *
-     * const cache = new Cache({
-     *   adapter: new MemoryCacheAdapter(),
-     *   keyPrefixer: new KeyPrefixer("cache")
-     * });
-     *
-     * const value = await cache.getOrAdd("a", 1);
-     *
-     * // Will be 1
-     * console.log(value);
-     * ```
-     *
-     * You can also pass in a function
-     * @example
-     * ```ts
-     * import { Cache } from "@daiso-tech/core/cache";
-     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/adapters";
-     * import { KeyPrefixer } from "@daiso-tech/core/utilities";
-     *
-     * const cache = new Cache({
-     *   adapter: new MemoryCacheAdapter(),
-     *   keyPrefixer: new KeyPrefixer("cache")
-     * });
-     *
-     * const value = await cache.getOrAdd("a", () => 1);
-     *
-     * // Will be 1
-     * console.log(value);
-     * ```
-     *
-     * You can also pass in a async function. This is useful because it allows for retrieval of external data if the key doesnt't.
-     * @example
-     * ```ts
-     * import { Cache } from "@daiso-tech/core/cache";
-     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/adapters";
-     * import { KeyPrefixer } from "@daiso-tech/core/utilities";
-     *
-     * const cache = new Cache({
-     *   adapter: new MemoryCacheAdapter(),
-     *   keyPrefixer: new KeyPrefixer("cache")
-     * });
-     *
-     * const value = await cache.getOrAdd("a", async () => 1);
-     *
-     * // Will be 1
-     * console.log(value);
-     * ```
-     *
-     * You can also pass in a <i>{@link LazyPromise}</i>. This is useful because all other components in this library returns <i>{@link LazyPromise}</i>.
-     * @example
-     * ```ts
-     * import { Cache } from "@daiso-tech/core/cache";
-     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/adapters";
-     * import { KeyPrefixer, LazyPromise } from "@daiso-tech/core/utilities";
-     *
-     * const cache = new Cache({
-     *   adapter: new MemoryCacheAdapter(),
-     *   keyPrefixer: new KeyPrefixer("cache")
-     * });
-     *
-     * const value = await cache.getOrAdd("a", new LazyPromise(async () => 1));
-     *
-     * // Will be 1
-     * console.log(value);
-     * ```
-     */
     getOrAdd(key, valueToAdd, ttl) {
         return this.createLazyPromise(async () => {
             const value = await this.get(key);