arkormx 2.11.1 → 2.11.2

package/dist/{relationship-IC-TAFyG.cjs → relationship-CQbj9Ahg.cjs}

@@ -1036,6 +1036,49 @@ const getLatestAppliedMigrations = (state, steps) => {
 		return right.index - left.index;
 	}).slice(0, Math.max(0, steps)).map((entry) => entry.migration);
 };
+/**
+* Groups the applied migrations into batches, oldest batch first, each batch
+* holding its migration ids in application order.
+*
+* A "batch" is one `migrate` run. When no runs were recorded (e.g. legacy state
+* written before run tracking), each applied migration is treated as its own
+* batch so `--step` still behaves predictably.
+*
+* @param state
+* @returns
+*/
+const resolveAppliedBatches = (state) => {
+	const runs = state.runs ?? [];
+	if (runs.length > 0) return runs.map((run, index) => ({
+		run,
+		index
+	})).sort((left, right) => {
+		const appliedAtOrder = left.run.appliedAt.localeCompare(right.run.appliedAt);
+		if (appliedAtOrder !== 0) return appliedAtOrder;
+		return left.index - right.index;
+	}).map((entry) => entry.run.migrationIds);
+	return state.migrations.map((migration) => [migration.id]);
+};
+/**
+* Resolves the migrations belonging to the most recent `batches` batches, ordered
+* for rollback — **reverse of the order they were applied** (most recent batch
+* first, and within each batch the migration that ran `up()` last runs `down()`
+* first), so a rollback exactly reverses how the migrations were applied.
+*
+* Defaults to a single batch (`migrate:rollback` with no `--step`); `--step=N`
+* rolls back the last N batches.
+*
+* @param state
+* @param batches
+* @returns
+*/
+const getLastBatchMigrations = (state, batches = 1) => {
+	if (batches < 1) return [];
+	const allBatches = resolveAppliedBatches(state);
+	const selected = allBatches.slice(Math.max(0, allBatches.length - batches));
+	const byId = new Map(state.migrations.map((migration) => [migration.id, migration]));
+	return selected.reverse().flatMap((migrationIds) => [...migrationIds].reverse()).map((id) => byId.get(id)).filter((migration) => Boolean(migration));
+};
 
 //#endregion
 //#region src/database/ForeignKeyBuilder.ts
@@ -4092,6 +4135,29 @@ const getRuntimeAdapter = () => {
 	if (!runtimeConfigLoaded) loadRuntimeConfigSync();
 	return runtimeAdapter;
 };
+/**
+* Releases the database resources held by the configured runtime — the adapter's
+* connection pool and/or the configured client. Intended for short-lived
+* processes (the CLI) so the Node event loop drains and the process exits
+* promptly instead of hanging on pool idle timeouts. Teardown failures are
+* swallowed because the process is shutting down anyway.
+*/
+const disposeArkormRuntime = async () => {
+	let adapterDisposed = false;
+	try {
+		if (runtimeAdapter && typeof runtimeAdapter.dispose === "function") {
+			await runtimeAdapter.dispose();
+			adapterDisposed = true;
+		}
+	} catch {}
+	const client = getRuntimeClient();
+	if (!client) return;
+	try {
+		if (typeof client.$disconnect === "function") await client.$disconnect();
+		else if (!adapterDisposed && typeof client.destroy === "function") await client.destroy();
+		else if (!adapterDisposed && typeof client.end === "function") await client.end();
+	} catch {}
+};
 const getActiveTransactionClient = () => {
 	return transactionClientStorage.getStore();
 };
@@ -6922,6 +6988,12 @@ Object.defineProperty(exports, 'deriveSingularFieldName', {
     return deriveSingularFieldName;
   }
 });
+Object.defineProperty(exports, 'disposeArkormRuntime', {
+  enumerable: true,
+  get: function () {
+    return disposeArkormRuntime;
+  }
+});
 Object.defineProperty(exports, 'emitRuntimeDebugEvent', {
   enumerable: true,
   get: function () {
@@ -7018,6 +7090,12 @@ Object.defineProperty(exports, 'getDefaultStubsPath', {
     return getDefaultStubsPath;
   }
 });
+Object.defineProperty(exports, 'getLastBatchMigrations', {
+  enumerable: true,
+  get: function () {
+    return getLastBatchMigrations;
+  }
+});
 Object.defineProperty(exports, 'getLastMigrationRun', {
   enumerable: true,
   get: function () {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkormx",
-  "version": "2.11.1",
+  "version": "2.11.2",
   "description": "Modern TypeScript-first ORM for Node.js.",
   "keywords": [
     "orm",
@@ -82,7 +82,7 @@
   },
   "dependencies": {
     "@h3ravel/collect.js": "^5.4.0",
-    "@h3ravel/musket": "^2.2.1",
+    "@h3ravel/musket": "^2.2.2",
     "@h3ravel/shared": "^2.2.1",
     "@h3ravel/support": "^2.2.1",
     "dotenv": "^17.3.1",