@catbee/utils 1.0.3 → 1.0.4

package/build/index.cjs

@@ -402,17 +402,17 @@ var Env = class _Env {
   *
   * @typeParam T - The allowed value type (string literal types).
   * @param {string} key - The environment variable key.
-  * @param {T[]} allowedValues - Array of accepted string values.
   * @param {T} [defaultValue] - Optional fallback value.
+  * @param {T[]} allowedValues - Array of accepted string values.
   * @returns {T} The validated environment value.
   * @throws {Error} If missing or invalid.
   *
   * @example
   * // If LOG_LEVEL=debug
-  * const level = Env.getEnum('LOG_LEVEL', ['debug', 'info', 'warn', 'error'] as const, 'info');
+  * const level = Env.getEnum('LOG_LEVEL', 'info', ['debug', 'info', 'warn', 'error'] as const);
   * // 'debug' (typed as 'debug' | 'info' | 'warn' | 'error')
   */
-  static getEnum(key, allowedValues, defaultValue) {
+  static getEnum(key, defaultValue, allowedValues) {
     const value = process.env[key];
     if (!value) {
       return defaultValue;
@@ -426,15 +426,15 @@ var Env = class _Env {
   * Retrieves an enum-like numeric environment variable.
   *
   * @param {string} key - The environment variable key.
-  * @param {number[]} allowedValues - Array of accepted values.
   * @param {number} defaultValue - Default value if not present.
+  * @param {number[]} allowedValues - Array of accepted values.
   * @returns {number} The validated value.
   *
   * @example
   * // If NODE_VERSION=16
-  * const version = Env.getNumberEnum('NODE_VERSION', [14, 16, 18], 16);
+  * const version = Env.getNumberEnum('NODE_VERSION', 16, [14, 16, 18]);
   */
-  static getNumberEnum(key, allowedValues, defaultValue) {
+  static getNumberEnum(key, defaultValue, allowedValues) {
     const value = _Env.getNumber(key, defaultValue);
     if (!allowedValues.includes(value)) {
       throw new Error(`Environment variable '${key}' must be one of: ${allowedValues.join(", ")}. Received: ${value}`);

package/build/index.d.ts

@@ -2437,30 +2437,30 @@ declare class Env {
      *
      * @typeParam T - The allowed value type (string literal types).
      * @param {string} key - The environment variable key.
-     * @param {T[]} allowedValues - Array of accepted string values.
      * @param {T} [defaultValue] - Optional fallback value.
+     * @param {T[]} allowedValues - Array of accepted string values.
      * @returns {T} The validated environment value.
      * @throws {Error} If missing or invalid.
      *
      * @example
      * // If LOG_LEVEL=debug
-     * const level = Env.getEnum('LOG_LEVEL', ['debug', 'info', 'warn', 'error'] as const, 'info');
+     * const level = Env.getEnum('LOG_LEVEL', 'info', ['debug', 'info', 'warn', 'error'] as const);
      * // 'debug' (typed as 'debug' | 'info' | 'warn' | 'error')
      */
-    static getEnum<T extends string>(key: string, allowedValues: readonly T[], defaultValue: T): T;
+    static getEnum<T extends string>(key: string, defaultValue: T, allowedValues: readonly T[]): T;
     /**
      * Retrieves an enum-like numeric environment variable.
      *
      * @param {string} key - The environment variable key.
-     * @param {number[]} allowedValues - Array of accepted values.
      * @param {number} defaultValue - Default value if not present.
+     * @param {number[]} allowedValues - Array of accepted values.
      * @returns {number} The validated value.
      *
      * @example
      * // If NODE_VERSION=16
-     * const version = Env.getNumberEnum('NODE_VERSION', [14, 16, 18], 16);
+     * const version = Env.getNumberEnum('NODE_VERSION', 16, [14, 16, 18]);
      */
-    static getNumberEnum(key: string, allowedValues: number[], defaultValue: number): number;
+    static getNumberEnum(key: string, defaultValue: number, allowedValues: number[]): number;
     /**
      * Retrieves a URL environment variable and validates it.
      *

package/build/index.mjs

@@ -390,17 +390,17 @@ var Env = class _Env {
   *
   * @typeParam T - The allowed value type (string literal types).
   * @param {string} key - The environment variable key.
-  * @param {T[]} allowedValues - Array of accepted string values.
   * @param {T} [defaultValue] - Optional fallback value.
+  * @param {T[]} allowedValues - Array of accepted string values.
   * @returns {T} The validated environment value.
   * @throws {Error} If missing or invalid.
   *
   * @example
   * // If LOG_LEVEL=debug
-  * const level = Env.getEnum('LOG_LEVEL', ['debug', 'info', 'warn', 'error'] as const, 'info');
+  * const level = Env.getEnum('LOG_LEVEL', 'info', ['debug', 'info', 'warn', 'error'] as const);
   * // 'debug' (typed as 'debug' | 'info' | 'warn' | 'error')
   */
-  static getEnum(key, allowedValues, defaultValue) {
+  static getEnum(key, defaultValue, allowedValues) {
     const value = process.env[key];
     if (!value) {
       return defaultValue;
@@ -414,15 +414,15 @@ var Env = class _Env {
   * Retrieves an enum-like numeric environment variable.
   *
   * @param {string} key - The environment variable key.
-  * @param {number[]} allowedValues - Array of accepted values.
   * @param {number} defaultValue - Default value if not present.
+  * @param {number[]} allowedValues - Array of accepted values.
   * @returns {number} The validated value.
   *
   * @example
   * // If NODE_VERSION=16
-  * const version = Env.getNumberEnum('NODE_VERSION', [14, 16, 18], 16);
+  * const version = Env.getNumberEnum('NODE_VERSION', 16, [14, 16, 18]);
   */
-  static getNumberEnum(key, allowedValues, defaultValue) {
+  static getNumberEnum(key, defaultValue, allowedValues) {
     const value = _Env.getNumber(key, defaultValue);
     if (!allowedValues.includes(value)) {
       throw new Error(`Environment variable '${key}' must be one of: ${allowedValues.join(", ")}. Received: ${value}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@catbee/utils",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "A modular, production-grade utility toolkit for Node.js and TypeScript, designed for robust, scalable applications (including Express-based services). All utilities are tree-shakable and can be imported independently.",
   "main": "build/index.cjs",
   "module": "build/index.mjs",