@brainerce/mcp-server 2.1.1 → 2.3.0

package/dist/bin/http.js

@@ -3157,7 +3157,12 @@ export default function CartPage() {
             <div className="mt-6 space-y-3">
               <h3 className="text-foreground text-sm font-semibold">{t('bundleOffers')}</h3>
               {bundles.bundles.map((offer) => (
-                <CartBundleOfferCard key={offer.id} offer={offer} onAdd={refreshCart} />
+                <CartBundleOfferCard
+                  key={offer.id}
+                  offer={offer}
+                  cartId={cart.id}
+                  onAdd={refreshCart}
+                />
               ))}
             </div>
           )}
@@ -7654,8 +7659,9 @@ export function PaymentStep({ checkoutId, className }: PaymentStepProps) {
       })
       .catch(() => null);
 
-    // B) Load + init SDK as early as possible
+    // B) Load + init SDK as early as possible (skip for sandbox)
     providerPromise.then((providerSdk) => {
+      if (providerSdk?.renderType === 'sandbox') return;
       if (providerSdk?.renderType === 'sdk-widget' && providerSdk.scriptUrl) {
         currentSdk = providerSdk;
         loadScript(providerSdk);
@@ -7682,6 +7688,9 @@ export function PaymentStep({ checkoutId, className }: PaymentStepProps) {
       const sdk = resolveClientSdk(intent, providerSdk);
       currentSdk = sdk;
 
+      // Sandbox mode \u2014 no SDK to load, UI handles it
+      if (sdk.renderType === 'sandbox') return;
+
       if (sdk.renderType === 'redirect') {
         window.location.href = intent.clientSecret;
         return;
@@ -7776,6 +7785,48 @@ export function PaymentStep({ checkoutId, className }: PaymentStepProps) {
 
   const sdk = resolveClientSdk(paymentIntent, preloadedSdk);
 
+  if (sdk.renderType === 'sandbox') {
+    const handleCompleteSandbox = async () => {
+      setLoading(true);
+      try {
+        const client = getClient();
+        await client.completeGuestCheckout(checkoutId);
+        window.location.href = \`/order-confirmation?checkout_id=\${checkoutId}\`;
+      } catch (err) {
+        setError(err instanceof Error ? err.message : t('paymentError'));
+        setLoading(false);
+      }
+    };
+
+    return (
+      <div className={cn('py-8 text-center', className)}>
+        <div className="mx-auto max-w-md rounded-lg border border-amber-200 bg-amber-50 p-6">
+          <svg
+            className="mx-auto mb-3 h-10 w-10 text-amber-500"
+            fill="none"
+            viewBox="0 0 24 24"
+            stroke="currentColor"
+          >
+            <path
+              strokeLinecap="round"
+              strokeLinejoin="round"
+              strokeWidth={1.5}
+              d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-2.5L13.732 4.5c-.77-.833-2.694-.833-3.464 0L3.34 16.5c-.77.833.192 2.5 1.732 2.5z"
+            />
+          </svg>
+          <h3 className="text-foreground mb-1 text-lg font-semibold">{t('sandboxTitle')}</h3>
+          <p className="text-muted-foreground mb-4 text-sm">{t('sandboxDescription')}</p>
+          <button
+            onClick={handleCompleteSandbox}
+            className="inline-flex items-center rounded-md bg-amber-500 px-6 py-2.5 text-sm font-medium text-white transition-colors hover:bg-amber-600"
+          >
+            {t('completeTestOrder')}
+          </button>
+        </div>
+      </div>
+    );
+  }
+
   if (sdk.renderType === 'sdk-widget') {
     const containerId =
       sdk.containerId || \`\${paymentIntent.provider || 'payment'}-payment-container\`;
@@ -9933,18 +9984,18 @@ import { useState } from 'react';
 import Image from 'next/image';
 import type { CartBundleOffer as CartBundleOfferType } from 'brainerce';
 import { formatPrice } from 'brainerce';
-import { getClient } from '@/lib/brainerce';
 import { useStoreInfo } from '@/providers/store-provider';
 import { useTranslations } from '@/lib/translations';
 import { cn } from '@/lib/utils';
 
 interface CartBundleOfferCardProps {
   offer: CartBundleOfferType;
+  cartId: string;
   onAdd: () => void;
   className?: string;
 }
 
-export function CartBundleOfferCard({ offer, onAdd, className }: CartBundleOfferCardProps) {
+export function CartBundleOfferCard({ offer, cartId, onAdd, className }: CartBundleOfferCardProps) {
   const { storeInfo } = useStoreInfo();
   const t = useTranslations('cart');
   const currency = storeInfo?.currency || 'USD';
@@ -9968,12 +10019,9 @@ export function CartBundleOfferCard({ offer, onAdd, className }: CartBundleOffer
     if (adding) return;
     try {
       setAdding(true);
+      const { getClient } = await import('@/lib/brainerce');
       const client = getClient();
-      await client.smartAddToCart({
-        productId: product.id,
-        variantId: offer.bundleVariantId || undefined,
-        quantity: 1,
-      });
+      await client.addBundleToCart(cartId, offer.id);
       onAdd();
     } catch (err) {
       console.error('Failed to add bundle item:', err);

package/dist/bin/stdio.js

@@ -3155,7 +3155,12 @@ export default function CartPage() {
             <div className="mt-6 space-y-3">
               <h3 className="text-foreground text-sm font-semibold">{t('bundleOffers')}</h3>
               {bundles.bundles.map((offer) => (
-                <CartBundleOfferCard key={offer.id} offer={offer} onAdd={refreshCart} />
+                <CartBundleOfferCard
+                  key={offer.id}
+                  offer={offer}
+                  cartId={cart.id}
+                  onAdd={refreshCart}
+                />
               ))}
             </div>
           )}
@@ -7652,8 +7657,9 @@ export function PaymentStep({ checkoutId, className }: PaymentStepProps) {
       })
       .catch(() => null);
 
-    // B) Load + init SDK as early as possible
+    // B) Load + init SDK as early as possible (skip for sandbox)
     providerPromise.then((providerSdk) => {
+      if (providerSdk?.renderType === 'sandbox') return;
       if (providerSdk?.renderType === 'sdk-widget' && providerSdk.scriptUrl) {
         currentSdk = providerSdk;
         loadScript(providerSdk);
@@ -7680,6 +7686,9 @@ export function PaymentStep({ checkoutId, className }: PaymentStepProps) {
       const sdk = resolveClientSdk(intent, providerSdk);
       currentSdk = sdk;
 
+      // Sandbox mode \u2014 no SDK to load, UI handles it
+      if (sdk.renderType === 'sandbox') return;
+
       if (sdk.renderType === 'redirect') {
         window.location.href = intent.clientSecret;
         return;
@@ -7774,6 +7783,48 @@ export function PaymentStep({ checkoutId, className }: PaymentStepProps) {
 
   const sdk = resolveClientSdk(paymentIntent, preloadedSdk);
 
+  if (sdk.renderType === 'sandbox') {
+    const handleCompleteSandbox = async () => {
+      setLoading(true);
+      try {
+        const client = getClient();
+        await client.completeGuestCheckout(checkoutId);
+        window.location.href = \`/order-confirmation?checkout_id=\${checkoutId}\`;
+      } catch (err) {
+        setError(err instanceof Error ? err.message : t('paymentError'));
+        setLoading(false);
+      }
+    };
+
+    return (
+      <div className={cn('py-8 text-center', className)}>
+        <div className="mx-auto max-w-md rounded-lg border border-amber-200 bg-amber-50 p-6">
+          <svg
+            className="mx-auto mb-3 h-10 w-10 text-amber-500"
+            fill="none"
+            viewBox="0 0 24 24"
+            stroke="currentColor"
+          >
+            <path
+              strokeLinecap="round"
+              strokeLinejoin="round"
+              strokeWidth={1.5}
+              d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-2.5L13.732 4.5c-.77-.833-2.694-.833-3.464 0L3.34 16.5c-.77.833.192 2.5 1.732 2.5z"
+            />
+          </svg>
+          <h3 className="text-foreground mb-1 text-lg font-semibold">{t('sandboxTitle')}</h3>
+          <p className="text-muted-foreground mb-4 text-sm">{t('sandboxDescription')}</p>
+          <button
+            onClick={handleCompleteSandbox}
+            className="inline-flex items-center rounded-md bg-amber-500 px-6 py-2.5 text-sm font-medium text-white transition-colors hover:bg-amber-600"
+          >
+            {t('completeTestOrder')}
+          </button>
+        </div>
+      </div>
+    );
+  }
+
   if (sdk.renderType === 'sdk-widget') {
     const containerId =
       sdk.containerId || \`\${paymentIntent.provider || 'payment'}-payment-container\`;
@@ -9931,18 +9982,18 @@ import { useState } from 'react';
 import Image from 'next/image';
 import type { CartBundleOffer as CartBundleOfferType } from 'brainerce';
 import { formatPrice } from 'brainerce';
-import { getClient } from '@/lib/brainerce';
 import { useStoreInfo } from '@/providers/store-provider';
 import { useTranslations } from '@/lib/translations';
 import { cn } from '@/lib/utils';
 
 interface CartBundleOfferCardProps {
   offer: CartBundleOfferType;
+  cartId: string;
   onAdd: () => void;
   className?: string;
 }
 
-export function CartBundleOfferCard({ offer, onAdd, className }: CartBundleOfferCardProps) {
+export function CartBundleOfferCard({ offer, cartId, onAdd, className }: CartBundleOfferCardProps) {
   const { storeInfo } = useStoreInfo();
   const t = useTranslations('cart');
   const currency = storeInfo?.currency || 'USD';
@@ -9966,12 +10017,9 @@ export function CartBundleOfferCard({ offer, onAdd, className }: CartBundleOffer
     if (adding) return;
     try {
       setAdding(true);
+      const { getClient } = await import('@/lib/brainerce');
       const client = getClient();
-      await client.smartAddToCart({
-        productId: product.id,
-        variantId: offer.bundleVariantId || undefined,
-        quantity: 1,
-      });
+      await client.addBundleToCart(cartId, offer.id);
       onAdd();
     } catch (err) {
       console.error('Failed to add bundle item:', err);

package/dist/index.js

@@ -3172,7 +3172,12 @@ export default function CartPage() {
             <div className="mt-6 space-y-3">
               <h3 className="text-foreground text-sm font-semibold">{t('bundleOffers')}</h3>
               {bundles.bundles.map((offer) => (
-                <CartBundleOfferCard key={offer.id} offer={offer} onAdd={refreshCart} />
+                <CartBundleOfferCard
+                  key={offer.id}
+                  offer={offer}
+                  cartId={cart.id}
+                  onAdd={refreshCart}
+                />
               ))}
             </div>
           )}
@@ -7669,8 +7674,9 @@ export function PaymentStep({ checkoutId, className }: PaymentStepProps) {
       })
       .catch(() => null);
 
-    // B) Load + init SDK as early as possible
+    // B) Load + init SDK as early as possible (skip for sandbox)
     providerPromise.then((providerSdk) => {
+      if (providerSdk?.renderType === 'sandbox') return;
       if (providerSdk?.renderType === 'sdk-widget' && providerSdk.scriptUrl) {
         currentSdk = providerSdk;
         loadScript(providerSdk);
@@ -7697,6 +7703,9 @@ export function PaymentStep({ checkoutId, className }: PaymentStepProps) {
       const sdk = resolveClientSdk(intent, providerSdk);
       currentSdk = sdk;
 
+      // Sandbox mode \u2014 no SDK to load, UI handles it
+      if (sdk.renderType === 'sandbox') return;
+
       if (sdk.renderType === 'redirect') {
         window.location.href = intent.clientSecret;
         return;
@@ -7791,6 +7800,48 @@ export function PaymentStep({ checkoutId, className }: PaymentStepProps) {
 
   const sdk = resolveClientSdk(paymentIntent, preloadedSdk);
 
+  if (sdk.renderType === 'sandbox') {
+    const handleCompleteSandbox = async () => {
+      setLoading(true);
+      try {
+        const client = getClient();
+        await client.completeGuestCheckout(checkoutId);
+        window.location.href = \`/order-confirmation?checkout_id=\${checkoutId}\`;
+      } catch (err) {
+        setError(err instanceof Error ? err.message : t('paymentError'));
+        setLoading(false);
+      }
+    };
+
+    return (
+      <div className={cn('py-8 text-center', className)}>
+        <div className="mx-auto max-w-md rounded-lg border border-amber-200 bg-amber-50 p-6">
+          <svg
+            className="mx-auto mb-3 h-10 w-10 text-amber-500"
+            fill="none"
+            viewBox="0 0 24 24"
+            stroke="currentColor"
+          >
+            <path
+              strokeLinecap="round"
+              strokeLinejoin="round"
+              strokeWidth={1.5}
+              d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-2.5L13.732 4.5c-.77-.833-2.694-.833-3.464 0L3.34 16.5c-.77.833.192 2.5 1.732 2.5z"
+            />
+          </svg>
+          <h3 className="text-foreground mb-1 text-lg font-semibold">{t('sandboxTitle')}</h3>
+          <p className="text-muted-foreground mb-4 text-sm">{t('sandboxDescription')}</p>
+          <button
+            onClick={handleCompleteSandbox}
+            className="inline-flex items-center rounded-md bg-amber-500 px-6 py-2.5 text-sm font-medium text-white transition-colors hover:bg-amber-600"
+          >
+            {t('completeTestOrder')}
+          </button>
+        </div>
+      </div>
+    );
+  }
+
   if (sdk.renderType === 'sdk-widget') {
     const containerId =
       sdk.containerId || \`\${paymentIntent.provider || 'payment'}-payment-container\`;
@@ -9948,18 +9999,18 @@ import { useState } from 'react';
 import Image from 'next/image';
 import type { CartBundleOffer as CartBundleOfferType } from 'brainerce';
 import { formatPrice } from 'brainerce';
-import { getClient } from '@/lib/brainerce';
 import { useStoreInfo } from '@/providers/store-provider';
 import { useTranslations } from '@/lib/translations';
 import { cn } from '@/lib/utils';
 
 interface CartBundleOfferCardProps {
   offer: CartBundleOfferType;
+  cartId: string;
   onAdd: () => void;
   className?: string;
 }
 
-export function CartBundleOfferCard({ offer, onAdd, className }: CartBundleOfferCardProps) {
+export function CartBundleOfferCard({ offer, cartId, onAdd, className }: CartBundleOfferCardProps) {
   const { storeInfo } = useStoreInfo();
   const t = useTranslations('cart');
   const currency = storeInfo?.currency || 'USD';
@@ -9983,12 +10034,9 @@ export function CartBundleOfferCard({ offer, onAdd, className }: CartBundleOffer
     if (adding) return;
     try {
       setAdding(true);
+      const { getClient } = await import('@/lib/brainerce');
       const client = getClient();
-      await client.smartAddToCart({
-        productId: product.id,
-        variantId: offer.bundleVariantId || undefined,
-        quantity: 1,
-      });
+      await client.addBundleToCart(cartId, offer.id);
       onAdd();
     } catch (err) {
       console.error('Failed to add bundle item:', err);

package/dist/index.mjs

@@ -3127,7 +3127,12 @@ export default function CartPage() {
             <div className="mt-6 space-y-3">
               <h3 className="text-foreground text-sm font-semibold">{t('bundleOffers')}</h3>
               {bundles.bundles.map((offer) => (
-                <CartBundleOfferCard key={offer.id} offer={offer} onAdd={refreshCart} />
+                <CartBundleOfferCard
+                  key={offer.id}
+                  offer={offer}
+                  cartId={cart.id}
+                  onAdd={refreshCart}
+                />
               ))}
             </div>
           )}
@@ -7624,8 +7629,9 @@ export function PaymentStep({ checkoutId, className }: PaymentStepProps) {
       })
       .catch(() => null);
 
-    // B) Load + init SDK as early as possible
+    // B) Load + init SDK as early as possible (skip for sandbox)
     providerPromise.then((providerSdk) => {
+      if (providerSdk?.renderType === 'sandbox') return;
       if (providerSdk?.renderType === 'sdk-widget' && providerSdk.scriptUrl) {
         currentSdk = providerSdk;
         loadScript(providerSdk);
@@ -7652,6 +7658,9 @@ export function PaymentStep({ checkoutId, className }: PaymentStepProps) {
       const sdk = resolveClientSdk(intent, providerSdk);
       currentSdk = sdk;
 
+      // Sandbox mode \u2014 no SDK to load, UI handles it
+      if (sdk.renderType === 'sandbox') return;
+
       if (sdk.renderType === 'redirect') {
         window.location.href = intent.clientSecret;
         return;
@@ -7746,6 +7755,48 @@ export function PaymentStep({ checkoutId, className }: PaymentStepProps) {
 
   const sdk = resolveClientSdk(paymentIntent, preloadedSdk);
 
+  if (sdk.renderType === 'sandbox') {
+    const handleCompleteSandbox = async () => {
+      setLoading(true);
+      try {
+        const client = getClient();
+        await client.completeGuestCheckout(checkoutId);
+        window.location.href = \`/order-confirmation?checkout_id=\${checkoutId}\`;
+      } catch (err) {
+        setError(err instanceof Error ? err.message : t('paymentError'));
+        setLoading(false);
+      }
+    };
+
+    return (
+      <div className={cn('py-8 text-center', className)}>
+        <div className="mx-auto max-w-md rounded-lg border border-amber-200 bg-amber-50 p-6">
+          <svg
+            className="mx-auto mb-3 h-10 w-10 text-amber-500"
+            fill="none"
+            viewBox="0 0 24 24"
+            stroke="currentColor"
+          >
+            <path
+              strokeLinecap="round"
+              strokeLinejoin="round"
+              strokeWidth={1.5}
+              d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-2.5L13.732 4.5c-.77-.833-2.694-.833-3.464 0L3.34 16.5c-.77.833.192 2.5 1.732 2.5z"
+            />
+          </svg>
+          <h3 className="text-foreground mb-1 text-lg font-semibold">{t('sandboxTitle')}</h3>
+          <p className="text-muted-foreground mb-4 text-sm">{t('sandboxDescription')}</p>
+          <button
+            onClick={handleCompleteSandbox}
+            className="inline-flex items-center rounded-md bg-amber-500 px-6 py-2.5 text-sm font-medium text-white transition-colors hover:bg-amber-600"
+          >
+            {t('completeTestOrder')}
+          </button>
+        </div>
+      </div>
+    );
+  }
+
   if (sdk.renderType === 'sdk-widget') {
     const containerId =
       sdk.containerId || \`\${paymentIntent.provider || 'payment'}-payment-container\`;
@@ -9903,18 +9954,18 @@ import { useState } from 'react';
 import Image from 'next/image';
 import type { CartBundleOffer as CartBundleOfferType } from 'brainerce';
 import { formatPrice } from 'brainerce';
-import { getClient } from '@/lib/brainerce';
 import { useStoreInfo } from '@/providers/store-provider';
 import { useTranslations } from '@/lib/translations';
 import { cn } from '@/lib/utils';
 
 interface CartBundleOfferCardProps {
   offer: CartBundleOfferType;
+  cartId: string;
   onAdd: () => void;
   className?: string;
 }
 
-export function CartBundleOfferCard({ offer, onAdd, className }: CartBundleOfferCardProps) {
+export function CartBundleOfferCard({ offer, cartId, onAdd, className }: CartBundleOfferCardProps) {
   const { storeInfo } = useStoreInfo();
   const t = useTranslations('cart');
   const currency = storeInfo?.currency || 'USD';
@@ -9938,12 +9989,9 @@ export function CartBundleOfferCard({ offer, onAdd, className }: CartBundleOffer
     if (adding) return;
     try {
       setAdding(true);
+      const { getClient } = await import('@/lib/brainerce');
       const client = getClient();
-      await client.smartAddToCart({
-        productId: product.id,
-        variantId: offer.bundleVariantId || undefined,
-        quantity: 1,
-      });
+      await client.addBundleToCart(cartId, offer.id);
       onAdd();
     } catch (err) {
       console.error('Failed to add bundle item:', err);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brainerce/mcp-server",
-  "version": "2.1.1",
+  "version": "2.3.0",
   "description": "MCP server for AI-powered Brainerce store building. Provides SDK docs, types, and code examples to AI tools like Lovable, Cursor, and Claude Code.",
   "bin": {
     "brainerce-mcp": "dist/bin/stdio.js"