@xemahq/biome-database-nest 1.1.0 → 3.0.0

package/dist/lib/session-timezone.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DatabaseSessionTimeZoneError = exports.DatabaseSessionPath = void 0;
 exports.assertDatabaseSessionUtc = assertDatabaseSessionUtc;
 exports.connectVerified = connectVerified;
-const platform_common_1 = require("@xemahq/platform-common");
+const database_url_1 = require("./database-url");
 var DatabaseSessionPath;
 (function (DatabaseSessionPath) {
     DatabaseSessionPath["AppPool"] = "app-pool";
@@ -12,7 +12,7 @@ var DatabaseSessionPath;
 })(DatabaseSessionPath || (exports.DatabaseSessionPath = DatabaseSessionPath = {}));
 const SHOW_TIME_ZONE_SQL = 'SHOW TimeZone';
 const ACCEPTED_ZONES = [
-    platform_common_1.BIOME_DB_SESSION_TIMEZONE.toLowerCase(),
+    database_url_1.BIOME_DB_SESSION_TIMEZONE.toLowerCase(),
     'etc/utc',
 ];
 class DatabaseSessionTimeZoneError extends Error {
@@ -58,7 +58,7 @@ async function assertDatabaseSessionUtc(probe, path) {
     const observed = await showTimeZone(probe);
     const text = typeof observed === 'string' ? observed : String(observed);
     if (!ACCEPTED_ZONES.includes(text.toLowerCase())) {
-        throw new DatabaseSessionTimeZoneError(platform_common_1.BIOME_DB_SESSION_TIMEZONE, text, path);
+        throw new DatabaseSessionTimeZoneError(database_url_1.BIOME_DB_SESSION_TIMEZONE, text, path);
     }
 }
 async function connectVerified(client, path) {

package/dist/lib/session-timezone.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-timezone.js","sourceRoot":"","sources":["../../src/lib/session-timezone.ts"],"names":[],"mappings":";;;AAyGA,4DAaC;AAYD,0CAWC;AA7ID,6DAAoE;AAMpE,IAAY,mBAOX;AAPD,WAAY,mBAAmB;IAE7B,2CAAoB,CAAA;IAEpB,8CAAuB,CAAA;IAEvB,+DAAwC,CAAA;AAC1C,CAAC,EAPW,mBAAmB,mCAAnB,mBAAmB,QAO9B;AAED,MAAM,kBAAkB,GAAG,eAAe,CAAC;AAE3C,MAAM,cAAc,GAAsB;IACxC,2CAAyB,CAAC,WAAW,EAAE;IACvC,SAAS;CACV,CAAC;AASF,MAAa,4BAA6B,SAAQ,KAAK;IAE1C;IACA;IACA;IAHX,YACW,QAAgB,EAChB,QAAgB,EAChB,cAAmC;QAE5C,KAAK,CACH,6BAA6B,cAAc,oBAAoB,QAAQ,IAAI;YACzE,iBAAiB,QAAQ,oCAAoC;YAC7D,kDAAkD;YAClD,0EAA0E;YAC1E,sDAAsD,CACzD,CAAC;QAVO,aAAQ,GAAR,QAAQ,CAAQ;QAChB,aAAQ,GAAR,QAAQ,CAAQ;QAChB,mBAAc,GAAd,cAAc,CAAqB;QAS5C,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,CAAC;CACF;AAfD,oEAeC;AA0BD,SAAS,aAAa,CACpB,KAA2B;IAE3B,OAAO,iBAAiB,IAAI,KAAK,CAAC;AACpC,CAAC;AAED,SAAS,oBAAoB,CAC3B,KAA2B;IAE3B,OAAO,UAAU,IAAI,KAAK,CAAC;AAC7B,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,KAA2B;IACrD,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,eAAe,CAAC,kBAAkB,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC;YAClC,GAAG,EAAE,kBAAkB;YACvB,IAAI,EAAE,EAAE;YACR,QAAQ,EAAE,EAAE;SACb,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACrD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC;AACtC,CAAC;AAQM,KAAK,UAAU,wBAAwB,CAC5C,KAA2B,EAC3B,IAAyB;IAEzB,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACxE,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,4BAA4B,CACpC,2CAAyB,EACzB,IAAI,EACJ,IAAI,CACL,CAAC;IACJ,CAAC;AACH,CAAC;AAYM,KAAK,UAAU,eAAe,CACnC,MAAgC,EAChC,IAAyB;IAEzB,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;IACvB,IAAI,CAAC;QACH,MAAM,wBAAwB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC;QACnB,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"session-timezone.js","sourceRoot":"","sources":["../../src/lib/session-timezone.ts"],"names":[],"mappings":";;;AAyGA,4DAaC;AAYD,0CAWC;AA7ID,iDAA2D;AAM3D,IAAY,mBAOX;AAPD,WAAY,mBAAmB;IAE7B,2CAAoB,CAAA;IAEpB,8CAAuB,CAAA;IAEvB,+DAAwC,CAAA;AAC1C,CAAC,EAPW,mBAAmB,mCAAnB,mBAAmB,QAO9B;AAED,MAAM,kBAAkB,GAAG,eAAe,CAAC;AAE3C,MAAM,cAAc,GAAsB;IACxC,wCAAyB,CAAC,WAAW,EAAE;IACvC,SAAS;CACV,CAAC;AASF,MAAa,4BAA6B,SAAQ,KAAK;IAE1C;IACA;IACA;IAHX,YACW,QAAgB,EAChB,QAAgB,EAChB,cAAmC;QAE5C,KAAK,CACH,6BAA6B,cAAc,oBAAoB,QAAQ,IAAI;YACzE,iBAAiB,QAAQ,oCAAoC;YAC7D,kDAAkD;YAClD,0EAA0E;YAC1E,sDAAsD,CACzD,CAAC;QAVO,aAAQ,GAAR,QAAQ,CAAQ;QAChB,aAAQ,GAAR,QAAQ,CAAQ;QAChB,mBAAc,GAAd,cAAc,CAAqB;QAS5C,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,CAAC;CACF;AAfD,oEAeC;AA0BD,SAAS,aAAa,CACpB,KAA2B;IAE3B,OAAO,iBAAiB,IAAI,KAAK,CAAC;AACpC,CAAC;AAED,SAAS,oBAAoB,CAC3B,KAA2B;IAE3B,OAAO,UAAU,IAAI,KAAK,CAAC;AAC7B,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,KAA2B;IACrD,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,eAAe,CAAC,kBAAkB,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC;YAClC,GAAG,EAAE,kBAAkB;YACvB,IAAI,EAAE,EAAE;YACR,QAAQ,EAAE,EAAE;SACb,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACrD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC;AACtC,CAAC;AAQM,KAAK,UAAU,wBAAwB,CAC5C,KAA2B,EAC3B,IAAyB;IAEzB,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACxE,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,4BAA4B,CACpC,wCAAyB,EACzB,IAAI,EACJ,IAAI,CACL,CAAC;IACJ,CAAC;AACH,CAAC;AAYM,KAAK,UAAU,eAAe,CACnC,MAAgC,EAChC,IAAyB;IAEzB,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;IACvB,IAAI,CAAC;QACH,MAAM,wBAAwB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC;QACnB,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/testing/index.d.ts

@@ -1,12 +1,3 @@
-import type { SdkOwnedMigrationSet } from '../lib/sdk-owned-migration-set';
-export interface TestMigrationTarget {
-    readonly serviceName: string;
-    readonly rootDir: string;
-    readonly url: string;
-    readonly schema: string;
-}
-export interface CreateTestMigratorOptions {
-    readonly sdkOwnedMigrations?: readonly SdkOwnedMigrationSet[];
-}
-export declare function createTestMigrator(options?: CreateTestMigratorOptions): (target: TestMigrationTarget) => Promise<void>;
+export { withPrefixMigrationDatabase } from './prefix-migration';
+export { createTestMigrator, type CreateTestMigratorOptions, type TestMigrationTarget, } from './test-migrator';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAM3E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,yBAAyB;IAExC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;CAC/D;AAWD,wBAAgB,kBAAkB,CAChC,OAAO,GAAE,yBAA8B,GACtC,CAAC,MAAM,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CA6BhD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EACL,kBAAkB,EAClB,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,GACzB,MAAM,iBAAiB,CAAC"}

package/dist/testing/index.js

@@ -1,36 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createTestMigrator = createTestMigrator;
-const node_fs_1 = require("node:fs");
-const node_path_1 = require("node:path");
-const biome_migrations_1 = require("../lib/biome-migrations");
-const operator_migration_1 = require("../lib/operator-migration");
-const SQL_IDENTIFIER = /^[a-z_][a-z0-9_]*$/iu;
-function createTestMigrator(options = {}) {
-    return async (target) => {
-        const schemaPath = (0, node_path_1.join)(target.rootDir, 'prisma', 'schema.prisma');
-        if (!(0, node_fs_1.existsSync)(schemaPath)) {
-            throw new Error(`${target.serviceName}: no Prisma schema at ${schemaPath}. Pass the service root as \`rootDir\` to provisionTestDatabase.`);
-        }
-        if (!SQL_IDENTIFIER.test(target.schema)) {
-            throw new Error(`${target.serviceName}: refusing scratch schema ${JSON.stringify(target.schema)}; it must match ${SQL_IDENTIFIER.source} before it is interpolated into CREATE SCHEMA.`);
-        }
-        const database = await (0, operator_migration_1.openOperatorMigrationClient)({
-            connectionString: target.url,
-        });
-        try {
-            await database.query(`CREATE SCHEMA IF NOT EXISTS "${target.schema}"`);
-            await (0, biome_migrations_1.runBiomeMigrations)({
-                database,
-                workspaceDir: target.rootDir,
-                connectionUrl: target.url,
-                label: target.serviceName,
-                sdkOwnedMigrations: options.sdkOwnedMigrations ?? [],
-            });
-        }
-        finally {
-            await database.end();
-        }
-    };
-}
+exports.createTestMigrator = exports.withPrefixMigrationDatabase = void 0;
+var prefix_migration_1 = require("./prefix-migration");
+Object.defineProperty(exports, "withPrefixMigrationDatabase", { enumerable: true, get: function () { return prefix_migration_1.withPrefixMigrationDatabase; } });
+var test_migrator_1 = require("./test-migrator");
+Object.defineProperty(exports, "createTestMigrator", { enumerable: true, get: function () { return test_migrator_1.createTestMigrator; } });
 //# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":";;AAmCA,gDA+BC;AAlED,qCAAqC;AACrC,yCAAiC;AAEjC,8DAA6D;AAC7D,kEAAwE;AAsBxE,MAAM,cAAc,GAAG,sBAAsB,CAAC;AAS9C,SAAgB,kBAAkB,CAChC,UAAqC,EAAE;IAEvC,OAAO,KAAK,EAAE,MAAM,EAAE,EAAE;QACtB,MAAM,UAAU,GAAG,IAAA,gBAAI,EAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC;QACnE,IAAI,CAAC,IAAA,oBAAU,EAAC,UAAU,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CACb,GAAG,MAAM,CAAC,WAAW,yBAAyB,UAAU,kEAAkE,CAC3H,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CACb,GAAG,MAAM,CAAC,WAAW,6BAA6B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,mBAAmB,cAAc,CAAC,MAAM,gDAAgD,CACxK,CAAC;QACJ,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,IAAA,gDAA2B,EAAC;YACjD,gBAAgB,EAAE,MAAM,CAAC,GAAG;SAC7B,CAAC,CAAC;QACH,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,KAAK,CAAC,gCAAgC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;YACvE,MAAM,IAAA,qCAAkB,EAAC;gBACvB,QAAQ;gBACR,YAAY,EAAE,MAAM,CAAC,OAAO;gBAC5B,aAAa,EAAE,MAAM,CAAC,GAAG;gBACzB,KAAK,EAAE,MAAM,CAAC,WAAW;gBACzB,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,IAAI,EAAE;aACrD,CAAC,CAAC;QACL,CAAC;gBAAS,CAAC;YACT,MAAM,QAAQ,CAAC,GAAG,EAAE,CAAC;QACvB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":";;;AAOA,uDAAiE;AAAxD,+HAAA,2BAA2B,OAAA;AACpC,iDAIyB;AAHvB,mHAAA,kBAAkB,OAAA"}

package/dist/testing/prefix-migration.d.ts

@@ -0,0 +1,3 @@
+import { type PrefixMigrationFixture } from '@xemahq/pg-test-harness/migration-prefix';
+export declare function withPrefixMigrationDatabase<T>(migrationsRoot: string, migrationName: string, label: string, body: (fixture: PrefixMigrationFixture) => Promise<T>): Promise<T>;
+//# sourceMappingURL=prefix-migration.d.ts.map

package/dist/testing/prefix-migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefix-migration.d.ts","sourceRoot":"","sources":["../../src/testing/prefix-migration.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,0CAA0C,CAAC;AAWlD,wBAAgB,2BAA2B,CAAC,CAAC,EAC3C,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,CAAC,OAAO,EAAE,sBAAsB,KAAK,OAAO,CAAC,CAAC,CAAC,GACpD,OAAO,CAAC,CAAC,CAAC,CAQZ"}

package/dist/testing/prefix-migration.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withPrefixMigrationDatabase = withPrefixMigrationDatabase;
+const migration_prefix_1 = require("@xemahq/pg-test-harness/migration-prefix");
+const operator_migration_ledger_1 = require("../lib/operator-migration-ledger");
+function withPrefixMigrationDatabase(migrationsRoot, migrationName, label, body) {
+    return (0, migration_prefix_1.withPrefixMigrationDatabase)(migrationsRoot, migrationName, label, body, { afterPrefix: operator_migration_ledger_1.ensureOperatorMigrationLedger });
+}
+//# sourceMappingURL=prefix-migration.js.map

package/dist/testing/prefix-migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefix-migration.js","sourceRoot":"","sources":["../../src/testing/prefix-migration.ts"],"names":[],"mappings":";;AAcA,kEAaC;AA3BD,+EAGkD;AAElD,gFAAiF;AASjF,SAAgB,2BAA2B,CACzC,cAAsB,EACtB,aAAqB,EACrB,KAAa,EACb,IAAqD;IAErD,OAAO,IAAA,8CAAkC,EACvC,cAAc,EACd,aAAa,EACb,KAAK,EACL,IAAI,EACJ,EAAE,WAAW,EAAE,yDAA6B,EAAE,CAC/C,CAAC;AACJ,CAAC"}

package/dist/testing/provision.d.ts

@@ -0,0 +1,7 @@
+import { type ProvisionTestDatabaseOptions as HarnessProvisionOptions } from '@xemahq/pg-test-harness';
+import type { SdkOwnedMigrationSet } from '../lib/sdk-owned-migration-set';
+export interface ProvisionBiomeTestDatabaseOptions extends Omit<HarnessProvisionOptions, 'migrate'> {
+    sdkOwnedMigrations?: readonly SdkOwnedMigrationSet[];
+}
+export declare function provisionTestDatabase(options: ProvisionBiomeTestDatabaseOptions): Promise<void>;
+//# sourceMappingURL=provision.d.ts.map

package/dist/testing/provision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provision.d.ts","sourceRoot":"","sources":["../../src/testing/provision.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,4BAA4B,IAAI,uBAAuB,EAC7D,MAAM,yBAAyB,CAAC;AAIjC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAE3E,MAAM,WAAW,iCACf,SAAQ,IAAI,CAAC,uBAAuB,EAAE,SAAS,CAAC;IAOhD,kBAAkB,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACtD;AAOD,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,iCAAiC,GACzC,OAAO,CAAC,IAAI,CAAC,CAMf"}

package/dist/testing/provision.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.provisionTestDatabase = provisionTestDatabase;
+const pg_test_harness_1 = require("@xemahq/pg-test-harness");
+const test_migrator_1 = require("./test-migrator");
+function provisionTestDatabase(options) {
+    const { sdkOwnedMigrations = [], ...harnessOptions } = options;
+    return (0, pg_test_harness_1.provisionTestDatabase)({
+        ...harnessOptions,
+        migrate: (0, test_migrator_1.createTestMigrator)({ sdkOwnedMigrations }),
+    });
+}
+//# sourceMappingURL=provision.js.map

package/dist/testing/provision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provision.js","sourceRoot":"","sources":["../../src/testing/provision.ts"],"names":[],"mappings":";;AAyBA,sDAQC;AAjCD,6DAGiC;AAEjC,mDAAqD;AAoBrD,SAAgB,qBAAqB,CACnC,OAA0C;IAE1C,MAAM,EAAE,kBAAkB,GAAG,EAAE,EAAE,GAAG,cAAc,EAAE,GAAG,OAAO,CAAC;IAC/D,OAAO,IAAA,uCAAwB,EAAC;QAC9B,GAAG,cAAc;QACjB,OAAO,EAAE,IAAA,kCAAkB,EAAC,EAAE,kBAAkB,EAAE,CAAC;KACpD,CAAC,CAAC;AACL,CAAC"}

package/dist/testing/test-migrator.d.ts

@@ -0,0 +1,12 @@
+import type { SdkOwnedMigrationSet } from '../lib/sdk-owned-migration-set';
+export interface TestMigrationTarget {
+    readonly serviceName: string;
+    readonly rootDir: string;
+    readonly url: string;
+    readonly schema: string;
+}
+export interface CreateTestMigratorOptions {
+    readonly sdkOwnedMigrations?: readonly SdkOwnedMigrationSet[];
+}
+export declare function createTestMigrator(options?: CreateTestMigratorOptions): (target: TestMigrationTarget) => Promise<void>;
+//# sourceMappingURL=test-migrator.d.ts.map

package/dist/testing/test-migrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-migrator.d.ts","sourceRoot":"","sources":["../../src/testing/test-migrator.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAM3E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,yBAAyB;IAExC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;CAC/D;AAWD,wBAAgB,kBAAkB,CAChC,OAAO,GAAE,yBAA8B,GACtC,CAAC,MAAM,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CA6BhD"}

package/dist/testing/test-migrator.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTestMigrator = createTestMigrator;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const biome_migrations_1 = require("../lib/biome-migrations");
+const operator_migration_1 = require("../lib/operator-migration");
+const SQL_IDENTIFIER = /^[a-z_][a-z0-9_]*$/iu;
+function createTestMigrator(options = {}) {
+    return async (target) => {
+        const schemaPath = (0, node_path_1.join)(target.rootDir, 'prisma', 'schema.prisma');
+        if (!(0, node_fs_1.existsSync)(schemaPath)) {
+            throw new Error(`${target.serviceName}: no Prisma schema at ${schemaPath}. Pass the service root as \`rootDir\` to provisionTestDatabase.`);
+        }
+        if (!SQL_IDENTIFIER.test(target.schema)) {
+            throw new Error(`${target.serviceName}: refusing scratch schema ${JSON.stringify(target.schema)}; it must match ${SQL_IDENTIFIER.source} before it is interpolated into CREATE SCHEMA.`);
+        }
+        const database = await (0, operator_migration_1.openOperatorMigrationClient)({
+            connectionString: target.url,
+        });
+        try {
+            await database.query(`CREATE SCHEMA IF NOT EXISTS "${target.schema}"`);
+            await (0, biome_migrations_1.runBiomeMigrations)({
+                database,
+                workspaceDir: target.rootDir,
+                connectionUrl: target.url,
+                label: target.serviceName,
+                sdkOwnedMigrations: options.sdkOwnedMigrations ?? [],
+            });
+        }
+        finally {
+            await database.end();
+        }
+    };
+}
+//# sourceMappingURL=test-migrator.js.map

package/dist/testing/test-migrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-migrator.js","sourceRoot":"","sources":["../../src/testing/test-migrator.ts"],"names":[],"mappings":";;AAmCA,gDA+BC;AAlED,qCAAqC;AACrC,yCAAiC;AAEjC,8DAA6D;AAC7D,kEAAwE;AAsBxE,MAAM,cAAc,GAAG,sBAAsB,CAAC;AAS9C,SAAgB,kBAAkB,CAChC,UAAqC,EAAE;IAEvC,OAAO,KAAK,EAAE,MAAM,EAAE,EAAE;QACtB,MAAM,UAAU,GAAG,IAAA,gBAAI,EAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC;QACnE,IAAI,CAAC,IAAA,oBAAU,EAAC,UAAU,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CACb,GAAG,MAAM,CAAC,WAAW,yBAAyB,UAAU,kEAAkE,CAC3H,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CACb,GAAG,MAAM,CAAC,WAAW,6BAA6B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,mBAAmB,cAAc,CAAC,MAAM,gDAAgD,CACxK,CAAC;QACJ,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,IAAA,gDAA2B,EAAC;YACjD,gBAAgB,EAAE,MAAM,CAAC,GAAG;SAC7B,CAAC,CAAC;QACH,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,KAAK,CAAC,gCAAgC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;YACvE,MAAM,IAAA,qCAAkB,EAAC;gBACvB,QAAQ;gBACR,YAAY,EAAE,MAAM,CAAC,OAAO;gBAC5B,aAAa,EAAE,MAAM,CAAC,GAAG;gBACzB,KAAK,EAAE,MAAM,CAAC,WAAW;gBACzB,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,IAAI,EAAE;aACrD,CAAC,CAAC;QACL,CAAC;gBAAS,CAAC;YACT,MAAM,QAAQ,CAAC,GAAG,EAAE,CAAC;QACvB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xemahq/biome-database-nest",
-  "version": "1.1.0",
+  "version": "3.0.0",
   "description": "Explicit database migration ownership, least-privilege runtime verification, and schema-qualified Prisma wiring for Xema biome services.",
   "license": "Apache-2.0",
   "author": "Neuralchowder Inc. <developer@xema.dev> (https://xema.dev)",
@@ -18,7 +18,10 @@
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
-    "dist"
+    "dist",
+    "prisma-url.js",
+    "prisma-url.d.ts",
+    "xema-peer-facts.json"
   ],
   "devDependencies": {
     "@nestjs/common": "11.1.18",
@@ -30,18 +33,19 @@
     "@types/node": "25.2.3",
     "@types/pg": "^8.16.0",
     "@xemahq/identity-client": "^0.15.5",
-    "@xemahq/contracts": "^0.79.0",
-    "@xemahq/pg-test-harness": "^0.3.1",
-    "@xemahq/platform-common": ">=0.77.0",
+    "@xemahq/contracts": "^0.83.0",
+    "@xemahq/pg-test-harness": "^0.5.0",
+    "@xemahq/platform-common": ">=0.83.0",
     "eslint": "^9.39.4",
     "jest": "^30.3.0",
     "prettier": "3.6.2",
     "prisma": "7.8.0",
     "ts-jest": "^29.4.9",
     "typescript": "5.9.3",
-    "@xemahq/eslint-config": "0.14.0",
-    "@xemahq/xema-decorators": "1.0.1",
-    "@xemahq/service-registry-nest": "1.1.0"
+    "@xemahq/eslint-config": "0.14.1",
+    "@xemahq/service-registry-nest": "1.1.0",
+    "@xemahq/peer-analysis": "0.2.0",
+    "@xemahq/xema-decorators": "2.0.0"
   },
   "peerDependencies": {
     "@nestjs/common": "^10 || ^11",
@@ -49,13 +53,19 @@
     "@prisma/adapter-pg": "^7",
     "@prisma/client": "^7",
     "@xemahq/identity-client": ">=0.9.0",
-    "@xemahq/contracts": ">=0.4.0",
+    "@xemahq/contracts": ">=0.82.0",
     "@xemahq/service-registry-nest": ">=0.12.0",
-    "@xemahq/platform-common": ">=0.18.0"
+    "@xemahq/platform-common": ">=0.47.0",
+    "@xemahq/pg-test-harness": ">=0.5.0"
+  },
+  "peerDependenciesMeta": {
+    "@xemahq/pg-test-harness": {
+      "optional": true
+    }
   },
   "dependencies": {
     "@xemahq/migration-runner-prisma": "^0.3.1",
-    "@xemahq/org-erasure-nest": "^2.0.1",
+    "@xemahq/org-erasure-nest": "^3.1.0",
     "pg": "^8.16.3"
   },
   "exports": {
@@ -69,20 +79,32 @@
       "xema-source": "./src/testing/index.ts",
       "default": "./dist/testing/index.js"
     },
+    "./testing/provision": {
+      "types": "./dist/testing/provision.d.ts",
+      "xema-source": "./src/testing/provision.ts",
+      "default": "./dist/testing/provision.js"
+    },
+    "./prisma-url": {
+      "types": "./prisma-url.d.ts",
+      "default": "./prisma-url.js"
+    },
     "./dist/lib/*": {
       "types": "./dist/lib/*.d.ts",
       "default": "./dist/lib/*.js"
     }
   },
+  "xema": {
+    "peerFacts": "./xema-peer-facts.json"
+  },
   "scripts": {
-    "clean": "rm -rf dist",
-    "build": "tsc -p tsconfig.build.json",
+    "clean": "rm -rf dist xema-peer-facts.json",
+    "build": "tsc -p tsconfig.build.json && xema-peer-facts",
     "format": "prettier --write \"src/**/*.ts\"",
     "lint": "eslint .",
-    "test": "jest",
+    "test": "jest --config jest.config.ts && jest --config jest.pg.config.ts",
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "xemaRelease": {
-    "sourceDigest": "sha256:6a5dd5acb427f3601ffafd9f7f634024b4504d3968dd6508b0b4794998130f71"
+    "sourceDigest": "sha256:bc1989f3082e141397022ab33df72b9c5ce1eae637eb126ddce463f74aa42366"
   }
 }

package/prisma-url.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Types for the build-free database-URL composition in `./prisma-url.js`.
+ *
+ * Hand-written rather than emitted, because the module it describes is
+ * committed rather than built — see that file's header for why it must be
+ * resolvable with no `dist/` present.
+ */
+
+/** Discrete connection parts, mirroring the standard `DB_*` env contract. */
+export interface BiomeDatabaseUrlParts {
+  readonly user?: string | undefined;
+  readonly password?: string | undefined;
+  readonly host?: string | undefined;
+  readonly port?: string | undefined;
+  readonly database?: string | undefined;
+  /** Per-biome schema for the shared `xema_biomes` DB; omit for dedicated DBs. */
+  readonly schema?: string | undefined;
+  /** Pre-formed SSL query params (e.g. `sslmode=require&sslrootcert=...`). */
+  readonly sslParams?: string | undefined;
+}
+
+/**
+ * Compose a Postgres connection URL from discrete parts, adding `?schema=` when
+ * a per-biome schema is supplied. Returns `null` when any required part is
+ * missing — the caller decides whether that is fatal (it is at runtime; it is
+ * not for `prisma generate`, which never reads the URL).
+ */
+export declare function composeBiomeDatabaseUrl(
+  parts: BiomeDatabaseUrlParts,
+): string | null;
+
+/**
+ * Convenience over {@link composeBiomeDatabaseUrl} reading the standard `DB_*`
+ * env contract. Pass a custom bag for tests; defaults to `process.env`.
+ */
+export declare function composeBiomeDatabaseUrlFromEnv(
+  env?: NodeJS.ProcessEnv,
+): string | null;

package/prisma-url.js

@@ -0,0 +1,84 @@
+'use strict';
+
+/**
+ * THE database-URL composition — and the ONE copy of it in this package.
+ *
+ * This file is plain CommonJS, committed rather than built, and it imports
+ * NOTHING. Every one of those three properties is load-bearing, and none of
+ * them is a style choice:
+ *
+ *   - **Committed, not built.** A `prisma.config.ts` is loaded by the Prisma
+ *     CLI during `postinstall` (`prisma generate`), i.e. BEFORE anything has
+ *     been compiled. In the aggregator `pnpm.overrides` forces this package to
+ *     `workspace:*`, so a consumer resolves a LINK to this source tree — where
+ *     `dist/` is gitignored and does not exist yet. An entry that resolves
+ *     into `dist/` therefore cannot be imported from a `prisma.config.ts` at
+ *     all: measured on prisma 7.8.0, the CLI fails at CONFIG LOAD with
+ *     `Failed to load config file ... Cannot find module .../dist/index.js`,
+ *     which would break `pnpm install` for every service at once.
+ *   - **Zero dependencies.** The same postinstall moment has no built
+ *     first-party graph either. Reaching this file through the package's
+ *     `xema-source` condition (`src/index.ts`) fails for exactly that reason —
+ *     it cascades into `@xemahq/contracts/idempotency` and every other
+ *     first-party import, each of which needs its own `dist`.
+ *   - **CommonJS.** The package declares no `"type"`, so `.js` here is CJS and
+ *     `require()`-able by the CLI's config loader without a transpile step.
+ *
+ * `src/lib/database-url.ts` RE-EXPORTS these functions rather than
+ * restating them, so the TypeScript surface every service's `main.ts` already
+ * imports and the build-free surface a `prisma.config.ts` imports are the same
+ * code. Do not add a second implementation on the TypeScript side: the whole
+ * reason this file exists is that 45 services hand-rolled this composition
+ * (29 of them in one repository, at 29 DISTINCT sha256), and a 46th copy
+ * shipped as the fix would be the defect wearing a fix's costume.
+ *
+ * What this file deliberately does NOT do: read `DATABASE_URL`, and throw.
+ * Both belong at the CALL SITE. A caller decides whether a pre-composed
+ * `DATABASE_URL` outranks the discrete parts, and a caller names ITSELF in the
+ * error — `null` here means "the parts are not all present", which is fatal at
+ * runtime and is NOT fatal for `prisma generate`, which never reads the URL.
+ * Deciding either of those here would take the choice away from the one place
+ * that can make it correctly.
+ */
+
+/**
+ * Compose a Postgres connection URL from discrete parts, adding `?schema=`
+ * when a per-biome schema is supplied. Returns `null` when any required part
+ * is missing.
+ *
+ * @param {import('./prisma-url').BiomeDatabaseUrlParts} parts
+ * @returns {string | null}
+ */
+function composeBiomeDatabaseUrl(parts) {
+  const { user, password, host, port, database, schema, sslParams } = parts;
+  if (!user || !password || !host || !port || !database) {
+    return null;
+  }
+  const base = `postgresql://${user}:${encodeURIComponent(
+    password,
+  )}@${host}:${port}/${database}`;
+  const schemaPart = schema ? `schema=${schema}` : null;
+  const query = [schemaPart, sslParams].filter(Boolean).join('&');
+  return query ? `${base}?${query}` : base;
+}
+
+/**
+ * Convenience over {@link composeBiomeDatabaseUrl} reading the standard `DB_*`
+ * env contract. Pass a custom bag for tests; defaults to `process.env`.
+ *
+ * @param {NodeJS.ProcessEnv} [env]
+ * @returns {string | null}
+ */
+function composeBiomeDatabaseUrlFromEnv(env = process.env) {
+  return composeBiomeDatabaseUrl({
+    user: env.DB_USER,
+    password: env.DB_PASSWORD,
+    host: env.DB_HOST,
+    port: env.DB_PORT,
+    database: env.DB_NAME,
+    schema: env.DB_SCHEMA,
+    sslParams: env.DB_SSL_PARAMS,
+  });
+}
+
+module.exports = { composeBiomeDatabaseUrl, composeBiomeDatabaseUrlFromEnv };