@daiso-tech/core 0.37.3 → 0.39.0

package/README.md

@@ -17,7 +17,11 @@
   @daiso-tech/core leverages modern JavaScript primitives, including ES modules
 
 - **Easily testable:**
-  @daiso-tech/core includes built-in vitest helpers for custom adapters and in-memory adapters for all components, enabling testing without Docker.
+  @daiso-tech/core includes built-in [vitest](https://vitest.dev/) helpers for custom adapters and in-memory adapters for all components, enabling testing without Docker.
+
+- **Supports standard schema:**
+  Integrated seamlessly with [standard schema](https://standardschema.dev/) allowing you to use libraries like zod to ensure both compile time and runtimte typesafety.
+
 
 ## A growing collection of officially maintained components
 

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/backof-policies/constant-backoff-policy/constant-backoff-policy.d.ts

@@ -14,7 +14,7 @@ export type ConstantBackoffPolicySettings = {
      */
     delay?: TimeSpan;
     /**
-     * @default {0.5}
+     * @default 0.5
      */
     jitter?: number;
     /**

package/dist/async/backof-policies/exponential-backoff-policy/exponential-backoff-policy.d.ts

@@ -18,11 +18,11 @@ export type ExponentialBackoffPolicySettings = {
      */
     minDelay?: TimeSpan;
     /**
-     * @default {2}
+     * @default 2
      */
     multiplier?: number;
     /**
-     * @default {0.5}
+     * @default 0.5
      */
     jitter?: number;
     /**

package/dist/async/backof-policies/linear-backoff-policy/linear-backoff-policy.d.ts

@@ -18,7 +18,7 @@ export type LinearBackoffPolicySettings = {
      */
     minDelay?: TimeSpan;
     /**
-     * @default {0.5}
+     * @default 0.5
      */
     jitter?: number;
     /**

package/dist/async/backof-policies/polynomial-backoff-policy/polynomial-backoff-policy.d.ts

@@ -18,11 +18,11 @@ export type PolynomialBackoffPolicySettings = {
      */
     minDelay?: TimeSpan;
     /**
-     * @default {2}
+     * @default 2
      */
     degree?: number;
     /**
-     * @default {0.5}
+     * @default 0.5
      */
     jitter?: number;
     /**

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.d.ts

@@ -34,14 +34,14 @@ export type BulkheadSettings<TParameters extends unknown[] = unknown[], 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}
+     * @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}
+     * @default null
      */
     maxCapacity?: number | null;
     /**

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