@catbee/utils 2.0.0-next.0 → 2.0.0

package/types/index.mjs

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

package/url/index.cjs

@@ -1,7 +1,7 @@
 /*
  * The MIT License
  * 
- * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
+ * Copyright (c) 2026 Catbee Technologies. https://catbee.in/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
@@ -90,10 +90,8 @@ function joinPaths(...segments) {
 __name(joinPaths, "joinPaths");
 function normalizeUrl(url$1, base) {
   try {
-    if (url$1.startsWith("//")) {
-      url$1 = `https:${url$1}`;
-    }
-    const parsedUrl = base ? new url.URL(url$1, base) : new url.URL(url$1);
+    let normalized = url$1.startsWith("//") ? `https:${url$1}` : url$1;
+    const parsedUrl = base ? new url.URL(normalized, base) : new url.URL(normalized);
     parsedUrl.pathname = parsedUrl.pathname.replace(/\/+/g, "/");
     parsedUrl.pathname = parsedUrl.pathname.replace(/\/+$/, "");
     parsedUrl.hostname = parsedUrl.hostname.toLowerCase();
@@ -103,6 +101,16 @@ function normalizeUrl(url$1, base) {
   }
 }
 __name(normalizeUrl, "normalizeUrl");
+function updateQueryParam(url$1, key, value) {
+  try {
+    const urlObj = new url.URL(url$1);
+    urlObj.searchParams.set(key, String(value));
+    return urlObj.toString();
+  } catch {
+    return url$1;
+  }
+}
+__name(updateQueryParam, "updateQueryParam");
 function createUrlBuilder(baseUrl) {
   return {
     /**
@@ -187,15 +195,65 @@ function parseTypedQueryParams(url$1, converters) {
   }
 }
 __name(parseTypedQueryParams, "parseTypedQueryParams");
+function getSubdomain(url$1) {
+  try {
+    const { hostname } = new url.URL(url$1);
+    const parts = hostname.split(".");
+    if (parts.length <= 2) return "";
+    return parts.slice(0, -2).join(".");
+  } catch {
+    return "";
+  }
+}
+__name(getSubdomain, "getSubdomain");
+function isRelativeUrl(url$1) {
+  if (!url$1 || typeof url$1 !== "string") return false;
+  try {
+    new url.URL(url$1);
+    return false;
+  } catch {
+    return url$1.startsWith("/") || url$1.startsWith("./") || url$1.startsWith("../");
+  }
+}
+__name(isRelativeUrl, "isRelativeUrl");
+function toAbsoluteUrl(relativeUrl, baseUrl) {
+  try {
+    return new url.URL(relativeUrl, baseUrl).toString();
+  } catch {
+    return relativeUrl;
+  }
+}
+__name(toAbsoluteUrl, "toAbsoluteUrl");
+function sanitizeUrl(url$1, allowedProtocols = [
+  "http",
+  "https"
+]) {
+  try {
+    const parsedUrl = new url.URL(url$1);
+    const protocol = parsedUrl.protocol.replace(":", "");
+    if (!allowedProtocols.includes(protocol)) {
+      return null;
+    }
+    return parsedUrl.toString();
+  } catch {
+    return null;
+  }
+}
+__name(sanitizeUrl, "sanitizeUrl");
 
 exports.appendQueryParams = appendQueryParams;
 exports.createUrlBuilder = createUrlBuilder;
 exports.extractQueryParams = extractQueryParams;
 exports.getDomain = getDomain;
 exports.getExtension = getExtension;
+exports.getSubdomain = getSubdomain;
+exports.isRelativeUrl = isRelativeUrl;
 exports.isValidUrl = isValidUrl;
 exports.joinPaths = joinPaths;
 exports.normalizeUrl = normalizeUrl;
 exports.parseQueryString = parseQueryString;
 exports.parseTypedQueryParams = parseTypedQueryParams;
 exports.removeQueryParams = removeQueryParams;
+exports.sanitizeUrl = sanitizeUrl;
+exports.toAbsoluteUrl = toAbsoluteUrl;
+exports.updateQueryParam = updateQueryParam;

package/url/index.d.ts

@@ -1,7 +1,7 @@
 /*
  * The MIT License
  * 
- * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
+ * Copyright (c) 2026 Catbee Technologies. https://catbee.in/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
@@ -22,4 +22,202 @@
  * SOFTWARE.
  */
 
-export * from './url.utils';
+/**
+ * Appends query parameters to a given URL.
+ *
+ * @param {string} url - The base URL to which query parameters will be appended.
+ * @param {Record<string, string | number>} params - Key-value pairs to add as query parameters.
+ * @returns {string} The new URL string with query parameters appended.
+ *
+ * @example
+ * appendQueryParams('https://example.com', { page: 1, limit: 10 });
+ * // -> 'https://example.com/?page=1&limit=10'
+ */
+declare function appendQueryParams(url: string, params: Record<string, string | number>): string;
+/**
+ * Parses a query string into a key-value object.
+ *
+ * @param {string} query - The query string (with or without leading '?').
+ * @returns {Record<string, string>} Object representing parsed query parameters.
+ *
+ * @example
+ * parseQueryString('?page=1&limit=10');
+ * // -> { page: '1', limit: '10' }
+ */
+declare function parseQueryString(query: string): Record<string, string>;
+/**
+ * Validates if a string is a valid URL.
+ *
+ * @param {string} url - The URL string to validate.
+ * @param {boolean} [requireHttps=false] - If true, requires the URL to use HTTPS.
+ * @returns {boolean} True if the URL is valid, false otherwise.
+ */
+declare function isValidUrl(url: string, requireHttps?: boolean): boolean;
+/**
+ * Extracts the domain name from a URL.
+ *
+ * @param {string} url - The URL to extract the domain from.
+ * @param {boolean} [removeSubdomains=false] - If true, removes subdomains (returns root domain only).
+ * @returns {string} The domain name.
+ *
+ * @example
+ * getDomain('https://api.example.com/path');
+ * // -> 'api.example.com'
+ *
+ * getDomain('https://api.example.com/path', true);
+ * // -> 'example.com'
+ */
+declare function getDomain(url: string, removeSubdomains?: boolean): string;
+/**
+ * Joins URL paths properly handling slashes.
+ *
+ * @param {...string[]} segments - URL path segments to join.
+ * @returns {string} Joined URL path.
+ *
+ * @example
+ * joinPaths('https://example.com/', '/api/', '/users');
+ * // -> 'https://example.com/api/users'
+ */
+declare function joinPaths(...segments: string[]): string;
+/**
+ * Normalizes a URL by resolving relative paths, handling protocol-relative URLs, etc.
+ *
+ * @param {string} url - The URL to normalize.
+ * @param {string} [base] - Optional base URL for resolving relative URLs.
+ * @returns {string} Normalized URL.
+ *
+ * @example
+ * normalizeUrl('HTTP://Example.COM/foo/../bar');
+ * // -> 'http://example.com/bar'
+ */
+declare function normalizeUrl(url: string, base?: string): string;
+/**
+ * Updates or sets a single query parameter in a URL.
+ *
+ * @param {string} url - The source URL.
+ * @param {string} key - Parameter key.
+ * @param {string | number} value - Parameter value.
+ * @returns {string} URL with updated parameter.
+ *
+ * @example
+ * updateQueryParam('https://example.com?page=1', 'page', 2); // 'https://example.com?page=2'
+ */
+declare function updateQueryParam(url: string, key: string, value: string | number): string;
+/**
+ * Creates a URL builder for constructing URLs with a base URL.
+ *
+ * @param {string} baseUrl - The base URL to build upon.
+ * @returns {Object} URL builder methods.
+ *
+ * @example
+ * const api = createUrlBuilder('https://api.example.com');
+ * api.path('/users', { active: true });
+ * // -> 'https://api.example.com/users?active=true'
+ */
+declare function createUrlBuilder(baseUrl: string): {
+    /**
+     * Creates a full URL with the given path and query parameters.
+     *
+     * @param {string} path - The path to append to the base URL.
+     * @param {Record<string, any>} [params] - Query parameters to add.
+     * @returns {string} The complete URL.
+     */
+    path(path: string, params?: Record<string, any>): string;
+    /**
+     * Creates a full URL with query parameters but no additional path.
+     *
+     * @param {Record<string, any>} params - Query parameters to add.
+     * @returns {string} The complete URL with query parameters.
+     */
+    query(params: Record<string, any>): string;
+};
+/**
+ * Extracts specific query parameters from a URL.
+ *
+ * @param {string} url - The URL to extract parameters from.
+ * @param {string[]} paramNames - Names of parameters to extract.
+ * @returns {Record<string, string>} Object containing the extracted parameters.
+ */
+declare function extractQueryParams(url: string, paramNames: string[]): Record<string, string>;
+/**
+ * Removes specified query parameters from a URL.
+ *
+ * @param {string} url - The URL to modify.
+ * @param {string[]} paramsToRemove - Names of parameters to remove.
+ * @returns {string} URL with parameters removed.
+ */
+declare function removeQueryParams(url: string, paramsToRemove: string[]): string;
+/**
+ * Gets the file extension from a URL path.
+ *
+ * @param {string} url - The URL to examine.
+ * @returns {string} The file extension (without dot) or empty string if none found.
+ *
+ * @example
+ * getExtension('https://example.com/document.pdf?v=1');
+ * // -> 'pdf'
+ */
+declare function getExtension(url: string): string;
+/**
+ * Parses URL query parameters into a strongly-typed object.
+ *
+ * @template T Expected type of the query parameters
+ * @param {string} url - The URL to parse.
+ * @param {Record<keyof T, (val: string) => any>} [converters] - Type converters for params.
+ * @returns {Partial<T>} Typed query parameters.
+ *
+ * @example
+ * parseTypedQueryParams<{page: number, q: string}>('https://example.com?page=2&q=test', {
+ *   page: Number,
+ *   q: String
+ * });
+ * // -> { page: 2, q: 'test' }
+ */
+declare function parseTypedQueryParams<T extends Record<string, any>>(url: string, converters?: Record<keyof T, (val: string) => any>): Partial<T>;
+/**
+ * Extracts the subdomain from a URL.
+ *
+ * @param {string} url - The URL.
+ * @returns {string} Subdomain or empty string.
+ *
+ * @example
+ * getSubdomain('https://api.example.com'); // 'api'
+ * getSubdomain('https://www.blog.example.com'); // 'www.blog'
+ */
+declare function getSubdomain(url: string): string;
+/**
+ * Checks if a URL is relative (not absolute).
+ *
+ * @param {string} url - The URL to check.
+ * @returns {boolean} True if relative.
+ *
+ * @example
+ * isRelativeUrl('/path/to/page'); // true
+ * isRelativeUrl('https://example.com/page'); // false
+ */
+declare function isRelativeUrl(url: string): boolean;
+/**
+ * Converts a relative URL to an absolute URL using a base URL.
+ *
+ * @param {string} relativeUrl - The relative URL.
+ * @param {string} baseUrl - The base URL.
+ * @returns {string} Absolute URL.
+ *
+ * @example
+ * toAbsoluteUrl('/api/users', 'https://example.com'); // 'https://example.com/api/users'
+ */
+declare function toAbsoluteUrl(relativeUrl: string, baseUrl: string): string;
+/**
+ * Sanitizes a URL by removing dangerous protocols and normalizing.
+ *
+ * @param {string} url - The URL to sanitize.
+ * @param {string[]} [allowedProtocols=['http', 'https']] - Allowed protocols.
+ * @returns {string | null} Sanitized URL or null if unsafe.
+ *
+ * @example
+ * sanitizeUrl('javascript:alert(1)'); // null
+ * sanitizeUrl('https://example.com'); // 'https://example.com/'
+ */
+declare function sanitizeUrl(url: string, allowedProtocols?: string[]): string | null;
+
+export { appendQueryParams, createUrlBuilder, extractQueryParams, getDomain, getExtension, getSubdomain, isRelativeUrl, isValidUrl, joinPaths, normalizeUrl, parseQueryString, parseTypedQueryParams, removeQueryParams, sanitizeUrl, toAbsoluteUrl, updateQueryParam };

package/url/index.mjs

@@ -1,7 +1,7 @@
 /*
  * The MIT License
  * 
- * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
+ * Copyright (c) 2026 Catbee Technologies. https://catbee.in/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
@@ -88,10 +88,8 @@ function joinPaths(...segments) {
 __name(joinPaths, "joinPaths");
 function normalizeUrl(url, base) {
   try {
-    if (url.startsWith("//")) {
-      url = `https:${url}`;
-    }
-    const parsedUrl = base ? new URL(url, base) : new URL(url);
+    let normalized = url.startsWith("//") ? `https:${url}` : url;
+    const parsedUrl = base ? new URL(normalized, base) : new URL(normalized);
     parsedUrl.pathname = parsedUrl.pathname.replace(/\/+/g, "/");
     parsedUrl.pathname = parsedUrl.pathname.replace(/\/+$/, "");
     parsedUrl.hostname = parsedUrl.hostname.toLowerCase();
@@ -101,6 +99,16 @@ function normalizeUrl(url, base) {
   }
 }
 __name(normalizeUrl, "normalizeUrl");
+function updateQueryParam(url, key, value) {
+  try {
+    const urlObj = new URL(url);
+    urlObj.searchParams.set(key, String(value));
+    return urlObj.toString();
+  } catch {
+    return url;
+  }
+}
+__name(updateQueryParam, "updateQueryParam");
 function createUrlBuilder(baseUrl) {
   return {
     /**
@@ -185,5 +193,50 @@ function parseTypedQueryParams(url, converters) {
   }
 }
 __name(parseTypedQueryParams, "parseTypedQueryParams");
+function getSubdomain(url) {
+  try {
+    const { hostname } = new URL(url);
+    const parts = hostname.split(".");
+    if (parts.length <= 2) return "";
+    return parts.slice(0, -2).join(".");
+  } catch {
+    return "";
+  }
+}
+__name(getSubdomain, "getSubdomain");
+function isRelativeUrl(url) {
+  if (!url || typeof url !== "string") return false;
+  try {
+    new URL(url);
+    return false;
+  } catch {
+    return url.startsWith("/") || url.startsWith("./") || url.startsWith("../");
+  }
+}
+__name(isRelativeUrl, "isRelativeUrl");
+function toAbsoluteUrl(relativeUrl, baseUrl) {
+  try {
+    return new URL(relativeUrl, baseUrl).toString();
+  } catch {
+    return relativeUrl;
+  }
+}
+__name(toAbsoluteUrl, "toAbsoluteUrl");
+function sanitizeUrl(url, allowedProtocols = [
+  "http",
+  "https"
+]) {
+  try {
+    const parsedUrl = new URL(url);
+    const protocol = parsedUrl.protocol.replace(":", "");
+    if (!allowedProtocols.includes(protocol)) {
+      return null;
+    }
+    return parsedUrl.toString();
+  } catch {
+    return null;
+  }
+}
+__name(sanitizeUrl, "sanitizeUrl");
 
-export { appendQueryParams, createUrlBuilder, extractQueryParams, getDomain, getExtension, isValidUrl, joinPaths, normalizeUrl, parseQueryString, parseTypedQueryParams, removeQueryParams };
+export { appendQueryParams, createUrlBuilder, extractQueryParams, getDomain, getExtension, getSubdomain, isRelativeUrl, isValidUrl, joinPaths, normalizeUrl, parseQueryString, parseTypedQueryParams, removeQueryParams, sanitizeUrl, toAbsoluteUrl, updateQueryParam };

package/{validate → validation}/index.cjs

@@ -1,7 +1,7 @@
 /*
  * The MIT License
  * 
- * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
+ * Copyright (c) 2026 Catbee Technologies. https://catbee.in/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
@@ -24,25 +24,41 @@
 
 'use strict';
 
+var net = require('net');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var net__default = /*#__PURE__*/_interopDefault(net);
+
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-
-// src/validate/validate.utils.ts
+var PORT_REGEX = /^[0-9]{1,5}$/;
+var UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+var PHONE_ALLOWED_CHARS_REGEX = /^[+]?[0-9\s().-]+$/;
+var ALPHANUMERIC_REGEX = /^[A-Za-z0-9]+$/;
+var HEX_COLOR_REGEX = /^#([a-f0-9]{6}|[a-f0-9]{3})$/i;
+var ISO_DATE_REGEX = /^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})?)?$/;
+var BASE64_REGEX = /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/;
+var DOT_ATOM_REGEX = /^[A-Za-z0-9!#$%&'*+/=?^_`{|}~-]+(\.[A-Za-z0-9!#$%&'*+/=?^_`{|}~-]+)*$/;
+var QUOTED_LOCAL_REGEX = /^"([\s\x21\x23-\x5B\x5D-\x7E]|\\[\x20-\x7E])*"$/;
+var TLD_REGEX = /^[A-Za-z]{2,63}$/;
 function isPort(value) {
-  const port = typeof value === "string" ? Number(value.trim()) : value;
+  if (typeof value === "number") return Number.isInteger(value) && value > 0 && value <= 65535;
+  if (!value || typeof value !== "string") return false;
+  const str = value.trim();
+  if (!PORT_REGEX.test(str)) return false;
+  const port = Number(str);
   return Number.isInteger(port) && port > 0 && port <= 65535;
 }
 __name(isPort, "isPort");
 function isEmail(str) {
-  if (typeof str !== "string" || str.length > 254) return false;
+  if (!str || typeof str !== "string" || str.length > 254) return false;
   const atIndex = str.indexOf("@");
   if (atIndex === -1 || atIndex !== str.lastIndexOf("@")) return false;
   const local = str.slice(0, atIndex);
   const domain = str.slice(atIndex + 1);
   if (!local || !domain) return false;
-  const dotAtom = /^[A-Za-z0-9!#$%&'*+/=?^_`{|}~-]+(\.[A-Za-z0-9!#$%&'*+/=?^_`{|}~-]+)*$/;
-  const quotedLocal = /^"([\s\x21\x23-\x5B\x5D-\x7E]|\\[\x20-\x7E])*"$/;
-  if (!dotAtom.test(local) && !quotedLocal.test(local)) return false;
+  if (!DOT_ATOM_REGEX.test(local) && !QUOTED_LOCAL_REGEX.test(local)) return false;
   if (domain.includes("..")) return false;
   const labels = domain.split(".");
   if (labels.some((l) => !l.length)) return false;
@@ -52,61 +68,75 @@ function isEmail(str) {
     if (!labelRegex.test(label)) return false;
     if (label.startsWith("-") || label.endsWith("-")) return false;
   }
-  const tld = labels[labels.length - 1];
-  if (!/^[A-Za-z]{2,63}$/.test(tld)) return false;
+  const tld = labels.at(-1) || "";
+  if (!TLD_REGEX.test(tld)) return false;
   return true;
 }
 __name(isEmail, "isEmail");
 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);
+  return UUID_REGEX.test(str);
 }
 __name(isUUID, "isUUID");
-function isURL(str) {
+function isURL(str, allowedProtocols = [
+  "http",
+  "https",
+  "ws",
+  "wss"
+]) {
+  if (!str || typeof str !== "string") return false;
   try {
-    new URL(str);
-    return true;
+    const url = new URL(str);
+    return allowedProtocols.includes(url.protocol.replace(":", ""));
   } catch {
     return false;
   }
 }
 __name(isURL, "isURL");
 function isPhone(str) {
-  if (typeof str !== "string") return false;
-  const digitsOnly = str.replace(/\D/g, "");
-  if (digitsOnly.length < 6 || digitsOnly.length > 15) return false;
-  return /^[+]?[\d\s().-]+$/.test(str);
+  if (!str || typeof str !== "string") return false;
+  const digits = str.replace(/\D/g, "");
+  if (digits.length < 6 || digits.length > 15) return false;
+  return PHONE_ALLOWED_CHARS_REGEX.test(str);
 }
 __name(isPhone, "isPhone");
 function isAlphanumeric(str) {
-  return /^[a-z0-9]+$/i.test(str);
+  if (!str || typeof str !== "string") return false;
+  return ALPHANUMERIC_REGEX.test(str);
 }
 __name(isAlphanumeric, "isAlphanumeric");
 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);
+  if (typeof value === "number") return Number.isFinite(value);
+  if (!value || typeof value !== "string") return false;
+  const str = value.trim();
+  if (str === "" || str.length > 16) return false;
+  const num = Number(str);
+  return Number.isFinite(num);
 }
 __name(isNumeric, "isNumeric");
 function isHexColor(str) {
-  return /^#([a-f0-9]{6}|[a-f0-9]{3})$/i.test(str);
+  if (!str || typeof str !== "string") return false;
+  return HEX_COLOR_REGEX.test(str);
 }
 __name(isHexColor, "isHexColor");
 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;
+  if (!str || typeof str !== "string") return false;
+  if (!ISO_DATE_REGEX.test(str)) return false;
   const date = new Date(str);
-  return !isNaN(date.getTime()) && date.toISOString().startsWith(str.slice(0, 10));
+  return !Number.isNaN(date.getTime());
 }
 __name(isISODate, "isISODate");
 function isLengthBetween(str, min, max) {
+  if (typeof str !== "string") return false;
   return str.length >= min && str.length <= max;
 }
 __name(isLengthBetween, "isLengthBetween");
 function isNumberBetween(value, min, max) {
+  if (typeof value !== "number" || !Number.isFinite(value)) return false;
   return value >= min && value <= max;
 }
 __name(isNumberBetween, "isNumberBetween");
 function isAlpha(str) {
+  if (!str || typeof str !== "string") return false;
   return /^[a-zA-Z]+$/.test(str);
 }
 __name(isAlpha, "isAlpha");
@@ -120,36 +150,43 @@ function isStrongPassword(str) {
 }
 __name(isStrongPassword, "isStrongPassword");
 function isIPv4(str) {
+  if (!str || typeof str !== "string") return false;
   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;
+  return parts.every((p) => {
+    if (p.length > 3 || p.startsWith("0") && p.length > 1) return false;
+    const n = Number(p);
+    return Number.isInteger(n) && n >= 0 && n <= 255;
   });
 }
 __name(isIPv4, "isIPv4");
 function isIPv6(str) {
-  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);
+  if (!str || typeof str !== "string" || str.length > 45) return false;
+  try {
+    return net__default.default.isIP(str) === 6;
+  } catch {
+    return false;
+  }
 }
 __name(isIPv6, "isIPv6");
 function isCreditCard(str) {
-  const cardNumber = str.replace(/\D/g, "");
-  if (cardNumber.length < 13 || cardNumber.length > 19) return false;
+  if (!str || typeof str !== "string") return false;
+  const s = str.replace(/\D/g, "");
+  if (s.length < 13 || s.length > 19) return false;
   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;
+  for (let i = 0, dbl = false; i < s.length; i++, dbl = !dbl) {
+    let d = s.charCodeAt(s.length - 1 - i) - 48;
+    if (dbl) {
+      d *= 2;
+      if (d > 9) d -= 9;
     }
-    sum += digit;
-    shouldDouble = !shouldDouble;
+    sum += d;
   }
   return sum % 10 === 0;
 }
 __name(isCreditCard, "isCreditCard");
 function isValidJSON(str) {
+  if (!str || typeof str !== "string") return false;
   try {
     JSON.parse(str);
     return true;
@@ -164,26 +201,36 @@ function isArray(value, itemGuard) {
 }
 __name(isArray, "isArray");
 function isBase64(str) {
-  return /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/.test(str);
+  if (!str || typeof str !== "string") return false;
+  return BASE64_REGEX.test(str);
 }
 __name(isBase64, "isBase64");
 function hasRequiredProps(obj, requiredProps) {
-  return requiredProps.every((prop) => Object.prototype.hasOwnProperty.call(obj, prop) && obj[prop] !== void 0 && obj[prop] !== null);
+  if (!obj || typeof obj !== "object") return false;
+  return requiredProps.every((prop) => Object.hasOwn(obj, prop) && obj[prop] != null);
 }
 __name(hasRequiredProps, "hasRequiredProps");
 function isDateInRange(date, minDate, maxDate) {
-  if (!(date instanceof Date) || isNaN(date.getTime())) return false;
+  if (!(date instanceof Date) || !Number.isFinite(date.getTime())) return false;
   if (minDate && date < minDate) return false;
   if (maxDate && date > maxDate) return false;
   return true;
 }
 __name(isDateInRange, "isDateInRange");
 function matchesPattern(str, pattern) {
+  if (typeof str !== "string") return false;
   return pattern.test(str);
 }
 __name(matchesPattern, "matchesPattern");
 function validateAll(value, validators) {
-  return validators.every((validator) => validator(value));
+  if (!Array.isArray(validators)) return false;
+  return validators.every((fn) => {
+    try {
+      return fn(value);
+    } catch {
+      return false;
+    }
+  });
 }
 __name(validateAll, "validateAll");