@claude-flow/shared 3.0.0-alpha.1

package/dist/resilience/bulkhead.js

@@ -0,0 +1,206 @@
+/**
+ * Bulkhead Pattern
+ *
+ * Isolates failures by limiting concurrent executions.
+ *
+ * @module v3/shared/resilience/bulkhead
+ */
+import { EventEmitter } from 'events';
+/**
+ * Default options
+ */
+const DEFAULT_OPTIONS = {
+    maxConcurrent: 10,
+    maxQueue: 100,
+    queueTimeout: 30000,
+};
+/**
+ * Bulkhead
+ *
+ * Limits concurrent executions to prevent resource exhaustion.
+ *
+ * @example
+ * const bulkhead = new Bulkhead({
+ *   name: 'database',
+ *   maxConcurrent: 10,
+ *   maxQueue: 50,
+ * });
+ *
+ * try {
+ *   const result = await bulkhead.execute(() => dbQuery());
+ * } catch (error) {
+ *   if (error.message.includes('Bulkhead full')) {
+ *     // Handle capacity exceeded
+ *   }
+ * }
+ */
+export class Bulkhead extends EventEmitter {
+    options;
+    active = 0;
+    queue = [];
+    completed = 0;
+    rejected = 0;
+    timedOut = 0;
+    constructor(options) {
+        super();
+        this.options = { ...DEFAULT_OPTIONS, ...options };
+    }
+    /**
+     * Execute a function within the bulkhead
+     */
+    async execute(fn) {
+        // If there's room for execution, run immediately
+        if (this.active < this.options.maxConcurrent) {
+            return this.runNow(fn);
+        }
+        // Check if queue is full
+        if (this.queue.length >= this.options.maxQueue) {
+            this.rejected++;
+            this.options.onRejected?.('full');
+            throw new Error(`Bulkhead '${this.options.name}' is full. Max concurrent: ${this.options.maxConcurrent}, queue: ${this.options.maxQueue}`);
+        }
+        // Add to queue
+        return this.addToQueue(fn);
+    }
+    /**
+     * Get current statistics
+     */
+    getStats() {
+        return {
+            active: this.active,
+            queued: this.queue.length,
+            maxConcurrent: this.options.maxConcurrent,
+            maxQueue: this.options.maxQueue,
+            completed: this.completed,
+            rejected: this.rejected,
+            timedOut: this.timedOut,
+        };
+    }
+    /**
+     * Check if there's capacity available
+     */
+    hasCapacity() {
+        return this.active < this.options.maxConcurrent || this.queue.length < this.options.maxQueue;
+    }
+    /**
+     * Get available capacity (concurrent + queue)
+     */
+    availableCapacity() {
+        const concurrentAvailable = this.options.maxConcurrent - this.active;
+        const queueAvailable = this.options.maxQueue - this.queue.length;
+        return concurrentAvailable + queueAvailable;
+    }
+    /**
+     * Reset statistics
+     */
+    resetStats() {
+        this.completed = 0;
+        this.rejected = 0;
+        this.timedOut = 0;
+    }
+    /**
+     * Run function immediately
+     */
+    async runNow(fn) {
+        this.active++;
+        this.emit('acquire');
+        try {
+            const result = await fn();
+            this.completed++;
+            return result;
+        }
+        finally {
+            this.active--;
+            this.emit('release');
+            this.processQueue();
+        }
+    }
+    /**
+     * Add function to queue
+     */
+    addToQueue(fn) {
+        return new Promise((resolve, reject) => {
+            const item = {
+                fn,
+                resolve,
+                reject,
+                queuedAt: Date.now(),
+            };
+            // Set timeout for queued item
+            item.timeoutId = setTimeout(() => {
+                const index = this.queue.indexOf(item);
+                if (index !== -1) {
+                    this.queue.splice(index, 1);
+                    this.timedOut++;
+                    this.options.onRejected?.('timeout');
+                    reject(new Error(`Bulkhead '${this.options.name}' queue timeout after ${this.options.queueTimeout}ms`));
+                }
+            }, this.options.queueTimeout);
+            this.queue.push(item);
+            this.emit('queued', { queueLength: this.queue.length });
+        });
+    }
+    /**
+     * Process next item in queue
+     */
+    processQueue() {
+        if (this.active >= this.options.maxConcurrent) {
+            return;
+        }
+        const item = this.queue.shift();
+        if (!item) {
+            return;
+        }
+        // Clear timeout
+        if (item.timeoutId) {
+            clearTimeout(item.timeoutId);
+        }
+        // Execute the queued function
+        this.active++;
+        this.emit('acquire');
+        item.fn()
+            .then((result) => {
+            this.completed++;
+            item.resolve(result);
+        })
+            .catch((error) => {
+            item.reject(error);
+        })
+            .finally(() => {
+            this.active--;
+            this.emit('release');
+            this.processQueue();
+        });
+    }
+}
+/**
+ * Create a semaphore for limiting concurrent access
+ */
+export function createSemaphore(maxConcurrent) {
+    let current = 0;
+    const waiting = [];
+    return {
+        async acquire() {
+            if (current < maxConcurrent) {
+                current++;
+                return;
+            }
+            return new Promise((resolve) => {
+                waiting.push(resolve);
+            });
+        },
+        release() {
+            const next = waiting.shift();
+            if (next) {
+                next();
+            }
+            else {
+                current = Math.max(0, current - 1);
+            }
+        },
+        available() {
+            return maxConcurrent - current;
+        },
+    };
+}
+//# sourceMappingURL=bulkhead.js.map

package/dist/resilience/bulkhead.js.map

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

package/dist/resilience/circuit-breaker.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Circuit Breaker Pattern
+ *
+ * Prevents cascading failures by breaking the circuit after failures.
+ *
+ * @module v3/shared/resilience/circuit-breaker
+ */
+import { EventEmitter } from 'events';
+/**
+ * Circuit breaker states
+ */
+export declare enum CircuitBreakerState {
+    /** Circuit is closed, requests flow normally */
+    CLOSED = "CLOSED",
+    /** Circuit is open, requests are rejected immediately */
+    OPEN = "OPEN",
+    /** Circuit is testing if service recovered */
+    HALF_OPEN = "HALF_OPEN"
+}
+/**
+ * Circuit breaker options
+ */
+export interface CircuitBreakerOptions {
+    /** Name for identification */
+    name: string;
+    /** Failure threshold before opening circuit (default: 5) */
+    failureThreshold: number;
+    /** Success threshold in half-open state to close circuit (default: 3) */
+    successThreshold: number;
+    /** Time to wait before testing again in ms (default: 30000) */
+    timeout: number;
+    /** Time window to track failures in ms (default: 60000) */
+    rollingWindow: number;
+    /** Volume threshold - minimum requests before tripping (default: 10) */
+    volumeThreshold: number;
+    /** Custom failure detection */
+    isFailure?: (error: Error) => boolean;
+    /** Fallback function when circuit is open */
+    fallback?: <T>(error: Error) => T | Promise<T>;
+    /** Callback when state changes */
+    onStateChange?: (from: CircuitBreakerState, to: CircuitBreakerState) => void;
+}
+/**
+ * Circuit breaker statistics
+ */
+export interface CircuitBreakerStats {
+    state: CircuitBreakerState;
+    failures: number;
+    successes: number;
+    totalRequests: number;
+    rejectedRequests: number;
+    lastFailure: Date | null;
+    lastSuccess: Date | null;
+    openSince: Date | null;
+}
+/**
+ * Circuit Breaker
+ *
+ * Implements the circuit breaker pattern to prevent cascading failures.
+ *
+ * @example
+ * const breaker = new CircuitBreaker({
+ *   name: 'external-api',
+ *   failureThreshold: 5,
+ *   timeout: 30000,
+ * });
+ *
+ * try {
+ *   const result = await breaker.execute(() => fetchExternalAPI());
+ * } catch (error) {
+ *   if (error.message === 'Circuit is open') {
+ *     // Handle circuit open case
+ *   }
+ * }
+ */
+export declare class CircuitBreaker extends EventEmitter {
+    private readonly options;
+    private state;
+    private requests;
+    private halfOpenSuccesses;
+    private openedAt;
+    private lastFailure;
+    private lastSuccess;
+    private rejectedCount;
+    private timeoutId?;
+    constructor(options: CircuitBreakerOptions);
+    /**
+     * Execute a function through the circuit breaker
+     */
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Get current state
+     */
+    getState(): CircuitBreakerState;
+    /**
+     * Get statistics
+     */
+    getStats(): CircuitBreakerStats;
+    /**
+     * Force reset the circuit breaker
+     */
+    reset(): void;
+    /**
+     * Handle successful request
+     */
+    private onSuccess;
+    /**
+     * Handle failed request
+     */
+    private onFailure;
+    /**
+     * Check if state should change based on timeout
+     */
+    private checkState;
+    /**
+     * Transition to new state
+     */
+    private transitionTo;
+    /**
+     * Schedule transition to half-open
+     */
+    private scheduleHalfOpen;
+    /**
+     * Notify state change
+     */
+    private notifyStateChange;
+    /**
+     * Clean old requests outside rolling window
+     */
+    private cleanOldRequests;
+}
+//# sourceMappingURL=circuit-breaker.d.ts.map

package/dist/resilience/circuit-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../src/resilience/circuit-breaker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC;;GAEG;AACH,oBAAY,mBAAmB;IAC7B,gDAAgD;IAChD,MAAM,WAAW;IAEjB,yDAAyD;IACzD,IAAI,SAAS;IAEb,8CAA8C;IAC9C,SAAS,cAAc;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IAEb,4DAA4D;IAC5D,gBAAgB,EAAE,MAAM,CAAC;IAEzB,yEAAyE;IACzE,gBAAgB,EAAE,MAAM,CAAC;IAEzB,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;IAEhB,2DAA2D;IAC3D,aAAa,EAAE,MAAM,CAAC;IAEtB,wEAAwE;IACxE,eAAe,EAAE,MAAM,CAAC;IAExB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC;IAEtC,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAE/C,kCAAkC;IAClC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,EAAE,EAAE,EAAE,mBAAmB,KAAK,IAAI,CAAC;CAC9E;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,mBAAmB,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;CACxB;AAqBD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,KAAK,CAAmD;IAChE,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,SAAS,CAAC,CAAgC;gBAEtC,OAAO,EAAE,qBAAqB;IAK1C;;OAEG;IACG,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAqClD;;OAEG;IACH,QAAQ,IAAI,mBAAmB;IAK/B;;OAEG;IACH,QAAQ,IAAI,mBAAmB;IAe/B;;OAEG;IACH,KAAK,IAAI,IAAI;IAiBb;;OAEG;IACH,OAAO,CAAC,SAAS;IAcjB;;OAEG;IACH,OAAO,CAAC,SAAS;IAuBjB;;OAEG;IACH,OAAO,CAAC,UAAU;IAUlB;;OAEG;IACH,OAAO,CAAC,YAAY;IAyBpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAIzB"}

package/dist/resilience/circuit-breaker.js

@@ -0,0 +1,233 @@
+/**
+ * Circuit Breaker Pattern
+ *
+ * Prevents cascading failures by breaking the circuit after failures.
+ *
+ * @module v3/shared/resilience/circuit-breaker
+ */
+import { EventEmitter } from 'events';
+/**
+ * Circuit breaker states
+ */
+export var CircuitBreakerState;
+(function (CircuitBreakerState) {
+    /** Circuit is closed, requests flow normally */
+    CircuitBreakerState["CLOSED"] = "CLOSED";
+    /** Circuit is open, requests are rejected immediately */
+    CircuitBreakerState["OPEN"] = "OPEN";
+    /** Circuit is testing if service recovered */
+    CircuitBreakerState["HALF_OPEN"] = "HALF_OPEN";
+})(CircuitBreakerState || (CircuitBreakerState = {}));
+/**
+ * Default options
+ */
+const DEFAULT_OPTIONS = {
+    failureThreshold: 5,
+    successThreshold: 3,
+    timeout: 30000,
+    rollingWindow: 60000,
+    volumeThreshold: 10,
+};
+/**
+ * Circuit Breaker
+ *
+ * Implements the circuit breaker pattern to prevent cascading failures.
+ *
+ * @example
+ * const breaker = new CircuitBreaker({
+ *   name: 'external-api',
+ *   failureThreshold: 5,
+ *   timeout: 30000,
+ * });
+ *
+ * try {
+ *   const result = await breaker.execute(() => fetchExternalAPI());
+ * } catch (error) {
+ *   if (error.message === 'Circuit is open') {
+ *     // Handle circuit open case
+ *   }
+ * }
+ */
+export class CircuitBreaker extends EventEmitter {
+    options;
+    state = CircuitBreakerState.CLOSED;
+    requests = [];
+    halfOpenSuccesses = 0;
+    openedAt = null;
+    lastFailure = null;
+    lastSuccess = null;
+    rejectedCount = 0;
+    timeoutId;
+    constructor(options) {
+        super();
+        this.options = { ...DEFAULT_OPTIONS, ...options };
+    }
+    /**
+     * Execute a function through the circuit breaker
+     */
+    async execute(fn) {
+        // Clean up old requests
+        this.cleanOldRequests();
+        // Check if circuit should be tested
+        this.checkState();
+        // If open, reject immediately or use fallback
+        if (this.state === CircuitBreakerState.OPEN) {
+            this.rejectedCount++;
+            const error = new Error(`Circuit breaker '${this.options.name}' is open`);
+            if (this.options.fallback) {
+                return this.options.fallback(error);
+            }
+            throw error;
+        }
+        try {
+            const result = await fn();
+            this.onSuccess();
+            return result;
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            // Check if this should be counted as failure
+            const isFailure = this.options.isFailure?.(err) ?? true;
+            if (isFailure) {
+                this.onFailure(err);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Get current state
+     */
+    getState() {
+        this.checkState();
+        return this.state;
+    }
+    /**
+     * Get statistics
+     */
+    getStats() {
+        this.cleanOldRequests();
+        return {
+            state: this.state,
+            failures: this.requests.filter((r) => !r.success).length,
+            successes: this.requests.filter((r) => r.success).length,
+            totalRequests: this.requests.length,
+            rejectedRequests: this.rejectedCount,
+            lastFailure: this.lastFailure,
+            lastSuccess: this.lastSuccess,
+            openSince: this.openedAt,
+        };
+    }
+    /**
+     * Force reset the circuit breaker
+     */
+    reset() {
+        const previousState = this.state;
+        this.state = CircuitBreakerState.CLOSED;
+        this.requests = [];
+        this.halfOpenSuccesses = 0;
+        this.openedAt = null;
+        if (this.timeoutId) {
+            clearTimeout(this.timeoutId);
+            this.timeoutId = undefined;
+        }
+        if (previousState !== this.state) {
+            this.notifyStateChange(previousState, this.state);
+        }
+    }
+    /**
+     * Handle successful request
+     */
+    onSuccess() {
+        this.lastSuccess = new Date();
+        this.requests.push({ timestamp: Date.now(), success: true });
+        if (this.state === CircuitBreakerState.HALF_OPEN) {
+            this.halfOpenSuccesses++;
+            if (this.halfOpenSuccesses >= this.options.successThreshold) {
+                this.transitionTo(CircuitBreakerState.CLOSED);
+                this.halfOpenSuccesses = 0;
+            }
+        }
+    }
+    /**
+     * Handle failed request
+     */
+    onFailure(error) {
+        this.lastFailure = new Date();
+        this.requests.push({ timestamp: Date.now(), success: false });
+        if (this.state === CircuitBreakerState.HALF_OPEN) {
+            // Failed during half-open, go back to open
+            this.transitionTo(CircuitBreakerState.OPEN);
+            this.halfOpenSuccesses = 0;
+            return;
+        }
+        // Check if we should open the circuit
+        const failures = this.requests.filter((r) => !r.success).length;
+        const totalRequests = this.requests.length;
+        if (totalRequests >= this.options.volumeThreshold &&
+            failures >= this.options.failureThreshold) {
+            this.transitionTo(CircuitBreakerState.OPEN);
+        }
+    }
+    /**
+     * Check if state should change based on timeout
+     */
+    checkState() {
+        if (this.state === CircuitBreakerState.OPEN && this.openedAt) {
+            const elapsed = Date.now() - this.openedAt.getTime();
+            if (elapsed >= this.options.timeout) {
+                this.transitionTo(CircuitBreakerState.HALF_OPEN);
+            }
+        }
+    }
+    /**
+     * Transition to new state
+     */
+    transitionTo(newState) {
+        const previousState = this.state;
+        if (previousState === newState) {
+            return;
+        }
+        this.state = newState;
+        if (newState === CircuitBreakerState.OPEN) {
+            this.openedAt = new Date();
+            this.scheduleHalfOpen();
+        }
+        else if (newState === CircuitBreakerState.CLOSED) {
+            this.openedAt = null;
+            this.requests = [];
+            if (this.timeoutId) {
+                clearTimeout(this.timeoutId);
+                this.timeoutId = undefined;
+            }
+        }
+        this.notifyStateChange(previousState, newState);
+    }
+    /**
+     * Schedule transition to half-open
+     */
+    scheduleHalfOpen() {
+        if (this.timeoutId) {
+            clearTimeout(this.timeoutId);
+        }
+        this.timeoutId = setTimeout(() => {
+            if (this.state === CircuitBreakerState.OPEN) {
+                this.transitionTo(CircuitBreakerState.HALF_OPEN);
+            }
+        }, this.options.timeout);
+    }
+    /**
+     * Notify state change
+     */
+    notifyStateChange(from, to) {
+        this.emit('stateChange', { from, to });
+        this.options.onStateChange?.(from, to);
+    }
+    /**
+     * Clean old requests outside rolling window
+     */
+    cleanOldRequests() {
+        const cutoff = Date.now() - this.options.rollingWindow;
+        this.requests = this.requests.filter((r) => r.timestamp >= cutoff);
+    }
+}
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/resilience/circuit-breaker.js.map

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

package/dist/resilience/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Resilience Patterns
+ *
+ * Production-ready resilience utilities:
+ * - Retry with exponential backoff
+ * - Circuit breaker pattern
+ * - Rate limiting
+ *
+ * @module v3/shared/resilience
+ */
+export { retry, RetryError } from './retry.js';
+export type { RetryOptions, RetryResult } from './retry.js';
+export { CircuitBreaker } from './circuit-breaker.js';
+export type { CircuitBreakerOptions, CircuitBreakerStats } from './circuit-breaker.js';
+export { SlidingWindowRateLimiter, TokenBucketRateLimiter } from './rate-limiter.js';
+export type { RateLimiter, RateLimiterOptions, RateLimitResult } from './rate-limiter.js';
+export { Bulkhead } from './bulkhead.js';
+export type { BulkheadOptions, BulkheadStats } from './bulkhead.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/resilience/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resilience/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC/C,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG5D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAGvF,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACrF,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAG1F,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/resilience/index.js

@@ -0,0 +1,19 @@
+/**
+ * Resilience Patterns
+ *
+ * Production-ready resilience utilities:
+ * - Retry with exponential backoff
+ * - Circuit breaker pattern
+ * - Rate limiting
+ *
+ * @module v3/shared/resilience
+ */
+// Retry
+export { retry, RetryError } from './retry.js';
+// Circuit Breaker
+export { CircuitBreaker } from './circuit-breaker.js';
+// Rate Limiter
+export { SlidingWindowRateLimiter, TokenBucketRateLimiter } from './rate-limiter.js';
+// Bulkhead
+export { Bulkhead } from './bulkhead.js';
+//# sourceMappingURL=index.js.map

package/dist/resilience/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resilience/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,QAAQ;AACR,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG/C,kBAAkB;AAClB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,eAAe;AACf,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAGrF,WAAW;AACX,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}