@daiso-tech/core 0.34.0 → 0.35.0

package/README.md

@@ -28,6 +28,8 @@ A modular, framework-agnostic library providing essential components for modern
             -   `exponentialBackoffPolicy`
             -   `linearBackoffPolicy`
             -   `polynomialBackoffPolicy`
+        -   `sequentialHedging`: Runs fallbacks sequentially if the primary function fails, ensuring graceful failure handling.
+        -   `concurrentHedging`: Executes the primary function alongside fallbacks concurrently, returning the first successful result and aborting all remaining operations.
         -   `timeout`: Guaranteed execution time limits
 -   **LazyPromise**:
     -   Executes only when awaited
@@ -46,10 +48,6 @@ A modular, framework-agnostic library providing essential components for modern
 -   SharedLock (ReaderWriterLock)
 -   RateLimiter
 -   CircuitBreaker
--   Heding middleware with multiple strategies:
-    -   fallback strategy
-    -   parallel strategy
-    -   latency strategy
 -   MessageQueue
 -   TaskScheduler
 -   Notification system

package/dist/async/_module-exports.d.ts

@@ -2,4 +2,3 @@ export * from "../async/backof-policies/_module.js";
 export * from "../async/middlewares/_module.js";
 export * from "../async/utilities/_module.js";
 export * from "../async/async.errors.js";
-export * from "../async/async.events.js";

package/dist/async/_module-exports.js

@@ -2,5 +2,4 @@ export * from "../async/backof-policies/_module.js";
 export * from "../async/middlewares/_module.js";
 export * from "../async/utilities/_module.js";
 export * from "../async/async.errors.js";
-export * from "../async/async.events.js";
 //# sourceMappingURL=_module-exports.js.map

package/dist/async/_module-exports.js.map

@@ -1 +1 @@
-{"version":3,"file":"_module-exports.js","sourceRoot":"","sources":["../../src/async/_module-exports.ts"],"names":[],"mappings":"AAAA,cAAc,oCAAoC,CAAC;AACnD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"_module-exports.js","sourceRoot":"","sources":["../../src/async/_module-exports.ts"],"names":[],"mappings":"AAAA,cAAc,oCAAoC,CAAC;AACnD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC"}

package/dist/async/async.errors.d.ts

@@ -10,16 +10,6 @@ export declare class AsyncError extends Error {
     constructor(message: string, cause?: unknown);
 }
 /**
- * This error is thrown when the is aborted.
- *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group Errors
- */
-export declare class AbortAsyncError extends AsyncError {
-    constructor(message: string, cause?: unknown);
-}
-/**
- * This error is thrown when the has exceeded the given time limit.
  *
  * IMPORT_PATH: `"@daiso-tech/core/async"`
  * @group Errors
@@ -37,7 +27,6 @@ export type RetryAsyncErrorData = {
     maxAttempts: number;
 };
 /**
- * This error is thrown when the has failed all retry attempts.
  *
  * IMPORT_PATH: `"@daiso-tech/core/async"`
  * @group Errors
@@ -47,6 +36,23 @@ export declare class RetryAsyncError extends AsyncError {
     readonly errors: unknown[];
     constructor(message: string, { errors, maxAttempts }: RetryAsyncErrorData);
 }
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Errors
+ */
+export declare class HedgingAsyncError extends AsyncError {
+    readonly errors: unknown[];
+    constructor(message: string, errors: unknown[]);
+}
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Errors
+ */
+export declare class CapacityFullAsyncError extends AsyncError {
+    constructor(message: string, cause?: unknown);
+}
 /**
  *
  * IMPORT_PATH: `"@daiso-tech/core/async"`
@@ -54,7 +60,8 @@ export declare class RetryAsyncError extends AsyncError {
  */
 export declare const ASYNC_ERRORS: {
     readonly Base: typeof AsyncError;
-    readonly Abort: typeof AbortAsyncError;
     readonly Timeout: typeof TimeoutAsyncError;
     readonly Retry: typeof RetryAsyncError;
+    readonly Hedging: typeof HedgingAsyncError;
+    readonly CapacityFull: typeof CapacityFullAsyncError;
 };

package/dist/async/async.errors.js

@@ -13,19 +13,6 @@ export class AsyncError extends Error {
     }
 }
 /**
- * This error is thrown when the is aborted.
- *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group Errors
- */
-export class AbortAsyncError extends AsyncError {
-    constructor(message, cause) {
-        super(message, cause);
-        this.name = AbortAsyncError.name;
-    }
-}
-/**
- * This error is thrown when the has exceeded the given time limit.
  *
  * IMPORT_PATH: `"@daiso-tech/core/async"`
  * @group Errors
@@ -37,7 +24,6 @@ export class TimeoutAsyncError extends AsyncError {
     }
 }
 /**
- * This error is thrown when the has failed all retry attempts.
  *
  * IMPORT_PATH: `"@daiso-tech/core/async"`
  * @group Errors
@@ -46,12 +32,36 @@ export class RetryAsyncError extends AsyncError {
     maxAttempts;
     errors = [];
     constructor(message, { errors, maxAttempts }) {
-        super(message, errors[errors.length - 1]);
+        super(message, errors);
         this.errors = errors;
         this.maxAttempts = maxAttempts;
         this.name = RetryAsyncError.name;
     }
 }
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Errors
+ */
+export class HedgingAsyncError extends AsyncError {
+    errors;
+    constructor(message, errors) {
+        super(message, errors);
+        this.errors = errors;
+        this.name = HedgingAsyncError.name;
+    }
+}
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Errors
+ */
+export class CapacityFullAsyncError extends AsyncError {
+    constructor(message, cause) {
+        super(message, cause);
+        this.name = CapacityFullAsyncError.name;
+    }
+}
 /**
  *
  * IMPORT_PATH: `"@daiso-tech/core/async"`
@@ -59,8 +69,9 @@ export class RetryAsyncError extends AsyncError {
  */
 export const ASYNC_ERRORS = {
     Base: AsyncError,
-    Abort: AbortAsyncError,
     Timeout: TimeoutAsyncError,
     Retry: RetryAsyncError,
+    Hedging: HedgingAsyncError,
+    CapacityFull: CapacityFullAsyncError,
 };
 //# sourceMappingURL=async.errors.js.map

package/dist/async/async.errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"async.errors.js","sourceRoot":"","sources":["../../src/async/async.errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,MAAM,OAAO,UAAW,SAAQ,KAAK;IACjC,YAAY,OAAe,EAAE,KAAe;QACxC,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;IAChC,CAAC;CACJ;AAED;;;;;GAKG;AACH,MAAM,OAAO,eAAgB,SAAQ,UAAU;IAC3C,YAAY,OAAe,EAAE,KAAe;QACxC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC;IACrC,CAAC;CACJ;AAED;;;;;GAKG;AACH,MAAM,OAAO,iBAAkB,SAAQ,UAAU;IAC7C,YAAY,OAAe,EAAE,KAAe;QACxC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC;IACvC,CAAC;CACJ;AAYD;;;;;GAKG;AACH,MAAM,OAAO,eAAgB,SAAQ,UAAU;IAC3B,WAAW,CAAS;IAEpB,MAAM,GAAc,EAAE,CAAC;IAEvC,YAAY,OAAe,EAAE,EAAE,MAAM,EAAE,WAAW,EAAuB;QACrE,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC;IACrC,CAAC;CACJ;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IACxB,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,eAAe;IACtB,OAAO,EAAE,iBAAiB;IAC1B,KAAK,EAAE,eAAe;CAChB,CAAC"}
+{"version":3,"file":"async.errors.js","sourceRoot":"","sources":["../../src/async/async.errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,MAAM,OAAO,UAAW,SAAQ,KAAK;IACjC,YAAY,OAAe,EAAE,KAAe;QACxC,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;IAChC,CAAC;CACJ;AAED;;;;GAIG;AACH,MAAM,OAAO,iBAAkB,SAAQ,UAAU;IAC7C,YAAY,OAAe,EAAE,KAAe;QACxC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC;IACvC,CAAC;CACJ;AAYD;;;;GAIG;AACH,MAAM,OAAO,eAAgB,SAAQ,UAAU;IAC3B,WAAW,CAAS;IAEpB,MAAM,GAAc,EAAE,CAAC;IAEvC,YAAY,OAAe,EAAE,EAAE,MAAM,EAAE,WAAW,EAAuB;QACrE,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC;IACrC,CAAC;CACJ;AAED;;;;GAIG;AACH,MAAM,OAAO,iBAAkB,SAAQ,UAAU;IAGzB;IAFpB,YACI,OAAe,EACC,MAAiB;QAEjC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAFP,WAAM,GAAN,MAAM,CAAW;QAGjC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC;IACvC,CAAC;CACJ;AAED;;;;GAIG;AACH,MAAM,OAAO,sBAAuB,SAAQ,UAAU;IAClD,YAAY,OAAe,EAAE,KAAe;QACxC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC,IAAI,CAAC;IAC5C,CAAC;CACJ;AACD;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IACxB,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,iBAAiB;IAC1B,KAAK,EAAE,eAAe;IACtB,OAAO,EAAE,iBAAiB;IAC1B,YAAY,EAAE,sBAAsB;CAC9B,CAAC"}

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

@@ -1,5 +1,8 @@
+export * from "../../async/middlewares/bulkhead/_module.js";
 export * from "../../async/middlewares/dynamic/_module.js";
 export * from "../../async/middlewares/fallback/_module.js";
+export * from "../../async/middlewares/hedging/_module.js";
 export * from "../../async/middlewares/observe/_module.js";
 export * from "../../async/middlewares/retry/_module.js";
 export * from "../../async/middlewares/timeout/_module.js";
+export * from "../../async/middlewares/_shared.js";

package/dist/async/middlewares/_module.js

@@ -1,6 +1,9 @@
+export * from "../../async/middlewares/bulkhead/_module.js";
 export * from "../../async/middlewares/dynamic/_module.js";
 export * from "../../async/middlewares/fallback/_module.js";
+export * from "../../async/middlewares/hedging/_module.js";
 export * from "../../async/middlewares/observe/_module.js";
 export * from "../../async/middlewares/retry/_module.js";
 export * from "../../async/middlewares/timeout/_module.js";
+export * from "../../async/middlewares/_shared.js";
 //# sourceMappingURL=_module.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../src/async/middlewares/_module.ts"],"names":[],"mappings":"AAAA,cAAc,wCAAwC,CAAC;AACvD,cAAc,yCAAyC,CAAC;AACxD,cAAc,wCAAwC,CAAC;AACvD,cAAc,sCAAsC,CAAC;AACrD,cAAc,wCAAwC,CAAC"}
+{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../src/async/middlewares/_module.ts"],"names":[],"mappings":"AAAA,cAAc,yCAAyC,CAAC;AACxD,cAAc,wCAAwC,CAAC;AACvD,cAAc,yCAAyC,CAAC;AACxD,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC;AACvD,cAAc,sCAAsC,CAAC;AACrD,cAAc,wCAAwC,CAAC;AACvD,cAAc,gCAAgC,CAAC"}

package/dist/async/middlewares/_shared.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @module Async
+ */
+import { type Invokable } from "../../utilities/_module-exports.js";
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Middleware
+ */
+export type ErrorPolicy = Invokable<[error: unknown], boolean>;

package/dist/async/middlewares/_shared.js

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

package/dist/async/middlewares/_shared.js.map

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

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

@@ -0,0 +1 @@
+export * from "../../../async/middlewares/bulkhead/bulkhead.middleware.js";

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

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

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

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

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

@@ -0,0 +1,80 @@
+/**
+ * @module Async
+ */
+import { TimeSpan, type AsyncMiddlewareFn, type HookContext, type Invokable } from "../../../utilities/_module-exports.js";
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Middleware
+ */
+export type OnProcessingData<TParameters extends unknown[] = unknown[], TContext extends HookContext = HookContext> = {
+    args: TParameters;
+    context: TContext;
+};
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Middleware
+ */
+export type OnProcessing<TParameters extends unknown[] = unknown[], TContext extends HookContext = HookContext> = Invokable<[data: OnProcessingData<TParameters, TContext>]>;
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Middleware
+ */
+export type BulkheadCallbacks<TParameters extends unknown[] = unknown[], TContext extends HookContext = HookContext> = {
+    onProcessing?: OnProcessing<TParameters, TContext>;
+};
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Middleware
+ */
+export type BulkheadSettings<TParameters extends unknown[] = unknown[], TContext extends HookContext = HookContext> = BulkheadCallbacks<TParameters, TContext> & {
+    /**
+     * The maximum number of promises allowed to run concurrently. If this limit is exceeded, additional promises will be queued until a slot becomes available.
+     *
+     * @default {25}
+     */
+    maxConcurrency?: number;
+    /**
+     * The maximum capacity of the promise queue. If null, the queue can grow indefinitely.
+     * If a number is provided and the queue exceeds this limit, an error will be thrown, and no further promises will be enqueued.
+     *
+     * @default {null}
+     */
+    maxCapacity?: number | null;
+    /**
+     * @default
+     * ```ts
+     * import { TimeSpan } from "@daiso-tech/core/utilities";
+     *
+     * TimeSpan.fromMilliseconds(0)
+     * ```
+     */
+    interval?: TimeSpan;
+};
+/**
+ * The `bulkhead` middlewares ensures that a given amount of {@link Promiselike | `PromiseLike`} objects run at the same time concurrently and the rest will be queued up.
+ * You can provide {@link BulkheadSettings | `settings.maxCapacity`}
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Middleware
+ * @throws {CapacityFullAsyncError} {@link CapacityFullAsyncError}
+ * ```ts
+ * import { bulkhead } from "@daiso-tech/core/async";
+ * import { AsyncHooks } from "@daiso-tech/core/utilities";
+ *
+ * const fetchData = new AsyncHooks(async (url: string): Promise<unknown> => {
+ *   const response = await fetch(url);
+ *   const json = await response.json();
+ *   return json;
+ * }, [
+ *   bulkhead()
+ * ]);
+ *
+ * // Will run only 25 promises concurrently by default.
+ * await Promise.all(Array(50).fill("").map(() => fetchData.invoke("URL")));
+ * ```
+ */
+export declare function bulkhead<TParameters extends unknown[], TReturn, TContext extends HookContext>(settings?: BulkheadSettings<TParameters, TContext>): AsyncMiddlewareFn<TParameters, TReturn, TContext>;

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

@@ -0,0 +1,46 @@
+/**
+ * @module Async
+ */
+import { callInvokable, TimeSpan, } from "../../../utilities/_module-exports.js";
+import { PromiseQueue } from "../../../async/utilities/_module.js";
+/**
+ * The `bulkhead` middlewares ensures that a given amount of {@link Promiselike | `PromiseLike`} objects run at the same time concurrently and the rest will be queued up.
+ * You can provide {@link BulkheadSettings | `settings.maxCapacity`}
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Middleware
+ * @throws {CapacityFullAsyncError} {@link CapacityFullAsyncError}
+ * ```ts
+ * import { bulkhead } from "@daiso-tech/core/async";
+ * import { AsyncHooks } from "@daiso-tech/core/utilities";
+ *
+ * const fetchData = new AsyncHooks(async (url: string): Promise<unknown> => {
+ *   const response = await fetch(url);
+ *   const json = await response.json();
+ *   return json;
+ * }, [
+ *   bulkhead()
+ * ]);
+ *
+ * // Will run only 25 promises concurrently by default.
+ * await Promise.all(Array(50).fill("").map(() => fetchData.invoke("URL")));
+ * ```
+ */
+export function bulkhead(settings = {}) {
+    const { maxConcurrency = 25, maxCapacity = null, interval = TimeSpan.fromMilliseconds(0), onProcessing = () => { }, } = settings;
+    const promiseQueue = new PromiseQueue({
+        maxCapacity,
+        maxConcurrency,
+        interval,
+    });
+    return async (args, next, { context, signal }) => {
+        return await promiseQueue.add(() => {
+            callInvokable(onProcessing, {
+                args,
+                context,
+            });
+            return next(...args);
+        }, signal);
+    };
+}
+//# sourceMappingURL=bulkhead.middleware.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bulkhead.middleware.js","sourceRoot":"","sources":["../../../../src/async/middlewares/bulkhead/bulkhead.middleware.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACH,aAAa,EACb,QAAQ,GAIX,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAwE5D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,QAAQ,CAKpB,WAAoD,EAAE;IAEtD,MAAM,EACF,cAAc,GAAG,EAAE,EACnB,WAAW,GAAG,IAAI,EAClB,QAAQ,GAAG,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,EACvC,YAAY,GAAG,GAAG,EAAE,GAAE,CAAC,GAC1B,GAAG,QAAQ,CAAC;IACb,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC;QAClC,WAAW;QACX,cAAc;QACd,QAAQ;KACX,CAAC,CAAC;IACH,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE;QAC7C,OAAO,MAAM,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE;YAC/B,aAAa,CAAC,YAAY,EAAE;gBACxB,IAAI;gBACJ,OAAO;aACV,CAAC,CAAC;YACH,OAAO,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QACzB,CAAC,EAAE,MAAM,CAAC,CAAC;IACf,CAAC,CAAC;AACN,CAAC"}

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

@@ -11,8 +11,8 @@ import { type AsyncMiddlewareFn, type Invokable } from "../../../utilities/_modu
  *
  * @example
  * ```ts
- * import { AsyncHooks } from "@daiso-tech/core/async";
- * import { dynamic, fallback } from "@daiso-tech/core/utilities";
+ * import { dynamic, fallback  } from "@daiso-tech/core/async";
+ * import { AsyncHooks } from "@daiso-tech/core/utilities";
  *
  * await new AsyncHooks(
  *   (a: number, b: number) => a / b,

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

@@ -10,8 +10,8 @@ import { callInvokable, } from "../../../utilities/_module-exports.js";
  *
  * @example
  * ```ts
- * import { AsyncHooks } from "@daiso-tech/core/async";
- * import { dynamic, fallback } from "@daiso-tech/core/utilities";
+ * import { dynamic, fallback  } from "@daiso-tech/core/async";
+ * import { AsyncHooks } from "@daiso-tech/core/utilities";
  *
  * await new AsyncHooks(
  *   (a: number, b: number) => a / b,
@@ -28,9 +28,9 @@ import { callInvokable, } from "../../../utilities/_module-exports.js";
  * ```
  */
 export function dynamic(dynamic) {
-    return (args, next, context) => {
-        const middleware = callInvokable(dynamic, args, context);
-        return callInvokable(middleware, args, next, context);
+    return (args, next, settings) => {
+        const middleware = callInvokable(dynamic, args, settings.context);
+        return callInvokable(middleware, args, next, settings);
     };
 }
 //# sourceMappingURL=dynamic.middleware.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"dynamic.middleware.js","sourceRoot":"","sources":["../../../../src/async/middlewares/dynamic/dynamic.middleware.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EACH,aAAa,GAGhB,MAAM,gCAAgC,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,OAAO,CAKnB,OAKC;IAED,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;QAC3B,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QACzD,OAAO,aAAa,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC,CAAC;AACN,CAAC"}
+{"version":3,"file":"dynamic.middleware.js","sourceRoot":"","sources":["../../../../src/async/middlewares/dynamic/dynamic.middleware.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EACH,aAAa,GAGhB,MAAM,gCAAgC,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,OAAO,CAKnB,OAKC;IAED,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QAC5B,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;QAClE,OAAO,aAAa,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC3D,CAAC,CAAC;AACN,CAAC"}

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

@@ -3,6 +3,7 @@
  */
 import type { HookContext, AsyncLazyable } from "../../../utilities/_module-exports.js";
 import { type AsyncMiddlewareFn, type Invokable } from "../../../utilities/_module-exports.js";
+import type { ErrorPolicy } from "../../../async/middlewares/_shared.js";
 /**
  *
  * IMPORT_PATH: `"@daiso-tech/core/async"`
@@ -25,27 +26,28 @@ export type OnFallback<TParameters extends unknown[] = unknown[], TFallbackValue
  * IMPORT_PATH: `"@daiso-tech/core/async"`
  * @group Middleware
  */
-export type FallbackPolicy = Invokable<[error: unknown], boolean>;
+export type FallbackCallbacks<TParameters extends unknown[] = unknown[], TReturn = unknown, TContext extends HookContext = HookContext> = {
+    /**
+     * Callback function that will be called before fallback values is returned.
+     */
+    onFallback?: OnFallback<TParameters, TReturn, TContext>;
+};
 /**
  *
  * IMPORT_PATH: `"@daiso-tech/core/async"`
  * @group Middleware
  */
-export type FallbackSettings<TParameters extends unknown[] = unknown[], TReturn = unknown, TContext extends HookContext = HookContext> = {
+export type FallbackSettings<TParameters extends unknown[] = unknown[], TReturn = unknown, TContext extends HookContext = HookContext> = FallbackCallbacks<TParameters, TReturn, TContext> & {
     fallbackValue: AsyncLazyable<TReturn>;
     /**
      * You can choose what errors you want to add fallback value. By default fallback value will be added to all errors.
      *
      * @default
      * ```ts
-     * () => true
+     * (_error: unknown) => true
      * ```
      */
-    fallbackPolicy?: FallbackPolicy;
-    /**
-     * Callback function that will be called before fallback values is returned.
-     */
-    onFallback?: OnFallback<TParameters, TReturn, TContext>;
+    fallbackPolicy?: ErrorPolicy;
 };
 /**
  * The `fallback` middleware adds fallback value when an error occurs.

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

@@ -30,7 +30,7 @@ import { callInvokable, resolveAsyncLazyable, } from "../../../utilities/_module
  */
 export function fallback(settings) {
     const { fallbackValue, fallbackPolicy = () => true, onFallback = () => { }, } = settings;
-    return async (args, next, context) => {
+    return async (args, next, { context }) => {
         try {
             return await next(...args);
         }

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

@@ -1 +1 @@
-{"version":3,"file":"fallback.middleware.js","sourceRoot":"","sources":["../../../../src/async/middlewares/fallback/fallback.middleware.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,EACH,aAAa,EACb,oBAAoB,GAGvB,MAAM,gCAAgC,CAAC;AAgExC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,QAAQ,CAKpB,QAAmE;IAEnE,MAAM,EACF,aAAa,EACb,cAAc,GAAG,GAAG,EAAE,CAAC,IAAI,EAC3B,UAAU,GAAG,GAAG,EAAE,GAAE,CAAC,GACxB,GAAG,QAAQ,CAAC;IACb,OAAO,KAAK,EACR,IAAiB,EACjB,IAAyC,EACzC,OAAiB,EACD,EAAE;QAClB,IAAI,CAAC;YACD,OAAO,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACtB,IAAI,aAAa,CAAC,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC;gBACvC,MAAM,qBAAqB,GACvB,MAAM,oBAAoB,CAAC,aAAa,CAAC,CAAC;gBAC9C,aAAa,CAAC,UAAU,EAAE;oBACtB,KAAK;oBACL,aAAa,EAAE,qBAAqB;oBACpC,IAAI;oBACJ,OAAO;iBACV,CAAC,CAAC;gBACH,OAAO,qBAAqB,CAAC;YACjC,CAAC;YACD,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC,CAAC;AACN,CAAC"}
+{"version":3,"file":"fallback.middleware.js","sourceRoot":"","sources":["../../../../src/async/middlewares/fallback/fallback.middleware.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EACH,aAAa,EACb,oBAAoB,GAGvB,MAAM,gCAAgC,CAAC;AAqExC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,QAAQ,CAKpB,QAAmE;IAEnE,MAAM,EACF,aAAa,EACb,cAAc,GAAG,GAAG,EAAE,CAAC,IAAI,EAC3B,UAAU,GAAG,GAAG,EAAE,GAAE,CAAC,GACxB,GAAG,QAAQ,CAAC;IACb,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,EAAoB,EAAE;QACvD,IAAI,CAAC;YACD,OAAO,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACtB,IAAI,aAAa,CAAC,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC;gBACvC,MAAM,qBAAqB,GACvB,MAAM,oBAAoB,CAAC,aAAa,CAAC,CAAC;gBAC9C,aAAa,CAAC,UAAU,EAAE;oBACtB,KAAK;oBACL,aAAa,EAAE,qBAAqB;oBACpC,IAAI;oBACJ,OAAO;iBACV,CAAC,CAAC;gBACH,OAAO,qBAAqB,CAAC;YACjC,CAAC;YACD,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC,CAAC;AACN,CAAC"}

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

@@ -0,0 +1,2 @@
+export * from "../../../async/middlewares/hedging/concurrent-hedging/_module.js";
+export * from "../../../async/middlewares/hedging/sequential-hedging/_module.js";

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

@@ -0,0 +1,3 @@
+export * from "../../../async/middlewares/hedging/concurrent-hedging/_module.js";
+export * from "../../../async/middlewares/hedging/sequential-hedging/_module.js";
+//# sourceMappingURL=_module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../../src/async/middlewares/hedging/_module.ts"],"names":[],"mappings":"AAAA,cAAc,2DAA2D,CAAC;AAC1E,cAAc,2DAA2D,CAAC"}

package/dist/async/middlewares/hedging/_shared.d.ts

@@ -0,0 +1,93 @@
+/**
+ * @module Async
+ */
+import type { TimeSpan } from "../../../utilities/_module-exports.js";
+import { type HookContext, type Invokable, type OneOrMore, type Promisable } from "../../../utilities/_module-exports.js";
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Middlewares
+ */
+export type OnHedgeAttemptData<TParameters extends unknown[] = unknown[], TContext extends HookContext = HookContext> = {
+    name: string;
+    args: TParameters;
+    context: TContext;
+};
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Middlewares
+ */
+export type OnHedgeAttempt<TParameters extends unknown[] = unknown[], TContext extends HookContext = HookContext> = Invokable<[data: OnHedgeAttemptData<TParameters, TContext>]>;
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Middlewares
+ */
+export type OnHedgeErrorData<TParameters extends unknown[] = unknown[], TContext extends HookContext = HookContext> = {
+    name: string;
+    error: unknown;
+    args: TParameters;
+    context: TContext;
+};
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Middlewares
+ */
+export type OnHedgeError<TParameters extends unknown[] = unknown[], TContext extends HookContext = HookContext> = Invokable<[data: OnHedgeErrorData<TParameters, TContext>]>;
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Middlewares
+ */
+export type HedgingCallbacks<TParameters extends unknown[] = unknown[], TContext extends HookContext = HookContext> = {
+    /**
+     * Callback function that will be called before execution attempt.
+     */
+    onHedgeAttempt?: OnHedgeAttempt<TParameters, TContext>;
+    /**
+     * Callback function that will be called when the error occurs.
+     */
+    onHedgeError?: OnHedgeError<TParameters, TContext>;
+};
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Middlewares
+ */
+export type Fallback<TParameters extends unknown[] = unknown[], TReturn = unknown> = Invokable<TParameters, Promisable<TReturn>>;
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Middlewares
+ */
+export type NamedFallback<TParameters extends unknown[] = unknown[], TReturn = unknown> = {
+    /**
+     * You can assign a custom name to the fallback function for easier identification in logs.
+     */
+    name: string;
+    func: Fallback<TParameters, TReturn>;
+};
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Middlewares
+ */
+export type HedgingSettings<TParameters extends unknown[] = unknown[], TReturn = unknown, TContext extends HookContext = HookContext> = HedgingCallbacks<TParameters, TContext> & {
+    /**
+     * The maximum time to wait before automatically aborting the executing primary function or fallback functions.
+     *
+     * @default
+     * ```ts
+     * import { TimeSpan } from "@daiso-tech/core/utilities";
+     *
+     * TimeSpan.fromSeconds(2)
+     * ```
+     */
+    waitTime?: TimeSpan;
+    /**
+     * The fallback functions that run in case the primary function fails.
+     */
+    fallbacks: OneOrMore<Fallback<TParameters, TReturn> | NamedFallback<TParameters, TReturn>>;
+};

package/dist/async/middlewares/hedging/_shared.js

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

package/dist/async/middlewares/hedging/_shared.js.map

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

package/dist/async/middlewares/hedging/concurrent-hedging/_module.d.ts

@@ -0,0 +1 @@
+export * from "../../../../async/middlewares/hedging/concurrent-hedging/_module.js";

package/dist/async/middlewares/hedging/concurrent-hedging/_module.js

@@ -0,0 +1,2 @@
+export * from "../../../../async/middlewares/hedging/concurrent-hedging/_module.js";
+//# sourceMappingURL=_module.js.map

package/dist/async/middlewares/hedging/concurrent-hedging/_module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../../../src/async/middlewares/hedging/concurrent-hedging/_module.ts"],"names":[],"mappings":"AAAA,cAAc,2DAA2D,CAAC"}