peta-migrate 0.2.2 → 0.3.0

package/README.md

@@ -86,13 +86,13 @@ Creates a generator that produces migration code from model definitions.
 ### Configuration
 
 ```ts
-import { defineConfig } from "peta-migrate"
+import type { PetaMigrateConfig } from "peta-migrate"
 
-const config = defineConfig({
+const config: PetaMigrateConfig = {
   migrationsDir: "./migrations",
   models: ["./src/models/*.ts"],
   getKysely: () => db,
-})
+}
 ```
 
 | Option | Type | Description |

package/dist/cli.mjs

@@ -1,5 +1,5 @@
-import { a as createMigrationGenerator, c as loadConfig, d as computeChecksum, f as loadChecksums, i as createMigrationRunner, l as loadMigrationFiles, m as verifyChecksum, n as loadSnapshot, o as diffSnapshots, p as saveChecksums, r as saveSnapshot, t as createSnapshot, u as loadModels } from "./snapshot-CO180dF3.mjs";
-import { mkdirSync, writeFileSync } from "node:fs";
+import { a as createMigrationGenerator, c as loadConfig, d as computeChecksum, f as loadChecksums, i as createMigrationRunner, l as loadMigrationFiles, m as verifyChecksum, n as loadSnapshot, p as saveChecksums, r as saveSnapshot, s as diffSnapshots, t as createSnapshot, u as loadModels } from "./snapshot-CWK4gVnT.mjs";
+import { mkdirSync, readdirSync, writeFileSync } from "node:fs";
 import { resolve } from "node:path";
 import cac from "cac";
 import ora from "ora";
@@ -24,7 +24,7 @@ async function run() {
 		spinner.text = "Generating migration...";
 		const gen = createMigrationGenerator();
 		const snapshotPath = resolve(config.migrationsDir, "snapshot.json");
-		const prevSnapshot = await loadSnapshot(snapshotPath);
+		const prevSnapshot = loadSnapshot(snapshotPath);
 		let code;
 		if (prevSnapshot) {
 			const currentSnapshot = createSnapshot(models);
@@ -33,12 +33,12 @@ async function run() {
 				spinner.succeed("No schema changes detected since last snapshot.");
 				return;
 			}
-			code = gen.generateMigrationFromDiff(diffs, { name: name ?? "changes" });
-			await saveSnapshot(snapshotPath, currentSnapshot);
+			code = gen.generateMigrationFromDiff(diffs);
+			saveSnapshot(snapshotPath, currentSnapshot);
 			spinner.text = `Generated incremental migration (${diffs.length} change(s))`;
 		} else {
 			code = gen.generateInitialMigration(models);
-			await saveSnapshot(snapshotPath, createSnapshot(models));
+			saveSnapshot(snapshotPath, createSnapshot(models));
 			spinner.text = `Generated initial migration (${models.size} model(s))`;
 		}
 		const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[-:T.Z]/g, "").slice(0, 14);
@@ -54,7 +54,7 @@ async function run() {
 	});
 	cli.command("migrate:diff", "Preview schema changes without writing a migration").action(async () => {
 		const config = await loadConfig();
-		const prevSnapshot = await loadSnapshot(resolve(config.migrationsDir, "snapshot.json"));
+		const prevSnapshot = loadSnapshot(resolve(config.migrationsDir, "snapshot.json"));
 		if (!prevSnapshot) {
 			console.log("No snapshot found. Run `migrate:generate` first to create one.");
 			return;
@@ -145,9 +145,9 @@ async function run() {
 			return;
 		}
 		spinner.text = "Pushing schema to database...";
-		const { pushSchema } = await import("./pusher-Be3BYUQM.mjs").then((n) => n.n);
+		const { pushSchema } = await import("./pusher-DZQMrZdN.mjs").then((n) => n.n);
 		const created = await pushSchema(config.getKysely(), models);
-		await saveSnapshot(resolve(config.migrationsDir, "snapshot.json"), createSnapshot(models));
+		saveSnapshot(resolve(config.migrationsDir, "snapshot.json"), createSnapshot(models));
 		if (created.length === 0) spinner.succeed("Schema is up to date (no new tables).");
 		else spinner.succeed(`Created tables: ${created.join(", ")}`);
 	});
@@ -161,18 +161,26 @@ async function run() {
 			writeFileSync(filename, `import type { Kysely } from "kysely"\n\nexport async function seed(db: Kysely<any>): Promise<void> {\n  // TODO: add seed data\n}\n`);
 			spinner.succeed(`Created ${filename}`);
 		} else {
-			const { readdirSync } = await import("node:fs");
 			const spinner = ora("Running seeds...").start();
 			const seedFiles = readdirSync(config.migrationsDir).filter((f) => f.includes("_seed_") && (f.endsWith(".ts") || f.endsWith(".js"))).sort();
 			if (seedFiles.length === 0) {
 				spinner.warn("No seed files found.");
 				return;
 			}
-			for (const file of seedFiles) {
+			let passed = 0;
+			let failed = 0;
+			for (const file of seedFiles) try {
 				const mod = await import(resolve(config.migrationsDir, file));
-				if (mod.seed) await mod.seed(config.getKysely());
+				if (mod.seed) {
+					await mod.seed(config.getKysely());
+					passed++;
+				}
+			} catch (err) {
+				console.error(`❌ Seed "${file}" failed:`, err.message);
+				failed++;
 			}
-			spinner.succeed(`Executed ${seedFiles.length} seed(s)`);
+			if (failed === 0) spinner.succeed(`Executed ${passed} seed(s)`);
+			else spinner.fail(`Executed ${passed} seed(s), ${failed} failed`);
 		}
 	});
 	cli.help();

package/dist/index.d.mts

@@ -42,11 +42,6 @@ interface PetaMigrateConfig {
   models: string[] | string;
   getKysely: () => Kysely<unknown>;
 }
-interface ResolvedConfig {
-  migrationsDir: string;
-  models: string[] | string;
-  getKysely: () => Kysely<unknown>;
-}
 interface SchemaColumn {
   name: string;
   type: string;
@@ -81,8 +76,7 @@ interface SchemaDiff {
 }
 //#endregion
 //#region src/config.d.ts
-declare function defineConfig(config: PetaMigrateConfig): PetaMigrateConfig;
-declare function loadConfig(): Promise<ResolvedConfig>;
+declare function loadConfig(): Promise<PetaMigrateConfig>;
 declare function loadMigrationFiles(dir: string): Promise<MigrationFile[]>;
 /**
  * Load model definitions from glob patterns.
@@ -99,14 +93,11 @@ declare function loadModels(patterns: string | string[]): Promise<Map<string, Mo
 declare function diffSnapshots(prev: SchemaSnapshot, next: SchemaSnapshot): SchemaDiff[];
 //#endregion
 //#region src/generator.d.ts
-interface GeneratorOptions {
-  name?: string;
-}
-interface MigrationGenerator {
-  generateInitialMigration(models: Map<string, ModelDefinition>, options?: GeneratorOptions): string;
-  generateMigrationFromDiff(diffs: SchemaDiff[], options?: GeneratorOptions): string;
-}
-declare function createMigrationGenerator(): MigrationGenerator;
+declare function createMigrationGenerator(): {
+  generateInitialMigration: (models: Map<string, ModelDefinition>) => string;
+  generateMigrationFromDiff: (diffs: SchemaDiff[]) => string;
+};
+type MigrationGenerator = ReturnType<typeof createMigrationGenerator>;
 //#endregion
 //#region src/pusher.d.ts
 /**
@@ -117,14 +108,14 @@ declare function createMigrationGenerator(): MigrationGenerator;
 declare function pushSchema(db: Kysely<unknown>, models: Map<string, ModelDefinition>): Promise<string[]>;
 //#endregion
 //#region src/runner.d.ts
-interface MigrationRunner {
-  ensureTable(): Promise<void>;
-  getCompleted(): Promise<MigrationRecord[]>;
-  up(migrations: MigrationFile[]): Promise<void>;
-  down(migrations: MigrationFile[]): Promise<void>;
-  status(migrations: MigrationFile[]): Promise<MigrationStatus>;
-}
-declare function createMigrationRunner(db: Kysely<Record<string, never>>, table?: string): MigrationRunner;
+declare function createMigrationRunner(db: Kysely<any>, table?: string): {
+  ensureTable: () => Promise<void>;
+  getCompleted: () => Promise<MigrationRecord[]>;
+  up: (migrations: MigrationFile[]) => Promise<void>;
+  down: (migrations: MigrationFile[]) => Promise<void>;
+  status: (migrations: MigrationFile[]) => Promise<MigrationStatus>;
+};
+type MigrationRunner = ReturnType<typeof createMigrationRunner>;
 //#endregion
 //#region src/snapshot.d.ts
 /**
@@ -133,11 +124,13 @@ declare function createMigrationRunner(db: Kysely<Record<string, never>>, table?
 declare function createSnapshot(models: Map<string, ModelDefinition>): SchemaSnapshot;
 /**
  * Load snapshot from a JSON file path.
+ * Returns null when the file doesn't exist.
+ * Throws when the file is corrupt or has an invalid shape.
  */
-declare function loadSnapshot(filePath: string): Promise<SchemaSnapshot | null>;
+declare function loadSnapshot(filePath: string): SchemaSnapshot | null;
 /**
  * Save snapshot to a JSON file path.
  */
-declare function saveSnapshot(filePath: string, snapshot: SchemaSnapshot): Promise<void>;
+declare function saveSnapshot(filePath: string, snapshot: SchemaSnapshot): void;
 //#endregion
-export { type GeneratorOptions, type MigrationFile, type MigrationGenerator, type MigrationRecord, type MigrationRunner, type MigrationStatus, type PetaMigrateConfig, type ResolvedConfig, type SchemaColumn, type SchemaDiff, type SchemaIndex, type SchemaSnapshot, type SchemaTable, computeChecksum, createMigrationGenerator, createMigrationRunner, createSnapshot, defineConfig, diffSnapshots, loadChecksums, loadConfig, loadMigrationFiles, loadModels, loadSnapshot, pushSchema, saveChecksums, saveSnapshot, verifyChecksum };
+export { type MigrationFile, type MigrationGenerator, type MigrationRecord, type MigrationRunner, type MigrationStatus, type PetaMigrateConfig, type SchemaColumn, type SchemaDiff, type SchemaIndex, type SchemaSnapshot, type SchemaTable, computeChecksum, createMigrationGenerator, createMigrationRunner, createSnapshot, diffSnapshots, loadChecksums, loadConfig, loadMigrationFiles, loadModels, loadSnapshot, pushSchema, saveChecksums, saveSnapshot, verifyChecksum };

package/dist/index.mjs

@@ -1,3 +1,3 @@
-import { t as pushSchema } from "./pusher-Be3BYUQM.mjs";
-import { a as createMigrationGenerator, c as loadConfig, d as computeChecksum, f as loadChecksums, i as createMigrationRunner, l as loadMigrationFiles, m as verifyChecksum, n as loadSnapshot, o as diffSnapshots, p as saveChecksums, r as saveSnapshot, s as defineConfig, t as createSnapshot, u as loadModels } from "./snapshot-CO180dF3.mjs";
-export { computeChecksum, createMigrationGenerator, createMigrationRunner, createSnapshot, defineConfig, diffSnapshots, loadChecksums, loadConfig, loadMigrationFiles, loadModels, loadSnapshot, pushSchema, saveChecksums, saveSnapshot, verifyChecksum };
+import { t as pushSchema } from "./pusher-DZQMrZdN.mjs";
+import { a as createMigrationGenerator, c as loadConfig, d as computeChecksum, f as loadChecksums, i as createMigrationRunner, l as loadMigrationFiles, m as verifyChecksum, n as loadSnapshot, p as saveChecksums, r as saveSnapshot, s as diffSnapshots, t as createSnapshot, u as loadModels } from "./snapshot-CWK4gVnT.mjs";
+export { computeChecksum, createMigrationGenerator, createMigrationRunner, createSnapshot, diffSnapshots, loadChecksums, loadConfig, loadMigrationFiles, loadModels, loadSnapshot, pushSchema, saveChecksums, saveSnapshot, verifyChecksum };

package/dist/{pusher-Be3BYUQM.mjs → pusher-DZQMrZdN.mjs}

@@ -1,3 +1,4 @@
+import { o as columnDataTypeToSql } from "./snapshot-CWK4gVnT.mjs";
 //#region \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
 var __exportAll = (all, no_symbols) => {
@@ -24,7 +25,7 @@ async function pushSchema(db, models) {
 		if (await tableExists(db, model.table)) continue;
 		let qb = db.schema.createTable(model.table).ifNotExists();
 		const columns = model.columns;
-		for (const [name, col] of Object.entries(columns)) qb = qb.addColumn(name, mapPushType(col), (cb) => buildColumn(col, cb));
+		for (const [name, col] of Object.entries(columns)) qb = qb.addColumn(name, columnDataTypeToSql(col.dataType, col.args), (cb) => buildColumn(col, cb));
 		await qb.execute();
 		createdTables.push(model.table);
 		for (const [colName, col] of Object.entries(columns)) if (col.hasConstraint("index") && !col.isPrimaryKey && !col.isUnique) await db.schema.createIndex(`${model.table}_${colName}_index`).on(model.table).column(colName).execute();
@@ -57,32 +58,5 @@ function buildColumn(col, cb) {
 	}
 	return cb;
 }
-function mapPushType(col) {
-	switch (col.dataType) {
-		case "integer":
-		case "smallint":
-		case "bigint":
-		case "text":
-		case "boolean":
-		case "timestamp":
-		case "date":
-		case "float":
-		case "double":
-		case "uuid": return col.dataType;
-		case "string": {
-			const max = col.args[0];
-			return max != null ? `varchar(${max})` : "varchar";
-		}
-		case "json":
-		case "jsonb": return "json";
-		case "decimal": {
-			const p = col.args[0];
-			const s = col.args[1];
-			return p != null ? `decimal(${p}, ${s ?? 0})` : "decimal";
-		}
-		case "enum": return "text";
-		default: return col.dataType;
-	}
-}
 //#endregion
 export { pusher_exports as n, pushSchema as t };

package/dist/{snapshot-CO180dF3.mjs → snapshot-CWK4gVnT.mjs}

@@ -1,5 +1,5 @@
 import { createHash } from "node:crypto";
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { existsSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
 import { resolve } from "node:path";
 import { Migrator } from "kysely/migration";
 //#region src/checksum.ts
@@ -39,9 +39,6 @@ function verifyChecksum(migrationsDir, name, filePath) {
 }
 //#endregion
 //#region src/config.ts
-function defineConfig(config) {
-	return config;
-}
 async function loadConfig() {
 	const candidates = [
 		"peta.config.ts",
@@ -52,8 +49,13 @@ async function loadConfig() {
 	for (const file of candidates) try {
 		mod = await import(resolve(process.cwd(), file));
 		break;
-	} catch {}
-	if (!mod) throw new Error("No peta.config.ts found. Create one in your project root.");
+	} catch (err) {
+		console.warn(`⚠ Failed to load config from "${file}":`, err.message);
+	}
+	if (!mod) {
+		const tried = candidates.map((f) => `\`${resolve(process.cwd(), f)}\``).join(", ");
+		throw new Error(`No configuration file found. Tried: ${tried}.\nCreate one in your project root and export a PetaMigrateConfig object.`);
+	}
 	const config = mod.default ?? mod;
 	return {
 		migrationsDir: config.migrationsDir,
@@ -62,8 +64,14 @@ async function loadConfig() {
 	};
 }
 async function loadMigrationFiles(dir) {
-	const { readdirSync } = await import("node:fs");
-	const files = readdirSync(dir).filter((f) => f.endsWith(".ts") || f.endsWith(".js")).sort();
+	let files;
+	try {
+		files = readdirSync(dir);
+	} catch (err) {
+		if (err.code === "ENOENT") throw new Error(`Migrations directory "${dir}" not found. Run \`peta migrate:init\` to create it.`);
+		throw err;
+	}
+	files = files.filter((f) => f.endsWith(".ts") || f.endsWith(".js")).sort();
 	const migrations = [];
 	for (const file of files) {
 		const mod = await import(resolve(dir, file));
@@ -87,9 +95,7 @@ async function loadModels(patterns) {
 	for (const raw of patternList) {
 		let pattern = raw;
 		if (!pattern.startsWith("/")) pattern = resolve(cwd, pattern);
-		const glob = new Bun.Glob(pattern);
-		const files = Array.from(glob.scanSync(cwd));
-		for (const file of files) {
+		for (const file of new Bun.Glob(pattern).scanSync({ cwd })) {
 			const fullPath = resolve(cwd, file);
 			try {
 				const mod = await import(fullPath);
@@ -194,9 +200,32 @@ function columnsDiffer(a, b) {
 	return false;
 }
 //#endregion
+//#region src/column-mapper.ts
+/**
+* Map a Column's dataType + args to a SQL type string.
+* Extracted from snapshot.ts, pusher.ts, generator.ts (which each had an identical copy).
+*/
+function columnDataTypeToSql(dataType, args) {
+	switch (dataType) {
+		case "string": {
+			const max = args[0];
+			return max != null ? `varchar(${max})` : "varchar";
+		}
+		case "json":
+		case "jsonb": return "json";
+		case "decimal": {
+			const p = args[0];
+			const s = args[1];
+			return p != null ? `decimal(${p}, ${s ?? 0})` : "decimal";
+		}
+		case "enum": return "text";
+		default: return dataType;
+	}
+}
+//#endregion
 //#region src/generator.ts
 function createMigrationGenerator() {
-	function generateInitialMigration(models, _options = {}) {
+	function generateInitialMigration(models) {
 		const parts = [];
 		const indexParts = [];
 		const warnings = [];
@@ -205,7 +234,7 @@ function createMigrationGenerator() {
 			const table = modelDef.table;
 			if (!table) continue;
 			parts.push(generateCreateTable(table, modelDef.columns));
-			for (const [colName, col] of Object.entries(modelDef.columns)) if (col.hasConstraint("index") && !col.isPrimaryKey && !col.isUnique) indexParts.push(generateCreateIndex(table, colName));
+			for (const [colName, col] of Object.entries(modelDef.columns)) if (col.hasConstraint("index") && !col.isPrimaryKey && !col.isUnique) indexParts.push(generateCreateIndexFromSchema(table, `${table}_${colName}_index`, [colName]));
 			for (const [, rel] of Object.entries(modelDef.relations ?? {})) if (rel.type === "manyToMany") {
 				const through = rel.throughTable;
 				if (through && !registeredTables.has(through)) warnings.push(`// ⚠ Detected ManyToMany "${modelDef.name}" references table "${through}" but no model is registered for it.\n//   Add a model to include the pivot table.`);
@@ -213,9 +242,9 @@ function createMigrationGenerator() {
 		}
 		const upBody = [...parts, ...indexParts].join("\n\n");
 		const downTables = [...models.values()].filter((m) => m.table).map((m) => `  await db.schema.dropTable("${m.table}").ifExists().execute()`).join("\n");
-		return `import type { Kysely } from "kysely"\nimport { sql } from "kysely"\n\nexport async function up(db: Kysely<any>): Promise<void> {\n${warnings.length > 0 ? `  // Warnings:\n${warnings.join("\n")}\n\n` : ""}${upBody}\n}\n\nexport async function down(db: Kysely<any>): Promise<void> {\n${downTables}\n}\n`;
+		return `import type { Kysely } from "kysely"\n\nexport async function up(db: Kysely<any>): Promise<void> {\n${warnings.length > 0 ? `  // Warnings:\n${warnings.join("\n")}\n\n` : ""}${upBody}\n}\n\nexport async function down(db: Kysely<any>): Promise<void> {\n${downTables}\n}\n`;
 	}
-	function generateMigrationFromDiff(diffs, _options = {}) {
+	function generateMigrationFromDiff(diffs) {
 		const upParts = [];
 		const downParts = [];
 		const warnings = [];
@@ -273,7 +302,7 @@ function createMigrationGenerator() {
 		}
 		const upBody = upParts.join("\n\n");
 		const downBody = downParts.join("\n\n");
-		return `import type { Kysely } from "kysely"\nimport { sql } from "kysely"\n\nexport async function up(db: Kysely<any>): Promise<void> {\n${warnings.length > 0 ? `  // Warnings:\n${warnings.join("\n")}\n\n` : ""}${upBody}\n}\n\nexport async function down(db: Kysely<any>): Promise<void> {\n${downBody}\n}\n`;
+		return `import type { Kysely } from "kysely"\n\nexport async function up(db: Kysely<any>): Promise<void> {\n${warnings.length > 0 ? `  // Warnings:\n${warnings.join("\n")}\n\n` : ""}${upBody}\n}\n\nexport async function down(db: Kysely<any>): Promise<void> {\n${downBody}\n}\n`;
 	}
 	return {
 		generateInitialMigration,
@@ -282,7 +311,7 @@ function createMigrationGenerator() {
 }
 function generateCreateTable(table, columns) {
 	const lines = [`  await db.schema.createTable("${table}").ifNotExists()`];
-	for (const [name, col] of Object.entries(columns)) lines.push(`    .addColumn("${name}", "${mapType(col)}"${columnCallback(col)})`);
+	for (const [name, col] of Object.entries(columns)) lines.push(`    .addColumn("${name}", "${columnDataTypeToSql(col.dataType, col.args)}"${columnCallback(col)})`);
 	lines.push("    .execute()");
 	return lines.join("\n");
 }
@@ -301,14 +330,6 @@ function generateCreateTableFromSchema(table, columns) {
 	lines.push("    .execute()");
 	return lines.join("\n");
 }
-function generateCreateIndex(table, column) {
-	return [
-		`  await db.schema.createIndex("${table}_${column}_index")`,
-		`    .on("${table}")`,
-		`    .column("${column}")`,
-		"    .execute()"
-	].join("\n");
-}
 function generateCreateIndexFromSchema(table, indexName, columns) {
 	const lines = [`  await db.schema.createIndex("${indexName}").on("${table}")`];
 	for (const col of columns) lines.push(`    .column("${col}")`);
@@ -342,33 +363,6 @@ function columnCallbackFromSchema(col) {
 	if (col.references) calls.push(`references("${col.references.table}.${col.references.column}")`);
 	return calls.length === 0 ? "" : `, (c) => c.${calls.join(".")}`;
 }
-function mapType(col) {
-	switch (col.dataType) {
-		case "integer":
-		case "smallint":
-		case "bigint":
-		case "text":
-		case "boolean":
-		case "timestamp":
-		case "date":
-		case "float":
-		case "double":
-		case "uuid": return col.dataType;
-		case "string": {
-			const max = col.args[0];
-			return max != null ? `varchar(${max})` : "varchar";
-		}
-		case "json":
-		case "jsonb": return "json";
-		case "decimal": {
-			const p = col.args[0];
-			const s = col.args[1];
-			return p != null ? `decimal(${p}, ${s ?? 0})` : "decimal";
-		}
-		case "enum": return "text";
-		default: return col.dataType;
-	}
-}
 //#endregion
 //#region src/runner.ts
 function createMigrationRunner(db, table = "_peta_migrations") {
@@ -488,7 +482,7 @@ function columnToSchema(name, col) {
 	}
 	return {
 		name,
-		type: mapSnapshotType(col),
+		type: columnDataTypeToSql(col.dataType, col.args),
 		isNullable: col.isNullable ?? false,
 		isPrimaryKey: col.isPrimaryKey ?? false,
 		isUnique: col.isUnique ?? false,
@@ -496,51 +490,37 @@ function columnToSchema(name, col) {
 		references
 	};
 }
-function mapSnapshotType(col) {
-	switch (col.dataType) {
-		case "integer":
-		case "smallint":
-		case "bigint":
-		case "text":
-		case "boolean":
-		case "timestamp":
-		case "date":
-		case "float":
-		case "double":
-		case "uuid": return col.dataType;
-		case "string": {
-			const max = col.args[0];
-			return max != null ? `varchar(${max})` : "varchar";
-		}
-		case "json":
-		case "jsonb": return "json";
-		case "decimal": {
-			const p = col.args[0];
-			const s = col.args[1];
-			return p != null ? `decimal(${p}, ${s ?? 0})` : "decimal";
-		}
-		case "enum": return "text";
-		default: return col.dataType;
-	}
-}
 /**
 * Load snapshot from a JSON file path.
+* Returns null when the file doesn't exist.
+* Throws when the file is corrupt or has an invalid shape.
 */
-async function loadSnapshot(filePath) {
+function loadSnapshot(filePath) {
+	let raw;
 	try {
-		const { readFileSync } = await import("node:fs");
-		const data = readFileSync(filePath, "utf-8");
-		return JSON.parse(data);
+		raw = readFileSync(filePath, "utf-8");
 	} catch {
 		return null;
 	}
+	let parsed;
+	try {
+		parsed = JSON.parse(raw);
+	} catch {
+		throw new Error(`Corrupt snapshot file "${filePath}". Delete it and re-run \`peta migrate:generate\` to recreate it.`);
+	}
+	if (!isSchemaSnapshot(parsed)) throw new Error(`Invalid snapshot shape in "${filePath}". Delete it and re-run \`peta migrate:generate\` to recreate it.`);
+	return parsed;
+}
+function isSchemaSnapshot(value) {
+	if (typeof value !== "object" || value === null) return false;
+	const obj = value;
+	return obj.version === 1 && Array.isArray(obj.tables) && obj.tables.every((t) => typeof t === "object" && t !== null && typeof t.name === "string" && Array.isArray(t.columns));
 }
 /**
 * Save snapshot to a JSON file path.
 */
-async function saveSnapshot(filePath, snapshot) {
-	const { writeFileSync } = await import("node:fs");
+function saveSnapshot(filePath, snapshot) {
 	writeFileSync(filePath, JSON.stringify(snapshot, null, 2));
 }
 //#endregion
-export { createMigrationGenerator as a, loadConfig as c, computeChecksum as d, loadChecksums as f, createMigrationRunner as i, loadMigrationFiles as l, verifyChecksum as m, loadSnapshot as n, diffSnapshots as o, saveChecksums as p, saveSnapshot as r, defineConfig as s, createSnapshot as t, loadModels as u };
+export { createMigrationGenerator as a, loadConfig as c, computeChecksum as d, loadChecksums as f, createMigrationRunner as i, loadMigrationFiles as l, verifyChecksum as m, loadSnapshot as n, columnDataTypeToSql as o, saveChecksums as p, saveSnapshot as r, diffSnapshots as s, createSnapshot as t, loadModels as u };

package/package.json

@@ -2,7 +2,7 @@
   "name": "peta-migrate",
   "type": "module",
   "private": false,
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "Migration tools for peta-orm",
   "license": "MIT",
   "repository": {