dartmind 17.0.0

package/dist/v10/recovery/RetryEngine.js

@@ -0,0 +1,473 @@
+/**
+ * FlutterAI v10 - Retry Engine
+ *
+ * Configurable retry logic with multiple backoff strategies.
+ *
+ * Features:
+ * - Multiple backoff strategies (constant, linear, exponential, decorrelated jitter)
+ * - Retry budgets
+ * - Condition-based retries
+ * - Abort signals
+ * - Retry hooks
+ * - Circuit breaker integration
+ *
+ * @module v10/recovery/RetryEngine
+ */
+import { EventEmitter } from 'events';
+// ============================================================================
+// Constants
+// ============================================================================
+const DEFAULT_CONFIG = {
+    maxAttempts: 3,
+    backoff: 'exponential_jitter',
+    initialDelay: 100,
+    maxDelay: 30000,
+    multiplier: 2,
+    jitter: 0.1,
+    delayFn: () => 0,
+    retryCondition: () => true,
+    attemptTimeout: 30000,
+    totalTimeout: 120000,
+    abortSignal: undefined
+};
+const DEFAULT_ENGINE_CONFIG = {
+    defaults: DEFAULT_CONFIG,
+    budget: { window: 60000, maxRetries: 100, minSuccessRatio: 0 },
+    maxConcurrent: 10
+};
+// Fibonacci sequence for fibonacci backoff
+const FIBONACCI = [1, 1, 2, 3, 5, 8, 13, 21, 34, 55, 89, 144, 233, 377, 610];
+// ============================================================================
+// RetryEngine Implementation
+// ============================================================================
+/**
+ * Retry engine with configurable backoff strategies
+ *
+ * @example
+ * ```typescript
+ * const retry = new RetryEngine();
+ *
+ * // Simple retry
+ * const result = await retry.execute(async () => {
+ *   return await fetchData();
+ * });
+ *
+ * // With custom config
+ * const result = await retry.execute(
+ *   async () => fetchData(),
+ *   {
+ *     maxAttempts: 5,
+ *     backoff: 'exponential_jitter',
+ *     initialDelay: 100,
+ *     maxDelay: 5000
+ *   }
+ * );
+ *
+ * // With hooks
+ * const result = await retry.execute(
+ *   async () => fetchData(),
+ *   { maxAttempts: 3 },
+ *   {
+ *     onError: (err, attempt) => console.log(`Attempt ${attempt} failed: ${err.message}`),
+ *     onSuccess: (result) => console.log('Success!', result)
+ *   }
+ * );
+ * ```
+ */
+export class RetryEngine extends EventEmitter {
+    config;
+    budgetState = new Map();
+    activeRetries = 0;
+    lastDelay = 0;
+    constructor(config = {}) {
+        super();
+        this.config = {
+            ...DEFAULT_ENGINE_CONFIG,
+            ...config,
+            defaults: { ...DEFAULT_CONFIG, ...config.defaults },
+            budget: config.budget ? { ...DEFAULT_ENGINE_CONFIG.budget, ...config.budget } : DEFAULT_ENGINE_CONFIG.budget
+        };
+    }
+    // --------------------------------------------------------------------------
+    // Core Retry Logic
+    // --------------------------------------------------------------------------
+    /**
+     * Execute a function with retry logic
+     */
+    async execute(fn, config = {}, hooks = {}) {
+        const mergedConfig = this.mergeConfig(config);
+        const startTime = Date.now();
+        const attempts = [];
+        let lastError;
+        let lastDelay = 0;
+        // Check concurrent limit
+        if (this.activeRetries >= this.config.maxConcurrent) {
+            return {
+                success: false,
+                error: new Error('Max concurrent retries exceeded'),
+                attempts,
+                totalAttempts: 0,
+                totalDuration: 0,
+                state: 'aborted'
+            };
+        }
+        this.activeRetries++;
+        try {
+            for (let attempt = 1; attempt <= mergedConfig.maxAttempts; attempt++) {
+                // Check abort signal
+                if (mergedConfig.abortSignal?.aborted) {
+                    await hooks.onAbort?.(attempt);
+                    this.emit('event', { type: 'retry_aborted', attempt });
+                    return {
+                        success: false,
+                        error: new Error('Retry aborted'),
+                        attempts,
+                        totalAttempts: attempt,
+                        totalDuration: Date.now() - startTime,
+                        state: 'aborted'
+                    };
+                }
+                // Check total timeout
+                if (Date.now() - startTime > mergedConfig.totalTimeout) {
+                    return {
+                        success: false,
+                        error: new Error('Total retry timeout exceeded'),
+                        attempts,
+                        totalAttempts: attempt,
+                        totalDuration: Date.now() - startTime,
+                        state: 'exhausted'
+                    };
+                }
+                // Check budget
+                if (!this.checkBudget('default')) {
+                    this.emit('event', { type: 'budget_exceeded', used: this.getBudgetState('default').used, max: this.config.budget.maxRetries });
+                    return {
+                        success: false,
+                        error: new Error('Retry budget exceeded'),
+                        attempts,
+                        totalAttempts: attempt,
+                        totalDuration: Date.now() - startTime,
+                        state: 'exhausted'
+                    };
+                }
+                // Calculate delay for this attempt
+                const delay = attempt === 1 ? 0 : this.calculateDelay(attempt - 1, lastDelay, mergedConfig);
+                lastDelay = delay > 0 ? delay : mergedConfig.initialDelay;
+                // Apply delay before attempt (except first)
+                if (attempt > 1 && delay > 0) {
+                    await hooks.onDelay?.(delay, attempt);
+                    this.emit('event', { type: 'delay_started', attempt, delay });
+                    await this.sleep(delay, mergedConfig.abortSignal);
+                }
+                const attemptInfo = {
+                    attempt,
+                    delay,
+                    startTime: Date.now(),
+                    success: false
+                };
+                await hooks.onAttempt?.(attempt, delay);
+                this.emit('event', { type: 'attempt_started', attempt, delay });
+                try {
+                    // Execute with timeout
+                    const result = await this.executeWithTimeout(fn, mergedConfig.attemptTimeout, mergedConfig.abortSignal);
+                    attemptInfo.endTime = Date.now();
+                    attemptInfo.duration = attemptInfo.endTime - attemptInfo.startTime;
+                    attemptInfo.success = true;
+                    attempts.push(attemptInfo);
+                    await hooks.onSuccess?.(result, attempt);
+                    this.emit('event', { type: 'attempt_success', attempt, duration: attemptInfo.duration });
+                    this.recordBudgetSuccess('default');
+                    return {
+                        success: true,
+                        result,
+                        attempts,
+                        totalAttempts: attempt,
+                        totalDuration: Date.now() - startTime,
+                        state: 'success'
+                    };
+                }
+                catch (error) {
+                    lastError = error instanceof Error ? error : new Error(String(error));
+                    attemptInfo.endTime = Date.now();
+                    attemptInfo.duration = attemptInfo.endTime - attemptInfo.startTime;
+                    attemptInfo.error = lastError;
+                    attempts.push(attemptInfo);
+                    await hooks.onError?.(lastError, attempt);
+                    this.emit('event', { type: 'attempt_failed', attempt, error: lastError });
+                    this.recordBudgetFailure('default');
+                    // Check retry condition
+                    if (!mergedConfig.retryCondition(lastError, attempt)) {
+                        break;
+                    }
+                    // Check if this was the last attempt
+                    if (attempt === mergedConfig.maxAttempts) {
+                        break;
+                    }
+                }
+            }
+            // Exhausted all retries
+            await hooks.onExhausted?.(lastError, attempts.length);
+            this.emit('event', { type: 'retries_exhausted', attempts: attempts.length, lastError: lastError });
+            return {
+                success: false,
+                error: lastError,
+                attempts,
+                totalAttempts: attempts.length,
+                totalDuration: Date.now() - startTime,
+                state: 'exhausted'
+            };
+        }
+        finally {
+            this.activeRetries--;
+        }
+    }
+    /**
+     * Execute with a preset strategy
+     */
+    async executeWithStrategy(fn, strategy, hooks = {}) {
+        return this.execute(fn, { backoff: strategy }, hooks);
+    }
+    /**
+     * Create a retryable version of a function
+     */
+    retryable(fn, config = {}) {
+        return async (...args) => {
+            return this.execute(() => fn(...args), config);
+        };
+    }
+    // --------------------------------------------------------------------------
+    // Backoff Strategies
+    // --------------------------------------------------------------------------
+    /**
+     * Calculate delay for next attempt
+     */
+    calculateDelay(attempt, lastDelay, config) {
+        const mergedConfig = this.mergeConfig(config);
+        let delay;
+        switch (mergedConfig.backoff) {
+            case 'constant':
+                delay = mergedConfig.initialDelay;
+                break;
+            case 'linear':
+                delay = mergedConfig.initialDelay * attempt;
+                break;
+            case 'exponential':
+                delay = mergedConfig.initialDelay * Math.pow(mergedConfig.multiplier, attempt - 1);
+                break;
+            case 'exponential_jitter':
+                delay = mergedConfig.initialDelay * Math.pow(mergedConfig.multiplier, attempt - 1);
+                delay = this.addJitter(delay, mergedConfig.jitter);
+                break;
+            case 'decorrelated_jitter':
+                // Decorrelated jitter: next delay is random between initial and 3 * last
+                delay = Math.random() * (3 * Math.max(lastDelay, mergedConfig.initialDelay) - mergedConfig.initialDelay) + mergedConfig.initialDelay;
+                break;
+            case 'fibonacci':
+                delay = mergedConfig.initialDelay * (FIBONACCI[Math.min(attempt - 1, FIBONACCI.length - 1)]);
+                break;
+            case 'custom':
+                delay = mergedConfig.delayFn(attempt, lastDelay);
+                break;
+            default:
+                delay = mergedConfig.initialDelay;
+        }
+        // Apply max delay cap
+        return Math.min(delay, mergedConfig.maxDelay);
+    }
+    /**
+     * Get delay for a specific strategy and attempt
+     */
+    getDelay(strategy, attempt, config = {}) {
+        const fullConfig = this.mergeConfig({ ...config, backoff: strategy });
+        return this.calculateDelay(attempt, this.lastDelay, fullConfig);
+    }
+    // --------------------------------------------------------------------------
+    // Budget Management
+    // --------------------------------------------------------------------------
+    /**
+     * Check if retry is allowed by budget
+     */
+    checkBudget(name = 'default') {
+        const state = this.getBudgetState(name);
+        this.refreshBudget(name);
+        if (state.used >= this.config.budget.maxRetries) {
+            return false;
+        }
+        if (this.config.budget.minSuccessRatio && this.config.budget.minSuccessRatio > 0) {
+            const total = state.successes + state.failures;
+            if (total > 0) {
+                const ratio = state.successes / total;
+                if (ratio < this.config.budget.minSuccessRatio) {
+                    return false;
+                }
+            }
+        }
+        return true;
+    }
+    /**
+     * Get budget state
+     */
+    getBudgetState(name = 'default') {
+        if (!this.budgetState.has(name)) {
+            this.budgetState.set(name, {
+                available: this.config.budget.maxRetries,
+                used: 0,
+                successes: 0,
+                failures: 0,
+                windowStart: Date.now(),
+                allowed: true
+            });
+        }
+        return this.budgetState.get(name);
+    }
+    /**
+     * Reset budget
+     */
+    resetBudget(name = 'default') {
+        this.budgetState.delete(name);
+    }
+    /**
+     * Reset all budgets
+     */
+    resetAllBudgets() {
+        this.budgetState.clear();
+    }
+    // --------------------------------------------------------------------------
+    // Configuration
+    // --------------------------------------------------------------------------
+    /**
+     * Get default configuration
+     */
+    getDefaults() {
+        return { ...this.config.defaults };
+    }
+    /**
+     * Update default configuration
+     */
+    setDefaults(config) {
+        this.config.defaults = { ...this.config.defaults, ...config };
+    }
+    /**
+     * Get current active retries count
+     */
+    getActiveRetries() {
+        return this.activeRetries;
+    }
+    // --------------------------------------------------------------------------
+    // Utilities
+    // --------------------------------------------------------------------------
+    /**
+     * Create an abort controller for retries
+     */
+    createAbortController() {
+        return new AbortController();
+    }
+    /**
+     * Wait for a specified delay
+     */
+    async delay(ms) {
+        return this.sleep(ms);
+    }
+    /**
+     * Shutdown the engine
+     */
+    shutdown() {
+        this.budgetState.clear();
+        this.removeAllListeners();
+    }
+    // --------------------------------------------------------------------------
+    // Private Methods
+    // --------------------------------------------------------------------------
+    mergeConfig(config) {
+        return {
+            ...DEFAULT_CONFIG,
+            ...this.config.defaults,
+            ...config
+        };
+    }
+    addJitter(delay, jitterFactor) {
+        const jitter = delay * jitterFactor;
+        return delay + (Math.random() * 2 - 1) * jitter;
+    }
+    async sleep(ms, signal) {
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(resolve, ms);
+            if (signal) {
+                const onAbort = () => {
+                    clearTimeout(timeout);
+                    reject(new Error('Sleep aborted'));
+                };
+                if (signal.aborted) {
+                    onAbort();
+                    return;
+                }
+                signal.addEventListener('abort', onAbort, { once: true });
+            }
+        });
+    }
+    async executeWithTimeout(fn, timeout, signal) {
+        return new Promise((resolve, reject) => {
+            let completed = false;
+            const timeoutId = setTimeout(() => {
+                if (!completed) {
+                    completed = true;
+                    reject(new Error(`Operation timed out after ${timeout}ms`));
+                }
+            }, timeout);
+            const onAbort = () => {
+                if (!completed) {
+                    completed = true;
+                    clearTimeout(timeoutId);
+                    reject(new Error('Operation aborted'));
+                }
+            };
+            if (signal) {
+                if (signal.aborted) {
+                    clearTimeout(timeoutId);
+                    reject(new Error('Operation aborted'));
+                    return;
+                }
+                signal.addEventListener('abort', onAbort, { once: true });
+            }
+            Promise.resolve(fn())
+                .then(result => {
+                if (!completed) {
+                    completed = true;
+                    clearTimeout(timeoutId);
+                    resolve(result);
+                }
+            })
+                .catch(error => {
+                if (!completed) {
+                    completed = true;
+                    clearTimeout(timeoutId);
+                    reject(error);
+                }
+            });
+        });
+    }
+    refreshBudget(name) {
+        const state = this.getBudgetState(name);
+        const now = Date.now();
+        if (now - state.windowStart > this.config.budget.window) {
+            // Reset window
+            state.windowStart = now;
+            state.used = 0;
+            state.successes = 0;
+            state.failures = 0;
+            state.available = this.config.budget.maxRetries;
+            state.allowed = true;
+        }
+    }
+    recordBudgetSuccess(name) {
+        const state = this.getBudgetState(name);
+        state.successes++;
+    }
+    recordBudgetFailure(name) {
+        const state = this.getBudgetState(name);
+        state.failures++;
+        state.used++;
+        state.available = Math.max(0, this.config.budget.maxRetries - state.used);
+    }
+}
+//# sourceMappingURL=RetryEngine.js.map

package/dist/v10/recovery/RetryEngine.js.map

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

package/dist/v10/recovery/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * FlutterAI v10 - Recovery Module
+ *
+ * Error recovery and retry logic.
+ *
+ * Components:
+ * - ErrorRecovery: Automatic error classification and recovery strategies
+ * - RetryEngine: Configurable retry logic with multiple backoff strategies
+ *
+ * @module v10/recovery
+ */
+export { ErrorRecovery, type ErrorSeverity, type ErrorCategory, type RecoveryAction, type ClassifiedError, type RecoveryStrategy, type RecoveryAttempt, type RecoveryResult, type ErrorRecoveryConfig, type ErrorClassifier, type RecoveryStats, type RecoveryEvent } from './ErrorRecovery.js';
+export { RetryEngine, type BackoffStrategy, type RetryState, type RetryConfig, type RetryAttemptInfo, type RetryResult, type RetryBudgetConfig, type RetryBudgetState, type RetryHooks, type RetryEngineConfig, type RetryEvent } from './RetryEngine.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/v10/recovery/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/v10/recovery/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,EACL,aAAa,EACb,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,aAAa,EACnB,MAAM,oBAAoB,CAAC;AAM5B,OAAO,EACL,WAAW,EACX,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,UAAU,EAChB,MAAM,kBAAkB,CAAC"}

package/dist/v10/recovery/index.js

@@ -0,0 +1,20 @@
+/**
+ * FlutterAI v10 - Recovery Module
+ *
+ * Error recovery and retry logic.
+ *
+ * Components:
+ * - ErrorRecovery: Automatic error classification and recovery strategies
+ * - RetryEngine: Configurable retry logic with multiple backoff strategies
+ *
+ * @module v10/recovery
+ */
+// ============================================================================
+// ErrorRecovery Exports
+// ============================================================================
+export { ErrorRecovery } from './ErrorRecovery.js';
+// ============================================================================
+// RetryEngine Exports
+// ============================================================================
+export { RetryEngine } from './RetryEngine.js';
+//# sourceMappingURL=index.js.map

package/dist/v10/recovery/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v10/recovery/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E,OAAO,EACL,aAAa,EAYd,MAAM,oBAAoB,CAAC;AAE5B,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E,OAAO,EACL,WAAW,EAWZ,MAAM,kBAAkB,CAAC"}