arkormx 0.2.4 → 0.2.5

package/dist/cli.mjs

@@ -2,13 +2,14 @@
 import { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "fs";
 import path, { dirname, extname, join, relative } from "path";
 import { createRequire } from "module";
-import { existsSync as existsSync$1, mkdirSync as mkdirSync$1, readFileSync as readFileSync$1, readdirSync as readdirSync$1, writeFileSync as writeFileSync$1 } from "node:fs";
-import { join as join$1, resolve } from "node: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 { dirname as dirname$1, extname as extname$1, join as join$1, resolve } from "node:path";
 import { spawnSync } from "node:child_process";
 import { str } from "@h3ravel/support";
 import { fileURLToPath, pathToFileURL } from "url";
 import { Logger } from "@h3ravel/shared";
 import { Command, Kernel } from "@h3ravel/musket";
+import { createHash } from "node:crypto";
 import { pathToFileURL as pathToFileURL$1 } from "node:url";
 
 //#region src/Exceptions/ArkormException.ts
@@ -1823,6 +1824,63 @@ var MakeSeederCommand = class extends Command {
 	}
 };
 
+//#endregion
+//#region src/helpers/migration-history.ts
+const DEFAULT_STATE = {
+	version: 1,
+	migrations: []
+};
+const resolveMigrationStateFilePath = (cwd, configuredPath) => {
+	if (configuredPath && configuredPath.trim().length > 0) return resolve(configuredPath);
+	return join$1(cwd, ".arkormx", "migrations.applied.json");
+};
+const buildMigrationIdentity = (filePath, className) => {
+	const fileName = filePath.split("/").pop()?.split("\\").pop() ?? filePath;
+	return `${fileName.slice(0, fileName.length - extname$1(fileName).length)}:${className}`;
+};
+const computeMigrationChecksum = (filePath) => {
+	const source = readFileSync$1(filePath, "utf-8");
+	return createHash("sha256").update(source).digest("hex");
+};
+const readAppliedMigrationsState = (stateFilePath) => {
+	if (!existsSync$1(stateFilePath)) return { ...DEFAULT_STATE };
+	try {
+		const parsed = JSON.parse(readFileSync$1(stateFilePath, "utf-8"));
+		if (!Array.isArray(parsed.migrations)) return { ...DEFAULT_STATE };
+		return {
+			version: 1,
+			migrations: parsed.migrations.filter((migration) => {
+				return typeof migration?.id === "string" && typeof migration?.file === "string" && typeof migration?.className === "string" && typeof migration?.appliedAt === "string" && (migration?.checksum === void 0 || typeof migration?.checksum === "string");
+			})
+		};
+	} catch {
+		return { ...DEFAULT_STATE };
+	}
+};
+const writeAppliedMigrationsState = (stateFilePath, state) => {
+	const directory = dirname$1(stateFilePath);
+	if (!existsSync$1(directory)) mkdirSync$1(directory, { recursive: true });
+	writeFileSync$1(stateFilePath, JSON.stringify(state, null, 2));
+};
+const isMigrationApplied = (state, identity, checksum) => {
+	const matched = state.migrations.find((migration) => migration.id === identity);
+	if (!matched) return false;
+	if (checksum && matched.checksum) return matched.checksum === checksum;
+	if (checksum && !matched.checksum) return false;
+	return true;
+};
+const findAppliedMigration = (state, identity) => {
+	return state.migrations.find((migration) => migration.id === identity);
+};
+const markMigrationApplied = (state, entry) => {
+	const next = state.migrations.filter((migration) => migration.id !== entry.id);
+	next.push(entry);
+	return {
+		version: 1,
+		migrations: next
+	};
+};
+
 //#endregion
 //#region src/database/Migration.ts
 const MIGRATION_BRAND = Symbol.for("arkormx.migration");
@@ -1854,6 +1912,7 @@ var MigrateCommand = class extends Command {
         {--deploy : Use prisma migrate deploy instead of migrate dev}
         {--skip-generate : Skip prisma generate}
         {--skip-migrate : Skip prisma migrate command}
+        {--state-file= : Path to applied migration state file}
         {--schema= : Explicit prisma schema path}
         {--migration-name= : Name for prisma migrate dev}
     `;
@@ -1875,10 +1934,47 @@ var MigrateCommand = class extends Command {
 		const schemaPath = this.option("schema") ? resolve(String(this.option("schema"))) : join$1(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.");
-		for (const [MigrationClassItem] of classes) await applyMigrationToPrismaSchema(MigrationClassItem, {
+		const shouldTrackApplied = Boolean(this.option("all") || !this.argument("name") || this.option("state-file"));
+		const stateFilePath = resolveMigrationStateFilePath(process.cwd(), this.option("state-file") ? String(this.option("state-file")) : void 0);
+		let appliedState = shouldTrackApplied ? readAppliedMigrationsState(stateFilePath) : void 0;
+		const skipped = [];
+		const changed = [];
+		const pending = classes.filter(([migrationClass, file]) => {
+			if (!appliedState) return true;
+			const identity = buildMigrationIdentity(file, migrationClass.name);
+			const checksum = computeMigrationChecksum(file);
+			const alreadyApplied = isMigrationApplied(appliedState, identity, checksum);
+			if (alreadyApplied) skipped.push([migrationClass, file]);
+			else if (findAppliedMigration(appliedState, identity)) changed.push([migrationClass, file]);
+			return !alreadyApplied;
+		});
+		skipped.forEach(([migrationClass, file]) => {
+			this.success(this.app.splitLogger("Skipped", `${file} (${migrationClass.name})`));
+		});
+		changed.forEach(([migrationClass, file]) => {
+			this.success(this.app.splitLogger("Changed", `${file} (${migrationClass.name})`));
+		});
+		if (pending.length === 0) {
+			this.success("No pending migration classes to apply.");
+			return;
+		}
+		for (const [MigrationClassItem] of pending) await applyMigrationToPrismaSchema(MigrationClassItem, {
 			schemaPath,
 			write: true
 		});
+		if (appliedState) {
+			for (const [migrationClass, file] of pending) {
+				const identity = buildMigrationIdentity(file, migrationClass.name);
+				appliedState = markMigrationApplied(appliedState, {
+					id: identity,
+					file,
+					className: migrationClass.name,
+					appliedAt: (/* @__PURE__ */ new Date()).toISOString(),
+					checksum: computeMigrationChecksum(file)
+				});
+			}
+			writeAppliedMigrationsState(stateFilePath, appliedState);
+		}
 		if (!this.option("skip-generate")) runPrismaCommand(["generate"], process.cwd());
 		if (!this.option("skip-migrate")) if (this.option("deploy")) runPrismaCommand(["migrate", "deploy"], process.cwd());
 		else runPrismaCommand([
@@ -1887,8 +1983,8 @@ var MigrateCommand = class extends Command {
 			"--name",
 			this.option("migration-name") ? String(this.option("migration-name")) : `arkorm_cli_${Date.now()}`
 		], process.cwd());
-		this.success(`Applied ${classes.length} migration(s).`);
-		classes.forEach(([_, file]) => this.success(this.app.splitLogger("Migrated", file)));
+		this.success(`Applied ${pending.length} migration(s).`);
+		pending.forEach(([_, file]) => this.success(this.app.splitLogger("Migrated", file)));
 	}
 	/**
 	* Load all migration classes from the specified directory.
@@ -1940,6 +2036,62 @@ var MigrateCommand = class extends Command {
 	}
 };
 
+//#endregion
+//#region src/cli/commands/MigrationHistoryCommand.ts
+/**
+* The MigrationHistoryCommand class manages tracked migration run history.
+*
+* @author Legacy (3m1n3nc3)
+* @since 0.2.4
+*/
+var MigrationHistoryCommand = class extends Command {
+	signature = `migrate:history
+        {--state-file= : Path to applied migration state file}
+        {--reset : Clear tracked migration history file}
+        {--delete : Delete tracked migration history file}
+        {--json : Print raw JSON output}
+    `;
+	description = "Inspect or reset tracked migration history";
+	async handle() {
+		this.app.command = this;
+		const stateFilePath = resolveMigrationStateFilePath(process.cwd(), this.option("state-file") ? String(this.option("state-file")) : void 0);
+		if (this.option("delete")) {
+			if (!existsSync$1(stateFilePath)) {
+				this.success(`No migration state file found at ${this.app.formatPathForLog(stateFilePath)}`);
+				return;
+			}
+			rmSync$1(stateFilePath);
+			this.success(`Deleted migration state file: ${this.app.formatPathForLog(stateFilePath)}`);
+			return;
+		}
+		if (this.option("reset")) {
+			writeAppliedMigrationsState(stateFilePath, {
+				version: 1,
+				migrations: []
+			});
+			this.success(`Reset migration state: ${this.app.formatPathForLog(stateFilePath)}`);
+			return;
+		}
+		const state = readAppliedMigrationsState(stateFilePath);
+		if (this.option("json")) {
+			this.success(JSON.stringify({
+				path: stateFilePath,
+				...state
+			}, null, 2));
+			return;
+		}
+		this.success(this.app.splitLogger("State", stateFilePath));
+		this.success(this.app.splitLogger("Tracked", String(state.migrations.length)));
+		if (state.migrations.length === 0) {
+			this.success("No tracked migrations found.");
+			return;
+		}
+		state.migrations.sort((left, right) => left.appliedAt.localeCompare(right.appliedAt)).forEach((migration) => {
+			this.success(this.app.splitLogger("Applied", `${migration.id} @ ${migration.appliedAt}`));
+		});
+	}
+};
+
 //#endregion
 //#region src/cli/commands/ModelsSyncCommand.ts
 var ModelsSyncCommand = class extends Command {
@@ -2119,7 +2271,8 @@ await Kernel.init(app, {
 		MakeMigrationCommand,
 		ModelsSyncCommand,
 		SeedCommand,
-		MigrateCommand
+		MigrateCommand,
+		MigrationHistoryCommand
 	],
 	exceptionHandler(exception) {
 		throw exception;

package/dist/index.cjs

@@ -37,6 +37,7 @@ let _h3ravel_support = require("@h3ravel/support");
 let url = require("url");
 let _h3ravel_shared = require("@h3ravel/shared");
 let _h3ravel_musket = require("@h3ravel/musket");
+let node_crypto = require("node:crypto");
 let node_url = require("node:url");
 let _h3ravel_collect_js = require("@h3ravel/collect.js");
 
@@ -2031,6 +2032,63 @@ var MakeSeederCommand = class extends _h3ravel_musket.Command {
 	}
 };
 
+//#endregion
+//#region src/helpers/migration-history.ts
+const DEFAULT_STATE = {
+	version: 1,
+	migrations: []
+};
+const resolveMigrationStateFilePath = (cwd, configuredPath) => {
+	if (configuredPath && configuredPath.trim().length > 0) return (0, node_path.resolve)(configuredPath);
+	return (0, node_path.join)(cwd, ".arkormx", "migrations.applied.json");
+};
+const buildMigrationIdentity = (filePath, className) => {
+	const fileName = filePath.split("/").pop()?.split("\\").pop() ?? filePath;
+	return `${fileName.slice(0, fileName.length - (0, node_path.extname)(fileName).length)}:${className}`;
+};
+const computeMigrationChecksum = (filePath) => {
+	const source = (0, node_fs.readFileSync)(filePath, "utf-8");
+	return (0, node_crypto.createHash)("sha256").update(source).digest("hex");
+};
+const readAppliedMigrationsState = (stateFilePath) => {
+	if (!(0, node_fs.existsSync)(stateFilePath)) return { ...DEFAULT_STATE };
+	try {
+		const parsed = JSON.parse((0, node_fs.readFileSync)(stateFilePath, "utf-8"));
+		if (!Array.isArray(parsed.migrations)) return { ...DEFAULT_STATE };
+		return {
+			version: 1,
+			migrations: parsed.migrations.filter((migration) => {
+				return typeof migration?.id === "string" && typeof migration?.file === "string" && typeof migration?.className === "string" && typeof migration?.appliedAt === "string" && (migration?.checksum === void 0 || typeof migration?.checksum === "string");
+			})
+		};
+	} catch {
+		return { ...DEFAULT_STATE };
+	}
+};
+const writeAppliedMigrationsState = (stateFilePath, state) => {
+	const directory = (0, node_path.dirname)(stateFilePath);
+	if (!(0, node_fs.existsSync)(directory)) (0, node_fs.mkdirSync)(directory, { recursive: true });
+	(0, node_fs.writeFileSync)(stateFilePath, JSON.stringify(state, null, 2));
+};
+const isMigrationApplied = (state, identity, checksum) => {
+	const matched = state.migrations.find((migration) => migration.id === identity);
+	if (!matched) return false;
+	if (checksum && matched.checksum) return matched.checksum === checksum;
+	if (checksum && !matched.checksum) return false;
+	return true;
+};
+const findAppliedMigration = (state, identity) => {
+	return state.migrations.find((migration) => migration.id === identity);
+};
+const markMigrationApplied = (state, entry) => {
+	const next = state.migrations.filter((migration) => migration.id !== entry.id);
+	next.push(entry);
+	return {
+		version: 1,
+		migrations: next
+	};
+};
+
 //#endregion
 //#region src/database/Migration.ts
 const MIGRATION_BRAND = Symbol.for("arkormx.migration");
@@ -2062,6 +2120,7 @@ var MigrateCommand = class extends _h3ravel_musket.Command {
         {--deploy : Use prisma migrate deploy instead of migrate dev}
         {--skip-generate : Skip prisma generate}
         {--skip-migrate : Skip prisma migrate command}
+        {--state-file= : Path to applied migration state file}
         {--schema= : Explicit prisma schema path}
         {--migration-name= : Name for prisma migrate dev}
     `;
@@ -2083,10 +2142,47 @@ var MigrateCommand = class extends _h3ravel_musket.Command {
 		const schemaPath = this.option("schema") ? (0, node_path.resolve)(String(this.option("schema"))) : (0, node_path.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.");
-		for (const [MigrationClassItem] of classes) await applyMigrationToPrismaSchema(MigrationClassItem, {
+		const shouldTrackApplied = Boolean(this.option("all") || !this.argument("name") || this.option("state-file"));
+		const stateFilePath = resolveMigrationStateFilePath(process.cwd(), this.option("state-file") ? String(this.option("state-file")) : void 0);
+		let appliedState = shouldTrackApplied ? readAppliedMigrationsState(stateFilePath) : void 0;
+		const skipped = [];
+		const changed = [];
+		const pending = classes.filter(([migrationClass, file]) => {
+			if (!appliedState) return true;
+			const identity = buildMigrationIdentity(file, migrationClass.name);
+			const checksum = computeMigrationChecksum(file);
+			const alreadyApplied = isMigrationApplied(appliedState, identity, checksum);
+			if (alreadyApplied) skipped.push([migrationClass, file]);
+			else if (findAppliedMigration(appliedState, identity)) changed.push([migrationClass, file]);
+			return !alreadyApplied;
+		});
+		skipped.forEach(([migrationClass, file]) => {
+			this.success(this.app.splitLogger("Skipped", `${file} (${migrationClass.name})`));
+		});
+		changed.forEach(([migrationClass, file]) => {
+			this.success(this.app.splitLogger("Changed", `${file} (${migrationClass.name})`));
+		});
+		if (pending.length === 0) {
+			this.success("No pending migration classes to apply.");
+			return;
+		}
+		for (const [MigrationClassItem] of pending) await applyMigrationToPrismaSchema(MigrationClassItem, {
 			schemaPath,
 			write: true
 		});
+		if (appliedState) {
+			for (const [migrationClass, file] of pending) {
+				const identity = buildMigrationIdentity(file, migrationClass.name);
+				appliedState = markMigrationApplied(appliedState, {
+					id: identity,
+					file,
+					className: migrationClass.name,
+					appliedAt: (/* @__PURE__ */ new Date()).toISOString(),
+					checksum: computeMigrationChecksum(file)
+				});
+			}
+			writeAppliedMigrationsState(stateFilePath, appliedState);
+		}
 		if (!this.option("skip-generate")) runPrismaCommand(["generate"], process.cwd());
 		if (!this.option("skip-migrate")) if (this.option("deploy")) runPrismaCommand(["migrate", "deploy"], process.cwd());
 		else runPrismaCommand([
@@ -2095,8 +2191,8 @@ var MigrateCommand = class extends _h3ravel_musket.Command {
 			"--name",
 			this.option("migration-name") ? String(this.option("migration-name")) : `arkorm_cli_${Date.now()}`
 		], process.cwd());
-		this.success(`Applied ${classes.length} migration(s).`);
-		classes.forEach(([_, file]) => this.success(this.app.splitLogger("Migrated", file)));
+		this.success(`Applied ${pending.length} migration(s).`);
+		pending.forEach(([_, file]) => this.success(this.app.splitLogger("Migrated", file)));
 	}
 	/**
 	* Load all migration classes from the specified directory.
@@ -2148,6 +2244,62 @@ var MigrateCommand = class extends _h3ravel_musket.Command {
 	}
 };
 
+//#endregion
+//#region src/cli/commands/MigrationHistoryCommand.ts
+/**
+* The MigrationHistoryCommand class manages tracked migration run history.
+*
+* @author Legacy (3m1n3nc3)
+* @since 0.2.4
+*/
+var MigrationHistoryCommand = class extends _h3ravel_musket.Command {
+	signature = `migrate:history
+        {--state-file= : Path to applied migration state file}
+        {--reset : Clear tracked migration history file}
+        {--delete : Delete tracked migration history file}
+        {--json : Print raw JSON output}
+    `;
+	description = "Inspect or reset tracked migration history";
+	async handle() {
+		this.app.command = this;
+		const stateFilePath = resolveMigrationStateFilePath(process.cwd(), this.option("state-file") ? String(this.option("state-file")) : void 0);
+		if (this.option("delete")) {
+			if (!(0, node_fs.existsSync)(stateFilePath)) {
+				this.success(`No migration state file found at ${this.app.formatPathForLog(stateFilePath)}`);
+				return;
+			}
+			(0, node_fs.rmSync)(stateFilePath);
+			this.success(`Deleted migration state file: ${this.app.formatPathForLog(stateFilePath)}`);
+			return;
+		}
+		if (this.option("reset")) {
+			writeAppliedMigrationsState(stateFilePath, {
+				version: 1,
+				migrations: []
+			});
+			this.success(`Reset migration state: ${this.app.formatPathForLog(stateFilePath)}`);
+			return;
+		}
+		const state = readAppliedMigrationsState(stateFilePath);
+		if (this.option("json")) {
+			this.success(JSON.stringify({
+				path: stateFilePath,
+				...state
+			}, null, 2));
+			return;
+		}
+		this.success(this.app.splitLogger("State", stateFilePath));
+		this.success(this.app.splitLogger("Tracked", String(state.migrations.length)));
+		if (state.migrations.length === 0) {
+			this.success("No tracked migrations found.");
+			return;
+		}
+		state.migrations.sort((left, right) => left.appliedAt.localeCompare(right.appliedAt)).forEach((migration) => {
+			this.success(this.app.splitLogger("Applied", `${migration.id} @ ${migration.appliedAt}`));
+		});
+	}
+};
+
 //#endregion
 //#region src/cli/commands/ModelsSyncCommand.ts
 var ModelsSyncCommand = class extends _h3ravel_musket.Command {
@@ -5130,6 +5282,7 @@ exports.MakeModelCommand = MakeModelCommand;
 exports.MakeSeederCommand = MakeSeederCommand;
 exports.MigrateCommand = MigrateCommand;
 exports.Migration = Migration;
+exports.MigrationHistoryCommand = MigrationHistoryCommand;
 exports.Model = Model;
 exports.ModelFactory = ModelFactory;
 exports.ModelNotFoundException = ModelNotFoundException;
@@ -5151,9 +5304,11 @@ exports.applyOperationsToPrismaSchema = applyOperationsToPrismaSchema;
 exports.buildFieldLine = buildFieldLine;
 exports.buildIndexLine = buildIndexLine;
 exports.buildInverseRelationLine = buildInverseRelationLine;
+exports.buildMigrationIdentity = buildMigrationIdentity;
 exports.buildMigrationSource = buildMigrationSource;
 exports.buildModelBlock = buildModelBlock;
 exports.buildRelationLine = buildRelationLine;
+exports.computeMigrationChecksum = computeMigrationChecksum;
 exports.configureArkormRuntime = configureArkormRuntime;
 exports.createMigrationTimestamp = createMigrationTimestamp;
 exports.createPrismaAdapter = createPrismaAdapter;
@@ -5165,6 +5320,7 @@ exports.deriveInverseRelationAlias = deriveInverseRelationAlias;
 exports.deriveRelationFieldName = deriveRelationFieldName;
 exports.ensureArkormConfigLoading = ensureArkormConfigLoading;
 exports.escapeRegex = escapeRegex;
+exports.findAppliedMigration = findAppliedMigration;
 exports.findModelBlock = findModelBlock;
 exports.formatDefaultValue = formatDefaultValue;
 exports.formatRelationAction = formatRelationAction;
@@ -5176,13 +5332,18 @@ exports.getRuntimePrismaClient = getRuntimePrismaClient;
 exports.getUserConfig = getUserConfig;
 exports.inferDelegateName = inferDelegateName;
 exports.isDelegateLike = isDelegateLike;
+exports.isMigrationApplied = isMigrationApplied;
 exports.loadArkormConfig = loadArkormConfig;
+exports.markMigrationApplied = markMigrationApplied;
 exports.pad = pad;
+exports.readAppliedMigrationsState = readAppliedMigrationsState;
 exports.resetArkormRuntimeForTests = resetArkormRuntimeForTests;
 exports.resolveCast = resolveCast;
 exports.resolveMigrationClassName = resolveMigrationClassName;
+exports.resolveMigrationStateFilePath = resolveMigrationStateFilePath;
 exports.resolvePrismaType = resolvePrismaType;
 exports.runMigrationWithPrisma = runMigrationWithPrisma;
 exports.runPrismaCommand = runPrismaCommand;
 exports.toMigrationFileSlug = toMigrationFileSlug;
-exports.toModelName = toModelName;
+exports.toModelName = toModelName;
+exports.writeAppliedMigrationsState = writeAppliedMigrationsState;

package/dist/index.d.cts

@@ -79,6 +79,17 @@ interface PrismaMigrationWorkflowOptions extends PrismaSchemaSyncOptions {
   migrateMode?: 'dev' | 'deploy';
   migrationName?: string;
 }
+interface AppliedMigrationEntry {
+  id: string;
+  file: string;
+  className: string;
+  appliedAt: string;
+  checksum?: string;
+}
+interface AppliedMigrationsState {
+  version: 1;
+  migrations: AppliedMigrationEntry[];
+}
 //#endregion
 //#region src/Collection.d.ts
 declare class ArkormCollection<T = any, X = T[]> extends Collection<T, X> {}
@@ -2251,6 +2262,19 @@ declare class MigrateCommand extends Command<CliApp> {
   private loadMigrationClassesFromFile;
 }
 //#endregion
+//#region src/cli/commands/MigrationHistoryCommand.d.ts
+/**
+ * The MigrationHistoryCommand class manages tracked migration run history.
+ *
+ * @author Legacy (3m1n3nc3)
+ * @since 0.2.4
+ */
+declare class MigrationHistoryCommand extends Command<CliApp> {
+  protected signature: string;
+  protected description: string;
+  handle(): Promise<void>;
+}
+//#endregion
 //#region src/cli/commands/ModelsSyncCommand.d.ts
 declare class ModelsSyncCommand extends Command<CliApp> {
   protected signature: string;
@@ -2731,6 +2755,16 @@ declare class ModelNotFoundException extends ArkormException {
   getModelName(): string;
 }
 //#endregion
+//#region src/helpers/migration-history.d.ts
+declare const resolveMigrationStateFilePath: (cwd: string, configuredPath?: string) => string;
+declare const buildMigrationIdentity: (filePath: string, className: string) => string;
+declare const computeMigrationChecksum: (filePath: string) => string;
+declare const readAppliedMigrationsState: (stateFilePath: string) => AppliedMigrationsState;
+declare const writeAppliedMigrationsState: (stateFilePath: string, state: AppliedMigrationsState) => void;
+declare const isMigrationApplied: (state: AppliedMigrationsState, identity: string, checksum?: string) => boolean;
+declare const findAppliedMigration: (state: AppliedMigrationsState, identity: string) => AppliedMigrationEntry | undefined;
+declare const markMigrationApplied: (state: AppliedMigrationsState, entry: AppliedMigrationEntry) => AppliedMigrationsState;
+//#endregion
 //#region src/helpers/migrations.d.ts
 declare const PRISMA_MODEL_REGEX: RegExp;
 /**
@@ -3080,4 +3114,4 @@ declare class URLDriver {
   url(page: number): string;
 }
 //#endregion
-export { ArkormCollection, ArkormException, CliApp, ForeignKeyBuilder, InitCommand, InlineFactory, LengthAwarePaginator, MIGRATION_BRAND, MakeFactoryCommand, MakeMigrationCommand, MakeModelCommand, MakeSeederCommand, MigrateCommand, Migration, Model, ModelFactory, ModelNotFoundException, ModelsSyncCommand, PRISMA_MODEL_REGEX, Paginator, PrismaDelegateMap, QueryBuilder, SEEDER_BRAND, SchemaBuilder, SeedCommand, Seeder, SeederCallArgument, SeederConstructor, SeederInput, TableBuilder, URLDriver, applyAlterTableOperation, applyCreateTableOperation, applyDropTableOperation, applyMigrationToPrismaSchema, applyOperationsToPrismaSchema, buildFieldLine, buildIndexLine, buildInverseRelationLine, buildMigrationSource, buildModelBlock, buildRelationLine, configureArkormRuntime, createMigrationTimestamp, createPrismaAdapter, createPrismaDelegateMap, defineConfig, defineFactory, deriveCollectionFieldName, deriveInverseRelationAlias, deriveRelationFieldName, ensureArkormConfigLoading, escapeRegex, findModelBlock, formatDefaultValue, formatRelationAction, generateMigrationFile, getDefaultStubsPath, getMigrationPlan, getRuntimePaginationURLDriverFactory, getRuntimePrismaClient, getUserConfig, inferDelegateName, isDelegateLike, loadArkormConfig, pad, resetArkormRuntimeForTests, resolveCast, resolveMigrationClassName, resolvePrismaType, runMigrationWithPrisma, runPrismaCommand, toMigrationFileSlug, toModelName };
+export { ArkormCollection, ArkormException, CliApp, ForeignKeyBuilder, InitCommand, InlineFactory, LengthAwarePaginator, MIGRATION_BRAND, MakeFactoryCommand, MakeMigrationCommand, MakeModelCommand, MakeSeederCommand, MigrateCommand, Migration, MigrationHistoryCommand, Model, ModelFactory, ModelNotFoundException, ModelsSyncCommand, PRISMA_MODEL_REGEX, Paginator, PrismaDelegateMap, QueryBuilder, SEEDER_BRAND, SchemaBuilder, SeedCommand, Seeder, SeederCallArgument, SeederConstructor, SeederInput, TableBuilder, URLDriver, applyAlterTableOperation, applyCreateTableOperation, applyDropTableOperation, applyMigrationToPrismaSchema, applyOperationsToPrismaSchema, buildFieldLine, buildIndexLine, buildInverseRelationLine, buildMigrationIdentity, buildMigrationSource, buildModelBlock, buildRelationLine, computeMigrationChecksum, configureArkormRuntime, createMigrationTimestamp, createPrismaAdapter, createPrismaDelegateMap, defineConfig, defineFactory, deriveCollectionFieldName, deriveInverseRelationAlias, deriveRelationFieldName, ensureArkormConfigLoading, escapeRegex, findAppliedMigration, findModelBlock, formatDefaultValue, formatRelationAction, generateMigrationFile, getDefaultStubsPath, getMigrationPlan, getRuntimePaginationURLDriverFactory, getRuntimePrismaClient, getUserConfig, inferDelegateName, isDelegateLike, isMigrationApplied, loadArkormConfig, markMigrationApplied, pad, readAppliedMigrationsState, resetArkormRuntimeForTests, resolveCast, resolveMigrationClassName, resolveMigrationStateFilePath, resolvePrismaType, runMigrationWithPrisma, runPrismaCommand, toMigrationFileSlug, toModelName, writeAppliedMigrationsState };

package/dist/index.d.mts

@@ -79,6 +79,17 @@ interface PrismaMigrationWorkflowOptions extends PrismaSchemaSyncOptions {
   migrateMode?: 'dev' | 'deploy';
   migrationName?: string;
 }
+interface AppliedMigrationEntry {
+  id: string;
+  file: string;
+  className: string;
+  appliedAt: string;
+  checksum?: string;
+}
+interface AppliedMigrationsState {
+  version: 1;
+  migrations: AppliedMigrationEntry[];
+}
 //#endregion
 //#region src/Collection.d.ts
 declare class ArkormCollection<T = any, X = T[]> extends Collection<T, X> {}
@@ -2251,6 +2262,19 @@ declare class MigrateCommand extends Command<CliApp> {
   private loadMigrationClassesFromFile;
 }
 //#endregion
+//#region src/cli/commands/MigrationHistoryCommand.d.ts
+/**
+ * The MigrationHistoryCommand class manages tracked migration run history.
+ *
+ * @author Legacy (3m1n3nc3)
+ * @since 0.2.4
+ */
+declare class MigrationHistoryCommand extends Command<CliApp> {
+  protected signature: string;
+  protected description: string;
+  handle(): Promise<void>;
+}
+//#endregion
 //#region src/cli/commands/ModelsSyncCommand.d.ts
 declare class ModelsSyncCommand extends Command<CliApp> {
   protected signature: string;
@@ -2731,6 +2755,16 @@ declare class ModelNotFoundException extends ArkormException {
   getModelName(): string;
 }
 //#endregion
+//#region src/helpers/migration-history.d.ts
+declare const resolveMigrationStateFilePath: (cwd: string, configuredPath?: string) => string;
+declare const buildMigrationIdentity: (filePath: string, className: string) => string;
+declare const computeMigrationChecksum: (filePath: string) => string;
+declare const readAppliedMigrationsState: (stateFilePath: string) => AppliedMigrationsState;
+declare const writeAppliedMigrationsState: (stateFilePath: string, state: AppliedMigrationsState) => void;
+declare const isMigrationApplied: (state: AppliedMigrationsState, identity: string, checksum?: string) => boolean;
+declare const findAppliedMigration: (state: AppliedMigrationsState, identity: string) => AppliedMigrationEntry | undefined;
+declare const markMigrationApplied: (state: AppliedMigrationsState, entry: AppliedMigrationEntry) => AppliedMigrationsState;
+//#endregion
 //#region src/helpers/migrations.d.ts
 declare const PRISMA_MODEL_REGEX: RegExp;
 /**
@@ -3080,4 +3114,4 @@ declare class URLDriver {
   url(page: number): string;
 }
 //#endregion
-export { ArkormCollection, ArkormException, CliApp, ForeignKeyBuilder, InitCommand, InlineFactory, LengthAwarePaginator, MIGRATION_BRAND, MakeFactoryCommand, MakeMigrationCommand, MakeModelCommand, MakeSeederCommand, MigrateCommand, Migration, Model, ModelFactory, ModelNotFoundException, ModelsSyncCommand, PRISMA_MODEL_REGEX, Paginator, PrismaDelegateMap, QueryBuilder, SEEDER_BRAND, SchemaBuilder, SeedCommand, Seeder, SeederCallArgument, SeederConstructor, SeederInput, TableBuilder, URLDriver, applyAlterTableOperation, applyCreateTableOperation, applyDropTableOperation, applyMigrationToPrismaSchema, applyOperationsToPrismaSchema, buildFieldLine, buildIndexLine, buildInverseRelationLine, buildMigrationSource, buildModelBlock, buildRelationLine, configureArkormRuntime, createMigrationTimestamp, createPrismaAdapter, createPrismaDelegateMap, defineConfig, defineFactory, deriveCollectionFieldName, deriveInverseRelationAlias, deriveRelationFieldName, ensureArkormConfigLoading, escapeRegex, findModelBlock, formatDefaultValue, formatRelationAction, generateMigrationFile, getDefaultStubsPath, getMigrationPlan, getRuntimePaginationURLDriverFactory, getRuntimePrismaClient, getUserConfig, inferDelegateName, isDelegateLike, loadArkormConfig, pad, resetArkormRuntimeForTests, resolveCast, resolveMigrationClassName, resolvePrismaType, runMigrationWithPrisma, runPrismaCommand, toMigrationFileSlug, toModelName };
+export { ArkormCollection, ArkormException, CliApp, ForeignKeyBuilder, InitCommand, InlineFactory, LengthAwarePaginator, MIGRATION_BRAND, MakeFactoryCommand, MakeMigrationCommand, MakeModelCommand, MakeSeederCommand, MigrateCommand, Migration, MigrationHistoryCommand, Model, ModelFactory, ModelNotFoundException, ModelsSyncCommand, PRISMA_MODEL_REGEX, Paginator, PrismaDelegateMap, QueryBuilder, SEEDER_BRAND, SchemaBuilder, SeedCommand, Seeder, SeederCallArgument, SeederConstructor, SeederInput, TableBuilder, URLDriver, applyAlterTableOperation, applyCreateTableOperation, applyDropTableOperation, applyMigrationToPrismaSchema, applyOperationsToPrismaSchema, buildFieldLine, buildIndexLine, buildInverseRelationLine, buildMigrationIdentity, buildMigrationSource, buildModelBlock, buildRelationLine, computeMigrationChecksum, configureArkormRuntime, createMigrationTimestamp, createPrismaAdapter, createPrismaDelegateMap, defineConfig, defineFactory, deriveCollectionFieldName, deriveInverseRelationAlias, deriveRelationFieldName, ensureArkormConfigLoading, escapeRegex, findAppliedMigration, findModelBlock, formatDefaultValue, formatRelationAction, generateMigrationFile, getDefaultStubsPath, getMigrationPlan, getRuntimePaginationURLDriverFactory, getRuntimePrismaClient, getUserConfig, inferDelegateName, isDelegateLike, isMigrationApplied, loadArkormConfig, markMigrationApplied, pad, readAppliedMigrationsState, resetArkormRuntimeForTests, resolveCast, resolveMigrationClassName, resolveMigrationStateFilePath, resolvePrismaType, runMigrationWithPrisma, runPrismaCommand, toMigrationFileSlug, toModelName, writeAppliedMigrationsState };

package/dist/index.mjs

@@ -1,13 +1,14 @@
 import { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "fs";
 import path, { dirname, extname, join, relative } from "path";
 import { createRequire } from "module";
-import { existsSync as existsSync$1, mkdirSync as mkdirSync$1, readFileSync as readFileSync$1, readdirSync as readdirSync$1, writeFileSync as writeFileSync$1 } from "node:fs";
-import { join as join$1, resolve } from "node: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 { dirname as dirname$1, extname as extname$1, join as join$1, resolve } from "node:path";
 import { spawnSync } from "node:child_process";
 import { str } from "@h3ravel/support";
 import { fileURLToPath, pathToFileURL } from "url";
 import { Logger } from "@h3ravel/shared";
 import { Command } from "@h3ravel/musket";
+import { createHash } from "node:crypto";
 import { pathToFileURL as pathToFileURL$1 } from "node:url";
 import { Collection } from "@h3ravel/collect.js";
 
@@ -2002,6 +2003,63 @@ var MakeSeederCommand = class extends Command {
 	}
 };
 
+//#endregion
+//#region src/helpers/migration-history.ts
+const DEFAULT_STATE = {
+	version: 1,
+	migrations: []
+};
+const resolveMigrationStateFilePath = (cwd, configuredPath) => {
+	if (configuredPath && configuredPath.trim().length > 0) return resolve(configuredPath);
+	return join$1(cwd, ".arkormx", "migrations.applied.json");
+};
+const buildMigrationIdentity = (filePath, className) => {
+	const fileName = filePath.split("/").pop()?.split("\\").pop() ?? filePath;
+	return `${fileName.slice(0, fileName.length - extname$1(fileName).length)}:${className}`;
+};
+const computeMigrationChecksum = (filePath) => {
+	const source = readFileSync$1(filePath, "utf-8");
+	return createHash("sha256").update(source).digest("hex");
+};
+const readAppliedMigrationsState = (stateFilePath) => {
+	if (!existsSync$1(stateFilePath)) return { ...DEFAULT_STATE };
+	try {
+		const parsed = JSON.parse(readFileSync$1(stateFilePath, "utf-8"));
+		if (!Array.isArray(parsed.migrations)) return { ...DEFAULT_STATE };
+		return {
+			version: 1,
+			migrations: parsed.migrations.filter((migration) => {
+				return typeof migration?.id === "string" && typeof migration?.file === "string" && typeof migration?.className === "string" && typeof migration?.appliedAt === "string" && (migration?.checksum === void 0 || typeof migration?.checksum === "string");
+			})
+		};
+	} catch {
+		return { ...DEFAULT_STATE };
+	}
+};
+const writeAppliedMigrationsState = (stateFilePath, state) => {
+	const directory = dirname$1(stateFilePath);
+	if (!existsSync$1(directory)) mkdirSync$1(directory, { recursive: true });
+	writeFileSync$1(stateFilePath, JSON.stringify(state, null, 2));
+};
+const isMigrationApplied = (state, identity, checksum) => {
+	const matched = state.migrations.find((migration) => migration.id === identity);
+	if (!matched) return false;
+	if (checksum && matched.checksum) return matched.checksum === checksum;
+	if (checksum && !matched.checksum) return false;
+	return true;
+};
+const findAppliedMigration = (state, identity) => {
+	return state.migrations.find((migration) => migration.id === identity);
+};
+const markMigrationApplied = (state, entry) => {
+	const next = state.migrations.filter((migration) => migration.id !== entry.id);
+	next.push(entry);
+	return {
+		version: 1,
+		migrations: next
+	};
+};
+
 //#endregion
 //#region src/database/Migration.ts
 const MIGRATION_BRAND = Symbol.for("arkormx.migration");
@@ -2033,6 +2091,7 @@ var MigrateCommand = class extends Command {
         {--deploy : Use prisma migrate deploy instead of migrate dev}
         {--skip-generate : Skip prisma generate}
         {--skip-migrate : Skip prisma migrate command}
+        {--state-file= : Path to applied migration state file}
         {--schema= : Explicit prisma schema path}
         {--migration-name= : Name for prisma migrate dev}
     `;
@@ -2054,10 +2113,47 @@ var MigrateCommand = class extends Command {
 		const schemaPath = this.option("schema") ? resolve(String(this.option("schema"))) : join$1(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.");
-		for (const [MigrationClassItem] of classes) await applyMigrationToPrismaSchema(MigrationClassItem, {
+		const shouldTrackApplied = Boolean(this.option("all") || !this.argument("name") || this.option("state-file"));
+		const stateFilePath = resolveMigrationStateFilePath(process.cwd(), this.option("state-file") ? String(this.option("state-file")) : void 0);
+		let appliedState = shouldTrackApplied ? readAppliedMigrationsState(stateFilePath) : void 0;
+		const skipped = [];
+		const changed = [];
+		const pending = classes.filter(([migrationClass, file]) => {
+			if (!appliedState) return true;
+			const identity = buildMigrationIdentity(file, migrationClass.name);
+			const checksum = computeMigrationChecksum(file);
+			const alreadyApplied = isMigrationApplied(appliedState, identity, checksum);
+			if (alreadyApplied) skipped.push([migrationClass, file]);
+			else if (findAppliedMigration(appliedState, identity)) changed.push([migrationClass, file]);
+			return !alreadyApplied;
+		});
+		skipped.forEach(([migrationClass, file]) => {
+			this.success(this.app.splitLogger("Skipped", `${file} (${migrationClass.name})`));
+		});
+		changed.forEach(([migrationClass, file]) => {
+			this.success(this.app.splitLogger("Changed", `${file} (${migrationClass.name})`));
+		});
+		if (pending.length === 0) {
+			this.success("No pending migration classes to apply.");
+			return;
+		}
+		for (const [MigrationClassItem] of pending) await applyMigrationToPrismaSchema(MigrationClassItem, {
 			schemaPath,
 			write: true
 		});
+		if (appliedState) {
+			for (const [migrationClass, file] of pending) {
+				const identity = buildMigrationIdentity(file, migrationClass.name);
+				appliedState = markMigrationApplied(appliedState, {
+					id: identity,
+					file,
+					className: migrationClass.name,
+					appliedAt: (/* @__PURE__ */ new Date()).toISOString(),
+					checksum: computeMigrationChecksum(file)
+				});
+			}
+			writeAppliedMigrationsState(stateFilePath, appliedState);
+		}
 		if (!this.option("skip-generate")) runPrismaCommand(["generate"], process.cwd());
 		if (!this.option("skip-migrate")) if (this.option("deploy")) runPrismaCommand(["migrate", "deploy"], process.cwd());
 		else runPrismaCommand([
@@ -2066,8 +2162,8 @@ var MigrateCommand = class extends Command {
 			"--name",
 			this.option("migration-name") ? String(this.option("migration-name")) : `arkorm_cli_${Date.now()}`
 		], process.cwd());
-		this.success(`Applied ${classes.length} migration(s).`);
-		classes.forEach(([_, file]) => this.success(this.app.splitLogger("Migrated", file)));
+		this.success(`Applied ${pending.length} migration(s).`);
+		pending.forEach(([_, file]) => this.success(this.app.splitLogger("Migrated", file)));
 	}
 	/**
 	* Load all migration classes from the specified directory.
@@ -2119,6 +2215,62 @@ var MigrateCommand = class extends Command {
 	}
 };
 
+//#endregion
+//#region src/cli/commands/MigrationHistoryCommand.ts
+/**
+* The MigrationHistoryCommand class manages tracked migration run history.
+*
+* @author Legacy (3m1n3nc3)
+* @since 0.2.4
+*/
+var MigrationHistoryCommand = class extends Command {
+	signature = `migrate:history
+        {--state-file= : Path to applied migration state file}
+        {--reset : Clear tracked migration history file}
+        {--delete : Delete tracked migration history file}
+        {--json : Print raw JSON output}
+    `;
+	description = "Inspect or reset tracked migration history";
+	async handle() {
+		this.app.command = this;
+		const stateFilePath = resolveMigrationStateFilePath(process.cwd(), this.option("state-file") ? String(this.option("state-file")) : void 0);
+		if (this.option("delete")) {
+			if (!existsSync$1(stateFilePath)) {
+				this.success(`No migration state file found at ${this.app.formatPathForLog(stateFilePath)}`);
+				return;
+			}
+			rmSync$1(stateFilePath);
+			this.success(`Deleted migration state file: ${this.app.formatPathForLog(stateFilePath)}`);
+			return;
+		}
+		if (this.option("reset")) {
+			writeAppliedMigrationsState(stateFilePath, {
+				version: 1,
+				migrations: []
+			});
+			this.success(`Reset migration state: ${this.app.formatPathForLog(stateFilePath)}`);
+			return;
+		}
+		const state = readAppliedMigrationsState(stateFilePath);
+		if (this.option("json")) {
+			this.success(JSON.stringify({
+				path: stateFilePath,
+				...state
+			}, null, 2));
+			return;
+		}
+		this.success(this.app.splitLogger("State", stateFilePath));
+		this.success(this.app.splitLogger("Tracked", String(state.migrations.length)));
+		if (state.migrations.length === 0) {
+			this.success("No tracked migrations found.");
+			return;
+		}
+		state.migrations.sort((left, right) => left.appliedAt.localeCompare(right.appliedAt)).forEach((migration) => {
+			this.success(this.app.splitLogger("Applied", `${migration.id} @ ${migration.appliedAt}`));
+		});
+	}
+};
+
 //#endregion
 //#region src/cli/commands/ModelsSyncCommand.ts
 var ModelsSyncCommand = class extends Command {
@@ -5087,4 +5239,4 @@ var Model = class Model {
 };
 
 //#endregion
-export { ArkormCollection, ArkormException, CliApp, ForeignKeyBuilder, InitCommand, InlineFactory, LengthAwarePaginator, MIGRATION_BRAND, MakeFactoryCommand, MakeMigrationCommand, MakeModelCommand, MakeSeederCommand, MigrateCommand, Migration, Model, ModelFactory, ModelNotFoundException, ModelsSyncCommand, PRISMA_MODEL_REGEX, Paginator, QueryBuilder, SEEDER_BRAND, SchemaBuilder, SeedCommand, Seeder, TableBuilder, URLDriver, applyAlterTableOperation, applyCreateTableOperation, applyDropTableOperation, applyMigrationToPrismaSchema, applyOperationsToPrismaSchema, buildFieldLine, buildIndexLine, buildInverseRelationLine, buildMigrationSource, buildModelBlock, buildRelationLine, configureArkormRuntime, createMigrationTimestamp, createPrismaAdapter, createPrismaDelegateMap, defineConfig, defineFactory, deriveCollectionFieldName, deriveInverseRelationAlias, deriveRelationFieldName, ensureArkormConfigLoading, escapeRegex, findModelBlock, formatDefaultValue, formatRelationAction, generateMigrationFile, getDefaultStubsPath, getMigrationPlan, getRuntimePaginationURLDriverFactory, getRuntimePrismaClient, getUserConfig, inferDelegateName, isDelegateLike, loadArkormConfig, pad, resetArkormRuntimeForTests, resolveCast, resolveMigrationClassName, resolvePrismaType, runMigrationWithPrisma, runPrismaCommand, toMigrationFileSlug, toModelName };
+export { ArkormCollection, ArkormException, CliApp, ForeignKeyBuilder, InitCommand, InlineFactory, LengthAwarePaginator, MIGRATION_BRAND, MakeFactoryCommand, MakeMigrationCommand, MakeModelCommand, MakeSeederCommand, MigrateCommand, Migration, MigrationHistoryCommand, Model, ModelFactory, ModelNotFoundException, ModelsSyncCommand, PRISMA_MODEL_REGEX, Paginator, QueryBuilder, SEEDER_BRAND, SchemaBuilder, SeedCommand, Seeder, TableBuilder, URLDriver, applyAlterTableOperation, applyCreateTableOperation, applyDropTableOperation, applyMigrationToPrismaSchema, applyOperationsToPrismaSchema, buildFieldLine, buildIndexLine, buildInverseRelationLine, buildMigrationIdentity, buildMigrationSource, buildModelBlock, buildRelationLine, computeMigrationChecksum, configureArkormRuntime, createMigrationTimestamp, createPrismaAdapter, createPrismaDelegateMap, defineConfig, defineFactory, deriveCollectionFieldName, deriveInverseRelationAlias, deriveRelationFieldName, ensureArkormConfigLoading, escapeRegex, findAppliedMigration, findModelBlock, formatDefaultValue, formatRelationAction, generateMigrationFile, getDefaultStubsPath, getMigrationPlan, getRuntimePaginationURLDriverFactory, getRuntimePrismaClient, getUserConfig, inferDelegateName, isDelegateLike, isMigrationApplied, loadArkormConfig, markMigrationApplied, pad, readAppliedMigrationsState, resetArkormRuntimeForTests, resolveCast, resolveMigrationClassName, resolveMigrationStateFilePath, resolvePrismaType, runMigrationWithPrisma, runPrismaCommand, toMigrationFileSlug, toModelName, writeAppliedMigrationsState };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkormx",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "description": "Modern TypeScript-first ORM for Node.js.",
   "keywords": [
     "orm",