@catbee/utils 0.0.8-rc.1 → 0.0.8-rc.2

package/build/src/utils/decorators.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"decorators.utils.js","sourceRoot":"","sources":["../../../src/utils/decorators.utils.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * The MIT License\n *\n * Copyright (c) 2025 Catbee Technologies. https://catbee-utils.npm.hprasath.com/license\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n/* eslint-disable @typescript-eslint/no-unused-vars */\n\nimport type { Request, RequestHandler, Response, Router } from 'express';\nimport 'reflect-metadata';\nimport { getLogger } from './logger.utils';\nimport { createFinalErrorResponse } from './response.utils';\nimport { HttpStatusCodes } from './http-status-codes';\nimport { rateLimit } from 'express-rate-limit';\nimport { TTLCache } from './cache.utils';\n\n// Metadata keys\nconst ROUTES_KEY = Symbol('routes');\nconst MIDDLEWARE_KEY = Symbol('middlewares');\nconst PARAMS_KEY = Symbol('params');\nconst HTTP_CODE_KEY = Symbol('httpCode');\nconst HEADER_KEY = Symbol('headers');\nconst BEFORE_KEY = Symbol('before');\nconst AFTER_KEY = Symbol('after');\nconst ROLES_KEY = Symbol('roles');\nconst REDIRECT_KEY = Symbol('redirect');\nconst CACHE_KEY = Symbol('cache');\nconst RATE_LIMIT_KEY = Symbol('rateLimit');\nconst CONTENT_TYPE_KEY = Symbol('contentType');\nconst VERSION_KEY = Symbol('version');\nconst TIMEOUT_KEY = Symbol('timeout');\nconst LOG_KEY = Symbol('log');\n\n/**\n * Supported HTTP methods for route decorators\n */\ntype HttpMethod = 'get' | 'post' | 'put' | 'patch' | 'delete' | 'options' | 'head' | 'trace' | 'connect';\n\n/**\n * Represents a route definition for controller methods\n */\ninterface RouteDefinition {\n  /** The URL path for this route */\n  path: string;\n  /** HTTP method for this route */\n  method: HttpMethod;\n  /** Name of the handler method in the controller class */\n  handlerName: string;\n}\n\n/**\n * Parameter decoration definition for method parameters\n */\ninterface ParamDefinition {\n  /** Parameter position in method signature */\n  index: number;\n  /** Type of parameter (query, body, etc.) */\n  type: 'query' | 'param' | 'body' | 'req' | 'res';\n  /** Optional key for extracting specific property */\n  key?: string;\n}\n\ntype CachedRateLimiter = {\n  limiter: ReturnType<typeof rateLimit>;\n  config: string;\n};\n\n/**\n * RateLimiter cache that uses TTLCache for automatic TTL and LRU handling.\n */\nexport class RateLimiterCache {\n  private cache: TTLCache<string, CachedRateLimiter>;\n\n  constructor(maxSize = 100, ttlMs = 5 * 60 * 1000) {\n    this.cache = new TTLCache<string, CachedRateLimiter>({\n      maxSize,\n      ttlMs\n    });\n  }\n\n  private generateKey(options: {\n    max: number;\n    windowMs: number;\n    standardHeaders: boolean;\n    legacyHeaders: boolean;\n  }): string {\n    return `${options.max}:${options.windowMs}:${options.standardHeaders}:${options.legacyHeaders}`;\n  }\n\n  get(options: {\n    max: number;\n    windowMs: number;\n    standardHeaders: boolean;\n    legacyHeaders: boolean;\n  }): ReturnType<typeof rateLimit> {\n    const key = this.generateKey(options);\n\n    const cached = this.cache.get(key);\n    if (cached) {\n      return cached.limiter;\n    }\n\n    // Create new limiter\n    const limiter = rateLimit({\n      ...options,\n      handler: (req: Request, res: Response) => {\n        const errorResponse = createFinalErrorResponse(req, HttpStatusCodes.TOO_MANY_REQUESTS, 'Too Many Requests');\n        res.status(HttpStatusCodes.TOO_MANY_REQUESTS).json(errorResponse);\n      }\n    });\n\n    // Store in cache\n    this.cache.set(key, {\n      limiter,\n      config: key\n    });\n\n    return limiter;\n  }\n\n  clear(): void {\n    this.cache.clear();\n  }\n\n  size(): number {\n    return this.cache.size();\n  }\n\n  destroy(): void {\n    this.cache.destroy();\n  }\n}\n\n// Global cache instance\nconst rateLimiterCache = new RateLimiterCache();\n\nfunction normalizeHeaderValue(value: unknown): string | string[] | undefined {\n  if (typeof value === 'undefined') return undefined;\n\n  if (typeof value === 'string') return value;\n\n  if (Array.isArray(value) && value.every(item => typeof item === 'string')) {\n    return value;\n  }\n\n  return String(value);\n}\n\n/**\n * Factory function that creates HTTP method decorators.\n *\n * @param method - HTTP method to create decorator for\n * @returns A method decorator function\n */\nfunction createRouteDecorator(method: HttpMethod) {\n  return (path: string): MethodDecorator => {\n    return (target, propertyKey, descriptor) => {\n      const routes: RouteDefinition[] = Reflect.getMetadata(ROUTES_KEY, target.constructor) || [];\n      routes.push({\n        path,\n        method,\n        handlerName: propertyKey as string\n      });\n      Reflect.defineMetadata(ROUTES_KEY, routes, target.constructor);\n    };\n  };\n}\n\n/**\n * Decorator for GET HTTP method routes.\n *\n * @param path - URL path for the route\n * @returns Method decorator\n *\n * @example\n * ```ts\n * @Get('/users')\n * getUsers() {\n *   return this.userService.findAll();\n * }\n * ```\n */\nexport const Get = createRouteDecorator('get');\n\n/**\n * Decorator for POST HTTP method routes.\n *\n * @param path - URL path for the route\n * @returns Method decorator\n *\n * @example\n * ```ts\n * @Post('/users')\n * createUser(@Body() userData: any) {\n *   return this.userService.create(userData);\n * }\n * ```\n */\nexport const Post = createRouteDecorator('post');\n\n/**\n * Decorator for PUT HTTP method routes.\n *\n * @param path - URL path for the route\n * @returns Method decorator\n */\nexport const Put = createRouteDecorator('put');\n\n/**\n * Decorator for PATCH HTTP method routes.\n *\n * @param path - URL path for the route\n * @returns Method decorator\n */\nexport const Patch = createRouteDecorator('patch');\n\n/**\n * Decorator for DELETE HTTP method routes.\n *\n * @param path - URL path for the route\n * @returns Method decorator\n */\nexport const Delete = createRouteDecorator('delete');\n\n/**\n * Decorator for OPTIONS HTTP method routes.\n *\n * @param path - URL path for the route\n * @returns Method decorator\n */\nexport const Options = createRouteDecorator('options');\n\n/**\n * Decorator for HEAD HTTP method routes.\n *\n * @param path - URL path for the route\n * @returns Method decorator\n */\nexport const Head = createRouteDecorator('head');\n\n/**\n * Decorator for TRACE HTTP method routes.\n *\n * @param path - URL path for the route\n * @returns Method decorator\n */\nexport const Trace = createRouteDecorator('trace');\n\n/**\n * Decorator for CONNECT HTTP method routes.\n *\n * @param path - URL path for the route\n * @returns Method decorator\n */\nexport const Connect = createRouteDecorator('connect');\n\n/**\n * Decorator that marks a class as a controller with a base path.\n * Used as the entry point for routing configuration.\n *\n * @param basePath - Base URL path for all routes in this controller\n * @returns Class decorator\n *\n * @example\n * ```ts\n * @Controller('/api/users')\n * class UserController {\n *   // Controller methods...\n * }\n * ```\n */\nexport function Controller(basePath: string): ClassDecorator {\n  return target => {\n    Reflect.defineMetadata('basePath', basePath, target);\n  };\n}\n\n/**\n * Decorator that applies middleware to a controller method.\n * Multiple middlewares can be applied and will execute in order.\n *\n * @param middlewares - Express middleware functions to apply\n * @returns Method decorator\n *\n * @example\n * ```ts\n * @Get('/protected')\n * @Use(authMiddleware, loggingMiddleware)\n * getProtectedResource() {\n *   // This route is protected by auth middleware\n * }\n * ```\n */\nexport function Use(...middlewares: RequestHandler[]): MethodDecorator {\n  return (target, propertyKey, _descriptor) => {\n    const existing: RequestHandler[] = Reflect.getMetadata(MIDDLEWARE_KEY, target, propertyKey as string) || [];\n    Reflect.defineMetadata(MIDDLEWARE_KEY, [...existing, ...middlewares], target, propertyKey as string);\n  };\n}\n\n/**\n * Factory function that creates parameter decorators.\n *\n * @param type - Parameter type to extract from request\n * @param key - Optional fixed key for extraction\n * @returns Parameter decorator function\n */\nfunction createParamDecorator(type: ParamDefinition['type'], key?: string) {\n  return (paramKey?: string): ParameterDecorator => {\n    return (target, propertyKey, parameterIndex) => {\n      const params: ParamDefinition[] = Reflect.getMetadata(PARAMS_KEY, target, propertyKey as string) || [];\n      // Ensure parameters are ordered by index\n      params.push({ index: parameterIndex, type, key: paramKey || key });\n      params.sort((a, b) => a.index - b.index);\n      Reflect.defineMetadata(PARAMS_KEY, params, target, propertyKey as string);\n    };\n  };\n}\n\n/**\n * Decorator that extracts query parameters from request.\n *\n * @param paramKey - Optional key to extract specific query parameter\n * @returns Parameter decorator\n *\n * @example\n * ```ts\n * @Get('/search')\n * search(@Query('term') searchTerm: string) {\n *   // searchTerm will contain the value of req.query.term\n * }\n * ```\n */\nexport const Query = createParamDecorator('query');\n\n/**\n * Decorator that extracts route parameters from request.\n *\n * @param paramKey - Optional key to extract specific route parameter\n * @returns Parameter decorator\n *\n * @example\n * ```ts\n * @Get('/users/:id')\n * getUser(@Param('id') userId: string) {\n *   // userId will contain the value of req.params.id\n * }\n * ```\n */\nexport const Param = createParamDecorator('param');\n\n/**\n * Decorator that extracts body or body property from request.\n *\n * @param paramKey - Optional key to extract specific body property\n * @returns Parameter decorator\n *\n * @example\n * ```ts\n * @Post('/users')\n * createUser(@Body() userData: any) {\n *   // userData will contain the entire req.body\n * }\n *\n * @Post('/update')\n * updateName(@Body('name') name: string) {\n *   // name will contain the value of req.body.name\n * }\n * ```\n */\nexport const Body = createParamDecorator('body');\n\n/**\n * Decorator that injects the entire request object.\n *\n * @returns Parameter decorator\n *\n * @example\n * ```ts\n * @Get('/complex')\n * complex(@Req() req: Request) {\n *   // Access the full request object\n *   console.log(req.headers);\n * }\n * ```\n */\nexport const Req = createParamDecorator('req');\n\n/**\n * Decorator that injects the response object.\n *\n * @returns Parameter decorator\n *\n * @example\n * ```ts\n * @Get('/custom')\n * custom(@Res() res: Response) {\n *   // Direct access to response object\n *   return res.status(201).send('Created');\n * }\n * ```\n */\nexport const Res = createParamDecorator('res');\n\n/**\n * Decorator that sets a custom HTTP status code for a response.\n *\n * @param status - HTTP status code to use\n * @returns Method decorator\n *\n * @example\n * ```ts\n * @Post('/users')\n * @HttpCode(201)\n * createUser(@Body() userData: any) {\n *   // Response will have 201 Created status code\n *   return { id: '123', ...userData };\n * }\n * ```\n */\nexport function HttpCode(status: number): MethodDecorator {\n  return (target, propertyKey, _descriptor) => {\n    Reflect.defineMetadata(HTTP_CODE_KEY, status, target, propertyKey as string);\n  };\n}\n\n/**\n * Decorator that adds a custom HTTP header to the response.\n *\n * @param header - Header name-value pairs or a single header name and value\n * @param value - Header value if a single header name is provided\n * @returns Method decorator\n *\n * @example\n * ```ts\n * @Get('/data')\n * @Header('Cache-Control', 'max-age=60')\n * getData() {\n *   // Response will include the Cache-Control header\n *   return { data: '...' };\n * }\n */\nexport function Header(name: string, value: string): MethodDecorator {\n  return Headers(name, value);\n}\n\n/**\n * Decorator that adds a custom HTTP headers to the response.\n *\n * @param headers - Header name-value pairs or a single header name and value\n * @param value - Header value if a single header name is provided\n * @returns Method decorator\n *\n * @example\n * ```ts\n * @Get('/data')\n * @Headers('Cache-Control', 'max-age=60')\n * getData() {\n *   // Response will include the Cache-Control header\n *   return { data: '...' };\n * }\n *\n * @Get('/data/:id')\n * @Headers({\n *   'Cache-Control': 'max-age=60',\n *   'X-Custom-Header': 'custom-value',\n *   'Content-Security-Policy': \"default-src 'self'\"\n * })\n * getData() {\n *   // Response will include all specified headers\n *   return { data: '...' };\n * }\n *\n * ```\n */\nexport function Headers(headers: Record<string, string> | string, value?: string): MethodDecorator {\n  return (target, propertyKey) => {\n    const existing: Record<string, string> = Reflect.getMetadata(HEADER_KEY, target, propertyKey) || {};\n    const newHeaders = typeof headers === 'string' ? { [headers]: value! } : headers;\n    Reflect.defineMetadata(HEADER_KEY, { ...existing, ...newHeaders }, target, propertyKey);\n  };\n}\n\n/**\n * Decorator that registers a function to run before route handler execution.\n * Useful for pre-processing or logging.\n *\n * @param fn - Function to execute before the handler\n * @returns Method decorator\n *\n * @example\n * ```ts\n * @Get('/users/:id')\n * @Before((req, res) => console.log(`Accessing user ${req.params.id}`))\n * getUser(@Param('id') id: string) {\n *   // Function will log before this handler runs\n * }\n * ```\n */\nexport function Before(fn: Function): MethodDecorator {\n  return (target, propertyKey, _descriptor) => {\n    const hooks: Function[] = Reflect.getMetadata(BEFORE_KEY, target, propertyKey as string) || [];\n    hooks.push(fn);\n    Reflect.defineMetadata(BEFORE_KEY, hooks, target, propertyKey as string);\n  };\n}\n\n/**\n * Decorator that registers a function to run after route handler execution.\n * Can access the handler's result.\n *\n * @param fn - Function to execute after the handler\n * @returns Method decorator\n *\n * @example\n * ```ts\n * @Get('/users/:id')\n * @After((req, res, result) => console.log(`User data sent: ${JSON.stringify(result)}`))\n * getUser(@Param('id') id: string) {\n *   // After this handler, the function will log the returned data\n *   return { id, name: 'Example' };\n * }\n * ```\n */\nexport function After(fn: Function): MethodDecorator {\n  return (target, propertyKey, _descriptor) => {\n    const hooks: Function[] = Reflect.getMetadata(AFTER_KEY, target, propertyKey as string) || [];\n    hooks.push(fn);\n    Reflect.defineMetadata(AFTER_KEY, hooks, target, propertyKey as string);\n  };\n}\n\n/**\n * Decorator that requires specific roles for accessing a route.\n * Must be used with authentication middleware.\n *\n * @param roles - List of roles that can access this route\n * @returns Method decorator\n *\n * @example\n * ```ts\n * @Get('/admin/settings')\n * @Roles('admin', 'superuser')\n * getSettings() {\n *   // Only admins and superusers can access\n *   return { settings: [...] };\n * }\n * ```\n */\nexport function Roles(...roles: string[]): MethodDecorator {\n  return (target, propertyKey, _descriptor) => {\n    Reflect.defineMetadata(ROLES_KEY, roles, target, propertyKey as string);\n  };\n}\n\n/**\n * Decorator that redirects to another URL.\n *\n * @param url - URL to redirect to (can be absolute or relative)\n * @param statusCode - HTTP status code for redirect (default: 302)\n * @returns Method decorator\n *\n * @example\n * ```ts\n * @Get('/old-path')\n * @Redirect('/new-path', 301)\n * redirectToNewPath() {\n *   // This method won't be executed; automatic redirect happens\n * }\n *\n * @Get('/dynamic-redirect')\n * @Redirect()\n * getDynamicRedirect() {\n *   // Return an object with url and optionally statusCode\n *   return { url: '/calculated-path', statusCode: 307 };\n * }\n * ```\n */\nexport function Redirect(url?: string, statusCode: number = 302): MethodDecorator {\n  return (target, propertyKey, descriptor) => {\n    // Store the redirect information in metadata\n    Reflect.defineMetadata(REDIRECT_KEY, { url, statusCode }, target, propertyKey as string);\n    return descriptor;\n  };\n}\n\n/**\n * Decorator that adds caching to a route response.\n *\n * @param ttlSeconds - Time to live in seconds for the cache\n * @returns Method decorator\n *\n * @example\n * ```ts\n * @Get('/data')\n * @Cache(300) // Cache for 5 minutes\n * getData() {\n *   return { data: 'expensive operation result' };\n * }\n * ```\n */\nexport function Cache(ttlSeconds: number): MethodDecorator {\n  return (target, propertyKey, _descriptor) => {\n    Reflect.defineMetadata(CACHE_KEY, { ttlSeconds }, target, propertyKey as string);\n  };\n}\n\n/**\n * Decorator that applies rate limiting to a route.\n * Note: Requires 'express-rate-limit' package to be installed.\n *\n * @param limit - Maximum number of requests allowed in the window\n * @param windowMs - Time window in milliseconds\n * @returns Method decorator\n *\n * Default Options:\n *  - standardHeaders: true\n *  - legacyHeaders: false\n *\n * @example\n * ```ts\n * @Post('/login')\n * @RateLimit({ max: 5, windowMs: 60000, standardHeaders: true, legacyHeaders: false }) // 5 requests per minute\n * login(@Body() credentials: LoginDto) {\n *   return this.authService.login(credentials);\n * }\n * ```\n */\nexport function RateLimit(options: {\n  max: number;\n  windowMs: number;\n  standardHeaders?: boolean;\n  legacyHeaders?: boolean;\n}): MethodDecorator {\n  const opts = {\n    standardHeaders: true,\n    legacyHeaders: false,\n    ...options\n  };\n  return (target, propertyKey, _descriptor) => {\n    Reflect.defineMetadata(RATE_LIMIT_KEY, opts, target, propertyKey as string);\n  };\n}\n\n/**\n * Decorator that sets the content type for the response.\n *\n * @param type - MIME type for the response\n * @returns Method decorator\n *\n * @example\n * ```ts\n * @Get('/download')\n * @ContentType('application/pdf')\n * downloadPdf() {\n *   return this.fileService.generatePdf();\n * }\n * ```\n */\nexport function ContentType(type: string): MethodDecorator {\n  return (target, propertyKey, _descriptor) => {\n    Reflect.defineMetadata(CONTENT_TYPE_KEY, { type }, target, propertyKey as string);\n  };\n}\n\n/**\n * Decorator that adds API versioning to a route.\n *\n * @param version - Version string for the API endpoint\n * @param options - Versioning options\n * @returns Method decorator\n *\n * Default Options:\n *  - addPrefix: true\n *  - addHeader: true\n *  - headerName: 'X-API-Version'\n *\n * @example\n * ```ts\n *\n * @Get('/users')\n * @Version('v2')\n * getUsersV2() {\n *   return this.userService.findAllV2();\n * }\n *\n * @Get('/users')\n * @Version('v2', { addPrefix: true, addHeader: true, headerName: 'X-API-Version' })\n * getUsersV2() {\n *   // Route becomes /v2/users\n *   return this.userService.findAllV2();\n * }\n * ```\n */\nexport function Version(\n  version: string,\n  options?: { addPrefix?: boolean; addHeader?: boolean; headerName?: string }\n): MethodDecorator {\n  const opts = {\n    addPrefix: true,\n    addHeader: true,\n    headerName: 'X-API-Version',\n    ...options\n  };\n\n  return (target, propertyKey, _descriptor) => {\n    Reflect.defineMetadata(VERSION_KEY, { version, options: opts }, target, propertyKey as string);\n  };\n}\n\n/**\n * Decorator that sets a timeout for route execution.\n *\n * @param ms - Timeout in milliseconds\n * @returns Method decorator\n *\n * @example\n * ```ts\n * @Get('/slow-operation')\n * @Timeout(30000) // 30 second timeout\n * slowOperation() {\n *   return this.heavyService.processData();\n * }\n * ```\n */\nexport function Timeout(ms: number): MethodDecorator {\n  return (target, propertyKey, _descriptor) => {\n    Reflect.defineMetadata(TIMEOUT_KEY, { ms }, target, propertyKey as string);\n  };\n}\n\n/**\n * Decorator that adds comprehensive logging to a route.\n *\n * @param options - Logging configuration options\n * @returns Method decorator\n *\n * Default Options:\n *  - logEntry: true\n *  - logExit: true\n *  - logBody: false\n *  - logParams: false\n *  - logResponse: false\n *\n * @example\n * ```ts\n * @Post('/users')\n * @Log({\n *   logEntry: true,\n *   logExit: true,\n *   logBody: true,\n *   logParams: true,\n *   logResponse: false\n * })\n * createUser(@Body() userData: any) {\n *   return this.userService.create(userData);\n * }\n * ```\n */\nexport function Log(options?: {\n  logEntry?: boolean;\n  logExit?: boolean;\n  logBody?: boolean;\n  logParams?: boolean;\n  logResponse?: boolean;\n}): MethodDecorator {\n  return (target, propertyKey, _descriptor) => {\n    const config = {\n      logEntry: true,\n      logExit: true,\n      logBody: false,\n      logParams: false,\n      logResponse: false,\n      ...options\n    };\n    Reflect.defineMetadata(LOG_KEY, config, target, propertyKey as string);\n  };\n}\n\n/**\n * Registers all controller classes with the provided router.\n * This function processes all decorators and sets up the Express routes.\n *\n * @param router - Express router instance\n * @param controllers - Array of controller classes\n */\nexport function registerControllers(router: Router, controllers: any[]) {\n  controllers.forEach(ControllerClass => {\n    const instance = new ControllerClass();\n    const basePath: string = Reflect.getMetadata('basePath', ControllerClass) || '';\n    const routes: RouteDefinition[] = Reflect.getMetadata(ROUTES_KEY, ControllerClass) || [];\n\n    // Get controller-level decorators (fallback values)\n    const controllerRateLimit = Reflect.getMetadata(RATE_LIMIT_KEY, ControllerClass);\n    const controllerCache = Reflect.getMetadata(CACHE_KEY, ControllerClass);\n    const controllerTimeout = Reflect.getMetadata(TIMEOUT_KEY, ControllerClass);\n    const controllerVersion = Reflect.getMetadata(VERSION_KEY, ControllerClass);\n    const controllerRoles = Reflect.getMetadata(ROLES_KEY, ControllerClass);\n    const controllerLogConfig = Reflect.getMetadata(LOG_KEY, ControllerClass);\n    const controllerHeaders = Reflect.getMetadata(HEADER_KEY, ControllerClass) || {};\n\n    routes.forEach(({ path, method, handlerName }) => {\n      const middlewares: RequestHandler[] = Reflect.getMetadata(MIDDLEWARE_KEY, instance, handlerName) || [];\n      const params: ParamDefinition[] = Reflect.getMetadata(PARAMS_KEY, instance, handlerName) || [];\n\n      const httpCode: number | undefined = Reflect.getMetadata(HTTP_CODE_KEY, instance, handlerName);\n\n      // Merge controller-level and method-level headers\n      const methodHeaders: Record<string, string> = Reflect.getMetadata(HEADER_KEY, instance, handlerName) || {};\n      const headers = { ...controllerHeaders, ...methodHeaders };\n\n      const beforeHooks: Function[] = Reflect.getMetadata(BEFORE_KEY, instance, handlerName) || [];\n      const afterHooks: Function[] = Reflect.getMetadata(AFTER_KEY, instance, handlerName) || [];\n      const redirect: { url?: string; statusCode: number } | undefined = Reflect.getMetadata(\n        REDIRECT_KEY,\n        instance,\n        handlerName\n      );\n      const contentType: { type: string } | undefined = Reflect.getMetadata(CONTENT_TYPE_KEY, instance, handlerName);\n\n      // Use method-level decorators if present, otherwise fall back to controller-level\n      const roles: string[] = Reflect.getMetadata(ROLES_KEY, instance, handlerName) || controllerRoles || [];\n      const cache: { ttlSeconds: number } | undefined =\n        Reflect.getMetadata(CACHE_KEY, instance, handlerName) || controllerCache;\n      const rateLimitOptions:\n        | { max: number; windowMs: number; standardHeaders: boolean; legacyHeaders: boolean }\n        | undefined = Reflect.getMetadata(RATE_LIMIT_KEY, instance, handlerName) || controllerRateLimit;\n      const version:\n        | { version: string; options: { addPrefix: boolean; addHeader: boolean; headerName: string } }\n        | undefined = Reflect.getMetadata(VERSION_KEY, instance, handlerName) || controllerVersion;\n      const timeout: { ms: number } | undefined =\n        Reflect.getMetadata(TIMEOUT_KEY, instance, handlerName) || controllerTimeout;\n      const logConfig:\n        | {\n            logEntry?: boolean;\n            logExit?: boolean;\n            logBody?: boolean;\n            logParams?: boolean;\n            logResponse?: boolean;\n          }\n        | undefined = Reflect.getMetadata(LOG_KEY, instance, handlerName) || controllerLogConfig;\n\n      // Create rate limiter for this specific route if needed\n      let rateLimiter: any = null;\n      if (rateLimitOptions) {\n        try {\n          rateLimiter = rateLimiterCache.get(rateLimitOptions);\n        } catch (err) {\n          getLogger().warn({ err }, 'express-rate-limit not available, skipping rate limiting for this route');\n        }\n      }\n\n      let finalPath = path;\n      if (version?.options?.addPrefix) {\n        finalPath = `/${version.version}${path}`;\n      }\n\n      const handler: RequestHandler = async (req, res, next) => {\n        // Set start time for duration tracking\n        req['startTime'] = Date.now();\n\n        let timeoutId: NodeJS.Timeout | undefined;\n        let timedOut = false;\n\n        try {\n          // Handle timeout setup\n          if (timeout) {\n            timeoutId = setTimeout(() => {\n              if (!res.headersSent && !timedOut) {\n                timedOut = true;\n                const errorResponse = createFinalErrorResponse(\n                  req,\n                  HttpStatusCodes.REQUEST_TIMEOUT,\n                  'Request timed out'\n                );\n                res.status(HttpStatusCodes.REQUEST_TIMEOUT).json(errorResponse);\n              }\n            }, timeout.ms);\n          }\n\n          if (timedOut) return;\n\n          // Handle rate limiting\n          if (rateLimiter) {\n            await new Promise<void>((resolve, reject) => {\n              rateLimiter(req, res, (err: any) => {\n                if (err) reject(err);\n                else resolve();\n              });\n            });\n          }\n\n          // Handle content type\n          if (!res.headersSent && contentType) {\n            res.setHeader('Content-Type', contentType.type);\n          }\n\n          // Handle versioning header\n          if (version?.options?.addHeader && version?.options?.headerName && version?.version) {\n            if (!res.headersSent) {\n              res.setHeader(version.options.headerName, version.version);\n            }\n          }\n\n          // Handle caching\n          if (cache && !res.headersSent) {\n            res.setHeader('Cache-Control', `public, max-age=${cache.ttlSeconds}`);\n          }\n\n          // Handle logging - entry\n          if (logConfig?.logEntry) {\n            const logger = getLogger();\n            const logData: any = {\n              method: req.method,\n              url: req.originalUrl || req.url,\n              userAgent: req.get('User-Agent')\n            };\n            if (logConfig.logParams) {\n              logData.params = req.params;\n              logData.query = req.query;\n            }\n            if (logConfig.logBody) logData.body = req.body;\n            logger.info({ entry: logData }, 'Route Entry:');\n          }\n\n          // Handle roles-based access control\n          if (roles.length && !(req as any)?.user?.roles?.some((role: string) => roles.includes(role))) {\n            const errorResponse = createFinalErrorResponse(\n              req,\n              HttpStatusCodes.FORBIDDEN,\n              'Forbidden Insufficient Roles'\n            );\n            res.status(HttpStatusCodes.FORBIDDEN).json(errorResponse);\n            if (timeoutId) {\n              clearTimeout(timeoutId);\n            }\n            return;\n          }\n\n          // Process static redirect if configured\n          if (redirect && redirect.url) {\n            if (timeoutId) {\n              clearTimeout(timeoutId);\n            }\n            return res.redirect(redirect.statusCode, redirect.url);\n          }\n\n          for (const fn of beforeHooks) await fn(req, res);\n          const args: any[] = [];\n          if (params.length) {\n            params.forEach(({ index, type, key }) => {\n              switch (type) {\n                case 'query':\n                  args[index] = key ? req.query[key] : req.query;\n                  break;\n                case 'param':\n                  args[index] = key ? req.params[key] : req.params;\n                  break;\n                case 'body':\n                  args[index] = key ? req.body?.[key] : req.body;\n                  break;\n                case 'req':\n                  args[index] = req;\n                  break;\n                case 'res':\n                  args[index] = res;\n                  break;\n              }\n            });\n          }\n          const result = (instance as any)[handlerName](...args);\n          // Support both sync and async handlers\n          const awaited = result instanceof Promise ? await result : result;\n\n          // Clear timeout if operation completed\n          if (timeoutId) {\n            clearTimeout(timeoutId);\n          }\n\n          if (timedOut) return;\n\n          // Handle dynamic redirects\n          if (redirect && awaited && typeof awaited === 'object' && 'url' in awaited) {\n            const redirectUrl = awaited.url as string;\n            const redirectStatus = (awaited.statusCode as number) || redirect.statusCode;\n            return res.redirect(redirectStatus, redirectUrl);\n          }\n\n          if (!res.headersSent && typeof awaited !== 'undefined') {\n            if (httpCode) res.status(httpCode);\n            for (const [k, v] of Object.entries(headers)) {\n              const normalized = normalizeHeaderValue(v);\n              if (typeof normalized !== 'undefined') {\n                res.set(k, normalized);\n              }\n            }\n            res.json(awaited);\n          }\n\n          // Handle logging - exit\n          if (logConfig?.logExit) {\n            const logger = getLogger();\n            const logData: any = {\n              method: req.method,\n              url: req.originalUrl || req.url,\n              statusCode: res.statusCode,\n              duration: `${Date.now() - (req as any).startTime}ms`\n            };\n            if (logConfig.logResponse) logData.response = awaited;\n            logger.info({ exit: logData }, 'Route Exit:');\n          }\n\n          for (const fn of afterHooks) await fn(req, res, awaited);\n        } catch (err) {\n          if (timeoutId) {\n            clearTimeout(timeoutId);\n          }\n          next(err);\n        }\n      };\n\n      (router as any)[method](basePath + finalPath, ...middlewares, handler);\n    });\n  });\n}\n\n// Export for testing purposes\nexport { rateLimiterCache };\n"]}

package/build/src/utils/dir.utils.d.ts

@@ -1,196 +0,0 @@
-import fs from 'fs';
-/**
- * Ensures that a directory exists, creating parent directories if needed (like `mkdir -p`).
- *
- * @param {string} dirPath - The directory path to ensure.
- * @returns {Promise<void>} Resolves when the directory exists.
- * @throws {Error} If directory cannot be created.
- */
-export declare function ensureDir(dirPath: string): Promise<void>;
-/**
- * Recursively lists all files in a directory.
- *
- * @param {string} dirPath - The base directory.
- * @param {boolean} [recursive=false] - Whether to recurse into subdirectories.
- * @returns {Promise<string[]>} Array of absolute file paths.
- * @throws {Error} If the directory cannot be read.
- */
-export declare function listFiles(dirPath: string, recursive?: boolean): Promise<string[]>;
-/**
- * Deletes a directory and all its contents recursively (like `rm -rf`).
- *
- * @param {string} dirPath - Directory to delete.
- * @returns {Promise<void>} Resolves when deletion is complete.
- * @throws {Error} If deletion fails.
- */
-export declare function deleteDirRecursive(dirPath: string): Promise<void>;
-/**
- * Checks whether a given path is a directory.
- *
- * @param {string} pathStr - Path to check.
- * @returns {Promise<boolean>} True if the path is a directory, else false.
- */
-export declare function isDirectory(pathStr: string): Promise<boolean>;
-/**
- * Recursively copies a directory and all its contents to a destination.
- *
- * @param {string} src - Source directory path.
- * @param {string} dest - Destination directory path.
- * @returns {Promise<void>} Resolves when copy is complete.
- * @throws {Error} If source does not exist or copy fails.
- */
-export declare function copyDir(src: string, dest: string): Promise<void>;
-/**
- * Moves a directory to a new location by copying and deleting the original.
- *
- * @param {string} src - Source directory path.
- * @param {string} dest - Destination directory path.
- * @returns {Promise<void>} Resolves when move is complete.
- * @throws {Error} If copy or deletion fails.
- */
-export declare function moveDir(src: string, dest: string): Promise<void>;
-/**
- * Empties a directory by deleting all files and subdirectories inside it.
- *
- * @param {string} dirPath - Path to the directory to empty.
- * @returns {Promise<void>} Resolves when the directory has been emptied.
- * @throws {Error} If files or subdirectories cannot be removed.
- */
-export declare function emptyDir(dirPath: string): Promise<void>;
-/**
- * Calculates the total size (in bytes) of all files in a directory (recursive).
- *
- * @param {string} dirPath - Path to the directory.
- * @returns {Promise<number>} Total size in bytes.
- * @throws {Error} If any file stats cannot be read.
- */
-export declare function getDirSize(dirPath: string): Promise<number>;
-/**
- * Watches a directory for file changes and calls a callback on each event.
- *
- * @param {string} dirPath - Directory path to watch.
- * @param {(eventType: "rename" | "change", filename: string | null) => void} callback - Callback for each change event.
- * @returns {() => void} A function to stop watching the directory.
- */
-export declare function watchDir(dirPath: string, callback: (eventType: 'rename' | 'change', filename: string | null) => void): () => void;
-/**
- * Finds files matching a glob pattern.
- *
- * @param {string} pattern - Glob pattern to match files.
- * @param {object} [options] - Options for glob pattern matching.
- * @param {string} [options.cwd] - Current working directory for relative patterns.
- * @param {boolean} [options.dot=false] - Include dotfiles in matches.
- * @param {boolean} [options.nodir=true] - Only match files, not directories.
- * @returns {Promise<string[]>} Array of matched file paths.
- * @throws {Error} If pattern matching fails.
- */
-export declare function findFilesByPattern(pattern: string, options?: {
-    cwd?: string;
-    dot?: boolean;
-    nodir?: boolean;
-}): Promise<string[]>;
-/**
- * Gets all subdirectories in a directory.
- *
- * @param {string} dirPath - The directory to search in.
- * @param {boolean} [recursive=false] - Whether to include subdirectories recursively.
- * @returns {Promise<string[]>} Array of absolute subdirectory paths.
- * @throws {Error} If directory cannot be read.
- */
-export declare function getSubdirectories(dirPath: string, recursive?: boolean): Promise<string[]>;
-/**
- * Ensures a directory exists and is empty.
- *
- * @param {string} dirPath - Path to the directory.
- * @returns {Promise<void>} Resolves when the directory exists and is empty.
- * @throws {Error} If directory cannot be created or emptied.
- */
-export declare function ensureEmptyDir(dirPath: string): Promise<void>;
-/**
- * Creates a temporary directory with optional auto-cleanup.
- *
- * @param {object} [options] - Options for the temporary directory.
- * @param {string} [options.prefix='tmp-'] - Prefix for the directory name.
- * @param {string} [options.parentDir=os.tmpdir()] - Parent directory.
- * @param {boolean} [options.cleanup=false] - Whether to register cleanup on process exit.
- * @returns {Promise<{ path: string, cleanup: () => Promise<void> }>} Object with directory path and cleanup function.
- * @throws {Error} If directory cannot be created.
- */
-export declare function createTempDir(options?: {
-    prefix?: string;
-    parentDir?: string;
-    cleanup?: boolean;
-}): Promise<{
-    path: string;
-    cleanup: () => Promise<void>;
-}>;
-/**
- * Finds the newest file in a directory.
- *
- * @param {string} dirPath - Directory to search.
- * @param {boolean} [recursive=false] - Whether to search subdirectories.
- * @returns {Promise<string | null>} Path to the newest file or null if no files.
- * @throws {Error} If directory cannot be read.
- */
-export declare function findNewestFile(dirPath: string, recursive?: boolean): Promise<string | null>;
-/**
- * Finds the oldest file in a directory.
- *
- * @param {string} dirPath - Directory to search.
- * @param {boolean} [recursive=false] - Whether to search subdirectories.
- * @returns {Promise<string | null>} Path to the oldest file or null if no files.
- * @throws {Error} If directory cannot be read.
- */
-export declare function findOldestFile(dirPath: string, recursive?: boolean): Promise<string | null>;
-/**
- * Finds files or directories in a directory matching a predicate function.
- *
- * @param {string} dirPath - Directory to search.
- * @param {(path: string, stat: fs.Stats) => boolean | Promise<boolean>} predicate - Function to test each path.
- * @param {boolean} [recursive=false] - Whether to search subdirectories.
- * @returns {Promise<string[]>} Array of matching paths.
- * @throws {Error} If directory cannot be read.
- */
-export declare function findInDir(dirPath: string, predicate: (path: string, stat: fs.Stats) => boolean | Promise<boolean>, recursive?: boolean): Promise<string[]>;
-/**
- * Watches a directory recursively for file changes.
- *
- * @param {string} dirPath - Base directory path to watch.
- * @param {(eventType: "rename" | "change", filename: string) => void} callback - Callback for each change event.
- * @param {boolean} [includeSubdirs=true] - Whether to watch subdirectories.
- * @returns {Promise<() => void>} A function to stop watching the directory.
- * @throws {Error} If directory cannot be watched.
- */
-export declare function watchDirRecursive(dirPath: string, callback: (eventType: 'rename' | 'change', filename: string) => void, includeSubdirs?: boolean): Promise<() => void>;
-/**
- * Gets detailed directory statistics including file count, directory count, and size.
- *
- * @param {string} dirPath - Path to the directory.
- * @returns {Promise<{ fileCount: number, dirCount: number, totalSize: number }>} Directory statistics.
- * @throws {Error} If directory cannot be read.
- */
-export declare function getDirStats(dirPath: string): Promise<{
-    fileCount: number;
-    dirCount: number;
-    totalSize: number;
-}>;
-/**
- * Walks through a directory hierarchy, calling a visitor function for each entry.
- *
- * @param {string} dirPath - Starting directory path.
- * @param {object} options - Options for walking the directory.
- * @param {(entry: { path: string, name: string, isDirectory: boolean, stats: fs.Stats }) => boolean | void | Promise<boolean | void>} options.visitorFn -
- *   Function called for each file/directory. Return false to skip a directory.
- * @param {'pre' | 'post'} [options.traversalOrder='pre'] - Whether to visit directories before or after their contents.
- * @throws {Error} If directory cannot be read.
- */
-export declare function walkDir(dirPath: string, options: {
-    visitorFn: (entry: {
-        path: string;
-        name: string;
-        isDirectory: boolean;
-        stats: fs.Stats;
-    }) => boolean | void | Promise<boolean | void>;
-    traversalOrder?: 'pre' | 'post';
-}): Promise<void>;
-//# sourceMappingURL=dir.utils.d.ts.map