@depup/express-validator 7.3.1-depup.1

package/lib/options.d.ts

@@ -0,0 +1,377 @@
+export type URLProtocol = 'http' | 'https' | 'ftp' | string;
+export type UUIDVersion = 1 | 2 | 3 | 4 | 5 | 7 | '1' | '2' | '3' | '4' | '5' | '7' | 'all' | 'loose';
+export type IPVersion = 4 | 6;
+export type AlphaLocale = 'ar' | 'ar-AE' | 'ar-BH' | 'ar-DZ' | 'ar-EG' | 'ar-IQ' | 'ar-JO' | 'ar-KW' | 'ar-LB' | 'ar-LY' | 'ar-MA' | 'ar-QA' | 'ar-QM' | 'ar-SA' | 'ar-SD' | 'ar-SY' | 'ar-TN' | 'ar-YE' | 'az-AZ' | 'bg-BG' | 'bn-BD' | 'cs-CZ' | 'da-DK' | 'de-DE' | 'el-GR' | 'en-AU' | 'en-GB' | 'en-HK' | 'en-IN' | 'en-NZ' | 'en-US' | 'en-ZA' | 'en-ZM' | 'es-ES' | 'eo' | 'fa-AF' | 'fa-IR' | 'fi-FI' | 'fr-FR' | 'gu-IN' | 'he' | 'hi-IN' | 'hu-HU' | 'id-ID' | 'it-IT' | 'ja-JP' | 'kk-KZ' | 'kn-IN' | 'ko-KR' | 'ku-IQ' | 'ml-IN' | 'nb-NO' | 'nl-NL' | 'nn-NO' | 'or-IN' | 'pa-IN' | 'pl-PL' | 'pt-BR' | 'pt-PT' | 'ru-RU' | 'si-LK' | 'sk-SK' | 'sl-SI' | 'sr-RS' | 'sr-RS@latin' | 'sv-SE' | 'ta-IN' | 'te-IN' | 'th-TH' | 'tr-TR' | 'uk-UA' | 'vi-VN';
+export type AlphanumericLocale = 'ar' | 'ar-AE' | 'ar-BH' | 'ar-DZ' | 'ar-EG' | 'ar-IQ' | 'ar-JO' | 'ar-KW' | 'ar-LB' | 'ar-LY' | 'ar-MA' | 'ar-QA' | 'ar-QM' | 'ar-SA' | 'ar-SD' | 'ar-SY' | 'ar-TN' | 'ar-YE' | 'az-AZ' | 'bg-BG' | 'bn-BD' | 'cs-CZ' | 'da-DK' | 'de-DE' | 'el-GR' | 'en-AU' | 'en-GB' | 'en-HK' | 'en-IN' | 'en-NZ' | 'en-US' | 'en-ZA' | 'en-ZM' | 'es-ES' | 'eo' | 'fa-AF' | 'fa-IR' | 'fi-FI' | 'fr-FR' | 'fr-BE' | 'gu-IN' | 'he' | 'hi-IN' | 'hu-HU' | 'it-IT' | 'id-ID' | 'ja-JP' | 'kk-KZ' | 'kn-IN' | 'ko-KR' | 'ku-IQ' | 'ml-IN' | 'nb-NO' | 'nl-BE' | 'nl-NL' | 'nn-NO' | 'or-IN' | 'pa-IN' | 'pl-PL' | 'pt-BR' | 'pt-PT' | 'ru-RU' | 'si-LK' | 'sk-SK' | 'sl-SI' | 'sr-RS' | 'sr-RS@latin' | 'sv-SE' | 'ta-IN' | 'te-IN' | 'th-TH' | 'tr-TR' | 'uk-UA' | 'vi-VN';
+export type MobilePhoneLocale = 'any' | 'am-AM' | 'ar-AE' | 'ar-BH' | 'ar-DZ' | 'ar-EG' | 'ar-EH' | 'ar-IQ' | 'ar-JO' | 'ar-KW' | 'ar-LB' | 'ar-LY' | 'ar-MA' | 'ar-OM' | 'ar-QA' | 'ar-PS' | 'ar-SA' | 'ar-SD' | 'ar-SY' | 'ar-TN' | 'ar-YE' | 'az-AZ' | 'be-BY' | 'bg-BG' | 'bn-BD' | 'bs-BA' | 'cs-CZ' | 'de-AT' | 'de-CH' | 'de-DE' | 'de-LU' | 'da-DK' | 'dv-MV' | 'dz-BT' | 'el-CY' | 'el-GR' | 'en-AG' | 'en-AI' | 'en-AU' | 'en-BM' | 'en-BS' | 'en-BW' | 'en-CA' | 'en-GB' | 'en-GG' | 'en-GH' | 'en-GY' | 'en-HK' | 'en-HN' | 'en-IE' | 'en-IN' | 'en-JM' | 'en-KE' | 'en-KI' | 'en-KN' | 'en-LS' | 'en-MT' | 'en-MU' | 'en-MW' | 'en-NA' | 'en-NG' | 'en-NZ' | 'en-PG' | 'en-PH' | 'en-PK' | 'en-RW' | 'en-SG' | 'en-SL' | 'en-SS' | 'en-TZ' | 'en-UG' | 'en-US' | 'en-ZA' | 'en-ZM' | 'en-ZW' | 'es-AR' | 'es-BO' | 'es-CL' | 'es-CO' | 'es-CR' | 'es-CU' | 'es-DO' | 'es-EC' | 'es-ES' | 'es-GT' | 'es-HN' | 'es-MX' | 'es-NI' | 'es-PA' | 'es-PE' | 'es-PY' | 'es-SV' | 'es-UY' | 'es-VE' | 'et-EE' | 'fa-AF' | 'fa-IR' | 'fi-FI' | 'fj-FJ' | 'fo-FO' | 'fr-BE' | 'fr-BF' | 'fr-BJ' | 'fr-CD' | 'fr-CF' | 'fr-CH' | 'fr-CM' | 'fr-FR' | 'fr-GF' | 'fr-GP' | 'fr-MQ' | 'fr-PF' | 'fr-RE' | 'fr-WF' | 'ga-IE' | 'he-IL' | 'hu-HU' | 'id-ID' | 'ir-IR' | 'it-CH' | 'it-IT' | 'it-SM' | 'ja-JP' | 'ka-GE' | 'kk-KZ' | 'kl-GL' | 'ko-KR' | 'ky-KG' | 'lt-LT' | 'lv-LV' | 'mg-MG' | 'mk-MK' | 'mn-MN' | 'ms-MY' | 'my-MM' | 'mz-MZ' | 'nb-NO' | 'nl-AW' | 'nl-BE' | 'nl-NL' | 'ne-NP' | 'nn-NO' | 'pl-PL' | 'pt-AO' | 'pt-BR' | 'pt-PT' | 'ro-MD' | 'ro-RO' | 'ru-RU' | 'si-LK' | 'sk-SK' | 'sl-SI' | 'so-SO' | 'sq-AL' | 'sr-RS' | 'sv-SE' | 'tg-TJ' | 'th-TH' | 'tk-TM' | 'tr-TR' | 'uk-UA' | 'uz-Uz' | 'vi-VN' | 'zh-CN' | 'zh-HK' | 'zh-TW';
+export type PostalCodeLocale = 'any' | 'AD' | 'AT' | 'AU' | 'AZ' | 'BA' | 'BD' | 'BE' | 'BG' | 'BR' | 'BY' | 'CA' | 'CH' | 'CN' | 'CO' | 'CZ' | 'DE' | 'DK' | 'DO' | 'DZ' | 'EE' | 'ES' | 'FI' | 'FR' | 'GB' | 'GR' | 'HR' | 'HT' | 'HU' | 'ID' | 'IL' | 'IN' | 'IR' | 'IS' | 'IT' | 'JP' | 'KE' | 'KR' | 'LI' | 'LK' | 'LT' | 'LU' | 'LV' | 'MT' | 'MX' | 'MY' | 'NL' | 'NO' | 'NP' | 'NZ' | 'PK' | 'PL' | 'PR' | 'PT' | 'RO' | 'RU' | 'SA' | 'SE' | 'SG' | 'SI' | 'SK' | 'TH' | 'TN' | 'TW' | 'UA' | 'US' | 'ZA' | 'ZM';
+export type HashAlgorithm = 'md4' | 'md5' | 'sha1' | 'sha256' | 'sha384' | 'sha512' | 'ripemd128' | 'ripemd160' | 'tiger128' | 'tiger160' | 'tiger192' | 'crc32' | 'crc32b';
+export type IBANCode = 'AD' | 'AE' | 'AL' | 'AT' | 'AZ' | 'BA' | 'BE' | 'BG' | 'BH' | 'BR' | 'BY' | 'CH' | 'CR' | 'CY' | 'CZ' | 'DE' | 'DK' | 'DO' | 'DZ' | 'EE' | 'EG' | 'ES' | 'FI' | 'FO' | 'FR' | 'GB' | 'GE' | 'GI' | 'GL' | 'GR' | 'GT' | 'HR' | 'HU' | 'IE' | 'IL' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JO' | 'KW' | 'KZ' | 'LB' | 'LC' | 'LI' | 'LT' | 'LU' | 'LV' | 'MC' | 'MD' | 'ME' | 'MK' | 'MR' | 'MT' | 'MU' | 'MZ' | 'NL' | 'NO' | 'PK' | 'PL' | 'PS' | 'PT' | 'QA' | 'RO' | 'RS' | 'SA' | 'SC' | 'SE' | 'SI' | 'SK' | 'SM' | 'SV' | 'TL' | 'TN' | 'TR' | 'UA' | 'VA' | 'VG' | 'XK';
+export interface IsIBANOptions {
+    whitelist?: readonly IBANCode[];
+    blacklist?: readonly IBANCode[];
+}
+export type IdentityCardLocale = 'any' | 'ar-LY' | 'ar-TN' | 'ES' | 'FI' | 'he-IL' | 'hk-HK' | 'IN' | 'IT' | 'IR' | 'MZ' | 'NO' | 'PK' | 'PL' | 'TH' | 'zh-CN' | 'zh-TW';
+export type PassportCountryCode = 'AM' | 'AR' | 'AT' | 'AU' | 'AZ' | 'BE' | 'BG' | 'BY' | 'BR' | 'CA' | 'CH' | 'CN' | 'CY' | 'CZ' | 'DE' | 'DK' | 'DZ' | 'EE' | 'ES' | 'FI' | 'FR' | 'GB' | 'GR' | 'HR' | 'HU' | 'ID' | 'IE' | 'IN' | 'IR' | 'IS' | 'IT' | 'JM' | 'JP' | 'KR' | 'KZ' | 'LI' | 'LT' | 'LU' | 'LV' | 'LY' | 'MT' | 'MY' | 'MZ' | 'NL' | 'NZ' | 'PH' | 'PK' | 'PL' | 'PO' | 'PT' | 'RO' | 'RU' | 'SE' | 'SL' | 'SK' | 'TH' | 'TR' | 'UA' | 'US' | 'ZA';
+export type IsLicensePlateLocale = 'cs-CZ' | 'de-DE' | 'de-LI' | 'en-NI' | 'en-PK' | 'en-SG' | 'es-AR' | 'fi-FI' | 'hu-HU' | 'pt-BR' | 'pt-PT' | 'sq-AL' | 'sv-SE' | 'any';
+export type TaxIDLocale = 'bg-BG' | 'cs-CZ' | 'de-AT' | 'de-DE' | 'dk-DK' | 'el-CY' | 'el-GR' | 'en-CA' | 'en-GB' | 'en-IE' | 'en-US' | 'es-AR' | 'es-ES' | 'et-EE' | 'fi-FI' | 'fr-BE' | 'fr-FR' | 'fr-LU' | 'hr-HR' | 'hu-HU' | 'it-IT' | 'lb-LU' | 'lt-LT' | 'lv-LV' | 'mt-MT' | 'nl-BE' | 'nl-NL' | 'pl-PL' | 'pt-BR' | 'pt-PT' | 'ro-RO' | 'sk-SK' | 'sl-SI' | 'sv-SE' | 'uk-UA';
+export type VATCountryCode = 'GB' | 'IT' | 'NL' | 'AT' | 'BE' | 'BG' | 'HR' | 'CU' | 'CY' | 'CZ' | 'DK' | 'EE' | 'FI' | 'FR' | 'DE' | 'EL' | 'HU' | 'IE' | 'LV' | 'LT' | 'LU' | 'MT' | 'PL' | 'PT' | 'RO' | 'SK' | 'SI' | 'ES' | 'SE' | 'AL' | 'MK' | 'AU' | 'BY' | 'CA' | 'IS' | 'IN' | 'ID' | 'IL' | 'KZ' | 'NZ' | 'NG' | 'NO' | 'PH' | 'RU' | 'SM' | 'SA' | 'RS' | 'CH' | 'TR' | 'UA' | 'UZ' | 'AR' | 'BO' | 'BR' | 'CL' | 'CO' | 'CR' | 'EC' | 'SV' | 'GT' | 'HN' | 'MX' | 'NI' | 'PA' | 'PY' | 'PE' | 'DO' | 'UY' | 'VE';
+export interface MinMaxOptions {
+    min?: number;
+    max?: number;
+}
+export interface MinMaxExtendedOptions extends MinMaxOptions {
+    lt?: number;
+    gt?: number;
+}
+/**
+ * defaults to
+ * {
+ *  ignoreCase: false|
+ *  minOccurrences: 1
+ * }
+ */
+export interface ContainsOptions {
+    ignoreCase?: boolean;
+    minOccurrences?: number;
+}
+/**
+ * defaults to
+ * {
+ *   comparisonDate: Date().toString()
+ * }
+ */
+export interface IsAfterOptions {
+    comparisonDate?: string;
+}
+export interface IsAlphaOptions {
+    ignore?: string | string[] | RegExp;
+}
+export interface IsAlphanumericOptions {
+    ignore?: string | RegExp;
+}
+/**
+ * defaults to
+ * {
+ *  crockford: false
+ * }
+ */
+export interface IsBase32Options {
+    crockford?: boolean;
+}
+/**
+ * defaults to
+ * {
+ *  urlSafe: false
+ * }
+ */
+export interface IsBase64Options {
+    urlSafe?: boolean;
+}
+/**
+ * defaults to
+ * {
+ *  comparisonDate: new Date().toString()
+ * }
+ */
+export interface IsBeforeOptions {
+    comparisonDate?: string;
+}
+/**
+ * defaults to
+ * {
+ *  strict: false
+ *  loose: false
+ * }
+ */
+export interface IsBooleanOptions {
+    strict?: boolean;
+    loose?: boolean;
+}
+/**
+ * defaults to
+ * {
+ *  includePercentValues: true
+ *  allowSpaces: true
+ * }
+ */
+export interface IsRgbColorOptions {
+    includePercentValues?: boolean;
+    allowSpaces?: boolean;
+}
+export interface IsCreditCard {
+    provider?: 'amex' | 'dinersclub' | 'discover' | 'jcb' | 'mastercard' | 'unionpay' | 'visa';
+}
+/**
+ * defaults to
+ * {
+ *   symbol: '$'|
+ *   require_symbol: false|
+ *   allow_space_after_symbol: false|
+ *   symbol_after_digits: false|
+ *   allow_negatives: true|
+ *   parens_for_negatives: false|
+ *   negative_sign_before_digits: false|
+ *   negative_sign_after_digits: false|
+ *   allow_negative_sign_placeholder: false|
+ *   thousands_separator: '|'|
+ *   decimal_separator: '.'|
+ *   allow_space_after_digits: false
+ * }
+ */
+export interface IsCurrencyOptions {
+    symbol?: string;
+    require_symbol?: boolean;
+    allow_space_after_symbol?: boolean;
+    symbol_after_digits?: boolean;
+    allow_negatives?: boolean;
+    parens_for_negatives?: boolean;
+    negative_sign_before_digits?: boolean;
+    negative_sign_after_digits?: boolean;
+    allow_negative_sign_placeholder?: boolean;
+    thousands_separator?: string;
+    decimal_separator?: string;
+    allow_decimal?: boolean;
+    require_decimal?: boolean;
+    digits_after_decimal?: number[];
+    allow_space_after_digits?: boolean;
+}
+/**
+ * defaults to
+ * {
+ *    format: 'YYYY/MM/DD'|
+ *    delimiters: ['/'| '-']|
+ *    strictMode: false
+ * }
+ */
+export interface IsDateOptions {
+    format?: string;
+    delimiters?: string[];
+    strictMode?: boolean;
+}
+export interface IsDecimalOptions {
+    decimal_digits?: string;
+    force_decimal?: boolean;
+    locale?: AlphanumericLocale;
+    blacklisted_chars?: string;
+}
+export interface IsEmailOptions {
+    allow_display_name?: boolean;
+    allow_underscores?: boolean;
+    allow_utf8_local_part?: boolean;
+    require_tld?: boolean;
+    ignore_max_length?: boolean;
+    allow_ip_domain?: boolean;
+    domain_specific_validation?: boolean;
+    blacklisted_chars?: string;
+    host_blacklist?: (string | RegExp)[];
+    host_whitelist?: (string | RegExp)[];
+}
+/**
+ * defaults to
+ * {
+ *    ignore_whitespace: false
+ * }
+ */
+export interface IsEmptyOptions {
+    ignore_whitespace: boolean;
+}
+export interface IsFloatOptions extends MinMaxExtendedOptions {
+    locale?: AlphanumericLocale;
+}
+/**
+ * defaults to
+ * {
+ *    require_tld: true|
+ *    allow_underscores: false|
+ *    allow_trailing_dot: false|
+ *    allow_numeric_tld: false|
+ *    allow_wildcard: false|
+ *    ignore_max_length: false
+ * }
+ */
+export interface IsFQDNOptions {
+    require_tld?: boolean;
+    allow_underscores?: boolean;
+    allow_trailing_dot?: boolean;
+    allow_numeric_tld?: boolean;
+    allow_wildcard?: boolean;
+    ignore_max_length?: boolean;
+}
+export interface IsIntOptions extends MinMaxExtendedOptions {
+    allow_leading_zeroes?: boolean;
+}
+/**
+ * defaults to
+ * {
+ *  allow_primitives: false
+ * }
+ */
+export interface IsJSONOptions {
+    allow_primitives?: boolean;
+}
+/**
+ * defaults to
+ * {
+ *  checkDMS: false
+ * }
+ */
+export interface IsLatLongOptions {
+    checkDMS?: boolean;
+}
+export interface IsLengthOptions extends MinMaxOptions {
+    discreteLengths?: number[];
+}
+/**
+ * defaults to
+ * {
+ *  allow_hyphens: false
+ * }
+ */
+export interface IsIMEIOptions {
+    allow_hyphens?: boolean;
+}
+/**
+ * defaults to
+ * {
+ *    strict: false|
+ *    strictSeparator: false
+ * }
+ */
+export interface IsISO8601Options {
+    strict?: boolean;
+    strictSeparator?: boolean;
+}
+export interface IsISBNOptions {
+    version?: '10' | '13';
+}
+/**
+ * defaults to
+ * {
+ *    case_sensitive: false|
+ *    require_hyphen: false
+ * }
+ */
+export interface IsISSNOptions {
+    case_sensitive?: boolean;
+    require_hyphen?: boolean;
+}
+/**
+ * defaults to
+ * ```js
+ * {
+ *    no_separators: false
+ * }
+ * ```
+ */
+export interface IsMACAddressOptions {
+    no_separators?: boolean;
+    /**
+     * @deprecated use `no_separators` instead
+     */
+    no_colons?: boolean;
+    eui?: '48' | '64';
+}
+export interface IsMobilePhoneOptions {
+    strictMode?: boolean;
+}
+/**
+ * defaults to
+ * {
+ *    no_symbols: false
+ * }
+ */
+export interface IsNumericOptions {
+    no_symbols: boolean;
+    locale?: AlphanumericLocale;
+}
+/**
+ * defaults to
+ * {
+ *    minLength: 8|
+ *    minLowercase: 1|
+ *    minUppercase: 1|
+ *    minNumbers: 1|
+ *    minSymbols: 1|
+ *    returnScore: false|
+ *    pointsPerUnique: 1|
+ *    pointsPerRepeat: 0.5|
+ *    pointsForContainingLower: 10|
+ *    pointsForContainingUpper: 10|
+ *    pointsForContainingNumber: 10|
+ *    pointsForContainingSymbol: 10
+ * }
+ */
+export interface IsStrongPasswordOptions {
+    minLength?: number;
+    minLowercase?: number;
+    minUppercase?: number;
+    minNumbers?: number;
+    minSymbols?: number;
+    returnScore?: boolean;
+    pointsPerUnique?: number;
+    pointsPerRepeat?: number;
+    pointsForContainingLower?: number;
+    pointsForContainingUpper?: number;
+    pointsForContainingNumber?: number;
+    pointsForContainingSymbol?: number;
+}
+/**
+ * defaults to
+ * {
+ *    protocols: ['http'|'https'|'ftp']|
+ *    require_tld: true|
+ *    require_protocol: false|
+ *    require_host: true|
+ *    require_port: false;
+ *    require_valid_protocol: true|
+ *    allow_underscores: false|
+ *    host_whitelist: false|
+ *    host_blacklist: false|
+ *    allow_trailing_dot: false|
+ *    allow_protocol_relative_urls: false|
+ *    validate_length: true|
+ *    allow_fragments: true|
+ *    allow_query_components: true
+ * }
+ */
+export interface IsURLOptions extends IsFQDNOptions {
+    protocols?: URLProtocol[];
+    require_protocol?: boolean;
+    require_host?: boolean;
+    require_port?: boolean;
+    require_valid_protocol?: boolean;
+    host_whitelist?: (string | RegExp)[];
+    host_blacklist?: (string | RegExp)[];
+    allow_protocol_relative_urls?: boolean;
+    disallow_auth?: boolean;
+    validate_length?: boolean;
+    max_allowed_length?: number;
+    allow_fragments?: boolean;
+    allow_query_components?: boolean;
+}
+/**
+ * defaults to
+ * {
+ *  hourFormat: 'hour24'|
+ *  mode: 'default'|
+ * };
+ */
+export interface IsTimeOptions {
+    hourFormat?: 'hour24' | 'hour12';
+    mode?: 'default' | 'withSeconds';
+}
+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;
+    icloud_lowercase?: boolean;
+    icloud_remove_subaddress?: boolean;
+    yandex_convert_yandexru?: boolean;
+}

package/lib/options.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/utils.d.ts

@@ -0,0 +1,12 @@
+import { Request } from './base';
+import { ContextRunningOptions, ResultWithContext, ValidationChainLike } from './chain';
+export declare const bindAll: <T>(object: T) => { [K in keyof T]: T[K]; };
+export declare function toString(value: any): string;
+/**
+ * Runs all validation chains, and returns their results.
+ *
+ * If one of them has a request-level bail set, the previous chains will be awaited on so that
+ * results are not skewed, which can be slow.
+ * If this same chain also contains errors, no further chains are run.
+ */
+export declare function runAllChains(req: Request, chains: readonly ValidationChainLike[], runOpts?: ContextRunningOptions): Promise<ResultWithContext[]>;

package/lib/utils.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bindAll = void 0;
+exports.toString = toString;
+exports.runAllChains = runAllChains;
+const bindAll = (object) => {
+    const protoKeys = Object.getOwnPropertyNames(Object.getPrototypeOf(object));
+    protoKeys.forEach(key => {
+        const maybeFn = object[key];
+        if (typeof maybeFn === 'function' && key !== 'constructor') {
+            object[key] = maybeFn.bind(object);
+        }
+    });
+    return object;
+};
+exports.bindAll = bindAll;
+function toString(value) {
+    if (value instanceof Date) {
+        return value.toISOString();
+    }
+    else if (value && typeof value === 'object' && value.toString) {
+        if (typeof value.toString !== 'function') {
+            return Object.getPrototypeOf(value).toString.call(value);
+        }
+        return value.toString();
+    }
+    else if (value == null || (isNaN(value) && !value.length)) {
+        return '';
+    }
+    return String(value);
+}
+/**
+ * Runs all validation chains, and returns their results.
+ *
+ * If one of them has a request-level bail set, the previous chains will be awaited on so that
+ * results are not skewed, which can be slow.
+ * If this same chain also contains errors, no further chains are run.
+ */
+async function runAllChains(req, chains, runOpts) {
+    const promises = [];
+    for (const chain of chains) {
+        const bails = chain.builder.build().bail;
+        if (bails) {
+            await Promise.all(promises);
+        }
+        const resultPromise = chain.run(req, runOpts);
+        promises.push(resultPromise);
+        if (bails) {
+            const result = await resultPromise;
+            if (!result.isEmpty()) {
+                break;
+            }
+        }
+    }
+    return Promise.all(promises);
+}

package/lib/validation-result.d.ts

@@ -0,0 +1,67 @@
+import { Request, ValidationError } from './base';
+/**
+ * Given a validation error, returns a new value that represents it.
+ */
+export type ErrorFormatter<T = any> = (error: ValidationError) => T;
+type ToArrayOptions = {
+    /**
+     * Whether only the first error of each field should be returned.
+     * @default false
+     */
+    onlyFirstError?: boolean;
+};
+export type ResultFactory<T> = (req: Request) => Result<T>;
+interface ResultFactoryBuilderOptions<T = any> {
+    /**
+     * The default error formatter of every {@link Result} instance returned by
+     * the custom `validationResult()` function.
+     */
+    formatter: ErrorFormatter<T>;
+}
+/**
+ * Extracts the validation errors of an express request
+ */
+export declare const validationResult: ResultFactory<ValidationError> & {
+    withDefaults: typeof withDefaults;
+};
+/**
+ * The current state of the validation errors in a request.
+ */
+export declare class Result<T = any> {
+    private formatter;
+    private readonly errors;
+    constructor(formatter: ErrorFormatter<T>, errors: readonly ValidationError[]);
+    /**
+     * Gets the validation errors as an array.
+     *
+     * @param options.onlyFirstError whether only the first error of each
+     */
+    array(options?: ToArrayOptions): T[];
+    /**
+     * Gets the validation errors as an object.
+     * If a field has more than one error, only the first one is set in the resulting object.
+     *
+     * @returns an object from field name to error
+     */
+    mapped(): Record<string, T>;
+    /**
+     * Specifies a function to format errors with.
+     * @param formatter the function to use for formatting errors
+     * @returns A new {@link Result} instance with the given formatter
+     */
+    formatWith<T2>(formatter: ErrorFormatter<T2>): Result<T2>;
+    /**
+     * @returns `true` if there are no errors, `false` otherwise
+     */
+    isEmpty(): boolean;
+    /**
+     * Throws an error if there are validation errors.
+     */
+    throw(): void;
+}
+/**
+ * Creates a `validationResult`-like function with default options passed to every {@link Result} it
+ * returns.
+ */
+declare function withDefaults<T = any>(options?: Partial<ResultFactoryBuilderOptions<T>>): ResultFactory<T>;
+export {};

package/lib/validation-result.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Result = exports.validationResult = void 0;
+const _ = require("lodash");
+const base_1 = require("./base");
+const utils_1 = require("./utils");
+/**
+ * Extracts the validation errors of an express request
+ */
+exports.validationResult = Object.assign(withDefaults(), { withDefaults });
+/**
+ * The current state of the validation errors in a request.
+ */
+class Result {
+    constructor(formatter, errors) {
+        this.formatter = formatter;
+        this.errors = errors;
+    }
+    /**
+     * Gets the validation errors as an array.
+     *
+     * @param options.onlyFirstError whether only the first error of each
+     */
+    array(options) {
+        return options?.onlyFirstError ? Object.values(this.mapped()) : this.errors.map(this.formatter);
+    }
+    /**
+     * Gets the validation errors as an object.
+     * If a field has more than one error, only the first one is set in the resulting object.
+     *
+     * @returns an object from field name to error
+     */
+    mapped() {
+        return this.errors.reduce((mapping, error) => {
+            const key = error.type === 'field' ? error.path : `_${error.type}`;
+            if (!mapping[key]) {
+                mapping[key] = this.formatter(error);
+            }
+            return mapping;
+        }, {});
+    }
+    /**
+     * Specifies a function to format errors with.
+     * @param formatter the function to use for formatting errors
+     * @returns A new {@link Result} instance with the given formatter
+     */
+    formatWith(formatter) {
+        return new Result(formatter, this.errors);
+    }
+    /**
+     * @returns `true` if there are no errors, `false` otherwise
+     */
+    isEmpty() {
+        return this.errors.length === 0;
+    }
+    /**
+     * Throws an error if there are validation errors.
+     */
+    throw() {
+        if (!this.isEmpty()) {
+            throw Object.assign(new Error(), (0, utils_1.bindAll)(this));
+        }
+    }
+}
+exports.Result = Result;
+/**
+ * Creates a `validationResult`-like function with default options passed to every {@link Result} it
+ * returns.
+ */
+function withDefaults(options = {}) {
+    const defaults = {
+        formatter: error => error,
+    };
+    const actualOptions = _.defaults(options, defaults);
+    return (req) => {
+        const contexts = req[base_1.contextsKey] || [];
+        const errors = _.flatMap(contexts, 'errors');
+        return new Result(actualOptions.formatter, errors);
+    };
+}