@otl-core/analytics 1.0.0 → 1.0.4

package/dist/index.cjs

@@ -0,0 +1,286 @@
+"use client";
+'use strict';
+
+var react = require('react');
+var jsxRuntime = require('react/jsx-runtime');
+
+// src/data-layer.ts
+var CMSDataLayer = class {
+  constructor() {
+    this.entries = [];
+    this.subscribers = /* @__PURE__ */ new Set();
+  }
+  push(entry) {
+    this.entries.push(entry);
+    for (const fn of this.subscribers) {
+      try {
+        fn(entry);
+      } catch {
+      }
+    }
+  }
+  subscribe(fn) {
+    for (const entry of this.entries) {
+      try {
+        fn(entry);
+      } catch {
+      }
+    }
+    this.subscribers.add(fn);
+    return () => {
+      this.subscribers.delete(fn);
+    };
+  }
+};
+var dataLayer = new CMSDataLayer();
+if (typeof window !== "undefined") {
+  window.__cms = dataLayer;
+}
+var AnalyticsContext = react.createContext({
+  trackEvent: () => {
+  },
+  enabled: false,
+  abnVariant: null,
+  setABnVariant: () => {
+  },
+  globalFormTracking: false
+});
+function useAnalytics() {
+  return react.useContext(AnalyticsContext);
+}
+function AnalyticsProvider({
+  enabled = true,
+  globalFormTracking = false,
+  children
+}) {
+  const [abnVariant, setABnVariant] = react.useState(null);
+  const trackEvent = react.useCallback(
+    (event, params) => {
+      if (!enabled) return;
+      const variantParams = {};
+      if (abnVariant) {
+        variantParams.abn_variant_id = abnVariant.variantId;
+        if (abnVariant.experimentId) {
+          variantParams.abn_experiment_id = abnVariant.experimentId;
+        }
+      }
+      dataLayer.push({
+        event,
+        timestamp: Date.now(),
+        ...variantParams,
+        ...params
+      });
+    },
+    [enabled, abnVariant]
+  );
+  const value = react.useMemo(
+    () => ({
+      trackEvent,
+      enabled,
+      abnVariant,
+      setABnVariant,
+      globalFormTracking
+    }),
+    [trackEvent, enabled, abnVariant, globalFormTracking]
+  );
+  return /* @__PURE__ */ jsxRuntime.jsx(AnalyticsContext.Provider, { value, children });
+}
+function BlockAnalyticsWrapper({
+  analyticsConfig,
+  blockId,
+  blockType,
+  children
+}) {
+  const wrapperRef = react.useRef(null);
+  if (!analyticsConfig || !analyticsConfig.enabled) {
+    return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children });
+  }
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    BlockAnalyticsInner,
+    {
+      analyticsConfig,
+      blockId,
+      blockType,
+      wrapperRef,
+      children
+    }
+  );
+}
+function BlockAnalyticsInner({
+  analyticsConfig,
+  blockId,
+  blockType,
+  wrapperRef,
+  children
+}) {
+  const {
+    event_label,
+    track_type,
+    visibility_threshold = 50,
+    fire_once = true,
+    target_providers = "all",
+    custom_params = {}
+  } = analyticsConfig;
+  const baseParams = {
+    block_id: blockId,
+    block_type: blockType,
+    event_label,
+    ...custom_params,
+    ...target_providers !== "all" ? { _target_providers: target_providers } : {}
+  };
+  const handleClick = react.useCallback(() => {
+    if (track_type === "click" || track_type === "both") {
+      dataLayer.push({
+        event: "block_click",
+        timestamp: Date.now(),
+        ...baseParams
+      });
+    }
+  }, [track_type, blockId, blockType, event_label]);
+  react.useEffect(() => {
+    if (track_type !== "visibility" && track_type !== "both") return;
+    if (!wrapperRef.current) return;
+    const threshold = Math.min(Math.max(visibility_threshold, 0), 100) / 100;
+    const observer = new IntersectionObserver(
+      (entries) => {
+        for (const entry of entries) {
+          if (entry.isIntersecting) {
+            dataLayer.push({
+              event: "block_visible",
+              timestamp: Date.now(),
+              ...baseParams
+            });
+            if (fire_once) {
+              observer.disconnect();
+            }
+          }
+        }
+      },
+      { threshold }
+    );
+    observer.observe(wrapperRef.current);
+    return () => {
+      observer.disconnect();
+    };
+  }, [
+    track_type,
+    visibility_threshold,
+    fire_once,
+    blockId,
+    blockType,
+    event_label
+  ]);
+  return /* @__PURE__ */ jsxRuntime.jsx("div", { ref: wrapperRef, onClick: handleClick, children });
+}
+function SectionAnalyticsWrapper({
+  analyticsConfig,
+  sectionId,
+  sectionType,
+  children
+}) {
+  const wrapperRef = react.useRef(null);
+  if (!analyticsConfig || !analyticsConfig.enabled) {
+    return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children });
+  }
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    SectionAnalyticsInner,
+    {
+      analyticsConfig,
+      sectionId,
+      sectionType,
+      wrapperRef,
+      children
+    }
+  );
+}
+function SectionAnalyticsInner({
+  analyticsConfig,
+  sectionId,
+  sectionType,
+  wrapperRef,
+  children
+}) {
+  const {
+    event_label,
+    track_type,
+    visibility_threshold = 50,
+    fire_once = true,
+    target_providers = "all",
+    custom_params = {}
+  } = analyticsConfig;
+  const baseParams = {
+    section_id: sectionId,
+    section_type: sectionType,
+    event_label,
+    ...custom_params,
+    ...target_providers !== "all" ? { _target_providers: target_providers } : {}
+  };
+  const handleClick = react.useCallback(() => {
+    if (track_type === "click" || track_type === "both") {
+      dataLayer.push({
+        event: "block_click",
+        timestamp: Date.now(),
+        ...baseParams
+      });
+    }
+  }, [track_type, sectionId, sectionType, event_label]);
+  react.useEffect(() => {
+    if (track_type !== "visibility" && track_type !== "both") return;
+    if (!wrapperRef.current) return;
+    const threshold = Math.min(Math.max(visibility_threshold, 0), 100) / 100;
+    const observer = new IntersectionObserver(
+      (entries) => {
+        for (const entry of entries) {
+          if (entry.isIntersecting) {
+            dataLayer.push({
+              event: "block_visible",
+              timestamp: Date.now(),
+              ...baseParams
+            });
+            if (fire_once) {
+              observer.disconnect();
+            }
+          }
+        }
+      },
+      { threshold }
+    );
+    observer.observe(wrapperRef.current);
+    return () => {
+      observer.disconnect();
+    };
+  }, [
+    track_type,
+    visibility_threshold,
+    fire_once,
+    sectionId,
+    sectionType,
+    event_label
+  ]);
+  return /* @__PURE__ */ jsxRuntime.jsx("div", { ref: wrapperRef, onClick: handleClick, children });
+}
+function ABnVariantSetter({
+  variantId,
+  experimentId
+}) {
+  const { setABnVariant, trackEvent } = useAnalytics();
+  react.useEffect(() => {
+    setABnVariant({ variantId, experimentId });
+    trackEvent("experiment_view", {
+      abn_variant_id: variantId,
+      abn_experiment_id: experimentId
+    });
+    return () => setABnVariant(null);
+  }, [variantId, experimentId, setABnVariant, trackEvent]);
+  return null;
+}
+
+exports.ABnVariantSetter = ABnVariantSetter;
+exports.AnalyticsProvider = AnalyticsProvider;
+exports.BlockAnalyticsWrapper = BlockAnalyticsWrapper;
+exports.CMSDataLayer = CMSDataLayer;
+exports.SectionAnalyticsWrapper = SectionAnalyticsWrapper;
+exports.dataLayer = dataLayer;
+exports.useAnalytics = useAnalytics;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/data-layer.ts","../src/analytics-context.tsx","../src/block-analytics-wrapper.tsx","../src/section-analytics-wrapper.tsx","../src/abn-variant-setter.tsx"],"names":["createContext","useContext","useState","useCallback","useMemo","jsx","useRef","Fragment","useEffect"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * CMS Data Layer\n *\n * Central event bus for analytics events. All events flow through here.\n * Provider adapters subscribe and translate events to provider-specific calls.\n */\n\nimport type { DataLayerEntry, DataLayerSubscriber } from \"./types\";\n\ndeclare global {\n  interface Window {\n    __cms?: CMSDataLayer;\n  }\n}\n\nexport class CMSDataLayer {\n  readonly entries: DataLayerEntry[] = [];\n  private readonly subscribers = new Set<DataLayerSubscriber>();\n\n  push(entry: DataLayerEntry): void {\n    this.entries.push(entry);\n    for (const fn of this.subscribers) {\n      try {\n        fn(entry);\n      } catch {\n        // Swallow subscriber errors to prevent cascade failures\n      }\n    }\n  }\n\n  subscribe(fn: DataLayerSubscriber): () => void {\n    for (const entry of this.entries) {\n      try {\n        fn(entry);\n      } catch {\n        // Swallow replay errors\n      }\n    }\n    this.subscribers.add(fn);\n    return () => {\n      this.subscribers.delete(fn);\n    };\n  }\n}\n\nexport const dataLayer = new CMSDataLayer();\n\nif (typeof window !== \"undefined\") {\n  window.__cms = dataLayer;\n}\n","\"use client\";\n\nimport {\n  createContext,\n  useCallback,\n  useContext,\n  useMemo,\n  useState,\n} from \"react\";\nimport type { StandardEventName } from \"@otl-core/cms-types\";\nimport type { ABnVariantContext, AnalyticsContextValue } from \"./types\";\nimport { dataLayer } from \"./data-layer\";\n\nconst AnalyticsContext = createContext<AnalyticsContextValue>({\n  trackEvent: () => {},\n  enabled: false,\n  abnVariant: null,\n  setABnVariant: () => {},\n  globalFormTracking: false,\n});\n\nexport function useAnalytics(): AnalyticsContextValue {\n  return useContext(AnalyticsContext);\n}\n\ninterface AnalyticsProviderProps {\n  enabled?: boolean;\n  /** When true, all forms automatically emit form_start, form_submit, form_error. */\n  globalFormTracking?: boolean;\n  children: React.ReactNode;\n}\n\nexport function AnalyticsProvider({\n  enabled = true,\n  globalFormTracking = false,\n  children,\n}: AnalyticsProviderProps) {\n  const [abnVariant, setABnVariant] = useState<ABnVariantContext | null>(null);\n\n  const trackEvent = useCallback(\n    (event: StandardEventName, params?: Record<string, unknown>) => {\n      if (!enabled) return;\n      const variantParams: Record<string, unknown> = {};\n      if (abnVariant) {\n        variantParams.abn_variant_id = abnVariant.variantId;\n        if (abnVariant.experimentId) {\n          variantParams.abn_experiment_id = abnVariant.experimentId;\n        }\n      }\n      dataLayer.push({\n        event,\n        timestamp: Date.now(),\n        ...variantParams,\n        ...params,\n      });\n    },\n    [enabled, abnVariant]\n  );\n\n  const value = useMemo<AnalyticsContextValue>(\n    () => ({\n      trackEvent,\n      enabled,\n      abnVariant,\n      setABnVariant,\n      globalFormTracking,\n    }),\n    [trackEvent, enabled, abnVariant, globalFormTracking]\n  );\n\n  return (\n    <AnalyticsContext.Provider value={value}>\n      {children}\n    </AnalyticsContext.Provider>\n  );\n}\n","\"use client\";\n\n/**\n * Block Analytics Wrapper\n *\n * Wraps a block and adds click/visibility tracking based on BlockAnalyticsConfig.\n */\n\nimport { useCallback, useEffect, useRef } from \"react\";\nimport type { BlockAnalyticsConfig } from \"@otl-core/cms-types\";\nimport { dataLayer } from \"./data-layer\";\n\ninterface BlockAnalyticsWrapperProps {\n  analyticsConfig: BlockAnalyticsConfig | undefined;\n  blockId: string;\n  blockType: string;\n  children: React.ReactNode;\n}\n\nexport function BlockAnalyticsWrapper({\n  analyticsConfig,\n  blockId,\n  blockType,\n  children,\n}: BlockAnalyticsWrapperProps) {\n  const wrapperRef = useRef<HTMLDivElement>(null);\n\n  if (!analyticsConfig || !analyticsConfig.enabled) {\n    return <>{children}</>;\n  }\n\n  return (\n    <BlockAnalyticsInner\n      analyticsConfig={analyticsConfig}\n      blockId={blockId}\n      blockType={blockType}\n      wrapperRef={wrapperRef}\n    >\n      {children}\n    </BlockAnalyticsInner>\n  );\n}\n\ninterface BlockAnalyticsInnerProps {\n  analyticsConfig: BlockAnalyticsConfig;\n  blockId: string;\n  blockType: string;\n  wrapperRef: React.RefObject<HTMLDivElement | null>;\n  children: React.ReactNode;\n}\n\nfunction BlockAnalyticsInner({\n  analyticsConfig,\n  blockId,\n  blockType,\n  wrapperRef,\n  children,\n}: BlockAnalyticsInnerProps) {\n  const {\n    event_label,\n    track_type,\n    visibility_threshold = 50,\n    fire_once = true,\n    target_providers = \"all\",\n    custom_params = {},\n  } = analyticsConfig;\n\n  const baseParams = {\n    block_id: blockId,\n    block_type: blockType,\n    event_label,\n    ...custom_params,\n    ...(target_providers !== \"all\"\n      ? { _target_providers: target_providers }\n      : {}),\n  };\n\n  const handleClick = useCallback(() => {\n    if (track_type === \"click\" || track_type === \"both\") {\n      dataLayer.push({\n        event: \"block_click\",\n        timestamp: Date.now(),\n        ...baseParams,\n      });\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [track_type, blockId, blockType, event_label]);\n\n  useEffect(() => {\n    if (track_type !== \"visibility\" && track_type !== \"both\") return;\n    if (!wrapperRef.current) return;\n\n    const threshold = Math.min(Math.max(visibility_threshold, 0), 100) / 100;\n    const observer = new IntersectionObserver(\n      entries => {\n        for (const entry of entries) {\n          if (entry.isIntersecting) {\n            dataLayer.push({\n              event: \"block_visible\",\n              timestamp: Date.now(),\n              ...baseParams,\n            });\n\n            if (fire_once) {\n              observer.disconnect();\n            }\n          }\n        }\n      },\n      { threshold }\n    );\n\n    observer.observe(wrapperRef.current);\n\n    return () => {\n      observer.disconnect();\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [\n    track_type,\n    visibility_threshold,\n    fire_once,\n    blockId,\n    blockType,\n    event_label,\n  ]);\n\n  return (\n    <div ref={wrapperRef} onClick={handleClick}>\n      {children}\n    </div>\n  );\n}\n","\"use client\";\n\n/**\n * Section Analytics Wrapper\n *\n * Wraps a section and adds click/visibility tracking based on BlockAnalyticsConfig.\n */\n\nimport { useCallback, useEffect, useRef } from \"react\";\nimport type { BlockAnalyticsConfig } from \"@otl-core/cms-types\";\nimport { dataLayer } from \"./data-layer\";\n\ninterface SectionAnalyticsWrapperProps {\n  analyticsConfig: BlockAnalyticsConfig | undefined;\n  sectionId: string;\n  sectionType: string;\n  children: React.ReactNode;\n}\n\nexport function SectionAnalyticsWrapper({\n  analyticsConfig,\n  sectionId,\n  sectionType,\n  children,\n}: SectionAnalyticsWrapperProps) {\n  const wrapperRef = useRef<HTMLDivElement>(null);\n\n  if (!analyticsConfig || !analyticsConfig.enabled) {\n    return <>{children}</>;\n  }\n\n  return (\n    <SectionAnalyticsInner\n      analyticsConfig={analyticsConfig}\n      sectionId={sectionId}\n      sectionType={sectionType}\n      wrapperRef={wrapperRef}\n    >\n      {children}\n    </SectionAnalyticsInner>\n  );\n}\n\ninterface SectionAnalyticsInnerProps {\n  analyticsConfig: BlockAnalyticsConfig;\n  sectionId: string;\n  sectionType: string;\n  wrapperRef: React.RefObject<HTMLDivElement | null>;\n  children: React.ReactNode;\n}\n\nfunction SectionAnalyticsInner({\n  analyticsConfig,\n  sectionId,\n  sectionType,\n  wrapperRef,\n  children,\n}: SectionAnalyticsInnerProps) {\n  const {\n    event_label,\n    track_type,\n    visibility_threshold = 50,\n    fire_once = true,\n    target_providers = \"all\",\n    custom_params = {},\n  } = analyticsConfig;\n\n  const baseParams = {\n    section_id: sectionId,\n    section_type: sectionType,\n    event_label,\n    ...custom_params,\n    ...(target_providers !== \"all\"\n      ? { _target_providers: target_providers }\n      : {}),\n  };\n\n  const handleClick = useCallback(() => {\n    if (track_type === \"click\" || track_type === \"both\") {\n      dataLayer.push({\n        event: \"block_click\",\n        timestamp: Date.now(),\n        ...baseParams,\n      });\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [track_type, sectionId, sectionType, event_label]);\n\n  useEffect(() => {\n    if (track_type !== \"visibility\" && track_type !== \"both\") return;\n    if (!wrapperRef.current) return;\n\n    const threshold = Math.min(Math.max(visibility_threshold, 0), 100) / 100;\n    const observer = new IntersectionObserver(\n      entries => {\n        for (const entry of entries) {\n          if (entry.isIntersecting) {\n            dataLayer.push({\n              event: \"block_visible\",\n              timestamp: Date.now(),\n              ...baseParams,\n            });\n\n            if (fire_once) {\n              observer.disconnect();\n            }\n          }\n        }\n      },\n      { threshold }\n    );\n\n    observer.observe(wrapperRef.current);\n\n    return () => {\n      observer.disconnect();\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [\n    track_type,\n    visibility_threshold,\n    fire_once,\n    sectionId,\n    sectionType,\n    event_label,\n  ]);\n\n  return (\n    <div ref={wrapperRef} onClick={handleClick}>\n      {children}\n    </div>\n  );\n}\n","\"use client\";\n\nimport { useEffect } from \"react\";\nimport type { StandardEventName } from \"@otl-core/cms-types\";\nimport { useAnalytics } from \"./analytics-context\";\n\ninterface ABnVariantSetterProps {\n  variantId: string;\n  experimentId?: string;\n}\n\n/**\n * A client component that page components render to communicate the\n * resolved A/B test variant to the analytics context.\n *\n * Renders nothing -- just sets context on mount and emits experiment_view.\n */\nexport function ABnVariantSetter({\n  variantId,\n  experimentId,\n}: ABnVariantSetterProps) {\n  const { setABnVariant, trackEvent } = useAnalytics();\n\n  useEffect(() => {\n    setABnVariant({ variantId, experimentId });\n    trackEvent(\"experiment_view\" as StandardEventName, {\n      abn_variant_id: variantId,\n      abn_experiment_id: experimentId,\n    });\n    return () => setABnVariant(null);\n  }, [variantId, experimentId, setABnVariant, trackEvent]);\n\n  return null;\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,86 @@
+import { StandardEventName, BlockAnalyticsConfig } from '@otl-core/cms-types';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+interface DataLayerEntry {
+    event: StandardEventName;
+    timestamp: number;
+    [key: string]: unknown;
+}
+type DataLayerSubscriber = (entry: DataLayerEntry) => void;
+interface ABnVariantContext {
+    /** The variant ID the user was assigned to. */
+    variantId: string;
+    /** A human-readable experiment name or the content ID being tested. */
+    experimentId?: string;
+}
+interface AnalyticsContextValue {
+    /** Push an event to the data layer. Variant context (if set) is automatically merged. */
+    trackEvent(event: StandardEventName, params?: Record<string, unknown>): void;
+    /** Whether analytics is active (false in preview/draft mode). */
+    enabled: boolean;
+    /** The current A/B test variant context, if any. */
+    abnVariant: ABnVariantContext | null;
+    /** Set the A/B variant context. Called by ABnVariantSetter from page components. */
+    setABnVariant(variant: ABnVariantContext | null): void;
+    /** When true, ALL forms automatically track form_start, form_submit, and form_error regardless of per-form settings. */
+    globalFormTracking: boolean;
+}
+
+/**
+ * CMS Data Layer
+ *
+ * Central event bus for analytics events. All events flow through here.
+ * Provider adapters subscribe and translate events to provider-specific calls.
+ */
+
+declare global {
+    interface Window {
+        __cms?: CMSDataLayer;
+    }
+}
+declare class CMSDataLayer {
+    readonly entries: DataLayerEntry[];
+    private readonly subscribers;
+    push(entry: DataLayerEntry): void;
+    subscribe(fn: DataLayerSubscriber): () => void;
+}
+declare const dataLayer: CMSDataLayer;
+
+declare function useAnalytics(): AnalyticsContextValue;
+interface AnalyticsProviderProps {
+    enabled?: boolean;
+    /** When true, all forms automatically emit form_start, form_submit, form_error. */
+    globalFormTracking?: boolean;
+    children: React.ReactNode;
+}
+declare function AnalyticsProvider({ enabled, globalFormTracking, children, }: AnalyticsProviderProps): react_jsx_runtime.JSX.Element;
+
+interface BlockAnalyticsWrapperProps {
+    analyticsConfig: BlockAnalyticsConfig | undefined;
+    blockId: string;
+    blockType: string;
+    children: React.ReactNode;
+}
+declare function BlockAnalyticsWrapper({ analyticsConfig, blockId, blockType, children, }: BlockAnalyticsWrapperProps): react_jsx_runtime.JSX.Element;
+
+interface SectionAnalyticsWrapperProps {
+    analyticsConfig: BlockAnalyticsConfig | undefined;
+    sectionId: string;
+    sectionType: string;
+    children: React.ReactNode;
+}
+declare function SectionAnalyticsWrapper({ analyticsConfig, sectionId, sectionType, children, }: SectionAnalyticsWrapperProps): react_jsx_runtime.JSX.Element;
+
+interface ABnVariantSetterProps {
+    variantId: string;
+    experimentId?: string;
+}
+/**
+ * A client component that page components render to communicate the
+ * resolved A/B test variant to the analytics context.
+ *
+ * Renders nothing -- just sets context on mount and emits experiment_view.
+ */
+declare function ABnVariantSetter({ variantId, experimentId, }: ABnVariantSetterProps): null;
+
+export { type ABnVariantContext, ABnVariantSetter, type AnalyticsContextValue, AnalyticsProvider, BlockAnalyticsWrapper, CMSDataLayer, type DataLayerEntry, type DataLayerSubscriber, SectionAnalyticsWrapper, dataLayer, useAnalytics };

package/dist/index.d.ts

@@ -0,0 +1,86 @@
+import { StandardEventName, BlockAnalyticsConfig } from '@otl-core/cms-types';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+interface DataLayerEntry {
+    event: StandardEventName;
+    timestamp: number;
+    [key: string]: unknown;
+}
+type DataLayerSubscriber = (entry: DataLayerEntry) => void;
+interface ABnVariantContext {
+    /** The variant ID the user was assigned to. */
+    variantId: string;
+    /** A human-readable experiment name or the content ID being tested. */
+    experimentId?: string;
+}
+interface AnalyticsContextValue {
+    /** Push an event to the data layer. Variant context (if set) is automatically merged. */
+    trackEvent(event: StandardEventName, params?: Record<string, unknown>): void;
+    /** Whether analytics is active (false in preview/draft mode). */
+    enabled: boolean;
+    /** The current A/B test variant context, if any. */
+    abnVariant: ABnVariantContext | null;
+    /** Set the A/B variant context. Called by ABnVariantSetter from page components. */
+    setABnVariant(variant: ABnVariantContext | null): void;
+    /** When true, ALL forms automatically track form_start, form_submit, and form_error regardless of per-form settings. */
+    globalFormTracking: boolean;
+}
+
+/**
+ * CMS Data Layer
+ *
+ * Central event bus for analytics events. All events flow through here.
+ * Provider adapters subscribe and translate events to provider-specific calls.
+ */
+
+declare global {
+    interface Window {
+        __cms?: CMSDataLayer;
+    }
+}
+declare class CMSDataLayer {
+    readonly entries: DataLayerEntry[];
+    private readonly subscribers;
+    push(entry: DataLayerEntry): void;
+    subscribe(fn: DataLayerSubscriber): () => void;
+}
+declare const dataLayer: CMSDataLayer;
+
+declare function useAnalytics(): AnalyticsContextValue;
+interface AnalyticsProviderProps {
+    enabled?: boolean;
+    /** When true, all forms automatically emit form_start, form_submit, form_error. */
+    globalFormTracking?: boolean;
+    children: React.ReactNode;
+}
+declare function AnalyticsProvider({ enabled, globalFormTracking, children, }: AnalyticsProviderProps): react_jsx_runtime.JSX.Element;
+
+interface BlockAnalyticsWrapperProps {
+    analyticsConfig: BlockAnalyticsConfig | undefined;
+    blockId: string;
+    blockType: string;
+    children: React.ReactNode;
+}
+declare function BlockAnalyticsWrapper({ analyticsConfig, blockId, blockType, children, }: BlockAnalyticsWrapperProps): react_jsx_runtime.JSX.Element;
+
+interface SectionAnalyticsWrapperProps {
+    analyticsConfig: BlockAnalyticsConfig | undefined;
+    sectionId: string;
+    sectionType: string;
+    children: React.ReactNode;
+}
+declare function SectionAnalyticsWrapper({ analyticsConfig, sectionId, sectionType, children, }: SectionAnalyticsWrapperProps): react_jsx_runtime.JSX.Element;
+
+interface ABnVariantSetterProps {
+    variantId: string;
+    experimentId?: string;
+}
+/**
+ * A client component that page components render to communicate the
+ * resolved A/B test variant to the analytics context.
+ *
+ * Renders nothing -- just sets context on mount and emits experiment_view.
+ */
+declare function ABnVariantSetter({ variantId, experimentId, }: ABnVariantSetterProps): null;
+
+export { type ABnVariantContext, ABnVariantSetter, type AnalyticsContextValue, AnalyticsProvider, BlockAnalyticsWrapper, CMSDataLayer, type DataLayerEntry, type DataLayerSubscriber, SectionAnalyticsWrapper, dataLayer, useAnalytics };

package/dist/index.js

@@ -0,0 +1,278 @@
+"use client";
+import { createContext, useContext, useState, useCallback, useMemo, useRef, useEffect } from 'react';
+import { jsx, Fragment } from 'react/jsx-runtime';
+
+// src/data-layer.ts
+var CMSDataLayer = class {
+  constructor() {
+    this.entries = [];
+    this.subscribers = /* @__PURE__ */ new Set();
+  }
+  push(entry) {
+    this.entries.push(entry);
+    for (const fn of this.subscribers) {
+      try {
+        fn(entry);
+      } catch {
+      }
+    }
+  }
+  subscribe(fn) {
+    for (const entry of this.entries) {
+      try {
+        fn(entry);
+      } catch {
+      }
+    }
+    this.subscribers.add(fn);
+    return () => {
+      this.subscribers.delete(fn);
+    };
+  }
+};
+var dataLayer = new CMSDataLayer();
+if (typeof window !== "undefined") {
+  window.__cms = dataLayer;
+}
+var AnalyticsContext = createContext({
+  trackEvent: () => {
+  },
+  enabled: false,
+  abnVariant: null,
+  setABnVariant: () => {
+  },
+  globalFormTracking: false
+});
+function useAnalytics() {
+  return useContext(AnalyticsContext);
+}
+function AnalyticsProvider({
+  enabled = true,
+  globalFormTracking = false,
+  children
+}) {
+  const [abnVariant, setABnVariant] = useState(null);
+  const trackEvent = useCallback(
+    (event, params) => {
+      if (!enabled) return;
+      const variantParams = {};
+      if (abnVariant) {
+        variantParams.abn_variant_id = abnVariant.variantId;
+        if (abnVariant.experimentId) {
+          variantParams.abn_experiment_id = abnVariant.experimentId;
+        }
+      }
+      dataLayer.push({
+        event,
+        timestamp: Date.now(),
+        ...variantParams,
+        ...params
+      });
+    },
+    [enabled, abnVariant]
+  );
+  const value = useMemo(
+    () => ({
+      trackEvent,
+      enabled,
+      abnVariant,
+      setABnVariant,
+      globalFormTracking
+    }),
+    [trackEvent, enabled, abnVariant, globalFormTracking]
+  );
+  return /* @__PURE__ */ jsx(AnalyticsContext.Provider, { value, children });
+}
+function BlockAnalyticsWrapper({
+  analyticsConfig,
+  blockId,
+  blockType,
+  children
+}) {
+  const wrapperRef = useRef(null);
+  if (!analyticsConfig || !analyticsConfig.enabled) {
+    return /* @__PURE__ */ jsx(Fragment, { children });
+  }
+  return /* @__PURE__ */ jsx(
+    BlockAnalyticsInner,
+    {
+      analyticsConfig,
+      blockId,
+      blockType,
+      wrapperRef,
+      children
+    }
+  );
+}
+function BlockAnalyticsInner({
+  analyticsConfig,
+  blockId,
+  blockType,
+  wrapperRef,
+  children
+}) {
+  const {
+    event_label,
+    track_type,
+    visibility_threshold = 50,
+    fire_once = true,
+    target_providers = "all",
+    custom_params = {}
+  } = analyticsConfig;
+  const baseParams = {
+    block_id: blockId,
+    block_type: blockType,
+    event_label,
+    ...custom_params,
+    ...target_providers !== "all" ? { _target_providers: target_providers } : {}
+  };
+  const handleClick = useCallback(() => {
+    if (track_type === "click" || track_type === "both") {
+      dataLayer.push({
+        event: "block_click",
+        timestamp: Date.now(),
+        ...baseParams
+      });
+    }
+  }, [track_type, blockId, blockType, event_label]);
+  useEffect(() => {
+    if (track_type !== "visibility" && track_type !== "both") return;
+    if (!wrapperRef.current) return;
+    const threshold = Math.min(Math.max(visibility_threshold, 0), 100) / 100;
+    const observer = new IntersectionObserver(
+      (entries) => {
+        for (const entry of entries) {
+          if (entry.isIntersecting) {
+            dataLayer.push({
+              event: "block_visible",
+              timestamp: Date.now(),
+              ...baseParams
+            });
+            if (fire_once) {
+              observer.disconnect();
+            }
+          }
+        }
+      },
+      { threshold }
+    );
+    observer.observe(wrapperRef.current);
+    return () => {
+      observer.disconnect();
+    };
+  }, [
+    track_type,
+    visibility_threshold,
+    fire_once,
+    blockId,
+    blockType,
+    event_label
+  ]);
+  return /* @__PURE__ */ jsx("div", { ref: wrapperRef, onClick: handleClick, children });
+}
+function SectionAnalyticsWrapper({
+  analyticsConfig,
+  sectionId,
+  sectionType,
+  children
+}) {
+  const wrapperRef = useRef(null);
+  if (!analyticsConfig || !analyticsConfig.enabled) {
+    return /* @__PURE__ */ jsx(Fragment, { children });
+  }
+  return /* @__PURE__ */ jsx(
+    SectionAnalyticsInner,
+    {
+      analyticsConfig,
+      sectionId,
+      sectionType,
+      wrapperRef,
+      children
+    }
+  );
+}
+function SectionAnalyticsInner({
+  analyticsConfig,
+  sectionId,
+  sectionType,
+  wrapperRef,
+  children
+}) {
+  const {
+    event_label,
+    track_type,
+    visibility_threshold = 50,
+    fire_once = true,
+    target_providers = "all",
+    custom_params = {}
+  } = analyticsConfig;
+  const baseParams = {
+    section_id: sectionId,
+    section_type: sectionType,
+    event_label,
+    ...custom_params,
+    ...target_providers !== "all" ? { _target_providers: target_providers } : {}
+  };
+  const handleClick = useCallback(() => {
+    if (track_type === "click" || track_type === "both") {
+      dataLayer.push({
+        event: "block_click",
+        timestamp: Date.now(),
+        ...baseParams
+      });
+    }
+  }, [track_type, sectionId, sectionType, event_label]);
+  useEffect(() => {
+    if (track_type !== "visibility" && track_type !== "both") return;
+    if (!wrapperRef.current) return;
+    const threshold = Math.min(Math.max(visibility_threshold, 0), 100) / 100;
+    const observer = new IntersectionObserver(
+      (entries) => {
+        for (const entry of entries) {
+          if (entry.isIntersecting) {
+            dataLayer.push({
+              event: "block_visible",
+              timestamp: Date.now(),
+              ...baseParams
+            });
+            if (fire_once) {
+              observer.disconnect();
+            }
+          }
+        }
+      },
+      { threshold }
+    );
+    observer.observe(wrapperRef.current);
+    return () => {
+      observer.disconnect();
+    };
+  }, [
+    track_type,
+    visibility_threshold,
+    fire_once,
+    sectionId,
+    sectionType,
+    event_label
+  ]);
+  return /* @__PURE__ */ jsx("div", { ref: wrapperRef, onClick: handleClick, children });
+}
+function ABnVariantSetter({
+  variantId,
+  experimentId
+}) {
+  const { setABnVariant, trackEvent } = useAnalytics();
+  useEffect(() => {
+    setABnVariant({ variantId, experimentId });
+    trackEvent("experiment_view", {
+      abn_variant_id: variantId,
+      abn_experiment_id: experimentId
+    });
+    return () => setABnVariant(null);
+  }, [variantId, experimentId, setABnVariant, trackEvent]);
+  return null;
+}
+
+export { ABnVariantSetter, AnalyticsProvider, BlockAnalyticsWrapper, CMSDataLayer, SectionAnalyticsWrapper, dataLayer, useAnalytics };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/data-layer.ts","../src/analytics-context.tsx","../src/block-analytics-wrapper.tsx","../src/section-analytics-wrapper.tsx","../src/abn-variant-setter.tsx"],"names":["jsx","useCallback","useRef","Fragment","useEffect"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * CMS Data Layer\n *\n * Central event bus for analytics events. All events flow through here.\n * Provider adapters subscribe and translate events to provider-specific calls.\n */\n\nimport type { DataLayerEntry, DataLayerSubscriber } from \"./types\";\n\ndeclare global {\n  interface Window {\n    __cms?: CMSDataLayer;\n  }\n}\n\nexport class CMSDataLayer {\n  readonly entries: DataLayerEntry[] = [];\n  private readonly subscribers = new Set<DataLayerSubscriber>();\n\n  push(entry: DataLayerEntry): void {\n    this.entries.push(entry);\n    for (const fn of this.subscribers) {\n      try {\n        fn(entry);\n      } catch {\n        // Swallow subscriber errors to prevent cascade failures\n      }\n    }\n  }\n\n  subscribe(fn: DataLayerSubscriber): () => void {\n    for (const entry of this.entries) {\n      try {\n        fn(entry);\n      } catch {\n        // Swallow replay errors\n      }\n    }\n    this.subscribers.add(fn);\n    return () => {\n      this.subscribers.delete(fn);\n    };\n  }\n}\n\nexport const dataLayer = new CMSDataLayer();\n\nif (typeof window !== \"undefined\") {\n  window.__cms = dataLayer;\n}\n","\"use client\";\n\nimport {\n  createContext,\n  useCallback,\n  useContext,\n  useMemo,\n  useState,\n} from \"react\";\nimport type { StandardEventName } from \"@otl-core/cms-types\";\nimport type { ABnVariantContext, AnalyticsContextValue } from \"./types\";\nimport { dataLayer } from \"./data-layer\";\n\nconst AnalyticsContext = createContext<AnalyticsContextValue>({\n  trackEvent: () => {},\n  enabled: false,\n  abnVariant: null,\n  setABnVariant: () => {},\n  globalFormTracking: false,\n});\n\nexport function useAnalytics(): AnalyticsContextValue {\n  return useContext(AnalyticsContext);\n}\n\ninterface AnalyticsProviderProps {\n  enabled?: boolean;\n  /** When true, all forms automatically emit form_start, form_submit, form_error. */\n  globalFormTracking?: boolean;\n  children: React.ReactNode;\n}\n\nexport function AnalyticsProvider({\n  enabled = true,\n  globalFormTracking = false,\n  children,\n}: AnalyticsProviderProps) {\n  const [abnVariant, setABnVariant] = useState<ABnVariantContext | null>(null);\n\n  const trackEvent = useCallback(\n    (event: StandardEventName, params?: Record<string, unknown>) => {\n      if (!enabled) return;\n      const variantParams: Record<string, unknown> = {};\n      if (abnVariant) {\n        variantParams.abn_variant_id = abnVariant.variantId;\n        if (abnVariant.experimentId) {\n          variantParams.abn_experiment_id = abnVariant.experimentId;\n        }\n      }\n      dataLayer.push({\n        event,\n        timestamp: Date.now(),\n        ...variantParams,\n        ...params,\n      });\n    },\n    [enabled, abnVariant]\n  );\n\n  const value = useMemo<AnalyticsContextValue>(\n    () => ({\n      trackEvent,\n      enabled,\n      abnVariant,\n      setABnVariant,\n      globalFormTracking,\n    }),\n    [trackEvent, enabled, abnVariant, globalFormTracking]\n  );\n\n  return (\n    <AnalyticsContext.Provider value={value}>\n      {children}\n    </AnalyticsContext.Provider>\n  );\n}\n","\"use client\";\n\n/**\n * Block Analytics Wrapper\n *\n * Wraps a block and adds click/visibility tracking based on BlockAnalyticsConfig.\n */\n\nimport { useCallback, useEffect, useRef } from \"react\";\nimport type { BlockAnalyticsConfig } from \"@otl-core/cms-types\";\nimport { dataLayer } from \"./data-layer\";\n\ninterface BlockAnalyticsWrapperProps {\n  analyticsConfig: BlockAnalyticsConfig | undefined;\n  blockId: string;\n  blockType: string;\n  children: React.ReactNode;\n}\n\nexport function BlockAnalyticsWrapper({\n  analyticsConfig,\n  blockId,\n  blockType,\n  children,\n}: BlockAnalyticsWrapperProps) {\n  const wrapperRef = useRef<HTMLDivElement>(null);\n\n  if (!analyticsConfig || !analyticsConfig.enabled) {\n    return <>{children}</>;\n  }\n\n  return (\n    <BlockAnalyticsInner\n      analyticsConfig={analyticsConfig}\n      blockId={blockId}\n      blockType={blockType}\n      wrapperRef={wrapperRef}\n    >\n      {children}\n    </BlockAnalyticsInner>\n  );\n}\n\ninterface BlockAnalyticsInnerProps {\n  analyticsConfig: BlockAnalyticsConfig;\n  blockId: string;\n  blockType: string;\n  wrapperRef: React.RefObject<HTMLDivElement | null>;\n  children: React.ReactNode;\n}\n\nfunction BlockAnalyticsInner({\n  analyticsConfig,\n  blockId,\n  blockType,\n  wrapperRef,\n  children,\n}: BlockAnalyticsInnerProps) {\n  const {\n    event_label,\n    track_type,\n    visibility_threshold = 50,\n    fire_once = true,\n    target_providers = \"all\",\n    custom_params = {},\n  } = analyticsConfig;\n\n  const baseParams = {\n    block_id: blockId,\n    block_type: blockType,\n    event_label,\n    ...custom_params,\n    ...(target_providers !== \"all\"\n      ? { _target_providers: target_providers }\n      : {}),\n  };\n\n  const handleClick = useCallback(() => {\n    if (track_type === \"click\" || track_type === \"both\") {\n      dataLayer.push({\n        event: \"block_click\",\n        timestamp: Date.now(),\n        ...baseParams,\n      });\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [track_type, blockId, blockType, event_label]);\n\n  useEffect(() => {\n    if (track_type !== \"visibility\" && track_type !== \"both\") return;\n    if (!wrapperRef.current) return;\n\n    const threshold = Math.min(Math.max(visibility_threshold, 0), 100) / 100;\n    const observer = new IntersectionObserver(\n      entries => {\n        for (const entry of entries) {\n          if (entry.isIntersecting) {\n            dataLayer.push({\n              event: \"block_visible\",\n              timestamp: Date.now(),\n              ...baseParams,\n            });\n\n            if (fire_once) {\n              observer.disconnect();\n            }\n          }\n        }\n      },\n      { threshold }\n    );\n\n    observer.observe(wrapperRef.current);\n\n    return () => {\n      observer.disconnect();\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [\n    track_type,\n    visibility_threshold,\n    fire_once,\n    blockId,\n    blockType,\n    event_label,\n  ]);\n\n  return (\n    <div ref={wrapperRef} onClick={handleClick}>\n      {children}\n    </div>\n  );\n}\n","\"use client\";\n\n/**\n * Section Analytics Wrapper\n *\n * Wraps a section and adds click/visibility tracking based on BlockAnalyticsConfig.\n */\n\nimport { useCallback, useEffect, useRef } from \"react\";\nimport type { BlockAnalyticsConfig } from \"@otl-core/cms-types\";\nimport { dataLayer } from \"./data-layer\";\n\ninterface SectionAnalyticsWrapperProps {\n  analyticsConfig: BlockAnalyticsConfig | undefined;\n  sectionId: string;\n  sectionType: string;\n  children: React.ReactNode;\n}\n\nexport function SectionAnalyticsWrapper({\n  analyticsConfig,\n  sectionId,\n  sectionType,\n  children,\n}: SectionAnalyticsWrapperProps) {\n  const wrapperRef = useRef<HTMLDivElement>(null);\n\n  if (!analyticsConfig || !analyticsConfig.enabled) {\n    return <>{children}</>;\n  }\n\n  return (\n    <SectionAnalyticsInner\n      analyticsConfig={analyticsConfig}\n      sectionId={sectionId}\n      sectionType={sectionType}\n      wrapperRef={wrapperRef}\n    >\n      {children}\n    </SectionAnalyticsInner>\n  );\n}\n\ninterface SectionAnalyticsInnerProps {\n  analyticsConfig: BlockAnalyticsConfig;\n  sectionId: string;\n  sectionType: string;\n  wrapperRef: React.RefObject<HTMLDivElement | null>;\n  children: React.ReactNode;\n}\n\nfunction SectionAnalyticsInner({\n  analyticsConfig,\n  sectionId,\n  sectionType,\n  wrapperRef,\n  children,\n}: SectionAnalyticsInnerProps) {\n  const {\n    event_label,\n    track_type,\n    visibility_threshold = 50,\n    fire_once = true,\n    target_providers = \"all\",\n    custom_params = {},\n  } = analyticsConfig;\n\n  const baseParams = {\n    section_id: sectionId,\n    section_type: sectionType,\n    event_label,\n    ...custom_params,\n    ...(target_providers !== \"all\"\n      ? { _target_providers: target_providers }\n      : {}),\n  };\n\n  const handleClick = useCallback(() => {\n    if (track_type === \"click\" || track_type === \"both\") {\n      dataLayer.push({\n        event: \"block_click\",\n        timestamp: Date.now(),\n        ...baseParams,\n      });\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [track_type, sectionId, sectionType, event_label]);\n\n  useEffect(() => {\n    if (track_type !== \"visibility\" && track_type !== \"both\") return;\n    if (!wrapperRef.current) return;\n\n    const threshold = Math.min(Math.max(visibility_threshold, 0), 100) / 100;\n    const observer = new IntersectionObserver(\n      entries => {\n        for (const entry of entries) {\n          if (entry.isIntersecting) {\n            dataLayer.push({\n              event: \"block_visible\",\n              timestamp: Date.now(),\n              ...baseParams,\n            });\n\n            if (fire_once) {\n              observer.disconnect();\n            }\n          }\n        }\n      },\n      { threshold }\n    );\n\n    observer.observe(wrapperRef.current);\n\n    return () => {\n      observer.disconnect();\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [\n    track_type,\n    visibility_threshold,\n    fire_once,\n    sectionId,\n    sectionType,\n    event_label,\n  ]);\n\n  return (\n    <div ref={wrapperRef} onClick={handleClick}>\n      {children}\n    </div>\n  );\n}\n","\"use client\";\n\nimport { useEffect } from \"react\";\nimport type { StandardEventName } from \"@otl-core/cms-types\";\nimport { useAnalytics } from \"./analytics-context\";\n\ninterface ABnVariantSetterProps {\n  variantId: string;\n  experimentId?: string;\n}\n\n/**\n * A client component that page components render to communicate the\n * resolved A/B test variant to the analytics context.\n *\n * Renders nothing -- just sets context on mount and emits experiment_view.\n */\nexport function ABnVariantSetter({\n  variantId,\n  experimentId,\n}: ABnVariantSetterProps) {\n  const { setABnVariant, trackEvent } = useAnalytics();\n\n  useEffect(() => {\n    setABnVariant({ variantId, experimentId });\n    trackEvent(\"experiment_view\" as StandardEventName, {\n      abn_variant_id: variantId,\n      abn_experiment_id: experimentId,\n    });\n    return () => setABnVariant(null);\n  }, [variantId, experimentId, setABnVariant, trackEvent]);\n\n  return null;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@otl-core/analytics",
-  "version": "1.0.0",
+  "version": "1.0.4",
   "type": "module",
   "description": "Analytics event bus and React context for OTL CMS",
   "main": "./dist/index.cjs",
@@ -33,7 +33,7 @@
     "url": "https://github.com/otl-core/analytics.git"
   },
   "dependencies": {
-    "@otl-core/cms-types": "^1.0.0"
+    "@otl-core/cms-types": "^1.0.4"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0"