epicmerch-mcp 1.0.0

package/src/tools/scaffold.js

@@ -0,0 +1,278 @@
+// src/tools/scaffold.js
+const TEMPLATES = {
+  react: {
+    auth: [
+      {
+        path: 'src/lib/epicmerch.js',
+        content: `import EpicMerch from 'epicmerch';
+
+export const store = new EpicMerch({
+  apiKey: import.meta.env.VITE_API_KEY,
+  ...(import.meta.env.VITE_API_URL && { baseUrl: import.meta.env.VITE_API_URL }),
+});
+`,
+      },
+      {
+        path: 'src/components/Login.jsx',
+        content: `import { useState } from 'react';
+import { store } from '../lib/epicmerch';
+
+export default function Login({ onLogin }) {
+  const [phone, setPhone] = useState('');
+  const [otp, setOtp] = useState('');
+  const [step, setStep] = useState('phone');
+
+  const sendOtp = async () => {
+    await store.auth.sendOtp(phone, 'phone');
+    setStep('otp');
+  };
+
+  const verify = async () => {
+    const result = await store.auth.verifyOtp(phone, otp, {});
+    if (result.token) {
+      store.setCustomerToken(result.token);
+      localStorage.setItem('customerInfo', JSON.stringify(result));
+      onLogin(result);
+    }
+  };
+
+  return (
+    <div>
+      {step === 'phone' ? (
+        <>
+          <input value={phone} onChange={e => setPhone(e.target.value)} placeholder="+919876543210" />
+          <button onClick={sendOtp}>Send OTP</button>
+        </>
+      ) : (
+        <>
+          <input value={otp} onChange={e => setOtp(e.target.value)} placeholder="Enter OTP" />
+          <button onClick={verify}>Verify</button>
+        </>
+      )}
+    </div>
+  );
+}
+`,
+      },
+    ],
+
+    products: [
+      {
+        path: 'src/components/ProductCard.jsx',
+        content: `export default function ProductCard({ product, onAddToCart }) {
+  return (
+    <div className="product-card">
+      <img src={product.images?.[0]} alt={product.name} />
+      <h3>{product.name}</h3>
+      <p>₹{product.price}</p>
+      <button onClick={() => onAddToCart(product._id)}>Add to Cart</button>
+    </div>
+  );
+}
+`,
+      },
+      {
+        path: 'src/components/ProductList.jsx',
+        content: `import { useEffect, useState } from 'react';
+import { store } from '../lib/epicmerch';
+import ProductCard from './ProductCard';
+
+export default function ProductList() {
+  const [products, setProducts] = useState([]);
+  const [category, setCategory] = useState(undefined);
+  const [categories, setCategories] = useState([]);
+
+  useEffect(() => {
+    store.categories.list().then(setCategories);
+  }, []);
+
+  useEffect(() => {
+    store.products.list({ type: category, limit: 12 }).then(d => setProducts(d.products));
+  }, [category]);
+
+  const addToCart = async (productId) => {
+    await store.cart.add(productId, 1);
+  };
+
+  return (
+    <div>
+      <div>
+        {categories.map(c => (
+          <button key={c} onClick={() => setCategory(c === 'All' ? undefined : c)}>{c}</button>
+        ))}
+      </div>
+      <div className="product-grid">
+        {products.map(p => <ProductCard key={p._id} product={p} onAddToCart={addToCart} />)}
+      </div>
+    </div>
+  );
+}
+`,
+      },
+    ],
+
+    orders: [
+      {
+        path: 'src/components/Cart.jsx',
+        content: `import { useEffect, useState } from 'react';
+import { store } from '../lib/epicmerch';
+
+export default function Cart({ onCheckout }) {
+  const [cart, setCart] = useState({ items: [] });
+
+  useEffect(() => { store.cart.get().then(setCart); }, []);
+
+  const remove = async (productId) => {
+    await store.cart.remove(productId);
+    store.cart.get().then(setCart);
+  };
+
+  const total = cart.items?.reduce((sum, i) => sum + i.price * i.qty, 0) ?? 0;
+
+  return (
+    <div>
+      {cart.items?.map(item => (
+        <div key={item.productId}>
+          <span>{item.name} x{item.qty}</span>
+          <span>₹{item.price * item.qty}</span>
+          <button onClick={() => remove(item.productId)}>Remove</button>
+        </div>
+      ))}
+      <p>Total: ₹{total}</p>
+      <button onClick={onCheckout}>Checkout</button>
+    </div>
+  );
+}
+`,
+      },
+      {
+        path: 'src/components/Checkout.jsx',
+        content: `import { useState } from 'react';
+import { store } from '../lib/epicmerch';
+
+export default function Checkout({ cart, onSuccess }) {
+  const [address, setAddress] = useState({ street: '', city: '', postalCode: '', country: 'India' });
+
+  const placeOrder = async () => {
+    const total = cart.items.reduce((s, i) => s + i.price * i.qty, 0);
+    const { orderId } = await store.orders.create({
+      orderItems: cart.items.map(i => ({ productId: i.productId, qty: i.qty, price: i.price })),
+      shippingAddress: address,
+      paymentMethod: 'Razorpay',
+      totalPrice: total,
+    });
+
+    const config = await store.payment.getConfig();
+    const { razorpayOrderId } = await store.payment.createOrder(total * 100, orderId);
+
+    const rzp = new window.Razorpay({
+      key: config.razorpayKeyId,
+      order_id: razorpayOrderId,
+      amount: total * 100,
+      handler: async (response) => {
+        await store.payment.verify({ ...response, orderId });
+        await store.cart.clear();
+        onSuccess(orderId);
+      },
+    });
+    rzp.open();
+  };
+
+  return (
+    <div>
+      <input placeholder="Street" onChange={e => setAddress(a => ({ ...a, street: e.target.value }))} />
+      <input placeholder="City" onChange={e => setAddress(a => ({ ...a, city: e.target.value }))} />
+      <input placeholder="Postal Code" onChange={e => setAddress(a => ({ ...a, postalCode: e.target.value }))} />
+      <button onClick={placeOrder}>Place Order</button>
+    </div>
+  );
+}
+`,
+      },
+      {
+        path: 'src/components/OrderHistory.jsx',
+        content: `import { useEffect, useState } from 'react';
+import { store } from '../lib/epicmerch';
+
+export default function OrderHistory() {
+  const [orders, setOrders] = useState([]);
+
+  useEffect(() => { store.orders.list().then(setOrders); }, []);
+
+  return (
+    <div>
+      {orders.map(order => (
+        <div key={order._id}>
+          <span>Order #{order._id.slice(-6)}</span>
+          <span>{order.status}</span>
+          <span>₹{order.totalPrice}</span>
+        </div>
+      ))}
+    </div>
+  );
+}
+`,
+      },
+    ],
+
+    envExample: {
+      path: '.env.example',
+      content: `VITE_API_KEY=your_epicmerch_api_key_here\n# VITE_API_URL=http://localhost:5001/api\n`,
+    },
+  },
+};
+
+function getFrameworkTemplates(framework) {
+  if (!TEMPLATES[framework]) {
+    throw new Error(`Framework "${framework}" not supported. Supported: ${Object.keys(TEMPLATES).join(', ')}`);
+  }
+  return TEMPLATES[framework];
+}
+
+export function scaffoldTools() {
+  return {
+    async store_scaffold_auth({ framework = 'react' } = {}) {
+      try {
+        const t = getFrameworkTemplates(framework);
+        return { content: [{ type: 'text', text: JSON.stringify(t.auth, null, 2) }] };
+      } catch (err) {
+        return { isError: true, content: [{ type: 'text', text: err.message }] };
+      }
+    },
+
+    async store_scaffold_products({ framework = 'react' } = {}) {
+      try {
+        const t = getFrameworkTemplates(framework);
+        return { content: [{ type: 'text', text: JSON.stringify(t.products, null, 2) }] };
+      } catch (err) {
+        return { isError: true, content: [{ type: 'text', text: err.message }] };
+      }
+    },
+
+    async store_scaffold_orders({ framework = 'react' } = {}) {
+      try {
+        const t = getFrameworkTemplates(framework);
+        return { content: [{ type: 'text', text: JSON.stringify(t.orders, null, 2) }] };
+      } catch (err) {
+        return { isError: true, content: [{ type: 'text', text: err.message }] };
+      }
+    },
+
+    async store_scaffold_full({ framework = 'react' } = {}) {
+      try {
+        const t = getFrameworkTemplates(framework);
+        const files = [...t.auth, ...t.products, ...t.orders, t.envExample];
+        return { content: [{ type: 'text', text: JSON.stringify(files, null, 2) }] };
+      } catch (err) {
+        return { isError: true, content: [{ type: 'text', text: err.message }] };
+      }
+    },
+  };
+}
+
+export const scaffoldToolDefs = [
+  { name: 'store_scaffold_auth', description: 'Generate auth integration files (SDK init + Login component) for a framework. Returns [{path, content}] — write these files to the project.', schema: { framework: { type: 'string', description: 'react (default)' } } },
+  { name: 'store_scaffold_products', description: 'Generate product catalog components (ProductList, ProductCard) for a framework.', schema: { framework: { type: 'string' } } },
+  { name: 'store_scaffold_orders', description: 'Generate cart + order management components (Cart, Checkout, OrderHistory) for a framework.', schema: { framework: { type: 'string' } } },
+  { name: 'store_scaffold_full', description: 'Generate a complete EpicMerch-integrated storefront scaffold (auth + products + orders + .env.example).', schema: { framework: { type: 'string' } } },
+];

package/src/tools/session.js

@@ -0,0 +1,44 @@
+export function sessionTools(session) {
+  return {
+    async store_list_stores(_args) {
+      const stores = session.listStores();
+      const lines = stores.map(s => `- ${s.name}${s.active ? ' (active)' : ''}`).join('\n');
+      return { content: [{ type: 'text', text: `Configured stores:\n${lines}` }] };
+    },
+
+    async store_switch({ name }) {
+      try {
+        session.switch(name);
+        return { content: [{ type: 'text', text: `Switched to store: ${name}` }] };
+      } catch (err) {
+        return { isError: true, content: [{ type: 'text', text: err.message }] };
+      }
+    },
+
+    async store_add({ name, apiKey }) {
+      session.addStore(name, apiKey);
+      return { content: [{ type: 'text', text: `Store "${name}" added. Call store_switch to activate it.` }] };
+    },
+  };
+}
+
+export const sessionToolDefs = [
+  {
+    name: 'store_list_stores',
+    description: 'List all configured EpicMerch stores and which is currently active.',
+    schema: {},
+  },
+  {
+    name: 'store_switch',
+    description: 'Switch the active store. All subsequent tool calls will use this store\'s credentials.',
+    schema: { name: { type: 'string', description: 'Store name as configured in EPICMERCH_STORES' } },
+  },
+  {
+    name: 'store_add',
+    description: 'Add a new EpicMerch store to the session without restarting.',
+    schema: {
+      name: { type: 'string', description: 'Store name' },
+      apiKey: { type: 'string', description: 'EpicMerch API key for this store' },
+    },
+  },
+];