feat: added phonenumber type validator to IsPhoneNumber.ts

Author: Sylar-3

src/decorator/string/IsPhoneNumber.ts

@@ -1,6 +1,12 @@
+import { PhoneNumberType } from '../../utils/phone-number-type';
 import { ValidationOptions } from '../ValidationOptions';
 import { buildMessage, ValidateBy } from '../common/ValidateBy';
-import { parsePhoneNumber, CountryCode } from 'libphonenumber-js/max';
+
+/* Changed import to /max for all metadata provided in the library in order to check phone number type
+ * since the (default = /min) always returns undefined in the .getType()
+ * reference https://www.npmjs.com/package/libphonenumber-js
+ */
+import { parsePhoneNumberFromString, CountryCode } from 'libphonenumber-js/max';
 
 export const IS_PHONE_NUMBER = 'isPhoneNumber';
 
@@ -10,26 +16,30 @@ export const IS_PHONE_NUMBER = 'isPhoneNumber';
  *
  * @param value the potential phone number string to test
  * @param region 2 characters uppercase country code (e.g. DE, US, CH) for country specific validation.
+ * @param acceptedNumbersTypes list of accepted number types (MOBILE, PAGER, etc...) if not provided check only MOBILE.
  * If text doesn't start with the international calling code (e.g. +41), then you must set this parameter.
  */
-export function isPhoneNumber(value: string, region?: CountryCode): boolean {
-  if (typeof value !== 'string' || value.trim() !== value) {
-    return false;
-  }
-
+export function isPhoneNumber(
+  value: string,
+  region?: CountryCode,
+  acceptedNumbersTypes?: Array<PhoneNumberType>
+): boolean {
   try {
-    const phoneNumber = parsePhoneNumber(value, region);
+    // the list of all phone number types that are the output of .getType() method
+    let checkedNumberTypes = ['MOBILE'];
 
-    /**
-     * We fail the validation if the user provided a region code
-     * and it doesn't match with the country code of the parsed number.
-     **/
-    if (region && phoneNumber.country !== region) {
-      return false;
+    // Checking if accepted types array is passed to override the default MOBILE number type
+    if (acceptedNumbersTypes) {
+      checkedNumberTypes = acceptedNumbersTypes;
     }
 
-    return phoneNumber.isValid();
+    const phoneNum = parsePhoneNumberFromString(value, region);
+
+    // number must be valid and is one of the phone types the function accepts (ALL TYPES PROVIDED IN phone-number-types.ts)
+    const result: boolean = !!phoneNum?.isValid() && !!checkedNumberTypes.some(item => item === phoneNum?.getType());
+    return !!result;
   } catch (error) {
+    // logging?
     return false;
   }
 }

src/utils/phone-number-type.ts

@@ -0,0 +1,15 @@
+/*
+  types of all possible return values of the .getType() in the phone number libphonenumber-js/max library
+*/
+export type PhoneNumberType =
+  | 'FIXED_LINE_OR_MOBILE'
+  | 'MOBILE'
+  | 'FIXED_LINE'
+  | 'PREMIUM_RATE'
+  | 'TOLL_FREE'
+  | 'SHARED_COST'
+  | 'VOIP'
+  | 'PERSONAL_NUMBER'
+  | 'PAGER'
+  | 'UAN'
+  | 'VOICEMAIL';