@momentumcms/plugins-seo 0.4.0

package/lib/seo-field-injector.cjs

@@ -0,0 +1,312 @@
+"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/plugins/seo/src/lib/seo-field-injector.ts
+var seo_field_injector_exports = {};
+__export(seo_field_injector_exports, {
+  injectSeoFields: () => injectSeoFields
+});
+module.exports = __toCommonJS(seo_field_injector_exports);
+
+// 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 textarea(name, options = {}) {
+  return {
+    name,
+    type: "textarea",
+    ...options
+  };
+}
+function number(name, options = {}) {
+  return {
+    name,
+    type: "number",
+    ...options
+  };
+}
+function checkbox(name, options = {}) {
+  return {
+    name,
+    type: "checkbox",
+    ...options,
+    defaultValue: options.defaultValue ?? false
+  };
+}
+function select(name, options) {
+  return {
+    name,
+    type: "select",
+    ...options
+  };
+}
+function upload(name, options = {}) {
+  return {
+    name,
+    type: "upload",
+    relationTo: options.relationTo ?? "media",
+    ...options
+  };
+}
+function json(name, options = {}) {
+  return {
+    name,
+    type: "json",
+    ...options
+  };
+}
+function tabs(name, options) {
+  return {
+    name,
+    type: "tabs",
+    ...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/plugins/seo/src/lib/seo-fields.ts
+function getSeoFields() {
+  return [
+    text("metaTitle", {
+      label: "Meta Title",
+      maxLength: 70,
+      description: "Title tag for search engines (50-60 chars recommended)"
+    }),
+    textarea("metaDescription", {
+      label: "Meta Description",
+      maxLength: 160,
+      rows: 3,
+      description: "Description for search results (120-155 chars recommended)"
+    }),
+    text("canonicalUrl", {
+      label: "Canonical URL",
+      description: "Override the canonical URL for this page"
+    }),
+    text("focusKeyword", {
+      label: "Focus Keyword",
+      description: "Primary keyword to optimize this content for"
+    }),
+    text("ogTitle", {
+      label: "OG Title",
+      description: "Open Graph title (falls back to Meta Title)"
+    }),
+    textarea("ogDescription", {
+      label: "OG Description",
+      rows: 2,
+      description: "Open Graph description (falls back to Meta Description)"
+    }),
+    upload("ogImage", {
+      label: "OG Image",
+      relationTo: "media",
+      mimeTypes: ["image/*"],
+      description: "Recommended size: 1200x630px"
+    }),
+    select("ogType", {
+      label: "OG Type",
+      options: [
+        { label: "Website", value: "website" },
+        { label: "Article", value: "article" },
+        { label: "Product", value: "product" },
+        { label: "Profile", value: "profile" }
+      ],
+      defaultValue: "website"
+    }),
+    select("twitterCard", {
+      label: "Twitter Card",
+      options: [
+        { label: "Summary", value: "summary" },
+        { label: "Summary Large Image", value: "summary_large_image" },
+        { label: "Player", value: "player" },
+        { label: "App", value: "app" }
+      ],
+      defaultValue: "summary_large_image"
+    }),
+    checkbox("noIndex", {
+      label: "No Index",
+      description: "Tell search engines not to index this page"
+    }),
+    checkbox("noFollow", {
+      label: "No Follow",
+      description: "Tell search engines not to follow links on this page"
+    }),
+    checkbox("excludeFromSitemap", {
+      label: "Exclude from Sitemap",
+      description: "Exclude this page from the XML sitemap without affecting search engine indexing"
+    }),
+    json("structuredData", {
+      label: "Structured Data (JSON-LD)",
+      description: "Custom JSON-LD structured data for this page"
+    })
+  ];
+}
+function createSeoTabConfig() {
+  return {
+    name: "seo",
+    label: "SEO",
+    description: "Search engine optimization settings",
+    fields: getSeoFields()
+  };
+}
+
+// libs/plugins/seo/src/lib/seo-utils.ts
+function hasSeoField(collection) {
+  for (const field of collection.fields) {
+    if (field.name === "seo" && field.type === "group")
+      return true;
+    if (field.type === "tabs") {
+      const tabsField = field;
+      if (tabsField.tabs.some((t) => t.name === "seo"))
+        return true;
+    }
+  }
+  return false;
+}
+
+// libs/plugins/seo/src/lib/seo-field-injector.ts
+function shouldInject(collection, options) {
+  if (collection.managed)
+    return false;
+  if (collection.slug.startsWith("seo-"))
+    return false;
+  if (options.collections === "*") {
+    return !(options.excludeCollections ?? []).includes(collection.slug);
+  }
+  return options.collections.includes(collection.slug);
+}
+function findTopLevelTabs(collection) {
+  return collection.fields.find((f) => f.type === "tabs");
+}
+function injectSeoFields(collections, options) {
+  const seoTab = createSeoTabConfig();
+  for (const collection of collections) {
+    if (!shouldInject(collection, options))
+      continue;
+    if (hasSeoField(collection))
+      continue;
+    const existingTabs = findTopLevelTabs(collection);
+    if (existingTabs) {
+      existingTabs.tabs.push(seoTab);
+    } else {
+      const originalFields = [...collection.fields];
+      const tabsField = tabs("seoTabs", {
+        tabs: [{ label: "Content", fields: originalFields }, seoTab]
+      });
+      collection.fields = [tabsField];
+    }
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  injectSeoFields
+});

package/lib/seo-field-injector.js

@@ -0,0 +1,285 @@
+// 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 textarea(name, options = {}) {
+  return {
+    name,
+    type: "textarea",
+    ...options
+  };
+}
+function number(name, options = {}) {
+  return {
+    name,
+    type: "number",
+    ...options
+  };
+}
+function checkbox(name, options = {}) {
+  return {
+    name,
+    type: "checkbox",
+    ...options,
+    defaultValue: options.defaultValue ?? false
+  };
+}
+function select(name, options) {
+  return {
+    name,
+    type: "select",
+    ...options
+  };
+}
+function upload(name, options = {}) {
+  return {
+    name,
+    type: "upload",
+    relationTo: options.relationTo ?? "media",
+    ...options
+  };
+}
+function json(name, options = {}) {
+  return {
+    name,
+    type: "json",
+    ...options
+  };
+}
+function tabs(name, options) {
+  return {
+    name,
+    type: "tabs",
+    ...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/plugins/seo/src/lib/seo-fields.ts
+function getSeoFields() {
+  return [
+    text("metaTitle", {
+      label: "Meta Title",
+      maxLength: 70,
+      description: "Title tag for search engines (50-60 chars recommended)"
+    }),
+    textarea("metaDescription", {
+      label: "Meta Description",
+      maxLength: 160,
+      rows: 3,
+      description: "Description for search results (120-155 chars recommended)"
+    }),
+    text("canonicalUrl", {
+      label: "Canonical URL",
+      description: "Override the canonical URL for this page"
+    }),
+    text("focusKeyword", {
+      label: "Focus Keyword",
+      description: "Primary keyword to optimize this content for"
+    }),
+    text("ogTitle", {
+      label: "OG Title",
+      description: "Open Graph title (falls back to Meta Title)"
+    }),
+    textarea("ogDescription", {
+      label: "OG Description",
+      rows: 2,
+      description: "Open Graph description (falls back to Meta Description)"
+    }),
+    upload("ogImage", {
+      label: "OG Image",
+      relationTo: "media",
+      mimeTypes: ["image/*"],
+      description: "Recommended size: 1200x630px"
+    }),
+    select("ogType", {
+      label: "OG Type",
+      options: [
+        { label: "Website", value: "website" },
+        { label: "Article", value: "article" },
+        { label: "Product", value: "product" },
+        { label: "Profile", value: "profile" }
+      ],
+      defaultValue: "website"
+    }),
+    select("twitterCard", {
+      label: "Twitter Card",
+      options: [
+        { label: "Summary", value: "summary" },
+        { label: "Summary Large Image", value: "summary_large_image" },
+        { label: "Player", value: "player" },
+        { label: "App", value: "app" }
+      ],
+      defaultValue: "summary_large_image"
+    }),
+    checkbox("noIndex", {
+      label: "No Index",
+      description: "Tell search engines not to index this page"
+    }),
+    checkbox("noFollow", {
+      label: "No Follow",
+      description: "Tell search engines not to follow links on this page"
+    }),
+    checkbox("excludeFromSitemap", {
+      label: "Exclude from Sitemap",
+      description: "Exclude this page from the XML sitemap without affecting search engine indexing"
+    }),
+    json("structuredData", {
+      label: "Structured Data (JSON-LD)",
+      description: "Custom JSON-LD structured data for this page"
+    })
+  ];
+}
+function createSeoTabConfig() {
+  return {
+    name: "seo",
+    label: "SEO",
+    description: "Search engine optimization settings",
+    fields: getSeoFields()
+  };
+}
+
+// libs/plugins/seo/src/lib/seo-utils.ts
+function hasSeoField(collection) {
+  for (const field of collection.fields) {
+    if (field.name === "seo" && field.type === "group")
+      return true;
+    if (field.type === "tabs") {
+      const tabsField = field;
+      if (tabsField.tabs.some((t) => t.name === "seo"))
+        return true;
+    }
+  }
+  return false;
+}
+
+// libs/plugins/seo/src/lib/seo-field-injector.ts
+function shouldInject(collection, options) {
+  if (collection.managed)
+    return false;
+  if (collection.slug.startsWith("seo-"))
+    return false;
+  if (options.collections === "*") {
+    return !(options.excludeCollections ?? []).includes(collection.slug);
+  }
+  return options.collections.includes(collection.slug);
+}
+function findTopLevelTabs(collection) {
+  return collection.fields.find((f) => f.type === "tabs");
+}
+function injectSeoFields(collections, options) {
+  const seoTab = createSeoTabConfig();
+  for (const collection of collections) {
+    if (!shouldInject(collection, options))
+      continue;
+    if (hasSeoField(collection))
+      continue;
+    const existingTabs = findTopLevelTabs(collection);
+    if (existingTabs) {
+      existingTabs.tabs.push(seoTab);
+    } else {
+      const originalFields = [...collection.fields];
+      const tabsField = tabs("seoTabs", {
+        tabs: [{ label: "Content", fields: originalFields }, seoTab]
+      });
+      collection.fields = [tabsField];
+    }
+  }
+}
+export {
+  injectSeoFields
+};

package/package.json

@@ -0,0 +1,54 @@
+{
+	"name": "@momentumcms/plugins-seo",
+	"version": "0.4.0",
+	"description": "SEO plugin for Momentum CMS — meta tags, sitemap, robots.txt, analysis",
+	"license": "MIT",
+	"author": "Momentum CMS Contributors",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/DonaldMurillo/momentum-cms.git",
+		"directory": "libs/plugins/seo"
+	},
+	"homepage": "https://github.com/DonaldMurillo/momentum-cms#readme",
+	"bugs": {
+		"url": "https://github.com/DonaldMurillo/momentum-cms/issues"
+	},
+	"keywords": [
+		"cms",
+		"momentum-cms",
+		"seo",
+		"sitemap",
+		"meta-tags",
+		"robots-txt",
+		"open-graph"
+	],
+	"engines": {
+		"node": ">=18"
+	},
+	"main": "./index.cjs",
+	"types": "./src/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./src/index.d.ts",
+			"default": "./index.cjs"
+		},
+		"./admin-routes": {
+			"types": "./src/lib/seo-admin-routes.d.ts",
+			"default": "./lib/seo-admin-routes.cjs"
+		},
+		"./fields": {
+			"types": "./src/lib/seo-field-injector.d.ts",
+			"default": "./lib/seo-field-injector.cjs"
+		}
+	},
+	"dependencies": {
+		"@angular/common": "^21.0.0",
+		"@angular/core": "^21.0.0",
+		"@momentumcms/core": "0.4.0",
+		"@momentumcms/plugins-core": "0.4.0",
+		"@momentumcms/ui": "0.4.0",
+		"@ng-icons/core": "^33.0.0",
+		"@ng-icons/heroicons": "^33.0.0",
+		"express": "^4.21.0"
+	}
+}

package/src/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @momentumcms/plugins/seo
+ *
+ * SEO plugin for Momentum CMS.
+ * Provides meta tags, sitemap, robots.txt, and content analysis.
+ */
+export { seoPlugin } from './lib/seo-plugin';
+export type { SeoPluginConfig, SeoAnalysisConfig, SeoScoringRule, SeoScoringContext, SeoFieldData, SitemapConfig, SitemapChangeFreq, RobotsConfig, RobotsRule, } from './lib/seo-config.types';
+export type { SeoAnalysisResult, SeoRuleResult, MetaTags } from './lib/analysis/seo-analysis.types';
+export { injectSeoFields } from './lib/seo-field-injector';
+export type { SeoFieldInjectorOptions } from './lib/seo-field-injector';

package/src/lib/analysis/seo-analysis-collection.d.ts

@@ -0,0 +1,7 @@
+/**
+ * SEO Analysis Collection
+ *
+ * Stores SEO analysis results per document.
+ * Hidden from sidebar — accessed via SEO dashboard.
+ */
+export declare const SeoAnalysis: import("@momentumcms/core").CollectionConfig;

package/src/lib/analysis/seo-analysis-hooks.d.ts

@@ -0,0 +1,13 @@
+/**
+ * SEO Analysis Hooks
+ *
+ * Injects afterChange hooks into SEO-enabled collections to trigger
+ * asynchronous content analysis after document saves.
+ */
+import type { CollectionConfig } from '@momentumcms/core';
+import type { MomentumAPI } from '@momentumcms/plugins/core';
+import type { SeoAnalysisConfig } from '../seo-config.types';
+/**
+ * Inject afterChange hooks for SEO analysis into eligible collections.
+ */
+export declare function injectSeoAnalysisHooks(collections: CollectionConfig[], config: SeoAnalysisConfig, getApi: () => MomentumAPI | null): void;