@tachui/core 0.7.0-alpha1

package/dist/runtime/error-recovery.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-recovery.cjs","sources":["../../src/runtime/error-recovery.ts"],"sourcesContent":["/**\n * Error Recovery Mechanisms (Phase 3.2.3)\n *\n * Advanced error recovery strategies and retry logic for TachUI.\n * Provides intelligent error handling, circuit breakers, and recovery patterns.\n */\n\nimport { createSignal } from '../reactive'\nimport { globalErrorManager, type TachUIError } from './error-boundary'\n\n/**\n * Circuit breaker states\n */\nexport type CircuitBreakerState = 'closed' | 'open' | 'half-open'\n\n/**\n * Circuit breaker configuration\n */\nexport interface CircuitBreakerConfig {\n  failureThreshold: number\n  resetTimeout: number\n  monitoringPeriod: number\n  minimumThroughput: number\n}\n\n/**\n * Retry policy configuration\n */\nexport interface RetryPolicyConfig {\n  maxAttempts: number\n  baseDelay: number\n  maxDelay: number\n  backoffMultiplier: number\n  jitter: boolean\n  retryableErrors: string[]\n  nonRetryableErrors: string[]\n}\n\n/**\n * Fallback configuration\n */\nexport interface FallbackConfig<T> {\n  value?: T\n  factory?: () => T | Promise<T>\n  timeout?: number\n  cache?: boolean\n  cacheKey?: string\n  cacheTimeout?: number\n}\n\n/**\n * Circuit breaker implementation\n */\nexport class CircuitBreaker {\n  private state: CircuitBreakerState = 'closed'\n  private failureCount = 0\n  private lastFailureTime = 0\n  private successCount = 0\n  private requestCount = 0\n  private lastRequestTime = 0\n\n  private config: CircuitBreakerConfig\n  private stateSignal: () => CircuitBreakerState\n  private setState: (value: CircuitBreakerState) => void\n\n  constructor(config: Partial<CircuitBreakerConfig> = {}) {\n    this.config = {\n      failureThreshold: 5,\n      resetTimeout: 60000, // 1 minute\n      monitoringPeriod: 300000, // 5 minutes\n      minimumThroughput: 10,\n      ...config,\n    }\n\n    // Initialize reactive state\n    const [stateSignal, setState] = createSignal<CircuitBreakerState>('closed')\n    this.stateSignal = stateSignal\n    this.setState = setState\n  }\n\n  /**\n   * Execute function with circuit breaker protection\n   */\n  async execute<R>(fn: () => Promise<R>): Promise<R> {\n    this.updateRequestCount()\n\n    if (this.state === 'open') {\n      if (this.shouldAttemptReset()) {\n        this.state = 'half-open'\n        this.setState('half-open')\n      } else {\n        throw new Error('Circuit breaker is open')\n      }\n    }\n\n    try {\n      const result = await fn()\n      this.onSuccess()\n      return result\n    } catch (error) {\n      this.onFailure()\n      throw error\n    }\n  }\n\n  /**\n   * Handle successful execution\n   */\n  private onSuccess(): void {\n    this.successCount++\n\n    if (this.state === 'half-open') {\n      this.reset()\n    }\n  }\n\n  /**\n   * Handle failed execution\n   */\n  private onFailure(): void {\n    this.failureCount++\n    this.lastFailureTime = Date.now()\n\n    if (this.shouldTrip()) {\n      this.trip()\n    }\n  }\n\n  /**\n   * Check if circuit breaker should trip to open state\n   */\n  private shouldTrip(): boolean {\n    return (\n      this.failureCount >= this.config.failureThreshold &&\n      this.requestCount >= this.config.minimumThroughput\n    )\n  }\n\n  /**\n   * Trip circuit breaker to open state\n   */\n  private trip(): void {\n    this.state = 'open'\n    this.setState('open')\n\n    globalErrorManager.reportError(\n      globalErrorManager.createTachUIError(new Error('Circuit breaker tripped'), {\n        category: 'component_error',\n        severity: 'medium',\n        context: {\n          failureCount: this.failureCount,\n          requestCount: this.requestCount,\n        },\n      })\n    )\n  }\n\n  /**\n   * Check if should attempt reset from open state\n   */\n  private shouldAttemptReset(): boolean {\n    return Date.now() - this.lastFailureTime >= this.config.resetTimeout\n  }\n\n  /**\n   * Reset circuit breaker to closed state\n   */\n  private reset(): void {\n    this.state = 'closed'\n    this.failureCount = 0\n    this.successCount = 0\n    this.setState('closed')\n  }\n\n  /**\n   * Update request count for monitoring period\n   */\n  private updateRequestCount(): void {\n    const now = Date.now()\n\n    if (now - this.lastRequestTime > this.config.monitoringPeriod) {\n      this.requestCount = 0\n    }\n\n    this.requestCount++\n    this.lastRequestTime = now\n  }\n\n  /**\n   * Get current state\n   */\n  getState(): CircuitBreakerState {\n    return this.state\n  }\n\n  /**\n   * Get state signal\n   */\n  getStateSignal(): () => CircuitBreakerState {\n    return this.stateSignal\n  }\n\n  /**\n   * Get metrics\n   */\n  getMetrics(): {\n    state: CircuitBreakerState\n    failureCount: number\n    successCount: number\n    requestCount: number\n    failureRate: number\n  } {\n    return {\n      state: this.state,\n      failureCount: this.failureCount,\n      successCount: this.successCount,\n      requestCount: this.requestCount,\n      failureRate: this.requestCount > 0 ? this.failureCount / this.requestCount : 0,\n    }\n  }\n}\n\n/**\n * Retry policy implementation\n */\nexport class RetryPolicy {\n  private config: RetryPolicyConfig\n\n  constructor(config: Partial<RetryPolicyConfig> = {}) {\n    this.config = {\n      maxAttempts: 3,\n      baseDelay: 1000,\n      maxDelay: 30000,\n      backoffMultiplier: 2,\n      jitter: true,\n      retryableErrors: [], // Empty means retry all errors by default (except non-retryable)\n      nonRetryableErrors: ['ValidationError', 'AuthenticationError'],\n      ...config,\n    }\n  }\n\n  /**\n   * Execute function with retry policy\n   */\n  async execute<T>(fn: () => Promise<T>): Promise<T> {\n    let lastError: Error\n\n    for (let attempt = 1; attempt <= this.config.maxAttempts; attempt++) {\n      try {\n        return await fn()\n      } catch (error) {\n        lastError = error as Error\n\n        if (!this.shouldRetry(error as Error, attempt)) {\n          throw error\n        }\n\n        if (attempt < this.config.maxAttempts) {\n          const delay = this.calculateDelay(attempt)\n          await this.sleep(delay)\n\n          // Report retry attempt\n          globalErrorManager.reportError(\n            globalErrorManager.createTachUIError(error as Error, {\n              category: 'network_error',\n              severity: 'low',\n              context: {\n                attempt,\n                nextDelay: delay,\n                retryPolicy: true,\n              },\n            })\n          )\n        }\n      }\n    }\n\n    throw lastError!\n  }\n\n  /**\n   * Check if error should be retried\n   */\n  private shouldRetry(error: Error, attempt: number): boolean {\n    if (attempt >= this.config.maxAttempts) {\n      return false\n    }\n\n    const errorName = error.constructor.name\n\n    // Check non-retryable errors first\n    if (this.config.nonRetryableErrors.includes(errorName)) {\n      return false\n    }\n\n    // Check retryable errors - if empty, allow retries by default\n    if (this.config.retryableErrors.length > 0) {\n      return this.config.retryableErrors.includes(errorName)\n    }\n\n    // Default: retry most errors except validation/auth\n    return !['ValidationError', 'AuthenticationError', 'AuthorizationError'].includes(errorName)\n  }\n\n  /**\n   * Calculate delay for next retry\n   */\n  private calculateDelay(attempt: number): number {\n    const exponentialDelay = this.config.baseDelay * this.config.backoffMultiplier ** (attempt - 1)\n    let delay = Math.min(exponentialDelay, this.config.maxDelay)\n\n    // Add jitter to prevent thundering herd\n    if (this.config.jitter) {\n      delay = delay * (0.5 + Math.random() * 0.5)\n    }\n\n    return Math.floor(delay)\n  }\n\n  /**\n   * Sleep for specified duration\n   */\n  private sleep(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms))\n  }\n\n  /**\n   * Get configuration\n   */\n  getConfig(): RetryPolicyConfig {\n    return { ...this.config }\n  }\n}\n\n/**\n * Fallback manager\n */\nexport class FallbackManager<T> {\n  private cache = new Map<string, { value: T; timestamp: number }>()\n\n  /**\n   * Execute with fallback\n   */\n  async executeWithFallback<R>(\n    fn: () => Promise<R>,\n    fallbackConfig: FallbackConfig<R>\n  ): Promise<R> {\n    try {\n      // Try with timeout if specified\n      if (fallbackConfig.timeout) {\n        return await this.withTimeout(fn(), fallbackConfig.timeout)\n      } else {\n        return await fn()\n      }\n    } catch (error) {\n      return this.getFallbackValue(fallbackConfig, error as Error)\n    }\n  }\n\n  /**\n   * Get fallback value\n   */\n  private async getFallbackValue<R>(config: FallbackConfig<R>, error: Error): Promise<R> {\n    // Check cache first\n    if (config.cache && config.cacheKey) {\n      const cached = this.getCachedValue<R>(config.cacheKey, config.cacheTimeout || 300000)\n      if (cached !== null) {\n        return cached\n      }\n    }\n\n    let fallbackValue: R\n\n    // Get fallback value\n    if (config.factory) {\n      fallbackValue = await config.factory()\n    } else if (config.value !== undefined) {\n      fallbackValue = config.value\n    } else {\n      throw error // No fallback available\n    }\n\n    // Cache the fallback value\n    if (config.cache && config.cacheKey) {\n      this.setCachedValue(config.cacheKey, fallbackValue)\n    }\n\n    return fallbackValue\n  }\n\n  /**\n   * Execute with timeout\n   */\n  private withTimeout<R>(promise: Promise<R>, timeout: number): Promise<R> {\n    return new Promise((resolve, reject) => {\n      const timer = setTimeout(() => {\n        reject(new Error(`Operation timed out after ${timeout}ms`))\n      }, timeout)\n\n      promise\n        .then(resolve)\n        .catch(reject)\n        .finally(() => clearTimeout(timer))\n    })\n  }\n\n  /**\n   * Get cached value\n   */\n  private getCachedValue<R>(key: string, maxAge: number): R | null {\n    const cached = this.cache.get(key)\n    if (!cached) return null\n\n    if (Date.now() - cached.timestamp > maxAge) {\n      this.cache.delete(key)\n      return null\n    }\n\n    return cached.value as unknown as R\n  }\n\n  /**\n   * Set cached value\n   */\n  private setCachedValue<R>(key: string, value: R): void {\n    this.cache.set(key, { value: value as any, timestamp: Date.now() })\n  }\n\n  /**\n   * Clear cache\n   */\n  clearCache(): void {\n    this.cache.clear()\n  }\n}\n\n/**\n * Composite recovery strategy\n */\nexport class RecoveryOrchestrator {\n  private circuitBreaker?: CircuitBreaker\n  private retryPolicy?: RetryPolicy\n  private fallbackManager = new FallbackManager()\n\n  constructor(\n    circuitBreakerConfig?: Partial<CircuitBreakerConfig>,\n    retryPolicyConfig?: Partial<RetryPolicyConfig>\n  ) {\n    if (circuitBreakerConfig) {\n      this.circuitBreaker = new CircuitBreaker(circuitBreakerConfig)\n    }\n\n    if (retryPolicyConfig) {\n      this.retryPolicy = new RetryPolicy(retryPolicyConfig)\n    }\n  }\n\n  /**\n   * Execute with all recovery mechanisms\n   */\n  async execute<T>(fn: () => Promise<T>, fallbackConfig?: FallbackConfig<T>): Promise<T> {\n    const wrappedFn = this.wrapWithRecovery(fn)\n\n    if (fallbackConfig) {\n      return this.fallbackManager.executeWithFallback(wrappedFn, fallbackConfig)\n    } else {\n      return wrappedFn()\n    }\n  }\n\n  /**\n   * Wrap function with recovery mechanisms\n   */\n  private wrapWithRecovery<T>(fn: () => Promise<T>): () => Promise<T> {\n    let wrappedFn = fn\n\n    // Apply retry policy\n    if (this.retryPolicy) {\n      const retryFn = wrappedFn\n      wrappedFn = () => this.retryPolicy!.execute(retryFn)\n    }\n\n    // Apply circuit breaker\n    if (this.circuitBreaker) {\n      const circuitFn = wrappedFn\n      wrappedFn = () => this.circuitBreaker!.execute(circuitFn)\n    }\n\n    return wrappedFn\n  }\n\n  /**\n   * Get circuit breaker metrics\n   */\n  getCircuitBreakerMetrics() {\n    return this.circuitBreaker?.getMetrics()\n  }\n\n  /**\n   * Get retry policy configuration\n   */\n  getRetryPolicyConfig() {\n    return this.retryPolicy?.getConfig()\n  }\n}\n\n/**\n * Error recovery utilities\n */\nexport const recoveryUtils = {\n  /**\n   * Create a robust function wrapper with all recovery mechanisms\n   */\n  createRobustFunction<T extends (...args: any[]) => Promise<any>>(\n    fn: T,\n    options: {\n      circuitBreaker?: Partial<CircuitBreakerConfig>\n      retryPolicy?: Partial<RetryPolicyConfig>\n      fallback?: FallbackConfig<Awaited<ReturnType<T>>>\n      onError?: (error: TachUIError) => void\n    } = {}\n  ): T {\n    const orchestrator = new RecoveryOrchestrator(options.circuitBreaker, options.retryPolicy)\n\n    return (async (...args: Parameters<T>): Promise<Awaited<ReturnType<T>>> => {\n      try {\n        return await orchestrator.execute(() => fn(...args), options.fallback)\n      } catch (error) {\n        if (options.onError) {\n          const tachUIError = globalErrorManager.createTachUIError(error as Error, {\n            category: 'network_error',\n          })\n          options.onError(tachUIError)\n        }\n        throw error\n      }\n    }) as T\n  },\n\n  /**\n   * Create simple retry wrapper\n   */\n  withRetry<T extends (...args: any[]) => Promise<any>>(\n    fn: T,\n    maxAttempts: number = 3,\n    baseDelay: number = 1000\n  ): T {\n    const retryPolicy = new RetryPolicy({\n      maxAttempts,\n      baseDelay,\n    })\n\n    return ((...args: Parameters<T>): Promise<Awaited<ReturnType<T>>> => {\n      return retryPolicy.execute(() => fn(...args))\n    }) as T\n  },\n\n  /**\n   * Create circuit breaker wrapper\n   */\n  withCircuitBreaker<T extends (...args: any[]) => Promise<any>>(\n    fn: T,\n    config?: Partial<CircuitBreakerConfig>\n  ): T {\n    const circuitBreaker = new CircuitBreaker(config)\n\n    return ((...args: Parameters<T>): Promise<Awaited<ReturnType<T>>> => {\n      return circuitBreaker.execute(() => fn(...args))\n    }) as T\n  },\n\n  /**\n   * Create fallback wrapper\n   */\n  withFallback<T extends (...args: any[]) => Promise<any>>(\n    fn: T,\n    fallbackValue: Awaited<ReturnType<T>> | (() => Awaited<ReturnType<T>>)\n  ): T {\n    const fallbackManager = new FallbackManager()\n\n    return ((...args: Parameters<T>): Promise<Awaited<ReturnType<T>>> => {\n      return fallbackManager.executeWithFallback(() => fn(...args), {\n        factory:\n          typeof fallbackValue === 'function'\n            ? (fallbackValue as () => Awaited<ReturnType<T>>)\n            : undefined,\n        value: typeof fallbackValue !== 'function' ? fallbackValue : undefined,\n      })\n    }) as T\n  },\n}\n\n/**\n * Global recovery configurations\n */\nexport const recoveryPresets = {\n  /**\n   * Configuration for network requests\n   */\n  network: {\n    circuitBreaker: {\n      failureThreshold: 5,\n      resetTimeout: 60000,\n      monitoringPeriod: 300000,\n    },\n    retryPolicy: {\n      maxAttempts: 3,\n      baseDelay: 1000,\n      backoffMultiplier: 2,\n      jitter: true,\n      retryableErrors: ['NetworkError', 'TimeoutError', 'ServiceUnavailable'],\n    },\n  },\n\n  /**\n   * Configuration for component rendering\n   */\n  component: {\n    retryPolicy: {\n      maxAttempts: 2,\n      baseDelay: 100,\n      backoffMultiplier: 1.5,\n      jitter: false,\n      retryableErrors: ['RenderError', 'ComponentError'],\n    },\n  },\n\n  /**\n   * Configuration for reactive operations\n   */\n  reactive: {\n    retryPolicy: {\n      maxAttempts: 1,\n      baseDelay: 0,\n      retryableErrors: [],\n    },\n  },\n}\n"],"names":["CircuitBreaker","config","__publicField","stateSignal","setState","createSignal","fn","result","error","globalErrorManager","now","RetryPolicy","lastError","attempt","delay","errorName","exponentialDelay","ms","resolve","FallbackManager","fallbackConfig","cached","fallbackValue","promise","timeout","reject","timer","key","maxAge","value","RecoveryOrchestrator","circuitBreakerConfig","retryPolicyConfig","wrappedFn","retryFn","circuitFn","recoveryUtils","options","orchestrator","args","tachUIError","maxAttempts","baseDelay","retryPolicy","circuitBreaker","fallbackManager","recoveryPresets"],"mappings":"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"}

package/dist/runtime/error-recovery.d.ts

@@ -0,0 +1,267 @@
+/**
+ * Error Recovery Mechanisms (Phase 3.2.3)
+ *
+ * Advanced error recovery strategies and retry logic for TachUI.
+ * Provides intelligent error handling, circuit breakers, and recovery patterns.
+ */
+import { type TachUIError } from './error-boundary';
+/**
+ * Circuit breaker states
+ */
+export type CircuitBreakerState = 'closed' | 'open' | 'half-open';
+/**
+ * Circuit breaker configuration
+ */
+export interface CircuitBreakerConfig {
+    failureThreshold: number;
+    resetTimeout: number;
+    monitoringPeriod: number;
+    minimumThroughput: number;
+}
+/**
+ * Retry policy configuration
+ */
+export interface RetryPolicyConfig {
+    maxAttempts: number;
+    baseDelay: number;
+    maxDelay: number;
+    backoffMultiplier: number;
+    jitter: boolean;
+    retryableErrors: string[];
+    nonRetryableErrors: string[];
+}
+/**
+ * Fallback configuration
+ */
+export interface FallbackConfig<T> {
+    value?: T;
+    factory?: () => T | Promise<T>;
+    timeout?: number;
+    cache?: boolean;
+    cacheKey?: string;
+    cacheTimeout?: number;
+}
+/**
+ * Circuit breaker implementation
+ */
+export declare class CircuitBreaker {
+    private state;
+    private failureCount;
+    private lastFailureTime;
+    private successCount;
+    private requestCount;
+    private lastRequestTime;
+    private config;
+    private stateSignal;
+    private setState;
+    constructor(config?: Partial<CircuitBreakerConfig>);
+    /**
+     * Execute function with circuit breaker protection
+     */
+    execute<R>(fn: () => Promise<R>): Promise<R>;
+    /**
+     * Handle successful execution
+     */
+    private onSuccess;
+    /**
+     * Handle failed execution
+     */
+    private onFailure;
+    /**
+     * Check if circuit breaker should trip to open state
+     */
+    private shouldTrip;
+    /**
+     * Trip circuit breaker to open state
+     */
+    private trip;
+    /**
+     * Check if should attempt reset from open state
+     */
+    private shouldAttemptReset;
+    /**
+     * Reset circuit breaker to closed state
+     */
+    private reset;
+    /**
+     * Update request count for monitoring period
+     */
+    private updateRequestCount;
+    /**
+     * Get current state
+     */
+    getState(): CircuitBreakerState;
+    /**
+     * Get state signal
+     */
+    getStateSignal(): () => CircuitBreakerState;
+    /**
+     * Get metrics
+     */
+    getMetrics(): {
+        state: CircuitBreakerState;
+        failureCount: number;
+        successCount: number;
+        requestCount: number;
+        failureRate: number;
+    };
+}
+/**
+ * Retry policy implementation
+ */
+export declare class RetryPolicy {
+    private config;
+    constructor(config?: Partial<RetryPolicyConfig>);
+    /**
+     * Execute function with retry policy
+     */
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Check if error should be retried
+     */
+    private shouldRetry;
+    /**
+     * Calculate delay for next retry
+     */
+    private calculateDelay;
+    /**
+     * Sleep for specified duration
+     */
+    private sleep;
+    /**
+     * Get configuration
+     */
+    getConfig(): RetryPolicyConfig;
+}
+/**
+ * Fallback manager
+ */
+export declare class FallbackManager<T> {
+    private cache;
+    /**
+     * Execute with fallback
+     */
+    executeWithFallback<R>(fn: () => Promise<R>, fallbackConfig: FallbackConfig<R>): Promise<R>;
+    /**
+     * Get fallback value
+     */
+    private getFallbackValue;
+    /**
+     * Execute with timeout
+     */
+    private withTimeout;
+    /**
+     * Get cached value
+     */
+    private getCachedValue;
+    /**
+     * Set cached value
+     */
+    private setCachedValue;
+    /**
+     * Clear cache
+     */
+    clearCache(): void;
+}
+/**
+ * Composite recovery strategy
+ */
+export declare class RecoveryOrchestrator {
+    private circuitBreaker?;
+    private retryPolicy?;
+    private fallbackManager;
+    constructor(circuitBreakerConfig?: Partial<CircuitBreakerConfig>, retryPolicyConfig?: Partial<RetryPolicyConfig>);
+    /**
+     * Execute with all recovery mechanisms
+     */
+    execute<T>(fn: () => Promise<T>, fallbackConfig?: FallbackConfig<T>): Promise<T>;
+    /**
+     * Wrap function with recovery mechanisms
+     */
+    private wrapWithRecovery;
+    /**
+     * Get circuit breaker metrics
+     */
+    getCircuitBreakerMetrics(): {
+        state: CircuitBreakerState;
+        failureCount: number;
+        successCount: number;
+        requestCount: number;
+        failureRate: number;
+    } | undefined;
+    /**
+     * Get retry policy configuration
+     */
+    getRetryPolicyConfig(): RetryPolicyConfig | undefined;
+}
+/**
+ * Error recovery utilities
+ */
+export declare const recoveryUtils: {
+    /**
+     * Create a robust function wrapper with all recovery mechanisms
+     */
+    createRobustFunction<T extends (...args: any[]) => Promise<any>>(fn: T, options?: {
+        circuitBreaker?: Partial<CircuitBreakerConfig>;
+        retryPolicy?: Partial<RetryPolicyConfig>;
+        fallback?: FallbackConfig<Awaited<ReturnType<T>>>;
+        onError?: (error: TachUIError) => void;
+    }): T;
+    /**
+     * Create simple retry wrapper
+     */
+    withRetry<T extends (...args: any[]) => Promise<any>>(fn: T, maxAttempts?: number, baseDelay?: number): T;
+    /**
+     * Create circuit breaker wrapper
+     */
+    withCircuitBreaker<T extends (...args: any[]) => Promise<any>>(fn: T, config?: Partial<CircuitBreakerConfig>): T;
+    /**
+     * Create fallback wrapper
+     */
+    withFallback<T extends (...args: any[]) => Promise<any>>(fn: T, fallbackValue: Awaited<ReturnType<T>> | (() => Awaited<ReturnType<T>>)): T;
+};
+/**
+ * Global recovery configurations
+ */
+export declare const recoveryPresets: {
+    /**
+     * Configuration for network requests
+     */
+    network: {
+        circuitBreaker: {
+            failureThreshold: number;
+            resetTimeout: number;
+            monitoringPeriod: number;
+        };
+        retryPolicy: {
+            maxAttempts: number;
+            baseDelay: number;
+            backoffMultiplier: number;
+            jitter: boolean;
+            retryableErrors: string[];
+        };
+    };
+    /**
+     * Configuration for component rendering
+     */
+    component: {
+        retryPolicy: {
+            maxAttempts: number;
+            baseDelay: number;
+            backoffMultiplier: number;
+            jitter: boolean;
+            retryableErrors: string[];
+        };
+    };
+    /**
+     * Configuration for reactive operations
+     */
+    reactive: {
+        retryPolicy: {
+            maxAttempts: number;
+            baseDelay: number;
+            retryableErrors: never[];
+        };
+    };
+};
+//# sourceMappingURL=error-recovery.d.ts.map

package/dist/runtime/error-recovery.d.ts.map

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