feat(#8204): Add feature to support adding phone number when registering patients

api/resources/translations/messages-en.properties

@@ -841,6 +841,7 @@ messages.f.report_accepted = Thank you for flagging {{patient_name}} ({{patient_
 messages.f.report_accepted_parent = {{patient_name}} ({{patient_id}}) was flagged by {{contact.name}} ({{contact.phone}}) for further attention.
 messages.generic.no_provided_patient_id = External ID number support is configured, but is not found on document in the configured location.
 messages.generic.provided_patient_id_not_unique = The provided ID number is already used.
+messages.generic.provided_phone_not_valid = The provided phone is not valid.
 messages.generic.registration_accepted = Thank you {{contact.name}} for registering {{patient_name}}. Their ID is {{patient_id}}.
 messages.generic.registration_not_found = No person with ID number '{{patient_id}}' found. Verify the ID and resend the message.
 messages.generic.report_accepted = Thank you {{contact.name}}, {{form}} for {{patient_name}} ({{patient_id}}) has been recorded.

api/resources/translations/messages-ne.properties

@@ -764,7 +764,8 @@ messages.errors.patient.missing =
 messages.f.report_accepted = 
 messages.f.report_accepted_parent = 
 messages.generic.no_provided_patient_id = 
-messages.generic.provided_patient_id_not_unique = 
+messages.generic.provided_patient_id_not_unique = तपाइँले पठाउनुभएको आईडी पहिल्यै प्रयोगमा छ।  
+messages.generic.provided_phone_not_valid = तपाइँले पठाउनुभएको फोन नम्बर मिलेन । फेरी प्रयास गर्नुहोस्।
 messages.generic.registration_accepted = 
 messages.generic.registration_not_found = 
 messages.generic.report_accepted = 

api/src/services/report/smsparser.js

@@ -8,6 +8,7 @@ const textformsParser = require('./textforms-parser');
 const logger = require('../../logger');
 const moment = require('moment');
 const bs = require('bikram-sambat');
+const phoneNumberParser = require('@medic/phone-number');
 
 const MUVUKU_REGEX = /^\s*([A-Za-z]?\d)!.+!.+/;
 // matches invisible characters that can mess up our parsing
@@ -209,9 +210,22 @@ const fieldParsers = {
   month: (raw) => {
     // keep months integers, not their list value.
     return parseNum(stripInvisibleCharacters(raw));
+  },
+  phone_number: (raw) => {
+    const formattedAndValidatedPhone = phoneNumberParser.normalize(config.getAll(), raw);
+    if (formattedAndValidatedPhone) {
+      return formattedAndValidatedPhone;
+    } 
+    logger.warn(`The provided phone number ${raw} is invalid`);
+
+    // Returning raw here becuase what to do with invalid phone 
+    // is defined in transitions so error will be thrown there if required. 
+    // Warning is logged just in case.
+    return raw;    
   }
 };
 
+//selects parser by field type and parses and validates the given data.
 exports.parseField = (field, raw, key) => {
   const parser = fieldParsers[field.type];
   if (!parser) {
@@ -281,7 +295,7 @@ exports.parse = (def, doc) => {
     }
   }
 
-  if(aggregateBSDateField) {
+  if (aggregateBSDateField) {
     let bsYear;
     let bsMonth = 1;
     let bsDay = 1;

api/tests/form-definitions.js

@@ -791,5 +791,18 @@ exports.forms = {
         required: true
       }
     }
+  },
+  NP: {
+    meta: {
+      code: 'NP'
+    },
+    fields: {
+      patient_age: {
+        type: 'integer'
+      },
+      phone_number: {
+        type: 'phone_number'
+      }
+    }
   }
 };