@daiso-tech/core 0.37.2 → 0.38.0

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

@@ -1,4 +1,4 @@
 export * from "../async/backof-policies/_module.js";
 export * from "../async/middlewares/_module.js";
-export * from "../async/utilities/_module.js";
+export * from "../async/utilities/lazy-promise/_module.js";
 export * from "../async/async.errors.js";

package/dist/async/_module-exports.js

@@ -1,5 +1,5 @@
 export * from "../async/backof-policies/_module.js";
 export * from "../async/middlewares/_module.js";
-export * from "../async/utilities/_module.js";
+export * from "../async/utilities/lazy-promise/_module.js";
 export * from "../async/async.errors.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"}
+{"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,2CAA2C,CAAC;AAC1D,cAAc,yBAAyB,CAAC"}

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

@@ -17,25 +17,6 @@ export declare class AsyncError extends Error {
 export declare class TimeoutAsyncError extends AsyncError {
     constructor(message: string, cause?: unknown);
 }
-/**
- *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group Errors
- */
-export type RetryAsyncErrorData = {
-    errors: unknown[];
-    maxAttempts: number;
-};
-/**
- *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group Errors
- */
-export declare class RetryAsyncError extends AsyncError {
-    readonly maxAttempts: number;
-    readonly errors: unknown[];
-    constructor(message: string, { errors, maxAttempts }: RetryAsyncErrorData);
-}
 /**
  *
  * IMPORT_PATH: `"@daiso-tech/core/async"`
@@ -61,7 +42,6 @@ export declare class CapacityFullAsyncError extends AsyncError {
 export declare const ASYNC_ERRORS: {
     readonly Base: typeof AsyncError;
     readonly Timeout: typeof TimeoutAsyncError;
-    readonly Retry: typeof RetryAsyncError;
     readonly Hedging: typeof HedgingAsyncError;
     readonly CapacityFull: typeof CapacityFullAsyncError;
 };

package/dist/async/async.errors.js

@@ -23,21 +23,6 @@ export class TimeoutAsyncError extends AsyncError {
         this.name = TimeoutAsyncError.name;
     }
 }
-/**
- *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group Errors
- */
-export class RetryAsyncError extends AsyncError {
-    maxAttempts;
-    errors = [];
-    constructor(message, { errors, maxAttempts }) {
-        super(message, errors);
-        this.errors = errors;
-        this.maxAttempts = maxAttempts;
-        this.name = RetryAsyncError.name;
-    }
-}
 /**
  *
  * IMPORT_PATH: `"@daiso-tech/core/async"`
@@ -70,7 +55,6 @@ export class CapacityFullAsyncError extends AsyncError {
 export const ASYNC_ERRORS = {
     Base: AsyncError,
     Timeout: TimeoutAsyncError,
-    Retry: RetryAsyncError,
     Hedging: HedgingAsyncError,
     CapacityFull: CapacityFullAsyncError,
 };

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;;;;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"}
+{"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;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,OAAO,EAAE,iBAAiB;IAC1B,YAAY,EAAE,sBAAsB;CAC9B,CAAC"}

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

@@ -5,4 +5,3 @@ 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

@@ -5,5 +5,4 @@ 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,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"}
+{"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"}

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

@@ -2,7 +2,7 @@
  * @module Async
  */
 import { callInvokable, TimeSpan, } from "../../../utilities/_module-exports.js";
-import { PromiseQueue } from "../../../async/utilities/_module.js";
+import { PromiseQueue } from "../../../async/utilities/promise-queue/_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`}

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

@@ -1 +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"}
+{"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,4CAA4C,CAAC;AAwE1E;;;;;;;;;;;;;;;;;;;;;;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/fallback/_module.d.ts

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

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

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

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

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

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

@@ -1,54 +1,9 @@
 /**
  * @module Async
  */
-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"`
- * @group Middlewares
- */
-export type OnFallbackData<TParameters extends unknown[] = unknown[], TFallbackValue = unknown, TContext extends HookContext = HookContext> = {
-    error: unknown;
-    fallbackValue: TFallbackValue;
-    args: TParameters;
-    context: TContext;
-};
-/**
- *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group Middlewares
- */
-export type OnFallback<TParameters extends unknown[] = unknown[], TFallbackValue = unknown, TContext extends HookContext = HookContext> = Invokable<[data: OnFallbackData<TParameters, TFallbackValue, TContext>]>;
-/**
- *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group Middlewares
- */
-export type FallbackCallbacks<TParameters extends unknown[] = unknown[], TReturn = unknown, TContext extends HookContext = HookContext> = {
-    /**
-     * Callback {@link Invokable | `Invokable`} that will be called before fallback value is returned.
-     */
-    onFallback?: OnFallback<TParameters, TReturn, TContext>;
-};
-/**
- *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group Middlewares
- */
-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
-     * (_error: unknown) => true
-     * ```
-     */
-    errorPolicy?: ErrorPolicy;
-};
+import { type HookContext } from "../../../utilities/_module-exports.js";
+import type { AsyncMiddlewareFn } from "../../../utilities/_module-exports.js";
+import type { FallbackSettings } from "../../../async/middlewares/fallback/fallback.types.js";
 /**
  * The `fallback` middleware adds fallback value when an error occurs.
  *
@@ -74,5 +29,26 @@ export type FallbackSettings<TParameters extends unknown[] = unknown[], TReturn
  * // Will return null when the fetch method throws an error.
  * console.log(await fetchData.invoke("URL_ENDPOINT"));
  * ```
+ *
+ * The middleware works also when the function returns a {@link Result | `Result`} type.
+ * @example
+ * ```ts
+ * import { fallback } from "@daiso-tech/core/async";
+ * import { AsyncHooks, Result, resultFailure, resultSuccess } from "@daiso-tech/core/utilities";
+ *
+ * const fetchData = new AsyncHooks(async (url: string): Promise<Result> => {
+ *   const response = await fetch(url);
+ *   const json = await response.json();
+ *   if (!response.ok) {
+ *     return resultFailure(json);
+ *   }
+ *   return resultSuccess(json);
+ * }, [
+ *   fallback({ fallbackValue: null })
+ * ]);
+ *
+ * // Will return null when the fetch method throws an error.
+ * console.log(await fetchData.invoke("URL_ENDPOINT"));
+ * ```
  */
-export declare function fallback<TParameters extends unknown[], TReturn, TContext extends HookContext>(settings: NoInfer<FallbackSettings<TParameters, TReturn, TContext>>): AsyncMiddlewareFn<TParameters, TReturn, TContext>;
+export declare function fallback<TParameters extends unknown[], TReturn, TContext extends HookContext>(settings: NoInfer<FallbackSettings<TParameters, TReturn, TContext, TReturn>>): AsyncMiddlewareFn<TParameters, TReturn, TContext>;

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

@@ -1,8 +1,8 @@
 /**
  * @module Async
  */
-import { callInvokable, resolveAsyncLazyable, } from "../../../utilities/_module-exports.js";
-import { callErrorPolicy, } from "../../../async/middlewares/_shared.js";
+import { resolveAsyncLazyable, callInvokable, resultSuccess, callErrorPolicyOnValue, isResultFailure, } from "../../../utilities/_module-exports.js";
+import { callErrorPolicyOnThrow } from "../../../utilities/_module-exports.js";
 /**
  * The `fallback` middleware adds fallback value when an error occurs.
  *
@@ -28,25 +28,63 @@ import { callErrorPolicy, } from "../../../async/middlewares/_shared.js";
  * // Will return null when the fetch method throws an error.
  * console.log(await fetchData.invoke("URL_ENDPOINT"));
  * ```
+ *
+ * The middleware works also when the function returns a {@link Result | `Result`} type.
+ * @example
+ * ```ts
+ * import { fallback } from "@daiso-tech/core/async";
+ * import { AsyncHooks, Result, resultFailure, resultSuccess } from "@daiso-tech/core/utilities";
+ *
+ * const fetchData = new AsyncHooks(async (url: string): Promise<Result> => {
+ *   const response = await fetch(url);
+ *   const json = await response.json();
+ *   if (!response.ok) {
+ *     return resultFailure(json);
+ *   }
+ *   return resultSuccess(json);
+ * }, [
+ *   fallback({ fallbackValue: null })
+ * ]);
+ *
+ * // Will return null when the fetch method throws an error.
+ * console.log(await fetchData.invoke("URL_ENDPOINT"));
+ * ```
  */
 export function fallback(settings) {
-    const { fallbackValue, errorPolicy = () => true, onFallback = () => { }, } = settings;
+    const { fallbackValue, errorPolicy, onFallback = () => { } } = settings;
     return async (args, next, { context }) => {
         try {
-            return await next(...args);
+            const value = await next(...args);
+            // Handle fallback value if an Result type is returned
+            if (!(await callErrorPolicyOnValue(errorPolicy, value))) {
+                return value;
+            }
+            // This is only needed for type inference
+            if (!isResultFailure(value)) {
+                return value;
+            }
+            const resolvedFallbackValue = await resolveAsyncLazyable(fallbackValue);
+            callInvokable(onFallback, {
+                error: value.error,
+                fallbackValue: resolvedFallbackValue,
+                args,
+                context,
+            });
+            return resultSuccess(resolvedFallbackValue);
+            // Handle fallback value if an error is thrown
         }
         catch (error) {
-            if (await callErrorPolicy(errorPolicy, error)) {
-                const resolvedFallbackValue = await resolveAsyncLazyable(fallbackValue);
-                callInvokable(onFallback, {
-                    error,
-                    fallbackValue: resolvedFallbackValue,
-                    args,
-                    context,
-                });
-                return resolvedFallbackValue;
+            if (!(await callErrorPolicyOnThrow(errorPolicy, error))) {
+                throw error;
             }
-            throw error;
+            const resolvedFallbackValue = await resolveAsyncLazyable(fallbackValue);
+            callInvokable(onFallback, {
+                error,
+                fallbackValue: resolvedFallbackValue,
+                args,
+                context,
+            });
+            return resolvedFallbackValue;
         }
     };
 }

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;AAMH,OAAO,EACH,aAAa,EACb,oBAAoB,GAGvB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAEH,eAAe,GAClB,MAAM,gCAAgC,CAAC;AAoExC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,QAAQ,CAKpB,QAAmE;IAEnE,MAAM,EACF,aAAa,EACb,WAAW,GAAG,GAAG,EAAE,CAAC,IAAI,EACxB,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,MAAM,eAAe,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC;gBAC5C,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;AAEH,OAAO,EAIH,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,sBAAsB,EACtB,eAAe,GAClB,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAExE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,MAAM,UAAU,QAAQ,CAKpB,QAEC;IAED,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,GAAG,GAAG,EAAE,GAAE,CAAC,EAAE,GAAG,QAAQ,CAAC;IACvE,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,EAAoB,EAAE;QACvD,IAAI,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;YAElC,sDAAsD;YACtD,IAAI,CAAC,CAAC,MAAM,sBAAsB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;gBACtD,OAAO,KAAK,CAAC;YACjB,CAAC;YACD,yCAAyC;YACzC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO,KAAK,CAAC;YACjB,CAAC;YAED,MAAM,qBAAqB,GACvB,MAAM,oBAAoB,CAAC,aAAa,CAAC,CAAC;YAC9C,aAAa,CAAC,UAAU,EAAE;gBACtB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,aAAa,EAAE,qBAAgC;gBAC/C,IAAI;gBACJ,OAAO;aACV,CAAC,CAAC;YACH,OAAO,aAAa,CAAC,qBAAqB,CAAY,CAAC;YAEvD,8CAA8C;QAClD,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACtB,IAAI,CAAC,CAAC,MAAM,sBAAsB,CAAM,WAAW,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;gBAC3D,MAAM,KAAK,CAAC;YAChB,CAAC;YACD,MAAM,qBAAqB,GACvB,MAAM,oBAAoB,CAAC,aAAa,CAAC,CAAC;YAC9C,aAAa,CAAC,UAAU,EAAE;gBACtB,KAAK;gBACL,aAAa,EAAE,qBAAgC;gBAC/C,IAAI;gBACJ,OAAO;aACV,CAAC,CAAC;YACH,OAAO,qBAAgC,CAAC;QAC5C,CAAC;IACL,CAAC,CAAC;AACN,CAAC"}

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

@@ -0,0 +1,42 @@
+/**
+ * @module Async
+ */
+import type { HookContext, AsyncLazyable, InferResultSuccess, InferResultError } from "../../../utilities/_module-exports.js";
+import { type Invokable } from "../../../utilities/_module-exports.js";
+import { type ErrorPolicySettings } from "../../../utilities/_module-exports.js";
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Middlewares
+ */
+export type OnFallbackData<TParameters extends unknown[] = unknown[], TFallbackValue = unknown, TContext extends HookContext = HookContext> = {
+    error: unknown;
+    fallbackValue: TFallbackValue;
+    args: TParameters;
+    context: TContext;
+};
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Middlewares
+ */
+export type OnFallback<TParameters extends unknown[] = unknown[], TFallbackValue = unknown, TContext extends HookContext = HookContext> = Invokable<[data: OnFallbackData<TParameters, TFallbackValue, TContext>]>;
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Middlewares
+ */
+export type FallbackCallbacks<TParameters extends unknown[] = unknown[], TReturn = unknown, TContext extends HookContext = HookContext> = {
+    /**
+     * Callback {@link Invokable | `Invokable`} that will be called before fallback value is returned.
+     */
+    onFallback?: OnFallback<TParameters, TReturn, TContext>;
+};
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Middlewares
+ */
+export type FallbackSettings<TParameters extends unknown[] = unknown[], TReturn = unknown, TContext extends HookContext = HookContext, TError = unknown> = FallbackCallbacks<TParameters, TReturn, TContext> & ErrorPolicySettings<InferResultError<TError>> & {
+    fallbackValue: AsyncLazyable<InferResultSuccess<TReturn>>;
+};

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

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

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

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

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

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

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

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

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

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

package/dist/async/middlewares/hedging/{_shared.d.ts → hedging.types.d.ts}

@@ -1,8 +1,9 @@
 /**
  * @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 { type AsyncMiddleware, type HookContext, type OneOrMore } from "../../../utilities/_module-exports.js";
+import type { ErrorPolicySettings, InferResultError } from "../../../utilities/_module-exports.js";
+import { type Invokable, type Promisable } from "../../../utilities/_module-exports.js";
 /**
  *
  * IMPORT_PATH: `"@daiso-tech/core/async"`
@@ -74,20 +75,47 @@ export type NamedFallback<TParameters extends unknown[] = unknown[], TReturn = u
  * IMPORT_PATH: `"@daiso-tech/core/async"`
  * @group Middlewares
  */
-export type HedgingSettings<TParameters extends unknown[] = unknown[], TReturn = unknown, TContext extends HookContext = HookContext> = HedgingCallbacks<TParameters, TContext> & {
+export type HedgingSettings<TParameters extends unknown[] = unknown[], TReturn = unknown, TContext extends HookContext = HookContext> = HedgingCallbacks<TParameters, TContext> & ErrorPolicySettings<InferResultError<TReturn>> & {
     /**
-     * The maximum time to wait before automatically aborting the executing primary {@link Invokable | `Invokable`} or fallback {@link Invokable | `Invokable:s`}.
+     * The fallback functions that run in case the primary function fails.
      *
      * @default
      * ```ts
-     * import { TimeSpan } from "@daiso-tech/core/utilities";
+     * import { retry } from "@daiso-tech/core/async";
+     * import { timeout } from "@daiso-tech/core/async";
      *
-     * TimeSpan.fromSeconds(2)
+     * [timeout(), retry()]
      * ```
      */
-    waitTime?: TimeSpan;
+    fallbacks: OneOrMore<Fallback<TParameters, TReturn> | NamedFallback<TParameters, TReturn>>;
     /**
-     * The fallback functions that run in case the primary function fails.
+     * Middlewares to apply on all fallback functions and on primary function.
+     *
+     * You can wrap primary and fallback functions with for example `retry` and `timeout` middlewares.
+     * @example
+     * ```ts
+     * import { retry, timeout, sequentialHedging } from "@daiso-tech/core/async";
+     *
+     * new AsyncHooks(fn, [
+     *   sequentialHedging({
+     *     fallbacks: [
+     *       fn1,
+     *       fn2,
+     *       fn3,
+     *     ],
+     *     middlewares: [
+     *       timeout({
+     *         waitTime: TimeSpan.fromSeconds(2),
+     *       }),
+     *       retry({
+     *         maxAttempts: 4
+     *       }),
+     *     ]
+     *   })
+     * ], {
+     *   signalBinder,
+     * })
+     * ```
      */
-    fallbacks: OneOrMore<Fallback<TParameters, TReturn> | NamedFallback<TParameters, TReturn>>;
+    middlewares?: Array<AsyncMiddleware<TParameters, TReturn>>;
 };

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

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

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

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

package/dist/async/middlewares/hedging/{sequential-hedging/sequential-hedging.middleware.d.ts → sequential-hedging.middleware.d.ts}

@@ -1,12 +1,12 @@
 /**
  * @module Async
  */
-import { type AsyncMiddlewareFn, type HookContext } from "../../../../utilities/_module-exports.js";
-import type { HedgingSettings } from "../../../../async/middlewares/hedging/_shared.js";
+import { type AsyncMiddlewareFn, type HookContext } from "../../../utilities/_module-exports.js";
+import { type HedgingSettings } from "../../../async/middlewares/hedging/hedging.types.js";
 /**
  * The `sequentialHedging` middleware executes the primary function and all fallback functions sequentially.
  * It returns the result of the first successful function and automatically cancels all remaining functions.
- * If all function fail than error is thrown.
+ * If all function fail than last error is thrown.
  *
  * IMPORT_PATH: `"@daiso-tech/core/async"`
  * @group Middlewares

package/dist/async/middlewares/hedging/sequential-hedging.middleware.js

@@ -0,0 +1,133 @@
+/**
+ * @module Async
+ */
+import { AsyncHooks, callErrorPolicyOnThrow, callErrorPolicyOnValue, callInvokable, isInvokable, optionNone, optionSome, resolveOneOrMore, } from "../../../utilities/_module-exports.js";
+import {} from "../../../async/middlewares/hedging/hedging.types.js";
+/**
+ * @internal
+ */
+function resolveFunctions(primaryFn, fallbacks, middlewares, signalBinder) {
+    const resolvedFallbacks = resolveOneOrMore(fallbacks).map((fallback, index) => {
+        if (isInvokable(fallback)) {
+            return {
+                name: `fallback-${String(index + 1)}`,
+                invokable: fallback,
+            };
+        }
+        return fallback;
+    });
+    return [
+        {
+            name: "__primary",
+            invokable: primaryFn,
+        },
+        ...resolvedFallbacks,
+    ].map((namedFn) => ({
+        name: namedFn.name,
+        invokable: new AsyncHooks(namedFn.invokable, middlewares, {
+            signalBinder,
+        }),
+    }));
+}
+/**
+ * The `sequentialHedging` middleware executes the primary function and all fallback functions sequentially.
+ * It returns the result of the first successful function and automatically cancels all remaining functions.
+ * If all function fail than last error is thrown.
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Middlewares
+ * @throws {HedgingAsyncError} {@link HedgingAsyncError}
+ *
+ * @example
+ * ```ts
+ * import { sequentialHedging } from "@daiso-tech/core/async";
+ * import { AsyncHooks } from "@daiso-tech/core/utilities";
+ *
+ * async function fn1(signal?: AbortSignal): Promise<unknown> {
+ *   const response = await fetch("ENDPOINT-1", { signal });
+ *   return await response.json();
+ * }
+ * async function fn2(signal?: AbortSignal): Promise<unknown> {
+ *   const response = await fetch("ENDPOINT-2", { signal });
+ *   return await response.json();
+ * }
+ * async function fn3(signal?: AbortSignal): Promise<unknown> {
+ *   const response = await fetch("ENDPOINT-3", { signal });
+ *   return await response.json();
+ * }
+ * const fetchData = new AsyncHooks(fn1, [
+ *   sequentialHedging({
+ *     fallbacks: [
+ *       fn2,
+ *       fn3
+ *     ]
+ *   })
+ * ], {
+ *   signalBinder: {
+ *     getSignal: (args) => args[0],
+ *     forwardSignal: (args, signal) => {
+ *       args[0] = signal;
+ *     }
+ *   }
+ * });
+ *
+ * console.log(await fetchData.invoke());
+ * ```
+ */
+export function sequentialHedging(settings) {
+    const { middlewares = [], fallbacks, errorPolicy, onHedgingAttempt = () => { }, onHedgingError = () => { }, } = settings;
+    return async (args, next, { context, signal, signalBinder }) => {
+        const funcs = resolveFunctions(next, fallbacks, middlewares, signalBinder);
+        let lastError = optionNone();
+        for (const { name, invokable: func } of funcs) {
+            try {
+                if (signal.aborted) {
+                    break;
+                }
+                callInvokable(onHedgingAttempt, {
+                    args,
+                    context,
+                    name,
+                });
+                const value = await callInvokable(func, ...args);
+                // Handle hedging if an Result type is returned
+                if (!(await callErrorPolicyOnValue(errorPolicy, value))) {
+                    return value;
+                }
+                // We can cast type here because callErrorPolicyOnValue ensures the value is a ResultFailure
+                const resultFailure = value;
+                callInvokable(onHedgingError, {
+                    args,
+                    context,
+                    error: resultFailure.error,
+                    name,
+                });
+                lastError = optionSome(resultFailure.error);
+                // Handle hedging if an error is thrown
+            }
+            catch (error) {
+                if (signal.aborted) {
+                    break;
+                }
+                if (await callErrorPolicyOnThrow(errorPolicy, error)) {
+                    lastError = optionSome(error);
+                }
+                else {
+                    throw error;
+                }
+                callInvokable(onHedgingError, {
+                    args,
+                    context,
+                    error,
+                    name,
+                });
+                lastError = optionSome(error);
+            }
+        }
+        if (lastError.type === "none") {
+            throw new Error("!!__MESSAGE__!!");
+        }
+        throw lastError.value;
+    };
+}
+//# sourceMappingURL=sequential-hedging.middleware.js.map

package/dist/async/middlewares/hedging/sequential-hedging.middleware.js.map

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

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

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