runtry 0.8.1 → 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/core.d.ts

@@ -1,41 +1,20 @@
 import type { AppError, Rule } from "./types";
-/**
- * AbortError (AbortController, fetch abort, etc)
- */
-export declare const abort: () => Rule<AppError<"ABORTED">>;
-/**
- * Timeout errors (AbortSignal.timeout, libs, etc)
- */
-export declare const timeout: () => Rule<AppError<"TIMEOUT">>;
-/**
- * HTTP-like errors (status / statusCode)
- */
-export declare const httpStatus: () => Rule<AppError<"HTTP">>;
-/**
- * AggregateError (Promise.any, etc)
- */
-export declare const aggregate: () => Rule<AppError<"UNKNOWN", {
+export declare const abort: Rule<AppError<"ABORTED">>;
+export declare const timeout: Rule<AppError<"TIMEOUT">>;
+export declare const httpStatus: Rule<AppError<"HTTP">>;
+export declare const aggregate: Rule<AppError<"UNKNOWN", {
     errors: unknown[];
 }>>;
-/**
- * String thrown errors
- */
-export declare const string: () => Rule<AppError<"UNKNOWN">>;
-/**
- * Message-like objects (final fallback)
- */
-export declare const message: () => Rule<AppError<"UNKNOWN">>;
-/**
- * Namespace export
- */
+export declare const string: Rule<AppError<"UNKNOWN">>;
+export declare const message: Rule<AppError<"UNKNOWN">>;
 export declare const rules: {
-    abort: () => Rule<AppError<"ABORTED">>;
-    timeout: () => Rule<AppError<"TIMEOUT">>;
-    httpStatus: () => Rule<AppError<"HTTP">>;
-    aggregate: () => Rule<AppError<"UNKNOWN", {
+    abort: Rule<AppError<"ABORTED">>;
+    timeout: Rule<AppError<"TIMEOUT">>;
+    httpStatus: Rule<AppError<"HTTP">>;
+    aggregate: Rule<AppError<"UNKNOWN", {
         errors: unknown[];
     }>>;
-    string: () => Rule<AppError<"UNKNOWN">>;
-    message: () => Rule<AppError<"UNKNOWN">>;
+    string: Rule<AppError<"UNKNOWN">>;
+    message: Rule<AppError<"UNKNOWN">>;
 };
 //# sourceMappingURL=core.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/error/core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE9C;;GAEG;AACH,eAAO,MAAM,KAAK,QAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAchD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,QAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAclD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,QAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAclD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,QAChB,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE;IAAE,MAAM,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC,CAalD,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,MAAM,QAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAKjD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,QAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAclD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,KAAK;iBAzGO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;mBAmBvB,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;sBAmBtB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;qBAoB9C,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE;QAAE,MAAM,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC,CAAC;kBAkB5B,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;mBAUxB,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;CA0BnD,CAAC"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/error/core.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE9C,eAAO,MAAM,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAY3C,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAY7C,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAa7C,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE;IAAE,MAAM,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC,CAYtE,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAK5C,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAU7C,CAAC;AAEF,eAAO,MAAM,KAAK;;;;;gBAjCyC,OAAO,EAAE;;;;CAwC1B,CAAC"}

package/dist/error/core.js

@@ -1,7 +1,6 @@
-/**
- * AbortError (AbortController, fetch abort, etc)
- */
-export const abort = () => (err) => {
+import { createRunner } from "../runner/runner";
+import { errorRule } from "./builder";
+export const abort = (err) => {
     if (err instanceof DOMException && err.name === "AbortError") {
         return { code: "ABORTED", message: "Request cancelled", cause: err };
     }
@@ -14,10 +13,7 @@ export const abort = () => (err) => {
     }
     return null;
 };
-/**
- * Timeout errors (AbortSignal.timeout, libs, etc)
- */
-export const timeout = () => (err) => {
+export const timeout = (err) => {
     if (err instanceof DOMException && err.name === "TimeoutError") {
         return { code: "TIMEOUT", message: "Request timed out", cause: err };
     }
@@ -30,10 +26,7 @@ export const timeout = () => (err) => {
     }
     return null;
 };
-/**
- * HTTP-like errors (status / statusCode)
- */
-export const httpStatus = () => (err) => {
+export const httpStatus = (err) => {
     if (typeof err === "object" && err !== null) {
         const status = err.status ?? err.statusCode;
         if (typeof status === "number") {
@@ -47,12 +40,8 @@ export const httpStatus = () => (err) => {
     }
     return null;
 };
-/**
- * AggregateError (Promise.any, etc)
- */
-export const aggregate = () => (err) => {
-    if (typeof AggregateError !== "undefined" &&
-        err instanceof AggregateError) {
+export const aggregate = (err) => {
+    if (typeof AggregateError !== "undefined" && err instanceof AggregateError) {
         return {
             code: "UNKNOWN",
             message: err.message || "Multiple errors occurred",
@@ -62,34 +51,21 @@ export const aggregate = () => (err) => {
     }
     return null;
 };
-/**
- * String thrown errors
- */
-export const string = () => (err) => {
+export const string = (err) => {
     if (typeof err === "string") {
         return { code: "UNKNOWN", message: err, cause: err };
     }
     return null;
 };
-/**
- * Message-like objects (final fallback)
- */
-export const message = () => (err) => {
+export const message = (err) => {
     if (typeof err === "object" &&
         err !== null &&
         "message" in err &&
         typeof err.message === "string") {
-        return {
-            code: "UNKNOWN",
-            message: err.message,
-            cause: err,
-        };
+        return { code: "UNKNOWN", message: err.message, cause: err };
     }
     return null;
 };
-/**
- * Namespace export
- */
 export const rules = {
     abort,
     timeout,

package/dist/error/core.js.map

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

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/error/types.d.ts

@@ -17,7 +17,7 @@ export type AppError<Code extends string = AppErrorCode | (string & {}), Meta =
 };
 type NonNull<T> = T extends null ? never : T;
 type RuleReturn<R> = R extends (err: unknown) => infer Out ? NonNull<Out> : never;
-export type InferErrorFromRules<TRules extends readonly Rule<any>[]> = TRules extends readonly [] ? AppError : RuleReturn<TRules[number]>;
+export type InferErrorFromRules<TRules extends readonly Rule<any>[]> = TRules extends readonly [] ? AppError : RuleReturn<TRules[number]> | AppError<"UNKNOWN">;
 export type Rule<E extends AppError = AppError> = (err: unknown) => E | null;
 export {};
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/error/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,SAAS,GACT,SAAS,GACT,YAAY,GACZ,MAAM,GACN,SAAS,CAAC;AAEd;;;;;;;;GAQG;AACH,MAAM,MAAM,QAAQ,CAClB,IAAI,SAAS,MAAM,GAAG,YAAY,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,EAClD,IAAI,GAAG,OAAO,IACZ;IACF,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,KAAK,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,GAAG,KAAK,GAAG,CAAC,CAAC;AAC7C,KAAK,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,GAAG,GACtD,OAAO,CAAC,GAAG,CAAC,GACZ,KAAK,CAAC;AACV,MAAM,MAAM,mBAAmB,CAAC,MAAM,SAAS,SAAS,IAAI,CAAC,GAAG,CAAC,EAAE,IACjE,MAAM,SAAS,SAAS,EAAE,GAAG,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;AACrE,MAAM,MAAM,IAAI,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ,IAAI,CAAC,GAAG,EAAE,OAAO,KAAK,CAAC,GAAG,IAAI,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/error/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,SAAS,GACT,SAAS,GACT,YAAY,GACZ,MAAM,GACN,SAAS,CAAC;AAEd;;;;;;;;GAQG;AACH,MAAM,MAAM,QAAQ,CAClB,IAAI,SAAS,MAAM,GAAG,YAAY,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,EAClD,IAAI,GAAG,OAAO,IACZ;IACF,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,KAAK,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,GAAG,KAAK,GAAG,CAAC,CAAC;AAC7C,KAAK,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,GAAG,GACtD,OAAO,CAAC,GAAG,CAAC,GACZ,KAAK,CAAC;AACV,MAAM,MAAM,mBAAmB,CAAC,MAAM,SAAS,SAAS,IAAI,CAAC,GAAG,CAAC,EAAE,IACjE,MAAM,SAAS,SAAS,EAAE,GACtB,QAAQ,GACR,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;AACvD,MAAM,MAAM,IAAI,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ,IAAI,CAAC,GAAG,EAAE,OAAO,KAAK,CAAC,GAAG,IAAI,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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"}