@ango-tools/validator

Biblioteca de validação de documentos e dados financeiros de Angola.

Instalação

npm install @ango-tools/validator

Uso

Número de Bilhete de Identidade (BI)

import { validateBI } from "@ango-tools/validator/validate";

validateBI("123456789AB123");
// { isValid: true, code: "VALID_NUM_BI" }

validateBI("123456789AB12");
// { isValid: false, code: "INVALID_NUM_BI" }

IBAN

import { validateIban } from "@ango-tools/validator/validate";

validateIban("AO32004000001234567891057");
// {
//   isValid: true,
//   code: "VALID_IBAN",
//   details: {
//     code: "0040",
//     swift: "BAIPAOLU",
//     name: "BAI",
//     fullname: "Banco Angolano de Investimento"
//   }
// }

Códigos bancários

import { CODE_LIST } from "@ango-tools/validator";

CODE_LIST.AO.agency["0040"];
// { code: "0040", swift: "BAIPAOLU", sname: "BAI", fname: "Banco Angolano de Investimento" }

API

| Importação | Função | Retorno | | --- | --- | --- | | @ango-tools/validator/validate | validateBI(value: string) | TypeValidationResponse | | @ango-tools/validator/validate | validateIban(iban: string) | TypeValidationResponse & { details?: IbanInfo } \| null |

Desenvolvimento

npm run build       # compila com tsup (ESM + CJS + tipos)
npm test            # roda os testes (vitest)
npm run typecheck   # verificação de tipos

Licença

MIT