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

package/build/esm/utils/type.utils.js

@@ -95,7 +95,7 @@ export function getTypeOf(value) {
 export function isArrayOf(value, itemTypeGuard) {
     if (!Array.isArray(value))
         return false;
-    return value.every(function (item) { return itemTypeGuard(item); });
+    return value.every(item => itemTypeGuard(item));
 }
 /**
  * Convert a value to a string.
@@ -104,8 +104,7 @@ export function isArrayOf(value, itemTypeGuard) {
  * @param defaultValue - Default value if conversion fails
  * @returns String representation of the value
  */
-export function toStr(value, defaultValue) {
-    if (defaultValue === void 0) { defaultValue = ''; }
+export function toStr(value, defaultValue = '') {
     if (value === null || value === undefined)
         return defaultValue;
     try {
@@ -114,7 +113,7 @@ export function toStr(value, defaultValue) {
         }
         return String(value);
     }
-    catch (_a) {
+    catch {
         return defaultValue;
     }
 }
@@ -125,17 +124,16 @@ export function toStr(value, defaultValue) {
  * @param defaultValue - Default value if conversion fails
  * @returns Numeric representation of the value
  */
-export function toNum(value, defaultValue) {
-    if (defaultValue === void 0) { defaultValue = 0; }
+export function toNum(value, defaultValue = 0) {
     if (value === null || value === undefined)
         return defaultValue;
     if (typeof value === 'number')
         return value;
     try {
-        var num = Number(value);
+        const num = Number(value);
         return isNaN(num) ? defaultValue : num;
     }
-    catch (_a) {
+    catch {
         return defaultValue;
     }
 }
@@ -146,14 +144,13 @@ export function toNum(value, defaultValue) {
  * @param defaultValue - Default value if conversion fails
  * @returns Boolean representation of the value
  */
-export function toBool(value, defaultValue) {
-    if (defaultValue === void 0) { defaultValue = false; }
+export function toBool(value, defaultValue = false) {
     if (value === null || value === undefined)
         return defaultValue;
     if (typeof value === 'boolean')
         return value;
     if (typeof value === 'string') {
-        var lowercased = value.toLowerCase();
+        const lowercased = value.toLowerCase();
         if (lowercased === 'true' || lowercased === 'yes' || lowercased === 'y' || lowercased === '1') {
             return true;
         }
@@ -187,4 +184,3 @@ export function ensureType(value, expectedType, defaultValue) {
     }
     return defaultValue;
 }
-//# sourceMappingURL=type.utils.js.map

package/build/esm/utils/url.utils.d.ts

@@ -138,4 +138,3 @@ export declare function getExtension(url: string): string;
  * // → { page: 2, q: 'test' }
  */
 export declare function parseTypedQueryParams<T extends Record<string, any>>(url: string, converters?: Record<keyof T, (val: string) => any>): Partial<T>;
-//# sourceMappingURL=url.utils.d.ts.map

package/build/esm/utils/url.utils.js

@@ -21,33 +21,6 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  */
-var __values = (this && this.__values) || function(o) {
-    var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
-    if (m) return m.call(o);
-    if (o && typeof o.length === "number") return {
-        next: function () {
-            if (o && i >= o.length) o = void 0;
-            return { value: o && o[i++], done: !o };
-        }
-    };
-    throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
-};
-var __read = (this && this.__read) || function (o, n) {
-    var m = typeof Symbol === "function" && o[Symbol.iterator];
-    if (!m) return o;
-    var i = m.call(o), r, ar = [], e;
-    try {
-        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
-    }
-    catch (error) { e = { error: error }; }
-    finally {
-        try {
-            if (r && !r.done && (m = i["return"])) m.call(i);
-        }
-        finally { if (e) throw e.error; }
-    }
-    return ar;
-};
 import { URL, URLSearchParams } from 'url';
 /**
  * Appends query parameters to a given URL.
@@ -61,20 +34,9 @@ import { URL, URLSearchParams } from 'url';
  * // → 'https://example.com/?page=1&limit=10'
  */
 export function appendQueryParams(url, params) {
-    var e_1, _a;
-    var urlObj = new URL(url);
-    try {
-        for (var _b = __values(Object.entries(params)), _c = _b.next(); !_c.done; _c = _b.next()) {
-            var _d = __read(_c.value, 2), key = _d[0], value = _d[1];
-            urlObj.searchParams.set(key, value.toString());
-        }
-    }
-    catch (e_1_1) { e_1 = { error: e_1_1 }; }
-    finally {
-        try {
-            if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
-        }
-        finally { if (e_1) throw e_1.error; }
+    const urlObj = new URL(url);
+    for (const [key, value] of Object.entries(params)) {
+        urlObj.searchParams.set(key, value.toString());
     }
     return urlObj.toString();
 }
@@ -89,7 +51,7 @@ export function appendQueryParams(url, params) {
  * // → { page: '1', limit: '10' }
  */
 export function parseQueryString(query) {
-    var cleanQuery = query.startsWith('?') ? query.slice(1) : query;
+    const cleanQuery = query.startsWith('?') ? query.slice(1) : query;
     // Object.fromEntries guarantees string values in result
     return Object.fromEntries(new URLSearchParams(cleanQuery));
 }
@@ -100,17 +62,16 @@ export function parseQueryString(query) {
  * @param {boolean} [requireHttps=false] - If true, requires the URL to use HTTPS.
  * @returns {boolean} True if the URL is valid, false otherwise.
  */
-export function isValidUrl(url, requireHttps) {
-    if (requireHttps === void 0) { requireHttps = false; }
+export function isValidUrl(url, requireHttps = false) {
     try {
-        var parsedUrl = new URL(url);
+        const parsedUrl = new URL(url);
         if (!parsedUrl.protocol || !parsedUrl.hostname)
             return false;
         if (requireHttps && parsedUrl.protocol !== 'https:')
             return false;
         return true;
     }
-    catch (_a) {
+    catch {
         return false;
     }
 }
@@ -128,26 +89,25 @@ export function isValidUrl(url, requireHttps) {
  * getDomain('https://api.example.com/path', true);
  * // → 'example.com'
  */
-export function getDomain(url, removeSubdomains) {
-    if (removeSubdomains === void 0) { removeSubdomains = false; }
+export function getDomain(url, removeSubdomains = false) {
     try {
-        var hostname = new URL(url).hostname;
+        const { hostname } = new URL(url);
         if (!removeSubdomains) {
             return hostname;
         }
         // Extract root domain (remove subdomains)
-        var parts = hostname.split('.');
+        const parts = hostname.split('.');
         if (parts.length <= 2)
             return hostname;
         // Handle special cases like co.in, com.au
-        var secondLevelDomains = ['co', 'com', 'org', 'net', 'gov', 'edu', 'ac'];
-        var sld = parts[parts.length - 2];
+        const secondLevelDomains = ['co', 'com', 'org', 'net', 'gov', 'edu', 'ac'];
+        const sld = parts[parts.length - 2];
         if (secondLevelDomains.includes(sld) && parts.length > 2) {
             return parts.slice(-3).join('.');
         }
         return parts.slice(-2).join('.');
     }
-    catch (_a) {
+    catch {
         return '';
     }
 }
@@ -161,14 +121,10 @@ export function getDomain(url, removeSubdomains) {
  * joinPaths('https://example.com/', '/api/', '/users');
  * // → 'https://example.com/api/users'
  */
-export function joinPaths() {
-    var segments = [];
-    for (var _i = 0; _i < arguments.length; _i++) {
-        segments[_i] = arguments[_i];
-    }
-    var result = segments
-        .filter(function (s) { return s !== undefined && s !== null; })
-        .map(function (segment, index) {
+export function joinPaths(...segments) {
+    let result = segments
+        .filter(s => s !== undefined && s !== null)
+        .map((segment, index) => {
         if (index === 0)
             return segment.replace(/\/+$/, '');
         return segment.replace(/^\/+|\/+$/g, '');
@@ -194,17 +150,17 @@ export function normalizeUrl(url, base) {
     try {
         // Handle protocol-relative URLs
         if (url.startsWith('//')) {
-            url = "https:".concat(url);
+            url = `https:${url}`;
         }
         // Resolve relative URLs against a base
-        var parsedUrl = base ? new URL(url, base) : new URL(url);
+        const parsedUrl = base ? new URL(url, base) : new URL(url);
         // Normalize
         parsedUrl.pathname = parsedUrl.pathname.replace(/\/+/g, '/'); // Collapse multiple slashes
         parsedUrl.pathname = parsedUrl.pathname.replace(/\/+$/, ''); // Remove trailing slash
         parsedUrl.hostname = parsedUrl.hostname.toLowerCase();
         return parsedUrl.toString();
     }
-    catch (_a) {
+    catch {
         return url; // Return original if invalid
     }
 }
@@ -228,8 +184,8 @@ export function createUrlBuilder(baseUrl) {
          * @param {Record<string, any>} [params] - Query parameters to add.
          * @returns {string} The complete URL.
          */
-        path: function (path, params) {
-            var url = joinPaths(baseUrl, path);
+        path(path, params) {
+            const url = joinPaths(baseUrl, path);
             return params ? appendQueryParams(url, params) : url;
         },
         /**
@@ -238,7 +194,7 @@ export function createUrlBuilder(baseUrl) {
          * @param {Record<string, any>} params - Query parameters to add.
          * @returns {string} The complete URL with query parameters.
          */
-        query: function (params) {
+        query(params) {
             return appendQueryParams(baseUrl, params);
         }
     };
@@ -251,29 +207,18 @@ export function createUrlBuilder(baseUrl) {
  * @returns {Record<string, string>} Object containing the extracted parameters.
  */
 export function extractQueryParams(url, paramNames) {
-    var e_2, _a;
     try {
-        var parsedUrl = new URL(url);
-        var result = {};
-        try {
-            for (var paramNames_1 = __values(paramNames), paramNames_1_1 = paramNames_1.next(); !paramNames_1_1.done; paramNames_1_1 = paramNames_1.next()) {
-                var name_1 = paramNames_1_1.value;
-                var value = parsedUrl.searchParams.get(name_1);
-                if (value !== null) {
-                    result[name_1] = value;
-                }
-            }
-        }
-        catch (e_2_1) { e_2 = { error: e_2_1 }; }
-        finally {
-            try {
-                if (paramNames_1_1 && !paramNames_1_1.done && (_a = paramNames_1.return)) _a.call(paramNames_1);
+        const parsedUrl = new URL(url);
+        const result = {};
+        for (const name of paramNames) {
+            const value = parsedUrl.searchParams.get(name);
+            if (value !== null) {
+                result[name] = value;
             }
-            finally { if (e_2) throw e_2.error; }
         }
         return result;
     }
-    catch (_b) {
+    catch {
         return {};
     }
 }
@@ -285,25 +230,14 @@ export function extractQueryParams(url, paramNames) {
  * @returns {string} URL with parameters removed.
  */
 export function removeQueryParams(url, paramsToRemove) {
-    var e_3, _a;
     try {
-        var parsedUrl = new URL(url);
-        try {
-            for (var paramsToRemove_1 = __values(paramsToRemove), paramsToRemove_1_1 = paramsToRemove_1.next(); !paramsToRemove_1_1.done; paramsToRemove_1_1 = paramsToRemove_1.next()) {
-                var param = paramsToRemove_1_1.value;
-                parsedUrl.searchParams.delete(param);
-            }
-        }
-        catch (e_3_1) { e_3 = { error: e_3_1 }; }
-        finally {
-            try {
-                if (paramsToRemove_1_1 && !paramsToRemove_1_1.done && (_a = paramsToRemove_1.return)) _a.call(paramsToRemove_1);
-            }
-            finally { if (e_3) throw e_3.error; }
+        const parsedUrl = new URL(url);
+        for (const param of paramsToRemove) {
+            parsedUrl.searchParams.delete(param);
         }
         return parsedUrl.toString();
     }
-    catch (_b) {
+    catch {
         return url;
     }
 }
@@ -319,13 +253,13 @@ export function removeQueryParams(url, paramsToRemove) {
  */
 export function getExtension(url) {
     try {
-        var pathname = new URL(url).pathname;
-        var match = pathname.match(/\.([^./\\?#]+)$/);
+        const { pathname } = new URL(url);
+        const match = pathname.match(/\.([^./\\?#]+)$/);
         return match ? match[1].toLowerCase() : '';
     }
-    catch (_a) {
+    catch {
         // If URL parsing fails, try a simpler approach
-        var match = url.match(/\.([^./\\?#]+)$/);
+        const match = url.match(/\.([^./\\?#]+)$/);
         return match ? match[1].toLowerCase() : '';
     }
 }
@@ -345,37 +279,25 @@ export function getExtension(url) {
  * // → { page: 2, q: 'test' }
  */
 export function parseTypedQueryParams(url, converters) {
-    var e_4, _a;
     try {
-        var searchParams = new URL(url).searchParams;
-        var result = {};
-        try {
-            for (var _b = __values(searchParams.entries()), _c = _b.next(); !_c.done; _c = _b.next()) {
-                var _d = __read(_c.value, 2), key = _d[0], value = _d[1];
-                if (converters && key in converters) {
-                    try {
-                        result[key] = converters[key](value);
-                    }
-                    catch (_e) {
-                        // Skip on conversion error
-                    }
+        const { searchParams } = new URL(url);
+        const result = {};
+        for (const [key, value] of searchParams.entries()) {
+            if (converters && key in converters) {
+                try {
+                    result[key] = converters[key](value);
                 }
-                else {
-                    result[key] = value;
+                catch {
+                    // Skip on conversion error
                 }
             }
-        }
-        catch (e_4_1) { e_4 = { error: e_4_1 }; }
-        finally {
-            try {
-                if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+            else {
+                result[key] = value;
             }
-            finally { if (e_4) throw e_4.error; }
         }
         return result;
     }
-    catch (_f) {
+    catch {
         return {};
     }
 }
-//# sourceMappingURL=url.utils.js.map

package/build/esm/utils/validate.utils.d.ts

@@ -174,4 +174,3 @@ export declare function matchesPattern(str: string, pattern: RegExp): boolean;
  * @returns {boolean} True if value passes all validations.
  */
 export declare function validateAll(value: unknown, validators: Array<(value: unknown) => boolean>): boolean;
-//# sourceMappingURL=validate.utils.d.ts.map

package/build/esm/utils/validate.utils.js

@@ -21,22 +21,6 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  */
-var __read = (this && this.__read) || function (o, n) {
-    var m = typeof Symbol === "function" && o[Symbol.iterator];
-    if (!m) return o;
-    var i = m.call(o), r, ar = [], e;
-    try {
-        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
-    }
-    catch (error) { e = { error: error }; }
-    finally {
-        try {
-            if (r && !r.done && (m = i["return"])) m.call(i);
-        }
-        finally { if (e) throw e.error; }
-    }
-    return ar;
-};
 /**
  * Collection of common validation helpers for strings, numbers, email, UUID, etc.
  */
@@ -47,7 +31,7 @@ var __read = (this && this.__read) || function (o, n) {
  * @returns True if valid port number, else false.
  */
 export function isPort(value) {
-    var port = typeof value === 'string' ? Number(value.trim()) : value;
+    const port = typeof value === 'string' ? Number(value.trim()) : value;
     return Number.isInteger(port) && port > 0 && port <= 65535;
 }
 /**
@@ -60,7 +44,7 @@ export function isEmail(str) {
     if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(str))
         return false;
     // Additional checks
-    var _a = __read(str.split('@'), 2), local = _a[0], domain = _a[1];
+    const [local, domain] = str.split('@');
     if (!local || !domain)
         return false;
     // Disallow consecutive dots in local or domain part
@@ -88,7 +72,7 @@ export function isURL(str) {
         new URL(str);
         return true;
     }
-    catch (_a) {
+    catch {
         return false;
     }
 }
@@ -102,7 +86,7 @@ export function isPhone(str) {
     if (typeof str !== 'string')
         return false;
     // Strip non-digit characters to count total digits
-    var digitsOnly = str.replace(/\D/g, '');
+    const digitsOnly = str.replace(/\D/g, '');
     if (digitsOnly.length < 6 || digitsOnly.length > 15)
         return false;
     // Accept typical phone characters: +, digits, space, -, (, )
@@ -126,7 +110,7 @@ export function isAlphanumeric(str) {
 export function isNumeric(value) {
     if (typeof value === 'string' && value.trim() === '')
         return false;
-    var num = typeof value === 'number' ? value : Number(value);
+    const num = typeof value === 'number' ? value : Number(value);
     return typeof num === 'number' && isFinite(num);
 }
 /**
@@ -145,10 +129,10 @@ export function isHexColor(str) {
  * @returns {boolean}
  */
 export function isISODate(str) {
-    var isoRegex = /^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})?)?$/;
+    const isoRegex = /^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})?)?$/;
     if (!isoRegex.test(str))
         return false;
-    var date = new Date(str);
+    const date = new Date(str);
     return !isNaN(date.getTime()) && date.toISOString().startsWith(str.slice(0, 10));
 }
 /**
@@ -192,10 +176,10 @@ export function isAlpha(str) {
 export function isStrongPassword(str) {
     if (str.length < 8)
         return false;
-    var hasUpperCase = /[A-Z]/.test(str);
-    var hasLowerCase = /[a-z]/.test(str);
-    var hasNumbers = /[0-9]/.test(str);
-    var hasSpecialChar = /[!@#$%^&*()_+\-=[\]{};':"\\|,.<>?]/.test(str);
+    const hasUpperCase = /[A-Z]/.test(str);
+    const hasLowerCase = /[a-z]/.test(str);
+    const hasNumbers = /[0-9]/.test(str);
+    const hasSpecialChar = /[!@#$%^&*()_+\-=[\]{};':"\\|,.<>?]/.test(str);
     return hasUpperCase && hasLowerCase && hasNumbers && hasSpecialChar;
 }
 /**
@@ -205,11 +189,11 @@ export function isStrongPassword(str) {
  * @returns {boolean} True if valid IPv4 address.
  */
 export function isIPv4(str) {
-    var parts = str.split('.');
+    const parts = str.split('.');
     if (parts.length !== 4)
         return false;
-    return parts.every(function (part) {
-        var num = parseInt(part, 10);
+    return parts.every(part => {
+        const num = parseInt(part, 10);
         return part === num.toString() && num >= 0 && num <= 255;
     });
 }
@@ -231,14 +215,14 @@ export function isIPv6(str) {
  */
 export function isCreditCard(str) {
     // Remove non-digit characters
-    var cardNumber = str.replace(/\D/g, '');
+    const cardNumber = str.replace(/\D/g, '');
     if (cardNumber.length < 13 || cardNumber.length > 19)
         return false;
     // Luhn algorithm implementation
-    var sum = 0;
-    var shouldDouble = false;
-    for (var i = cardNumber.length - 1; i >= 0; i--) {
-        var digit = parseInt(cardNumber.charAt(i), 10);
+    let sum = 0;
+    let shouldDouble = false;
+    for (let i = cardNumber.length - 1; i >= 0; i--) {
+        let digit = parseInt(cardNumber.charAt(i), 10);
         if (shouldDouble) {
             digit *= 2;
             if (digit > 9)
@@ -260,7 +244,7 @@ export function isValidJSON(str) {
         JSON.parse(str);
         return true;
     }
-    catch (_a) {
+    catch {
         return false;
     }
 }
@@ -275,7 +259,7 @@ export function isValidJSON(str) {
 export function isArray(value, itemGuard) {
     if (!Array.isArray(value))
         return false;
-    return !itemGuard || value.every(function (item) { return itemGuard(item); });
+    return !itemGuard || value.every(item => itemGuard(item));
 }
 /**
  * Checks if a string is a valid base64 encoded string.
@@ -294,7 +278,7 @@ export function isBase64(str) {
  * @returns {boolean} True if all required properties exist.
  */
 export function hasRequiredProps(obj, requiredProps) {
-    return requiredProps.every(function (prop) { return Object.prototype.hasOwnProperty.call(obj, prop) && obj[prop] !== undefined && obj[prop] !== null; });
+    return requiredProps.every(prop => Object.prototype.hasOwnProperty.call(obj, prop) && obj[prop] !== undefined && obj[prop] !== null);
 }
 /**
  * Validates a date is within a specified range.
@@ -331,6 +315,5 @@ export function matchesPattern(str, pattern) {
  * @returns {boolean} True if value passes all validations.
  */
 export function validateAll(value, validators) {
-    return validators.every(function (validator) { return validator(value); });
+    return validators.every(validator => validator(value));
 }
-//# sourceMappingURL=validate.utils.js.map

package/package.json

@@ -1,11 +1,10 @@
 {
   "name": "@catbee/utils",
-  "version": "0.0.8-rc.1",
+  "version": "0.0.8-rc.2",
   "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/src/index.js",
+  "main": "build/esm/index.js",
   "module": "build/esm/index.js",
-  "esnext": "build/esnext/index.js",
-  "types": "build/src/index.d.ts",
+  "types": "build/esm/index.d.ts",
   "publishConfig": {
     "access": "public"
   },
@@ -14,28 +13,6 @@
     "email": "hprasath.dev@gmail.com"
   },
   "license": "MIT",
-  "scripts": {
-    "start": "node build/src/index.js",
-    "prepack": "npm run compile",
-    "compile": "npm run clean && tsc --build tsconfig.json tsconfig.esm.json tsconfig.esnext.json",
-    "clean": "tsc --build --clean tsconfig.json tsconfig.esm.json tsconfig.esnext.json",
-    "lint": "eslint src tests",
-    "lint:fix": "eslint --fix src tests",
-    "preversion": "npm run check-license && npm run lint && npm run test && npm run compile",
-    "pretest": "npm run compile",
-    "dryrun": "npm pack --dry-run",
-    "dryrun:list": "npm pack --dry-run --json > pack-output.json",
-    "test": "cross-env LOGGER_LEVEL=silent jest",
-    "test:coverage": "cross-env LOGGER_LEVEL=silent jest --coverage",
-    "coverage": "npm run test:coverage",
-    "test:debug": "cross-env LOGGER_LEVEL=info jest",
-    "add-license": "npx license-check-and-add add -f file-banner-lic.json && npm run lint:fix",
-    "check-license": "npx license-check-and-add check -f file-banner-lic.json",
-    "docs:install": "cd docs && npm install",
-    "docs:start": "cd docs && npm run start",
-    "docs:build": "cd docs && npm run build",
-    "docs:serve": "npm run docs:build && cd docs && npm run serve"
-  },
   "keywords": [
     "utils",
     "utility",
@@ -90,14 +67,7 @@
   },
   "files": [
     "build/esm/**/*.js",
-    "build/esm/**/*.js.map",
     "build/esm/**/*.d.ts",
-    "build/esnext/**/*.js",
-    "build/esnext/**/*.js.map",
-    "build/esnext/**/*.d.ts",
-    "build/src/**/*.js",
-    "build/src/**/*.js.map",
-    "build/src/**/*.d.ts",
     "LICENSE",
     "README.md"
   ]

package/build/esm/config.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * The MIT License\n *\n * Copyright (c) 2025 Catbee Technologies. https://catbee-utils.npm.hprasath.com/license\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { ServerConfig } from './types/server';\nimport { Env } from './utils/env.utils';\nimport { uuid } from './utils/id.utils';\nimport { Logger, LoggerLevels } from './utils/logger.utils';\nimport { deepObjMerge } from './utils/obj.utils';\n\n/**\n * Extends Express Request interface to add request ID tracking.\n * Added by requestId middleware during request processing.\n */\ndeclare global {\n  namespace Express {\n    interface Request {\n      /** Unique request identifier (set by middleware) */\n      id?: string;\n      /** Logger instance for the request (set by middleware) */\n      logger?: Logger;\n      /** User information (set by authentication middleware) */\n      user?: any;\n    }\n  }\n}\n\n/**\n * Application runtime configuration loaded from environment variables.\n */\nexport let config = {\n  logger: {\n    /**\n     * Logging level (e.g., 'info', 'debug', 'warn', 'error').\n     */\n    level: Env.get('LOGGER_LEVEL', 'info') as LoggerLevels,\n\n    /**\n     * Name of the logger instance (defaults to npm package name).\n     */\n    name: Env.get('LOGGER_NAME', Env.get('npm_package_name', '@catbee/utils')),\n\n    /**\n     * Enables pretty-print logging in development.\n     * Has no effect in production.\n     */\n    pretty: Env.getBoolean('LOGGER_PRETTY', true),\n    /**\n     * Single line output for pretty-print (default: false)\n     */\n    singleLine: Env.getBoolean('LOGGER_PRETTY_SINGLE_LINE', false)\n  },\n\n  cache: {\n    /**\n     * Default TTL (time to live) for cache entries in seconds\n     */\n    defaultTtl: Env.getNumber('CACHE_DEFAULT_TTL_SECONDS', 3600) * 1000\n  }\n};\n\nexport const defaultServerConfig = {\n  port: 3000,\n  host: '0.0.0.0',\n  cors: false,\n  helmet: false,\n  compression: false,\n  bodyParser: {\n    json: { limit: '1mb' },\n    urlencoded: { extended: true, limit: '1mb' }\n  },\n  cookieParser: false,\n  isMicroservice: false,\n  appName: 'express_app',\n  globalHeaders: {},\n  rateLimit: {\n    enable: false,\n    windowMs: 15 * 60 * 1000,\n    max: 100,\n    message: 'Too many requests',\n    standardHeaders: true,\n    legacyHeaders: false\n  },\n  requestLogging: {\n    enable: Env.isDev(),\n    ignorePaths: (req, _res) => {\n      const skipPaths = ['/healthz', '/favicon.ico', '/metrics', '/docs', '/.well-known'];\n      return skipPaths.some(path => req.path.startsWith(path));\n    },\n    skipNotFoundRoutes: false\n  },\n  openApi: {\n    enable: false,\n    mountPath: '/docs',\n    verbose: false,\n    withGlobalPrefix: false\n  },\n  healthCheck: {\n    path: '/healthz',\n    detailed: true\n  },\n  requestTimeout: 30000,\n  responseTime: {\n    enable: false,\n    addHeader: true,\n    logOnComplete: false\n  },\n  requestId: {\n    headerName: 'x-request-id',\n    exposeHeader: true,\n    generator: () => uuid()\n  },\n  metrics: {\n    enable: false,\n    path: '/metrics',\n    withGlobalPrefix: false\n  },\n  serviceVersion: {\n    enable: false,\n    headerName: 'x-service-version',\n    version: '0.0.0'\n  }\n} satisfies ServerConfig;\n\n/**\n * Update the @catbee/utils configuration.\n * @param value Partial configuration object.\n */\nexport function setConfig(value: Partial<typeof config>): void {\n  deepObjMerge(config, value);\n}\n\n/**\n * Get the current @catbee/utils configuration.\n * @returns The current configuration object.\n */\nexport function getConfig(): typeof config {\n  return config;\n}\n"]}

package/build/esm/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEhD,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AAEvC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AAErC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC","sourcesContent":["/*\n * The MIT License\n *\n * Copyright (c) 2025 Catbee Technologies. https://catbee-utils.npm.hprasath.com/license\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nexport { setConfig, getConfig } from './config';\n\nexport * from './utils/array.utils';\nexport * from './utils/async.utils';\nexport * from './utils/cache.utils';\nexport * from './utils/context-store.utils';\nexport * from './utils/crypto.utils';\nexport * from './utils/decorators.utils';\nexport * from './utils/dir.utils';\nexport * from './utils/env.utils';\nexport * from './utils/exception.utils';\nexport * from './utils/fs.utils';\nexport * from './utils/http-status-codes';\nexport * from './utils/id.utils';\nexport * from './utils/logger.utils';\nexport * from './utils/middleware.utils';\nexport * from './utils/obj.utils';\nexport * from './utils/request.utils';\nexport * from './utils/response.utils';\nexport * from './utils/string.utils';\nexport * from './utils/url.utils';\nexport * from './utils/validate.utils';\n\nexport * from './types/index';\nexport * from './types/server';\nexport * from './types/api-response';\n\nexport * from './servers/server';\nexport * from './servers/server.builder';\n"]}