arkormx 2.9.1 → 2.9.3

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_relationship = require('./relationship-BVYP9lU2.cjs');
+const require_relationship = require('./relationship-DhdzLnKH.cjs');
 let pg = require("pg");
 let node_path = require("node:path");
 let module$1 = require("module");
@@ -34,9 +34,9 @@ var QueryExecutionException = class extends require_relationship.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
 */
@@ -1084,9 +1084,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.
 	*/
@@ -1104,10 +1104,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.
 	*/
@@ -1118,11 +1118,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);
@@ -1141,9 +1141,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.
 	*/
@@ -1214,11 +1214,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);
@@ -1245,9 +1245,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);
@@ -1277,9 +1277,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.
 	*/
@@ -1301,9 +1301,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.
 	*/
@@ -1319,9 +1319,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);
@@ -1338,9 +1338,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.
 	*/
@@ -1353,9 +1353,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.
 	*/
@@ -1369,7 +1369,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.
 	*/
@@ -1383,9 +1383,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;
@@ -1521,10 +1521,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.
@@ -1539,12 +1539,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);
@@ -1603,7 +1603,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.
 */
@@ -1614,9 +1614,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
 */
@@ -1885,9 +1885,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);
@@ -1897,10 +1897,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);
@@ -1911,9 +1911,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);
@@ -1922,10 +1922,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);
@@ -1954,9 +1954,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);
@@ -1973,10 +1973,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);
@@ -2006,9 +2006,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);
@@ -2019,10 +2019,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);
@@ -2037,9 +2037,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);
@@ -2050,9 +2050,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({
@@ -2062,8 +2062,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 require_relationship.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.", {
@@ -2072,12 +2072,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 require_relationship.UnsupportedAdapterFeatureException("Transactions are not supported by the Prisma compatibility adapter.", {
@@ -2094,9 +2094,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.
@@ -2105,9 +2105,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.
@@ -2137,10 +2137,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 require_relationship.configureArkormRuntime(client, options);
@@ -2157,113 +2157,113 @@ var Arkorm = class Arkorm {
 	}
 	/**
 	* Register migration constructors directly without relying on runtime discovery.
-	* 
-	* @param migrations 
-	* @returns 
+	*
+	* @param migrations
+	* @returns
 	*/
 	static registerMigrations(...migrations) {
 		return require_relationship.registerMigrations(...migrations);
 	}
 	/**
 	* Register seeder constructors directly without relying on runtime discovery.
-	* 
-	* @param seeders 
-	* @returns 
+	*
+	* @param seeders
+	* @returns
 	*/
 	static registerSeeders(...seeders) {
 		return require_relationship.registerSeeders(...seeders);
 	}
 	/**
 	* Register model constructors directly without relying on runtime discovery.
-	* 
-	* @param models 
-	* @returns 
+	*
+	* @param models
+	* @returns
 	*/
 	static registerModels(...models) {
 		return require_relationship.registerModels(...models);
 	}
 	/**
 	* Register factory constructors or instances directly without relying on runtime discovery.
-	* 
-	* @param factories 
-	* @returns 
+	*
+	* @param factories
+	* @returns
 	*/
 	static registerFactories(...factories) {
 		return require_relationship.registerFactories(...factories);
 	}
 	/**
 	* Register additional runtime discovery paths for models without replacing configured paths.
-	* 
-	* @param paths 
-	* @returns 
+	*
+	* @param paths
+	* @returns
 	*/
 	static loadModelsFrom(paths) {
 		return require_relationship.loadModelsFrom(paths);
 	}
 	/**
 	* Register additional runtime discovery paths for seeders without replacing configured paths.
-	* 
-	* @param paths 
-	* @returns 
+	*
+	* @param paths
+	* @returns
 	*/
 	static loadSeedersFrom(paths) {
 		return require_relationship.loadSeedersFrom(paths);
 	}
 	/**
 	* Register additional runtime discovery paths for migrations without replacing configured paths.
-	* 
-	* @param paths 
-	* @returns 
+	*
+	* @param paths
+	* @returns
 	*/
 	static loadMigrationsFrom(paths) {
 		return require_relationship.loadMigrationsFrom(paths);
 	}
 	/**
 	* Register additional runtime discovery paths for factories without replacing configured paths.
-	* 
-	* @param paths 
-	* @returns 
+	*
+	* @param paths
+	* @returns
 	*/
 	static loadFactoriesFrom(paths) {
 		return require_relationship.loadFactoriesFrom(paths);
 	}
 	/**
 	* Get registered runtime discovery paths or registered constructors for a specific type.
-	* 
-	* @param key 
-	* @returns 
+	*
+	* @param key
+	* @returns
 	*/
 	static getRegisteredPaths(key) {
 		return require_relationship.getRegisteredPaths(key);
 	}
 	/**
 	* Get registered migration constructors instances
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	static getRegisteredMigrations() {
 		return require_relationship.getRegisteredMigrations();
 	}
 	/**
 	* Get registered seeder constructors instances.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	static getRegisteredSeeders() {
 		return require_relationship.getRegisteredSeeders();
 	}
 	/**
 	* Get registered model constructors instances.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	static getRegisteredModels() {
 		return require_relationship.getRegisteredModels();
 	}
 	/**
 	* Get registered factory constructors or instances.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	static getRegisteredFactories() {
 		return require_relationship.getRegisteredFactories();
@@ -2391,12 +2391,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;
@@ -2485,7 +2485,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
@@ -2497,19 +2497,19 @@ var CliApp = class {
 	}
 	/**
 	* Resolve the path to a stub file based on configuration
-	* 
-	* @param stubName 
-	* @returns 
+	*
+	* @param stubName
+	* @returns
 	*/
 	resolveStubPath(stubName) {
 		return (0, path.join)(this.resolveConfigPath("stubs", require_relationship.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 = (0, _h3ravel_support.str)(name.replace(/Factory$/, "")).pascal();
@@ -2531,10 +2531,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 = `${(0, _h3ravel_support.str)(name.replace(/Seeder$/, "")).pascal()}Seeder`;
@@ -2548,7 +2548,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.
 	*/
@@ -2564,10 +2564,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 = (0, _h3ravel_support.str)(name.replace(/Model$/, "")).pascal().toString();
@@ -2611,10 +2611,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.
 	*/
@@ -2646,7 +2646,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.
 	*/
@@ -2939,9 +2939,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.
 	*/
@@ -2989,11 +2989,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.
@@ -3089,12 +3089,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.
 	*/
@@ -3125,7 +3125,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)
@@ -3184,8 +3184,8 @@ var MakeFactoryCommand = class extends _h3ravel_musket.Command {
 	}
 	/**
 	* Command handler for the make:factory command.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	async handle() {
 		this.app.command = this;
@@ -3214,8 +3214,8 @@ var MakeMigrationCommand = class extends _h3ravel_musket.Command {
 	}
 	/**
 	* Command handler for the make:migration command.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	async handle() {
 		this.app.command = this;
@@ -3229,7 +3229,7 @@ var MakeMigrationCommand = class extends _h3ravel_musket.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)
@@ -3251,8 +3251,8 @@ var MakeModelCommand = class extends _h3ravel_musket.Command {
 	}
 	/**
 	* Command handler for the make:model command.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	async handle() {
 		this.app.command = this;
@@ -3302,8 +3302,8 @@ var MakeSeederCommand = class extends _h3ravel_musket.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)
@@ -3318,7 +3318,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)
@@ -3342,12 +3342,12 @@ var MigrateCommand = class extends _h3ravel_musket.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;
@@ -3462,10 +3462,10 @@ var MigrateCommand = class extends _h3ravel_musket.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, ""]];
@@ -3488,9 +3488,9 @@ var MigrateCommand = class extends _h3ravel_musket.Command {
 	}
 	/**
 	* Load migration classes from a given file path.
-	* 
-	* @param filePath 
-	* @returns 
+	*
+	* @param filePath
+	* @returns
 	*/
 	async loadMigrationClassesFromFile(filePath) {
 		const imported = await require_relationship.RuntimeModuleLoader.load(filePath);
@@ -3909,7 +3909,7 @@ var ModelsSyncCommand = class extends _h3ravel_musket.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)
@@ -3924,7 +3924,7 @@ var Seeder = class Seeder {
 	}
 	/**
 	* Runs one or more seeders.
-	* 
+	*
 	* @param seeders   The seeders to be run.
 	*/
 	async call(...seeders) {
@@ -3932,9 +3932,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 = [];
@@ -3944,8 +3944,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.
 	*/
@@ -3958,7 +3958,7 @@ var Seeder = class Seeder {
 	}
 	/**
 	* Runs the given seeders in sequence.
-	* 
+	*
 	* @param seeders   The seeders to be run.
 	*/
 	static async runSeeders(...seeders) {
@@ -3978,7 +3978,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
@@ -3994,8 +3994,8 @@ var SeedCommand = class extends _h3ravel_musket.Command {
 	}
 	/**
 	* Command handler for the seed command.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	async handle() {
 		this.app.command = this;
@@ -4011,9 +4011,9 @@ var SeedCommand = class extends _h3ravel_musket.Command {
 	}
 	/**
 	* Load all seeder classes from the specified directory.
-	* 
-	* @param seedersDir 
-	* @returns 
+	*
+	* @param seedersDir
+	* @returns
 	*/
 	resolveSeederDirectories(configuredSeedersDir) {
 		return [this.app.resolveRuntimeDirectoryPath(configuredSeedersDir), ...require_relationship.getRegisteredPaths("seeders").map((directory) => this.app.resolveRuntimeDirectoryPath(directory))].filter((directory, index, all) => (0, node_fs.existsSync)(directory) && all.indexOf(directory) === index);
@@ -4024,10 +4024,10 @@ var SeedCommand = class extends _h3ravel_musket.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$/, "");
@@ -4049,7 +4049,7 @@ var SeedCommand = class extends _h3ravel_musket.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.
 	*/
@@ -4315,9 +4315,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
 */
@@ -4375,9 +4375,9 @@ var UniqueConstraintResolutionException = class extends require_relationship.Ark
 //#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
@@ -4385,8 +4385,8 @@ var UniqueConstraintResolutionException = class extends require_relationship.Ark
 var QueryBuilder = class QueryBuilder {
 	/**
 	* Creates a new QueryBuilder instance.
-	* 
-	* @param model 
+	*
+	* @param model
 	*/
 	constructor(model, adapter) {
 		this.model = model;
@@ -4564,45 +4564,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();
@@ -4613,9 +4613,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();
@@ -4623,9 +4623,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();
@@ -4633,9 +4633,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();
@@ -4643,9 +4643,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();
@@ -4662,9 +4662,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);
@@ -4804,12 +4804,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());
@@ -4838,10 +4838,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 });
@@ -4861,10 +4861,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, {
@@ -4883,9 +4883,9 @@ var QueryBuilder = class QueryBuilder {
 	}
 	/**
 	* OR variant of whereJsonContainsKey().
-	* 
-	* @param column 
-	* @returns 
+	*
+	* @param column
+	* @returns
 	*/
 	orWhereJsonContainsKey(column) {
 		return this.appendJsonCondition("OR", "contains-key", column);
@@ -4901,9 +4901,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 });
@@ -4945,10 +4945,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 });
@@ -5066,9 +5066,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;
@@ -5122,9 +5122,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);
@@ -5137,11 +5137,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);
@@ -5343,10 +5343,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;
@@ -5354,10 +5354,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;
@@ -5365,11 +5365,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;
@@ -5378,14 +5378,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)}`;
@@ -5448,9 +5448,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);
@@ -5801,9 +5801,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;
@@ -5820,9 +5820,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;
@@ -5839,9 +5839,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();
@@ -5888,8 +5888,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();
@@ -5910,10 +5910,10 @@ var QueryBuilder = class QueryBuilder {
 		return new require_relationship.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;
@@ -5934,8 +5934,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();
@@ -6048,9 +6048,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);
@@ -6136,11 +6136,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();
@@ -6255,8 +6255,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();
@@ -6354,8 +6354,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;
@@ -6393,15 +6393,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;
@@ -6553,13 +6562,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);
@@ -6597,8 +6606,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);
@@ -6628,9 +6637,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 };
@@ -6819,7 +6828,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() {
@@ -7287,10 +7296,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);
@@ -7303,14 +7312,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;
@@ -7341,11 +7350,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();
@@ -7615,10 +7624,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
 */
@@ -7626,6 +7635,9 @@ var Model = class Model {
 	static {
 		this.lifecycleStates = /* @__PURE__ */ new WeakMap();
 	}
+	static {
+		this.castMapCache = /* @__PURE__ */ new WeakMap();
+	}
 	static {
 		this.emittedDeprecationWarnings = /* @__PURE__ */ new Set();
 	}
@@ -7764,6 +7776,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;
@@ -7941,9 +7978,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.");
@@ -7965,9 +8002,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);
@@ -7993,31 +8030,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);
@@ -8085,10 +8122,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 {
@@ -8097,11 +8134,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);
@@ -8112,10 +8149,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;
@@ -8255,12 +8292,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;
@@ -8304,10 +8341,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;
@@ -8336,8 +8373,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;
@@ -8365,9 +8402,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);
@@ -8433,8 +8470,8 @@ var Model = class Model {
 	}
 	/**
 	* Get the raw attributes of the model without applying any mutators or casts.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	getRawAttributes() {
 		return { ...this.attributes };
@@ -8495,10 +8532,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) => {
@@ -8514,8 +8551,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();
@@ -8564,11 +8601,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;
@@ -8576,11 +8613,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;
@@ -8588,25 +8625,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 require_relationship.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;
@@ -8614,14 +8651,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;
@@ -8629,14 +8666,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;
@@ -8644,13 +8681,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;
@@ -8659,13 +8696,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;
@@ -8680,7 +8717,7 @@ var Model = class Model {
 	}
 	/**
 	* Define a polymorphic many to many relationship.
-	* 
+	*
 	* @param related
 	* @param morphName
 	* @param throughTable
@@ -8689,7 +8726,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;
@@ -8717,9 +8754,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${(0, _h3ravel_support.str)(key).studly()}Attribute`;
@@ -8751,10 +8788,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.
@@ -8786,9 +8820,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${(0, _h3ravel_support.str)(key).studly()}Attribute`;
@@ -9015,9 +9049,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 };
@@ -9035,9 +9069,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)
@@ -9063,9 +9097,9 @@ var ModelFactory = class ModelFactory {
 	configure() {}
 	/**
 	* Set the number of models to create.
-	* 
-	* @param amount 
-	* @returns 
+	*
+	* @param amount
+	* @returns
 	*/
 	count(amount) {
 		this.ensureConfigured();
@@ -9073,9 +9107,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.
 	*/
@@ -9086,9 +9120,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();
@@ -9097,9 +9131,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();
@@ -9108,9 +9142,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();
@@ -9135,10 +9169,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));
@@ -9160,19 +9194,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();
@@ -9183,10 +9217,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();
@@ -9198,10 +9232,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();
@@ -9213,11 +9247,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();
@@ -9230,9 +9264,9 @@ var ModelFactory = class ModelFactory {
 	}
 	/**
 	* Reuse existing models when resolving factory-backed relationships.
-	* 
-	* @param models 
-	* @returns 
+	*
+	* @param models
+	* @returns
 	*/
 	recycle(models) {
 		this.ensureConfigured();
@@ -9246,18 +9280,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;
@@ -9428,11 +9462,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
 */
@@ -9448,7 +9482,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.
@@ -9581,10 +9615,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
 */