{"_id":"@aria-cli/gateway-whatsapp","name":"@aria-cli/gateway-whatsapp","dist-tags":{"latest":"1.0.80"},"versions":{"1.0.80":{"name":"@aria-cli/gateway-whatsapp","version":"1.0.80","description":"Optional WhatsApp adapter for ARIA — pairs a Baileys bridge subprocess with the @aria-cli/gateway ChannelAdapter contract. Pulls Meta's unofficial Web protocol into isolated opt-in territory.","type":"module","main":"dist/index.js","types":"dist/index.d.ts","exports":{".":{"bun":"./src/index.ts","types":"./dist/index.d.ts","import":"./dist/index.js"}},"bin":{"aria-whatsapp-bridge":"bin/bridge.mjs"},"scripts":{"test":"vitest run --config vitest.config.ts"},"peerDependencies":{"@whiskeysockets/baileys":"^6.7.0","qrcode-terminal":"^0.12.0"},"peerDependenciesMeta":{"@whiskeysockets/baileys":{"optional":true},"qrcode-terminal":{"optional":true}},"keywords":["aria","whatsapp","gateway","baileys","ai-agent","messaging"],"homepage":"https://ariacli.com","repository":{"type":"git","url":"git+https://github.com/aria-cli/aria.git","directory":"packages/gateway-whatsapp"},"bugs":{"url":"https://github.com/aria-cli/aria/issues"},"author":{"name":"The ARIA Team"},"license":"SEE LICENSE IN LICENSE","engines":{"bun":">=1.3.11"},"publishConfig":{"access":"public"},"gitHead":"90558202fa183ebada1cb5160c76df2ec2a2aa2f","_id":"@aria-cli/gateway-whatsapp@1.0.80","_nodeVersion":"25.8.1","_npmVersion":"11.11.0","dist":{"integrity":"sha512-cJEXbr7Bu2Yox/JjXvmW6lBqEgRsQkVcSEfHpq8NpXBYpjh9wKBltkpwxD6UmCBA3e/CTsTeLip+IIXbDFaW+A==","shasum":"7e745d71b979b0c8953137a899eec7190eb201c6","tarball":"https://registry.npmjs.org/@aria-cli/gateway-whatsapp/-/gateway-whatsapp-1.0.80.tgz","fileCount":15,"unpackedSize":50502,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDKGFnkW10zGfhd/LDfxnyQB4EfHzgpk2R8yU4syVZ60wIgb+anJlJAhwQ3y//70vhv021qtKJm0p9mIXKaZUvu3Y8="}]},"_npmUser":{"name":"hoang17","email":"hoang@yah.vn"},"directories":{},"maintainers":[{"name":"hoang17","email":"hoang@yah.vn"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/gateway-whatsapp_1.0.80_1778720829360_0.6662779129260263"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-14T01:07:09.300Z","1.0.80":"2026-05-14T01:07:09.507Z","modified":"2026-05-14T01:07:09.693Z"},"maintainers":[{"name":"hoang17","email":"hoang@yah.vn"}],"description":"Optional WhatsApp adapter for ARIA — pairs a Baileys bridge subprocess with the @aria-cli/gateway ChannelAdapter contract. Pulls Meta's unofficial Web protocol into isolated opt-in territory.","homepage":"https://ariacli.com","keywords":["aria","whatsapp","gateway","baileys","ai-agent","messaging"],"repository":{"type":"git","url":"git+https://github.com/aria-cli/aria.git","directory":"packages/gateway-whatsapp"},"author":{"name":"The ARIA Team"},"bugs":{"url":"https://github.com/aria-cli/aria/issues"},"license":"SEE LICENSE IN LICENSE","readme":"# @aria-cli/gateway-whatsapp\n\nOptional WhatsApp adapter for ARIA. Pairs a **Baileys-backed subprocess\nbridge** with the `@aria-cli/gateway` `ChannelAdapter` contract, so the\nunofficial WhatsApp Web protocol never enters the core ARIA binary.\n\n## Why a bridge subprocess\n\n- ✅ **Core binary stays lean** — Baileys pulls ~35 MB of deps\n- ✅ **Legal/ToS risk stays opt-in** — users install this package knowingly\n- ✅ **Swappable backend** — same NDJSON protocol can front Baileys today,\n  `whatsapp-web.js` or Meta Cloud API later, without touching consumers\n- ✅ **Crash isolation** — bridge can OOM without taking ARIA down\n\n## Install\n\n```sh\n# Runtime deps (user installs — we don't ship them)\nnpm install -g @whiskeysockets/baileys qrcode-terminal\n# Then the adapter\nnpm install -g @aria-cli/gateway-whatsapp\n```\n\n## Use from ARIA\n\n```sh\naria gateway channels enable whatsapp\naria gateway start\n# A QR code renders in the terminal on first pair.\n```\n\n## Session storage\n\nBy default, pairing state lives under\n`~/.aria/gateway/whatsapp/default/`. Pass `--session <dir>` to\n`aria-whatsapp-bridge` to use a different location.\n\n## Protocol (stable)\n\nLine-delimited JSON over the bridge's stdio. Events (bridge → adapter):\n\n| `kind` | payload |\n|---|---|\n| `hello` | `{ protocolVersion, bridgeVersion }` |\n| `qr` | `{ qrAscii, qrDataUrl? }` |\n| `ready` | `{ jid, phoneNumber? }` |\n| `disconnected` | `{ reason, reconnectSeconds? }` |\n| `error` | `{ message }` |\n| `message` | `{ chatId, senderId, senderName?, isGroup, mentioned, text, timestamp, messageId }` |\n| `ack` | `{ correlationId, ok, error? }` |\n\nCommands (adapter → bridge): `send`, `logout`, `ping` (all carry\n`correlationId` for ack-matching).\n\n## Legal notice\n\nThe bridge uses Baileys, which implements WhatsApp's private Web\nprotocol. WhatsApp's ToS prohibits unofficial clients in certain\ncommercial contexts. This package is provided for personal,\nexperimental, and self-hosted use. For production commercial use,\nprefer the Meta Cloud API adapter (roadmap).\n\n## License\n\nProprietary. See the root [LICENSE](../../LICENSE) for terms.\nFor licensing inquiries: **hello@ariaai.dev**.\n","readmeFilename":"README.md","_rev":"1-233ece619db81ad98bde631d82e775f7"}