nitrostack 1.0.55 → 1.0.56

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

@@ -1,266 +0,0 @@
-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. 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 (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'),
-    }),
-    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. 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 (e.g., "prod-3" from browse_products results)'),
-    }),
-    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

@@ -1,42 +0,0 @@
-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

@@ -1,90 +0,0 @@
-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

@@ -1,122 +0,0 @@
-'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

@@ -1,116 +0,0 @@
-'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);