@felixgeelhaar/govee-api-client 1.1.0 → 2.0.1

package/dist/infrastructure/retry/RetryConfigPresets.js

@@ -0,0 +1,406 @@
+import { RateLimitError, NetworkError, GoveeApiError } from '../../errors';
+/**
+ * Environment-specific retry configuration presets
+ */
+export class RetryConfigPresets {
+    /**
+     * Development environment configuration - aggressive retries for testing
+     */
+    static development(logger) {
+        return {
+            backoff: {
+                type: 'exponential',
+                initialDelayMs: 100, // Start very fast
+                maxDelayMs: 5000, // Cap at 5 seconds
+                multiplier: 1.5, // Gentle exponential growth
+            },
+            jitter: {
+                type: 'equal',
+                factor: 0.2,
+            },
+            condition: {
+                maxAttempts: 5, // More attempts for testing
+                maxTotalTimeMs: 15000, // 15 seconds total
+                retryableStatusCodes: [400, 408, 429, 500, 502, 503, 504],
+                retryableErrorTypes: [RateLimitError, NetworkError, GoveeApiError],
+            },
+            circuitBreaker: {
+                enabled: false, // Disabled for development
+                failureThreshold: 10,
+                recoveryTimeoutMs: 5000,
+                halfOpenSuccessThreshold: 1,
+            },
+            logger,
+            enableMetrics: true,
+        };
+    }
+    /**
+     * Testing environment configuration - predictable behavior
+     */
+    static testing(logger) {
+        return {
+            backoff: {
+                type: 'fixed',
+                initialDelayMs: 100, // Fixed delay for predictable tests
+                maxDelayMs: 100,
+            },
+            jitter: {
+                type: 'none', // No jitter for predictable timing
+            },
+            condition: {
+                maxAttempts: 3,
+                maxTotalTimeMs: 1000, // Quick for tests
+                retryableStatusCodes: [429, 502, 503, 504],
+                retryableErrorTypes: [RateLimitError, NetworkError, GoveeApiError],
+            },
+            circuitBreaker: {
+                enabled: false, // Disabled for testing
+                failureThreshold: 5,
+                recoveryTimeoutMs: 1000,
+                halfOpenSuccessThreshold: 1,
+            },
+            logger,
+            enableMetrics: false, // Disabled for cleaner test output
+        };
+    }
+    /**
+     * Production environment configuration - conservative and reliable
+     */
+    static production(logger) {
+        return {
+            backoff: {
+                type: 'exponential',
+                initialDelayMs: 2000, // Start with 2 seconds
+                maxDelayMs: 60000, // Cap at 1 minute
+                multiplier: 2.0, // Standard exponential backoff
+            },
+            jitter: {
+                type: 'decorrelated', // Sophisticated jitter
+                factor: 0.1,
+            },
+            condition: {
+                maxAttempts: 3, // Conservative retry count
+                maxTotalTimeMs: 180000, // 3 minutes total
+                retryableStatusCodes: [429, 502, 503, 504], // Only server errors
+                retryableErrorTypes: [RateLimitError, NetworkError, GoveeApiError],
+            },
+            circuitBreaker: {
+                enabled: true,
+                failureThreshold: 5,
+                recoveryTimeoutMs: 60000, // 1 minute recovery
+                halfOpenSuccessThreshold: 3,
+            },
+            logger,
+            enableMetrics: true,
+        };
+    }
+    /**
+     * High-frequency operations configuration - optimized for frequent API calls
+     */
+    static highFrequency(logger) {
+        return {
+            backoff: {
+                type: 'linear',
+                initialDelayMs: 500,
+                maxDelayMs: 5000,
+            },
+            jitter: {
+                type: 'full',
+                factor: 0.5, // High jitter to spread load
+            },
+            condition: {
+                maxAttempts: 2, // Quick failure for high frequency
+                maxTotalTimeMs: 10000, // 10 seconds max
+                retryableStatusCodes: [429, 503, 504],
+                retryableErrorTypes: [RateLimitError, NetworkError],
+            },
+            circuitBreaker: {
+                enabled: true,
+                failureThreshold: 3, // Quick circuit opening
+                recoveryTimeoutMs: 15000,
+                halfOpenSuccessThreshold: 2,
+            },
+            logger,
+            enableMetrics: true,
+        };
+    }
+    /**
+     * Rate-limit aware configuration - optimized for APIs with strict rate limits
+     */
+    static rateLimitAware(logger) {
+        return {
+            backoff: {
+                type: 'exponential',
+                initialDelayMs: 1000,
+                maxDelayMs: 300000, // 5 minutes for severe rate limiting
+                multiplier: 1.5,
+            },
+            jitter: {
+                type: 'equal',
+                factor: 0.05, // Low jitter to respect rate limits
+            },
+            condition: {
+                maxAttempts: 3,
+                maxTotalTimeMs: 600000, // 10 minutes total
+                retryableStatusCodes: [429],
+                retryableErrorTypes: [RateLimitError],
+                shouldRetry: (error, attempt, elapsed) => {
+                    // Custom logic for rate limit errors
+                    if (error instanceof RateLimitError) {
+                        return error.canRetry() && attempt < 3;
+                    }
+                    return false;
+                },
+            },
+            circuitBreaker: {
+                enabled: false, // Don't use circuit breaker with rate limits
+                failureThreshold: 1,
+                recoveryTimeoutMs: 60000,
+                halfOpenSuccessThreshold: 1,
+            },
+            logger,
+            enableMetrics: true,
+        };
+    }
+    /**
+     * Network-resilient configuration - optimized for unreliable networks
+     */
+    static networkResilient(logger) {
+        return {
+            backoff: {
+                type: 'exponential',
+                initialDelayMs: 2000,
+                maxDelayMs: 30000,
+                multiplier: 2.0,
+            },
+            jitter: {
+                type: 'decorrelated',
+                factor: 0.3, // High jitter for network issues
+            },
+            condition: {
+                maxAttempts: 5, // More attempts for network issues
+                maxTotalTimeMs: 120000, // 2 minutes
+                retryableStatusCodes: [408, 502, 503, 504],
+                retryableErrorTypes: [NetworkError],
+                shouldRetry: (error, attempt, elapsed) => {
+                    // Only retry network errors that are explicitly retryable
+                    if (error instanceof NetworkError) {
+                        return error.isRetryable() && attempt < 5;
+                    }
+                    return false;
+                },
+            },
+            circuitBreaker: {
+                enabled: true,
+                failureThreshold: 7, // Higher threshold for network issues
+                recoveryTimeoutMs: 30000,
+                halfOpenSuccessThreshold: 2,
+            },
+            logger,
+            enableMetrics: true,
+        };
+    }
+    /**
+     * Custom configuration builder for specific use cases
+     */
+    static custom() {
+        return new RetryConfigBuilder();
+    }
+}
+/**
+ * Fluent builder for creating custom retry configurations
+ */
+export class RetryConfigBuilder {
+    constructor() {
+        this.config = {};
+    }
+    /**
+     * Set backoff strategy
+     */
+    withBackoff(strategy) {
+        this.config.backoff = strategy;
+        return this;
+    }
+    /**
+     * Set exponential backoff with defaults
+     */
+    withExponentialBackoff(initialDelayMs = 1000, maxDelayMs = 30000, multiplier = 2.0) {
+        this.config.backoff = {
+            type: 'exponential',
+            initialDelayMs,
+            maxDelayMs,
+            multiplier,
+        };
+        return this;
+    }
+    /**
+     * Set linear backoff
+     */
+    withLinearBackoff(initialDelayMs = 1000, maxDelayMs = 10000) {
+        this.config.backoff = {
+            type: 'linear',
+            initialDelayMs,
+            maxDelayMs,
+        };
+        return this;
+    }
+    /**
+     * Set fixed backoff
+     */
+    withFixedBackoff(delayMs = 1000) {
+        this.config.backoff = {
+            type: 'fixed',
+            initialDelayMs: delayMs,
+            maxDelayMs: delayMs,
+        };
+        return this;
+    }
+    /**
+     * Set custom backoff function
+     */
+    withCustomBackoff(initialDelayMs, maxDelayMs, customBackoff) {
+        this.config.backoff = {
+            type: 'custom',
+            initialDelayMs,
+            maxDelayMs,
+            customBackoff,
+        };
+        return this;
+    }
+    /**
+     * Set jitter configuration
+     */
+    withJitter(jitter) {
+        this.config.jitter = jitter;
+        return this;
+    }
+    /**
+     * Set no jitter
+     */
+    withoutJitter() {
+        this.config.jitter = { type: 'none' };
+        return this;
+    }
+    /**
+     * Set equal jitter
+     */
+    withEqualJitter(factor = 0.1) {
+        this.config.jitter = { type: 'equal', factor };
+        return this;
+    }
+    /**
+     * Set full jitter
+     */
+    withFullJitter(factor = 0.1) {
+        this.config.jitter = { type: 'full', factor };
+        return this;
+    }
+    /**
+     * Set decorrelated jitter
+     */
+    withDecorrelatedJitter(factor = 0.1) {
+        this.config.jitter = { type: 'decorrelated', factor };
+        return this;
+    }
+    /**
+     * Set retry conditions
+     */
+    withConditions(conditions) {
+        this.config.condition = conditions;
+        return this;
+    }
+    /**
+     * Set basic retry conditions
+     */
+    withBasicConditions(maxAttempts = 3, maxTotalTimeMs = 60000, retryableStatusCodes = [429, 502, 503, 504]) {
+        this.config.condition = {
+            maxAttempts,
+            maxTotalTimeMs,
+            retryableStatusCodes,
+            retryableErrorTypes: [RateLimitError, NetworkError, GoveeApiError],
+        };
+        return this;
+    }
+    /**
+     * Set circuit breaker configuration
+     */
+    withCircuitBreaker(circuitBreaker) {
+        this.config.circuitBreaker = circuitBreaker;
+        return this;
+    }
+    /**
+     * Enable circuit breaker with defaults
+     */
+    withBasicCircuitBreaker(failureThreshold = 5, recoveryTimeoutMs = 30000, halfOpenSuccessThreshold = 2) {
+        this.config.circuitBreaker = {
+            enabled: true,
+            failureThreshold,
+            recoveryTimeoutMs,
+            halfOpenSuccessThreshold,
+        };
+        return this;
+    }
+    /**
+     * Disable circuit breaker
+     */
+    withoutCircuitBreaker() {
+        this.config.circuitBreaker = {
+            enabled: false,
+            failureThreshold: 1,
+            recoveryTimeoutMs: 1000,
+            halfOpenSuccessThreshold: 1,
+        };
+        return this;
+    }
+    /**
+     * Set logger
+     */
+    withLogger(logger) {
+        this.config.logger = logger;
+        return this;
+    }
+    /**
+     * Enable or disable metrics
+     */
+    withMetrics(enabled = true) {
+        this.config.enableMetrics = enabled;
+        return this;
+    }
+    /**
+     * Build the final configuration
+     */
+    build() {
+        // Ensure required fields have defaults
+        const backoff = this.config.backoff || {
+            type: 'exponential',
+            initialDelayMs: 1000,
+            maxDelayMs: 30000,
+            multiplier: 2.0,
+        };
+        const jitter = this.config.jitter || {
+            type: 'equal',
+            factor: 0.1,
+        };
+        const condition = this.config.condition || {
+            maxAttempts: 3,
+            maxTotalTimeMs: 60000,
+            retryableStatusCodes: [429, 502, 503, 504],
+            retryableErrorTypes: [RateLimitError, NetworkError, GoveeApiError],
+        };
+        const circuitBreaker = this.config.circuitBreaker || {
+            enabled: true,
+            failureThreshold: 5,
+            recoveryTimeoutMs: 30000,
+            halfOpenSuccessThreshold: 2,
+        };
+        return {
+            backoff,
+            jitter,
+            condition,
+            circuitBreaker,
+            logger: this.config.logger,
+            enableMetrics: this.config.enableMetrics ?? true,
+        };
+    }
+}
+//# sourceMappingURL=RetryConfigPresets.js.map

package/dist/infrastructure/retry/RetryConfigPresets.js.map

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

package/dist/infrastructure/retry/RetryPolicy.d.ts

@@ -0,0 +1,148 @@
+import { Logger } from 'pino';
+import { GoveeApiClientError } from '../../errors';
+/**
+ * Backoff strategy configuration for retry policies
+ */
+export interface BackoffStrategy {
+    /** Type of backoff algorithm */
+    type: 'exponential' | 'linear' | 'fixed' | 'custom';
+    /** Initial delay in milliseconds */
+    initialDelayMs: number;
+    /** Maximum delay between retries in milliseconds */
+    maxDelayMs: number;
+    /** Multiplier for exponential backoff (default: 2.0) */
+    multiplier?: number;
+    /** Custom backoff function for 'custom' type */
+    customBackoff?: (attempt: number, error: GoveeApiClientError) => number;
+}
+/**
+ * Jitter configuration to prevent thundering herd problems
+ */
+export interface JitterConfig {
+    /** Type of jitter algorithm */
+    type: 'none' | 'full' | 'equal' | 'decorrelated';
+    /** Jitter factor (0.0 to 1.0) */
+    factor?: number;
+}
+/**
+ * Retry condition configuration
+ */
+export interface RetryCondition {
+    /** Maximum number of retry attempts */
+    maxAttempts: number;
+    /** Maximum total time to spend retrying in milliseconds */
+    maxTotalTimeMs: number;
+    /** HTTP status codes that should trigger retries */
+    retryableStatusCodes: number[];
+    /** Error types that should trigger retries */
+    retryableErrorTypes: (new (...args: any[]) => GoveeApiClientError)[];
+    /** Custom retry decision function */
+    shouldRetry?: (error: GoveeApiClientError, attempt: number, elapsed: number) => boolean;
+}
+/**
+ * Circuit breaker configuration for retry policies
+ */
+export interface CircuitBreakerConfig {
+    /** Enable circuit breaker functionality */
+    enabled: boolean;
+    /** Number of consecutive failures to open circuit */
+    failureThreshold: number;
+    /** Time to wait before attempting to close circuit (ms) */
+    recoveryTimeoutMs: number;
+    /** Percentage of requests to allow through when half-open */
+    halfOpenSuccessThreshold: number;
+}
+/**
+ * Retry metrics for observability
+ */
+export interface RetryMetrics {
+    /** Total number of retry attempts */
+    totalAttempts: number;
+    /** Total number of successful retries */
+    successfulRetries: number;
+    /** Total number of failed retries */
+    failedRetries: number;
+    /** Total time spent retrying */
+    totalRetryTimeMs: number;
+    /** Average retry delay */
+    averageRetryDelayMs: number;
+    /** Circuit breaker state */
+    circuitBreakerState: 'closed' | 'open' | 'half-open';
+    /** Last error encountered */
+    lastError?: GoveeApiClientError;
+    /** Timestamp of last retry attempt */
+    lastRetryTimestamp?: Date;
+}
+/**
+ * Complete retry policy configuration
+ */
+export interface RetryPolicyConfig {
+    /** Backoff strategy configuration */
+    backoff: BackoffStrategy;
+    /** Jitter configuration */
+    jitter: JitterConfig;
+    /** Retry condition configuration */
+    condition: RetryCondition;
+    /** Circuit breaker configuration */
+    circuitBreaker?: CircuitBreakerConfig;
+    /** Logger instance for retry operations */
+    logger?: Logger;
+    /** Enable detailed metrics collection */
+    enableMetrics?: boolean;
+}
+/**
+ * Enterprise-grade retry policy with exponential backoff, jitter, and circuit breaker
+ */
+export declare class RetryPolicy {
+    private readonly config;
+    private readonly circuitBreaker?;
+    private readonly metrics;
+    private readonly logger?;
+    constructor(config: RetryPolicyConfig);
+    private validateConfig;
+    /**
+     * Determines if an error should trigger a retry attempt
+     */
+    shouldRetry(error: GoveeApiClientError, attempt: number, elapsedTimeMs: number): boolean;
+    /**
+     * Calculates the delay before the next retry attempt
+     */
+    calculateDelay(attempt: number, error: GoveeApiClientError): number;
+    /**
+     * Applies jitter to prevent thundering herd problems
+     */
+    private applyJitter;
+    /**
+     * Records a successful operation
+     */
+    recordSuccess(): void;
+    /**
+     * Records a failed operation
+     */
+    recordFailure(error: GoveeApiClientError): void;
+    /**
+     * Updates retry metrics
+     */
+    private updateMetrics;
+    /**
+     * Gets current retry metrics
+     */
+    getMetrics(): Readonly<RetryMetrics>;
+    /**
+     * Resets retry metrics and circuit breaker
+     */
+    reset(): void;
+    /**
+     * Creates a default retry policy optimized for Govee API
+     */
+    static createGoveeOptimized(logger?: Logger): RetryPolicy;
+    /**
+     * Creates a conservative retry policy for production environments
+     */
+    static createConservative(logger?: Logger): RetryPolicy;
+    /**
+     * Creates an aggressive retry policy for development/testing
+     */
+    static createAggressive(logger?: Logger): RetryPolicy;
+}
+//# sourceMappingURL=RetryPolicy.d.ts.map

package/dist/infrastructure/retry/RetryPolicy.d.ts.map

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