@openclaw/whatsapp 2026.5.2 → 2026.5.3-beta.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (302) hide show
  1. package/dist/access-control-BQ3tCkH8.js +288 -0
  2. package/dist/account-config-CNQ33oav.js +47 -0
  3. package/dist/account-ids-DG18xddX.js +5 -0
  4. package/dist/accounts-BDqgpFEB.js +116 -0
  5. package/dist/action-runtime-DTGNgG-i.js +74 -0
  6. package/dist/action-runtime-api.js +2 -0
  7. package/dist/action-runtime.runtime.js +2 -0
  8. package/dist/active-listener-N7GFKsuN.js +11 -0
  9. package/dist/agent-tools-login-DpRxLNRB.js +89 -0
  10. package/dist/api.js +148 -0
  11. package/dist/audio-preflight.runtime-Bcdsl_ri.js +7 -0
  12. package/dist/auth-presence.js +32 -0
  13. package/dist/auth-store-BjCb50Ry.js +381 -0
  14. package/dist/channel-DQ-5Xoj9.js +542 -0
  15. package/dist/channel-config-api.js +2 -0
  16. package/dist/channel-plugin-api.js +2 -0
  17. package/dist/channel-react-action-Df20qAy9.js +42 -0
  18. package/dist/channel.runtime-DKXRnA8x.js +55 -0
  19. package/dist/channel.setup-DOHR2BGp.js +20 -0
  20. package/dist/command-policy-O8sRnqUV.js +8 -0
  21. package/dist/config-schema-Dmo66Ubb.js +27 -0
  22. package/dist/connection-controller-BiHAsTM8.js +596 -0
  23. package/dist/connection-controller-registry-D_iIGz5m.js +22 -0
  24. package/dist/constants-DLGCIbfl.js +4 -0
  25. package/dist/constants.js +2 -0
  26. package/dist/contract-api.js +19 -0
  27. package/dist/creds-files-_2V8jzQa.js +19 -0
  28. package/dist/directory-config-DVs4ffXu.js +37 -0
  29. package/dist/directory-contract-api.js +2 -0
  30. package/dist/doctor-A9tXm9Om.js +48 -0
  31. package/dist/doctor-contract-api.js +10 -0
  32. package/dist/group-session-contract-B8QBn0I2.js +15 -0
  33. package/dist/identity-QHAlV7Fu.js +75 -0
  34. package/dist/index.js +18 -0
  35. package/dist/legacy-session-surface-api.js +8 -0
  36. package/dist/legacy-state-migrations-api.js +2 -0
  37. package/dist/light-runtime-api.js +5 -0
  38. package/dist/login-DymdrKca.js +52 -0
  39. package/dist/login-qr-DIS0Iv-7.js +378 -0
  40. package/dist/login-qr-api.js +2 -0
  41. package/dist/login-qr-runtime.js +16 -0
  42. package/dist/monitor-C4Fhg_lD.js +3349 -0
  43. package/dist/normalize-CWYiGkXw.js +2 -0
  44. package/dist/normalize-target-BPVHNsM5.js +74 -0
  45. package/dist/outbound-adapter-BssVnZdz.js +29 -0
  46. package/dist/outbound-base-Bq1UYEK5.js +119 -0
  47. package/dist/outbound-media-contract-CGss_QHy.js +163 -0
  48. package/dist/outbound-payload-test-api.js +2 -0
  49. package/dist/quoted-message-TENQzyxV.js +108 -0
  50. package/dist/reaction-level-CRVEVAfi.js +16 -0
  51. package/dist/reply-resolver.runtime-BRCgoO4C.js +2 -0
  52. package/dist/resolve-outbound-target-CN-Wo6IY.js +39 -0
  53. package/dist/rolldown-runtime-RkAeH_Qm.js +27 -0
  54. package/dist/runtime-6fZ67abR.js +8 -0
  55. package/dist/runtime-api.js +15 -0
  56. package/dist/runtime-group-policy-Gp1lQ0at.js +11 -0
  57. package/dist/secret-contract-api.js +5 -0
  58. package/dist/security-contract-DqH8JDX6.js +26 -0
  59. package/dist/security-contract-api.js +2 -0
  60. package/dist/send-CIyLFxdZ.js +234 -0
  61. package/dist/session-contract-B0efQf9P.js +27 -0
  62. package/dist/session-errors-CSuKZPub.js +63 -0
  63. package/dist/session.runtime-C1eSE_KK.js +13 -0
  64. package/dist/setup-core-DZKvpzbH.js +46 -0
  65. package/dist/setup-entry.js +23 -0
  66. package/dist/setup-plugin-api.js +2 -0
  67. package/dist/setup-surface-ieFnIW4g.js +344 -0
  68. package/dist/shared-D_wzSVar.js +307 -0
  69. package/dist/state-migrations-DnCdvoYD.js +39 -0
  70. package/dist/targets.js +2 -0
  71. package/dist/test-api.js +3 -0
  72. package/dist/text-runtime-C1zNiZeO.js +116 -0
  73. package/package.json +14 -6
  74. package/action-runtime-api.ts +0 -1
  75. package/action-runtime.runtime.ts +0 -1
  76. package/api.ts +0 -213
  77. package/auth-presence.ts +0 -80
  78. package/channel-config-api.ts +0 -1
  79. package/channel-plugin-api.ts +0 -3
  80. package/config-api.ts +0 -4
  81. package/constants.ts +0 -1
  82. package/contract-api.ts +0 -29
  83. package/directory-contract-api.ts +0 -4
  84. package/doctor-contract-api.ts +0 -8
  85. package/index.test.ts +0 -13
  86. package/index.ts +0 -16
  87. package/legacy-session-surface-api.ts +0 -6
  88. package/legacy-state-migrations-api.ts +0 -1
  89. package/light-runtime-api.ts +0 -12
  90. package/login-qr-api.ts +0 -1
  91. package/login-qr-runtime.ts +0 -23
  92. package/outbound-payload-test-api.ts +0 -1
  93. package/runtime-api.ts +0 -84
  94. package/secret-contract-api.ts +0 -4
  95. package/security-contract-api.ts +0 -4
  96. package/setup-entry.test.ts +0 -21
  97. package/setup-entry.ts +0 -21
  98. package/setup-plugin-api.ts +0 -3
  99. package/src/account-config.ts +0 -77
  100. package/src/account-ids.ts +0 -13
  101. package/src/account-types.ts +0 -5
  102. package/src/accounts.test.ts +0 -182
  103. package/src/accounts.ts +0 -176
  104. package/src/accounts.whatsapp-auth.test.ts +0 -59
  105. package/src/action-runtime-target-auth.ts +0 -27
  106. package/src/action-runtime.test.ts +0 -330
  107. package/src/action-runtime.ts +0 -76
  108. package/src/active-listener.test.ts +0 -65
  109. package/src/active-listener.ts +0 -17
  110. package/src/agent-tools-login.test.ts +0 -81
  111. package/src/agent-tools-login.ts +0 -113
  112. package/src/approval-auth.test.ts +0 -24
  113. package/src/approval-auth.ts +0 -27
  114. package/src/auth-store.runtime.ts +0 -1
  115. package/src/auth-store.test.ts +0 -311
  116. package/src/auth-store.ts +0 -502
  117. package/src/auto-reply/config.runtime.ts +0 -16
  118. package/src/auto-reply/constants.ts +0 -1
  119. package/src/auto-reply/deliver-reply.test.ts +0 -843
  120. package/src/auto-reply/deliver-reply.ts +0 -279
  121. package/src/auto-reply/loggers.ts +0 -6
  122. package/src/auto-reply/mentions.ts +0 -131
  123. package/src/auto-reply/monitor/ack-reaction.test.ts +0 -170
  124. package/src/auto-reply/monitor/ack-reaction.ts +0 -99
  125. package/src/auto-reply/monitor/audio-preflight.runtime.ts +0 -9
  126. package/src/auto-reply/monitor/broadcast.ts +0 -153
  127. package/src/auto-reply/monitor/commands.ts +0 -19
  128. package/src/auto-reply/monitor/echo.ts +0 -64
  129. package/src/auto-reply/monitor/group-activation.runtime.ts +0 -1
  130. package/src/auto-reply/monitor/group-activation.test.ts +0 -189
  131. package/src/auto-reply/monitor/group-activation.ts +0 -73
  132. package/src/auto-reply/monitor/group-gating.audio-preflight.test.ts +0 -103
  133. package/src/auto-reply/monitor/group-gating.runtime.ts +0 -8
  134. package/src/auto-reply/monitor/group-gating.ts +0 -217
  135. package/src/auto-reply/monitor/group-members.test.ts +0 -56
  136. package/src/auto-reply/monitor/group-members.ts +0 -65
  137. package/src/auto-reply/monitor/inbound-context.test.ts +0 -97
  138. package/src/auto-reply/monitor/inbound-context.ts +0 -92
  139. package/src/auto-reply/monitor/inbound-dispatch.runtime.ts +0 -21
  140. package/src/auto-reply/monitor/inbound-dispatch.test.ts +0 -895
  141. package/src/auto-reply/monitor/inbound-dispatch.ts +0 -422
  142. package/src/auto-reply/monitor/last-route.test.ts +0 -37
  143. package/src/auto-reply/monitor/last-route.ts +0 -61
  144. package/src/auto-reply/monitor/message-line.runtime.ts +0 -38
  145. package/src/auto-reply/monitor/message-line.ts +0 -54
  146. package/src/auto-reply/monitor/on-message.audio-preflight.test.ts +0 -354
  147. package/src/auto-reply/monitor/on-message.ts +0 -291
  148. package/src/auto-reply/monitor/peer.ts +0 -17
  149. package/src/auto-reply/monitor/process-message.audio-preflight.test.ts +0 -420
  150. package/src/auto-reply/monitor/process-message.test.ts +0 -355
  151. package/src/auto-reply/monitor/process-message.ts +0 -531
  152. package/src/auto-reply/monitor/runtime-api.ts +0 -30
  153. package/src/auto-reply/monitor-state.test.ts +0 -64
  154. package/src/auto-reply/monitor-state.ts +0 -106
  155. package/src/auto-reply/monitor.ts +0 -600
  156. package/src/auto-reply/reply-resolver.runtime.ts +0 -1
  157. package/src/auto-reply/types.ts +0 -48
  158. package/src/auto-reply/util.ts +0 -63
  159. package/src/auto-reply/web-auto-reply-monitor.test.ts +0 -687
  160. package/src/auto-reply/web-auto-reply-utils.test.ts +0 -392
  161. package/src/auto-reply.broadcast-groups.combined.test.ts +0 -246
  162. package/src/auto-reply.broadcast-groups.test-harness.ts +0 -47
  163. package/src/auto-reply.impl.ts +0 -6
  164. package/src/auto-reply.test-harness.ts +0 -421
  165. package/src/auto-reply.ts +0 -1
  166. package/src/auto-reply.web-auto-reply.compresses-common-formats-jpeg-cap.test.ts +0 -427
  167. package/src/auto-reply.web-auto-reply.connection-and-logging.e2e.test.ts +0 -908
  168. package/src/auto-reply.web-auto-reply.last-route.test.ts +0 -184
  169. package/src/channel-actions.runtime.ts +0 -7
  170. package/src/channel-actions.test.ts +0 -216
  171. package/src/channel-actions.ts +0 -84
  172. package/src/channel-outbound.test.ts +0 -131
  173. package/src/channel-outbound.ts +0 -36
  174. package/src/channel-react-action.runtime.ts +0 -7
  175. package/src/channel-react-action.test.ts +0 -294
  176. package/src/channel-react-action.ts +0 -84
  177. package/src/channel.runtime.ts +0 -117
  178. package/src/channel.setup.test.ts +0 -461
  179. package/src/channel.setup.ts +0 -28
  180. package/src/channel.ts +0 -339
  181. package/src/command-policy.ts +0 -7
  182. package/src/config-accessors.test.ts +0 -34
  183. package/src/config-accessors.ts +0 -22
  184. package/src/config-schema.test.ts +0 -121
  185. package/src/config-schema.ts +0 -6
  186. package/src/config-ui-hints.ts +0 -24
  187. package/src/connection-controller-registry.test.ts +0 -27
  188. package/src/connection-controller-registry.ts +0 -49
  189. package/src/connection-controller.test.ts +0 -282
  190. package/src/connection-controller.ts +0 -679
  191. package/src/creds-files.ts +0 -19
  192. package/src/creds-persistence.ts +0 -102
  193. package/src/directory-config.test.ts +0 -60
  194. package/src/directory-config.ts +0 -40
  195. package/src/directory-contract.test.ts +0 -56
  196. package/src/doctor-contract.ts +0 -11
  197. package/src/doctor.test.ts +0 -74
  198. package/src/doctor.ts +0 -56
  199. package/src/group-intro.ts +0 -15
  200. package/src/group-policy.test.ts +0 -36
  201. package/src/group-policy.ts +0 -40
  202. package/src/group-session-contract.ts +0 -20
  203. package/src/group-session-key.test.ts +0 -53
  204. package/src/group-session-key.ts +0 -41
  205. package/src/heartbeat.ts +0 -34
  206. package/src/identity.ts +0 -164
  207. package/src/inbound/access-control.test-harness.ts +0 -37
  208. package/src/inbound/access-control.test.ts +0 -375
  209. package/src/inbound/access-control.ts +0 -237
  210. package/src/inbound/dedupe.ts +0 -132
  211. package/src/inbound/extract.test.ts +0 -282
  212. package/src/inbound/extract.ts +0 -488
  213. package/src/inbound/lifecycle.ts +0 -39
  214. package/src/inbound/media.node.test.ts +0 -83
  215. package/src/inbound/media.ts +0 -102
  216. package/src/inbound/monitor.ts +0 -890
  217. package/src/inbound/runtime-api.ts +0 -7
  218. package/src/inbound/save-media.runtime.ts +0 -1
  219. package/src/inbound/send-api.test.ts +0 -319
  220. package/src/inbound/send-api.ts +0 -145
  221. package/src/inbound/send-result.ts +0 -61
  222. package/src/inbound/types.ts +0 -106
  223. package/src/inbound-context.contract.test.ts +0 -32
  224. package/src/inbound-policy.ts +0 -231
  225. package/src/inbound.media.test.ts +0 -320
  226. package/src/inbound.test.ts +0 -290
  227. package/src/inbound.ts +0 -9
  228. package/src/login-qr.test.ts +0 -483
  229. package/src/login-qr.ts +0 -542
  230. package/src/login.coverage.test.ts +0 -133
  231. package/src/login.test.ts +0 -89
  232. package/src/login.ts +0 -70
  233. package/src/logout.test.ts +0 -162
  234. package/src/media.test.ts +0 -480
  235. package/src/media.ts +0 -10
  236. package/src/monitor-inbox.allows-messages-from-senders-allowfrom-list.test-support.ts +0 -400
  237. package/src/monitor-inbox.append-upsert.test-support.ts +0 -133
  238. package/src/monitor-inbox.behavior.test.ts +0 -5
  239. package/src/monitor-inbox.blocks-messages-from-unauthorized-senders-not-allowfrom.test-support.ts +0 -362
  240. package/src/monitor-inbox.captures-media-path-image-messages.test-support.ts +0 -306
  241. package/src/monitor-inbox.streams-inbound-messages.test-support.ts +0 -729
  242. package/src/monitor-inbox.test-harness.ts +0 -304
  243. package/src/normalize-target.ts +0 -123
  244. package/src/normalize.ts +0 -7
  245. package/src/outbound-adapter.poll.test.ts +0 -62
  246. package/src/outbound-adapter.sendpayload.test.ts +0 -195
  247. package/src/outbound-adapter.ts +0 -36
  248. package/src/outbound-base.test.ts +0 -560
  249. package/src/outbound-base.ts +0 -244
  250. package/src/outbound-media-contract.ts +0 -278
  251. package/src/outbound-media.runtime.ts +0 -36
  252. package/src/outbound-payload.contract.test.ts +0 -61
  253. package/src/outbound-send-deps.ts +0 -1
  254. package/src/outbound-test-support.ts +0 -16
  255. package/src/pairing-security.test-harness.ts +0 -59
  256. package/src/qr-image.ts +0 -1
  257. package/src/qr-terminal.ts +0 -1
  258. package/src/quoted-message.test.ts +0 -83
  259. package/src/quoted-message.ts +0 -184
  260. package/src/reaction-level.test.ts +0 -94
  261. package/src/reaction-level.ts +0 -21
  262. package/src/reconnect.test.ts +0 -51
  263. package/src/reconnect.ts +0 -55
  264. package/src/resolve-outbound-target.test.ts +0 -288
  265. package/src/resolve-outbound-target.ts +0 -58
  266. package/src/resolve-target.test.ts +0 -120
  267. package/src/runtime-api.ts +0 -59
  268. package/src/runtime-group-policy.ts +0 -16
  269. package/src/runtime.ts +0 -9
  270. package/src/security-contract.ts +0 -47
  271. package/src/security-fix.ts +0 -71
  272. package/src/send.test.ts +0 -534
  273. package/src/send.ts +0 -292
  274. package/src/session-contract.test.ts +0 -31
  275. package/src/session-contract.ts +0 -43
  276. package/src/session-errors.ts +0 -125
  277. package/src/session-route.test.ts +0 -41
  278. package/src/session-route.ts +0 -32
  279. package/src/session.runtime.ts +0 -8
  280. package/src/session.test.ts +0 -559
  281. package/src/session.ts +0 -330
  282. package/src/setup-core.ts +0 -52
  283. package/src/setup-finalize.ts +0 -446
  284. package/src/setup-surface.test.ts +0 -367
  285. package/src/setup-surface.ts +0 -69
  286. package/src/setup-test-helpers.ts +0 -216
  287. package/src/shared.ts +0 -291
  288. package/src/socket-timing.test.ts +0 -49
  289. package/src/socket-timing.ts +0 -38
  290. package/src/state-migrations.ts +0 -54
  291. package/src/status-issues.test.ts +0 -137
  292. package/src/status-issues.ts +0 -185
  293. package/src/system-prompt.test.ts +0 -199
  294. package/src/system-prompt.ts +0 -31
  295. package/src/targets-runtime.ts +0 -180
  296. package/src/test-helpers.ts +0 -690
  297. package/src/text-runtime.test.ts +0 -162
  298. package/src/text-runtime.ts +0 -11
  299. package/src/vcard.ts +0 -84
  300. package/targets.ts +0 -5
  301. package/test-api.ts +0 -2
  302. package/tsconfig.json +0 -16
@@ -1,729 +0,0 @@
1
- import fsSync from "node:fs";
2
- import path from "node:path";
3
- import "./monitor-inbox.test-harness.js";
4
- import { beforeEach, describe, expect, it, vi } from "vitest";
5
- import { WhatsAppRetryableInboundError } from "./inbound/dedupe.js";
6
- import { WHATSAPP_GROUP_METADATA_CACHE_MAX_ENTRIES } from "./inbound/monitor.js";
7
- import {
8
- type InboxMonitorOptions,
9
- InboxOnMessage,
10
- buildNotifyMessageUpsert,
11
- getAuthDir,
12
- getSock,
13
- installWebMonitorInboxUnitTestHooks,
14
- startInboxMonitor,
15
- waitForMessageCalls,
16
- } from "./monitor-inbox.test-harness.js";
17
-
18
- const { sleepWithAbortMock } = vi.hoisted(() => ({
19
- sleepWithAbortMock: vi.fn(async (_ms: number, _signal?: AbortSignal) => undefined),
20
- }));
21
-
22
- vi.mock("./reconnect.js", async () => {
23
- const actual = await vi.importActual<typeof import("./reconnect.js")>("./reconnect.js");
24
- return {
25
- ...actual,
26
- sleepWithAbort: (ms: number, signal?: AbortSignal) => sleepWithAbortMock(ms, signal),
27
- };
28
- });
29
-
30
- let nextMessageSequence = 0;
31
-
32
- function nextMessageId(label: string): string {
33
- nextMessageSequence += 1;
34
- return `${label}-${nextMessageSequence}`;
35
- }
36
-
37
- function createSocketRef(): NonNullable<InboxMonitorOptions["socketRef"]> {
38
- return { current: null };
39
- }
40
-
41
- async function primeInboundReplyHandle(params: {
42
- onMessage: ReturnType<typeof vi.fn>;
43
- socketRef: NonNullable<InboxMonitorOptions["socketRef"]>;
44
- upsertId: string;
45
- retryPolicy: NonNullable<InboxMonitorOptions["disconnectRetryPolicy"]>;
46
- useCurrentSock?: boolean;
47
- }) {
48
- const { listener, sock } = await startInboxMonitor(params.onMessage as InboxOnMessage, {
49
- socketRef: params.socketRef,
50
- shouldRetryDisconnect: () => true,
51
- disconnectRetryPolicy: params.retryPolicy,
52
- });
53
- const sourceSock = params.useCurrentSock ? getSock() : sock;
54
- sourceSock.ev.emit(
55
- "messages.upsert",
56
- buildNotifyMessageUpsert({
57
- id: nextMessageId(params.upsertId),
58
- remoteJid: "999@s.whatsapp.net",
59
- text: "ping",
60
- timestamp: 1_700_000_000,
61
- pushName: "Tester",
62
- }),
63
- );
64
- await waitForMessageCalls(params.onMessage, 1);
65
-
66
- const inbound = params.onMessage.mock.calls.at(0)?.at(0) as
67
- | {
68
- reply: (text: string) => Promise<void>;
69
- }
70
- | undefined;
71
- expect(inbound).toBeDefined();
72
-
73
- return { listener, sock, inbound };
74
- }
75
-
76
- describe("web monitor inbox", () => {
77
- installWebMonitorInboxUnitTestHooks();
78
-
79
- beforeEach(() => {
80
- sleepWithAbortMock.mockReset();
81
- sleepWithAbortMock.mockImplementation(async (_ms: number, _signal?: AbortSignal) => undefined);
82
- });
83
-
84
- async function expectQuotedReplyContext(quotedMessage: unknown) {
85
- const onMessage = vi.fn(async (msg) => {
86
- await msg.reply("pong");
87
- });
88
-
89
- const { listener, sock } = await startInboxMonitor(onMessage as InboxOnMessage);
90
- const upsert = {
91
- type: "notify",
92
- messages: [
93
- {
94
- key: {
95
- id: nextMessageId("quoted"),
96
- fromMe: false,
97
- remoteJid: "999@s.whatsapp.net",
98
- },
99
- message: {
100
- extendedTextMessage: {
101
- text: "reply",
102
- contextInfo: {
103
- stanzaId: "q1",
104
- participant: "111@s.whatsapp.net",
105
- quotedMessage,
106
- },
107
- },
108
- },
109
- messageTimestamp: 1_700_000_000,
110
- pushName: "Tester",
111
- },
112
- ],
113
- };
114
-
115
- sock.ev.emit("messages.upsert", upsert);
116
- await waitForMessageCalls(onMessage, 1);
117
-
118
- expect(onMessage).toHaveBeenCalledWith(
119
- expect.objectContaining({
120
- replyToId: "q1",
121
- replyToBody: "original",
122
- replyToSender: "+111",
123
- sender: expect.objectContaining({
124
- e164: "+999",
125
- name: "Tester",
126
- }),
127
- replyTo: expect.objectContaining({
128
- id: "q1",
129
- body: "original",
130
- sender: expect.objectContaining({
131
- jid: "111@s.whatsapp.net",
132
- e164: "+111",
133
- label: "+111",
134
- }),
135
- }),
136
- self: expect.objectContaining({
137
- jid: "123@s.whatsapp.net",
138
- e164: "+123",
139
- }),
140
- }),
141
- );
142
- expect(sock.sendMessage).toHaveBeenCalledWith("999@s.whatsapp.net", {
143
- text: "pong",
144
- });
145
-
146
- await listener.close();
147
- }
148
-
149
- it("streams inbound messages", async () => {
150
- const onMessage = vi.fn(async (msg) => {
151
- await msg.sendComposing();
152
- await msg.reply("pong");
153
- });
154
-
155
- const { listener, sock } = await startInboxMonitor(onMessage as InboxOnMessage);
156
- expect(sock.sendPresenceUpdate).toHaveBeenNthCalledWith(1, "available");
157
- const messageId = nextMessageId("stream");
158
- const upsert = buildNotifyMessageUpsert({
159
- id: messageId,
160
- remoteJid: "999@s.whatsapp.net",
161
- text: "ping",
162
- timestamp: 1_700_000_000,
163
- pushName: "Tester",
164
- });
165
-
166
- sock.ev.emit("messages.upsert", upsert);
167
- await waitForMessageCalls(onMessage, 1);
168
-
169
- expect(onMessage).toHaveBeenCalledWith(
170
- expect.objectContaining({ body: "ping", from: "+999", to: "+123" }),
171
- );
172
- expect(sock.readMessages).toHaveBeenCalledWith([
173
- {
174
- remoteJid: "999@s.whatsapp.net",
175
- id: messageId,
176
- participant: undefined,
177
- fromMe: false,
178
- },
179
- ]);
180
- expect(sock.sendPresenceUpdate).toHaveBeenCalledWith("available");
181
- expect(sock.sendPresenceUpdate).toHaveBeenCalledWith("composing", "999@s.whatsapp.net");
182
- expect(sock.sendMessage).toHaveBeenCalledWith("999@s.whatsapp.net", {
183
- text: "pong",
184
- });
185
-
186
- await listener.close();
187
- });
188
-
189
- it("stays unavailable on connect in self-chat mode", async () => {
190
- const { listener, sock } = await startInboxMonitor(vi.fn(async () => {}) as InboxOnMessage, {
191
- selfChatMode: true,
192
- });
193
-
194
- expect(sock.sendPresenceUpdate).toHaveBeenNthCalledWith(1, "unavailable");
195
-
196
- await listener.close();
197
- });
198
-
199
- it("hydrates participating groups once after connect", async () => {
200
- const { listener, sock } = await startInboxMonitor(vi.fn(async () => {}) as InboxOnMessage);
201
-
202
- expect(sock.groupFetchAllParticipating).toHaveBeenCalledTimes(1);
203
-
204
- await listener.close();
205
- });
206
-
207
- it("continues when group hydration fails on connect", async () => {
208
- const sock = getSock();
209
- sock.groupFetchAllParticipating.mockRejectedValueOnce(new Error("no groups"));
210
-
211
- const { listener } = await startInboxMonitor(vi.fn(async () => {}) as InboxOnMessage);
212
-
213
- expect(sock.groupFetchAllParticipating).toHaveBeenCalledTimes(1);
214
- expect(sock.sendPresenceUpdate).toHaveBeenNthCalledWith(1, "available");
215
-
216
- await listener.close();
217
- });
218
-
219
- it("keeps group inbound alive with cached metadata after reconnect-time metadata fetch failures", async () => {
220
- const groupMetadataCache: NonNullable<InboxMonitorOptions["groupMetadataCache"]> = new Map();
221
- const onMessage = vi.fn(async (_msg: Parameters<InboxOnMessage>[0]) => {
222
- return;
223
- });
224
-
225
- const firstSock = getSock();
226
- firstSock.groupFetchAllParticipating.mockResolvedValueOnce({
227
- "123@g.us": {
228
- id: "123@g.us",
229
- subject: "Recovered Group",
230
- owner: undefined,
231
- participants: [{ id: "444@s.whatsapp.net" }],
232
- },
233
- });
234
- const first = await startInboxMonitor(onMessage as InboxOnMessage, {
235
- groupMetadataCache,
236
- });
237
- await vi.waitFor(() => {
238
- expect(groupMetadataCache.get("123@g.us")?.subject).toBe("Recovered Group");
239
- });
240
- expect(
241
- (groupMetadataCache.get("123@g.us") as Record<string, unknown>)?.participants,
242
- ).toBeUndefined();
243
- await first.listener.close();
244
-
245
- const second = await startInboxMonitor(onMessage as InboxOnMessage, {
246
- groupMetadataCache,
247
- });
248
- second.sock.groupMetadata.mockRejectedValueOnce(new Error("408 timed out"));
249
- second.sock.ev.emit(
250
- "messages.upsert",
251
- buildNotifyMessageUpsert({
252
- id: nextMessageId("group-reconnect-cache"),
253
- remoteJid: "123@g.us",
254
- participant: "444@s.whatsapp.net",
255
- text: "ping",
256
- timestamp: 1_700_000_000,
257
- }),
258
- );
259
-
260
- await waitForMessageCalls(onMessage, 1);
261
- expect(onMessage).toHaveBeenCalledWith(
262
- expect.objectContaining({
263
- body: "ping",
264
- from: "123@g.us",
265
- groupSubject: "Recovered Group",
266
- senderE164: "+444",
267
- chatType: "group",
268
- }),
269
- );
270
- expect(onMessage.mock.calls[0]?.[0].groupParticipants).toBeUndefined();
271
-
272
- await second.listener.close();
273
- });
274
-
275
- it("bounds cached group metadata kept across reconnects", async () => {
276
- const groupMetadataCache: NonNullable<InboxMonitorOptions["groupMetadataCache"]> = new Map();
277
- const groups = Object.fromEntries(
278
- Array.from({ length: WHATSAPP_GROUP_METADATA_CACHE_MAX_ENTRIES + 2 }, (_, index) => [
279
- `${index}@g.us`,
280
- {
281
- id: `${index}@g.us`,
282
- subject: `Group ${index}`,
283
- owner: undefined,
284
- participants: [],
285
- },
286
- ]),
287
- );
288
- const sock = getSock();
289
- sock.groupFetchAllParticipating.mockResolvedValueOnce(groups);
290
-
291
- const { listener } = await startInboxMonitor(vi.fn(async () => {}) as InboxOnMessage, {
292
- groupMetadataCache,
293
- });
294
-
295
- await vi.waitFor(() => {
296
- expect(groupMetadataCache.size).toBe(WHATSAPP_GROUP_METADATA_CACHE_MAX_ENTRIES);
297
- });
298
- expect(groupMetadataCache.has("0@g.us")).toBe(false);
299
- expect(groupMetadataCache.has(`${WHATSAPP_GROUP_METADATA_CACHE_MAX_ENTRIES + 1}@g.us`)).toBe(
300
- true,
301
- );
302
-
303
- await listener.close();
304
- });
305
-
306
- it("does not block inbound listeners while group hydration is pending", async () => {
307
- let resolveHydration!: () => void;
308
- const sock = getSock();
309
- const pendingHydration = new Promise<Record<string, never>>((resolve) => {
310
- resolveHydration = () => resolve({});
311
- });
312
- sock.groupFetchAllParticipating.mockImplementationOnce(() => pendingHydration);
313
- const onMessage = vi.fn(async () => {
314
- return;
315
- });
316
-
317
- const { listener } = await startInboxMonitor(onMessage as InboxOnMessage);
318
- sock.ev.emit(
319
- "messages.upsert",
320
- buildNotifyMessageUpsert({
321
- id: nextMessageId("pending-hydration"),
322
- remoteJid: "999@s.whatsapp.net",
323
- text: "ping",
324
- timestamp: 1_700_000_000,
325
- pushName: "Tester",
326
- }),
327
- );
328
- await waitForMessageCalls(onMessage, 1);
329
-
330
- resolveHydration();
331
- await listener.close();
332
- });
333
-
334
- it("uses a replacement socket for replies created before reconnect", async () => {
335
- const onMessage = vi.fn(async () => undefined);
336
- const socketRef: NonNullable<InboxMonitorOptions["socketRef"]> = { current: null };
337
-
338
- const { listener, sock } = await startInboxMonitor(onMessage as InboxOnMessage, { socketRef });
339
- sock.ev.emit(
340
- "messages.upsert",
341
- buildNotifyMessageUpsert({
342
- id: nextMessageId("replacement-socket"),
343
- remoteJid: "999@s.whatsapp.net",
344
- text: "ping",
345
- timestamp: 1_700_000_000,
346
- pushName: "Tester",
347
- }),
348
- );
349
- await waitForMessageCalls(onMessage, 1);
350
-
351
- const inbound = onMessage.mock.calls.at(0)?.at(0) as
352
- | {
353
- reply: (text: string) => Promise<void>;
354
- sendMedia: (payload: Record<string, unknown>) => Promise<void>;
355
- sendComposing: () => Promise<void>;
356
- }
357
- | undefined;
358
- expect(inbound).toBeDefined();
359
-
360
- const replacementSock = {
361
- sendMessage: vi.fn(async () => undefined),
362
- sendPresenceUpdate: vi.fn(async () => undefined),
363
- };
364
- socketRef.current = replacementSock as unknown as NonNullable<
365
- InboxMonitorOptions["socketRef"]
366
- >["current"];
367
-
368
- await inbound?.reply("pong");
369
- await inbound?.sendMedia({ text: "after-reconnect" });
370
- await inbound?.sendComposing();
371
-
372
- expect(replacementSock.sendMessage).toHaveBeenNthCalledWith(1, "999@s.whatsapp.net", {
373
- text: "pong",
374
- });
375
- expect(replacementSock.sendMessage).toHaveBeenNthCalledWith(2, "999@s.whatsapp.net", {
376
- text: "after-reconnect",
377
- });
378
- expect(replacementSock.sendPresenceUpdate).toHaveBeenCalledWith(
379
- "composing",
380
- "999@s.whatsapp.net",
381
- );
382
- expect(sock.sendMessage).not.toHaveBeenCalled();
383
-
384
- await listener.close();
385
- });
386
-
387
- it("waits for a replacement socket before sending replies", async () => {
388
- const onMessage = vi.fn(async () => undefined);
389
- const socketRef = createSocketRef();
390
- const { listener, sock, inbound } = await primeInboundReplyHandle({
391
- onMessage,
392
- socketRef,
393
- upsertId: "reconnect-gap",
394
- retryPolicy: {
395
- initialMs: 10,
396
- maxMs: 10,
397
- factor: 1,
398
- jitter: 0,
399
- maxAttempts: 2,
400
- },
401
- });
402
-
403
- const replacementSock = {
404
- sendMessage: vi.fn(async () => undefined),
405
- sendPresenceUpdate: vi.fn(async () => undefined),
406
- };
407
- socketRef.current = null;
408
- sleepWithAbortMock.mockImplementationOnce(async () => {
409
- socketRef.current = replacementSock as unknown as NonNullable<
410
- InboxMonitorOptions["socketRef"]
411
- >["current"];
412
- });
413
-
414
- await inbound?.reply("pong");
415
-
416
- expect(sleepWithAbortMock).toHaveBeenCalledWith(10, undefined);
417
- expect(replacementSock.sendMessage).toHaveBeenCalledWith("999@s.whatsapp.net", {
418
- text: "pong",
419
- });
420
- expect(sock.sendMessage).not.toHaveBeenCalled();
421
-
422
- await listener.close();
423
- });
424
-
425
- it("flushes pending debounced inbound batches after close", async () => {
426
- vi.useFakeTimers();
427
- try {
428
- const onMessage = vi.fn(async () => undefined);
429
- const { listener, sock } = await startInboxMonitor(onMessage as InboxOnMessage, {
430
- debounceMs: 50,
431
- });
432
- sock.ev.emit(
433
- "messages.upsert",
434
- buildNotifyMessageUpsert({
435
- id: nextMessageId("debounce-close-1"),
436
- remoteJid: "999@s.whatsapp.net",
437
- text: "first",
438
- timestamp: 1_700_000_000,
439
- pushName: "Tester",
440
- }),
441
- );
442
- sock.ev.emit(
443
- "messages.upsert",
444
- buildNotifyMessageUpsert({
445
- id: nextMessageId("debounce-close-2"),
446
- remoteJid: "999@s.whatsapp.net",
447
- text: "second",
448
- timestamp: 1_700_000_001,
449
- pushName: "Tester",
450
- }),
451
- );
452
-
453
- await listener.close();
454
- await vi.advanceTimersByTimeAsync(50);
455
- await waitForMessageCalls(onMessage, 1);
456
- expect(onMessage).toHaveBeenCalledWith(
457
- expect.objectContaining({
458
- body: "first\nsecond",
459
- }),
460
- );
461
- } finally {
462
- vi.useRealTimers();
463
- }
464
- });
465
-
466
- it("retries timed-out sends on the same socket without clearing the socket ref", async () => {
467
- const onMessage = vi.fn(async () => undefined);
468
- const socketRef = createSocketRef();
469
- const { listener, sock, inbound } = await primeInboundReplyHandle({
470
- onMessage,
471
- socketRef,
472
- upsertId: "timeout-retry",
473
- retryPolicy: {
474
- initialMs: 1,
475
- maxMs: 1,
476
- factor: 1,
477
- jitter: 0,
478
- maxAttempts: 2,
479
- },
480
- });
481
-
482
- sock.sendMessage
483
- .mockRejectedValueOnce(new Error("operation timed out"))
484
- .mockResolvedValueOnce({ key: { id: "after-timeout" } });
485
-
486
- await inbound?.reply("pong");
487
-
488
- expect(sock.sendMessage).toHaveBeenNthCalledWith(1, "999@s.whatsapp.net", {
489
- text: "pong",
490
- });
491
- expect(sock.sendMessage).toHaveBeenNthCalledWith(2, "999@s.whatsapp.net", {
492
- text: "pong",
493
- });
494
- expect(socketRef.current).toBe(sock);
495
- expect(sleepWithAbortMock).toHaveBeenCalledTimes(1);
496
-
497
- await listener.close();
498
- });
499
-
500
- it("bounds reconnect-gap retries even when reconnect attempts are unlimited", async () => {
501
- const onMessage = vi.fn(async () => undefined);
502
- const socketRef = createSocketRef();
503
- const { listener, inbound } = await primeInboundReplyHandle({
504
- onMessage,
505
- socketRef,
506
- upsertId: "unlimited-reconnect-send-bound",
507
- retryPolicy: {
508
- initialMs: 1,
509
- maxMs: 1,
510
- factor: 1,
511
- jitter: 0,
512
- maxAttempts: 0,
513
- },
514
- useCurrentSock: true,
515
- });
516
-
517
- socketRef.current = null;
518
-
519
- await expect(inbound?.reply("pong")).rejects.toThrow(
520
- "no active socket - reconnection in progress",
521
- );
522
- expect(sleepWithAbortMock).toHaveBeenCalledTimes(11);
523
-
524
- await listener.close();
525
- });
526
-
527
- it("deduplicates redelivered messages by id", async () => {
528
- const onMessage = vi.fn(async () => {
529
- return;
530
- });
531
-
532
- const { listener, sock } = await startInboxMonitor(onMessage as InboxOnMessage);
533
- const upsert = buildNotifyMessageUpsert({
534
- id: nextMessageId("dedupe"),
535
- remoteJid: "999@s.whatsapp.net",
536
- text: "ping",
537
- timestamp: 1_700_000_000,
538
- pushName: "Tester",
539
- });
540
-
541
- sock.ev.emit("messages.upsert", upsert);
542
- sock.ev.emit("messages.upsert", upsert);
543
- await waitForMessageCalls(onMessage, 1);
544
-
545
- expect(onMessage).toHaveBeenCalledTimes(1);
546
-
547
- await listener.close();
548
- });
549
-
550
- it("retries redelivered messages after an explicit retryable inbound failure", async () => {
551
- let attempts = 0;
552
- const onMessage = vi.fn(async () => {
553
- attempts += 1;
554
- if (attempts === 1) {
555
- throw new WhatsAppRetryableInboundError("retry me");
556
- }
557
- });
558
-
559
- const { listener, sock } = await startInboxMonitor(onMessage as InboxOnMessage);
560
- const upsert = buildNotifyMessageUpsert({
561
- id: nextMessageId("retryable-dedupe"),
562
- remoteJid: "999@s.whatsapp.net",
563
- text: "ping",
564
- timestamp: 1_700_000_000,
565
- pushName: "Tester",
566
- });
567
-
568
- sock.ev.emit("messages.upsert", upsert);
569
- await waitForMessageCalls(onMessage, 1);
570
-
571
- sock.ev.emit("messages.upsert", upsert);
572
- await waitForMessageCalls(onMessage, 2);
573
-
574
- await listener.close();
575
- });
576
-
577
- it("resolves LID JIDs using Baileys LID mapping store", async () => {
578
- const onMessage = vi.fn(async () => {
579
- return;
580
- });
581
-
582
- const { listener, sock } = await startInboxMonitor(onMessage as InboxOnMessage);
583
- const getPNForLID = vi.spyOn(sock.signalRepository.lidMapping, "getPNForLID");
584
- sock.signalRepository.lidMapping.getPNForLID.mockResolvedValueOnce("999:0@s.whatsapp.net");
585
- const upsert = buildNotifyMessageUpsert({
586
- id: nextMessageId("lid-store"),
587
- remoteJid: "999@lid",
588
- text: "ping",
589
- timestamp: 1_700_000_000,
590
- pushName: "Tester",
591
- });
592
-
593
- sock.ev.emit("messages.upsert", upsert);
594
- await waitForMessageCalls(onMessage, 1);
595
-
596
- expect(getPNForLID).toHaveBeenCalledWith("999@lid");
597
- expect(onMessage).toHaveBeenCalledWith(
598
- expect.objectContaining({ body: "ping", from: "+999", to: "+123" }),
599
- );
600
-
601
- await listener.close();
602
- });
603
-
604
- it("resolves LID JIDs via authDir mapping files", async () => {
605
- const onMessage = vi.fn(async () => {
606
- return;
607
- });
608
- fsSync.writeFileSync(
609
- path.join(getAuthDir(), "lid-mapping-555_reverse.json"),
610
- JSON.stringify("1555"),
611
- );
612
-
613
- const { listener, sock } = await startInboxMonitor(onMessage as InboxOnMessage);
614
- const getPNForLID = vi.spyOn(sock.signalRepository.lidMapping, "getPNForLID");
615
- const upsert = buildNotifyMessageUpsert({
616
- id: nextMessageId("lid-authdir"),
617
- remoteJid: "555@lid",
618
- text: "ping",
619
- timestamp: 1_700_000_000,
620
- pushName: "Tester",
621
- });
622
-
623
- sock.ev.emit("messages.upsert", upsert);
624
- await waitForMessageCalls(onMessage, 1);
625
-
626
- expect(onMessage).toHaveBeenCalledWith(
627
- expect.objectContaining({ body: "ping", from: "+1555", to: "+123" }),
628
- );
629
- expect(getPNForLID).not.toHaveBeenCalled();
630
-
631
- await listener.close();
632
- });
633
-
634
- it("resolves group participant LID JIDs via Baileys mapping", async () => {
635
- const onMessage = vi.fn(async () => {
636
- return;
637
- });
638
-
639
- const { listener, sock } = await startInboxMonitor(onMessage as InboxOnMessage);
640
- const getPNForLID = vi.spyOn(sock.signalRepository.lidMapping, "getPNForLID");
641
- sock.signalRepository.lidMapping.getPNForLID.mockResolvedValueOnce("444:0@s.whatsapp.net");
642
- const upsert = buildNotifyMessageUpsert({
643
- id: nextMessageId("group-lid"),
644
- remoteJid: "123@g.us",
645
- participant: "444@lid",
646
- text: "ping",
647
- timestamp: 1_700_000_000,
648
- });
649
-
650
- sock.ev.emit("messages.upsert", upsert);
651
- await waitForMessageCalls(onMessage, 1);
652
-
653
- expect(getPNForLID).toHaveBeenCalledWith("444@lid");
654
- expect(onMessage).toHaveBeenCalledWith(
655
- expect.objectContaining({
656
- body: "ping",
657
- from: "123@g.us",
658
- senderE164: "+444",
659
- chatType: "group",
660
- }),
661
- );
662
-
663
- await listener.close();
664
- });
665
-
666
- it("does not block follow-up messages when handler is pending", async () => {
667
- let resolveFirst: (() => void) | null = null;
668
- const onMessage = vi.fn(async () => {
669
- if (!resolveFirst) {
670
- await new Promise<void>((resolve) => {
671
- resolveFirst = resolve;
672
- });
673
- }
674
- });
675
-
676
- const { listener, sock } = await startInboxMonitor(onMessage as InboxOnMessage);
677
- const upsert = {
678
- type: "notify",
679
- messages: [
680
- {
681
- key: { id: "abc1", fromMe: false, remoteJid: "999@s.whatsapp.net" },
682
- message: { conversation: "ping" },
683
- messageTimestamp: 1_700_000_000,
684
- },
685
- {
686
- key: { id: "abc2", fromMe: false, remoteJid: "999@s.whatsapp.net" },
687
- message: { conversation: "pong" },
688
- messageTimestamp: 1_700_000_001,
689
- },
690
- ],
691
- };
692
-
693
- sock.ev.emit("messages.upsert", upsert);
694
- await waitForMessageCalls(onMessage, 2);
695
-
696
- expect(onMessage).toHaveBeenCalledTimes(2);
697
-
698
- (resolveFirst as (() => void) | null)?.();
699
- await listener.close();
700
- });
701
-
702
- it("captures reply context from quoted messages", async () => {
703
- await expectQuotedReplyContext({ conversation: "original" });
704
- });
705
-
706
- it("captures reply context from wrapped quoted messages", async () => {
707
- await expectQuotedReplyContext({
708
- viewOnceMessageV2Extension: {
709
- message: { conversation: "original" },
710
- },
711
- });
712
- });
713
-
714
- it("captures reply context from botInvokeMessage wrapped quoted messages", async () => {
715
- await expectQuotedReplyContext({
716
- botInvokeMessage: {
717
- message: { conversation: "original" },
718
- },
719
- });
720
- });
721
-
722
- it("captures reply context from groupMentionedMessage wrapped quoted messages", async () => {
723
- await expectQuotedReplyContext({
724
- groupMentionedMessage: {
725
- message: { conversation: "original" },
726
- },
727
- });
728
- });
729
- });