arkormx 2.11.13 → 2.12.1

package/dist/index.mjs

@@ -1,10 +1,12 @@
-import { $ as registerSeeders, $n as supportsDatabaseMigrationState, $t as resolveEnumName, A as getRuntimePaginationCurrentPageResolver, An as min, At as buildFieldLine, B as getRegisteredFactories, Bn as createEmptyAppliedMigrationsState, Bt as deriveInverseRelationAlias, C as ensureArkormConfigLoading, Cn as col, Ct as applyDropTableOperation, D as getRuntimeAdapter, Dn as fromExpressionNode, Dt as applyMigrationToPrismaSchema, E as getDefaultStubsPath, En as fn, Et as applyMigrationToDatabase, F as isQuerySchemaLike, Fn as PrimaryKeyGenerationPlanner, Ft as buildPrimaryKeyLine, G as loadFactoriesFrom, Gn as getLatestAppliedMigrations, Gt as findEnumBlock, H as getRegisteredModels, Hn as findAppliedMigration, Ht as deriveRelationFieldName, I as isTransactionCapableClient, In as ForeignKeyBuilder, It as buildRelationLine, J as loadSeedersFrom, Jn as markMigrationRun, Jt as formatEnumDefaultValue, K as loadMigrationsFrom, Kn as isMigrationApplied, Kt as findModelBlock, L as loadArkormConfig, Ln as buildMigrationIdentity, Lt as buildUniqueConstraintLine, M as getRuntimePrismaClient, Mn as sum, Mt as buildInverseRelationLine, N as getUserConfig, Nn as val, Nt as buildMigrationSource, O as getRuntimeClient, On as json, Ot as applyOperationsToPrismaSchema, P as isDelegateLike, Pn as where, Pt as buildModelBlock, Q as registerPaths, Qn as resolveMigrationStateFilePath, Qt as pad, R as resetArkormRuntimeForTests, Rn as buildMigrationRunId, Rt as createMigrationTimestamp, S as emitRuntimeDebugEvent, Sn as coalesce, St as applyCreateTableOperation, T as getActiveTransactionClient, Tn as expressionBuilder, Tt as applyMigrationRollbackToPrismaSchema, U as getRegisteredPaths, Un as getLastBatchMigrations, Ut as deriveSingularFieldName, V as getRegisteredMigrations, Vn as deleteAppliedMigrationsStateFromStore, Vt as deriveRelationAlias, W as getRegisteredSeeders, Wn as getLastMigrationRun, Wt as escapeRegex, X as registerMigrations, Xn as readAppliedMigrationsStateFromStore, Xt as generateMigrationFile, Y as registerFactories, Yn as readAppliedMigrationsState, Yt as formatRelationAction, Z as registerModels, Zn as removeAppliedMigration, Zt as getMigrationPlan, _ as awaitConfiguredModelsRegistration, _n as CaseExpression, _t as writePersistedColumnMappingsState, a as MorphedByManyRelation, an as supportsDatabaseCreation, at as getPersistedEnumMap, b as defineConfig, bn as avg, bt as PRISMA_MODEL_REGEX, c as HasManyThroughRelation, cn as toMigrationFileSlug, cr as ArkormException, ct as getPersistedTableMetadata, dn as runInMigrationPlanning, dt as rebuildPersistedColumnMappingsState, en as resolveMigrationClassName, er as writeAppliedMigrationsState, et as resetRuntimeRegistryForTests, f as BelongsToManyRelation, fn as SchemaBuilder, ft as resetPersistedColumnMappingsCache, g as URLDriver, gn as AggregateExpression, gt as validatePersistedMetadataFeaturesForMigrations, h as Paginator, hn as resolveGeneratedExpression, ht as syncPersistedColumnMappingsFromState, i as MorphManyRelation, in as stripPrismaSchemaModelsAndEnums, ir as SetBasedEagerLoader, it as getPersistedColumnMap, j as getRuntimePaginationURLDriverFactory, jn as raw, jt as buildIndexLine, k as getRuntimeDebugHandler, kn as max, kt as buildEnumBlock, l as HasManyRelation, ln as toModelName, lt as getPersistedTimestampColumns, m as LengthAwarePaginator, mn as TableBuilder, mt as resolvePersistedMetadataFeatures, n as MorphToManyRelation, nn as runMigrationWithPrisma, nr as RuntimeModuleLoader, nt as createEmptyPersistedColumnMappingsState, o as HasOneThroughRelation, on as supportsDatabaseMigrationExecution, or as RelationResolutionException, ot as getPersistedEnumTsType, p as Relation, pn as EnumBuilder, pt as resolveColumnMappingsFilePath, q as loadModelsFrom, qn as markMigrationApplied, qt as formatDefaultValue, r as MorphOneRelation, rn as runPrismaCommand, rr as UnsupportedAdapterFeatureException, rt as deletePersistedColumnMappingsState, s as HasOneRelation, sn as supportsDatabaseReset, sr as ArkormCollection, st as getPersistedPrimaryKeyGeneration, t as MorphToRelation, tn as resolvePrismaType, tr as writeAppliedMigrationsStateToStore, tt as applyOperationsToPersistedColumnMappingsState, u as BelongsToRelation, un as isMigrationPlanningActive, ut as readPersistedColumnMappingsState, v as bindAdapterToModels, vn as Expression, vt as PRISMA_ENUM_MEMBER_REGEX, w as getActiveTransactionAdapter, wn as count, wt as applyMigrationRollbackToDatabase, x as disposeArkormRuntime, xn as caseWhen, xt as applyAlterTableOperation, y as configureArkormRuntime, yn as JsonExpression, yt as PRISMA_ENUM_REGEX, z as runArkormTransaction, zn as computeMigrationChecksum, zt as deriveCollectionFieldName } from "./relationship-DYMxYzUD.mjs";
+import { $ as buildPrimaryKeyLine, $n as readAppliedMigrationsState, $t as bindAdapterToModels, A as resetPersistedColumnMappingsCache, An as registerFactories, At as EnumBuilder, B as applyCreateTableOperation, Bn as ForeignKeyBuilder, Bt as col, C as getPersistedEnumMap, Cn as getRegisteredModels, Ct as supportsDatabaseCreation, D as getPersistedTimestampColumns, Dn as loadMigrationsFrom, Dt as toModelName, E as getPersistedTableMetadata, En as loadFactoriesFrom, Et as toMigrationFileSlug, F as writePersistedColumnMappingsState, Fn as resetRuntimeRegistryForTests, Ft as Expression, G as applyMigrationToPrismaSchema, Gn as deleteAppliedMigrationsStateFromStore, Gt as json, H as applyMigrationRollbackToDatabase, Hn as buildMigrationRunId, Ht as expressionBuilder, I as PRISMA_ENUM_MEMBER_REGEX, In as resolveRegisteredModel, It as JsonExpression, J as buildFieldLine, Jn as getLastMigrationRun, Jt as raw, K as applyOperationsToPrismaSchema, Kn as findAppliedMigration, Kt as max, L as PRISMA_ENUM_REGEX, Ln as UnsupportedAdapterFeatureException, Lt as avg, M as resolvePersistedMetadataFeatures, Mn as registerModels, Mt as resolveGeneratedExpression, N as syncPersistedColumnMappingsFromState, Nn as registerPaths, Nt as AggregateExpression, O as readPersistedColumnMappingsState, On as loadModelsFrom, Ot as isMigrationPlanningActive, P as validatePersistedMetadataFeaturesForMigrations, Pn as registerSeeders, Pt as CaseExpression, Q as buildModelBlock, Qn as markMigrationRun, Qt as awaitConfiguredModelsRegistration, R as PRISMA_MODEL_REGEX, Rn as RuntimeModuleLoader, Rt as caseWhen, S as getPersistedColumnMap, Sn as getRegisteredMigrations, St as stripPrismaSchemaModelsAndEnums, T as getPersistedPrimaryKeyGeneration, Tn as getRegisteredSeeders, Tt as supportsDatabaseReset, U as applyMigrationRollbackToPrismaSchema, Un as computeMigrationChecksum, Ut as fn, V as applyDropTableOperation, Vn as buildMigrationIdentity, Vt as count, W as applyMigrationToDatabase, Wn as createEmptyAppliedMigrationsState, Wt as fromExpressionNode, X as buildInverseRelationLine, Xn as isMigrationApplied, Xt as val, Y as buildIndexLine, Yn as getLatestAppliedMigrations, Yt as sum, Z as buildMigrationSource, Zn as markMigrationApplied, Zt as where, _ as SetBasedEagerLoader, _n as isTransactionCapableClient, _t as resolveEnumName, a as MorphManyRelation, an as getActiveTransactionAdapter, ar as writeAppliedMigrationsStateToStore, at as deriveRelationAlias, b as createEmptyPersistedColumnMappingsState, bn as runArkormTransaction, bt as runMigrationWithPrisma, c as HasManyThroughRelation, cn as getRuntimeAdapter, cr as ArkormException, ct as escapeRegex, dn as getRuntimePaginationCurrentPageResolver, dt as formatDefaultValue, en as configureArkormRuntime, er as readAppliedMigrationsStateFromStore, et as buildRelationLine, f as BelongsToManyRelation, fn as getRuntimePaginationURLDriverFactory, ft as formatEnumDefaultValue, g as URLDriver, gn as isQuerySchemaLike, gt as pad, h as Paginator, hn as isDelegateLike, ht as getMigrationPlan, i as MorphOneRelation, in as ensureArkormConfigLoading, ir as writeAppliedMigrationsState, it as deriveInverseRelationAlias, j as resolveColumnMappingsFilePath, jn as registerMigrations, jt as TableBuilder, k as rebuildPersistedColumnMappingsState, kn as loadSeedersFrom, kt as SchemaBuilder, l as HasManyRelation, ln as getRuntimeClient, lt as findEnumBlock, m as LengthAwarePaginator, mn as getUserConfig, mt as generateMigrationFile, n as MorphedByManyRelation, nn as disposeArkormRuntime, nr as resolveMigrationStateFilePath, nt as createMigrationTimestamp, o as HasOneThroughRelation, on as getActiveTransactionClient, or as RelationResolutionException, ot as deriveRelationFieldName, p as Relation, pn as getRuntimePrismaClient, pt as formatRelationAction, q as buildEnumBlock, qn as getLastBatchMigrations, qt as min, r as MorphToManyRelation, rn as emitRuntimeDebugEvent, rr as supportsDatabaseMigrationState, rt as deriveCollectionFieldName, s as HasOneRelation, sn as getDefaultStubsPath, sr as ArkormCollection, st as deriveSingularFieldName, t as MorphToRelation, tn as defineConfig, tr as removeAppliedMigration, tt as buildUniqueConstraintLine, u as BelongsToRelation, un as getRuntimeDebugHandler, ut as findModelBlock, vn as loadArkormConfig, vt as resolveMigrationClassName, w as getPersistedEnumTsType, wn as getRegisteredPaths, wt as supportsDatabaseMigrationExecution, x as deletePersistedColumnMappingsState, xn as getRegisteredFactories, xt as runPrismaCommand, y as applyOperationsToPersistedColumnMappingsState, yn as resetArkormRuntimeForTests, yt as resolvePrismaType, z as applyAlterTableOperation, zn as PrimaryKeyGenerationPlanner, zt as coalesce } from "./relationship-CrNsvYto.mjs";
 import { Pool } from "pg";
-import { join, resolve } from "node:path";
+import { extname, isAbsolute, join, relative, resolve } from "node:path";
+import { existsSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
+import { createJiti } from "jiti";
+import { pathToFileURL } from "node:url";
 import { createRequire } from "module";
-import { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "fs";
-import { dirname as dirname$1, extname as extname$1, join as join$1, relative } from "path";
-import { existsSync as existsSync$1, readFileSync as readFileSync$1, readdirSync as readdirSync$1, rmSync as rmSync$1, writeFileSync as writeFileSync$1 } from "node:fs";
+import { copyFileSync, existsSync as existsSync$1, mkdirSync as mkdirSync$1, readFileSync as readFileSync$1, readdirSync as readdirSync$1, realpathSync, rmSync as rmSync$1, writeFileSync as writeFileSync$1 } from "fs";
+import { dirname as dirname$1, extname as extname$1, join as join$1, relative as relative$1 } from "path";
 import { DateTime, str } from "@h3ravel/support";
 import { AsyncLocalStorage } from "node:async_hooks";
 import { sql } from "kysely";
@@ -2379,6 +2381,92 @@ const createPrismaDatabaseAdapter = (prisma, mapping = {}) => {
 */
 const createPrismaCompatibilityAdapter = createPrismaDatabaseAdapter;
 
+//#endregion
+//#region src/helpers/model-resolver.ts
+const modelExtensions = [
+	".ts",
+	".tsx",
+	".mts",
+	".cts",
+	".js",
+	".mjs",
+	".cjs"
+];
+const isModelModule = (value) => typeof value === "object" && value !== null;
+const isModelConstructor = (value) => {
+	if (typeof value !== "function") return false;
+	const candidate = value;
+	return typeof candidate.query === "function" && typeof candidate.hydrate === "function" && typeof candidate.getTable === "function" && typeof candidate.getPrimaryKey === "function";
+};
+const resolveModelExport = (module, modelName) => {
+	if (!isModelModule(module)) return module;
+	return module.default ?? module[modelName] ?? module;
+};
+const resolveRuntimeDirectory = (directory) => {
+	if (existsSync(directory)) return directory;
+	const buildOutput = getUserConfig("paths")?.buildOutput;
+	if (typeof buildOutput !== "string" || buildOutput.trim().length === 0) return directory;
+	const relativeSource = relative(process.cwd(), directory);
+	if (!relativeSource || relativeSource.startsWith("..")) return directory;
+	const mappedDirectory = join(buildOutput, relativeSource);
+	return existsSync(mappedDirectory) ? mappedDirectory : directory;
+};
+const resolveRuntimeModelPath = (sourcePath) => {
+	const extension = extname(sourcePath).toLowerCase();
+	const candidates = [];
+	if (modelExtensions.includes(extension)) candidates.push(sourcePath);
+	else candidates.push(...modelExtensions.map((modelExtension) => `${sourcePath}${modelExtension}`));
+	const buildOutput = getUserConfig("paths")?.buildOutput;
+	if (typeof buildOutput === "string" && buildOutput.trim().length > 0) candidates.slice().forEach((candidate) => {
+		const relativeSource = relative(process.cwd(), candidate);
+		if (!relativeSource || relativeSource.startsWith("..")) return;
+		const mappedFile = join(buildOutput, relativeSource);
+		const mappedExtension = extname(mappedFile).toLowerCase();
+		if ([
+			".ts",
+			".tsx",
+			".mts",
+			".cts"
+		].includes(mappedExtension)) {
+			const base = mappedFile.slice(0, -mappedExtension.length);
+			candidates.push(`${base}.js`, `${base}.mjs`, `${base}.cjs`);
+			return;
+		}
+		candidates.push(mappedFile);
+	});
+	return candidates.find((candidate) => existsSync(candidate)) ?? sourcePath;
+};
+const getModelDirectories = () => {
+	const configured = getUserConfig("paths")?.models;
+	const registered = getRegisteredPaths("models");
+	return [...typeof configured === "string" ? [configured] : [], ...registered].map((directory) => resolveRuntimeDirectory(isAbsolute(directory) ? directory : resolve(directory))).filter((directory, index, all) => all.indexOf(directory) === index);
+};
+const loadModel = (modelName, exportName) => {
+	const jiti = createJiti(`${pathToFileURL(resolve(".")).href}/`, {
+		interopDefault: false,
+		tsconfigPaths: true,
+		sourceMaps: true
+	});
+	for (const directory of getModelDirectories()) {
+		const modulePath = resolveRuntimeModelPath(join(directory, modelName));
+		if (!existsSync(modulePath)) continue;
+		const model = resolveModelExport(jiti(modulePath), exportName);
+		if (!isModelConstructor(model)) continue;
+		registerModels(model);
+		return model;
+	}
+};
+function getModel(modelName) {
+	const normalized = modelName.trim();
+	const exportName = normalized.replace(/\\/g, "/").split("/").pop()?.replace(/\.[^.]+$/, "");
+	if (!normalized || !exportName) throw new Error("Model name is required.");
+	const registeredModel = getRegisteredModels().find((model) => model.name === exportName);
+	if (registeredModel) return registeredModel;
+	const model = loadModel(normalized, exportName);
+	if (model) return model;
+	throw new Error(`Model "${modelName}" not found.`);
+}
+
 //#endregion
 //#region src/Arkorm.ts
 var Arkorm = class Arkorm {
@@ -2398,6 +2486,7 @@ var Arkorm = class Arkorm {
 		this.getRegisteredMigrations = Arkorm.getRegisteredMigrations;
 		this.getRegisteredSeeders = Arkorm.getRegisteredSeeders;
 		this.getRegisteredModels = Arkorm.getRegisteredModels;
+		this.getModel = Arkorm.getModel;
 		this.getRegisteredFactories = Arkorm.getRegisteredFactories;
 	}
 	/**
@@ -2525,6 +2614,9 @@ var Arkorm = class Arkorm {
 	static getRegisteredModels() {
 		return getRegisteredModels();
 	}
+	static {
+		this.getModel = getModel;
+	}
 	/**
 	* Get registered factory constructors or instances.
 	*
@@ -2652,7 +2744,7 @@ var CliApp = class {
 	*/
 	ensureDirectory(filePath) {
 		const dir = dirname$1(filePath);
-		if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+		if (!existsSync$1(dir)) mkdirSync$1(dir, { recursive: true });
 	}
 	/**
 	* Convert absolute paths under current working directory into relative display paths.
@@ -2661,7 +2753,7 @@ var CliApp = class {
 	* @returns
 	*/
 	formatPathForLog(filePath) {
-		const relPath = relative(process.cwd(), filePath);
+		const relPath = relative$1(process.cwd(), filePath);
 		if (!relPath) return ".";
 		if (relPath.startsWith("..")) return filePath;
 		return relPath;
@@ -2701,13 +2793,13 @@ var CliApp = class {
 	* @returns
 	*/
 	resolveRuntimeDirectoryPath(directoryPath) {
-		if (existsSync(directoryPath)) return directoryPath;
+		if (existsSync$1(directoryPath)) return directoryPath;
 		const { buildOutput } = this.getConfig("paths") || {};
 		if (typeof buildOutput !== "string" || buildOutput.trim().length === 0) return directoryPath;
-		const relativeSource = relative(process.cwd(), directoryPath);
+		const relativeSource = relative$1(process.cwd(), directoryPath);
 		if (!relativeSource || relativeSource.startsWith("..")) return directoryPath;
 		const mappedDirectory = join$1(buildOutput, relativeSource);
-		return existsSync(mappedDirectory) ? mappedDirectory : directoryPath;
+		return existsSync$1(mappedDirectory) ? mappedDirectory : directoryPath;
 	}
 	/**
 	* Resolve a script file path for runtime execution.
@@ -2727,7 +2819,7 @@ var CliApp = class {
 		}
 		const { buildOutput } = this.getConfig("paths") ?? {};
 		if (typeof buildOutput === "string" && buildOutput.trim().length > 0) {
-			const relativeSource = relative(process.cwd(), filePath);
+			const relativeSource = relative$1(process.cwd(), filePath);
 			if (relativeSource && !relativeSource.startsWith("..")) {
 				const mappedFile = join$1(buildOutput, relativeSource);
 				const mappedExtension = extname$1(mappedFile).toLowerCase();
@@ -2737,7 +2829,7 @@ var CliApp = class {
 				} else candidates.push(mappedFile);
 			}
 		}
-		const runtimeMatch = candidates.find((path) => existsSync(path));
+		const runtimeMatch = candidates.find((path) => existsSync$1(path));
 		if (runtimeMatch) return runtimeMatch;
 		return filePath;
 	}
@@ -2749,14 +2841,14 @@ var CliApp = class {
 	* @param replacements
 	*/
 	generateFile(stubPath, outputPath, replacements, options) {
-		if (existsSync(outputPath) && !options?.force) {
+		if (existsSync$1(outputPath) && !options?.force) {
 			this.command.error(`Error: ${this.formatPathForLog(outputPath)} already exists.`);
 			process.exit(1);
-		} else if (existsSync(outputPath) && options?.force) rmSync(outputPath);
-		let content = readFileSync(stubPath, "utf-8");
+		} else if (existsSync$1(outputPath) && options?.force) rmSync$1(outputPath);
+		let content = readFileSync$1(stubPath, "utf-8");
 		for (const [key, value] of Object.entries(replacements)) content = content.replace(new RegExp(`{{${key}}}`, "g"), value);
 		this.ensureDirectory(outputPath);
-		writeFileSync(outputPath, content);
+		writeFileSync$1(outputPath, content);
 		return outputPath;
 	}
 	/**
@@ -2794,7 +2886,7 @@ var CliApp = class {
 		const outputExt = this.resolveOutputExt();
 		const outputPath = join$1(this.resolveConfigPath("factories", join$1(process.cwd(), "database", "factories")), `${factoryName}.${outputExt}`);
 		const modelPath = join$1(this.resolveConfigPath("models", join$1(process.cwd(), "src", "models")), `${modelName}.${outputExt}`);
-		const relativeImport = options.modelImportPath ?? `./${this.stripKnownSourceExtension(relative(dirname$1(outputPath), modelPath).replace(/\\/g, "/"))}${outputExt === "js" ? ".js" : ""}`;
+		const relativeImport = options.modelImportPath ?? `./${this.stripKnownSourceExtension(relative$1(dirname$1(outputPath), modelPath).replace(/\\/g, "/"))}${outputExt === "js" ? ".js" : ""}`;
 		const stubPath = this.resolveStubPath(outputExt === "js" ? "factory.js.stub" : "factory.stub");
 		return {
 			name: factoryName,
@@ -2856,7 +2948,7 @@ var CliApp = class {
 		const shouldBuildMigration = options.all || options.migration;
 		const factoryName = `${baseName}Factory`;
 		const factoryPath = join$1(this.resolveConfigPath("factories", join$1(process.cwd(), "database", "factories")), `${factoryName}.${outputExt}`);
-		const factoryImportPath = `./${relative(dirname$1(outputPath), factoryPath).replace(/\\/g, "/").replace(/\.(ts|tsx|mts|cts|js|mjs|cjs)$/i, "")}${outputExt === "js" ? ".js" : ""}`;
+		const factoryImportPath = `./${relative$1(dirname$1(outputPath), factoryPath).replace(/\\/g, "/").replace(/\.(ts|tsx|mts|cts|js|mjs|cjs)$/i, "")}${outputExt === "js" ? ".js" : ""}`;
 		let stubPath;
 		if (options.pivot) stubPath = this.resolveStubPath("pivot-model.stub");
 		else stubPath = this.resolveStubPath(outputExt === "js" ? "model.js.stub" : "model.stub");
@@ -2880,7 +2972,7 @@ var CliApp = class {
 		if (shouldBuildFactory) created.factory = this.makeFactory(baseName, {
 			force: options.force,
 			modelName,
-			modelImportPath: `./${relative(dirname$1(factoryPath), outputPath).replace(/\\/g, "/").replace(/\.(ts|tsx|mts|cts|js|mjs|cjs)$/i, "")}${outputExt === "js" ? ".js" : ""}`
+			modelImportPath: `./${relative$1(dirname$1(factoryPath), outputPath).replace(/\\/g, "/").replace(/\.(ts|tsx|mts|cts|js|mjs|cjs)$/i, "")}${outputExt === "js" ? ".js" : ""}`
 		});
 		if (shouldBuildSeeder) created.seeder = this.makeSeeder(baseName, { force: options.force });
 		if (shouldBuildMigration) created.migration = this.makeMigration(`create ${tableName} table`);
@@ -2896,15 +2988,15 @@ var CliApp = class {
 	*/
 	ensurePrismaModelEntry(modelName, tableName) {
 		const schemaPath = join$1(process.cwd(), "prisma", "schema.prisma");
-		if (!existsSync(schemaPath)) return void 0;
-		const source = readFileSync(schemaPath, "utf-8");
+		if (!existsSync$1(schemaPath)) return void 0;
+		const source = readFileSync$1(schemaPath, "utf-8");
 		const existingByTable = findModelBlock(source, tableName);
 		const existingByName = new RegExp(`model\\s+${modelName}\\s*\\{`, "m").test(source);
 		if (existingByTable || existingByName) return {
 			path: schemaPath,
 			updated: false
 		};
-		writeFileSync(schemaPath, applyCreateTableOperation(source, {
+		writeFileSync$1(schemaPath, applyCreateTableOperation(source, {
 			type: "createTable",
 			table: tableName,
 			columns: [{
@@ -3122,7 +3214,7 @@ var CliApp = class {
 		return lines.join("\n");
 	}
 	parseModelSyncSource(modelSource) {
-		const classMatch = modelSource.match(/export\s+class\s+(\w+)\s+extends\s+Model(?:<[^\n]+>)?\s*\{/);
+		const classMatch = modelSource.match(/export\s+(?:abstract\s+)?class\s+(\w+)\s+extends\s+/);
 		if (!classMatch) return null;
 		const className = classMatch[1];
 		const tableMatch = modelSource.match(/protected\s+static\s+override\s+table\s*=\s*['"]([^'"]+)['"]/) ?? modelSource.match(/static\s+table\s*=\s*['"]([^'"]+)['"]/);
@@ -3136,7 +3228,7 @@ var CliApp = class {
 		const updated = [];
 		const skipped = [];
 		modelFiles.forEach((filePath) => {
-			const source = readFileSync(filePath, "utf-8");
+			const source = readFileSync$1(filePath, "utf-8");
 			const structure = resolveStructure(filePath, source);
 			if (!structure || structure.fields.length === 0) {
 				skipped.push(filePath);
@@ -3147,7 +3239,7 @@ var CliApp = class {
 				skipped.push(filePath);
 				return;
 			}
-			writeFileSync(filePath, synced.content);
+			writeFileSync$1(filePath, synced.content);
 			updated.push(filePath);
 		});
 		return {
@@ -3155,6 +3247,58 @@ var CliApp = class {
 			skipped
 		};
 	}
+	resolveModelFiles(modelsDir) {
+		if (!existsSync$1(modelsDir)) throw new Error(`Models directory not found: ${modelsDir}`);
+		return readdirSync$1(modelsDir).filter((file) => file.endsWith(".ts")).map((file) => join$1(modelsDir, file));
+	}
+	syncModelRegistryTypes(modelFiles) {
+		const registryDir = join$1(realpathSync(process.cwd()), ".arkormx");
+		const registryPath = join$1(registryDir, "models.d.ts");
+		const models = modelFiles.map((filePath) => {
+			const parsed = this.parseModelSyncSource(readFileSync$1(filePath, "utf-8"));
+			if (!parsed) return null;
+			return {
+				className: parsed.className,
+				importPath: this.resolveModelRegistryImportPath(registryPath, filePath)
+			};
+		}).filter((model) => model !== null).sort((left, right) => left.className.localeCompare(right.className));
+		const importLines = models.map((model) => {
+			return `import type { ${model.className} } from '${model.importPath}'`;
+		});
+		const registryLines = models.map((model) => {
+			return `    ${model.className}: typeof ${model.className}`;
+		});
+		const content = [
+			"/* eslint-disable */",
+			"// This file is generated by `arkorm models:sync`.",
+			...importLines,
+			"",
+			"declare module 'arkormx' {",
+			"  interface ArkormModelRegistry {",
+			...registryLines,
+			"  }",
+			"}",
+			"",
+			"export {}",
+			""
+		].join("\n");
+		if ((existsSync$1(registryPath) ? readFileSync$1(registryPath, "utf-8") : null) === content) return {
+			path: registryPath,
+			updated: false
+		};
+		mkdirSync$1(registryDir, { recursive: true });
+		writeFileSync$1(registryPath, content);
+		return {
+			path: registryPath,
+			updated: true
+		};
+	}
+	resolveModelRegistryImportPath(registryPath, modelPath) {
+		const realModelPath = realpathSync(modelPath);
+		const withoutExtension = realModelPath.slice(0, -extname$1(realModelPath).length);
+		const relativePath = relative$1(dirname$1(registryPath), withoutExtension).replace(/\\/g, "/");
+		return relativePath.startsWith(".") ? relativePath : `./${relativePath}`;
+	}
 	applyPersistedFieldMetadata(structure) {
 		const persistedMetadata = getPersistedTableMetadata(structure.table, {
 			features: resolvePersistedMetadataFeatures(this.getConfig("features")),
@@ -3332,12 +3476,11 @@ var CliApp = class {
 	}
 	async syncModels(options = {}) {
 		const modelsDir = options.modelsDir ?? this.resolveConfigPath("models", join$1(process.cwd(), "src", "models"));
-		if (!existsSync(modelsDir)) throw new Error(`Models directory not found: ${modelsDir}`);
-		const modelFiles = readdirSync(modelsDir).filter((file) => file.endsWith(".ts")).map((file) => join$1(modelsDir, file));
+		const modelFiles = this.resolveModelFiles(modelsDir);
 		const adapter = this.getConfig("adapter");
 		if (adapter && typeof adapter.introspectModels === "function") {
 			const sources = modelFiles.reduce((all, filePath) => {
-				const parsed = this.parseModelSyncSource(readFileSync(filePath, "utf-8"));
+				const parsed = this.parseModelSyncSource(readFileSync$1(filePath, "utf-8"));
 				if (parsed) all.set(filePath, parsed);
 				return all;
 			}, /* @__PURE__ */ new Map());
@@ -3350,11 +3493,13 @@ var CliApp = class {
 				const parsed = sources.get(filePath);
 				return parsed ? structuresByTable.get(parsed.table) : void 0;
 			}, /* @__PURE__ */ new Map());
+			const modelTypes = this.syncModelRegistryTypes(modelFiles);
 			return {
 				source: "adapter",
 				modelsDir,
+				modelTypesPath: modelTypes.path,
 				total: modelFiles.length,
-				updated: result.updated,
+				updated: modelTypes.updated ? [...result.updated, modelTypes.path] : result.updated,
 				skipped: result.skipped
 			};
 		}
@@ -3363,6 +3508,19 @@ var CliApp = class {
 			...this.syncModelsFromPrisma(options)
 		};
 	}
+	syncModelRegistry(options = {}) {
+		const modelsDir = options.modelsDir ?? this.resolveConfigPath("models", join$1(process.cwd(), "src", "models"));
+		const modelFiles = this.resolveModelFiles(modelsDir);
+		const modelTypes = this.syncModelRegistryTypes(modelFiles);
+		return {
+			source: "registry",
+			modelsDir,
+			modelTypesPath: modelTypes.path,
+			total: modelFiles.length,
+			updated: modelTypes.updated ? [modelTypes.path] : [],
+			skipped: []
+		};
+	}
 	/**
 	* Sync model attribute declarations in model files based on the Prisma schema.
 	* This method reads the Prisma schema to extract model definitions and their
@@ -3377,22 +3535,23 @@ var CliApp = class {
 	syncModelsFromPrisma(options = {}) {
 		const schemaPath = options.schemaPath ?? join$1(process.cwd(), "prisma", "schema.prisma");
 		const modelsDir = options.modelsDir ?? this.resolveConfigPath("models", join$1(process.cwd(), "src", "models"));
-		if (!existsSync(schemaPath)) throw new Error(`Prisma schema file not found: ${schemaPath}`);
-		if (!existsSync(modelsDir)) throw new Error(`Models directory not found: ${modelsDir}`);
-		const schema = readFileSync(schemaPath, "utf-8");
+		if (!existsSync$1(schemaPath)) throw new Error(`Prisma schema file not found: ${schemaPath}`);
+		const schema = readFileSync$1(schemaPath, "utf-8");
 		const prismaEnums = this.parsePrismaEnums(schema);
 		const prismaModels = this.parsePrismaModels(schema);
-		const modelFiles = readdirSync(modelsDir).filter((file) => file.endsWith(".ts")).map((file) => join$1(modelsDir, file));
+		const modelFiles = this.resolveModelFiles(modelsDir);
 		const result = this.syncModelFiles(modelFiles, (filePath, source) => {
 			const parsed = this.parseModelSyncSource(source);
 			if (!parsed) return void 0;
 			return prismaModels.find((model) => model.table === parsed.table) ?? prismaModels.find((model) => model.name === parsed.className);
 		}, prismaEnums);
+		const modelTypes = this.syncModelRegistryTypes(modelFiles);
 		return {
 			schemaPath,
 			modelsDir,
+			modelTypesPath: modelTypes.path,
 			total: modelFiles.length,
-			updated: result.updated,
+			updated: modelTypes.updated ? [...result.updated, modelTypes.path] : result.updated,
 			skipped: result.skipped
 		};
 	}
@@ -3502,11 +3661,11 @@ var DbCommand = class extends Command {
 		const filePath = this.option("file") ? String(this.option("file")) : void 0;
 		if (filePath) {
 			const resolved = resolve(filePath);
-			if (!existsSync$1(resolved)) {
+			if (!existsSync(resolved)) {
 				this.error(`Error: SQL file not found: ${this.app.formatPathForLog(resolved)}`);
 				return null;
 			}
-			return readFileSync$1(resolved, "utf-8");
+			return readFileSync(resolved, "utf-8");
 		}
 		return await this.multiline("Query", "Enter the SQL to execute");
 	}
@@ -3592,18 +3751,18 @@ var InitCommand = class extends Command {
 		const stubsDir = typeof stubs === "string" && stubs.trim().length > 0 ? stubs : getDefaultStubsPath();
 		const preferredStubPath = join(stubsDir, "arkormx.config.stub");
 		const legacyStubPath = join(stubsDir, "arkorm.config.stub");
-		const stubPath = existsSync(preferredStubPath) ? preferredStubPath : legacyStubPath;
-		if (existsSync(outputDir) && !this.option("force")) {
+		const stubPath = existsSync$1(preferredStubPath) ? preferredStubPath : legacyStubPath;
+		if (existsSync$1(outputDir) && !this.option("force")) {
 			this.error("Error: Arkormˣ has already been initialized. Use --force to reinitialize.");
 			process.exit(1);
 		}
 		this.app.ensureDirectory(outputDir);
-		if (existsSync(outputDir) && this.option("force")) copyFileSync(outputDir, outputDir.replace(/\.js$/, `.backup.${Date.now()}.js`));
-		if (!existsSync(stubPath)) {
+		if (existsSync$1(outputDir) && this.option("force")) copyFileSync(outputDir, outputDir.replace(/\.js$/, `.backup.${Date.now()}.js`));
+		if (!existsSync$1(stubPath)) {
 			this.error(`Error: Missing config stub at ${preferredStubPath} (or ${legacyStubPath})`);
 			process.exit(1);
 		}
-		writeFileSync(outputDir, readFileSync(stubPath, "utf-8"));
+		writeFileSync$1(outputDir, readFileSync$1(stubPath, "utf-8"));
 		this.success("Arkormˣ initialized successfully!");
 	}
 };
@@ -3785,6 +3944,7 @@ var MigrateCommand = class extends Command {
         {--deploy : Use prisma migrate deploy instead of migrate dev (Prisma compatibility driver only)}
         {--skip-generate : Skip prisma generate (Prisma compatibility driver only)}
         {--skip-migrate : Skip prisma migrate command}
+        {--r|registry : Sync the generated model registry type augmentation after a successful migration}
         {--state-file= : Path to applied migration state file}
         {--schema= : Explicit prisma schema path (Prisma compatibility driver only)}
         {--migration-name= : Name for prisma migrate dev (Prisma compatibility driver only)}
@@ -3841,6 +4001,7 @@ var MigrateCommand = class extends Command {
 				this.error(`Error: ${error instanceof Error ? error.message : String(error)}`);
 				return;
 			}
+			if (!this.syncModelRegistryIfRequested()) return;
 			this.success("No pending migration classes to apply.");
 			return;
 		}
@@ -3899,6 +4060,18 @@ var MigrateCommand = class extends Command {
 		], process.cwd());
 		this.success(`Applied ${pending.length} migration(s).`);
 		pending.forEach(([_, file]) => this.success(this.app.splitLogger("Migrated", file)));
+		this.syncModelRegistryIfRequested();
+	}
+	syncModelRegistryIfRequested() {
+		if (!this.option("registry") && !this.option("r")) return true;
+		try {
+			const result = this.app.syncModelRegistry();
+			this.success(this.app.splitLogger("Model Types", result.modelTypesPath ?? "none"));
+			return true;
+		} catch (error) {
+			this.error(`Error: ${error instanceof Error ? error.message : String(error)}`);
+			return false;
+		}
 	}
 	/**
 	* Load all migration classes from the specified directory.
@@ -3906,10 +4079,10 @@ var MigrateCommand = class extends Command {
 	* @param migrationsDir The directory to load migration classes from.
 	*/
 	resolveMigrationDirectories(configuredMigrationsDir) {
-		return [this.app.resolveRuntimeDirectoryPath(configuredMigrationsDir), ...getRegisteredPaths("migrations").map((directory) => this.app.resolveRuntimeDirectoryPath(directory))].filter((directory, index, all) => existsSync$1(directory) && all.indexOf(directory) === index);
+		return [this.app.resolveRuntimeDirectoryPath(configuredMigrationsDir), ...getRegisteredPaths("migrations").map((directory) => this.app.resolveRuntimeDirectoryPath(directory))].filter((directory, index, all) => existsSync(directory) && all.indexOf(directory) === index);
 	}
 	async loadAllMigrations(migrationsDirs) {
-		const files = migrationsDirs.flatMap((migrationsDir) => readdirSync$1(migrationsDir).filter((file) => /\.(ts|js|mjs|cjs)$/i.test(file)).sort((left, right) => left.localeCompare(right)).map((file) => this.app.resolveRuntimeScriptPath(join(migrationsDir, file))));
+		const files = migrationsDirs.flatMap((migrationsDir) => readdirSync(migrationsDir).filter((file) => /\.(ts|js|mjs|cjs)$/i.test(file)).sort((left, right) => left.localeCompare(right)).map((file) => this.app.resolveRuntimeScriptPath(join(migrationsDir, file))));
 		return [...(await Promise.all(files.map(async (file) => (await this.loadMigrationClassesFromFile(file)).map((cls) => [cls, file])))).flat(), ...getRegisteredMigrations().map((cls) => [cls, `registered:${cls.name}`])];
 	}
 	/**
@@ -3933,7 +4106,7 @@ var MigrateCommand = class extends Command {
 			`${base}Migration.js`,
 			`${base}Migration.mjs`,
 			`${base}Migration.cjs`
-		].map((file) => join(migrationsDir, file))).find((file) => existsSync$1(file));
+		].map((file) => join(migrationsDir, file))).find((file) => existsSync(file));
 		if (!target) return [[void 0, name]];
 		const runtimeTarget = this.app.resolveRuntimeScriptPath(target);
 		return (await this.loadMigrationClassesFromFile(runtimeTarget)).map((cls) => [cls, runtimeTarget]);
@@ -4040,8 +4213,8 @@ var MigrateFreshCommand = class extends Command {
 			}
 			if (!(await this.runWithDatabaseCreationRetry(adapter, () => adapter.resetDatabase())).ok) return;
 		} else {
-			if (!existsSync$1(schemaPath)) return void this.error(`Error: Prisma schema file not found: ${this.app.formatPathForLog(schemaPath)}`);
-			writeFileSync$1(schemaPath, stripPrismaSchemaModelsAndEnums(readFileSync$1(schemaPath, "utf-8")));
+			if (!existsSync(schemaPath)) return void this.error(`Error: Prisma schema file not found: ${this.app.formatPathForLog(schemaPath)}`);
+			writeFileSync(schemaPath, stripPrismaSchemaModelsAndEnums(readFileSync(schemaPath, "utf-8")));
 		}
 		let appliedState = createEmptyAppliedMigrationsState();
 		if (!(await this.runWithDatabaseCreationRetry(adapter, () => writeAppliedMigrationsStateToStore(adapter, stateFilePath, appliedState))).ok) return;
@@ -4088,10 +4261,10 @@ var MigrateFreshCommand = class extends Command {
 		migrations.forEach(([_, file]) => this.success(this.app.splitLogger("Migrated", file)));
 	}
 	resolveMigrationDirectories(configuredMigrationsDir) {
-		return [this.app.resolveRuntimeDirectoryPath(configuredMigrationsDir), ...getRegisteredPaths("migrations").map((directory) => this.app.resolveRuntimeDirectoryPath(directory))].filter((directory, index, all) => existsSync$1(directory) && all.indexOf(directory) === index);
+		return [this.app.resolveRuntimeDirectoryPath(configuredMigrationsDir), ...getRegisteredPaths("migrations").map((directory) => this.app.resolveRuntimeDirectoryPath(directory))].filter((directory, index, all) => existsSync(directory) && all.indexOf(directory) === index);
 	}
 	async loadAllMigrations(migrationsDirs) {
-		const files = migrationsDirs.flatMap((migrationsDir) => readdirSync$1(migrationsDir).filter((file) => /\.(ts|js|mjs|cjs)$/i.test(file)).sort((left, right) => left.localeCompare(right)).map((file) => this.app.resolveRuntimeScriptPath(join(migrationsDir, file))));
+		const files = migrationsDirs.flatMap((migrationsDir) => readdirSync(migrationsDir).filter((file) => /\.(ts|js|mjs|cjs)$/i.test(file)).sort((left, right) => left.localeCompare(right)).map((file) => this.app.resolveRuntimeScriptPath(join(migrationsDir, file))));
 		return [...(await Promise.all(files.map(async (file) => (await this.loadMigrationClassesFromFile(file)).map((cls) => [cls, file])))).flat(), ...getRegisteredMigrations().map((cls) => [cls, `registered:${cls.name}`])];
 	}
 	async loadMigrationClassesFromFile(filePath) {
@@ -4236,10 +4409,10 @@ var MigrateRollbackCommand = class extends Command {
 		rollbackClasses.forEach(([_, file]) => this.success(this.app.splitLogger("RolledBack", file)));
 	}
 	resolveMigrationDirectories(configuredMigrationsDir) {
-		return [this.app.resolveRuntimeDirectoryPath(configuredMigrationsDir), ...getRegisteredPaths("migrations").map((directory) => this.app.resolveRuntimeDirectoryPath(directory))].filter((directory, index, all) => existsSync$1(directory) && all.indexOf(directory) === index);
+		return [this.app.resolveRuntimeDirectoryPath(configuredMigrationsDir), ...getRegisteredPaths("migrations").map((directory) => this.app.resolveRuntimeDirectoryPath(directory))].filter((directory, index, all) => existsSync(directory) && all.indexOf(directory) === index);
 	}
 	async loadAllMigrations(migrationsDirs) {
-		const files = migrationsDirs.flatMap((migrationsDir) => readdirSync$1(migrationsDir).filter((file) => /\.(ts|js|mjs|cjs)$/i.test(file)).sort((left, right) => left.localeCompare(right)).map((file) => this.app.resolveRuntimeScriptPath(join(migrationsDir, file))));
+		const files = migrationsDirs.flatMap((migrationsDir) => readdirSync(migrationsDir).filter((file) => /\.(ts|js|mjs|cjs)$/i.test(file)).sort((left, right) => left.localeCompare(right)).map((file) => this.app.resolveRuntimeScriptPath(join(migrationsDir, file))));
 		return [...(await Promise.all(files.map(async (file) => (await this.loadMigrationClassesFromFile(file)).map((cls) => [cls, file])))).flat(), ...getRegisteredMigrations().map((cls) => [cls, `registered:${cls.name}`])];
 	}
 	async loadMigrationClassesFromFile(filePath) {
@@ -4285,11 +4458,11 @@ var MigrationHistoryCommand = class extends Command {
 				this.success("Deleted tracked migration state from database.");
 				return;
 			}
-			if (!existsSync$1(stateFilePath)) {
+			if (!existsSync(stateFilePath)) {
 				this.success(`No migration state file found at ${this.app.formatPathForLog(stateFilePath)}`);
 				return;
 			}
-			rmSync$1(stateFilePath);
+			rmSync(stateFilePath);
 			deletePersistedColumnMappingsState(resolveColumnMappingsFilePath(process.cwd()));
 			this.success(`Deleted migration state file: ${this.app.formatPathForLog(stateFilePath)}`);
 			return;
@@ -4328,6 +4501,7 @@ var ModelsSyncCommand = class extends Command {
 		this.signature = `models:sync
         {--schema= : Path to prisma schema file used when adapter introspection is unavailable}
         {--models= : Path to models directory}
+        {--r|registry-only : Only sync the generated model registry type augmentation}
     `;
 		this.description = "Sync model declare attributes from the active adapter when supported";
 	}
@@ -4336,10 +4510,11 @@ var ModelsSyncCommand = class extends Command {
 		await loadArkormConfig();
 		let result;
 		try {
-			result = await this.app.syncModels({
+			const options = {
 				schemaPath: this.option("schema") ? resolve(String(this.option("schema"))) : void 0,
 				modelsDir: this.option("models") ? resolve(String(this.option("models"))) : void 0
-			});
+			};
+			result = this.option("registryOnly") || this.option("registry-only") || this.option("r") ? this.app.syncModelRegistry({ modelsDir: options.modelsDir }) : await this.app.syncModels(options);
 		} catch (error) {
 			this.error(`Error: ${error instanceof Error ? error.message : String(error)}`);
 			return;
@@ -4347,9 +4522,10 @@ var ModelsSyncCommand = class extends Command {
 		const updatedLines = result.updated.length === 0 ? [this.app.splitLogger("Updated", "none")] : result.updated.map((path) => this.app.splitLogger("Updated", path));
 		this.success("SUCCESS: Model sync completed with the following results:");
 		[
-			this.app.splitLogger("Source", result.source === "adapter" ? "adapter introspection" : "prisma schema"),
+			this.app.splitLogger("Source", result.source === "adapter" ? "adapter introspection" : result.source === "registry" ? "model registry" : "prisma schema"),
 			...result.schemaPath ? [this.app.splitLogger("Schema", result.schemaPath)] : [],
 			this.app.splitLogger("Models", result.modelsDir),
+			...result.modelTypesPath ? [this.app.splitLogger("Model Types", result.modelTypesPath)] : [],
 			this.app.splitLogger("Processed", String(result.total)),
 			...updatedLines,
 			this.app.splitLogger("Skipped", String(result.skipped.length))
@@ -4469,10 +4645,10 @@ var SeedCommand = class extends Command {
 	* @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);
+		return [this.app.resolveRuntimeDirectoryPath(configuredSeedersDir), ...getRegisteredPaths("seeders").map((directory) => this.app.resolveRuntimeDirectoryPath(directory))].filter((directory, index, all) => existsSync(directory) && all.indexOf(directory) === index);
 	}
 	async loadAllSeeders(seedersDirs) {
-		const files = seedersDirs.flatMap((seedersDir) => readdirSync$1(seedersDir).filter((file) => /\.(ts|js|mjs|cjs)$/i.test(file)).map((file) => this.app.resolveRuntimeScriptPath(join(seedersDir, file))));
+		const files = seedersDirs.flatMap((seedersDir) => readdirSync(seedersDir).filter((file) => /\.(ts|js|mjs|cjs)$/i.test(file)).map((file) => this.app.resolveRuntimeScriptPath(join(seedersDir, file))));
 		return [...(await Promise.all(files.map(async (file) => await this.loadSeederClassesFromFile(file)))).flat(), ...getRegisteredSeeders()];
 	}
 	/**
@@ -4495,7 +4671,7 @@ var SeedCommand = class extends Command {
 			`${base}Seeder.js`,
 			`${base}Seeder.mjs`,
 			`${base}Seeder.cjs`
-		].map((file) => join(seedersDir, file))).find((file) => existsSync$1(file));
+		].map((file) => join(seedersDir, file))).find((file) => existsSync(file));
 		if (!target) return [];
 		const runtimeTarget = this.app.resolveRuntimeScriptPath(target);
 		return await this.loadSeederClassesFromFile(runtimeTarget);
@@ -9664,115 +9840,50 @@ var Model = class Model {
 	isNotSame(model) {
 		return !this.isSame(model);
 	}
-	/**
-	* Define a has one relationship.
-	*
-	* @param related
-	* @param foreignKey
-	* @param localKey
-	* @returns
-	*/
 	hasOne(related, foreignKey, localKey) {
 		const constructor = this.constructor;
-		return new HasOneRelation(this, related, foreignKey, localKey ?? constructor.getPrimaryKey());
+		const relatedModel = this.resolveRelationshipModel(related, "hasOne");
+		const resolvedLocalKey = localKey ?? constructor.getPrimaryKey();
+		return new HasOneRelation(this, relatedModel, foreignKey ?? this.resolveDefaultHasForeignKey(constructor, resolvedLocalKey), resolvedLocalKey);
 	}
-	/**
-	* Define a has many relationship.
-	*
-	* @param related
-	* @param foreignKey
-	* @param localKey
-	* @returns
-	*/
 	hasMany(related, foreignKey, localKey) {
 		const constructor = this.constructor;
-		return new HasManyRelation(this, related, foreignKey, localKey ?? constructor.getPrimaryKey());
+		const relatedModel = this.resolveRelationshipModel(related, "hasMany");
+		const resolvedLocalKey = localKey ?? constructor.getPrimaryKey();
+		return new HasManyRelation(this, relatedModel, foreignKey ?? this.resolveDefaultHasForeignKey(constructor, resolvedLocalKey), resolvedLocalKey);
 	}
-	/**
-	* Define a belongs to relationship.
-	*
-	* @param related
-	* @param foreignKey
-	* @param ownerKey
-	* @returns
-	*/
 	belongsTo(related, foreignKey, ownerKey) {
-		return new BelongsToRelation(this, related, foreignKey, ownerKey ?? related.getPrimaryKey());
+		const relatedModel = this.resolveRelationshipModel(related, "belongsTo");
+		const resolvedOwnerKey = ownerKey ?? relatedModel.getPrimaryKey();
+		return new BelongsToRelation(this, relatedModel, foreignKey ?? this.resolveDefaultBelongsToForeignKey(relatedModel, resolvedOwnerKey), resolvedOwnerKey);
 	}
-	/**
-	* Define a belongs to many relationship.
-	*
-	* @param related
-	* @param throughTable
-	* @param foreignPivotKey
-	* @param relatedPivotKey
-	* @param parentKey
-	* @param relatedKey
-	* @returns
-	*/
 	belongsToMany(related, throughTable, foreignPivotKey, relatedPivotKey, parentKey, relatedKey) {
 		const constructor = this.constructor;
-		return new BelongsToManyRelation(this, related, throughTable, foreignPivotKey, relatedPivotKey, parentKey ?? constructor.getPrimaryKey(), relatedKey ?? related.getPrimaryKey());
+		const relatedModel = this.resolveRelationshipModel(related, "belongsToMany");
+		const resolvedRelatedKey = relatedKey ?? relatedModel.getPrimaryKey();
+		return new BelongsToManyRelation(this, relatedModel, throughTable, foreignPivotKey, relatedPivotKey, parentKey ?? constructor.getPrimaryKey(), resolvedRelatedKey);
 	}
-	/**
-	* Define a has one through relationship.
-	*
-	* @param related
-	* @param throughTable
-	* @param firstKey
-	* @param secondKey
-	* @param localKey
-	* @param secondLocalKey
-	* @returns
-	*/
-	hasOneThrough(related, throughTable, firstKey, secondKey, localKey, secondLocalKey = "id") {
+	hasOneThrough(related, throughTable, firstKey, secondKey, localKey, secondLocalKey) {
 		const constructor = this.constructor;
-		return new HasOneThroughRelation(this, related, throughTable, firstKey, secondKey, localKey ?? constructor.getPrimaryKey(), secondLocalKey);
+		const relatedModel = this.resolveRelationshipModel(related, "hasOneThrough");
+		return new HasOneThroughRelation(this, relatedModel, throughTable, firstKey, secondKey, localKey ?? constructor.getPrimaryKey(), secondLocalKey ?? "id");
 	}
-	/**
-	* Define a has many through relationship.
-	*
-	* @param related
-	* @param throughTable
-	* @param firstKey
-	* @param secondKey
-	* @param localKey
-	* @param secondLocalKey
-	* @returns
-	*/
 	hasManyThrough(related, throughTable, firstKey, secondKey, localKey, secondLocalKey = "id") {
 		const constructor = this.constructor;
-		return new HasManyThroughRelation(this, related, throughTable, firstKey, secondKey, localKey ?? constructor.getPrimaryKey(), secondLocalKey);
+		const relatedModel = this.resolveRelationshipModel(related, "hasManyThrough");
+		return new HasManyThroughRelation(this, relatedModel, throughTable, firstKey, secondKey, localKey ?? constructor.getPrimaryKey(), secondLocalKey);
 	}
-	/**
-	* Define a polymorphic one to one relationship.
-	*
-	* @param related
-	* @param morphName
-	* @param idColumn
-	* @param typeColumn
-	* @param localKey
-	* @returns
-	*/
 	morphOne(related, morphName, idColumn, typeColumn, localKey) {
 		const constructor = this.constructor;
+		const relatedModel = this.resolveRelationshipModel(related, "morphOne");
 		const columns = this.resolveMorphColumns(morphName, idColumn, typeColumn);
-		return new MorphOneRelation(this, related, morphName, columns.idColumn, columns.typeColumn, localKey ?? constructor.getPrimaryKey());
+		return new MorphOneRelation(this, relatedModel, morphName, columns.idColumn, columns.typeColumn, localKey ?? constructor.getPrimaryKey());
 	}
-	/**
-	* Define a polymorphic one to many relationship.
-	*
-	* @param related
-	* @param morphName
-	* @param idColumn
-	* @param typeColumn
-	* @param localKey
-	* @returns
-	*/
 	morphMany(related, morphName, idColumn, typeColumn, localKey) {
 		const constructor = this.constructor;
+		const relatedModel = this.resolveRelationshipModel(related, "morphMany");
 		const columns = this.resolveMorphColumns(morphName, idColumn, typeColumn);
-		return new MorphManyRelation(this, related, morphName, columns.idColumn, columns.typeColumn, localKey ?? constructor.getPrimaryKey());
+		return new MorphManyRelation(this, relatedModel, morphName, columns.idColumn, columns.typeColumn, localKey ?? constructor.getPrimaryKey());
 	}
 	morphTo(morphName, typeColumnOrRelated, idColumn, ownerKey) {
 		const related = typeof typeColumnOrRelated === "function" ? typeColumnOrRelated : void 0;
@@ -9780,51 +9891,37 @@ var Model = class Model {
 		const columns = this.resolveMorphColumns(morphName, idColumn, typeColumn);
 		return new MorphToRelation(this, morphName, columns.typeColumn, columns.idColumn, ownerKey, related);
 	}
-	/**
-	* Define a polymorphic many to many relationship.
-	*
-	* @param related
-	* @param morphName
-	* @param throughTable
-	* @param foreignPivotKey
-	* @param morphTypeColumn
-	* @param relatedPivotKey
-	* @param parentKey
-	* @param relatedKey
-	* @returns
-	*/
 	morphToMany(related, morphName, throughTable, foreignPivotKey, morphTypeColumn, relatedPivotKey, parentKey, relatedKey) {
 		const constructor = this.constructor;
 		const namingCase = Model.getNamingCase();
-		const resolvedRelatedKey = relatedKey ?? related.getPrimaryKey();
+		const relatedModel = this.resolveRelationshipModel(related, "morphToMany");
+		const resolvedRelatedKey = relatedKey ?? relatedModel.getPrimaryKey();
 		const resolvedTable = throughTable ?? this.formatConventionName(`${str(morphName).plural()}`, namingCase);
-		const resolvedRelatedPivotKey = relatedPivotKey ?? this.formatConventionName(`${str(related.getTable()).singular()}_${resolvedRelatedKey}`, namingCase);
+		const resolvedRelatedPivotKey = relatedPivotKey ?? this.formatConventionName(`${str(relatedModel.getTable()).singular()}_${resolvedRelatedKey}`, namingCase);
 		const morphIdColumn = foreignPivotKey ?? this.formatConventionName(`${morphName}_id`, namingCase);
 		const resolvedMorphTypeColumn = morphTypeColumn ?? this.formatConventionName(`${morphName}_type`, namingCase);
-		return new MorphToManyRelation(this, related, resolvedTable, morphName, morphIdColumn, resolvedMorphTypeColumn, resolvedRelatedPivotKey, parentKey ?? constructor.getPrimaryKey(), resolvedRelatedKey);
+		return new MorphToManyRelation(this, relatedModel, resolvedTable, morphName, morphIdColumn, resolvedMorphTypeColumn, resolvedRelatedPivotKey, parentKey ?? constructor.getPrimaryKey(), resolvedRelatedKey);
 	}
-	/**
-	* Define the inverse side of a polymorphic many-to-many relationship.
-	*
-	* @param related
-	* @param morphName
-	* @param throughTable
-	* @param foreignPivotKey
-	* @param morphTypeColumn
-	* @param relatedPivotKey
-	* @param parentKey
-	* @param relatedKey
-	* @returns
-	*/
 	morphedByMany(related, morphName, throughTable, foreignPivotKey, morphTypeColumn, relatedPivotKey, parentKey, relatedKey) {
 		const constructor = this.constructor;
 		const namingCase = Model.getNamingCase();
-		const resolvedRelatedKey = relatedKey ?? related.getPrimaryKey();
+		const relatedModel = this.resolveRelationshipModel(related, "morphedByMany");
+		const resolvedRelatedKey = relatedKey ?? relatedModel.getPrimaryKey();
 		const resolvedTable = throughTable ?? this.formatConventionName(`${str(morphName).plural()}`, namingCase);
 		const resolvedForeignPivotKey = foreignPivotKey ?? this.formatConventionName(`${str(constructor.getTable()).singular()}_${parentKey ?? constructor.getPrimaryKey()}`, namingCase);
 		const resolvedMorphTypeColumn = morphTypeColumn ?? this.formatConventionName(`${morphName}_type`, namingCase);
 		const resolvedRelatedPivotKey = relatedPivotKey ?? this.formatConventionName(`${morphName}_id`, namingCase);
-		return new MorphedByManyRelation(this, related, resolvedTable, morphName, resolvedForeignPivotKey, resolvedMorphTypeColumn, resolvedRelatedPivotKey, parentKey ?? constructor.getPrimaryKey(), resolvedRelatedKey);
+		return new MorphedByManyRelation(this, relatedModel, resolvedTable, morphName, resolvedForeignPivotKey, resolvedMorphTypeColumn, resolvedRelatedPivotKey, parentKey ?? constructor.getPrimaryKey(), resolvedRelatedKey);
+	}
+	resolveRelationshipModel(related, operation) {
+		if (typeof related === "function") return related;
+		return resolveRegisteredModel(related, { operation });
+	}
+	resolveDefaultHasForeignKey(parent, localKey) {
+		return this.formatConventionName(`${str(parent.getTable()).singular()}_${localKey}`, Model.getNamingCase());
+	}
+	resolveDefaultBelongsToForeignKey(related, ownerKey) {
+		return this.formatConventionName(`${str(related.getTable()).singular()}_${ownerKey}`, Model.getNamingCase());
 	}
 	resolveMorphColumns(morphName, idColumn, typeColumn) {
 		const namingCase = Model.getNamingCase();
@@ -10774,4 +10871,4 @@ var PivotModel = class extends Model {
 };
 
 //#endregion
-export { AggregateExpression, Arkorm, ArkormCollection, ArkormException, Arkormx, Attribute, CaseExpression, CliApp, DB, DbCommand, EnumBuilder, Expression, ForeignKeyBuilder, InitCommand, InlineFactory, JoinClause, JsonExpression, KyselyDatabaseAdapter, LengthAwarePaginator, MIGRATION_BRAND, MakeFactoryCommand, MakeMigrationCommand, MakeModelCommand, MakeSeederCommand, MigrateCommand, MigrateFreshCommand, MigrateRollbackCommand, Migration, MigrationHistoryCommand, MissingDelegateException, Model, ModelFactory, ModelNotFoundException, ModelsSyncCommand, PRISMA_ENUM_MEMBER_REGEX, PRISMA_ENUM_REGEX, PRISMA_MODEL_REGEX, Paginator, PivotModel, PrimaryKeyGenerationPlanner, PrismaDatabaseAdapter, QueryBuilder, QueryConstraintException, QueryExecutionException, RelationResolutionException, RuntimeModuleLoader, SEEDER_BRAND, SchemaBuilder, ScopeNotDefinedException, SeedCommand, Seeder, TableBuilder, URLDriver, UniqueConstraintResolutionException, UnsupportedAdapterFeatureException, applyAlterTableOperation, applyCreateTableOperation, applyDropTableOperation, applyMigrationRollbackToDatabase, applyMigrationRollbackToPrismaSchema, applyMigrationToDatabase, applyMigrationToPrismaSchema, applyOperationsToPersistedColumnMappingsState, applyOperationsToPrismaSchema, avg, awaitConfiguredModelsRegistration, bindAdapterToModels, buildEnumBlock, buildFieldLine, buildIndexLine, buildInverseRelationLine, buildMigrationIdentity, buildMigrationRunId, buildMigrationSource, buildModelBlock, buildPrimaryKeyLine, buildRelationLine, buildUniqueConstraintLine, caseWhen, coalesce, col, computeMigrationChecksum, configureArkormRuntime, count, createEmptyAppliedMigrationsState, createEmptyPersistedColumnMappingsState, createKyselyAdapter, createMigrationTimestamp, createPrismaAdapter, createPrismaCompatibilityAdapter, createPrismaDatabaseAdapter, createPrismaDelegateMap, defineConfig, defineFactory, deleteAppliedMigrationsStateFromStore, deletePersistedColumnMappingsState, deriveCollectionFieldName, deriveInverseRelationAlias, deriveRelationAlias, deriveRelationFieldName, deriveSingularFieldName, disposeArkormRuntime, emitRuntimeDebugEvent, ensureArkormConfigLoading, escapeRegex, expressionBuilder, findAppliedMigration, findEnumBlock, findModelBlock, fn, formatDefaultValue, formatEnumDefaultValue, formatRelationAction, fromExpressionNode, generateMigrationFile, getActiveTransactionAdapter, getActiveTransactionClient, getDefaultStubsPath, getLastBatchMigrations, getLastMigrationRun, getLatestAppliedMigrations, getMigrationPlan, getPersistedColumnMap, getPersistedEnumMap, getPersistedEnumTsType, getPersistedPrimaryKeyGeneration, getPersistedTableMetadata, getPersistedTimestampColumns, getRegisteredFactories, getRegisteredMigrations, getRegisteredModels, getRegisteredPaths, getRegisteredSeeders, getRuntimeAdapter, getRuntimeClient, getRuntimeCompatibilityAdapter, getRuntimeDebugHandler, getRuntimePaginationCurrentPageResolver, getRuntimePaginationURLDriverFactory, getRuntimePrismaClient, getUserConfig, inferDelegateName, isDelegateLike, isMigrationApplied, isMigrationPlanningActive, isQuerySchemaLike, isTransactionCapableClient, json, loadArkormConfig, loadFactoriesFrom, loadMigrationsFrom, loadModelsFrom, loadSeedersFrom, markMigrationApplied, markMigrationRun, max, min, pad, raw, readAppliedMigrationsState, readAppliedMigrationsStateFromStore, readPersistedColumnMappingsState, rebuildPersistedColumnMappingsState, registerFactories, registerMigrations, registerModels, registerPaths, registerSeeders, removeAppliedMigration, resetArkormRuntimeForTests, resetPersistedColumnMappingsCache, resetRuntimeRegistryForTests, resolveCast, resolveColumnMappingsFilePath, resolveEnumName, resolveGeneratedExpression, resolveMigrationClassName, resolveMigrationStateFilePath, resolvePersistedMetadataFeatures, resolvePrismaType, resolveRuntimeCompatibilityQuerySchema, resolveRuntimeCompatibilityQuerySchemaOrThrow, runArkormTransaction, runInMigrationPlanning, runMigrationWithPrisma, runPrismaCommand, stripPrismaSchemaModelsAndEnums, sum, supportsDatabaseCreation, supportsDatabaseMigrationExecution, supportsDatabaseMigrationState, supportsDatabaseReset, syncPersistedColumnMappingsFromState, toMigrationFileSlug, toModelName, val, validatePersistedMetadataFeaturesForMigrations, where, writeAppliedMigrationsState, writeAppliedMigrationsStateToStore, writePersistedColumnMappingsState };
+export { AggregateExpression, Arkorm, ArkormCollection, ArkormException, Arkormx, Attribute, CaseExpression, CliApp, DB, DbCommand, EnumBuilder, Expression, ForeignKeyBuilder, InitCommand, InlineFactory, JoinClause, JsonExpression, KyselyDatabaseAdapter, LengthAwarePaginator, MIGRATION_BRAND, MakeFactoryCommand, MakeMigrationCommand, MakeModelCommand, MakeSeederCommand, MigrateCommand, MigrateFreshCommand, MigrateRollbackCommand, Migration, MigrationHistoryCommand, MissingDelegateException, Model, ModelFactory, ModelNotFoundException, ModelsSyncCommand, PRISMA_ENUM_MEMBER_REGEX, PRISMA_ENUM_REGEX, PRISMA_MODEL_REGEX, Paginator, PivotModel, PrimaryKeyGenerationPlanner, PrismaDatabaseAdapter, QueryBuilder, QueryConstraintException, QueryExecutionException, RelationResolutionException, RuntimeModuleLoader, SEEDER_BRAND, SchemaBuilder, ScopeNotDefinedException, SeedCommand, Seeder, TableBuilder, URLDriver, UniqueConstraintResolutionException, UnsupportedAdapterFeatureException, applyAlterTableOperation, applyCreateTableOperation, applyDropTableOperation, applyMigrationRollbackToDatabase, applyMigrationRollbackToPrismaSchema, applyMigrationToDatabase, applyMigrationToPrismaSchema, applyOperationsToPersistedColumnMappingsState, applyOperationsToPrismaSchema, avg, awaitConfiguredModelsRegistration, bindAdapterToModels, buildEnumBlock, buildFieldLine, buildIndexLine, buildInverseRelationLine, buildMigrationIdentity, buildMigrationRunId, buildMigrationSource, buildModelBlock, buildPrimaryKeyLine, buildRelationLine, buildUniqueConstraintLine, caseWhen, coalesce, col, computeMigrationChecksum, configureArkormRuntime, count, createEmptyAppliedMigrationsState, createEmptyPersistedColumnMappingsState, createKyselyAdapter, createMigrationTimestamp, createPrismaAdapter, createPrismaCompatibilityAdapter, createPrismaDatabaseAdapter, createPrismaDelegateMap, defineConfig, defineFactory, deleteAppliedMigrationsStateFromStore, deletePersistedColumnMappingsState, deriveCollectionFieldName, deriveInverseRelationAlias, deriveRelationAlias, deriveRelationFieldName, deriveSingularFieldName, disposeArkormRuntime, emitRuntimeDebugEvent, ensureArkormConfigLoading, escapeRegex, expressionBuilder, findAppliedMigration, findEnumBlock, findModelBlock, fn, formatDefaultValue, formatEnumDefaultValue, formatRelationAction, fromExpressionNode, generateMigrationFile, getActiveTransactionAdapter, getActiveTransactionClient, getDefaultStubsPath, getLastBatchMigrations, getLastMigrationRun, getLatestAppliedMigrations, getMigrationPlan, getModel, getPersistedColumnMap, getPersistedEnumMap, getPersistedEnumTsType, getPersistedPrimaryKeyGeneration, getPersistedTableMetadata, getPersistedTimestampColumns, getRegisteredFactories, getRegisteredMigrations, getRegisteredModels, getRegisteredPaths, getRegisteredSeeders, getRuntimeAdapter, getRuntimeClient, getRuntimeCompatibilityAdapter, getRuntimeDebugHandler, getRuntimePaginationCurrentPageResolver, getRuntimePaginationURLDriverFactory, getRuntimePrismaClient, getUserConfig, inferDelegateName, isDelegateLike, isMigrationApplied, isQuerySchemaLike, isTransactionCapableClient, json, loadArkormConfig, loadFactoriesFrom, loadMigrationsFrom, loadModelsFrom, loadSeedersFrom, markMigrationApplied, markMigrationRun, max, min, pad, raw, readAppliedMigrationsState, readAppliedMigrationsStateFromStore, readPersistedColumnMappingsState, rebuildPersistedColumnMappingsState, registerFactories, registerMigrations, registerModels, registerPaths, registerSeeders, removeAppliedMigration, resetArkormRuntimeForTests, resetPersistedColumnMappingsCache, resetRuntimeRegistryForTests, resolveCast, resolveColumnMappingsFilePath, resolveEnumName, resolveGeneratedExpression, resolveMigrationClassName, resolveMigrationStateFilePath, resolvePersistedMetadataFeatures, resolvePrismaType, resolveRegisteredModel, resolveRuntimeCompatibilityQuerySchema, resolveRuntimeCompatibilityQuerySchemaOrThrow, runArkormTransaction, runMigrationWithPrisma, runPrismaCommand, stripPrismaSchemaModelsAndEnums, sum, supportsDatabaseCreation, supportsDatabaseMigrationExecution, supportsDatabaseMigrationState, supportsDatabaseReset, syncPersistedColumnMappingsFromState, toMigrationFileSlug, toModelName, val, validatePersistedMetadataFeaturesForMigrations, where, writeAppliedMigrationsState, writeAppliedMigrationsStateToStore, writePersistedColumnMappingsState };