@archi-code/validation 0.0.0-stage → 3.0.0-alpha.1

package/dist/esm/helpers/escapeRegExp.d.ts

@@ -0,0 +1 @@
+export declare function escapeRegExp(text: string): string;

package/dist/esm/helpers/escapeRegExp.js

@@ -0,0 +1,3 @@
+export function escapeRegExp(text) {
+    return text.replace(/[.*+?^${}()|[\]\\-]/g, '\\$&');
+}

package/dist/esm/helpers/hasOwn.d.ts

@@ -0,0 +1 @@
+export declare function hasOwn<T extends object>(table: T, key: unknown): key is keyof T;

package/dist/esm/helpers/hasOwn.js

@@ -0,0 +1,3 @@
+export function hasOwn(table, key) {
+    return typeof key === 'string' && Object.prototype.hasOwnProperty.call(table, key);
+}

package/dist/esm/helpers/merge.d.ts

@@ -0,0 +1 @@
+export declare function merge<T extends object, D extends object>(obj: T | null | undefined, defaults: D): T & D;

package/dist/esm/helpers/merge.js

@@ -0,0 +1,12 @@
+export function merge(obj, defaults) {
+    if (obj === null || typeof obj !== 'object') {
+        return { ...defaults };
+    }
+    const result = { ...obj };
+    for (const key in defaults) {
+        if (typeof result[key] === 'undefined') {
+            result[key] = defaults[key];
+        }
+    }
+    return result;
+}

package/dist/esm/helpers/scorePassword.d.ts

@@ -0,0 +1,9 @@
+export interface ScorePasswordOptions {
+    pointsPerUnique?: number;
+    pointsPerRepeat?: number;
+    pointsForContainingLower?: number;
+    pointsForContainingUpper?: number;
+    pointsForContainingNumber?: number;
+    pointsForContainingSymbol?: number;
+}
+export declare function scorePassword(str: unknown, options?: ScorePasswordOptions): number;

package/dist/esm/helpers/scorePassword.js

@@ -0,0 +1,34 @@
+import { merge } from './merge.js';
+import { analyzePassword } from './analyzePassword.js';
+import { toString } from '../convert/string.js';
+const defaultOptions = {
+    pointsPerUnique: 1,
+    pointsPerRepeat: 0.5,
+    pointsForContainingLower: 10,
+    pointsForContainingUpper: 10,
+    pointsForContainingNumber: 10,
+    pointsForContainingSymbol: 10,
+};
+export function scorePassword(str, options) {
+    const stringResult = toString(str);
+    if (!stringResult.ok)
+        return 0;
+    const analysis = analyzePassword(stringResult.value);
+    const scoringOptions = merge(options || {}, defaultOptions);
+    let points = 0;
+    points += analysis.uniqueChars * scoringOptions.pointsPerUnique;
+    points += (analysis.length - analysis.uniqueChars) * scoringOptions.pointsPerRepeat;
+    if (analysis.lowercaseCount > 0) {
+        points += scoringOptions.pointsForContainingLower;
+    }
+    if (analysis.uppercaseCount > 0) {
+        points += scoringOptions.pointsForContainingUpper;
+    }
+    if (analysis.numberCount > 0) {
+        points += scoringOptions.pointsForContainingNumber;
+    }
+    if (analysis.symbolCount > 0) {
+        points += scoringOptions.pointsForContainingSymbol;
+    }
+    return points;
+}

package/dist/esm/index.d.ts

@@ -0,0 +1,103 @@
+export { validator } from './validators/index.js';
+export { equals } from './validators/equals.js';
+export { contains } from './validators/contains.js';
+export { matches } from './validators/matches.js';
+export { isEmail } from './validators/isEmail.js';
+export { isURL } from './validators/isURL.js';
+export { isMACAddress } from './validators/isMACAddress.js';
+export { isIP } from './validators/isIP.js';
+export { isIPRange } from './validators/isIPRange.js';
+export { isFQDN } from './validators/isFQDN.js';
+export { isBoolean } from './validators/isBoolean.js';
+export { isIBAN, locales as ibanLocales } from './validators/isIBAN.js';
+export { isBIC } from './validators/isBIC.js';
+export { isAbaRouting } from './validators/isAbaRouting.js';
+export { isAlpha, locales as isAlphaLocales } from './validators/isAlpha.js';
+export { isAlphanumeric, locales as isAlphanumericLocales } from './validators/isAlphanumeric.js';
+export { isNumeric } from './validators/isNumeric.js';
+export { isPassportNumber, locales as passportNumberLocales } from './validators/isPassportNumber.js';
+export { isPort } from './validators/isPort.js';
+export { isLowercase } from './validators/isLowercase.js';
+export { isUppercase } from './validators/isUppercase.js';
+export { isAscii } from './validators/isAscii.js';
+export { isFullWidth } from './validators/isFullWidth.js';
+export { isHalfWidth } from './validators/isHalfWidth.js';
+export { isVariableWidth } from './validators/isVariableWidth.js';
+export { isMultibyte } from './validators/isMultibyte.js';
+export { isSemVer } from './validators/isSemVer.js';
+export { isSurrogatePair } from './validators/isSurrogatePair.js';
+export { isInt } from './validators/isInt.js';
+export { isIMEI } from './validators/isIMEI.js';
+export { isFloat, locales as isFloatLocales } from './validators/isFloat.js';
+export { isDecimal } from './validators/isDecimal.js';
+export { isHexadecimal } from './validators/isHexadecimal.js';
+export { isOctal } from './validators/isOctal.js';
+export { isDivisibleBy } from './validators/isDivisibleBy.js';
+export { isHexColor } from './validators/isHexColor.js';
+export { isRgbColor } from './validators/isRgbColor.js';
+export { isHSL } from './validators/isHSL.js';
+export { isISRC } from './validators/isISRC.js';
+export { isMD5 } from './validators/isMD5.js';
+export { isHash } from './validators/isHash.js';
+export { isJWT } from './validators/isJWT.js';
+export { isJSON } from './validators/isJSON.js';
+export { isEmpty } from './validators/isEmpty.js';
+export { isNotEmpty } from './validators/isNotEmpty.js';
+export { isRequired } from './validators/isRequired.js';
+export { isLength } from './validators/isLength.js';
+export { isLocale } from './validators/isLocale.js';
+export { isByteLength } from './validators/isByteLength.js';
+export { isULID } from './validators/isULID.js';
+export { isUUID } from './validators/isUUID.js';
+export { isMongoId } from './validators/isMongoId.js';
+export { isAfter } from './validators/isAfter.js';
+export { isBefore } from './validators/isBefore.js';
+export { isIn } from './validators/isIn.js';
+export { isLuhnNumber } from './validators/isLuhnNumber.js';
+export { isCreditCard } from './validators/isCreditCard.js';
+export { isIdentityCard } from './validators/isIdentityCard.js';
+export { isEAN } from './validators/isEAN.js';
+export { isISIN } from './validators/isISIN.js';
+export { isISBN } from './validators/isISBN.js';
+export { isISSN } from './validators/isISSN.js';
+export { isMobilePhone, locales as isMobilePhoneLocales } from './validators/isMobilePhone.js';
+export { isPostalCode, locales as isPostalCodeLocales } from './validators/isPostalCode.js';
+export { isEthereumAddress } from './validators/isEthereumAddress.js';
+export { isCurrency } from './validators/isCurrency.js';
+export { isBtcAddress } from './validators/isBtcAddress.js';
+export { isISO6346, isFreightContainerID } from './validators/isISO6346.js';
+export { isISO6391 } from './validators/isISO6391.js';
+export { isISO8601 } from './validators/isISO8601.js';
+export { isISO15924 } from './validators/isISO15924.js';
+export { isRFC3339 } from './validators/isRFC3339.js';
+export { isISO31661Alpha2 } from './validators/isISO31661Alpha2.js';
+export { isISO31661Alpha3 } from './validators/isISO31661Alpha3.js';
+export { isISO31661Numeric } from './validators/isISO31661Numeric.js';
+export { isISO4217 } from './validators/isISO4217.js';
+export { isBase32 } from './validators/isBase32.js';
+export { isBase58 } from './validators/isBase58.js';
+export { isBase64 } from './validators/isBase64.js';
+export { isDataURI } from './validators/isDataURI.js';
+export { isMagnetURI } from './validators/isMagnetURI.js';
+export { isMailtoURI } from './validators/isMailtoURI.js';
+export { isMimeType } from './validators/isMimeType.js';
+export { isLatLong } from './validators/isLatLong.js';
+export { isWhitelisted } from './validators/isWhitelisted.js';
+export { isSlug } from './validators/isSlug.js';
+export { isStrongPassword } from './validators/isStrongPassword.js';
+export { isDate } from './validators/isDate.js';
+export { isTime } from './validators/isTime.js';
+export { isLicensePlate } from './validators/isLicensePlate.js';
+export { isVAT } from './validators/isVAT.js';
+export * from './canBe/index.js';
+export * from './convert/index.js';
+export * as sanitizer from './sanitizer/index.js';
+export { Validations } from './decorator/validations.js';
+export { runValidations } from './decorator/validate.js';
+export type { Validation, BuiltInValidation, CustomValidation, ValidatorName, ValidationProperties, ValidatedClass, } from './decorator/validations.js';
+export type { ValidationError, ValidationSuccess, ValidationFailure, ValidationResult, Validatable, } from './decorator/validate.js';
+export { scorePassword } from './helpers/scorePassword.js';
+export type { ScorePasswordOptions } from './helpers/scorePassword.js';
+export { ValidationConfigError } from './helpers/errors.js';
+export type * from './validators/index.js';
+export type { NormalizeEmailOptions } from './sanitizer/normalizeEmail.js';

package/dist/esm/index.js

@@ -0,0 +1,98 @@
+export { validator } from './validators/index.js';
+export { equals } from './validators/equals.js';
+export { contains } from './validators/contains.js';
+export { matches } from './validators/matches.js';
+export { isEmail } from './validators/isEmail.js';
+export { isURL } from './validators/isURL.js';
+export { isMACAddress } from './validators/isMACAddress.js';
+export { isIP } from './validators/isIP.js';
+export { isIPRange } from './validators/isIPRange.js';
+export { isFQDN } from './validators/isFQDN.js';
+export { isBoolean } from './validators/isBoolean.js';
+export { isIBAN, locales as ibanLocales } from './validators/isIBAN.js';
+export { isBIC } from './validators/isBIC.js';
+export { isAbaRouting } from './validators/isAbaRouting.js';
+export { isAlpha, locales as isAlphaLocales } from './validators/isAlpha.js';
+export { isAlphanumeric, locales as isAlphanumericLocales } from './validators/isAlphanumeric.js';
+export { isNumeric } from './validators/isNumeric.js';
+export { isPassportNumber, locales as passportNumberLocales } from './validators/isPassportNumber.js';
+export { isPort } from './validators/isPort.js';
+export { isLowercase } from './validators/isLowercase.js';
+export { isUppercase } from './validators/isUppercase.js';
+export { isAscii } from './validators/isAscii.js';
+export { isFullWidth } from './validators/isFullWidth.js';
+export { isHalfWidth } from './validators/isHalfWidth.js';
+export { isVariableWidth } from './validators/isVariableWidth.js';
+export { isMultibyte } from './validators/isMultibyte.js';
+export { isSemVer } from './validators/isSemVer.js';
+export { isSurrogatePair } from './validators/isSurrogatePair.js';
+export { isInt } from './validators/isInt.js';
+export { isIMEI } from './validators/isIMEI.js';
+export { isFloat, locales as isFloatLocales } from './validators/isFloat.js';
+export { isDecimal } from './validators/isDecimal.js';
+export { isHexadecimal } from './validators/isHexadecimal.js';
+export { isOctal } from './validators/isOctal.js';
+export { isDivisibleBy } from './validators/isDivisibleBy.js';
+export { isHexColor } from './validators/isHexColor.js';
+export { isRgbColor } from './validators/isRgbColor.js';
+export { isHSL } from './validators/isHSL.js';
+export { isISRC } from './validators/isISRC.js';
+export { isMD5 } from './validators/isMD5.js';
+export { isHash } from './validators/isHash.js';
+export { isJWT } from './validators/isJWT.js';
+export { isJSON } from './validators/isJSON.js';
+export { isEmpty } from './validators/isEmpty.js';
+export { isNotEmpty } from './validators/isNotEmpty.js';
+export { isRequired } from './validators/isRequired.js';
+export { isLength } from './validators/isLength.js';
+export { isLocale } from './validators/isLocale.js';
+export { isByteLength } from './validators/isByteLength.js';
+export { isULID } from './validators/isULID.js';
+export { isUUID } from './validators/isUUID.js';
+export { isMongoId } from './validators/isMongoId.js';
+export { isAfter } from './validators/isAfter.js';
+export { isBefore } from './validators/isBefore.js';
+export { isIn } from './validators/isIn.js';
+export { isLuhnNumber } from './validators/isLuhnNumber.js';
+export { isCreditCard } from './validators/isCreditCard.js';
+export { isIdentityCard } from './validators/isIdentityCard.js';
+export { isEAN } from './validators/isEAN.js';
+export { isISIN } from './validators/isISIN.js';
+export { isISBN } from './validators/isISBN.js';
+export { isISSN } from './validators/isISSN.js';
+export { isMobilePhone, locales as isMobilePhoneLocales } from './validators/isMobilePhone.js';
+export { isPostalCode, locales as isPostalCodeLocales } from './validators/isPostalCode.js';
+export { isEthereumAddress } from './validators/isEthereumAddress.js';
+export { isCurrency } from './validators/isCurrency.js';
+export { isBtcAddress } from './validators/isBtcAddress.js';
+export { isISO6346, isFreightContainerID } from './validators/isISO6346.js';
+export { isISO6391 } from './validators/isISO6391.js';
+export { isISO8601 } from './validators/isISO8601.js';
+export { isISO15924 } from './validators/isISO15924.js';
+export { isRFC3339 } from './validators/isRFC3339.js';
+export { isISO31661Alpha2 } from './validators/isISO31661Alpha2.js';
+export { isISO31661Alpha3 } from './validators/isISO31661Alpha3.js';
+export { isISO31661Numeric } from './validators/isISO31661Numeric.js';
+export { isISO4217 } from './validators/isISO4217.js';
+export { isBase32 } from './validators/isBase32.js';
+export { isBase58 } from './validators/isBase58.js';
+export { isBase64 } from './validators/isBase64.js';
+export { isDataURI } from './validators/isDataURI.js';
+export { isMagnetURI } from './validators/isMagnetURI.js';
+export { isMailtoURI } from './validators/isMailtoURI.js';
+export { isMimeType } from './validators/isMimeType.js';
+export { isLatLong } from './validators/isLatLong.js';
+export { isWhitelisted } from './validators/isWhitelisted.js';
+export { isSlug } from './validators/isSlug.js';
+export { isStrongPassword } from './validators/isStrongPassword.js';
+export { isDate } from './validators/isDate.js';
+export { isTime } from './validators/isTime.js';
+export { isLicensePlate } from './validators/isLicensePlate.js';
+export { isVAT } from './validators/isVAT.js';
+export * from './canBe/index.js';
+export * from './convert/index.js';
+export * as sanitizer from './sanitizer/index.js';
+export { Validations } from './decorator/validations.js';
+export { runValidations } from './decorator/validate.js';
+export { scorePassword } from './helpers/scorePassword.js';
+export { ValidationConfigError } from './helpers/errors.js';

package/dist/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/dist/esm/sanitizer/blacklist.d.ts

@@ -0,0 +1 @@
+export declare function blacklist(str: string, chars: string): string;

package/dist/esm/sanitizer/blacklist.js

@@ -0,0 +1,8 @@
+import { assertString } from '../helpers/assertString.js';
+import { escapeRegExp } from '../helpers/escapeRegExp.js';
+export function blacklist(str, chars) {
+    assertString(str);
+    if (!chars)
+        return str;
+    return str.replace(new RegExp(`[${escapeRegExp(chars)}]+`, 'g'), '');
+}

package/dist/esm/sanitizer/escape.d.ts

@@ -0,0 +1 @@
+export declare function escape(str: string): string;

package/dist/esm/sanitizer/escape.js

@@ -0,0 +1,13 @@
+import { assertString } from '../helpers/assertString.js';
+export function escape(str) {
+    assertString(str);
+    return str
+        .replace(/&/g, '&')
+        .replace(/"/g, '"')
+        .replace(/'/g, ''')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/\//g, '&#x2F;')
+        .replace(/\\/g, '&#x5C;')
+        .replace(/`/g, '&#96;');
+}

package/dist/esm/sanitizer/index.d.ts

@@ -0,0 +1,10 @@
+export { ltrim } from './ltrim.js';
+export { rtrim } from './rtrim.js';
+export { trim } from './trim.js';
+export { escape } from './escape.js';
+export { unescape } from './unescape.js';
+export { blacklist } from './blacklist.js';
+export { whitelist } from './whitelist.js';
+export { stripLow } from './stripLow.js';
+export { normalizeEmail } from './normalizeEmail.js';
+export type { NormalizeEmailOptions } from './normalizeEmail.js';

package/dist/esm/sanitizer/index.js

@@ -0,0 +1,9 @@
+export { ltrim } from './ltrim.js';
+export { rtrim } from './rtrim.js';
+export { trim } from './trim.js';
+export { escape } from './escape.js';
+export { unescape } from './unescape.js';
+export { blacklist } from './blacklist.js';
+export { whitelist } from './whitelist.js';
+export { stripLow } from './stripLow.js';
+export { normalizeEmail } from './normalizeEmail.js';

package/dist/esm/sanitizer/ltrim.d.ts

@@ -0,0 +1 @@
+export declare function ltrim(str: string, chars?: string): string;

package/dist/esm/sanitizer/ltrim.js

@@ -0,0 +1,10 @@
+import { assertString } from '../helpers/assertString.js';
+import { escapeRegExp } from '../helpers/escapeRegExp.js';
+const hasNativeTrimStart = typeof String.prototype.trimStart === 'function';
+export function ltrim(str, chars) {
+    assertString(str);
+    if (chars) {
+        return str.replace(new RegExp(`^[${escapeRegExp(chars)}]+`), '');
+    }
+    return hasNativeTrimStart ? str.trimStart() : str.replace(/^\s+/, '');
+}

package/dist/esm/sanitizer/normalizeEmail.d.ts

@@ -0,0 +1,16 @@
+export interface NormalizeEmailOptions {
+    all_lowercase?: boolean;
+    gmail_lowercase?: boolean;
+    gmail_remove_dots?: boolean;
+    gmail_remove_subaddress?: boolean;
+    gmail_convert_googlemaildotcom?: boolean;
+    outlookdotcom_lowercase?: boolean;
+    outlookdotcom_remove_subaddress?: boolean;
+    yahoo_lowercase?: boolean;
+    yahoo_remove_subaddress?: boolean;
+    yandex_lowercase?: boolean;
+    yandex_convert_yandexru?: boolean;
+    icloud_lowercase?: boolean;
+    icloud_remove_subaddress?: boolean;
+}
+export declare function normalizeEmail(email: string, options?: NormalizeEmailOptions): string | false;

package/dist/esm/sanitizer/normalizeEmail.js

@@ -0,0 +1,191 @@
+import { merge } from '../helpers/merge.js';
+import { assertString } from '../helpers/assertString.js';
+const default_normalize_email_options = {
+    all_lowercase: true,
+    gmail_lowercase: true,
+    gmail_remove_dots: true,
+    gmail_remove_subaddress: true,
+    gmail_convert_googlemaildotcom: true,
+    outlookdotcom_lowercase: true,
+    outlookdotcom_remove_subaddress: true,
+    yahoo_lowercase: true,
+    yahoo_remove_subaddress: true,
+    yandex_lowercase: true,
+    yandex_convert_yandexru: true,
+    icloud_lowercase: true,
+    icloud_remove_subaddress: true,
+};
+const icloud_domains = ['icloud.com', 'me.com'];
+const outlookdotcom_domains = [
+    'hotmail.at',
+    'hotmail.be',
+    'hotmail.ca',
+    'hotmail.cl',
+    'hotmail.co.il',
+    'hotmail.co.nz',
+    'hotmail.co.th',
+    'hotmail.co.uk',
+    'hotmail.com',
+    'hotmail.com.ar',
+    'hotmail.com.au',
+    'hotmail.com.br',
+    'hotmail.com.gr',
+    'hotmail.com.mx',
+    'hotmail.com.pe',
+    'hotmail.com.tr',
+    'hotmail.com.vn',
+    'hotmail.cz',
+    'hotmail.de',
+    'hotmail.dk',
+    'hotmail.es',
+    'hotmail.fr',
+    'hotmail.hu',
+    'hotmail.id',
+    'hotmail.ie',
+    'hotmail.in',
+    'hotmail.it',
+    'hotmail.jp',
+    'hotmail.kr',
+    'hotmail.lv',
+    'hotmail.my',
+    'hotmail.ph',
+    'hotmail.pt',
+    'hotmail.sa',
+    'hotmail.sg',
+    'hotmail.sk',
+    'live.be',
+    'live.co.uk',
+    'live.com',
+    'live.com.ar',
+    'live.com.mx',
+    'live.de',
+    'live.es',
+    'live.eu',
+    'live.fr',
+    'live.it',
+    'live.nl',
+    'msn.com',
+    'outlook.at',
+    'outlook.be',
+    'outlook.cl',
+    'outlook.co.il',
+    'outlook.co.nz',
+    'outlook.co.th',
+    'outlook.com',
+    'outlook.com.ar',
+    'outlook.com.au',
+    'outlook.com.br',
+    'outlook.com.gr',
+    'outlook.com.pe',
+    'outlook.com.tr',
+    'outlook.com.vn',
+    'outlook.cz',
+    'outlook.de',
+    'outlook.dk',
+    'outlook.es',
+    'outlook.fr',
+    'outlook.hu',
+    'outlook.id',
+    'outlook.ie',
+    'outlook.in',
+    'outlook.it',
+    'outlook.jp',
+    'outlook.kr',
+    'outlook.lv',
+    'outlook.my',
+    'outlook.ph',
+    'outlook.pt',
+    'outlook.sa',
+    'outlook.sg',
+    'outlook.sk',
+    'passport.com',
+];
+const yahoo_domains = [
+    'rocketmail.com',
+    'yahoo.ca',
+    'yahoo.co.uk',
+    'yahoo.com',
+    'yahoo.de',
+    'yahoo.fr',
+    'yahoo.in',
+    'yahoo.it',
+    'ymail.com',
+];
+const yandex_domains = ['yandex.ru', 'yandex.ua', 'yandex.kz', 'yandex.com', 'yandex.by', 'ya.ru'];
+function removeSingleDotKeepRuns(match) {
+    if (match.length > 1) {
+        return match;
+    }
+    return '';
+}
+export function normalizeEmail(email, options) {
+    assertString(email);
+    const opts = merge(options, default_normalize_email_options);
+    const raw_parts = email.split('@');
+    if (raw_parts.length < 2) {
+        return false;
+    }
+    const domain = raw_parts.pop();
+    const user = raw_parts.join('@');
+    const parts = [user, domain];
+    parts[1] = parts[1].toLowerCase();
+    if (parts[1] === 'gmail.com' || parts[1] === 'googlemail.com') {
+        if (opts.gmail_remove_subaddress) {
+            parts[0] = parts[0].split('+')[0];
+        }
+        if (opts.gmail_remove_dots) {
+            parts[0] = parts[0].replace(/\.+/g, removeSingleDotKeepRuns);
+        }
+        if (!parts[0].length) {
+            return false;
+        }
+        if (opts.all_lowercase || opts.gmail_lowercase) {
+            parts[0] = parts[0].toLowerCase();
+        }
+        parts[1] = opts.gmail_convert_googlemaildotcom ? 'gmail.com' : parts[1];
+    }
+    else if (icloud_domains.indexOf(parts[1]) >= 0) {
+        if (opts.icloud_remove_subaddress) {
+            parts[0] = parts[0].split('+')[0];
+        }
+        if (!parts[0].length) {
+            return false;
+        }
+        if (opts.all_lowercase || opts.icloud_lowercase) {
+            parts[0] = parts[0].toLowerCase();
+        }
+    }
+    else if (outlookdotcom_domains.indexOf(parts[1]) >= 0) {
+        if (opts.outlookdotcom_remove_subaddress) {
+            parts[0] = parts[0].split('+')[0];
+        }
+        if (!parts[0].length) {
+            return false;
+        }
+        if (opts.all_lowercase || opts.outlookdotcom_lowercase) {
+            parts[0] = parts[0].toLowerCase();
+        }
+    }
+    else if (yahoo_domains.indexOf(parts[1]) >= 0) {
+        if (opts.yahoo_remove_subaddress) {
+            const components = parts[0].split('-');
+            parts[0] = components.length > 1 ? components.slice(0, -1).join('-') : components[0];
+        }
+        if (!parts[0].length) {
+            return false;
+        }
+        if (opts.all_lowercase || opts.yahoo_lowercase) {
+            parts[0] = parts[0].toLowerCase();
+        }
+    }
+    else if (yandex_domains.indexOf(parts[1]) >= 0) {
+        if (opts.all_lowercase || opts.yandex_lowercase) {
+            parts[0] = parts[0].toLowerCase();
+        }
+        parts[1] = opts.yandex_convert_yandexru ? 'yandex.ru' : parts[1];
+    }
+    else if (opts.all_lowercase) {
+        parts[0] = parts[0].toLowerCase();
+    }
+    return parts.join('@');
+}

package/dist/esm/sanitizer/rtrim.d.ts

@@ -0,0 +1 @@
+export declare function rtrim(str: string, chars?: string): string;

package/dist/esm/sanitizer/rtrim.js

@@ -0,0 +1,18 @@
+import { assertString } from '../helpers/assertString.js';
+const hasNativeTrimEnd = typeof String.prototype.trimEnd === 'function';
+export function rtrim(str, chars) {
+    assertString(str);
+    if (!chars && hasNativeTrimEnd) {
+        return str.trimEnd();
+    }
+    let i = str.length - 1;
+    if (chars) {
+        while (i >= 0 && chars.includes(str.charAt(i)))
+            i--;
+    }
+    else {
+        while (/\s/.test(str.charAt(i)))
+            i--;
+    }
+    return str.slice(0, i + 1);
+}

package/dist/esm/sanitizer/stripLow.d.ts

@@ -0,0 +1 @@
+export declare function stripLow(str: string, keepNewLines?: boolean): string;

package/dist/esm/sanitizer/stripLow.js

@@ -0,0 +1,7 @@
+import { assertString } from '../helpers/assertString.js';
+const lowChars = /[\x00-\x1F\x7F]+/g;
+const lowCharsKeepNewLines = /[\x00-\x09\x0B\x0C\x0E-\x1F\x7F]+/g;
+export function stripLow(str, keepNewLines) {
+    assertString(str);
+    return str.replace(keepNewLines ? lowCharsKeepNewLines : lowChars, '');
+}

package/dist/esm/sanitizer/trim.d.ts

@@ -0,0 +1 @@
+export declare function trim(str: string, chars?: string): string;

package/dist/esm/sanitizer/trim.js

@@ -0,0 +1,11 @@
+import { assertString } from '../helpers/assertString.js';
+import { ltrim } from './ltrim.js';
+import { rtrim } from './rtrim.js';
+const hasNativeTrim = typeof String.prototype.trim === 'function';
+export function trim(str, chars) {
+    if (!chars && hasNativeTrim) {
+        assertString(str);
+        return str.trim();
+    }
+    return rtrim(ltrim(str, chars), chars);
+}

package/dist/esm/sanitizer/unescape.d.ts

@@ -0,0 +1 @@
+export declare function unescape(str: string): string;

package/dist/esm/sanitizer/unescape.js

@@ -0,0 +1,13 @@
+import { assertString } from '../helpers/assertString.js';
+export function unescape(str) {
+    assertString(str);
+    return str
+        .replace(/"/g, '"')
+        .replace(/'/g, "'")
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&#x2F;/g, '/')
+        .replace(/&#x5C;/g, '\\')
+        .replace(/&#96;/g, '`')
+        .replace(/&amp;/g, '&');
+}

package/dist/esm/sanitizer/whitelist.d.ts

@@ -0,0 +1 @@
+export declare function whitelist(str: string, chars: string): string;

package/dist/esm/sanitizer/whitelist.js

@@ -0,0 +1,8 @@
+import { assertString } from '../helpers/assertString.js';
+import { escapeRegExp } from '../helpers/escapeRegExp.js';
+export function whitelist(str, chars) {
+    assertString(str);
+    if (!chars)
+        return '';
+    return str.replace(new RegExp(`[^${escapeRegExp(chars)}]+`, 'g'), '');
+}