@replohq/sdk 2.18.0 → 2.18.2

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

@@ -1,9 +1,9 @@
-import type { AnalyticsSink, CartLineEventPayload, CartViewedPayload, CheckoutStartedPayload, ClickPayload, CollectionViewedPayload, LegacyCheckoutStartedPayload, ProductViewedPayload, 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";
 export declare class GA4Sink implements AnalyticsSink {
     private send;
     constructor();
-    customEvent(): Promise<void>;
+    customEvent({ event, properties }: CustomEventPayload): Promise<void>;
     pageView(metadata?: PageMetadata): Promise<void>;
     purchase({ amount, currency, data }: PurchasePayload): Promise<void>;
     click({ data }: ClickPayload): Promise<void>;
@@ -13,4 +13,5 @@ export declare class GA4Sink implements AnalyticsSink {
     viewCart({ data }: CartViewedPayload): Promise<void>;
     startCheckout(payload: CheckoutStartedPayload | LegacyCheckoutStartedPayload): Promise<void>;
     viewCollection({ data }: CollectionViewedPayload): Promise<void>;
+    private sendCartLine;
 }

package/analytics/sinks/ga4-sink.js

@@ -2,6 +2,22 @@ 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";
+function toGa4Item({
+  product,
+  index
+}) {
+  return filterUndefined({
+    item_id: legacyResourceId(product.productId),
+    item_name: product.productTitle,
+    item_variant: product.variantTitle,
+    price: product.price,
+    quantity: product.quantity,
+    index
+  });
+}
+function toMoney(amount) {
+  return Number(amount.toPrecision(12));
+}
 class GA4Sink {
   send;
   constructor() {
@@ -14,7 +30,8 @@ class GA4Sink {
       "GA4"
     );
   }
-  async customEvent() {
+  async customEvent({ event, properties }) {
+    this.send(event, properties);
   }
   async pageView(metadata) {
     const params = metadata ? {
@@ -24,34 +41,60 @@ class GA4Sink {
     this.send("page_view", params);
   }
   async purchase({ amount, currency, data }) {
-    this.send("purchase", { value: amount, currency, ...data });
+    this.send(
+      "purchase",
+      filterUndefined({
+        transaction_id: data.orderId,
+        value: toMoney(
+          amount - (data.totalTax ?? 0) - (data.totalShipping ?? 0)
+        ),
+        currency,
+        tax: data.totalTax,
+        shipping: data.totalShipping,
+        coupon: data.discountCodes?.join(","),
+        items: data.lineItems?.map((line) => toGa4Item({ product: line }))
+      })
+    );
   }
   async click({ data }) {
     this.send("select_content", data);
   }
   async productViewed({ data }) {
-    this.send("view_item", {
-      value: data.price,
-      currency: data.currency,
-      ...data
-    });
+    this.send(
+      "view_item",
+      filterUndefined({
+        currency: data.currency,
+        value: data.price,
+        items: [toGa4Item({ product: data })]
+      })
+    );
   }
   async addToCart({ data }) {
-    this.send("add_to_cart", {
-      value: data.price,
-      currency: data.currency,
-      ...data
-    });
+    this.sendCartLine({ event: "add_to_cart", line: data });
   }
   async removeFromCart({ data }) {
-    this.send("remove_from_cart", data);
+    this.sendCartLine({ event: "remove_from_cart", line: data });
   }
   async viewCart({ data }) {
-    this.send("view_cart", data);
+    this.send(
+      "view_cart",
+      filterUndefined({
+        currency: data.currency,
+        value: data.subtotal,
+        items: data.lineItems.map((line) => toGa4Item({ product: line }))
+      })
+    );
   }
   async startCheckout(payload) {
     const data = toCheckoutStartedData(payload.data);
-    this.send("begin_checkout", data);
+    this.send(
+      "begin_checkout",
+      filterUndefined({
+        currency: data.currency,
+        value: data.subtotal,
+        items: data.lineItems.map((line) => toGa4Item({ product: line }))
+      })
+    );
   }
   async viewCollection({ data }) {
     const { products, ...rest } = data;
@@ -61,18 +104,22 @@ class GA4Sink {
       currency: data.currency,
       ...products.length > 0 ? {
         items: products.map((product, index) => {
-          return filterUndefined({
-            item_id: legacyResourceId(product.productId),
-            item_name: product.productTitle,
-            item_variant: product.variantTitle,
-            price: product.price,
-            index
-          });
+          return toGa4Item({ product, index });
         })
       } : {},
       ...rest
     });
   }
+  sendCartLine({ event, line }) {
+    this.send(
+      event,
+      filterUndefined({
+        currency: line.currency,
+        value: line.price === void 0 ? void 0 : toMoney(line.price * line.quantity),
+        items: [toGa4Item({ product: line })]
+      })
+    );
+  }
 }
 export {
   GA4Sink

package/lib/buildMetadata.js

@@ -1,7 +1,7 @@
 export const BUILD_METADATA = {
   "packageName": "@replohq/sdk",
-  "version": "2.18.0",
+  "version": "2.18.2",
   "branch": "HEAD",
-  "commit": "aa9296f4104e4be2271247d775a27fa69288bbe8",
-  "builtAt": "2026-11-02T03:31:48.722Z"
+  "commit": "b67d568983a09c8048085ad6e81a8d5a8195658e",
+  "builtAt": "2026-11-03T21:12:47.031Z"
 };

package/loaders/loader-args.d.ts

@@ -0,0 +1,15 @@
+import { CanopyError } from "../lib/canopy-error";
+/** A loader argument that can't be sent to canopy-api, such as a function. */
+export declare class LoaderArgsError extends CanopyError {
+}
+/**
+ * Finds the first function in a loader's args. JSON drops functions silently,
+ * so canopy-api would receive the args without that key and reject them. The
+ * usual cause is a value exported from a "use client" file and imported into a
+ * server component: on the server, every such export is a client reference
+ * (a function), never the value itself.
+ */
+export declare function getLoaderArgsError({ loaderKey, args, }: {
+    loaderKey: string;
+    args: Record<string, unknown>;
+}): LoaderArgsError | null;

package/loaders/loader-args.js

@@ -0,0 +1,46 @@
+import { CanopyError } from "../lib/canopy-error";
+const CLIENT_REFERENCE_TAG = Symbol.for("react.client.reference");
+class LoaderArgsError extends CanopyError {
+}
+function findFunctionArg(value, path, seen) {
+  if (typeof value === "function") {
+    return {
+      path,
+      isClientReference: Reflect.get(value, "$$typeof") === CLIENT_REFERENCE_TAG
+    };
+  }
+  if (typeof value !== "object" || value === null || seen.has(value) || typeof Reflect.get(value, "toJSON") === "function") {
+    return null;
+  }
+  seen.add(value);
+  for (const [key, child] of Object.entries(value)) {
+    const childPath = Array.isArray(value) ? `${path}[${key}]` : `${path}.${key}`;
+    const found = findFunctionArg(child, childPath, seen);
+    if (found !== null) {
+      return found;
+    }
+  }
+  return null;
+}
+function getLoaderArgsError({
+  loaderKey,
+  args
+}) {
+  const found = findFunctionArg(args, "args", /* @__PURE__ */ new Set());
+  if (found === null) {
+    return null;
+  }
+  const what = found.isClientReference ? "a client reference, not a value" : "a function";
+  return new LoaderArgsError({
+    message: `[Replo] Loader ${loaderKey}: ${found.path} is ${what}, so it can't be sent to the loader. It was probably imported from a "use client" file into a server component. Move the value into a module without "use client" and import it from both places.`,
+    additionalData: {
+      loaderKey,
+      path: found.path,
+      isClientReference: found.isClientReference
+    }
+  });
+}
+export {
+  LoaderArgsError,
+  getLoaderArgsError
+};

package/loaders/loader-output.d.ts

@@ -21,6 +21,9 @@ export declare class LoaderOutputError extends CanopyError {
  *
  * Malformed output is logged with the loader key and the failing paths, then
  * rejected with a `LoaderOutputError`; callers decide whether to fail soft.
+ * Args holding a function are logged and rejected with a `LoaderArgsError`
+ * before any request, since JSON would drop them and canopy-api would reject
+ * the rest. The log matters because `PrefetchedLoaders` swallows rejections.
  */
 export declare function fetchValidatedLoaderOutput({ loaderKey, args, }: {
     loaderKey: string;

package/loaders/loader-output.js

@@ -9,6 +9,7 @@ import {
   smileRewardsOutputSchema,
   smileVipTiersOutputSchema
 } from "./integration-loader-schemas";
+import { getLoaderArgsError } from "./loader-args";
 import { DATA_LOADER_KEYS } from "./loader-keys";
 import {
   contentfulEntriesLoaderOutputSchema,
@@ -93,6 +94,11 @@ async function fetchValidatedLoaderOutput({
   loaderKey,
   args
 }) {
+  const argsError = getLoaderArgsError({ loaderKey, args });
+  if (argsError !== null) {
+    console.error(argsError.message);
+    throw argsError;
+  }
   const gateway = await getCanopyApiGateway();
   const { data } = await gateway.invokeLoader({ loaderKey, args });
   const knownKey = dataLoaderKeySchema.safeParse(loaderKey);

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@replohq/sdk",
-  "version": "2.18.0",
+  "version": "2.18.2",
   "reploBuild": {
     "packageName": "@replohq/sdk",
-    "version": "2.18.0",
+    "version": "2.18.2",
     "branch": "HEAD",
-    "commit": "aa9296f4104e4be2271247d775a27fa69288bbe8",
-    "builtAt": "2026-11-02T03:31:48.722Z"
+    "commit": "b67d568983a09c8048085ad6e81a8d5a8195658e",
+    "builtAt": "2026-11-03T21:12:47.031Z"
   },
   "description": "Replo SDK — cart, analytics, and data loaders for agent-built Next.js sites.",
   "license": "SEE LICENSE IN LICENSE",