arkormx 2.10.0 → 2.10.2

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { $ as applyOperationsToPersistedColumnMappingsState, $t as resolvePrismaType, A as getRuntimePrismaClient, An as writeAppliedMigrationsStateToStore, At as buildInverseRelationLine, B as getRegisteredModels, Bt as deriveRelationFieldName, C as getActiveTransactionClient, Cn as markMigrationRun, Ct as applyMigrationRollbackToPrismaSchema, D as getRuntimeDebugHandler, Dn as resolveMigrationStateFilePath, Dt as buildEnumBlock, E as getRuntimeClient, En as removeAppliedMigration, Et as applyOperationsToPrismaSchema, F as loadArkormConfig, Fn as RelationResolutionException, Ft as buildUniqueConstraintLine, G as loadModelsFrom, Gt as formatDefaultValue, H as getRegisteredSeeders, Ht as escapeRegex, I as resetArkormRuntimeForTests, In as ArkormCollection, It as createMigrationTimestamp, J as registerMigrations, Jt as generateMigrationFile, K as loadSeedersFrom, Kt as formatEnumDefaultValue, L as runArkormTransaction, Ln as ArkormException, Lt as deriveCollectionFieldName, M as isDelegateLike, Mn as UnsupportedAdapterFeatureException, Mt as buildModelBlock, N as isQuerySchemaLike, Nn as SetBasedEagerLoader, Nt as buildPrimaryKeyLine, O as getRuntimePaginationCurrentPageResolver, On as supportsDatabaseMigrationState, Ot as buildFieldLine, P as isTransactionCapableClient, Pt as buildRelationLine, Q as resetRuntimeRegistryForTests, Qt as resolveMigrationClassName, R as getRegisteredFactories, Rt as deriveInverseRelationAlias, S as getActiveTransactionAdapter, Sn as markMigrationApplied, St as applyMigrationRollbackToDatabase, T as getRuntimeAdapter, Tn as readAppliedMigrationsStateFromStore, Tt as applyMigrationToPrismaSchema, U as loadFactoriesFrom, Ut as findEnumBlock, V as getRegisteredPaths, Vt as deriveSingularFieldName, W as loadMigrationsFrom, Wt as findModelBlock, X as registerPaths, Xt as pad, Y as registerModels, Yt as getMigrationPlan, Z as registerSeeders, Zt as resolveEnumName, _ as bindAdapterToModels, _n as deleteAppliedMigrationsStateFromStore, _t as PRISMA_ENUM_REGEX, a as HasOneThroughRelation, an as supportsDatabaseReset, at as getPersistedPrimaryKeyGeneration, b as emitRuntimeDebugEvent, bn as getLatestAppliedMigrations, bt as applyCreateTableOperation, c as HasManyRelation, cn as SchemaBuilder, ct as readPersistedColumnMappingsState, d as BelongsToManyRelation, dn as PrimaryKeyGenerationPlanner, dt as resolveColumnMappingsFilePath, en as runMigrationWithPrisma, et as createEmptyPersistedColumnMappingsState, f as Relation, fn as ForeignKeyBuilder, ft as resolvePersistedMetadataFeatures, g as awaitConfiguredModelsRegistration, gn as createEmptyAppliedMigrationsState, gt as PRISMA_ENUM_MEMBER_REGEX, h as URLDriver, hn as computeMigrationChecksum, ht as writePersistedColumnMappingsState, i as MorphManyRelation, in as supportsDatabaseMigrationExecution, it as getPersistedEnumTsType, j as getUserConfig, jn as RuntimeModuleLoader, jt as buildMigrationSource, k as getRuntimePaginationURLDriverFactory, kn as writeAppliedMigrationsState, kt as buildIndexLine, l as BelongsToRelation, ln as EnumBuilder, lt as rebuildPersistedColumnMappingsState, m as Paginator, mn as buildMigrationRunId, mt as validatePersistedMetadataFeaturesForMigrations, n as MorphToManyRelation, nn as stripPrismaSchemaModelsAndEnums, nt as getPersistedColumnMap, o as HasOneRelation, on as toMigrationFileSlug, ot as getPersistedTableMetadata, p as LengthAwarePaginator, pn as buildMigrationIdentity, pt as syncPersistedColumnMappingsFromState, q as registerFactories, qt as formatRelationAction, r as MorphOneRelation, rn as supportsDatabaseCreation, rt as getPersistedEnumMap, s as HasManyThroughRelation, sn as toModelName, st as getPersistedTimestampColumns, t as MorphToRelation, tn as runPrismaCommand, tt as deletePersistedColumnMappingsState, un as TableBuilder, ut as resetPersistedColumnMappingsCache, v as configureArkormRuntime, vn as findAppliedMigration, vt as PRISMA_MODEL_REGEX, w as getDefaultStubsPath, wn as readAppliedMigrationsState, wt as applyMigrationToDatabase, x as ensureArkormConfigLoading, xn as isMigrationApplied, xt as applyDropTableOperation, y as defineConfig, yn as getLastMigrationRun, yt as applyAlterTableOperation, z as getRegisteredMigrations, zt as deriveRelationAlias } from "./relationship-CmhzOlEo.mjs";
+import { $ as applyOperationsToPersistedColumnMappingsState, $t as resolvePrismaType, A as getRuntimePrismaClient, An as writeAppliedMigrationsStateToStore, At as buildInverseRelationLine, B as getRegisteredModels, Bt as deriveRelationFieldName, C as getActiveTransactionClient, Cn as markMigrationRun, Ct as applyMigrationRollbackToPrismaSchema, D as getRuntimeDebugHandler, Dn as resolveMigrationStateFilePath, Dt as buildEnumBlock, E as getRuntimeClient, En as removeAppliedMigration, Et as applyOperationsToPrismaSchema, F as loadArkormConfig, Fn as RelationResolutionException, Ft as buildUniqueConstraintLine, G as loadModelsFrom, Gt as formatDefaultValue, H as getRegisteredSeeders, Ht as escapeRegex, I as resetArkormRuntimeForTests, In as ArkormCollection, It as createMigrationTimestamp, J as registerMigrations, Jt as generateMigrationFile, K as loadSeedersFrom, Kt as formatEnumDefaultValue, L as runArkormTransaction, Ln as ArkormException, Lt as deriveCollectionFieldName, M as isDelegateLike, Mn as UnsupportedAdapterFeatureException, Mt as buildModelBlock, N as isQuerySchemaLike, Nn as SetBasedEagerLoader, Nt as buildPrimaryKeyLine, O as getRuntimePaginationCurrentPageResolver, On as supportsDatabaseMigrationState, Ot as buildFieldLine, P as isTransactionCapableClient, Pt as buildRelationLine, Q as resetRuntimeRegistryForTests, Qt as resolveMigrationClassName, R as getRegisteredFactories, Rt as deriveInverseRelationAlias, S as getActiveTransactionAdapter, Sn as markMigrationApplied, St as applyMigrationRollbackToDatabase, T as getRuntimeAdapter, Tn as readAppliedMigrationsStateFromStore, Tt as applyMigrationToPrismaSchema, U as loadFactoriesFrom, Ut as findEnumBlock, V as getRegisteredPaths, Vt as deriveSingularFieldName, W as loadMigrationsFrom, Wt as findModelBlock, X as registerPaths, Xt as pad, Y as registerModels, Yt as getMigrationPlan, Z as registerSeeders, Zt as resolveEnumName, _ as bindAdapterToModels, _n as deleteAppliedMigrationsStateFromStore, _t as PRISMA_ENUM_REGEX, a as HasOneThroughRelation, an as supportsDatabaseReset, at as getPersistedPrimaryKeyGeneration, b as emitRuntimeDebugEvent, bn as getLatestAppliedMigrations, bt as applyCreateTableOperation, c as HasManyRelation, cn as SchemaBuilder, ct as readPersistedColumnMappingsState, d as BelongsToManyRelation, dn as PrimaryKeyGenerationPlanner, dt as resolveColumnMappingsFilePath, en as runMigrationWithPrisma, et as createEmptyPersistedColumnMappingsState, f as Relation, fn as ForeignKeyBuilder, ft as resolvePersistedMetadataFeatures, g as awaitConfiguredModelsRegistration, gn as createEmptyAppliedMigrationsState, gt as PRISMA_ENUM_MEMBER_REGEX, h as URLDriver, hn as computeMigrationChecksum, ht as writePersistedColumnMappingsState, i as MorphManyRelation, in as supportsDatabaseMigrationExecution, it as getPersistedEnumTsType, j as getUserConfig, jn as RuntimeModuleLoader, jt as buildMigrationSource, k as getRuntimePaginationURLDriverFactory, kn as writeAppliedMigrationsState, kt as buildIndexLine, l as BelongsToRelation, ln as EnumBuilder, lt as rebuildPersistedColumnMappingsState, m as Paginator, mn as buildMigrationRunId, mt as validatePersistedMetadataFeaturesForMigrations, n as MorphToManyRelation, nn as stripPrismaSchemaModelsAndEnums, nt as getPersistedColumnMap, o as HasOneRelation, on as toMigrationFileSlug, ot as getPersistedTableMetadata, p as LengthAwarePaginator, pn as buildMigrationIdentity, pt as syncPersistedColumnMappingsFromState, q as registerFactories, qt as formatRelationAction, r as MorphOneRelation, rn as supportsDatabaseCreation, rt as getPersistedEnumMap, s as HasManyThroughRelation, sn as toModelName, st as getPersistedTimestampColumns, t as MorphToRelation, tn as runPrismaCommand, tt as deletePersistedColumnMappingsState, un as TableBuilder, ut as resetPersistedColumnMappingsCache, v as configureArkormRuntime, vn as findAppliedMigration, vt as PRISMA_MODEL_REGEX, w as getDefaultStubsPath, wn as readAppliedMigrationsState, wt as applyMigrationToDatabase, x as ensureArkormConfigLoading, xn as isMigrationApplied, xt as applyDropTableOperation, y as defineConfig, yn as getLastMigrationRun, yt as applyAlterTableOperation, z as getRegisteredMigrations, zt as deriveRelationAlias } from "./relationship-SFhKrphd.mjs";
 import { Pool } from "pg";
 import { join, resolve } from "node:path";
 import { createRequire } from "module";
@@ -450,12 +450,60 @@ var KyselyDatabaseAdapter = class KyselyDatabaseAdapter {
 		const table = this.resolveMappedTable(operation.table);
 		await this.ensureEnumTypes(table, operation.addColumns, executor);
 		for (const column of operation.addColumns) await this.executeRawStatement(`alter table ${this.quoteIdentifier(table)} add column if not exists ${this.buildSchemaColumnDefinition(table, column)}`, executor);
+		for (const column of operation.changeColumns ?? []) await this.executeChangeColumn(table, column, executor);
 		for (const column of operation.dropColumns) await this.executeRawStatement(`alter table ${this.quoteIdentifier(table)} drop column if exists ${this.quoteIdentifier(column)}`, executor);
 		for (const foreignKey of operation.addForeignKeys ?? []) await this.executeRawStatement(`alter table ${this.quoteIdentifier(table)} add ${this.buildSchemaForeignKeyConstraint(table, foreignKey, operation.addColumns)}`, executor);
 		if (operation.addPrimaryKey) await this.executeRawStatement(`alter table ${this.quoteIdentifier(table)} add ${this.buildSchemaPrimaryKeyConstraint(table, operation.addPrimaryKey, operation.addColumns)}`, executor);
 		for (const constraint of operation.addUniqueConstraints ?? []) await this.executeRawStatement(`alter table ${this.quoteIdentifier(table)} add ${this.buildSchemaUniqueConstraint(table, constraint, operation.addColumns)}`, executor);
 		for (const index of operation.addIndexes ?? []) await this.executeRawStatement(this.buildSchemaIndexStatement(table, index, operation.addColumns), executor);
 	}
+	async enumTypeExists(enumName, executor) {
+		const result = await sql`
+            select exists(select 1 from pg_type where typname = ${enumName}) as exists
+        `.execute(executor);
+		return Boolean(result.rows[0]?.exists);
+	}
+	/**
+	* Redefine an existing column in place using ALTER COLUMN statements: the
+	* column type (recreating the enum type when enum values change), nullability,
+	* default, and a conventionally-named unique constraint.
+	*
+	* @param table
+	* @param column
+	* @param executor
+	*/
+	async executeChangeColumn(table, column, executor) {
+		const quotedTable = this.quoteIdentifier(table);
+		const physicalName = column.map ?? column.name;
+		const physical = this.quoteIdentifier(physicalName);
+		if (column.type === "enum") {
+			const enumName = this.resolveSchemaEnumName(table, column);
+			const values = column.enumValues ?? [];
+			if (values.length === 0) throw new ArkormException(`Enum column [${column.name}] requires enum values to change its definition.`);
+			const quotedEnum = this.quoteIdentifier(enumName);
+			const enumLiterals = values.map((value) => this.quoteLiteral(value)).join(", ");
+			if (await this.enumTypeExists(enumName, executor)) {
+				const tempEnum = this.quoteIdentifier(`${enumName}__arkorm_change`);
+				await this.executeRawStatement(`drop type if exists ${tempEnum}`, executor);
+				await this.executeRawStatement(`alter type ${quotedEnum} rename to ${tempEnum}`, executor);
+				await this.executeRawStatement(`create type ${quotedEnum} as enum (${enumLiterals})`, executor);
+				await this.executeRawStatement(`alter table ${quotedTable} alter column ${physical} type ${quotedEnum} using ${physical}::text::${quotedEnum}`, executor);
+				await this.executeRawStatement(`drop type ${tempEnum}`, executor);
+			} else {
+				await this.executeRawStatement(`create type ${quotedEnum} as enum (${enumLiterals})`, executor);
+				await this.executeRawStatement(`alter table ${quotedTable} alter column ${physical} type ${quotedEnum} using ${physical}::text::${quotedEnum}`, executor);
+			}
+		} else {
+			const targetType = this.resolveSchemaColumnType(table, column);
+			await this.executeRawStatement(`alter table ${quotedTable} alter column ${physical} type ${targetType} using ${physical}::${targetType}`, executor);
+		}
+		await this.executeRawStatement(column.nullable ? `alter table ${quotedTable} alter column ${physical} drop not null` : `alter table ${quotedTable} alter column ${physical} set not null`, executor);
+		const defaultValue = this.resolveSchemaColumnDefault(column);
+		await this.executeRawStatement(defaultValue ? `alter table ${quotedTable} alter column ${physical} set default ${defaultValue}` : `alter table ${quotedTable} alter column ${physical} drop default`, executor);
+		const constraint = this.quoteIdentifier(`${table}_${physicalName}_key`);
+		await this.executeRawStatement(`alter table ${quotedTable} drop constraint if exists ${constraint}`, executor);
+		if (column.unique) await this.executeRawStatement(`alter table ${quotedTable} add constraint ${constraint} unique (${physical})`, executor);
+	}
 	async executeDropTableOperation(operation, executor) {
 		const table = this.resolveMappedTable(operation.table);
 		await this.executeRawStatement(`drop table if exists ${this.quoteIdentifier(table)} cascade`, executor);
@@ -3325,6 +3373,14 @@ var Migration = class {
 	static {
 		this[MIGRATION_BRAND] = true;
 	}
+	/**
+	* Optional lifecycle hook invoked after the migration's schema operations
+	* have been applied to the database, for either direction. Override it to run
+	* extra logic such as seeding or data backfills once the schema is in place.
+	*
+	* @param direction The direction that just ran (`'up'` or `'down'`).
+	*/
+	done(_direction) {}
 };
 
 //#endregion
@@ -6265,10 +6321,11 @@ var QueryBuilder = class QueryBuilder {
 		return affected;
 	}
 	/**
-	* Deletes the first record matching the current query constraints and returns
-	* it as a hydrated model instance. Returns null when no record matches.
+	* Deletes every record matching the current query constraints and returns the
+	* number of rows deleted (Laravel parity: `int delete()`). A where clause is
+	* required — guarding against an accidental full-table delete.
 	*
-	* @returns
+	* @returns the count of deleted rows (0 when nothing matched)
 	*/
 	async delete() {
 		const where = this.buildWhere();
@@ -6276,40 +6333,17 @@ var QueryBuilder = class QueryBuilder {
 			operation: "delete",
 			model: this.model.name
 		});
-		const directSpec = this.tryBuildDeleteSpec(where);
-		const adapter = this.requireAdapter();
-		if (!this.isUniqueWhere(where) && directSpec && typeof adapter.deleteFirst === "function") {
-			const deleted = await adapter.deleteFirst(directSpec);
-			if (!deleted) return null;
-			return this.hydrateDeleted(deleted);
-		}
-		const uniqueWhere = await this.resolveUniqueWhere(where, false);
-		if (!uniqueWhere) return null;
-		const deleted = await this.executeDeleteRow(uniqueWhere, false);
-		if (!deleted) return null;
-		return this.hydrateDeleted(deleted);
+		return this.executeDeleteManyRows(where);
 	}
 	/**
-	* Hydrate a row that was just deleted, marking the resulting model as no
-	* longer existing in the database.
+	* Deletes every record matching the current query constraints and throws when
+	* none matched.
 	*
-	* @param attributes
-	* @returns
-	*/
-	hydrateDeleted(attributes) {
-		const model = this.model.hydrate(attributes);
-		model.exists = false;
-		return model;
-	}
-	/**
-	* Deletes the first record matching the current query constraints and throws
-	* when no record matches.
-	*
-	* @returns
+	* @returns the count of deleted rows (always >= 1)
 	*/
 	async deleteOrFail() {
 		const deleted = await this.delete();
-		if (!deleted) throw new ModelNotFoundException(this.model.name, "Record not found for delete operation.", { operation: "delete" });
+		if (deleted === 0) throw new ModelNotFoundException(this.model.name, "Record not found for delete operation.", { operation: "delete" });
 		return deleted;
 	}
 	tryBuildInsertSpec(values) {
@@ -6356,14 +6390,6 @@ var QueryBuilder = class QueryBuilder {
 			values
 		};
 	}
-	tryBuildDeleteSpec(where) {
-		const condition = this.tryBuildQueryCondition(where);
-		if (!condition) return null;
-		return {
-			target: this.buildQueryTarget(),
-			where: condition
-		};
-	}
 	/**
 	* Counts the number of records matching the current query constraints.
 	*
@@ -7294,17 +7320,31 @@ var QueryBuilder = class QueryBuilder {
 		}
 		return updated;
 	}
-	async executeDeleteRow(where, failIfMissing = true) {
+	async executeDeleteManyRows(where) {
 		const adapter = this.requireAdapter();
-		const spec = this.tryBuildDeleteSpec(where);
-		if (!spec) throw new UnsupportedAdapterFeatureException("Delete could not be compiled into an Arkorm delete specification.", {
+		const condition = this.tryBuildQueryCondition(where);
+		if (condition === null) throw new UnsupportedAdapterFeatureException("Delete could not be compiled into an Arkorm delete specification.", {
 			operation: "query.delete",
 			model: this.model.name
 		});
-		const deleted = await adapter.delete(spec);
-		if (!deleted) return failIfMissing ? (() => {
-			throw new ModelNotFoundException(this.model.name, "Record not found for delete operation.", { operation: "delete" });
-		})() : null;
+		const spec = {
+			target: this.buildQueryTarget(),
+			where: condition
+		};
+		if (typeof adapter.deleteMany === "function") return await adapter.deleteMany(spec);
+		const rows = await adapter.select({
+			target: spec.target,
+			where: spec.where
+		});
+		let deleted = 0;
+		for (const row of rows) {
+			const rowWhere = this.tryBuildQueryCondition(row);
+			if (!rowWhere) continue;
+			if (await adapter.delete({
+				target: spec.target,
+				where: rowWhere
+			})) deleted += 1;
+		}
 		return deleted;
 	}
 	/**
@@ -8206,6 +8246,22 @@ var Model = class Model {
 		});
 		return this;
 	}
+	/**
+	* Merge already-stored (database representation) attribute values into the
+	* model without running set mutators or casts. Used to refresh the instance
+	* from a row returned by a write, where the values are already in storage
+	* form and must not be re-cast (re-applying a non-idempotent set-cast such as
+	* a money or array cast would corrupt the value).
+	*
+	* @param attributes
+	* @returns
+	*/
+	fillRawAttributes(attributes) {
+		Object.entries(attributes).forEach(([key, value]) => {
+			this.attributes[key] = Model.cloneAttributeValue(value);
+		});
+		return this;
+	}
 	async update(attributes) {
 		try {
 			const primaryKey = this.constructor.getPrimaryKey();
@@ -8261,7 +8317,7 @@ var Model = class Model {
 			await Model.dispatchEvent(constructor, "creating", this);
 			const payload = this.normalizePersistenceAttributes(this.getRawAttributes());
 			const model = await constructor.query().create(payload);
-			this.fill(model.getRawAttributes());
+			this.fillRawAttributes(model.getRawAttributes());
 			this.syncChanges(previousOriginal);
 			this.syncPrevious(previousOriginal);
 			this.syncOriginal();
@@ -8278,7 +8334,7 @@ var Model = class Model {
 		const payload = this.normalizePersistenceAttributes(this.getDirtyAttributes());
 		delete payload[primaryKey];
 		const model = await constructor.query().where({ [primaryKey]: identifier }).update(payload);
-		this.fill(model.getRawAttributes());
+		this.fillRawAttributes(model.getRawAttributes());
 		this.syncChanges(previousOriginal);
 		this.syncPrevious(previousOriginal);
 		this.syncOriginal();
@@ -8321,14 +8377,13 @@ var Model = class Model {
 		const softDeleteConfig = constructor.getSoftDeleteConfig();
 		if (softDeleteConfig.enabled) {
 			const model = await constructor.query().where({ [primaryKey]: identifier }).update({ [softDeleteConfig.column]: /* @__PURE__ */ new Date() });
-			this.fill(model.getRawAttributes());
+			this.fillRawAttributes(model.getRawAttributes());
 			this.syncChanges(previousOriginal);
 			this.syncOriginal();
 			await Model.dispatchEvent(constructor, "deleted", this);
 			return this;
 		}
-		const deleted = await constructor.query().where({ [primaryKey]: identifier }).deleteOrFail();
-		this.fill(deleted.getRawAttributes());
+		await constructor.query().where({ [primaryKey]: identifier }).deleteOrFail();
 		this.syncChanges(previousOriginal);
 		this.syncOriginal();
 		this.exists = false;
@@ -8366,8 +8421,7 @@ var Model = class Model {
 		const previousOriginal = this.getOriginal();
 		await Model.dispatchEvent(constructor, "forceDeleting", this);
 		await Model.dispatchEvent(constructor, "deleting", this);
-		const deleted = await constructor.query().withTrashed().where({ [primaryKey]: identifier }).deleteOrFail();
-		this.fill(deleted.getRawAttributes());
+		await constructor.query().withTrashed().where({ [primaryKey]: identifier }).deleteOrFail();
 		this.syncChanges(previousOriginal);
 		this.syncOriginal();
 		this.exists = false;
@@ -8398,7 +8452,7 @@ var Model = class Model {
 		const previousOriginal = this.getOriginal();
 		await Model.dispatchEvent(constructor, "restoring", this);
 		const model = await constructor.query().withTrashed().where({ [primaryKey]: identifier }).update({ [softDeleteConfig.column]: null });
-		this.fill(model.getRawAttributes());
+		this.fillRawAttributes(model.getRawAttributes());
 		this.syncChanges(previousOriginal);
 		this.syncOriginal();
 		await Model.dispatchEvent(constructor, "restored", this);

package/dist/relationship/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_relationship = require('../relationship-DGOpcWA0.cjs');
+const require_relationship = require('../relationship-DWtfgLfh.cjs');
 
 exports.BelongsToManyRelation = require_relationship.BelongsToManyRelation;
 exports.BelongsToRelation = require_relationship.BelongsToRelation;

package/dist/relationship/index.d.cts

@@ -1,2 +1,2 @@
-import { Ao as HasOneRelation, Do as MorphOneRelation, Eo as MorphToManyRelation, Fo as BelongsToManyRelation, Io as Relation, Lo as RelationTableLoader, Mo as HasManyRelation, No as BelongsToRelation, Oo as MorphManyRelation, Po as SingleResultRelation, To as MorphToRelation, jo as HasManyThroughRelation, ko as HasOneThroughRelation, wo as SetBasedEagerLoader } from "../index-CgzhC61F.cjs";
+import { Ao as HasOneRelation, Do as MorphOneRelation, Eo as MorphToManyRelation, Fo as BelongsToManyRelation, Io as Relation, Lo as RelationTableLoader, Mo as HasManyRelation, No as BelongsToRelation, Oo as MorphManyRelation, Po as SingleResultRelation, To as MorphToRelation, jo as HasManyThroughRelation, ko as HasOneThroughRelation, wo as SetBasedEagerLoader } from "../index-CGawfwb8.cjs";
 export { BelongsToManyRelation, BelongsToRelation, HasManyRelation, HasManyThroughRelation, HasOneRelation, HasOneThroughRelation, MorphManyRelation, MorphOneRelation, MorphToManyRelation, MorphToRelation, Relation, RelationTableLoader, SetBasedEagerLoader, SingleResultRelation };

package/dist/relationship/index.d.mts

@@ -1,2 +1,2 @@
-import { Ao as HasOneRelation, Do as MorphOneRelation, Eo as MorphToManyRelation, Fo as BelongsToManyRelation, Io as Relation, Lo as RelationTableLoader, Mo as HasManyRelation, No as BelongsToRelation, Oo as MorphManyRelation, Po as SingleResultRelation, To as MorphToRelation, jo as HasManyThroughRelation, ko as HasOneThroughRelation, wo as SetBasedEagerLoader } from "../index-CJ7yJR43.mjs";
+import { Ao as HasOneRelation, Do as MorphOneRelation, Eo as MorphToManyRelation, Fo as BelongsToManyRelation, Io as Relation, Lo as RelationTableLoader, Mo as HasManyRelation, No as BelongsToRelation, Oo as MorphManyRelation, Po as SingleResultRelation, To as MorphToRelation, jo as HasManyThroughRelation, ko as HasOneThroughRelation, wo as SetBasedEagerLoader } from "../index-ClVzjhGq.mjs";
 export { BelongsToManyRelation, BelongsToRelation, HasManyRelation, HasManyThroughRelation, HasOneRelation, HasOneThroughRelation, MorphManyRelation, MorphOneRelation, MorphToManyRelation, MorphToRelation, Relation, RelationTableLoader, SetBasedEagerLoader, SingleResultRelation };

package/dist/relationship/index.mjs

@@ -1,3 +1,3 @@
-import { Nn as SetBasedEagerLoader, Pn as RelationTableLoader, a as HasOneThroughRelation, c as HasManyRelation, d as BelongsToManyRelation, f as Relation, i as MorphManyRelation, l as BelongsToRelation, n as MorphToManyRelation, o as HasOneRelation, r as MorphOneRelation, s as HasManyThroughRelation, t as MorphToRelation, u as SingleResultRelation } from "../relationship-CmhzOlEo.mjs";
+import { Nn as SetBasedEagerLoader, Pn as RelationTableLoader, a as HasOneThroughRelation, c as HasManyRelation, d as BelongsToManyRelation, f as Relation, i as MorphManyRelation, l as BelongsToRelation, n as MorphToManyRelation, o as HasOneRelation, r as MorphOneRelation, s as HasManyThroughRelation, t as MorphToRelation, u as SingleResultRelation } from "../relationship-SFhKrphd.mjs";
 
 export { BelongsToManyRelation, BelongsToRelation, HasManyRelation, HasManyThroughRelation, HasOneRelation, HasOneThroughRelation, MorphManyRelation, MorphOneRelation, MorphToManyRelation, MorphToRelation, Relation, RelationTableLoader, SetBasedEagerLoader, SingleResultRelation };

package/dist/{relationship-DGOpcWA0.cjs → relationship-DWtfgLfh.cjs}

@@ -1218,6 +1218,15 @@ var EnumBuilder = class {
 		this.tableBuilder.map(name, this.columnName);
 		return this;
 	}
+	/**
+	* Marks the enum column as an in-place change to an existing column.
+	*
+	* @returns
+	*/
+	change() {
+		this.tableBuilder.change(this.columnName);
+		return this;
+	}
 };
 /**
 * The TableBuilder class provides a fluent interface for defining
@@ -1230,6 +1239,7 @@ var TableBuilder = class {
 	constructor() {
 		this.columns = [];
 		this.dropColumnNames = [];
+		this.changeColumnNames = /* @__PURE__ */ new Set();
 		this.indexes = [];
 		this.foreignKeys = [];
 		this.compositeUniqueConstraints = [];
@@ -1543,6 +1553,24 @@ var TableBuilder = class {
 		return this;
 	}
 	/**
+	* Marks a (re)defined column as a change to an existing column rather than an
+	* addition. Use it at the end of a normal column chain inside `alterTable` to
+	* redefine the column's type, nullability, default, or enum values in place:
+	*
+	* ```ts
+	* table.string('status').default('active').change()
+	* table.enum('role', ['admin', 'user', 'guest']).change()
+	* ```
+	*
+	* @param columnName Optional explicit column name. When omitted, applies to the latest defined column.
+	* @returns          The current TableBuilder instance for chaining.
+	*/
+	change(columnName) {
+		const column = this.resolveColumn(columnName);
+		this.changeColumnNames.add(column.name);
+		return this;
+	}
+	/**
 	* Marks a column as nullable.
 	*
 	* @param columnName Optional explicit column name. When omitted, applies to the latest defined column.
@@ -1651,7 +1679,18 @@ var TableBuilder = class {
 	* @returns
 	*/
 	getColumns() {
-		return this.columns.map((column) => ({
+		return this.columns.filter((column) => !this.changeColumnNames.has(column.name)).map((column) => ({
+			...column,
+			enumValues: column.enumValues ? [...column.enumValues] : void 0
+		}));
+	}
+	/**
+	* Returns a deep copy of the columns flagged for in-place change via `change()`.
+	*
+	* @returns
+	*/
+	getChangeColumns() {
+		return this.columns.filter((column) => this.changeColumnNames.has(column.name)).map((column) => ({
 			...column,
 			enumValues: column.enumValues ? [...column.enumValues] : void 0
 		}));
@@ -1873,6 +1912,7 @@ var SchemaBuilder = class SchemaBuilder {
 			type: "alterTable",
 			table,
 			addColumns: builder.getColumns(),
+			changeColumns: builder.getChangeColumns(),
 			dropColumns: builder.getDropColumns(),
 			addIndexes: builder.getIndexes(),
 			addForeignKeys: builder.getForeignKeys(),
@@ -1927,6 +1967,10 @@ var SchemaBuilder = class SchemaBuilder {
 					...column,
 					enumValues: column.enumValues ? [...column.enumValues] : void 0
 				})),
+				changeColumns: operation.changeColumns?.map((column) => ({
+					...column,
+					enumValues: column.enumValues ? [...column.enumValues] : void 0
+				})),
 				dropColumns: [...operation.dropColumns],
 				addIndexes: operation.addIndexes.map((index) => ({
 					...index,
@@ -2431,11 +2475,18 @@ const applyCreateTableOperation = (schema, operation) => {
 const applyAlterTableOperation = (schema, operation) => {
 	const model = findModelBlock(schema, operation.table);
 	if (!model) throw new ArkormException(`Prisma model for table [${operation.table}] was not found.`);
-	const schemaWithEnums = ensureEnumBlocks(schema, operation.addColumns);
+	const schemaWithEnums = ensureEnumBlocks(schema, [...operation.addColumns, ...operation.changeColumns ?? []]);
 	const refreshedModel = findModelBlock(schemaWithEnums, operation.table);
 	if (!refreshedModel) throw new ArkormException(`Prisma model for table [${operation.table}] was not found.`);
 	let block = refreshedModel.block;
 	const bodyLines = block.split("\n");
+	(operation.changeColumns ?? []).forEach((column) => {
+		const fieldLine = buildFieldLine(column);
+		const columnRegex = new RegExp(`^\\s*${escapeRegex(column.name)}\\s+`);
+		const index = bodyLines.findIndex((line) => columnRegex.test(line));
+		if (index >= 0) bodyLines.splice(index, 1, fieldLine);
+		else bodyLines.splice(Math.max(1, bodyLines.length - 1), 0, fieldLine);
+	});
 	operation.dropColumns.forEach((column) => {
 		const columnRegex = new RegExp(`^\\s*${escapeRegex(column)}\\s+`);
 		for (let index = 0; index < bodyLines.length; index += 1) if (columnRegex.test(bodyLines[index])) {
@@ -2660,14 +2711,18 @@ const stripPrismaSchemaModelsAndEnums = (schema) => {
 };
 const applyMigrationToDatabase = async (adapter, migration) => {
 	if (!supportsDatabaseMigrationExecution(adapter)) throw new ArkormException("The configured adapter does not support database-backed migration execution.");
-	const operations = await getMigrationPlan(migration, "up");
+	const instance = typeof migration === "function" ? new migration() : migration;
+	const operations = await getMigrationPlan(instance, "up");
 	await adapter.executeSchemaOperations(operations);
+	await instance.done?.("up");
 	return { operations };
 };
 const applyMigrationRollbackToDatabase = async (adapter, migration) => {
 	if (!supportsDatabaseMigrationExecution(adapter)) throw new ArkormException("The configured adapter does not support database-backed migration execution.");
-	const operations = await getMigrationPlan(migration, "down");
+	const instance = typeof migration === "function" ? new migration() : migration;
+	const operations = await getMigrationPlan(instance, "down");
 	await adapter.executeSchemaOperations(operations);
+	await instance.done?.("down");
 	return { operations };
 };
 /**

package/dist/{relationship-CmhzOlEo.mjs → relationship-SFhKrphd.mjs}

@@ -1190,6 +1190,15 @@ var EnumBuilder = class {
 		this.tableBuilder.map(name, this.columnName);
 		return this;
 	}
+	/**
+	* Marks the enum column as an in-place change to an existing column.
+	*
+	* @returns
+	*/
+	change() {
+		this.tableBuilder.change(this.columnName);
+		return this;
+	}
 };
 /**
 * The TableBuilder class provides a fluent interface for defining
@@ -1202,6 +1211,7 @@ var TableBuilder = class {
 	constructor() {
 		this.columns = [];
 		this.dropColumnNames = [];
+		this.changeColumnNames = /* @__PURE__ */ new Set();
 		this.indexes = [];
 		this.foreignKeys = [];
 		this.compositeUniqueConstraints = [];
@@ -1515,6 +1525,24 @@ var TableBuilder = class {
 		return this;
 	}
 	/**
+	* Marks a (re)defined column as a change to an existing column rather than an
+	* addition. Use it at the end of a normal column chain inside `alterTable` to
+	* redefine the column's type, nullability, default, or enum values in place:
+	*
+	* ```ts
+	* table.string('status').default('active').change()
+	* table.enum('role', ['admin', 'user', 'guest']).change()
+	* ```
+	*
+	* @param columnName Optional explicit column name. When omitted, applies to the latest defined column.
+	* @returns          The current TableBuilder instance for chaining.
+	*/
+	change(columnName) {
+		const column = this.resolveColumn(columnName);
+		this.changeColumnNames.add(column.name);
+		return this;
+	}
+	/**
 	* Marks a column as nullable.
 	*
 	* @param columnName Optional explicit column name. When omitted, applies to the latest defined column.
@@ -1623,7 +1651,18 @@ var TableBuilder = class {
 	* @returns
 	*/
 	getColumns() {
-		return this.columns.map((column) => ({
+		return this.columns.filter((column) => !this.changeColumnNames.has(column.name)).map((column) => ({
+			...column,
+			enumValues: column.enumValues ? [...column.enumValues] : void 0
+		}));
+	}
+	/**
+	* Returns a deep copy of the columns flagged for in-place change via `change()`.
+	*
+	* @returns
+	*/
+	getChangeColumns() {
+		return this.columns.filter((column) => this.changeColumnNames.has(column.name)).map((column) => ({
 			...column,
 			enumValues: column.enumValues ? [...column.enumValues] : void 0
 		}));
@@ -1845,6 +1884,7 @@ var SchemaBuilder = class SchemaBuilder {
 			type: "alterTable",
 			table,
 			addColumns: builder.getColumns(),
+			changeColumns: builder.getChangeColumns(),
 			dropColumns: builder.getDropColumns(),
 			addIndexes: builder.getIndexes(),
 			addForeignKeys: builder.getForeignKeys(),
@@ -1899,6 +1939,10 @@ var SchemaBuilder = class SchemaBuilder {
 					...column,
 					enumValues: column.enumValues ? [...column.enumValues] : void 0
 				})),
+				changeColumns: operation.changeColumns?.map((column) => ({
+					...column,
+					enumValues: column.enumValues ? [...column.enumValues] : void 0
+				})),
 				dropColumns: [...operation.dropColumns],
 				addIndexes: operation.addIndexes.map((index) => ({
 					...index,
@@ -2403,11 +2447,18 @@ const applyCreateTableOperation = (schema, operation) => {
 const applyAlterTableOperation = (schema, operation) => {
 	const model = findModelBlock(schema, operation.table);
 	if (!model) throw new ArkormException(`Prisma model for table [${operation.table}] was not found.`);
-	const schemaWithEnums = ensureEnumBlocks(schema, operation.addColumns);
+	const schemaWithEnums = ensureEnumBlocks(schema, [...operation.addColumns, ...operation.changeColumns ?? []]);
 	const refreshedModel = findModelBlock(schemaWithEnums, operation.table);
 	if (!refreshedModel) throw new ArkormException(`Prisma model for table [${operation.table}] was not found.`);
 	let block = refreshedModel.block;
 	const bodyLines = block.split("\n");
+	(operation.changeColumns ?? []).forEach((column) => {
+		const fieldLine = buildFieldLine(column);
+		const columnRegex = new RegExp(`^\\s*${escapeRegex(column.name)}\\s+`);
+		const index = bodyLines.findIndex((line) => columnRegex.test(line));
+		if (index >= 0) bodyLines.splice(index, 1, fieldLine);
+		else bodyLines.splice(Math.max(1, bodyLines.length - 1), 0, fieldLine);
+	});
 	operation.dropColumns.forEach((column) => {
 		const columnRegex = new RegExp(`^\\s*${escapeRegex(column)}\\s+`);
 		for (let index = 0; index < bodyLines.length; index += 1) if (columnRegex.test(bodyLines[index])) {
@@ -2632,14 +2683,18 @@ const stripPrismaSchemaModelsAndEnums = (schema) => {
 };
 const applyMigrationToDatabase = async (adapter, migration) => {
 	if (!supportsDatabaseMigrationExecution(adapter)) throw new ArkormException("The configured adapter does not support database-backed migration execution.");
-	const operations = await getMigrationPlan(migration, "up");
+	const instance = typeof migration === "function" ? new migration() : migration;
+	const operations = await getMigrationPlan(instance, "up");
 	await adapter.executeSchemaOperations(operations);
+	await instance.done?.("up");
 	return { operations };
 };
 const applyMigrationRollbackToDatabase = async (adapter, migration) => {
 	if (!supportsDatabaseMigrationExecution(adapter)) throw new ArkormException("The configured adapter does not support database-backed migration execution.");
-	const operations = await getMigrationPlan(migration, "down");
+	const instance = typeof migration === "function" ? new migration() : migration;
+	const operations = await getMigrationPlan(instance, "down");
 	await adapter.executeSchemaOperations(operations);
+	await instance.done?.("down");
 	return { operations };
 };
 /**

package/package.json

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