pixkey

pixkey - Identifier, normalizer, formatter

This lib identifies/validates, normalizes and formats a Pix key from a string, directly inferencing the key type.

Note that it only validates the data type and does not check whether a Pix key is registered on Bacen's DICT. For that, you must be a registered Pix participant or work with one.

Installing

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. [phone]).
• 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.

1.0.0

• First version