@felixgeelhaar/govee-api-client 1.1.0 → 2.0.1

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

@@ -0,0 +1,133 @@
+/**
+ * Integration Guide for Retry Logic with Govee API Client
+ *
+ * This file provides comprehensive examples and integration patterns for
+ * adding retry logic to the Govee API client after rate limiting is implemented.
+ */
+import { Logger } from 'pino';
+import { GoveeControlService } from '../../services/GoveeControlService';
+import { RetryPolicy, RetryableRepository } from './index';
+/**
+ * INTEGRATION EXAMPLE 1: Basic Retry-Enabled Repository
+ *
+ * This example shows how to wrap the existing GoveeDeviceRepository
+ * with retry functionality using default Govee API optimized settings.
+ */
+export declare function createBasicRetryRepository(apiKey: string, logger?: Logger): RetryableRepository;
+/**
+ * INTEGRATION EXAMPLE 2: Production-Ready Service with Retry Logic
+ *
+ * This example shows how to integrate retry logic into the GoveeControlService
+ * for production environments with conservative retry policies.
+ */
+export declare function createProductionGoveeService(apiKey: string, logger: Logger): GoveeControlService;
+/**
+ * INTEGRATION EXAMPLE 3: Custom Retry Configuration for Specific Use Cases
+ *
+ * This example demonstrates creating custom retry policies for different
+ * operational scenarios.
+ */
+export declare class CustomRetryConfigurations {
+    /**
+     * Configuration for bulk operations that need to be resilient
+     */
+    static createBulkOperationConfig(logger?: Logger): RetryPolicy;
+    /**
+     * Configuration for real-time operations that need fast failure
+     */
+    static createRealTimeConfig(logger?: Logger): RetryPolicy;
+    /**
+     * Configuration optimized for rate-limited APIs
+     */
+    static createRateLimitOptimizedConfig(logger?: Logger): RetryPolicy;
+}
+/**
+ * INTEGRATION EXAMPLE 4: Service with Multiple Retry Strategies
+ *
+ * This example shows how to use different retry strategies for different
+ * types of operations within the same service.
+ */
+export declare class AdvancedGoveeService {
+    private readonly bulkRepository;
+    private readonly realTimeRepository;
+    private readonly baseRepository;
+    private readonly logger;
+    constructor(apiKey: string, logger: Logger);
+    /**
+     * Bulk device discovery with resilient retry logic
+     */
+    discoverAllDevices(): Promise<import("../..").GoveeDevice[]>;
+    /**
+     * Real-time device state check with fast failure
+     */
+    getDeviceStateRealTime(deviceId: string, sku: string): Promise<import("../..").DeviceState>;
+    /**
+     * Get comprehensive retry metrics across all strategies
+     */
+    getRetryMetrics(): {
+        bulk: Readonly<import("./RetryPolicy").RetryMetrics>;
+        realTime: Readonly<import("./RetryPolicy").RetryMetrics>;
+    };
+    /**
+     * Reset all retry metrics
+     */
+    resetMetrics(): void;
+}
+/**
+ * INTEGRATION EXAMPLE 5: Monitoring and Observability Integration
+ *
+ * This example shows how to integrate retry metrics with monitoring systems.
+ */
+export declare class RetryMetricsCollector {
+    private readonly retryableRepository;
+    private readonly logger;
+    private readonly metricsIntervalMs;
+    private metricsInterval?;
+    constructor(retryableRepository: RetryableRepository, logger: Logger, metricsIntervalMs?: number);
+    /**
+     * Start collecting and logging retry metrics
+     */
+    startMetricsCollection(): void;
+    /**
+     * Stop metrics collection
+     */
+    stopMetricsCollection(): void;
+    /**
+     * Get current metrics snapshot
+     */
+    getMetricsSnapshot(): {
+        timestamp: string;
+        total_attempts: number;
+        successful_retries: number;
+        failed_retries: number;
+        success_rate: number;
+        average_retry_delay_ms: number;
+        circuit_breaker_state: "closed" | "open" | "half-open";
+        last_error: {
+            name: string;
+            code: string;
+            message: string;
+            timestamp: string;
+            stack?: string;
+            cause?: unknown;
+        } | undefined;
+        last_retry: string | undefined;
+    };
+}
+/**
+ * INTEGRATION EXAMPLE 6: Environment-Specific Configuration Factory
+ *
+ * This factory creates appropriate retry configurations based on environment.
+ */
+export declare class RetryConfigFactory {
+    /**
+     * Create retry configuration based on environment
+     */
+    static createForEnvironment(environment: 'development' | 'testing' | 'staging' | 'production', logger?: Logger): RetryPolicy;
+    /**
+     * Create retry configuration for specific use cases
+     */
+    static createForUseCase(useCase: 'bulk' | 'realtime' | 'background' | 'interactive', logger?: Logger): RetryPolicy;
+}
+export { RetryExecutorFactory } from './RetryableRequest';
+//# sourceMappingURL=IntegrationGuide.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IntegrationGuide.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/retry/IntegrationGuide.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAE9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EACL,WAAW,EAEX,mBAAmB,EAIpB,MAAM,SAAS,CAAC;AAEjB;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAiB/F;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,mBAAmB,CA6BhG;AAED;;;;;GAKG;AACH,qBAAa,yBAAyB;IACpC;;OAEG;IACH,MAAM,CAAC,yBAAyB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW;IAe9D;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW;IAezD;;OAEG;IACH,MAAM,CAAC,8BAA8B,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW;CAGpE;AAED;;;;;GAKG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsB;IACrD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAsB;IACzD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwB;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAmC1C;;OAEG;IACG,kBAAkB;IAsBxB;;OAEG;IACG,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;IAqB1D;;OAEG;IACH,eAAe;;;;IAOf;;OAEG;IACH,YAAY;CAIb;AAED;;;;GAIG;AACH,qBAAa,qBAAqB;IAI9B,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IALpC,OAAO,CAAC,eAAe,CAAC,CAAiB;gBAGtB,mBAAmB,EAAE,mBAAmB,EACxC,MAAM,EAAE,MAAM,EACd,iBAAiB,GAAE,MAAc;IAGpD;;OAEG;IACH,sBAAsB;IAsBtB;;OAEG;IACH,qBAAqB;IAOrB;;OAEG;IACH,kBAAkB;;;;;;;;;;;;;;;;;;CAgBnB;AAED;;;;GAIG;AACH,qBAAa,kBAAkB;IAC7B;;OAEG;IACH,MAAM,CAAC,oBAAoB,CACzB,WAAW,EAAE,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,YAAY,EACjE,MAAM,CAAC,EAAE,MAAM,GACd,WAAW;IAuBd;;OAEG;IACH,MAAM,CAAC,gBAAgB,CACrB,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,YAAY,GAAG,aAAa,EAC3D,MAAM,CAAC,EAAE,MAAM,GACd,WAAW;CAkBf;AAGD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/infrastructure/retry/IntegrationGuide.js

@@ -0,0 +1,295 @@
+/**
+ * Integration Guide for Retry Logic with Govee API Client
+ *
+ * This file provides comprehensive examples and integration patterns for
+ * adding retry logic to the Govee API client after rate limiting is implemented.
+ */
+import { GoveeDeviceRepository } from '../GoveeDeviceRepository';
+import { GoveeControlService } from '../../services/GoveeControlService';
+import { RetryPolicy, RetryExecutor, RetryableRepository, RetryConfigPresets, RetryExecutorFactory, } from './index';
+/**
+ * INTEGRATION EXAMPLE 1: Basic Retry-Enabled Repository
+ *
+ * This example shows how to wrap the existing GoveeDeviceRepository
+ * with retry functionality using default Govee API optimized settings.
+ */
+export function createBasicRetryRepository(apiKey, logger) {
+    // Create the base repository
+    const baseRepository = new GoveeDeviceRepository({
+        apiKey,
+        timeout: 30000,
+        logger,
+    });
+    // Wrap with retry functionality
+    const retryableRepository = new RetryableRepository({
+        repository: baseRepository,
+        retryExecutor: RetryExecutorFactory.createForGoveeApi(logger),
+        logger,
+        enableRequestIds: true,
+    });
+    return retryableRepository;
+}
+/**
+ * INTEGRATION EXAMPLE 2: Production-Ready Service with Retry Logic
+ *
+ * This example shows how to integrate retry logic into the GoveeControlService
+ * for production environments with conservative retry policies.
+ */
+export function createProductionGoveeService(apiKey, logger) {
+    // Create base repository
+    const baseRepository = new GoveeDeviceRepository({
+        apiKey,
+        timeout: 30000,
+        logger,
+    });
+    // Create production-optimized retry executor
+    const retryPolicy = RetryPolicy.createConservative(logger);
+    const retryExecutor = new RetryExecutor(retryPolicy, {
+        logger,
+        enableRequestLogging: true,
+        enablePerformanceTracking: true,
+    });
+    // Wrap repository with retry logic
+    const retryableRepository = new RetryableRepository({
+        repository: baseRepository,
+        retryExecutor,
+        logger,
+    });
+    // Create service with retry-enabled repository
+    return new GoveeControlService({
+        repository: retryableRepository,
+        rateLimit: 100, // 100 requests per minute
+        logger,
+    });
+}
+/**
+ * INTEGRATION EXAMPLE 3: Custom Retry Configuration for Specific Use Cases
+ *
+ * This example demonstrates creating custom retry policies for different
+ * operational scenarios.
+ */
+export class CustomRetryConfigurations {
+    /**
+     * Configuration for bulk operations that need to be resilient
+     */
+    static createBulkOperationConfig(logger) {
+        const builder = RetryConfigPresets.custom()
+            .withExponentialBackoff(2000, 60000, 1.5) // Start at 2s, max 1min, gentle growth
+            .withDecorrelatedJitter(0.2) // Sophisticated jitter
+            .withBasicConditions(5, 300000, [429, 502, 503, 504]) // 5 attempts, 5min total
+            .withBasicCircuitBreaker(7, 60000, 3) // Higher failure threshold
+            .withMetrics(true);
+        if (logger) {
+            builder.withLogger(logger);
+        }
+        return new RetryPolicy(builder.build());
+    }
+    /**
+     * Configuration for real-time operations that need fast failure
+     */
+    static createRealTimeConfig(logger) {
+        const builder = RetryConfigPresets.custom()
+            .withLinearBackoff(500, 2000) // Quick linear backoff
+            .withEqualJitter(0.1) // Low jitter
+            .withBasicConditions(2, 5000, [429, 503, 504]) // Quick failure
+            .withBasicCircuitBreaker(3, 10000, 1) // Fast circuit breaking
+            .withMetrics(true);
+        if (logger) {
+            builder.withLogger(logger);
+        }
+        return new RetryPolicy(builder.build());
+    }
+    /**
+     * Configuration optimized for rate-limited APIs
+     */
+    static createRateLimitOptimizedConfig(logger) {
+        return new RetryPolicy(RetryConfigPresets.rateLimitAware(logger));
+    }
+}
+/**
+ * INTEGRATION EXAMPLE 4: Service with Multiple Retry Strategies
+ *
+ * This example shows how to use different retry strategies for different
+ * types of operations within the same service.
+ */
+export class AdvancedGoveeService {
+    constructor(apiKey, logger) {
+        this.logger = logger;
+        // Create base repository
+        this.baseRepository = new GoveeDeviceRepository({
+            apiKey,
+            timeout: 30000,
+            logger,
+        });
+        // Create bulk operations repository (resilient, slower)
+        const bulkRetryExecutor = new RetryExecutor(CustomRetryConfigurations.createBulkOperationConfig(logger), { logger, enableRequestLogging: true, enablePerformanceTracking: true });
+        this.bulkRepository = new RetryableRepository({
+            repository: this.baseRepository,
+            retryExecutor: bulkRetryExecutor,
+            logger,
+        });
+        // Create real-time repository (fast failure)
+        const realTimeRetryExecutor = new RetryExecutor(CustomRetryConfigurations.createRealTimeConfig(logger), { logger, enableRequestLogging: true, enablePerformanceTracking: true });
+        this.realTimeRepository = new RetryableRepository({
+            repository: this.baseRepository,
+            retryExecutor: realTimeRetryExecutor,
+            logger,
+        });
+    }
+    /**
+     * Bulk device discovery with resilient retry logic
+     */
+    async discoverAllDevices() {
+        this.logger.info('Starting bulk device discovery');
+        const result = await this.bulkRepository.findAllWithRetryResult();
+        this.logger.info({
+            devices: result.data?.length || 0,
+            attempts: result.totalAttempts,
+            totalTime: result.totalTimeMs,
+            success: result.success,
+        }, 'Bulk device discovery completed');
+        if (!result.success) {
+            throw result.error;
+        }
+        return result.data;
+    }
+    /**
+     * Real-time device state check with fast failure
+     */
+    async getDeviceStateRealTime(deviceId, sku) {
+        this.logger.debug({ deviceId, sku }, 'Getting device state (real-time)');
+        const result = await this.realTimeRepository.findStateWithRetryResult(deviceId, sku);
+        if (!result.success) {
+            this.logger.warn({
+                deviceId,
+                sku,
+                attempts: result.totalAttempts,
+                error: result.error?.toObject(),
+            }, 'Real-time state check failed');
+            throw result.error;
+        }
+        return result.data;
+    }
+    /**
+     * Get comprehensive retry metrics across all strategies
+     */
+    getRetryMetrics() {
+        return {
+            bulk: this.bulkRepository.getRetryMetrics(),
+            realTime: this.realTimeRepository.getRetryMetrics(),
+        };
+    }
+    /**
+     * Reset all retry metrics
+     */
+    resetMetrics() {
+        this.bulkRepository.resetRetryMetrics();
+        this.realTimeRepository.resetRetryMetrics();
+    }
+}
+/**
+ * INTEGRATION EXAMPLE 5: Monitoring and Observability Integration
+ *
+ * This example shows how to integrate retry metrics with monitoring systems.
+ */
+export class RetryMetricsCollector {
+    constructor(retryableRepository, logger, metricsIntervalMs = 60000 // 1 minute
+    ) {
+        this.retryableRepository = retryableRepository;
+        this.logger = logger;
+        this.metricsIntervalMs = metricsIntervalMs;
+    }
+    /**
+     * Start collecting and logging retry metrics
+     */
+    startMetricsCollection() {
+        this.metricsInterval = setInterval(() => {
+            const metrics = this.retryableRepository.getRetryMetrics();
+            this.logger.info({
+                retry_metrics: {
+                    total_attempts: metrics.totalAttempts,
+                    successful_retries: metrics.successfulRetries,
+                    failed_retries: metrics.failedRetries,
+                    total_retry_time_ms: metrics.totalRetryTimeMs,
+                    average_retry_delay_ms: metrics.averageRetryDelayMs,
+                    circuit_breaker_state: metrics.circuitBreakerState,
+                    success_rate: metrics.totalAttempts > 0 ? metrics.successfulRetries / metrics.totalAttempts : 0,
+                },
+            }, 'Retry metrics collected');
+        }, this.metricsIntervalMs);
+    }
+    /**
+     * Stop metrics collection
+     */
+    stopMetricsCollection() {
+        if (this.metricsInterval) {
+            clearInterval(this.metricsInterval);
+            this.metricsInterval = undefined;
+        }
+    }
+    /**
+     * Get current metrics snapshot
+     */
+    getMetricsSnapshot() {
+        const metrics = this.retryableRepository.getRetryMetrics();
+        return {
+            timestamp: new Date().toISOString(),
+            total_attempts: metrics.totalAttempts,
+            successful_retries: metrics.successfulRetries,
+            failed_retries: metrics.failedRetries,
+            success_rate: metrics.totalAttempts > 0 ? (metrics.successfulRetries / metrics.totalAttempts) * 100 : 0,
+            average_retry_delay_ms: metrics.averageRetryDelayMs,
+            circuit_breaker_state: metrics.circuitBreakerState,
+            last_error: metrics.lastError?.toObject(),
+            last_retry: metrics.lastRetryTimestamp?.toISOString(),
+        };
+    }
+}
+/**
+ * INTEGRATION EXAMPLE 6: Environment-Specific Configuration Factory
+ *
+ * This factory creates appropriate retry configurations based on environment.
+ */
+export class RetryConfigFactory {
+    /**
+     * Create retry configuration based on environment
+     */
+    static createForEnvironment(environment, logger) {
+        switch (environment) {
+            case 'development':
+                return new RetryPolicy(RetryConfigPresets.development(logger));
+            case 'testing':
+                return new RetryPolicy(RetryConfigPresets.testing(logger));
+            case 'staging':
+                // Use production-like settings but with more logging
+                return new RetryPolicy({
+                    ...RetryConfigPresets.production(logger),
+                    enableMetrics: true,
+                });
+            case 'production':
+                return new RetryPolicy(RetryConfigPresets.production(logger));
+            default:
+                throw new Error(`Unknown environment: ${environment}`);
+        }
+    }
+    /**
+     * Create retry configuration for specific use cases
+     */
+    static createForUseCase(useCase, logger) {
+        switch (useCase) {
+            case 'bulk':
+                return CustomRetryConfigurations.createBulkOperationConfig(logger);
+            case 'realtime':
+                return CustomRetryConfigurations.createRealTimeConfig(logger);
+            case 'background':
+                return new RetryPolicy(RetryConfigPresets.networkResilient(logger));
+            case 'interactive':
+                return new RetryPolicy(RetryConfigPresets.highFrequency(logger));
+            default:
+                throw new Error(`Unknown use case: ${useCase}`);
+        }
+    }
+}
+// Re-export for convenience
+export { RetryExecutorFactory } from './RetryableRequest';
+//# sourceMappingURL=IntegrationGuide.js.map

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

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

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

@@ -0,0 +1,114 @@
+import { Logger } from 'pino';
+import { RetryPolicyConfig, BackoffStrategy, JitterConfig, RetryCondition, CircuitBreakerConfig } from './RetryPolicy';
+/**
+ * Environment-specific retry configuration presets
+ */
+export declare class RetryConfigPresets {
+    /**
+     * Development environment configuration - aggressive retries for testing
+     */
+    static development(logger?: Logger): RetryPolicyConfig;
+    /**
+     * Testing environment configuration - predictable behavior
+     */
+    static testing(logger?: Logger): RetryPolicyConfig;
+    /**
+     * Production environment configuration - conservative and reliable
+     */
+    static production(logger?: Logger): RetryPolicyConfig;
+    /**
+     * High-frequency operations configuration - optimized for frequent API calls
+     */
+    static highFrequency(logger?: Logger): RetryPolicyConfig;
+    /**
+     * Rate-limit aware configuration - optimized for APIs with strict rate limits
+     */
+    static rateLimitAware(logger?: Logger): RetryPolicyConfig;
+    /**
+     * Network-resilient configuration - optimized for unreliable networks
+     */
+    static networkResilient(logger?: Logger): RetryPolicyConfig;
+    /**
+     * Custom configuration builder for specific use cases
+     */
+    static custom(): RetryConfigBuilder;
+}
+/**
+ * Fluent builder for creating custom retry configurations
+ */
+export declare class RetryConfigBuilder {
+    private config;
+    /**
+     * Set backoff strategy
+     */
+    withBackoff(strategy: BackoffStrategy): this;
+    /**
+     * Set exponential backoff with defaults
+     */
+    withExponentialBackoff(initialDelayMs?: number, maxDelayMs?: number, multiplier?: number): this;
+    /**
+     * Set linear backoff
+     */
+    withLinearBackoff(initialDelayMs?: number, maxDelayMs?: number): this;
+    /**
+     * Set fixed backoff
+     */
+    withFixedBackoff(delayMs?: number): this;
+    /**
+     * Set custom backoff function
+     */
+    withCustomBackoff(initialDelayMs: number, maxDelayMs: number, customBackoff: (attempt: number, error: any) => number): this;
+    /**
+     * Set jitter configuration
+     */
+    withJitter(jitter: JitterConfig): this;
+    /**
+     * Set no jitter
+     */
+    withoutJitter(): this;
+    /**
+     * Set equal jitter
+     */
+    withEqualJitter(factor?: number): this;
+    /**
+     * Set full jitter
+     */
+    withFullJitter(factor?: number): this;
+    /**
+     * Set decorrelated jitter
+     */
+    withDecorrelatedJitter(factor?: number): this;
+    /**
+     * Set retry conditions
+     */
+    withConditions(conditions: RetryCondition): this;
+    /**
+     * Set basic retry conditions
+     */
+    withBasicConditions(maxAttempts?: number, maxTotalTimeMs?: number, retryableStatusCodes?: number[]): this;
+    /**
+     * Set circuit breaker configuration
+     */
+    withCircuitBreaker(circuitBreaker: CircuitBreakerConfig): this;
+    /**
+     * Enable circuit breaker with defaults
+     */
+    withBasicCircuitBreaker(failureThreshold?: number, recoveryTimeoutMs?: number, halfOpenSuccessThreshold?: number): this;
+    /**
+     * Disable circuit breaker
+     */
+    withoutCircuitBreaker(): this;
+    /**
+     * Set logger
+     */
+    withLogger(logger: Logger): this;
+    /**
+     * Enable or disable metrics
+     */
+    withMetrics(enabled?: boolean): this;
+    /**
+     * Build the final configuration
+     */
+    build(): RetryPolicyConfig;
+}
+//# sourceMappingURL=RetryConfigPresets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RetryConfigPresets.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/retry/RetryConfigPresets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAC9B,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,cAAc,EACd,oBAAoB,EACrB,MAAM,eAAe,CAAC;AAGvB;;GAEG;AACH,qBAAa,kBAAkB;IAC7B;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,iBAAiB;IA6BtD;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,iBAAiB;IA2BlD;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,iBAAiB;IA6BrD;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,iBAAiB;IA4BxD;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,iBAAiB;IAoCzD;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,iBAAiB;IAoC3D;;OAEG;IACH,MAAM,CAAC,MAAM,IAAI,kBAAkB;CAGpC;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAkC;IAEhD;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAK5C;;OAEG;IACH,sBAAsB,CACpB,cAAc,GAAE,MAAa,EAC7B,UAAU,GAAE,MAAc,EAC1B,UAAU,GAAE,MAAY,GACvB,IAAI;IAUP;;OAEG;IACH,iBAAiB,CAAC,cAAc,GAAE,MAAa,EAAE,UAAU,GAAE,MAAc,GAAG,IAAI;IASlF;;OAEG;IACH,gBAAgB,CAAC,OAAO,GAAE,MAAa,GAAG,IAAI;IAS9C;;OAEG;IACH,iBAAiB,CACf,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,MAAM,GACrD,IAAI;IAUP;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAKtC;;OAEG;IACH,aAAa,IAAI,IAAI;IAKrB;;OAEG;IACH,eAAe,CAAC,MAAM,GAAE,MAAY,GAAG,IAAI;IAK3C;;OAEG;IACH,cAAc,CAAC,MAAM,GAAE,MAAY,GAAG,IAAI;IAK1C;;OAEG;IACH,sBAAsB,CAAC,MAAM,GAAE,MAAY,GAAG,IAAI;IAKlD;;OAEG;IACH,cAAc,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI;IAKhD;;OAEG;IACH,mBAAmB,CACjB,WAAW,GAAE,MAAU,EACvB,cAAc,GAAE,MAAc,EAC9B,oBAAoB,GAAE,MAAM,EAAyB,GACpD,IAAI;IAUP;;OAEG;IACH,kBAAkB,CAAC,cAAc,EAAE,oBAAoB,GAAG,IAAI;IAK9D;;OAEG;IACH,uBAAuB,CACrB,gBAAgB,GAAE,MAAU,EAC5B,iBAAiB,GAAE,MAAc,EACjC,wBAAwB,GAAE,MAAU,GACnC,IAAI;IAUP;;OAEG;IACH,qBAAqB,IAAI,IAAI;IAU7B;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKhC;;OAEG;IACH,WAAW,CAAC,OAAO,GAAE,OAAc,GAAG,IAAI;IAK1C;;OAEG;IACH,KAAK,IAAI,iBAAiB;CAqC3B"}