@rohan9024/retrykit 0.1.0 → 0.2.0

package/README.md

@@ -1,8 +1,24 @@
+
 # @rohan9024/retrykit ⚡
 
-> Zero-dependency, header-aware retry wrapper tailored for LLM APIs and fetch.
+> A zero-dependency, header-aware retry engine and circuit breaker built for reliable LLM API integrations.
+
+[![npm version](https://img.shields.io/npm/v/@rohan9024/retrykit.svg)](https://www.npmjs.com/package/@rohan9024/retrykit)
+[![license](https://img.shields.io/npm/l/@rohan9024/retrykit.svg)](https://github.com/rohan9024/retrykit)
+[![bundle size](https://img.shields.io/bundlephobia/min/@rohan9024/retrykit)](https://bundlephobia.com/package/@rohan9024/retrykit)
+
+**RetryKit** helps developers build resilient applications powered by LLM APIs such as OpenAI, Anthropic, DeepSeek, Groq, and Mistral.
 
-Automatically handles `429 Too Many Requests` by parsing rate-limit headers from OpenAI, Anthropic, and Groq before falling back to exponential backoff with full jitter.
+Unlike basic retry libraries such as `p-retry` or `tenacity`, RetryKit understands provider-specific rate-limit headers and uses that information to schedule smarter retries.
+
+### Why RetryKit?
+
+- **Header-aware retries:** Parses provider-specific rate-limit reset headers.
+- **Exponential backoff with jitter:** Prevents synchronized retry storms.
+- **SSE stream resilience:** Handles mid-stream connection interruptions.
+- **Circuit breaker:** Prevents cascading failures during provider outages.
+- **Timeout protection:** Supports per-attempt request timeouts.
+- **Zero dependencies:** Lightweight and dependency-free.
 
 ---
 
@@ -14,40 +30,47 @@ npm install @rohan9024/retrykit
 
 ---
 
-## 🚀 Usage
+## 🚀 Quick Start
 
-### 1. Drop-in Replacement for `fetch` (`retryFetch`)
+### 1. Drop-in Fetch Replacement (`retryFetch`)
 
-`retryFetch` works exactly like standard `fetch`, but automatically handles retries and honors rate-limit headers:
+Use `retryFetch` just like standard `fetch`, with automatic retries and rate-limit awareness.
 
 ```typescript
 import { retryFetch } from '@rohan9024/retrykit';
 
-const response = await retryFetch('https://api.openai.com/v1/chat/completions', {
-  method: 'POST',
-  headers: {
-    'Authorization': `Bearer ${process.env.OPENAI_API_KEY}`,
-    'Content-Type': 'application/json',
-  },
-  body: JSON.stringify({
-    model: 'gpt-4o',
-    messages: [{ role: 'user', content: 'Say hello!' }],
-  }),
-}, {
-  retries: 3,
-  onRetry: (error, attempt, delayMs) => {
-    console.warn(`Retry attempt #${attempt} after ${delayMs}ms delay...`);
+const response = await retryFetch(
+  'https://api.openai.com/v1/chat/completions',
+  {
+    method: 'POST',
+    headers: {
+      Authorization: `Bearer ${process.env.OPENAI_API_KEY}`,
+      'Content-Type': 'application/json',
+    },
+    body: JSON.stringify({
+      model: 'gpt-4o',
+      messages: [
+        { role: 'user', content: 'Say hello!' }
+      ],
+    }),
   },
-});
+  {
+    retries: 4,
+    timeoutMs: 15000,
+    onRetry: (error, attempt, delayMs) => {
+      console.warn(
+        `Retry #${attempt}: Waiting ${delayMs}ms...`
+      );
+    },
+  }
+);
 
 const data = await response.json();
 ```
 
----
-
 ### 2. Wrap Official SDKs (`retry`)
 
-Wrap calls from the official OpenAI, Anthropic, or Mistral client libraries:
+Use RetryKit with existing SDKs such as OpenAI, Anthropic, Mistral, or Google.
 
 ```typescript
 import OpenAI from 'openai';
@@ -55,43 +78,113 @@ import { retry } from '@rohan9024/retrykit';
 
 const openai = new OpenAI();
 
-const completion = await retry(() =>
-  openai.chat.completions.create({
-    model: 'gpt-4o',
-    messages: [{ role: 'user', content: 'Write a haiku' }],
-  }),
+const completion = await retry(
+  () =>
+    openai.chat.completions.create({
+      model: 'gpt-4o',
+      messages: [
+        {
+          role: 'user',
+          content: 'Write a poem about resilience',
+        },
+      ],
+    }),
   {
-    retries: 4,
+    retries: 3,
     baseDelayMs: 500,
   }
 );
 ```
 
+### 3. Resilient Token Streaming (`retryStream`)
+
+LLM streaming connections can fail midway through generation. `retryStream` helps recover from interrupted streams.
+
+```typescript
+import { retryStream } from '@rohan9024/retrykit';
+
+async function* tokenGenerator() {
+  const stream = await fetchLLMStream();
+
+  for await (const chunk of stream) {
+    yield chunk;
+  }
+}
+
+for await (const chunk of retryStream(() => tokenGenerator())) {
+  process.stdout.write(chunk);
+}
+```
+
+### 4. Circuit Breaker
+
+Protect your application from cascading failures and unnecessary requests when an AI provider experiences an outage.
+
+```typescript
+import { CircuitBreaker } from '@rohan9024/retrykit';
+
+const breaker = new CircuitBreaker({
+  failureThreshold: 3,
+  resetTimeoutMs: 30000,
+
+  onStateChange: (from, to) => {
+    console.log(`Circuit changed: ${from} -> ${to}`);
+  },
+});
+
+// Fails fast when the circuit is open
+const result = await breaker.execute(() => callUnstableAPI());
+```
+
 ---
 
-## 🧠 Provider Header Awareness
+## 🧠 Supported Provider Headers
 
-`retrykit` inspects and obeys the following provider headers before falling back to exponential backoff:
+RetryKit automatically extracts retry timing information from commonly used API rate-limit headers.
 
-- `retry-after` (RFC 1123 HTTP Dates or relative seconds)
-- `x-ratelimit-reset-requests` (OpenAI format, e.g., `"15s"`, `"600ms"`)
-- `x-ratelimit-reset-tokens` (Anthropic format)
+| Provider | Supported Headers |
+|---|---|
+| OpenAI | `x-ratelimit-reset-requests`, `x-ratelimit-reset-tokens`, `retry-after` |
+| Anthropic | `anthropic-ratelimit-requests-reset`, `anthropic-ratelimit-tokens-reset`, `retry-after` |
+| Groq / DeepSeek | `x-ratelimit-reset-total`, `retry-after-ms`, `retry-after` |
+| Standard HTTP | `Retry-After` (integer seconds or RFC 1123 HTTP dates) |
 
 ---
 
-## ⚙️ Options Reference
+## ⚙️ Configuration Options
+
+RetryKit provides configurable retry behavior.
 
 | Option | Type | Default | Description |
-| :--- | :--- | :--- | :--- |
-| `retries` | `number` | `3` | Max retry attempts before failing |
-| `baseDelayMs` | `number` | `500` | Starting backoff delay in ms |
-| `maxDelayMs` | `number` | `30000` | Ceiling delay cap in ms |
-| `retryOnStatus`| `number[]` | `[408, 429, 500, 502, 503, 504]` | HTTP status codes that trigger a retry |
-| `onRetry` | `(err, attempt, delay) => void` | `undefined` | Hook called before every sleep |
-| `signal` | `AbortSignal` | `undefined` | Immediate cancellation controller |
+|---|---|---|---|
+| `retries` | `number` | `3` | Maximum retry attempts before failing |
+| `baseDelayMs` | `number` | `500` | Initial backoff delay in milliseconds |
+| `maxDelayMs` | `number` | `30000` | Maximum backoff delay |
+| `timeoutMs` | `number` | `undefined` | Per-attempt timeout in milliseconds |
+| `retryOnStatus` | `number[]` | `[408, 429, 500, 502, 503, 504]` | HTTP status codes that trigger retries |
+| `shouldRetry` | `(err, attempt) => boolean` | `undefined` | Custom retry decision logic |
+| `onRetry` | `(err, attempt, delay) => void` | `undefined` | Callback executed before each retry |
+| `signal` | `AbortSignal` | `undefined` | Abort signal for immediate cancellation |
+
+---
+
+## 🛡️ Designed For
+
+- LLM-powered applications
+- AI agents and autonomous workflows
+- RAG pipelines
+- High-volume API integrations
+- Streaming chat applications
+- Production AI infrastructure
 
 ---
 
 ## 📄 License
 
-MIT
+MIT © [rohan9024](https://github.com/rohan9024)
+
+---
+
+<p align="center">
+  Built for developers who want their AI applications to be resilient. ⚡
+</p>

package/dist/index.d.mts

@@ -5,19 +5,61 @@ interface RetryOptions {
     baseDelayMs?: number;
     /** Maximum backoff ceiling delay in milliseconds. Default: 30000 */
     maxDelayMs?: number;
+    /** Per-request timeout in milliseconds. Default: undefined */
+    timeoutMs?: number;
     /** HTTP status codes that trigger a retry. Default: [408, 429, 500, 502, 503, 504] */
     retryOnStatus?: number[];
-    /** Optional callback fired on every retry attempt before sleep */
+    /** Custom condition to decide whether to retry */
+    shouldRetry?: (error: unknown, attempt: number) => boolean;
+    /** Optional callback fired before every retry sleep */
     onRetry?: (error: unknown, attempt: number, delayMs: number) => void;
     /** AbortSignal for immediate cancellation */
     signal?: AbortSignal;
 }
+interface CircuitBreakerOptions {
+    /** Number of consecutive failures before opening the circuit. Default: 5 */
+    failureThreshold?: number;
+    /** Time in milliseconds to wait before attempting recovery (HALF_OPEN). Default: 30000 */
+    resetTimeoutMs?: number;
+    /** Optional callback triggered on circuit state changes */
+    onStateChange?: (from: CircuitState, to: CircuitState) => void;
+}
+type CircuitState = 'CLOSED' | 'OPEN' | 'HALF_OPEN';
 type HeaderSource = Headers | Record<string, string | string[] | undefined> | [string, string][] | undefined;
 
 declare function retryFetch(url: string | URL | Request, init?: RequestInit, options?: RetryOptions): Promise<Response>;
 
 declare function retry<T>(fn: (attempt: number) => Promise<T>, options?: RetryOptions): Promise<T>;
 
+/**
+ * Resilient wrapper for Server-Sent Events / LLM chunk streams.
+ * If the streaming connection drops mid-generation, it retries and resumes.
+ */
+declare function retryStream<T>(streamFactory: (attempt: number) => Promise<AsyncIterable<T>>, options?: RetryOptions): AsyncGenerator<T, void, unknown>;
+
+declare class CircuitBreakerOpenError extends Error {
+    constructor(message?: string);
+}
+/**
+ * Zero-dependency Circuit Breaker implementation to stop cascading failure
+ * cascades when downstream LLM APIs experience total outages.
+ */
+declare class CircuitBreaker {
+    private state;
+    private failureCount;
+    private lastFailureTime;
+    private readonly failureThreshold;
+    private readonly resetTimeoutMs;
+    private readonly onStateChange?;
+    constructor(options?: CircuitBreakerOptions);
+    getState(): CircuitState;
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    private recordSuccess;
+    private recordFailure;
+    private transitionTo;
+    reset(): void;
+}
+
 declare const DEFAULT_RETRYABLE_STATUS_CODES: number[];
 /**
  * Calculates exponential backoff with full jitter:
@@ -29,19 +71,20 @@ declare function computeJitterDelay(attempt: number, baseDelayMs?: number, maxDe
  */
 declare function parseDurationToMs(value: string): number | null;
 /**
- * Inspects rate-limiting headers and extracts sleep delay in milliseconds:
- * - retry-after (seconds or HTTP date)
- * - x-ratelimit-reset-requests (OpenAI format)
- * - x-ratelimit-reset-tokens (Anthropic format)
+ * Exhaustively checks provider headers across:
+ * - RFC 7231 / RFC 6585 standard `retry-after`
+ * - OpenAI: `x-ratelimit-reset-requests`, `x-ratelimit-reset-tokens`
+ * - Anthropic: `anthropic-ratelimit-requests-reset`, `anthropic-ratelimit-tokens-reset`
+ * - Groq / DeepSeek / Mistral: `x-ratelimit-reset-total`, `retry-after-ms`
  */
 declare function parseRateLimitDelay(headers: HeaderSource): number | null;
 /**
- * Detects transient network drop errors.
+ * Detects transient network drop errors across Node, Bun, Deno, and browsers.
  */
 declare function isTransientNetworkError(error: unknown): boolean;
 /**
- * Sleep helper respecting AbortSignal cancellation.
+ * Promisified sleep that respects AbortSignal cancellation.
  */
 declare function sleep(ms: number, signal?: AbortSignal): Promise<void>;
 
-export { DEFAULT_RETRYABLE_STATUS_CODES, type HeaderSource, type RetryOptions, computeJitterDelay, isTransientNetworkError, parseDurationToMs, parseRateLimitDelay, retry, retryFetch, sleep };
+export { CircuitBreaker, CircuitBreakerOpenError, type CircuitBreakerOptions, type CircuitState, DEFAULT_RETRYABLE_STATUS_CODES, type HeaderSource, type RetryOptions, computeJitterDelay, isTransientNetworkError, parseDurationToMs, parseRateLimitDelay, retry, retryFetch, retryStream, sleep };

package/dist/index.d.ts

@@ -5,19 +5,61 @@ interface RetryOptions {
     baseDelayMs?: number;
     /** Maximum backoff ceiling delay in milliseconds. Default: 30000 */
     maxDelayMs?: number;
+    /** Per-request timeout in milliseconds. Default: undefined */
+    timeoutMs?: number;
     /** HTTP status codes that trigger a retry. Default: [408, 429, 500, 502, 503, 504] */
     retryOnStatus?: number[];
-    /** Optional callback fired on every retry attempt before sleep */
+    /** Custom condition to decide whether to retry */
+    shouldRetry?: (error: unknown, attempt: number) => boolean;
+    /** Optional callback fired before every retry sleep */
     onRetry?: (error: unknown, attempt: number, delayMs: number) => void;
     /** AbortSignal for immediate cancellation */
     signal?: AbortSignal;
 }
+interface CircuitBreakerOptions {
+    /** Number of consecutive failures before opening the circuit. Default: 5 */
+    failureThreshold?: number;
+    /** Time in milliseconds to wait before attempting recovery (HALF_OPEN). Default: 30000 */
+    resetTimeoutMs?: number;
+    /** Optional callback triggered on circuit state changes */
+    onStateChange?: (from: CircuitState, to: CircuitState) => void;
+}
+type CircuitState = 'CLOSED' | 'OPEN' | 'HALF_OPEN';
 type HeaderSource = Headers | Record<string, string | string[] | undefined> | [string, string][] | undefined;
 
 declare function retryFetch(url: string | URL | Request, init?: RequestInit, options?: RetryOptions): Promise<Response>;
 
 declare function retry<T>(fn: (attempt: number) => Promise<T>, options?: RetryOptions): Promise<T>;
 
+/**
+ * Resilient wrapper for Server-Sent Events / LLM chunk streams.
+ * If the streaming connection drops mid-generation, it retries and resumes.
+ */
+declare function retryStream<T>(streamFactory: (attempt: number) => Promise<AsyncIterable<T>>, options?: RetryOptions): AsyncGenerator<T, void, unknown>;
+
+declare class CircuitBreakerOpenError extends Error {
+    constructor(message?: string);
+}
+/**
+ * Zero-dependency Circuit Breaker implementation to stop cascading failure
+ * cascades when downstream LLM APIs experience total outages.
+ */
+declare class CircuitBreaker {
+    private state;
+    private failureCount;
+    private lastFailureTime;
+    private readonly failureThreshold;
+    private readonly resetTimeoutMs;
+    private readonly onStateChange?;
+    constructor(options?: CircuitBreakerOptions);
+    getState(): CircuitState;
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    private recordSuccess;
+    private recordFailure;
+    private transitionTo;
+    reset(): void;
+}
+
 declare const DEFAULT_RETRYABLE_STATUS_CODES: number[];
 /**
  * Calculates exponential backoff with full jitter:
@@ -29,19 +71,20 @@ declare function computeJitterDelay(attempt: number, baseDelayMs?: number, maxDe
  */
 declare function parseDurationToMs(value: string): number | null;
 /**
- * Inspects rate-limiting headers and extracts sleep delay in milliseconds:
- * - retry-after (seconds or HTTP date)
- * - x-ratelimit-reset-requests (OpenAI format)
- * - x-ratelimit-reset-tokens (Anthropic format)
+ * Exhaustively checks provider headers across:
+ * - RFC 7231 / RFC 6585 standard `retry-after`
+ * - OpenAI: `x-ratelimit-reset-requests`, `x-ratelimit-reset-tokens`
+ * - Anthropic: `anthropic-ratelimit-requests-reset`, `anthropic-ratelimit-tokens-reset`
+ * - Groq / DeepSeek / Mistral: `x-ratelimit-reset-total`, `retry-after-ms`
  */
 declare function parseRateLimitDelay(headers: HeaderSource): number | null;
 /**
- * Detects transient network drop errors.
+ * Detects transient network drop errors across Node, Bun, Deno, and browsers.
  */
 declare function isTransientNetworkError(error: unknown): boolean;
 /**
- * Sleep helper respecting AbortSignal cancellation.
+ * Promisified sleep that respects AbortSignal cancellation.
  */
 declare function sleep(ms: number, signal?: AbortSignal): Promise<void>;
 
-export { DEFAULT_RETRYABLE_STATUS_CODES, type HeaderSource, type RetryOptions, computeJitterDelay, isTransientNetworkError, parseDurationToMs, parseRateLimitDelay, retry, retryFetch, sleep };
+export { CircuitBreaker, CircuitBreakerOpenError, type CircuitBreakerOptions, type CircuitState, DEFAULT_RETRYABLE_STATUS_CODES, type HeaderSource, type RetryOptions, computeJitterDelay, isTransientNetworkError, parseDurationToMs, parseRateLimitDelay, retry, retryFetch, retryStream, sleep };

package/dist/index.js

@@ -20,6 +20,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  CircuitBreaker: () => CircuitBreaker,
+  CircuitBreakerOpenError: () => CircuitBreakerOpenError,
   DEFAULT_RETRYABLE_STATUS_CODES: () => DEFAULT_RETRYABLE_STATUS_CODES,
   computeJitterDelay: () => computeJitterDelay,
   isTransientNetworkError: () => isTransientNetworkError,
@@ -27,6 +29,7 @@ __export(index_exports, {
   parseRateLimitDelay: () => parseRateLimitDelay,
   retry: () => retry,
   retryFetch: () => retryFetch,
+  retryStream: () => retryStream,
   sleep: () => sleep
 });
 module.exports = __toCommonJS(index_exports);
@@ -100,6 +103,11 @@ function parseDurationToMs(value) {
 }
 function parseRateLimitDelay(headers) {
   if (!headers) return null;
+  const retryAfterMs = getHeader(headers, "retry-after-ms");
+  if (retryAfterMs) {
+    const parsed = parseFloat(retryAfterMs);
+    if (!isNaN(parsed)) return Math.max(0, Math.floor(parsed));
+  }
   const retryAfter = getHeader(headers, "retry-after");
   if (retryAfter) {
     if (/^\d+(\.\d+)?$/.test(retryAfter.trim())) {
@@ -111,15 +119,23 @@ function parseRateLimitDelay(headers) {
       return Math.max(0, parsedDate - Date.now());
     }
   }
-  const openaiReset = getHeader(headers, "x-ratelimit-reset-requests");
-  if (openaiReset) {
-    const durationMs = parseDurationToMs(openaiReset);
-    if (durationMs !== null) return durationMs;
-  }
-  const anthropicReset = getHeader(headers, "x-ratelimit-reset-tokens");
-  if (anthropicReset) {
-    const durationMs = parseDurationToMs(anthropicReset);
-    if (durationMs !== null) return durationMs;
+  const candidateKeys = [
+    "x-ratelimit-reset-requests",
+    "x-ratelimit-reset-tokens",
+    "anthropic-ratelimit-requests-reset",
+    "anthropic-ratelimit-tokens-reset",
+    "x-ratelimit-reset-total"
+  ];
+  for (const key of candidateKeys) {
+    const raw = getHeader(headers, key);
+    if (raw) {
+      const ms = parseDurationToMs(raw);
+      if (ms !== null) return ms;
+      const epochSec = parseFloat(raw);
+      if (!isNaN(epochSec) && epochSec > 1e9) {
+        return Math.max(0, Math.floor(epochSec * 1e3 - Date.now()));
+      }
+    }
   }
   return null;
 }
@@ -128,9 +144,17 @@ function isTransientNetworkError(error) {
   const msg = error.message.toLowerCase();
   const code = error.code;
   if (error.name === "TypeError" && msg.includes("fetch failed")) return true;
-  const transientCodes = ["ECONNRESET", "ETIMEDOUT", "ENOTFOUND", "EAI_AGAIN", "ECONNREFUSED"];
+  const transientCodes = [
+    "ECONNRESET",
+    "ETIMEDOUT",
+    "ENOTFOUND",
+    "EAI_AGAIN",
+    "ECONNREFUSED",
+    "UND_ERR_CONNECT_TIMEOUT",
+    "UND_ERR_SOCKET"
+  ];
   if (code && transientCodes.includes(code)) return true;
-  return msg.includes("network error") || msg.includes("socket hang up") || msg.includes("timeout");
+  return msg.includes("network error") || msg.includes("socket hang up") || msg.includes("terminated") || msg.includes("econnreset");
 }
 function sleep(ms, signal) {
   return new Promise((resolve, reject) => {
@@ -155,7 +179,9 @@ async function retryFetch(url, init, options = {}) {
     retries = 3,
     baseDelayMs = 500,
     maxDelayMs = 3e4,
+    timeoutMs,
     retryOnStatus = DEFAULT_RETRYABLE_STATUS_CODES,
+    shouldRetry,
     onRetry,
     signal
   } = options;
@@ -164,12 +190,25 @@ async function retryFetch(url, init, options = {}) {
     if (signal?.aborted) {
       throw signal.reason ?? new DOMException("The operation was aborted.", "AbortError");
     }
+    const attemptController = new AbortController();
+    let timeoutId;
+    if (timeoutMs && timeoutMs > 0) {
+      timeoutId = setTimeout(() => {
+        attemptController.abort(new DOMException(`Request timed out after ${timeoutMs}ms`, "TimeoutError"));
+      }, timeoutMs);
+    }
+    const abortHandler = () => attemptController.abort(signal?.reason);
+    signal?.addEventListener("abort", abortHandler, { once: true });
     try {
       const response = await fetch(url, {
         ...init,
-        signal: signal ?? init?.signal
+        signal: attemptController.signal
       });
-      if (retryOnStatus.includes(response.status) && attempt < retries) {
+      if (timeoutId) clearTimeout(timeoutId);
+      signal?.removeEventListener("abort", abortHandler);
+      const isStatusRetryable = retryOnStatus.includes(response.status);
+      const customRetry = shouldRetry ? shouldRetry(response, attempt) : isStatusRetryable;
+      if (customRetry && attempt < retries) {
         const headerDelay = parseRateLimitDelay(response.headers);
         const backoffDelay = computeJitterDelay(attempt, baseDelayMs, maxDelayMs);
         const chosenDelay = Math.min(maxDelayMs, headerDelay ?? backoffDelay);
@@ -180,10 +219,15 @@ async function retryFetch(url, init, options = {}) {
       }
       return response;
     } catch (error) {
-      if (signal?.aborted || error instanceof Error && error.name === "AbortError") {
-        throw error;
+      if (timeoutId) clearTimeout(timeoutId);
+      signal?.removeEventListener("abort", abortHandler);
+      if (signal?.aborted) {
+        throw signal.reason ?? error;
       }
-      if (isTransientNetworkError(error) && attempt < retries) {
+      const isTimeout = error instanceof Error && error.name === "TimeoutError";
+      const isNetworkDrop = isTransientNetworkError(error);
+      const customRetry = shouldRetry ? shouldRetry(error, attempt) : isNetworkDrop || isTimeout;
+      if (customRetry && attempt < retries) {
         const chosenDelay = computeJitterDelay(attempt, baseDelayMs, maxDelayMs);
         onRetry?.(error, attempt + 1, chosenDelay);
         await sleep(chosenDelay, signal);
@@ -202,6 +246,7 @@ async function retry(fn, options = {}) {
     baseDelayMs = 500,
     maxDelayMs = 3e4,
     retryOnStatus = DEFAULT_RETRYABLE_STATUS_CODES,
+    shouldRetry,
     onRetry,
     signal
   } = options;
@@ -224,7 +269,8 @@ async function retry(fn, options = {}) {
       const headers = err?.headers ?? err?.response?.headers;
       const isStatusRetryable = statusCode !== void 0 && retryOnStatus.includes(statusCode);
       const isNetworkRetryable = isTransientNetworkError(error);
-      if (!isStatusRetryable && !isNetworkRetryable) {
+      const customRetry = shouldRetry ? shouldRetry(error, attempt) : isStatusRetryable || isNetworkRetryable;
+      if (!customRetry) {
         throw error;
       }
       let chosenDelay;
@@ -240,8 +286,117 @@ async function retry(fn, options = {}) {
     }
   }
 }
+
+// src/stream.ts
+async function* retryStream(streamFactory, options = {}) {
+  const {
+    retries = 3,
+    baseDelayMs = 500,
+    maxDelayMs = 3e4,
+    onRetry,
+    signal
+  } = options;
+  let attempt = 0;
+  while (true) {
+    if (signal?.aborted) {
+      throw signal.reason ?? new DOMException("The operation was aborted.", "AbortError");
+    }
+    try {
+      const stream = await streamFactory(attempt);
+      for await (const chunk of stream) {
+        if (signal?.aborted) {
+          throw signal.reason ?? new DOMException("The operation was aborted.", "AbortError");
+        }
+        yield chunk;
+      }
+      return;
+    } catch (error) {
+      if (signal?.aborted || error instanceof Error && error.name === "AbortError") {
+        throw error;
+      }
+      if (attempt >= retries) {
+        throw error;
+      }
+      const delay = computeJitterDelay(attempt, baseDelayMs, maxDelayMs);
+      onRetry?.(error, attempt + 1, delay);
+      await sleep(delay, signal);
+      attempt++;
+    }
+  }
+}
+
+// src/circuit-breaker.ts
+var CircuitBreakerOpenError = class extends Error {
+  constructor(message = "Circuit breaker is OPEN. Fast-failing requests.") {
+    super(message);
+    this.name = "CircuitBreakerOpenError";
+  }
+};
+var CircuitBreaker = class {
+  state = "CLOSED";
+  failureCount = 0;
+  lastFailureTime = 0;
+  failureThreshold;
+  resetTimeoutMs;
+  onStateChange;
+  constructor(options = {}) {
+    this.failureThreshold = options.failureThreshold ?? 5;
+    this.resetTimeoutMs = options.resetTimeoutMs ?? 3e4;
+    this.onStateChange = options.onStateChange;
+  }
+  getState() {
+    if (this.state === "OPEN") {
+      const elapsed = Date.now() - this.lastFailureTime;
+      if (elapsed >= this.resetTimeoutMs) {
+        this.transitionTo("HALF_OPEN");
+      }
+    }
+    return this.state;
+  }
+  async execute(fn) {
+    const currentState = this.getState();
+    if (currentState === "OPEN") {
+      throw new CircuitBreakerOpenError();
+    }
+    try {
+      const result = await fn();
+      this.recordSuccess();
+      return result;
+    } catch (error) {
+      this.recordFailure();
+      throw error;
+    }
+  }
+  recordSuccess() {
+    if (this.state === "HALF_OPEN") {
+      this.transitionTo("CLOSED");
+    }
+    this.failureCount = 0;
+  }
+  recordFailure() {
+    this.failureCount++;
+    this.lastFailureTime = Date.now();
+    if (this.state === "HALF_OPEN" || this.failureCount >= this.failureThreshold) {
+      this.transitionTo("OPEN");
+    }
+  }
+  transitionTo(nextState) {
+    const prevState = this.state;
+    if (prevState !== nextState) {
+      this.state = nextState;
+      this.onStateChange?.(prevState, nextState);
+    }
+  }
+  reset() {
+    this.state = "CLOSED";
+    this.failureCount = 0;
+    this.lastFailureTime = 0;
+  }
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  CircuitBreaker,
+  CircuitBreakerOpenError,
   DEFAULT_RETRYABLE_STATUS_CODES,
   computeJitterDelay,
   isTransientNetworkError,
@@ -249,6 +404,7 @@ async function retry(fn, options = {}) {
   parseRateLimitDelay,
   retry,
   retryFetch,
+  retryStream,
   sleep
 });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/engine.ts","../src/fetch.ts","../src/wrap.ts"],"sourcesContent":["export { retryFetch } from './fetch.js';\r\nexport { retry } from './wrap.js';\r\nexport {\r\n  computeJitterDelay,\r\n  parseDurationToMs,\r\n  parseRateLimitDelay,\r\n  isTransientNetworkError,\r\n  sleep,\r\n  DEFAULT_RETRYABLE_STATUS_CODES,\r\n} from './engine.js';\r\nexport type { RetryOptions, HeaderSource } from './types.js';","import { HeaderSource } from './types.js';\r\n\r\nexport const DEFAULT_RETRYABLE_STATUS_CODES = [408, 429, 500, 502, 503, 504];\r\n\r\n/**\r\n * Calculates exponential backoff with full jitter:\r\n * sleepMs = min(maxDelayMs, baseDelayMs * 2 ** attempt) * Math.random()\r\n */\r\nexport function computeJitterDelay(\r\n  attempt: number,\r\n  baseDelayMs: number = 500,\r\n  maxDelayMs: number = 30000\r\n): number {\r\n  const exponential = baseDelayMs * Math.pow(2, attempt);\r\n  const ceiling = Math.min(maxDelayMs, exponential);\r\n  return Math.floor(ceiling * Math.random());\r\n}\r\n\r\n/**\r\n * Safely extracts a header value case-insensitively across Headers, records, or tuples.\r\n */\r\nexport function getHeader(headers: HeaderSource, name: string): string | null {\r\n  if (!headers) return null;\r\n\r\n  const target = name.toLowerCase();\r\n\r\n  // Native Web API Headers\r\n  if (typeof (headers as Headers).get === 'function') {\r\n    return (headers as Headers).get(target);\r\n  }\r\n\r\n  // Array of tuples\r\n  if (Array.isArray(headers)) {\r\n    for (const [key, value] of headers) {\r\n      if (key.toLowerCase() === target) {\r\n        return value;\r\n      }\r\n    }\r\n    return null;\r\n  }\r\n\r\n  // Plain object\r\n  if (typeof headers === 'object') {\r\n    for (const key of Object.keys(headers)) {\r\n      if (key.toLowerCase() === target) {\r\n        const val = (headers as Record<string, unknown>)[key];\r\n        if (Array.isArray(val)) return val[0] ?? null;\r\n        return typeof val === 'string' ? val : String(val);\r\n      }\r\n    }\r\n  }\r\n\r\n  return null;\r\n}\r\n\r\n/**\r\n * Parses duration strings returned by LLM APIs (e.g. \"600ms\", \"10s\", \"2m\", \"1m30s\", \"1.5\").\r\n */\r\nexport function parseDurationToMs(value: string): number | null {\r\n  const trimmed = value.trim();\r\n  if (!trimmed) return null;\r\n\r\n  // Pure numeric string represents seconds\r\n  if (/^\\d+(\\.\\d+)?$/.test(trimmed)) {\r\n    const sec = parseFloat(trimmed);\r\n    return isNaN(sec) ? null : Math.max(0, Math.floor(sec * 1000));\r\n  }\r\n\r\n  // Units match\r\n  const regex = /(\\d+(?:\\.\\d+)?)\\s*(ms|s|m|h|d)/gi;\r\n  let match: RegExpExecArray | null;\r\n  let totalMs = 0;\r\n  let matched = false;\r\n\r\n  while ((match = regex.exec(trimmed)) !== null) {\r\n    matched = true;\r\n    const amount = parseFloat(match[1]);\r\n    const unit = match[2].toLowerCase();\r\n\r\n    switch (unit) {\r\n      case 'ms':\r\n        totalMs += amount;\r\n        break;\r\n      case 's':\r\n        totalMs += amount * 1000;\r\n        break;\r\n      case 'm':\r\n        totalMs += amount * 60 * 1000;\r\n        break;\r\n      case 'h':\r\n        totalMs += amount * 60 * 60 * 1000;\r\n        break;\r\n      case 'd':\r\n        totalMs += amount * 24 * 60 * 60 * 1000;\r\n        break;\r\n    }\r\n  }\r\n\r\n  return matched ? Math.max(0, Math.floor(totalMs)) : null;\r\n}\r\n\r\n/**\r\n * Inspects rate-limiting headers and extracts sleep delay in milliseconds:\r\n * - retry-after (seconds or HTTP date)\r\n * - x-ratelimit-reset-requests (OpenAI format)\r\n * - x-ratelimit-reset-tokens (Anthropic format)\r\n */\r\nexport function parseRateLimitDelay(headers: HeaderSource): number | null {\r\n  if (!headers) return null;\r\n\r\n  const retryAfter = getHeader(headers, 'retry-after');\r\n  if (retryAfter) {\r\n    if (/^\\d+(\\.\\d+)?$/.test(retryAfter.trim())) {\r\n      const sec = parseFloat(retryAfter.trim());\r\n      if (!isNaN(sec)) return Math.max(0, Math.floor(sec * 1000));\r\n    }\r\n\r\n    const parsedDate = Date.parse(retryAfter);\r\n    if (!isNaN(parsedDate)) {\r\n      return Math.max(0, parsedDate - Date.now());\r\n    }\r\n  }\r\n\r\n  const openaiReset = getHeader(headers, 'x-ratelimit-reset-requests');\r\n  if (openaiReset) {\r\n    const durationMs = parseDurationToMs(openaiReset);\r\n    if (durationMs !== null) return durationMs;\r\n  }\r\n\r\n  const anthropicReset = getHeader(headers, 'x-ratelimit-reset-tokens');\r\n  if (anthropicReset) {\r\n    const durationMs = parseDurationToMs(anthropicReset);\r\n    if (durationMs !== null) return durationMs;\r\n  }\r\n\r\n  return null;\r\n}\r\n\r\n/**\r\n * Detects transient network drop errors.\r\n */\r\nexport function isTransientNetworkError(error: unknown): boolean {\r\n  if (!(error instanceof Error)) return false;\r\n\r\n  const msg = error.message.toLowerCase();\r\n  const code = (error as { code?: string }).code;\r\n\r\n  if (error.name === 'TypeError' && msg.includes('fetch failed')) return true;\r\n\r\n  const transientCodes = ['ECONNRESET', 'ETIMEDOUT', 'ENOTFOUND', 'EAI_AGAIN', 'ECONNREFUSED'];\r\n  if (code && transientCodes.includes(code)) return true;\r\n\r\n  return (\r\n    msg.includes('network error') ||\r\n    msg.includes('socket hang up') ||\r\n    msg.includes('timeout')\r\n  );\r\n}\r\n\r\n/**\r\n * Sleep helper respecting AbortSignal cancellation.\r\n */\r\nexport function sleep(ms: number, signal?: AbortSignal): Promise<void> {\r\n  return new Promise((resolve, reject) => {\r\n    if (signal?.aborted) {\r\n      return reject(signal.reason ?? new DOMException('The operation was aborted.', 'AbortError'));\r\n    }\r\n\r\n    const timer = setTimeout(() => {\r\n      signal?.removeEventListener('abort', onAbort);\r\n      resolve();\r\n    }, ms);\r\n\r\n    function onAbort() {\r\n      clearTimeout(timer);\r\n      reject(signal?.reason ?? new DOMException('The operation was aborted.', 'AbortError'));\r\n    }\r\n\r\n    signal?.addEventListener('abort', onAbort, { once: true });\r\n  });\r\n}","import {\r\n  computeJitterDelay,\r\n  DEFAULT_RETRYABLE_STATUS_CODES,\r\n  isTransientNetworkError,\r\n  parseRateLimitDelay,\r\n  sleep,\r\n} from './engine.js';\r\nimport { RetryOptions } from './types.js';\r\n\r\nexport async function retryFetch(\r\n  url: string | URL | Request,\r\n  init?: RequestInit,\r\n  options: RetryOptions = {}\r\n): Promise<Response> {\r\n  const {\r\n    retries = 3,\r\n    baseDelayMs = 500,\r\n    maxDelayMs = 30000,\r\n    retryOnStatus = DEFAULT_RETRYABLE_STATUS_CODES,\r\n    onRetry,\r\n    signal,\r\n  } = options;\r\n\r\n  let attempt = 0;\r\n\r\n  while (true) {\r\n    if (signal?.aborted) {\r\n      throw signal.reason ?? new DOMException('The operation was aborted.', 'AbortError');\r\n    }\r\n\r\n    try {\r\n      const response = await fetch(url, {\r\n        ...init,\r\n        signal: signal ?? init?.signal,\r\n      });\r\n\r\n      if (retryOnStatus.includes(response.status) && attempt < retries) {\r\n        const headerDelay = parseRateLimitDelay(response.headers);\r\n        const backoffDelay = computeJitterDelay(attempt, baseDelayMs, maxDelayMs);\r\n        const chosenDelay = Math.min(maxDelayMs, headerDelay ?? backoffDelay);\r\n\r\n        onRetry?.(response, attempt + 1, chosenDelay);\r\n        await sleep(chosenDelay, signal);\r\n        attempt++;\r\n        continue;\r\n      }\r\n\r\n      return response;\r\n    } catch (error) {\r\n      if (signal?.aborted || (error instanceof Error && error.name === 'AbortError')) {\r\n        throw error;\r\n      }\r\n\r\n      if (isTransientNetworkError(error) && attempt < retries) {\r\n        const chosenDelay = computeJitterDelay(attempt, baseDelayMs, maxDelayMs);\r\n        onRetry?.(error, attempt + 1, chosenDelay);\r\n        await sleep(chosenDelay, signal);\r\n        attempt++;\r\n        continue;\r\n      }\r\n\r\n      throw error;\r\n    }\r\n  }\r\n}","import {\r\n  computeJitterDelay,\r\n  DEFAULT_RETRYABLE_STATUS_CODES,\r\n  isTransientNetworkError,\r\n  parseRateLimitDelay,\r\n  sleep,\r\n} from './engine.js';\r\nimport { HeaderSource, RetryOptions } from './types.js';\r\n\r\ninterface ErrorWithStatus extends Error {\r\n  status?: number;\r\n  statusCode?: number;\r\n  headers?: HeaderSource;\r\n  response?: {\r\n    status?: number;\r\n    headers?: HeaderSource;\r\n  };\r\n}\r\n\r\nexport async function retry<T>(\r\n  fn: (attempt: number) => Promise<T>,\r\n  options: RetryOptions = {}\r\n): Promise<T> {\r\n  const {\r\n    retries = 3,\r\n    baseDelayMs = 500,\r\n    maxDelayMs = 30000,\r\n    retryOnStatus = DEFAULT_RETRYABLE_STATUS_CODES,\r\n    onRetry,\r\n    signal,\r\n  } = options;\r\n\r\n  let attempt = 0;\r\n\r\n  while (true) {\r\n    if (signal?.aborted) {\r\n      throw signal.reason ?? new DOMException('The operation was aborted.', 'AbortError');\r\n    }\r\n\r\n    try {\r\n      return await fn(attempt);\r\n    } catch (error) {\r\n      if (signal?.aborted || (error instanceof Error && error.name === 'AbortError')) {\r\n        throw error;\r\n      }\r\n\r\n      if (attempt >= retries) {\r\n        throw error;\r\n      }\r\n\r\n      const err = error as ErrorWithStatus;\r\n      const statusCode = err?.status ?? err?.statusCode ?? err?.response?.status;\r\n      const headers = err?.headers ?? err?.response?.headers;\r\n\r\n      const isStatusRetryable = statusCode !== undefined && retryOnStatus.includes(statusCode);\r\n      const isNetworkRetryable = isTransientNetworkError(error);\r\n\r\n      if (!isStatusRetryable && !isNetworkRetryable) {\r\n        throw error;\r\n      }\r\n\r\n      let chosenDelay: number;\r\n      const headerDelay = headers ? parseRateLimitDelay(headers) : null;\r\n\r\n      if (headerDelay !== null) {\r\n        chosenDelay = Math.min(maxDelayMs, headerDelay);\r\n      } else {\r\n        chosenDelay = computeJitterDelay(attempt, baseDelayMs, maxDelayMs);\r\n      }\r\n\r\n      onRetry?.(error, attempt + 1, chosenDelay);\r\n      await sleep(chosenDelay, signal);\r\n      attempt++;\r\n    }\r\n  }\r\n}"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/engine.ts","../src/fetch.ts","../src/wrap.ts","../src/stream.ts","../src/circuit-breaker.ts"],"sourcesContent":["export { retryFetch } from './fetch.js';\r\nexport { retry } from './wrap.js';\r\nexport { retryStream } from './stream.js';\r\nexport { CircuitBreaker, CircuitBreakerOpenError } from './circuit-breaker.js';\r\nexport {\r\n  computeJitterDelay,\r\n  parseDurationToMs,\r\n  parseRateLimitDelay,\r\n  isTransientNetworkError,\r\n  sleep,\r\n  DEFAULT_RETRYABLE_STATUS_CODES,\r\n} from './engine.js';\r\nexport type {\r\n  RetryOptions,\r\n  CircuitBreakerOptions,\r\n  CircuitState,\r\n  HeaderSource,\r\n} from './types.js';","import { HeaderSource } from './types.js';\r\n\r\nexport const DEFAULT_RETRYABLE_STATUS_CODES = [408, 429, 500, 502, 503, 504];\r\n\r\n/**\r\n * Calculates exponential backoff with full jitter:\r\n * sleepMs = min(maxDelayMs, baseDelayMs * 2 ** attempt) * Math.random()\r\n */\r\nexport function computeJitterDelay(\r\n  attempt: number,\r\n  baseDelayMs: number = 500,\r\n  maxDelayMs: number = 30000\r\n): number {\r\n  const exponential = baseDelayMs * Math.pow(2, attempt);\r\n  const ceiling = Math.min(maxDelayMs, exponential);\r\n  return Math.floor(ceiling * Math.random());\r\n}\r\n\r\n/**\r\n * Safely extracts a header value case-insensitively across Headers instances, records, or tuples.\r\n */\r\nexport function getHeader(headers: HeaderSource, name: string): string | null {\r\n  if (!headers) return null;\r\n\r\n  const target = name.toLowerCase();\r\n\r\n  if (typeof (headers as Headers).get === 'function') {\r\n    return (headers as Headers).get(target);\r\n  }\r\n\r\n  if (Array.isArray(headers)) {\r\n    for (const [key, value] of headers) {\r\n      if (key.toLowerCase() === target) {\r\n        return value;\r\n      }\r\n    }\r\n    return null;\r\n  }\r\n\r\n  if (typeof headers === 'object') {\r\n    for (const key of Object.keys(headers)) {\r\n      if (key.toLowerCase() === target) {\r\n        const val = (headers as Record<string, unknown>)[key];\r\n        if (Array.isArray(val)) return val[0] ?? null;\r\n        return typeof val === 'string' ? val : String(val);\r\n      }\r\n    }\r\n  }\r\n\r\n  return null;\r\n}\r\n\r\n/**\r\n * Parses duration strings returned by LLM APIs (e.g. \"600ms\", \"10s\", \"2m\", \"1m30s\", \"1.5\").\r\n */\r\nexport function parseDurationToMs(value: string): number | null {\r\n  const trimmed = value.trim();\r\n  if (!trimmed) return null;\r\n\r\n  if (/^\\d+(\\.\\d+)?$/.test(trimmed)) {\r\n    const sec = parseFloat(trimmed);\r\n    return isNaN(sec) ? null : Math.max(0, Math.floor(sec * 1000));\r\n  }\r\n\r\n  const regex = /(\\d+(?:\\.\\d+)?)\\s*(ms|s|m|h|d)/gi;\r\n  let match: RegExpExecArray | null;\r\n  let totalMs = 0;\r\n  let matched = false;\r\n\r\n  while ((match = regex.exec(trimmed)) !== null) {\r\n    matched = true;\r\n    const amount = parseFloat(match[1]);\r\n    const unit = match[2].toLowerCase();\r\n\r\n    switch (unit) {\r\n      case 'ms':\r\n        totalMs += amount;\r\n        break;\r\n      case 's':\r\n        totalMs += amount * 1000;\r\n        break;\r\n      case 'm':\r\n        totalMs += amount * 60 * 1000;\r\n        break;\r\n      case 'h':\r\n        totalMs += amount * 60 * 60 * 1000;\r\n        break;\r\n      case 'd':\r\n        totalMs += amount * 24 * 60 * 60 * 1000;\r\n        break;\r\n    }\r\n  }\r\n\r\n  return matched ? Math.max(0, Math.floor(totalMs)) : null;\r\n}\r\n\r\n/**\r\n * Exhaustively checks provider headers across:\r\n * - RFC 7231 / RFC 6585 standard `retry-after`\r\n * - OpenAI: `x-ratelimit-reset-requests`, `x-ratelimit-reset-tokens`\r\n * - Anthropic: `anthropic-ratelimit-requests-reset`, `anthropic-ratelimit-tokens-reset`\r\n * - Groq / DeepSeek / Mistral: `x-ratelimit-reset-total`, `retry-after-ms`\r\n */\r\nexport function parseRateLimitDelay(headers: HeaderSource): number | null {\r\n  if (!headers) return null;\r\n\r\n  // 1. Direct milliseconds header (Groq, custom proxies)\r\n  const retryAfterMs = getHeader(headers, 'retry-after-ms');\r\n  if (retryAfterMs) {\r\n    const parsed = parseFloat(retryAfterMs);\r\n    if (!isNaN(parsed)) return Math.max(0, Math.floor(parsed));\r\n  }\r\n\r\n  // 2. Standard Retry-After (seconds or RFC 1123 HTTP Date)\r\n  const retryAfter = getHeader(headers, 'retry-after');\r\n  if (retryAfter) {\r\n    if (/^\\d+(\\.\\d+)?$/.test(retryAfter.trim())) {\r\n      const sec = parseFloat(retryAfter.trim());\r\n      if (!isNaN(sec)) return Math.max(0, Math.floor(sec * 1000));\r\n    }\r\n\r\n    const parsedDate = Date.parse(retryAfter);\r\n    if (!isNaN(parsedDate)) {\r\n      return Math.max(0, parsedDate - Date.now());\r\n    }\r\n  }\r\n\r\n  // 3. Provider-specific reset headers\r\n  const candidateKeys = [\r\n    'x-ratelimit-reset-requests',\r\n    'x-ratelimit-reset-tokens',\r\n    'anthropic-ratelimit-requests-reset',\r\n    'anthropic-ratelimit-tokens-reset',\r\n    'x-ratelimit-reset-total',\r\n  ];\r\n\r\n  for (const key of candidateKeys) {\r\n    const raw = getHeader(headers, key);\r\n    if (raw) {\r\n      const ms = parseDurationToMs(raw);\r\n      if (ms !== null) return ms;\r\n\r\n      // Handle epoch timestamp formats\r\n      const epochSec = parseFloat(raw);\r\n      if (!isNaN(epochSec) && epochSec > 1000000000) {\r\n        return Math.max(0, Math.floor(epochSec * 1000 - Date.now()));\r\n      }\r\n    }\r\n  }\r\n\r\n  return null;\r\n}\r\n\r\n/**\r\n * Detects transient network drop errors across Node, Bun, Deno, and browsers.\r\n */\r\nexport function isTransientNetworkError(error: unknown): boolean {\r\n  if (!(error instanceof Error)) return false;\r\n\r\n  const msg = error.message.toLowerCase();\r\n  const code = (error as { code?: string }).code;\r\n\r\n  if (error.name === 'TypeError' && msg.includes('fetch failed')) return true;\r\n\r\n  const transientCodes = [\r\n    'ECONNRESET',\r\n    'ETIMEDOUT',\r\n    'ENOTFOUND',\r\n    'EAI_AGAIN',\r\n    'ECONNREFUSED',\r\n    'UND_ERR_CONNECT_TIMEOUT',\r\n    'UND_ERR_SOCKET',\r\n  ];\r\n  if (code && transientCodes.includes(code)) return true;\r\n\r\n  return (\r\n    msg.includes('network error') ||\r\n    msg.includes('socket hang up') ||\r\n    msg.includes('terminated') ||\r\n    msg.includes('econnreset')\r\n  );\r\n}\r\n\r\n/**\r\n * Promisified sleep that respects AbortSignal cancellation.\r\n */\r\nexport function sleep(ms: number, signal?: AbortSignal): Promise<void> {\r\n  return new Promise((resolve, reject) => {\r\n    if (signal?.aborted) {\r\n      return reject(signal.reason ?? new DOMException('The operation was aborted.', 'AbortError'));\r\n    }\r\n\r\n    const timer = setTimeout(() => {\r\n      signal?.removeEventListener('abort', onAbort);\r\n      resolve();\r\n    }, ms);\r\n\r\n    function onAbort() {\r\n      clearTimeout(timer);\r\n      reject(signal?.reason ?? new DOMException('The operation was aborted.', 'AbortError'));\r\n    }\r\n\r\n    signal?.addEventListener('abort', onAbort, { once: true });\r\n  });\r\n}","import {\r\n  computeJitterDelay,\r\n  DEFAULT_RETRYABLE_STATUS_CODES,\r\n  isTransientNetworkError,\r\n  parseRateLimitDelay,\r\n  sleep,\r\n} from './engine.js';\r\nimport { RetryOptions } from './types.js';\r\n\r\nexport async function retryFetch(\r\n  url: string | URL | Request,\r\n  init?: RequestInit,\r\n  options: RetryOptions = {}\r\n): Promise<Response> {\r\n  const {\r\n    retries = 3,\r\n    baseDelayMs = 500,\r\n    maxDelayMs = 30000,\r\n    timeoutMs,\r\n    retryOnStatus = DEFAULT_RETRYABLE_STATUS_CODES,\r\n    shouldRetry,\r\n    onRetry,\r\n    signal,\r\n  } = options;\r\n\r\n  let attempt = 0;\r\n\r\n  while (true) {\r\n    if (signal?.aborted) {\r\n      throw signal.reason ?? new DOMException('The operation was aborted.', 'AbortError');\r\n    }\r\n\r\n    // Set up per-attempt timeout controller\r\n    const attemptController = new AbortController();\r\n    let timeoutId: ReturnType<typeof setTimeout> | undefined;\r\n\r\n    if (timeoutMs && timeoutMs > 0) {\r\n      timeoutId = setTimeout(() => {\r\n        attemptController.abort(new DOMException(`Request timed out after ${timeoutMs}ms`, 'TimeoutError'));\r\n      }, timeoutMs);\r\n    }\r\n\r\n    const abortHandler = () => attemptController.abort(signal?.reason);\r\n    signal?.addEventListener('abort', abortHandler, { once: true });\r\n\r\n    try {\r\n      const response = await fetch(url, {\r\n        ...init,\r\n        signal: attemptController.signal,\r\n      });\r\n\r\n      if (timeoutId) clearTimeout(timeoutId);\r\n      signal?.removeEventListener('abort', abortHandler);\r\n\r\n      const isStatusRetryable = retryOnStatus.includes(response.status);\r\n      const customRetry = shouldRetry ? shouldRetry(response, attempt) : isStatusRetryable;\r\n\r\n      if (customRetry && attempt < retries) {\r\n        const headerDelay = parseRateLimitDelay(response.headers);\r\n        const backoffDelay = computeJitterDelay(attempt, baseDelayMs, maxDelayMs);\r\n        const chosenDelay = Math.min(maxDelayMs, headerDelay ?? backoffDelay);\r\n\r\n        onRetry?.(response, attempt + 1, chosenDelay);\r\n        await sleep(chosenDelay, signal);\r\n        attempt++;\r\n        continue;\r\n      }\r\n\r\n      return response;\r\n    } catch (error) {\r\n      if (timeoutId) clearTimeout(timeoutId);\r\n      signal?.removeEventListener('abort', abortHandler);\r\n\r\n      // Do not retry intentional outer aborts\r\n      if (signal?.aborted) {\r\n        throw signal.reason ?? error;\r\n      }\r\n\r\n      const isTimeout = error instanceof Error && error.name === 'TimeoutError';\r\n      const isNetworkDrop = isTransientNetworkError(error);\r\n      const customRetry = shouldRetry ? shouldRetry(error, attempt) : (isNetworkDrop || isTimeout);\r\n\r\n      if (customRetry && attempt < retries) {\r\n        const chosenDelay = computeJitterDelay(attempt, baseDelayMs, maxDelayMs);\r\n        onRetry?.(error, attempt + 1, chosenDelay);\r\n        await sleep(chosenDelay, signal);\r\n        attempt++;\r\n        continue;\r\n      }\r\n\r\n      throw error;\r\n    }\r\n  }\r\n}","import {\r\n  computeJitterDelay,\r\n  DEFAULT_RETRYABLE_STATUS_CODES,\r\n  isTransientNetworkError,\r\n  parseRateLimitDelay,\r\n  sleep,\r\n} from './engine.js';\r\nimport { HeaderSource, RetryOptions } from './types.js';\r\n\r\ninterface ErrorWithStatus extends Error {\r\n  status?: number;\r\n  statusCode?: number;\r\n  headers?: HeaderSource;\r\n  response?: {\r\n    status?: number;\r\n    headers?: HeaderSource;\r\n  };\r\n}\r\n\r\nexport async function retry<T>(\r\n  fn: (attempt: number) => Promise<T>,\r\n  options: RetryOptions = {}\r\n): Promise<T> {\r\n  const {\r\n    retries = 3,\r\n    baseDelayMs = 500,\r\n    maxDelayMs = 30000,\r\n    retryOnStatus = DEFAULT_RETRYABLE_STATUS_CODES,\r\n    shouldRetry,\r\n    onRetry,\r\n    signal,\r\n  } = options;\r\n\r\n  let attempt = 0;\r\n\r\n  while (true) {\r\n    if (signal?.aborted) {\r\n      throw signal.reason ?? new DOMException('The operation was aborted.', 'AbortError');\r\n    }\r\n\r\n    try {\r\n      return await fn(attempt);\r\n    } catch (error) {\r\n      if (signal?.aborted || (error instanceof Error && error.name === 'AbortError')) {\r\n        throw error;\r\n      }\r\n\r\n      if (attempt >= retries) {\r\n        throw error;\r\n      }\r\n\r\n      const err = error as ErrorWithStatus;\r\n      const statusCode = err?.status ?? err?.statusCode ?? err?.response?.status;\r\n      const headers = err?.headers ?? err?.response?.headers;\r\n\r\n      const isStatusRetryable = statusCode !== undefined && retryOnStatus.includes(statusCode);\r\n      const isNetworkRetryable = isTransientNetworkError(error);\r\n      const customRetry = shouldRetry\r\n        ? shouldRetry(error, attempt)\r\n        : (isStatusRetryable || isNetworkRetryable);\r\n\r\n      if (!customRetry) {\r\n        throw error;\r\n      }\r\n\r\n      let chosenDelay: number;\r\n      const headerDelay = headers ? parseRateLimitDelay(headers) : null;\r\n\r\n      if (headerDelay !== null) {\r\n        chosenDelay = Math.min(maxDelayMs, headerDelay);\r\n      } else {\r\n        chosenDelay = computeJitterDelay(attempt, baseDelayMs, maxDelayMs);\r\n      }\r\n\r\n      onRetry?.(error, attempt + 1, chosenDelay);\r\n      await sleep(chosenDelay, signal);\r\n      attempt++;\r\n    }\r\n  }\r\n}","import { computeJitterDelay, sleep } from './engine.js';\r\nimport { RetryOptions } from './types.js';\r\n\r\n/**\r\n * Resilient wrapper for Server-Sent Events / LLM chunk streams.\r\n * If the streaming connection drops mid-generation, it retries and resumes.\r\n */\r\nexport async function* retryStream<T>(\r\n  streamFactory: (attempt: number) => Promise<AsyncIterable<T>>,\r\n  options: RetryOptions = {}\r\n): AsyncGenerator<T, void, unknown> {\r\n  const {\r\n    retries = 3,\r\n    baseDelayMs = 500,\r\n    maxDelayMs = 30000,\r\n    onRetry,\r\n    signal,\r\n  } = options;\r\n\r\n  let attempt = 0;\r\n\r\n  while (true) {\r\n    if (signal?.aborted) {\r\n      throw signal.reason ?? new DOMException('The operation was aborted.', 'AbortError');\r\n    }\r\n\r\n    try {\r\n      const stream = await streamFactory(attempt);\r\n      for await (const chunk of stream) {\r\n        if (signal?.aborted) {\r\n          throw signal.reason ?? new DOMException('The operation was aborted.', 'AbortError');\r\n        }\r\n        yield chunk;\r\n      }\r\n      return;\r\n    } catch (error) {\r\n      if (signal?.aborted || (error instanceof Error && error.name === 'AbortError')) {\r\n        throw error;\r\n      }\r\n\r\n      if (attempt >= retries) {\r\n        throw error;\r\n      }\r\n\r\n      const delay = computeJitterDelay(attempt, baseDelayMs, maxDelayMs);\r\n      onRetry?.(error, attempt + 1, delay);\r\n      await sleep(delay, signal);\r\n      attempt++;\r\n    }\r\n  }\r\n}","import { CircuitBreakerOptions, CircuitState } from './types.js';\r\n\r\nexport class CircuitBreakerOpenError extends Error {\r\n  constructor(message: string = 'Circuit breaker is OPEN. Fast-failing requests.') {\r\n    super(message);\r\n    this.name = 'CircuitBreakerOpenError';\r\n  }\r\n}\r\n\r\n/**\r\n * Zero-dependency Circuit Breaker implementation to stop cascading failure\r\n * cascades when downstream LLM APIs experience total outages.\r\n */\r\nexport class CircuitBreaker {\r\n  private state: CircuitState = 'CLOSED';\r\n  private failureCount: number = 0;\r\n  private lastFailureTime: number = 0;\r\n  private readonly failureThreshold: number;\r\n  private readonly resetTimeoutMs: number;\r\n  private readonly onStateChange?: (from: CircuitState, to: CircuitState) => void;\r\n\r\n  constructor(options: CircuitBreakerOptions = {}) {\r\n    this.failureThreshold = options.failureThreshold ?? 5;\r\n    this.resetTimeoutMs = options.resetTimeoutMs ?? 30000;\r\n    this.onStateChange = options.onStateChange;\r\n  }\r\n\r\n  public getState(): CircuitState {\r\n    if (this.state === 'OPEN') {\r\n      const elapsed = Date.now() - this.lastFailureTime;\r\n      if (elapsed >= this.resetTimeoutMs) {\r\n        this.transitionTo('HALF_OPEN');\r\n      }\r\n    }\r\n    return this.state;\r\n  }\r\n\r\n  public async execute<T>(fn: () => Promise<T>): Promise<T> {\r\n    const currentState = this.getState();\r\n\r\n    if (currentState === 'OPEN') {\r\n      throw new CircuitBreakerOpenError();\r\n    }\r\n\r\n    try {\r\n      const result = await fn();\r\n      this.recordSuccess();\r\n      return result;\r\n    } catch (error) {\r\n      this.recordFailure();\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  private recordSuccess(): void {\r\n    if (this.state === 'HALF_OPEN') {\r\n      this.transitionTo('CLOSED');\r\n    }\r\n    this.failureCount = 0;\r\n  }\r\n\r\n  private recordFailure(): void {\r\n    this.failureCount++;\r\n    this.lastFailureTime = Date.now();\r\n\r\n    if (this.state === 'HALF_OPEN' || this.failureCount >= this.failureThreshold) {\r\n      this.transitionTo('OPEN');\r\n    }\r\n  }\r\n\r\n  private transitionTo(nextState: CircuitState): void {\r\n    const prevState = this.state;\r\n    if (prevState !== nextState) {\r\n      this.state = nextState;\r\n      this.onStateChange?.(prevState, nextState);\r\n    }\r\n  }\r\n\r\n  public reset(): void {\r\n    this.state = 'CLOSED';\r\n    this.failureCount = 0;\r\n    this.lastFailureTime = 0;\r\n  }\r\n}"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACEO,IAAM,iCAAiC,CAAC,KAAK,KAAK,KAAK,KAAK,KAAK,GAAG;AAMpE,SAAS,mBACd,SACA,cAAsB,KACtB,aAAqB,KACb;AACR,QAAM,cAAc,cAAc,KAAK,IAAI,GAAG,OAAO;AACrD,QAAM,UAAU,KAAK,IAAI,YAAY,WAAW;AAChD,SAAO,KAAK,MAAM,UAAU,KAAK,OAAO,CAAC;AAC3C;AAKO,SAAS,UAAU,SAAuB,MAA6B;AAC5E,MAAI,CAAC,QAAS,QAAO;AAErB,QAAM,SAAS,KAAK,YAAY;AAEhC,MAAI,OAAQ,QAAoB,QAAQ,YAAY;AAClD,WAAQ,QAAoB,IAAI,MAAM;AAAA,EACxC;AAEA,MAAI,MAAM,QAAQ,OAAO,GAAG;AAC1B,eAAW,CAAC,KAAK,KAAK,KAAK,SAAS;AAClC,UAAI,IAAI,YAAY,MAAM,QAAQ;AAChC,eAAO;AAAA,MACT;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,YAAY,UAAU;AAC/B,eAAW,OAAO,OAAO,KAAK,OAAO,GAAG;AACtC,UAAI,IAAI,YAAY,MAAM,QAAQ;AAChC,cAAM,MAAO,QAAoC,GAAG;AACpD,YAAI,MAAM,QAAQ,GAAG,EAAG,QAAO,IAAI,CAAC,KAAK;AACzC,eAAO,OAAO,QAAQ,WAAW,MAAM,OAAO,GAAG;AAAA,MACnD;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAKO,SAAS,kBAAkB,OAA8B;AAC9D,QAAM,UAAU,MAAM,KAAK;AAC3B,MAAI,CAAC,QAAS,QAAO;AAErB,MAAI,gBAAgB,KAAK,OAAO,GAAG;AACjC,UAAM,MAAM,WAAW,OAAO;AAC9B,WAAO,MAAM,GAAG,IAAI,OAAO,KAAK,IAAI,GAAG,KAAK,MAAM,MAAM,GAAI,CAAC;AAAA,EAC/D;AAEA,QAAM,QAAQ;AACd,MAAI;AACJ,MAAI,UAAU;AACd,MAAI,UAAU;AAEd,UAAQ,QAAQ,MAAM,KAAK,OAAO,OAAO,MAAM;AAC7C,cAAU;AACV,UAAM,SAAS,WAAW,MAAM,CAAC,CAAC;AAClC,UAAM,OAAO,MAAM,CAAC,EAAE,YAAY;AAElC,YAAQ,MAAM;AAAA,MACZ,KAAK;AACH,mBAAW;AACX;AAAA,MACF,KAAK;AACH,mBAAW,SAAS;AACpB;AAAA,MACF,KAAK;AACH,mBAAW,SAAS,KAAK;AACzB;AAAA,MACF,KAAK;AACH,mBAAW,SAAS,KAAK,KAAK;AAC9B;AAAA,MACF,KAAK;AACH,mBAAW,SAAS,KAAK,KAAK,KAAK;AACnC;AAAA,IACJ;AAAA,EACF;AAEA,SAAO,UAAU,KAAK,IAAI,GAAG,KAAK,MAAM,OAAO,CAAC,IAAI;AACtD;AASO,SAAS,oBAAoB,SAAsC;AACxE,MAAI,CAAC,QAAS,QAAO;AAGrB,QAAM,eAAe,UAAU,SAAS,gBAAgB;AACxD,MAAI,cAAc;AAChB,UAAM,SAAS,WAAW,YAAY;AACtC,QAAI,CAAC,MAAM,MAAM,EAAG,QAAO,KAAK,IAAI,GAAG,KAAK,MAAM,MAAM,CAAC;AAAA,EAC3D;AAGA,QAAM,aAAa,UAAU,SAAS,aAAa;AACnD,MAAI,YAAY;AACd,QAAI,gBAAgB,KAAK,WAAW,KAAK,CAAC,GAAG;AAC3C,YAAM,MAAM,WAAW,WAAW,KAAK,CAAC;AACxC,UAAI,CAAC,MAAM,GAAG,EAAG,QAAO,KAAK,IAAI,GAAG,KAAK,MAAM,MAAM,GAAI,CAAC;AAAA,IAC5D;AAEA,UAAM,aAAa,KAAK,MAAM,UAAU;AACxC,QAAI,CAAC,MAAM,UAAU,GAAG;AACtB,aAAO,KAAK,IAAI,GAAG,aAAa,KAAK,IAAI,CAAC;AAAA,IAC5C;AAAA,EACF;AAGA,QAAM,gBAAgB;AAAA,IACpB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAEA,aAAW,OAAO,eAAe;AAC/B,UAAM,MAAM,UAAU,SAAS,GAAG;AAClC,QAAI,KAAK;AACP,YAAM,KAAK,kBAAkB,GAAG;AAChC,UAAI,OAAO,KAAM,QAAO;AAGxB,YAAM,WAAW,WAAW,GAAG;AAC/B,UAAI,CAAC,MAAM,QAAQ,KAAK,WAAW,KAAY;AAC7C,eAAO,KAAK,IAAI,GAAG,KAAK,MAAM,WAAW,MAAO,KAAK,IAAI,CAAC,CAAC;AAAA,MAC7D;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAKO,SAAS,wBAAwB,OAAyB;AAC/D,MAAI,EAAE,iBAAiB,OAAQ,QAAO;AAEtC,QAAM,MAAM,MAAM,QAAQ,YAAY;AACtC,QAAM,OAAQ,MAA4B;AAE1C,MAAI,MAAM,SAAS,eAAe,IAAI,SAAS,cAAc,EAAG,QAAO;AAEvE,QAAM,iBAAiB;AAAA,IACrB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACA,MAAI,QAAQ,eAAe,SAAS,IAAI,EAAG,QAAO;AAElD,SACE,IAAI,SAAS,eAAe,KAC5B,IAAI,SAAS,gBAAgB,KAC7B,IAAI,SAAS,YAAY,KACzB,IAAI,SAAS,YAAY;AAE7B;AAKO,SAAS,MAAM,IAAY,QAAqC;AACrE,SAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,QAAI,QAAQ,SAAS;AACnB,aAAO,OAAO,OAAO,UAAU,IAAI,aAAa,8BAA8B,YAAY,CAAC;AAAA,IAC7F;AAEA,UAAM,QAAQ,WAAW,MAAM;AAC7B,cAAQ,oBAAoB,SAAS,OAAO;AAC5C,cAAQ;AAAA,IACV,GAAG,EAAE;AAEL,aAAS,UAAU;AACjB,mBAAa,KAAK;AAClB,aAAO,QAAQ,UAAU,IAAI,aAAa,8BAA8B,YAAY,CAAC;AAAA,IACvF;AAEA,YAAQ,iBAAiB,SAAS,SAAS,EAAE,MAAM,KAAK,CAAC;AAAA,EAC3D,CAAC;AACH;;;ACnMA,eAAsB,WACpB,KACA,MACA,UAAwB,CAAC,GACN;AACnB,QAAM;AAAA,IACJ,UAAU;AAAA,IACV,cAAc;AAAA,IACd,aAAa;AAAA,IACb;AAAA,IACA,gBAAgB;AAAA,IAChB;AAAA,IACA;AAAA,IACA;AAAA,EACF,IAAI;AAEJ,MAAI,UAAU;AAEd,SAAO,MAAM;AACX,QAAI,QAAQ,SAAS;AACnB,YAAM,OAAO,UAAU,IAAI,aAAa,8BAA8B,YAAY;AAAA,IACpF;AAGA,UAAM,oBAAoB,IAAI,gBAAgB;AAC9C,QAAI;AAEJ,QAAI,aAAa,YAAY,GAAG;AAC9B,kBAAY,WAAW,MAAM;AAC3B,0BAAkB,MAAM,IAAI,aAAa,2BAA2B,SAAS,MAAM,cAAc,CAAC;AAAA,MACpG,GAAG,SAAS;AAAA,IACd;AAEA,UAAM,eAAe,MAAM,kBAAkB,MAAM,QAAQ,MAAM;AACjE,YAAQ,iBAAiB,SAAS,cAAc,EAAE,MAAM,KAAK,CAAC;AAE9D,QAAI;AACF,YAAM,WAAW,MAAM,MAAM,KAAK;AAAA,QAChC,GAAG;AAAA,QACH,QAAQ,kBAAkB;AAAA,MAC5B,CAAC;AAED,UAAI,UAAW,cAAa,SAAS;AACrC,cAAQ,oBAAoB,SAAS,YAAY;AAEjD,YAAM,oBAAoB,cAAc,SAAS,SAAS,MAAM;AAChE,YAAM,cAAc,cAAc,YAAY,UAAU,OAAO,IAAI;AAEnE,UAAI,eAAe,UAAU,SAAS;AACpC,cAAM,cAAc,oBAAoB,SAAS,OAAO;AACxD,cAAM,eAAe,mBAAmB,SAAS,aAAa,UAAU;AACxE,cAAM,cAAc,KAAK,IAAI,YAAY,eAAe,YAAY;AAEpE,kBAAU,UAAU,UAAU,GAAG,WAAW;AAC5C,cAAM,MAAM,aAAa,MAAM;AAC/B;AACA;AAAA,MACF;AAEA,aAAO;AAAA,IACT,SAAS,OAAO;AACd,UAAI,UAAW,cAAa,SAAS;AACrC,cAAQ,oBAAoB,SAAS,YAAY;AAGjD,UAAI,QAAQ,SAAS;AACnB,cAAM,OAAO,UAAU;AAAA,MACzB;AAEA,YAAM,YAAY,iBAAiB,SAAS,MAAM,SAAS;AAC3D,YAAM,gBAAgB,wBAAwB,KAAK;AACnD,YAAM,cAAc,cAAc,YAAY,OAAO,OAAO,IAAK,iBAAiB;AAElF,UAAI,eAAe,UAAU,SAAS;AACpC,cAAM,cAAc,mBAAmB,SAAS,aAAa,UAAU;AACvE,kBAAU,OAAO,UAAU,GAAG,WAAW;AACzC,cAAM,MAAM,aAAa,MAAM;AAC/B;AACA;AAAA,MACF;AAEA,YAAM;AAAA,IACR;AAAA,EACF;AACF;;;AC1EA,eAAsB,MACpB,IACA,UAAwB,CAAC,GACb;AACZ,QAAM;AAAA,IACJ,UAAU;AAAA,IACV,cAAc;AAAA,IACd,aAAa;AAAA,IACb,gBAAgB;AAAA,IAChB;AAAA,IACA;AAAA,IACA;AAAA,EACF,IAAI;AAEJ,MAAI,UAAU;AAEd,SAAO,MAAM;AACX,QAAI,QAAQ,SAAS;AACnB,YAAM,OAAO,UAAU,IAAI,aAAa,8BAA8B,YAAY;AAAA,IACpF;AAEA,QAAI;AACF,aAAO,MAAM,GAAG,OAAO;AAAA,IACzB,SAAS,OAAO;AACd,UAAI,QAAQ,WAAY,iBAAiB,SAAS,MAAM,SAAS,cAAe;AAC9E,cAAM;AAAA,MACR;AAEA,UAAI,WAAW,SAAS;AACtB,cAAM;AAAA,MACR;AAEA,YAAM,MAAM;AACZ,YAAM,aAAa,KAAK,UAAU,KAAK,cAAc,KAAK,UAAU;AACpE,YAAM,UAAU,KAAK,WAAW,KAAK,UAAU;AAE/C,YAAM,oBAAoB,eAAe,UAAa,cAAc,SAAS,UAAU;AACvF,YAAM,qBAAqB,wBAAwB,KAAK;AACxD,YAAM,cAAc,cAChB,YAAY,OAAO,OAAO,IACzB,qBAAqB;AAE1B,UAAI,CAAC,aAAa;AAChB,cAAM;AAAA,MACR;AAEA,UAAI;AACJ,YAAM,cAAc,UAAU,oBAAoB,OAAO,IAAI;AAE7D,UAAI,gBAAgB,MAAM;AACxB,sBAAc,KAAK,IAAI,YAAY,WAAW;AAAA,MAChD,OAAO;AACL,sBAAc,mBAAmB,SAAS,aAAa,UAAU;AAAA,MACnE;AAEA,gBAAU,OAAO,UAAU,GAAG,WAAW;AACzC,YAAM,MAAM,aAAa,MAAM;AAC/B;AAAA,IACF;AAAA,EACF;AACF;;;ACxEA,gBAAuB,YACrB,eACA,UAAwB,CAAC,GACS;AAClC,QAAM;AAAA,IACJ,UAAU;AAAA,IACV,cAAc;AAAA,IACd,aAAa;AAAA,IACb;AAAA,IACA;AAAA,EACF,IAAI;AAEJ,MAAI,UAAU;AAEd,SAAO,MAAM;AACX,QAAI,QAAQ,SAAS;AACnB,YAAM,OAAO,UAAU,IAAI,aAAa,8BAA8B,YAAY;AAAA,IACpF;AAEA,QAAI;AACF,YAAM,SAAS,MAAM,cAAc,OAAO;AAC1C,uBAAiB,SAAS,QAAQ;AAChC,YAAI,QAAQ,SAAS;AACnB,gBAAM,OAAO,UAAU,IAAI,aAAa,8BAA8B,YAAY;AAAA,QACpF;AACA,cAAM;AAAA,MACR;AACA;AAAA,IACF,SAAS,OAAO;AACd,UAAI,QAAQ,WAAY,iBAAiB,SAAS,MAAM,SAAS,cAAe;AAC9E,cAAM;AAAA,MACR;AAEA,UAAI,WAAW,SAAS;AACtB,cAAM;AAAA,MACR;AAEA,YAAM,QAAQ,mBAAmB,SAAS,aAAa,UAAU;AACjE,gBAAU,OAAO,UAAU,GAAG,KAAK;AACnC,YAAM,MAAM,OAAO,MAAM;AACzB;AAAA,IACF;AAAA,EACF;AACF;;;AChDO,IAAM,0BAAN,cAAsC,MAAM;AAAA,EACjD,YAAY,UAAkB,mDAAmD;AAC/E,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;AAMO,IAAM,iBAAN,MAAqB;AAAA,EAClB,QAAsB;AAAA,EACtB,eAAuB;AAAA,EACvB,kBAA0B;AAAA,EACjB;AAAA,EACA;AAAA,EACA;AAAA,EAEjB,YAAY,UAAiC,CAAC,GAAG;AAC/C,SAAK,mBAAmB,QAAQ,oBAAoB;AACpD,SAAK,iBAAiB,QAAQ,kBAAkB;AAChD,SAAK,gBAAgB,QAAQ;AAAA,EAC/B;AAAA,EAEO,WAAyB;AAC9B,QAAI,KAAK,UAAU,QAAQ;AACzB,YAAM,UAAU,KAAK,IAAI,IAAI,KAAK;AAClC,UAAI,WAAW,KAAK,gBAAgB;AAClC,aAAK,aAAa,WAAW;AAAA,MAC/B;AAAA,IACF;AACA,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAa,QAAW,IAAkC;AACxD,UAAM,eAAe,KAAK,SAAS;AAEnC,QAAI,iBAAiB,QAAQ;AAC3B,YAAM,IAAI,wBAAwB;AAAA,IACpC;AAEA,QAAI;AACF,YAAM,SAAS,MAAM,GAAG;AACxB,WAAK,cAAc;AACnB,aAAO;AAAA,IACT,SAAS,OAAO;AACd,WAAK,cAAc;AACnB,YAAM;AAAA,IACR;AAAA,EACF;AAAA,EAEQ,gBAAsB;AAC5B,QAAI,KAAK,UAAU,aAAa;AAC9B,WAAK,aAAa,QAAQ;AAAA,IAC5B;AACA,SAAK,eAAe;AAAA,EACtB;AAAA,EAEQ,gBAAsB;AAC5B,SAAK;AACL,SAAK,kBAAkB,KAAK,IAAI;AAEhC,QAAI,KAAK,UAAU,eAAe,KAAK,gBAAgB,KAAK,kBAAkB;AAC5E,WAAK,aAAa,MAAM;AAAA,IAC1B;AAAA,EACF;AAAA,EAEQ,aAAa,WAA+B;AAClD,UAAM,YAAY,KAAK;AACvB,QAAI,cAAc,WAAW;AAC3B,WAAK,QAAQ;AACb,WAAK,gBAAgB,WAAW,SAAS;AAAA,IAC3C;AAAA,EACF;AAAA,EAEO,QAAc;AACnB,SAAK,QAAQ;AACb,SAAK,eAAe;AACpB,SAAK,kBAAkB;AAAA,EACzB;AACF;","names":[]}

package/dist/index.mjs

@@ -67,6 +67,11 @@ function parseDurationToMs(value) {
 }
 function parseRateLimitDelay(headers) {
   if (!headers) return null;
+  const retryAfterMs = getHeader(headers, "retry-after-ms");
+  if (retryAfterMs) {
+    const parsed = parseFloat(retryAfterMs);
+    if (!isNaN(parsed)) return Math.max(0, Math.floor(parsed));
+  }
   const retryAfter = getHeader(headers, "retry-after");
   if (retryAfter) {
     if (/^\d+(\.\d+)?$/.test(retryAfter.trim())) {
@@ -78,15 +83,23 @@ function parseRateLimitDelay(headers) {
       return Math.max(0, parsedDate - Date.now());
     }
   }
-  const openaiReset = getHeader(headers, "x-ratelimit-reset-requests");
-  if (openaiReset) {
-    const durationMs = parseDurationToMs(openaiReset);
-    if (durationMs !== null) return durationMs;
-  }
-  const anthropicReset = getHeader(headers, "x-ratelimit-reset-tokens");
-  if (anthropicReset) {
-    const durationMs = parseDurationToMs(anthropicReset);
-    if (durationMs !== null) return durationMs;
+  const candidateKeys = [
+    "x-ratelimit-reset-requests",
+    "x-ratelimit-reset-tokens",
+    "anthropic-ratelimit-requests-reset",
+    "anthropic-ratelimit-tokens-reset",
+    "x-ratelimit-reset-total"
+  ];
+  for (const key of candidateKeys) {
+    const raw = getHeader(headers, key);
+    if (raw) {
+      const ms = parseDurationToMs(raw);
+      if (ms !== null) return ms;
+      const epochSec = parseFloat(raw);
+      if (!isNaN(epochSec) && epochSec > 1e9) {
+        return Math.max(0, Math.floor(epochSec * 1e3 - Date.now()));
+      }
+    }
   }
   return null;
 }
@@ -95,9 +108,17 @@ function isTransientNetworkError(error) {
   const msg = error.message.toLowerCase();
   const code = error.code;
   if (error.name === "TypeError" && msg.includes("fetch failed")) return true;
-  const transientCodes = ["ECONNRESET", "ETIMEDOUT", "ENOTFOUND", "EAI_AGAIN", "ECONNREFUSED"];
+  const transientCodes = [
+    "ECONNRESET",
+    "ETIMEDOUT",
+    "ENOTFOUND",
+    "EAI_AGAIN",
+    "ECONNREFUSED",
+    "UND_ERR_CONNECT_TIMEOUT",
+    "UND_ERR_SOCKET"
+  ];
   if (code && transientCodes.includes(code)) return true;
-  return msg.includes("network error") || msg.includes("socket hang up") || msg.includes("timeout");
+  return msg.includes("network error") || msg.includes("socket hang up") || msg.includes("terminated") || msg.includes("econnreset");
 }
 function sleep(ms, signal) {
   return new Promise((resolve, reject) => {
@@ -122,7 +143,9 @@ async function retryFetch(url, init, options = {}) {
     retries = 3,
     baseDelayMs = 500,
     maxDelayMs = 3e4,
+    timeoutMs,
     retryOnStatus = DEFAULT_RETRYABLE_STATUS_CODES,
+    shouldRetry,
     onRetry,
     signal
   } = options;
@@ -131,12 +154,25 @@ async function retryFetch(url, init, options = {}) {
     if (signal?.aborted) {
       throw signal.reason ?? new DOMException("The operation was aborted.", "AbortError");
     }
+    const attemptController = new AbortController();
+    let timeoutId;
+    if (timeoutMs && timeoutMs > 0) {
+      timeoutId = setTimeout(() => {
+        attemptController.abort(new DOMException(`Request timed out after ${timeoutMs}ms`, "TimeoutError"));
+      }, timeoutMs);
+    }
+    const abortHandler = () => attemptController.abort(signal?.reason);
+    signal?.addEventListener("abort", abortHandler, { once: true });
     try {
       const response = await fetch(url, {
         ...init,
-        signal: signal ?? init?.signal
+        signal: attemptController.signal
       });
-      if (retryOnStatus.includes(response.status) && attempt < retries) {
+      if (timeoutId) clearTimeout(timeoutId);
+      signal?.removeEventListener("abort", abortHandler);
+      const isStatusRetryable = retryOnStatus.includes(response.status);
+      const customRetry = shouldRetry ? shouldRetry(response, attempt) : isStatusRetryable;
+      if (customRetry && attempt < retries) {
         const headerDelay = parseRateLimitDelay(response.headers);
         const backoffDelay = computeJitterDelay(attempt, baseDelayMs, maxDelayMs);
         const chosenDelay = Math.min(maxDelayMs, headerDelay ?? backoffDelay);
@@ -147,10 +183,15 @@ async function retryFetch(url, init, options = {}) {
       }
       return response;
     } catch (error) {
-      if (signal?.aborted || error instanceof Error && error.name === "AbortError") {
-        throw error;
+      if (timeoutId) clearTimeout(timeoutId);
+      signal?.removeEventListener("abort", abortHandler);
+      if (signal?.aborted) {
+        throw signal.reason ?? error;
       }
-      if (isTransientNetworkError(error) && attempt < retries) {
+      const isTimeout = error instanceof Error && error.name === "TimeoutError";
+      const isNetworkDrop = isTransientNetworkError(error);
+      const customRetry = shouldRetry ? shouldRetry(error, attempt) : isNetworkDrop || isTimeout;
+      if (customRetry && attempt < retries) {
         const chosenDelay = computeJitterDelay(attempt, baseDelayMs, maxDelayMs);
         onRetry?.(error, attempt + 1, chosenDelay);
         await sleep(chosenDelay, signal);
@@ -169,6 +210,7 @@ async function retry(fn, options = {}) {
     baseDelayMs = 500,
     maxDelayMs = 3e4,
     retryOnStatus = DEFAULT_RETRYABLE_STATUS_CODES,
+    shouldRetry,
     onRetry,
     signal
   } = options;
@@ -191,7 +233,8 @@ async function retry(fn, options = {}) {
       const headers = err?.headers ?? err?.response?.headers;
       const isStatusRetryable = statusCode !== void 0 && retryOnStatus.includes(statusCode);
       const isNetworkRetryable = isTransientNetworkError(error);
-      if (!isStatusRetryable && !isNetworkRetryable) {
+      const customRetry = shouldRetry ? shouldRetry(error, attempt) : isStatusRetryable || isNetworkRetryable;
+      if (!customRetry) {
         throw error;
       }
       let chosenDelay;
@@ -207,7 +250,116 @@ async function retry(fn, options = {}) {
     }
   }
 }
+
+// src/stream.ts
+async function* retryStream(streamFactory, options = {}) {
+  const {
+    retries = 3,
+    baseDelayMs = 500,
+    maxDelayMs = 3e4,
+    onRetry,
+    signal
+  } = options;
+  let attempt = 0;
+  while (true) {
+    if (signal?.aborted) {
+      throw signal.reason ?? new DOMException("The operation was aborted.", "AbortError");
+    }
+    try {
+      const stream = await streamFactory(attempt);
+      for await (const chunk of stream) {
+        if (signal?.aborted) {
+          throw signal.reason ?? new DOMException("The operation was aborted.", "AbortError");
+        }
+        yield chunk;
+      }
+      return;
+    } catch (error) {
+      if (signal?.aborted || error instanceof Error && error.name === "AbortError") {
+        throw error;
+      }
+      if (attempt >= retries) {
+        throw error;
+      }
+      const delay = computeJitterDelay(attempt, baseDelayMs, maxDelayMs);
+      onRetry?.(error, attempt + 1, delay);
+      await sleep(delay, signal);
+      attempt++;
+    }
+  }
+}
+
+// src/circuit-breaker.ts
+var CircuitBreakerOpenError = class extends Error {
+  constructor(message = "Circuit breaker is OPEN. Fast-failing requests.") {
+    super(message);
+    this.name = "CircuitBreakerOpenError";
+  }
+};
+var CircuitBreaker = class {
+  state = "CLOSED";
+  failureCount = 0;
+  lastFailureTime = 0;
+  failureThreshold;
+  resetTimeoutMs;
+  onStateChange;
+  constructor(options = {}) {
+    this.failureThreshold = options.failureThreshold ?? 5;
+    this.resetTimeoutMs = options.resetTimeoutMs ?? 3e4;
+    this.onStateChange = options.onStateChange;
+  }
+  getState() {
+    if (this.state === "OPEN") {
+      const elapsed = Date.now() - this.lastFailureTime;
+      if (elapsed >= this.resetTimeoutMs) {
+        this.transitionTo("HALF_OPEN");
+      }
+    }
+    return this.state;
+  }
+  async execute(fn) {
+    const currentState = this.getState();
+    if (currentState === "OPEN") {
+      throw new CircuitBreakerOpenError();
+    }
+    try {
+      const result = await fn();
+      this.recordSuccess();
+      return result;
+    } catch (error) {
+      this.recordFailure();
+      throw error;
+    }
+  }
+  recordSuccess() {
+    if (this.state === "HALF_OPEN") {
+      this.transitionTo("CLOSED");
+    }
+    this.failureCount = 0;
+  }
+  recordFailure() {
+    this.failureCount++;
+    this.lastFailureTime = Date.now();
+    if (this.state === "HALF_OPEN" || this.failureCount >= this.failureThreshold) {
+      this.transitionTo("OPEN");
+    }
+  }
+  transitionTo(nextState) {
+    const prevState = this.state;
+    if (prevState !== nextState) {
+      this.state = nextState;
+      this.onStateChange?.(prevState, nextState);
+    }
+  }
+  reset() {
+    this.state = "CLOSED";
+    this.failureCount = 0;
+    this.lastFailureTime = 0;
+  }
+};
 export {
+  CircuitBreaker,
+  CircuitBreakerOpenError,
   DEFAULT_RETRYABLE_STATUS_CODES,
   computeJitterDelay,
   isTransientNetworkError,
@@ -215,6 +367,7 @@ export {
   parseRateLimitDelay,
   retry,
   retryFetch,
+  retryStream,
   sleep
 };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/engine.ts","../src/fetch.ts","../src/wrap.ts"],"sourcesContent":["import { HeaderSource } from './types.js';\r\n\r\nexport const DEFAULT_RETRYABLE_STATUS_CODES = [408, 429, 500, 502, 503, 504];\r\n\r\n/**\r\n * Calculates exponential backoff with full jitter:\r\n * sleepMs = min(maxDelayMs, baseDelayMs * 2 ** attempt) * Math.random()\r\n */\r\nexport function computeJitterDelay(\r\n  attempt: number,\r\n  baseDelayMs: number = 500,\r\n  maxDelayMs: number = 30000\r\n): number {\r\n  const exponential = baseDelayMs * Math.pow(2, attempt);\r\n  const ceiling = Math.min(maxDelayMs, exponential);\r\n  return Math.floor(ceiling * Math.random());\r\n}\r\n\r\n/**\r\n * Safely extracts a header value case-insensitively across Headers, records, or tuples.\r\n */\r\nexport function getHeader(headers: HeaderSource, name: string): string | null {\r\n  if (!headers) return null;\r\n\r\n  const target = name.toLowerCase();\r\n\r\n  // Native Web API Headers\r\n  if (typeof (headers as Headers).get === 'function') {\r\n    return (headers as Headers).get(target);\r\n  }\r\n\r\n  // Array of tuples\r\n  if (Array.isArray(headers)) {\r\n    for (const [key, value] of headers) {\r\n      if (key.toLowerCase() === target) {\r\n        return value;\r\n      }\r\n    }\r\n    return null;\r\n  }\r\n\r\n  // Plain object\r\n  if (typeof headers === 'object') {\r\n    for (const key of Object.keys(headers)) {\r\n      if (key.toLowerCase() === target) {\r\n        const val = (headers as Record<string, unknown>)[key];\r\n        if (Array.isArray(val)) return val[0] ?? null;\r\n        return typeof val === 'string' ? val : String(val);\r\n      }\r\n    }\r\n  }\r\n\r\n  return null;\r\n}\r\n\r\n/**\r\n * Parses duration strings returned by LLM APIs (e.g. \"600ms\", \"10s\", \"2m\", \"1m30s\", \"1.5\").\r\n */\r\nexport function parseDurationToMs(value: string): number | null {\r\n  const trimmed = value.trim();\r\n  if (!trimmed) return null;\r\n\r\n  // Pure numeric string represents seconds\r\n  if (/^\\d+(\\.\\d+)?$/.test(trimmed)) {\r\n    const sec = parseFloat(trimmed);\r\n    return isNaN(sec) ? null : Math.max(0, Math.floor(sec * 1000));\r\n  }\r\n\r\n  // Units match\r\n  const regex = /(\\d+(?:\\.\\d+)?)\\s*(ms|s|m|h|d)/gi;\r\n  let match: RegExpExecArray | null;\r\n  let totalMs = 0;\r\n  let matched = false;\r\n\r\n  while ((match = regex.exec(trimmed)) !== null) {\r\n    matched = true;\r\n    const amount = parseFloat(match[1]);\r\n    const unit = match[2].toLowerCase();\r\n\r\n    switch (unit) {\r\n      case 'ms':\r\n        totalMs += amount;\r\n        break;\r\n      case 's':\r\n        totalMs += amount * 1000;\r\n        break;\r\n      case 'm':\r\n        totalMs += amount * 60 * 1000;\r\n        break;\r\n      case 'h':\r\n        totalMs += amount * 60 * 60 * 1000;\r\n        break;\r\n      case 'd':\r\n        totalMs += amount * 24 * 60 * 60 * 1000;\r\n        break;\r\n    }\r\n  }\r\n\r\n  return matched ? Math.max(0, Math.floor(totalMs)) : null;\r\n}\r\n\r\n/**\r\n * Inspects rate-limiting headers and extracts sleep delay in milliseconds:\r\n * - retry-after (seconds or HTTP date)\r\n * - x-ratelimit-reset-requests (OpenAI format)\r\n * - x-ratelimit-reset-tokens (Anthropic format)\r\n */\r\nexport function parseRateLimitDelay(headers: HeaderSource): number | null {\r\n  if (!headers) return null;\r\n\r\n  const retryAfter = getHeader(headers, 'retry-after');\r\n  if (retryAfter) {\r\n    if (/^\\d+(\\.\\d+)?$/.test(retryAfter.trim())) {\r\n      const sec = parseFloat(retryAfter.trim());\r\n      if (!isNaN(sec)) return Math.max(0, Math.floor(sec * 1000));\r\n    }\r\n\r\n    const parsedDate = Date.parse(retryAfter);\r\n    if (!isNaN(parsedDate)) {\r\n      return Math.max(0, parsedDate - Date.now());\r\n    }\r\n  }\r\n\r\n  const openaiReset = getHeader(headers, 'x-ratelimit-reset-requests');\r\n  if (openaiReset) {\r\n    const durationMs = parseDurationToMs(openaiReset);\r\n    if (durationMs !== null) return durationMs;\r\n  }\r\n\r\n  const anthropicReset = getHeader(headers, 'x-ratelimit-reset-tokens');\r\n  if (anthropicReset) {\r\n    const durationMs = parseDurationToMs(anthropicReset);\r\n    if (durationMs !== null) return durationMs;\r\n  }\r\n\r\n  return null;\r\n}\r\n\r\n/**\r\n * Detects transient network drop errors.\r\n */\r\nexport function isTransientNetworkError(error: unknown): boolean {\r\n  if (!(error instanceof Error)) return false;\r\n\r\n  const msg = error.message.toLowerCase();\r\n  const code = (error as { code?: string }).code;\r\n\r\n  if (error.name === 'TypeError' && msg.includes('fetch failed')) return true;\r\n\r\n  const transientCodes = ['ECONNRESET', 'ETIMEDOUT', 'ENOTFOUND', 'EAI_AGAIN', 'ECONNREFUSED'];\r\n  if (code && transientCodes.includes(code)) return true;\r\n\r\n  return (\r\n    msg.includes('network error') ||\r\n    msg.includes('socket hang up') ||\r\n    msg.includes('timeout')\r\n  );\r\n}\r\n\r\n/**\r\n * Sleep helper respecting AbortSignal cancellation.\r\n */\r\nexport function sleep(ms: number, signal?: AbortSignal): Promise<void> {\r\n  return new Promise((resolve, reject) => {\r\n    if (signal?.aborted) {\r\n      return reject(signal.reason ?? new DOMException('The operation was aborted.', 'AbortError'));\r\n    }\r\n\r\n    const timer = setTimeout(() => {\r\n      signal?.removeEventListener('abort', onAbort);\r\n      resolve();\r\n    }, ms);\r\n\r\n    function onAbort() {\r\n      clearTimeout(timer);\r\n      reject(signal?.reason ?? new DOMException('The operation was aborted.', 'AbortError'));\r\n    }\r\n\r\n    signal?.addEventListener('abort', onAbort, { once: true });\r\n  });\r\n}","import {\r\n  computeJitterDelay,\r\n  DEFAULT_RETRYABLE_STATUS_CODES,\r\n  isTransientNetworkError,\r\n  parseRateLimitDelay,\r\n  sleep,\r\n} from './engine.js';\r\nimport { RetryOptions } from './types.js';\r\n\r\nexport async function retryFetch(\r\n  url: string | URL | Request,\r\n  init?: RequestInit,\r\n  options: RetryOptions = {}\r\n): Promise<Response> {\r\n  const {\r\n    retries = 3,\r\n    baseDelayMs = 500,\r\n    maxDelayMs = 30000,\r\n    retryOnStatus = DEFAULT_RETRYABLE_STATUS_CODES,\r\n    onRetry,\r\n    signal,\r\n  } = options;\r\n\r\n  let attempt = 0;\r\n\r\n  while (true) {\r\n    if (signal?.aborted) {\r\n      throw signal.reason ?? new DOMException('The operation was aborted.', 'AbortError');\r\n    }\r\n\r\n    try {\r\n      const response = await fetch(url, {\r\n        ...init,\r\n        signal: signal ?? init?.signal,\r\n      });\r\n\r\n      if (retryOnStatus.includes(response.status) && attempt < retries) {\r\n        const headerDelay = parseRateLimitDelay(response.headers);\r\n        const backoffDelay = computeJitterDelay(attempt, baseDelayMs, maxDelayMs);\r\n        const chosenDelay = Math.min(maxDelayMs, headerDelay ?? backoffDelay);\r\n\r\n        onRetry?.(response, attempt + 1, chosenDelay);\r\n        await sleep(chosenDelay, signal);\r\n        attempt++;\r\n        continue;\r\n      }\r\n\r\n      return response;\r\n    } catch (error) {\r\n      if (signal?.aborted || (error instanceof Error && error.name === 'AbortError')) {\r\n        throw error;\r\n      }\r\n\r\n      if (isTransientNetworkError(error) && attempt < retries) {\r\n        const chosenDelay = computeJitterDelay(attempt, baseDelayMs, maxDelayMs);\r\n        onRetry?.(error, attempt + 1, chosenDelay);\r\n        await sleep(chosenDelay, signal);\r\n        attempt++;\r\n        continue;\r\n      }\r\n\r\n      throw error;\r\n    }\r\n  }\r\n}","import {\r\n  computeJitterDelay,\r\n  DEFAULT_RETRYABLE_STATUS_CODES,\r\n  isTransientNetworkError,\r\n  parseRateLimitDelay,\r\n  sleep,\r\n} from './engine.js';\r\nimport { HeaderSource, RetryOptions } from './types.js';\r\n\r\ninterface ErrorWithStatus extends Error {\r\n  status?: number;\r\n  statusCode?: number;\r\n  headers?: HeaderSource;\r\n  response?: {\r\n    status?: number;\r\n    headers?: HeaderSource;\r\n  };\r\n}\r\n\r\nexport async function retry<T>(\r\n  fn: (attempt: number) => Promise<T>,\r\n  options: RetryOptions = {}\r\n): Promise<T> {\r\n  const {\r\n    retries = 3,\r\n    baseDelayMs = 500,\r\n    maxDelayMs = 30000,\r\n    retryOnStatus = DEFAULT_RETRYABLE_STATUS_CODES,\r\n    onRetry,\r\n    signal,\r\n  } = options;\r\n\r\n  let attempt = 0;\r\n\r\n  while (true) {\r\n    if (signal?.aborted) {\r\n      throw signal.reason ?? new DOMException('The operation was aborted.', 'AbortError');\r\n    }\r\n\r\n    try {\r\n      return await fn(attempt);\r\n    } catch (error) {\r\n      if (signal?.aborted || (error instanceof Error && error.name === 'AbortError')) {\r\n        throw error;\r\n      }\r\n\r\n      if (attempt >= retries) {\r\n        throw error;\r\n      }\r\n\r\n      const err = error as ErrorWithStatus;\r\n      const statusCode = err?.status ?? err?.statusCode ?? err?.response?.status;\r\n      const headers = err?.headers ?? err?.response?.headers;\r\n\r\n      const isStatusRetryable = statusCode !== undefined && retryOnStatus.includes(statusCode);\r\n      const isNetworkRetryable = isTransientNetworkError(error);\r\n\r\n      if (!isStatusRetryable && !isNetworkRetryable) {\r\n        throw error;\r\n      }\r\n\r\n      let chosenDelay: number;\r\n      const headerDelay = headers ? parseRateLimitDelay(headers) : null;\r\n\r\n      if (headerDelay !== null) {\r\n        chosenDelay = Math.min(maxDelayMs, headerDelay);\r\n      } else {\r\n        chosenDelay = computeJitterDelay(attempt, baseDelayMs, maxDelayMs);\r\n      }\r\n\r\n      onRetry?.(error, attempt + 1, chosenDelay);\r\n      await sleep(chosenDelay, signal);\r\n      attempt++;\r\n    }\r\n  }\r\n}"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/engine.ts","../src/fetch.ts","../src/wrap.ts","../src/stream.ts","../src/circuit-breaker.ts"],"sourcesContent":["import { HeaderSource } from './types.js';\r\n\r\nexport const DEFAULT_RETRYABLE_STATUS_CODES = [408, 429, 500, 502, 503, 504];\r\n\r\n/**\r\n * Calculates exponential backoff with full jitter:\r\n * sleepMs = min(maxDelayMs, baseDelayMs * 2 ** attempt) * Math.random()\r\n */\r\nexport function computeJitterDelay(\r\n  attempt: number,\r\n  baseDelayMs: number = 500,\r\n  maxDelayMs: number = 30000\r\n): number {\r\n  const exponential = baseDelayMs * Math.pow(2, attempt);\r\n  const ceiling = Math.min(maxDelayMs, exponential);\r\n  return Math.floor(ceiling * Math.random());\r\n}\r\n\r\n/**\r\n * Safely extracts a header value case-insensitively across Headers instances, records, or tuples.\r\n */\r\nexport function getHeader(headers: HeaderSource, name: string): string | null {\r\n  if (!headers) return null;\r\n\r\n  const target = name.toLowerCase();\r\n\r\n  if (typeof (headers as Headers).get === 'function') {\r\n    return (headers as Headers).get(target);\r\n  }\r\n\r\n  if (Array.isArray(headers)) {\r\n    for (const [key, value] of headers) {\r\n      if (key.toLowerCase() === target) {\r\n        return value;\r\n      }\r\n    }\r\n    return null;\r\n  }\r\n\r\n  if (typeof headers === 'object') {\r\n    for (const key of Object.keys(headers)) {\r\n      if (key.toLowerCase() === target) {\r\n        const val = (headers as Record<string, unknown>)[key];\r\n        if (Array.isArray(val)) return val[0] ?? null;\r\n        return typeof val === 'string' ? val : String(val);\r\n      }\r\n    }\r\n  }\r\n\r\n  return null;\r\n}\r\n\r\n/**\r\n * Parses duration strings returned by LLM APIs (e.g. \"600ms\", \"10s\", \"2m\", \"1m30s\", \"1.5\").\r\n */\r\nexport function parseDurationToMs(value: string): number | null {\r\n  const trimmed = value.trim();\r\n  if (!trimmed) return null;\r\n\r\n  if (/^\\d+(\\.\\d+)?$/.test(trimmed)) {\r\n    const sec = parseFloat(trimmed);\r\n    return isNaN(sec) ? null : Math.max(0, Math.floor(sec * 1000));\r\n  }\r\n\r\n  const regex = /(\\d+(?:\\.\\d+)?)\\s*(ms|s|m|h|d)/gi;\r\n  let match: RegExpExecArray | null;\r\n  let totalMs = 0;\r\n  let matched = false;\r\n\r\n  while ((match = regex.exec(trimmed)) !== null) {\r\n    matched = true;\r\n    const amount = parseFloat(match[1]);\r\n    const unit = match[2].toLowerCase();\r\n\r\n    switch (unit) {\r\n      case 'ms':\r\n        totalMs += amount;\r\n        break;\r\n      case 's':\r\n        totalMs += amount * 1000;\r\n        break;\r\n      case 'm':\r\n        totalMs += amount * 60 * 1000;\r\n        break;\r\n      case 'h':\r\n        totalMs += amount * 60 * 60 * 1000;\r\n        break;\r\n      case 'd':\r\n        totalMs += amount * 24 * 60 * 60 * 1000;\r\n        break;\r\n    }\r\n  }\r\n\r\n  return matched ? Math.max(0, Math.floor(totalMs)) : null;\r\n}\r\n\r\n/**\r\n * Exhaustively checks provider headers across:\r\n * - RFC 7231 / RFC 6585 standard `retry-after`\r\n * - OpenAI: `x-ratelimit-reset-requests`, `x-ratelimit-reset-tokens`\r\n * - Anthropic: `anthropic-ratelimit-requests-reset`, `anthropic-ratelimit-tokens-reset`\r\n * - Groq / DeepSeek / Mistral: `x-ratelimit-reset-total`, `retry-after-ms`\r\n */\r\nexport function parseRateLimitDelay(headers: HeaderSource): number | null {\r\n  if (!headers) return null;\r\n\r\n  // 1. Direct milliseconds header (Groq, custom proxies)\r\n  const retryAfterMs = getHeader(headers, 'retry-after-ms');\r\n  if (retryAfterMs) {\r\n    const parsed = parseFloat(retryAfterMs);\r\n    if (!isNaN(parsed)) return Math.max(0, Math.floor(parsed));\r\n  }\r\n\r\n  // 2. Standard Retry-After (seconds or RFC 1123 HTTP Date)\r\n  const retryAfter = getHeader(headers, 'retry-after');\r\n  if (retryAfter) {\r\n    if (/^\\d+(\\.\\d+)?$/.test(retryAfter.trim())) {\r\n      const sec = parseFloat(retryAfter.trim());\r\n      if (!isNaN(sec)) return Math.max(0, Math.floor(sec * 1000));\r\n    }\r\n\r\n    const parsedDate = Date.parse(retryAfter);\r\n    if (!isNaN(parsedDate)) {\r\n      return Math.max(0, parsedDate - Date.now());\r\n    }\r\n  }\r\n\r\n  // 3. Provider-specific reset headers\r\n  const candidateKeys = [\r\n    'x-ratelimit-reset-requests',\r\n    'x-ratelimit-reset-tokens',\r\n    'anthropic-ratelimit-requests-reset',\r\n    'anthropic-ratelimit-tokens-reset',\r\n    'x-ratelimit-reset-total',\r\n  ];\r\n\r\n  for (const key of candidateKeys) {\r\n    const raw = getHeader(headers, key);\r\n    if (raw) {\r\n      const ms = parseDurationToMs(raw);\r\n      if (ms !== null) return ms;\r\n\r\n      // Handle epoch timestamp formats\r\n      const epochSec = parseFloat(raw);\r\n      if (!isNaN(epochSec) && epochSec > 1000000000) {\r\n        return Math.max(0, Math.floor(epochSec * 1000 - Date.now()));\r\n      }\r\n    }\r\n  }\r\n\r\n  return null;\r\n}\r\n\r\n/**\r\n * Detects transient network drop errors across Node, Bun, Deno, and browsers.\r\n */\r\nexport function isTransientNetworkError(error: unknown): boolean {\r\n  if (!(error instanceof Error)) return false;\r\n\r\n  const msg = error.message.toLowerCase();\r\n  const code = (error as { code?: string }).code;\r\n\r\n  if (error.name === 'TypeError' && msg.includes('fetch failed')) return true;\r\n\r\n  const transientCodes = [\r\n    'ECONNRESET',\r\n    'ETIMEDOUT',\r\n    'ENOTFOUND',\r\n    'EAI_AGAIN',\r\n    'ECONNREFUSED',\r\n    'UND_ERR_CONNECT_TIMEOUT',\r\n    'UND_ERR_SOCKET',\r\n  ];\r\n  if (code && transientCodes.includes(code)) return true;\r\n\r\n  return (\r\n    msg.includes('network error') ||\r\n    msg.includes('socket hang up') ||\r\n    msg.includes('terminated') ||\r\n    msg.includes('econnreset')\r\n  );\r\n}\r\n\r\n/**\r\n * Promisified sleep that respects AbortSignal cancellation.\r\n */\r\nexport function sleep(ms: number, signal?: AbortSignal): Promise<void> {\r\n  return new Promise((resolve, reject) => {\r\n    if (signal?.aborted) {\r\n      return reject(signal.reason ?? new DOMException('The operation was aborted.', 'AbortError'));\r\n    }\r\n\r\n    const timer = setTimeout(() => {\r\n      signal?.removeEventListener('abort', onAbort);\r\n      resolve();\r\n    }, ms);\r\n\r\n    function onAbort() {\r\n      clearTimeout(timer);\r\n      reject(signal?.reason ?? new DOMException('The operation was aborted.', 'AbortError'));\r\n    }\r\n\r\n    signal?.addEventListener('abort', onAbort, { once: true });\r\n  });\r\n}","import {\r\n  computeJitterDelay,\r\n  DEFAULT_RETRYABLE_STATUS_CODES,\r\n  isTransientNetworkError,\r\n  parseRateLimitDelay,\r\n  sleep,\r\n} from './engine.js';\r\nimport { RetryOptions } from './types.js';\r\n\r\nexport async function retryFetch(\r\n  url: string | URL | Request,\r\n  init?: RequestInit,\r\n  options: RetryOptions = {}\r\n): Promise<Response> {\r\n  const {\r\n    retries = 3,\r\n    baseDelayMs = 500,\r\n    maxDelayMs = 30000,\r\n    timeoutMs,\r\n    retryOnStatus = DEFAULT_RETRYABLE_STATUS_CODES,\r\n    shouldRetry,\r\n    onRetry,\r\n    signal,\r\n  } = options;\r\n\r\n  let attempt = 0;\r\n\r\n  while (true) {\r\n    if (signal?.aborted) {\r\n      throw signal.reason ?? new DOMException('The operation was aborted.', 'AbortError');\r\n    }\r\n\r\n    // Set up per-attempt timeout controller\r\n    const attemptController = new AbortController();\r\n    let timeoutId: ReturnType<typeof setTimeout> | undefined;\r\n\r\n    if (timeoutMs && timeoutMs > 0) {\r\n      timeoutId = setTimeout(() => {\r\n        attemptController.abort(new DOMException(`Request timed out after ${timeoutMs}ms`, 'TimeoutError'));\r\n      }, timeoutMs);\r\n    }\r\n\r\n    const abortHandler = () => attemptController.abort(signal?.reason);\r\n    signal?.addEventListener('abort', abortHandler, { once: true });\r\n\r\n    try {\r\n      const response = await fetch(url, {\r\n        ...init,\r\n        signal: attemptController.signal,\r\n      });\r\n\r\n      if (timeoutId) clearTimeout(timeoutId);\r\n      signal?.removeEventListener('abort', abortHandler);\r\n\r\n      const isStatusRetryable = retryOnStatus.includes(response.status);\r\n      const customRetry = shouldRetry ? shouldRetry(response, attempt) : isStatusRetryable;\r\n\r\n      if (customRetry && attempt < retries) {\r\n        const headerDelay = parseRateLimitDelay(response.headers);\r\n        const backoffDelay = computeJitterDelay(attempt, baseDelayMs, maxDelayMs);\r\n        const chosenDelay = Math.min(maxDelayMs, headerDelay ?? backoffDelay);\r\n\r\n        onRetry?.(response, attempt + 1, chosenDelay);\r\n        await sleep(chosenDelay, signal);\r\n        attempt++;\r\n        continue;\r\n      }\r\n\r\n      return response;\r\n    } catch (error) {\r\n      if (timeoutId) clearTimeout(timeoutId);\r\n      signal?.removeEventListener('abort', abortHandler);\r\n\r\n      // Do not retry intentional outer aborts\r\n      if (signal?.aborted) {\r\n        throw signal.reason ?? error;\r\n      }\r\n\r\n      const isTimeout = error instanceof Error && error.name === 'TimeoutError';\r\n      const isNetworkDrop = isTransientNetworkError(error);\r\n      const customRetry = shouldRetry ? shouldRetry(error, attempt) : (isNetworkDrop || isTimeout);\r\n\r\n      if (customRetry && attempt < retries) {\r\n        const chosenDelay = computeJitterDelay(attempt, baseDelayMs, maxDelayMs);\r\n        onRetry?.(error, attempt + 1, chosenDelay);\r\n        await sleep(chosenDelay, signal);\r\n        attempt++;\r\n        continue;\r\n      }\r\n\r\n      throw error;\r\n    }\r\n  }\r\n}","import {\r\n  computeJitterDelay,\r\n  DEFAULT_RETRYABLE_STATUS_CODES,\r\n  isTransientNetworkError,\r\n  parseRateLimitDelay,\r\n  sleep,\r\n} from './engine.js';\r\nimport { HeaderSource, RetryOptions } from './types.js';\r\n\r\ninterface ErrorWithStatus extends Error {\r\n  status?: number;\r\n  statusCode?: number;\r\n  headers?: HeaderSource;\r\n  response?: {\r\n    status?: number;\r\n    headers?: HeaderSource;\r\n  };\r\n}\r\n\r\nexport async function retry<T>(\r\n  fn: (attempt: number) => Promise<T>,\r\n  options: RetryOptions = {}\r\n): Promise<T> {\r\n  const {\r\n    retries = 3,\r\n    baseDelayMs = 500,\r\n    maxDelayMs = 30000,\r\n    retryOnStatus = DEFAULT_RETRYABLE_STATUS_CODES,\r\n    shouldRetry,\r\n    onRetry,\r\n    signal,\r\n  } = options;\r\n\r\n  let attempt = 0;\r\n\r\n  while (true) {\r\n    if (signal?.aborted) {\r\n      throw signal.reason ?? new DOMException('The operation was aborted.', 'AbortError');\r\n    }\r\n\r\n    try {\r\n      return await fn(attempt);\r\n    } catch (error) {\r\n      if (signal?.aborted || (error instanceof Error && error.name === 'AbortError')) {\r\n        throw error;\r\n      }\r\n\r\n      if (attempt >= retries) {\r\n        throw error;\r\n      }\r\n\r\n      const err = error as ErrorWithStatus;\r\n      const statusCode = err?.status ?? err?.statusCode ?? err?.response?.status;\r\n      const headers = err?.headers ?? err?.response?.headers;\r\n\r\n      const isStatusRetryable = statusCode !== undefined && retryOnStatus.includes(statusCode);\r\n      const isNetworkRetryable = isTransientNetworkError(error);\r\n      const customRetry = shouldRetry\r\n        ? shouldRetry(error, attempt)\r\n        : (isStatusRetryable || isNetworkRetryable);\r\n\r\n      if (!customRetry) {\r\n        throw error;\r\n      }\r\n\r\n      let chosenDelay: number;\r\n      const headerDelay = headers ? parseRateLimitDelay(headers) : null;\r\n\r\n      if (headerDelay !== null) {\r\n        chosenDelay = Math.min(maxDelayMs, headerDelay);\r\n      } else {\r\n        chosenDelay = computeJitterDelay(attempt, baseDelayMs, maxDelayMs);\r\n      }\r\n\r\n      onRetry?.(error, attempt + 1, chosenDelay);\r\n      await sleep(chosenDelay, signal);\r\n      attempt++;\r\n    }\r\n  }\r\n}","import { computeJitterDelay, sleep } from './engine.js';\r\nimport { RetryOptions } from './types.js';\r\n\r\n/**\r\n * Resilient wrapper for Server-Sent Events / LLM chunk streams.\r\n * If the streaming connection drops mid-generation, it retries and resumes.\r\n */\r\nexport async function* retryStream<T>(\r\n  streamFactory: (attempt: number) => Promise<AsyncIterable<T>>,\r\n  options: RetryOptions = {}\r\n): AsyncGenerator<T, void, unknown> {\r\n  const {\r\n    retries = 3,\r\n    baseDelayMs = 500,\r\n    maxDelayMs = 30000,\r\n    onRetry,\r\n    signal,\r\n  } = options;\r\n\r\n  let attempt = 0;\r\n\r\n  while (true) {\r\n    if (signal?.aborted) {\r\n      throw signal.reason ?? new DOMException('The operation was aborted.', 'AbortError');\r\n    }\r\n\r\n    try {\r\n      const stream = await streamFactory(attempt);\r\n      for await (const chunk of stream) {\r\n        if (signal?.aborted) {\r\n          throw signal.reason ?? new DOMException('The operation was aborted.', 'AbortError');\r\n        }\r\n        yield chunk;\r\n      }\r\n      return;\r\n    } catch (error) {\r\n      if (signal?.aborted || (error instanceof Error && error.name === 'AbortError')) {\r\n        throw error;\r\n      }\r\n\r\n      if (attempt >= retries) {\r\n        throw error;\r\n      }\r\n\r\n      const delay = computeJitterDelay(attempt, baseDelayMs, maxDelayMs);\r\n      onRetry?.(error, attempt + 1, delay);\r\n      await sleep(delay, signal);\r\n      attempt++;\r\n    }\r\n  }\r\n}","import { CircuitBreakerOptions, CircuitState } from './types.js';\r\n\r\nexport class CircuitBreakerOpenError extends Error {\r\n  constructor(message: string = 'Circuit breaker is OPEN. Fast-failing requests.') {\r\n    super(message);\r\n    this.name = 'CircuitBreakerOpenError';\r\n  }\r\n}\r\n\r\n/**\r\n * Zero-dependency Circuit Breaker implementation to stop cascading failure\r\n * cascades when downstream LLM APIs experience total outages.\r\n */\r\nexport class CircuitBreaker {\r\n  private state: CircuitState = 'CLOSED';\r\n  private failureCount: number = 0;\r\n  private lastFailureTime: number = 0;\r\n  private readonly failureThreshold: number;\r\n  private readonly resetTimeoutMs: number;\r\n  private readonly onStateChange?: (from: CircuitState, to: CircuitState) => void;\r\n\r\n  constructor(options: CircuitBreakerOptions = {}) {\r\n    this.failureThreshold = options.failureThreshold ?? 5;\r\n    this.resetTimeoutMs = options.resetTimeoutMs ?? 30000;\r\n    this.onStateChange = options.onStateChange;\r\n  }\r\n\r\n  public getState(): CircuitState {\r\n    if (this.state === 'OPEN') {\r\n      const elapsed = Date.now() - this.lastFailureTime;\r\n      if (elapsed >= this.resetTimeoutMs) {\r\n        this.transitionTo('HALF_OPEN');\r\n      }\r\n    }\r\n    return this.state;\r\n  }\r\n\r\n  public async execute<T>(fn: () => Promise<T>): Promise<T> {\r\n    const currentState = this.getState();\r\n\r\n    if (currentState === 'OPEN') {\r\n      throw new CircuitBreakerOpenError();\r\n    }\r\n\r\n    try {\r\n      const result = await fn();\r\n      this.recordSuccess();\r\n      return result;\r\n    } catch (error) {\r\n      this.recordFailure();\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  private recordSuccess(): void {\r\n    if (this.state === 'HALF_OPEN') {\r\n      this.transitionTo('CLOSED');\r\n    }\r\n    this.failureCount = 0;\r\n  }\r\n\r\n  private recordFailure(): void {\r\n    this.failureCount++;\r\n    this.lastFailureTime = Date.now();\r\n\r\n    if (this.state === 'HALF_OPEN' || this.failureCount >= this.failureThreshold) {\r\n      this.transitionTo('OPEN');\r\n    }\r\n  }\r\n\r\n  private transitionTo(nextState: CircuitState): void {\r\n    const prevState = this.state;\r\n    if (prevState !== nextState) {\r\n      this.state = nextState;\r\n      this.onStateChange?.(prevState, nextState);\r\n    }\r\n  }\r\n\r\n  public reset(): void {\r\n    this.state = 'CLOSED';\r\n    this.failureCount = 0;\r\n    this.lastFailureTime = 0;\r\n  }\r\n}"],"mappings":"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","names":[]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rohan9024/retrykit",
-  "version": "0.1.0",
-  "description": "Zero-dependency, header-aware network retry library tailored for LLM APIs and fetch.",
+  "version": "0.2.0",
+  "description": "The ultimate zero-dependency, header-aware retry engine and circuit breaker for LLM APIs (OpenAI, Anthropic, DeepSeek, Groq).",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
@@ -27,28 +27,27 @@
   },
   "keywords": [
     "retry",
-    "fetch",
     "llm",
     "openai",
     "anthropic",
-    "backoff",
-    "jitter",
-    "exponential-backoff",
+    "deepseek",
+    "groq",
+    "fetch",
+    "circuit-breaker",
+    "streaming",
     "rate-limit",
-    "retry-after"
+    "backoff",
+    "jitter"
   ],
-  "author": "",
+  "author": "rohan9024",
   "license": "MIT",
   "devDependencies": {
-    "@types/node": "^22.20.5",
-    "tsup": "^8.5.1",
-    "typescript": "^5.9.3",
-    "vitest": "^2.1.9"
+    "@types/node": "^22.0.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
   },
   "engines": {
     "node": ">=18.0.0"
-  },
-  "directories": {
-    "test": "test"
   }
-}
+}