Versões e segurança
jsonW 1.4.0: cifra em repouso, máscaras de documentos e perfis dos protocolos de agentes
O arquivo .jsw pode ficar cifrado no disco, com a chave fora dele. CPF e CNPJ entram com máscara que recusa o valor inválido. E 49 objetos dos protocolos de agentes têm perfil provado com ida e volta.
· jsonW 1.4.0
O que a 1.4.0 traz
Três coisas. A cifra em repouso, para o arquivo que fica no disco. As máscaras de documentos de vários países, que recusam o valor inválido na gravação. E os perfis jsonW dos protocolos de agentes, com cada objeto amostrado e conferido. Quem não usa nenhuma delas não percebe diferença: um arquivo sem cifra e sem tipo novo sai byte a byte igual ao da 1.3.14.
Cifra em repouso
O arquivo .jsw pode ficar cifrado no disco (XChaCha20-Poly1305). A chave do tenant fica fora do arquivo: um arquivo com 64 caracteres hexadecimais, apontado por WJSW_CHAVE_ARQ ou pela opção --chave. Sem a chave, o arquivo cifrado não abre.
$ wjsw cifrar cifrado.jsw --chave chave.hex
$ wjsw conferir cifrado.jsw
FALHOU: arquivo cifrado: falta a chave do tenant (WJSW_CHAVE_ARQ ou credencial wjsw-chave)
$ wjsw para-texto cifrado.jsw --chave chave.hex
{id:1,cpf:"12345678909",cnpj:"11222333000181"}
{id:2,cpf:"12345678909",cnpj:"11222333000181"}
Saída real do wjsw 1.4.1. O cifrar não imprime nada. Sem a chave, o conferir sai com código 1.
Máscaras de documentos
Na coluna mascara(tipo), o jsonW aceita o documento com ou sem pontuação, grava a forma canônica e recusa o que não é válido. O arquivo de entrada clientes.jsw.txt traz o CPF e o CNPJ com pontuação; a gravação guarda só os dígitos.
$ wjsw de-texto "id:i64,cpf:mascara(cpf),cnpj:mascara(cnpj)" clientes.jsw.txt docs.jsw
2 linhas -> docs.jsw
$ wjsw para-texto docs.jsw
{id:1,cpf:"12345678909",cnpj:"11222333000181"}
{id:2,cpf:"12345678909",cnpj:"11222333000181"}
$ wjsw de-texto "id:i64,cpf:mascara(cpf),cnpj:mascara(cnpj)" invalido.jsw.txt inv.jsw
valor 1 nao coube no esquema
O último comando sai com código 1: o CPF 111.111.111-11 não é válido.
Entre os tipos estão CPF, CNPJ, CEP, telefone, PIS, RENAVAM, IBAN, NIF de Portugal, SIREN e SIRET da França, EIN e SSN dos Estados Unidos, CURP e RFC do México, RUT do Chile e partita IVA da Itália. A lista está em mascara/wmascara.h.
Perfis dos protocolos de agentes
A pasta perfis/ tem um arquivo por protocolo, com o esquema jsonW de cada objeto: A2A, UCP, ACP, AP2, Verifiable Intent, x402, MPP, AG-UI e OpenTelemetry, além de L402 e PIX. Cada objeto tem amostra gravada e custódia conferida, e volta igual ao que entrou.
$ bash perfis/provar-perfis.sh bin/macos-arm64/wjsw | tail -1
perfis: 49 ok, 0 falhas
Compatibilidade
Medido com o mesmo esquema nas duas versões. O arquivo sem cifra gravado pela 1.4.1 saiu igual, byte a byte, ao gravado pela 1.3.14. A 1.3.14 não abre o arquivo cifrado: recusa com versao do jsonW desconhecida, em vez de ler o texto cifrado como se fosse dado.
$ wjsw para-texto cifrado.jsw # com o binário 1.3.14
versao do jsonW desconhecida
Onde está
Na ferramenta wjsw, na biblioteca e nos SDKs. No npm, npm install @wortictecnologia/[email protected]. A 1.4.1, que corrige a visão por permissão, vem logo depois: veja o post da 1.4.1.