Escrita e histórico
Gravação viva e publicação atômica
O arquivo .jsw só anexa: um processo pode ler enquanto outro grava, sem ver bloco pela metade. Nos SDKs, o arquivo só aparece inteiro no fechar().
· jsonW 1.3.11
O problema
Quem lê um arquivo enquanto outro programa grava pode pegar uma linha cortada. E um programa que cai no meio da gravação pode deixar um arquivo pela metade no lugar do bom.
Como o jsonW resolve
Cada bloco do .jsw se sustenta sozinho, com marcador, CRC32C e hash. Por isso o formato permite ler em fluxo enquanto outro processo grava, como um tail -f que nunca vê um bloco pela metade. Na escrita pelos SDKs, o arquivo só é publicado no fechar(); quem sai por erro chama abandonar(), e o destino fica como estava.
const { Escritor } = require("@wortictecnologia/jsonw");
const e = new Escritor("eventos.jsw", "id:i64,tipo:dic,quando:tempo");
e.gravar({ id: 1, tipo: "entrada", quando: "2026-11-13T09:00:00Z" });
e.fechar();
Gravação pelo SDK de Node (npm @wortictecnologia/jsonw). O arquivo eventos.jsw só passa a existir, inteiro, no fechar().
Onde está
A publicação atômica está nos 10 SDKs. A leitura durante a gravação existe no núcleo, mas, na versão 1.3.11, não tem comando no wjsw nem função na ABI pública.