Description

This PR adds a model validator to the Telecom class that strips leading/trailing whitespace from emails and normalizes phone as an E164 string, i.e., including country codes but excluding extensions. When using feature_iter, only the national number (no country code) is used for comparison to avoid issues with Jaro-Winkler over indexing on similarities in country codes. For emails, we do not apply text normalization in feature_iter so that we can preserve the special characters for comparison.

Storing:

• email: email with leading/trailing whitespace removed
• phone number: normalized to E164 where possible, otherwise store raw number

Comparing:
-email: same as storage
phone number: national number (no country code) and normalized_text() is applied to remove additional special characters. I primarily kept normalized_text in case we were not able to normalize to E164 during ingestion and we want to remove special characters.

Related Issues

Fixes #248

Additional Notes

<--------------------- REMOVE THE LINES BELOW BEFORE MERGING --------------------->

Checklist

Please review and complete the following checklist before submitting your pull request:

• I have ensured that the pull request is of a manageable size, allowing it to be reviewed within a single session.
• I have reviewed my changes to ensure they are clear, concise, and well-documented.
• I have updated the documentation, if applicable.
• I have added or updated test cases to cover my changes, if applicable.
• I have minimized the number of reviewers to include only those essential for the review.

Checklist for Reviewers

Please review and complete the following checklist during the review process:

• The code follows best practices and conventions.
• The changes implement the desired functionality or fix the reported issue.
• The tests cover the new changes and pass successfully.
• Any potential edge cases or error scenarios have been considered.