Laboratório de contratos
Resulta
Como manter uma API total e erros explícitos sem perder ergonomia entre ESM e CJS?
- Status
- implementado
- Commit-fonte
- main
- Licença
- Consultar repositório
Contexto
Uma biblioteca pequena para investigar resultados tipados, interoperabilidade de módulos e garantias
documentadas. O interesse não é o tipo Result em si, e sim manter a mesma promessa nos dois
formatos de módulo.
Forças e restrições
- Nenhum caminho deve retornar um estado implícito.
- ESM e CJS precisam oferecer o mesmo contrato.
Decisões
- 01
API total
Cada operação representa sucesso e erro no tipo de retorno.
- 02
Distribuição dupla
Os formatos de módulo compartilham garantias documentadas.
Evidências
Pacote público
API, builds ESM/CJS e documentação versionada.
Limites conhecidos
- A biblioteca explicita erros; não decide políticas de recuperação da aplicação.
- Adoção e uso em produção não são alegados.
Mapa arquitetural
- Entrada — fronteira. Operação total.
- Result — decisão. Sucesso ou erro explícito.
- ESM / CJS — evidência. Saídas com a mesma garantia.