arkormx 2.4.5 → 2.4.7

package/dist/relationship/index.cjs

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

package/dist/relationship/index.d.cts

@@ -1,2 +1,2 @@
-import { $a as SetBasedEagerLoader, ao as HasManyThroughRelation, co as SingleResultRelation, do as RelationTableLoader, eo as MorphToManyRelation, io as HasOneRelation, lo as BelongsToManyRelation, no as MorphManyRelation, oo as HasManyRelation, ro as HasOneThroughRelation, so as BelongsToRelation, to as MorphOneRelation, uo as Relation } from "../index-A71-nct_.cjs";
+import { ao as HasOneThroughRelation, co as HasManyRelation, do as BelongsToManyRelation, fo as Relation, io as MorphManyRelation, lo as BelongsToRelation, no as MorphToManyRelation, oo as HasOneRelation, po as RelationTableLoader, ro as MorphOneRelation, so as HasManyThroughRelation, to as SetBasedEagerLoader, uo as SingleResultRelation } from "../index-DKqMpR3p.cjs";
 export { BelongsToManyRelation, BelongsToRelation, HasManyRelation, HasManyThroughRelation, HasOneRelation, HasOneThroughRelation, MorphManyRelation, MorphOneRelation, MorphToManyRelation, Relation, RelationTableLoader, SetBasedEagerLoader, SingleResultRelation };

package/dist/relationship/index.d.mts

@@ -1,2 +1,2 @@
-import { $a as SetBasedEagerLoader, ao as HasManyThroughRelation, co as SingleResultRelation, do as RelationTableLoader, eo as MorphToManyRelation, io as HasOneRelation, lo as BelongsToManyRelation, no as MorphManyRelation, oo as HasManyRelation, ro as HasOneThroughRelation, so as BelongsToRelation, to as MorphOneRelation, uo as Relation } from "../index-ngpa9-9f.mjs";
+import { ao as HasOneThroughRelation, co as HasManyRelation, do as BelongsToManyRelation, fo as Relation, io as MorphManyRelation, lo as BelongsToRelation, no as MorphToManyRelation, oo as HasOneRelation, po as RelationTableLoader, ro as MorphOneRelation, so as HasManyThroughRelation, to as SetBasedEagerLoader, uo as SingleResultRelation } from "../index-Bn-2R_ax.mjs";
 export { BelongsToManyRelation, BelongsToRelation, HasManyRelation, HasManyThroughRelation, HasOneRelation, HasOneThroughRelation, MorphManyRelation, MorphOneRelation, MorphToManyRelation, Relation, RelationTableLoader, SetBasedEagerLoader, SingleResultRelation };

package/dist/relationship/index.mjs

@@ -1,3 +1,3 @@
-import { An as RelationTableLoader, a as HasOneRelation, c as BelongsToRelation, d as Relation, i as HasOneThroughRelation, kn as SetBasedEagerLoader, l as SingleResultRelation, n as MorphOneRelation, o as HasManyThroughRelation, r as MorphManyRelation, s as HasManyRelation, t as MorphToManyRelation, u as BelongsToManyRelation } from "../relationship-DcvK5Xn-.mjs";
+import { Mn as RelationTableLoader, a as HasOneRelation, c as BelongsToRelation, d as Relation, i as HasOneThroughRelation, jn as SetBasedEagerLoader, l as SingleResultRelation, n as MorphOneRelation, o as HasManyThroughRelation, r as MorphManyRelation, s as HasManyRelation, t as MorphToManyRelation, u as BelongsToManyRelation } from "../relationship-BkNxySap.mjs";
 
 export { BelongsToManyRelation, BelongsToRelation, HasManyRelation, HasManyThroughRelation, HasOneRelation, HasOneThroughRelation, MorphManyRelation, MorphOneRelation, MorphToManyRelation, Relation, RelationTableLoader, SetBasedEagerLoader, SingleResultRelation };

package/dist/{relationship-DcvK5Xn-.mjs → relationship-BkNxySap.mjs}

@@ -1018,18 +1018,21 @@ var TableBuilder = class {
 		this.dropColumnNames = [];
 		this.indexes = [];
 		this.foreignKeys = [];
+		this.compositeUniqueConstraints = [];
 	}
-	/**
-	* Defines a primary key column in the table.
-	* 
-	* @param columnNameOrOptions 
-	* @param options 
-	* @returns 
-	*/
 	primary(columnNameOrOptions, options) {
+		if (Array.isArray(columnNameOrOptions)) {
+			const columns = this.normalizeCompositeColumns(columnNameOrOptions, "primary key");
+			if (this.compositePrimaryKey) throw new Error("A composite primary key has already been defined for this table.");
+			this.compositePrimaryKey = {
+				columns,
+				...typeof options === "string" && options.trim() ? { name: options.trim() } : {}
+			};
+			return this;
+		}
 		const config = typeof columnNameOrOptions === "string" ? {
 			columnName: columnNameOrOptions,
-			...options ?? {}
+			...typeof options === "object" ? options : {}
 		} : columnNameOrOptions ?? {};
 		const column = this.resolveColumn(config.columnName);
 		column.primary = true;
@@ -1129,15 +1132,19 @@ var TableBuilder = class {
 	float(name, options = {}) {
 		return this.column(name, "float", options);
 	}
-	/**
-	* Marks a column as unique in the table.
-	* 
-	* @param name Optional explicit column name. 
-	* When omitted, applies to the latest defined column.
-	* @returns The current TableBuilder instance for chaining.
-	*/
-	unique(name) {
-		const column = this.resolveColumn(name);
+	unique(columnsOrName, name) {
+		if (Array.isArray(columnsOrName)) {
+			const columns = this.normalizeCompositeColumns(columnsOrName, "unique constraint");
+			const normalizedName = name?.trim();
+			if (this.compositeUniqueConstraints.find((constraint) => constraint.columns.length === columns.length && constraint.columns.every((column, index) => column === columns[index]))) throw new Error(`A unique constraint for columns [${columns.join(", ")}] has already been defined for this table.`);
+			if (normalizedName && this.compositeUniqueConstraints.some((constraint) => constraint.name === normalizedName)) throw new Error(`A unique constraint named [${normalizedName}] has already been defined for this table.`);
+			this.compositeUniqueConstraints.push({
+				columns,
+				...normalizedName ? { name: normalizedName } : {}
+			});
+			return this;
+		}
+		const column = this.resolveColumn(columnsOrName);
 		column.unique = true;
 		return this;
 	}
@@ -1379,6 +1386,24 @@ var TableBuilder = class {
 		return this.foreignKeys.map((foreignKey) => ({ ...foreignKey }));
 	}
 	/**
+	* Returns a copy of the table-level composite primary key.
+	*/
+	getPrimaryKey() {
+		return this.compositePrimaryKey ? {
+			...this.compositePrimaryKey,
+			columns: [...this.compositePrimaryKey.columns]
+		} : void 0;
+	}
+	/**
+	* Returns copies of table-level composite unique constraints.
+	*/
+	getUniqueConstraints() {
+		return this.compositeUniqueConstraints.map((constraint) => ({
+			...constraint,
+			columns: [...constraint.columns]
+		}));
+	}
+	/**
 	* Defines a column in the table with the given name.
 	* 
 	* @param name      The name of the column.
@@ -1420,6 +1445,13 @@ var TableBuilder = class {
 		if (!column) throw new Error(`Column [${targetName}] was not found in the table definition.`);
 		return column;
 	}
+	normalizeCompositeColumns(columns, label) {
+		const normalized = columns.map((column) => column.trim());
+		if (normalized.length < 2) throw new Error(`A composite ${label} must contain at least two columns.`);
+		if (normalized.some((column) => !column)) throw new Error(`Composite ${label} columns must be non-empty strings.`);
+		if (new Set(normalized).size !== normalized.length) throw new Error(`Composite ${label} columns must be unique.`);
+		return normalized;
+	}
 };
 
 //#endregion
@@ -1445,12 +1477,17 @@ var SchemaBuilder = class {
 	createTable(table, callback) {
 		const builder = new TableBuilder();
 		callback(builder);
+		const primaryKey = builder.getPrimaryKey();
+		this.validateCompositePrimaryKey(table, primaryKey, builder.getColumns(), true);
+		this.validateCompositeUniqueConstraints(table, builder.getUniqueConstraints(), builder.getColumns(), true);
 		this.operations.push({
 			type: "createTable",
 			table,
 			columns: builder.getColumns(),
 			indexes: builder.getIndexes(),
-			foreignKeys: builder.getForeignKeys()
+			foreignKeys: builder.getForeignKeys(),
+			primaryKey,
+			uniqueConstraints: builder.getUniqueConstraints()
 		});
 		return this;
 	}
@@ -1464,13 +1501,18 @@ var SchemaBuilder = class {
 	alterTable(table, callback) {
 		const builder = new TableBuilder();
 		callback(builder);
+		const primaryKey = builder.getPrimaryKey();
+		this.validateCompositePrimaryKey(table, primaryKey, builder.getColumns(), false);
+		this.validateCompositeUniqueConstraints(table, builder.getUniqueConstraints(), builder.getColumns(), false);
 		this.operations.push({
 			type: "alterTable",
 			table,
 			addColumns: builder.getColumns(),
 			dropColumns: builder.getDropColumns(),
 			addIndexes: builder.getIndexes(),
-			addForeignKeys: builder.getForeignKeys()
+			addForeignKeys: builder.getForeignKeys(),
+			addPrimaryKey: primaryKey,
+			addUniqueConstraints: builder.getUniqueConstraints()
 		});
 		return this;
 	}
@@ -1504,7 +1546,15 @@ var SchemaBuilder = class {
 					...index,
 					columns: [...index.columns]
 				})),
-				foreignKeys: operation.foreignKeys.map((foreignKey) => ({ ...foreignKey }))
+				foreignKeys: operation.foreignKeys.map((foreignKey) => ({ ...foreignKey })),
+				primaryKey: operation.primaryKey ? {
+					...operation.primaryKey,
+					columns: [...operation.primaryKey.columns]
+				} : void 0,
+				uniqueConstraints: operation.uniqueConstraints?.map((constraint) => ({
+					...constraint,
+					columns: [...constraint.columns]
+				}))
 			};
 			if (operation.type === "alterTable") return {
 				...operation,
@@ -1517,11 +1567,37 @@ var SchemaBuilder = class {
 					...index,
 					columns: [...index.columns]
 				})),
-				addForeignKeys: operation.addForeignKeys.map((foreignKey) => ({ ...foreignKey }))
+				addForeignKeys: operation.addForeignKeys.map((foreignKey) => ({ ...foreignKey })),
+				addPrimaryKey: operation.addPrimaryKey ? {
+					...operation.addPrimaryKey,
+					columns: [...operation.addPrimaryKey.columns]
+				} : void 0,
+				addUniqueConstraints: operation.addUniqueConstraints?.map((constraint) => ({
+					...constraint,
+					columns: [...constraint.columns]
+				}))
 			};
 			return { ...operation };
 		});
 	}
+	validateCompositePrimaryKey(table, primaryKey, columns, requireColumns) {
+		if (!primaryKey) return;
+		if (columns.some((column) => column.primary)) throw new Error(`Table [${table}] cannot combine column primary keys with a composite primary key.`);
+		if (!requireColumns) return;
+		primaryKey.columns.forEach((columnName) => {
+			const column = columns.find((candidate) => candidate.name === columnName);
+			if (!column) throw new Error(`Composite primary key column [${columnName}] was not found on table [${table}].`);
+			if (column.nullable) throw new Error(`Composite primary key column [${columnName}] on table [${table}] cannot be nullable.`);
+		});
+	}
+	validateCompositeUniqueConstraints(table, constraints, columns, requireColumns) {
+		if (!requireColumns) return;
+		constraints.forEach((constraint) => {
+			constraint.columns.forEach((columnName) => {
+				if (!columns.some((column) => column.name === columnName)) throw new Error(`Composite unique constraint column [${columnName}] was not found on table [${table}].`);
+			});
+		});
+	}
 };
 
 //#endregion
@@ -1745,6 +1821,24 @@ const buildIndexLine = (index) => {
 	return `  @@index([${index.columns.join(", ")}]${typeof index.name === "string" && index.name.trim().length > 0 ? `, name: "${index.name.replace(/"/g, "\\\"")}"` : ""})`;
 };
 /**
+* Build a Prisma model-level composite primary key definition.
+*
+* @param primaryKey
+* @returns
+*/
+const buildPrimaryKeyLine = (primaryKey) => {
+	return `  @@id([${primaryKey.columns.join(", ")}]${typeof primaryKey.name === "string" && primaryKey.name.trim().length > 0 ? `, name: "${primaryKey.name.replace(/"/g, "\\\"")}"` : ""})`;
+};
+/**
+* Build a Prisma model-level composite unique constraint definition.
+*
+* @param constraint
+* @returns
+*/
+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 
 * common conventions, such as removing "Id" suffixes and converting to camelCase.
 * 
@@ -1893,7 +1987,14 @@ const buildModelBlock = (operation) => {
 	const mapped = operation.table !== modelName.toLowerCase();
 	const fields = operation.columns.map(buildFieldLine);
 	const relations = (operation.foreignKeys ?? []).map((foreignKey) => buildRelationLine(modelName, foreignKey, operation.columns));
-	const metadata = [...(operation.indexes ?? []).map(buildIndexLine), ...mapped ? [`  @@map("${str(operation.table).snake()}")`] : []];
+	const indexes = (operation.indexes ?? []).map(buildIndexLine);
+	const uniqueConstraints = (operation.uniqueConstraints ?? []).map(buildUniqueConstraintLine);
+	const metadata = [
+		...operation.primaryKey ? [buildPrimaryKeyLine(operation.primaryKey)] : [],
+		...uniqueConstraints,
+		...indexes,
+		...mapped ? [`  @@map("${str(operation.table).snake()}")`] : []
+	];
 	return `model ${modelName} {\n${(metadata.length > 0 ? [
 		...fields,
 		...relations,
@@ -1990,6 +2091,18 @@ const applyAlterTableOperation = (schema, operation) => {
 		const insertIndex = Math.max(1, bodyLines.length - 1);
 		bodyLines.splice(insertIndex, 0, indexLine);
 	});
+	if (operation.addPrimaryKey) {
+		const primaryKeyLine = buildPrimaryKeyLine(operation.addPrimaryKey);
+		if (bodyLines.some((line) => line.includes(" @id") || line.trim().startsWith("@@id("))) throw new ArkormException(`Prisma model for table [${operation.table}] already defines a primary key.`);
+		const insertIndex = Math.max(1, bodyLines.length - 1);
+		bodyLines.splice(insertIndex, 0, primaryKeyLine);
+	}
+	for (const constraint of operation.addUniqueConstraints ?? []) {
+		const constraintLine = buildUniqueConstraintLine(constraint);
+		if (bodyLines.some((line) => line.trim() === constraintLine.trim())) continue;
+		const insertIndex = Math.max(1, bodyLines.length - 1);
+		bodyLines.splice(insertIndex, 0, constraintLine);
+	}
 	for (const foreignKey of operation.addForeignKeys ?? []) {
 		const relationLine = buildRelationLine(model.modelName, foreignKey, operation.addColumns);
 		const relationRegex = new RegExp(`^\\s*${escapeRegex(foreignKey.fieldAlias?.trim() || deriveRelationFieldName(foreignKey.column))}\\s+`);
@@ -4866,4 +4979,4 @@ var MorphToManyRelation = class extends Relation {
 };
 
 //#endregion
-export { deletePersistedColumnMappingsState as $, supportsDatabaseCreation as $t, isDelegateLike as A, RelationTableLoader as An, buildModelBlock as At, getRegisteredSeeders as B, findModelBlock as Bt, getRuntimeAdapter as C, resolveMigrationStateFilePath as Cn, applyMigrationToPrismaSchema as Ct, getRuntimePaginationURLDriverFactory as D, RuntimeModuleLoader as Dn, buildIndexLine as Dt, getRuntimePaginationCurrentPageResolver as E, writeAppliedMigrationsStateToStore as En, buildFieldLine as Et, runArkormTransaction as F, deriveRelationAlias as Ft, registerFactories as G, getMigrationPlan as Gt, loadMigrationsFrom as H, formatEnumDefaultValue as Ht, getRegisteredFactories as I, deriveRelationFieldName as It, registerPaths as J, resolveMigrationClassName as Jt, registerMigrations as K, pad as Kt, getRegisteredMigrations as L, deriveSingularFieldName as Lt, isTransactionCapableClient as M, ArkormCollection as Mn, createMigrationTimestamp as Mt, loadArkormConfig as N, ArkormException as Nn, deriveCollectionFieldName as Nt, getRuntimePrismaClient as O, UnsupportedAdapterFeatureException as On, buildInverseRelationLine as Ot, resetArkormRuntimeForTests as P, deriveInverseRelationAlias as Pt, createEmptyPersistedColumnMappingsState as Q, stripPrismaSchemaModelsAndEnums as Qt, getRegisteredModels as R, escapeRegex as Rt, getDefaultStubsPath as S, removeAppliedMigration as Sn, applyMigrationToDatabase as St, getRuntimeDebugHandler as T, writeAppliedMigrationsState as Tn, buildEnumBlock as Tt, loadModelsFrom as U, formatRelationAction as Ut, loadFactoriesFrom as V, formatDefaultValue as Vt, loadSeedersFrom as W, generateMigrationFile as Wt, resetRuntimeRegistryForTests as X, runMigrationWithPrisma as Xt, registerSeeders as Y, resolvePrismaType as Yt, applyOperationsToPersistedColumnMappingsState as Z, runPrismaCommand as Zt, defineConfig as _, isMigrationApplied as _n, applyAlterTableOperation as _t, HasOneRelation as a, EnumBuilder as an, getPersistedTimestampColumns as at, getActiveTransactionAdapter as b, readAppliedMigrationsState as bn, applyMigrationRollbackToDatabase as bt, BelongsToRelation as c, PrimaryKeyGenerationPlanner as cn, resetPersistedColumnMappingsCache as ct, Relation as d, computeMigrationChecksum as dn, syncPersistedColumnMappingsFromState as dt, supportsDatabaseMigrationExecution as en, getPersistedColumnMap as et, LengthAwarePaginator as f, createEmptyAppliedMigrationsState as fn, validatePersistedMetadataFeaturesForMigrations as ft, configureArkormRuntime as g, getLatestAppliedMigrations as gn, PRISMA_MODEL_REGEX as gt, bindAdapterToModels as h, getLastMigrationRun as hn, PRISMA_ENUM_REGEX as ht, HasOneThroughRelation as i, SchemaBuilder as in, getPersistedTableMetadata as it, isQuerySchemaLike as j, RelationResolutionException as jn, buildRelationLine as jt, getUserConfig as k, SetBasedEagerLoader as kn, buildMigrationSource as kt, SingleResultRelation as l, buildMigrationIdentity as ln, resolveColumnMappingsFilePath as lt, URLDriver as m, findAppliedMigration as mn, PRISMA_ENUM_MEMBER_REGEX as mt, MorphOneRelation as n, toMigrationFileSlug as nn, getPersistedEnumTsType as nt, HasManyThroughRelation as o, TableBuilder as on, readPersistedColumnMappingsState as ot, Paginator as p, deleteAppliedMigrationsStateFromStore as pn, writePersistedColumnMappingsState as pt, registerModels as q, resolveEnumName as qt, MorphManyRelation as r, toModelName as rn, getPersistedPrimaryKeyGeneration as rt, HasManyRelation as s, ForeignKeyBuilder as sn, rebuildPersistedColumnMappingsState as st, MorphToManyRelation as t, supportsDatabaseReset as tn, getPersistedEnumMap as tt, BelongsToManyRelation as u, buildMigrationRunId as un, resolvePersistedMetadataFeatures as ut, emitRuntimeDebugEvent as v, markMigrationApplied as vn, applyCreateTableOperation as vt, getRuntimeClient as w, supportsDatabaseMigrationState as wn, applyOperationsToPrismaSchema as wt, getActiveTransactionClient as x, readAppliedMigrationsStateFromStore as xn, applyMigrationRollbackToPrismaSchema as xt, ensureArkormConfigLoading as y, markMigrationRun as yn, applyDropTableOperation as yt, getRegisteredPaths as z, findEnumBlock as zt };
+export { deletePersistedColumnMappingsState as $, runPrismaCommand as $t, isDelegateLike as A, UnsupportedAdapterFeatureException as An, buildModelBlock as At, getRegisteredSeeders as B, escapeRegex as Bt, getRuntimeAdapter as C, readAppliedMigrationsStateFromStore as Cn, applyMigrationToPrismaSchema as Ct, getRuntimePaginationURLDriverFactory as D, writeAppliedMigrationsState as Dn, buildIndexLine as Dt, getRuntimePaginationCurrentPageResolver as E, supportsDatabaseMigrationState as En, buildFieldLine as Et, runArkormTransaction as F, ArkormException as Fn, deriveCollectionFieldName as Ft, registerFactories as G, formatRelationAction as Gt, loadMigrationsFrom as H, findModelBlock as Ht, getRegisteredFactories as I, deriveInverseRelationAlias as It, registerPaths as J, pad as Jt, registerMigrations as K, generateMigrationFile as Kt, getRegisteredMigrations as L, deriveRelationAlias as Lt, isTransactionCapableClient as M, RelationTableLoader as Mn, buildRelationLine as Mt, loadArkormConfig as N, RelationResolutionException as Nn, buildUniqueConstraintLine as Nt, getRuntimePrismaClient as O, writeAppliedMigrationsStateToStore as On, buildInverseRelationLine as Ot, resetArkormRuntimeForTests as P, ArkormCollection as Pn, createMigrationTimestamp as Pt, createEmptyPersistedColumnMappingsState as Q, runMigrationWithPrisma as Qt, getRegisteredModels as R, deriveRelationFieldName as Rt, getDefaultStubsPath as S, readAppliedMigrationsState as Sn, applyMigrationToDatabase as St, getRuntimeDebugHandler as T, resolveMigrationStateFilePath as Tn, buildEnumBlock as Tt, loadModelsFrom as U, formatDefaultValue as Ut, loadFactoriesFrom as V, findEnumBlock as Vt, loadSeedersFrom as W, formatEnumDefaultValue as Wt, resetRuntimeRegistryForTests as X, resolveMigrationClassName as Xt, registerSeeders as Y, resolveEnumName as Yt, applyOperationsToPersistedColumnMappingsState as Z, resolvePrismaType as Zt, defineConfig as _, getLastMigrationRun as _n, applyAlterTableOperation as _t, HasOneRelation as a, toModelName as an, getPersistedTimestampColumns as at, getActiveTransactionAdapter as b, markMigrationApplied as bn, applyMigrationRollbackToDatabase as bt, BelongsToRelation as c, TableBuilder as cn, resetPersistedColumnMappingsCache as ct, Relation as d, buildMigrationIdentity as dn, syncPersistedColumnMappingsFromState as dt, stripPrismaSchemaModelsAndEnums as en, getPersistedColumnMap as et, LengthAwarePaginator as f, buildMigrationRunId as fn, validatePersistedMetadataFeaturesForMigrations as ft, configureArkormRuntime as g, findAppliedMigration as gn, PRISMA_MODEL_REGEX as gt, bindAdapterToModels as h, deleteAppliedMigrationsStateFromStore as hn, PRISMA_ENUM_REGEX as ht, HasOneThroughRelation as i, toMigrationFileSlug as in, getPersistedTableMetadata as it, isQuerySchemaLike as j, SetBasedEagerLoader as jn, buildPrimaryKeyLine as jt, getUserConfig as k, RuntimeModuleLoader as kn, buildMigrationSource as kt, SingleResultRelation as l, ForeignKeyBuilder as ln, resolveColumnMappingsFilePath as lt, URLDriver as m, createEmptyAppliedMigrationsState as mn, PRISMA_ENUM_MEMBER_REGEX as mt, MorphOneRelation as n, supportsDatabaseMigrationExecution as nn, getPersistedEnumTsType as nt, HasManyThroughRelation as o, SchemaBuilder as on, readPersistedColumnMappingsState as ot, Paginator as p, computeMigrationChecksum as pn, writePersistedColumnMappingsState as pt, registerModels as q, getMigrationPlan as qt, MorphManyRelation as r, supportsDatabaseReset as rn, getPersistedPrimaryKeyGeneration as rt, HasManyRelation as s, EnumBuilder as sn, rebuildPersistedColumnMappingsState as st, MorphToManyRelation as t, supportsDatabaseCreation as tn, getPersistedEnumMap as tt, BelongsToManyRelation as u, PrimaryKeyGenerationPlanner as un, resolvePersistedMetadataFeatures as ut, emitRuntimeDebugEvent as v, getLatestAppliedMigrations as vn, applyCreateTableOperation as vt, getRuntimeClient as w, removeAppliedMigration as wn, applyOperationsToPrismaSchema as wt, getActiveTransactionClient as x, markMigrationRun as xn, applyMigrationRollbackToPrismaSchema as xt, ensureArkormConfigLoading as y, isMigrationApplied as yn, applyDropTableOperation as yt, getRegisteredPaths as z, deriveSingularFieldName as zt };

package/dist/{relationship-Cku0y1Mt.cjs → relationship-CuPNAoHm.cjs}

@@ -1046,18 +1046,21 @@ var TableBuilder = class {
 		this.dropColumnNames = [];
 		this.indexes = [];
 		this.foreignKeys = [];
+		this.compositeUniqueConstraints = [];
 	}
-	/**
-	* Defines a primary key column in the table.
-	* 
-	* @param columnNameOrOptions 
-	* @param options 
-	* @returns 
-	*/
 	primary(columnNameOrOptions, options) {
+		if (Array.isArray(columnNameOrOptions)) {
+			const columns = this.normalizeCompositeColumns(columnNameOrOptions, "primary key");
+			if (this.compositePrimaryKey) throw new Error("A composite primary key has already been defined for this table.");
+			this.compositePrimaryKey = {
+				columns,
+				...typeof options === "string" && options.trim() ? { name: options.trim() } : {}
+			};
+			return this;
+		}
 		const config = typeof columnNameOrOptions === "string" ? {
 			columnName: columnNameOrOptions,
-			...options ?? {}
+			...typeof options === "object" ? options : {}
 		} : columnNameOrOptions ?? {};
 		const column = this.resolveColumn(config.columnName);
 		column.primary = true;
@@ -1157,15 +1160,19 @@ var TableBuilder = class {
 	float(name, options = {}) {
 		return this.column(name, "float", options);
 	}
-	/**
-	* Marks a column as unique in the table.
-	* 
-	* @param name Optional explicit column name. 
-	* When omitted, applies to the latest defined column.
-	* @returns The current TableBuilder instance for chaining.
-	*/
-	unique(name) {
-		const column = this.resolveColumn(name);
+	unique(columnsOrName, name) {
+		if (Array.isArray(columnsOrName)) {
+			const columns = this.normalizeCompositeColumns(columnsOrName, "unique constraint");
+			const normalizedName = name?.trim();
+			if (this.compositeUniqueConstraints.find((constraint) => constraint.columns.length === columns.length && constraint.columns.every((column, index) => column === columns[index]))) throw new Error(`A unique constraint for columns [${columns.join(", ")}] has already been defined for this table.`);
+			if (normalizedName && this.compositeUniqueConstraints.some((constraint) => constraint.name === normalizedName)) throw new Error(`A unique constraint named [${normalizedName}] has already been defined for this table.`);
+			this.compositeUniqueConstraints.push({
+				columns,
+				...normalizedName ? { name: normalizedName } : {}
+			});
+			return this;
+		}
+		const column = this.resolveColumn(columnsOrName);
 		column.unique = true;
 		return this;
 	}
@@ -1407,6 +1414,24 @@ var TableBuilder = class {
 		return this.foreignKeys.map((foreignKey) => ({ ...foreignKey }));
 	}
 	/**
+	* Returns a copy of the table-level composite primary key.
+	*/
+	getPrimaryKey() {
+		return this.compositePrimaryKey ? {
+			...this.compositePrimaryKey,
+			columns: [...this.compositePrimaryKey.columns]
+		} : void 0;
+	}
+	/**
+	* Returns copies of table-level composite unique constraints.
+	*/
+	getUniqueConstraints() {
+		return this.compositeUniqueConstraints.map((constraint) => ({
+			...constraint,
+			columns: [...constraint.columns]
+		}));
+	}
+	/**
 	* Defines a column in the table with the given name.
 	* 
 	* @param name      The name of the column.
@@ -1448,6 +1473,13 @@ var TableBuilder = class {
 		if (!column) throw new Error(`Column [${targetName}] was not found in the table definition.`);
 		return column;
 	}
+	normalizeCompositeColumns(columns, label) {
+		const normalized = columns.map((column) => column.trim());
+		if (normalized.length < 2) throw new Error(`A composite ${label} must contain at least two columns.`);
+		if (normalized.some((column) => !column)) throw new Error(`Composite ${label} columns must be non-empty strings.`);
+		if (new Set(normalized).size !== normalized.length) throw new Error(`Composite ${label} columns must be unique.`);
+		return normalized;
+	}
 };
 
 //#endregion
@@ -1473,12 +1505,17 @@ var SchemaBuilder = class {
 	createTable(table, callback) {
 		const builder = new TableBuilder();
 		callback(builder);
+		const primaryKey = builder.getPrimaryKey();
+		this.validateCompositePrimaryKey(table, primaryKey, builder.getColumns(), true);
+		this.validateCompositeUniqueConstraints(table, builder.getUniqueConstraints(), builder.getColumns(), true);
 		this.operations.push({
 			type: "createTable",
 			table,
 			columns: builder.getColumns(),
 			indexes: builder.getIndexes(),
-			foreignKeys: builder.getForeignKeys()
+			foreignKeys: builder.getForeignKeys(),
+			primaryKey,
+			uniqueConstraints: builder.getUniqueConstraints()
 		});
 		return this;
 	}
@@ -1492,13 +1529,18 @@ var SchemaBuilder = class {
 	alterTable(table, callback) {
 		const builder = new TableBuilder();
 		callback(builder);
+		const primaryKey = builder.getPrimaryKey();
+		this.validateCompositePrimaryKey(table, primaryKey, builder.getColumns(), false);
+		this.validateCompositeUniqueConstraints(table, builder.getUniqueConstraints(), builder.getColumns(), false);
 		this.operations.push({
 			type: "alterTable",
 			table,
 			addColumns: builder.getColumns(),
 			dropColumns: builder.getDropColumns(),
 			addIndexes: builder.getIndexes(),
-			addForeignKeys: builder.getForeignKeys()
+			addForeignKeys: builder.getForeignKeys(),
+			addPrimaryKey: primaryKey,
+			addUniqueConstraints: builder.getUniqueConstraints()
 		});
 		return this;
 	}
@@ -1532,7 +1574,15 @@ var SchemaBuilder = class {
 					...index,
 					columns: [...index.columns]
 				})),
-				foreignKeys: operation.foreignKeys.map((foreignKey) => ({ ...foreignKey }))
+				foreignKeys: operation.foreignKeys.map((foreignKey) => ({ ...foreignKey })),
+				primaryKey: operation.primaryKey ? {
+					...operation.primaryKey,
+					columns: [...operation.primaryKey.columns]
+				} : void 0,
+				uniqueConstraints: operation.uniqueConstraints?.map((constraint) => ({
+					...constraint,
+					columns: [...constraint.columns]
+				}))
 			};
 			if (operation.type === "alterTable") return {
 				...operation,
@@ -1545,11 +1595,37 @@ var SchemaBuilder = class {
 					...index,
 					columns: [...index.columns]
 				})),
-				addForeignKeys: operation.addForeignKeys.map((foreignKey) => ({ ...foreignKey }))
+				addForeignKeys: operation.addForeignKeys.map((foreignKey) => ({ ...foreignKey })),
+				addPrimaryKey: operation.addPrimaryKey ? {
+					...operation.addPrimaryKey,
+					columns: [...operation.addPrimaryKey.columns]
+				} : void 0,
+				addUniqueConstraints: operation.addUniqueConstraints?.map((constraint) => ({
+					...constraint,
+					columns: [...constraint.columns]
+				}))
 			};
 			return { ...operation };
 		});
 	}
+	validateCompositePrimaryKey(table, primaryKey, columns, requireColumns) {
+		if (!primaryKey) return;
+		if (columns.some((column) => column.primary)) throw new Error(`Table [${table}] cannot combine column primary keys with a composite primary key.`);
+		if (!requireColumns) return;
+		primaryKey.columns.forEach((columnName) => {
+			const column = columns.find((candidate) => candidate.name === columnName);
+			if (!column) throw new Error(`Composite primary key column [${columnName}] was not found on table [${table}].`);
+			if (column.nullable) throw new Error(`Composite primary key column [${columnName}] on table [${table}] cannot be nullable.`);
+		});
+	}
+	validateCompositeUniqueConstraints(table, constraints, columns, requireColumns) {
+		if (!requireColumns) return;
+		constraints.forEach((constraint) => {
+			constraint.columns.forEach((columnName) => {
+				if (!columns.some((column) => column.name === columnName)) throw new Error(`Composite unique constraint column [${columnName}] was not found on table [${table}].`);
+			});
+		});
+	}
 };
 
 //#endregion
@@ -1773,6 +1849,24 @@ const buildIndexLine = (index) => {
 	return `  @@index([${index.columns.join(", ")}]${typeof index.name === "string" && index.name.trim().length > 0 ? `, name: "${index.name.replace(/"/g, "\\\"")}"` : ""})`;
 };
 /**
+* Build a Prisma model-level composite primary key definition.
+*
+* @param primaryKey
+* @returns
+*/
+const buildPrimaryKeyLine = (primaryKey) => {
+	return `  @@id([${primaryKey.columns.join(", ")}]${typeof primaryKey.name === "string" && primaryKey.name.trim().length > 0 ? `, name: "${primaryKey.name.replace(/"/g, "\\\"")}"` : ""})`;
+};
+/**
+* Build a Prisma model-level composite unique constraint definition.
+*
+* @param constraint
+* @returns
+*/
+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 
 * common conventions, such as removing "Id" suffixes and converting to camelCase.
 * 
@@ -1921,7 +2015,14 @@ const buildModelBlock = (operation) => {
 	const mapped = operation.table !== modelName.toLowerCase();
 	const fields = operation.columns.map(buildFieldLine);
 	const relations = (operation.foreignKeys ?? []).map((foreignKey) => buildRelationLine(modelName, foreignKey, operation.columns));
-	const metadata = [...(operation.indexes ?? []).map(buildIndexLine), ...mapped ? [`  @@map("${(0, _h3ravel_support.str)(operation.table).snake()}")`] : []];
+	const indexes = (operation.indexes ?? []).map(buildIndexLine);
+	const uniqueConstraints = (operation.uniqueConstraints ?? []).map(buildUniqueConstraintLine);
+	const metadata = [
+		...operation.primaryKey ? [buildPrimaryKeyLine(operation.primaryKey)] : [],
+		...uniqueConstraints,
+		...indexes,
+		...mapped ? [`  @@map("${(0, _h3ravel_support.str)(operation.table).snake()}")`] : []
+	];
 	return `model ${modelName} {\n${(metadata.length > 0 ? [
 		...fields,
 		...relations,
@@ -2018,6 +2119,18 @@ const applyAlterTableOperation = (schema, operation) => {
 		const insertIndex = Math.max(1, bodyLines.length - 1);
 		bodyLines.splice(insertIndex, 0, indexLine);
 	});
+	if (operation.addPrimaryKey) {
+		const primaryKeyLine = buildPrimaryKeyLine(operation.addPrimaryKey);
+		if (bodyLines.some((line) => line.includes(" @id") || line.trim().startsWith("@@id("))) throw new ArkormException(`Prisma model for table [${operation.table}] already defines a primary key.`);
+		const insertIndex = Math.max(1, bodyLines.length - 1);
+		bodyLines.splice(insertIndex, 0, primaryKeyLine);
+	}
+	for (const constraint of operation.addUniqueConstraints ?? []) {
+		const constraintLine = buildUniqueConstraintLine(constraint);
+		if (bodyLines.some((line) => line.trim() === constraintLine.trim())) continue;
+		const insertIndex = Math.max(1, bodyLines.length - 1);
+		bodyLines.splice(insertIndex, 0, constraintLine);
+	}
 	for (const foreignKey of operation.addForeignKeys ?? []) {
 		const relationLine = buildRelationLine(model.modelName, foreignKey, operation.addColumns);
 		const relationRegex = new RegExp(`^\\s*${escapeRegex(foreignKey.fieldAlias?.trim() || deriveRelationFieldName(foreignKey.column))}\\s+`);
@@ -5182,12 +5295,24 @@ Object.defineProperty(exports, 'buildModelBlock', {
     return buildModelBlock;
   }
 });
+Object.defineProperty(exports, 'buildPrimaryKeyLine', {
+  enumerable: true,
+  get: function () {
+    return buildPrimaryKeyLine;
+  }
+});
 Object.defineProperty(exports, 'buildRelationLine', {
   enumerable: true,
   get: function () {
     return buildRelationLine;
   }
 });
+Object.defineProperty(exports, 'buildUniqueConstraintLine', {
+  enumerable: true,
+  get: function () {
+    return buildUniqueConstraintLine;
+  }
+});
 Object.defineProperty(exports, 'computeMigrationChecksum', {
   enumerable: true,
   get: function () {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkormx",
-  "version": "2.4.5",
+  "version": "2.4.7",
   "description": "Modern TypeScript-first ORM for Node.js.",
   "keywords": [
     "orm",
@@ -60,7 +60,7 @@
     "@types/node": "^25.6.2",
     "@types/pg": "^8.16.0",
     "@viteplus/versions": "^2.0.6",
-    "@vitest/coverage-v8": "^4.1.5",
+    "@vitest/coverage-v8": "^4.1.8",
     "barrelize": "^1.7.3",
     "dotenv": "^17.3.1",
     "eslint": "^10.3.0",
@@ -73,7 +73,7 @@
     "unrun": "^0.3.0",
     "vite-plugin-swc-transform": "^1.1.1",
     "vitepress": "^2.0.0-alpha.17",
-    "vitest": "^4.1.5"
+    "vitest": "^4.1.8"
   },
   "engines": {
     "node": ">=20.0.0"