Identify, validate, format and normalize a Pix key type from a string
npm install pixkey
npm i pixkey
`
Importing
`
import { validate, format, normalize } from 'pixkey'
// or
const { validate, format, normalize } = require('pixkey')
`
Functions
This lib exposes three functions. They all receive one first argument: the pix key as a string.
normalize and format may also return a second argument "as" (string), to indicate which Pix key type ('cpf', 'cnpj', 'email', 'phone' or 'random') and should be used if the input is dual (i.e. both a valid phone number and CPF).
- validate: validates a Pix key, returning either 'cpf', 'cnpj', 'email', 'phone' or 'random' (depending on the Pix key type) or [] (empty array) if the key is invalid.
- normalize: returns the normalized data, or the key itself if the key is "email" or "random". Normalizing means, for CPF and CNPJ, that all formating characters will be removed, and for phone Pix keys, that it will be changed to the international full phone number format (i.e. +5511987654321).
- format: returns the pix key formatted for better reading, or the key itself if the key is "email" or "random". Formatting means, for CPF and CNPJ, that if it does not contain the group separators, it will be included (".", "-" and "/"), and for phone Pix keys, that it will be changed to the national phone number format (i.e. (11) 98765-4321)
Testing
Tests are available using Mocha. Run npm test.
License
MIT
Changelog
2.0.1
* Rewritten using Typescript and added types
2.0.0
- BREAKING CHANGE validate() now returns an array instead of a string. The array may contain multiple elements (i.e. if the input is a valid CPF but also a valid phone number) or only one.
- BREAKING CHANGE validate() now returns an empty array, and no longer false`, if the input is not valid.