@catbee/utils 0.0.8-next.0 → 0.0.8-rc.1

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

@@ -0,0 +1 @@
+{"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.d.ts

@@ -0,0 +1,230 @@
+import { ErrorResponse } from './response.utils';
+/**
+ * Generic HTTP error class used for custom exceptions with any status code.
+ * Inherit this when you need to throw errors dynamically at runtime.
+ */
+export declare class HttpError extends ErrorResponse {
+    /**
+     * Creates a new HTTP error instance.
+     * @param status - A valid HTTP status code (e.g., 400, 500).
+     * @param message - The error message to return to the client.
+     */
+    constructor(status: number, message: string);
+}
+/**
+ * Represents a 500 Internal Server Error.
+ * Use this for unexpected backend errors that are not caused by the client.
+ */
+export declare class InternalServerErrorException extends ErrorResponse {
+    /**
+     * @param message - Optional custom message. Defaults to "Internal server error".
+     */
+    constructor(message?: string);
+}
+/**
+ * Represents a 401 Unauthorized Error.
+ * Indicates that authentication is required and has failed or not been provided.
+ */
+export declare class UnauthorizedException extends ErrorResponse {
+    /**
+     * @param message - Optional custom message. Defaults to "Unauthorized".
+     */
+    constructor(message?: string);
+}
+/**
+ * Represents a 400 Bad Request Error.
+ * Indicates that the client has sent invalid data (e.g., malformed request body).
+ */
+export declare class BadRequestException extends ErrorResponse {
+    /**
+     * @param message - Optional custom message. Defaults to "Bad request".
+     */
+    constructor(message?: string);
+}
+/**
+ * Represents a 404 Not Found Error.
+ * Used when a requested resource (e.g., user, file) could not be located.
+ */
+export declare class NotFoundException extends ErrorResponse {
+    /**
+     * @param message - Optional custom message. Defaults to "Resource not found".
+     */
+    constructor(message?: string);
+}
+/**
+ * Represents a 403 Forbidden Error.
+ * Indicates that the client is authenticated but not allowed to access the resource.
+ */
+export declare class ForbiddenException extends ErrorResponse {
+    /**
+     * @param message - Optional custom message. Defaults to "Forbidden".
+     */
+    constructor(message?: string);
+}
+/**
+ * Represents a 409 Conflict Error.
+ * Commonly used when a resource already exists or a versioning conflict occurs.
+ */
+export declare class ConflictException extends ErrorResponse {
+    /**
+     * @param message - Optional custom message. Defaults to "Conflict".
+     */
+    constructor(message?: string);
+}
+/**
+ * Represents a 502 Bad Gateway Error.
+ * Used when the server receives an invalid response from an upstream server.
+ */
+export declare class BadGatewayException extends ErrorResponse {
+    /**
+     * @param message - Optional custom message. Defaults to "Bad Gateway".
+     */
+    constructor(message?: string);
+}
+/**
+ * Represents a 429 Too Many Requests Error.
+ * Returned when the client has hit a rate limit.
+ */
+export declare class TooManyRequestsException extends ErrorResponse {
+    /**
+     * @param message - Optional custom message. Defaults to "Too many requests".
+     */
+    constructor(message?: string);
+}
+/**
+ * Represents a 503 Service Unavailable Error.
+ * Indicates that the server is temporarily unavailable (e.g., for maintenance).
+ */
+export declare class ServiceUnavailableException extends ErrorResponse {
+    /**
+     * @param message - Optional custom message. Defaults to "Service Unavailable".
+     */
+    constructor(message?: string);
+}
+/**
+ * Represents a 504 Gateway Timeout Error.
+ * Returned when the server acting as a gateway times out waiting for a response.
+ */
+export declare class GatewayTimeoutException extends ErrorResponse {
+    /**
+     * @param message - Optional custom message. Defaults to "Gateway Timeout".
+     */
+    constructor(message?: string);
+}
+/**
+ * Represents a 422 Unprocessable Entity Error.
+ * Used when the server understands the content type but cannot process the contained instructions.
+ */
+export declare class UnprocessableEntityException extends ErrorResponse {
+    details?: Record<string, any> | undefined;
+    /**
+     * @param message - Optional custom message. Defaults to "Unprocessable Entity".
+     * @param details - Optional validation details or additional error context.
+     */
+    constructor(message?: string, details?: Record<string, any> | undefined);
+}
+/**
+ * Represents a 405 Method Not Allowed Error.
+ * Used when the request method is not supported for the requested resource.
+ */
+export declare class MethodNotAllowedException extends ErrorResponse {
+    allowedMethods?: string[] | undefined;
+    /**
+     * @param message - Optional custom message. Defaults to "Method Not Allowed".
+     * @param allowedMethods - Optional array of allowed HTTP methods.
+     */
+    constructor(message?: string, allowedMethods?: string[] | undefined);
+}
+/**
+ * Represents a 406 Not Acceptable Error.
+ * Used when the server cannot produce a response matching the client's accepted content types.
+ */
+export declare class NotAcceptableException extends ErrorResponse {
+    /**
+     * @param message - Optional custom message. Defaults to "Not Acceptable".
+     */
+    constructor(message?: string);
+}
+/**
+ * Represents a 408 Request Timeout Error.
+ * Used when the server times out waiting for the client to send a request.
+ */
+export declare class RequestTimeoutException extends ErrorResponse {
+    /**
+     * @param message - Optional custom message. Defaults to "Request Timeout".
+     */
+    constructor(message?: string);
+}
+/**
+ * Represents a 415 Unsupported Media Type Error.
+ * Used when the request's Content-Type is not supported.
+ */
+export declare class UnsupportedMediaTypeException extends ErrorResponse {
+    /**
+     * @param message - Optional custom message. Defaults to "Unsupported Media Type".
+     */
+    constructor(message?: string);
+}
+/**
+ * Represents a 413 Payload Too Large Error.
+ * Used when the request body exceeds server limits.
+ */
+export declare class PayloadTooLargeException extends ErrorResponse {
+    /**
+     * @param message - Optional custom message. Defaults to "Payload Too Large".
+     */
+    constructor(message?: string);
+}
+/**
+ * Represents a 507 Insufficient Storage Error.
+ * Used when the server has insufficient storage to complete the request.
+ */
+export declare class InsufficientStorageException extends ErrorResponse {
+    /**
+     * @param message - Optional custom message. Defaults to "Insufficient Storage".
+     */
+    constructor(message?: string);
+}
+/**
+ * Checks if an error is an instance of HttpError or its subclasses.
+ *
+ * @param error - The error to check.
+ * @returns True if the error is an HttpError, false otherwise.
+ */
+export declare function isHttpError(error: unknown): error is ErrorResponse;
+/**
+ * Creates an HTTP error with the specified status code and message.
+ * Factory function for creating appropriate HTTP error instances.
+ *
+ * @param status - HTTP status code.
+ * @param message - Optional custom error message.
+ * @returns An instance of the appropriate HTTP error class.
+ */
+export declare function createHttpError(status: number, message?: string): ErrorResponse;
+/**
+ * Type guard to check if an object has specific error properties.
+ *
+ * @param error - The object to check.
+ * @returns True if object has error-like structure.
+ */
+export declare function hasErrorShape(error: unknown): error is {
+    message: string;
+    status?: number;
+    code?: string;
+};
+/**
+ * Safely extracts message from any error type.
+ *
+ * @param error - Any error object or value.
+ * @returns A string error message.
+ */
+export declare function getErrorMessage(error: unknown): string;
+/**
+ * Wraps a function and transforms any errors into HTTP errors.
+ * Useful for API handlers to ensure consistent error responses.
+ *
+ * @param handler - The async function to wrap.
+ * @returns A function that always returns or throws an HTTP error.
+ */
+export declare function withErrorHandling<T extends (...args: any[]) => Promise<any>>(handler: T): (...args: Parameters<T>) => Promise<Awaited<ReturnType<T>>>;
+//# sourceMappingURL=exception.utils.d.ts.map