raffel 0.1.2

package/dist/middleware/interceptors/circuit-breaker.int.test.js

@@ -0,0 +1,253 @@
+/**
+ * Circuit Breaker Interceptor Tests
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { createCircuitBreakerInterceptor, createProcedureCircuitBreaker, createCircuitBreakerManager, } from './circuit-breaker.js';
+import { createContext } from '../../types/index.js';
+import { RaffelError } from '../../core/router.js';
+function createEnvelope(procedure) {
+    return {
+        id: `test-${Date.now()}`,
+        procedure,
+        payload: {},
+        type: 'request',
+        metadata: {},
+        context: createContext('test-id'),
+    };
+}
+function createTestContext() {
+    return createContext('test');
+}
+describe('createCircuitBreakerInterceptor', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it('should allow requests when circuit is closed', async () => {
+        const interceptor = createCircuitBreakerInterceptor({
+            failureThreshold: 3,
+        });
+        const result = await interceptor(createEnvelope('test'), createTestContext(), async () => 'success');
+        expect(result).toBe('success');
+    });
+    it('should open circuit after failure threshold', async () => {
+        const interceptor = createCircuitBreakerInterceptor({
+            failureThreshold: 3,
+            resetTimeoutMs: 30000,
+            failureCodes: ['UNAVAILABLE'],
+        });
+        // Cause 3 failures with matching error code
+        for (let i = 0; i < 3; i++) {
+            await expect(interceptor(createEnvelope('test'), createTestContext(), async () => {
+                throw new RaffelError('UNAVAILABLE', `Failure ${i + 1}`);
+            })).rejects.toThrow();
+        }
+        // Circuit should be open now - throws UNAVAILABLE with "Circuit breaker is open"
+        await expect(interceptor(createEnvelope('test'), createTestContext(), async () => 'success')).rejects.toThrow('Circuit breaker is open');
+    });
+    it('should transition to half-open after reset timeout', async () => {
+        const interceptor = createCircuitBreakerInterceptor({
+            failureThreshold: 2,
+            resetTimeoutMs: 1000,
+            failureCodes: ['UNAVAILABLE'],
+        });
+        // Open the circuit
+        for (let i = 0; i < 2; i++) {
+            await expect(interceptor(createEnvelope('test'), createTestContext(), async () => {
+                throw new RaffelError('UNAVAILABLE', 'Fail');
+            })).rejects.toThrow();
+        }
+        // Circuit is open
+        await expect(interceptor(createEnvelope('test'), createTestContext(), async () => 'success')).rejects.toThrow('Circuit breaker is open');
+        // Wait for reset timeout
+        vi.advanceTimersByTime(1100);
+        // Now in half-open state, should allow one request
+        const result = await interceptor(createEnvelope('test'), createTestContext(), async () => 'success');
+        expect(result).toBe('success');
+    });
+    it('should close circuit after success in half-open state', async () => {
+        const interceptor = createCircuitBreakerInterceptor({
+            failureThreshold: 2,
+            successThreshold: 2,
+            resetTimeoutMs: 1000,
+            failureCodes: ['UNAVAILABLE'],
+        });
+        // Open the circuit
+        for (let i = 0; i < 2; i++) {
+            await expect(interceptor(createEnvelope('test'), createTestContext(), async () => {
+                throw new RaffelError('UNAVAILABLE', 'Fail');
+            })).rejects.toThrow();
+        }
+        // Wait for reset timeout
+        vi.advanceTimersByTime(1100);
+        // Successful requests in half-open state should close circuit
+        await interceptor(createEnvelope('test'), createTestContext(), async () => 'success');
+        await interceptor(createEnvelope('test'), createTestContext(), async () => 'success');
+        // Circuit should be closed now, multiple requests should work
+        for (let i = 0; i < 5; i++) {
+            await expect(interceptor(createEnvelope('test'), createTestContext(), async () => 'ok')).resolves.toBe('ok');
+        }
+    });
+    it('should re-open circuit on failure in half-open state', async () => {
+        const interceptor = createCircuitBreakerInterceptor({
+            failureThreshold: 2,
+            resetTimeoutMs: 1000,
+            failureCodes: ['UNAVAILABLE'],
+        });
+        // Open the circuit
+        for (let i = 0; i < 2; i++) {
+            await expect(interceptor(createEnvelope('test'), createTestContext(), async () => {
+                throw new RaffelError('UNAVAILABLE', 'Fail');
+            })).rejects.toThrow();
+        }
+        // Wait for reset timeout
+        vi.advanceTimersByTime(1100);
+        // Fail in half-open state
+        await expect(interceptor(createEnvelope('test'), createTestContext(), async () => {
+            throw new RaffelError('UNAVAILABLE', 'Still failing');
+        })).rejects.toThrow('Still failing');
+        // Should be open again
+        await expect(interceptor(createEnvelope('test'), createTestContext(), async () => 'success')).rejects.toThrow('Circuit breaker is open');
+    });
+    it('should only count errors with matching codes as failures', async () => {
+        const interceptor = createCircuitBreakerInterceptor({
+            failureThreshold: 2,
+            failureCodes: ['UNAVAILABLE'], // Only count UNAVAILABLE as failure
+        });
+        // Non-matching error codes should not count toward opening
+        for (let i = 0; i < 5; i++) {
+            await expect(interceptor(createEnvelope('test'), createTestContext(), async () => {
+                throw new RaffelError('INVALID_ARGUMENT', 'Bad input');
+            })).rejects.toThrow('Bad input');
+        }
+        // Circuit should still be closed
+        await expect(interceptor(createEnvelope('test'), createTestContext(), async () => 'success')).resolves.toBe('success');
+        // UNAVAILABLE errors should open circuit
+        for (let i = 0; i < 2; i++) {
+            await expect(interceptor(createEnvelope('test'), createTestContext(), async () => {
+                throw new RaffelError('UNAVAILABLE', 'Service down');
+            })).rejects.toThrow('Service down');
+        }
+        // Now circuit should be open
+        await expect(interceptor(createEnvelope('test'), createTestContext(), async () => 'success')).rejects.toThrow('Circuit breaker is open');
+    });
+    it('should call onStateChange callback', async () => {
+        const stateChanges = [];
+        const interceptor = createCircuitBreakerInterceptor({
+            failureThreshold: 2,
+            resetTimeoutMs: 1000,
+            failureCodes: ['UNAVAILABLE'],
+            onStateChange: (state, procedure) => {
+                stateChanges.push({ state, procedure });
+            },
+        });
+        // Open the circuit
+        for (let i = 0; i < 2; i++) {
+            await expect(interceptor(createEnvelope('test'), createTestContext(), async () => {
+                throw new RaffelError('UNAVAILABLE', 'Fail');
+            })).rejects.toThrow();
+        }
+        expect(stateChanges).toContainEqual({ state: 'open', procedure: 'test' });
+        // Wait for half-open
+        vi.advanceTimersByTime(1100);
+        await interceptor(createEnvelope('test'), createTestContext(), async () => 'success');
+        expect(stateChanges.some(s => s.state === 'half-open')).toBe(true);
+    });
+});
+describe('createProcedureCircuitBreaker', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it('should track circuits per procedure', async () => {
+        const interceptor = createProcedureCircuitBreaker({
+            default: {
+                failureThreshold: 2,
+                failureCodes: ['UNAVAILABLE'],
+            },
+            procedures: {},
+        });
+        // Open circuit for procedure-a
+        for (let i = 0; i < 2; i++) {
+            await expect(interceptor(createEnvelope('procedure-a'), createTestContext(), async () => {
+                throw new RaffelError('UNAVAILABLE', 'Fail');
+            })).rejects.toThrow();
+        }
+        // procedure-a should be open
+        await expect(interceptor(createEnvelope('procedure-a'), createTestContext(), async () => 'success')).rejects.toThrow('Circuit breaker is open');
+        // procedure-b should still work
+        await expect(interceptor(createEnvelope('procedure-b'), createTestContext(), async () => 'success')).resolves.toBe('success');
+    });
+    it('should use procedure-specific configuration', async () => {
+        const interceptor = createProcedureCircuitBreaker({
+            default: {
+                failureThreshold: 5,
+                failureCodes: ['UNAVAILABLE'],
+            },
+            procedures: {
+                'critical.service': {
+                    failureThreshold: 2, // More sensitive
+                },
+            },
+        });
+        // critical.service should open after 2 failures
+        for (let i = 0; i < 2; i++) {
+            await expect(interceptor(createEnvelope('critical.service'), createTestContext(), async () => {
+                throw new RaffelError('UNAVAILABLE', 'Fail');
+            })).rejects.toThrow();
+        }
+        await expect(interceptor(createEnvelope('critical.service'), createTestContext(), async () => 'success')).rejects.toThrow('Circuit breaker is open');
+    });
+});
+describe('createCircuitBreakerManager', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it('should provide getStates for all circuits', async () => {
+        const manager = createCircuitBreakerManager({
+            failureThreshold: 2,
+            failureCodes: ['UNAVAILABLE'],
+        });
+        // Cause failures
+        for (let i = 0; i < 2; i++) {
+            await expect(manager.interceptor(createEnvelope('test'), createTestContext(), async () => {
+                throw new RaffelError('UNAVAILABLE', 'Fail');
+            })).rejects.toThrow();
+        }
+        const states = manager.getStates();
+        expect(states.get('test')).toBe('open');
+    });
+    it('should allow resetAll to close all circuits', async () => {
+        const manager = createCircuitBreakerManager({
+            failureThreshold: 2,
+            failureCodes: ['UNAVAILABLE'],
+        });
+        // Open the circuit
+        for (let i = 0; i < 2; i++) {
+            await expect(manager.interceptor(createEnvelope('test'), createTestContext(), async () => {
+                throw new RaffelError('UNAVAILABLE', 'Fail');
+            })).rejects.toThrow();
+        }
+        expect(manager.getStates().get('test')).toBe('open');
+        // Manually reset all
+        manager.resetAll();
+        expect(manager.getStates().get('test')).toBe('closed');
+    });
+    it('should allow forceState to control circuit state', async () => {
+        const manager = createCircuitBreakerManager({
+            failureThreshold: 5,
+            failureCodes: ['UNAVAILABLE'],
+        });
+        // Force the circuit to open
+        manager.forceState('test', 'open');
+        expect(manager.getStates().get('test')).toBe('open');
+    });
+});
+//# sourceMappingURL=circuit-breaker.int.test.js.map

package/dist/middleware/interceptors/circuit-breaker.int.test.js.map

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

package/dist/middleware/interceptors/circuit-breaker.js

@@ -0,0 +1,268 @@
+/**
+ * Circuit Breaker Interceptor
+ *
+ * Protocol-agnostic circuit breaker pattern implementation.
+ * Prevents cascading failures by failing fast when a service is unhealthy.
+ */
+import { RaffelError } from '../../core/router.js';
+/**
+ * Default error codes that count as failures
+ */
+const DEFAULT_FAILURE_CODES = [
+    'UNAVAILABLE',
+    'DEADLINE_EXCEEDED',
+    'INTERNAL_ERROR',
+    'UNKNOWN',
+];
+/**
+ * Create a circuit breaker interceptor
+ *
+ * The circuit breaker has three states:
+ * - CLOSED: Normal operation, requests pass through
+ * - OPEN: Circuit is tripped, requests fail fast
+ * - HALF-OPEN: Testing if service recovered, limited requests allowed
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * const circuitBreaker = createCircuitBreakerInterceptor()
+ *
+ * // Custom configuration
+ * const circuitBreaker = createCircuitBreakerInterceptor({
+ *   failureThreshold: 5,      // Open after 5 failures
+ *   successThreshold: 3,      // Close after 3 successes in half-open
+ *   resetTimeoutMs: 30000,    // Try to recover after 30s
+ * })
+ *
+ * // With state change callback
+ * const circuitBreaker = createCircuitBreakerInterceptor({
+ *   onStateChange: (state, procedure) => {
+ *     metrics.gauge('circuit_breaker', state === 'open' ? 1 : 0, { procedure })
+ *   }
+ * })
+ *
+ * server.use(circuitBreaker)
+ * ```
+ */
+export function createCircuitBreakerInterceptor(config = {}) {
+    const { failureThreshold = 5, successThreshold = 3, resetTimeoutMs = 30000, windowMs = 60000, failureCodes = DEFAULT_FAILURE_CODES, onStateChange, } = config;
+    // Circuit breakers per procedure
+    const circuits = new Map();
+    /**
+     * Get or create a circuit breaker for a procedure
+     */
+    const getCircuit = (procedure) => {
+        let circuit = circuits.get(procedure);
+        if (!circuit) {
+            circuit = {
+                state: 'closed',
+                failures: 0,
+                successes: 0,
+                lastFailureTime: 0,
+                lastStateChange: Date.now(),
+            };
+            circuits.set(procedure, circuit);
+        }
+        return circuit;
+    };
+    /**
+     * Transition to a new state
+     */
+    const transitionTo = (circuit, procedure, newState) => {
+        if (circuit.state !== newState) {
+            const _oldState = circuit.state;
+            circuit.state = newState;
+            circuit.lastStateChange = Date.now();
+            // Reset counters on state change
+            if (newState === 'closed') {
+                circuit.failures = 0;
+                circuit.successes = 0;
+            }
+            else if (newState === 'half-open') {
+                circuit.successes = 0;
+            }
+            onStateChange?.(newState, procedure);
+        }
+    };
+    /**
+     * Check if a failure is within the counting window
+     */
+    const isWithinWindow = (circuit) => {
+        return Date.now() - circuit.lastFailureTime < windowMs;
+    };
+    /**
+     * Record a success
+     */
+    const recordSuccess = (circuit, procedure) => {
+        if (circuit.state === 'half-open') {
+            circuit.successes++;
+            if (circuit.successes >= successThreshold) {
+                transitionTo(circuit, procedure, 'closed');
+            }
+        }
+        else if (circuit.state === 'closed') {
+            // Reset failure count on success if outside window
+            if (!isWithinWindow(circuit)) {
+                circuit.failures = 0;
+            }
+        }
+    };
+    /**
+     * Record a failure
+     */
+    const recordFailure = (circuit, procedure) => {
+        circuit.lastFailureTime = Date.now();
+        if (circuit.state === 'half-open') {
+            // Any failure in half-open goes back to open
+            transitionTo(circuit, procedure, 'open');
+        }
+        else if (circuit.state === 'closed') {
+            circuit.failures++;
+            if (circuit.failures >= failureThreshold) {
+                transitionTo(circuit, procedure, 'open');
+            }
+        }
+    };
+    /**
+     * Check if circuit should allow request
+     */
+    const shouldAllowRequest = (circuit, procedure) => {
+        const now = Date.now();
+        switch (circuit.state) {
+            case 'closed':
+                return true;
+            case 'open':
+                // Check if reset timeout has passed
+                if (now - circuit.lastStateChange >= resetTimeoutMs) {
+                    transitionTo(circuit, procedure, 'half-open');
+                    return true;
+                }
+                return false;
+            case 'half-open':
+                // Allow limited requests in half-open state
+                return true;
+            default:
+                return true;
+        }
+    };
+    /**
+     * Check if an error counts as a failure
+     */
+    const isFailure = (error) => {
+        const code = error.code;
+        return code && failureCodes.includes(code);
+    };
+    return async (envelope, ctx, next) => {
+        const procedure = envelope.procedure;
+        const circuit = getCircuit(procedure);
+        // Check if request should be allowed
+        if (!shouldAllowRequest(circuit, procedure)) {
+            throw new RaffelError('UNAVAILABLE', 'Circuit breaker is open', {
+                procedure,
+                state: circuit.state,
+                failures: circuit.failures,
+                lastFailureTime: circuit.lastFailureTime,
+                resetAfterMs: resetTimeoutMs - (Date.now() - circuit.lastStateChange),
+            });
+        }
+        try {
+            const result = await next();
+            recordSuccess(circuit, procedure);
+            return result;
+        }
+        catch (error) {
+            if (isFailure(error)) {
+                recordFailure(circuit, procedure);
+            }
+            throw error;
+        }
+    };
+}
+/**
+ * Create a circuit breaker with procedure-specific configurations
+ *
+ * @example
+ * ```typescript
+ * const circuitBreaker = createProcedureCircuitBreaker({
+ *   default: { failureThreshold: 5 },
+ *   procedures: {
+ *     'external.payment': { failureThreshold: 3, resetTimeoutMs: 60000 },
+ *     'external.email': { failureThreshold: 10 },
+ *   }
+ * })
+ * ```
+ */
+export function createProcedureCircuitBreaker(config) {
+    const { default: defaultConfig = {}, procedures } = config;
+    // Create circuit breakers for each procedure
+    const breakers = new Map();
+    // Default breaker
+    const defaultBreaker = createCircuitBreakerInterceptor(defaultConfig);
+    return async (envelope, ctx, next) => {
+        const procedure = envelope.procedure;
+        // Check for exact match
+        if (procedures[procedure]) {
+            let breaker = breakers.get(procedure);
+            if (!breaker) {
+                breaker = createCircuitBreakerInterceptor({
+                    ...defaultConfig,
+                    ...procedures[procedure],
+                });
+                breakers.set(procedure, breaker);
+            }
+            return breaker(envelope, ctx, next);
+        }
+        // Check for pattern match
+        for (const [pattern, procedureConfig] of Object.entries(procedures)) {
+            const regex = pattern
+                .replace(/[.+^${}()|[\]\\]/g, '\\$&')
+                .replace(/\*\*/g, '{{DOUBLE_STAR}}')
+                .replace(/\*/g, '[^.]*')
+                .replace(/{{DOUBLE_STAR}}/g, '.*');
+            if (new RegExp(`^${regex}$`).test(procedure)) {
+                let breaker = breakers.get(pattern);
+                if (!breaker) {
+                    breaker = createCircuitBreakerInterceptor({
+                        ...defaultConfig,
+                        ...procedureConfig,
+                    });
+                    breakers.set(pattern, breaker);
+                }
+                return breaker(envelope, ctx, next);
+            }
+        }
+        // Use default breaker
+        return defaultBreaker(envelope, ctx, next);
+    };
+}
+export function createCircuitBreakerManager(config = {}) {
+    const circuits = new Map();
+    const interceptor = createCircuitBreakerInterceptor({
+        ...config,
+        onStateChange: (state, procedure) => {
+            circuits.set(procedure, { state });
+            config.onStateChange?.(state, procedure);
+        },
+    });
+    return {
+        getStates() {
+            const states = new Map();
+            for (const [procedure, circuit] of circuits) {
+                states.set(procedure, circuit.state);
+            }
+            return states;
+        },
+        forceState(procedure, state) {
+            circuits.set(procedure, { state });
+            config.onStateChange?.(state, procedure);
+        },
+        resetAll() {
+            for (const [procedure] of circuits) {
+                circuits.set(procedure, { state: 'closed' });
+                config.onStateChange?.('closed', procedure);
+            }
+        },
+        interceptor,
+    };
+}
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/middleware/interceptors/circuit-breaker.js.map

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

package/dist/middleware/interceptors/dedup.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Request Deduplication Interceptor
+ *
+ * Coalesces identical in-flight requests to avoid duplicate work.
+ * When multiple requests with the same key are made simultaneously,
+ * only the first one executes - subsequent ones wait for and share the result.
+ *
+ * Features:
+ * - Automatic key generation based on procedure + payload hash
+ * - Custom key generators for complex scenarios
+ * - Safe method detection (only dedup idempotent operations)
+ * - Memory-efficient with automatic cleanup
+ */
+import type { Interceptor, Envelope, Context } from '../../types/index.js';
+/**
+ * Deduplication configuration
+ */
+export interface DedupConfig {
+    /**
+     * Custom key generator for deduplication
+     * Default: procedure + JSON hash of payload
+     */
+    keyGenerator?: (envelope: Envelope, ctx: Context) => string;
+    /**
+     * Envelope types to deduplicate (default: ['query'])
+     * Procedures are typically not safe to deduplicate
+     */
+    types?: Array<'query' | 'procedure' | 'stream' | 'event'>;
+    /**
+     * Procedure patterns to deduplicate (glob patterns)
+     * If specified, only matching procedures are deduplicated
+     */
+    procedures?: string[];
+    /**
+     * Procedure patterns to exclude from deduplication
+     */
+    excludeProcedures?: string[];
+    /**
+     * TTL for pending request entries in ms (default: 30000)
+     * Prevents memory leaks if requests never complete
+     */
+    ttlMs?: number;
+    /**
+     * Callback when a request is deduplicated
+     * Useful for metrics and debugging
+     */
+    onDedup?: (info: {
+        key: string;
+        procedure: string;
+        requestId?: string;
+        waitingCount: number;
+    }) => void;
+}
+/**
+ * Create a request deduplication interceptor
+ *
+ * Coalesces identical in-flight requests to avoid duplicate work.
+ * Only the first request executes; subsequent identical requests
+ * wait for and share the result.
+ *
+ * @example
+ * ```typescript
+ * // Basic usage - dedup queries only
+ * const dedup = createDedupInterceptor()
+ *
+ * // Custom key generation
+ * const dedup = createDedupInterceptor({
+ *   keyGenerator: (envelope, ctx) => {
+ *     // Include user in key for user-specific caching
+ *     return `${ctx.auth?.principal}:${envelope.procedure}`
+ *   }
+ * })
+ *
+ * // With metrics
+ * const dedup = createDedupInterceptor({
+ *   onDedup: ({ procedure, waitingCount }) => {
+ *     metrics.increment('dedup.coalesced', { procedure })
+ *     metrics.gauge('dedup.waiting', waitingCount)
+ *   }
+ * })
+ *
+ * // Deduplicate specific procedures
+ * const dedup = createDedupInterceptor({
+ *   types: ['query', 'procedure'],
+ *   procedures: ['users.get', 'products.list', 'cache.**'],
+ * })
+ *
+ * server.use(dedup)
+ * ```
+ */
+export declare function createDedupInterceptor(config?: DedupConfig): Interceptor;
+/**
+ * Create a deduplication interceptor for read-only procedures
+ *
+ * Convenience wrapper that only deduplicates queries and
+ * procedures matching common read patterns.
+ *
+ * @example
+ * ```typescript
+ * const dedup = createReadOnlyDedupInterceptor()
+ * server.use(dedup)
+ * ```
+ */
+export declare function createReadOnlyDedupInterceptor(config?: Omit<DedupConfig, 'types' | 'procedures'>): Interceptor;
+//# sourceMappingURL=dedup.d.ts.map

package/dist/middleware/interceptors/dedup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.d.ts","sourceRoot":"","sources":["../../../src/middleware/interceptors/dedup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAE1E;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,KAAK,MAAM,CAAA;IAE3D;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC,CAAA;IAEzD;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IAErB;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;IAE5B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE;QACf,GAAG,EAAE,MAAM,CAAA;QACX,SAAS,EAAE,MAAM,CAAA;QACjB,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,YAAY,EAAE,MAAM,CAAA;KACrB,KAAK,IAAI,CAAA;CACX;AAuDD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,GAAE,WAAgB,GAAG,WAAW,CAyF5E;AA4BD;;;;;;;;;;;GAWG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,GAAE,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,YAAY,CAAM,GAAG,WAAW,CAsBlH"}