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

package/build/esnext/utils/validate.utils.js

@@ -1,320 +0,0 @@
-/*
- * The MIT License
- *
- * Copyright (c) 2025 Catbee Technologies. https://catbee-utils.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
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-/**
- * Collection of common validation helpers for strings, numbers, email, UUID, etc.
- */
-/**
- * Checks if a string is a valid port number.
- *
- * @param str - The input string or number.
- * @returns True if valid port number, else false.
- */
-export function isPort(value) {
-    const port = typeof value === 'string' ? Number(value.trim()) : value;
-    return Number.isInteger(port) && port > 0 && port <= 65535;
-}
-/**
- * Checks if a string is a valid email address.
- *
- * @param {string} str - The input string.
- * @returns {boolean} True if valid email, else false.
- */
-export function isEmail(str) {
-    if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(str))
-        return false;
-    // Additional checks
-    const [local, domain] = str.split('@');
-    if (!local || !domain)
-        return false;
-    // Disallow consecutive dots in local or domain part
-    if (local.includes('..') || domain.includes('..'))
-        return false;
-    return true;
-}
-/**
- * Checks if a string is a valid UUID (versions 1-5).
- *
- * @param {string} str - The input string.
- * @returns {boolean} True if valid UUID, else false.
- */
-export function isUUID(str) {
-    return /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(str);
-}
-/**
- * Checks if a string is a valid URL.
- *
- * @param {string} str - The input string.
- * @returns {boolean} True if valid URL, else false.
- */
-export function isURL(str) {
-    try {
-        new URL(str);
-        return true;
-    }
-    catch (_a) {
-        return false;
-    }
-}
-/**
- * Checks if a string is a valid international phone number (E.164 or common patterns).
- *
- * @param {string} str - The input string.
- * @returns {boolean} True if looks like a phone number.
- */
-export function isPhone(str) {
-    if (typeof str !== 'string')
-        return false;
-    // Strip non-digit characters to count total digits
-    const digitsOnly = str.replace(/\D/g, '');
-    if (digitsOnly.length < 6 || digitsOnly.length > 15)
-        return false;
-    // Accept typical phone characters: +, digits, space, -, (, )
-    return /^[+]?[\d\s().-]+$/.test(str);
-}
-/**
- * Checks if a string is strictly alphanumeric (letters/numbers only).
- *
- * @param {string} str - The input string.
- * @returns {boolean} True if alphanumeric.
- */
-export function isAlphanumeric(str) {
-    return /^[a-z0-9]+$/i.test(str);
-}
-/**
- * Checks if a string or number can be safely parsed to a number.
- *
- * @param {string | number} value - The value to check.
- * @returns {boolean} True if the value is numeric.
- */
-export function isNumeric(value) {
-    if (typeof value === 'string' && value.trim() === '')
-        return false;
-    const num = typeof value === 'number' ? value : Number(value);
-    return typeof num === 'number' && isFinite(num);
-}
-/**
- * Checks if a string is a valid hex color code (e.g. #FFF or #FFFFFF).
- *
- * @param {string} str - Input string.
- * @returns {boolean}
- */
-export function isHexColor(str) {
-    return /^#([a-f0-9]{6}|[a-f0-9]{3})$/i.test(str);
-}
-/**
- * Checks if a string is a valid date string.
- *
- * @param {string} str - Input string.
- * @returns {boolean}
- */
-export function isISODate(str) {
-    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;
-    const date = new Date(str);
-    return !isNaN(date.getTime()) && date.toISOString().startsWith(str.slice(0, 10));
-}
-/**
- * Checks if a string matches a specified length range.
- *
- * @param {string} str - The input string.
- * @param {number} min - Minimum length (inclusive).
- * @param {number} max - Maximum length (inclusive).
- * @returns {boolean} True if string length is within range.
- */
-export function isLengthBetween(str, min, max) {
-    return str.length >= min && str.length <= max;
-}
-/**
- * Validates that a number is between specified min and max values (inclusive).
- *
- * @param {number} value - The number to validate.
- * @param {number} min - Minimum value.
- * @param {number} max - Maximum value.
- * @returns {boolean} True if number is within range.
- */
-export function isNumberBetween(value, min, max) {
-    return value >= min && value <= max;
-}
-/**
- * Checks if a string contains only alphabetic characters.
- *
- * @param {string} str - The input string.
- * @returns {boolean} True if alphabetic only.
- */
-export function isAlpha(str) {
-    return /^[a-zA-Z]+$/.test(str);
-}
-/**
- * Validates that a string contains at least one uppercase letter,
- * one lowercase letter, one number, and one special character.
- *
- * @param {string} str - The input string.
- * @returns {boolean} True if string meets password complexity requirements.
- */
-export function isStrongPassword(str) {
-    if (str.length < 8)
-        return false;
-    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;
-}
-/**
- * Checks if a string is a valid IPv4 address.
- *
- * @param {string} str - The input string.
- * @returns {boolean} True if valid IPv4 address.
- */
-export function isIPv4(str) {
-    const parts = str.split('.');
-    if (parts.length !== 4)
-        return false;
-    return parts.every(part => {
-        const num = parseInt(part, 10);
-        return part === num.toString() && num >= 0 && num <= 255;
-    });
-}
-/**
- * Checks if a string is a valid IPv6 address.
- *
- * @param {string} str - The input string.
- * @returns {boolean} True if valid IPv6 address.
- */
-export function isIPv6(str) {
-    // Simple but effective check for common IPv6 formats
-    return /^(([0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]+|::(ffff(:0{1,4})?:)?((25[0-5]|(2[0-4]|1?[0-9])?[0-9])\.){3}(25[0-5]|(2[0-4]|1?[0-9])?[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1?[0-9])?[0-9])\.){3}(25[0-5]|(2[0-4]|1?[0-9])?[0-9]))$/.test(str);
-}
-/**
- * Validates a credit card number using the Luhn algorithm.
- *
- * @param {string} str - The credit card number string.
- * @returns {boolean} True if valid credit card number.
- */
-export function isCreditCard(str) {
-    // Remove non-digit characters
-    const cardNumber = str.replace(/\D/g, '');
-    if (cardNumber.length < 13 || cardNumber.length > 19)
-        return false;
-    // Luhn algorithm implementation
-    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)
-                digit -= 9;
-        }
-        sum += digit;
-        shouldDouble = !shouldDouble;
-    }
-    return sum % 10 === 0;
-}
-/**
- * Checks if a string is a valid JSON.
- *
- * @param {string} str - The input string.
- * @returns {boolean} True if valid JSON.
- */
-export function isValidJSON(str) {
-    try {
-        JSON.parse(str);
-        return true;
-    }
-    catch (_a) {
-        return false;
-    }
-}
-/**
- * Type guard that checks if a value is an array.
- *
- * @template T Optional expected element type
- * @param {unknown} value - The value to check.
- * @param {(item: unknown) => boolean} [itemGuard] - Optional function to validate each item.
- * @returns {boolean} True if value is an array (with optional item validation).
- */
-export function isArray(value, itemGuard) {
-    if (!Array.isArray(value))
-        return false;
-    return !itemGuard || value.every(item => itemGuard(item));
-}
-/**
- * Checks if a string is a valid base64 encoded string.
- *
- * @param {string} str - The input string.
- * @returns {boolean} True if valid base64.
- */
-export function isBase64(str) {
-    return /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/.test(str);
-}
-/**
- * Validates that an object has all required properties.
- *
- * @param {object} obj - The object to validate.
- * @param {string[]} requiredProps - Array of required property names.
- * @returns {boolean} True if all required properties exist.
- */
-export function hasRequiredProps(obj, requiredProps) {
-    return requiredProps.every(prop => Object.prototype.hasOwnProperty.call(obj, prop) && obj[prop] !== undefined && obj[prop] !== null);
-}
-/**
- * Validates a date is within a specified range.
- *
- * @param {Date} date - The date to validate.
- * @param {Date} [minDate] - Optional minimum date (inclusive).
- * @param {Date} [maxDate] - Optional maximum date (inclusive).
- * @returns {boolean} True if date is within range.
- */
-export function isDateInRange(date, minDate, maxDate) {
-    if (!(date instanceof Date) || isNaN(date.getTime()))
-        return false;
-    if (minDate && date < minDate)
-        return false;
-    if (maxDate && date > maxDate)
-        return false;
-    return true;
-}
-/**
- * Validates a string matches a specific regular expression pattern.
- *
- * @param {string} str - The input string.
- * @param {RegExp} pattern - Regular expression to test against.
- * @returns {boolean} True if string matches pattern.
- */
-export function matchesPattern(str, pattern) {
-    return pattern.test(str);
-}
-/**
- * Validates data against multiple constraints.
- *
- * @param {unknown} value - The value to validate.
- * @param {Array<(value: unknown) => boolean>} validators - Array of validation functions.
- * @returns {boolean} True if value passes all validations.
- */
-export function validateAll(value, validators) {
-    return validators.every(validator => validator(value));
-}
-//# sourceMappingURL=validate.utils.js.map

package/build/esnext/utils/validate.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"validate.utils.js","sourceRoot":"","sources":["../../../src/utils/validate.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH;;GAEG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAC,KAAsB;IAC3C,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACtE,OAAO,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,IAAI,KAAK,CAAC;AAC7D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,IAAI,CAAC,4BAA4B,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAE1D,oBAAoB;IACpB,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAEpC,oDAAoD;IACpD,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAEhE,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAC,GAAW;IAChC,OAAO,4EAA4E,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAChG,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,KAAK,CAAC,GAAW;IAC/B,IAAI,CAAC;QACH,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE1C,mDAAmD;IACnD,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC1C,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,CAAC,MAAM,GAAG,EAAE;QAAE,OAAO,KAAK,CAAC;IAElE,6DAA6D;IAC7D,OAAO,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,OAAO,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,KAAsB;IAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IACnE,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9D,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC;AAClD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,+BAA+B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACnD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,MAAM,QAAQ,GAAG,sEAAsE,CAAC;IAExF,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAEtC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3B,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AACnF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,GAAW,EAAE,GAAW;IACnE,OAAO,GAAG,CAAC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC;AAChD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW;IACrE,OAAO,KAAK,IAAI,GAAG,IAAI,KAAK,IAAI,GAAG,CAAC;AACtC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,OAAO,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACjC,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,cAAc,GAAG,oCAAoC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtE,OAAO,YAAY,IAAI,YAAY,IAAI,UAAU,IAAI,cAAc,CAAC;AACtE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAC,GAAW;IAChC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAErC,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE;QACxB,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC/B,OAAO,IAAI,KAAK,GAAG,CAAC,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,CAAC;IAC3D,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAC,GAAW;IAChC,qDAAqD;IACrD,OAAO,smBAAsmB,CAAC,IAAI,CAChnB,GAAG,CACJ,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,8BAA8B;IAC9B,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC1C,IAAI,UAAU,CAAC,MAAM,GAAG,EAAE,IAAI,UAAU,CAAC,MAAM,GAAG,EAAE;QAAE,OAAO,KAAK,CAAC;IAEnE,gCAAgC;IAChC,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,YAAY,GAAG,KAAK,CAAC;IAEzB,KAAK,IAAI,CAAC,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAChD,IAAI,KAAK,GAAG,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAE/C,IAAI,YAAY,EAAE,CAAC;YACjB,KAAK,IAAI,CAAC,CAAC;YACX,IAAI,KAAK,GAAG,CAAC;gBAAE,KAAK,IAAI,CAAC,CAAC;QAC5B,CAAC;QAED,GAAG,IAAI,KAAK,CAAC;QACb,YAAY,GAAG,CAAC,YAAY,CAAC;IAC/B,CAAC;IAED,OAAO,GAAG,GAAG,EAAE,KAAK,CAAC,CAAC;AACxB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,IAAI,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,OAAO,CAAc,KAAc,EAAE,SAAwC;IAC3F,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,OAAO,kEAAkE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACtF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAA4B,EAAE,aAAuB;IACpF,OAAO,aAAa,CAAC,KAAK,CACxB,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,CACzG,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,IAAU,EAAE,OAAc,EAAE,OAAc;IACtE,IAAI,CAAC,CAAC,IAAI,YAAY,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,KAAK,CAAC;IAEnE,IAAI,OAAO,IAAI,IAAI,GAAG,OAAO;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,OAAO,IAAI,IAAI,GAAG,OAAO;QAAE,OAAO,KAAK,CAAC;IAE5C,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW,EAAE,OAAe;IACzD,OAAO,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc,EAAE,UAA8C;IACxF,OAAO,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AACzD,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\n/**\n * Collection of common validation helpers for strings, numbers, email, UUID, etc.\n */\n\n/**\n * Checks if a string is a valid port number.\n *\n * @param str - The input string or number.\n * @returns True if valid port number, else false.\n */\nexport function isPort(value: string | number): boolean {\n  const port = typeof value === 'string' ? Number(value.trim()) : value;\n  return Number.isInteger(port) && port > 0 && port <= 65535;\n}\n\n/**\n * Checks if a string is a valid email address.\n *\n * @param {string} str - The input string.\n * @returns {boolean} True if valid email, else false.\n */\nexport function isEmail(str: string): boolean {\n  if (!/^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(str)) return false;\n\n  // Additional checks\n  const [local, domain] = str.split('@');\n  if (!local || !domain) return false;\n\n  // Disallow consecutive dots in local or domain part\n  if (local.includes('..') || domain.includes('..')) return false;\n\n  return true;\n}\n\n/**\n * Checks if a string is a valid UUID (versions 1-5).\n *\n * @param {string} str - The input string.\n * @returns {boolean} True if valid UUID, else false.\n */\nexport function isUUID(str: string): boolean {\n  return /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(str);\n}\n\n/**\n * Checks if a string is a valid URL.\n *\n * @param {string} str - The input string.\n * @returns {boolean} True if valid URL, else false.\n */\nexport function isURL(str: string): boolean {\n  try {\n    new URL(str);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Checks if a string is a valid international phone number (E.164 or common patterns).\n *\n * @param {string} str - The input string.\n * @returns {boolean} True if looks like a phone number.\n */\nexport function isPhone(str: string): boolean {\n  if (typeof str !== 'string') return false;\n\n  // Strip non-digit characters to count total digits\n  const digitsOnly = str.replace(/\\D/g, '');\n  if (digitsOnly.length < 6 || digitsOnly.length > 15) return false;\n\n  // Accept typical phone characters: +, digits, space, -, (, )\n  return /^[+]?[\\d\\s().-]+$/.test(str);\n}\n\n/**\n * Checks if a string is strictly alphanumeric (letters/numbers only).\n *\n * @param {string} str - The input string.\n * @returns {boolean} True if alphanumeric.\n */\nexport function isAlphanumeric(str: string): boolean {\n  return /^[a-z0-9]+$/i.test(str);\n}\n\n/**\n * Checks if a string or number can be safely parsed to a number.\n *\n * @param {string | number} value - The value to check.\n * @returns {boolean} True if the value is numeric.\n */\nexport function isNumeric(value: string | number): boolean {\n  if (typeof value === 'string' && value.trim() === '') return false;\n  const num = typeof value === 'number' ? value : Number(value);\n  return typeof num === 'number' && isFinite(num);\n}\n\n/**\n * Checks if a string is a valid hex color code (e.g. #FFF or #FFFFFF).\n *\n * @param {string} str - Input string.\n * @returns {boolean}\n */\nexport function isHexColor(str: string): boolean {\n  return /^#([a-f0-9]{6}|[a-f0-9]{3})$/i.test(str);\n}\n\n/**\n * Checks if a string is a valid date string.\n *\n * @param {string} str - Input string.\n * @returns {boolean}\n */\nexport function isISODate(str: string): boolean {\n  const isoRegex = /^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?(Z|[+-]\\d{2}:\\d{2})?)?$/;\n\n  if (!isoRegex.test(str)) return false;\n\n  const date = new Date(str);\n  return !isNaN(date.getTime()) && date.toISOString().startsWith(str.slice(0, 10));\n}\n\n/**\n * Checks if a string matches a specified length range.\n *\n * @param {string} str - The input string.\n * @param {number} min - Minimum length (inclusive).\n * @param {number} max - Maximum length (inclusive).\n * @returns {boolean} True if string length is within range.\n */\nexport function isLengthBetween(str: string, min: number, max: number): boolean {\n  return str.length >= min && str.length <= max;\n}\n\n/**\n * Validates that a number is between specified min and max values (inclusive).\n *\n * @param {number} value - The number to validate.\n * @param {number} min - Minimum value.\n * @param {number} max - Maximum value.\n * @returns {boolean} True if number is within range.\n */\nexport function isNumberBetween(value: number, min: number, max: number): boolean {\n  return value >= min && value <= max;\n}\n\n/**\n * Checks if a string contains only alphabetic characters.\n *\n * @param {string} str - The input string.\n * @returns {boolean} True if alphabetic only.\n */\nexport function isAlpha(str: string): boolean {\n  return /^[a-zA-Z]+$/.test(str);\n}\n\n/**\n * Validates that a string contains at least one uppercase letter,\n * one lowercase letter, one number, and one special character.\n *\n * @param {string} str - The input string.\n * @returns {boolean} True if string meets password complexity requirements.\n */\nexport function isStrongPassword(str: string): boolean {\n  if (str.length < 8) return false;\n  const hasUpperCase = /[A-Z]/.test(str);\n  const hasLowerCase = /[a-z]/.test(str);\n  const hasNumbers = /[0-9]/.test(str);\n  const hasSpecialChar = /[!@#$%^&*()_+\\-=[\\]{};':\"\\\\|,.<>?]/.test(str);\n  return hasUpperCase && hasLowerCase && hasNumbers && hasSpecialChar;\n}\n\n/**\n * Checks if a string is a valid IPv4 address.\n *\n * @param {string} str - The input string.\n * @returns {boolean} True if valid IPv4 address.\n */\nexport function isIPv4(str: string): boolean {\n  const parts = str.split('.');\n  if (parts.length !== 4) return false;\n\n  return parts.every(part => {\n    const num = parseInt(part, 10);\n    return part === num.toString() && num >= 0 && num <= 255;\n  });\n}\n\n/**\n * Checks if a string is a valid IPv6 address.\n *\n * @param {string} str - The input string.\n * @returns {boolean} True if valid IPv6 address.\n */\nexport function isIPv6(str: string): boolean {\n  // Simple but effective check for common IPv6 formats\n  return /^(([0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]+|::(ffff(:0{1,4})?:)?((25[0-5]|(2[0-4]|1?[0-9])?[0-9])\\.){3}(25[0-5]|(2[0-4]|1?[0-9])?[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1?[0-9])?[0-9])\\.){3}(25[0-5]|(2[0-4]|1?[0-9])?[0-9]))$/.test(\n    str\n  );\n}\n\n/**\n * Validates a credit card number using the Luhn algorithm.\n *\n * @param {string} str - The credit card number string.\n * @returns {boolean} True if valid credit card number.\n */\nexport function isCreditCard(str: string): boolean {\n  // Remove non-digit characters\n  const cardNumber = str.replace(/\\D/g, '');\n  if (cardNumber.length < 13 || cardNumber.length > 19) return false;\n\n  // Luhn algorithm implementation\n  let sum = 0;\n  let shouldDouble = false;\n\n  for (let i = cardNumber.length - 1; i >= 0; i--) {\n    let digit = parseInt(cardNumber.charAt(i), 10);\n\n    if (shouldDouble) {\n      digit *= 2;\n      if (digit > 9) digit -= 9;\n    }\n\n    sum += digit;\n    shouldDouble = !shouldDouble;\n  }\n\n  return sum % 10 === 0;\n}\n\n/**\n * Checks if a string is a valid JSON.\n *\n * @param {string} str - The input string.\n * @returns {boolean} True if valid JSON.\n */\nexport function isValidJSON(str: string): boolean {\n  try {\n    JSON.parse(str);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Type guard that checks if a value is an array.\n *\n * @template T Optional expected element type\n * @param {unknown} value - The value to check.\n * @param {(item: unknown) => boolean} [itemGuard] - Optional function to validate each item.\n * @returns {boolean} True if value is an array (with optional item validation).\n */\nexport function isArray<T = unknown>(value: unknown, itemGuard?: (item: unknown) => item is T): value is T[] {\n  if (!Array.isArray(value)) return false;\n  return !itemGuard || value.every(item => itemGuard(item));\n}\n\n/**\n * Checks if a string is a valid base64 encoded string.\n *\n * @param {string} str - The input string.\n * @returns {boolean} True if valid base64.\n */\nexport function isBase64(str: string): boolean {\n  return /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/.test(str);\n}\n\n/**\n * Validates that an object has all required properties.\n *\n * @param {object} obj - The object to validate.\n * @param {string[]} requiredProps - Array of required property names.\n * @returns {boolean} True if all required properties exist.\n */\nexport function hasRequiredProps(obj: Record<string, unknown>, requiredProps: string[]): boolean {\n  return requiredProps.every(\n    prop => Object.prototype.hasOwnProperty.call(obj, prop) && obj[prop] !== undefined && obj[prop] !== null\n  );\n}\n\n/**\n * Validates a date is within a specified range.\n *\n * @param {Date} date - The date to validate.\n * @param {Date} [minDate] - Optional minimum date (inclusive).\n * @param {Date} [maxDate] - Optional maximum date (inclusive).\n * @returns {boolean} True if date is within range.\n */\nexport function isDateInRange(date: Date, minDate?: Date, maxDate?: Date): boolean {\n  if (!(date instanceof Date) || isNaN(date.getTime())) return false;\n\n  if (minDate && date < minDate) return false;\n  if (maxDate && date > maxDate) return false;\n\n  return true;\n}\n\n/**\n * Validates a string matches a specific regular expression pattern.\n *\n * @param {string} str - The input string.\n * @param {RegExp} pattern - Regular expression to test against.\n * @returns {boolean} True if string matches pattern.\n */\nexport function matchesPattern(str: string, pattern: RegExp): boolean {\n  return pattern.test(str);\n}\n\n/**\n * Validates data against multiple constraints.\n *\n * @param {unknown} value - The value to validate.\n * @param {Array<(value: unknown) => boolean>} validators - Array of validation functions.\n * @returns {boolean} True if value passes all validations.\n */\nexport function validateAll(value: unknown, validators: Array<(value: unknown) => boolean>): boolean {\n  return validators.every(validator => validator(value));\n}\n"]}

package/build/src/config.d.ts

@@ -1,122 +0,0 @@
-import { Logger, LoggerLevels } from './utils/logger.utils';
-/**
- * Extends Express Request interface to add request ID tracking.
- * Added by requestId middleware during request processing.
- */
-declare global {
-    namespace Express {
-        interface Request {
-            /** Unique request identifier (set by middleware) */
-            id?: string;
-            /** Logger instance for the request (set by middleware) */
-            logger?: Logger;
-            /** User information (set by authentication middleware) */
-            user?: any;
-        }
-    }
-}
-/**
- * Application runtime configuration loaded from environment variables.
- */
-export declare let config: {
-    logger: {
-        /**
-         * Logging level (e.g., 'info', 'debug', 'warn', 'error').
-         */
-        level: LoggerLevels;
-        /**
-         * Name of the logger instance (defaults to npm package name).
-         */
-        name: string;
-        /**
-         * Enables pretty-print logging in development.
-         * Has no effect in production.
-         */
-        pretty: boolean;
-        /**
-         * Single line output for pretty-print (default: false)
-         */
-        singleLine: boolean;
-    };
-    cache: {
-        /**
-         * Default TTL (time to live) for cache entries in seconds
-         */
-        defaultTtl: number;
-    };
-};
-export declare const defaultServerConfig: {
-    port: number;
-    host: string;
-    cors: false;
-    helmet: false;
-    compression: false;
-    bodyParser: {
-        json: {
-            limit: string;
-        };
-        urlencoded: {
-            extended: true;
-            limit: string;
-        };
-    };
-    cookieParser: false;
-    isMicroservice: false;
-    appName: string;
-    globalHeaders: {};
-    rateLimit: {
-        enable: false;
-        windowMs: number;
-        max: number;
-        message: string;
-        standardHeaders: true;
-        legacyHeaders: false;
-    };
-    requestLogging: {
-        enable: boolean;
-        ignorePaths: (req: import("express").Request<import("express-serve-static-core").ParamsDictionary, any, any, import("qs").ParsedQs, Record<string, any>>, _res: import("express").Response<any, Record<string, any>>) => boolean;
-        skipNotFoundRoutes: false;
-    };
-    openApi: {
-        enable: false;
-        mountPath: string;
-        verbose: false;
-        withGlobalPrefix: false;
-    };
-    healthCheck: {
-        path: string;
-        detailed: true;
-    };
-    requestTimeout: number;
-    responseTime: {
-        enable: false;
-        addHeader: true;
-        logOnComplete: false;
-    };
-    requestId: {
-        headerName: string;
-        exposeHeader: true;
-        generator: () => string;
-    };
-    metrics: {
-        enable: false;
-        path: string;
-        withGlobalPrefix: false;
-    };
-    serviceVersion: {
-        enable: false;
-        headerName: string;
-        version: string;
-    };
-};
-/**
- * Update the @catbee/utils configuration.
- * @param value Partial configuration object.
- */
-export declare function setConfig(value: Partial<typeof config>): void;
-/**
- * Get the current @catbee/utils configuration.
- * @returns The current configuration object.
- */
-export declare function getConfig(): typeof config;
-//# sourceMappingURL=config.d.ts.map

package/build/src/config.js

@@ -1,138 +0,0 @@
-"use strict";
-/*
- * The MIT License
- *
- * Copyright (c) 2025 Catbee Technologies. https://catbee-utils.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
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.defaultServerConfig = exports.config = void 0;
-exports.setConfig = setConfig;
-exports.getConfig = getConfig;
-const env_utils_1 = require("./utils/env.utils");
-const id_utils_1 = require("./utils/id.utils");
-const obj_utils_1 = require("./utils/obj.utils");
-/**
- * Application runtime configuration loaded from environment variables.
- */
-exports.config = {
-    logger: {
-        /**
-         * Logging level (e.g., 'info', 'debug', 'warn', 'error').
-         */
-        level: env_utils_1.Env.get('LOGGER_LEVEL', 'info'),
-        /**
-         * Name of the logger instance (defaults to npm package name).
-         */
-        name: env_utils_1.Env.get('LOGGER_NAME', env_utils_1.Env.get('npm_package_name', '@catbee/utils')),
-        /**
-         * Enables pretty-print logging in development.
-         * Has no effect in production.
-         */
-        pretty: env_utils_1.Env.getBoolean('LOGGER_PRETTY', true),
-        /**
-         * Single line output for pretty-print (default: false)
-         */
-        singleLine: env_utils_1.Env.getBoolean('LOGGER_PRETTY_SINGLE_LINE', false)
-    },
-    cache: {
-        /**
-         * Default TTL (time to live) for cache entries in seconds
-         */
-        defaultTtl: env_utils_1.Env.getNumber('CACHE_DEFAULT_TTL_SECONDS', 3600) * 1000
-    }
-};
-exports.defaultServerConfig = {
-    port: 3000,
-    host: '0.0.0.0',
-    cors: false,
-    helmet: false,
-    compression: false,
-    bodyParser: {
-        json: { limit: '1mb' },
-        urlencoded: { extended: true, limit: '1mb' }
-    },
-    cookieParser: false,
-    isMicroservice: false,
-    appName: 'express_app',
-    globalHeaders: {},
-    rateLimit: {
-        enable: false,
-        windowMs: 15 * 60 * 1000,
-        max: 100,
-        message: 'Too many requests',
-        standardHeaders: true,
-        legacyHeaders: false
-    },
-    requestLogging: {
-        enable: env_utils_1.Env.isDev(),
-        ignorePaths: (req, _res) => {
-            const skipPaths = ['/healthz', '/favicon.ico', '/metrics', '/docs', '/.well-known'];
-            return skipPaths.some(path => req.path.startsWith(path));
-        },
-        skipNotFoundRoutes: false
-    },
-    openApi: {
-        enable: false,
-        mountPath: '/docs',
-        verbose: false,
-        withGlobalPrefix: false
-    },
-    healthCheck: {
-        path: '/healthz',
-        detailed: true
-    },
-    requestTimeout: 30000,
-    responseTime: {
-        enable: false,
-        addHeader: true,
-        logOnComplete: false
-    },
-    requestId: {
-        headerName: 'x-request-id',
-        exposeHeader: true,
-        generator: () => (0, id_utils_1.uuid)()
-    },
-    metrics: {
-        enable: false,
-        path: '/metrics',
-        withGlobalPrefix: false
-    },
-    serviceVersion: {
-        enable: false,
-        headerName: 'x-service-version',
-        version: '0.0.0'
-    }
-};
-/**
- * Update the @catbee/utils configuration.
- * @param value Partial configuration object.
- */
-function setConfig(value) {
-    (0, obj_utils_1.deepObjMerge)(exports.config, value);
-}
-/**
- * Get the current @catbee/utils configuration.
- * @returns The current configuration object.
- */
-function getConfig() {
-    return exports.config;
-}
-//# sourceMappingURL=config.js.map

package/build/src/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/src/index.d.ts

@@ -1,27 +0,0 @@
-export { setConfig, getConfig } from './config';
-export * from './utils/array.utils';
-export * from './utils/async.utils';
-export * from './utils/cache.utils';
-export * from './utils/context-store.utils';
-export * from './utils/crypto.utils';
-export * from './utils/decorators.utils';
-export * from './utils/dir.utils';
-export * from './utils/env.utils';
-export * from './utils/exception.utils';
-export * from './utils/fs.utils';
-export * from './utils/http-status-codes';
-export * from './utils/id.utils';
-export * from './utils/logger.utils';
-export * from './utils/middleware.utils';
-export * from './utils/obj.utils';
-export * from './utils/request.utils';
-export * from './utils/response.utils';
-export * from './utils/string.utils';
-export * from './utils/url.utils';
-export * from './utils/validate.utils';
-export * from './types/index';
-export * from './types/server';
-export * from './types/api-response';
-export * from './servers/server';
-export * from './servers/server.builder';
-//# sourceMappingURL=index.d.ts.map