botozap-js

Monorepo das ferramentas públicas do BotoZap — a plataforma dev-first multi-tenant sobre a WhatsApp Cloud API oficial. O core da plataforma é fechado; o que vive aqui é a camada que ajuda quem integra.

Status: preview público 0.x. Os pacotes estão publicados no npm. A API REST continua sendo a interface oficial e estável — tudo aqui é um envelope fino sobre ela. Tudo é 0.x, sem promessa de estabilidade de API até a 1.0; se algo faltar ou quebrar nos pacotes, o fallback é sempre a API REST direto.

Node suportado: >=20.19, validado em CI nos majors 20.19, 22 e 24 (typecheck, testes, build, imports ESM/CJS, smokes de CLI/MCP e instalação dos tarballs reais num projeto limpo). A matriz contratual completa também está verde contra os handlers reais no repositório privado do core.

Bugs: issues deste repositório — nunca inclua sua chave de API no relato.

Pacotes

O SDK é a única implementação do cliente HTTP: CLI e MCP consomem @botozap/sdk (workspace) — autenticação, envelopes, paginação, erros e tipos vivem num lugar só.

Related MCP server: leporis-mcp

Exemplos

Em examples/: envio sandbox em JavaScript e TypeScript, receptor de webhook (HMAC + idempotência transacional), configuração do MCP com chave sandbox e o agent-endpoint, com fila PostgreSQL e worker orientado a Eventos que responde sem polling.

Desenvolvimento

Requer Node ≥ 20.19 e pnpm (exclusivamente — nunca npm/yarn/bun).

pnpm install
pnpm typecheck
pnpm test
pnpm build
pnpm gate:tarballs

gate:tarballs empacota SDK, CLI e MCP, instala os três em um projeto temporário limpo e prova imports ESM/CJS, tipos, bins e um cliente MCP tools-only real. O diretório temporário é removido ao final e nenhuma credencial live é usada.

Versionamento com Changesets — tudo 0.x, sem promessa de estabilidade prematura. A publicação continua sendo uma ação manual posterior aos gates; o CI nunca recebe token npm.

Licença

MIT