@replohq/sdk 0.1.0

package/analytics/analytics-provider.d.ts

@@ -0,0 +1,16 @@
+import type React from "react";
+import type { CheckoutProvider } from "../lib/integration-utils";
+import type { AnalyticsSink } from "./analytics-sink";
+export declare function AnalyticsProvider({ children, checkoutProvider, }: React.PropsWithChildren<{
+    checkoutProvider?: CheckoutProvider;
+}>): import("react/jsx-runtime").JSX.Element;
+/**
+ * Returns the AnalyticsSink from the nearest AnalyticsProvider.
+ * Throws if used outside of an AnalyticsProvider.
+ */
+export declare function useAnalytics(): AnalyticsSink | null;
+/**
+ * Returns the AnalyticsSink if an AnalyticsProvider is present, or null otherwise.
+ * Does not throw -- safe to use in components that may render with or without analytics.
+ */
+export declare function useAnalyticsOptional(): AnalyticsSink | null;

package/analytics/analytics-provider.js

@@ -0,0 +1,113 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import { createContext, useContext, useEffect, useMemo, useRef } from "react";
+import { useConsent } from "../consent/consent-store";
+import { useRegisteredScripts } from "../consent/script-registration-store";
+import { getAnalyticsSinks } from "./get-analytics-sinks";
+import { NavigationTracker } from "./utils/navigation-tracker";
+function combineSinks(sinks) {
+  const broadcast = async (method, ...args) => {
+    if (typeof window !== "undefined") {
+      console.debug(
+        "[analytics] broadcast",
+        method,
+        "to",
+        sinks.length,
+        "sinks",
+        { args }
+      );
+    }
+    await Promise.all(
+      sinks.map(async (sink) => {
+        try {
+          const sinkMethod = sink[method];
+          await sinkMethod.apply(sink, args);
+        } catch {
+          if (typeof window !== "undefined") {
+            console.warn("[analytics] sink error", { method, sink });
+          }
+        }
+      })
+    );
+  };
+  return {
+    pageView: (...args) => broadcast("pageView", ...args),
+    purchase: (...args) => broadcast("purchase", ...args),
+    click: (...args) => broadcast("click", ...args),
+    productViewed: (...args) => broadcast("productViewed", ...args),
+    addToCart: (...args) => broadcast("addToCart", ...args),
+    removeFromCart: (...args) => broadcast("removeFromCart", ...args),
+    viewCart: (...args) => broadcast("viewCart", ...args),
+    startCheckout: (...args) => broadcast("startCheckout", ...args),
+    viewCollection: (...args) => broadcast("viewCollection", ...args)
+  };
+}
+const AnalyticsContext = createContext(null);
+function AnalyticsProvider({
+  children,
+  checkoutProvider
+}) {
+  const consent = useConsent();
+  const registeredScripts = useRegisteredScripts();
+  const analytics = useMemo(() => {
+    return combineSinks(
+      getAnalyticsSinks({
+        consent: {
+          mode: consent.mode,
+          categories: consent.categories,
+          decidedAt: consent.decidedAt
+        },
+        registeredScripts,
+        checkoutProvider
+      })
+    );
+  }, [
+    consent.mode,
+    consent.categories,
+    consent.decidedAt,
+    registeredScripts,
+    checkoutProvider
+  ]);
+  const analyticsRef = useRef(analytics);
+  analyticsRef.current = analytics;
+  const navigationTracker = useRef(null);
+  useEffect(() => {
+    if (typeof window === "undefined") {
+      return;
+    }
+    navigationTracker.current = new NavigationTracker(
+      (metadata) => {
+        void analyticsRef.current.pageView(metadata);
+      }
+    );
+    navigationTracker.current.init();
+    return () => {
+      navigationTracker.current?.cleanup();
+    };
+  }, []);
+  return /* @__PURE__ */ jsx(AnalyticsContext.Provider, { value: { analytics }, children });
+}
+class AnalyticsContextError extends Error {
+  constructor({ message }) {
+    super(message);
+  }
+}
+function useAnalytics() {
+  const context = useContext(AnalyticsContext);
+  if (!context) {
+    throw new AnalyticsContextError({
+      message: "useAnalytics must be used within <AnalyticsProvider>"
+    });
+  }
+  return context.analytics;
+}
+function useAnalyticsOptional() {
+  const context = useContext(AnalyticsContext);
+  return context?.analytics ?? null;
+}
+export {
+  AnalyticsProvider,
+  useAnalytics,
+  useAnalyticsOptional
+};
+//# sourceMappingURL=analytics-provider.js.map

package/analytics/analytics-provider.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../analytics/analytics-provider.tsx"],
+  "sourcesContent": ["\"use client\";\n\nimport type React from \"react\";\nimport type { CheckoutProvider } from \"../lib/integration-utils\";\nimport type { AnalyticsSink } from \"./analytics-sink\";\nimport type { PageMetadata } from \"./utils/navigation-tracker\";\n\nimport { createContext, useContext, useEffect, useMemo, useRef } from \"react\";\n\nimport { useConsent } from \"../consent/consent-store\";\nimport { useRegisteredScripts } from \"../consent/script-registration-store\";\nimport { getAnalyticsSinks } from \"./get-analytics-sinks\";\nimport { NavigationTracker } from \"./utils/navigation-tracker\";\n\nfunction combineSinks(sinks: AnalyticsSink[]): AnalyticsSink {\n  // oxlint-disable-next-line typescript/no-explicit-any -- legacy any, may or may not be needed\n  const broadcast = async (method: keyof AnalyticsSink, ...args: any[]) => {\n    if (typeof window !== \"undefined\") {\n      console.debug(\n        \"[analytics] broadcast\",\n        method,\n        \"to\",\n        sinks.length,\n        \"sinks\",\n        { args },\n      );\n    }\n\n    await Promise.all(\n      sinks.map(async (sink) => {\n        try {\n          // Legacy cast - may or may not be necessary\n          // oxlint-disable-next-line replo/no-as-cast, typescript/no-explicit-any -- legacy any/cast, may or may not be needed\n          const sinkMethod = sink[method] as (...args: any[]) => Promise<void>;\n          await sinkMethod.apply(sink, args);\n        } catch {\n          if (typeof window !== \"undefined\") {\n            console.warn(\"[analytics] sink error\", { method, sink });\n          }\n        }\n      }),\n    );\n  };\n\n  return {\n    pageView: (...args) => broadcast(\"pageView\", ...args),\n    purchase: (...args) => broadcast(\"purchase\", ...args),\n    click: (...args) => broadcast(\"click\", ...args),\n    productViewed: (...args) => broadcast(\"productViewed\", ...args),\n    addToCart: (...args) => broadcast(\"addToCart\", ...args),\n    removeFromCart: (...args) => broadcast(\"removeFromCart\", ...args),\n    viewCart: (...args) => broadcast(\"viewCart\", ...args),\n    startCheckout: (...args) => broadcast(\"startCheckout\", ...args),\n    viewCollection: (...args) => broadcast(\"viewCollection\", ...args),\n  };\n}\n\ninterface AnalyticsContextType {\n  analytics: AnalyticsSink | null;\n}\n\nconst AnalyticsContext = createContext<AnalyticsContextType | null>(null);\n\nexport function AnalyticsProvider({\n  children,\n  checkoutProvider,\n}: React.PropsWithChildren<{ checkoutProvider?: CheckoutProvider }>) {\n  const consent = useConsent();\n  const registeredScripts = useRegisteredScripts();\n\n  // Sinks are derived from consent + which managed scripts are on the page, so\n  // the set rebuilds whenever the visitor changes consent or a script mounts.\n  const analytics = useMemo(() => {\n    return combineSinks(\n      getAnalyticsSinks({\n        consent: {\n          mode: consent.mode,\n          categories: consent.categories,\n          decidedAt: consent.decidedAt,\n        },\n        registeredScripts,\n        checkoutProvider,\n      }),\n    );\n  }, [\n    consent.mode,\n    consent.categories,\n    consent.decidedAt,\n    registeredScripts,\n    checkoutProvider,\n  ]);\n\n  // The navigation tracker is set up once, but always dispatches to the latest\n  // combined sink via a ref so consent/registration changes take effect.\n  const analyticsRef = useRef(analytics);\n  analyticsRef.current = analytics;\n  const navigationTracker = useRef<NavigationTracker | null>(null);\n\n  // eslint-disable-next-line replo/no-use-effect -- one-time SPA navigation tracking setup; dispatches through analyticsRef to stay current\n  useEffect(() => {\n    if (typeof window === \"undefined\") {\n      return;\n    }\n    navigationTracker.current = new NavigationTracker(\n      (metadata: PageMetadata) => {\n        void analyticsRef.current.pageView(metadata);\n      },\n    );\n    navigationTracker.current.init();\n\n    return () => {\n      navigationTracker.current?.cleanup();\n    };\n  }, []);\n\n  return (\n    <AnalyticsContext.Provider value={{ analytics }}>\n      {children}\n    </AnalyticsContext.Provider>\n  );\n}\n\nclass AnalyticsContextError extends Error {\n  constructor({ message }: { message: string }) {\n    super(message);\n  }\n}\n\n/**\n * Returns the AnalyticsSink from the nearest AnalyticsProvider.\n * Throws if used outside of an AnalyticsProvider.\n */\nexport function useAnalytics(): AnalyticsSink | null {\n  const context = useContext(AnalyticsContext);\n  if (!context) {\n    throw new AnalyticsContextError({\n      message: \"useAnalytics must be used within <AnalyticsProvider>\",\n    });\n  }\n  return context.analytics;\n}\n\n/**\n * Returns the AnalyticsSink if an AnalyticsProvider is present, or null otherwise.\n * Does not throw -- safe to use in components that may render with or without analytics.\n */\nexport function useAnalyticsOptional(): AnalyticsSink | null {\n  const context = useContext(AnalyticsContext);\n  return context?.analytics ?? null;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/analytics/analytics-sink.d.ts

@@ -0,0 +1,26 @@
+import type { PageMetadata } from "./utils/navigation-tracker";
+export type DataPayload = {
+    data: Record<string, any>;
+};
+export type PurchasePayload = {
+    /**
+     * Decimal major units (e.g. 19.99), NOT minor units — every downstream ad
+     * sink (GA4/Meta/TikTok value fields) and the Replo analytics store speak
+     * decimal money. Convert with fromMinorUnitsToMajorUnits at the caller when the source
+     * amount is integer minor units.
+     */
+    amount: number;
+    currency: string;
+    data: Record<string, any>;
+};
+export interface AnalyticsSink {
+    pageView(metadata?: PageMetadata): Promise<void>;
+    purchase(payload: PurchasePayload): Promise<void>;
+    click(payload: DataPayload): Promise<void>;
+    productViewed(payload: DataPayload): Promise<void>;
+    addToCart(payload: DataPayload): Promise<void>;
+    removeFromCart(payload: DataPayload): Promise<void>;
+    viewCart(payload: DataPayload): Promise<void>;
+    startCheckout(payload: DataPayload): Promise<void>;
+    viewCollection(payload: DataPayload): Promise<void>;
+}

package/analytics/analytics-sink.js

@@ -0,0 +1 @@
+//# sourceMappingURL=analytics-sink.js.map

package/analytics/analytics-sink.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/analytics/get-analytics-sinks.d.ts

@@ -0,0 +1,27 @@
+import type { ConsentState } from "../consent/consent-store";
+import type { RegisteredScript } from "../consent/script-registration-store";
+import type { CheckoutProvider } from "../lib/integration-utils";
+import type { AnalyticsSink } from "./analytics-sink";
+/**
+ * Builds the set of analytics sinks that may fire given the current consent
+ * state and which managed scripts are registered on the page.
+ *
+ * Consent gates data egress, not in-page plumbing:
+ * - `WindowSink` is a local `CustomEvent` bus (no data leaves the device), so it
+ *   always ships regardless of consent. Its consumers self-gate: managed pixels
+ *   are already gated at the injection layer (they never mount without consent,
+ *   so they never subscribe), and unmanaged custom scripts are the author's
+ *   responsibility.
+ * - `ReploSink` forwards into Replo's first-party analytics pipeline (real
+ *   egress / processing), so it counts as `analytics`-category tracking and is
+ *   gated by that consent. It is an implicit sink this scaffold always ships
+ *   (not tied to a registered entry) and is never editable in the miniapp.
+ *
+ * Third-party provider sinks are created only when a matching `<ReploScripts>`
+ * entry is registered AND its required consent is granted.
+ */
+export declare function getAnalyticsSinks({ consent, registeredScripts, checkoutProvider, }: {
+    consent: ConsentState;
+    registeredScripts: RegisteredScript[];
+    checkoutProvider?: CheckoutProvider;
+}): AnalyticsSink[];

package/analytics/get-analytics-sinks.js

@@ -0,0 +1,52 @@
+import { isConsentAllowed } from "../consent/consent-store";
+import { GA4Sink } from "./sinks/ga4-sink";
+import { MetaSink } from "./sinks/meta-sink";
+import { PinterestSink } from "./sinks/pinterest-sink";
+import { RedditSink } from "./sinks/reddit-sink";
+import { ReploSink } from "./sinks/replo-sink";
+import { SnapchatSink } from "./sinks/snapchat-sink";
+import { TikTokSink } from "./sinks/tiktok-sink";
+import { WindowSink } from "./sinks/window-sink";
+import { gateShopifyOwnedFunnelEvents } from "./utils/shopify-funnel-gate";
+const PROVIDER_SINK_FACTORIES = {
+  GA4: () => new GA4Sink(),
+  Meta: () => new MetaSink(),
+  TikTok: () => new TikTokSink(),
+  Snapchat: () => new SnapchatSink(),
+  Pinterest: () => new PinterestSink(),
+  Reddit: () => new RedditSink()
+};
+function getAnalyticsSinks({
+  consent,
+  registeredScripts,
+  checkoutProvider
+}) {
+  const sinks = [new WindowSink()];
+  const firstPartyAllowed = consent.mode === "off" || consent.categories.analytics;
+  if (firstPartyAllowed) {
+    sinks.push(new ReploSink());
+  }
+  const shopifyOwnsCheckout = checkoutProvider === "shopify";
+  const addedTypes = /* @__PURE__ */ new Set();
+  for (const script of registeredScripts) {
+    const factory = PROVIDER_SINK_FACTORIES[script.type];
+    if (!factory || addedTypes.has(script.type)) {
+      continue;
+    }
+    if (isConsentAllowed({
+      state: consent,
+      requiredConsent: script.requiredConsent
+    })) {
+      const sink = factory();
+      sinks.push(
+        shopifyOwnsCheckout ? gateShopifyOwnedFunnelEvents(sink) : sink
+      );
+      addedTypes.add(script.type);
+    }
+  }
+  return sinks;
+}
+export {
+  getAnalyticsSinks
+};
+//# sourceMappingURL=get-analytics-sinks.js.map

package/analytics/get-analytics-sinks.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../analytics/get-analytics-sinks.ts"],
+  "sourcesContent": ["import type { ReploScriptType } from \"schemas/generated/consent\";\nimport type { ConsentState } from \"../consent/consent-store\";\nimport type { RegisteredScript } from \"../consent/script-registration-store\";\nimport type { CheckoutProvider } from \"../lib/integration-utils\";\nimport type { AnalyticsSink } from \"./analytics-sink\";\n\nimport { isConsentAllowed } from \"../consent/consent-store\";\nimport { GA4Sink } from \"./sinks/ga4-sink\";\nimport { MetaSink } from \"./sinks/meta-sink\";\nimport { PinterestSink } from \"./sinks/pinterest-sink\";\nimport { RedditSink } from \"./sinks/reddit-sink\";\nimport { ReploSink } from \"./sinks/replo-sink\";\nimport { SnapchatSink } from \"./sinks/snapchat-sink\";\nimport { TikTokSink } from \"./sinks/tiktok-sink\";\nimport { WindowSink } from \"./sinks/window-sink\";\nimport { gateShopifyOwnedFunnelEvents } from \"./utils/shopify-funnel-gate\";\n\n/**\n * Named providers that have a corresponding ecommerce-event sink. The other\n * managed providers (GoogleTagManager, Hotjar, MicrosoftClarity, Segment) and\n * generic `snippet`/`custom` entries load scripts but do not map to\n * `AnalyticsSink` events today, so they never produce a sink here.\n */\nconst PROVIDER_SINK_FACTORIES: Partial<\n  Record<ReploScriptType, () => AnalyticsSink>\n> = {\n  GA4: () => new GA4Sink(),\n  Meta: () => new MetaSink(),\n  TikTok: () => new TikTokSink(),\n  Snapchat: () => new SnapchatSink(),\n  Pinterest: () => new PinterestSink(),\n  Reddit: () => new RedditSink(),\n};\n\n/**\n * Builds the set of analytics sinks that may fire given the current consent\n * state and which managed scripts are registered on the page.\n *\n * Consent gates data egress, not in-page plumbing:\n * - `WindowSink` is a local `CustomEvent` bus (no data leaves the device), so it\n *   always ships regardless of consent. Its consumers self-gate: managed pixels\n *   are already gated at the injection layer (they never mount without consent,\n *   so they never subscribe), and unmanaged custom scripts are the author's\n *   responsibility.\n * - `ReploSink` forwards into Replo's first-party analytics pipeline (real\n *   egress / processing), so it counts as `analytics`-category tracking and is\n *   gated by that consent. It is an implicit sink this scaffold always ships\n *   (not tied to a registered entry) and is never editable in the miniapp.\n *\n * Third-party provider sinks are created only when a matching `<ReploScripts>`\n * entry is registered AND its required consent is granted.\n */\nexport function getAnalyticsSinks({\n  consent,\n  registeredScripts,\n  checkoutProvider,\n}: {\n  consent: ConsentState;\n  registeredScripts: RegisteredScript[];\n  checkoutProvider?: CheckoutProvider;\n}): AnalyticsSink[] {\n  const sinks: AnalyticsSink[] = [new WindowSink()];\n\n  const firstPartyAllowed =\n    consent.mode === \"off\" || consent.categories.analytics;\n  if (firstPartyAllowed) {\n    sinks.push(new ReploSink());\n  }\n\n  // When Shopify hosts checkout, its native channels report the checkout-funnel\n  // events to ad platforms server-side. Suppress those events on third-party\n  // storefront pixels so they don't double-count Shopify's copy.\n  const shopifyOwnsCheckout = checkoutProvider === \"shopify\";\n\n  const addedTypes = new Set<ReploScriptType>();\n  for (const script of registeredScripts) {\n    const factory = PROVIDER_SINK_FACTORIES[script.type];\n    if (!factory || addedTypes.has(script.type)) {\n      continue;\n    }\n    if (\n      isConsentAllowed({\n        state: consent,\n        requiredConsent: script.requiredConsent,\n      })\n    ) {\n      const sink = factory();\n      sinks.push(\n        shopifyOwnsCheckout ? gateShopifyOwnedFunnelEvents(sink) : sink,\n      );\n      addedTypes.add(script.type);\n    }\n  }\n\n  return sinks;\n}\n"],
+  "mappings": "AAMA,SAAS,wBAAwB;AACjC,SAAS,eAAe;AACxB,SAAS,gBAAgB;AACzB,SAAS,qBAAqB;AAC9B,SAAS,kBAAkB;AAC3B,SAAS,iBAAiB;AAC1B,SAAS,oBAAoB;AAC7B,SAAS,kBAAkB;AAC3B,SAAS,kBAAkB;AAC3B,SAAS,oCAAoC;AAQ7C,MAAM,0BAEF;AAAA,EACF,KAAK,MAAM,IAAI,QAAQ;AAAA,EACvB,MAAM,MAAM,IAAI,SAAS;AAAA,EACzB,QAAQ,MAAM,IAAI,WAAW;AAAA,EAC7B,UAAU,MAAM,IAAI,aAAa;AAAA,EACjC,WAAW,MAAM,IAAI,cAAc;AAAA,EACnC,QAAQ,MAAM,IAAI,WAAW;AAC/B;AAoBO,SAAS,kBAAkB;AAAA,EAChC;AAAA,EACA;AAAA,EACA;AACF,GAIoB;AAClB,QAAM,QAAyB,CAAC,IAAI,WAAW,CAAC;AAEhD,QAAM,oBACJ,QAAQ,SAAS,SAAS,QAAQ,WAAW;AAC/C,MAAI,mBAAmB;AACrB,UAAM,KAAK,IAAI,UAAU,CAAC;AAAA,EAC5B;AAKA,QAAM,sBAAsB,qBAAqB;AAEjD,QAAM,aAAa,oBAAI,IAAqB;AAC5C,aAAW,UAAU,mBAAmB;AACtC,UAAM,UAAU,wBAAwB,OAAO,IAAI;AACnD,QAAI,CAAC,WAAW,WAAW,IAAI,OAAO,IAAI,GAAG;AAC3C;AAAA,IACF;AACA,QACE,iBAAiB;AAAA,MACf,OAAO;AAAA,MACP,iBAAiB,OAAO;AAAA,IAC1B,CAAC,GACD;AACA,YAAM,OAAO,QAAQ;AACrB,YAAM;AAAA,QACJ,sBAAsB,6BAA6B,IAAI,IAAI;AAAA,MAC7D;AACA,iBAAW,IAAI,OAAO,IAAI;AAAA,IAC5B;AAAA,EACF;AAEA,SAAO;AACT;",
+  "names": []
+}

package/analytics/hooks/use-product-viewed-analytics.d.ts

@@ -0,0 +1,23 @@
+interface AnalyticsProduct {
+    id: string;
+    title: string;
+    slug?: string;
+    description?: string;
+}
+interface AnalyticsProductVariant {
+    id: string;
+    title?: string;
+    sku?: string;
+    price?: number;
+}
+interface UseProductViewedAnalyticsProps {
+    product: AnalyticsProduct | null;
+    selectedVariant?: AnalyticsProductVariant | null;
+}
+/**
+ * Fires a `productViewed` analytics event when the product or selected variant
+ * changes. Deduplicates by product+variant ID so the same combination is only
+ * tracked once per component lifecycle.
+ */
+export declare function useProductViewedAnalytics({ product, selectedVariant, }: UseProductViewedAnalyticsProps): void;
+export {};

package/analytics/hooks/use-product-viewed-analytics.js

@@ -0,0 +1,34 @@
+"use client";
+import { useEffect, useRef } from "react";
+import { useAnalytics } from "../analytics-provider";
+function useProductViewedAnalytics({
+  product,
+  selectedVariant
+}) {
+  const analytics = useAnalytics();
+  const lastTrackedRef = useRef(null);
+  useEffect(() => {
+    if (analytics && product && selectedVariant) {
+      const trackingKey = `${product.id}-${selectedVariant.id}`;
+      if (lastTrackedRef.current !== trackingKey) {
+        lastTrackedRef.current = trackingKey;
+        void analytics.productViewed({
+          data: {
+            productId: product.id,
+            productTitle: product.title,
+            productSlug: product.slug,
+            productDescription: product.description,
+            variantId: selectedVariant.id ?? "",
+            variantTitle: selectedVariant.title ?? "",
+            variantSku: selectedVariant.sku ?? "",
+            price: selectedVariant.price ?? 0
+          }
+        });
+      }
+    }
+  }, [analytics, product, selectedVariant]);
+}
+export {
+  useProductViewedAnalytics
+};
+//# sourceMappingURL=use-product-viewed-analytics.js.map

package/analytics/hooks/use-product-viewed-analytics.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../analytics/hooks/use-product-viewed-analytics.ts"],
+  "sourcesContent": ["\"use client\";\n\nimport { useEffect, useRef } from \"react\";\n\nimport { useAnalytics } from \"../analytics-provider\";\n\ninterface AnalyticsProduct {\n  id: string;\n  title: string;\n  slug?: string;\n  description?: string;\n}\n\ninterface AnalyticsProductVariant {\n  id: string;\n  title?: string;\n  sku?: string;\n  price?: number;\n}\n\ninterface UseProductViewedAnalyticsProps {\n  product: AnalyticsProduct | null;\n  selectedVariant?: AnalyticsProductVariant | null;\n}\n\n/**\n * Fires a `productViewed` analytics event when the product or selected variant\n * changes. Deduplicates by product+variant ID so the same combination is only\n * tracked once per component lifecycle.\n */\nexport function useProductViewedAnalytics({\n  product,\n  selectedVariant,\n}: UseProductViewedAnalyticsProps) {\n  const analytics = useAnalytics();\n  const lastTrackedRef = useRef<string | null>(null);\n\n  // eslint-disable-next-line replo/no-use-effect -- Legacy effect - may or may not be necessary\n  useEffect(() => {\n    if (analytics && product && selectedVariant) {\n      const trackingKey = `${product.id}-${selectedVariant.id}`;\n\n      if (lastTrackedRef.current !== trackingKey) {\n        lastTrackedRef.current = trackingKey;\n\n        void analytics.productViewed({\n          data: {\n            productId: product.id,\n            productTitle: product.title,\n            productSlug: product.slug,\n            productDescription: product.description,\n            variantId: selectedVariant.id ?? \"\",\n            variantTitle: selectedVariant.title ?? \"\",\n            variantSku: selectedVariant.sku ?? \"\",\n            price: selectedVariant.price ?? 0,\n          },\n        });\n      }\n    }\n  }, [analytics, product, selectedVariant]);\n}\n"],
+  "mappings": ";AAEA,SAAS,WAAW,cAAc;AAElC,SAAS,oBAAoB;AA0BtB,SAAS,0BAA0B;AAAA,EACxC;AAAA,EACA;AACF,GAAmC;AACjC,QAAM,YAAY,aAAa;AAC/B,QAAM,iBAAiB,OAAsB,IAAI;AAGjD,YAAU,MAAM;AACd,QAAI,aAAa,WAAW,iBAAiB;AAC3C,YAAM,cAAc,GAAG,QAAQ,EAAE,IAAI,gBAAgB,EAAE;AAEvD,UAAI,eAAe,YAAY,aAAa;AAC1C,uBAAe,UAAU;AAEzB,aAAK,UAAU,cAAc;AAAA,UAC3B,MAAM;AAAA,YACJ,WAAW,QAAQ;AAAA,YACnB,cAAc,QAAQ;AAAA,YACtB,aAAa,QAAQ;AAAA,YACrB,oBAAoB,QAAQ;AAAA,YAC5B,WAAW,gBAAgB,MAAM;AAAA,YACjC,cAAc,gBAAgB,SAAS;AAAA,YACvC,YAAY,gBAAgB,OAAO;AAAA,YACnC,OAAO,gBAAgB,SAAS;AAAA,UAClC;AAAA,QACF,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF,GAAG,CAAC,WAAW,SAAS,eAAe,CAAC;AAC1C;",
+  "names": []
+}

package/analytics/replo-first-party-pixel.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Resolves the Replo first-party pixel's config from the worker env and hands it
+ * to the consent-gated client injector. This lives inside `ReploProvider` (not
+ * the site's `app/layout.tsx`) so every agent site ships the implicit
+ * first-party pixel automatically — mirroring how `ReploSink` is an always-on
+ * sink that is never authored in the layout or editable in the miniapp.
+ *
+ * Renders nothing when the analytics pipeline isn't wired (e.g. lean local dev,
+ * where `REPLO_ANALYTICS_PIXEL_URL` / `ANALYTICS_FIRE_API_URL` are unset),
+ * mirroring the self-disabling consent action.
+ */
+export declare function ReploFirstPartyPixel(): Promise<import("react/jsx-runtime").JSX.Element | null>;

package/analytics/replo-first-party-pixel.js

@@ -0,0 +1,31 @@
+import { jsx } from "react/jsx-runtime";
+import { getEnv } from "../env";
+import { ReploPixelScript } from "./replo-pixel-script";
+async function ReploFirstPartyPixel() {
+  let pixelUrl;
+  let apiUrl;
+  let projectId;
+  try {
+    const env = await getEnv();
+    pixelUrl = env.REPLO_ANALYTICS_PIXEL_URL;
+    apiUrl = env.ANALYTICS_FIRE_API_URL;
+    projectId = env.PROJECT_ID;
+  } catch {
+    return null;
+  }
+  if (!pixelUrl || !apiUrl || !projectId) {
+    return null;
+  }
+  return /* @__PURE__ */ jsx(
+    ReploPixelScript,
+    {
+      pixelUrl,
+      apiUrl,
+      projectId
+    }
+  );
+}
+export {
+  ReploFirstPartyPixel
+};
+//# sourceMappingURL=replo-first-party-pixel.js.map

package/analytics/replo-first-party-pixel.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../analytics/replo-first-party-pixel.tsx"],
+  "sourcesContent": ["import { getEnv } from \"../env\";\nimport { ReploPixelScript } from \"./replo-pixel-script\";\n\n/**\n * Resolves the Replo first-party pixel's config from the worker env and hands it\n * to the consent-gated client injector. This lives inside `ReploProvider` (not\n * the site's `app/layout.tsx`) so every agent site ships the implicit\n * first-party pixel automatically \u2014 mirroring how `ReploSink` is an always-on\n * sink that is never authored in the layout or editable in the miniapp.\n *\n * Renders nothing when the analytics pipeline isn't wired (e.g. lean local dev,\n * where `REPLO_ANALYTICS_PIXEL_URL` / `ANALYTICS_FIRE_API_URL` are unset),\n * mirroring the self-disabling consent action.\n */\nexport async function ReploFirstPartyPixel() {\n  let pixelUrl: string | undefined;\n  let apiUrl: string | undefined;\n  let projectId: string | undefined;\n  try {\n    const env = await getEnv();\n    pixelUrl = env.REPLO_ANALYTICS_PIXEL_URL;\n    apiUrl = env.ANALYTICS_FIRE_API_URL;\n    projectId = env.PROJECT_ID;\n  } catch {\n    // No Cloudflare env (e.g. running the site outside the worker): no pixel.\n    return null;\n  }\n\n  if (!pixelUrl || !apiUrl || !projectId) {\n    return null;\n  }\n\n  return (\n    <ReploPixelScript\n      pixelUrl={pixelUrl}\n      apiUrl={apiUrl}\n      projectId={projectId}\n    />\n  );\n}\n"],
+  "mappings": "AAiCI;AAjCJ,SAAS,cAAc;AACvB,SAAS,wBAAwB;AAajC,eAAsB,uBAAuB;AAC3C,MAAI;AACJ,MAAI;AACJ,MAAI;AACJ,MAAI;AACF,UAAM,MAAM,MAAM,OAAO;AACzB,eAAW,IAAI;AACf,aAAS,IAAI;AACb,gBAAY,IAAI;AAAA,EAClB,QAAQ;AAEN,WAAO;AAAA,EACT;AAEA,MAAI,CAAC,YAAY,CAAC,UAAU,CAAC,WAAW;AACtC,WAAO;AAAA,EACT;AAEA,SACE;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA;AAAA,MACA;AAAA;AAAA,EACF;AAEJ;",
+  "names": []
+}

package/analytics/replo-pixel-script.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Consent-gated injector for Replo's first-party analytics pixel. The loaded
+ * script sets `window.ReploPixel`, which the always-on `ReploSink` forwards
+ * events into, so gating it on `analytics` consent keeps the first-party sink
+ * consent-correct without the pixel loading unconditionally in `<head>` the way
+ * the legacy scaffold does. `analytics` consent here matches the
+ * `firstPartyAllowed` gate that controls whether `ReploSink` is created at all.
+ */
+export declare function ReploPixelScript({ pixelUrl, apiUrl, projectId, }: {
+    pixelUrl: string;
+    apiUrl: string;
+    projectId: string;
+}): import("react/jsx-runtime").JSX.Element | null;

package/analytics/replo-pixel-script.js

@@ -0,0 +1,30 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import { isConsentAllowed, useConsent } from "../consent/consent-store";
+import { InjectedScript } from "../consent/replo-scripts";
+const PIXEL_SCRIPT_ID = "replo:first-party-pixel";
+function ReploPixelScript({
+  pixelUrl,
+  apiUrl,
+  projectId
+}) {
+  const consent = useConsent();
+  if (!isConsentAllowed({ state: consent, requiredConsent: ["analytics"] })) {
+    return null;
+  }
+  const descriptors = [
+    {
+      kind: "external",
+      src: `${pixelUrl}/latest.js`,
+      attributes: {
+        "data-api-url": apiUrl,
+        "data-project-id": projectId
+      }
+    }
+  ];
+  return /* @__PURE__ */ jsx(InjectedScript, { baseId: PIXEL_SCRIPT_ID, descriptors });
+}
+export {
+  ReploPixelScript
+};
+//# sourceMappingURL=replo-pixel-script.js.map

package/analytics/replo-pixel-script.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../analytics/replo-pixel-script.tsx"],
+  "sourcesContent": ["\"use client\";\n\nimport type { ScriptTagDescriptor } from \"schemas/generated/consent\";\n\nimport { isConsentAllowed, useConsent } from \"../consent/consent-store\";\nimport { InjectedScript } from \"../consent/replo-scripts\";\n\n// Stable injection id so re-renders and React Strict Mode double-invokes never\n// inject the pixel twice (the loader itself also guards via `__reploPixelLoaded`).\nconst PIXEL_SCRIPT_ID = \"replo:first-party-pixel\";\n\n/**\n * Consent-gated injector for Replo's first-party analytics pixel. The loaded\n * script sets `window.ReploPixel`, which the always-on `ReploSink` forwards\n * events into, so gating it on `analytics` consent keeps the first-party sink\n * consent-correct without the pixel loading unconditionally in `<head>` the way\n * the legacy scaffold does. `analytics` consent here matches the\n * `firstPartyAllowed` gate that controls whether `ReploSink` is created at all.\n */\nexport function ReploPixelScript({\n  pixelUrl,\n  apiUrl,\n  projectId,\n}: {\n  pixelUrl: string;\n  apiUrl: string;\n  projectId: string;\n}) {\n  const consent = useConsent();\n  if (!isConsentAllowed({ state: consent, requiredConsent: [\"analytics\"] })) {\n    return null;\n  }\n\n  const descriptors: ScriptTagDescriptor[] = [\n    {\n      kind: \"external\",\n      src: `${pixelUrl}/latest.js`,\n      attributes: {\n        \"data-api-url\": apiUrl,\n        \"data-project-id\": projectId,\n      },\n    },\n  ];\n\n  return <InjectedScript baseId={PIXEL_SCRIPT_ID} descriptors={descriptors} />;\n}\n"],
+  "mappings": ";AA4CS;AAxCT,SAAS,kBAAkB,kBAAkB;AAC7C,SAAS,sBAAsB;AAI/B,MAAM,kBAAkB;AAUjB,SAAS,iBAAiB;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AACF,GAIG;AACD,QAAM,UAAU,WAAW;AAC3B,MAAI,CAAC,iBAAiB,EAAE,OAAO,SAAS,iBAAiB,CAAC,WAAW,EAAE,CAAC,GAAG;AACzE,WAAO;AAAA,EACT;AAEA,QAAM,cAAqC;AAAA,IACzC;AAAA,MACE,MAAM;AAAA,MACN,KAAK,GAAG,QAAQ;AAAA,MAChB,YAAY;AAAA,QACV,gBAAgB;AAAA,QAChB,mBAAmB;AAAA,MACrB;AAAA,IACF;AAAA,EACF;AAEA,SAAO,oBAAC,kBAAe,QAAQ,iBAAiB,aAA0B;AAC5E;",
+  "names": []
+}

package/analytics/sinks/ga4-sink.d.ts

@@ -0,0 +1,15 @@
+import type { AnalyticsSink, DataPayload, PurchasePayload } from "../analytics-sink";
+import type { PageMetadata } from "../utils/navigation-tracker";
+export declare class GA4Sink implements AnalyticsSink {
+    private send;
+    constructor();
+    pageView(metadata?: PageMetadata): Promise<void>;
+    purchase({ amount, currency, data }: PurchasePayload): Promise<void>;
+    click({ data }: DataPayload): Promise<void>;
+    productViewed({ data }: DataPayload): Promise<void>;
+    addToCart({ data }: DataPayload): Promise<void>;
+    removeFromCart({ data }: DataPayload): Promise<void>;
+    viewCart({ data }: DataPayload): Promise<void>;
+    startCheckout({ data }: DataPayload): Promise<void>;
+    viewCollection({ data }: DataPayload): Promise<void>;
+}

package/analytics/sinks/ga4-sink.js

@@ -0,0 +1,60 @@
+import { createEventQueue } from "../utils/analytics-utils";
+class GA4Sink {
+  // oxlint-disable-next-line typescript/no-explicit-any -- legacy any, may or may not be needed
+  send;
+  constructor() {
+    this.send = createEventQueue(
+      // Legacy cast - may or may not be necessary
+      // oxlint-disable-next-line replo/no-as-cast, typescript/no-explicit-any -- legacy any/cast, may or may not be needed
+      () => typeof window !== "undefined" && Boolean(window.gtag),
+      (event, params) => {
+        const gtag = window.gtag;
+        gtag("event", event, params);
+      },
+      "GA4"
+    );
+  }
+  async pageView(metadata) {
+    const params = metadata ? {
+      page_title: metadata.title,
+      page_location: metadata.url
+    } : {};
+    this.send("page_view", params);
+  }
+  async purchase({ amount, currency, data }) {
+    this.send("purchase", { value: amount, currency, ...data });
+  }
+  async click({ data }) {
+    this.send("select_content", data);
+  }
+  async productViewed({ data }) {
+    this.send("view_item", {
+      value: data.price,
+      currency: data.currency,
+      ...data
+    });
+  }
+  async addToCart({ data }) {
+    this.send("add_to_cart", {
+      value: data.price,
+      currency: data.currency,
+      ...data
+    });
+  }
+  async removeFromCart({ data }) {
+    this.send("remove_from_cart", data);
+  }
+  async viewCart({ data }) {
+    this.send("view_cart", data);
+  }
+  async startCheckout({ data }) {
+    this.send("begin_checkout", data);
+  }
+  async viewCollection({ data }) {
+    this.send("view_item_list", data);
+  }
+}
+export {
+  GA4Sink
+};
+//# sourceMappingURL=ga4-sink.js.map

package/analytics/sinks/ga4-sink.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../analytics/sinks/ga4-sink.ts"],
+  "sourcesContent": ["import type {\n  AnalyticsSink,\n  DataPayload,\n  PurchasePayload,\n} from \"../analytics-sink\";\nimport type { PageMetadata } from \"../utils/navigation-tracker\";\n\nimport { createEventQueue } from \"../utils/analytics-utils\";\n\nexport class GA4Sink implements AnalyticsSink {\n  // oxlint-disable-next-line typescript/no-explicit-any -- legacy any, may or may not be needed\n  private send: (event: string, params?: Record<string, any>) => void;\n\n  constructor() {\n    this.send = createEventQueue(\n      // Legacy cast - may or may not be necessary\n      // oxlint-disable-next-line replo/no-as-cast, typescript/no-explicit-any -- legacy any/cast, may or may not be needed\n      () => typeof window !== \"undefined\" && Boolean((window as any).gtag),\n      (event, params) => {\n        // Legacy cast - may or may not be necessary\n        // oxlint-disable-next-line replo/no-as-cast, typescript/no-explicit-any -- legacy any/cast, may or may not be needed\n        const gtag = (window as any).gtag;\n        gtag(\"event\", event, params);\n      },\n      \"GA4\",\n    );\n  }\n\n  async pageView(metadata?: PageMetadata) {\n    const params = metadata\n      ? {\n          page_title: metadata.title,\n          page_location: metadata.url,\n        }\n      : {};\n    this.send(\"page_view\", params);\n  }\n\n  async purchase({ amount, currency, data }: PurchasePayload) {\n    this.send(\"purchase\", { value: amount, currency, ...data });\n  }\n\n  async click({ data }: DataPayload) {\n    this.send(\"select_content\", data);\n  }\n\n  async productViewed({ data }: DataPayload) {\n    this.send(\"view_item\", {\n      value: data.price,\n      currency: data.currency,\n      ...data,\n    });\n  }\n\n  async addToCart({ data }: DataPayload) {\n    this.send(\"add_to_cart\", {\n      value: data.price,\n      currency: data.currency,\n      ...data,\n    });\n  }\n\n  async removeFromCart({ data }: DataPayload) {\n    this.send(\"remove_from_cart\", data);\n  }\n\n  async viewCart({ data }: DataPayload) {\n    this.send(\"view_cart\", data);\n  }\n\n  async startCheckout({ data }: DataPayload) {\n    this.send(\"begin_checkout\", data);\n  }\n\n  async viewCollection({ data }: DataPayload) {\n    this.send(\"view_item_list\", data);\n  }\n}\n"],
+  "mappings": "AAOA,SAAS,wBAAwB;AAE1B,MAAM,QAAiC;AAAA;AAAA,EAEpC;AAAA,EAER,cAAc;AACZ,SAAK,OAAO;AAAA;AAAA;AAAA,MAGV,MAAM,OAAO,WAAW,eAAe,QAAS,OAAe,IAAI;AAAA,MACnE,CAAC,OAAO,WAAW;AAGjB,cAAM,OAAQ,OAAe;AAC7B,aAAK,SAAS,OAAO,MAAM;AAAA,MAC7B;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,SAAS,UAAyB;AACtC,UAAM,SAAS,WACX;AAAA,MACE,YAAY,SAAS;AAAA,MACrB,eAAe,SAAS;AAAA,IAC1B,IACA,CAAC;AACL,SAAK,KAAK,aAAa,MAAM;AAAA,EAC/B;AAAA,EAEA,MAAM,SAAS,EAAE,QAAQ,UAAU,KAAK,GAAoB;AAC1D,SAAK,KAAK,YAAY,EAAE,OAAO,QAAQ,UAAU,GAAG,KAAK,CAAC;AAAA,EAC5D;AAAA,EAEA,MAAM,MAAM,EAAE,KAAK,GAAgB;AACjC,SAAK,KAAK,kBAAkB,IAAI;AAAA,EAClC;AAAA,EAEA,MAAM,cAAc,EAAE,KAAK,GAAgB;AACzC,SAAK,KAAK,aAAa;AAAA,MACrB,OAAO,KAAK;AAAA,MACZ,UAAU,KAAK;AAAA,MACf,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,UAAU,EAAE,KAAK,GAAgB;AACrC,SAAK,KAAK,eAAe;AAAA,MACvB,OAAO,KAAK;AAAA,MACZ,UAAU,KAAK;AAAA,MACf,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,eAAe,EAAE,KAAK,GAAgB;AAC1C,SAAK,KAAK,oBAAoB,IAAI;AAAA,EACpC;AAAA,EAEA,MAAM,SAAS,EAAE,KAAK,GAAgB;AACpC,SAAK,KAAK,aAAa,IAAI;AAAA,EAC7B;AAAA,EAEA,MAAM,cAAc,EAAE,KAAK,GAAgB;AACzC,SAAK,KAAK,kBAAkB,IAAI;AAAA,EAClC;AAAA,EAEA,MAAM,eAAe,EAAE,KAAK,GAAgB;AAC1C,SAAK,KAAK,kBAAkB,IAAI;AAAA,EAClC;AACF;",
+  "names": []
+}

package/analytics/sinks/meta-sink.d.ts

@@ -0,0 +1,14 @@
+import type { AnalyticsSink, DataPayload, PurchasePayload } from "../analytics-sink";
+export declare class MetaSink implements AnalyticsSink {
+    private track;
+    constructor();
+    pageView(): Promise<void>;
+    purchase({ amount, currency, data }: PurchasePayload): Promise<void>;
+    click(): Promise<void>;
+    productViewed({ data }: DataPayload): Promise<void>;
+    addToCart({ data }: DataPayload): Promise<void>;
+    removeFromCart(): Promise<void>;
+    viewCart(): Promise<void>;
+    startCheckout({ data }: DataPayload): Promise<void>;
+    viewCollection(): Promise<void>;
+}

package/analytics/sinks/meta-sink.js

@@ -0,0 +1,56 @@
+import { createEventQueue } from "../utils/analytics-utils";
+class MetaSink {
+  // oxlint-disable-next-line typescript/no-explicit-any -- legacy any, may or may not be needed
+  track;
+  constructor() {
+    this.track = createEventQueue(
+      // Legacy cast - may or may not be necessary
+      // oxlint-disable-next-line replo/no-as-cast, typescript/no-explicit-any -- legacy any/cast, may or may not be needed
+      () => typeof window !== "undefined" && Boolean(window.fbq),
+      (event, params) => {
+        const fbq = window.fbq;
+        fbq("track", event, params);
+      },
+      "Meta"
+    );
+  }
+  async pageView() {
+    this.track("PageView");
+  }
+  async purchase({ amount, currency, data }) {
+    this.track("Purchase", { value: amount, currency, ...data });
+  }
+  async click() {
+  }
+  async productViewed({ data }) {
+    this.track("ViewContent", {
+      value: data.price,
+      currency: data.currency,
+      ...data
+    });
+  }
+  async addToCart({ data }) {
+    this.track("AddToCart", {
+      value: data.price,
+      currency: data.currency,
+      ...data
+    });
+  }
+  async removeFromCart() {
+  }
+  async viewCart() {
+  }
+  async startCheckout({ data }) {
+    this.track("InitiateCheckout", {
+      value: data.totalPrice?.amount,
+      currency: data.currencyCode,
+      ...data
+    });
+  }
+  async viewCollection() {
+  }
+}
+export {
+  MetaSink
+};
+//# sourceMappingURL=meta-sink.js.map