@replohq/sdk 1.22.0 → 2.0.0

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

@@ -1,153 +1,59 @@
 import { filterUndefined } from "../../_vendor/replo-utils/lib/object.mjs";
-import * as z from "zod";
-const analyticsRecordSchema = z.record(z.string(), z.unknown());
-const nonEmptyStringSchema = z.union([
-  z.string().min(1),
-  z.number().finite().transform(String)
-]);
-const finiteNumberSchema = z.union([
-  z.number().finite(),
-  z.string().trim().min(1).transform(Number).pipe(z.number().finite())
-]);
-const couponSchema = z.union([z.string(), z.array(z.string())]);
-function parseRecord(value) {
-  const result = analyticsRecordSchema.safeParse(value);
-  return result.success ? result.data : null;
-}
-function firstValue(record, keys) {
-  for (const key of keys) {
-    const value = record[key];
-    if (value !== null && value !== void 0) {
-      return value;
-    }
-  }
-  return void 0;
-}
-function parseString(value) {
-  const result = nonEmptyStringSchema.safeParse(value);
-  return result.success ? result.data : void 0;
-}
-function numberValue(value) {
-  const result = finiteNumberSchema.safeParse(value);
-  return result.success ? result.data : void 0;
-}
-function stringFrom(record, keys) {
-  return parseString(firstValue(record, keys));
-}
-function numberFrom(record, keys) {
-  return numberValue(firstValue(record, keys));
-}
-function moneyFrom(value) {
-  const record = parseRecord(value);
-  if (!record) {
+function mapProduct(line, currency = line.currency) {
+  if (!line.productTitle || line.price === void 0 || !currency) {
     return null;
   }
   return {
-    amount: numberFrom(record, ["amount"]),
-    currency: stringFrom(record, ["currencyCode", "currency"])
-  };
-}
-function optionalProductProperties({
-  source,
-  variant,
-  product
-}) {
-  return {
-    variant_id: stringFrom(source, ["variant_id", "variantId"]) ?? stringFrom(variant, ["id"]),
-    sku: stringFrom(source, ["sku", "variantSku"]) ?? stringFrom(variant, ["sku"]),
-    variant_name: stringFrom(source, ["variant_name", "variantTitle"]) ?? stringFrom(variant, ["title"]),
-    vendor: stringFrom(source, ["vendor", "productVendor"]) ?? stringFrom(product, ["vendor"]),
-    url: stringFrom(source, ["url", "productUrl"]) ?? stringFrom(product, ["url"]),
-    image_url: stringFrom(source, ["image_url", "imageUrl", "productImageUrl"]) ?? stringFrom(product, ["imageUrl", "image_url"])
-  };
-}
-function mapProduct(value, defaults = {}) {
-  const source = parseRecord(value);
-  if (!source) {
-    return null;
-  }
-  const variant = parseRecord(source.variant) ?? {};
-  const product = parseRecord(variant.product) ?? parseRecord(source.product) ?? {};
-  const variantPrice = moneyFrom(variant.price);
-  const sourcePrice = moneyFrom(source.price);
-  const productId = stringFrom(source, ["product_id", "productId"]) ?? stringFrom(product, ["id"]);
-  const name = stringFrom(source, ["name", "productTitle", "title"]) ?? stringFrom(product, ["title", "name"]);
-  const price = numberFrom(source, ["price"]) ?? sourcePrice?.amount ?? variantPrice?.amount;
-  const currency = stringFrom(source, ["currency", "currencyCode"]) ?? sourcePrice?.currency ?? variantPrice?.currency ?? defaults.currency;
-  if (!productId || !name || price === void 0 || !currency) {
-    return null;
-  }
-  const quantity = numberFrom(source, ["quantity"]) ?? defaults.quantity;
-  const mapped = {
-    product_id: productId,
-    name,
-    price,
+    product_id: line.productId,
+    name: line.productTitle,
+    price: line.price,
     currency,
-    ...filterUndefined(optionalProductProperties({ source, variant, product })),
-    ...quantity === void 0 ? {} : { quantity }
+    ...filterUndefined({
+      variant_id: line.variantId || void 0,
+      sku: line.variantSku || void 0,
+      variant_name: line.variantTitle || void 0
+    })
   };
-  return mapped;
-}
-function listFrom(record, keys) {
-  const value = firstValue(record, keys);
-  return Array.isArray(value) ? value : [];
 }
-function couponFrom(record) {
-  const result = couponSchema.safeParse(
-    firstValue(record, ["coupon", "discountCode"])
-  );
-  return result.success ? result.data : void 0;
+function mapCartItems(lines, currency) {
+  const items = lines.flatMap((line) => {
+    const product = mapProduct(line, line.currency ?? currency);
+    return product ? [{ ...product, quantity: line.quantity }] : [];
+  });
+  return items.length > 0 ? items : void 0;
 }
 function mapConvergeProduct(data) {
-  const product = mapProduct(data);
-  if (!product) {
-    return null;
-  }
-  const { quantity: _quantity, ...properties } = product;
-  return properties;
+  return mapProduct(data);
 }
 function mapConvergeCartItem(data) {
-  const product = mapProduct(data, { quantity: 1 });
-  if (!product || product.quantity === void 0) {
-    return null;
-  }
-  return { ...product, quantity: product.quantity };
+  const product = mapProduct(data);
+  return product ? { ...product, quantity: data.quantity } : null;
 }
 function mapConvergeCollection(data) {
-  const id = stringFrom(data, ["id", "collectionId"]);
-  const name = stringFrom(data, ["name", "collectionTitle"]);
-  if (!id || !name) {
+  if (!data.collectionTitle) {
     return null;
   }
-  const items = listFrom(data, ["items", "products"]).map((item) => mapProduct(item)).filter((item) => item !== null).map(({ quantity: _quantity, ...item }) => item);
+  const items = data.products.flatMap((line) => mapProduct(line) ?? []);
   return {
-    id,
-    name,
-    ...filterUndefined({
-      description: stringFrom(data, ["description", "collectionDescription"]),
-      items: items.length > 0 ? items : void 0
-    })
+    id: data.collectionId,
+    name: data.collectionTitle,
+    ...items.length > 0 ? { items } : {}
   };
 }
-function mapConvergeCart(data) {
-  const totalPriceMoney = moneyFrom(firstValue(data, ["totalPrice"]));
-  const subtotalMoney = moneyFrom(firstValue(data, ["subtotalPrice"]));
-  const currency = stringFrom(data, ["currency", "currencyCode"]) ?? totalPriceMoney?.currency ?? subtotalMoney?.currency;
-  const totalPrice = numberFrom(data, ["total_price", "totalAmount", "subtotal"]) ?? totalPriceMoney?.amount ?? subtotalMoney?.amount;
-  if (totalPrice === void 0 || !currency) {
+function mapConvergeCart({
+  totalPrice,
+  currency,
+  lineItems
+}) {
+  if (!currency) {
     return null;
   }
-  const items = listFrom(data, ["items", "lineItems"]).map((item) => mapProduct(item, { currency, quantity: 1 })).filter((item) => item?.quantity !== void 0);
   return {
     total_price: totalPrice,
-    total_tax: numberFrom(data, ["total_tax", "totalTax"]) ?? 0,
-    total_shipping: numberFrom(data, ["total_shipping", "totalShipping"]) ?? 0,
+    total_tax: 0,
+    total_shipping: 0,
     currency,
-    ...filterUndefined({
-      total_discount: numberFrom(data, ["total_discount", "totalDiscount"]),
-      coupon: couponFrom(data),
-      items: items.length > 0 ? items : void 0
-    })
+    ...filterUndefined({ items: mapCartItems(lineItems, currency) })
   };
 }
 function mapConvergeOrder({
@@ -155,16 +61,27 @@ function mapConvergeOrder({
   currency,
   data
 }) {
-  const id = stringFrom(data, ["id", "order_id", "orderId"]);
-  if (!id) {
+  if (!data.orderId) {
     return null;
   }
   const cart = mapConvergeCart({
-    ...data,
-    total_price: amount,
-    currency
+    totalPrice: amount,
+    currency,
+    lineItems: data.lineItems ?? []
   });
-  return cart ? { id, ...cart } : null;
+  if (!cart) {
+    return null;
+  }
+  return {
+    id: data.orderId,
+    ...cart,
+    total_tax: data.totalTax ?? 0,
+    total_shipping: data.totalShipping ?? 0,
+    ...filterUndefined({
+      total_discount: data.totalDiscount,
+      coupon: data.discountCodes
+    })
+  };
 }
 export {
   mapConvergeCart,

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

@@ -1,4 +1,4 @@
-import type { AnalyticsSink, DataPayload, PurchasePayload } from "../analytics-sink";
+import type { AnalyticsSink, CartLineEventPayload, CartViewedPayload, CheckoutStartedPayload, CollectionViewedPayload, LegacyCheckoutStartedPayload, ProductViewedPayload, PurchasePayload } from "../analytics-sink";
 import type { PageMetadata } from "../utils/navigation-tracker";
 type ConvergeCall = {
     method: "track";
@@ -23,14 +23,15 @@ declare global {
 export declare class ConvergeSink implements AnalyticsSink {
     private send;
     private trackIfValid;
+    customEvent(): Promise<void>;
     pageView(metadata?: PageMetadata): Promise<void>;
     purchase(payload: PurchasePayload): Promise<void>;
     click(): 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>;
+    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>;
 }
 export {};

package/analytics/sinks/converge-sink.js

@@ -1,3 +1,4 @@
+import { toCheckoutStartedData } from "../legacy-checkout";
 import { createAnalyticsQueue } from "../utils/analytics-utils";
 import {
   mapConvergeCart,
@@ -27,6 +28,8 @@ class ConvergeSink {
     }
     this.send({ method: "track", eventName, properties });
   }
+  async customEvent() {
+  }
   async pageView(metadata) {
     if (metadata?.navigationType === "initial") {
       return;
@@ -58,10 +61,25 @@ class ConvergeSink {
     this.trackIfValid("Removed From Cart", mapConvergeCartItem(data));
   }
   async viewCart({ data }) {
-    this.trackIfValid("Viewed Cart", mapConvergeCart(data));
+    this.trackIfValid(
+      "Viewed Cart",
+      mapConvergeCart({
+        totalPrice: data.subtotal,
+        currency: data.currency,
+        lineItems: data.lineItems
+      })
+    );
   }
-  async startCheckout({ data }) {
-    this.trackIfValid("Started Checkout", mapConvergeCart(data));
+  async startCheckout(payload) {
+    const data = toCheckoutStartedData(payload.data);
+    this.trackIfValid(
+      "Started Checkout",
+      mapConvergeCart({
+        totalPrice: data.total,
+        currency: data.currency,
+        lineItems: data.lineItems
+      })
+    );
   }
   async viewCollection({ data }) {
     this.trackIfValid("Viewed Collection", mapConvergeCollection(data));

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

@@ -1,4 +1,4 @@
-import type { AnalyticsSink, DataPayload } from "../analytics-sink";
+import type { AnalyticsSink, CartLineEventPayload, CartViewedPayload, CheckoutStartedPayload, CollectionViewedPayload, LegacyCheckoutStartedPayload, ProductViewedPayload } from "../analytics-sink";
 import type { PageMetadata } from "../utils/navigation-tracker";
 type ElevarUserProperties = {
     visitor_type: "guest" | "logged_in";
@@ -25,14 +25,16 @@ export declare class ElevarSink implements AnalyticsSink {
     constructor();
     private pushEcommerceEvent;
     private pushProductEvent;
+    customEvent(): Promise<void>;
     pageView(metadata?: PageMetadata): Promise<void>;
     purchase(): Promise<void>;
     click(): Promise<void>;
-    productViewed(payload: DataPayload): Promise<void>;
-    addToCart(payload: DataPayload): Promise<void>;
-    removeFromCart(payload: DataPayload): Promise<void>;
-    viewCart({ data }: DataPayload): Promise<void>;
-    startCheckout({ data }: DataPayload): Promise<void>;
-    viewCollection({ data }: DataPayload): Promise<void>;
+    productViewed({ data }: ProductViewedPayload): Promise<void>;
+    addToCart({ data }: CartLineEventPayload): Promise<void>;
+    removeFromCart({ data }: CartLineEventPayload): Promise<void>;
+    private cartProducts;
+    viewCart({ data }: CartViewedPayload): Promise<void>;
+    startCheckout(payload: CheckoutStartedPayload | LegacyCheckoutStartedPayload): Promise<void>;
+    viewCollection({ data }: CollectionViewedPayload): Promise<void>;
 }
 export {};

package/analytics/sinks/elevar-sink.js

@@ -1,83 +1,15 @@
-import * as z from "zod";
+import { toCheckoutStartedData } from "../legacy-checkout";
 import { legacyResourceId } from "../utils/analytics-products";
 const GUEST_USER_PROPERTIES = { visitor_type: "guest" };
 const FALLBACK_CURRENCY_CODE = "USD";
-const nonEmptyStringSchema = z.union([z.string().min(1), z.number().finite().transform(String)]).optional().catch(void 0);
-const finiteNumberSchema = z.union([
-  z.number().finite(),
-  z.string().trim().min(1).transform(Number).pipe(z.number().finite())
-]).optional().catch(void 0);
-const analyticsProductSchema = z.object({
-  productId: nonEmptyStringSchema,
-  productTitle: nonEmptyStringSchema,
-  variantId: nonEmptyStringSchema,
-  variantTitle: nonEmptyStringSchema,
-  variantSku: nonEmptyStringSchema,
-  price: finiteNumberSchema,
-  currency: nonEmptyStringSchema,
-  quantity: finiteNumberSchema
-});
-const checkoutLineSchema = z.object({
-  quantity: finiteNumberSchema,
-  merchandise: z.object({
-    id: nonEmptyStringSchema,
-    title: nonEmptyStringSchema,
-    sku: nonEmptyStringSchema,
-    price: z.object({
-      amount: finiteNumberSchema,
-      currencyCode: nonEmptyStringSchema
-    }).optional(),
-    product: z.object({ id: nonEmptyStringSchema, title: nonEmptyStringSchema }).optional()
-  }).optional()
-});
-const productListSchema = z.array(z.unknown()).optional().catch(void 0);
-const cartPayloadSchema = z.object({
-  currency: nonEmptyStringSchema,
-  currencyCode: nonEmptyStringSchema,
-  subtotal: finiteNumberSchema,
-  totalPrice: z.object({ amount: finiteNumberSchema }).optional(),
-  lineItems: productListSchema
-});
-const collectionPayloadSchema = z.object({
-  currency: nonEmptyStringSchema,
-  currencyCode: nonEmptyStringSchema,
-  products: productListSchema
-});
 function formatMoney(amount) {
   return amount.toFixed(2);
 }
-function parseCheckoutLine(line) {
-  const parsed = checkoutLineSchema.safeParse(line);
-  if (!parsed.success || !parsed.data.merchandise) {
-    return null;
-  }
-  const { merchandise, quantity } = parsed.data;
-  return {
-    productId: merchandise.product?.id,
-    productTitle: merchandise.product?.title,
-    variantId: merchandise.id,
-    variantTitle: merchandise.title,
-    variantSku: merchandise.sku,
-    price: merchandise.price?.amount,
-    currency: merchandise.price?.currencyCode,
-    quantity
-  };
-}
-function parseAnalyticsProduct(value) {
-  const parsed = analyticsProductSchema.safeParse(value);
-  if (!parsed.success) {
-    return null;
-  }
-  return parsed.data.productId ? parsed.data : parseCheckoutLine(value);
-}
 function toElevarProduct(product, options) {
   const productId = product.productId;
-  if (!productId) {
-    return null;
-  }
-  const variantId = product.variantId ?? productId;
+  const variantId = product.variantId || productId;
   return {
-    id: product.variantSku ?? legacyResourceId(variantId),
+    id: product.variantSku || legacyResourceId(variantId),
     name: product.productTitle ?? "",
     brand: "",
     category: "",
@@ -93,12 +25,13 @@ function toElevarProduct(product, options) {
   };
 }
 function toElevarProducts(products, options) {
-  const parsedProducts = products.map(parseAnalyticsProduct).filter((product) => product !== null);
-  const currencyCode = options.currency ?? parsedProducts.find((product) => product.currency)?.currency ?? FALLBACK_CURRENCY_CODE;
-  const elevarProducts = parsedProducts.map((product, index) => {
-    return toElevarProduct(product, { ...options, position: index + 1 });
-  }).filter((product) => product !== null);
-  return { products: elevarProducts, currencyCode };
+  const currencyCode = options.currency ?? products.find((product) => product.currency)?.currency ?? FALLBACK_CURRENCY_CODE;
+  return {
+    products: products.map((product, index) => {
+      return toElevarProduct(product, { ...options, position: index + 1 });
+    }),
+    currencyCode
+  };
 }
 function pushToElevarDataLayer(event) {
   if (typeof window === "undefined") {
@@ -139,16 +72,11 @@ class ElevarSink {
       ecommerce
     });
   }
-  pushProductEvent(event, action, { data }, options) {
-    const product = parseAnalyticsProduct(data);
-    const elevarProduct = product && toElevarProduct(product, {
+  pushProductEvent(event, action, product, options) {
+    const elevarProduct = toElevarProduct(product, {
       list: "",
       withQuantity: options.withQuantity
     });
-    if (!elevarProduct) {
-      console.warn(`[analytics] skipped Elevar ${event}: no product id`);
-      return;
-    }
     if (options.withUrl) {
       elevarProduct.url = window.location.href;
     }
@@ -160,6 +88,8 @@ class ElevarSink {
       }
     });
   }
+  async customEvent() {
+  }
   async pageView(metadata) {
     if (typeof window === "undefined") {
       return;
@@ -173,35 +103,31 @@ class ElevarSink {
   }
   async click() {
   }
-  async productViewed(payload) {
-    this.pushProductEvent("dl_view_item", "detail", payload, {
+  async productViewed({ data }) {
+    this.pushProductEvent("dl_view_item", "detail", data, {
       withQuantity: false
     });
   }
-  async addToCart(payload) {
-    this.pushProductEvent("dl_add_to_cart", "add", payload, {
+  async addToCart({ data }) {
+    this.pushProductEvent("dl_add_to_cart", "add", data, {
       withQuantity: true,
       withUrl: true
     });
   }
-  async removeFromCart(payload) {
-    this.pushProductEvent("dl_remove_from_cart", "remove", payload, {
+  async removeFromCart({ data }) {
+    this.pushProductEvent("dl_remove_from_cart", "remove", data, {
       withQuantity: true
     });
   }
+  cartProducts(cart) {
+    return toElevarProducts(cart.lineItems, {
+      list: "",
+      withQuantity: true,
+      currency: cart.currency
+    });
+  }
   async viewCart({ data }) {
-    const cart = cartPayloadSchema.safeParse(data);
-    if (!cart.success) {
-      return;
-    }
-    const { products, currencyCode } = toElevarProducts(
-      cart.data.lineItems ?? [],
-      {
-        list: "",
-        withQuantity: true,
-        currency: cart.data.currency ?? cart.data.currencyCode
-      }
-    );
+    const { products, currencyCode } = this.cartProducts(data);
     this.pushEcommerceEvent(
       "dl_view_cart",
       {
@@ -209,22 +135,12 @@ class ElevarSink {
         actionField: { list: "Shopping Cart" },
         impressions: products
       },
-      formatMoney(cart.data.subtotal ?? cart.data.totalPrice?.amount ?? 0)
+      formatMoney(data.subtotal)
     );
   }
-  async startCheckout({ data }) {
-    const cart = cartPayloadSchema.safeParse(data);
-    if (!cart.success) {
-      return;
-    }
-    const { products, currencyCode } = toElevarProducts(
-      cart.data.lineItems ?? [],
-      {
-        list: "",
-        withQuantity: true,
-        currency: cart.data.currencyCode ?? cart.data.currency
-      }
-    );
+  async startCheckout(payload) {
+    const data = toCheckoutStartedData(payload.data);
+    const { products, currencyCode } = this.cartProducts(data);
     this.pushEcommerceEvent("dl_begin_checkout", {
       currencyCode,
       checkout: {
@@ -234,18 +150,11 @@ class ElevarSink {
     });
   }
   async viewCollection({ data }) {
-    const collection = collectionPayloadSchema.safeParse(data);
-    if (!collection.success) {
-      return;
-    }
-    const { products, currencyCode } = toElevarProducts(
-      collection.data.products ?? [],
-      {
-        list: window.location.pathname,
-        withQuantity: false,
-        currency: collection.data.currency ?? collection.data.currencyCode
-      }
-    );
+    const { products, currencyCode } = toElevarProducts(data.products, {
+      list: window.location.pathname,
+      withQuantity: false,
+      currency: data.currency
+    });
     this.pushEcommerceEvent("dl_view_item_list", {
       currencyCode,
       impressions: products

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

@@ -1,15 +1,16 @@
-import type { AnalyticsSink, DataPayload, PurchasePayload } from "../analytics-sink";
+import type { AnalyticsSink, CartLineEventPayload, CartViewedPayload, CheckoutStartedPayload, ClickPayload, CollectionViewedPayload, LegacyCheckoutStartedPayload, ProductViewedPayload, PurchasePayload } from "../analytics-sink";
 import type { PageMetadata } from "../utils/navigation-tracker";
 export declare class GA4Sink implements AnalyticsSink {
     private send;
     constructor();
+    customEvent(): Promise<void>;
     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>;
+    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/ga4-sink.js

@@ -1,8 +1,6 @@
-import {
-  legacyResourceId,
-  splitCollectionProducts,
-  withoutUndefined
-} from "../utils/analytics-products";
+import { filterUndefined } from "../../_vendor/replo-utils/lib/object.mjs";
+import { toCheckoutStartedData } from "../legacy-checkout";
+import { legacyResourceId } from "../utils/analytics-products";
 import { createEventQueue } from "../utils/analytics-utils";
 class GA4Sink {
   send;
@@ -16,6 +14,8 @@ class GA4Sink {
       "GA4"
     );
   }
+  async customEvent() {
+  }
   async pageView(metadata) {
     const params = metadata ? {
       page_title: metadata.title,
@@ -49,18 +49,19 @@ class GA4Sink {
   async viewCart({ data }) {
     this.send("view_cart", data);
   }
-  async startCheckout({ data }) {
+  async startCheckout(payload) {
+    const data = toCheckoutStartedData(payload.data);
     this.send("begin_checkout", data);
   }
   async viewCollection({ data }) {
-    const { products, rest } = splitCollectionProducts(data);
+    const { products, ...rest } = data;
     this.send("view_item_list", {
       item_list_id: data.collectionId,
       item_list_name: data.collectionTitle,
       currency: data.currency,
       ...products.length > 0 ? {
         items: products.map((product, index) => {
-          return withoutUndefined({
+          return filterUndefined({
             item_id: legacyResourceId(product.productId),
             item_name: product.productTitle,
             item_variant: product.variantTitle,

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

@@ -1,5 +1,6 @@
-import type { AnalyticsSink, CustomEventPayload, DataPayload, PurchasePayload } from "../analytics-sink";
+import type { AnalyticsSink, CartLineEventPayload, CartViewedPayload, CheckoutStartedPayload, ClickPayload, CollectionViewedPayload, CustomEventPayload, LegacyCheckoutStartedPayload, ProductViewedPayload, PurchasePayload } from "../analytics-sink";
 import type { PageMetadata } from "../utils/navigation-tracker";
+/** Each mapping receives the event's typed payload. */
 export type IntelligemsEventMappings = {
     [Method in Exclude<keyof AnalyticsSink, "customEvent">]?: (...args: Parameters<AnalyticsSink[Method]>) => CustomEventPayload | null;
 };
@@ -19,11 +20,11 @@ export declare class IntelligemsSink implements AnalyticsSink {
     private send;
     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>;
+    click(payload: ClickPayload): Promise<void>;
+    productViewed(payload: ProductViewedPayload): Promise<void>;
+    addToCart(payload: CartLineEventPayload): Promise<void>;
+    removeFromCart(payload: CartLineEventPayload): Promise<void>;
+    viewCart(payload: CartViewedPayload): Promise<void>;
+    startCheckout(payload: CheckoutStartedPayload | LegacyCheckoutStartedPayload): Promise<void>;
+    viewCollection(payload: CollectionViewedPayload): Promise<void>;
 }

package/analytics/sinks/intelligems-sink.js

@@ -1,5 +1,6 @@
 "use client";
 import { consentStore, isConsentAllowed } from "../../consent/consent-store";
+import { toCheckoutStartedData } from "../legacy-checkout";
 class IntelligemsSink {
   constructor(options) {
     this.options = options;
@@ -55,7 +56,8 @@ class IntelligemsSink {
     await this.send(this.options.events?.viewCart?.(payload));
   }
   async startCheckout(payload) {
-    await this.send(this.options.events?.startCheckout?.(payload));
+    const data = toCheckoutStartedData(payload.data);
+    await this.send(this.options.events?.startCheckout?.({ data }));
   }
   async viewCollection(payload) {
     await this.send(this.options.events?.viewCollection?.(payload));