@momentumcms/migrations 0.5.9 → 0.5.11

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@momentumcms/migrations",
-	"version": "0.5.9",
+	"version": "0.5.11",
 	"description": "Database migration system for Momentum CMS",
 	"license": "MIT",
 	"main": "./src/index.cjs",

package/src/cli/generate.cjs

@@ -1378,7 +1378,11 @@ function serializeOperationsMeta(operations) {
 var import_node_fs = require("node:fs");
 var import_node_path = require("node:path");
 var SNAPSHOT_FILENAME = ".snapshot.json";
+var PER_MIGRATION_SNAPSHOT_PATTERN = /^\d{14}_.+\.snapshot\.json$/;
 function readSnapshot(directory) {
+  const perMigration = findLatestPerMigrationSnapshot(directory);
+  if (perMigration)
+    return perMigration;
   const filePath = (0, import_node_path.join)(directory, SNAPSHOT_FILENAME);
   if (!(0, import_node_fs.existsSync)(filePath))
     return null;
@@ -1390,6 +1394,21 @@ function writeSnapshot(directory, snapshot) {
   const filePath = (0, import_node_path.join)(directory, SNAPSHOT_FILENAME);
   (0, import_node_fs.writeFileSync)(filePath, serializeSnapshot(snapshot), "utf-8");
 }
+function writePerMigrationSnapshot(directory, migrationName, snapshot) {
+  (0, import_node_fs.mkdirSync)(directory, { recursive: true });
+  const filePath = (0, import_node_path.join)(directory, `${migrationName}.snapshot.json`);
+  (0, import_node_fs.writeFileSync)(filePath, serializeSnapshot(snapshot), "utf-8");
+}
+function findLatestPerMigrationSnapshot(directory) {
+  if (!(0, import_node_fs.existsSync)(directory))
+    return null;
+  const snapshotFiles = (0, import_node_fs.readdirSync)(directory).filter((f) => PER_MIGRATION_SNAPSHOT_PATTERN.test(f)).sort();
+  if (snapshotFiles.length === 0)
+    return null;
+  const latestFile = snapshotFiles[snapshotFiles.length - 1];
+  const json2 = (0, import_node_fs.readFileSync)((0, import_node_path.join)(directory, latestFile), "utf-8");
+  return deserializeSnapshot(json2);
+}
 
 // libs/migrations/src/cli/shared.ts
 var import_node_url = require("node:url");
@@ -1754,7 +1773,7 @@ Would write: ${(0, import_node_path2.join)(directory, `${timestampedName}.ts`)}`
   (0, import_node_fs2.mkdirSync)(directory, { recursive: true });
   const filePath = (0, import_node_path2.join)(directory, `${timestampedName}.ts`);
   (0, import_node_fs2.writeFileSync)(filePath, fileContent, "utf-8");
-  writeSnapshot(directory, desired);
+  writePerMigrationSnapshot(directory, timestampedName, desired);
   console.warn(`
 Generated migration: ${filePath}`);
   console.warn(`Operations: ${diff.operations.length}`);

package/src/cli/generate.js

@@ -1373,10 +1373,14 @@ function serializeOperationsMeta(operations) {
 }
 
 // libs/migrations/src/lib/loader/snapshot-manager.ts
-import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
+import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync } from "node:fs";
 import { join } from "node:path";
 var SNAPSHOT_FILENAME = ".snapshot.json";
+var PER_MIGRATION_SNAPSHOT_PATTERN = /^\d{14}_.+\.snapshot\.json$/;
 function readSnapshot(directory) {
+  const perMigration = findLatestPerMigrationSnapshot(directory);
+  if (perMigration)
+    return perMigration;
   const filePath = join(directory, SNAPSHOT_FILENAME);
   if (!existsSync(filePath))
     return null;
@@ -1388,6 +1392,21 @@ function writeSnapshot(directory, snapshot) {
   const filePath = join(directory, SNAPSHOT_FILENAME);
   writeFileSync(filePath, serializeSnapshot(snapshot), "utf-8");
 }
+function writePerMigrationSnapshot(directory, migrationName, snapshot) {
+  mkdirSync(directory, { recursive: true });
+  const filePath = join(directory, `${migrationName}.snapshot.json`);
+  writeFileSync(filePath, serializeSnapshot(snapshot), "utf-8");
+}
+function findLatestPerMigrationSnapshot(directory) {
+  if (!existsSync(directory))
+    return null;
+  const snapshotFiles = readdirSync(directory).filter((f) => PER_MIGRATION_SNAPSHOT_PATTERN.test(f)).sort();
+  if (snapshotFiles.length === 0)
+    return null;
+  const latestFile = snapshotFiles[snapshotFiles.length - 1];
+  const json2 = readFileSync(join(directory, latestFile), "utf-8");
+  return deserializeSnapshot(json2);
+}
 
 // libs/migrations/src/cli/shared.ts
 import { pathToFileURL } from "node:url";
@@ -1752,7 +1771,7 @@ Would write: ${join2(directory, `${timestampedName}.ts`)}`);
   mkdirSync2(directory, { recursive: true });
   const filePath = join2(directory, `${timestampedName}.ts`);
   writeFileSync2(filePath, fileContent, "utf-8");
-  writeSnapshot(directory, desired);
+  writePerMigrationSnapshot(directory, timestampedName, desired);
   console.warn(`
 Generated migration: ${filePath}`);
   console.warn(`Operations: ${diff.operations.length}`);

package/src/index.cjs

@@ -41,6 +41,7 @@ __export(src_exports, {
   fieldToColumnType: () => fieldToColumnType,
   fieldToPostgresType: () => fieldToPostgresType,
   fieldToSqliteType: () => fieldToSqliteType,
+  findLatestPerMigrationSnapshot: () => findLatestPerMigrationSnapshot,
   generateMigrationFileContent: () => generateMigrationFileContent,
   generateMigrationName: () => generateMigrationName,
   getAppliedMigrations: () => getAppliedMigrations,
@@ -67,6 +68,7 @@ __export(src_exports, {
   runMigrations: () => runMigrations,
   runPush: () => runPush,
   serializeSnapshot: () => serializeSnapshot,
+  writePerMigrationSnapshot: () => writePerMigrationSnapshot,
   writeSnapshot: () => writeSnapshot
 });
 module.exports = __toCommonJS(src_exports);
@@ -2394,7 +2396,11 @@ async function loadMigrationsFromDisk(directory) {
 var import_node_fs2 = require("node:fs");
 var import_node_path2 = require("node:path");
 var SNAPSHOT_FILENAME = ".snapshot.json";
+var PER_MIGRATION_SNAPSHOT_PATTERN = /^\d{14}_.+\.snapshot\.json$/;
 function readSnapshot(directory) {
+  const perMigration = findLatestPerMigrationSnapshot(directory);
+  if (perMigration)
+    return perMigration;
   const filePath = (0, import_node_path2.join)(directory, SNAPSHOT_FILENAME);
   if (!(0, import_node_fs2.existsSync)(filePath))
     return null;
@@ -2406,6 +2412,21 @@ function writeSnapshot(directory, snapshot) {
   const filePath = (0, import_node_path2.join)(directory, SNAPSHOT_FILENAME);
   (0, import_node_fs2.writeFileSync)(filePath, serializeSnapshot(snapshot), "utf-8");
 }
+function writePerMigrationSnapshot(directory, migrationName, snapshot) {
+  (0, import_node_fs2.mkdirSync)(directory, { recursive: true });
+  const filePath = (0, import_node_path2.join)(directory, `${migrationName}.snapshot.json`);
+  (0, import_node_fs2.writeFileSync)(filePath, serializeSnapshot(snapshot), "utf-8");
+}
+function findLatestPerMigrationSnapshot(directory) {
+  if (!(0, import_node_fs2.existsSync)(directory))
+    return null;
+  const snapshotFiles = (0, import_node_fs2.readdirSync)(directory).filter((f) => PER_MIGRATION_SNAPSHOT_PATTERN.test(f)).sort();
+  if (snapshotFiles.length === 0)
+    return null;
+  const latestFile = snapshotFiles[snapshotFiles.length - 1];
+  const json2 = (0, import_node_fs2.readFileSync)((0, import_node_path2.join)(directory, latestFile), "utf-8");
+  return deserializeSnapshot(json2);
+}
 function getSnapshotPath(directory) {
   return (0, import_node_path2.join)(directory, SNAPSHOT_FILENAME);
 }
@@ -2545,6 +2566,7 @@ function parseMigrationArgs(args) {
   fieldToColumnType,
   fieldToPostgresType,
   fieldToSqliteType,
+  findLatestPerMigrationSnapshot,
   generateMigrationFileContent,
   generateMigrationName,
   getAppliedMigrations,
@@ -2571,5 +2593,6 @@ function parseMigrationArgs(args) {
   runMigrations,
   runPush,
   serializeSnapshot,
+  writePerMigrationSnapshot,
   writeSnapshot
 });

package/src/index.d.ts

@@ -30,7 +30,7 @@ export type { CloneCapableDb, CloneTestApplyOptions, CloneTestApplyResult, } fro
 export { createDataHelpers } from './lib/helpers/data-helpers';
 export type { DataHelperDb } from './lib/helpers/data-helpers';
 export { loadMigrationsFromDisk } from './lib/loader/migration-loader';
-export { readSnapshot, writeSnapshot, getSnapshotPath } from './lib/loader/snapshot-manager';
+export { readSnapshot, writeSnapshot, writePerMigrationSnapshot, findLatestPerMigrationSnapshot, getSnapshotPath, } from './lib/loader/snapshot-manager';
 export { resolveDialect, buildTrackerFromAdapter, buildContextFromAdapter, buildPushDbFromAdapter, buildCloneDbFromAdapter, buildIntrospector, parseMigrationArgs, } from './cli/shared';
 export type { MigrationCliArgs } from './cli/shared';
 export * from './lib/migration.types';

package/src/index.js

@@ -2326,10 +2326,14 @@ async function loadMigrationsFromDisk(directory) {
 }
 
 // libs/migrations/src/lib/loader/snapshot-manager.ts
-import { readFileSync, writeFileSync, existsSync as existsSync2, mkdirSync } from "node:fs";
+import { readFileSync, writeFileSync, existsSync as existsSync2, mkdirSync, readdirSync as readdirSync2 } from "node:fs";
 import { join as join2 } from "node:path";
 var SNAPSHOT_FILENAME = ".snapshot.json";
+var PER_MIGRATION_SNAPSHOT_PATTERN = /^\d{14}_.+\.snapshot\.json$/;
 function readSnapshot(directory) {
+  const perMigration = findLatestPerMigrationSnapshot(directory);
+  if (perMigration)
+    return perMigration;
   const filePath = join2(directory, SNAPSHOT_FILENAME);
   if (!existsSync2(filePath))
     return null;
@@ -2341,6 +2345,21 @@ function writeSnapshot(directory, snapshot) {
   const filePath = join2(directory, SNAPSHOT_FILENAME);
   writeFileSync(filePath, serializeSnapshot(snapshot), "utf-8");
 }
+function writePerMigrationSnapshot(directory, migrationName, snapshot) {
+  mkdirSync(directory, { recursive: true });
+  const filePath = join2(directory, `${migrationName}.snapshot.json`);
+  writeFileSync(filePath, serializeSnapshot(snapshot), "utf-8");
+}
+function findLatestPerMigrationSnapshot(directory) {
+  if (!existsSync2(directory))
+    return null;
+  const snapshotFiles = readdirSync2(directory).filter((f) => PER_MIGRATION_SNAPSHOT_PATTERN.test(f)).sort();
+  if (snapshotFiles.length === 0)
+    return null;
+  const latestFile = snapshotFiles[snapshotFiles.length - 1];
+  const json2 = readFileSync(join2(directory, latestFile), "utf-8");
+  return deserializeSnapshot(json2);
+}
 function getSnapshotPath(directory) {
   return join2(directory, SNAPSHOT_FILENAME);
 }
@@ -2479,6 +2498,7 @@ export {
   fieldToColumnType,
   fieldToPostgresType,
   fieldToSqliteType,
+  findLatestPerMigrationSnapshot,
   generateMigrationFileContent,
   generateMigrationName,
   getAppliedMigrations,
@@ -2505,5 +2525,6 @@ export {
   runMigrations,
   runPush,
   serializeSnapshot,
+  writePerMigrationSnapshot,
   writeSnapshot
 };

package/src/lib/loader/snapshot-manager.d.ts

@@ -1,6 +1,7 @@
 import type { DatabaseSchemaSnapshot } from '../schema/schema-snapshot';
 /**
  * Read the schema snapshot from the migrations directory.
+ * Prefers per-migration snapshots (latest by timestamp) over the legacy .snapshot.json.
  * Returns null if no snapshot file exists.
  */
 export declare function readSnapshot(directory: string): DatabaseSchemaSnapshot | null;
@@ -9,6 +10,18 @@ export declare function readSnapshot(directory: string): DatabaseSchemaSnapshot
  * Creates the directory if it doesn't exist.
  */
 export declare function writeSnapshot(directory: string, snapshot: DatabaseSchemaSnapshot): void;
+/**
+ * Write a per-migration snapshot alongside its migration file.
+ * Creates a file named `{migrationName}.snapshot.json` in the directory.
+ */
+export declare function writePerMigrationSnapshot(directory: string, migrationName: string, snapshot: DatabaseSchemaSnapshot): void;
+/**
+ * Find the latest per-migration snapshot in the directory.
+ * Scans for files matching YYYYMMDDHHMMSS_name.snapshot.json,
+ * sorts lexicographically (timestamp prefix ensures correct order),
+ * and returns the last one.
+ */
+export declare function findLatestPerMigrationSnapshot(directory: string): DatabaseSchemaSnapshot | null;
 /**
  * Get the full path to the snapshot file.
  */