phone_numbers_parser

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

• Upgrade metadata

• Upgrade metadata

• Fix format for argentinian phone number

• Fix wrong format for some countries

• Added a format parameter to choose between international and national format
• Format now uses the national format by default

• added support for remaining phoneNumberTypes (thanks @cottonman132 )

• update metadata

• add demo link in readme

• added VOIP support
• udpated metadata
• Removed MinMaxUtils that was unused internally. While exported publically it was undocumented.

• deprectate getFormattedNsn in favor of formatNsn

• lower meta dependency version for flutter compat

• updated metadata

• updated metadata
• fix for local phone numbers not parsing accurately (issue 46)
• phone numbers starting with the country code of the destination country will now return the phone number without the country code if the phone number is valid without it.
• refactor some internal

• made it easier to contribute
• remove dependency on dart_countries and phone_number_metadata and instead work as a monorepo for easier contribution.
• upgrade metadata

• Changed behavior to not remove the country code from an incomplete phone number that did not start with an exit code.

• Fix issue where international phone numbers would be transformed as if those were local ones.

This major introduces a more accurate parsing logic taking into account caller and destination country.

• add parse method which takes as parameters callerCountry and destinationCountry
• [Breaking]: removed most factory methods on PhoneNumber in favor of parse, see readme
• [Breaking]: renamed validate and validateWithLength to isValid and isValidateLength
• updated metadata
• PhoneNumber.findPotentialPhoneNumbers now returns a list of phone number when scanning text.

• please use 6.0.0 or upgrade to 7.0.0, this is a faulty version.
• deprecated factories

• [Breaking]: removed fromMap, toMap which have been replaced by fromJson(Map), toJson respectively.

• improved readme

• improved readme
• upgraded deps

• updated metadata

• [Breaking] all iso code api now use IsoCode enum
• fix for parseRaw when only country code is present.

• make phone number json serializable

• Fix incorrect parsing in some cases
  • fix validate length as it was incorrectly validating with pattern

• only modify national number to its international version when it is valid
  • resolve issue where phone number were incorrectly parsed if national number started with country code (it happens)

• reexport deprecated public api for backward comp

This release removes the LightPhoneParser because it was not working perfectly and the cost of maintaining two parsers is too high.

Removing that parser allowed to revert to a more succint public API, where methods should be accessed solely via the PhoneNumber class.

PhoneParser, PhoneNumberFormatter and the likes are still exported for backward compatibility but it is advised to switch to PhoneNumber's methods instead

• [Breaking]: LightPhoneParser has been removed as it was imperfect and added complexity in maintaining two parsers.
• [Deprecated]: PhoneParser methods have been deprecated in favor of the methods on PhoneNumber class

• fix formatter error when empty input

• added [parseNational]

• added localized formatter to format a phone number in an human readable way
• added PhoneNumberRanges and utility operators on PhoneNumber (thanks @bsutton)
• renamed [dialCode] to [countryCode] as dialCode was semantically incorrect

• rename base class for parsers to BasePhoneParser, as parser was too broad.
• export BasePhoneParser

• Resolve issue #1 where it was possible to significantly increase memory foothprint by importing both parsers. Thanks @xvrh
• Deplaced validate method from PhoneNumber to PhoneParser and LightPhoneParser to make it more obvious that one is
• Light parser can now parseWithDialCode and parseRaw, although less accurate than the full parser

• Minor doc change

• Added metadata property runtime type to toString to make it more obvious when two instances are not equals

• Made toString more readable

• Add toString to PhoneNumber

• validate method on PhoneNumber

• There are now two parsers:

  • PhoneParser: Heavy, more accurate and more computationally intensive (relies on pattern matching)
  • LightPhoneParser: Light, somewhat accurate and less computationally intensive (relies on length) If a light validation based on length suffice, LightPhoneParser can be used, assuming you don't import the other parser, that will decrease the library size footprint.

  With this change a few breaking changes had to be made

• [Breaking]: PhoneNumber creation is now made with parsers:

  before:

  final frPhone = PhoneNumber.fromRaw('+33 655 5705 76');
  final frPhone1 = PhoneNumber.fromIsoCode('FR', '655 5705 76');
  

  after:

  final frPhone = PhoneParser.fromRaw('+33 655 5705 76')
  final frPhone1 = LightPhoneParser.fromIsoCode('FR', '655 5705 76');
  

• [Breaking]: removed country class and country list, which are now in a separate library

• extracted country data files to another library dart_countries as it can be used in other scenarios
• [Breaking]: Country.getDisplayDialCode is now a getter Country.displayIsoCode.