import { createHash } from "node:crypto"; import { readdir, readFile } from "node:fs/promises"; import path from "node:path"; import type { Db } from "../config/db.js"; export interface MigrationFile { version: string; file: string; sql: string; checksum: string; } export interface MigrationResult { applied: string[]; skipped: string[]; drifted: { version: string; recorded: string; current: string }[]; } const FILE_PATTERN = /^(\d{3,4}_[a-z0-9_]+)\.sql$/; export const listMigrations = async (dir: string): Promise => { const entries = await readdir(dir); const files = entries.filter((entry) => FILE_PATTERN.test(entry)).sort(); return Promise.all( files.map(async (file) => { const sql = await readFile(path.join(dir, file), "utf8"); return { version: FILE_PATTERN.exec(file)?.[1] ?? file, file, sql, checksum: createHash("sha256").update(sql).digest("hex"), }; }), ); }; const ensureLedger = async (db: Db): Promise => { await db.raw(` CREATE TABLE IF NOT EXISTS schema_migrations ( version VARCHAR(64) NOT NULL, applied_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (version) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci `); await db.raw( "ALTER TABLE schema_migrations ADD COLUMN IF NOT EXISTS checksum CHAR(64) NULL AFTER applied_at", ); }; export const runMigrations = async ( db: Db, dir: string, options: { dryRun?: boolean } = {}, ): Promise => { const files = await listMigrations(dir); await ensureLedger(db); const applied = new Map(); const rows = await db.query<{ version: string; checksum: string | null }>( "SELECT version, checksum FROM schema_migrations", ); for (const row of rows) applied.set(row.version, { checksum: row.checksum }); const result: MigrationResult = { applied: [], skipped: [], drifted: [] }; for (const migration of files) { const record = applied.get(migration.version); if (record) { result.skipped.push(migration.version); if (record.checksum && record.checksum !== migration.checksum) { result.drifted.push({ version: migration.version, recorded: record.checksum, current: migration.checksum, }); } continue; } if (options.dryRun) { result.applied.push(migration.version); continue; } const statements = migration.sql .split(/;\s*(?:\r?\n|$)/) .map((statement) => statement .split(/\r?\n/) .filter((line) => !line.trim().startsWith("--")) .join("\n") .trim(), ) .filter((statement) => statement.length > 0); for (const statement of statements) await db.raw(statement); await db.exec("INSERT INTO schema_migrations (version, checksum) VALUES (?, ?)", [ migration.version, migration.checksum, ]); result.applied.push(migration.version); } return result; }; export const assertNoDrift = (result: MigrationResult): void => { if (result.drifted.length === 0) return; const lines = result.drifted.map( (d) => ` ${d.version} : appliquee ${d.recorded.slice(0, 12)}, fichier ${d.current.slice(0, 12)}`, ); throw new Error( `Migrations deja appliquees modifiees depuis leur execution (${result.drifted.length}) :\n` + `${lines.join("\n")}\n` + "Une migration appliquee ne se modifie pas : creez un nouveau fichier.", ); };