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

package/build/esm/utils/date.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"date.utils.js","sourceRoot":"","sources":["../../../src/utils/date.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/**\n * Format options for the formatDate function\n */\nexport interface DateFormatOptions {\n  /** Date format pattern (default: 'yyyy-MM-dd') */\n  format?: string;\n  /** Locale to use for formatting (default: system locale) */\n  locale?: string | string[];\n  /** Time zone to use (default: system time zone) */\n  timeZone?: string;\n}\n\n/**\n * Format a date according to the specified format pattern.\n *\n * @param date - Date to format\n * @param options - Formatting options\n * @returns Formatted date string\n *\n * @example\n * ```typescript\n * // Format as ISO date\n * formatDate(new Date(), { format: 'yyyy-MM-dd' }); // '2023-05-15'\n *\n * // Format with time\n * formatDate(new Date(), { format: 'yyyy-MM-dd HH:mm:ss' }); // '2023-05-15 14:30:22'\n *\n * // Format with locale\n * formatDate(new Date(), { format: 'PPPP', locale: 'fr-FR' }); // 'lundi 15 mai 2023'\n * ```\n */\nexport function formatDate(date: Date | number, options: DateFormatOptions = {}): string {\n  const { format = 'yyyy-MM-dd', locale, timeZone } = options;\n  const d = date instanceof Date ? date : new Date(date);\n\n  // Custom formatter for common patterns\n  if (format === 'yyyy-MM-dd') {\n    const yyyy = d.getFullYear();\n    const mm = String(d.getMonth() + 1).padStart(2, '0');\n    const dd = String(d.getDate()).padStart(2, '0');\n    return `${yyyy}-${mm}-${dd}`;\n  }\n  if (format === 'yyyy-MM-dd HH:mm:ss') {\n    const yyyy = d.getFullYear();\n    const mm = String(d.getMonth() + 1).padStart(2, '0');\n    const dd = String(d.getDate()).padStart(2, '0');\n    const HH = String(d.getHours()).padStart(2, '0');\n    const MM = String(d.getMinutes()).padStart(2, '0');\n    const SS = String(d.getSeconds()).padStart(2, '0');\n    return `${yyyy}-${mm}-${dd} ${HH}:${MM}:${SS}`;\n  }\n  if (format === 'relative') {\n    return formatRelativeTime(date);\n  }\n\n  // Fallback to Intl.DateTimeFormat for other formats\n  return new Intl.DateTimeFormat(locale, {\n    timeZone,\n    year: format.includes('yyyy') || format.includes('y') ? 'numeric' : undefined,\n    month: format.includes('MM') || format.includes('M') ? 'numeric' : undefined,\n    day: format.includes('dd') || format.includes('d') ? 'numeric' : undefined,\n    hour: format.includes('HH') || format.includes('H') ? 'numeric' : undefined,\n    minute: format.includes('mm') || format.includes('m') ? 'numeric' : undefined,\n    second: format.includes('ss') || format.includes('s') ? 'numeric' : undefined,\n    hour12: !format.includes('HH') && !format.includes('H')\n  }).format(d);\n}\n\n/**\n * Format a date as relative time (e.g., \"5 minutes ago\", \"in 3 days\").\n *\n * @param date - Date to format\n * @param now - Reference date (default: current time)\n * @param locale - Locale to use for formatting\n * @returns Formatted relative time string\n */\nexport function formatRelativeTime(\n  date: Date | number,\n  now: Date | number = new Date(),\n  locale?: string | string[]\n): string {\n  const d1 = date instanceof Date ? date : new Date(date);\n  const d2 = now instanceof Date ? now : new Date(now);\n\n  const diffMs = d1.getTime() - d2.getTime();\n  const diffSecs = Math.round(diffMs / 1000);\n  const diffMins = Math.round(diffSecs / 60);\n  const diffHours = Math.round(diffMins / 60);\n  const diffDays = Math.round(diffHours / 24);\n  const diffMonths = Math.round(diffDays / 30);\n  const diffYears = Math.round(diffDays / 365);\n\n  const formatter = new Intl.RelativeTimeFormat(locale, { numeric: 'auto' });\n\n  if (Math.abs(diffSecs) < 60) return formatter.format(diffSecs, 'second');\n  if (Math.abs(diffMins) < 60) return formatter.format(diffMins, 'minute');\n  if (Math.abs(diffHours) < 24) return formatter.format(diffHours, 'hour');\n  if (Math.abs(diffDays) < 30) return formatter.format(diffDays, 'day');\n  if (Math.abs(diffMonths) < 12) return formatter.format(diffMonths, 'month');\n  return formatter.format(diffYears, 'year');\n}\n\n/**\n * Parse a date string or timestamp into a Date object.\n *\n * @param input - Date string or timestamp to parse\n * @param fallback - Fallback date if parsing fails\n * @returns Parsed Date object or fallback\n *\n * @example\n * ```typescript\n * parseDate('2023-05-15'); // Date object for May 15, 2023\n * parseDate('invalid', new Date()); // Returns current date as fallback\n * ```\n */\nexport function parseDate(input: string | number, fallback?: Date): Date | null {\n  if (typeof input === 'number') {\n    return new Date(input);\n  }\n\n  try {\n    const date = new Date(input);\n    // Check if date is valid\n    if (isNaN(date.getTime())) {\n      return fallback || null;\n    }\n    return date;\n  } catch {\n    return fallback || null;\n  }\n}\n\n/**\n * Calculate the difference between two dates in the specified unit.\n *\n * @param date1 - First date\n * @param date2 - Second date (default: current time)\n * @param unit - Unit of time for the difference\n * @returns Difference in the specified unit\n *\n * @example\n * ```typescript\n * // Get difference in days\n * dateDiff(new Date('2023-05-15'), new Date('2023-05-10'), 'days'); // 5\n *\n * // Get difference in hours\n * dateDiff(new Date('2023-05-15T10:00:00'), new Date('2023-05-15T06:00:00'), 'hours'); // 4\n * ```\n */\nexport function dateDiff(\n  date1: Date | number,\n  date2: Date | number = new Date(),\n  unit: 'milliseconds' | 'seconds' | 'minutes' | 'hours' | 'days' | 'months' | 'years' = 'days'\n): number {\n  const d1 = date1 instanceof Date ? date1 : new Date(date1);\n  const d2 = date2 instanceof Date ? date2 : new Date(date2);\n\n  const diffMs = d1.getTime() - d2.getTime();\n\n  switch (unit) {\n    case 'milliseconds':\n      return diffMs;\n    case 'seconds':\n      return diffMs / 1000;\n    case 'minutes':\n      return diffMs / (1000 * 60);\n    case 'hours':\n      return diffMs / (1000 * 60 * 60);\n    case 'days':\n      return diffMs / (1000 * 60 * 60 * 24);\n    case 'months':\n      return (d1.getFullYear() - d2.getFullYear()) * 12 + d1.getMonth() - d2.getMonth();\n    case 'years':\n      return d1.getFullYear() - d2.getFullYear();\n    default:\n      throw new Error(`Unsupported unit: ${unit}`);\n  }\n}\n\n/**\n * Add a specified amount of time to a date.\n *\n * @param date - Base date\n * @param amount - Amount to add (can be negative)\n * @param unit - Unit of time to add\n * @returns New date with the addition\n *\n * @example\n * ```typescript\n * // Add 5 days\n * addToDate(new Date('2023-05-15'), 5, 'days'); // Date for May 20, 2023\n *\n * // Subtract 2 hours\n * addToDate(new Date('2023-05-15T10:00:00'), -2, 'hours'); // Date for May 15, 2023 08:00:00\n * ```\n */\nexport function addToDate(\n  date: Date | number,\n  amount: number,\n  unit: 'milliseconds' | 'seconds' | 'minutes' | 'hours' | 'days' | 'months' | 'years'\n): Date {\n  const d = date instanceof Date ? new Date(date) : new Date(date);\n\n  switch (unit) {\n    case 'milliseconds':\n      d.setMilliseconds(d.getMilliseconds() + amount);\n      break;\n    case 'seconds':\n      d.setSeconds(d.getSeconds() + amount);\n      break;\n    case 'minutes':\n      d.setMinutes(d.getMinutes() + amount);\n      break;\n    case 'hours':\n      d.setHours(d.getHours() + amount);\n      break;\n    case 'days':\n      d.setDate(d.getDate() + amount);\n      break;\n    case 'months': {\n      const origDate = d.getDate();\n      const origMonth = d.getMonth();\n      d.setDate(1); // Prevent overflow\n      d.setMonth(origMonth + amount);\n      const lastDay = new Date(d.getFullYear(), d.getMonth() + 1, 0).getDate();\n      d.setDate(Math.min(origDate, lastDay));\n      break;\n    }\n    case 'years':\n      d.setFullYear(d.getFullYear() + amount);\n      break;\n    default:\n      throw new Error(`Unsupported unit: ${unit}`);\n  }\n\n  return d;\n}\n\n/**\n * Get the start of a time period containing the specified date.\n *\n * @param date - Date to get the start from\n * @param unit - Time unit\n * @returns Date object representing the start of the time unit\n *\n * @example\n * ```typescript\n * // Get start of day (midnight)\n * startOf(new Date('2023-05-15T14:30:00'), 'day'); // Date for May 15, 2023 00:00:00\n *\n * // Get start of month\n * startOf(new Date('2023-05-15'), 'month'); // Date for May 1, 2023\n * ```\n */\nexport function startOf(\n  date: Date | number,\n  unit: 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year'\n): Date {\n  const d = date instanceof Date ? new Date(date) : new Date(date);\n\n  switch (unit) {\n    case 'second':\n      d.setMilliseconds(0);\n      break;\n    case 'minute':\n      d.setSeconds(0, 0);\n      break;\n    case 'hour':\n      d.setMinutes(0, 0, 0);\n      break;\n    case 'day':\n      d.setHours(0, 0, 0, 0);\n      break;\n    case 'week':\n      d.setHours(0, 0, 0, 0);\n      d.setDate(d.getDate() - d.getDay());\n      break;\n    case 'month':\n      d.setDate(1);\n      d.setHours(0, 0, 0, 0);\n      break;\n    case 'quarter':\n      d.setMonth(Math.floor(d.getMonth() / 3) * 3, 1);\n      d.setHours(0, 0, 0, 0);\n      break;\n    case 'year':\n      d.setMonth(0, 1);\n      d.setHours(0, 0, 0, 0);\n      break;\n    default:\n      throw new Error(`Unsupported unit: ${unit}`);\n  }\n\n  return d;\n}\n\n/**\n * Get the end of a time period containing the specified date.\n *\n * @param date - Date to get the end from\n * @param unit - Time unit\n * @returns Date object representing the end of the time unit\n *\n * @example\n * ```typescript\n * // Get end of day (23:59:59.999)\n * endOf(new Date('2023-05-15T14:30:00'), 'day'); // Date for May 15, 2023 23:59:59.999\n *\n * // Get end of month\n * endOf(new Date('2023-05-15'), 'month'); // Date for May 31, 2023 23:59:59.999\n * ```\n */\nexport function endOf(\n  date: Date | number,\n  unit: 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year'\n): Date {\n  const d = date instanceof Date ? new Date(date) : new Date(date);\n\n  switch (unit) {\n    case 'second':\n      d.setMilliseconds(999);\n      break;\n    case 'minute':\n      d.setSeconds(59, 999);\n      break;\n    case 'hour':\n      d.setMinutes(59, 59, 999);\n      break;\n    case 'day':\n      d.setHours(23, 59, 59, 999);\n      break;\n    case 'week':\n      d.setDate(d.getDate() - d.getDay() + 6);\n      d.setHours(23, 59, 59, 999);\n      break;\n    case 'month':\n      d.setMonth(d.getMonth() + 1, 0);\n      d.setHours(23, 59, 59, 999);\n      break;\n    case 'quarter':\n      d.setMonth(Math.floor(d.getMonth() / 3) * 3 + 3, 0);\n      d.setHours(23, 59, 59, 999);\n      break;\n    case 'year':\n      d.setMonth(11, 31);\n      d.setHours(23, 59, 59, 999);\n      break;\n    default:\n      throw new Error(`Unsupported unit: ${unit}`);\n  }\n\n  return d;\n}\n\n/**\n * Check if a date is between two other dates.\n *\n * @param date - Date to check\n * @param start - Start date of the range\n * @param end - End date of the range\n * @param inclusive - Whether the comparison should be inclusive of start/end\n * @returns True if the date is within the range\n *\n * @example\n * ```typescript\n * const date = new Date('2023-05-15');\n * const start = new Date('2023-05-10');\n * const end = new Date('2023-05-20');\n *\n * isBetween(date, start, end); // true\n * ```\n */\nexport function isBetween(\n  date: Date | number,\n  start: Date | number,\n  end: Date | number,\n  inclusive: boolean = true\n): boolean {\n  const d = date instanceof Date ? date.getTime() : date;\n  const s = start instanceof Date ? start.getTime() : start;\n  const e = end instanceof Date ? end.getTime() : end;\n\n  return inclusive ? d >= s && d <= e : d > s && d < e;\n}\n\n/**\n * Check if a year is a leap year.\n *\n * @param year - Year to check (or date object)\n * @returns True if the year is a leap year\n */\nexport function isLeapYear(year: number | Date): boolean {\n  const y = year instanceof Date ? year.getFullYear() : year;\n  return (y % 4 === 0 && y % 100 !== 0) || y % 400 === 0;\n}\n\n/**\n * Get the number of days in a month.\n *\n * @param year - Year\n * @param month - Month (0-11)\n * @returns Number of days in the month\n */\nexport function daysInMonth(year: number | Date, month?: number): number {\n  if (year instanceof Date) {\n    month = year.getMonth();\n    year = year.getFullYear();\n  }\n\n  if (month === undefined) {\n    throw new Error('Month is required when year is a number');\n  }\n\n  return new Date(year, month + 1, 0).getDate();\n}\n"]}

package/build/esm/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 { RequestHandler, Router } from 'express';\nimport 'reflect-metadata';\nimport { HttpStatusCodes } from './http-status-codes';\nimport { ForbiddenException } from './exception.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');\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\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 name - Header name\n * @param value - Header value\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 * ```\n */\nexport function Header(name: string, value: string): MethodDecorator {\n  return (target, propertyKey, _descriptor) => {\n    const headers: Record<string, string> = Reflect.getMetadata(HEADER_KEY, target, propertyKey as string) || {};\n    headers[name] = value;\n    Reflect.defineMetadata(HEADER_KEY, headers, target, propertyKey as string);\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 * 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    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      const headers: Record<string, string> = Reflect.getMetadata(HEADER_KEY, instance, handlerName) || {};\n      const beforeHooks: Function[] = Reflect.getMetadata(BEFORE_KEY, instance, handlerName) || [];\n      const afterHooks: Function[] = Reflect.getMetadata(AFTER_KEY, instance, handlerName) || [];\n      const roles: string[] = Reflect.getMetadata(ROLES_KEY, instance, handlerName) || [];\n      const redirect: { url?: string; statusCode: number } | undefined = Reflect.getMetadata(\n        REDIRECT_KEY,\n        instance,\n        handlerName\n      );\n\n      const handler: RequestHandler = async (req, res, next) => {\n        try {\n          // Handle roles-based access control\n          if (roles.length && !(req as any)?.user?.roles?.some((role: string) => roles.includes(role))) {\n            res.status(HttpStatusCodes.FORBIDDEN).json(new ForbiddenException('Forbidden Insufficient Roles'));\n            return;\n          }\n\n          // Process static redirect if configured\n          if (redirect && redirect.url) {\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          // 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)) res.set?.(k, v);\n            res.json(awaited);\n          }\n          for (const fn of afterHooks) await fn(req, res, awaited);\n        } catch (err) {\n          next(err);\n        }\n      };\n\n      (router as any)[method](basePath + path, ...middlewares, handler);\n    });\n  });\n}\n"]}

package/build/esm/utils/dir.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"dir.utils.js","sourceRoot":"","sources":["../../../src/utils/dir.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,GAAG,MAAM,aAAa,CAAC;AAC9B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC;;;;;;GAMG;AACH,MAAM,UAAgB,SAAS,CAAC,OAAe;;;;wBAC7C,qBAAM,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,EAAA;;oBAA7C,SAA6C,CAAC;;;;;CAC/C;AAED;;;;;;;GAOG;AACH,MAAM,UAAgB,SAAS;wDAAC,OAAe,EAAE,SAAiB;;;QAAjB,0BAAA,EAAA,iBAAiB;;;wBAChD,qBAAM,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAA;;oBAA7D,OAAO,GAAG,SAAmD;oBAC7D,KAAK,GAAa,EAAE,CAAC;;;;oBAEP,YAAA,SAAA,OAAO,CAAA;;;;oBAAhB,KAAK;oBACR,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;yBAE5C,KAAK,CAAC,MAAM,EAAE,EAAd,wBAAc;oBAChB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;;;yBACZ,CAAA,SAAS,IAAI,KAAK,CAAC,WAAW,EAAE,CAAA,EAAhC,wBAAgC;oBACrB,qBAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAA;;oBAA7C,WAAW,GAAG,SAA+B;oBACnD,KAAK,CAAC,IAAI,OAAV,KAAK,2BAAS,WAAW,WAAE;;;;;;;;;;;;;;;;yBAI/B,sBAAO,KAAK,EAAC;;;;CACd;AAED;;;;;;GAMG;AACH,MAAM,UAAgB,kBAAkB,CAAC,OAAe;;;;wBACtD,qBAAM,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAA;;oBAAvD,SAAuD,CAAC;;;;;CACzD;AAED;;;;;GAKG;AACH,MAAM,UAAgB,WAAW,CAAC,OAAe;;;;;;;oBAEhC,qBAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,EAAA;;oBAA9B,IAAI,GAAG,SAAuB;oBACpC,sBAAO,IAAI,CAAC,WAAW,EAAE,EAAC;;;oBAE1B,sBAAO,KAAK,EAAC;;;;;CAEhB;AAED;;;;;;;GAOG;AACH,MAAM,UAAgB,OAAO,CAAC,GAAW,EAAE,IAAY;;;;;;wBACrD,qBAAM,SAAS,CAAC,IAAI,CAAC,EAAA;;oBAArB,SAAqB,CAAC;oBACN,qBAAM,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAA;;oBAAzD,OAAO,GAAG,SAA+C;;;;oBAE3C,YAAA,SAAA,OAAO,CAAA;;;;oBAAhB,KAAK;oBACR,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;oBACrC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;yBAEzC,KAAK,CAAC,WAAW,EAAE,EAAnB,wBAAmB;oBACrB,qBAAM,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAA;;oBAAhC,SAAgC,CAAC;;wBAEjC,qBAAM,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAA;;oBAArC,SAAqC,CAAC;;;;;;;;;;;;;;;;;;;;CAG3C;AAED;;;;;;;GAOG;AACH,MAAM,UAAgB,OAAO,CAAC,GAAW,EAAE,IAAY;;;;wBACrD,qBAAM,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,EAAA;;oBAAxB,SAAwB,CAAC;oBACzB,qBAAM,kBAAkB,CAAC,GAAG,CAAC,EAAA;;oBAA7B,SAA6B,CAAC;;;;;CAC/B;AAED;;;;;;GAMG;AACH,MAAM,UAAgB,QAAQ,CAAC,OAAe;;;;;;wBAC5B,qBAAM,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAA;;oBAA7D,OAAO,GAAG,SAAmD;;;;oBAE/C,YAAA,SAAA,OAAO,CAAA;;;;oBAAhB,KAAK;oBACR,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;yBAE7C,KAAK,CAAC,WAAW,EAAE,EAAnB,wBAAmB;oBACrB,qBAAM,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAA;;oBAAzD,SAAyD,CAAC;;wBAE1D,qBAAM,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,EAAA;;oBAA3B,SAA2B,CAAC;;;;;;;;;;;;;;;;;;;;CAGjC;AAED;;;;;;GAMG;AACH,MAAM,UAAgB,UAAU,CAAC,OAAe;;;;;;;oBAC1C,KAAK,GAAG,CAAC,CAAC;oBACE,qBAAM,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAA;;oBAA7D,OAAO,GAAG,SAAmD;;;;oBAE/C,YAAA,SAAA,OAAO,CAAA;;;;oBAAhB,KAAK;oBACR,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;yBAC7C,KAAK,CAAC,WAAW,EAAE,EAAnB,wBAAmB;oBACrB,KAAA,KAAK,CAAA;oBAAI,qBAAM,UAAU,CAAC,SAAS,CAAC,EAAA;;oBAApC,KAAK,GAAL,KAAS,SAA2B,CAAC;;wBAExB,qBAAM,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAA;;oBAAhC,IAAI,GAAG,SAAyB;oBACtC,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;yBAIvB,sBAAO,KAAK,EAAC;;;;CACd;AAED;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CACtB,OAAe,EACf,QAA2E;IAE3E,IAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,UAAC,SAAS,EAAE,QAAQ;QACpD,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,OAAO,cAAM,OAAA,OAAO,CAAC,KAAK,EAAE,EAAf,CAAe,CAAC;AAC/B,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAgB,kBAAkB;wDACtC,OAAe,EACf,OAA8D;;QAA9D,wBAAA,EAAA,YAA8D;;YAExD,cAAc,cAAK,KAAK,EAAE,IAAI,IAAK,OAAO,CAAE,CAAC;YACnD,sBAAO,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,EAAC;;;CACtC;AAED;;;;;;;GAOG;AACH,MAAM,UAAgB,iBAAiB;wDAAC,OAAe,EAAE,SAAiB;;QAAjB,0BAAA,EAAA,iBAAiB;;;wBACxD,qBAAM,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAA;;oBAA7D,OAAO,GAAG,SAAmD;oBAC7D,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,UAAA,KAAK,IAAI,OAAA,KAAK,CAAC,WAAW,EAAE,EAAnB,CAAmB,CAAC,CAAC,GAAG,CAAC,UAAA,KAAK,IAAI,OAAA,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,EAA9B,CAA8B,CAAC,CAAC;yBAEnG,CAAA,SAAS,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAA,EAA5B,wBAA4B;oBACX,qBAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,UAAA,GAAG,IAAI,OAAA,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,EAA5B,CAA4B,CAAC,CAAC,EAAA;;oBAA7E,UAAU,GAAG,SAAgE;oBACnF,6DAAW,IAAI,kBAAK,UAAU,CAAC,IAAI,EAAE,WAAE;wBAGzC,sBAAO,IAAI,EAAC;;;;CACb;AAED;;;;;;GAMG;AACH,MAAM,UAAgB,cAAc,CAAC,OAAe;;;;;wBAC9C,qBAAM,WAAW,CAAC,OAAO,CAAC,EAAA;;yBAA1B,SAA0B,EAA1B,wBAA0B;oBAC5B,qBAAM,QAAQ,CAAC,OAAO,CAAC,EAAA;;oBAAvB,SAAuB,CAAC;;;;oBAGtB,qBAAM,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,EAAA;;oBAAzB,SAAyB,CAAC;;;;oBAE1B,+BAA+B;oBAC/B,IAAK,OAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;wBACvD,MAAM,OAAK,CAAC;oBACd,CAAC;;wBAEH,qBAAM,SAAS,CAAC,OAAO,CAAC,EAAA;;oBAAxB,SAAwB,CAAC;;;;;;CAE5B;AAED;;;;;;;;;GASG;AACH,MAAM,UAAgB,aAAa;wDACjC,OAAwE;;;QAAxE,wBAAA,EAAA,YAAwE;;;;oBAElE,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC;oBAClC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC;oBAC7C,OAAO,GAAG,UAAG,MAAM,SAAG,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAE,CAAC;oBACvD,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;oBAElD,qBAAM,SAAS,CAAC,WAAW,CAAC,EAAA;;oBAA5B,SAA4B,CAAC;oBAEvB,OAAO,GAAG;;;;;;oCAEZ,qBAAM,kBAAkB,CAAC,WAAW,CAAC,EAAA;;oCAArC,SAAqC,CAAC;;;;;;;;yBAIzC,CAAC;oBAEF,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;wBACpB,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE;4BACnB,IAAI,CAAC;gCACH,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;4BAC3D,CAAC;4BAAC,WAAM,CAAC;gCACP,gCAAgC;4BAClC,CAAC;wBACH,CAAC,CAAC,CAAC;wBAEH,oCAAoC;wBACpC,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,OAAO,CAAC,UAAA,MAAM;4BACxD,OAAO,CAAC,IAAI,CAAC,MAAwB,EAAE;gCACrC,OAAO,EAAE,CAAC,IAAI,CAAC,cAAM,OAAA,OAAO,CAAC,IAAI,EAAE,EAAd,CAAc,CAAC,CAAC;4BACvC,CAAC,CAAC,CAAC;wBACL,CAAC,CAAC,CAAC;oBACL,CAAC;oBAED,sBAAO,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,SAAA,EAAE,EAAC;;;;CACvC;AAED;;;;;;;GAOG;AACH,MAAM,UAAgB,cAAc;wDAAC,OAAe,EAAE,SAAiB;;;QAAjB,0BAAA,EAAA,iBAAiB;;;wBACvD,qBAAM,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,EAAA;;oBAA3C,KAAK,GAAG,SAAmC;oBACjD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;wBAAE,sBAAO,IAAI,EAAC;oBAEtB,qBAAM,OAAO,CAAC,GAAG,CAC7B,KAAK,CAAC,GAAG,CAAC,UAAM,IAAI;;;;;;4CAClB,IAAI,EAAE,IAAI;;wCACF,qBAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAA;4CAFN,sBAAA,CAEtB,QAAK,GAAE,CAAC,SAAoB,CAAC,CAAC,KAAK;+CACnC,EAAA;;;6BAAA,CAAC,CACJ,EAAA;;oBALK,KAAK,GAAG,SAKb;oBAED,sBAAO,KAAK,CAAC,IAAI,CAAC,UAAC,CAAC,EAAE,CAAC,IAAK,OAAA,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,EAArC,CAAqC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAC;;;;CAC5E;AAED;;;;;;;GAOG;AACH,MAAM,UAAgB,cAAc;wDAAC,OAAe,EAAE,SAAiB;;;QAAjB,0BAAA,EAAA,iBAAiB;;;wBACvD,qBAAM,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,EAAA;;oBAA3C,KAAK,GAAG,SAAmC;oBACjD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;wBAAE,sBAAO,IAAI,EAAC;oBAEtB,qBAAM,OAAO,CAAC,GAAG,CAC7B,KAAK,CAAC,GAAG,CAAC,UAAM,IAAI;;;;;;4CAClB,IAAI,EAAE,IAAI;;wCACF,qBAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAA;4CAFN,sBAAA,CAEtB,QAAK,GAAE,CAAC,SAAoB,CAAC,CAAC,KAAK;+CACnC,EAAA;;;6BAAA,CAAC,CACJ,EAAA;;oBALK,KAAK,GAAG,SAKb;oBAED,sBAAO,KAAK,CAAC,IAAI,CAAC,UAAC,CAAC,EAAE,CAAC,IAAK,OAAA,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,EAArC,CAAqC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAC;;;;CAC5E;AAED;;;;;;;;GAQG;AACH,MAAM,UAAgB,SAAS;wDAC7B,OAAe,EACf,SAAuE,EACvE,SAAiB;;;QAAjB,0BAAA,EAAA,iBAAiB;;;wBAED,qBAAM,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAA;;oBAA7D,OAAO,GAAG,SAAmD;oBAC7D,OAAO,GAAa,EAAE,CAAC;;;;oBAET,YAAA,SAAA,OAAO,CAAA;;;;oBAAhB,KAAK;oBACR,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;oBACpC,qBAAM,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAA;;oBAAhC,IAAI,GAAG,SAAyB;oBAElC,qBAAM,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,EAAA;;oBAApC,IAAI,SAAgC,EAAE,CAAC;wBACrC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;oBAC1B,CAAC;yBAEG,CAAA,SAAS,IAAI,KAAK,CAAC,WAAW,EAAE,CAAA,EAAhC,wBAAgC;oBACZ,qBAAM,SAAS,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,EAAA;;oBAA3D,aAAa,GAAG,SAA2C;oBACjE,OAAO,CAAC,IAAI,OAAZ,OAAO,2BAAS,aAAa,WAAE;;;;;;;;;;;;;;;;yBAInC,sBAAO,OAAO,EAAC;;;;CAChB;AAED;;;;;;;;GAQG;AACH,MAAM,UAAgB,iBAAiB;wDACrC,OAAe,EACf,QAAoE,EACpE,cAAqB;;;;QAArB,+BAAA,EAAA,qBAAqB;;;;oBAGf,kBAAkB,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;oBAG7C,QAAQ,GAAmB,EAAE,CAAC;oBAG9B,UAAU,GAAG,UAAC,GAAW;wBAC7B,IAAI,CAAC;4BACH,IAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,UAAC,SAAS,EAAE,QAAQ;gCAChD,IAAI,CAAC,QAAQ;oCAAE,OAAO;gCAEtB,IAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;gCAC1C,+CAA+C;gCAC/C,IAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;gCACjE,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;gCAElC,oDAAoD;gCACpD,IAAI,SAAS,KAAK,QAAQ,IAAI,cAAc,EAAE,CAAC;oCAC7C,UAAU,CAAC;;;;;;oDAEH,qBAAM,WAAW,CAAC,QAAQ,CAAC,EAAA;;oDAA/B,IAAI,SAA2B,EAAE,CAAC;wDAChC,UAAU,CAAC,QAAQ,CAAC,CAAC;oDACvB,CAAC;;;;;;;;yCAIJ,EAAE,GAAG,CAAC,CAAC;gCACV,CAAC;4BACH,CAAC,CAAC,CAAC;4BACH,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;wBACzB,CAAC;wBAAC,WAAM,CAAC;4BACP,6CAA6C;wBAC/C,CAAC;oBACH,CAAC,CAAC;oBAEF,qCAAqC;oBACrC,UAAU,CAAC,kBAAkB,CAAC,CAAC;yBAG3B,cAAc,EAAd,wBAAc;oBACA,qBAAM,iBAAiB,CAAC,kBAAkB,EAAE,IAAI,CAAC,EAAA;;oBAA3D,OAAO,GAAG,SAAiD;;wBACjE,KAAqB,YAAA,SAAA,OAAO,CAAA,qFAAE,CAAC;4BAApB,MAAM;4BACf,UAAU,CAAC,MAAM,CAAC,CAAC;wBACrB,CAAC;;;;;;;;;;;gBAGH,0CAA0C;gBAC1C,sBAAO;wBACL,QAAQ,CAAC,OAAO,CAAC,UAAA,OAAO,IAAI,OAAA,OAAO,CAAC,KAAK,EAAE,EAAf,CAAe,CAAC,CAAC;oBAC/C,CAAC,EAAC;;;;CACH;AAED;;;;;;GAMG;AACH,MAAM,UAAgB,WAAW,CAC/B,OAAe;;QAMf,SAAe,UAAU,CAAC,WAAmB;;;;;;gCAC3B,qBAAM,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAA;;4BAAjE,OAAO,GAAG,SAAuD;;;;4BAEnD,YAAA,SAAA,OAAO,CAAA;;;;4BAAhB,KAAK;4BACR,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;iCAEjD,KAAK,CAAC,WAAW,EAAE,EAAnB,wBAAmB;4BACrB,QAAQ,EAAE,CAAC;4BACX,qBAAM,UAAU,CAAC,SAAS,CAAC,EAAA;;4BAA3B,SAA2B,CAAC;;;iCACnB,KAAK,CAAC,MAAM,EAAE,EAAd,wBAAc;4BACvB,SAAS,EAAE,CAAC;4BACC,qBAAM,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAA;;4BAAhC,IAAI,GAAG,SAAyB;4BACtC,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;SAG5B;;;;;oBAnBG,SAAS,GAAG,CAAC,CAAC;oBACd,QAAQ,GAAG,CAAC,CAAC;oBACb,SAAS,GAAG,CAAC,CAAC;oBAmBlB,qBAAM,UAAU,CAAC,OAAO,CAAC,EAAA;;oBAAzB,SAAyB,CAAC;oBAE1B,sBAAO,EAAE,SAAS,WAAA,EAAE,QAAQ,UAAA,EAAE,SAAS,WAAA,EAAE,EAAC;;;;CAC3C;AAED;;;;;;;;;GASG;AACH,MAAM,UAAgB,OAAO,CAC3B,OAAe,EACf,OAQC;;;;;;;oBAEK,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,KAAK,CAAC;oBACvC,qBAAM,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAA;;oBAA7D,OAAO,GAAG,SAAmD;;;;oBAE/C,YAAA,SAAA,OAAO,CAAA;;;;oBAAhB,KAAK;oBACR,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;oBACnC,qBAAM,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAA;;oBAAjC,KAAK,GAAG,SAAyB;oBACjC,SAAS,GAAG;wBAChB,IAAI,EAAE,SAAS;wBACf,IAAI,EAAE,KAAK,CAAC,IAAI;wBAChB,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE;wBAChC,KAAK,OAAA;qBACN,CAAC;yBAEE,KAAK,CAAC,WAAW,EAAE,EAAnB,yBAAmB;yBAEjB,CAAA,cAAc,KAAK,KAAK,CAAA,EAAxB,wBAAwB;oBACH,qBAAM,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,EAAA;;oBAAnD,cAAc,GAAG,SAAkC;yBAErD,CAAA,cAAc,KAAK,KAAK,CAAA,EAAxB,wBAAwB;oBAC1B,qBAAM,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,EAAA;;oBAAjC,SAAiC,CAAC;;;;gBAGpC,iDAAiD;gBACjD,qBAAM,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,EAAA;;oBADjC,iDAAiD;oBACjD,SAAiC,CAAC;oBAClC,qBAAM,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,EAAA;;oBAAlC,SAAkC,CAAC;;;;gBAGrC,4CAA4C;gBAC5C,qBAAM,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,EAAA;;oBADlC,4CAA4C;oBAC5C,SAAkC,CAAC;;;;;;;;;;;;;;;;;yBAInC,CAAA,cAAc,KAAK,MAAM,CAAA,EAAzB,yBAAyB;oBAGb,qBAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,EAAA;;oBAA/B,KAAK,GAAG,SAAuB;oBAC/B,SAAS,GAAG;wBAChB,IAAI,EAAE,OAAO;wBACb,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;wBAC5B,WAAW,EAAE,IAAI;wBACjB,KAAK,OAAA;qBACN,CAAC;oBACF,qBAAM,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,EAAA;;oBAAlC,SAAkC,CAAC;;;;;;CAEtC","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\nimport os from 'os';\nimport fs from 'fs';\nimport fsp from 'fs/promises';\nimport path from 'path';\nimport { glob } from 'glob';\nimport { randomBytes } from 'crypto';\n\n/**\n * Ensures that a directory exists, creating parent directories if needed (like `mkdir -p`).\n *\n * @param {string} dirPath - The directory path to ensure.\n * @returns {Promise<void>} Resolves when the directory exists.\n * @throws {Error} If directory cannot be created.\n */\nexport async function ensureDir(dirPath: string): Promise<void> {\n  await fsp.mkdir(dirPath, { recursive: true });\n}\n\n/**\n * Recursively lists all files in a directory.\n *\n * @param {string} dirPath - The base directory.\n * @param {boolean} [recursive=false] - Whether to recurse into subdirectories.\n * @returns {Promise<string[]>} Array of absolute file paths.\n * @throws {Error} If the directory cannot be read.\n */\nexport async function listFiles(dirPath: string, recursive = false): Promise<string[]> {\n  const entries = await fsp.readdir(dirPath, { withFileTypes: true });\n  const files: string[] = [];\n\n  for (const entry of entries) {\n    const fullPath = path.join(dirPath, entry.name);\n\n    if (entry.isFile()) {\n      files.push(fullPath);\n    } else if (recursive && entry.isDirectory()) {\n      const nestedFiles = await listFiles(fullPath, true);\n      files.push(...nestedFiles);\n    }\n  }\n\n  return files;\n}\n\n/**\n * Deletes a directory and all its contents recursively (like `rm -rf`).\n *\n * @param {string} dirPath - Directory to delete.\n * @returns {Promise<void>} Resolves when deletion is complete.\n * @throws {Error} If deletion fails.\n */\nexport async function deleteDirRecursive(dirPath: string): Promise<void> {\n  await fsp.rm(dirPath, { recursive: true, force: true });\n}\n\n/**\n * Checks whether a given path is a directory.\n *\n * @param {string} pathStr - Path to check.\n * @returns {Promise<boolean>} True if the path is a directory, else false.\n */\nexport async function isDirectory(pathStr: string): Promise<boolean> {\n  try {\n    const stat = await fsp.stat(pathStr);\n    return stat.isDirectory();\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Recursively copies a directory and all its contents to a destination.\n *\n * @param {string} src - Source directory path.\n * @param {string} dest - Destination directory path.\n * @returns {Promise<void>} Resolves when copy is complete.\n * @throws {Error} If source does not exist or copy fails.\n */\nexport async function copyDir(src: string, dest: string): Promise<void> {\n  await ensureDir(dest);\n  const entries = await fsp.readdir(src, { withFileTypes: true });\n\n  for (const entry of entries) {\n    const srcPath = path.join(src, entry.name);\n    const destPath = path.join(dest, entry.name);\n\n    if (entry.isDirectory()) {\n      await copyDir(srcPath, destPath);\n    } else {\n      await fsp.copyFile(srcPath, destPath);\n    }\n  }\n}\n\n/**\n * Moves a directory to a new location by copying and deleting the original.\n *\n * @param {string} src - Source directory path.\n * @param {string} dest - Destination directory path.\n * @returns {Promise<void>} Resolves when move is complete.\n * @throws {Error} If copy or deletion fails.\n */\nexport async function moveDir(src: string, dest: string): Promise<void> {\n  await copyDir(src, dest);\n  await deleteDirRecursive(src);\n}\n\n/**\n * Empties a directory by deleting all files and subdirectories inside it.\n *\n * @param {string} dirPath - Path to the directory to empty.\n * @returns {Promise<void>} Resolves when the directory has been emptied.\n * @throws {Error} If files or subdirectories cannot be removed.\n */\nexport async function emptyDir(dirPath: string): Promise<void> {\n  const entries = await fsp.readdir(dirPath, { withFileTypes: true });\n\n  for (const entry of entries) {\n    const entryPath = path.join(dirPath, entry.name);\n\n    if (entry.isDirectory()) {\n      await fsp.rm(entryPath, { recursive: true, force: true });\n    } else {\n      await fsp.unlink(entryPath);\n    }\n  }\n}\n\n/**\n * Calculates the total size (in bytes) of all files in a directory (recursive).\n *\n * @param {string} dirPath - Path to the directory.\n * @returns {Promise<number>} Total size in bytes.\n * @throws {Error} If any file stats cannot be read.\n */\nexport async function getDirSize(dirPath: string): Promise<number> {\n  let total = 0;\n  const entries = await fsp.readdir(dirPath, { withFileTypes: true });\n\n  for (const entry of entries) {\n    const entryPath = path.join(dirPath, entry.name);\n    if (entry.isDirectory()) {\n      total += await getDirSize(entryPath);\n    } else {\n      const stat = await fsp.stat(entryPath);\n      total += stat.size;\n    }\n  }\n\n  return total;\n}\n\n/**\n * Watches a directory for file changes and calls a callback on each event.\n *\n * @param {string} dirPath - Directory path to watch.\n * @param {(eventType: \"rename\" | \"change\", filename: string | null) => void} callback - Callback for each change event.\n * @returns {() => void} A function to stop watching the directory.\n */\nexport function watchDir(\n  dirPath: string,\n  callback: (eventType: 'rename' | 'change', filename: string | null) => void\n): () => void {\n  const watcher = fs.watch(dirPath, (eventType, filename) => {\n    callback(eventType, filename);\n  });\n\n  return () => watcher.close();\n}\n\n/**\n * Finds files matching a glob pattern.\n *\n * @param {string} pattern - Glob pattern to match files.\n * @param {object} [options] - Options for glob pattern matching.\n * @param {string} [options.cwd] - Current working directory for relative patterns.\n * @param {boolean} [options.dot=false] - Include dotfiles in matches.\n * @param {boolean} [options.nodir=true] - Only match files, not directories.\n * @returns {Promise<string[]>} Array of matched file paths.\n * @throws {Error} If pattern matching fails.\n */\nexport async function findFilesByPattern(\n  pattern: string,\n  options: { cwd?: string; dot?: boolean; nodir?: boolean } = {}\n): Promise<string[]> {\n  const defaultOptions = { nodir: true, ...options };\n  return glob(pattern, defaultOptions);\n}\n\n/**\n * Gets all subdirectories in a directory.\n *\n * @param {string} dirPath - The directory to search in.\n * @param {boolean} [recursive=false] - Whether to include subdirectories recursively.\n * @returns {Promise<string[]>} Array of absolute subdirectory paths.\n * @throws {Error} If directory cannot be read.\n */\nexport async function getSubdirectories(dirPath: string, recursive = false): Promise<string[]> {\n  const entries = await fsp.readdir(dirPath, { withFileTypes: true });\n  const dirs = entries.filter(entry => entry.isDirectory()).map(entry => path.join(dirPath, entry.name));\n\n  if (recursive && dirs.length > 0) {\n    const nestedDirs = await Promise.all(dirs.map(dir => getSubdirectories(dir, true)));\n    return [...dirs, ...nestedDirs.flat()];\n  }\n\n  return dirs;\n}\n\n/**\n * Ensures a directory exists and is empty.\n *\n * @param {string} dirPath - Path to the directory.\n * @returns {Promise<void>} Resolves when the directory exists and is empty.\n * @throws {Error} If directory cannot be created or emptied.\n */\nexport async function ensureEmptyDir(dirPath: string): Promise<void> {\n  if (await isDirectory(dirPath)) {\n    await emptyDir(dirPath);\n  } else {\n    try {\n      await fsp.unlink(dirPath);\n    } catch (error) {\n      // Ignore if file doesn't exist\n      if ((error as NodeJS.ErrnoException).code !== 'ENOENT') {\n        throw error;\n      }\n    }\n    await ensureDir(dirPath);\n  }\n}\n\n/**\n * Creates a temporary directory with optional auto-cleanup.\n *\n * @param {object} [options] - Options for the temporary directory.\n * @param {string} [options.prefix='tmp-'] - Prefix for the directory name.\n * @param {string} [options.parentDir=os.tmpdir()] - Parent directory.\n * @param {boolean} [options.cleanup=false] - Whether to register cleanup on process exit.\n * @returns {Promise<{ path: string, cleanup: () => Promise<void> }>} Object with directory path and cleanup function.\n * @throws {Error} If directory cannot be created.\n */\nexport async function createTempDir(\n  options: { prefix?: string; parentDir?: string; cleanup?: boolean } = {}\n): Promise<{ path: string; cleanup: () => Promise<void> }> {\n  const prefix = options.prefix || 'tmp-';\n  const parentDir = options.parentDir || os.tmpdir();\n  const dirName = `${prefix}${randomBytes(6).toString('hex')}`;\n  const tempDirPath = path.join(parentDir, dirName);\n\n  await ensureDir(tempDirPath);\n\n  const cleanup = async () => {\n    try {\n      await deleteDirRecursive(tempDirPath);\n    } catch {\n      // Ignore cleanup errors\n    }\n  };\n\n  if (options.cleanup) {\n    process.once('exit', () => {\n      try {\n        fs.rmSync(tempDirPath, { recursive: true, force: true });\n      } catch {\n        // Ignore cleanup errors on exit\n      }\n    });\n\n    // Handle signals for better cleanup\n    ['SIGINT', 'SIGTERM', 'SIGUSR1', 'SIGUSR2'].forEach(signal => {\n      process.once(signal as NodeJS.Signals, () => {\n        cleanup().then(() => process.exit());\n      });\n    });\n  }\n\n  return { path: tempDirPath, cleanup };\n}\n\n/**\n * Finds the newest file in a directory.\n *\n * @param {string} dirPath - Directory to search.\n * @param {boolean} [recursive=false] - Whether to search subdirectories.\n * @returns {Promise<string | null>} Path to the newest file or null if no files.\n * @throws {Error} If directory cannot be read.\n */\nexport async function findNewestFile(dirPath: string, recursive = false): Promise<string | null> {\n  const files = await listFiles(dirPath, recursive);\n  if (files.length === 0) return null;\n\n  const stats = await Promise.all(\n    files.map(async file => ({\n      path: file,\n      mtime: (await fsp.stat(file)).mtime\n    }))\n  );\n\n  return stats.sort((a, b) => b.mtime.getTime() - a.mtime.getTime())[0].path;\n}\n\n/**\n * Finds the oldest file in a directory.\n *\n * @param {string} dirPath - Directory to search.\n * @param {boolean} [recursive=false] - Whether to search subdirectories.\n * @returns {Promise<string | null>} Path to the oldest file or null if no files.\n * @throws {Error} If directory cannot be read.\n */\nexport async function findOldestFile(dirPath: string, recursive = false): Promise<string | null> {\n  const files = await listFiles(dirPath, recursive);\n  if (files.length === 0) return null;\n\n  const stats = await Promise.all(\n    files.map(async file => ({\n      path: file,\n      mtime: (await fsp.stat(file)).mtime\n    }))\n  );\n\n  return stats.sort((a, b) => a.mtime.getTime() - b.mtime.getTime())[0].path;\n}\n\n/**\n * Finds files or directories in a directory matching a predicate function.\n *\n * @param {string} dirPath - Directory to search.\n * @param {(path: string, stat: fs.Stats) => boolean | Promise<boolean>} predicate - Function to test each path.\n * @param {boolean} [recursive=false] - Whether to search subdirectories.\n * @returns {Promise<string[]>} Array of matching paths.\n * @throws {Error} If directory cannot be read.\n */\nexport async function findInDir(\n  dirPath: string,\n  predicate: (path: string, stat: fs.Stats) => boolean | Promise<boolean>,\n  recursive = false\n): Promise<string[]> {\n  const entries = await fsp.readdir(dirPath, { withFileTypes: true });\n  const results: string[] = [];\n\n  for (const entry of entries) {\n    const entryPath = path.join(dirPath, entry.name);\n    const stat = await fsp.stat(entryPath);\n\n    if (await predicate(entryPath, stat)) {\n      results.push(entryPath);\n    }\n\n    if (recursive && entry.isDirectory()) {\n      const nestedResults = await findInDir(entryPath, predicate, true);\n      results.push(...nestedResults);\n    }\n  }\n\n  return results;\n}\n\n/**\n * Watches a directory recursively for file changes.\n *\n * @param {string} dirPath - Base directory path to watch.\n * @param {(eventType: \"rename\" | \"change\", filename: string) => void} callback - Callback for each change event.\n * @param {boolean} [includeSubdirs=true] - Whether to watch subdirectories.\n * @returns {Promise<() => void>} A function to stop watching the directory.\n * @throws {Error} If directory cannot be watched.\n */\nexport async function watchDirRecursive(\n  dirPath: string,\n  callback: (eventType: 'rename' | 'change', filename: string) => void,\n  includeSubdirs = true\n): Promise<() => void> {\n  // Normalize the path to ensure consistent path separators\n  const normalizedBasePath = path.normalize(dirPath);\n\n  // Create watchers for the base dir and all subdirectories\n  const watchers: fs.FSWatcher[] = [];\n\n  // Helper function to add a watcher for a directory\n  const addWatcher = (dir: string) => {\n    try {\n      const watcher = fs.watch(dir, (eventType, filename) => {\n        if (!filename) return;\n\n        const fullPath = path.join(dir, filename);\n        // Make the path relative to the base directory\n        const relativePath = path.relative(normalizedBasePath, fullPath);\n        callback(eventType, relativePath);\n\n        // If a new directory is created, we should watch it\n        if (eventType === 'rename' && includeSubdirs) {\n          setTimeout(async () => {\n            try {\n              if (await isDirectory(fullPath)) {\n                addWatcher(fullPath);\n              }\n            } catch {\n              // Ignore errors checking newly created items\n            }\n          }, 100);\n        }\n      });\n      watchers.push(watcher);\n    } catch {\n      // Silently ignore directories we can't watch\n    }\n  };\n\n  // Add watcher for the base directory\n  addWatcher(normalizedBasePath);\n\n  // If watching subdirectories, add watchers for all existing subdirectories\n  if (includeSubdirs) {\n    const subdirs = await getSubdirectories(normalizedBasePath, true);\n    for (const subdir of subdirs) {\n      addWatcher(subdir);\n    }\n  }\n\n  // Return a function to close all watchers\n  return () => {\n    watchers.forEach(watcher => watcher.close());\n  };\n}\n\n/**\n * Gets detailed directory statistics including file count, directory count, and size.\n *\n * @param {string} dirPath - Path to the directory.\n * @returns {Promise<{ fileCount: number, dirCount: number, totalSize: number }>} Directory statistics.\n * @throws {Error} If directory cannot be read.\n */\nexport async function getDirStats(\n  dirPath: string\n): Promise<{ fileCount: number; dirCount: number; totalSize: number }> {\n  let fileCount = 0;\n  let dirCount = 0;\n  let totalSize = 0;\n\n  async function processDir(currentPath: string): Promise<void> {\n    const entries = await fsp.readdir(currentPath, { withFileTypes: true });\n\n    for (const entry of entries) {\n      const entryPath = path.join(currentPath, entry.name);\n\n      if (entry.isDirectory()) {\n        dirCount++;\n        await processDir(entryPath);\n      } else if (entry.isFile()) {\n        fileCount++;\n        const stat = await fsp.stat(entryPath);\n        totalSize += stat.size;\n      }\n    }\n  }\n\n  await processDir(dirPath);\n\n  return { fileCount, dirCount, totalSize };\n}\n\n/**\n * Walks through a directory hierarchy, calling a visitor function for each entry.\n *\n * @param {string} dirPath - Starting directory path.\n * @param {object} options - Options for walking the directory.\n * @param {(entry: { path: string, name: string, isDirectory: boolean, stats: fs.Stats }) => boolean | void | Promise<boolean | void>} options.visitorFn -\n *   Function called for each file/directory. Return false to skip a directory.\n * @param {'pre' | 'post'} [options.traversalOrder='pre'] - Whether to visit directories before or after their contents.\n * @throws {Error} If directory cannot be read.\n */\nexport async function walkDir(\n  dirPath: string,\n  options: {\n    visitorFn: (entry: {\n      path: string;\n      name: string;\n      isDirectory: boolean;\n      stats: fs.Stats;\n    }) => boolean | void | Promise<boolean | void>;\n    traversalOrder?: 'pre' | 'post';\n  }\n): Promise<void> {\n  const traversalOrder = options.traversalOrder || 'pre';\n  const entries = await fsp.readdir(dirPath, { withFileTypes: true });\n\n  for (const entry of entries) {\n    const entryPath = path.join(dirPath, entry.name);\n    const stats = await fsp.stat(entryPath);\n    const entryInfo = {\n      path: entryPath,\n      name: entry.name,\n      isDirectory: entry.isDirectory(),\n      stats\n    };\n\n    if (entry.isDirectory()) {\n      // Pre-order: visit directory before its contents\n      if (traversalOrder === 'pre') {\n        const shouldContinue = await options.visitorFn(entryInfo);\n        // If the visitor returns false, don't recurse into this directory\n        if (shouldContinue !== false) {\n          await walkDir(entryPath, options);\n        }\n      } else {\n        // Post-order: visit directory after its contents\n        await walkDir(entryPath, options);\n        await options.visitorFn(entryInfo);\n      }\n    } else {\n      // Files are always visited when encountered\n      await options.visitorFn(entryInfo);\n    }\n  }\n\n  if (traversalOrder === 'post') {\n    // Only visit the root if this is the top-level call (not for subdirectories)\n    // But since this function is always called recursively, always visit after children\n    const stats = await fsp.stat(dirPath);\n    const entryInfo = {\n      path: dirPath,\n      name: path.basename(dirPath),\n      isDirectory: true,\n      stats\n    };\n    await options.visitorFn(entryInfo);\n  }\n}\n"]}

package/build/esm/utils/env.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"env.utils.js","sourceRoot":"","sources":["../../../src/utils/env.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 n/no-process-env */\nimport { existsSync, readFileSync } from 'fs';\nimport { isAbsolute, resolve } from 'path';\n\n/**\n * Enum representing valid application environments.\n */\nexport enum Environment {\n  PRODUCTION = 'production',\n  DEVELOPMENT = 'development',\n  STAGING = 'staging',\n  TESTING = 'testing'\n}\n\n/**\n * Options for validating URL environment variables\n */\nexport interface UrlOptions {\n  /** List of allowed protocols (e.g., ['http', 'https']) */\n  protocols?: string[];\n  /** Whether a top-level domain is required (default: true) */\n  requireTld?: boolean;\n  /** Whether to allow IP addresses (default: true) */\n  allowIp?: boolean;\n  /** Whether to allow localhost (default: true) */\n  allowLocalhost?: boolean;\n}\n\n/**\n * Options for validating path environment variables\n */\nexport interface PathOptions {\n  /** Whether the path must exist on the filesystem (default: false) */\n  mustExist?: boolean;\n  /** Whether to convert relative paths to absolute (default: true) */\n  makeAbsolute?: boolean;\n  /** List of allowed file extensions */\n  allowedExtensions?: string[];\n}\n\n/**\n * Utility class for accessing and managing environment variables.\n * Provides typed getters with fallback defaults and validation.\n */\nexport class Env {\n  // Cache for parsed values to avoid repeated parsing of complex values\n  private static cache: Map<string, any> = new Map();\n\n  /**\n   * Checks if the current NODE_ENV is 'development'.\n   *\n   * @returns {boolean} `true` if NODE_ENV is 'development', else `false`.\n   */\n  static isDev(): boolean {\n    return Env.get('NODE_ENV', Environment.DEVELOPMENT) === Environment.DEVELOPMENT;\n  }\n\n  /**\n   * Checks if the current NODE_ENV is 'production'.\n   *\n   * @returns {boolean} `true` if NODE_ENV is 'production', else `false`.\n   */\n  static isProd(): boolean {\n    return Env.get('NODE_ENV', Environment.DEVELOPMENT) === Environment.PRODUCTION;\n  }\n\n  /**\n   * Checks if the current NODE_ENV is 'testing'.\n   *\n   * @returns {boolean} `true` if NODE_ENV is 'testing', else `false`.\n   */\n  static isTest(): boolean {\n    return Env.get('NODE_ENV', Environment.DEVELOPMENT) === Environment.TESTING;\n  }\n\n  /**\n   * Checks if the current NODE_ENV is 'staging'.\n   *\n   * @returns {boolean} `true` if NODE_ENV is 'staging', else `false`.\n   */\n  static isStaging(): boolean {\n    return Env.get('NODE_ENV', Environment.DEVELOPMENT) === Environment.STAGING;\n  }\n\n  /**\n   * Sets an environment variable (only affects runtime memory).\n   *\n   * @param {string} key - The environment variable key.\n   * @param {string} value - The value to set.\n   */\n  static set(key: string, value: string): void {\n    process.env[key] = value;\n\n    // Clear all cached values for this key with any prefix\n    this.cache.delete(key);\n    for (const cacheKey of [...this.cache.keys()]) {\n      if (cacheKey.includes(`:${key}`)) {\n        this.cache.delete(cacheKey);\n      }\n    }\n  }\n\n  /**\n   * Returns all environment variables as an object.\n   *\n   * @returns {object} The current `process.env` object.\n   */\n  static getAll(): object {\n    return process.env;\n  }\n\n  /**\n   * Retrieves a string environment variable with a fallback default.\n   * Supports variable expansion with ${VAR_NAME} syntax.\n   *\n   * @param {string} key - The environment variable key.\n   * @param {string} [defaultValue] - Value to return if the key is missing.\n   * @returns {string} The env value or the fallback.\n   *\n   * @example\n   * // If DATABASE_URL is \"postgres://localhost:5432/${DB_NAME}\"\n   * // and DB_NAME is \"myapp\"\n   * const url = Env.get('DATABASE_URL', ''); // \"postgres://localhost:5432/myapp\"\n   */\n  static get(key: string, defaultValue: string): string {\n    let value = process.env[key] ?? defaultValue;\n\n    // Expand ${VAR} references\n    if (value && value.includes('${')) {\n      value = value.replace(/\\${([A-Za-z0-9_]+)}/g, (_, varName) => {\n        return process.env[varName] ?? '';\n      });\n    }\n\n    return value;\n  }\n\n  /**\n   * Retrieves a string environment variable and throws if it's missing.\n   *\n   * @param {string} key - The environment variable key.\n   * @returns {string} The environment variable's value.\n   * @throws {Error} If the variable is not defined.\n   */\n  static getRequired(key: string): string {\n    const value = process.env[key];\n    if (value === undefined) {\n      throw new Error(`Required environment variable '${key}' is missing`);\n    }\n    return Env.get(key, ''); // Use get to handle variable expansion\n  }\n\n  /**\n   * Retrieves a value using a default generating function if the key doesn't exist.\n   * Useful for expensive default calculations.\n   *\n   * @param {string} key - The environment variable key.\n   * @param {() => string} defaultFn - Function that generates default value.\n   * @returns {string} The environment value or generated default.\n   *\n   * @example\n   * const hostname = Env.getWithDefault('HOSTNAME', () => {\n   *   // Only called if HOSTNAME is not set\n   *   return require('os').hostname();\n   * });\n   */\n  static getWithDefault(key: string, defaultFn: () => string): string {\n    if (Env.has(key)) {\n      return Env.get(key, '');\n    }\n    return defaultFn();\n  }\n\n  /**\n   * Retrieves an environment variable as a number, or returns a default.\n   *\n   * @param {string} key - The environment variable key.\n   * @param {number} defaultValue - Fallback number if key is not present.\n   * @returns {number} Parsed numeric value or default.\n   * @throws {Error} If the value is not a valid number.\n   */\n  static getNumber(key: string, defaultValue: number): number {\n    if (this.cache.has(`number:${key}`)) {\n      return this.cache.get(`number:${key}`);\n    }\n\n    const value = process.env[key];\n    if (value === undefined) {\n      return defaultValue;\n    }\n\n    const numberValue = Number(value);\n    if (isNaN(numberValue)) {\n      throw new Error(`Environment variable '${key}' is not a valid number, got: \"${value}\"`);\n    }\n\n    this.cache.set(`number:${key}`, numberValue);\n    return numberValue;\n  }\n\n  /**\n   * Retrieves a required environment variable as a number.\n   *\n   * @param {string} key - The environment variable key.\n   * @returns {number} Parsed number.\n   * @throws {Error} If the value is missing or not a number.\n   */\n  static getNumberRequired(key: string): number {\n    const value = process.env[key];\n    if (value === undefined) {\n      throw new Error(`Required environment variable '${key}' is missing`);\n    }\n\n    return Env.getNumber(key, 0); // The default is ignored since we know the key exists\n  }\n\n  /**\n   * Retrieves an integer environment variable and validates it.\n   *\n   * @param {string} key - The environment variable key.\n   * @param {number} defaultValue - Fallback number if key is not present.\n   * @param {object} [options] - Validation options.\n   * @param {number} [options.min] - Minimum allowed value.\n   * @param {number} [options.max] - Maximum allowed value.\n   * @returns {number} The parsed integer.\n   *\n   * @example\n   * // Require PORT to be between 1000 and 9999\n   * const port = Env.getInteger('PORT', 3000, { min: 1000, max: 9999 });\n   */\n  static getInteger(key: string, defaultValue: number, options: { min?: number; max?: number } = {}): number {\n    const num = Env.getNumber(key, defaultValue);\n    const intValue = Math.floor(num);\n\n    if (intValue !== num) {\n      throw new Error(`Environment variable '${key}' must be an integer, got: ${num}`);\n    }\n\n    if (options.min !== undefined && intValue < options.min) {\n      throw new Error(`Environment variable '${key}' must be at least ${options.min}, got: ${intValue}`);\n    }\n\n    if (options.max !== undefined && intValue > options.max) {\n      throw new Error(`Environment variable '${key}' must be at most ${options.max}, got: ${intValue}`);\n    }\n\n    return intValue;\n  }\n\n  /**\n   * Retrieves an environment variable as a boolean.\n   * Accepts `true`, `1`, `yes`, `on` as true; `false`, `0`, `no`, `off` as false.\n   *\n   * @param {string} key - The environment variable key.\n   * @param {boolean} [defaultValue=false] - Optional fallback value if key is missing.\n   * @returns {boolean} Parsed boolean.\n   * @throws {Error} If the value is not a recognized boolean string.\n   *\n   * @example\n   * // If DEBUG=yes\n   * const isDebug = Env.getBoolean('DEBUG', false); // true\n   */\n  static getBoolean(key: string, defaultValue = false): boolean {\n    if (this.cache.has(`bool:${key}`)) {\n      return this.cache.get(`bool:${key}`);\n    }\n\n    const value = process.env[key];\n    if (value === undefined) {\n      return defaultValue;\n    }\n\n    const lowerValue = value.toLowerCase();\n    if (['true', '1', 'yes', 'on'].includes(lowerValue)) {\n      this.cache.set(`bool:${key}`, true);\n      return true;\n    }\n\n    if (['false', '0', 'no', 'off'].includes(lowerValue)) {\n      this.cache.set(`bool:${key}`, false);\n      return false;\n    }\n\n    throw new Error(\n      `Environment variable '${key}' is not a valid boolean, got: \"${value}\". Use true/false, yes/no, 1/0, or on/off.`\n    );\n  }\n\n  /**\n   * Retrieves a required environment variable as a boolean.\n   *\n   * @param {string} key - The environment variable key.\n   * @returns {boolean} Parsed boolean value.\n   * @throws {Error} If missing or invalid.\n   */\n  static getBooleanRequired(key: string): boolean {\n    const value = process.env[key];\n    if (value === undefined) {\n      throw new Error(`Required environment variable '${key}' is missing`);\n    }\n    return Env.getBoolean(key);\n  }\n\n  /**\n   * Parses a stringified JSON object from an environment variable.\n   *\n   * @typeParam T - The type to parse as (defaults to `object`).\n   * @param {string} key - The environment variable key.\n   * @param {T} defaultValue - Value to return if key is missing.\n   * @returns {T} Parsed object or default.\n   * @throws {Error} If the value is not valid JSON.\n   *\n   * @example\n   * // If CONFIG='{\"debug\":true,\"api\":{\"url\":\"https://api.example.com\"}}'\n   * const config = Env.getJSON('CONFIG', { debug: false });\n   * // { debug: true, api: { url: \"https://api.example.com\" }}\n   */\n  static getJSON<T extends object = object>(key: string, defaultValue: T): T {\n    if (this.cache.has(`json:${key}`)) {\n      return this.cache.get(`json:${key}`);\n    }\n\n    const v = process.env[key];\n    if (v === undefined) {\n      return defaultValue;\n    }\n\n    try {\n      const parsed = JSON.parse(v);\n      this.cache.set(`json:${key}`, parsed);\n      return parsed;\n    } catch (error) {\n      throw new Error(`Environment variable '${key}' is not valid JSON: ${(error as Error).message}`);\n    }\n  }\n\n  /**\n   * Parses a comma-separated string as an array.\n   *\n   * @typeParam T - The item type (optional, defaults to string).\n   * @param {string} key - The environment variable key.\n   * @param {T[]} [defaultValue=[]] - Array to return if value is empty or missing.\n   * @param {string} [splitter=','] - Delimiter to split on.\n   * @param {(item: string) => T} [transform] - Optional function to transform each item.\n   * @returns {T[]} An array of items.\n   *\n   * @example\n   * // If ALLOWED_IPS=127.0.0.1,192.168.1.1,10.0.0.1\n   * const ips = Env.getArray('ALLOWED_IPS');\n   * // [\"127.0.0.1\", \"192.168.1.1\", \"10.0.0.1\"]\n   *\n   * // With transformation function\n   * const ports = Env.getArray('PORTS', [], ',', (p) => parseInt(p, 10));\n   */\n  static getArray<T = string>(\n    key: string,\n    defaultValue: T[] = [] as unknown as T[],\n    splitter = ',',\n    transform?: (item: string) => T\n  ): T[] {\n    const cacheKey = `array:${key}:${splitter}:${transform ? 'transformed' : 'raw'}`;\n    if (this.cache.has(cacheKey)) {\n      return this.cache.get(cacheKey);\n    }\n\n    const value = process.env[key];\n    if (!value || value.trim() === '') {\n      return defaultValue;\n    }\n\n    const items = value\n      .split(splitter)\n      .map(item => item.trim())\n      .filter(item => item.length > 0);\n\n    if (transform) {\n      try {\n        const result = items.map(transform);\n        this.cache.set(cacheKey, result);\n        return result;\n      } catch (error) {\n        throw new Error(`Failed to transform items in '${key}': ${(error as Error).message}`);\n      }\n    }\n\n    const result = items as unknown as T[];\n    this.cache.set(cacheKey, result);\n    return result;\n  }\n\n  /**\n   * Parses a comma-separated list of numbers.\n   *\n   * @param {string} key - The environment variable key.\n   * @param {number[]} [defaultValue=[]] - Default value if not present.\n   * @param {string} [splitter=','] - Delimiter to split on.\n   * @returns {number[]} Array of parsed numbers.\n   *\n   * @example\n   * // If ALLOWED_PORTS=80,443,3000,8080\n   * const ports = Env.getNumberArray('ALLOWED_PORTS');\n   * // [80, 443, 3000, 8080]\n   */\n  static getNumberArray(key: string, defaultValue: number[] = [], splitter = ','): number[] {\n    return Env.getArray(key, defaultValue, splitter, item => {\n      const num = Number(item);\n      if (isNaN(num)) {\n        throw new Error(`Value \"${item}\" in array '${key}' is not a valid number`);\n      }\n      return num;\n    });\n  }\n\n  /**\n   * Retrieves an enum-like environment variable value, validating against allowed values.\n   *\n   * @typeParam T - The allowed value type (string literal types).\n   * @param {string} key - The environment variable key.\n   * @param {T[]} allowedValues - Array of accepted string values.\n   * @param {T} [defaultValue] - Optional fallback value.\n   * @returns {T} The validated environment value.\n   * @throws {Error} If missing or invalid.\n   *\n   * @example\n   * // If LOG_LEVEL=debug\n   * const level = Env.getEnum('LOG_LEVEL', ['debug', 'info', 'warn', 'error'] as const, 'info');\n   * // 'debug' (typed as 'debug' | 'info' | 'warn' | 'error')\n   */\n  static getEnum<T extends string>(key: string, allowedValues: readonly T[], defaultValue: T): T {\n    const value = process.env[key];\n\n    if (!value) {\n      return defaultValue;\n    }\n\n    if (!allowedValues.includes(value as T)) {\n      throw new Error(\n        `Environment variable '${key}' must be one of: ${allowedValues.join(', ')}. Received: \"${value}\"`\n      );\n    }\n\n    return value as T;\n  }\n\n  /**\n   * Retrieves an enum-like numeric environment variable.\n   *\n   * @param {string} key - The environment variable key.\n   * @param {number[]} allowedValues - Array of accepted values.\n   * @param {number} defaultValue - Default value if not present.\n   * @returns {number} The validated value.\n   *\n   * @example\n   * // If NODE_VERSION=16\n   * const version = Env.getNumberEnum('NODE_VERSION', [14, 16, 18], 16);\n   */\n  static getNumberEnum(key: string, allowedValues: number[], defaultValue: number): number {\n    const value = Env.getNumber(key, defaultValue);\n\n    if (!allowedValues.includes(value)) {\n      throw new Error(`Environment variable '${key}' must be one of: ${allowedValues.join(', ')}. Received: ${value}`);\n    }\n\n    return value;\n  }\n\n  /**\n   * Retrieves a URL environment variable and validates it.\n   *\n   * @param {string} key - The environment variable key.\n   * @param {string} [defaultValue] - Optional fallback value.\n   * @param {UrlOptions} [options] - Validation options.\n   * @returns {string} The validated URL.\n   * @throws {Error} If URL is invalid.\n   *\n   * @example\n   * // Validate API URL requires HTTPS\n   * const apiUrl = Env.getUrl('API_URL', 'https://api.example.com', {\n   *   protocols: ['https'],\n   *   requireTld: true,\n   *   allowIp: false\n   * });\n   */\n  static getUrl(key: string, defaultValue: string, options: UrlOptions = {}): string {\n    const cacheKey = `url:${key}:${JSON.stringify(options)}`;\n    if (this.cache.has(cacheKey)) {\n      return this.cache.get(cacheKey);\n    }\n\n    const value = Env.get(key, defaultValue);\n    if (!value) {\n      throw new Error(`URL environment variable '${key}' is missing or empty`);\n    }\n\n    let url: URL;\n    try {\n      url = new URL(value);\n    } catch {\n      throw new Error(`Environment variable '${key}' is not a valid URL: \"${value}\"`);\n    }\n\n    // Validate protocol\n    if (options.protocols && options.protocols.length > 0) {\n      const protocol = url.protocol.replace(':', '');\n      if (!options.protocols.includes(protocol)) {\n        throw new Error(\n          `Environment variable '${key}' must use one of the protocols: ${options.protocols.join(', ')}. Got: ${protocol}`\n        );\n      }\n    }\n\n    // Validate hostname\n    const { hostname } = url;\n    const isIp = /^(?:[0-9]{1,3}\\.){3}[0-9]{1,3}$/.test(hostname);\n    const isLocalhost = hostname === 'localhost';\n\n    // Check if hostname is an IP address when not allowed\n    if (isIp && options.allowIp === false) {\n      throw new Error(`Environment variable '${key}' cannot be an IP address: \"${hostname}\"`);\n    }\n\n    // Check if hostname is localhost when not allowed\n    if (isLocalhost && options.allowLocalhost === false) {\n      throw new Error(`Environment variable '${key}' cannot be localhost`);\n    }\n\n    // Check for TLD requirement - include localhost in check if requireTld is true and allowLocalhost is false\n    if (options.requireTld === true) {\n      if (isLocalhost && options.allowLocalhost !== false) {\n        // Localhost is allowed, so no TLD check needed for it\n      } else if (isIp && options.allowIp !== false) {\n        // IP is allowed, so no TLD check needed for it\n      } else if (!hostname.includes('.') || hostname.endsWith('.')) {\n        throw new Error(`Environment variable '${key}' must have a valid host with TLD: \"${hostname}\"`);\n      }\n    }\n\n    this.cache.set(cacheKey, value);\n    return value;\n  }\n\n  /**\n   * Retrieves an email environment variable and validates it.\n   *\n   * @param {string} key - The environment variable key.\n   * @param {string} [defaultValue] - Optional fallback value.\n   * @returns {string} The validated email address.\n   * @throws {Error} If email is invalid.\n   *\n   * @example\n   * const supportEmail = Env.getEmail('SUPPORT_EMAIL', 'support@example.com');\n   */\n  static getEmail(key: string, defaultValue: string): string {\n    if (this.cache.has(`email:${key}`)) {\n      return this.cache.get(`email:${key}`);\n    }\n\n    const value = Env.get(key, defaultValue);\n    if (!value) {\n      if (defaultValue === undefined) {\n        throw new Error(`Email environment variable '${key}' is missing`);\n      }\n      return defaultValue;\n    }\n\n    // More comprehensive email validation regex\n    const emailRegex =\n      /^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/;\n\n    if (!emailRegex.test(value)) {\n      throw new Error(`Environment variable '${key}' is not a valid email address: \"${value}\"`);\n    }\n\n    this.cache.set(`email:${key}`, value);\n    return value;\n  }\n\n  /**\n   * Retrieves a path environment variable and validates it exists.\n   *\n   * @param {string} key - The environment variable key.\n   * @param {string} [defaultValue] - Optional fallback value.\n   * @param {PathOptions} [options] - Validation options.\n   * @returns {string} The validated path.\n   * @throws {Error} If path is invalid.\n   *\n   * @example\n   * // Require that the path exists and is a .json file\n   * const configPath = Env.getPath('CONFIG_PATH', './config.json', {\n   *   mustExist: true,\n   *   allowedExtensions: ['.json', '.yaml']\n   * });\n   */\n  static getPath(key: string, defaultValue: string, options: PathOptions = {}): string {\n    const cacheKey = `path:${key}:${JSON.stringify(options)}`;\n    if (this.cache.has(cacheKey)) {\n      return this.cache.get(cacheKey);\n    }\n\n    const value = Env.get(key, defaultValue);\n    if (!value) {\n      if (defaultValue === undefined) {\n        throw new Error(`Path environment variable '${key}' is missing`);\n      }\n      return defaultValue;\n    }\n\n    const path = options.makeAbsolute !== false && !isAbsolute(value) ? resolve(process.cwd(), value) : value;\n\n    // Validate path exists if required\n    if (options.mustExist && !existsSync(path)) {\n      throw new Error(`Path in environment variable '${key}' does not exist: \"${path}\"`);\n    }\n\n    // Validate file extension if specified\n    if (options.allowedExtensions && options.allowedExtensions.length > 0) {\n      const hasValidExtension = options.allowedExtensions.some(ext => path.toLowerCase().endsWith(ext.toLowerCase()));\n\n      if (!hasValidExtension) {\n        throw new Error(\n          `Path in environment variable '${key}' must have one of these extensions: ${options.allowedExtensions.join(\n            ', '\n          )}. Got: \"${path}\"`\n        );\n      }\n    }\n\n    this.cache.set(cacheKey, path);\n    return path;\n  }\n\n  /**\n   * Retrieves a port environment variable and validates it.\n   *\n   * @param {string} key - The environment variable key.\n   * @param {number} [defaultValue] - Optional fallback value.\n   * @returns {number} The validated port number.\n   * @throws {Error} If port is invalid.\n   *\n   * @example\n   * const serverPort = Env.getPort('PORT', 3000);\n   */\n  static getPort(key: string, defaultValue: number): number {\n    try {\n      return Env.getInteger(key, defaultValue, { min: 0, max: 65535 });\n    } catch (error) {\n      // Rewrite the error message to match the expected pattern\n      if ((error as Error).message.includes('must be at most 65535')) {\n        throw new Error(`Environment variable '${key}' must be a valid port number (0-65535)`);\n      }\n      throw error;\n    }\n  }\n\n  /**\n   * Retrieves an ISO date string and converts it to a Date object.\n   *\n   * @param {string} key - The environment variable key.\n   * @param {string|Date} [defaultValue] - Optional fallback value.\n   * @returns {Date} The parsed Date object.\n   *\n   * @example\n   * // If EXPIRY_DATE=2023-12-31T23:59:59Z\n   * const expiryDate = Env.getDate('EXPIRY_DATE', new Date());\n   */\n  static getDate(key: string, defaultValue: string | Date = new Date()): Date {\n    const value = Env.get(key, defaultValue instanceof Date ? defaultValue.toISOString() : defaultValue);\n\n    if (!value) {\n      return defaultValue instanceof Date ? defaultValue : new Date();\n    }\n\n    const date = new Date(value);\n    if (isNaN(date.getTime())) {\n      throw new Error(`Environment variable '${key}' is not a valid date: \"${value}\"`);\n    }\n\n    return date;\n  }\n\n  /**\n   * Retrieves a duration string and converts it to milliseconds.\n   * Supports formats like \"1d\", \"2h\", \"30m\", \"45s\", \"100ms\" or combinations like \"1h30m\".\n   *\n   * @param {string} key - The environment variable key.\n   * @param {string|number} [defaultValue='0'] - Optional fallback value.\n   * @returns {number} The duration in milliseconds.\n   * @throws {Error} If duration format is invalid.\n   *\n   * @example\n   * // If CACHE_TTL=2h30m\n   * const cacheTtlMs = Env.getDuration('CACHE_TTL', '1h');\n   * // 9000000 (2.5 hours in milliseconds)\n   */\n  static getDuration(key: string, defaultValue: string | number = '0'): number {\n    const cacheKey = `duration:${key}`;\n    if (this.cache.has(cacheKey)) {\n      return this.cache.get(cacheKey);\n    }\n\n    const value = Env.get(key, String(defaultValue));\n    if (!value) return 0;\n\n    // Handle plain number input (assume milliseconds)\n    if (/^\\d+$/.test(value)) {\n      const ms = parseInt(value, 10);\n      this.cache.set(cacheKey, ms);\n      return ms;\n    }\n\n    // Enhanced duration parsing with more precise regex\n    const durationRegex = /^(?:(\\d+)y)?(?:(\\d+)w)?(?:(\\d+)d)?(?:(\\d+)h)?(?:(\\d+)m)?(?:(\\d+)s)?(?:(\\d+)ms)?$/;\n    const matches = value.match(durationRegex);\n\n    if (!matches || matches[0] === '') {\n      throw new Error(\n        `Environment variable '${key}' has invalid duration format: \"${value}\". ` +\n          `Use formats like 1y, 2w, 3d, 4h, 5m, 6s, or 7ms.`\n      );\n    }\n\n    let ms = 0;\n\n    if (matches[1]) ms += parseInt(matches[1], 10) * 31536000000; // years (approximate)\n    if (matches[2]) ms += parseInt(matches[2], 10) * 604800000; // weeks\n    if (matches[3]) ms += parseInt(matches[3], 10) * 86400000; // days\n    if (matches[4]) ms += parseInt(matches[4], 10) * 3600000; // hours\n    if (matches[5]) ms += parseInt(matches[5], 10) * 60000; // minutes\n    if (matches[6]) ms += parseInt(matches[6], 10) * 1000; // seconds\n    if (matches[7]) ms += parseInt(matches[7], 10); // milliseconds\n\n    this.cache.set(cacheKey, ms);\n    return ms;\n  }\n\n  /**\n   * Gets all environment variables with sensitive values masked for safe logging.\n   *\n   * @param {string[]} [sensitiveKeys=['password', 'secret', 'key', 'token', 'auth']] - Keys to mask.\n   * @returns {Record<string, string>} Environment variables with sensitive values masked.\n   *\n   * @example\n   * console.log(Env.getSafeEnv(['password', 'secret', 'key']));\n   * // { DATABASE_URL: \"postgres://...\", API_KEY: \"******\", ... }\n   */\n  static getSafeEnv(sensitiveKeys: string[] = ['password', 'secret', 'key', 'token', 'auth']): Record<string, string> {\n    const safeEnv: Record<string, string> = {};\n\n    for (const [key, value] of Object.entries(process.env)) {\n      if (!value) continue;\n\n      const isSensitive = sensitiveKeys.some(sensitiveKey => key.toLowerCase().includes(sensitiveKey.toLowerCase()));\n      safeEnv[key] = isSensitive ? '******' : value;\n    }\n\n    return safeEnv;\n  }\n\n  /**\n   * Loads environment variables from a .env file.\n   * Does not override existing variables.\n   *\n   * @param {string} [path='.env'] - Path to the .env file.\n   * @returns {Record<string, string>} Loaded environment variables.\n   *\n   * @example\n   * // Load variables from .env.development\n   * Env.loadFromFile('.env.development');\n   */\n  static loadFromFile(path: string = '.env'): Record<string, string> {\n    if (!existsSync(path)) {\n      throw new Error(`Environment file not found: \"${path}\"`);\n    }\n\n    const content = readFileSync(path, 'utf8');\n    const variables: Record<string, string> = {};\n    const lines = content.split(/\\r?\\n/);\n\n    let i = 0;\n    while (i < lines.length) {\n      let line = lines[i].trim();\n\n      // Skip empty lines or comment-only lines\n      if (!line || line.startsWith('#')) {\n        i++;\n        continue;\n      }\n\n      const match = line.match(/^([^=]+)=(.*)$/);\n      if (!match) {\n        i++;\n        continue;\n      }\n\n      const key = match[1].trim();\n      let value = match[2].trim();\n\n      // Remove inline comment for unquoted values\n      if (!/^['\"]/.test(value)) {\n        const hashIndex = value.indexOf(' #');\n        if (hashIndex !== -1) {\n          value = value.slice(0, hashIndex).trim();\n        }\n      }\n\n      // Handle quoted values\n      if ((value.startsWith('\"') || value.startsWith(\"'\")) && value.length > 1) {\n        const quote = value[0];\n        if (!value.endsWith(quote) || value.length === 1) {\n          // multiline quoted\n          let multilineValue = value.slice(1);\n          i++;\n          while (i < lines.length) {\n            const nextLine = lines[i];\n            if (nextLine.endsWith(quote)) {\n              multilineValue += '\\n' + nextLine.slice(0, -1);\n              break;\n            } else {\n              multilineValue += '\\n' + nextLine;\n            }\n            i++;\n          }\n          value = multilineValue;\n        } else {\n          // single-line quoted\n          value = value.slice(1, -1);\n        }\n      } else {\n        // Handle unquoted multiline: continue collecting until next key=value or empty line\n        i++;\n        while (i < lines.length && !lines[i].includes('=') && lines[i].trim() !== '') {\n          value += '\\n' + lines[i];\n          i++;\n        }\n        i--; // adjust for outer loop\n      }\n\n      if (!process.env[key]) {\n        process.env[key] = value;\n        variables[key] = value;\n      }\n\n      i++;\n    }\n\n    return variables;\n  }\n\n  /**\n   * Checks whether the specified environment variable exists.\n   *\n   * @param {string} key - The environment variable key.\n   * @returns {boolean} `true` if the variable is defined, otherwise `false`.\n   */\n  static has(key: string): boolean {\n    return process.env[key] !== undefined;\n  }\n\n  /**\n   * Deletes the given environment variable (useful in tests).\n   *\n   * @param {string} key - The environment variable key to delete.\n   * @returns {void}\n   */\n  static delete(key: string): void {\n    delete process.env[key];\n    this.cache.delete(key);\n\n    // Also clear all cached variations of this key\n    for (const cacheKey of this.cache.keys()) {\n      if (cacheKey.includes(`:${key}`)) {\n        this.cache.delete(cacheKey);\n      }\n    }\n  }\n\n  /**\n   * Clears the internal cache of parsed environment values.\n   * Useful for testing or when environment variables might change.\n   */\n  static clearCache(): void {\n    this.cache.clear();\n  }\n}\n"]}

package/build/esm/utils/exception.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"exception.utils.js","sourceRoot":"","sources":["../../../src/utils/exception.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\nimport { HttpStatusCodes } from './http-status-codes';\nimport { getLogger } from './logger.utils';\nimport { ErrorResponse } from './response.utils';\n\n/**\n * Generic HTTP error class used for custom exceptions with any status code.\n * Inherit this when you need to throw errors dynamically at runtime.\n */\nexport class HttpError extends ErrorResponse {\n  /**\n   * Creates a new HTTP error instance.\n   * @param status - A valid HTTP status code (e.g., 400, 500).\n   * @param message - The error message to return to the client.\n   */\n  constructor(status: number, message: string) {\n    super(message);\n    this.status = status;\n  }\n}\n\n/**\n * Represents a 500 Internal Server Error.\n * Use this for unexpected backend errors that are not caused by the client.\n */\nexport class InternalServerErrorException extends ErrorResponse {\n  /**\n   * @param message - Optional custom message. Defaults to \"Internal server error\".\n   */\n  constructor(message: string = 'Internal server error') {\n    super(message);\n    this.status = HttpStatusCodes.INTERNAL_SERVER_ERROR;\n  }\n}\n\n/**\n * Represents a 401 Unauthorized Error.\n * Indicates that authentication is required and has failed or not been provided.\n */\nexport class UnauthorizedException extends ErrorResponse {\n  /**\n   * @param message - Optional custom message. Defaults to \"Unauthorized\".\n   */\n  constructor(message: string = 'Unauthorized') {\n    super(message);\n    this.status = HttpStatusCodes.UNAUTHORIZED;\n  }\n}\n\n/**\n * Represents a 400 Bad Request Error.\n * Indicates that the client has sent invalid data (e.g., malformed request body).\n */\nexport class BadRequestException extends ErrorResponse {\n  /**\n   * @param message - Optional custom message. Defaults to \"Bad request\".\n   */\n  constructor(message: string = 'Bad request') {\n    super(message);\n    this.status = HttpStatusCodes.BAD_REQUEST;\n  }\n}\n\n/**\n * Represents a 404 Not Found Error.\n * Used when a requested resource (e.g., user, file) could not be located.\n */\nexport class NotFoundException extends ErrorResponse {\n  /**\n   * @param message - Optional custom message. Defaults to \"Resource not found\".\n   */\n  constructor(message: string = 'Resource not found') {\n    super(message);\n    this.status = HttpStatusCodes.NOT_FOUND;\n  }\n}\n\n/**\n * Represents a 403 Forbidden Error.\n * Indicates that the client is authenticated but not allowed to access the resource.\n */\nexport class ForbiddenException extends ErrorResponse {\n  /**\n   * @param message - Optional custom message. Defaults to \"Forbidden\".\n   */\n  constructor(message: string = 'Forbidden') {\n    super(message);\n    this.status = HttpStatusCodes.FORBIDDEN;\n  }\n}\n\n/**\n * Represents a 409 Conflict Error.\n * Commonly used when a resource already exists or a versioning conflict occurs.\n */\nexport class ConflictException extends ErrorResponse {\n  /**\n   * @param message - Optional custom message. Defaults to \"Conflict\".\n   */\n  constructor(message: string = 'Conflict') {\n    super(message);\n    this.status = HttpStatusCodes.CONFLICT;\n  }\n}\n\n/**\n * Represents a 502 Bad Gateway Error.\n * Used when the server receives an invalid response from an upstream server.\n */\nexport class BadGatewayException extends ErrorResponse {\n  /**\n   * @param message - Optional custom message. Defaults to \"Bad Gateway\".\n   */\n  constructor(message: string = 'Bad Gateway') {\n    super(message);\n    this.status = HttpStatusCodes.BAD_GATEWAY;\n  }\n}\n\n/**\n * Represents a 429 Too Many Requests Error.\n * Returned when the client has hit a rate limit.\n */\nexport class TooManyRequestsException extends ErrorResponse {\n  /**\n   * @param message - Optional custom message. Defaults to \"Too many requests\".\n   */\n  constructor(message: string = 'Too many requests') {\n    super(message);\n    this.status = HttpStatusCodes.TOO_MANY_REQUESTS;\n  }\n}\n\n/**\n * Represents a 503 Service Unavailable Error.\n * Indicates that the server is temporarily unavailable (e.g., for maintenance).\n */\nexport class ServiceUnavailableException extends ErrorResponse {\n  /**\n   * @param message - Optional custom message. Defaults to \"Service Unavailable\".\n   */\n  constructor(message: string = 'Service Unavailable') {\n    super(message);\n    this.status = HttpStatusCodes.SERVICE_UNAVAILABLE;\n  }\n}\n\n/**\n * Represents a 504 Gateway Timeout Error.\n * Returned when the server acting as a gateway times out waiting for a response.\n */\nexport class GatewayTimeoutException extends ErrorResponse {\n  /**\n   * @param message - Optional custom message. Defaults to \"Gateway Timeout\".\n   */\n  constructor(message: string = 'Gateway Timeout') {\n    super(message);\n    this.status = HttpStatusCodes.GATEWAY_TIMEOUT;\n  }\n}\n\n/**\n * Represents a 422 Unprocessable Entity Error.\n * Used when the server understands the content type but cannot process the contained instructions.\n */\nexport class UnprocessableEntityException extends ErrorResponse {\n  /**\n   * @param message - Optional custom message. Defaults to \"Unprocessable Entity\".\n   * @param details - Optional validation details or additional error context.\n   */\n  constructor(\n    message: string = 'Unprocessable Entity',\n    public details?: Record<string, any>\n  ) {\n    super(message);\n    this.status = HttpStatusCodes.UNPROCESSABLE_ENTITY;\n  }\n}\n\n/**\n * Represents a 405 Method Not Allowed Error.\n * Used when the request method is not supported for the requested resource.\n */\nexport class MethodNotAllowedException extends ErrorResponse {\n  /**\n   * @param message - Optional custom message. Defaults to \"Method Not Allowed\".\n   * @param allowedMethods - Optional array of allowed HTTP methods.\n   */\n  constructor(\n    message: string = 'Method Not Allowed',\n    public allowedMethods?: string[]\n  ) {\n    super(message);\n    this.status = HttpStatusCodes.METHOD_NOT_ALLOWED;\n  }\n}\n\n/**\n * Represents a 406 Not Acceptable Error.\n * Used when the server cannot produce a response matching the client's accepted content types.\n */\nexport class NotAcceptableException extends ErrorResponse {\n  /**\n   * @param message - Optional custom message. Defaults to \"Not Acceptable\".\n   */\n  constructor(message: string = 'Not Acceptable') {\n    super(message);\n    this.status = HttpStatusCodes.NOT_ACCEPTABLE;\n  }\n}\n\n/**\n * Represents a 408 Request Timeout Error.\n * Used when the server times out waiting for the client to send a request.\n */\nexport class RequestTimeoutException extends ErrorResponse {\n  /**\n   * @param message - Optional custom message. Defaults to \"Request Timeout\".\n   */\n  constructor(message: string = 'Request Timeout') {\n    super(message);\n    this.status = HttpStatusCodes.REQUEST_TIMEOUT;\n  }\n}\n\n/**\n * Represents a 415 Unsupported Media Type Error.\n * Used when the request's Content-Type is not supported.\n */\nexport class UnsupportedMediaTypeException extends ErrorResponse {\n  /**\n   * @param message - Optional custom message. Defaults to \"Unsupported Media Type\".\n   */\n  constructor(message: string = 'Unsupported Media Type') {\n    super(message);\n    this.status = HttpStatusCodes.UNSUPPORTED_MEDIA_TYPE;\n  }\n}\n\n/**\n * Represents a 413 Payload Too Large Error.\n * Used when the request body exceeds server limits.\n */\nexport class PayloadTooLargeException extends ErrorResponse {\n  /**\n   * @param message - Optional custom message. Defaults to \"Payload Too Large\".\n   */\n  constructor(message: string = 'Payload Too Large') {\n    super(message);\n    this.status = HttpStatusCodes.PAYLOAD_TOO_LARGE;\n  }\n}\n\n/**\n * Represents a 507 Insufficient Storage Error.\n * Used when the server has insufficient storage to complete the request.\n */\nexport class InsufficientStorageException extends ErrorResponse {\n  /**\n   * @param message - Optional custom message. Defaults to \"Insufficient Storage\".\n   */\n  constructor(message: string = 'Insufficient Storage') {\n    super(message);\n    this.status = HttpStatusCodes.INSUFFICIENT_STORAGE;\n  }\n}\n\n/**\n * Checks if an error is an instance of HttpError or its subclasses.\n *\n * @param error - The error to check.\n * @returns True if the error is an HttpError, false otherwise.\n */\nexport function isHttpError(error: unknown): error is ErrorResponse {\n  return error instanceof ErrorResponse;\n}\n\n/**\n * Creates an HTTP error with the specified status code and message.\n * Factory function for creating appropriate HTTP error instances.\n *\n * @param status - HTTP status code.\n * @param message - Optional custom error message.\n * @returns An instance of the appropriate HTTP error class.\n */\nexport function createHttpError(status: number, message?: string): ErrorResponse {\n  switch (status) {\n    case HttpStatusCodes.BAD_REQUEST:\n      return new BadRequestException(message);\n    case HttpStatusCodes.UNAUTHORIZED:\n      return new UnauthorizedException(message);\n    case HttpStatusCodes.FORBIDDEN:\n      return new ForbiddenException(message);\n    case HttpStatusCodes.NOT_FOUND:\n      return new NotFoundException(message);\n    case HttpStatusCodes.METHOD_NOT_ALLOWED:\n      return new MethodNotAllowedException(message);\n    case HttpStatusCodes.NOT_ACCEPTABLE:\n      return new NotAcceptableException(message);\n    case HttpStatusCodes.REQUEST_TIMEOUT:\n      return new RequestTimeoutException(message);\n    case HttpStatusCodes.CONFLICT:\n      return new ConflictException(message);\n    case HttpStatusCodes.GONE:\n      return new HttpError(HttpStatusCodes.GONE, message || 'Gone');\n    case HttpStatusCodes.PAYLOAD_TOO_LARGE:\n      return new PayloadTooLargeException(message);\n    case HttpStatusCodes.UNSUPPORTED_MEDIA_TYPE:\n      return new UnsupportedMediaTypeException(message);\n    case HttpStatusCodes.UNPROCESSABLE_ENTITY:\n      return new UnprocessableEntityException(message);\n    case HttpStatusCodes.TOO_MANY_REQUESTS:\n      return new TooManyRequestsException(message);\n    case HttpStatusCodes.INTERNAL_SERVER_ERROR:\n      return new InternalServerErrorException(message);\n    case HttpStatusCodes.BAD_GATEWAY:\n      return new BadGatewayException(message);\n    case HttpStatusCodes.SERVICE_UNAVAILABLE:\n      return new ServiceUnavailableException(message);\n    case HttpStatusCodes.GATEWAY_TIMEOUT:\n      return new GatewayTimeoutException(message);\n    case HttpStatusCodes.INSUFFICIENT_STORAGE:\n      return new InsufficientStorageException(message);\n    default:\n      return new HttpError(status, message || `HTTP Error ${status}`);\n  }\n}\n\n/**\n * Type guard to check if an object has specific error properties.\n *\n * @param error - The object to check.\n * @returns True if object has error-like structure.\n */\nexport function hasErrorShape(error: unknown): error is { message: string; status?: number; code?: string } {\n  return (\n    typeof error === 'object' && error !== null && 'message' in error && typeof (error as any).message === 'string'\n  );\n}\n\n/**\n * Safely extracts message from any error type.\n *\n * @param error - Any error object or value.\n * @returns A string error message.\n */\nexport function getErrorMessage(error: unknown): string {\n  if (typeof error === 'string') {\n    return error;\n  }\n\n  if (error instanceof Error) {\n    return error.message;\n  }\n\n  if (hasErrorShape(error)) {\n    return error.message;\n  }\n\n  return 'Unknown error occurred';\n}\n\n/**\n * Wraps a function and transforms any errors into HTTP errors.\n * Useful for API handlers to ensure consistent error responses.\n *\n * @param handler - The async function to wrap.\n * @returns A function that always returns or throws an HTTP error.\n */\nexport function withErrorHandling<T extends (...args: any[]) => Promise<any>>(\n  handler: T\n): (...args: Parameters<T>) => Promise<Awaited<ReturnType<T>>> {\n  return async (...args: Parameters<T>) => {\n    try {\n      return await handler(...args);\n    } catch (err) {\n      if (isHttpError(err)) {\n        throw err;\n      }\n\n      // Log the original error (consider using a proper logger)\n      getLogger().error({ err }, 'Caught error in handler');\n\n      // Extract status code if it exists, otherwise use 500\n      let status = HttpStatusCodes.INTERNAL_SERVER_ERROR;\n      if (hasErrorShape(err) && typeof err.status === 'number') {\n        status = err.status;\n      }\n\n      // Create appropriate HTTP error\n      throw createHttpError(status, getErrorMessage(err));\n    }\n  };\n}\n"]}

package/build/esm/utils/fs.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"fs.utils.js","sourceRoot":"","sources":["../../../src/utils/fs.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\nimport { BufferEncoding } from './crypto.utils';\nimport fs from 'fs/promises';\nimport { createReadStream, createWriteStream, Stats } from 'fs';\nimport { tmpdir } from 'os';\nimport path from 'path';\nimport { pipeline } from 'stream/promises';\nimport { randomUUID } from 'crypto';\n\n/**\n * Checks whether a file or directory exists at the given path.\n *\n * @param {string} path - The file or directory path to check.\n * @returns {Promise<boolean>} Resolves to `true` if the path exists, `false` otherwise.\n */\nexport async function fileExists(path: string): Promise<boolean> {\n  try {\n    await fs.access(path);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Reads and parses a JSON file from the specified path.\n *\n * @typeParam T - The expected type of the parsed JSON object.\n * @param {string} path - The path to the JSON file.\n * @returns {Promise<T | null>} The parsed object, or `null` if reading or parsing fails.\n */\nexport async function readJsonFile<T = any>(path: string): Promise<T | null> {\n  try {\n    const data = await fs.readFile(path, 'utf-8');\n    return JSON.parse(data) as T;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Writes a JavaScript object to a file as formatted JSON.\n *\n * @param {string} path - The destination file path.\n * @param {any} data - The object to serialize and write.\n * @param {number} [space=2] - Number of spaces for JSON formatting.\n * @returns {Promise<void>} Resolves when writing is complete.\n */\nexport async function writeJsonFile(path: string, data: any, space = 2): Promise<void> {\n  const json = JSON.stringify(data, null, space);\n  await fs.writeFile(path, json, 'utf-8');\n}\n\n/**\n * Deletes a file if it exists.\n *\n * @param {string} path - The file path to delete.\n * @returns {Promise<boolean>} Resolves to `true` if the file was deleted or didn't exist, `false` if deletion failed.\n */\nexport async function deleteFileIfExists(path: string): Promise<boolean> {\n  try {\n    await fs.unlink(path);\n    return true;\n  } catch (err: any) {\n    if (err.code === 'ENOENT') return true;\n    return false;\n  }\n}\n\n/**\n * Reads a text file from the specified path.\n *\n * @param {string} path - The path to the text file.\n * @param {BufferEncoding} [encoding=\"utf-8\"] - The encoding to use.\n * @returns {Promise<string | null>} The file contents, or `null` if reading fails.\n */\nexport async function readTextFile(path: string, encoding: BufferEncoding = 'utf-8'): Promise<string | null> {\n  try {\n    return await fs.readFile(path, encoding);\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Writes text content to a file.\n *\n * @param {string} path - The destination file path.\n * @param {string} content - The text content to write.\n * @param {BufferEncoding} [encoding=\"utf-8\"] - The encoding to use.\n * @returns {Promise<boolean>} Resolves to `true` if successful, `false` otherwise.\n */\nexport async function writeTextFile(\n  path: string,\n  content: string,\n  encoding: BufferEncoding = 'utf-8'\n): Promise<boolean> {\n  try {\n    await fs.writeFile(path, content, encoding);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Appends text content to a file.\n *\n * @param {string} path - The file path to append to.\n * @param {string} content - The text content to append.\n * @param {BufferEncoding} [encoding=\"utf-8\"] - The encoding to use.\n * @returns {Promise<boolean>} Resolves to `true` if successful, `false` otherwise.\n */\nexport async function appendTextFile(\n  path: string,\n  content: string,\n  encoding: BufferEncoding = 'utf-8'\n): Promise<boolean> {\n  try {\n    await fs.appendFile(path, content, encoding);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Copies a file from source to destination.\n *\n * @param {string} source - Source file path.\n * @param {string} destination - Destination file path.\n * @param {boolean} [overwrite=false] - Whether to overwrite if destination exists.\n * @returns {Promise<boolean>} Resolves to `true` if successful, `false` otherwise.\n */\nexport async function copyFile(source: string, destination: string, overwrite = false): Promise<boolean> {\n  try {\n    const flags = overwrite ? 0 : fs.constants.COPYFILE_EXCL;\n    await fs.copyFile(source, destination, flags);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Renames/moves a file.\n *\n * @param {string} oldPath - Current file path.\n * @param {string} newPath - New file path.\n * @returns {Promise<boolean>} Resolves to `true` if successful, `false` otherwise.\n */\nexport async function moveFile(oldPath: string, newPath: string): Promise<boolean> {\n  try {\n    await fs.rename(oldPath, newPath);\n    return true;\n  } catch {\n    // If rename fails (e.g., across devices), try copy+delete\n    try {\n      await fs.copyFile(oldPath, newPath);\n      await fs.unlink(oldPath);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n}\n\n/**\n * Gets file stats if the file exists.\n *\n * @param {string} path - Path to the file.\n * @returns {Promise<fs.Stats | null>} File stats object or null if file doesn't exist.\n */\nexport async function getFileStats(path: string): Promise<Stats | null> {\n  try {\n    return await fs.stat(path);\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Creates a temporary file with optional content.\n *\n * @param {object} [options] - Options for creating the temp file.\n * @param {string} [options.prefix=\"tmp-\"] - Filename prefix.\n * @param {string} [options.extension=\"\"] - File extension.\n * @param {string} [options.dir] - Directory to create the file in (defaults to OS temp dir).\n * @param {string | Buffer} [options.content] - Optional content to write to the file.\n * @returns {Promise<string>} Path to the created temporary file.\n */\nexport async function createTempFile({\n  prefix = 'tmp-',\n  extension = '',\n  dir = tmpdir(),\n  content\n}: {\n  prefix?: string;\n  extension?: string;\n  dir?: string;\n  content?: string | Buffer;\n} = {}): Promise<string> {\n  const ext = extension ? (extension.startsWith('.') ? extension : `.${extension}`) : '';\n  const filename = `${prefix}${randomUUID()}${ext}`;\n  const filepath = path.join(dir, filename);\n\n  if (content) {\n    await fs.writeFile(filepath, content);\n  } else {\n    await fs.writeFile(filepath, '');\n  }\n\n  return filepath;\n}\n\n/**\n * Streams a file from source to destination.\n * Useful for large files to avoid loading the entire file into memory.\n *\n * @param {string} source - Source file path.\n * @param {string} destination - Destination file path.\n * @returns {Promise<void>} Resolves when streaming completes.\n * @throws {Error} If streaming fails.\n */\nexport async function streamFile(source: string, destination: string): Promise<void> {\n  const readStream = createReadStream(source);\n  const writeStream = createWriteStream(destination);\n\n  try {\n    await pipeline(readStream, writeStream);\n  } catch (error) {\n    // Ensure both streams are closed in case of error\n    readStream.destroy();\n    writeStream.destroy();\n    throw error;\n  }\n}\n\n/**\n * Reads a directory and returns file names.\n *\n * @param {string} dirPath - Path to the directory.\n * @param {object} [options] - Options for reading the directory.\n * @param {boolean} [options.fullPaths=false] - Whether to return full paths.\n * @param {RegExp} [options.filter] - Optional regex to filter files.\n * @returns {Promise<string[]>} Array of file names or paths.\n * @throws {Error} If directory cannot be read.\n */\nexport async function readDirectory(\n  dirPath: string,\n  options: { fullPaths?: boolean; filter?: RegExp } = {}\n): Promise<string[]> {\n  const files = await fs.readdir(dirPath);\n\n  let result = files;\n\n  if (options.filter) {\n    result = result.filter(file => options.filter!.test(file));\n  }\n\n  if (options.fullPaths) {\n    result = result.map(file => path.join(dirPath, file));\n  }\n\n  return result;\n}\n\n/**\n * Creates a directory if it doesn't exist.\n *\n * @param {string} dirPath - Path to the directory.\n * @param {boolean} [recursive=true] - Whether to create parent directories.\n * @returns {Promise<boolean>} Resolves to `true` if successful, `false` otherwise.\n */\nexport async function createDirectory(dirPath: string, recursive = true): Promise<boolean> {\n  try {\n    await fs.mkdir(dirPath, { recursive });\n    return true;\n  } catch (err: any) {\n    // Consider it success if directory already exists\n    return err.code === 'EEXIST';\n  }\n}\n\n/**\n * Safely reads and parses a JSON file with error details.\n *\n * @typeParam T - The expected type of the parsed JSON object.\n * @param {string} path - The path to the JSON file.\n * @returns {Promise<{ data: T | null; error: Error | null }>} Object with data and error properties.\n */\nexport async function safeReadJsonFile<T = any>(path: string): Promise<{ data: T | null; error: Error | null }> {\n  try {\n    const content = await fs.readFile(path, 'utf-8');\n    try {\n      const data = JSON.parse(content) as T;\n      return { data, error: null };\n    } catch (error: any) {\n      return {\n        data: null,\n        error: new Error(`Invalid JSON in file ${path}: ${error.message}`)\n      };\n    }\n  } catch (error: any) {\n    return {\n      data: null,\n      error: new Error(`Failed to read file ${path}: ${error.message}`)\n    };\n  }\n}\n\n/**\n * Checks if a path points to a file (not a directory).\n *\n * @param {string} path - Path to check.\n * @returns {Promise<boolean>} True if the path is a file, false otherwise.\n */\nexport async function isFile(path: string): Promise<boolean> {\n  try {\n    const stat = await fs.stat(path);\n    return stat.isFile();\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Gets the size of a file in bytes.\n *\n * @param {string} path - Path to the file.\n * @returns {Promise<number>} Size in bytes or -1 if file doesn't exist.\n */\nexport async function getFileSize(path: string): Promise<number> {\n  try {\n    const stat = await fs.stat(path);\n    return stat.size;\n  } catch {\n    return -1;\n  }\n}\n\n/**\n * Reads a file as a Buffer.\n *\n * @param {string} path - Path to the file.\n * @returns {Promise<Buffer | null>} File contents as Buffer or null if reading fails.\n */\nexport async function readFileBuffer(path: string): Promise<Buffer | null> {\n  try {\n    return await fs.readFile(path);\n  } catch {\n    return null;\n  }\n}\n"]}

package/build/esm/utils/http-status-codes.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"http-status-codes.js","sourceRoot":"","sources":["../../../src/utils/http-status-codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH;;;GAGG;AACH,MAAM,CAAN,IAAY,eAwUX;AAxUD,WAAY,eAAe;IACzB,oBAAoB;IACpB;;OAEG;IACH,+DAAc,CAAA;IAEd;;OAEG;IACH,qFAAyB,CAAA;IAEzB;;OAEG;IACH,mEAAgB,CAAA;IAEhB;;OAEG;IACH,qEAAiB,CAAA;IAEjB,cAAc;IACd;;OAEG;IACH,mDAAQ,CAAA;IAER;;OAEG;IACH,6DAAa,CAAA;IAEb;;OAEG;IACH,+DAAc,CAAA;IAEd;;OAEG;IACH,yGAAmC,CAAA;IAEnC;;OAEG;IACH,mEAAgB,CAAA;IAEhB;;OAEG;IACH,yEAAmB,CAAA;IAEnB;;OAEG;IACH,6EAAqB,CAAA;IAErB;;OAEG;IACH,uEAAkB,CAAA;IAElB;;OAEG;IACH,+EAAsB,CAAA;IAEtB;;OAEG;IACH,6DAAa,CAAA;IAEb,kBAAkB;IAClB;;OAEG;IACH,+EAAsB,CAAA;IAEtB;;OAEG;IACH,iFAAuB,CAAA;IAEvB;;OAEG;IACH,iFAAuB,CAAA;IAEvB;;OAEG;IACH,iEAAe,CAAA;IAEf;;OAEG;IACH,uEAAkB,CAAA;IAElB;;;OAGG;IACH,iEAAe,CAAA;IAEf;;OAEG;IACH,mFAAwB,CAAA;IAExB;;OAEG;IACH,mFAAwB,CAAA;IAExB,mBAAmB;IACnB;;OAEG;IACH,qEAAiB,CAAA;IAEjB;;OAEG;IACH,uEAAkB,CAAA;IAElB;;OAEG;IACH,+EAAsB,CAAA;IAEtB;;OAEG;IACH,iEAAe,CAAA;IAEf;;OAEG;IACH,iEAAe,CAAA;IAEf;;OAEG;IACH,mFAAwB,CAAA;IAExB;;OAEG;IACH,2EAAoB,CAAA;IAEpB;;OAEG;IACH,yGAAmC,CAAA;IAEnC;;OAEG;IACH,6EAAqB,CAAA;IAErB;;OAEG;IACH,+DAAc,CAAA;IAEd;;OAEG;IACH,uDAAU,CAAA;IAEV;;OAEG;IACH,6EAAqB,CAAA;IAErB;;OAEG;IACH,qFAAyB,CAAA;IAEzB;;OAEG;IACH,+EAAsB,CAAA;IAEtB;;;OAGG;IACH,iFAAuB,CAAA;IAEvB;;OAEG;IACH,uFAA0B,CAAA;IAE1B;;OAEG;IACH,2FAA4B,CAAA;IAE5B;;OAEG;IACH,6GAAqC,CAAA;IAErC;;OAEG;IACH,mFAAwB,CAAA;IAExB;;OAEG;IACH,qEAAiB,CAAA;IAEjB;;OAEG;IACH,2GAAoC,CAAA;IAEpC;;;OAGG;IACH,2EAAoB,CAAA;IAEpB;;OAEG;IACH,qFAAyB,CAAA;IAEzB;;OAEG;IACH,uFAA0B,CAAA;IAE1B;;OAEG;IACH,2DAAY,CAAA;IAEZ;;OAEG;IACH,iFAAuB,CAAA;IAEvB;;OAEG;IACH,+EAAsB,CAAA;IAEtB;;OAEG;IACH,yFAA2B,CAAA;IAE3B;;OAEG;IACH,iFAAuB,CAAA;IAEvB;;OAEG;IACH,6GAAqC,CAAA;IAErC;;OAEG;IACH,yGAAmC,CAAA;IAEnC,mBAAmB;IACnB;;OAEG;IACH,yFAA2B,CAAA;IAE3B;;OAEG;IACH,6EAAqB,CAAA;IAErB;;OAEG;IACH,qEAAiB,CAAA;IAEjB;;OAEG;IACH,qFAAyB,CAAA;IAEzB;;OAEG;IACH,6EAAqB,CAAA;IAErB;;OAEG;IACH,mGAAgC,CAAA;IAEhC;;OAEG;IACH,6FAA6B,CAAA;IAE7B;;OAEG;IACH,uFAA0B,CAAA;IAE1B;;OAEG;IACH,yEAAmB,CAAA;IAEnB;;OAEG;IACH,uEAAkB,CAAA;IAElB;;OAEG;IACH,6GAAqC,CAAA;AACvC,CAAC,EAxUW,eAAe,KAAf,eAAe,QAwU1B","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/**\n * Complete HTTP status codes enum with descriptions.\n * For use with API responses and error handling.\n */\nexport enum HttpStatusCodes {\n  // 1xx Informational\n  /**\n   * The server has received the request headers and the client should proceed to send the request body.\n   */\n  CONTINUE = 100,\n\n  /**\n   * The server is switching protocols according to the client's request.\n   */\n  SWITCHING_PROTOCOLS = 101,\n\n  /**\n   * Server has received the request and is still processing it.\n   */\n  PROCESSING = 102,\n\n  /**\n   * The server is sending preliminary headers while preparing the final response.\n   */\n  EARLY_HINTS = 103,\n\n  // 2xx Success\n  /**\n   * The request succeeded. The result meaning depends on the HTTP method used.\n   */\n  OK = 200,\n\n  /**\n   * The request succeeded and a new resource was created as a result.\n   */\n  CREATED = 201,\n\n  /**\n   * The request has been received but not yet acted upon.\n   */\n  ACCEPTED = 202,\n\n  /**\n   * The returned information is from a third-party source, not the origin server.\n   */\n  NON_AUTHORITATIVE_INFORMATION = 203,\n\n  /**\n   * The request succeeded but there's no content to send in the response.\n   */\n  NO_CONTENT = 204,\n\n  /**\n   * The client should reset the document view that caused this request.\n   */\n  RESET_CONTENT = 205,\n\n  /**\n   * The server is delivering only part of the resource due to a range header sent by the client.\n   */\n  PARTIAL_CONTENT = 206,\n\n  /**\n   * Conveys information about multiple resources, for complex operations.\n   */\n  MULTI_STATUS = 207,\n\n  /**\n   * The members of a DAV binding have already been enumerated and are not included in the response.\n   */\n  ALREADY_REPORTED = 208,\n\n  /**\n   * The server has fulfilled a request for the resource, and the response represents the result of one or more instance-manipulations.\n   */\n  IM_USED = 226,\n\n  // 3xx Redirection\n  /**\n   * The request has more than one possible response and the client should choose one.\n   */\n  MULTIPLE_CHOICES = 300,\n\n  /**\n   * The resource has been permanently moved to a new URL.\n   */\n  MOVED_PERMANENTLY = 301,\n\n  /**\n   * The resource has been temporarily moved to another URL.\n   */\n  MOVED_TEMPORARILY = 302,\n\n  /**\n   * The response to the request can be found under another URI using the GET method.\n   */\n  SEE_OTHER = 303,\n\n  /**\n   * The resource hasn't been modified since the last request.\n   */\n  NOT_MODIFIED = 304,\n\n  /**\n   * @deprecated\n   * Response must be accessed through a proxy.\n   */\n  USE_PROXY = 305,\n\n  /**\n   * The resource is temporarily available at a different URI, using the same HTTP method.\n   */\n  TEMPORARY_REDIRECT = 307,\n\n  /**\n   * The resource has been permanently moved to another URL, using the same HTTP method.\n   */\n  PERMANENT_REDIRECT = 308,\n\n  // 4xx Client Error\n  /**\n   * The server cannot process the request due to a client error (malformed request).\n   */\n  BAD_REQUEST = 400,\n\n  /**\n   * Authentication is required and has failed or not been provided.\n   */\n  UNAUTHORIZED = 401,\n\n  /**\n   * Reserved for future use, originally intended for digital payment systems.\n   */\n  PAYMENT_REQUIRED = 402,\n\n  /**\n   * The client doesn't have permission to access the requested resource.\n   */\n  FORBIDDEN = 403,\n\n  /**\n   * The requested resource could not be found on the server.\n   */\n  NOT_FOUND = 404,\n\n  /**\n   * The request method is not supported for the requested resource.\n   */\n  METHOD_NOT_ALLOWED = 405,\n\n  /**\n   * The server can't provide a response matching the list of acceptable values in the client's headers.\n   */\n  NOT_ACCEPTABLE = 406,\n\n  /**\n   * Authentication by a proxy is required.\n   */\n  PROXY_AUTHENTICATION_REQUIRED = 407,\n\n  /**\n   * The server timed out waiting for the request.\n   */\n  REQUEST_TIMEOUT = 408,\n\n  /**\n   * The request conflicts with the current state of the server.\n   */\n  CONFLICT = 409,\n\n  /**\n   * The resource has been permanently deleted with no forwarding address.\n   */\n  GONE = 410,\n\n  /**\n   * The server requires a Content-Length header field.\n   */\n  LENGTH_REQUIRED = 411,\n\n  /**\n   * Preconditions in the client's headers failed.\n   */\n  PRECONDITION_FAILED = 412,\n\n  /**\n   * Request entity is larger than limits defined by server.\n   */\n  REQUEST_TOO_LONG = 413,\n\n  /**\n   * The request payload exceeds server size limits.\n   * Modern equivalent of REQUEST_TOO_LONG.\n   */\n  PAYLOAD_TOO_LARGE = 413,\n\n  /**\n   * The URI requested is too long for the server to interpret.\n   */\n  REQUEST_URI_TOO_LONG = 414,\n\n  /**\n   * The server does not support the media type requested by the client.\n   */\n  UNSUPPORTED_MEDIA_TYPE = 415,\n\n  /**\n   * The range specified by the Range header cannot be fulfilled.\n   */\n  REQUESTED_RANGE_NOT_SATISFIABLE = 416,\n\n  /**\n   * The server cannot meet the expectations given in the Expect header.\n   */\n  EXPECTATION_FAILED = 417,\n\n  /**\n   * The server refuses to brew coffee because it is a teapot. (April Fools' joke)\n   */\n  IM_A_TEAPOT = 418,\n\n  /**\n   * The server cannot store the representation needed to complete the request.\n   */\n  INSUFFICIENT_SPACE_ON_RESOURCE = 419,\n\n  /**\n   * @deprecated\n   * A method has failed - specific to Spring Framework.\n   */\n  METHOD_FAILURE = 420,\n\n  /**\n   * The server cannot produce a response for the requested URI scheme and authority.\n   */\n  MISDIRECTED_REQUEST = 421,\n\n  /**\n   * The request was well-formed but has semantic errors preventing processing.\n   */\n  UNPROCESSABLE_ENTITY = 422,\n\n  /**\n   * The requested resource is locked against access.\n   */\n  LOCKED = 423,\n\n  /**\n   * The request failed due to the failure of a previous request.\n   */\n  FAILED_DEPENDENCY = 424,\n\n  /**\n   * The client should switch to a different protocol.\n   */\n  UPGRADE_REQUIRED = 426,\n\n  /**\n   * The server requires conditional requests to prevent lost updates.\n   */\n  PRECONDITION_REQUIRED = 428,\n\n  /**\n   * The client has sent too many requests in a given time period (rate limiting).\n   */\n  TOO_MANY_REQUESTS = 429,\n\n  /**\n   * Request headers are too large for the server to process.\n   */\n  REQUEST_HEADER_FIELDS_TOO_LARGE = 431,\n\n  /**\n   * Resource cannot be legally provided (e.g., censored by government).\n   */\n  UNAVAILABLE_FOR_LEGAL_REASONS = 451,\n\n  // 5xx Server Error\n  /**\n   * The server encountered an unexpected error preventing it from fulfilling the request.\n   */\n  INTERNAL_SERVER_ERROR = 500,\n\n  /**\n   * The server does not support the functionality required to fulfill the request.\n   */\n  NOT_IMPLEMENTED = 501,\n\n  /**\n   * The server, acting as a gateway, received an invalid response from an upstream server.\n   */\n  BAD_GATEWAY = 502,\n\n  /**\n   * The server is currently unable to handle the request due to temporary overload or maintenance.\n   */\n  SERVICE_UNAVAILABLE = 503,\n\n  /**\n   * The server, acting as a gateway, did not receive a timely response from an upstream server.\n   */\n  GATEWAY_TIMEOUT = 504,\n\n  /**\n   * The server does not support the HTTP protocol version used in the request.\n   */\n  HTTP_VERSION_NOT_SUPPORTED = 505,\n\n  /**\n   * Transparent content negotiation for the request resulted in circular reference.\n   */\n  VARIANT_ALSO_NEGOTIATES = 506,\n\n  /**\n   * The server cannot store the representation needed to complete the request.\n   */\n  INSUFFICIENT_STORAGE = 507,\n\n  /**\n   * The server detected an infinite loop while processing the request.\n   */\n  LOOP_DETECTED = 508,\n\n  /**\n   * Further extensions to the request are required for the server to fulfill it.\n   */\n  NOT_EXTENDED = 510,\n\n  /**\n   * The client needs to authenticate to gain network access.\n   */\n  NETWORK_AUTHENTICATION_REQUIRED = 511\n}\n"]}

package/build/esm/utils/id.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"id.utils.js","sourceRoot":"","sources":["../../../src/utils/id.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAEjD;;;;GAIG;AACH,MAAM,UAAU,IAAI;IAClB,OAAO,UAAU,EAAE,CAAC;AACtB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAC,MAAmB;IAAnB,uBAAA,EAAA,WAAmB;IACxC,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAC3B,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,OAAO,EAAE,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC;QAC1B,EAAE,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;aAC3C,QAAQ,CAAC,WAAW,CAAC;aACrB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,UAAuB;IAAvB,2BAAA,EAAA,eAAuB;IAC/C,6DAA6D;IAC7D,kGAAkG;IAClG,OAAO,WAAW,CAAC,UAAU,CAAC;SAC3B,QAAQ,CAAC,KAAK,CAAC;SACf,QAAQ,CAAC,UAAU,GAAG,CAAC,EAAE,GAAG,CAAC;SAC7B,KAAK,CAAC,CAAC,EAAE,UAAU,GAAG,CAAC,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,GAAW;IAChD,IAAM,KAAK,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;IAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC;AACjD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,UAAuB;IAAvB,2BAAA,EAAA,eAAuB;IAClD,OAAO,WAAW,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AACvD,CAAC","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\nimport { randomUUID, randomBytes } from 'crypto';\n\n/**\n * Generates a UUID v4 string (RFC 4122).\n *\n * @returns {string} UUID v4 (e.g., 'c0de1234-5678-9abc-def0-123456789abc')\n */\nexport function uuid(): string {\n  return randomUUID();\n}\n\n/**\n * Generates a nanoid-style random ID (URL-safe, customizable length).\n *\n * @param {number} length - Length of the ID (default: 21).\n * @returns {string} Nanoid-style random string.\n */\nexport function nanoId(length: number = 21): string {\n  if (length <= 0) return '';\n  let id = '';\n  while (id.length < length) {\n    id += randomBytes(Math.ceil((length * 3) / 4))\n      .toString('base64url')\n      .replace(/[+/=]/g, '');\n  }\n  return id.slice(0, length);\n}\n\n/**\n * Generates a cryptographically strong random hex string.\n *\n * @param {number} byteLength - Number of random bytes (default: 16 → 32 hex chars).\n * @returns {string} Random hex string.\n */\nexport function randomHex(byteLength: number = 16): string {\n  // Use Node.js crypto for both Node and browser compatibility\n  // Prefer randomBytes if available (Node), fallback to getRandomValues for browser (not used here)\n  return randomBytes(byteLength)\n    .toString('hex')\n    .padStart(byteLength * 2, '0')\n    .slice(0, byteLength * 2);\n}\n\n/**\n * Generates a random integer between min (inclusive) and max (inclusive).\n *\n * @param {number} min - Minimum value.\n * @param {number} max - Maximum value.\n * @returns {number} Random integer in range.\n */\nexport function randomInt(min: number, max: number): number {\n  const range = max - min + 1;\n  return Math.floor(Math.random() * range) + min;\n}\n\n/**\n * Generates a cryptographically strong random base64 string.\n *\n * @param {number} byteLength - Number of random bytes (default: 16).\n * @returns {string} Random base64 string (URL-safe, no padding).\n */\nexport function randomBase64(byteLength: number = 16): string {\n  return randomBytes(byteLength).toString('base64url');\n}\n"]}

package/build/esm/utils/logger.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"logger.utils.js","sourceRoot":"","sources":["../../../src/utils/logger.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\nimport pino, { LoggerOptions, stdTimeFunctions } from 'pino';\nimport type { Logger as PinoLogger } from 'pino'; // Type-only import\nimport { config } from '../config';\nimport { ContextStore, StoreKeys } from './context-store.utils';\nimport { Env } from './env.utils';\n\n/**\n * Symbol used to store the root logger in the Node.js global object.\n */\nconst GLOBAL_LOGGER_KEY = Symbol.for('logger');\n\n/**\n * Logger type for application-wide logging.\n */\nexport type Logger = pino.Logger;\n\n/**\n * Logger levels for application-wide logging.\n */\nexport type LoggerLevels = pino.Level;\n\n// Default sensitive fields\nexport const defaultSensitiveFields = [\n  'password',\n  'secret',\n  'token',\n  'apiKey',\n  'api_key',\n  'auth',\n  'jwt',\n  'access_token',\n  'client_secret',\n  'session_token',\n  'refresh_token'\n];\n\n/**\n * The global censor function used by the logger.\n */\nlet globalRedactCensor: (value: unknown, path: string[], sensitiveFields?: string[]) => string = (\n  value,\n  path,\n  sensitiveFields = defaultSensitiveFields\n) => {\n  if (typeof value !== 'string') return '***';\n\n  const lowerPath = path.map(p => p.toLowerCase());\n  const lowerSensitiveFields = sensitiveFields.map(f => f.toLowerCase());\n\n  if (lowerPath.some(p => lowerSensitiveFields.includes(p))) return '***';\n\n  // Redact URLs\n  if (lowerPath[0] === 'url') {\n    return value.replace(new RegExp(`([?&](${lowerSensitiveFields.join('|')})=)[^&#]*`, 'gi'), '$1***');\n  }\n\n  if (lowerPath.some(p => p.includes('authorization') || p.includes('auth'))) {\n    return value.replace(/^(\\S+)\\s+.+$/, '$1 ***') || '***';\n  }\n\n  // Redact sensitive fields - check each path segment against each sensitive field\n  if (lowerPath.some(pathPart => lowerSensitiveFields.some(field => pathPart.includes(field)))) {\n    return '***';\n  }\n\n  if (path.length > 0 && !['req', 'res', 'headers'].includes(lowerPath[0])) {\n    return value;\n  }\n\n  return value;\n};\n\n/**\n * Sets the global redaction censor function used throughout the application for log redaction.\n *\n * Use this function to customize how sensitive data is redacted in logs. The provided function\n * will replace the default censor implementation.\n *\n * @example\n * ```typescript\n * // Custom censor that redacts only specific values\n * setRedactCensor((value, path, sensitiveFields) => {\n *   if (path.includes('password')) return '***';\n *   return value;\n * });\n * ```\n *\n * @param fn - The redaction censor function to use globally. This function receives:\n *   - value: The data value to potentially redact\n *   - path: Array of strings representing the path to the value in the object\n *   - sensitiveFields: Optional array of field names to consider sensitive\n * @returns void\n */\nexport function setRedactCensor(fn: (value: unknown, path: string[], sensitiveFields?: string[]) => string) {\n  globalRedactCensor = fn;\n}\n\n/**\n * Gets the current global redaction censor function used for log redaction.\n *\n * This function is called internally by the logger when determining how to redact\n * sensitive information. It can also be used to access the current censor implementation\n * for composition or extension.\n *\n * @example\n * ```typescript\n * const currentCensor = getRedactCensor();\n * // Create an enhanced censor that extends the current one\n * setRedactCensor((value, path, fields) => {\n *   // Add custom logic before delegating to current censor\n *   if (someCondition) return customHandling();\n *   return currentCensor(value, path, fields);\n * });\n * ```\n *\n * @returns The current redaction censor function\n */\nexport function getRedactCensor() {\n  return globalRedactCensor;\n}\n\n/**\n * Convenience function to redact sensitive data using the current global redact censor.\n *\n * This is a direct wrapper around the global censor function that simplifies usage\n * in application code without needing to access the censor function directly.\n *\n * @example\n * ```typescript\n * // Redact a potential sensitive value\n * const safeValue = redact(value, ['user', 'apiKey']);\n * ```\n *\n * @param value - The value to potentially redact\n * @param path - Array of strings representing the path to the value in the object\n * @param sensitiveFields - Optional array of field names to consider sensitive\n * @returns The redacted string value or \"***\" for redacted content\n */\nexport function redact(value: unknown, path: string[], sensitiveFields?: string[]) {\n  return globalRedactCensor(value, path, sensitiveFields);\n}\n\n/**\n * Extends the current redaction function with additional fields to redact.\n *\n * This function wraps the existing censor while adding more fields to be considered\n * sensitive without replacing the entire redaction logic.\n *\n * @example\n * ```typescript\n * // Add custom fields to be redacted in all future redaction operations\n * addRedactFields(['customerId', 'accountNumber']);\n * ```\n *\n * @param fields - Array of additional field names to redact\n */\nexport function addRedactFields(fields: string[]) {\n  const prev = globalRedactCensor;\n  globalRedactCensor = (value, path, sensitiveFields = defaultSensitiveFields) =>\n    prev(value, path, [...(sensitiveFields || []), ...fields]);\n}\n\n/**\n * Replaces the default list of sensitive fields with a new list.\n *\n * This is useful when you want complete control over what fields are considered\n * sensitive by default, rather than using the library's built-in list.\n *\n * @example\n * ```typescript\n * // Replace default sensitive fields with a custom list\n * setSensitiveFields(['password', 'ssn', 'creditCard']);\n * ```\n *\n * @param fields - Array of field names to set as the new default sensitive fields\n */\nexport function setSensitiveFields(fields: string[]) {\n  defaultSensitiveFields.splice(0, defaultSensitiveFields.length, ...fields);\n}\n\n/**\n * Adds additional field names to the default sensitive fields list.\n *\n * This preserves the existing sensitive fields while adding new ones for\n * application-specific sensitive data.\n *\n * @example\n * ```typescript\n * // Add domain-specific sensitive fields to the default list\n * addSensitiveFields(['socialSecurityNumber', 'medicalRecordNumber']);\n * ```\n *\n * @param fields - Array of additional field names to add to the sensitive fields list\n */\nexport function addSensitiveFields(fields: string[]) {\n  defaultSensitiveFields.push(...fields);\n}\n\n/**\n * Use an object compatible with either modern or legacy global scopes.\n */\nexport const _globalThis = typeof globalThis === 'object' ? globalThis : global;\nconst _global = _globalThis as unknown as { [GLOBAL_LOGGER_KEY]: PinoLogger };\n\n/**\n * Initializes the global root logger according to app configuration.\n *\n * - Sets log name, level, timestamp, and redaction for sensitive fields.\n * - Uses singleton in global symbol registry.\n */\nfunction setupLogger(): void {\n  const logParams: LoggerOptions = {\n    name: config.logger.name || '@catbee/utils',\n    level: config.logger.level || 'info',\n    redact: {\n      paths: ['req.authorization', 'res.authorization', 'url', 'headers.authorization', 'headers.cookies'],\n      censor: (value, path) => redact(value, path)\n    },\n    // serializers: {\n    //   req: pino.stdSerializers.req,\n    //   request: pino.stdSerializers.req,\n    //   res: pino.stdSerializers.res,\n    //   response: pino.stdSerializers.res,\n    //   err: pino.stdSerializers.err,\n    //   error: pino.stdSerializers.err\n    // },\n    timestamp: stdTimeFunctions.isoTime\n  };\n\n  const logger =\n    config.logger.pretty && Env.isDev()\n      ? pino(\n          logParams,\n          pino.transport({\n            target: 'pino-pretty',\n            options: {\n              colorize: true,\n              translateTime: 'SYS:standard',\n              ignore: 'pid,hostname',\n              singleLine: config.logger.singleLine,\n              levelFirst: true\n            }\n          })\n        )\n      : pino(logParams);\n\n  _global[GLOBAL_LOGGER_KEY] = logger;\n  _global[GLOBAL_LOGGER_KEY]?.debug('Logger initialized');\n}\n\n/**\n * Retrieves the current logger instance:\n * - Returns a request-scoped logger from AsyncLocalStorage if available\n * - Falls back to the global (singleton) logger\n * - Initializes the global logger if not created yet\n *\n * @returns {Logger} The logger instance (request-bound or global root logger)\n */\nexport function getLogger(): PinoLogger {\n  const logger = ContextStore.get<PinoLogger>(StoreKeys.LOGGER);\n  if (logger) return logger;\n\n  if (!_global[GLOBAL_LOGGER_KEY]) {\n    setupLogger();\n  }\n\n  return _global[GLOBAL_LOGGER_KEY];\n}\n\n/**\n * Logger instance for the global context.\n * This logger is used for logging messages that are not tied to a specific request.\n */\nexport const logger = getLogger();\n\n/**\n * Creates a child logger with additional context.\n *\n * @param {Record<string, any>} bindings - Properties to attach to all log records\n * @param {Logger} [parentLogger] - Parent logger (defaults to current context logger or global)\n * @returns {Logger} Child logger with merged context\n */\nexport function createChildLogger(bindings: Record<string, any>, parentLogger?: PinoLogger): PinoLogger {\n  const logger = parentLogger || getLogger();\n  return logger.child(bindings);\n}\n\n/**\n * Creates a request-scoped logger with request ID and stores it in context\n *\n * @param {string} requestId - Unique request identifier\n * @param {object} [additionalContext] - Additional context to include in logs\n * @returns {Logger} Request-scoped logger instance\n */\nexport function createRequestLogger(requestId: string, additionalContext: Record<string, any> = {}): PinoLogger {\n  const logger = createChildLogger({\n    requestId,\n    ...additionalContext\n  });\n\n  try {\n    ContextStore.set(StoreKeys.LOGGER, logger);\n  } catch {\n    // Context not initialized, can't store logger\n    logger.debug('Failed to store logger in context - AsyncLocalStorage not initialized');\n  }\n\n  return logger;\n}\n\n/**\n * Utility to safely log errors with proper stack trace extraction\n *\n * @param {Error|unknown} error - Error object to log\n * @param {string} [message] - Optional message to include\n * @param {Record<string, any>} [context] - Additional context properties\n */\nexport function logError(error: Error | unknown, message?: string, context?: Record<string, any>): void {\n  const logger = getLogger();\n\n  const errObj = error instanceof Error ? error : new Error(String(error));\n  const logContext = {\n    ...context,\n    error: errObj\n  };\n\n  logger.error(logContext, message || errObj.message);\n}\n"]}

package/build/esm/utils/middleware.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"middleware.utils.js","sourceRoot":"","sources":["../../../src/utils/middleware.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\nimport { uuid } from './id.utils';\nimport { HttpStatusCodes } from './http-status-codes';\nimport { createFinalErrorResponse, ErrorResponse } from './response.utils';\nimport { getLogger } from './logger.utils';\nimport type { Request, Response, NextFunction } from 'express';\nimport { ContextStore, StoreKeys } from './context-store.utils';\nimport { RequestTimeoutException } from './exception.utils';\nimport { ApiErrorResponse } from '../types/api-response';\n\nexport type Middleware = (req: Request, res: Response, next: NextFunction) => void | Promise<void>;\n\n/**\n * Attaches a unique request ID to each request.\n * Useful for request tracing and correlation between logs.\n *\n * @param {object} [options] - Configuration options\n * @param {string} [options.headerName='X-Request-ID'] - Header name for request ID\n * @param {boolean} [options.exposeHeader=true] - Whether to expose the header in response\n * @param {() => string} [options.generator] - Custom ID generator function\n * @returns {Middleware} Express-compatible middleware\n */\nexport function requestId(options?: {\n  headerName?: string;\n  exposeHeader?: boolean;\n  generator?: () => string;\n}): Middleware {\n  const headerName = options?.headerName || 'X-Request-ID';\n  const exposeHeader = options?.exposeHeader !== false;\n  const generateId = options?.generator || uuid;\n\n  return (req, res, next) => {\n    // Use existing request ID from header or generate a new one\n    const existingId = req.headers[headerName.toLowerCase()];\n    const id = (existingId as string) || generateId();\n\n    // Attach ID to request object\n    req.id = id;\n\n    // Add ID to response headers\n    if (exposeHeader) {\n      res.setHeader(headerName, id);\n    }\n\n    next();\n  };\n}\n\n/**\n * Measures request processing time and logs or adds it to response headers.\n *\n * @param {object} [options] - Configuration options\n * @param {boolean} [options.addHeader=true] - Whether to add X-Response-Time header\n * @param {boolean} [options.logOnComplete=false] - Whether to log timing info\n * @returns {Middleware} Express-compatible middleware\n */\nexport function responseTime(options?: { addHeader?: boolean; logOnComplete?: boolean }) {\n  const addHeader = options?.addHeader !== false;\n  const logOnComplete = options?.logOnComplete === true;\n\n  return (req: Request, res: Response, next: NextFunction) => {\n    const start = process.hrtime();\n\n    // Function to calculate duration\n    const getDuration = () => {\n      const diff = process.hrtime(start);\n      return (diff[0] * 1e3 + diff[1] * 1e-6).toFixed(2);\n    };\n\n    if (addHeader) {\n      // Ensure header is set before response is sent\n      const originalWriteHead = res.writeHead;\n      res.writeHead = function (...args: any[]) {\n        res.setHeader('X-Response-Time', `${getDuration()}ms`);\n        return originalWriteHead.apply(this, args as any);\n      };\n    }\n\n    if (logOnComplete) {\n      res.on('finish', () => {\n        getLogger().info(`${req.method} ${req.url} - ${getDuration()}ms`);\n      });\n    }\n\n    next();\n  };\n}\n\n/**\n * Request timeout middleware.\n * Aborts requests that take too long to process.\n *\n * @param {number} [timeoutMs=30000] - Timeout in milliseconds\n * @returns {Middleware} Express-compatible middleware\n */\nexport function timeout(timeoutMs: number = 30000): Middleware {\n  return (_req, res, next) => {\n    // Set timeout for the request\n    const timer = setTimeout(() => {\n      const response = new RequestTimeoutException('Request timed out');\n      res.status(HttpStatusCodes.REQUEST_TIMEOUT).json(response);\n    }, timeoutMs);\n\n    // Clear timeout when response is sent\n    res.on('finish', () => {\n      clearTimeout(timer);\n    });\n\n    next();\n  };\n}\n\n/**\n * Creates an Express middleware that initializes a per-request context.\n *\n * @param {object} [options] - Optional configuration\n * @param {string} [options.headerName='x-request-id'] - Header to look for request ID\n * @param {boolean} [options.autoLog=true] - Whether to log automatically when context is initialized\n * @returns {(req: Request, res: Response, next: NextFunction) => void} Express middleware function\n */\nexport function setupRequestContext(options: { headerName?: string; autoLog?: boolean } = {}): Middleware {\n  const { headerName = 'x-request-id', autoLog = true } = options;\n  return (req, _res, next) => {\n    // Generate or use existing request ID\n    const requestId = (req.headers[headerName] as string) || req?.['id'] || uuid();\n\n    ContextStore.run({ [StoreKeys.REQUEST_ID]: requestId }, () => {\n      // Create a child logger for this request\n      const childLogger = getLogger().child({\n        requestId,\n        method: req.method,\n        url: req.originalUrl || req.url\n      });\n\n      req.logger = childLogger;\n\n      // Store logger in context\n      ContextStore.set(StoreKeys.LOGGER, childLogger);\n\n      if (autoLog) {\n        req.logger.info('Request context initialized');\n      }\n\n      next();\n    });\n  };\n}\n\nexport interface ErrorHandlerOptions {\n  /** Whether to log errors (default: true) */\n  logErrors?: boolean;\n  /** Whether to include error details in non-production (default: false) */\n  includeDetails?: boolean;\n}\n\n/**\n * Global error handling middleware with enhanced features.\n *\n * @param {ErrorHandlerOptions} options - Error handler options\n * @param {boolean} [options.logErrors=true] - Whether to log errors\n * @param {boolean} [options.includeDetails=false] - Whether to include error details in non-production\n * @returns Error middleware\n *\n * @example\n * import express from 'express';\n * import { errorHandler } from '@catbee/utils';\n *\n * const app = express();\n *\n * // Your routes\n * app.get('/ping', (req, res) => {\n *   throw new Error('Something went wrong');\n * });\n *\n * // Error handler (must be last middleware)\n * app.use(errorHandler({ includeDetails: true }));\n *\n * app.listen(3000, () => {\n *   console.log('Server running on port 3000');\n * });\n */\nexport function errorHandler(options?: ErrorHandlerOptions) {\n  const logErrors = options?.logErrors !== false;\n  const includeDetails = options?.includeDetails === true;\n\n  return (err: any, req: Request, res: Response, _next: NextFunction) => {\n    // Determine status code\n    const status = err?.status || err?.statusCode || HttpStatusCodes.INTERNAL_SERVER_ERROR;\n\n    // Log error if enabled\n    if (logErrors) {\n      getLogger().error({ err }, `${err.message || 'Unknown error'}`);\n    }\n\n    // Handle ErrorResponse instances (our custom error class)\n    if (err instanceof ErrorResponse) {\n      const result: ApiErrorResponse = {\n        error: true,\n        message: err.message,\n        timestamp: err.timestamp,\n        requestId: err?.requestId || req?.id || uuid(),\n        status,\n        path: req.originalUrl || req.url\n      };\n\n      if (includeDetails && err?.stack) {\n        result.stack = err.stack.split('\\n').map((line: string) => line.trim());\n      }\n      return res.status(status).json(result);\n    }\n\n    // Handle any other errors\n    return res\n      .status(status)\n      .json(createFinalErrorResponse(req, status, err?.message || 'Internal Server Error', err, { includeDetails }));\n  };\n}\n\n/**\n * Health check middleware for service status and custom checks.\n *\n * @param {object} [options] - Health check options\n * @param {string} [options.path='/healthz'] - Health check endpoint path\n * @param {Array<{name: string; check: () => Promise<boolean> | boolean}>} [options.checks] - Custom health checks\n * @param {boolean} [options.detailed=true] - Show detailed check results\n * @returns {Middleware} Express-compatible middleware\n */\nexport function healthCheck(options?: {\n  path?: string;\n  checks?: Array<{ name: string; check: () => Promise<boolean> | boolean }>;\n  detailed?: boolean;\n}): Middleware {\n  const path = options?.path || '/healthz';\n  const checks = options?.checks || [];\n  const detailed = options?.detailed !== false;\n\n  return async (req, res, next) => {\n    if (req.path !== path) return next();\n    const results: Record<string, boolean> = {};\n    let allHealthy = true;\n    for (const check of checks) {\n      try {\n        const result = await Promise.resolve(check.check());\n        results[check.name] = !!result;\n        if (!result) allHealthy = false;\n      } catch {\n        results[check.name] = false;\n        allHealthy = false;\n      }\n    }\n    const status = allHealthy ? HttpStatusCodes.OK : HttpStatusCodes.SERVICE_UNAVAILABLE;\n    const response = detailed\n      ? { status: allHealthy ? 'ok' : 'unhealthy', checks: results, timestamp: new Date().toISOString() }\n      : { status: allHealthy ? 'ok' : 'unhealthy' };\n    res.status(status).json(response);\n  };\n}\n"]}