runtry 0.8.2 → 0.9.0

package/README.md

@@ -4,7 +4,7 @@ Run async functions and return a typed `Result` **instead of throwing**.
 
 - ✅ No repetitive `try/catch` in UI code
 - ✅ Typed success/error handling
-- ✅ Pluggable error normalization (matchers / adapters)
+- ✅ Pluggable error normalization (rules)
 - ✅ **Automatic Retries** with backoff & jitter
 - ✅ **Concurrency control** with `runAll`
 
@@ -35,176 +35,118 @@ const result = await run(async () => {
 if (result.ok) {
   console.log("data:", result.data);
 } else {
-  console.error("error:", result.error.code, result.error.message);
+  console.log("error:", result.error.code); // "UNKNOWN" | "ABORTED" | ...
 }
 ```
 
 ---
 
-## API
+## `createRunner()` (Recommended)
 
-### `run(fn, options?)`
+Define your error rules once and reuse them. Types are inferred automatically!
 
 ```ts
-import type { AppError, RunOptions, RunResult } from "runtry";
+import { createRunner, rules, errorRule } from "runtry";
+import { ZodError } from "zod";
+import { AxiosError } from "axios";
 
-declare function run<T, E extends AppError = AppError>(
-  fn: () => Promise<T>,
-  options?: RunOptions<T, E>
-): Promise<RunResult<T, E>>;
+const runner = createRunner({
+  rules: [
+    // Core rules (optional)
+    rules.abort(), // code: "ABORTED"
+    rules.timeout(), // code: "TIMEOUT"
+
+    // Custom rules (type inferred!)
+    errorRule.instance(ZodError).toError((e) => ({
+      code: "VALIDATION_ERROR", // Literal type "VALIDATION_ERROR"
+      message: "Validation failed",
+      meta: { issues: e.issues },
+    })),
+
+    errorRule.instance(AxiosError).toError((e) => ({
+      code: "HTTP_ERROR",
+      message: e.message,
+      status: e.response?.status,
+    })),
+  ],
+});
+
+// Now use it everywhere
+const result = await runner.run(fetchUser);
+
+if (!result.ok) {
+  // ⭐️ Strict typing based on your rules!
+  // error.code is "ABORTED" | "TIMEOUT" | "VALIDATION_ERROR" | "HTTP_ERROR" | "UNKNOWN"
+
+  if (result.error.code === "VALIDATION_ERROR") {
+    console.log(result.error.meta.issues); // Typed!
+  }
+}
 ```
 
-#### Options
+---
 
-- `toError`: Custom error normalizer.
-- `onError`: Callback for final failure.
-- `onSuccess`: Callback for success.
-- `onFinally`: Callback after completion (success or fail).
-- `ignoreAbort`: Don't trigger onError for Abort/Cancellation (default: true).
+## API
 
-#### Retries
+### `run(fn, options?)`
 
-You can configure automatic retries for failed operations:
+Executes a single async function.
 
 ```ts
-await run(fetchData, {
+await runner.run(fn, {
   retries: 3,
-  retryDelay: (attempt, err) => attempt * 1000,
-  jitter: { ratio: 0.5, mode: "full" }, // adds randomization to delay
-  shouldRetry: (attempt, err) => err.status === 503, // optional filter
+  retryDelay: (attempt) => attempt * 1000,
+  onError: (err) => toast.error(err.message),
+  onSuccess: (data) => console.log(data),
 });
 ```
 
----
-
 ### `runAll(tasks, options?)`
 
-Executes multiple tasks with **concurrency control**.
+Executes multiple tasks with concurrency control.
 
 ```ts
-import { runAll } from "runtry";
-
 const tasks = [
   () => fetch("/api/1"),
   () => fetch("/api/2"),
   () => fetch("/api/3"),
 ];
 
-// Run max 2 at a time
-const results = await runAll(tasks, {
+// Run max 2 at a time, stop if any fails
+const results = await runner.all(tasks, {
   concurrency: 2,
-  onSettled: (res, index) => console.log(`Task ${index} done`),
-  retries: 2, // Inherits all run() options including retries!
-});
-```
-
----
-
-## Normalizing errors (matchers)
-
-`runtry` can normalize unknown thrown values (`unknown`) into a consistent `AppError` shape.
-
-### 1) Create matchers (adapters)
-
-```ts
-import {
-  createNormalizer,
-  abortMatcher,
-  matchInstance,
-  defaultFallback,
-} from "runtry";
-import type { AppError } from "runtry";
-import { HttpError } from "./http-error"; // your app error class
-
-type MyMeta = { url?: string; body?: unknown };
-
-const httpMatcher = matchInstance(HttpError, (e) => ({
-  code: "HTTP",
-  message: e.message,
-  status: e.status,
-  meta: { url: e.url, body: e.body } as MyMeta,
-  cause: e,
-}));
-
-const toError = createNormalizer<AppError<MyMeta>>(
-  [abortMatcher, httpMatcher],
-  (e) => defaultFallback(e) as AppError<MyMeta>
-);
-```
-
-### 2) Use the normalizer in `run`
-
-```ts
-import { run } from "runtry";
-
-const res = await run(getDocuments, {
-  toError,
-  onError: (e) => console.log(e.status, e.message),
+  mode: "fail-fast", // or "settle" (default)
 });
 ```
 
----
-
-## `createRunner()` (configure once, reuse everywhere)
+### `runAllOrThrow(tasks, options?)`
 
-If you don't want to pass `toError` every time, create a runner:
+Like `Promise.all` but with concurrency control and retries. Throws the first error (normalized).
 
 ```ts
-import {
-  createRunner,
-  abortMatcher,
-  matchInstance,
-  defaultFallback,
-} from "runtry";
-import { HttpError } from "./http-error";
-
-const runner = createRunner({
-  matchers: [
-    abortMatcher,
-    matchInstance(HttpError, (e) => ({
-      code: "HTTP",
-      message: e.message,
-      status: e.status,
-      meta: { url: e.url, body: e.body },
-      cause: e,
-    })),
-  ],
-  fallback: defaultFallback,
-  ignoreAbort: true, // default
-});
-
-const result = await client.run(getDocuments, {
-  onError: (e) => console.log(e.code, e.message),
-});
+try {
+  const data = await runner.allOrThrow(tasks, { concurrency: 5 });
+} catch (err) {
+  // err is your typed AppError
+  console.error(err.code);
+}
 ```
 
 ---
 
-## React example (loading + toast, no try/catch)
+## React Example
 
 ```ts
-import { createRunner, abortMatcher, defaultFallback } from "runtry";
-
-const runner = createRunner({
-  matchers: [abortMatcher],
-  fallback: defaultFallback,
-});
-
 useEffect(() => {
   let cancelled = false;
-  setIsLoading(true);
 
-  client.run(getDocuments, {
-    onSuccess: (docs) => {
-      if (cancelled) return;
-      setUploadedFiles(docs.map(mapper));
-    },
-    onError: (e) => {
-      if (e.code === "ABORTED") return;
-      toast.error(e.message);
+  runner.run(fetchData, {
+    onSuccess: (data) => {
+      if (!cancelled) setData(data);
     },
-    onFinally: () => {
-      if (!cancelled) setIsLoading(false);
+    onError: (err) => {
+      if (err.code === "ABORTED") return;
+      toast.error(err.message);
     },
   });
 

package/dist/error/normalize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/error/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE9C,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,QAAQ,EACjD,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAChB,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,CAAC,IAErB,KAAK,OAAO,KAAG,CAAC,CAOzB;AAGD,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,QAAQ,CAQtD;AAGD,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,QAAQ,CAMjD"}
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/error/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE9C,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,QAAQ,EACjD,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAChB,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,CAAC,IAErB,KAAK,OAAO,KAAG,CAAC,CAOzB;AAGD,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,QAAQ,CAQtD;AAGD,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,QAAQ,CASjD"}

package/dist/error/normalize.js

@@ -24,6 +24,9 @@ export function toAppError(err) {
     if (err instanceof DOMException && err.name === "AbortError") {
         return { code: "ABORTED", message: "Request cancelled", cause: err };
     }
+    if (err instanceof DOMException && err.name === "TimeoutError") {
+        return { code: "TIMEOUT", message: "Request timed out", cause: err };
+    }
     return defaultFallback(err);
 }
 //# sourceMappingURL=normalize.js.map

package/dist/error/normalize.js.map

@@ -1 +1 @@
-{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../src/error/normalize.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,gBAAgB,CAC9B,KAAgB,EAChB,QAA6B;IAE7B,OAAO,CAAC,GAAY,EAAK,EAAE;QACzB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;YACnB,IAAI,GAAG;gBAAE,OAAO,GAAG,CAAC;QACtB,CAAC;QACD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC,CAAC;AACJ,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,mEAAmE;QACnE,gEAAgE;QAChE,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,sBAAsB,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IAC9E,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,sBAAsB,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;AAC1E,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,UAAU,CAAC,GAAY;IACrC,iDAAiD;IACjD,IAAI,GAAG,YAAY,YAAY,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAC7D,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,mBAAmB,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IACvE,CAAC;IACD,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../src/error/normalize.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,gBAAgB,CAC9B,KAAgB,EAChB,QAA6B;IAE7B,OAAO,CAAC,GAAY,EAAK,EAAE;QACzB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;YACnB,IAAI,GAAG;gBAAE,OAAO,GAAG,CAAC;QACtB,CAAC;QACD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC,CAAC;AACJ,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,mEAAmE;QACnE,gEAAgE;QAChE,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,sBAAsB,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IAC9E,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,sBAAsB,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;AAC1E,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,UAAU,CAAC,GAAY;IACrC,iDAAiD;IACjD,IAAI,GAAG,YAAY,YAAY,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAC7D,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,mBAAmB,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IACvE,CAAC;IACD,IAAI,GAAG,YAAY,YAAY,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;QAC/D,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,mBAAmB,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IACvE,CAAC;IACD,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC;AAC9B,CAAC"}

package/dist/index.d.ts

@@ -1,7 +1,9 @@
 export { run } from "./runner/run";
 export { runAll } from "./runner/runAll";
-export type { RunAllOptions } from "./runner/runAll";
+export type { RunAllOptions, SuccessResult, ErrorResult } from "./runner/runAll";
+export { isSuccess } from "./runner/runAll";
 export type { RunOptions, RunResult, RetryOptions } from "./types";
+export type { BackoffStrategy, CircuitBreakerOptions, Metrics, RetryContext, } from "./types";
 export type { AppError, AppErrorCode } from "./error/types";
 export { toAppError, defaultFallback, createNormalizer, } from "./error/normalize";
 export { rules } from "./error/core";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEnE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EACL,UAAU,EACV,eAAe,EACf,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAErC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnE,YAAY,EACV,eAAe,EACf,qBAAqB,EACrB,OAAO,EACP,YAAY,GACb,MAAM,SAAS,CAAC;AAEjB,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EACL,UAAU,EACV,eAAe,EACf,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAErC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -1,5 +1,6 @@
 export { run } from "./runner/run";
 export { runAll } from "./runner/runAll";
+export { isSuccess } from "./runner/runAll";
 export { toAppError, defaultFallback, createNormalizer, } from "./error/normalize";
 export { rules } from "./error/core";
 export { errorRule } from "./error/builder";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAKzC,OAAO,EACL,UAAU,EACV,eAAe,EACf,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAErC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAU5C,OAAO,EACL,UAAU,EACV,eAAe,EACf,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAErC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/runner/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/runner/run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAGtD;;;;;;;;GAQG;AACH,wBAAsB,GAAG,CAAC,CAAC,EAAE,CAAC,SAAS,QAAQ,GAAG,QAAQ,EACxD,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAM,GAC7B,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAmE1B"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/runner/run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAItD;;;;;;;;GAQG;AACH,wBAAsB,GAAG,CAAC,CAAC,EAAE,CAAC,SAAS,QAAQ,GAAG,QAAQ,EACxD,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAM,GAC7B,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CA8I1B"}

package/dist/runner/run.js

@@ -1,4 +1,5 @@
 import { toAppError as defaultToAppError } from "../error/normalize";
+import { validateOptions } from "../types";
 import { applyJitter, resolveRetryDelay, sleep } from "../utils";
 /**
  * Executes an async operation and returns a Result instead of throwing.
@@ -10,37 +11,88 @@ import { applyJitter, resolveRetryDelay, sleep } from "../utils";
  * React effects, and any async context.
  */
 export async function run(fn, options = {}) {
-    const { toError = defaultToAppError, mapError, onError, onSuccess, onFinally, ignoreAbort = true, retries = 0, retryDelay, shouldRetry = () => true, jitter = { ratio: 0.5, mode: "full" }, } = options;
+    const { toError = defaultToAppError, mapError, onError, onSuccess, onFinally, ignoreAbort = true, retries = 0, retryDelay, shouldRetry = () => true, jitter = { ratio: 0.5, mode: "full" }, backoffStrategy, maxDelay, timeout, signal, onRetry, logger, cleanup, onAbort, } = options;
     const defaultBaseDelay = retries > 0 ? 300 : 0;
+    validateOptions(options);
+    if (signal?.aborted) {
+        try {
+            onAbort?.(signal);
+        }
+        finally {
+            const err = toError(new DOMException("Aborted", "AbortError"));
+            const mapped = mapError ? mapError(err) : err;
+            if (!ignoreAbort) {
+                onError?.(mapped);
+            }
+            onFinally?.();
+            return { ok: false, data: null, error: mapped, metrics: { totalAttempts: 0, totalRetries: 0, totalDuration: 0, lastError: mapped } };
+        }
+    }
+    const startedAt = Date.now();
     let attempt = 0;
+    let lastError;
     while (true) {
         try {
-            const data = await fn();
+            const timeoutPromise = timeout && timeout > 0
+                ? new Promise((_, reject) => setTimeout(() => reject(new DOMException("Timeout", "TimeoutError")), timeout))
+                : null;
+            const data = await (timeoutPromise ? Promise.race([fn(), timeoutPromise]) : fn());
             onSuccess?.(data);
             onFinally?.();
-            return { ok: true, data, error: null };
+            const totalDuration = Date.now() - startedAt;
+            const metrics = {
+                totalAttempts: attempt + 1,
+                totalRetries: attempt,
+                totalDuration,
+                lastError,
+            };
+            logger?.debug?.("run:success", { attempts: metrics.totalAttempts, duration: metrics.totalDuration });
+            return { ok: true, data, error: null, metrics };
         }
         catch (e) {
             let err = toError(e);
             if (mapError)
                 err = mapError(err);
-            const isAborted = err.code === "ABORTED";
+            const isAborted = err?.code === "ABORTED" ||
+                (e instanceof DOMException && e.name === "AbortError") ||
+                signal?.aborted;
             if (isAborted) {
-                if (!ignoreAbort) {
-                    onError?.(err);
+                try {
+                    if (signal)
+                        onAbort?.(signal);
+                }
+                finally {
+                    if (!ignoreAbort) {
+                        onError?.(err);
+                    }
+                    onFinally?.();
+                    const totalDuration = Date.now() - startedAt;
+                    const metrics = {
+                        totalAttempts: attempt,
+                        totalRetries: attempt,
+                        totalDuration,
+                        lastError: err,
+                    };
+                    logger?.debug?.("run:aborted", { attempt, duration: metrics.totalDuration });
+                    return { ok: false, data: null, error: err, metrics };
                 }
-                onFinally?.();
-                return { ok: false, data: null, error: err };
-                // If not ignoring abort, we fall through to onError and return
             }
+            lastError = err;
             const nextAttempt = attempt + 1;
-            const canRetry = attempt < retries && shouldRetry(nextAttempt, err);
+            const context = {
+                totalAttempts: nextAttempt,
+                elapsedTime: Date.now() - startedAt,
+            };
+            const decision = await Promise.resolve(shouldRetry(nextAttempt, err, context));
+            const canRetry = attempt < retries && decision;
             if (canRetry) {
                 attempt = nextAttempt;
-                let delay = resolveRetryDelay(retryDelay, attempt, err, defaultBaseDelay);
+                let delay = resolveRetryDelay(retryDelay, attempt, err, defaultBaseDelay, backoffStrategy, maxDelay);
                 if (!Number.isFinite(delay) || delay < 0)
                     delay = 0;
                 delay = applyJitter(delay, jitter);
+                onRetry?.(attempt, err, delay);
+                logger?.debug?.("run:retry", { attempt, delay });
                 if (delay > 0)
                     await sleep(delay);
                 continue;
@@ -48,7 +100,15 @@ export async function run(fn, options = {}) {
             // Final failure or aborted
             onError?.(err);
             onFinally?.();
-            return { ok: false, data: null, error: err };
+            const totalDuration = Date.now() - startedAt;
+            const metrics = {
+                totalAttempts: attempt + 1,
+                totalRetries: attempt,
+                totalDuration,
+                lastError: err,
+            };
+            logger?.error?.("run:error", err);
+            return { ok: false, data: null, error: err, metrics };
         }
     }
 }

package/dist/runner/run.js.map

@@ -1 +1 @@
-{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/runner/run.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,IAAI,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAErE,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEjE;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG,CACvB,EAAoB,EACpB,UAA4B,EAAE;IAE9B,MAAM,EACJ,OAAO,GAAG,iBAAmD,EAC7D,QAAQ,EACR,OAAO,EACP,SAAS,EACT,SAAS,EACT,WAAW,GAAG,IAAI,EAClB,OAAO,GAAG,CAAC,EACX,UAAU,EACV,WAAW,GAAG,GAAG,EAAE,CAAC,IAAI,EACxB,MAAM,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,GACtC,GAAG,OAAO,CAAC;IAEZ,MAAM,gBAAgB,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAE/C,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,EAAE,EAAE,CAAC;YACxB,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC;YAClB,SAAS,EAAE,EAAE,CAAC;YACd,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACzC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YACrB,IAAI,QAAQ;gBAAE,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;YAElC,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC;YAEzC,IAAI,SAAS,EAAE,CAAC;gBACd,IAAI,CAAC,WAAW,EAAE,CAAC;oBACjB,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;gBACjB,CAAC;gBAED,SAAS,EAAE,EAAE,CAAC;gBACd,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;gBAC7C,+DAA+D;YACjE,CAAC;YAED,MAAM,WAAW,GAAG,OAAO,GAAG,CAAC,CAAC;YAChC,MAAM,QAAQ,GAAG,OAAO,GAAG,OAAO,IAAI,WAAW,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;YAEpE,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,GAAG,WAAW,CAAC;gBAEtB,IAAI,KAAK,GAAG,iBAAiB,CAC3B,UAAU,EACV,OAAO,EACP,GAAG,EACH,gBAAgB,CACjB,CAAC;gBAEF,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;oBAAE,KAAK,GAAG,CAAC,CAAC;gBAEpD,KAAK,GAAG,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;gBAEnC,IAAI,KAAK,GAAG,CAAC;oBAAE,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;gBAClC,SAAS;YACX,CAAC;YAED,2BAA2B;YAC3B,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;YACf,SAAS,EAAE,EAAE,CAAC;YACd,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;QAC/C,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/runner/run.ts"],"names":[],"mappings":"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"}

package/dist/runner/runAll.d.ts

@@ -1,5 +1,11 @@
 import type { AppError } from "../error/types";
 import type { RunOptions } from "../types";
+/**
+ * Resultado discriminado por ítem en `runAll`:
+ * - "ok": tarea exitosa con `data`
+ * - "error": tarea fallida con `error`
+ * - "skipped": tarea no ejecutada por cancelación/fail-fast/concurrencia
+ */
 export type RunAllItemResult<T, E extends AppError = AppError> = {
     status: "ok";
     ok: true;
@@ -16,6 +22,16 @@ export type RunAllItemResult<T, E extends AppError = AppError> = {
     data: null;
     error: null;
 };
+/** Helper para discriminar resultados exitosos. */
+export type SuccessResult<T> = Extract<RunAllItemResult<T, any>, {
+    status: "ok";
+}>;
+/** Helper para discriminar resultados con error. */
+export type ErrorResult<E> = Extract<RunAllItemResult<any, E extends AppError ? E : AppError>, {
+    status: "error";
+}>;
+/** Type guard que detecta `status: "ok"` con tipado de `data`. */
+export declare const isSuccess: <T, E extends AppError = AppError>(r: RunAllItemResult<T, E>) => r is SuccessResult<T>;
 export type RunAllOptions<T, E extends AppError = AppError> = RunOptions<T, E> & {
     /**
      * Maximum number of concurrent tasks to run.

package/dist/runner/runAll.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runAll.d.ts","sourceRoot":"","sources":["../../src/runner/runAll.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAa,MAAM,UAAU,CAAC;AAEtD,MAAM,MAAM,gBAAgB,CAAC,CAAC,EAAE,CAAC,SAAS,QAAQ,GAAG,QAAQ,IACzD;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,IAAI,CAAA;CAAE,GAChD;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACpD;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,IAAI,CAAA;CAAE,CAAC;AAE9D,MAAM,MAAM,aAAa,CAAC,CAAC,EAAE,CAAC,SAAS,QAAQ,GAAG,QAAQ,IAAI,UAAU,CACtE,CAAC,EACD,CAAC,CACF,GAAG;IACF;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;CAC/B,CAAC;AAEF,wBAAsB,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,QAAQ,GAAG,QAAQ,EAC3D,KAAK,EAAE,KAAK,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,EAC9B,OAAO,GAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAM,GAChC,OAAO,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAqEnC"}
+{"version":3,"file":"runAll.d.ts","sourceRoot":"","sources":["../../src/runner/runAll.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAa,MAAM,UAAU,CAAC;AAGtD;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,EAAE,CAAC,SAAS,QAAQ,GAAG,QAAQ,IACzD;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,IAAI,CAAA;CAAE,GAChD;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACpD;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,IAAI,CAAA;CAAE,CAAC;AAE9D,mDAAmD;AACnD,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,OAAO,CACpC,gBAAgB,CAAC,CAAC,EAAE,GAAG,CAAC,EACxB;IAAE,MAAM,EAAE,IAAI,CAAA;CAAE,CACjB,CAAC;AACF,oDAAoD;AACpD,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,OAAO,CAClC,gBAAgB,CAAC,GAAG,EAAE,CAAC,SAAS,QAAQ,GAAG,CAAC,GAAG,QAAQ,CAAC,EACxD;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,CACpB,CAAC;AAEF,kEAAkE;AAClE,eAAO,MAAM,SAAS,GAAI,CAAC,EAAE,CAAC,SAAS,QAAQ,GAAG,QAAQ,EACxD,GAAG,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,KACxB,CAAC,IAAI,aAAa,CAAC,CAAC,CAAsB,CAAC;AAE9C,MAAM,MAAM,aAAa,CAAC,CAAC,EAAE,CAAC,SAAS,QAAQ,GAAG,QAAQ,IAAI,UAAU,CACtE,CAAC,EACD,CAAC,CACF,GAAG;IACF;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;CAC/B,CAAC;AAEF,wBAAsB,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,QAAQ,GAAG,QAAQ,EAC3D,KAAK,EAAE,KAAK,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,EAC9B,OAAO,GAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAM,GAChC,OAAO,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAsEnC"}

package/dist/runner/runAll.js

@@ -1,6 +1,10 @@
 import { run } from "./run";
+import { validateOptions } from "../types";
+/** Type guard que detecta `status: "ok"` con tipado de `data`. */
+export const isSuccess = (r) => r.status === "ok";
 export async function runAll(tasks, options = {}) {
     const { concurrency = Infinity, mode = "settle", ...runOptions } = options;
+    validateOptions(runOptions);
     if (tasks.length === 0)
         return [];
     const limit = Number.isFinite(concurrency)

package/dist/runner/runAll.js.map

@@ -1 +1 @@
-{"version":3,"file":"runAll.js","sourceRoot":"","sources":["../../src/runner/runAll.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AA4B5B,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,KAA8B,EAC9B,UAA+B,EAAE;IAEjC,MAAM,EAAE,WAAW,GAAG,QAAQ,EAAE,IAAI,GAAG,QAAQ,EAAE,GAAG,UAAU,EAAE,GAAG,OAAO,CAAC;IAE3E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAElC,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC;QACxC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACtC,CAAC,CAAC,QAAQ,CAAC;IAEb,MAAM,OAAO,GAA6B,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAElE,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,MAAM,SAAS,GAAG,CAAC,CAAS,EAAE,CAAkB,EAAE,EAAE;QAClD,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE;YACf,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE;YACvD,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;IACjE,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,GAAG,EAAE;QACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,IAAI,OAAO,CAAC,CAAC,CAAC;gBAAE,SAAS;YACzB,OAAO,CAAC,CAAC,CAAC,GAAG;gBACX,MAAM,EAAE,SAAS;gBACjB,EAAE,EAAE,KAAK;gBACT,IAAI,EAAE,IAAI;gBACV,KAAK,EAAE,IAAI;aACZ,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;IAEF,qDAAqD;IACrD,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAO,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;QACzE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YAClB,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;QACH,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,IAAI,EAAE;QACxB,OAAO,IAAI,EAAE,CAAC;YACZ,IAAI,OAAO;gBAAE,OAAO;YAEpB,MAAM,CAAC,GAAG,SAAS,EAAE,CAAC;YACtB,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM;gBAAE,OAAO;YAE9B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,IAAI,CAAC,IAAI;gBAAE,SAAS,CAAC,4BAA4B;YAEjD,MAAM,CAAC,GAAG,MAAM,GAAG,CAAO,IAAI,EAAE,UAAU,CAAC,CAAC;YAC5C,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAEhB,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;gBACV,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;oBACzB,OAAO,GAAG,IAAI,CAAC;oBACf,OAAO;gBACT,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,OAAO,CAAC,GAAG,CACf,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CACtE,CAAC;IAEF,WAAW,EAAE,CAAC;IACd,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"runAll.js","sourceRoot":"","sources":["../../src/runner/runAll.ts"],"names":[],"mappings":"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"}

package/dist/runner/runAllOrThrow.d.ts

@@ -1,5 +1,10 @@
 import type { AppError } from "../error/types";
 import type { RunOptions } from "../types";
+/**
+ * Opciones para `runAllOrThrow`:
+ * - Hereda todas las opciones de `RunOptions`
+ * - `concurrency`: límite de tareas simultáneas; si falla una, se lanza
+ */
 export type RunAllOrThrowOptions<T, E extends AppError = AppError> = RunOptions<T, E> & {
     /**
      * Maximum number of concurrent tasks to run.

package/dist/runner/runAllOrThrow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runAllOrThrow.d.ts","sourceRoot":"","sources":["../../src/runner/runAllOrThrow.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAa,MAAM,UAAU,CAAC;AAEtD,MAAM,MAAM,oBAAoB,CAAC,CAAC,EAAE,CAAC,SAAS,QAAQ,GAAG,QAAQ,IAAI,UAAU,CAC7E,CAAC,EACD,CAAC,CACF,GAAG;IACF;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,wBAAsB,aAAa,CAAC,CAAC,EAAE,CAAC,SAAS,QAAQ,GAAG,QAAQ,EAClE,KAAK,EAAE,KAAK,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,EAC9B,OAAO,GAAE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAM,GACvC,OAAO,CAAC,CAAC,EAAE,CAAC,CAyDd"}
+{"version":3,"file":"runAllOrThrow.d.ts","sourceRoot":"","sources":["../../src/runner/runAllOrThrow.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAa,MAAM,UAAU,CAAC;AAGtD;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,EAAE,CAAC,SAAS,QAAQ,GAAG,QAAQ,IAAI,UAAU,CAC7E,CAAC,EACD,CAAC,CACF,GAAG;IACF;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,wBAAsB,aAAa,CAAC,CAAC,EAAE,CAAC,SAAS,QAAQ,GAAG,QAAQ,EAClE,KAAK,EAAE,KAAK,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,EAC9B,OAAO,GAAE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAM,GACvC,OAAO,CAAC,CAAC,EAAE,CAAC,CA0Dd"}

package/dist/runner/runAllOrThrow.js

@@ -1,6 +1,8 @@
 import { run } from "./run";
+import { validateOptions } from "../types";
 export async function runAllOrThrow(tasks, options = {}) {
     const { concurrency = Infinity, ...runOptions } = options;
+    validateOptions(runOptions);
     if (tasks.length === 0)
         return [];
     const limit = Number.isFinite(concurrency)

package/dist/runner/runAllOrThrow.js.map

@@ -1 +1 @@
-{"version":3,"file":"runAllOrThrow.js","sourceRoot":"","sources":["../../src/runner/runAllOrThrow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAe5B,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAA8B,EAC9B,UAAsC,EAAE;IAExC,MAAM,EAAE,WAAW,GAAG,QAAQ,EAAE,GAAG,UAAU,EAAE,GAAG,OAAO,CAAC;IAE1D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAElC,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC;QACxC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACtC,CAAC,CAAC,QAAQ,CAAC;IAEb,MAAM,IAAI,GAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAE1C,qDAAqD;IACrD,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,OAAO,CAAC,GAAG,CACf,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE;YACvB,MAAM,CAAC,GAAG,MAAM,GAAG,CAAO,CAAC,EAAE,UAAU,CAAC,CAAC;YACzC,IAAI,CAAC,CAAC,CAAC,EAAE;gBAAE,MAAM,CAAC,CAAC,KAAK,CAAC;YACzB,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;QACnB,CAAC,CAAC,CACH,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,UAAU,GAAa,IAAI,CAAC;IAEhC,MAAM,MAAM,GAAG,KAAK,IAAI,EAAE;QACxB,OAAO,IAAI,EAAE,CAAC;YACZ,IAAI,OAAO;gBAAE,OAAO;YAEpB,MAAM,CAAC,GAAG,SAAS,EAAE,CAAC;YACtB,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM;gBAAE,OAAO;YAE9B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,IAAI,CAAC,IAAI;gBAAE,SAAS,CAAC,4BAA4B;YAEjD,MAAM,CAAC,GAAG,MAAM,GAAG,CAAO,IAAI,EAAE,UAAU,CAAC,CAAC;YAE5C,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;gBACV,UAAU,KAAV,UAAU,GAAK,CAAC,CAAC,KAAK,EAAC;gBACvB,OAAO,GAAG,IAAI,CAAC;gBACf,OAAO;YACT,CAAC;YAED,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;QACnB,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,OAAO,CAAC,GAAG,CACf,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CACtE,CAAC;IAEF,IAAI,UAAU;QAAE,MAAM,UAAU,CAAC;IAEjC,cAAc;IACd,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"runAllOrThrow.js","sourceRoot":"","sources":["../../src/runner/runAllOrThrow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAG5B,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAkB3C,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAA8B,EAC9B,UAAsC,EAAE;IAExC,MAAM,EAAE,WAAW,GAAG,QAAQ,EAAE,GAAG,UAAU,EAAE,GAAG,OAAO,CAAC;IAC1D,eAAe,CAAC,UAAU,CAAC,CAAC;IAE5B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAElC,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC;QACxC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACtC,CAAC,CAAC,QAAQ,CAAC;IAEb,MAAM,IAAI,GAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAE1C,qDAAqD;IACrD,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,OAAO,CAAC,GAAG,CACf,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE;YACvB,MAAM,CAAC,GAAG,MAAM,GAAG,CAAO,CAAC,EAAE,UAAU,CAAC,CAAC;YACzC,IAAI,CAAC,CAAC,CAAC,EAAE;gBAAE,MAAM,CAAC,CAAC,KAAK,CAAC;YACzB,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;QACnB,CAAC,CAAC,CACH,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,UAAU,GAAa,IAAI,CAAC;IAEhC,MAAM,MAAM,GAAG,KAAK,IAAI,EAAE;QACxB,OAAO,IAAI,EAAE,CAAC;YACZ,IAAI,OAAO;gBAAE,OAAO;YAEpB,MAAM,CAAC,GAAG,SAAS,EAAE,CAAC;YACtB,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM;gBAAE,OAAO;YAE9B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,IAAI,CAAC,IAAI;gBAAE,SAAS,CAAC,4BAA4B;YAEjD,MAAM,CAAC,GAAG,MAAM,GAAG,CAAO,IAAI,EAAE,UAAU,CAAC,CAAC;YAE5C,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;gBACV,UAAU,KAAV,UAAU,GAAK,CAAC,CAAC,KAAK,EAAC;gBACvB,OAAO,GAAG,IAAI,CAAC;gBACf,OAAO;YACT,CAAC;YAED,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;QACnB,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,OAAO,CAAC,GAAG,CACf,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CACtE,CAAC;IAEF,IAAI,UAAU;QAAE,MAAM,UAAU,CAAC;IAEjC,cAAc;IACd,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/runner/runner.d.ts

@@ -1,5 +1,6 @@
 import type { AppError, Rule, InferErrorFromRules } from "../error/types";
 import type { RunOptions, RunResult } from "../types";
+import type { CircuitBreakerOptions } from "../types";
 import { type RunAllItemResult, type RunAllOptions } from "./runAll";
 export type CreateRunnerOptions<E extends AppError = AppError> = {
     /**
@@ -21,6 +22,11 @@ export type CreateRunnerOptions<E extends AppError = AppError> = {
     ignoreAbort?: boolean;
     /** Optional default mapper for all runs */
     mapError?: (error: E) => E;
+    /**
+     * Circuit breaker por defecto para todas las ejecuciones de la instancia.
+     * Puede ser sobreescrito por `options.circuitBreaker` en cada `run`.
+     */
+    circuitBreaker?: CircuitBreakerOptions;
 };
 export interface Runner<E extends AppError> {
     run<T>(fn: () => Promise<T>, options?: RunOptions<T, E>): Promise<RunResult<T, E>>;

package/dist/runner/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/runner/runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAO1E,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEtD,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,aAAa,EACnB,MAAM,UAAU,CAAC;AAElB,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ,IAAI;IAC/D;;;OAGG;IACH,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAElB;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,CAAC,CAAC;IAE/B;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,CAAC,CAAC;IAE9B,8BAA8B;IAC9B,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;CAC5B,CAAC;AAOF,MAAM,WAAW,MAAM,CAAC,CAAC,SAAS,QAAQ;IACxC,GAAG,CAAC,CAAC,EACH,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,GACzB,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5B,GAAG,CAAC,CAAC,EACH,GAAG,EAAE,KAAK,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,EAC5B,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,GAC5B,OAAO,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IACrC,UAAU,CAAC,CAAC,EACV,GAAG,EAAE,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EACzB,OAAO,CAAC,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,GACzB,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;CACjB;AAED,wBAAgB,YAAY,CAC1B,IAAI,CAAC,EAAE,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,GAClD,MAAM,CAAC,QAAQ,CAAC,CAAC;AAEpB,wBAAgB,YAAY,CAAC,KAAK,CAAC,MAAM,SAAS,SAAS,IAAI,CAAC,GAAG,CAAC,EAAE,EACpE,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAC5B,mBAAmB,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,EAChD,OAAO,CACR,GACA,MAAM,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/runner/runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAO1E,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAEtD,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,aAAa,EACnB,MAAM,UAAU,CAAC;AAElB,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ,IAAI;IAC/D;;;OAGG;IACH,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAElB;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,CAAC,CAAC;IAE/B;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,CAAC,CAAC;IAE9B,8BAA8B;IAC9B,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;IAC3B;;;OAGG;IACH,cAAc,CAAC,EAAE,qBAAqB,CAAC;CACxC,CAAC;AAOF,MAAM,WAAW,MAAM,CAAC,CAAC,SAAS,QAAQ;IACxC,GAAG,CAAC,CAAC,EACH,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,GACzB,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5B,GAAG,CAAC,CAAC,EACH,GAAG,EAAE,KAAK,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,EAC5B,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,GAC5B,OAAO,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IACrC,UAAU,CAAC,CAAC,EACV,GAAG,EAAE,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EACzB,OAAO,CAAC,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,GACzB,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;CACjB;AAED,wBAAgB,YAAY,CAC1B,IAAI,CAAC,EAAE,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,GAClD,MAAM,CAAC,QAAQ,CAAC,CAAC;AAEpB,wBAAgB,YAAY,CAAC,KAAK,CAAC,MAAM,SAAS,SAAS,IAAI,CAAC,GAAG,CAAC,EAAE,EACpE,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAC5B,mBAAmB,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,EAChD,OAAO,CACR,GACA,MAAM,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC"}

package/dist/runner/runner.js

@@ -4,18 +4,85 @@ import { runAllOrThrow as baseRunAllOrThrow } from "./runAllOrThrow";
 import { runAll as baseRunAll, } from "./runAll";
 const composeMapError = (base, local) => (e) => local ? local(base ? base(e) : e) : base ? base(e) : e;
 export function createRunner(opts = {}) {
-    const { rules = [], fallback = (e) => defaultFallback(e), toError: customToError, ignoreAbort = true, mapError: defaultMapError, } = opts;
+    const { rules = [], fallback = (e) => defaultFallback(e), toError: customToError, ignoreAbort = true, mapError: defaultMapError, circuitBreaker: defaultCircuitBreaker, } = opts;
     const toError = customToError ??
         (rules.length > 0
             ? createNormalizer(rules, fallback)
             : toAppError);
+    let failureCount = 0;
+    let openUntil = null;
+    let halfOpenRemaining = null;
     return {
         run(fn, options = {}) {
+            const cb = options.circuitBreaker ?? defaultCircuitBreaker;
+            const now = Date.now();
+            if (cb) {
+                if (openUntil && now < openUntil) {
+                    const err = toError(new Error("Circuit open"));
+                    const mapped = composeMapError(defaultMapError, options.mapError)(err);
+                    options.onError?.(mapped);
+                    options.onFinally?.();
+                    return Promise.resolve({
+                        ok: false,
+                        data: null,
+                        error: mapped,
+                        metrics: {
+                            totalAttempts: 0,
+                            totalRetries: 0,
+                            totalDuration: 0,
+                            lastError: mapped,
+                        },
+                    });
+                }
+                if (openUntil && now >= openUntil) {
+                    openUntil = null;
+                    failureCount = 0;
+                    halfOpenRemaining = cb.halfOpenRequests ?? 1;
+                }
+                if (halfOpenRemaining != null) {
+                    if (halfOpenRemaining <= 0) {
+                        const err = toError(new Error("Circuit half-open limit"));
+                        const mapped = composeMapError(defaultMapError, options.mapError)(err);
+                        options.onError?.(mapped);
+                        options.onFinally?.();
+                        return Promise.resolve({
+                            ok: false,
+                            data: null,
+                            error: mapped,
+                            metrics: {
+                                totalAttempts: 0,
+                                totalRetries: 0,
+                                totalDuration: 0,
+                                lastError: mapped,
+                            },
+                        });
+                    }
+                    else {
+                        halfOpenRemaining--;
+                    }
+                }
+            }
             return baseRun(fn, {
                 toError,
                 ignoreAbort,
                 ...options,
                 mapError: composeMapError(defaultMapError, options.mapError),
+            }).then((r) => {
+                if (!cb)
+                    return r;
+                if (!r.ok) {
+                    failureCount++;
+                    if (failureCount >= cb.failureThreshold) {
+                        openUntil = Date.now() + cb.resetTimeout;
+                        halfOpenRemaining = null;
+                    }
+                }
+                else {
+                    failureCount = 0;
+                    openUntil = null;
+                    halfOpenRemaining = null;
+                }
+                return r;
             });
         },
         all(fns, options = {}) {

package/dist/runner/runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/runner/runner.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,UAAU,GACX,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,GAAG,IAAI,OAAO,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,EAAE,aAAa,IAAI,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EACL,MAAM,IAAI,UAAU,GAGrB,MAAM,UAAU,CAAC;AA4BlB,MAAM,eAAe,GACnB,CAAI,IAAkB,EAAE,KAAmB,EAAE,EAAE,CAC/C,CAAC,CAAI,EAAE,EAAE,CACP,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AA4B3D,MAAM,UAAU,YAAY,CAC1B,OAAY,EAAE;IAId,MAAM,EACJ,KAAK,GAAG,EAAE,EACV,QAAQ,GAAG,CAAC,CAAU,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,CAAiB,EAC7D,OAAO,EAAE,aAAa,EACtB,WAAW,GAAG,IAAI,EAClB,QAAQ,EAAE,eAAe,GAC1B,GAAG,IAA8B,CAAC;IAEnC,MAAM,OAAO,GACX,aAAa;QACb,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;YACf,CAAC,CAAC,gBAAgB,CAAI,KAA6B,EAAE,QAAQ,CAAC;YAC9D,CAAC,CAAE,UAA2C,CAAC,CAAC;IAEpD,OAAO;QACL,GAAG,CACD,EAAoB,EACpB,UAA4B,EAAE;YAE9B,OAAO,OAAO,CAAC,EAAE,EAAE;gBACjB,OAAO;gBACP,WAAW;gBACX,GAAG,OAAO;gBACV,QAAQ,EAAE,eAAe,CAAC,eAAe,EAAE,OAAO,CAAC,QAAQ,CAAC;aAC7D,CAAC,CAAC;QACL,CAAC;QACD,GAAG,CACD,GAA4B,EAC5B,UAA+B,EAAE;YAEjC,OAAO,UAAU,CAAC,GAAG,EAAE;gBACrB,OAAO;gBACP,WAAW;gBACX,GAAG,OAAO;gBACV,QAAQ,EAAE,eAAe,CAAC,eAAe,EAAE,OAAO,CAAC,QAAQ,CAAC;aAC7D,CAAC,CAAC;QACL,CAAC;QACD,UAAU,CACR,GAAyB,EACzB,UAA4B,EAAE;YAE9B,OAAO,iBAAiB,CAAC,GAAG,EAAE;gBAC5B,OAAO;gBACP,WAAW;gBACX,GAAG,OAAO;gBACV,QAAQ,EAAE,eAAe,CAAC,eAAe,EAAE,OAAO,CAAC,QAAQ,CAAC;aAC7D,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/runner/runner.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -5,90 +5,166 @@ export type Jitter = boolean | number | {
     mode?: "full" | "equal";
     rng?: () => number;
 };
+/**
+ * Estrategia de backoff para calcular el delay entre reintentos.
+ * - "linear": usa el delay base tal cual en cada intento.
+ * - "exponential": multiplica por 2^(attempt-1) el delay.
+ * - "fibonacci": multiplica por F(attempt) (serie fibonacci clásica).
+ * - function: función personalizada basada en el número de intento.
+ */
+export type BackoffStrategy = "linear" | "exponential" | "fibonacci" | ((attempt: number) => number);
+/**
+ * Opciones de reintentos para `run`, `runAll` y `runAllOrThrow`.
+ */
 export type RetryOptions<E extends AppError = AppError> = {
     /**
-     * Number of retries to attempt.
+     * Cantidad de reintentos a realizar (no incluye el intento inicial).
      * @default 0
      */
     retries?: number;
     /**
-     * Delay in milliseconds between retries.
-     *
-     * - `number` for a fixed delay
-     * - `function` for custom delay based on attempt and error
-     *
-     * @default 0
+     * Delay entre intentos:
+     * - number: delay fijo (ms)
+     * - () => number: delay lazy (evaluado por intento)
+     * - (attempt, err) => number: delay basado en intento y último error
+     * @default 0 o un baseDelay por defecto si hay retries
      */
-    retryDelay?: number | RetryDelayFn<E>;
+    retryDelay?: number | (() => number) | RetryDelayFn<E>;
     /**
-     * Function to determine if a retry should be attempted.
-     * Returns true to retry, false to stop.
+     * Decide si se debe reintentar ante un error dado.
+     * Puede ser síncrono o asíncrono.
+     * Recibe el intento siguiente y un contexto con métricas acumuladas.
      * @default () => true
      */
-    shouldRetry?: (attempt: number, error: E) => boolean;
+    shouldRetry?: (attempt: number, error: E, context: RetryContext) => boolean | Promise<boolean>;
     /**
-     * Adds random jitter to the delay to prevent thundering herd.
-     *
-     * - `true` for default 0.5 ratio
-     * - `false` to disable jitter
-     * - `number` for custom ratio 0..1
-     * - `{ ratio, mode, rng }` for full control
-     *
+     * Jitter aleatorio para evitar thundering herd:
+     * - true: ratio 0.5 por defecto
+     * - false: sin jitter
+     * - number: ratio 0..1
+     * - object: control completo (ratio, mode, rng)
      * @default 0.5
      */
     jitter?: Jitter;
+    /**
+     * Estrategia de backoff a aplicar sobre el delay calculado.
+     * @default "linear"
+     */
+    backoffStrategy?: BackoffStrategy;
+    /**
+     * Límite superior del delay tras backoff y antes de jitter.
+     * @default undefined (sin límite)
+     */
+    maxDelay?: number;
+};
+/**
+ * Contexto para `shouldRetry` con acumulados del intento actual.
+ */
+export type RetryContext = {
+    /** Total de intentos (incluyendo el próximo reintento). */
+    totalAttempts: number;
+    /** Tiempo transcurrido en ms desde el inicio del `run`. */
+    elapsedTime: number;
 };
+/**
+ * Opciones principales para `run` y extendidas a `runAll`/`runAllOrThrow`.
+ */
 export type RunOptions<T, E extends AppError = AppError> = RetryOptions<E> & {
     /**
-     * Converts an unknown thrown value into your normalized error type `E`.
-     *
-     * Use this to integrate custom errors (e.g. HttpError, AxiosError, ZodError),
-     * map status codes, or attach metadata for UI/debugging.
-     *
-     * If omitted, a default normalizer is used (best-effort).
+     * Normaliza un valor de error desconocido a tu tipo `E`.
+     * Si no se provee, se usa un normalizador por defecto.
      */
     toError?: (err: unknown) => E;
     /**
-     * Optional error transformer applied AFTER `toError`.
-     *
-     * Useful for translating messages, mapping status to user-friendly text,
-     * or enforcing a consistent error format across the app.
+     * Transformación opcional aplicada luego de `toError`.
+     * Útil para ajustar mensajes, códigos o agregar metadata.
      */
     mapError?: (error: E) => E;
     /**
-     * Called when the operation fails (except when `ignoreAbort` is true and the error code is "ABORTED").
-     *
-     * Great place for toasts, logging, analytics, etc.
+     * Callback al fallar (no se llama si `ignoreAbort` y el error es ABORTED).
      */
     onError?: (error: E) => void;
     /**
-     * Called when the operation succeeds.
+     * Callback al tener éxito.
      */
     onSuccess?: (data: T) => void;
     /**
-     * Called after success or failure, similar to `finally`, but with no return value.
-     *
-     * Common use: stop loading spinners, cleanup state, etc.
+     * Callback que se ejecuta siempre al finalizar (éxito o error).
      */
     onFinally?: () => void;
     /**
-     * When true, errors with `code === "ABORTED"` are treated as non-fatal:
-     * - `onError` is NOT called
-     * - the result is returned as `{ ok: false, error }`
-     *
-     * This is useful for cancellable side-effects (React effects, debounced searches, etc.).
-     *
+     * Si true, los abortos (ABORTED) no se consideran error fatal:
+     * no se llama `onError` y se devuelve `{ ok: false, error }`.
      * @default true
      */
     ignoreAbort?: boolean;
+    /**
+     * Señal para cancelación nativa del trabajo.
+     * Si está abortada, se corta con `AbortError`.
+     */
+    signal?: AbortSignal;
+    /**
+     * Timeout máximo en ms para el trabajo; expira con `TimeoutError`.
+     */
+    timeout?: number;
+    /**
+     * Observabilidad de reintentos: recibe intento, error y delay siguiente.
+     */
+    onRetry?: (attempt: number, error: E, nextDelay: number) => void;
+    /**
+     * Logger estructurado opcional para debug y errores.
+     */
+    logger?: {
+        debug?: (msg: string, meta?: any) => void;
+        error?: (msg: string, error: E) => void;
+    };
+    /**
+     * Limpieza de recursos que se ejecuta siempre al terminar.
+     */
+    cleanup?: () => void | Promise<void>;
+    /**
+     * Callback al abortar, útil para reaccionar a `AbortSignal`.
+     */
+    onAbort?: (signal: AbortSignal) => void;
+    /**
+     * Configuración de circuit breaker por llamada.
+     * Si no se define, puede usar el valor por defecto del `Runner`.
+     */
+    circuitBreaker?: CircuitBreakerOptions;
+};
+/**
+ * Opciones de configuración del circuit breaker:
+ * - failureThreshold: número de fallos consecutivos para abrir el circuito
+ * - resetTimeout: tiempo en ms que permanece abierto antes de intentar half-open
+ * - halfOpenRequests: cantidad permitida en estado half-open
+ */
+export type CircuitBreakerOptions = {
+    failureThreshold: number;
+    resetTimeout: number;
+    halfOpenRequests?: number;
+};
+/**
+ * Métricas de ejecución devueltas opcionalmente en `RunResult`.
+ */
+export type Metrics = {
+    totalAttempts: number;
+    totalRetries: number;
+    totalDuration: number;
+    lastError?: AppError;
 };
 export type RunResult<T, E extends AppError = AppError> = {
     ok: true;
     data: T;
     error: null;
+    metrics?: Metrics;
 } | {
     ok: false;
     data: null;
     error: E;
+    metrics?: Metrics;
 };
+/**
+ * Valida opciones comunes de ejecución/reintentos.
+ */
+export declare function validateOptions<T, E extends AppError = AppError>(options: RunOptions<T, E>): void;
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK,MAAM,CAAC;AAElE,MAAM,MAAM,MAAM,GACd,OAAO,GACP,MAAM,GACN;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CAAE,CAAC;AAEpE,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ,IAAI;IACxD;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IAEtC;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC;IAErD;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,UAAU,CAAC,CAAC,EAAE,CAAC,SAAS,QAAQ,GAAG,QAAQ,IAAI,YAAY,CAAC,CAAC,CAAC,GAAG;IAC3E;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,CAAC,CAAC;IAE9B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;IAE3B;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAE7B;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;IAE9B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IAEvB;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,SAAS,CAAC,CAAC,EAAE,CAAC,SAAS,QAAQ,GAAG,QAAQ,IAClD;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,IAAI,CAAA;CAAE,GAClC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK,MAAM,CAAC;AAElE,MAAM,MAAM,MAAM,GACd,OAAO,GACP,MAAM,GACN;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CAAE,CAAC;AAEpE;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GACvB,QAAQ,GACR,aAAa,GACb,WAAW,GACX,CAAC,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;AAElC;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ,IAAI;IACxD;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IACvD;;;;;OAKG;IACH,WAAW,CAAC,EAAE,CACZ,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,YAAY,KAClB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,2DAA2D;IAC3D,aAAa,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,EAAE,CAAC,SAAS,QAAQ,GAAG,QAAQ,IAAI,YAAY,CAAC,CAAC,CAAC,GAAG;IAC3E;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,CAAC,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;IAC3B;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC7B;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;IAC9B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACjE;;OAEG;IACH,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;QAC1C,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;KACzC,CAAC;IACF;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;IACxC;;;OAGG;IACH,cAAc,CAAC,EAAE,qBAAqB,CAAC;CACxC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,QAAQ,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,SAAS,CAAC,CAAC,EAAE,CAAC,SAAS,QAAQ,GAAG,QAAQ,IAClD;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GACrD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAE3D;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,CAAC,SAAS,QAAQ,GAAG,QAAQ,EAC9D,OAAO,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,GACxB,IAAI,CAsBN"}

package/dist/types.js

@@ -1,2 +1,27 @@
-export {};
+/**
+ * Valida opciones comunes de ejecución/reintentos.
+ */
+export function validateOptions(options) {
+    if (options.retries != null && options.retries < 0) {
+        throw new Error("retries must be >= 0");
+    }
+    if (options.timeout != null && options.timeout <= 0) {
+        throw new Error("timeout must be > 0");
+    }
+    if (options.maxDelay != null && options.maxDelay < 0) {
+        throw new Error("maxDelay must be >= 0");
+    }
+    const cb = options.circuitBreaker;
+    if (cb) {
+        if (cb.failureThreshold < 1) {
+            throw new Error("failureThreshold must be >= 1");
+        }
+        if (cb.resetTimeout <= 0) {
+            throw new Error("resetTimeout must be > 0");
+        }
+        if (cb.halfOpenRequests != null && cb.halfOpenRequests < 1) {
+            throw new Error("halfOpenRequests must be >= 1");
+        }
+    }
+}
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA8KA;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAyB;IAEzB,IAAI,OAAO,CAAC,OAAO,IAAI,IAAI,IAAI,OAAO,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,OAAO,CAAC,OAAO,IAAI,IAAI,IAAI,OAAO,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,IAAI,IAAI,IAAI,OAAO,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;IACD,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAClC,IAAI,EAAE,EAAE,CAAC;QACP,IAAI,EAAE,CAAC,gBAAgB,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACnD,CAAC;QACD,IAAI,EAAE,CAAC,YAAY,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,EAAE,CAAC,gBAAgB,IAAI,IAAI,IAAI,EAAE,CAAC,gBAAgB,GAAG,CAAC,EAAE,CAAC;YAC3D,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/utils.d.ts

@@ -1,6 +1,7 @@
-import type { Jitter, RetryDelayFn } from "./types";
+import type { Jitter, RetryDelayFn, BackoffStrategy } from "./types";
 export declare const sleep: (ms: number) => Promise<unknown>;
 export declare function clamp(n: number, min: number, max: number): number;
-export declare function resolveRetryDelay<E>(retryDelay: number | RetryDelayFn<E> | undefined, attempt: number, err: E, defaultBaseDelay: number): number;
+export declare function resolveRetryDelay<E>(retryDelay: number | RetryDelayFn<E> | undefined, attempt: number, err: E, defaultBaseDelay: number, backoffStrategy?: BackoffStrategy, maxDelay?: number): number;
 export declare function applyJitter(delay: number, jitter: Jitter | undefined): number;
+export declare function computeBackoffDelay(strategy: BackoffStrategy, base: number, attempt: number): number;
 //# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEpD,eAAO,MAAM,KAAK,GAAI,IAAI,MAAM,qBACmB,CAAC;AAEpD,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,UAExD;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,UAAU,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,EAChD,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,CAAC,EACN,gBAAgB,EAAE,MAAM,GACvB,MAAM,CAIR;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CA4B7E"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAErE,eAAO,MAAM,KAAK,GAAI,IAAI,MAAM,qBACmB,CAAC;AAEpD,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,UAExD;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,UAAU,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,EAChD,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,CAAC,EACN,gBAAgB,EAAE,MAAM,EACxB,eAAe,CAAC,EAAE,eAAe,EACjC,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAkBR;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CA4B7E;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,eAAe,EACzB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,MAAM,CAqBR"}

package/dist/utils.js

@@ -2,12 +2,17 @@ export const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 export function clamp(n, min, max) {
     return Math.max(min, Math.min(max, n));
 }
-export function resolveRetryDelay(retryDelay, attempt, err, defaultBaseDelay) {
-    if (typeof retryDelay === "function")
-        return retryDelay(attempt, err);
-    if (typeof retryDelay === "number")
-        return retryDelay;
-    return defaultBaseDelay;
+export function resolveRetryDelay(retryDelay, attempt, err, defaultBaseDelay, backoffStrategy, maxDelay) {
+    let base = typeof retryDelay === "function"
+        ? retryDelay(attempt, err)
+        : typeof retryDelay === "number"
+            ? retryDelay
+            : typeof retryDelay === "undefined"
+                ? defaultBaseDelay
+                : defaultBaseDelay;
+    const backoff = computeBackoffDelay(backoffStrategy ?? "linear", base, attempt);
+    const out = maxDelay != null ? clamp(backoff, 0, maxDelay) : backoff;
+    return Number.isFinite(out) ? out : 0;
 }
 export function applyJitter(delay, jitter) {
     if (delay <= 0 || !jitter)
@@ -31,4 +36,29 @@ export function applyJitter(delay, jitter) {
     // full jitter
     return rng() * delay * (1 + r);
 }
+export function computeBackoffDelay(strategy, base, attempt) {
+    if (typeof strategy === "function") {
+        const v = strategy(attempt);
+        return v >= 0 ? v : 0;
+    }
+    const b = base >= 0 ? base : 0;
+    const a = attempt >= 1 ? attempt : 1;
+    if (strategy === "linear")
+        return b;
+    if (strategy === "exponential")
+        return b * Math.pow(2, a - 1);
+    if (strategy === "fibonacci") {
+        if (a <= 2)
+            return b;
+        let prev = 1;
+        let curr = 1;
+        for (let i = 3; i <= a; i++) {
+            const next = prev + curr;
+            prev = curr;
+            curr = next;
+        }
+        return b * curr;
+    }
+    return b;
+}
 //# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,EAAE,CAClC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAEpD,MAAM,UAAU,KAAK,CAAC,CAAS,EAAE,GAAW,EAAE,GAAW;IACvD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,UAAgD,EAChD,OAAe,EACf,GAAM,EACN,gBAAwB;IAExB,IAAI,OAAO,UAAU,KAAK,UAAU;QAAE,OAAO,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACtE,IAAI,OAAO,UAAU,KAAK,QAAQ;QAAE,OAAO,UAAU,CAAC;IACtD,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,MAA0B;IACnE,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAExC,MAAM,GAAG,GACP,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;IAEtE,sBAAsB;IACtB,MAAM,KAAK,GACT,OAAO,MAAM,KAAK,QAAQ;QACxB,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,MAAM,KAAK,IAAI;YACjB,CAAC,CAAC,GAAG;YACL,CAAC,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,IAAI,IAAI;gBACpD,CAAC,CAAC,MAAM,CAAC,KAAK;gBACd,CAAC,CAAC,GAAG,CAAC;IAEV,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAE7B,MAAM,IAAI,GAAG,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;IAE9E,qEAAqE;IACrE,4CAA4C;IAC5C,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,OAAO,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,KAAK,GAAG,CAAC,CAAC;IAC7C,CAAC;IAED,cAAc;IACd,OAAO,GAAG,EAAE,GAAG,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACjC,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "runtry",
-  "version": "0.8.2",
+  "version": "0.9.0",
   "description": "Run async functions and return a typed Result instead of throwing.",
   "type": "module",
   "main": "./dist/index.js",
@@ -19,14 +19,19 @@
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
     "test": "bun test",
+    "docs:dev": "cd docs && mintlify dev",
+    "docs:dev:es": "cd docs && mintlify dev --config mint.es.json",
+    "docs:build": "cd docs && mintlify build",
+    "docs:preview": "cd docs && mintlify preview",
     "prepublishOnly": "npm run build"
   },
   "devDependencies": {
     "@types/bun": "latest",
-    "typescript": "^5.0.0"
+    "typescript": "^5.0.0",
+    "mint": "latest"
   },
   "license": "MIT",
-  "homepage": "https://github.com/sebasxsala/runtry#readme",
+  "homepage": "https://runtry.sebastian-sala-tech.workers.dev/",
   "bugs": "https://github.com/sebasxsala/runtry/issues",
   "author": {
     "name": "sebasxsala",