{"_id":"@artrsousa/cpf-cnpj-validator","_rev":"5-7d8e2d6c1a493b5cc46e40d0907db229","name":"@artrsousa/cpf-cnpj-validator","dist-tags":{"latest":"1.0.4"},"versions":{"1.0.0":{"name":"@artrsousa/cpf-cnpj-validator","version":"1.0.0","keywords":["cpf","cnpj","brasil","validator","generator","cadastro","pessoa física","pessoa jurídica"],"author":"","license":"MIT","_id":"@artrsousa/cpf-cnpj-validator@1.0.0","maintainers":[{"name":"artrsousa","email":"artrsousa.dev@gmail.com"}],"dist":{"shasum":"b15e6ae7052d5586c8f2c0655219cac600be376c","tarball":"https://registry.npmjs.org/@artrsousa/cpf-cnpj-validator/-/cpf-cnpj-validator-1.0.0.tgz","fileCount":17,"integrity":"sha512-wmX/qwIbgg/dGIU05ANVJ06YyBD5v6UwIsrIRrHEzTLrlrmH906khVSjbep6p01PeaxCip0uJG8PuY4S9GoxpA==","signatures":[{"sig":"MEUCIQCu282QLj/BSnmyuiJiqmL1FosTvDaGRSL1jhjWNAXbHwIgYprHbrH5CgA0Bjf9IwwDCtYizsMkQavlzXqYUXtHao4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":27476},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js"}},"gitHead":"6321b8087875d7feb975a25ad01e328f04df2a1f","scripts":{"test":"npm run build && node --test test/cpf.test.js test/cnpj.test.js","build":"tsc"},"_npmUser":{"name":"artrsousa","email":"artrsousa.dev@gmail.com"},"_npmVersion":"11.4.2","description":"Valida e gera CPF e CNPJ válidos (Brasil)","directories":{},"_nodeVersion":"24.3.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2"},"_npmOperationalInternal":{"tmp":"tmp/cpf-cnpj-validator_1.0.0_1772135916172_0.17244735916992981","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@artrsousa/cpf-cnpj-validator","version":"1.0.1","keywords":["cpf","cnpj","brasil","validator","generator","cadastro","pessoa física","pessoa jurídica"],"author":"","license":"MIT","_id":"@artrsousa/cpf-cnpj-validator@1.0.1","maintainers":[{"name":"artrsousa","email":"artrsousa.dev@gmail.com"}],"dist":{"shasum":"6fb1d6a32ce07f5448882cc77bca19d28feac7fb","tarball":"https://registry.npmjs.org/@artrsousa/cpf-cnpj-validator/-/cpf-cnpj-validator-1.0.1.tgz","fileCount":17,"integrity":"sha512-zL/Ziv7nicoCudGPhPIyTnWzhZN12ZNZA1ns6P1zfHqTEFOlBap2zA1gY5Hw5GrBzvDjPk1sS7oZ3y/zTIYnIQ==","signatures":[{"sig":"MEQCIFG6KFTxmOyjdip4+datQtpi0azM/EdmE6jiWq0YgVGfAiAMteun+bJM7J7fLz8HDi9nPNkok3ECGSOwww8tGFXq8Q==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":27573},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js"}},"gitHead":"9c5059a6395799a6895e961cda419296c1750655","scripts":{"test":"npm run build && node --test test/cpf.test.js test/cnpj.test.js","build":"tsc"},"_npmUser":{"name":"artrsousa","email":"artrsousa.dev@gmail.com"},"_npmVersion":"11.4.2","description":"Valida e gera CPF e CNPJ válidos (Brasil)","directories":{},"_nodeVersion":"24.3.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2"},"_npmOperationalInternal":{"tmp":"tmp/cpf-cnpj-validator_1.0.1_1772136856711_0.4660198671899647","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@artrsousa/cpf-cnpj-validator","version":"1.0.2","keywords":["cpf","cnpj","brasil","validator","generator","cadastro","pessoa física","pessoa jurídica"],"author":"","license":"MIT","_id":"@artrsousa/cpf-cnpj-validator@1.0.2","maintainers":[{"name":"artrsousa","email":"artrsousa.dev@gmail.com"}],"dist":{"shasum":"ed3ee5dc69f972d816335af842f3bed04d07fb83","tarball":"https://registry.npmjs.org/@artrsousa/cpf-cnpj-validator/-/cpf-cnpj-validator-1.0.2.tgz","fileCount":18,"integrity":"sha512-TjMkNZjS2esDpkJ1FjiMueG8eS4xvyBr/FSobCtKnFXUzkytTYJPtivnwXIkuqQpk7vFbyB4RflZhRVOcZiMcA==","signatures":[{"sig":"MEUCIG07os4VolVwy66uiCW1vL8jasMiJYusJcZXporWSpNwAiEAkYhfeZSbDTGGqn2+0MNYKHz1EHjW3uFmyQn5oLypz7Y=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":28642},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js"}},"gitHead":"1c1e2caa3a6399fd583d37060041af72b7c4be91","scripts":{"test":"npm run build && node --test test/cpf.test.js test/cnpj.test.js","build":"tsc"},"_npmUser":{"name":"artrsousa","email":"artrsousa.dev@gmail.com"},"_npmVersion":"11.4.2","description":"Valida e gera CPF e CNPJ válidos (Brasil)","directories":{},"_nodeVersion":"24.3.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2"},"_npmOperationalInternal":{"tmp":"tmp/cpf-cnpj-validator_1.0.2_1772137879594_0.5015049684436745","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@artrsousa/cpf-cnpj-validator","version":"1.0.3","keywords":["cpf","cnpj","brasil","validator","generator","cadastro","pessoa física","pessoa jurídica"],"author":"","license":"MIT","_id":"@artrsousa/cpf-cnpj-validator@1.0.3","maintainers":[{"name":"artrsousa","email":"artrsousa.dev@gmail.com"}],"homepage":"https://github.com/artrsousa1/cpf-cnpj-validator#readme","bugs":{"url":"https://github.com/artrsousa1/cpf-cnpj-validator/issues"},"dist":{"shasum":"31670dfa6b299510f136c911d292aaf2e92475a5","tarball":"https://registry.npmjs.org/@artrsousa/cpf-cnpj-validator/-/cpf-cnpj-validator-1.0.3.tgz","fileCount":18,"integrity":"sha512-NoJR3A+t4txqi2jmCB+6ZxFe/EnvcMzT/KxdUE3eeOTEWZWBRHMQQjafeRcNFG1ZGrZ1SHkOzyyKhcoHDlctaQ==","signatures":[{"sig":"MEUCIQC9yn3qg0P0wo/ndJgEVYIzXWVOX2mHAUfDhuQMDT9IzQIgZoCRMazkwSxakBDHlu1IjM/7H4912wFQ/gIkKdmMPnc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":28772},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js"}},"gitHead":"95718e071fb93fd817f36ce239db961c23679565","scripts":{"test":"npm run build && node --test test/cpf.test.js test/cnpj.test.js","build":"tsc"},"_npmUser":{"name":"artrsousa","email":"artrsousa.dev@gmail.com"},"repository":{"url":"git+https://github.com/artrsousa1/cpf-cnpj-validator.git","type":"git"},"_npmVersion":"11.4.2","description":"Valida e gera CPF e CNPJ válidos (Brasil)","directories":{},"_nodeVersion":"24.3.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2"},"_npmOperationalInternal":{"tmp":"tmp/cpf-cnpj-validator_1.0.3_1772138176908_0.9054399305908085","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"@artrsousa/cpf-cnpj-validator","version":"1.0.4","description":"Valida e gera CPF e CNPJ válidos (Brasil)","type":"module","main":"dist/index.js","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js"}},"scripts":{"build":"tsc","test":"npm run build && node --test test/cpf.test.js test/cnpj.test.js"},"keywords":["cpf","cnpj","brasil","validator","generator","cadastro","pessoa física","pessoa jurídica"],"repository":{"type":"git","url":"git+https://github.com/artrsousa1/cpf-cnpj-validator.git"},"author":"","license":"MIT","devDependencies":{"typescript":"^5.7.2"},"_id":"@artrsousa/cpf-cnpj-validator@1.0.4","gitHead":"6673bdcdc481e71b9bdf76be16fb4d0fc83ceb92","bugs":{"url":"https://github.com/artrsousa1/cpf-cnpj-validator/issues"},"homepage":"https://github.com/artrsousa1/cpf-cnpj-validator#readme","_nodeVersion":"24.3.0","_npmVersion":"11.4.2","dist":{"integrity":"sha512-rGwywrVLkSxj4oPy2znwCcYgMNFRXhtN7g14BstmDf7ZyPjFCx69s3/BScu2DNCgSXl36kgSd2RHxytBn9XoWQ==","shasum":"3b89c1806b2142b20665cc35664a6d39694ef54d","tarball":"https://registry.npmjs.org/@artrsousa/cpf-cnpj-validator/-/cpf-cnpj-validator-1.0.4.tgz","fileCount":18,"unpackedSize":28538,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIDsMixZJhOB1aL0yR9eXLvTHhb5TJT+DHAY3jYsonlEjAiEA2fVLdZjGPrDnRy3P3WzsxvPewx2mG8eR6TNi0eT1Mog="}]},"_npmUser":{"name":"artrsousa","email":"artrsousa.dev@gmail.com"},"directories":{},"maintainers":[{"name":"artrsousa","email":"artrsousa.dev@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/cpf-cnpj-validator_1.0.4_1772211224044_0.49208367536758435"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-26T19:58:36.095Z","modified":"2026-02-27T16:53:44.293Z","1.0.0":"2026-02-26T19:58:36.309Z","1.0.1":"2026-02-26T20:14:16.839Z","1.0.2":"2026-02-26T20:31:19.759Z","1.0.3":"2026-02-26T20:36:17.053Z","1.0.4":"2026-02-27T16:53:44.180Z"},"bugs":{"url":"https://github.com/artrsousa1/cpf-cnpj-validator/issues"},"license":"MIT","homepage":"https://github.com/artrsousa1/cpf-cnpj-validator#readme","keywords":["cpf","cnpj","brasil","validator","generator","cadastro","pessoa física","pessoa jurídica"],"repository":{"type":"git","url":"git+https://github.com/artrsousa1/cpf-cnpj-validator.git"},"description":"Valida e gera CPF e CNPJ válidos (Brasil)","maintainers":[{"name":"artrsousa","email":"artrsousa.dev@gmail.com"}],"readme":"# cpf-cnpj-validator\n\nBiblioteca leve e tipada para **validação, geração e formatação** de **CPF** e **CNPJ** válidos (Brasil), utilizando o algoritmo oficial de dígitos verificadores da Receita Federal.\n\n## Características\n\n* Validação de CPF numérico\n* Validação de CNPJ numérico\n* Suporte a CNPJ alfanumérico (formato futuro da Receita Federal)\n* Escrita em TypeScript\n* ESM-only (Node.js 18+)\n* Sem dependências externas\n\n---\n\n## Instalação\n\n```bash\nnpm install @artrsousa/cpf-cnpj-validator\n```\n\n---\n\n## Uso\n\nA biblioteca é ESM-only (`\"type\": \"module\"`).\nUtilize `import` em Node.js 18+ ou bundlers modernos (Vite, Webpack, etc).\n\n---\n\n## Uso com JavaScript (ES Modules)\n\n```javascript\nimport { cpf, cnpj } from '@artrsousa/cpf-cnpj-validator';\n\n// CPF\ncpf.isValid('313.402.809-30');\ncpf.isValid('31340280930');\n\ncpf.generate(); \ncpf.generate({ formatted: false });\n\ncpf.format('31340280930');\n\n// CNPJ numérico\ncnpj.isValid('11.222.333/0001-81');\ncnpj.isValid('11222333000181');\n\ncnpj.generate();\ncnpj.generate({ formatted: false });\n\ncnpj.format('11222333000181');\n\n// CNPJ alfanumérico\ncnpj.generate({ type: 'alphanumeric' });\ncnpj.generate({ type: 'alphanumeric', formatted: false });\n```\n\n---\n\n## Uso com TypeScript\n\nA biblioteca inclui definições de tipos (`.d.ts`).\n\n```typescript\nimport {\n  cpf,\n  cnpj,\n  type CPF,\n  type CNPJ,\n  type CpfGenerateOptions,\n  type CnpjGenerateOptions\n} from '@artrsousa/cpf-cnpj-validator';\n\nconst cpfValue: string = '313.402.809-30';\n\nif (cpf.isValid(cpfValue)) {\n  const formatted: string | null = cpf.format(cpfValue);\n  console.log(formatted);\n}\n\nconst options: CnpjGenerateOptions = {\n  type: 'alphanumeric',\n  formatted: true,\n};\n\nconst novoCnpj: string = cnpj.generate(options);\n```\n\n---\n\n## Tipos Exportados\n\n| Tipo                  | Descrição                     |\n| --------------------- | ----------------------------- |\n| `CPF`                 | Interface da API de CPF       |\n| `CNPJ`                | Interface da API de CNPJ      |\n| `CpfGenerateOptions`  | Opções para `cpf.generate()`  |\n| `CnpjGenerateOptions` | Opções para `cnpj.generate()` |\n\n---\n\n# API\n\n## CPF\n\n### `cpf.isValid(value: string): boolean`\n\nValida um CPF.\n\n* Aceita com ou sem formatação\n* Rejeita sequências repetidas (ex: `111.111.111-11`)\n* Valida os dígitos verificadores\n\n---\n\n### `cpf.generate(options?: CpfGenerateOptions): string`\n\nGera um CPF válido aleatoriamente.\n\n| Opção       | Tipo      | Padrão |\n| ----------- | --------- | ------ |\n| `formatted` | `boolean` | `true` |\n\nExemplo:\n\n```typescript\ncpf.generate();\ncpf.generate({ formatted: false });\n```\n\n---\n\n### `cpf.format(value: string): string | null`\n\nFormata para o padrão:\n\n```\n000.000.000-00\n```\n\nRetorna `null` caso não possua 11 dígitos válidos.\n\n---\n\n## CNPJ\n\n### `cnpj.isValid(value: string): boolean`\n\nValida CNPJ numérico.\n\n* Aceita com ou sem formatação\n* Rejeita sequências repetidas\n* Valida os dígitos verificadores\n\n---\n\n### `cnpj.generate(options?: CnpjGenerateOptions): string`\n\nGera um CNPJ válido.\n\n| Opção       | Tipo                          | Padrão      |\n| ----------- | ----------------------------- | ----------- |\n| `type`      | `'numeric' \\| 'alphanumeric'` | `'numeric'` |\n| `formatted` | `boolean`                     | `true`      |\n\nExemplo:\n\n```typescript\ncnpj.generate();\n\ncnpj.generate({\n  type: 'alphanumeric',\n  formatted: false\n});\n```\n\n---\n\n### `cnpj.format(value: string): string | null`\n\nFormata para o padrão:\n\n```\n00.000.000/0000-00\n```\n\n* Funciona para CNPJ numérico\n* Funciona para CNPJ alfanumérico\n* Retorna `null` se não possuir 14 caracteres\n\n---\n\n## Requisitos\n\n* Node.js 18+\n* Ambiente com suporte a ES Modules\n\n---\n\n## Licença\n\nMIT\n\n","readmeFilename":"README.md"}