@dotdo/postgres 0.1.0

package/dist/migrations/progress-tracker-do.d.ts

@@ -0,0 +1,195 @@
+/**
+ * Durable Object-based Progress Storage
+ *
+ * Storage implementation using a Durable Object for centralized
+ * migration progress tracking with strong consistency.
+ *
+ * @module migrations/progress-tracker-do
+ */
+import type { ProgressStorage, MigrationOperation, DOProgressState, DOMigrationStatus } from './progress-tracker';
+/**
+ * Progress Tracker Durable Object
+ *
+ * Centralized DO for storing and querying migration progress across
+ * thousands of other DOs.
+ *
+ * Benefits over KV:
+ * - Strong consistency
+ * - Fast queries (no multi-key fetch)
+ * - Transactional updates
+ * - Lower latency for reads
+ *
+ * Tradeoffs:
+ * - Single instance (but can handle high throughput)
+ * - Not globally distributed (but can be geo-located near workers)
+ *
+ * @example
+ * ```typescript
+ * export class ProgressTrackerDO {
+ *   constructor(private state: DurableObjectState) {}
+ *
+ *   async fetch(request: Request): Promise<Response> {
+ *     const url = new URL(request.url)
+ *
+ *     if (url.pathname === '/operation' && request.method === 'PUT') {
+ *       const { migrationId, operation } = await request.json()
+ *       await this.setOperation(migrationId, operation)
+ *       return new Response('OK')
+ *     }
+ *
+ *     // ... other endpoints
+ *   }
+ *
+ *   private async setOperation(id: string, op: MigrationOperation) {
+ *     await this.state.storage.put(`op:${id}`, op)
+ *   }
+ * }
+ * ```
+ */
+export interface ProgressTrackerDOInterface {
+    /**
+     * Store migration operation
+     */
+    setOperation(migrationId: string, operation: MigrationOperation): Promise<void>;
+    /**
+     * Get migration operation
+     */
+    getOperation(migrationId: string): Promise<MigrationOperation | null>;
+    /**
+     * Store DO progress
+     */
+    setDOProgress(migrationId: string, doId: string, progress: DOProgressState): Promise<void>;
+    /**
+     * Get DO progress
+     */
+    getDOProgress(migrationId: string, doId: string): Promise<DOProgressState | null>;
+    /**
+     * Get all DO progress for a migration
+     */
+    getAllDOProgress(migrationId: string): Promise<DOProgressState[]>;
+    /**
+     * Get DO progress by status
+     */
+    getDOProgressByStatus(migrationId: string, status: DOMigrationStatus): Promise<DOProgressState[]>;
+    /**
+     * Delete migration operation
+     */
+    deleteOperation(migrationId: string): Promise<void>;
+    /**
+     * List all operations
+     */
+    listOperations(): Promise<MigrationOperation[]>;
+}
+/**
+ * Client for interacting with Progress Tracker Durable Object
+ */
+export declare class DOProgressStorageClient implements ProgressStorage {
+    private doStub;
+    private requestTimeout;
+    constructor(doStub: DurableObjectStub, requestTimeout?: number);
+    /**
+     * Make a request to the DO with timeout
+     */
+    private request;
+    setOperation(migrationId: string, operation: MigrationOperation): Promise<void>;
+    getOperation(migrationId: string): Promise<MigrationOperation | null>;
+    setDOProgress(migrationId: string, doId: string, progress: DOProgressState): Promise<void>;
+    getDOProgress(migrationId: string, doId: string): Promise<DOProgressState | null>;
+    getAllDOProgress(migrationId: string): Promise<DOProgressState[]>;
+    getDOProgressByStatus(migrationId: string, status: DOMigrationStatus): Promise<DOProgressState[]>;
+    deleteOperation(migrationId: string): Promise<void>;
+    listOperations(): Promise<MigrationOperation[]>;
+}
+/**
+ * Durable Object implementation for progress tracking
+ *
+ * This is a reference implementation that can be used directly
+ * or adapted to your specific needs.
+ *
+ * @example In your wrangler.toml:
+ * ```toml
+ * [[durable_objects.bindings]]
+ * name = "PROGRESS_TRACKER"
+ * class_name = "ProgressTrackerDO"
+ * script_name = "postgres-worker"
+ * ```
+ *
+ * @example In your worker:
+ * ```typescript
+ * import { ProgressTrackerDO } from '@dotdo/postgres/migrations/progress-tracker-do'
+ *
+ * export { ProgressTrackerDO }
+ *
+ * // Use it
+ * const id = env.PROGRESS_TRACKER.idFromName('default')
+ * const stub = env.PROGRESS_TRACKER.get(id)
+ * const storage = new DOProgressStorageClient(stub)
+ * const tracker = createProgressTracker({ storage })
+ * ```
+ */
+export declare class ProgressTrackerDO implements DurableObject {
+    private state;
+    constructor(state: DurableObjectState);
+    fetch(request: Request): Promise<Response>;
+    /**
+     * Handle PUT /operation - Set operation
+     */
+    private handleOperation;
+    /**
+     * Handle POST /operation/get - Get operation
+     */
+    private handleGetOperation;
+    /**
+     * Handle PUT /progress - Set DO progress
+     */
+    private handleProgress;
+    /**
+     * Handle POST /progress/get - Get DO progress
+     */
+    private handleGetProgress;
+    /**
+     * Handle POST /progress/all - Get all DO progress
+     */
+    private handleGetAllProgress;
+    /**
+     * Handle POST /progress/by-status - Get DO progress by status
+     */
+    private handleGetProgressByStatus;
+    /**
+     * Handle GET /operations - List all operations
+     */
+    private handleListOperations;
+    private operationKey;
+    private doProgressKey;
+    private doListKey;
+    private statusIndexKey;
+    setOperation(migrationId: string, operation: MigrationOperation): Promise<void>;
+    getOperation(migrationId: string): Promise<MigrationOperation | null>;
+    setDOProgress(migrationId: string, doId: string, progress: DOProgressState): Promise<void>;
+    getDOProgress(migrationId: string, doId: string): Promise<DOProgressState | null>;
+    getAllDOProgress(migrationId: string): Promise<DOProgressState[]>;
+    getDOProgressByStatus(migrationId: string, status: DOMigrationStatus): Promise<DOProgressState[]>;
+    deleteOperation(migrationId: string): Promise<void>;
+    listOperations(): Promise<MigrationOperation[]>;
+    private getStatusIndex;
+    private addToStatusIndex;
+    private removeFromStatusIndex;
+    private getDOList;
+    private addToDOList;
+}
+/**
+ * Create a DO-based progress storage client
+ *
+ * @param doStub Durable Object stub for the progress tracker DO
+ * @param requestTimeout Optional timeout in milliseconds (default: 30000)
+ * @returns Configured DO progress storage client
+ *
+ * @example
+ * ```typescript
+ * const id = env.PROGRESS_TRACKER.idFromName('default')
+ * const stub = env.PROGRESS_TRACKER.get(id)
+ * const storage = createDOProgressStorage(stub)
+ * ```
+ */
+export declare function createDOProgressStorage(doStub: DurableObjectStub, requestTimeout?: number): DOProgressStorageClient;
+//# sourceMappingURL=progress-tracker-do.d.ts.map

package/dist/migrations/progress-tracker-do.d.ts.map

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

package/dist/migrations/progress-tracker-do.js

@@ -0,0 +1,339 @@
+/**
+ * Durable Object-based Progress Storage
+ *
+ * Storage implementation using a Durable Object for centralized
+ * migration progress tracking with strong consistency.
+ *
+ * @module migrations/progress-tracker-do
+ */
+import { createLogger, LogLevel } from '@dotdo/postgres-shared';
+// Module-level logger for progress tracker DO
+const doLogger = createLogger({
+    level: LogLevel.ERROR,
+    prefix: '[ProgressTrackerDO]',
+});
+/**
+ * Client for interacting with Progress Tracker Durable Object
+ */
+export class DOProgressStorageClient {
+    doStub;
+    requestTimeout;
+    constructor(doStub, requestTimeout = 30000) {
+        this.doStub = doStub;
+        this.requestTimeout = requestTimeout;
+    }
+    /**
+     * Make a request to the DO with timeout
+     */
+    async request(method, path, body) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.requestTimeout);
+        try {
+            const response = await this.doStub.fetch(`https://do/${path}`, {
+                method,
+                headers: { 'Content-Type': 'application/json' },
+                ...(body !== undefined && { body: JSON.stringify(body) }),
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                const error = await response.text();
+                throw new Error(`DO request failed: ${error}`);
+            }
+            const data = await response.json();
+            return data;
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    async setOperation(migrationId, operation) {
+        await this.request('PUT', 'operation', { migrationId, operation });
+    }
+    async getOperation(migrationId) {
+        return this.request('POST', 'operation/get', { migrationId });
+    }
+    async setDOProgress(migrationId, doId, progress) {
+        await this.request('PUT', 'progress', { migrationId, doId, progress });
+    }
+    async getDOProgress(migrationId, doId) {
+        return this.request('POST', 'progress/get', { migrationId, doId });
+    }
+    async getAllDOProgress(migrationId) {
+        return this.request('POST', 'progress/all', { migrationId });
+    }
+    async getDOProgressByStatus(migrationId, status) {
+        return this.request('POST', 'progress/by-status', { migrationId, status });
+    }
+    async deleteOperation(migrationId) {
+        await this.request('DELETE', 'operation', { migrationId });
+    }
+    async listOperations() {
+        return this.request('GET', 'operations', undefined);
+    }
+}
+/**
+ * Durable Object implementation for progress tracking
+ *
+ * This is a reference implementation that can be used directly
+ * or adapted to your specific needs.
+ *
+ * @example In your wrangler.toml:
+ * ```toml
+ * [[durable_objects.bindings]]
+ * name = "PROGRESS_TRACKER"
+ * class_name = "ProgressTrackerDO"
+ * script_name = "postgres-worker"
+ * ```
+ *
+ * @example In your worker:
+ * ```typescript
+ * import { ProgressTrackerDO } from '@dotdo/postgres/migrations/progress-tracker-do'
+ *
+ * export { ProgressTrackerDO }
+ *
+ * // Use it
+ * const id = env.PROGRESS_TRACKER.idFromName('default')
+ * const stub = env.PROGRESS_TRACKER.get(id)
+ * const storage = new DOProgressStorageClient(stub)
+ * const tracker = createProgressTracker({ storage })
+ * ```
+ */
+export class ProgressTrackerDO {
+    state;
+    constructor(state) {
+        this.state = state;
+    }
+    async fetch(request) {
+        try {
+            const url = new URL(request.url);
+            const path = url.pathname.slice(1); // Remove leading /
+            // Handle different endpoints
+            switch (path) {
+                case 'operation':
+                    return this.handleOperation(request);
+                case 'operation/get':
+                    return this.handleGetOperation(request);
+                case 'progress':
+                    return this.handleProgress(request);
+                case 'progress/get':
+                    return this.handleGetProgress(request);
+                case 'progress/all':
+                    return this.handleGetAllProgress(request);
+                case 'progress/by-status':
+                    return this.handleGetProgressByStatus(request);
+                case 'operations':
+                    return this.handleListOperations(request);
+                default:
+                    return new Response('Not Found', { status: 404 });
+            }
+        }
+        catch (error) {
+            doLogger.error('ProgressTrackerDO error', { error: error instanceof Error ? error.message : String(error) });
+            return new Response(error instanceof Error ? error.message : 'Internal Error', {
+                status: 500,
+            });
+        }
+    }
+    /**
+     * Handle PUT /operation - Set operation
+     */
+    async handleOperation(request) {
+        if (request.method === 'PUT') {
+            const { migrationId, operation } = await request.json();
+            await this.setOperation(migrationId, operation);
+            return Response.json({ success: true });
+        }
+        else if (request.method === 'DELETE') {
+            const { migrationId } = await request.json();
+            await this.deleteOperation(migrationId);
+            return Response.json({ success: true });
+        }
+        return new Response('Method Not Allowed', { status: 405 });
+    }
+    /**
+     * Handle POST /operation/get - Get operation
+     */
+    async handleGetOperation(request) {
+        const { migrationId } = await request.json();
+        const operation = await this.getOperation(migrationId);
+        return Response.json(operation);
+    }
+    /**
+     * Handle PUT /progress - Set DO progress
+     */
+    async handleProgress(request) {
+        const { migrationId, doId, progress } = await request.json();
+        await this.setDOProgress(migrationId, doId, progress);
+        return Response.json({ success: true });
+    }
+    /**
+     * Handle POST /progress/get - Get DO progress
+     */
+    async handleGetProgress(request) {
+        const { migrationId, doId } = await request.json();
+        const progress = await this.getDOProgress(migrationId, doId);
+        return Response.json(progress);
+    }
+    /**
+     * Handle POST /progress/all - Get all DO progress
+     */
+    async handleGetAllProgress(request) {
+        const { migrationId } = await request.json();
+        const progress = await this.getAllDOProgress(migrationId);
+        return Response.json(progress);
+    }
+    /**
+     * Handle POST /progress/by-status - Get DO progress by status
+     */
+    async handleGetProgressByStatus(request) {
+        const { migrationId, status } = await request.json();
+        const progress = await this.getDOProgressByStatus(migrationId, status);
+        return Response.json(progress);
+    }
+    /**
+     * Handle GET /operations - List all operations
+     */
+    async handleListOperations(_request) {
+        const operations = await this.listOperations();
+        return Response.json(operations);
+    }
+    // Storage implementation
+    operationKey(migrationId) {
+        return `op:${migrationId}`;
+    }
+    doProgressKey(migrationId, doId) {
+        return `do:${migrationId}:${doId}`;
+    }
+    doListKey(migrationId) {
+        return `do_list:${migrationId}`;
+    }
+    statusIndexKey(migrationId, status) {
+        return `index:${migrationId}:${status}`;
+    }
+    async setOperation(migrationId, operation) {
+        await this.state.storage.put(this.operationKey(migrationId), operation);
+    }
+    async getOperation(migrationId) {
+        return (await this.state.storage.get(this.operationKey(migrationId))) ?? null;
+    }
+    async setDOProgress(migrationId, doId, progress) {
+        // Get old progress to handle status index updates
+        const oldProgress = await this.getDOProgress(migrationId, doId);
+        // Store new progress
+        await this.state.storage.put(this.doProgressKey(migrationId, doId), progress);
+        // Update status indexes
+        if (oldProgress && oldProgress.status !== progress.status) {
+            // Remove from old status index
+            await this.removeFromStatusIndex(migrationId, doId, oldProgress.status);
+        }
+        // Add to new status index
+        await this.addToStatusIndex(migrationId, doId, progress.status);
+        // Add to DO list
+        await this.addToDOList(migrationId, doId);
+    }
+    async getDOProgress(migrationId, doId) {
+        return ((await this.state.storage.get(this.doProgressKey(migrationId, doId))) ?? null);
+    }
+    async getAllDOProgress(migrationId) {
+        const doIds = await this.getDOList(migrationId);
+        if (doIds.length === 0) {
+            return [];
+        }
+        // Get all progress states
+        const keys = doIds.map((doId) => this.doProgressKey(migrationId, doId));
+        const results = await this.state.storage.get(keys);
+        return Array.from(results.values());
+    }
+    async getDOProgressByStatus(migrationId, status) {
+        const doIds = await this.getStatusIndex(migrationId, status);
+        if (doIds.length === 0) {
+            return [];
+        }
+        const keys = doIds.map((doId) => this.doProgressKey(migrationId, doId));
+        const results = await this.state.storage.get(keys);
+        return Array.from(results.values());
+    }
+    async deleteOperation(migrationId) {
+        // Get all DO IDs
+        const doIds = await this.getDOList(migrationId);
+        // Collect all keys to delete
+        const keysToDelete = [
+            this.operationKey(migrationId),
+            this.doListKey(migrationId),
+        ];
+        // Add all DO progress keys
+        for (const doId of doIds) {
+            keysToDelete.push(this.doProgressKey(migrationId, doId));
+        }
+        // Add all status index keys
+        const statuses = ['pending', 'running', 'completed', 'failed', 'skipped'];
+        for (const status of statuses) {
+            keysToDelete.push(this.statusIndexKey(migrationId, status));
+        }
+        // Delete all keys
+        await this.state.storage.delete(keysToDelete);
+    }
+    async listOperations() {
+        const operations = [];
+        // List all keys with 'op:' prefix
+        const allKeys = await this.state.storage.list({ prefix: 'op:' });
+        for (const [, operation] of allKeys) {
+            operations.push(operation);
+        }
+        return operations;
+    }
+    // Helper methods for status indexes
+    async getStatusIndex(migrationId, status) {
+        const key = this.statusIndexKey(migrationId, status);
+        return (await this.state.storage.get(key)) ?? [];
+    }
+    async addToStatusIndex(migrationId, doId, status) {
+        const key = this.statusIndexKey(migrationId, status);
+        const index = await this.getStatusIndex(migrationId, status);
+        if (!index.includes(doId)) {
+            index.push(doId);
+            await this.state.storage.put(key, index);
+        }
+    }
+    async removeFromStatusIndex(migrationId, doId, status) {
+        const key = this.statusIndexKey(migrationId, status);
+        const index = await this.getStatusIndex(migrationId, status);
+        const filtered = index.filter((id) => id !== doId);
+        if (filtered.length > 0) {
+            await this.state.storage.put(key, filtered);
+        }
+        else {
+            await this.state.storage.delete(key);
+        }
+    }
+    async getDOList(migrationId) {
+        const key = this.doListKey(migrationId);
+        return (await this.state.storage.get(key)) ?? [];
+    }
+    async addToDOList(migrationId, doId) {
+        const key = this.doListKey(migrationId);
+        const list = await this.getDOList(migrationId);
+        if (!list.includes(doId)) {
+            list.push(doId);
+            await this.state.storage.put(key, list);
+        }
+    }
+}
+/**
+ * Create a DO-based progress storage client
+ *
+ * @param doStub Durable Object stub for the progress tracker DO
+ * @param requestTimeout Optional timeout in milliseconds (default: 30000)
+ * @returns Configured DO progress storage client
+ *
+ * @example
+ * ```typescript
+ * const id = env.PROGRESS_TRACKER.idFromName('default')
+ * const stub = env.PROGRESS_TRACKER.get(id)
+ * const storage = createDOProgressStorage(stub)
+ * ```
+ */
+export function createDOProgressStorage(doStub, requestTimeout) {
+    return new DOProgressStorageClient(doStub, requestTimeout);
+}
+//# sourceMappingURL=progress-tracker-do.js.map

package/dist/migrations/progress-tracker-do.js.map

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

package/dist/migrations/progress-tracker-kv.d.ts

@@ -0,0 +1,103 @@
+/**
+ * KV-based Progress Storage
+ *
+ * Production storage implementation using Cloudflare Workers KV
+ * for migration progress tracking across Durable Objects.
+ *
+ * @module migrations/progress-tracker-kv
+ */
+import type { ProgressStorage, MigrationOperation, DOProgressState, DOMigrationStatus } from './progress-tracker';
+/**
+ * Configuration for KV-based progress storage
+ */
+export interface KVProgressStorageConfig {
+    /** KV namespace binding */
+    kv: KVNamespace;
+    /** Prefix for all keys (default: 'migration_progress') */
+    prefix?: string;
+    /** Expiration time for completed migrations in seconds (default: 7 days) */
+    expirationTtl?: number;
+}
+/**
+ * KV-based progress storage implementation
+ *
+ * Uses Cloudflare Workers KV to store migration progress data.
+ * Keys are structured as:
+ * - {prefix}:op:{migrationId} - Operation metadata
+ * - {prefix}:do:{migrationId}:{doId} - DO progress
+ * - {prefix}:index:{migrationId}:{status} - Status indexes for filtering
+ *
+ * @example
+ * ```typescript
+ * const storage = new KVProgressStorage({
+ *   kv: env.MIGRATION_PROGRESS_KV,
+ *   prefix: 'migration_progress',
+ *   expirationTtl: 604800, // 7 days
+ * })
+ *
+ * const tracker = createProgressTracker({ storage })
+ * ```
+ */
+export declare class KVProgressStorage implements ProgressStorage {
+    private kv;
+    private prefix;
+    private expirationTtl;
+    constructor(config: KVProgressStorageConfig);
+    /**
+     * Generate key for operation metadata
+     */
+    private operationKey;
+    /**
+     * Generate key for DO progress
+     */
+    private doProgressKey;
+    /**
+     * Generate key for DO list
+     */
+    private doListKey;
+    /**
+     * Generate key for status index
+     */
+    private statusIndexKey;
+    /**
+     * Generate key prefix for listing operations
+     */
+    private operationListPrefix;
+    setOperation(migrationId: string, operation: MigrationOperation): Promise<void>;
+    getOperation(migrationId: string): Promise<MigrationOperation | null>;
+    setDOProgress(migrationId: string, doId: string, progress: DOProgressState): Promise<void>;
+    getDOProgress(migrationId: string, doId: string): Promise<DOProgressState | null>;
+    getAllDOProgress(migrationId: string): Promise<DOProgressState[]>;
+    getDOProgressByStatus(migrationId: string, status: DOMigrationStatus): Promise<DOProgressState[]>;
+    deleteOperation(migrationId: string): Promise<void>;
+    listOperations(): Promise<MigrationOperation[]>;
+    /**
+     * Update status index when DO status changes
+     */
+    private updateStatusIndex;
+    /**
+     * Add DO to the DO list for a migration
+     */
+    private addToDOList;
+    /**
+     * Get list of all DO IDs for a migration
+     */
+    private getDOList;
+}
+/**
+ * Create a KV-based progress storage instance
+ *
+ * @param config KV storage configuration
+ * @returns Configured KV progress storage
+ *
+ * @example
+ * ```typescript
+ * const storage = createKVProgressStorage({
+ *   kv: env.MIGRATION_PROGRESS_KV,
+ *   prefix: 'migrations',
+ *   expirationTtl: 604800, // 7 days
+ * })
+ * ```
+ */
+export declare function createKVProgressStorage(config: KVProgressStorageConfig): KVProgressStorage;
+//# sourceMappingURL=progress-tracker-kv.d.ts.map

package/dist/migrations/progress-tracker-kv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-tracker-kv.d.ts","sourceRoot":"","sources":["../../src/migrations/progress-tracker-kv.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EAClB,MAAM,oBAAoB,CAAA;AAE3B;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,2BAA2B;IAC3B,EAAE,EAAE,WAAW,CAAA;IACf,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,iBAAkB,YAAW,eAAe;IACvD,OAAO,CAAC,EAAE,CAAa;IACvB,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,aAAa,CAAQ;gBAEjB,MAAM,EAAE,uBAAuB;IAM3C;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAIrB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAU/E,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAWrE,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAa1F,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAWjF,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAgBjE,qBAAqB,CACzB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,eAAe,EAAE,CAAC;IAmBvB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BnD,cAAc,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAmBrD;;OAEG;YACW,iBAAiB;IAoC/B;;OAEG;YACW,WAAW;IAYzB;;OAEG;YACW,SAAS;CAMxB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,uBAAuB,GAAG,iBAAiB,CAE1F"}