nitrostack 1.0.0 → 1.0.2

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

@@ -0,0 +1,374 @@
+import { v4 as uuidv4 } from 'uuid';
+import bcrypt from 'bcryptjs';
+import { getDatabase } from './database.js';
+
+/**
+ * Seed database with initial data
+ */
+
+export function seedUsers(): void {
+  const db = getDatabase();
+  
+  // Data from https://dummyjson.com/users
+  const users = [
+    {
+      id: 'user-emily',
+      email: 'emily.johnson@x.dummyjson.com',
+      password: 'password123',
+      name: 'Emily Johnson',
+      profile_picture: 'https://dummyjson.com/icon/emilys/128',
+    },
+    {
+      id: 'user-michael',
+      email: 'michael.williams@x.dummyjson.com',
+      password: 'password123',
+      name: 'Michael Williams',
+      profile_picture: 'https://dummyjson.com/icon/michaelw/128',
+    },
+    {
+      id: 'user-sophia',
+      email: 'sophia.brown@x.dummyjson.com',
+      password: 'password123',
+      name: 'Sophia Brown',
+      profile_picture: 'https://dummyjson.com/icon/sophiab/128',
+    },
+    {
+      id: 'user-james',
+      email: 'james.davis@x.dummyjson.com',
+      password: 'password123',
+      name: 'James Davis',
+      profile_picture: 'https://dummyjson.com/icon/jamesd/128',
+    },
+    {
+      id: 'user-emma',
+      email: 'emma.miller@x.dummyjson.com',
+      password: 'password123',
+      name: 'Emma Miller',
+      profile_picture: 'https://dummyjson.com/icon/emmaj/128',
+    },
+  ];
+  
+  const stmt = db.prepare(`
+    INSERT OR REPLACE INTO users (id, email, password_hash, name, profile_picture)
+    VALUES (?, ?, ?, ?, ?)
+  `);
+  
+  for (const user of users) {
+    const passwordHash = bcrypt.hashSync(user.password, 10);
+    stmt.run(user.id, user.email, passwordHash, user.name, user.profile_picture);
+  }
+  
+  console.log(`✅ Seeded ${users.length} users (from DummyJSON)`);
+}
+
+export function seedProducts(): void {
+  const db = getDatabase();
+  
+  // Data from https://dummyjson.com/products
+  const products = [
+    // Beauty Products
+    {
+      id: 'prod-1',
+      name: 'Essence Mascara Lash Princess',
+      description: 'The Essence Mascara Lash Princess is a popular mascara known for its volumizing and lengthening effects.',
+      price: 9.99,
+      category: 'Beauty',
+      stock: 99,
+      image_url: 'https://cdn.dummyjson.com/product-images/beauty/essence-mascara-lash-princess/thumbnail.webp',
+    },
+    {
+      id: 'prod-2',
+      name: 'Eyeshadow Palette with Mirror',
+      description: 'The Eyeshadow Palette offers a versatile range of eyeshadow shades for creating stunning eye looks.',
+      price: 19.99,
+      category: 'Beauty',
+      stock: 34,
+      image_url: 'https://cdn.dummyjson.com/product-images/beauty/eyeshadow-palette-with-mirror/thumbnail.webp',
+    },
+    {
+      id: 'prod-3',
+      name: 'Powder Canister',
+      description: 'The Powder Canister is a finely milled setting powder designed to set makeup and control shine.',
+      price: 14.99,
+      category: 'Beauty',
+      stock: 89,
+      image_url: 'https://cdn.dummyjson.com/product-images/beauty/powder-canister/thumbnail.webp',
+    },
+    {
+      id: 'prod-4',
+      name: 'Red Lipstick',
+      description: 'The Red Lipstick is a classic and bold choice for adding a pop of color to your lips.',
+      price: 12.99,
+      category: 'Beauty',
+      stock: 91,
+      image_url: 'https://cdn.dummyjson.com/product-images/beauty/red-lipstick/thumbnail.webp',
+    },
+    {
+      id: 'prod-5',
+      name: 'Red Nail Polish',
+      description: 'The Red Nail Polish offers a rich and glossy red hue for vibrant and polished nails.',
+      price: 8.99,
+      category: 'Beauty',
+      stock: 79,
+      image_url: 'https://cdn.dummyjson.com/product-images/beauty/red-nail-polish/thumbnail.webp',
+    },
+    
+    // Fragrances
+    {
+      id: 'prod-6',
+      name: 'Calvin Klein CK One',
+      description: 'CK One by Calvin Klein is a classic unisex fragrance, known for its fresh and clean scent.',
+      price: 49.99,
+      category: 'Fragrances',
+      stock: 17,
+      image_url: 'https://cdn.dummyjson.com/product-images/fragrances/calvin-klein-ck-one/thumbnail.webp',
+    },
+    {
+      id: 'prod-7',
+      name: 'Chanel Coco Noir Eau De',
+      description: 'Coco Noir by Chanel is an elegant and mysterious fragrance, featuring notes of grapefruit and rose.',
+      price: 129.99,
+      category: 'Fragrances',
+      stock: 41,
+      image_url: 'https://cdn.dummyjson.com/product-images/fragrances/chanel-coco-noir-eau-de/thumbnail.webp',
+    },
+    {
+      id: 'prod-8',
+      name: 'Dior J\'adore',
+      description: 'J\'adore by Dior is a luxurious and floral fragrance, known for its sophisticated blend of ylang-ylang.',
+      price: 89.99,
+      category: 'Fragrances',
+      stock: 91,
+      image_url: 'https://cdn.dummyjson.com/product-images/fragrances/dior-j-adore/thumbnail.webp',
+    },
+    {
+      id: 'prod-9',
+      name: 'Dolce Shine Eau de',
+      description: 'Dolce Shine by Dolce & Gabbana is a vibrant and fruity fragrance, featuring notes of mango and jasmine.',
+      price: 69.99,
+      category: 'Fragrances',
+      stock: 3,
+      image_url: 'https://cdn.dummyjson.com/product-images/fragrances/dolce-shine-eau-de/thumbnail.webp',
+    },
+    {
+      id: 'prod-10',
+      name: 'Gucci Bloom Eau de',
+      description: 'Gucci Bloom by Gucci is a floral and captivating fragrance, with notes of tuberose and jasmine.',
+      price: 79.99,
+      category: 'Fragrances',
+      stock: 93,
+      image_url: 'https://cdn.dummyjson.com/product-images/fragrances/gucci-bloom-eau-de/thumbnail.webp',
+    },
+    
+    // Furniture
+    {
+      id: 'prod-11',
+      name: 'Annibale Colombo Bed',
+      description: 'The Annibale Colombo Bed is a luxurious and elegant bed frame, crafted with high-quality materials.',
+      price: 1899.99,
+      category: 'Furniture',
+      stock: 47,
+      image_url: 'https://cdn.dummyjson.com/product-images/furniture/annibale-colombo-bed/thumbnail.webp',
+    },
+    {
+      id: 'prod-12',
+      name: 'Annibale Colombo Sofa',
+      description: 'The Annibale Colombo Sofa is a sophisticated and comfortable seating option, featuring exquisite design.',
+      price: 2499.99,
+      category: 'Furniture',
+      stock: 16,
+      image_url: 'https://cdn.dummyjson.com/product-images/furniture/annibale-colombo-sofa/thumbnail.webp',
+    },
+    {
+      id: 'prod-13',
+      name: 'Bedside Table African Cherry',
+      description: 'The Bedside Table in African Cherry is a stylish and functional addition to your bedroom.',
+      price: 299.99,
+      category: 'Furniture',
+      stock: 16,
+      image_url: 'https://cdn.dummyjson.com/product-images/furniture/bedside-table-african-cherry/thumbnail.webp',
+    },
+    {
+      id: 'prod-14',
+      name: 'Knoll Saarinen Executive Conference Chair',
+      description: 'The Knoll Saarinen Executive Conference Chair is a modern and ergonomic chair, perfect for your office.',
+      price: 499.99,
+      category: 'Furniture',
+      stock: 47,
+      image_url: 'https://cdn.dummyjson.com/product-images/furniture/knoll-saarinen-executive-conference-chair/thumbnail.webp',
+    },
+    {
+      id: 'prod-15',
+      name: 'Wooden Bathroom Sink With Mirror',
+      description: 'The Wooden Bathroom Sink with Mirror is a unique and stylish addition to your bathroom.',
+      price: 799.99,
+      category: 'Furniture',
+      stock: 95,
+      image_url: 'https://cdn.dummyjson.com/product-images/furniture/wooden-bathroom-sink-with-mirror/thumbnail.webp',
+    },
+    
+    // Groceries
+    {
+      id: 'prod-16',
+      name: 'Apple',
+      description: 'Fresh and crisp apples, perfect for snacking or incorporating into various recipes.',
+      price: 1.99,
+      category: 'Groceries',
+      stock: 9,
+      image_url: 'https://cdn.dummyjson.com/product-images/groceries/apple/thumbnail.webp',
+    },
+    {
+      id: 'prod-17',
+      name: 'Beef Steak',
+      description: 'High-quality beef steak, great for grilling or cooking to your preferred level of doneness.',
+      price: 12.99,
+      category: 'Groceries',
+      stock: 96,
+      image_url: 'https://cdn.dummyjson.com/product-images/groceries/beef-steak/thumbnail.webp',
+    },
+    {
+      id: 'prod-18',
+      name: 'Cat Food',
+      description: 'Nutritious cat food formulated to meet the dietary needs of your feline friend.',
+      price: 8.99,
+      category: 'Groceries',
+      stock: 13,
+      image_url: 'https://cdn.dummyjson.com/product-images/groceries/cat-food/thumbnail.webp',
+    },
+    {
+      id: 'prod-19',
+      name: 'Chicken Meat',
+      description: 'Fresh and tender chicken meat, suitable for various culinary preparations.',
+      price: 9.99,
+      category: 'Groceries',
+      stock: 69,
+      image_url: 'https://cdn.dummyjson.com/product-images/groceries/chicken-meat/thumbnail.webp',
+    },
+    {
+      id: 'prod-20',
+      name: 'Cooking Oil',
+      description: 'Versatile cooking oil suitable for frying, sautéing, and various culinary applications.',
+      price: 4.99,
+      category: 'Groceries',
+      stock: 22,
+      image_url: 'https://cdn.dummyjson.com/product-images/groceries/cooking-oil/thumbnail.webp',
+    },
+    {
+      id: 'prod-21',
+      name: 'Cucumber',
+      description: 'Crisp and hydrating cucumbers, ideal for salads, snacks, or as a refreshing side.',
+      price: 1.49,
+      category: 'Groceries',
+      stock: 22,
+      image_url: 'https://cdn.dummyjson.com/product-images/groceries/cucumber/thumbnail.webp',
+    },
+    {
+      id: 'prod-22',
+      name: 'Dog Food',
+      description: 'Specially formulated dog food designed to provide essential nutrients for your canine companion.',
+      price: 10.99,
+      category: 'Groceries',
+      stock: 40,
+      image_url: 'https://cdn.dummyjson.com/product-images/groceries/dog-food/thumbnail.webp',
+    },
+    {
+      id: 'prod-23',
+      name: 'Eggs',
+      description: 'Fresh eggs, a versatile ingredient for baking, cooking, or breakfast.',
+      price: 2.99,
+      category: 'Groceries',
+      stock: 10,
+      image_url: 'https://cdn.dummyjson.com/product-images/groceries/eggs/thumbnail.webp',
+    },
+    {
+      id: 'prod-24',
+      name: 'Fish Steak',
+      description: 'Quality fish steak, suitable for grilling, baking, or pan-searing.',
+      price: 14.99,
+      category: 'Groceries',
+      stock: 99,
+      image_url: 'https://cdn.dummyjson.com/product-images/groceries/fish-steak/thumbnail.webp',
+    },
+    {
+      id: 'prod-25',
+      name: 'Green Bell Pepper',
+      description: 'Fresh green bell pepper, perfect for adding color and flavor to your dishes.',
+      price: 1.29,
+      category: 'Groceries',
+      stock: 89,
+      image_url: 'https://cdn.dummyjson.com/product-images/groceries/green-bell-pepper/thumbnail.webp',
+    },
+    {
+      id: 'prod-26',
+      name: 'Green Chili Pepper',
+      description: 'Spicy green chili pepper, ideal for adding heat to your favorite recipes.',
+      price: 0.99,
+      category: 'Groceries',
+      stock: 8,
+      image_url: 'https://cdn.dummyjson.com/product-images/groceries/green-chili-pepper/thumbnail.webp',
+    },
+    {
+      id: 'prod-27',
+      name: 'Honey Jar',
+      description: 'Pure and natural honey in a convenient jar, perfect for sweetening beverages or drizzling over food.',
+      price: 6.99,
+      category: 'Groceries',
+      stock: 34,
+      image_url: 'https://cdn.dummyjson.com/product-images/groceries/honey-jar/thumbnail.webp',
+    },
+    {
+      id: 'prod-28',
+      name: 'Ice Cream',
+      description: 'Creamy and delicious ice cream, available in various flavors for a delightful treat.',
+      price: 5.49,
+      category: 'Groceries',
+      stock: 27,
+      image_url: 'https://cdn.dummyjson.com/product-images/groceries/ice-cream/thumbnail.webp',
+    },
+    {
+      id: 'prod-29',
+      name: 'Juice',
+      description: 'Refreshing fruit juice, packed with vitamins and great for staying hydrated.',
+      price: 3.99,
+      category: 'Groceries',
+      stock: 50,
+      image_url: 'https://cdn.dummyjson.com/product-images/groceries/juice/thumbnail.webp',
+    },
+    {
+      id: 'prod-30',
+      name: 'Kiwi',
+      description: 'Nutrient-rich kiwi, perfect for snacking or adding a tropical twist to your dishes.',
+      price: 2.49,
+      category: 'Groceries',
+      stock: 99,
+      image_url: 'https://cdn.dummyjson.com/product-images/groceries/kiwi/thumbnail.webp',
+    },
+  ];
+  
+  const stmt = db.prepare(`
+    INSERT OR REPLACE INTO products (id, name, description, price, category, stock, image_url)
+    VALUES (?, ?, ?, ?, ?, ?, ?)
+  `);
+  
+  for (const product of products) {
+    stmt.run(
+      product.id,
+      product.name,
+      product.description,
+      product.price,
+      product.category,
+      product.stock,
+      product.image_url
+    );
+  }
+  
+  console.log(`✅ Seeded ${products.length} products (from DummyJSON)`);
+}
+
+export function seedAll(): void {
+  console.log('🌱 Seeding database...');
+  seedUsers();
+  seedProducts();
+  console.log('✅ Database seeding complete!');
+}
+

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

@@ -0,0 +1,87 @@
+import * as dotenv from 'dotenv';
+import { initializeSchema, clearAllData } from './database.js';
+import { seedAll } from './seed.js';
+import crypto from 'crypto';
+import fs from 'fs';
+import path from 'path';
+
+/**
+ * Database setup script
+ * Run with: npm run setup-db
+ */
+
+// Load environment variables
+dotenv.config();
+
+console.log('╔══════════════════════════════════════════════════════════════╗');
+console.log('║                                                              ║');
+console.log('║           E-COMMERCE MCP SERVER - DATABASE SETUP             ║');
+console.log('║                                                              ║');
+console.log('╚══════════════════════════════════════════════════════════════╝\n');
+
+try {
+  // 1. Initialize schema
+  console.log('📦 Initializing database schema...');
+  initializeSchema();
+  console.log('✅ Schema initialized\n');
+  
+  // 2. Clear existing data (optional)
+  console.log('🗑️  Clearing existing data...');
+  clearAllData();
+  console.log('✅ Data cleared\n');
+  
+  // 3. Seed data
+  seedAll();
+  console.log('');
+  
+  // 4. Generate JWT secret if not exists
+  const envPath = path.join(process.cwd(), '.env');
+  const envExamplePath = path.join(process.cwd(), '.env.example');
+  
+  if (!fs.existsSync(envPath) && fs.existsSync(envExamplePath)) {
+    console.log('📝 Creating .env file...');
+    let envContent = fs.readFileSync(envExamplePath, 'utf-8');
+    
+    // Generate JWT secret (64 random bytes encoded as base64url)
+    const jwtSecret = 'jwt_secret_' + crypto.randomBytes(32).toString('base64url');
+    envContent = envContent.replace('your-jwt-secret-here-change-this', jwtSecret);
+    
+    fs.writeFileSync(envPath, envContent);
+    console.log('✅ .env file created with JWT secret\n');
+  }
+  
+  // 5. Print test credentials
+  console.log('═══════════════════════════════════════════════════════════════');
+  console.log('                     TEST CREDENTIALS                         ');
+  console.log('═══════════════════════════════════════════════════════════════\n');
+  
+  console.log('🧪 Test Users (use these in the inspector):');
+  console.log('');
+  console.log('  👤 Alice Johnson');
+  console.log('     Email: alice@example.com');
+  console.log('     Password: password123');
+  console.log('');
+  console.log('  👤 Bob Smith');
+  console.log('     Email: bob@example.com');
+  console.log('     Password: password123');
+  console.log('');
+  console.log('  👤 Charlie Brown');
+  console.log('     Email: charlie@example.com');
+  console.log('     Password: password123');
+  console.log('');
+  
+  console.log('═══════════════════════════════════════════════════════════════\n');
+  
+  console.log('🎉 Database setup complete!\n');
+  console.log('Next steps:');
+  console.log('  1. npm install');
+  console.log('  2. npm run build');
+  console.log('  3. npm run dev');
+  console.log('  4. Test in inspector with the credentials above\n');
+  
+  process.exit(0);
+} catch (error) {
+  console.error('❌ Setup failed:', error);
+  process.exit(1);
+}
+

package/templates/typescript-auth/src/events/analytics.service.ts

@@ -0,0 +1,52 @@
+import { Injectable, OnEvent } from 'nitrostack';
+
+/**
+ * Analytics Service
+ * 
+ * Tracks events for analytics
+ */
+@Injectable()
+export class AnalyticsService {
+  private events: any[] = [];
+
+  /**
+   * Track order creation
+   */
+  @OnEvent('order.created')
+  async trackOrderCreated(order: any): Promise<void> {
+    this.events.push({
+      type: 'order_created',
+      timestamp: new Date().toISOString(),
+      data: {
+        order_id: order.id,
+        total: order.total,
+        item_count: order.items?.length || 0,
+      },
+    });
+    console.log(`📊 Tracked: Order Created #${order.id}`);
+  }
+
+  /**
+   * Track product viewed
+   */
+  @OnEvent('product.viewed')
+  async trackProductViewed(product: any): Promise<void> {
+    this.events.push({
+      type: 'product_viewed',
+      timestamp: new Date().toISOString(),
+      data: {
+        product_id: product.id,
+        product_name: product.name,
+      },
+    });
+    console.log(`📊 Tracked: Product Viewed - ${product.name}`);
+  }
+
+  /**
+   * Get analytics data
+   */
+  getAnalytics(): any[] {
+    return this.events;
+  }
+}
+

package/templates/typescript-auth/src/events/notification.service.ts

@@ -0,0 +1,40 @@
+import { Injectable, OnEvent } from 'nitrostack';
+
+/**
+ * Notification Service
+ * 
+ * Listens to events and sends notifications
+ */
+@Injectable()
+export class NotificationService {
+  /**
+   * Handle order created event
+   */
+  @OnEvent('order.created')
+  async handleOrderCreated(order: any): Promise<void> {
+    console.log(`📧 Sending order confirmation email for order #${order.id}`);
+    // TODO: Implement actual email sending
+    console.log(`  To: ${order.user_email}`);
+    console.log(`  Subject: Order Confirmation #${order.id}`);
+    console.log(`  Total: $${order.total}`);
+  }
+
+  /**
+   * Handle order shipped event
+   */
+  @OnEvent('order.shipped')
+  async handleOrderShipped(order: any): Promise<void> {
+    console.log(`📦 Sending shipping notification for order #${order.id}`);
+    // TODO: Implement actual notification
+  }
+
+  /**
+   * Handle user registered event
+   */
+  @OnEvent('user.registered')
+  async handleUserRegistered(user: any): Promise<void> {
+    console.log(`👋 Sending welcome email to ${user.email}`);
+    // TODO: Implement actual welcome email
+  }
+}
+

package/templates/typescript-auth/src/filters/global-exception.filter.ts

@@ -0,0 +1,28 @@
+import { ExceptionFilter, ExceptionFilterInterface, ExecutionContext } from 'nitrostack';
+
+/**
+ * Global Exception Filter
+ * 
+ * Handles all unhandled exceptions and formats error responses
+ */
+@ExceptionFilter()
+export class GlobalExceptionFilter implements ExceptionFilterInterface {
+  catch(exception: any, context: ExecutionContext) {
+    context.logger.error('Unhandled exception', {
+      tool: context.toolName || 'unknown',
+      error: exception.message,
+      stack: exception.stack,
+    });
+    
+    // Format error response
+    return {
+      error: true,
+      message: exception.message || 'Internal server error',
+      code: exception.code || 'INTERNAL_ERROR',
+      timestamp: new Date().toISOString(),
+      requestId: context.requestId,
+      tool: context.toolName || 'unknown',
+    };
+  }
+}
+

package/templates/typescript-auth/src/guards/README.md

@@ -0,0 +1,75 @@
+# Guards
+
+Guards are classes that implement the `Guard` interface and determine whether a tool can be executed.
+
+## What are Guards?
+
+Guards in NitroStack are similar to NestJS guards - they handle authorization logic before tool execution. Use the `@UseGuards()` decorator to apply guards to your tools.
+
+## Available Guards
+
+### JWTGuard
+
+Validates JWT tokens and populates `context.auth` with user information.
+
+**Usage:**
+```typescript
+import { JWTGuard } from '../guards/jwt.guard.js';
+
+@Tool({ name: 'get_profile', ... })
+@UseGuards(JWTGuard)
+async getProfile(input: any, context: ExecutionContext) {
+  const userId = context.auth?.subject;
+  // User is already authenticated!
+}
+```
+
+## Creating Custom Guards
+
+Create a class that implements the `Guard` interface:
+
+```typescript
+import { Guard, ExecutionContext } from 'nitrostack';
+
+export class RoleGuard implements Guard {
+  constructor(private requiredRole: string) {}
+
+  async canActivate(context: ExecutionContext): Promise<boolean> {
+    const userRole = context.auth?.role;
+    
+    if (userRole !== this.requiredRole) {
+      throw new Error(`Required role: ${this.requiredRole}`);
+    }
+    
+    return true;
+  }
+}
+```
+
+**Usage:**
+```typescript
+@UseGuards(JWTGuard, new RoleGuard('admin'))
+async deleteUser(input: any, context: ExecutionContext) {
+  // Only admins can execute this
+}
+```
+
+## Guard Execution Order
+
+Guards are executed in the order they are specified:
+```typescript
+@UseGuards(JWTGuard, RoleGuard, PermissionGuard)
+```
+1. JWTGuard validates token
+2. RoleGuard checks user role
+3. PermissionGuard checks specific permissions
+
+If any guard returns `false` or throws an error, execution stops.
+
+## Best Practices
+
+1. **Keep guards focused** - Each guard should have one responsibility
+2. **Reuse guards** - Create guards that can be used across multiple tools
+3. **Clear error messages** - Help users understand why access was denied
+4. **Log important events** - Use `context.logger` for debugging
+