sqlstack 2.0.0 → 3.1.0

package/dist/esm/testing/postgres/allocator.js

@@ -0,0 +1,49 @@
+import { randomBytes } from 'crypto';
+import { connectAdmin, redact, resolveAdminUrl, TestPostgresServerError, withDatabase, } from './server.js';
+const NAME_PREFIX = 'sqlstack_test_';
+let counter = 0;
+/**
+ * Unique, safe, bounded-length database name. Randomness plus a process
+ * counter keeps parallel builds (including across worker processes)
+ * collision-free. Always well under PostgreSQL's 63-byte identifier limit.
+ */
+export function nextDatabaseName() {
+    counter += 1;
+    return `${NAME_PREFIX}${randomBytes(4).toString('hex')}_${counter}`;
+}
+/** Create a fresh uniquely named database on the configured test server. */
+export async function allocateDatabase(options = {}) {
+    const adminUrl = resolveAdminUrl(options);
+    const name = nextDatabaseName();
+    const admin = await connectAdmin(options);
+    try {
+        await admin.query(`CREATE DATABASE "${name}"`);
+    }
+    catch (err) {
+        throw new TestPostgresServerError(`Failed to create test database "${name}" on ${redact(adminUrl)}: ${err.message}\n` +
+            `The admin connection must have CREATE DATABASE privilege ` +
+            `(set SQLSTACK_TEST_PG_URL or options.adminUrl; start the bundled server with npm run db:pg:up).`);
+    }
+    finally {
+        await admin.end().catch(() => undefined);
+    }
+    return { name, url: withDatabase(adminUrl, name), adminUrl };
+}
+/** Drop exactly the named database. Safe to call for an already-dropped db. */
+export async function dropDatabase(name, options = {}) {
+    if (!name.startsWith(NAME_PREFIX)) {
+        throw new TestPostgresServerError(`Refusing to drop database "${name}": not an sqlstack test database (expected prefix ${NAME_PREFIX})`);
+    }
+    const admin = await connectAdmin(options);
+    try {
+        // FORCE (PG 13+) terminates lingering sessions so parallel teardown is robust.
+        await admin.query(`DROP DATABASE IF EXISTS "${name}" WITH (FORCE)`);
+    }
+    catch (err) {
+        throw new TestPostgresServerError(`Failed to drop test database "${name}" on ${redact(resolveAdminUrl(options))}: ${err.message}`);
+    }
+    finally {
+        await admin.end().catch(() => undefined);
+    }
+}
+//# sourceMappingURL=allocator.js.map

package/dist/esm/testing/postgres/allocator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"allocator.js","sourceRoot":"","sources":["../../../../src/testing/postgres/allocator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EACL,YAAY,EACZ,MAAM,EACN,eAAe,EACf,uBAAuB,EAEvB,YAAY,GACb,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,GAAG,gBAAgB,CAAC;AACrC,IAAI,OAAO,GAAG,CAAC,CAAC;AAEhB;;;;GAIG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,IAAI,CAAC,CAAC;IACb,OAAO,GAAG,WAAW,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;AACtE,CAAC;AAQD,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,UAA6B,EAAE;IACpE,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,gBAAgB,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,KAAK,CAAC,oBAAoB,IAAI,GAAG,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,uBAAuB,CAC/B,mCAAmC,IAAI,QAAQ,MAAM,CAAC,QAAQ,CAAC,KAAM,GAAa,CAAC,OAAO,IAAI;YAC5F,2DAA2D;YAC3D,iGAAiG,CACpG,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,MAAM,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC;AAC/D,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,UAA6B,EAAE;IAC9E,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,uBAAuB,CAC/B,8BAA8B,IAAI,qDAAqD,WAAW,GAAG,CACtG,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,CAAC;QACH,+EAA+E;QAC/E,MAAM,KAAK,CAAC,KAAK,CAAC,4BAA4B,IAAI,gBAAgB,CAAC,CAAC;IACtE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,uBAAuB,CAC/B,iCAAiC,IAAI,QAAQ,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,KAAM,GAAa,CAAC,OAAO,EAAE,CAC3G,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,MAAM,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC","sourcesContent":["import { randomBytes } from 'crypto';\nimport {\n  connectAdmin,\n  redact,\n  resolveAdminUrl,\n  TestPostgresServerError,\n  TestServerOptions,\n  withDatabase,\n} from './server';\n\nconst NAME_PREFIX = 'sqlstack_test_';\nlet counter = 0;\n\n/**\n * Unique, safe, bounded-length database name. Randomness plus a process\n * counter keeps parallel builds (including across worker processes)\n * collision-free. Always well under PostgreSQL's 63-byte identifier limit.\n */\nexport function nextDatabaseName(): string {\n  counter += 1;\n  return `${NAME_PREFIX}${randomBytes(4).toString('hex')}_${counter}`;\n}\n\nexport interface AllocatedDatabase {\n  readonly name: string;\n  readonly url: string;\n  readonly adminUrl: string;\n}\n\n/** Create a fresh uniquely named database on the configured test server. */\nexport async function allocateDatabase(options: TestServerOptions = {}): Promise<AllocatedDatabase> {\n  const adminUrl = resolveAdminUrl(options);\n  const name = nextDatabaseName();\n  const admin = await connectAdmin(options);\n  try {\n    await admin.query(`CREATE DATABASE \"${name}\"`);\n  } catch (err) {\n    throw new TestPostgresServerError(\n      `Failed to create test database \"${name}\" on ${redact(adminUrl)}: ${(err as Error).message}\\n` +\n        `The admin connection must have CREATE DATABASE privilege ` +\n        `(set SQLSTACK_TEST_PG_URL or options.adminUrl; start the bundled server with npm run db:pg:up).`\n    );\n  } finally {\n    await admin.end().catch(() => undefined);\n  }\n  return { name, url: withDatabase(adminUrl, name), adminUrl };\n}\n\n/** Drop exactly the named database. Safe to call for an already-dropped db. */\nexport async function dropDatabase(name: string, options: TestServerOptions = {}): Promise<void> {\n  if (!name.startsWith(NAME_PREFIX)) {\n    throw new TestPostgresServerError(\n      `Refusing to drop database \"${name}\": not an sqlstack test database (expected prefix ${NAME_PREFIX})`\n    );\n  }\n  const admin = await connectAdmin(options);\n  try {\n    // FORCE (PG 13+) terminates lingering sessions so parallel teardown is robust.\n    await admin.query(`DROP DATABASE IF EXISTS \"${name}\" WITH (FORCE)`);\n  } catch (err) {\n    throw new TestPostgresServerError(\n      `Failed to drop test database \"${name}\" on ${redact(resolveAdminUrl(options))}: ${(err as Error).message}`\n    );\n  } finally {\n    await admin.end().catch(() => undefined);\n  }\n}\n"]}

package/dist/esm/testing/postgres/database.js

@@ -0,0 +1,36 @@
+import { dropDatabase } from './allocator.js';
+import { loadPg, TestPostgresServerError } from './server.js';
+/**
+ * Connect a helper pool to an allocated database and produce the handle.
+ * The handle owns exactly this database and drops it on dispose.
+ */
+export async function createDatabaseHandle(owned, options = {}) {
+    const pg = await loadPg();
+    const Pool = pg.Pool ?? pg.default?.Pool;
+    const pool = new Pool({ connectionString: owned.url, max: 4 });
+    let disposed = false;
+    return {
+        url: owned.url,
+        _pool: pool,
+        async query(sql, params = []) {
+            if (disposed) {
+                throw new TestPostgresServerError(`Test database "${owned.name}" has been disposed; no further queries are possible.`);
+            }
+            const res = await pool.query(sql, params);
+            return res.rows;
+        },
+        async dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            try {
+                await pool.end();
+            }
+            catch {
+                /* pool may already be closed */
+            }
+            await dropDatabase(owned.name, options);
+        },
+    };
+}
+//# sourceMappingURL=database.js.map

package/dist/esm/testing/postgres/database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../../../../src/testing/postgres/database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,uBAAuB,EAAqB,MAAM,UAAU,CAAC;AAgB9E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAAoB,EACpB,UAA6B,EAAE;IAE/B,MAAM,EAAE,GAAG,MAAM,MAAM,EAAE,CAAC;IAC1B,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC;IACzC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,EAAE,gBAAgB,EAAE,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IAC/D,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,OAAO;QACL,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,KAAK,EAAE,IAAI;QACX,KAAK,CAAC,KAAK,CAAC,GAAW,EAAE,SAA6B,EAAE;YACtD,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,IAAI,uBAAuB,CAC/B,kBAAkB,KAAK,CAAC,IAAI,uDAAuD,CACpF,CAAC;YACJ,CAAC;YACD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,MAAmB,CAAC,CAAC;YACvD,OAAO,GAAG,CAAC,IAAI,CAAC;QAClB,CAAC;QACD,KAAK,CAAC,OAAO;YACX,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC;YACnB,CAAC;YAAC,MAAM,CAAC;gBACP,gCAAgC;YAClC,CAAC;YACD,MAAM,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC1C,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import { dropDatabase } from './allocator';\nimport { loadPg, TestPostgresServerError, TestServerOptions } from './server';\n\n/** The built test database handle. */\nexport interface TestPostgresDatabase {\n  /** Normal PostgreSQL connection string identifying only this database. */\n  readonly url: string;\n  query(sql: string, params?: readonly unknown[]): Promise<unknown>;\n  /** Close helper connections and drop the owned database. Idempotent. */\n  dispose(): Promise<void>;\n}\n\nexport interface OwnedDatabase {\n  readonly name: string;\n  readonly url: string;\n}\n\n/**\n * Connect a helper pool to an allocated database and produce the handle.\n * The handle owns exactly this database and drops it on dispose.\n */\nexport async function createDatabaseHandle(\n  owned: OwnedDatabase,\n  options: TestServerOptions = {}\n): Promise<TestPostgresDatabase & { _pool: any }> {\n  const pg = await loadPg();\n  const Pool = pg.Pool ?? pg.default?.Pool;\n  const pool = new Pool({ connectionString: owned.url, max: 4 });\n  let disposed = false;\n  return {\n    url: owned.url,\n    _pool: pool,\n    async query(sql: string, params: readonly unknown[] = []) {\n      if (disposed) {\n        throw new TestPostgresServerError(\n          `Test database \"${owned.name}\" has been disposed; no further queries are possible.`\n        );\n      }\n      const res = await pool.query(sql, params as unknown[]);\n      return res.rows;\n    },\n    async dispose() {\n      if (disposed) return;\n      disposed = true;\n      try {\n        await pool.end();\n      } catch {\n        /* pool may already be closed */\n      }\n      await dropDatabase(owned.name, options);\n    },\n  };\n}\n"]}

package/dist/esm/testing/postgres/loadData.js

@@ -0,0 +1,176 @@
+import { SqlStackError } from '../../core/errors.js';
+import { quoteIdent } from '../schema/ddl.js';
+export class TestDataError extends SqlStackError {
+    constructor(message) {
+        super(message);
+        this.name = 'TestDataError';
+    }
+}
+/** Validate one `.data()` payload against the structured schema (fail-fast). */
+export function toOperations(schema, data) {
+    const ops = [];
+    const tables = new Map(schema.tables.map((t) => [t.name, t]));
+    for (const [tableName, rows] of Object.entries(data)) {
+        const table = tables.get(tableName);
+        if (!table) {
+            const known = schema.tables.map((t) => t.name).join(', ') || '(none)';
+            throw new TestDataError(`.data(): unknown table "${tableName}". Structured tables declared in ${schema.source}: ${known}. ` +
+                `Tables created only through raw SQL cannot receive .data() rows; insert them via raw SQL instead.`);
+        }
+        if (!Array.isArray(rows)) {
+            throw new TestDataError(`.data(): rows for table "${tableName}" must be an array`);
+        }
+        const columnNames = new Set(table.columns.map((c) => c.name));
+        rows.forEach((row, i) => {
+            if (!row || typeof row !== 'object' || Array.isArray(row)) {
+                throw new TestDataError(`.data(): row #${i} for table "${tableName}" must be an object`);
+            }
+            for (const key of Object.keys(row)) {
+                if (!columnNames.has(key)) {
+                    throw new TestDataError(`.data(): unknown column "${key}" in row #${i} for table "${tableName}" ` +
+                        `(declared columns: ${[...columnNames].join(', ')})`);
+                }
+            }
+            for (const pk of table.primaryKey) {
+                if (row[pk] === undefined) {
+                    throw new TestDataError(`.data(): row #${i} for table "${tableName}" is missing primary-key column "${pk}" ` +
+                        `(primary key: ${table.primaryKey.join(', ')})`);
+                }
+            }
+            ops.push({ table: tableName, row });
+        });
+    }
+    return ops;
+}
+/**
+ * Compose row operations into effective rows per table.
+ * PK tables: identity = ordered PK values; later writes replace, first
+ * occurrence keeps its position. No-PK tables: append in authored order.
+ */
+export function composeRows(schema, ops) {
+    const tables = new Map(schema.tables.map((t) => [t.name, t]));
+    const result = new Map();
+    const identityIndex = new Map();
+    for (const op of ops) {
+        const table = tables.get(op.table);
+        let rows = result.get(op.table);
+        if (!rows) {
+            rows = [];
+            result.set(op.table, rows);
+        }
+        if (table.primaryKey.length === 0) {
+            rows.push(op.row);
+            continue;
+        }
+        const identity = JSON.stringify(table.primaryKey.map((pk) => op.row[pk]));
+        let index = identityIndex.get(op.table);
+        if (!index) {
+            index = new Map();
+            identityIndex.set(op.table, index);
+        }
+        const existing = index.get(identity);
+        if (existing === undefined) {
+            index.set(identity, rows.length);
+            rows.push(op.row);
+        }
+        else {
+            rows[existing] = op.row;
+        }
+    }
+    return result;
+}
+/**
+ * Deterministic insertion order for the tables that actually have rows,
+ * topologically sorted by declared references between those tables.
+ * Cycles fail with actionable guidance.
+ */
+export function planInsertOrder(schema, tablesWithRows) {
+    const inPlan = new Set(tablesWithRows);
+    const tables = schema.tables.filter((t) => inPlan.has(t.name));
+    // deps[t] = set of tables (with rows) that must be inserted before t
+    const deps = new Map();
+    for (const t of tables) {
+        const set = new Set();
+        for (const c of t.columns) {
+            if (c.references && c.references.table !== t.name && inPlan.has(c.references.table)) {
+                set.add(c.references.table);
+            }
+        }
+        deps.set(t.name, set);
+    }
+    const order = [];
+    const done = new Set();
+    let progressed = true;
+    while (progressed && order.length < tables.length) {
+        progressed = false;
+        for (const t of tables) {
+            if (done.has(t.name))
+                continue;
+            const pending = [...deps.get(t.name)].filter((d) => !done.has(d));
+            if (pending.length === 0) {
+                order.push(t.name);
+                done.add(t.name);
+                progressed = true;
+            }
+        }
+    }
+    if (order.length < tables.length) {
+        const cycle = tables.filter((t) => !done.has(t.name)).map((t) => t.name);
+        throw new TestDataError(`Cannot derive an insertion order: declared references between tables [${cycle.join(', ')}] form a cycle. ` +
+            `Insert this data via a raw "sql" entry (e.g. with deferred constraints), or restructure the references.`);
+    }
+    return order;
+}
+/**
+ * Insert effective rows. Parameterized and batched per table by column
+ * signature; missing columns are omitted from the INSERT so PostgreSQL
+ * defaults apply, while explicit null is sent as NULL.
+ */
+export async function insertRows(query, schema, effective) {
+    const order = planInsertOrder(schema, [...effective.keys()]);
+    const declared = new Map(schema.tables.map((t) => [t.name, t.columns.map((c) => c.name)]));
+    for (const tableName of order) {
+        const rows = effective.get(tableName);
+        const columnOrder = declared.get(tableName);
+        // Group consecutive-compatible rows into batches sharing a column signature.
+        const batches = new Map();
+        for (const row of rows) {
+            const columns = columnOrder.filter((c) => row[c] !== undefined);
+            const sig = columns.join(',');
+            let batch = batches.get(sig);
+            if (!batch) {
+                batch = { columns, rows: [] };
+                batches.set(sig, batch);
+            }
+            batch.rows.push(row);
+        }
+        for (const { columns, rows: batchRows } of batches.values()) {
+            if (columns.length === 0) {
+                for (let i = 0; i < batchRows.length; i++) {
+                    await run(query, tableName, `INSERT INTO ${quoteIdent(tableName)} DEFAULT VALUES`, []);
+                }
+                continue;
+            }
+            const params = [];
+            const tuples = batchRows.map((row) => {
+                const placeholders = columns.map((c) => {
+                    params.push(row[c]);
+                    return `$${params.length}`;
+                });
+                return `(${placeholders.join(', ')})`;
+            });
+            const sql = `INSERT INTO ${quoteIdent(tableName)} (${columns.map(quoteIdent).join(', ')}) ` +
+                `VALUES ${tuples.join(', ')}`;
+            await run(query, tableName, sql, params);
+        }
+    }
+}
+async function run(query, tableName, sql, params) {
+    try {
+        await query(sql, params);
+    }
+    catch (err) {
+        throw new TestDataError(`Failed to insert scenario rows into table "${tableName}": ${err.message}`);
+    }
+}
+//# sourceMappingURL=loadData.js.map

package/dist/esm/testing/postgres/loadData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadData.js","sourceRoot":"","sources":["../../../../src/testing/postgres/loadData.ts"],"names":[],"mappings":"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","sourcesContent":["import { SqlStackError } from '../../core/errors';\nimport { quoteIdent } from '../schema/ddl';\nimport type { NormalizedTestSchema } from '../schema/types';\n\nexport class TestDataError extends SqlStackError {\n  constructor(message: string) {\n    super(message);\n    this.name = 'TestDataError';\n  }\n}\n\nexport type Row = Record<string, unknown>;\n\nexport interface DataOperation {\n  readonly table: string;\n  readonly row: Readonly<Row>;\n}\n\n/** Validate one `.data()` payload against the structured schema (fail-fast). */\nexport function toOperations(schema: NormalizedTestSchema, data: Record<string, Row[]>): DataOperation[] {\n  const ops: DataOperation[] = [];\n  const tables = new Map(schema.tables.map((t) => [t.name, t]));\n  for (const [tableName, rows] of Object.entries(data)) {\n    const table = tables.get(tableName);\n    if (!table) {\n      const known = schema.tables.map((t) => t.name).join(', ') || '(none)';\n      throw new TestDataError(\n        `.data(): unknown table \"${tableName}\". Structured tables declared in ${schema.source}: ${known}. ` +\n          `Tables created only through raw SQL cannot receive .data() rows; insert them via raw SQL instead.`\n      );\n    }\n    if (!Array.isArray(rows)) {\n      throw new TestDataError(`.data(): rows for table \"${tableName}\" must be an array`);\n    }\n    const columnNames = new Set(table.columns.map((c) => c.name));\n    rows.forEach((row, i) => {\n      if (!row || typeof row !== 'object' || Array.isArray(row)) {\n        throw new TestDataError(`.data(): row #${i} for table \"${tableName}\" must be an object`);\n      }\n      for (const key of Object.keys(row)) {\n        if (!columnNames.has(key)) {\n          throw new TestDataError(\n            `.data(): unknown column \"${key}\" in row #${i} for table \"${tableName}\" ` +\n              `(declared columns: ${[...columnNames].join(', ')})`\n          );\n        }\n      }\n      for (const pk of table.primaryKey) {\n        if (row[pk] === undefined) {\n          throw new TestDataError(\n            `.data(): row #${i} for table \"${tableName}\" is missing primary-key column \"${pk}\" ` +\n              `(primary key: ${table.primaryKey.join(', ')})`\n          );\n        }\n      }\n      ops.push({ table: tableName, row });\n    });\n  }\n  return ops;\n}\n\n/**\n * Compose row operations into effective rows per table.\n * PK tables: identity = ordered PK values; later writes replace, first\n * occurrence keeps its position. No-PK tables: append in authored order.\n */\nexport function composeRows(\n  schema: NormalizedTestSchema,\n  ops: readonly DataOperation[]\n): Map<string, Row[]> {\n  const tables = new Map(schema.tables.map((t) => [t.name, t]));\n  const result = new Map<string, Row[]>();\n  const identityIndex = new Map<string, Map<string, number>>();\n  for (const op of ops) {\n    const table = tables.get(op.table)!;\n    let rows = result.get(op.table);\n    if (!rows) {\n      rows = [];\n      result.set(op.table, rows);\n    }\n    if (table.primaryKey.length === 0) {\n      rows.push(op.row);\n      continue;\n    }\n    const identity = JSON.stringify(table.primaryKey.map((pk) => op.row[pk]));\n    let index = identityIndex.get(op.table);\n    if (!index) {\n      index = new Map();\n      identityIndex.set(op.table, index);\n    }\n    const existing = index.get(identity);\n    if (existing === undefined) {\n      index.set(identity, rows.length);\n      rows.push(op.row);\n    } else {\n      rows[existing] = op.row;\n    }\n  }\n  return result;\n}\n\n/**\n * Deterministic insertion order for the tables that actually have rows,\n * topologically sorted by declared references between those tables.\n * Cycles fail with actionable guidance.\n */\nexport function planInsertOrder(schema: NormalizedTestSchema, tablesWithRows: readonly string[]): string[] {\n  const inPlan = new Set(tablesWithRows);\n  const tables = schema.tables.filter((t) => inPlan.has(t.name));\n  // deps[t] = set of tables (with rows) that must be inserted before t\n  const deps = new Map<string, Set<string>>();\n  for (const t of tables) {\n    const set = new Set<string>();\n    for (const c of t.columns) {\n      if (c.references && c.references.table !== t.name && inPlan.has(c.references.table)) {\n        set.add(c.references.table);\n      }\n    }\n    deps.set(t.name, set);\n  }\n  const order: string[] = [];\n  const done = new Set<string>();\n  let progressed = true;\n  while (progressed && order.length < tables.length) {\n    progressed = false;\n    for (const t of tables) {\n      if (done.has(t.name)) continue;\n      const pending = [...deps.get(t.name)!].filter((d) => !done.has(d));\n      if (pending.length === 0) {\n        order.push(t.name);\n        done.add(t.name);\n        progressed = true;\n      }\n    }\n  }\n  if (order.length < tables.length) {\n    const cycle = tables.filter((t) => !done.has(t.name)).map((t) => t.name);\n    throw new TestDataError(\n      `Cannot derive an insertion order: declared references between tables [${cycle.join(', ')}] form a cycle. ` +\n        `Insert this data via a raw \"sql\" entry (e.g. with deferred constraints), or restructure the references.`\n    );\n  }\n  return order;\n}\n\n/**\n * Insert effective rows. Parameterized and batched per table by column\n * signature; missing columns are omitted from the INSERT so PostgreSQL\n * defaults apply, while explicit null is sent as NULL.\n */\nexport async function insertRows(\n  query: (sql: string, params: unknown[]) => Promise<unknown>,\n  schema: NormalizedTestSchema,\n  effective: Map<string, Row[]>\n): Promise<void> {\n  const order = planInsertOrder(schema, [...effective.keys()]);\n  const declared = new Map(schema.tables.map((t) => [t.name, t.columns.map((c) => c.name)]));\n  for (const tableName of order) {\n    const rows = effective.get(tableName)!;\n    const columnOrder = declared.get(tableName)!;\n    // Group consecutive-compatible rows into batches sharing a column signature.\n    const batches = new Map<string, { columns: string[]; rows: Row[] }>();\n    for (const row of rows) {\n      const columns = columnOrder.filter((c) => row[c] !== undefined);\n      const sig = columns.join(',');\n      let batch = batches.get(sig);\n      if (!batch) {\n        batch = { columns, rows: [] };\n        batches.set(sig, batch);\n      }\n      batch.rows.push(row);\n    }\n    for (const { columns, rows: batchRows } of batches.values()) {\n      if (columns.length === 0) {\n        for (let i = 0; i < batchRows.length; i++) {\n          await run(query, tableName, `INSERT INTO ${quoteIdent(tableName)} DEFAULT VALUES`, []);\n        }\n        continue;\n      }\n      const params: unknown[] = [];\n      const tuples = batchRows.map((row) => {\n        const placeholders = columns.map((c) => {\n          params.push(row[c]);\n          return `$${params.length}`;\n        });\n        return `(${placeholders.join(', ')})`;\n      });\n      const sql =\n        `INSERT INTO ${quoteIdent(tableName)} (${columns.map(quoteIdent).join(', ')}) ` +\n        `VALUES ${tuples.join(', ')}`;\n      await run(query, tableName, sql, params);\n    }\n  }\n}\n\nasync function run(\n  query: (sql: string, params: unknown[]) => Promise<unknown>,\n  tableName: string,\n  sql: string,\n  params: unknown[]\n): Promise<void> {\n  try {\n    await query(sql, params);\n  } catch (err) {\n    throw new TestDataError(\n      `Failed to insert scenario rows into table \"${tableName}\": ${(err as Error).message}`\n    );\n  }\n}\n"]}

package/dist/esm/testing/postgres/server.js

@@ -0,0 +1,69 @@
+import { SqlStackError } from '../../core/errors.js';
+/** Default matches docker/docker-compose.pg.yml (npm run db:pg:up). */
+export const DEFAULT_ADMIN_URL = 'postgres://postgres:postgres@127.0.0.1:55432/postgres';
+export class TestPostgresServerError extends SqlStackError {
+    constructor(message) {
+        super(message);
+        this.name = 'TestPostgresServerError';
+    }
+}
+export function resolveAdminUrl(options = {}) {
+    return options.adminUrl ?? process.env.SQLSTACK_TEST_PG_URL ?? DEFAULT_ADMIN_URL;
+}
+/**
+ * Load the `pg` driver lazily so browser/Worker bundles that never import
+ * sqlstack/testing do not see it. Testing is Node-only.
+ */
+const dynamicImport = 
+// Indirect so neither tsc's CJS downlevel nor bundlers statically link "pg".
+new Function('specifier', 'return import(specifier)');
+export async function loadPg() {
+    // CJS path first (also covers jest's VM, where dynamic import is unavailable).
+    try {
+        if (typeof require === 'function')
+            return require('pg');
+    }
+    catch {
+        /* fall through to dynamic import */
+    }
+    try {
+        return await dynamicImport('pg');
+    }
+    catch {
+        throw new TestPostgresServerError(`sqlstack/testing requires the optional "pg" package. Install it in your project (npm i -D pg).`);
+    }
+}
+/** Create a connected admin client, with an actionable diagnostic on failure. */
+export async function connectAdmin(options = {}) {
+    const url = resolveAdminUrl(options);
+    const pg = await loadPg();
+    const Client = pg.Client ?? pg.default?.Client;
+    const client = new Client({ connectionString: url });
+    try {
+        await client.connect();
+    }
+    catch (err) {
+        try {
+            await client.end();
+        }
+        catch {
+            /* ignore */
+        }
+        throw new TestPostgresServerError(`Cannot connect to the test PostgreSQL server at ${redact(url)}: ${err.message}\n` +
+            `- If you use the bundled docker server, start it with: npm run db:pg:up\n` +
+            `- Otherwise set SQLSTACK_TEST_PG_URL (or pass options.adminUrl) to an admin URL with ` +
+            `permission to CREATE/DROP DATABASE.`);
+    }
+    return client;
+}
+/** Hide password in URLs used inside diagnostics. */
+export function redact(url) {
+    return url.replace(/\/\/([^:@/]+):[^@/]+@/, '//$1:***@');
+}
+/** Replace the database segment of a postgres URL. */
+export function withDatabase(url, dbName) {
+    const u = new URL(url);
+    u.pathname = `/${dbName}`;
+    return u.toString();
+}
+//# sourceMappingURL=server.js.map

package/dist/esm/testing/postgres/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../../src/testing/postgres/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,uEAAuE;AACvE,MAAM,CAAC,MAAM,iBAAiB,GAAG,uDAAuD,CAAC;AAEzF,MAAM,OAAO,uBAAwB,SAAQ,aAAa;IACxD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAOD,MAAM,UAAU,eAAe,CAAC,UAA6B,EAAE;IAC7D,OAAO,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,iBAAiB,CAAC;AACnF,CAAC;AAED;;;GAGG;AACH,MAAM,aAAa;AACjB,6EAA6E;AAC7E,IAAI,QAAQ,CAAC,WAAW,EAAE,0BAA0B,CAAQ,CAAC;AAE/D,MAAM,CAAC,KAAK,UAAU,MAAM;IAC1B,+EAA+E;IAC/E,IAAI,CAAC;QACH,IAAI,OAAO,OAAO,KAAK,UAAU;YAAE,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,oCAAoC;IACtC,CAAC;IACD,IAAI,CAAC;QACH,OAAO,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,uBAAuB,CAC/B,gGAAgG,CACjG,CAAC;IACJ,CAAC;AACH,CAAC;AAED,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,UAA6B,EAAE;IAChE,MAAM,GAAG,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,EAAE,GAAG,MAAM,MAAM,EAAE,CAAC;IAC1B,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC;IAC/C,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,gBAAgB,EAAE,GAAG,EAAE,CAAC,CAAC;IACrD,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;IACzB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC;QACrB,CAAC;QAAC,MAAM,CAAC;YACP,YAAY;QACd,CAAC;QACD,MAAM,IAAI,uBAAuB,CAC/B,mDAAmD,MAAM,CAAC,GAAG,CAAC,KAAM,GAAa,CAAC,OAAO,IAAI;YAC3F,2EAA2E;YAC3E,uFAAuF;YACvF,qCAAqC,CACxC,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,MAAM,CAAC,GAAW;IAChC,OAAO,GAAG,CAAC,OAAO,CAAC,uBAAuB,EAAE,WAAW,CAAC,CAAC;AAC3D,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,MAAc;IACtD,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC,CAAC,QAAQ,GAAG,IAAI,MAAM,EAAE,CAAC;IAC1B,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;AACtB,CAAC","sourcesContent":["import { SqlStackError } from '../../core/errors';\n\n/** Default matches docker/docker-compose.pg.yml (npm run db:pg:up). */\nexport const DEFAULT_ADMIN_URL = 'postgres://postgres:postgres@127.0.0.1:55432/postgres';\n\nexport class TestPostgresServerError extends SqlStackError {\n  constructor(message: string) {\n    super(message);\n    this.name = 'TestPostgresServerError';\n  }\n}\n\nexport interface TestServerOptions {\n  /** Admin connection URL with CREATE/DROP DATABASE privilege. */\n  adminUrl?: string;\n}\n\nexport function resolveAdminUrl(options: TestServerOptions = {}): string {\n  return options.adminUrl ?? process.env.SQLSTACK_TEST_PG_URL ?? DEFAULT_ADMIN_URL;\n}\n\n/**\n * Load the `pg` driver lazily so browser/Worker bundles that never import\n * sqlstack/testing do not see it. Testing is Node-only.\n */\nconst dynamicImport: (specifier: string) => Promise<any> =\n  // Indirect so neither tsc's CJS downlevel nor bundlers statically link \"pg\".\n  new Function('specifier', 'return import(specifier)') as any;\n\nexport async function loadPg(): Promise<any> {\n  // CJS path first (also covers jest's VM, where dynamic import is unavailable).\n  try {\n    if (typeof require === 'function') return require('pg');\n  } catch {\n    /* fall through to dynamic import */\n  }\n  try {\n    return await dynamicImport('pg');\n  } catch {\n    throw new TestPostgresServerError(\n      `sqlstack/testing requires the optional \"pg\" package. Install it in your project (npm i -D pg).`\n    );\n  }\n}\n\n/** Create a connected admin client, with an actionable diagnostic on failure. */\nexport async function connectAdmin(options: TestServerOptions = {}): Promise<any> {\n  const url = resolveAdminUrl(options);\n  const pg = await loadPg();\n  const Client = pg.Client ?? pg.default?.Client;\n  const client = new Client({ connectionString: url });\n  try {\n    await client.connect();\n  } catch (err) {\n    try {\n      await client.end();\n    } catch {\n      /* ignore */\n    }\n    throw new TestPostgresServerError(\n      `Cannot connect to the test PostgreSQL server at ${redact(url)}: ${(err as Error).message}\\n` +\n        `- If you use the bundled docker server, start it with: npm run db:pg:up\\n` +\n        `- Otherwise set SQLSTACK_TEST_PG_URL (or pass options.adminUrl) to an admin URL with ` +\n        `permission to CREATE/DROP DATABASE.`\n    );\n  }\n  return client;\n}\n\n/** Hide password in URLs used inside diagnostics. */\nexport function redact(url: string): string {\n  return url.replace(/\\/\\/([^:@/]+):[^@/]+@/, '//$1:***@');\n}\n\n/** Replace the database segment of a postgres URL. */\nexport function withDatabase(url: string, dbName: string): string {\n  const u = new URL(url);\n  u.pathname = `/${dbName}`;\n  return u.toString();\n}\n"]}

package/dist/esm/testing/schema/ddl.js

@@ -0,0 +1,65 @@
+export function quoteIdent(name) {
+    return `"${name.replace(/"/g, '""')}"`;
+}
+function renderDefault(value) {
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'boolean')
+        return value ? 'TRUE' : 'FALSE';
+    return String(value);
+}
+function sqliteType(type) {
+    const normalized = type.trim().toLowerCase();
+    if (normalized === 'uuid')
+        return 'TEXT';
+    if (/^(timestamp|timestamptz)(\s+with(out)?\s+time\s+zone)?$/.test(normalized))
+        return 'TEXT';
+    if (normalized === 'json' || normalized === 'jsonb')
+        return 'TEXT';
+    if (normalized === 'boolean' || normalized === 'bool')
+        return 'INTEGER';
+    if (normalized === 'citext')
+        return 'TEXT COLLATE NOCASE';
+    if (/^(serial|bigserial|smallserial)$/.test(normalized))
+        return 'INTEGER';
+    if (/^(bytea)$/.test(normalized))
+        return 'BLOB';
+    if (/^(double precision|real|float[48]?)$/.test(normalized))
+        return 'REAL';
+    return type;
+}
+export function generateTableDdl(table, dialect = 'postgres') {
+    const lines = [];
+    for (const col of table.columns) {
+        const type = dialect === 'sqlite' ? sqliteType(col.type) : col.type;
+        let line = `  ${quoteIdent(col.name)} ${type}`;
+        if (!col.nullable && !col.primary)
+            line += ' NOT NULL';
+        if (col.unique && !col.primary)
+            line += ' UNIQUE';
+        if (col.hasDefault)
+            line += ` DEFAULT ${renderDefault(col.default)}`;
+        if (dialect === 'sqlite' && col.references) {
+            line += ` REFERENCES ${quoteIdent(col.references.table)} (${quoteIdent(col.references.column)})`;
+        }
+        lines.push(line);
+    }
+    if (table.primaryKey.length > 0) {
+        lines.push(`  PRIMARY KEY (${table.primaryKey.map(quoteIdent).join(', ')})`);
+    }
+    return `CREATE TABLE ${quoteIdent(table.name)} (\n${lines.join(',\n')}\n)`;
+}
+export function generateDdl(schema) {
+    const statements = schema.tables.map((table) => generateTableDdl(table, schema.dialect));
+    if (schema.dialect === 'sqlite')
+        return statements;
+    for (const table of schema.tables) {
+        for (const col of table.columns) {
+            if (col.references) {
+                statements.push(`ALTER TABLE ${quoteIdent(table.name)} ADD CONSTRAINT ${quoteIdent(`fk_${table.name}_${col.name}`)} FOREIGN KEY (${quoteIdent(col.name)}) REFERENCES ${quoteIdent(col.references.table)} (${quoteIdent(col.references.column)})`);
+            }
+        }
+    }
+    return statements;
+}
+//# sourceMappingURL=ddl.js.map

package/dist/esm/testing/schema/ddl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ddl.js","sourceRoot":"","sources":["../../../../src/testing/schema/ddl.ts"],"names":[],"mappings":"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","sourcesContent":["import type { NormalizedTable, NormalizedTestSchema } from './types';\n\nexport function quoteIdent(name: string): string {\n  return `\"${name.replace(/\"/g, '\"\"')}\"`;\n}\n\nfunction renderDefault(value: string | number | boolean): string {\n  if (typeof value === 'string') return value;\n  if (typeof value === 'boolean') return value ? 'TRUE' : 'FALSE';\n  return String(value);\n}\n\nfunction sqliteType(type: string): string {\n  const normalized = type.trim().toLowerCase();\n  if (normalized === 'uuid') return 'TEXT';\n  if (/^(timestamp|timestamptz)(\\s+with(out)?\\s+time\\s+zone)?$/.test(normalized)) return 'TEXT';\n  if (normalized === 'json' || normalized === 'jsonb') return 'TEXT';\n  if (normalized === 'boolean' || normalized === 'bool') return 'INTEGER';\n  if (normalized === 'citext') return 'TEXT COLLATE NOCASE';\n  if (/^(serial|bigserial|smallserial)$/.test(normalized)) return 'INTEGER';\n  if (/^(bytea)$/.test(normalized)) return 'BLOB';\n  if (/^(double precision|real|float[48]?)$/.test(normalized)) return 'REAL';\n  return type;\n}\n\nexport function generateTableDdl(\n  table: NormalizedTable,\n  dialect: 'postgres' | 'sqlite' = 'postgres'\n): string {\n  const lines: string[] = [];\n  for (const col of table.columns) {\n    const type = dialect === 'sqlite' ? sqliteType(col.type) : col.type;\n    let line = `  ${quoteIdent(col.name)} ${type}`;\n    if (!col.nullable && !col.primary) line += ' NOT NULL';\n    if (col.unique && !col.primary) line += ' UNIQUE';\n    if (col.hasDefault) line += ` DEFAULT ${renderDefault(col.default!)}`;\n    if (dialect === 'sqlite' && col.references) {\n      line += ` REFERENCES ${quoteIdent(col.references.table)} (${quoteIdent(col.references.column)})`;\n    }\n    lines.push(line);\n  }\n  if (table.primaryKey.length > 0) {\n    lines.push(`  PRIMARY KEY (${table.primaryKey.map(quoteIdent).join(', ')})`);\n  }\n  return `CREATE TABLE ${quoteIdent(table.name)} (\\n${lines.join(',\\n')}\\n)`;\n}\n\nexport function generateDdl(schema: NormalizedTestSchema): string[] {\n  const statements = schema.tables.map((table) => generateTableDdl(table, schema.dialect));\n  if (schema.dialect === 'sqlite') return statements;\n  for (const table of schema.tables) {\n    for (const col of table.columns) {\n      if (col.references) {\n        statements.push(\n          `ALTER TABLE ${quoteIdent(table.name)} ADD CONSTRAINT ${quoteIdent(\n            `fk_${table.name}_${col.name}`\n          )} FOREIGN KEY (${quoteIdent(col.name)}) REFERENCES ${quoteIdent(\n            col.references.table\n          )} (${quoteIdent(col.references.column)})`\n        );\n      }\n    }\n  }\n  return statements;\n}\n"]}

package/dist/esm/testing/schema/normalize.js

@@ -0,0 +1,164 @@
+import * as path from 'path';
+import * as fs from 'fs';
+import { SqlStackError } from '../../core/errors.js';
+export class TestSchemaError extends SqlStackError {
+    constructor(message, source) {
+        super(source ? `${message} (schema source: ${source})` : message);
+        this.name = 'TestSchemaError';
+    }
+}
+const IDENT = /^[A-Za-z_][A-Za-z0-9_]*$/;
+function assertIdentifier(kind, name, source) {
+    if (!IDENT.test(name)) {
+        throw new TestSchemaError(`Invalid ${kind} name ${JSON.stringify(name)}: names must match /^[A-Za-z_][A-Za-z0-9_]*$/`, source);
+    }
+}
+function parseReference(raw, where, source) {
+    if (typeof raw !== 'string') {
+        throw new TestSchemaError(`Invalid "references" at ${where}: expected a string like "table.column"`, source);
+    }
+    // Accept "table.column" or "table(column)".
+    let m = /^([A-Za-z_][A-Za-z0-9_]*)\.([A-Za-z_][A-Za-z0-9_]*)$/.exec(raw);
+    if (!m)
+        m = /^([A-Za-z_][A-Za-z0-9_]*)\(([A-Za-z_][A-Za-z0-9_]*)\)$/.exec(raw);
+    if (!m) {
+        throw new TestSchemaError(`Invalid "references" syntax ${JSON.stringify(raw)} at ${where}: use "table.column" or "table(column)"`, source);
+    }
+    return { table: m[1], column: m[2] };
+}
+const COLUMN_KEYS = new Set(['type', 'nullable', 'primary', 'unique', 'default', 'references']);
+function normalizeColumn(tableName, name, decl, source) {
+    const where = `${tableName}.${name}`;
+    assertIdentifier('column', name, source);
+    let obj;
+    if (typeof decl === 'string') {
+        obj = { type: decl };
+    }
+    else if (decl && typeof decl === 'object' && !Array.isArray(decl)) {
+        obj = decl;
+    }
+    else {
+        throw new TestSchemaError(`Malformed column declaration at ${where}: expected a type string or an object`, source);
+    }
+    for (const key of Object.keys(obj)) {
+        if (!COLUMN_KEYS.has(key)) {
+            throw new TestSchemaError(`Unknown column property ${JSON.stringify(key)} at ${where}: supported properties are ${[...COLUMN_KEYS].join(', ')}`, source);
+        }
+    }
+    const type = obj.type;
+    if (typeof type !== 'string' || type.trim() === '') {
+        throw new TestSchemaError(`Missing or invalid "type" at ${where}: a non-empty string is required`, source);
+    }
+    for (const flag of ['nullable', 'primary', 'unique']) {
+        if (obj[flag] !== undefined && typeof obj[flag] !== 'boolean') {
+            throw new TestSchemaError(`Invalid "${flag}" at ${where}: expected a boolean`, source);
+        }
+    }
+    const def = obj.default;
+    if (def !== undefined && !['string', 'number', 'boolean'].includes(typeof def)) {
+        throw new TestSchemaError(`Invalid "default" at ${where}: expected a string, number, or boolean`, source);
+    }
+    const primary = obj.primary === true;
+    return {
+        name,
+        type: type.trim(),
+        nullable: obj.nullable === undefined ? !primary : obj.nullable,
+        primary,
+        unique: obj.unique === true,
+        hasDefault: def !== undefined,
+        default: def,
+        references: obj.references === undefined ? undefined : parseReference(obj.references, where, source),
+    };
+}
+function normalizeTable(name, decl, source) {
+    assertIdentifier('table', name, source);
+    if (!decl || typeof decl !== 'object' || Array.isArray(decl)) {
+        throw new TestSchemaError(`Malformed table declaration "${name}": expected an object with "columns"`, source);
+    }
+    const columnsDecl = decl.columns;
+    if (!columnsDecl || typeof columnsDecl !== 'object' || Array.isArray(columnsDecl)) {
+        throw new TestSchemaError(`Table "${name}" is missing a "columns" map`, source);
+    }
+    const columns = Object.entries(columnsDecl).map(([colName, colDecl]) => normalizeColumn(name, colName, colDecl, source));
+    if (columns.length === 0) {
+        throw new TestSchemaError(`Table "${name}" declares no columns`, source);
+    }
+    const primaryKey = columns.filter((c) => c.primary).map((c) => c.name);
+    return { name, columns: Object.freeze(columns), primaryKey: Object.freeze(primaryKey) };
+}
+function normalizeSqlEntry(raw, index, options, source) {
+    if (typeof raw !== 'string' || raw.trim() === '') {
+        throw new TestSchemaError(`Invalid sql entry #${index}: expected a non-empty string`, source);
+    }
+    const looksLikeFile = !raw.includes('\n') && /\.sql$/i.test(raw.trim());
+    if (!looksLikeFile) {
+        return { kind: 'inline', index, sql: raw };
+    }
+    const authored = raw.trim();
+    if (!options.sourceDir) {
+        throw new TestSchemaError(`sql entry #${index} references file "${authored}" but no sourceDir is available. ` +
+            `Pass the schema as a file path, or provide { sourceDir } so relative .sql paths can be resolved ` +
+            `(paths are never resolved against process.cwd() implicitly).`, source);
+    }
+    const resolvedPath = path.resolve(options.sourceDir, authored);
+    if (!fs.existsSync(resolvedPath)) {
+        throw new TestSchemaError(`sql entry #${index}: file not found: ${authored} (resolved to ${resolvedPath})`, source);
+    }
+    return { kind: 'file', index, sourcePath: authored, resolvedPath };
+}
+export function normalizeTestSchema(doc, options = {}) {
+    const source = options.sourceLabel ?? '<inline schema>';
+    if (!doc || typeof doc !== 'object' || Array.isArray(doc)) {
+        throw new TestSchemaError('Test schema must be a YAML mapping / object', source);
+    }
+    const root = doc;
+    if (root.version !== 1) {
+        throw new TestSchemaError(`Unsupported test schema version: ${JSON.stringify(root.version)} (expected: version: 1)`, source);
+    }
+    if (root.dialect !== 'postgres' && root.dialect !== 'sqlite') {
+        throw new TestSchemaError(`Unsupported test schema dialect: ${JSON.stringify(root.dialect)} (expected: dialect: postgres or sqlite)`, source);
+    }
+    for (const key of Object.keys(root)) {
+        if (!['version', 'dialect', 'tables', 'sql'].includes(key)) {
+            throw new TestSchemaError(`Unknown top-level key ${JSON.stringify(key)} in test schema`, source);
+        }
+    }
+    let tables = [];
+    if (root.tables !== undefined) {
+        if (!root.tables || typeof root.tables !== 'object' || Array.isArray(root.tables)) {
+            throw new TestSchemaError('"tables" must be a mapping of table name to declaration', source);
+        }
+        tables = Object.entries(root.tables).map(([name, decl]) => normalizeTable(name, decl, source));
+    }
+    // Validate references that point at structured tables.
+    const byName = new Map(tables.map((t) => [t.name, t]));
+    for (const t of tables) {
+        for (const c of t.columns) {
+            const ref = c.references;
+            if (ref && byName.has(ref.table)) {
+                const target = byName.get(ref.table);
+                if (!target.columns.some((tc) => tc.name === ref.column)) {
+                    throw new TestSchemaError(`Column ${t.name}.${c.name} references ${ref.table}.${ref.column}, but table "${ref.table}" declares no column "${ref.column}"`, source);
+                }
+            }
+        }
+    }
+    let sql = [];
+    if (root.sql !== undefined) {
+        if (!Array.isArray(root.sql)) {
+            throw new TestSchemaError('"sql" must be a list of inline SQL strings or .sql file paths', source);
+        }
+        sql = root.sql.map((entry, i) => normalizeSqlEntry(entry, i, options, source));
+    }
+    if (tables.length === 0 && sql.length === 0) {
+        throw new TestSchemaError('Test schema declares no tables and no sql entries', source);
+    }
+    return Object.freeze({
+        version: 1,
+        dialect: root.dialect,
+        tables: Object.freeze(tables),
+        sql: Object.freeze(sql),
+        source,
+    });
+}
+//# sourceMappingURL=normalize.js.map