@daiso-tech/core 0.34.0 → 0.35.0

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

@@ -3,35 +3,43 @@
  */
 import { callInvokable, TimeSpan, } from "../../../utilities/_module-exports.js";
 import { exponentialBackoffPolicy, } from "../../../async/backof-policies/_module.js";
-import { AbortAsyncError, RetryAsyncError } from "../../../async/async.errors.js";
+import { RetryAsyncError } from "../../../async/async.errors.js";
 import { LazyPromise } from "../../../async/utilities/_module.js";
+import {} from "../../../async/middlewares/_shared.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 {AbortAsyncError} {@link AbortAsyncError}
+ * @throws {RetryAsyncError} {@link RetryAsyncError}
  *
  * @example
  * ```ts
  * import { retry } from "@daiso-tech/core/async";
- * import { AsyncHooks } from "@daiso-tech/core/utilities";
+ * import { AsyncHooks, TimeSpan } from "@daiso-tech/core/utilities";
  *
- * await new AsyncHooks(async (url: string) => {
- *   const response = await fetch(url);
- *   const json = await response.json();
- *   if (!response.ok) {
- *     throw json
+ * const data = await new AsyncHooks(
+ *   async (url: string, signal?: AbortSignal): Promise<unknown> => {
+ *     const response = await fetch(url, { signal });
+ *     return await response.json();
+ *   },
+ *   [retry()],
+ *   {
+ *     signalBinder: {
+ *       getSignal: (args) => args[1],
+ *       forwardSignal: (args, signal) => {
+ *         args[1] = signal;
+ *       }
+ *     }
  *   }
- *   return json;
- * }, retry({ maxAttempts: 8 })).invoke("URL_ENDPOINT");
+ * )
+ * .invoke("URL");
  * ```
  */
 export function retry(settings = {}) {
-    const { maxAttempts = 4, backoffPolicy = exponentialBackoffPolicy(), retryPolicy = () => true, onRetryStart = () => { }, onRetryEnd = () => { }, onExecutionAttempt = () => { }, } = settings;
-    return async (args, next, context) => {
+    const { maxAttempts = 4, backoffPolicy = exponentialBackoffPolicy(), retryPolicy = () => true, onRetryDelay = () => { }, onExecutionAttempt = () => { }, } = settings;
+    return async (args, next, { context, signal }) => {
         const errors = [];
         for (let attempt = 1; attempt <= maxAttempts; attempt++) {
             try {
@@ -39,29 +47,24 @@ export function retry(settings = {}) {
                 return await next(...args);
             }
             catch (error) {
-                const time = TimeSpan.fromMilliseconds(callInvokable(backoffPolicy, attempt, error));
-                callInvokable(onRetryStart, {
+                if (signal.aborted) {
+                    break;
+                }
+                const waitTime = TimeSpan.fromMilliseconds(callInvokable(backoffPolicy, attempt, error));
+                callInvokable(onRetryDelay, {
                     error,
-                    waitTime: time,
+                    waitTime,
                     attempt,
                     args,
                     context,
                 });
-                errors.push(error);
-                if (error instanceof AbortAsyncError) {
-                    throw error;
+                if (callInvokable(retryPolicy, error)) {
+                    errors.push(error);
                 }
-                if (!callInvokable(retryPolicy, error, attempt)) {
+                else {
                     throw error;
                 }
-                await LazyPromise.delay(time);
-                callInvokable(onRetryEnd, {
-                    error,
-                    waitTime: time,
-                    attempt,
-                    args,
-                    context,
-                });
+                await LazyPromise.delay(waitTime, signal);
             }
         }
         let errorMessage = `Promise was failed after retried ${String(maxAttempts)} times`;

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;AAEH,OAAO,EACH,aAAa,EACb,QAAQ,GAIX,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACH,wBAAwB,GAE3B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AA8G3D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;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,UAAU,GAAG,GAAG,EAAE,GAAE,CAAC,EACrB,kBAAkB,GAAG,GAAG,EAAE,GAAE,CAAC,GAChC,GAAG,QAAQ,CAAC;IACb,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;QACjC,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,MAAM,IAAI,GAAG,QAAQ,CAAC,gBAAgB,CAClC,aAAa,CAAC,aAAa,EAAE,OAAO,EAAE,KAAK,CAAC,CAC/C,CAAC;gBACF,aAAa,CAAC,YAAY,EAAE;oBACxB,KAAK;oBACL,QAAQ,EAAE,IAAI;oBACd,OAAO;oBACP,IAAI;oBACJ,OAAO;iBACV,CAAC,CAAC;gBAEH,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACnB,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;oBACnC,MAAM,KAAK,CAAC;gBAChB,CAAC;gBACD,IAAI,CAAC,aAAa,CAAC,WAAW,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC;oBAC9C,MAAM,KAAK,CAAC;gBAChB,CAAC;gBACD,MAAM,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAE9B,aAAa,CAAC,UAAU,EAAE;oBACtB,KAAK;oBACL,QAAQ,EAAE,IAAI;oBACd,OAAO;oBACP,IAAI;oBACJ,OAAO;iBACV,CAAC,CAAC;YACP,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;AAEH,OAAO,EACH,aAAa,EACb,QAAQ,GAIX,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,EAAoB,MAAM,gCAAgC,CAAC;AA4GlE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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;gBACD,MAAM,QAAQ,GAAG,QAAQ,CAAC,gBAAgB,CACtC,aAAa,CAAC,aAAa,EAAE,OAAO,EAAE,KAAK,CAAC,CAC/C,CAAC;gBACF,aAAa,CAAC,YAAY,EAAE;oBACxB,KAAK;oBACL,QAAQ;oBACR,OAAO;oBACP,IAAI;oBACJ,OAAO;iBACV,CAAC,CAAC;gBAEH,IAAI,aAAa,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC;oBACpC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACvB,CAAC;qBAAM,CAAC;oBACJ,MAAM,KAAK,CAAC;gBAChB,CAAC;gBACD,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"}

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

@@ -1,7 +1,7 @@
 /**
  * @module Async
  */
-import type { TimeSpan } from "../../../utilities/_module-exports.js";
+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";
 /**
@@ -10,7 +10,7 @@ import { type Invokable } from "../../../utilities/_module-exports.js";
  * @group Middleware
  */
 export type OnTimeoutData<TParameters extends unknown[] = unknown[], TContext extends HookContext = HookContext> = {
-    maxTime: TimeSpan;
+    waitTime: TimeSpan;
     args: TParameters;
     context: TContext;
 };
@@ -25,19 +25,29 @@ export type OnTimeout<TParameters extends unknown[] = unknown[], TContext extend
  * IMPORT_PATH: `"@daiso-tech/core/async"`
  * @group Middleware
  */
-export type AbortSignalBinder<TParameters extends unknown[] = unknown[]> = Invokable<[arguments_: TParameters, signal: AbortSignal], TParameters>;
+export type TimeoutCallbacks<TParameters extends unknown[] = unknown[], TContext extends HookContext = HookContext> = {
+    /**
+     * Callback function that will be called when the timeout occurs.
+     */
+    onTimeout?: OnTimeout<TParameters, TContext>;
+};
 /**
  *
  * IMPORT_PATH: `"@daiso-tech/core/async"`
  * @group Middleware
  */
-export type TimeoutSettings<TParameters extends unknown[] = unknown[], TContext extends HookContext = HookContext> = {
-    time: TimeSpan;
-    signalBinder?: AbortSignalBinder<TParameters>;
+export type TimeoutSettings<TParameters extends unknown[] = unknown[], TContext extends HookContext = HookContext> = TimeoutCallbacks<TParameters, TContext> & {
     /**
-     * Callback function that will be called when the timeout occurs.
+     * The maximum time to wait before automatically aborting the executing function.
+     *
+     * @default
+     * ```ts
+     * import { TimeSpan } from "@daiso-tech/core/utilities";
+     *
+     * TimeSpan.fromSeconds(2)
+     * ```
      */
-    onTimeout?: OnTimeout<TParameters, TContext>;
+    waitTime?: TimeSpan;
 };
 /**
  * The `timeout` middleware automatically cancels functions after a specified time period, throwing an error when aborted.
@@ -45,7 +55,6 @@ export type TimeoutSettings<TParameters extends unknown[] = unknown[], TContext
  *
  * IMPORT_PATH: `"@daiso-tech/core/async"`
  * @group Middleware
- *
  * @throws {TimeoutAsyncError} {@link TimeoutAsyncError}
  *
  * @example
@@ -53,36 +62,22 @@ export type TimeoutSettings<TParameters extends unknown[] = unknown[], TContext
  * import { timeout } from "@daiso-tech/core/async";
  * import { AsyncHooks, TimeSpan } from "@daiso-tech/core/utilities";
  *
- * const abortController = new AbortController();
- *
- * const promise = new AsyncHooks(async (url: string, signal?: AbortSignal): Promise<unknown> => {
- *   const response = await fetch(url, {
- *     signal
- *   });
- *   const json = await response.json();
- *   if (!response.ok) {
- *     throw json
+ * const data = await new AsyncHooks(
+ *   async (url: string, signal?: AbortSignal): Promise<unknown> => {
+ *     const response = await fetch(url, { signal });
+ *     return await response.json();
+ *   },
+ *   [timeout({ waitTime: TimeSpan.fromSeconds(2) })],
+ *   {
+ *     signalBinder: {
+ *       getSignal: (args) => args[1],
+ *       forwardSignal: (args, signal) => {
+ *         args[1] = signal;
+ *       }
+ *     }
  *   }
- *   return json;
- * }, timeout({
- *   time: TimeSpan.fromSeconds(2),
- *   // With the defined signalBinder the HTTP request will be arboted when timed out or when the inputed `AbortSignal` is called.
- *   signalBinder: ([url, fetchSignal], timeoutSignal) => {
- *     return [
- *       url,
- *       AbortSignal.any([
- *         fetchSignal,
- *         timeoutSignal
- *       ].filter(signal => signal !== undefined))
- *     ] as const;
- *   }
- * }))
- * .invoke("ENDPOINT", abortController.signal);
- *
- * abortController.abort();
- *
- * // An error will be thrown.
- * await promise;
+ * )
+ * .invoke("URL");
  * ```
  */
-export declare function timeout<TParameters extends unknown[], TReturn, TContext extends HookContext>(settings: NoInfer<TimeoutSettings<TParameters, TContext>>): AsyncMiddlewareFn<TParameters, TReturn, TContext>;
+export declare function timeout<TParameters extends unknown[], TReturn, TContext extends HookContext>(settings?: NoInfer<TimeoutSettings<TParameters, TContext>>): AsyncMiddlewareFn<TParameters, TReturn, TContext>;

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

@@ -1,17 +1,17 @@
 /**
  * @module Async
  */
+import { TimeSpan } from "../../../utilities/_module-exports.js";
 import {} from "../../../utilities/_module-exports.js";
 import { callInvokable } from "../../../utilities/_module-exports.js";
-import { AbortAsyncError, TimeoutAsyncError } from "../../../async/async.errors.js";
-import { abortAndFail } from "../../../async/utilities/_module.js";
+import { TimeoutAsyncError } from "../../../async/async.errors.js";
+import { timeoutAndFail } from "../../../async/utilities/_module.js";
 /**
  * The `timeout` middleware automatically cancels functions after a specified time period, throwing an error when aborted.
  * Note the original function continues executing (even if the promise fails), you'll need to provide a settings.signalBinder to forward the `AbortSignal`.
  *
  * IMPORT_PATH: `"@daiso-tech/core/async"`
  * @group Middleware
- *
  * @throws {TimeoutAsyncError} {@link TimeoutAsyncError}
  *
  * @example
@@ -19,59 +19,42 @@ import { abortAndFail } from "../../../async/utilities/_module.js";
  * import { timeout } from "@daiso-tech/core/async";
  * import { AsyncHooks, TimeSpan } from "@daiso-tech/core/utilities";
  *
- * const abortController = new AbortController();
- *
- * const promise = new AsyncHooks(async (url: string, signal?: AbortSignal): Promise<unknown> => {
- *   const response = await fetch(url, {
- *     signal
- *   });
- *   const json = await response.json();
- *   if (!response.ok) {
- *     throw json
- *   }
- *   return json;
- * }, timeout({
- *   time: TimeSpan.fromSeconds(2),
- *   // With the defined signalBinder the HTTP request will be arboted when timed out or when the inputed `AbortSignal` is called.
- *   signalBinder: ([url, fetchSignal], timeoutSignal) => {
- *     return [
- *       url,
- *       AbortSignal.any([
- *         fetchSignal,
- *         timeoutSignal
- *       ].filter(signal => signal !== undefined))
- *     ] as const;
+ * const data = await new AsyncHooks(
+ *   async (url: string, signal?: AbortSignal): Promise<unknown> => {
+ *     const response = await fetch(url, { signal });
+ *     return await response.json();
+ *   },
+ *   [timeout({ waitTime: TimeSpan.fromSeconds(2) })],
+ *   {
+ *     signalBinder: {
+ *       getSignal: (args) => args[1],
+ *       forwardSignal: (args, signal) => {
+ *         args[1] = signal;
+ *       }
+ *     }
  *   }
- * }))
- * .invoke("ENDPOINT", abortController.signal);
- *
- * abortController.abort();
- *
- * // An error will be thrown.
- * await promise;
+ * )
+ * .invoke("URL");
  * ```
  */
-export function timeout(settings) {
-    const { time, signalBinder = (args) => args, onTimeout = () => { }, } = settings;
-    return async (args, next, context) => {
-        const timeoutController = new AbortController();
-        const timeoutId = setTimeout(() => {
-            timeoutController.abort(new TimeoutAsyncError("The promise exceded time"));
-        }, time.toMilliseconds());
+export function timeout(settings = {}) {
+    const { waitTime = TimeSpan.fromSeconds(2), onTimeout = () => { } } = settings;
+    return async (args, next, { context, abort, signal }) => {
         try {
-            return await abortAndFail(next(...callInvokable(signalBinder, args, timeoutController.signal)), timeoutController.signal);
+            return await timeoutAndFail(next(...args), waitTime, (error) => {
+                abort(error);
+            }, signal);
         }
         catch (error) {
-            if (error instanceof AbortAsyncError &&
-                error.cause instanceof TimeoutAsyncError) {
-                callInvokable(onTimeout, { maxTime: time, args, context });
-                throw error.cause;
+            if (error instanceof TimeoutAsyncError) {
+                callInvokable(onTimeout, {
+                    args,
+                    context,
+                    waitTime,
+                });
             }
             throw error;
         }
-        finally {
-            clearTimeout(timeoutId);
-        }
     };
 }
 //# sourceMappingURL=timeout.middleware.js.map

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;AAGH,OAAO,EAGN,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,aAAa,EAAkB,MAAM,gCAAgC,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAqD5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,MAAM,UAAU,OAAO,CAKnB,QAAyD;IAEzD,MAAM,EACF,IAAI,EACJ,YAAY,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAC7B,SAAS,GAAG,GAAG,EAAE,GAAE,CAAC,GACvB,GAAG,QAAQ,CAAC;IACb,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;QACjC,MAAM,iBAAiB,GAAG,IAAI,eAAe,EAAE,CAAC;QAChD,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAC9B,iBAAiB,CAAC,KAAK,CACnB,IAAI,iBAAiB,CAAC,0BAA0B,CAAC,CACpD,CAAC;QACN,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC;YACD,OAAO,MAAM,YAAY,CACrB,IAAI,CACA,GAAG,aAAa,CACZ,YAAY,EACZ,IAAI,EACJ,iBAAiB,CAAC,MAAM,CAC3B,CACJ,EACD,iBAAiB,CAAC,MAAM,CAC3B,CAAC;QACN,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACtB,IACI,KAAK,YAAY,eAAe;gBAChC,KAAK,CAAC,KAAK,YAAY,iBAAiB,EAC1C,CAAC;gBACC,aAAa,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;gBAC3D,MAAM,KAAK,CAAC,KAAK,CAAC;YACtB,CAAC;YACD,MAAM,KAAK,CAAC;QAChB,CAAC;gBAAS,CAAC;YACP,YAAY,CAAC,SAAS,CAAC,CAAC;QAC5B,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,EAGN,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;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/utilities/_module.d.ts

@@ -1,2 +1,4 @@
 export * from "../../async/utilities/abort-and-fail/_module.js";
 export * from "../../async/utilities/lazy-promise/_module.js";
+export * from "../../async/utilities/promise-queue/_module.js";
+export * from "../../async/utilities/timeout-and-fail/_module.js";

package/dist/async/utilities/_module.js

@@ -1,3 +1,5 @@
 export * from "../../async/utilities/abort-and-fail/_module.js";
 export * from "../../async/utilities/lazy-promise/_module.js";
+export * from "../../async/utilities/promise-queue/_module.js";
+export * from "../../async/utilities/timeout-and-fail/_module.js";
 //# sourceMappingURL=_module.js.map

package/dist/async/utilities/_module.js.map

@@ -1 +1 @@
-{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../src/async/utilities/_module.ts"],"names":[],"mappings":"AAAA,cAAc,6CAA6C,CAAC;AAC5D,cAAc,2CAA2C,CAAC"}
+{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../src/async/utilities/_module.ts"],"names":[],"mappings":"AAAA,cAAc,6CAA6C,CAAC;AAC5D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,4CAA4C,CAAC;AAC3D,cAAc,+CAA+C,CAAC"}

package/dist/async/utilities/abort-and-fail/abort-and-fail.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Async
+ */
 /**
  * @internal
  */

package/dist/async/utilities/abort-and-fail/abort-and-fail.js

@@ -1,21 +1,21 @@
 /**
  * @module Async
  */
-import { AbortAsyncError } from "../../../async/async.errors.js";
 /**
  * @internal
  */
-function abortSignalToPromise(abortSignal, createError) {
+function abortSignalToPromise(abortSignal) {
     let reject_ = null;
     function abort() {
         if (reject_ === null) {
             return;
         }
-        reject_(createError(abortSignal.reason));
+        reject_(abortSignal.reason);
     }
     if (abortSignal.aborted) {
         return {
-            promise: Promise.reject(createError(abortSignal.reason)),
+            // eslint-disable-next-line @typescript-eslint/prefer-promise-reject-errors
+            promise: Promise.reject(abortSignal.reason),
             abort,
         };
     }
@@ -37,11 +37,10 @@ function abortSignalToPromise(abortSignal, createError) {
  * @internal
  */
 export async function abortAndFail(promise, abortSignal) {
-    const createError = (reason) => new AbortAsyncError(`Promise was aborted with reason of "${String(reason)}"`, reason);
     if (abortSignal.aborted) {
-        throw createError(abortSignal.reason);
+        throw abortSignal.reason;
     }
-    const { promise: abortSignalPromise, abort } = abortSignalToPromise(abortSignal, createError);
+    const { promise: abortSignalPromise, abort } = abortSignalToPromise(abortSignal);
     try {
         return await Promise.race([promise, abortSignalPromise]);
     }

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

@@ -1 +1 @@
-{"version":3,"file":"abort-and-fail.js","sourceRoot":"","sources":["../../../../src/async/utilities/abort-and-fail/abort-and-fail.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D;;GAEG;AACH,SAAS,oBAAoB,CACzB,WAAwB,EACxB,WAAiD;IAKjD,IAAI,OAAO,GAAsC,IAAI,CAAC;IACtD,SAAS,KAAK;QACV,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACnB,OAAO;QACX,CAAC;QACD,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;QACtB,OAAO;YACH,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YACxD,KAAK;SACR,CAAC;IACN,CAAC;IAED,OAAO;QACH,OAAO,EAAE,IAAI,OAAO,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;YACtC,OAAO,GAAG,MAAM,CAAC;YACjB,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;gBACtB,KAAK,EAAE,CAAC;gBACR,OAAO;YACX,CAAC;YACD,WAAW,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE;gBACzC,IAAI,EAAE,IAAI;aACb,CAAC,CAAC;QACP,CAAC,CAAC;QACF,KAAK;KACR,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAC9B,OAA4B,EAC5B,WAAwB;IAExB,MAAM,WAAW,GAAG,CAAC,MAAe,EAAE,EAAE,CACpC,IAAI,eAAe,CACf,uCAAuC,MAAM,CAAC,MAAM,CAAC,GAAG,EACxD,MAAM,CACT,CAAC;IACN,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;QACtB,MAAM,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,EAAE,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,GAAG,oBAAoB,CAC/D,WAAW,EACX,WAAW,CACd,CAAC;IACF,IAAI,CAAC;QACD,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAC7D,CAAC;YAAS,CAAC;QACP,WAAW,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACpD,CAAC;AACL,CAAC"}
+{"version":3,"file":"abort-and-fail.js","sourceRoot":"","sources":["../../../../src/async/utilities/abort-and-fail/abort-and-fail.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,SAAS,oBAAoB,CACzB,WAAwB;IAKxB,IAAI,OAAO,GAAsC,IAAI,CAAC;IACtD,SAAS,KAAK;QACV,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACnB,OAAO;QACX,CAAC;QACD,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;QACtB,OAAO;YACH,2EAA2E;YAC3E,OAAO,EAAE,OAAO,CAAC,MAAM,CAAS,WAAW,CAAC,MAAM,CAAC;YACnD,KAAK;SACR,CAAC;IACN,CAAC;IAED,OAAO;QACH,OAAO,EAAE,IAAI,OAAO,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;YACtC,OAAO,GAAG,MAAM,CAAC;YACjB,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;gBACtB,KAAK,EAAE,CAAC;gBACR,OAAO;YACX,CAAC;YACD,WAAW,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE;gBACzC,IAAI,EAAE,IAAI;aACb,CAAC,CAAC;QACP,CAAC,CAAC;QACF,KAAK;KACR,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAC9B,OAA4B,EAC5B,WAAwB;IAExB,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;QACtB,MAAM,WAAW,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED,MAAM,EAAE,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,GACxC,oBAAoB,CAAS,WAAW,CAAC,CAAC;IAC9C,IAAI,CAAC;QACD,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAC7D,CAAC;YAAS,CAAC;QACP,WAAW,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACpD,CAAC;AACL,CAAC"}

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

@@ -51,7 +51,6 @@ export class LazyPromise {
                 }), abortSignal);
             }
             finally {
-                // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
                 if (timeoutId !== null) {
                     clearTimeout(timeoutId);
                 }

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

package/dist/async/utilities/promise-queue/_module.d.ts

@@ -0,0 +1 @@
+export * from "../../../async/utilities/promise-queue/promise-queue.js";

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

@@ -0,0 +1,2 @@
+export * from "../../../async/utilities/promise-queue/promise-queue.js";
+//# sourceMappingURL=_module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../../src/async/utilities/promise-queue/_module.ts"],"names":[],"mappings":"AAAA,cAAc,kDAAkD,CAAC"}

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

@@ -0,0 +1,32 @@
+/**
+ * @module Async
+ */
+import type { TimeSpan } from "../../../utilities/_module-exports.js";
+import { type InvokableFn, type Promisable } from "../../../utilities/_module-exports.js";
+/**
+ * @internal
+ */
+export type PromiseQueueSettings = {
+    maxConcurrency: number;
+    maxCapacity: number | null;
+    interval: TimeSpan;
+};
+/**
+ * @internal
+ */
+export declare class PromiseQueue {
+    private readonly settings;
+    private readonly queue;
+    private readonly listeners;
+    constructor(settings: PromiseQueueSettings);
+    private start;
+    private getItems;
+    private process;
+    private enqueue;
+    private listenOnce;
+    private asPromise;
+    /**
+     * @throws {CapacityFullAsyncError} {@link CapacityFullAsyncError}
+     */
+    add<TValue>(func: InvokableFn<[signal: AbortSignal], Promisable<TValue>>, signal: AbortSignal): Promise<TValue>;
+}

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

@@ -0,0 +1,107 @@
+/**
+ * @module Async
+ */
+import {} from "../../../utilities/_module-exports.js";
+import { LazyPromise } from "../../../async/utilities/_module.js";
+import { v4 } from "uuid";
+import { CapacityFullAsyncError } from "../../../async/async.errors.js";
+/**
+ * @internal
+ */
+class Queue {
+    array = [];
+    size() {
+        return this.array.length;
+    }
+    enqueue(value) {
+        this.array.push(value);
+    }
+    dequeue() {
+        return this.array.shift() ?? null;
+    }
+}
+/**
+ * @internal
+ */
+export class PromiseQueue {
+    settings;
+    queue = new Queue();
+    listeners = new Map();
+    constructor(settings) {
+        this.settings = settings;
+        // eslint-disable-next-line @typescript-eslint/no-floating-promises
+        this.start();
+    }
+    async start() {
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition, no-constant-condition
+        while (true) {
+            await Promise.all(this.getItems().map((item) => this.process(item)));
+            await LazyPromise.delay(this.settings.interval);
+        }
+    }
+    getItems() {
+        const values = [];
+        for (let i = 0; i < this.settings.maxConcurrency; i++) {
+            const item = this.queue.dequeue();
+            if (item === null) {
+                continue;
+            }
+            values.push(item);
+        }
+        return values;
+    }
+    async process(item) {
+        const listener = this.listeners.get(item.id);
+        try {
+            if (item.signal.aborted) {
+                listener?.([null, item.signal.reason]);
+                return;
+            }
+            const value = await item.func(item.signal);
+            listener?.([value, null]);
+        }
+        catch (error) {
+            listener?.([null, error]);
+            throw error;
+        }
+    }
+    enqueue(func, signal) {
+        const id = v4();
+        if (this.settings.maxCapacity === null) {
+            this.queue.enqueue({
+                id,
+                func,
+                signal,
+            });
+        }
+        else if (this.queue.size() <= this.settings.maxCapacity) {
+            this.queue.enqueue({ id, func, signal });
+        }
+        else {
+            throw new CapacityFullAsyncError(`Max capacity reached, ${String(this.settings.maxCapacity)} items allowed.`);
+        }
+        return id;
+    }
+    listenOnce(id, listener) {
+        this.listeners.set(id, listener);
+    }
+    asPromise(id) {
+        return new Promise((resolve, reject) => {
+            this.listenOnce(id, ([value, error]) => {
+                if (value === null) {
+                    // eslint-disable-next-line @typescript-eslint/prefer-promise-reject-errors
+                    reject(error);
+                    return;
+                }
+                resolve(value);
+            });
+        });
+    }
+    /**
+     * @throws {CapacityFullAsyncError} {@link CapacityFullAsyncError}
+     */
+    add(func, signal) {
+        return this.asPromise(this.enqueue(func, signal));
+    }
+}
+//# sourceMappingURL=promise-queue.js.map

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

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

package/dist/async/utilities/timeout-and-fail/_module.d.ts

@@ -0,0 +1 @@
+export * from "../../../async/utilities/timeout-and-fail/timeout-and-fail.js";

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

@@ -0,0 +1,2 @@
+export * from "../../../async/utilities/timeout-and-fail/timeout-and-fail.js";
+//# sourceMappingURL=_module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../../src/async/utilities/timeout-and-fail/_module.ts"],"names":[],"mappings":"AAAA,cAAc,wDAAwD,CAAC"}

package/dist/async/utilities/timeout-and-fail/timeout-and-fail.d.ts

@@ -0,0 +1,7 @@
+import type { TimeSpan } from "../../../utilities/_module-exports.js";
+/**
+ * @throws {TimeoutAsyncError} {@link TimeoutAsyncError}
+ *
+ * @internal
+ */
+export declare function timeoutAndFail<TValue>(promise: PromiseLike<TValue>, time: TimeSpan, abort: (rejection: unknown) => void, signal: AbortSignal): Promise<TValue>;

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

@@ -0,0 +1,19 @@
+import { TimeoutAsyncError } from "../../../async/async.errors.js";
+import { abortAndFail } from "../../../async/utilities/abort-and-fail/_module.js";
+/**
+ * @throws {TimeoutAsyncError} {@link TimeoutAsyncError}
+ *
+ * @internal
+ */
+export async function timeoutAndFail(promise, time, abort, signal) {
+    const timeoutId = setTimeout(() => {
+        abort(new TimeoutAsyncError("The promise exceded time"));
+    }, time.toMilliseconds());
+    try {
+        return await abortAndFail(promise, signal);
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+}
+//# sourceMappingURL=timeout-and-fail.js.map