@daiso-tech/core 0.37.3 → 0.39.0

package/dist/async/middlewares/retry/retry.middleware.js

@@ -1,18 +1,16 @@
 /**
  * @module Async
  */
-import { callInvokable, } from "../../../utilities/_module-exports.js";
-import { exponentialBackoffPolicy, } from "../../../async/backof-policies/_module.js";
-import { RetryAsyncError } from "../../../async/async.errors.js";
-import { LazyPromise } from "../../../async/utilities/_module.js";
-import { callErrorPolicy, } from "../../../async/middlewares/_shared.js";
+import { callInvokable, optionNone, optionSome, OPTION, UnexpectedError, } from "../../../utilities/_module-exports.js";
+import { exponentialBackoffPolicy } from "../../../async/backof-policies/_module.js";
+import { callErrorPolicyOnThrow, callErrorPolicyOnValue, } from "../../../utilities/_module-exports.js";
+import { LazyPromise } from "../../../async/utilities/lazy-promise/_module.js";
 /**
  * The `retry` middleware enables automatic retries for all errors or specific errors, with configurable backoff policies.
  * An error will be thrown when all retry attempts fail.
  *
  * IMPORT_PATH: `"@daiso-tech/core/async"`
  * @group Middleware
- * @throws {RetryAsyncError} {@link RetryAsyncError}
  *
  * @example
  * ```ts
@@ -22,7 +20,39 @@ import { callErrorPolicy, } from "../../../async/middlewares/_shared.js";
  * const data = await new AsyncHooks(
  *   async (url: string, signal?: AbortSignal): Promise<unknown> => {
  *     const response = await fetch(url, { signal });
- *     return await response.json();
+ *     const json = await response.json();
+ *     if (!response.ok) {
+ *       return json;
+ *     }
+ *     return json;
+ *   },
+ *   [retry()],
+ *   {
+ *     signalBinder: {
+ *       getSignal: (args) => args[1],
+ *       forwardSignal: (args, signal) => {
+ *         args[1] = signal;
+ *       }
+ *     }
+ *   }
+ * )
+ * .invoke("URL");
+ * ```
+ *
+ * The middleware works also when the function returns a {@link Result | `Result`} type.
+ * @example
+ * ```ts
+ * import { retry } from "@daiso-tech/core/async";
+ * import { AsyncHooks, TimeSpan, Result, resultFailure, resultSuccess } from "@daiso-tech/core/utilities";
+ *
+ * const data = await new AsyncHooks(
+ *   async (url: string, signal?: AbortSignal): Promise<Result> => {
+ *     const response = await fetch(url, { signal });
+ *     const json = await response.json();
+ *     if (!response.ok) {
+ *       return resultFailure(json);
+ *     }
+ *     return resultSuccess(json);
  *   },
  *   [retry()],
  *   {
@@ -38,27 +68,48 @@ import { callErrorPolicy, } from "../../../async/middlewares/_shared.js";
  * ```
  */
 export function retry(settings = {}) {
-    const { maxAttempts = 4, backoffPolicy = exponentialBackoffPolicy(), errorPolicy = () => true, onRetryDelay = () => { }, onExecutionAttempt = () => { }, } = settings;
+    const { maxAttempts = 4, backoffPolicy = exponentialBackoffPolicy(), errorPolicy, onRetryDelay = () => { }, onExecutionAttempt = () => { }, } = settings;
     return async (args, next, { context, signal }) => {
-        const errors = [];
+        let result = optionNone();
+        let error_ = optionNone();
         for (let attempt = 1; attempt <= maxAttempts; attempt++) {
             try {
                 callInvokable(onExecutionAttempt, { attempt, args, context });
-                return await next(...args);
+                const value = await next(...args);
+                // Handle retrying if an Result type is returned
+                result = optionSome(value);
+                if (!(await callErrorPolicyOnValue(errorPolicy, value))) {
+                    return value;
+                }
+                // We can cast type here because callErrorPolicyOnValue ensures the value is a ResultFailure
+                const resultFailure = value;
+                if (signal.aborted) {
+                    break;
+                }
+                const waitTime = callInvokable(backoffPolicy, attempt, resultFailure.error);
+                callInvokable(onRetryDelay, {
+                    error: resultFailure.error,
+                    waitTime,
+                    attempt,
+                    args,
+                    context,
+                });
+                await LazyPromise.delay(waitTime, signal);
+                // Handle retrying if an error is thrown
             }
             catch (error) {
                 if (signal.aborted) {
                     break;
                 }
-                if (await callErrorPolicy(errorPolicy, error)) {
-                    errors.push(error);
+                if (await callErrorPolicyOnThrow(errorPolicy, error)) {
+                    error_ = optionSome(error);
                 }
                 else {
                     throw error;
                 }
                 const waitTime = callInvokable(backoffPolicy, attempt, error);
                 callInvokable(onRetryDelay, {
-                    error,
+                    error: error,
                     waitTime,
                     attempt,
                     args,
@@ -67,16 +118,13 @@ export function retry(settings = {}) {
                 await LazyPromise.delay(waitTime, signal);
             }
         }
-        let errorMessage = `Promise was failed after retried ${String(maxAttempts)} times`;
-        const lastError = errors[errors.length - 1];
-        if (lastError) {
-            // eslint-disable-next-line @typescript-eslint/no-base-to-string
-            errorMessage = `${errorMessage} and last thrown error was "${String(lastError)}"`;
+        if (error_.type === OPTION.SOME) {
+            throw error_.value;
+        }
+        if (result.type === OPTION.SOME) {
+            return result.value;
         }
-        throw new RetryAsyncError(errorMessage, {
-            errors,
-            maxAttempts,
-        });
+        throw new UnexpectedError("!!__MESSAGE__!!");
     };
 }
 //# sourceMappingURL=retry.middleware.js.map

package/dist/async/middlewares/retry/retry.middleware.js.map

@@ -1 +1 @@
-{"version":3,"file":"retry.middleware.js","sourceRoot":"","sources":["../../../../src/async/middlewares/retry/retry.middleware.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACH,aAAa,GAIhB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACH,wBAAwB,GAE3B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAEH,eAAe,GAClB,MAAM,gCAAgC,CAAC;AA4GxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,KAAK,CAKjB,WAA0D,EAAE;IAE5D,MAAM,EACF,WAAW,GAAG,CAAC,EACf,aAAa,GAAG,wBAAwB,EAAE,EAC1C,WAAW,GAAG,GAAG,EAAE,CAAC,IAAI,EACxB,YAAY,GAAG,GAAG,EAAE,GAAE,CAAC,EACvB,kBAAkB,GAAG,GAAG,EAAE,GAAE,CAAC,GAChC,GAAG,QAAQ,CAAC;IACb,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE;QAC7C,MAAM,MAAM,GAAc,EAAE,CAAC;QAC7B,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;YACtD,IAAI,CAAC;gBACD,aAAa,CAAC,kBAAkB,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;gBAC9D,OAAO,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;YAC/B,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACtB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBACjB,MAAM;gBACV,CAAC;gBAED,IAAI,MAAM,eAAe,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC;oBAC5C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACvB,CAAC;qBAAM,CAAC;oBACJ,MAAM,KAAK,CAAC;gBAChB,CAAC;gBAED,MAAM,QAAQ,GAAG,aAAa,CAAC,aAAa,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;gBAE9D,aAAa,CAAC,YAAY,EAAE;oBACxB,KAAK;oBACL,QAAQ;oBACR,OAAO;oBACP,IAAI;oBACJ,OAAO;iBACV,CAAC,CAAC;gBACH,MAAM,WAAW,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC9C,CAAC;QACL,CAAC;QAED,IAAI,YAAY,GAAG,oCAAoC,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC;QACnF,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC5C,IAAI,SAAS,EAAE,CAAC;YACZ,gEAAgE;YAChE,YAAY,GAAG,GAAG,YAAY,+BAA+B,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC;QACtF,CAAC;QACD,MAAM,IAAI,eAAe,CAAC,YAAY,EAAE;YACpC,MAAM;YACN,WAAW;SACd,CAAC,CAAC;IACP,CAAC,CAAC;AACN,CAAC"}
+{"version":3,"file":"retry.middleware.js","sourceRoot":"","sources":["../../../../src/async/middlewares/retry/retry.middleware.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAGH,aAAa,EACb,UAAU,EACV,UAAU,EACV,MAAM,EACN,eAAe,GAClB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAE9E,OAAO,EACH,sBAAsB,EACtB,sBAAsB,GACzB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AAExE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,MAAM,UAAU,KAAK,CAKjB,WAAmE,EAAE;IAErE,MAAM,EACF,WAAW,GAAG,CAAC,EACf,aAAa,GAAG,wBAAwB,EAAE,EAC1C,WAAW,EACX,YAAY,GAAG,GAAG,EAAE,GAAE,CAAC,EACvB,kBAAkB,GAAG,GAAG,EAAE,GAAE,CAAC,GAChC,GAAG,QAAQ,CAAC;IACb,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE;QAC7C,IAAI,MAAM,GAAoB,UAAU,EAAE,CAAC;QAC3C,IAAI,MAAM,GAAW,UAAU,EAAE,CAAC;QAClC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;YACtD,IAAI,CAAC;gBACD,aAAa,CAAC,kBAAkB,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;gBAC9D,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;gBAElC,gDAAgD;gBAChD,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;gBAC3B,IAAI,CAAC,CAAC,MAAM,sBAAsB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;oBACtD,OAAO,KAAK,CAAC;gBACjB,CAAC;gBACD,4FAA4F;gBAC5F,MAAM,aAAa,GAAG,KAAsB,CAAC;gBAE7C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBACjB,MAAM;gBACV,CAAC;gBAED,MAAM,QAAQ,GAAG,aAAa,CAC1B,aAAa,EACb,OAAO,EACP,aAAa,CAAC,KAAK,CACtB,CAAC;gBAEF,aAAa,CAAC,YAAY,EAAE;oBACxB,KAAK,EAAE,aAAa,CAAC,KAAK;oBAC1B,QAAQ;oBACR,OAAO;oBACP,IAAI;oBACJ,OAAO;iBACV,CAAC,CAAC;gBACH,MAAM,WAAW,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;gBAE1C,wCAAwC;YAC5C,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACtB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBACjB,MAAM;gBACV,CAAC;gBAED,IAAI,MAAM,sBAAsB,CAAM,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC;oBACxD,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;gBAC/B,CAAC;qBAAM,CAAC;oBACJ,MAAM,KAAK,CAAC;gBAChB,CAAC;gBAED,MAAM,QAAQ,GAAG,aAAa,CAAC,aAAa,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;gBAE9D,aAAa,CAAC,YAAY,EAAE;oBACxB,KAAK,EAAE,KAAK;oBACZ,QAAQ;oBACR,OAAO;oBACP,IAAI;oBACJ,OAAO;iBACV,CAAC,CAAC;gBACH,MAAM,WAAW,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC9C,CAAC;QACL,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC;YAC9B,MAAM,MAAM,CAAC,KAAK,CAAC;QACvB,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC;YAC9B,OAAO,MAAM,CAAC,KAAK,CAAC;QACxB,CAAC;QACD,MAAM,IAAI,eAAe,CAAC,iBAAiB,CAAC,CAAC;IACjD,CAAC,CAAC;AACN,CAAC"}

package/dist/async/middlewares/retry/retry.types.d.ts

@@ -0,0 +1,77 @@
+/**
+ * @module Async
+ */
+import type { InferResultError, TimeSpan } from "../../../utilities/_module-exports.js";
+import { type Invokable, type HookContext } from "../../../utilities/_module-exports.js";
+import { type BackoffPolicy } from "../../../async/backof-policies/_module.js";
+import { type ErrorPolicySettings } from "../../../utilities/_module-exports.js";
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Middlewares
+ */
+export type OnRetryAttemptData<TParameters extends unknown[] = unknown[], TContext extends HookContext = HookContext> = {
+    attempt: number;
+    args: TParameters;
+    context: TContext;
+};
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Middlewares
+ */
+export type OnExecutionAttempt<TParameters extends unknown[] = unknown[], TContext extends HookContext = HookContext> = Invokable<[data: OnRetryAttemptData<TParameters, TContext>]>;
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Middlewares
+ */
+export type OnRetryDelayData<TParameters extends unknown[] = unknown[], TContext extends HookContext = HookContext> = {
+    error: unknown;
+    attempt: number;
+    waitTime: TimeSpan;
+    args: TParameters;
+    context: TContext;
+};
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Middlewares
+ */
+export type OnRetryDelay<TParameters extends unknown[] = unknown[], TContext extends HookContext = HookContext> = Invokable<[data: OnRetryDelayData<TParameters, TContext>]>;
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Middlewares
+ */
+export type RetryCallbacks<TParameters extends unknown[] = unknown[], TContext extends HookContext = HookContext> = {
+    /**
+     * Callback {@link Invokable | `Invokable`} that will be called before execution attempt.
+     */
+    onExecutionAttempt?: OnExecutionAttempt<TParameters, TContext>;
+    /**
+     * Callback {@link Invokable | `Invokable`} that will be called before the retry delay starts.
+     */
+    onRetryDelay?: OnRetryDelay<TParameters, TContext>;
+};
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Middlewares
+ */
+export type RetrySettings<TParameters extends unknown[] = unknown[], TContext extends HookContext = HookContext, TReturn = unknown> = RetryCallbacks<TParameters, TContext> & ErrorPolicySettings<InferResultError<TReturn>> & {
+    /**
+     * You can decide maximal times you can retry.
+     * @default 4
+     */
+    maxAttempts?: number;
+    /**
+     * @default
+     * ```ts
+     * import { exponentialBackoffPolicy } from "@daiso-tech/core/async";
+     *
+     * exponentialBackoffPolicy();
+     * ```
+     */
+    backoffPolicy?: BackoffPolicy;
+};

package/dist/async/middlewares/retry/retry.types.js

@@ -0,0 +1,7 @@
+/**
+ * @module Async
+ */
+import {} from "../../../utilities/_module-exports.js";
+import {} from "../../../async/backof-policies/_module.js";
+import {} from "../../../utilities/_module-exports.js";
+//# sourceMappingURL=retry.types.js.map

package/dist/async/middlewares/retry/retry.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.types.js","sourceRoot":"","sources":["../../../../src/async/middlewares/retry/retry.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAGN,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAsB,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAA4B,MAAM,gCAAgC,CAAC"}

package/dist/async/middlewares/timeout/_module.d.ts

@@ -1 +1,2 @@
 export * from "../../../async/middlewares/timeout/timeout.middleware.js";
+export * from "../../../async/middlewares/timeout/timeout.type.js";

package/dist/async/middlewares/timeout/_module.js

@@ -1,2 +1,3 @@
 export * from "../../../async/middlewares/timeout/timeout.middleware.js";
+export * from "../../../async/middlewares/timeout/timeout.type.js";
 //# sourceMappingURL=_module.js.map

package/dist/async/middlewares/timeout/_module.js.map

@@ -1 +1 @@
-{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../../src/async/middlewares/timeout/_module.ts"],"names":[],"mappings":"AAAA,cAAc,mDAAmD,CAAC"}
+{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../../src/async/middlewares/timeout/_module.ts"],"names":[],"mappings":"AAAA,cAAc,mDAAmD,CAAC;AAClE,cAAc,6CAA6C,CAAC"}

package/dist/async/middlewares/timeout/timeout.middleware.d.ts

@@ -1,54 +1,8 @@
 /**
  * @module Async
  */
-import { TimeSpan } from "../../../utilities/_module-exports.js";
 import { type AsyncMiddlewareFn, type HookContext } from "../../../utilities/_module-exports.js";
-import { type Invokable } from "../../../utilities/_module-exports.js";
-/**
- *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group Middlewares
- */
-export type OnTimeoutData<TParameters extends unknown[] = unknown[], TContext extends HookContext = HookContext> = {
-    waitTime: TimeSpan;
-    args: TParameters;
-    context: TContext;
-};
-/**
- *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group Middlewares
- */
-export type OnTimeout<TParameters extends unknown[] = unknown[], TContext extends HookContext = HookContext> = Invokable<[data: OnTimeoutData<TParameters, TContext>]>;
-/**
- *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group Middlewares
- */
-export type TimeoutCallbacks<TParameters extends unknown[] = unknown[], TContext extends HookContext = HookContext> = {
-    /**
-     * Callback {@link Invokable | `Invokable`} that will be called before the timeout occurs.
-     */
-    onTimeout?: OnTimeout<TParameters, TContext>;
-};
-/**
- *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group Middlewares
- */
-export type TimeoutSettings<TParameters extends unknown[] = unknown[], TContext extends HookContext = HookContext> = TimeoutCallbacks<TParameters, TContext> & {
-    /**
-     * The maximum time to wait before automatically aborting the executing function.
-     *
-     * @default
-     * ```ts
-     * import { TimeSpan } from "@daiso-tech/core/utilities";
-     *
-     * TimeSpan.fromSeconds(2)
-     * ```
-     */
-    waitTime?: TimeSpan;
-};
+import type { TimeoutSettings } from "../../../async/middlewares/timeout/timeout.type.js";
 /**
  * The `timeout` middleware automatically cancels functions after a specified time period, throwing an error when aborted.
  *

package/dist/async/middlewares/timeout/timeout.middleware.js

@@ -5,7 +5,7 @@ import { TimeSpan } from "../../../utilities/_module-exports.js";
 import {} from "../../../utilities/_module-exports.js";
 import { callInvokable } from "../../../utilities/_module-exports.js";
 import { TimeoutAsyncError } from "../../../async/async.errors.js";
-import { timeoutAndFail } from "../../../async/utilities/_module.js";
+import { timeoutAndFail } from "../../../async/utilities/timeout-and-fail/_module.js";
 /**
  * The `timeout` middleware automatically cancels functions after a specified time period, throwing an error when aborted.
  *

package/dist/async/middlewares/timeout/timeout.middleware.js.map

@@ -1 +1 @@
-{"version":3,"file":"timeout.middleware.js","sourceRoot":"","sources":["../../../../src/async/middlewares/timeout/timeout.middleware.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC1D,OAAO,EAON,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,aAAa,EAAkB,MAAM,gCAAgC,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AA+D9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,UAAU,OAAO,CAKnB,WAA4D,EAAE;IAE9D,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,SAAS,GAAG,GAAG,EAAE,GAAE,CAAC,EAAE,GAC9D,QAAQ,CAAC;IACb,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE;QACpD,IAAI,CAAC;YACD,OAAO,MAAM,cAAc,CACvB,IAAI,CAAC,GAAG,IAAI,CAAC,EACb,QAAQ,EACR,CAAC,KAAc,EAAE,EAAE;gBACf,KAAK,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC,EACD,MAAM,CACT,CAAC;QACN,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACtB,IAAI,KAAK,YAAY,iBAAiB,EAAE,CAAC;gBACrC,aAAa,CAAC,SAAS,EAAE;oBACrB,IAAI;oBACJ,OAAO;oBACP,QAAQ;iBACX,CAAC,CAAC;YACP,CAAC;YACD,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC,CAAC;AACN,CAAC"}
+{"version":3,"file":"timeout.middleware.js","sourceRoot":"","sources":["../../../../src/async/middlewares/timeout/timeout.middleware.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC1D,OAAO,EAON,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,+CAA+C,CAAC;AAG/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,UAAU,OAAO,CAKnB,WAA4D,EAAE;IAE9D,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,SAAS,GAAG,GAAG,EAAE,GAAE,CAAC,EAAE,GAC9D,QAAQ,CAAC;IACb,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE;QACpD,IAAI,CAAC;YACD,OAAO,MAAM,cAAc,CACvB,IAAI,CAAC,GAAG,IAAI,CAAC,EACb,QAAQ,EACR,CAAC,KAAc,EAAE,EAAE;gBACf,KAAK,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC,EACD,MAAM,CACT,CAAC;QACN,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACtB,IAAI,KAAK,YAAY,iBAAiB,EAAE,CAAC;gBACrC,aAAa,CAAC,SAAS,EAAE;oBACrB,IAAI;oBACJ,OAAO;oBACP,QAAQ;iBACX,CAAC,CAAC;YACP,CAAC;YACD,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC,CAAC;AACN,CAAC"}

package/dist/async/middlewares/timeout/timeout.type.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @module Async
+ */
+import type { TimeSpan } from "../../../utilities/_module-exports.js";
+import { type HookContext } from "../../../utilities/_module-exports.js";
+import { type Invokable } from "../../../utilities/_module-exports.js";
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Middlewares
+ */
+export type OnTimeoutData<TParameters extends unknown[] = unknown[], TContext extends HookContext = HookContext> = {
+    waitTime: TimeSpan;
+    args: TParameters;
+    context: TContext;
+};
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Middlewares
+ */
+export type OnTimeout<TParameters extends unknown[] = unknown[], TContext extends HookContext = HookContext> = Invokable<[data: OnTimeoutData<TParameters, TContext>]>;
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Middlewares
+ */
+export type TimeoutCallbacks<TParameters extends unknown[] = unknown[], TContext extends HookContext = HookContext> = {
+    /**
+     * Callback {@link Invokable | `Invokable`} that will be called before the timeout occurs.
+     */
+    onTimeout?: OnTimeout<TParameters, TContext>;
+};
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Middlewares
+ */
+export type TimeoutSettings<TParameters extends unknown[] = unknown[], TContext extends HookContext = HookContext> = TimeoutCallbacks<TParameters, TContext> & {
+    /**
+     * The maximum time to wait before automatically aborting the executing function.
+     *
+     * @default
+     * ```ts
+     * import { TimeSpan } from "@daiso-tech/core/utilities";
+     *
+     * TimeSpan.fromSeconds(2)
+     * ```
+     */
+    waitTime?: TimeSpan;
+};

package/dist/async/middlewares/timeout/timeout.type.js

@@ -0,0 +1,6 @@
+/**
+ * @module Async
+ */
+import {} from "../../../utilities/_module-exports.js";
+import {} from "../../../utilities/_module-exports.js";
+//# sourceMappingURL=timeout.type.js.map

package/dist/async/middlewares/timeout/timeout.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.type.js","sourceRoot":"","sources":["../../../../src/async/middlewares/timeout/timeout.type.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAoB,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAkB,MAAM,gCAAgC,CAAC"}

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

@@ -2,7 +2,7 @@
  * @module Async
  */
 import {} from "../../../utilities/_module-exports.js";
-import { LazyPromise } from "../../../async/utilities/_module.js";
+import { LazyPromise } from "../../../async/utilities/lazy-promise/_module.js";
 import { v4 } from "uuid";
 import { CapacityFullAsyncError } from "../../../async/async.errors.js";
 /**
@@ -54,14 +54,23 @@ export class PromiseQueue {
         const listener = this.listeners.get(item.id);
         try {
             if (item.signal.aborted) {
-                listener?.([null, item.signal.reason]);
+                listener?.({
+                    type: "failure",
+                    error: item.signal.reason,
+                });
                 return;
             }
             const value = await item.func(item.signal);
-            listener?.([value, null]);
+            listener?.({
+                type: "success",
+                value,
+            });
         }
         catch (error) {
-            listener?.([null, error]);
+            listener?.({
+                type: "failure",
+                error,
+            });
             throw error;
         }
     }
@@ -87,13 +96,15 @@ export class PromiseQueue {
     }
     asPromise(id) {
         return new Promise((resolve, reject) => {
-            this.listenOnce(id, ([value, error]) => {
-                if (value === null) {
+            this.listenOnce(id, (result) => {
+                if (result.type === "failure") {
                     // eslint-disable-next-line @typescript-eslint/prefer-promise-reject-errors
-                    reject(error);
+                    reject(result.error);
                     return;
                 }
-                resolve(value);
+                else {
+                    resolve(result.value);
+                }
             });
         });
     }

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

@@ -1 +1 @@
-{"version":3,"file":"promise-queue.js","sourceRoot":"","sources":["../../../../src/async/utilities/promise-queue/promise-queue.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"promise-queue.js","sourceRoot":"","sources":["../../../../src/async/utilities/promise-queue/promise-queue.ts"],"names":[],"mappings":"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"}

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

@@ -92,7 +92,7 @@ export type ICacheBase<TType = unknown> = {
      *
      * @param ttl - If null is passed, the item will not expire.
      *
-     * @returns true when key doesn't exists otherwise false will be returned.
+     * @returns Returns true when key doesn't exists otherwise false will be returned.
      */
     add(key: OneOrMore<string>, value: TType, ttl?: TimeSpan | null): LazyPromise<boolean>;
     /**
@@ -105,7 +105,7 @@ export type ICacheBase<TType = unknown> = {
      *
      * @param ttl - If null is passed, the item will not expire.
      *
-     * @returns true if the `key` where replaced otherwise false is returned.
+     * @returns Returns true if the `key` where replaced otherwise false is returned.
      */
     put(key: OneOrMore<string>, value: TType, ttl?: TimeSpan | null): LazyPromise<boolean>;
     /**
@@ -115,7 +115,7 @@ export type ICacheBase<TType = unknown> = {
      * If it's an `Iterable`, it will be joined into a single string.
      * Think of an `Iterable` as representing a path.
      *
-     * @returns true if the `key` where updated otherwise false will be returned.
+     * @returns Returns true if the `key` where updated otherwise false will be returned.
      */
     update(key: OneOrMore<string>, value: TType): LazyPromise<boolean>;
     /**
@@ -128,7 +128,7 @@ export type ICacheBase<TType = unknown> = {
      *
      * @param value - If not defined then it will be defaulted to 1.
      *
-     * @returns true if the `key` where incremented otherwise false will be returned.
+     * @returns Returns true if the `key` where incremented otherwise false will be returned.
      *
      * @throws {TypeCacheError} {@link TypeCacheError}
      */
@@ -143,7 +143,7 @@ export type ICacheBase<TType = unknown> = {
      *
      * @param value - If not defined then it will be defaulted to 1.
      *
-     * @returns true if the `key` where decremented otherwise false will be returned.
+     * @returns Returns true if the `key` where decremented otherwise false will be returned.
      *
      * @throws {TypeCacheError} {@link TypeCacheError}
      */
@@ -155,7 +155,7 @@ export type ICacheBase<TType = unknown> = {
      * If it's an `Iterable`, it will be joined into a single string.
      * Think of an `Iterable` as representing a path.
      *
-     * @returns true if the key is found otherwise false is returned.
+     * @returns Returns true if the key is found otherwise false is returned.
      */
     remove(key: OneOrMore<string>): LazyPromise<boolean>;
     /**
@@ -165,7 +165,7 @@ export type ICacheBase<TType = unknown> = {
      * If the param items are an `Iterable`, it will be joined into a single string.
      * Think of an `Iterable` as representing a path.
      *
-     * @returns true if one of the keys where deleted otherwise false is returned.
+     * @returns Returns true if one of the keys where deleted otherwise false is returned.
      */
     removeMany(keys: Iterable<OneOrMore<string>>): LazyPromise<boolean>;
     /**

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

@@ -1,25 +1,12 @@
 /**
  * @module Cache
  */
-import type { ISerderRegister, ISerializable } from "../../serde/contracts/_module-exports.js";
-import { type ISerializedError, type OneOrMore } from "../../utilities/_module-exports.js";
 /**
  *
  * IMPORT_PATH: `"@daiso-tech/core/cache/contracts"`
  * @group Errors
  */
-export declare class CacheError extends Error implements ISerializable<ISerializedError> {
-    static deserialize(deserializedValue: ISerializedError): CacheError;
-    constructor(message: string, cause?: unknown);
-    serialize(): ISerializedError;
-}
-/**
- *
- * IMPORT_PATH: `"@daiso-tech/core/cache/contracts"`
- * @group Errors
- */
-export declare class UnexpectedCacheError extends CacheError implements ISerializable<ISerializedError> {
-    static deserialize(deserializedValue: ISerializedError): CacheError;
+export declare class CacheError extends Error {
     constructor(message: string, cause?: unknown);
 }
 /**
@@ -28,8 +15,7 @@ export declare class UnexpectedCacheError extends CacheError implements ISeriali
  * IMPORT_PATH: `"@daiso-tech/core/cache/contracts"`
  * @group Errors
  */
-export declare class TypeCacheError extends CacheError implements ISerializable<ISerializedError> {
-    static deserialize(deserializedValue: ISerializedError): CacheError;
+export declare class TypeCacheError extends CacheError {
     constructor(message: string, cause?: unknown);
 }
 /**
@@ -38,8 +24,7 @@ export declare class TypeCacheError extends CacheError implements ISerializable<
  * IMPORT_PATH: `"@daiso-tech/core/cache/contracts"`
  * @group Errors
  */
-export declare class KeyNotFoundCacheError extends CacheError implements ISerializable<ISerializedError> {
-    static deserialize(deserializedValue: ISerializedError): CacheError;
+export declare class KeyNotFoundCacheError extends CacheError {
     constructor(message: string, cause?: unknown);
 }
 /**
@@ -49,14 +34,6 @@ export declare class KeyNotFoundCacheError extends CacheError implements ISerial
  */
 export declare const CACHE_ERRORS: {
     readonly Base: typeof CacheError;
-    readonly Unexpected: typeof UnexpectedCacheError;
     readonly Type: typeof TypeCacheError;
     readonly KeyNotFound: typeof KeyNotFoundCacheError;
 };
-/**
- * The `registerCacheErrorsToSerde` function registers all {@link ICache | `ICache`} related errors with `ISerderRegister`, ensuring they will properly be serialized and deserialized.
- *
- * IMPORT_PATH: `"@daiso-tech/core/cache/contracts"`
- * @group Errors
- */
-export declare function registerCacheErrorsToSerde(serde: OneOrMore<ISerderRegister>): void;