ai-database 0.1.0 → 0.2.0

package/dist/execution-queue.d.ts

@@ -0,0 +1,239 @@
+/**
+ * Execution Queue - Manages execution priority and batching
+ *
+ * The queue decides WHEN to execute based on priority, concurrency, and batch windows.
+ * Operations can be executed immediately, queued, or deferred to batch processing.
+ *
+ * @packageDocumentation
+ */
+import { DurablePromise, type ExecutionPriority, type BatchScheduler } from './durable-promise.js';
+/**
+ * Configuration for the execution queue
+ */
+export interface ExecutionQueueOptions {
+    /** Default execution priority */
+    priority?: ExecutionPriority;
+    /** Maximum concurrent operations per priority tier */
+    concurrency?: {
+        priority?: number;
+        standard?: number;
+        flex?: number;
+        batch?: number;
+    };
+    /** Batch window in milliseconds (how long to accumulate before flush) */
+    batchWindow?: number;
+    /** Maximum batch size before auto-flush */
+    maxBatchSize?: number;
+    /** Auto-flush at process exit */
+    flushOnExit?: boolean;
+}
+/**
+ * Stats for queue monitoring
+ */
+export interface QueueStats {
+    /** Counts by priority tier */
+    byPriority: Record<ExecutionPriority, {
+        pending: number;
+        active: number;
+        completed: number;
+    }>;
+    /** Total counts */
+    totals: {
+        pending: number;
+        active: number;
+        completed: number;
+        failed: number;
+    };
+    /** Current batch info */
+    batch: {
+        size: number;
+        nextFlush: Date | null;
+    };
+}
+/**
+ * Batch submission result from a provider
+ */
+export interface BatchSubmission {
+    /** Provider-assigned batch ID */
+    batchId: string;
+    /** Estimated completion time */
+    estimatedCompletion?: Date;
+    /** Number of requests in batch */
+    count: number;
+}
+/**
+ * Provider interface for batch submission
+ */
+export interface BatchProvider {
+    /** Provider name */
+    readonly name: string;
+    /** Whether this provider supports batch API */
+    readonly supportsBatch: boolean;
+    /** Whether this provider supports flex tier */
+    readonly supportsFlex: boolean;
+    /** Submit a batch of requests */
+    submitBatch(requests: BatchRequest[]): Promise<BatchSubmission>;
+    /** Get batch status */
+    getBatchStatus(batchId: string): Promise<BatchStatus>;
+    /** Stream results as they complete */
+    streamResults(batchId: string): AsyncIterable<BatchResult>;
+}
+/**
+ * A single request in a batch
+ */
+export interface BatchRequest {
+    /** Unique ID for matching results */
+    customId: string;
+    /** The action ID (for updating status) */
+    actionId: string;
+    /** Method being called */
+    method: string;
+    /** Request parameters */
+    params: unknown;
+}
+/**
+ * Status of a batch
+ */
+export interface BatchStatus {
+    /** Batch ID */
+    batchId: string;
+    /** Current status */
+    status: 'validating' | 'in_progress' | 'completed' | 'failed' | 'expired' | 'cancelled';
+    /** Completion counts */
+    counts: {
+        total: number;
+        completed: number;
+        failed: number;
+    };
+    /** Estimated completion */
+    estimatedCompletion?: Date;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * A single result from a batch
+ */
+export interface BatchResult {
+    /** Custom ID matching the request */
+    customId: string;
+    /** Action ID for updating status */
+    actionId: string;
+    /** Success or failure */
+    status: 'success' | 'error';
+    /** Result data (if success) */
+    result?: unknown;
+    /** Error details (if error) */
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+/**
+ * Manages execution of DurablePromises with priority-based scheduling
+ *
+ * @example
+ * ```ts
+ * const queue = new ExecutionQueue({
+ *   priority: 'standard',
+ *   concurrency: { standard: 10, batch: 1000 },
+ *   batchWindow: 60000, // 1 minute
+ * })
+ *
+ * // Register batch providers
+ * queue.registerProvider(openaiProvider)
+ * queue.registerProvider(claudeProvider)
+ *
+ * // Queue operations
+ * queue.enqueue(durablePromise)
+ *
+ * // Flush batch at end of workflow
+ * await queue.flush()
+ * ```
+ */
+export declare class ExecutionQueue implements BatchScheduler {
+    private readonly semaphores;
+    private readonly queues;
+    private readonly providers;
+    private readonly options;
+    private batchTimer;
+    private completedCount;
+    private failedCount;
+    private isProcessing;
+    constructor(options?: ExecutionQueueOptions);
+    /**
+     * Register a batch provider
+     */
+    registerProvider(provider: BatchProvider): void;
+    /**
+     * Get a registered provider
+     */
+    getProvider(name: string): BatchProvider | undefined;
+    /**
+     * List registered providers
+     */
+    listProviders(): BatchProvider[];
+    /**
+     * Add a promise to the execution queue
+     */
+    enqueue(promise: DurablePromise<unknown>): void;
+    private startBatchTimer;
+    private processQueue;
+    /**
+     * Flush all pending batch operations
+     */
+    flush(): Promise<void>;
+    private groupByProvider;
+    private getProviderFromMethod;
+    private submitToBatchProvider;
+    private executeFallback;
+    private pollBatchCompletion;
+    /**
+     * Set the default priority for new operations
+     */
+    setPriority(priority: ExecutionPriority): void;
+    /**
+     * Set concurrency limit for a priority tier
+     */
+    setConcurrency(priority: ExecutionPriority, limit: number): void;
+    /**
+     * Set the batch window (how long to accumulate before auto-flush)
+     */
+    setBatchWindow(ms: number): void;
+    /**
+     * Set max batch size before auto-flush
+     */
+    setMaxBatchSize(size: number): void;
+    /**
+     * Get count of pending operations
+     */
+    get pending(): number;
+    /**
+     * Get count of active operations
+     */
+    get active(): number;
+    /**
+     * Get count of completed operations
+     */
+    get completed(): number;
+    /**
+     * Get full queue statistics
+     */
+    getStats(): QueueStats;
+    /**
+     * Stop the queue and clear all pending operations
+     */
+    destroy(): void;
+}
+/**
+ * Create an execution queue
+ */
+export declare function createExecutionQueue(options?: ExecutionQueueOptions): ExecutionQueue;
+/**
+ * Get or create the default execution queue
+ */
+export declare function getDefaultQueue(): ExecutionQueue;
+/**
+ * Set the default execution queue
+ */
+export declare function setDefaultQueue(queue: ExecutionQueue | null): void;
+//# sourceMappingURL=execution-queue.d.ts.map

package/dist/execution-queue.d.ts.map

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

package/dist/execution-queue.js

@@ -0,0 +1,400 @@
+/**
+ * Execution Queue - Manages execution priority and batching
+ *
+ * The queue decides WHEN to execute based on priority, concurrency, and batch windows.
+ * Operations can be executed immediately, queued, or deferred to batch processing.
+ *
+ * @packageDocumentation
+ */
+import { Semaphore } from './memory-provider.js';
+import { DurablePromise, setBatchScheduler, } from './durable-promise.js';
+// =============================================================================
+// ExecutionQueue Class
+// =============================================================================
+/**
+ * Manages execution of DurablePromises with priority-based scheduling
+ *
+ * @example
+ * ```ts
+ * const queue = new ExecutionQueue({
+ *   priority: 'standard',
+ *   concurrency: { standard: 10, batch: 1000 },
+ *   batchWindow: 60000, // 1 minute
+ * })
+ *
+ * // Register batch providers
+ * queue.registerProvider(openaiProvider)
+ * queue.registerProvider(claudeProvider)
+ *
+ * // Queue operations
+ * queue.enqueue(durablePromise)
+ *
+ * // Flush batch at end of workflow
+ * await queue.flush()
+ * ```
+ */
+export class ExecutionQueue {
+    semaphores;
+    queues;
+    providers = new Map();
+    options;
+    batchTimer = null;
+    completedCount = 0;
+    failedCount = 0;
+    isProcessing = false;
+    constructor(options = {}) {
+        this.options = {
+            priority: options.priority ?? 'standard',
+            concurrency: {
+                priority: options.concurrency?.priority ?? 50,
+                standard: options.concurrency?.standard ?? 20,
+                flex: options.concurrency?.flex ?? 10,
+                batch: options.concurrency?.batch ?? 1000,
+            },
+            batchWindow: options.batchWindow ?? 60000, // 1 minute default
+            maxBatchSize: options.maxBatchSize ?? 10000,
+            flushOnExit: options.flushOnExit ?? true,
+        };
+        // Initialize semaphores for each priority tier
+        this.semaphores = {
+            priority: new Semaphore(this.options.concurrency.priority),
+            standard: new Semaphore(this.options.concurrency.standard),
+            flex: new Semaphore(this.options.concurrency.flex),
+            batch: new Semaphore(this.options.concurrency.batch),
+        };
+        // Initialize queues
+        this.queues = {
+            priority: [],
+            standard: [],
+            flex: [],
+            batch: [],
+        };
+        // Register as global batch scheduler
+        setBatchScheduler(this);
+        // Setup exit handler
+        if (this.options.flushOnExit && typeof process !== 'undefined') {
+            const exitHandler = async () => {
+                await this.flush();
+            };
+            process.on('beforeExit', exitHandler);
+            process.on('SIGINT', async () => {
+                await exitHandler();
+                process.exit(0);
+            });
+            process.on('SIGTERM', async () => {
+                await exitHandler();
+                process.exit(0);
+            });
+        }
+    }
+    // ===========================================================================
+    // Provider Management
+    // ===========================================================================
+    /**
+     * Register a batch provider
+     */
+    registerProvider(provider) {
+        this.providers.set(provider.name, provider);
+    }
+    /**
+     * Get a registered provider
+     */
+    getProvider(name) {
+        return this.providers.get(name);
+    }
+    /**
+     * List registered providers
+     */
+    listProviders() {
+        return Array.from(this.providers.values());
+    }
+    // ===========================================================================
+    // Queue Operations
+    // ===========================================================================
+    /**
+     * Add a promise to the execution queue
+     */
+    enqueue(promise) {
+        const item = {
+            promise,
+            priority: promise.priority,
+            enqueuedAt: new Date(),
+        };
+        this.queues[promise.priority].push(item);
+        // For batch, start the window timer
+        if (promise.priority === 'batch') {
+            this.startBatchTimer();
+            // Check for auto-flush on size
+            if (this.queues.batch.length >= this.options.maxBatchSize) {
+                this.flush();
+            }
+        }
+        else {
+            // For other priorities, process immediately
+            this.processQueue(promise.priority);
+        }
+    }
+    startBatchTimer() {
+        if (this.batchTimer)
+            return;
+        this.batchTimer = setTimeout(async () => {
+            this.batchTimer = null;
+            await this.flush();
+        }, this.options.batchWindow);
+    }
+    async processQueue(priority) {
+        if (this.isProcessing)
+            return;
+        this.isProcessing = true;
+        const queue = this.queues[priority];
+        const semaphore = this.semaphores[priority];
+        try {
+            while (queue.length > 0) {
+                const item = queue.shift();
+                if (!item)
+                    break;
+                // Run with concurrency control
+                // The promise will execute itself; we just track completion
+                semaphore.run(async () => {
+                    try {
+                        await item.promise;
+                        this.completedCount++;
+                    }
+                    catch {
+                        this.failedCount++;
+                    }
+                });
+            }
+        }
+        finally {
+            this.isProcessing = false;
+        }
+    }
+    // ===========================================================================
+    // Batch Operations
+    // ===========================================================================
+    /**
+     * Flush all pending batch operations
+     */
+    async flush() {
+        // Clear the timer
+        if (this.batchTimer) {
+            clearTimeout(this.batchTimer);
+            this.batchTimer = null;
+        }
+        const batchItems = [...this.queues.batch];
+        this.queues.batch = [];
+        if (batchItems.length === 0)
+            return;
+        // Group by method/provider
+        const groups = this.groupByProvider(batchItems);
+        // Submit each group to its provider
+        const submissions = await Promise.all(Array.from(groups.entries()).map(async ([providerName, items]) => {
+            const provider = this.providers.get(providerName);
+            if (!provider) {
+                // Fallback to standard execution if no provider
+                return this.executeFallback(items);
+            }
+            return this.submitToBatchProvider(provider, items);
+        }));
+        // Wait for all batch results
+        await Promise.all(submissions.map((submission) => {
+            if (submission && 'batchId' in submission) {
+                return this.pollBatchCompletion(submission);
+            }
+            return Promise.resolve();
+        }));
+    }
+    groupByProvider(items) {
+        const groups = new Map();
+        for (const item of items) {
+            // Determine provider from method prefix
+            const providerName = this.getProviderFromMethod(item.promise.method);
+            const existing = groups.get(providerName) || [];
+            existing.push(item);
+            groups.set(providerName, existing);
+        }
+        return groups;
+    }
+    getProviderFromMethod(method) {
+        // Extract provider from method like 'openai.chat' -> 'openai'
+        const parts = method.split('.');
+        return parts[0] || 'default';
+    }
+    async submitToBatchProvider(provider, items) {
+        if (!provider.supportsBatch) {
+            await this.executeFallback(items);
+            return null;
+        }
+        const requests = items.map((item) => ({
+            customId: crypto.randomUUID(),
+            actionId: item.promise.actionId,
+            method: item.promise.method,
+            params: {}, // Would need to extract from promise
+        }));
+        try {
+            return await provider.submitBatch(requests);
+        }
+        catch (error) {
+            console.error(`Batch submission failed for ${provider.name}:`, error);
+            await this.executeFallback(items);
+            return null;
+        }
+    }
+    async executeFallback(items) {
+        // Execute as standard priority
+        for (const item of items) {
+            this.queues.standard.push(item);
+        }
+        await this.processQueue('standard');
+    }
+    async pollBatchCompletion(submission) {
+        // This would be implemented by the specific provider
+        // For now, just log
+        console.log(`Batch ${submission.batchId} submitted with ${submission.count} requests`);
+        // In production, this would poll getBatchStatus and stream results
+    }
+    // ===========================================================================
+    // Configuration
+    // ===========================================================================
+    /**
+     * Set the default priority for new operations
+     */
+    setPriority(priority) {
+        this.options.priority = priority;
+    }
+    /**
+     * Set concurrency limit for a priority tier
+     */
+    setConcurrency(priority, limit) {
+        this.options.concurrency[priority] = limit;
+        // Re-create the semaphore (existing operations continue with old limit)
+        this.semaphores[priority] = new Semaphore(limit);
+    }
+    /**
+     * Set the batch window (how long to accumulate before auto-flush)
+     */
+    setBatchWindow(ms) {
+        this.options.batchWindow = ms;
+    }
+    /**
+     * Set max batch size before auto-flush
+     */
+    setMaxBatchSize(size) {
+        this.options.maxBatchSize = size;
+    }
+    // ===========================================================================
+    // Stats
+    // ===========================================================================
+    /**
+     * Get count of pending operations
+     */
+    get pending() {
+        return (this.queues.priority.length +
+            this.queues.standard.length +
+            this.queues.flex.length +
+            this.queues.batch.length);
+    }
+    /**
+     * Get count of active operations
+     */
+    get active() {
+        return (this.semaphores.priority.active +
+            this.semaphores.standard.active +
+            this.semaphores.flex.active +
+            this.semaphores.batch.active);
+    }
+    /**
+     * Get count of completed operations
+     */
+    get completed() {
+        return this.completedCount;
+    }
+    /**
+     * Get full queue statistics
+     */
+    getStats() {
+        return {
+            byPriority: {
+                priority: {
+                    pending: this.queues.priority.length,
+                    active: this.semaphores.priority.active,
+                    completed: 0, // Would need per-tier tracking
+                },
+                standard: {
+                    pending: this.queues.standard.length,
+                    active: this.semaphores.standard.active,
+                    completed: 0,
+                },
+                flex: {
+                    pending: this.queues.flex.length,
+                    active: this.semaphores.flex.active,
+                    completed: 0,
+                },
+                batch: {
+                    pending: this.queues.batch.length,
+                    active: this.semaphores.batch.active,
+                    completed: 0,
+                },
+            },
+            totals: {
+                pending: this.pending,
+                active: this.active,
+                completed: this.completedCount,
+                failed: this.failedCount,
+            },
+            batch: {
+                size: this.queues.batch.length,
+                nextFlush: this.batchTimer
+                    ? new Date(Date.now() + this.options.batchWindow)
+                    : null,
+            },
+        };
+    }
+    // ===========================================================================
+    // Cleanup
+    // ===========================================================================
+    /**
+     * Stop the queue and clear all pending operations
+     */
+    destroy() {
+        if (this.batchTimer) {
+            clearTimeout(this.batchTimer);
+            this.batchTimer = null;
+        }
+        this.queues.priority = [];
+        this.queues.standard = [];
+        this.queues.flex = [];
+        this.queues.batch = [];
+        setBatchScheduler(null);
+    }
+}
+// =============================================================================
+// Factory
+// =============================================================================
+/**
+ * Create an execution queue
+ */
+export function createExecutionQueue(options) {
+    return new ExecutionQueue(options);
+}
+// =============================================================================
+// Default Instance
+// =============================================================================
+let defaultQueue = null;
+/**
+ * Get or create the default execution queue
+ */
+export function getDefaultQueue() {
+    if (!defaultQueue) {
+        defaultQueue = createExecutionQueue();
+    }
+    return defaultQueue;
+}
+/**
+ * Set the default execution queue
+ */
+export function setDefaultQueue(queue) {
+    defaultQueue = queue;
+}
+//# sourceMappingURL=execution-queue.js.map

package/dist/execution-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-queue.js","sourceRoot":"","sources":["../src/execution-queue.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAChD,OAAO,EACL,cAAc,EACd,iBAAiB,GAGlB,MAAM,sBAAsB,CAAA;AA4I7B,gFAAgF;AAChF,uBAAuB;AACvB,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,cAAc;IACR,UAAU,CAAsC;IAChD,MAAM,CAAwC;IAC9C,SAAS,GAAG,IAAI,GAAG,EAAyB,CAAA;IAC5C,OAAO,CAAiC;IAEjD,UAAU,GAAyC,IAAI,CAAA;IACvD,cAAc,GAAG,CAAC,CAAA;IAClB,WAAW,GAAG,CAAC,CAAA;IACf,YAAY,GAAG,KAAK,CAAA;IAE5B,YAAY,UAAiC,EAAE;QAC7C,IAAI,CAAC,OAAO,GAAG;YACb,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,UAAU;YACxC,WAAW,EAAE;gBACX,QAAQ,EAAE,OAAO,CAAC,WAAW,EAAE,QAAQ,IAAI,EAAE;gBAC7C,QAAQ,EAAE,OAAO,CAAC,WAAW,EAAE,QAAQ,IAAI,EAAE;gBAC7C,IAAI,EAAE,OAAO,CAAC,WAAW,EAAE,IAAI,IAAI,EAAE;gBACrC,KAAK,EAAE,OAAO,CAAC,WAAW,EAAE,KAAK,IAAI,IAAI;aAC1C;YACD,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,KAAK,EAAE,mBAAmB;YAC9D,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,KAAK;YAC3C,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,IAAI;SACzC,CAAA;QAED,+CAA+C;QAC/C,IAAI,CAAC,UAAU,GAAG;YAChB,QAAQ,EAAE,IAAI,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,QAAS,CAAC;YAC3D,QAAQ,EAAE,IAAI,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,QAAS,CAAC;YAC3D,IAAI,EAAE,IAAI,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAK,CAAC;YACnD,KAAK,EAAE,IAAI,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,KAAM,CAAC;SACtD,CAAA;QAED,oBAAoB;QACpB,IAAI,CAAC,MAAM,GAAG;YACZ,QAAQ,EAAE,EAAE;YACZ,QAAQ,EAAE,EAAE;YACZ,IAAI,EAAE,EAAE;YACR,KAAK,EAAE,EAAE;SACV,CAAA;QAED,qCAAqC;QACrC,iBAAiB,CAAC,IAAI,CAAC,CAAA;QAEvB,qBAAqB;QACrB,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,OAAO,OAAO,KAAK,WAAW,EAAE,CAAC;YAC/D,MAAM,WAAW,GAAG,KAAK,IAAI,EAAE;gBAC7B,MAAM,IAAI,CAAC,KAAK,EAAE,CAAA;YACpB,CAAC,CAAA;YAED,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,WAAW,CAAC,CAAA;YACrC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;gBAC9B,MAAM,WAAW,EAAE,CAAA;gBACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACjB,CAAC,CAAC,CAAA;YACF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;gBAC/B,MAAM,WAAW,EAAE,CAAA;gBACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACjB,CAAC,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAED,8EAA8E;IAC9E,sBAAsB;IACtB,8EAA8E;IAE9E;;OAEG;IACH,gBAAgB,CAAC,QAAuB;QACtC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAC7C,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,IAAY;QACtB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACjC,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAA;IAC5C,CAAC;IAED,8EAA8E;IAC9E,mBAAmB;IACnB,8EAA8E;IAE9E;;OAEG;IACH,OAAO,CAAC,OAAgC;QACtC,MAAM,IAAI,GAAc;YACtB,OAAO;YACP,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,UAAU,EAAE,IAAI,IAAI,EAAE;SACvB,CAAA;QAED,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAExC,oCAAoC;QACpC,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YACjC,IAAI,CAAC,eAAe,EAAE,CAAA;YAEtB,+BAA+B;YAC/B,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;gBAC1D,IAAI,CAAC,KAAK,EAAE,CAAA;YACd,CAAC;QACH,CAAC;aAAM,CAAC;YACN,4CAA4C;YAC5C,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QACrC,CAAC;IACH,CAAC;IAEO,eAAe;QACrB,IAAI,IAAI,CAAC,UAAU;YAAE,OAAM;QAE3B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,KAAK,IAAI,EAAE;YACtC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAA;YACtB,MAAM,IAAI,CAAC,KAAK,EAAE,CAAA;QACpB,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;IAC9B,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,QAA2B;QACpD,IAAI,IAAI,CAAC,YAAY;YAAE,OAAM;QAC7B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAA;QAExB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QACnC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAA;QAE3C,IAAI,CAAC;YACH,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,EAAE,CAAA;gBAC1B,IAAI,CAAC,IAAI;oBAAE,MAAK;gBAEhB,+BAA+B;gBAC/B,4DAA4D;gBAC5D,SAAS,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE;oBACvB,IAAI,CAAC;wBACH,MAAM,IAAI,CAAC,OAAO,CAAA;wBAClB,IAAI,CAAC,cAAc,EAAE,CAAA;oBACvB,CAAC;oBAAC,MAAM,CAAC;wBACP,IAAI,CAAC,WAAW,EAAE,CAAA;oBACpB,CAAC;gBACH,CAAC,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,YAAY,GAAG,KAAK,CAAA;QAC3B,CAAC;IACH,CAAC;IAED,8EAA8E;IAC9E,mBAAmB;IACnB,8EAA8E;IAE9E;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,kBAAkB;QAClB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;YAC7B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAA;QACxB,CAAC;QAED,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QACzC,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,EAAE,CAAA;QAEtB,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,OAAM;QAEnC,2BAA2B;QAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,CAAA;QAE/C,oCAAoC;QACpC,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,GAAG,CACnC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,YAAY,EAAE,KAAK,CAAC,EAAE,EAAE;YAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;YACjD,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,gDAAgD;gBAChD,OAAO,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAA;YACpC,CAAC;YAED,OAAO,IAAI,CAAC,qBAAqB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;QACpD,CAAC,CAAC,CACH,CAAA;QAED,6BAA6B;QAC7B,MAAM,OAAO,CAAC,GAAG,CACf,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE;YAC7B,IAAI,UAAU,IAAI,SAAS,IAAI,UAAU,EAAE,CAAC;gBAC1C,OAAO,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAA;YAC7C,CAAC;YACD,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;QAC1B,CAAC,CAAC,CACH,CAAA;IACH,CAAC;IAEO,eAAe,CAAC,KAAkB;QACxC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAuB,CAAA;QAE7C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,wCAAwC;YACxC,MAAM,YAAY,GAAG,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;YACpE,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,CAAA;YAC/C,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACnB,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAA;QACpC,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC;IAEO,qBAAqB,CAAC,MAAc;QAC1C,8DAA8D;QAC9D,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAC/B,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,SAAS,CAAA;IAC9B,CAAC;IAEO,KAAK,CAAC,qBAAqB,CACjC,QAAuB,EACvB,KAAkB;QAElB,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;YAC5B,MAAM,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAA;YACjC,OAAO,IAAI,CAAA;QACb,CAAC;QAED,MAAM,QAAQ,GAAmB,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACpD,QAAQ,EAAE,MAAM,CAAC,UAAU,EAAE;YAC7B,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ;YAC/B,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;YAC3B,MAAM,EAAE,EAAE,EAAE,qCAAqC;SAClD,CAAC,CAAC,CAAA;QAEH,IAAI,CAAC;YACH,OAAO,MAAM,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAA;QAC7C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,+BAA+B,QAAQ,CAAC,IAAI,GAAG,EAAE,KAAK,CAAC,CAAA;YACrE,MAAM,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAA;YACjC,OAAO,IAAI,CAAA;QACb,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,eAAe,CAAC,KAAkB;QAC9C,+BAA+B;QAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACjC,CAAC;QACD,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAA;IACrC,CAAC;IAEO,KAAK,CAAC,mBAAmB,CAAC,UAA2B;QAC3D,qDAAqD;QACrD,oBAAoB;QACpB,OAAO,CAAC,GAAG,CAAC,SAAS,UAAU,CAAC,OAAO,mBAAmB,UAAU,CAAC,KAAK,WAAW,CAAC,CAAA;QAEtF,mEAAmE;IACrE,CAAC;IAED,8EAA8E;IAC9E,gBAAgB;IAChB,8EAA8E;IAE9E;;OAEG;IACH,WAAW,CAAC,QAA2B;QACrC,IAAI,CAAC,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAClC,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,QAA2B,EAAE,KAAa;QACvD,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAA;QAC1C,wEAAwE;QACxE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,IAAI,SAAS,CAAC,KAAK,CAAC,CAAA;IAClD,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,EAAU;QACvB,IAAI,CAAC,OAAO,CAAC,WAAW,GAAG,EAAE,CAAA;IAC/B,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,IAAY;QAC1B,IAAI,CAAC,OAAO,CAAC,YAAY,GAAG,IAAI,CAAA;IAClC,CAAC;IAED,8EAA8E;IAC9E,QAAQ;IACR,8EAA8E;IAE9E;;OAEG;IACH,IAAI,OAAO;QACT,OAAO,CACL,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM;YAC3B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM;YAC3B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM;YACvB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CACzB,CAAA;IACH,CAAC;IAED;;OAEG;IACH,IAAI,MAAM;QACR,OAAO,CACL,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM;YAC/B,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM;YAC/B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM;YAC3B,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAC7B,CAAA;IACH,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,cAAc,CAAA;IAC5B,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO;YACL,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM;oBACpC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM;oBACvC,SAAS,EAAE,CAAC,EAAE,+BAA+B;iBAC9C;gBACD,QAAQ,EAAE;oBACR,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM;oBACpC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM;oBACvC,SAAS,EAAE,CAAC;iBACb;gBACD,IAAI,EAAE;oBACJ,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM;oBAChC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM;oBACnC,SAAS,EAAE,CAAC;iBACb;gBACD,KAAK,EAAE;oBACL,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM;oBACjC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM;oBACpC,SAAS,EAAE,CAAC;iBACb;aACF;YACD,MAAM,EAAE;gBACN,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,SAAS,EAAE,IAAI,CAAC,cAAc;gBAC9B,MAAM,EAAE,IAAI,CAAC,WAAW;aACzB;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM;gBAC9B,SAAS,EAAE,IAAI,CAAC,UAAU;oBACxB,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;oBACjD,CAAC,CAAC,IAAI;aACT;SACF,CAAA;IACH,CAAC;IAED,8EAA8E;IAC9E,UAAU;IACV,8EAA8E;IAE9E;;OAEG;IACH,OAAO;QACL,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;YAC7B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAA;QACxB,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,EAAE,CAAA;QACzB,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,EAAE,CAAA;QACzB,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,EAAE,CAAA;QACrB,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,EAAE,CAAA;QAEtB,iBAAiB,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;CACF;AAED,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAA+B;IAClE,OAAO,IAAI,cAAc,CAAC,OAAO,CAAC,CAAA;AACpC,CAAC;AAED,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF,IAAI,YAAY,GAA0B,IAAI,CAAA;AAE9C;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,YAAY,GAAG,oBAAoB,EAAE,CAAA;IACvC,CAAC;IACD,OAAO,YAAY,CAAA;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAA4B;IAC1D,YAAY,GAAG,KAAK,CAAA;AACtB,CAAC"}