lordceaser-baileys 3.4.0 → 3.4.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 (398) hide show
  1. package/LICENSE +22 -0
  2. package/README.md +201 -0
  3. package/WAProto/_orig.js +92429 -277359
  4. package/WAProto/index.d.ts +11659 -95047
  5. package/WAProto/index.js +5 -2
  6. package/banner.png +0 -0
  7. package/index.js +11 -6
  8. package/lib/Defaults/index.d.ts +118 -48
  9. package/lib/Defaults/index.d.ts.map +1 -1
  10. package/lib/Defaults/index.js +29 -6
  11. package/lib/Defaults/index.js.map +1 -1
  12. package/lib/Signal/Group/ciphertext-message.d.ts +8 -8
  13. package/lib/Signal/Group/ciphertext-message.d.ts.map +1 -1
  14. package/lib/Signal/Group/ciphertext-message.js.map +1 -1
  15. package/lib/Signal/Group/group-session-builder.d.ts +6 -13
  16. package/lib/Signal/Group/group-session-builder.d.ts.map +1 -1
  17. package/lib/Signal/Group/group-session-builder.js.map +1 -1
  18. package/lib/Signal/Group/group_cipher.d.ts +9 -15
  19. package/lib/Signal/Group/group_cipher.d.ts.map +1 -1
  20. package/lib/Signal/Group/group_cipher.js.map +1 -1
  21. package/lib/Signal/Group/index.d.ts +11 -11
  22. package/lib/Signal/Group/index.d.ts.map +1 -1
  23. package/lib/Signal/Group/index.js.map +1 -1
  24. package/lib/Signal/Group/keyhelper.d.ts +6 -10
  25. package/lib/Signal/Group/keyhelper.d.ts.map +1 -1
  26. package/lib/Signal/Group/keyhelper.js.map +1 -1
  27. package/lib/Signal/Group/sender-chain-key.d.ts +10 -10
  28. package/lib/Signal/Group/sender-chain-key.d.ts.map +1 -1
  29. package/lib/Signal/Group/sender-chain-key.js.map +1 -1
  30. package/lib/Signal/Group/sender-key-distribution-message.d.ts +14 -14
  31. package/lib/Signal/Group/sender-key-distribution-message.d.ts.map +1 -1
  32. package/lib/Signal/Group/sender-key-distribution-message.js.map +1 -1
  33. package/lib/Signal/Group/sender-key-message.d.ts +16 -16
  34. package/lib/Signal/Group/sender-key-message.d.ts.map +1 -1
  35. package/lib/Signal/Group/sender-key-message.js.map +1 -1
  36. package/lib/Signal/Group/sender-key-name.d.ts +7 -13
  37. package/lib/Signal/Group/sender-key-name.d.ts.map +1 -1
  38. package/lib/Signal/Group/sender-key-name.js.map +1 -1
  39. package/lib/Signal/Group/sender-key-record.d.ts +10 -28
  40. package/lib/Signal/Group/sender-key-record.d.ts.map +1 -1
  41. package/lib/Signal/Group/sender-key-record.js.map +1 -1
  42. package/lib/Signal/Group/sender-key-state.d.ts +14 -36
  43. package/lib/Signal/Group/sender-key-state.d.ts.map +1 -1
  44. package/lib/Signal/Group/sender-key-state.js.map +1 -1
  45. package/lib/Signal/Group/sender-message-key.d.ts +10 -10
  46. package/lib/Signal/Group/sender-message-key.d.ts.map +1 -1
  47. package/lib/Signal/Group/sender-message-key.js.map +1 -1
  48. package/lib/Signal/libsignal.d.ts +54 -4
  49. package/lib/Signal/libsignal.d.ts.map +1 -1
  50. package/lib/Signal/libsignal.js.map +1 -1
  51. package/lib/Signal/lid-mapping.d.ts +15 -17
  52. package/lib/Signal/lid-mapping.d.ts.map +1 -1
  53. package/lib/Signal/lid-mapping.js.map +1 -1
  54. package/lib/Socket/Client/index.d.ts +2 -2
  55. package/lib/Socket/Client/index.d.ts.map +1 -1
  56. package/lib/Socket/Client/index.js +1 -0
  57. package/lib/Socket/Client/index.js.map +1 -1
  58. package/lib/Socket/Client/types.d.ts +4 -14
  59. package/lib/Socket/Client/types.d.ts.map +1 -1
  60. package/lib/Socket/Client/types.js +2 -1
  61. package/lib/Socket/Client/types.js.map +1 -1
  62. package/lib/Socket/Client/websocket.d.ts +5 -5
  63. package/lib/Socket/Client/websocket.d.ts.map +1 -1
  64. package/lib/Socket/Client/websocket.js +2 -1
  65. package/lib/Socket/Client/websocket.js.map +1 -1
  66. package/lib/Socket/business.d.ts +353 -175
  67. package/lib/Socket/business.d.ts.map +1 -1
  68. package/lib/Socket/business.js +43 -70
  69. package/lib/Socket/business.js.map +1 -1
  70. package/lib/Socket/chats.d.ts +112 -93
  71. package/lib/Socket/chats.d.ts.map +1 -1
  72. package/lib/Socket/chats.js +20 -709
  73. package/lib/Socket/chats.js.map +1 -1
  74. package/lib/Socket/communities.d.ts +499 -210
  75. package/lib/Socket/communities.d.ts.map +1 -1
  76. package/lib/Socket/communities.js +1 -0
  77. package/lib/Socket/communities.js.map +1 -1
  78. package/lib/Socket/groups.d.ts +245 -120
  79. package/lib/Socket/groups.d.ts.map +1 -1
  80. package/lib/Socket/groups.js +5 -206
  81. package/lib/Socket/groups.js.map +1 -1
  82. package/lib/Socket/index.d.ts +478 -208
  83. package/lib/Socket/index.d.ts.map +1 -1
  84. package/lib/Socket/index.js +3 -28
  85. package/lib/Socket/index.js.map +1 -1
  86. package/lib/Socket/messages-recv.d.ts +295 -164
  87. package/lib/Socket/messages-recv.d.ts.map +1 -1
  88. package/lib/Socket/messages-recv.js +9 -381
  89. package/lib/Socket/messages-recv.js.map +1 -1
  90. package/lib/Socket/messages-send.d.ts +290 -159
  91. package/lib/Socket/messages-send.d.ts.map +1 -1
  92. package/lib/Socket/messages-send.js +154 -1963
  93. package/lib/Socket/messages-send.js.map +1 -1
  94. package/lib/Socket/mex.d.ts +1 -2
  95. package/lib/Socket/mex.d.ts.map +1 -1
  96. package/lib/Socket/mex.js +2 -1
  97. package/lib/Socket/mex.js.map +1 -1
  98. package/lib/Socket/newsletter.d.ts +251 -138
  99. package/lib/Socket/newsletter.d.ts.map +1 -1
  100. package/lib/Socket/newsletter.js +9 -43
  101. package/lib/Socket/newsletter.js.map +1 -1
  102. package/lib/Socket/socket.d.ts +44 -42
  103. package/lib/Socket/socket.d.ts.map +1 -1
  104. package/lib/Socket/socket.js +17 -64
  105. package/lib/Socket/socket.js.map +1 -1
  106. package/lib/Store/index.d.ts +4 -0
  107. package/lib/Store/index.d.ts.map +1 -0
  108. package/lib/Store/index.js +4 -0
  109. package/lib/Store/index.js.map +1 -0
  110. package/lib/Store/make-in-memory-store.d.ts +63 -0
  111. package/lib/Store/make-in-memory-store.d.ts.map +1 -0
  112. package/lib/Store/make-in-memory-store.js +421 -0
  113. package/lib/Store/make-in-memory-store.js.map +1 -0
  114. package/lib/Store/make-ordered-dictionary.d.ts +13 -0
  115. package/lib/Store/make-ordered-dictionary.d.ts.map +1 -0
  116. package/lib/Store/make-ordered-dictionary.js +79 -0
  117. package/lib/Store/make-ordered-dictionary.js.map +1 -0
  118. package/lib/Store/object-repository.d.ts +11 -0
  119. package/lib/Store/object-repository.d.ts.map +1 -0
  120. package/lib/Store/object-repository.js +24 -0
  121. package/lib/Store/object-repository.js.map +1 -0
  122. package/lib/Types/Auth.d.ts +0 -115
  123. package/lib/Types/Auth.d.ts.map +1 -1
  124. package/lib/Types/Auth.js.map +1 -1
  125. package/lib/Types/Bussines.d.ts +1 -24
  126. package/lib/Types/Bussines.d.ts.map +1 -1
  127. package/lib/Types/Bussines.js.map +1 -1
  128. package/lib/Types/Call.d.ts +1 -14
  129. package/lib/Types/Call.d.ts.map +1 -1
  130. package/lib/Types/Call.js.map +1 -1
  131. package/lib/Types/Chat.d.ts +1 -123
  132. package/lib/Types/Chat.d.ts.map +1 -1
  133. package/lib/Types/Chat.js.map +1 -1
  134. package/lib/Types/Contact.d.ts +1 -25
  135. package/lib/Types/Contact.d.ts.map +1 -1
  136. package/lib/Types/Contact.js.map +1 -1
  137. package/lib/Types/Events.d.ts +1 -255
  138. package/lib/Types/Events.d.ts.map +1 -1
  139. package/lib/Types/Events.js.map +1 -1
  140. package/lib/Types/GroupMetadata.d.ts +1 -70
  141. package/lib/Types/GroupMetadata.d.ts.map +1 -1
  142. package/lib/Types/GroupMetadata.js.map +1 -1
  143. package/lib/Types/Label.d.ts +1 -45
  144. package/lib/Types/Label.d.ts.map +1 -1
  145. package/lib/Types/Label.js.map +1 -1
  146. package/lib/Types/LabelAssociation.d.ts +1 -28
  147. package/lib/Types/LabelAssociation.d.ts.map +1 -1
  148. package/lib/Types/LabelAssociation.js.map +1 -1
  149. package/lib/Types/Message.d.ts +10 -318
  150. package/lib/Types/Message.d.ts.map +1 -1
  151. package/lib/Types/Message.js +7 -0
  152. package/lib/Types/Message.js.map +1 -1
  153. package/lib/Types/Mex.d.ts +2 -140
  154. package/lib/Types/Mex.d.ts.map +1 -1
  155. package/lib/Types/Mex.js +2 -0
  156. package/lib/Types/Mex.js.map +1 -1
  157. package/lib/Types/Product.d.ts +1 -78
  158. package/lib/Types/Product.d.ts.map +1 -1
  159. package/lib/Types/Product.js.map +1 -1
  160. package/lib/Types/RichType.d.ts +3 -0
  161. package/lib/Types/RichType.d.ts.map +1 -0
  162. package/lib/Types/RichType.js +23 -0
  163. package/lib/Types/RichType.js.map +1 -0
  164. package/lib/Types/Signal.d.ts +0 -85
  165. package/lib/Types/Signal.d.ts.map +1 -1
  166. package/lib/Types/Signal.js.map +1 -1
  167. package/lib/Types/Socket.d.ts +1 -135
  168. package/lib/Types/Socket.d.ts.map +1 -1
  169. package/lib/Types/Socket.js +0 -1
  170. package/lib/Types/Socket.js.map +1 -1
  171. package/lib/Types/State.d.ts +5 -96
  172. package/lib/Types/State.d.ts.map +1 -1
  173. package/lib/Types/State.js.map +1 -1
  174. package/lib/Types/USync.d.ts +1 -25
  175. package/lib/Types/USync.d.ts.map +1 -1
  176. package/lib/Types/USync.js.map +1 -1
  177. package/lib/Types/index.d.ts +13 -65
  178. package/lib/Types/index.d.ts.map +1 -1
  179. package/lib/Types/index.js.map +1 -1
  180. package/lib/Utils/auth-utils.d.ts +51 -17
  181. package/lib/Utils/auth-utils.d.ts.map +1 -1
  182. package/lib/Utils/auth-utils.js +5 -1
  183. package/lib/Utils/auth-utils.js.map +1 -1
  184. package/lib/Utils/browser-utils.d.ts +9 -3
  185. package/lib/Utils/browser-utils.d.ts.map +1 -1
  186. package/lib/Utils/browser-utils.js.map +1 -1
  187. package/lib/Utils/business.d.ts +46 -19
  188. package/lib/Utils/business.d.ts.map +1 -1
  189. package/lib/Utils/business.js.map +1 -1
  190. package/lib/Utils/chat-utils.d.ts +398 -89
  191. package/lib/Utils/chat-utils.d.ts.map +1 -1
  192. package/lib/Utils/chat-utils.js.map +1 -1
  193. package/lib/Utils/companion-reg-client-utils.d.ts +4 -16
  194. package/lib/Utils/companion-reg-client-utils.d.ts.map +1 -1
  195. package/lib/Utils/companion-reg-client-utils.js +7 -2
  196. package/lib/Utils/companion-reg-client-utils.js.map +1 -1
  197. package/lib/Utils/crypto.d.ts +29 -26
  198. package/lib/Utils/crypto.d.ts.map +1 -1
  199. package/lib/Utils/crypto.js +2 -0
  200. package/lib/Utils/crypto.js.map +1 -1
  201. package/lib/Utils/decode-wa-message.d.ts +76 -58
  202. package/lib/Utils/decode-wa-message.d.ts.map +1 -1
  203. package/lib/Utils/decode-wa-message.js.map +1 -1
  204. package/lib/Utils/event-buffer.d.ts +9 -32
  205. package/lib/Utils/event-buffer.d.ts.map +1 -1
  206. package/lib/Utils/event-buffer.js.map +1 -1
  207. package/lib/Utils/generics.d.ts +45 -73
  208. package/lib/Utils/generics.d.ts.map +1 -1
  209. package/lib/Utils/generics.js +17 -15
  210. package/lib/Utils/generics.js.map +1 -1
  211. package/lib/Utils/history.d.ts +73 -21
  212. package/lib/Utils/history.d.ts.map +1 -1
  213. package/lib/Utils/history.js.map +1 -1
  214. package/lib/Utils/identity-change-handler.d.ts +9 -39
  215. package/lib/Utils/identity-change-handler.d.ts.map +1 -1
  216. package/lib/Utils/identity-change-handler.js.map +1 -1
  217. package/lib/Utils/index.d.ts +24 -21
  218. package/lib/Utils/index.d.ts.map +1 -1
  219. package/lib/Utils/index.js +3 -0
  220. package/lib/Utils/index.js.map +1 -1
  221. package/lib/Utils/link-preview.d.ts +8 -16
  222. package/lib/Utils/link-preview.d.ts.map +1 -1
  223. package/lib/Utils/link-preview.js.map +1 -1
  224. package/lib/Utils/logger.d.ts +1 -10
  225. package/lib/Utils/logger.d.ts.map +1 -1
  226. package/lib/Utils/logger.js.map +1 -1
  227. package/lib/Utils/lt-hash.d.ts +1 -2
  228. package/lib/Utils/lt-hash.d.ts.map +1 -1
  229. package/lib/Utils/lt-hash.js.map +1 -1
  230. package/lib/Utils/make-mutex.d.ts +4 -6
  231. package/lib/Utils/make-mutex.d.ts.map +1 -1
  232. package/lib/Utils/make-mutex.js.map +1 -1
  233. package/lib/Utils/message-retry-manager.d.ts +36 -71
  234. package/lib/Utils/message-retry-manager.d.ts.map +1 -1
  235. package/lib/Utils/message-retry-manager.js +1 -1
  236. package/lib/Utils/message-retry-manager.js.map +1 -1
  237. package/lib/Utils/messages-media.d.ts +121 -117
  238. package/lib/Utils/messages-media.d.ts.map +1 -1
  239. package/lib/Utils/messages-media.js +87 -32
  240. package/lib/Utils/messages-media.js.map +1 -1
  241. package/lib/Utils/messages.d.ts +33 -78
  242. package/lib/Utils/messages.d.ts.map +1 -1
  243. package/lib/Utils/messages.js +1010 -63
  244. package/lib/Utils/messages.js.map +1 -1
  245. package/lib/Utils/noise-handler.d.ts +18 -17
  246. package/lib/Utils/noise-handler.d.ts.map +1 -1
  247. package/lib/Utils/noise-handler.js.map +1 -1
  248. package/lib/Utils/offline-node-processor.d.ts +2 -9
  249. package/lib/Utils/offline-node-processor.d.ts.map +1 -1
  250. package/lib/Utils/offline-node-processor.js.map +1 -1
  251. package/lib/Utils/pre-key-manager.d.ts +9 -11
  252. package/lib/Utils/pre-key-manager.d.ts.map +1 -1
  253. package/lib/Utils/pre-key-manager.js.map +1 -1
  254. package/lib/Utils/process-message.d.ts +70 -46
  255. package/lib/Utils/process-message.d.ts.map +1 -1
  256. package/lib/Utils/process-message.js +119 -0
  257. package/lib/Utils/process-message.js.map +1 -1
  258. package/lib/Utils/reporting-utils.d.ts +12 -10
  259. package/lib/Utils/reporting-utils.d.ts.map +1 -1
  260. package/lib/Utils/reporting-utils.js.map +1 -1
  261. package/lib/Utils/rich-message-utils.d.ts +49 -0
  262. package/lib/Utils/rich-message-utils.d.ts.map +1 -0
  263. package/lib/Utils/rich-message-utils.js +370 -0
  264. package/lib/Utils/rich-message-utils.js.map +1 -0
  265. package/lib/Utils/signal.d.ts +71 -35
  266. package/lib/Utils/signal.d.ts.map +1 -1
  267. package/lib/Utils/signal.js.map +1 -1
  268. package/lib/Utils/stanza-ack.d.ts +8 -2
  269. package/lib/Utils/stanza-ack.d.ts.map +1 -1
  270. package/lib/Utils/stanza-ack.js.map +1 -1
  271. package/lib/Utils/sync-action-utils.d.ts +2 -18
  272. package/lib/Utils/sync-action-utils.d.ts.map +1 -1
  273. package/lib/Utils/sync-action-utils.js.map +1 -1
  274. package/lib/Utils/tc-token-utils.d.ts +23 -30
  275. package/lib/Utils/tc-token-utils.d.ts.map +1 -1
  276. package/lib/Utils/tc-token-utils.js.map +1 -1
  277. package/lib/Utils/use-multi-file-auth-state.d.ts +9 -11
  278. package/lib/Utils/use-multi-file-auth-state.d.ts.map +1 -1
  279. package/lib/Utils/use-multi-file-auth-state.js.map +1 -1
  280. package/lib/Utils/use-single-file-auth-state.d.ts +11 -0
  281. package/lib/Utils/use-single-file-auth-state.d.ts.map +1 -0
  282. package/lib/Utils/use-single-file-auth-state.js +109 -0
  283. package/lib/Utils/use-single-file-auth-state.js.map +1 -0
  284. package/lib/Utils/use-sqlite-auth-state.d.ts +11 -0
  285. package/lib/Utils/use-sqlite-auth-state.d.ts.map +1 -0
  286. package/lib/Utils/use-sqlite-auth-state.js +109 -0
  287. package/lib/Utils/use-sqlite-auth-state.js.map +1 -0
  288. package/lib/Utils/validate-connection.d.ts +42 -9
  289. package/lib/Utils/validate-connection.d.ts.map +1 -1
  290. package/lib/Utils/validate-connection.js.map +1 -1
  291. package/lib/WABinary/constants.d.ts +60 -26
  292. package/lib/WABinary/constants.d.ts.map +1 -1
  293. package/lib/WABinary/constants.js +166 -0
  294. package/lib/WABinary/constants.js.map +1 -1
  295. package/lib/WABinary/decode.d.ts +8 -5
  296. package/lib/WABinary/decode.d.ts.map +1 -1
  297. package/lib/WABinary/decode.js.map +1 -1
  298. package/lib/WABinary/encode.d.ts +2 -2
  299. package/lib/WABinary/encode.d.ts.map +1 -1
  300. package/lib/WABinary/encode.js.map +1 -1
  301. package/lib/WABinary/generic-utils.d.ts +75 -13
  302. package/lib/WABinary/generic-utils.d.ts.map +1 -1
  303. package/lib/WABinary/generic-utils.js +114 -1
  304. package/lib/WABinary/generic-utils.js.map +1 -1
  305. package/lib/WABinary/index.d.ts +5 -5
  306. package/lib/WABinary/index.d.ts.map +1 -1
  307. package/lib/WABinary/index.js.map +1 -1
  308. package/lib/WABinary/jid-utils.d.ts +28 -47
  309. package/lib/WABinary/jid-utils.d.ts.map +1 -1
  310. package/lib/WABinary/jid-utils.js +1 -1
  311. package/lib/WABinary/jid-utils.js.map +1 -1
  312. package/lib/WABinary/types.d.ts +1 -18
  313. package/lib/WABinary/types.d.ts.map +1 -1
  314. package/lib/WABinary/types.js.map +1 -1
  315. package/lib/WAM/BinaryInfo.d.ts +4 -5
  316. package/lib/WAM/BinaryInfo.d.ts.map +1 -1
  317. package/lib/WAM/BinaryInfo.js.map +1 -1
  318. package/lib/WAM/constants.d.ts +34916 -29
  319. package/lib/WAM/constants.d.ts.map +1 -1
  320. package/lib/WAM/constants.js.map +1 -1
  321. package/lib/WAM/encode.d.ts +1 -2
  322. package/lib/WAM/encode.d.ts.map +1 -1
  323. package/lib/WAM/encode.js.map +1 -1
  324. package/lib/WAM/index.d.ts +3 -3
  325. package/lib/WAM/index.d.ts.map +1 -1
  326. package/lib/WAM/index.js.map +1 -1
  327. package/lib/WAUSync/Protocols/USyncContactProtocol.d.ts +34 -7
  328. package/lib/WAUSync/Protocols/USyncContactProtocol.d.ts.map +1 -1
  329. package/lib/WAUSync/Protocols/USyncContactProtocol.js +3 -7
  330. package/lib/WAUSync/Protocols/USyncContactProtocol.js.map +1 -1
  331. package/lib/WAUSync/Protocols/USyncDeviceProtocol.d.ts +20 -20
  332. package/lib/WAUSync/Protocols/USyncDeviceProtocol.d.ts.map +1 -1
  333. package/lib/WAUSync/Protocols/USyncDeviceProtocol.js +2 -1
  334. package/lib/WAUSync/Protocols/USyncDeviceProtocol.js.map +1 -1
  335. package/lib/WAUSync/Protocols/USyncDisappearingModeProtocol.d.ts +9 -9
  336. package/lib/WAUSync/Protocols/USyncDisappearingModeProtocol.d.ts.map +1 -1
  337. package/lib/WAUSync/Protocols/USyncDisappearingModeProtocol.js +2 -1
  338. package/lib/WAUSync/Protocols/USyncDisappearingModeProtocol.js.map +1 -1
  339. package/lib/WAUSync/Protocols/USyncStatusProtocol.d.ts +9 -9
  340. package/lib/WAUSync/Protocols/USyncStatusProtocol.d.ts.map +1 -1
  341. package/lib/WAUSync/Protocols/USyncStatusProtocol.js +2 -1
  342. package/lib/WAUSync/Protocols/USyncStatusProtocol.js.map +1 -1
  343. package/lib/WAUSync/Protocols/USyncUsernameProtocol.d.ts +7 -7
  344. package/lib/WAUSync/Protocols/USyncUsernameProtocol.d.ts.map +1 -1
  345. package/lib/WAUSync/Protocols/USyncUsernameProtocol.js +3 -2
  346. package/lib/WAUSync/Protocols/USyncUsernameProtocol.js.map +1 -1
  347. package/lib/WAUSync/Protocols/UsyncBotProfileProtocol.d.ts +36 -23
  348. package/lib/WAUSync/Protocols/UsyncBotProfileProtocol.d.ts.map +1 -1
  349. package/lib/WAUSync/Protocols/UsyncBotProfileProtocol.js +2 -1
  350. package/lib/WAUSync/Protocols/UsyncBotProfileProtocol.js.map +1 -1
  351. package/lib/WAUSync/Protocols/UsyncLIDProtocol.d.ts +12 -7
  352. package/lib/WAUSync/Protocols/UsyncLIDProtocol.d.ts.map +1 -1
  353. package/lib/WAUSync/Protocols/UsyncLIDProtocol.js +2 -1
  354. package/lib/WAUSync/Protocols/UsyncLIDProtocol.js.map +1 -1
  355. package/lib/WAUSync/Protocols/index.d.ts +5 -5
  356. package/lib/WAUSync/Protocols/index.d.ts.map +1 -1
  357. package/lib/WAUSync/Protocols/index.js +1 -7
  358. package/lib/WAUSync/Protocols/index.js.map +1 -1
  359. package/lib/WAUSync/USyncQuery.d.ts +10 -19
  360. package/lib/WAUSync/USyncQuery.d.ts.map +1 -1
  361. package/lib/WAUSync/USyncQuery.js +23 -126
  362. package/lib/WAUSync/USyncQuery.js.map +1 -1
  363. package/lib/WAUSync/USyncUser.d.ts +15 -15
  364. package/lib/WAUSync/USyncUser.d.ts.map +1 -1
  365. package/lib/WAUSync/USyncUser.js +1 -24
  366. package/lib/WAUSync/USyncUser.js.map +1 -1
  367. package/lib/WAUSync/index.d.ts +3 -3
  368. package/lib/WAUSync/index.d.ts.map +1 -1
  369. package/lib/WAUSync/index.js +2 -1
  370. package/lib/WAUSync/index.js.map +1 -1
  371. package/lib/index.d.ts +9 -9
  372. package/lib/index.d.ts.map +1 -1
  373. package/lib/index.js +1 -0
  374. package/lib/index.js.map +1 -1
  375. package/package.json +11 -3
  376. package/WAProto/GenerateStatics.sh +0 -3
  377. package/WAProto/V +0 -1
  378. package/WAProto/WAProto.proto +0 -8423
  379. package/WAProto/fix-imports.js +0 -85
  380. package/lib/Socket/aigroups.js +0 -315
  381. package/lib/Socket/ban-checker.js +0 -153
  382. package/lib/Socket/chats.js[old] +0 -1227
  383. package/lib/Socket/graphql.js +0 -899
  384. package/lib/Socket/groups.js[old] +0 -347
  385. package/lib/Socket/interactive-handler.js +0 -600
  386. package/lib/Socket/interop.js +0 -563
  387. package/lib/Socket/managed-account.js +0 -208
  388. package/lib/Socket/package.json +0 -1
  389. package/lib/Socket/privacy.js +0 -446
  390. package/lib/Socket/registration.js +0 -428
  391. package/lib/Socket/username.js +0 -229
  392. package/lib/Utils/package.json +0 -1
  393. package/lib/WAUSync/Protocols/USyncBusinessProtocol.js +0 -96
  394. package/lib/WAUSync/Protocols/USyncFeatureProtocol.js +0 -70
  395. package/lib/WAUSync/Protocols/USyncPictureProtocol.js +0 -28
  396. package/lib/WAUSync/Protocols/USyncSidelistProtocol.js +0 -25
  397. package/lib/WAUSync/Protocols/USyncTextStatusProtocol.js +0 -34
  398. package/lib/package.json +0 -1
@@ -1,135 +1,44 @@
1
1
  import NodeCache from '@cacheable/node-cache';
2
2
  import { Boom } from '@hapi/boom';
3
- import { randomBytes, randomUUID } from 'crypto';
3
+ import { randomBytes } from 'crypto';
4
4
  import { proto } from '../../WAProto/index.js';
5
5
  import { BIZ_BOT_SUPPORT_PAYLOAD, DEFAULT_CACHE_TTLS, WA_DEFAULT_EPHEMERAL } from '../Defaults/index.js';
6
- import { aggregateMessageKeysNotFromMe, assertMediaContent, assertMeId, bindWaitForEvent, buildLinkPreview, decryptMediaRetryData, DEF_MEDIA_HOST, delay, encodeNewsletterMessage, encodeSignedDeviceIdentity, encodeWAMessage, encryptMediaRetryRequest, extractDeviceJids, extractImageThumb, generateMessageIDV2, generateParticipantHashV2, generateWAMessage, generateWAMessageFromContent, getStatusCodeForMediaRetry, makeWhatsAppFlowButton, getUrlFromDirectPath, getWAUploadToServer, MessageRetryManager, normalizeMessageContent, parseAndInjectE2ESessions, prepareWAMessageMedia, shouldIncludeBizBinaryNode, unixTimestampSeconds } from '../Utils/index.js';
6
+ import { aggregateMessageKeysNotFromMe, assertMediaContent, assertMeId, bindWaitForEvent, decryptMediaRetryData, DEF_MEDIA_HOST, delay, encodeNewsletterMessage, encodeSignedDeviceIdentity, encodeWAMessage, encryptMediaRetryRequest, extractDeviceJids, generateMessageIDV2, generateParticipantHashV2, generateWAMessage, generateWAMessageFromContent, getStatusCodeForMediaRetry, getUrlFromDirectPath, getWAUploadToServer, hasValidAlbumMedia, MessageRetryManager, normalizeMessageContent, parseAndInjectE2ESessions, shouldIncludeBizBinaryNode, unixTimestampSeconds } from '../Utils/index.js';
7
+ import { AssociationType } from '../Types/index.js';
7
8
  import { getUrlInfo } from '../Utils/link-preview.js';
8
- import { prepareRichMenuMessage, prepareA2UIMessage, prepareA2UICommandMenu, prepareAIRichCommandMenu, prepareSocialEntityMessage, prepareInstagramProfileMessage, prepareRichResponseMessage, prepareRichGenerationMessage, prepareCopyToClipboardMessage, prepareRichTextMessage, prepareRichQuoteMessage, prepareRichImageMessage, prepareRichLinkMessage, prepareSocialProfileMessage, prepareUnifiedResponseMessage, prepareRichMapMessage, prepareBotPromptSuggestionsMessage, prepareBotSourcesMessage, prepareRichDynamicMediaMessage, prepareBotPttTranscriptMessage, prepareGridImageMessage, prepareVerticalAlbumMessage, prepareVideoGridMessage, prepareHtmlMessage, prepareRichHtmlMessage, buildRichLabelMessage, attachBotVerificationProofs, hasVerifiableProofs } from '../Utils/rich-message-utils.js';
9
- import { generateSlotMachineHtml } from '../Utils/games/slot-machine.js';
10
- import { generateMiniAppHtml } from '../Utils/games/miniapp.js';
11
- import { generateWebsitePreviewHtml, generateLinkPreviewHtml } from '../Utils/games/website-preview.js';
12
- import { isViewOnceMessage, extractViewOnceContent, getViewOnceMediaType, getViewOnceMediaContent, downloadViewOnceMedia, createRegularMessageFromViewOnce, parseViewOnceInfo } from '../Utils/view-once-utils.js';
13
9
  import { makeKeyedMutex, makeMutex } from '../Utils/make-mutex.js';
14
10
  import { getMessageReportingToken, shouldIncludeReportingToken } from '../Utils/reporting-utils.js';
15
11
  import { buildMergedTcTokenIndexWrite, isTcTokenExpired, resolveIssuanceJid, resolveTcTokenJid, shouldSendNewTcToken, storeTcTokensFromIqResult } from '../Utils/tc-token-utils.js';
16
12
  import { areJidsSameUser, getBinaryNodeChild, getBinaryNodeChildren, getBizBinaryNode, isHostedLidUser, isHostedPnUser, isJidBot, isJidGroup, isJidMetaAI, isJidNewsletter, isLidUser, isPnUser, jidDecode, jidEncode, jidNormalizedUser, PSA_WID, S_WHATSAPP_NET } from '../WABinary/index.js';
17
13
  import { USyncQuery, USyncUser } from '../WAUSync/index.js';
18
- import { captureUnifiedResponse, generateCodeBlockContent, generateLatexContent, generateListContent, generateTableContent, generateUnifiedResponseContent } from '../Utils/message-composer.js';
19
- import { BotCapabilityType, buildBotRichResponse } from '../Utils/bot-capabilities.js';
20
- import { Baron } from './interactive-handler.js';
21
- import { collectMetaAIBotParticipantJids, isMetaAIBotResponse, META_AI_BOT_JID } from './aigroups.js';
22
- import { makeUsernameSocket } from './username.js';
23
- import { grepSource } from '../Utils/source-grep.js';
24
-
25
- const STATUS_JID = 'status@broadcast';
26
- export const normalizeStatusJidList = (value) => {
27
- if (!Array.isArray(value) || value.length === 0) {
28
- throw new Boom('statusJidList must contain at least one recipient JID', { statusCode: 400 });
29
- }
30
- const recipients = [...new Set(value.map(jidNormalizedUser).filter(jid => isPnUser(jid) || isLidUser(jid)))];
31
- if (recipients.length === 0) {
32
- throw new Boom('statusJidList does not contain any valid user JIDs', { statusCode: 400 });
33
- }
34
- return recipients;
35
- };
36
-
14
+ import { makeNewsletterSocket } from './newsletter.js';
37
15
  export const makeMessagesSocket = (config) => {
38
16
  const { logger, linkPreviewImageThumbnailWidth, generateHighQualityLinkPreview, options: httpRequestOptions, patchMessageBeforeSending, cachedGroupMetadata, enableRecentMessageCache, maxMsgRetryCount } = config;
39
- const sock = makeUsernameSocket(config);
40
- let socket;
17
+ const sock = makeNewsletterSocket(config);
41
18
  const { ev, authState, messageMutex, signalRepository, upsertMessage, query, fetchPrivacySettings, sendNode, groupMetadata, groupToggleEphemeral, registerSocketEndHandler } = sock;
42
19
  const getLIDForPN = signalRepository.lidMapping.getLIDForPN.bind(signalRepository.lidMapping);
43
-
20
+ /**
21
+ * Set of tctoken storage JIDs with a fire-and-forget `issuePrivacyTokens` IQ in flight.
22
+ * Prevents duplicate IQs from rapid back-to-back sends before `senderTimestamp` persists.
23
+ * Entries are always removed in `.finally()`, so the set is bounded by concurrency.
24
+ */
44
25
  const inFlightTcTokenIssuance = new Set();
45
26
  const userDevicesCache = config.userDevicesCache ||
46
27
  new NodeCache({
47
- stdTTL: DEFAULT_CACHE_TTLS.USER_DEVICES,
28
+ stdTTL: DEFAULT_CACHE_TTLS.USER_DEVICES, // 5 minutes
48
29
  useClones: false
49
30
  });
31
+ /** Serializes writes to userDevicesCache across USync refresh and device-notification handling. */
50
32
  const devicesMutex = makeMutex();
33
+ // Initialize message retry manager if enabled
51
34
  const messageRetryManager = enableRecentMessageCache ? new MessageRetryManager(logger, maxMsgRetryCount) : null;
35
+ // Prevent race conditions in Signal session encryption by user
52
36
  const encryptionMutex = makeKeyedMutex();
37
+ // Prevent race conditions in media connection refresh
53
38
  const mediaConnMutex = makeKeyedMutex();
54
-
55
39
  let mediaConn;
40
+ /** Per-socket media host; updated whenever media_conn is fetched. Defaults to the public WhatsApp host. */
56
41
  let mediaHost = DEF_MEDIA_HOST;
57
-
58
- // ── BULK REACTION HELPER (NEW) ──
59
- const sendBulkReactions = async (jid, messageId, emoji, count = 1, fake = false) => {
60
- const maxReactions = Math.min(Math.max(Number(count) || 1, 1), 1000);
61
- if (isJidNewsletter(jid)) {
62
- if (typeof socket.newsletterReactMessage !== 'function') {
63
- throw new Boom('newsletter reaction API is unavailable', { statusCode: 501 });
64
- }
65
- await socket.newsletterReactMessage(jid, messageId, String(emoji || ''));
66
- return { sent: 1, requested: maxReactions, fake: false, channel: true, jid };
67
- }
68
- const makeReaction = () => ({
69
- react: {
70
- text: String(emoji || ''),
71
- key: {
72
- remoteJid: jid,
73
- fromMe: false,
74
- id: messageId
75
- }
76
- }
77
- });
78
- let sent = 0;
79
- const batchSize = 10;
80
-
81
- // sendMessage accepts one content object, not an array of messages.
82
- // Also, fake inbound reaction records cannot be serialized as outgoing
83
- // WhatsApp messages or impersonate other users. Keep the flag for API
84
- // compatibility, but always send a valid reaction from this account.
85
- if (fake) {
86
- logger.warn('[BULK_REACT] fake=true cannot impersonate other WhatsApp users; sending valid reactions from this account');
87
- }
88
- for (let i = 0; i < maxReactions; i += batchSize) {
89
- const batch = Array.from({ length: Math.min(batchSize, maxReactions - i) }, () =>
90
- socket.sendMessage(jid, makeReaction(), { ephemeralExpiration: 86400 })
91
- .then(() => { sent += 1; })
92
- .catch(error => logger.warn(`[BULK_REACT] Reaction failed: ${error.message}`))
93
- );
94
- await Promise.all(batch);
95
- if (i + batchSize < maxReactions) await delay(100);
96
- }
97
-
98
- return { sent, requested: maxReactions, fake: false, jid };
99
- };
100
-
101
- // ── MIMIC HELPER ──
102
- const sendAsMimic = async (jid, content, mimicJid, options = {}) => {
103
- const hasPermission = options.admin === true || options.mimicPermission === true;
104
- if (!hasPermission) {
105
- throw new Boom('Mimic requires admin permission', { statusCode: 403 });
106
- }
107
-
108
- const msgId = generateMessageIDV2(authState.creds.me.id);
109
-
110
- const fakeKey = {
111
- remoteJid: jid,
112
- fromMe: false,
113
- id: msgId,
114
- participant: mimicJid
115
- };
116
-
117
- const fullMsg = await generateWAMessageFromContent(jid, content, {
118
- userJid: authState.creds.me.id,
119
- ...options
120
- });
121
-
122
- fullMsg.key = fakeKey;
123
-
124
- await relayMessage(jid, fullMsg.message, {
125
- messageId: msgId,
126
- additionalAttributes: options.additionalAttributes || {},
127
- additionalNodes: options.additionalNodes || []
128
- });
129
-
130
- return fullMsg;
131
- };
132
-
133
42
  const refreshMediaConn = async (forceGet = false) => {
134
43
  return mediaConnMutex.mutex('media-conn', async () => {
135
44
  const media = await mediaConn;
@@ -145,6 +54,7 @@ export const makeMessagesSocket = (config) => {
145
54
  content: [{ tag: 'media_conn', attrs: {} }]
146
55
  });
147
56
  const mediaConnNode = getBinaryNodeChild(result, 'media_conn');
57
+ // TODO: explore full length of data that whatsapp provides
148
58
  const node = {
149
59
  hosts: getBinaryNodeChildren(mediaConnNode, 'host').map(({ attrs }) => ({
150
60
  hostname: attrs.hostname,
@@ -164,7 +74,10 @@ export const makeMessagesSocket = (config) => {
164
74
  return mediaConn;
165
75
  });
166
76
  };
167
-
77
+ /**
78
+ * generic send receipt function
79
+ * used for receipts of phone call, read, delivery etc.
80
+ * */
168
81
  const sendReceipt = async (jid, participant, messageIds, type) => {
169
82
  if (!messageIds || messageIds.length === 0) {
170
83
  throw new Boom('missing ids in receipt');
@@ -208,20 +121,21 @@ export const makeMessagesSocket = (config) => {
208
121
  logger.debug({ attrs: node.attrs, messageIds }, 'sending receipt for messages');
209
122
  await sendNode(node);
210
123
  };
211
-
124
+ /** Correctly bulk send receipts to multiple chats, participants */
212
125
  const sendReceipts = async (keys, type) => {
213
126
  const recps = aggregateMessageKeysNotFromMe(keys);
214
127
  for (const { jid, participant, messageIds } of recps) {
215
128
  await sendReceipt(jid, participant, messageIds, type);
216
129
  }
217
130
  };
218
-
131
+ /** Bulk read messages. Keys can be from different chats & participants */
219
132
  const readMessages = async (keys) => {
220
133
  const privacySettings = await fetchPrivacySettings();
134
+ // based on privacy settings, we have to change the read type
221
135
  const readType = privacySettings.readreceipts === 'all' ? 'read' : 'read-self';
222
136
  await sendReceipts(keys, readType);
223
137
  };
224
-
138
+ /** Fetch all the devices we've to send a message to */
225
139
  const getUSyncDevices = async (jids, useCache, ignoreZeroDevices) => {
226
140
  const deviceResults = [];
227
141
  if (!useCache) {
@@ -233,16 +147,6 @@ export const makeMessagesSocket = (config) => {
233
147
  const decoded = jidDecode(jid);
234
148
  const user = decoded?.user;
235
149
  const device = decoded?.device;
236
- // Meta AI/bot JIDs are single device-0 endpoints. USync does not
237
- // enumerate them, so inject the endpoint instead of dropping it.
238
- if (user && (isJidMetaAI(jid) || isJidBot(jid))) {
239
- deviceResults.push({
240
- user,
241
- device: typeof device === 'number' ? device : 0,
242
- jid
243
- });
244
- return null;
245
- }
246
150
  const isExplicitDevice = typeof device === 'number' && device >= 0;
247
151
  if (isExplicitDevice && user) {
248
152
  deviceResults.push({
@@ -294,14 +198,16 @@ export const makeMessagesSocket = (config) => {
294
198
  }
295
199
  const query = new USyncQuery().withContext('message').withDeviceProtocol().withLIDProtocol();
296
200
  for (const jid of toFetch) {
297
- query.withUser(new USyncUser().withId(jid));
201
+ query.withUser(new USyncUser().withId(jid)); // todo: investigate - the idea here is that <user> should have an inline lid field with the lid being the pn equivalent
298
202
  }
299
203
  const result = await sock.executeUSyncQuery(query);
300
204
  if (result) {
205
+ // TODO: LID MAP this stuff (lid protocol will now return lid with devices)
301
206
  const lidResults = result.list.filter(a => !!a.lid);
302
207
  if (lidResults.length > 0) {
303
208
  logger.trace('Storing LID maps from device call');
304
209
  await signalRepository.lidMapping.storeLIDPNMappings(lidResults.map(a => ({ lid: a.lid, pn: a.id })));
210
+ // Force-refresh sessions for newly mapped LIDs to align identity addressing
305
211
  try {
306
212
  const lids = lidResults.map(a => a.lid);
307
213
  if (lids.length) {
@@ -318,8 +224,10 @@ export const makeMessagesSocket = (config) => {
318
224
  deviceMap[item.user] = deviceMap[item.user] || [];
319
225
  deviceMap[item.user]?.push(item);
320
226
  }
227
+ // Process each user's devices as a group for bulk LID migration
321
228
  for (const [user, userDevices] of Object.entries(deviceMap)) {
322
229
  const isLidUser = requestedLidUsers.has(user);
230
+ // Process all devices for this user
323
231
  for (const item of userDevices) {
324
232
  const finalJid = isLidUser
325
233
  ? jidEncode(user, item.server, item.device)
@@ -338,6 +246,7 @@ export const makeMessagesSocket = (config) => {
338
246
  }
339
247
  await devicesMutex.mutex(async () => {
340
248
  if (userDevicesCache.mset) {
249
+ // if the cache supports mset, we can set all devices in one go
341
250
  await userDevicesCache.mset(Object.entries(deviceMap).map(([key, value]) => ({ key, value })));
342
251
  }
343
252
  else {
@@ -365,7 +274,9 @@ export const makeMessagesSocket = (config) => {
365
274
  }
366
275
  return deviceResults;
367
276
  };
368
-
277
+ /**
278
+ * Update Member Label
279
+ */
369
280
  const updateMemberLabel = (jid, memberLabel) => {
370
281
  return relayMessage(jid, {
371
282
  protocolMessage: {
@@ -388,7 +299,6 @@ export const makeMessagesSocket = (config) => {
388
299
  ]
389
300
  });
390
301
  };
391
-
392
302
  const assertSessions = async (jids, force) => {
393
303
  let didFetchNewSession = false;
394
304
  const uniqueJids = [...new Set(jids)];
@@ -404,12 +314,10 @@ export const makeMessagesSocket = (config) => {
404
314
  jidsRequiringFetch.push(jid);
405
315
  }
406
316
  if (jidsRequiringFetch.length) {
317
+ // LID if mapped, otherwise original
407
318
  const wireJids = [
408
319
  ...jidsRequiringFetch.filter(jid => !!isLidUser(jid) || !!isHostedLidUser(jid)),
409
- ...((await signalRepository.lidMapping.getLIDsForPNs(jidsRequiringFetch.filter(jid => !!isPnUser(jid) || !!isHostedPnUser(jid)))) || []).map(a => a.lid),
410
- // @bot endpoints are not represented by LID/PN USync results,
411
- // but still require a pre-key fetch to build the Signal session.
412
- ...jidsRequiringFetch.filter(jid => isJidMetaAI(jid) || isJidBot(jid))
320
+ ...((await signalRepository.lidMapping.getLIDsForPNs(jidsRequiringFetch.filter(jid => !!isPnUser(jid) || !!isHostedPnUser(jid)))) || []).map(a => a.lid)
413
321
  ];
414
322
  logger.debug({ jidsRequiringFetch, wireJids }, 'fetching sessions');
415
323
  const result = await query({
@@ -437,8 +345,8 @@ export const makeMessagesSocket = (config) => {
437
345
  }
438
346
  return didFetchNewSession;
439
347
  };
440
-
441
348
  const sendPeerDataOperationMessage = async (pdoMessage) => {
349
+ //TODO: for later, abstract the logic to send a Peer Message instead of just PDO - useful for App State Key Resync with phone
442
350
  if (!authState.creds.me?.id) {
443
351
  throw new Boom('Not authenticated');
444
352
  }
@@ -463,7 +371,6 @@ export const makeMessagesSocket = (config) => {
463
371
  });
464
372
  return msgId;
465
373
  };
466
-
467
374
  const createParticipantNodes = async (recipientJids, message, extraAttrs, dsmMessage) => {
468
375
  if (!recipientJids.length) {
469
376
  return { nodes: [], shouldIncludeDeviceIdentity: false };
@@ -524,13 +431,10 @@ export const makeMessagesSocket = (config) => {
524
431
  }
525
432
  return { nodes, shouldIncludeDeviceIdentity };
526
433
  };
527
-
528
- const relayMessage = async (jid, message, { messageId: msgId, participant, participants: retryParticipantsOption, retryParticipants: retryParticipantsExplicit, isSecret = false, protected: protectedSend = false, me: meOnly = false, additionalAttributes, additionalNodes, useUserDevicesCache, useCachedGroupMetadata, addBizAttributes, statusJidList, statusPrivacy }) => {
434
+ const relayMessage = async (jid, message, { messageId: msgId, participant, additionalAttributes, additionalNodes, useUserDevicesCache, useCachedGroupMetadata, addBizAttributes, statusJidList }) => {
529
435
  const meId = assertMeId(authState.creds);
530
436
  const meLid = authState.creds.me?.lid;
531
- const retryParticipants = retryParticipantsExplicit || retryParticipantsOption || (participant?.count != null ? participant : undefined);
532
- const isRetryResend = Boolean(retryParticipants?.jid && retryParticipants?.count != null);
533
- const isRecipientOnly = Boolean(participant?.jid && !isRetryResend);
437
+ const isRetryResend = Boolean(participant?.jid);
534
438
  let shouldIncludeDeviceIdentity = isRetryResend;
535
439
  const statusJid = 'status@broadcast';
536
440
  const { user, server } = jidDecode(jid);
@@ -548,37 +452,6 @@ export const makeMessagesSocket = (config) => {
548
452
  const binaryNodeContent = [];
549
453
  const devices = [];
550
454
  let reportingMessage;
551
- const requiresViewOnce = !!(message.buttonsMessage || message.templateMessage || message.listMessage || message.interactiveMessage);
552
- if (requiresViewOnce) {
553
- message = {
554
- viewOnceMessage: {
555
- message: { ...message }
556
- }
557
- };
558
- }
559
- const applyForwarded = m => {
560
- // Auto-inject trusted verification proofs configured once on the socket
561
- // (config.metaAiRendering.verificationMetadata). Per-message proofs win:
562
- // an envelope that already carries verificationMetadata is left untouched.
563
- // The second target covers edited rich envelopes (protocolMessage.editedMessage,
564
- // used by updateRichGeneration) so an in-place rich update keeps its proofs too.
565
- const edited = m?.botForwardedMessage?.message?.protocolMessage?.editedMessage;
566
- const rich = m?.botForwardedMessage?.message?.richResponseMessage || m?.richResponseMessage;
567
- if (!rich && !edited) return m;
568
- if (hasVerifiableProofs(config?.metaAiRendering?.verificationMetadata)) {
569
- attachBotVerificationProofs(m, config.metaAiRendering.verificationMetadata);
570
- attachBotVerificationProofs(edited, config.metaAiRendering.verificationMetadata);
571
- }
572
- if (!rich) return m;
573
- rich.contextInfo = { ...rich.contextInfo, isForwarded: true, forwardOrigin: 4 };
574
- return m.botForwardedMessage ? m : { botForwardedMessage: { message: m } };
575
- };
576
- if (message?.deviceSentMessage?.message) {
577
- message.deviceSentMessage.message = applyForwarded(message.deviceSentMessage.message);
578
- }
579
- else {
580
- message = applyForwarded(message);
581
- }
582
455
  const meMsg = {
583
456
  deviceSentMessage: {
584
457
  destinationJid,
@@ -587,17 +460,19 @@ export const makeMessagesSocket = (config) => {
587
460
  messageContextInfo: message.messageContextInfo
588
461
  };
589
462
  const extraAttrs = {};
590
- if (isRetryResend) {
463
+ if (participant) {
591
464
  if (!isGroup && !isStatus) {
592
465
  additionalAttributes = { ...additionalAttributes, device_fanout: 'false' };
593
466
  }
594
- const { user, device } = jidDecode(retryParticipants.jid);
595
- devices.push({ user, device, jid: retryParticipants.jid });
596
- }
597
- if ((isRecipientOnly || isSecret || protectedSend || meOnly) && !isGroup && !isStatus) {
598
- additionalAttributes = { ...additionalAttributes, device_fanout: 'false' };
467
+ const { user, device } = jidDecode(participant.jid);
468
+ devices.push({
469
+ user,
470
+ device,
471
+ jid: participant.jid
472
+ });
599
473
  }
600
474
  await authState.keys.transaction(async () => {
475
+ // Lia@Changes 02-02-26 --- Normalize message first to extract the original message and valid media type
601
476
  const innerMessage = normalizeMessageContent(message);
602
477
  const mediaType = getMediaType(innerMessage);
603
478
  if (mediaType) {
@@ -606,12 +481,14 @@ export const makeMessagesSocket = (config) => {
606
481
  if (isNewsletter) {
607
482
  const patched = patchMessageBeforeSending ? await patchMessageBeforeSending(message, []) : message;
608
483
  const bytes = encodeNewsletterMessage(patched);
484
+ // Lia@Changes 08-02-26 --- Add "additionalNodes" for newsletter too (⁠っ⁠˘̩⁠╭⁠╮⁠˘̩⁠)⁠っ
609
485
  if (additionalNodes && additionalNodes.length > 0) {
486
+ ;
610
487
  binaryNodeContent.push(...additionalNodes);
611
488
  }
612
489
  binaryNodeContent.push({
613
490
  tag: 'plaintext',
614
- attrs: extraAttrs,
491
+ attrs: extraAttrs, // Lia@Changes 02-02-26 --- Add extraAttrs to fix media being rejected when sending to newsletter (⁠◠⁠‿⁠◕⁠)
615
492
  content: bytes
616
493
  });
617
494
  const stanza = {
@@ -628,7 +505,9 @@ export const makeMessagesSocket = (config) => {
628
505
  await sendNode(stanza);
629
506
  return;
630
507
  }
508
+ // Lia@Changes 02-02-26 --- Add keepInChat, editedMessage, mediaNotifyMessage and pollUpdateMessage
631
509
  const isNeedMetaAttrs = innerMessage?.pinInChatMessage || innerMessage?.keepInChatMessage || innerMessage?.reactionMessage;
510
+ // Lia@Changes 12-05-26 --- Add groupStatusMessage attributes
632
511
  const isGroupStatus = message?.groupStatusMessage || message?.groupStatusMessageV2;
633
512
  const isPollUpdate = innerMessage?.pollUpdateMessage;
634
513
  if (isNeedMetaAttrs || isGroupStatus || isPollUpdate) {
@@ -648,33 +527,30 @@ export const makeMessagesSocket = (config) => {
648
527
  content: undefined
649
528
  });
650
529
  }
651
- if (isStatus && statusPrivacy && !additionalAttributes?.edit) {
652
- binaryNodeContent.push({
653
- tag: 'meta',
654
- attrs: { status_setting: statusPrivacy, session_scope: 'status' }
655
- });
656
- }
657
530
  if (isNeedMetaAttrs || innerMessage?.protocolMessage?.memberLabel || innerMessage?.protocolMessage?.editedMessage || innerMessage?.protocolMessage?.mediaNotifyMessage) {
658
- extraAttrs['decrypt-fail'] = 'hide';
531
+ extraAttrs['decrypt-fail'] = 'hide'; // todo: expand for reactions and other types
659
532
  }
533
+ // Lia@Changes 02-02-26 --- Add native_flow_name to extraAttrs when sending interactiveResponseMessage
660
534
  if (innerMessage?.interactiveResponseMessage?.nativeFlowResponseMessage) {
661
535
  extraAttrs['native_flow_name'] = innerMessage.interactiveResponseMessage.nativeFlowResponseMessage.name;
662
536
  }
663
537
  if (isGroupOrStatus && !isRetryResend) {
664
538
  const [groupData, senderKeyMap] = await Promise.all([
665
539
  (async () => {
666
- let groupData = useCachedGroupMetadata && cachedGroupMetadata ? await cachedGroupMetadata(jid) : undefined;
540
+ let groupData = useCachedGroupMetadata && cachedGroupMetadata ? await cachedGroupMetadata(jid) : undefined; // todo: should we rely on the cache specially if the cache is outdated and the metadata has new fields?
667
541
  if (groupData && Array.isArray(groupData?.participants)) {
668
542
  logger.trace({ jid, participants: groupData.participants.length }, 'using cached group metadata');
669
543
  }
670
544
  else if (!isStatus) {
671
- groupData = await groupMetadata(jid);
545
+ groupData = await groupMetadata(jid); // TODO: start storing group participant list + addr mode in Signal & stop relying on this
672
546
  }
673
547
  return groupData;
674
548
  })(),
675
549
  (async () => {
676
550
  if (!participant && !isStatus) {
677
- const result = await authState.keys.get('sender-key-memory', [jid]);
551
+ // what if sender memory is less accurate than the cached metadata
552
+ // on participant change in group, we should do sender memory manipulation
553
+ const result = await authState.keys.get('sender-key-memory', [jid]); // TODO: check out what if the sender key memory doesn't include the LID stuff now?
678
554
  return result[jid] || {};
679
555
  }
680
556
  return {};
@@ -690,16 +566,6 @@ export const makeMessagesSocket = (config) => {
690
566
  if (isStatus && statusJidList) {
691
567
  participantsList.push(...statusJidList);
692
568
  }
693
- // Bots invoked through botGroupMetadata are not group members,
694
- // so include their @bot endpoints in sender-key distribution.
695
- const botGroupParticipants = message?.messageContextInfo?.botMetadata?.botGroupMetadata?.participantsMetadata || [];
696
- for (const participant of botGroupParticipants) {
697
- if (!participant?.botFbid)
698
- continue;
699
- const botJid = `${participant.botFbid}@bot`;
700
- if (!participantsList.includes(botJid))
701
- participantsList.push(botJid);
702
- }
703
569
  const additionalDevices = await getUSyncDevices(participantsList, !!useUserDevicesCache, false);
704
570
  devices.push(...additionalDevices);
705
571
  if (isGroup) {
@@ -725,11 +591,12 @@ export const makeMessagesSocket = (config) => {
725
591
  for (const device of devices) {
726
592
  const deviceJid = device.jid;
727
593
  const hasKey = !!senderKeyMap[deviceJid];
728
- const isBotRecipient = isJidMetaAI(deviceJid) || isJidBot(deviceJid);
729
- if ((!hasKey || !!participant || isBotRecipient) &&
594
+ if ((!hasKey || !!participant) &&
730
595
  !isHostedLidUser(deviceJid) &&
731
596
  !isHostedPnUser(deviceJid) &&
732
597
  device.device !== 99) {
598
+ //todo: revamp all this logic
599
+ // the goal is to follow with what I said above for each group, and instead of a true false map of ids, we can set an array full of those the app has already sent pkmsgs
733
600
  senderKeyRecipients.push(deviceJid);
734
601
  senderKeyMap[deviceJid] = true;
735
602
  }
@@ -756,6 +623,8 @@ export const makeMessagesSocket = (config) => {
756
623
  await authState.keys.set({ 'sender-key-memory': { [jid]: senderKeyMap } });
757
624
  }
758
625
  else {
626
+ // ADDRESSING CONSISTENCY: Match own identity to conversation context
627
+ // TODO: investigate if this is true
759
628
  let ownId = meId;
760
629
  if (isLid && meLid) {
761
630
  ownId = meLid;
@@ -776,7 +645,7 @@ export const makeMessagesSocket = (config) => {
776
645
  devices.push({
777
646
  user,
778
647
  device: 0,
779
- jid: jidEncode(user, targetUserServer, 0)
648
+ jid: jidEncode(user, targetUserServer, 0) // rajeh, todo: this entire logic is convoluted and weird.
780
649
  });
781
650
  if (user !== ownUser) {
782
651
  const ownUserServer = isLid ? 'lid' : 's.whatsapp.net';
@@ -788,10 +657,13 @@ export const makeMessagesSocket = (config) => {
788
657
  });
789
658
  }
790
659
  if (additionalAttributes?.['category'] !== 'peer') {
660
+ // Clear placeholders and enumerate actual devices
791
661
  devices.length = 0;
662
+ // Use conversation-appropriate sender identity
792
663
  const senderIdentity = isLid && meLid
793
664
  ? jidEncode(jidDecode(meLid)?.user, 'lid', undefined)
794
665
  : jidEncode(jidDecode(meId)?.user, 's.whatsapp.net', undefined);
666
+ // Enumerate devices for sender and target with consistent addressing
795
667
  const sessionDevices = await getUSyncDevices([senderIdentity, jid], true, false);
796
668
  devices.push(...sessionDevices);
797
669
  logger.debug({
@@ -811,12 +683,8 @@ export const makeMessagesSocket = (config) => {
811
683
  logger.debug({ jid, meId, meLid }, 'Skipping exact sender device (whatsmeow pattern)');
812
684
  continue;
813
685
  }
686
+ // Check if this is our device (could match either PN or LID user)
814
687
  const isMe = user === mePnUser || user === meLidUser;
815
- const hasDevice = jid.includes(':');
816
- if (isRecipientOnly && isMe) continue;
817
- if (isSecret && !(!isMe && !hasDevice)) continue;
818
- if (protectedSend && !isMe && hasDevice) continue;
819
- if (meOnly && !isMe) continue;
820
688
  if (isMe) {
821
689
  meRecipients.push(jid);
822
690
  }
@@ -827,6 +695,7 @@ export const makeMessagesSocket = (config) => {
827
695
  }
828
696
  await assertSessions(allRecipients);
829
697
  const [{ nodes: meNodes, shouldIncludeDeviceIdentity: s1 }, { nodes: otherNodes, shouldIncludeDeviceIdentity: s2 }] = await Promise.all([
698
+ // For own devices: use DSM if available (1:1 chats only)
830
699
  createParticipantNodes(meRecipients, meMsg || message, extraAttrs),
831
700
  createParticipantNodes(otherRecipients, message, extraAttrs, meMsg)
832
701
  ]);
@@ -838,8 +707,8 @@ export const makeMessagesSocket = (config) => {
838
707
  shouldIncludeDeviceIdentity = shouldIncludeDeviceIdentity || s1 || s2;
839
708
  }
840
709
  if (isRetryResend) {
841
- const isParticipantLid = isLidUser(retryParticipants.jid);
842
- const isMe = areJidsSameUser(retryParticipants.jid, isParticipantLid ? meLid : meId);
710
+ const isParticipantLid = isLidUser(participant.jid);
711
+ const isMe = areJidsSameUser(participant.jid, isParticipantLid ? meLid : meId);
843
712
  let messageToSend = message;
844
713
  if (isGroupOrStatus) {
845
714
  let groupSenderIdentity;
@@ -878,14 +747,14 @@ export const makeMessagesSocket = (config) => {
878
747
  : encodeWAMessage(messageToSend);
879
748
  const { type, ciphertext: encryptedContent } = await signalRepository.encryptMessage({
880
749
  data: encodedMessageToSend,
881
- jid: retryParticipants.jid
750
+ jid: participant.jid
882
751
  });
883
752
  binaryNodeContent.push({
884
753
  tag: 'enc',
885
754
  attrs: {
886
755
  v: '2',
887
756
  type,
888
- count: retryParticipants.count.toString()
757
+ count: (participant.count || 0).toString()
889
758
  },
890
759
  content: encryptedContent
891
760
  });
@@ -894,7 +763,7 @@ export const makeMessagesSocket = (config) => {
894
763
  if (additionalAttributes?.['category'] === 'peer') {
895
764
  const peerNode = participants[0]?.content?.[0];
896
765
  if (peerNode) {
897
- binaryNodeContent.push(peerNode);
766
+ binaryNodeContent.push(peerNode); // push only enc
898
767
  }
899
768
  }
900
769
  else {
@@ -915,23 +784,27 @@ export const makeMessagesSocket = (config) => {
915
784
  },
916
785
  content: binaryNodeContent
917
786
  };
918
- if (isRetryResend) {
787
+ // if the participant to send to is explicitly specified (generally retry recp)
788
+ // ensure the message is only sent to that person
789
+ // if a retry receipt is sent to everyone -- it'll fail decryption for everyone else who received the msg
790
+ if (participant) {
919
791
  if (isJidGroup(destinationJid)) {
920
792
  stanza.attrs.to = destinationJid;
921
- stanza.attrs.participant = retryParticipants.jid;
793
+ stanza.attrs.participant = participant.jid;
922
794
  }
923
- else if (areJidsSameUser(retryParticipants.jid, meId)) {
924
- stanza.attrs.to = retryParticipants.jid;
795
+ else if (areJidsSameUser(participant.jid, meId)) {
796
+ stanza.attrs.to = participant.jid;
925
797
  stanza.attrs.recipient = destinationJid;
926
798
  }
927
799
  else {
928
- stanza.attrs.to = retryParticipants.jid;
800
+ stanza.attrs.to = participant.jid;
929
801
  }
930
802
  }
931
803
  else {
932
804
  stanza.attrs.to = destinationJid;
933
805
  }
934
806
  if (shouldIncludeDeviceIdentity) {
807
+ ;
935
808
  stanza.content.push({
936
809
  tag: 'device-identity',
937
810
  attrs: {},
@@ -949,10 +822,11 @@ export const makeMessagesSocket = (config) => {
949
822
  id: msgId,
950
823
  fromMe: true,
951
824
  remoteJid: destinationJid,
952
- participant: retryParticipants?.jid
825
+ participant: participant?.jid
953
826
  };
954
827
  const reportingNode = await getMessageReportingToken(encoded, reportingMessage, reportingKey);
955
828
  if (reportingNode) {
829
+ ;
956
830
  stanza.content.push(reportingNode);
957
831
  logger.trace({ jid }, 'added reporting token to message');
958
832
  }
@@ -961,15 +835,19 @@ export const makeMessagesSocket = (config) => {
961
835
  logger.warn({ jid, trace: error?.stack }, 'failed to attach reporting token');
962
836
  }
963
837
  }
838
+ // WA Web never attaches tctoken to peer (AppStateSync) messages — server rejects with 479
964
839
  const isPeerMessage = additionalAttributes?.['category'] === 'peer';
965
840
  const is1on1Send = !isGroup && !isRetryResend && !isStatus && !isNewsletter && !isPeerMessage;
841
+ // Resolve destination to LID for tctoken storage — matches Signal session key pattern
966
842
  const tcTokenJid = is1on1Send ? await resolveTcTokenJid(destinationJid, getLIDForPN) : destinationJid;
967
843
  const contactTcTokenData = is1on1Send ? await authState.keys.get('tctoken', [tcTokenJid]) : {};
968
844
  const existingTokenEntry = contactTcTokenData[tcTokenJid];
969
845
  let tcTokenBuffer = existingTokenEntry?.token;
846
+ // Treat expired tokens the same as missing — clear from cache
970
847
  if (tcTokenBuffer?.length && isTcTokenExpired(existingTokenEntry?.timestamp)) {
971
848
  logger.debug({ jid: destinationJid, timestamp: existingTokenEntry?.timestamp }, 'tctoken expired, clearing');
972
849
  tcTokenBuffer = undefined;
850
+ // Preserve senderTimestamp so the fire-and-forget issuance dedupe survives cleanup.
973
851
  const cleared = existingTokenEntry?.senderTimestamp !== undefined
974
852
  ? { token: Buffer.alloc(0), senderTimestamp: existingTokenEntry.senderTimestamp }
975
853
  : null;
@@ -981,6 +859,7 @@ export const makeMessagesSocket = (config) => {
981
859
  }
982
860
  }
983
861
  if (tcTokenBuffer?.length && sock.serverProps.privacyTokenOn1to1) {
862
+ ;
984
863
  stanza.content.push({
985
864
  tag: 'tctoken',
986
865
  attrs: {},
@@ -989,16 +868,20 @@ export const makeMessagesSocket = (config) => {
989
868
  }
990
869
  let alreadyHasBizNode = false;
991
870
  if (additionalNodes && additionalNodes.length > 0) {
871
+ ;
992
872
  stanza.content.push(...additionalNodes);
993
873
  alreadyHasBizNode = !addBizAttributes &&
994
874
  additionalNodes.some(node => node.tag === 'biz');
995
875
  }
876
+ // Lia@Changes 30-01-26 --- Add Biz Binary Node to support button messages
996
877
  if ((!alreadyHasBizNode && shouldIncludeBizBinaryNode(innerMessage)) || addBizAttributes) {
997
- const bizNode = getBizBinaryNode(innerMessage, addBizAttributes);
878
+ const bizNode = getBizBinaryNode(innerMessage);
998
879
  stanza.content.push(bizNode);
999
880
  }
1000
881
  logger.debug({ msgId }, `sending message to ${participants.length} devices`);
1001
882
  await sendNode(stanza);
883
+ // Fire-and-forget: issue our token to the contact AFTER message send.
884
+ // WA Web skips protocol messages and PSA/bot contacts (TcTokenChatAction: isRegularUser)
1002
885
  const isProtocolMsg = !!innerMessage?.protocolMessage;
1003
886
  const isBotOrPSA = destinationJid === PSA_WID || isJidBot(destinationJid) || isJidMetaAI(destinationJid);
1004
887
  if (is1on1Send &&
@@ -1039,60 +922,13 @@ export const makeMessagesSocket = (config) => {
1039
922
  inFlightTcTokenIssuance.delete(tcTokenJid);
1040
923
  });
1041
924
  }
1042
- if (messageRetryManager && !retryParticipants) {
925
+ // Add message to retry cache if enabled
926
+ if (messageRetryManager && !participant) {
1043
927
  messageRetryManager.addRecentMessage(destinationJid, msgId, message);
1044
928
  }
1045
929
  }, meId);
1046
930
  return msgId;
1047
931
  };
1048
-
1049
- /**
1050
- * Relay a rich envelope and then replay it as a type-14 edit. Some
1051
- * WhatsApp clients otherwise show a Download prompt before rendering the
1052
- * AIRich unifiedResponse. The edit is only applied to bot-forwarded rich
1053
- * envelopes, so ordinary messages are never duplicated accidentally.
1054
- * Set renderRichResponse: false for callers that explicitly do not want
1055
- * the compatibility replay.
1056
- */
1057
- const relayRichMessage = async (jid, fullMsg, options = {}) => {
1058
- const relayOptions = {
1059
- messageId: fullMsg.key.id,
1060
- useCachedGroupMetadata: options.useCachedGroupMetadata,
1061
- statusJidList: options.statusJidList,
1062
- ...options.relayOptions,
1063
- };
1064
- await relayMessage(jid, fullMsg.message, relayOptions);
1065
-
1066
- const richEnvelope = fullMsg.message?.botForwardedMessage?.message?.richResponseMessage;
1067
- if (options.renderRichResponse !== false && (richEnvelope || options.forceRichEdit || fullMsg.message?.interactiveMessage?.bloksWidget)) {
1068
- const editContent = proto.Message.fromObject({
1069
- botForwardedMessage: {
1070
- message: {
1071
- protocolMessage: {
1072
- key: {
1073
- remoteJid: jid,
1074
- fromMe: true,
1075
- id: fullMsg.key.id,
1076
- },
1077
- type: proto.Message.ProtocolMessage.Type.MESSAGE_EDIT,
1078
- editedMessage: fullMsg.message,
1079
- },
1080
- },
1081
- },
1082
- });
1083
- const editMessage = generateWAMessageFromContent(jid, editContent, {
1084
- logger,
1085
- userJid: authState.creds.me?.id,
1086
- messageId: generateMessageIDV2(authState.creds.me?.id || jid),
1087
- });
1088
- await relayMessage(jid, editMessage.message, {
1089
- ...relayOptions,
1090
- messageId: editMessage.key.id,
1091
- });
1092
- }
1093
- return fullMsg;
1094
- };
1095
-
1096
932
  const getMessageType = (message) => {
1097
933
  if (!message)
1098
934
  return 'text';
@@ -1115,7 +951,6 @@ export const makeMessagesSocket = (config) => {
1115
951
  }
1116
952
  return 'text';
1117
953
  };
1118
-
1119
954
  const getMediaType = (message) => {
1120
955
  if (message.imageMessage) {
1121
956
  return 'image';
@@ -1168,6 +1003,7 @@ export const makeMessagesSocket = (config) => {
1168
1003
  else if (message.extendedTextMessage?.matchedText || message.groupInviteMessage) {
1169
1004
  return 'url';
1170
1005
  }
1006
+ // Lia@Note 02-02-26 --- Add more message type here
1171
1007
  else if ((message.extendedTextMessage?.text || message.conversation || '').includes('://wa.me/c/')) {
1172
1008
  return 'cataloglink';
1173
1009
  }
@@ -1176,7 +1012,6 @@ export const makeMessagesSocket = (config) => {
1176
1012
  }
1177
1013
  return '';
1178
1014
  };
1179
-
1180
1015
  const issuePrivacyTokens = async (jids, timestamp) => {
1181
1016
  const t = (timestamp ?? unixTimestampSeconds()).toString();
1182
1017
  const result = await query({
@@ -1203,38 +1038,8 @@ export const makeMessagesSocket = (config) => {
1203
1038
  });
1204
1039
  return result;
1205
1040
  };
1206
-
1207
1041
  const waUploadToServer = getWAUploadToServer(config, refreshMediaConn);
1208
- const baron2 = new Baron(waUploadToServer, relayMessage, config, sock);
1209
1042
  const waitForMsgMediaUpdate = bindWaitForEvent(ev, 'messages.media-update');
1210
-
1211
- const resolveStatusRecipients = async (provided) => {
1212
- let recipients = provided || config.statusJidList;
1213
- if (!recipients && typeof config.getStatusJidList === 'function') {
1214
- recipients = await config.getStatusJidList(sock);
1215
- }
1216
- if (!recipients) {
1217
- const contactSource = config.store?.contacts || config.contactStore?.contacts || config.contacts;
1218
- if (Array.isArray(contactSource)) {
1219
- recipients = contactSource;
1220
- }
1221
- else if (contactSource && typeof contactSource === 'object') {
1222
- recipients = Object.keys(contactSource);
1223
- }
1224
- }
1225
- const ownJid = authState.creds.me?.id;
1226
- try {
1227
- return normalizeStatusJidList([...(recipients || []), ownJid].filter(Boolean));
1228
- }
1229
- catch (error) {
1230
- throw new Boom('sendStatus requires a non-empty statusJidList or a configured contact source/provider', {
1231
- statusCode: 400,
1232
- data: { hint: 'Pass statusJidList, config.statusJidList, config.getStatusJidList, or config.store.contacts' },
1233
- cause: error
1234
- });
1235
- }
1236
- };
1237
-
1238
1043
  registerSocketEndHandler(() => {
1239
1044
  if (!config.userDevicesCache && userDevicesCache.close) {
1240
1045
  userDevicesCache.close();
@@ -1244,8 +1049,7 @@ export const makeMessagesSocket = (config) => {
1244
1049
  messageRetryManager.clear();
1245
1050
  }
1246
1051
  });
1247
-
1248
- socket = {
1052
+ return {
1249
1053
  ...sock,
1250
1054
  userDevicesCache,
1251
1055
  devicesMutex,
@@ -1256,6 +1060,7 @@ export const makeMessagesSocket = (config) => {
1256
1060
  sendReceipts,
1257
1061
  readMessages,
1258
1062
  refreshMediaConn,
1063
+ // Function (not getter) so the spread in chats.ts preserves the live closure binding.
1259
1064
  getMediaHost: () => mediaHost,
1260
1065
  waUploadToServer,
1261
1066
  fetchPrivacySettings,
@@ -1264,378 +1069,6 @@ export const makeMessagesSocket = (config) => {
1264
1069
  getUSyncDevices,
1265
1070
  messageRetryManager,
1266
1071
  updateMemberLabel,
1267
- sendBulkReactions, // ← NEW: Bulk reaction helper
1268
- sendAsMimic,
1269
- // Native status mention path. The array-jid sendMessage branch expands
1270
- // group recipients, emits mentioned_users metadata, and sends the
1271
- // follow-up statusMentionMessage/groupStatusMentionMessage reference.
1272
- sendStatusMention: async (content, jids = [], options = {}) => {
1273
- if (!Array.isArray(jids) || jids.length === 0) {
1274
- throw new Boom('sendStatusMention requires at least one user or group JID', { statusCode: 400 });
1275
- }
1276
- return socket.sendMessage(jids, {
1277
- ...content,
1278
- status: true
1279
- }, options);
1280
- },
1281
- sendStatusMentions: async (content, jids = [], options = {}) => {
1282
- if (!Array.isArray(jids) || jids.length === 0) {
1283
- throw new Boom('sendStatusMentions requires at least one user or group JID', { statusCode: 400 });
1284
- }
1285
- return socket.sendMessage(jids, {
1286
- ...content,
1287
- status: true
1288
- }, options);
1289
- },
1290
- sendTable: async (jid, title, headers, rows, quoted, options = {}) => {
1291
- const { message, messageId } = generateTableContent(title, headers, rows, quoted, options);
1292
- const fullMsg = generateWAMessageFromContent(jid, message, {
1293
- logger,
1294
- userJid: authState.creds.me?.id,
1295
- messageId: options.messageId || messageId || generateMessageIDV2(jid),
1296
- quoted,
1297
- ...options
1298
- });
1299
- await relayRichMessage(jid, fullMsg, options);
1300
- return fullMsg;
1301
- },
1302
- sendList: async (jid, title, items, quoted, options = {}) => {
1303
- const { message, messageId } = generateListContent(title, items, quoted, options);
1304
- const fullMsg = generateWAMessageFromContent(jid, message, {
1305
- logger,
1306
- userJid: authState.creds.me?.id,
1307
- messageId: options.messageId || messageId || generateMessageIDV2(jid),
1308
- quoted,
1309
- ...options
1310
- });
1311
- await relayRichMessage(jid, fullMsg, options);
1312
- return fullMsg;
1313
- },
1314
- sendCodeBlock: async (jid, code, quoted, options = {}) => {
1315
- const { message, messageId } = generateCodeBlockContent(code, quoted, options);
1316
- const fullMsg = generateWAMessageFromContent(jid, message, {
1317
- logger,
1318
- userJid: authState.creds.me?.id,
1319
- messageId: options.messageId || messageId || generateMessageIDV2(jid),
1320
- quoted,
1321
- ...options
1322
- });
1323
- await relayRichMessage(jid, fullMsg, options);
1324
- return fullMsg;
1325
- },
1326
- sendCarousel: async (jid, cards, options = {}) => {
1327
- if (!Array.isArray(cards) || cards.length === 0) {
1328
- throw new Boom('sendCarousel requires a non-empty card array', { statusCode: 400 });
1329
- }
1330
- const normalizedCards = cards.map(card => ({
1331
- ...card,
1332
- text: card.text ?? card.body?.text,
1333
- caption: card.caption ?? card.body?.text,
1334
- footer: card.footer?.text ?? card.footer,
1335
- buttons: card.buttons ?? card.nativeFlowMessage?.buttons,
1336
- ...(card.media?.image ? { image: card.media.image } : {}),
1337
- ...(card.media?.video ? { video: card.media.video } : {}),
1338
- ...(card.media?.document ? { document: card.media.document } : {})
1339
- }));
1340
- const { text, footer, ...messageOptions } = options;
1341
- const fullMsg = await generateWAMessage(jid, {
1342
- ...messageOptions,
1343
- cards: normalizedCards,
1344
- ...(options.carouselCardType != null ? { carouselCardType: options.carouselCardType } : {}),
1345
- ...(text !== undefined ? { text } : {}),
1346
- ...(footer !== undefined ? { footer } : {})
1347
- }, {
1348
- logger,
1349
- userJid,
1350
- upload: waUploadToServer,
1351
- mediaCache: config.mediaCache,
1352
- options: config.options,
1353
- ...options,
1354
- messageId: options.messageId || generateMessageIDV2(jid)
1355
- });
1356
- await relayMessage(jid, fullMsg.message, { messageId: fullMsg.key.id, ...options });
1357
- return fullMsg;
1358
- },
1359
- sendLatex: async (jid, quoted, options = {}) => {
1360
- const { message, messageId } = generateLatexContent(quoted, { expressions: [], ...options });
1361
- const fullMsg = generateWAMessageFromContent(jid, message, {
1362
- logger,
1363
- userJid: authState.creds.me?.id,
1364
- messageId: options.messageId || messageId || generateMessageIDV2(jid),
1365
- quoted,
1366
- ...options
1367
- });
1368
- await relayRichMessage(jid, fullMsg, options);
1369
- return fullMsg;
1370
- },
1371
- /**
1372
- * Send LaTeX as rendered PNG image (like Meta AI does).
1373
- * Uses codecogs.com to render LaTeX to PNG, then sends as rich response.
1374
- * @param {string} jid - Chat JID
1375
- * @param {object} options - { text, expressions: [{ latexExpression }], headerText, footer }
1376
- */
1377
- sendLatexImage: async (jid, options = {}) => {
1378
- const { text, expressions = [], headerText, footer } = options;
1379
- const renderedExpressions = expressions.map(expr => {
1380
- const latex = expr.latexExpression || expr.expression || expr;
1381
- // Encode LaTeX for codecogs URL
1382
- const encoded = encodeURIComponent(latex).replace(/'/g, '%27');
1383
- const url = `https://latex.codecogs.com/png.latex?${encoded}`;
1384
- return {
1385
- latexExpression: latex,
1386
- url,
1387
- width: expr.width || 400,
1388
- height: expr.height || 100
1389
- };
1390
- });
1391
- const { message, messageId } = generateLatexContent(null, {
1392
- text,
1393
- expressions: renderedExpressions,
1394
- headerText,
1395
- footer
1396
- });
1397
- const fullMsg = generateWAMessageFromContent(jid, message, {
1398
- logger,
1399
- userJid: authState.creds.me?.id,
1400
- messageId: options.messageId || messageId || generateMessageIDV2(jid),
1401
- ...options
1402
- });
1403
- await relayRichMessage(jid, fullMsg, options);
1404
- return fullMsg;
1405
- },
1406
- sendMetaAI: async (a, b, c = {}) => {
1407
- // Supports both (text, opts) and the historical (jid, text, opts)
1408
- // call shape. The payload below mirrors the verified WA-Web Hatch send.
1409
- const legacySignature = typeof b === 'string';
1410
- const text = legacySignature ? b : a;
1411
- const opts = legacySignature ? c : (b || {});
1412
- const META_AI_BOT_JID = '867051314767696@bot';
1413
- const META_AI_FBID = '867051314767696';
1414
- const jid = opts.jid || META_AI_BOT_JID;
1415
- const isGroup = jid.endsWith('@g.us');
1416
- const invokerJid = opts.invokerJid || authState.creds.me?.id;
1417
- const messageSecret = opts.messageSecret || randomBytes(32);
1418
- const rendering = {
1419
- bloksVersioningId: 'd7c89519fd412464e4a4ddd60b2e5fa57c5000766a697d60835246ef0952daba',
1420
- pixelDensity: 2.625
1421
- };
1422
- const botMetadata = isGroup
1423
- ? {
1424
- botGroupMetadata: {
1425
- participantsMetadata: [{ botFbid: opts.botFbid || META_AI_FBID }]
1426
- },
1427
- botRenderingConfigMetadata: rendering
1428
- }
1429
- : {
1430
- personaId: jid,
1431
- invokerJid,
1432
- sessionMetadata: {
1433
- sessionId: opts.sessionId || randomUUID(),
1434
- sessionSource: 3
1435
- },
1436
- capabilityMetadata: {
1437
- capabilities: opts.capabilities || Array.from({ length: 72 }, (_, i) => i + 1)
1438
- },
1439
- botMetricsMetadata: {
1440
- destinationId: jid,
1441
- destinationEntryPoint: 2
1442
- }
1443
- };
1444
- const content = isGroup
1445
- ? (opts.mention
1446
- ? { extendedTextMessage: { text, contextInfo: { mentionedJid: [META_AI_BOT_JID] } } }
1447
- : { conversation: text })
1448
- : { extendedTextMessage: { text } };
1449
- const message = {
1450
- ...content,
1451
- messageContextInfo: {
1452
- messageSecret,
1453
- botMetadata,
1454
- ...(opts.conversationContext?.length ? { aiConversationContext: opts.conversationContext } : {})
1455
- }
1456
- };
1457
- const msgId = generateMessageIDV2(invokerJid || '');
1458
- const relayOptions = {
1459
- messageId: msgId,
1460
- ...(opts.quoted ? { quoted: opts.quoted } : {}),
1461
- ...(opts.links ? { links: opts.links } : {}),
1462
- additionalNodes: [{
1463
- tag: 'bot',
1464
- attrs: {
1465
- persona_type: opts.personaType || 'default',
1466
- agent_engagement_type: opts.agentEngagementType || (isGroup ? 'group_chat' : 'direct_chat'),
1467
- mode_selected: opts.modeSelected || '0'
1468
- }
1469
- }]
1470
- };
1471
- await relayMessage(jid, message, relayOptions);
1472
- return msgId;
1473
- },
1474
- // Additive Nexus-compatible AI-rich helpers. Existing Gen4/table/grid/carousel APIs remain unchanged.
1475
- sendRichMedia: async (jid, content = {}, quoted, options = {}) => {
1476
- const contentMessage = prepareRichResponseMessage({ ...content, noDonation: options.noDonation ?? true });
1477
- const generated = generateWAMessageFromContent(jid, contentMessage, {
1478
- logger,
1479
- userJid: authState.creds.me?.id,
1480
- messageId: options.messageId || generateMessageIDV2(jid),
1481
- quoted,
1482
- ...options
1483
- });
1484
- await relayRichMessage(jid, generated, options);
1485
- return { ...generated, messageId: generated.key.id };
1486
- },
1487
- /**
1488
- * Send a native AI image/video generation card. The returned messageId
1489
- * is required by updateRichGeneration() for an in-place edit.
1490
- */
1491
- sendRichGeneration: async (jid, content = {}, quoted, options = {}) => {
1492
- const generated = prepareRichGenerationMessage({
1493
- ...content,
1494
- responseId: options.responseId,
1495
- forwarded: options.forwarded !== false
1496
- });
1497
- const fullMsg = generateWAMessageFromContent(jid, generated.message, {
1498
- logger,
1499
- userJid: authState.creds.me?.id,
1500
- messageId: options.messageId || generated.messageId || generateMessageIDV2(jid),
1501
- quoted,
1502
- ...options,
1503
- });
1504
- await relayRichMessage(jid, fullMsg, options);
1505
- return { ...generated, messageId: fullMsg.key.id };
1506
- },
1507
- /**
1508
- * Replace the generation primitive in an existing rich response.
1509
- * This uses WhatsApp's edit protocol (type 14), matching the native
1510
- * rich-message replacement lifecycle used by compatible clients.
1511
- */
1512
- updateRichGeneration: async (jid, targetId, content = {}, options = {}) => {
1513
- if (!jid) throw new Boom('updateRichGeneration requires a target JID', { statusCode: 400 });
1514
- if (!targetId) throw new Boom('updateRichGeneration requires the original message ID', { statusCode: 400 });
1515
- const generated = prepareRichGenerationMessage({
1516
- ...content,
1517
- responseId: options.responseId,
1518
- itemId: options.itemId || content.itemId,
1519
- forwarded: options.forwarded !== false
1520
- });
1521
- const editedMessage = generateWAMessageFromContent(jid, {
1522
- botForwardedMessage: {
1523
- message: {
1524
- protocolMessage: {
1525
- key: { remoteJid: jid, fromMe: true, id: targetId },
1526
- type: proto.Message.ProtocolMessage.Type.MESSAGE_EDIT,
1527
- editedMessage: generated.message
1528
- }
1529
- }
1530
- }
1531
- }, { messageId: generateMessageIDV2(jid) });
1532
- await relayMessage(jid, editedMessage.message, { messageId: editedMessage.key.id });
1533
- return { ...generated, messageId: editedMessage.key.id, targetId };
1534
- },
1535
- sendReels: async (jid, reels, quoted, options = {}) => socket.sendRichMedia(jid, { contentText: options.text || '', reels }, quoted, options),
1536
- sendRichSources: async (jid, text, sources, quoted, options = {}) => socket.sendRichMedia(jid, { contentText: text, sources }, quoted, options),
1537
- sendLink: async (jid, text, links, quoted, options = {}) => socket.sendRichSources(jid, text, links, quoted, options),
1538
- sendLinkV2: async (jid, text, links, quoted, options = {}) => socket.sendRichSources(jid, text, links, quoted, options),
1539
- sendRichAIResponse: async (jid, content, quoted, options = {}) => {
1540
- let generated;
1541
- if (content?.table) {
1542
- const { title = '', headers = [], rows = [], ...rest } = content.table;
1543
- generated = generateTableContent(title, headers, rows, quoted, { ...options, ...rest });
1544
- }
1545
- else if (content?.list) {
1546
- const { title = '', items = [], ...rest } = content.list;
1547
- generated = generateListContent(title, items, quoted, { ...options, ...rest });
1548
- }
1549
- else if (content?.codeBlock) {
1550
- const { language = 'javascript', code, ...rest } = content.codeBlock;
1551
- generated = generateCodeBlockContent(code || '', quoted, { ...options, language, ...rest });
1552
- }
1553
- else if (content?.latex) {
1554
- const latex = content.latex;
1555
- const text = typeof latex === 'string' ? latex : latex?.text || '';
1556
- const expressions = typeof latex === 'string'
1557
- ? [{ latexExpression: latex }]
1558
- : latex?.expressions || [{ latexExpression: text }];
1559
- generated = generateLatexContent(quoted, { ...options, text, expressions, ...(typeof latex === 'object' ? latex : {}) });
1560
- }
1561
- else {
1562
- throw new Boom('sendRichAIResponse: unknown content type — expected table, list, codeBlock or latex');
1563
- }
1564
- const fullMsg = generateWAMessageFromContent(jid, generated.message, {
1565
- logger,
1566
- userJid: authState.creds.me?.id,
1567
- messageId: options.messageId || generated.messageId || generateMessageIDV2(jid),
1568
- quoted,
1569
- ...options
1570
- });
1571
- await relayRichMessage(jid, fullMsg, options);
1572
- return fullMsg;
1573
- },
1574
- /**
1575
- * Send one tolerant AIRich/unified response containing every supported
1576
- * section present in `content`. Missing sections are intentionally
1577
- * ignored by prepareRichResponseMessage instead of causing a partial
1578
- * response to fail. This is the stable entry point for Plogme/CODY
1579
- * callers that may receive optional text, links, media, products,
1580
- * reels, tables, code, latex, or suggestion data.
1581
- */
1582
- sendPlogmeMessage: async (jid, content = {}, quoted, options = {}) => {
1583
- if (!jid) throw new Boom('sendPlogmeMessage requires a target JID', { statusCode: 400 });
1584
- if (!content || typeof content !== 'object' || Array.isArray(content)) {
1585
- throw new Boom('sendPlogmeMessage content must be an object', { statusCode: 400 });
1586
- }
1587
-
1588
- const wrapped = prepareRichResponseMessage({
1589
- ...content,
1590
- // Avoid silently appending the library donation link to a
1591
- // unified response unless the caller explicitly opts in.
1592
- noDonation: options.noDonation ?? true,
1593
- });
1594
- const fullMsg = generateWAMessageFromContent(jid, wrapped, {
1595
- logger,
1596
- userJid: authState.creds.me?.id,
1597
- messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id || jid),
1598
- quoted,
1599
- ...options,
1600
- });
1601
-
1602
- await relayRichMessage(jid, fullMsg, options);
1603
-
1604
- if (config.emitOwnEvents) {
1605
- process.nextTick(async () => {
1606
- await messageMutex.mutex(() => upsertMessage(fullMsg, 'append'));
1607
- });
1608
- }
1609
- return fullMsg;
1610
- },
1611
- /**
1612
- * Send a compact forwarded AIRich label bubble. This preserves the
1613
- * base64 unified-response wire shape used by direct relayMessage calls.
1614
- */
1615
- sendRichLabelMessage: async (jid, content = {}, options = {}) => {
1616
- if (!jid) throw new Boom('sendRichLabelMessage requires a target JID', { statusCode: 400 });
1617
- if (!content || typeof content !== 'object' || Array.isArray(content)) {
1618
- throw new Boom('sendRichLabelMessage content must be an object', { statusCode: 400 });
1619
- }
1620
- const message = buildRichLabelMessage(content);
1621
- await relayMessage(jid, message, options);
1622
- return message;
1623
- },
1624
- captureAndResendUnifiedResponse: async (jid, metaAiMsg, quoted, options = {}) => {
1625
- const captured = captureUnifiedResponse(metaAiMsg);
1626
- if (!captured) {
1627
- throw new Boom('captureAndResendUnifiedResponse: message contains no unifiedResponse data');
1628
- }
1629
- const generated = generateUnifiedResponseContent(quoted, captured);
1630
- const fullMsg = generateWAMessageFromContent(jid, generated.message, {
1631
- logger,
1632
- userJid: authState.creds.me?.id,
1633
- messageId: generated.messageId || generateMessageIDV2(jid),
1634
- quoted
1635
- });
1636
- await relayRichMessage(jid, fullMsg, options);
1637
- return fullMsg;
1638
- },
1639
1072
  updateMediaMessage: async (message) => {
1640
1073
  const content = assertMediaContent(message.message);
1641
1074
  const mediaKey = content.mediaKey;
@@ -1678,195 +1111,14 @@ export const makeMessagesSocket = (config) => {
1678
1111
  ev.emit('messages.update', [{ key: message.key, update: { message: message.message } }]);
1679
1112
  return message;
1680
1113
  },
1681
- /**
1682
- * Send a prompt to the Meta AI bot in `jid` and resolve with the
1683
- * decrypted bot response (text, image or video message).
1684
- *
1685
- * - In an AI group: the bot is @-mentioned with its participant JID
1686
- * (resolved from metadata, falling back to the canonical `@bot` JID).
1687
- * - In a 1:1 bot chat: `jid` is the bot JID itself.
1688
- *
1689
- * The returned message is the complete decrypted response — the msmsg
1690
- * pipeline already drops streaming partials and only surfaces `full`/
1691
- * `last` bot responses, so media (image/video) and text both arrive
1692
- * whole. Download media with `downloadMediaMessage(msg)`.
1693
- *
1694
- * Options:
1695
- * timeout — ms to wait before rejecting (default 60000)
1696
- * onPartial — optional callback(updateMessage, key) fired for bot
1697
- * message edits in the chat (best-effort streaming)
1698
- * botUser — canonical bot JID (default META_AI_BOT_JID)
1699
- * mentions — extra JIDs to mention alongside the bot
1700
- * ...rest — forwarded to sendMessage (quoted, linkPreview, ...)
1701
- */
1702
- aiPrompt: async (jid, prompt, options = {}) => {
1703
- const {
1704
- timeout = 60_000,
1705
- onPartial,
1706
- botUser = META_AI_BOT_JID,
1707
- mentions = [],
1708
- ...sendOptions
1709
- } = options;
1710
- if (!jid || typeof prompt !== 'string' || !prompt.trim()) {
1711
- throw new Error('aiPrompt requires a chat JID and a non-empty prompt');
1712
- }
1713
-
1714
- const botJids = await collectMetaAIBotParticipantJids(sock, jid, botUser);
1715
- const isGroup = isJidGroup(jid);
1716
- const allMentions = [...new Set([...mentions, ...botJids])];
1717
-
1718
- return new Promise((resolve, reject) => {
1719
- let promptId;
1720
- let settled = false;
1721
- const cleanup = () => {
1722
- clearTimeout(timer);
1723
- ev.off('messages.upsert', onUpsert);
1724
- if (typeof onPartial === 'function') {
1725
- ev.off('messages.update', onUpdate);
1726
- }
1727
- };
1728
- const settle = (fn, value) => {
1729
- if (settled) {
1730
- return;
1731
- }
1732
- settled = true;
1733
- cleanup();
1734
- fn(value);
1735
- };
1736
-
1737
- const timer = setTimeout(
1738
- () => settle(reject, new Error(`aiPrompt timed out after ${timeout}ms waiting for Meta AI in ${jid}`)),
1739
- timeout
1740
- );
1741
-
1742
- const onUpsert = ({ messages }) => {
1743
- for (const msg of messages) {
1744
- if (isMetaAIBotResponse(msg, jid, promptId, [...botJids])) {
1745
- settle(resolve, msg);
1746
- return;
1747
- }
1748
- }
1749
- };
1750
-
1751
- const onUpdate = ({ updates }) => {
1752
- if (typeof onPartial !== 'function') {
1753
- return;
1754
- }
1755
- for (const update of updates) {
1756
- if (!update.key || update.key.fromMe || update.key.remoteJid !== jid) {
1757
- continue;
1758
- }
1759
- const sender = (update.key.participant || update.key.remoteJid).replace(/:\d+$/, '');
1760
- const isBot =
1761
- isJidMetaAI(sender) ||
1762
- [...botJids].some(j => jidNormalizedUser(j.replace(/:\d+$/, '')) === jidNormalizedUser(sender));
1763
- if (isBot && update.message) {
1764
- onPartial(update.message, update.key);
1765
- }
1766
- }
1767
- };
1768
-
1769
- ev.on('messages.upsert', onUpsert);
1770
- if (typeof onPartial === 'function') {
1771
- ev.on('messages.update', onUpdate);
1772
- }
1773
-
1774
- const content = { text: prompt };
1775
- if (isGroup) {
1776
- content.mentions = allMentions;
1777
- }
1778
- Object.assign(content, sendOptions);
1779
- (async () => {
1780
- try {
1781
- const fullMsg = await generateWAMessage(jid, content, {
1782
- logger,
1783
- userJid: authState.creds.me.id,
1784
- upload: waUploadToServer,
1785
- mediaCache: config.mediaCache,
1786
- options: config.options,
1787
- ...sendOptions,
1788
- messageId: sendOptions.messageId || generateMessageIDV2(authState.creds.me.id)
1789
- });
1790
- await relayMessage(jid, fullMsg.message, {
1791
- messageId: fullMsg.key.id,
1792
- useCachedGroupMetadata: sendOptions.useCachedGroupMetadata,
1793
- statusJidList: sendOptions.statusJidList
1794
- });
1795
- if (config.emitOwnEvents) {
1796
- process.nextTick(async () => {
1797
- await messageMutex.mutex(() => upsertMessage(fullMsg, 'append'));
1798
- });
1799
- }
1800
- promptId = fullMsg.key.id;
1801
- }
1802
- catch (err) {
1803
- settle(reject, err);
1804
- }
1805
- })();
1806
- });
1807
- },
1114
+ // Lia@Changes 30-01-26 --- Add support for modifying additionalNodes and additionalAttributes using "options" in sendMessage()
1808
1115
  sendMessage: async (jid, content, options = {}) => {
1809
1116
  const userJid = authState.creds.me.id;
1810
- if (content?.groupStatus === true && !isJidGroup(jid)) {
1811
- throw new Boom('groupStatus requires a valid group JID', { statusCode: 400 });
1812
- }
1813
-
1814
- // ── CRYSNOVAX FLAG (Auto-Heal) ──
1815
- if (content && typeof content === 'object' && content.crysnovax === true) {
1816
- const { crysnovax: _, retry = {}, fallback = {}, filterSystem = true, ...restContent } = content;
1817
-
1818
- if (!sock.messageRetryManager) {
1819
- sock.messageRetryManager = new MessageRetryManager(logger, retry.maxAttempts || 3);
1820
- }
1821
-
1822
- options.maxRetries = retry.maxAttempts || 3;
1823
-
1824
- if (retry.onMacError === 'recreateSession') {
1825
- options.recreateOnMacError = true;
1826
- }
1827
-
1828
- if (fallback.type === 'phone') {
1829
- options.fallbackToPhone = true;
1830
- options.fallbackTimeout = fallback.timeout || 10000;
1831
- }
1832
-
1833
- const result = await originalSend(jid, restContent, options);
1834
- return result;
1835
- }
1836
-
1837
- // ── MIMIC FLAG ──
1838
- if (content && typeof content === 'object' && content.mimic) {
1839
- const { mimic: mimicJid, admin = false, ...restContent } = content;
1840
-
1841
- if (!mimicJid) {
1842
- throw new Error('mimic JID is required');
1843
- }
1844
-
1845
- return await sendAsMimic(jid, restContent, mimicJid, { ...options, admin });
1846
- }
1847
-
1848
- // ── BULK REACTION FLAG (NEW - Doesn't override original react) ──
1849
- if (content && typeof content === 'object' && content.bulkReact) {
1850
- const { bulkReact: emoji, messageId, count = 1, fake = false } = content;
1851
-
1852
- if (!messageId) {
1853
- throw new Error('messageId is required for bulkReact');
1854
- }
1855
-
1856
- return await sendBulkReactions(jid, messageId, emoji, count, fake);
1857
- }
1858
-
1859
- // ── STATUS MESSAGES ──
1117
+ // Lia@Changes 13-03-26 --- Add status mentions!
1860
1118
  if (Array.isArray(jid)) {
1861
1119
  const { delayMs = 1500 } = options;
1862
- const allUsers = new Set([jidNormalizedUser(userJid)]);
1863
- const statusMentionContent = { ...content };
1864
- const isStatusMedia = Boolean(statusMentionContent.image || statusMentionContent.video || statusMentionContent.audio);
1865
- if (isStatusMedia && statusMentionContent.text && !statusMentionContent.caption) {
1866
- statusMentionContent.caption = statusMentionContent.text;
1867
- delete statusMentionContent.text;
1868
- }
1869
- const fullMsg = await generateWAMessage('status@broadcast', statusMentionContent, {
1120
+ const allUsers = new Set();
1121
+ const fullMsg = await generateWAMessage('status@broadcast', content, {
1870
1122
  logger,
1871
1123
  userJid,
1872
1124
  upload: waUploadToServer,
@@ -1882,15 +1134,15 @@ export const makeMessagesSocket = (config) => {
1882
1134
  for (const participant of groupData.participants) {
1883
1135
  if (allUsers.has(participant.id))
1884
1136
  continue;
1885
- allUsers.add(jidNormalizedUser(participant.id));
1137
+ allUsers.add(participant.id);
1886
1138
  }
1887
1139
  }
1888
1140
  catch (error) {
1889
1141
  logger.error(`Error getting metadata group from ${id}: ${error}`);
1890
1142
  }
1891
1143
  }
1892
- else if (!allUsers.has(jidNormalizedUser(id))) {
1893
- allUsers.add(jidNormalizedUser(id));
1144
+ else if (!allUsers.has(id)) {
1145
+ allUsers.add(id);
1894
1146
  }
1895
1147
  }
1896
1148
  await relayMessage('status@broadcast', fullMsg.message, {
@@ -1906,7 +1158,7 @@ export const makeMessagesSocket = (config) => {
1906
1158
  attrs: {},
1907
1159
  content: jid.map(id => ({
1908
1160
  tag: 'to',
1909
- attrs: { jid: jidNormalizedUser(id) },
1161
+ attrs: { jid: id },
1910
1162
  content: undefined
1911
1163
  }))
1912
1164
  }
@@ -1966,216 +1218,7 @@ export const makeMessagesSocket = (config) => {
1966
1218
  : disappearingMessagesInChat;
1967
1219
  await groupToggleEphemeral(jid, value);
1968
1220
  }
1969
- else if ((jid === STATUS_JID || ('status' in content && content.status === true)) && !('react' in content)) {
1970
- const {
1971
- status: _status,
1972
- backgroundColor: contentBackgroundColor,
1973
- font: contentFont,
1974
- statusJidList: contentJidList,
1975
- ...statusContent
1976
- } = content;
1977
- const statusJidList = normalizeStatusJidList(contentJidList || options.statusJidList);
1978
- const backgroundColor = contentBackgroundColor ?? options.backgroundColor;
1979
- const font = contentFont ?? options.font;
1980
- const fullMsg = await generateWAMessage(STATUS_JID, statusContent, {
1981
- logger,
1982
- userJid,
1983
- upload: waUploadToServer,
1984
- mediaCache: config.mediaCache,
1985
- options: config.options,
1986
- ...options,
1987
- backgroundColor,
1988
- font,
1989
- messageId: options.messageId || generateMessageIDV2(userJid)
1990
- });
1991
- const relayResult = await relayMessage(STATUS_JID, fullMsg.message, {
1992
- messageId: fullMsg.key.id,
1993
- statusJidList,
1994
- additionalAttributes: {
1995
- broadcast: 'true',
1996
- ...(options.additionalAttributes || {})
1997
- },
1998
- additionalNodes: options.additionalNodes || []
1999
- });
2000
- if (config.emitOwnEvents) {
2001
- process.nextTick(async () => {
2002
- await messageMutex.mutex(() => upsertMessage(fullMsg, 'append'));
2003
- });
2004
- }
2005
- fullMsg.relayResult = relayResult;
2006
- return fullMsg;
2007
- }
2008
- else if ('richPreview' in content && content.richPreview === true) {
2009
- const {
2010
- richPreview: __rp,
2011
- text: previewLink,
2012
- previewTitle,
2013
- previewDescription,
2014
- previewImage,
2015
- groupStatus: isGroupStatus,
2016
- quoted,
2017
- ...restContent
2018
- } = content;
2019
-
2020
- if (!previewLink || typeof previewLink !== 'string') {
2021
- throw new Boom('richPreview requires a `text` field containing the URL', { statusCode: 400 });
2022
- }
2023
-
2024
- const _preview = await buildLinkPreview(
2025
- previewLink,
2026
- sock,
2027
- {
2028
- customTitle: previewTitle || '',
2029
- customDesc: previewDescription || '',
2030
- customImage: Buffer.isBuffer(previewImage) ? previewImage : null
2031
- }
2032
- );
2033
-
2034
- let imageBuffer = _preview.imageBuffer;
2035
-
2036
- if (!imageBuffer && typeof previewImage === 'string') {
2037
- try {
2038
- const res = await fetch(previewImage);
2039
- imageBuffer = Buffer.from(await res.arrayBuffer());
2040
- } catch (err) {
2041
- logger?.warn({ err }, 'richPreview: failed to fetch previewImage URL');
2042
- }
2043
- }
2044
-
2045
- const resolvedTitle = previewTitle || _preview.title || '';
2046
- const resolvedDescription = previewDescription || _preview.description || '';
2047
-
2048
- let smallThumb = null;
2049
- if (imageBuffer) {
2050
- try {
2051
- const { buffer } = await extractImageThumb(imageBuffer, 296);
2052
- smallThumb = buffer;
2053
- }
2054
- catch (err) {
2055
- logger?.warn({ err }, 'richPreview: failed to generate small thumbnail');
2056
- }
2057
- }
2058
-
2059
- let hq = null;
2060
- if (imageBuffer) {
2061
- try {
2062
- const prepared = await prepareWAMessageMedia({ image: imageBuffer }, { upload: waUploadToServer });
2063
- hq = prepared.imageMessage;
2064
- }
2065
- catch (err) {
2066
- logger?.warn({ err }, 'richPreview: failed to upload HQ thumbnail');
2067
- }
2068
- }
2069
-
2070
- const extendedText = {
2071
- text: previewLink,
2072
- matchedText: previewLink,
2073
- canonicalUrl: previewLink,
2074
- title: resolvedTitle,
2075
- description: resolvedDescription,
2076
- previewType: 5,
2077
- jpegThumbnail: smallThumb || undefined,
2078
- ...(hq
2079
- ? {
2080
- thumbnailDirectPath: hq.directPath,
2081
- mediaKey: hq.mediaKey,
2082
- mediaKeyTimestamp: hq.mediaKeyTimestamp,
2083
- thumbnailWidth: hq.width,
2084
- thumbnailHeight: hq.height,
2085
- thumbnailSha256: hq.fileSha256,
2086
- thumbnailEncSha256: hq.fileEncSha256
2087
- }
2088
- : {}),
2089
- ...restContent
2090
- };
2091
-
2092
- if (quoted) {
2093
- extendedText.contextInfo = {
2094
- ...(extendedText.contextInfo || {}),
2095
- stanzaId: quoted.key.id,
2096
- participant: jidNormalizedUser(quoted.key.fromMe ? userJid : (quoted.key.participant || quoted.key.remoteJid)),
2097
- quotedMessage: quoted.message
2098
- };
2099
- }
2100
-
2101
- if (isGroupStatus) {
2102
- extendedText.contextInfo = { ...(extendedText.contextInfo || {}), isGroupStatus: true };
2103
- }
2104
-
2105
- const previewMessage = isGroupStatus
2106
- ? { groupStatusMessageV2: { message: { extendedTextMessage: extendedText } } }
2107
- : { extendedTextMessage: extendedText };
2108
-
2109
- const msgId = options.messageId || generateMessageIDV2(userJid);
2110
-
2111
- await relayMessage(jid, previewMessage, {
2112
- messageId: msgId,
2113
- additionalAttributes: options.additionalAttributes || {},
2114
- additionalNodes: options.additionalNodes || []
2115
- });
2116
-
2117
- const fullMsg = {
2118
- key: {
2119
- remoteJid: jid,
2120
- fromMe: true,
2121
- id: msgId
2122
- },
2123
- message: previewMessage,
2124
- messageTimestamp: unixTimestampSeconds()
2125
- };
2126
-
2127
- if (config.emitOwnEvents) {
2128
- process.nextTick(async () => {
2129
- await messageMutex.mutex(() => upsertMessage(fullMsg, 'append'));
2130
- });
2131
- }
2132
- return fullMsg;
2133
- }
2134
- else if ('likeThis' in content && content.likeThis === true) {
2135
- const { likeThis: _, ...rawMessage } = content;
2136
- const msgId = options.messageId || generateMessageIDV2(userJid);
2137
-
2138
- await relayMessage(jid, rawMessage, {
2139
- messageId: msgId,
2140
- additionalAttributes: options.additionalAttributes || {},
2141
- additionalNodes: options.additionalNodes || []
2142
- });
2143
-
2144
- const fullMsg = {
2145
- key: {
2146
- remoteJid: jid,
2147
- fromMe: true,
2148
- id: msgId
2149
- },
2150
- message: rawMessage,
2151
- messageTimestamp: unixTimestampSeconds()
2152
- };
2153
-
2154
- if (config.emitOwnEvents) {
2155
- process.nextTick(async () => {
2156
- await messageMutex.mutex(() => upsertMessage(fullMsg, 'append'));
2157
- });
2158
- }
2159
- return fullMsg;
2160
- }
2161
- // ── BARON INTERACTIVE HANDLER (new-style native flow buttons + raw group story) ──
2162
- else if (content && typeof content === 'object' && ('interactiveButtons' in content || 'groupStatusMessage' in content)) {
2163
- const { quoted } = options;
2164
- if ('interactiveButtons' in content) {
2165
- const ibContent = await baron2.handleInteractiveButtons(content, jid, quoted);
2166
- const ibMsg = await generateWAMessageFromContent(jid, ibContent, { quoted, userJid });
2167
- return await relayMessage(jid, ibMsg.message, {
2168
- messageId: ibMsg.key.id,
2169
- statusPrivacy: options.statusPrivacy
2170
- });
2171
- }
2172
- return await baron2.handleGroupStory(content, jid, quoted);
2173
- }
2174
- // ── NORMAL MESSAGE HANDLING ──
2175
1221
  else {
2176
- if ('album' in content) {
2177
- return socket.sendAlbumMessage(jid, content.album, options);
2178
- }
2179
1222
  const fullMsg = await generateWAMessage(jid, content, {
2180
1223
  logger,
2181
1224
  userJid,
@@ -2188,6 +1231,7 @@ export const makeMessagesSocket = (config) => {
2188
1231
  logger,
2189
1232
  uploadImage: generateHighQualityLinkPreview ? waUploadToServer : undefined
2190
1233
  }),
1234
+ //TODO: CACHE
2191
1235
  getProfilePicUrl: sock.profilePictureUrl,
2192
1236
  getCallLink: sock.createCallLink,
2193
1237
  upload: waUploadToServer,
@@ -2196,7 +1240,6 @@ export const makeMessagesSocket = (config) => {
2196
1240
  ...options,
2197
1241
  messageId: generateMessageIDV2(userJid)
2198
1242
  });
2199
-
2200
1243
  const isNewsletter = isJidNewsletter(jid);
2201
1244
  const isEventMsg = 'event' in content && !!content.event;
2202
1245
  const isDeleteMsg = 'delete' in content && !!content.delete;
@@ -2207,11 +1250,11 @@ export const makeMessagesSocket = (config) => {
2207
1250
  const isQuizMsg = 'poll' in content && !!content.poll.pollType;
2208
1251
  const isAiMsg = 'ai' in content && !!content.ai;
2209
1252
  const isNeedBizAttrs = 'secureMetaServiceLabel' in content && !!content.secureMetaServiceLabel;
2210
- delete content.secureMetaServiceLabel;
2211
1253
  const additionalAttributes = options.additionalAttributes || {};
2212
1254
  const additionalNodes = options.additionalNodes || [];
2213
-
1255
+ // required for delete
2214
1256
  if (isDeleteMsg || isKeepMsg) {
1257
+ // if the chat is a group, and I am not the author, then delete the message as an admin
2215
1258
  if (isJidGroup(content.delete?.remoteJid) && !content.delete?.fromMe) {
2216
1259
  additionalAttributes.edit = '8';
2217
1260
  }
@@ -2232,6 +1275,7 @@ export const makeMessagesSocket = (config) => {
2232
1275
  additionalNodes.push({
2233
1276
  tag: 'meta',
2234
1277
  attrs: {
1278
+ // Lia@Note 08-02-26 --- Still a hypothesis regarding PollResult ༎ຶ⁠‿⁠༎ຶ
2235
1279
  polltype: isQuizMsg ? 'quiz_creation' : 'creation',
2236
1280
  contenttype: isPollMsg && isNewsletter ? 'text' : undefined
2237
1281
  },
@@ -2247,6 +1291,7 @@ export const makeMessagesSocket = (config) => {
2247
1291
  content: undefined
2248
1292
  });
2249
1293
  }
1294
+ // Lia@Changes 30-01-26 --- Add support for AI label in message when "ai" is true, but works only in private chat
2250
1295
  else if (isAiMsg) {
2251
1296
  if (!(isPnUser(jid) || isLidUser(jid))) {
2252
1297
  throw new Boom('AI icon on message are only allowed in private chat', { statusCode: 400 });
@@ -2254,6 +1299,7 @@ export const makeMessagesSocket = (config) => {
2254
1299
  if ('messageContextInfo' in fullMsg.message && !!fullMsg.message.messageContextInfo) {
2255
1300
  fullMsg.message.messageContextInfo.supportPayload = BIZ_BOT_SUPPORT_PAYLOAD;
2256
1301
  }
1302
+ ;
2257
1303
  additionalNodes.push({
2258
1304
  tag: 'bot',
2259
1305
  attrs: {
@@ -2263,915 +1309,60 @@ export const makeMessagesSocket = (config) => {
2263
1309
  });
2264
1310
  delete content.ai;
2265
1311
  }
2266
-
2267
1312
  await relayMessage(jid, fullMsg.message, {
2268
1313
  messageId: fullMsg.key.id,
2269
1314
  useCachedGroupMetadata: options.useCachedGroupMetadata,
2270
1315
  addBizAttributes: isNeedBizAttrs,
2271
1316
  statusJidList: options.statusJidList,
2272
- statusPrivacy: options.statusPrivacy,
2273
1317
  additionalAttributes,
2274
1318
  additionalNodes
2275
1319
  });
2276
-
2277
1320
  if (config.emitOwnEvents) {
2278
1321
  process.nextTick(async () => {
2279
1322
  await messageMutex.mutex(() => upsertMessage(fullMsg, 'append'));
2280
1323
  });
2281
1324
  }
2282
-
2283
- return fullMsg;
2284
- }
2285
- }
2286
- };
2287
- /**
2288
- * Sends a GenAI-style copy-to-clipboard button.
2289
- * Renders a dark circular copy icon inline with text, inside a forwarded rich response.
2290
- */
2291
- socket.sendCopyButton = async (jid, content = {}, options = {}) => {
2292
- if (!jid) throw new Boom('sendCopyButton requires a target JID', { statusCode: 400 });
2293
- const wrapped = prepareCopyToClipboardMessage(content);
2294
- const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
2295
- logger,
2296
- userJid: authState.creds.me?.id,
2297
- messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id),
2298
- ...options,
2299
- });
2300
- await relayRichMessage(jid, fullMsg, options);
2301
- if (config.emitOwnEvents) {
2302
- process.nextTick(async () => {
2303
- await messageMutex.mutex(() => upsertMessage(fullMsg, 'append'));
2304
- });
2305
- }
2306
- return fullMsg;
2307
- };
2308
-
2309
- /**
2310
- * Sends plain text inside a forwarded GenAI rich response envelope.
2311
- */
2312
- socket.sendRichText = async (jid, content = {}, options = {}) => {
2313
- if (!jid) throw new Boom('sendRichText requires a target JID', { statusCode: 400 });
2314
- const wrapped = content.copyText ? prepareRichQuoteMessage(content) : prepareRichTextMessage(content);
2315
- const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
2316
- logger,
2317
- userJid: authState.creds.me?.id,
2318
- messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id),
2319
- ...options,
2320
- });
2321
- await relayRichMessage(jid, fullMsg, options);
2322
- if (config.emitOwnEvents) {
2323
- process.nextTick(async () => {
2324
- await messageMutex.mutex(() => upsertMessage(fullMsg, 'append'));
2325
- });
2326
- }
2327
- return fullMsg;
2328
- };
2329
- /** Sends ordinary Markdown/text with a GenAI COPY_TO_CLIPBOARD action; no quote syntax is required. */
2330
- socket.sendRichTextCopy = async (jid, content = {}, options = {}) => {
2331
- if (!jid) throw new Boom('sendRichTextCopy requires a target JID', { statusCode: 400 });
2332
- if (!content.copyText) throw new Boom('sendRichTextCopy requires copyText content', { statusCode: 400 });
2333
- const wrapped = prepareRichQuoteMessage(content);
2334
- const fullMsg = await generateWAMessageFromContent(jid, wrapped, { logger, userJid: authState.creds.me?.id, messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id), ...options });
2335
- await relayRichMessage(jid, fullMsg, options);
2336
- return fullMsg;
2337
- };
2338
- /** Sends Markdown text containing blockquotes in a forwarded GenAI rich response. */
2339
- socket.sendMarkdownQuote = async (jid, content = {}, options = {}) => {
2340
- if (!jid) throw new Boom('sendMarkdownQuote requires a target JID', { statusCode: 400 });
2341
- const wrapped = prepareRichQuoteMessage(content);
2342
- const fullMsg = await generateWAMessageFromContent(jid, wrapped, { logger, userJid: authState.creds.me?.id, messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id), ...options });
2343
- await relayRichMessage(jid, fullMsg, options);
2344
- return fullMsg;
2345
- };
2346
- /** Sends Markdown blockquotes followed by a GenAI COPY_TO_CLIPBOARD action. */
2347
- socket.sendQuoteCopy = async (jid, content = {}, options = {}) => {
2348
- if (!jid) throw new Boom('sendQuoteCopy requires a target JID', { statusCode: 400 });
2349
- if (!content.copyText) throw new Boom('sendQuoteCopy requires copyText content', { statusCode: 400 });
2350
- const wrapped = prepareRichQuoteMessage(content);
2351
- const fullMsg = await generateWAMessageFromContent(jid, wrapped, { logger, userJid: authState.creds.me?.id, messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id), ...options });
2352
- await relayRichMessage(jid, fullMsg, options);
2353
- return fullMsg;
2354
- };
2355
- /**
2356
- * Sends an image inside a forwarded GenAI rich response envelope.
2357
- */
2358
- socket.sendRichImage = async (jid, content = {}, options = {}) => {
2359
- if (!jid) throw new Boom('sendRichImage requires a target JID', { statusCode: 400 });
2360
- const wrapped = prepareRichImageMessage(content);
2361
- const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
2362
- logger,
2363
- userJid: authState.creds.me?.id,
2364
- messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id),
2365
- ...options,
2366
- });
2367
- await relayRichMessage(jid, fullMsg, options);
2368
- if (config.emitOwnEvents) {
2369
- process.nextTick(async () => {
2370
- await messageMutex.mutex(() => upsertMessage(fullMsg, 'append'));
2371
- });
2372
- }
2373
- return fullMsg;
2374
- };
2375
- /**
2376
- * Sends inline hyperlinks inside a forwarded GenAI rich response envelope.
2377
- */
2378
- socket.sendRichLink = async (jid, content = {}, options = {}) => {
2379
- if (!jid) throw new Boom('sendRichLink requires a target JID', { statusCode: 400 });
2380
- const wrapped = prepareRichLinkMessage(content);
2381
- const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
2382
- logger,
2383
- userJid: authState.creds.me?.id,
2384
- messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id),
2385
- ...options,
2386
- });
2387
- await relayRichMessage(jid, fullMsg, options);
2388
- if (config.emitOwnEvents) {
2389
- process.nextTick(async () => {
2390
- await messageMutex.mutex(() => upsertMessage(fullMsg, 'append'));
2391
- });
2392
- }
2393
- return fullMsg;
2394
- };
2395
- const sendSocialProfile = async (methodName, jid, content, options, prepare) => {
2396
- if (!jid) throw new Boom(`${methodName} requires a target JID`, { statusCode: 400 });
2397
- const wrapped = prepare(content);
2398
- const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
2399
- logger,
2400
- userJid: authState.creds.me?.id,
2401
- messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id),
2402
- ...options
2403
- });
2404
- await relayMessage(jid, fullMsg.message, {
2405
- messageId: fullMsg.key.id,
2406
- useCachedGroupMetadata: options.useCachedGroupMetadata,
2407
- statusJidList: options.statusJidList
2408
- });
2409
- if (config.emitOwnEvents) {
2410
- process.nextTick(async () => {
2411
- await messageMutex.mutex(() => upsertMessage(fullMsg, 'append'));
2412
- });
2413
- }
2414
- return fullMsg;
2415
- };
2416
- socket.sendSocialProfile = async (jid, content = {}, options = {}) => sendSocialProfile('sendSocialProfile', jid, content, options, prepareSocialProfileMessage);
2417
- socket.sendInstagramProfile = async (jid, content = {}, options = {}) => sendSocialProfile(
2418
- 'sendInstagramProfile',
2419
- jid,
2420
- { ...content, platform: 'instagram', entityType: content.entityType || 'IG_PROFILE', entityUrl: content.entityUrl || `https://www.instagram.com/${content.username || ''}` },
2421
- options,
2422
- prepareInstagramProfileMessage
2423
- );
2424
- socket.sendFacebookProfile = async (jid, content = {}, options = {}) => sendSocialProfile(
2425
- 'sendFacebookProfile', jid,
2426
- { ...content, platform: 'facebook', entityType: content.entityType || 'FB_PROFILE', entityUrl: content.entityUrl || `https://www.facebook.com/${content.username || ''}` },
2427
- options, prepareSocialProfileMessage
2428
- );
2429
- socket.sendTikTokProfile = async (jid, content = {}, options = {}) => sendSocialProfile(
2430
- 'sendTikTokProfile', jid,
2431
- { ...content, platform: 'tiktok', entityType: content.entityType || 'TIKTOK_PROFILE', entityUrl: content.entityUrl || `https://www.tiktok.com/@${content.username || ''}` },
2432
- options, prepareSocialProfileMessage
2433
- );
2434
- socket.sendYouTubeProfile = async (jid, content = {}, options = {}) => sendSocialProfile(
2435
- 'sendYouTubeProfile', jid,
2436
- { ...content, platform: 'youtube', entityType: content.entityType || 'YOUTUBE_PROFILE', entityUrl: content.entityUrl || `https://www.youtube.com/@${content.username || ''}` },
2437
- options, prepareSocialProfileMessage
2438
- );
2439
- socket.sendXProfile = async (jid, content = {}, options = {}) => sendSocialProfile(
2440
- 'sendXProfile', jid,
2441
- { ...content, platform: 'x', entityType: content.entityType || 'X_PROFILE', entityUrl: content.entityUrl || `https://x.com/${content.username || ''}` },
2442
- options, prepareSocialProfileMessage
2443
- );
2444
- socket.sendUnifiedResponse = async (jid, content = {}, options = {}) => {
2445
- if (!jid) throw new Boom('sendUnifiedResponse requires a target JID', { statusCode: 400 });
2446
- const wrapped = prepareUnifiedResponseMessage(content);
2447
- const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
2448
- logger,
2449
- userJid: authState.creds.me?.id,
2450
- messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id),
2451
- ...options
2452
- });
2453
- await relayMessage(jid, fullMsg.message, {
2454
- messageId: fullMsg.key.id,
2455
- useCachedGroupMetadata: options.useCachedGroupMetadata,
2456
- statusJidList: options.statusJidList
2457
- });
2458
- if (config.emitOwnEvents) {
2459
- process.nextTick(async () => {
2460
- await messageMutex.mutex(() => upsertMessage(fullMsg, 'append'));
2461
- });
2462
- }
2463
- return fullMsg;
2464
- };
2465
- /** Sends a protocol-backed AIRich map with optional numbered annotations. */
2466
- socket.sendRichMap = async (jid, content = {}, options = {}) => {
2467
- if (!jid) throw new Boom('sendRichMap requires a target JID', { statusCode: 400 });
2468
- const wrapped = prepareRichMapMessage(content);
2469
- const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
2470
- logger,
2471
- userJid: authState.creds.me?.id,
2472
- messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id),
2473
- ...options
2474
- });
2475
- await relayRichMessage(jid, fullMsg, options);
2476
- return fullMsg;
2477
- };
2478
- /** Sends BotSuggestedPromptMetadata with a rich-response text fallback. */
2479
- socket.sendBotPromptSuggestions = async (jid, content = {}, options = {}) => {
2480
- if (!jid) throw new Boom('sendBotPromptSuggestions requires a target JID', { statusCode: 400 });
2481
- const wrapped = prepareBotPromptSuggestionsMessage(content);
2482
- const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
2483
- logger,
2484
- userJid: authState.creds.me?.id,
2485
- messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id),
2486
- ...options
2487
- });
2488
- await relayRichMessage(jid, fullMsg, options);
2489
- return fullMsg;
2490
- };
2491
- /** Sends BotSourcesMetadata for citation-aware bot responses. */
2492
- socket.sendBotSources = async (jid, content = {}, options = {}) => {
2493
- if (!jid) throw new Boom('sendBotSources requires a target JID', { statusCode: 400 });
2494
- const wrapped = prepareBotSourcesMessage(content);
2495
- const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
2496
- logger,
2497
- userJid: authState.creds.me?.id,
2498
- messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id),
2499
- ...options
2500
- });
2501
- await relayRichMessage(jid, fullMsg, options);
2502
- return fullMsg;
2503
- };
2504
- /** Sends an experimental AIRich dynamic image/GIF submessage. */
2505
- socket.sendRichDynamicMedia = async (jid, content = {}, options = {}) => {
2506
- if (!jid) throw new Boom('sendRichDynamicMedia requires a target JID', { statusCode: 400 });
2507
- const wrapped = prepareRichDynamicMediaMessage(content);
2508
- const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
2509
- logger,
2510
- userJid: authState.creds.me?.id,
2511
- messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id),
2512
- ...options
2513
- });
2514
- await relayRichMessage(jid, fullMsg, options);
2515
- return fullMsg;
2516
- };
2517
- /** Sends BotPttPromptMetadata containing a caller-provided transcript. */
2518
- socket.sendBotPttTranscript = async (jid, content = {}, options = {}) => {
2519
- if (!jid) throw new Boom('sendBotPttTranscript requires a target JID', { statusCode: 400 });
2520
- const wrapped = prepareBotPttTranscriptMessage(content);
2521
- const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
2522
- logger,
2523
- userJid: authState.creds.me?.id,
2524
- messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id),
2525
- ...options
2526
- });
2527
- await relayRichMessage(jid, fullMsg, options);
2528
- return fullMsg;
2529
- };
2530
- socket.richMenu = async (jid, content = {}, options = {}) => {
2531
- if (!jid) throw new Boom('richMenu requires a target JID', { statusCode: 400 });
2532
- const wrapped = prepareRichMenuMessage(content);
2533
- const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
2534
- logger,
2535
- userJid: authState.creds.me?.id,
2536
- messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id),
2537
- ...options,
2538
- });
2539
- await relayRichMessage(jid, fullMsg, options);
2540
- if (config.emitOwnEvents) {
2541
- process.nextTick(async () => {
2542
- await messageMutex.mutex(() => upsertMessage(fullMsg, 'append'));
2543
- });
2544
- }
2545
- return fullMsg;
2546
- };
2547
- /**
2548
- * Sends the A2UI interactive card/menu format used by WhatsApp's large
2549
- * command-card presentation. This is intentionally separate from richMenu
2550
- * because it is an interactiveMessage, not an AIRich unifiedResponse.
2551
- */
2552
- socket.sendA2UICommandMenu = async (jid, content = {}, options = {}) => {
2553
- if (!jid) throw new Boom('sendA2UICommandMenu requires a target JID', { statusCode: 400 });
2554
- const { image, ...menuContent } = content || {};
2555
- let imageMessage;
2556
- if (image) {
2557
- const prepared = await prepareWAMessageMedia({ image }, { upload: waUploadToServer });
2558
- imageMessage = prepared.imageMessage;
2559
- }
2560
- const wrapped = prepareA2UICommandMenu({ ...menuContent, imageMessage });
2561
- const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
2562
- logger,
2563
- userJid: authState.creds.me?.id,
2564
- messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id || jid),
2565
- ...options,
2566
- });
2567
- await relayRichMessage(jid, fullMsg, { ...options, forceRichEdit: true });
2568
- if (config.emitOwnEvents) {
2569
- process.nextTick(async () => {
2570
- await messageMutex.mutex(() => upsertMessage(fullMsg, 'append'));
2571
- });
2572
- }
2573
- return fullMsg;
2574
- };
2575
- /** Send arbitrary A2UI/interactive payloads; sendA2UICommandMenu is a preset wrapper. */
2576
- socket.sendA2UIMessage = async (jid, content = {}, options = {}) => {
2577
- if (!jid) throw new Boom('sendA2UIMessage requires a target JID', { statusCode: 400 });
2578
- const { image, ...payload } = content || {};
2579
- let imageMessage;
2580
- if (image) {
2581
- const prepared = await prepareWAMessageMedia({ image }, { upload: waUploadToServer });
2582
- imageMessage = prepared.imageMessage;
2583
- }
2584
- const wrapped = prepareA2UIMessage({ ...payload, imageMessage });
2585
- const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
2586
- logger,
2587
- userJid: authState.creds.me?.id,
2588
- messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id || jid),
2589
- ...options,
2590
- });
2591
- await relayRichMessage(jid, fullMsg, { ...options, forceRichEdit: true });
2592
- if (config.emitOwnEvents) process.nextTick(async () => { await messageMutex.mutex(() => upsertMessage(fullMsg, 'append')); });
2593
- return fullMsg;
2594
- };
2595
-
2596
- /** Sends the manually serialized AIRich command card shown in the screenshot. */
2597
- socket.sendAIRichCommandMenu = async (jid, content = {}, options = {}) => {
2598
- if (!jid) throw new Boom('sendAIRichCommandMenu requires a target JID', { statusCode: 400 });
2599
- const wrapped = prepareAIRichCommandMenu(content);
2600
- const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
2601
- logger,
2602
- userJid: authState.creds.me?.id,
2603
- messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id || jid),
2604
- ...options,
2605
- });
2606
- await relayRichMessage(jid, fullMsg, options);
2607
- if (config.emitOwnEvents) {
2608
- process.nextTick(async () => {
2609
- await messageMutex.mutex(() => upsertMessage(fullMsg, 'append'));
2610
- });
2611
- }
2612
- return fullMsg;
2613
- };
2614
- /** Send a provider-neutral AIRich social/entity result card. */
2615
- socket.sendSocialEntity = async (jid, content = {}, options = {}) => {
2616
- if (!jid) throw new Boom('sendSocialEntity requires a target JID', { statusCode: 400 });
2617
- const wrapped = prepareSocialEntityMessage(content);
2618
- const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
2619
- logger,
2620
- userJid: authState.creds.me?.id,
2621
- messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id || jid),
2622
- ...options,
2623
- });
2624
- await relayRichMessage(jid, fullMsg, options);
2625
- if (config.emitOwnEvents) process.nextTick(async () => { await messageMutex.mutex(() => upsertMessage(fullMsg, 'append')); });
2626
- return fullMsg;
2627
- };
2628
-
2629
- /** Send the primary Instagram profile result using the universal social/entity API. */
2630
- socket.sendInstagramProfile = async (jid, content = {}, options = {}) => {
2631
- if (!jid) throw new Boom('sendInstagramProfile requires a target JID', { statusCode: 400 });
2632
- const wrapped = prepareInstagramProfileMessage(content);
2633
- const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
2634
- logger,
2635
- userJid: authState.creds.me?.id,
2636
- messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id || jid),
2637
- ...options,
2638
- });
2639
- await relayRichMessage(jid, fullMsg, options);
2640
- if (config.emitOwnEvents) process.nextTick(async () => { await messageMutex.mutex(() => upsertMessage(fullMsg, 'append')); });
2641
- return fullMsg;
2642
- };
2643
-
2644
- /** Sends a rich response with experimental BotInfrastructureDiagnostics metadata. */
2645
- socket.sendBotDiagnostics = async (jid, content = {}, options = {}) => {
2646
- if (!jid) throw new Boom('sendBotDiagnostics requires a target JID', { statusCode: 400 });
2647
- const { text = 'Bot diagnostics test', botBackend = 0, toolsUsed = [], isThinking = false, botJid = '867051314767696@bot' } = content;
2648
- const wrapped = {
2649
- messageContextInfo: { botMetadata: { botInfrastructureDiagnostics: { botBackend, toolsUsed, isThinking } } },
2650
- botForwardedMessage: { message: { richResponseMessage: { messageType: 1, submessages: [{ messageType: 2, messageText: text }], contextInfo: { isForwarded: true, forwardingScore: 1, forwardedAiBotMessageInfo: { botJid }, forwardOrigin: 4 } } } }
2651
- };
2652
- const fullMsg = await generateWAMessageFromContent(jid, wrapped, { logger, userJid: authState.creds.me?.id, messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id), ...options });
2653
- await relayRichMessage(jid, fullMsg, options);
2654
- return fullMsg;
2655
- };
2656
- /** Sends a rich response with experimental BotCommandMetadata. */
2657
- socket.sendBotCommand = async (jid, content = {}, options = {}) => {
2658
- if (!jid) throw new Boom('sendBotCommand requires a target JID', { statusCode: 400 });
2659
- const { text = 'Bot command test', commandName = '', commandDescription = '', commandPrompt = '', botJid = '867051314767696@bot' } = content;
2660
- const wrapped = buildBotRichResponse({ text, botJid, botMetadata: { commandMetadata: { commandName, commandDescription, commandPrompt } } });
2661
- const fullMsg = await generateWAMessageFromContent(jid, wrapped, { logger, userJid: authState.creds.me?.id, messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id), ...options });
2662
- await relayRichMessage(jid, fullMsg, options);
2663
- return fullMsg;
2664
- };
2665
- /** Sends a planning/execution-plan rich response with WAProto capabilities. */
2666
- socket.sendBotPlanning = async (jid, content = {}, options = {}) => {
2667
- if (!jid) throw new Boom('sendBotPlanning requires a target JID', { statusCode: 400 });
2668
- const { text = 'Execution plan', steps = [], queryPlan = true, botJid = '867051314767696@bot' } = content;
2669
- const submessages = [
2670
- { messageType: proto.AIRichResponseSubMessageType.AI_RICH_RESPONSE_TEXT, messageText: text },
2671
- ...steps.map(step => ({
2672
- messageType: proto.AIRichResponseSubMessageType.AI_RICH_RESPONSE_TEXT,
2673
- messageText: typeof step === 'string' ? step : `${step.title || step.name || 'Step'}${step.body ? `: ${step.body}` : ''}`
2674
- }))
2675
- ];
2676
- const wrapped = buildBotRichResponse({
2677
- botJid,
2678
- submessages,
2679
- capabilities: [
2680
- BotCapabilityType.AGENTIC_PLANNING,
2681
- ...(queryPlan ? [BotCapabilityType.QUERY_PLAN] : [])
2682
- ]
2683
- });
2684
- const fullMsg = await generateWAMessageFromContent(jid, wrapped, { logger, userJid: authState.creds.me?.id, messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id), ...options });
2685
- await relayRichMessage(jid, fullMsg, options);
2686
- return fullMsg;
2687
- };
2688
- /** Sends a rich response with experimental BotResolvedToolCallMetadata. */
2689
- socket.sendBotToolResult = async (jid, content = {}, options = {}) => {
2690
- if (!jid) throw new Boom('sendBotToolResult requires a target JID', { statusCode: 400 });
2691
- const { text = 'Bot tool result test', toolCallId = `tool-${Date.now()}`, resolutionData, resolutionDataSerialized, botJid = '867051314767696@bot' } = content;
2692
- const wrapped = buildBotRichResponse({
2693
- text,
2694
- botJid,
2695
- capabilities: [BotCapabilityType.AGENTIC_PLANNING, BotCapabilityType.QUERY_PLAN],
2696
- botMetadata: {
2697
- resolvedToolCallMetadata: {
2698
- toolCallId,
2699
- resolutionDataSerialized: resolutionDataSerialized ?? JSON.stringify(resolutionData ?? {})
2700
- }
2701
- }
2702
- });
2703
- const fullMsg = await generateWAMessageFromContent(jid, wrapped, { logger, userJid: authState.creds.me?.id, messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id), ...options });
2704
- await relayRichMessage(jid, fullMsg, options);
2705
- return fullMsg;
2706
- };
2707
- /**
2708
- * Sends a real BotProgressIndicatorMetadata planning envelope. The plan is
2709
- * application-controlled; this advertises the public schema capability but
2710
- * does not claim to invoke Meta's private planning backend.
2711
- */
2712
- socket.sendBotPlan = async (jid, content = {}, options = {}) => {
2713
- if (!jid) throw new Boom('sendBotPlan requires a target JID', { statusCode: 400 });
2714
- const {
2715
- text = 'Execution plan',
2716
- title = 'Execution plan',
2717
- steps = [],
2718
- estimatedCompletionTime,
2719
- botJid = '867051314767696@bot'
2720
- } = content;
2721
- if (!Array.isArray(steps) || steps.length === 0) {
2722
- throw new Boom('sendBotPlan requires at least one step', { statusCode: 400 });
2723
- }
2724
- const planningStatus = proto.BotProgressIndicatorMetadata.BotPlanningStepMetadata.PlanningStepStatus;
2725
- const normalizedSteps = steps.map((step, index) => ({
2726
- statusTitle: String(step.title || step.name || `Step ${index + 1}`),
2727
- statusBody: String(step.body || step.description || ''),
2728
- status: step.status === 'executing' ? planningStatus.EXECUTING
2729
- : step.status === 'finished' || step.status === 'completed' ? planningStatus.FINISHED
2730
- : planningStatus.PLANNED,
2731
- isReasoning: step.isReasoning === true,
2732
- isEnhancedSearch: step.isEnhancedSearch === true,
2733
- ...(Array.isArray(step.sections) ? { sections: step.sections } : {})
2734
- }));
2735
- const wrapped = {
2736
- messageContextInfo: { botMetadata: {
2737
- capabilityMetadata: {
2738
- capabilities: [
2739
- proto.BotCapabilityMetadata.BotCapabilityType.AGENTIC_PLANNING,
2740
- proto.BotCapabilityMetadata.BotCapabilityType.QUERY_PLAN
2741
- ]
2742
- },
2743
- progressIndicatorMetadata: {
2744
- progressDescription: title,
2745
- stepsMetadata: normalizedSteps,
2746
- ...(estimatedCompletionTime ? { estimatedCompletionTime } : {})
1325
+ // Lia@Changes 31-01-26 --- Add support for album messages
1326
+ // Lia@Note 06-02-26 --- Refactored to reduce high RSS usage (⁠╥⁠﹏⁠╥⁠)
1327
+ if ('album' in content) {
1328
+ const { delayMs = 1500 } = options;
1329
+ for (const albumMedia of content.album) {
1330
+ const albumMsg = await generateWAMessage(jid, albumMedia, {
1331
+ logger,
1332
+ userJid,
1333
+ upload: waUploadToServer,
1334
+ mediaCache: config.mediaCache,
1335
+ options: config.options,
1336
+ ...options,
1337
+ messageId: generateMessageIDV2(userJid)
1338
+ });
1339
+ if (!hasValidAlbumMedia(normalizeMessageContent(albumMsg.message))) {
1340
+ throw new Boom('Invalid message type for album', { statusCode: 400 });
1341
+ }
1342
+ albumMsg.message.messageContextInfo ||= {};
1343
+ albumMsg.message.messageContextInfo.messageAssociation = {
1344
+ parentMessageKey: fullMsg.key,
1345
+ associationType: AssociationType.MEDIA_ALBUM
1346
+ };
1347
+ await relayMessage(jid, albumMsg.message, {
1348
+ messageId: albumMsg.key.id,
1349
+ useCachedGroupMetadata: options.useCachedGroupMetadata,
1350
+ addBizAttributes: isNeedBizAttrs,
1351
+ statusJidList: options.statusJidList,
1352
+ additionalAttributes,
1353
+ additionalNodes
1354
+ });
1355
+ if (config.emitOwnEvents) {
1356
+ process.nextTick(async () => {
1357
+ await messageMutex.mutex(() => upsertMessage(albumMsg, 'append'));
1358
+ });
1359
+ }
1360
+ await delay(delayMs);
2747
1361
  }
2748
- } },
2749
- botForwardedMessage: { message: { richResponseMessage: {
2750
- messageType: 1,
2751
- submessages: [{ messageType: 2, messageText: text }],
2752
- contextInfo: { isForwarded: true, forwardingScore: 1, forwardedAiBotMessageInfo: { botJid }, forwardOrigin: 4 }
2753
- } } }
2754
- };
2755
- const fullMsg = await generateWAMessageFromContent(jid, wrapped, { logger, userJid: authState.creds.me?.id, messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id), ...options });
2756
- await relayMessage(jid, fullMsg.message, { messageId: fullMsg.key.id, useCachedGroupMetadata: options.useCachedGroupMetadata, statusJidList: options.statusJidList });
2757
- return fullMsg;
2758
- };
2759
- socket.sendStatus = async (content, options = {}) => {
2760
- const statusJidList = await resolveStatusRecipients(options.statusJidList || content?.statusJidList);
2761
- return socket.sendMessage(STATUS_JID, {
2762
- ...content,
2763
- status: true
2764
- }, {
2765
- ...options,
2766
- broadcast: true,
2767
- statusJidList
2768
- });
2769
- };
2770
- socket.sendRichButtonGrid = async (jid, grid, options = {}) => {
2771
- const { text, footer, cards = [] } = grid || {};
2772
- if (!Array.isArray(cards) || cards.length === 0) {
2773
- throw new Boom('sendRichButtonGrid expects at least one card', { statusCode: 400 });
2774
- }
2775
- const normalizedCards = cards.map((card, index) => {
2776
- const buttons = card.buttons || card.nativeFlow || [];
2777
- if (!Array.isArray(buttons) || buttons.length === 0) {
2778
- throw new Boom(`sendRichButtonGrid card ${index + 1} needs buttons`, { statusCode: 400 });
2779
- }
2780
- return {
2781
- ...card,
2782
- nativeFlow: buttons,
2783
- caption: card.caption || card.title || `Menu ${index + 1}`
2784
- };
2785
- });
2786
- return socket.sendMessage(jid, {
2787
- ...(text ? { text } : {}),
2788
- ...(footer ? { footer } : {}),
2789
- cards: normalizedCards
2790
- }, options);
2791
- };
2792
- /**
2793
- * Compatibility entry point for the former Gen4/grid menu.
2794
- * This is additive: sendRichButtonGrid remains unchanged for existing callers.
2795
- */
2796
- socket.HoldOn = async (jid, grid, options = {}) => socket.sendRichButtonGrid(jid, grid, options);
2797
- socket.sendWhatsAppFlow = async (jid, flow, options = {}) => {
2798
- const { text, footer, image, caption, ...flowOptions } = flow || {};
2799
- const button = makeWhatsAppFlowButton(flowOptions);
2800
- return socket.sendMessage(jid, {
2801
- ...(image ? { image, caption: caption || text || flowOptions.cta } : { text: text || flowOptions.cta }),
2802
- ...(footer ? { footer } : {}),
2803
- nativeFlow: [button]
2804
- }, options);
2805
- };
2806
- /**
2807
- * Send a rich URL CTA intended to open a hosted WebView/Mini App.
2808
- * `useWebview` is serialized by the existing native-flow normalizer.
2809
- * `toast` is preserved as immediate button acknowledgement metadata.
2810
- */
2811
- socket.sendRichWebview = async (jid, content = {}, options = {}) => {
2812
- const { text = '', title, footer, image, caption, buttonText = 'Open', url, useWebview = true, toast, ...rest } = content;
2813
- if (!url || typeof url !== 'string') {
2814
- throw new Boom('sendRichWebview requires a URL', { statusCode: 400 });
2815
- }
2816
- const button = { text: buttonText, url, useWebview, ...(toast ? { toast } : {}), ...rest };
2817
- return socket.sendMessage(jid, {
2818
- ...(image ? { image, caption: caption || text || title || buttonText } : { text: text || title || buttonText }),
2819
- ...(footer ? { footer } : {}),
2820
- nativeFlow: [button],
2821
- ...(toast ? { toast } : {})
2822
- }, options);
2823
- };
2824
- socket.sendInteractiveTable = async (jid, table, options = {}) => {
2825
- const { title = '', headers = [], rows = [], image, buttons = [], footer } = table || {};
2826
- if (!Array.isArray(headers) || !Array.isArray(rows) || !Array.isArray(buttons)) {
2827
- throw new Boom('sendInteractiveTable expects headers, rows, and buttons arrays', { statusCode: 400 });
2828
- }
2829
- const lines = [];
2830
- if (title) lines.push(String(title));
2831
- if (headers.length) lines.push(`| ${headers.map(String).join(' | ')} |`);
2832
- if (headers.length) lines.push(`| ${headers.map(() => '---').join(' | ')} |`);
2833
- for (const row of rows) {
2834
- lines.push(`| ${(Array.isArray(row) ? row : [row]).map(value => String(value ?? '')).join(' | ')} |`);
2835
- }
2836
- const content = {
2837
- ...(image ? { caption: lines.join('\n'), image } : { text: lines.join('\n') }),
2838
- buttons: buttons.map((button, index) => ({
2839
- id: button.id || `table_${index + 1}`,
2840
- text: button.text || button.buttonText || `Option ${index + 1}`
2841
- })),
2842
- ...(footer ? { footer } : {})
2843
- };
2844
- return socket.sendMessage(jid, content, options);
2845
- };
2846
- // ====================================
2847
- // VIEW-ONCE AUTO-DECRYPT & AUTO-DELETE
2848
- // ====================================
2849
-
2850
- /**
2851
- * Auto-decrypt view-once messages (autoVV)
2852
- * Downloads the media content from a view-once message and re-emits it
2853
- * as a regular message with decryptedMedia attached.
2854
- */
2855
- socket.autoVV = async (message, options = {}) => {
2856
- if (!isViewOnceMessage(message)) {
2857
- logger.debug({ key: message?.key }, 'autoVV: message is not a view-once message');
2858
- return null;
2859
- }
2860
-
2861
- const info = parseViewOnceInfo(message);
2862
- logger.info({ key: message?.key, ...info }, 'autoVV: decrypting view-once message');
2863
-
2864
- try {
2865
- // Download and decrypt the media
2866
- const mediaBuffer = await downloadViewOnceMedia(message, {
2867
- logger,
2868
- ...options,
2869
- });
2870
-
2871
- // Create a regular message from the decrypted content
2872
- const regularMessage = createRegularMessageFromViewOnce(message, mediaBuffer);
2873
-
2874
- if (regularMessage) {
2875
- // Emit as a new message with decrypted content
2876
- ev.emit('messages.upsert', {
2877
- messages: [regularMessage],
2878
- type: 'append',
2879
- });
2880
-
2881
- logger.info({
2882
- key: message?.key,
2883
- mediaType: info.mediaType,
2884
- bufferSize: mediaBuffer.length,
2885
- }, 'autoVV: successfully decrypted view-once message');
2886
- }
2887
-
2888
- return regularMessage;
2889
- } catch (error) {
2890
- logger.error({
2891
- key: message?.key,
2892
- error: error.message,
2893
- }, 'autoVV: failed to decrypt view-once message');
2894
- throw error;
2895
- }
2896
- };
2897
-
2898
- /**
2899
- * Auto-delete view-once messages (antiVV)
2900
- * Detects incoming view-once messages and deletes them immediately.
2901
- * This prevents the sender from knowing the message was viewed.
2902
- */
2903
- socket.antiVV = async (message, options = {}) => {
2904
- if (!isViewOnceMessage(message)) {
2905
- logger.debug({ key: message?.key }, 'antiVV: message is not a view-once message');
2906
- return false;
2907
- }
2908
-
2909
- const info = parseViewOnceInfo(message);
2910
- logger.info({ key: message?.key, ...info }, 'antiVV: deleting view-once message');
2911
-
2912
- try {
2913
- // Delete the message by sending a revoke receipt
2914
- const jid = message.key.remoteJid;
2915
- const participant = message.key.participant || jid;
2916
- const messageId = message.key.id;
2917
-
2918
- // Send a revoke receipt to delete the message
2919
- await sendReceipt(jid, participant, [messageId], 'sender');
2920
-
2921
- // Also emit a message update to remove it from local store
2922
- ev.emit('messages.update', [
2923
- {
2924
- key: message.key,
2925
- update: {
2926
- messageStubType: proto.WebMessageInfo.StubType.REVOKE,
2927
- messageStubParameters: ['auto-vv-delete'],
2928
- },
2929
- },
2930
- ]);
2931
-
2932
- logger.info({
2933
- key: message?.key,
2934
- mediaType: info.mediaType,
2935
- }, 'antiVV: successfully deleted view-once message');
2936
-
2937
- return true;
2938
- } catch (error) {
2939
- logger.error({
2940
- key: message?.key,
2941
- error: error.message,
2942
- }, 'antiVV: failed to delete view-once message');
2943
- throw error;
2944
- }
2945
- };
2946
-
2947
- /**
2948
- * Check if a message is a view-once message
2949
- */
2950
- socket.isViewOnce = (message) => isViewOnceMessage(message);
2951
-
2952
- /**
2953
- * Get view-once message info (media type, mime type, etc.)
2954
- */
2955
- socket.getViewOnceInfo = (message) => parseViewOnceInfo(message);
2956
-
2957
-
2958
- /**
2959
- * Sends a full-width vertical AIRich album. Unlike the legacy
2960
- * albumMessage collection or compact GRID_IMAGE layout, this is one
2961
- * forwarded unified-response message with one large media item per row.
2962
- */
2963
- socket.sendAlbumMessage = async (jid, medias = [], options = {}) => {
2964
- if (!jid) throw new Boom('sendAlbumMessage requires a target JID', { statusCode: 400 });
2965
- if (!Array.isArray(medias) || medias.length < 2) {
2966
- throw new Boom('sendAlbumMessage requires at least two media items', { statusCode: 400 });
2967
- }
2968
- const albumItems = medias.map((media) => {
2969
- const raw = media?.type && media?.data ? media.data : (media?.image ?? media);
2970
- if (media?.video || media?.type === 'video') {
2971
- const video = media?.video || raw;
2972
- const sourceUrl = typeof video === 'string' ? video : (video?.url || video?.videoUrl || '');
2973
- if (!sourceUrl) throw new Boom('Each video album item requires a video URL', { statusCode: 400 });
2974
- return { type: 'video', video: { ...video, url: sourceUrl } };
1362
+ }
1363
+ return fullMsg;
2975
1364
  }
2976
- return {
2977
- type: 'image',
2978
- image: raw
2979
- };
2980
- });
2981
- const wrapped = prepareVerticalAlbumMessage({
2982
- items: albumItems,
2983
- verificationMetadata: options.verificationMetadata
2984
- });
2985
- const fullMsg = generateWAMessageFromContent(jid, wrapped, {
2986
- logger,
2987
- userJid: authState.creds.me?.id,
2988
- messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id || jid),
2989
- ...options
2990
- });
2991
- await relayRichMessage(jid, fullMsg, options);
2992
- if (config.emitOwnEvents) {
2993
- process.nextTick(async () => {
2994
- await messageMutex.mutex(() => upsertMessage(fullMsg, 'append'));
2995
- });
2996
- }
2997
- return fullMsg;
2998
- };
2999
-
3000
- /**
3001
- * Sends a unified-response video grid. This uses GenAIVideoPrimitive items
3002
- * inside GenAIGridLayoutViewModel; it is not the image-only GRID_IMAGE type.
3003
- */
3004
- socket.sendVideoGridMessage = async (jid, videos = [], options = {}) => {
3005
- if (!jid) throw new Boom('sendVideoGridMessage requires a target JID', { statusCode: 400 });
3006
- if (!Array.isArray(videos) || videos.length < 2) {
3007
- throw new Boom('sendVideoGridMessage requires at least two videos', { statusCode: 400 });
3008
1365
  }
3009
- const wrapped = prepareVideoGridMessage({
3010
- videos,
3011
- verificationMetadata: options.verificationMetadata
3012
- });
3013
- const fullMsg = generateWAMessageFromContent(jid, wrapped, {
3014
- logger,
3015
- userJid: authState.creds.me?.id,
3016
- messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id || jid),
3017
- ...options
3018
- });
3019
- await relayRichMessage(jid, fullMsg, options);
3020
- if (config.emitOwnEvents) {
3021
- process.nextTick(async () => {
3022
- await messageMutex.mutex(() => upsertMessage(fullMsg, 'append'));
3023
- });
3024
- }
3025
- return fullMsg;
3026
- };
3027
-
3028
-
3029
- /**
3030
- * Sends an HTML message — renders raw HTML inside the chat bubble.
3031
- * Uses FOAHtmlPrimitiveDemoDONOTUSE for full HTML/CSS/JS rendering.
3032
- *
3033
- * @param {string} jid - Target JID
3034
- * @param {Object} content - { html: string, trustedSources?: string[] }
3035
- * @param {Object} options - Additional options
3036
- * @returns {Object} Sent message info
3037
- *
3038
- * @example
3039
- * // Simple HTML
3040
- * await sock.sendHtmlMessage(jid, {
3041
- * html: '<h1>Hello!</h1><p style="color: blue">World</p>'
3042
- * })
3043
- */
3044
- socket.sendHtmlMessage = async (jid, content = {}, options = {}) => {
3045
- if (!jid) throw new Boom('sendHtmlMessage requires a target JID', { statusCode: 400 });
3046
- const { html, trustedSources } = content;
3047
- if (!html) throw new Boom('sendHtmlMessage requires html content', { statusCode: 400 });
3048
- const wrapped = prepareHtmlMessage({ html, trustedSources });
3049
- const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
3050
- logger,
3051
- userJid: authState.creds.me?.id,
3052
- messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id),
3053
- ...options
3054
- });
3055
- await relayRichMessage(jid, fullMsg, { ...options, forceRichEdit: true });
3056
- return fullMsg;
3057
- };
3058
-
3059
- /**
3060
- * Sends an interactive GenAI HTML screen with embedded tabs.
3061
- * This is distinct from sendHtmlMessage(): it uses the aeacdsnw HTML
3062
- * primitive and FOAIDNixelButtonSheets envelope used by interactive games.
3063
- *
3064
- * @param {string} jid - Target JID
3065
- * @param {Object} content - { html, title?, tabs?, trustedSources?, url? }
3066
- * @param {Object} options - Additional relay options
3067
- */
3068
- socket.sendRichHtmlMessage = async (jid, content = {}, options = {}) => {
3069
- if (!jid) throw new Boom('sendRichHtmlMessage requires a target JID', { statusCode: 400 });
3070
- if (!content.html && !(Array.isArray(content.tabs) && content.tabs.length)) {
3071
- throw new Boom('sendRichHtmlMessage requires html or tabs content', { statusCode: 400 });
3072
- }
3073
- const wrapped = prepareRichHtmlMessage(content);
3074
- const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
3075
- logger,
3076
- userJid: authState.creds.me?.id,
3077
- messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id),
3078
- ...options
3079
- });
3080
- await relayRichMessage(jid, fullMsg, options);
3081
- return fullMsg;
3082
- };
3083
-
3084
- /** Find a word or expression in the installed package source. */
3085
- socket.grepCode = (pattern, options = {}) => grepSource(pattern, options);
3086
-
3087
-
3088
- /**
3089
- * Sends a slot machine game — Fruit Bonanza!
3090
- * Renders a fully interactive canvas-based slot machine inside the chat bubble.
3091
- *
3092
- * @param {string} jid - Target JID
3093
- * @param {Object} [options] - Game options
3094
- * @param {string} [options.title='FRUIT BONANZA'] - Machine title
3095
- * @param {number} [options.startingCredits=500] - Starting credits
3096
- * @param {Object} [sendOptions] - Send options (quoted, etc.)
3097
- * @returns {Object} Sent message info
3098
- *
3099
- * @example
3100
- * // Default slot machine
3101
- * await sock.sendSlotMachine(jid)
3102
- *
3103
- * // Custom title and credits
3104
- * await sock.sendSlotMachine(jid, { title: 'MEGA SLOTS', startingCredits: 1000 })
3105
- */
3106
- socket.sendSlotMachine = async (jid, options = {}, sendOptions = {}) => {
3107
- if (!jid) throw new Boom('sendSlotMachine requires a target JID', { statusCode: 400 });
3108
- const html = generateSlotMachineHtml(options);
3109
- return socket.sendHtmlMessage(jid, { html }, sendOptions);
3110
- };
3111
-
3112
- /** Sends the attached interactive mini-app through the rich HTML envelope. */
3113
- socket.sendMiniApp = async (jid, options = {}, sendOptions = {}) => {
3114
- if (!jid) throw new Boom('sendMiniApp requires a target JID', { statusCode: 400 });
3115
- return socket.sendRichHtmlMessage(jid, {
3116
- html: generateMiniAppHtml(options),
3117
- title: options.title || 'mini-app',
3118
- url: 'https://pair.crysnova.link',
3119
- trustedSources: ['pair.crysnova.link']
3120
- }, sendOptions);
3121
- };
3122
-
3123
-
3124
- /**
3125
- * Mirrors a website inside the WhatsApp chat bubble.
3126
- * Fetches the site and renders it in a sandboxed iframe.
3127
- *
3128
- * @param {string} jid - Target JID
3129
- * @param {string} url - Website URL to mirror
3130
- * @param {Object} [options] - Preview options
3131
- * @param {boolean} [options.sandbox=true] - Sandbox restrictions
3132
- * @param {string} [options.height='600px'] - Preview height
3133
- * @param {boolean} [options.showUrl=true] - Show URL bar
3134
- * @param {Object} [sendOptions] - Send options
3135
- * @returns {Object} Sent message info
3136
- *
3137
- * @example
3138
- * await sock.sendWebsitePreview(jid, 'https://google.com')
3139
- * await sock.sendWebsitePreview(jid, 'https://example.com', { height: '400px' })
3140
- */
3141
- socket.sendWebsitePreview = async (jid, url, options = {}, sendOptions = {}) => {
3142
- if (!jid) throw new Boom('sendWebsitePreview requires a target JID', { statusCode: 400 });
3143
- if (!url) throw new Boom('sendWebsitePreview requires a URL', { statusCode: 400 });
3144
- const html = await generateWebsitePreviewHtml(url, options);
3145
- return socket.sendHtmlMessage(jid, { html }, sendOptions);
3146
- };
3147
-
3148
- /**
3149
- * Sends a link preview card for a URL.
3150
- * Lighter weight than sendWebsitePreview — just shows title, description, image.
3151
- *
3152
- * @param {string} jid - Target JID
3153
- * @param {string} url - URL to preview
3154
- * @param {Object} [options] - Card options
3155
- * @param {string} [options.title] - Override title
3156
- * @param {string} [options.description] - Override description
3157
- * @param {string} [options.image] - Override image URL
3158
- * @param {Object} [sendOptions] - Send options
3159
- * @returns {Object} Sent message info
3160
- *
3161
- * @example
3162
- * await sock.sendLinkPreview(jid, 'https://google.com')
3163
- * await sock.sendLinkPreview(jid, 'https://example.com', {
3164
- * title: 'My Website',
3165
- * description: 'Check out my cool site!',
3166
- * image: 'https://example.com/og.png'
3167
- * })
3168
- */
3169
- socket.sendLinkPreview = async (jid, url, options = {}, sendOptions = {}) => {
3170
- if (!jid) throw new Boom('sendLinkPreview requires a target JID', { statusCode: 400 });
3171
- if (!url) throw new Boom('sendLinkPreview requires a URL', { statusCode: 400 });
3172
- const html = generateLinkPreviewHtml(url, options);
3173
- return socket.sendHtmlMessage(jid, { html }, sendOptions);
3174
1366
  };
3175
-
3176
- return socket;
3177
1367
  };
1368
+ //# sourceMappingURL=messages-send.js.map