@replohq/sdk 1.9.4 → 1.10.0

package/README.md

@@ -41,6 +41,13 @@ export default function RootLayout({ children }: React.PropsWithChildren) {
 `ReploProvider` is an async Server Component. Components that use SDK hooks or
 loaders must render beneath it.
 
+## Buy now checkout
+
+Use `useBuyNow` from `@replohq/sdk/cart/hooks/use-buy-now` to send a shopper
+directly to checkout. Shopify checkout applies selling plans and discount codes.
+Stripe checkout ignores both, logs a server warning when either is supplied,
+and still creates the checkout session.
+
 ## Data loaders
 
 Data loaders retrieve data from integrations configured for the Replo project.

package/_vendor/schemas/loaderKeys.mjs

@@ -6,6 +6,7 @@ var DATA_LOADER_KEYS = {
   SHOPIFY_COLLECTION_PRODUCTS: "shopify_storefront.collection_products",
   SHOPIFY_METAOBJECT: "shopify_storefront.metaobject",
   SHOPIFY_METAOBJECTS: "shopify_storefront.metaobjects",
+  SHOPIFY_KACHING_BUNDLES: "shopify_storefront.kaching_bundles",
   REPLO_PRODUCT: "replo_products.product",
   OKENDO_PRODUCT_REVIEWS: "okendo.product_reviews",
   OKENDO_PRODUCT_REVIEW_AGGREGATE: "okendo.product_review_aggregate",

package/analytics/utils/analytics-utils.js

@@ -53,6 +53,9 @@ function createAnalyticsQueue({
       return;
     }
     if (isReady()) {
+      if (queue.length > 0) {
+        flush();
+      }
       send(payload);
     } else {
       queue.push(payload);
@@ -124,6 +127,9 @@ function createMethodQueue(checkInstanceReady, options) {
     }
     const instance = checkInstanceReady();
     if (instance) {
+      if (queue.length > 0) {
+        flush();
+      }
       const methodFunction = instance[method];
       if (typeof methodFunction === "function") {
         void methodFunction.apply(instance, args);

package/cart/buy-now-action.js

@@ -48,6 +48,11 @@ async function buyNowWithRecoveryAction(input) {
     };
   });
   if (checkoutProvider === "stripe") {
+    if (discountCodes.length > 0 || lineItems.some((lineItem) => Boolean(lineItem.sellingPlanId))) {
+      console.warn(
+        "[Replo] Stripe buy now does not support selling plans or discount codes; those options were ignored."
+      );
+    }
     const env = await getEnv();
     const temporaryCartId = input.checkoutAttemptId ?? uuidv4();
     const body = {

package/cart/cart-schema.d.ts

@@ -78,4 +78,83 @@ export declare const cartSchema: z.ZodObject<{
         country: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
+export declare const clientCartSchema: z.ZodObject<{
+    id: z.ZodString;
+    cost: z.ZodObject<{
+        subtotalAmount: z.ZodNumber;
+        totalAmount: z.ZodNumber;
+        currencyCode: z.ZodString;
+    }, z.core.$strip>;
+    checkoutUrl: z.ZodOptional<z.ZodString>;
+    discountCodes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        applicable: z.ZodBoolean;
+    }, z.core.$strip>>>;
+    discountAllocations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        discountedAmount: z.ZodNumber;
+        title: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>>;
+    buyerIdentity: z.ZodOptional<z.ZodObject<{
+        country: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    lines: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        quantity: z.ZodNumber;
+        attributes: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
+        }, z.core.$strip>>;
+        sellingPlanAllocation: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            sellingPlan: z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+                description: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>;
+            priceAdjustments: z.ZodArray<z.ZodObject<{
+                compareAtPrice: z.ZodObject<{
+                    amount: z.ZodNumber;
+                    currencyCode: z.ZodString;
+                }, z.core.$strip>;
+                perDeliveryPrice: z.ZodObject<{
+                    amount: z.ZodNumber;
+                    currencyCode: z.ZodString;
+                }, z.core.$strip>;
+                price: z.ZodObject<{
+                    amount: z.ZodNumber;
+                    currencyCode: z.ZodString;
+                }, z.core.$strip>;
+                unitPrice: z.ZodNullable<z.ZodObject<{
+                    amount: z.ZodNumber;
+                    currencyCode: z.ZodString;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+            checkoutChargeAmount: z.ZodObject<{
+                amount: z.ZodNumber;
+                currencyCode: z.ZodString;
+            }, z.core.$strip>;
+            remainingBalanceChargeAmount: z.ZodObject<{
+                amount: z.ZodNumber;
+                currencyCode: z.ZodString;
+            }, z.core.$strip>;
+        }, z.core.$strip>>>;
+        merchandise: z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            price: z.ZodNumber;
+            compareAtPrice: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            image: z.ZodNullable<z.ZodObject<{
+                url: z.ZodString;
+                altText: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>>;
+            selectedOptions: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                value: z.ZodString;
+            }, z.core.$strip>>;
+            product: z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+            }, z.core.$loose>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 export type Cart = z.infer<typeof cartSchema>;

package/cart/cart-schema.js

@@ -69,6 +69,16 @@ const cartSchema = z.object({
   discountAllocations: z.array(cartDiscountAllocationSchema).optional(),
   buyerIdentity: z.object({ country: z.string().nullable() }).optional()
 });
+const clientCartSchema = cartSchema.extend({
+  lines: z.array(
+    cartLineSchema.extend({
+      merchandise: cartLineMerchandiseSchema.extend({
+        product: cartLineMerchandiseSchema.shape.product.loose()
+      }).nullable()
+    })
+  )
+});
 export {
-  cartSchema
+  cartSchema,
+  clientCartSchema
 };

package/cart/hooks/use-buy-now.d.ts

@@ -1,3 +1,4 @@
+import type { CartLineAttribute } from "../cart-types";
 /**
  * What a `buyNow` call did. Out of stock is an expected storefront outcome
  * (a buyer can race the last unit), so it rides the return value rather than
@@ -17,11 +18,14 @@ export interface VariantBuyNowInfo {
     variantId: string;
     quantity?: number;
     sellingPlanId?: string | null;
+    /** Custom line item properties (appear on the order). */
+    properties?: CartLineAttribute[];
 }
 /**
  * React hook that returns a `buyNow` function for express checkout flows.
  * Handles creating the cart/checkout session server-side and redirecting
- * the browser to checkout.
+ * the browser to checkout. Stripe checkout ignores selling plans and discount
+ * codes, logging a server-side warning when either is supplied.
  *
  * @example
  *

package/cart/hooks/use-buy-now.js

@@ -32,7 +32,7 @@ function useBuyNow() {
           variantId: variant.variantId,
           quantity: variant.quantity ?? 1,
           sellingPlanId: variant.sellingPlanId ?? null,
-          properties: []
+          properties: variant.properties ?? []
         })),
         discountCodes: options?.discountCodes ?? [],
         pageUrl: window.location.href

package/cart/utils/cart-utils.js

@@ -66,7 +66,8 @@ function calculateCartTotals({
 }) {
   const lineItemSubtotal = calculateLineItemsSubtotal(lineItems);
   const compareAtSubtotal = lineItems.reduce((sum, item) => {
-    return sum + getCartLinePricing(item).compareAtPrice * item.quantity;
+    const { compareAtPrice, finalPrice } = getCartLinePricing(item);
+    return sum + Math.max(compareAtPrice, finalPrice) * item.quantity;
   }, 0);
   const total = cart?.cost.totalAmount ?? lineItemSubtotal;
   const discountAmount = (cart?.discountAllocations ?? []).reduce(

package/cart/utils/cookie-cart-persistence.js

@@ -1,10 +1,28 @@
 "use server";
 import { cookies } from "next/headers";
+import { parseJsonOrNull } from "../../_vendor/replo-utils/lib/json.mjs";
+import { CanopyError } from "../../lib/canopy-error";
+import { clientCartSchema } from "../cart-schema";
 import { getCartCookieOptions } from "../gateways/cart-constants";
 import { recalculateCartCost } from "./cart-utils";
+const MAX_CART_COOKIE_SIZE_BYTES = 3900;
+class CartCookieSizeError extends CanopyError {
+}
 async function saveCartToCookie(cart, cookieName) {
+  const serializedCart = JSON.stringify(cart);
+  const serializedSizeBytes = encodeURIComponent(serializedCart).length;
+  if (serializedSizeBytes > MAX_CART_COOKIE_SIZE_BYTES) {
+    throw new CartCookieSizeError({
+      message: `[Replo] ${cookieName} exceeds the browser cookie size limit; cart changes were not persisted.`,
+      additionalData: {
+        cookieName,
+        serializedSizeBytes,
+        maxSizeBytes: MAX_CART_COOKIE_SIZE_BYTES
+      }
+    });
+  }
   const cookieStore = await cookies();
-  cookieStore.set(cookieName, JSON.stringify(cart), getCartCookieOptions());
+  cookieStore.set(cookieName, serializedCart, getCartCookieOptions());
 }
 async function loadCartFromCookie(cookieName) {
   const cookieStore = await cookies();
@@ -12,13 +30,13 @@ async function loadCartFromCookie(cookieName) {
   if (!cartCookie?.value) {
     return null;
   }
-  try {
-    return JSON.parse(cartCookie.value);
-  } catch (error) {
-    console.warn("Failed to parse cart cookie:", error);
-    await clearCartCookie(cookieName);
-    return null;
+  const result = clientCartSchema.safeParse(parseJsonOrNull(cartCookie.value));
+  if (result.success) {
+    return result.data;
   }
+  console.warn("Failed to parse cart cookie:", result.error);
+  await clearCartCookie(cookieName);
+  return null;
 }
 async function clearCartCookie(cookieName) {
   const cookieStore = await cookies();

package/consent/consent-action.d.ts

@@ -1,5 +1,16 @@
 import type { ConsentAction } from "../_vendor/schemas/generated/consent";
 import type { ConsentCategories } from "./cookie";
+/**
+ * Pure mapping from a consent decision (previous state vs the resulting state)
+ * to the legal-record `action` written to the proof-of-consent audit log.
+ *
+ * Only non-necessary categories matter (`necessary` is always granted). The
+ * mapping is:
+ *   - first decision (`decidedAt === null`), some category granted -> "accept"
+ *   - first decision, nothing granted                            -> "reject"
+ *   - later decision moving from some consent to none            -> "withdraw"
+ *   - any other later change                                     -> "update"
+ */
 export declare function deriveConsentAction({ previous, next, }: {
     previous: {
         decidedAt: number | null;

package/consent/consent-action.js

@@ -1,23 +1,15 @@
-const NON_NECESSARY_CATEGORIES = [
-  "analytics",
-  "marketing",
-  "preferences",
-  "sale_of_data"
-];
+import { OPTIONAL_CONSENT_CATEGORIES } from "./consent-platform";
+function hasAnyGranted(categories) {
+  return OPTIONAL_CONSENT_CATEGORIES.some((category) => categories[category]);
+}
 function deriveConsentAction({
   previous,
   next
 }) {
-  const anyGranted = NON_NECESSARY_CATEGORIES.some(
-    (category) => next[category]
-  );
   if (previous.decidedAt === null) {
-    return anyGranted ? "accept" : "reject";
-  }
-  if (!anyGranted) {
-    return "withdraw";
+    return hasAnyGranted(next) ? "accept" : "reject";
   }
-  return "update";
+  return hasAnyGranted(previous.categories) && !hasAnyGranted(next) ? "withdraw" : "update";
 }
 export {
   deriveConsentAction

package/lib/buildMetadata.js

@@ -1,7 +1,7 @@
 export const BUILD_METADATA = {
   "packageName": "@replohq/sdk",
-  "version": "1.9.4",
+  "version": "1.10.0",
   "branch": "HEAD",
-  "commit": "aa07173168356fbdc7ade4a24770a38f85a887f6",
-  "builtAt": "2026-09-18T16:24:49.114Z"
+  "commit": "24c482167732242f8a358ac9f85c39183293880a",
+  "builtAt": "2026-09-18T23:32:34.853Z"
 };

package/loaders/kaching-bundles-loader.d.ts

@@ -0,0 +1,23 @@
+import type { ReactNode } from "react";
+import type { AddToCartItem } from "../cart/hooks/use-add-to-cart";
+type KachingBundlesLoaderProps = {
+    loaderKey: string;
+    productId: string;
+    dealBlockId?: string;
+    country?: string;
+    language?: string;
+    selectedVariantId?: string;
+    /**
+     * Rendered under Kaching's widget with the shopper's current pick. The lines
+     * are ready for `addToCart` and carry the Kaching line attributes that
+     * Checkout uses to apply the discount; they are empty until the shopper picks.
+     */
+    children: (bundle: {
+        lines: AddToCartItem[];
+    }) => ReactNode;
+    fallback?: ReactNode;
+    /** Rendered instead of the widget when Kaching has no active deal for this product. */
+    noDealFallback?: ReactNode;
+};
+export declare function KachingBundlesLoader({ loaderKey, productId, dealBlockId, country, language, selectedVariantId, children, fallback, noDealFallback, }: KachingBundlesLoaderProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/loaders/kaching-bundles-loader.js

@@ -0,0 +1,75 @@
+"use client";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { Suspense, useState } from "react";
+import { KachingBundle } from "@kachingappz/bundles-react";
+import { useSuspenseQuery } from "@tanstack/react-query";
+import { invokeLoader } from "./invoke-loader";
+import { LoaderErrorBoundary } from "./loader-error-boundary";
+import { shopifyKachingBundlesLoaderOutputSchema } from "./loader-schemas";
+function KachingBundlesLoaderInner({
+  loaderKey,
+  args,
+  selectedVariantId,
+  children,
+  noDealFallback
+}) {
+  const [lines, setLines] = useState([]);
+  const { data } = useSuspenseQuery({
+    queryKey: [loaderKey, args],
+    queryFn: async () => {
+      const loadedData = await invokeLoader({ loaderKey, args });
+      return shopifyKachingBundlesLoaderOutputSchema.parse(loadedData);
+    }
+  });
+  if (data.bundles === null) {
+    return /* @__PURE__ */ jsx(Fragment, { children: noDealFallback ?? null });
+  }
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx(
+      KachingBundle,
+      {
+        data: data.bundles,
+        selectedVariantId,
+        onLinesChange: (widgetLines) => {
+          setLines(
+            widgetLines.map((line) => ({
+              merchandiseId: line.merchandiseId,
+              quantity: line.quantity,
+              sellingPlanId: line.sellingPlanId ?? null,
+              properties: line.attributes
+            }))
+          );
+        }
+      }
+    ),
+    children({ lines })
+  ] });
+}
+function KachingBundlesLoader({
+  loaderKey,
+  productId,
+  dealBlockId,
+  country,
+  language,
+  selectedVariantId,
+  children,
+  fallback,
+  noDealFallback
+}) {
+  const args = { productId, dealBlockId, country, language };
+  const instanceKey = `${loaderKey}:${JSON.stringify(args)}`;
+  return /* @__PURE__ */ jsx(LoaderErrorBoundary, { fallback: fallback ?? null, resetKey: instanceKey, children: /* @__PURE__ */ jsx(Suspense, { fallback: fallback ?? null, children: /* @__PURE__ */ jsx(
+    KachingBundlesLoaderInner,
+    {
+      loaderKey,
+      args,
+      selectedVariantId,
+      noDealFallback,
+      children
+    },
+    instanceKey
+  ) }) });
+}
+export {
+  KachingBundlesLoader
+};

package/loaders/loader-keys.d.ts

@@ -15,6 +15,7 @@ export declare const DATA_LOADER_KEYS: {
     readonly SHOPIFY_COLLECTION_PRODUCTS: "shopify_storefront.collection_products";
     readonly SHOPIFY_METAOBJECT: "shopify_storefront.metaobject";
     readonly SHOPIFY_METAOBJECTS: "shopify_storefront.metaobjects";
+    readonly SHOPIFY_KACHING_BUNDLES: "shopify_storefront.kaching_bundles";
     readonly REPLO_PRODUCT: "replo_products.product";
     readonly OKENDO_PRODUCT_REVIEWS: "okendo.product_reviews";
     readonly OKENDO_PRODUCT_REVIEW_AGGREGATE: "okendo.product_review_aggregate";

package/loaders/loader-keys.js

@@ -4,6 +4,7 @@ const DATA_LOADER_KEYS = {
   SHOPIFY_COLLECTION_PRODUCTS: "shopify_storefront.collection_products",
   SHOPIFY_METAOBJECT: "shopify_storefront.metaobject",
   SHOPIFY_METAOBJECTS: "shopify_storefront.metaobjects",
+  SHOPIFY_KACHING_BUNDLES: "shopify_storefront.kaching_bundles",
   REPLO_PRODUCT: "replo_products.product",
   OKENDO_PRODUCT_REVIEWS: "okendo.product_reviews",
   OKENDO_PRODUCT_REVIEW_AGGREGATE: "okendo.product_review_aggregate",

package/loaders/loader-schemas.d.ts

@@ -1011,6 +1011,10 @@ export declare const shopifyMetaobjectsLoaderOutputSchema: z.ZodObject<{
         endCursor: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>;
+export declare const shopifyKachingBundlesLoaderOutputSchema: z.ZodObject<{
+    bundles: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type ShopifyKachingBundlesLoaderOutput = z.infer<typeof shopifyKachingBundlesLoaderOutputSchema>;
 export type StorefrontMetaobject = z.infer<typeof storefrontMetaobjectSchema>;
 export type ShopifyMetaobjectLoaderOutput = z.infer<typeof shopifyMetaobjectLoaderOutputSchema>;
 export type ShopifyMetaobjectsLoaderOutput = z.infer<typeof shopifyMetaobjectsLoaderOutputSchema>;

package/loaders/loader-schemas.js

@@ -347,6 +347,9 @@ const shopifyMetaobjectsLoaderOutputSchema = z.object({
     endCursor: z.string().nullable()
   })
 }).describe("ShopifyMetaobjectsLoaderOutput");
+const shopifyKachingBundlesLoaderOutputSchema = z.object({
+  bundles: z.record(z.string(), z.unknown()).nullable()
+}).describe("ShopifyKachingBundles");
 export {
   contentfulAssetObjectSchema,
   contentfulEntriesLoaderOutputSchema,
@@ -385,6 +388,7 @@ export {
   sellingPlanOptionValueSchema,
   sellingPlanPriceAdjustmentSchema,
   sellingPlanSchema,
+  shopifyKachingBundlesLoaderOutputSchema,
   shopifyMetaobjectLoaderOutputSchema,
   shopifyMetaobjectsLoaderOutputSchema,
   statsigExperimentLoaderOutputSchema,

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@replohq/sdk",
-  "version": "1.9.4",
+  "version": "1.10.0",
   "reploBuild": {
     "packageName": "@replohq/sdk",
-    "version": "1.9.4",
+    "version": "1.10.0",
     "branch": "HEAD",
-    "commit": "aa07173168356fbdc7ade4a24770a38f85a887f6",
-    "builtAt": "2026-09-18T16:24:49.114Z"
+    "commit": "24c482167732242f8a358ac9f85c39183293880a",
+    "builtAt": "2026-09-18T23:32:34.853Z"
   },
   "description": "Replo SDK — cart, analytics, and data loaders for agent-built Next.js sites.",
   "license": "SEE LICENSE IN LICENSE",
@@ -117,6 +117,10 @@
       "types": "./loaders/judgeme-reviews-loader.d.ts",
       "default": "./loaders/judgeme-reviews-loader.js"
     },
+    "./loaders/kaching-bundles-loader": {
+      "types": "./loaders/kaching-bundles-loader.d.ts",
+      "default": "./loaders/kaching-bundles-loader.js"
+    },
     "./loaders/levanta-product-loader": {
       "types": "./loaders/levanta-product-loader.d.ts",
       "default": "./loaders/levanta-product-loader.js"
@@ -269,6 +273,7 @@
   },
   "dependencies": {
     "@formatjs/intl-localematcher": "^0.8.13",
+    "@kachingappz/bundles-react": "0.5.3",
     "negotiator": "^1.0.0",
     "react-markdown": "^9.1.0",
     "remark-gfm": "^4.0.1",