@catbee/utils 1.0.5 → 2.0.0-next.0

package/validate/index.mjs

@@ -0,0 +1,188 @@
+/*
+ * 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.
+ */
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/validate/validate.utils.ts
+function isPort(value) {
+  const port = typeof value === "string" ? Number(value.trim()) : value;
+  return Number.isInteger(port) && port > 0 && port <= 65535;
+}
+__name(isPort, "isPort");
+function isEmail(str) {
+  if (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 (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 (!/^[A-Za-z]{2,63}$/.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);
+}
+__name(isUUID, "isUUID");
+function isURL(str) {
+  try {
+    new URL(str);
+    return true;
+  } 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);
+}
+__name(isPhone, "isPhone");
+function isAlphanumeric(str) {
+  return /^[a-z0-9]+$/i.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);
+}
+__name(isNumeric, "isNumeric");
+function isHexColor(str) {
+  return /^#([a-f0-9]{6}|[a-f0-9]{3})$/i.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;
+  const date = new Date(str);
+  return !isNaN(date.getTime()) && date.toISOString().startsWith(str.slice(0, 10));
+}
+__name(isISODate, "isISODate");
+function isLengthBetween(str, min, max) {
+  return str.length >= min && str.length <= max;
+}
+__name(isLengthBetween, "isLengthBetween");
+function isNumberBetween(value, min, max) {
+  return value >= min && value <= max;
+}
+__name(isNumberBetween, "isNumberBetween");
+function isAlpha(str) {
+  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) {
+  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;
+  });
+}
+__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);
+}
+__name(isIPv6, "isIPv6");
+function isCreditCard(str) {
+  const cardNumber = str.replace(/\D/g, "");
+  if (cardNumber.length < 13 || cardNumber.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;
+    }
+    sum += digit;
+    shouldDouble = !shouldDouble;
+  }
+  return sum % 10 === 0;
+}
+__name(isCreditCard, "isCreditCard");
+function isValidJSON(str) {
+  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) {
+  return /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/.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);
+}
+__name(hasRequiredProps, "hasRequiredProps");
+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;
+}
+__name(isDateInRange, "isDateInRange");
+function matchesPattern(str, pattern) {
+  return pattern.test(str);
+}
+__name(matchesPattern, "matchesPattern");
+function validateAll(value, validators) {
+  return validators.every((validator) => validator(value));
+}
+__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 };

package/validate/validate.utils.d.ts

@@ -0,0 +1,200 @@
+/*
+ * 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.
+ */
+export 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.
+ */
+export 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.
+ */
+export declare function isUUID(str: string): boolean;
+/**
+ * Checks if a string is a valid URL.
+ *
+ * @param {string} str - The input string.
+ * @returns {boolean} True if valid URL, else false.
+ */
+export declare function isURL(str: 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.
+ */
+export 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.
+ */
+export 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.
+ */
+export 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}
+ */
+export declare function isHexColor(str: string): boolean;
+/**
+ * Checks if a string is a valid date string.
+ *
+ * @param {string} str - Input string.
+ * @returns {boolean}
+ */
+export 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.
+ */
+export 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.
+ */
+export 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.
+ */
+export 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.
+ *
+ * @param {string} str - The input string.
+ * @returns {boolean} True if string meets password complexity requirements.
+ */
+export 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.
+ */
+export 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.
+ */
+export 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.
+ */
+export 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.
+ */
+export 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).
+ */
+export 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.
+ */
+export 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.
+ */
+export 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.
+ */
+export 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.
+ */
+export 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.
+ */
+export declare function validateAll(value: unknown, validators: Array<(value: unknown) => boolean>): boolean;