@wgtechlabs/nuvex 0.1.1

package/dist/esm/layers/postgres.js

@@ -0,0 +1,485 @@
+/**
+ * Nuvex - PostgreSQL Storage Layer (L3)
+ * Next-gen Unified Vault Experience
+ *
+ * PostgreSQL persistent storage layer serving as the source of truth for all data.
+ * Provides ACID-compliant, durable storage with full data integrity guarantees.
+ *
+ * Features:
+ * - ACID-compliant persistent storage
+ * - Source of truth for all data
+ * - JSON support for flexible data structures
+ * - Automatic TTL-based expiration
+ * - Connection pooling for optimal performance
+ * - Health monitoring with SELECT 1 queries
+ *
+ * @author Waren Gonzaga, WG Technology Labs
+ * @since 2025
+ */
+import pkg from 'pg';
+const { Pool } = pkg;
+import { validateSQLIdentifier } from '../core/database.js';
+/**
+ * PostgreSQL Storage Layer - L3 Persistent Storage
+ *
+ * Implements persistent storage using PostgreSQL. This is the authoritative
+ * source of truth for all data in the system. All writes must succeed here
+ * for the operation to be considered successful.
+ *
+ * **Key Features:**
+ * - ACID compliance for data integrity
+ * - Durable storage that survives restarts
+ * - JSON/JSONB support for complex objects
+ * - TTL-based automatic expiration
+ * - Connection pooling for performance
+ * - Transaction support for complex operations
+ *
+ * **Storage Schema:**
+ * - Table: nuvex_storage
+ * - Columns: id, key (unique), value (JSONB), expires_at, created_at, updated_at
+ * - Indexes: key, expires_at, key pattern (trigram)
+ *
+ * **Performance Characteristics:**
+ * - Get: O(log n) with index lookup
+ * - Set: O(log n) with index update
+ * - Latency: 5-50ms typical (storage + network)
+ *
+ * **Error Handling:**
+ * - Returns null on read errors (graceful degradation)
+ * - Logs errors for monitoring
+ * - Throws on critical connection failures
+ *
+ * @implements {StorageLayerInterface}
+ *
+ * @example
+ * ```typescript
+ * // Create PostgreSQL layer
+ * const postgres = new PostgresStorage({
+ *   host: 'localhost',
+ *   port: 5432,
+ *   database: 'myapp',
+ *   user: 'postgres',
+ *   password: 'password'
+ * });
+ *
+ * // Connect (creates pool)
+ * await postgres.connect();
+ *
+ * // Store data (source of truth)
+ * await postgres.set('user:123', userData, 86400);
+ *
+ * // Retrieve data
+ * const data = await postgres.get('user:123');
+ *
+ * // Check health
+ * const isHealthy = await postgres.ping();
+ * ```
+ *
+ * @class PostgresStorage
+ * @since 1.0.0
+ */
+export class PostgresStorage {
+    /**
+     * Creates a new PostgresStorage instance
+     *
+     * Accepts either a PostgreSQL configuration object or an existing Pool instance.
+     * If a Pool is provided, the caller is responsible for managing its lifecycle.
+     *
+     * Schema configuration is extracted from the config object when creating a new pool.
+     * When using an existing pool, schema defaults to standard Nuvex naming.
+     *
+     * @param config - PostgreSQL configuration or existing Pool instance
+     * @param logger - Optional logger for debugging
+     *
+     * @example
+     * ```typescript
+     * // With configuration (supports schema customization)
+     * const postgres = new PostgresStorage({
+     *   host: 'localhost',
+     *   database: 'myapp',
+     *   user: 'postgres',
+     *   password: 'password',
+     *   schema: {
+     *     tableName: 'storage_cache',
+     *     columns: { key: 'key', value: 'value' }
+     *   }
+     * });
+     *
+     * // With existing pool (uses default schema)
+     * const existingPool = new Pool({ ... });
+     * const postgres = new PostgresStorage(existingPool);
+     * ```
+     */
+    constructor(config, logger = null) {
+        this.config = config;
+        this.pool = null;
+        this.connected = false;
+        this.logger = logger;
+        // Check if config is already a Pool instance
+        this.ownsPool = !('query' in config && typeof config.query === 'function');
+        // Extract schema configuration with defaults
+        // Note: Schema is only extracted from config objects, not from existing Pool instances
+        const schema = this.ownsPool ? config.schema : undefined;
+        this.tableName = schema?.tableName ?? 'nuvex_storage';
+        this.keyColumn = schema?.columns?.key ?? 'nuvex_key';
+        this.valueColumn = schema?.columns?.value ?? 'nuvex_data';
+        // Validate all identifiers to prevent SQL injection
+        validateSQLIdentifier(this.tableName, 'table name');
+        validateSQLIdentifier(this.keyColumn, 'key column name');
+        validateSQLIdentifier(this.valueColumn, 'value column name');
+    }
+    /**
+     * Establish connection to PostgreSQL
+     *
+     * Creates a connection pool (if not already provided) and tests the connection.
+     * Should be called before any storage operations.
+     *
+     * @throws {Error} If connection test fails
+     *
+     * @example
+     * ```typescript
+     * try {
+     *   await postgres.connect();
+     *   console.log('PostgreSQL connected');
+     * } catch (error) {
+     *   console.error('PostgreSQL connection failed:', error);
+     * }
+     * ```
+     */
+    async connect() {
+        try {
+            if (this.ownsPool) {
+                // Create new pool from config
+                this.pool = new Pool(this.config);
+            }
+            else {
+                // Use existing pool
+                this.pool = this.config;
+            }
+            // Test connection
+            if (this.pool) {
+                await this.pool.query('SELECT 1');
+                this.connected = true;
+                this.log('info', 'PostgreSQL L3: Connected successfully');
+            }
+        }
+        catch (error) {
+            this.connected = false;
+            this.log('error', 'PostgreSQL L3: Connection failed', {
+                error: error instanceof Error ? error.message : String(error)
+            });
+            throw error;
+        }
+    }
+    /**
+     * Close PostgreSQL connection pool
+     *
+     * Only closes the pool if we created it. If an existing pool was provided,
+     * the caller is responsible for closing it.
+     *
+     * @example
+     * ```typescript
+     * await postgres.disconnect();
+     * ```
+     */
+    async disconnect() {
+        if (this.pool && this.ownsPool) {
+            await this.pool.end();
+            this.log('info', 'PostgreSQL L3: Disconnected');
+        }
+        this.connected = false;
+    }
+    /**
+     * Retrieve a value from PostgreSQL
+     *
+     * Queries the nuvex_storage table and automatically filters out expired entries.
+     * Deserializes the JSON-stored value.
+     *
+     * @param key - The key to retrieve
+     * @returns Promise resolving to the value or null if not found/expired
+     *
+     * @example
+     * ```typescript
+     * const userData = await postgres.get('user:123');
+     * if (userData !== null) {
+     *   console.log('Found in PostgreSQL');
+     * }
+     * ```
+     */
+    async get(key) {
+        if (!this.connected || !this.pool) {
+            return null;
+        }
+        try {
+            const result = await this.pool.query(`SELECT ${this.valueColumn} FROM ${this.tableName} WHERE ${this.keyColumn} = $1 AND (expires_at IS NULL OR expires_at > NOW())`, [key]);
+            if (result.rows.length === 0) {
+                return null;
+            }
+            // Value is already parsed by PostgreSQL JSONB type
+            return result.rows[0][this.valueColumn];
+        }
+        catch (error) {
+            // Table might not exist yet, that's okay
+            this.log('debug', `PostgreSQL L3: Error getting key: ${key}`, {
+                error: error instanceof Error ? error.message : String(error)
+            });
+            return null;
+        }
+    }
+    /**
+     * Store a value in PostgreSQL
+     *
+     * Inserts or updates the value in the nuvex_storage table. Uses UPSERT
+     * (INSERT ... ON CONFLICT) to handle existing keys efficiently.
+     *
+     * **Note:** This is the authoritative write. If this fails, the entire
+     * write operation should be considered failed.
+     *
+     * @param key - The key to store
+     * @param value - The value to store (will be JSON serialized)
+     * @param ttlSeconds - Optional TTL in seconds
+     *
+     * @example
+     * ```typescript
+     * // Store with 24 hour TTL
+     * await postgres.set('user:123', userData, 86400);
+     *
+     * // Store without TTL (persists until deleted)
+     * await postgres.set('config:app', configData);
+     * ```
+     */
+    async set(key, value, ttlSeconds) {
+        if (!this.connected || !this.pool) {
+            this.log('warn', 'PostgreSQL L3: Cannot set - not connected', { key });
+            throw new Error('PostgreSQL not connected');
+        }
+        try {
+            const expiresAt = ttlSeconds ? new Date(Date.now() + (ttlSeconds * 1000)) : null;
+            await this.pool.query(`INSERT INTO ${this.tableName} (${this.keyColumn}, ${this.valueColumn}, expires_at) 
+         VALUES ($1, $2, $3)
+         ON CONFLICT (${this.keyColumn}) 
+         DO UPDATE SET ${this.valueColumn} = $2, expires_at = $3, updated_at = NOW()`, [key, JSON.stringify(value), expiresAt]);
+        }
+        catch (error) {
+            // If table doesn't exist, this is a critical error for L3
+            this.log('error', `PostgreSQL L3: Error setting key: ${key}`, {
+                error: error instanceof Error ? error.message : String(error)
+            });
+            throw error;
+        }
+    }
+    /**
+     * Delete a value from PostgreSQL
+     *
+     * Permanently removes the key from the nuvex_storage table.
+     *
+     * @param key - The key to delete
+     *
+     * @example
+     * ```typescript
+     * await postgres.delete('user:123');
+     * ```
+     */
+    async delete(key) {
+        if (!this.connected || !this.pool) {
+            return;
+        }
+        try {
+            await this.pool.query(`DELETE FROM ${this.tableName} WHERE ${this.keyColumn} = $1`, [key]);
+        }
+        catch (error) {
+            this.log('error', `PostgreSQL L3: Error deleting key: ${key}`, {
+                error: error instanceof Error ? error.message : String(error)
+            });
+        }
+    }
+    /**
+     * Check if a key exists in PostgreSQL
+     *
+     * Queries for the key and verifies it hasn't expired.
+     *
+     * @param key - The key to check
+     * @returns Promise resolving to true if the key exists and is not expired
+     *
+     * @example
+     * ```typescript
+     * if (await postgres.exists('user:123')) {
+     *   console.log('Key exists in PostgreSQL');
+     * }
+     * ```
+     */
+    async exists(key) {
+        if (!this.connected || !this.pool) {
+            return false;
+        }
+        try {
+            const result = await this.pool.query(`SELECT 1 FROM ${this.tableName} WHERE ${this.keyColumn} = $1 AND (expires_at IS NULL OR expires_at > NOW())`, [key]);
+            return result.rows.length > 0;
+        }
+        catch (error) {
+            this.log('error', `PostgreSQL L3: Error checking existence: ${key}`, {
+                error: error instanceof Error ? error.message : String(error)
+            });
+            return false;
+        }
+    }
+    /**
+     * Clear all keys from PostgreSQL
+     *
+     * **WARNING:** This operation deletes all data from nuvex_storage table.
+     * Use with extreme caution in production environments.
+     *
+     * @example
+     * ```typescript
+     * await postgres.clear(); // Deletes all data
+     * ```
+     */
+    async clear() {
+        if (!this.connected || !this.pool) {
+            return;
+        }
+        try {
+            await this.pool.query(`DELETE FROM ${this.tableName}`);
+            this.log('info', 'PostgreSQL L3: All data cleared');
+        }
+        catch (error) {
+            this.log('error', 'PostgreSQL L3: Error clearing data', {
+                error: error instanceof Error ? error.message : String(error)
+            });
+        }
+    }
+    /**
+     * Health check for PostgreSQL connection
+     *
+     * Executes a simple SELECT 1 query to verify connectivity and database
+     * responsiveness. This is a lightweight operation that tests the full
+     * connection path including pool, connection, and database.
+     *
+     * @returns Promise resolving to true if PostgreSQL is healthy and responsive
+     *
+     * @example
+     * ```typescript
+     * const isHealthy = await postgres.ping();
+     * if (!isHealthy) {
+     *   console.error('PostgreSQL connection is down');
+     * }
+     * ```
+     */
+    async ping() {
+        if (!this.connected || !this.pool) {
+            return false;
+        }
+        let client;
+        try {
+            // Get a client from the pool and run a simple query
+            client = await this.pool.connect();
+            try {
+                await client.query('SELECT 1');
+                return true;
+            }
+            finally {
+                client.release();
+            }
+        }
+        catch (error) {
+            this.log('error', 'PostgreSQL L3: Ping failed', {
+                error: error instanceof Error ? error.message : String(error)
+            });
+            return false;
+        }
+    }
+    /**
+     * Check if PostgreSQL is connected
+     *
+     * @returns True if connected
+     */
+    isConnected() {
+        return this.connected;
+    }
+    /**
+     * Get the PostgreSQL connection pool
+     *
+     * Useful for executing custom queries or transactions.
+     *
+     * @returns The connection pool or null if not connected
+     *
+     * @example
+     * ```typescript
+     * const pool = postgres.getPool();
+     * if (pool) {
+     *   const result = await pool.query('SELECT * FROM custom_table');
+     * }
+     * ```
+     */
+    getPool() {
+        return this.pool;
+    }
+    /**
+     * Atomically increment a numeric value
+     *
+     * Uses PostgreSQL UPDATE with row-level locking for true atomic increments.
+     * If the key doesn't exist, it's created with the delta value.
+     *
+     * This operation is safe for concurrent access across multiple instances.
+     *
+     * @param key - The key to increment
+     * @param delta - The amount to increment by
+     * @param ttlSeconds - Optional TTL in seconds
+     * @returns Promise resolving to the new value after increment
+     *
+     * @example
+     * ```typescript
+     * // Atomic increment - safe for concurrent access
+     * const newValue = await postgres.increment('counter', 1, 86400);
+     * ```
+     */
+    async increment(key, delta, ttlSeconds) {
+        if (!this.connected || !this.pool) {
+            this.log('warn', 'PostgreSQL L3: Cannot increment - not connected', { key });
+            throw new Error('PostgreSQL not connected');
+        }
+        try {
+            const expiresAt = ttlSeconds ? new Date(Date.now() + (ttlSeconds * 1000)) : null;
+            // Atomic upsert to handle both insert and update cases
+            // This avoids race conditions when multiple concurrent increments happen on non-existent keys
+            const result = await this.pool.query(`INSERT INTO ${this.tableName} (${this.keyColumn}, ${this.valueColumn}, expires_at)
+         VALUES ($1, to_jsonb($2), $3)
+         ON CONFLICT (${this.keyColumn}) DO UPDATE
+           SET ${this.valueColumn} = to_jsonb(
+                 CASE 
+                   WHEN ${this.tableName}.expires_at IS NULL OR ${this.tableName}.expires_at > NOW()
+                   THEN (${this.tableName}.${this.valueColumn}::text)::numeric + (EXCLUDED.${this.valueColumn}::text)::numeric
+                   ELSE (EXCLUDED.${this.valueColumn}::text)::numeric
+                 END
+               ),
+               expires_at = EXCLUDED.expires_at,
+               updated_at = NOW()
+         RETURNING (${this.valueColumn}::text)::numeric as value`, [key, delta, expiresAt]);
+            if (result.rows.length > 0) {
+                return Number(result.rows[0].value);
+            }
+            // Fallback: should not reach here, but return delta if no rows returned
+            return delta;
+        }
+        catch (error) {
+            this.log('error', `PostgreSQL L3: Error incrementing key: ${key}`, {
+                error: error instanceof Error ? error.message : String(error)
+            });
+            throw error;
+        }
+    }
+    /**
+     * Log a message if logger is configured
+     *
+     * @private
+     * @param level - Log level
+     * @param message - Log message
+     * @param meta - Optional metadata
+     */
+    log(level, message, meta) {
+        if (this.logger) {
+            this.logger[level](message, meta);
+        }
+    }
+}
+//# sourceMappingURL=postgres.js.map

package/dist/esm/layers/postgres.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.js","sourceRoot":"","sources":["../../../src/layers/postgres.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,GAAG,MAAM,IAAI,CAAC;AACrB,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC;AAIrB,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,MAAM,OAAO,eAAe;IAyB1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,YAAY,MAAiC,EAAE,SAAwB,IAAI;QACzE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,6CAA6C;QAC7C,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,OAAO,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC;QAE3E,6CAA6C;QAC7C,uFAAuF;QACvF,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAE,MAAyB,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;QAC7E,IAAI,CAAC,SAAS,GAAG,MAAM,EAAE,SAAS,IAAI,eAAe,CAAC;QACtD,IAAI,CAAC,SAAS,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,WAAW,CAAC;QACrD,IAAI,CAAC,WAAW,GAAG,MAAM,EAAE,OAAO,EAAE,KAAK,IAAI,YAAY,CAAC;QAE1D,oDAAoD;QACpD,qBAAqB,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QACpD,qBAAqB,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;QACzD,qBAAqB,CAAC,IAAI,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC;IAC/D,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,KAAK,CAAC,OAAO;QACX,IAAI,CAAC;YACH,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,8BAA8B;gBAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,MAAwB,CAAC,CAAC;YACtD,CAAC;iBAAM,CAAC;gBACN,oBAAoB;gBACpB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,MAAkB,CAAC;YACtC,CAAC;YAED,kBAAkB;YAClB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;gBAClC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;gBACtB,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,uCAAuC,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;YACvB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,kCAAkC,EAAE;gBACpD,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC,CAAC;YACH,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC/B,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YACtB,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,6BAA6B,CAAC,CAAC;QAClD,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;IACzB,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAClC,UAAU,IAAI,CAAC,WAAW,SAAS,IAAI,CAAC,SAAS,UAAU,IAAI,CAAC,SAAS,sDAAsD,EAC/H,CAAC,GAAG,CAAC,CACN,CAAC;YAEF,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC7B,OAAO,IAAI,CAAC;YACd,CAAC;YAED,mDAAmD;YACnD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,yCAAyC;YACzC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,qCAAqC,GAAG,EAAE,EAAE;gBAC5D,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAc,EAAE,UAAmB;QACxD,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAClC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,2CAA2C,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;YACvE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAEjF,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CACnB,eAAe,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,WAAW;;wBAErD,IAAI,CAAC,SAAS;yBACb,IAAI,CAAC,WAAW,4CAA4C,EAC7E,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,CACxC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,0DAA0D;YAC1D,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,qCAAqC,GAAG,EAAE,EAAE;gBAC5D,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC,CAAC;YACH,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAClC,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,IAAI,CAAC,SAAS,UAAU,IAAI,CAAC,SAAS,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7F,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,sCAAsC,GAAG,EAAE,EAAE;gBAC7D,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAClC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAClC,iBAAiB,IAAI,CAAC,SAAS,UAAU,IAAI,CAAC,SAAS,sDAAsD,EAC7G,CAAC,GAAG,CAAC,CACN,CAAC;YAEF,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,4CAA4C,GAAG,EAAE,EAAE;gBACnE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC,CAAC;YACH,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAClC,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;YACvD,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,iCAAiC,CAAC,CAAC;QACtD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,oCAAoC,EAAE;gBACtD,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAClC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,MAAM,CAAC;QACX,IAAI,CAAC;YACH,oDAAoD;YACpD,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACnC,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;gBAC/B,OAAO,IAAI,CAAC;YACd,CAAC;oBAAS,CAAC;gBACT,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,4BAA4B,EAAE;gBAC9C,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC,CAAC;YACH,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,KAAK,CAAC,SAAS,CAAC,GAAW,EAAE,KAAa,EAAE,UAAmB;QAC7D,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAClC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,iDAAiD,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;YAC7E,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAEjF,uDAAuD;YACvD,8FAA8F;YAC9F,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAClC,eAAe,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,WAAW;;wBAErD,IAAI,CAAC,SAAS;iBACrB,IAAI,CAAC,WAAW;;0BAEP,IAAI,CAAC,SAAS,0BAA0B,IAAI,CAAC,SAAS;2BACrD,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,WAAW,gCAAgC,IAAI,CAAC,WAAW;oCACzE,IAAI,CAAC,WAAW;;;;;sBAK9B,IAAI,CAAC,WAAW,2BAA2B,EACzD,CAAC,GAAG,EAAE,KAAK,EAAE,SAAS,CAAC,CACxB,CAAC;YAEF,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3B,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACtC,CAAC;YAED,wEAAwE;YACxE,OAAO,KAAK,CAAC;QACf,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,0CAA0C,GAAG,EAAE,EAAE;gBACjE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC,CAAC;YACH,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACK,GAAG,CAAC,KAA0C,EAAE,OAAe,EAAE,IAA8B;QACrG,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;CACF"}