nitrostack 1.0.0 → 1.0.2

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

@@ -0,0 +1,266 @@
+import { 
+  ToolDecorator as Tool, 
+  Widget, 
+  z, 
+  ExecutionContext,
+  Injectable,
+  UseMiddleware,
+  UseInterceptors,
+  UsePipes,
+  UseFilters,
+  Cache,
+  RateLimit,
+} from 'nitrostack';
+import { DatabaseService } from '../../services/database.service.js';
+import { LoggingMiddleware } from '../../middleware/logging.middleware.js';
+import { TransformInterceptor } from '../../interceptors/transform.interceptor.js';
+import { ValidationPipe } from '../../pipes/validation.pipe.js';
+import { GlobalExceptionFilter } from '../../filters/global-exception.filter.js';
+
+/**
+ * Products Tools
+ * 
+ * Demonstrates all V3.1 features:
+ * - Dependency Injection (@Injectable)
+ * - Middleware (@UseMiddleware)
+ * - Interceptors (@UseInterceptors)
+ * - Pipes (@UsePipes)
+ * - Exception Filters (@UseFilters)
+ * - Caching (@Cache)
+ * - Rate Limiting (@RateLimit)
+ */
+@Injectable()
+export class ProductsTools {
+  constructor(private database: DatabaseService) {}
+
+  /**
+   * Browse products - No authentication required
+   * Demonstrates: Middleware, Interceptors, Pipes, Caching
+   */
+  @Tool({
+    name: 'browse_products',
+    description: 'Browse available products. Can filter by category, search by name, and paginate results.',
+    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'),
+      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'),
+    }),
+    examples: {
+      request: {
+        category: 'Beauty',
+        page: 1,
+        limit: 4
+      },
+      response: {
+        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'
+          }
+        ],
+        pagination: {
+          page: 1,
+          limit: 4,
+          totalPages: 2,
+          totalResults: 5
+        }
+      }
+    }
+  })
+  @Widget('products-grid')
+  @UseMiddleware(LoggingMiddleware)
+  @UseInterceptors(TransformInterceptor)
+  @UsePipes(ValidationPipe)
+  @UseFilters(GlobalExceptionFilter)
+  @Cache({ ttl: 60, key: (input) => `products:${input.category}:${input.search}:${input.page}` })
+  async browseProducts(input: any, context: ExecutionContext) {
+    // Apply defaults if not provided
+    const category = input.category || 'All';
+    const page = input.page || 1;
+    const limit = input.limit || 10;
+    const search = input.search || '';
+    
+    const offset = (page - 1) * limit;
+    
+    let query = 'SELECT * FROM products WHERE 1=1';
+    const params: any[] = [];
+    
+    // Filter by category
+    if (category && category !== 'All') {
+      query += ' AND category = ?';
+      params.push(category);
+    }
+    
+    // Search by name
+    if (search) {
+      query += ' AND name LIKE ?';
+      params.push(`%${search}%`);
+    }
+    
+    // Add pagination
+    query += ' ORDER BY name LIMIT ? OFFSET ?';
+    params.push(limit, offset);
+    
+    const products = this.database.query(query, params);
+    
+    // Get total count
+    let countQuery = 'SELECT COUNT(*) as count FROM products WHERE 1=1';
+    const countParams: any[] = [];
+    
+    if (category && category !== 'All') {
+      countQuery += ' AND category = ?';
+      countParams.push(category);
+    }
+    
+    if (search) {
+      countQuery += ' AND name LIKE ?';
+      countParams.push(`%${search}%`);
+    }
+    
+    const result = this.database.queryOne<{ count: number }>(countQuery, countParams);
+    const count = result?.count || 0;
+    const totalPages = Math.ceil(count / limit);
+    
+    context.logger.info(`Browsing products: category=${category}, search=${search}, page=${page}, found=${products.length} products`);
+    
+    return {
+      products,
+      pagination: {
+        page,
+        limit,
+        total: count,
+        totalPages,
+        hasMore: page < totalPages,
+      },
+    };
+  }
+
+  /**
+   * Get product details - No authentication required
+   * Demonstrates: All features + Rate Limiting
+   */
+  @Tool({
+    name: 'get_product_details',
+    description: 'Get detailed information about a specific product by ID.',
+    inputSchema: z.object({
+      product_id: z.string().describe('The ID of the product to retrieve'),
+    }),
+    examples: {
+      request: {
+        product_id: 'prod-1'
+      },
+      response: {
+        product: {
+          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'
+        },
+        availability: 'In Stock',
+        stockMessage: 'Available'
+      }
+    }
+  })
+  @Widget('product-card')
+  @UseMiddleware(LoggingMiddleware)
+  @UseInterceptors(TransformInterceptor)
+  @UsePipes(ValidationPipe)
+  @UseFilters(GlobalExceptionFilter)
+  @Cache({ ttl: 300, key: (input) => `product:${input.product_id}` }) // Cache for 5 minutes
+  @RateLimit({ requests: 100, window: '1m' }) // 100 requests per minute
+  async getProductDetails(input: any, context: ExecutionContext) {
+    const product = this.database.queryOne(`SELECT * FROM products WHERE id = ?`, [input.product_id]);
+    
+    if (!product) {
+      throw new Error(`Product with ID ${input.product_id} not found`);
+    }
+    
+    context.logger.info(`Retrieved details for product: ${(product as any).name}`);
+    
+    return {
+      product,
+      availability: (product as any).stock > 0 ? 'In Stock' : 'Out of Stock',
+      stockMessage: (product as any).stock > 10 
+        ? 'Available' 
+        : (product as any).stock > 0 
+          ? `Only ${(product as any).stock} left!` 
+          : 'Currently unavailable',
+    };
+  }
+
+  /**
+   * Get product categories - No authentication required
+   * Demonstrates: Simple caching
+   */
+  @Tool({
+    name: 'get_categories',
+    description: 'Get all available product categories.',
+    inputSchema: z.object({}),
+    examples: {
+      request: {},
+      response: {
+        categories: [
+          { name: 'Beauty', productCount: 5 },
+          { name: 'Fragrances', productCount: 5 },
+          { name: 'Furniture', productCount: 5 },
+          { name: 'Groceries', productCount: 5 }
+        ]
+      }
+    }
+  })
+  @Widget('categories')
+  @UseMiddleware(LoggingMiddleware)
+  @UseInterceptors(TransformInterceptor)
+  @Cache({ ttl: 300 }) // Cache for 5 minutes
+  async getCategories(input: any, context: ExecutionContext) {
+    const categories = this.database.query(`
+      SELECT DISTINCT category, COUNT(*) as count
+      FROM products
+      GROUP BY category
+      ORDER BY category
+    `);
+    
+    return {
+      categories: categories.map((c: any) => ({
+        name: c.category,
+        productCount: c.count,
+      })),
+    };
+  }
+}

package/templates/typescript-auth/src/pipes/validation.pipe.ts

@@ -0,0 +1,42 @@
+import { Pipe, PipeInterface, ArgumentMetadata } from 'nitrostack';
+
+/**
+ * Validation Pipe
+ * 
+ * Validates and sanitizes input data
+ */
+@Pipe()
+export class ValidationPipe implements PipeInterface {
+  transform(value: any, metadata: ArgumentMetadata) {
+    if (!value || typeof value !== 'object') {
+      throw new Error('Input must be an object');
+    }
+    
+    // Sanitize strings
+    const sanitized = this.sanitizeObject(value);
+    
+    return sanitized;
+  }
+  
+  private sanitizeObject(obj: any): any {
+    if (typeof obj !== 'object' || obj === null) {
+      return obj;
+    }
+    
+    const sanitized: any = Array.isArray(obj) ? [] : {};
+    
+    for (const key in obj) {
+      if (typeof obj[key] === 'string') {
+        // Trim and sanitize strings
+        sanitized[key] = obj[key].trim();
+      } else if (typeof obj[key] === 'object') {
+        sanitized[key] = this.sanitizeObject(obj[key]);
+      } else {
+        sanitized[key] = obj[key];
+      }
+    }
+    
+    return sanitized;
+  }
+}
+

package/templates/typescript-auth/src/services/database.service.ts

@@ -0,0 +1,90 @@
+import { Injectable } from 'nitrostack';
+import Database from 'better-sqlite3';
+import { getDatabase } from '../db/database.js';
+
+/**
+ * Database Service
+ * 
+ * Provides database access with dependency injection
+ */
+@Injectable()
+export class DatabaseService {
+  private db: Database.Database;
+
+  constructor() {
+    this.db = getDatabase();
+  }
+
+  /**
+   * Execute a query
+   */
+  query<T = any>(sql: string, params: any[] = []): T[] {
+    const stmt = this.db.prepare(sql);
+    // better-sqlite3 expects individual parameters, not an array
+    if (params.length === 0) {
+      return stmt.all() as T[];
+    }
+    return stmt.all(...params) as T[];
+  }
+
+  /**
+   * Execute a query and get first result
+   */
+  queryOne<T = any>(sql: string, params: any[] = []): T | null {
+    const stmt = this.db.prepare(sql);
+    // better-sqlite3 expects individual parameters, not an array
+    if (params.length === 0) {
+      return (stmt.get() as T) || null;
+    }
+    return (stmt.get(...params) as T) || null;
+  }
+
+  /**
+   * Insert a record
+   */
+  insert(table: string, data: Record<string, any>): { lastInsertRowid: number } {
+    const keys = Object.keys(data);
+    const values = Object.values(data);
+    const placeholders = keys.map(() => '?').join(', ');
+    
+    const sql = `INSERT INTO ${table} (${keys.join(', ')}) VALUES (${placeholders})`;
+    const stmt = this.db.prepare(sql);
+    return stmt.run(...values) as any;
+  }
+
+  /**
+   * Update a record
+   */
+  update(table: string, data: Record<string, any>, where: Record<string, any>): { changes: number } {
+    const setClause = Object.keys(data).map(k => `${k} = ?`).join(', ');
+    const whereClause = Object.keys(where).map(k => `${k} = ?`).join(' AND ');
+    
+    const sql = `UPDATE ${table} SET ${setClause} WHERE ${whereClause}`;
+    const stmt = this.db.prepare(sql);
+    return stmt.run(...Object.values(data), ...Object.values(where)) as any;
+  }
+
+  /**
+   * Delete a record
+   */
+  delete(table: string, where: Record<string, any>): { changes: number } {
+    const whereClause = Object.keys(where).map(k => `${k} = ?`).join(' AND ');
+    
+    const sql = `DELETE FROM ${table} WHERE ${whereClause}`;
+    const stmt = this.db.prepare(sql);
+    return stmt.run(...Object.values(where)) as any;
+  }
+
+  /**
+   * Check database connectivity
+   */
+  async ping(): Promise<boolean> {
+    try {
+      this.db.prepare('SELECT 1').get();
+      return true;
+    } catch {
+      return false;
+    }
+  }
+}
+

package/templates/typescript-auth/src/widgets/app/add-to-cart/page.tsx

@@ -0,0 +1,122 @@
+'use client';
+
+import { withToolData } from 'nitrostack/widgets';
+import * as styles from '../../styles/ecommerce';
+
+interface AddToCartData {
+  message: string;
+  product_id?: string;
+  product_name?: string;
+  price?: number;
+  quantity?: number;
+  image_url?: string;
+  cartItemCount?: number;
+}
+
+function AddToCartWidget({ data }: { data: AddToCartData }) {
+  const { message, product_name, price, quantity, image_url, cartItemCount } = data;
+
+  return (
+    <div style={styles.containerStyle}>
+      <div style={{
+        ...styles.cardStyle,
+        maxWidth: '500px',
+        margin: '0 auto',
+      }}>
+        <div style={{
+          textAlign: 'center',
+          marginBottom: styles.spacing.xl,
+        }}>
+          <div style={{
+            width: '60px',
+            height: '60px',
+            margin: '0 auto 16px',
+            borderRadius: styles.borderRadius.full,
+            background: styles.colors.success,
+            display: 'flex',
+            alignItems: 'center',
+            justifyContent: 'center',
+            fontSize: '28px',
+          }}>
+            ✓
+          </div>
+          <h2 style={{
+            fontSize: styles.typography.fontSize.xl,
+            fontWeight: styles.typography.fontWeight.bold,
+            color: styles.colors.gray[900],
+            marginBottom: styles.spacing.sm,
+          }}>
+            {message}
+          </h2>
+          <p style={{
+            fontSize: styles.typography.fontSize.base,
+            color: styles.colors.gray[600],
+          }}>
+            You now have {cartItemCount || 1} {cartItemCount === 1 ? 'item' : 'items'} in your cart
+          </p>
+        </div>
+
+        {product_name && (
+          <div style={{
+            display: 'flex',
+            gap: styles.spacing.md,
+            padding: styles.spacing.lg,
+            background: styles.colors.gray[50],
+            borderRadius: styles.borderRadius.md,
+          }}>
+            {image_url && (
+              <div style={{
+                width: '80px',
+                height: '80px',
+                flexShrink: 0,
+                borderRadius: styles.borderRadius.md,
+                overflow: 'hidden',
+                background: styles.colors.white,
+              }}>
+                <img
+                  src={image_url}
+                  alt={product_name}
+                  style={{
+                    width: '100%',
+                    height: '100%',
+                    objectFit: 'cover',
+                  }}
+                />
+              </div>
+            )}
+
+            <div style={{ flex: 1 }}>
+              <div style={{
+                fontSize: styles.typography.fontSize.base,
+                fontWeight: styles.typography.fontWeight.semibold,
+                color: styles.colors.gray[900],
+                marginBottom: styles.spacing.xs,
+              }}>
+                {product_name}
+              </div>
+              <div style={{
+                display: 'flex',
+                alignItems: 'center',
+                gap: styles.spacing.md,
+              }}>
+                {price && (
+                  <div style={styles.priceStyle}>
+                    ${price.toFixed(2)}
+                  </div>
+                )}
+                {quantity && (
+                  <div style={styles.badgeStyle}>
+                    Qty: {quantity}
+                  </div>
+                )}
+              </div>
+            </div>
+          </div>
+        )}
+      </div>
+    </div>
+  );
+}
+
+export default withToolData<AddToCartData>(AddToCartWidget);
+

package/templates/typescript-auth/src/widgets/app/address-added/page.tsx

@@ -0,0 +1,116 @@
+'use client';
+
+import { withToolData } from 'nitrostack/widgets';
+import * as styles from '../../styles/ecommerce';
+
+interface AddressAddedData {
+  message: string;
+  addressId: string;
+  isDefault?: boolean;
+}
+
+function AddressAddedWidget({ data }: { data: AddressAddedData }) {
+  const { message, addressId, isDefault } = data;
+
+  if (!addressId) {
+    return (
+      <div style={styles.containerStyle}>
+        <div style={styles.emptyStateStyle}>
+          <p style={styles.metaTextStyle}>Loading...</p>
+        </div>
+      </div>
+    );
+  }
+
+  return (
+    <div style={styles.containerStyle}>
+      <div style={{
+        ...styles.cardStyle,
+        maxWidth: '500px',
+        margin: '0 auto',
+      }}>
+        <div style={{
+          textAlign: 'center',
+          marginBottom: styles.spacing.xl,
+        }}>
+          <div style={{
+            width: '60px',
+            height: '60px',
+            margin: '0 auto 16px',
+            borderRadius: styles.borderRadius.full,
+            background: styles.colors.success,
+            display: 'flex',
+            alignItems: 'center',
+            justifyContent: 'center',
+            fontSize: '28px',
+          }}>
+            ✓
+          </div>
+          <h2 style={{
+            fontSize: styles.typography.fontSize.xl,
+            fontWeight: styles.typography.fontWeight.bold,
+            color: styles.colors.gray[900],
+            marginBottom: styles.spacing.sm,
+          }}>
+            {message}
+          </h2>
+        </div>
+
+        <div style={{
+          background: styles.colors.gray[50],
+          borderRadius: styles.borderRadius.md,
+          padding: styles.spacing.lg,
+          marginBottom: styles.spacing.md,
+        }}>
+          <div style={{
+            fontSize: styles.typography.fontSize.sm,
+            color: styles.colors.gray[500],
+            marginBottom: styles.spacing.xs,
+            textTransform: 'uppercase',
+            letterSpacing: '0.5px',
+            fontWeight: styles.typography.fontWeight.semibold,
+          }}>
+            Address Reference
+          </div>
+          <div style={{
+            fontSize: styles.typography.fontSize.sm,
+            fontWeight: styles.typography.fontWeight.medium,
+            color: styles.colors.gray[900],
+            fontFamily: 'monospace',
+            wordBreak: 'break-all',
+          }}>
+            {addressId}
+          </div>
+        </div>
+
+        {isDefault && (
+          <div style={{
+            textAlign: 'center',
+            padding: styles.spacing.md,
+            background: `linear-gradient(135deg, ${styles.colors.primary} 0%, ${styles.colors.primaryHover} 100%)`,
+            color: styles.colors.black,
+            borderRadius: styles.borderRadius.md,
+            fontWeight: styles.typography.fontWeight.bold,
+            fontSize: styles.typography.fontSize.sm,
+          }}>
+            ⭐ Default Shipping Address
+          </div>
+        )}
+
+        <div style={{
+          marginTop: styles.spacing.md,
+          padding: styles.spacing.md,
+          background: `${styles.colors.success}15`,
+          borderRadius: styles.borderRadius.md,
+          fontSize: styles.typography.fontSize.sm,
+          color: styles.colors.gray[700],
+          textAlign: 'center',
+        }}>
+          📦 Ready for deliveries
+        </div>
+      </div>
+    </div>
+  );
+}
+
+export default withToolData<AddressAddedData>(AddressAddedWidget);