@dotdo/postgres 0.1.2 → 0.1.3

package/dist/do/postgres.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Postgres Durable Object
+ *
+ * A PostgreSQL database running in a Cloudflare Durable Object with:
+ * - DO SQLite for durable persistence (survives evictions)
+ * - PGLite for full PostgreSQL features (arrays, JSON, window functions, etc.)
+ * - Automatic sync between the two layers
+ *
+ * @example
+ * ```typescript
+ * import { sql, Postgres } from '@dotdo/postgres'
+ * export { Postgres }
+ *
+ * export default {
+ *   fetch: () => Response.json(await sql`SELECT * FROM posts`)
+ * }
+ * ```
+ */
+interface SqlStorage {
+    exec(query: string, ...bindings: unknown[]): SqlStorageCursor;
+}
+interface SqlStorageCursor {
+    [Symbol.iterator](): Iterator<Record<string, SqlStorageValue>>;
+    toArray(): Record<string, SqlStorageValue>[];
+    one(): Record<string, SqlStorageValue> | null;
+    raw<T>(): T[][];
+    columnNames: string[];
+    rowsRead: number;
+    rowsWritten: number;
+}
+type SqlStorageValue = string | number | null | ArrayBuffer;
+interface DurableObjectState {
+    storage: {
+        sql: SqlStorage;
+        get<T>(key: string): Promise<T | undefined>;
+        put<T>(key: string, value: T): Promise<void>;
+        delete(key: string): Promise<boolean>;
+    };
+    waitUntil(promise: Promise<unknown>): void;
+    id: {
+        toString(): string;
+    };
+}
+export interface PostgresEnv {
+    [key: string]: unknown;
+}
+export interface QueryResult<T = Record<string, unknown>> {
+    rows: T[];
+    rowCount: number;
+    fields?: {
+        name: string;
+        dataTypeID: number;
+    }[];
+}
+/**
+ * Postgres Durable Object
+ *
+ * Provides a full PostgreSQL database in each Durable Object instance.
+ * Data persists in DO SQLite and is loaded into PGLite on initialization.
+ */
+export declare class Postgres implements DurableObject {
+    private state;
+    private pglite;
+    private initPromise;
+    private initialized;
+    private sql;
+    constructor(state: DurableObjectState, _env: PostgresEnv);
+    /**
+     * Initialize DO SQLite schema for persistence
+     */
+    private initStorage;
+    /**
+     * Initialize PGLite and restore data from DO SQLite
+     */
+    private init;
+    /**
+     * Restore all tables and data from DO SQLite into PGLite
+     */
+    private restoreFromStorage;
+    /**
+     * Register a table schema for persistence
+     */
+    private registerTable;
+    /**
+     * Persist a row to DO SQLite
+     */
+    private persistRow;
+    /**
+     * Delete a row from DO SQLite
+     */
+    private deleteRowFromStorage;
+    /**
+     * Delete all rows from a table in DO SQLite
+     */
+    private deleteAllRowsFromStorage;
+    /**
+     * Execute a SQL query
+     */
+    query<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<QueryResult<T>>;
+    /**
+     * Execute SQL without returning results
+     */
+    exec(sql: string): Promise<void>;
+    /**
+     * Handle HTTP requests to the Durable Object
+     */
+    fetch(request: Request): Promise<Response>;
+}
+export default Postgres;
+//# sourceMappingURL=postgres.d.ts.map

package/dist/do/postgres.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.d.ts","sourceRoot":"","sources":["../../src/do/postgres.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,UAAU,UAAU;IAClB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAAA;CAC9D;AAED,UAAU,gBAAgB;IACxB,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAA;IAC9D,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EAAE,CAAA;IAC5C,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,IAAI,CAAA;IAC7C,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,CAAA;IACf,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,KAAK,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,WAAW,CAAA;AAE3D,UAAU,kBAAkB;IAC1B,OAAO,EAAE;QACP,GAAG,EAAE,UAAU,CAAA;QACf,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAA;QAC3C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;QAC5C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;KACtC,CAAA;IACD,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAA;IAC1C,EAAE,EAAE;QAAE,QAAQ,IAAI,MAAM,CAAA;KAAE,CAAA;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACtD,IAAI,EAAE,CAAC,EAAE,CAAA;IACT,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAChD;AAGD;;;;;GAKG;AACH,qBAAa,QAAS,YAAW,aAAa;IAO1C,OAAO,CAAC,KAAK;IANf,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,GAAG,CAAY;gBAGb,KAAK,EAAE,kBAAkB,EACjC,IAAI,EAAE,WAAW;IAMnB;;OAEG;IACH,OAAO,CAAC,WAAW;IAqCnB;;OAEG;YACW,IAAI;IAuBlB;;OAEG;YACW,kBAAkB;IAyChC;;OAEG;IACH,OAAO,CAAC,aAAa;IAQrB;;OAEG;IACH,OAAO,CAAC,UAAU;IAUlB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAQ5B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAOhC;;OAEG;IACG,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IA2ElG;;OAEG;IACG,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItC;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;CAyCjD;AAED,eAAe,QAAQ,CAAA"}

package/dist/do/postgres.js

@@ -0,0 +1,266 @@
+/**
+ * Postgres Durable Object
+ *
+ * A PostgreSQL database running in a Cloudflare Durable Object with:
+ * - DO SQLite for durable persistence (survives evictions)
+ * - PGLite for full PostgreSQL features (arrays, JSON, window functions, etc.)
+ * - Automatic sync between the two layers
+ *
+ * @example
+ * ```typescript
+ * import { sql, Postgres } from '@dotdo/postgres'
+ * export { Postgres }
+ *
+ * export default {
+ *   fetch: () => Response.json(await sql`SELECT * FROM posts`)
+ * }
+ * ```
+ */
+import { PGlite } from '@dotdo/pglite';
+/**
+ * Postgres Durable Object
+ *
+ * Provides a full PostgreSQL database in each Durable Object instance.
+ * Data persists in DO SQLite and is loaded into PGLite on initialization.
+ */
+export class Postgres {
+    state;
+    pglite = null;
+    initPromise = null;
+    initialized = false;
+    sql;
+    constructor(state, _env) {
+        this.state = state;
+        this.sql = state.storage.sql;
+        this.initStorage();
+    }
+    /**
+     * Initialize DO SQLite schema for persistence
+     */
+    initStorage() {
+        // Core metadata table
+        this.sql.exec(`
+      CREATE TABLE IF NOT EXISTS __pg_metadata (
+        key TEXT PRIMARY KEY,
+        value TEXT NOT NULL,
+        updated_at TEXT DEFAULT (datetime('now'))
+      )
+    `);
+        // Table registry - tracks all tables and their schemas
+        this.sql.exec(`
+      CREATE TABLE IF NOT EXISTS __pg_tables (
+        name TEXT PRIMARY KEY,
+        schema TEXT NOT NULL,
+        created_at TEXT DEFAULT (datetime('now'))
+      )
+    `);
+        // Generic data storage - stores all table data as JSON
+        this.sql.exec(`
+      CREATE TABLE IF NOT EXISTS __pg_data (
+        table_name TEXT NOT NULL,
+        row_id TEXT NOT NULL,
+        data TEXT NOT NULL,
+        created_at TEXT DEFAULT (datetime('now')),
+        updated_at TEXT DEFAULT (datetime('now')),
+        PRIMARY KEY (table_name, row_id)
+      )
+    `);
+        // Create index for faster queries
+        this.sql.exec(`
+      CREATE INDEX IF NOT EXISTS idx_pg_data_table ON __pg_data(table_name)
+    `);
+    }
+    /**
+     * Initialize PGLite and restore data from DO SQLite
+     */
+    async init() {
+        if (this.initialized && this.pglite) {
+            return;
+        }
+        if (this.initPromise) {
+            return this.initPromise;
+        }
+        this.initPromise = (async () => {
+            // Initialize PGLite (in-memory PostgreSQL)
+            this.pglite = new PGlite();
+            await this.pglite.waitReady;
+            // Restore tables and data from DO SQLite
+            await this.restoreFromStorage();
+            this.initialized = true;
+        })();
+        return this.initPromise;
+    }
+    /**
+     * Restore all tables and data from DO SQLite into PGLite
+     */
+    async restoreFromStorage() {
+        if (!this.pglite)
+            return;
+        // Get all registered tables
+        const tables = [...this.sql.exec('SELECT name, schema FROM __pg_tables')];
+        for (const table of tables) {
+            const tableName = table.name;
+            const schema = table.schema;
+            // Create table in PGLite
+            try {
+                await this.pglite.exec(schema);
+            }
+            catch (e) {
+                // Table might already exist, ignore
+            }
+            // Restore data for this table
+            const rows = [...this.sql.exec('SELECT row_id, data FROM __pg_data WHERE table_name = ?', tableName)];
+            for (const row of rows) {
+                const data = JSON.parse(row.data);
+                const columns = Object.keys(data);
+                const values = columns.map(c => data[c]);
+                const placeholders = columns.map((_, i) => `$${i + 1}`).join(', ');
+                try {
+                    await this.pglite.query(`INSERT INTO ${tableName} (${columns.join(', ')}) VALUES (${placeholders}) ON CONFLICT DO NOTHING`, values);
+                }
+                catch (e) {
+                    // Row might already exist or schema mismatch, continue
+                }
+            }
+        }
+    }
+    /**
+     * Register a table schema for persistence
+     */
+    registerTable(tableName, createStatement) {
+        this.sql.exec('INSERT OR REPLACE INTO __pg_tables (name, schema) VALUES (?, ?)', tableName, createStatement);
+    }
+    /**
+     * Persist a row to DO SQLite
+     */
+    persistRow(tableName, rowId, data) {
+        this.sql.exec(`INSERT OR REPLACE INTO __pg_data (table_name, row_id, data, updated_at)
+       VALUES (?, ?, ?, datetime('now'))`, tableName, rowId, JSON.stringify(data));
+    }
+    /**
+     * Delete a row from DO SQLite
+     */
+    deleteRowFromStorage(tableName, rowId) {
+        this.sql.exec('DELETE FROM __pg_data WHERE table_name = ? AND row_id = ?', tableName, rowId);
+    }
+    /**
+     * Delete all rows from a table in DO SQLite
+     */
+    deleteAllRowsFromStorage(tableName) {
+        this.sql.exec('DELETE FROM __pg_data WHERE table_name = ?', tableName);
+    }
+    /**
+     * Execute a SQL query
+     */
+    async query(sql, params) {
+        await this.init();
+        if (!this.pglite) {
+            throw new Error('PGLite not initialized');
+        }
+        // Detect and handle DDL statements
+        const upperSql = sql.trim().toUpperCase();
+        if (upperSql.startsWith('CREATE TABLE')) {
+            // Extract table name and register for persistence
+            const match = sql.match(/CREATE\s+TABLE\s+(?:IF\s+NOT\s+EXISTS\s+)?["']?(\w+)["']?/i);
+            if (match) {
+                this.registerTable(match[1], sql);
+            }
+        }
+        // Execute on PGLite
+        const result = await this.pglite.query(sql, params);
+        // Handle INSERT/UPDATE/DELETE - persist changes
+        if (upperSql.startsWith('INSERT') || upperSql.startsWith('UPDATE') || upperSql.startsWith('DELETE')) {
+            // Extract table name
+            let tableName = null;
+            if (upperSql.startsWith('INSERT')) {
+                const match = sql.match(/INSERT\s+INTO\s+["']?(\w+)["']?/i);
+                tableName = match?.[1] || null;
+            }
+            else if (upperSql.startsWith('UPDATE')) {
+                const match = sql.match(/UPDATE\s+["']?(\w+)["']?/i);
+                tableName = match?.[1] || null;
+            }
+            else if (upperSql.startsWith('DELETE')) {
+                const match = sql.match(/DELETE\s+FROM\s+["']?(\w+)["']?/i);
+                tableName = match?.[1] || null;
+            }
+            // For RETURNING clauses, persist the returned rows (INSERT/UPDATE)
+            if (tableName && (upperSql.startsWith('INSERT') || upperSql.startsWith('UPDATE'))) {
+                if (result.rows && result.rows.length > 0) {
+                    for (const row of result.rows) {
+                        const rowId = row.id || row._id || JSON.stringify(row);
+                        this.persistRow(tableName, rowId, row);
+                    }
+                }
+            }
+            // For DELETE with RETURNING, remove the deleted rows
+            if (tableName && upperSql.startsWith('DELETE')) {
+                if (result.rows && result.rows.length > 0) {
+                    for (const row of result.rows) {
+                        const rowId = row.id || row._id || JSON.stringify(row);
+                        this.deleteRowFromStorage(tableName, rowId);
+                    }
+                }
+                else {
+                    // DELETE without RETURNING - sync entire table
+                    // This is expensive but ensures consistency
+                    this.deleteAllRowsFromStorage(tableName);
+                    // Re-persist all remaining rows
+                    const allRows = await this.pglite.query(`SELECT * FROM ${tableName}`);
+                    for (const row of allRows.rows) {
+                        const rowId = row.id || row._id || JSON.stringify(row);
+                        this.persistRow(tableName, rowId, row);
+                    }
+                }
+            }
+        }
+        return {
+            rows: result.rows,
+            rowCount: result.rows?.length || 0,
+            fields: result.fields?.map(f => ({ name: f.name, dataTypeID: f.dataTypeID })),
+        };
+    }
+    /**
+     * Execute SQL without returning results
+     */
+    async exec(sql) {
+        await this.query(sql);
+    }
+    /**
+     * Handle HTTP requests to the Durable Object
+     */
+    async fetch(request) {
+        try {
+            await this.init();
+            const url = new URL(request.url);
+            // POST /query - Execute SQL
+            if (url.pathname === '/query' && request.method === 'POST') {
+                const body = await request.json();
+                if (!body.sql) {
+                    return Response.json({ error: 'Missing sql' }, { status: 400 });
+                }
+                const result = await this.query(body.sql, body.params);
+                return Response.json(result);
+            }
+            // GET /health - Health check
+            if (url.pathname === '/health') {
+                return Response.json({
+                    ok: true,
+                    initialized: this.initialized,
+                    id: this.state.id.toString(),
+                });
+            }
+            // GET /tables - List tables
+            if (url.pathname === '/tables') {
+                const tables = [...this.sql.exec('SELECT name FROM __pg_tables')];
+                return Response.json({ tables: tables.map(t => t.name) });
+            }
+            return Response.json({ error: 'Not found' }, { status: 404 });
+        }
+        catch (error) {
+            return Response.json({ error: error instanceof Error ? error.message : 'Unknown error' }, { status: 500 });
+        }
+    }
+}
+export default Postgres;
+//# sourceMappingURL=postgres.js.map

package/dist/do/postgres.js.map

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

package/dist/do/sql.d.ts

@@ -0,0 +1,92 @@
+/**
+ * SQL Tagged Template & Database Client
+ *
+ * Execute PostgreSQL queries with a simple API.
+ * Automatically routes to the Postgres Durable Object using cloudflare:workers env.
+ *
+ * @example
+ * ```typescript
+ * import { sql, db } from '@dotdo/postgres'
+ *
+ * // Tagged template (safe from SQL injection)
+ * const posts = await sql`SELECT * FROM posts WHERE id = ${id}`
+ *
+ * // db.query for dynamic queries
+ * const result = await db.query('SELECT * FROM posts')
+ * ```
+ */
+export interface SqlConfig {
+    /** DO binding name (default: 'POSTGRES') */
+    binding?: string;
+    /** DO instance name (default: 'default') */
+    instance?: string;
+}
+export interface SqlResult<T = Record<string, unknown>> {
+    rows: T[];
+    rowCount: number;
+    fields?: {
+        name: string;
+        dataTypeID: number;
+    }[];
+}
+type DOStub = {
+    fetch(request: Request): Promise<Response>;
+};
+/**
+ * SQL tagged template - safe parameterized queries
+ *
+ * @example
+ * ```typescript
+ * import { sql } from '@dotdo/postgres'
+ *
+ * const posts = await sql`SELECT * FROM posts`
+ * const post = await sql`SELECT * FROM posts WHERE id = ${id}`
+ * const newPost = await sql`INSERT INTO posts (title) VALUES (${title}) RETURNING *`
+ * ```
+ */
+export declare function sql<T = Record<string, unknown>>(strings: TemplateStringsArray, ...values: unknown[]): Promise<SqlResult<T>>;
+export declare namespace sql {
+    var unsafe: <T = Record<string, unknown>>(query: string, params?: unknown[]) => Promise<SqlResult<T>>;
+}
+/**
+ * Database client for programmatic access
+ *
+ * @example
+ * ```typescript
+ * import { db } from '@dotdo/postgres'
+ *
+ * const result = await db.query('SELECT * FROM posts')
+ * await db.exec('CREATE TABLE posts (id SERIAL PRIMARY KEY, title TEXT)')
+ * ```
+ */
+export declare const db: {
+    /**
+     * Execute a query and return results
+     */
+    query<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<SqlResult<T>>;
+    /**
+     * Execute SQL without returning results (DDL, etc.)
+     */
+    exec(sql: string): Promise<void>;
+    /**
+     * Get raw access to the DO stub for advanced use cases
+     */
+    getStub(): Promise<DOStub>;
+};
+/**
+ * Create a sql function bound to a specific binding/instance
+ */
+export declare function createSql(env: Record<string, unknown>, config?: SqlConfig): {
+    <T = Record<string, unknown>>(strings: TemplateStringsArray, ...values: unknown[]): Promise<SqlResult<T>>;
+    unsafe<T = Record<string, unknown>>(query: string, params?: unknown[]): Promise<SqlResult<T>>;
+};
+/**
+ * Create a db client bound to a specific binding/instance
+ */
+export declare function createDb(env: Record<string, unknown>, config?: SqlConfig): {
+    query<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<SqlResult<T>>;
+    exec(sql: string): Promise<void>;
+    getStub(): DOStub;
+};
+export default sql;
+//# sourceMappingURL=sql.d.ts.map

package/dist/do/sql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql.d.ts","sourceRoot":"","sources":["../../src/do/sql.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,SAAS;IACxB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,SAAS,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACpD,IAAI,EAAE,CAAC,EAAE,CAAA;IACT,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAChD;AASD,KAAK,MAAM,GAAG;IACZ,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;CAC3C,CAAA;AAwED;;;;;;;;;;;GAWG;AACH,wBAAsB,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnD,OAAO,EAAE,oBAAoB,EAC7B,GAAG,MAAM,EAAE,OAAO,EAAE,GACnB,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAGvB;yBANqB,GAAG;iBAWG,CAAC,mCACpB,MAAM,WACJ,OAAO,EAAE,KACjB,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;;AAQxB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,EAAE;IACb;;OAEG;UACS,CAAC,iCAAiC,MAAM,WAAW,OAAO,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAIhG;;OAEG;cACa,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItC;;OAEG;eACc,OAAO,CAAC,MAAM,CAAC;CAGjC,CAAA;AAMD;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAE,SAAc;KAWpD,CAAC,qCACd,oBAAoB,aAClB,OAAO,EAAE,GACnB,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;WAiBS,CAAC,mCACzB,MAAM,WACJ,OAAO,EAAE,GACjB,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;EAgBzB;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAE,SAAc;UAY7D,CAAC,iCAAiC,MAAM,WAAW,OAAO,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;cAehF,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;eAI3B,MAAM;EAIpB;AAED,eAAe,GAAG,CAAA"}