@dotdo/postgres 0.1.0

package/dist/streaming/live-cdc-stream.js.map

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

package/dist/streaming/memory-bounded-stream.d.ts

@@ -0,0 +1,207 @@
+/**
+ * MemoryBoundedStream - Stream with configurable memory limits
+ *
+ * Wraps async iterables with memory tracking and bounded buffering,
+ * preventing OOM by pausing producers when memory limits are reached.
+ *
+ * ## How It Works
+ *
+ * MemoryBoundedStream sits between a producer (e.g., QueryStreamer) and a
+ * consumer, tracking memory usage and applying backpressure when limits
+ * are approached.
+ *
+ * ```
+ * Producer -> MemoryBoundedStream -> Consumer
+ *                |
+ *                +-- Tracks memory
+ *                +-- Pauses when highWaterMark exceeded
+ *                +-- Resumes when lowWaterMark reached
+ *                +-- Throws OOM if memoryLimit exceeded
+ * ```
+ *
+ * ## Water Mark System
+ *
+ * - **highWaterMark**: When memory exceeds this, iteration pauses
+ * - **lowWaterMark**: When memory drops below this, iteration resumes
+ * - **memoryLimit**: Hard limit that throws StreamingOOMError
+ *
+ * The gap between high and low water marks prevents thrashing (rapid
+ * pause/resume cycles).
+ *
+ * @module streaming/memory-bounded-stream
+ */
+import { type Row } from './query-streamer';
+/**
+ * Configuration for MemoryBoundedStream
+ */
+export interface MemoryBoundedStreamConfig {
+    /** Maximum memory limit in bytes (default: 50MB) */
+    memoryLimit?: number;
+    /** High water mark - pause when reached (default: 10MB) */
+    highWaterMark?: number;
+    /** Low water mark - resume when below (default: 5MB) */
+    lowWaterMark?: number;
+    /** Custom size estimator function for items */
+    sizeEstimator?: (item: unknown) => number;
+    /** Callback when memory pressure is detected (highWaterMark exceeded) */
+    onMemoryPressure?: () => void | Promise<void>;
+    /** Callback when memory is released (dropped below lowWaterMark) */
+    onMemoryRelease?: () => void | Promise<void>;
+}
+/**
+ * Memory statistics for monitoring stream health
+ */
+export interface MemoryStats {
+    /** Current memory usage in bytes */
+    currentUsage: number;
+    /** Peak memory usage seen during stream lifetime */
+    peakUsage: number;
+    /** Number of items that have passed through the stream */
+    itemsProcessed: number;
+    /** Number of times pause was triggered due to memory pressure */
+    pauseCount: number;
+    /** Number of times resume was triggered after memory release */
+    resumeCount: number;
+    /** Whether the stream is currently paused */
+    isPaused: boolean;
+}
+/**
+ * MemoryBoundedStream wraps an async iterable with memory tracking.
+ *
+ * Implements backpressure by pausing iteration when memory limits are reached,
+ * ensuring memory usage stays bounded regardless of producer speed.
+ *
+ * ## Memory Tracking
+ *
+ * The stream estimates memory usage using a configurable sizeEstimator function.
+ * By default, this uses JSON.stringify() which provides a reasonable approximation
+ * for most data types.
+ *
+ * ## Automatic vs Manual Release
+ *
+ * The stream automatically releases memory after each yield. For scenarios where
+ * the consumer holds references to items (e.g., accumulating in an array), use
+ * the release() method to manually signal when items are no longer needed.
+ *
+ * @example Basic usage
+ * ```typescript
+ * const source = generateLargeDataset()
+ * const bounded = new MemoryBoundedStream(source, {
+ *   memoryLimit: 10 * 1024 * 1024, // 10MB
+ * })
+ *
+ * for await (const item of bounded) {
+ *   await processItem(item)
+ * }
+ *
+ * console.log('Peak memory:', bounded.getStats().peakUsage)
+ * ```
+ *
+ * @example With callbacks
+ * ```typescript
+ * const bounded = new MemoryBoundedStream(source, {
+ *   highWaterMark: 5 * 1024 * 1024,
+ *   onMemoryPressure: () => console.log('Memory pressure detected'),
+ *   onMemoryRelease: () => console.log('Memory pressure relieved'),
+ * })
+ * ```
+ */
+export declare class MemoryBoundedStream<T = Row> implements AsyncIterable<T> {
+    private readonly source;
+    private readonly config;
+    private currentUsage;
+    private peakUsage;
+    private itemsProcessed;
+    private pauseCount;
+    private resumeCount;
+    private isPaused;
+    private resolveResume;
+    /**
+     * Create a new MemoryBoundedStream.
+     *
+     * @param source - Source async iterable to wrap
+     * @param config - Memory bounds configuration
+     */
+    constructor(source: AsyncIterable<T>, config?: MemoryBoundedStreamConfig);
+    /**
+     * Track memory allocation for an item.
+     * @internal
+     */
+    private trackAllocation;
+    /**
+     * Wait for memory to be released when paused.
+     * @internal
+     */
+    private waitForResume;
+    /**
+     * Manually release memory for a processed item.
+     *
+     * Call this when the consumer is holding references to items and
+     * automatic memory release after yield is not sufficient.
+     *
+     * @param item - The item to release memory for
+     */
+    release(item: T): void;
+    /**
+     * Get current memory statistics for monitoring.
+     */
+    getStats(): MemoryStats;
+    /**
+     * Get current estimated memory usage in bytes.
+     */
+    getMemoryUsage(): number;
+    /**
+     * Check if currently under memory pressure (above high water mark).
+     */
+    isUnderMemoryPressure(): boolean;
+    /**
+     * Abort streaming and throw OOM error.
+     * Use this to proactively abort when external memory pressure is detected.
+     */
+    abortOnMemoryPressure(): Promise<never>;
+    /**
+     * Reset statistics while preserving current state.
+     * Useful for monitoring memory usage across multiple operations.
+     */
+    resetStats(): void;
+    /**
+     * Iterate over the source with memory tracking.
+     *
+     * Memory is automatically released after each yield. For scenarios
+     * where the consumer holds references, call release() manually.
+     */
+    [Symbol.asyncIterator](): AsyncGenerator<T>;
+    /**
+     * Create a batched version of this stream.
+     *
+     * Groups items into arrays of the specified size, which can be more
+     * efficient for bulk operations.
+     *
+     * @param size - Maximum number of items per batch
+     * @returns A new MemoryBoundedStream yielding arrays of items
+     */
+    batch(size: number): MemoryBoundedStream<T[]>;
+}
+/**
+ * Create a memory-bounded wrapper for an async iterable.
+ *
+ * This is a convenience function that creates a new MemoryBoundedStream.
+ *
+ * @param source - Source async iterable to wrap
+ * @param config - Memory bounds configuration (optional)
+ * @returns A new MemoryBoundedStream
+ *
+ * @example
+ * ```typescript
+ * const bounded = createMemoryBoundedStream(generateRows(), {
+ *   memoryLimit: 10 * 1024 * 1024,
+ * })
+ *
+ * for await (const row of bounded) {
+ *   await processRow(row)
+ * }
+ * ```
+ */
+export declare function createMemoryBoundedStream<T>(source: AsyncIterable<T>, config?: MemoryBoundedStreamConfig): MemoryBoundedStream<T>;
+export type { Row };
+//# sourceMappingURL=memory-bounded-stream.d.ts.map

package/dist/streaming/memory-bounded-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-bounded-stream.d.ts","sourceRoot":"","sources":["../../src/streaming/memory-bounded-stream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EAAE,KAAK,GAAG,EAAqB,MAAM,kBAAkB,CAAA;AAM9D;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,+CAA+C;IAC/C,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,CAAA;IACzC,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7C,oEAAoE;IACpE,eAAe,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAA;IACpB,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAA;IACjB,0DAA0D;IAC1D,cAAc,EAAE,MAAM,CAAA;IACtB,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAA;IAClB,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAA;IACnB,6CAA6C;IAC7C,QAAQ,EAAE,OAAO,CAAA;CAClB;AAmDD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,qBAAa,mBAAmB,CAAC,CAAC,GAAG,GAAG,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;IACnE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,YAAY,CAAI;IACxB,OAAO,CAAC,SAAS,CAAI;IACrB,OAAO,CAAC,cAAc,CAAI;IAC1B,OAAO,CAAC,UAAU,CAAI;IACtB,OAAO,CAAC,WAAW,CAAI;IACvB,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,aAAa,CAA4B;IAEjD;;;;;OAKG;gBACS,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,GAAE,yBAA8B;IA6B5E;;;OAGG;YACW,eAAe;IAmB7B;;;OAGG;YACW,aAAa;IAY3B;;;;;;;OAOG;IACH,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAmBtB;;OAEG;IACH,QAAQ,IAAI,WAAW;IAWvB;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,qBAAqB,IAAI,OAAO;IAIhC;;;OAGG;IACG,qBAAqB,IAAI,OAAO,CAAC,KAAK,CAAC;IAW7C;;;OAGG;IACH,UAAU,IAAI,IAAI;IAWlB;;;;;OAKG;IACI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC;IA8BlD;;;;;;;;OAQG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAAC,CAAC,EAAE,CAAC;CA4B9C;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,EACzC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EACxB,MAAM,CAAC,EAAE,yBAAyB,GACjC,mBAAmB,CAAC,CAAC,CAAC,CAExB;AAGD,YAAY,EAAE,GAAG,EAAE,CAAA"}

package/dist/streaming/memory-bounded-stream.js

@@ -0,0 +1,340 @@
+/**
+ * MemoryBoundedStream - Stream with configurable memory limits
+ *
+ * Wraps async iterables with memory tracking and bounded buffering,
+ * preventing OOM by pausing producers when memory limits are reached.
+ *
+ * ## How It Works
+ *
+ * MemoryBoundedStream sits between a producer (e.g., QueryStreamer) and a
+ * consumer, tracking memory usage and applying backpressure when limits
+ * are approached.
+ *
+ * ```
+ * Producer -> MemoryBoundedStream -> Consumer
+ *                |
+ *                +-- Tracks memory
+ *                +-- Pauses when highWaterMark exceeded
+ *                +-- Resumes when lowWaterMark reached
+ *                +-- Throws OOM if memoryLimit exceeded
+ * ```
+ *
+ * ## Water Mark System
+ *
+ * - **highWaterMark**: When memory exceeds this, iteration pauses
+ * - **lowWaterMark**: When memory drops below this, iteration resumes
+ * - **memoryLimit**: Hard limit that throws StreamingOOMError
+ *
+ * The gap between high and low water marks prevents thrashing (rapid
+ * pause/resume cycles).
+ *
+ * @module streaming/memory-bounded-stream
+ */
+import { StreamingOOMError } from './query-streamer';
+// ============================================================================
+// Imported Configuration
+// ============================================================================
+import { DEFAULT_STREAMING_MEMORY_LIMIT, DEFAULT_HIGH_WATER_MARK, DEFAULT_LOW_WATER_MARK, } from '../config/streaming';
+// ============================================================================
+// Local Aliases (for backward compatibility)
+// ============================================================================
+/** Default memory limit (50MB) */
+const DEFAULT_MEMORY_LIMIT = DEFAULT_STREAMING_MEMORY_LIMIT;
+/**
+ * Default size estimator using JSON serialization.
+ * Falls back to 1KB for items that can't be serialized.
+ */
+function defaultSizeEstimator(item) {
+    try {
+        return JSON.stringify(item).length;
+    }
+    catch {
+        return 1024;
+    }
+}
+// ============================================================================
+// MemoryBoundedStream Class
+// ============================================================================
+/**
+ * MemoryBoundedStream wraps an async iterable with memory tracking.
+ *
+ * Implements backpressure by pausing iteration when memory limits are reached,
+ * ensuring memory usage stays bounded regardless of producer speed.
+ *
+ * ## Memory Tracking
+ *
+ * The stream estimates memory usage using a configurable sizeEstimator function.
+ * By default, this uses JSON.stringify() which provides a reasonable approximation
+ * for most data types.
+ *
+ * ## Automatic vs Manual Release
+ *
+ * The stream automatically releases memory after each yield. For scenarios where
+ * the consumer holds references to items (e.g., accumulating in an array), use
+ * the release() method to manually signal when items are no longer needed.
+ *
+ * @example Basic usage
+ * ```typescript
+ * const source = generateLargeDataset()
+ * const bounded = new MemoryBoundedStream(source, {
+ *   memoryLimit: 10 * 1024 * 1024, // 10MB
+ * })
+ *
+ * for await (const item of bounded) {
+ *   await processItem(item)
+ * }
+ *
+ * console.log('Peak memory:', bounded.getStats().peakUsage)
+ * ```
+ *
+ * @example With callbacks
+ * ```typescript
+ * const bounded = new MemoryBoundedStream(source, {
+ *   highWaterMark: 5 * 1024 * 1024,
+ *   onMemoryPressure: () => console.log('Memory pressure detected'),
+ *   onMemoryRelease: () => console.log('Memory pressure relieved'),
+ * })
+ * ```
+ */
+export class MemoryBoundedStream {
+    source;
+    config;
+    currentUsage = 0;
+    peakUsage = 0;
+    itemsProcessed = 0;
+    pauseCount = 0;
+    resumeCount = 0;
+    isPaused = false;
+    resolveResume = null;
+    /**
+     * Create a new MemoryBoundedStream.
+     *
+     * @param source - Source async iterable to wrap
+     * @param config - Memory bounds configuration
+     */
+    constructor(source, config = {}) {
+        this.source = source;
+        const memoryLimit = config.memoryLimit ?? DEFAULT_MEMORY_LIMIT;
+        const highWaterMark = config.highWaterMark ?? DEFAULT_HIGH_WATER_MARK;
+        const lowWaterMark = config.lowWaterMark ?? DEFAULT_LOW_WATER_MARK;
+        // Validate configuration
+        if (lowWaterMark >= highWaterMark) {
+            throw new Error('lowWaterMark must be less than highWaterMark');
+        }
+        if (highWaterMark >= memoryLimit) {
+            throw new Error('highWaterMark must be less than memoryLimit');
+        }
+        this.config = {
+            memoryLimit,
+            highWaterMark,
+            lowWaterMark,
+            sizeEstimator: config.sizeEstimator ?? defaultSizeEstimator,
+            onMemoryPressure: config.onMemoryPressure ?? (() => { }),
+            onMemoryRelease: config.onMemoryRelease ?? (() => { }),
+        };
+    }
+    // ============================================================================
+    // Internal Memory Management
+    // ============================================================================
+    /**
+     * Track memory allocation for an item.
+     * @internal
+     */
+    async trackAllocation(size) {
+        this.currentUsage += size;
+        if (this.currentUsage > this.peakUsage) {
+            this.peakUsage = this.currentUsage;
+        }
+        // Check hard limit first
+        if (this.currentUsage > this.config.memoryLimit) {
+            throw new StreamingOOMError();
+        }
+        // Check if we should pause (high water mark)
+        if (!this.isPaused && this.currentUsage > this.config.highWaterMark) {
+            this.isPaused = true;
+            this.pauseCount++;
+            await this.config.onMemoryPressure();
+        }
+    }
+    /**
+     * Wait for memory to be released when paused.
+     * @internal
+     */
+    async waitForResume() {
+        if (!this.isPaused)
+            return;
+        return new Promise((resolve) => {
+            this.resolveResume = resolve;
+        });
+    }
+    // ============================================================================
+    // Public API
+    // ============================================================================
+    /**
+     * Manually release memory for a processed item.
+     *
+     * Call this when the consumer is holding references to items and
+     * automatic memory release after yield is not sufficient.
+     *
+     * @param item - The item to release memory for
+     */
+    release(item) {
+        const size = this.config.sizeEstimator(item);
+        this.currentUsage = Math.max(0, this.currentUsage - size);
+        this.itemsProcessed++;
+        // Check if we should resume (low water mark)
+        if (this.isPaused && this.currentUsage < this.config.lowWaterMark) {
+            this.isPaused = false;
+            this.resumeCount++;
+            this.config.onMemoryRelease();
+            // Signal to resume if waiting
+            if (this.resolveResume) {
+                this.resolveResume();
+                this.resolveResume = null;
+            }
+        }
+    }
+    /**
+     * Get current memory statistics for monitoring.
+     */
+    getStats() {
+        return {
+            currentUsage: this.currentUsage,
+            peakUsage: this.peakUsage,
+            itemsProcessed: this.itemsProcessed,
+            pauseCount: this.pauseCount,
+            resumeCount: this.resumeCount,
+            isPaused: this.isPaused,
+        };
+    }
+    /**
+     * Get current estimated memory usage in bytes.
+     */
+    getMemoryUsage() {
+        return this.currentUsage;
+    }
+    /**
+     * Check if currently under memory pressure (above high water mark).
+     */
+    isUnderMemoryPressure() {
+        return this.currentUsage > this.config.highWaterMark;
+    }
+    /**
+     * Abort streaming and throw OOM error.
+     * Use this to proactively abort when external memory pressure is detected.
+     */
+    async abortOnMemoryPressure() {
+        // Reset state before throwing
+        this.currentUsage = 0;
+        this.isPaused = false;
+        if (this.resolveResume) {
+            this.resolveResume();
+            this.resolveResume = null;
+        }
+        throw new StreamingOOMError();
+    }
+    /**
+     * Reset statistics while preserving current state.
+     * Useful for monitoring memory usage across multiple operations.
+     */
+    resetStats() {
+        this.peakUsage = this.currentUsage;
+        this.itemsProcessed = 0;
+        this.pauseCount = 0;
+        this.resumeCount = 0;
+    }
+    // ============================================================================
+    // Async Iteration
+    // ============================================================================
+    /**
+     * Iterate over the source with memory tracking.
+     *
+     * Memory is automatically released after each yield. For scenarios
+     * where the consumer holds references, call release() manually.
+     */
+    async *[Symbol.asyncIterator]() {
+        for await (const item of this.source) {
+            // Wait if paused due to memory pressure
+            await this.waitForResume();
+            // Track memory allocation
+            const size = this.config.sizeEstimator(item);
+            await this.trackAllocation(size);
+            yield item;
+            // Auto-release: assume item is no longer referenced after yield
+            this.currentUsage = Math.max(0, this.currentUsage - size);
+            this.itemsProcessed++;
+            // Check if we should resume (below low water mark)
+            if (this.isPaused && this.currentUsage < this.config.lowWaterMark) {
+                this.isPaused = false;
+                this.resumeCount++;
+                this.config.onMemoryRelease();
+                // Signal to resume if waiting
+                if (this.resolveResume) {
+                    this.resolveResume();
+                    this.resolveResume = null;
+                }
+            }
+        }
+    }
+    /**
+     * Create a batched version of this stream.
+     *
+     * Groups items into arrays of the specified size, which can be more
+     * efficient for bulk operations.
+     *
+     * @param size - Maximum number of items per batch
+     * @returns A new MemoryBoundedStream yielding arrays of items
+     */
+    batch(size) {
+        if (size <= 0) {
+            throw new Error('Batch size must be positive');
+        }
+        const source = this.source;
+        const config = this.config;
+        async function* batchGenerator() {
+            let batch = [];
+            for await (const item of source) {
+                batch.push(item);
+                if (batch.length >= size) {
+                    yield batch;
+                    batch = [];
+                }
+            }
+            if (batch.length > 0) {
+                yield batch;
+            }
+        }
+        return new MemoryBoundedStream(batchGenerator(), {
+            memoryLimit: config.memoryLimit,
+            highWaterMark: config.highWaterMark,
+            lowWaterMark: config.lowWaterMark,
+        });
+    }
+}
+// ============================================================================
+// Factory Functions
+// ============================================================================
+/**
+ * Create a memory-bounded wrapper for an async iterable.
+ *
+ * This is a convenience function that creates a new MemoryBoundedStream.
+ *
+ * @param source - Source async iterable to wrap
+ * @param config - Memory bounds configuration (optional)
+ * @returns A new MemoryBoundedStream
+ *
+ * @example
+ * ```typescript
+ * const bounded = createMemoryBoundedStream(generateRows(), {
+ *   memoryLimit: 10 * 1024 * 1024,
+ * })
+ *
+ * for await (const row of bounded) {
+ *   await processRow(row)
+ * }
+ * ```
+ */
+export function createMemoryBoundedStream(source, config) {
+    return new MemoryBoundedStream(source, config);
+}
+//# sourceMappingURL=memory-bounded-stream.js.map

package/dist/streaming/memory-bounded-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-bounded-stream.js","sourceRoot":"","sources":["../../src/streaming/memory-bounded-stream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EAAY,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AA0C9D,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E,OAAO,EACL,8BAA8B,EAC9B,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,qBAAqB,CAAA;AAE5B,+EAA+E;AAC/E,6CAA6C;AAC7C,+EAA+E;AAE/E,kCAAkC;AAClC,MAAM,oBAAoB,GAAG,8BAA8B,CAAA;AAE3D;;;GAGG;AACH,SAAS,oBAAoB,CAAC,IAAa;IACzC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,MAAM,CAAA;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAkBD,+EAA+E;AAC/E,4BAA4B;AAC5B,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,MAAM,OAAO,mBAAmB;IACb,MAAM,CAAkB;IACxB,MAAM,CAAgB;IAC/B,YAAY,GAAG,CAAC,CAAA;IAChB,SAAS,GAAG,CAAC,CAAA;IACb,cAAc,GAAG,CAAC,CAAA;IAClB,UAAU,GAAG,CAAC,CAAA;IACd,WAAW,GAAG,CAAC,CAAA;IACf,QAAQ,GAAG,KAAK,CAAA;IAChB,aAAa,GAAwB,IAAI,CAAA;IAEjD;;;;;OAKG;IACH,YAAY,MAAwB,EAAE,SAAoC,EAAE;QAC1E,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QAEpB,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,oBAAoB,CAAA;QAC9D,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,IAAI,uBAAuB,CAAA;QACrE,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,sBAAsB,CAAA;QAElE,yBAAyB;QACzB,IAAI,YAAY,IAAI,aAAa,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;QACjE,CAAC;QACD,IAAI,aAAa,IAAI,WAAW,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;QAChE,CAAC;QAED,IAAI,CAAC,MAAM,GAAG;YACZ,WAAW;YACX,aAAa;YACb,YAAY;YACZ,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,oBAAoB;YAC3D,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;YACvD,eAAe,EAAE,MAAM,CAAC,eAAe,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;SACtD,CAAA;IACH,CAAC;IAED,+EAA+E;IAC/E,6BAA6B;IAC7B,+EAA+E;IAE/E;;;OAGG;IACK,KAAK,CAAC,eAAe,CAAC,IAAY;QACxC,IAAI,CAAC,YAAY,IAAI,IAAI,CAAA;QACzB,IAAI,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YACvC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,YAAY,CAAA;QACpC,CAAC;QAED,yBAAyB;QACzB,IAAI,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YAChD,MAAM,IAAI,iBAAiB,EAAE,CAAA;QAC/B,CAAC;QAED,6CAA6C;QAC7C,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;YACpE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;YACpB,IAAI,CAAC,UAAU,EAAE,CAAA;YACjB,MAAM,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAA;QACtC,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,aAAa;QACzB,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAM;QAE1B,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACnC,IAAI,CAAC,aAAa,GAAG,OAAO,CAAA;QAC9B,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,+EAA+E;IAC/E,aAAa;IACb,+EAA+E;IAE/E;;;;;;;OAOG;IACH,OAAO,CAAC,IAAO;QACb,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAA;QAC5C,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,CAAA;QACzD,IAAI,CAAC,cAAc,EAAE,CAAA;QAErB,6CAA6C;QAC7C,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;YAClE,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAA;YACrB,IAAI,CAAC,WAAW,EAAE,CAAA;YAClB,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAA;YAE7B,8BAA8B;YAC9B,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;gBACvB,IAAI,CAAC,aAAa,EAAE,CAAA;gBACpB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAA;YAC3B,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO;YACL,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAA;IACH,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,YAAY,CAAA;IAC1B,CAAC;IAED;;OAEG;IACH,qBAAqB;QACnB,OAAO,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,CAAA;IACtD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,qBAAqB;QACzB,8BAA8B;QAC9B,IAAI,CAAC,YAAY,GAAG,CAAC,CAAA;QACrB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAA;QACrB,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,IAAI,CAAC,aAAa,EAAE,CAAA;YACpB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAA;QAC3B,CAAC;QACD,MAAM,IAAI,iBAAiB,EAAE,CAAA;IAC/B,CAAC;IAED;;;OAGG;IACH,UAAU;QACR,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,YAAY,CAAA;QAClC,IAAI,CAAC,cAAc,GAAG,CAAC,CAAA;QACvB,IAAI,CAAC,UAAU,GAAG,CAAC,CAAA;QACnB,IAAI,CAAC,WAAW,GAAG,CAAC,CAAA;IACtB,CAAC;IAED,+EAA+E;IAC/E,kBAAkB;IAClB,+EAA+E;IAE/E;;;;;OAKG;IACH,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC;QAC3B,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACrC,wCAAwC;YACxC,MAAM,IAAI,CAAC,aAAa,EAAE,CAAA;YAE1B,0BAA0B;YAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAA;YAC5C,MAAM,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;YAEhC,MAAM,IAAI,CAAA;YAEV,gEAAgE;YAChE,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,CAAA;YACzD,IAAI,CAAC,cAAc,EAAE,CAAA;YAErB,mDAAmD;YACnD,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;gBAClE,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAA;gBACrB,IAAI,CAAC,WAAW,EAAE,CAAA;gBAClB,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAA;gBAE7B,8BAA8B;gBAC9B,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;oBACvB,IAAI,CAAC,aAAa,EAAE,CAAA;oBACpB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAA;gBAC3B,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,IAAY;QAChB,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAA;QAChD,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;QAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;QAE1B,KAAK,SAAS,CAAC,CAAC,cAAc;YAC5B,IAAI,KAAK,GAAQ,EAAE,CAAA;YACnB,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;gBAChC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBAChB,IAAI,KAAK,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC;oBACzB,MAAM,KAAK,CAAA;oBACX,KAAK,GAAG,EAAE,CAAA;gBACZ,CAAC;YACH,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrB,MAAM,KAAK,CAAA;YACb,CAAC;QACH,CAAC;QAED,OAAO,IAAI,mBAAmB,CAAM,cAAc,EAAE,EAAE;YACpD,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,YAAY,EAAE,MAAM,CAAC,YAAY;SAClC,CAAC,CAAA;IACJ,CAAC;CACF;AAED,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAAwB,EACxB,MAAkC;IAElC,OAAO,IAAI,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAChD,CAAC"}