@replohq/sdk 2.0.0 → 2.1.0

package/analytics/get-analytics-sinks.js

@@ -8,6 +8,7 @@ import { NorthbeamSink } from "./sinks/northbeam-sink";
 import { PinterestSink } from "./sinks/pinterest-sink";
 import { RedditSink } from "./sinks/reddit-sink";
 import { ReploSink } from "./sinks/replo-sink";
+import { SegmentSink } from "./sinks/segment-sink";
 import { SnapchatSink } from "./sinks/snapchat-sink";
 import { TikTokSink } from "./sinks/tiktok-sink";
 import { WindowSink } from "./sinks/window-sink";
@@ -21,11 +22,13 @@ const PROVIDER_SINK_FACTORIES = {
   Pinterest: () => new PinterestSink(),
   Reddit: () => new RedditSink(),
   Northbeam: () => new NorthbeamSink(),
-  Converge: () => new ConvergeSink()
+  Converge: () => new ConvergeSink(),
+  Segment: () => new SegmentSink()
 };
 const SNIPPET_PROVIDER_SINK_FACTORIES = {
   [snippetScriptId("Elevar")]: () => new ElevarSink()
 };
+const SHOPIFY_FUNNEL_GATE_EXEMPT_PROVIDERS = /* @__PURE__ */ new Set(["Segment"]);
 function findSinkFactory(script) {
   if (script.type === "X") {
     return () => {
@@ -66,9 +69,8 @@ function getAnalyticsSinks({
       requiredConsent: script.requiredConsent
     })) {
       const sink = factory();
-      sinks.push(
-        shopifyOwnsCheckout ? gateShopifyOwnedFunnelEvents(sink) : sink
-      );
+      const gated = shopifyOwnsCheckout && !SHOPIFY_FUNNEL_GATE_EXEMPT_PROVIDERS.has(script.type);
+      sinks.push(gated ? gateShopifyOwnedFunnelEvents(sink) : sink);
       addedProviders.add(providerKey);
     }
   }

package/analytics/sinks/segment-event-mapper.d.ts

@@ -0,0 +1,86 @@
+import type { AnalyticsProductLine, CartLineData, CartViewedData, CheckoutStartedData, CollectionViewedData, PurchasePayload } from "../analytics-sink";
+export declare function mapSegmentProduct(line: AnalyticsProductLine, currency: string | undefined): {
+    name?: string | undefined;
+    variant?: string | undefined;
+    variant_id?: string | undefined;
+    sku?: string | undefined;
+    price?: number | undefined;
+    quantity?: number | undefined;
+    currency?: string | undefined;
+    product_id: string;
+};
+export declare function mapSegmentCartLine(line: CartLineData): {
+    name?: string | undefined;
+    variant?: string | undefined;
+    variant_id?: string | undefined;
+    sku?: string | undefined;
+    price?: number | undefined;
+    quantity?: number | undefined;
+    currency?: string | undefined;
+    product_id: string;
+};
+export declare function mapSegmentCartViewed(data: CartViewedData): {
+    currency?: string | undefined;
+    value: number;
+    products: {
+        name?: string | undefined;
+        variant?: string | undefined;
+        variant_id?: string | undefined;
+        sku?: string | undefined;
+        price?: number | undefined;
+        quantity?: number | undefined;
+        currency?: string | undefined;
+        product_id: string;
+    }[];
+};
+export declare function mapSegmentCheckoutStarted(data: CheckoutStartedData): {
+    currency?: string | undefined;
+    value: number;
+    total: number;
+    revenue: number;
+    products: {
+        name?: string | undefined;
+        variant?: string | undefined;
+        variant_id?: string | undefined;
+        sku?: string | undefined;
+        price?: number | undefined;
+        quantity?: number | undefined;
+        currency?: string | undefined;
+        product_id: string;
+    }[];
+};
+export declare function mapSegmentProductList(data: CollectionViewedData): {
+    category?: string | undefined;
+    list_id: string;
+    products: {
+        name?: string | undefined;
+        variant?: string | undefined;
+        variant_id?: string | undefined;
+        sku?: string | undefined;
+        price?: number | undefined;
+        quantity?: number | undefined;
+        currency?: string | undefined;
+        product_id: string;
+    }[];
+};
+export declare function mapSegmentOrder({ amount, currency, data }: PurchasePayload): {
+    tax?: number | undefined;
+    shipping?: number | undefined;
+    order_id?: string | undefined;
+    discount?: number | undefined;
+    coupon?: string | undefined;
+    value: number;
+    total: number;
+    revenue: number;
+    currency: string;
+    products: {
+        name?: string | undefined;
+        variant?: string | undefined;
+        variant_id?: string | undefined;
+        sku?: string | undefined;
+        price?: number | undefined;
+        quantity?: number | undefined;
+        currency?: string | undefined;
+        product_id: string;
+    }[];
+};

package/analytics/sinks/segment-event-mapper.js

@@ -0,0 +1,71 @@
+import { filterUndefined } from "../../_vendor/replo-utils/lib/object.mjs";
+import { legacyResourceId } from "../utils/analytics-products";
+function mapSegmentProduct(line, currency) {
+  return {
+    product_id: legacyResourceId(line.productId),
+    ...filterUndefined({
+      name: line.productTitle,
+      variant: line.variantTitle || void 0,
+      variant_id: line.variantId ? legacyResourceId(line.variantId) : void 0,
+      sku: line.variantSku || void 0,
+      price: line.price,
+      quantity: line.quantity,
+      currency: line.currency ?? currency
+    })
+  };
+}
+function mapProducts(lines, currency) {
+  return lines.map((line) => mapSegmentProduct(line, currency));
+}
+function mapSegmentCartLine(line) {
+  return mapSegmentProduct(line, void 0);
+}
+function mapSegmentCartViewed(data) {
+  return {
+    value: data.subtotal,
+    products: mapProducts(data.lineItems, data.currency),
+    ...filterUndefined({ currency: data.currency })
+  };
+}
+function mapSegmentCheckoutStarted(data) {
+  return {
+    value: data.total,
+    total: data.total,
+    revenue: data.subtotal,
+    products: mapProducts(data.lineItems, data.currency),
+    ...filterUndefined({ currency: data.currency })
+  };
+}
+function mapSegmentProductList(data) {
+  return {
+    list_id: legacyResourceId(data.collectionId),
+    products: mapProducts(data.products, data.currency),
+    ...filterUndefined({ category: data.collectionTitle })
+  };
+}
+function mapSegmentOrder({ amount, currency, data }) {
+  const tax = data.totalTax ?? 0;
+  const shipping = data.totalShipping ?? 0;
+  return {
+    value: amount,
+    total: amount,
+    revenue: Math.round((amount - tax - shipping) * 100) / 100,
+    currency,
+    products: mapProducts(data.lineItems ?? [], currency),
+    ...filterUndefined({
+      tax: data.totalTax,
+      shipping: data.totalShipping,
+      order_id: data.orderId,
+      discount: data.totalDiscount,
+      coupon: data.discountCodes?.join(",")
+    })
+  };
+}
+export {
+  mapSegmentCartLine,
+  mapSegmentCartViewed,
+  mapSegmentCheckoutStarted,
+  mapSegmentOrder,
+  mapSegmentProduct,
+  mapSegmentProductList
+};

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

@@ -0,0 +1,23 @@
+import type { AnalyticsSink, CartLineEventPayload, CartViewedPayload, CheckoutStartedPayload, ClickPayload, CollectionViewedPayload, CustomEventPayload, LegacyCheckoutStartedPayload, ProductViewedPayload, PurchasePayload } from "../analytics-sink";
+import type { PageMetadata } from "../utils/navigation-tracker";
+/**
+ * Sends Replo's analytics events to Segment as V2 E-Commerce spec `track`
+ * events, so a tracking plan written against the spec ("Product Added",
+ * "Order Completed") is met without page-level code. The consent-gated
+ * snippet sends the landing pageview; this sink adds a `page` call for each
+ * in-site navigation.
+ */
+export declare class SegmentSink implements AnalyticsSink {
+    private send;
+    private track;
+    customEvent({ event, properties }: CustomEventPayload): Promise<void>;
+    pageView(metadata?: PageMetadata): Promise<void>;
+    purchase(payload: PurchasePayload): Promise<void>;
+    click({ data }: ClickPayload): Promise<void>;
+    productViewed({ data }: ProductViewedPayload): Promise<void>;
+    addToCart({ data }: CartLineEventPayload): Promise<void>;
+    removeFromCart({ data }: CartLineEventPayload): Promise<void>;
+    viewCart({ data }: CartViewedPayload): Promise<void>;
+    startCheckout(payload: CheckoutStartedPayload | LegacyCheckoutStartedPayload): Promise<void>;
+    viewCollection({ data }: CollectionViewedPayload): Promise<void>;
+}

package/analytics/sinks/segment-sink.js

@@ -0,0 +1,84 @@
+import { toCheckoutStartedData } from "../legacy-checkout";
+import { createAnalyticsQueue } from "../utils/analytics-utils";
+import {
+  mapSegmentCartLine,
+  mapSegmentCartViewed,
+  mapSegmentCheckoutStarted,
+  mapSegmentOrder,
+  mapSegmentProduct,
+  mapSegmentProductList
+} from "./segment-event-mapper";
+function findSegment() {
+  if (typeof window === "undefined") {
+    return null;
+  }
+  return window.analytics ?? null;
+}
+class SegmentSink {
+  send = createAnalyticsQueue({
+    isReady: () => Boolean(findSegment()),
+    send: (call) => {
+      const analytics = findSegment();
+      if (call.method === "page") {
+        analytics?.page(call.properties);
+      } else {
+        analytics?.track(call.event, call.properties);
+      }
+    },
+    queueName: "Segment"
+  });
+  track(event, properties) {
+    this.send({ method: "track", event, properties });
+  }
+  async customEvent({ event, properties }) {
+    this.track(event, properties ?? {});
+  }
+  async pageView(metadata) {
+    if (metadata?.navigationType === "initial") {
+      return;
+    }
+    if (!metadata) {
+      this.send({ method: "page", properties: {} });
+      return;
+    }
+    this.send({
+      method: "page",
+      properties: {
+        url: metadata.url,
+        path: new URL(metadata.url, window.location.origin).pathname,
+        title: metadata.title,
+        referrer: metadata.referrer
+      }
+    });
+  }
+  async purchase(payload) {
+    this.track("Order Completed", mapSegmentOrder(payload));
+  }
+  async click({ data }) {
+    this.track("Element Clicked", data);
+  }
+  async productViewed({ data }) {
+    this.track("Product Viewed", mapSegmentProduct(data, data.currency));
+  }
+  async addToCart({ data }) {
+    this.track("Product Added", mapSegmentCartLine(data));
+  }
+  async removeFromCart({ data }) {
+    this.track("Product Removed", mapSegmentCartLine(data));
+  }
+  async viewCart({ data }) {
+    this.track("Cart Viewed", mapSegmentCartViewed(data));
+  }
+  async startCheckout(payload) {
+    this.track(
+      "Checkout Started",
+      mapSegmentCheckoutStarted(toCheckoutStartedData(payload.data))
+    );
+  }
+  async viewCollection({ data }) {
+    this.track("Product List Viewed", mapSegmentProductList(data));
+  }
+}
+export {
+  SegmentSink
+};

package/lib/buildMetadata.js

@@ -1,7 +1,7 @@
 export const BUILD_METADATA = {
   "packageName": "@replohq/sdk",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "branch": "HEAD",
-  "commit": "17bbe81f0395ba343461c4ec1df4662e1ede00bd",
-  "builtAt": "2026-10-19T23:10:20.892Z"
+  "commit": "fd5e2e68393795f73c76f04e5fbccad127d8ee31",
+  "builtAt": "2026-10-20T14:39:29.462Z"
 };

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@replohq/sdk",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "reploBuild": {
     "packageName": "@replohq/sdk",
-    "version": "2.0.0",
+    "version": "2.1.0",
     "branch": "HEAD",
-    "commit": "17bbe81f0395ba343461c4ec1df4662e1ede00bd",
-    "builtAt": "2026-10-19T23:10:20.892Z"
+    "commit": "fd5e2e68393795f73c76f04e5fbccad127d8ee31",
+    "builtAt": "2026-10-20T14:39:29.462Z"
   },
   "description": "Replo SDK — cart, analytics, and data loaders for agent-built Next.js sites.",
   "license": "SEE LICENSE IN LICENSE",