@jskit-ai/database-runtime 0.1.131 → 0.1.132

package/package.descriptor.mjs

@@ -1,7 +1,7 @@
 export default Object.freeze({
   packageVersion: 1,
   packageId: "@jskit-ai/database-runtime",
-  version: "0.1.131",
+  version: "0.1.132",
   kind: "runtime",
   dependsOn: [
     "@jskit-ai/kernel"
@@ -70,7 +70,7 @@ export default Object.freeze({
   mutations: {
     dependencies: {
       runtime: {
-        "@jskit-ai/kernel": "0.1.132",
+        "@jskit-ai/kernel": "0.1.133",
         "dotenv": "^16.4.5",
         "knex": "^3.1.0"
       },
@@ -99,6 +99,13 @@ export default Object.freeze({
         reason: "Ensure migrations directory exists so Knex migration commands can run before any module installs migrations.",
         category: "database-runtime",
         id: "database-runtime-migrations-dir"
+      },
+      {
+        from: "templates/migrations/constraints/.gitkeep",
+        to: "migrations/constraints/.gitkeep",
+        reason: "Ensure the ordered deferred-constraint migration directory exists.",
+        category: "database-runtime",
+        id: "database-runtime-constraint-migrations-dir"
       }
     ]
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/database-runtime",
-  "version": "0.1.131",
+  "version": "0.1.132",
   "type": "module",
   "scripts": {
     "test": "node --test"
@@ -25,6 +25,6 @@
     "./shared/transactions": "./src/shared/transactions.js"
   },
   "dependencies": {
-    "@jskit-ai/kernel": "0.1.132"
+    "@jskit-ai/kernel": "0.1.133"
   }
 }

package/templates/knexfile.js

@@ -17,6 +17,7 @@ const dialectId = resolveDatabaseClientFromEnvironment(process.env);
 const client = toKnexClientId(dialectId);
 const defaultPort = dialectId === "pg" ? 5432 : 3306;
 const migrationsDirectory = path.resolve(appRoot, normalizeText(process.env.DB_MIGRATIONS_DIR) || "migrations");
+const deferredConstraintsDirectory = path.join(migrationsDirectory, "constraints");
 
 export default {
   client,
@@ -26,7 +27,10 @@ export default {
     context: "knex migrations"
   }),
   migrations: {
-    directory: migrationsDirectory,
-    extension: "cjs"
+    // Run every table-creation migration before deferred constraints. This keeps
+    // valid mutual foreign keys rebuildable without disabling database checks.
+    directory: [migrationsDirectory, deferredConstraintsDirectory],
+    extension: "cjs",
+    sortDirsSeparately: true
   }
 };

package/templates/migrations/constraints/.gitkeep

@@ -0,0 +1 @@
+

package/test/packageDescriptor.test.js

@@ -1,7 +1,12 @@
 import assert from "node:assert/strict";
+import { readFile } from "node:fs/promises";
+import path from "node:path";
 import test from "node:test";
+import { fileURLToPath } from "node:url";
 import descriptor from "../package.descriptor.mjs";
 
+const PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+
 test("database-runtime db migrate scripts sync JSKIT-managed migrations before Knex reads them", () => {
   const scripts = descriptor.mutations.packageJson.scripts;
 
@@ -27,3 +32,18 @@ test("database-runtime db migrate scripts sync JSKIT-managed migrations before K
     }
   ]);
 });
+
+test("database-runtime runs deferred constraints after all ordinary migrations", async () => {
+  const knexfile = await readFile(path.join(PACKAGE_ROOT, "templates/knexfile.js"), "utf8");
+  const deferredDirectoryMutation = descriptor.mutations.files.find(
+    (mutation) => mutation.id === "database-runtime-constraint-migrations-dir"
+  );
+
+  assert.match(
+    knexfile,
+    /directory:\s*\[migrationsDirectory,\s*deferredConstraintsDirectory\]/
+  );
+  assert.match(knexfile, /sortDirsSeparately:\s*true/);
+  assert.match(knexfile, /path\.join\(migrationsDirectory,\s*"constraints"\)/);
+  assert.equal(deferredDirectoryMutation?.to, "migrations/constraints/.gitkeep");
+});