@catbee/utils 2.0.0-next.0 → 2.0.0-next.1

package/url/index.cjs

@@ -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();

package/url/index.d.ts

@@ -22,4 +22,145 @@
  * 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;
+/**
+ * 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>;
+
+export { appendQueryParams, createUrlBuilder, extractQueryParams, getDomain, getExtension, isValidUrl, joinPaths, normalizeUrl, parseQueryString, parseTypedQueryParams, removeQueryParams };

package/url/index.mjs

@@ -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();

package/{validate → validation}/index.cjs

@@ -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;
@@ -53,60 +69,74 @@ function isEmail(str) {
     if (label.startsWith("-") || label.endsWith("-")) return false;
   }
   const tld = labels[labels.length - 1];
-  if (!/^[A-Za-z]{2,63}$/.test(tld)) return false;
+  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.prototype.hasOwnProperty.call(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");
 

package/{validate/validate.utils.d.ts → validation/index.d.ts}

@@ -31,63 +31,64 @@
  * @param str - The input string or number.
  * @returns True if valid port number, else false.
  */
-export declare function isPort(value: string | number): boolean;
+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;
+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;
+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.
  */
-export declare function isURL(str: string): boolean;
+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.
  */
-export declare function isPhone(str: string): boolean;
+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;
+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;
+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;
+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;
+declare function isISODate(str: string): boolean;
 /**
  * Checks if a string matches a specified length range.
  *
@@ -96,7 +97,7 @@ export declare function isISODate(str: string): boolean;
  * @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;
+declare function isLengthBetween(str: string, min: number, max: number): boolean;
 /**
  * Validates that a number is between specified min and max values (inclusive).
  *
@@ -105,50 +106,56 @@ export declare function isLengthBetween(str: string, min: number, max: number):
  * @param {number} max - Maximum value.
  * @returns {boolean} True if number is within range.
  */
-export declare function isNumberBetween(value: number, min: number, max: number): boolean;
+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;
+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.
  */
-export declare function isStrongPassword(str: string): boolean;
+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;
+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;
+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;
+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;
+declare function isValidJSON(str: string): boolean;
 /**
  * Type guard that checks if a value is an array.
  *
@@ -157,14 +164,14 @@ export declare function isValidJSON(str: string): boolean;
  * @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[];
+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;
+declare function isBase64(str: string): boolean;
 /**
  * Validates that an object has all required properties.
  *
@@ -172,7 +179,7 @@ export declare function isBase64(str: string): boolean;
  * @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;
+declare function hasRequiredProps(obj: Record<string, unknown>, requiredProps: string[]): boolean;
 /**
  * Validates a date is within a specified range.
  *
@@ -181,7 +188,7 @@ export declare function hasRequiredProps(obj: Record<string, unknown>, requiredP
  * @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;
+declare function isDateInRange(date: Date, minDate?: Date, maxDate?: Date): boolean;
 /**
  * Validates a string matches a specific regular expression pattern.
  *
@@ -189,7 +196,7 @@ export declare function isDateInRange(date: Date, minDate?: Date, maxDate?: Date
  * @param {RegExp} pattern - Regular expression to test against.
  * @returns {boolean} True if string matches pattern.
  */
-export declare function matchesPattern(str: string, pattern: RegExp): boolean;
+declare function matchesPattern(str: string, pattern: RegExp): boolean;
 /**
  * Validates data against multiple constraints.
  *
@@ -197,4 +204,6 @@ export declare function matchesPattern(str: string, pattern: RegExp): boolean;
  * @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;
+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 };