@fgrzl/fetch 1.1.0-alpha.3 → 1.1.0-alpha.8

package/dist/cjs/middleware/rate-limit/rate-limit.js

@@ -0,0 +1,87 @@
+"use strict";
+/**
+ * @fileoverview Rate limiting middleware implementation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRateLimitMiddleware = createRateLimitMiddleware;
+/**
+ * Simple token bucket implementation for rate limiting.
+ */
+class TokenBucket {
+    constructor(maxTokens, refillRate, // tokens per millisecond
+    timeProvider = () => Date.now()) {
+        this.maxTokens = maxTokens;
+        this.refillRate = refillRate;
+        this.timeProvider = timeProvider;
+        this.tokens = maxTokens;
+        this.lastRefill = this.timeProvider();
+    }
+    tryConsume() {
+        this.refill();
+        if (this.tokens >= 1) {
+            this.tokens--;
+            return { allowed: true };
+        }
+        // Calculate when next token will be available
+        const retryAfter = (1 - this.tokens) / this.refillRate;
+        return { allowed: false, retryAfter: Math.ceil(retryAfter) };
+    }
+    refill() {
+        const now = this.timeProvider();
+        const timePassed = now - this.lastRefill;
+        const tokensToAdd = timePassed * this.refillRate;
+        this.tokens = Math.min(this.maxTokens, this.tokens + tokensToAdd);
+        this.lastRefill = now;
+    }
+}
+/**
+ * Creates rate limiting middleware - mainly for API quota management.
+ * Note: Rate limiting is typically a server concern, but this can help with:
+ * - Respecting API provider limits
+ * - Preventing runaway requests in bulk operations
+ * - Cost management for pay-per-request APIs
+ */
+function createRateLimitMiddleware(options = {}) {
+    const { maxRequests = 60, windowMs = 60000, keyGenerator = () => 'default', skipPatterns = [], onRateLimitExceeded, } = options;
+    const buckets = new Map();
+    const refillRate = maxRequests / windowMs;
+    return async (request, next) => {
+        const url = request.url || '';
+        // Skip rate limiting if URL matches skip patterns
+        if (skipPatterns.some((pattern) => typeof pattern === 'string' ? url.includes(pattern) : pattern.test(url))) {
+            return next(request);
+        }
+        const key = keyGenerator(request);
+        if (!buckets.has(key)) {
+            buckets.set(key, new TokenBucket(maxRequests, refillRate));
+        }
+        const bucket = buckets.get(key);
+        const result = bucket.tryConsume();
+        if (!result.allowed) {
+            if (onRateLimitExceeded) {
+                const customResponse = await onRateLimitExceeded(result.retryAfter || 0, request);
+                // If the custom handler returns a response, use it
+                if (customResponse) {
+                    return customResponse;
+                }
+            }
+            // Return a 429 Too Many Requests response instead of throwing
+            return {
+                data: null,
+                status: 429,
+                statusText: 'Too Many Requests',
+                headers: new Headers({
+                    'Retry-After': Math.ceil((result.retryAfter || 0) / 1000).toString(),
+                }),
+                url: request.url || '',
+                ok: false,
+                error: {
+                    message: `Rate limit exceeded. Retry after ${result.retryAfter}ms`,
+                    body: { retryAfter: result.retryAfter },
+                },
+            };
+        }
+        return next(request);
+    };
+}
+//# sourceMappingURL=rate-limit.js.map

package/dist/cjs/middleware/rate-limit/rate-limit.js.map

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

package/dist/cjs/middleware/rate-limit/types.d.ts

@@ -0,0 +1,97 @@
+/**
+ * @fileoverview Rate limiting middleware types and configuration.
+ */
+/**
+ * Rate limiting algorithm types.
+ */
+export type RateLimitAlgorithm = 'token-bucket' | 'sliding-window' | 'fixed-window';
+/**
+ * Rate limiting configuration options - optimized for "pit of success".
+ *
+ * Smart defaults:
+ * - 60 requests per minute
+ * - Token bucket algorithm
+ * - Per-client limiting
+ * - Graceful handling when rate limit exceeded
+ */
+export interface RateLimitOptions {
+    /**
+     * Maximum number of requests allowed (default: 60)
+     */
+    maxRequests?: number;
+    /**
+     * Time window in milliseconds (default: 60000 = 1 minute)
+     */
+    windowMs?: number;
+    /**
+     * Rate limiting algorithm (default: 'token-bucket')
+     * - 'token-bucket': Allows bursts up to maxRequests, refills over time
+     * - 'sliding-window': Smooth rate limiting over rolling window
+     * - 'fixed-window': Fixed number of requests per fixed time window
+     */
+    algorithm?: RateLimitAlgorithm;
+    /**
+     * Custom key generator for rate limiting scope
+     * Default: single global rate limit for all requests
+     *
+     * @example Per-endpoint rate limiting:
+     * ```typescript
+     * keyGenerator: (request) => request.url || 'default'
+     * ```
+     *
+     * @example Per-user rate limiting:
+     * ```typescript
+     * keyGenerator: (request) => {
+     *   const auth = request.headers?.get('Authorization');
+     *   return auth ? `user:${auth}` : 'anonymous';
+     * }
+     * ```
+     */
+    keyGenerator?: (request: RequestInit & {
+        url?: string;
+    }) => string;
+    /**
+     * Skip rate limiting for requests matching these URL patterns
+     *
+     * @example
+     * ```typescript
+     * skipPatterns: ['/health', /^\/public\//]
+     * ```
+     */
+    skipPatterns?: (RegExp | string)[];
+    /**
+     * Custom handler called when rate limit is exceeded
+     * Can return a custom response or void to use default behavior
+     *
+     * @param retryAfter - Milliseconds until next request is allowed
+     * @param request - The rate-limited request
+     * @returns Custom response or void for default behavior
+     */
+    onRateLimitExceeded?: (retryAfter: number, request: RequestInit & {
+        url?: string;
+    }) => void | Promise<void> | {
+        data: unknown;
+        status: number;
+        statusText: string;
+        headers: Headers;
+        url: string;
+        ok: boolean;
+        error?: {
+            message: string;
+            body?: unknown;
+        };
+    } | Promise<{
+        data: unknown;
+        status: number;
+        statusText: string;
+        headers: Headers;
+        url: string;
+        ok: boolean;
+        error?: {
+            message: string;
+            body?: unknown;
+        };
+    }>;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/middleware/rate-limit/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/middleware/rate-limit/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,cAAc,GACd,gBAAgB,GAChB,cAAc,CAAC;AAEnB;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAE/B;;;;;;;;;;;;;;;;OAgBG;IACH,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,GAAG;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAC;IAEnE;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAEnC;;;;;;;OAOG;IACH,mBAAmB,CAAC,EAAE,CACpB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,WAAW,GAAG;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,KACpC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG;QAC1B,IAAI,EAAE,OAAO,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,OAAO,CAAC;QACjB,GAAG,EAAE,MAAM,CAAC;QACZ,EAAE,EAAE,OAAO,CAAC;QACZ,KAAK,CAAC,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;KAC7C,GAAG,OAAO,CAAC;QACV,IAAI,EAAE,OAAO,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,OAAO,CAAC;QACjB,GAAG,EAAE,MAAM,CAAC;QACZ,EAAE,EAAE,OAAO,CAAC;QACZ,KAAK,CAAC,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;KAC7C,CAAC,CAAC;CACJ;AAGD,OAAO,EAAE,CAAC"}

package/dist/cjs/middleware/rate-limit/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * @fileoverview Rate limiting middleware types and configuration.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/middleware/rate-limit/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/middleware/rate-limit/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/cjs/middleware/retry/index.d.ts

@@ -0,0 +1,6 @@
+import type { FetchClient } from '../../client/fetch-client';
+import type { RetryOptions } from './types';
+export type { RetryOptions } from './types';
+export { createRetryMiddleware } from './retry';
+export declare function useRetry(client: FetchClient, options?: RetryOptions): FetchClient;
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/middleware/retry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/middleware/retry/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAG5C,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAEhD,wBAAgB,QAAQ,CACtB,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,YAAiB,GACzB,WAAW,CAEb"}

package/dist/cjs/middleware/retry/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRetryMiddleware = void 0;
+exports.useRetry = useRetry;
+const retry_1 = require("./retry");
+var retry_2 = require("./retry");
+Object.defineProperty(exports, "createRetryMiddleware", { enumerable: true, get: function () { return retry_2.createRetryMiddleware; } });
+function useRetry(client, options = {}) {
+    return client.use((0, retry_1.createRetryMiddleware)(options));
+}
+//# sourceMappingURL=index.js.map

package/dist/cjs/middleware/retry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/middleware/retry/index.ts"],"names":[],"mappings":";;;AAOA,4BAKC;AAVD,mCAAgD;AAGhD,iCAAgD;AAAvC,8GAAA,qBAAqB,OAAA;AAE9B,SAAgB,QAAQ,CACtB,MAAmB,EACnB,UAAwB,EAAE;IAE1B,OAAO,MAAM,CAAC,GAAG,CAAC,IAAA,6BAAqB,EAAC,OAAO,CAAC,CAAC,CAAC;AACpD,CAAC"}

package/dist/cjs/middleware/retry/retry.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @fileoverview Retry middleware implementation with enhanced architecture.
+ */
+import type { FetchMiddleware } from '../../client/fetch-client';
+import type { RetryOptions } from './types';
+/**
+ * Creates a retry middleware with smart defaults.
+ *
+ * 🎯 PIT OF SUCCESS: Works great with no config, customizable when needed.
+ *
+ * Features:
+ * - ✅ Preserves full middleware chain on retries (unlike old implementation)
+ * - ✅ Exponential backoff with jitter
+ * - ✅ Smart retry conditions (network errors + 5xx)
+ * - ✅ Configurable but sensible defaults
+ * - ✅ Type-safe configuration
+ *
+ * @param options - Retry configuration (all optional)
+ * @returns Middleware function
+ *
+ * @example Basic usage:
+ * ```typescript
+ * const client = new FetchClient();
+ * client.use(createRetryMiddleware()); // 3 retries with exponential backoff
+ * ```
+ *
+ * @example Custom configuration:
+ * ```typescript
+ * const client = new FetchClient();
+ * client.use(createRetryMiddleware({
+ *   maxRetries: 5,
+ *   delay: 500,
+ *   backoff: 'linear',
+ *   onRetry: (attempt, delay) => console.log(`Retry ${attempt} in ${delay}ms`)
+ * }));
+ * ```
+ */
+export declare function createRetryMiddleware(options?: RetryOptions): FetchMiddleware;
+//# sourceMappingURL=retry.d.ts.map

package/dist/cjs/middleware/retry/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../../src/middleware/retry/retry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAgD5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,GAAE,YAAiB,GACzB,eAAe,CAgGjB"}

package/dist/cjs/middleware/retry/retry.js

@@ -0,0 +1,144 @@
+"use strict";
+/**
+ * @fileoverview Retry middleware implementation with enhanced architecture.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRetryMiddleware = createRetryMiddleware;
+/**
+ * Default retry condition - retry on network errors and 5xx server errors.
+ */
+const defaultShouldRetry = (response) => {
+    // Network errors (status 0) or server errors (5xx)
+    return (response.status === 0 || (response.status >= 500 && response.status < 600));
+};
+/**
+ * Calculate delay for retry attempt based on backoff strategy.
+ */
+const calculateDelay = (attempt, baseDelay, backoff, maxDelay) => {
+    let delay;
+    switch (backoff) {
+        case 'exponential':
+            delay = baseDelay * Math.pow(2, attempt - 1);
+            break;
+        case 'linear':
+            delay = baseDelay * attempt;
+            break;
+        case 'fixed':
+        default:
+            delay = baseDelay;
+            break;
+    }
+    return Math.min(delay, maxDelay);
+};
+/**
+ * Sleep for specified duration.
+ */
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/**
+ * Creates a retry middleware with smart defaults.
+ *
+ * 🎯 PIT OF SUCCESS: Works great with no config, customizable when needed.
+ *
+ * Features:
+ * - ✅ Preserves full middleware chain on retries (unlike old implementation)
+ * - ✅ Exponential backoff with jitter
+ * - ✅ Smart retry conditions (network errors + 5xx)
+ * - ✅ Configurable but sensible defaults
+ * - ✅ Type-safe configuration
+ *
+ * @param options - Retry configuration (all optional)
+ * @returns Middleware function
+ *
+ * @example Basic usage:
+ * ```typescript
+ * const client = new FetchClient();
+ * client.use(createRetryMiddleware()); // 3 retries with exponential backoff
+ * ```
+ *
+ * @example Custom configuration:
+ * ```typescript
+ * const client = new FetchClient();
+ * client.use(createRetryMiddleware({
+ *   maxRetries: 5,
+ *   delay: 500,
+ *   backoff: 'linear',
+ *   onRetry: (attempt, delay) => console.log(`Retry ${attempt} in ${delay}ms`)
+ * }));
+ * ```
+ */
+function createRetryMiddleware(options = {}) {
+    const { maxRetries = 3, delay = 1000, backoff = 'exponential', maxDelay = 30000, shouldRetry = defaultShouldRetry, onRetry, } = options;
+    return async (request, next) => {
+        let lastResponse;
+        let attempt = 0;
+        while (attempt <= maxRetries) {
+            try {
+                // Execute the request through the middleware chain
+                const response = await next(request);
+                // If successful, return immediately
+                if (response.ok) {
+                    return response;
+                }
+                // Check if we should retry this response with current attempt count
+                if (!shouldRetry({ status: response.status, ok: response.ok }, attempt + 1)) {
+                    return response;
+                }
+                // If we've reached max retries, return the response
+                if (attempt >= maxRetries) {
+                    return response;
+                }
+                // Store the failed response and increment attempt counter
+                lastResponse = response;
+                attempt++;
+                // Calculate delay for next attempt
+                const retryDelay = calculateDelay(attempt, delay, backoff, maxDelay);
+                // Call onRetry callback if provided
+                if (onRetry) {
+                    onRetry(attempt, retryDelay, {
+                        status: response.status,
+                        statusText: response.statusText,
+                    });
+                }
+                // Wait before retrying
+                await sleep(retryDelay);
+            }
+            catch (error) {
+                // Handle unexpected errors - treat as network error (status 0)
+                const errorResponse = {
+                    data: null,
+                    status: 0,
+                    statusText: 'Network Error',
+                    headers: new Headers(),
+                    url: request.url || '',
+                    ok: false,
+                    error: {
+                        message: error instanceof Error ? error.message : 'Unknown error',
+                        body: error,
+                    },
+                };
+                // If shouldn't retry, return error immediately
+                if (!shouldRetry(errorResponse, attempt + 1)) {
+                    return errorResponse;
+                }
+                // If we've reached max retries, return the error
+                if (attempt >= maxRetries) {
+                    return errorResponse;
+                }
+                lastResponse = errorResponse;
+                attempt++;
+                // Calculate delay for next attempt
+                const retryDelay = calculateDelay(attempt, delay, backoff, maxDelay);
+                if (onRetry) {
+                    onRetry(attempt, retryDelay, {
+                        status: errorResponse.status,
+                        statusText: errorResponse.statusText,
+                    });
+                }
+                await sleep(retryDelay);
+            }
+        }
+        // Return the last response if we've exhausted all retries
+        return lastResponse;
+    };
+}
+//# sourceMappingURL=retry.js.map

package/dist/cjs/middleware/retry/retry.js.map

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

package/dist/cjs/middleware/retry/types.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @fileoverview Retry middleware types and configuration.
+ */
+/**
+ * Retry configuration options - optimized for "pit of success".
+ *
+ * Smart defaults:
+ * - 3 retries (4 total attempts)
+ * - Exponential backoff starting at 1000ms
+ * - Only retry on network errors and 5xx status codes
+ */
+export interface RetryOptions {
+    /**
+     * Maximum number of retry attempts (default: 3)
+     * Total attempts will be maxRetries + 1
+     */
+    maxRetries?: number;
+    /**
+     * Initial delay in milliseconds (default: 1000)
+     * Subsequent delays use exponential backoff
+     */
+    delay?: number;
+    /**
+     * Backoff strategy (default: 'exponential')
+     * - 'exponential': delay * (2 ^ attempt)
+     * - 'linear': delay * attempt
+     * - 'fixed': always use delay
+     */
+    backoff?: 'exponential' | 'linear' | 'fixed';
+    /**
+     * Maximum delay cap in milliseconds (default: 30000 = 30s)
+     * Prevents exponential backoff from getting too large
+     */
+    maxDelay?: number;
+    /**
+     * Custom function to determine if a response should be retried
+     * Default: retry on network errors (status 0) and server errors (5xx)
+     *
+     * @param response - The fetch response or error
+     * @param attempt - Current attempt number (1-based)
+     * @returns true if request should be retried
+     */
+    shouldRetry?: (response: {
+        status: number;
+        ok: boolean;
+    }, attempt: number) => boolean;
+    /**
+     * Optional callback called before each retry attempt
+     * Useful for logging or analytics
+     *
+     * @param attempt - Current attempt number (1-based)
+     * @param delay - Delay before this retry in ms
+     * @param lastResponse - The failed response that triggered the retry
+     */
+    onRetry?: (attempt: number, delay: number, lastResponse: {
+        status: number;
+        statusText: string;
+    }) => void;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/middleware/retry/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/middleware/retry/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;OAKG;IACH,OAAO,CAAC,EAAE,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAC;IAE7C;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,CACZ,QAAQ,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,OAAO,CAAA;KAAE,EACzC,OAAO,EAAE,MAAM,KACZ,OAAO,CAAC;IAEb;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,CACR,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,YAAY,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,KACjD,IAAI,CAAC;CACX;AAGD,OAAO,EAAE,CAAC"}

package/dist/cjs/middleware/retry/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * @fileoverview Retry middleware types and configuration.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/middleware/retry/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/middleware/retry/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}