@replohq/sdk 1.22.0 → 2.0.0

package/analytics/sinks/x-sink.js

@@ -1,54 +1,21 @@
 import { filterUndefined } from "../../_vendor/replo-utils/lib/object.mjs";
-import * as z from "zod";
 import { isXEventIdForPixel } from "../../consent/script-snippets";
+import { toCheckoutStartedData } from "../legacy-checkout";
 import { legacyResourceId } from "../utils/analytics-products";
 import { createEventQueue } from "../utils/analytics-utils";
-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())
-]);
-function parseRecord(value) {
-  const result = analyticsRecordSchema.safeParse(value);
-  return result.success ? result.data : {};
-}
-function parseString(value) {
-  const result = nonEmptyStringSchema.safeParse(value);
-  return result.success ? result.data : void 0;
-}
-function parseNumber(value) {
-  const result = finiteNumberSchema.safeParse(value);
-  return result.success ? result.data : void 0;
-}
-function mapContent(value, defaultQuantity) {
-  const line = parseRecord(value);
-  const variant = parseRecord(line.variant);
-  const product = parseRecord(variant.product);
-  const productId = parseString(line.productId) ?? parseString(product.id);
-  if (!productId) {
-    return null;
-  }
+function mapContent(line, defaultQuantity) {
   return filterUndefined({
-    content_id: legacyResourceId(productId),
-    content_name: parseString(line.productTitle) ?? parseString(product.title) ?? parseString(line.title),
-    content_price: parseNumber(line.price) ?? parseNumber(parseRecord(variant.price).amount),
-    num_items: parseNumber(line.quantity) ?? defaultQuantity
+    content_id: legacyResourceId(line.productId),
+    content_name: line.productTitle || void 0,
+    content_price: line.price,
+    num_items: line.quantity ?? defaultQuantity
   });
 }
 function mapContents(lines) {
-  const result = z.array(z.unknown()).safeParse(lines);
-  if (!result.success) {
-    return void 0;
-  }
-  const contents = result.data.map((line) => mapContent(line, void 0)).filter((content) => content !== null);
-  return contents.length > 0 ? contents : void 0;
+  return lines && lines.length > 0 ? lines.map((line) => mapContent(line, void 0)) : void 0;
 }
 function lineValue(content) {
-  if (content?.content_price === void 0) {
+  if (content.content_price === void 0) {
     return void 0;
   }
   return content.content_price * (content.num_items ?? 1);
@@ -74,6 +41,8 @@ class XSink {
       this.send(eventId, filterUndefined(parameters));
     }
   }
+  async customEvent() {
+  }
   async pageView(metadata) {
     if (metadata?.navigationType === "initial") {
       return;
@@ -84,7 +53,7 @@ class XSink {
     this.track("purchase", {
       value: amount,
       currency,
-      conversion_id: parseString(data.order_id) ?? parseString(data.orderId) ?? parseString(data.id),
+      conversion_id: data.orderId,
       contents: mapContents(data.lineItems)
     });
   }
@@ -94,27 +63,27 @@ class XSink {
     const content = mapContent(data, 1);
     this.track("productViewed", {
       value: lineValue(content),
-      currency: parseString(data.currency),
-      contents: content ? [content] : void 0
+      currency: data.currency || void 0,
+      contents: [content]
     });
   }
   async addToCart({ data }) {
     const content = mapContent(data, 1);
     this.track("addToCart", {
       value: lineValue(content),
-      currency: parseString(data.currency),
-      contents: content ? [content] : void 0
+      currency: data.currency || void 0,
+      contents: [content]
     });
   }
   async removeFromCart() {
   }
   async viewCart() {
   }
-  async startCheckout({ data }) {
-    const totalPrice = parseRecord(data.totalPrice);
+  async startCheckout(payload) {
+    const data = toCheckoutStartedData(payload.data);
     this.track("startCheckout", {
-      value: parseNumber(totalPrice.amount),
-      currency: parseString(data.currencyCode) ?? parseString(totalPrice.currencyCode),
+      value: data.total,
+      currency: data.currency,
       contents: mapContents(data.lineItems)
     });
   }

package/analytics/test-fixtures.d.ts

@@ -0,0 +1,5 @@
+import type { CartLineData, CartViewedData, CheckoutStartedData, CollectionViewedData } from "./analytics-sink";
+export declare function cartLine(overrides?: Partial<CartLineData>): CartLineData;
+export declare function cartView(overrides?: Partial<CartViewedData>): CartViewedData;
+export declare function checkoutStarted(overrides?: Partial<CheckoutStartedData>): CheckoutStartedData;
+export declare function collectionViewed(overrides?: Partial<CollectionViewedData>): CollectionViewedData;

package/analytics/test-fixtures.js

@@ -0,0 +1,18 @@
+function cartLine(overrides = {}) {
+  return { productId: "1", price: 1, quantity: 1, ...overrides };
+}
+function cartView(overrides = {}) {
+  return { itemCount: 0, subtotal: 0, lineItems: [], ...overrides };
+}
+function checkoutStarted(overrides = {}) {
+  return { itemCount: 0, subtotal: 0, total: 0, lineItems: [], ...overrides };
+}
+function collectionViewed(overrides = {}) {
+  return { collectionId: "c1", products: [], ...overrides };
+}
+export {
+  cartLine,
+  cartView,
+  checkoutStarted,
+  collectionViewed
+};

package/analytics/utils/analytics-products.d.ts

@@ -1,36 +1,6 @@
-import * as z from "zod";
-/**
- * The flat per-product line the cart provider and the viewed hooks emit.
- * Prices are decimal major units.
- */
-declare const analyticsProductLineSchema: z.ZodObject<{
-    productId: z.ZodCatch<z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodPipe<z.ZodNumber, z.ZodTransform<string, number>>]>>>;
-    productTitle: z.ZodCatch<z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodPipe<z.ZodNumber, z.ZodTransform<string, number>>]>>>;
-    variantId: z.ZodCatch<z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodPipe<z.ZodNumber, z.ZodTransform<string, number>>]>>>;
-    variantTitle: z.ZodCatch<z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodPipe<z.ZodNumber, z.ZodTransform<string, number>>]>>>;
-    variantSku: z.ZodCatch<z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodPipe<z.ZodNumber, z.ZodTransform<string, number>>]>>>;
-    price: z.ZodCatch<z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>, z.ZodNumber>]>>>;
-    currency: z.ZodCatch<z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodPipe<z.ZodNumber, z.ZodTransform<string, number>>]>>>;
-    quantity: z.ZodCatch<z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>, z.ZodNumber>]>>>;
-}, z.core.$strip>;
-export type AnalyticsProductLine = z.infer<typeof analyticsProductLineSchema> & {
-    productId: string;
-};
-export declare function parseAnalyticsProductLines(value: unknown): AnalyticsProductLine[];
-/**
- * Separates a collection-view payload's `products` list from the scalar
- * fields, so a sink can map the list into its own item shape and forward the
- * rest untouched.
- */
-export declare function splitCollectionProducts(data: Record<string, unknown>): {
-    products: AnalyticsProductLine[];
-    rest: Record<string, unknown>;
-};
 /**
  * Shopify catalogs synced into ad platforms key on legacy numeric ids, while
  * the Storefront API hands sites GIDs (`gid://shopify/Product/123`). Pixel
  * catalog matching is an exact string match, so ids are sent bare.
  */
 export declare function legacyResourceId(id: string): string;
-export declare function withoutUndefined<RecordType extends Record<string, unknown>>(record: RecordType): Partial<RecordType>;
-export {};

package/analytics/utils/analytics-products.js

@@ -1,56 +1,6 @@
-import * as z from "zod";
-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 analyticsProductLineSchema = z.object({
-  productId: nonEmptyStringSchema,
-  productTitle: nonEmptyStringSchema,
-  variantId: nonEmptyStringSchema,
-  variantTitle: nonEmptyStringSchema,
-  variantSku: nonEmptyStringSchema,
-  price: finiteNumberSchema,
-  currency: nonEmptyStringSchema,
-  quantity: finiteNumberSchema
-});
-function parseAnalyticsProductLines(value) {
-  if (!Array.isArray(value)) {
-    return [];
-  }
-  return value.flatMap((item) => {
-    const parsed = analyticsProductLineSchema.safeParse(item);
-    if (!parsed.success || !parsed.data.productId) {
-      return [];
-    }
-    return [{ ...parsed.data, productId: parsed.data.productId }];
-  });
-}
-function splitCollectionProducts(data) {
-  const { products, ...rest } = data;
-  const lines = parseAnalyticsProductLines(products);
-  if (Array.isArray(products) && products.length > 0 && lines.length === 0) {
-    console.warn(
-      "[analytics] collection view products did not match the per-line shape and were dropped"
-    );
-  }
-  return { products: lines, rest };
-}
 function legacyResourceId(id) {
   return id.replace(/^gid:\/\/shopify\/\w+\//, "");
 }
-function withoutUndefined(record) {
-  const compacted = {};
-  for (const key in record) {
-    if (record[key] !== void 0) {
-      compacted[key] = record[key];
-    }
-  }
-  return compacted;
-}
 export {
-  legacyResourceId,
-  parseAnalyticsProductLines,
-  splitCollectionProducts,
-  withoutUndefined
+  legacyResourceId
 };

package/analytics/utils/collection-analytics.d.ts

@@ -1,3 +1,4 @@
+import type { CollectionViewedData } from "../analytics-sink";
 export interface AnalyticsMoney {
     amount: number | string;
     currencyCode: string;
@@ -27,18 +28,4 @@ export interface AnalyticsCollectionProduct {
 export declare function buildCollectionViewedAnalyticsData({ collection, products, }: {
     collection: AnalyticsCollection;
     products: AnalyticsCollectionProduct[];
-}): {
-    collectionTitle?: string | undefined;
-    collectionHandle?: string | undefined;
-    currency?: string | undefined;
-    collectionId: string;
-    products: {
-        productTitle?: string | undefined;
-        variantId?: string | undefined;
-        variantTitle?: string | undefined;
-        variantSku?: string | undefined;
-        price?: number | undefined;
-        currency?: string | undefined;
-        productId: string;
-    }[];
-};
+}): CollectionViewedData;

package/analytics/utils/collection-analytics.js

@@ -1,4 +1,4 @@
-import { withoutUndefined } from "./analytics-products";
+import { filterUndefined } from "../../_vendor/replo-utils/lib/object.mjs";
 function parseAmount(money) {
   if (!money) {
     return void 0;
@@ -9,32 +9,28 @@ function parseAmount(money) {
 function buildCollectionProductLine(product) {
   const variant = product.variants?.[0];
   const money = variant?.price ?? product.minPrice ?? void 0;
-  return {
+  return filterUndefined({
     productId: product.id,
-    ...withoutUndefined({
-      productTitle: product.title ?? void 0,
-      variantId: variant?.id,
-      variantTitle: variant?.title ?? void 0,
-      variantSku: variant?.sku ?? void 0,
-      price: parseAmount(money),
-      currency: money?.currencyCode
-    })
-  };
+    productTitle: product.title ?? void 0,
+    variantId: variant?.id,
+    variantTitle: variant?.title ?? void 0,
+    variantSku: variant?.sku ?? void 0,
+    price: parseAmount(money),
+    currency: money?.currencyCode
+  });
 }
 function buildCollectionViewedAnalyticsData({
   collection,
   products
 }) {
   const lines = products.map(buildCollectionProductLine);
-  return {
+  return filterUndefined({
     collectionId: collection.id,
     products: lines,
-    ...withoutUndefined({
-      collectionTitle: collection.title ?? void 0,
-      collectionHandle: collection.handle ?? void 0,
-      currency: lines.find((line) => line.currency)?.currency
-    })
-  };
+    collectionTitle: collection.title ?? void 0,
+    collectionHandle: collection.handle ?? void 0,
+    currency: lines.find((line) => line.currency)?.currency
+  });
 }
 export {
   buildCollectionViewedAnalyticsData

package/analytics/utils/product-analytics.d.ts

@@ -0,0 +1,23 @@
+import type { ProductViewedData } from "../analytics-sink";
+export interface AnalyticsProduct {
+    id: string;
+    title: string;
+    slug?: string;
+    description?: string;
+}
+export interface AnalyticsProductVariant {
+    id: string;
+    title?: string;
+    sku?: string;
+    price?: number | {
+        amount: number | string;
+        currencyCode: string;
+    };
+    currency?: string;
+    priceCurrencyCode?: string | null;
+}
+/** The `productViewed` payload for a product and its selected variant. */
+export declare function buildProductViewedAnalyticsData({ product, selectedVariant, }: {
+    product: AnalyticsProduct;
+    selectedVariant: AnalyticsProductVariant;
+}): ProductViewedData;

package/analytics/utils/product-analytics.js

@@ -0,0 +1,21 @@
+function buildProductViewedAnalyticsData({
+  product,
+  selectedVariant
+}) {
+  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;
+  return {
+    productId: product.id,
+    productTitle: product.title,
+    productSlug: product.slug,
+    productDescription: product.description,
+    variantId: selectedVariant.id,
+    variantTitle: selectedVariant.title ?? "",
+    variantSku: selectedVariant.sku ?? "",
+    price,
+    currency
+  };
+}
+export {
+  buildProductViewedAnalyticsData
+};

package/cart/hooks/use-add-to-cart.js

@@ -1,7 +1,7 @@
 "use client";
 import React from "react";
 import { useQueryClient } from "@tanstack/react-query";
-import { fromMajorUnitsToMinorUnits } from "../../_vendor/schemas/money.mjs";
+import { fromMajorUnitsToMinorUnits } from "../../_vendor/schemas/moneyFormat.mjs";
 import { DATA_LOADER_KEYS } from "../../loaders/loader-keys";
 import { useCartInternal } from "../cart-provider";
 import { REPLO_ATTRIBUTION_PROPERTY } from "../cart-types";

package/cart/utils/cart-analytics.d.ts

@@ -1,3 +1,4 @@
+import type { CartLineData, CartViewedData } from "../../analytics/analytics-sink";
 import type { Cart, CartLineMerchandise } from "../cart-types";
 /**
  * The per-line payload every cart event carries. Cart amounts are integer
@@ -8,27 +9,6 @@ export declare function buildCartLineAnalyticsData({ merchandise, quantity, curr
     merchandise: CartLineMerchandise;
     quantity: number;
     currencyCode: string | undefined;
-}): {
-    productId: string;
-    variantId: string;
-    quantity: number;
-    price: number;
-    currency: string | undefined;
-    productTitle: string;
-    variantTitle: string;
-};
+}): CartLineData;
 /** The cart-view payload, built from whichever cart snapshot the caller passes. */
-export declare function buildCartViewAnalyticsData(cart: Cart | null): {
-    itemCount: number;
-    subtotal: number;
-    currency: string | undefined;
-    lineItems: {
-        productId: string;
-        variantId: string;
-        quantity: number;
-        price: number;
-        currency: string | undefined;
-        productTitle: string;
-        variantTitle: string;
-    }[];
-};
+export declare function buildCartViewAnalyticsData(cart: Cart | null): CartViewedData;

package/cart/utils/cart-analytics.js

@@ -1,4 +1,4 @@
-import { fromMinorUnitsToMajorUnits } from "../../_vendor/schemas/money.mjs";
+import { fromMinorUnitsToMajorUnits } from "../../_vendor/schemas/moneyFormat.mjs";
 const FALLBACK_CURRENCY_CODE = "USD";
 function buildCartLineAnalyticsData({
   merchandise,

package/cart/utils/cart-utils.js

@@ -1,4 +1,4 @@
-import { formatAmount } from "../../_vendor/schemas/money.mjs";
+import { formatAmount } from "../../_vendor/schemas/moneyFormat.mjs";
 import { CanopyError } from "../../lib/canopy-error";
 import { getCartLinePricing } from "./variant-to-cart-line";
 class CartReconciliationMismatchError extends CanopyError {

package/cart/utils/variant-to-cart-line.js

@@ -1,4 +1,4 @@
-import { fromMajorUnitsToMinorUnits } from "../../_vendor/schemas/money.mjs";
+import { fromMajorUnitsToMinorUnits } from "../../_vendor/schemas/moneyFormat.mjs";
 function applyPriceAdjustment(variantPrice, adjustment, currencyCode) {
   switch (adjustment.valueType) {
     case "price":

package/chunk-CKRRL66R.mjs

@@ -0,0 +1,28 @@
+import { v4 } from 'uuid';
+
+function randomUUID() {
+  return v4();
+}
+
+var ReploError = class _ReploError extends Error {
+  config;
+  id;
+  constructor(config) {
+    super(config.message);
+    this.message = config.message ?? this.constructor.name;
+    this.config = config;
+    this.id = randomUUID();
+    const cause = config.cause;
+    if (cause) {
+      this.cause = cause;
+      if (cause instanceof _ReploError) {
+        this.config.additionalData = {
+          ...this.config.additionalData,
+          ...cause.config.additionalData
+        };
+      }
+    }
+  }
+};
+
+export { ReploError };

package/{chunk-VVB7BEDE.mjs → chunk-O4QBR4QC.mjs}

@@ -1,6 +1,5 @@
-import { pickBy_default } from './chunk-ACQS4AG5.mjs';
-import { isString_default, isNumber_default } from './chunk-EUIVDITZ.mjs';
-import { isObject_default } from './chunk-SSBIMQES.mjs';
+import { isString_default, isNumber_default } from './chunk-OPKMOW43.mjs';
+import { isObject_default } from './chunk-ZPDXVFCR.mjs';
 
 var has = Object.prototype.hasOwnProperty;
 function dequal(foo, bar) {
@@ -75,7 +74,13 @@ function omit(obj, keysToOmit) {
   return result;
 }
 function filterUndefined(data) {
-  return pickBy_default(data, (value) => value !== void 0);
+  const result = {};
+  for (const [key, value] of Object.entries(data)) {
+    if (value !== void 0) {
+      result[key] = value;
+    }
+  }
+  return result;
 }
 function toNullableIfDefined(value) {
   return value === void 0 ? void 0 : value ?? null;

package/{chunk-EUIVDITZ.mjs → chunk-OPKMOW43.mjs}

@@ -1,4 +1,4 @@
-import { isObjectLike_default, baseGetTag_default, isArray_default } from './chunk-SSBIMQES.mjs';
+import { isObjectLike_default, baseGetTag_default, isArray_default } from './chunk-ZPDXVFCR.mjs';
 
 var numberTag = "[object Number]";
 function isNumber(value) {

package/{chunk-C37TXOGI.mjs → chunk-PSYP2DYM.mjs}

@@ -1,4 +1,4 @@
-import { omit } from './chunk-VVB7BEDE.mjs';
+import { omit } from './chunk-O4QBR4QC.mjs';
 
 function parseJsonOrNull(json) {
   try {