Containers

Bun (experimental)

Bun é um runtime local opcional para executar TypeScript diretamente (bun run ..., bun --watch ...). O gerenciador de pacotes padrão continua sendo pnpm, que é totalmente compatível e usado pelas ferramentas de documentação. Bun não consegue usar pnpm-lock.yaml e irá ignorá-lo.

Instalação

  • Instalar dependências

    bun install
    

    bun.lock / bun.lockb são ignorados pelo git, portanto não há alterações desnecessárias no repositório. Para pular completamente a escrita de lockfile:

    bun install --no-save
    
  • Compilar e testar

    bun run build
    bun run vitest run
    
  • Scripts de ciclo de vida

    Bun bloqueia scripts de ciclo de vida de dependências, a menos que sejam explicitamente confiáveis. Para este repositório, os scripts comumente bloqueados não são necessários:

    • @whiskeysockets/baileys preinstall -- verifica Node major >= 20 (OpenClaw usa Node 24 por padrão e ainda oferece suporte a Node 22 LTS, atualmente 22.16+)
    • protobufjs postinstall -- emite avisos sobre esquemas de versão incompatíveis (sem artefatos de build)

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

    bun pm trust @whiskeysockets/baileys protobufjs
    

    Ressalvas

    Alguns scripts ainda fixam pnpm no código (por exemplo, docs:build, ui:*, protocol:check). Execute-os via pnpm por enquanto.

    Relacionados