@autonomaai/service-utils 1.0.0

package/dist/resilience/rate-limiter.js.map

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

package/dist/resilience/retry.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Retry Pattern with Exponential Backoff
+ *
+ * Automatically retries failed operations with configurable:
+ * - Max attempts
+ * - Exponential backoff
+ * - Jitter (randomization)
+ * - Retryable exceptions
+ *
+ * @example
+ * ```typescript
+ * // Using retry function
+ * const result = await retry(
+ *   () => fetchData(),
+ *   {
+ *     maxAttempts: 3,
+ *     initialDelay: 100,
+ *     backoffMultiplier: 2,
+ *     jitter: true
+ *   }
+ * );
+ *
+ * // Using decorator
+ * class ApiClient {
+ *   @withRetry({ maxAttempts: 3 })
+ *   async fetchData(): Promise<Data> {
+ *     // ...
+ *   }
+ * }
+ * ```
+ */
+import { RetryConfig } from './types.js';
+/**
+ * Execute a function with retry logic
+ *
+ * @param fn - Async function to execute
+ * @param config - Retry configuration
+ * @returns Result from the function
+ * @throws RetryExhaustedError if all retries fail
+ */
+export declare function retry<T>(fn: () => Promise<T>, config?: Partial<RetryConfig>): Promise<T>;
+/**
+ * Decorator to add retry logic to a method
+ */
+export declare function withRetry(config?: Partial<RetryConfig>): <T extends (...args: any[]) => Promise<any>>(target: any, propertyKey: string, descriptor: TypedPropertyDescriptor<T>) => TypedPropertyDescriptor<T>;
+/**
+ * Create a retry wrapper function
+ */
+export declare function createRetry(config?: Partial<RetryConfig>): <T>(fn: () => Promise<T>) => Promise<T>;
+/**
+ * Retry with specific configuration presets
+ */
+export declare const retryPresets: {
+    /** Fast retry for transient errors */
+    fast: Partial<RetryConfig>;
+    /** Standard retry for API calls */
+    standard: Partial<RetryConfig>;
+    /** Aggressive retry for critical operations */
+    aggressive: Partial<RetryConfig>;
+    /** Conservative retry for rate-limited APIs */
+    conservative: Partial<RetryConfig>;
+};
+//# sourceMappingURL=retry.d.ts.map

package/dist/resilience/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/resilience/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,WAAW,EAAuB,MAAM,YAAY,CAAC;AAwE9D;;;;;;;GAOG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAC3B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAC5B,OAAO,CAAC,CAAC,CAAC,CAsCZ;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,IACpC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,EACzD,QAAQ,GAAG,EACX,aAAa,MAAM,EACnB,YAAY,uBAAuB,CAAC,CAAC,CAAC,gCAUzC;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAC5B,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAEzC;AAED;;GAEG;AACH,eAAO,MAAM,YAAY;IACvB,sCAAsC;UAOjC,OAAO,CAAC,WAAW,CAAC;IAEzB,mCAAmC;cAO9B,OAAO,CAAC,WAAW,CAAC;IAEzB,+CAA+C;gBAO1C,OAAO,CAAC,WAAW,CAAC;IAEzB,+CAA+C;kBAO1C,OAAO,CAAC,WAAW,CAAC;CAC1B,CAAC"}

package/dist/resilience/retry.js

@@ -0,0 +1,190 @@
+/**
+ * Retry Pattern with Exponential Backoff
+ *
+ * Automatically retries failed operations with configurable:
+ * - Max attempts
+ * - Exponential backoff
+ * - Jitter (randomization)
+ * - Retryable exceptions
+ *
+ * @example
+ * ```typescript
+ * // Using retry function
+ * const result = await retry(
+ *   () => fetchData(),
+ *   {
+ *     maxAttempts: 3,
+ *     initialDelay: 100,
+ *     backoffMultiplier: 2,
+ *     jitter: true
+ *   }
+ * );
+ *
+ * // Using decorator
+ * class ApiClient {
+ *   @withRetry({ maxAttempts: 3 })
+ *   async fetchData(): Promise<Data> {
+ *     // ...
+ *   }
+ * }
+ * ```
+ */
+import { RetryExhaustedError } from './types.js';
+const DEFAULT_CONFIG = {
+    maxAttempts: 3,
+    initialDelay: 100,
+    maxDelay: 30000,
+    backoffMultiplier: 2,
+    jitter: true,
+    jitterFactor: 0.1,
+    retryableErrors: [],
+    nonRetryableErrors: []
+};
+/**
+ * Calculate delay for a given attempt
+ */
+function calculateDelay(attempt, config) {
+    let delay = config.initialDelay * Math.pow(config.backoffMultiplier, attempt - 1);
+    delay = Math.min(delay, config.maxDelay);
+    if (config.jitter) {
+        const jitterFactor = config.jitterFactor || 0.1;
+        const jitterRange = delay * jitterFactor;
+        delay += Math.random() * jitterRange * 2 - jitterRange;
+    }
+    return Math.max(0, delay);
+}
+/**
+ * Check if an error should be retried
+ */
+function shouldRetry(error, config) {
+    // Check non-retryable errors first
+    if (config.nonRetryableErrors?.length) {
+        for (const nonRetryable of config.nonRetryableErrors) {
+            if (typeof nonRetryable === 'string') {
+                if (error.message.includes(nonRetryable) || error.name === nonRetryable) {
+                    return false;
+                }
+            }
+            else if (error instanceof nonRetryable) {
+                return false;
+            }
+        }
+    }
+    // If no retryable errors specified, retry all
+    if (!config.retryableErrors?.length) {
+        return true;
+    }
+    // Check retryable errors
+    for (const retryable of config.retryableErrors) {
+        if (typeof retryable === 'string') {
+            if (error.message.includes(retryable) || error.name === retryable) {
+                return true;
+            }
+        }
+        else if (error instanceof retryable) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Sleep for a given number of milliseconds
+ */
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+/**
+ * Execute a function with retry logic
+ *
+ * @param fn - Async function to execute
+ * @param config - Retry configuration
+ * @returns Result from the function
+ * @throws RetryExhaustedError if all retries fail
+ */
+export async function retry(fn, config) {
+    const mergedConfig = { ...DEFAULT_CONFIG, ...config };
+    let lastError;
+    for (let attempt = 1; attempt <= mergedConfig.maxAttempts; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            // Check if this is the last attempt
+            if (attempt === mergedConfig.maxAttempts) {
+                console.error(`All ${mergedConfig.maxAttempts} attempts failed:`, lastError.message);
+                throw new RetryExhaustedError(mergedConfig.maxAttempts, lastError);
+            }
+            // Check if error is retryable
+            if (!shouldRetry(lastError, mergedConfig)) {
+                console.error('Non-retryable error:', lastError.message);
+                throw lastError;
+            }
+            // Calculate delay and wait
+            const delay = calculateDelay(attempt, mergedConfig);
+            console.warn(`Attempt ${attempt}/${mergedConfig.maxAttempts} failed: ${lastError.message}. ` +
+                `Retrying in ${delay.toFixed(0)}ms`);
+            // Call retry callback if provided
+            mergedConfig.onRetry?.(lastError, attempt, delay);
+            await sleep(delay);
+        }
+    }
+    // This should never be reached, but TypeScript needs it
+    throw lastError;
+}
+/**
+ * Decorator to add retry logic to a method
+ */
+export function withRetry(config) {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            return retry(() => originalMethod.apply(this, args), config);
+        };
+        return descriptor;
+    };
+}
+/**
+ * Create a retry wrapper function
+ */
+export function createRetry(config) {
+    return (fn) => retry(fn, config);
+}
+/**
+ * Retry with specific configuration presets
+ */
+export const retryPresets = {
+    /** Fast retry for transient errors */
+    fast: {
+        maxAttempts: 3,
+        initialDelay: 50,
+        maxDelay: 500,
+        backoffMultiplier: 2,
+        jitter: true
+    },
+    /** Standard retry for API calls */
+    standard: {
+        maxAttempts: 3,
+        initialDelay: 100,
+        maxDelay: 5000,
+        backoffMultiplier: 2,
+        jitter: true
+    },
+    /** Aggressive retry for critical operations */
+    aggressive: {
+        maxAttempts: 5,
+        initialDelay: 200,
+        maxDelay: 30000,
+        backoffMultiplier: 2,
+        jitter: true
+    },
+    /** Conservative retry for rate-limited APIs */
+    conservative: {
+        maxAttempts: 3,
+        initialDelay: 1000,
+        maxDelay: 60000,
+        backoffMultiplier: 3,
+        jitter: true
+    }
+};
+//# sourceMappingURL=retry.js.map

package/dist/resilience/retry.js.map

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

package/dist/resilience/timeout.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Timeout Pattern
+ *
+ * Ensures operations complete within a specified time limit.
+ * Prevents hanging operations from blocking resources.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const result = await withTimeout(
+ *     () => fetchData(),
+ *     { timeout: 5000, message: 'Fetch data timed out' }
+ *   );
+ * } catch (error) {
+ *   if (error instanceof TimeoutError) {
+ *     // Handle timeout
+ *   }
+ * }
+ * ```
+ */
+import { TimeoutConfig } from './types.js';
+/**
+ * Execute a function with a timeout
+ *
+ * @param fn - Async function to execute
+ * @param config - Timeout configuration
+ * @returns Result from the function
+ * @throws TimeoutError if operation exceeds timeout
+ */
+export declare function timeout<T>(fn: () => Promise<T>, config?: Partial<TimeoutConfig>): Promise<T>;
+/**
+ * Decorator to apply timeout to a method
+ */
+export declare function withTimeout(config?: Partial<TimeoutConfig>): <T extends (...args: any[]) => Promise<any>>(target: any, propertyKey: string, descriptor: TypedPropertyDescriptor<T>) => TypedPropertyDescriptor<T>;
+/**
+ * Create a timeout wrapper function
+ */
+export declare function createTimeout(config?: Partial<TimeoutConfig>): <T>(fn: () => Promise<T>) => Promise<T>;
+/**
+ * Timeout presets for common use cases
+ */
+export declare const timeoutPresets: {
+    /** Fast timeout for health checks */
+    healthCheck: Partial<TimeoutConfig>;
+    /** Standard timeout for API calls */
+    api: Partial<TimeoutConfig>;
+    /** Extended timeout for complex operations */
+    extended: Partial<TimeoutConfig>;
+    /** Long timeout for batch operations */
+    batch: Partial<TimeoutConfig>;
+    /** Short timeout for cache operations */
+    cache: Partial<TimeoutConfig>;
+};
+/**
+ * Create a racing timeout - returns first result or times out
+ */
+export declare function raceWithTimeout<T>(promises: Array<Promise<T>>, config?: Partial<TimeoutConfig>): Promise<T>;
+/**
+ * Execute with deadline (absolute time)
+ */
+export declare function withDeadline<T>(fn: () => Promise<T>, deadline: Date, message?: string): Promise<T>;
+//# sourceMappingURL=timeout.d.ts.map

package/dist/resilience/timeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.d.ts","sourceRoot":"","sources":["../../src/resilience/timeout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,aAAa,EAAgB,MAAM,YAAY,CAAC;AAOzD;;;;;;;GAOG;AACH,wBAAsB,OAAO,CAAC,CAAC,EAC7B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAC9B,OAAO,CAAC,CAAC,CAAC,CA8BZ;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,IACxC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,EACzD,QAAQ,GAAG,EACX,aAAa,MAAM,EACnB,YAAY,uBAAuB,CAAC,CAAC,CAAC,gCAUzC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAC9B,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAEzC;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;IACzB,qCAAqC;iBAIhC,OAAO,CAAC,aAAa,CAAC;IAE3B,qCAAqC;SAIhC,OAAO,CAAC,aAAa,CAAC;IAE3B,8CAA8C;cAIzC,OAAO,CAAC,aAAa,CAAC;IAE3B,wCAAwC;WAInC,OAAO,CAAC,aAAa,CAAC;IAE3B,yCAAyC;WAIpC,OAAO,CAAC,aAAa,CAAC;CAC5B,CAAC;AAEF;;GAEG;AACH,wBAAsB,eAAe,CAAC,CAAC,EACrC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAC3B,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAC9B,OAAO,CAAC,CAAC,CAAC,CAWZ;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,QAAQ,EAAE,IAAI,EACd,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,CAAC,CAAC,CAUZ"}

package/dist/resilience/timeout.js

@@ -0,0 +1,135 @@
+/**
+ * Timeout Pattern
+ *
+ * Ensures operations complete within a specified time limit.
+ * Prevents hanging operations from blocking resources.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const result = await withTimeout(
+ *     () => fetchData(),
+ *     { timeout: 5000, message: 'Fetch data timed out' }
+ *   );
+ * } catch (error) {
+ *   if (error instanceof TimeoutError) {
+ *     // Handle timeout
+ *   }
+ * }
+ * ```
+ */
+import { TimeoutError } from './types.js';
+const DEFAULT_CONFIG = {
+    timeout: 30000,
+    message: undefined
+};
+/**
+ * Execute a function with a timeout
+ *
+ * @param fn - Async function to execute
+ * @param config - Timeout configuration
+ * @returns Result from the function
+ * @throws TimeoutError if operation exceeds timeout
+ */
+export async function timeout(fn, config) {
+    const mergedConfig = { ...DEFAULT_CONFIG, ...config };
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const timer = setTimeout(() => {
+            if (!settled) {
+                settled = true;
+                mergedConfig.onTimeout?.();
+                reject(new TimeoutError(mergedConfig.timeout, mergedConfig.message));
+            }
+        }, mergedConfig.timeout);
+        fn()
+            .then(result => {
+            if (!settled) {
+                settled = true;
+                clearTimeout(timer);
+                resolve(result);
+            }
+        })
+            .catch(error => {
+            if (!settled) {
+                settled = true;
+                clearTimeout(timer);
+                reject(error);
+            }
+        });
+    });
+}
+/**
+ * Decorator to apply timeout to a method
+ */
+export function withTimeout(config) {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            return timeout(() => originalMethod.apply(this, args), config);
+        };
+        return descriptor;
+    };
+}
+/**
+ * Create a timeout wrapper function
+ */
+export function createTimeout(config) {
+    return (fn) => timeout(fn, config);
+}
+/**
+ * Timeout presets for common use cases
+ */
+export const timeoutPresets = {
+    /** Fast timeout for health checks */
+    healthCheck: {
+        timeout: 1000,
+        message: 'Health check timed out'
+    },
+    /** Standard timeout for API calls */
+    api: {
+        timeout: 10000,
+        message: 'API call timed out'
+    },
+    /** Extended timeout for complex operations */
+    extended: {
+        timeout: 30000,
+        message: 'Operation timed out'
+    },
+    /** Long timeout for batch operations */
+    batch: {
+        timeout: 120000,
+        message: 'Batch operation timed out'
+    },
+    /** Short timeout for cache operations */
+    cache: {
+        timeout: 100,
+        message: 'Cache operation timed out'
+    }
+};
+/**
+ * Create a racing timeout - returns first result or times out
+ */
+export async function raceWithTimeout(promises, config) {
+    const mergedConfig = { ...DEFAULT_CONFIG, ...config };
+    const timeoutPromise = new Promise((_, reject) => {
+        setTimeout(() => {
+            mergedConfig.onTimeout?.();
+            reject(new TimeoutError(mergedConfig.timeout, mergedConfig.message));
+        }, mergedConfig.timeout);
+    });
+    return Promise.race([...promises, timeoutPromise]);
+}
+/**
+ * Execute with deadline (absolute time)
+ */
+export async function withDeadline(fn, deadline, message) {
+    const now = Date.now();
+    const deadlineMs = deadline.getTime();
+    const remainingMs = deadlineMs - now;
+    if (remainingMs <= 0) {
+        throw new TimeoutError(0, message || 'Deadline already passed');
+    }
+    return timeout(fn, { timeout: remainingMs, message });
+}
+//# sourceMappingURL=timeout.js.map

package/dist/resilience/timeout.js.map

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

package/dist/resilience/types.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Resilience Pattern Types
+ *
+ * Type definitions for all resilience patterns.
+ */
+/**
+ * Circuit breaker states
+ */
+export declare enum CircuitState {
+    CLOSED = "closed",
+    OPEN = "open",
+    HALF_OPEN = "half_open"
+}
+/**
+ * Circuit breaker configuration
+ */
+export interface CircuitBreakerConfig {
+    /** Unique name for this circuit breaker */
+    name: string;
+    /** Number of failures before opening circuit */
+    failureThreshold: number;
+    /** Time in ms before attempting recovery */
+    recoveryTimeout: number;
+    /** Max calls allowed in half-open state */
+    halfOpenMaxCalls: number;
+    /** Failure rate threshold (0-1) to trip breaker */
+    failureRateThreshold?: number;
+    /** Exceptions that don't count as failures */
+    excludedErrors?: Array<new (...args: any[]) => Error>;
+    /** Callback when circuit opens */
+    onOpen?: () => void;
+    /** Callback when circuit closes */
+    onClose?: () => void;
+    /** Callback when circuit enters half-open */
+    onHalfOpen?: () => void;
+}
+/**
+ * Circuit breaker statistics
+ */
+export interface CircuitBreakerStats {
+    totalCalls: number;
+    successfulCalls: number;
+    failedCalls: number;
+    rejectedCalls: number;
+    lastFailureTime?: number;
+    lastSuccessTime?: number;
+    state: CircuitState;
+}
+/**
+ * Retry policy configuration
+ */
+export interface RetryConfig {
+    /** Maximum number of attempts */
+    maxAttempts: number;
+    /** Initial delay in ms */
+    initialDelay: number;
+    /** Maximum delay in ms */
+    maxDelay: number;
+    /** Backoff multiplier */
+    backoffMultiplier: number;
+    /** Add jitter to delays */
+    jitter: boolean;
+    /** Jitter factor (0-1) */
+    jitterFactor?: number;
+    /** Error codes/types that are retryable */
+    retryableErrors?: Array<string | (new (...args: any[]) => Error)>;
+    /** Error codes/types that should NOT be retried */
+    nonRetryableErrors?: Array<string | (new (...args: any[]) => Error)>;
+    /** Callback on each retry */
+    onRetry?: (error: Error, attempt: number, delay: number) => void;
+}
+/**
+ * Bulkhead configuration
+ */
+export interface BulkheadConfig {
+    /** Maximum concurrent executions */
+    maxConcurrent: number;
+    /** Maximum queued requests */
+    maxQueued: number;
+    /** Queue timeout in ms */
+    queueTimeout: number;
+    /** Callback when bulkhead is full */
+    onReject?: () => void;
+}
+/**
+ * Rate limiter configuration
+ */
+export interface RateLimiterConfig {
+    /** Time window in ms */
+    windowMs: number;
+    /** Maximum requests per window */
+    maxRequests: number;
+    /** Key generator function */
+    keyGenerator?: (context: any) => string;
+    /** Skip successful requests */
+    skipSuccessfulRequests?: boolean;
+    /** Skip failed requests */
+    skipFailedRequests?: boolean;
+    /** Callback when rate limit exceeded */
+    onLimitReached?: (key: string) => void;
+}
+/**
+ * Timeout configuration
+ */
+export interface TimeoutConfig {
+    /** Timeout in ms */
+    timeout: number;
+    /** Custom timeout error message */
+    message?: string;
+    /** Callback on timeout */
+    onTimeout?: () => void;
+}
+/**
+ * Fallback configuration
+ */
+export interface FallbackConfig<T> {
+    /** Fallback strategy */
+    strategy: 'cache' | 'default' | 'function' | 'error';
+    /** Default value for 'default' strategy */
+    defaultValue?: T;
+    /** Fallback function for 'function' strategy */
+    fallbackFn?: () => T | Promise<T>;
+    /** Cache TTL in ms for 'cache' strategy */
+    cacheTTL?: number;
+}
+/**
+ * Combined resilience options
+ */
+export interface ResilienceOptions<T = any> {
+    circuitBreaker?: Partial<CircuitBreakerConfig>;
+    retry?: Partial<RetryConfig>;
+    bulkhead?: Partial<BulkheadConfig>;
+    rateLimiter?: Partial<RateLimiterConfig>;
+    timeout?: Partial<TimeoutConfig>;
+    fallback?: FallbackConfig<T>;
+}
+/**
+ * Error types
+ */
+export declare class CircuitBreakerOpenError extends Error {
+    readonly name: string;
+    readonly retryAfter: number;
+    constructor(name: string, retryAfter: number);
+}
+export declare class BulkheadFullError extends Error {
+    readonly name: string;
+    constructor(name: string);
+}
+export declare class RateLimitExceededError extends Error {
+    readonly key: string;
+    readonly retryAfter: number;
+    constructor(key: string, retryAfter: number);
+}
+export declare class TimeoutError extends Error {
+    readonly timeout: number;
+    constructor(timeout: number, message?: string);
+}
+export declare class RetryExhaustedError extends Error {
+    readonly attempts: number;
+    readonly lastError: Error;
+    constructor(attempts: number, lastError: Error);
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/resilience/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,oBAAY,YAAY;IACtB,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,SAAS,cAAc;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,gBAAgB,EAAE,MAAM,CAAC;IACzB,4CAA4C;IAC5C,eAAe,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,gBAAgB,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,8CAA8C;IAC9C,cAAc,CAAC,EAAE,KAAK,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,KAAK,CAAC,CAAC;IACtD,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,YAAY,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2BAA2B;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,0BAA0B;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,eAAe,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC;IAClE,mDAAmD;IACnD,kBAAkB,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC;IACrE,6BAA6B;IAC7B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAClE;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,MAAM,CAAC;IACxC,+BAA+B;IAC/B,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,2BAA2B;IAC3B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,wCAAwC;IACxC,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,wBAAwB;IACxB,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC;IACrD,2CAA2C;IAC3C,YAAY,CAAC,EAAE,CAAC,CAAC;IACjB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAClC,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,GAAG;IACxC,cAAc,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC/C,KAAK,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACnC,WAAW,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACzC,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;CAC9B;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;aAE9B,IAAI,EAAE,MAAM;aACZ,UAAU,EAAE,MAAM;gBADlB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM;CAKrC;AAED,qBAAa,iBAAkB,SAAQ,KAAK;aACd,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;CAIzC;AAED,qBAAa,sBAAuB,SAAQ,KAAK;aAE7B,GAAG,EAAE,MAAM;aACX,UAAU,EAAE,MAAM;gBADlB,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM;CAKrC;AAED,qBAAa,YAAa,SAAQ,KAAK;aACT,OAAO,EAAE,MAAM;gBAAf,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAI9D;AAED,qBAAa,mBAAoB,SAAQ,KAAK;aAE1B,QAAQ,EAAE,MAAM;aAChB,SAAS,EAAE,KAAK;gBADhB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,KAAK;CAKnC"}