@replohq/sdk 1.9.1 → 1.9.2

package/_vendor/schemas/generated/storefrontCountryCode.d.ts

@@ -0,0 +1,10 @@
+export type StorefrontCountryCode = "AC" | "AD" | "AE" | "AF" | "AG" | "AI" | "AL" | "AM" | "AN" | "AO" | "AR" | "AT" | "AU" | "AW" | "AX" | "AZ" | "BA" | "BB" | "BD" | "BE" | "BF" | "BG" | "BH" | "BI" | "BJ" | "BL" | "BM" | "BN" | "BO" | "BQ" | "BR" | "BS" | "BT" | "BV" | "BW" | "BY" | "BZ" | "CA" | "CC" | "CD" | "CF" | "CG" | "CH" | "CI" | "CK" | "CL" | "CM" | "CN" | "CO" | "CR" | "CU" | "CV" | "CW" | "CX" | "CY" | "CZ" | "DE" | "DJ" | "DK" | "DM" | "DO" | "DZ" | "EC" | "EE" | "EG" | "EH" | "ER" | "ES" | "ET" | "FI" | "FJ" | "FK" | "FO" | "FR" | "GA" | "GB" | "GD" | "GE" | "GF" | "GG" | "GH" | "GI" | "GL" | "GM" | "GN" | "GP" | "GQ" | "GR" | "GS" | "GT" | "GW" | "GY" | "HK" | "HM" | "HN" | "HR" | "HT" | "HU" | "ID" | "IE" | "IL" | "IM" | "IN" | "IO" | "IQ" | "IR" | "IS" | "IT" | "JE" | "JM" | "JO" | "JP" | "KE" | "KG" | "KH" | "KI" | "KM" | "KN" | "KP" | "KR" | "KW" | "KY" | "KZ" | "LA" | "LB" | "LC" | "LI" | "LK" | "LR" | "LS" | "LT" | "LU" | "LV" | "LY" | "MA" | "MC" | "MD" | "ME" | "MF" | "MG" | "MK" | "ML" | "MM" | "MN" | "MO" | "MQ" | "MR" | "MS" | "MT" | "MU" | "MV" | "MW" | "MX" | "MY" | "MZ" | "NA" | "NC" | "NE" | "NF" | "NG" | "NI" | "NL" | "NO" | "NP" | "NR" | "NU" | "NZ" | "OM" | "PA" | "PE" | "PF" | "PG" | "PH" | "PK" | "PL" | "PM" | "PN" | "PS" | "PT" | "PY" | "QA" | "RE" | "RO" | "RS" | "RU" | "RW" | "SA" | "SB" | "SC" | "SD" | "SE" | "SG" | "SH" | "SI" | "SJ" | "SK" | "SL" | "SM" | "SN" | "SO" | "SR" | "SS" | "ST" | "SV" | "SX" | "SY" | "SZ" | "TA" | "TC" | "TD" | "TF" | "TG" | "TH" | "TJ" | "TK" | "TL" | "TM" | "TN" | "TO" | "TR" | "TT" | "TV" | "TW" | "TZ" | "UA" | "UG" | "UM" | "US" | "UY" | "UZ" | "VA" | "VC" | "VE" | "VG" | "VN" | "VU" | "WF" | "WS" | "XK" | "YE" | "YT" | "ZA" | "ZM" | "ZW" | "ZZ";
+export type ShopifyMarket = {
+    country?: StorefrontCountryCode;
+};
+export type Markets = {
+    shopify?: Partial<ShopifyMarket>;
+};
+export type CartBuyerIdentity = {
+    country: StorefrontCountryCode;
+};

package/_vendor/schemas/routing/locale.d.ts

@@ -21,8 +21,8 @@ export declare const localeRoutingConfigSchema: z.ZodObject<{
     locales: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
     defaultLocale: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
     detection: z.ZodDefault<z.ZodEnum<{
-        language: "language";
         country: "country";
+        language: "language";
     }>>;
     urlMode: z.ZodDefault<z.ZodEnum<{
         prefixed: "prefixed";

package/cart/buy-now-action.d.ts

@@ -1,3 +1,4 @@
+import type { StorefrontCountryCode } from "../loaders/markets";
 import type { CartLineAttribute } from "./cart-types";
 /**
  * Server action that handles the full buy-now flow:
@@ -19,6 +20,7 @@ export declare function buyNowAction(input: Parameters<typeof buyNowWithRecovery
 }>;
 export declare function buyNowWithRecoveryAction(input: {
     checkoutAttemptId?: string;
+    country?: StorefrontCountryCode;
     lineItems: {
         variantId: string;
         quantity: number;

package/cart/buy-now-action.js

@@ -114,6 +114,7 @@ async function buyNowWithRecoveryAction(input) {
   const cart = await createCartAction({
     lines: cartLines,
     skipStoringCart: true,
+    country: input.country,
     discountCodes: discountCodes.length > 0 ? discountCodes : void 0
   });
   if (!cart?.checkoutUrl) {

package/cart/cart-actions.d.ts

@@ -1,3 +1,4 @@
+import type { StorefrontCountryCode } from "../loaders/markets";
 import type { AddToCartPayload, Cart, CartLinePayload, RemoveFromCartPayload, UpdateCartLineItemPayload } from "./cart-types";
 /**
  * Gets the existing cart or creates a new one if none exists. This is necessary
@@ -7,7 +8,9 @@ import type { AddToCartPayload, Cart, CartLinePayload, RemoveFromCartPayload, Up
  *
  * @returns The existing cart or a newly created cart
  */
-export declare function getOrCreateCartAction(): Promise<Cart | null>;
+export declare function getOrCreateCartAction(options?: {
+    country?: StorefrontCountryCode;
+}): Promise<Cart | null>;
 /**
  * Retrieves the current cart from cookies. Returns null if no cart exists or
  * if the cart has expired/been deleted.
@@ -28,6 +31,7 @@ export declare function createCartAction(options?: {
     lines?: CartLinePayload[];
     skipStoringCart?: boolean;
     discountCodes?: string[];
+    country?: StorefrontCountryCode;
 }): Promise<Cart | null>;
 /**
  * Adds line items to an existing cart.

package/cart/cart-actions.js

@@ -11,13 +11,20 @@ import {
   saveCartToCookie
 } from "./utils/cookie-cart-persistence";
 const SHOPIFY_CART_COOKIE_NAME = "replo_cart_id";
-async function getOrCreateCartAction() {
+async function getOrCreateCartAction(options) {
   const existingCart = await getCartAction();
   if (existingCart) {
     const cartGateway = await getCartGateway();
-    return await cartGateway.reconcileStoredCart(existingCart);
+    const reconciledCart = await cartGateway.reconcileStoredCart(existingCart);
+    if (options?.country && reconciledCart.buyerIdentity?.country !== options.country) {
+      return await cartGateway.updateCartBuyerIdentity({
+        cartId: reconciledCart.id,
+        buyerIdentity: { country: options.country }
+      });
+    }
+    return reconciledCart;
   }
-  return await createCartAction();
+  return await createCartAction({ country: options?.country });
 }
 async function getCartAction() {
   const checkoutProvider = await getCheckoutProvider();
@@ -44,10 +51,19 @@ async function getCartAction() {
   return cart;
 }
 async function createCartAction(options) {
-  const { lines, skipStoringCart = false, discountCodes } = options ?? {};
+  const {
+    lines,
+    skipStoringCart = false,
+    discountCodes,
+    country
+  } = options ?? {};
   const checkoutProvider = await getCheckoutProvider();
   const cartGateway = await getCartGateway();
-  const cart = await cartGateway.createCart(lines, discountCodes);
+  const cart = await cartGateway.createCart({
+    lines,
+    discountCodes,
+    buyerIdentity: country ? { country } : void 0
+  });
   if (cart && !skipStoringCart) {
     try {
       if (checkoutProvider === "stripe") {

package/cart/cart-country-context.d.ts

@@ -0,0 +1,2 @@
+import type { StorefrontCountryCode } from "../loaders/markets";
+export declare const CartCountryContext: import("react").Context<StorefrontCountryCode | undefined>;

package/cart/cart-country-context.js

@@ -0,0 +1,6 @@
+"use client";
+import { createContext } from "react";
+const CartCountryContext = createContext(void 0);
+export {
+  CartCountryContext
+};

package/cart/cart-loader.d.ts

@@ -1,3 +1,4 @@
+import type { StorefrontCountryCode } from "../loaders/markets";
 /**
  * Server component that loads the cart and provides it to child components
  * through the CartProvider context. In development mode, skips initial
@@ -6,4 +7,6 @@
  * @param children - Child components that will have access to the cart
  * @returns A CartProvider component wrapping the children with cart data
  */
-export declare function CartLoader({ children }: React.PropsWithChildren): Promise<import("react/jsx-runtime").JSX.Element>;
+export declare function CartLoader({ children, country, }: React.PropsWithChildren<{
+    country?: StorefrontCountryCode;
+}>): Promise<import("react/jsx-runtime").JSX.Element>;

package/cart/cart-loader.js

@@ -2,13 +2,16 @@ import { jsx } from "react/jsx-runtime";
 import { unstable_rethrow } from "next/navigation";
 import { getCartAction } from "./cart-actions";
 import { CartProvider } from "./cart-provider";
-async function CartLoader({ children }) {
+async function CartLoader({
+  children,
+  country
+}) {
   const cart = process.env.NODE_ENV === "development" ? null : await getCartAction().catch((error) => {
     unstable_rethrow(error);
     console.warn("[Replo] Failed to load cart:", error);
     return null;
   });
-  return /* @__PURE__ */ jsx(CartProvider, { cart, children });
+  return /* @__PURE__ */ jsx(CartProvider, { cart, country, children });
 }
 export {
   CartLoader

package/cart/cart-provider.d.ts

@@ -1,3 +1,4 @@
+import type { StorefrontCountryCode } from "../loaders/markets";
 import type { Cart, CartLine, CartLineAdjustment, CartLinePayload } from "./cart-types";
 import React from "react";
 export type CartOperation = "add" | "update" | "remove" | "discount";
@@ -93,9 +94,10 @@ export interface CartContextType {
  *
  * @returns A context provider wrapping the children with cart functionality
  */
-export declare function CartProvider({ children, cart, }: React.PropsWithChildren<{
+export declare function CartProvider({ children, cart, country, }: React.PropsWithChildren<{
     /** Initial cart data from the server (can be null) */
     cart: Cart | null;
+    country?: StorefrontCountryCode;
 }>): import("react/jsx-runtime").JSX.Element;
 /**
  * @deprecated For internal use only. Use useAddToCart or useBuyNow

package/cart/cart-provider.js

@@ -12,6 +12,7 @@ import {
   updateCartDiscountCodesAction,
   updateCartLineItemAction
 } from "./cart-actions";
+import { CartCountryContext } from "./cart-country-context";
 import {
   deriveAddToCartAdjustments,
   deriveUpdateCartAdjustments
@@ -24,18 +25,27 @@ import { CartContextError, toCartError } from "./utils/cart-error";
 import { recalculateCartCost } from "./utils/cart-utils";
 import { createOptimisticSellingPlanAllocation } from "./utils/variant-to-cart-line";
 let cartCreationPromise = null;
-function getOrCreateSharedCart() {
-  cartCreationPromise ??= getOrCreateCartAction().then((cart) => {
+let cartCreationCountry;
+function getOrCreateSharedCart(country) {
+  if (cartCreationPromise && cartCreationCountry === country) {
+    return cartCreationPromise;
+  }
+  const previousCreation = cartCreationPromise;
+  const creation = (async () => {
+    if (previousCreation) await previousCreation.catch(() => null);
+    const cart = await getOrCreateCartAction({ country });
     if (!cart) {
       throw new CartContextError({
         message: "Your cart could not be loaded. Please try again."
       });
     }
     return cart;
-  }).finally(() => {
-    cartCreationPromise = null;
+  })().finally(() => {
+    if (cartCreationPromise === creation) cartCreationPromise = null;
   });
-  return cartCreationPromise;
+  cartCreationCountry = country;
+  cartCreationPromise = creation;
+  return creation;
 }
 function addLineToCart({
   cart,
@@ -84,7 +94,8 @@ const CartContext = React.createContext(
 );
 function CartProvider({
   children,
-  cart
+  cart,
+  country
 }) {
   const [cartData, setCartData] = React.useState(cart);
   const optimisticCart = React.useRef(cart);
@@ -101,6 +112,10 @@ function CartProvider({
   const [error, setError] = React.useState(null);
   const clearError = React.useCallback(() => setError(null), []);
   const isMounted = React.useRef(true);
+  const marketSelection = React.useRef({ country });
+  if (marketSelection.current.country !== country) {
+    marketSelection.current = { country };
+  }
   const runWithErrorState = async (operation, mutate) => {
     setError(null);
     try {
@@ -175,18 +190,22 @@ function CartProvider({
     });
   };
   const initializeCart = React.useCallback(async () => {
-    const loadedCart = await getOrCreateSharedCart();
-    if (!isMounted.current) {
-      throw new DOMException("Cart provider was unmounted", "AbortError");
+    const selection = marketSelection.current;
+    const loadedCart = await getOrCreateSharedCart(country);
+    if (!isMounted.current || marketSelection.current !== selection) {
+      throw new DOMException(
+        "Cart initialization was superseded",
+        "AbortError"
+      );
     }
     serverCart.current = loadedCart;
     if (pendingMutations.current === 0) updateCartData(loadedCart);
     return loadedCart;
-  }, [updateCartData]);
+  }, [country, updateCartData]);
   React.useEffect(() => {
     isMounted.current = true;
     void initializeCart().catch((error2) => {
-      if (isMounted.current) {
+      if (isMounted.current && !(error2 instanceof DOMException && error2.name === "AbortError")) {
         console.error("[Replo] Error getting or creating cart:", error2);
       }
     });
@@ -400,7 +419,8 @@ function CartProvider({
     const cart2 = await createCartAction({
       lines,
       skipStoringCart: true,
-      discountCodes
+      discountCodes,
+      country
     });
     if (cart2) {
       return cart2;
@@ -412,7 +432,7 @@ function CartProvider({
     }
   };
   const checkoutUrl = cartData?.checkoutUrl ?? "/";
-  return /* @__PURE__ */ jsx(
+  return /* @__PURE__ */ jsx(CartCountryContext.Provider, { value: country, children: /* @__PURE__ */ jsx(
     CartContext.Provider,
     {
       value: {
@@ -436,7 +456,7 @@ function CartProvider({
       },
       children
     }
-  );
+  ) });
 }
 function useCartInternal() {
   const context = React.useContext(CartContext);

package/cart/cart-schema.d.ts

@@ -74,5 +74,8 @@ export declare const cartSchema: 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>>;
 }, z.core.$strip>;
 export type Cart = z.infer<typeof cartSchema>;

package/cart/cart-schema.js

@@ -66,7 +66,8 @@ const cartSchema = z.object({
   cost: cartCostSchema,
   checkoutUrl: z.string().optional(),
   discountCodes: z.array(cartDiscountCodeSchema).optional(),
-  discountAllocations: z.array(cartDiscountAllocationSchema).optional()
+  discountAllocations: z.array(cartDiscountAllocationSchema).optional(),
+  buyerIdentity: z.object({ country: z.string().nullable() }).optional()
 });
 export {
   cartSchema

package/cart/cart-types.d.ts

@@ -3,6 +3,7 @@
  * @module
  */
 import type { SellingPlanGroup } from "../loaders/loader-schemas";
+import type { StorefrontCountryCode } from "../loaders/markets";
 export interface Image {
     url: string;
     altText: string | null;
@@ -118,6 +119,14 @@ export interface Cart {
     checkoutUrl?: string;
     discountCodes?: CartDiscountCode[];
     discountAllocations?: CartDiscountAllocation[];
+    /**
+     * The market Shopify has the cart in. Shopify prices `cost` and the checkout
+     * from this, not from the catalog country the product loaders pass, so it is
+     * what tells a market site whether the cart already matches the page.
+     */
+    buyerIdentity?: {
+        country: string | null;
+    };
 }
 /**
  * How a cart write differed from what the shopper asked for, derived by
@@ -157,3 +166,6 @@ export interface UpdateCartDiscountCodesPayload {
     cartId: string;
     discountCodes: string[];
 }
+export interface CartBuyerIdentity {
+    country: StorefrontCountryCode;
+}

package/cart/gateways/cart-gateway.d.ts

@@ -1,4 +1,4 @@
-import type { AddToCartPayload, Cart, CartLinePayload, RemoveFromCartPayload, UpdateCartDiscountCodesPayload, UpdateCartLineItemPayload } from "../cart-types";
+import type { AddToCartPayload, Cart, CartBuyerIdentity, CartLinePayload, RemoveFromCartPayload, UpdateCartDiscountCodesPayload, UpdateCartLineItemPayload } from "../cart-types";
 export interface CartGateway {
     getCart(cartId: string): Promise<Cart | null>;
     /**
@@ -8,8 +8,16 @@ export interface CartGateway {
      * cart unchanged.
      */
     reconcileStoredCart(cart: Cart): Promise<Cart>;
-    createCart(lines?: CartLinePayload[], discountCodes?: string[]): Promise<Cart | null>;
+    createCart(options?: {
+        lines?: CartLinePayload[];
+        discountCodes?: string[];
+        buyerIdentity?: CartBuyerIdentity;
+    }): Promise<Cart | null>;
     addToCart(cartPayload: AddToCartPayload): Promise<Cart | null>;
+    updateCartBuyerIdentity(payload: {
+        cartId: string;
+        buyerIdentity: CartBuyerIdentity;
+    }): Promise<Cart | null>;
     updateCartLineItem(cartPayload: UpdateCartLineItemPayload): Promise<Cart | null>;
     removeCartLineItems(cartPayload: RemoveFromCartPayload): Promise<Cart | null>;
     updateCartDiscountCodes(cartPayload: UpdateCartDiscountCodesPayload): Promise<Cart | null>;

package/cart/gateways/cookie-cart-gateway.d.ts

@@ -1,5 +1,5 @@
 import type { ReconciledCartLine } from "../../gateways/canopy-api";
-import type { AddToCartPayload, Cart, CartLinePayload, RemoveFromCartPayload, UpdateCartDiscountCodesPayload, UpdateCartLineItemPayload } from "../cart-types";
+import type { AddToCartPayload, Cart, CartBuyerIdentity, CartLinePayload, RemoveFromCartPayload, UpdateCartDiscountCodesPayload, UpdateCartLineItemPayload } from "../cart-types";
 import type { LineMergeFn } from "../utils/cookie-cart-persistence";
 import type { CartGateway } from "./cart-gateway";
 /**
@@ -28,10 +28,18 @@ export declare abstract class CookieBasedCartGateway implements CartGateway {
     private reconcileForWrite;
     reconcileStoredCart(cart: Cart): Promise<Cart>;
     getCart(cartId: string): Promise<Cart | null>;
-    createCart(lines?: CartLinePayload[], _discountCodes?: string[]): Promise<Cart | null>;
+    createCart({ lines, }?: {
+        lines?: CartLinePayload[];
+        discountCodes?: string[];
+        buyerIdentity?: CartBuyerIdentity;
+    }): Promise<Cart | null>;
     addToCart(cartPayload: AddToCartPayload): Promise<Cart | null>;
     updateCartLineItem(cartPayload: UpdateCartLineItemPayload): Promise<Cart | null>;
     removeCartLineItems(cartPayload: RemoveFromCartPayload): Promise<Cart | null>;
     updateCartDiscountCodes(cartPayload: UpdateCartDiscountCodesPayload): Promise<Cart | null>;
+    updateCartBuyerIdentity({ cartId, }: {
+        cartId: string;
+        buyerIdentity: CartBuyerIdentity;
+    }): Promise<Cart | null>;
 }
 export {};

package/cart/gateways/cookie-cart-gateway.js

@@ -62,7 +62,9 @@ class CookieBasedCartGateway {
       return null;
     }
   }
-  async createCart(lines, _discountCodes) {
+  async createCart({
+    lines
+  } = {}) {
     try {
       const cart = await createCartWithPersistence({
         cookieName: this.config.cookieName,
@@ -149,6 +151,11 @@ class CookieBasedCartGateway {
       return null;
     }
   }
+  async updateCartBuyerIdentity({
+    cartId
+  }) {
+    return this.getCart(cartId);
+  }
 }
 export {
   CookieBasedCartGateway

package/cart/gateways/resolver-cart-gateway.js

@@ -8,7 +8,11 @@ class ResolverCartGateway {
     const gateway = await getCanopyApiGateway();
     return await gateway.cartGet({ cartId });
   }
-  async createCart(lines, discountCodes) {
+  async createCart({
+    lines,
+    discountCodes,
+    buyerIdentity
+  } = {}) {
     try {
       const gateway = await getCanopyApiGateway();
       return await gateway.cartCreate({
@@ -21,7 +25,8 @@ class ResolverCartGateway {
           })),
           sellingPlanId: line.sellingPlanId
         })),
-        discountCodes
+        discountCodes,
+        country: buyerIdentity?.country
       });
     } catch (error) {
       console.warn("Failed to create cart via canopy-api:", error);
@@ -94,6 +99,24 @@ class ResolverCartGateway {
       return null;
     }
   }
+  async updateCartBuyerIdentity({
+    cartId,
+    buyerIdentity
+  }) {
+    try {
+      const gateway = await getCanopyApiGateway();
+      return await gateway.cartUpdateBuyerIdentity({
+        cartId,
+        country: buyerIdentity.country
+      });
+    } catch (error) {
+      console.warn(
+        "Failed to update cart buyer identity via canopy-api:",
+        error
+      );
+      return null;
+    }
+  }
 }
 async function createResolverCartGateway() {
   return new ResolverCartGateway();

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

@@ -4,6 +4,7 @@ import { useClientValue } from "../../hooks/use-client-value";
 import { CanopyError } from "../../lib/canopy-error";
 import { navigateExternal } from "../../lib/external-navigation";
 import { buyNowWithRecoveryAction } from "../buy-now-action";
+import { CartCountryContext } from "../cart-country-context";
 const REPLO_LOCAL_STORAGE_SESSION_KEY = "_replo_sid";
 const REPLO_SESSION_ID_KEY = "rsid";
 const REPLO_CLIENT_ID_KEY = "rclid";
@@ -13,6 +14,7 @@ class CheckoutAttemptError extends CanopyError {
 }
 const checkoutAttempts = /* @__PURE__ */ new Map();
 function useBuyNow() {
+  const country = React.useContext(CartCountryContext);
   const reploSessionString = useClientValue(
     () => localStorage.getItem(REPLO_LOCAL_STORAGE_SESSION_KEY),
     null
@@ -25,6 +27,7 @@ function useBuyNow() {
         });
       }
       const checkoutInput = {
+        country,
         lineItems: variants.map((variant) => ({
           variantId: variant.variantId,
           quantity: variant.quantity ?? 1,
@@ -82,7 +85,7 @@ function useBuyNow() {
       navigateExternal(url.toString());
       return { result: "redirected" };
     },
-    [reploSessionString]
+    [reploSessionString, country]
   );
   return { buyNow };
 }

package/gateways/canopy-api.d.ts

@@ -1,4 +1,5 @@
 import type { Cart } from "../cart/cart-schema";
+import type { StorefrontCountryCode } from "../loaders/markets";
 import { z } from "zod";
 import { CanopyError } from "../lib/canopy-error";
 type CanopyApiGatewayErrorConfig = {
@@ -71,6 +72,7 @@ declare class CanopyApiGateway {
             sellingPlanId?: string | null;
         }[];
         discountCodes?: string[];
+        country?: StorefrontCountryCode;
     }): Promise<Cart>;
     cartAddLines({ cartId, lines, }: {
         cartId: string;
@@ -104,6 +106,10 @@ declare class CanopyApiGateway {
         cartId: string;
         discountCodes: string[];
     }): Promise<Cart>;
+    cartUpdateBuyerIdentity({ cartId, country, }: {
+        cartId: string;
+        country: StorefrontCountryCode;
+    }): Promise<Cart>;
 }
 export declare function getCanopyApiGateway(): Promise<CanopyApiGateway>;
 export {};

package/gateways/canopy-api.js

@@ -194,7 +194,8 @@ If you're running locally, make sure the canopy-api cloudflare worker is running
   async cartCreate(options) {
     return this._cartPost("/create", {
       lines: options?.lines,
-      discountCodes: options?.discountCodes
+      discountCodes: options?.discountCodes,
+      country: options?.country
     });
   }
   async cartAddLines({
@@ -221,6 +222,12 @@ If you're running locally, make sure the canopy-api cloudflare worker is running
   }) {
     return this._cartPost("/update-discount-codes", { cartId, discountCodes });
   }
+  async cartUpdateBuyerIdentity({
+    cartId,
+    country
+  }) {
+    return this._cartPost("/update-buyer-identity", { cartId, country });
+  }
 }
 async function getCanopyApiGateway() {
   return CanopyApiGateway.setup();

package/lib/buildMetadata.js

@@ -1,7 +1,7 @@
 export const BUILD_METADATA = {
   "packageName": "@replohq/sdk",
-  "version": "1.9.1",
+  "version": "1.9.2",
   "branch": "HEAD",
-  "commit": "dadbeffde02243998e85250ba4b2a21565c0b804",
-  "builtAt": "2026-09-17T18:18:44.111Z"
+  "commit": "b00423087f2b01a9cc8fb4700d453161b9ec846c",
+  "builtAt": "2026-09-17T18:32:43.736Z"
 };

package/loaders/collection-loader-args.d.ts

@@ -1,8 +1,9 @@
+import type { StorefrontCountryCode } from "./markets";
 export type CollectionLoaderArgs = {
     handle?: string;
     collectionGid?: string;
     language?: string;
-    country?: string;
+    country?: StorefrontCountryCode;
 };
 /**
  * Builds the single object used as BOTH the React Query key and the loader

package/loaders/collection-products-loader-args.d.ts

@@ -1,9 +1,10 @@
+import type { StorefrontCountryCode } from "./markets";
 export type CollectionProductsLoaderArgs = {
     collectionGid: string;
     first?: number;
     after?: string;
     language?: string;
-    country?: string;
+    country?: StorefrontCountryCode;
 };
 /**
  * Builds the single object used as BOTH the React Query key and the loader

package/loaders/markets.d.ts

@@ -0,0 +1 @@
+export type { Markets, ShopifyMarket, StorefrontCountryCode, } from "../_vendor/schemas/generated/storefrontCountryCode";

package/loaders/product-loader-args.d.ts

@@ -1,3 +1,4 @@
+import type { StorefrontCountryCode } from "./markets";
 export type MetafieldIdentifier = {
     namespace: string;
     key: string;
@@ -8,7 +9,7 @@ export type ProductLoaderArgs = {
     productMetafieldIdentifiers?: MetafieldIdentifier[];
     variantMetafieldIdentifiers?: MetafieldIdentifier[];
     language?: string;
-    country?: string;
+    country?: StorefrontCountryCode;
 };
 /**
  * Builds the single object used as BOTH the React Query key and the loader

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@replohq/sdk",
-  "version": "1.9.1",
+  "version": "1.9.2",
   "reploBuild": {
     "packageName": "@replohq/sdk",
-    "version": "1.9.1",
+    "version": "1.9.2",
     "branch": "HEAD",
-    "commit": "dadbeffde02243998e85250ba4b2a21565c0b804",
-    "builtAt": "2026-09-17T18:18:44.111Z"
+    "commit": "b00423087f2b01a9cc8fb4700d453161b9ec846c",
+    "builtAt": "2026-09-17T18:32:43.736Z"
   },
   "description": "Replo SDK — cart, analytics, and data loaders for agent-built Next.js sites.",
   "license": "SEE LICENSE IN LICENSE",
@@ -213,6 +213,10 @@
       "types": "./loaders/collection-products-loader-args.d.ts",
       "default": "./loaders/collection-products-loader-args.js"
     },
+    "./loaders/markets": {
+      "types": "./loaders/markets.d.ts",
+      "default": "./loaders/markets.js"
+    },
     "./orders/order-status": {
       "types": "./orders/order-status.d.ts",
       "default": "./orders/order-status.js"

package/providers/replo-provider.d.ts

@@ -1,3 +1,4 @@
+import type { Markets } from "../loaders/markets";
 /**
  * Root provider for a Replo site. Mount it once in `app/layout.tsx`, wrapping
  * the whole app. It sets up the React Query client every data loader reads
@@ -17,4 +18,7 @@
  * }
  * ```
  */
-export declare function ReploProvider({ children }: React.PropsWithChildren): Promise<import("react/jsx-runtime").JSX.Element>;
+export declare function ReploProvider({ children, markets, }: React.PropsWithChildren<{
+    /** Nested so Shopify and later Replo-product markets do not share one `country`. */
+    markets?: Markets;
+}>): Promise<import("react/jsx-runtime").JSX.Element>;

package/providers/replo-provider.js

@@ -6,7 +6,10 @@ import { getCheckoutProvider } from "../lib/integration-utils";
 import { LoaderErrorDetailsProvider } from "../loaders/loader-error-boundary";
 import { shouldShowLoaderErrorDetails } from "../loaders/loader-error-details";
 import { QueryProvider } from "./query-provider";
-async function ReploProvider({ children }) {
+async function ReploProvider({
+  children,
+  markets
+}) {
   let checkoutProvider = "none";
   try {
     checkoutProvider = await getCheckoutProvider();
@@ -15,7 +18,7 @@ async function ReploProvider({ children }) {
   }
   return /* @__PURE__ */ jsx(QueryProvider, { children: /* @__PURE__ */ jsx(LoaderErrorDetailsProvider, { enabled: shouldShowLoaderErrorDetails(), children: /* @__PURE__ */ jsxs(AnalyticsProvider, { checkoutProvider, children: [
     /* @__PURE__ */ jsx(ReploFirstPartyPixel, {}),
-    /* @__PURE__ */ jsx(CartLoader, { children })
+    /* @__PURE__ */ jsx(CartLoader, { country: markets?.shopify?.country, children })
   ] }) }) });
 }
 export {