daycare-cli 0.0.0-canary.00a24ac

package/dist/services/psql/psqlSchemaApply.js

@@ -0,0 +1,96 @@
+import { psqlColumnTypeToPg } from "./psqlColumnTypeToPg.js";
+import { psqlIdentifierQuote } from "./psqlIdentifierQuote.js";
+import { PSQL_SYSTEM_COLUMNS } from "./psqlTypes.js";
+/**
+ * Applies additive schema changes to a target database.
+ * Expects: diff.errors is empty and change list comes from psqlSchemaDiff.
+ */
+export async function psqlSchemaApply(db, diff) {
+    if (diff.errors.length > 0) {
+        throw new Error(`Schema diff has blocking errors: ${diff.errors.join("; ")}`);
+    }
+    const executedSql = [];
+    for (const change of diff.changes) {
+        if (change.kind === "table_add") {
+            const createTableSql = tableCreateSqlBuild(change.table.name, change.table.columns);
+            const createIndexSql = tableCurrentIndexSqlBuild(change.table.name);
+            const tableCommentSql = tableCommentSqlBuild(change.table.name, change.table.comment);
+            await db.exec(createTableSql);
+            await db.exec(createIndexSql);
+            await db.exec(tableCommentSql);
+            executedSql.push(createTableSql, createIndexSql, tableCommentSql);
+            for (const column of change.table.columns) {
+                const columnCommentSql = columnCommentSqlBuild(change.table.name, column.name, column.comment);
+                await db.exec(columnCommentSql);
+                executedSql.push(columnCommentSql);
+            }
+            continue;
+        }
+        if (change.kind === "column_add") {
+            const alterSql = columnAddSqlBuild(change.table, change.column);
+            const columnCommentSql = columnCommentSqlBuild(change.table, change.column.name, change.column.comment);
+            await db.exec(alterSql);
+            await db.exec(columnCommentSql);
+            executedSql.push(alterSql, columnCommentSql);
+            continue;
+        }
+        if (change.kind === "table_comment_set") {
+            const tableCommentSql = tableCommentSqlBuild(change.table, change.comment);
+            await db.exec(tableCommentSql);
+            executedSql.push(tableCommentSql);
+            continue;
+        }
+        const columnCommentSql = columnCommentSqlBuild(change.table, change.column, change.comment);
+        await db.exec(columnCommentSql);
+        executedSql.push(columnCommentSql);
+    }
+    return {
+        sql: executedSql
+    };
+}
+function tableCreateSqlBuild(tableName, businessColumns) {
+    const quotedTable = psqlIdentifierQuote(tableName);
+    const systemColumns = [
+        '"id" text NOT NULL',
+        '"version" integer NOT NULL',
+        '"valid_from" bigint NOT NULL',
+        '"valid_to" bigint',
+        '"created_at" bigint NOT NULL',
+        '"updated_at" bigint NOT NULL'
+    ];
+    const business = businessColumns.map((column) => columnSqlBuild(column));
+    return `CREATE TABLE ${quotedTable} (${[...systemColumns, ...business, 'PRIMARY KEY ("id", "version")'].join(", ")})`;
+}
+function tableCurrentIndexSqlBuild(tableName) {
+    const quotedTable = psqlIdentifierQuote(tableName);
+    const quotedIndex = psqlIdentifierQuote(`idx_${tableName}_current_id`);
+    return `CREATE UNIQUE INDEX ${quotedIndex} ON ${quotedTable} ("id") WHERE "valid_to" IS NULL`;
+}
+function columnAddSqlBuild(tableName, column) {
+    const quotedTable = psqlIdentifierQuote(tableName);
+    return `ALTER TABLE ${quotedTable} ADD COLUMN ${columnSqlBuild(column)}`;
+}
+function tableCommentSqlBuild(tableName, comment) {
+    const quotedTable = psqlIdentifierQuote(tableName);
+    return `COMMENT ON TABLE ${quotedTable} IS ${psqlStringLiteralQuote(comment)}`;
+}
+function columnCommentSqlBuild(tableName, columnName, comment) {
+    const quotedTable = psqlIdentifierQuote(tableName);
+    const quotedColumn = psqlIdentifierQuote(columnName);
+    return `COMMENT ON COLUMN ${quotedTable}.${quotedColumn} IS ${psqlStringLiteralQuote(comment)}`;
+}
+function columnSqlBuild(column) {
+    const quotedColumn = psqlIdentifierQuote(column.name);
+    const typeSql = psqlColumnTypeToPg(column.type);
+    if (column.nullable) {
+        return `${quotedColumn} ${typeSql}`;
+    }
+    return `${quotedColumn} ${typeSql} NOT NULL`;
+}
+function psqlStringLiteralQuote(value) {
+    return `'${value.replaceAll("'", "''")}'`;
+}
+export function psqlSystemColumnNameIs(columnName) {
+    return PSQL_SYSTEM_COLUMNS.some((column) => column.name === columnName);
+}
+//# sourceMappingURL=psqlSchemaApply.js.map

package/dist/services/psql/psqlSchemaApply.js.map

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

package/dist/services/psql/psqlSchemaApply.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=psqlSchemaApply.spec.d.ts.map

package/dist/services/psql/psqlSchemaApply.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"psqlSchemaApply.spec.d.ts","sourceRoot":"","sources":["../../../sources/services/psql/psqlSchemaApply.spec.ts"],"names":[],"mappings":""}

package/dist/services/psql/psqlSchemaApply.spec.js

@@ -0,0 +1,63 @@
+import { PGlite } from "@electric-sql/pglite";
+import { afterEach, describe, expect, it } from "vitest";
+import { psqlSchemaApply } from "./psqlSchemaApply.js";
+import { psqlSchemaDiff } from "./psqlSchemaDiff.js";
+import { psqlSchemaIntrospect } from "./psqlSchemaIntrospect.js";
+describe("psqlSchemaApply", () => {
+    const databases = [];
+    afterEach(async () => {
+        await Promise.all(databases.map(async (db) => db.close()));
+        databases.length = 0;
+    });
+    it("creates tables and adds columns", async () => {
+        const db = new PGlite();
+        databases.push(db);
+        const firstDesired = {
+            name: "contacts",
+            comment: "Contact records",
+            columns: [{ name: "first_name", type: "text", comment: "Given name" }]
+        };
+        const firstDiff = psqlSchemaDiff(firstDesired, null);
+        await psqlSchemaApply(db, firstDiff);
+        let schema = await psqlSchemaIntrospect(db);
+        expect(schema).toEqual({
+            tables: [
+                {
+                    name: "contacts",
+                    comment: "Contact records",
+                    columns: [{ name: "first_name", type: "text", comment: "Given name", nullable: false }]
+                }
+            ]
+        });
+        const nextDesired = {
+            name: "contacts",
+            comment: "Contact records",
+            columns: [
+                { name: "first_name", type: "text", comment: "Given name" },
+                { name: "age", type: "integer", comment: "Age in years", nullable: true }
+            ]
+        };
+        const currentTable = schema.tables.find((table) => table.name === "contacts") ?? null;
+        const nextDiff = psqlSchemaDiff(nextDesired, currentTable);
+        await psqlSchemaApply(db, nextDiff);
+        schema = await psqlSchemaIntrospect(db);
+        expect(schema).toEqual({
+            tables: [
+                {
+                    name: "contacts",
+                    comment: "Contact records",
+                    columns: [
+                        { name: "first_name", type: "text", comment: "Given name", nullable: false },
+                        { name: "age", type: "integer", comment: "Age in years", nullable: true }
+                    ]
+                }
+            ]
+        });
+    });
+    it("rejects apply when diff has errors", async () => {
+        const db = new PGlite();
+        databases.push(db);
+        await expect(psqlSchemaApply(db, { changes: [], errors: ["x"] })).rejects.toThrow("blocking errors");
+    });
+});
+//# sourceMappingURL=psqlSchemaApply.spec.js.map

package/dist/services/psql/psqlSchemaApply.spec.js.map

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

package/dist/services/psql/psqlSchemaDiff.d.ts

@@ -0,0 +1,7 @@
+import type { PsqlSchemaDiffResult, PsqlTableSchema } from "./psqlTypes.js";
+/**
+ * Computes additive field-level schema changes for a single table.
+ * Expects: desired/current table declarations use normalized names.
+ */
+export declare function psqlSchemaDiff(desired: PsqlTableSchema, current: PsqlTableSchema | null): PsqlSchemaDiffResult;
+//# sourceMappingURL=psqlSchemaDiff.d.ts.map

package/dist/services/psql/psqlSchemaDiff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"psqlSchemaDiff.d.ts","sourceRoot":"","sources":["../../../sources/services/psql/psqlSchemaDiff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,oBAAoB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE3F;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,GAAG,oBAAoB,CA8E9G"}

package/dist/services/psql/psqlSchemaDiff.js

@@ -0,0 +1,113 @@
+/**
+ * Computes additive field-level schema changes for a single table.
+ * Expects: desired/current table declarations use normalized names.
+ */
+export function psqlSchemaDiff(desired, current) {
+    const errors = [];
+    const changes = [];
+    const desiredTable = tableNormalize(desired, "desired", errors);
+    if (!desiredTable) {
+        return { changes, errors };
+    }
+    const currentTable = current ? tableNormalize(current, "current", errors) : null;
+    if (!currentTable) {
+        changes.push({ kind: "table_add", table: desiredTable });
+        return { changes, errors };
+    }
+    if (desiredTable.name !== currentTable.name) {
+        errors.push(`Table name mismatch is not allowed: ${currentTable.name} -> ${desiredTable.name}`);
+        return { changes, errors };
+    }
+    if (desiredTable.comment !== currentTable.comment) {
+        changes.push({
+            kind: "table_comment_set",
+            table: desiredTable.name,
+            comment: desiredTable.comment
+        });
+    }
+    const desiredColumns = columnMapBuild(desiredTable, "desired", errors);
+    const currentColumns = columnMapBuild(currentTable, "current", errors);
+    const removedColumns = [];
+    for (const currentColumnName of currentColumns.keys()) {
+        if (!desiredColumns.has(currentColumnName)) {
+            removedColumns.push(currentColumnName);
+            errors.push(`Column removal is not allowed: ${desiredTable.name}.${currentColumnName}`);
+        }
+    }
+    const addedColumns = [];
+    for (const [columnName, desiredColumn] of desiredColumns.entries()) {
+        const currentColumn = currentColumns.get(columnName);
+        if (!currentColumn) {
+            addedColumns.push(columnName);
+            changes.push({ kind: "column_add", table: desiredTable.name, column: desiredColumn });
+            continue;
+        }
+        if (desiredColumn.comment !== currentColumn.comment) {
+            changes.push({
+                kind: "column_comment_set",
+                table: desiredTable.name,
+                column: columnName,
+                comment: desiredColumn.comment
+            });
+        }
+        if (currentColumn.type !== desiredColumn.type) {
+            errors.push(`Column type change is not allowed: ${desiredTable.name}.${columnName} ${currentColumn.type} -> ${desiredColumn.type}`);
+        }
+        const currentNullable = currentColumn.nullable ?? false;
+        const desiredNullable = desiredColumn.nullable ?? false;
+        if (currentNullable !== desiredNullable) {
+            errors.push(`Column nullability change is not allowed: ${desiredTable.name}.${columnName} ${currentNullable} -> ${desiredNullable}`);
+        }
+    }
+    if (removedColumns.length > 0 && addedColumns.length > 0) {
+        errors.push(`Column rename is not allowed on ${desiredTable.name}: removed [${removedColumns.join(", ")}], added [${addedColumns.join(", ")}]`);
+    }
+    return { changes, errors };
+}
+function tableNormalize(table, source, errors) {
+    const name = table.name.trim();
+    if (!name) {
+        errors.push(`${source} schema contains a table with empty name.`);
+        return null;
+    }
+    const comment = table.comment.trim();
+    if (source === "desired" && comment.length === 0) {
+        errors.push(`${source} schema table ${name} requires a non-empty comment.`);
+    }
+    return {
+        name,
+        comment,
+        columns: table.columns.map((column) => ({
+            name: column.name.trim(),
+            type: column.type,
+            comment: column.comment.trim(),
+            nullable: column.nullable ?? false
+        }))
+    };
+}
+function columnMapBuild(table, source, errors) {
+    const map = new Map();
+    for (const column of table.columns) {
+        const name = column.name.trim();
+        if (!name) {
+            errors.push(`${source} schema table ${table.name} has a column with empty name.`);
+            continue;
+        }
+        if (map.has(name)) {
+            errors.push(`${source} schema table ${table.name} has duplicate column: ${name}`);
+            continue;
+        }
+        const comment = column.comment.trim();
+        if (source === "desired" && comment.length === 0) {
+            errors.push(`${source} schema table ${table.name} column ${name} requires a non-empty comment.`);
+        }
+        map.set(name, {
+            name,
+            type: column.type,
+            comment,
+            nullable: column.nullable ?? false
+        });
+    }
+    return map;
+}
+//# sourceMappingURL=psqlSchemaDiff.js.map

package/dist/services/psql/psqlSchemaDiff.js.map

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

package/dist/services/psql/psqlSchemaDiff.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=psqlSchemaDiff.spec.d.ts.map

package/dist/services/psql/psqlSchemaDiff.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"psqlSchemaDiff.spec.d.ts","sourceRoot":"","sources":["../../../sources/services/psql/psqlSchemaDiff.spec.ts"],"names":[],"mappings":""}

package/dist/services/psql/psqlSchemaDiff.spec.js

@@ -0,0 +1,130 @@
+import { describe, expect, it } from "vitest";
+import { psqlSchemaDiff } from "./psqlSchemaDiff.js";
+describe("psqlSchemaDiff", () => {
+    it("detects new table creation", () => {
+        const desired = {
+            name: "companies",
+            comment: "Company records",
+            columns: [{ name: "name", type: "text", comment: "Company name" }]
+        };
+        const result = psqlSchemaDiff(desired, null);
+        expect(result.errors).toEqual([]);
+        expect(result.changes).toEqual([
+            {
+                kind: "table_add",
+                table: {
+                    name: "companies",
+                    comment: "Company records",
+                    columns: [{ name: "name", type: "text", comment: "Company name", nullable: false }]
+                }
+            }
+        ]);
+    });
+    it("detects added fields on an existing table", () => {
+        const current = {
+            name: "contacts",
+            comment: "Contact records",
+            columns: [{ name: "first_name", type: "text", comment: "Given name" }]
+        };
+        const desired = {
+            name: "contacts",
+            comment: "Contact records",
+            columns: [
+                { name: "first_name", type: "text", comment: "Given name" },
+                { name: "age", type: "integer", comment: "Age in years", nullable: true }
+            ]
+        };
+        const result = psqlSchemaDiff(desired, current);
+        expect(result.errors).toEqual([]);
+        expect(result.changes).toEqual([
+            {
+                kind: "column_add",
+                table: "contacts",
+                column: { name: "age", type: "integer", comment: "Age in years", nullable: true }
+            }
+        ]);
+    });
+    it("rejects removals", () => {
+        const current = {
+            name: "contacts",
+            comment: "Contact records",
+            columns: [
+                { name: "first_name", type: "text", comment: "Given name" },
+                { name: "age", type: "integer", comment: "Age in years" }
+            ]
+        };
+        const desired = {
+            name: "contacts",
+            comment: "Contact records",
+            columns: [{ name: "first_name", type: "text", comment: "Given name" }]
+        };
+        const result = psqlSchemaDiff(desired, current);
+        expect(result.errors).toContain("Column removal is not allowed: contacts.age");
+    });
+    it("rejects type changes", () => {
+        const current = {
+            name: "contacts",
+            comment: "Contact records",
+            columns: [{ name: "age", type: "integer", comment: "Age in years" }]
+        };
+        const desired = {
+            name: "contacts",
+            comment: "Contact records",
+            columns: [{ name: "age", type: "text", comment: "Age in years" }]
+        };
+        const result = psqlSchemaDiff(desired, current);
+        expect(result.errors).toContain("Column type change is not allowed: contacts.age integer -> text");
+    });
+    it("rejects table name mismatch", () => {
+        const current = {
+            name: "contacts",
+            comment: "Contact records",
+            columns: [{ name: "name", type: "text", comment: "Name" }]
+        };
+        const desired = {
+            name: "people",
+            comment: "People records",
+            columns: [{ name: "name", type: "text", comment: "Name" }]
+        };
+        const result = psqlSchemaDiff(desired, current);
+        expect(result.errors).toEqual(["Table name mismatch is not allowed: contacts -> people"]);
+    });
+    it("rejects field removals in field-level diff", () => {
+        const current = {
+            name: "contacts",
+            comment: "Contact records",
+            columns: [{ name: "name", type: "text", comment: "Name" }]
+        };
+        const desired = {
+            name: "contacts",
+            comment: "Contact records",
+            columns: []
+        };
+        const result = psqlSchemaDiff(desired, current);
+        expect(result.errors).toEqual(["Column removal is not allowed: contacts.name"]);
+    });
+    it("detects comment updates", () => {
+        const current = {
+            name: "contacts",
+            comment: "",
+            columns: [{ name: "first_name", type: "text", comment: "" }]
+        };
+        const desired = {
+            name: "contacts",
+            comment: "Contact records",
+            columns: [{ name: "first_name", type: "text", comment: "Given name" }]
+        };
+        const result = psqlSchemaDiff(desired, current);
+        expect(result.errors).toEqual([]);
+        expect(result.changes).toEqual([
+            { kind: "table_comment_set", table: "contacts", comment: "Contact records" },
+            {
+                kind: "column_comment_set",
+                table: "contacts",
+                column: "first_name",
+                comment: "Given name"
+            }
+        ]);
+    });
+});
+//# sourceMappingURL=psqlSchemaDiff.spec.js.map

package/dist/services/psql/psqlSchemaDiff.spec.js.map

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

package/dist/services/psql/psqlSchemaIntrospect.d.ts

@@ -0,0 +1,7 @@
+import { type PsqlClient, type PsqlSchemaDeclaration } from "./psqlTypes.js";
+/**
+ * Reads current schema state from a PGlite database and emits declaration JSON.
+ * Expects: db is an open PostgreSQL-compatible client.
+ */
+export declare function psqlSchemaIntrospect(db: PsqlClient): Promise<PsqlSchemaDeclaration>;
+//# sourceMappingURL=psqlSchemaIntrospect.d.ts.map

package/dist/services/psql/psqlSchemaIntrospect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"psqlSchemaIntrospect.d.ts","sourceRoot":"","sources":["../../../sources/services/psql/psqlSchemaIntrospect.ts"],"names":[],"mappings":"AACA,OAAO,EAAuB,KAAK,UAAU,EAAE,KAAK,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAgBlG;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAkEzF"}

package/dist/services/psql/psqlSchemaIntrospect.js

@@ -0,0 +1,65 @@
+import { psqlColumnTypeFromPg } from "./psqlColumnTypeFromPg.js";
+import { PSQL_SYSTEM_COLUMNS } from "./psqlTypes.js";
+/**
+ * Reads current schema state from a PGlite database and emits declaration JSON.
+ * Expects: db is an open PostgreSQL-compatible client.
+ */
+export async function psqlSchemaIntrospect(db) {
+    const tables = await db.query(`
+        SELECT tables.table_name, obj_description(classes.oid, 'pg_class') AS table_comment
+        FROM information_schema.tables AS tables
+        JOIN pg_catalog.pg_class AS classes ON classes.relname = tables.table_name
+        JOIN pg_catalog.pg_namespace AS namespaces ON namespaces.oid = classes.relnamespace
+        WHERE tables.table_schema = 'public'
+          AND tables.table_type = 'BASE TABLE'
+          AND namespaces.nspname = tables.table_schema
+        ORDER BY tables.table_name ASC
+        `);
+    const rows = await db.query(`
+        SELECT
+            columns.table_name,
+            columns.column_name,
+            columns.data_type,
+            columns.is_nullable,
+            columns.ordinal_position,
+            col_description(classes.oid, attributes.attnum) AS column_comment
+        FROM information_schema.columns AS columns
+        JOIN pg_catalog.pg_class AS classes ON classes.relname = columns.table_name
+        JOIN pg_catalog.pg_namespace AS namespaces ON namespaces.oid = classes.relnamespace
+        JOIN pg_catalog.pg_attribute AS attributes ON attributes.attrelid = classes.oid
+        WHERE columns.table_schema = 'public'
+          AND namespaces.nspname = columns.table_schema
+          AND attributes.attname = columns.column_name
+          AND attributes.attnum > 0
+          AND NOT attributes.attisdropped
+        ORDER BY columns.table_name ASC, columns.ordinal_position ASC
+        `);
+    const systemColumnNames = new Set(PSQL_SYSTEM_COLUMNS.map((column) => column.name));
+    const byTable = new Map();
+    for (const table of tables.rows) {
+        byTable.set(table.table_name, {
+            name: table.table_name,
+            comment: table.table_comment?.trim() ?? "",
+            columns: []
+        });
+    }
+    for (const row of rows.rows) {
+        if (systemColumnNames.has(row.column_name)) {
+            continue;
+        }
+        const table = byTable.get(row.table_name);
+        if (!table) {
+            continue;
+        }
+        table.columns.push({
+            name: row.column_name,
+            type: psqlColumnTypeFromPg(row.data_type),
+            comment: row.column_comment?.trim() ?? "",
+            nullable: row.is_nullable === "YES"
+        });
+    }
+    return {
+        tables: [...byTable.values()].sort((a, b) => a.name.localeCompare(b.name))
+    };
+}
+//# sourceMappingURL=psqlSchemaIntrospect.js.map

package/dist/services/psql/psqlSchemaIntrospect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"psqlSchemaIntrospect.js","sourceRoot":"","sources":["../../../sources/services/psql/psqlSchemaIntrospect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAA+C,MAAM,gBAAgB,CAAC;AAgBlG;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,EAAc;IACrD,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,KAAK,CACzB;;;;;;;;;SASC,CACJ,CAAC;IACF,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,KAAK,CACvB;;;;;;;;;;;;;;;;;;SAkBC,CACJ,CAAC;IAEF,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IACpF,MAAM,OAAO,GAAG,IAAI,GAAG,EAAmD,CAAC;IAC3E,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE;YAC1B,IAAI,EAAE,KAAK,CAAC,UAAU;YACtB,OAAO,EAAE,KAAK,CAAC,aAAa,EAAE,IAAI,EAAE,IAAI,EAAE;YAC1C,OAAO,EAAE,EAAE;SACd,CAAC,CAAC;IACP,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QAC1B,IAAI,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YACzC,SAAS;QACb,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC1C,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,SAAS;QACb,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;YACf,IAAI,EAAE,GAAG,CAAC,WAAW;YACrB,IAAI,EAAE,oBAAoB,CAAC,GAAG,CAAC,SAAS,CAAC;YACzC,OAAO,EAAE,GAAG,CAAC,cAAc,EAAE,IAAI,EAAE,IAAI,EAAE;YACzC,QAAQ,EAAE,GAAG,CAAC,WAAW,KAAK,KAAK;SACtC,CAAC,CAAC;IACP,CAAC;IAED,OAAO;QACH,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;KAC7E,CAAC;AACN,CAAC"}

package/dist/services/psql/psqlSchemaIntrospect.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=psqlSchemaIntrospect.spec.d.ts.map

package/dist/services/psql/psqlSchemaIntrospect.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"psqlSchemaIntrospect.spec.d.ts","sourceRoot":"","sources":["../../../sources/services/psql/psqlSchemaIntrospect.spec.ts"],"names":[],"mappings":""}

package/dist/services/psql/psqlSchemaIntrospect.spec.js

@@ -0,0 +1,43 @@
+import { PGlite } from "@electric-sql/pglite";
+import { afterEach, describe, expect, it } from "vitest";
+import { psqlSchemaIntrospect } from "./psqlSchemaIntrospect.js";
+describe("psqlSchemaIntrospect", () => {
+    const databases = [];
+    afterEach(async () => {
+        await Promise.all(databases.map(async (db) => db.close()));
+        databases.length = 0;
+    });
+    it("returns declaration format and excludes system columns", async () => {
+        const db = new PGlite();
+        databases.push(db);
+        await db.exec(`
+            CREATE TABLE contacts (
+                id text NOT NULL,
+                version integer NOT NULL,
+                valid_from bigint NOT NULL,
+                valid_to bigint,
+                created_at bigint NOT NULL,
+                updated_at bigint NOT NULL,
+                first_name text NOT NULL,
+                age integer
+            )
+        `);
+        await db.exec("COMMENT ON TABLE contacts IS 'Contact records'");
+        await db.exec("COMMENT ON COLUMN contacts.first_name IS 'Given name'");
+        await db.exec("COMMENT ON COLUMN contacts.age IS 'Age in years'");
+        const schema = await psqlSchemaIntrospect(db);
+        expect(schema).toEqual({
+            tables: [
+                {
+                    name: "contacts",
+                    comment: "Contact records",
+                    columns: [
+                        { name: "first_name", type: "text", comment: "Given name", nullable: false },
+                        { name: "age", type: "integer", comment: "Age in years", nullable: true }
+                    ]
+                }
+            ]
+        });
+    });
+});
+//# sourceMappingURL=psqlSchemaIntrospect.spec.js.map

package/dist/services/psql/psqlSchemaIntrospect.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"psqlSchemaIntrospect.spec.js","sourceRoot":"","sources":["../../../sources/services/psql/psqlSchemaIntrospect.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IAClC,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,SAAS,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC3D,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,EAAE,GAAG,IAAI,MAAM,EAAE,CAAC;QACxB,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEnB,MAAM,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;SAWb,CAAC,CAAC;QACH,MAAM,EAAE,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;QAChE,MAAM,EAAE,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;QACvE,MAAM,EAAE,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;QAElE,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,EAAE,CAAC,CAAC;QAE9C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACnB,MAAM,EAAE;gBACJ;oBACI,IAAI,EAAE,UAAU;oBAChB,OAAO,EAAE,iBAAiB;oBAC1B,OAAO,EAAE;wBACL,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE;wBAC5E,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,EAAE;qBAC5E;iBACJ;aACJ;SACJ,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/services/psql/psqlTableDescribe.d.ts

@@ -0,0 +1,17 @@
+import type { PsqlClient, PsqlColumnType } from "./psqlTypes.js";
+export type PsqlTableBusinessColumn = {
+    name: string;
+    type: PsqlColumnType;
+    nullable: boolean;
+};
+export type PsqlTableDescription = {
+    table: string;
+    businessColumns: PsqlTableBusinessColumn[];
+    businessByName: Map<string, PsqlTableBusinessColumn>;
+};
+/**
+ * Loads runtime table shape from information_schema and separates business columns from system columns.
+ * Expects: table exists in public schema.
+ */
+export declare function psqlTableDescribe(db: PsqlClient, table: string): Promise<PsqlTableDescription>;
+//# sourceMappingURL=psqlTableDescribe.d.ts.map

package/dist/services/psql/psqlTableDescribe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"psqlTableDescribe.d.ts","sourceRoot":"","sources":["../../../sources/services/psql/psqlTableDescribe.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AASjE,MAAM,MAAM,uBAAuB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,cAAc,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,uBAAuB,EAAE,CAAC;IAC3C,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;CACxD,CAAC;AAEF;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA4BpG"}