30397 nr phone validation (bcgov#3782)

* 30397 nr phone validation

* clean up

* add missing

* fix lint

Author: bobdev-94

legal-api/src/legal_api/resources/v2/namerequest.py

@@ -22,6 +22,7 @@
 from legal_api.services import namex
 from legal_api.services.bootstrap import AccountService
 from legal_api.services.permissions import ListActionsPermissionsAllowed, PermissionService
+from legal_api.utils.formatting import normalize_phone
 
 
 bp = Blueprint('NAMEREQUEST2', __name__, url_prefix='/api/v2/nameRequests')
@@ -65,7 +66,7 @@ def validate_with_contact_info(identifier):
         # If NR is not affiliated, validate the email and phone
         nr_phone = nr_json.get('applicants').get('phoneNumber')
         nr_email = nr_json.get('applicants').get('emailAddress')
-        if (phone and phone != nr_phone) or (email and email != nr_email):
+        if (phone and normalize_phone(phone) != normalize_phone(nr_phone)) or (email and email != nr_email):
             return make_response(jsonify(message='Invalid email or phone number.'), 400)
 
         return jsonify(nr_json)

legal-api/src/legal_api/utils/formatting.py

@@ -13,6 +13,7 @@
 # limitations under the License.
 """Custom formatting."""
 import decimal
+import re
 
 
 def float_to_str(f, precision=17):
@@ -22,3 +23,28 @@ def float_to_str(f, precision=17):
 
     value = ctx.create_decimal(repr(f))
     return format(value, 'f')
+
+
+def normalize_phone(phone: str) -> str:
+    """
+    Normalize a phone number by stripping all non-digit characters.
+
+    This function takes a phone number string in various formats
+    (e.g., "555-555-5555", "555 555 5555", "(555) 555-5555", "+1 (555) 555-5555") and returns
+    a normalized string containing only digits.
+
+    Args:
+        phone_number (str): The phone number string to normalize.
+
+    Returns:
+        str: The normalized phone number containing only digits.
+             Example: "5555555555".
+    """
+    # keep only digits
+    digits = re.sub(r"\D", "", phone)
+
+    # handle North America: allow 10 digits, or 11 with leading "1"
+    if len(digits) == 11 and digits.startswith("1"):
+        digits = digits[1:]
+    else:
+        return digits