sqlstack 2.0.0 → 3.1.0

package/dist/cjs/testing/postgres/server.d.ts

@@ -0,0 +1,19 @@
+import { SqlStackError } from '../../core/errors';
+/** Default matches docker/docker-compose.pg.yml (npm run db:pg:up). */
+export declare const DEFAULT_ADMIN_URL = "postgres://postgres:postgres@127.0.0.1:55432/postgres";
+export declare class TestPostgresServerError extends SqlStackError {
+    constructor(message: string);
+}
+export interface TestServerOptions {
+    /** Admin connection URL with CREATE/DROP DATABASE privilege. */
+    adminUrl?: string;
+}
+export declare function resolveAdminUrl(options?: TestServerOptions): string;
+export declare function loadPg(): Promise<any>;
+/** Create a connected admin client, with an actionable diagnostic on failure. */
+export declare function connectAdmin(options?: TestServerOptions): Promise<any>;
+/** Hide password in URLs used inside diagnostics. */
+export declare function redact(url: string): string;
+/** Replace the database segment of a postgres URL. */
+export declare function withDatabase(url: string, dbName: string): string;
+//# sourceMappingURL=server.d.ts.map

package/dist/cjs/testing/postgres/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../src/testing/postgres/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,uEAAuE;AACvE,eAAO,MAAM,iBAAiB,0DAA0D,CAAC;AAEzF,qBAAa,uBAAwB,SAAQ,aAAa;gBAC5C,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,iBAAiB;IAChC,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,eAAe,CAAC,OAAO,GAAE,iBAAsB,GAAG,MAAM,CAEvE;AAUD,wBAAsB,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,CAc3C;AAED,iFAAiF;AACjF,wBAAsB,YAAY,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,GAAG,CAAC,CAqBhF;AAED,qDAAqD;AACrD,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED,sDAAsD;AACtD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAIhE"}

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

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TestPostgresServerError = exports.DEFAULT_ADMIN_URL = void 0;
+exports.resolveAdminUrl = resolveAdminUrl;
+exports.loadPg = loadPg;
+exports.connectAdmin = connectAdmin;
+exports.redact = redact;
+exports.withDatabase = withDatabase;
+const errors_1 = require("../../core/errors");
+/** Default matches docker/docker-compose.pg.yml (npm run db:pg:up). */
+exports.DEFAULT_ADMIN_URL = 'postgres://postgres:postgres@127.0.0.1:55432/postgres';
+class TestPostgresServerError extends errors_1.SqlStackError {
+    constructor(message) {
+        super(message);
+        this.name = 'TestPostgresServerError';
+    }
+}
+exports.TestPostgresServerError = TestPostgresServerError;
+function resolveAdminUrl(options = {}) {
+    return options.adminUrl ?? process.env.SQLSTACK_TEST_PG_URL ?? exports.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)');
+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. */
+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. */
+function redact(url) {
+    return url.replace(/\/\/([^:@/]+):[^@/]+@/, '//$1:***@');
+}
+/** Replace the database segment of a postgres URL. */
+function withDatabase(url, dbName) {
+    const u = new URL(url);
+    u.pathname = `/${dbName}`;
+    return u.toString();
+}
+//# sourceMappingURL=server.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../../src/testing/postgres/server.ts"],"names":[],"mappings":";;;AAiBA,0CAEC;AAUD,wBAcC;AAGD,oCAqBC;AAGD,wBAEC;AAGD,oCAIC;AA/ED,8CAAkD;AAElD,uEAAuE;AAC1D,QAAA,iBAAiB,GAAG,uDAAuD,CAAC;AAEzF,MAAa,uBAAwB,SAAQ,sBAAa;IACxD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AALD,0DAKC;AAOD,SAAgB,eAAe,CAAC,UAA6B,EAAE;IAC7D,OAAO,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,yBAAiB,CAAC;AACnF,CAAC;AAED;;;GAGG;AACH,MAAM,aAAa;AACjB,6EAA6E;AAC7E,IAAI,QAAQ,CAAC,WAAW,EAAE,0BAA0B,CAAQ,CAAC;AAExD,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;AAC1E,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,SAAgB,MAAM,CAAC,GAAW;IAChC,OAAO,GAAG,CAAC,OAAO,CAAC,uBAAuB,EAAE,WAAW,CAAC,CAAC;AAC3D,CAAC;AAED,sDAAsD;AACtD,SAAgB,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/cjs/testing/schema/ddl.d.ts

@@ -0,0 +1,5 @@
+import type { NormalizedTable, NormalizedTestSchema } from './types';
+export declare function quoteIdent(name: string): string;
+export declare function generateTableDdl(table: NormalizedTable, dialect?: 'postgres' | 'sqlite'): string;
+export declare function generateDdl(schema: NormalizedTestSchema): string[];
+//# sourceMappingURL=ddl.d.ts.map

package/dist/cjs/testing/schema/ddl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ddl.d.ts","sourceRoot":"","sources":["../../../../src/testing/schema/ddl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAErE,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAqBD,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,eAAe,EACtB,OAAO,GAAE,UAAU,GAAG,QAAqB,GAC1C,MAAM,CAiBR;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,EAAE,CAiBlE"}

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

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.quoteIdent = quoteIdent;
+exports.generateTableDdl = generateTableDdl;
+exports.generateDdl = generateDdl;
+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;
+}
+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)`;
+}
+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/cjs/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/cjs/testing/schema/normalize.d.ts

@@ -0,0 +1,7 @@
+import { SqlStackError } from '../../core/errors';
+import type { NormalizedTestSchema, ParseTestSchemaOptions } from './types';
+export declare class TestSchemaError extends SqlStackError {
+    constructor(message: string, source?: string);
+}
+export declare function normalizeTestSchema(doc: unknown, options?: ParseTestSchemaOptions): NormalizedTestSchema;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/cjs/testing/schema/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../../src/testing/schema/normalize.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAIV,oBAAoB,EACpB,sBAAsB,EAEvB,MAAM,SAAS,CAAC;AAEjB,qBAAa,eAAgB,SAAQ,aAAa;gBACpC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAI7C;AAkID,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE,sBAA2B,GACnC,oBAAoB,CAsEtB"}

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

@@ -0,0 +1,202 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TestSchemaError = void 0;
+exports.normalizeTestSchema = normalizeTestSchema;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const errors_1 = require("../../core/errors");
+class TestSchemaError extends errors_1.SqlStackError {
+    constructor(message, source) {
+        super(source ? `${message} (schema source: ${source})` : message);
+        this.name = 'TestSchemaError';
+    }
+}
+exports.TestSchemaError = 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 };
+}
+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

package/dist/cjs/testing/schema/normalize.js.map

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

package/dist/cjs/testing/schema/parser.d.ts

@@ -0,0 +1,9 @@
+import type { NormalizedTestSchema, ParseTestSchemaOptions } from './types';
+/**
+ * Parse a test schema from a YAML string, a plain object, or a .yml/.yaml
+ * file path. When given a file path, relative raw .sql entries resolve
+ * against the file's own directory unless options.sourceDir overrides it.
+ */
+export declare function parseTestSchema(input: string | object, options?: ParseTestSchemaOptions): NormalizedTestSchema;
+export declare function isSchemaFilePath(input: string): boolean;
+//# sourceMappingURL=parser.d.ts.map

package/dist/cjs/testing/schema/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../../src/testing/schema/parser.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAE5E;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,OAAO,GAAE,sBAA2B,GACnC,oBAAoB,CAoBtB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEvD"}

package/dist/cjs/testing/schema/parser.js

@@ -0,0 +1,80 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseTestSchema = parseTestSchema;
+exports.isSchemaFilePath = isSchemaFilePath;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const yaml_1 = require("yaml");
+const normalize_1 = require("./normalize");
+/**
+ * Parse a test schema from a YAML string, a plain object, or a .yml/.yaml
+ * file path. When given a file path, relative raw .sql entries resolve
+ * against the file's own directory unless options.sourceDir overrides it.
+ */
+function parseTestSchema(input, options = {}) {
+    if (typeof input === 'object') {
+        return (0, normalize_1.normalizeTestSchema)(input, options);
+    }
+    if (isSchemaFilePath(input)) {
+        const filePath = path.resolve(input);
+        let text;
+        try {
+            text = fs.readFileSync(filePath, 'utf8');
+        }
+        catch (err) {
+            throw new normalize_1.TestSchemaError(`Cannot read test schema file: ${filePath} (${err.message})`);
+        }
+        return parseYamlText(text, {
+            sourceDir: options.sourceDir ?? path.dirname(filePath),
+            sourceLabel: options.sourceLabel ?? filePath,
+        });
+    }
+    return parseYamlText(input, options);
+}
+function isSchemaFilePath(input) {
+    return !input.includes('\n') && /\.ya?ml$/i.test(input.trim());
+}
+function parseYamlText(text, options) {
+    let doc;
+    try {
+        doc = (0, yaml_1.parse)(text);
+    }
+    catch (err) {
+        throw new normalize_1.TestSchemaError(`Failed to parse test schema YAML: ${err.message}`, options.sourceLabel);
+    }
+    return (0, normalize_1.normalizeTestSchema)(doc, options);
+}
+//# sourceMappingURL=parser.js.map

package/dist/cjs/testing/schema/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../../../src/testing/schema/parser.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAWA,0CAuBC;AAED,4CAEC;AAtCD,2CAA6B;AAC7B,uCAAyB;AACzB,+BAA0C;AAC1C,2CAAmE;AAGnE;;;;GAIG;AACH,SAAgB,eAAe,CAC7B,KAAsB,EACtB,UAAkC,EAAE;IAEpC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,IAAA,+BAAmB,EAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IACD,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,IAAY,CAAC;QACjB,IAAI,CAAC;YACH,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,2BAAe,CACvB,iCAAiC,QAAQ,KAAM,GAAa,CAAC,OAAO,GAAG,CACxE,CAAC;QACJ,CAAC;QACD,OAAO,aAAa,CAAC,IAAI,EAAE;YACzB,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;YACtD,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,QAAQ;SAC7C,CAAC,CAAC;IACL,CAAC;IACD,OAAO,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC;AAED,SAAgB,gBAAgB,CAAC,KAAa;IAC5C,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,SAAS,aAAa,CAAC,IAAY,EAAE,OAA+B;IAClE,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,IAAA,YAAS,EAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,2BAAe,CACvB,qCAAsC,GAAa,CAAC,OAAO,EAAE,EAC7D,OAAO,CAAC,WAAW,CACpB,CAAC;IACJ,CAAC;IACD,OAAO,IAAA,+BAAmB,EAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AAC3C,CAAC","sourcesContent":["import * as path from 'path';\nimport * as fs from 'fs';\nimport { parse as parseYaml } from 'yaml';\nimport { normalizeTestSchema, TestSchemaError } from './normalize';\nimport type { NormalizedTestSchema, ParseTestSchemaOptions } from './types';\n\n/**\n * Parse a test schema from a YAML string, a plain object, or a .yml/.yaml\n * file path. When given a file path, relative raw .sql entries resolve\n * against the file's own directory unless options.sourceDir overrides it.\n */\nexport function parseTestSchema(\n  input: string | object,\n  options: ParseTestSchemaOptions = {}\n): NormalizedTestSchema {\n  if (typeof input === 'object') {\n    return normalizeTestSchema(input, options);\n  }\n  if (isSchemaFilePath(input)) {\n    const filePath = path.resolve(input);\n    let text: string;\n    try {\n      text = fs.readFileSync(filePath, 'utf8');\n    } catch (err) {\n      throw new TestSchemaError(\n        `Cannot read test schema file: ${filePath} (${(err as Error).message})`\n      );\n    }\n    return parseYamlText(text, {\n      sourceDir: options.sourceDir ?? path.dirname(filePath),\n      sourceLabel: options.sourceLabel ?? filePath,\n    });\n  }\n  return parseYamlText(input, options);\n}\n\nexport function isSchemaFilePath(input: string): boolean {\n  return !input.includes('\\n') && /\\.ya?ml$/i.test(input.trim());\n}\n\nfunction parseYamlText(text: string, options: ParseTestSchemaOptions): NormalizedTestSchema {\n  let doc: unknown;\n  try {\n    doc = parseYaml(text);\n  } catch (err) {\n    throw new TestSchemaError(\n      `Failed to parse test schema YAML: ${(err as Error).message}`,\n      options.sourceLabel\n    );\n  }\n  return normalizeTestSchema(doc, options);\n}\n"]}

package/dist/cjs/testing/schema/types.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Types for the sqlstack/testing versioned YAML test-schema.
+ */
+export interface TestColumnInput {
+    type: string;
+    nullable?: boolean;
+    primary?: boolean;
+    unique?: boolean;
+    /** Raw SQL default expression (emitted verbatim into DDL). */
+    default?: string | number | boolean;
+    /** Reference target: "table.column" or "table(column)". */
+    references?: string;
+}
+export interface TestTableInput {
+    columns: Record<string, string | TestColumnInput>;
+}
+export interface TestSchemaInput {
+    version: number;
+    dialect: string;
+    tables?: Record<string, TestTableInput>;
+    sql?: string[];
+}
+export interface NormalizedReference {
+    readonly table: string;
+    readonly column: string;
+}
+export interface NormalizedColumn {
+    readonly name: string;
+    readonly type: string;
+    readonly nullable: boolean;
+    readonly primary: boolean;
+    readonly unique: boolean;
+    readonly hasDefault: boolean;
+    readonly default?: string | number | boolean;
+    readonly references?: NormalizedReference;
+}
+export interface NormalizedTable {
+    readonly name: string;
+    readonly columns: readonly NormalizedColumn[];
+    readonly primaryKey: readonly string[];
+}
+export type RawSqlEntry = {
+    readonly kind: 'inline';
+    readonly index: number;
+    readonly sql: string;
+} | {
+    readonly kind: 'file';
+    readonly index: number;
+    readonly sourcePath: string;
+    readonly resolvedPath: string;
+};
+export interface NormalizedTestSchema {
+    readonly version: 1;
+    readonly dialect: 'postgres' | 'sqlite';
+    readonly tables: readonly NormalizedTable[];
+    readonly sql: readonly RawSqlEntry[];
+    readonly source: string;
+}
+export interface ParseTestSchemaOptions {
+    sourceDir?: string;
+    sourceLabel?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/testing/schema/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/testing/schema/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACpC,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACxC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC7C,QAAQ,CAAC,UAAU,CAAC,EAAE,mBAAmB,CAAC;CAC3C;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACzE;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEN,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,QAAQ,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IAC5C,QAAQ,CAAC,GAAG,EAAE,SAAS,WAAW,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}