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

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