dummy-api

Kit dummy para exercitar o fluxo de criação e publicação de kits no cullet. Não é uma curadoria de API real; serve como sandbox de validação para o catálogo.

Para o sumário prompt-friendly veja KIT_CONTEXT.md. Para os contratos comuns a todos os kits veja a PHILOSOPHY.md.

O que entrega

• Esqueleto de pastas core/domain/, core/exceptions/, core/errors/, core/result/, core/application/ — ainda sem primitives implementadas.
• meta.json, KIT_CONTEXT.md e index.ts válidos contra kit-spec.schema.json.
• Serve como referência ao rodar npm run new-kit e como teste de regressão para o validate-kits.

Como começa

import {} from /* nada exportado ainda */ "@cullet/dummy-api";

Para inspecionar a estrutura sem instalar:

npx cullet fc [email protected] --dry-run

Decisões tomadas

• Modelo de erro mixed: estabelecido por contrato do catálogo — mesmo em um kit dummy, a estrutura segue a filosofia (domínio lança, aplicação retorna Result, infra traduz).
• Sem dependência runtime externa: externalDeps: []. Qualquer dep nova exige justificativa no KIT_CONTEXT.md.
• Sem portas implementadas: a expectativa é evoluir o kit antes de qualquer consumidor real usá-lo.

Como evoluir

• Substituir a descrição genérica em meta.json e KIT_CONTEXT.md antes da primeira release real.
• Preencher core/domain/, core/application/, core/errors/, core/exceptions/ à medida que o problema-alvo se definir.
• Mudança incompatível: abrir versions/2.0.0/. Regras em kits/VERSIONING.md.
• Antes de qualquer publicação: npm run validate-kits.