sqlstack 3.2.0 → 3.4.0

package/dist/cjs/testing/fixture-provenance.js

@@ -0,0 +1,21 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertFixtureSqlFile = assertFixtureSqlFile;
+const node_path_1 = __importDefault(require("node:path"));
+const node_fs_1 = require("node:fs");
+const errors_1 = require("../core/errors");
+/** File provenance guard; inline SQL still requires architecture/source review. */
+function assertFixtureSqlFile(file) {
+    const resolved = (0, node_fs_1.realpathSync)(file);
+    for (const candidate of [file, resolved]) {
+        const segments = candidate.split(/[\\/]/);
+        if (segments.some(segment => /^migrations?$/i.test(segment))
+            || /\.(up|down)\.(sql|[cm]?js|ts)$/i.test(node_path_1.default.basename(candidate))) {
+            throw new errors_1.SqlStackError(`Application fixtures cannot read migration file ${file}; use explicit schema/plain data and keep migration transitions in @noego/proper/testing.`);
+        }
+    }
+}
+//# sourceMappingURL=fixture-provenance.js.map

package/dist/cjs/testing/fixture-provenance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture-provenance.js","sourceRoot":"","sources":["../../../src/testing/fixture-provenance.ts"],"names":[],"mappings":";;;;;AAKA,oDAWC;AAhBD,0DAA6B;AAC7B,qCAAuC;AACvC,2CAA+C;AAE/C,mFAAmF;AACnF,SAAgB,oBAAoB,CAAC,IAAY;IAC/C,MAAM,QAAQ,GAAG,IAAA,sBAAY,EAAC,IAAI,CAAC,CAAC;IACpC,KAAK,MAAM,SAAS,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;eACvD,iCAAiC,CAAC,IAAI,CAAC,mBAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;YACtE,MAAM,IAAI,sBAAa,CACrB,mDAAmD,IAAI,2FAA2F,CACnJ,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC","sourcesContent":["import path from 'node:path';\nimport { realpathSync } from 'node:fs';\nimport { SqlStackError } from '../core/errors';\n\n/** File provenance guard; inline SQL still requires architecture/source review. */\nexport function assertFixtureSqlFile(file: string): void {\n  const resolved = realpathSync(file);\n  for (const candidate of [file, resolved]) {\n    const segments = candidate.split(/[\\\\/]/);\n    if (segments.some(segment => /^migrations?$/i.test(segment))\n      || /\\.(up|down)\\.(sql|[cm]?js|ts)$/i.test(path.basename(candidate))) {\n      throw new SqlStackError(\n        `Application fixtures cannot read migration file ${file}; use explicit schema/plain data and keep migration transitions in @noego/proper/testing.`,\n      );\n    }\n  }\n}\n"]}

package/dist/cjs/testing/index.d.ts

@@ -5,6 +5,8 @@ export { testSqlite } from './sqlite/builder';
 export type { TestSqliteBuilder, TestSqliteOptions } from './sqlite/builder';
 export { TestSqliteError } from './sqlite/database';
 export type { TestSqliteDatabase } from './sqlite/database';
+export { isDisposableTestDatabase, TestDatabaseDisposeError, TestDatabaseBuildError } from './resource';
+export type { DisposableTestDatabase } from './resource';
 export { parseTestSchema } from './schema/parser';
 export { normalizeTestSchema, TestSchemaError } from './schema/normalize';
 export { generateDdl } from './schema/ddl';

package/dist/cjs/testing/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAC1E,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,sBAAsB,GACvB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAC1E,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACxG,YAAY,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,sBAAsB,GACvB,MAAM,gBAAgB,CAAC"}

package/dist/cjs/testing/index.js

@@ -1,12 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_ADMIN_URL = exports.TestPostgresServerError = exports.TestDataError = exports.generateDdl = exports.TestSchemaError = exports.normalizeTestSchema = exports.parseTestSchema = exports.TestSqliteError = exports.testSqlite = exports.testPostgres = void 0;
+exports.DEFAULT_ADMIN_URL = exports.TestPostgresServerError = exports.TestDataError = exports.generateDdl = exports.TestSchemaError = exports.normalizeTestSchema = exports.parseTestSchema = exports.TestDatabaseBuildError = exports.TestDatabaseDisposeError = exports.isDisposableTestDatabase = exports.TestSqliteError = exports.testSqlite = exports.testPostgres = void 0;
 var builder_1 = require("./builder");
 Object.defineProperty(exports, "testPostgres", { enumerable: true, get: function () { return builder_1.testPostgres; } });
 var builder_2 = require("./sqlite/builder");
 Object.defineProperty(exports, "testSqlite", { enumerable: true, get: function () { return builder_2.testSqlite; } });
 var database_1 = require("./sqlite/database");
 Object.defineProperty(exports, "TestSqliteError", { enumerable: true, get: function () { return database_1.TestSqliteError; } });
+var resource_1 = require("./resource");
+Object.defineProperty(exports, "isDisposableTestDatabase", { enumerable: true, get: function () { return resource_1.isDisposableTestDatabase; } });
+Object.defineProperty(exports, "TestDatabaseDisposeError", { enumerable: true, get: function () { return resource_1.TestDatabaseDisposeError; } });
+Object.defineProperty(exports, "TestDatabaseBuildError", { enumerable: true, get: function () { return resource_1.TestDatabaseBuildError; } });
 var parser_1 = require("./schema/parser");
 Object.defineProperty(exports, "parseTestSchema", { enumerable: true, get: function () { return parser_1.parseTestSchema; } });
 var normalize_1 = require("./schema/normalize");

package/dist/cjs/testing/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":";;;AAAA,qCAAyC;AAAhC,uGAAA,YAAY,OAAA;AAGrB,4CAA8C;AAArC,qGAAA,UAAU,OAAA;AAEnB,8CAAoD;AAA3C,2GAAA,eAAe,OAAA;AAExB,0CAAkD;AAAzC,yGAAA,eAAe,OAAA;AACxB,gDAA0E;AAAjE,gHAAA,mBAAmB,OAAA;AAAE,4GAAA,eAAe,OAAA;AAC7C,oCAA2C;AAAlC,kGAAA,WAAW,OAAA;AACpB,gDAAoD;AAA3C,yGAAA,aAAa,OAAA;AACtB,4CAA+E;AAAtE,iHAAA,uBAAuB,OAAA;AAAE,2GAAA,iBAAiB,OAAA","sourcesContent":["export { testPostgres } from './builder';\nexport type { TestPostgresBuilder, TestPostgresOptions } from './builder';\nexport type { TestPostgresDatabase } from './postgres/database';\nexport { testSqlite } from './sqlite/builder';\nexport type { TestSqliteBuilder, TestSqliteOptions } from './sqlite/builder';\nexport { TestSqliteError } from './sqlite/database';\nexport type { TestSqliteDatabase } from './sqlite/database';\nexport { parseTestSchema } from './schema/parser';\nexport { normalizeTestSchema, TestSchemaError } from './schema/normalize';\nexport { generateDdl } from './schema/ddl';\nexport { TestDataError } from './postgres/loadData';\nexport { TestPostgresServerError, DEFAULT_ADMIN_URL } from './postgres/server';\nexport type {\n  NormalizedTestSchema,\n  NormalizedTable,\n  NormalizedColumn,\n  RawSqlEntry,\n  ParseTestSchemaOptions,\n} from './schema/types';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":";;;AAAA,qCAAyC;AAAhC,uGAAA,YAAY,OAAA;AAGrB,4CAA8C;AAArC,qGAAA,UAAU,OAAA;AAEnB,8CAAoD;AAA3C,2GAAA,eAAe,OAAA;AAExB,uCAAwG;AAA/F,oHAAA,wBAAwB,OAAA;AAAE,oHAAA,wBAAwB,OAAA;AAAE,kHAAA,sBAAsB,OAAA;AAEnF,0CAAkD;AAAzC,yGAAA,eAAe,OAAA;AACxB,gDAA0E;AAAjE,gHAAA,mBAAmB,OAAA;AAAE,4GAAA,eAAe,OAAA;AAC7C,oCAA2C;AAAlC,kGAAA,WAAW,OAAA;AACpB,gDAAoD;AAA3C,yGAAA,aAAa,OAAA;AACtB,4CAA+E;AAAtE,iHAAA,uBAAuB,OAAA;AAAE,2GAAA,iBAAiB,OAAA","sourcesContent":["export { testPostgres } from './builder';\nexport type { TestPostgresBuilder, TestPostgresOptions } from './builder';\nexport type { TestPostgresDatabase } from './postgres/database';\nexport { testSqlite } from './sqlite/builder';\nexport type { TestSqliteBuilder, TestSqliteOptions } from './sqlite/builder';\nexport { TestSqliteError } from './sqlite/database';\nexport type { TestSqliteDatabase } from './sqlite/database';\nexport { isDisposableTestDatabase, TestDatabaseDisposeError, TestDatabaseBuildError } from './resource';\nexport type { DisposableTestDatabase } from './resource';\nexport { parseTestSchema } from './schema/parser';\nexport { normalizeTestSchema, TestSchemaError } from './schema/normalize';\nexport { generateDdl } from './schema/ddl';\nexport { TestDataError } from './postgres/loadData';\nexport { TestPostgresServerError, DEFAULT_ADMIN_URL } from './postgres/server';\nexport type {\n  NormalizedTestSchema,\n  NormalizedTable,\n  NormalizedColumn,\n  RawSqlEntry,\n  ParseTestSchemaOptions,\n} from './schema/types';\n"]}

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

@@ -1,10 +1,18 @@
 import { TestServerOptions } from './server';
 /** The built test database handle. */
 export interface TestPostgresDatabase {
+    /** Engine discriminator for SQLStack-minted disposable test databases. */
+    readonly engine: 'postgres';
+    /** Fresh per-allocation identifier; never reused within a process. */
+    readonly resourceId: string;
     /** Normal PostgreSQL connection string identifying only this database. */
     readonly url: string;
     query(sql: string, params?: readonly unknown[]): Promise<unknown>;
-    /** Close helper connections and drop the owned database. Idempotent. */
+    /**
+     * Close helper connections and drop the owned database. Idempotent:
+     * concurrent and repeated calls share one outcome. Every cleanup step is
+     * attempted; failures are aggregated into a `TestDatabaseDisposeError`.
+     */
     dispose(): Promise<void>;
 }
 export interface OwnedDatabase {

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

@@ -1 +1 @@
-{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../../../src/testing/postgres/database.ts"],"names":[],"mappings":"AACA,OAAO,EAAmC,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE9E,sCAAsC;AACtC,MAAM,WAAW,oBAAoB;IACnC,0EAA0E;IAC1E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClE,wEAAwE;IACxE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,aAAa,EACpB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,oBAAoB,GAAG;IAAE,KAAK,EAAE,GAAG,CAAA;CAAE,CAAC,CA4BhD"}
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../../../src/testing/postgres/database.ts"],"names":[],"mappings":"AACA,OAAO,EAAmC,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAG9E,sCAAsC;AACtC,MAAM,WAAW,oBAAoB;IACnC,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,sEAAsE;IACtE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,0EAA0E;IAC1E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClE;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,aAAa,EACpB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,oBAAoB,GAAG;IAAE,KAAK,EAAE,GAAG,CAAA;CAAE,CAAC,CAkChD"}

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

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createDatabaseHandle = createDatabaseHandle;
 const allocator_1 = require("./allocator");
 const server_1 = require("./server");
+const resource_1 = require("../resource");
 /**
  * Connect a helper pool to an allocated database and produce the handle.
  * The handle owns exactly this database and drops it on dispose.
@@ -11,29 +12,32 @@ async function createDatabaseHandle(owned, options = {}) {
     const pg = await (0, server_1.loadPg)();
     const Pool = pg.Pool ?? pg.default?.Pool;
     const pool = new Pool({ connectionString: owned.url, max: 4 });
-    let disposed = false;
-    return {
+    const resourceId = (0, resource_1.mintResourceId)('postgres');
+    let disposal;
+    const handle = {
+        engine: 'postgres',
+        resourceId,
         url: owned.url,
         _pool: pool,
         async query(sql, params = []) {
-            if (disposed) {
+            if (disposal) {
                 throw new server_1.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();
+        dispose() {
+            if (!disposal) {
+                (0, resource_1.retireResource)(handle);
+                disposal = Promise.resolve().then(() => (0, resource_1.runCleanupSteps)(`Test database "${owned.name}"`, [
+                    () => pool.end(),
+                    () => (0, allocator_1.dropDatabase)(owned.name, options),
+                ]));
             }
-            catch {
-                /* pool may already be closed */
-            }
-            await (0, allocator_1.dropDatabase)(owned.name, options);
+            return disposal;
         },
     };
+    (0, resource_1.registerResource)(handle, { engine: 'postgres', resourceId });
+    return handle;
 }
 //# sourceMappingURL=database.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"database.js","sourceRoot":"","sources":["../../../../src/testing/postgres/database.ts"],"names":[],"mappings":";;AAqBA,oDA+BC;AApDD,2CAA2C;AAC3C,qCAA8E;AAgB9E;;;GAGG;AACI,KAAK,UAAU,oBAAoB,CACxC,KAAoB,EACpB,UAA6B,EAAE;IAE/B,MAAM,EAAE,GAAG,MAAM,IAAA,eAAM,GAAE,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,gCAAuB,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,IAAA,wBAAY,EAAC,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"]}
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../../../../src/testing/postgres/database.ts"],"names":[],"mappings":";;AA8BA,oDAqCC;AAnED,2CAA2C;AAC3C,qCAA8E;AAC9E,0CAAgG;AAwBhG;;;GAGG;AACI,KAAK,UAAU,oBAAoB,CACxC,KAAoB,EACpB,UAA6B,EAAE;IAE/B,MAAM,EAAE,GAAG,MAAM,IAAA,eAAM,GAAE,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,MAAM,UAAU,GAAG,IAAA,yBAAc,EAAC,UAAU,CAAC,CAAC;IAC9C,IAAI,QAAmC,CAAC;IAExC,MAAM,MAAM,GAA0C;QACpD,MAAM,EAAE,UAAU;QAClB,UAAU;QACV,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,gCAAuB,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,OAAO;YACL,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,IAAA,yBAAc,EAAC,MAAM,CAAC,CAAC;gBACvB,QAAQ,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAA,0BAAe,EAAC,kBAAkB,KAAK,CAAC,IAAI,GAAG,EAAE;oBACvF,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;oBAChB,GAAG,EAAE,CAAC,IAAA,wBAAY,EAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC;iBACxC,CAAC,CAAC,CAAC;YACN,CAAC;YACD,OAAO,QAAQ,CAAC;QAClB,CAAC;KACF,CAAC;IACF,IAAA,2BAAgB,EAAC,MAAM,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC;IAC7D,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["import { dropDatabase } from './allocator';\nimport { loadPg, TestPostgresServerError, TestServerOptions } from './server';\nimport { mintResourceId, registerResource, retireResource, runCleanupSteps } from '../resource';\n\n/** The built test database handle. */\nexport interface TestPostgresDatabase {\n  /** Engine discriminator for SQLStack-minted disposable test databases. */\n  readonly engine: 'postgres';\n  /** Fresh per-allocation identifier; never reused within a process. */\n  readonly resourceId: string;\n  /** Normal PostgreSQL connection string identifying only this database. */\n  readonly url: string;\n  query(sql: string, params?: readonly unknown[]): Promise<unknown>;\n  /**\n   * Close helper connections and drop the owned database. Idempotent:\n   * concurrent and repeated calls share one outcome. Every cleanup step is\n   * attempted; failures are aggregated into a `TestDatabaseDisposeError`.\n   */\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  const resourceId = mintResourceId('postgres');\n  let disposal: Promise<void> | undefined;\n\n  const handle: TestPostgresDatabase & { _pool: any } = {\n    engine: 'postgres',\n    resourceId,\n    url: owned.url,\n    _pool: pool,\n    async query(sql: string, params: readonly unknown[] = []) {\n      if (disposal) {\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    dispose() {\n      if (!disposal) {\n        retireResource(handle);\n        disposal = Promise.resolve().then(() => runCleanupSteps(`Test database \"${owned.name}\"`, [\n          () => pool.end(),\n          () => dropDatabase(owned.name, options),\n        ]));\n      }\n      return disposal;\n    },\n  };\n  registerResource(handle, { engine: 'postgres', resourceId });\n  return handle;\n}\n"]}

package/dist/cjs/testing/resource.d.ts

@@ -0,0 +1,76 @@
+import { SqlStackError } from '../core/errors';
+import type { TestPostgresDatabase } from './postgres/database';
+import type { TestSqliteDatabase } from './sqlite/database';
+/**
+ * Internal provenance for SQLStack-minted disposable test databases.
+ *
+ * Every handle allocated by a SQLStack fixture builder is registered here at
+ * allocation time and retired on dispose. Membership is module-private:
+ * nothing outside this package can mint, register, or extend a handle's
+ * lifetime, and structural copies (spread, `{ ...handle }`, hand-built
+ * lookalikes) never validate because verification is by object identity.
+ */
+/** A disposable test database minted by a SQLStack fixture allocation. */
+export type DisposableTestDatabase = (TestPostgresDatabase & {
+    readonly engine: 'postgres';
+    readonly resourceId: string;
+}) | (TestSqliteDatabase & {
+    readonly engine: 'sqlite';
+    readonly resourceId: string;
+    readonly storage: 'memory' | 'file';
+});
+export type DisposableEngine = DisposableTestDatabase['engine'];
+interface ResourceRecord {
+    readonly engine: DisposableEngine;
+    readonly resourceId: string;
+    readonly storage?: 'memory' | 'file';
+    readonly url?: unknown;
+    readonly db?: unknown;
+    readonly conn?: unknown;
+    readonly path?: unknown;
+    readonly query?: unknown;
+    readonly dispose?: unknown;
+}
+/** Fresh, process-unique identifier for one allocation. */
+export declare function mintResourceId(engine: DisposableEngine): string;
+/**
+ * Register a freshly allocated handle as an active SQLStack resource.
+ * Only fixture allocation code paths call this; it is never exported from
+ * `sqlstack/testing`.
+ */
+export declare function registerResource(handle: object, record: ResourceRecord): void;
+/**
+ * Optional shared testing resource-scope ABI. SQLStack remains independently
+ * usable; it never creates a scope or imports a test runner.
+ * Called within the builder's rollback boundary before returning a fixture.
+ */
+export declare function adoptFixtureResource<T extends {
+    dispose(): unknown;
+}>(handle: T): T;
+/** Mark a handle's owned resources as released. Verification fails from now on. */
+export declare function retireResource(handle: object): void;
+/**
+ * True only for a handle object that was minted by a SQLStack fixture
+ * allocation in this process and has not been disposed. Field checks are a
+ * consistency guard on top of identity membership, never a substitute for it.
+ */
+export declare function isDisposableTestDatabase(value: unknown): value is DisposableTestDatabase;
+/** Failed fixture construction plus failed rollback, preserving both causes. */
+export declare class TestDatabaseBuildError extends SqlStackError {
+    readonly cause: unknown;
+    readonly errors: readonly unknown[];
+    constructor(message: string, cause: unknown, cleanup: unknown);
+}
+/** Raised by `dispose()` when one or more owned cleanup steps failed. */
+export declare class TestDatabaseDisposeError extends SqlStackError {
+    /** Every cleanup failure, in attempt order. Nothing is swallowed. */
+    readonly errors: readonly unknown[];
+    constructor(message: string, errors: readonly unknown[]);
+}
+/**
+ * Run every cleanup step, retaining each failure, then either resolve or
+ * reject once with all retained errors.
+ */
+export declare function runCleanupSteps(label: string, steps: readonly (() => Promise<void> | void)[]): Promise<void>;
+export {};
+//# sourceMappingURL=resource.d.ts.map

package/dist/cjs/testing/resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../../src/testing/resource.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D;;;;;;;;GAQG;AAEH,0EAA0E;AAC1E,MAAM,MAAM,sBAAsB,GAC9B,CAAC,oBAAoB,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,GACrF,CAAC,kBAAkB,GAAG;IACpB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAC;CACrC,CAAC,CAAC;AAEP,MAAM,MAAM,gBAAgB,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;AAEhE,UAAU,cAAc;IACtB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IACrC,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AASD,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAG/D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,CAK7E;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS;IAAE,OAAO,IAAI,OAAO,CAAA;CAAE,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAOnF;AAED,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,sBAAsB,CAcxF;AAED,gFAAgF;AAChF,qBAAa,sBAAuB,SAAQ,aAAa;IAE1B,QAAQ,CAAC,KAAK,EAAE,OAAO;IADpD,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC;gBACxB,OAAO,EAAE,MAAM,EAAW,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO;CAKvE;AAED,yEAAyE;AACzE,qBAAa,wBAAyB,SAAQ,aAAa;IACzD,qEAAqE;IACrE,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC;gBAExB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,OAAO,EAAE;CAKxD;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,SAAS,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,GAC7C,OAAO,CAAC,IAAI,CAAC,CAiBf"}

package/dist/cjs/testing/resource.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TestDatabaseDisposeError = exports.TestDatabaseBuildError = void 0;
+exports.mintResourceId = mintResourceId;
+exports.registerResource = registerResource;
+exports.adoptFixtureResource = adoptFixtureResource;
+exports.retireResource = retireResource;
+exports.isDisposableTestDatabase = isDisposableTestDatabase;
+exports.runCleanupSteps = runCleanupSteps;
+const node_crypto_1 = require("node:crypto");
+const errors_1 = require("../core/errors");
+/** Handles whose owned resources are currently allocated (not yet disposed). */
+const active = new WeakSet();
+/** Provenance recorded at mint time, kept for the handle's whole lifetime. */
+const provenance = new WeakMap();
+let counter = 0;
+/** Fresh, process-unique identifier for one allocation. */
+function mintResourceId(engine) {
+    counter += 1;
+    return `${engine}-${(0, node_crypto_1.randomBytes)(6).toString('hex')}-${counter}`;
+}
+/**
+ * Register a freshly allocated handle as an active SQLStack resource.
+ * Only fixture allocation code paths call this; it is never exported from
+ * `sqlstack/testing`.
+ */
+function registerResource(handle, record) {
+    const locator = handle;
+    provenance.set(handle, Object.freeze({ ...record, url: locator.url, db: locator.db,
+        conn: locator.conn, path: locator.path, query: locator.query, dispose: locator.dispose }));
+    active.add(handle);
+}
+/**
+ * Optional shared testing resource-scope ABI. SQLStack remains independently
+ * usable; it never creates a scope or imports a test runner.
+ * Called within the builder's rollback boundary before returning a fixture.
+ */
+function adoptFixtureResource(handle) {
+    const channel = globalThis[Symbol.for('@noego/testing.resource-scope.v1')];
+    if (channel) {
+        if (typeof channel.getStore !== 'function')
+            throw new Error('Incompatible NoEgo resource-scope v1 channel');
+        channel.getStore()?.own(handle, 'sqlstack fixture');
+    }
+    return handle;
+}
+/** Mark a handle's owned resources as released. Verification fails from now on. */
+function retireResource(handle) {
+    active.delete(handle);
+}
+/**
+ * True only for a handle object that was minted by a SQLStack fixture
+ * allocation in this process and has not been disposed. Field checks are a
+ * consistency guard on top of identity membership, never a substitute for it.
+ */
+function isDisposableTestDatabase(value) {
+    if (value === null || (typeof value !== 'object' && typeof value !== 'function'))
+        return false;
+    const handle = value;
+    if (!active.has(handle))
+        return false;
+    const record = provenance.get(handle);
+    if (!record)
+        return false;
+    const candidate = handle;
+    if (candidate.engine !== record.engine || candidate.resourceId !== record.resourceId)
+        return false;
+    if (record.engine === 'sqlite' && candidate.storage !== record.storage)
+        return false;
+    const locator = handle;
+    for (const key of ['url', 'db', 'conn', 'path', 'query', 'dispose']) {
+        if (locator[key] !== record[key])
+            return false;
+    }
+    return true;
+}
+/** Failed fixture construction plus failed rollback, preserving both causes. */
+class TestDatabaseBuildError extends errors_1.SqlStackError {
+    constructor(message, cause, cleanup) {
+        super(message);
+        this.cause = cause;
+        this.name = 'TestDatabaseBuildError';
+        this.errors = Object.freeze([cause, cleanup]);
+    }
+}
+exports.TestDatabaseBuildError = TestDatabaseBuildError;
+/** Raised by `dispose()` when one or more owned cleanup steps failed. */
+class TestDatabaseDisposeError extends errors_1.SqlStackError {
+    constructor(message, errors) {
+        super(message);
+        this.name = 'TestDatabaseDisposeError';
+        this.errors = Object.freeze([...errors]);
+    }
+}
+exports.TestDatabaseDisposeError = TestDatabaseDisposeError;
+/**
+ * Run every cleanup step, retaining each failure, then either resolve or
+ * reject once with all retained errors.
+ */
+async function runCleanupSteps(label, steps) {
+    const errors = [];
+    for (const step of steps) {
+        try {
+            await step();
+        }
+        catch (err) {
+            errors.push(err);
+        }
+    }
+    if (errors.length === 0)
+        return;
+    const detail = errors
+        .map((err, index) => `  [${index + 1}] ${err instanceof Error ? err.message : String(err)}`)
+        .join('\n');
+    throw new TestDatabaseDisposeError(`${label}: ${errors.length} cleanup step(s) failed while disposing:\n${detail}`, errors);
+}
+//# sourceMappingURL=resource.js.map

package/dist/cjs/testing/resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.js","sourceRoot":"","sources":["../../../src/testing/resource.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomBytes } from 'node:crypto';\nimport { SqlStackError } from '../core/errors';\nimport type { TestPostgresDatabase } from './postgres/database';\nimport type { TestSqliteDatabase } from './sqlite/database';\n\n/**\n * Internal provenance for SQLStack-minted disposable test databases.\n *\n * Every handle allocated by a SQLStack fixture builder is registered here at\n * allocation time and retired on dispose. Membership is module-private:\n * nothing outside this package can mint, register, or extend a handle's\n * lifetime, and structural copies (spread, `{ ...handle }`, hand-built\n * lookalikes) never validate because verification is by object identity.\n */\n\n/** A disposable test database minted by a SQLStack fixture allocation. */\nexport type DisposableTestDatabase =\n  | (TestPostgresDatabase & { readonly engine: 'postgres'; readonly resourceId: string })\n  | (TestSqliteDatabase & {\n      readonly engine: 'sqlite';\n      readonly resourceId: string;\n      readonly storage: 'memory' | 'file';\n    });\n\nexport type DisposableEngine = DisposableTestDatabase['engine'];\n\ninterface ResourceRecord {\n  readonly engine: DisposableEngine;\n  readonly resourceId: string;\n  readonly storage?: 'memory' | 'file';\n  readonly url?: unknown;\n  readonly db?: unknown;\n  readonly conn?: unknown;\n  readonly path?: unknown;\n  readonly query?: unknown;\n  readonly dispose?: unknown;\n}\n\n/** Handles whose owned resources are currently allocated (not yet disposed). */\nconst active = new WeakSet<object>();\n/** Provenance recorded at mint time, kept for the handle's whole lifetime. */\nconst provenance = new WeakMap<object, ResourceRecord>();\n\nlet counter = 0;\n\n/** Fresh, process-unique identifier for one allocation. */\nexport function mintResourceId(engine: DisposableEngine): string {\n  counter += 1;\n  return `${engine}-${randomBytes(6).toString('hex')}-${counter}`;\n}\n\n/**\n * Register a freshly allocated handle as an active SQLStack resource.\n * Only fixture allocation code paths call this; it is never exported from\n * `sqlstack/testing`.\n */\nexport function registerResource(handle: object, record: ResourceRecord): void {\n  const locator = handle as Record<string, unknown>;\n  provenance.set(handle, Object.freeze({ ...record, url: locator.url, db: locator.db,\n    conn: locator.conn, path: locator.path, query: locator.query, dispose: locator.dispose }));\n  active.add(handle);\n}\n\n/**\n * Optional shared testing resource-scope ABI. SQLStack remains independently\n * usable; it never creates a scope or imports a test runner.\n * Called within the builder's rollback boundary before returning a fixture.\n */\nexport function adoptFixtureResource<T extends { dispose(): unknown }>(handle: T): T {\n  const channel = (globalThis as Record<PropertyKey, any>)[Symbol.for('@noego/testing.resource-scope.v1')];\n  if (channel) {\n    if (typeof channel.getStore !== 'function') throw new Error('Incompatible NoEgo resource-scope v1 channel');\n    channel.getStore()?.own(handle, 'sqlstack fixture');\n  }\n  return handle;\n}\n\n/** Mark a handle's owned resources as released. Verification fails from now on. */\nexport function retireResource(handle: object): void {\n  active.delete(handle);\n}\n\n/**\n * True only for a handle object that was minted by a SQLStack fixture\n * allocation in this process and has not been disposed. Field checks are a\n * consistency guard on top of identity membership, never a substitute for it.\n */\nexport function isDisposableTestDatabase(value: unknown): value is DisposableTestDatabase {\n  if (value === null || (typeof value !== 'object' && typeof value !== 'function')) return false;\n  const handle = value as object;\n  if (!active.has(handle)) return false;\n  const record = provenance.get(handle);\n  if (!record) return false;\n  const candidate = handle as { engine?: unknown; resourceId?: unknown; storage?: unknown };\n  if (candidate.engine !== record.engine || candidate.resourceId !== record.resourceId) return false;\n  if (record.engine === 'sqlite' && candidate.storage !== record.storage) return false;\n  const locator = handle as Record<string, unknown>;\n  for (const key of ['url', 'db', 'conn', 'path', 'query', 'dispose'] as const) {\n    if (locator[key] !== record[key]) return false;\n  }\n  return true;\n}\n\n/** Failed fixture construction plus failed rollback, preserving both causes. */\nexport class TestDatabaseBuildError extends SqlStackError {\n  readonly errors: readonly unknown[];\n  constructor(message: string, readonly cause: unknown, cleanup: unknown) {\n    super(message);\n    this.name = 'TestDatabaseBuildError';\n    this.errors = Object.freeze([cause, cleanup]);\n  }\n}\n\n/** Raised by `dispose()` when one or more owned cleanup steps failed. */\nexport class TestDatabaseDisposeError extends SqlStackError {\n  /** Every cleanup failure, in attempt order. Nothing is swallowed. */\n  readonly errors: readonly unknown[];\n\n  constructor(message: string, errors: readonly unknown[]) {\n    super(message);\n    this.name = 'TestDatabaseDisposeError';\n    this.errors = Object.freeze([...errors]);\n  }\n}\n\n/**\n * Run every cleanup step, retaining each failure, then either resolve or\n * reject once with all retained errors.\n */\nexport async function runCleanupSteps(\n  label: string,\n  steps: readonly (() => Promise<void> | void)[]\n): Promise<void> {\n  const errors: unknown[] = [];\n  for (const step of steps) {\n    try {\n      await step();\n    } catch (err) {\n      errors.push(err);\n    }\n  }\n  if (errors.length === 0) return;\n  const detail = errors\n    .map((err, index) => `  [${index + 1}] ${err instanceof Error ? err.message : String(err)}`)\n    .join('\\n');\n  throw new TestDatabaseDisposeError(\n    `${label}: ${errors.length} cleanup step(s) failed while disposing:\\n${detail}`,\n    errors\n  );\n}\n"]}

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

@@ -1 +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"}
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../../src/testing/sqlite/builder.ts"],"names":[],"mappings":"AAKA,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;AAsFD,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,OAAO,GAAE,iBAAsB,GAC9B,iBAAiB,CAcnB"}

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

@@ -35,6 +35,8 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.testSqlite = testSqlite;
 const fs = __importStar(require("node:fs"));
+const resource_1 = require("../resource");
+const fixture_provenance_1 = require("../fixture-provenance");
 const ddl_1 = require("../schema/ddl");
 const parser_1 = require("../schema/parser");
 const database_1 = require("./database");
@@ -45,6 +47,7 @@ function readRawSql(schema) {
             return { label: `sql entry #${entry.index} (inline)`, sql: entry.sql };
         }
         try {
+            (0, fixture_provenance_1.assertFixtureSqlFile)(entry.resolvedPath);
             return {
                 label: `sql entry #${entry.index} (${entry.sourcePath})`,
                 sql: fs.readFileSync(entry.resolvedPath, 'utf8'),
@@ -102,10 +105,15 @@ function makeBuilder(state) {
                     }
                 }
                 await (0, loadData_1.insertRows)((sql, params) => handle.db.query(sql, params), state.schema, effective);
-                return handle;
+                return (0, resource_1.adoptFixtureResource)(handle);
             }
             catch (err) {
-                await handle.dispose();
+                try {
+                    await handle.dispose();
+                }
+                catch (cleanup) {
+                    throw new resource_1.TestDatabaseBuildError('SQLite fixture build and cleanup failed', err, cleanup);
+                }
                 throw err;
             }
         },

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

@@ -1 +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"]}
+{"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 { adoptFixtureResource, TestDatabaseBuildError } from '../resource';\nimport { assertFixtureSqlFile } from '../fixture-provenance';\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      assertFixtureSqlFile(entry.resolvedPath);\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 adoptFixtureResource(handle);\n      } catch (err) {\n        try { await handle.dispose(); }\n        catch (cleanup) { throw new TestDatabaseBuildError('SQLite fixture build and cleanup failed', err, cleanup); }\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

@@ -4,6 +4,12 @@ export declare class TestSqliteError extends SqlStackError {
     constructor(message: string);
 }
 export interface TestSqliteDatabase {
+    /** Engine discriminator for SQLStack-minted disposable test databases. */
+    readonly engine: 'sqlite';
+    /** Fresh per-allocation identifier; never reused within a process. */
+    readonly resourceId: string;
+    /** Explicit storage: an owned temporary file, or an isolated `:memory:` db. */
+    readonly storage: 'memory' | 'file';
     /** The live sqlstack SQLite adapter, suitable for direct injection. */
     readonly db: Database;
     /** The underlying better-sqlite3 (or sqlite3) connection. */
@@ -11,7 +17,11 @@ export interface TestSqliteDatabase {
     /** 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. */
+    /**
+     * Close the connection and remove owned temporary files. Idempotent:
+     * concurrent and repeated calls share one outcome. Every cleanup step is
+     * attempted; failures are aggregated into a `TestDatabaseDisposeError`.
+     */
     dispose(): Promise<void>;
 }
 export declare function createDatabaseHandle(fileBacked: boolean): Promise<TestSqliteDatabase>;

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

@@ -1 +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"}
+{"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;AAG/C,qBAAa,eAAgB,SAAQ,aAAa;gBACpC,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,kBAAkB;IACjC,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,sEAAsE;IACtE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAC;IACpC,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;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAgCD,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,OAAO,GAClB,OAAO,CAAC,kBAAkB,CAAC,CAsD7B"}

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

@@ -40,6 +40,7 @@ const os = __importStar(require("node:os"));
 const path = __importStar(require("node:path"));
 const sqlite_1 = require("../../adapters/sqlite");
 const errors_1 = require("../../core/errors");
+const resource_1 = require("../resource");
 class TestSqliteError extends errors_1.SqlStackError {
     constructor(message) {
         super(message);
@@ -70,6 +71,12 @@ function trackDirectory(directory) {
         }
     });
 }
+/** Remove exactly the SQLStack-owned temp directory; never a caller path. */
+function removeOwnedDirectory(directory) {
+    fs.rmSync(directory, { recursive: true, force: true });
+    // Keep failed paths in the owned inventory for the exit cleanup retry.
+    abandonedDirectories.delete(directory);
+}
 async function createDatabaseHandle(fileBacked) {
     let directory;
     let filename = ':memory:';
@@ -84,8 +91,12 @@ async function createDatabaseHandle(fileBacked) {
     }
     catch (err) {
         if (directory) {
-            fs.rmSync(directory, { recursive: true, force: true });
-            abandonedDirectories.delete(directory);
+            try {
+                removeOwnedDirectory(directory);
+            }
+            catch (cleanup) {
+                throw Object.assign(new resource_1.TestDatabaseDisposeError('SQLite test allocation failed and owned cleanup failed', [err, cleanup]), { cause: err });
+            }
         }
         const message = err.message;
         if (message.includes('No SQLite driver available')) {
@@ -93,31 +104,34 @@ async function createDatabaseHandle(fileBacked) {
         }
         throw new TestSqliteError(`Failed to create SQLite test database: ${message}`);
     }
-    let disposed = false;
-    return {
+    const storage = fileBacked ? 'file' : 'memory';
+    const resourceId = (0, resource_1.mintResourceId)('sqlite');
+    const ownedDirectory = directory;
+    let disposal;
+    const handle = {
+        engine: 'sqlite',
+        resourceId,
+        storage,
         db,
         conn: db.conn,
         path: fileBacked ? filename : undefined,
         async query(sql, params = []) {
-            if (disposed)
+            if (disposal)
                 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);
+        dispose() {
+            if (!disposal) {
+                (0, resource_1.retireResource)(handle);
+                const steps = [() => db.close()];
+                if (ownedDirectory)
+                    steps.push(() => removeOwnedDirectory(ownedDirectory));
+                disposal = Promise.resolve().then(() => (0, resource_1.runCleanupSteps)(`Test SQLite database (${storage})`, steps));
             }
+            return disposal;
         },
     };
+    (0, resource_1.registerResource)(handle, { engine: 'sqlite', resourceId, storage });
+    return handle;
 }
 //# sourceMappingURL=database.js.map