arkormx 2.9.2 → 2.9.4

package/dist/cli.mjs

@@ -117,10 +117,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}/`, {
@@ -277,9 +277,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)
@@ -291,10 +291,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;
@@ -302,22 +302,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;
@@ -325,20 +325,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;
@@ -457,7 +457,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)
@@ -494,7 +494,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.
@@ -504,7 +504,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.
@@ -535,7 +535,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.
@@ -545,7 +545,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.
@@ -555,7 +555,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.
@@ -565,7 +565,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.
@@ -575,7 +575,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.
@@ -583,6 +583,22 @@ var TableBuilder = class {
 	float(name, options = {}) {
 		return this.column(name, "float", options);
 	}
+	/**
+	* Defines a fixed-precision decimal column in the table.
+	*
+	* @param name      The name of the decimal column.
+	* @param precision The total number of digits. Defaults to 8.
+	* @param scale     The number of digits to the right of the point. Defaults to 2.
+	* @param options   Additional options for the decimal column.
+	* @returns         The current TableBuilder instance for chaining.
+	*/
+	decimal(name, precision = 8, scale = 2, options = {}) {
+		return this.column(name, "decimal", {
+			precision,
+			scale,
+			...options
+		});
+	}
 	unique(columnsOrName, name) {
 		if (Array.isArray(columnsOrName)) {
 			const columns = this.normalizeCompositeColumns(columnsOrName, "unique constraint");
@@ -601,8 +617,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.
 	*/
@@ -611,29 +627,39 @@ 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 a date-time column in the table (timestamp without time zone).
+	*
+	* @param name      The name of the date-time column.
+	* @param options   Additional options for the date-time column.
+	* @returns         The current TableBuilder instance for chaining.
+	*/
+	dateTime(name, options = {}) {
+		return this.column(name, "dateTime", 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 });
@@ -642,9 +668,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 });
@@ -653,28 +679,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);
@@ -735,9 +761,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 });
@@ -745,9 +771,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);
@@ -755,7 +781,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.
 	*/
@@ -793,7 +819,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.
@@ -805,7 +831,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.
@@ -817,7 +843,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.
@@ -846,11 +872,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;
@@ -858,8 +884,8 @@ var TableBuilder = class {
 	}
 	/**
 	* Returns a deep copy of the defined columns for the table.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	getColumns() {
 		return this.columns.map((column) => ({
@@ -869,15 +895,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() {
@@ -914,11 +940,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({
@@ -934,6 +960,8 @@ var TableBuilder = class {
 			after: options.after,
 			default: options.default,
 			updatedAt: options.updatedAt,
+			precision: options.precision,
+			scale: options.scale,
 			primaryKeyGeneration: options.primaryKeyGeneration
 		});
 		const column = this.columns[this.columns.length - 1];
@@ -943,9 +971,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;
@@ -966,19 +994,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.
@@ -1002,7 +1095,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.
@@ -1027,7 +1120,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.
 	*/
@@ -1040,7 +1133,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() {
@@ -1116,7 +1209,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.
 */
@@ -1128,16 +1221,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";
@@ -1147,6 +1240,7 @@ const resolvePrismaType = (column) => {
 	if (column.type === "integer") return "Int";
 	if (column.type === "bigInteger") return "BigInt";
 	if (column.type === "float") return "Float";
+	if (column.type === "decimal") return "Decimal";
 	if (column.type === "boolean") return "Boolean";
 	if (column.type === "json") return "Json";
 	return "DateTime";
@@ -1156,11 +1250,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;
@@ -1171,9 +1265,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;
@@ -1182,9 +1276,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.");
@@ -1194,9 +1288,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);
@@ -1212,11 +1306,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;
@@ -1226,9 +1320,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") {
@@ -1245,14 +1339,15 @@ const buildFieldLine = (column) => {
 	const primary = column.primary ? " @id" : "";
 	const mapped = typeof column.map === "string" && column.map.trim().length > 0 ? ` @map("${column.map.replace(/"/g, "\\\"")}")` : "";
 	const updatedAt = column.updatedAt ? " @updatedAt" : "";
+	const nativeType = column.type === "decimal" ? ` @db.Decimal(${column.precision ?? 8}, ${column.scale ?? 2})` : "";
 	const defaultValue = column.type === "enum" ? formatEnumDefaultValue(column.default) : column.primaryKeyGeneration?.prismaDefault ?? formatDefaultValue(column.default);
 	const defaultSuffix = defaultValue ? ` ${defaultValue}` : "";
-	return `  ${column.name} ${scalar}${nullable}${primary}${unique}${defaultSuffix}${updatedAt}${mapped}`;
+	return `  ${column.name} ${scalar}${nullable}${primary}${unique}${defaultSuffix}${updatedAt}${mapped}${nativeType}`;
 };
 /**
-* 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.
@@ -1262,12 +1357,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)];
@@ -1286,13 +1381,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;
@@ -1322,9 +1417,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, "\\\"")}"` : ""})`;
@@ -1348,9 +1443,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.
 */
@@ -1365,10 +1460,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.
@@ -1394,9 +1489,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.
 */
@@ -1408,9 +1503,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.
 */
@@ -1426,10 +1521,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.
@@ -1442,14 +1537,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;
@@ -1458,10 +1553,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.
@@ -1484,9 +1579,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.
 */
@@ -1511,12 +1606,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)];
@@ -1548,9 +1643,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.
@@ -1562,9 +1657,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.
@@ -1631,10 +1726,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.
@@ -1648,7 +1743,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
@@ -1663,11 +1758,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();
@@ -1675,39 +1770,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 [
@@ -1744,12 +1839,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());
@@ -1774,10 +1869,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;
@@ -1812,10 +1907,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.
@@ -2192,17 +2287,17 @@ const pushUnique = (items, values) => {
 const normalizeConstructors = (items) => items.flatMap((item) => Array.isArray(item) ? item : [item]).filter(Boolean);
 /**
 * Register model constructors directly without relying on runtime discovery.
-* 
-* @param models 
+*
+* @param models
 */
 const registerModels = (...models) => {
 	pushUnique(registry.models, normalizeConstructors(models));
 };
 /**
 * 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]];
@@ -2215,14 +2310,14 @@ 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];
 
@@ -2318,9 +2413,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 ?? {};
@@ -2376,10 +2471,10 @@ const awaitConfiguredModelsRegistration = async () => {
 };
 /**
 * 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) => {
@@ -2388,10 +2483,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];
@@ -2400,8 +2495,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 = {}) => {
@@ -2436,9 +2531,9 @@ const configureArkormRuntime = (client, options = {}) => {
 /**
 * 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;
@@ -2447,12 +2542,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;
@@ -2472,11 +2567,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);
@@ -2496,9 +2591,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) {
@@ -2531,6 +2626,65 @@ const loadArkormConfig = async () => {
 const getDefaultStubsPath = () => {
 	return resolveDefaultStubsPath();
 };
+/**
+* Get the runtime compatibility client.
+* This function will trigger the loading of the ArkORM configuration if
+* it hasn't already been loaded.
+*
+* @returns
+*/
+const getRuntimeClient = () => {
+	const activeTransactionClient = transactionClientStorage.getStore();
+	if (activeTransactionClient) return activeTransactionClient;
+	if (!runtimeConfigLoaded) loadRuntimeConfigSync();
+	return resolveClient(runtimeClientResolver);
+};
+/**
+* Get the currently configured runtime adapter, if any.
+*
+* @returns
+*/
+const getRuntimeAdapter = () => {
+	const activeTransactionAdapter = transactionAdapterStorage.getStore();
+	if (activeTransactionAdapter) return activeTransactionAdapter;
+	if (!runtimeConfigLoaded) loadRuntimeConfigSync();
+	return runtimeAdapter;
+};
+const isTransactionCapableClient = (value) => {
+	if (!value || typeof value !== "object") return false;
+	return typeof value.$transaction === "function";
+};
+const runArkormTransaction = async (callback, options = {}, preferredAdapter) => {
+	const activeTransactionAdapter = transactionAdapterStorage.getStore();
+	const activeTransactionClient = transactionClientStorage.getStore();
+	if (activeTransactionAdapter || activeTransactionClient) return await callback({
+		adapter: activeTransactionAdapter,
+		client: activeTransactionClient
+	});
+	const adapter = preferredAdapter ?? getRuntimeAdapter();
+	if (adapter) return await adapter.transaction(async (transactionAdapter) => {
+		return await transactionAdapterStorage.run(transactionAdapter, async () => {
+			return await callback({
+				adapter: transactionAdapter,
+				client: transactionClientStorage.getStore()
+			});
+		});
+	}, options);
+	const client = getRuntimeClient();
+	if (!client) throw new ArkormException("Cannot start a transaction without a configured runtime client or adapter.", {
+		code: "CLIENT_NOT_CONFIGURED",
+		operation: "transaction"
+	});
+	if (!isTransactionCapableClient(client)) throw new UnsupportedAdapterFeatureException("Transactions are not supported by the current adapter.", {
+		code: "TRANSACTION_NOT_SUPPORTED",
+		operation: "transaction"
+	});
+	return await client.$transaction(async (transactionClient) => {
+		return await transactionClientStorage.run(transactionClient, async () => {
+			return await callback({ client: transactionClient });
+		});
+	}, options);
+};
 const getRuntimeDebugHandler = () => {
 	if (!runtimeConfigLoaded) loadRuntimeConfigSync();
 	return runtimeDebugHandler;
@@ -2541,7 +2695,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.
 */
@@ -2567,7 +2721,7 @@ loadArkormConfig();
 //#region src/helpers/prisma.ts
 /**
 * 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.
 */
@@ -2578,9 +2732,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
 */
@@ -2849,9 +3003,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);
@@ -2861,10 +3015,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);
@@ -2875,9 +3029,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);
@@ -2886,10 +3040,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);
@@ -2918,9 +3072,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);
@@ -2937,10 +3091,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);
@@ -2970,9 +3124,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);
@@ -2983,10 +3137,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);
@@ -3001,9 +3155,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);
@@ -3014,9 +3168,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({
@@ -3026,8 +3180,8 @@ var PrismaDatabaseAdapter = class PrismaDatabaseAdapter {
 	}
 	/**
 	* Loads related models for a batch of parent records based on the specified relation load plans.
-	* 
-	* @param _spec 
+	*
+	* @param _spec
 	*/
 	async loadRelations(_spec) {
 		throw new UnsupportedAdapterFeatureException("Adapter-owned relation batch loading is intentionally unavailable on the Prisma compatibility adapter; eager loading stays on Arkorm's generic loader for this path.", {
@@ -3036,12 +3190,12 @@ var PrismaDatabaseAdapter = class PrismaDatabaseAdapter {
 		});
 	}
 	/**
-	* Executes a series of database operations within a transaction. 
+	* Executes a series of database operations within a transaction.
 	* If the underlying Prisma client does not support transactions, an exception is thrown.
-	* 
-	* @param callback 
-	* @param context 
-	* @returns 
+	*
+	* @param callback
+	* @param context
+	* @returns
 	*/
 	async transaction(callback, context = {}) {
 		if (!this.hasTransactionSupport(this.prisma)) throw new UnsupportedAdapterFeatureException("Transactions are not supported by the Prisma compatibility adapter.", {
@@ -3097,12 +3251,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;
@@ -3191,7 +3345,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
@@ -3203,19 +3357,19 @@ var CliApp = class {
 	}
 	/**
 	* Resolve the path to a stub file based on configuration
-	* 
-	* @param stubName 
-	* @returns 
+	*
+	* @param stubName
+	* @returns
 	*/
 	resolveStubPath(stubName) {
 		return join$1(this.resolveConfigPath("stubs", getDefaultStubsPath()), stubName);
 	}
 	/**
 	* Generate a factory file for a given model name.
-	* 
-	* @param name 
-	* @param options 
-	* @returns 
+	*
+	* @param name
+	* @param options
+	* @returns
 	*/
 	makeFactory(name, options = {}) {
 		const baseName = str(name.replace(/Factory$/, "")).pascal();
@@ -3237,10 +3391,10 @@ var CliApp = class {
 	}
 	/**
 	* Generate a seeder file for a given name.
-	* 
-	* @param name 
-	* @param options 
-	* @returns 
+	*
+	* @param name
+	* @param options
+	* @returns
 	*/
 	makeSeeder(name, options = {}) {
 		const seederName = `${str(name.replace(/Seeder$/, "")).pascal()}Seeder`;
@@ -3254,7 +3408,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.
 	*/
@@ -3270,10 +3424,10 @@ var CliApp = class {
 	}
 	/**
 	* Generate a model file along with optional factory, seeder, and migration files.
-	* 
-	* @param name 
-	* @param options 
-	* @returns 
+	*
+	* @param name
+	* @param options
+	* @returns
 	*/
 	makeModel(name, options = {}) {
 		const baseName = str(name.replace(/Model$/, "")).pascal().toString();
@@ -3317,10 +3471,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.
 	*/
@@ -3352,7 +3506,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.
 	*/
@@ -3645,9 +3799,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.
 	*/
@@ -3695,11 +3849,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.
@@ -3795,12 +3949,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.
 	*/
@@ -3831,7 +3985,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)
@@ -3890,8 +4044,8 @@ var MakeFactoryCommand = class extends Command {
 	}
 	/**
 	* Command handler for the make:factory command.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	async handle() {
 		this.app.command = this;
@@ -3920,8 +4074,8 @@ var MakeMigrationCommand = class extends Command {
 	}
 	/**
 	* Command handler for the make:migration command.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	async handle() {
 		this.app.command = this;
@@ -3935,7 +4089,7 @@ var MakeMigrationCommand = class extends Command {
 //#endregion
 //#region src/cli/commands/MakeModelCommand.ts
 /**
-* The MakeModelCommand class implements the CLI command for creating new model 
+* The MakeModelCommand class implements the CLI command for creating new model
 * classes along with optional linked resources such as factories, seeders, and migrations.
 *
 * @author Legacy (3m1n3nc3)
@@ -3957,8 +4111,8 @@ var MakeModelCommand = class extends Command {
 	}
 	/**
 	* Command handler for the make:model command.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	async handle() {
 		this.app.command = this;
@@ -4008,8 +4162,8 @@ var MakeSeederCommand = class extends Command {
 //#region src/database/Migration.ts
 const MIGRATION_BRAND = Symbol.for("arkormx.migration");
 /**
-* The Migration class serves as a base for defining database migrations, requiring 
-* the implementation of `up` and `down` methods to specify the changes to be 
+* The Migration class serves as a base for defining database migrations, requiring
+* the implementation of `up` and `down` methods to specify the changes to be
 * applied or reverted in the database schema.
 *
 * @author Legacy (3m1n3nc3)
@@ -4024,7 +4178,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)
@@ -4048,12 +4202,12 @@ var MigrateCommand = class extends Command {
 	}
 	/**
 	* Command handler for the migrate command.
-	* This method is responsible for orchestrating the migration 
-	* process, including loading migration classes, applying them to 
-	* the Prisma schema, and running the appropriate Prisma commands 
+	* This method is responsible for orchestrating the migration
+	* process, including loading migration classes, applying them to
+	* the Prisma schema, and running the appropriate Prisma commands
 	* based on the provided options.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	async handle() {
 		this.app.command = this;
@@ -4168,10 +4322,10 @@ var MigrateCommand = class extends Command {
 	}
 	/**
 	* Load migration classes from a specific file or by class name.
-	* 
-	* @param migrationsDir 
-	* @param name 
-	* @returns 
+	*
+	* @param migrationsDir
+	* @param name
+	* @returns
 	*/
 	async loadNamedMigration(migrationsDirs, name) {
 		if (!name) return [[void 0, ""]];
@@ -4194,9 +4348,9 @@ var MigrateCommand = class extends Command {
 	}
 	/**
 	* Load migration classes from a given file path.
-	* 
-	* @param filePath 
-	* @returns 
+	*
+	* @param filePath
+	* @returns
 	*/
 	async loadMigrationClassesFromFile(filePath) {
 		const imported = await RuntimeModuleLoader.load(filePath);
@@ -4615,7 +4769,7 @@ var ModelsSyncCommand = class extends Command {
 //#region src/database/Seeder.ts
 const SEEDER_BRAND = Symbol.for("arkormx.seeder");
 /**
-* The Seeder class serves as a base for defining database seeders, which are 
+* The Seeder class serves as a base for defining database seeders, which are
 * used to populate the database with initial or test data.
 *
 * @author Legacy (3m1n3nc3)
@@ -4630,7 +4784,7 @@ var Seeder = class Seeder {
 	}
 	/**
 	* Runs one or more seeders.
-	* 
+	*
 	* @param seeders   The seeders to be run.
 	*/
 	async call(...seeders) {
@@ -4638,9 +4792,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 = [];
@@ -4650,8 +4804,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.
 	*/
@@ -4664,7 +4818,7 @@ var Seeder = class Seeder {
 	}
 	/**
 	* Runs the given seeders in sequence.
-	* 
+	*
 	* @param seeders   The seeders to be run.
 	*/
 	static async runSeeders(...seeders) {
@@ -4684,7 +4838,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
@@ -4700,8 +4854,8 @@ var SeedCommand = class extends Command {
 	}
 	/**
 	* Command handler for the seed command.
-	* 
-	* @returns 
+	*
+	* @returns
 	*/
 	async handle() {
 		this.app.command = this;
@@ -4717,9 +4871,9 @@ var SeedCommand = class extends Command {
 	}
 	/**
 	* Load all seeder classes from the specified directory.
-	* 
-	* @param seedersDir 
-	* @returns 
+	*
+	* @param seedersDir
+	* @returns
 	*/
 	resolveSeederDirectories(configuredSeedersDir) {
 		return [this.app.resolveRuntimeDirectoryPath(configuredSeedersDir), ...getRegisteredPaths("seeders").map((directory) => this.app.resolveRuntimeDirectoryPath(directory))].filter((directory, index, all) => existsSync$1(directory) && all.indexOf(directory) === index);
@@ -4730,10 +4884,10 @@ var SeedCommand = class extends Command {
 	}
 	/**
 	* Load seeder classes from a specific file or by class name.
-	* 
-	* @param seedersDir 
-	* @param name 
-	* @returns 
+	*
+	* @param seedersDir
+	* @param name
+	* @returns
 	*/
 	async loadNamedSeeder(seedersDirs, name) {
 		const base = name.replace(/Seeder$/, "");
@@ -4755,7 +4909,7 @@ var SeedCommand = class extends Command {
 	}
 	/**
 	* Load seeder classes from a given file path.
-	* 
+	*
 	* @param filePath The path to the file containing seeder classes.
 	* @returns An array of seeder classes.
 	*/