arkormx 2.9.1 → 2.9.3

package/dist/{relationship-DtNgcxxv.mjs → relationship-BD04hN72.mjs}

@@ -65,9 +65,9 @@ var RelationResolutionException = class extends ArkormException {
 //#endregion
 //#region src/relationship/RelationTableLoader.ts
 /**
-* Utility class responsible for loading data from relation tables, which are used to 
-* manage relationships between models in Arkorm. 
-* 
+* Utility class responsible for loading data from relation tables, which are used to
+* manage relationships between models in Arkorm.
+*
 * @author Legacy (3m1n3nc3)
 * @since 2.0.0-next.0
 */
@@ -113,9 +113,9 @@ var RelationTableLoader = class {
 //#endregion
 //#region src/relationship/SetBasedEagerLoader.ts
 /**
-* Utility class responsible for performing set-based eager loading of relationships for 
+* Utility class responsible for performing set-based eager loading of relationships for
 * a collection of models.
-* 
+*
 * @author Legacy (3m1n3nc3)
 * @since 2.0.0-next.2
 */
@@ -125,9 +125,9 @@ var SetBasedEagerLoader = class SetBasedEagerLoader {
 		this.relations = relations;
 	}
 	/**
-	* Performs eager loading of all specified relationships for the set of models. 
-	* 
-	* @returns 
+	* Performs eager loading of all specified relationships for the set of models.
+	*
+	* @returns
 	*/
 	async load() {
 		if (this.models.length === 0) return;
@@ -144,9 +144,9 @@ var SetBasedEagerLoader = class SetBasedEagerLoader {
 		await new SetBasedEagerLoader(relatedModels, this.relationTreeToMap(node.children)).load();
 	}
 	/**
-	* Loads a specific relationship for the set of models based on the relationship name 
+	* Loads a specific relationship for the set of models based on the relationship name
 	* and an optional constraint.
-	* 
+	*
 	* @param name          The name of the relationship to load.
 	* @param constraint    An optional constraint to apply to the query.
 	* @returns             A promise that resolves when the relationship is loaded.
@@ -187,9 +187,9 @@ var SetBasedEagerLoader = class SetBasedEagerLoader {
 		}
 	}
 	/**
-	* Resolves the relation resolver function for a given relationship name by inspecting 
+	* Resolves the relation resolver function for a given relationship name by inspecting
 	* the first model in the set.
-	* 
+	*
 	* @param name  The name of the relationship to resolve.
 	* @returns     The relation resolver function or null if not found.
 	*/
@@ -249,7 +249,7 @@ var SetBasedEagerLoader = class SetBasedEagerLoader {
 	}
 	/**
 	* Loads a "belongs to" relationship for the set of models.
-	* 
+	*
 	* @param name          The name of the relationship to load.
 	* @param resolver      The relation resolver function.
 	* @param metadata      The metadata for the relationship.
@@ -281,12 +281,12 @@ var SetBasedEagerLoader = class SetBasedEagerLoader {
 		});
 	}
 	/**
-	* Loads a "has many" relationship for the set of models. 
-	* 
-	* @param name 
-	* @param metadata 
-	* @param constraint 
-	* @returns 
+	* Loads a "has many" relationship for the set of models.
+	*
+	* @param name
+	* @param metadata
+	* @param constraint
+	* @returns
 	*/
 	async loadHasMany(name, metadata, constraint) {
 		const keys = this.collectUniqueKeys((model) => model.getAttribute(metadata.localKey));
@@ -315,12 +315,12 @@ var SetBasedEagerLoader = class SetBasedEagerLoader {
 		});
 	}
 	/**
-	* Loads a "belongs to many" relationship for the set of models. 
-	* 
-	* @param name 
-	* @param metadata 
-	* @param constraint 
-	* @returns 
+	* Loads a "belongs to many" relationship for the set of models.
+	*
+	* @param name
+	* @param metadata
+	* @param constraint
+	* @returns
 	*/
 	async loadBelongsToMany(name, metadata, constraint) {
 		const parentKeys = this.collectUniqueKeys((model) => model.getAttribute(metadata.parentKey));
@@ -415,12 +415,12 @@ var SetBasedEagerLoader = class SetBasedEagerLoader {
 	}
 	/**
 	* Loads a "belongs to many" relationship for the set of models.
-	* 
-	* @param name 
-	* @param resolver 
-	* @param metadata 
-	* @param constraint 
-	* @returns 
+	*
+	* @param name
+	* @param resolver
+	* @param metadata
+	* @param constraint
+	* @returns
 	*/
 	async loadHasOne(name, resolver, metadata, constraint) {
 		const keys = this.collectUniqueKeys((model) => model.getAttribute(metadata.localKey));
@@ -448,11 +448,11 @@ var SetBasedEagerLoader = class SetBasedEagerLoader {
 	}
 	/**
 	* Loads a "has many through" relationship for the set of models.
-	* 
-	* @param name 
-	* @param metadata 
-	* @param constraint 
-	* @returns 
+	*
+	* @param name
+	* @param metadata
+	* @param constraint
+	* @returns
 	*/
 	async loadHasManyThrough(name, metadata, constraint) {
 		const parentKeys = this.collectUniqueKeys((model) => model.getAttribute(metadata.localKey));
@@ -506,12 +506,12 @@ var SetBasedEagerLoader = class SetBasedEagerLoader {
 	}
 	/**
 	* Loads a "has one through" relationship for the set of models.
-	* 
-	* @param name 
-	* @param resolver 
-	* @param metadata 
-	* @param constraint 
-	* @returns 
+	*
+	* @param name
+	* @param resolver
+	* @param metadata
+	* @param constraint
+	* @returns
 	*/
 	async loadHasOneThrough(name, resolver, metadata, constraint) {
 		const parentKeys = this.collectUniqueKeys((model) => model.getAttribute(metadata.localKey));
@@ -705,19 +705,19 @@ var SetBasedEagerLoader = class SetBasedEagerLoader {
 	}
 	/**
 	* Applies an eager load constraint to a query if provided.
-	* 
-	* @param query 
-	* @param constraint 
-	* @returns 
+	*
+	* @param query
+	* @param constraint
+	* @returns
 	*/
 	applyConstraint(query, constraint) {
 		if (!constraint) return query;
 		return constraint(query) ?? query;
 	}
 	/**
-	* Collects unique values from the set of models based on a resolver function, which 
+	* Collects unique values from the set of models based on a resolver function, which
 	* is used to extract the value from each model.
-	* 
+	*
 	* @param resolve   A function that takes a model and returns the value to be collected.
 	* @returns         An array of unique values.
 	*/
@@ -735,9 +735,9 @@ var SetBasedEagerLoader = class SetBasedEagerLoader {
 		return values;
 	}
 	/**
-	* Collects unique values from an array of database rows based on a specified key, which 
+	* Collects unique values from an array of database rows based on a specified key, which
 	* is used to extract the value from each row.
-	* 
+	*
 	* @param rows  An array of database rows.
 	* @param key   The key to extract values from each row.
 	* @returns     An array of unique values.
@@ -757,16 +757,16 @@ var SetBasedEagerLoader = class SetBasedEagerLoader {
 	}
 	/**
 	* Loads a "belongs to many" relationship for the set of models.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	createRelationTableLoader() {
 		return new RelationTableLoader(this.resolveAdapter());
 	}
 	/**
 	* Loads a "belongs to many" relationship for the set of models.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	resolveAdapter() {
 		const adapter = this.models[0].constructor.getAdapter?.();
@@ -774,30 +774,30 @@ var SetBasedEagerLoader = class SetBasedEagerLoader {
 		return adapter;
 	}
 	/**
-	* Reads an attribute value from a model using the getAttribute method, which is used 
+	* Reads an attribute value from a model using the getAttribute method, which is used
 	* to access model attributes in a way that is compatible with Arkorm's internal model structure.
-	* 
+	*
 	* @param model The model to read the attribute from.
 	* @param key The name of the attribute to read.
-	* @returns 
+	* @returns
 	*/
 	readModelAttribute(model, key) {
 		return model.getAttribute?.(key);
 	}
 	/**
-	* Resolves the default result for a relationship when no related models are found. 
-	* 
-	* @param resolver 
-	* @param model 
-	* @returns 
+	* Resolves the default result for a relationship when no related models are found.
+	*
+	* @param resolver
+	* @param model
+	* @returns
 	*/
 	resolveSingleDefault(resolver, model) {
 		return resolver.call(model).resolveDefaultResult?.() ?? null;
 	}
 	/**
-	* Generates a unique lookup key for a given value, which is used to store and retrieve 
+	* Generates a unique lookup key for a given value, which is used to store and retrieve
 	* values in maps during the eager loading process.
-	* 
+	*
 	* @param value     The value to generate a lookup key for.
 	* @returns         A unique string representing the value.
 	*/
@@ -843,10 +843,10 @@ var RuntimeModuleLoader = class {
 	*
 	* Each returned entry carries either the loaded module or the last error,
 	* so callers can surface genuine failures instead of silently dropping them.
-	* 
-	* @param filePaths 
-	* @param useDefault 
-	* @returns 
+	*
+	* @param filePaths
+	* @param useDefault
+	* @returns
 	*/
 	static async loadAll(filePaths, useDefault = false) {
 		const jiti = createJiti(`${pathToFileURL(resolve(".")).href}/`, {
@@ -1012,9 +1012,9 @@ const getLatestAppliedMigrations = (state, steps) => {
 //#endregion
 //#region src/database/ForeignKeyBuilder.ts
 /**
-* The ForeignKeyBuilder class provides a fluent interface for defining 
-* foreign key constraints in a migration. It allows you to specify 
-* the referenced table and column, as well as actions to take on 
+* The ForeignKeyBuilder class provides a fluent interface for defining
+* foreign key constraints in a migration. It allows you to specify
+* the referenced table and column, as well as actions to take on
 * delete and aliases for the relation.
 *
 * @author Legacy (3m1n3nc3)
@@ -1026,10 +1026,10 @@ var ForeignKeyBuilder = class {
 	}
 	/**
 	* Defines the referenced table and column for this foreign key constraint.
-	* 
-	* @param table 
-	* @param column 
-	* @returns 
+	*
+	* @param table
+	* @param column
+	* @returns
 	*/
 	references(table, column) {
 		this.foreignKey.referencesTable = table;
@@ -1037,22 +1037,22 @@ var ForeignKeyBuilder = class {
 		return this;
 	}
 	/**
-	* Defines the action to take when a referenced record is deleted, such 
+	* Defines the action to take when a referenced record is deleted, such
 	* as "CASCADE", "SET NULL", or "RESTRICT".
-	* 
-	* @param action 
-	* @returns 
+	*
+	* @param action
+	* @returns
 	*/
 	onDelete(action) {
 		this.foreignKey.onDelete = action;
 		return this;
 	}
 	/**
-	* Defines an alias for the relation represented by this foreign key, which 
+	* Defines an alias for the relation represented by this foreign key, which
 	* can be used in the ORM for more intuitive access to related models.
-	* 
-	* @param name 
-	* @returns 
+	*
+	* @param name
+	* @returns
 	*/
 	alias(name) {
 		this.foreignKey.relationAlias = name;
@@ -1060,20 +1060,20 @@ var ForeignKeyBuilder = class {
 	}
 	/**
 	* Defines an alias for the inverse relation represented by this foreign key.
-	* 
-	* @param name 
-	* @returns 
+	*
+	* @param name
+	* @returns
 	*/
 	inverseAlias(name) {
 		this.foreignKey.inverseRelationAlias = name;
 		return this;
 	}
 	/**
-	* Defines an alias for the foreign key field itself, which can be 
+	* Defines an alias for the foreign key field itself, which can be
 	* used in the ORM for more intuitive access to the foreign key value.
-	* 
-	* @param fieldName 
-	* @returns 
+	*
+	* @param fieldName
+	* @returns
 	*/
 	as(fieldName) {
 		this.foreignKey.fieldAlias = fieldName;
@@ -1192,7 +1192,7 @@ var EnumBuilder = class {
 	}
 };
 /**
-* The TableBuilder class provides a fluent interface for defining 
+* The TableBuilder class provides a fluent interface for defining
 * the structure of a database table in a migration, including columns to add or drop.
 *
 * @author Legacy (3m1n3nc3)
@@ -1229,7 +1229,7 @@ var TableBuilder = class {
 	}
 	/**
 	* Defines an auto-incrementing primary key column.
-	* 
+	*
 	* @param name  The name of the primary key column.
 	* @default 'id'
 	* @returns     The current TableBuilder instance for chaining.
@@ -1239,7 +1239,7 @@ var TableBuilder = class {
 	}
 	/**
 	* Defines a UUID column in the table.
-	* 
+	*
 	* @param name      The name of the UUID column.
 	* @param options   Additional options for the UUID column.
 	* @returns         The current TableBuilder instance for chaining.
@@ -1270,7 +1270,7 @@ var TableBuilder = class {
 	}
 	/**
 	* Defines a string column in the table.
-	* 
+	*
 	* @param name      The name of the string column.
 	* @param options   Additional options for the string column.
 	* @returns         The current TableBuilder instance for chaining.
@@ -1280,7 +1280,7 @@ var TableBuilder = class {
 	}
 	/**
 	* Defines a text column in the table.
-	* 
+	*
 	* @param name      The name of the text column.
 	* @param options   Additional options for the text column.
 	* @returns         The current TableBuilder instance for chaining.
@@ -1290,7 +1290,7 @@ var TableBuilder = class {
 	}
 	/**
 	* Defines an integer column in the table.
-	* 
+	*
 	* @param name      The name of the integer column.
 	* @param options   Additional options for the integer column.
 	* @returns         The current TableBuilder instance for chaining.
@@ -1300,7 +1300,7 @@ var TableBuilder = class {
 	}
 	/**
 	* Defines a big integer column in the table.
-	* 
+	*
 	* @param name      The name of the big integer column.
 	* @param options   Additional options for the big integer column.
 	* @returns         The current TableBuilder instance for chaining.
@@ -1310,7 +1310,7 @@ var TableBuilder = class {
 	}
 	/**
 	* Defines a float column in the table.
-	* 
+	*
 	* @param name      The name of the float column.
 	* @param options   Additional options for the float column.
 	* @returns         The current TableBuilder instance for chaining.
@@ -1336,8 +1336,8 @@ var TableBuilder = class {
 	}
 	/**
 	* Defines a boolean column in the table.
-	* 
-	* @param name      The name of the boolean column. 
+	*
+	* @param name      The name of the boolean column.
 	* @param options   Additional options for the boolean column.
 	* @returns         The current TableBuilder instance for chaining.
 	*/
@@ -1346,29 +1346,29 @@ var TableBuilder = class {
 	}
 	/**
 	* Defines a JSON column in the table.
-	* 
+	*
 	* @param name      The name of the JSON column.
 	* @param options   Additional options for the JSON column.
-	* @returns 
+	* @returns
 	*/
 	json(name, options = {}) {
 		return this.column(name, "json", options);
 	}
 	/**
 	* Defines a date column in the table.
-	* 
+	*
 	* @param name      The name of the date column.
 	* @param options   Additional options for the date column.
-	* @returns 
+	* @returns
 	*/
 	date(name, options = {}) {
 		return this.column(name, "date", options);
 	}
 	/**
 	* Defines colonns for a polymorphic relationship in the table.
-	* 
+	*
 	* @param name    The base name for the polymorphic relationship columns.
-	* @returns 
+	* @returns
 	*/
 	morphs(name, nullable = false) {
 		this.string(`${name}Type`, { nullable });
@@ -1377,9 +1377,9 @@ var TableBuilder = class {
 	}
 	/**
 	* Defines columns for a polymorphic relationship in the table with UUID ID.
-	* 
+	*
 	* @param name    The base name for the polymorphic relationship columns.
-	* @returns 
+	* @returns
 	*/
 	uuidMorphs(name, nullable = false) {
 		this.string(`${name}Type`, { nullable });
@@ -1388,28 +1388,28 @@ var TableBuilder = class {
 	}
 	/**
 	* Defines nullable columns for a polymorphic relationship in the table.
-	* 
+	*
 	* @param name  The base name for the polymorphic relationship columns.
-	* @returns 
+	* @returns
 	*/
 	nullableMorphs(name) {
 		return this.morphs(name, true);
 	}
 	/**
 	* Defines nullable columns for a polymorphic relationship in the table with UUID ID.
-	* 
+	*
 	* @param name  The base name for the polymorphic relationship columns.
-	* @returns 
+	* @returns
 	*/
 	nullableUuidMorphs(name) {
 		return this.uuidMorphs(name, true);
 	}
 	/**
 	* Defines a timestamp column in the table.
-	* 
+	*
 	* @param name      The name of the timestamp column.
 	* @param options   Additional options for the timestamp column.
-	* @returns 
+	* @returns
 	*/
 	timestamp(name, options = {}) {
 		return this.column(name, "timestamp", options);
@@ -1470,9 +1470,9 @@ var TableBuilder = class {
 	}
 	/**
 	* Defines a soft delete timestamp column in the table.
-	* 
+	*
 	* @param column    The name of the soft delete column.
-	* @returns 
+	* @returns
 	*/
 	softDeletes(column = "deletedAt") {
 		this.timestamp(column, { nullable: true });
@@ -1480,9 +1480,9 @@ var TableBuilder = class {
 	}
 	/**
 	* Defines a column to be dropped from the table in an alterTable operation.
-	* 
+	*
 	* @param name   The name of the column to drop.
-	* @returns 
+	* @returns
 	*/
 	dropColumn(name) {
 		this.dropColumnNames.push(name);
@@ -1490,7 +1490,7 @@ var TableBuilder = class {
 	}
 	/**
 	* Marks a column as nullable.
-	* 
+	*
 	* @param columnName Optional explicit column name. When omitted, applies to the latest defined column.
 	* @returns          The current TableBuilder instance for chaining.
 	*/
@@ -1528,7 +1528,7 @@ var TableBuilder = class {
 	}
 	/**
 	* Sets the column position to appear after another column when possible.
-	* 
+	*
 	* @param referenceColumn The column that the target column should be placed after.
 	* @param columnName      Optional explicit target column name. When omitted, applies to the latest defined column.
 	* @returns               The current TableBuilder instance for chaining.
@@ -1540,7 +1540,7 @@ var TableBuilder = class {
 	}
 	/**
 	* Maps the column to a custom database column name.
-	* 
+	*
 	* @param name       The custom database column name.
 	* @param columnName Optional explicit target column name. When omitted, applies to the latest defined column.
 	* @returns          The current TableBuilder instance for chaining.
@@ -1552,7 +1552,7 @@ var TableBuilder = class {
 	}
 	/**
 	* Defines an index on one or more columns.
-	* 
+	*
 	* @param columns Optional target columns. When omitted, applies to the latest defined column.
 	* @param name    Optional index name.
 	* @returns       The current TableBuilder instance for chaining.
@@ -1581,11 +1581,11 @@ var TableBuilder = class {
 		return new ForeignKeyBuilder(entry);
 	}
 	/**
-	* Defines a foreign key relation for a column, using a 
+	* Defines a foreign key relation for a column, using a
 	* conventional naming pattern.
-	* 
-	* @param column 
-	* @returns 
+	*
+	* @param column
+	* @returns
 	*/
 	foreign(column) {
 		const columnName = this.resolveColumn(column).name;
@@ -1593,8 +1593,8 @@ var TableBuilder = class {
 	}
 	/**
 	* Returns a deep copy of the defined columns for the table.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	getColumns() {
 		return this.columns.map((column) => ({
@@ -1604,15 +1604,15 @@ var TableBuilder = class {
 	}
 	/**
 	* Returns a copy of the defined column names to be dropped from the table.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	getDropColumns() {
 		return [...this.dropColumnNames];
 	}
 	/**
 	* Returns a deep copy of the defined indexes for the table.
-	* 
+	*
 	* @returns
 	*/
 	getIndexes() {
@@ -1649,11 +1649,11 @@ var TableBuilder = class {
 	}
 	/**
 	* Defines a column in the table with the given name.
-	* 
+	*
 	* @param name      The name of the column.
 	* @param type      The type of the column.
 	* @param options   Additional options for the column.
-	* @returns 
+	* @returns
 	*/
 	column(name, type, options) {
 		this.columns.push({
@@ -1678,9 +1678,9 @@ var TableBuilder = class {
 	}
 	/**
 	* Resolve a target column by name or fallback to the latest defined column.
-	* 
-	* @param columnName 
-	* @returns 
+	*
+	* @param columnName
+	* @returns
 	*/
 	resolveColumn(columnName) {
 		const targetName = columnName ?? this.latestColumnName;
@@ -1701,19 +1701,84 @@ var TableBuilder = class {
 //#endregion
 //#region src/database/SchemaBuilder.ts
 /**
-* The SchemaBuilder class provides methods for defining the operations to be 
-* performed in a migration, such as creating, altering, or dropping tables. 
+* The SchemaBuilder class provides methods for defining the operations to be
+* performed in a migration, such as creating, altering, or dropping tables.
 *
 * @author Legacy (3m1n3nc3)
 * @since 0.1.0
 */
-var SchemaBuilder = class {
+var SchemaBuilder = class SchemaBuilder {
 	constructor() {
 		this.operations = [];
 	}
 	/**
+	* Disable foreign-key constraint enforcement on the active PostgreSQL
+	* connection by switching the session into replication mode, which
+	* suppresses the internal triggers that enforce foreign keys.
+	*
+	* The setting is connection-scoped, so the disable, the work that depends
+	* on it, and the matching {@link SchemaBuilder.enableForeignKeyConstraints}
+	* must run on the same connection. Prefer
+	* {@link SchemaBuilder.withoutForeignKeyConstraints}, which guarantees this
+	* by wrapping the work in a transaction. Requires a SQL-backed adapter and
+	* a database role permitted to set `session_replication_role`.
+	*
+	* @returns
+	*/
+	static async disableForeignKeyConstraints() {
+		await SchemaBuilder.setSessionReplicationRole("replica");
+	}
+	/**
+	* Re-enable foreign-key constraint enforcement on the active PostgreSQL
+	* connection by restoring the default session replication role.
+	*
+	* @returns
+	*/
+	static async enableForeignKeyConstraints() {
+		await SchemaBuilder.setSessionReplicationRole("origin");
+	}
+	/**
+	* Run the given callback with foreign-key constraints disabled, then
+	* restore them. The whole unit runs inside a transaction so the disable,
+	* the callback, and the re-enable share a single connection (required for
+	* the connection-scoped replication role to take effect) and roll back
+	* together on failure.
+	*
+	* @example
+	* await SchemaBuilder.withoutForeignKeyConstraints(async () => {
+	*   await User.factory()
+	*     .hasAttached(Tenant.factory().has(Project.factory(3)), { status: 'active' }, 'tenantMemberships')
+	*     .create()
+	* })
+	*
+	* @param callback
+	* @returns
+	*/
+	static async withoutForeignKeyConstraints(callback) {
+		return await runArkormTransaction(async () => {
+			await SchemaBuilder.disableForeignKeyConstraints();
+			try {
+				return await callback();
+			} finally {
+				await SchemaBuilder.enableForeignKeyConstraints();
+			}
+		});
+	}
+	static async setSessionReplicationRole(role) {
+		const adapter = getRuntimeAdapter();
+		if (!adapter) throw new ArkormException("Toggling foreign-key constraints requires a configured database adapter.", {
+			code: "ADAPTER_NOT_CONFIGURED",
+			operation: "schema.foreignKeyConstraints"
+		});
+		if (!adapter.rawQuery) throw new UnsupportedAdapterFeatureException("Toggling foreign-key constraints requires an adapter that supports raw queries.", {
+			operation: "schema.foreignKeyConstraints",
+			meta: { feature: "rawQuery" }
+		});
+		await adapter.rawQuery({ sql: `SET session_replication_role = '${role}'` });
+	}
+	/**
 	* Defines a new table to be created in the migration.
-	* 
+	*
 	* @param table     The name of the table to create.
 	* @param callback  A callback function to define the table's columns and structure.
 	* @returns         The current SchemaBuilder instance for chaining.
@@ -1737,7 +1802,7 @@ var SchemaBuilder = class {
 	}
 	/**
 	* Defines alterations to an existing table in the migration.
-	* 
+	*
 	* @param table     The name of the table to alter.
 	* @param callback  A callback function to define the alterations to the table's columns and structure.
 	* @returns         The current SchemaBuilder instance for chaining.
@@ -1762,7 +1827,7 @@ var SchemaBuilder = class {
 	}
 	/**
 	* Defines a table to be dropped in the migration.
-	* 
+	*
 	* @param table The name of the table to drop.
 	* @returns     The current SchemaBuilder instance for chaining.
 	*/
@@ -1775,7 +1840,7 @@ var SchemaBuilder = class {
 	}
 	/**
 	* Returns a deep copy of the defined schema operations for the migration/
-	* 
+	*
 	* @returns An array of schema operations for the migration.
 	*/
 	getOperations() {
@@ -1851,7 +1916,7 @@ const PRISMA_ENUM_REGEX = /enum\s+(\w+)\s*\{[\s\S]*?\n\}/g;
 const PRISMA_ENUM_MEMBER_REGEX = /^[A-Za-z][A-Za-z0-9_]*$/;
 /**
 * Convert a table name to a PascalCase model name, with basic singularization.
-* 
+*
 * @param tableName The name of the table to convert.
 * @returns The corresponding PascalCase model name.
 */
@@ -1863,16 +1928,16 @@ const toModelName = (tableName) => {
 };
 /**
 * Escape special characters in a string for use in a regular expression.
-* 
-* @param value 
-* @returns 
+*
+* @param value
+* @returns
 */
 const escapeRegex = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 /**
 * Convert a SchemaColumn definition to a Prisma field type string, including modifiers.
-* 
-* @param column 
-* @returns 
+*
+* @param column
+* @returns
 */
 const resolvePrismaType = (column) => {
 	if (column.type === "id") return "Int";
@@ -1891,11 +1956,11 @@ const resolveEnumName = (column) => {
 	if (column.enumName && column.enumName.trim().length > 0) return column.enumName.trim();
 	throw new ArkormException(`Enum column [${column.name}] must define an enum name.`);
 };
-/** 
+/**
 * Format a default value for inclusion in a Prisma schema field definition, based on its type.
-* 
-* @param value 
-* @returns 
+*
+* @param value
+* @returns
 */
 const formatDefaultValue = (value) => {
 	if (value == null) return void 0;
@@ -1906,9 +1971,9 @@ const formatDefaultValue = (value) => {
 };
 /**
 * Format a default value for an enum column as a Prisma @default attribute, validating that it is a non-empty string.
-* 
-* @param value 
-* @returns 
+*
+* @param value
+* @returns
 */
 const formatEnumDefaultValue = (value) => {
 	if (value == null) return void 0;
@@ -1917,9 +1982,9 @@ const formatEnumDefaultValue = (value) => {
 };
 /**
 * Normalize an enum value by ensuring it is a non-empty string and trimming whitespace.
-* 
-* @param value 
-* @returns 
+*
+* @param value
+* @returns
 */
 const normalizeEnumValue = (value) => {
 	if (typeof value !== "string" || value.trim().length === 0) throw new ArkormException("Enum values must be provided as non-empty strings.");
@@ -1929,9 +1994,9 @@ const normalizeEnumValue = (value) => {
 };
 /**
 * Extract the enum values from a Prisma enum block string.
-* 
-* @param block 
-* @returns 
+*
+* @param block
+* @returns
 */
 const extractEnumBlockValues = (block) => {
 	return block.split("\n").slice(1, -1).map((line) => line.trim()).filter(Boolean);
@@ -1947,11 +2012,11 @@ const validateEnumValues = (column, enumName, enumValues) => {
 };
 /**
 * Validate that a default value for an enum column is included in the defined enum values.
-* 
-* @param column 
-* @param enumName 
-* @param enumValues 
-* @returns 
+*
+* @param column
+* @param enumName
+* @param enumValues
+* @returns
 */
 const validateEnumDefaultValue = (column, enumName, enumValues) => {
 	if (column.default == null) return;
@@ -1961,9 +2026,9 @@ const validateEnumDefaultValue = (column, enumName, enumValues) => {
 };
 /**
 * Build a single line of a Prisma model field definition based on a SchemaColumn, including type and modifiers.
-* 
-* @param column 
-* @returns 
+*
+* @param column
+* @returns
 */
 const buildFieldLine = (column) => {
 	if (column.type === "id") {
@@ -1985,9 +2050,9 @@ const buildFieldLine = (column) => {
 	return `  ${column.name} ${scalar}${nullable}${primary}${unique}${defaultSuffix}${updatedAt}${mapped}`;
 };
 /**
-* Build a Prisma enum block string based on an enum name and its values, validating that 
+* Build a Prisma enum block string based on an enum name and its values, validating that
 * at least one value is provided.
-* 
+*
 * @param enumName      The name of the enum to create.
 * @param values        The array of values for the enum.
 * @returns             The Prisma enum block string.
@@ -1997,12 +2062,12 @@ const buildEnumBlock = (enumName, values) => {
 	return `enum ${enumName} {\n${values.map((value) => `  ${value}`).join("\n")}\n}`;
 };
 /**
-* Find the Prisma enum block in a schema string that corresponds to a given enum 
+* Find the Prisma enum block in a schema string that corresponds to a given enum
 * name, returning its details if found.
-* 
+*
 * @param schema        The Prisma schema string to search for the enum block.
 * @param enumName      The name of the enum to find in the schema.
-* @returns 
+* @returns
 */
 const findEnumBlock = (schema, enumName) => {
 	const candidates = [...schema.matchAll(PRISMA_ENUM_REGEX)];
@@ -2021,13 +2086,13 @@ const findEnumBlock = (schema, enumName) => {
 	return null;
 };
 /**
-* Ensure that Prisma enum blocks exist in the schema for any enum columns defined in a 
-* create or alter table operation, adding them if necessary and validating against 
+* Ensure that Prisma enum blocks exist in the schema for any enum columns defined in a
+* create or alter table operation, adding them if necessary and validating against
 * existing blocks.
-* 
+*
 * @param schema    The current Prisma schema string to check and modify.
 * @param columns   The array of schema column definitions to check for enum types and ensure corresponding blocks exist for.
-* @returns 
+* @returns
 */
 const ensureEnumBlocks = (schema, columns) => {
 	let nextSchema = schema;
@@ -2057,9 +2122,9 @@ const ensureEnumBlocks = (schema, columns) => {
 };
 /**
 * Build a Prisma model-level @@index definition line.
-* 
+*
 * @param index     The schema index definition to convert to a Prisma \@\@index line.
-* @returns 
+* @returns
 */
 const buildIndexLine = (index) => {
 	return `  @@index([${index.columns.join(", ")}]${typeof index.name === "string" && index.name.trim().length > 0 ? `, name: "${index.name.replace(/"/g, "\\\"")}"` : ""})`;
@@ -2083,9 +2148,9 @@ const buildUniqueConstraintLine = (constraint) => {
 	return `  @@unique([${constraint.columns.join(", ")}]${typeof constraint.name === "string" && constraint.name.trim().length > 0 ? `, name: "${constraint.name.replace(/"/g, "\\\"")}"` : ""})`;
 };
 /**
-* Derive a relation field name from a foreign key column name by applying 
+* Derive a relation field name from a foreign key column name by applying
 * common conventions, such as removing "Id" suffixes and converting to camelCase.
-* 
+*
 * @param columnName    The name of the foreign key column.
 * @returns             The derived relation field name.
 */
@@ -2100,10 +2165,10 @@ const deriveRelationFieldName = (columnName) => {
 	return `${trimmed.charAt(0).toLowerCase()}${trimmed.slice(1)}`;
 };
 /**
-* Derive a relation name for both sides of a relation based on the 
-* source and target model names, using an explicit alias if provided or a 
+* Derive a relation name for both sides of a relation based on the
+* source and target model names, using an explicit alias if provided or a
 * convention of combining the full source model name with the target model name.
-* 
+*
 * @param sourceModelName    The name of the source model in the relation.
 * @param targetModelName    The name of the target model in the relation.
 * @param explicitAlias      An optional explicit alias for the relation.
@@ -2130,9 +2195,9 @@ const resolveForeignKeyColumn = (columns, foreignKey) => {
 const isOneToOneForeignKey = (column) => {
 	return Boolean(column?.unique || column?.primary);
 };
-/** 
+/**
 * Format a SchemaForeignKeyAction value as a Prisma onDelete action string.
-* 
+*
 * @param action    The foreign key action to format.
 * @returns         The corresponding Prisma onDelete action string.
 */
@@ -2144,9 +2209,9 @@ const formatRelationAction = (action) => {
 	return "NoAction";
 };
 /**
-* Build a Prisma relation field line based on a SchemaForeignKey 
+* Build a Prisma relation field line based on a SchemaForeignKey
 * definition, including relation name and onDelete action.
-* 
+*
 * @param foreignKey    The foreign key definition to convert to a relation line.
 * @returns             The corresponding Prisma schema line for the relation field.
 */
@@ -2162,10 +2227,10 @@ const buildRelationLine = (sourceModelName, foreignKey, columns = []) => {
 	return `  ${fieldName} ${targetModel}${optional} @relation("${relationName.replace(/"/g, "\\\"")}", fields: [${foreignKey.column}], references: [${foreignKey.referencesColumn}]${onDelete})`;
 };
 /**
-* Build a Prisma relation field line for the inverse side of a relation, based 
-* on the source and target model names and the foreign key definition, using 
+* Build a Prisma relation field line for the inverse side of a relation, based
+* on the source and target model names and the foreign key definition, using
 * naming conventions and any explicit inverse alias provided.
-* 
+*
 * @param sourceModelName   The name of the source model in the relation.
 * @param targetModelName   The name of the target model in the relation.
 * @param foreignKey        The foreign key definition for the relation.
@@ -2178,14 +2243,14 @@ const buildInverseRelationLine = (sourceModelName, targetModelName, foreignKey,
 	return `  ${fieldName} ${isOneToOneForeignKey(sourceColumn) ? `${sourceModelName}?` : `${sourceModelName}[]`} @relation("${relationName.replace(/"/g, "\\\"")}")`;
 };
 /**
-* Inject a line into the body of a Prisma model block if it does not already 
-* exist, using a provided existence check function to determine if the line 
+* Inject a line into the body of a Prisma model block if it does not already
+* exist, using a provided existence check function to determine if the line
 * is already present.
-* 
+*
 * @param bodyLines The lines of the model block body to modify.
 * @param line      The line to inject if it does not already exist.
 * @param exists    A function that checks if a given line already exists in the body.
-* @returns 
+* @returns
 */
 const injectLineIntoModelBody = (bodyLines, line, exists) => {
 	if (bodyLines.some(exists)) return bodyLines;
@@ -2194,10 +2259,10 @@ const injectLineIntoModelBody = (bodyLines, line, exists) => {
 	return bodyLines;
 };
 /**
-* Apply inverse relation definitions to a Prisma schema string based on the 
-* foreign keys defined in a create or alter table operation, ensuring that 
+* Apply inverse relation definitions to a Prisma schema string based on the
+* foreign keys defined in a create or alter table operation, ensuring that
 * related models have corresponding relation fields for bi-directional navigation.
-* 
+*
 * @param schema The Prisma schema string to modify.
 * @param sourceModelName The name of the source model in the relation.
 * @param foreignKeys An array of foreign key definitions to process.
@@ -2220,9 +2285,9 @@ const applyInverseRelations = (schema, sourceModelName, foreignKeys, columns = [
 	return nextSchema;
 };
 /**
-* Build a Prisma model block string based on a SchemaTableCreateOperation, including 
+* Build a Prisma model block string based on a SchemaTableCreateOperation, including
 * all fields and any necessary mapping.
-* 
+*
 * @param operation The schema table create operation to convert.
 * @returns         The corresponding Prisma model block string.
 */
@@ -2247,12 +2312,12 @@ const buildModelBlock = (operation) => {
 	] : [...fields, ...relations]).join("\n")}\n}`;
 };
 /**
-* Find the Prisma model block in a schema string that corresponds to a given 
+* Find the Prisma model block in a schema string that corresponds to a given
 * table name, using both explicit mapping and naming conventions.
-* 
-* @param schema 
-* @param table 
-* @returns 
+*
+* @param schema
+* @param table
+* @returns
 */
 const findModelBlock = (schema, table) => {
 	const candidates = [...schema.matchAll(PRISMA_MODEL_REGEX)];
@@ -2284,9 +2349,9 @@ const findModelBlock = (schema, table) => {
 	return null;
 };
 /**
-* Apply a create table operation to a Prisma schema string, adding a new model 
+* Apply a create table operation to a Prisma schema string, adding a new model
 * block for the specified table and fields.
-* 
+*
 * @param schema    The current Prisma schema string.
 * @param operation The schema table create operation to apply.
 * @returns         The updated Prisma schema string with the new model block.
@@ -2298,9 +2363,9 @@ const applyCreateTableOperation = (schema, operation) => {
 	return applyInverseRelations(`${schemaWithEnums.trimEnd()}\n\n${block}\n`, toModelName(operation.table), operation.foreignKeys ?? [], operation.columns);
 };
 /**
-* Apply an alter table operation to a Prisma schema string, modifying the model 
+* Apply an alter table operation to a Prisma schema string, modifying the model
 * block for the specified table by adding and removing fields as needed.
-* 
+*
 * @param schema    The current Prisma schema string.
 * @param operation The schema table alter operation to apply.
 * @returns         The updated Prisma schema string with the modified model block.
@@ -2367,10 +2432,10 @@ const applyDropTableOperation = (schema, operation) => {
 	return `${before}${before && after ? "\n\n" : ""}${after}`;
 };
 /**
-* The SchemaBuilder class provides a fluent interface for defining 
-* database schema operations in a migration, such as creating, altering, and 
+* The SchemaBuilder class provides a fluent interface for defining
+* database schema operations in a migration, such as creating, altering, and
 * dropping tables.
-* 
+*
 * @param schema        The current Prisma schema string.
 * @param operations    The list of schema operations to apply.
 * @returns             The updated Prisma schema string after applying all operations.
@@ -2384,7 +2449,7 @@ const applyOperationsToPrismaSchema = (schema, operations) => {
 };
 /**
 * Run a Prisma CLI command using npx, capturing and throwing any errors that occur.
-* 
+*
 * @param args The arguments to pass to the Prisma CLI command.
 * @param cwd The current working directory to run the command in.
 * @returns void
@@ -2399,11 +2464,11 @@ const runPrismaCommand = (args, cwd) => {
 	throw new ArkormException(errorOutput ? `Prisma command failed: prisma ${args.join(" ")}\n${errorOutput}` : `Prisma command failed: prisma ${args.join(" ")}`);
 };
 /**
-* Generate a new migration file with a given name and options, including 
+* Generate a new migration file with a given name and options, including
 * writing the file to disk if specified.
-* 
-* @param name 
-* @returns 
+*
+* @param name
+* @returns
 */
 const resolveMigrationClassName = (name) => {
 	const cleaned = name.replace(/[^a-zA-Z0-9]+/g, " ").trim();
@@ -2411,39 +2476,39 @@ const resolveMigrationClassName = (name) => {
 	return `${cleaned.split(/\s+/g).map((part) => `${part.charAt(0).toUpperCase()}${part.slice(1)}`).join("")}Migration`;
 };
 /**
-* Pad a number with leading zeros to ensure it is at least two digits, for 
+* Pad a number with leading zeros to ensure it is at least two digits, for
 * use in migration timestamps.
-* 
-* @param value 
-* @returns 
+*
+* @param value
+* @returns
 */
 const pad = (value) => String(value).padStart(2, "0");
 /**
-* Create a timestamp string in the format YYYYMMDDHHMMSS for use in migration 
+* Create a timestamp string in the format YYYYMMDDHHMMSS for use in migration
 * file names, based on the current date and time or a provided date.
-* 
-* @param date 
-* @returns 
+*
+* @param date
+* @returns
 */
 const createMigrationTimestamp = (date = /* @__PURE__ */ new Date()) => {
 	return `${date.getFullYear()}${pad(date.getMonth() + 1)}${pad(date.getDate())}${pad(date.getHours())}${pad(date.getMinutes())}${pad(date.getSeconds())}`;
 };
 /**
-* Convert a migration name to a slug suitable for use in a file name, by 
+* Convert a migration name to a slug suitable for use in a file name, by
 * lowercasing and replacing non-alphanumeric characters with underscores.
-* 
-* @param name 
-* @returns 
+*
+* @param name
+* @returns
 */
 const toMigrationFileSlug = (name) => {
 	return name.trim().toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "") || "migration";
 };
 /**
-* Build the source code for a new migration file based on a given class 
+* Build the source code for a new migration file based on a given class
 * name, using a template with empty up and down methods.
-* 
-* @param className 
-* @returns 
+*
+* @param className
+* @returns
 */
 const buildMigrationSource = (className, extension = "ts") => {
 	if (extension === "js") return [
@@ -2480,12 +2545,12 @@ const buildMigrationSource = (className, extension = "ts") => {
 	].join("\n");
 };
 /**
-* Generate a new migration file with a given name and options, including 
+* Generate a new migration file with a given name and options, including
 * writing the file to disk if specified, and return the details of the generated file.
-* 
-* @param name 
-* @param options 
-* @returns 
+*
+* @param name
+* @param options
+* @returns
 */
 const generateMigrationFile = (name, options = {}) => {
 	const timestamp = createMigrationTimestamp(/* @__PURE__ */ new Date());
@@ -2510,10 +2575,10 @@ const generateMigrationFile = (name, options = {}) => {
 };
 /**
 * Get the list of schema operations that would be performed by a given migration class when run in a specified direction (up or down), without actually applying them.
-* 
+*
 * @param migration The migration class or instance to analyze.
 * @param direction The direction of the migration to plan for ('up' or 'down').
-* @returns         A promise that resolves to an array of schema operations that would be performed.   
+* @returns         A promise that resolves to an array of schema operations that would be performed.
 */
 const getMigrationPlan = async (migration, direction = "up") => {
 	const instance = typeof migration === "function" ? new migration() : migration;
@@ -2548,10 +2613,10 @@ const applyMigrationRollbackToDatabase = async (adapter, migration) => {
 	return { operations };
 };
 /**
-* Apply the schema operations defined in a migration to a Prisma schema 
-* file, updating the file on disk if specified, and return the updated 
+* Apply the schema operations defined in a migration to a Prisma schema
+* file, updating the file on disk if specified, and return the updated
 * schema and list of operations applied.
-* 
+*
 * @param migration The migration class or instance to apply.
 * @param options   Options for applying the migration, including schema path and write flag.
 * @returns         A promise that resolves to an object containing the updated schema, schema path, and list of operations applied.
@@ -2590,10 +2655,10 @@ const applyMigrationRollbackToPrismaSchema = async (migration, options = {}) =>
 	};
 };
 /**
-* Run a migration by applying its schema operations to a Prisma schema 
-* file, optionally generating Prisma client code and running migrations after 
+* Run a migration by applying its schema operations to a Prisma schema
+* file, optionally generating Prisma client code and running migrations after
 * applying the schema changes.
-* 
+*
 * @param migration The migration class or instance to run.
 * @param options   Options for running the migration, including schema path, write flag, and Prisma commands.
 * @returns         A promise that resolves to an object containing the schema path and list of operations applied.
@@ -2975,8 +3040,8 @@ const normalizePathInput = (paths) => {
 const normalizeConstructors = (items) => items.flatMap((item) => Array.isArray(item) ? item : [item]).filter(Boolean);
 /**
 * Register additional runtime discovery paths without replacing configured paths.
-* 
-* @param paths 
+*
+* @param paths
 */
 const registerPaths = (paths) => {
 	Object.entries(paths).forEach(([key, value]) => {
@@ -2985,69 +3050,69 @@ const registerPaths = (paths) => {
 };
 /**
 * Register additional runtime discovery paths for migrations without replacing configured paths.
-* 
-* @param paths 
-* @returns 
+*
+* @param paths
+* @returns
 */
 const loadMigrationsFrom = (paths) => registerPaths({ migrations: paths });
 /**
 * Register additional runtime discovery paths for seeders without replacing configured paths.
-* 
-* @param paths 
-* @returns 
+*
+* @param paths
+* @returns
 */
 const loadSeedersFrom = (paths) => registerPaths({ seeders: paths });
 /**
 * Register additional runtime discovery paths for models without replacing configured paths.
-* 
-* @param paths 
-* @returns 
+*
+* @param paths
+* @returns
 */
 const loadModelsFrom = (paths) => registerPaths({ models: paths });
 /**
 * Register additional runtime discovery paths for factories without replacing configured paths.
-* 
-* @param paths 
-* @returns 
+*
+* @param paths
+* @returns
 */
 const loadFactoriesFrom = (paths) => registerPaths({ factories: paths });
 /**
 * Register migration constructors directly without relying on runtime discovery.
-* 
-* @param migrations 
+*
+* @param migrations
 */
 const registerMigrations = (...migrations) => {
 	pushUnique(registry.migrations, normalizeConstructors(migrations));
 };
 /**
 * Register seeder constructors directly without relying on runtime discovery.
-* 
-* @param seeders 
+*
+* @param seeders
 */
 const registerSeeders = (...seeders) => {
 	pushUnique(registry.seeders, normalizeConstructors(seeders));
 };
 /**
 * Register model constructors directly without relying on runtime discovery.
-* 
-* @param models 
+*
+* @param models
 */
 const registerModels = (...models) => {
 	pushUnique(registry.models, normalizeConstructors(models));
 };
 /**
 * Register factory constructors or instances directly without relying on runtime discovery.
-* 
-* @param factories 
+*
+* @param factories
 */
 const registerFactories = (...factories) => {
 	pushUnique(registry.factories, normalizeConstructors(factories));
 };
 /**
 * Get registered runtime discovery paths or registered constructors for a specific type.
-* 
-* @param key 
-* @returns 
+*
+* @param key
+* @returns
 */
 const getRegisteredPaths = (key) => {
 	if (key) return [...registry.paths[key]];
@@ -3060,26 +3125,26 @@ const getRegisteredPaths = (key) => {
 };
 /**
 * Get registered migration constructors instances.
-* 
-* @returns 
+*
+* @returns
 */
 const getRegisteredMigrations = () => [...registry.migrations];
 /**
 * Get registered seeder constructors instances.
-* 
-* @returns 
+*
+* @returns
 */
 const getRegisteredSeeders = () => [...registry.seeders];
 /**
 * Get registered model constructors instances.
-* 
-* @returns 
+*
+* @returns
 */
 const getRegisteredModels = () => [...registry.models];
 /**
 * Get registered factory constructors or instances.
-* 
-* @returns 
+*
+* @returns
 */
 const getRegisteredFactories = () => [...registry.factories];
 const resetRuntimeRegistryForTests = () => {
@@ -3183,9 +3248,9 @@ const mergePathConfig = (paths) => {
 };
 /**
 * Merge the feature configuration from the base defaults, user configuration, and provided options.
-* 
-* @param features 
-* @returns 
+*
+* @param features
+* @returns
 */
 const mergeFeatureConfig = (features) => {
 	const defaults = baseConfig.features ?? {};
@@ -3241,7 +3306,7 @@ const awaitConfiguredModelsRegistration = async () => {
 };
 /**
 * Define the ArkORM runtime configuration. This function can be used to provide.
-* 
+*
 * @param config The ArkORM configuration object.
 * @returns The same configuration object.
 */
@@ -3250,10 +3315,10 @@ const defineConfig = (config) => {
 };
 /**
 * Bind a database adapter instance to an array of models that support adapter binding.
-* 
-* @param adapter 
-* @param models 
-* @returns 
+*
+* @param adapter
+* @param models
+* @returns
 */
 const bindAdapterToModels = (adapter, models) => {
 	models.forEach((model) => {
@@ -3262,10 +3327,10 @@ const bindAdapterToModels = (adapter, models) => {
 	return adapter;
 };
 /**
-* Get the user-provided ArkORM configuration. 
-* 
+* Get the user-provided ArkORM configuration.
+*
 * @param key Optional specific configuration key to retrieve. If omitted, the entire configuration object is returned.
-* @returns The user-provided ArkORM configuration object.  
+* @returns The user-provided ArkORM configuration object.
 */
 const getUserConfig = (key) => {
 	if (key) return userConfig[key];
@@ -3274,8 +3339,8 @@ const getUserConfig = (key) => {
 /**
 * Configure the ArkORM runtime with the provided runtime client resolver and
 * adapter-first options.
-* 
-* @param client 
+*
+* @param client
 * @param options
 */
 const configureArkormRuntime = (client, options = {}) => {
@@ -3308,7 +3373,7 @@ const configureArkormRuntime = (client, options = {}) => {
 	});
 };
 /**
-* Reset the ArkORM runtime configuration. 
+* Reset the ArkORM runtime configuration.
 * This is primarily intended for testing purposes.
 */
 const resetArkormRuntimeForTests = () => {
@@ -3333,9 +3398,9 @@ const resetArkormRuntimeForTests = () => {
 /**
 * Resolve a runtime client instance from the provided resolver, which can be either
 * a direct client instance or a function that returns a client instance.
-* 
-* @param resolver 
-* @returns 
+*
+* @param resolver
+* @returns
 */
 const resolveClient = (resolver) => {
 	if (!resolver) return void 0;
@@ -3344,12 +3409,12 @@ const resolveClient = (resolver) => {
 	return client;
 };
 /**
-* Resolve and apply the ArkORM configuration from an imported module. 
+* Resolve and apply the ArkORM configuration from an imported module.
 * This function checks for a default export and falls back to the module itself, then validates
 * the configuration object and applies it to the runtime if valid.
-* 
-* @param imported 
-* @returns 
+*
+* @param imported
+* @returns
 */
 const resolveAndApplyConfig = (imported) => {
 	const config = imported?.default ?? imported;
@@ -3369,11 +3434,11 @@ const resolveAndApplyConfig = (imported) => {
 	runtimeConfigLoaded = true;
 };
 /**
-* Dynamically import a configuration file. 
+* Dynamically import a configuration file.
 * A cache-busting query parameter is appended to ensure the latest version is loaded.
-* 
-* @param configPath 
-* @returns A promise that resolves to the imported configuration module.   
+*
+* @param configPath
+* @returns A promise that resolves to the imported configuration module.
 */
 const importConfigFile = (configPath) => {
 	return RuntimeModuleLoader.load(configPath);
@@ -3393,9 +3458,9 @@ const loadRuntimeConfigSync = () => {
 	return false;
 };
 /**
-* Load the ArkORM configuration by searching for configuration files in the 
+* Load the ArkORM configuration by searching for configuration files in the
 * current working directory.
-* @returns 
+* @returns
 */
 const loadArkormConfig = async () => {
 	if (runtimeConfigLoaded) {
@@ -3426,11 +3491,11 @@ const loadArkormConfig = async () => {
 	await runtimeConfigLoadingPromise;
 };
 /**
-* Ensure that the ArkORM configuration is loaded. 
+* Ensure that the ArkORM configuration is loaded.
 * This function can be called to trigger the loading process if it hasn't already been initiated.
 * If the configuration is already loaded, it will return immediately.
-* 
-* @returns 
+*
+* @returns
 */
 const ensureArkormConfigLoading = () => {
 	if (runtimeConfigLoaded) return;
@@ -3441,10 +3506,10 @@ const getDefaultStubsPath = () => {
 };
 /**
 * Get the runtime compatibility client.
-* This function will trigger the loading of the ArkORM configuration if 
+* This function will trigger the loading of the ArkORM configuration if
 * it hasn't already been loaded.
-* 
-* @returns 
+*
+* @returns
 */
 const getRuntimeClient = () => {
 	const activeTransactionClient = transactionClientStorage.getStore();
@@ -3458,8 +3523,8 @@ const getRuntimeClient = () => {
 const getRuntimePrismaClient = getRuntimeClient;
 /**
 * Get the currently configured runtime adapter, if any.
-* 
-* @returns 
+*
+* @returns
 */
 const getRuntimeAdapter = () => {
 	const activeTransactionAdapter = transactionAdapterStorage.getStore();
@@ -3536,7 +3601,7 @@ const emitRuntimeDebugEvent = (event) => {
 /**
 * Check if a given value matches Arkorm's query-schema contract
 * by verifying the presence of common delegate methods.
-* 
+*
 * @param value The value to check.
 * @returns True if the value matches the query-schema contract, false otherwise.
 */
@@ -3562,7 +3627,7 @@ loadArkormConfig();
 //#region src/URLDriver.ts
 /**
 * URLDriver builds pagination URLs from paginator options.
-* 
+*
 * @author Legacy (3m1n3nc3)
 * @since 0.1.0
 */
@@ -3605,7 +3670,7 @@ var URLDriver = class URLDriver {
 /**
 * The LengthAwarePaginator class encapsulates paginated results with full
 * metadata including the total result count and last page.
-* 
+*
 * @template T The type of the data being paginated.
 * @author Legacy (3m1n3nc3)
 * @since 0.1.0
@@ -3613,7 +3678,7 @@ var URLDriver = class URLDriver {
 var LengthAwarePaginator = class {
 	/**
 	* Creates a new LengthAwarePaginator instance.
-	* 
+	*
 	* @param data          The collection of data being paginated.
 	* @param total         The total number of items.
 	* @param perPage       The number of items per page.
@@ -3658,8 +3723,8 @@ var LengthAwarePaginator = class {
 	}
 	/**
 	* Converts the paginator instance to a JSON-serializable object.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	toJSON() {
 		return {
@@ -3734,7 +3799,7 @@ var Paginator = class {
 //#region src/relationship/Relation.ts
 /**
 * Base class for all relationship types. Not meant to be used directly.
-* 
+*
 * @author Legacy (3m1n3nc3)
 * @since 0.1.0
 */
@@ -3780,7 +3845,7 @@ var Relation = class {
 	}
 	/**
 	* Apply a constraint to the relationship query.
-	* 
+	*
 	* @param constraint The constraint function to apply to the query.
 	* @returns The current relation instance.
 	*/
@@ -3884,81 +3949,81 @@ var Relation = class {
 	}
 	/**
 	* Adds clause to determine if a column's value is in the past
-	* 
-	* @param key 
-	* @returns 
+	*
+	* @param key
+	* @returns
 	*/
 	wherePast(key) {
 		return this.constrain((query) => query.wherePast(key));
 	}
 	/**
 	* Adds clause to determine if a column's value is in the future
-	* 
-	* @param key 
-	* @returns 
+	*
+	* @param key
+	* @returns
 	*/
 	whereFuture(key) {
 		return this.constrain((query) => query.whereFuture(key));
 	}
 	/**
 	* 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.constrain((query) => query.whereNowOrPast(key));
 	}
 	/**
 	* 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.constrain((query) => query.whereNowOrFuture(key));
 	}
 	/**
 	* Adds clause to determine if a column's value is today
-	* 
-	* @param key 
-	* @returns 
+	*
+	* @param key
+	* @returns
 	*/
 	whereToday(key) {
 		return this.constrain((query) => query.whereToday(key));
 	}
 	/**
 	* Adds clause to determine if a column's value is before today
-	* 
-	* @param key 
-	* @returns 
+	*
+	* @param key
+	* @returns
 	*/
 	whereBeforeToday(key) {
 		return this.constrain((query) => query.whereBeforeToday(key));
 	}
 	/**
 	* Adds clause to determine if a column's value is after today
-	* 
-	* @param key 
-	* @returns 
+	*
+	* @param key
+	* @returns
 	*/
 	whereAfterToday(key) {
 		return this.constrain((query) => query.whereAfterToday(key));
 	}
 	/**
 	* Adds clause to determine if a column's value is today or before today
-	* 
-	* @param key 
-	* @returns 
+	*
+	* @param key
+	* @returns
 	*/
 	whereTodayOrBefore(key) {
 		return this.constrain((query) => query.whereTodayOrBefore(key));
 	}
 	/**
 	* Adds clause to determine if a column's value is today or after today
-	* 
-	* @param key 
-	* @returns 
+	*
+	* @param key
+	* @returns
 	*/
 	whereTodayOrAfter(key) {
 		return this.constrain((query) => query.whereTodayOrAfter(key));
@@ -3968,9 +4033,9 @@ var Relation = class {
 	}
 	/**
 	* Adds "where exists" SQL clauses.
-	* 
-	* @param queryOrCallback 
-	* @returns 
+	*
+	* @param queryOrCallback
+	* @returns
 	*/
 	whereExists(queryOrCallback) {
 		return this.constrain((query) => query.whereExists(queryOrCallback));
@@ -4069,107 +4134,107 @@ var Relation = class {
 	}
 	/**
 	* Add an OR string contains clause to the relationship query.
-	* 
-	* @param key 
-	* @param value 
-	* @returns 
+	*
+	* @param key
+	* @param value
+	* @returns
 	*/
 	orWhereLike(key, value) {
 		return this.constrain((query) => query.orWhereLike(key, value));
 	}
 	/**
 	* Add a negated string contains (NOT LIKE) clause to the relationship query.
-	* 
-	* @param key 
-	* @param value 
-	* @returns 
+	*
+	* @param key
+	* @param value
+	* @returns
 	*/
 	whereNotLike(key, value) {
 		return this.constrain((query) => query.whereNotLike(key, value));
 	}
 	/**
 	* Add an OR negated string contains (NOT LIKE) clause to the relationship query.
-	* 
-	* @param key 
-	* @param value 
-	* @returns 
+	*
+	* @param key
+	* @param value
+	* @returns
 	*/
 	orWhereNotLike(key, value) {
 		return this.constrain((query) => query.orWhereNotLike(key, value));
 	}
 	/**
 	* Add a JSON containment clause to the relationship query.
-	* 
-	* @param key 
-	* @param value 
-	* @returns 
+	*
+	* @param key
+	* @param value
+	* @returns
 	*/
 	whereJsonContains(column, value) {
 		return this.constrain((query) => query.whereJsonContains(column, value));
 	}
 	/**
 	* OR variant of whereJsonContains().
-	* 
-	* @param column 
-	* @param value 
-	* @returns 
+	*
+	* @param column
+	* @param value
+	* @returns
 	*/
 	orWhereJsonContains(column, value) {
 		return this.constrain((query) => query.orWhereJsonContains(column, value));
 	}
 	/**
 	* Add a negated JSON containment clause to the relationship query.
-	* 
-	* @param column 
-	* @param value 
-	* @returns 
+	*
+	* @param column
+	* @param value
+	* @returns
 	*/
 	whereJsonDoesntContain(column, value) {
 		return this.constrain((query) => query.whereJsonDoesntContain(column, value));
 	}
 	/**
 	* OR variant of whereJsonDoesntContain().
-	* 
-	* @param column 
-	* @param value 
-	* @returns 
+	*
+	* @param column
+	* @param value
+	* @returns
 	*/
 	orWhereJsonDoesntContain(column, value) {
 		return this.constrain((query) => query.orWhereJsonDoesntContain(column, value));
 	}
 	/**
 	* Add a JSON key-existence clause to the relationship query.
-	* 
-	* @param column 
-	* @param value 
-	* @returns 
+	*
+	* @param column
+	* @param value
+	* @returns
 	*/
 	whereJsonContainsKey(column) {
 		return this.constrain((query) => query.whereJsonContainsKey(column));
 	}
 	/**
 	* OR variant of whereJsonContainsKey().
-	* 
-	* @param column 
-	* @returns 
+	*
+	* @param column
+	* @returns
 	*/
 	orWhereJsonContainsKey(column) {
 		return this.constrain((query) => query.orWhereJsonContainsKey(column));
 	}
 	/**
 	* Add a negated JSON key-existence clause to the relationship query.
-	* 
-	* @param column 
-	* @returns 
+	*
+	* @param column
+	* @returns
 	*/
 	whereJsonDoesntContainKey(column) {
 		return this.constrain((query) => query.whereJsonDoesntContainKey(column));
 	}
 	/**
 	* OR variant of whereJsonDoesntContainKey().
-	* 
-	* @param column 
-	* @returns 
+	*
+	* @param column
+	* @returns
 	*/
 	orWhereJsonDoesntContainKey(column) {
 		return this.constrain((query) => query.orWhereJsonDoesntContainKey(column));
@@ -4182,18 +4247,18 @@ var Relation = class {
 	}
 	/**
 	* Add a JSON array overlap clause to the relationship query.
-	* 
-	* @param column 
-	* @param value 
+	*
+	* @param column
+	* @param value
 	*/
 	whereJsonOverlaps(column, value) {
 		return this.constrain((query) => query.whereJsonOverlaps(column, value));
 	}
 	/**
 	* OR variant of whereJsonOverlaps().
-	* 
-	* @param column 
-	* @param value 
+	*
+	* @param column
+	* @param value
 	*/
 	orWhereJsonOverlaps(column, value) {
 		return this.constrain((query) => query.orWhereJsonOverlaps(column, value));
@@ -4420,9 +4485,9 @@ var Relation = class {
 	}
 	/**
 	* Apply the defined constraint to the given query, if any.
-	* 
+	*
 	* @param query The query builder instance to apply the constraint to.
-	* 
+	*
 	* @returns The query builder instance with the constraint applied, if any.
 	*/
 	applyConstraint(query) {
@@ -4449,18 +4514,18 @@ var Relation = class {
 	}
 	/**
 	* Execute the relationship query and return the first related model or throw an error if not found.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	async firstOrFail() {
 		return (await this.getQuery()).firstOrFail();
 	}
 	/**
-	* Execute the relationship query and return the first related model or the result of 
+	* Execute the relationship query and return the first related model or the result of
 	* the callback if not found.
-	* 
-	* @param callback 
-	* @returns 
+	*
+	* @param callback
+	* @returns
 	*/
 	async firstOr(callback) {
 		const result = await this.first();
@@ -4496,11 +4561,11 @@ var Relation = class {
 		return !await this.exists();
 	}
 	/**
-	* Create a new instance of the related model with the given attributes and 
+	* Create a new instance of the related model with the given attributes and
 	* relationship creation attributes applied, but do not save it.
-	* 
-	* @param attributes 
-	* @returns 
+	*
+	* @param attributes
+	* @returns
 	*/
 	make(attributes = {}) {
 		const model = this.getRelatedModelConstructor().hydrate(this.mergeCreationAttributes(attributes));
@@ -4508,31 +4573,31 @@ var Relation = class {
 		return model;
 	}
 	/**
-	* Create new instances of the related model with the given attributes and relationship 
+	* Create new instances of the related model with the given attributes and relationship
 	* creation attributes applied, but do not save them.
-	* 
-	* @param attributes 
-	* @returns 
+	*
+	* @param attributes
+	* @returns
 	*/
 	makeMany(attributes = []) {
 		return attributes.map((item) => this.make(item));
 	}
 	/**
-	* Create a new instance of the related model with the given attributes and relationship 
+	* Create a new instance of the related model with the given attributes and relationship
 	* creation attributes applied, and save it to the database.
-	* 
-	* @param attributes 
-	* @returns 
+	*
+	* @param attributes
+	* @returns
 	*/
 	async create(attributes = {}) {
 		return await this.getRelatedModelConstructor().query().create(this.mergeCreationAttributes(attributes));
 	}
 	/**
-	* Create new instances of the related model with the given attributes and relationship 
+	* Create new instances of the related model with the given attributes and relationship
 	* creation attributes applied, and save them to the database.
-	* 
-	* @param values 
-	* @returns 
+	*
+	* @param values
+	* @returns
 	*/
 	async createMany(values = []) {
 		if (values.length === 0) return [];
@@ -4540,9 +4605,9 @@ var Relation = class {
 	}
 	/**
 	* Save the given model instance by applying relationship creation attributes and calling save() on it.
-	* 
-	* @param model 
-	* @returns 
+	*
+	* @param model
+	* @returns
 	*/
 	async save(model) {
 		const saveable = this.applyCreationAttributesToModel(model);
@@ -4556,11 +4621,11 @@ var Relation = class {
 		}
 	}
 	/**
-	* Save the given model instance by applying relationship creation attributes and 
+	* Save the given model instance by applying relationship creation attributes and
 	* calling saveQuietly() on it if supported, otherwise falling back to save().
-	* 
-	* @param model 
-	* @returns 
+	*
+	* @param model
+	* @returns
 	*/
 	async saveQuietly(model) {
 		const saveable = this.applyCreationAttributesToModel(model);
@@ -4578,21 +4643,21 @@ var Relation = class {
 		return error instanceof Error && (error.name === "ModelNotFoundException" || error.message.includes("Record not found"));
 	}
 	/**
-	* Create new instances of the related model with the given attributes and 
+	* Create new instances of the related model with the given attributes and
 	* relationship * creation attributes applied, and save them to the database.
-	* 
-	* @param models 
-	* @returns 
+	*
+	* @param models
+	* @returns
 	*/
 	async saveMany(models = []) {
 		return await Promise.all(models.map(async (model) => await this.save(model)));
 	}
 	/**
-	* Create new instances of the related model with the given attributes and relationship 
+	* Create new instances of the related model with the given attributes and relationship
 	* creation attributes applied, and save them to the database.
-	* 
-	* @param models 
-	* @returns 
+	*
+	* @param models
+	* @returns
 	*/
 	async saveManyQuietly(models = []) {
 		return await Promise.all(models.map(async (model) => await this.saveQuietly(model)));
@@ -4616,10 +4681,10 @@ var Relation = class {
 	}
 	/**
 	* Find the first related model by a specific key and value, or create a new instance if not found.
-	* 
-	* @param attributes 
-	* @param values 
-	* @returns 
+	*
+	* @param attributes
+	* @param values
+	* @returns
 	*/
 	async firstOrNew(attributes, values = {}) {
 		const found = await (await this.getQuery()).clone().where(attributes).first();
@@ -4630,12 +4695,12 @@ var Relation = class {
 		});
 	}
 	/**
-	* Find the first related model by a specific key and value, or create and save a new instance 
+	* Find the first related model by a specific key and value, or create and save a new instance
 	* if not found.
-	* 
-	* @param attributes 
-	* @param values 
-	* @returns 
+	*
+	* @param attributes
+	* @param values
+	* @returns
 	*/
 	async firstOrCreate(attributes, values = {}) {
 		const found = await (await this.getQuery()).clone().where(attributes).first();
@@ -4646,12 +4711,12 @@ var Relation = class {
 		});
 	}
 	/**
-	* Find the first related model by a specific key and value, update the first matching record with 
+	* Find the first related model by a specific key and value, update the first matching record with
 	* the given values, or create and save a new instance if no matching record is found.
-	* 
-	* @param attributes 
-	* @param values 
-	* @returns 
+	*
+	* @param attributes
+	* @param values
+	* @returns
 	*/
 	async updateOrCreate(attributes, values = {}) {
 		const query = await this.getQuery();
@@ -4665,35 +4730,35 @@ var Relation = class {
 		return await query.clone().where(attributes).update(values);
 	}
 	/**
-	* Find related models by specific attributes, update matching records with the given values, or 
+	* Find related models by specific attributes, update matching records with the given values, or
 	* create and save new instances if no matching records are found.
-	* 
-	* @param values 
-	* @param uniqueBy 
-	* @param update 
-	* @returns 
+	*
+	* @param values
+	* @param uniqueBy
+	* @param update
+	* @returns
 	*/
 	async upsert(values, uniqueBy, update = null) {
 		return await (await this.getQuery()).upsert(values.map((value) => this.mergeCreationAttributes(value)), uniqueBy, update);
 	}
 	/**
 	* Paginate the relationship query results.
-	* 
-	* @param perPage 
-	* @param page 
-	* @param options 
-	* @returns 
+	*
+	* @param perPage
+	* @param page
+	* @param options
+	* @returns
 	*/
 	async paginate(perPage = 15, page, options = {}) {
 		return (await this.getQuery()).paginate(perPage, page, options);
 	}
 	/**
 	* Paginate the relationship query results without total count optimization.
-	* 
-	* @param perPage 
-	* @param page 
-	* @param options 
-	* @returns 
+	*
+	* @param perPage
+	* @param page
+	* @param options
+	* @returns
 	*/
 	async simplePaginate(perPage = 15, page, options = {}) {
 		return (await this.getQuery()).simplePaginate(perPage, page, options);
@@ -4704,7 +4769,7 @@ var Relation = class {
 //#region src/relationship/BelongsToManyRelation.ts
 /**
 * Defines a many-to-many relationship.
-* 
+*
 * @author Legacy (3m1n3nc3)
 * @since 0.1.0
 */
@@ -4727,9 +4792,9 @@ var BelongsToManyRelation = class BelongsToManyRelation extends Relation {
 	}
 	/**
 	* Specifies additional pivot columns to include on the related models.
-	* 
-	* @param columns   The pivot columns to include on the related models. 
-	* @returns 
+	*
+	* @param columns   The pivot columns to include on the related models.
+	* @returns
 	*/
 	withPivot(...columns) {
 		columns.flat().forEach((column) => {
@@ -4740,9 +4805,9 @@ var BelongsToManyRelation = class BelongsToManyRelation extends Relation {
 		return this;
 	}
 	/**
-	* Specifies that the pivot table contains timestamp columns and optionally 
+	* Specifies that the pivot table contains timestamp columns and optionally
 	* allows customizing the names of those columns.
-	* 
+	*
 	* @param createdAtColumn    The name of the "created at" timestamp column.
 	* @param updatedAtColumn    The name of the "updated at" timestamp column.
 	* @returns                  The current instance of the relationship.
@@ -4753,10 +4818,10 @@ var BelongsToManyRelation = class BelongsToManyRelation extends Relation {
 		return this.withPivot(createdAtColumn, updatedAtColumn);
 	}
 	/**
-	* Specifies a custom accessor name for the pivot attributes on the related models. 
-	* By default, pivot attributes are accessible via the `pivot` property on the 
+	* Specifies a custom accessor name for the pivot attributes on the related models.
+	* By default, pivot attributes are accessible via the `pivot` property on the
 	* related models.
-	* 
+	*
 	* @param accessor    The custom accessor name for the pivot attributes.
 	* @returns           The current instance of the relationship.
 	*/
@@ -4768,10 +4833,10 @@ var BelongsToManyRelation = class BelongsToManyRelation extends Relation {
 		return this;
 	}
 	/**
-	* Specifies a custom pivot model to use for the pivot records. The pivot model can 
-	* be used to define custom behavior or methods on the pivot records, as well as to 
+	* Specifies a custom pivot model to use for the pivot records. The pivot model can
+	* be used to define custom behavior or methods on the pivot records, as well as to
 	* specify a custom hydration method for the pivot records.
-	* 
+	*
 	* @param pivotModel    The custom pivot model to use.
 	* @returns             The current instance of the relationship.
 	*/
@@ -4788,20 +4853,20 @@ var BelongsToManyRelation = class BelongsToManyRelation extends Relation {
 	}
 	/**
 	* Adds a "pivot column in" condition to the relationship query.
-	* 
-	* @param column 
-	* @param values 
-	* @returns 
+	*
+	* @param column
+	* @param values
+	* @returns
 	*/
 	wherePivotNotIn(column, values) {
 		return this.addPivotWhere(this.makePivotComparison(column, "not-in", values));
 	}
 	/**
 	* Adds a "pivot column between" condition to the relationship query.
-	* 
-	* @param column 
-	* @param range 
-	* @returns 
+	*
+	* @param column
+	* @param range
+	* @returns
 	*/
 	wherePivotBetween(column, range) {
 		return this.addPivotWhere({
@@ -4812,10 +4877,10 @@ var BelongsToManyRelation = class BelongsToManyRelation extends Relation {
 	}
 	/**
 	* Adds a "pivot column not between" condition to the relationship query.
-	* 
-	* @param column 
-	* @param range 
-	* @returns 
+	*
+	* @param column
+	* @param range
+	* @returns
 	*/
 	wherePivotNotBetween(column, range) {
 		return this.addPivotWhere({
@@ -4829,18 +4894,18 @@ var BelongsToManyRelation = class BelongsToManyRelation extends Relation {
 	}
 	/**
 	* Adds a "pivot column is null" condition to the relationship query.
-	* 
-	* @param column 
-	* @returns 
+	*
+	* @param column
+	* @returns
 	*/
 	wherePivotNull(column) {
 		return this.addPivotWhere(this.makePivotComparison(column, "is-null"));
 	}
 	/**
 	* Adds a "pivot column is not null" condition to the relationship query.
-	* 
-	* @param column 
-	* @returns 
+	*
+	* @param column
+	* @returns
 	*/
 	wherePivotNotNull(column) {
 		return this.addPivotWhere(this.makePivotComparison(column, "is-not-null"));
@@ -5040,9 +5105,9 @@ var BelongsToManyRelation = class BelongsToManyRelation extends Relation {
 		return rows.length;
 	}
 	/**
-	* Creates a new instance of the related model with the given attributes and attaches 
+	* Creates a new instance of the related model with the given attributes and attaches
 	* pivot attributes if pivot attributes should be included.
-	* 
+	*
 	* @param attributes    The attributes to initialize the related model with.
 	* @returns             A new instance of the related model.
 	*/
@@ -5050,10 +5115,10 @@ var BelongsToManyRelation = class BelongsToManyRelation extends Relation {
 		return this.related.hydrate(attributes);
 	}
 	/**
-	* Creates a new related model record with the given attributes, creates a pivot record 
-	* with the given pivot attributes, and attaches pivot attributes if pivot attributes 
+	* Creates a new related model record with the given attributes, creates a pivot record
+	* with the given pivot attributes, and attaches pivot attributes if pivot attributes
 	* should be included.
-	* 
+	*
 	* @param attributes        The attributes to initialize the related model with.
 	* @param pivotAttributes   The attributes to initialize the pivot record with.
 	* @returns                 A new instance of the related model with pivot attributes attached.
@@ -5065,10 +5130,10 @@ var BelongsToManyRelation = class BelongsToManyRelation extends Relation {
 		return this.attachPivotToSingleResult(related, pivotRow);
 	}
 	/**
-	* Saves a related model record, creates a pivot record with the given pivot attributes 
-	* if the related model was not previously persisted, and attaches pivot attributes if 
+	* Saves a related model record, creates a pivot record with the given pivot attributes
+	* if the related model was not previously persisted, and attaches pivot attributes if
 	* pivot attributes should be included.
-	* 
+	*
 	* @param related           The related model instance to save.
 	* @param pivotAttributes   The attributes to initialize the pivot record with.
 	* @returns                 A new instance of the related model with pivot attributes attached.
@@ -5088,9 +5153,9 @@ var BelongsToManyRelation = class BelongsToManyRelation extends Relation {
 		return this.attachPivotToSingleResult(persisted, pivotRow);
 	}
 	/**
-	* Attaches one or more related model records to the parent model by creating pivot 
+	* Attaches one or more related model records to the parent model by creating pivot
 	* records with the given pivot attributes if pivot attributes should be included.
-	* 
+	*
 	* @param related           The related model instance(s) to attach.
 	* @param pivotAttributes   The attributes to initialize the pivot record with.
 	* @returns                 The number of related model records attached.
@@ -5173,7 +5238,7 @@ var BelongsToManyRelation = class BelongsToManyRelation extends Relation {
 	}
 	/**
 	* Creates a pivot record from a row of data.
-	* 
+	*
 	* @param row   The row of data containing pivot attributes.
 	* @returns     The pivot record.
 	*/
@@ -5188,10 +5253,10 @@ var BelongsToManyRelation = class BelongsToManyRelation extends Relation {
 	}
 	/**
 	* Attaches pivot attributes to the related models if pivot attributes should be included.
-	* 
-	* @param results 
-	* @param pivotRows 
-	* @returns 
+	*
+	* @param results
+	* @param pivotRows
+	* @returns
 	*/
 	attachPivotToResults(results, pivotRows) {
 		if (!this.shouldAttachPivotAttributes()) return results;
@@ -5283,8 +5348,8 @@ var BelongsToManyRelation = class BelongsToManyRelation extends Relation {
 	}
 	/**
 	* Fetches the related models for this relationship.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	async getResults() {
 		return (await this.getQuery()).get();
@@ -5295,7 +5360,7 @@ var BelongsToManyRelation = class BelongsToManyRelation extends Relation {
 //#region src/relationship/SingleResultRelation.ts
 /**
 * Base class for relationships that resolve to a single related model.
-* 
+*
 * @author Legacy (3m1n3nc3)
 * @since 1.3.0
 */
@@ -5307,7 +5372,7 @@ var SingleResultRelation = class extends Relation {
 	}
 	/**
 	* Defines a default value to return when the relationship does not find a related model.
-	* 
+	*
 	* @param value     The default value or a callback that returns the default value.
 	* @returns         The current instance for method chaining.
 	*/
@@ -5327,7 +5392,7 @@ var SingleResultRelation = class extends Relation {
 //#region src/relationship/BelongsToRelation.ts
 /**
 * Defines an inverse one-to-one or many relationship.
-* 
+*
 * @author Legacy (3m1n3nc3)
 * @since 0.1.0
 */
@@ -5356,8 +5421,8 @@ var BelongsToRelation = class extends SingleResultRelation {
 	}
 	/**
 	* Fetches the related models for this relationship.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	async getResults() {
 		return await (await this.getQuery()).first() ?? this.resolveDefaultResult();
@@ -5368,7 +5433,7 @@ var BelongsToRelation = class extends SingleResultRelation {
 //#region src/relationship/HasManyRelation.ts
 /**
 * Defines a one-to-many relationship.
-* 
+*
 * @author Legacy (3m1n3nc3)
 * @since 0.1.0
 */
@@ -5402,8 +5467,8 @@ var HasManyRelation = class extends Relation {
 	}
 	/**
 	* Fetches the related models for this relationship.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	async getResults() {
 		return (await this.getQuery()).get();
@@ -5413,9 +5478,9 @@ var HasManyRelation = class extends Relation {
 //#endregion
 //#region src/relationship/HasManyThroughRelation.ts
 /**
-* Defines a has-many-through relationship, which provides a convenient way to access 
-* distant relations via an intermediate relation. 
-* 
+* Defines a has-many-through relationship, which provides a convenient way to access
+* distant relations via an intermediate relation.
+*
 * @author Legacy (3m1n3nc3)
 * @since 0.1.0
 */
@@ -5464,8 +5529,8 @@ var HasManyThroughRelation = class extends Relation {
 	}
 	/**
 	* Fetches the related models for this relationship.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	async getResults() {
 		return (await this.getQuery()).get();
@@ -5476,7 +5541,7 @@ var HasManyThroughRelation = class extends Relation {
 //#region src/relationship/HasOneRelation.ts
 /**
 * Represents a "has one" relationship between two models.
-* 
+*
 * @author Legacy (3m1n3nc3)
 * @since 0.1.0
 */
@@ -5508,8 +5573,8 @@ var HasOneRelation = class extends SingleResultRelation {
 	}
 	/**
 	* Fetches the related models for this relationship.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	async getResults() {
 		return await (await this.getQuery()).first() ?? this.resolveDefaultResult();
@@ -5519,9 +5584,9 @@ var HasOneRelation = class extends SingleResultRelation {
 //#endregion
 //#region src/relationship/HasOneThroughRelation.ts
 /**
-* Represents a "has one through" relationship, where the parent model is related 
+* Represents a "has one through" relationship, where the parent model is related
 * to exactly one instance of the related model through an intermediate model.
-* 
+*
 * @author Legacy (3m1n3nc3)
 * @since 0.1.0
 */
@@ -5569,8 +5634,8 @@ var HasOneThroughRelation = class extends SingleResultRelation {
 	}
 	/**
 	* Fetches the related models for this relationship.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	async getResults() {
 		return await (await this.getQuery()).first() ?? this.resolveDefaultResult();
@@ -5580,8 +5645,8 @@ var HasOneThroughRelation = class extends SingleResultRelation {
 //#endregion
 //#region src/relationship/MorphManyRelation.ts
 /**
-* Defines a polymorphic one-to-many relationship. 
-* 
+* Defines a polymorphic one-to-many relationship.
+*
 * @author Legacy (3m1n3nc3)
 * @since 0.1.0
 */
@@ -5626,8 +5691,8 @@ var MorphManyRelation = class extends Relation {
 	}
 	/**
 	* Fetches the related models for this relationship.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	async getResults() {
 		return (await this.getQuery()).get();
@@ -5638,7 +5703,7 @@ var MorphManyRelation = class extends Relation {
 //#region src/relationship/MorphOneRelation.ts
 /**
 * Defines a polymorphic one-to-one relationship.
-* 
+*
 * @author Legacy (3m1n3nc3)
 * @since 0.1.0
 */
@@ -5681,8 +5746,8 @@ var MorphOneRelation = class extends SingleResultRelation {
 	}
 	/**
 	* Fetches the related models for this relationship.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	async getResults() {
 		return await (await this.getQuery()).first() ?? this.resolveDefaultResult();
@@ -5692,8 +5757,8 @@ var MorphOneRelation = class extends SingleResultRelation {
 //#endregion
 //#region src/relationship/MorphToManyRelation.ts
 /**
-* Defines a polymorphic many-to-many relationship.  
-* 
+* Defines a polymorphic many-to-many relationship.
+*
 * @author Legacy (3m1n3nc3)
 * @since 0.1.0
 */
@@ -5756,8 +5821,8 @@ var MorphToManyRelation = class extends Relation {
 	}
 	/**
 	* Fetches the related models for this relationship.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	async getResults() {
 		return (await this.getQuery()).get();