@brainerce/mcp-server 3.5.0 → 3.5.1

package/dist/bin/http.js

@@ -95,7 +95,7 @@ npm install brainerce
 import { BrainerceClient } from 'brainerce';
 
 export const client = new BrainerceClient({
-  connectionId: '${connectionId}',
+  salesChannelId: '${connectionId}',
 });
 
 // Cart helpers \u2014 save cart ID to localStorage
@@ -197,7 +197,7 @@ async function startCheckout() {
 ### Full Checkout Flow (Multi-Provider)
 
 1. Customer fills cart
-2. Customer optionally applies coupon (cart page)
+2. Customer optionally applies coupon on cart page \u2192 \`applyCoupon(cartId, code)\`
 3. Detect payment providers \u2192 \`getPaymentProviders()\`
 4. Start checkout session (\`startGuestCheckout()\` or \`createCheckout()\`)
 5. Set shipping address (includes required email) \u2192 \`setShippingAddress()\`
@@ -215,7 +215,7 @@ import { Elements, PaymentElement, useStripe, useElements } from '@stripe/react-
 
 function CheckoutPage() {
   const [paymentData, setPaymentData] = useState<{
-    clientSecret: string; provider: string; checkoutId: string;
+    clientSecret: string; provider: string; checkoutId: string; clientSdk?: { renderType: string };
   } | null>(null);
   const [stripePromise, setStripePromise] = useState<ReturnType<typeof loadStripe> | null>(null);
   const [paypalClientId, setPaypalClientId] = useState<string | null>(null);
@@ -277,7 +277,7 @@ function CheckoutPage() {
         // saveCard: customerOptedIn,  // optional opt-in
       });
 
-      setPaymentData({ clientSecret: paymentIntent.clientSecret, provider: paymentIntent.provider, checkoutId });
+      setPaymentData({ clientSecret: paymentIntent.clientSecret, provider: paymentIntent.provider, checkoutId, clientSdk: paymentIntent.clientSdk });
 
       // Step 5: Initialize the correct payment provider
       if (paymentIntent.provider === 'stripe' && stripeProvider) {
@@ -887,6 +887,10 @@ function ProductPage({ product, storeInfo }: { product: Product; storeInfo: Stor
     ? getVariantPrice(selectedVariant, product.basePrice).toString()
     : product.salePrice || product.basePrice;
 
+  // \u2705 For catalog cards: use pre-computed priceMin/priceMax instead of iterating variants
+  // product.priceMin / product.priceMax are always set for VARIABLE products with explicit variant prices.
+  // product.priceVaries is true when the range should be shown as "\u20AA49 \u2013 \u20AA199".
+
   // Build attribute buttons (size, color, etc.)
   const allOptions = product.variants?.map(v => getVariantOptions(v)) || [];
   const attrNames = [...new Set(allOptions.flatMap(opts => opts.map(o => o.name)))];
@@ -1101,6 +1105,7 @@ const total = cart.total;
 
 ### Coupons
 
+**On the cart page** (before checkout is created):
 \`\`\`typescript
 // Apply coupon \u2014 returns updated Cart with discountAmount
 const updatedCart = await client.applyCoupon(cartId, 'SAVE20');
@@ -1108,13 +1113,24 @@ console.log(updatedCart.discountAmount); // "10.00"
 console.log(updatedCart.couponCode);     // "SAVE20"
 
 // Remove coupon
-const updatedCart = await client.removeCoupon(cartId);
+await client.removeCoupon(cartId);
 
 // Calculate totals including discount
 const totals = getCartTotals(cart); // { subtotal, discount, shipping, total }
 \`\`\`
 
-Add a coupon code input on the cart page. Coupons only work on server \`Cart\` (has \`id\` field). Checkout inherits the coupon \u2014 show \`checkout.discountAmount\` and \`checkout.couponCode\` in checkout order summary.
+**On the checkout page** (after checkout session exists \u2014 ALWAYS use this when checkoutId is available):
+\`\`\`typescript
+// Applies to cart AND updates checkout totals in one call
+const checkout = await client.applyCheckoutCoupon(checkoutId, 'SAVE20');
+console.log(checkout.discountAmount); // "10.00"
+console.log(checkout.total);          // correctly updated total
+
+// Remove coupon from checkout
+await client.removeCheckoutCoupon(checkoutId);
+\`\`\`
+
+> \u26A0\uFE0F **Critical:** if a checkout session already exists, ALWAYS use \`applyCheckoutCoupon(checkoutId, code)\`. Using \`applyCoupon(cartId, code)\` after checkout creation does NOT update the checkout total \u2014 payment will charge the original amount. Show \`checkout.discountAmount\` and \`checkout.couponCode\` in the order summary.
 
 ### \u26A0\uFE0F Checkout Order Summary \u2014 Use checkout.lineItems, NOT cart.items!
 
@@ -1934,7 +1950,7 @@ subsequent SDK call sends the \`Accept-Language\` header automatically:
 \`\`\`typescript
 import { BrainerceClient } from 'brainerce';
 
-const client = new BrainerceClient({ connectionId: 'vc_...' });
+const client = new BrainerceClient({ salesChannelId: 'vc_...' });
 client.setLocale('he'); // done \u2014 all calls are now in Hebrew
 \`\`\`
 
@@ -2651,6 +2667,9 @@ interface Product {
   basePrice: string;   // Use parseFloat() for calculations
   salePrice?: string | null;
   costPrice?: string | null;
+  priceMin?: string | null;  // Lowest variant price (VARIABLE products). Use for catalog/JSON-LD range display.
+  priceMax?: string | null;  // Highest variant price (VARIABLE products).
+  priceVaries?: boolean;     // true when variant prices differ \u2014 show "\u20AA49 \u2013 \u20AA199" range.
   status: string;
   type: 'SIMPLE' | 'VARIABLE';
   isDownloadable?: boolean;
@@ -3221,9 +3240,9 @@ var HELPERS_TYPES = `// ---- Helper Functions (import from 'brainerce') ----
 // Price helpers
 function formatPrice(priceString: string | number | undefined | null, options?: { currency?: string; locale?: string; }): string;
 function getProductPrice(product: Pick<Product, 'basePrice' | 'salePrice'>): number;
-function getProductPriceInfo(product: Pick<Product, 'basePrice' | 'salePrice'>): {
+function getProductPriceInfo(product: Pick<Product, 'basePrice' | 'salePrice' | 'discount' | 'priceMin' | 'priceVaries'>): {
   price: number; originalPrice: number; isOnSale: boolean; discountAmount: number; discountPercent: number;
-};
+}; // Falls back to priceMin when basePrice=0 (VARIABLE products)
 function getVariantPrice(variant: Pick<ProductVariant, 'price' | 'salePrice'>, productBasePrice: string): number;
 
 // Cart helpers
@@ -3725,7 +3744,7 @@ function selectVariant(product: Product, selections: Record<string, string>) {
 import { client } from './brainerce';
 
 // 1. Submit the address + email. Email is REQUIRED on the DTO.
-const { shippingRates } = await client.setShippingAddress(checkoutId, {
+const { checkout, rates } = await client.setShippingAddress(checkoutId, {
   email,
   firstName,
   lastName,
@@ -3736,10 +3755,11 @@ const { shippingRates } = await client.setShippingAddress(checkoutId, {
   postalCode,
   country,
 });
+// rates = available shipping rates; checkout = updated checkout object
 
 // 2. Let the customer pick one of the returned rates.
-const chosen = shippingRates[0]; // user selection
-await client.setShippingMethod(checkoutId, chosen.id);
+const chosen = rates[0]; // user selection
+await client.selectShippingMethod(checkoutId, chosen.id);
 
 // 3. Re-fetch the checkout to get updated totals (tax may change after address).
 const checkout = await client.getCheckout(checkoutId);
@@ -3793,21 +3813,21 @@ if (providers.length === 0) {
 }
 
 const active = providers[0];`,
-  "checkout-stripe-confirm": `// Stripe confirm flow. Requires @stripe/stripe-js and @stripe/react-stripe-js
-// (or the vanilla Stripe.js browser SDK).
+  "checkout-stripe-confirm": `// Stripe confirm flow. Requires @stripe/stripe-js.
 import { loadStripe } from '@stripe/stripe-js';
 import { client } from './brainerce';
 
 const stripe = await loadStripe(stripePublicKey);
 if (!stripe) throw new Error('Stripe failed to load');
 
-// The SDK returns a clientSecret via the provider's config after setPaymentMethod.
-const { clientSecret } = await client.setPaymentMethod(checkoutId, {
-  providerId: stripeProvider.id,
+// Create a payment intent \u2014 returns clientSecret for Stripe Elements.
+const intent = await client.createPaymentIntent(checkoutId, {
+  successUrl: \`\${window.location.origin}/order-confirmation?checkoutId=\${checkoutId}\`,
+  cancelUrl: \`\${window.location.origin}/checkout?error=cancelled\`,
 });
 
-// Use Stripe Elements to collect the card, then confirm:
-const result = await stripe.confirmCardPayment(clientSecret, {
+// Use Stripe Elements to confirm:
+const result = await stripe.confirmCardPayment(intent.clientSecret, {
   payment_method: { card: cardElement },
 });
 
@@ -3816,21 +3836,21 @@ if (result.error) {
   return;
 }
 
-// Success \u2014 redirect to your confirmation page with checkoutId in the URL.
+// Success \u2014 redirect to confirmation page.
 // The confirmation page runs handlePaymentSuccess + waitForOrder.
 window.location.assign(\`/order-confirmation?checkoutId=\${checkoutId}\`);`,
   "checkout-paypal-confirm": `// PayPal confirm flow. Use the PayPal JS SDK (render a PayPal button component).
 import { client } from './brainerce';
 
-// When the PayPal button's onApprove fires with the PayPal order ID:
-async function onPayPalApprove(paypalOrderId: string) {
-  await client.setPaymentMethod(checkoutId, {
-    providerId: paypalProvider.id,
-    providerData: { paypalOrderId },
-  });
+// Create a payment intent first \u2014 for PayPal this returns the PayPal order ID.
+const intent = await client.createPaymentIntent(checkoutId, {
+  successUrl: \`\${window.location.origin}/order-confirmation?checkoutId=\${checkoutId}\`,
+  cancelUrl: \`\${window.location.origin}/checkout?error=cancelled\`,
+});
 
-  // PayPal confirmation \u2014 the SDK captures the order server-side.
-  // After this resolves, redirect to confirmation.
+// Render a PayPal button using intent.clientSdk (provider SDK config).
+// When the PayPal button's onApprove fires, redirect to confirmation:
+function onPayPalApprove() {
   window.location.assign(\`/order-confirmation?checkoutId=\${checkoutId}\`);
 }`,
   "checkout-sandbox-confirm": `// Sandbox payment \u2014 store has sandboxPaymentsEnabled=true. No real charge.
@@ -3873,7 +3893,7 @@ async function registerAndMaybeVerify(input: {
   firstName: string;
   lastName: string;
 }) {
-  const result = await client.register(input);
+  const result = await client.registerCustomer(input);
   if (result.requiresVerification) {
     // Route the user to your verify-email UI. Do NOT treat them as logged in.
     return { state: 'needs-verification' as const };
@@ -3894,7 +3914,7 @@ async function resendCode() {
 import { client } from './brainerce';
 
 async function login(email: string, password: string) {
-  const result = await client.login({ email, password });
+  const result = await client.loginCustomer(email, password);
   if (result.requiresVerification) {
     return { state: 'needs-verification' as const };
   }
@@ -3929,25 +3949,37 @@ async function submitReset(token: string, newPassword: string) {
   "oauth-redirect-and-callback": `// OAuth sign-in. Redirect flow, NOT popup.
 import { client } from './brainerce';
 
-// On your login / register UI:
-const providers = await client.getAvailableOAuthProviders();
-// Render one button per provider. On click, redirect the browser:
-for (const p of providers) {
-  // button.onclick = () => window.location.assign(p.authorizationUrl)
+// Step 1: Get available provider names (strings: 'GOOGLE', 'FACEBOOK', 'GITHUB')
+const { providers } = await client.getAvailableOAuthProviders();
+
+// Step 2: For each provider, fetch the authorization URL, then redirect.
+// Call this when the user clicks a provider button:
+async function redirectToOAuth(provider: string) {
+  const { authorizationUrl } = await client.getOAuthAuthorizeUrl(provider, {
+    redirectUrl: \`\${window.location.origin}/auth/callback\`,
+  });
+  window.location.href = authorizationUrl; // full-page redirect, NOT a popup
 }
 
-// On your OAuth callback route (SERVER-SIDE / BFF):
-// 1. Read token + oauth_success (or oauth_error) from query params.
-// 2. If oauth_error: redirect to login with the error message.
-// 3. If oauth_success: exchange the token for a session cookie (your BFF),
-//    then redirect the browser to /account or wherever.
-// Do NOT allow the token to land in browser history as a query param.`,
+// Step 3: On your /auth/callback route, read token from URL params:
+const params = new URLSearchParams(window.location.search);
+const oauthError = params.get('oauth_error');
+const token = params.get('token');
+if (oauthError) {
+  window.location.href = '/login?error=' + encodeURIComponent(oauthError);
+} else if (token) {
+  client.setCustomerToken(token);
+  window.location.href = '/account';
+}`,
   "coupon-apply-and-remove": `// Coupon input. Build the UI even if no coupons exist today \u2014 it auto-hides.
+// IMPORTANT: use applyCheckoutCoupon when a checkoutId is available (checkout page).
+// Using applyCoupon after checkout creation does NOT update the checkout total.
 import { client } from './brainerce';
 
-async function applyCoupon(code: string) {
+// On cart page (no checkout session yet)
+async function applyCouponToCart(cartId: string, code: string) {
   try {
-    const cart = await client.applyCoupon(code);
+    const cart = await client.applyCoupon(cartId, code);
     return { ok: true, cart };
   } catch (err) {
     // Invalid / expired / minimum not met. Surface the specific error.
@@ -3955,17 +3987,30 @@ async function applyCoupon(code: string) {
   }
 }
 
-async function removeCoupon() {
-  const cart = await client.removeCoupon();
-  return cart;
+async function removeCouponFromCart(cartId: string) {
+  return client.removeCoupon(cartId);
+}
+
+// On checkout page (checkout session already exists \u2014 always prefer this)
+async function applyCouponToCheckout(checkoutId: string, code: string) {
+  try {
+    const checkout = await client.applyCheckoutCoupon(checkoutId, code);
+    return { ok: true, checkout }; // checkout.total is already updated
+  } catch (err) {
+    return { ok: false, error: (err as Error).message };
+  }
+}
+
+async function removeCouponFromCheckout(checkoutId: string) {
+  return client.removeCheckoutCoupon(checkoutId);
 }`,
   "reservation-countdown": `// Reservation countdown. Use the SDK's expiry timestamp \u2014 do NOT invent
 // your own timer state.
 import { client } from './brainerce';
 
-function getRemainingMs(cart: { reservationExpiresAt?: string | null }): number {
-  if (!cart.reservationExpiresAt) return 0;
-  const expiry = new Date(cart.reservationExpiresAt).getTime();
+function getRemainingMs(cart: { reservation?: { expiresAt?: string } }): number {
+  if (!cart.reservation?.expiresAt) return 0;
+  const expiry = new Date(cart.reservation.expiresAt).getTime();
   return Math.max(0, expiry - Date.now());
 }
 
@@ -3992,8 +4037,8 @@ function onSearchChange(query: string, onResults: (items: unknown[]) => void) {
     return;
   }
   searchTimer = setTimeout(async () => {
-    const results = await client.searchProducts(query);
-    onResults(results);
+    const { products } = await client.getSearchSuggestions(query);
+    onResults(products);
   }, 300);
 }`,
   "i18n-set-locale": `// i18n \u2014 only if get-store-capabilities reports i18n.enabled.
@@ -4350,19 +4395,13 @@ import { client } from './brainerce-client';
 
 interface CheckoutOptions {
   cartId: string;
-  shippingAddress: object;
-  shippingMethodId: string;
-  paymentProviderId: string;
 }
 
 async function createCheckoutSafe(opts: CheckoutOptions) {
   try {
-    return await client.createCheckout({
-      cartId: opts.cartId,
-      shippingAddress: opts.shippingAddress,
-      shippingMethodId: opts.shippingMethodId,
-      paymentProviderId: opts.paymentProviderId,
-    });
+    // createCheckout only takes cartId (+ optional customerId, selectedItemIds).
+    // Shipping address, shipping method, and payment are set via separate calls.
+    return await client.createCheckout({ cartId: opts.cartId });
   } catch (err: unknown) {
     if (!isApiError(err, 'PRICE_DRIFT')) throw err;
 
@@ -5037,21 +5076,21 @@ var FLOWS = {
 1. **Collect address + email.** Build a form that captures customer email, billing address, shipping address (with \`line1\`, \`line2\`, \`city\`, \`region\`, \`postalCode\`, \`country\`). \`email\` is REQUIRED on \`SetShippingAddressDto\`.
 2. **Submit the address to get shipping rates.**
    \`\`\`ts
-   const { shippingRates } = await client.setShippingAddress(checkoutId, {
+   const { checkout, rates } = await client.setShippingAddress(checkoutId, {
      email,
      firstName,
      lastName,
      line1, line2, city, region, postalCode, country,
    });
    \`\`\`
-   The response includes the available shipping rates for that address + the store's zones.
+   \`rates\` = available shipping rates for that address + the store's zones. \`checkout\` = updated checkout object.
 3. **Let the customer pick a rate**, then persist the selection:
    \`\`\`ts
-   await client.setShippingMethod(checkoutId, rateId);
+   await client.selectShippingMethod(checkoutId, rateId);
    \`\`\`
-4. **Fetch payment providers for this checkout:**
+4. **Fetch payment providers:**
    \`\`\`ts
-   const providers = await client.getPaymentProviders(checkoutId);
+   const providers = await client.getPaymentProviders();
    \`\`\`
    The response tells you which providers are configured (Stripe, Grow, PayPal, Sandbox) and how to render each. Each provider has a \`renderType\` telling you whether to show a Stripe Elements form, a redirect button, a PayPal button, or a sandbox "complete test order" button.
 5. **Confirm payment using the provider's recommended flow.** For Stripe: Stripe Elements \u2192 \`stripe.confirmCardPayment\` using the clientSecret returned by the SDK. For sandbox payments: call \`completeGuestCheckout(checkoutId)\` directly. For PayPal/Grow: follow the redirect and handle the return on your confirmation page.
@@ -5067,28 +5106,28 @@ Never bypass these steps. Never call \`submitGuestOrder\` / \`createOrder\` \u20
   "auth-register": {
     title: "Registration",
     body: `1. **Collect** email, password, first name, last name. Enforce strong passwords client-side: 8+ chars, upper, lower, number, special.
-2. **Call register:**
+2. **Call registerCustomer:**
    \`\`\`ts
-   const result = await client.register({ email, password, firstName, lastName });
+   const result = await client.registerCustomer({ email, password, firstName, lastName });
    \`\`\`
 3. **Branch on \`result.requiresVerification\`:**
-   - If \`true\`: route the user to your verify-email UI. Do NOT treat them as logged in yet.
-   - If \`false\`: the user is logged in. Store the token via your BFF session and route to the account area.
+   - If \`true\`: store the token temporarily (e.g. sessionStorage), route the user to your verify-email UI. Do NOT treat them as logged in yet.
+   - If \`false\`: call \`client.setCustomerToken(result.token)\` and route to the account area.
 4. **On the verify-email step:** collect a 6-digit code and call \`client.verifyEmail(code)\`. Offer a "resend code" button wired to \`client.resendVerificationEmail()\`.
-5. **After verifyEmail resolves:** the user is now logged in. Persist the session via your BFF and route to the account area.
+5. **After verifyEmail resolves:** call \`client.setCustomerToken(result.token)\` \u2014 the user is now logged in \u2014 then route to the account area.
 
 Build the verify-email step EVEN IF the store currently has verification disabled. It auto-hides; store owners enable it later.`
   },
   "auth-login": {
     title: "Login",
     body: `1. **Collect** email + password.
-2. **Call login:**
+2. **Call loginCustomer:**
    \`\`\`ts
-   const result = await client.login({ email, password });
+   const result = await client.loginCustomer(email, password);
    \`\`\`
 3. **Branch on \`result.requiresVerification\`:**
    - If \`true\`: route to verify-email. The user must complete verification before accessing account features.
-   - If \`false\`: persist the session via your BFF and route to the previous page (or account area).
+   - If \`false\`: call \`client.setCustomerToken(result.token)\` and route to the previous page (or account area).
 4. **Offer OAuth buttons** from \`client.getAvailableOAuthProviders()\`. Render a placeholder region even when no providers are returned \u2014 the region auto-hides today and shows buttons the moment a provider is enabled in the dashboard.
 5. **On error**, render the specific message (invalid credentials, rate limited, account disabled) \u2014 never swallow.`
   },
@@ -5113,15 +5152,24 @@ Build both steps EVEN IF the store has no email provider configured today \u2014
   },
   oauth: {
     title: "OAuth sign-in",
-    body: `1. **Render available providers:**
+    body: `1. **Get available provider names:**
+   \`\`\`ts
+   const { providers } = await client.getAvailableOAuthProviders();
+   // providers = ['GOOGLE', 'FACEBOOK', 'GITHUB'] (strings, not objects with authorizationUrl)
+   \`\`\`
+2. **For each provider, fetch the authorization URL:**
+   \`\`\`ts
+   const { authorizationUrl } = await client.getOAuthAuthorizeUrl(provider, {
+     redirectUrl: \`\${window.location.origin}/auth/callback\`,
+   });
+   window.location.href = authorizationUrl; // full-page redirect, NOT a popup
+   \`\`\`
+3. **On the callback page** the URL contains \`token\` + \`oauth_success\` (or \`oauth_error\`) query params. Extract and apply the token:
    \`\`\`ts
-   const providers = await client.getAvailableOAuthProviders();
+   const token = new URLSearchParams(location.search).get('token');
+   if (token) client.setCustomerToken(token); // then redirect to account
    \`\`\`
-   Each provider has \`{ provider: 'GOOGLE' | 'FACEBOOK' | 'GITHUB', authorizationUrl }\`.
-2. **Build a button for each** that redirects the browser to \`authorizationUrl\`. Do NOT open a popup; the full-page redirect is required.
-3. **On the provider's side** the user authenticates, and the provider redirects back to your OAuth callback URL with \`token\` + \`oauth_success\` (or \`oauth_error\`) query params.
-4. **The callback handler MUST run server-side (BFF).** Extract the token from the query params, exchange it for a session cookie via your BFF, then redirect the browser to the account area. Never let the token land in browser history as a query param or localStorage.
-5. **On \`oauth_error\`:** redirect to login with an error message.
+4. **On \`oauth_error\`:** redirect to login with an error message.
 
 Build the OAuth button region AND the callback handler even when no providers are configured. They auto-hide.`
   },
@@ -5143,7 +5191,7 @@ Build the OAuth button region AND the callback handler even when no providers ar
 
 - **Cart ID persistence:** the SDK stores the cart ID across reloads. You do not need to write cart-to-localStorage code yourself.
 - **Reads:** \`client.getCart()\` returns the current cart. Call it on mount in your cart UI and on any page that shows a cart count (header).
-- **Writes:** use \`client.addToCart\`, \`client.updateCartItem\`, \`client.removeCartItem\`, \`client.applyCoupon\`, \`client.removeCoupon\`. After each mutation the SDK returns the updated cart.
+- **Writes:** use \`client.addToCart\`, \`client.updateCartItem\`, \`client.removeCartItem\`, \`client.applyCoupon\`, \`client.removeCoupon\`. After each mutation the SDK returns the updated cart. On the **checkout page** use \`client.applyCheckoutCoupon(checkoutId, code)\` / \`client.removeCheckoutCoupon(checkoutId)\` \u2014 these update checkout totals atomically. Never use \`applyCoupon\` after a checkout session exists.
 - **Totals:** call \`getCartTotals(cart)\` \u2014 do NOT read \`cart.total\`. The helper understands taxes, shipping, and discounts.
 - **\`smartGetCart()\`** returns \`CartWithIncludes\` (extends \`Cart\`). All carts are server-side. Pass \`{ include: ['recommendations', 'upgrades', 'bundles'] }\` to fetch extras in one request.
 - **NEVER mutate cart state outside SDK helpers.** Any hand-rolled cart update risks desync with the reservation timer and the checkout flow.`
@@ -5275,7 +5323,7 @@ var FEATURES = [
     id: "browse-products",
     title: "Browse, filter, and search products",
     description: "Users can list products with pagination, apply category / price / attribute / custom-field filters, sort by name / price / newest, and run a search with autocomplete. Custom-field filters surface metafield definitions whose filterable=true (SELECT, MULTI_SELECT, BOOLEAN). Must handle empty states and loading states.",
-    sdk: "client.getProducts({ page, limit, filters, sort, metafields }), client.getPublicMetafieldDefinitions(), client.searchProducts(query)",
+    sdk: "client.getProducts({ page, limit, filters, sort, metafields }), client.getPublicMetafieldDefinitions(), client.getSearchSuggestions(query)",
     mandatory: "mandatory"
   },
   {
@@ -5305,7 +5353,7 @@ var FEATURES = [
     id: "cart-coupons",
     title: "Apply and remove coupon codes",
     description: "Users can enter a coupon code, see it applied to the cart, see the discount amount, and remove it. Build the UI even if no coupons are configured today \u2014 it auto-hides.",
-    sdk: "client.applyCoupon(code), client.removeCoupon()",
+    sdk: "client.applyCoupon(cartId, code), client.removeCoupon(cartId) \u2014 on cart page. client.applyCheckoutCoupon(checkoutId, code), client.removeCheckoutCoupon(checkoutId) \u2014 on checkout page (use when checkoutId exists)",
     mandatory: "mandatory",
     capabilityFlag: "hasCoupons",
     whenDisabledNote: "Store has no coupons configured today. Build the UI anyway \u2014 it auto-hides until the store owner creates a coupon."
@@ -5322,7 +5370,7 @@ var FEATURES = [
     id: "checkout",
     title: "Complete a full checkout end-to-end",
     description: "Users can enter their address, pick a shipping rate, pick a payment provider, pay, and land on a confirmation page showing the real order. Displays checkout.lineItems (not cart.items) on the summary.",
-    sdk: "client.setShippingAddress, client.setShippingMethod, client.getPaymentProviders, provider-specific confirm, client.handlePaymentSuccess, client.waitForOrder",
+    sdk: "client.setShippingAddress (returns { checkout, rates }), client.selectShippingMethod, client.getPaymentProviders(), provider-specific confirm, client.handlePaymentSuccess, client.waitForOrder",
     flowRef: "checkout",
     mandatory: "mandatory"
   },
@@ -5338,7 +5386,7 @@ var FEATURES = [
     id: "register",
     title: "Register a new account with email verification",
     description: 'Users can create an account (email, password, first + last name). Handles the requiresVerification branch by routing to an email-verification step. Verification step collects a 6-digit code and has a "resend code" action.',
-    sdk: "client.register({email, password, firstName, lastName}), client.verifyEmail(code), client.resendVerificationEmail()",
+    sdk: "client.registerCustomer({email, password, firstName, lastName}), client.verifyEmail(code), client.resendVerificationEmail()",
     flowRef: "auth-register",
     mandatory: "mandatory",
     capabilityFlag: "oauth",
@@ -5348,7 +5396,7 @@ var FEATURES = [
     id: "login",
     title: "Log in with email / password and handle verification branch",
     description: "Users can log in. The login form handles the requiresVerification branch by routing to the verify-email step. Specific errors render (bad credentials, rate limited, disabled account).",
-    sdk: "client.login({email, password})",
+    sdk: "client.loginCustomer(email, password)",
     flowRef: "auth-login",
     mandatory: "mandatory"
   },
@@ -5381,14 +5429,14 @@ var FEATURES = [
     id: "header",
     title: "Global header with cart count and search",
     description: "A header visible across the experience with the store logo, navigation, a cart icon with live item count, a search input with autocomplete (debounced ~300ms, 2-char minimum), and a login / account action. Below the header, discount banners render when active.",
-    sdk: "client.getCart() for the count, client.searchProducts(query) for autocomplete",
+    sdk: "client.getCart() for the count, client.getSearchSuggestions(query) for autocomplete",
     mandatory: "mandatory"
   },
   {
     id: "discount-banners",
     title: "Show active discount banners and badges",
     description: "Active discount rules render as banners (below the header) and as badges on product cards / detail pages. Build the UI even if the store has no active discounts today \u2014 it auto-hides.",
-    sdk: "client.getDiscountBanners(), getProductDiscountBadge(product)",
+    sdk: "client.getDiscountBanners(), client.getProductDiscountBadge(productId)",
     mandatory: "mandatory",
     capabilityFlag: "hasDiscountRules",
     whenDisabledNote: "Store has no discount rules active. Build the banner and badge components anyway \u2014 they auto-hide."