arkormx 0.2.5 → 0.2.7

package/dist/index.cjs

@@ -26,15 +26,15 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 
 //#endregion
-let fs = require("fs");
-let path = require("path");
-path = __toESM(path);
-let module$1 = require("module");
 let node_fs = require("node:fs");
 let node_path = require("node:path");
 let node_child_process = require("node:child_process");
 let _h3ravel_support = require("@h3ravel/support");
+let path = require("path");
+path = __toESM(path);
+let fs = require("fs");
 let url = require("url");
+let module$1 = require("module");
 let _h3ravel_shared = require("@h3ravel/shared");
 let _h3ravel_musket = require("@h3ravel/musket");
 let node_crypto = require("node:crypto");
@@ -1152,6 +1152,26 @@ const applyMigrationToPrismaSchema = async (migration, options = {}) => {
 	};
 };
 /**
+* Apply the rollback (down) operations defined in a migration to a Prisma schema file.
+*
+* @param migration The migration class or instance to rollback.
+* @param options   Options for applying the rollback, including schema path and write flag.
+* @returns         A promise that resolves to an object containing the updated schema, schema path, and rollback operations applied.
+*/
+const applyMigrationRollbackToPrismaSchema = async (migration, options = {}) => {
+	const schemaPath = options.schemaPath ?? (0, node_path.join)(process.cwd(), "prisma", "schema.prisma");
+	if (!(0, node_fs.existsSync)(schemaPath)) throw new ArkormException(`Prisma schema file not found: ${schemaPath}`);
+	const source = (0, node_fs.readFileSync)(schemaPath, "utf-8");
+	const operations = await getMigrationPlan(migration, "down");
+	const schema = applyOperationsToPrismaSchema(source, operations);
+	if (options.write ?? true) (0, node_fs.writeFileSync)(schemaPath, schema);
+	return {
+		schema,
+		schemaPath,
+		operations
+	};
+};
+/**
 * Run a migration by applying its schema operations to a Prisma schema 
 * file, optionally generating Prisma client code and running migrations after 
 * applying the schema changes.
@@ -1702,7 +1722,9 @@ var CliApp = class {
 				name: "id",
 				type: "id",
 				primary: true
-			}]
+			}],
+			indexes: [],
+			foreignKeys: []
 		}));
 		return {
 			path: schemaPath,
@@ -1754,14 +1776,14 @@ var CliApp = class {
 			body.split("\n").forEach((rawLine) => {
 				const line = rawLine.trim();
 				if (!line || line.startsWith("@@") || line.startsWith("//")) return;
-				const fieldMatch = line.match(/^(\w+)\s+([A-Za-z]+)(\?)?\b/);
+				const fieldMatch = line.match(/^(\w+)\s+([A-Za-z]+)(\?)?(?:\s|$)/);
 				if (!fieldMatch) return;
 				const fieldType = fieldMatch[2];
 				if (!scalarTypes.has(fieldType)) return;
 				fields.push({
 					name: fieldMatch[1],
 					type: this.prismaTypeToTs(fieldType),
-					optional: Boolean(fieldMatch[3])
+					nullable: Boolean(fieldMatch[3])
 				});
 			});
 			models.push({
@@ -1852,7 +1874,7 @@ var CliApp = class {
 				skipped.push(filePath);
 				return;
 			}
-			const declarations = prismaModel.fields.map((field) => `declare ${field.name}${field.optional ? "?" : ""}: ${field.type}`);
+			const declarations = prismaModel.fields.map((field) => `declare ${field.name}: ${field.type}${field.nullable ? " | null" : ""}`);
 			const synced = this.syncModelDeclarations(source, declarations);
 			if (!synced.updated) {
 				skipped.push(filePath);
@@ -2036,7 +2058,8 @@ var MakeSeederCommand = class extends _h3ravel_musket.Command {
 //#region src/helpers/migration-history.ts
 const DEFAULT_STATE = {
 	version: 1,
-	migrations: []
+	migrations: [],
+	runs: []
 };
 const resolveMigrationStateFilePath = (cwd, configuredPath) => {
 	if (configuredPath && configuredPath.trim().length > 0) return (0, node_path.resolve)(configuredPath);
@@ -2059,7 +2082,10 @@ const readAppliedMigrationsState = (stateFilePath) => {
 			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");
-			})
+			}),
+			runs: Array.isArray(parsed.runs) ? parsed.runs.filter((run) => {
+				return typeof run?.id === "string" && typeof run?.appliedAt === "string" && Array.isArray(run?.migrationIds) && run.migrationIds.every((item) => typeof item === "string");
+			}) : []
 		};
 	} catch {
 		return { ...DEFAULT_STATE };
@@ -2085,9 +2111,40 @@ const markMigrationApplied = (state, entry) => {
 	next.push(entry);
 	return {
 		version: 1,
-		migrations: next
+		migrations: next,
+		runs: state.runs ?? []
 	};
 };
+const removeAppliedMigration = (state, identity) => {
+	return {
+		version: 1,
+		migrations: state.migrations.filter((migration) => migration.id !== identity),
+		runs: (state.runs ?? []).map((run) => ({
+			...run,
+			migrationIds: run.migrationIds.filter((id) => id !== identity)
+		})).filter((run) => run.migrationIds.length > 0)
+	};
+};
+const buildMigrationRunId = () => {
+	return `run_${Date.now()}_${Math.random().toString(36).slice(2, 10)}`;
+};
+const markMigrationRun = (state, run) => {
+	const nextRuns = (state.runs ?? []).filter((existing) => existing.id !== run.id);
+	nextRuns.push(run);
+	return {
+		version: 1,
+		migrations: state.migrations,
+		runs: nextRuns
+	};
+};
+const getLastMigrationRun = (state) => {
+	const runs = state.runs ?? [];
+	if (runs.length === 0) return void 0;
+	return [...runs].sort((left, right) => right.appliedAt.localeCompare(left.appliedAt))[0];
+};
+const getLatestAppliedMigrations = (state, steps) => {
+	return [...state.migrations].sort((left, right) => right.appliedAt.localeCompare(left.appliedAt)).slice(0, Math.max(0, steps));
+};
 
 //#endregion
 //#region src/database/Migration.ts
@@ -2142,9 +2199,8 @@ 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.");
-		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;
+		let appliedState = readAppliedMigrationsState(stateFilePath);
 		const skipped = [];
 		const changed = [];
 		const pending = classes.filter(([migrationClass, file]) => {
@@ -2171,6 +2227,7 @@ var MigrateCommand = class extends _h3ravel_musket.Command {
 			write: true
 		});
 		if (appliedState) {
+			const runAppliedIds = [];
 			for (const [migrationClass, file] of pending) {
 				const identity = buildMigrationIdentity(file, migrationClass.name);
 				appliedState = markMigrationApplied(appliedState, {
@@ -2180,7 +2237,13 @@ var MigrateCommand = class extends _h3ravel_musket.Command {
 					appliedAt: (/* @__PURE__ */ new Date()).toISOString(),
 					checksum: computeMigrationChecksum(file)
 				});
+				runAppliedIds.push(identity);
 			}
+			appliedState = markMigrationRun(appliedState, {
+				id: buildMigrationRunId(),
+				appliedAt: (/* @__PURE__ */ new Date()).toISOString(),
+				migrationIds: runAppliedIds
+			});
 			writeAppliedMigrationsState(stateFilePath, appliedState);
 		}
 		if (!this.option("skip-generate")) runPrismaCommand(["generate"], process.cwd());
@@ -2244,6 +2307,91 @@ var MigrateCommand = class extends _h3ravel_musket.Command {
 	}
 };
 
+//#endregion
+//#region src/cli/commands/MigrateRollbackCommand.ts
+/**
+* Rollback migration classes from the Prisma schema and run Prisma workflow.
+* By default, rolls back classes applied in the last migrate run.
+*
+* @author Legacy (3m1n3nc3)
+* @since 0.2.4
+*/
+var MigrateRollbackCommand = class extends _h3ravel_musket.Command {
+	signature = `migrate:rollback
+        {--step= : Number of latest applied migration classes to rollback}
+        {--dry-run : Preview rollback targets without applying changes}
+        {--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}
+    `;
+	description = "Rollback migration classes from schema.prisma and run Prisma workflow";
+	async handle() {
+		this.app.command = this;
+		const configuredMigrationsDir = this.app.getConfig("paths")?.migrations ?? (0, node_path.join)(process.cwd(), "database", "migrations");
+		const migrationsDir = this.app.resolveRuntimeDirectoryPath(configuredMigrationsDir);
+		if (!(0, node_fs.existsSync)(migrationsDir)) return void this.error(`Error: Migrations directory not found: ${this.app.formatPathForLog(configuredMigrationsDir)}`);
+		const schemaPath = this.option("schema") ? (0, node_path.resolve)(String(this.option("schema"))) : (0, node_path.join)(process.cwd(), "prisma", "schema.prisma");
+		const stateFilePath = resolveMigrationStateFilePath(process.cwd(), this.option("state-file") ? String(this.option("state-file")) : void 0);
+		let appliedState = readAppliedMigrationsState(stateFilePath);
+		const stepOption = this.option("step");
+		const stepCount = stepOption == null ? void 0 : Number(stepOption);
+		if (stepCount != null && (!Number.isFinite(stepCount) || stepCount <= 0 || !Number.isInteger(stepCount))) return void this.error("Error: --step must be a positive integer.");
+		const targets = stepCount ? getLatestAppliedMigrations(appliedState, stepCount) : (() => {
+			const lastRun = getLastMigrationRun(appliedState);
+			if (!lastRun) return [];
+			return lastRun.migrationIds.map((id) => appliedState.migrations.find((migration) => migration.id === id)).filter((migration) => Boolean(migration));
+		})();
+		if (targets.length === 0) return void this.error("Error: No tracked migrations available to rollback.");
+		const available = await this.loadAllMigrations(migrationsDir);
+		const rollbackClasses = targets.map((target) => {
+			return available.find(([migrationClass, file]) => {
+				return buildMigrationIdentity(file, migrationClass.name) === target.id || migrationClass.name === target.className;
+			});
+		}).filter((entry) => Boolean(entry));
+		if (rollbackClasses.length === 0) return void this.error("Error: Unable to resolve rollback migration classes from tracked history.");
+		if (this.option("dry-run")) {
+			this.success(`Dry run: ${rollbackClasses.length} migration(s) would be rolled back.`);
+			rollbackClasses.forEach(([_, file]) => this.success(this.app.splitLogger("WouldRollback", file)));
+			return;
+		}
+		for (const [MigrationClassItem] of rollbackClasses) await applyMigrationRollbackToPrismaSchema(MigrationClassItem, {
+			schemaPath,
+			write: true
+		});
+		for (const [migrationClass, file] of rollbackClasses) {
+			const identity = buildMigrationIdentity(file, migrationClass.name);
+			appliedState = removeAppliedMigration(appliedState, identity);
+		}
+		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([
+			"migrate",
+			"dev",
+			"--name",
+			this.option("migration-name") ? String(this.option("migration-name")) : `arkorm_cli_rollback_${Date.now()}`
+		], process.cwd());
+		this.success(`Rolled back ${rollbackClasses.length} migration(s).`);
+		rollbackClasses.forEach(([_, file]) => this.success(this.app.splitLogger("RolledBack", file)));
+	}
+	async loadAllMigrations(migrationsDir) {
+		const files = (0, node_fs.readdirSync)(migrationsDir).filter((file) => /\.(ts|js|mjs|cjs)$/i.test(file)).sort((left, right) => left.localeCompare(right)).map((file) => this.app.resolveRuntimeScriptPath((0, node_path.join)(migrationsDir, file)));
+		return (await Promise.all(files.map(async (file) => (await this.loadMigrationClassesFromFile(file)).map((cls) => [cls, file])))).flat();
+	}
+	async loadMigrationClassesFromFile(filePath) {
+		const imported = await import(`${(0, node_url.pathToFileURL)((0, node_path.resolve)(filePath)).href}?arkorm_rollback=${Date.now()}`);
+		return Object.values(imported).filter((value) => {
+			if (typeof value !== "function") return false;
+			const candidate = value;
+			const prototype = candidate.prototype;
+			return candidate[MIGRATION_BRAND] === true || typeof prototype?.up === "function" && typeof prototype?.down === "function";
+		});
+	}
+};
+
 //#endregion
 //#region src/cli/commands/MigrationHistoryCommand.ts
 /**
@@ -2295,7 +2443,7 @@ var MigrationHistoryCommand = class extends _h3ravel_musket.Command {
 			return;
 		}
 		state.migrations.sort((left, right) => left.appliedAt.localeCompare(right.appliedAt)).forEach((migration) => {
-			this.success(this.app.splitLogger("Applied", `${migration.id} @ ${migration.appliedAt}`));
+			this.success(this.app.splitLogger("Applied:", `${migration.id} @ ${migration.appliedAt}`));
 		});
 	}
 };
@@ -5281,6 +5429,7 @@ exports.MakeMigrationCommand = MakeMigrationCommand;
 exports.MakeModelCommand = MakeModelCommand;
 exports.MakeSeederCommand = MakeSeederCommand;
 exports.MigrateCommand = MigrateCommand;
+exports.MigrateRollbackCommand = MigrateRollbackCommand;
 exports.Migration = Migration;
 exports.MigrationHistoryCommand = MigrationHistoryCommand;
 exports.Model = Model;
@@ -5299,12 +5448,14 @@ exports.URLDriver = URLDriver;
 exports.applyAlterTableOperation = applyAlterTableOperation;
 exports.applyCreateTableOperation = applyCreateTableOperation;
 exports.applyDropTableOperation = applyDropTableOperation;
+exports.applyMigrationRollbackToPrismaSchema = applyMigrationRollbackToPrismaSchema;
 exports.applyMigrationToPrismaSchema = applyMigrationToPrismaSchema;
 exports.applyOperationsToPrismaSchema = applyOperationsToPrismaSchema;
 exports.buildFieldLine = buildFieldLine;
 exports.buildIndexLine = buildIndexLine;
 exports.buildInverseRelationLine = buildInverseRelationLine;
 exports.buildMigrationIdentity = buildMigrationIdentity;
+exports.buildMigrationRunId = buildMigrationRunId;
 exports.buildMigrationSource = buildMigrationSource;
 exports.buildModelBlock = buildModelBlock;
 exports.buildRelationLine = buildRelationLine;
@@ -5326,6 +5477,8 @@ exports.formatDefaultValue = formatDefaultValue;
 exports.formatRelationAction = formatRelationAction;
 exports.generateMigrationFile = generateMigrationFile;
 exports.getDefaultStubsPath = getDefaultStubsPath;
+exports.getLastMigrationRun = getLastMigrationRun;
+exports.getLatestAppliedMigrations = getLatestAppliedMigrations;
 exports.getMigrationPlan = getMigrationPlan;
 exports.getRuntimePaginationURLDriverFactory = getRuntimePaginationURLDriverFactory;
 exports.getRuntimePrismaClient = getRuntimePrismaClient;
@@ -5335,8 +5488,10 @@ exports.isDelegateLike = isDelegateLike;
 exports.isMigrationApplied = isMigrationApplied;
 exports.loadArkormConfig = loadArkormConfig;
 exports.markMigrationApplied = markMigrationApplied;
+exports.markMigrationRun = markMigrationRun;
 exports.pad = pad;
 exports.readAppliedMigrationsState = readAppliedMigrationsState;
+exports.removeAppliedMigration = removeAppliedMigration;
 exports.resetArkormRuntimeForTests = resetArkormRuntimeForTests;
 exports.resolveCast = resolveCast;
 exports.resolveMigrationClassName = resolveMigrationClassName;

package/dist/index.d.cts

@@ -86,9 +86,15 @@ interface AppliedMigrationEntry {
   appliedAt: string;
   checksum?: string;
 }
+interface AppliedMigrationRun {
+  id: string;
+  appliedAt: string;
+  migrationIds: string[];
+}
 interface AppliedMigrationsState {
   version: 1;
   migrations: AppliedMigrationEntry[];
+  runs?: AppliedMigrationRun[];
 }
 //#endregion
 //#region src/Collection.d.ts
@@ -2262,6 +2268,22 @@ declare class MigrateCommand extends Command<CliApp> {
   private loadMigrationClassesFromFile;
 }
 //#endregion
+//#region src/cli/commands/MigrateRollbackCommand.d.ts
+/**
+ * Rollback migration classes from the Prisma schema and run Prisma workflow.
+ * By default, rolls back classes applied in the last migrate run.
+ *
+ * @author Legacy (3m1n3nc3)
+ * @since 0.2.4
+ */
+declare class MigrateRollbackCommand extends Command<CliApp> {
+  protected signature: string;
+  protected description: string;
+  handle(): Promise<undefined>;
+  private loadAllMigrations;
+  private loadMigrationClassesFromFile;
+}
+//#endregion
 //#region src/cli/commands/MigrationHistoryCommand.d.ts
 /**
  * The MigrationHistoryCommand class manages tracked migration run history.
@@ -2764,6 +2786,11 @@ declare const writeAppliedMigrationsState: (stateFilePath: string, state: Applie
 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;
+declare const removeAppliedMigration: (state: AppliedMigrationsState, identity: string) => AppliedMigrationsState;
+declare const buildMigrationRunId: () => string;
+declare const markMigrationRun: (state: AppliedMigrationsState, run: AppliedMigrationRun) => AppliedMigrationsState;
+declare const getLastMigrationRun: (state: AppliedMigrationsState) => AppliedMigrationRun | undefined;
+declare const getLatestAppliedMigrations: (state: AppliedMigrationsState, steps: number) => AppliedMigrationEntry[];
 //#endregion
 //#region src/helpers/migrations.d.ts
 declare const PRISMA_MODEL_REGEX: RegExp;
@@ -2990,6 +3017,18 @@ declare const applyMigrationToPrismaSchema: (migration: Migration | (new () => M
   schemaPath: string;
   operations: SchemaOperation[];
 }>;
+/**
+ * Apply the rollback (down) operations defined in a migration to a Prisma schema file.
+ *
+ * @param migration The migration class or instance to rollback.
+ * @param options   Options for applying the rollback, including schema path and write flag.
+ * @returns         A promise that resolves to an object containing the updated schema, schema path, and rollback operations applied.
+ */
+declare const applyMigrationRollbackToPrismaSchema: (migration: Migration | (new () => Migration), options?: PrismaSchemaSyncOptions) => Promise<{
+  schema: string;
+  schemaPath: string;
+  operations: SchemaOperation[];
+}>;
 /**
  * Run a migration by applying its schema operations to a Prisma schema
  * file, optionally generating Prisma client code and running migrations after
@@ -3114,4 +3153,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, 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 };
+export { ArkormCollection, ArkormException, CliApp, ForeignKeyBuilder, InitCommand, InlineFactory, LengthAwarePaginator, MIGRATION_BRAND, MakeFactoryCommand, MakeMigrationCommand, MakeModelCommand, MakeSeederCommand, MigrateCommand, MigrateRollbackCommand, 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, applyMigrationRollbackToPrismaSchema, applyMigrationToPrismaSchema, applyOperationsToPrismaSchema, buildFieldLine, buildIndexLine, buildInverseRelationLine, buildMigrationIdentity, buildMigrationRunId, buildMigrationSource, buildModelBlock, buildRelationLine, computeMigrationChecksum, configureArkormRuntime, createMigrationTimestamp, createPrismaAdapter, createPrismaDelegateMap, defineConfig, defineFactory, deriveCollectionFieldName, deriveInverseRelationAlias, deriveRelationFieldName, ensureArkormConfigLoading, escapeRegex, findAppliedMigration, findModelBlock, formatDefaultValue, formatRelationAction, generateMigrationFile, getDefaultStubsPath, getLastMigrationRun, getLatestAppliedMigrations, getMigrationPlan, getRuntimePaginationURLDriverFactory, getRuntimePrismaClient, getUserConfig, inferDelegateName, isDelegateLike, isMigrationApplied, loadArkormConfig, markMigrationApplied, markMigrationRun, pad, readAppliedMigrationsState, removeAppliedMigration, resetArkormRuntimeForTests, resolveCast, resolveMigrationClassName, resolveMigrationStateFilePath, resolvePrismaType, runMigrationWithPrisma, runPrismaCommand, toMigrationFileSlug, toModelName, writeAppliedMigrationsState };

package/dist/index.d.mts

@@ -86,9 +86,15 @@ interface AppliedMigrationEntry {
   appliedAt: string;
   checksum?: string;
 }
+interface AppliedMigrationRun {
+  id: string;
+  appliedAt: string;
+  migrationIds: string[];
+}
 interface AppliedMigrationsState {
   version: 1;
   migrations: AppliedMigrationEntry[];
+  runs?: AppliedMigrationRun[];
 }
 //#endregion
 //#region src/Collection.d.ts
@@ -2262,6 +2268,22 @@ declare class MigrateCommand extends Command<CliApp> {
   private loadMigrationClassesFromFile;
 }
 //#endregion
+//#region src/cli/commands/MigrateRollbackCommand.d.ts
+/**
+ * Rollback migration classes from the Prisma schema and run Prisma workflow.
+ * By default, rolls back classes applied in the last migrate run.
+ *
+ * @author Legacy (3m1n3nc3)
+ * @since 0.2.4
+ */
+declare class MigrateRollbackCommand extends Command<CliApp> {
+  protected signature: string;
+  protected description: string;
+  handle(): Promise<undefined>;
+  private loadAllMigrations;
+  private loadMigrationClassesFromFile;
+}
+//#endregion
 //#region src/cli/commands/MigrationHistoryCommand.d.ts
 /**
  * The MigrationHistoryCommand class manages tracked migration run history.
@@ -2764,6 +2786,11 @@ declare const writeAppliedMigrationsState: (stateFilePath: string, state: Applie
 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;
+declare const removeAppliedMigration: (state: AppliedMigrationsState, identity: string) => AppliedMigrationsState;
+declare const buildMigrationRunId: () => string;
+declare const markMigrationRun: (state: AppliedMigrationsState, run: AppliedMigrationRun) => AppliedMigrationsState;
+declare const getLastMigrationRun: (state: AppliedMigrationsState) => AppliedMigrationRun | undefined;
+declare const getLatestAppliedMigrations: (state: AppliedMigrationsState, steps: number) => AppliedMigrationEntry[];
 //#endregion
 //#region src/helpers/migrations.d.ts
 declare const PRISMA_MODEL_REGEX: RegExp;
@@ -2990,6 +3017,18 @@ declare const applyMigrationToPrismaSchema: (migration: Migration | (new () => M
   schemaPath: string;
   operations: SchemaOperation[];
 }>;
+/**
+ * Apply the rollback (down) operations defined in a migration to a Prisma schema file.
+ *
+ * @param migration The migration class or instance to rollback.
+ * @param options   Options for applying the rollback, including schema path and write flag.
+ * @returns         A promise that resolves to an object containing the updated schema, schema path, and rollback operations applied.
+ */
+declare const applyMigrationRollbackToPrismaSchema: (migration: Migration | (new () => Migration), options?: PrismaSchemaSyncOptions) => Promise<{
+  schema: string;
+  schemaPath: string;
+  operations: SchemaOperation[];
+}>;
 /**
  * Run a migration by applying its schema operations to a Prisma schema
  * file, optionally generating Prisma client code and running migrations after
@@ -3114,4 +3153,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, 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 };
+export { ArkormCollection, ArkormException, CliApp, ForeignKeyBuilder, InitCommand, InlineFactory, LengthAwarePaginator, MIGRATION_BRAND, MakeFactoryCommand, MakeMigrationCommand, MakeModelCommand, MakeSeederCommand, MigrateCommand, MigrateRollbackCommand, 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, applyMigrationRollbackToPrismaSchema, applyMigrationToPrismaSchema, applyOperationsToPrismaSchema, buildFieldLine, buildIndexLine, buildInverseRelationLine, buildMigrationIdentity, buildMigrationRunId, buildMigrationSource, buildModelBlock, buildRelationLine, computeMigrationChecksum, configureArkormRuntime, createMigrationTimestamp, createPrismaAdapter, createPrismaDelegateMap, defineConfig, defineFactory, deriveCollectionFieldName, deriveInverseRelationAlias, deriveRelationFieldName, ensureArkormConfigLoading, escapeRegex, findAppliedMigration, findModelBlock, formatDefaultValue, formatRelationAction, generateMigrationFile, getDefaultStubsPath, getLastMigrationRun, getLatestAppliedMigrations, getMigrationPlan, getRuntimePaginationURLDriverFactory, getRuntimePrismaClient, getUserConfig, inferDelegateName, isDelegateLike, isMigrationApplied, loadArkormConfig, markMigrationApplied, markMigrationRun, pad, readAppliedMigrationsState, removeAppliedMigration, resetArkormRuntimeForTests, resolveCast, resolveMigrationClassName, resolveMigrationStateFilePath, resolvePrismaType, runMigrationWithPrisma, runPrismaCommand, toMigrationFileSlug, toModelName, writeAppliedMigrationsState };