{
  "title": "Bun (experimental)",
  "content": "Goal: run this repo with **Bun** (optional, not recommended for WhatsApp/Telegram)\nwithout diverging from pnpm workflows.\n\n⚠️ **Not recommended for Gateway runtime** (WhatsApp/Telegram bugs). Use Node for production.\n\n* Bun is an optional local runtime for running TypeScript directly (`bun run …`, `bun --watch …`).\n* `pnpm` is the default for builds and remains fully supported (and used by some docs tooling).\n* Bun cannot use `pnpm-lock.yaml` and will ignore it.\n\nNote: `bun.lock`/`bun.lockb` are gitignored, so there’s no repo churn either way. If you want *no lockfile writes*:\n\n## Build / Test (Bun)\n\n## Bun lifecycle scripts (blocked by default)\n\nBun may block dependency lifecycle scripts unless explicitly trusted (`bun pm untrusted` / `bun pm trust`).\nFor this repo, the commonly blocked scripts are not required:\n\n* `@whiskeysockets/baileys` `preinstall`: checks Node major >= 20 (we run Node 22+).\n* `protobufjs` `postinstall`: emits warnings about incompatible version schemes (no build artifacts).\n\nIf you hit a real runtime issue that requires these scripts, trust them explicitly:\n\n* Some scripts still hardcode pnpm (e.g. `docs:build`, `ui:*`, `protocol:check`). Run those via pnpm for now.",
  "code_samples": [
    {
      "code": "Note: `bun.lock`/`bun.lockb` are gitignored, so there’s no repo churn either way. If you want *no lockfile writes*:",
      "language": "unknown"
    },
    {
      "code": "## Build / Test (Bun)",
      "language": "unknown"
    },
    {
      "code": "## Bun lifecycle scripts (blocked by default)\n\nBun may block dependency lifecycle scripts unless explicitly trusted (`bun pm untrusted` / `bun pm trust`).\nFor this repo, the commonly blocked scripts are not required:\n\n* `@whiskeysockets/baileys` `preinstall`: checks Node major >= 20 (we run Node 22+).\n* `protobufjs` `postinstall`: emits warnings about incompatible version schemes (no build artifacts).\n\nIf you hit a real runtime issue that requires these scripts, trust them explicitly:",
      "language": "unknown"
    }
  ],
  "headings": [
    {
      "level": "h2",
      "text": "Status",
      "id": "status"
    },
    {
      "level": "h2",
      "text": "Install",
      "id": "install"
    },
    {
      "level": "h2",
      "text": "Build / Test (Bun)",
      "id": "build-/-test-(bun)"
    },
    {
      "level": "h2",
      "text": "Bun lifecycle scripts (blocked by default)",
      "id": "bun-lifecycle-scripts-(blocked-by-default)"
    },
    {
      "level": "h2",
      "text": "Caveats",
      "id": "caveats"
    }
  ],
  "url": "llms-txt#bun-(experimental)",
  "links": []
}