README

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

Pacote	O que é
`@botozap/sdk`	SDK Node.js — cliente tipado da API `/api/v1`, sem dependências de runtime
`@botozap/cli`	CLI `botozap` — a API no terminal e em scripts
`@botozap/mcp`	Servidor MCP — as operações da API como ferramentas para agentes (Claude Code, Cursor, Codex)

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ó.

Exemplos

Em examples/: envio sandbox em JavaScript e TypeScript, receptor de webhook (HMAC + idempotência transacional) e configuração do MCP com chave sandbox.

Desenvolvimento

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

pnpm install
pnpm typecheck
pnpm test
pnpm build

Versionamento com Changesets — tudo 0.x, sem promessa de estabilidade prematura.

Licença

MIT

@botozap/mcp