@sparkleideas/cli 3.1.0-alpha.19 → 3.1.0-alpha.21

package/dist/src/production/error-handler.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Production Error Handling
+ *
+ * Provides standardized error handling with:
+ * - Error classification
+ * - Sanitization (no sensitive data leak)
+ * - Structured error responses
+ * - Error aggregation and reporting
+ *
+ * @module @sparkleideas/cli/production/error-handler
+ */
+export interface ErrorContext {
+    operation: string;
+    tool?: string;
+    input?: Record<string, unknown>;
+    userId?: string;
+    agentId?: string;
+    requestId?: string;
+    timestamp: string;
+}
+export interface ErrorHandlerConfig {
+    includeStack: boolean;
+    sanitize: boolean;
+    reportToMonitoring: boolean;
+    maxErrorsPerMinute: number;
+    errorCategories: Record<string, string[]>;
+}
+export type ErrorCategory = 'validation' | 'authentication' | 'authorization' | 'not_found' | 'rate_limit' | 'timeout' | 'circuit_open' | 'external_service' | 'internal' | 'unknown';
+export interface StructuredError {
+    success: false;
+    error: {
+        code: string;
+        message: string;
+        category: ErrorCategory;
+        retryable: boolean;
+        retryAfterMs?: number;
+        details?: Record<string, unknown>;
+    };
+    context?: Partial<ErrorContext>;
+    timestamp: string;
+}
+export declare class ErrorHandler {
+    private config;
+    private errorCounts;
+    private errorLog;
+    private maxLogSize;
+    constructor(config?: Partial<ErrorHandlerConfig>);
+    /**
+     * Classify an error into a category
+     */
+    classifyError(error: Error | string): ErrorCategory;
+    /**
+     * Check if an error category is retryable
+     */
+    isRetryable(category: ErrorCategory): boolean;
+    /**
+     * Sanitize input to remove sensitive data
+     */
+    sanitize(input: Record<string, unknown>): Record<string, unknown>;
+    /**
+     * Handle an error and return a structured response
+     */
+    handle(error: Error | string, context?: Partial<ErrorContext>): StructuredError;
+    /**
+     * Wrap a handler with error handling
+     */
+    wrap<T extends (...args: unknown[]) => Promise<unknown>>(handler: T, context: Partial<ErrorContext>): T;
+    /**
+     * Get error statistics
+     */
+    getStats(): {
+        totalErrors: number;
+        byCategory: Record<string, number>;
+        recentErrors: StructuredError[];
+        errorRate: number;
+    };
+    /**
+     * Clear error log
+     */
+    clearLog(): void;
+    private getErrorCode;
+    private getRetryDelay;
+    private sanitizeMessage;
+    private trackError;
+    private logError;
+}
+/**
+ * Wrap a handler with error handling (convenience function)
+ */
+export declare function withErrorHandling<T extends (...args: unknown[]) => Promise<unknown>>(handler: T, context?: Partial<ErrorContext>): T;
+export default ErrorHandler;
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/src/production/error-handler.d.ts.map

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

package/dist/src/production/error-handler.js

@@ -0,0 +1,299 @@
+/**
+ * Production Error Handling
+ *
+ * Provides standardized error handling with:
+ * - Error classification
+ * - Sanitization (no sensitive data leak)
+ * - Structured error responses
+ * - Error aggregation and reporting
+ *
+ * @module @sparkleideas/cli/production/error-handler
+ */
+// ============================================================================
+// Error Classification
+// ============================================================================
+const ERROR_PATTERNS = {
+    validation: [
+        /invalid/i,
+        /required/i,
+        /missing/i,
+        /must be/i,
+        /cannot be/i,
+        /validation/i,
+    ],
+    authentication: [
+        /unauthorized/i,
+        /unauthenticated/i,
+        /not authenticated/i,
+        /invalid token/i,
+        /expired token/i,
+    ],
+    authorization: [
+        /forbidden/i,
+        /permission denied/i,
+        /access denied/i,
+        /not allowed/i,
+    ],
+    not_found: [
+        /not found/i,
+        /does not exist/i,
+        /no such/i,
+        /unknown/i,
+    ],
+    rate_limit: [
+        /rate limit/i,
+        /too many requests/i,
+        /throttled/i,
+    ],
+    timeout: [
+        /timeout/i,
+        /timed out/i,
+        /deadline/i,
+    ],
+    circuit_open: [
+        /circuit open/i,
+        /service unavailable/i,
+        /temporarily unavailable/i,
+    ],
+    external_service: [
+        /ECONNREFUSED/i,
+        /ENOTFOUND/i,
+        /ETIMEDOUT/i,
+        /network/i,
+        /connection/i,
+    ],
+    internal: [
+        /internal/i,
+        /unexpected/i,
+    ],
+    unknown: [],
+};
+const RETRYABLE_CATEGORIES = [
+    'timeout',
+    'external_service',
+    'rate_limit',
+    'circuit_open',
+];
+// Sensitive keys to sanitize
+const SENSITIVE_KEYS = [
+    'password',
+    'token',
+    'api_key',
+    'apiKey',
+    'secret',
+    'authorization',
+    'bearer',
+    'credential',
+    'private',
+];
+// ============================================================================
+// Error Handler
+// ============================================================================
+const DEFAULT_CONFIG = {
+    includeStack: process.env.NODE_ENV !== 'production',
+    sanitize: true,
+    reportToMonitoring: true,
+    maxErrorsPerMinute: 100,
+    errorCategories: {},
+};
+export class ErrorHandler {
+    config;
+    errorCounts = new Map();
+    errorLog = [];
+    maxLogSize = 1000;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Classify an error into a category
+     */
+    classifyError(error) {
+        const message = typeof error === 'string' ? error : error.message;
+        for (const [category, patterns] of Object.entries(ERROR_PATTERNS)) {
+            for (const pattern of patterns) {
+                if (pattern.test(message)) {
+                    return category;
+                }
+            }
+        }
+        return 'unknown';
+    }
+    /**
+     * Check if an error category is retryable
+     */
+    isRetryable(category) {
+        return RETRYABLE_CATEGORIES.includes(category);
+    }
+    /**
+     * Sanitize input to remove sensitive data
+     */
+    sanitize(input) {
+        if (!this.config.sanitize)
+            return input;
+        const sanitized = {};
+        for (const [key, value] of Object.entries(input)) {
+            const lowerKey = key.toLowerCase();
+            const isSensitive = SENSITIVE_KEYS.some(sk => lowerKey.includes(sk.toLowerCase()));
+            if (isSensitive) {
+                sanitized[key] = '[REDACTED]';
+            }
+            else if (typeof value === 'object' && value !== null) {
+                sanitized[key] = this.sanitize(value);
+            }
+            else {
+                sanitized[key] = value;
+            }
+        }
+        return sanitized;
+    }
+    /**
+     * Handle an error and return a structured response
+     */
+    handle(error, context = {}) {
+        const message = typeof error === 'string' ? error : error.message;
+        const category = this.classifyError(error);
+        const retryable = this.isRetryable(category);
+        const now = new Date().toISOString();
+        // Track error counts for rate limiting
+        this.trackError(category);
+        // Build structured error
+        const structured = {
+            success: false,
+            error: {
+                code: this.getErrorCode(category),
+                message: this.sanitizeMessage(message),
+                category,
+                retryable,
+                retryAfterMs: retryable ? this.getRetryDelay(category) : undefined,
+            },
+            context: context.input
+                ? { ...context, input: this.sanitize(context.input) }
+                : context,
+            timestamp: now,
+        };
+        // Include stack trace in non-production
+        if (this.config.includeStack && error instanceof Error && error.stack) {
+            structured.error.details = { stack: error.stack };
+        }
+        // Log error
+        this.logError(structured);
+        return structured;
+    }
+    /**
+     * Wrap a handler with error handling
+     */
+    wrap(handler, context) {
+        return (async (...args) => {
+            try {
+                return await handler(...args);
+            }
+            catch (error) {
+                return this.handle(error, {
+                    ...context,
+                    input: args[0],
+                });
+            }
+        });
+    }
+    /**
+     * Get error statistics
+     */
+    getStats() {
+        const byCategory = {};
+        for (const error of this.errorLog) {
+            const cat = error.error.category;
+            byCategory[cat] = (byCategory[cat] || 0) + 1;
+        }
+        // Calculate error rate (errors per minute in last 5 minutes)
+        const fiveMinutesAgo = Date.now() - 5 * 60 * 1000;
+        const recentCount = this.errorLog.filter(e => new Date(e.timestamp).getTime() > fiveMinutesAgo).length;
+        const errorRate = recentCount / 5;
+        return {
+            totalErrors: this.errorLog.length,
+            byCategory,
+            recentErrors: this.errorLog.slice(-10),
+            errorRate,
+        };
+    }
+    /**
+     * Clear error log
+     */
+    clearLog() {
+        this.errorLog = [];
+        this.errorCounts.clear();
+    }
+    // ============================================================================
+    // Private Methods
+    // ============================================================================
+    getErrorCode(category) {
+        const codes = {
+            validation: 'ERR_VALIDATION',
+            authentication: 'ERR_AUTHENTICATION',
+            authorization: 'ERR_AUTHORIZATION',
+            not_found: 'ERR_NOT_FOUND',
+            rate_limit: 'ERR_RATE_LIMIT',
+            timeout: 'ERR_TIMEOUT',
+            circuit_open: 'ERR_CIRCUIT_OPEN',
+            external_service: 'ERR_EXTERNAL_SERVICE',
+            internal: 'ERR_INTERNAL',
+            unknown: 'ERR_UNKNOWN',
+        };
+        return codes[category];
+    }
+    getRetryDelay(category) {
+        const delays = {
+            timeout: 1000,
+            external_service: 2000,
+            rate_limit: 5000,
+            circuit_open: 30000,
+            validation: 0,
+            authentication: 0,
+            authorization: 0,
+            not_found: 0,
+            internal: 0,
+            unknown: 0,
+        };
+        return delays[category];
+    }
+    sanitizeMessage(message) {
+        if (!this.config.sanitize)
+            return message;
+        // Remove potential sensitive data from message
+        let sanitized = message;
+        for (const key of SENSITIVE_KEYS) {
+            const pattern = new RegExp(`${key}[=:]?\\s*["']?[^\\s"']+["']?`, 'gi');
+            sanitized = sanitized.replace(pattern, `${key}=[REDACTED]`);
+        }
+        return sanitized;
+    }
+    trackError(category) {
+        const now = Date.now();
+        const key = category;
+        const entry = this.errorCounts.get(key);
+        if (!entry || now > entry.resetAt) {
+            this.errorCounts.set(key, { count: 1, resetAt: now + 60000 });
+        }
+        else {
+            entry.count++;
+        }
+    }
+    logError(error) {
+        this.errorLog.push(error);
+        // Trim log if too large
+        if (this.errorLog.length > this.maxLogSize) {
+            this.errorLog = this.errorLog.slice(-this.maxLogSize / 2);
+        }
+    }
+}
+// ============================================================================
+// Convenience Functions
+// ============================================================================
+const defaultHandler = new ErrorHandler();
+/**
+ * Wrap a handler with error handling (convenience function)
+ */
+export function withErrorHandling(handler, context = {}) {
+    return defaultHandler.wrap(handler, context);
+}
+export default ErrorHandler;
+//# sourceMappingURL=error-handler.js.map

package/dist/src/production/error-handler.js.map

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

package/dist/src/production/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * V3 Production Hardening Module
+ *
+ * Provides production-grade utilities:
+ * - Error handling middleware
+ * - Rate limiting
+ * - Retry mechanisms with exponential backoff
+ * - Circuit breaker pattern
+ * - Monitoring and observability hooks
+ *
+ * @module @sparkleideas/cli/production
+ */
+export { ErrorHandler, withErrorHandling } from './error-handler.js';
+export type { ErrorContext, ErrorHandlerConfig } from './error-handler.js';
+export { RateLimiter, createRateLimiter } from './rate-limiter.js';
+export type { RateLimiterConfig, RateLimitResult } from './rate-limiter.js';
+export { withRetry } from './retry.js';
+export type { RetryConfig, RetryResult, RetryStrategy } from './retry.js';
+export { CircuitBreaker } from './circuit-breaker.js';
+export type { CircuitBreakerConfig, CircuitState } from './circuit-breaker.js';
+export { MonitoringHooks, createMonitor } from './monitoring.js';
+export type { MonitorConfig, MetricEvent } from './monitoring.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/production/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/production/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACrE,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACnE,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACjE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/src/production/index.js

@@ -0,0 +1,18 @@
+/**
+ * V3 Production Hardening Module
+ *
+ * Provides production-grade utilities:
+ * - Error handling middleware
+ * - Rate limiting
+ * - Retry mechanisms with exponential backoff
+ * - Circuit breaker pattern
+ * - Monitoring and observability hooks
+ *
+ * @module @sparkleideas/cli/production
+ */
+export { ErrorHandler, withErrorHandling } from './error-handler.js';
+export { RateLimiter, createRateLimiter } from './rate-limiter.js';
+export { withRetry } from './retry.js';
+export { CircuitBreaker } from './circuit-breaker.js';
+export { MonitoringHooks, createMonitor } from './monitoring.js';
+//# sourceMappingURL=index.js.map

package/dist/src/production/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/production/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAErE,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEnE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/src/production/monitoring.d.ts

@@ -0,0 +1,161 @@
+/**
+ * Production Monitoring and Observability
+ *
+ * Provides monitoring hooks for:
+ * - Request/response metrics
+ * - Error tracking
+ * - Performance monitoring
+ * - Health checks
+ * - Alerting
+ *
+ * @module @sparkleideas/cli/production/monitoring
+ */
+export type MetricType = 'counter' | 'gauge' | 'histogram' | 'summary';
+export interface MetricEvent {
+    name: string;
+    type: MetricType;
+    value: number;
+    labels: Record<string, string>;
+    timestamp: number;
+}
+export interface MonitorConfig {
+    enabled: boolean;
+    retentionMs: number;
+    maxMetrics: number;
+    samplingRate: number;
+    alertThresholds: Record<string, {
+        warning: number;
+        critical: number;
+    }>;
+    healthCheckIntervalMs: number;
+    reportingEndpoint?: string;
+    globalLabels: Record<string, string>;
+}
+export interface HealthStatus {
+    healthy: boolean;
+    checks: Record<string, {
+        status: 'healthy' | 'degraded' | 'unhealthy';
+        message?: string;
+        lastCheck: number;
+        responseTimeMs?: number;
+    }>;
+    timestamp: number;
+}
+export interface PerformanceMetrics {
+    requestCount: number;
+    errorCount: number;
+    errorRate: number;
+    avgResponseTimeMs: number;
+    p50ResponseTimeMs: number;
+    p95ResponseTimeMs: number;
+    p99ResponseTimeMs: number;
+    activeRequests: number;
+    uptime: number;
+}
+type AlertLevel = 'info' | 'warning' | 'critical';
+interface Alert {
+    id: string;
+    level: AlertLevel;
+    metric: string;
+    message: string;
+    value: number;
+    threshold: number;
+    timestamp: number;
+    acknowledged: boolean;
+}
+export declare class MonitoringHooks {
+    private config;
+    private metrics;
+    private responseTimes;
+    private alerts;
+    private healthStatus;
+    private startTime;
+    private activeRequests;
+    private requestCount;
+    private errorCount;
+    private healthChecks;
+    constructor(config?: Partial<MonitorConfig>);
+    /**
+     * Record a counter metric
+     */
+    counter(name: string, value?: number, labels?: Record<string, string>): void;
+    /**
+     * Record a gauge metric
+     */
+    gauge(name: string, value: number, labels?: Record<string, string>): void;
+    /**
+     * Record a histogram metric
+     */
+    histogram(name: string, value: number, labels?: Record<string, string>): void;
+    /**
+     * Record a metric event
+     */
+    private recordMetric;
+    /**
+     * Start tracking a request
+     */
+    startRequest(requestId: string): () => void;
+    /**
+     * Record an error
+     */
+    recordError(error: Error, labels?: Record<string, string>): void;
+    /**
+     * Register a health check
+     */
+    registerHealthCheck(name: string, check: () => Promise<{
+        healthy: boolean;
+        message?: string;
+    }>): void;
+    /**
+     * Run all health checks
+     */
+    runHealthChecks(): Promise<HealthStatus>;
+    /**
+     * Get current health status
+     */
+    getHealthStatus(): HealthStatus;
+    /**
+     * Get performance metrics
+     */
+    getPerformanceMetrics(): PerformanceMetrics;
+    /**
+     * Get active alerts
+     */
+    getAlerts(level?: AlertLevel): Alert[];
+    /**
+     * Acknowledge an alert
+     */
+    acknowledgeAlert(alertId: string): boolean;
+    /**
+     * Clear all alerts
+     */
+    clearAlerts(): void;
+    /**
+     * Get metrics for a specific name
+     */
+    getMetrics(name: string, since?: number): MetricEvent[];
+    /**
+     * Get all metrics summary
+     */
+    getMetricsSummary(): Record<string, {
+        count: number;
+        lastValue: number;
+        avgValue: number;
+    }>;
+    /**
+     * Reset all metrics
+     */
+    reset(): void;
+    private checkAlerts;
+    private cleanupMetrics;
+}
+/**
+ * Create or get the default monitor
+ */
+export declare function createMonitor(config?: Partial<MonitorConfig>): MonitoringHooks;
+/**
+ * Get the default monitor
+ */
+export declare function getMonitor(): MonitoringHooks;
+export default MonitoringHooks;
+//# sourceMappingURL=monitoring.d.ts.map

package/dist/src/production/monitoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitoring.d.ts","sourceRoot":"","sources":["../../../src/production/monitoring.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,SAAS,CAAC;AAEvE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAE5B,OAAO,EAAE,OAAO,CAAC;IAEjB,WAAW,EAAE,MAAM,CAAC;IAEpB,UAAU,EAAE,MAAM,CAAC;IAEnB,YAAY,EAAE,MAAM,CAAC;IAErB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAEvE,qBAAqB,EAAE,MAAM,CAAC;IAE9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QACrB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;QAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC,CAAC;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,KAAK,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;AAElD,UAAU,KAAK;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;CACvB;AAwBD,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,YAAY,CAAiF;gBAEzF,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM;IAa/C;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,IAAI;IAInF;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,IAAI;IAI7E;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,IAAI;IAIjF;;OAEG;IACH,OAAO,CAAC,YAAY;IAgCpB;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,IAAI;IAqB3C;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,IAAI;IAapE;;OAEG;IACH,mBAAmB,CACjB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAC3D,IAAI;IAIP;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,YAAY,CAAC;IAmC9C;;OAEG;IACH,eAAe,IAAI,YAAY;IAQ/B;;OAEG;IACH,qBAAqB,IAAI,kBAAkB;IA+B3C;;OAEG;IACH,SAAS,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,KAAK,EAAE;IAQtC;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAS1C;;OAEG;IACH,WAAW,IAAI,IAAI;IAQnB;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE;IAQvD;;OAEG;IACH,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAwB3F;;OAEG;IACH,KAAK,IAAI,IAAI;IAcb,OAAO,CAAC,WAAW;IAsCnB,OAAO,CAAC,cAAc;CAiBvB;AAQD;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,eAAe,CAK9E;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,eAAe,CAE5C;AAED,eAAe,eAAe,CAAC"}