@validex/core 1.0.0

package/dist/checks/index.d.cts

@@ -0,0 +1,207 @@
+/**
+ * Has Uppercase
+ * Checks that the string contains uppercase letters within the given bounds.
+ *
+ * @param value - The string to inspect.
+ * @param min   - Minimum number of uppercase letters required.
+ * @param max   - Maximum number of uppercase letters allowed (optional).
+ * @returns True if the uppercase letter count is within [min, max].
+ */
+declare function hasUppercase(value: string, min: number, max?: number): boolean;
+/**
+ * Has Lowercase
+ * Checks that the string contains lowercase letters within the given bounds.
+ *
+ * @param value - The string to inspect.
+ * @param min   - Minimum number of lowercase letters required.
+ * @param max   - Maximum number of lowercase letters allowed (optional).
+ * @returns True if the lowercase letter count is within [min, max].
+ */
+declare function hasLowercase(value: string, min: number, max?: number): boolean;
+/**
+ * Has Digits
+ * Checks that the string contains digit characters within the given bounds.
+ *
+ * @param value - The string to inspect.
+ * @param min   - Minimum number of digits required.
+ * @param max   - Maximum number of digits allowed (optional).
+ * @returns True if the digit count is within [min, max].
+ */
+declare function hasDigits(value: string, min: number, max?: number): boolean;
+/**
+ * Has Special
+ * Checks that the string contains special characters within the given bounds.
+ * Special characters are those that are not letters, digits, or whitespace.
+ *
+ * @param value - The string to inspect.
+ * @param min   - Minimum number of special characters required.
+ * @param max   - Maximum number of special characters allowed (optional).
+ * @returns True if the special character count is within [min, max].
+ */
+declare function hasSpecial(value: string, min: number, max?: number): boolean;
+
+/**
+ * Contains Email
+ * Returns true when the value contains what looks like an email address.
+ *
+ * @param value - The string to scan for email addresses.
+ * @returns True if an email-like pattern is detected.
+ *
+ * NOTE: Optimised for recall over precision — false positives are acceptable.
+ */
+declare function containsEmail(value: string): boolean;
+/**
+ * Contains URL
+ * Returns true when the value contains what looks like a URL.
+ *
+ * @param value - The string to scan for URLs.
+ * @returns True if a URL-like pattern is detected.
+ *
+ * NOTE: Detects both protocol-prefixed (http/https) and www-prefixed URLs.
+ */
+declare function containsUrl(value: string): boolean;
+/**
+ * Contains HTML
+ * Returns true when the value contains HTML-like tags.
+ *
+ * @param value - The string to scan for HTML tags.
+ * @returns True if an HTML tag pattern is detected.
+ *
+ * NOTE: Avoids false positives on comparison operators and emoticons.
+ */
+declare function containsHtml(value: string): boolean;
+
+/**
+ * Max Words
+ * Returns true if value has at most `max` words.
+ *
+ * @param value - The string to inspect.
+ * @param max   - Maximum number of words allowed (inclusive).
+ * @returns True if the word count is at most `max`.
+ */
+declare function maxWords(value: string, max: number): boolean;
+/**
+ * Min Words
+ * Returns true if value has at least `min` words.
+ *
+ * @param value - The string to inspect.
+ * @param min   - Minimum number of words required (inclusive).
+ * @returns True if the word count is at least `min`.
+ */
+declare function minWords(value: string, min: number): boolean;
+/**
+ * Max Consecutive
+ * Returns true if no single character repeats more than `max` times
+ * consecutively. Handles unicode characters (emoji, CJK, etc.).
+ *
+ * @param value - The string to inspect.
+ * @param max   - Maximum allowed consecutive repetitions (inclusive).
+ * @returns True if no character appears more than `max` times in a row.
+ */
+declare function maxConsecutive(value: string, max: number): boolean;
+/**
+ * No Spaces
+ * Returns true if value contains no whitespace characters.
+ *
+ * @param value - The string to inspect.
+ * @returns True if the string has no spaces, tabs, or newlines.
+ */
+declare function noSpaces(value: string): boolean;
+
+/**
+ * Contains Phone Number
+ * Returns true when the value contains a phone number, detected via
+ * libphonenumber-js. Uses dynamic import to avoid pulling the library
+ * into consumers who never call this function.
+ *
+ * @param value - The string to scan for phone numbers.
+ * @returns Resolves to true if at least one phone number is found.
+ */
+declare function containsPhoneNumber(value: string): Promise<boolean>;
+
+/**
+ * Only Alpha
+ * Returns true when every character is a unicode letter.
+ *
+ * @param value - The string to test.
+ * @returns True if the string is non-empty and contains only letters.
+ */
+declare function onlyAlpha(value: string): boolean;
+/**
+ * Only Numeric
+ * Returns true when every character is a digit (0-9).
+ *
+ * @param value - The string to test.
+ * @returns True if the string is non-empty and contains only digits.
+ */
+declare function onlyNumeric(value: string): boolean;
+/**
+ * Only Alphanumeric
+ * Returns true when every character is a unicode letter or digit.
+ *
+ * @param value - The string to test.
+ * @returns True if the string is non-empty and contains only letters and digits.
+ */
+declare function onlyAlphanumeric(value: string): boolean;
+/**
+ * Only Alphanumeric Space Hyphen
+ * Returns true when every character is a unicode letter, digit, whitespace,
+ * or hyphen.
+ *
+ * @param value - The string to test.
+ * @returns True if the string is non-empty and contains only the allowed set.
+ */
+declare function onlyAlphanumericSpaceHyphen(value: string): boolean;
+/**
+ * Only Alpha Space Hyphen
+ * Returns true when every character is a unicode letter, whitespace,
+ * or hyphen.
+ *
+ * @param value - The string to test.
+ * @returns True if the string is non-empty and contains only the allowed set.
+ */
+declare function onlyAlphaSpaceHyphen(value: string): boolean;
+
+/**
+ * Empty To Undefined
+ * Converts empty strings and null to undefined. All other values pass through.
+ *
+ * @param value - The value to inspect.
+ * @returns Undefined if value is `""` or `null`, otherwise the original value.
+ */
+declare function emptyToUndefined(value: unknown): unknown;
+/**
+ * To Title Case
+ * Converts a string to Title Case. Handles hyphens, apostrophes, and unicode.
+ *
+ * @param value - The string to transform.
+ * @returns The title-cased string.
+ */
+declare function toTitleCase(value: string): string;
+/**
+ * To Slug
+ * Converts a string to a URL-safe slug. Lowercases, replaces non-alphanumeric
+ * characters with hyphens, collapses multiple hyphens, and trims edge hyphens.
+ *
+ * @param value - The string to transform.
+ * @returns The slugified string.
+ */
+declare function toSlug(value: string): string;
+/**
+ * Strip HTML
+ * Removes HTML tags from a string.
+ *
+ * @param value - The string containing HTML.
+ * @returns The string with all HTML tags removed.
+ */
+declare function stripHtml(value: string): string;
+/**
+ * Collapse Whitespace
+ * Collapses multiple whitespace characters into a single space and trims.
+ *
+ * @param value - The string to normalize.
+ * @returns The string with collapsed whitespace.
+ */
+declare function collapseWhitespace(value: string): string;
+
+export { collapseWhitespace, containsEmail, containsHtml, containsPhoneNumber, containsUrl, emptyToUndefined, hasDigits, hasLowercase, hasSpecial, hasUppercase, maxConsecutive, maxWords, minWords, noSpaces, onlyAlpha, onlyAlphaSpaceHyphen, onlyAlphanumeric, onlyAlphanumericSpaceHyphen, onlyNumeric, stripHtml, toSlug, toTitleCase };

package/dist/checks/index.d.ts

@@ -0,0 +1,207 @@
+/**
+ * Has Uppercase
+ * Checks that the string contains uppercase letters within the given bounds.
+ *
+ * @param value - The string to inspect.
+ * @param min   - Minimum number of uppercase letters required.
+ * @param max   - Maximum number of uppercase letters allowed (optional).
+ * @returns True if the uppercase letter count is within [min, max].
+ */
+declare function hasUppercase(value: string, min: number, max?: number): boolean;
+/**
+ * Has Lowercase
+ * Checks that the string contains lowercase letters within the given bounds.
+ *
+ * @param value - The string to inspect.
+ * @param min   - Minimum number of lowercase letters required.
+ * @param max   - Maximum number of lowercase letters allowed (optional).
+ * @returns True if the lowercase letter count is within [min, max].
+ */
+declare function hasLowercase(value: string, min: number, max?: number): boolean;
+/**
+ * Has Digits
+ * Checks that the string contains digit characters within the given bounds.
+ *
+ * @param value - The string to inspect.
+ * @param min   - Minimum number of digits required.
+ * @param max   - Maximum number of digits allowed (optional).
+ * @returns True if the digit count is within [min, max].
+ */
+declare function hasDigits(value: string, min: number, max?: number): boolean;
+/**
+ * Has Special
+ * Checks that the string contains special characters within the given bounds.
+ * Special characters are those that are not letters, digits, or whitespace.
+ *
+ * @param value - The string to inspect.
+ * @param min   - Minimum number of special characters required.
+ * @param max   - Maximum number of special characters allowed (optional).
+ * @returns True if the special character count is within [min, max].
+ */
+declare function hasSpecial(value: string, min: number, max?: number): boolean;
+
+/**
+ * Contains Email
+ * Returns true when the value contains what looks like an email address.
+ *
+ * @param value - The string to scan for email addresses.
+ * @returns True if an email-like pattern is detected.
+ *
+ * NOTE: Optimised for recall over precision — false positives are acceptable.
+ */
+declare function containsEmail(value: string): boolean;
+/**
+ * Contains URL
+ * Returns true when the value contains what looks like a URL.
+ *
+ * @param value - The string to scan for URLs.
+ * @returns True if a URL-like pattern is detected.
+ *
+ * NOTE: Detects both protocol-prefixed (http/https) and www-prefixed URLs.
+ */
+declare function containsUrl(value: string): boolean;
+/**
+ * Contains HTML
+ * Returns true when the value contains HTML-like tags.
+ *
+ * @param value - The string to scan for HTML tags.
+ * @returns True if an HTML tag pattern is detected.
+ *
+ * NOTE: Avoids false positives on comparison operators and emoticons.
+ */
+declare function containsHtml(value: string): boolean;
+
+/**
+ * Max Words
+ * Returns true if value has at most `max` words.
+ *
+ * @param value - The string to inspect.
+ * @param max   - Maximum number of words allowed (inclusive).
+ * @returns True if the word count is at most `max`.
+ */
+declare function maxWords(value: string, max: number): boolean;
+/**
+ * Min Words
+ * Returns true if value has at least `min` words.
+ *
+ * @param value - The string to inspect.
+ * @param min   - Minimum number of words required (inclusive).
+ * @returns True if the word count is at least `min`.
+ */
+declare function minWords(value: string, min: number): boolean;
+/**
+ * Max Consecutive
+ * Returns true if no single character repeats more than `max` times
+ * consecutively. Handles unicode characters (emoji, CJK, etc.).
+ *
+ * @param value - The string to inspect.
+ * @param max   - Maximum allowed consecutive repetitions (inclusive).
+ * @returns True if no character appears more than `max` times in a row.
+ */
+declare function maxConsecutive(value: string, max: number): boolean;
+/**
+ * No Spaces
+ * Returns true if value contains no whitespace characters.
+ *
+ * @param value - The string to inspect.
+ * @returns True if the string has no spaces, tabs, or newlines.
+ */
+declare function noSpaces(value: string): boolean;
+
+/**
+ * Contains Phone Number
+ * Returns true when the value contains a phone number, detected via
+ * libphonenumber-js. Uses dynamic import to avoid pulling the library
+ * into consumers who never call this function.
+ *
+ * @param value - The string to scan for phone numbers.
+ * @returns Resolves to true if at least one phone number is found.
+ */
+declare function containsPhoneNumber(value: string): Promise<boolean>;
+
+/**
+ * Only Alpha
+ * Returns true when every character is a unicode letter.
+ *
+ * @param value - The string to test.
+ * @returns True if the string is non-empty and contains only letters.
+ */
+declare function onlyAlpha(value: string): boolean;
+/**
+ * Only Numeric
+ * Returns true when every character is a digit (0-9).
+ *
+ * @param value - The string to test.
+ * @returns True if the string is non-empty and contains only digits.
+ */
+declare function onlyNumeric(value: string): boolean;
+/**
+ * Only Alphanumeric
+ * Returns true when every character is a unicode letter or digit.
+ *
+ * @param value - The string to test.
+ * @returns True if the string is non-empty and contains only letters and digits.
+ */
+declare function onlyAlphanumeric(value: string): boolean;
+/**
+ * Only Alphanumeric Space Hyphen
+ * Returns true when every character is a unicode letter, digit, whitespace,
+ * or hyphen.
+ *
+ * @param value - The string to test.
+ * @returns True if the string is non-empty and contains only the allowed set.
+ */
+declare function onlyAlphanumericSpaceHyphen(value: string): boolean;
+/**
+ * Only Alpha Space Hyphen
+ * Returns true when every character is a unicode letter, whitespace,
+ * or hyphen.
+ *
+ * @param value - The string to test.
+ * @returns True if the string is non-empty and contains only the allowed set.
+ */
+declare function onlyAlphaSpaceHyphen(value: string): boolean;
+
+/**
+ * Empty To Undefined
+ * Converts empty strings and null to undefined. All other values pass through.
+ *
+ * @param value - The value to inspect.
+ * @returns Undefined if value is `""` or `null`, otherwise the original value.
+ */
+declare function emptyToUndefined(value: unknown): unknown;
+/**
+ * To Title Case
+ * Converts a string to Title Case. Handles hyphens, apostrophes, and unicode.
+ *
+ * @param value - The string to transform.
+ * @returns The title-cased string.
+ */
+declare function toTitleCase(value: string): string;
+/**
+ * To Slug
+ * Converts a string to a URL-safe slug. Lowercases, replaces non-alphanumeric
+ * characters with hyphens, collapses multiple hyphens, and trims edge hyphens.
+ *
+ * @param value - The string to transform.
+ * @returns The slugified string.
+ */
+declare function toSlug(value: string): string;
+/**
+ * Strip HTML
+ * Removes HTML tags from a string.
+ *
+ * @param value - The string containing HTML.
+ * @returns The string with all HTML tags removed.
+ */
+declare function stripHtml(value: string): string;
+/**
+ * Collapse Whitespace
+ * Collapses multiple whitespace characters into a single space and trims.
+ *
+ * @param value - The string to normalize.
+ * @returns The string with collapsed whitespace.
+ */
+declare function collapseWhitespace(value: string): string;
+
+export { collapseWhitespace, containsEmail, containsHtml, containsPhoneNumber, containsUrl, emptyToUndefined, hasDigits, hasLowercase, hasSpecial, hasUppercase, maxConsecutive, maxWords, minWords, noSpaces, onlyAlpha, onlyAlphaSpaceHyphen, onlyAlphanumeric, onlyAlphanumericSpaceHyphen, onlyNumeric, stripHtml, toSlug, toTitleCase };

package/dist/checks/index.js

@@ -0,0 +1,51 @@
+import "../chunk-4HUGF4EZ.js";
+import {
+  collapseWhitespace,
+  containsEmail,
+  containsHtml,
+  containsUrl,
+  emptyToUndefined,
+  hasDigits,
+  hasLowercase,
+  hasSpecial,
+  hasUppercase,
+  maxConsecutive,
+  maxWords,
+  minWords,
+  noSpaces,
+  onlyAlpha,
+  onlyAlphaSpaceHyphen,
+  onlyAlphanumeric,
+  onlyAlphanumericSpaceHyphen,
+  onlyNumeric,
+  stripHtml,
+  toSlug,
+  toTitleCase
+} from "../chunk-6MGS4JWP.js";
+import {
+  containsPhoneNumber
+} from "../chunk-FD77PZXB.js";
+export {
+  collapseWhitespace,
+  containsEmail,
+  containsHtml,
+  containsPhoneNumber,
+  containsUrl,
+  emptyToUndefined,
+  hasDigits,
+  hasLowercase,
+  hasSpecial,
+  hasUppercase,
+  maxConsecutive,
+  maxWords,
+  minWords,
+  noSpaces,
+  onlyAlpha,
+  onlyAlphaSpaceHyphen,
+  onlyAlphanumeric,
+  onlyAlphanumericSpaceHyphen,
+  onlyNumeric,
+  stripHtml,
+  toSlug,
+  toTitleCase
+};

package/dist/chunk-2OTGUKO7.cjs

@@ -0,0 +1,26 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } }// src/loaders/currencyCodes.ts
+var cache;
+async function loadCurrencyCodes() {
+  if (cache !== void 0)
+    return cache;
+  const raw = (await Promise.resolve().then(() => _interopRequireWildcard(require("./currencyCodes-GU6W3HSN.cjs")))).default;
+  cache = new Set(raw);
+  return cache;
+}
+function getCurrencyCodes() {
+  if (cache === void 0) {
+    throw new Error(
+      "validex: Currency codes not loaded. Use parseAsync() or call preloadData() first."
+    );
+  }
+  return cache;
+}
+function clearCurrencyCodesCache() {
+  cache = void 0;
+}
+
+
+
+
+
+exports.loadCurrencyCodes = loadCurrencyCodes; exports.getCurrencyCodes = getCurrencyCodes; exports.clearCurrencyCodesCache = clearCurrencyCodesCache;

package/dist/chunk-5CYBSNNG.cjs

@@ -0,0 +1,33 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } }// src/loaders/ibanPatterns.ts
+var cache;
+async function loadIbanPatterns() {
+  if (cache !== void 0)
+    return cache;
+  const raw = (await Promise.resolve().then(() => _interopRequireWildcard(require("./ibanPatterns-2PM32RIY.cjs")))).default;
+  const map = /* @__PURE__ */ new Map();
+  for (const entry of raw) {
+    map.set(entry.country, {
+      length: entry.length,
+      regex: new RegExp(entry.regex)
+    });
+  }
+  cache = map;
+  return cache;
+}
+function getIbanPatterns() {
+  if (cache === void 0) {
+    throw new Error(
+      "validex: IBAN patterns not loaded. Use parseAsync() or call preloadData() first."
+    );
+  }
+  return cache;
+}
+function clearIbanPatternsCache() {
+  cache = void 0;
+}
+
+
+
+
+
+exports.loadIbanPatterns = loadIbanPatterns; exports.getIbanPatterns = getIbanPatterns; exports.clearIbanPatternsCache = clearIbanPatternsCache;

package/dist/chunk-5DOFRLSB.js

@@ -0,0 +1,30 @@
+// src/loaders/vatPatterns.ts
+var cache;
+async function loadVatPatterns() {
+  if (cache !== void 0)
+    return cache;
+  const raw = (await import("./vatPatterns-BLRXHNCP.js")).default;
+  const map = /* @__PURE__ */ new Map();
+  for (const entry of raw) {
+    map.set(entry.country, new RegExp(entry.regex));
+  }
+  cache = map;
+  return cache;
+}
+function getVatPatterns() {
+  if (cache === void 0) {
+    throw new Error(
+      "validex: VAT patterns not loaded. Use parseAsync() or call preloadData() first."
+    );
+  }
+  return cache;
+}
+function clearVatPatternsCache() {
+  cache = void 0;
+}
+
+export {
+  loadVatPatterns,
+  getVatPatterns,
+  clearVatPatternsCache
+};

package/dist/chunk-64X6D23X.cjs

@@ -0,0 +1,24 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } }// src/loaders/disposableDomains.ts
+var cache;
+async function loadDisposableDomains() {
+  if (cache !== void 0)
+    return cache;
+  const { disposableEmailBlocklistSet } = await Promise.resolve().then(() => _interopRequireWildcard(require("disposable-email-domains-js")));
+  cache = disposableEmailBlocklistSet();
+  return cache;
+}
+function getDisposableDomains() {
+  if (cache === void 0) {
+    throw new Error("Disposable domains not loaded. Call loadDisposableDomains() or preloadData({ disposable: true }) first.");
+  }
+  return cache;
+}
+function clearDisposableDomainsCache() {
+  cache = void 0;
+}
+
+
+
+
+
+exports.loadDisposableDomains = loadDisposableDomains; exports.getDisposableDomains = getDisposableDomains; exports.clearDisposableDomainsCache = clearDisposableDomainsCache;