CID-10

Valida um código CID-10 contra as tabelas que o DATASUS publica, a edição brasileira da CID-10 (Classificação Estatística Internacional de Doenças e Problemas Relacionados à Saúde, 10ª revisão), o código que atestados médicos e sistemas de saúde carregam.

• Os dois níveis da classificação são válidos: as categorias de 3 caracteres (A00) e as subcategorias de 4 caracteres, escritas com o ponto (A00.0) ou sem ele (A000).
• Maiúsculas, minúsculas e espaços em volta são ignorados. Qualquer outra coisa (outro separador, um quinto caractere, um sufixo de cruz ou asterisco, um valor que não é string) é rejeitada.
• As tabelas são as V2008 do DATASUS, mais a categoria U07 da tabela da CID-10 que o DATASUS mantém para o SIM (U07, U07.0, U07.1 COVID-19 com vírus identificado e U07.2 vírus não identificado), que as V2008 não têm. Um código que não está em nenhuma delas não é encontrado, como U09.9 (condição pós-COVID-19) e U10.9 (síndrome inflamatória multissistêmica associada à COVID-19). Até a 2.4.0 os códigos U07 também não eram encontrados.
• Só uma tabela de códigos é lida (cerca de 7 KB minificada), não as descrições que getCid10 carrega.

import { isValidCid10 } from '@brazilian-utils/brazilian-utils';

isValidCid10('A00.0'); // true
isValidCid10('a000'); // true
isValidCid10('A00'); // true (uma categoria)
isValidCid10('I10'); // true (uma categoria que não é subdividida)
isValidCid10('A00.5'); // false (A00 não tem a subcategoria 5)
isValidCid10('I10.0'); // false (I10 não tem subcategorias)
isValidCid10('A00-0'); // false (não é uma forma documentada)

Formata um código CID-10 do jeito que ele é impresso: em maiúsculas, com um ponto entre a categoria de 3 caracteres e o quarto caractere da subcategoria. Só a estrutura muda; use isValidCid10 para conferir um código com as tabelas.

• A máscara é aplicada até onde o valor vai, então uma categoria fica como está e o ponto só aparece com o quarto caractere.
• Caracteres fora da máscara são descartados e o valor é limitado a 4 caracteres.

import { formatCid10 } from '@brazilian-utils/brazilian-utils';

formatCid10('A000'); // A00.0
formatCid10('f322'); // F32.2
formatCid10('A00'); // A00 (uma categoria não tem ponto)
formatCid10('A00.0'); // A00.0

Remove a formatação de um código CID-10, mantém apenas letras e dígitos, em maiúsculas, e limita o resultado aos 4 caracteres de uma subcategoria, a forma que as tabelas do DATASUS guardam.

• Um valor mais curto passa até onde ele vai.

import { parseCid10 } from '@brazilian-utils/brazilian-utils';

parseCid10('A00.0'); // 'A000'
parseCid10('f32.2'); // 'F322'
parseCid10('A00'); // 'A00'

Busca um código CID-10 e retorna a sua descrição oficial em português. O resultado é um registro Cid10: { code, description }.

• Mesmas regras de entrada de isValidCid10. O code vem em maiúsculas e sem o ponto. Retorna null quando o código é desconhecido ou o valor não está em uma forma documentada.
• Mesma tabela de isValidCid10: a V2008 do DATASUS mais os códigos U07 da tabela do SIM (getCid10('U07.1') é { code: 'U071', description: 'Infecção pelo novo Coronavírus (COVID-19)' }); U09.9 e U10.9 não são encontrados.
• Este é o utilitário mais pesado do pacote: ele embute as 2046 categorias e 12191 subcategorias com suas descrições, cerca de 722 KB minificado (113 KB com gzip). Carregue-o sob demanda pelo seu subpath, como mostrado em Tamanho do bundle, e use isValidCid10 quando a descrição não for necessária.

import { getCid10 } from '@brazilian-utils/brazilian-utils';

getCid10('A00.0'); // { code: 'A000', description: 'Cólera devida a Vibrio cholerae 01, biótipo cholerae' }
getCid10('a000'); // { code: 'A000', description: 'Cólera devida a Vibrio cholerae 01, biótipo cholerae' }
getCid10('A00'); // { code: 'A00', description: 'Cólera' }
getCid10('A00.5'); // null
getCid10('A00-0'); // null (não é uma forma documentada)

Fonte: tabelas da CID-10 V2008 que o DATASUS publica em CSV e a tabela da CID-10 do SIM para os códigos U07.