Gabriel AlmirENAPI total
Cada operação representa sucesso e erro no tipo de retorno.
lab / implemented
Resulta
Como manter uma API total e erros explícitos sem perder ergonomia entre ESM e CJS?
01 / Contexto
Uma biblioteca pequena para investigar resultados tipados, interoperabilidade de módulos e garantias documentadas.
- Nenhum caminho deve retornar um estado implícito.
- ESM e CJS precisam oferecer o mesmo contrato.
02 / Mapa arquitetural
Mapa arquitetural
- 01Entrada
Operação total.
- 02Result
Sucesso ou erro explícito.
- 03ESM / CJS
Saídas com a mesma garantia.
03 / Decisões
Decisões
Distribuição dupla
Os formatos de módulo compartilham garantias documentadas.
Evidências
- Pacote públicoAPI, 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.