arkormx 2.0.0-next.25 → 2.0.0-next.27

package/dist/cli.mjs

@@ -1,16 +1,16 @@
 #!/usr/bin/env node
 import { AsyncLocalStorage } from "async_hooks";
-import { dirname, extname, join, resolve } from "node:path";
-import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
-import { createHash, randomUUID } from "node:crypto";
-import { spawnSync } from "node:child_process";
-import { str } from "@h3ravel/support";
 import { createJiti } from "@rexxars/jiti";
 import { pathToFileURL } from "node:url";
+import { dirname, extname, join, resolve } from "node:path";
 import { createRequire } from "module";
-import { copyFileSync, existsSync as existsSync$1, mkdirSync as mkdirSync$1, readFileSync as readFileSync$1, readdirSync as readdirSync$1, rmSync as rmSync$1, writeFileSync as writeFileSync$1 } from "fs";
+import { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "fs";
 import { fileURLToPath } from "url";
 import path, { dirname as dirname$1, extname as extname$1, join as join$1, relative } from "path";
+import { existsSync as existsSync$1, mkdirSync as mkdirSync$1, readFileSync as readFileSync$1, readdirSync as readdirSync$1, rmSync as rmSync$1, writeFileSync as writeFileSync$1 } from "node:fs";
+import { createHash, randomUUID } from "node:crypto";
+import { spawnSync } from "node:child_process";
+import { str } from "@h3ravel/support";
 import { Logger } from "@h3ravel/shared";
 import { Command, Kernel } from "@h3ravel/musket";
 
@@ -100,6 +100,18 @@ var UnsupportedAdapterFeatureException = class extends ArkormException {
 	}
 };
 
+//#endregion
+//#region src/helpers/runtime-module-loader.ts
+var RuntimeModuleLoader = class {
+	static async load(filePath) {
+		const resolvedPath = resolve(filePath);
+		return await createJiti(pathToFileURL(resolvedPath).href, {
+			interopDefault: false,
+			tsconfigPaths: true
+		}).import(resolvedPath);
+	}
+};
+
 //#endregion
 //#region src/helpers/migration-history.ts
 const createEmptyAppliedMigrationsState = () => ({
@@ -119,13 +131,13 @@ const buildMigrationIdentity = (filePath, className) => {
 	return `${fileName.slice(0, fileName.length - extname(fileName).length)}:${className}`;
 };
 const computeMigrationChecksum = (filePath) => {
-	const source = readFileSync(filePath, "utf-8");
+	const source = readFileSync$1(filePath, "utf-8");
 	return createHash("sha256").update(source).digest("hex");
 };
 const readAppliedMigrationsState = (stateFilePath) => {
-	if (!existsSync(stateFilePath)) return createEmptyAppliedMigrationsState();
+	if (!existsSync$1(stateFilePath)) return createEmptyAppliedMigrationsState();
 	try {
-		const parsed = JSON.parse(readFileSync(stateFilePath, "utf-8"));
+		const parsed = JSON.parse(readFileSync$1(stateFilePath, "utf-8"));
 		if (!Array.isArray(parsed.migrations)) return createEmptyAppliedMigrationsState();
 		return {
 			version: 1,
@@ -146,8 +158,8 @@ const readAppliedMigrationsStateFromStore = async (adapter, stateFilePath) => {
 };
 const writeAppliedMigrationsState = (stateFilePath, state) => {
 	const directory = dirname(stateFilePath);
-	if (!existsSync(directory)) mkdirSync(directory, { recursive: true });
-	writeFileSync(stateFilePath, JSON.stringify(state, null, 2));
+	if (!existsSync$1(directory)) mkdirSync$1(directory, { recursive: true });
+	writeFileSync$1(stateFilePath, JSON.stringify(state, null, 2));
 };
 const writeAppliedMigrationsStateToStore = async (adapter, stateFilePath, state) => {
 	if (supportsDatabaseMigrationState(adapter)) {
@@ -1532,9 +1544,9 @@ const generateMigrationFile = (name, options = {}) => {
 	const filePath = join(directory, fileName);
 	const content = buildMigrationSource(className, extension);
 	if (options.write ?? true) {
-		if (!existsSync(directory)) mkdirSync(directory, { recursive: true });
-		if (existsSync(filePath)) throw new ArkormException(`Migration file already exists: ${filePath}`);
-		writeFileSync(filePath, content);
+		if (!existsSync$1(directory)) mkdirSync$1(directory, { recursive: true });
+		if (existsSync$1(filePath)) throw new ArkormException(`Migration file already exists: ${filePath}`);
+		writeFileSync$1(filePath, content);
 	}
 	return {
 		fileName,
@@ -1590,11 +1602,11 @@ const applyMigrationRollbackToDatabase = async (adapter, migration) => {
 */
 const applyMigrationToPrismaSchema = async (migration, options = {}) => {
 	const schemaPath = options.schemaPath ?? join(process.cwd(), "prisma", "schema.prisma");
-	if (!existsSync(schemaPath)) throw new ArkormException(`Prisma schema file not found: ${schemaPath}`);
-	const source = readFileSync(schemaPath, "utf-8");
+	if (!existsSync$1(schemaPath)) throw new ArkormException(`Prisma schema file not found: ${schemaPath}`);
+	const source = readFileSync$1(schemaPath, "utf-8");
 	const operations = await getMigrationPlan(migration, "up");
 	const schema = applyOperationsToPrismaSchema(source, operations);
-	if (options.write ?? true) writeFileSync(schemaPath, schema);
+	if (options.write ?? true) writeFileSync$1(schemaPath, schema);
 	return {
 		schema,
 		schemaPath,
@@ -1610,11 +1622,11 @@ const applyMigrationToPrismaSchema = async (migration, options = {}) => {
 */
 const applyMigrationRollbackToPrismaSchema = async (migration, options = {}) => {
 	const schemaPath = options.schemaPath ?? join(process.cwd(), "prisma", "schema.prisma");
-	if (!existsSync(schemaPath)) throw new ArkormException(`Prisma schema file not found: ${schemaPath}`);
-	const source = readFileSync(schemaPath, "utf-8");
+	if (!existsSync$1(schemaPath)) throw new ArkormException(`Prisma schema file not found: ${schemaPath}`);
+	const source = readFileSync$1(schemaPath, "utf-8");
 	const operations = await getMigrationPlan(migration, "down");
 	const schema = applyOperationsToPrismaSchema(source, operations);
-	if (options.write ?? true) writeFileSync(schemaPath, schema);
+	if (options.write ?? true) writeFileSync$1(schemaPath, schema);
 	return {
 		schema,
 		schemaPath,
@@ -1737,14 +1749,14 @@ const resetPersistedColumnMappingsCache = () => {
 };
 const readPersistedColumnMappingsState = (filePath) => {
 	if (cachedColumnMappingsPath === filePath && cachedColumnMappingsState) return cachedColumnMappingsState;
-	if (!existsSync(filePath)) {
+	if (!existsSync$1(filePath)) {
 		const empty = createEmptyPersistedColumnMappingsState();
 		cachedColumnMappingsPath = filePath;
 		cachedColumnMappingsState = empty;
 		return empty;
 	}
 	try {
-		const normalized = normalizePersistedColumnMappingsState(JSON.parse(readFileSync(filePath, "utf-8")));
+		const normalized = normalizePersistedColumnMappingsState(JSON.parse(readFileSync$1(filePath, "utf-8")));
 		cachedColumnMappingsPath = filePath;
 		cachedColumnMappingsState = normalized;
 		return normalized;
@@ -1758,13 +1770,13 @@ const readPersistedColumnMappingsState = (filePath) => {
 const writePersistedColumnMappingsState = (filePath, state) => {
 	const normalized = normalizePersistedColumnMappingsState(state);
 	const directory = dirname(filePath);
-	if (!existsSync(directory)) mkdirSync(directory, { recursive: true });
-	writeFileSync(filePath, JSON.stringify(normalized, null, 2));
+	if (!existsSync$1(directory)) mkdirSync$1(directory, { recursive: true });
+	writeFileSync$1(filePath, JSON.stringify(normalized, null, 2));
 	cachedColumnMappingsPath = filePath;
 	cachedColumnMappingsState = normalized;
 };
 const deletePersistedColumnMappingsState = (filePath) => {
-	if (existsSync(filePath)) rmSync(filePath, { force: true });
+	if (existsSync$1(filePath)) rmSync$1(filePath, { force: true });
 	resetPersistedColumnMappingsCache();
 };
 const getPersistedTableMetadata = (table, options = {}) => {
@@ -1937,18 +1949,6 @@ const getPersistedEnumTsType = (values) => {
 	return buildEnumUnionType(values);
 };
 
-//#endregion
-//#region src/helpers/runtime-module-loader.ts
-var RuntimeModuleLoader = class {
-	static async load(filePath) {
-		const resolvedPath = resolve(filePath);
-		return await createJiti(pathToFileURL(resolvedPath).href, {
-			interopDefault: false,
-			tsconfigPaths: true
-		}).import(resolvedPath);
-	}
-};
-
 //#endregion
 //#region src/helpers/runtime-config.ts
 const resolveDefaultStubsPath = () => {
@@ -1956,7 +1956,7 @@ const resolveDefaultStubsPath = () => {
 	while (true) {
 		const packageJsonPath = path.join(current, "package.json");
 		const stubsPath = path.join(current, "stubs");
-		if (existsSync$1(packageJsonPath) && existsSync$1(stubsPath)) return stubsPath;
+		if (existsSync(packageJsonPath) && existsSync(stubsPath)) return stubsPath;
 		const parent = path.dirname(current);
 		if (parent === current) break;
 		current = parent;
@@ -1991,6 +1991,7 @@ let runtimePaginationURLDriverFactory;
 let runtimePaginationCurrentPageResolver;
 let runtimeDebugHandler;
 const transactionClientStorage = new AsyncLocalStorage();
+const transactionAdapterStorage = new AsyncLocalStorage();
 const defaultDebugHandler = (event) => {
 	const prefix = `[arkorm:${event.adapter}] ${event.operation}${event.target ? ` [${event.target}]` : ""}`;
 	const payload = {
@@ -2023,6 +2024,12 @@ const mergePathConfig = (paths) => {
 		...incoming
 	};
 };
+/**
+* Merge the feature configuration from the base defaults, user configuration, and provided options.
+* 
+* @param features 
+* @returns 
+*/
 const mergeFeatureConfig = (features) => {
 	const defaults = baseConfig.features ?? {};
 	const current = userConfig.features ?? {};
@@ -2032,6 +2039,13 @@ const mergeFeatureConfig = (features) => {
 		...features ?? {}
 	};
 };
+/**
+* Bind a database adapter instance to an array of models that support adapter binding.
+* 
+* @param adapter 
+* @param models 
+* @returns 
+*/
 const bindAdapterToModels = (adapter, models) => {
 	models.forEach((model) => {
 		model.setAdapter(adapter);
@@ -2041,6 +2055,7 @@ const bindAdapterToModels = (adapter, models) => {
 /**
 * Get the user-provided ArkORM configuration. 
 * 
+* @param key Optional specific configuration key to retrieve. If omitted, the entire configuration object is returned.
 * @returns The user-provided ArkORM configuration object.  
 */
 const getUserConfig = (key) => {
@@ -2048,37 +2063,41 @@ const getUserConfig = (key) => {
 	return userConfig;
 };
 /**
-* Configure the ArkORM runtime with the provided Prisma client resolver and 
-* delegate mapping resolver.
+* Configure the ArkORM runtime with the provided runtime client resolver and
+* adapter-first options.
 * 
-* @param prisma 
-* @param mapping 
+* @param client 
+* @param options
 */
-const configureArkormRuntime = (prisma, options = {}) => {
+const configureArkormRuntime = (client, options = {}) => {
+	const resolvedClient = client ?? options.client;
 	const nextConfig = {
 		...userConfig,
 		features: mergeFeatureConfig(options.features),
 		paths: mergePathConfig(options.paths)
 	};
-	nextConfig.prisma = prisma;
+	nextConfig.client = resolvedClient;
+	nextConfig.prisma = resolvedClient;
 	if (options.pagination !== void 0) nextConfig.pagination = options.pagination;
 	if (options.adapter !== void 0) nextConfig.adapter = options.adapter;
 	if (options.boot !== void 0) nextConfig.boot = options.boot;
 	if (options.debug !== void 0) nextConfig.debug = options.debug;
 	if (options.outputExt !== void 0) nextConfig.outputExt = options.outputExt;
 	Object.assign(userConfig, { ...nextConfig });
-	runtimeClientResolver = prisma;
+	runtimeClientResolver = resolvedClient;
 	runtimeAdapter = options.adapter;
 	runtimePaginationURLDriverFactory = nextConfig.pagination?.urlDriver;
 	runtimePaginationCurrentPageResolver = nextConfig.pagination?.resolveCurrentPage;
 	runtimeDebugHandler = resolveDebugHandler(nextConfig.debug);
+	const bootClient = resolveClient(resolvedClient);
 	options.boot?.({
-		prisma: resolveClient(prisma),
+		client: bootClient,
+		prisma: bootClient,
 		bindAdapter: bindAdapterToModels
 	});
 };
 /**
-* Resolve a Prisma client instance from the provided resolver, which can be either
+* Resolve a runtime client instance from the provided resolver, which can be either
 * a direct client instance or a function that returns a client instance.
 * 
 * @param resolver 
@@ -2101,7 +2120,9 @@ const resolveClient = (resolver) => {
 const resolveAndApplyConfig = (imported) => {
 	const config = imported?.default ?? imported;
 	if (!config || typeof config !== "object") return;
-	configureArkormRuntime(config.prisma, {
+	const runtimeClient = config.client ?? config.prisma;
+	configureArkormRuntime(runtimeClient, {
+		client: runtimeClient,
 		adapter: config.adapter,
 		boot: config.boot,
 		debug: config.debug,
@@ -2126,7 +2147,7 @@ const loadRuntimeConfigSync = () => {
 	const require = createRequire(import.meta.url);
 	const syncConfigPaths = [path.join(process.cwd(), "arkormx.config.cjs")];
 	for (const configPath of syncConfigPaths) {
-		if (!existsSync$1(configPath)) continue;
+		if (!existsSync(configPath)) continue;
 		try {
 			resolveAndApplyConfig(require(configPath));
 			return true;
@@ -2148,7 +2169,7 @@ const loadArkormConfig = async () => {
 	runtimeConfigLoadingPromise = (async () => {
 		const configPaths = [path.join(process.cwd(), "arkormx.config.js"), path.join(process.cwd(), "arkormx.config.ts")];
 		for (const configPath of configPaths) {
-			if (!existsSync$1(configPath)) continue;
+			if (!existsSync(configPath)) continue;
 			try {
 				resolveAndApplyConfig(await importConfigFile(configPath));
 				return;
@@ -2171,13 +2192,13 @@ const emitRuntimeDebugEvent = (event) => {
 	getRuntimeDebugHandler()?.(event);
 };
 /**
-* Check if a given value is a Prisma delegate-like object 
+* Check if a given value matches Arkorm's query-schema contract
 * by verifying the presence of common delegate methods.
 * 
 * @param value The value to check.
-* @returns True if the value is a Prisma delegate-like object, false otherwise.    
+* @returns True if the value matches the query-schema contract, false otherwise.
 */
-const isDelegateLike = (value) => {
+const isQuerySchemaLike = (value) => {
 	if (!value || typeof value !== "object") return false;
 	const candidate = value;
 	return [
@@ -2189,6 +2210,10 @@ const isDelegateLike = (value) => {
 		"count"
 	].every((method) => typeof candidate[method] === "function");
 };
+/**
+* @deprecated Use isQuerySchemaLike instead.
+*/
+const isDelegateLike = isQuerySchemaLike;
 loadArkormConfig();
 
 //#endregion
@@ -2308,7 +2333,7 @@ var PrismaDatabaseAdapter = class PrismaDatabaseAdapter {
 			if (!nested) return void 0;
 			return { NOT: nested };
 		}
-		throw new UnsupportedAdapterFeatureException("Raw where clauses are not supported by the Prisma compatibility adapter.", {
+		throw new UnsupportedAdapterFeatureException("Raw where clauses are not supported by the Prisma compatibility adapter; use a SQL-backed adapter for raw SQL predicates.", {
 			operation: "adapter.where",
 			meta: {
 				feature: "rawWhere",
@@ -2442,9 +2467,10 @@ var PrismaDatabaseAdapter = class PrismaDatabaseAdapter {
 		});
 	}
 	/**
-	* @todo Implement relationLoads by performing separate queries and merging results 
-	* in-memory, since Prisma does not support nested reads with constraints, ordering, or
-	* pagination on related models as of now.
+	* Prisma can translate relation load plans on direct select/selectOne calls into
+	* Prisma include/select arguments, but the adapter does not advertise the
+	* adapter-owned batch relation load seam. QueryBuilder eager loads therefore stay
+	* on Arkorm's generic relation loader on the Prisma compatibility path.
 	* 
 	* @param spec 
 	* @returns 
@@ -2626,7 +2652,7 @@ var PrismaDatabaseAdapter = class PrismaDatabaseAdapter {
 	* @param _spec 
 	*/
 	async loadRelations(_spec) {
-		throw new UnsupportedAdapterFeatureException("Relation batch loading is not supported by the Prisma compatibility adapter yet.", {
+		throw new UnsupportedAdapterFeatureException("Adapter-owned relation batch loading is intentionally unavailable on the Prisma compatibility adapter; eager loading stays on Arkorm's generic loader for this path.", {
 			operation: "adapter.loadRelations",
 			meta: { feature: "relationLoads" }
 		});
@@ -2685,7 +2711,7 @@ var CliApp = class {
 	*/
 	ensureDirectory(filePath) {
 		const dir = dirname$1(filePath);
-		if (!existsSync$1(dir)) mkdirSync$1(dir, { recursive: true });
+		if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
 	}
 	/**
 	* Convert absolute paths under current working directory into relative display paths.
@@ -2734,13 +2760,13 @@ var CliApp = class {
 	* @returns
 	*/
 	resolveRuntimeDirectoryPath(directoryPath) {
-		if (existsSync$1(directoryPath)) return directoryPath;
+		if (existsSync(directoryPath)) return directoryPath;
 		const { buildOutput } = this.getConfig("paths") || {};
 		if (typeof buildOutput !== "string" || buildOutput.trim().length === 0) return directoryPath;
 		const relativeSource = relative(process.cwd(), directoryPath);
 		if (!relativeSource || relativeSource.startsWith("..")) return directoryPath;
 		const mappedDirectory = join$1(buildOutput, relativeSource);
-		return existsSync$1(mappedDirectory) ? mappedDirectory : directoryPath;
+		return existsSync(mappedDirectory) ? mappedDirectory : directoryPath;
 	}
 	/**
 	* Resolve a script file path for runtime execution.
@@ -2770,7 +2796,7 @@ var CliApp = class {
 				} else candidates.push(mappedFile);
 			}
 		}
-		const runtimeMatch = candidates.find((path) => existsSync$1(path));
+		const runtimeMatch = candidates.find((path) => existsSync(path));
 		if (runtimeMatch) return runtimeMatch;
 		return filePath;
 	}
@@ -2782,14 +2808,14 @@ var CliApp = class {
 	* @param replacements
 	*/
 	generateFile(stubPath, outputPath, replacements, options) {
-		if (existsSync$1(outputPath) && !options?.force) {
+		if (existsSync(outputPath) && !options?.force) {
 			this.command.error(`Error: ${this.formatPathForLog(outputPath)} already exists.`);
 			process.exit(1);
-		} else if (existsSync$1(outputPath) && options?.force) rmSync$1(outputPath);
-		let content = readFileSync$1(stubPath, "utf-8");
+		} else if (existsSync(outputPath) && options?.force) rmSync(outputPath);
+		let content = readFileSync(stubPath, "utf-8");
 		for (const [key, value] of Object.entries(replacements)) content = content.replace(new RegExp(`{{${key}}}`, "g"), value);
 		this.ensureDirectory(outputPath);
-		writeFileSync$1(outputPath, content);
+		writeFileSync(outputPath, content);
 		return outputPath;
 	}
 	/**
@@ -2881,7 +2907,7 @@ var CliApp = class {
 	makeModel(name, options = {}) {
 		const baseName = str(name.replace(/Model$/, "")).pascal().toString();
 		const modelName = `${baseName}`;
-		const delegateName = str(baseName).camel().plural().toString();
+		const tableName = str(baseName).camel().plural().toString();
 		const outputExt = this.resolveOutputExt();
 		const outputPath = join$1(this.resolveConfigPath("models", join$1(process.cwd(), "src", "models")), `${modelName}.${outputExt}`);
 		const shouldBuildFactory = options.all || options.factory;
@@ -2895,11 +2921,11 @@ var CliApp = class {
 		else stubPath = this.resolveStubPath(outputExt === "js" ? "model.js.stub" : "model.stub");
 		const modelPath = this.generateFile(stubPath, outputPath, {
 			ModelName: modelName,
-			DelegateName: delegateName,
+			TableName: tableName,
 			FactoryImport: shouldBuildFactory ? `import { ${factoryName} } from '${factoryImportPath}'\n` : "",
 			FactoryLink: shouldBuildFactory ? outputExt === "js" ? `\n    static factoryClass = ${factoryName}` : `\n    protected static override factoryClass = ${factoryName}` : ""
 		}, options);
-		const prisma = this.isUsingPrismaAdapter() ? this.ensurePrismaModelEntry(modelName, delegateName) : void 0;
+		const prisma = this.isUsingPrismaAdapter() ? this.ensurePrismaModelEntry(modelName, tableName) : void 0;
 		const created = {
 			model: {
 				name: modelName,
@@ -2916,30 +2942,30 @@ var CliApp = class {
 			modelImportPath: `./${relative(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 ${delegateName} table`);
+		if (shouldBuildMigration) created.migration = this.makeMigration(`create ${tableName} table`);
 		return created;
 	}
 	/**
 	* Ensure that the Prisma schema has a model entry for the given model 
-	* and delegate names.
+	* and table names.
 	* If the entry does not exist, it will be created with a default `id` field.
 	* 
 	* @param modelName The name of the model to ensure in the Prisma schema.
-	* @param delegateName The name of the delegate (table) to ensure in the Prisma schema.
+	* @param tableName The table name to ensure in the Prisma schema.
 	*/
-	ensurePrismaModelEntry(modelName, delegateName) {
+	ensurePrismaModelEntry(modelName, tableName) {
 		const schemaPath = join$1(process.cwd(), "prisma", "schema.prisma");
-		if (!existsSync$1(schemaPath)) return void 0;
-		const source = readFileSync$1(schemaPath, "utf-8");
-		const existingByTable = findModelBlock(source, delegateName);
+		if (!existsSync(schemaPath)) return void 0;
+		const source = readFileSync(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$1(schemaPath, applyCreateTableOperation(source, {
+		writeFileSync(schemaPath, applyCreateTableOperation(source, {
 			type: "createTable",
-			table: delegateName,
+			table: tableName,
 			columns: [{
 				name: "id",
 				type: "id",
@@ -3159,17 +3185,17 @@ var CliApp = class {
 		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*['"]([^'"]+)['"]/);
-		const delegateMatch = modelSource.match(/protected\s+static\s+override\s+delegate\s*=\s*['"]([^'"]+)['"]/) ?? modelSource.match(/static\s+delegate\s*=\s*['"]([^'"]+)['"]/);
+		const compatibilityDelegateMatch = modelSource.match(/protected\s+static\s+override\s+delegate\s*=\s*['"]([^'"]+)['"]/) ?? modelSource.match(/static\s+delegate\s*=\s*['"]([^'"]+)['"]/);
 		return {
 			className,
-			table: tableMatch?.[1] ?? delegateMatch?.[1] ?? str(className).camel().plural().toString()
+			table: tableMatch?.[1] ?? compatibilityDelegateMatch?.[1] ?? str(className).camel().plural().toString()
 		};
 	}
 	syncModelFiles(modelFiles, resolveStructure, enums) {
 		const updated = [];
 		const skipped = [];
 		modelFiles.forEach((filePath) => {
-			const source = readFileSync$1(filePath, "utf-8");
+			const source = readFileSync(filePath, "utf-8");
 			const structure = resolveStructure(filePath, source);
 			if (!structure || structure.fields.length === 0) {
 				skipped.push(filePath);
@@ -3180,7 +3206,7 @@ var CliApp = class {
 				skipped.push(filePath);
 				return;
 			}
-			writeFileSync$1(filePath, synced.content);
+			writeFileSync(filePath, synced.content);
 			updated.push(filePath);
 		});
 		return {
@@ -3365,12 +3391,12 @@ var CliApp = class {
 	}
 	async syncModels(options = {}) {
 		const modelsDir = options.modelsDir ?? this.resolveConfigPath("models", join$1(process.cwd(), "src", "models"));
-		if (!existsSync$1(modelsDir)) throw new Error(`Models directory not found: ${modelsDir}`);
-		const modelFiles = readdirSync$1(modelsDir).filter((file) => file.endsWith(".ts")).map((file) => join$1(modelsDir, file));
+		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 adapter = this.getConfig("adapter");
 		if (adapter && typeof adapter.introspectModels === "function") {
 			const sources = modelFiles.reduce((all, filePath) => {
-				const parsed = this.parseModelSyncSource(readFileSync$1(filePath, "utf-8"));
+				const parsed = this.parseModelSyncSource(readFileSync(filePath, "utf-8"));
 				if (parsed) all.set(filePath, parsed);
 				return all;
 			}, /* @__PURE__ */ new Map());
@@ -3410,12 +3436,12 @@ 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$1(schemaPath)) throw new Error(`Prisma schema file not found: ${schemaPath}`);
-		if (!existsSync$1(modelsDir)) throw new Error(`Models directory not found: ${modelsDir}`);
-		const schema = readFileSync$1(schemaPath, "utf-8");
+		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");
 		const prismaEnums = this.parsePrismaEnums(schema);
 		const prismaModels = this.parsePrismaModels(schema);
-		const modelFiles = readdirSync$1(modelsDir).filter((file) => file.endsWith(".ts")).map((file) => join$1(modelsDir, file));
+		const modelFiles = readdirSync(modelsDir).filter((file) => file.endsWith(".ts")).map((file) => join$1(modelsDir, file));
 		const result = this.syncModelFiles(modelFiles, (filePath, source) => {
 			const parsed = this.parseModelSyncSource(source);
 			if (!parsed) return void 0;
@@ -3455,18 +3481,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$1(preferredStubPath) ? preferredStubPath : legacyStubPath;
-		if (existsSync$1(outputDir) && !this.option("force")) {
+		const stubPath = existsSync(preferredStubPath) ? preferredStubPath : legacyStubPath;
+		if (existsSync(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$1(outputDir) && this.option("force")) copyFileSync(outputDir, outputDir.replace(/\.js$/, `.backup.${Date.now()}.js`));
-		if (!existsSync$1(stubPath)) {
+		if (existsSync(outputDir) && this.option("force")) copyFileSync(outputDir, outputDir.replace(/\.js$/, `.backup.${Date.now()}.js`));
+		if (!existsSync(stubPath)) {
 			this.error(`Error: Missing config stub at ${preferredStubPath} (or ${legacyStubPath})`);
 			process.exit(1);
 		}
-		writeFileSync$1(outputDir, readFileSync$1(stubPath, "utf-8"));
+		writeFileSync(outputDir, readFileSync(stubPath, "utf-8"));
 		this.success("Arkormˣ initialized successfully!");
 	}
 };
@@ -3641,7 +3667,7 @@ var MigrateCommand = class extends Command {
 		this.app.command = this;
 		const configuredMigrationsDir = this.app.getConfig("paths")?.migrations ?? join(process.cwd(), "database", "migrations");
 		const migrationsDir = this.app.resolveRuntimeDirectoryPath(configuredMigrationsDir);
-		if (!existsSync(migrationsDir)) return void this.error(`Error: Migrations directory not found: ${this.app.formatPathForLog(configuredMigrationsDir)}`);
+		if (!existsSync$1(migrationsDir)) return void this.error(`Error: Migrations directory not found: ${this.app.formatPathForLog(configuredMigrationsDir)}`);
 		const schemaPath = this.option("schema") ? resolve(String(this.option("schema"))) : join(process.cwd(), "prisma", "schema.prisma");
 		const classes = this.option("all") || !this.argument("name") ? await this.loadAllMigrations(migrationsDir) : (await this.loadNamedMigration(migrationsDir, this.argument("name"))).filter(([cls]) => cls !== void 0);
 		if (classes.length === 0) return void this.error("Error: No migration classes found to run.");
@@ -3736,7 +3762,7 @@ var MigrateCommand = class extends Command {
 	* @param migrationsDir The directory to load migration classes from.
 	*/
 	async loadAllMigrations(migrationsDir) {
-		const files = 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)));
+		const files = 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)));
 		return (await Promise.all(files.map(async (file) => (await this.loadMigrationClassesFromFile(file)).map((cls) => [cls, file])))).flat();
 	}
 	/**
@@ -3758,7 +3784,7 @@ var MigrateCommand = class extends Command {
 			`${base}Migration.js`,
 			`${base}Migration.mjs`,
 			`${base}Migration.cjs`
-		].map((file) => join(migrationsDir, file)).find((file) => existsSync(file));
+		].map((file) => join(migrationsDir, file)).find((file) => existsSync$1(file));
 		if (!target) return [[void 0, name]];
 		const runtimeTarget = this.app.resolveRuntimeScriptPath(target);
 		return (await this.loadMigrationClassesFromFile(runtimeTarget)).map((cls) => [cls, runtimeTarget]);
@@ -3794,7 +3820,7 @@ var MigrateFreshCommand = class extends Command {
 		this.app.command = this;
 		const configuredMigrationsDir = this.app.getConfig("paths")?.migrations ?? join(process.cwd(), "database", "migrations");
 		const migrationsDir = this.app.resolveRuntimeDirectoryPath(configuredMigrationsDir);
-		if (!existsSync(migrationsDir)) return void this.error(`Error: Migrations directory not found: ${this.app.formatPathForLog(configuredMigrationsDir)}`);
+		if (!existsSync$1(migrationsDir)) return void this.error(`Error: Migrations directory not found: ${this.app.formatPathForLog(configuredMigrationsDir)}`);
 		const adapter = this.app.getConfig("adapter");
 		const useDatabaseMigrations = supportsDatabaseMigrationExecution(adapter);
 		const persistedFeatures = resolvePersistedMetadataFeatures(this.app.getConfig("features"));
@@ -3815,8 +3841,8 @@ var MigrateFreshCommand = class extends Command {
 			}
 			await adapter.resetDatabase();
 		} else {
-			if (!existsSync(schemaPath)) return void this.error(`Error: Prisma schema file not found: ${this.app.formatPathForLog(schemaPath)}`);
-			writeFileSync(schemaPath, stripPrismaSchemaModelsAndEnums(readFileSync(schemaPath, "utf-8")));
+			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")));
 		}
 		let appliedState = createEmptyAppliedMigrationsState();
 		await writeAppliedMigrationsStateToStore(adapter, stateFilePath, appliedState);
@@ -3863,7 +3889,7 @@ var MigrateFreshCommand = class extends Command {
 		migrations.forEach(([_, file]) => this.success(this.app.splitLogger("Migrated", file)));
 	}
 	async loadAllMigrations(migrationsDir) {
-		const files = 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)));
+		const files = 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)));
 		return (await Promise.all(files.map(async (file) => (await this.loadMigrationClassesFromFile(file)).map((cls) => [cls, file])))).flat();
 	}
 	async loadMigrationClassesFromFile(filePath) {
@@ -3902,7 +3928,7 @@ var MigrateRollbackCommand = class extends Command {
 		this.app.command = this;
 		const configuredMigrationsDir = this.app.getConfig("paths")?.migrations ?? join(process.cwd(), "database", "migrations");
 		const migrationsDir = this.app.resolveRuntimeDirectoryPath(configuredMigrationsDir);
-		if (!existsSync(migrationsDir)) return void this.error(`Error: Migrations directory not found: ${this.app.formatPathForLog(configuredMigrationsDir)}`);
+		if (!existsSync$1(migrationsDir)) return void this.error(`Error: Migrations directory not found: ${this.app.formatPathForLog(configuredMigrationsDir)}`);
 		const schemaPath = this.option("schema") ? resolve(String(this.option("schema"))) : join(process.cwd(), "prisma", "schema.prisma");
 		const stateFilePath = resolveMigrationStateFilePath(process.cwd(), this.option("state-file") ? String(this.option("state-file")) : void 0);
 		const adapter = this.app.getConfig("adapter");
@@ -3963,7 +3989,7 @@ var MigrateRollbackCommand = class extends Command {
 		rollbackClasses.forEach(([_, file]) => this.success(this.app.splitLogger("RolledBack", file)));
 	}
 	async loadAllMigrations(migrationsDir) {
-		const files = 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)));
+		const files = 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)));
 		return (await Promise.all(files.map(async (file) => (await this.loadMigrationClassesFromFile(file)).map((cls) => [cls, file])))).flat();
 	}
 	async loadMigrationClassesFromFile(filePath) {
@@ -4005,11 +4031,11 @@ var MigrationHistoryCommand = class extends Command {
 				this.success("Deleted tracked migration state from database.");
 				return;
 			}
-			if (!existsSync(stateFilePath)) {
+			if (!existsSync$1(stateFilePath)) {
 				this.success(`No migration state file found at ${this.app.formatPathForLog(stateFilePath)}`);
 				return;
 			}
-			rmSync(stateFilePath);
+			rmSync$1(stateFilePath);
 			deletePersistedColumnMappingsState(resolveColumnMappingsFilePath(process.cwd()));
 			this.success(`Deleted migration state file: ${this.app.formatPathForLog(stateFilePath)}`);
 			return;
@@ -4144,7 +4170,7 @@ var SeedCommand = class extends Command {
 		this.app.command = this;
 		const configuredSeedersDir = this.app.getConfig("paths")?.seeders ?? join(process.cwd(), "database", "seeders");
 		const seedersDir = this.app.resolveRuntimeDirectoryPath(configuredSeedersDir);
-		if (!existsSync(seedersDir)) return void this.error(`ERROR: Seeders directory not found: ${this.app.formatPathForLog(configuredSeedersDir)}`);
+		if (!existsSync$1(seedersDir)) return void this.error(`ERROR: Seeders directory not found: ${this.app.formatPathForLog(configuredSeedersDir)}`);
 		const classes = this.option("all") ? await this.loadAllSeeders(seedersDir) : await this.loadNamedSeeder(seedersDir, this.argument("name") ?? "DatabaseSeeder");
 		if (classes.length === 0) return void this.error("ERROR: No seeder classes found to run.");
 		for (const SeederClassItem of classes) await new SeederClassItem().run();
@@ -4158,7 +4184,7 @@ var SeedCommand = class extends Command {
 	* @returns 
 	*/
 	async loadAllSeeders(seedersDir) {
-		const files = readdirSync(seedersDir).filter((file) => /\.(ts|js|mjs|cjs)$/i.test(file)).map((file) => this.app.resolveRuntimeScriptPath(join(seedersDir, file)));
+		const files = readdirSync$1(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();
 	}
 	/**
@@ -4179,7 +4205,7 @@ var SeedCommand = class extends Command {
 			`${base}Seeder.js`,
 			`${base}Seeder.mjs`,
 			`${base}Seeder.cjs`
-		].map((file) => join(seedersDir, file)).find((file) => existsSync(file));
+		].map((file) => join(seedersDir, file)).find((file) => existsSync$1(file));
 		if (!target) return [];
 		const runtimeTarget = this.app.resolveRuntimeScriptPath(target);
 		return await this.loadSeederClassesFromFile(runtimeTarget);