callman-core 1.29.0 → 1.30.0

package/dist/host/db/introspection/oracle.d.ts

@@ -0,0 +1,12 @@
+import type { DbConnection } from "../types.js";
+import { type ResolvedIntrospectOptions } from "./shared.js";
+import type { DbSchema } from "./types.js";
+export declare const formatOracleType: (row: {
+    DATA_TYPE?: unknown;
+    DATA_LENGTH?: unknown;
+    CHAR_LENGTH?: unknown;
+    DATA_PRECISION?: unknown;
+    DATA_SCALE?: unknown;
+}) => string;
+export declare const introspectOracle: (connection: DbConnection, options: ResolvedIntrospectOptions) => Promise<DbSchema>;
+//# sourceMappingURL=oracle.d.ts.map

package/dist/host/db/introspection/oracle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oracle.d.ts","sourceRoot":"","sources":["../../../../src/host/db/introspection/oracle.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAA0F,KAAK,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACrJ,OAAO,KAAK,EAAE,QAAQ,EAAiB,MAAM,YAAY,CAAC;AA0D1D,eAAO,MAAM,gBAAgB,GAAI,KAAK;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,KAAG,MAc7J,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,YAAY,YAAY,EAAE,SAAS,yBAAyB,KAAG,OAAO,CAAC,QAAQ,CAmJ5G,CAAC"}

package/dist/host/db/introspection/oracle.js

@@ -0,0 +1,225 @@
+// Oracle schema introspection over the ALL_* data dictionary views (one
+// connection, a handful of queries per schema/owner). The current schema is
+// read unless owners are named; Oracle-maintained accounts are never listed.
+import { withOracleConnection } from "../oracleAdapter.js";
+import { asNumber, asString, emptyTable, finishTable, referentialAction, selectTables, tableKey } from "./shared.js";
+const CURRENT_SCHEMA_SQL = "SELECT SYS_CONTEXT('USERENV', 'CURRENT_SCHEMA') AS SCH FROM DUAL";
+const DB_NAME_SQL = "SELECT SYS_CONTEXT('USERENV', 'DB_NAME') AS DB FROM DUAL";
+const SCHEMAS_SQL = "SELECT USERNAME AS SCH FROM ALL_USERS WHERE ORACLE_MAINTAINED = 'N' ORDER BY 1";
+const SCHEMAS_FALLBACK_SQL = `
+SELECT USERNAME AS SCH FROM ALL_USERS
+WHERE USERNAME NOT IN ('SYS', 'SYSTEM', 'OUTLN', 'XDB', 'CTXSYS', 'MDSYS', 'ORDSYS', 'ORDDATA', 'WMSYS', 'DBSNMP', 'APPQOSSYS', 'AUDSYS',
+  'GSMADMIN_INTERNAL', 'DVSYS', 'LBACSYS', 'OJVMSYS', 'OLAPSYS', 'ORACLE_OCM', 'REMOTE_SCHEDULER_AGENT', 'SYSBACKUP', 'SYSDG', 'SYSKM', 'SYSRAC',
+  'SYS$UMF', 'DBSFWUSER', 'GGSYS', 'ANONYMOUS', 'XS$NULL', 'DIP', 'APEX_PUBLIC_USER', 'FLOWS_FILES', 'MDDATA', 'SI_INFORMTN_SCHEMA', 'ORDPLUGINS',
+  'SPATIAL_CSW_ADMIN_USR', 'WKSYS', 'WKPROXY', 'WK_TEST', 'EXFSYS', 'DMSYS', 'TSMSYS', 'OWBSYS', 'OWBSYS_AUDIT', 'SCOTT', 'HR', 'OE', 'PM', 'IX', 'SH', 'BI')
+ORDER BY 1`;
+const TABLES_SQL = `
+SELECT t.OWNER AS SCH, t.TABLE_NAME AS TBL, 'table' AS KIND, c.COMMENTS AS TABLE_COMMENT, t.NUM_ROWS AS ESTIMATE
+FROM ALL_TABLES t
+LEFT JOIN ALL_TAB_COMMENTS c ON c.OWNER = t.OWNER AND c.TABLE_NAME = t.TABLE_NAME
+WHERE t.OWNER = :owner AND t.TABLE_NAME NOT LIKE 'BIN$%'
+UNION ALL
+SELECT v.OWNER, v.VIEW_NAME, 'view', c.COMMENTS, NULL
+FROM ALL_VIEWS v
+LEFT JOIN ALL_TAB_COMMENTS c ON c.OWNER = v.OWNER AND c.TABLE_NAME = v.VIEW_NAME
+WHERE v.OWNER = :owner
+ORDER BY 1, 2`;
+const COLUMNS_SQL = `
+SELECT c.TABLE_NAME AS TBL, c.COLUMN_NAME AS COL, c.COLUMN_ID AS ORDINAL, c.DATA_TYPE, c.DATA_LENGTH, c.CHAR_LENGTH,
+       c.DATA_PRECISION, c.DATA_SCALE, c.NULLABLE, c.DATA_DEFAULT, cc.COMMENTS AS COL_COMMENT
+FROM ALL_TAB_COLUMNS c
+LEFT JOIN ALL_COL_COMMENTS cc ON cc.OWNER = c.OWNER AND cc.TABLE_NAME = c.TABLE_NAME AND cc.COLUMN_NAME = c.COLUMN_NAME
+WHERE c.OWNER = :owner
+ORDER BY 1, 3`;
+const CONSTRAINTS_SQL = `
+SELECT c.TABLE_NAME AS TBL, c.CONSTRAINT_NAME AS CNAME, c.CONSTRAINT_TYPE AS CTYPE, cc.COLUMN_NAME AS COL, cc.POSITION AS POS,
+       c.R_OWNER AS REF_OWNER, c.R_CONSTRAINT_NAME AS REF_CNAME, c.DELETE_RULE AS ON_DELETE
+FROM ALL_CONSTRAINTS c
+JOIN ALL_CONS_COLUMNS cc ON cc.OWNER = c.OWNER AND cc.CONSTRAINT_NAME = c.CONSTRAINT_NAME AND cc.TABLE_NAME = c.TABLE_NAME
+WHERE c.OWNER = :owner AND c.CONSTRAINT_TYPE IN ('P', 'U', 'R')
+ORDER BY 1, 2, 5`;
+const KEY_COLUMNS_SQL = `
+SELECT cc.CONSTRAINT_NAME AS CNAME, cc.TABLE_NAME AS TBL, cc.COLUMN_NAME AS COL, cc.POSITION AS POS
+FROM ALL_CONS_COLUMNS cc
+JOIN ALL_CONSTRAINTS c ON c.OWNER = cc.OWNER AND c.CONSTRAINT_NAME = cc.CONSTRAINT_NAME
+WHERE cc.OWNER = :owner AND c.CONSTRAINT_TYPE IN ('P', 'U')
+ORDER BY 1, 4`;
+const INDEXES_SQL = `
+SELECT i.TABLE_NAME AS TBL, i.INDEX_NAME AS NAME, i.UNIQUENESS AS UNIQ, ic.COLUMN_NAME AS COL, ic.COLUMN_POSITION AS POS
+FROM ALL_INDEXES i
+JOIN ALL_IND_COLUMNS ic ON ic.INDEX_OWNER = i.OWNER AND ic.INDEX_NAME = i.INDEX_NAME
+WHERE i.TABLE_OWNER = :owner
+ORDER BY 1, 2, 5`;
+// The type the way SQL Developer prints it: VARCHAR2(120), NUMBER(10,2), DATE.
+export const formatOracleType = (row) => {
+    const type = String(row.DATA_TYPE ?? "").toUpperCase();
+    const charLength = asNumber(row.CHAR_LENGTH);
+    const dataLength = asNumber(row.DATA_LENGTH);
+    const precision = asNumber(row.DATA_PRECISION);
+    const scale = asNumber(row.DATA_SCALE);
+    if (["VARCHAR2", "NVARCHAR2", "CHAR", "NCHAR"].includes(type))
+        return `${type}(${charLength && charLength > 0 ? charLength : dataLength ?? ""})`.replace("()", "");
+    if (type === "RAW")
+        return dataLength !== undefined ? `RAW(${dataLength})` : type;
+    if (type === "NUMBER") {
+        if (precision !== undefined)
+            return scale ? `NUMBER(${precision},${scale})` : `NUMBER(${precision})`;
+        return "NUMBER";
+    }
+    if (type === "FLOAT")
+        return precision !== undefined ? `FLOAT(${precision})` : type;
+    return type;
+};
+export const introspectOracle = (connection, options) => withOracleConnection(connection, async (client, oracledb) => {
+    const query = async (sql, binds = {}) => {
+        const result = await client.execute(sql, binds, { outFormat: oracledb.OUT_FORMAT_OBJECT });
+        return Array.isArray(result?.rows) ? result.rows : [];
+    };
+    const warnings = [];
+    const current = String((await query(CURRENT_SCHEMA_SQL))[0]?.SCH ?? connection.username).toUpperCase();
+    let database;
+    try {
+        database = asString((await query(DB_NAME_SQL))[0]?.DB);
+    }
+    catch {
+        database = connection.serviceName?.trim() || connection.database?.trim() || undefined;
+    }
+    let schemas;
+    try {
+        schemas = (await query(SCHEMAS_SQL)).map((row) => String(row.SCH));
+    }
+    catch {
+        // ORACLE_MAINTAINED arrived in 12c; older servers get the static list.
+        schemas = (await query(SCHEMAS_FALLBACK_SQL)).map((row) => String(row.SCH));
+    }
+    if (!schemas.includes(current))
+        schemas.unshift(current);
+    const wanted = options.schemas ? options.schemas.map((name) => name.toUpperCase()) : [current];
+    const candidates = [];
+    for (const owner of wanted) {
+        for (const row of await query(TABLES_SQL, { owner })) {
+            candidates.push({
+                schema: String(row.SCH),
+                name: String(row.TBL),
+                kind: String(row.KIND) === "view" ? "view" : "table",
+                ...(asString(row.TABLE_COMMENT) ? { comment: String(row.TABLE_COMMENT) } : {}),
+                ...(asNumber(row.ESTIMATE) !== undefined ? { estimate: asNumber(row.ESTIMATE) } : {}),
+            });
+        }
+    }
+    const { selected, truncated } = selectTables(candidates, options);
+    const tables = new Map();
+    for (const candidate of selected) {
+        tables.set(tableKey(candidate.schema, candidate.name), emptyTable(candidate, {
+            ...(candidate.comment ? { comment: candidate.comment } : {}),
+            ...(candidate.estimate !== undefined ? { rowCountEstimate: candidate.estimate } : {}),
+        }));
+    }
+    if (!options.objectsOnly && tables.size > 0) {
+        const detailOwners = [...new Set(selected.map((candidate) => candidate.schema))];
+        // Referenced key constraints, by owner + constraint name, for the FK ends.
+        const keyColumns = new Map();
+        const loadKeyColumns = async (owner) => {
+            for (const row of await query(KEY_COLUMNS_SQL, { owner })) {
+                const key = `${owner}.${row.CNAME}`;
+                const entry = keyColumns.get(key) ?? { table: String(row.TBL), columns: [] };
+                entry.columns.push(String(row.COL));
+                keyColumns.set(key, entry);
+            }
+        };
+        for (const owner of detailOwners) {
+            for (const row of await query(COLUMNS_SQL, { owner })) {
+                const table = tables.get(tableKey(owner, String(row.TBL)));
+                if (!table)
+                    continue;
+                const defaultValue = asString(row.DATA_DEFAULT)?.trim();
+                table.columns.push({
+                    name: String(row.COL),
+                    dataType: formatOracleType(row),
+                    ordinal: asNumber(row.ORDINAL) ?? table.columns.length + 1,
+                    nullable: String(row.NULLABLE ?? "Y").toUpperCase() === "Y",
+                    primaryKey: false,
+                    ...(defaultValue ? { defaultValue } : {}),
+                    ...(defaultValue && /\.NEXTVAL$/i.test(defaultValue) ? { autoIncrement: true } : {}),
+                    ...(asString(row.COL_COMMENT) ? { comment: String(row.COL_COMMENT) } : {}),
+                });
+            }
+            await loadKeyColumns(owner);
+            const groups = new Map();
+            for (const row of await query(CONSTRAINTS_SQL, { owner })) {
+                const table = tables.get(tableKey(owner, String(row.TBL)));
+                if (!table)
+                    continue;
+                const key = `${row.TBL}.${row.CNAME}`;
+                let group = groups.get(key);
+                if (!group) {
+                    group = {
+                        table,
+                        name: String(row.CNAME),
+                        type: String(row.CTYPE),
+                        columns: [],
+                        ...(asString(row.REF_OWNER) ? { refOwner: String(row.REF_OWNER) } : {}),
+                        ...(asString(row.REF_CNAME) ? { refName: String(row.REF_CNAME) } : {}),
+                        ...(referentialAction(row.ON_DELETE) ? { onDelete: referentialAction(row.ON_DELETE) } : {}),
+                    };
+                    groups.set(key, group);
+                }
+                group.columns.push(String(row.COL));
+            }
+            for (const group of groups.values()) {
+                if (group.type === "P")
+                    group.table.primaryKey = group.columns;
+                else if (group.type === "U")
+                    group.table.indexes.push({ name: group.name, columns: group.columns, unique: true });
+                else if (group.type === "R" && group.refOwner && group.refName) {
+                    if (!detailOwners.includes(group.refOwner) && ![...keyColumns.keys()].some((key) => key.startsWith(`${group.refOwner}.`)))
+                        await loadKeyColumns(group.refOwner);
+                    const referenced = keyColumns.get(`${group.refOwner}.${group.refName}`);
+                    if (!referenced) {
+                        warnings.push(`Foreign key ${group.name} on ${owner}.${group.table.name} references a key this connection cannot read.`);
+                        continue;
+                    }
+                    group.table.foreignKeys.push({
+                        name: group.name,
+                        columns: group.columns,
+                        refSchema: group.refOwner,
+                        refTable: referenced.table,
+                        refColumns: referenced.columns,
+                        ...(group.onDelete ? { onDelete: group.onDelete } : {}),
+                    });
+                }
+            }
+            const indexGroups = new Map();
+            for (const row of await query(INDEXES_SQL, { owner })) {
+                const table = tables.get(tableKey(owner, String(row.TBL)));
+                if (!table)
+                    continue;
+                const key = `${row.TBL}.${row.NAME}`;
+                let group = indexGroups.get(key);
+                if (!group) {
+                    group = { table, name: String(row.NAME), unique: String(row.UNIQ ?? "").toUpperCase() === "UNIQUE", columns: [] };
+                    indexGroups.set(key, group);
+                }
+                group.columns.push(String(row.COL));
+            }
+            for (const group of indexGroups.values()) {
+                if (group.table.indexes.some((index) => index.name === group.name))
+                    continue;
+                const primary = group.unique && group.table.primaryKey.length > 0 && group.columns.join(",") === group.table.primaryKey.join(",");
+                group.table.indexes.push({ name: group.name, columns: group.columns, unique: group.unique, ...(primary ? { primary: true } : {}) });
+            }
+        }
+        for (const table of tables.values())
+            finishTable(table);
+    }
+    return {
+        dialect: "oracle",
+        ...(database ? { database } : {}),
+        schemas,
+        tables: [...tables.values()],
+        capturedAt: new Date().toISOString(),
+        warnings,
+        ...(truncated ? { truncated: true } : {}),
+    };
+});
+//# sourceMappingURL=oracle.js.map

package/dist/host/db/introspection/oracle.js.map

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

package/dist/host/db/introspection/postgres.d.ts

@@ -0,0 +1,5 @@
+import type { DbConnection } from "../types.js";
+import { type ResolvedIntrospectOptions } from "./shared.js";
+import type { DbSchema } from "./types.js";
+export declare const introspectPostgres: (connection: DbConnection, options: ResolvedIntrospectOptions) => Promise<DbSchema>;
+//# sourceMappingURL=postgres.d.ts.map

package/dist/host/db/introspection/postgres.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.d.ts","sourceRoot":"","sources":["../../../../src/host/db/introspection/postgres.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EASL,KAAK,yBAAyB,EAC/B,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,QAAQ,EAAiB,MAAM,YAAY,CAAC;AAiF1D,eAAO,MAAM,kBAAkB,GAAI,YAAY,YAAY,EAAE,SAAS,yBAAyB,KAAG,OAAO,CAAC,QAAQ,CA2F9G,CAAC"}

package/dist/host/db/introspection/postgres.js

@@ -0,0 +1,172 @@
+// PostgreSQL schema introspection over pg_catalog (one client, five catalog
+// queries). information_schema is avoided on purpose: it hides objects the
+// role does not own and formats types less faithfully than format_type().
+import { withPostgresClient } from "../postgresAdapter.js";
+import { asBoolean, asNumber, asString, emptyTable, finishTable, referentialAction, selectTables, tableKey, } from "./shared.js";
+const SCHEMAS_SQL = `
+SELECT n.nspname AS sch
+FROM pg_namespace n
+WHERE n.nspname NOT IN ('pg_catalog', 'information_schema', 'pg_toast')
+  AND n.nspname NOT LIKE 'pg\\_temp\\_%'
+  AND n.nspname NOT LIKE 'pg\\_toast\\_temp\\_%'
+ORDER BY 1`;
+const TABLES_SQL = `
+SELECT n.nspname AS sch, c.relname AS tbl, c.relkind::text AS kind,
+       obj_description(c.oid, 'pg_class') AS comment,
+       GREATEST(c.reltuples, 0)::bigint AS estimate
+FROM pg_class c
+JOIN pg_namespace n ON n.oid = c.relnamespace
+WHERE n.nspname = ANY($1::text[]) AND c.relkind::text = ANY($2::text[])
+ORDER BY 1, 2`;
+const COLUMNS_SQL = `
+SELECT n.nspname AS sch, c.relname AS tbl, a.attname AS col, a.attnum AS ordinal,
+       format_type(a.atttypid, a.atttypmod) AS data_type,
+       NOT a.attnotnull AS nullable,
+       pg_get_expr(d.adbin, d.adrelid) AS default_value,
+       col_description(c.oid, a.attnum) AS comment,
+       (a.attidentity <> '') AS identity
+FROM pg_attribute a
+JOIN pg_class c ON c.oid = a.attrelid
+JOIN pg_namespace n ON n.oid = c.relnamespace
+LEFT JOIN pg_attrdef d ON d.adrelid = a.attrelid AND d.adnum = a.attnum
+WHERE a.attnum > 0 AND NOT a.attisdropped
+  AND n.nspname = ANY($1::text[]) AND c.relkind::text = ANY($2::text[])
+ORDER BY 1, 2, 4`;
+const CONSTRAINTS_SQL = `
+SELECT con.conname AS cname, con.contype::text AS ctype, n.nspname AS sch, c.relname AS tbl,
+       (SELECT array_agg(a.attname ORDER BY k.ord)
+          FROM unnest(con.conkey) WITH ORDINALITY AS k(attnum, ord)
+          JOIN pg_attribute a ON a.attrelid = con.conrelid AND a.attnum = k.attnum) AS cols,
+       fn.nspname AS ref_sch, fc.relname AS ref_tbl,
+       (SELECT array_agg(a.attname ORDER BY k.ord)
+          FROM unnest(con.confkey) WITH ORDINALITY AS k(attnum, ord)
+          JOIN pg_attribute a ON a.attrelid = con.confrelid AND a.attnum = k.attnum) AS ref_cols,
+       con.confdeltype::text AS on_delete, con.confupdtype::text AS on_update
+FROM pg_constraint con
+JOIN pg_class c ON c.oid = con.conrelid
+JOIN pg_namespace n ON n.oid = c.relnamespace
+LEFT JOIN pg_class fc ON fc.oid = con.confrelid
+LEFT JOIN pg_namespace fn ON fn.oid = fc.relnamespace
+WHERE con.contype IN ('p', 'u', 'f') AND n.nspname = ANY($1::text[])
+ORDER BY 3, 4, 1`;
+const INDEXES_SQL = `
+SELECT n.nspname AS sch, t.relname AS tbl, i.relname AS name,
+       ix.indisunique AS is_unique, ix.indisprimary AS is_primary,
+       (SELECT array_agg(a.attname ORDER BY k.ord)
+          FROM unnest(ix.indkey::int2[]) WITH ORDINALITY AS k(attnum, ord)
+          JOIN pg_attribute a ON a.attrelid = ix.indrelid AND a.attnum = k.attnum
+         WHERE k.attnum > 0) AS cols
+FROM pg_index ix
+JOIN pg_class t ON t.oid = ix.indrelid
+JOIN pg_class i ON i.oid = ix.indexrelid
+JOIN pg_namespace n ON n.oid = t.relnamespace
+WHERE n.nspname = ANY($1::text[])
+ORDER BY 1, 2, 3`;
+const asList = (value) => {
+    if (Array.isArray(value))
+        return value.map(String);
+    if (typeof value === "string") {
+        // pg returns text[] as arrays, but a driver without type parsing may hand
+        // back the "{a,b}" literal.
+        const inner = value.replace(/^\{|\}$/g, "");
+        return inner ? inner.split(",").map((item) => item.replace(/^"|"$/g, "")) : [];
+    }
+    return [];
+};
+const kindOf = (relkind) => (relkind === "v" || relkind === "m" ? "view" : "table");
+export const introspectPostgres = (connection, options) => withPostgresClient(connection, async (client) => {
+    const query = async (sql, params = []) => {
+        const result = await client.query(sql, params);
+        return Array.isArray(result?.rows) ? result.rows : [];
+    };
+    const warnings = [];
+    const databaseRow = (await query("SELECT current_database() AS db"))[0];
+    const schemas = (await query(SCHEMAS_SQL)).map((row) => String(row.sch));
+    const wanted = options.schemas ? options.schemas.filter((name) => schemas.includes(name)) : schemas;
+    for (const name of options.schemas ?? [])
+        if (!schemas.includes(name))
+            warnings.push(`Schema "${name}" is not visible to this connection.`);
+    const kinds = options.includeViews ? ["r", "p", "f", "v", "m"] : ["r", "p", "f"];
+    const tableRows = wanted.length > 0 ? await query(TABLES_SQL, [wanted, kinds]) : [];
+    const candidates = tableRows.map((row) => ({
+        schema: String(row.sch),
+        name: String(row.tbl),
+        kind: kindOf(String(row.kind)),
+        comment: asString(row.comment),
+        estimate: asNumber(row.estimate),
+    }));
+    const { selected, truncated } = selectTables(candidates, options);
+    const tables = new Map();
+    for (const candidate of selected) {
+        tables.set(tableKey(candidate.schema, candidate.name), emptyTable(candidate, {
+            ...(candidate.comment ? { comment: candidate.comment } : {}),
+            ...(candidate.estimate !== undefined ? { rowCountEstimate: candidate.estimate } : {}),
+        }));
+    }
+    if (!options.objectsOnly && tables.size > 0) {
+        const detailSchemas = [...new Set(selected.map((candidate) => candidate.schema))];
+        for (const row of await query(COLUMNS_SQL, [detailSchemas, kinds])) {
+            const table = tables.get(tableKey(String(row.sch), String(row.tbl)));
+            if (!table)
+                continue;
+            const defaultValue = asString(row.default_value);
+            table.columns.push({
+                name: String(row.col),
+                dataType: String(row.data_type),
+                ordinal: asNumber(row.ordinal) ?? table.columns.length + 1,
+                nullable: asBoolean(row.nullable),
+                primaryKey: false,
+                ...(defaultValue !== undefined ? { defaultValue } : {}),
+                ...(asBoolean(row.identity) || /^nextval\(/i.test(defaultValue ?? "") ? { autoIncrement: true } : {}),
+                ...(asString(row.comment) ? { comment: asString(row.comment) } : {}),
+            });
+        }
+        for (const row of await query(CONSTRAINTS_SQL, [detailSchemas])) {
+            const table = tables.get(tableKey(String(row.sch), String(row.tbl)));
+            if (!table)
+                continue;
+            const columns = asList(row.cols);
+            const type = String(row.ctype);
+            if (type === "p")
+                table.primaryKey = columns;
+            else if (type === "u") {
+                table.indexes.push({ name: String(row.cname), columns, unique: true });
+            }
+            else if (type === "f") {
+                table.foreignKeys.push({
+                    name: String(row.cname),
+                    columns,
+                    ...(asString(row.ref_sch) ? { refSchema: String(row.ref_sch) } : {}),
+                    refTable: String(row.ref_tbl ?? ""),
+                    refColumns: asList(row.ref_cols),
+                    ...(referentialAction(row.on_delete) ? { onDelete: referentialAction(row.on_delete) } : {}),
+                    ...(referentialAction(row.on_update) ? { onUpdate: referentialAction(row.on_update) } : {}),
+                });
+            }
+        }
+        for (const row of await query(INDEXES_SQL, [detailSchemas])) {
+            const table = tables.get(tableKey(String(row.sch), String(row.tbl)));
+            if (!table)
+                continue;
+            const name = String(row.name);
+            if (table.indexes.some((index) => index.name === name))
+                continue; // the unique constraint already listed it
+            const columns = asList(row.cols);
+            if (columns.length === 0)
+                continue; // expression index
+            table.indexes.push({ name, columns, unique: asBoolean(row.is_unique), ...(asBoolean(row.is_primary) ? { primary: true } : {}) });
+        }
+        for (const table of tables.values())
+            finishTable(table);
+    }
+    return {
+        dialect: "postgres",
+        ...(asString(databaseRow?.db) ? { database: String(databaseRow.db) } : {}),
+        schemas,
+        tables: [...tables.values()],
+        capturedAt: new Date().toISOString(),
+        warnings,
+        ...(truncated ? { truncated: true } : {}),
+    };
+});
+//# sourceMappingURL=postgres.js.map

package/dist/host/db/introspection/postgres.js.map

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

package/dist/host/db/introspection/shared.d.ts

@@ -0,0 +1,29 @@
+import type { DbIntrospectOptions, DbSchemaObjectKind, DbSchemaTable } from "./types.js";
+export interface ResolvedIntrospectOptions {
+    schemas?: string[];
+    tables?: string[];
+    includeViews: boolean;
+    objectsOnly: boolean;
+    sampleSize: number;
+    maxTables: number;
+}
+export declare const resolveIntrospectOptions: (options?: DbIntrospectOptions) => ResolvedIntrospectOptions;
+export declare const tableKey: (schema: string | undefined, name: string) => string;
+export declare const tableMatchesFilter: (schema: string | undefined, name: string, filters: string[] | undefined) => boolean;
+export interface TableCandidate {
+    schema?: string;
+    name: string;
+    kind: DbSchemaObjectKind;
+}
+export declare const selectTables: <T extends TableCandidate>(candidates: T[], options: ResolvedIntrospectOptions) => {
+    selected: T[];
+    truncated: boolean;
+};
+export declare const emptyTable: (candidate: TableCandidate, extra?: Partial<DbSchemaTable>) => DbSchemaTable;
+export declare const asString: (value: unknown) => string | undefined;
+export declare const asNumber: (value: unknown) => number | undefined;
+export declare const asBoolean: (value: unknown) => boolean;
+export declare const referentialAction: (value: unknown) => string | undefined;
+export declare const markUniqueColumns: (table: DbSchemaTable) => void;
+export declare const finishTable: (table: DbSchemaTable) => DbSchemaTable;
+//# sourceMappingURL=shared.d.ts.map

package/dist/host/db/introspection/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../src/host/db/introspection/shared.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEzF,MAAM,WAAW,yBAAyB;IACxC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,eAAO,MAAM,wBAAwB,GAAI,UAAS,mBAAwB,KAAG,yBAW5E,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,QAAQ,MAAM,GAAG,SAAS,EAAE,MAAM,MAAM,KAAG,MAA+C,CAAC;AAKpH,eAAO,MAAM,kBAAkB,GAAI,QAAQ,MAAM,GAAG,SAAS,EAAE,MAAM,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,KAAG,OAQ5G,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,kBAAkB,CAAC;CAC1B;AAKD,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,cAAc,EACnD,YAAY,CAAC,EAAE,EACf,SAAS,yBAAyB,KACjC;IAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAMrC,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,WAAW,cAAc,EAAE,QAAO,OAAO,CAAC,aAAa,CAAM,KAAG,aASzF,CAAC;AAEH,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,MAAM,GAAG,SAIlD,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,MAAM,GAAG,SAIlD,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,OAK1C,CAAC;AAGF,eAAO,MAAM,iBAAiB,GAAI,OAAO,OAAO,KAAG,MAAM,GAAG,SAuB3D,CAAC;AAGF,eAAO,MAAM,iBAAiB,GAAI,OAAO,aAAa,KAAG,IAUxD,CAAC;AAGF,eAAO,MAAM,WAAW,GAAI,OAAO,aAAa,KAAG,aAMlD,CAAC"}

package/dist/host/db/introspection/shared.js

@@ -0,0 +1,119 @@
+// Helpers every dialect's introspection shares: the resolved options, the
+// table filter, the size cap and small normalisers.
+const clamp = (value, min, max) => Math.min(max, Math.max(min, value));
+export const resolveIntrospectOptions = (options = {}) => {
+    const schemas = options.schemas?.map((name) => name.trim()).filter(Boolean);
+    const tables = options.tables?.map((name) => name.trim()).filter(Boolean);
+    return {
+        ...(schemas && schemas.length > 0 ? { schemas } : {}),
+        ...(tables && tables.length > 0 ? { tables } : {}),
+        includeViews: options.includeViews !== false,
+        objectsOnly: Boolean(options.objectsOnly),
+        sampleSize: clamp(Math.round(Number(options.sampleSize) || 100), 1, 1000),
+        maxTables: clamp(Math.round(Number(options.maxTables) || 2000), 1, 20000),
+    };
+};
+export const tableKey = (schema, name) => (schema ? `${schema}.${name}` : name);
+// "schema.table" matches the qualified name, a bare name matches the table
+// name in any schema; both case-insensitive (Oracle upper-cases, Postgres
+// lower-cases, SQL Server does not care).
+export const tableMatchesFilter = (schema, name, filters) => {
+    if (!filters || filters.length === 0)
+        return true;
+    const qualified = tableKey(schema, name).toLowerCase();
+    const bare = name.toLowerCase();
+    return filters.some((filter) => {
+        const wanted = filter.toLowerCase();
+        return wanted.includes(".") ? wanted === qualified : wanted === bare;
+    });
+};
+// Views, the explicit table filter and the cap, applied in the order the
+// database listed the objects. Returns the kept candidates and whether the
+// cap cut anything.
+export const selectTables = (candidates, options) => {
+    const filtered = candidates.filter((candidate) => (options.includeViews || candidate.kind !== "view") && tableMatchesFilter(candidate.schema, candidate.name, options.tables));
+    if (filtered.length <= options.maxTables)
+        return { selected: filtered, truncated: false };
+    return { selected: filtered.slice(0, options.maxTables), truncated: true };
+};
+export const emptyTable = (candidate, extra = {}) => ({
+    ...(candidate.schema ? { schema: candidate.schema } : {}),
+    name: candidate.name,
+    kind: candidate.kind,
+    columns: [],
+    primaryKey: [],
+    foreignKeys: [],
+    indexes: [],
+    ...extra,
+});
+export const asString = (value) => {
+    if (value === null || value === undefined)
+        return undefined;
+    const text = String(value);
+    return text.length > 0 ? text : undefined;
+};
+export const asNumber = (value) => {
+    if (value === null || value === undefined || value === "")
+        return undefined;
+    const number = Number(value);
+    return Number.isFinite(number) ? number : undefined;
+};
+export const asBoolean = (value) => {
+    if (typeof value === "boolean")
+        return value;
+    if (typeof value === "number")
+        return value !== 0;
+    if (typeof value === "string")
+        return /^(1|true|yes|y|t)$/i.test(value.trim());
+    return Boolean(value);
+};
+// Referential actions the way SQL spells them, from the dialect's codes.
+export const referentialAction = (value) => {
+    const text = asString(value);
+    if (!text)
+        return undefined;
+    const upper = text.trim().toUpperCase().replace(/_/g, " ");
+    switch (upper) {
+        case "A":
+        case "NO ACTION":
+            return "NO ACTION";
+        case "R":
+        case "RESTRICT":
+            return "RESTRICT";
+        case "C":
+        case "CASCADE":
+            return "CASCADE";
+        case "N":
+        case "SET NULL":
+            return "SET NULL";
+        case "D":
+        case "SET DEFAULT":
+            return "SET DEFAULT";
+        default:
+            return upper;
+    }
+};
+// Mark the columns a single-column unique constraint/index covers.
+export const markUniqueColumns = (table) => {
+    const unique = new Set();
+    const primary = new Set(table.primaryKey);
+    for (const index of table.indexes) {
+        if (!index.unique || index.primary || index.columns.length !== 1 || primary.has(index.columns[0]))
+            continue;
+        unique.add(index.columns[0]);
+    }
+    for (const column of table.columns) {
+        if (unique.has(column.name) && !column.primaryKey)
+            column.unique = true;
+    }
+};
+// Column order and primary-key flags from the table's key list.
+export const finishTable = (table) => {
+    table.columns.sort((a, b) => a.ordinal - b.ordinal);
+    const primary = new Set(table.primaryKey);
+    for (const column of table.columns)
+        column.primaryKey = primary.has(column.name);
+    markUniqueColumns(table);
+    return table;
+};
+//# sourceMappingURL=shared.js.map

package/dist/host/db/introspection/shared.js.map

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