arkormx 2.11.3 → 2.11.5

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

@@ -9,6 +9,7 @@ import { fileURLToPath } from "url";
 import path from "path";
 import { existsSync as existsSync$1, mkdirSync as mkdirSync$1, readFileSync as readFileSync$1, rmSync as rmSync$1, writeFileSync as writeFileSync$1 } from "node:fs";
 import { createHash, randomUUID } from "node:crypto";
+import { AsyncLocalStorage as AsyncLocalStorage$1 } from "node:async_hooks";
 import { spawnSync } from "node:child_process";
 import { str } from "@h3ravel/support";
 
@@ -2467,6 +2468,34 @@ var SchemaBuilder = class SchemaBuilder {
 	}
 };
 
+//#endregion
+//#region src/helpers/migration-planning.ts
+/**
+* Tracks whether a migration body is currently being invoked purely to collect
+* its schema plan (rather than to actually apply it).
+*
+* A migration's `up()`/`down()` is executed both to gather its {@link SchemaOperation}s
+* and, when it uses helpers like `DB.raw()`, as real database side effects. Some
+* flows (column-mapping sync, feature validation) re-invoke `up()` on already
+* applied migrations solely to rebuild metadata — they must NOT re-run those side
+* effects, or a rollback would replay every still-applied migration's raw SQL
+* against a schema it was never meant to touch again.
+*
+* While this context is active, direct data-affecting `DB` calls become no-ops.
+* Actual apply/rollback runs outside it, so side effects happen normally.
+*/
+const STORAGE_KEY = Symbol.for("arkorm.migrationPlanningStorage");
+const globalScope = globalThis;
+const migrationPlanningStorage = globalScope[STORAGE_KEY] ?? (globalScope[STORAGE_KEY] = new AsyncLocalStorage$1());
+/** Runs `fn` in a side-effect-free migration-planning context. */
+const runInMigrationPlanning = async (fn) => {
+	return await migrationPlanningStorage.run(true, async () => await fn());
+};
+/** True when a migration body is being invoked only to collect its schema plan. */
+const isMigrationPlanningActive = () => {
+	return migrationPlanningStorage.getStore() === true;
+};
+
 //#endregion
 //#region src/helpers/migrations.ts
 const PRISMA_MODEL_REGEX = /model\s+(\w+)\s*\{[\s\S]*?\n\}/g;
@@ -3151,11 +3180,15 @@ const generateMigrationFile = (name, options = {}) => {
 * @param direction The direction of the migration to plan for ('up' or 'down').
 * @returns         A promise that resolves to an array of schema operations that would be performed.
 */
-const getMigrationPlan = async (migration, direction = "up") => {
+const getMigrationPlan = async (migration, direction = "up", options = {}) => {
 	const instance = typeof migration === "function" ? new migration() : migration;
 	const schema = new SchemaBuilder();
-	if (direction === "up") await instance.up(schema);
-	else await instance.down(schema);
+	const invoke = async () => {
+		if (direction === "up") await instance.up(schema);
+		else await instance.down(schema);
+	};
+	if (options.inert) await runInMigrationPlanning(invoke);
+	else await invoke();
 	return schema.getOperations();
 };
 const supportsDatabaseMigrationExecution = (adapter) => {
@@ -3563,7 +3596,7 @@ const rebuildPersistedColumnMappingsState = async (state, availableMigrations, f
 				className: migration.className
 			}
 		});
-		const operations = await getMigrationPlan(migrationClass, "up");
+		const operations = await getMigrationPlan(migrationClass, "up", { inert: true });
 		nextState = applyOperationsToPersistedColumnMappingsState(nextState, operations, features);
 	}
 	return nextState;
@@ -3580,7 +3613,7 @@ const syncPersistedColumnMappingsFromState = async (cwd, state, availableMigrati
 const validatePersistedMetadataFeaturesForMigrations = async (migrations, features = resolvePersistedMetadataFeatures()) => {
 	let nextState = createEmptyPersistedColumnMappingsState();
 	for (const [migrationClass] of migrations) {
-		const operations = await getMigrationPlan(migrationClass, "up");
+		const operations = await getMigrationPlan(migrationClass, "up", { inert: true });
 		nextState = applyOperationsToPersistedColumnMappingsState(nextState, operations, features);
 	}
 };
@@ -5387,6 +5420,7 @@ var BelongsToManyRelation = class BelongsToManyRelation extends Relation {
 		this.pivotColumns = /* @__PURE__ */ new Set();
 		this.pivotAccessor = "pivot";
 		this.shouldAttachPivot = false;
+		this.pivotValues = /* @__PURE__ */ new Map();
 	}
 	/**
 	* Specifies additional pivot columns to include on the related models.
@@ -5430,6 +5464,22 @@ var BelongsToManyRelation = class BelongsToManyRelation extends Relation {
 		this.shouldAttachPivot = true;
 		return this;
 	}
+	withPivotValue(column, value) {
+		if (typeof column === "object" && column !== null) {
+			Object.entries(column).forEach(([name, columnValue]) => {
+				this.applyPivotValue(name, columnValue);
+			});
+			return this;
+		}
+		return this.applyPivotValue(column, value);
+	}
+	applyPivotValue(column, value) {
+		const normalized = column.trim();
+		if (normalized.length === 0) return this;
+		this.wherePivot(normalized, value);
+		this.pivotValues.set(normalized, value);
+		return this;
+	}
 	/**
 	* Specifies a custom pivot model to use for the pivot records. The pivot model can
 	* be used to define custom behavior or methods on the pivot records, as well as to
@@ -5621,6 +5671,7 @@ var BelongsToManyRelation = class BelongsToManyRelation extends Relation {
 	}
 	buildPivotInsertValues(related, attributes = {}) {
 		const values = {
+			...Object.fromEntries(this.pivotValues),
 			...attributes,
 			[this.foreignPivotKey]: this.resolveParentPivotValue(),
 			[this.relatedPivotKey]: this.resolveRelatedPivotValue(related)
@@ -6510,4 +6561,4 @@ var MorphToRelation = class extends Relation {
 };
 
 //#endregion
-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 };
+export { resetRuntimeRegistryForTests as $, writeAppliedMigrationsState as $n, resolveMigrationClassName as $t, getRuntimePaginationURLDriverFactory as A, raw as An, buildIndexLine as At, getRegisteredMigrations as B, deleteAppliedMigrationsStateFromStore as Bn, deriveRelationAlias as Bt, getActiveTransactionAdapter as C, count as Cn, applyMigrationRollbackToDatabase as Ct, getRuntimeClient as D, json as Dn, applyOperationsToPrismaSchema as Dt, getRuntimeAdapter as E, fromExpressionNode as En, applyMigrationToPrismaSchema as Et, isTransactionCapableClient as F, ForeignKeyBuilder as Fn, buildRelationLine as Ft, loadMigrationsFrom as G, isMigrationApplied as Gn, findModelBlock as Gt, getRegisteredPaths as H, getLastBatchMigrations as Hn, deriveSingularFieldName as Ht, loadArkormConfig as I, buildMigrationIdentity as In, buildUniqueConstraintLine as It, registerFactories as J, readAppliedMigrationsState as Jn, formatRelationAction as Jt, loadModelsFrom as K, markMigrationApplied as Kn, formatDefaultValue as Kt, resetArkormRuntimeForTests as L, buildMigrationRunId as Ln, createMigrationTimestamp as Lt, getUserConfig as M, val as Mn, buildMigrationSource as Mt, isDelegateLike as N, where as Nn, buildModelBlock as Nt, getRuntimeDebugHandler as O, max as On, buildEnumBlock as Ot, isQuerySchemaLike as P, PrimaryKeyGenerationPlanner as Pn, buildPrimaryKeyLine as Pt, registerSeeders as Q, supportsDatabaseMigrationState as Qn, resolveEnumName as Qt, runArkormTransaction as R, computeMigrationChecksum as Rn, deriveCollectionFieldName as Rt, ensureArkormConfigLoading as S, col as Sn, applyDropTableOperation as St, getDefaultStubsPath as T, fn as Tn, applyMigrationToDatabase as Tt, getRegisteredSeeders as U, getLastMigrationRun as Un, escapeRegex as Ut, getRegisteredModels as V, findAppliedMigration as Vn, deriveRelationFieldName as Vt, loadFactoriesFrom as W, getLatestAppliedMigrations as Wn, findEnumBlock as Wt, registerModels as X, removeAppliedMigration as Xn, getMigrationPlan as Xt, registerMigrations as Y, readAppliedMigrationsStateFromStore as Yn, generateMigrationFile as Yt, registerPaths as Z, resolveMigrationStateFilePath as Zn, pad as Zt, bindAdapterToModels as _, Expression as _n, PRISMA_ENUM_MEMBER_REGEX as _t, HasOneThroughRelation as a, supportsDatabaseMigrationExecution as an, RelationResolutionException as ar, getPersistedEnumTsType as at, disposeArkormRuntime as b, caseWhen as bn, applyAlterTableOperation as bt, HasManyRelation as c, toModelName as cn, getPersistedTimestampColumns as ct, BelongsToManyRelation as d, SchemaBuilder as dn, resetPersistedColumnMappingsCache as dt, resolvePrismaType as en, writeAppliedMigrationsStateToStore as er, applyOperationsToPersistedColumnMappingsState as et, Relation as f, EnumBuilder as fn, resolveColumnMappingsFilePath as ft, awaitConfiguredModelsRegistration as g, CaseExpression as gn, writePersistedColumnMappingsState as gt, URLDriver as h, AggregateExpression as hn, validatePersistedMetadataFeaturesForMigrations as ht, MorphManyRelation as i, supportsDatabaseCreation as in, RelationTableLoader as ir, getPersistedEnumMap as it, getRuntimePrismaClient as j, sum as jn, buildInverseRelationLine as jt, getRuntimePaginationCurrentPageResolver as k, min as kn, buildFieldLine as kt, BelongsToRelation as l, isMigrationPlanningActive as ln, readPersistedColumnMappingsState as lt, Paginator as m, resolveGeneratedExpression as mn, syncPersistedColumnMappingsFromState as mt, MorphToManyRelation as n, runPrismaCommand as nn, UnsupportedAdapterFeatureException as nr, deletePersistedColumnMappingsState as nt, HasOneRelation as o, supportsDatabaseReset as on, ArkormCollection as or, getPersistedPrimaryKeyGeneration as ot, LengthAwarePaginator as p, TableBuilder as pn, resolvePersistedMetadataFeatures as pt, loadSeedersFrom as q, markMigrationRun as qn, formatEnumDefaultValue as qt, MorphOneRelation as r, stripPrismaSchemaModelsAndEnums as rn, SetBasedEagerLoader as rr, getPersistedColumnMap as rt, HasManyThroughRelation as s, toMigrationFileSlug as sn, ArkormException as sr, getPersistedTableMetadata as st, MorphToRelation as t, runMigrationWithPrisma as tn, RuntimeModuleLoader as tr, createEmptyPersistedColumnMappingsState as tt, SingleResultRelation as u, runInMigrationPlanning as un, rebuildPersistedColumnMappingsState as ut, configureArkormRuntime as v, JsonExpression as vn, PRISMA_ENUM_REGEX as vt, getActiveTransactionClient as w, expressionBuilder as wn, applyMigrationRollbackToPrismaSchema as wt, emitRuntimeDebugEvent as x, coalesce as xn, applyCreateTableOperation as xt, defineConfig as y, avg as yn, PRISMA_MODEL_REGEX as yt, getRegisteredFactories as z, createEmptyAppliedMigrationsState as zn, deriveInverseRelationAlias as zt };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkormx",
-  "version": "2.11.3",
+  "version": "2.11.5",
   "description": "Modern TypeScript-first ORM for Node.js.",
   "keywords": [
     "orm",