@catbee/utils 0.0.2 → 0.0.3

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

@@ -1 +1 @@
-{"version":3,"file":"env.utils.js","sourceRoot":"","sources":["../../../src/utils/env.utils.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable n/no-process-env */\nimport { existsSync } from \"fs\";\nimport { isAbsolute, resolve } from \"path\";\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 * Utility class for accessing and managing environment variables.\n * Provides typed getters with fallback defaults and validation.\n */\nexport class Env {\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 (\n      Env.get(\"NODE_ENV\", Environment.DEVELOPMENT) === Environment.DEVELOPMENT\n    );\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.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.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.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\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   *\n   * @param {string} key - The environment variable key.\n   * @param {string} [defaultValue] - Value to return if the key is missing.\n   * @returns {string | undefined} The env value or the fallback.\n   */\n  static get(key: string, defaultValue?: string): string | undefined {\n    return process.env[key] ?? defaultValue;\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 env ${key} is missing`);\n    }\n    return value;\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    const value = process.env[key] ?? defaultValue;\n    const numberValue = Number(value);\n    if (isNaN(numberValue)) {\n      throw new Error(`Env ${key} is not a number`);\n    }\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 env ${key} is missing`);\n    }\n    const numberValue = Number(value);\n    if (isNaN(numberValue)) {\n      throw new Error(`Required env ${key} is not a number`);\n    }\n    return numberValue;\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  static getBoolean(key: string, defaultValue = false): boolean {\n    const value = (process.env[key] ?? defaultValue).toString().toLowerCase();\n    if ([\"true\", \"1\", \"yes\", \"on\"].includes(value)) return true;\n    if ([\"false\", \"0\", \"no\", \"off\"].includes(value)) return false;\n    throw new Error(`Env variable ${key} is not a boolean`);\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 env ${key} is missing`);\n    }\n    return this.getBoolean(key); // reuse logic\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  static getJSON<T extends object = object>(key: string, defaultValue: T): T {\n    const v = process.env[key];\n    if (v !== undefined) {\n      try {\n        return JSON.parse(v);\n      } catch {\n        throw new Error(`Env variable ${key} is not a valid JSON string`);\n      }\n    }\n    return defaultValue;\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   * @returns {string[] | T[]} An array of strings.\n   */\n  static getArray<T = string>(\n    key: string,\n    defaultValue: T[] = [],\n    splitter = \",\",\n  ): string[] | T[] {\n    const value = process.env[key];\n    if (!value || value.trim() === \"\") {\n      return defaultValue;\n    }\n    return value\n      .split(splitter)\n      .map((item) => item.trim())\n      .filter((item) => item.length > 0);\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  static getEnum<T extends string>(\n    key: string,\n    allowedValues: T[],\n    defaultValue?: T,\n  ): T {\n    const value = process.env[key] ?? defaultValue;\n    if (!value || !allowedValues.includes(value as T)) {\n      throw new Error(\n        `Env ${key} must be one of ${allowedValues.join(\", \")}. Received: ${value}`,\n      );\n    }\n    return value as T;\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 {object} [options] - Validation options.\n   * @param {string[]} [options.protocols] - Allowed protocols.\n   * @param {boolean} [options.requireTld=true] - Whether TLD is required.\n   * @returns {string} The validated URL.\n   * @throws {Error} If URL is invalid.\n   */\n  static getUrl(\n    key: string,\n    defaultValue?: string,\n    options: { protocols?: string[]; requireTld?: boolean } = {},\n  ): string {\n    const value = Env.get(key, defaultValue);\n    if (!value) {\n      throw new Error(`Env ${key} is missing or empty`);\n    }\n\n    let url: URL;\n    try {\n      url = new URL(value);\n    } catch {\n      throw new Error(`Env ${key} is not a valid URL`);\n    }\n\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          `Env ${key} must use one of the protocols: ${options.protocols.join(\", \")}`,\n        );\n      }\n    }\n\n    if (options.requireTld === true) {\n      // Check if hostname has a TLD (contains at least one dot and doesn't end with a dot)\n      // localhost, 127.0.0.1, etc. don't have TLDs\n      const hostname = url.hostname;\n      if (\n        !hostname.includes(\".\") ||\n        hostname === \"localhost\" ||\n        /^[\\d.]+$/.test(hostname) || // IP address\n        hostname.endsWith(\".\")\n      ) {\n        throw new Error(`Env ${key} must have a valid host with TLD`);\n      }\n    }\n\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  static getEmail(key: string, defaultValue?: string): string {\n    const value = Env.get(key, defaultValue);\n\n    if (!value) {\n      if (defaultValue === undefined) {\n        throw new Error(`Email env ${key} is missing`);\n      }\n      return defaultValue;\n    }\n\n    // Simple email validation regex\n    const emailRegex = /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$/;\n    if (!emailRegex.test(value)) {\n      throw new Error(`Env ${key} is not a valid email address`);\n    }\n\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 {object} [options] - Validation options.\n   * @param {boolean} [options.mustExist=false] - Whether path must exist.\n   * @param {boolean} [options.makeAbsolute=true] - Convert relative paths to absolute.\n   * @returns {string} The validated path.\n   * @throws {Error} If path is invalid.\n   */\n  static getPath(\n    key: string,\n    defaultValue?: string,\n    options: { mustExist?: boolean; makeAbsolute?: boolean } = {},\n  ): string {\n    const value = Env.get(key, defaultValue);\n\n    if (!value) {\n      if (defaultValue === undefined) {\n        throw new Error(`Path env ${key} is missing`);\n      }\n      return defaultValue;\n    }\n\n    const path =\n      options.makeAbsolute !== false && !isAbsolute(value)\n        ? resolve(process.cwd(), value)\n        : value;\n\n    if (options.mustExist && !existsSync(path)) {\n      throw new Error(`Path in env ${key} does not exist: ${path}`);\n    }\n\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=3000] - Optional fallback value.\n   * @returns {number} The validated port number.\n   * @throws {Error} If port is invalid.\n   */\n  static getPort(key: string, defaultValue: number = 3000): number {\n    const port = Env.getNumber(key, defaultValue);\n\n    if (port < 0 || port > 65535) {\n      throw new Error(`Env ${key} must be a valid port number (0-65535)`);\n    }\n\n    return port;\n  }\n\n  /**\n   * Retrieves a duration string and converts 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  static getDuration(key: string, defaultValue: string | number = \"0\"): number {\n    const value = Env.get(key, String(defaultValue));\n\n    if (!value) return 0;\n\n    // Handle plain number input (assume milliseconds)\n    if (/^\\d+$/.test(value)) {\n      return parseInt(value, 10);\n    }\n\n    // Parse duration string like \"1d2h30m15s\"\n    const durationRegex = /(\\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        `Env ${key} has invalid duration format. Use 1d, 2h, 30m, 45s, or 100ms.`,\n      );\n    }\n\n    let ms = 0;\n\n    if (matches[1]) ms += parseInt(matches[1], 10) * 86400000; // days\n    if (matches[2]) ms += parseInt(matches[2], 10) * 3600000; // hours\n    if (matches[3]) ms += parseInt(matches[3], 10) * 60000; // minutes\n    if (matches[4]) ms += parseInt(matches[4], 10) * 1000; // seconds\n    if (matches[5]) ms += parseInt(matches[5], 10); // milliseconds\n\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  static getSafeEnv(\n    sensitiveKeys: string[] = [\"password\", \"secret\", \"key\", \"token\", \"auth\"],\n  ): 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) =>\n        key.toLowerCase().includes(sensitiveKey.toLowerCase()),\n      );\n\n      safeEnv[key] = isSensitive ? \"******\" : value;\n    }\n\n    return safeEnv;\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  }\n}\n"]}
+{"version":3,"file":"env.utils.js","sourceRoot":"","sources":["../../../src/utils/env.utils.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable n/no-process-env */\nimport { existsSync } from 'fs';\nimport { isAbsolute, resolve } from 'path';\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 * Utility class for accessing and managing environment variables.\n * Provides typed getters with fallback defaults and validation.\n */\nexport class Env {\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.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.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.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\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   *\n   * @param {string} key - The environment variable key.\n   * @param {string} [defaultValue] - Value to return if the key is missing.\n   * @returns {string | undefined} The env value or the fallback.\n   */\n  static get(key: string, defaultValue?: string): string | undefined {\n    return process.env[key] ?? defaultValue;\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 env ${key} is missing`);\n    }\n    return value;\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    const value = process.env[key] ?? defaultValue;\n    const numberValue = Number(value);\n    if (isNaN(numberValue)) {\n      throw new Error(`Env ${key} is not a number`);\n    }\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 env ${key} is missing`);\n    }\n    const numberValue = Number(value);\n    if (isNaN(numberValue)) {\n      throw new Error(`Required env ${key} is not a number`);\n    }\n    return numberValue;\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  static getBoolean(key: string, defaultValue = false): boolean {\n    const value = (process.env[key] ?? defaultValue).toString().toLowerCase();\n    if (['true', '1', 'yes', 'on'].includes(value)) return true;\n    if (['false', '0', 'no', 'off'].includes(value)) return false;\n    throw new Error(`Env variable ${key} is not a boolean`);\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 env ${key} is missing`);\n    }\n    return this.getBoolean(key); // reuse logic\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  static getJSON<T extends object = object>(key: string, defaultValue: T): T {\n    const v = process.env[key];\n    if (v !== undefined) {\n      try {\n        return JSON.parse(v);\n      } catch {\n        throw new Error(`Env variable ${key} is not a valid JSON string`);\n      }\n    }\n    return defaultValue;\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   * @returns {string[] | T[]} An array of strings.\n   */\n  static getArray<T = string>(key: string, defaultValue: T[] = [], splitter = ','): string[] | T[] {\n    const value = process.env[key];\n    if (!value || value.trim() === '') {\n      return defaultValue;\n    }\n    return value\n      .split(splitter)\n      .map(item => item.trim())\n      .filter(item => item.length > 0);\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  static getEnum<T extends string>(key: string, allowedValues: T[], defaultValue?: T): T {\n    const value = process.env[key] ?? defaultValue;\n    if (!value || !allowedValues.includes(value as T)) {\n      throw new Error(`Env ${key} must be one of ${allowedValues.join(', ')}. Received: ${value}`);\n    }\n    return value as T;\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 {object} [options] - Validation options.\n   * @param {string[]} [options.protocols] - Allowed protocols.\n   * @param {boolean} [options.requireTld=true] - Whether TLD is required.\n   * @returns {string} The validated URL.\n   * @throws {Error} If URL is invalid.\n   */\n  static getUrl(\n    key: string,\n    defaultValue?: string,\n    options: { protocols?: string[]; requireTld?: boolean } = {}\n  ): string {\n    const value = Env.get(key, defaultValue);\n    if (!value) {\n      throw new Error(`Env ${key} is missing or empty`);\n    }\n\n    let url: URL;\n    try {\n      url = new URL(value);\n    } catch {\n      throw new Error(`Env ${key} is not a valid URL`);\n    }\n\n    if (options.protocols && options.protocols.length > 0) {\n      const protocol = url.protocol.replace(':', '');\n      if (!options.protocols.includes(protocol)) {\n        throw new Error(`Env ${key} must use one of the protocols: ${options.protocols.join(', ')}`);\n      }\n    }\n\n    if (options.requireTld === true) {\n      // Check if hostname has a TLD (contains at least one dot and doesn't end with a dot)\n      // localhost, 127.0.0.1, etc. don't have TLDs\n      const hostname = url.hostname;\n      if (\n        !hostname.includes('.') ||\n        hostname === 'localhost' ||\n        /^[\\d.]+$/.test(hostname) || // IP address\n        hostname.endsWith('.')\n      ) {\n        throw new Error(`Env ${key} must have a valid host with TLD`);\n      }\n    }\n\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  static getEmail(key: string, defaultValue?: string): string {\n    const value = Env.get(key, defaultValue);\n\n    if (!value) {\n      if (defaultValue === undefined) {\n        throw new Error(`Email env ${key} is missing`);\n      }\n      return defaultValue;\n    }\n\n    // Simple email validation regex\n    const emailRegex = /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$/;\n    if (!emailRegex.test(value)) {\n      throw new Error(`Env ${key} is not a valid email address`);\n    }\n\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 {object} [options] - Validation options.\n   * @param {boolean} [options.mustExist=false] - Whether path must exist.\n   * @param {boolean} [options.makeAbsolute=true] - Convert relative paths to absolute.\n   * @returns {string} The validated path.\n   * @throws {Error} If path is invalid.\n   */\n  static getPath(\n    key: string,\n    defaultValue?: string,\n    options: { mustExist?: boolean; makeAbsolute?: boolean } = {}\n  ): string {\n    const value = Env.get(key, defaultValue);\n\n    if (!value) {\n      if (defaultValue === undefined) {\n        throw new Error(`Path env ${key} is missing`);\n      }\n      return defaultValue;\n    }\n\n    const path = options.makeAbsolute !== false && !isAbsolute(value) ? resolve(process.cwd(), value) : value;\n\n    if (options.mustExist && !existsSync(path)) {\n      throw new Error(`Path in env ${key} does not exist: ${path}`);\n    }\n\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=3000] - Optional fallback value.\n   * @returns {number} The validated port number.\n   * @throws {Error} If port is invalid.\n   */\n  static getPort(key: string, defaultValue: number = 3000): number {\n    const port = Env.getNumber(key, defaultValue);\n\n    if (port < 0 || port > 65535) {\n      throw new Error(`Env ${key} must be a valid port number (0-65535)`);\n    }\n\n    return port;\n  }\n\n  /**\n   * Retrieves a duration string and converts 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  static getDuration(key: string, defaultValue: string | number = '0'): number {\n    const value = Env.get(key, String(defaultValue));\n\n    if (!value) return 0;\n\n    // Handle plain number input (assume milliseconds)\n    if (/^\\d+$/.test(value)) {\n      return parseInt(value, 10);\n    }\n\n    // Parse duration string like \"1d2h30m15s\"\n    const durationRegex = /(\\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(`Env ${key} has invalid duration format. Use 1d, 2h, 30m, 45s, or 100ms.`);\n    }\n\n    let ms = 0;\n\n    if (matches[1]) ms += parseInt(matches[1], 10) * 86400000; // days\n    if (matches[2]) ms += parseInt(matches[2], 10) * 3600000; // hours\n    if (matches[3]) ms += parseInt(matches[3], 10) * 60000; // minutes\n    if (matches[4]) ms += parseInt(matches[4], 10) * 1000; // seconds\n    if (matches[5]) ms += parseInt(matches[5], 10); // milliseconds\n\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  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\n      safeEnv[key] = isSensitive ? '******' : value;\n    }\n\n    return safeEnv;\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  }\n}\n"]}

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

@@ -1,4 +1,4 @@
-import { ErrorResponse } from "./response.utils";
+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.

package/build/src/utils/exception.utils.js

@@ -33,7 +33,7 @@ class InternalServerErrorException extends response_utils_1.ErrorResponse {
     /**
      * @param message - Optional custom message. Defaults to "Internal server error".
      */
-    constructor(message = "Internal server error") {
+    constructor(message = 'Internal server error') {
         super(message);
         this.status = http_status_codes_1.HttpStatusCodes.INTERNAL_SERVER_ERROR;
     }
@@ -47,7 +47,7 @@ class UnauthorizedException extends response_utils_1.ErrorResponse {
     /**
      * @param message - Optional custom message. Defaults to "Unauthorized".
      */
-    constructor(message = "Unauthorized") {
+    constructor(message = 'Unauthorized') {
         super(message);
         this.status = http_status_codes_1.HttpStatusCodes.UNAUTHORIZED;
     }
@@ -61,7 +61,7 @@ class BadRequestException extends response_utils_1.ErrorResponse {
     /**
      * @param message - Optional custom message. Defaults to "Bad request".
      */
-    constructor(message = "Bad request") {
+    constructor(message = 'Bad request') {
         super(message);
         this.status = http_status_codes_1.HttpStatusCodes.BAD_REQUEST;
     }
@@ -75,7 +75,7 @@ class NotFoundException extends response_utils_1.ErrorResponse {
     /**
      * @param message - Optional custom message. Defaults to "Resource not found".
      */
-    constructor(message = "Resource not found") {
+    constructor(message = 'Resource not found') {
         super(message);
         this.status = http_status_codes_1.HttpStatusCodes.NOT_FOUND;
     }
@@ -89,7 +89,7 @@ class ForbiddenException extends response_utils_1.ErrorResponse {
     /**
      * @param message - Optional custom message. Defaults to "Forbidden".
      */
-    constructor(message = "Forbidden") {
+    constructor(message = 'Forbidden') {
         super(message);
         this.status = http_status_codes_1.HttpStatusCodes.FORBIDDEN;
     }
@@ -103,7 +103,7 @@ class ConflictException extends response_utils_1.ErrorResponse {
     /**
      * @param message - Optional custom message. Defaults to "Conflict".
      */
-    constructor(message = "Conflict") {
+    constructor(message = 'Conflict') {
         super(message);
         this.status = http_status_codes_1.HttpStatusCodes.CONFLICT;
     }
@@ -117,7 +117,7 @@ class BadGatewayException extends response_utils_1.ErrorResponse {
     /**
      * @param message - Optional custom message. Defaults to "Bad Gateway".
      */
-    constructor(message = "Bad Gateway") {
+    constructor(message = 'Bad Gateway') {
         super(message);
         this.status = http_status_codes_1.HttpStatusCodes.BAD_GATEWAY;
     }
@@ -131,7 +131,7 @@ class TooManyRequestsException extends response_utils_1.ErrorResponse {
     /**
      * @param message - Optional custom message. Defaults to "Too many requests".
      */
-    constructor(message = "Too many requests") {
+    constructor(message = 'Too many requests') {
         super(message);
         this.status = http_status_codes_1.HttpStatusCodes.TOO_MANY_REQUESTS;
     }
@@ -145,7 +145,7 @@ class ServiceUnavailableException extends response_utils_1.ErrorResponse {
     /**
      * @param message - Optional custom message. Defaults to "Service Unavailable".
      */
-    constructor(message = "Service Unavailable") {
+    constructor(message = 'Service Unavailable') {
         super(message);
         this.status = http_status_codes_1.HttpStatusCodes.SERVICE_UNAVAILABLE;
     }
@@ -159,7 +159,7 @@ class GatewayTimeoutException extends response_utils_1.ErrorResponse {
     /**
      * @param message - Optional custom message. Defaults to "Gateway Timeout".
      */
-    constructor(message = "Gateway Timeout") {
+    constructor(message = 'Gateway Timeout') {
         super(message);
         this.status = http_status_codes_1.HttpStatusCodes.GATEWAY_TIMEOUT;
     }
@@ -174,7 +174,7 @@ class UnprocessableEntityException extends response_utils_1.ErrorResponse {
      * @param message - Optional custom message. Defaults to "Unprocessable Entity".
      * @param details - Optional validation details or additional error context.
      */
-    constructor(message = "Unprocessable Entity", details) {
+    constructor(message = 'Unprocessable Entity', details) {
         super(message);
         this.details = details;
         this.status = http_status_codes_1.HttpStatusCodes.UNPROCESSABLE_ENTITY;
@@ -190,7 +190,7 @@ class MethodNotAllowedException extends response_utils_1.ErrorResponse {
      * @param message - Optional custom message. Defaults to "Method Not Allowed".
      * @param allowedMethods - Optional array of allowed HTTP methods.
      */
-    constructor(message = "Method Not Allowed", allowedMethods) {
+    constructor(message = 'Method Not Allowed', allowedMethods) {
         super(message);
         this.allowedMethods = allowedMethods;
         this.status = http_status_codes_1.HttpStatusCodes.METHOD_NOT_ALLOWED;
@@ -205,7 +205,7 @@ class NotAcceptableException extends response_utils_1.ErrorResponse {
     /**
      * @param message - Optional custom message. Defaults to "Not Acceptable".
      */
-    constructor(message = "Not Acceptable") {
+    constructor(message = 'Not Acceptable') {
         super(message);
         this.status = http_status_codes_1.HttpStatusCodes.NOT_ACCEPTABLE;
     }
@@ -219,7 +219,7 @@ class RequestTimeoutException extends response_utils_1.ErrorResponse {
     /**
      * @param message - Optional custom message. Defaults to "Request Timeout".
      */
-    constructor(message = "Request Timeout") {
+    constructor(message = 'Request Timeout') {
         super(message);
         this.status = http_status_codes_1.HttpStatusCodes.REQUEST_TIMEOUT;
     }
@@ -233,7 +233,7 @@ class UnsupportedMediaTypeException extends response_utils_1.ErrorResponse {
     /**
      * @param message - Optional custom message. Defaults to "Unsupported Media Type".
      */
-    constructor(message = "Unsupported Media Type") {
+    constructor(message = 'Unsupported Media Type') {
         super(message);
         this.status = http_status_codes_1.HttpStatusCodes.UNSUPPORTED_MEDIA_TYPE;
     }
@@ -247,7 +247,7 @@ class PayloadTooLargeException extends response_utils_1.ErrorResponse {
     /**
      * @param message - Optional custom message. Defaults to "Payload Too Large".
      */
-    constructor(message = "Payload Too Large") {
+    constructor(message = 'Payload Too Large') {
         super(message);
         this.status = http_status_codes_1.HttpStatusCodes.PAYLOAD_TOO_LARGE;
     }
@@ -261,7 +261,7 @@ class InsufficientStorageException extends response_utils_1.ErrorResponse {
     /**
      * @param message - Optional custom message. Defaults to "Insufficient Storage".
      */
-    constructor(message = "Insufficient Storage") {
+    constructor(message = 'Insufficient Storage') {
         super(message);
         this.status = http_status_codes_1.HttpStatusCodes.INSUFFICIENT_STORAGE;
     }
@@ -303,7 +303,7 @@ function createHttpError(status, message) {
         case http_status_codes_1.HttpStatusCodes.CONFLICT:
             return new ConflictException(message);
         case http_status_codes_1.HttpStatusCodes.GONE:
-            return new HttpError(http_status_codes_1.HttpStatusCodes.GONE, message || "Gone");
+            return new HttpError(http_status_codes_1.HttpStatusCodes.GONE, message || 'Gone');
         case http_status_codes_1.HttpStatusCodes.PAYLOAD_TOO_LARGE:
             return new PayloadTooLargeException(message);
         case http_status_codes_1.HttpStatusCodes.UNSUPPORTED_MEDIA_TYPE:
@@ -333,10 +333,7 @@ function createHttpError(status, message) {
  * @returns True if object has error-like structure.
  */
 function hasErrorShape(error) {
-    return (typeof error === "object" &&
-        error !== null &&
-        "message" in error &&
-        typeof error.message === "string");
+    return (typeof error === 'object' && error !== null && 'message' in error && typeof error.message === 'string');
 }
 /**
  * Safely extracts message from any error type.
@@ -345,7 +342,7 @@ function hasErrorShape(error) {
  * @returns A string error message.
  */
 function getErrorMessage(error) {
-    if (typeof error === "string") {
+    if (typeof error === 'string') {
         return error;
     }
     if (error instanceof Error) {
@@ -354,7 +351,7 @@ function getErrorMessage(error) {
     if (hasErrorShape(error)) {
         return error.message;
     }
-    return "Unknown error occurred";
+    return 'Unknown error occurred';
 }
 /**
  * Wraps a function and transforms any errors into HTTP errors.
@@ -373,10 +370,10 @@ function withErrorHandling(handler) {
                 throw error;
             }
             // Log the original error (consider using a proper logger)
-            (0, logger_utils_1.getLogger)().error("Caught error in handler:", error);
+            (0, logger_utils_1.getLogger)().error('Caught error in handler:', error);
             // Extract status code if it exists, otherwise use 500
             let status = http_status_codes_1.HttpStatusCodes.INTERNAL_SERVER_ERROR;
-            if (hasErrorShape(error) && typeof error.status === "number") {
+            if (hasErrorShape(error) && typeof error.status === 'number') {
                 status = error.status;
             }
             // Create appropriate HTTP error

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

@@ -1 +1 @@
-{"version":3,"file":"exception.utils.js","sourceRoot":"","sources":["../../../src/utils/exception.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { 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(\n  status: number,\n  message?: string,\n): 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(\n  error: unknown,\n): error is { message: string; status?: number; code?: string } {\n  return (\n    typeof error === \"object\" &&\n    error !== null &&\n    \"message\" in error &&\n    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 (error) {\n      if (isHttpError(error)) {\n        throw error;\n      }\n\n      // Log the original error (consider using a proper logger)\n      getLogger().error(\"Caught error in handler:\", error);\n\n      // Extract status code if it exists, otherwise use 500\n      let status = HttpStatusCodes.INTERNAL_SERVER_ERROR;\n      if (hasErrorShape(error) && typeof error.status === \"number\") {\n        status = error.status;\n      }\n\n      // Create appropriate HTTP error\n      throw createHttpError(status, getErrorMessage(error));\n    }\n  };\n}\n"]}
+{"version":3,"file":"exception.utils.js","sourceRoot":"","sources":["../../../src/utils/exception.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { 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 (error) {\n      if (isHttpError(error)) {\n        throw error;\n      }\n\n      // Log the original error (consider using a proper logger)\n      getLogger().error('Caught error in handler:', error);\n\n      // Extract status code if it exists, otherwise use 500\n      let status = HttpStatusCodes.INTERNAL_SERVER_ERROR;\n      if (hasErrorShape(error) && typeof error.status === 'number') {\n        status = error.status;\n      }\n\n      // Create appropriate HTTP error\n      throw createHttpError(status, getErrorMessage(error));\n    }\n  };\n}\n"]}

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

@@ -1,5 +1,5 @@
-import { BufferEncoding } from "./crypto.utils";
-import { Stats } from "fs";
+import { BufferEncoding } from './crypto.utils';
+import { Stats } from 'fs';
 /**
  * Checks whether a file or directory exists at the given path.
  *
@@ -91,7 +91,7 @@ export declare function getFileStats(path: string): Promise<Stats | null>;
  * @param {string | Buffer} [options.content] - Optional content to write to the file.
  * @returns {Promise<string>} Path to the created temporary file.
  */
-export declare function createTempFile({ prefix, extension, dir, content, }?: {
+export declare function createTempFile({ prefix, extension, dir, content }?: {
     prefix?: string;
     extension?: string;
     dir?: string;

package/build/src/utils/fs.utils.js

@@ -51,7 +51,7 @@ async function fileExists(path) {
  */
 async function readJsonFile(path) {
     try {
-        const data = await promises_1.default.readFile(path, "utf-8");
+        const data = await promises_1.default.readFile(path, 'utf-8');
         return JSON.parse(data);
     }
     catch (_a) {
@@ -68,7 +68,7 @@ async function readJsonFile(path) {
  */
 async function writeJsonFile(path, data, space = 2) {
     const json = JSON.stringify(data, null, space);
-    await promises_1.default.writeFile(path, json, "utf-8");
+    await promises_1.default.writeFile(path, json, 'utf-8');
 }
 /**
  * Deletes a file if it exists.
@@ -82,7 +82,7 @@ async function deleteFileIfExists(path) {
         return true;
     }
     catch (err) {
-        if (err.code === "ENOENT")
+        if (err.code === 'ENOENT')
             return true;
         return false;
     }
@@ -94,7 +94,7 @@ async function deleteFileIfExists(path) {
  * @param {BufferEncoding} [encoding="utf-8"] - The encoding to use.
  * @returns {Promise<string | null>} The file contents, or `null` if reading fails.
  */
-async function readTextFile(path, encoding = "utf-8") {
+async function readTextFile(path, encoding = 'utf-8') {
     try {
         return await promises_1.default.readFile(path, encoding);
     }
@@ -110,7 +110,7 @@ async function readTextFile(path, encoding = "utf-8") {
  * @param {BufferEncoding} [encoding="utf-8"] - The encoding to use.
  * @returns {Promise<boolean>} Resolves to `true` if successful, `false` otherwise.
  */
-async function writeTextFile(path, content, encoding = "utf-8") {
+async function writeTextFile(path, content, encoding = 'utf-8') {
     try {
         await promises_1.default.writeFile(path, content, encoding);
         return true;
@@ -127,7 +127,7 @@ async function writeTextFile(path, content, encoding = "utf-8") {
  * @param {BufferEncoding} [encoding="utf-8"] - The encoding to use.
  * @returns {Promise<boolean>} Resolves to `true` if successful, `false` otherwise.
  */
-async function appendTextFile(path, content, encoding = "utf-8") {
+async function appendTextFile(path, content, encoding = 'utf-8') {
     try {
         await promises_1.default.appendFile(path, content, encoding);
         return true;
@@ -202,19 +202,15 @@ async function getFileStats(path) {
  * @param {string | Buffer} [options.content] - Optional content to write to the file.
  * @returns {Promise<string>} Path to the created temporary file.
  */
-async function createTempFile({ prefix = "tmp-", extension = "", dir = (0, os_1.tmpdir)(), content, } = {}) {
-    const ext = extension
-        ? extension.startsWith(".")
-            ? extension
-            : `.${extension}`
-        : "";
+async function createTempFile({ prefix = 'tmp-', extension = '', dir = (0, os_1.tmpdir)(), content } = {}) {
+    const ext = extension ? (extension.startsWith('.') ? extension : `.${extension}`) : '';
     const filename = `${prefix}${(0, crypto_1.randomUUID)()}${ext}`;
     const filepath = path_1.default.join(dir, filename);
     if (content) {
         await promises_1.default.writeFile(filepath, content);
     }
     else {
-        await promises_1.default.writeFile(filepath, "");
+        await promises_1.default.writeFile(filepath, '');
     }
     return filepath;
 }
@@ -254,10 +250,10 @@ async function readDirectory(dirPath, options = {}) {
     const files = await promises_1.default.readdir(dirPath);
     let result = files;
     if (options.filter) {
-        result = result.filter((file) => options.filter.test(file));
+        result = result.filter(file => options.filter.test(file));
     }
     if (options.fullPaths) {
-        result = result.map((file) => path_1.default.join(dirPath, file));
+        result = result.map(file => path_1.default.join(dirPath, file));
     }
     return result;
 }
@@ -275,7 +271,7 @@ async function createDirectory(dirPath, recursive = true) {
     }
     catch (err) {
         // Consider it success if directory already exists
-        return err.code === "EEXIST";
+        return err.code === 'EEXIST';
     }
 }
 /**
@@ -287,7 +283,7 @@ async function createDirectory(dirPath, recursive = true) {
  */
 async function safeReadJsonFile(path) {
     try {
-        const content = await promises_1.default.readFile(path, "utf-8");
+        const content = await promises_1.default.readFile(path, 'utf-8');
         try {
             const data = JSON.parse(content);
             return { data, error: null };
@@ -295,14 +291,14 @@ async function safeReadJsonFile(path) {
         catch (error) {
             return {
                 data: null,
-                error: new Error(`Invalid JSON in file ${path}: ${error.message}`),
+                error: new Error(`Invalid JSON in file ${path}: ${error.message}`)
             };
         }
     }
     catch (error) {
         return {
             data: null,
-            error: new Error(`Failed to read file ${path}: ${error.message}`),
+            error: new Error(`Failed to read file ${path}: ${error.message}`)
         };
     }
 }