sqlstack 2.0.0 → 3.1.0

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

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Types for the sqlstack/testing versioned YAML test-schema.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

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

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

package/dist/cjs/testing/sqlite/builder.d.ts

@@ -0,0 +1,24 @@
+import type { NormalizedTestSchema, ParseTestSchemaOptions } from '../schema/types';
+import { TestSqliteDatabase } from './database';
+import { DataOperation, Row } from './loadData';
+export interface TestSqliteOptions extends ParseTestSchemaOptions {
+    /**
+     * Storage for the test database. Defaults to `'file'`: an owned temporary
+     * file, removed on `dispose()`. Pass `'memory'` to opt back into an isolated
+     * `:memory:` database — only worth it for a test that opens many databases
+     * and never touches restart behavior.
+     */
+    mode?: 'memory' | 'file';
+    /** Legacy alias for `mode`. `false` selects `:memory:`. */
+    fileBacked?: boolean;
+    /** Legacy alias for `mode`. `false` selects `:memory:`. */
+    tempFile?: boolean;
+}
+export interface TestSqliteBuilder {
+    readonly schema: NormalizedTestSchema;
+    readonly ops: readonly DataOperation[];
+    data(rows: Record<string, Row[]>): TestSqliteBuilder;
+    build(): Promise<TestSqliteDatabase>;
+}
+export declare function testSqlite(schema: string | object, options?: TestSqliteOptions): TestSqliteBuilder;
+//# sourceMappingURL=builder.d.ts.map

package/dist/cjs/testing/sqlite/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../../src/testing/sqlite/builder.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACpF,OAAO,EAAwB,kBAAkB,EAAmB,MAAM,YAAY,CAAC;AACvF,OAAO,EAAe,aAAa,EAAc,GAAG,EAAgB,MAAM,YAAY,CAAC;AAEvF,MAAM,WAAW,iBAAkB,SAAQ,sBAAsB;IAC/D;;;;;OAKG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IACzB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,GAAG,EAAE,SAAS,aAAa,EAAE,CAAC;IACvC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,iBAAiB,CAAC;IACrD,KAAK,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACtC;AAoFD,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,OAAO,GAAE,iBAAsB,GAC9B,iBAAiB,CAcnB"}

package/dist/cjs/testing/sqlite/builder.js

@@ -0,0 +1,134 @@
+"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.testSqlite = testSqlite;
+const fs = __importStar(require("node:fs"));
+const ddl_1 = require("../schema/ddl");
+const parser_1 = require("../schema/parser");
+const database_1 = require("./database");
+const loadData_1 = require("./loadData");
+function readRawSql(schema) {
+    return schema.sql.map((entry) => {
+        if (entry.kind === 'inline') {
+            return { label: `sql entry #${entry.index} (inline)`, sql: entry.sql };
+        }
+        try {
+            return {
+                label: `sql entry #${entry.index} (${entry.sourcePath})`,
+                sql: fs.readFileSync(entry.resolvedPath, 'utf8'),
+            };
+        }
+        catch (err) {
+            throw new database_1.TestSqliteError(`Cannot read raw SQL file for sql entry #${entry.index}: ${entry.resolvedPath} ` +
+                `(authored as "${entry.sourcePath}" in ${schema.source}): ${err.message}`);
+        }
+    });
+}
+async function executeRaw(handle, sql) {
+    const conn = handle.conn;
+    if (typeof conn?.exec === 'function') {
+        await conn.exec(sql);
+    }
+    else {
+        await handle.db.query(sql, []);
+    }
+}
+function makeBuilder(state) {
+    return {
+        schema: state.schema,
+        ops: state.ops,
+        data(rows) {
+            return makeBuilder({
+                ...state,
+                ops: [...state.ops, ...(0, loadData_1.toOperations)(state.schema, rows)],
+            });
+        },
+        async build() {
+            const rawSql = readRawSql(state.schema);
+            const ddl = (0, ddl_1.generateDdl)(state.schema);
+            const effective = (0, loadData_1.composeRows)(state.schema, state.ops);
+            const fileBacked = state.options.mode
+                ? state.options.mode === 'file'
+                : state.options.fileBacked !== false && state.options.tempFile !== false;
+            const handle = await (0, database_1.createDatabaseHandle)(fileBacked);
+            try {
+                for (const statement of ddl) {
+                    try {
+                        await handle.db.query(statement, []);
+                    }
+                    catch (err) {
+                        throw new database_1.TestSqliteError(`Failed to apply structured DDL from ${state.schema.source}: ${err.message}\n` +
+                            `Statement:\n${statement}`);
+                    }
+                }
+                for (const entry of rawSql) {
+                    try {
+                        await executeRaw(handle, entry.sql);
+                    }
+                    catch (err) {
+                        throw new database_1.TestSqliteError(`Failed to apply raw ${entry.label} from ${state.schema.source}: ${err.message}`);
+                    }
+                }
+                await (0, loadData_1.insertRows)((sql, params) => handle.db.query(sql, params), state.schema, effective);
+                return handle;
+            }
+            catch (err) {
+                await handle.dispose();
+                throw err;
+            }
+        },
+    };
+}
+function testSqlite(schema, options = {}) {
+    const normalized = isNormalizedSchema(schema)
+        ? schema
+        : (0, parser_1.parseTestSchema)(schema, options);
+    if (normalized.dialect !== 'sqlite') {
+        throw new database_1.TestSqliteError(`testSqlite requires a schema with dialect: sqlite (received: ${normalized.dialect})`);
+    }
+    return makeBuilder({
+        schema: normalized,
+        ops: [],
+        options: Object.freeze({ ...options }),
+    });
+}
+function isNormalizedSchema(input) {
+    return (!!input &&
+        typeof input === 'object' &&
+        Array.isArray(input.tables) &&
+        Array.isArray(input.sql) &&
+        typeof input.source === 'string');
+}
+//# sourceMappingURL=builder.js.map

package/dist/cjs/testing/sqlite/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../../../src/testing/sqlite/builder.ts"],"names":[],"mappings":"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","sourcesContent":["import * as fs from 'node:fs';\nimport { generateDdl } from '../schema/ddl';\nimport { parseTestSchema } from '../schema/parser';\nimport type { NormalizedTestSchema, ParseTestSchemaOptions } from '../schema/types';\nimport { createDatabaseHandle, TestSqliteDatabase, TestSqliteError } from './database';\nimport { composeRows, DataOperation, insertRows, Row, toOperations } from './loadData';\n\nexport interface TestSqliteOptions extends ParseTestSchemaOptions {\n  /**\n   * Storage for the test database. Defaults to `'file'`: an owned temporary\n   * file, removed on `dispose()`. Pass `'memory'` to opt back into an isolated\n   * `:memory:` database — only worth it for a test that opens many databases\n   * and never touches restart behavior.\n   */\n  mode?: 'memory' | 'file';\n  /** Legacy alias for `mode`. `false` selects `:memory:`. */\n  fileBacked?: boolean;\n  /** Legacy alias for `mode`. `false` selects `:memory:`. */\n  tempFile?: boolean;\n}\n\nexport interface TestSqliteBuilder {\n  readonly schema: NormalizedTestSchema;\n  readonly ops: readonly DataOperation[];\n  data(rows: Record<string, Row[]>): TestSqliteBuilder;\n  build(): Promise<TestSqliteDatabase>;\n}\n\ninterface BuilderState {\n  readonly schema: NormalizedTestSchema;\n  readonly ops: readonly DataOperation[];\n  readonly options: Readonly<TestSqliteOptions>;\n}\n\nfunction readRawSql(schema: NormalizedTestSchema): { label: string; sql: string }[] {\n  return schema.sql.map((entry) => {\n    if (entry.kind === 'inline') {\n      return { label: `sql entry #${entry.index} (inline)`, sql: entry.sql };\n    }\n    try {\n      return {\n        label: `sql entry #${entry.index} (${entry.sourcePath})`,\n        sql: fs.readFileSync(entry.resolvedPath, 'utf8'),\n      };\n    } catch (err) {\n      throw new TestSqliteError(\n        `Cannot read raw SQL file for sql entry #${entry.index}: ${entry.resolvedPath} ` +\n          `(authored as \"${entry.sourcePath}\" in ${schema.source}): ${(err as Error).message}`\n      );\n    }\n  });\n}\n\nasync function executeRaw(handle: TestSqliteDatabase, sql: string): Promise<void> {\n  const conn = handle.conn as { exec?: (sql: string) => unknown };\n  if (typeof conn?.exec === 'function') {\n    await conn.exec(sql);\n  } else {\n    await handle.db.query(sql, []);\n  }\n}\n\nfunction makeBuilder(state: BuilderState): TestSqliteBuilder {\n  return {\n    schema: state.schema,\n    ops: state.ops,\n    data(rows: Record<string, Row[]>): TestSqliteBuilder {\n      return makeBuilder({\n        ...state,\n        ops: [...state.ops, ...toOperations(state.schema, rows)],\n      });\n    },\n    async build(): Promise<TestSqliteDatabase> {\n      const rawSql = readRawSql(state.schema);\n      const ddl = generateDdl(state.schema);\n      const effective = composeRows(state.schema, state.ops);\n      const fileBacked = state.options.mode\n        ? state.options.mode === 'file'\n        : state.options.fileBacked !== false && state.options.tempFile !== false;\n      const handle = await createDatabaseHandle(fileBacked);\n      try {\n        for (const statement of ddl) {\n          try {\n            await handle.db.query(statement, []);\n          } catch (err) {\n            throw new TestSqliteError(\n              `Failed to apply structured DDL from ${state.schema.source}: ${(err as Error).message}\\n` +\n                `Statement:\\n${statement}`\n            );\n          }\n        }\n        for (const entry of rawSql) {\n          try {\n            await executeRaw(handle, entry.sql);\n          } catch (err) {\n            throw new TestSqliteError(\n              `Failed to apply raw ${entry.label} from ${state.schema.source}: ${(err as Error).message}`\n            );\n          }\n        }\n        await insertRows((sql, params) => handle.db.query(sql, params), state.schema, effective);\n        return handle;\n      } catch (err) {\n        await handle.dispose();\n        throw err;\n      }\n    },\n  };\n}\n\nexport function testSqlite(\n  schema: string | object,\n  options: TestSqliteOptions = {}\n): TestSqliteBuilder {\n  const normalized = isNormalizedSchema(schema)\n    ? schema\n    : parseTestSchema(schema as string | object, options);\n  if (normalized.dialect !== 'sqlite') {\n    throw new TestSqliteError(\n      `testSqlite requires a schema with dialect: sqlite (received: ${normalized.dialect})`\n    );\n  }\n  return makeBuilder({\n    schema: normalized,\n    ops: [],\n    options: Object.freeze({ ...options }),\n  });\n}\n\nfunction isNormalizedSchema(input: unknown): input is NormalizedTestSchema {\n  return (\n    !!input &&\n    typeof input === 'object' &&\n    Array.isArray((input as NormalizedTestSchema).tables) &&\n    Array.isArray((input as NormalizedTestSchema).sql) &&\n    typeof (input as NormalizedTestSchema).source === 'string'\n  );\n}\n"]}

package/dist/cjs/testing/sqlite/database.d.ts

@@ -0,0 +1,18 @@
+import { SqlStackError } from '../../core/errors';
+import type { Database } from '../../registry';
+export declare class TestSqliteError extends SqlStackError {
+    constructor(message: string);
+}
+export interface TestSqliteDatabase {
+    /** The live sqlstack SQLite adapter, suitable for direct injection. */
+    readonly db: Database;
+    /** The underlying better-sqlite3 (or sqlite3) connection. */
+    readonly conn: unknown;
+    /** Absolute database path in file mode; undefined for :memory:. */
+    readonly path?: string;
+    query(sql: string, params?: readonly unknown[]): Promise<unknown>;
+    /** Close the connection and remove owned temporary files. Idempotent. */
+    dispose(): Promise<void>;
+}
+export declare function createDatabaseHandle(fileBacked: boolean): Promise<TestSqliteDatabase>;
+//# sourceMappingURL=database.d.ts.map

package/dist/cjs/testing/sqlite/database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../../../src/testing/sqlite/database.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,qBAAa,eAAgB,SAAQ,aAAa;gBACpC,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,kBAAkB;IACjC,uEAAuE;IACvE,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,mEAAmE;IACnE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClE,yEAAyE;IACzE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAyBD,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,OAAO,GAClB,OAAO,CAAC,kBAAkB,CAAC,CA+C7B"}

package/dist/cjs/testing/sqlite/database.js

@@ -0,0 +1,123 @@
+"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.TestSqliteError = void 0;
+exports.createDatabaseHandle = createDatabaseHandle;
+const fs = __importStar(require("node:fs"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const sqlite_1 = require("../../adapters/sqlite");
+const errors_1 = require("../../core/errors");
+class TestSqliteError extends errors_1.SqlStackError {
+    constructor(message) {
+        super(message);
+        this.name = 'TestSqliteError';
+    }
+}
+exports.TestSqliteError = TestSqliteError;
+/**
+ * Temp directories for file-backed handles that were never disposed. Tests are
+ * expected to call `dispose()`, but a failed assertion can skip it; this keeps
+ * an abandoned directory from outliving the worker process.
+ */
+const abandonedDirectories = new Set();
+let exitCleanupRegistered = false;
+function trackDirectory(directory) {
+    abandonedDirectories.add(directory);
+    if (exitCleanupRegistered)
+        return;
+    exitCleanupRegistered = true;
+    process.once('exit', () => {
+        for (const dir of abandonedDirectories) {
+            try {
+                fs.rmSync(dir, { recursive: true, force: true });
+            }
+            catch {
+                /* best-effort cleanup */
+            }
+        }
+    });
+}
+async function createDatabaseHandle(fileBacked) {
+    let directory;
+    let filename = ':memory:';
+    if (fileBacked) {
+        directory = fs.mkdtempSync(path.join(os.tmpdir(), 'sqlstack-test-'));
+        filename = path.join(directory, 'database.sqlite');
+        trackDirectory(directory);
+    }
+    let db;
+    try {
+        db = await (0, sqlite_1.createSqliteDb)(filename);
+    }
+    catch (err) {
+        if (directory) {
+            fs.rmSync(directory, { recursive: true, force: true });
+            abandonedDirectories.delete(directory);
+        }
+        const message = err.message;
+        if (message.includes('No SQLite driver available')) {
+            throw new TestSqliteError('testSqlite requires the optional peer "better-sqlite3".');
+        }
+        throw new TestSqliteError(`Failed to create SQLite test database: ${message}`);
+    }
+    let disposed = false;
+    return {
+        db,
+        conn: db.conn,
+        path: fileBacked ? filename : undefined,
+        async query(sql, params = []) {
+            if (disposed)
+                throw new TestSqliteError('Test SQLite database has been disposed.');
+            return db.query(sql, [...params]);
+        },
+        async dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            try {
+                await db.close();
+            }
+            catch {
+                /* connection may already be closed */
+            }
+            if (directory) {
+                fs.rmSync(directory, { recursive: true, force: true });
+                abandonedDirectories.delete(directory);
+            }
+        },
+    };
+}
+//# sourceMappingURL=database.js.map

package/dist/cjs/testing/sqlite/database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../../../../src/testing/sqlite/database.ts"],"names":[],"mappings":"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","sourcesContent":["import * as fs from 'node:fs';\nimport * as os from 'node:os';\nimport * as path from 'node:path';\nimport { createSqliteDb } from '../../adapters/sqlite';\nimport { SqlStackError } from '../../core/errors';\nimport type { Database } from '../../registry';\n\nexport class TestSqliteError extends SqlStackError {\n  constructor(message: string) {\n    super(message);\n    this.name = 'TestSqliteError';\n  }\n}\n\nexport interface TestSqliteDatabase {\n  /** The live sqlstack SQLite adapter, suitable for direct injection. */\n  readonly db: Database;\n  /** The underlying better-sqlite3 (or sqlite3) connection. */\n  readonly conn: unknown;\n  /** Absolute database path in file mode; undefined for :memory:. */\n  readonly path?: string;\n  query(sql: string, params?: readonly unknown[]): Promise<unknown>;\n  /** Close the connection and remove owned temporary files. Idempotent. */\n  dispose(): Promise<void>;\n}\n\n/**\n * Temp directories for file-backed handles that were never disposed. Tests are\n * expected to call `dispose()`, but a failed assertion can skip it; this keeps\n * an abandoned directory from outliving the worker process.\n */\nconst abandonedDirectories = new Set<string>();\nlet exitCleanupRegistered = false;\n\nfunction trackDirectory(directory: string): void {\n  abandonedDirectories.add(directory);\n  if (exitCleanupRegistered) return;\n  exitCleanupRegistered = true;\n  process.once('exit', () => {\n    for (const dir of abandonedDirectories) {\n      try {\n        fs.rmSync(dir, { recursive: true, force: true });\n      } catch {\n        /* best-effort cleanup */\n      }\n    }\n  });\n}\n\nexport async function createDatabaseHandle(\n  fileBacked: boolean\n): Promise<TestSqliteDatabase> {\n  let directory: string | undefined;\n  let filename = ':memory:';\n  if (fileBacked) {\n    directory = fs.mkdtempSync(path.join(os.tmpdir(), 'sqlstack-test-'));\n    filename = path.join(directory, 'database.sqlite');\n    trackDirectory(directory);\n  }\n\n  let db: Database;\n  try {\n    db = await createSqliteDb(filename);\n  } catch (err) {\n    if (directory) {\n      fs.rmSync(directory, { recursive: true, force: true });\n      abandonedDirectories.delete(directory);\n    }\n    const message = (err as Error).message;\n    if (message.includes('No SQLite driver available')) {\n      throw new TestSqliteError('testSqlite requires the optional peer \"better-sqlite3\".');\n    }\n    throw new TestSqliteError(`Failed to create SQLite test database: ${message}`);\n  }\n\n  let disposed = false;\n  return {\n    db,\n    conn: db.conn,\n    path: fileBacked ? filename : undefined,\n    async query(sql: string, params: readonly unknown[] = []) {\n      if (disposed) throw new TestSqliteError('Test SQLite database has been disposed.');\n      return db.query(sql, [...params]);\n    },\n    async dispose() {\n      if (disposed) return;\n      disposed = true;\n      try {\n        await db.close();\n      } catch {\n        /* connection may already be closed */\n      }\n      if (directory) {\n        fs.rmSync(directory, { recursive: true, force: true });\n        abandonedDirectories.delete(directory);\n      }\n    },\n  };\n}\n"]}

package/dist/cjs/testing/sqlite/loadData.d.ts

@@ -0,0 +1,7 @@
+import type { NormalizedTestSchema } from '../schema/types';
+import { TestDataError, composeRows, planInsertOrder, toOperations } from '../postgres/loadData';
+import type { DataOperation, Row } from '../postgres/loadData';
+export { TestDataError, composeRows, planInsertOrder, toOperations };
+export type { DataOperation, Row };
+export declare function insertRows(query: (sql: string, params: unknown[]) => Promise<unknown>, schema: NormalizedTestSchema, effective: Map<string, Row[]>): Promise<void>;
+//# sourceMappingURL=loadData.d.ts.map

package/dist/cjs/testing/sqlite/loadData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadData.d.ts","sourceRoot":"","sources":["../../../../src/testing/sqlite/loadData.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EACL,aAAa,EACb,WAAW,EACX,eAAe,EACf,YAAY,EACb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAE/D,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,CAAC;AACrE,YAAY,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC;AAEnC,wBAAsB,UAAU,CAC9B,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,EAC3D,MAAM,EAAE,oBAAoB,EAC5B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC,CAwCf"}

package/dist/cjs/testing/sqlite/loadData.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toOperations = exports.planInsertOrder = exports.composeRows = exports.TestDataError = void 0;
+exports.insertRows = insertRows;
+const ddl_1 = require("../schema/ddl");
+const loadData_1 = require("../postgres/loadData");
+Object.defineProperty(exports, "TestDataError", { enumerable: true, get: function () { return loadData_1.TestDataError; } });
+Object.defineProperty(exports, "composeRows", { enumerable: true, get: function () { return loadData_1.composeRows; } });
+Object.defineProperty(exports, "planInsertOrder", { enumerable: true, get: function () { return loadData_1.planInsertOrder; } });
+Object.defineProperty(exports, "toOperations", { enumerable: true, get: function () { return loadData_1.toOperations; } });
+async function insertRows(query, schema, effective) {
+    const order = (0, loadData_1.planInsertOrder)(schema, [...effective.keys()]);
+    const declared = new Map(schema.tables.map((table) => [
+        table.name,
+        table.columns.map((column) => column.name),
+    ]));
+    for (const tableName of order) {
+        const rows = effective.get(tableName);
+        const columnOrder = declared.get(tableName);
+        const batches = new Map();
+        for (const row of rows) {
+            const columns = columnOrder.filter((column) => row[column] !== undefined);
+            const signature = columns.join(',');
+            const batch = batches.get(signature) ?? { columns, rows: [] };
+            batch.rows.push(row);
+            batches.set(signature, batch);
+        }
+        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 ${(0, ddl_1.quoteIdent)(tableName)} DEFAULT VALUES`, []);
+                }
+                continue;
+            }
+            const params = [];
+            const tuples = batchRows.map((row) => {
+                const placeholders = columns.map((column) => {
+                    params.push(row[column]);
+                    return '?';
+                });
+                return `(${placeholders.join(', ')})`;
+            });
+            await run(query, tableName, `INSERT INTO ${(0, ddl_1.quoteIdent)(tableName)} (${columns.map(ddl_1.quoteIdent).join(', ')}) VALUES ${tuples.join(', ')}`, params);
+        }
+    }
+}
+async function run(query, tableName, sql, params) {
+    try {
+        await query(sql, params);
+    }
+    catch (err) {
+        throw new loadData_1.TestDataError(`Failed to insert scenario rows into table "${tableName}": ${err.message}`);
+    }
+}
+//# sourceMappingURL=loadData.js.map

package/dist/cjs/testing/sqlite/loadData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadData.js","sourceRoot":"","sources":["../../../../src/testing/sqlite/loadData.ts"],"names":[],"mappings":"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","sourcesContent":["import { quoteIdent } from '../schema/ddl';\nimport type { NormalizedTestSchema } from '../schema/types';\nimport {\n  TestDataError,\n  composeRows,\n  planInsertOrder,\n  toOperations,\n} from '../postgres/loadData';\nimport type { DataOperation, Row } from '../postgres/loadData';\n\nexport { TestDataError, composeRows, planInsertOrder, toOperations };\nexport type { DataOperation, Row };\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((table) => [\n    table.name,\n    table.columns.map((column) => column.name),\n  ]));\n  for (const tableName of order) {\n    const rows = effective.get(tableName)!;\n    const columnOrder = declared.get(tableName)!;\n    const batches = new Map<string, { columns: string[]; rows: Row[] }>();\n    for (const row of rows) {\n      const columns = columnOrder.filter((column) => row[column] !== undefined);\n      const signature = columns.join(',');\n      const batch = batches.get(signature) ?? { columns, rows: [] };\n      batch.rows.push(row);\n      batches.set(signature, batch);\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((column) => {\n          params.push(row[column]);\n          return '?';\n        });\n        return `(${placeholders.join(', ')})`;\n      });\n      await run(\n        query,\n        tableName,\n        `INSERT INTO ${quoteIdent(tableName)} (${columns.map(quoteIdent).join(', ')}) VALUES ${tuples.join(', ')}`,\n        params\n      );\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/cjs/transactions.d.ts

@@ -1,4 +1,5 @@
 import type { Database, QueryResult } from './registry';
+import type { DatabaseEntry } from './stack';
 export type TransactionOptions = {
     db?: string;
     lazy?: boolean;
@@ -6,8 +7,9 @@ export type TransactionOptions = {
 };
 export declare class TransactionHandle {
     #private;
-    readonly dbName: string;
-    constructor(dbName: string, state: TxState, owned: boolean);
+    readonly entry: DatabaseEntry;
+    constructor(entry: DatabaseEntry, state: TxState, owned: boolean);
+    get dbName(): string;
     ensureStarted(): Promise<void>;
     rollbackOnly(errorToThrow?: unknown): void;
     commit(): Promise<void>;
@@ -17,7 +19,7 @@ export declare class TransactionHandle {
     finishOnError(err: unknown): Promise<void>;
 }
 declare class TxState {
-    readonly dbName: string;
+    readonly entry: DatabaseEntry;
     readonly db: Database;
     readonly options: Required<Pick<TransactionOptions, 'lazy'>> & Pick<TransactionOptions, 'nested'>;
     depth: number;
@@ -27,7 +29,7 @@ declare class TxState {
     rollbackError: unknown | undefined;
     private txDb;
     private releaseFn;
-    constructor(dbName: string, db: Database, options: TransactionOptions | undefined);
+    constructor(entry: DatabaseEntry, options: TransactionOptions | undefined);
     get activeDb(): Database;
     ensureStarted(): Promise<void>;
     query(sql: string, params: unknown[]): Promise<QueryResult>;
@@ -37,7 +39,14 @@ declare class TxState {
     finishOnSuccess(): Promise<void>;
     finishOnError(err: unknown): Promise<void>;
 }
+/**
+ * @deprecated Synchronous lookup against the legacy global registry only.
+ * Under an active IoC root, use `currentTransactionFor(entry)` with an entry
+ * from the root's SqlStack (`stack.getEntry(name)`).
+ */
 export declare function currentTransaction(db?: string): TransactionHandle | undefined;
+/** Active transaction handle for a concrete database entry, if any. */
+export declare function currentTransactionFor(entry: DatabaseEntry): TransactionHandle | undefined;
 export declare function withTransaction<T>(fn: () => Promise<T>, options?: TransactionOptions): Promise<T>;
 export type TransactionDecorator = {
     (target: any, prop: string | symbol, desc: PropertyDescriptor): void;
@@ -47,6 +56,6 @@ export declare const transaction: TransactionDecorator;
 export type ActiveTransaction = {
     query(sql: string, params: unknown[]): Promise<QueryResult>;
 };
-export declare function getActiveTransaction(dbName: string): ActiveTransaction | undefined;
+export declare function getActiveTransaction(entry: DatabaseEntry): ActiveTransaction | undefined;
 export {};
 //# sourceMappingURL=transactions.d.ts.map

package/dist/cjs/transactions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transactions.d.ts","sourceRoot":"","sources":["../../src/transactions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAKxD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AA0BF,qBAAa,iBAAiB;;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAKZ,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO;IAMpD,aAAa;IAInB,YAAY,CAAC,YAAY,CAAC,EAAE,OAAO;IAO7B,MAAM;IAKN,QAAQ;IAKR,OAAO;IAKP,eAAe;IAMf,aAAa,CAAC,GAAG,EAAE,OAAO;CAKjC;AAED,cAAM,OAAO;IACX,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;IAClG,KAAK,SAAK;IACV,OAAO,UAAS;IAChB,SAAS,UAAS;IAClB,YAAY,UAAS;IACrB,aAAa,EAAE,OAAO,GAAG,SAAS,CAAC;IAEnC,OAAO,CAAC,IAAI,CAAuB;IACnC,OAAO,CAAC,SAAS,CAAoC;gBAEzC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,GAAG,SAAS;IASjF,IAAI,QAAQ,IAAI,QAAQ,CAEvB;IAEK,aAAa;IAuCb,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IAK3D,eAAe;IAUf,iBAAiB;IAUjB,OAAO;IASP,eAAe;IAaf,aAAa,CAAC,GAAG,EAAE,OAAO;CAWjC;AAwBD,wBAAgB,kBAAkB,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAO7E;AAED,wBAAsB,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC,CAkBvG;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACrE,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,kBAAkB,KAAK,IAAI,CAAC;CACxG,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,oBAYlB,CAAC;AAST,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAC7D,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAGlF"}
+{"version":3,"file":"transactions.d.ts","sourceRoot":"","sources":["../../src/transactions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAG7C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AA6BF,qBAAa,iBAAiB;;IAC5B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;gBAKlB,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO;IAMhE,IAAI,MAAM,IAAI,MAAM,CAEnB;IAEK,aAAa;IAInB,YAAY,CAAC,YAAY,CAAC,EAAE,OAAO;IAO7B,MAAM;IAKN,QAAQ;IAKR,OAAO;IAKP,eAAe;IAMf,aAAa,CAAC,GAAG,EAAE,OAAO;CAKjC;AAED,cAAM,OAAO;IACX,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;IAClG,KAAK,SAAK;IACV,OAAO,UAAS;IAChB,SAAS,UAAS;IAClB,YAAY,UAAS;IACrB,aAAa,EAAE,OAAO,GAAG,SAAS,CAAC;IAEnC,OAAO,CAAC,IAAI,CAAuB;IACnC,OAAO,CAAC,SAAS,CAAoC;gBAEzC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,kBAAkB,GAAG,SAAS;IASzE,IAAI,QAAQ,IAAI,QAAQ,CAEvB;IAEK,aAAa;IAuCb,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IAK3D,eAAe;IAUf,iBAAiB;IAUjB,OAAO;IASP,eAAe;IAaf,aAAa,CAAC,GAAG,EAAE,OAAO;CAWjC;AAuBD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAO7E;AAED,uEAAuE;AACvE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,aAAa,GAAG,iBAAiB,GAAG,SAAS,CAKzF;AAED,wBAAsB,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC,CAkBvG;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACrE,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,kBAAkB,KAAK,IAAI,CAAC;CACxG,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,oBAYlB,CAAC;AAST,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAC7D,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,aAAa,GAAG,iBAAiB,GAAG,SAAS,CAGxF"}