@replohq/sdk 1.22.0 → 2.0.0

package/_vendor/replo-utils/lib/json.mjs

@@ -1,6 +1,5 @@
-export { jsonStringifyOrNull, omitJsonObjectFieldsOrNull, parseJsonOrNull } from '../../../chunk-C37TXOGI.mjs';
-import '../../../chunk-VVB7BEDE.mjs';
-import '../../../chunk-ACQS4AG5.mjs';
-import '../../../chunk-EUIVDITZ.mjs';
-import '../../../chunk-SSBIMQES.mjs';
+export { jsonStringifyOrNull, omitJsonObjectFieldsOrNull, parseJsonOrNull } from '../../../chunk-PSYP2DYM.mjs';
+import '../../../chunk-O4QBR4QC.mjs';
+import '../../../chunk-OPKMOW43.mjs';
+import '../../../chunk-ZPDXVFCR.mjs';
 import '../../../chunk-UJCSKKID.mjs';

package/_vendor/replo-utils/lib/misc.mjs

@@ -1,4 +1,5 @@
-export { coerceNumberToString, deepCloneAndMergeReplacingArrays, errorMessage, exhaustiveSwitch, formatFileSize, getFromRecordOrNull, hasOwnProperty, invariant, isEmpty, isNotNullish, isNullish, isPrimitive, mergeReplacingArrays, mergeReplacingObjects, noop, preventDefault, sleep, sleepWithSignal, warning } from '../../../chunk-HFKL4ZR5.mjs';
-export { isNumber_default as isNumber, isString_default as isString } from '../../../chunk-EUIVDITZ.mjs';
-export { isFunction_default as isFunction } from '../../../chunk-SSBIMQES.mjs';
+export { coerceNumberToString, deepCloneAndMergeReplacingArrays, errorMessage, exhaustiveSwitch, formatFileSize, getFromRecordOrNull, hasOwnProperty, invariant, isEmpty, isNotNullish, isNullish, isPrimitive, mergeReplacingArrays, mergeReplacingObjects, noop, preventDefault, sleep, sleepWithSignal, warning } from '../../../chunk-XGXJOHUY.mjs';
+export { isFunction_default as isFunction } from '../../../chunk-XWWFRIXV.mjs';
+export { isNumber_default as isNumber, isString_default as isString } from '../../../chunk-OPKMOW43.mjs';
+import '../../../chunk-ZPDXVFCR.mjs';
 import '../../../chunk-UJCSKKID.mjs';

package/_vendor/replo-utils/lib/object.d.ts

@@ -26,6 +26,21 @@ export declare const deepEqual: typeof dequalLite;
  * @returns A new object without the specified keys
  */
 export declare function omit<ObjectType extends Record<string, any>, KeyType extends keyof ObjectType>(obj: ObjectType, keysToOmit: KeyType[]): Omit<ObjectType, KeyType>;
-export declare function filterUndefined<ObjectType extends Record<string, unknown>>(data: ObjectType): Partial<ObjectType>;
+/**
+ * `ObjectType` with every key that can hold `undefined` made optional and
+ * `undefined` removed from its value type. Keys that can't be `undefined`
+ * stay required.
+ */
+export type WithoutUndefined<ObjectType> = {
+    [Key in keyof ObjectType as undefined extends ObjectType[Key] ? never : Key]: ObjectType[Key];
+} & {
+    [Key in keyof ObjectType as undefined extends ObjectType[Key] ? Key : never]?: Exclude<ObjectType[Key], undefined>;
+};
+/**
+ * Copies `data` without its `undefined`-valued own keys. A plain loop rather
+ * than lodash `pickBy`: this ships in the published SDK, and `pickBy` drags in
+ * lodash's iteratee-shorthand machinery (~6 KB gzipped) for a one-line check.
+ */
+export declare function filterUndefined<ObjectType extends Record<string, unknown>>(data: ObjectType): WithoutUndefined<ObjectType>;
 export declare function toNullableIfDefined<ValueType>(value: ValueType | undefined): ValueType | null | undefined;
 export {};

package/_vendor/replo-utils/lib/object.mjs

@@ -1,5 +1,4 @@
-export { deepEqual, filterUndefined, forEachPrimitiveValue, omit, shallowEqual, toNullableIfDefined } from '../../../chunk-VVB7BEDE.mjs';
-import '../../../chunk-ACQS4AG5.mjs';
-import '../../../chunk-EUIVDITZ.mjs';
-import '../../../chunk-SSBIMQES.mjs';
+export { deepEqual, filterUndefined, forEachPrimitiveValue, omit, shallowEqual, toNullableIfDefined } from '../../../chunk-O4QBR4QC.mjs';
+import '../../../chunk-OPKMOW43.mjs';
+import '../../../chunk-ZPDXVFCR.mjs';
 import '../../../chunk-UJCSKKID.mjs';

package/_vendor/schemas/contentEntry.mjs

@@ -1,5 +1,5 @@
-export { CONTENT_MANAGED_ENTRY_VALUE_KEYS, contentEntryFrontmatterSchema, convertLegacyContentEntryDocument, getContentEntryFieldValidationIssues, getContentRenderableEntryValues, parseContentEntryDocument, serializeContentEntryDocument } from '../../chunk-CQYCPDPI.mjs';
+export { CONTENT_MANAGED_ENTRY_VALUE_KEYS, contentEntryFrontmatterSchema, convertLegacyContentEntryDocument, getContentEntryFieldValidationIssues, getContentRenderableEntryValues, parseContentEntryDocument, serializeContentEntryDocument } from '../../chunk-TTEBDCWT.mjs';
 import '../../chunk-RQ76VK3L.mjs';
-import '../../chunk-ACQS4AG5.mjs';
-import '../../chunk-SSBIMQES.mjs';
+import '../../chunk-XWWFRIXV.mjs';
+import '../../chunk-ZPDXVFCR.mjs';
 import '../../chunk-UJCSKKID.mjs';

package/_vendor/schemas/contentManifest.mjs

@@ -1,10 +1,10 @@
-import { parseContentEntryDocument, getContentRenderableEntryValues, getContentEntryFieldValidationIssues } from '../../chunk-CQYCPDPI.mjs';
+import { parseContentEntryDocument, getContentRenderableEntryValues, getContentEntryFieldValidationIssues } from '../../chunk-TTEBDCWT.mjs';
 import { isValidContentSlug, CONTENT_COLLECTION_SCHEMA_FILENAME, CONTENT_ENTRY_FILE_EXTENSION, contentCollectionFileSchema, CONTENT_ENTRY_PUBLISHED_FILE_EXTENSION } from '../../chunk-RQ76VK3L.mjs';
-import { parseJsonOrNull } from '../../chunk-C37TXOGI.mjs';
-import '../../chunk-VVB7BEDE.mjs';
-import '../../chunk-ACQS4AG5.mjs';
-import '../../chunk-EUIVDITZ.mjs';
-import '../../chunk-SSBIMQES.mjs';
+import '../../chunk-XWWFRIXV.mjs';
+import { parseJsonOrNull } from '../../chunk-PSYP2DYM.mjs';
+import '../../chunk-O4QBR4QC.mjs';
+import '../../chunk-OPKMOW43.mjs';
+import '../../chunk-ZPDXVFCR.mjs';
 import '../../chunk-UJCSKKID.mjs';
 import * as z from 'zod';
 

package/_vendor/schemas/errors.d.ts

@@ -1,48 +1,8 @@
 import type { ErrorUserFacingDetails, ErrorUserFacingDetailsWithMessage } from "./generated/errors";
+import type { ReploErrorConfig } from "./reploError";
 import * as z from "zod";
-/**
- * Config to use for any standard error we throw in Replo
- */
-export type ReploErrorConfig = {
-    /**
-     * Message of the error, used only internally. If not provided, defaults to
-     * the error's class name
-     */
-    message?: string;
-    /**
-     * Any additional data about the error, e.g. ids of content that was trying
-     * to be accessed, contextual variables, etc. This is included when the error
-     * is logged to Sentry, etc
-     */
-    additionalData?: Record<string, unknown>;
-    /** Meta details for error reporting */
-    errorReportingDetails?: {
-        /**
-         * If true, tells Sentry that it should group this error differently when
-         * it happens on different endpoints ("transactions" in Sentry are endpoints)
-         */
-        includeTransactionInFingerprint?: boolean;
-        /**
-         * If provided, these get added to the Sentry fingerprint for this error. Useful
-         * for when you want to modify the grouping of an error, especially for reusing
-         * errors in different places.
-         */
-        customFingerprint?: string[];
-    };
-    /**
-     * Original cause of the error (useful for if you need to catch and re-throw errors
-     * with more context). Will be reported in stacktraces, sentry, etc.
-     */
-    cause?: unknown;
-};
-/**
- * Base error that all errors in Replo inherit from
- */
-export declare abstract class ReploError extends Error {
-    config: ReploErrorConfig;
-    id: string;
-    constructor(config: ReploErrorConfig);
-}
+import { ReploError } from "./reploError";
+export { ReploError, type ReploErrorConfig } from "./reploError";
 /**
  * Wraps an error so `async-retry` stops immediately instead of scheduling
  * another attempt: the library rejects with any thrown error carrying a truthy

package/_vendor/schemas/{money.d.ts → moneyFormat.d.ts}

@@ -1,5 +1,4 @@
-import * as z from "zod";
-import { ReploError } from "./errors";
+import { ReploError } from "./reploError";
 export declare class InvalidAmountError extends ReploError {
 }
 export declare class UnsupportedCurrencyError extends ReploError {
@@ -52,9 +51,3 @@ export declare function formatAmount({ amount, currencyCode, locale, }: {
     currencyCode: string;
     locale?: string;
 }): string;
-export declare const amountSchema: z.ZodNumber;
-/** An amount in minor units paired with its ISO 4217 currency code. */
-export declare const amountWithCurrencyCodeSchema: z.ZodObject<{
-    amount: z.ZodNumber;
-    currencyCode: z.ZodString;
-}, z.core.$strip>;

package/_vendor/schemas/{money.mjs → moneyFormat.mjs}

@@ -1,9 +1,5 @@
-import { ReploError } from '../../chunk-AQG3256R.mjs';
-import '../../chunk-HFKL4ZR5.mjs';
-import '../../chunk-EUIVDITZ.mjs';
-import '../../chunk-SSBIMQES.mjs';
+import { ReploError } from '../../chunk-CKRRL66R.mjs';
 import { __commonJS, __toESM } from '../../chunk-UJCSKKID.mjs';
-import * as z from 'zod';
 
 var require_first_match = __commonJS({
   "../../node_modules/.pnpm/first-match@0.0.1/node_modules/first-match/index.js"(exports, module) {
@@ -1816,9 +1812,9 @@ var require_currency_codes = __commonJS({
         }) || []).indexOf(country2) > -1;
       });
     };
-    var number2 = function(number3) {
+    var number = function(number2) {
       return first(data, function(c) {
-        return c.number === String(number3);
+        return c.number === String(number2);
       });
     };
     var codes = function() {
@@ -1846,7 +1842,7 @@ var require_currency_codes = __commonJS({
     };
     exports.code = code;
     exports.country = country;
-    exports.number = number2;
+    exports.number = number;
     exports.codes = codes;
     exports.numbers = numbers;
     exports.countries = countries;
@@ -1926,12 +1922,5 @@ function formatAmount({
     currency: currencyCode.toUpperCase()
   }).format(fromMinorUnitsToMajorUnits({ amount, currencyCode }));
 }
-var amountSchema = z.number().int().describe(
-  "Integer amount in the currency's minor units (Stripe convention): 1999 = $19.99 USD, 1999 = \xA51999 JPY, 1999 = 1.999 KWD"
-);
-var amountWithCurrencyCodeSchema = z.object({
-  amount: amountSchema,
-  currencyCode: z.string()
-});
 
-export { InvalidAmountError, UnsupportedCurrencyError, amountSchema, amountWithCurrencyCodeSchema, formatAmount, fromMajorUnitsToMinorUnits, fromMinorUnitsToMajorUnits, fromMinorUnitsToMajorUnitsString, parseDecimalToMinorUnits };
+export { InvalidAmountError, UnsupportedCurrencyError, formatAmount, fromMajorUnitsToMinorUnits, fromMinorUnitsToMajorUnits, fromMinorUnitsToMajorUnitsString, parseDecimalToMinorUnits };

package/_vendor/schemas/reploError.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Config to use for any standard error we throw in Replo
+ */
+export type ReploErrorConfig = {
+    /**
+     * Message of the error, used only internally. If not provided, defaults to
+     * the error's class name
+     */
+    message?: string;
+    /**
+     * Any additional data about the error, e.g. ids of content that was trying
+     * to be accessed, contextual variables, etc. This is included when the error
+     * is logged to Sentry, etc
+     */
+    additionalData?: Record<string, unknown>;
+    /** Meta details for error reporting */
+    errorReportingDetails?: {
+        /**
+         * If true, tells Sentry that it should group this error differently when
+         * it happens on different endpoints ("transactions" in Sentry are endpoints)
+         */
+        includeTransactionInFingerprint?: boolean;
+        /**
+         * If provided, these get added to the Sentry fingerprint for this error. Useful
+         * for when you want to modify the grouping of an error, especially for reusing
+         * errors in different places.
+         */
+        customFingerprint?: string[];
+    };
+    /**
+     * Original cause of the error (useful for if you need to catch and re-throw errors
+     * with more context). Will be reported in stacktraces, sentry, etc.
+     */
+    cause?: unknown;
+};
+/**
+ * Base error that all errors in Replo inherit from
+ */
+export declare abstract class ReploError extends Error {
+    config: ReploErrorConfig;
+    id: string;
+    constructor(config: ReploErrorConfig);
+}

package/_vendor/schemas/routing/locale.mjs

@@ -1,7 +1,9 @@
-import { ReploError } from '../../../chunk-AQG3256R.mjs';
-import '../../../chunk-HFKL4ZR5.mjs';
-import '../../../chunk-EUIVDITZ.mjs';
-import '../../../chunk-SSBIMQES.mjs';
+import '../../../chunk-XSMYSAKY.mjs';
+import { ReploError } from '../../../chunk-CKRRL66R.mjs';
+import '../../../chunk-XGXJOHUY.mjs';
+import '../../../chunk-XWWFRIXV.mjs';
+import '../../../chunk-OPKMOW43.mjs';
+import '../../../chunk-ZPDXVFCR.mjs';
 import '../../../chunk-UJCSKKID.mjs';
 import * as z from 'zod';
 

package/_vendor/schemas/routing/rules.mjs

@@ -1,8 +1,10 @@
 import { getParamSegment, getRouteParams, hasRouteParam, matchSource } from '../../../chunk-VPEVERWE.mjs';
-import { ReploError } from '../../../chunk-AQG3256R.mjs';
-import '../../../chunk-HFKL4ZR5.mjs';
-import '../../../chunk-EUIVDITZ.mjs';
-import '../../../chunk-SSBIMQES.mjs';
+import '../../../chunk-XSMYSAKY.mjs';
+import { ReploError } from '../../../chunk-CKRRL66R.mjs';
+import '../../../chunk-XGXJOHUY.mjs';
+import '../../../chunk-XWWFRIXV.mjs';
+import '../../../chunk-OPKMOW43.mjs';
+import '../../../chunk-ZPDXVFCR.mjs';
 import '../../../chunk-UJCSKKID.mjs';
 import * as z from 'zod';
 

package/analytics/analytics-sink.d.ts

@@ -1,6 +1,80 @@
 import type { PageMetadata } from "./utils/navigation-tracker";
-export type DataPayload = {
-    data: Record<string, any>;
+/**
+ * One product line on a product, cart, collection or checkout event. Prices
+ * are decimal major units (19.99), never integer minor units.
+ */
+export type AnalyticsProductLine = {
+    productId: string;
+    productTitle?: string;
+    variantId?: string;
+    variantTitle?: string;
+    /** May be empty when the variant has no SKU. */
+    variantSku?: string;
+    price?: number;
+    currency?: string;
+    quantity?: number;
+};
+/** Sent by `useProductViewedAnalytics`. */
+export type ProductViewedData = Omit<AnalyticsProductLine, "quantity"> & {
+    productSlug?: string;
+    productDescription?: string;
+};
+/** Sent by the cart provider for each added or removed line. */
+export type CartLineData = AnalyticsProductLine & {
+    quantity: number;
+};
+/** Sent by the cart provider when the cart opens. */
+export type CartViewedData = {
+    itemCount: number;
+    subtotal: number;
+    currency?: string;
+    lineItems: CartLineData[];
+};
+/** The cart a shopper takes to checkout, with its order total. */
+export type CheckoutStartedData = CartViewedData & {
+    total: number;
+};
+/** Sent by `useCollectionViewedAnalytics`. */
+export type CollectionViewedData = {
+    collectionId: string;
+    collectionTitle?: string;
+    collectionHandle?: string;
+    currency?: string;
+    products: AnalyticsProductLine[];
+};
+export type AnalyticsProperty = string | number | boolean | null | AnalyticsProperty[] | {
+    [key: string]: AnalyticsProperty;
+};
+/** A site-defined click; its properties are forwarded as-is. */
+export type ClickData = Record<string, AnalyticsProperty>;
+/** Order amounts are decimal major units, like `PurchasePayload.amount`. */
+export type PurchaseData = {
+    orderId?: string;
+    lineItems?: CartLineData[];
+    /** Units in the order, when the caller has a count but no lines. */
+    itemCount?: number;
+    totalTax?: number;
+    totalShipping?: number;
+    totalDiscount?: number;
+    discountCodes?: string[];
+};
+export type ProductViewedPayload = {
+    data: ProductViewedData;
+};
+export type CartLineEventPayload = {
+    data: CartLineData;
+};
+export type CartViewedPayload = {
+    data: CartViewedData;
+};
+export type CheckoutStartedPayload = {
+    data: CheckoutStartedData;
+};
+export type CollectionViewedPayload = {
+    data: CollectionViewedData;
+};
+export type ClickPayload = {
+    data: ClickData;
 };
 export type PurchasePayload = {
     /**
@@ -11,25 +85,63 @@ export type PurchasePayload = {
      */
     amount: number;
     currency: string;
-    data: Record<string, any>;
+    data: PurchaseData;
 };
-export type AnalyticsProperty = string | number | boolean | null | AnalyticsProperty[] | {
-    [key: string]: AnalyticsProperty;
+/** A money amount as older starter carts built it. */
+export type LegacyMoney = {
+    amount: number;
+    currencyCode: string;
+};
+/** A checkout line as older starter carts built it. */
+export type LegacyCheckoutLineItem = {
+    id: string;
+    quantity: number;
+    title: string;
+    variant: {
+        id: string;
+        title: string;
+        price: LegacyMoney;
+        product: {
+            id: string;
+            title: string;
+            url?: string;
+        };
+    };
+    finalLinePrice?: LegacyMoney;
+};
+/** The nested checkout payload older starter carts send. */
+export type LegacyCheckoutStartedData = {
+    currencyCode: string;
+    totalPrice: LegacyMoney;
+    subtotalPrice: LegacyMoney;
+    lineItems: LegacyCheckoutLineItem[];
+};
+export type LegacyCheckoutStartedPayload = {
+    data: LegacyCheckoutStartedData;
 };
 export interface CustomEventPayload {
     event: string;
     properties?: Record<string, AnalyticsProperty>;
 }
+/**
+ * What `useAnalytics()` returns, and what every sink implements, including
+ * sinks registered with `useAnalyticsSink`. Each event takes its typed payload;
+ * a sink with no use for an event implements it as a no-op.
+ */
 export interface AnalyticsSink {
-    /** Explicit business goals; sinks without custom-event support may omit this. */
-    customEvent?(payload: CustomEventPayload): Promise<void>;
+    /** An explicit business goal, such as a completed quiz. */
+    customEvent(payload: CustomEventPayload): Promise<void>;
     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>;
+    /**
+     * Also takes the nested payload older starter carts send; the built-in
+     * sinks convert it to `CheckoutStartedData`.
+     */
+    startCheckout(payload: CheckoutStartedPayload | LegacyCheckoutStartedPayload): Promise<void>;
+    viewCollection(payload: CollectionViewedPayload): Promise<void>;
 }

package/analytics/combine-sinks.js

@@ -1,6 +1,6 @@
 import { logAnalyticsActivity } from "./utils/analytics-log";
 function combineSinks(sinks) {
-  const broadcast = async (method, ...args) => {
+  const broadcast = async (method, send) => {
     if (typeof window !== "undefined") {
       logAnalyticsActivity({
         kind: "broadcast",
@@ -11,8 +11,7 @@ function combineSinks(sinks) {
     await Promise.all(
       sinks.map(async (sink) => {
         try {
-          const sinkMethod = sink[method];
-          await sinkMethod?.apply(sink, args);
+          await send(sink);
         } catch {
           if (typeof window !== "undefined") {
             console.warn("[analytics] sink error", { method });
@@ -22,16 +21,40 @@ function combineSinks(sinks) {
     );
   };
   return {
-    customEvent: (...args) => broadcast("customEvent", ...args),
-    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)
+    customEvent: (payload) => {
+      return broadcast("customEvent", (sink) => sink.customEvent(payload));
+    },
+    pageView: (metadata) => {
+      return broadcast("pageView", (sink) => sink.pageView(metadata));
+    },
+    purchase: (payload) => {
+      return broadcast("purchase", (sink) => sink.purchase(payload));
+    },
+    click: (payload) => {
+      return broadcast("click", (sink) => sink.click(payload));
+    },
+    productViewed: (payload) => {
+      return broadcast("productViewed", (sink) => sink.productViewed(payload));
+    },
+    addToCart: (payload) => {
+      return broadcast("addToCart", (sink) => sink.addToCart(payload));
+    },
+    removeFromCart: (payload) => {
+      return broadcast("removeFromCart", (sink) => {
+        return sink.removeFromCart(payload);
+      });
+    },
+    viewCart: (payload) => {
+      return broadcast("viewCart", (sink) => sink.viewCart(payload));
+    },
+    startCheckout: (payload) => {
+      return broadcast("startCheckout", (sink) => sink.startCheckout(payload));
+    },
+    viewCollection: (payload) => {
+      return broadcast("viewCollection", (sink) => {
+        return sink.viewCollection(payload);
+      });
+    }
   };
 }
 export {

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

@@ -1,20 +1,4 @@
-interface AnalyticsProduct {
-    id: string;
-    title: string;
-    slug?: string;
-    description?: string;
-}
-interface AnalyticsProductVariant {
-    id: string;
-    title?: string;
-    sku?: string;
-    price?: number | {
-        amount: number | string;
-        currencyCode: string;
-    };
-    currency?: string;
-    priceCurrencyCode?: string | null;
-}
+import type { AnalyticsProduct, AnalyticsProductVariant } from "../utils/product-analytics";
 interface UseProductViewedAnalyticsProps {
     product: AnalyticsProduct | null;
     selectedVariant?: AnalyticsProductVariant | null;

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

@@ -1,6 +1,7 @@
 "use client";
 import { useEffect, useRef } from "react";
 import { useAnalytics } from "../analytics-provider";
+import { buildProductViewedAnalyticsData } from "../utils/product-analytics";
 function useProductViewedAnalytics({
   product,
   selectedVariant
@@ -12,21 +13,11 @@ function useProductViewedAnalytics({
       const trackingKey = `${product.id}-${selectedVariant.id}`;
       if (lastTrackedRef.current !== trackingKey) {
         lastTrackedRef.current = trackingKey;
-        const price = typeof selectedVariant.price === "object" ? Number(selectedVariant.price.amount) : selectedVariant.price ?? 0;
-        const currency = typeof selectedVariant.price === "object" ? selectedVariant.price.currencyCode : selectedVariant.currency ?? selectedVariant.priceCurrencyCode ?? void 0;
-        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,
-            currency
-          }
+        const data = buildProductViewedAnalyticsData({
+          product,
+          selectedVariant
         });
+        void analytics.productViewed({ data });
       }
     }
   }, [analytics, product, selectedVariant]);

package/analytics/legacy-checkout.d.ts

@@ -0,0 +1,2 @@
+import type { CheckoutStartedData, LegacyCheckoutStartedData } from "./analytics-sink";
+export declare function toCheckoutStartedData(data: CheckoutStartedData | LegacyCheckoutStartedData): CheckoutStartedData;

package/analytics/legacy-checkout.js

@@ -0,0 +1,26 @@
+function toCheckoutStartedData(data) {
+  if ("total" in data) {
+    return data;
+  }
+  const lineItems = data.lineItems.map((line) => {
+    return {
+      productId: line.variant.product.id,
+      productTitle: line.variant.product.title,
+      variantId: line.variant.id,
+      variantTitle: line.variant.title,
+      price: line.variant.price.amount,
+      currency: line.variant.price.currencyCode,
+      quantity: line.quantity
+    };
+  });
+  return {
+    itemCount: lineItems.reduce((sum, line) => sum + line.quantity, 0),
+    subtotal: data.subtotalPrice.amount,
+    total: data.totalPrice.amount,
+    currency: data.currencyCode,
+    lineItems
+  };
+}
+export {
+  toCheckoutStartedData
+};

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

@@ -1,5 +1,4 @@
-import type { PurchasePayload } from "../analytics-sink";
-type AnalyticsRecord = Record<string, unknown>;
+import type { CartLineData, CollectionViewedData, ProductViewedData, PurchasePayload } from "../analytics-sink";
 export type ConvergeProductProperties = {
     product_id: string;
     name: string;
@@ -8,9 +7,6 @@ export type ConvergeProductProperties = {
     variant_id?: string;
     sku?: string;
     variant_name?: string;
-    vendor?: string;
-    url?: string;
-    image_url?: string;
 };
 type ConvergeCartItem = ConvergeProductProperties & {
     quantity: number;
@@ -22,7 +18,7 @@ export type ConvergeCartProperties = {
     currency: string;
     items?: ConvergeCartItem[];
     total_discount?: number;
-    coupon?: string | string[];
+    coupon?: string[];
 };
 export type ConvergeOrderProperties = ConvergeCartProperties & {
     id: string;
@@ -30,12 +26,15 @@ export type ConvergeOrderProperties = ConvergeCartProperties & {
 export type ConvergeCollectionProperties = {
     id: string;
     name: string;
-    description?: string;
     items?: ConvergeProductProperties[];
 };
-export declare function mapConvergeProduct(data: AnalyticsRecord): ConvergeProductProperties | null;
-export declare function mapConvergeCartItem(data: AnalyticsRecord): ConvergeCartItem | null;
-export declare function mapConvergeCollection(data: AnalyticsRecord): ConvergeCollectionProperties | null;
-export declare function mapConvergeCart(data: AnalyticsRecord): ConvergeCartProperties | null;
+export declare function mapConvergeProduct(data: ProductViewedData): ConvergeProductProperties | null;
+export declare function mapConvergeCartItem(data: CartLineData): ConvergeCartItem | null;
+export declare function mapConvergeCollection(data: CollectionViewedData): ConvergeCollectionProperties | null;
+export declare function mapConvergeCart({ totalPrice, currency, lineItems, }: {
+    totalPrice: number;
+    currency: string | undefined;
+    lineItems: CartLineData[];
+}): ConvergeCartProperties | null;
 export declare function mapConvergeOrder({ amount, currency, data, }: PurchasePayload): ConvergeOrderProperties | null;
 export {};