@momentumcms/plugins-analytics 0.4.0 → 0.4.1

package/lib/analytics-admin-routes.js

@@ -296,6 +296,7 @@ import {
   PLATFORM_ID as PLATFORM_ID2
 } from "@angular/core";
 import { isPlatformBrowser as isPlatformBrowser2 } from "@angular/common";
+import { Router, ActivatedRoute } from "@angular/router";
 import {
   Card as Card2,
   CardHeader as CardHeader2,
@@ -329,6 +330,8 @@ var init_analytics_dashboard_page = __esm({
       constructor() {
         this.analytics = inject2(AnalyticsService);
         this.platformId = inject2(PLATFORM_ID2);
+        this.router = inject2(Router);
+        this.route = inject2(ActivatedRoute);
         /** Date range options */
         this.dateRanges = [
           {
@@ -366,15 +369,12 @@ var init_analytics_dashboard_page = __esm({
         this.currentPage = signal3(1);
         /** Events per page */
         this.pageSize = 20;
-        /** Filtered events based on selected category (client-side filter on top of server query) */
+        /** Events from server query (filtered server-side by category when selected) */
         this.filteredEvents = computed2(() => {
           const result = this.analytics.events();
           if (!result)
             return [];
-          const cat = this.selectedCategory();
-          if (cat === "all")
-            return result.events;
-          return result.events.filter((e) => e.category === cat);
+          return result.events;
         });
         /** Total pages for pagination */
         this.totalPages = computed2(() => {
@@ -394,6 +394,22 @@ var init_analytics_dashboard_page = __esm({
       ngOnInit() {
         if (!isPlatformBrowser2(this.platformId))
           return;
+        const params = this.route.snapshot.queryParams;
+        if (params["range"] && this.dateRanges.some((r) => r.value === params["range"])) {
+          this.selectedRange.set(params["range"]);
+        }
+        if (params["category"] && this.categoryFilters.some((c) => c.value === params["category"])) {
+          this.selectedCategory.set(params["category"]);
+        }
+        if (params["search"]) {
+          this.searchTerm.set(params["search"]);
+        }
+        if (params["page"]) {
+          const page = parseInt(params["page"], 10);
+          if (!isNaN(page) && page > 0) {
+            this.currentPage.set(page);
+          }
+        }
         void this.refresh();
       }
       /**
@@ -404,13 +420,15 @@ var init_analytics_dashboard_page = __esm({
         const from = dateRange?.getFrom();
         const search = this.searchTerm() || void 0;
         const page = this.currentPage();
+        const category = this.selectedCategory();
         await Promise.all([
           this.analytics.fetchSummary({ from }),
           this.analytics.queryEvents({
             limit: this.pageSize,
             page,
             from,
-            search
+            search,
+            category: category !== "all" ? category : void 0
           })
         ]);
       }
@@ -420,13 +438,17 @@ var init_analytics_dashboard_page = __esm({
       setDateRange(range) {
         this.selectedRange.set(range.value);
         this.currentPage.set(1);
+        this.syncUrlParams();
         void this.refresh();
       }
       /**
-       * Set category filter.
+       * Set category filter and re-query server.
        */
       setCategory(category) {
         this.selectedCategory.set(category);
+        this.currentPage.set(1);
+        this.syncUrlParams();
+        void this.refresh();
       }
       /**
        * Handle search input.
@@ -436,6 +458,7 @@ var init_analytics_dashboard_page = __esm({
         if (target instanceof HTMLInputElement) {
           this.searchTerm.set(target.value);
           this.currentPage.set(1);
+          this.syncUrlParams();
           void this.refresh();
         }
       }
@@ -444,8 +467,26 @@ var init_analytics_dashboard_page = __esm({
        */
       goToPage(page) {
         this.currentPage.set(page);
+        this.syncUrlParams();
         void this.refresh();
       }
+      /**
+       * Sync current filter state to URL query params.
+       */
+      syncUrlParams() {
+        const queryParams = {
+          range: this.selectedRange() !== "all" ? this.selectedRange() : null,
+          category: this.selectedCategory() !== "all" ? this.selectedCategory() : null,
+          search: this.searchTerm() || null,
+          page: this.currentPage() > 1 ? String(this.currentPage()) : null
+        };
+        void this.router.navigate([], {
+          relativeTo: this.route,
+          queryParams,
+          queryParamsHandling: "merge",
+          replaceUrl: true
+        });
+      }
       /**
        * Get total content operations count.
        */
@@ -1152,6 +1193,7 @@ import {
   PLATFORM_ID as PLATFORM_ID3
 } from "@angular/core";
 import { isPlatformBrowser as isPlatformBrowser3 } from "@angular/common";
+import { Router as Router2, ActivatedRoute as ActivatedRoute2 } from "@angular/router";
 import {
   Card as Card3,
   CardHeader as CardHeader3,
@@ -1180,6 +1222,8 @@ var init_content_performance_page = __esm({
       constructor() {
         this.service = inject3(ContentPerformanceService);
         this.platformId = inject3(PLATFORM_ID3);
+        this.router = inject3(Router2);
+        this.route = inject3(ActivatedRoute2);
         this.dateRanges = [
           {
             label: "24h",
@@ -1229,16 +1273,25 @@ var init_content_performance_page = __esm({
       ngOnInit() {
         if (!isPlatformBrowser3(this.platformId))
           return;
+        const params = this.route.snapshot.queryParams;
+        if (params["range"] && this.dateRanges.some((r) => r.value === params["range"])) {
+          this.selectedRange.set(params["range"]);
+        }
+        if (params["search"]) {
+          this.searchTerm.set(params["search"]);
+        }
         void this.fetchData();
       }
       setDateRange(range) {
         this.selectedRange.set(range.value);
         this.expandedRow.set(null);
+        this.syncUrlParams();
         void this.fetchData();
       }
       onSearch(event) {
         if (event.target instanceof HTMLInputElement) {
           this.searchTerm.set(event.target.value);
+          this.syncUrlParams();
         }
       }
       toggleRow(url) {
@@ -1249,6 +1302,18 @@ var init_content_performance_page = __esm({
         const from = range?.getFrom();
         await this.service.fetchTopPages({ from });
       }
+      syncUrlParams() {
+        const queryParams = {
+          range: this.selectedRange() !== "all" ? this.selectedRange() : null,
+          search: this.searchTerm() || null
+        };
+        void this.router.navigate([], {
+          relativeTo: this.route,
+          queryParams,
+          queryParamsHandling: "merge",
+          replaceUrl: true
+        });
+      }
     };
     ContentPerformancePage = __decorateClass([
       Component3({

package/lib/page-view-tracker.cjs

@@ -0,0 +1,208 @@
+"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);
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result)
+    __defProp(target, key, result);
+  return result;
+};
+
+// libs/plugins/analytics/src/lib/page-view-tracker.ts
+var page_view_tracker_exports = {};
+__export(page_view_tracker_exports, {
+  DEFAULT_EXCLUDE_PREFIXES: () => DEFAULT_EXCLUDE_PREFIXES,
+  PAGE_VIEW_TRACKING_CONFIG: () => PAGE_VIEW_TRACKING_CONFIG,
+  PageViewTrackerService: () => PageViewTrackerService,
+  buildPageViewEvent: () => buildPageViewEvent,
+  providePageViewTracking: () => providePageViewTracking,
+  shouldTrackNavigation: () => shouldTrackNavigation
+});
+module.exports = __toCommonJS(page_view_tracker_exports);
+var import_core = require("@angular/core");
+var import_common = require("@angular/common");
+var import_router = require("@angular/router");
+var import_http = require("@angular/common/http");
+var import_rxjs = require("rxjs");
+
+// libs/plugins/analytics/src/lib/utils/content-route-matcher.ts
+function escapeRegex(str) {
+  return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function compileContentRoute(collection, pattern) {
+  const segments = pattern.split("/").filter(Boolean);
+  const paramNames = [];
+  let staticCount = 0;
+  const regexParts = segments.map((seg) => {
+    if (seg.startsWith(":")) {
+      paramNames.push(seg.slice(1));
+      return "([^/]+)";
+    }
+    staticCount++;
+    return escapeRegex(seg);
+  });
+  const regexStr = "^/" + regexParts.join("/") + "/?$";
+  return {
+    collection,
+    pattern,
+    regex: new RegExp(regexStr),
+    paramNames,
+    staticSegments: staticCount
+  };
+}
+function compileContentRoutes(routes) {
+  const compiled = Object.entries(routes).map(
+    ([collection, pattern]) => compileContentRoute(collection, pattern)
+  );
+  compiled.sort((a, b) => b.staticSegments - a.staticSegments);
+  return compiled;
+}
+function matchContentRoute(path, routes) {
+  for (const route of routes) {
+    const match = route.regex.exec(path);
+    if (match) {
+      const params = {};
+      for (let i = 0; i < route.paramNames.length; i++) {
+        params[route.paramNames[i]] = match[i + 1];
+      }
+      return { collection: route.collection, params };
+    }
+  }
+  return void 0;
+}
+
+// libs/plugins/analytics/src/lib/page-view-tracker.utils.ts
+var DEFAULT_EXCLUDE_PREFIXES = ["/admin", "/api/"];
+function shouldTrackNavigation(url, isFirstNavigation, excludePrefixes) {
+  if (isFirstNavigation)
+    return false;
+  const path = url.split("?")[0].split("#")[0];
+  for (const prefix of excludePrefixes) {
+    if (path.startsWith(prefix))
+      return false;
+  }
+  return true;
+}
+function buildPageViewEvent(url, compiledRoutes) {
+  const path = url.split("?")[0].split("#")[0];
+  const properties = { path };
+  if (compiledRoutes) {
+    const routeMatch = matchContentRoute(path, compiledRoutes);
+    if (routeMatch) {
+      properties["collection"] = routeMatch.collection;
+      properties["slug"] = routeMatch.params["slug"];
+    }
+  }
+  return {
+    name: "page_view",
+    category: "page",
+    properties
+  };
+}
+
+// libs/plugins/analytics/src/lib/page-view-tracker.ts
+var PAGE_VIEW_TRACKING_CONFIG = new import_core.InjectionToken(
+  "PAGE_VIEW_TRACKING_CONFIG"
+);
+function getOrCreateStorageId(storage, key) {
+  let id = storage.getItem(key);
+  if (!id) {
+    id = Date.now().toString(36) + Math.random().toString(36).slice(2, 10);
+    storage.setItem(key, id);
+  }
+  return id;
+}
+var PageViewTrackerService = class {
+  constructor() {
+    this.router = (0, import_core.inject)(import_router.Router);
+    this.http = (0, import_core.inject)(import_http.HttpClient);
+    this.platformId = (0, import_core.inject)(import_core.PLATFORM_ID);
+    this.destroyRef = (0, import_core.inject)(import_core.DestroyRef);
+    this.config = (0, import_core.inject)(PAGE_VIEW_TRACKING_CONFIG);
+    this.doc = (0, import_core.inject)(import_common.DOCUMENT);
+    this.isFirstNavigation = true;
+    this.endpoint = this.config.endpoint ?? "/api/analytics/collect";
+    this.compiledRoutes = this.config.contentRoutes ? compileContentRoutes(this.config.contentRoutes) : void 0;
+    this.excludePrefixes = this.config.excludePrefixes ? [...DEFAULT_EXCLUDE_PREFIXES, ...this.config.excludePrefixes] : DEFAULT_EXCLUDE_PREFIXES;
+    if (!(0, import_common.isPlatformBrowser)(this.platformId))
+      return;
+    const sub = this.router.events.pipe((0, import_rxjs.filter)((e) => e instanceof import_router.NavigationEnd)).subscribe((event) => {
+      const url = event.urlAfterRedirects;
+      if (!shouldTrackNavigation(url, this.isFirstNavigation, this.excludePrefixes)) {
+        this.isFirstNavigation = false;
+        return;
+      }
+      this.isFirstNavigation = false;
+      this.trackPageView(url);
+    });
+    this.destroyRef.onDestroy(() => sub.unsubscribe());
+  }
+  trackPageView(url) {
+    const eventPayload = buildPageViewEvent(url, this.compiledRoutes);
+    const win = this.doc.defaultView;
+    let visitorId;
+    let sessionId;
+    try {
+      if (win?.localStorage)
+        visitorId = getOrCreateStorageId(win.localStorage, "_m_vid");
+      if (win?.sessionStorage)
+        sessionId = getOrCreateStorageId(win.sessionStorage, "_m_sid");
+    } catch {
+    }
+    const clientEvent = {
+      ...eventPayload,
+      context: {
+        url: win?.location?.href ?? "",
+        referrer: this.doc.referrer
+      },
+      visitorId,
+      sessionId
+    };
+    this.http.post(this.endpoint, { events: [clientEvent] }).subscribe();
+  }
+};
+PageViewTrackerService = __decorateClass([
+  (0, import_core.Injectable)()
+], PageViewTrackerService);
+function providePageViewTracking(config) {
+  return (0, import_core.makeEnvironmentProviders)([
+    { provide: PAGE_VIEW_TRACKING_CONFIG, useValue: config },
+    PageViewTrackerService,
+    {
+      provide: import_core.ENVIRONMENT_INITIALIZER,
+      multi: true,
+      useFactory: () => {
+        (0, import_core.inject)(PageViewTrackerService);
+        return () => {
+        };
+      }
+    }
+  ]);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_EXCLUDE_PREFIXES,
+  PAGE_VIEW_TRACKING_CONFIG,
+  PageViewTrackerService,
+  buildPageViewEvent,
+  providePageViewTracking,
+  shouldTrackNavigation
+});

package/lib/page-view-tracker.js

@@ -0,0 +1,189 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result)
+    __defProp(target, key, result);
+  return result;
+};
+
+// libs/plugins/analytics/src/lib/page-view-tracker.ts
+import {
+  Injectable,
+  InjectionToken,
+  inject,
+  DestroyRef,
+  PLATFORM_ID,
+  makeEnvironmentProviders,
+  ENVIRONMENT_INITIALIZER
+} from "@angular/core";
+import { DOCUMENT, isPlatformBrowser } from "@angular/common";
+import { Router, NavigationEnd } from "@angular/router";
+import { HttpClient } from "@angular/common/http";
+import { filter } from "rxjs";
+
+// libs/plugins/analytics/src/lib/utils/content-route-matcher.ts
+function escapeRegex(str) {
+  return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function compileContentRoute(collection, pattern) {
+  const segments = pattern.split("/").filter(Boolean);
+  const paramNames = [];
+  let staticCount = 0;
+  const regexParts = segments.map((seg) => {
+    if (seg.startsWith(":")) {
+      paramNames.push(seg.slice(1));
+      return "([^/]+)";
+    }
+    staticCount++;
+    return escapeRegex(seg);
+  });
+  const regexStr = "^/" + regexParts.join("/") + "/?$";
+  return {
+    collection,
+    pattern,
+    regex: new RegExp(regexStr),
+    paramNames,
+    staticSegments: staticCount
+  };
+}
+function compileContentRoutes(routes) {
+  const compiled = Object.entries(routes).map(
+    ([collection, pattern]) => compileContentRoute(collection, pattern)
+  );
+  compiled.sort((a, b) => b.staticSegments - a.staticSegments);
+  return compiled;
+}
+function matchContentRoute(path, routes) {
+  for (const route of routes) {
+    const match = route.regex.exec(path);
+    if (match) {
+      const params = {};
+      for (let i = 0; i < route.paramNames.length; i++) {
+        params[route.paramNames[i]] = match[i + 1];
+      }
+      return { collection: route.collection, params };
+    }
+  }
+  return void 0;
+}
+
+// libs/plugins/analytics/src/lib/page-view-tracker.utils.ts
+var DEFAULT_EXCLUDE_PREFIXES = ["/admin", "/api/"];
+function shouldTrackNavigation(url, isFirstNavigation, excludePrefixes) {
+  if (isFirstNavigation)
+    return false;
+  const path = url.split("?")[0].split("#")[0];
+  for (const prefix of excludePrefixes) {
+    if (path.startsWith(prefix))
+      return false;
+  }
+  return true;
+}
+function buildPageViewEvent(url, compiledRoutes) {
+  const path = url.split("?")[0].split("#")[0];
+  const properties = { path };
+  if (compiledRoutes) {
+    const routeMatch = matchContentRoute(path, compiledRoutes);
+    if (routeMatch) {
+      properties["collection"] = routeMatch.collection;
+      properties["slug"] = routeMatch.params["slug"];
+    }
+  }
+  return {
+    name: "page_view",
+    category: "page",
+    properties
+  };
+}
+
+// libs/plugins/analytics/src/lib/page-view-tracker.ts
+var PAGE_VIEW_TRACKING_CONFIG = new InjectionToken(
+  "PAGE_VIEW_TRACKING_CONFIG"
+);
+function getOrCreateStorageId(storage, key) {
+  let id = storage.getItem(key);
+  if (!id) {
+    id = Date.now().toString(36) + Math.random().toString(36).slice(2, 10);
+    storage.setItem(key, id);
+  }
+  return id;
+}
+var PageViewTrackerService = class {
+  constructor() {
+    this.router = inject(Router);
+    this.http = inject(HttpClient);
+    this.platformId = inject(PLATFORM_ID);
+    this.destroyRef = inject(DestroyRef);
+    this.config = inject(PAGE_VIEW_TRACKING_CONFIG);
+    this.doc = inject(DOCUMENT);
+    this.isFirstNavigation = true;
+    this.endpoint = this.config.endpoint ?? "/api/analytics/collect";
+    this.compiledRoutes = this.config.contentRoutes ? compileContentRoutes(this.config.contentRoutes) : void 0;
+    this.excludePrefixes = this.config.excludePrefixes ? [...DEFAULT_EXCLUDE_PREFIXES, ...this.config.excludePrefixes] : DEFAULT_EXCLUDE_PREFIXES;
+    if (!isPlatformBrowser(this.platformId))
+      return;
+    const sub = this.router.events.pipe(filter((e) => e instanceof NavigationEnd)).subscribe((event) => {
+      const url = event.urlAfterRedirects;
+      if (!shouldTrackNavigation(url, this.isFirstNavigation, this.excludePrefixes)) {
+        this.isFirstNavigation = false;
+        return;
+      }
+      this.isFirstNavigation = false;
+      this.trackPageView(url);
+    });
+    this.destroyRef.onDestroy(() => sub.unsubscribe());
+  }
+  trackPageView(url) {
+    const eventPayload = buildPageViewEvent(url, this.compiledRoutes);
+    const win = this.doc.defaultView;
+    let visitorId;
+    let sessionId;
+    try {
+      if (win?.localStorage)
+        visitorId = getOrCreateStorageId(win.localStorage, "_m_vid");
+      if (win?.sessionStorage)
+        sessionId = getOrCreateStorageId(win.sessionStorage, "_m_sid");
+    } catch {
+    }
+    const clientEvent = {
+      ...eventPayload,
+      context: {
+        url: win?.location?.href ?? "",
+        referrer: this.doc.referrer
+      },
+      visitorId,
+      sessionId
+    };
+    this.http.post(this.endpoint, { events: [clientEvent] }).subscribe();
+  }
+};
+PageViewTrackerService = __decorateClass([
+  Injectable()
+], PageViewTrackerService);
+function providePageViewTracking(config) {
+  return makeEnvironmentProviders([
+    { provide: PAGE_VIEW_TRACKING_CONFIG, useValue: config },
+    PageViewTrackerService,
+    {
+      provide: ENVIRONMENT_INITIALIZER,
+      multi: true,
+      useFactory: () => {
+        inject(PageViewTrackerService);
+        return () => {
+        };
+      }
+    }
+  ]);
+}
+export {
+  DEFAULT_EXCLUDE_PREFIXES,
+  PAGE_VIEW_TRACKING_CONFIG,
+  PageViewTrackerService,
+  buildPageViewEvent,
+  providePageViewTracking,
+  shouldTrackNavigation
+};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@momentumcms/plugins-analytics",
-	"version": "0.4.0",
+	"version": "0.4.1",
 	"description": "Analytics and content tracking plugin for Momentum CMS",
 	"license": "MIT",
 	"author": "Momentum CMS Contributors",
@@ -41,13 +41,17 @@
 		"./client": {
 			"types": "./src/lib/client/tracker.d.ts",
 			"default": "./lib/client/tracker.cjs"
+		},
+		"./page-tracker": {
+			"types": "./src/lib/page-view-tracker.d.ts",
+			"default": "./lib/page-view-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",
+		"@momentumcms/core": "0.4.1",
+		"@momentumcms/logger": "0.4.1",
+		"@momentumcms/plugins-core": "0.4.1",
+		"@momentumcms/server-core": "0.4.1",
 		"express": "^4.21.0"
 	},
 	"peerDependencies": {

package/src/index.d.ts

@@ -1,8 +1,10 @@
 export type { AnalyticsEvent, AnalyticsCategory, AnalyticsContext, AnalyticsQueryOptions, AnalyticsQueryResult, } from './lib/analytics-event.types';
-export type { AnalyticsAdapter, AnalyticsConfig } from './lib/analytics-config.types';
+export type { AnalyticsAdapter, AnalyticsConfig, PageViewTrackingOptions, } from './lib/analytics-config.types';
 export { EventStore, type EventStoreOptions } from './lib/event-store';
 export { injectCollectionCollector, type AnalyticsEmitter, type CollectionCollectorOptions, } from './lib/collectors/collection-collector';
 export { createApiCollectorMiddleware } from './lib/collectors/api-collector';
+export { createPageViewCollectorMiddleware, isBot, type PageViewEmitter, } from './lib/collectors/page-view-collector';
+export { compileContentRoutes, matchContentRoute, type CompiledContentRoute, type ContentRouteMatch, } from './lib/utils/content-route-matcher';
 export { createIngestRouter, type IngestHandlerOptions } from './lib/ingest-handler';
 export { MemoryAnalyticsAdapter } from './lib/adapters/memory-adapter';
 export { postgresAnalyticsAdapter, type PostgresAnalyticsAdapterOptions, } from './lib/adapters/postgres-adapter';

package/src/lib/analytics-config.types.d.ts

@@ -16,6 +16,27 @@ export interface AnalyticsAdapter {
     /** Flush pending events and close connections */
     shutdown?(): Promise<void>;
 }
+/**
+ * Options for server-side page view tracking.
+ */
+export interface PageViewTrackingOptions {
+    /** Additional path prefixes to exclude from tracking. */
+    excludePaths?: string[];
+    /** File extensions to ignore (overrides defaults when provided). */
+    excludeExtensions?: string[];
+    /** Only track responses with 2xx status codes. @default true */
+    onlySuccessful?: boolean;
+    /** Whether to track bot traffic (Googlebot, Bingbot, etc.). @default false */
+    trackBots?: boolean;
+    /**
+     * Map collection slugs to URL patterns for content attribution.
+     * When a page view URL matches a pattern, the event is enriched with
+     * collection and slug metadata, enabling per-document analytics.
+     * Patterns use Express-style `:param` syntax.
+     * @example { articles: '/articles/:slug', pages: '/:slug' }
+     */
+    contentRoutes?: Record<string, string>;
+}
 /**
  * Analytics configuration.
  */
@@ -30,6 +51,14 @@ export interface AnalyticsConfig {
     trackApi?: boolean;
     /** Admin action tracking. @default true */
     trackAdmin?: boolean;
+    /**
+     * Server-side page view tracking (SSR page renders).
+     * - `true` (default): enable with default settings
+     * - `false`: disable
+     * - object: override page view tracking options
+     * @default true
+     */
+    trackPageViews?: boolean | PageViewTrackingOptions;
     /** Client-side ingest endpoint path. @default '/api/analytics/collect' */
     ingestPath?: string;
     /** Rate limit for ingest endpoint (requests per minute per IP). @default 100 */

package/src/lib/analytics-plugin.d.ts

@@ -2,7 +2,7 @@
  * Analytics Plugin
  *
  * A Momentum CMS plugin that wires all analytics collectors together.
- * Tracks collection CRUD, API requests, and accepts client-side events.
+ * Tracks collection CRUD, API requests, page views, and accepts client-side events.
  *
  * @example
  * ```typescript