@momentumcms/migrations 0.3.0 → 0.4.0

package/src/cli/status.cjs

@@ -0,0 +1,356 @@
+"use strict";
+
+// libs/migrations/src/cli/status.ts
+var import_node_path2 = require("node:path");
+
+// libs/core/src/lib/collections/define-collection.ts
+function defineCollection(config) {
+  const collection = {
+    timestamps: true,
+    // Enable timestamps by default
+    ...config
+  };
+  if (!collection.slug) {
+    throw new Error("Collection must have a slug");
+  }
+  if (!collection.fields || collection.fields.length === 0) {
+    throw new Error(`Collection "${collection.slug}" must have at least one field`);
+  }
+  if (!/^[a-z][a-z0-9-]*$/.test(collection.slug)) {
+    throw new Error(
+      `Collection slug "${collection.slug}" must be kebab-case (lowercase letters, numbers, and hyphens, starting with a letter)`
+    );
+  }
+  return collection;
+}
+
+// libs/core/src/lib/fields/field-builders.ts
+function text(name, options = {}) {
+  return {
+    name,
+    type: "text",
+    ...options
+  };
+}
+function number(name, options = {}) {
+  return {
+    name,
+    type: "number",
+    ...options
+  };
+}
+function json(name, options = {}) {
+  return {
+    name,
+    type: "json",
+    ...options
+  };
+}
+
+// libs/core/src/lib/collections/media.collection.ts
+var MediaCollection = defineCollection({
+  slug: "media",
+  labels: {
+    singular: "Media",
+    plural: "Media"
+  },
+  upload: {
+    mimeTypes: ["image/*", "application/pdf", "video/*", "audio/*"]
+  },
+  admin: {
+    useAsTitle: "filename",
+    defaultColumns: ["filename", "mimeType", "filesize", "createdAt"]
+  },
+  fields: [
+    text("filename", {
+      required: true,
+      label: "Filename",
+      description: "Original filename of the uploaded file"
+    }),
+    text("mimeType", {
+      required: true,
+      label: "MIME Type",
+      description: "File MIME type (e.g., image/jpeg, application/pdf)"
+    }),
+    number("filesize", {
+      label: "File Size",
+      description: "File size in bytes"
+    }),
+    text("path", {
+      label: "Storage Path",
+      description: "Path/key where the file is stored",
+      admin: {
+        hidden: true
+      }
+    }),
+    text("url", {
+      label: "URL",
+      description: "Public URL to access the file"
+    }),
+    text("alt", {
+      label: "Alt Text",
+      description: "Alternative text for accessibility"
+    }),
+    number("width", {
+      label: "Width",
+      description: "Image width in pixels (for images only)"
+    }),
+    number("height", {
+      label: "Height",
+      description: "Image height in pixels (for images only)"
+    }),
+    json("focalPoint", {
+      label: "Focal Point",
+      description: "Focal point coordinates for image cropping",
+      admin: {
+        hidden: true
+      }
+    })
+  ],
+  access: {
+    // Media is readable by anyone by default
+    read: () => true,
+    // Only authenticated users can create/update/delete
+    create: ({ req }) => !!req?.user,
+    update: ({ req }) => !!req?.user,
+    delete: ({ req }) => !!req?.user
+  }
+});
+
+// libs/core/src/lib/migrations.ts
+function resolveMigrationMode(mode) {
+  if (mode === "push" || mode === "migrate")
+    return mode;
+  const env = process.env["NODE_ENV"];
+  if (env === "production")
+    return "migrate";
+  return "push";
+}
+function resolveMigrationConfig(config) {
+  if (!config)
+    return void 0;
+  const mode = resolveMigrationMode(config.mode);
+  return {
+    ...config,
+    directory: config.directory ?? "./migrations",
+    mode,
+    cloneTest: config.cloneTest ?? mode === "migrate",
+    dangerDetection: config.dangerDetection ?? true,
+    autoApply: config.autoApply ?? mode === "push"
+  };
+}
+
+// libs/migrations/src/lib/loader/migration-loader.ts
+var import_node_fs = require("node:fs");
+var import_node_path = require("node:path");
+var import_node_url = require("node:url");
+var MIGRATION_FILE_PATTERN = /^\d{14}_.+\.ts$/;
+function isMigrationFile(value) {
+  if (typeof value !== "object" || value === null)
+    return false;
+  const obj = value;
+  return "meta" in obj && typeof obj["meta"] === "object" && obj["meta"] !== null && "up" in obj && typeof obj["up"] === "function" && "down" in obj && typeof obj["down"] === "function";
+}
+function validateMigrationModule(mod, filePath) {
+  const file = mod["default"] ?? mod;
+  if (!isMigrationFile(file)) {
+    if (typeof file !== "object" || file === null) {
+      throw new Error(`Migration file ${filePath} does not export a valid module`);
+    }
+    if (!("meta" in file) || typeof file["meta"] !== "object") {
+      throw new Error(`Migration file ${filePath} is missing a valid 'meta' export`);
+    }
+    if (!("up" in file) || typeof file["up"] !== "function") {
+      throw new Error(`Migration file ${filePath} is missing an 'up' function export`);
+    }
+    if (!("down" in file) || typeof file["down"] !== "function") {
+      throw new Error(`Migration file ${filePath} is missing a 'down' function export`);
+    }
+    throw new Error(`Migration file ${filePath} does not conform to MigrationFile interface`);
+  }
+  return file;
+}
+async function loadMigrationsFromDisk(directory) {
+  if (!(0, import_node_fs.existsSync)(directory))
+    return [];
+  const files = (0, import_node_fs.readdirSync)(directory).filter((f) => MIGRATION_FILE_PATTERN.test(f)).sort();
+  if (files.length === 0)
+    return [];
+  const migrations = [];
+  for (const filename of files) {
+    const filePath = (0, import_node_path.join)(directory, filename);
+    const fileUrl = (0, import_node_url.pathToFileURL)(filePath).href;
+    const mod = await import(fileUrl);
+    const file = validateMigrationModule(mod, filePath);
+    const name = filename.replace(/\.ts$/, "");
+    migrations.push({ name, file });
+  }
+  return migrations;
+}
+
+// libs/migrations/src/lib/migration.types.ts
+var MIGRATION_TRACKING_TABLE = "_momentum_migrations";
+
+// libs/migrations/src/lib/tracking/migration-tracker.ts
+async function ensureTrackingTable(db, dialect) {
+  if (dialect === "postgresql") {
+    await db.execute(`
+			CREATE TABLE IF NOT EXISTS "${MIGRATION_TRACKING_TABLE}" (
+				"id" VARCHAR(36) PRIMARY KEY,
+				"name" VARCHAR(255) NOT NULL UNIQUE,
+				"batch" INTEGER NOT NULL,
+				"checksum" VARCHAR(64) NOT NULL,
+				"appliedAt" TIMESTAMPTZ NOT NULL,
+				"executionMs" INTEGER NOT NULL
+			)
+		`);
+  } else {
+    await db.execute(`
+			CREATE TABLE IF NOT EXISTS "${MIGRATION_TRACKING_TABLE}" (
+				"id" TEXT PRIMARY KEY,
+				"name" TEXT NOT NULL UNIQUE,
+				"batch" INTEGER NOT NULL,
+				"checksum" TEXT NOT NULL,
+				"appliedAt" TEXT NOT NULL,
+				"executionMs" INTEGER NOT NULL
+			)
+		`);
+  }
+}
+async function getAppliedMigrations(db) {
+  const rows = await db.query(
+    `SELECT * FROM "${MIGRATION_TRACKING_TABLE}" ORDER BY "batch" ASC, "name" ASC`
+  );
+  return rows.map(toTrackingRecord);
+}
+function toTrackingRecord(row2) {
+  return {
+    id: String(row2["id"]),
+    name: String(row2["name"]),
+    batch: Number(row2["batch"]),
+    checksum: String(row2["checksum"]),
+    appliedAt: String(row2["appliedAt"]),
+    executionMs: Number(row2["executionMs"])
+  };
+}
+
+// libs/migrations/src/lib/runner/migrate-runner.ts
+async function getMigrationStatus(migrations, tracker, dialect) {
+  await ensureTrackingTable(tracker, dialect);
+  const applied = await getAppliedMigrations(tracker);
+  const appliedMap = new Map(applied.map((m) => [m.name, m]));
+  return migrations.map((m) => {
+    const record = appliedMap.get(m.name);
+    if (record) {
+      return {
+        name: m.name,
+        status: "applied",
+        batch: record.batch,
+        appliedAt: record.appliedAt
+      };
+    }
+    return { name: m.name, status: "pending" };
+  });
+}
+
+// libs/migrations/src/cli/shared.ts
+var import_node_url2 = require("node:url");
+function isResolvedConfig(value) {
+  return typeof value === "object" && value !== null && "collections" in value && "db" in value;
+}
+async function loadMomentumConfig(configPath) {
+  const configUrl = (0, import_node_url2.pathToFileURL)(configPath).href;
+  const mod = await import(configUrl);
+  const raw = mod["default"] ?? mod;
+  if (!isResolvedConfig(raw)) {
+    throw new Error(`Config at ${configPath} is not a valid ResolvedMomentumConfig`);
+  }
+  if (!raw.db?.adapter) {
+    throw new Error(`Config at ${configPath} is missing db.adapter`);
+  }
+  if (!raw.collections || raw.collections.length === 0) {
+    throw new Error(`Config at ${configPath} has no collections`);
+  }
+  return raw;
+}
+function resolveDialect(adapter) {
+  if (!adapter.dialect) {
+    throw new Error(
+      "DatabaseAdapter.dialect is not set. Ensure your adapter factory (postgresAdapter/sqliteAdapter) sets the dialect property."
+    );
+  }
+  return adapter.dialect;
+}
+function buildTrackerFromAdapter(adapter) {
+  if (!adapter.queryRaw || !adapter.executeRaw) {
+    throw new Error("DatabaseAdapter must implement queryRaw and executeRaw for migration tracking");
+  }
+  const queryRaw = adapter.queryRaw.bind(adapter);
+  const executeRaw = adapter.executeRaw.bind(adapter);
+  return {
+    async query(sql, params) {
+      return queryRaw(sql, params);
+    },
+    async execute(sql, params) {
+      return executeRaw(sql, params);
+    }
+  };
+}
+function parseMigrationArgs(args) {
+  const configPath = args.find((a) => !a.startsWith("--"));
+  if (!configPath) {
+    throw new Error("Usage: npx tsx <command>.ts <configPath> [options]");
+  }
+  let name;
+  const nameIdx = args.indexOf("--name");
+  if (nameIdx !== -1 && args[nameIdx + 1]) {
+    name = args[nameIdx + 1];
+  }
+  return {
+    configPath,
+    name,
+    dryRun: args.includes("--dry-run"),
+    testOnly: args.includes("--test-only"),
+    skipCloneTest: args.includes("--skip-clone-test")
+  };
+}
+
+// libs/migrations/src/cli/status.ts
+async function main() {
+  const args = parseMigrationArgs(process.argv.slice(2));
+  const config = await loadMomentumConfig((0, import_node_path2.resolve)(args.configPath));
+  const adapter = config.db.adapter;
+  const dialect = resolveDialect(adapter);
+  const migrationConfig = resolveMigrationConfig(config.migrations ?? {});
+  if (!migrationConfig) {
+    console.warn("No migration config found.");
+    process.exit(1);
+  }
+  const directory = (0, import_node_path2.resolve)(migrationConfig.directory);
+  const migrations = await loadMigrationsFromDisk(directory);
+  if (migrations.length === 0) {
+    console.warn("No migration files found in", directory);
+    return;
+  }
+  const tracker = buildTrackerFromAdapter(adapter);
+  const entries = await getMigrationStatus(migrations, tracker, dialect);
+  const appliedCount = entries.filter((e) => e.status === "applied").length;
+  const pendingCount = entries.filter((e) => e.status === "pending").length;
+  console.warn(`
+Migration Status (${appliedCount} applied, ${pendingCount} pending)
+`);
+  console.warn("  Name".padEnd(50) + "Status".padEnd(12) + "Batch".padEnd(8) + "Applied At");
+  console.warn("  " + "-".repeat(80));
+  for (const entry of entries) {
+    const name = `  ${entry.name}`.padEnd(50);
+    const status = entry.status.padEnd(12);
+    const batch = (entry.batch?.toString() ?? "-").padEnd(8);
+    const appliedAt = entry.appliedAt ?? "-";
+    console.warn(`${name}${status}${batch}${appliedAt}`);
+  }
+  console.warn("");
+}
+main().catch((err) => {
+  console.error("Migration status failed:", err);
+  process.exit(1);
+});

package/src/cli/status.js

@@ -0,0 +1,354 @@
+// libs/migrations/src/cli/status.ts
+import { resolve } from "node:path";
+
+// libs/core/src/lib/collections/define-collection.ts
+function defineCollection(config) {
+  const collection = {
+    timestamps: true,
+    // Enable timestamps by default
+    ...config
+  };
+  if (!collection.slug) {
+    throw new Error("Collection must have a slug");
+  }
+  if (!collection.fields || collection.fields.length === 0) {
+    throw new Error(`Collection "${collection.slug}" must have at least one field`);
+  }
+  if (!/^[a-z][a-z0-9-]*$/.test(collection.slug)) {
+    throw new Error(
+      `Collection slug "${collection.slug}" must be kebab-case (lowercase letters, numbers, and hyphens, starting with a letter)`
+    );
+  }
+  return collection;
+}
+
+// libs/core/src/lib/fields/field-builders.ts
+function text(name, options = {}) {
+  return {
+    name,
+    type: "text",
+    ...options
+  };
+}
+function number(name, options = {}) {
+  return {
+    name,
+    type: "number",
+    ...options
+  };
+}
+function json(name, options = {}) {
+  return {
+    name,
+    type: "json",
+    ...options
+  };
+}
+
+// libs/core/src/lib/collections/media.collection.ts
+var MediaCollection = defineCollection({
+  slug: "media",
+  labels: {
+    singular: "Media",
+    plural: "Media"
+  },
+  upload: {
+    mimeTypes: ["image/*", "application/pdf", "video/*", "audio/*"]
+  },
+  admin: {
+    useAsTitle: "filename",
+    defaultColumns: ["filename", "mimeType", "filesize", "createdAt"]
+  },
+  fields: [
+    text("filename", {
+      required: true,
+      label: "Filename",
+      description: "Original filename of the uploaded file"
+    }),
+    text("mimeType", {
+      required: true,
+      label: "MIME Type",
+      description: "File MIME type (e.g., image/jpeg, application/pdf)"
+    }),
+    number("filesize", {
+      label: "File Size",
+      description: "File size in bytes"
+    }),
+    text("path", {
+      label: "Storage Path",
+      description: "Path/key where the file is stored",
+      admin: {
+        hidden: true
+      }
+    }),
+    text("url", {
+      label: "URL",
+      description: "Public URL to access the file"
+    }),
+    text("alt", {
+      label: "Alt Text",
+      description: "Alternative text for accessibility"
+    }),
+    number("width", {
+      label: "Width",
+      description: "Image width in pixels (for images only)"
+    }),
+    number("height", {
+      label: "Height",
+      description: "Image height in pixels (for images only)"
+    }),
+    json("focalPoint", {
+      label: "Focal Point",
+      description: "Focal point coordinates for image cropping",
+      admin: {
+        hidden: true
+      }
+    })
+  ],
+  access: {
+    // Media is readable by anyone by default
+    read: () => true,
+    // Only authenticated users can create/update/delete
+    create: ({ req }) => !!req?.user,
+    update: ({ req }) => !!req?.user,
+    delete: ({ req }) => !!req?.user
+  }
+});
+
+// libs/core/src/lib/migrations.ts
+function resolveMigrationMode(mode) {
+  if (mode === "push" || mode === "migrate")
+    return mode;
+  const env = process.env["NODE_ENV"];
+  if (env === "production")
+    return "migrate";
+  return "push";
+}
+function resolveMigrationConfig(config) {
+  if (!config)
+    return void 0;
+  const mode = resolveMigrationMode(config.mode);
+  return {
+    ...config,
+    directory: config.directory ?? "./migrations",
+    mode,
+    cloneTest: config.cloneTest ?? mode === "migrate",
+    dangerDetection: config.dangerDetection ?? true,
+    autoApply: config.autoApply ?? mode === "push"
+  };
+}
+
+// libs/migrations/src/lib/loader/migration-loader.ts
+import { readdirSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+var MIGRATION_FILE_PATTERN = /^\d{14}_.+\.ts$/;
+function isMigrationFile(value) {
+  if (typeof value !== "object" || value === null)
+    return false;
+  const obj = value;
+  return "meta" in obj && typeof obj["meta"] === "object" && obj["meta"] !== null && "up" in obj && typeof obj["up"] === "function" && "down" in obj && typeof obj["down"] === "function";
+}
+function validateMigrationModule(mod, filePath) {
+  const file = mod["default"] ?? mod;
+  if (!isMigrationFile(file)) {
+    if (typeof file !== "object" || file === null) {
+      throw new Error(`Migration file ${filePath} does not export a valid module`);
+    }
+    if (!("meta" in file) || typeof file["meta"] !== "object") {
+      throw new Error(`Migration file ${filePath} is missing a valid 'meta' export`);
+    }
+    if (!("up" in file) || typeof file["up"] !== "function") {
+      throw new Error(`Migration file ${filePath} is missing an 'up' function export`);
+    }
+    if (!("down" in file) || typeof file["down"] !== "function") {
+      throw new Error(`Migration file ${filePath} is missing a 'down' function export`);
+    }
+    throw new Error(`Migration file ${filePath} does not conform to MigrationFile interface`);
+  }
+  return file;
+}
+async function loadMigrationsFromDisk(directory) {
+  if (!existsSync(directory))
+    return [];
+  const files = readdirSync(directory).filter((f) => MIGRATION_FILE_PATTERN.test(f)).sort();
+  if (files.length === 0)
+    return [];
+  const migrations = [];
+  for (const filename of files) {
+    const filePath = join(directory, filename);
+    const fileUrl = pathToFileURL(filePath).href;
+    const mod = await import(fileUrl);
+    const file = validateMigrationModule(mod, filePath);
+    const name = filename.replace(/\.ts$/, "");
+    migrations.push({ name, file });
+  }
+  return migrations;
+}
+
+// libs/migrations/src/lib/migration.types.ts
+var MIGRATION_TRACKING_TABLE = "_momentum_migrations";
+
+// libs/migrations/src/lib/tracking/migration-tracker.ts
+async function ensureTrackingTable(db, dialect) {
+  if (dialect === "postgresql") {
+    await db.execute(`
+			CREATE TABLE IF NOT EXISTS "${MIGRATION_TRACKING_TABLE}" (
+				"id" VARCHAR(36) PRIMARY KEY,
+				"name" VARCHAR(255) NOT NULL UNIQUE,
+				"batch" INTEGER NOT NULL,
+				"checksum" VARCHAR(64) NOT NULL,
+				"appliedAt" TIMESTAMPTZ NOT NULL,
+				"executionMs" INTEGER NOT NULL
+			)
+		`);
+  } else {
+    await db.execute(`
+			CREATE TABLE IF NOT EXISTS "${MIGRATION_TRACKING_TABLE}" (
+				"id" TEXT PRIMARY KEY,
+				"name" TEXT NOT NULL UNIQUE,
+				"batch" INTEGER NOT NULL,
+				"checksum" TEXT NOT NULL,
+				"appliedAt" TEXT NOT NULL,
+				"executionMs" INTEGER NOT NULL
+			)
+		`);
+  }
+}
+async function getAppliedMigrations(db) {
+  const rows = await db.query(
+    `SELECT * FROM "${MIGRATION_TRACKING_TABLE}" ORDER BY "batch" ASC, "name" ASC`
+  );
+  return rows.map(toTrackingRecord);
+}
+function toTrackingRecord(row2) {
+  return {
+    id: String(row2["id"]),
+    name: String(row2["name"]),
+    batch: Number(row2["batch"]),
+    checksum: String(row2["checksum"]),
+    appliedAt: String(row2["appliedAt"]),
+    executionMs: Number(row2["executionMs"])
+  };
+}
+
+// libs/migrations/src/lib/runner/migrate-runner.ts
+async function getMigrationStatus(migrations, tracker, dialect) {
+  await ensureTrackingTable(tracker, dialect);
+  const applied = await getAppliedMigrations(tracker);
+  const appliedMap = new Map(applied.map((m) => [m.name, m]));
+  return migrations.map((m) => {
+    const record = appliedMap.get(m.name);
+    if (record) {
+      return {
+        name: m.name,
+        status: "applied",
+        batch: record.batch,
+        appliedAt: record.appliedAt
+      };
+    }
+    return { name: m.name, status: "pending" };
+  });
+}
+
+// libs/migrations/src/cli/shared.ts
+import { pathToFileURL as pathToFileURL2 } from "node:url";
+function isResolvedConfig(value) {
+  return typeof value === "object" && value !== null && "collections" in value && "db" in value;
+}
+async function loadMomentumConfig(configPath) {
+  const configUrl = pathToFileURL2(configPath).href;
+  const mod = await import(configUrl);
+  const raw = mod["default"] ?? mod;
+  if (!isResolvedConfig(raw)) {
+    throw new Error(`Config at ${configPath} is not a valid ResolvedMomentumConfig`);
+  }
+  if (!raw.db?.adapter) {
+    throw new Error(`Config at ${configPath} is missing db.adapter`);
+  }
+  if (!raw.collections || raw.collections.length === 0) {
+    throw new Error(`Config at ${configPath} has no collections`);
+  }
+  return raw;
+}
+function resolveDialect(adapter) {
+  if (!adapter.dialect) {
+    throw new Error(
+      "DatabaseAdapter.dialect is not set. Ensure your adapter factory (postgresAdapter/sqliteAdapter) sets the dialect property."
+    );
+  }
+  return adapter.dialect;
+}
+function buildTrackerFromAdapter(adapter) {
+  if (!adapter.queryRaw || !adapter.executeRaw) {
+    throw new Error("DatabaseAdapter must implement queryRaw and executeRaw for migration tracking");
+  }
+  const queryRaw = adapter.queryRaw.bind(adapter);
+  const executeRaw = adapter.executeRaw.bind(adapter);
+  return {
+    async query(sql, params) {
+      return queryRaw(sql, params);
+    },
+    async execute(sql, params) {
+      return executeRaw(sql, params);
+    }
+  };
+}
+function parseMigrationArgs(args) {
+  const configPath = args.find((a) => !a.startsWith("--"));
+  if (!configPath) {
+    throw new Error("Usage: npx tsx <command>.ts <configPath> [options]");
+  }
+  let name;
+  const nameIdx = args.indexOf("--name");
+  if (nameIdx !== -1 && args[nameIdx + 1]) {
+    name = args[nameIdx + 1];
+  }
+  return {
+    configPath,
+    name,
+    dryRun: args.includes("--dry-run"),
+    testOnly: args.includes("--test-only"),
+    skipCloneTest: args.includes("--skip-clone-test")
+  };
+}
+
+// libs/migrations/src/cli/status.ts
+async function main() {
+  const args = parseMigrationArgs(process.argv.slice(2));
+  const config = await loadMomentumConfig(resolve(args.configPath));
+  const adapter = config.db.adapter;
+  const dialect = resolveDialect(adapter);
+  const migrationConfig = resolveMigrationConfig(config.migrations ?? {});
+  if (!migrationConfig) {
+    console.warn("No migration config found.");
+    process.exit(1);
+  }
+  const directory = resolve(migrationConfig.directory);
+  const migrations = await loadMigrationsFromDisk(directory);
+  if (migrations.length === 0) {
+    console.warn("No migration files found in", directory);
+    return;
+  }
+  const tracker = buildTrackerFromAdapter(adapter);
+  const entries = await getMigrationStatus(migrations, tracker, dialect);
+  const appliedCount = entries.filter((e) => e.status === "applied").length;
+  const pendingCount = entries.filter((e) => e.status === "pending").length;
+  console.warn(`
+Migration Status (${appliedCount} applied, ${pendingCount} pending)
+`);
+  console.warn("  Name".padEnd(50) + "Status".padEnd(12) + "Batch".padEnd(8) + "Applied At");
+  console.warn("  " + "-".repeat(80));
+  for (const entry of entries) {
+    const name = `  ${entry.name}`.padEnd(50);
+    const status = entry.status.padEnd(12);
+    const batch = (entry.batch?.toString() ?? "-").padEnd(8);
+    const appliedAt = entry.appliedAt ?? "-";
+    console.warn(`${name}${status}${batch}${appliedAt}`);
+  }
+  console.warn("");
+}
+main().catch((err) => {
+  console.error("Migration status failed:", err);
+  process.exit(1);
+});