feat: epic issues to create release 0.13.2

README.md

@@ -139,7 +139,7 @@ export interface ValidatorOptions {
 }
 ```
 
-> It's highly advised to set `forbidUnknownValues: true` as it will prevent unknown objects from passing validation.
+> It's highly advised to not set `forbidUnknownValues: false` as it will allow unknown objects to bypass validation. The default is a safe value of `true`.
 
 ## Validation errors
 
@@ -824,8 +824,8 @@ isBoolean(value);
 | **String validation decorators**                | |
 | `@Contains(seed: string)`                       | Checks if the string contains the seed. |
 | `@NotContains(seed: string)`                    | Checks if the string not contains the seed. |
-| `@IsAlpha()`                                    | Checks if the string contains only letters (a-zA-Z). |
-| `@IsAlphanumeric()`                             | Checks if the string contains only letters and numbers. |
+| `@IsAlpha(locale?: string, options?: IsAlphaOptions)`                                    | Checks if the string contains only letters (a-zA-Z). |
+| `@IsAlphanumeric(locale?: string, options?: IsAlphanumericOptions)`                             | Checks if the string contains only letters and numbers. |
 | `@IsDecimal(options?: IsDecimalOptions)`        | Checks if the string is a valid decimal value. Default IsDecimalOptions are `force_decimal=False`, `decimal_digits: '1,'`, `locale: 'en-US'` |
 | `@IsAscii()`                                    | Checks if the string contains ASCII chars only. |
 | `@IsBase32()`                                   | Checks if a string is base32 encoded. |
@@ -875,7 +875,7 @@ isBoolean(value);
 | `@IsMultibyte()`                                | Checks if the string contains one or more multibyte chars. |
 | `@IsNumberString(options?: IsNumericOptions)`   | Checks if the string is numeric. |
 | `@IsSurrogatePair()`                            | Checks if the string contains any surrogate pairs chars. |
-| `@IsUrl(options?: IsURLOptions)`                | Checks if the string is an url. |
+| `@IsUrl(options?: IsURLOptions)`                | Checks if the string is a url. |
 | `@IsMagnetURI()`                                | Checks if the string is a [magnet uri format](https://en.wikipedia.org/wiki/Magnet_URI_scheme). |
 | `@IsUUID(version?: "3"\|"4"\|"5"\|"all")`       | Checks if the string is a UUID (version 3, 4, 5 or all ). |
 | `@IsFirebasePushId()`                           | Checks if the string is a [Firebase Push ID](https://firebase.googleblog.com/2015/02/the-2120-ways-to-ensure-unique_68.html) |

package.json

@@ -36,30 +36,30 @@
     "test:ci": "jest --runInBand --no-cache --coverage --verbose"
   },
   "dependencies": {
-    "libphonenumber-js": "^1.9.43",
+    "libphonenumber-js": "^1.10.13",
+    "@types/validator": "^13.7.7",
     "validator": "^13.7.0"
   },
   "devDependencies": {
-    "@rollup/plugin-commonjs": "^21.0.1",
-    "@rollup/plugin-node-resolve": "^13.0.6",
-    "@types/jest": "^27.0.3",
-    "@types/node": "^16.11.9",
-    "@types/validator": "^13.7.0",
-    "@typescript-eslint/eslint-plugin": "^4.33.0",
-    "@typescript-eslint/parser": "^4.33.0",
-    "eslint": "^7.32.0",
-    "eslint-config-prettier": "^8.3.0",
-    "eslint-plugin-jest": "^25.2.4",
-    "husky": "^4.3.8",
-    "jest": "^26.6.3",
-    "lint-staged": "^12.0.3",
-    "prettier": "^2.2.1",
+    "@rollup/plugin-commonjs": "^22.0.2",
+    "@rollup/plugin-node-resolve": "^14.1.0",
+    "@types/jest": "^29.1.2",
+    "@types/node": "^18.8.3",
+    "@typescript-eslint/eslint-plugin": "^5.39.0",
+    "@typescript-eslint/parser": "^5.39.0",
+    "eslint": "^8.24.0",
+    "eslint-config-prettier": "^8.5.0",
+    "eslint-plugin-jest": "^27.1.1",
+    "husky": "^8.0.1",
+    "jest": "^29.1.2",
+    "lint-staged": "^13.0.3",
+    "prettier": "^2.7.1",
     "reflect-metadata": "0.1.13",
     "rimraf": "3.0.2",
-    "rollup": "^2.60.0",
+    "rollup": "^2.79.1",
     "rollup-plugin-terser": "^7.0.2",
-    "ts-jest": "^26.5.6",
-    "ts-node": "^10.4.0",
-    "typescript": "^4.2.4"
+    "ts-jest": "^29.0.3",
+    "ts-node": "^10.9.1",
+    "typescript": "^4.8.4"
   }
 }

src/decorator/array/ArrayContains.ts

@@ -23,7 +23,7 @@ export function ArrayContains(values: any[], validationOptions?: ValidationOptio
       name: ARRAY_CONTAINS,
       constraints: [values],
       validator: {
-        validate: (value, args): boolean => arrayContains(value, args.constraints[0]),
+        validate: (value, args): boolean => arrayContains(value, args?.constraints[0]),
         defaultMessage: buildMessage(
           eachPrefix => eachPrefix + '$property must contain $constraint1 values',
           validationOptions

src/decorator/array/ArrayMaxSize.ts

@@ -21,9 +21,9 @@ export function ArrayMaxSize(max: number, validationOptions?: ValidationOptions)
       name: ARRAY_MAX_SIZE,
       constraints: [max],
       validator: {
-        validate: (value, args): boolean => arrayMaxSize(value, args.constraints[0]),
+        validate: (value, args): boolean => arrayMaxSize(value, args?.constraints[0]),
         defaultMessage: buildMessage(
-          eachPrefix => eachPrefix + '$property must contain not more than $constraint1 elements',
+          eachPrefix => eachPrefix + '$property must contain no more than $constraint1 elements',
           validationOptions
         ),
       },

src/decorator/array/ArrayMinSize.ts

@@ -21,7 +21,7 @@ export function ArrayMinSize(min: number, validationOptions?: ValidationOptions)
       name: ARRAY_MIN_SIZE,
       constraints: [min],
       validator: {
-        validate: (value, args): boolean => arrayMinSize(value, args.constraints[0]),
+        validate: (value, args): boolean => arrayMinSize(value, args?.constraints[0]),
         defaultMessage: buildMessage(
           eachPrefix => eachPrefix + '$property must contain at least $constraint1 elements',
           validationOptions

src/decorator/array/ArrayNotContains.ts

@@ -23,7 +23,7 @@ export function ArrayNotContains(values: any[], validationOptions?: ValidationOp
       name: ARRAY_NOT_CONTAINS,
       constraints: [values],
       validator: {
-        validate: (value, args): boolean => arrayNotContains(value, args.constraints[0]),
+        validate: (value, args): boolean => arrayNotContains(value, args?.constraints[0]),
         defaultMessage: buildMessage(
           eachPrefix => eachPrefix + '$property should not contain $constraint1 values',
           validationOptions

src/decorator/common/Equals.ts

@@ -19,7 +19,7 @@ export function Equals(comparison: any, validationOptions?: ValidationOptions):
       name: EQUALS,
       constraints: [comparison],
       validator: {
-        validate: (value, args): boolean => equals(value, args.constraints[0]),
+        validate: (value, args): boolean => equals(value, args?.constraints[0]),
         defaultMessage: buildMessage(
           eachPrefix => eachPrefix + '$property must be equal to $constraint1',
           validationOptions

src/decorator/common/IsIn.ts

@@ -19,7 +19,7 @@ export function IsIn(values: readonly any[], validationOptions?: ValidationOptio
       name: IS_IN,
       constraints: [values],
       validator: {
-        validate: (value, args): boolean => isIn(value, args.constraints[0]),
+        validate: (value, args): boolean => isIn(value, args?.constraints[0]),
         defaultMessage: buildMessage(
           eachPrefix => eachPrefix + '$property must be one of the following values: $constraint1',
           validationOptions

src/decorator/common/IsNotIn.ts

@@ -19,7 +19,7 @@ export function IsNotIn(values: readonly any[], validationOptions?: ValidationOp
       name: IS_NOT_IN,
       constraints: [values],
       validator: {
-        validate: (value, args): boolean => isNotIn(value, args.constraints[0]),
+        validate: (value, args): boolean => isNotIn(value, args?.constraints[0]),
         defaultMessage: buildMessage(
           eachPrefix => eachPrefix + '$property should not be one of the following values: $constraint1',
           validationOptions

src/decorator/common/NotEquals.ts

@@ -19,7 +19,7 @@ export function NotEquals(comparison: any, validationOptions?: ValidationOptions
       name: NOT_EQUALS,
       constraints: [comparison],
       validator: {
-        validate: (value, args): boolean => notEquals(value, args.constraints[0]),
+        validate: (value, args): boolean => notEquals(value, args?.constraints[0]),
         defaultMessage: buildMessage(
           eachPrefix => eachPrefix + '$property should not be equal to $constraint1',
           validationOptions

src/decorator/date/MaxDate.ts

@@ -19,7 +19,7 @@ export function MaxDate(date: Date, validationOptions?: ValidationOptions): Prop
       name: MAX_DATE,
       constraints: [date],
       validator: {
-        validate: (value, args): boolean => maxDate(value, args.constraints[0]),
+        validate: (value, args): boolean => maxDate(value, args?.constraints[0]),
         defaultMessage: buildMessage(
           eachPrefix => 'maximal allowed date for ' + eachPrefix + '$property is $constraint1',
           validationOptions

src/decorator/date/MinDate.ts

@@ -19,7 +19,7 @@ export function MinDate(date: Date, validationOptions?: ValidationOptions): Prop
       name: MIN_DATE,
       constraints: [date],
       validator: {
-        validate: (value, args): boolean => minDate(value, args.constraints[0]),
+        validate: (value, args): boolean => minDate(value, args?.constraints[0]),
         defaultMessage: buildMessage(
           eachPrefix => 'minimal allowed date for ' + eachPrefix + '$property is $constraint1',
           validationOptions

src/decorator/number/IsDivisibleBy.ts

@@ -20,7 +20,7 @@ export function IsDivisibleBy(num: number, validationOptions?: ValidationOptions
       name: IS_DIVISIBLE_BY,
       constraints: [num],
       validator: {
-        validate: (value, args): boolean => isDivisibleBy(value, args.constraints[0]),
+        validate: (value, args): boolean => isDivisibleBy(value, args?.constraints[0]),
         defaultMessage: buildMessage(
           eachPrefix => eachPrefix + '$property must be divisible by $constraint1',
           validationOptions

src/decorator/number/Max.ts

@@ -19,7 +19,7 @@ export function Max(maxValue: number, validationOptions?: ValidationOptions): Pr
       name: MAX,
       constraints: [maxValue],
       validator: {
-        validate: (value, args): boolean => max(value, args.constraints[0]),
+        validate: (value, args): boolean => max(value, args?.constraints[0]),
         defaultMessage: buildMessage(
           eachPrefix => eachPrefix + '$property must not be greater than $constraint1',
           validationOptions

src/decorator/number/Min.ts

@@ -19,7 +19,7 @@ export function Min(minValue: number, validationOptions?: ValidationOptions): Pr
       name: MIN,
       constraints: [minValue],
       validator: {
-        validate: (value, args): boolean => min(value, args.constraints[0]),
+        validate: (value, args): boolean => min(value, args?.constraints[0]),
         defaultMessage: buildMessage(
           eachPrefix => eachPrefix + '$property must not be less than $constraint1',
           validationOptions

src/decorator/object/IsInstance.ts

@@ -24,10 +24,10 @@ export function IsInstance(
       name: IS_INSTANCE,
       constraints: [targetType],
       validator: {
-        validate: (value, args): boolean => isInstance(value, args.constraints[0]),
+        validate: (value, args): boolean => isInstance(value, args?.constraints[0]),
         defaultMessage: buildMessage((eachPrefix, args) => {
-          if (args.constraints[0]) {
-            return eachPrefix + `$property must be an instance of ${args.constraints[0].name as string}`;
+          if (args?.constraints[0]) {
+            return eachPrefix + `$property must be an instance of ${args?.constraints[0].name as string}`;
           } else {
             return eachPrefix + `${IS_INSTANCE} decorator expects and object as value, but got falsy value.`;
           }

src/decorator/object/IsNotEmptyObject.ts

@@ -13,7 +13,7 @@ export function isNotEmptyObject(value: unknown, options?: { nullable?: boolean
     return false;
   }
 
-  if (options?.nullable === true) {
+  if (options?.nullable === false) {
     return !Object.values(value).every(propertyValue => propertyValue === null || propertyValue === undefined);
   }
 
@@ -39,7 +39,7 @@ export function IsNotEmptyObject(
       name: IS_NOT_EMPTY_OBJECT,
       constraints: [options],
       validator: {
-        validate: (value, args): boolean => isNotEmptyObject(value, args.constraints[0]),
+        validate: (value, args): boolean => isNotEmptyObject(value, args?.constraints[0]),
         defaultMessage: buildMessage(
           eachPrefix => eachPrefix + '$property must be a non-empty object',
           validationOptions

src/decorator/string/Contains.ts

@@ -22,7 +22,7 @@ export function Contains(seed: string, validationOptions?: ValidationOptions): P
       name: CONTAINS,
       constraints: [seed],
       validator: {
-        validate: (value, args): boolean => contains(value, args.constraints[0]),
+        validate: (value, args): boolean => contains(value, args?.constraints[0]),
         defaultMessage: buildMessage(
           eachPrefix => eachPrefix + '$property must contain a $constraint1 string',
           validationOptions

src/decorator/string/IsAlpha.ts

@@ -9,21 +9,29 @@ export const IS_ALPHA = 'isAlpha';
  * Checks if the string contains only letters (a-zA-Z).
  * If given value is not a string, then it returns false.
  */
-export function isAlpha(value: unknown, locale?: ValidatorJS.AlphaLocale): boolean {
-  return typeof value === 'string' && isAlphaValidator(value, locale);
+export function isAlpha(
+  value: unknown,
+  locale?: ValidatorJS.AlphaLocale,
+  options?: ValidatorJS.IsAlphaOptions
+): boolean {
+  return typeof value === 'string' && isAlphaValidator(value, locale, options);
 }
 
 /**
  * Checks if the string contains only letters (a-zA-Z).
  * If given value is not a string, then it returns false.
  */
-export function IsAlpha(locale?: string, validationOptions?: ValidationOptions): PropertyDecorator {
+export function IsAlpha(
+  locale?: string,
+  validationOptions?: ValidationOptions,
+  options?: ValidatorJS.IsAlphaOptions
+): PropertyDecorator {
   return ValidateBy(
     {
       name: IS_ALPHA,
-      constraints: [locale],
+      constraints: [locale, options],
       validator: {
-        validate: (value, args): boolean => isAlpha(value, args.constraints[0]),
+        validate: (value, args): boolean => isAlpha(value, args.constraints[0], args.constraints[1]),
         defaultMessage: buildMessage(
           eachPrefix => eachPrefix + '$property must contain only letters (a-zA-Z)',
           validationOptions

src/decorator/string/IsAlphanumeric.ts

@@ -9,21 +9,29 @@ export const IS_ALPHANUMERIC = 'isAlphanumeric';
  * Checks if the string contains only letters and numbers.
  * If given value is not a string, then it returns false.
  */
-export function isAlphanumeric(value: unknown, locale?: ValidatorJS.AlphanumericLocale): boolean {
-  return typeof value === 'string' && isAlphanumericValidator(value, locale);
+export function isAlphanumeric(
+  value: unknown,
+  locale?: ValidatorJS.AlphanumericLocale,
+  options?: ValidatorJS.IsAlphanumericOptions
+): boolean {
+  return typeof value === 'string' && isAlphanumericValidator(value, locale, options);
 }
 
 /**
  * Checks if the string contains only letters and numbers.
  * If given value is not a string, then it returns false.
  */
-export function IsAlphanumeric(locale?: string, validationOptions?: ValidationOptions): PropertyDecorator {
+export function IsAlphanumeric(
+  locale?: string,
+  validationOptions?: ValidationOptions,
+  options?: ValidatorJS.IsAlphanumericOptions
+): PropertyDecorator {
   return ValidateBy(
     {
       name: IS_ALPHANUMERIC,
-      constraints: [locale],
+      constraints: [locale, options],
       validator: {
-        validate: (value, args): boolean => isAlphanumeric(value, args.constraints[0]),
+        validate: (value, args): boolean => isAlphanumeric(value, args.constraints[0], args.constraints[1]),
         defaultMessage: buildMessage(
           eachPrefix => eachPrefix + '$property must contain only letters and numbers',
           validationOptions

src/decorator/string/IsByteLength.ts

@@ -22,7 +22,7 @@ export function IsByteLength(min: number, max?: number, validationOptions?: Vali
       name: IS_BYTE_LENGTH,
       constraints: [min, max],
       validator: {
-        validate: (value, args): boolean => isByteLength(value, args.constraints[0], args.constraints[1]),
+        validate: (value, args): boolean => isByteLength(value, args?.constraints[0], args?.constraints[1]),
         defaultMessage: buildMessage(
           eachPrefix => eachPrefix + "$property's byte length must fall into ($constraint1, $constraint2) range",
           validationOptions

src/decorator/string/IsCurrency.ts

@@ -26,7 +26,7 @@ export function IsCurrency(
       name: IS_CURRENCY,
       constraints: [options],
       validator: {
-        validate: (value, args): boolean => isCurrency(value, args.constraints[0]),
+        validate: (value, args): boolean => isCurrency(value, args?.constraints[0]),
         defaultMessage: buildMessage(eachPrefix => eachPrefix + '$property must be a currency', validationOptions),
       },
     },

src/decorator/string/IsDateString.ts

@@ -24,7 +24,7 @@ export function IsDateString(
       name: IS_DATE_STRING,
       constraints: [options],
       validator: {
-        validate: (value, args): boolean => isDateString(value),
+        validate: (value): boolean => isDateString(value, options),
         defaultMessage: buildMessage(
           eachPrefix => eachPrefix + '$property must be a valid ISO 8601 date string',
           validationOptions

src/decorator/string/IsDecimal.ts

@@ -14,7 +14,7 @@ export function isDecimal(value: unknown, options?: ValidatorJS.IsDecimalOptions
 }
 
 /**
- * Checks if the string contains only letters and numbers.
+ * Checks if the string is a valid decimal.
  * If given value is not a string, then it returns false.
  */
 export function IsDecimal(
@@ -26,7 +26,7 @@ export function IsDecimal(
       name: IS_DECIMAL,
       constraints: [options],
       validator: {
-        validate: (value, args): boolean => isDecimal(value, args.constraints[0]),
+        validate: (value, args): boolean => isDecimal(value, args?.constraints[0]),
         defaultMessage: buildMessage(
           eachPrefix => eachPrefix + '$property is not a valid decimal number.',
           validationOptions

src/decorator/string/IsEmail.ts

@@ -26,7 +26,7 @@ export function IsEmail(
       name: IS_EMAIL,
       constraints: [options],
       validator: {
-        validate: (value, args): boolean => isEmail(value, args.constraints[0]),
+        validate: (value, args): boolean => isEmail(value, args?.constraints[0]),
         defaultMessage: buildMessage(eachPrefix => eachPrefix + '$property must be an email', validationOptions),
       },
     },

src/decorator/string/IsFQDN.ts

@@ -23,7 +23,7 @@ export function IsFQDN(options?: ValidatorJS.IsFQDNOptions, validationOptions?:
       name: IS_FQDN,
       constraints: [options],
       validator: {
-        validate: (value, args): boolean => isFQDN(value, args.constraints[0]),
+        validate: (value, args): boolean => isFQDN(value, args?.constraints[0]),
         defaultMessage: buildMessage(
           eachPrefix => eachPrefix + '$property must be a valid domain name',
           validationOptions

src/decorator/string/IsHalfWidth.ts

@@ -13,7 +13,7 @@ export function isHalfWidth(value: unknown): boolean {
 }
 
 /**
- * Checks if the string contains any full-width chars.
+ * Checks if the string contains any half-width chars.
  * If given value is not a string, then it returns false.
  */
 export function IsHalfWidth(validationOptions?: ValidationOptions): PropertyDecorator {

src/decorator/string/IsHash.ts

@@ -25,7 +25,7 @@ export function IsHash(algorithm: string, validationOptions?: ValidationOptions)
       name: IS_HASH,
       constraints: [algorithm],
       validator: {
-        validate: (value, args): boolean => isHash(value, args.constraints[0]),
+        validate: (value, args): boolean => isHash(value, args?.constraints[0]),
         defaultMessage: buildMessage(
           eachPrefix => eachPrefix + '$property must be a hash of type $constraint1',
           validationOptions

src/decorator/string/IsIP.ts

@@ -26,7 +26,7 @@ export function IsIP(version?: IsIpVersion, validationOptions?: ValidationOption
       name: IS_IP,
       constraints: [version],
       validator: {
-        validate: (value, args): boolean => isIP(value, args.constraints[0]),
+        validate: (value, args): boolean => isIP(value, args?.constraints[0]),
         defaultMessage: buildMessage(eachPrefix => eachPrefix + '$property must be an ip address', validationOptions),
       },
     },