@jantokic/chtype 0.2.0 → 0.4.0

package/dist/client/client.d.ts

@@ -6,8 +6,10 @@
 import { type ClickHouseClient as BaseClient, type ClickHouseClientConfigOptions } from '@clickhouse/client';
 import type { CompiledQuery, DatabaseSchema, InsertType, TableName } from '../query/types.js';
 export interface ChtypeClient<DB extends DatabaseSchema> {
-    /** Execute a compiled query and return typed rows. */
-    execute<T = Record<string, unknown>>(query: CompiledQuery): Promise<T[]>;
+    /** Execute a compiled query and return typed rows. Result type is inferred from the compiled query. */
+    execute<T = Record<string, unknown>>(query: CompiledQuery<T>): Promise<T[]>;
+    /** Execute a compiled query and return a typed async iterable for streaming large result sets. */
+    stream<T = Record<string, unknown>>(query: CompiledQuery<T>): AsyncIterable<T[]>;
     /** Execute a raw SQL query with optional parameters. */
     query<T = Record<string, unknown>>(sql: string, params?: Record<string, unknown>): Promise<T[]>;
     /** Insert rows into a table. Type-checked against the table's Insert type. */

package/dist/client/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,KAAK,gBAAgB,IAAI,UAAU,EACnC,KAAK,6BAA6B,EAEnC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9F,MAAM,WAAW,YAAY,CAAC,EAAE,SAAS,cAAc;IACrD,sDAAsD;IACtD,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAEzE,wDAAwD;IACxD,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAEhG,8EAA8E;IAC9E,MAAM,CAAC,CAAC,SAAS,SAAS,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpF;;;;;;OAMG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;CAC1B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,EAAE,SAAS,cAAc,EACpD,OAAO,EAAE,6BAA6B,GACrC,YAAY,CAAC,EAAE,CAAC,CA8ClB"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,KAAK,gBAAgB,IAAI,UAAU,EACnC,KAAK,6BAA6B,EAEnC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9F,MAAM,WAAW,YAAY,CAAC,EAAE,SAAS,cAAc;IACrD,uGAAuG;IACvG,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAE5E,kGAAkG;IAClG,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC;IAEjF,wDAAwD;IACxD,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAEhG,8EAA8E;IAC9E,MAAM,CAAC,CAAC,SAAS,SAAS,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpF;;;;;;OAMG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;CAC1B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,EAAE,SAAS,cAAc,EACpD,OAAO,EAAE,6BAA6B,GACrC,YAAY,CAAC,EAAE,CAAC,CA0DlB"}

package/dist/client/client.js

@@ -29,6 +29,17 @@ export function createClient(options) {
             });
             return result.json();
         },
+        async *stream(query) {
+            const result = await client.query({
+                query: query.sql,
+                query_params: query.params,
+                format: 'JSONEachRow',
+            });
+            const stream = result.stream();
+            for await (const rows of stream) {
+                yield rows.map((row) => row.json());
+            }
+        },
         async query(sql, params) {
             const result = await client.query({
                 query: sql,

package/dist/client/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAGL,YAAY,IAAI,gBAAgB,GACjC,MAAM,oBAAoB,CAAC;AA0B5B;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAsC;IAEtC,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAEzC,OAAO;QACL,KAAK,CAAC,OAAO,CAA8B,KAAoB;YAC7D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC;gBAChC,KAAK,EAAE,KAAK,CAAC,GAAG;gBAChB,YAAY,EAAE,KAAK,CAAC,MAAM;gBAC1B,MAAM,EAAE,aAAa;aACtB,CAAC,CAAC;YACH,OAAO,MAAM,CAAC,IAAI,EAAK,CAAC;QAC1B,CAAC;QAED,KAAK,CAAC,KAAK,CACT,GAAW,EACX,MAAgC;YAEhC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC;gBAChC,KAAK,EAAE,GAAG;gBACV,YAAY,EAAE,MAAM;gBACpB,MAAM,EAAE,aAAa;aACtB,CAAC,CAAC;YACH,OAAO,MAAM,CAAC,IAAI,EAAK,CAAC;QAC1B,CAAC;QAED,KAAK,CAAC,MAAM,CAA0B,KAAQ,EAAE,IAAyB;YACvE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO;YAC9B,MAAM,MAAM,CAAC,MAAM,CAAC;gBAClB,KAAK,EAAE,KAAe;gBACtB,MAAM,EAAE,IAAI;gBACZ,MAAM,EAAE,aAAa;aACtB,CAAC,CAAC;QACL,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,GAAW;YACvB,MAAM,MAAM,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QACvC,CAAC;QAED,KAAK,CAAC,KAAK;YACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;QAED,IAAI,GAAG;YACL,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAGL,YAAY,IAAI,gBAAgB,GACjC,MAAM,oBAAoB,CAAC;AA6B5B;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAsC;IAEtC,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAEzC,OAAO;QACL,KAAK,CAAC,OAAO,CAA8B,KAAuB;YAChE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC;gBAChC,KAAK,EAAE,KAAK,CAAC,GAAG;gBAChB,YAAY,EAAE,KAAK,CAAC,MAAM;gBAC1B,MAAM,EAAE,aAAa;aACtB,CAAC,CAAC;YACH,OAAO,MAAM,CAAC,IAAI,EAAK,CAAC;QAC1B,CAAC;QAED,KAAK,CAAC,CAAC,MAAM,CAA8B,KAAuB;YAChE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC;gBAChC,KAAK,EAAE,KAAK,CAAC,GAAG;gBAChB,YAAY,EAAE,KAAK,CAAC,MAAM;gBAC1B,MAAM,EAAE,aAAa;aACtB,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAK,CAAC;YAClC,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;gBAChC,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;QAED,KAAK,CAAC,KAAK,CACT,GAAW,EACX,MAAgC;YAEhC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC;gBAChC,KAAK,EAAE,GAAG;gBACV,YAAY,EAAE,MAAM;gBACpB,MAAM,EAAE,aAAa;aACtB,CAAC,CAAC;YACH,OAAO,MAAM,CAAC,IAAI,EAAK,CAAC;QAC1B,CAAC;QAED,KAAK,CAAC,MAAM,CAA0B,KAAQ,EAAE,IAAyB;YACvE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO;YAC9B,MAAM,MAAM,CAAC,MAAM,CAAC;gBAClB,KAAK,EAAE,KAAe;gBACtB,MAAM,EAAE,IAAI;gBACZ,MAAM,EAAE,aAAa;aACtB,CAAC,CAAC;QACL,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,GAAW;YACvB,MAAM,MAAM,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QACvC,CAAC;QAED,KAAK,CAAC,KAAK;YACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;QAED,IAAI,GAAG;YACL,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/migrate/differ.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Schema differ — compares two schemas (arrays of IntrospectedTable)
+ * and produces a structured diff describing all changes.
+ */
+import type { IntrospectedColumn, IntrospectedTable } from '../codegen/introspect.js';
+export type DiffAction = 'add' | 'drop' | 'modify';
+export interface ColumnDiff {
+    action: DiffAction;
+    column: IntrospectedColumn;
+    /** Present only when action is 'modify' — the column definition before the change. */
+    previous?: IntrospectedColumn;
+}
+export interface TableDiff {
+    action: DiffAction;
+    table: string;
+    /** Full table definition — present for 'add' (the new table) and 'drop' (the dropped table). */
+    definition?: IntrospectedTable;
+    /** Column-level changes — present only when action is 'modify'. */
+    columns?: ColumnDiff[];
+}
+export interface SchemaDiff {
+    tables: TableDiff[];
+    /** True when the two schemas are identical. */
+    isEmpty: boolean;
+}
+/**
+ * Compare two IntrospectedColumn values and return true if they differ
+ * in type, default kind, default expression, or comment.
+ *
+ * Key membership flags (isInSortingKey, isInPrimaryKey, isInPartitionKey) are
+ * intentionally excluded — changing ORDER BY / PARTITION BY requires table
+ * recreation in ClickHouse, which is out of scope for column-level diffing.
+ */
+export declare function columnsEqual(a: IntrospectedColumn, b: IntrospectedColumn): boolean;
+/**
+ * Diff two schemas and produce a list of table-level and column-level changes.
+ *
+ * @param from - The current / source schema (e.g. production snapshot).
+ * @param to   - The desired / target schema (e.g. dev database).
+ * @returns A SchemaDiff describing every change needed to go from `from` to `to`.
+ */
+export declare function diffSchemas(from: IntrospectedTable[], to: IntrospectedTable[]): SchemaDiff;
+//# sourceMappingURL=differ.d.ts.map

package/dist/migrate/differ.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"differ.d.ts","sourceRoot":"","sources":["../../src/migrate/differ.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAEtF,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEnD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,sFAAsF;IACtF,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC/B;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,gGAAgG;IAChG,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,mEAAmE;IACnE,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,+CAA+C;IAC/C,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,kBAAkB,EAAE,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAOlF;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,iBAAiB,EAAE,EAAE,EAAE,EAAE,iBAAiB,EAAE,GAAG,UAAU,CA8B1F"}

package/dist/migrate/differ.js

@@ -0,0 +1,77 @@
+/**
+ * Schema differ — compares two schemas (arrays of IntrospectedTable)
+ * and produces a structured diff describing all changes.
+ */
+/**
+ * Compare two IntrospectedColumn values and return true if they differ
+ * in type, default kind, default expression, or comment.
+ *
+ * Key membership flags (isInSortingKey, isInPrimaryKey, isInPartitionKey) are
+ * intentionally excluded — changing ORDER BY / PARTITION BY requires table
+ * recreation in ClickHouse, which is out of scope for column-level diffing.
+ */
+export function columnsEqual(a, b) {
+    return (a.type === b.type &&
+        a.defaultKind === b.defaultKind &&
+        a.defaultExpression === b.defaultExpression &&
+        a.comment === b.comment);
+}
+/**
+ * Diff two schemas and produce a list of table-level and column-level changes.
+ *
+ * @param from - The current / source schema (e.g. production snapshot).
+ * @param to   - The desired / target schema (e.g. dev database).
+ * @returns A SchemaDiff describing every change needed to go from `from` to `to`.
+ */
+export function diffSchemas(from, to) {
+    const fromMap = new Map(from.map((t) => [t.name, t]));
+    const toMap = new Map(to.map((t) => [t.name, t]));
+    const tables = [];
+    // Detect dropped tables (in `from` but not in `to`)
+    for (const [name, table] of fromMap) {
+        if (!toMap.has(name)) {
+            tables.push({ action: 'drop', table: name, definition: table });
+        }
+    }
+    // Detect new tables and modified tables
+    for (const [name, toTable] of toMap) {
+        const fromTable = fromMap.get(name);
+        if (!fromTable) {
+            tables.push({ action: 'add', table: name, definition: toTable });
+            continue;
+        }
+        // Table exists in both — diff columns
+        const columnDiffs = diffColumns(fromTable.columns, toTable.columns);
+        if (columnDiffs.length > 0) {
+            tables.push({ action: 'modify', table: name, columns: columnDiffs });
+        }
+    }
+    return { tables, isEmpty: tables.length === 0 };
+}
+/**
+ * Diff two column lists and return the set of column-level changes.
+ */
+function diffColumns(from, to) {
+    const fromMap = new Map(from.map((c) => [c.name, c]));
+    const toMap = new Map(to.map((c) => [c.name, c]));
+    const diffs = [];
+    // Dropped columns
+    for (const [name, col] of fromMap) {
+        if (!toMap.has(name)) {
+            diffs.push({ action: 'drop', column: col });
+        }
+    }
+    // New and modified columns
+    for (const [name, toCol] of toMap) {
+        const fromCol = fromMap.get(name);
+        if (!fromCol) {
+            diffs.push({ action: 'add', column: toCol });
+            continue;
+        }
+        if (!columnsEqual(fromCol, toCol)) {
+            diffs.push({ action: 'modify', column: toCol, previous: fromCol });
+        }
+    }
+    return diffs;
+}
+//# sourceMappingURL=differ.js.map

package/dist/migrate/differ.js.map

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

package/dist/migrate/generator.d.ts

@@ -0,0 +1,33 @@
+/**
+ * SQL generator — converts schema diffs into valid ClickHouse SQL statements.
+ *
+ * Produces CREATE TABLE, DROP TABLE, and ALTER TABLE ADD/DROP/MODIFY COLUMN statements.
+ */
+import type { IntrospectedTable } from '../codegen/introspect.js';
+import type { ColumnDiff, SchemaDiff } from './differ.js';
+/**
+ * Generate ClickHouse SQL statements from a SchemaDiff.
+ *
+ * Returns an array of SQL strings, one per statement.
+ */
+export declare function generateSQL(diff: SchemaDiff): string[];
+/**
+ * Generate a CREATE TABLE statement from a full table definition.
+ *
+ * Note: sortingKey, partitionKey, defaultExpression, and other values are
+ * trusted inputs from introspect.ts (sourced from system tables), not
+ * user-supplied strings, so they are emitted as-is without sanitization.
+ */
+export declare function generateCreateTable(table: IntrospectedTable): string;
+/**
+ * Generate a DROP TABLE statement.
+ */
+export declare function generateDropTable(tableName: string): string;
+/**
+ * Generate ALTER TABLE statements for column-level changes.
+ *
+ * Each column change produces a separate ALTER TABLE statement for clarity
+ * and to allow partial application.
+ */
+export declare function generateAlterTable(tableName: string, columns: ColumnDiff[]): string[];
+//# sourceMappingURL=generator.d.ts.map

package/dist/migrate/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/migrate/generator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAa,MAAM,aAAa,CAAC;AAErE;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,EAAE,CAsBtD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAgCpE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,EAAE,CAmCrF"}

package/dist/migrate/generator.js

@@ -0,0 +1,125 @@
+/**
+ * SQL generator — converts schema diffs into valid ClickHouse SQL statements.
+ *
+ * Produces CREATE TABLE, DROP TABLE, and ALTER TABLE ADD/DROP/MODIFY COLUMN statements.
+ */
+/**
+ * Generate ClickHouse SQL statements from a SchemaDiff.
+ *
+ * Returns an array of SQL strings, one per statement.
+ */
+export function generateSQL(diff) {
+    const statements = [];
+    for (const tableDiff of diff.tables) {
+        switch (tableDiff.action) {
+            case 'add':
+                if (tableDiff.definition) {
+                    statements.push(generateCreateTable(tableDiff.definition));
+                }
+                break;
+            case 'drop':
+                statements.push(generateDropTable(tableDiff.table));
+                break;
+            case 'modify':
+                if (tableDiff.columns) {
+                    statements.push(...generateAlterTable(tableDiff.table, tableDiff.columns));
+                }
+                break;
+        }
+    }
+    return statements;
+}
+/**
+ * Generate a CREATE TABLE statement from a full table definition.
+ *
+ * Note: sortingKey, partitionKey, defaultExpression, and other values are
+ * trusted inputs from introspect.ts (sourced from system tables), not
+ * user-supplied strings, so they are emitted as-is without sanitization.
+ */
+export function generateCreateTable(table) {
+    const columns = table.columns.map((col) => {
+        let def = `  ${quoteIdentifier(col.name)} ${col.type}`;
+        if (col.defaultKind && col.defaultExpression) {
+            def += ` ${col.defaultKind} ${col.defaultExpression}`;
+        }
+        if (col.comment) {
+            def += ` COMMENT ${quoteSingleString(col.comment)}`;
+        }
+        return def;
+    });
+    let sql = `CREATE TABLE ${quoteIdentifier(table.name)}\n(\n${columns.join(',\n')}\n)`;
+    sql += `\nENGINE = ${table.engineFull || table.engine}`;
+    // ORDER BY, PARTITION BY, and PRIMARY KEY are only valid for MergeTree-family engines.
+    // Emitting them for Log, Memory, Kafka, etc. produces invalid DDL.
+    const isMergeTree = table.engine.includes('MergeTree');
+    if (isMergeTree && table.partitionKey) {
+        sql += `\nPARTITION BY ${table.partitionKey}`;
+    }
+    if (isMergeTree && table.sortingKey) {
+        sql += `\nORDER BY (${table.sortingKey})`;
+    }
+    if (isMergeTree && table.primaryKey && table.primaryKey !== table.sortingKey) {
+        sql += `\nPRIMARY KEY (${table.primaryKey})`;
+    }
+    if (table.comment) {
+        sql += `\nCOMMENT ${quoteSingleString(table.comment)}`;
+    }
+    return sql;
+}
+/**
+ * Generate a DROP TABLE statement.
+ */
+export function generateDropTable(tableName) {
+    return `DROP TABLE ${quoteIdentifier(tableName)}`;
+}
+/**
+ * Generate ALTER TABLE statements for column-level changes.
+ *
+ * Each column change produces a separate ALTER TABLE statement for clarity
+ * and to allow partial application.
+ */
+export function generateAlterTable(tableName, columns) {
+    const statements = [];
+    const quoted = quoteIdentifier(tableName);
+    for (const diff of columns) {
+        switch (diff.action) {
+            case 'add': {
+                let clause = `ALTER TABLE ${quoted} ADD COLUMN ${quoteIdentifier(diff.column.name)} ${diff.column.type}`;
+                if (diff.column.defaultKind && diff.column.defaultExpression) {
+                    clause += ` ${diff.column.defaultKind} ${diff.column.defaultExpression}`;
+                }
+                if (diff.column.comment) {
+                    clause += ` COMMENT ${quoteSingleString(diff.column.comment)}`;
+                }
+                statements.push(clause);
+                break;
+            }
+            case 'drop':
+                statements.push(`ALTER TABLE ${quoted} DROP COLUMN ${quoteIdentifier(diff.column.name)}`);
+                break;
+            case 'modify': {
+                let clause = `ALTER TABLE ${quoted} MODIFY COLUMN ${quoteIdentifier(diff.column.name)} ${diff.column.type}`;
+                if (diff.column.defaultKind && diff.column.defaultExpression) {
+                    clause += ` ${diff.column.defaultKind} ${diff.column.defaultExpression}`;
+                }
+                if (diff.column.comment) {
+                    clause += ` COMMENT ${quoteSingleString(diff.column.comment)}`;
+                }
+                statements.push(clause);
+                break;
+            }
+        }
+    }
+    return statements;
+}
+/** Quote a ClickHouse identifier with backticks if it contains special characters. */
+function quoteIdentifier(name) {
+    if (/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(name))
+        return name;
+    return `\`${name.replace(/`/g, '\\`')}\``;
+}
+/** Escape and quote a string for use in SQL (single quotes). */
+function quoteSingleString(value) {
+    return `'${value.replace(/'/g, "\\'")}'`;
+}
+//# sourceMappingURL=generator.js.map

package/dist/migrate/generator.js.map

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

package/dist/migrate/index.d.ts

@@ -0,0 +1,4 @@
+export { diffSchemas, columnsEqual, type ColumnDiff, type TableDiff, type SchemaDiff, type DiffAction, } from './differ.js';
+export { generateSQL, generateCreateTable, generateDropTable, generateAlterTable, } from './generator.js';
+export { createSnapshot, saveSnapshot, loadSnapshot, type Snapshot, type SnapshotMeta, } from './snapshot.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/migrate/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/migrate/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,YAAY,EACZ,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,UAAU,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,KAAK,QAAQ,EACb,KAAK,YAAY,GAClB,MAAM,eAAe,CAAC"}

package/dist/migrate/index.js

@@ -0,0 +1,4 @@
+export { diffSchemas, columnsEqual, } from './differ.js';
+export { generateSQL, generateCreateTable, generateDropTable, generateAlterTable, } from './generator.js';
+export { createSnapshot, saveSnapshot, loadSnapshot, } from './snapshot.js';
+//# sourceMappingURL=index.js.map

package/dist/migrate/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/migrate/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,YAAY,GAKb,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,cAAc,EACd,YAAY,EACZ,YAAY,GAGb,MAAM,eAAe,CAAC"}

package/dist/migrate/snapshot.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Schema snapshot — save and load IntrospectedTable arrays as JSON files.
+ *
+ * Snapshots are the mechanism for comparing a live database against a
+ * previously captured schema state.
+ */
+import type { IntrospectedTable } from '../codegen/introspect.js';
+export interface SnapshotMeta {
+    version: 1;
+    createdAt: string;
+    database: string;
+}
+export interface Snapshot {
+    meta: SnapshotMeta;
+    tables: IntrospectedTable[];
+}
+/**
+ * Create a Snapshot object from introspected tables.
+ */
+export declare function createSnapshot(tables: IntrospectedTable[], database: string): Snapshot;
+/**
+ * Save a snapshot to a JSON file.
+ */
+export declare function saveSnapshot(snapshot: Snapshot, filePath: string): Promise<void>;
+/**
+ * Load a snapshot from a JSON file.
+ *
+ * Throws if the file does not exist or contains invalid JSON.
+ */
+export declare function loadSnapshot(filePath: string): Promise<Snapshot>;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/migrate/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/migrate/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,iBAAiB,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,iBAAiB,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAStF;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGtF;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAStE"}

package/dist/migrate/snapshot.js

@@ -0,0 +1,68 @@
+/**
+ * Schema snapshot — save and load IntrospectedTable arrays as JSON files.
+ *
+ * Snapshots are the mechanism for comparing a live database against a
+ * previously captured schema state.
+ */
+import { readFile, writeFile } from 'node:fs/promises';
+/**
+ * Create a Snapshot object from introspected tables.
+ */
+export function createSnapshot(tables, database) {
+    return {
+        meta: {
+            version: 1,
+            createdAt: new Date().toISOString(),
+            database,
+        },
+        tables,
+    };
+}
+/**
+ * Save a snapshot to a JSON file.
+ */
+export async function saveSnapshot(snapshot, filePath) {
+    const json = JSON.stringify(snapshot, null, 2);
+    await writeFile(filePath, json + '\n', 'utf-8');
+}
+/**
+ * Load a snapshot from a JSON file.
+ *
+ * Throws if the file does not exist or contains invalid JSON.
+ */
+export async function loadSnapshot(filePath) {
+    const raw = await readFile(filePath, 'utf-8');
+    const parsed = JSON.parse(raw);
+    if (!isSnapshot(parsed)) {
+        throw new Error(`Invalid snapshot file: ${filePath}`);
+    }
+    return parsed;
+}
+function isSnapshot(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const obj = value;
+    if (typeof obj['meta'] !== 'object' || obj['meta'] === null)
+        return false;
+    const meta = obj['meta'];
+    if (meta['version'] !== 1)
+        return false;
+    if (typeof meta['createdAt'] !== 'string')
+        return false;
+    if (typeof meta['database'] !== 'string')
+        return false;
+    if (!Array.isArray(obj['tables']))
+        return false;
+    // Validate each table entry has the minimum required shape
+    for (const entry of obj['tables']) {
+        if (typeof entry !== 'object' || entry === null)
+            return false;
+        const table = entry;
+        if (typeof table['name'] !== 'string')
+            return false;
+        if (!Array.isArray(table['columns']))
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/migrate/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/migrate/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAcvD;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAA2B,EAAE,QAAgB;IAC1E,OAAO;QACL,IAAI,EAAE;YACJ,OAAO,EAAE,CAAC;YACV,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,QAAQ;SACT;QACD,MAAM;KACP,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAkB,EAAE,QAAgB;IACrE,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC/C,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB;IACjD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAExC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,IAAI,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC1E,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAA4B,CAAC;IACpD,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,IAAI,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACxD,IAAI,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACvD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAEhD,2DAA2D;IAC3D,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,QAAQ,CAAc,EAAE,CAAC;QAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAC9D,MAAM,KAAK,GAAG,KAAgC,CAAC;QAC/C,IAAI,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QACpD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;IACrD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/query/compile-utils.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Shared compilation utilities for SELECT, DELETE, and UPDATE builders.
+ */
+import type { BetweenOp, ComparisonOp, SetOp, UnaryOp } from './types.js';
+import { Expression } from './expressions.js';
+import { Param } from './param.js';
+export type WhereClause = {
+    kind: 'comparison';
+    column: string;
+    op: ComparisonOp | SetOp;
+    value: Param | Expression;
+} | {
+    kind: 'unary';
+    column: string;
+    op: UnaryOp;
+} | {
+    kind: 'between';
+    column: string;
+    op: BetweenOp;
+    low: Param | Expression;
+    high: Param | Expression;
+} | {
+    kind: 'expression';
+    expr: Expression;
+};
+export interface CompileContext {
+    params: Record<string, unknown>;
+    /** Param names that came from subqueries/CTEs (external sources). */
+    externalParams: Set<string>;
+}
+export declare function createCompileContext(): CompileContext;
+export declare function mergeParams(ctx: CompileContext, source: Record<string, unknown>): void;
+export declare function renderValue(value: number | Param | Expression, ctx: CompileContext): string;
+export declare function renderWhereClause(w: WhereClause, ctx: CompileContext): string;
+/** Valid SQL identifier pattern (settings keys, CTE names, cluster names, column names). */
+export declare const VALID_IDENTIFIER: RegExp;
+//# sourceMappingURL=compile-utils.d.ts.map

package/dist/query/compile-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile-utils.d.ts","sourceRoot":"","sources":["../../src/query/compile-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,EAAkB,UAAU,EAAY,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,YAAY,GAAG,KAAK,CAAC;IAAC,KAAK,EAAE,KAAK,GAAG,UAAU,CAAA;CAAE,GAC3F;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,OAAO,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,KAAK,GAAG,UAAU,CAAC;IAAC,IAAI,EAAE,KAAK,GAAG,UAAU,CAAA;CAAE,GACrG;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AAE7C,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,qEAAqE;IACrE,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC7B;AAED,wBAAgB,oBAAoB,IAAI,cAAc,CAErD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAQtF;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,GAAG,UAAU,EAAE,GAAG,EAAE,cAAc,GAAG,MAAM,CAiB3F;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,cAAc,GAAG,MAAM,CAoB7E;AAED,4FAA4F;AAC5F,eAAO,MAAM,gBAAgB,QAA6B,CAAC"}

package/dist/query/compile-utils.js

@@ -0,0 +1,59 @@
+/**
+ * Shared compilation utilities for SELECT, DELETE, and UPDATE builders.
+ */
+import { ConditionGroup, Expression, Subquery } from './expressions.js';
+import { Param } from './param.js';
+export function createCompileContext() {
+    return { params: {}, externalParams: new Set() };
+}
+export function mergeParams(ctx, source) {
+    for (const key of Object.keys(source)) {
+        if (key in ctx.params) {
+            throw new Error(`Param name collision: "${key}" is used in both the subquery/CTE and outer query`);
+        }
+        ctx.params[key] = source[key];
+        ctx.externalParams.add(key);
+    }
+}
+export function renderValue(value, ctx) {
+    if (value instanceof Subquery) {
+        mergeParams(ctx, value.subqueryParams);
+        return value.sql;
+    }
+    if (value instanceof Param) {
+        if (ctx.externalParams.has(value.name)) {
+            throw new Error(`Param name collision: "${value.name}" is used in both the subquery/CTE and outer query`);
+        }
+        ctx.params[value.name] = undefined;
+        return value.toString();
+    }
+    if (value instanceof Expression) {
+        return value.sql;
+    }
+    // Only numbers reach here (from limit/offset)
+    return String(value);
+}
+export function renderWhereClause(w, ctx) {
+    switch (w.kind) {
+        case 'comparison':
+            return `${w.column} ${w.op} ${renderValue(w.value, ctx)}`;
+        case 'unary':
+            return `${w.column} ${w.op}`;
+        case 'between':
+            return `${w.column} ${w.op} ${renderValue(w.low, ctx)} AND ${renderValue(w.high, ctx)}`;
+        case 'expression': {
+            if (w.expr instanceof ConditionGroup) {
+                for (const p of w.expr.params) {
+                    if (ctx.externalParams.has(p.name)) {
+                        throw new Error(`Param name collision: "${p.name}" is used in both the subquery/CTE and outer query`);
+                    }
+                    ctx.params[p.name] = undefined;
+                }
+            }
+            return w.expr.sql;
+        }
+    }
+}
+/** Valid SQL identifier pattern (settings keys, CTE names, cluster names, column names). */
+export const VALID_IDENTIFIER = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
+//# sourceMappingURL=compile-utils.js.map

package/dist/query/compile-utils.js.map

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

package/dist/query/delete-builder.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Type-safe DELETE builder for ClickHouse.
+ *
+ * ClickHouse uses ALTER TABLE ... DELETE WHERE syntax.
+ * All values in WHERE must be Param or Expression — no raw strings.
+ */
+import type { BetweenOp, ColumnName, CompiledQuery, ComparisonOp, DatabaseSchema, SetOp, TableName, UnaryOp } from './types.js';
+import { Expression } from './expressions.js';
+import { Param } from './param.js';
+export declare class DeleteBuilder<DB extends DatabaseSchema, T extends TableName<DB> = TableName<DB>> {
+    private _table;
+    private _cluster?;
+    private _wheres;
+    constructor(table: T);
+    /** Specify the cluster for distributed deletes: ALTER TABLE ... ON CLUSTER ... */
+    onCluster(cluster: string): this;
+    where(column: ColumnName<DB, T> | Expression | string, op: ComparisonOp, value: Param | Expression): this;
+    where(column: ColumnName<DB, T> | Expression | string, op: SetOp, value: Param | Expression): this;
+    where(column: ColumnName<DB, T> | Expression | string, op: UnaryOp): this;
+    where(column: ColumnName<DB, T> | Expression | string, op: BetweenOp, value: [Param | Expression, Param | Expression]): this;
+    where(condition: Expression): this;
+    compile(): CompiledQuery;
+}
+//# sourceMappingURL=delete-builder.d.ts.map

package/dist/query/delete-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-builder.d.ts","sourceRoot":"","sources":["../../src/query/delete-builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,aAAa,EACb,YAAY,EACZ,cAAc,EACd,KAAK,EACL,SAAS,EACT,OAAO,EAER,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAQnC,qBAAa,aAAa,CACxB,EAAE,SAAS,cAAc,EACzB,CAAC,SAAS,SAAS,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,EAAE,CAAC;IAEvC,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAqB;gBAExB,KAAK,EAAE,CAAC;IAIpB,kFAAkF;IAClF,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQhC,KAAK,CACH,MAAM,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,UAAU,GAAG,MAAM,EAC/C,EAAE,EAAE,YAAY,EAChB,KAAK,EAAE,KAAK,GAAG,UAAU,GACxB,IAAI;IACP,KAAK,CACH,MAAM,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,UAAU,GAAG,MAAM,EAC/C,EAAE,EAAE,KAAK,EACT,KAAK,EAAE,KAAK,GAAG,UAAU,GACxB,IAAI;IACP,KAAK,CACH,MAAM,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,UAAU,GAAG,MAAM,EAC/C,EAAE,EAAE,OAAO,GACV,IAAI;IACP,KAAK,CACH,MAAM,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,UAAU,GAAG,MAAM,EAC/C,EAAE,EAAE,SAAS,EACb,KAAK,EAAE,CAAC,KAAK,GAAG,UAAU,EAAE,KAAK,GAAG,UAAU,CAAC,GAC9C,IAAI;IACP,KAAK,CAAC,SAAS,EAAE,UAAU,GAAG,IAAI;IAUlC,OAAO,IAAI,aAAa;CAazB"}