Nine Pedestrians Mesmerized

    pixkey

    2.0.0 • Public • Published

    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 false 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.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

    Install

    npm i pixkey

    DownloadsWeekly Downloads

    7

    Version

    2.0.0

    License

    MIT

    Unpacked Size

    14.8 kB

    Total Files

    7

    Last publish

    Collaborators

    • jesobreira