create-tigra 1.0.7 → 2.0.0

package/template/server/src/utils/errors.ts

@@ -1,108 +0,0 @@
-/**
- * Error Handling Utilities
- * 
- * All errors thrown in the application MUST extend AppError.
- * This ensures consistent error responses across the API.
- * 
- * @see /mnt/project/06-response-handling.md
- */
-
-/**
- * Base error class for all application errors
- * 
- * @property {number} statusCode - HTTP status code
- * @property {string} code - Machine-readable error code
- * @property {string} message - Human-readable error message
- */
-export class AppError extends Error {
-    public readonly statusCode: number;
-    public readonly code: string;
-    public readonly isOperational: boolean;
-
-    constructor(message: string, statusCode: number, code: string) {
-        super(message);
-
-        this.statusCode = statusCode;
-        this.code = code;
-        this.isOperational = true;
-
-        // Maintains proper stack trace for where error was thrown (V8 only)
-        Error.captureStackTrace(this, this.constructor);
-
-        // Set the prototype explicitly for instanceof checks
-        Object.setPrototypeOf(this, AppError.prototype);
-    }
-}
-
-/**
- * 400 Bad Request
- * Use when client sends invalid data or malformed requests
- */
-export class BadRequestError extends AppError {
-    constructor(message = 'Bad request') {
-        super(message, 400, 'BAD_REQUEST');
-        Object.setPrototypeOf(this, BadRequestError.prototype);
-    }
-}
-
-/**
- * 401 Unauthorized
- * Use when authentication is required but missing or invalid
- */
-export class UnauthorizedError extends AppError {
-    constructor(message = 'Unauthorized') {
-        super(message, 401, 'UNAUTHORIZED');
-        Object.setPrototypeOf(this, UnauthorizedError.prototype);
-    }
-}
-
-/**
- * 403 Forbidden
- * Use when user is authenticated but lacks permission
- */
-export class ForbiddenError extends AppError {
-    constructor(message = 'Forbidden') {
-        super(message, 403, 'FORBIDDEN');
-        Object.setPrototypeOf(this, ForbiddenError.prototype);
-    }
-}
-
-/**
- * 404 Not Found
- * Use when requested resource does not exist
- */
-export class NotFoundError extends AppError {
-    constructor(message = 'Resource not found') {
-        super(message, 404, 'NOT_FOUND');
-        Object.setPrototypeOf(this, NotFoundError.prototype);
-    }
-}
-
-/**
- * 409 Conflict
- * Use when request conflicts with current state (e.g., duplicate email)
- */
-export class ConflictError extends AppError {
-    constructor(message = 'Conflict') {
-        super(message, 409, 'CONFLICT');
-        Object.setPrototypeOf(this, ConflictError.prototype);
-    }
-}
-
-/**
- * 500 Internal Server Error
- * Use for unexpected server errors
- */
-export class InternalError extends AppError {
-    constructor(message = 'Internal server error') {
-        super(message, 500, 'INTERNAL_ERROR');
-        Object.setPrototypeOf(this, InternalError.prototype);
-    }
-}
-
-/**
- * Type guard to check if error is an AppError
- */
-export function isAppError(error: unknown): error is AppError {
-    return error instanceof AppError;
-}

package/template/server/src/utils/pagination.ts

@@ -1,120 +0,0 @@
-/**
- * Pagination Utilities
- * 
- * Unified pagination response format for all paginated API endpoints.
- * This ensures consistent pagination structure across the entire API.
- * 
- * @see /mnt/project/04-pagination.md
- */
-
-/**
- * Pagination metadata structure
- * 
- * MANDATORY format - DO NOT modify
- */
-export interface PaginationMeta {
-    page: number;
-    limit: number;
-    totalItems: number;
-    totalPages: number;
-    hasNextPage: boolean;
-    hasPreviousPage: boolean;
-}
-
-/**
- * Paginated response structure
- * 
- * MANDATORY format - DO NOT modify
- */
-export interface PaginatedResponse<T = any> {
-    success: true;
-    message: string;
-    data: {
-        items: T[];
-        pagination: PaginationMeta;
-    };
-}
-
-/**
- * Creates a standardized paginated response
- * 
- * @param message - Human-readable success message
- * @param items - Array of items for current page
- * @param page - Current page number (1-indexed)
- * @param limit - Items per page
- * @param totalItems - Total count of items across all pages
- * @returns Standardized paginated response object
- * 
- * @example
- * // In controller
- * const { items, totalItems } = await resourceService.getResources(filters, page, limit);
- * return reply.send(
- *   paginatedResponse('Resources retrieved successfully', items, page, limit, totalItems)
- * );
- * 
- * @example
- * // Response format
- * {
- *   "success": true,
- *   "message": "Resources retrieved successfully",
- *   "data": {
- *     "items": [...],
- *     "pagination": {
- *       "page": 2,
- *       "limit": 10,
- *       "totalItems": 237,
- *       "totalPages": 24,
- *       "hasNextPage": true,
- *       "hasPreviousPage": true
- *     }
- *   }
- * }
- */
-export function paginatedResponse<T = any>(
-    message: string,
-    items: T[],
-    page: number,
-    limit: number,
-    totalItems: number
-): PaginatedResponse<T> {
-    // Calculate total pages (always round up)
-    const totalPages = Math.ceil(totalItems / limit);
-
-    // Calculate navigation flags
-    const hasNextPage = page < totalPages;
-    const hasPreviousPage = page > 1;
-
-    return {
-        success: true,
-        message,
-        data: {
-            items,
-            pagination: {
-                page,
-                limit,
-                totalItems,
-                totalPages,
-                hasNextPage,
-                hasPreviousPage,
-            },
-        },
-    };
-}
-
-/**
- * Calculates offset for database queries
- * 
- * @param page - Current page number (1-indexed)
- * @param limit - Items per page
- * @returns Offset value for database skip/offset
- * 
- * @example
- * const offset = calculateOffset(page, limit);
- * const items = await prisma.resource.findMany({
- *   skip: offset,
- *   take: limit,
- * });
- */
-export function calculateOffset(page: number, limit: number): number {
-    return (page - 1) * limit;
-}

package/template/server/src/utils/response.ts

@@ -1,110 +0,0 @@
-/**
- * Response Utilities
- * 
- * Unified success response format for all API endpoints.
- * This ensures consistent response structure across the entire API.
- * 
- * @see /mnt/project/06-response-handling.md
- * @see /mnt/project/04-pagination.md
- */
-
-/**
- * Success response structure
- * 
- * MANDATORY format - DO NOT modify
- */
-export interface SuccessResponse<T = any> {
-    success: true;
-    message: string;
-    data: T;
-}
-
-/**
- * Paginated response structure
- * 
- * MANDATORY format - DO NOT modify
- */
-export interface PaginatedResponse<T = any> {
-    success: true;
-    message: string;
-    data: {
-        items: T[];
-        pagination: {
-            page: number;
-            limit: number;
-            totalItems: number;
-            totalPages: number;
-            hasNextPage: boolean;
-            hasPreviousPage: boolean;
-        };
-    };
-}
-
-/**
- * Creates a standardized success response
- * 
- * @param message - Human-readable success message
- * @param data - Response payload (object, array, or null)
- * @returns Standardized success response object
- * 
- * @example
- * // Simple success
- * return reply.send(successResponse('User created successfully', user));
- * 
- * @example
- * // With null data
- * return reply.send(successResponse('Deleted successfully', null));
- * 
- * @example
- * // With array data
- * return reply.send(successResponse('Users retrieved', users));
- */
-export function successResponse<T = any>(
-    message: string,
-    data: T
-): SuccessResponse<T> {
-    return {
-        success: true,
-        message,
-        data,
-    };
-}
-
-/**
- * Creates a standardized paginated response
- * 
- * @param message - Human-readable success message
- * @param items - Array of items for current page
- * @param page - Current page number (1-indexed)
- * @param limit - Items per page
- * @param totalItems - Total count of items across all pages
- * @returns Standardized paginated response object
- * 
- * @example
- * return reply.send(paginatedResponse('Users retrieved', users, 1, 10, 237));
- */
-export function paginatedResponse<T = any>(
-    message: string,
-    items: T[],
-    page: number,
-    limit: number,
-    totalItems: number
-): PaginatedResponse<T> {
-    const totalPages = Math.ceil(totalItems / limit);
-
-    return {
-        success: true,
-        message,
-        data: {
-            items,
-            pagination: {
-                page,
-                limit,
-                totalItems,
-                totalPages,
-                hasNextPage: page < totalPages,
-                hasPreviousPage: page > 1,
-            },
-        },
-    };
-}

package/template/server/src/workers/file.worker.ts

@@ -1,106 +0,0 @@
-/**
- * File Processing Background Worker
- * 
- * Process jobs from the 'files' queue.
- * Reference implementation for background job processing.
- * 
- * @see /mnt/project/10-background-jobs-v2.md
- */
-
-import { Worker, Job } from 'bullmq';
-import { redis } from '@/libs/redis';
-import logger from '@/libs/logger';
-
-
-/**
- * Data structure for file processing jobs
- */
-export interface FileJobData {
-    fileId: string;
-    path: string;
-    operation: 'thumbnail' | 'compress' | 'convert';
-    options?: Record<string, any>;
-}
-
-/**
- * Mock file processor
- * In a real app, this would use sharp, ffmpeg, etc.
- */
-async function processFile(data: FileJobData): Promise<void> {
-    const { fileId, operation } = data;
-
-    // Simulate processing time
-    await new Promise(resolve => setTimeout(resolve, 1000));
-
-    logger.info({ fileId, operation }, 'File successfully processed');
-}
-
-/**
- * File Worker Implementation
- * 
- * Processes files in the background with:
- * - Rate limit of 100 jobs per minute
- * - Concurrency of 5 jobs at a time
- */
-export const fileWorker = new Worker<FileJobData>(
-    'files',
-    async (job: Job<FileJobData>) => {
-        const { fileId, operation } = job.data;
-
-        logger.info({ jobId: job.id, fileId, operation }, 'Processing file job');
-
-        try {
-            await processFile(job.data);
-            return { success: true, processedAt: new Date().toISOString() };
-        } catch (error) {
-            logger.error(
-                {
-                    jobId: job.id,
-                    error: error instanceof Error ? error.message : 'Unknown error'
-                },
-                'Failed to process file'
-            );
-            throw error;
-        }
-    },
-    {
-        connection: redis as any,
-        concurrency: 5,
-        limiter: {
-            max: 100,
-            duration: 60000,
-        },
-    }
-);
-
-/**
- * Worker Event Listeners
- */
-fileWorker.on('completed', (job) => {
-    logger.info({ jobId: job.id, queue: 'files' }, 'File job completed');
-});
-
-fileWorker.on('failed', (job, error) => {
-    logger.error(
-        {
-            jobId: job?.id,
-            queue: 'files',
-            error: error.message,
-        },
-        'File job failed'
-    );
-});
-
-/**
- * Graceful Shutdown
- */
-const shutdownWorker = async (signal: string) => {
-    logger.info(`Received ${signal}, closing file worker...`);
-    await fileWorker.close();
-    process.exit(0);
-};
-
-process.on('SIGTERM', () => shutdownWorker('SIGTERM'));
-process.on('SIGINT', () => shutdownWorker('SIGINT'));
-
-logger.info('File worker initialized and listening for jobs');

package/template/server/tsconfig.build.json

@@ -1,30 +0,0 @@
-{
-    "compilerOptions": {
-        "target": "ES2022",
-        "module": "ES2022",
-        "lib": ["ES2022"],
-        "outDir": "./dist",
-        "rootDir": "./src",
-        "removeComments": true,
-        "strict": false,
-        "skipLibCheck": true,
-        "moduleResolution": "bundler",
-        "esModuleInterop": true,
-        "resolveJsonModule": true,
-        "declaration": false,
-        "sourceMap": false,
-        "incremental": true,
-        "types": [],
-        "baseUrl": ".",
-        "paths": {
-            "@/*": ["src/*"],
-            "@/config/*": ["src/config/*"],
-            "@/libs/*": ["src/libs/*"],
-            "@/modules/*": ["src/modules/*"],
-            "@/utils/*": ["src/utils/*"],
-            "@/types/*": ["src/types/*"]
-        }
-    },
-    "include": ["src/**/*.ts"],
-    "exclude": ["node_modules", "dist", "**/*.test.ts", "**/*.spec.ts"]
-}

package/template/server/tsconfig.test.json

@@ -1,22 +0,0 @@
-{
-    "compilerOptions": {
-        "target": "ES2022",
-        "module": "ES2022",
-        "lib": [
-            "ES2022"
-        ],
-        "outDir": "./dist",
-        "strict": true,
-        "esModuleInterop": true,
-        "skipLibCheck": true,
-        "forceConsistentCasingInFileNames": true,
-        "resolveJsonModule": true,
-        "moduleResolution": "bundler",
-        "noEmit": true
-    },
-    "files": [
-        "src/utils/errors.ts",
-        "src/utils/response.ts",
-        "src/utils/pagination.ts"
-    ]
-}