@brainerce/mcp-server 2.3.0 → 2.4.0

package/dist/bin/http.js

@@ -314,6 +314,20 @@ function CheckoutPage() {
   if (!paymentData) return <div>Unable to initialize payment</div>;
 
   // Render payment UI based on provider
+  if (paymentData.provider === 'sandbox') {
+    return (
+      <div className="text-center p-6 bg-amber-50 border border-amber-200 rounded-lg">
+        <h3 className="font-semibold mb-2">Test Mode</h3>
+        <p className="text-sm text-gray-600 mb-4">No real payment will be charged.</p>
+        <button onClick={async () => {
+          await client.completeGuestCheckout(checkoutId);
+          window.location.href = \\\`/order-confirmation?checkout_id=\\\${checkoutId}\\\`;
+        }} className="bg-amber-500 text-white px-6 py-2 rounded">
+          Complete Test Order
+        </button>
+      </div>
+    );
+  }
   if (paymentData.provider === 'grow') {
     return <GrowPaymentForm paymentUrl={paymentData.clientSecret} checkoutId={paymentData.checkoutId} />;
   }
@@ -432,11 +446,12 @@ const growProvider = providers.find(p => p.provider === 'grow');
 const paypalProvider = providers.find(p => p.provider === 'paypal');
 \`\`\`
 
-Each provider has: \`id\`, \`provider\` ('stripe'|'grow'|'paypal'), \`name\`, \`publicKey\`, \`stripeAccountId\` (Stripe only), \`supportedMethods\`, \`testMode\`, \`isDefault\`.
+Each provider has: \`id\`, \`provider\` ('stripe'|'grow'|'paypal'|'sandbox'), \`name\`, \`publicKey\`, \`stripeAccountId\` (Stripe only), \`supportedMethods\`, \`testMode\`, \`isDefault\`.
 
 - **Stripe:** \`npm install @stripe/stripe-js @stripe/react-stripe-js\` \u2014 \`loadStripe(publicKey, { stripeAccount })\`
 - **Grow:** No SDK \u2014 uses iframe with payment URL. Supports credit cards, Bit, Apple Pay, Google Pay.
-- **PayPal:** \`npm install @paypal/react-paypal-js\` \u2014 \`PayPalScriptProvider\` + \`PayPalButtons\``;
+- **PayPal:** \`npm install @paypal/react-paypal-js\` \u2014 \`PayPalScriptProvider\` + \`PayPalButtons\`
+- **Sandbox:** No SDK needed \u2014 when \`sandboxPaymentsEnabled\` is true, \`getPaymentProviders()\` includes a sandbox provider with \`renderType: 'sandbox'\`. Show a "Complete Test Order" button. Call \`completeGuestCheckout(checkoutId)\` to finalize. Orders are marked \`isTestOrder: true\`.`;
 }
 function getProductsSection(_currency) {
   return `## Products & Variants
@@ -10533,7 +10548,8 @@ var DETAILED = `# Required Pages \u2014 Detailed Guide
 - Step 1: Customer info (email, name)
 - Step 2: Shipping address form
 - Step 3: Shipping method selection (from rates returned by \`setShippingAddress()\`)
-- Step 4: Payment (auto-detects Stripe/Grow/PayPal via \`getPaymentProviders()\`)
+- Step 4: Payment (auto-detects Stripe/Grow/PayPal/Sandbox via \`getPaymentProviders()\`)
+- If \`sandboxPaymentsEnabled\` is on, a sandbox provider with \`renderType: 'sandbox'\` is included \u2014 show a "Complete Test Order" button instead of real payment UI. Call \`completeGuestCheckout(checkoutId)\` to finalize.
 - Order summary sidebar showing \`checkout.lineItems\` (NOT cart.items!)
 - Tax display after address entry
 - Reservation countdown
@@ -10775,6 +10791,9 @@ function formatCapabilities(caps) {
   lines.push(
     `- Email verification: ${caps.connection.requireEmailVerification ? "required" : "not required"}`
   );
+  lines.push(
+    `- Sandbox payments: ${caps.connection.sandboxPaymentsEnabled ? "enabled (test orders without real payment)" : "disabled"}`
+  );
   lines.push(
     `- Inventory reservation: ${caps.connection.reservationStrategy} (${caps.connection.reservationTimeout} min timeout)`
   );
@@ -10814,6 +10833,11 @@ function formatCapabilities(caps) {
       'Email verification is required \u2014 ALWAYS build the verify-email page. Use get-code-example("verify-email").'
     );
   }
+  if (caps.connection.sandboxPaymentsEnabled) {
+    suggestions.push(
+      `Sandbox payments are enabled \u2014 the PaymentStep component shows a "Complete Test Order" button when renderType is 'sandbox'. No real charges. Test orders are marked isTestOrder: true.`
+    );
+  }
   if (caps.connection.reservationStrategy !== "ON_PAYMENT") {
     suggestions.push(
       'Inventory reservation is active \u2014 show a countdown timer. Use get-code-example("reservation-countdown").'
@@ -10967,6 +10991,9 @@ function formatCapabilitiesSummary(caps) {
   lines.push(
     `- Guest checkout tracking: ${caps.connection.guestCheckoutTracking ? "enabled" : "disabled"}`
   );
+  lines.push(
+    `- Sandbox payments: ${caps.connection.sandboxPaymentsEnabled ? "ENABLED \u2014 payment step shows test order button (no real charges)" : "disabled"}`
+  );
   return lines.join("\n");
 }
 function buildStoreBundle(options) {

package/dist/bin/stdio.js

@@ -312,6 +312,20 @@ function CheckoutPage() {
   if (!paymentData) return <div>Unable to initialize payment</div>;
 
   // Render payment UI based on provider
+  if (paymentData.provider === 'sandbox') {
+    return (
+      <div className="text-center p-6 bg-amber-50 border border-amber-200 rounded-lg">
+        <h3 className="font-semibold mb-2">Test Mode</h3>
+        <p className="text-sm text-gray-600 mb-4">No real payment will be charged.</p>
+        <button onClick={async () => {
+          await client.completeGuestCheckout(checkoutId);
+          window.location.href = \\\`/order-confirmation?checkout_id=\\\${checkoutId}\\\`;
+        }} className="bg-amber-500 text-white px-6 py-2 rounded">
+          Complete Test Order
+        </button>
+      </div>
+    );
+  }
   if (paymentData.provider === 'grow') {
     return <GrowPaymentForm paymentUrl={paymentData.clientSecret} checkoutId={paymentData.checkoutId} />;
   }
@@ -430,11 +444,12 @@ const growProvider = providers.find(p => p.provider === 'grow');
 const paypalProvider = providers.find(p => p.provider === 'paypal');
 \`\`\`
 
-Each provider has: \`id\`, \`provider\` ('stripe'|'grow'|'paypal'), \`name\`, \`publicKey\`, \`stripeAccountId\` (Stripe only), \`supportedMethods\`, \`testMode\`, \`isDefault\`.
+Each provider has: \`id\`, \`provider\` ('stripe'|'grow'|'paypal'|'sandbox'), \`name\`, \`publicKey\`, \`stripeAccountId\` (Stripe only), \`supportedMethods\`, \`testMode\`, \`isDefault\`.
 
 - **Stripe:** \`npm install @stripe/stripe-js @stripe/react-stripe-js\` \u2014 \`loadStripe(publicKey, { stripeAccount })\`
 - **Grow:** No SDK \u2014 uses iframe with payment URL. Supports credit cards, Bit, Apple Pay, Google Pay.
-- **PayPal:** \`npm install @paypal/react-paypal-js\` \u2014 \`PayPalScriptProvider\` + \`PayPalButtons\``;
+- **PayPal:** \`npm install @paypal/react-paypal-js\` \u2014 \`PayPalScriptProvider\` + \`PayPalButtons\`
+- **Sandbox:** No SDK needed \u2014 when \`sandboxPaymentsEnabled\` is true, \`getPaymentProviders()\` includes a sandbox provider with \`renderType: 'sandbox'\`. Show a "Complete Test Order" button. Call \`completeGuestCheckout(checkoutId)\` to finalize. Orders are marked \`isTestOrder: true\`.`;
 }
 function getProductsSection(_currency) {
   return `## Products & Variants
@@ -10531,7 +10546,8 @@ var DETAILED = `# Required Pages \u2014 Detailed Guide
 - Step 1: Customer info (email, name)
 - Step 2: Shipping address form
 - Step 3: Shipping method selection (from rates returned by \`setShippingAddress()\`)
-- Step 4: Payment (auto-detects Stripe/Grow/PayPal via \`getPaymentProviders()\`)
+- Step 4: Payment (auto-detects Stripe/Grow/PayPal/Sandbox via \`getPaymentProviders()\`)
+- If \`sandboxPaymentsEnabled\` is on, a sandbox provider with \`renderType: 'sandbox'\` is included \u2014 show a "Complete Test Order" button instead of real payment UI. Call \`completeGuestCheckout(checkoutId)\` to finalize.
 - Order summary sidebar showing \`checkout.lineItems\` (NOT cart.items!)
 - Tax display after address entry
 - Reservation countdown
@@ -10773,6 +10789,9 @@ function formatCapabilities(caps) {
   lines.push(
     `- Email verification: ${caps.connection.requireEmailVerification ? "required" : "not required"}`
   );
+  lines.push(
+    `- Sandbox payments: ${caps.connection.sandboxPaymentsEnabled ? "enabled (test orders without real payment)" : "disabled"}`
+  );
   lines.push(
     `- Inventory reservation: ${caps.connection.reservationStrategy} (${caps.connection.reservationTimeout} min timeout)`
   );
@@ -10812,6 +10831,11 @@ function formatCapabilities(caps) {
       'Email verification is required \u2014 ALWAYS build the verify-email page. Use get-code-example("verify-email").'
     );
   }
+  if (caps.connection.sandboxPaymentsEnabled) {
+    suggestions.push(
+      `Sandbox payments are enabled \u2014 the PaymentStep component shows a "Complete Test Order" button when renderType is 'sandbox'. No real charges. Test orders are marked isTestOrder: true.`
+    );
+  }
   if (caps.connection.reservationStrategy !== "ON_PAYMENT") {
     suggestions.push(
       'Inventory reservation is active \u2014 show a countdown timer. Use get-code-example("reservation-countdown").'
@@ -10965,6 +10989,9 @@ function formatCapabilitiesSummary(caps) {
   lines.push(
     `- Guest checkout tracking: ${caps.connection.guestCheckoutTracking ? "enabled" : "disabled"}`
   );
+  lines.push(
+    `- Sandbox payments: ${caps.connection.sandboxPaymentsEnabled ? "ENABLED \u2014 payment step shows test order button (no real charges)" : "disabled"}`
+  );
   return lines.join("\n");
 }
 function buildStoreBundle(options) {

package/dist/index.d.mts

@@ -50,6 +50,7 @@ interface StoreCapabilities {
         ordersWriteEnabled: boolean;
         guestCheckoutTracking: boolean;
         requireEmailVerification: boolean;
+        sandboxPaymentsEnabled: boolean;
         reservationStrategy: string;
         reservationTimeout: number;
         lowStockWarning: boolean;

package/dist/index.d.ts

@@ -50,6 +50,7 @@ interface StoreCapabilities {
         ordersWriteEnabled: boolean;
         guestCheckoutTracking: boolean;
         requireEmailVerification: boolean;
+        sandboxPaymentsEnabled: boolean;
         reservationStrategy: string;
         reservationTimeout: number;
         lowStockWarning: boolean;

package/dist/index.js

@@ -329,6 +329,20 @@ function CheckoutPage() {
   if (!paymentData) return <div>Unable to initialize payment</div>;
 
   // Render payment UI based on provider
+  if (paymentData.provider === 'sandbox') {
+    return (
+      <div className="text-center p-6 bg-amber-50 border border-amber-200 rounded-lg">
+        <h3 className="font-semibold mb-2">Test Mode</h3>
+        <p className="text-sm text-gray-600 mb-4">No real payment will be charged.</p>
+        <button onClick={async () => {
+          await client.completeGuestCheckout(checkoutId);
+          window.location.href = \\\`/order-confirmation?checkout_id=\\\${checkoutId}\\\`;
+        }} className="bg-amber-500 text-white px-6 py-2 rounded">
+          Complete Test Order
+        </button>
+      </div>
+    );
+  }
   if (paymentData.provider === 'grow') {
     return <GrowPaymentForm paymentUrl={paymentData.clientSecret} checkoutId={paymentData.checkoutId} />;
   }
@@ -447,11 +461,12 @@ const growProvider = providers.find(p => p.provider === 'grow');
 const paypalProvider = providers.find(p => p.provider === 'paypal');
 \`\`\`
 
-Each provider has: \`id\`, \`provider\` ('stripe'|'grow'|'paypal'), \`name\`, \`publicKey\`, \`stripeAccountId\` (Stripe only), \`supportedMethods\`, \`testMode\`, \`isDefault\`.
+Each provider has: \`id\`, \`provider\` ('stripe'|'grow'|'paypal'|'sandbox'), \`name\`, \`publicKey\`, \`stripeAccountId\` (Stripe only), \`supportedMethods\`, \`testMode\`, \`isDefault\`.
 
 - **Stripe:** \`npm install @stripe/stripe-js @stripe/react-stripe-js\` \u2014 \`loadStripe(publicKey, { stripeAccount })\`
 - **Grow:** No SDK \u2014 uses iframe with payment URL. Supports credit cards, Bit, Apple Pay, Google Pay.
-- **PayPal:** \`npm install @paypal/react-paypal-js\` \u2014 \`PayPalScriptProvider\` + \`PayPalButtons\``;
+- **PayPal:** \`npm install @paypal/react-paypal-js\` \u2014 \`PayPalScriptProvider\` + \`PayPalButtons\`
+- **Sandbox:** No SDK needed \u2014 when \`sandboxPaymentsEnabled\` is true, \`getPaymentProviders()\` includes a sandbox provider with \`renderType: 'sandbox'\`. Show a "Complete Test Order" button. Call \`completeGuestCheckout(checkoutId)\` to finalize. Orders are marked \`isTestOrder: true\`.`;
 }
 function getProductsSection(_currency) {
   return `## Products & Variants
@@ -10548,7 +10563,8 @@ var DETAILED = `# Required Pages \u2014 Detailed Guide
 - Step 1: Customer info (email, name)
 - Step 2: Shipping address form
 - Step 3: Shipping method selection (from rates returned by \`setShippingAddress()\`)
-- Step 4: Payment (auto-detects Stripe/Grow/PayPal via \`getPaymentProviders()\`)
+- Step 4: Payment (auto-detects Stripe/Grow/PayPal/Sandbox via \`getPaymentProviders()\`)
+- If \`sandboxPaymentsEnabled\` is on, a sandbox provider with \`renderType: 'sandbox'\` is included \u2014 show a "Complete Test Order" button instead of real payment UI. Call \`completeGuestCheckout(checkoutId)\` to finalize.
 - Order summary sidebar showing \`checkout.lineItems\` (NOT cart.items!)
 - Tax display after address entry
 - Reservation countdown
@@ -10790,6 +10806,9 @@ function formatCapabilities(caps) {
   lines.push(
     `- Email verification: ${caps.connection.requireEmailVerification ? "required" : "not required"}`
   );
+  lines.push(
+    `- Sandbox payments: ${caps.connection.sandboxPaymentsEnabled ? "enabled (test orders without real payment)" : "disabled"}`
+  );
   lines.push(
     `- Inventory reservation: ${caps.connection.reservationStrategy} (${caps.connection.reservationTimeout} min timeout)`
   );
@@ -10829,6 +10848,11 @@ function formatCapabilities(caps) {
       'Email verification is required \u2014 ALWAYS build the verify-email page. Use get-code-example("verify-email").'
     );
   }
+  if (caps.connection.sandboxPaymentsEnabled) {
+    suggestions.push(
+      `Sandbox payments are enabled \u2014 the PaymentStep component shows a "Complete Test Order" button when renderType is 'sandbox'. No real charges. Test orders are marked isTestOrder: true.`
+    );
+  }
   if (caps.connection.reservationStrategy !== "ON_PAYMENT") {
     suggestions.push(
       'Inventory reservation is active \u2014 show a countdown timer. Use get-code-example("reservation-countdown").'
@@ -10982,6 +11006,9 @@ function formatCapabilitiesSummary(caps) {
   lines.push(
     `- Guest checkout tracking: ${caps.connection.guestCheckoutTracking ? "enabled" : "disabled"}`
   );
+  lines.push(
+    `- Sandbox payments: ${caps.connection.sandboxPaymentsEnabled ? "ENABLED \u2014 payment step shows test order button (no real charges)" : "disabled"}`
+  );
   return lines.join("\n");
 }
 function buildStoreBundle(options) {

package/dist/index.mjs

@@ -284,6 +284,20 @@ function CheckoutPage() {
   if (!paymentData) return <div>Unable to initialize payment</div>;
 
   // Render payment UI based on provider
+  if (paymentData.provider === 'sandbox') {
+    return (
+      <div className="text-center p-6 bg-amber-50 border border-amber-200 rounded-lg">
+        <h3 className="font-semibold mb-2">Test Mode</h3>
+        <p className="text-sm text-gray-600 mb-4">No real payment will be charged.</p>
+        <button onClick={async () => {
+          await client.completeGuestCheckout(checkoutId);
+          window.location.href = \\\`/order-confirmation?checkout_id=\\\${checkoutId}\\\`;
+        }} className="bg-amber-500 text-white px-6 py-2 rounded">
+          Complete Test Order
+        </button>
+      </div>
+    );
+  }
   if (paymentData.provider === 'grow') {
     return <GrowPaymentForm paymentUrl={paymentData.clientSecret} checkoutId={paymentData.checkoutId} />;
   }
@@ -402,11 +416,12 @@ const growProvider = providers.find(p => p.provider === 'grow');
 const paypalProvider = providers.find(p => p.provider === 'paypal');
 \`\`\`
 
-Each provider has: \`id\`, \`provider\` ('stripe'|'grow'|'paypal'), \`name\`, \`publicKey\`, \`stripeAccountId\` (Stripe only), \`supportedMethods\`, \`testMode\`, \`isDefault\`.
+Each provider has: \`id\`, \`provider\` ('stripe'|'grow'|'paypal'|'sandbox'), \`name\`, \`publicKey\`, \`stripeAccountId\` (Stripe only), \`supportedMethods\`, \`testMode\`, \`isDefault\`.
 
 - **Stripe:** \`npm install @stripe/stripe-js @stripe/react-stripe-js\` \u2014 \`loadStripe(publicKey, { stripeAccount })\`
 - **Grow:** No SDK \u2014 uses iframe with payment URL. Supports credit cards, Bit, Apple Pay, Google Pay.
-- **PayPal:** \`npm install @paypal/react-paypal-js\` \u2014 \`PayPalScriptProvider\` + \`PayPalButtons\``;
+- **PayPal:** \`npm install @paypal/react-paypal-js\` \u2014 \`PayPalScriptProvider\` + \`PayPalButtons\`
+- **Sandbox:** No SDK needed \u2014 when \`sandboxPaymentsEnabled\` is true, \`getPaymentProviders()\` includes a sandbox provider with \`renderType: 'sandbox'\`. Show a "Complete Test Order" button. Call \`completeGuestCheckout(checkoutId)\` to finalize. Orders are marked \`isTestOrder: true\`.`;
 }
 function getProductsSection(_currency) {
   return `## Products & Variants
@@ -10503,7 +10518,8 @@ var DETAILED = `# Required Pages \u2014 Detailed Guide
 - Step 1: Customer info (email, name)
 - Step 2: Shipping address form
 - Step 3: Shipping method selection (from rates returned by \`setShippingAddress()\`)
-- Step 4: Payment (auto-detects Stripe/Grow/PayPal via \`getPaymentProviders()\`)
+- Step 4: Payment (auto-detects Stripe/Grow/PayPal/Sandbox via \`getPaymentProviders()\`)
+- If \`sandboxPaymentsEnabled\` is on, a sandbox provider with \`renderType: 'sandbox'\` is included \u2014 show a "Complete Test Order" button instead of real payment UI. Call \`completeGuestCheckout(checkoutId)\` to finalize.
 - Order summary sidebar showing \`checkout.lineItems\` (NOT cart.items!)
 - Tax display after address entry
 - Reservation countdown
@@ -10745,6 +10761,9 @@ function formatCapabilities(caps) {
   lines.push(
     `- Email verification: ${caps.connection.requireEmailVerification ? "required" : "not required"}`
   );
+  lines.push(
+    `- Sandbox payments: ${caps.connection.sandboxPaymentsEnabled ? "enabled (test orders without real payment)" : "disabled"}`
+  );
   lines.push(
     `- Inventory reservation: ${caps.connection.reservationStrategy} (${caps.connection.reservationTimeout} min timeout)`
   );
@@ -10784,6 +10803,11 @@ function formatCapabilities(caps) {
       'Email verification is required \u2014 ALWAYS build the verify-email page. Use get-code-example("verify-email").'
     );
   }
+  if (caps.connection.sandboxPaymentsEnabled) {
+    suggestions.push(
+      `Sandbox payments are enabled \u2014 the PaymentStep component shows a "Complete Test Order" button when renderType is 'sandbox'. No real charges. Test orders are marked isTestOrder: true.`
+    );
+  }
   if (caps.connection.reservationStrategy !== "ON_PAYMENT") {
     suggestions.push(
       'Inventory reservation is active \u2014 show a countdown timer. Use get-code-example("reservation-countdown").'
@@ -10937,6 +10961,9 @@ function formatCapabilitiesSummary(caps) {
   lines.push(
     `- Guest checkout tracking: ${caps.connection.guestCheckoutTracking ? "enabled" : "disabled"}`
   );
+  lines.push(
+    `- Sandbox payments: ${caps.connection.sandboxPaymentsEnabled ? "ENABLED \u2014 payment step shows test order button (no real charges)" : "disabled"}`
+  );
   return lines.join("\n");
 }
 function buildStoreBundle(options) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brainerce/mcp-server",
-  "version": "2.3.0",
+  "version": "2.4.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"