@momentumcms/plugins-analytics 0.3.0 → 0.4.0

package/lib/collectors/block-field-injector.cjs

@@ -0,0 +1,206 @@
+"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/analytics/src/lib/collectors/block-field-injector.ts
+var block_field_injector_exports = {};
+__export(block_field_injector_exports, {
+  injectBlockAnalyticsFields: () => injectBlockAnalyticsFields
+});
+module.exports = __toCommonJS(block_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 number(name, options = {}) {
+  return {
+    name,
+    type: "number",
+    ...options
+  };
+}
+function checkbox(name, options = {}) {
+  return {
+    name,
+    type: "checkbox",
+    ...options,
+    defaultValue: options.defaultValue ?? false
+  };
+}
+function group(name, options) {
+  return {
+    name,
+    type: "group",
+    ...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/plugins/analytics/src/lib/collectors/block-field-injector.ts
+function createAnalyticsGroupField() {
+  return group("_analytics", {
+    label: "Analytics",
+    admin: { collapsible: true, defaultOpen: false },
+    fields: [
+      checkbox("trackImpressions", { label: "Track Impressions" }),
+      checkbox("trackHover", { label: "Track Hover" })
+    ]
+  });
+}
+function hasAnalyticsField(fields) {
+  return fields.some((f) => f.name === "_analytics" && f.type === "group");
+}
+function hasBlocks(field) {
+  return field.type === "blocks" && "blocks" in field;
+}
+function hasNestedFields(field) {
+  return "fields" in field && Array.isArray(field.fields);
+}
+function hasTabs(field) {
+  return field.type === "tabs" && "tabs" in field;
+}
+function injectIntoFields(fields) {
+  for (const field of fields) {
+    if (hasBlocks(field)) {
+      for (const blockConfig of field.blocks) {
+        if (!hasAnalyticsField(blockConfig.fields)) {
+          blockConfig.fields.push(createAnalyticsGroupField());
+        }
+      }
+    }
+    if ((field.type === "group" || field.type === "array" || field.type === "collapsible" || field.type === "row") && hasNestedFields(field)) {
+      injectIntoFields(field.fields);
+    }
+    if (hasTabs(field)) {
+      for (const tab of field.tabs) {
+        injectIntoFields(tab.fields);
+      }
+    }
+  }
+}
+function injectBlockAnalyticsFields(collections) {
+  for (const collection of collections) {
+    injectIntoFields(collection.fields);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  injectBlockAnalyticsFields
+});

package/lib/collectors/block-field-injector.js

@@ -0,0 +1,179 @@
+// 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 checkbox(name, options = {}) {
+  return {
+    name,
+    type: "checkbox",
+    ...options,
+    defaultValue: options.defaultValue ?? false
+  };
+}
+function group(name, options) {
+  return {
+    name,
+    type: "group",
+    ...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/plugins/analytics/src/lib/collectors/block-field-injector.ts
+function createAnalyticsGroupField() {
+  return group("_analytics", {
+    label: "Analytics",
+    admin: { collapsible: true, defaultOpen: false },
+    fields: [
+      checkbox("trackImpressions", { label: "Track Impressions" }),
+      checkbox("trackHover", { label: "Track Hover" })
+    ]
+  });
+}
+function hasAnalyticsField(fields) {
+  return fields.some((f) => f.name === "_analytics" && f.type === "group");
+}
+function hasBlocks(field) {
+  return field.type === "blocks" && "blocks" in field;
+}
+function hasNestedFields(field) {
+  return "fields" in field && Array.isArray(field.fields);
+}
+function hasTabs(field) {
+  return field.type === "tabs" && "tabs" in field;
+}
+function injectIntoFields(fields) {
+  for (const field of fields) {
+    if (hasBlocks(field)) {
+      for (const blockConfig of field.blocks) {
+        if (!hasAnalyticsField(blockConfig.fields)) {
+          blockConfig.fields.push(createAnalyticsGroupField());
+        }
+      }
+    }
+    if ((field.type === "group" || field.type === "array" || field.type === "collapsible" || field.type === "row") && hasNestedFields(field)) {
+      injectIntoFields(field.fields);
+    }
+    if (hasTabs(field)) {
+      for (const tab of field.tabs) {
+        injectIntoFields(tab.fields);
+      }
+    }
+  }
+}
+function injectBlockAnalyticsFields(collections) {
+  for (const collection of collections) {
+    injectIntoFields(collection.fields);
+  }
+}
+export {
+  injectBlockAnalyticsFields
+};

package/package.json

@@ -1,56 +1,61 @@
 {
-  "name": "@momentumcms/plugins-analytics",
-  "version": "0.3.0",
-  "description": "Analytics and content tracking plugin for Momentum CMS",
-  "license": "MIT",
-  "author": "Momentum CMS Contributors",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/DonaldMurillo/momentum-cms.git",
-    "directory": "libs/plugins/analytics"
-  },
-  "homepage": "https://github.com/DonaldMurillo/momentum-cms#readme",
-  "bugs": {
-    "url": "https://github.com/DonaldMurillo/momentum-cms/issues"
-  },
-  "keywords": [
-    "cms",
-    "momentum-cms",
-    "analytics",
-    "tracking",
-    "content-performance"
-  ],
-  "engines": {
-    "node": ">=18"
-  },
-  "main": "./index.cjs",
-  "types": "./src/index.d.ts",
-  "dependencies": {
-    "@angular/aria": "^21.1.2",
-    "@angular/cdk": "^21.1.2",
-    "@angular/common": "~21.1.0",
-    "@angular/core": "~21.1.0",
-    "@angular/forms": "~21.1.0",
-    "@angular/router": "~21.1.0",
-    "@aws-sdk/client-s3": "^3.983.0",
-    "@aws-sdk/s3-request-presigner": "^3.983.0",
-    "@momentumcms/core": "0.3.0",
-    "@momentumcms/logger": "0.3.0",
-    "@momentumcms/plugins-core": "0.3.0",
-    "@momentumcms/server-core": "0.3.0",
-    "@ng-icons/core": "^33.0.0",
-    "@ng-icons/heroicons": "^33.0.0",
-    "express": "^4.21.0",
-    "graphql": "^16.12.0",
-    "rxjs": "~7.8.0"
-  },
-  "peerDependencies": {
-    "pg": "^8.0.0"
-  },
-  "peerDependenciesMeta": {
-    "pg": {
-      "optional": true
-    }
-  },
-  "module": "./index.js"
-}
+	"name": "@momentumcms/plugins-analytics",
+	"version": "0.4.0",
+	"description": "Analytics and content tracking plugin for Momentum CMS",
+	"license": "MIT",
+	"author": "Momentum CMS Contributors",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/DonaldMurillo/momentum-cms.git",
+		"directory": "libs/plugins/analytics"
+	},
+	"homepage": "https://github.com/DonaldMurillo/momentum-cms#readme",
+	"bugs": {
+		"url": "https://github.com/DonaldMurillo/momentum-cms/issues"
+	},
+	"keywords": [
+		"cms",
+		"momentum-cms",
+		"analytics",
+		"tracking",
+		"content-performance"
+	],
+	"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/analytics-admin-routes.d.ts",
+			"default": "./lib/analytics-admin-routes.cjs"
+		},
+		"./block-fields": {
+			"types": "./src/lib/collectors/block-field-injector.d.ts",
+			"default": "./lib/collectors/block-field-injector.cjs"
+		},
+		"./client": {
+			"types": "./src/lib/client/tracker.d.ts",
+			"default": "./lib/client/tracker.cjs"
+		}
+	},
+	"dependencies": {
+		"@momentumcms/core": "0.4.0",
+		"@momentumcms/logger": "0.4.0",
+		"@momentumcms/plugins-core": "0.4.0",
+		"@momentumcms/server-core": "0.4.0",
+		"express": "^4.21.0"
+	},
+	"peerDependencies": {
+		"pg": "^8.0.0"
+	},
+	"peerDependenciesMeta": {
+		"pg": {
+			"optional": true
+		}
+	}
+}

package/src/lib/analytics-admin-routes.d.ts

@@ -0,0 +1,3 @@
+import type { PluginAdminRouteDescriptor } from '@momentumcms/core';
+
+export declare const analyticsAdminRoutes: PluginAdminRouteDescriptor[];

package/CHANGELOG.md

@@ -1,99 +0,0 @@
-## 0.3.0 (2026-02-20)
-
-### 🚀 Features
-
-- add named tabs support with nested data grouping and UI improvements ([#30](https://github.com/DonaldMurillo/momentum-cms/pull/30))
-
-### ❤️ Thank You
-
-- Claude Opus 4.6
-- Donald Murillo @DonaldMurillo
-
-## 0.2.0 (2026-02-17)
-
-This was a version bump only for plugins-analytics to align it with other projects, there were no code changes.
-
-## 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 plugins-analytics 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 plugins-analytics to align it with other projects, there were no code changes.
-
-## 0.1.5 (2026-02-16)
-
-This was a version bump only for plugins-analytics to align it with other projects, there were no code changes.
-
-## 0.1.4 (2026-02-16)
-
-This was a version bump only for plugins-analytics to align it with other projects, there were no code changes.
-
-## 0.1.3 (2026-02-16)
-
-This was a version bump only for plugins-analytics 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 plugins-analytics to align it with other projects, there were no code changes.
-
-## 0.1.0 (2026-02-16)
-
-### 🚀 Features
-
-- add tracking rules, content performance, and block analytics ([#21](https://github.com/DonaldMurillo/momentum-cms/pull/21))
-
-### 🩹 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))
-
-### ❤️ Thank You
-
-- Claude Haiku 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.