@replohq/sdk 1.9.5 → 1.10.0

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/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,6 +18,8 @@ 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.

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/lib/buildMetadata.js

@@ -1,7 +1,7 @@
 export const BUILD_METADATA = {
   "packageName": "@replohq/sdk",
-  "version": "1.9.5",
+  "version": "1.10.0",
   "branch": "HEAD",
-  "commit": "0a035b21ce1b041469758df14644035659d54252",
-  "builtAt": "2026-09-18T18:40:51.491Z"
+  "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.5",
+  "version": "1.10.0",
   "reploBuild": {
     "packageName": "@replohq/sdk",
-    "version": "1.9.5",
+    "version": "1.10.0",
     "branch": "HEAD",
-    "commit": "0a035b21ce1b041469758df14644035659d54252",
-    "builtAt": "2026-09-18T18:40:51.491Z"
+    "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",