@archlast/server 0.1.8 → 0.1.9

package/dist/cache/redis-adapter.js

@@ -0,0 +1,424 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisCacheAdapter = void 0;
+const crypto_1 = __importDefault(require("crypto"));
+const os_1 = __importDefault(require("os"));
+const ioredis_1 = __importDefault(require("ioredis"));
+const circuit_breaker_js_1 = require("./circuit-breaker.js");
+/**
+ * Redis L2 cache adapter using ioredis.
+ *
+ * Features:
+ * - Cache-aside pattern (check Redis, return null on miss)
+ * - Connection retry logic with exponential backoff
+ * - Graceful degradation (returns null if Redis unavailable)
+ * - Pub/sub for cross-instance cache invalidation
+ */
+class RedisCacheAdapter {
+    options;
+    redis = null;
+    subscriber = null;
+    enabled;
+    isConnectedFlag = false;
+    healthCheckInterval = null;
+    HEALTH_CHECK_INTERVAL_MS = 30000; // 30 seconds
+    circuitBreaker;
+    instanceId;
+    constructor(options) {
+        this.options = options;
+        this.enabled = options.enabled;
+        this.instanceId = `${os_1.default.hostname()}:${process.pid}:${Date.now()}`;
+        this.circuitBreaker = new circuit_breaker_js_1.CircuitBreaker({
+            failureThreshold: 5,
+            resetTimeoutMs: 30000,
+            name: "RedisCacheAdapter",
+        });
+        if (this.enabled) {
+            this.initializeRedis();
+        }
+    }
+    initializeRedis() {
+        try {
+            this.redis = new ioredis_1.default({
+                host: this.options.host,
+                port: this.options.port,
+                password: this.options.password,
+                db: this.options.db,
+                maxRetriesPerRequest: 3,
+                enableReadyCheck: true,
+                retryStrategy: (times) => {
+                    // Exponential backoff: 2^times * 100ms, capped at 30 seconds
+                    const baseDelay = Math.min(Math.pow(2, times) * 100, 30000);
+                    // Add jitter: ±25% randomization to prevent thundering herd
+                    const jitter = baseDelay * 0.25 * (Math.random() * 2 - 1);
+                    return Math.floor(baseDelay + jitter);
+                },
+                reconnectOnError: (err) => {
+                    const reconnectErrors = [
+                        "ECONNREFUSED",
+                        "ETIMEDOUT",
+                        "ECONNRESET",
+                        "ENOTFOUND",
+                        "EPIPE",
+                        "EAI_AGAIN",
+                    ];
+                    const errorMessage = err.message.toUpperCase();
+                    // Reconnect on all connection-related errors
+                    if (reconnectErrors.some((code) => errorMessage.includes(code))) {
+                        console.warn(`Redis reconnecting due to connection error: ${err.message}`);
+                        return true;
+                    }
+                    // Also reconnect on READONLY errors (original behavior)
+                    if (errorMessage.includes("READONLY")) {
+                        console.warn(`Redis reconnecting due to READONLY error: ${err.message}`);
+                        return true;
+                    }
+                    return false;
+                },
+            });
+            // Setup pub/sub subscriber for invalidation
+            this.subscriber = this.redis.duplicate();
+            this.subscriber.subscribe("cache:invalidate", (err) => {
+                if (err) {
+                    console.error("Redis pub/sub subscribe failed:", err);
+                }
+            });
+            this.subscriber.on("message", (channel, message) => {
+                if (channel === "cache:invalidate" && this.options.onInvalidate) {
+                    try {
+                        const parsed = JSON.parse(message);
+                        // Support both old format (array of keys) and new format
+                        if (Array.isArray(parsed)) {
+                            // Old format: just keys array
+                            this.options.onInvalidate(parsed, undefined);
+                        }
+                        else if (parsed.version === "1.0") {
+                            // New format: structured message
+                            this.options.onInvalidate(parsed.keys || [], parsed.pattern);
+                        }
+                        else {
+                            // Legacy format: { keys, pattern } object
+                            this.options.onInvalidate(parsed.keys || [], parsed.pattern);
+                        }
+                    }
+                    catch (err) {
+                        console.error("[Cache] Failed to parse invalidation message:", err);
+                    }
+                }
+            });
+            // Log connection status and track connection state
+            this.redis.on("connect", () => {
+                console.log("Redis L2 cache connected");
+                this.isConnectedFlag = true;
+            });
+            this.redis.on("ready", () => {
+                console.log("Redis L2 cache ready");
+                this.isConnectedFlag = true;
+                this.startHealthCheck();
+            });
+            this.redis.on("error", (err) => {
+                console.error("Redis L2 cache error:", err.message);
+                this.isConnectedFlag = false;
+            });
+            this.redis.on("close", () => {
+                console.warn("Redis L2 cache connection closed");
+                this.isConnectedFlag = false;
+                this.stopHealthCheck();
+            });
+            this.redis.on("reconnecting", () => {
+                console.log("Redis L2 cache reconnecting...");
+                this.isConnectedFlag = false;
+            });
+            this.redis.on("end", () => {
+                console.warn("Redis L2 cache connection ended");
+                this.isConnectedFlag = false;
+                this.stopHealthCheck();
+            });
+        }
+        catch (err) {
+            console.error("Failed to initialize Redis:", err);
+            this.enabled = false;
+        }
+    }
+    /**
+     * Get value from Redis L2 cache
+     */
+    async get(key) {
+        if (!this.enabled || !this.redis)
+            return null;
+        try {
+            return await this.circuitBreaker.execute(async () => {
+                const value = await this.redis.get(key);
+                return value ? JSON.parse(value) : null;
+            });
+        }
+        catch (err) {
+            if (err instanceof circuit_breaker_js_1.CircuitBreakerOpenError) {
+                console.warn("Redis circuit breaker is open, returning null");
+                return null; // Graceful degradation
+            }
+            console.warn(`Redis GET failed for key ${key}:`, err);
+            return null;
+        }
+    }
+    /**
+     * Get remaining TTL for a key in milliseconds
+     * Returns null if key doesn't exist or has no TTL
+     */
+    async getTtl(key) {
+        if (!this.enabled || !this.redis)
+            return null;
+        try {
+            return await this.circuitBreaker.execute(async () => {
+                const ttlSeconds = await this.redis.ttl(key);
+                if (ttlSeconds < 0) {
+                    // -1 = key exists but has no TTL, -2 = key doesn't exist
+                    return ttlSeconds === -1 ? null : null;
+                }
+                return ttlSeconds * 1000; // Convert to milliseconds
+            });
+        }
+        catch (err) {
+            if (err instanceof circuit_breaker_js_1.CircuitBreakerOpenError) {
+                console.warn("Redis circuit breaker is open, returning null TTL");
+                return null;
+            }
+            console.warn(`Redis TTL failed for key ${key}:`, err);
+            return null;
+        }
+    }
+    /**
+     * Set value in Redis L2 cache with TTL
+     * Uses direct L2 TTL value (in milliseconds) from caller
+     */
+    async set(key, value, ttlMs) {
+        if (!this.enabled || !this.redis)
+            return;
+        try {
+            await this.circuitBreaker.execute(async () => {
+                // Convert TTL from milliseconds to seconds for Redis
+                const ttlSeconds = Math.ceil(ttlMs / 1000);
+                await this.redis.set(key, JSON.stringify(value), "EX", ttlSeconds);
+            });
+        }
+        catch (err) {
+            if (err instanceof circuit_breaker_js_1.CircuitBreakerOpenError) {
+                console.warn("Redis circuit breaker is open, skipping SET");
+                return; // Graceful degradation
+            }
+            console.warn(`Redis SET failed for key ${key}:`, err);
+        }
+    }
+    /**
+     * Delete key from Redis L2 cache
+     */
+    async delete(key) {
+        if (!this.enabled || !this.redis)
+            return;
+        try {
+            await this.circuitBreaker.execute(async () => {
+                await this.redis.del(key);
+            });
+        }
+        catch (err) {
+            if (err instanceof circuit_breaker_js_1.CircuitBreakerOpenError) {
+                console.warn("Redis circuit breaker is open, skipping DELETE");
+                return; // Graceful degradation
+            }
+            console.warn(`Redis DELETE failed for key ${key}:`, err);
+        }
+    }
+    /**
+     * Invalidate all keys matching pattern
+     */
+    async invalidatePattern(pattern) {
+        if (!this.enabled || !this.redis)
+            return;
+        try {
+            await this.circuitBreaker.execute(async () => {
+                const keys = await this.redis.keys(pattern);
+                if (keys.length > 0) {
+                    await this.redis.del(...keys);
+                }
+            });
+        }
+        catch (err) {
+            if (err instanceof circuit_breaker_js_1.CircuitBreakerOpenError) {
+                console.warn("Redis circuit breaker is open, skipping INVALIDATE_PATTERN");
+                return; // Graceful degradation
+            }
+            console.warn(`Redis INVALIDATE_PATTERN failed for ${pattern}:`, err);
+        }
+    }
+    /**
+     * Publish invalidation event to Redis pub/sub
+     * Uses structured message format with metadata for observability
+     */
+    async publishInvalidation(keys, pattern) {
+        if (!this.enabled || !this.redis)
+            return;
+        try {
+            await this.circuitBreaker.execute(async () => {
+                const message = {
+                    version: "1.0",
+                    timestamp: new Date().toISOString(),
+                    source: this.instanceId,
+                    keys,
+                    pattern,
+                    metadata: {
+                        correlationId: crypto_1.default.randomUUID(),
+                        reason: pattern ? "pattern_invalidation" : "key_invalidation",
+                    },
+                };
+                await this.redis.publish("cache:invalidate", JSON.stringify(message));
+            });
+        }
+        catch (err) {
+            if (err instanceof circuit_breaker_js_1.CircuitBreakerOpenError) {
+                console.warn("Redis circuit breaker is open, skipping PUBLISH");
+                return; // Graceful degradation
+            }
+            console.warn("Redis PUBLISH failed:", err);
+        }
+    }
+    /**
+     * Get Redis statistics
+     */
+    async getStats() {
+        if (!this.enabled || !this.redis)
+            return null;
+        try {
+            return await this.circuitBreaker.execute(async () => {
+                const info = await this.redis.info("stats");
+                const memory = await this.redis.info("memory");
+                const clients = await this.redis.info("clients");
+                const hits = this.parseInfo(info, "keyspace_hits");
+                const misses = this.parseInfo(info, "keyspace_misses");
+                const total = hits + misses;
+                return {
+                    connected: this.isConnected(),
+                    hits,
+                    misses,
+                    hitRate: total > 0 ? hits / total : 0,
+                    memoryUsed: this.parseInfo(memory, "used_memory"),
+                    connectedClients: this.parseInfo(clients, "connected_clients"),
+                    evictions: this.parseInfo(info, "evicted_keys"),
+                    opsPerSec: this.parseInfo(info, "instantaneous_ops_per_sec"),
+                };
+            });
+        }
+        catch (err) {
+            if (err instanceof circuit_breaker_js_1.CircuitBreakerOpenError) {
+                console.warn("Redis circuit breaker is open, returning null stats");
+                return null; // Graceful degradation
+            }
+            console.warn("Redis getStats failed:", err);
+            return null;
+        }
+    }
+    /**
+     * Check if Redis client is connected
+     */
+    isConnected() {
+        return this.isConnectedFlag && this.redis?.status === "ready";
+    }
+    /**
+     * Start periodic health check interval
+     */
+    startHealthCheck() {
+        // Clear any existing interval first
+        this.stopHealthCheck();
+        this.healthCheckInterval = setInterval(async () => {
+            const isHealthy = await this.healthCheck();
+            if (!isHealthy) {
+                console.warn("Redis health check failed during periodic check");
+                this.isConnectedFlag = false;
+                // The reconnectOnError and retryStrategy will handle reconnection
+            }
+            else {
+                this.isConnectedFlag = true;
+            }
+        }, this.HEALTH_CHECK_INTERVAL_MS);
+        // Prevent the interval from keeping the process alive
+        if (this.healthCheckInterval.unref) {
+            this.healthCheckInterval.unref();
+        }
+    }
+    /**
+     * Stop periodic health check interval
+     */
+    stopHealthCheck() {
+        if (this.healthCheckInterval) {
+            clearInterval(this.healthCheckInterval);
+            this.healthCheckInterval = null;
+        }
+    }
+    /**
+     * Health check for Redis connection with timeout
+     *
+     * Tests Redis connection using PING command with configurable timeout.
+     * Returns false if Redis is disabled, not connected, or times out.
+     *
+     * @param timeoutMs - Timeout in milliseconds (default: 5000)
+     * @returns true if Redis is responsive, false otherwise
+     */
+    async healthCheck(timeoutMs = 5000) {
+        // Return false if Redis is disabled or not initialized
+        if (!this.enabled || !this.redis) {
+            console.warn("Redis health check failed: Redis is disabled or not initialized");
+            return false;
+        }
+        // Return false if client is not in ready state
+        if (!this.isConnected()) {
+            console.warn("Redis health check failed: Redis client is not connected");
+            return false;
+        }
+        try {
+            return await this.circuitBreaker.execute(async () => {
+                // Race between PING command and timeout
+                const pingPromise = this.redis.ping();
+                const timeoutPromise = new Promise((_, reject) => {
+                    setTimeout(() => reject(new Error("Health check timeout")), timeoutMs);
+                });
+                await Promise.race([pingPromise, timeoutPromise]);
+                return true;
+            });
+        }
+        catch (err) {
+            if (err instanceof circuit_breaker_js_1.CircuitBreakerOpenError) {
+                console.warn("Redis health check skipped: circuit breaker is open");
+                return false; // Graceful degradation
+            }
+            const message = err instanceof Error ? err.message : String(err);
+            console.warn(`Redis health check failed: ${message}`);
+            return false;
+        }
+    }
+    /**
+     * Parse Redis INFO response for specific key
+     */
+    parseInfo(info, key) {
+        const match = info.match(new RegExp(`${key}:(\\d+)`));
+        return match ? parseInt(match[1], 10) : 0;
+    }
+    /**
+     * Close Redis connections
+     */
+    async close() {
+        this.stopHealthCheck();
+        this.isConnectedFlag = false;
+        if (this.subscriber) {
+            await this.subscriber.quit();
+            this.subscriber = null;
+        }
+        if (this.redis) {
+            await this.redis.quit();
+            this.redis = null;
+        }
+    }
+}
+exports.RedisCacheAdapter = RedisCacheAdapter;
+//# sourceMappingURL=redis-adapter.js.map

package/dist/cache/redis-adapter.js.map

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

package/dist/cache/run-sidecar.js

@@ -8,10 +8,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const sidecar_server_js_1 = require("./sidecar-server.js");
 const logger_js_1 = require("../logging/logger.js");
+const service_js_1 = require("../config/service.js");
 const path_1 = require("path");
 const fs_1 = require("fs");
 const SOCKET_PATH = process.env.CACHE_SOCKET_PATH || (0, path_1.join)(process.cwd(), "data", "cache.sock");
 async function main() {
+    const config = (0, service_js_1.loadServerConfig)();
     logger_js_1.logger.log({
         timestamp: Date.now(),
         level: "info",
@@ -33,7 +35,14 @@ async function main() {
             // Directory creation is best-effort; listen will surface failures.
         }
     }
-    const server = new sidecar_server_js_1.CacheSidecarServer(SOCKET_PATH);
+    const server = new sidecar_server_js_1.CacheSidecarServer(SOCKET_PATH, {
+        enabled: config.redis.enabled,
+        host: config.redis.host,
+        port: config.redis.port,
+        password: config.redis.password,
+        db: config.redis.db,
+        ttlMultiplier: config.redis.ttlMultiplier,
+    });
     // Handle graceful shutdown
     const shutdown = async () => {
         logger_js_1.logger.log({

package/dist/cache/run-sidecar.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-sidecar.js","sourceRoot":"","sources":["../../src/cache/run-sidecar.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAEH,2DAAyD;AACzD,oDAA8C;AAE9C,+BAAqC;AACrC,2BAA+B;AAE/B,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,IAAA,WAAI,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;AAE/F,KAAK,UAAU,IAAI;IACf,kBAAM,CAAC,GAAG,CAAC;QACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,iDAAiD;KAC7D,CAAC,CAAC;IACH,kBAAM,CAAC,GAAG,CAAC;QACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,+BAA+B,WAAW,EAAE;KACxD,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,IAAA,cAAO,EAAC,WAAW,CAAC,CAAC;IACvC,IAAI,SAAS,IAAI,SAAS,KAAK,GAAG,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;QACtD,IAAI,CAAC;YACD,IAAA,cAAS,EAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,CAAC;QAAC,MAAM,CAAC;YACL,mEAAmE;QACvE,CAAC;IACL,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,sCAAkB,CAAC,WAAW,CAAC,CAAC;IAEnD,2BAA2B;IAC3B,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;QACxB,kBAAM,CAAC,GAAG,CAAC;YACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,KAAK,EAAE,MAAM;YACb,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,iCAAiC;SAC7C,CAAC,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAEhC,eAAe;IACf,IAAI,CAAC;QACD,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,kBAAM,CAAC,GAAG,CAAC;YACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,KAAK,EAAE,MAAM;YACb,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,4CAA4C;SACxD,CAAC,CAAC;IACP,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,kBAAM,CAAC,GAAG,CAAC;YACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,KAAK,EAAE,OAAO;YACd,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,wCAAwC;YACjD,OAAO,EAAE,EAAE,GAAG,EAAE;SACnB,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACL,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACjB,kBAAM,CAAC,GAAG,CAAC;QACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,6BAA6B;QACtC,OAAO,EAAE,GAAG;KACf,CAAC,CAAC;IACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"run-sidecar.js","sourceRoot":"","sources":["../../src/cache/run-sidecar.ts"],"names":[],"mappings":"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"}

package/dist/cache/sidecar-server.d.ts

@@ -5,12 +5,62 @@
  * Handles all cache operations via IPC.
  */
 import { estimateSize } from "./store.js";
+import { type RedisCacheAdapterOptions } from "./redis-adapter.js";
 export { estimateSize };
 export declare class CacheSidecarServer {
     private server;
     private cache;
     private socketPath;
-    constructor(socketPath: string);
+    private redis;
+    private invalidationRetryQueue;
+    private l2AccessLog;
+    private recentlyDemoted;
+    private cleanupInterval;
+    private readonly PROMOTION_THRESHOLD;
+    private readonly PROMOTION_WINDOW_MS;
+    private readonly DEMOTION_COOLDOWN_MS;
+    private readonly MIN_TTL_REMAINING_MS;
+    private readonly CLEANUP_INTERVAL_MS;
+    constructor(socketPath: string, redisConfig?: RedisCacheAdapterOptions);
+    /**
+     * Start periodic cleanup of old access and demotion records
+     */
+    private startCleanupInterval;
+    /**
+     * Stop periodic cleanup interval
+     */
+    private stopCleanupInterval;
+    /**
+     * Cleanup old access records and demotion records
+     */
+    private cleanupOldRecords;
+    /**
+     * Get partition for a key based on key prefix/pattern
+     * Keys are namespaced as "partition:key"
+     */
+    private getPartitionForKey;
+    /**
+     * Record L2 access and determine if entry should be promoted to L1
+     */
+    private recordL2AccessAndCheckPromotion;
+    /**
+     * Check if L1 partition has space for new entry
+     */
+    private hasSpaceInPartition;
+    /**
+     * Get access count for a key
+     */
+    private getAccessCount;
+    /**
+     * Mark a key as recently demoted to prevent immediate re-promotion
+     */
+    private onL1Eviction;
+    /**
+     * Set up L1→L2 promotion handlers on LRU eviction
+     * When an entry is evicted from L1 due to space constraints,
+     * write it to L2 Redis before it's lost
+     */
+    private setupL1EvictionHandlers;
     private registerHandlers;
     start(): Promise<void>;
     stop(): Promise<void>;

package/dist/cache/sidecar-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sidecar-server.d.ts","sourceRoot":"","sources":["../../src/cache/sidecar-server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAc,YAAY,EAAE,MAAM,YAAY,CAAC;AAItD,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,EAAE,MAAM;IAO9B,OAAO,CAAC,gBAAgB;IAqGlB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAUtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAG9B"}
+{"version":3,"file":"sidecar-server.d.ts","sourceRoot":"","sources":["../../src/cache/sidecar-server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAc,YAAY,EAAE,MAAM,YAAY,CAAC;AAGtD,OAAO,EAAqB,KAAK,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAGtF,OAAO,EAAE,YAAY,EAAE,CAAC;AAWxB,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,sBAAsB,CAAyB;IAGvD,OAAO,CAAC,WAAW,CAAwC;IAC3D,OAAO,CAAC,eAAe,CAAkC;IACzD,OAAO,CAAC,eAAe,CAA+B;IAEtD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAK;IACzC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAiB;IACrD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAa;IAClD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAa;IAClD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAa;gBAErC,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,wBAAwB;IA8CtE;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAW5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA4BzB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;OAEG;IACH,OAAO,CAAC,+BAA+B;IAgDvC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAa3B;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;;;OAIG;IACH,OAAO,CAAC,uBAAuB;IAqE/B,OAAO,CAAC,gBAAgB;IAgPlB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IActB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAS9B"}