@momentumcms/core 0.2.0 → 0.4.0

package/package.json

@@ -1,35 +1,44 @@
 {
-  "name": "@momentumcms/core",
-  "version": "0.2.0",
-  "description": "Core collection config, fields, hooks, and access control for Momentum CMS",
-  "license": "MIT",
-  "author": "Momentum CMS Contributors",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/DonaldMurillo/momentum-cms.git",
-    "directory": "libs/core"
-  },
-  "homepage": "https://github.com/DonaldMurillo/momentum-cms#readme",
-  "bugs": {
-    "url": "https://github.com/DonaldMurillo/momentum-cms/issues"
-  },
-  "keywords": [
-    "cms",
-    "headless-cms",
-    "angular",
-    "momentum-cms",
-    "collections",
-    "fields",
-    "content-management"
-  ],
-  "engines": {
-    "node": ">=18"
-  },
-  "main": "./index.cjs",
-  "types": "./src/index.d.ts",
-  "bin": {
-    "momentum-generate": "./generators/generator.cjs"
-  },
-  "dependencies": {},
-  "module": "./index.js"
-}
+	"name": "@momentumcms/core",
+	"version": "0.4.0",
+	"description": "Core collection config, fields, hooks, and access control for Momentum CMS",
+	"license": "MIT",
+	"author": "Momentum CMS Contributors",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/DonaldMurillo/momentum-cms.git",
+		"directory": "libs/core"
+	},
+	"homepage": "https://github.com/DonaldMurillo/momentum-cms#readme",
+	"bugs": {
+		"url": "https://github.com/DonaldMurillo/momentum-cms/issues"
+	},
+	"keywords": [
+		"cms",
+		"headless-cms",
+		"angular",
+		"momentum-cms",
+		"collections",
+		"fields",
+		"content-management"
+	],
+	"engines": {
+		"node": ">=18"
+	},
+	"main": "./src/index.cjs",
+	"module": "./src/index.js",
+	"types": "./src/index.d.ts",
+	"schematics": "./schematics/collection.json",
+	"bin": {
+		"momentum-generate": "./src/generators/generator.cjs"
+	},
+	"peerDependencies": {
+		"@angular-devkit/schematics": ">=17.0.0"
+	},
+	"peerDependenciesMeta": {
+		"@angular-devkit/schematics": {
+			"optional": true
+		}
+	},
+	"dependencies": {}
+}

package/schematics/collection.json

@@ -0,0 +1,10 @@
+{
+	"$schema": "../../../node_modules/@angular-devkit/schematics/collection-schema.json",
+	"schematics": {
+		"types": {
+			"description": "Generate TypeScript types and browser-safe admin config from momentum.config.ts",
+			"factory": "./types/index#generateTypes",
+			"schema": "./types/schema.json"
+		}
+	}
+}

package/schematics/types/index.cjs

@@ -0,0 +1,53 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// libs/core/schematics/types/index.ts
+var types_exports = {};
+__export(types_exports, {
+  generateTypes: () => generateTypes
+});
+module.exports = __toCommonJS(types_exports);
+var import_node_child_process = require("node:child_process");
+function generateTypes(options) {
+  return (_tree, context) => {
+    const configPath = options.configPath || "src/momentum.config.ts";
+    const typesOutput = options.typesOutput || "src/generated/momentum.types.ts";
+    const configOutput = options.configOutput || "src/generated/momentum.config.ts";
+    context.logger.info("Generating Momentum CMS types and admin config...");
+    context.logger.info(`  Config: ${configPath}`);
+    context.logger.info(`  Types:  ${typesOutput}`);
+    context.logger.info(`  Admin:  ${configOutput}`);
+    try {
+      (0, import_node_child_process.execFileSync)(
+        "npx",
+        ["momentum-generate", configPath, "--types", typesOutput, "--config", configOutput],
+        { stdio: "inherit", shell: true }
+      );
+      context.logger.info("Types and admin config generated successfully.");
+    } catch (error) {
+      context.logger.error("Failed to generate types. Is @momentumcms/core installed?");
+      throw error;
+    }
+    return _tree;
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  generateTypes
+});

package/schematics/types/index.js

@@ -0,0 +1,28 @@
+// libs/core/schematics/types/index.ts
+import { execFileSync } from "node:child_process";
+function generateTypes(options) {
+  return (_tree, context) => {
+    const configPath = options.configPath || "src/momentum.config.ts";
+    const typesOutput = options.typesOutput || "src/generated/momentum.types.ts";
+    const configOutput = options.configOutput || "src/generated/momentum.config.ts";
+    context.logger.info("Generating Momentum CMS types and admin config...");
+    context.logger.info(`  Config: ${configPath}`);
+    context.logger.info(`  Types:  ${typesOutput}`);
+    context.logger.info(`  Admin:  ${configOutput}`);
+    try {
+      execFileSync(
+        "npx",
+        ["momentum-generate", configPath, "--types", typesOutput, "--config", configOutput],
+        { stdio: "inherit", shell: true }
+      );
+      context.logger.info("Types and admin config generated successfully.");
+    } catch (error) {
+      context.logger.error("Failed to generate types. Is @momentumcms/core installed?");
+      throw error;
+    }
+    return _tree;
+  };
+}
+export {
+  generateTypes
+};

package/schematics/types/schema.d.ts

@@ -0,0 +1,5 @@
+export interface TypesSchema {
+	configPath: string;
+	typesOutput: string;
+	configOutput: string;
+}

package/schematics/types/schema.json

@@ -0,0 +1,26 @@
+{
+	"$schema": "http://json-schema.org/draft-07/schema",
+	"$id": "MomentumGenerateTypes",
+	"title": "Momentum CMS Type Generation",
+	"description": "Generate TypeScript types and browser-safe admin config from momentum.config.ts",
+	"type": "object",
+	"properties": {
+		"configPath": {
+			"type": "string",
+			"description": "Path to momentum.config.ts",
+			"default": "src/momentum.config.ts",
+			"x-prompt": "Path to your momentum.config.ts file?"
+		},
+		"typesOutput": {
+			"type": "string",
+			"description": "Output path for generated TypeScript types",
+			"default": "src/generated/momentum.types.ts"
+		},
+		"configOutput": {
+			"type": "string",
+			"description": "Output path for generated browser-safe admin config",
+			"default": "src/generated/momentum.config.ts"
+		}
+	},
+	"required": []
+}

package/{generators → src/generators}/generator.cjs

@@ -392,6 +392,44 @@ var FIELD_ADMIN_STRIP_KEYS = /* @__PURE__ */ new Set(["condition"]);
 function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+function collectFieldNames(fields) {
+  const names = [];
+  for (const field of fields) {
+    if (field.type === "tabs" && field.tabs) {
+      for (const tab of field.tabs) {
+        if (tab.name) {
+          names.push(tab.name);
+        } else {
+          names.push(...collectFieldNames(tab.fields));
+        }
+      }
+    } else if ((field.type === "collapsible" || field.type === "row") && field.fields) {
+      names.push(...collectFieldNames(field.fields));
+    } else {
+      names.push(field.name);
+    }
+  }
+  return names;
+}
+function previewFunctionToTemplate(fn, fields) {
+  try {
+    const sentinel = "__MCMS_FIELD_";
+    const mockDoc = {};
+    for (const name of collectFieldNames(fields)) {
+      mockDoc[name] = `${sentinel}${name}__`;
+    }
+    const result = fn(mockDoc);
+    if (typeof result !== "string")
+      return true;
+    const template = result.replace(
+      new RegExp(`${sentinel}(\\w+)__`, "g"),
+      (_match, fieldName) => `{${fieldName}}`
+    );
+    return template;
+  } catch {
+    return true;
+  }
+}
 function serializeValue(value, indent = "	") {
   if (value === null)
     return "null";
@@ -584,9 +622,13 @@ function serializeCollection(collection, indent = "	") {
   }
   parts.push(`${indent}	fields: ${serializeFieldsArray(collection.fields, indent + "	")}`);
   if (collection.admin) {
-    const adminEntries = Object.entries(collection.admin).filter(
-      ([, v]) => v !== void 0 && typeof v !== "function"
-    );
+    const adminEntries = Object.entries(collection.admin).filter(([, v]) => v !== void 0).map(([k, v]) => {
+      if (k === "preview" && typeof v === "function") {
+        const fn = v;
+        return [k, previewFunctionToTemplate(fn, collection.fields)];
+      }
+      return [k, v];
+    }).filter(([, v]) => typeof v !== "function");
     if (adminEntries.length > 0) {
       const adminObj = Object.fromEntries(adminEntries);
       parts.push(`${indent}	admin: ${serializeValue(adminObj, indent + "	")}`);
@@ -610,6 +652,9 @@ function serializeCollection(collection, indent = "	") {
   if (collection.defaultSort) {
     parts.push(`${indent}	defaultSort: ${JSON.stringify(collection.defaultSort)}`);
   }
+  if (collection.upload !== void 0) {
+    parts.push(`${indent}	upload: ${serializeValue(collection.upload, indent + "	")}`);
+  }
   return `{
 ${parts.join(",\n")},
 ${indent}}`;
@@ -739,6 +784,15 @@ function parseArgs(args) {
   }
   return { configPath, typesOutputPath, configOutputPath, watch: watchMode };
 }
+function formatWithPrettier(...filePaths) {
+  try {
+    (0, import_node_child_process.execFileSync)("npx", ["prettier", "--write", ...filePaths], {
+      stdio: "pipe"
+    });
+  } catch {
+    console.warn("prettier not available \u2014 skipping formatting of generated files");
+  }
+}
 async function runGenerator(options) {
   const configPath = (0, import_node_path.resolve)(options.configPath);
   const typesOutputPath = (0, import_node_path.resolve)(options.typesOutputPath);
@@ -758,6 +812,7 @@ async function runGenerator(options) {
       (0, import_node_fs.mkdirSync)((0, import_node_path.dirname)(configOutputPath), { recursive: true });
       (0, import_node_fs.writeFileSync)(configOutputPath, adminConfigContent, "utf-8");
       console.info(`Admin config generated: ${configOutputPath}`);
+      formatWithPrettier(typesOutputPath, configOutputPath);
     } catch (error) {
       console.error(`Error generating:`, error);
       throw error;

package/src/generators/generator.d.ts

@@ -91,6 +91,16 @@ interface CollectionDefinition {
     defaultWhere?: unknown;
     endpoints?: unknown[];
     webhooks?: unknown[];
+    upload?: {
+        mimeTypes?: string[];
+        maxFileSize?: number;
+        directory?: string;
+        filenameField?: string;
+        mimeTypeField?: string;
+        filesizeField?: string;
+        pathField?: string;
+        urlField?: string;
+    };
 }
 interface GlobalDefinition {
     slug: string;

package/{generators → src/generators}/generator.js

@@ -361,6 +361,44 @@ var FIELD_ADMIN_STRIP_KEYS = /* @__PURE__ */ new Set(["condition"]);
 function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+function collectFieldNames(fields) {
+  const names = [];
+  for (const field of fields) {
+    if (field.type === "tabs" && field.tabs) {
+      for (const tab of field.tabs) {
+        if (tab.name) {
+          names.push(tab.name);
+        } else {
+          names.push(...collectFieldNames(tab.fields));
+        }
+      }
+    } else if ((field.type === "collapsible" || field.type === "row") && field.fields) {
+      names.push(...collectFieldNames(field.fields));
+    } else {
+      names.push(field.name);
+    }
+  }
+  return names;
+}
+function previewFunctionToTemplate(fn, fields) {
+  try {
+    const sentinel = "__MCMS_FIELD_";
+    const mockDoc = {};
+    for (const name of collectFieldNames(fields)) {
+      mockDoc[name] = `${sentinel}${name}__`;
+    }
+    const result = fn(mockDoc);
+    if (typeof result !== "string")
+      return true;
+    const template = result.replace(
+      new RegExp(`${sentinel}(\\w+)__`, "g"),
+      (_match, fieldName) => `{${fieldName}}`
+    );
+    return template;
+  } catch {
+    return true;
+  }
+}
 function serializeValue(value, indent = "	") {
   if (value === null)
     return "null";
@@ -553,9 +591,13 @@ function serializeCollection(collection, indent = "	") {
   }
   parts.push(`${indent}	fields: ${serializeFieldsArray(collection.fields, indent + "	")}`);
   if (collection.admin) {
-    const adminEntries = Object.entries(collection.admin).filter(
-      ([, v]) => v !== void 0 && typeof v !== "function"
-    );
+    const adminEntries = Object.entries(collection.admin).filter(([, v]) => v !== void 0).map(([k, v]) => {
+      if (k === "preview" && typeof v === "function") {
+        const fn = v;
+        return [k, previewFunctionToTemplate(fn, collection.fields)];
+      }
+      return [k, v];
+    }).filter(([, v]) => typeof v !== "function");
     if (adminEntries.length > 0) {
       const adminObj = Object.fromEntries(adminEntries);
       parts.push(`${indent}	admin: ${serializeValue(adminObj, indent + "	")}`);
@@ -579,6 +621,9 @@ function serializeCollection(collection, indent = "	") {
   if (collection.defaultSort) {
     parts.push(`${indent}	defaultSort: ${JSON.stringify(collection.defaultSort)}`);
   }
+  if (collection.upload !== void 0) {
+    parts.push(`${indent}	upload: ${serializeValue(collection.upload, indent + "	")}`);
+  }
   return `{
 ${parts.join(",\n")},
 ${indent}}`;
@@ -708,6 +753,15 @@ function parseArgs(args) {
   }
   return { configPath, typesOutputPath, configOutputPath, watch: watchMode };
 }
+function formatWithPrettier(...filePaths) {
+  try {
+    execFileSync("npx", ["prettier", "--write", ...filePaths], {
+      stdio: "pipe"
+    });
+  } catch {
+    console.warn("prettier not available \u2014 skipping formatting of generated files");
+  }
+}
 async function runGenerator(options) {
   const configPath = resolve(options.configPath);
   const typesOutputPath = resolve(options.typesOutputPath);
@@ -727,6 +781,7 @@ async function runGenerator(options) {
       mkdirSync(dirname(configOutputPath), { recursive: true });
       writeFileSync(configOutputPath, adminConfigContent, "utf-8");
       console.info(`Admin config generated: ${configOutputPath}`);
+      formatWithPrettier(typesOutputPath, configOutputPath);
     } catch (error) {
       console.error(`Error generating:`, error);
       throw error;

package/{index.cjs → src/index.cjs}

@@ -46,6 +46,7 @@ __export(src_exports, {
   getDbAdapter: () => getDbAdapter,
   getGlobals: () => getGlobals,
   getSoftDeleteField: () => getSoftDeleteField,
+  getUploadFieldMapping: () => getUploadFieldMapping,
   group: () => group,
   hasAllRoles: () => hasAllRoles,
   hasAnyRole: () => hasAnyRole,
@@ -55,6 +56,7 @@ __export(src_exports, {
   isLayoutField: () => isLayoutField,
   isNamedTab: () => isNamedTab,
   isOwner: () => isOwner,
+  isUploadCollection: () => isUploadCollection,
   json: () => json,
   not: () => not,
   number: () => number,
@@ -63,6 +65,8 @@ __export(src_exports, {
   point: () => point,
   radio: () => radio,
   relationship: () => relationship,
+  resolveMigrationConfig: () => resolveMigrationConfig,
+  resolveMigrationMode: () => resolveMigrationMode,
   richText: () => richText,
   row: () => row,
   select: () => select,
@@ -117,6 +121,21 @@ function getSoftDeleteField(config) {
   const sdConfig = config.softDelete;
   return sdConfig.field ?? "deletedAt";
 }
+function isUploadCollection(config) {
+  return config.upload != null;
+}
+function getUploadFieldMapping(config) {
+  if (!isUploadCollection(config))
+    return null;
+  const u = config.upload;
+  return {
+    filename: u.filenameField ?? "filename",
+    mimeType: u.mimeTypeField ?? "mimeType",
+    filesize: u.filesizeField ?? "filesize",
+    path: u.pathField ?? "path",
+    url: u.urlField ?? "url"
+  };
+}
 
 // libs/core/src/lib/fields/field.types.ts
 var LAYOUT_FIELD_TYPES = /* @__PURE__ */ new Set(["tabs", "collapsible", "row"]);
@@ -430,6 +449,9 @@ var MediaCollection = defineCollection({
     singular: "Media",
     plural: "Media"
   },
+  upload: {
+    mimeTypes: ["image/*", "application/pdf", "video/*", "audio/*"]
+  },
   admin: {
     useAsTitle: "filename",
     defaultColumns: ["filename", "mimeType", "filesize", "createdAt"]
@@ -450,7 +472,6 @@ var MediaCollection = defineCollection({
       description: "File size in bytes"
     }),
     text("path", {
-      required: true,
       label: "Storage Path",
       description: "Path/key where the file is stored",
       admin: {
@@ -561,6 +582,29 @@ function isOwner(ownerField = "createdBy") {
   };
 }
 
+// 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/core/src/lib/config.ts
 var MIN_PASSWORD_LENGTH = 8;
 function defineMomentumConfig(config) {
@@ -591,7 +635,8 @@ function defineMomentumConfig(config) {
       level: config.logging?.level ?? "info",
       format: config.logging?.format ?? "pretty",
       timestamps: config.logging?.timestamps ?? true
-    }
+    },
+    migrations: resolveMigrationConfig(config.migrations)
   };
 }
 function getDbAdapter(config) {
@@ -717,6 +762,7 @@ function createSeedHelpers() {
   getDbAdapter,
   getGlobals,
   getSoftDeleteField,
+  getUploadFieldMapping,
   group,
   hasAllRoles,
   hasAnyRole,
@@ -726,6 +772,7 @@ function createSeedHelpers() {
   isLayoutField,
   isNamedTab,
   isOwner,
+  isUploadCollection,
   json,
   not,
   number,
@@ -734,6 +781,8 @@ function createSeedHelpers() {
   point,
   radio,
   relationship,
+  resolveMigrationConfig,
+  resolveMigrationMode,
   richText,
   row,
   select,

package/src/index.d.ts

@@ -12,3 +12,4 @@ export * from './lib/plugins';
 export * from './lib/storage';
 export * from './lib/seeding';
 export * from './lib/versions';
+export * from './lib/migrations';

package/{index.js → src/index.js}

@@ -40,6 +40,21 @@ function getSoftDeleteField(config) {
   const sdConfig = config.softDelete;
   return sdConfig.field ?? "deletedAt";
 }
+function isUploadCollection(config) {
+  return config.upload != null;
+}
+function getUploadFieldMapping(config) {
+  if (!isUploadCollection(config))
+    return null;
+  const u = config.upload;
+  return {
+    filename: u.filenameField ?? "filename",
+    mimeType: u.mimeTypeField ?? "mimeType",
+    filesize: u.filesizeField ?? "filesize",
+    path: u.pathField ?? "path",
+    url: u.urlField ?? "url"
+  };
+}
 
 // libs/core/src/lib/fields/field.types.ts
 var LAYOUT_FIELD_TYPES = /* @__PURE__ */ new Set(["tabs", "collapsible", "row"]);
@@ -353,6 +368,9 @@ var MediaCollection = defineCollection({
     singular: "Media",
     plural: "Media"
   },
+  upload: {
+    mimeTypes: ["image/*", "application/pdf", "video/*", "audio/*"]
+  },
   admin: {
     useAsTitle: "filename",
     defaultColumns: ["filename", "mimeType", "filesize", "createdAt"]
@@ -373,7 +391,6 @@ var MediaCollection = defineCollection({
       description: "File size in bytes"
     }),
     text("path", {
-      required: true,
       label: "Storage Path",
       description: "Path/key where the file is stored",
       admin: {
@@ -484,6 +501,29 @@ function isOwner(ownerField = "createdBy") {
   };
 }
 
+// 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/core/src/lib/config.ts
 var MIN_PASSWORD_LENGTH = 8;
 function defineMomentumConfig(config) {
@@ -514,7 +554,8 @@ function defineMomentumConfig(config) {
       level: config.logging?.level ?? "info",
       format: config.logging?.format ?? "pretty",
       timestamps: config.logging?.timestamps ?? true
-    }
+    },
+    migrations: resolveMigrationConfig(config.migrations)
   };
 }
 function getDbAdapter(config) {
@@ -639,6 +680,7 @@ export {
   getDbAdapter,
   getGlobals,
   getSoftDeleteField,
+  getUploadFieldMapping,
   group,
   hasAllRoles,
   hasAnyRole,
@@ -648,6 +690,7 @@ export {
   isLayoutField,
   isNamedTab,
   isOwner,
+  isUploadCollection,
   json,
   not,
   number,
@@ -656,6 +699,8 @@ export {
   point,
   radio,
   relationship,
+  resolveMigrationConfig,
+  resolveMigrationMode,
   richText,
   row,
   select,

package/src/lib/collections/collection.types.d.ts

@@ -74,8 +74,8 @@ export interface AdminConfig {
     description?: string;
     /** Hide from admin navigation */
     hidden?: boolean;
-    /** Enable preview mode */
-    preview?: boolean | ((doc: Record<string, unknown>) => string);
+    /** Enable preview mode. String values are URL templates with {fieldName} placeholders. */
+    preview?: boolean | string | ((doc: Record<string, unknown>) => string);
     /** Custom action buttons displayed in the collection list header (alongside Create button) */
     headerActions?: Array<{
         id: string;
@@ -120,6 +120,24 @@ export interface SoftDeleteConfig {
     /** Auto-purge soft-deleted records after this many days. Undefined means never purge. */
     retentionDays?: number;
 }
+export interface UploadCollectionConfig {
+    /** Allowed MIME types for uploads to this collection (e.g., ['image/*', 'application/pdf']) */
+    mimeTypes?: string[];
+    /** Maximum file size in bytes (overrides global storage.maxFileSize) */
+    maxFileSize?: number;
+    /** Subdirectory within the upload dir for this collection's files */
+    directory?: string;
+    /** Field name for the original filename. @default 'filename' */
+    filenameField?: string;
+    /** Field name for the MIME type. @default 'mimeType' */
+    mimeTypeField?: string;
+    /** Field name for the file size in bytes. @default 'filesize' */
+    filesizeField?: string;
+    /** Field name for the storage path. @default 'path' */
+    pathField?: string;
+    /** Field name for the public URL. @default 'url' */
+    urlField?: string;
+}
 export interface TimestampsConfig {
     /** Add createdAt field */
     createdAt?: boolean;
@@ -188,6 +206,12 @@ export interface CollectionConfig {
     endpoints?: EndpointConfig[];
     /** Webhook subscriptions for this collection */
     webhooks?: WebhookConfig[];
+    /**
+     * Upload configuration. When present, this collection becomes an "upload collection"
+     * where POST /api/{slug} accepts multipart/form-data and auto-populates file metadata fields.
+     * Similar to Payload CMS's upload collection pattern.
+     */
+    upload?: UploadCollectionConfig;
 }
 /** Events that trigger webhooks. */
 export type WebhookEvent = 'afterChange' | 'afterDelete' | 'afterCreate' | 'afterUpdate';

package/src/lib/collections/define-collection.d.ts

@@ -40,6 +40,25 @@ export declare function defineGlobal(config: GlobalConfig): GlobalConfig;
  * @returns The deletedAt field name, or null if soft delete is not enabled
  */
 export declare function getSoftDeleteField(config: CollectionConfig): string | null;
+/**
+ * Check whether a collection is configured as an upload collection.
+ */
+export declare function isUploadCollection(config: CollectionConfig): boolean;
+/**
+ * Resolved field name mapping for upload collection metadata fields.
+ */
+export interface UploadFieldMapping {
+    filename: string;
+    mimeType: string;
+    filesize: string;
+    path: string;
+    url: string;
+}
+/**
+ * Get the resolved upload field mapping for an upload collection.
+ * Returns field names used for auto-populating file metadata, or null for non-upload collections.
+ */
+export declare function getUploadFieldMapping(config: CollectionConfig): UploadFieldMapping | null;
 /**
  * Helper type to extract the document type from a collection
  * Useful for typing API responses and database queries

package/src/lib/collections/index.d.ts

@@ -1,5 +1,5 @@
 export * from './collection.types';
-export { defineCollection, defineGlobal, getSoftDeleteField } from './define-collection';
-export type { InferDocumentType } from './define-collection';
+export { defineCollection, defineGlobal, getSoftDeleteField, isUploadCollection, getUploadFieldMapping, } from './define-collection';
+export type { InferDocumentType, UploadFieldMapping } from './define-collection';
 export { MediaCollection } from './media.collection';
 export type { MediaDocument } from './media.collection';

package/src/lib/config.d.ts

@@ -3,6 +3,7 @@ import type { SeedingConfig, SeedingOptions } from './seeding';
 import type { DocumentVersion, DocumentStatus, VersionQueryOptions, VersionCountOptions, CreateVersionOptions } from './versions';
 import type { MomentumPlugin, PluginAdminRouteDescriptor } from './plugins';
 import type { StorageAdapter } from './storage';
+import type { MigrationConfig, ResolvedMigrationConfig } from './migrations';
 /**
  * Minimum password length for user accounts.
  * Shared across seeding, user sync hooks, and setup middleware.
@@ -13,6 +14,12 @@ export declare const MIN_PASSWORD_LENGTH = 8;
  * This is a placeholder type - actual adapters implement this interface.
  */
 export interface DatabaseAdapter {
+    /**
+     * Database dialect identifier.
+     * Set by the adapter factory (e.g., postgresAdapter sets 'postgresql', sqliteAdapter sets 'sqlite').
+     * Used by the migration CLI to select the correct introspection and SQL generation strategy.
+     */
+    dialect?: 'postgresql' | 'sqlite';
     find(collection: string, query: Record<string, unknown>): Promise<Record<string, unknown>[]>;
     findById(collection: string, id: string): Promise<Record<string, unknown> | null>;
     create(collection: string, data: Record<string, unknown>): Promise<Record<string, unknown>>;
@@ -148,6 +155,34 @@ export interface DatabaseAdapter {
      * @returns The full global record after update
      */
     updateGlobal?(slug: string, data: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /**
+     * Introspect the current database schema.
+     * Returns table/column metadata for diffing against collection config.
+     */
+    introspect?(): Promise<Record<string, unknown>>;
+    /**
+     * Execute a raw SQL statement (DDL or DML).
+     * Returns the number of affected rows.
+     */
+    executeRaw?(sql: string, params?: unknown[]): Promise<number>;
+    /**
+     * Execute a raw SQL query and return rows.
+     */
+    queryRaw?<T extends Record<string, unknown>>(sql: string, params?: unknown[]): Promise<T[]>;
+    /**
+     * Clone the database for migration testing.
+     * Returns a connection string or path for the clone.
+     */
+    cloneDatabase?(targetName: string): Promise<string>;
+    /**
+     * Drop a cloned database.
+     */
+    dropClone?(targetName: string): Promise<void>;
+    /**
+     * Acquire an advisory lock for migration safety.
+     * Returns a release function.
+     */
+    acquireMigrationLock?(): Promise<() => Promise<void>>;
 }
 /**
  * Database configuration options.
@@ -327,6 +362,11 @@ export interface MomentumConfig {
      * Plugins run in array order during init/ready, reverse during shutdown.
      */
     plugins?: MomentumPlugin[];
+    /**
+     * Migration system configuration.
+     * When set, enables the schema migration system.
+     */
+    migrations?: MigrationConfig;
 }
 /**
  * Resolved seeding options with defaults applied.
@@ -346,6 +386,7 @@ export interface ResolvedMomentumConfig extends MomentumConfig {
     server: Required<ServerConfig>;
     seeding?: ResolvedSeedingConfig;
     logging: ResolvedLoggingConfig;
+    migrations?: ResolvedMigrationConfig;
 }
 /**
  * Defines Momentum CMS configuration.

package/src/lib/migrations.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Migration Types for Momentum CMS
+ *
+ * Universal (browser + server) types for the migration system.
+ * Server-only implementation lives in @momentumcms/migrations.
+ */
+/**
+ * Configuration for the migration system.
+ * Added to MomentumConfig.migrations when migrations are enabled.
+ */
+export interface MigrationConfig {
+    /**
+     * Directory where migration files are stored.
+     * Relative to the app root.
+     * @default './migrations'
+     */
+    directory?: string;
+    /**
+     * Database operation mode.
+     * - 'push': Dev mode — direct schema sync, no migration files
+     * - 'migrate': Production mode — migration files required
+     * - 'auto': 'push' in development, 'migrate' in production
+     * @default 'auto'
+     */
+    mode?: 'push' | 'migrate' | 'auto';
+    /**
+     * Enable clone-test-apply safety pipeline before applying migrations.
+     * When enabled, migrations are first tested on a database clone.
+     * @default true in migrate mode
+     */
+    cloneTest?: boolean;
+    /**
+     * Enable dangerous operation detection and warnings.
+     * @default true
+     */
+    dangerDetection?: boolean;
+    /**
+     * Automatically apply pending migrations on server start.
+     * Only applies in 'push' mode. Migrate mode always requires explicit CLI commands.
+     * @default true in push mode
+     */
+    autoApply?: boolean;
+}
+/**
+ * Status of an individual applied migration.
+ */
+export interface MigrationStatus {
+    /** Migration filename (without extension) */
+    name: string;
+    /** Batch number (migrations applied together share a batch) */
+    batch: number;
+    /** When the migration was applied (ISO string) */
+    appliedAt: string;
+    /** SHA-256 checksum of the migration file */
+    checksum: string;
+    /** How long the migration took to execute (ms) */
+    executionMs: number;
+}
+/**
+ * Overall migration system status (browser-safe for admin UI).
+ */
+export interface MigrationSystemStatus {
+    /** Whether the database schema matches the collection config */
+    inSync: boolean;
+    /** Number of pending (unapplied) migrations */
+    pending: number;
+    /** List of applied migrations */
+    applied: MigrationStatus[];
+    /** Current migration mode */
+    mode: 'push' | 'migrate';
+}
+/**
+ * Severity levels for dangerous operation warnings.
+ */
+export type DangerSeverity = 'warning' | 'destructive' | 'irreversible';
+/**
+ * Resolved migration config with defaults applied.
+ */
+export interface ResolvedMigrationConfig extends MigrationConfig {
+    directory: string;
+    mode: 'push' | 'migrate';
+    cloneTest: boolean;
+    dangerDetection: boolean;
+    autoApply: boolean;
+}
+/**
+ * Resolve the effective migration mode from config and environment.
+ */
+export declare function resolveMigrationMode(mode: MigrationConfig['mode']): 'push' | 'migrate';
+/**
+ * Resolve migration config with defaults applied.
+ */
+export declare function resolveMigrationConfig(config: MigrationConfig | undefined): ResolvedMigrationConfig | undefined;

package/src/lib/plugins.d.ts

@@ -17,8 +17,14 @@ export interface PluginMiddlewareDescriptor {
     path: string;
     /** Express Router or middleware function. Typed as unknown to avoid Express dependency in core. */
     handler: unknown;
-    /** Where to mount relative to collection CRUD routes. @default 'before-api' */
-    position?: 'before-api' | 'after-api';
+    /**
+     * Where to mount relative to collection CRUD routes.
+     * - 'before-api': Before collection CRUD routes (under /api)
+     * - 'after-api': After collection CRUD routes (under /api)
+     * - 'root': Mounted at the application root (not under /api)
+     * @default 'before-api'
+     */
+    position?: 'before-api' | 'after-api' | 'root';
 }
 /**
  * Descriptor for Angular DI providers that a plugin wants auto-registered during SSR.

package/CHANGELOG.md

@@ -1,117 +0,0 @@
-## 0.2.0 (2026-02-17)
-
-### 🚀 Features
-
-- add named tabs support with nested data grouping and tab UI improvements ([63ab63e](https://github.com/DonaldMurillo/momentum-cms/commit/63ab63e))
-
-### ❤️ Thank You
-
-- Claude Opus 4.6
-- Donald Murillo @DonaldMurillo
-
-## 0.1.10 (2026-02-17)
-
-### 🩹 Fixes
-
-- **create-momentum-app:** add shell option to execFileSync for Windows ([#28](https://github.com/DonaldMurillo/momentum-cms/pull/28))
-
-### ❤️ Thank You
-
-- Claude Opus 4.6
-- Donald Murillo @DonaldMurillo
-
-## 0.1.9 (2026-02-16)
-
-This was a version bump only for core to align it with other projects, there were no code changes.
-
-## 0.1.8 (2026-02-16)
-
-### 🩹 Fixes
-
-- correct repository URLs and add GitHub link to CLI ([#26](https://github.com/DonaldMurillo/momentum-cms/pull/26))
-
-### ❤️ Thank You
-
-- Claude Opus 4.6
-- Donald Murillo @DonaldMurillo
-
-## 0.1.7 (2026-02-16)
-
-### 🩹 Fixes
-
-- correct repository URLs and add GitHub link to CLI output ([f7e96bb](https://github.com/DonaldMurillo/momentum-cms/commit/f7e96bb))
-
-### ❤️ Thank You
-
-- Claude Opus 4.6
-- Donald Murillo @DonaldMurillo
-
-## 0.1.6 (2026-02-16)
-
-This was a version bump only for core to align it with other projects, there were no code changes.
-
-## 0.1.5 (2026-02-16)
-
-### 🚀 Features
-
-- **create-app:** add landing page, fix setup flow, theme detection, type generator, Playwright E2E ([5e0f4ed](https://github.com/DonaldMurillo/momentum-cms/commit/5e0f4ed))
-
-### ❤️ Thank You
-
-- Claude Opus 4.6
-- Donald Murillo @DonaldMurillo
-
-## 0.1.4 (2026-02-16)
-
-This was a version bump only for core to align it with other projects, there were no code changes.
-
-## 0.1.3 (2026-02-16)
-
-This was a version bump only for core to align it with other projects, there were no code changes.
-
-## 0.1.2 (2026-02-16)
-
-### 🩹 Fixes
-
-- **release:** centralize manifestRootsToUpdate to update both source and dist ([2b8f832](https://github.com/DonaldMurillo/momentum-cms/commit/2b8f832))
-- **create-app:** fix Angular SSR, Analog builds, and CJS/ESM compatibility ([28d4d0a](https://github.com/DonaldMurillo/momentum-cms/commit/28d4d0a))
-
-### ❤️ Thank You
-
-- Claude Opus 4.6
-- Donald Murillo @DonaldMurillo
-
-## 0.1.1 (2026-02-16)
-
-This was a version bump only for core to align it with other projects, there were no code changes.
-
-## 0.1.0 (2026-02-16)
-
-### 🚀 Features
-
-- implement soft deletes with full stack support ([#22](https://github.com/DonaldMurillo/momentum-cms/pull/22))
-- add tracking rules, content performance, and block analytics ([#21](https://github.com/DonaldMurillo/momentum-cms/pull/21))
-- implement globals (singleton collections) with full stack support ([#20](https://github.com/DonaldMurillo/momentum-cms/pull/20))
-- visual block editor & auth-gated admin mode ([#18](https://github.com/DonaldMurillo/momentum-cms/pull/18))
-- Add display formatting and complex field rendering ([#14](https://github.com/DonaldMurillo/momentum-cms/pull/14))
-- UI polish fixes and database-level FK constraints for relationship integrity ([#13](https://github.com/DonaldMurillo/momentum-cms/pull/13))
-- Add document versioning and drafts system ([#5](https://github.com/DonaldMurillo/momentum-cms/pull/5))
-- Add seeding feature with idempotent data initialization ([#1](https://github.com/DonaldMurillo/momentum-cms/pull/1))
-- Add typed access control helper functions ([980d8d0](https://github.com/DonaldMurillo/momentum-cms/commit/980d8d0))
-- Add type-safe Momentum API with signal support ([aee6c02](https://github.com/DonaldMurillo/momentum-cms/commit/aee6c02))
-- Implement admin UI with API integration and SSR hydration ([9ed7b2b](https://github.com/DonaldMurillo/momentum-cms/commit/9ed7b2b))
-- Initialize Momentum CMS foundation ([f64f581](https://github.com/DonaldMurillo/momentum-cms/commit/f64f581))
-
-### 🩹 Fixes
-
-- resolve CUD toast interceptor issues ([#17](https://github.com/DonaldMurillo/momentum-cms/pull/17), [#1](https://github.com/DonaldMurillo/momentum-cms/issues/1), [#2](https://github.com/DonaldMurillo/momentum-cms/issues/2), [#3](https://github.com/DonaldMurillo/momentum-cms/issues/3), [#4](https://github.com/DonaldMurillo/momentum-cms/issues/4))
-- address 7 critical and high-severity security and validation bugs ([#12](https://github.com/DonaldMurillo/momentum-cms/pull/12))
-- address security vulnerabilities from code review ([#9](https://github.com/DonaldMurillo/momentum-cms/pull/9))
-- address security and reliability issues from code review ([#7](https://github.com/DonaldMurillo/momentum-cms/pull/7))
-
-### ❤️ Thank You
-
-- Claude Haiku 4.5
-- Claude Opus 4.5
-- Claude Opus 4.6
-- Donald Murillo @DonaldMurillo

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2024-present Momentum CMS Contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/README.md

@@ -1,11 +0,0 @@
-# core
-
-This library was generated with [Nx](https://nx.dev).
-
-## Building
-
-Run `nx build core` to build the library.
-
-## Running unit tests
-
-Run `nx test core` to execute the unit tests via [Jest](https://jestjs.io).