@stackmemoryai/stackmemory 0.2.4 → 0.2.7

package/dist/src/core/errors/index.js.map

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

package/dist/src/core/errors/recovery.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Error recovery utilities for StackMemory
+ * Provides retry logic, circuit breakers, and fallback mechanisms
+ */
+import { ErrorContext } from './index.js';
+export interface RetryOptions {
+    maxAttempts?: number;
+    initialDelay?: number;
+    maxDelay?: number;
+    backoffFactor?: number;
+    timeout?: number;
+    onRetry?: (attempt: number, error: unknown) => void;
+}
+export interface CircuitBreakerOptions {
+    failureThreshold?: number;
+    resetTimeout?: number;
+    halfOpenRequests?: number;
+}
+export declare enum CircuitState {
+    CLOSED = "closed",
+    OPEN = "open",
+    HALF_OPEN = "half_open"
+}
+/**
+ * Exponential backoff with jitter
+ */
+export declare function calculateBackoff(attempt: number, initialDelay: number, maxDelay: number, factor: number): number;
+/**
+ * Retry with exponential backoff
+ */
+export declare function retry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+/**
+ * Circuit breaker implementation
+ */
+export declare class CircuitBreaker<T> {
+    private readonly name;
+    private state;
+    private failures;
+    private successCount;
+    private lastFailTime?;
+    private readonly options;
+    constructor(name: string, options?: CircuitBreakerOptions);
+    execute<R = T>(fn: () => Promise<R>): Promise<R>;
+    private handleFailure;
+    getState(): CircuitState;
+    reset(): void;
+}
+/**
+ * Fallback with multiple strategies
+ */
+export declare function withFallback<T>(primary: () => Promise<T>, fallbacks: Array<() => Promise<T>>, context?: ErrorContext): Promise<T>;
+/**
+ * Bulkhead pattern - limit concurrent operations
+ */
+export declare class Bulkhead {
+    private readonly name;
+    private readonly maxConcurrent;
+    private running;
+    private queue;
+    constructor(name: string, maxConcurrent: number);
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    getStats(): {
+        running: number;
+        queued: number;
+        maxConcurrent: number;
+    };
+}
+/**
+ * Timeout wrapper with proper cleanup
+ */
+export declare function withTimeout<T>(fn: () => Promise<T>, timeoutMs: number, timeoutMessage?: string): Promise<T>;
+/**
+ * Graceful degradation helper
+ */
+export declare function gracefulDegrade<T, F>(fn: () => Promise<T>, defaultValue: F, logContext?: ErrorContext): Promise<T | F>;
+/**
+ * Create a resilient operation with multiple recovery strategies
+ */
+export declare function createResilientOperation<T>(name: string, options?: {
+    retry?: RetryOptions;
+    circuitBreaker?: CircuitBreakerOptions;
+    bulkhead?: number;
+    timeout?: number;
+    fallback?: () => Promise<T>;
+}): (fn: () => Promise<T>) => Promise<T>;
+//# sourceMappingURL=recovery.d.ts.map

package/dist/src/core/errors/recovery.d.ts.map

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

package/dist/src/core/errors/recovery.js

@@ -0,0 +1,274 @@
+/**
+ * Error recovery utilities for StackMemory
+ * Provides retry logic, circuit breakers, and fallback mechanisms
+ */
+import { logger } from '../monitoring/logger.js';
+import { isRetryableError, getErrorMessage, } from './index.js';
+export var CircuitState;
+(function (CircuitState) {
+    CircuitState["CLOSED"] = "closed";
+    CircuitState["OPEN"] = "open";
+    CircuitState["HALF_OPEN"] = "half_open";
+})(CircuitState || (CircuitState = {}));
+/**
+ * Exponential backoff with jitter
+ */
+export function calculateBackoff(attempt, initialDelay, maxDelay, factor) {
+    const exponentialDelay = Math.min(initialDelay * Math.pow(factor, attempt - 1), maxDelay);
+    // Add jitter (0-25% of delay)
+    const jitter = exponentialDelay * Math.random() * 0.25;
+    return Math.floor(exponentialDelay + jitter);
+}
+/**
+ * Retry with exponential backoff
+ */
+export async function retry(fn, options = {}) {
+    const { maxAttempts = 3, initialDelay = 1000, maxDelay = 30000, backoffFactor = 2, timeout, onRetry, } = options;
+    let lastError;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        try {
+            // Add timeout if specified
+            if (timeout) {
+                return await Promise.race([
+                    fn(),
+                    new Promise((_, reject) => setTimeout(() => reject(new Error(`Operation timed out after ${timeout}ms`)), timeout)),
+                ]);
+            }
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            // Don't retry if not retryable or last attempt
+            if (!isRetryableError(error) || attempt === maxAttempts) {
+                throw error;
+            }
+            const delay = calculateBackoff(attempt, initialDelay, maxDelay, backoffFactor);
+            logger.warn(`Retry attempt ${attempt}/${maxAttempts} after ${delay}ms`, {
+                error: getErrorMessage(error),
+                attempt,
+                delay,
+            });
+            if (onRetry) {
+                onRetry(attempt, error);
+            }
+            await new Promise((resolve) => setTimeout(resolve, delay));
+        }
+    }
+    throw lastError;
+}
+/**
+ * Circuit breaker implementation
+ */
+export class CircuitBreaker {
+    name;
+    state = CircuitState.CLOSED;
+    failures = 0;
+    successCount = 0;
+    lastFailTime;
+    options;
+    constructor(name, options = {}) {
+        this.name = name;
+        this.options = {
+            failureThreshold: options.failureThreshold ?? 5,
+            resetTimeout: options.resetTimeout ?? 60000,
+            halfOpenRequests: options.halfOpenRequests ?? 3,
+        };
+    }
+    async execute(fn) {
+        // Check if circuit should transition from OPEN to HALF_OPEN
+        if (this.state === CircuitState.OPEN) {
+            const timeSinceLastFailure = this.lastFailTime
+                ? Date.now() - this.lastFailTime.getTime()
+                : 0;
+            if (timeSinceLastFailure >= this.options.resetTimeout) {
+                this.state = CircuitState.HALF_OPEN;
+                this.successCount = 0;
+                logger.info(`Circuit breaker ${this.name} entering half-open state`);
+            }
+            else {
+                throw new Error(`Circuit breaker ${this.name} is OPEN. Retry after ${this.options.resetTimeout - timeSinceLastFailure}ms`);
+            }
+        }
+        try {
+            const result = await fn();
+            // Handle success
+            if (this.state === CircuitState.HALF_OPEN) {
+                this.successCount++;
+                if (this.successCount >= this.options.halfOpenRequests) {
+                    this.state = CircuitState.CLOSED;
+                    this.failures = 0;
+                    logger.info(`Circuit breaker ${this.name} is now CLOSED`);
+                }
+            }
+            else {
+                this.failures = 0;
+            }
+            return result;
+        }
+        catch (error) {
+            this.handleFailure(error);
+            throw error;
+        }
+    }
+    handleFailure(error) {
+        this.failures++;
+        this.lastFailTime = new Date();
+        if (this.state === CircuitState.HALF_OPEN) {
+            this.state = CircuitState.OPEN;
+            logger.error(`Circuit breaker ${this.name} reopened due to failure in half-open state`);
+        }
+        else if (this.state === CircuitState.CLOSED &&
+            this.failures >= this.options.failureThreshold) {
+            this.state = CircuitState.OPEN;
+            logger.error(`Circuit breaker ${this.name} opened after ${this.failures} failures`);
+        }
+    }
+    getState() {
+        return this.state;
+    }
+    reset() {
+        this.state = CircuitState.CLOSED;
+        this.failures = 0;
+        this.successCount = 0;
+        this.lastFailTime = undefined;
+        logger.info(`Circuit breaker ${this.name} manually reset`);
+    }
+}
+/**
+ * Fallback with multiple strategies
+ */
+export async function withFallback(primary, fallbacks, context) {
+    const errors = [];
+    // Try primary
+    try {
+        return await primary();
+    }
+    catch (error) {
+        errors.push(error);
+        logger.warn('Primary operation failed, trying fallbacks', {
+            error: getErrorMessage(error),
+            context,
+        });
+    }
+    // Try fallbacks in order
+    for (let i = 0; i < fallbacks.length; i++) {
+        try {
+            const result = await fallbacks[i]();
+            logger.info(`Fallback ${i + 1} succeeded`, { context });
+            return result;
+        }
+        catch (error) {
+            errors.push(error);
+            if (i < fallbacks.length - 1) {
+                logger.warn(`Fallback ${i + 1} failed, trying next`, {
+                    error: getErrorMessage(error),
+                    context,
+                });
+            }
+        }
+    }
+    // All attempts failed
+    throw new Error(`All attempts failed. Errors: ${errors.map(getErrorMessage).join(', ')}`);
+}
+/**
+ * Bulkhead pattern - limit concurrent operations
+ */
+export class Bulkhead {
+    name;
+    maxConcurrent;
+    running = 0;
+    queue = [];
+    constructor(name, maxConcurrent) {
+        this.name = name;
+        this.maxConcurrent = maxConcurrent;
+    }
+    async execute(fn) {
+        if (this.running >= this.maxConcurrent) {
+            await new Promise((resolve) => {
+                this.queue.push(resolve);
+            });
+        }
+        this.running++;
+        try {
+            return await fn();
+        }
+        finally {
+            this.running--;
+            const next = this.queue.shift();
+            if (next) {
+                next();
+            }
+        }
+    }
+    getStats() {
+        return {
+            running: this.running,
+            queued: this.queue.length,
+            maxConcurrent: this.maxConcurrent,
+        };
+    }
+}
+/**
+ * Timeout wrapper with proper cleanup
+ */
+export async function withTimeout(fn, timeoutMs, timeoutMessage) {
+    return Promise.race([
+        fn(),
+        new Promise((_, reject) => setTimeout(() => reject(new Error(timeoutMessage ?? `Operation timed out after ${timeoutMs}ms`)), timeoutMs)),
+    ]);
+}
+/**
+ * Graceful degradation helper
+ */
+export async function gracefulDegrade(fn, defaultValue, logContext) {
+    try {
+        return await fn();
+    }
+    catch (error) {
+        logger.warn('Operation failed, using default value', {
+            error: getErrorMessage(error),
+            ...logContext,
+        });
+        return defaultValue;
+    }
+}
+/**
+ * Create a resilient operation with multiple recovery strategies
+ */
+export function createResilientOperation(name, options = {}) {
+    const circuitBreaker = options.circuitBreaker
+        ? new CircuitBreaker(name, options.circuitBreaker)
+        : null;
+    const bulkhead = options.bulkhead
+        ? new Bulkhead(name, options.bulkhead)
+        : null;
+    return async (fn) => {
+        let currentFn = fn;
+        // Wrap with bulkhead if configured
+        if (bulkhead) {
+            const wrapped = currentFn;
+            currentFn = () => bulkhead.execute(wrapped);
+        }
+        // Wrap with timeout if configured
+        if (options.timeout) {
+            const wrapped = currentFn;
+            currentFn = () => withTimeout(wrapped, options.timeout);
+        }
+        // Wrap with retry if configured
+        if (options.retry) {
+            const wrapped = currentFn;
+            currentFn = () => retry(wrapped, options.retry);
+        }
+        // Wrap with circuit breaker if configured
+        if (circuitBreaker) {
+            const wrapped = currentFn;
+            currentFn = () => circuitBreaker.execute(wrapped);
+        }
+        // Execute with fallback if configured
+        if (options.fallback) {
+            return withFallback(currentFn, [options.fallback]);
+        }
+        return currentFn();
+    };
+}
+//# sourceMappingURL=recovery.js.map

package/dist/src/core/errors/recovery.js.map

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

package/dist/src/core/logger.test.js

@@ -1,5 +1,5 @@
 import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
-import { logger, LogLevel } from './logger.js';
+import { logger, LogLevel } from './monitoring/logger.js';
 describe('Logger', () => {
     let consoleSpy;
     beforeEach(() => {

package/dist/src/core/logger.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.test.js","sourceRoot":"","sources":["../../../src/core/logger.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE/C,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;IACtB,IAAI,UAAuC,CAAC;IAE5C,UAAU,CAAC,GAAG,EAAE;QACd,UAAU,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,UAAU,CAAC,WAAW,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC5B,MAAM,CAAC,UAAU,CAAC,CAAC,gBAAgB,EAAE,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC7C,MAAM,CAAC,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,CAAC,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,CAAC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"logger.test.js","sourceRoot":"","sources":["../../../src/core/logger.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAE1D,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;IACtB,IAAI,UAAuC,CAAC;IAE5C,UAAU,CAAC,GAAG,EAAE;QACd,UAAU,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,UAAU,CAAC,WAAW,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC5B,MAAM,CAAC,UAAU,CAAC,CAAC,gBAAgB,EAAE,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC7C,MAAM,CAAC,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,CAAC,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,CAAC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/core/monitoring/error-handler.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Comprehensive error handling for StackMemory CLI
+ */
+export declare enum ErrorCode {
+    AUTH_FAILED = "AUTH_FAILED",
+    TOKEN_EXPIRED = "TOKEN_EXPIRED",
+    INVALID_CREDENTIALS = "INVALID_CREDENTIALS",
+    FILE_NOT_FOUND = "FILE_NOT_FOUND",
+    PERMISSION_DENIED = "PERMISSION_DENIED",
+    DISK_FULL = "DISK_FULL",
+    NOT_GIT_REPO = "NOT_GIT_REPO",
+    GIT_COMMAND_FAILED = "GIT_COMMAND_FAILED",
+    INVALID_BRANCH = "INVALID_BRANCH",
+    DB_CONNECTION_FAILED = "DB_CONNECTION_FAILED",
+    DB_QUERY_FAILED = "DB_QUERY_FAILED",
+    DB_CORRUPTION = "DB_CORRUPTION",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    API_ERROR = "API_ERROR",
+    TIMEOUT = "TIMEOUT",
+    INVALID_INPUT = "INVALID_INPUT",
+    VALIDATION_FAILED = "VALIDATION_FAILED",
+    UNKNOWN_ERROR = "UNKNOWN_ERROR",
+    OPERATION_FAILED = "OPERATION_FAILED",
+    CONFIGURATION_ERROR = "CONFIGURATION_ERROR"
+}
+export declare class StackMemoryError extends Error {
+    readonly code: ErrorCode;
+    readonly context: Record<string, unknown>;
+    readonly userMessage: string;
+    readonly recoverable: boolean;
+    constructor(code: ErrorCode, message: string, userMessage?: string, context?: Record<string, unknown>, recoverable?: boolean, cause?: Error);
+    private getDefaultUserMessage;
+    static fromNodeError(nodeError: NodeJS.ErrnoException, context?: Record<string, unknown>): StackMemoryError;
+}
+export declare class ErrorHandler {
+    private static retryMap;
+    private static readonly MAX_RETRIES;
+    static handle(error: unknown, operation: string): never;
+    static safeExecute<T>(operation: () => Promise<T> | T, operationName: string, fallback?: T): Promise<T | undefined>;
+    static withRetry<T>(operation: () => Promise<T> | T, operationName: string, maxRetries?: number): Promise<T>;
+    static createCircuitBreaker<T>(operation: () => Promise<T> | T, operationName: string, threshold?: number): () => Promise<T>;
+}
+export declare const validateInput: (value: unknown, name: string, validator: (val: unknown) => boolean) => asserts value is NonNullable<unknown>;
+export declare const validateEmail: (email: string) => asserts email is string;
+export declare const validatePath: (filePath: string) => asserts filePath is string;
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/src/core/monitoring/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../../../src/core/monitoring/error-handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,oBAAY,SAAS;IAEnB,WAAW,gBAAgB;IAC3B,aAAa,kBAAkB;IAC/B,mBAAmB,wBAAwB;IAG3C,cAAc,mBAAmB;IACjC,iBAAiB,sBAAsB;IACvC,SAAS,cAAc;IAGvB,YAAY,iBAAiB;IAC7B,kBAAkB,uBAAuB;IACzC,cAAc,mBAAmB;IAGjC,oBAAoB,yBAAyB;IAC7C,eAAe,oBAAoB;IACnC,aAAa,kBAAkB;IAG/B,aAAa,kBAAkB;IAC/B,SAAS,cAAc;IACvB,OAAO,YAAY;IAGnB,aAAa,kBAAkB;IAC/B,iBAAiB,sBAAsB;IAGvC,aAAa,kBAAkB;IAC/B,gBAAgB,qBAAqB;IACrC,mBAAmB,wBAAwB;CAC5C;AAED,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,SAAgB,IAAI,EAAE,SAAS,CAAC;IAChC,SAAgB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjD,SAAgB,WAAW,EAAE,MAAM,CAAC;IACpC,SAAgB,WAAW,EAAE,OAAO,CAAC;gBAGnC,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACrC,WAAW,GAAE,OAAe,EAC5B,KAAK,CAAC,EAAE,KAAK;IAsBf,OAAO,CAAC,qBAAqB;IAqB7B,MAAM,CAAC,aAAa,CAClB,SAAS,EAAE,MAAM,CAAC,cAAc,EAChC,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACpC,gBAAgB;CAwDpB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA6B;IACpD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAK;IAExC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK;WAqD1C,WAAW,CAAC,CAAC,EACxB,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EAC/B,aAAa,EAAE,MAAM,EACrB,QAAQ,CAAC,EAAE,CAAC,GACX,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;WAeZ,SAAS,CAAC,CAAC,EACtB,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EAC/B,aAAa,EAAE,MAAM,EACrB,UAAU,GAAE,MAAiC,GAC5C,OAAO,CAAC,CAAC,CAAC;IAuCb,MAAM,CAAC,oBAAoB,CAAC,CAAC,EAC3B,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EAC/B,aAAa,EAAE,MAAM,EACrB,SAAS,GAAE,MAAU,SAMJ,OAAO,CAAC,CAAC,CAAC;CA8B9B;AAGD,eAAO,MAAM,aAAa,GACxB,OAAO,OAAO,EACd,MAAM,MAAM,EACZ,WAAW,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,KACnC,QAAQ,KAAK,IAAI,WAAW,CAAC,OAAO,CAUtC,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,KAAG,QAAQ,KAAK,IAAI,MAW9D,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,UAAU,MAAM,KAAG,QAAQ,QAAQ,IAAI,MAUnE,CAAC"}