Bun (experimental)¶

Objetivo: executar este repositório com Bun (opcional, não recomendado para WhatsApp/Telegram) sem divergir dos fluxos de trabalho com pnpm.

⚠️ Não recomendado para runtime do Gateway (bugs no WhatsApp/Telegram). Use Node em produção.

Status¶

• Bun é um runtime local opcional para executar TypeScript diretamente (bun run …, bun --watch …).
• pnpm é o padrão para builds e continua totalmente suportado (e usado por algumas ferramentas de docs).
• Bun não pode usar pnpm-lock.yaml e irá ignorá-lo.

Instalar¶

Padrão:

bun install

Nota: bun.lock/bun.lockb são ignorados pelo git, então não há churn no repositório de nenhuma forma. Se você quiser nenhuma escrita de lockfile:

bun install --no-save

Compilar / Teste (Bun)¶

bun run build
bun run vitest run

Scripts de ciclo de vida do Bun (bloqueados por padrão)¶

O Bun pode bloquear scripts de ciclo de vida de dependências, a menos que sejam explicitamente confiáveis (bun pm untrusted / bun pm trust). Para este repositório, os scripts comumente bloqueados não são necessários:

• @whiskeysockets/baileys preinstall: verifica Node major >= 20 (executamos Node 22+).
• protobufjs postinstall: emite avisos sobre esquemas de versão incompatíveis (sem artefatos de build).

Se você encontrar um problema real em runtime que exija esses scripts, confie neles explicitamente:

bun pm trust @whiskeysockets/baileys protobufjs

Ressalvas¶

• Alguns scripts ainda codificam pnpm (por exemplo, docs:build, ui:*, protocol:check). Execute esses via pnpm por enquanto.