@catbee/utils 1.1.0 → 2.0.0-next.1

package/validation/index.cjs

@@ -0,0 +1,259 @@
+/*
+ * The MIT License
+ * 
+ * Copyright (c) 2025 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
+ * 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.
+ */
+
+'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 });
+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) {
+  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 (!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;
+  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;
+  if (labels.length < 2) return false;
+  const labelRegex = /^[A-Za-z0-9-]{1,63}$/;
+  for (const label of labels) {
+    if (!labelRegex.test(label)) return false;
+    if (label.startsWith("-") || label.endsWith("-")) return false;
+  }
+  const tld = labels[labels.length - 1];
+  if (!TLD_REGEX.test(tld)) return false;
+  return true;
+}
+__name(isEmail, "isEmail");
+function isUUID(str) {
+  return UUID_REGEX.test(str);
+}
+__name(isUUID, "isUUID");
+function isURL(str, allowedProtocols = [
+  "http",
+  "https",
+  "ws",
+  "wss"
+]) {
+  if (!str || typeof str !== "string") return false;
+  try {
+    const url = new URL(str);
+    return allowedProtocols.includes(url.protocol.replace(":", ""));
+  } catch {
+    return false;
+  }
+}
+__name(isURL, "isURL");
+function isPhone(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) {
+  if (!str || typeof str !== "string") return false;
+  return ALPHANUMERIC_REGEX.test(str);
+}
+__name(isAlphanumeric, "isAlphanumeric");
+function isNumeric(value) {
+  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) {
+  if (!str || typeof str !== "string") return false;
+  return HEX_COLOR_REGEX.test(str);
+}
+__name(isHexColor, "isHexColor");
+function isISODate(str) {
+  if (!str || typeof str !== "string") return false;
+  if (!ISO_DATE_REGEX.test(str)) return false;
+  const date = new Date(str);
+  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");
+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;
+}
+__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((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) {
+  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) {
+  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;
+  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 += d;
+  }
+  return sum % 10 === 0;
+}
+__name(isCreditCard, "isCreditCard");
+function isValidJSON(str) {
+  if (!str || typeof str !== "string") return false;
+  try {
+    JSON.parse(str);
+    return true;
+  } catch {
+    return false;
+  }
+}
+__name(isValidJSON, "isValidJSON");
+function isArray(value, itemGuard) {
+  if (!Array.isArray(value)) return false;
+  return !itemGuard || value.every((item) => itemGuard(item));
+}
+__name(isArray, "isArray");
+function isBase64(str) {
+  if (!str || typeof str !== "string") return false;
+  return BASE64_REGEX.test(str);
+}
+__name(isBase64, "isBase64");
+function hasRequiredProps(obj, requiredProps) {
+  if (!obj || typeof obj !== "object") return false;
+  return requiredProps.every((prop) => Object.prototype.hasOwnProperty.call(obj, prop) && obj[prop] != null);
+}
+__name(hasRequiredProps, "hasRequiredProps");
+function isDateInRange(date, minDate, maxDate) {
+  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) {
+  if (!Array.isArray(validators)) return false;
+  return validators.every((fn) => {
+    try {
+      return fn(value);
+    } catch {
+      return false;
+    }
+  });
+}
+__name(validateAll, "validateAll");
+
+exports.hasRequiredProps = hasRequiredProps;
+exports.isAlpha = isAlpha;
+exports.isAlphanumeric = isAlphanumeric;
+exports.isArray = isArray;
+exports.isBase64 = isBase64;
+exports.isCreditCard = isCreditCard;
+exports.isDateInRange = isDateInRange;
+exports.isEmail = isEmail;
+exports.isHexColor = isHexColor;
+exports.isIPv4 = isIPv4;
+exports.isIPv6 = isIPv6;
+exports.isISODate = isISODate;
+exports.isLengthBetween = isLengthBetween;
+exports.isNumberBetween = isNumberBetween;
+exports.isNumeric = isNumeric;
+exports.isPhone = isPhone;
+exports.isPort = isPort;
+exports.isStrongPassword = isStrongPassword;
+exports.isURL = isURL;
+exports.isUUID = isUUID;
+exports.isValidJSON = isValidJSON;
+exports.matchesPattern = matchesPattern;
+exports.validateAll = validateAll;

package/validation/index.d.ts

@@ -0,0 +1,209 @@
+/*
+ * The MIT License
+ * 
+ * Copyright (c) 2025 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
+ * 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.
+ */
+declare function isPort(value: string | number): boolean;
+/**
+ * Checks if a string is a valid email address.
+ *
+ * @param {string} str - The input string.
+ * @returns {boolean} True if valid email, else false.
+ */
+declare function isEmail(str: string): boolean;
+/**
+ * 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.
+ */
+declare function isUUID(str: string): boolean;
+/**
+ * Checks if a string is a valid URL.
+ *
+ * @param {string} str - The input string.
+ * @param {string[]} [allowedProtocols=['http', 'https', 'ws', 'wss']] - Allowed URL protocols.
+ * @returns {boolean} True if valid URL, else false.
+ */
+declare function isURL(str: string, allowedProtocols?: string[]): boolean;
+/**
+ * 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.
+ */
+declare function isPhone(str: string): boolean;
+/**
+ * Checks if a string is strictly alphanumeric (letters/numbers only).
+ *
+ * @param {string} str - The input string.
+ * @returns {boolean} True if alphanumeric.
+ */
+declare function isAlphanumeric(str: string): boolean;
+/**
+ * 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.
+ */
+declare function isNumeric(value: string | number): boolean;
+/**
+ * Checks if a string is a valid hex color code (e.g. #FFF or #FFFFFF).
+ *
+ * @param {string} str - Input string.
+ * @returns {boolean}
+ */
+declare function isHexColor(str: string): boolean;
+/**
+ * Checks if a string is a valid date string.
+ *
+ * @param {string} str - Input string.
+ * @returns {boolean}
+ */
+declare function isISODate(str: string): boolean;
+/**
+ * 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.
+ */
+declare function isLengthBetween(str: string, min: number, max: number): boolean;
+/**
+ * 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.
+ */
+declare function isNumberBetween(value: number, min: number, max: number): boolean;
+/**
+ * Checks if a string contains only alphabetic characters.
+ *
+ * @param {string} str - The input string.
+ * @returns {boolean} True if alphabetic only.
+ */
+declare function isAlpha(str: string): boolean;
+/**
+ * Validates that a string contains at least one uppercase letter,
+ * one lowercase letter, one number, and one special character.
+ *
+ * - Minimum length of 8 characters.
+ * - At least one uppercase letter (A-Z).
+ * - At least one lowercase letter (a-z).
+ * - At least one digit (0-9).
+ * - At least one special character e.g. !@#$%^&*()_+-=[]{};':"\\|,.<>?/
+ *
+ * @param {string} str - The input string.
+ * @returns {boolean} True if string meets password complexity requirements.
+ */
+declare function isStrongPassword(str: string): boolean;
+/**
+ * Checks if a string is a valid IPv4 address.
+ *
+ * @param {string} str - The input string.
+ * @returns {boolean} True if valid IPv4 address.
+ */
+declare function isIPv4(str: string): boolean;
+/**
+ * Checks if a string is a valid IPv6 address.
+ *
+ * @param {string} str - The input string.
+ * @returns {boolean} True if valid IPv6 address.
+ */
+declare function isIPv6(str: string): boolean;
+/**
+ * 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.
+ */
+declare function isCreditCard(str: string): boolean;
+/**
+ * Checks if a string is a valid JSON.
+ *
+ * @param {string} str - The input string.
+ * @returns {boolean} True if valid JSON.
+ */
+declare function isValidJSON(str: string): boolean;
+/**
+ * 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).
+ */
+declare function isArray<T = unknown>(value: unknown, itemGuard?: (item: unknown) => item is T): value is T[];
+/**
+ * Checks if a string is a valid base64 encoded string.
+ *
+ * @param {string} str - The input string.
+ * @returns {boolean} True if valid base64.
+ */
+declare function isBase64(str: string): boolean;
+/**
+ * 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.
+ */
+declare function hasRequiredProps(obj: Record<string, unknown>, requiredProps: string[]): boolean;
+/**
+ * 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.
+ */
+declare function isDateInRange(date: Date, minDate?: Date, maxDate?: Date): boolean;
+/**
+ * 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.
+ */
+declare function matchesPattern(str: string, pattern: RegExp): boolean;
+/**
+ * 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.
+ */
+declare function validateAll(value: unknown, validators: Array<(value: unknown) => boolean>): boolean;
+
+export { hasRequiredProps, isAlpha, isAlphanumeric, isArray, isBase64, isCreditCard, isDateInRange, isEmail, isHexColor, isIPv4, isIPv6, isISODate, isLengthBetween, isNumberBetween, isNumeric, isPhone, isPort, isStrongPassword, isURL, isUUID, isValidJSON, matchesPattern, validateAll };

package/validation/index.mjs

@@ -0,0 +1,231 @@
+/*
+ * The MIT License
+ * 
+ * Copyright (c) 2025 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
+ * 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.
+ */
+
+import net from 'net';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+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) {
+  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 (!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;
+  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;
+  if (labels.length < 2) return false;
+  const labelRegex = /^[A-Za-z0-9-]{1,63}$/;
+  for (const label of labels) {
+    if (!labelRegex.test(label)) return false;
+    if (label.startsWith("-") || label.endsWith("-")) return false;
+  }
+  const tld = labels[labels.length - 1];
+  if (!TLD_REGEX.test(tld)) return false;
+  return true;
+}
+__name(isEmail, "isEmail");
+function isUUID(str) {
+  return UUID_REGEX.test(str);
+}
+__name(isUUID, "isUUID");
+function isURL(str, allowedProtocols = [
+  "http",
+  "https",
+  "ws",
+  "wss"
+]) {
+  if (!str || typeof str !== "string") return false;
+  try {
+    const url = new URL(str);
+    return allowedProtocols.includes(url.protocol.replace(":", ""));
+  } catch {
+    return false;
+  }
+}
+__name(isURL, "isURL");
+function isPhone(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) {
+  if (!str || typeof str !== "string") return false;
+  return ALPHANUMERIC_REGEX.test(str);
+}
+__name(isAlphanumeric, "isAlphanumeric");
+function isNumeric(value) {
+  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) {
+  if (!str || typeof str !== "string") return false;
+  return HEX_COLOR_REGEX.test(str);
+}
+__name(isHexColor, "isHexColor");
+function isISODate(str) {
+  if (!str || typeof str !== "string") return false;
+  if (!ISO_DATE_REGEX.test(str)) return false;
+  const date = new Date(str);
+  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");
+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;
+}
+__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((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) {
+  if (!str || typeof str !== "string" || str.length > 45) return false;
+  try {
+    return net.isIP(str) === 6;
+  } catch {
+    return false;
+  }
+}
+__name(isIPv6, "isIPv6");
+function isCreditCard(str) {
+  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;
+  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 += d;
+  }
+  return sum % 10 === 0;
+}
+__name(isCreditCard, "isCreditCard");
+function isValidJSON(str) {
+  if (!str || typeof str !== "string") return false;
+  try {
+    JSON.parse(str);
+    return true;
+  } catch {
+    return false;
+  }
+}
+__name(isValidJSON, "isValidJSON");
+function isArray(value, itemGuard) {
+  if (!Array.isArray(value)) return false;
+  return !itemGuard || value.every((item) => itemGuard(item));
+}
+__name(isArray, "isArray");
+function isBase64(str) {
+  if (!str || typeof str !== "string") return false;
+  return BASE64_REGEX.test(str);
+}
+__name(isBase64, "isBase64");
+function hasRequiredProps(obj, requiredProps) {
+  if (!obj || typeof obj !== "object") return false;
+  return requiredProps.every((prop) => Object.prototype.hasOwnProperty.call(obj, prop) && obj[prop] != null);
+}
+__name(hasRequiredProps, "hasRequiredProps");
+function isDateInRange(date, minDate, maxDate) {
+  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) {
+  if (!Array.isArray(validators)) return false;
+  return validators.every((fn) => {
+    try {
+      return fn(value);
+    } catch {
+      return false;
+    }
+  });
+}
+__name(validateAll, "validateAll");
+
+export { hasRequiredProps, isAlpha, isAlphanumeric, isArray, isBase64, isCreditCard, isDateInRange, isEmail, isHexColor, isIPv4, isIPv6, isISODate, isLengthBetween, isNumberBetween, isNumeric, isPhone, isPort, isStrongPassword, isURL, isUUID, isValidJSON, matchesPattern, validateAll };