@simpleapps-com/augur-web 0.2.13 → 0.2.14

package/dist/gtm.cjs

@@ -0,0 +1,142 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
+"use client";
+
+// src/gtm.tsx
+
+
+
+
+
+
+
+var _react = require('react');
+var _jsxruntime = require('react/jsx-runtime');
+var GtmContext = _react.createContext.call(void 0, null);
+function getDataLayer() {
+  if (typeof window === "undefined") return [];
+  if (!window.dataLayer) window.dataLayer = [];
+  return window.dataLayer;
+}
+function injectGtmScript(gtmId, strategy) {
+  if (typeof document === "undefined") return;
+  if (document.getElementById("gtm-script")) return;
+  const dataLayer = getDataLayer();
+  dataLayer.push({ "gtm.start": (/* @__PURE__ */ new Date()).getTime(), event: "gtm.js" });
+  const script = document.createElement("script");
+  script.id = "gtm-script";
+  script.src = `https://www.googletagmanager.com/gtm.js?id=${encodeURIComponent(gtmId)}`;
+  if (strategy === "lazyOnload") {
+    script.async = true;
+    script.defer = true;
+  } else if (strategy === "worker") {
+    script.type = "text/partytown";
+    script.async = true;
+  } else {
+    script.async = true;
+  }
+  document.head.appendChild(script);
+}
+function GtmProvider({
+  gtmId,
+  strategy = "afterInteractive",
+  consentRequired = false,
+  debug = false,
+  children
+}) {
+  const [hasConsent, setHasConsent] = _react.useState.call(void 0, !consentRequired);
+  const [isLoaded, setIsLoaded] = _react.useState.call(void 0, false);
+  const injectedRef = _react.useRef.call(void 0, false);
+  const loadGtm = _react.useCallback.call(void 0, () => {
+    if (injectedRef.current) return;
+    injectedRef.current = true;
+    if (strategy === "lazyOnload" && typeof requestIdleCallback === "function") {
+      requestIdleCallback(() => {
+        injectGtmScript(gtmId, strategy);
+        setIsLoaded(true);
+      });
+    } else if (strategy === "afterInteractive") {
+      setTimeout(() => {
+        injectGtmScript(gtmId, strategy);
+        setIsLoaded(true);
+      }, 0);
+    } else {
+      injectGtmScript(gtmId, strategy);
+      setIsLoaded(true);
+    }
+  }, [gtmId, strategy]);
+  if (hasConsent && !injectedRef.current && typeof window !== "undefined") {
+    loadGtm();
+  }
+  const pushEvent = _react.useCallback.call(void 0, 
+    (event, params) => {
+      const entry = { event, ...params };
+      if (debug) {
+        console.log("[GTM]", entry);
+      }
+      getDataLayer().push(entry);
+    },
+    [debug]
+  );
+  const pushEcommerceEvent = _react.useCallback.call(void 0, 
+    (event, params) => {
+      getDataLayer().push({ ecommerce: null });
+      const entry = { event, ecommerce: params };
+      if (debug) {
+        console.log("[GTM ecommerce]", entry);
+      }
+      getDataLayer().push(entry);
+    },
+    [debug]
+  );
+  const grantConsent = _react.useCallback.call(void 0, () => {
+    setHasConsent(true);
+    loadGtm();
+  }, [loadGtm]);
+  const revokeConsent = _react.useCallback.call(void 0, () => {
+    setHasConsent(false);
+  }, []);
+  const value = _react.useMemo.call(void 0, 
+    () => ({
+      pushEvent,
+      pushEcommerceEvent,
+      grantConsent,
+      revokeConsent,
+      hasConsent,
+      isLoaded
+    }),
+    [
+      pushEvent,
+      pushEcommerceEvent,
+      grantConsent,
+      revokeConsent,
+      hasConsent,
+      isLoaded
+    ]
+  );
+  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, GtmContext.Provider, { value, children });
+}
+function useGtm() {
+  const context = _react.useContext.call(void 0, GtmContext);
+  if (!context) {
+    throw new Error("useGtm must be used within a <GtmProvider>");
+  }
+  return context;
+}
+function GtmNoscript({ gtmId }) {
+  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "noscript", { children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+    "iframe",
+    {
+      src: `https://www.googletagmanager.com/ns.html?id=${encodeURIComponent(gtmId)}`,
+      height: "0",
+      width: "0",
+      style: { display: "none", visibility: "hidden" },
+      title: "Google Tag Manager"
+    }
+  ) });
+}
+
+
+
+
+exports.GtmNoscript = GtmNoscript; exports.GtmProvider = GtmProvider; exports.useGtm = useGtm;
+//# sourceMappingURL=gtm.cjs.map

package/dist/gtm.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/augur-packages/augur-packages/packages/augur-web/dist/gtm.cjs","../src/gtm.tsx"],"names":[],"mappings":"AAAA,qFAAY;AACZ,YAAY;AACZ;AACA;ACDA;AACE;AACA;AACA;AACA;AACA;AACA;AAAA,8BACK;AAiOE,+CAAA;AA1IT,IAAM,WAAA,EAAa,kCAAA,IAA0C,CAAA;AAY7D,SAAS,YAAA,CAAA,EAA0C;AACjD,EAAA,GAAA,CAAI,OAAO,OAAA,IAAW,WAAA,EAAa,OAAO,CAAC,CAAA;AAC3C,EAAA,GAAA,CAAI,CAAC,MAAA,CAAO,SAAA,EAAW,MAAA,CAAO,UAAA,EAAY,CAAC,CAAA;AAC3C,EAAA,OAAO,MAAA,CAAO,SAAA;AAChB;AAEA,SAAS,eAAA,CAAgB,KAAA,EAAe,QAAA,EAA6B;AACnE,EAAA,GAAA,CAAI,OAAO,SAAA,IAAa,WAAA,EAAa,MAAA;AAGrC,EAAA,GAAA,CAAI,QAAA,CAAS,cAAA,CAAe,YAAY,CAAA,EAAG,MAAA;AAE3C,EAAA,MAAM,UAAA,EAAY,YAAA,CAAa,CAAA;AAC/B,EAAA,SAAA,CAAU,IAAA,CAAK,EAAE,WAAA,EAAA,iBAAa,IAAI,IAAA,CAAK,CAAA,CAAA,CAAE,OAAA,CAAQ,CAAA,EAAG,KAAA,EAAO,SAAS,CAAC,CAAA;AAErE,EAAA,MAAM,OAAA,EAAS,QAAA,CAAS,aAAA,CAAc,QAAQ,CAAA;AAC9C,EAAA,MAAA,CAAO,GAAA,EAAK,YAAA;AACZ,EAAA,MAAA,CAAO,IAAA,EAAM,CAAA,2CAAA,EAA8C,kBAAA,CAAmB,KAAK,CAAC,CAAA,CAAA;AAErD,EAAA;AACd,IAAA;AACA,IAAA;AACiB,EAAA;AAClB,IAAA;AACC,IAAA;AACV,EAAA;AAEU,IAAA;AACjB,EAAA;AAEgC,EAAA;AAClC;AAM4B;AAC1B,EAAA;AACW,EAAA;AACO,EAAA;AACV,EAAA;AACR,EAAA;AACmB;AAC0C,EAAA;AACf,EAAA;AACd,EAAA;AAEE,EAAA;AACP,IAAA;AACH,IAAA;AAEsD,IAAA;AAChD,MAAA;AACO,QAAA;AACf,QAAA;AACjB,MAAA;AACyC,IAAA;AAEzB,MAAA;AACgB,QAAA;AACf,QAAA;AACd,MAAA;AACC,IAAA;AAC0B,MAAA;AACf,MAAA;AAClB,IAAA;AACkB,EAAA;AAGqD,EAAA;AAC/D,IAAA;AACV,EAAA;AAEkB,EAAA;AACqC,IAAA;AAClB,MAAA;AACtB,MAAA;AACiB,QAAA;AAC5B,MAAA;AACyB,MAAA;AAC3B,IAAA;AACM,IAAA;AACR,EAAA;AAE2B,EAAA;AACiC,IAAA;AAEjB,MAAA;AACE,MAAA;AAC9B,MAAA;AAC2B,QAAA;AACtC,MAAA;AACyB,MAAA;AAC3B,IAAA;AACM,IAAA;AACR,EAAA;AAEuC,EAAA;AACnB,IAAA;AACV,IAAA;AACE,EAAA;AAE4B,EAAA;AACnB,IAAA;AAChB,EAAA;AAES,EAAA;AACL,IAAA;AACL,MAAA;AACA,MAAA;AACA,MAAA;AACA,MAAA;AACA,MAAA;AACA,MAAA;AACF,IAAA;AACA,IAAA;AACE,MAAA;AACA,MAAA;AACA,MAAA;AACA,MAAA;AACA,MAAA;AACA,MAAA;AACF,IAAA;AACF,EAAA;AAEoD,EAAA;AACtD;AAM0C;AACH,EAAA;AACvB,EAAA;AACgD,IAAA;AAC9D,EAAA;AACO,EAAA;AACT;AAWyD;AAGnD,EAAA;AAAC,IAAA;AAAA,IAAA;AAC8E,MAAA;AACtE,MAAA;AACD,MAAA;AACyC,MAAA;AACzC,MAAA;AAAA,IAAA;AAEV,EAAA;AAEJ;ADtIuF;AACA;AACA;AACA;AACA","file":"/home/runner/work/augur-packages/augur-packages/packages/augur-web/dist/gtm.cjs","sourcesContent":[null,"\"use client\";\n\nimport {\n  createContext,\n  useCallback,\n  useContext,\n  useMemo,\n  useRef,\n  useState,\n} from \"react\";\nimport type { ReactNode } from \"react\";\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/** GTM script loading strategy. */\nexport type GtmStrategy =\n  | \"default\"\n  | \"afterInteractive\"\n  | \"lazyOnload\"\n  | \"worker\";\n\n/** GA4 standard e-commerce event names. */\nexport type GtmEcommerceEvent =\n  | \"view_item\"\n  | \"view_item_list\"\n  | \"select_item\"\n  | \"add_to_cart\"\n  | \"remove_from_cart\"\n  | \"view_cart\"\n  | \"begin_checkout\"\n  | \"add_shipping_info\"\n  | \"add_payment_info\"\n  | \"purchase\"\n  | \"refund\";\n\n/** GA4 e-commerce item shape. */\nexport interface GtmItem {\n  item_id: string;\n  item_name?: string;\n  item_brand?: string;\n  item_category?: string;\n  item_variant?: string;\n  price?: number;\n  quantity?: number;\n  index?: number;\n  [key: string]: unknown;\n}\n\n/** Parameters for e-commerce events. */\nexport interface GtmEcommerceParams {\n  currency?: string;\n  value?: number;\n  items?: GtmItem[];\n  transaction_id?: string;\n  shipping?: number;\n  tax?: number;\n  coupon?: string;\n  [key: string]: unknown;\n}\n\nexport interface GtmProviderProps {\n  /** GTM container ID (e.g. \"GTM-XXXXX\"). */\n  gtmId: string;\n  /** Script loading strategy. Default: \"afterInteractive\". */\n  strategy?: GtmStrategy;\n  /** Delay GTM loading until consent is granted. Default: false. */\n  consentRequired?: boolean;\n  /** Log dataLayer pushes to console. Default: false. */\n  debug?: boolean;\n  children: ReactNode;\n}\n\nexport interface GtmContextValue {\n  /** Push a custom event to the dataLayer. */\n  pushEvent: (event: string, params?: Record<string, unknown>) => void;\n  /** Push a GA4 e-commerce event to the dataLayer. */\n  pushEcommerceEvent: (\n    event: GtmEcommerceEvent,\n    params: GtmEcommerceParams,\n  ) => void;\n  /** Grant consent — loads GTM if consentRequired was true. */\n  grantConsent: () => void;\n  /** Revoke consent. Does not unload GTM (scripts can't be unloaded). */\n  revokeConsent: () => void;\n  /** Whether consent has been granted. */\n  hasConsent: boolean;\n  /** Whether the GTM script has been injected. */\n  isLoaded: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Context\n// ---------------------------------------------------------------------------\n\nconst GtmContext = createContext<GtmContextValue | null>(null);\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\ndeclare global {\n  interface Window {\n    dataLayer?: Record<string, unknown>[];\n  }\n}\n\nfunction getDataLayer(): Record<string, unknown>[] {\n  if (typeof window === \"undefined\") return [];\n  if (!window.dataLayer) window.dataLayer = [];\n  return window.dataLayer;\n}\n\nfunction injectGtmScript(gtmId: string, strategy: GtmStrategy): void {\n  if (typeof document === \"undefined\") return;\n\n  // Prevent double-injection\n  if (document.getElementById(\"gtm-script\")) return;\n\n  const dataLayer = getDataLayer();\n  dataLayer.push({ \"gtm.start\": new Date().getTime(), event: \"gtm.js\" });\n\n  const script = document.createElement(\"script\");\n  script.id = \"gtm-script\";\n  script.src = `https://www.googletagmanager.com/gtm.js?id=${encodeURIComponent(gtmId)}`;\n\n  if (strategy === \"lazyOnload\") {\n    script.async = true;\n    script.defer = true;\n  } else if (strategy === \"worker\") {\n    script.type = \"text/partytown\";\n    script.async = true;\n  } else {\n    // \"default\" and \"afterInteractive\"\n    script.async = true;\n  }\n\n  document.head.appendChild(script);\n}\n\n// ---------------------------------------------------------------------------\n// Provider\n// ---------------------------------------------------------------------------\n\nexport function GtmProvider({\n  gtmId,\n  strategy = \"afterInteractive\",\n  consentRequired = false,\n  debug = false,\n  children,\n}: GtmProviderProps) {\n  const [hasConsent, setHasConsent] = useState(!consentRequired);\n  const [isLoaded, setIsLoaded] = useState(false);\n  const injectedRef = useRef(false);\n\n  const loadGtm = useCallback(() => {\n    if (injectedRef.current) return;\n    injectedRef.current = true;\n\n    if (strategy === \"lazyOnload\" && typeof requestIdleCallback === \"function\") {\n      requestIdleCallback(() => {\n        injectGtmScript(gtmId, strategy);\n        setIsLoaded(true);\n      });\n    } else if (strategy === \"afterInteractive\") {\n      // Defer to after hydration\n      setTimeout(() => {\n        injectGtmScript(gtmId, strategy);\n        setIsLoaded(true);\n      }, 0);\n    } else {\n      injectGtmScript(gtmId, strategy);\n      setIsLoaded(true);\n    }\n  }, [gtmId, strategy]);\n\n  // Auto-load when consent is not required or already granted\n  if (hasConsent && !injectedRef.current && typeof window !== \"undefined\") {\n    loadGtm();\n  }\n\n  const pushEvent = useCallback(\n    (event: string, params?: Record<string, unknown>) => {\n      const entry = { event, ...params };\n      if (debug) {\n        console.log(\"[GTM]\", entry);\n      }\n      getDataLayer().push(entry);\n    },\n    [debug],\n  );\n\n  const pushEcommerceEvent = useCallback(\n    (event: GtmEcommerceEvent, params: GtmEcommerceParams) => {\n      // Clear previous ecommerce data per GA4 best practices\n      getDataLayer().push({ ecommerce: null });\n      const entry = { event, ecommerce: params };\n      if (debug) {\n        console.log(\"[GTM ecommerce]\", entry);\n      }\n      getDataLayer().push(entry);\n    },\n    [debug],\n  );\n\n  const grantConsent = useCallback(() => {\n    setHasConsent(true);\n    loadGtm();\n  }, [loadGtm]);\n\n  const revokeConsent = useCallback(() => {\n    setHasConsent(false);\n  }, []);\n\n  const value = useMemo<GtmContextValue>(\n    () => ({\n      pushEvent,\n      pushEcommerceEvent,\n      grantConsent,\n      revokeConsent,\n      hasConsent,\n      isLoaded,\n    }),\n    [\n      pushEvent,\n      pushEcommerceEvent,\n      grantConsent,\n      revokeConsent,\n      hasConsent,\n      isLoaded,\n    ],\n  );\n\n  return <GtmContext.Provider value={value}>{children}</GtmContext.Provider>;\n}\n\n// ---------------------------------------------------------------------------\n// Hook\n// ---------------------------------------------------------------------------\n\nexport function useGtm(): GtmContextValue {\n  const context = useContext(GtmContext);\n  if (!context) {\n    throw new Error(\"useGtm must be used within a <GtmProvider>\");\n  }\n  return context;\n}\n\n// ---------------------------------------------------------------------------\n// Noscript\n// ---------------------------------------------------------------------------\n\nexport interface GtmNoscriptProps {\n  /** GTM container ID (must match GtmProvider). */\n  gtmId: string;\n}\n\nexport function GtmNoscript({ gtmId }: GtmNoscriptProps) {\n  return (\n    <noscript>\n      <iframe\n        src={`https://www.googletagmanager.com/ns.html?id=${encodeURIComponent(gtmId)}`}\n        height=\"0\"\n        width=\"0\"\n        style={{ display: \"none\", visibility: \"hidden\" }}\n        title=\"Google Tag Manager\"\n      />\n    </noscript>\n  );\n}\n"]}

package/dist/gtm.d.cts

@@ -0,0 +1,69 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+/** GTM script loading strategy. */
+type GtmStrategy = "default" | "afterInteractive" | "lazyOnload" | "worker";
+/** GA4 standard e-commerce event names. */
+type GtmEcommerceEvent = "view_item" | "view_item_list" | "select_item" | "add_to_cart" | "remove_from_cart" | "view_cart" | "begin_checkout" | "add_shipping_info" | "add_payment_info" | "purchase" | "refund";
+/** GA4 e-commerce item shape. */
+interface GtmItem {
+    item_id: string;
+    item_name?: string;
+    item_brand?: string;
+    item_category?: string;
+    item_variant?: string;
+    price?: number;
+    quantity?: number;
+    index?: number;
+    [key: string]: unknown;
+}
+/** Parameters for e-commerce events. */
+interface GtmEcommerceParams {
+    currency?: string;
+    value?: number;
+    items?: GtmItem[];
+    transaction_id?: string;
+    shipping?: number;
+    tax?: number;
+    coupon?: string;
+    [key: string]: unknown;
+}
+interface GtmProviderProps {
+    /** GTM container ID (e.g. "GTM-XXXXX"). */
+    gtmId: string;
+    /** Script loading strategy. Default: "afterInteractive". */
+    strategy?: GtmStrategy;
+    /** Delay GTM loading until consent is granted. Default: false. */
+    consentRequired?: boolean;
+    /** Log dataLayer pushes to console. Default: false. */
+    debug?: boolean;
+    children: ReactNode;
+}
+interface GtmContextValue {
+    /** Push a custom event to the dataLayer. */
+    pushEvent: (event: string, params?: Record<string, unknown>) => void;
+    /** Push a GA4 e-commerce event to the dataLayer. */
+    pushEcommerceEvent: (event: GtmEcommerceEvent, params: GtmEcommerceParams) => void;
+    /** Grant consent — loads GTM if consentRequired was true. */
+    grantConsent: () => void;
+    /** Revoke consent. Does not unload GTM (scripts can't be unloaded). */
+    revokeConsent: () => void;
+    /** Whether consent has been granted. */
+    hasConsent: boolean;
+    /** Whether the GTM script has been injected. */
+    isLoaded: boolean;
+}
+declare global {
+    interface Window {
+        dataLayer?: Record<string, unknown>[];
+    }
+}
+declare function GtmProvider({ gtmId, strategy, consentRequired, debug, children, }: GtmProviderProps): react_jsx_runtime.JSX.Element;
+declare function useGtm(): GtmContextValue;
+interface GtmNoscriptProps {
+    /** GTM container ID (must match GtmProvider). */
+    gtmId: string;
+}
+declare function GtmNoscript({ gtmId }: GtmNoscriptProps): react_jsx_runtime.JSX.Element;
+
+export { type GtmContextValue, type GtmEcommerceEvent, type GtmEcommerceParams, type GtmItem, GtmNoscript, type GtmNoscriptProps, GtmProvider, type GtmProviderProps, type GtmStrategy, useGtm };

package/dist/gtm.d.ts

@@ -0,0 +1,69 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+/** GTM script loading strategy. */
+type GtmStrategy = "default" | "afterInteractive" | "lazyOnload" | "worker";
+/** GA4 standard e-commerce event names. */
+type GtmEcommerceEvent = "view_item" | "view_item_list" | "select_item" | "add_to_cart" | "remove_from_cart" | "view_cart" | "begin_checkout" | "add_shipping_info" | "add_payment_info" | "purchase" | "refund";
+/** GA4 e-commerce item shape. */
+interface GtmItem {
+    item_id: string;
+    item_name?: string;
+    item_brand?: string;
+    item_category?: string;
+    item_variant?: string;
+    price?: number;
+    quantity?: number;
+    index?: number;
+    [key: string]: unknown;
+}
+/** Parameters for e-commerce events. */
+interface GtmEcommerceParams {
+    currency?: string;
+    value?: number;
+    items?: GtmItem[];
+    transaction_id?: string;
+    shipping?: number;
+    tax?: number;
+    coupon?: string;
+    [key: string]: unknown;
+}
+interface GtmProviderProps {
+    /** GTM container ID (e.g. "GTM-XXXXX"). */
+    gtmId: string;
+    /** Script loading strategy. Default: "afterInteractive". */
+    strategy?: GtmStrategy;
+    /** Delay GTM loading until consent is granted. Default: false. */
+    consentRequired?: boolean;
+    /** Log dataLayer pushes to console. Default: false. */
+    debug?: boolean;
+    children: ReactNode;
+}
+interface GtmContextValue {
+    /** Push a custom event to the dataLayer. */
+    pushEvent: (event: string, params?: Record<string, unknown>) => void;
+    /** Push a GA4 e-commerce event to the dataLayer. */
+    pushEcommerceEvent: (event: GtmEcommerceEvent, params: GtmEcommerceParams) => void;
+    /** Grant consent — loads GTM if consentRequired was true. */
+    grantConsent: () => void;
+    /** Revoke consent. Does not unload GTM (scripts can't be unloaded). */
+    revokeConsent: () => void;
+    /** Whether consent has been granted. */
+    hasConsent: boolean;
+    /** Whether the GTM script has been injected. */
+    isLoaded: boolean;
+}
+declare global {
+    interface Window {
+        dataLayer?: Record<string, unknown>[];
+    }
+}
+declare function GtmProvider({ gtmId, strategy, consentRequired, debug, children, }: GtmProviderProps): react_jsx_runtime.JSX.Element;
+declare function useGtm(): GtmContextValue;
+interface GtmNoscriptProps {
+    /** GTM container ID (must match GtmProvider). */
+    gtmId: string;
+}
+declare function GtmNoscript({ gtmId }: GtmNoscriptProps): react_jsx_runtime.JSX.Element;
+
+export { type GtmContextValue, type GtmEcommerceEvent, type GtmEcommerceParams, type GtmItem, GtmNoscript, type GtmNoscriptProps, GtmProvider, type GtmProviderProps, type GtmStrategy, useGtm };

package/dist/gtm.js

@@ -0,0 +1,142 @@
+"use client";
+"use client";
+
+// src/gtm.tsx
+import {
+  createContext,
+  useCallback,
+  useContext,
+  useMemo,
+  useRef,
+  useState
+} from "react";
+import { jsx } from "react/jsx-runtime";
+var GtmContext = createContext(null);
+function getDataLayer() {
+  if (typeof window === "undefined") return [];
+  if (!window.dataLayer) window.dataLayer = [];
+  return window.dataLayer;
+}
+function injectGtmScript(gtmId, strategy) {
+  if (typeof document === "undefined") return;
+  if (document.getElementById("gtm-script")) return;
+  const dataLayer = getDataLayer();
+  dataLayer.push({ "gtm.start": (/* @__PURE__ */ new Date()).getTime(), event: "gtm.js" });
+  const script = document.createElement("script");
+  script.id = "gtm-script";
+  script.src = `https://www.googletagmanager.com/gtm.js?id=${encodeURIComponent(gtmId)}`;
+  if (strategy === "lazyOnload") {
+    script.async = true;
+    script.defer = true;
+  } else if (strategy === "worker") {
+    script.type = "text/partytown";
+    script.async = true;
+  } else {
+    script.async = true;
+  }
+  document.head.appendChild(script);
+}
+function GtmProvider({
+  gtmId,
+  strategy = "afterInteractive",
+  consentRequired = false,
+  debug = false,
+  children
+}) {
+  const [hasConsent, setHasConsent] = useState(!consentRequired);
+  const [isLoaded, setIsLoaded] = useState(false);
+  const injectedRef = useRef(false);
+  const loadGtm = useCallback(() => {
+    if (injectedRef.current) return;
+    injectedRef.current = true;
+    if (strategy === "lazyOnload" && typeof requestIdleCallback === "function") {
+      requestIdleCallback(() => {
+        injectGtmScript(gtmId, strategy);
+        setIsLoaded(true);
+      });
+    } else if (strategy === "afterInteractive") {
+      setTimeout(() => {
+        injectGtmScript(gtmId, strategy);
+        setIsLoaded(true);
+      }, 0);
+    } else {
+      injectGtmScript(gtmId, strategy);
+      setIsLoaded(true);
+    }
+  }, [gtmId, strategy]);
+  if (hasConsent && !injectedRef.current && typeof window !== "undefined") {
+    loadGtm();
+  }
+  const pushEvent = useCallback(
+    (event, params) => {
+      const entry = { event, ...params };
+      if (debug) {
+        console.log("[GTM]", entry);
+      }
+      getDataLayer().push(entry);
+    },
+    [debug]
+  );
+  const pushEcommerceEvent = useCallback(
+    (event, params) => {
+      getDataLayer().push({ ecommerce: null });
+      const entry = { event, ecommerce: params };
+      if (debug) {
+        console.log("[GTM ecommerce]", entry);
+      }
+      getDataLayer().push(entry);
+    },
+    [debug]
+  );
+  const grantConsent = useCallback(() => {
+    setHasConsent(true);
+    loadGtm();
+  }, [loadGtm]);
+  const revokeConsent = useCallback(() => {
+    setHasConsent(false);
+  }, []);
+  const value = useMemo(
+    () => ({
+      pushEvent,
+      pushEcommerceEvent,
+      grantConsent,
+      revokeConsent,
+      hasConsent,
+      isLoaded
+    }),
+    [
+      pushEvent,
+      pushEcommerceEvent,
+      grantConsent,
+      revokeConsent,
+      hasConsent,
+      isLoaded
+    ]
+  );
+  return /* @__PURE__ */ jsx(GtmContext.Provider, { value, children });
+}
+function useGtm() {
+  const context = useContext(GtmContext);
+  if (!context) {
+    throw new Error("useGtm must be used within a <GtmProvider>");
+  }
+  return context;
+}
+function GtmNoscript({ gtmId }) {
+  return /* @__PURE__ */ jsx("noscript", { children: /* @__PURE__ */ jsx(
+    "iframe",
+    {
+      src: `https://www.googletagmanager.com/ns.html?id=${encodeURIComponent(gtmId)}`,
+      height: "0",
+      width: "0",
+      style: { display: "none", visibility: "hidden" },
+      title: "Google Tag Manager"
+    }
+  ) });
+}
+export {
+  GtmNoscript,
+  GtmProvider,
+  useGtm
+};
+//# sourceMappingURL=gtm.js.map

package/dist/gtm.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/gtm.tsx"],"sourcesContent":["\"use client\";\n\nimport {\n  createContext,\n  useCallback,\n  useContext,\n  useMemo,\n  useRef,\n  useState,\n} from \"react\";\nimport type { ReactNode } from \"react\";\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/** GTM script loading strategy. */\nexport type GtmStrategy =\n  | \"default\"\n  | \"afterInteractive\"\n  | \"lazyOnload\"\n  | \"worker\";\n\n/** GA4 standard e-commerce event names. */\nexport type GtmEcommerceEvent =\n  | \"view_item\"\n  | \"view_item_list\"\n  | \"select_item\"\n  | \"add_to_cart\"\n  | \"remove_from_cart\"\n  | \"view_cart\"\n  | \"begin_checkout\"\n  | \"add_shipping_info\"\n  | \"add_payment_info\"\n  | \"purchase\"\n  | \"refund\";\n\n/** GA4 e-commerce item shape. */\nexport interface GtmItem {\n  item_id: string;\n  item_name?: string;\n  item_brand?: string;\n  item_category?: string;\n  item_variant?: string;\n  price?: number;\n  quantity?: number;\n  index?: number;\n  [key: string]: unknown;\n}\n\n/** Parameters for e-commerce events. */\nexport interface GtmEcommerceParams {\n  currency?: string;\n  value?: number;\n  items?: GtmItem[];\n  transaction_id?: string;\n  shipping?: number;\n  tax?: number;\n  coupon?: string;\n  [key: string]: unknown;\n}\n\nexport interface GtmProviderProps {\n  /** GTM container ID (e.g. \"GTM-XXXXX\"). */\n  gtmId: string;\n  /** Script loading strategy. Default: \"afterInteractive\". */\n  strategy?: GtmStrategy;\n  /** Delay GTM loading until consent is granted. Default: false. */\n  consentRequired?: boolean;\n  /** Log dataLayer pushes to console. Default: false. */\n  debug?: boolean;\n  children: ReactNode;\n}\n\nexport interface GtmContextValue {\n  /** Push a custom event to the dataLayer. */\n  pushEvent: (event: string, params?: Record<string, unknown>) => void;\n  /** Push a GA4 e-commerce event to the dataLayer. */\n  pushEcommerceEvent: (\n    event: GtmEcommerceEvent,\n    params: GtmEcommerceParams,\n  ) => void;\n  /** Grant consent — loads GTM if consentRequired was true. */\n  grantConsent: () => void;\n  /** Revoke consent. Does not unload GTM (scripts can't be unloaded). */\n  revokeConsent: () => void;\n  /** Whether consent has been granted. */\n  hasConsent: boolean;\n  /** Whether the GTM script has been injected. */\n  isLoaded: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Context\n// ---------------------------------------------------------------------------\n\nconst GtmContext = createContext<GtmContextValue | null>(null);\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\ndeclare global {\n  interface Window {\n    dataLayer?: Record<string, unknown>[];\n  }\n}\n\nfunction getDataLayer(): Record<string, unknown>[] {\n  if (typeof window === \"undefined\") return [];\n  if (!window.dataLayer) window.dataLayer = [];\n  return window.dataLayer;\n}\n\nfunction injectGtmScript(gtmId: string, strategy: GtmStrategy): void {\n  if (typeof document === \"undefined\") return;\n\n  // Prevent double-injection\n  if (document.getElementById(\"gtm-script\")) return;\n\n  const dataLayer = getDataLayer();\n  dataLayer.push({ \"gtm.start\": new Date().getTime(), event: \"gtm.js\" });\n\n  const script = document.createElement(\"script\");\n  script.id = \"gtm-script\";\n  script.src = `https://www.googletagmanager.com/gtm.js?id=${encodeURIComponent(gtmId)}`;\n\n  if (strategy === \"lazyOnload\") {\n    script.async = true;\n    script.defer = true;\n  } else if (strategy === \"worker\") {\n    script.type = \"text/partytown\";\n    script.async = true;\n  } else {\n    // \"default\" and \"afterInteractive\"\n    script.async = true;\n  }\n\n  document.head.appendChild(script);\n}\n\n// ---------------------------------------------------------------------------\n// Provider\n// ---------------------------------------------------------------------------\n\nexport function GtmProvider({\n  gtmId,\n  strategy = \"afterInteractive\",\n  consentRequired = false,\n  debug = false,\n  children,\n}: GtmProviderProps) {\n  const [hasConsent, setHasConsent] = useState(!consentRequired);\n  const [isLoaded, setIsLoaded] = useState(false);\n  const injectedRef = useRef(false);\n\n  const loadGtm = useCallback(() => {\n    if (injectedRef.current) return;\n    injectedRef.current = true;\n\n    if (strategy === \"lazyOnload\" && typeof requestIdleCallback === \"function\") {\n      requestIdleCallback(() => {\n        injectGtmScript(gtmId, strategy);\n        setIsLoaded(true);\n      });\n    } else if (strategy === \"afterInteractive\") {\n      // Defer to after hydration\n      setTimeout(() => {\n        injectGtmScript(gtmId, strategy);\n        setIsLoaded(true);\n      }, 0);\n    } else {\n      injectGtmScript(gtmId, strategy);\n      setIsLoaded(true);\n    }\n  }, [gtmId, strategy]);\n\n  // Auto-load when consent is not required or already granted\n  if (hasConsent && !injectedRef.current && typeof window !== \"undefined\") {\n    loadGtm();\n  }\n\n  const pushEvent = useCallback(\n    (event: string, params?: Record<string, unknown>) => {\n      const entry = { event, ...params };\n      if (debug) {\n        console.log(\"[GTM]\", entry);\n      }\n      getDataLayer().push(entry);\n    },\n    [debug],\n  );\n\n  const pushEcommerceEvent = useCallback(\n    (event: GtmEcommerceEvent, params: GtmEcommerceParams) => {\n      // Clear previous ecommerce data per GA4 best practices\n      getDataLayer().push({ ecommerce: null });\n      const entry = { event, ecommerce: params };\n      if (debug) {\n        console.log(\"[GTM ecommerce]\", entry);\n      }\n      getDataLayer().push(entry);\n    },\n    [debug],\n  );\n\n  const grantConsent = useCallback(() => {\n    setHasConsent(true);\n    loadGtm();\n  }, [loadGtm]);\n\n  const revokeConsent = useCallback(() => {\n    setHasConsent(false);\n  }, []);\n\n  const value = useMemo<GtmContextValue>(\n    () => ({\n      pushEvent,\n      pushEcommerceEvent,\n      grantConsent,\n      revokeConsent,\n      hasConsent,\n      isLoaded,\n    }),\n    [\n      pushEvent,\n      pushEcommerceEvent,\n      grantConsent,\n      revokeConsent,\n      hasConsent,\n      isLoaded,\n    ],\n  );\n\n  return <GtmContext.Provider value={value}>{children}</GtmContext.Provider>;\n}\n\n// ---------------------------------------------------------------------------\n// Hook\n// ---------------------------------------------------------------------------\n\nexport function useGtm(): GtmContextValue {\n  const context = useContext(GtmContext);\n  if (!context) {\n    throw new Error(\"useGtm must be used within a <GtmProvider>\");\n  }\n  return context;\n}\n\n// ---------------------------------------------------------------------------\n// Noscript\n// ---------------------------------------------------------------------------\n\nexport interface GtmNoscriptProps {\n  /** GTM container ID (must match GtmProvider). */\n  gtmId: string;\n}\n\nexport function GtmNoscript({ gtmId }: GtmNoscriptProps) {\n  return (\n    <noscript>\n      <iframe\n        src={`https://www.googletagmanager.com/ns.html?id=${encodeURIComponent(gtmId)}`}\n        height=\"0\"\n        width=\"0\"\n        style={{ display: \"none\", visibility: \"hidden\" }}\n        title=\"Google Tag Manager\"\n      />\n    </noscript>\n  );\n}\n"],"mappings":";;;;AAEA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAiOE;AA1IT,IAAM,aAAa,cAAsC,IAAI;AAY7D,SAAS,eAA0C;AACjD,MAAI,OAAO,WAAW,YAAa,QAAO,CAAC;AAC3C,MAAI,CAAC,OAAO,UAAW,QAAO,YAAY,CAAC;AAC3C,SAAO,OAAO;AAChB;AAEA,SAAS,gBAAgB,OAAe,UAA6B;AACnE,MAAI,OAAO,aAAa,YAAa;AAGrC,MAAI,SAAS,eAAe,YAAY,EAAG;AAE3C,QAAM,YAAY,aAAa;AAC/B,YAAU,KAAK,EAAE,cAAa,oBAAI,KAAK,GAAE,QAAQ,GAAG,OAAO,SAAS,CAAC;AAErE,QAAM,SAAS,SAAS,cAAc,QAAQ;AAC9C,SAAO,KAAK;AACZ,SAAO,MAAM,8CAA8C,mBAAmB,KAAK,CAAC;AAEpF,MAAI,aAAa,cAAc;AAC7B,WAAO,QAAQ;AACf,WAAO,QAAQ;AAAA,EACjB,WAAW,aAAa,UAAU;AAChC,WAAO,OAAO;AACd,WAAO,QAAQ;AAAA,EACjB,OAAO;AAEL,WAAO,QAAQ;AAAA,EACjB;AAEA,WAAS,KAAK,YAAY,MAAM;AAClC;AAMO,SAAS,YAAY;AAAA,EAC1B;AAAA,EACA,WAAW;AAAA,EACX,kBAAkB;AAAA,EAClB,QAAQ;AAAA,EACR;AACF,GAAqB;AACnB,QAAM,CAAC,YAAY,aAAa,IAAI,SAAS,CAAC,eAAe;AAC7D,QAAM,CAAC,UAAU,WAAW,IAAI,SAAS,KAAK;AAC9C,QAAM,cAAc,OAAO,KAAK;AAEhC,QAAM,UAAU,YAAY,MAAM;AAChC,QAAI,YAAY,QAAS;AACzB,gBAAY,UAAU;AAEtB,QAAI,aAAa,gBAAgB,OAAO,wBAAwB,YAAY;AAC1E,0BAAoB,MAAM;AACxB,wBAAgB,OAAO,QAAQ;AAC/B,oBAAY,IAAI;AAAA,MAClB,CAAC;AAAA,IACH,WAAW,aAAa,oBAAoB;AAE1C,iBAAW,MAAM;AACf,wBAAgB,OAAO,QAAQ;AAC/B,oBAAY,IAAI;AAAA,MAClB,GAAG,CAAC;AAAA,IACN,OAAO;AACL,sBAAgB,OAAO,QAAQ;AAC/B,kBAAY,IAAI;AAAA,IAClB;AAAA,EACF,GAAG,CAAC,OAAO,QAAQ,CAAC;AAGpB,MAAI,cAAc,CAAC,YAAY,WAAW,OAAO,WAAW,aAAa;AACvE,YAAQ;AAAA,EACV;AAEA,QAAM,YAAY;AAAA,IAChB,CAAC,OAAe,WAAqC;AACnD,YAAM,QAAQ,EAAE,OAAO,GAAG,OAAO;AACjC,UAAI,OAAO;AACT,gBAAQ,IAAI,SAAS,KAAK;AAAA,MAC5B;AACA,mBAAa,EAAE,KAAK,KAAK;AAAA,IAC3B;AAAA,IACA,CAAC,KAAK;AAAA,EACR;AAEA,QAAM,qBAAqB;AAAA,IACzB,CAAC,OAA0B,WAA+B;AAExD,mBAAa,EAAE,KAAK,EAAE,WAAW,KAAK,CAAC;AACvC,YAAM,QAAQ,EAAE,OAAO,WAAW,OAAO;AACzC,UAAI,OAAO;AACT,gBAAQ,IAAI,mBAAmB,KAAK;AAAA,MACtC;AACA,mBAAa,EAAE,KAAK,KAAK;AAAA,IAC3B;AAAA,IACA,CAAC,KAAK;AAAA,EACR;AAEA,QAAM,eAAe,YAAY,MAAM;AACrC,kBAAc,IAAI;AAClB,YAAQ;AAAA,EACV,GAAG,CAAC,OAAO,CAAC;AAEZ,QAAM,gBAAgB,YAAY,MAAM;AACtC,kBAAc,KAAK;AAAA,EACrB,GAAG,CAAC,CAAC;AAEL,QAAM,QAAQ;AAAA,IACZ,OAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA;AAAA,MACE;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEA,SAAO,oBAAC,WAAW,UAAX,EAAoB,OAAe,UAAS;AACtD;AAMO,SAAS,SAA0B;AACxC,QAAM,UAAU,WAAW,UAAU;AACrC,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI,MAAM,4CAA4C;AAAA,EAC9D;AACA,SAAO;AACT;AAWO,SAAS,YAAY,EAAE,MAAM,GAAqB;AACvD,SACE,oBAAC,cACC;AAAA,IAAC;AAAA;AAAA,MACC,KAAK,+CAA+C,mBAAmB,KAAK,CAAC;AAAA,MAC7E,QAAO;AAAA,MACP,OAAM;AAAA,MACN,OAAO,EAAE,SAAS,QAAQ,YAAY,SAAS;AAAA,MAC/C,OAAM;AAAA;AAAA,EACR,GACF;AAEJ;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simpleapps-com/augur-web",
-  "version": "0.2.13",
+  "version": "0.2.14",
   "description": "Shared React UI components for Augur ecommerce sites (Radix + Tailwind)",
   "license": "MIT",
   "repository": {
@@ -145,6 +145,11 @@
       "import": "./dist/form-textarea.js",
       "require": "./dist/form-textarea.cjs"
     },
+    "./gtm": {
+      "types": "./dist/gtm.d.ts",
+      "import": "./dist/gtm.js",
+      "require": "./dist/gtm.cjs"
+    },
     "./mdx-components": {
       "types": "./dist/mdx-components.d.ts",
       "import": "./dist/mdx-components.js",
@@ -156,7 +161,7 @@
     "dist"
   ],
   "dependencies": {
-    "@simpleapps-com/augur-utils": "0.2.13"
+    "@simpleapps-com/augur-utils": "0.2.14"
   },
   "peerDependencies": {
     "@radix-ui/react-accordion": "^1.2.0",