@brainerce/mcp-server 3.5.0 → 3.5.1

package/dist/index.mjs

@@ -87,7 +87,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
@@ -189,7 +189,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()\`
@@ -207,7 +207,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);
@@ -269,7 +269,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) {
@@ -879,6 +879,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)))];
@@ -1093,6 +1097,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');
@@ -1100,13 +1105,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!
 
@@ -1926,7 +1942,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
 \`\`\`
 
@@ -2643,6 +2659,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;
@@ -3213,9 +3232,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
@@ -3717,7 +3736,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,
@@ -3728,10 +3747,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);
@@ -3785,21 +3805,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 },
 });
 
@@ -3808,21 +3828,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.
@@ -3865,7 +3885,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 };
@@ -3886,7 +3906,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 };
   }
@@ -3921,25 +3941,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.
@@ -3947,17 +3979,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());
 }
 
@@ -3984,8 +4029,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.
@@ -4342,19 +4387,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;
 
@@ -5029,21 +5068,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.
@@ -5059,28 +5098,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.`
   },
@@ -5105,15 +5144,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.`
   },
@@ -5135,7 +5183,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.`
@@ -5267,7 +5315,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"
   },
   {
@@ -5297,7 +5345,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."
@@ -5314,7 +5362,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"
   },
@@ -5330,7 +5378,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",
@@ -5340,7 +5388,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"
   },
@@ -5373,14 +5421,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."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brainerce/mcp-server",
-  "version": "3.5.0",
+  "version": "3.5.1",
   "description": "Framework-agnostic domain knowledge API for Brainerce. Provides SDK docs, types, business flows, critical rules, and store capabilities to AI tools like Lovable, Cursor, Bolt, v0, and Claude Code. Does NOT provide framework-specific boilerplate — clients build in whatever framework fits.",
   "bin": {
     "brainerce-mcp": "dist/bin/stdio.js"