{"_id":"@br-health-kit/ans","name":"@br-health-kit/ans","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@br-health-kit/ans","version":"1.0.0","description":"Registro de operadoras de planos de saude da ANS, tipado e versionado","license":"MIT","engines":{"node":">=20"},"type":"module","sideEffects":false,"main":"./dist/index.cjs","module":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"},"./web":{"types":"./dist/web.d.ts","import":"./dist/web.js","require":"./dist/web.cjs"},"./data/*":"./data/*"},"dependencies":{"@br-health-kit/core":"1.0.0"},"publishConfig":{"access":"public"},"keywords":["ans","operadoras","plano de saude","saude suplementar","brasil"],"repository":{"type":"git","url":"git+https://github.com/arielff3/br-health-kit.git","directory":"packages/ans"},"homepage":"https://github.com/arielff3/br-health-kit/tree/main/packages/ans#readme","bugs":{"url":"https://github.com/arielff3/br-health-kit/issues"},"scripts":{"build":"tsup","clean":"node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\""},"_id":"@br-health-kit/ans@1.0.0","_integrity":"sha512-LiKkbXl/DEHPxbwGEtcSrW0tKnz+4twxMcNujTfZceiS+Ew2XwX2QQX62feouQzo7QAHvJNhaI6VRMpRzmfnfA==","_resolved":"C:\\Users\\ariel\\AppData\\Local\\Temp\\c78fe834a60b0dbb6eb9d973598fdab8\\br-health-kit-ans-1.0.0.tgz","_from":"file:br-health-kit-ans-1.0.0.tgz","_nodeVersion":"22.17.1","_npmVersion":"10.9.2","dist":{"integrity":"sha512-LiKkbXl/DEHPxbwGEtcSrW0tKnz+4twxMcNujTfZceiS+Ew2XwX2QQX62feouQzo7QAHvJNhaI6VRMpRzmfnfA==","shasum":"f541f75762f1787beec49b206e8e8cfba0b41a86","tarball":"https://registry.npmjs.org/@br-health-kit/ans/-/ans-1.0.0.tgz","fileCount":21,"unpackedSize":726347,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIB2XJvm97fsTuggqyFpPoSeQ4x1e98AiXgsYNeCjUC5fAiEA+dJkwWVvuYwQJbhKtKcEQW1XJ7+68TWGGgGKrhe/4AM="}]},"_npmUser":{"name":"arielff03","email":"arielfrancoferreira5@gmail.com"},"directories":{},"maintainers":[{"name":"arielff03","email":"arielfrancoferreira5@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/ans_1.0.0_1787770210712_0.3950943186192233"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-26T18:50:10.494Z","1.0.0":"2026-08-26T18:50:10.844Z","modified":"2026-08-26T18:50:11.135Z"},"maintainers":[{"name":"arielff03","email":"arielfrancoferreira5@gmail.com"}],"description":"Registro de operadoras de planos de saude da ANS, tipado e versionado","homepage":"https://github.com/arielff3/br-health-kit/tree/main/packages/ans#readme","keywords":["ans","operadoras","plano de saude","saude suplementar","brasil"],"repository":{"type":"git","url":"git+https://github.com/arielff3/br-health-kit.git","directory":"packages/ans"},"bugs":{"url":"https://github.com/arielff3/br-health-kit/issues"},"license":"MIT","readme":"# @br-health-kit/ans\n\nThe ANS register of active health plan operators, typed and versioned.\n\n```bash\nnpm install @br-health-kit/ans\n```\n\n```ts\nimport { ans } from '@br-health-kit/ans'\n\nans.find('419761')                    // by ANS registration number\nans.find(419761)                      // accepts a number; spreadsheets eat the zero\nans.findByCnpj('19.541.931/0001-25')  // formatted or bare\nans.isValidRegistro('419761')\n\nans.byUf('SP')\nans.byModalidade('Cooperativa Médica')\nans.search('unimed')\nans.modalidades()\n```\n\n## The ANS number is not the CNPJ\n\nThe identifier used in TISS guides, billing and regulatory reporting is the\n**ANS registration number** (six digits), not the CNPJ. The two are frequently\nconfused. This package indexes by both.\n\n## What the dataset contains\n\n**Active** operators. Each record carries the legal name, trading name, legal\nform (`modalidade`), address, contact, legal representative,\ncommercialisation region (1 to 6) and the ANS registration date.\n\nFields absent at the source become `null`, never an empty string.\n\n## Versioning\n\nThe source is updated continuously, so the version names the day ANS\npublished, `2026.08.25`, derived from the official file's `Last-Modified`.\n\n```ts\nans.metadata.publishedAt  // publication date at the source\nans.load('2026.08.25')    // pinned\nans.latest()              // follows\n```\n\n## Integrity guarantee\n\nThe pipeline refuses to publish if any CNPJ fails its check digits: that\nindicates a shifted column during parsing, not an invalid company. An\nunrecognised `modalidade` produces a warning rather than an error, because ANS\ndoes create new ones and that must not block a publication.\n\n## Environment\n\nNode 20+ through the default entry, which reads its data from disk, including\nNext.js server components, route handlers and Remix loaders.\n\nFor a client bundle use `@br-health-kit/ans/web`. See\n[`docs/browser.md`](../../docs/browser.md).\n\n## Provenance\n\nANS open data (PDA), redistributed without content modification. Code under\nMIT.\n","readmeFilename":"README.md","_rev":"1-fe262f0830b32812c89cbb7f851b58c9"}