arkormx 2.11.0 → 2.11.2

package/dist/{relationship-CP1xbMOa.mjs → relationship-4S2yHPIH.mjs}

@@ -1008,6 +1008,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
@@ -4064,6 +4107,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();
 };
@@ -6444,4 +6510,4 @@ var MorphToRelation = class extends Relation {
 };
 
 //#endregion
-export { applyOperationsToPersistedColumnMappingsState as $, SetBasedEagerLoader as $n, resolvePrismaType as $t, getRuntimePrismaClient as A, where as An, buildInverseRelationLine as At, getRegisteredModels as B, getLatestAppliedMigrations as Bn, deriveRelationFieldName as Bt, getActiveTransactionClient as C, fromExpressionNode as Cn, applyMigrationRollbackToPrismaSchema as Ct, getRuntimeDebugHandler as D, raw as Dn, buildEnumBlock as Dt, getRuntimeClient as E, min as En, applyOperationsToPrismaSchema as Et, loadArkormConfig as F, computeMigrationChecksum as Fn, buildUniqueConstraintLine as Ft, loadModelsFrom as G, readAppliedMigrationsStateFromStore as Gn, formatDefaultValue as Gt, getRegisteredSeeders as H, markMigrationApplied as Hn, escapeRegex as Ht, resetArkormRuntimeForTests as I, createEmptyAppliedMigrationsState as In, createMigrationTimestamp as It, registerMigrations as J, supportsDatabaseMigrationState as Jn, generateMigrationFile as Jt, loadSeedersFrom as K, removeAppliedMigration as Kn, formatEnumDefaultValue as Kt, runArkormTransaction as L, deleteAppliedMigrationsStateFromStore as Ln, deriveCollectionFieldName as Lt, isDelegateLike as M, ForeignKeyBuilder as Mn, buildModelBlock as Mt, isQuerySchemaLike as N, buildMigrationIdentity as Nn, buildPrimaryKeyLine as Nt, getRuntimePaginationCurrentPageResolver as O, sum as On, buildFieldLine as Ot, isTransactionCapableClient as P, buildMigrationRunId as Pn, buildRelationLine as Pt, resetRuntimeRegistryForTests as Q, UnsupportedAdapterFeatureException as Qn, resolveMigrationClassName as Qt, getRegisteredFactories as R, findAppliedMigration as Rn, deriveInverseRelationAlias as Rt, getActiveTransactionAdapter as S, fn as Sn, applyMigrationRollbackToDatabase as St, getRuntimeAdapter as T, max as Tn, applyMigrationToPrismaSchema as Tt, loadFactoriesFrom as U, markMigrationRun as Un, findEnumBlock as Ut, getRegisteredPaths as V, isMigrationApplied as Vn, deriveSingularFieldName as Vt, loadMigrationsFrom as W, readAppliedMigrationsState as Wn, findModelBlock as Wt, registerPaths as X, writeAppliedMigrationsStateToStore as Xn, pad as Xt, registerModels as Y, writeAppliedMigrationsState as Yn, getMigrationPlan as Yt, registerSeeders as Z, RuntimeModuleLoader as Zn, resolveEnumName as Zt, bindAdapterToModels as _, caseWhen as _n, PRISMA_ENUM_REGEX as _t, HasOneThroughRelation as a, supportsDatabaseReset as an, getPersistedPrimaryKeyGeneration as at, emitRuntimeDebugEvent as b, count as bn, applyCreateTableOperation as bt, HasManyRelation as c, SchemaBuilder as cn, readPersistedColumnMappingsState as ct, BelongsToManyRelation as d, resolveGeneratedExpression as dn, resolveColumnMappingsFilePath as dt, runMigrationWithPrisma as en, RelationTableLoader as er, createEmptyPersistedColumnMappingsState as et, Relation as f, AggregateExpression as fn, resolvePersistedMetadataFeatures as ft, awaitConfiguredModelsRegistration as g, avg as gn, PRISMA_ENUM_MEMBER_REGEX as gt, URLDriver as h, JsonExpression as hn, writePersistedColumnMappingsState as ht, MorphManyRelation as i, supportsDatabaseMigrationExecution as in, getPersistedEnumTsType as it, getUserConfig as j, PrimaryKeyGenerationPlanner as jn, buildMigrationSource as jt, getRuntimePaginationURLDriverFactory as k, val as kn, buildIndexLine as kt, BelongsToRelation as l, EnumBuilder as ln, rebuildPersistedColumnMappingsState as lt, Paginator as m, Expression as mn, validatePersistedMetadataFeaturesForMigrations as mt, MorphToManyRelation as n, stripPrismaSchemaModelsAndEnums as nn, ArkormCollection as nr, getPersistedColumnMap as nt, HasOneRelation as o, toMigrationFileSlug as on, getPersistedTableMetadata as ot, LengthAwarePaginator as p, CaseExpression as pn, syncPersistedColumnMappingsFromState as pt, registerFactories as q, resolveMigrationStateFilePath as qn, formatRelationAction as qt, MorphOneRelation as r, supportsDatabaseCreation as rn, ArkormException as rr, getPersistedEnumMap as rt, HasManyThroughRelation as s, toModelName as sn, getPersistedTimestampColumns as st, MorphToRelation as t, runPrismaCommand as tn, RelationResolutionException as tr, deletePersistedColumnMappingsState as tt, SingleResultRelation as u, TableBuilder as un, resetPersistedColumnMappingsCache as ut, configureArkormRuntime as v, coalesce as vn, PRISMA_MODEL_REGEX as vt, getDefaultStubsPath as w, json as wn, applyMigrationToDatabase as wt, ensureArkormConfigLoading as x, expressionBuilder as xn, applyDropTableOperation as xt, defineConfig as y, col as yn, applyAlterTableOperation as yt, getRegisteredMigrations as z, getLastMigrationRun as zn, deriveRelationAlias as zt };
+export { resetRuntimeRegistryForTests as $, RuntimeModuleLoader as $n, resolveMigrationClassName as $t, getRuntimePaginationURLDriverFactory as A, val as An, buildIndexLine as At, getRegisteredMigrations as B, getLastBatchMigrations as Bn, deriveRelationAlias as Bt, getActiveTransactionAdapter as C, fn as Cn, applyMigrationRollbackToDatabase as Ct, getRuntimeClient as D, min as Dn, applyOperationsToPrismaSchema as Dt, getRuntimeAdapter as E, max as En, applyMigrationToPrismaSchema as Et, isTransactionCapableClient as F, buildMigrationRunId as Fn, buildRelationLine as Ft, loadMigrationsFrom as G, markMigrationRun as Gn, findModelBlock as Gt, getRegisteredPaths as H, getLatestAppliedMigrations as Hn, deriveSingularFieldName as Ht, loadArkormConfig as I, computeMigrationChecksum as In, buildUniqueConstraintLine as It, registerFactories as J, removeAppliedMigration as Jn, formatRelationAction as Jt, loadModelsFrom as K, readAppliedMigrationsState as Kn, formatDefaultValue as Kt, resetArkormRuntimeForTests as L, createEmptyAppliedMigrationsState as Ln, createMigrationTimestamp as Lt, getUserConfig as M, PrimaryKeyGenerationPlanner as Mn, buildMigrationSource as Mt, isDelegateLike as N, ForeignKeyBuilder as Nn, buildModelBlock as Nt, getRuntimeDebugHandler as O, raw as On, buildEnumBlock as Ot, isQuerySchemaLike as P, buildMigrationIdentity as Pn, buildPrimaryKeyLine as Pt, registerSeeders as Q, writeAppliedMigrationsStateToStore as Qn, resolveEnumName as Qt, runArkormTransaction as R, deleteAppliedMigrationsStateFromStore as Rn, deriveCollectionFieldName as Rt, ensureArkormConfigLoading as S, expressionBuilder as Sn, applyDropTableOperation as St, getDefaultStubsPath as T, json as Tn, applyMigrationToDatabase as Tt, getRegisteredSeeders as U, isMigrationApplied as Un, escapeRegex as Ut, getRegisteredModels as V, getLastMigrationRun as Vn, deriveRelationFieldName as Vt, loadFactoriesFrom as W, markMigrationApplied as Wn, findEnumBlock as Wt, registerModels as X, supportsDatabaseMigrationState as Xn, getMigrationPlan as Xt, registerMigrations as Y, resolveMigrationStateFilePath as Yn, generateMigrationFile as Yt, registerPaths as Z, writeAppliedMigrationsState as Zn, pad as Zt, bindAdapterToModels as _, avg as _n, PRISMA_ENUM_MEMBER_REGEX as _t, HasOneThroughRelation as a, supportsDatabaseMigrationExecution as an, ArkormException as ar, getPersistedEnumTsType as at, disposeArkormRuntime as b, col as bn, applyAlterTableOperation as bt, HasManyRelation as c, toModelName as cn, getPersistedTimestampColumns as ct, BelongsToManyRelation as d, TableBuilder as dn, resetPersistedColumnMappingsCache as dt, resolvePrismaType as en, UnsupportedAdapterFeatureException as er, applyOperationsToPersistedColumnMappingsState as et, Relation as f, resolveGeneratedExpression as fn, resolveColumnMappingsFilePath as ft, awaitConfiguredModelsRegistration as g, JsonExpression as gn, writePersistedColumnMappingsState as gt, URLDriver as h, Expression as hn, validatePersistedMetadataFeaturesForMigrations as ht, MorphManyRelation as i, supportsDatabaseCreation as in, ArkormCollection as ir, getPersistedEnumMap as it, getRuntimePrismaClient as j, where as jn, buildInverseRelationLine as jt, getRuntimePaginationCurrentPageResolver as k, sum as kn, buildFieldLine as kt, BelongsToRelation as l, SchemaBuilder as ln, readPersistedColumnMappingsState as lt, Paginator as m, CaseExpression as mn, syncPersistedColumnMappingsFromState as mt, MorphToManyRelation as n, runPrismaCommand as nn, RelationTableLoader as nr, deletePersistedColumnMappingsState as nt, HasOneRelation as o, supportsDatabaseReset as on, getPersistedPrimaryKeyGeneration as ot, LengthAwarePaginator as p, AggregateExpression as pn, resolvePersistedMetadataFeatures as pt, loadSeedersFrom as q, readAppliedMigrationsStateFromStore as qn, formatEnumDefaultValue as qt, MorphOneRelation as r, stripPrismaSchemaModelsAndEnums as rn, RelationResolutionException as rr, getPersistedColumnMap as rt, HasManyThroughRelation as s, toMigrationFileSlug as sn, getPersistedTableMetadata as st, MorphToRelation as t, runMigrationWithPrisma as tn, SetBasedEagerLoader as tr, createEmptyPersistedColumnMappingsState as tt, SingleResultRelation as u, EnumBuilder as un, rebuildPersistedColumnMappingsState as ut, configureArkormRuntime as v, caseWhen as vn, PRISMA_ENUM_REGEX as vt, getActiveTransactionClient as w, fromExpressionNode as wn, applyMigrationRollbackToPrismaSchema as wt, emitRuntimeDebugEvent as x, count as xn, applyCreateTableOperation as xt, defineConfig as y, coalesce as yn, PRISMA_MODEL_REGEX as yt, getRegisteredFactories as z, findAppliedMigration as zn, deriveInverseRelationAlias as zt };

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.0",
+  "version": "2.11.2",
   "description": "Modern TypeScript-first ORM for Node.js.",
   "keywords": [
     "orm",
@@ -81,10 +81,10 @@
     "node": ">=20.0.0"
   },
   "dependencies": {
-    "@h3ravel/collect.js": "^5.3.7",
-    "@h3ravel/musket": "^2.0.0",
-    "@h3ravel/shared": "^2.1.4",
-    "@h3ravel/support": "^2.1.4",
+    "@h3ravel/collect.js": "^5.4.0",
+    "@h3ravel/musket": "^2.2.2",
+    "@h3ravel/shared": "^2.2.1",
+    "@h3ravel/support": "^2.2.1",
     "dotenv": "^17.3.1",
     "jiti": "^2.7.0",
     "kysely": "^0.28.15",