feat: update UUID validation to support versions 1-8, nil, max, and all (#2647)

* fix: update UUID validation to support versions 1-8, nil, max, and all

* feat: add loose UUID validation and update documentation

* feat: enhance isUUID function to support array of versions and add corresponding tests

* test: update loose UUID validation tests with new valid and invalid cases

* Enhance @IsUUID description for version support

Updated the @IsUUID description to include support for an array of versions.

---------

Co-authored-by: Brage Sekse Aarset <brage.aarset@gmail.com>

Author: PleBea

README.md

@@ -930,7 +930,7 @@ isBoolean(value);
 | `@IsTaxId()`                                           | Checks if the string is a valid tax ID. Default locale is `en-US`.                                                                                                                                    |
 | `@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?: UUIDVersion)`                       | Checks if the string is a UUID (version 3, 4, 5 or all ).                                                                                                                                             |
+| `@IsUUID(version?: UUIDVersion)`                       | Checks if the string is a UUID (version 1-8, nil, max, loose, all). Also accepts array of versions.                                                                                                   |
 | `@IsFirebasePushId()`                                  | Checks if the string is a [Firebase Push ID](https://firebase.googleblog.com/2015/02/the-2120-ways-to-ensure-unique_68.html)                                                                          |
 | `@IsUppercase()`                                       | Checks if the string is uppercase.                                                                                                                                                                    |
 | `@Length(min: number, max?: number)`                   | Checks if the string's length falls in a range.                                                                                                                                                       |

src/decorator/string/IsUUID.ts

@@ -5,19 +5,30 @@ import * as ValidatorJS from 'validator';
 
 export const IS_UUID = 'isUuid';
 
+export type IsUUIDVersion = ValidatorJS.UUIDVersion | ValidatorJS.UUIDVersion[];
+
 /**
- * Checks if the string is a UUID (version 3, 4 or 5).
+ * Checks if the string is a UUID (version 1-8, nil, max, loose, all).
  * If given value is not a string, then it returns false.
+ * Supports single version or array of versions.
  */
-export function isUUID(value: unknown, version?: ValidatorJS.UUIDVersion): boolean {
-  return typeof value === 'string' && isUuidValidator(value, version);
+export function isUUID(value: unknown, version?: IsUUIDVersion): boolean {
+  if (typeof value !== 'string') return false;
+  if (Array.isArray(version)) {
+    for (const v of version) {
+      if (isUuidValidator(value, v)) return true;
+    }
+    return false;
+  }
+  return isUuidValidator(value, version);
 }
 
 /**
- * Checks if the string is a UUID (version 3, 4 or 5).
+ * Checks if the string is a UUID (version 1-8, nil, max, loose, all).
  * If given value is not a string, then it returns false.
+ * Supports single version or array of versions.
  */
-export function IsUUID(version?: ValidatorJS.UUIDVersion, validationOptions?: ValidationOptions): PropertyDecorator {
+export function IsUUID(version?: IsUUIDVersion, validationOptions?: ValidationOptions): PropertyDecorator {
   return ValidateBy(
     {
       name: IS_UUID,