@catbee/utils 1.0.3 → 1.0.5

package/LICENSE

@@ -1,6 +1,6 @@
 The MIT License
 
-Copyright (c) 2025 Catbee Technologies. https://catbee-utils.npm.hprasath.com/license
+Copyright (c) 2025 Catbee Technologies. https://catbee.npm.hprasath.com/license
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -77,31 +77,31 @@ console.log(isEmail("user@example.com")); // true
 
 | Module | Description |
 | ------ | ----------- |
-| [Express Server](https://catbee-utils.npm.hprasath.com/docs/express-server) | Fast, secure, and scalable server setup |
-| [Array Utilities](https://catbee-utils.npm.hprasath.com/docs/utils/array) | Advanced array manipulation |
-| [Async Utilities](https://catbee-utils.npm.hprasath.com/docs/utils/async) | Promise helpers, concurrency, timing |
-| [Cache Utilities](https://catbee-utils.npm.hprasath.com/docs/utils/cache) | In-memory caching with TTL |
-| [Context Store](https://catbee-utils.npm.hprasath.com/docs/utils/context-store) | Per-request context via AsyncLocalStorage |
-| [Crypto Utilities](https://catbee-utils.npm.hprasath.com/docs/utils/crypto) | Hashing, encryption, tokens |
-| [Date Utilities](https://catbee-utils.npm.hprasath.com/docs/utils/date) | Date/time manipulation |
-| [Decorators Utilities](https://catbee-utils.npm.hprasath.com/docs/utils/decorators) | TypeScript decorators for Express |
-| [Directory Utilities](https://catbee-utils.npm.hprasath.com/docs/utils/directory) | Directory and file system helpers |
-| [Environment Utilities](https://catbee-utils.npm.hprasath.com/docs/utils/environment) | Env variable management |
-| [Exception Utilities](https://catbee-utils.npm.hprasath.com/docs/utils/exception) | HTTP and error handling |
-| [File System Utilities](https://catbee-utils.npm.hprasath.com/docs/utils/file-system) | File operations |
-| [HTTP Status Codes](https://catbee-utils.npm.hprasath.com/docs/utils/http-status-codes) | Typed status codes |
-| [ID Utilities](https://catbee-utils.npm.hprasath.com/docs/utils/id) | UUID and ID generation |
-| [Logger Utilities](https://catbee-utils.npm.hprasath.com/docs/utils/logger) | Structured logging with Pino |
-| [Middleware Utilities](https://catbee-utils.npm.hprasath.com/docs/utils/middleware) | Express middleware collection |
-| [Object Utilities](https://catbee-utils.npm.hprasath.com/docs/utils/object) | Deep merge, flatten, pick/omit, etc. |
-| [Performance Utilities](https://catbee-utils.npm.hprasath.com/docs/utils/performance) | Timing, memoization, memory tracking |
-| [Request Utilities](https://catbee-utils.npm.hprasath.com/docs/utils/request) | HTTP request parameter parsing/validation |
-| [Response Utilities](https://catbee-utils.npm.hprasath.com/docs/utils/response) | Standardized API response formatting |
-| [Stream Utilities](https://catbee-utils.npm.hprasath.com/docs/utils/stream) | Stream conversion, batching, throttling, line splitting |
-| [String Utilities](https://catbee-utils.npm.hprasath.com/docs/utils/string) | Casing, masking, slugifying, formatting |
-| [Type Utilities](https://catbee-utils.npm.hprasath.com/docs/utils/type) | Type checking, conversion, guards |
-| [URL Utilities](https://catbee-utils.npm.hprasath.com/docs/utils/url) | URL parsing, query manipulation, normalization |
-| [Validate Utilities](https://catbee-utils.npm.hprasath.com/docs/utils/validation) | Input validation functions |
+| [Express Server](https://catbee.npm.hprasath.com/docs/@catbee/utils/express-server) | Fast, secure, and scalable server setup |
+| [Array Utilities](https://catbee.npm.hprasath.com/docs/@catbee/utils/modules/array) | Advanced array manipulation |
+| [Async Utilities](https://catbee.npm.hprasath.com/docs/@catbee/utils/modules/async) | Promise helpers, concurrency, timing |
+| [Cache Utilities](https://catbee.npm.hprasath.com/docs/@catbee/utils/modules/cache) | In-memory caching with TTL |
+| [Context Store](https://catbee.npm.hprasath.com/docs/@catbee/utils/modules/context-store) | Per-request context via AsyncLocalStorage |
+| [Crypto Utilities](https://catbee.npm.hprasath.com/docs/@catbee/utils/modules/crypto) | Hashing, encryption, tokens |
+| [Date Utilities](https://catbee.npm.hprasath.com/docs/@catbee/utils/modules/date) | Date/time manipulation |
+| [Decorators Utilities](https://catbee.npm.hprasath.com/docs/@catbee/utils/modules/decorators) | TypeScript decorators for Express |
+| [Directory Utilities](https://catbee.npm.hprasath.com/docs/@catbee/utils/modules/directory) | Directory and file system helpers |
+| [Environment Utilities](https://catbee.npm.hprasath.com/docs/@catbee/utils/modules/environment) | Env variable management |
+| [Exception Utilities](https://catbee.npm.hprasath.com/docs/@catbee/utils/modules/exception) | HTTP and error handling |
+| [File System Utilities](https://catbee.npm.hprasath.com/docs/@catbee/utils/modules/file-system) | File operations |
+| [HTTP Status Codes](https://catbee.npm.hprasath.com/docs/@catbee/utils/modules/http-status-codes) | Typed status codes |
+| [ID Utilities](https://catbee.npm.hprasath.com/docs/@catbee/utils/modules/id) | UUID and ID generation |
+| [Logger Utilities](https://catbee.npm.hprasath.com/docs/@catbee/utils/modules/logger) | Structured logging with Pino |
+| [Middleware Utilities](https://catbee.npm.hprasath.com/docs/@catbee/utils/modules/middleware) | Express middleware collection |
+| [Object Utilities](https://catbee.npm.hprasath.com/docs/@catbee/utils/modules/object) | Deep merge, flatten, pick/omit, etc. |
+| [Performance Utilities](https://catbee.npm.hprasath.com/docs/@catbee/utils/modules/performance) | Timing, memoization, memory tracking |
+| [Request Utilities](https://catbee.npm.hprasath.com/docs/@catbee/utils/modules/request) | HTTP request parameter parsing/validation |
+| [Response Utilities](https://catbee.npm.hprasath.com/docs/@catbee/utils/modules/response) | Standardized API response formatting |
+| [Stream Utilities](https://catbee.npm.hprasath.com/docs/@catbee/utils/modules/stream) | Stream conversion, batching, throttling, line splitting |
+| [String Utilities](https://catbee.npm.hprasath.com/docs/@catbee/utils/modules/string) | Casing, masking, slugifying, formatting |
+| [Type Utilities](https://catbee.npm.hprasath.com/docs/@catbee/utils/modules/type) | Type checking, conversion, guards |
+| [URL Utilities](https://catbee.npm.hprasath.com/docs/@catbee/utils/modules/url) | URL parsing, query manipulation, normalization |
+| [Validate Utilities](https://catbee.npm.hprasath.com/docs/@catbee/utils/modules/validation) | Input validation functions |
 
 ---
 
@@ -117,10 +117,10 @@ import { chunk, sleep, TTLCache, getLogger } from "@catbee/utils";
 
 ## 📖 Documentation
 
-- [Full API Docs & Examples](https://catbee-utils.npm.hprasath.com)
+- [Full API Docs & Examples](https://catbee.npm.hprasath.com/docs/@catbee/utils/intro)
 
 ---
 
 ## 📜 License
 
-MIT © catbee-technologies
+MIT © Catbee Technologies (see the [LICENSE](https://catbee.npm.hprasath.com/license/) file for the full text)

package/build/index.cjs

@@ -29,7 +29,7 @@ var https__default = /*#__PURE__*/_interopDefault(https);
 /*
  * The MIT License
  * 
- * Copyright (c) 2025 Catbee Technologies. https://catbee-utils.npm.hprasath.com/license
+ * Copyright (c) 2025 Catbee Technologies. https://catbee.npm.hprasath.com/license
  * 
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -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}`);
@@ -6663,7 +6663,7 @@ var ExpressServer = class _ExpressServer {
           const skip = this.config.requestLogging?.ignorePaths?.(req, res);
           if (skip) return next();
         } else if (Array.isArray(this.config.requestLogging?.ignorePaths)) {
-          const skip = this.config.requestLogging?.ignorePaths?.includes(req.path);
+          const skip = this.config.requestLogging?.ignorePaths?.some((path3) => req.path.startsWith(path3));
           if (skip) return next();
         }
         const logger2 = getLogger();

package/build/index.d.ts

@@ -1,7 +1,7 @@
 /*
  * The MIT License
  * 
- * Copyright (c) 2025 Catbee Technologies. https://catbee-utils.npm.hprasath.com/license
+ * Copyright (c) 2025 Catbee Technologies. https://catbee.npm.hprasath.com/license
  * 
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -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

@@ -17,7 +17,7 @@ import https from 'https';
 /*
  * The MIT License
  * 
- * Copyright (c) 2025 Catbee Technologies. https://catbee-utils.npm.hprasath.com/license
+ * Copyright (c) 2025 Catbee Technologies. https://catbee.npm.hprasath.com/license
  * 
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -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}`);
@@ -6651,7 +6651,7 @@ var ExpressServer = class _ExpressServer {
           const skip = this.config.requestLogging?.ignorePaths?.(req, res);
           if (skip) return next();
         } else if (Array.isArray(this.config.requestLogging?.ignorePaths)) {
-          const skip = this.config.requestLogging?.ignorePaths?.includes(req.path);
+          const skip = this.config.requestLogging?.ignorePaths?.some((path3) => req.path.startsWith(path3));
           if (skip) return next();
         }
         const logger2 = getLogger();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@catbee/utils",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "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",