nitrostack 1.0.15 → 1.0.16

package/src/studio/package.json

@@ -16,6 +16,7 @@
     "@fontsource/jetbrains-mono": "^5.2.8",
     "@modelcontextprotocol/sdk": "^1.0.4",
     "clsx": "^2.1.0",
+    "eventsource": "^2.0.2",
     "lucide-react": "^0.546.0",
     "next": "^14.2.5",
     "react": "^18.3.1",

package/templates/typescript-auth/README.md

@@ -57,10 +57,12 @@ npm run dev
 ```
 
 This starts:
-- **MCP Server** (stdio mode) - Hot reloads on code changes
+- **MCP Server** (dual transport: STDIO + HTTP on port 3002) - Hot reloads on code changes
 - **Studio** on http://localhost:3000 - Visual testing environment
 - **Widget Dev Server** on http://localhost:3001 - Hot module replacement
 
+> 💡 **Dual Transport**: Your server exposes tools via both STDIO (for direct connections) and HTTP (for remote access on port 3002). Switch between transports in Studio → Settings.
+
 The `nitrostack dev` command handles everything automatically:
 - ✅ Auto-detects widget directory
 - ✅ Installs dependencies (if needed)

package/templates/typescript-auth/src/db/database.ts

@@ -109,14 +109,13 @@ export function initializeSchema(): void {
     CREATE TABLE IF NOT EXISTS orders (
       id TEXT PRIMARY KEY,
       user_id TEXT NOT NULL,
-      address_id TEXT NOT NULL,
-      total_amount REAL NOT NULL,
+      shipping_address_id TEXT NOT NULL,
+      total REAL NOT NULL,
       status TEXT NOT NULL DEFAULT 'pending',
-      payment_method TEXT NOT NULL DEFAULT 'cash_on_delivery',
+      payment_method TEXT NOT NULL DEFAULT 'credit_card',
       created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-      updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
       FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE,
-      FOREIGN KEY (address_id) REFERENCES addresses(id)
+      FOREIGN KEY (shipping_address_id) REFERENCES addresses(id)
     )
   `);
   
@@ -126,10 +125,8 @@ export function initializeSchema(): void {
       id TEXT PRIMARY KEY,
       order_id TEXT NOT NULL,
       product_id TEXT NOT NULL,
-      product_name TEXT NOT NULL,
-      product_price REAL NOT NULL,
       quantity INTEGER NOT NULL,
-      subtotal REAL NOT NULL,
+      price REAL NOT NULL,
       FOREIGN KEY (order_id) REFERENCES orders(id) ON DELETE CASCADE,
       FOREIGN KEY (product_id) REFERENCES products(id)
     )

package/templates/typescript-auth/src/index.ts

@@ -15,8 +15,19 @@ async function bootstrap() {
   // Create and start the MCP server from AppModule
   const server = await McpApplicationFactory.create(AppModule);
   
-  // Start the server
-  await server.start();
+  // Start the server with dual transport (STDIO + HTTP)
+  // This allows both direct stdio connections and HTTP-based connections
+  // Note: Studio runs on 3000, Widgets on 3001, so MCP HTTP uses 3002
+  const port = parseInt(process.env.PORT || '3002');
+  await server.start('dual', {
+    port,
+    host: '0.0.0.0',
+    basePath: '/mcp',
+  });
+  
+  console.error(`\n🚀 Server started successfully (DUAL: STDIO + HTTP)`);
+  console.error(`📡 MCP Protocol: STDIO (for direct connections)`);
+  console.error(`🌐 HTTP Server: http://0.0.0.0:${port}/mcp`);
 }
 
 // Start the application

package/templates/typescript-auth/src/modules/addresses/addresses.tools.ts

@@ -13,14 +13,14 @@ export class AddressesTools {
    */
   @Tool({
     name: 'add_address',
-    description: 'Add a new shipping address. Requires authentication.',
+    description: 'Add a new shipping address. Requires authentication. SMART TIP: If user mentions a well-known city, infer the state and country (e.g., Bangalore → Karnataka, India; New York → NY, USA; London → England, UK).',
     inputSchema: z.object({
       full_name: z.string().describe('Full name for delivery'),
       street: z.string().describe('Street address'),
-      city: z.string().describe('City'),
-      state: z.string().describe('State/Province'),
-      zip_code: z.string().describe('ZIP/Postal code'),
-      country: z.string().default('USA').describe('Country'),
+      city: z.string().describe('City name (e.g., Bangalore, San Francisco, London)'),
+      state: z.string().optional().describe('State/Province (e.g., Karnataka, CA, England). Can be inferred from city in many cases.'),
+      zip_code: z.string().optional().describe('ZIP/Postal code (optional, can be left empty)'),
+      country: z.string().default('USA').describe('Country (e.g., India, USA, UK). Can be inferred from well-known cities.'),
       phone: z.string().describe('Contact phone number'),
       is_default: z.boolean().default(false).describe('Set as default address'),
     }),
@@ -49,6 +49,44 @@ export class AddressesTools {
     const userId = context.auth?.subject;
     const addressId = uuidv4();
     
+    // Smart defaults for common locations
+    const cityLower = input.city?.toLowerCase() || '';
+    
+    // If state not provided, try to infer from well-known cities
+    if (!input.state) {
+      const cityToState: Record<string, { state: string; country: string }> = {
+        'bangalore': { state: 'Karnataka', country: 'India' },
+        'bengaluru': { state: 'Karnataka', country: 'India' },
+        'mumbai': { state: 'Maharashtra', country: 'India' },
+        'delhi': { state: 'Delhi', country: 'India' },
+        'hyderabad': { state: 'Telangana', country: 'India' },
+        'chennai': { state: 'Tamil Nadu', country: 'India' },
+        'pune': { state: 'Maharashtra', country: 'India' },
+        'kolkata': { state: 'West Bengal', country: 'India' },
+        'san francisco': { state: 'CA', country: 'USA' },
+        'new york': { state: 'NY', country: 'USA' },
+        'los angeles': { state: 'CA', country: 'USA' },
+        'chicago': { state: 'IL', country: 'USA' },
+        'boston': { state: 'MA', country: 'USA' },
+        'seattle': { state: 'WA', country: 'USA' },
+        'london': { state: 'England', country: 'UK' },
+        'manchester': { state: 'England', country: 'UK' },
+        'toronto': { state: 'Ontario', country: 'Canada' },
+        'vancouver': { state: 'British Columbia', country: 'Canada' },
+      };
+      
+      const inferred = cityToState[cityLower];
+      if (inferred) {
+        input.state = inferred.state;
+        input.country = inferred.country;
+        context.logger.info(`Smart inference: ${input.city} → ${input.state}, ${input.country}`);
+      }
+    }
+    
+    // Set defaults if still missing
+    input.state = input.state || 'N/A';
+    input.zip_code = input.zip_code || '000000';
+    
     // If this is set as default, unset other defaults
     if (input.is_default) {
       db.prepare(`
@@ -72,12 +110,17 @@ export class AddressesTools {
       input.is_default ? 1 : 0
     );
     
-    context.logger.info(`Address added: ${input.city}, ${input.state}`);
+    context.logger.info(`Address added: ${input.city}, ${input.state}, ${input.country}`);
     
     return {
       message: 'Address added successfully!',
       addressId,
       isDefault: input.is_default,
+      address: {
+        city: input.city,
+        state: input.state,
+        country: input.country,
+      },
     };
   }
 

package/templates/typescript-auth/src/modules/cart/cart.tools.ts

@@ -13,9 +13,9 @@ export class CartTools {
    */
   @Tool({
     name: 'add_to_cart',
-    description: 'Add a product to the shopping cart. Requires authentication.',
+    description: 'Add a product to the shopping cart. Requires authentication. IMPORTANT: Use the product ID from browse_products or get_product_details results. If user says "add apple", find the product with name "Apple" from previous results and use its ID.',
     inputSchema: z.object({
-      product_id: z.string().describe('The ID of the product to add'),
+      product_id: z.string().describe('The ID of the product to add (e.g., "prod-3"). Get this from browse_products results by matching the product name.'),
       quantity: z.number().min(1).default(1).describe('Quantity to add'),
     }),
     examples: {
@@ -77,13 +77,11 @@ export class CartTools {
       
       return {
         message: `Added to cart!`,
-        item: {
-          id: input.product_id,
-          name: product.name,
-          price: product.price,
-          quantity: input.quantity,
-          image_url: product.image_url,
-        },
+        product_id: input.product_id,
+        product_name: product.name,
+        price: product.price,
+        quantity: input.quantity,
+        image_url: product.image_url,
         cartItemCount: cartCount.total || 0,
       };
     } else {
@@ -104,13 +102,11 @@ export class CartTools {
       
       return {
         message: `Added to cart!`,
-        item: {
-          id: input.product_id,
-          name: product.name,
-          price: product.price,
-          quantity: input.quantity,
-          image_url: product.image_url,
-        },
+        product_id: input.product_id,
+        product_name: product.name,
+        price: product.price,
+        quantity: input.quantity,
+        image_url: product.image_url,
         cartItemCount: cartCount.total || 0,
       };
     }
@@ -156,7 +152,7 @@ export class CartTools {
     const userId = context.auth?.subject;
     
     const items: any[] = db.prepare(`
-      SELECT c.id, c.quantity, p.id as product_id, p.name, p.price, p.image_url
+      SELECT c.id, c.quantity, p.id as product_id, p.name, p.price, p.image_url, p.description, p.stock
       FROM carts c
       JOIN products p ON c.product_id = p.id
       WHERE c.user_id = ?

package/templates/typescript-auth/src/modules/orders/orders.tools.ts

@@ -13,10 +13,10 @@ export class OrdersTools {
    */
   @Tool({
     name: 'create_order',
-    description: 'Create an order from the current shopping cart. Requires authentication and at least one item in cart.',
+    description: 'Create an order from the current shopping cart. Requires authentication and at least one item in cart. A default shipping address will be automatically created if the user doesn\'t have one.',
     inputSchema: z.object({
       payment_method: z.enum(['credit_card', 'paypal', 'apple_pay']).describe('Payment method'),
-      shipping_address_id: z.string().optional().describe('Address ID for shipping. Uses default if not provided.'),
+      shipping_address_id: z.string().optional().describe('Optional: Address ID for shipping. If not provided, uses or creates a default address automatically.'),
     }),
     examples: {
       request: {
@@ -57,16 +57,21 @@ export class OrdersTools {
   @Widget('order-confirmation')
   @UseGuards(JWTGuard)
   async createOrder(input: any, context: ExecutionContext) {
-    const db = getDatabase();
-    const userId = context.auth?.subject;
-    
-    // Get cart items
-    const cartItems: any[] = db.prepare(`
-      SELECT c.*, p.name, p.price, p.stock, p.image_url
-      FROM carts c
-      JOIN products p ON c.product_id = p.id
-      WHERE c.user_id = ?
-    `).all(userId);
+    try {
+      const db = getDatabase();
+      const userId = context.auth?.subject;
+      
+      context.logger.info(`Creating order for user: ${userId}, payment_method: ${input.payment_method}`);
+      
+      // Get cart items
+      const cartItems: any[] = db.prepare(`
+        SELECT c.*, p.name, p.price, p.stock, p.image_url
+        FROM carts c
+        JOIN products p ON c.product_id = p.id
+        WHERE c.user_id = ?
+      `).all(userId);
+      
+      context.logger.info(`Found ${cartItems.length} items in cart`);
     
     if (cartItems.length === 0) {
       throw new Error('Cart is empty. Add items to cart before creating an order.');
@@ -79,7 +84,7 @@ export class OrdersTools {
       }
     }
     
-    // Get shipping address
+    // Get shipping address (create a temporary one if none exists)
     let addressId = input.shipping_address_id;
     if (!addressId) {
       const defaultAddress: any = db.prepare(`
@@ -87,10 +92,18 @@ export class OrdersTools {
       `).get(userId);
       
       if (!defaultAddress) {
-        throw new Error('No shipping address found. Please add an address first.');
+        // Create a temporary default address for the user
+        const tempAddressId = uuidv4();
+        db.prepare(`
+          INSERT INTO addresses (id, user_id, full_name, street, city, state, zip_code, country, phone, is_default)
+          VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+        `).run(tempAddressId, userId, 'Default User', '123 Main St', 'City', 'State', '00000', 'USA', '000-000-0000', 1);
+        
+        context.logger.info('Created temporary default address for user');
+        addressId = tempAddressId;
+      } else {
+        addressId = defaultAddress.id;
       }
-      
-      addressId = defaultAddress.id;
     }
     
     // Calculate total
@@ -143,6 +156,10 @@ export class OrdersTools {
         })),
       },
     };
+    } catch (error: any) {
+      context.logger.error(`Order creation failed: ${error.message}`, { error, stack: error.stack });
+      throw new Error(`Failed to create order: ${error.message}`);
+    }
   }
 
   /**
@@ -200,6 +217,11 @@ export class OrdersTools {
     return {
       orders,
       totalOrders: orders.length,
+      pagination: {
+        page: 1,
+        totalPages: 1,
+        totalResults: orders.length,
+      },
     };
   }
 

package/templates/typescript-auth/src/modules/products/products.tools.ts

@@ -39,10 +39,10 @@ export class ProductsTools {
    */
   @Tool({
     name: 'browse_products',
-    description: 'Browse available products. Can filter by category, search by name, and paginate results.',
+    description: 'Browse available products. Can filter by category, search by name, and paginate results. Returns products with their IDs which can be used with other tools like add_to_cart.',
     inputSchema: z.object({
       category: z.enum(['Electronics', 'Clothing', 'Home', 'Books', 'Sports', 'All']).default('All').describe('Filter by product category'),
-      search: z.string().optional().describe('Search products by name'),
+      search: z.string().optional().describe('Search products by name (e.g., "apple" will find products containing "apple")'),
       page: z.number().min(1).default(1).describe('Page number for pagination'),
       limit: z.number().min(1).max(50).default(10).describe('Number of products per page'),
     }),
@@ -174,9 +174,9 @@ export class ProductsTools {
    */
   @Tool({
     name: 'get_product_details',
-    description: 'Get detailed information about a specific product by ID.',
+    description: 'Get detailed information about a specific product by ID. Use this if you need more details about a product from browse_products results.',
     inputSchema: z.object({
-      product_id: z.string().describe('The ID of the product to retrieve'),
+      product_id: z.string().describe('The ID of the product to retrieve (e.g., "prod-3" from browse_products results)'),
     }),
     examples: {
       request: {

package/templates/typescript-auth/src/widgets/app/order-confirmation/page.tsx

@@ -5,8 +5,33 @@ import { OrderConfirmationData } from '../../types/tool-data';
 import * as styles from '../../styles/ecommerce';
 
 function OrderConfirmationWidget({ data }: { data: OrderConfirmationData }) {
+  // Handle missing or undefined data
+  if (!data) {
+    return (
+      <div style={styles.containerStyle}>
+        <div style={styles.cardStyle}>
+          <p style={{ color: styles.colors.error }}>No order data available</p>
+        </div>
+      </div>
+    );
+  }
+
   const { order, message } = data;
 
+  // Handle missing order
+  if (!order || !order.id) {
+    return (
+      <div style={styles.containerStyle}>
+        <div style={styles.cardStyle}>
+          <p style={{ color: styles.colors.error }}>Order data incomplete</p>
+          <pre style={{ fontSize: '12px', marginTop: '10px' }}>
+            {JSON.stringify(data, null, 2)}
+          </pre>
+        </div>
+      </div>
+    );
+  }
+
   return (
     <div style={styles.containerStyle}>
       <div style={{

package/templates/typescript-auth/src/widgets/app/products-grid/page.tsx

@@ -5,8 +5,33 @@ import { ProductsGridData } from '../../types/tool-data';
 import * as styles from '../../styles/ecommerce';
 
 function ProductsGridWidget({ data }: { data: ProductsGridData }) {
+  // Handle missing or undefined data
+  if (!data) {
+    return (
+      <div style={styles.containerStyle}>
+        <div style={styles.cardStyle}>
+          <p style={{ color: styles.colors.error }}>No data available</p>
+        </div>
+      </div>
+    );
+  }
+
   const { products, pagination } = data;
 
+  // Handle missing products array
+  if (!products || !Array.isArray(products)) {
+    return (
+      <div style={styles.containerStyle}>
+        <div style={styles.cardStyle}>
+          <p style={{ color: styles.colors.error }}>Invalid product data</p>
+          <pre style={{ fontSize: '12px', marginTop: '10px' }}>
+            {JSON.stringify(data, null, 2)}
+          </pre>
+        </div>
+      </div>
+    );
+  }
+
   if (products.length === 0) {
     return (
       <div style={styles.containerStyle}>
@@ -152,7 +177,7 @@ function ProductsGridWidget({ data }: { data: ProductsGridData }) {
         ))}
       </div>
 
-      {pagination.totalPages > 1 && (
+      {pagination && pagination.totalPages > 1 && (
         <div style={{
           marginTop: styles.spacing['2xl'],
           textAlign: 'center',

package/templates/typescript-auth-api-key/README.md

@@ -43,7 +43,9 @@ npm run build
 nitrostack dev
 ```
 
-The server will start with API key authentication enabled.
+The server will start with API key authentication enabled in dual transport mode (STDIO + HTTP on port 3002).
+
+> 💡 **Dual Transport**: Your server exposes tools via both STDIO (for direct connections) and HTTP (for remote access on port 3002). Switch between transports in Studio → Settings.
 
 ### 2. Open NitroStack Studio
 

package/templates/typescript-auth-api-key/src/index.ts

@@ -30,10 +30,18 @@ async function bootstrap() {
     console.error('   - Protected tools require valid API key');
     console.error('   - Public tools accessible without authentication\n');
 
-    // Start the MCP server
-    await app.start();
+    // Start the MCP server with dual transport (STDIO + HTTP)
+    // Note: Studio runs on 3000, Widgets on 3001, so MCP HTTP uses 3002
+    const port = parseInt(process.env.PORT || '3002');
+    await app.start('dual', {
+      port,
+      host: '0.0.0.0',
+      basePath: '/mcp',
+    });
     
-    console.error('🚀 Server started successfully!');
+    console.error('🚀 Server started successfully (DUAL: STDIO + HTTP)!');
+    console.error(`📡 MCP Protocol: STDIO (for direct connections)`);
+    console.error(`🌐 HTTP Server: http://0.0.0.0:${port}/mcp`);
     console.error('   Open NitroStack Studio to test the server');
     console.error('   Set your API key in Studio → Auth → API Key section\n');
     

package/templates/typescript-starter/README.md

@@ -46,10 +46,12 @@ npm run dev
 ```
 
 This starts:
-- **MCP Server** (stdio mode) - Hot reloads on code changes
+- **MCP Server** (dual transport: STDIO + HTTP on port 3002) - Hot reloads on code changes
 - **Studio** on http://localhost:3000 - Visual testing environment
 - **Widget Dev Server** on http://localhost:3001 - Hot module replacement
 
+> 💡 **Dual Transport**: Your server exposes tools via both STDIO (for direct connections) and HTTP (for remote access on port 3002). Switch between transports in Studio → Settings.
+
 The `nitrostack dev` command handles everything automatically:
 - ✅ Auto-detects widget directory
 - ✅ Installs dependencies (if needed)