ai-database 0.0.0-development → 0.2.0

package/dist/durable-promise.d.ts

@@ -0,0 +1,182 @@
+/**
+ * Durable Promise - Promise-like wrapper around database Actions
+ *
+ * Time is an implementation detail. Whether an operation takes 10ms or 10 hours,
+ * the same code works. The DurablePromise persists its state as an Action,
+ * allowing crash recovery, observability, and time-agnostic execution.
+ *
+ * @packageDocumentation
+ */
+import type { Action, MemoryProvider } from './memory-provider.js';
+/**
+ * Execution priority tiers
+ *
+ * - priority: Pay more for immediate execution (fastest, highest cost)
+ * - standard: Normal price/latency tradeoff (default)
+ * - flex: Discount for variable latency (cost savings)
+ * - batch: Maximum discount, 24h SLA (50% savings)
+ */
+export type ExecutionPriority = 'priority' | 'standard' | 'flex' | 'batch';
+/**
+ * Options for creating a DurablePromise
+ */
+export interface DurablePromiseOptions<T = unknown> {
+    /** Method identifier (e.g., 'ai.generate', 'db.get', 'api.fetch') */
+    method: string;
+    /** Arguments passed to the method */
+    args?: unknown[];
+    /** The executor function that performs the actual work */
+    executor: () => Promise<T>;
+    /** Execution priority tier (defaults to context or 'standard') */
+    priority?: ExecutionPriority;
+    /** Concurrency key for queue grouping */
+    concurrencyKey?: string;
+    /** Defer execution until this time (for batch windows) */
+    deferUntil?: Date;
+    /** Action IDs this promise depends on (must complete first) */
+    dependsOn?: string[];
+    /** Actor identifier (who initiated this operation) */
+    actor?: string;
+    /** Additional metadata */
+    meta?: Record<string, unknown>;
+    /** Provider instance (if not using context) */
+    provider?: MemoryProvider;
+}
+/**
+ * Result of DurablePromise resolution
+ */
+export interface DurablePromiseResult<T> {
+    /** The resolved value */
+    value: T;
+    /** The underlying Action record */
+    action: Action;
+    /** Total execution time in ms */
+    duration: number;
+}
+interface ExecutionContext {
+    priority: ExecutionPriority;
+    provider?: MemoryProvider;
+    concurrencyKey?: string;
+    actor?: string;
+    batchWindow?: number;
+    onFlush?: () => Promise<void>;
+}
+/**
+ * Get the current execution context
+ */
+export declare function getCurrentContext(): ExecutionContext | undefined;
+/**
+ * Run code within an execution context
+ */
+export declare function withContext<T>(context: Partial<ExecutionContext>, fn: () => Promise<T>): Promise<T>;
+/**
+ * Set global default context
+ */
+export declare function setDefaultContext(context: Partial<ExecutionContext>): void;
+/** Symbol to identify DurablePromise instances */
+export declare const DURABLE_PROMISE_SYMBOL: unique symbol;
+/**
+ * A Promise-like class that persists its state as an Action
+ *
+ * @example
+ * ```ts
+ * const promise = new DurablePromise({
+ *   method: 'ai.generate',
+ *   args: [{ prompt: 'Hello' }],
+ *   executor: async () => await ai.generate({ prompt: 'Hello' }),
+ *   priority: 'batch',
+ * })
+ *
+ * // Access the underlying action
+ * console.log(promise.actionId)
+ *
+ * // Await like a normal promise
+ * const result = await promise
+ * ```
+ */
+export declare class DurablePromise<T> implements PromiseLike<T> {
+    readonly [DURABLE_PROMISE_SYMBOL] = true;
+    /** The Action ID backing this promise */
+    readonly actionId: string;
+    /** The method being executed */
+    readonly method: string;
+    /** The execution priority */
+    readonly priority: ExecutionPriority;
+    /** Dependencies that must complete first */
+    readonly dependsOn: string[];
+    private readonly state;
+    private action;
+    private provider;
+    private executor;
+    private startTime;
+    constructor(options: DurablePromiseOptions<T>);
+    private initializeAction;
+    private parseActionVerb;
+    private waitForDependencies;
+    private execute;
+    private executeDirectly;
+    private resolve;
+    private reject;
+    /**
+     * Implement PromiseLike interface
+     */
+    then<TResult1 = T, TResult2 = never>(onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
+    /**
+     * Catch handler
+     */
+    catch<TResult = never>(onrejected?: ((reason: unknown) => TResult | PromiseLike<TResult>) | null): Promise<T | TResult>;
+    /**
+     * Finally handler
+     */
+    finally(onfinally?: (() => void) | null): Promise<T>;
+    /**
+     * Get the current status
+     */
+    get status(): Action['status'];
+    /**
+     * Get the underlying Action (if available)
+     */
+    getAction(): Promise<Action | null>;
+    /**
+     * Get the result with full metadata
+     */
+    getResult(): Promise<DurablePromiseResult<T>>;
+    /**
+     * Cancel the promise if still pending
+     */
+    cancel(): Promise<void>;
+    /**
+     * Retry a failed promise
+     */
+    retry(): Promise<this>;
+}
+/**
+ * Check if a value is a DurablePromise
+ */
+export declare function isDurablePromise(value: unknown): value is DurablePromise<unknown>;
+/**
+ * Create a durable promise from an executor function
+ */
+export declare function durable<T>(method: string, executor: () => Promise<T>, options?: Omit<DurablePromiseOptions<T>, 'method' | 'executor'>): DurablePromise<T>;
+/**
+ * Get the global batch scheduler
+ */
+export declare function getBatchScheduler(): BatchScheduler | null;
+/**
+ * Set the global batch scheduler
+ */
+export declare function setBatchScheduler(scheduler: BatchScheduler | null): void;
+/**
+ * Interface for batch scheduling
+ * Full implementation is in execution-queue.ts
+ */
+export interface BatchScheduler {
+    /** Add a promise to the batch queue */
+    enqueue(promise: DurablePromise<unknown>): void;
+    /** Flush all pending batches */
+    flush(): Promise<void>;
+    /** Get count of pending promises */
+    readonly pending: number;
+}
+export {};
+//# sourceMappingURL=durable-promise.d.ts.map

package/dist/durable-promise.d.ts.map

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

package/dist/durable-promise.js

@@ -0,0 +1,409 @@
+/**
+ * Durable Promise - Promise-like wrapper around database Actions
+ *
+ * Time is an implementation detail. Whether an operation takes 10ms or 10 hours,
+ * the same code works. The DurablePromise persists its state as an Action,
+ * allowing crash recovery, observability, and time-agnostic execution.
+ *
+ * @packageDocumentation
+ */
+const contextStack = [];
+/**
+ * Get the current execution context
+ */
+export function getCurrentContext() {
+    return contextStack[contextStack.length - 1];
+}
+/**
+ * Run code within an execution context
+ */
+export async function withContext(context, fn) {
+    const parent = getCurrentContext();
+    const merged = {
+        priority: context.priority ?? parent?.priority ?? 'standard',
+        provider: context.provider ?? parent?.provider,
+        concurrencyKey: context.concurrencyKey ?? parent?.concurrencyKey,
+        actor: context.actor ?? parent?.actor,
+        batchWindow: context.batchWindow ?? parent?.batchWindow,
+        onFlush: context.onFlush ?? parent?.onFlush,
+    };
+    contextStack.push(merged);
+    try {
+        return await fn();
+    }
+    finally {
+        contextStack.pop();
+    }
+}
+/**
+ * Set global default context
+ */
+export function setDefaultContext(context) {
+    if (contextStack.length === 0) {
+        contextStack.push({
+            priority: context.priority ?? 'standard',
+            provider: context.provider,
+            concurrencyKey: context.concurrencyKey,
+            actor: context.actor,
+            batchWindow: context.batchWindow,
+            onFlush: context.onFlush,
+        });
+    }
+    else {
+        Object.assign(contextStack[0], context);
+    }
+}
+// =============================================================================
+// DurablePromise Class
+// =============================================================================
+/** Symbol to identify DurablePromise instances */
+export const DURABLE_PROMISE_SYMBOL = Symbol.for('ai-database.DurablePromise');
+/**
+ * A Promise-like class that persists its state as an Action
+ *
+ * @example
+ * ```ts
+ * const promise = new DurablePromise({
+ *   method: 'ai.generate',
+ *   args: [{ prompt: 'Hello' }],
+ *   executor: async () => await ai.generate({ prompt: 'Hello' }),
+ *   priority: 'batch',
+ * })
+ *
+ * // Access the underlying action
+ * console.log(promise.actionId)
+ *
+ * // Await like a normal promise
+ * const result = await promise
+ * ```
+ */
+export class DurablePromise {
+    [DURABLE_PROMISE_SYMBOL] = true;
+    /** The Action ID backing this promise */
+    actionId;
+    /** The method being executed */
+    method;
+    /** The execution priority */
+    priority;
+    /** Dependencies that must complete first */
+    dependsOn;
+    state = {
+        status: 'pending',
+        resolvers: [],
+    };
+    action = null;
+    provider = null;
+    executor = null;
+    startTime = Date.now();
+    constructor(options) {
+        const context = getCurrentContext();
+        this.method = options.method;
+        this.priority = options.priority ?? context?.priority ?? 'standard';
+        this.dependsOn = options.dependsOn ?? [];
+        this.provider = options.provider ?? context?.provider ?? null;
+        this.executor = options.executor;
+        this.actionId = crypto.randomUUID();
+        // Create the action immediately if we have a provider
+        if (this.provider) {
+            this.initializeAction(options);
+        }
+        else {
+            // Defer action creation but start execution
+            this.executeDirectly();
+        }
+    }
+    async initializeAction(options) {
+        if (!this.provider)
+            return;
+        try {
+            // Create the action record
+            this.action = await this.provider.createAction({
+                actor: options.actor ?? getCurrentContext()?.actor ?? 'system',
+                action: this.parseActionVerb(this.method),
+                object: this.method,
+                objectData: {
+                    method: this.method,
+                    args: options.args,
+                    priority: this.priority,
+                    concurrencyKey: options.concurrencyKey,
+                    deferUntil: options.deferUntil?.toISOString(),
+                    dependsOn: this.dependsOn,
+                },
+                meta: options.meta,
+            });
+            this.action.id = this.actionId;
+            // Check if we should defer execution
+            if (this.priority === 'batch') {
+                // Register with the batch scheduler instead of executing immediately
+                const scheduler = getBatchScheduler();
+                if (scheduler) {
+                    scheduler.enqueue(this);
+                    return;
+                }
+            }
+            // Check dependencies
+            if (this.dependsOn.length > 0) {
+                await this.waitForDependencies();
+            }
+            // Execute
+            await this.execute();
+        }
+        catch (error) {
+            this.reject(error);
+        }
+    }
+    parseActionVerb(method) {
+        // Extract verb from method like 'ai.generate' -> 'generate'
+        const parts = method.split('.');
+        return parts[parts.length - 1] || 'process';
+    }
+    async waitForDependencies() {
+        if (!this.provider || this.dependsOn.length === 0)
+            return;
+        // Poll for dependency completion
+        const checkInterval = 100; // ms
+        const maxWait = 24 * 60 * 60 * 1000; // 24 hours
+        const startWait = Date.now();
+        while (Date.now() - startWait < maxWait) {
+            const pending = await this.provider.listActions({
+                status: 'pending',
+            });
+            const active = await this.provider.listActions({
+                status: 'active',
+            });
+            const blockedBy = [...pending, ...active]
+                .filter((a) => this.dependsOn.includes(a.id))
+                .map((a) => a.id);
+            if (blockedBy.length === 0) {
+                // All dependencies resolved
+                return;
+            }
+            // Wait before checking again
+            await new Promise((resolve) => setTimeout(resolve, checkInterval));
+        }
+        throw new Error(`Timeout waiting for dependencies: ${this.dependsOn.join(', ')}`);
+    }
+    async execute() {
+        if (!this.executor) {
+            throw new Error('No executor provided');
+        }
+        try {
+            // Mark as active
+            if (this.provider && this.action) {
+                await this.provider.updateAction(this.actionId, { status: 'active' });
+            }
+            // Execute the actual work
+            const result = await this.executor();
+            // Mark as completed
+            if (this.provider && this.action) {
+                await this.provider.updateAction(this.actionId, {
+                    status: 'completed',
+                    result: { value: result },
+                });
+            }
+            this.resolve(result);
+        }
+        catch (error) {
+            // Mark as failed
+            if (this.provider && this.action) {
+                await this.provider.updateAction(this.actionId, {
+                    status: 'failed',
+                    error: error.message,
+                });
+            }
+            this.reject(error);
+        }
+    }
+    async executeDirectly() {
+        if (!this.executor) {
+            throw new Error('No executor provided');
+        }
+        try {
+            const result = await this.executor();
+            this.resolve(result);
+        }
+        catch (error) {
+            this.reject(error);
+        }
+    }
+    resolve(value) {
+        if (this.state.status !== 'pending')
+            return;
+        this.state.status = 'resolved';
+        this.state.value = value;
+        for (const { resolve } of this.state.resolvers) {
+            resolve(value);
+        }
+        this.state.resolvers = [];
+    }
+    reject(error) {
+        if (this.state.status !== 'pending')
+            return;
+        this.state.status = 'rejected';
+        this.state.error = error;
+        for (const { reject } of this.state.resolvers) {
+            reject(error);
+        }
+        this.state.resolvers = [];
+    }
+    /**
+     * Implement PromiseLike interface
+     */
+    then(onfulfilled, onrejected) {
+        return new Promise((resolve, reject) => {
+            const handleResolve = (value) => {
+                if (onfulfilled) {
+                    try {
+                        resolve(onfulfilled(value));
+                    }
+                    catch (e) {
+                        reject(e);
+                    }
+                }
+                else {
+                    resolve(value);
+                }
+            };
+            const handleReject = (error) => {
+                if (onrejected) {
+                    try {
+                        resolve(onrejected(error));
+                    }
+                    catch (e) {
+                        reject(e);
+                    }
+                }
+                else {
+                    reject(error);
+                }
+            };
+            if (this.state.status === 'resolved') {
+                handleResolve(this.state.value);
+            }
+            else if (this.state.status === 'rejected') {
+                handleReject(this.state.error);
+            }
+            else {
+                this.state.resolvers.push({
+                    resolve: handleResolve,
+                    reject: handleReject,
+                });
+            }
+        });
+    }
+    /**
+     * Catch handler
+     */
+    catch(onrejected) {
+        return this.then(null, onrejected);
+    }
+    /**
+     * Finally handler
+     */
+    finally(onfinally) {
+        return this.then((value) => {
+            onfinally?.();
+            return value;
+        }, (reason) => {
+            onfinally?.();
+            throw reason;
+        });
+    }
+    /**
+     * Get the current status
+     */
+    get status() {
+        if (this.action)
+            return this.action.status;
+        if (this.state.status === 'resolved')
+            return 'completed';
+        if (this.state.status === 'rejected')
+            return 'failed';
+        return 'pending';
+    }
+    /**
+     * Get the underlying Action (if available)
+     */
+    async getAction() {
+        if (this.action)
+            return this.action;
+        if (!this.provider)
+            return null;
+        return this.provider.getAction(this.actionId);
+    }
+    /**
+     * Get the result with full metadata
+     */
+    async getResult() {
+        const value = await this;
+        const action = await this.getAction();
+        return {
+            value,
+            action: action,
+            duration: Date.now() - this.startTime,
+        };
+    }
+    /**
+     * Cancel the promise if still pending
+     */
+    async cancel() {
+        if (this.state.status !== 'pending') {
+            throw new Error('Cannot cancel a resolved or rejected promise');
+        }
+        if (this.provider) {
+            await this.provider.cancelAction(this.actionId);
+        }
+        this.reject(new Error('Promise cancelled'));
+    }
+    /**
+     * Retry a failed promise
+     */
+    async retry() {
+        if (this.state.status !== 'rejected') {
+            throw new Error('Can only retry failed promises');
+        }
+        if (this.provider) {
+            await this.provider.retryAction(this.actionId);
+        }
+        // Re-execute
+        this.state.status = 'pending';
+        await this.execute();
+        return this;
+    }
+}
+/**
+ * Check if a value is a DurablePromise
+ */
+export function isDurablePromise(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        DURABLE_PROMISE_SYMBOL in value &&
+        value[DURABLE_PROMISE_SYMBOL] === true);
+}
+/**
+ * Create a durable promise from an executor function
+ */
+export function durable(method, executor, options) {
+    return new DurablePromise({
+        method,
+        executor,
+        ...options,
+    });
+}
+// =============================================================================
+// Batch Scheduler Singleton
+// =============================================================================
+let batchScheduler = null;
+/**
+ * Get the global batch scheduler
+ */
+export function getBatchScheduler() {
+    return batchScheduler;
+}
+/**
+ * Set the global batch scheduler
+ */
+export function setBatchScheduler(scheduler) {
+    batchScheduler = scheduler;
+}
+//# sourceMappingURL=durable-promise.js.map

package/dist/durable-promise.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-promise.js","sourceRoot":"","sources":["../src/durable-promise.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA2FH,MAAM,YAAY,GAAuB,EAAE,CAAA;AAE3C;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,YAAY,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAkC,EAClC,EAAoB;IAEpB,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAA;IAClC,MAAM,MAAM,GAAqB;QAC/B,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,MAAM,EAAE,QAAQ,IAAI,UAAU;QAC5D,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,MAAM,EAAE,QAAQ;QAC9C,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,MAAM,EAAE,cAAc;QAChE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,MAAM,EAAE,KAAK;QACrC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,MAAM,EAAE,WAAW;QACvD,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,MAAM,EAAE,OAAO;KAC5C,CAAA;IAED,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACzB,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAA;IACnB,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,GAAG,EAAE,CAAA;IACpB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAkC;IAClE,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,YAAY,CAAC,IAAI,CAAC;YAChB,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,UAAU;YACxC,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC,CAAA;IACJ,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAE,EAAE,OAAO,CAAC,CAAA;IAC1C,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,uBAAuB;AACvB,gFAAgF;AAEhF,kDAAkD;AAClD,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAA;AAE9E;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,cAAc;IAChB,CAAC,sBAAsB,CAAC,GAAG,IAAI,CAAA;IAExC,yCAAyC;IAChC,QAAQ,CAAQ;IAEzB,gCAAgC;IACvB,MAAM,CAAQ;IAEvB,6BAA6B;IACpB,QAAQ,CAAmB;IAEpC,4CAA4C;IACnC,SAAS,CAAU;IAEX,KAAK,GAAoB;QACxC,MAAM,EAAE,SAAS;QACjB,SAAS,EAAE,EAAE;KACd,CAAA;IAEO,MAAM,GAAkB,IAAI,CAAA;IAC5B,QAAQ,GAA0B,IAAI,CAAA;IACtC,QAAQ,GAA8B,IAAI,CAAA;IAC1C,SAAS,GAAW,IAAI,CAAC,GAAG,EAAE,CAAA;IAEtC,YAAY,OAAiC;QAC3C,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAA;QAEnC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;QAC5B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,EAAE,QAAQ,IAAI,UAAU,CAAA;QACnE,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAA;QACxC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,EAAE,QAAQ,IAAI,IAAI,CAAA;QAC7D,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAA;QAChC,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,UAAU,EAAE,CAAA;QAEnC,sDAAsD;QACtD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAA;QAChC,CAAC;aAAM,CAAC;YACN,4CAA4C;YAC5C,IAAI,CAAC,eAAe,EAAE,CAAA;QACxB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAAC,OAAiC;QAC9D,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAM;QAE1B,IAAI,CAAC;YACH,2BAA2B;YAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;gBAC7C,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,iBAAiB,EAAE,EAAE,KAAK,IAAI,QAAQ;gBAC9D,MAAM,EAAE,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC;gBACzC,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,UAAU,EAAE;oBACV,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,cAAc,EAAE,OAAO,CAAC,cAAc;oBACtC,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,WAAW,EAAE;oBAC7C,SAAS,EAAE,IAAI,CAAC,SAAS;iBAC1B;gBACD,IAAI,EAAE,OAAO,CAAC,IAAI;aACnB,CAAC,CAID;YAAC,IAAI,CAAC,MAAyB,CAAC,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAA;YAEnD,qCAAqC;YACrC,IAAI,IAAI,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;gBAC9B,qEAAqE;gBACrE,MAAM,SAAS,GAAG,iBAAiB,EAAE,CAAA;gBACrC,IAAI,SAAS,EAAE,CAAC;oBACd,SAAS,CAAC,OAAO,CAAC,IAA+B,CAAC,CAAA;oBAClD,OAAM;gBACR,CAAC;YACH,CAAC;YAED,qBAAqB;YACrB,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9B,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAA;YAClC,CAAC;YAED,UAAU;YACV,MAAM,IAAI,CAAC,OAAO,EAAE,CAAA;QACtB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAc,CAAC,CAAA;QAC7B,CAAC;IACH,CAAC;IAEO,eAAe,CAAC,MAAc;QACpC,4DAA4D;QAC5D,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAC/B,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,SAAS,CAAA;IAC7C,CAAC;IAEO,KAAK,CAAC,mBAAmB;QAC/B,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAM;QAEzD,iCAAiC;QACjC,MAAM,aAAa,GAAG,GAAG,CAAA,CAAC,KAAK;QAC/B,MAAM,OAAO,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA,CAAC,WAAW;QAE/C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAE5B,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,OAAO,EAAE,CAAC;YACxC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;gBAC9C,MAAM,EAAE,SAAS;aAClB,CAAC,CAAA;YAEF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;gBAC7C,MAAM,EAAE,QAAQ;aACjB,CAAC,CAAA;YAEF,MAAM,SAAS,GAAG,CAAC,GAAG,OAAO,EAAE,GAAG,MAAM,CAAC;iBACtC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;iBAC5C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;YAEnB,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3B,4BAA4B;gBAC5B,OAAM;YACR,CAAC;YAED,6BAA6B;YAC7B,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAA;QACpE,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,qCAAqC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACnF,CAAC;IAEO,KAAK,CAAC,OAAO;QACnB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAA;QACzC,CAAC;QAED,IAAI,CAAC;YACH,iBAAiB;YACjB,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBACjC,MAAM,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAA;YACvE,CAAC;YAED,0BAA0B;YAC1B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAA;YAEpC,oBAAoB;YACpB,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBACjC,MAAM,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE;oBAC9C,MAAM,EAAE,WAAW;oBACnB,MAAM,EAAE,EAAE,KAAK,EAAE,MAA4C,EAAE;iBAChE,CAAC,CAAA;YACJ,CAAC;YAED,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QACtB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,iBAAiB;YACjB,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBACjC,MAAM,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE;oBAC9C,MAAM,EAAE,QAAQ;oBAChB,KAAK,EAAG,KAAe,CAAC,OAAO;iBAChC,CAAC,CAAA;YACJ,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,KAAc,CAAC,CAAA;QAC7B,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,eAAe;QAC3B,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAA;QACzC,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAA;YACpC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QACtB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAc,CAAC,CAAA;QAC7B,CAAC;IACH,CAAC;IAEO,OAAO,CAAC,KAAQ;QACtB,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS;YAAE,OAAM;QAE3C,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,UAAU,CAAA;QAC9B,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAA;QAExB,KAAK,MAAM,EAAE,OAAO,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;YAC/C,OAAO,CAAC,KAAK,CAAC,CAAA;QAChB,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,EAAE,CAAA;IAC3B,CAAC;IAEO,MAAM,CAAC,KAAY;QACzB,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS;YAAE,OAAM;QAE3C,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,UAAU,CAAA;QAC9B,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAA;QAExB,KAAK,MAAM,EAAE,MAAM,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;YAC9C,MAAM,CAAC,KAAK,CAAC,CAAA;QACf,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,EAAE,CAAA;IAC3B,CAAC;IAED;;OAEG;IACH,IAAI,CACF,WAAqE,EACrE,UAA2E;QAE3E,OAAO,IAAI,OAAO,CAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1D,MAAM,aAAa,GAAG,CAAC,KAAQ,EAAE,EAAE;gBACjC,IAAI,WAAW,EAAE,CAAC;oBAChB,IAAI,CAAC;wBACH,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAA;oBAC7B,CAAC;oBAAC,OAAO,CAAC,EAAE,CAAC;wBACX,MAAM,CAAC,CAAC,CAAC,CAAA;oBACX,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,KAA4B,CAAC,CAAA;gBACvC,CAAC;YACH,CAAC,CAAA;YAED,MAAM,YAAY,GAAG,CAAC,KAAc,EAAE,EAAE;gBACtC,IAAI,UAAU,EAAE,CAAC;oBACf,IAAI,CAAC;wBACH,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAA;oBAC5B,CAAC;oBAAC,OAAO,CAAC,EAAE,CAAC;wBACX,MAAM,CAAC,CAAC,CAAC,CAAA;oBACX,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,KAAK,CAAC,CAAA;gBACf,CAAC;YACH,CAAC,CAAA;YAED,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;gBACrC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,KAAM,CAAC,CAAA;YAClC,CAAC;iBAAM,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;gBAC5C,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;YAChC,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC;oBACxB,OAAO,EAAE,aAAoD;oBAC7D,MAAM,EAAE,YAAY;iBACrB,CAAC,CAAA;YACJ,CAAC;QACH,CAAC,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CACH,UAAyE;QAEzE,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;IACpC,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,SAA+B;QACrC,OAAO,IAAI,CAAC,IAAI,CACd,CAAC,KAAK,EAAE,EAAE;YACR,SAAS,EAAE,EAAE,CAAA;YACb,OAAO,KAAK,CAAA;QACd,CAAC,EACD,CAAC,MAAM,EAAE,EAAE;YACT,SAAS,EAAE,EAAE,CAAA;YACb,MAAM,MAAM,CAAA;QACd,CAAC,CACF,CAAA;IACH,CAAC;IAED;;OAEG;IACH,IAAI,MAAM;QACR,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAA;QAC1C,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,UAAU;YAAE,OAAO,WAAW,CAAA;QACxD,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,UAAU;YAAE,OAAO,QAAQ,CAAA;QACrD,OAAO,SAAS,CAAA;IAClB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS;QACb,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC,MAAM,CAAA;QACnC,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAA;QAC/B,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC/C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS;QACb,MAAM,KAAK,GAAG,MAAM,IAAI,CAAA;QACxB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAA;QAErC,OAAO;YACL,KAAK;YACL,MAAM,EAAE,MAAO;YACf,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS;SACtC,CAAA;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM;QACV,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;QACjE,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACjD,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAA;IAC7C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAA;QACnD,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAChD,CAAC;QAED,aAAa;QACb,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAA;QAC7B,MAAM,IAAI,CAAC,OAAO,EAAE,CAAA;QACpB,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,sBAAsB,IAAI,KAAK;QAC9B,KAAiC,CAAC,sBAAsB,CAAC,KAAK,IAAI,CACpE,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CACrB,MAAc,EACd,QAA0B,EAC1B,OAA+D;IAE/D,OAAO,IAAI,cAAc,CAAC;QACxB,MAAM;QACN,QAAQ;QACR,GAAG,OAAO;KACX,CAAC,CAAA;AACJ,CAAC;AAED,gFAAgF;AAChF,4BAA4B;AAC5B,gFAAgF;AAEhF,IAAI,cAAc,GAA0B,IAAI,CAAA;AAEhD;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,cAAc,CAAA;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAgC;IAChE,cAAc,GAAG,SAAS,CAAA;AAC5B,CAAC"}