arkormx 2.9.1 → 2.9.3

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-DtNgcxxv.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-BD04hN72.mjs";
 import { Pool } from "pg";
 import { join, resolve } from "node:path";
 import { createRequire } from "module";
@@ -33,9 +33,9 @@ var QueryExecutionException = class extends ArkormException {
 //#endregion
 //#region src/adapters/KyselyDatabaseAdapter.ts
 /**
-* Database adapter implementation for Kysely, allowing Arkorm to execute queries using Kysely 
+* Database adapter implementation for Kysely, allowing Arkorm to execute queries using Kysely
 * as the underlying query builder and executor.
-* 
+*
 * @author Legacy (3m1n3nc3)
 * @since 2.0.0-next.0
 */
@@ -1083,9 +1083,9 @@ var KyselyDatabaseAdapter = class KyselyDatabaseAdapter {
 		}
 	}
 	/**
-	* Selects records from the database matching the specified criteria and returns 
+	* Selects records from the database matching the specified criteria and returns
 	* them as an array of database rows.
-	* 
+	*
 	* @param spec  The specification defining the selection criteria.
 	* @returns     A promise that resolves to an array of database rows.
 	*/
@@ -1103,10 +1103,10 @@ var KyselyDatabaseAdapter = class KyselyDatabaseAdapter {
 		});
 	}
 	/**
-	* Selects a single record from the database matching the specified criteria and returns it as 
-	* a database row. If multiple records match the criteria, only the first one is returned. 
+	* Selects a single record from the database matching the specified criteria and returns it as
+	* a database row. If multiple records match the criteria, only the first one is returned.
 	* If no records match, null is returned.
-	* 
+	*
 	* @param spec  The specification defining the selection criteria.
 	* @returns     A promise that resolves to a database row or null if no records match.
 	*/
@@ -1117,11 +1117,11 @@ var KyselyDatabaseAdapter = class KyselyDatabaseAdapter {
 		}))[0] ?? null;
 	}
 	/**
-	* Inserts a new record into the database with the specified values and returns the 
+	* Inserts a new record into the database with the specified values and returns the
 	* inserted record as a database row.
-	* 
-	* @param spec 
-	* @returns 
+	*
+	* @param spec
+	* @returns
 	*/
 	async insert(spec) {
 		const values = this.mapValues(spec.target, spec.values);
@@ -1140,9 +1140,9 @@ var KyselyDatabaseAdapter = class KyselyDatabaseAdapter {
 		}, { values: spec.values });
 	}
 	/**
-	* Inserts multiple records into the database with the specified values and returns the number 
-	* of records successfully inserted. 
-	* 
+	* Inserts multiple records into the database with the specified values and returns the number
+	* of records successfully inserted.
+	*
 	* @param spec  The specification defining the values to be inserted.
 	* @returns     A promise that resolves to the number of records successfully inserted.
 	*/
@@ -1213,11 +1213,11 @@ var KyselyDatabaseAdapter = class KyselyDatabaseAdapter {
 		return spec.values.length;
 	}
 	/**
-	* Updates records in the database matching the specified criteria with the given values 
-	* and returns the updated record as a database row. 
-	* 
+	* Updates records in the database matching the specified criteria with the given values
+	* and returns the updated record as a database row.
+	*
 	* @param spec  The specification defining the update criteria and values.
-	* @returns     A promise that resolves to the updated record as a database row, or null if no records match the criteria.  
+	* @returns     A promise that resolves to the updated record as a database row, or null if no records match the criteria.
 	*/
 	async update(spec) {
 		const values = this.mapValues(spec.target, spec.values);
@@ -1244,9 +1244,9 @@ var KyselyDatabaseAdapter = class KyselyDatabaseAdapter {
 	}
 	/**
 	* Updates a single record in the database matching the specified criteria with the given values.
-	* 
-	* @param spec 
-	* @returns 
+	*
+	* @param spec
+	* @returns
 	*/
 	async updateFirst(spec) {
 		const values = this.mapValues(spec.target, spec.values);
@@ -1276,9 +1276,9 @@ var KyselyDatabaseAdapter = class KyselyDatabaseAdapter {
 		});
 	}
 	/**
-	* Updates multiple records in the database matching the specified criteria with the 
+	* Updates multiple records in the database matching the specified criteria with the
 	* given values and returns the number of records successfully updated.
-	* 
+	*
 	* @param spec  The specification defining the update criteria and values.
 	* @returns     A promise that resolves to the number of records successfully updated.
 	*/
@@ -1300,9 +1300,9 @@ var KyselyDatabaseAdapter = class KyselyDatabaseAdapter {
 		});
 	}
 	/**
-	* Deletes records from the database matching the specified criteria and returns the 
+	* Deletes records from the database matching the specified criteria and returns the
 	* deleted record as a database row.
-	* 
+	*
 	* @param spec  The specification defining the delete criteria.
 	* @returns     A promise that resolves to the deleted record as a database row, or null if no records match the criteria.
 	*/
@@ -1318,9 +1318,9 @@ var KyselyDatabaseAdapter = class KyselyDatabaseAdapter {
 	}
 	/**
 	* Deletes a single record from the database matching the specified criteria and returns it as a database row.
-	* 
-	* @param spec 
-	* @returns 
+	*
+	* @param spec
+	* @returns
 	*/
 	async deleteFirst(spec) {
 		const primaryKey = this.resolvePrimaryKey(spec.target);
@@ -1337,9 +1337,9 @@ var KyselyDatabaseAdapter = class KyselyDatabaseAdapter {
 		}, { where: spec.where });
 	}
 	/**
-	* Deletes multiple records from the database matching the specified criteria and 
+	* Deletes multiple records from the database matching the specified criteria and
 	* returns the number of records successfully deleted.
-	* 
+	*
 	* @param spec  The specification defining the delete criteria.
 	* @returns     A promise that resolves to the number of records successfully deleted.
 	*/
@@ -1352,9 +1352,9 @@ var KyselyDatabaseAdapter = class KyselyDatabaseAdapter {
 		return await this.executeWithDebug("deleteMany", spec.target, statement, (rows) => rows.length, { where: spec.where });
 	}
 	/**
-	* Counts the number of records in the database matching the specified criteria and returns 
+	* Counts the number of records in the database matching the specified criteria and returns
 	* the count as a number.
-	* 
+	*
 	* @param spec  The specification defining the count criteria.
 	* @returns     A promise that resolves to the number of records matching the criteria.
 	*/
@@ -1368,7 +1368,7 @@ var KyselyDatabaseAdapter = class KyselyDatabaseAdapter {
 	}
 	/**
 	* Checks for the existence of records matching the specified criteria.
-	* 
+	*
 	* @param spec  The specification defining the existence criteria.
 	* @returns     A promise that resolves to a boolean indicating whether any records match the criteria.
 	*/
@@ -1382,9 +1382,9 @@ var KyselyDatabaseAdapter = class KyselyDatabaseAdapter {
 	}
 	/**
 	* Loads relations for the given models based on the specified relation load plans.
-	* 
+	*
 	* @param spec  The specification defining the models and their relations to be loaded.
-	* @returns 
+	* @returns
 	*/
 	async loadRelations(spec) {
 		if (spec.models.length === 0 || spec.relations.length === 0) return;
@@ -1520,10 +1520,10 @@ var KyselyDatabaseAdapter = class KyselyDatabaseAdapter {
 		});
 	}
 	/**
-	* Executes a series of database operations within a transaction. 
-	* The provided callback function is called with a new instance of the 
+	* Executes a series of database operations within a transaction.
+	* The provided callback function is called with a new instance of the
 	* KyselyDatabaseAdapter that is bound to the transaction context.
-	* 
+	*
 	* @param callback  The callback function containing the database operations to be executed within the transaction.
 	* @param context   The transaction context specifying options such as read-only mode and isolation level.
 	* @returns         A promise that resolves to the result of the callback function.
@@ -1538,12 +1538,12 @@ var KyselyDatabaseAdapter = class KyselyDatabaseAdapter {
 	}
 };
 /**
-* Factory function to create a KyselyDatabaseAdapter instance with the given Kysely executor 
+* Factory function to create a KyselyDatabaseAdapter instance with the given Kysely executor
 * and optional table name mapping.
-* 
+*
 * @param db        The Kysely executor to be used by the adapter.
 * @param mapping   Optional table name mapping for the adapter.
-* @returns         A new instance of KyselyDatabaseAdapter.   
+* @returns         A new instance of KyselyDatabaseAdapter.
 */
 const createKyselyAdapter = (db, mapping = {}) => {
 	return new KyselyDatabaseAdapter(db, mapping);
@@ -1602,7 +1602,7 @@ function createPrismaDelegateMap(prisma, mapping = {}) {
 }
 /**
 * Infer the Prisma delegate name for a given model name using a simple convention.
-* 
+*
 * @param modelName The name of the model to infer the delegate name for.
 * @returns The inferred Prisma delegate name.
 */
@@ -1613,9 +1613,9 @@ function inferDelegateName(modelName) {
 //#endregion
 //#region src/adapters/PrismaDatabaseAdapter.ts
 /**
-* Database adapter implementation for Prisma, allowing Arkorm to execute queries using Prisma 
+* Database adapter implementation for Prisma, allowing Arkorm to execute queries using Prisma
 * as the underlying query builder and executor.
-* 
+*
 * @author Legacy (3m1n3nc3)
 * @since 2.0.0-next.0
 */
@@ -1884,9 +1884,9 @@ var PrismaDatabaseAdapter = class PrismaDatabaseAdapter {
 	* Prisma include/select arguments, but the adapter does not advertise the
 	* adapter-owned batch relation load seam. QueryBuilder eager loads therefore stay
 	* on Arkorm's generic relation loader on the Prisma compatibility path.
-	* 
-	* @param spec 
-	* @returns 
+	*
+	* @param spec
+	* @returns
 	*/
 	async select(spec) {
 		const delegate = this.resolveDelegate(spec.target);
@@ -1896,10 +1896,10 @@ var PrismaDatabaseAdapter = class PrismaDatabaseAdapter {
 		}, { args });
 	}
 	/**
-	* Selects a single record matching the specified criteria. 
-	* 
-	* @param spec 
-	* @returns 
+	* Selects a single record matching the specified criteria.
+	*
+	* @param spec
+	* @returns
 	*/
 	async selectOne(spec) {
 		const delegate = this.resolveDelegate(spec.target);
@@ -1910,9 +1910,9 @@ var PrismaDatabaseAdapter = class PrismaDatabaseAdapter {
 	}
 	/**
 	* Inserts a single record into the database and returns the created record.
-	* 
-	* @param spec 
-	* @returns 
+	*
+	* @param spec
+	* @returns
 	*/
 	async insert(spec) {
 		const delegate = this.resolveDelegate(spec.target);
@@ -1921,10 +1921,10 @@ var PrismaDatabaseAdapter = class PrismaDatabaseAdapter {
 		}, { values: spec.values });
 	}
 	/**
-	* Inserts multiple records into the database. 
-	* 
-	* @param spec 
-	* @returns 
+	* Inserts multiple records into the database.
+	*
+	* @param spec
+	* @returns
 	*/
 	async insertMany(spec) {
 		const delegate = this.resolveDelegate(spec.target);
@@ -1953,9 +1953,9 @@ var PrismaDatabaseAdapter = class PrismaDatabaseAdapter {
 	}
 	/**
 	* Updates a single record matching the specified criteria and returns the updated record.
-	* 
-	* @param spec 
-	* @returns 
+	*
+	* @param spec
+	* @returns
 	*/
 	async update(spec) {
 		const delegate = this.resolveDelegate(spec.target);
@@ -1972,10 +1972,10 @@ var PrismaDatabaseAdapter = class PrismaDatabaseAdapter {
 		});
 	}
 	/**
-	* Updates multiple records matching the specified criteria. 
-	* 
-	* @param spec 
-	* @returns 
+	* Updates multiple records matching the specified criteria.
+	*
+	* @param spec
+	* @returns
 	*/
 	async updateMany(spec) {
 		const delegate = this.resolveDelegate(spec.target);
@@ -2005,9 +2005,9 @@ var PrismaDatabaseAdapter = class PrismaDatabaseAdapter {
 	}
 	/**
 	* Deletes a single record matching the specified criteria and returns the deleted record.
-	* 
-	* @param spec 
-	* @returns 
+	*
+	* @param spec
+	* @returns
 	*/
 	async delete(spec) {
 		const delegate = this.resolveDelegate(spec.target);
@@ -2018,10 +2018,10 @@ var PrismaDatabaseAdapter = class PrismaDatabaseAdapter {
 		}, { where });
 	}
 	/**
-	* Deletes multiple records matching the specified criteria. 
-	* 
-	* @param spec 
-	* @returns 
+	* Deletes multiple records matching the specified criteria.
+	*
+	* @param spec
+	* @returns
 	*/
 	async deleteMany(spec) {
 		const delegate = this.resolveDelegate(spec.target);
@@ -2036,9 +2036,9 @@ var PrismaDatabaseAdapter = class PrismaDatabaseAdapter {
 	}
 	/**
 	* Counts the number of records matching the specified criteria.
-	* 
-	* @param spec 
-	* @returns 
+	*
+	* @param spec
+	* @returns
 	*/
 	async count(spec) {
 		const delegate = this.resolveDelegate(spec.target);
@@ -2049,9 +2049,9 @@ var PrismaDatabaseAdapter = class PrismaDatabaseAdapter {
 	}
 	/**
 	* Checks for the existence of records matching the specified criteria.
-	* 
-	* @param spec 
-	* @returns 
+	*
+	* @param spec
+	* @returns
 	*/
 	async exists(spec) {
 		return await this.selectOne({
@@ -2061,8 +2061,8 @@ var PrismaDatabaseAdapter = class PrismaDatabaseAdapter {
 	}
 	/**
 	* Loads related models for a batch of parent records based on the specified relation load plans.
-	* 
-	* @param _spec 
+	*
+	* @param _spec
 	*/
 	async loadRelations(_spec) {
 		throw new UnsupportedAdapterFeatureException("Adapter-owned relation batch loading is intentionally unavailable on the Prisma compatibility adapter; eager loading stays on Arkorm's generic loader for this path.", {
@@ -2071,12 +2071,12 @@ var PrismaDatabaseAdapter = class PrismaDatabaseAdapter {
 		});
 	}
 	/**
-	* Executes a series of database operations within a transaction. 
+	* Executes a series of database operations within a transaction.
 	* If the underlying Prisma client does not support transactions, an exception is thrown.
-	* 
-	* @param callback 
-	* @param context 
-	* @returns 
+	*
+	* @param callback
+	* @param context
+	* @returns
 	*/
 	async transaction(callback, context = {}) {
 		if (!this.hasTransactionSupport(this.prisma)) throw new UnsupportedAdapterFeatureException("Transactions are not supported by the Prisma compatibility adapter.", {
@@ -2093,9 +2093,9 @@ var PrismaDatabaseAdapter = class PrismaDatabaseAdapter {
 	}
 };
 /**
-* Factory function to create a PrismaDatabaseAdapter instance with the given 
+* Factory function to create a PrismaDatabaseAdapter instance with the given
 * Prisma client and optional delegate name mapping.
-* 
+*
 * @param prisma    The Prisma client instance to be used by the adapter.
 * @param mapping   Optional mapping of delegate names.
 * @returns         A new instance of PrismaDatabaseAdapter.
@@ -2104,9 +2104,9 @@ const createPrismaDatabaseAdapter = (prisma, mapping = {}) => {
 	return new PrismaDatabaseAdapter(prisma, mapping);
 };
 /**
-* Alias for createPrismaDatabaseAdapter to maintain backward compatibility with 
+* Alias for createPrismaDatabaseAdapter to maintain backward compatibility with
 * previous versions of Arkorm that exported the adapter factory under a different name.
-* 
+*
 * @param prisma    The Prisma client instance to be used by the adapter.
 * @param mapping   Optional mapping of delegate names.
 * @returns         A new instance of PrismaDatabaseAdapter.
@@ -2136,10 +2136,10 @@ var Arkorm = class Arkorm {
 	}
 	/**
 	* Configure the ArkORM runtime with the provided runtime client resolver and adapter-first options.
-	* 
-	* @param client 
-	* @param options 
-	* @returns 
+	*
+	* @param client
+	* @param options
+	* @returns
 	*/
 	static configure(options, client) {
 		return configureArkormRuntime(client, options);
@@ -2156,113 +2156,113 @@ var Arkorm = class Arkorm {
 	}
 	/**
 	* Register migration constructors directly without relying on runtime discovery.
-	* 
-	* @param migrations 
-	* @returns 
+	*
+	* @param migrations
+	* @returns
 	*/
 	static registerMigrations(...migrations) {
 		return registerMigrations(...migrations);
 	}
 	/**
 	* Register seeder constructors directly without relying on runtime discovery.
-	* 
-	* @param seeders 
-	* @returns 
+	*
+	* @param seeders
+	* @returns
 	*/
 	static registerSeeders(...seeders) {
 		return registerSeeders(...seeders);
 	}
 	/**
 	* Register model constructors directly without relying on runtime discovery.
-	* 
-	* @param models 
-	* @returns 
+	*
+	* @param models
+	* @returns
 	*/
 	static registerModels(...models) {
 		return registerModels(...models);
 	}
 	/**
 	* Register factory constructors or instances directly without relying on runtime discovery.
-	* 
-	* @param factories 
-	* @returns 
+	*
+	* @param factories
+	* @returns
 	*/
 	static registerFactories(...factories) {
 		return registerFactories(...factories);
 	}
 	/**
 	* Register additional runtime discovery paths for models without replacing configured paths.
-	* 
-	* @param paths 
-	* @returns 
+	*
+	* @param paths
+	* @returns
 	*/
 	static loadModelsFrom(paths) {
 		return loadModelsFrom(paths);
 	}
 	/**
 	* Register additional runtime discovery paths for seeders without replacing configured paths.
-	* 
-	* @param paths 
-	* @returns 
+	*
+	* @param paths
+	* @returns
 	*/
 	static loadSeedersFrom(paths) {
 		return loadSeedersFrom(paths);
 	}
 	/**
 	* Register additional runtime discovery paths for migrations without replacing configured paths.
-	* 
-	* @param paths 
-	* @returns 
+	*
+	* @param paths
+	* @returns
 	*/
 	static loadMigrationsFrom(paths) {
 		return loadMigrationsFrom(paths);
 	}
 	/**
 	* Register additional runtime discovery paths for factories without replacing configured paths.
-	* 
-	* @param paths 
-	* @returns 
+	*
+	* @param paths
+	* @returns
 	*/
 	static loadFactoriesFrom(paths) {
 		return loadFactoriesFrom(paths);
 	}
 	/**
 	* Get registered runtime discovery paths or registered constructors for a specific type.
-	* 
-	* @param key 
-	* @returns 
+	*
+	* @param key
+	* @returns
 	*/
 	static getRegisteredPaths(key) {
 		return getRegisteredPaths(key);
 	}
 	/**
 	* Get registered migration constructors instances
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	static getRegisteredMigrations() {
 		return getRegisteredMigrations();
 	}
 	/**
 	* Get registered seeder constructors instances.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	static getRegisteredSeeders() {
 		return getRegisteredSeeders();
 	}
 	/**
 	* Get registered model constructors instances.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	static getRegisteredModels() {
 		return getRegisteredModels();
 	}
 	/**
 	* Get registered factory constructors or instances.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	static getRegisteredFactories() {
 		return getRegisteredFactories();
@@ -2390,12 +2390,12 @@ var CliApp = class {
 		return relPath;
 	}
 	/**
-	* Utility to format a value for logging, converting absolute paths under current 
+	* Utility to format a value for logging, converting absolute paths under current
 	* working directory into relative display paths.
-	* 
-	* @param name 
-	* @param value 
-	* @returns 
+	*
+	* @param name
+	* @param value
+	* @returns
 	*/
 	splitLogger(name, value) {
 		value = value.includes(process.cwd()) ? this.formatPathForLog(value) : value;
@@ -2484,7 +2484,7 @@ var CliApp = class {
 	}
 	/**
 	* Resolve a configuration path with a fallback default
-	* 
+	*
 	* @param key The configuration key to resolve
 	* @param fallback The fallback value if the configuration key is not set
 	* @returns The resolved configuration path
@@ -2496,19 +2496,19 @@ var CliApp = class {
 	}
 	/**
 	* Resolve the path to a stub file based on configuration
-	* 
-	* @param stubName 
-	* @returns 
+	*
+	* @param stubName
+	* @returns
 	*/
 	resolveStubPath(stubName) {
 		return join$1(this.resolveConfigPath("stubs", getDefaultStubsPath()), stubName);
 	}
 	/**
 	* Generate a factory file for a given model name.
-	* 
-	* @param name 
-	* @param options 
-	* @returns 
+	*
+	* @param name
+	* @param options
+	* @returns
 	*/
 	makeFactory(name, options = {}) {
 		const baseName = str(name.replace(/Factory$/, "")).pascal();
@@ -2530,10 +2530,10 @@ var CliApp = class {
 	}
 	/**
 	* Generate a seeder file for a given name.
-	* 
-	* @param name 
-	* @param options 
-	* @returns 
+	*
+	* @param name
+	* @param options
+	* @returns
 	*/
 	makeSeeder(name, options = {}) {
 		const seederName = `${str(name.replace(/Seeder$/, "")).pascal()}Seeder`;
@@ -2547,7 +2547,7 @@ var CliApp = class {
 	}
 	/**
 	* Generate a migration file for a given name.
-	* 
+	*
 	* @param name The name of the migration.
 	* @returns An object containing the name and path of the generated migration file.
 	*/
@@ -2563,10 +2563,10 @@ var CliApp = class {
 	}
 	/**
 	* Generate a model file along with optional factory, seeder, and migration files.
-	* 
-	* @param name 
-	* @param options 
-	* @returns 
+	*
+	* @param name
+	* @param options
+	* @returns
 	*/
 	makeModel(name, options = {}) {
 		const baseName = str(name.replace(/Model$/, "")).pascal().toString();
@@ -2610,10 +2610,10 @@ var CliApp = class {
 		return created;
 	}
 	/**
-	* Ensure that the Prisma schema has a model entry for the given model 
+	* Ensure that the Prisma schema has a model entry for the given model
 	* and table names.
 	* If the entry does not exist, it will be created with a default `id` field.
-	* 
+	*
 	* @param modelName The name of the model to ensure in the Prisma schema.
 	* @param tableName The table name to ensure in the Prisma schema.
 	*/
@@ -2645,7 +2645,7 @@ var CliApp = class {
 	}
 	/**
 	* Convert a Prisma scalar type to its corresponding TypeScript type.
-	* 
+	*
 	* @param value The Prisma scalar type.
 	* @returns     The corresponding TypeScript type.
 	*/
@@ -2938,9 +2938,9 @@ var CliApp = class {
 		return isList ? `Array<${baseType}>` : baseType;
 	}
 	/**
-	* Parse the Prisma schema to extract model definitions and their fields, focusing 
+	* Parse the Prisma schema to extract model definitions and their fields, focusing
 	* on scalar types.
-	* 
+	*
 	* @param schema    The Prisma schema as a string.
 	* @returns         An array of model definitions with their fields.
 	*/
@@ -2988,11 +2988,11 @@ var CliApp = class {
 		return models;
 	}
 	/**
-	* Sync model attribute declarations in a model file based on the 
+	* Sync model attribute declarations in a model file based on the
 	* provided declarations.
-	* This method takes the source code of a model file and a list of 
+	* This method takes the source code of a model file and a list of
 	* attribute declarations,
-	* 
+	*
 	* @param modelSource   The source code of the model file.
 	* @param declarations  A list of attribute declarations to sync.
 	* @returns An object containing the updated content and a flag indicating if it was updated.
@@ -3088,12 +3088,12 @@ var CliApp = class {
 	}
 	/**
 	* Sync model attribute declarations in model files based on the Prisma schema.
-	* This method reads the Prisma schema to extract model definitions and their 
-	* scalar fields, then updates the corresponding model files to include `declare` 
+	* This method reads the Prisma schema to extract model definitions and their
+	* scalar fields, then updates the corresponding model files to include `declare`
 	* statements for these fields. It returns an object containing the paths of the
-	* schema and models, the total number of model files processed, and lists of 
+	* schema and models, the total number of model files processed, and lists of
 	* updated and skipped files.
-	* 
+	*
 	* @param options Optional parameters to specify custom paths for the Prisma schema and models directory.
 	* @returns An object with details about the synchronization process, including updated and skipped files.
 	*/
@@ -3124,7 +3124,7 @@ var CliApp = class {
 //#endregion
 //#region src/cli/commands/InitCommand.ts
 /**
-* The InitCommand class implements the CLI command for initializing Arkormˣ by creating 
+* The InitCommand class implements the CLI command for initializing Arkormˣ by creating
 * a default config file in the current directory.
 *
 * @author Legacy (3m1n3nc3)
@@ -3183,8 +3183,8 @@ var MakeFactoryCommand = class extends Command {
 	}
 	/**
 	* Command handler for the make:factory command.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	async handle() {
 		this.app.command = this;
@@ -3213,8 +3213,8 @@ var MakeMigrationCommand = class extends Command {
 	}
 	/**
 	* Command handler for the make:migration command.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	async handle() {
 		this.app.command = this;
@@ -3228,7 +3228,7 @@ var MakeMigrationCommand = class extends Command {
 //#endregion
 //#region src/cli/commands/MakeModelCommand.ts
 /**
-* The MakeModelCommand class implements the CLI command for creating new model 
+* The MakeModelCommand class implements the CLI command for creating new model
 * classes along with optional linked resources such as factories, seeders, and migrations.
 *
 * @author Legacy (3m1n3nc3)
@@ -3250,8 +3250,8 @@ var MakeModelCommand = class extends Command {
 	}
 	/**
 	* Command handler for the make:model command.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	async handle() {
 		this.app.command = this;
@@ -3301,8 +3301,8 @@ var MakeSeederCommand = class extends Command {
 //#region src/database/Migration.ts
 const MIGRATION_BRAND = Symbol.for("arkormx.migration");
 /**
-* The Migration class serves as a base for defining database migrations, requiring 
-* the implementation of `up` and `down` methods to specify the changes to be 
+* The Migration class serves as a base for defining database migrations, requiring
+* the implementation of `up` and `down` methods to specify the changes to be
 * applied or reverted in the database schema.
 *
 * @author Legacy (3m1n3nc3)
@@ -3317,7 +3317,7 @@ var Migration = class {
 //#endregion
 //#region src/cli/commands/MigrateCommand.ts
 /**
-* The MigrateCommand class implements the CLI command for applying migration 
+* The MigrateCommand class implements the CLI command for applying migration
 * classes to the Prisma schema and running the Prisma workflow.
 *
 * @author Legacy (3m1n3nc3)
@@ -3341,12 +3341,12 @@ var MigrateCommand = class extends Command {
 	}
 	/**
 	* Command handler for the migrate command.
-	* This method is responsible for orchestrating the migration 
-	* process, including loading migration classes, applying them to 
-	* the Prisma schema, and running the appropriate Prisma commands 
+	* This method is responsible for orchestrating the migration
+	* process, including loading migration classes, applying them to
+	* the Prisma schema, and running the appropriate Prisma commands
 	* based on the provided options.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	async handle() {
 		this.app.command = this;
@@ -3461,10 +3461,10 @@ var MigrateCommand = class extends Command {
 	}
 	/**
 	* Load migration classes from a specific file or by class name.
-	* 
-	* @param migrationsDir 
-	* @param name 
-	* @returns 
+	*
+	* @param migrationsDir
+	* @param name
+	* @returns
 	*/
 	async loadNamedMigration(migrationsDirs, name) {
 		if (!name) return [[void 0, ""]];
@@ -3487,9 +3487,9 @@ var MigrateCommand = class extends Command {
 	}
 	/**
 	* Load migration classes from a given file path.
-	* 
-	* @param filePath 
-	* @returns 
+	*
+	* @param filePath
+	* @returns
 	*/
 	async loadMigrationClassesFromFile(filePath) {
 		const imported = await RuntimeModuleLoader.load(filePath);
@@ -3908,7 +3908,7 @@ var ModelsSyncCommand = class extends Command {
 //#region src/database/Seeder.ts
 const SEEDER_BRAND = Symbol.for("arkormx.seeder");
 /**
-* The Seeder class serves as a base for defining database seeders, which are 
+* The Seeder class serves as a base for defining database seeders, which are
 * used to populate the database with initial or test data.
 *
 * @author Legacy (3m1n3nc3)
@@ -3923,7 +3923,7 @@ var Seeder = class Seeder {
 	}
 	/**
 	* Runs one or more seeders.
-	* 
+	*
 	* @param seeders   The seeders to be run.
 	*/
 	async call(...seeders) {
@@ -3931,9 +3931,9 @@ var Seeder = class Seeder {
 	}
 	/**
 	* Run seeders and return every seeder class executed, including nested calls.
-	* 
-	* @param seeders 
-	* @returns 
+	*
+	* @param seeders
+	* @returns
 	*/
 	static async runWithReport(...seeders) {
 		const report = [];
@@ -3943,8 +3943,8 @@ var Seeder = class Seeder {
 		return report;
 	}
 	/**
-	* Converts a SeederInput into a Seeder instance. 
-	* 
+	* Converts a SeederInput into a Seeder instance.
+	*
 	* @param input     The SeederInput to convert.
 	* @returns         A Seeder instance.
 	*/
@@ -3957,7 +3957,7 @@ var Seeder = class Seeder {
 	}
 	/**
 	* Runs the given seeders in sequence.
-	* 
+	*
 	* @param seeders   The seeders to be run.
 	*/
 	static async runSeeders(...seeders) {
@@ -3977,7 +3977,7 @@ var Seeder = class Seeder {
 //#endregion
 //#region src/cli/commands/SeedCommand.ts
 /**
-* The SeedCommand class implements the CLI command for running seeder classes. 
+* The SeedCommand class implements the CLI command for running seeder classes.
 *
 * @author Legacy (3m1n3nc3)
 * @since 0.1.0
@@ -3993,8 +3993,8 @@ var SeedCommand = class extends Command {
 	}
 	/**
 	* Command handler for the seed command.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	async handle() {
 		this.app.command = this;
@@ -4010,9 +4010,9 @@ var SeedCommand = class extends Command {
 	}
 	/**
 	* Load all seeder classes from the specified directory.
-	* 
-	* @param seedersDir 
-	* @returns 
+	*
+	* @param seedersDir
+	* @returns
 	*/
 	resolveSeederDirectories(configuredSeedersDir) {
 		return [this.app.resolveRuntimeDirectoryPath(configuredSeedersDir), ...getRegisteredPaths("seeders").map((directory) => this.app.resolveRuntimeDirectoryPath(directory))].filter((directory, index, all) => existsSync$1(directory) && all.indexOf(directory) === index);
@@ -4023,10 +4023,10 @@ var SeedCommand = class extends Command {
 	}
 	/**
 	* Load seeder classes from a specific file or by class name.
-	* 
-	* @param seedersDir 
-	* @param name 
-	* @returns 
+	*
+	* @param seedersDir
+	* @param name
+	* @returns
 	*/
 	async loadNamedSeeder(seedersDirs, name) {
 		const base = name.replace(/Seeder$/, "");
@@ -4048,7 +4048,7 @@ var SeedCommand = class extends Command {
 	}
 	/**
 	* Load seeder classes from a given file path.
-	* 
+	*
 	* @param filePath The path to the file containing seeder classes.
 	* @returns An array of seeder classes.
 	*/
@@ -4314,9 +4314,9 @@ var JoinClause = class JoinClause {
 //#endregion
 //#region src/Exceptions/ModelNotFoundException.ts
 /**
-* The ModelNotFoundException class is a custom error type for handling 
-* cases where a requested model instance cannot be found in the database. 
-* 
+* The ModelNotFoundException class is a custom error type for handling
+* cases where a requested model instance cannot be found in the database.
+*
 * @author Legacy (3m1n3nc3)
 * @since 0.1.0
 */
@@ -4374,9 +4374,9 @@ var UniqueConstraintResolutionException = class extends ArkormException {
 //#endregion
 //#region src/QueryBuilder.ts
 /**
-* The QueryBuilder class provides a fluent interface for building and 
+* The QueryBuilder class provides a fluent interface for building and
 * executing database queries.
-* 
+*
 * @template TModel The type of the model being queried.
 * @author Legacy (3m1n3nc3)
 * @since 0.1.0
@@ -4384,8 +4384,8 @@ var UniqueConstraintResolutionException = class extends ArkormException {
 var QueryBuilder = class QueryBuilder {
 	/**
 	* Creates a new QueryBuilder instance.
-	* 
-	* @param model 
+	*
+	* @param model
 	*/
 	constructor(model, adapter) {
 		this.model = model;
@@ -4563,45 +4563,45 @@ var QueryBuilder = class QueryBuilder {
 	}
 	/**
 	* Adds clause to determine if a column's value is in the past
-	* 
-	* @param key 
-	* @returns 
+	*
+	* @param key
+	* @returns
 	*/
 	wherePast(key) {
 		return this.where({ [key]: { lt: /* @__PURE__ */ new Date() } });
 	}
 	/**
 	* Adds clause to determine if a column's value is in the future
-	* 
-	* @param key 
-	* @returns 
+	*
+	* @param key
+	* @returns
 	*/
 	whereFuture(key) {
 		return this.where({ [key]: { gt: /* @__PURE__ */ new Date() } });
 	}
 	/**
 	* Adds clause to determine if a column's value is in the past, inclusive of the current date and time
-	* 
-	* @param key 
-	* @returns 
+	*
+	* @param key
+	* @returns
 	*/
 	whereNowOrPast(key) {
 		return this.where({ [key]: { lte: /* @__PURE__ */ new Date() } });
 	}
 	/**
 	* Adds clause to determine if a column's value is in the future, inclusive of the current date and time
-	* 
-	* @param key 
-	* @returns 
+	*
+	* @param key
+	* @returns
 	*/
 	whereNowOrFuture(key) {
 		return this.where({ [key]: { gte: /* @__PURE__ */ new Date() } });
 	}
 	/**
 	* Adds clause to determine if a column's value is today
-	* 
-	* @param key 
-	* @returns 
+	*
+	* @param key
+	* @returns
 	*/
 	whereToday(key) {
 		const [start, end] = this.getUtcDayBounds();
@@ -4612,9 +4612,9 @@ var QueryBuilder = class QueryBuilder {
 	}
 	/**
 	* Adds clause to determine if a column's value is before today
-	* 
-	* @param key 
-	* @returns 
+	*
+	* @param key
+	* @returns
 	*/
 	whereBeforeToday(key) {
 		const [start] = this.getUtcDayBounds();
@@ -4622,9 +4622,9 @@ var QueryBuilder = class QueryBuilder {
 	}
 	/**
 	* Adds clause to determine if a column's value is after today
-	* 
-	* @param key 
-	* @returns 
+	*
+	* @param key
+	* @returns
 	*/
 	whereAfterToday(key) {
 		const [, end] = this.getUtcDayBounds();
@@ -4632,9 +4632,9 @@ var QueryBuilder = class QueryBuilder {
 	}
 	/**
 	* Adds clause to determine if a column's value is today or before today
-	* 
-	* @param key 
-	* @returns 
+	*
+	* @param key
+	* @returns
 	*/
 	whereTodayOrBefore(key) {
 		const [, end] = this.getUtcDayBounds();
@@ -4642,9 +4642,9 @@ var QueryBuilder = class QueryBuilder {
 	}
 	/**
 	* Adds clause to determine if a column's value is today or after today
-	* 
-	* @param key 
-	* @returns 
+	*
+	* @param key
+	* @returns
 	*/
 	whereTodayOrAfter(key) {
 		const [start] = this.getUtcDayBounds();
@@ -4661,9 +4661,9 @@ var QueryBuilder = class QueryBuilder {
 	}
 	/**
 	* Adds "where exists" SQL clauses.
-	* 
-	* @param queryOrCallback 
-	* @returns 
+	*
+	* @param queryOrCallback
+	* @returns
 	*/
 	whereExists(queryOrCallback) {
 		const baseQuery = new QueryBuilder(this.model, this.adapter);
@@ -4803,12 +4803,12 @@ var QueryBuilder = class QueryBuilder {
 	/**
 	* Append a structured JSON predicate, splitting a `column->path->key`
 	* expression into its base column and nested path segments.
-	* 
-	* @param boolean 
-	* @param kind 
-	* @param column 
-	* @param options 
-	* @returns 
+	*
+	* @param boolean
+	* @param kind
+	* @param column
+	* @param options
+	* @returns
 	*/
 	appendJsonCondition(boolean, kind, column, options = {}) {
 		const [base, ...path] = column.split("->").map((segment) => segment.trim());
@@ -4837,10 +4837,10 @@ var QueryBuilder = class QueryBuilder {
 	}
 	/**
 	* OR variant of whereJsonContains().
-	* 
-	* @param column 
-	* @param value 
-	* @returns 
+	*
+	* @param column
+	* @param value
+	* @returns
 	*/
 	orWhereJsonContains(column, value) {
 		return this.appendJsonCondition("OR", "contains", column, { value });
@@ -4860,10 +4860,10 @@ var QueryBuilder = class QueryBuilder {
 	}
 	/**
 	* OR variant of whereJsonDoesntContain().
-	* 
-	* @param column 
-	* @param value 
-	* @returns 
+	*
+	* @param column
+	* @param value
+	* @returns
 	*/
 	orWhereJsonDoesntContain(column, value) {
 		return this.appendJsonCondition("OR", "contains", column, {
@@ -4882,9 +4882,9 @@ var QueryBuilder = class QueryBuilder {
 	}
 	/**
 	* OR variant of whereJsonContainsKey().
-	* 
-	* @param column 
-	* @returns 
+	*
+	* @param column
+	* @returns
 	*/
 	orWhereJsonContainsKey(column) {
 		return this.appendJsonCondition("OR", "contains-key", column);
@@ -4900,9 +4900,9 @@ var QueryBuilder = class QueryBuilder {
 	}
 	/**
 	* OR variant of whereJsonDoesntContainKey().
-	* 
-	* @param column 
-	* @returns 
+	*
+	* @param column
+	* @returns
 	*/
 	orWhereJsonDoesntContainKey(column) {
 		return this.appendJsonCondition("OR", "contains-key", column, { not: true });
@@ -4944,10 +4944,10 @@ var QueryBuilder = class QueryBuilder {
 	}
 	/**
 	* OR variant of whereJsonOverlaps().
-	* 
-	* @param column 
-	* @param value 
-	* @returns 
+	*
+	* @param column
+	* @param value
+	* @returns
 	*/
 	orWhereJsonOverlaps(column, value) {
 		return this.appendJsonCondition("OR", "overlaps", column, { value });
@@ -5065,9 +5065,9 @@ var QueryBuilder = class QueryBuilder {
 	}
 	/**
 	* Adds an orderBy clause to the query. This will overwrite any existing orderBy clause.
-	* 
-	* @param orderBy 
-	* @returns 
+	*
+	* @param orderBy
+	* @returns
 	*/
 	orderBy(orderBy) {
 		this.randomOrderEnabled = false;
@@ -5121,9 +5121,9 @@ var QueryBuilder = class QueryBuilder {
 	}
 	/**
 	* Adds an include clause to the query. This will overwrite any existing include clause.
-	* 
-	* @param include 
-	* @returns 
+	*
+	* @param include
+	* @returns
 	*/
 	include(include) {
 		const normalized = this.normalizeRelationLoads(include);
@@ -5136,11 +5136,11 @@ var QueryBuilder = class QueryBuilder {
 		return this;
 	}
 	/**
-	* Adds eager loading for the specified relations. 
+	* Adds eager loading for the specified relations.
 	* This will merge with any existing include clause.
-	* 
-	* @param relations 
-	* @returns 
+	*
+	* @param relations
+	* @returns
 	*/
 	with(relations) {
 		const relationMap = this.normalizeWith(relations);
@@ -5342,10 +5342,10 @@ var QueryBuilder = class QueryBuilder {
 		return this.withRelationAggregate("max", relation, column);
 	}
 	/**
-	* Includes soft-deleted records in the query results. 
+	* Includes soft-deleted records in the query results.
 	* This method is only applicable if the model has soft delete enabled.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	withTrashed() {
 		this.includeTrashed = true;
@@ -5353,10 +5353,10 @@ var QueryBuilder = class QueryBuilder {
 		return this;
 	}
 	/**
-	* Limits the query results to only soft-deleted records. 
+	* Limits the query results to only soft-deleted records.
 	* This method is only applicable if the model has soft delete enabled.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	onlyTrashed() {
 		this.onlyTrashedRecords = true;
@@ -5364,11 +5364,11 @@ var QueryBuilder = class QueryBuilder {
 		return this;
 	}
 	/**
-	* Excludes soft-deleted records from the query results. 
-	* This is the default behavior, but this method can be used to explicitly 
+	* Excludes soft-deleted records from the query results.
+	* This is the default behavior, but this method can be used to explicitly
 	* enforce it after using withTrashed or onlyTrashed.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	withoutTrashed() {
 		this.includeTrashed = false;
@@ -5377,14 +5377,14 @@ var QueryBuilder = class QueryBuilder {
 	}
 	/**
 	* Applies a named scope to the query. A scope is a reusable query constraint
-	* defined as a static method on the model. The scope method will look for a 
-	* method with the name `scope{Name}` on the model's prototype. 
-	* If found, it will call that method with the current query builder 
+	* defined as a static method on the model. The scope method will look for a
+	* method with the name `scope{Name}` on the model's prototype.
+	* If found, it will call that method with the current query builder
 	* instance and any additional arguments provided.
-	* 
-	* @param name 
-	* @param args 
-	* @returns 
+	*
+	* @param name
+	* @param args
+	* @returns
 	*/
 	scope(name, ...args) {
 		const methodName = `scope${name.charAt(0).toUpperCase()}${name.slice(1)}`;
@@ -5447,9 +5447,9 @@ var QueryBuilder = class QueryBuilder {
 	}
 	/**
 	* Adds a select clause to the query. This will overwrite any existing select clause.
-	* 
-	* @param select 
-	* @returns 
+	*
+	* @param select
+	* @returns
 	*/
 	select(select) {
 		const normalized = this.normalizeQuerySelect(select);
@@ -5800,9 +5800,9 @@ var QueryBuilder = class QueryBuilder {
 	/**
 	* Adds a skip clause to the query for pagination.
 	* This will overwrite any existing skip clause.
-	* 
-	* @param skip 
-	* @returns 
+	*
+	* @param skip
+	* @returns
 	*/
 	skip(skip) {
 		this.offsetValue = skip;
@@ -5819,9 +5819,9 @@ var QueryBuilder = class QueryBuilder {
 	}
 	/**
 	* Adds a take clause to the query for pagination.
-	* 
-	* @param take 
-	* @returns 
+	*
+	* @param take
+	* @returns
 	*/
 	take(take) {
 		this.limitValue = take;
@@ -5838,9 +5838,9 @@ var QueryBuilder = class QueryBuilder {
 	}
 	/**
 	* Returns a representation of the query that can be used for debugging or logging purposes.
-	* 
-	* @param operation 
-	* @returns 
+	*
+	* @param operation
+	* @returns
 	*/
 	inspect(operation = "select") {
 		const adapter = this.requireAdapter();
@@ -5887,8 +5887,8 @@ var QueryBuilder = class QueryBuilder {
 	}
 	/**
 	* Executes the query and returns the results as a collection of model instances.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	async get() {
 		const useAdapterRelationFeatures = this.canExecuteRelationFeaturesInAdapter();
@@ -5909,10 +5909,10 @@ var QueryBuilder = class QueryBuilder {
 		return new ArkormCollection(filteredModels);
 	}
 	/**
-	* Executes the query and returns the first result as a model 
+	* Executes the query and returns the first result as a model
 	* instance, or null if no results are found.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	async first() {
 		if (this.shouldUseCompatibilityRelationFallback()) return (await this.get()).all()[0] ?? null;
@@ -5933,8 +5933,8 @@ var QueryBuilder = class QueryBuilder {
 	}
 	/**
 	* Executes the query and returns the first result as a model instance.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	async firstOrFail() {
 		const model = await this.first();
@@ -6047,9 +6047,9 @@ var QueryBuilder = class QueryBuilder {
 	}
 	/**
 	* Creates a new record with the specified data and returns it as a model instance.
-	* 
-	* @param data 
-	* @returns 
+	*
+	* @param data
+	* @returns
 	*/
 	async create(data) {
 		const created = await this.executeInsertRow(data);
@@ -6135,11 +6135,11 @@ var QueryBuilder = class QueryBuilder {
 		return this.insertOrIgnore(rows);
 	}
 	/**
-	* Updates records matching the current query constraints with the 
+	* Updates records matching the current query constraints with the
 	* specified data and returns the updated record(s) as model instance(s).
-	* 
-	* @param data 
-	* @returns 
+	*
+	* @param data
+	* @returns
 	*/
 	async update(data) {
 		const where = this.buildWhere();
@@ -6254,8 +6254,8 @@ var QueryBuilder = class QueryBuilder {
 	/**
 	* Deletes the first record matching the current query constraints and returns
 	* it as a hydrated model instance. Returns null when no record matches.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	async delete() {
 		const where = this.buildWhere();
@@ -6353,8 +6353,8 @@ var QueryBuilder = class QueryBuilder {
 	}
 	/**
 	* Counts the number of records matching the current query constraints.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	async count() {
 		if (this.hasRelationFilters() && this.shouldUseCompatibilityRelationFallback()) return (await this.get()).all().length;
@@ -6392,15 +6392,24 @@ var QueryBuilder = class QueryBuilder {
 				if (nextPayload[column.column] !== void 0 && nextPayload[column.column] !== null) continue;
 				if (column.default === "now()" || column.updatedAt) nextPayload[column.column] = now;
 			}
-			return nextPayload;
+			return this.castForPersistence(nextPayload);
 		});
 	}
+	/**
+	* Apply the model's persistence casts when a real model backs the query.
+	*
+	* @param payload
+	* @returns
+	*/
+	castForPersistence(payload) {
+		return typeof this.model.castAttributesForPersistence === "function" ? this.model.castAttributesForPersistence(payload) : payload;
+	}
 	normalizeUpdatePayload(values) {
 		const metadata = this.model.getModelMetadata();
 		const nextPayload = { ...values };
 		const now = /* @__PURE__ */ new Date();
 		for (const column of metadata.timestampColumns ?? []) if (column.updatedAt) nextPayload[column.column] = now;
-		return nextPayload;
+		return this.castForPersistence(nextPayload);
 	}
 	resolveAffectedCount(result, fallback) {
 		if (typeof result === "number") return result;
@@ -6552,13 +6561,13 @@ var QueryBuilder = class QueryBuilder {
 		return this;
 	}
 	/**
-	* Paginates the query results and returns a LengthAwarePaginator instance 
+	* Paginates the query results and returns a LengthAwarePaginator instance
 	* containing data and total-aware pagination metadata.
-	* 
-	* @param page 
-	* @param perPage 
+	*
+	* @param page
+	* @param perPage
 	* @param options
-	* @returns 
+	* @returns
 	*/
 	async paginate(perPage = 15, page = void 0, options = {}) {
 		const currentPage = this.resolvePaginationPage(page, options);
@@ -6596,8 +6605,8 @@ var QueryBuilder = class QueryBuilder {
 	}
 	/**
 	* Creates a clone of the current query builder instance with the same state.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	clone() {
 		const builder = new QueryBuilder(this.model, this.adapter);
@@ -6627,9 +6636,9 @@ var QueryBuilder = class QueryBuilder {
 	}
 	/**
 	* Normalizes the input for eager loading relations into a consistent format.
-	* 
-	* @param relations 
-	* @returns 
+	*
+	* @param relations
+	* @returns
 	*/
 	normalizeWith(relations) {
 		if (typeof relations === "string") return { [relations]: void 0 };
@@ -6818,7 +6827,7 @@ var QueryBuilder = class QueryBuilder {
 	}
 	/**
 	* Attempts to build relation load plans for the adapter based on the eager loads specified in the query builder.
-	* 
+	*
 	* @returns an array of RelationLoadPlan if successful, or null if the eager loads contain constraints that cannot be represented in a way compatible with adapter-based loading.
 	*/
 	tryBuildAdapterRelationLoadPlans() {
@@ -7286,10 +7295,10 @@ var QueryBuilder = class QueryBuilder {
 		return deleted;
 	}
 	/**
-	* Builds the where clause for the query, taking into account soft delete 
+	* Builds the where clause for the query, taking into account soft delete
 	* settings if applicable.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	buildWhere() {
 		const baseWhere = this.legacyWhere ?? this.toQuerySchemaWhere(this.queryWhere);
@@ -7302,14 +7311,14 @@ var QueryBuilder = class QueryBuilder {
 	}
 	/**
 	* Builds the arguments for the findMany delegate method, including the where clause.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	/**
-	* Resolves a unique where clause for update and delete operations. 
-	* 
-	* @param where 
-	* @returns 
+	* Resolves a unique where clause for update and delete operations.
+	*
+	* @param where
+	* @returns
 	*/
 	async resolveUniqueWhere(where, failIfMissing = true) {
 		if (this.isUniqueWhere(where)) return where;
@@ -7340,11 +7349,11 @@ var QueryBuilder = class QueryBuilder {
 		return { [primaryKey]: row[primaryKey] };
 	}
 	/**
-	* Checks if the provided where clause is already a unique 
+	* Checks if the provided where clause is already a unique
 	* identifier (i.e., contains only an 'id' field).
-	* 
-	* @param where 
-	* @returns 
+	*
+	* @param where
+	* @returns
 	*/
 	isUniqueWhere(where) {
 		const primaryKey = this.model.getPrimaryKey();
@@ -7614,10 +7623,10 @@ var QueryBuilder = class QueryBuilder {
 //#endregion
 //#region src/Model.ts
 /**
-* Base model class that all models should extend. 
-* 
+* Base model class that all models should extend.
+*
 * @template TModel The type of the model extending this base class.
-* 
+*
 * @author Legacy (3m1n3nc3)
 * @since 0.1.0
 */
@@ -7625,6 +7634,9 @@ var Model = class Model {
 	static {
 		this.lifecycleStates = /* @__PURE__ */ new WeakMap();
 	}
+	static {
+		this.castMapCache = /* @__PURE__ */ new WeakMap();
+	}
 	static {
 		this.emittedDeprecationWarnings = /* @__PURE__ */ new Set();
 	}
@@ -7763,6 +7775,31 @@ var Model = class Model {
 			timestampColumns: persistedMetadata.timestampColumns?.map((column) => ({ ...column }))
 		};
 	}
+	/**
+	* The model's cast map. Resolved from a throwaway instance (casts are an
+	* instance field) and cached per model class.
+	*/
+	static getCasts() {
+		const cached = Model.castMapCache.get(this);
+		if (cached) return cached;
+		const casts = { ...new this({}).casts };
+		Model.castMapCache.set(this, casts);
+		return casts;
+	}
+	/**
+	* Apply built-in persistence casts (currently `json` serialisation) to a raw
+	* attribute payload, without re-running arbitrary custom setters. Used by
+	* both instance `save()` and the query-builder insert/update paths so a JS
+	* object/array destined for a `json`/`jsonb` column is serialised to a string
+	* rather than bound as a Postgres array.
+	*/
+	static castAttributesForPersistence(attributes) {
+		const casts = this.getCasts();
+		return Object.entries(attributes).reduce((normalized, [key, value]) => {
+			normalized[key] = casts[key] === "json" ? resolveCast("json").set(value) : value;
+			return normalized;
+		}, {});
+	}
 	static getRelationMetadata(name) {
 		const resolver = this.prototype[name];
 		if (typeof resolver !== "function") return null;
@@ -7940,9 +7977,9 @@ var Model = class Model {
 	* If a delegate name is provided, it will attempt to resolve that delegate.
 	* Otherwise, it will attempt to resolve a compatibility schema based on the model's name or
 	* the static `delegate` property.
-	* 
-	* @param delegate 
-	* @returns 
+	*
+	* @param delegate
+	* @returns
 	*/
 	static getDelegate(delegate) {
 		Model.emitDeprecationWarning("ARKORM_GET_DELEGATE_DEPRECATED", "Model.getDelegate() is deprecated and will be removed in Arkorm 3.0. Use Model.getAdapter() and adapter-backed execution instead.");
@@ -7964,9 +8001,9 @@ var Model = class Model {
 	}
 	/**
 	* Get a new query builder instance for the model.
-	* 
-	* @param this 
-	* @returns 
+	*
+	* @param this
+	* @returns
 	*/
 	static query() {
 		Model.ensureModelBooted(this);
@@ -7992,31 +8029,31 @@ var Model = class Model {
 	static booted() {}
 	/**
 	* Get a query builder instance that includes soft-deleted records.
-	* 
-	* @param this 
-	* @returns 
+	*
+	* @param this
+	* @returns
 	*/
 	static withTrashed() {
 		return this.query().withTrashed();
 	}
 	/**
 	* Get a query builder instance that only includes soft-deleted records.
-	* 
-	* @param this 
-	* @returns 
+	*
+	* @param this
+	* @returns
 	*/
 	static onlyTrashed() {
 		return this.query().onlyTrashed();
 	}
 	/**
-	* Get a query builder instance that excludes soft-deleted records. 
-	* This is the default behavior of the query builder, but this method can be used 
+	* Get a query builder instance that excludes soft-deleted records.
+	* This is the default behavior of the query builder, but this method can be used
 	* to explicitly specify it after using `withTrashed` or `onlyTrashed`.
-	* 
-	* @param this 
-	* @param name 
-	* @param args 
-	* @returns 
+	*
+	* @param this
+	* @param name
+	* @param args
+	* @returns
 	*/
 	static scope(name, ...args) {
 		return this.query().scope(name, ...args);
@@ -8084,10 +8121,10 @@ var Model = class Model {
 		return deleted;
 	}
 	/**
-	* Get the soft delete configuration for the model, including whether 
+	* Get the soft delete configuration for the model, including whether
 	* soft deletes are enabled and the name of the deleted at column.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	static getSoftDeleteConfig() {
 		return {
@@ -8096,11 +8133,11 @@ var Model = class Model {
 		};
 	}
 	/**
-	* Hydrate a model instance from a plain object of attributes. 
-	* 
-	* @param this 
-	* @param attributes 
-	* @returns 
+	* Hydrate a model instance from a plain object of attributes.
+	*
+	* @param this
+	* @param attributes
+	* @returns
 	*/
 	static hydrate(attributes) {
 		const model = new this(attributes);
@@ -8111,10 +8148,10 @@ var Model = class Model {
 	}
 	/**
 	* Hydrate multiple model instances from an array of plain objects of attributes.
-	* 
-	* @param this 
-	* @param attributes 
-	* @returns 
+	*
+	* @param this
+	* @param attributes
+	* @returns
 	*/
 	static hydrateMany(attributes) {
 		const constructor = this;
@@ -8254,12 +8291,12 @@ var Model = class Model {
 		return await this.constructor.transaction(async () => await this.save());
 	}
 	/**
-	* Delete the model from the database. 
-	* If soft deletes are enabled, it will perform a soft delete by 
-	* setting the deleted at column to the current date. 
+	* Delete the model from the database.
+	* If soft deletes are enabled, it will perform a soft delete by
+	* setting the deleted at column to the current date.
 	* Otherwise, it will perform a hard delete.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	async delete() {
 		const constructor = this.constructor;
@@ -8303,10 +8340,10 @@ var Model = class Model {
 		return await this.constructor.transaction(async () => await this.delete());
 	}
 	/**
-	* Permanently delete the model from the database, regardless of whether soft 
+	* Permanently delete the model from the database, regardless of whether soft
 	* deletes are enabled.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	async forceDelete() {
 		const constructor = this.constructor;
@@ -8335,8 +8372,8 @@ var Model = class Model {
 	}
 	/**
 	* Restore a soft-deleted model by setting the deleted at column to null.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	async restore() {
 		const constructor = this.constructor;
@@ -8364,9 +8401,9 @@ var Model = class Model {
 	}
 	/**
 	* Load related models onto the current model instance.
-	* 
-	* @param relations 
-	* @returns 
+	*
+	* @param relations
+	* @returns
 	*/
 	async load(relations) {
 		const relationMap = this.normalizeRelationMap(relations);
@@ -8432,8 +8469,8 @@ var Model = class Model {
 	}
 	/**
 	* Get the raw attributes of the model without applying any mutators or casts.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	getRawAttributes() {
 		return { ...this.attributes };
@@ -8494,10 +8531,10 @@ var Model = class Model {
 		}, {});
 	}
 	/**
-	* Convert the model instance to a plain object, applying visibility 
+	* Convert the model instance to a plain object, applying visibility
 	* rules, appends, and mutators.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	toObject() {
 		const object = (this.visible.length > 0 ? this.visible : Object.keys(this.attributes).filter((key) => !this.hidden.includes(key))).reduce((accumulator, key) => {
@@ -8513,8 +8550,8 @@ var Model = class Model {
 	}
 	/**
 	* Convert the model instance to JSON by first converting it to a plain object.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	toJSON() {
 		return this.toObject();
@@ -8563,11 +8600,11 @@ var Model = class Model {
 	}
 	/**
 	* Define a has one relationship.
-	* 
-	* @param related 
-	* @param foreignKey 
-	* @param localKey 
-	* @returns 
+	*
+	* @param related
+	* @param foreignKey
+	* @param localKey
+	* @returns
 	*/
 	hasOne(related, foreignKey, localKey) {
 		const constructor = this.constructor;
@@ -8575,11 +8612,11 @@ var Model = class Model {
 	}
 	/**
 	* Define a has many relationship.
-	* 
-	* @param related 
-	* @param foreignKey 
-	* @param localKey 
-	* @returns 
+	*
+	* @param related
+	* @param foreignKey
+	* @param localKey
+	* @returns
 	*/
 	hasMany(related, foreignKey, localKey) {
 		const constructor = this.constructor;
@@ -8587,25 +8624,25 @@ var Model = class Model {
 	}
 	/**
 	* Define a belongs to relationship.
-	* 
-	* @param related 
-	* @param foreignKey 
-	* @param ownerKey 
-	* @returns 
+	*
+	* @param related
+	* @param foreignKey
+	* @param ownerKey
+	* @returns
 	*/
 	belongsTo(related, foreignKey, ownerKey) {
 		return new BelongsToRelation(this, related, foreignKey, ownerKey ?? related.getPrimaryKey());
 	}
 	/**
 	* Define a belongs to many relationship.
-	* 
-	* @param related 
+	*
+	* @param related
 	* @param throughTable
-	* @param foreignPivotKey 
-	* @param relatedPivotKey 
-	* @param parentKey 
-	* @param relatedKey 
-	* @returns 
+	* @param foreignPivotKey
+	* @param relatedPivotKey
+	* @param parentKey
+	* @param relatedKey
+	* @returns
 	*/
 	belongsToMany(related, throughTable, foreignPivotKey, relatedPivotKey, parentKey, relatedKey) {
 		const constructor = this.constructor;
@@ -8613,14 +8650,14 @@ var Model = class Model {
 	}
 	/**
 	* Define a has one through relationship.
-	* 
-	* @param related 
+	*
+	* @param related
 	* @param throughTable
-	* @param firstKey 
-	* @param secondKey 
-	* @param localKey 
-	* @param secondLocalKey 
-	* @returns 
+	* @param firstKey
+	* @param secondKey
+	* @param localKey
+	* @param secondLocalKey
+	* @returns
 	*/
 	hasOneThrough(related, throughTable, firstKey, secondKey, localKey, secondLocalKey = "id") {
 		const constructor = this.constructor;
@@ -8628,14 +8665,14 @@ var Model = class Model {
 	}
 	/**
 	* Define a has many through relationship.
-	* 
-	* @param related 
+	*
+	* @param related
 	* @param throughTable
-	* @param firstKey 
-	* @param secondKey 
-	* @param localKey 
-	* @param secondLocalKey 
-	* @returns 
+	* @param firstKey
+	* @param secondKey
+	* @param localKey
+	* @param secondLocalKey
+	* @returns
 	*/
 	hasManyThrough(related, throughTable, firstKey, secondKey, localKey, secondLocalKey = "id") {
 		const constructor = this.constructor;
@@ -8643,13 +8680,13 @@ var Model = class Model {
 	}
 	/**
 	* Define a polymorphic one to one relationship.
-	* 
-	* @param related 
+	*
+	* @param related
 	* @param morphName
 	* @param idColumn
 	* @param typeColumn
 	* @param localKey
-	* @returns 
+	* @returns
 	*/
 	morphOne(related, morphName, idColumn, typeColumn, localKey) {
 		const constructor = this.constructor;
@@ -8658,13 +8695,13 @@ var Model = class Model {
 	}
 	/**
 	* Define a polymorphic one to many relationship.
-	* 
-	* @param related 
+	*
+	* @param related
 	* @param morphName
 	* @param idColumn
 	* @param typeColumn
 	* @param localKey
-	* @returns 
+	* @returns
 	*/
 	morphMany(related, morphName, idColumn, typeColumn, localKey) {
 		const constructor = this.constructor;
@@ -8679,7 +8716,7 @@ var Model = class Model {
 	}
 	/**
 	* Define a polymorphic many to many relationship.
-	* 
+	*
 	* @param related
 	* @param morphName
 	* @param throughTable
@@ -8688,7 +8725,7 @@ var Model = class Model {
 	* @param relatedPivotKey
 	* @param parentKey
 	* @param relatedKey
-	* @returns 
+	* @returns
 	*/
 	morphToMany(related, morphName, throughTable, foreignPivotKey, morphTypeColumn, relatedPivotKey, parentKey, relatedKey) {
 		const constructor = this.constructor;
@@ -8716,9 +8753,9 @@ var Model = class Model {
 	}
 	/**
 	* Resolve a get mutator method for a given attribute key, if it exists.
-	* 
-	* @param key 
-	* @returns 
+	*
+	* @param key
+	* @returns
 	*/
 	resolveGetMutator(key) {
 		const methodName = `get${str(key).studly()}Attribute`;
@@ -8750,10 +8787,7 @@ var Model = class Model {
 	* @returns
 	*/
 	normalizePersistenceAttributes(attributes) {
-		return Object.entries(attributes).reduce((normalized, [key, value]) => {
-			normalized[key] = this.casts[key] === "json" ? resolveCast("json").set(value) : value;
-			return normalized;
-		}, {});
+		return this.constructor.castAttributesForPersistence(attributes);
 	}
 	/**
 	* Normalize a key or key list for dirty/change lookups.
@@ -8785,9 +8819,9 @@ var Model = class Model {
 	}
 	/**
 	* Resolve a set mutator method for a given attribute key, if it exists.
-	* 
-	* @param key 
-	* @returns 
+	*
+	* @param key
+	* @returns
 	*/
 	resolveSetMutator(key) {
 		const methodName = `set${str(key).studly()}Attribute`;
@@ -9014,9 +9048,9 @@ var Model = class Model {
 	}
 	/**
 	* Normalize the relation map for eager loading.
-	* 
-	* @param relations 
-	* @returns 
+	*
+	* @param relations
+	* @returns
 	*/
 	normalizeRelationMap(relations) {
 		if (typeof relations === "string") return { [relations]: void 0 };
@@ -9034,9 +9068,9 @@ var Model = class Model {
 //#endregion
 //#region src/database/factories.ts
 /**
-* Base class for defining model factories. 
+* Base class for defining model factories.
 * Not meant to be used directly.
-* 
+*
 * @template TModel The type of model the factory creates.
 * @template TAttributes The type of attributes used to create the model.
 * @author Legacy (3m1n3nc3)
@@ -9062,9 +9096,9 @@ var ModelFactory = class ModelFactory {
 	configure() {}
 	/**
 	* Set the number of models to create.
-	* 
-	* @param amount 
-	* @returns 
+	*
+	* @param amount
+	* @returns
 	*/
 	count(amount) {
 		this.ensureConfigured();
@@ -9072,9 +9106,9 @@ var ModelFactory = class ModelFactory {
 		return this;
 	}
 	/**
-	* Define a state transformation for the factory. 
+	* Define a state transformation for the factory.
 	* States are applied in the order they were defined.
-	* 
+	*
 	* @param resolver A function that takes the current attributes and sequence number, and returns the transformed attributes.
 	* @returns The factory instance for chaining.
 	*/
@@ -9085,9 +9119,9 @@ var ModelFactory = class ModelFactory {
 	}
 	/**
 	* Register a callback that runs after a model is made.
-	* 
-	* @param callback 
-	* @returns 
+	*
+	* @param callback
+	* @returns
 	*/
 	afterMaking(callback) {
 		this.ensureConfigured();
@@ -9096,9 +9130,9 @@ var ModelFactory = class ModelFactory {
 	}
 	/**
 	* Register a callback that runs after a model is persisted.
-	* 
-	* @param callback 
-	* @returns 
+	*
+	* @param callback
+	* @returns
 	*/
 	afterCreating(callback) {
 		this.ensureConfigured();
@@ -9107,9 +9141,9 @@ var ModelFactory = class ModelFactory {
 	}
 	/**
 	* Create a new model instance without saving it to the database.
-	* 
-	* @param overrides 
-	* @returns 
+	*
+	* @param overrides
+	* @returns
 	*/
 	make(overrides = {}) {
 		this.ensureConfigured();
@@ -9134,10 +9168,10 @@ var ModelFactory = class ModelFactory {
 	}
 	/**
 	* Create multiple model instances without saving them to the database.
-	* 
-	* @param amount 
-	* @param overrides 
-	* @returns 
+	*
+	* @param amount
+	* @param overrides
+	* @returns
 	*/
 	makeMany(amount = this.amount, overrides = {}) {
 		const total = Math.max(1, Math.floor(amount));
@@ -9159,19 +9193,19 @@ var ModelFactory = class ModelFactory {
 	}
 	/**
 	* Create a new model instance and save it to the database.
-	* 
-	* @param overrides 
-	* @returns 
+	*
+	* @param overrides
+	* @returns
 	*/
 	async create(overrides = {}) {
 		return await this.createPersisted(overrides);
 	}
 	/**
 	* Create multiple model instances and save them to the database.
-	* 
-	* @param amount 
-	* @param overrides 
-	* @returns 
+	*
+	* @param amount
+	* @param overrides
+	* @returns
 	*/
 	async createMany(amount = this.amount, overrides = {}) {
 		this.ensureConfigured();
@@ -9182,10 +9216,10 @@ var ModelFactory = class ModelFactory {
 	}
 	/**
 	* Create related models through a has-one or has-many relationship.
-	* 
-	* @param factory 
-	* @param relationship 
-	* @returns 
+	*
+	* @param factory
+	* @param relationship
+	* @returns
 	*/
 	has(factory, relationship) {
 		this.ensureConfigured();
@@ -9197,10 +9231,10 @@ var ModelFactory = class ModelFactory {
 	}
 	/**
 	* Associate the created model with a parent model or factory.
-	* 
-	* @param related 
-	* @param relationship 
-	* @returns 
+	*
+	* @param related
+	* @param relationship
+	* @returns
 	*/
 	for(related, relationship) {
 		this.ensureConfigured();
@@ -9212,11 +9246,11 @@ var ModelFactory = class ModelFactory {
 	}
 	/**
 	* Create or reuse related models and attach them through a many-to-many relationship.
-	* 
-	* @param related 
-	* @param pivot 
-	* @param relationship 
-	* @returns 
+	*
+	* @param related
+	* @param pivot
+	* @param relationship
+	* @returns
 	*/
 	hasAttached(related, pivot = {}, relationship) {
 		this.ensureConfigured();
@@ -9229,9 +9263,9 @@ var ModelFactory = class ModelFactory {
 	}
 	/**
 	* Reuse existing models when resolving factory-backed relationships.
-	* 
-	* @param models 
-	* @returns 
+	*
+	* @param models
+	* @returns
 	*/
 	recycle(models) {
 		this.ensureConfigured();
@@ -9245,18 +9279,18 @@ var ModelFactory = class ModelFactory {
 	}
 	/**
 	* Get the model contgructor
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	getModelConstructor() {
 		return this.model;
 	}
 	/**
-	* Build the attributes for a model instance, applying the factory 
+	* Build the attributes for a model instance, applying the factory
 	* definition and any defined states, and merging in any overrides.
-	* 
-	* @param overrides 
-	* @returns 
+	*
+	* @param overrides
+	* @returns
 	*/
 	buildAttributes(overrides) {
 		const sequence = this.sequence;
@@ -9427,11 +9461,11 @@ var ModelFactory = class ModelFactory {
 	}
 };
 /**
-* A helper class for defining factories using an inline definition 
+* A helper class for defining factories using an inline definition
 * function, without needing to create a separate factory class.
-* 
+*
 * @template TModel
-* @template TAttributes 
+* @template TAttributes
 * @author Legacy (3m1n3nc3)
 * @since 0.1.0
 */
@@ -9447,7 +9481,7 @@ var InlineFactory = class extends ModelFactory {
 };
 /**
 * Define a factory for a given model using an inline definition function.
-* 
+*
 * @template TModel         The type of model the factory creates.
 * @template TAttributes    The type of attributes used to create the model.
 * @param model             The model constructor.
@@ -9580,10 +9614,10 @@ var DB = class DB {
 //#endregion
 //#region src/PivotModel.ts
 /**
-* Base pivot class that all pivot models should extend. 
-* 
+* Base pivot class that all pivot models should extend.
+*
 * @template TModel The type of the model extending this base class.
-* 
+*
 * @author Legacy (3m1n3nc3)
 * @since 2.0.0-next.18
 */