zapo-js 0.3.0 → 1.0.1

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 (781) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +98 -178
  3. package/dist/appstate/{WaAppStateCrypto.js → crypto/WaAppStateCrypto.js} +58 -49
  4. package/dist/appstate/index.js +7 -6
  5. package/dist/appstate/{encoding.js → parsers/encoding.js} +11 -4
  6. package/dist/appstate/{response-parser.js → parsers/response-parser.js} +20 -8
  7. package/dist/appstate/{WaAppStateSyncClient.js → sync/WaAppStateSyncClient.js} +174 -53
  8. package/dist/appstate/utils.js +16 -0
  9. package/dist/appstate-spec.js +89 -0
  10. package/dist/auth/WaAuthClient.js +100 -5
  11. package/dist/auth/credentials-flow.js +20 -8
  12. package/dist/auth/pairing/WaPairingFlow.js +35 -26
  13. package/dist/auth/pairing/pairing-code-crypto.js +17 -19
  14. package/dist/client/WaClient.js +343 -474
  15. package/dist/client/WaClientFactory.js +281 -78
  16. package/dist/client/connection/WaConnectionManager.js +28 -11
  17. package/dist/client/coordinators/WaAbPropsCoordinator.js +1 -2
  18. package/dist/client/coordinators/WaAppStateMutationCoordinator.js +663 -143
  19. package/dist/client/coordinators/WaBotCoordinator.js +345 -0
  20. package/dist/client/coordinators/WaBroadcastListCoordinator.js +20 -0
  21. package/dist/client/coordinators/WaBusinessCoordinator.js +81 -171
  22. package/dist/client/coordinators/WaEmailCoordinator.js +1 -0
  23. package/dist/client/coordinators/WaGroupCoordinator.js +529 -52
  24. package/dist/client/coordinators/WaIncomingNodeCoordinator.js +97 -12
  25. package/dist/client/coordinators/WaLowLevelCoordinator.js +41 -0
  26. package/dist/client/coordinators/WaMessageCoordinator.js +365 -0
  27. package/dist/client/coordinators/WaMessageDispatchCoordinator.js +685 -207
  28. package/dist/client/coordinators/WaNewsletterCoordinator.js +18 -0
  29. package/dist/client/coordinators/WaPassiveTasksCoordinator.js +17 -4
  30. package/dist/client/coordinators/WaPresenceCoordinator.js +21 -0
  31. package/dist/client/coordinators/WaPrivacyCoordinator.js +7 -5
  32. package/dist/client/coordinators/WaProfileCoordinator.js +220 -49
  33. package/dist/client/coordinators/WaRetryCoordinator.js +257 -126
  34. package/dist/client/coordinators/WaStatusCoordinator.js +49 -0
  35. package/dist/client/coordinators/WaStreamControlCoordinator.js +8 -9
  36. package/dist/client/coordinators/WaTrustedContactTokenCoordinator.js +7 -6
  37. package/dist/client/events/appstate-mutation.js +133 -0
  38. package/dist/client/events/business.js +375 -0
  39. package/dist/client/events/call.js +58 -0
  40. package/dist/client/events/chatstate.js +23 -0
  41. package/dist/client/events/devices.js +15 -16
  42. package/dist/client/{dirty.js → events/dirty.js} +33 -19
  43. package/dist/client/events/group.js +13 -24
  44. package/dist/client/events/identity.js +2 -1
  45. package/dist/client/events/incoming.js +502 -0
  46. package/dist/client/events/mex-notification.js +181 -0
  47. package/dist/client/events/picture.js +33 -0
  48. package/dist/client/events/presence.js +44 -0
  49. package/dist/client/events/receipt.js +26 -0
  50. package/dist/client/media.js +163 -6
  51. package/dist/client/messaging/fanout.js +9 -10
  52. package/dist/client/messaging/{participants.js → group-metadata.js} +93 -44
  53. package/dist/client/messaging/ignore-key.js +132 -0
  54. package/dist/client/messaging/key-protocol.js +4 -18
  55. package/dist/client/messaging/link-preview.js +159 -0
  56. package/dist/client/messaging/messages.js +671 -0
  57. package/dist/client/newsletter/admin.js +165 -0
  58. package/dist/client/newsletter/content.js +253 -0
  59. package/dist/client/newsletter/discovery.js +115 -0
  60. package/dist/client/newsletter/messaging.js +197 -0
  61. package/dist/client/newsletter/mex.js +41 -0
  62. package/dist/client/newsletter/parse.js +217 -0
  63. package/dist/client/persistence/WriteBehindPersistence.js +31 -4
  64. package/dist/client/{history-sync.js → persistence/history-sync.js} +125 -18
  65. package/dist/client/persistence/mailbox.js +104 -0
  66. package/dist/client/tokens/cs-token.js +11 -17
  67. package/dist/crypto/core/hkdf.js +12 -12
  68. package/dist/crypto/core/index.js +6 -8
  69. package/dist/crypto/core/keys.js +1 -8
  70. package/dist/crypto/core/nonce.js +12 -12
  71. package/dist/crypto/core/primitives.js +123 -93
  72. package/dist/crypto/core/random.js +6 -0
  73. package/dist/crypto/core/xeddsa.js +11 -9
  74. package/dist/crypto/curves/Ed25519.js +32 -21
  75. package/dist/crypto/curves/X25519.js +70 -34
  76. package/dist/crypto/curves/constants.js +2 -1
  77. package/dist/crypto/math/constants.js +1 -2
  78. package/dist/crypto/math/mod.js +0 -33
  79. package/dist/esm/appstate/{WaAppStateCrypto.js → crypto/WaAppStateCrypto.js} +58 -49
  80. package/dist/esm/appstate/index.js +5 -5
  81. package/dist/esm/appstate/{encoding.js → parsers/encoding.js} +11 -4
  82. package/dist/esm/appstate/{response-parser.js → parsers/response-parser.js} +20 -8
  83. package/dist/esm/appstate/{WaAppStateSyncClient.js → sync/WaAppStateSyncClient.js} +174 -52
  84. package/dist/esm/appstate/utils.js +16 -0
  85. package/dist/esm/appstate-spec.js +79 -0
  86. package/dist/esm/auth/WaAuthClient.js +100 -5
  87. package/dist/esm/auth/credentials-flow.js +18 -6
  88. package/dist/esm/auth/pairing/WaPairingFlow.js +34 -25
  89. package/dist/esm/auth/pairing/pairing-code-crypto.js +12 -14
  90. package/dist/esm/client/WaClient.js +345 -476
  91. package/dist/esm/client/WaClientFactory.js +282 -79
  92. package/dist/esm/client/connection/WaConnectionManager.js +28 -11
  93. package/dist/esm/client/coordinators/WaAbPropsCoordinator.js +2 -3
  94. package/dist/esm/client/coordinators/WaAppStateMutationCoordinator.js +665 -145
  95. package/dist/esm/client/coordinators/WaBotCoordinator.js +342 -0
  96. package/dist/esm/client/coordinators/WaBroadcastListCoordinator.js +17 -0
  97. package/dist/esm/client/coordinators/WaBusinessCoordinator.js +79 -169
  98. package/dist/esm/client/coordinators/WaEmailCoordinator.js +1 -0
  99. package/dist/esm/client/coordinators/WaGroupCoordinator.js +532 -55
  100. package/dist/esm/client/coordinators/WaIncomingNodeCoordinator.js +98 -13
  101. package/dist/esm/client/coordinators/WaLowLevelCoordinator.js +38 -0
  102. package/dist/esm/client/coordinators/WaMessageCoordinator.js +361 -0
  103. package/dist/esm/client/coordinators/WaMessageDispatchCoordinator.js +686 -208
  104. package/dist/esm/client/coordinators/WaNewsletterCoordinator.js +13 -0
  105. package/dist/esm/client/coordinators/WaPassiveTasksCoordinator.js +18 -5
  106. package/dist/esm/client/coordinators/WaPresenceCoordinator.js +18 -0
  107. package/dist/esm/client/coordinators/WaPrivacyCoordinator.js +7 -5
  108. package/dist/esm/client/coordinators/WaProfileCoordinator.js +223 -52
  109. package/dist/esm/client/coordinators/WaRetryCoordinator.js +258 -127
  110. package/dist/esm/client/coordinators/WaStatusCoordinator.js +46 -0
  111. package/dist/esm/client/coordinators/WaStreamControlCoordinator.js +8 -9
  112. package/dist/esm/client/coordinators/WaTrustedContactTokenCoordinator.js +7 -6
  113. package/dist/esm/client/events/appstate-mutation.js +130 -0
  114. package/dist/esm/client/events/business.js +370 -0
  115. package/dist/esm/client/events/call.js +55 -0
  116. package/dist/esm/client/events/chatstate.js +20 -0
  117. package/dist/esm/client/events/devices.js +15 -16
  118. package/dist/esm/client/{dirty.js → events/dirty.js} +33 -19
  119. package/dist/esm/client/events/group.js +14 -25
  120. package/dist/esm/client/events/identity.js +2 -1
  121. package/dist/esm/client/events/incoming.js +487 -0
  122. package/dist/esm/client/events/mex-notification.js +178 -0
  123. package/dist/esm/client/events/picture.js +30 -0
  124. package/dist/esm/client/events/presence.js +41 -0
  125. package/dist/esm/client/events/receipt.js +23 -0
  126. package/dist/esm/client/media.js +158 -8
  127. package/dist/esm/client/messaging/fanout.js +10 -11
  128. package/dist/esm/client/messaging/{participants.js → group-metadata.js} +92 -43
  129. package/dist/esm/client/messaging/ignore-key.js +126 -0
  130. package/dist/esm/client/messaging/key-protocol.js +3 -17
  131. package/dist/esm/client/messaging/link-preview.js +156 -0
  132. package/dist/esm/client/messaging/messages.js +667 -0
  133. package/dist/esm/client/newsletter/admin.js +162 -0
  134. package/dist/esm/client/newsletter/content.js +249 -0
  135. package/dist/esm/client/newsletter/discovery.js +112 -0
  136. package/dist/esm/client/newsletter/messaging.js +194 -0
  137. package/dist/esm/client/newsletter/mex.js +37 -0
  138. package/dist/esm/client/newsletter/parse.js +200 -0
  139. package/dist/esm/client/persistence/WriteBehindPersistence.js +31 -4
  140. package/dist/esm/client/{history-sync.js → persistence/history-sync.js} +124 -18
  141. package/dist/esm/client/persistence/mailbox.js +101 -0
  142. package/dist/esm/client/tokens/cs-token.js +12 -18
  143. package/dist/esm/crypto/core/hkdf.js +14 -14
  144. package/dist/esm/crypto/core/index.js +2 -2
  145. package/dist/esm/crypto/core/keys.js +1 -7
  146. package/dist/esm/crypto/core/nonce.js +11 -11
  147. package/dist/esm/crypto/core/primitives.js +121 -88
  148. package/dist/esm/crypto/core/random.js +6 -0
  149. package/dist/esm/crypto/core/xeddsa.js +11 -9
  150. package/dist/esm/crypto/curves/Ed25519.js +35 -24
  151. package/dist/esm/crypto/curves/X25519.js +72 -36
  152. package/dist/esm/crypto/curves/constants.js +1 -0
  153. package/dist/esm/crypto/math/constants.js +1 -2
  154. package/dist/esm/crypto/math/mod.js +0 -32
  155. package/dist/esm/index.js +7 -2
  156. package/dist/esm/infra/log/ConsoleLogger.js +30 -6
  157. package/dist/esm/infra/log/PinoLogger.js +64 -0
  158. package/dist/esm/infra/log/types.js +4 -2
  159. package/dist/esm/infra/perf/BackgroundQueue.js +55 -13
  160. package/dist/esm/media/constants.js +33 -2
  161. package/dist/esm/media/crypto/WaMediaCrypto.js +374 -0
  162. package/dist/esm/media/index.js +4 -3
  163. package/dist/esm/media/sticker/sticker-pack.js +133 -0
  164. package/dist/esm/media/{WaMediaTransferClient.js → transfer/WaMediaTransferClient.js} +37 -6
  165. package/dist/esm/media/{conn.js → transfer/conn.js} +10 -5
  166. package/dist/esm/message/WaMessageClient.js +46 -15
  167. package/dist/esm/message/addons/link-preview/builder.js +36 -0
  168. package/dist/esm/message/addons/link-preview/detect.js +55 -0
  169. package/dist/esm/message/addons/link-preview/fetcher.js +391 -0
  170. package/dist/esm/message/addons/link-preview/types.js +1 -0
  171. package/dist/esm/message/context-info.js +123 -0
  172. package/dist/esm/message/{addon-crypto.js → crypto/addon-crypto.js} +68 -10
  173. package/dist/esm/message/{icdc.js → crypto/icdc.js} +5 -7
  174. package/dist/esm/message/crypto/phash.js +133 -0
  175. package/dist/esm/message/{reporting-token.js → crypto/reporting-token.js} +6 -6
  176. package/dist/esm/message/{use-case-secret.js → crypto/use-case-secret.js} +20 -3
  177. package/dist/esm/message/{content.js → encode/content.js} +176 -7
  178. package/dist/esm/message/encode/media-payload.js +42 -0
  179. package/dist/esm/message/{padding.js → encode/padding.js} +9 -3
  180. package/dist/esm/message/index.js +2 -2
  181. package/dist/esm/message/kinds/bot.js +111 -0
  182. package/dist/esm/message/kinds/newsletter.js +244 -0
  183. package/dist/esm/message/kinds/sticker-pack.js +29 -0
  184. package/dist/esm/message/{ack.js → primitives/ack.js} +8 -1
  185. package/dist/esm/message/{incoming.js → primitives/incoming.js} +215 -31
  186. package/dist/esm/message/primitives/peer-data-operation.js +93 -0
  187. package/dist/esm/mex.js +1 -0
  188. package/dist/esm/protocol/abprops.js +10 -0
  189. package/dist/esm/protocol/appstate.js +6 -30
  190. package/dist/esm/protocol/auth.js +3 -2
  191. package/dist/esm/protocol/bot.js +77 -0
  192. package/dist/esm/protocol/browser.js +8 -0
  193. package/dist/esm/protocol/business.js +19 -0
  194. package/dist/esm/protocol/call.js +48 -0
  195. package/dist/esm/protocol/constants.js +8 -2
  196. package/dist/esm/protocol/defaults.js +3 -0
  197. package/dist/esm/protocol/index.js +1 -1
  198. package/dist/esm/protocol/jid.js +102 -5
  199. package/dist/esm/protocol/media.js +25 -12
  200. package/dist/esm/protocol/message.js +4 -1
  201. package/dist/esm/protocol/newsletter.js +61 -0
  202. package/dist/esm/protocol/nodes.js +22 -2
  203. package/dist/esm/protocol/notification.js +18 -2
  204. package/dist/esm/protocol/presence.js +13 -0
  205. package/dist/esm/protocol/status.js +6 -0
  206. package/dist/esm/retry/codec.js +5 -0
  207. package/dist/esm/retry/parse.js +20 -38
  208. package/dist/esm/retry/reason.js +5 -0
  209. package/dist/esm/retry/replay.js +131 -37
  210. package/dist/esm/retry/tracker.js +4 -8
  211. package/dist/esm/signal/api/SignalDeviceSyncApi.js +69 -20
  212. package/dist/esm/signal/api/SignalDigestSyncApi.js +7 -2
  213. package/dist/esm/signal/api/SignalIdentitySyncApi.js +9 -0
  214. package/dist/esm/signal/api/SignalMissingPreKeysSyncApi.js +24 -63
  215. package/dist/esm/signal/api/SignalRotateKeyApi.js +10 -0
  216. package/dist/esm/signal/api/SignalSessionSyncApi.js +23 -51
  217. package/dist/esm/signal/api/codec.js +52 -1
  218. package/dist/esm/signal/api/prekeys.js +4 -0
  219. package/dist/esm/signal/{crypto → attestation}/WaAdvSignature.js +5 -6
  220. package/dist/esm/signal/constants.js +3 -0
  221. package/dist/esm/signal/encoding.js +6 -289
  222. package/dist/esm/signal/group/SenderKeyChain.js +18 -33
  223. package/dist/esm/signal/group/SenderKeyManager.js +25 -8
  224. package/dist/esm/signal/group/encoding.js +96 -0
  225. package/dist/esm/signal/index.js +4 -1
  226. package/dist/esm/signal/registration/encoding.js +34 -0
  227. package/dist/esm/signal/registration/keygen.js +10 -0
  228. package/dist/esm/signal/registration/utils.js +8 -1
  229. package/dist/esm/signal/session/SignalProtocol.js +113 -11
  230. package/dist/esm/signal/session/SignalRatchet.js +29 -58
  231. package/dist/esm/signal/session/SignalSession.js +7 -14
  232. package/dist/esm/signal/session/encoding.js +173 -0
  233. package/dist/esm/signal/session/resolver.js +139 -30
  234. package/dist/esm/store/cache/identity.cache.js +75 -0
  235. package/dist/esm/store/cache/privacy-token.cache.js +57 -0
  236. package/dist/esm/store/cache/sender-key.cache.js +101 -0
  237. package/dist/esm/store/cache/session.cache.js +92 -0
  238. package/dist/esm/store/contracts/group-metadata.store.js +1 -0
  239. package/dist/esm/store/createStore.js +91 -37
  240. package/dist/esm/store/index.js +15 -14
  241. package/dist/esm/store/locks/contact.lock.js +1 -0
  242. package/dist/esm/store/locks/device-list.lock.js +1 -0
  243. package/dist/esm/store/locks/group-metadata.lock.js +20 -0
  244. package/dist/esm/store/locks/pre-key.lock.js +4 -1
  245. package/dist/esm/store/{providers/memory → memory}/appstate.store.js +5 -5
  246. package/dist/esm/store/memory/auth.store.js +24 -0
  247. package/dist/esm/store/memory/contact.store.js +79 -0
  248. package/dist/esm/store/memory/device-list.store.js +103 -0
  249. package/dist/esm/store/{providers/memory/participants.store.js → memory/group-metadata.store.js} +22 -13
  250. package/dist/esm/store/{providers/memory → memory}/identity.store.js +3 -3
  251. package/dist/esm/store/{providers/memory → memory}/message-secret.store.js +17 -8
  252. package/dist/esm/store/{providers/memory → memory}/message.store.js +2 -2
  253. package/dist/esm/store/{providers/memory → memory}/pre-key.store.js +2 -2
  254. package/dist/esm/store/{providers/memory → memory}/privacy-token.store.js +1 -1
  255. package/dist/esm/store/{providers/memory → memory}/retry.store.js +28 -7
  256. package/dist/esm/store/{providers/memory → memory}/sender-key.store.js +3 -3
  257. package/dist/esm/store/{providers/memory → memory}/session.store.js +3 -3
  258. package/dist/esm/store/{providers/memory → memory}/thread.store.js +2 -2
  259. package/dist/esm/store/noop.store.js +6 -4
  260. package/dist/esm/transport/WaComms.js +14 -5
  261. package/dist/esm/transport/WaWebSocket.js +32 -8
  262. package/dist/esm/transport/binary/constants.js +10 -4
  263. package/dist/esm/transport/binary/decoder.js +21 -15
  264. package/dist/esm/transport/binary/encoder.js +96 -21
  265. package/dist/esm/transport/binary/tokens.js +12 -12
  266. package/dist/esm/transport/index.js +1 -0
  267. package/dist/esm/transport/keepalive/WaKeepAlive.js +18 -4
  268. package/dist/esm/transport/node/WaMobileTcpSocket.js +6 -0
  269. package/dist/esm/transport/node/WaNodeOrchestrator.js +9 -5
  270. package/dist/esm/transport/node/WaNodeTransport.js +13 -0
  271. package/dist/esm/transport/node/builders/abprops.js +2 -2
  272. package/dist/esm/transport/node/builders/account-sync.js +7 -15
  273. package/dist/esm/transport/node/builders/bot.js +38 -0
  274. package/dist/esm/transport/node/builders/business.js +30 -30
  275. package/dist/esm/transport/node/builders/chatstate.js +28 -0
  276. package/dist/esm/transport/node/builders/community.js +53 -0
  277. package/dist/esm/transport/node/builders/device.js +2 -2
  278. package/dist/esm/transport/node/builders/email.js +6 -5
  279. package/dist/esm/transport/node/builders/global.js +1 -1
  280. package/dist/esm/transport/node/builders/group.js +114 -4
  281. package/dist/esm/transport/node/builders/media.js +2 -2
  282. package/dist/esm/transport/node/builders/message.js +83 -49
  283. package/dist/esm/transport/node/builders/newsletter.js +176 -0
  284. package/dist/esm/transport/node/builders/passive.js +7 -0
  285. package/dist/esm/transport/node/builders/prekeys.js +4 -4
  286. package/dist/esm/transport/node/builders/presence.js +27 -1
  287. package/dist/esm/transport/node/builders/privacy-token.js +2 -2
  288. package/dist/esm/transport/node/builders/privacy.js +6 -6
  289. package/dist/esm/transport/node/builders/profile.js +28 -8
  290. package/dist/esm/transport/node/builders/tos.js +58 -0
  291. package/dist/esm/transport/node/builders/usync.js +51 -2
  292. package/dist/esm/transport/node/helpers.js +3 -1
  293. package/dist/esm/transport/node/mex/argo-decoder.js +2 -2
  294. package/dist/esm/transport/node/mex/client.js +22 -0
  295. package/dist/esm/transport/node/query.js +17 -0
  296. package/dist/esm/transport/node/usync.js +12 -0
  297. package/dist/esm/transport/noise/WaClientPayload.js +8 -8
  298. package/dist/esm/transport/noise/WaMobileClientPayload.js +5 -0
  299. package/dist/esm/transport/noise/WaNoiseCert.js +5 -0
  300. package/dist/esm/transport/noise/WaNoiseHandshake.js +27 -25
  301. package/dist/esm/transport/noise/WaNoiseSession.js +39 -59
  302. package/dist/esm/transport/noise/WaNoiseSocket.js +19 -13
  303. package/dist/esm/transport/noise/constants.js +0 -1
  304. package/dist/esm/transport/proxy.js +5 -0
  305. package/dist/esm/transport/stream/parse.js +3 -7
  306. package/dist/esm/transport/wa-web-version-fetcher.js +91 -0
  307. package/dist/esm/util/async.js +4 -0
  308. package/dist/esm/util/bytes.js +37 -2
  309. package/dist/esm/util/clock.js +15 -0
  310. package/dist/esm/util/coercion.js +45 -3
  311. package/dist/esm/util/collections.js +11 -0
  312. package/dist/esm/util/index.js +2 -2
  313. package/dist/esm/util/primitives.js +19 -0
  314. package/dist/esm/util/runtime.js +5 -0
  315. package/dist/esm/version-spec.js +1 -0
  316. package/dist/index.js +35 -5
  317. package/dist/infra/log/ConsoleLogger.js +30 -6
  318. package/dist/infra/log/PinoLogger.js +64 -0
  319. package/dist/infra/log/types.js +4 -2
  320. package/dist/infra/perf/BackgroundQueue.js +55 -13
  321. package/dist/media/constants.js +34 -3
  322. package/dist/media/crypto/WaMediaCrypto.js +378 -0
  323. package/dist/media/index.js +9 -4
  324. package/dist/media/sticker/sticker-pack.js +136 -0
  325. package/dist/media/{WaMediaTransferClient.js → transfer/WaMediaTransferClient.js} +37 -6
  326. package/dist/media/{conn.js → transfer/conn.js} +10 -5
  327. package/dist/message/WaMessageClient.js +46 -15
  328. package/dist/message/addons/link-preview/builder.js +39 -0
  329. package/dist/message/addons/link-preview/detect.js +58 -0
  330. package/dist/message/addons/link-preview/fetcher.js +394 -0
  331. package/dist/message/addons/link-preview/types.js +2 -0
  332. package/dist/message/context-info.js +129 -0
  333. package/dist/message/{addon-crypto.js → crypto/addon-crypto.js} +68 -10
  334. package/dist/message/{icdc.js → crypto/icdc.js} +5 -7
  335. package/dist/message/crypto/phash.js +136 -0
  336. package/dist/message/{reporting-token.js → crypto/reporting-token.js} +6 -6
  337. package/dist/message/{use-case-secret.js → crypto/use-case-secret.js} +20 -3
  338. package/dist/message/{content.js → encode/content.js} +192 -7
  339. package/dist/message/encode/media-payload.js +45 -0
  340. package/dist/message/{padding.js → encode/padding.js} +9 -3
  341. package/dist/message/index.js +2 -2
  342. package/dist/message/kinds/bot.js +120 -0
  343. package/dist/message/kinds/newsletter.js +248 -0
  344. package/dist/message/kinds/sticker-pack.js +34 -0
  345. package/dist/message/{ack.js → primitives/ack.js} +8 -1
  346. package/dist/message/{incoming.js → primitives/incoming.js} +216 -31
  347. package/dist/message/primitives/peer-data-operation.js +96 -0
  348. package/dist/mex.js +6 -0
  349. package/dist/proto.js +1 -1
  350. package/dist/protocol/abprops.js +10 -0
  351. package/dist/protocol/appstate.js +7 -31
  352. package/dist/protocol/auth.js +3 -2
  353. package/dist/protocol/bot.js +81 -0
  354. package/dist/protocol/browser.js +8 -0
  355. package/dist/protocol/business.js +22 -0
  356. package/dist/protocol/call.js +51 -0
  357. package/dist/protocol/constants.js +39 -3
  358. package/dist/protocol/defaults.js +3 -0
  359. package/dist/protocol/index.js +12 -3
  360. package/dist/protocol/jid.js +107 -5
  361. package/dist/protocol/media.js +25 -12
  362. package/dist/protocol/message.js +4 -1
  363. package/dist/protocol/newsletter.js +64 -0
  364. package/dist/protocol/nodes.js +22 -2
  365. package/dist/protocol/notification.js +19 -3
  366. package/dist/protocol/presence.js +16 -0
  367. package/dist/protocol/status.js +9 -0
  368. package/dist/retry/codec.js +5 -0
  369. package/dist/retry/parse.js +16 -34
  370. package/dist/retry/reason.js +5 -0
  371. package/dist/retry/replay.js +130 -36
  372. package/dist/retry/tracker.js +3 -7
  373. package/dist/signal/api/SignalDeviceSyncApi.js +67 -18
  374. package/dist/signal/api/SignalDigestSyncApi.js +7 -2
  375. package/dist/signal/api/SignalIdentitySyncApi.js +9 -0
  376. package/dist/signal/api/SignalMissingPreKeysSyncApi.js +21 -60
  377. package/dist/signal/api/SignalRotateKeyApi.js +10 -0
  378. package/dist/signal/api/SignalSessionSyncApi.js +20 -48
  379. package/dist/signal/api/codec.js +52 -0
  380. package/dist/signal/api/prekeys.js +4 -0
  381. package/dist/signal/{crypto → attestation}/WaAdvSignature.js +6 -8
  382. package/dist/signal/constants.js +4 -1
  383. package/dist/signal/encoding.js +5 -303
  384. package/dist/signal/group/SenderKeyChain.js +18 -33
  385. package/dist/signal/group/SenderKeyCodec.js +2 -2
  386. package/dist/signal/group/SenderKeyManager.js +26 -9
  387. package/dist/signal/group/encoding.js +101 -0
  388. package/dist/signal/index.js +13 -10
  389. package/dist/signal/registration/encoding.js +39 -0
  390. package/dist/signal/registration/keygen.js +11 -1
  391. package/dist/signal/registration/utils.js +8 -1
  392. package/dist/signal/session/SignalProtocol.js +113 -11
  393. package/dist/signal/session/SignalRatchet.js +26 -56
  394. package/dist/signal/session/SignalSerializer.js +2 -2
  395. package/dist/signal/session/SignalSession.js +7 -15
  396. package/dist/signal/session/encoding.js +183 -0
  397. package/dist/signal/session/resolver.js +139 -30
  398. package/dist/store/cache/identity.cache.js +78 -0
  399. package/dist/store/cache/privacy-token.cache.js +60 -0
  400. package/dist/store/cache/sender-key.cache.js +104 -0
  401. package/dist/store/cache/session.cache.js +95 -0
  402. package/dist/store/contracts/group-metadata.store.js +2 -0
  403. package/dist/store/createStore.js +90 -36
  404. package/dist/store/index.js +18 -16
  405. package/dist/store/locks/contact.lock.js +1 -0
  406. package/dist/store/locks/device-list.lock.js +1 -0
  407. package/dist/store/locks/group-metadata.lock.js +23 -0
  408. package/dist/store/locks/pre-key.lock.js +4 -1
  409. package/dist/store/{providers/memory → memory}/appstate.store.js +5 -5
  410. package/dist/store/memory/auth.store.js +28 -0
  411. package/dist/store/memory/contact.store.js +83 -0
  412. package/dist/store/memory/device-list.store.js +107 -0
  413. package/dist/store/{providers/memory/participants.store.js → memory/group-metadata.store.js} +24 -15
  414. package/dist/store/{providers/memory → memory}/identity.store.js +3 -3
  415. package/dist/store/{providers/memory → memory}/message-secret.store.js +17 -8
  416. package/dist/store/{providers/memory → memory}/message.store.js +2 -2
  417. package/dist/store/{providers/memory → memory}/pre-key.store.js +2 -2
  418. package/dist/store/{providers/memory → memory}/privacy-token.store.js +1 -1
  419. package/dist/store/{providers/memory → memory}/retry.store.js +28 -7
  420. package/dist/store/{providers/memory → memory}/sender-key.store.js +3 -3
  421. package/dist/store/{providers/memory → memory}/session.store.js +3 -3
  422. package/dist/store/{providers/memory → memory}/thread.store.js +2 -2
  423. package/dist/store/noop.store.js +7 -5
  424. package/dist/transport/WaComms.js +14 -5
  425. package/dist/transport/WaWebSocket.js +32 -8
  426. package/dist/transport/binary/constants.js +11 -5
  427. package/dist/transport/binary/decoder.js +24 -18
  428. package/dist/transport/binary/encoder.js +109 -34
  429. package/dist/transport/binary/tokens.js +12 -12
  430. package/dist/transport/index.js +3 -1
  431. package/dist/transport/keepalive/WaKeepAlive.js +18 -4
  432. package/dist/transport/node/WaMobileTcpSocket.js +6 -0
  433. package/dist/transport/node/WaNodeOrchestrator.js +9 -5
  434. package/dist/transport/node/WaNodeTransport.js +13 -0
  435. package/dist/transport/node/builders/abprops.js +1 -1
  436. package/dist/transport/node/builders/account-sync.js +7 -16
  437. package/dist/transport/node/builders/bot.js +43 -0
  438. package/dist/transport/node/builders/business.js +31 -31
  439. package/dist/transport/node/builders/chatstate.js +31 -0
  440. package/dist/transport/node/builders/community.js +59 -0
  441. package/dist/transport/node/builders/device.js +1 -1
  442. package/dist/transport/node/builders/email.js +6 -5
  443. package/dist/transport/node/builders/global.js +2 -2
  444. package/dist/transport/node/builders/group.js +121 -3
  445. package/dist/transport/node/builders/media.js +1 -1
  446. package/dist/transport/node/builders/message.js +84 -49
  447. package/dist/transport/node/builders/newsletter.js +183 -0
  448. package/dist/transport/node/builders/passive.js +10 -0
  449. package/dist/transport/node/builders/prekeys.js +3 -3
  450. package/dist/transport/node/builders/presence.js +28 -1
  451. package/dist/transport/node/builders/privacy-token.js +1 -1
  452. package/dist/transport/node/builders/privacy.js +5 -5
  453. package/dist/transport/node/builders/profile.js +30 -7
  454. package/dist/transport/node/builders/tos.js +63 -0
  455. package/dist/transport/node/builders/usync.js +52 -1
  456. package/dist/transport/node/helpers.js +3 -2
  457. package/dist/transport/node/mex/argo-decoder.js +2 -2
  458. package/dist/transport/node/mex/client.js +23 -0
  459. package/dist/transport/node/query.js +17 -0
  460. package/dist/transport/node/usync.js +13 -0
  461. package/dist/transport/noise/WaClientPayload.js +9 -9
  462. package/dist/transport/noise/WaMobileClientPayload.js +6 -1
  463. package/dist/transport/noise/WaNoiseCert.js +7 -2
  464. package/dist/transport/noise/WaNoiseHandshake.js +26 -24
  465. package/dist/transport/noise/WaNoiseSession.js +41 -61
  466. package/dist/transport/noise/WaNoiseSocket.js +19 -13
  467. package/dist/transport/noise/constants.js +1 -2
  468. package/dist/transport/proxy.js +5 -0
  469. package/dist/transport/stream/parse.js +3 -7
  470. package/dist/transport/wa-web-version-fetcher.js +94 -0
  471. package/dist/types/appstate/constants.d.ts +1 -1
  472. package/dist/types/appstate/{WaAppStateCrypto.d.ts → crypto/WaAppStateCrypto.d.ts} +26 -9
  473. package/dist/types/appstate/index.d.ts +5 -5
  474. package/dist/types/appstate/{encoding.d.ts → parsers/encoding.d.ts} +8 -1
  475. package/dist/types/appstate/{response-parser.d.ts → parsers/response-parser.d.ts} +13 -3
  476. package/dist/types/appstate/sync/WaAppStateSyncClient.d.ts +105 -0
  477. package/dist/types/appstate/types.d.ts +1 -1
  478. package/dist/types/appstate/utils.d.ts +18 -2
  479. package/dist/types/appstate-spec.d.ts +24 -0
  480. package/dist/types/auth/WaAuthClient.d.ts +89 -3
  481. package/dist/types/auth/credentials-flow.d.ts +4 -3
  482. package/dist/types/auth/pairing/pairing-code-crypto.d.ts +0 -1
  483. package/dist/types/auth/types.d.ts +49 -2
  484. package/dist/types/client/WaClient.d.ts +178 -71
  485. package/dist/types/client/WaClientFactory.d.ts +30 -5
  486. package/dist/types/client/connection/WaConnectionManager.d.ts +4 -2
  487. package/dist/types/client/connection/WaReceiptQueue.d.ts +1 -1
  488. package/dist/types/client/coordinators/WaAppStateMutationCoordinator.d.ts +215 -5
  489. package/dist/types/client/coordinators/WaBotCoordinator.d.ts +117 -0
  490. package/dist/types/client/coordinators/WaBroadcastListCoordinator.d.ts +39 -0
  491. package/dist/types/client/coordinators/WaBusinessCoordinator.d.ts +44 -43
  492. package/dist/types/client/coordinators/WaEmailCoordinator.d.ts +16 -0
  493. package/dist/types/client/coordinators/WaGroupCoordinator.d.ts +311 -9
  494. package/dist/types/client/coordinators/WaIncomingNodeCoordinator.d.ts +11 -4
  495. package/dist/types/client/coordinators/WaLowLevelCoordinator.d.ts +47 -0
  496. package/dist/types/client/coordinators/WaMessageCoordinator.d.ts +232 -0
  497. package/dist/types/client/coordinators/WaMessageDispatchCoordinator.d.ts +55 -32
  498. package/dist/types/client/coordinators/WaNewsletterCoordinator.d.ts +13 -0
  499. package/dist/types/client/coordinators/WaPassiveTasksCoordinator.d.ts +4 -3
  500. package/dist/types/client/coordinators/WaPresenceCoordinator.d.ts +27 -0
  501. package/dist/types/client/coordinators/WaPrivacyCoordinator.d.ts +27 -0
  502. package/dist/types/client/coordinators/WaProfileCoordinator.d.ts +113 -0
  503. package/dist/types/client/coordinators/WaRetryCoordinator.d.ts +19 -17
  504. package/dist/types/client/coordinators/WaStatusCoordinator.d.ts +42 -0
  505. package/dist/types/client/coordinators/WaTrustedContactTokenCoordinator.d.ts +5 -1
  506. package/dist/types/client/events/abprops.d.ts +2 -1
  507. package/dist/types/client/events/appstate-mutation.d.ts +3 -0
  508. package/dist/types/client/events/business.d.ts +10 -0
  509. package/dist/types/client/events/call.d.ts +31 -0
  510. package/dist/types/client/events/chatstate.d.ts +9 -0
  511. package/dist/types/client/events/devices.d.ts +5 -4
  512. package/dist/types/client/{dirty.d.ts → events/dirty.d.ts} +4 -3
  513. package/dist/types/client/events/group.d.ts +2 -1
  514. package/dist/types/client/events/identity.d.ts +2 -1
  515. package/dist/types/client/{incoming.d.ts → events/incoming.d.ts} +27 -4
  516. package/dist/types/client/events/mex-notification.d.ts +6 -0
  517. package/dist/types/client/events/picture.d.ts +8 -0
  518. package/dist/types/client/events/presence.d.ts +28 -0
  519. package/dist/types/client/events/receipt.d.ts +14 -0
  520. package/dist/types/client/events/registration.d.ts +4 -3
  521. package/dist/types/client/index.d.ts +1 -1
  522. package/dist/types/client/media.d.ts +35 -1
  523. package/dist/types/client/messaging/fanout.d.ts +2 -2
  524. package/dist/types/client/messaging/group-metadata.d.ts +19 -0
  525. package/dist/types/client/messaging/ignore-key.d.ts +11 -0
  526. package/dist/types/client/messaging/key-protocol.d.ts +9 -7
  527. package/dist/types/client/messaging/link-preview.d.ts +19 -0
  528. package/dist/types/client/messaging/messages.d.ts +28 -0
  529. package/dist/types/client/newsletter/admin.d.ts +71 -0
  530. package/dist/types/client/newsletter/content.d.ts +42 -0
  531. package/dist/types/client/newsletter/discovery.d.ts +33 -0
  532. package/dist/types/client/newsletter/messaging.d.ts +66 -0
  533. package/dist/types/client/newsletter/mex.d.ts +14 -0
  534. package/dist/types/client/newsletter/parse.d.ts +19 -0
  535. package/dist/types/client/newsletter/types.d.ts +190 -0
  536. package/dist/types/client/persistence/WriteBehindPersistence.d.ts +12 -1
  537. package/dist/types/client/persistence/history-sync.d.ts +29 -0
  538. package/dist/types/client/{mailbox.d.ts → persistence/mailbox.d.ts} +4 -4
  539. package/dist/types/client/tokens/cs-token.d.ts +1 -3
  540. package/dist/types/client/types.d.ts +844 -72
  541. package/dist/types/crypto/core/hkdf.d.ts +10 -2
  542. package/dist/types/crypto/core/index.d.ts +2 -2
  543. package/dist/types/crypto/core/keys.d.ts +0 -4
  544. package/dist/types/crypto/core/nonce.d.ts +4 -5
  545. package/dist/types/crypto/core/primitives.d.ts +31 -20
  546. package/dist/types/crypto/core/random.d.ts +6 -0
  547. package/dist/types/crypto/core/xeddsa.d.ts +9 -0
  548. package/dist/types/crypto/curves/Ed25519.d.ts +7 -1
  549. package/dist/types/crypto/curves/X25519.d.ts +20 -1
  550. package/dist/types/crypto/curves/constants.d.ts +4 -3
  551. package/dist/types/crypto/curves/types.d.ts +0 -5
  552. package/dist/types/crypto/math/constants.d.ts +0 -1
  553. package/dist/types/crypto/math/mod.d.ts +0 -1
  554. package/dist/types/index.d.ts +34 -8
  555. package/dist/types/infra/log/ConsoleLogger.d.ts +18 -1
  556. package/dist/types/infra/log/PinoLogger.d.ts +55 -1
  557. package/dist/types/infra/log/types.d.ts +6 -0
  558. package/dist/types/infra/perf/BackgroundQueue.d.ts +19 -0
  559. package/dist/types/media/constants.d.ts +7 -2
  560. package/dist/types/media/crypto/WaMediaCrypto.d.ts +59 -0
  561. package/dist/types/media/index.d.ts +7 -5
  562. package/dist/types/media/processor.d.ts +27 -5
  563. package/dist/types/media/sticker/sticker-pack.d.ts +6 -0
  564. package/dist/types/media/{WaMediaTransferClient.d.ts → transfer/WaMediaTransferClient.d.ts} +30 -1
  565. package/dist/types/media/transfer/conn.d.ts +7 -0
  566. package/dist/types/media/types.d.ts +1 -2
  567. package/dist/types/message/WaMessageClient.d.ts +14 -0
  568. package/dist/types/message/addons/link-preview/builder.d.ts +13 -0
  569. package/dist/types/message/addons/link-preview/detect.d.ts +5 -0
  570. package/dist/types/message/addons/link-preview/fetcher.d.ts +13 -0
  571. package/dist/types/message/addons/link-preview/types.d.ts +51 -0
  572. package/dist/types/message/context-info.d.ts +66 -0
  573. package/dist/types/message/{addon-crypto.d.ts → crypto/addon-crypto.d.ts} +27 -5
  574. package/dist/types/message/{icdc.d.ts → crypto/icdc.d.ts} +4 -4
  575. package/dist/types/message/{phash.d.ts → crypto/phash.d.ts} +1 -1
  576. package/dist/types/message/{reporting-token.d.ts → crypto/reporting-token.d.ts} +2 -2
  577. package/dist/types/message/{use-case-secret.d.ts → crypto/use-case-secret.d.ts} +17 -1
  578. package/dist/types/message/encode/content.d.ts +43 -0
  579. package/dist/types/message/{device-sent.d.ts → encode/device-sent.d.ts} +1 -1
  580. package/dist/types/message/encode/media-payload.d.ts +12 -0
  581. package/dist/types/message/index.d.ts +2 -2
  582. package/dist/types/message/kinds/bot.d.ts +31 -0
  583. package/dist/types/message/kinds/newsletter.d.ts +12 -0
  584. package/dist/types/message/kinds/sticker-pack.d.ts +6 -0
  585. package/dist/types/message/{ack.d.ts → primitives/ack.d.ts} +1 -1
  586. package/dist/types/message/primitives/incoming.d.ts +21 -0
  587. package/dist/types/message/primitives/peer-data-operation.d.ts +23 -0
  588. package/dist/types/message/types.d.ts +209 -11
  589. package/dist/types/mex.d.ts +2 -0
  590. package/dist/types/proto.d.ts +2 -2
  591. package/dist/types/protocol/abprops.d.ts +9 -0
  592. package/dist/types/protocol/appstate.d.ts +4 -49
  593. package/dist/types/protocol/auth.d.ts +2 -2
  594. package/dist/types/protocol/bot.d.ts +45 -0
  595. package/dist/types/protocol/browser.d.ts +8 -0
  596. package/dist/types/protocol/business.d.ts +21 -0
  597. package/dist/types/protocol/call.d.ts +44 -0
  598. package/dist/types/protocol/constants.d.ts +16 -3
  599. package/dist/types/protocol/defaults.d.ts +3 -0
  600. package/dist/types/protocol/group.d.ts +1 -1
  601. package/dist/types/protocol/index.d.ts +2 -1
  602. package/dist/types/protocol/jid.d.ts +78 -0
  603. package/dist/types/protocol/media.d.ts +21 -13
  604. package/dist/types/protocol/message.d.ts +4 -0
  605. package/dist/types/protocol/newsletter.d.ts +65 -0
  606. package/dist/types/protocol/nodes.d.ts +20 -0
  607. package/dist/types/protocol/notification.d.ts +16 -0
  608. package/dist/types/protocol/presence.d.ts +16 -0
  609. package/dist/types/protocol/status.d.ts +7 -0
  610. package/dist/types/retry/codec.d.ts +5 -0
  611. package/dist/types/retry/index.d.ts +1 -1
  612. package/dist/types/retry/parse.d.ts +9 -0
  613. package/dist/types/retry/reason.d.ts +5 -0
  614. package/dist/types/retry/replay.d.ts +19 -5
  615. package/dist/types/retry/tracker.d.ts +10 -3
  616. package/dist/types/retry/types.d.ts +3 -8
  617. package/dist/types/signal/api/SignalDeviceSyncApi.d.ts +20 -0
  618. package/dist/types/signal/api/SignalDigestSyncApi.d.ts +10 -0
  619. package/dist/types/signal/api/SignalIdentitySyncApi.d.ts +9 -0
  620. package/dist/types/signal/api/SignalMissingPreKeysSyncApi.d.ts +8 -0
  621. package/dist/types/signal/api/SignalRotateKeyApi.d.ts +10 -0
  622. package/dist/types/signal/api/SignalSessionSyncApi.d.ts +13 -0
  623. package/dist/types/signal/api/codec.d.ts +20 -0
  624. package/dist/types/signal/api/constants.d.ts +1 -1
  625. package/dist/types/signal/api/prekeys.d.ts +4 -0
  626. package/dist/types/signal/{crypto → attestation}/WaAdvSignature.d.ts +2 -2
  627. package/dist/types/signal/attestation/constants.d.ts +4 -0
  628. package/dist/types/signal/constants.d.ts +7 -4
  629. package/dist/types/signal/encoding.d.ts +6 -68
  630. package/dist/types/signal/group/SenderKeyChain.d.ts +1 -1
  631. package/dist/types/signal/group/SenderKeyManager.d.ts +18 -1
  632. package/dist/types/signal/group/encoding.d.ts +25 -0
  633. package/dist/types/signal/index.d.ts +4 -1
  634. package/dist/types/signal/registration/encoding.d.ts +30 -0
  635. package/dist/types/signal/registration/keygen.d.ts +10 -0
  636. package/dist/types/signal/registration/utils.d.ts +5 -0
  637. package/dist/types/signal/session/SignalProtocol.d.ts +55 -0
  638. package/dist/types/signal/session/SignalRatchet.d.ts +2 -3
  639. package/dist/types/signal/session/SignalSession.d.ts +0 -1
  640. package/dist/types/signal/session/encoding.d.ts +28 -0
  641. package/dist/types/signal/session/resolver.d.ts +14 -0
  642. package/dist/types/signal/types.d.ts +1 -1
  643. package/dist/types/store/cache/identity.cache.d.ts +15 -0
  644. package/dist/types/store/cache/privacy-token.cache.d.ts +15 -0
  645. package/dist/types/store/cache/sender-key.cache.d.ts +18 -0
  646. package/dist/types/store/cache/session.cache.d.ts +23 -0
  647. package/dist/types/store/contracts/contact.store.d.ts +14 -0
  648. package/dist/types/store/contracts/device-list.store.d.ts +13 -0
  649. package/dist/types/store/contracts/group-metadata.store.d.ts +14 -0
  650. package/dist/types/store/contracts/message.store.d.ts +0 -2
  651. package/dist/types/store/createStore.d.ts +54 -2
  652. package/dist/types/store/index.d.ts +17 -16
  653. package/dist/types/store/locks/group-metadata.lock.d.ts +2 -0
  654. package/dist/types/store/{providers/memory → memory}/appstate.store.d.ts +2 -2
  655. package/dist/types/store/memory/auth.store.d.ts +18 -0
  656. package/dist/types/store/{providers/memory → memory}/contact.store.d.ts +6 -1
  657. package/dist/types/store/{providers/memory → memory}/device-list.store.d.ts +15 -2
  658. package/dist/types/store/memory/group-metadata.store.d.ts +27 -0
  659. package/dist/types/store/{providers/memory → memory}/identity.store.d.ts +2 -2
  660. package/dist/types/store/{providers/memory → memory}/message-secret.store.d.ts +12 -2
  661. package/dist/types/store/{providers/memory → memory}/message.store.d.ts +1 -1
  662. package/dist/types/store/{providers/memory → memory}/pre-key.store.d.ts +2 -2
  663. package/dist/types/store/{providers/memory → memory}/privacy-token.store.d.ts +1 -1
  664. package/dist/types/store/{providers/memory → memory}/retry.store.d.ts +16 -3
  665. package/dist/types/store/{providers/memory → memory}/sender-key.store.d.ts +2 -2
  666. package/dist/types/store/{providers/memory → memory}/session.store.d.ts +2 -2
  667. package/dist/types/store/{providers/memory → memory}/signal.store.d.ts +2 -2
  668. package/dist/types/store/{providers/memory → memory}/thread.store.d.ts +1 -1
  669. package/dist/types/store/noop.store.d.ts +2 -2
  670. package/dist/types/store/types.d.ts +250 -6
  671. package/dist/types/transport/WaComms.d.ts +5 -0
  672. package/dist/types/transport/WaWebSocket.d.ts +5 -0
  673. package/dist/types/transport/binary/constants.d.ts +8 -2
  674. package/dist/types/transport/binary/decoder.d.ts +5 -0
  675. package/dist/types/transport/binary/encoder.d.ts +5 -0
  676. package/dist/types/transport/binary/tokens.d.ts +6 -6
  677. package/dist/types/transport/index.d.ts +3 -1
  678. package/dist/types/transport/keepalive/WaKeepAlive.d.ts +7 -0
  679. package/dist/types/transport/node/WaMobileTcpSocket.d.ts +6 -0
  680. package/dist/types/transport/node/WaNodeOrchestrator.d.ts +5 -0
  681. package/dist/types/transport/node/WaNodeTransport.d.ts +13 -0
  682. package/dist/types/transport/node/builders/account-sync.d.ts +1 -2
  683. package/dist/types/transport/node/builders/bot.d.ts +4 -0
  684. package/dist/types/transport/node/builders/business.d.ts +21 -4
  685. package/dist/types/transport/node/builders/chatstate.d.ts +11 -0
  686. package/dist/types/transport/node/builders/community.d.ts +17 -0
  687. package/dist/types/transport/node/builders/group.d.ts +44 -2
  688. package/dist/types/transport/node/builders/message.d.ts +11 -6
  689. package/dist/types/transport/node/builders/newsletter.d.ts +73 -0
  690. package/dist/types/transport/node/builders/passive.d.ts +3 -0
  691. package/dist/types/transport/node/builders/presence.d.ts +8 -1
  692. package/dist/types/transport/node/builders/profile.d.ts +3 -0
  693. package/dist/types/transport/node/builders/tos.d.ts +12 -0
  694. package/dist/types/transport/node/builders/usync.d.ts +16 -0
  695. package/dist/types/transport/node/helpers.d.ts +1 -2
  696. package/dist/types/transport/node/mex/client.d.ts +12 -1
  697. package/dist/types/transport/node/query.d.ts +19 -1
  698. package/dist/types/transport/node/usync.d.ts +3 -0
  699. package/dist/types/transport/noise/WaMobileClientPayload.d.ts +6 -1
  700. package/dist/types/transport/noise/WaNoiseCert.d.ts +5 -0
  701. package/dist/types/transport/noise/WaNoiseHandshake.d.ts +12 -6
  702. package/dist/types/transport/noise/WaNoiseSession.d.ts +0 -1
  703. package/dist/types/transport/noise/WaNoiseSocket.d.ts +12 -6
  704. package/dist/types/transport/noise/constants.d.ts +4 -5
  705. package/dist/types/transport/noise/types.d.ts +1 -1
  706. package/dist/types/transport/proxy.d.ts +5 -0
  707. package/dist/types/transport/types.d.ts +14 -7
  708. package/dist/types/transport/wa-web-version-fetcher.d.ts +44 -0
  709. package/dist/types/util/async.d.ts +4 -0
  710. package/dist/types/util/bytes.d.ts +36 -1
  711. package/dist/types/util/clock.d.ts +6 -0
  712. package/dist/types/util/coercion.d.ts +25 -0
  713. package/dist/types/util/collections.d.ts +8 -0
  714. package/dist/types/util/index.d.ts +2 -2
  715. package/dist/types/util/primitives.d.ts +11 -0
  716. package/dist/types/util/runtime.d.ts +5 -0
  717. package/dist/types/version-spec.d.ts +1 -0
  718. package/dist/util/async.js +4 -0
  719. package/dist/util/bytes.js +37 -2
  720. package/dist/util/clock.js +18 -0
  721. package/dist/util/coercion.js +48 -3
  722. package/dist/util/collections.js +12 -0
  723. package/dist/util/index.js +7 -1
  724. package/dist/util/primitives.js +20 -0
  725. package/dist/util/runtime.js +5 -0
  726. package/dist/version-spec.js +5 -0
  727. package/package.json +32 -8
  728. package/spec/appstate/index.d.ts +188 -0
  729. package/spec/appstate/index.js +850 -0
  730. package/spec/mex/index.d.ts +4172 -0
  731. package/spec/mex/index.js +261 -0
  732. package/spec/proto/index.d.ts +16305 -0
  733. package/spec/proto/index.js +1 -0
  734. package/spec/version/index.d.ts +4 -0
  735. package/spec/version/index.js +9 -0
  736. package/spec/version/version.json +3 -0
  737. package/dist/client/events/chat.js +0 -227
  738. package/dist/client/incoming.js +0 -306
  739. package/dist/client/mailbox.js +0 -66
  740. package/dist/client/messages.js +0 -305
  741. package/dist/esm/client/events/chat.js +0 -224
  742. package/dist/esm/client/incoming.js +0 -296
  743. package/dist/esm/client/mailbox.js +0 -63
  744. package/dist/esm/client/messages.js +0 -301
  745. package/dist/esm/media/WaMediaCrypto.js +0 -499
  746. package/dist/esm/message/phash.js +0 -47
  747. package/dist/esm/store/locks/participants.lock.js +0 -20
  748. package/dist/esm/store/providers/memory/contact.store.js +0 -28
  749. package/dist/esm/store/providers/memory/device-list.store.js +0 -67
  750. package/dist/esm/transport/node/mex/persist-ids.js +0 -10
  751. package/dist/media/WaMediaCrypto.js +0 -503
  752. package/dist/message/phash.js +0 -50
  753. package/dist/store/locks/participants.lock.js +0 -23
  754. package/dist/store/providers/memory/contact.store.js +0 -32
  755. package/dist/store/providers/memory/device-list.store.js +0 -71
  756. package/dist/transport/node/mex/persist-ids.js +0 -13
  757. package/dist/types/appstate/WaAppStateSyncClient.d.ts +0 -70
  758. package/dist/types/client/events/chat.d.ts +0 -3
  759. package/dist/types/client/history-sync.d.ts +0 -20
  760. package/dist/types/client/messages.d.ts +0 -18
  761. package/dist/types/client/messaging/participants.d.ts +0 -13
  762. package/dist/types/media/WaMediaCrypto.d.ts +0 -22
  763. package/dist/types/media/conn.d.ts +0 -3
  764. package/dist/types/message/content.d.ts +0 -14
  765. package/dist/types/message/incoming.d.ts +0 -18
  766. package/dist/types/signal/crypto/constants.d.ts +0 -4
  767. package/dist/types/store/contracts/participants.store.d.ts +0 -13
  768. package/dist/types/store/locks/participants.lock.d.ts +0 -2
  769. package/dist/types/store/providers/memory/participants.store.d.ts +0 -17
  770. package/dist/types/transport/node/mex/persist-ids.d.ts +0 -14
  771. package/proto/index.d.ts +0 -10903
  772. package/proto/index.js +0 -1
  773. /package/dist/{store/contracts/participants.store.js → client/newsletter/types.js} +0 -0
  774. /package/dist/esm/{store/contracts/participants.store.js → client/newsletter/types.js} +0 -0
  775. /package/dist/esm/message/{device-sent.js → encode/device-sent.js} +0 -0
  776. /package/dist/esm/signal/{crypto → attestation}/constants.js +0 -0
  777. /package/dist/esm/store/{providers/memory → memory}/signal.store.js +0 -0
  778. /package/dist/message/{device-sent.js → encode/device-sent.js} +0 -0
  779. /package/dist/signal/{crypto → attestation}/constants.js +0 -0
  780. /package/dist/store/{providers/memory → memory}/signal.store.js +0 -0
  781. /package/dist/types/message/{padding.d.ts → encode/padding.d.ts} +0 -0
@@ -1,7 +1,7 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.WaMessageClient = void 0;
4
- const ack_1 = require("./ack");
4
+ const ack_1 = require("./primitives/ack");
5
5
  const constants_1 = require("../protocol/constants");
6
6
  const global_1 = require("../transport/node/builders/global");
7
7
  const async_1 = require("../util/async");
@@ -14,6 +14,11 @@ class MessagePublishNackError extends Error {
14
14
  this.retryable = retryable;
15
15
  }
16
16
  }
17
+ /**
18
+ * Low-level message-publishing client. Sends pre-built message/receipt nodes,
19
+ * handles ack timeouts and retry on negative-ack failures, and is the
20
+ * transport hook used by {@link WaMessageCoordinator}.
21
+ */
17
22
  class WaMessageClient {
18
23
  constructor(options) {
19
24
  this.logger = options.logger;
@@ -23,6 +28,11 @@ class WaMessageClient {
23
28
  this.defaultMaxAttempts = options.defaultMaxAttempts ?? constants_1.WA_DEFAULTS.MESSAGE_MAX_ATTEMPTS;
24
29
  this.defaultRetryDelayMs = options.defaultRetryDelayMs ?? constants_1.WA_DEFAULTS.MESSAGE_RETRY_DELAY_MS;
25
30
  }
31
+ /**
32
+ * Publishes a `<message>` stanza and awaits its ack/receipt, retrying on
33
+ * retryable negative-ack errors up to `maxAttempts`. Returns the ack
34
+ * metadata extracted from the server response.
35
+ */
26
36
  async publishNode(node, options = {}) {
27
37
  if (node.tag !== constants_1.WA_MESSAGE_TAGS.MESSAGE) {
28
38
  throw new Error(`invalid node tag for message publish: ${node.tag}`);
@@ -54,14 +64,25 @@ class WaMessageClient {
54
64
  if ((0, ack_1.isNegativeAckNode)(ackNode)) {
55
65
  throw new MessagePublishNackError(`negative publish ack: ${(0, ack_1.describeAckNode)(ackNode)}`, (0, ack_1.isRetryableNegativeAck)(ackNode));
56
66
  }
57
- this.logger.info('message publish acknowledged', {
58
- id,
59
- tag: ackNode.tag,
60
- type: ackNode.attrs.type,
61
- phash: ackNode.attrs.phash,
62
- addressingMode: ackNode.attrs.addressing_mode,
63
- attempts: attempt
64
- });
67
+ if (attempt > 1) {
68
+ this.logger.info('message publish acknowledged after retry', {
69
+ id,
70
+ tag: ackNode.tag,
71
+ type: ackNode.attrs.type,
72
+ phash: ackNode.attrs.phash,
73
+ addressingMode: ackNode.attrs.addressing_mode,
74
+ attempts: attempt
75
+ });
76
+ }
77
+ else {
78
+ this.logger.trace('message publish acknowledged', {
79
+ id,
80
+ tag: ackNode.tag,
81
+ type: ackNode.attrs.type,
82
+ phash: ackNode.attrs.phash,
83
+ addressingMode: ackNode.attrs.addressing_mode
84
+ });
85
+ }
65
86
  return {
66
87
  id,
67
88
  attempts: attempt,
@@ -74,25 +95,33 @@ class WaMessageClient {
74
95
  const nackRetryable = error instanceof MessagePublishNackError ? error.retryable : false;
75
96
  const canRetry = attempt < maxAttempts &&
76
97
  (this.isRetryablePublishError(lastError) || nackRetryable);
98
+ if (canRetry) {
99
+ this.logger.debug('message publish attempt failed, will retry', {
100
+ attempt,
101
+ maxAttempts,
102
+ nackRetryable,
103
+ message: lastError.message
104
+ });
105
+ await (0, async_1.delay)(retryDelayMs * attempt);
106
+ continue;
107
+ }
77
108
  this.logger.warn('message publish attempt failed', {
78
109
  attempt,
79
110
  maxAttempts,
80
- canRetry,
81
111
  nackRetryable,
82
112
  message: lastError.message
83
113
  });
84
- if (!canRetry) {
85
- throw lastError;
86
- }
87
- await (0, async_1.delay)(retryDelayMs * attempt);
114
+ throw lastError;
88
115
  }
89
116
  }
90
117
  throw lastError ?? new Error('message publish failed');
91
118
  }
119
+ /** Builds the encrypted message envelope from `input` and publishes it via {@link publishNode}. */
92
120
  async publishEncrypted(input, options = {}) {
93
121
  const node = this.buildEncryptedMessageNode(input);
94
122
  return this.publishNode(node, options);
95
123
  }
124
+ /** Fire-and-forget variant: sends a `<message>` stanza without awaiting an ack. */
96
125
  async sendMessageNode(node) {
97
126
  if (node.tag !== constants_1.WA_MESSAGE_TAGS.MESSAGE) {
98
127
  throw new Error(`invalid node tag for message send: ${node.tag}`);
@@ -104,6 +133,7 @@ class WaMessageClient {
104
133
  });
105
134
  await this.sendNode(node);
106
135
  }
136
+ /** Builds and sends an encrypted message envelope without awaiting an ack. */
107
137
  async sendEncrypted(input) {
108
138
  const node = this.buildEncryptedMessageNode(input);
109
139
  await this.sendMessageNode(node);
@@ -168,12 +198,13 @@ class WaMessageClient {
168
198
  };
169
199
  return node;
170
200
  }
201
+ /** Builds and sends a `<receipt>` stanza (delivery/read/played/etc.). */
171
202
  async sendReceipt(input) {
172
203
  const node = (0, global_1.buildReceiptNode)({
173
204
  kind: 'outbound',
174
205
  to: input.to,
175
206
  id: input.id,
176
- type: input.type ?? 'read',
207
+ type: input.type ?? constants_1.WA_MESSAGE_TYPES.RECEIPT_TYPE_READ,
177
208
  participant: input.participant,
178
209
  recipient: input.recipient,
179
210
  category: input.category,
@@ -0,0 +1,39 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.buildExtendedTextWithPreview = buildExtendedTextWithPreview;
4
+ function buildExtendedTextWithPreview(text, resolved, thumbnailFields) {
5
+ const message = {
6
+ text,
7
+ matchedText: resolved.matchedText,
8
+ previewType: resolved.previewType
9
+ };
10
+ if (resolved.title !== undefined)
11
+ message.title = resolved.title;
12
+ if (resolved.description !== undefined)
13
+ message.description = resolved.description;
14
+ if (thumbnailFields.jpegThumbnail !== undefined) {
15
+ message.jpegThumbnail = thumbnailFields.jpegThumbnail;
16
+ }
17
+ if (thumbnailFields.thumbnailDirectPath !== undefined) {
18
+ message.thumbnailDirectPath = thumbnailFields.thumbnailDirectPath;
19
+ }
20
+ if (thumbnailFields.thumbnailSha256 !== undefined) {
21
+ message.thumbnailSha256 = thumbnailFields.thumbnailSha256;
22
+ }
23
+ if (thumbnailFields.thumbnailEncSha256 !== undefined) {
24
+ message.thumbnailEncSha256 = thumbnailFields.thumbnailEncSha256;
25
+ }
26
+ if (thumbnailFields.mediaKey !== undefined) {
27
+ message.mediaKey = thumbnailFields.mediaKey;
28
+ }
29
+ if (thumbnailFields.mediaKeyTimestamp !== undefined) {
30
+ message.mediaKeyTimestamp = thumbnailFields.mediaKeyTimestamp;
31
+ }
32
+ if (thumbnailFields.thumbnailWidth !== undefined) {
33
+ message.thumbnailWidth = thumbnailFields.thumbnailWidth;
34
+ }
35
+ if (thumbnailFields.thumbnailHeight !== undefined) {
36
+ message.thumbnailHeight = thumbnailFields.thumbnailHeight;
37
+ }
38
+ return { extendedTextMessage: message };
39
+ }
@@ -0,0 +1,58 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.findFirstLink = findFirstLink;
4
+ const URL_REGEX = /\bhttps?:\/\/\S+/i;
5
+ const TRAILING_PUNCT = '.,;:!?\'"»›>';
6
+ const WRAPPER_PAIRS = Object.freeze({
7
+ ')': '(',
8
+ ']': '[',
9
+ '}': '{'
10
+ });
11
+ function findFirstLink(text) {
12
+ const match = URL_REGEX.exec(text);
13
+ if (!match)
14
+ return null;
15
+ const raw = stripTrailing(match[0]);
16
+ if (raw.length === 0)
17
+ return null;
18
+ let url;
19
+ try {
20
+ url = new URL(raw);
21
+ }
22
+ catch {
23
+ return null;
24
+ }
25
+ if (url.protocol !== 'http:' && url.protocol !== 'https:')
26
+ return null;
27
+ return { matchedText: raw, url };
28
+ }
29
+ function stripTrailing(raw) {
30
+ let s = raw;
31
+ while (s.length > 0) {
32
+ const last = s[s.length - 1] ?? '';
33
+ if (TRAILING_PUNCT.includes(last)) {
34
+ s = s.slice(0, -1);
35
+ continue;
36
+ }
37
+ const opener = WRAPPER_PAIRS[last];
38
+ if (opener === undefined)
39
+ break;
40
+ // Only strip the closing wrapper if it's unbalanced (no matching opener
41
+ // inside the candidate URL). Keeps URLs like `/a_(b)` intact while
42
+ // still trimming `(see https://x.com)` → `https://x.com`.
43
+ if (countChar(s, last) > countChar(s, opener)) {
44
+ s = s.slice(0, -1);
45
+ continue;
46
+ }
47
+ break;
48
+ }
49
+ return s;
50
+ }
51
+ function countChar(s, ch) {
52
+ let n = 0;
53
+ for (let i = 0; i < s.length; i++) {
54
+ if (s[i] === ch)
55
+ n++;
56
+ }
57
+ return n;
58
+ }
@@ -0,0 +1,394 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.createDefaultLinkPreviewFetcher = createDefaultLinkPreviewFetcher;
4
+ const _proto_1 = require("../../../proto");
5
+ const proxy_1 = require("../../../transport/proxy");
6
+ const bytes_1 = require("../../../util/bytes");
7
+ const primitives_1 = require("../../../util/primitives");
8
+ const DEFAULT_USER_AGENT = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36';
9
+ const DEFAULT_TIMEOUT_MS = 3000;
10
+ const DEFAULT_HTML_BYTES = 65536;
11
+ const DEFAULT_THUMBNAIL_BYTES = 262144;
12
+ const INLINE_THUMBNAIL_MAX_BYTES = 64 * 1024;
13
+ const MAX_REDIRECTS = 5;
14
+ function createDefaultLinkPreviewFetcher(options) {
15
+ const userAgent = options.userAgent ?? DEFAULT_USER_AGENT;
16
+ const fetchTimeoutMs = options.fetchTimeoutMs ?? DEFAULT_TIMEOUT_MS;
17
+ const maxHtmlBytes = options.maxHtmlBytes ?? DEFAULT_HTML_BYTES;
18
+ const maxThumbnailBytes = options.maxThumbnailBytes ?? DEFAULT_THUMBNAIL_BYTES;
19
+ const allowPrivateHosts = options.allowPrivateHosts === true;
20
+ const agent = (0, proxy_1.toProxyAgent)(options.proxy);
21
+ const mediaTransfer = options.mediaTransfer;
22
+ return {
23
+ async fetch(input) {
24
+ if (!allowPrivateHosts && isPrivateHost(input.url.hostname)) {
25
+ input.logger.warn('link preview blocked: private host', {
26
+ hostname: input.url.hostname
27
+ });
28
+ return null;
29
+ }
30
+ const minimal = {
31
+ matchedText: input.matchedText,
32
+ title: input.url.hostname,
33
+ previewType: _proto_1.proto.Message.ExtendedTextMessage.PreviewType.NONE
34
+ };
35
+ let html;
36
+ try {
37
+ html = await fetchHtml(input.url, {
38
+ mediaTransfer,
39
+ agent,
40
+ userAgent,
41
+ timeoutMs: fetchTimeoutMs,
42
+ maxBytes: maxHtmlBytes,
43
+ signal: input.signal,
44
+ allowPrivateHosts
45
+ });
46
+ }
47
+ catch (error) {
48
+ input.logger.warn('link preview html fetch failed', {
49
+ url: input.url.toString(),
50
+ message: (0, primitives_1.toError)(error).message
51
+ });
52
+ return minimal;
53
+ }
54
+ if (html.length === 0)
55
+ return minimal;
56
+ const parsed = parseHtmlMeta(html, input.url);
57
+ let thumbnail;
58
+ if (parsed.imageUrl !== undefined) {
59
+ const fetched = await fetchThumbnail(parsed.imageUrl, {
60
+ mediaTransfer,
61
+ agent,
62
+ userAgent,
63
+ timeoutMs: fetchTimeoutMs,
64
+ maxBytes: maxThumbnailBytes,
65
+ allowPrivateHosts,
66
+ signal: input.signal,
67
+ logger: input.logger
68
+ });
69
+ if (fetched !== undefined) {
70
+ thumbnail = {
71
+ ...fetched,
72
+ ...(parsed.imageWidth !== undefined ? { width: parsed.imageWidth } : {}),
73
+ ...(parsed.imageHeight !== undefined ? { height: parsed.imageHeight } : {})
74
+ };
75
+ }
76
+ }
77
+ return {
78
+ matchedText: input.matchedText,
79
+ title: parsed.title ?? input.url.hostname,
80
+ previewType: parsed.hasVideo
81
+ ? _proto_1.proto.Message.ExtendedTextMessage.PreviewType.VIDEO
82
+ : _proto_1.proto.Message.ExtendedTextMessage.PreviewType.NONE,
83
+ ...(parsed.description !== undefined ? { description: parsed.description } : {}),
84
+ ...(thumbnail !== undefined ? { thumbnail } : {})
85
+ };
86
+ }
87
+ };
88
+ }
89
+ function parseHtmlMeta(html, base) {
90
+ const head = extractHeadSection(html);
91
+ const ogTitle = extractMetaContent(head, 'property', 'og:title');
92
+ const twitterTitle = extractMetaContent(head, 'name', 'twitter:title');
93
+ const titleTag = extractTitleTag(head);
94
+ const ogDesc = extractMetaContent(head, 'property', 'og:description');
95
+ const twitterDesc = extractMetaContent(head, 'name', 'twitter:description');
96
+ const metaDesc = extractMetaContent(head, 'name', 'description');
97
+ const ogImage = extractMetaContent(head, 'property', 'og:image:secure_url') ??
98
+ extractMetaContent(head, 'property', 'og:image:url') ??
99
+ extractMetaContent(head, 'property', 'og:image') ??
100
+ extractMetaContent(head, 'name', 'twitter:image');
101
+ const ogImageWidth = (0, primitives_1.parseOptionalInt)(extractMetaContent(head, 'property', 'og:image:width'));
102
+ const ogImageHeight = (0, primitives_1.parseOptionalInt)(extractMetaContent(head, 'property', 'og:image:height'));
103
+ const ogVideo = extractMetaContent(head, 'property', 'og:video:secure_url') ??
104
+ extractMetaContent(head, 'property', 'og:video:url') ??
105
+ extractMetaContent(head, 'property', 'og:video');
106
+ return {
107
+ title: cleanText(ogTitle ?? twitterTitle ?? titleTag),
108
+ description: cleanText(ogDesc ?? twitterDesc ?? metaDesc),
109
+ imageUrl: ogImage ? toAbsoluteUrl(ogImage, base) : undefined,
110
+ imageWidth: ogImageWidth,
111
+ imageHeight: ogImageHeight,
112
+ hasVideo: ogVideo !== undefined
113
+ };
114
+ }
115
+ function extractHeadSection(html) {
116
+ const closeIdx = html.search(/<\/head\s*>/i);
117
+ if (closeIdx === -1)
118
+ return html;
119
+ return html.slice(0, closeIdx);
120
+ }
121
+ function extractMetaContent(html, attr, key) {
122
+ const escaped = key.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
123
+ const re1 = new RegExp(`<meta\\b[^>]*?\\b${attr}\\s*=\\s*["']${escaped}["'][^>]*?\\bcontent\\s*=\\s*["']([^"']*)["']`, 'i');
124
+ const re2 = new RegExp(`<meta\\b[^>]*?\\bcontent\\s*=\\s*["']([^"']*)["'][^>]*?\\b${attr}\\s*=\\s*["']${escaped}["']`, 'i');
125
+ const m = re1.exec(html) ?? re2.exec(html);
126
+ return m?.[1];
127
+ }
128
+ function extractTitleTag(html) {
129
+ const m = /<title[^>]*>([\s\S]*?)<\/title>/i.exec(html);
130
+ return m?.[1];
131
+ }
132
+ function cleanText(s) {
133
+ if (s === undefined)
134
+ return undefined;
135
+ const decoded = decodeHtmlEntities(s.replace(/\s+/g, ' ').trim());
136
+ return decoded.length === 0 ? undefined : decoded;
137
+ }
138
+ function decodeHtmlEntities(s) {
139
+ return s
140
+ .replace(/&lt;/g, '<')
141
+ .replace(/&gt;/g, '>')
142
+ .replace(/&quot;/g, '"')
143
+ .replace(/&#39;/g, "'")
144
+ .replace(/&apos;/g, "'")
145
+ .replace(/&nbsp;/g, ' ')
146
+ .replace(/&#(\d+);/g, (_, n) => safeCodePoint(Number(n)))
147
+ .replace(/&#x([0-9a-f]+);/gi, (_, hex) => safeCodePoint(Number.parseInt(hex, 16)))
148
+ .replace(/&amp;/g, '&');
149
+ }
150
+ function safeCodePoint(cp) {
151
+ if (!Number.isFinite(cp) || cp < 0 || cp > 0x10ffff)
152
+ return '';
153
+ return String.fromCodePoint(cp);
154
+ }
155
+ function toAbsoluteUrl(raw, base) {
156
+ try {
157
+ return new URL(raw, base).toString();
158
+ }
159
+ catch {
160
+ return undefined;
161
+ }
162
+ }
163
+ async function fetchHtml(url, opts) {
164
+ const result = await httpGetWithRedirects({
165
+ url,
166
+ mediaTransfer: opts.mediaTransfer,
167
+ agent: opts.agent,
168
+ userAgent: opts.userAgent,
169
+ accept: 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8',
170
+ timeoutMs: opts.timeoutMs,
171
+ maxBytes: opts.maxBytes,
172
+ signal: opts.signal,
173
+ allowPrivateHosts: opts.allowPrivateHosts
174
+ });
175
+ if (result.status < 200 || result.status >= 300) {
176
+ throw new Error(`http ${result.status}`);
177
+ }
178
+ if (!/text\/html|application\/xhtml/i.test(result.contentType)) {
179
+ return '';
180
+ }
181
+ // HTML truncation is tolerable: the regex meta parser only needs the
182
+ // <head> section, which fits well below maxHtmlBytes for realistic pages.
183
+ return bytes_1.TEXT_DECODER.decode(result.bytes);
184
+ }
185
+ async function fetchThumbnail(url, opts) {
186
+ let parsed;
187
+ try {
188
+ parsed = new URL(url);
189
+ }
190
+ catch {
191
+ return undefined;
192
+ }
193
+ if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:')
194
+ return undefined;
195
+ if (!opts.allowPrivateHosts && isPrivateHost(parsed.hostname)) {
196
+ opts.logger.warn('link preview thumbnail blocked: private host', {
197
+ hostname: parsed.hostname
198
+ });
199
+ return undefined;
200
+ }
201
+ try {
202
+ const streamResult = await httpGetStreamWithRedirects({
203
+ url: parsed,
204
+ mediaTransfer: opts.mediaTransfer,
205
+ agent: opts.agent,
206
+ userAgent: opts.userAgent,
207
+ accept: 'image/jpeg,image/*;q=0.8',
208
+ timeoutMs: opts.timeoutMs,
209
+ signal: opts.signal,
210
+ allowPrivateHosts: opts.allowPrivateHosts
211
+ });
212
+ if (streamResult.status < 200 || streamResult.status >= 300) {
213
+ streamResult.body?.destroy();
214
+ return undefined;
215
+ }
216
+ if (!/^image\//i.test(streamResult.contentType)) {
217
+ streamResult.body?.destroy();
218
+ return undefined;
219
+ }
220
+ if (!streamResult.body)
221
+ return undefined;
222
+ if (streamResult.contentLength !== undefined &&
223
+ streamResult.contentLength > opts.maxBytes) {
224
+ streamResult.body.destroy();
225
+ return undefined;
226
+ }
227
+ if (streamResult.contentLength !== undefined &&
228
+ streamResult.contentLength > INLINE_THUMBNAIL_MAX_BYTES) {
229
+ return { stream: streamResult.body, contentLength: streamResult.contentLength };
230
+ }
231
+ const capped = await readBodyCapped(streamResult.body, opts.maxBytes);
232
+ if (capped.bytes.byteLength === 0)
233
+ return undefined;
234
+ // If we capped without knowing the real size, the bytes are an
235
+ // arbitrary prefix of the original image (corrupt JPEG/PNG). Drop it.
236
+ if (capped.truncated && streamResult.contentLength === undefined) {
237
+ opts.logger.warn('link preview thumbnail dropped: truncated without content-length', {
238
+ url: parsed.toString()
239
+ });
240
+ return undefined;
241
+ }
242
+ return { bytes: capped.bytes };
243
+ }
244
+ catch (error) {
245
+ opts.logger.warn('link preview thumbnail fetch failed', {
246
+ url: parsed.toString(),
247
+ message: (0, primitives_1.toError)(error).message
248
+ });
249
+ return undefined;
250
+ }
251
+ }
252
+ async function httpGetWithRedirects(opts) {
253
+ const streamResult = await httpGetStreamWithRedirects({
254
+ url: opts.url,
255
+ mediaTransfer: opts.mediaTransfer,
256
+ agent: opts.agent,
257
+ userAgent: opts.userAgent,
258
+ accept: opts.accept,
259
+ timeoutMs: opts.timeoutMs,
260
+ signal: opts.signal,
261
+ allowPrivateHosts: opts.allowPrivateHosts
262
+ });
263
+ const capped = await readBodyCapped(streamResult.body, opts.maxBytes);
264
+ return {
265
+ status: streamResult.status,
266
+ contentType: streamResult.contentType,
267
+ bytes: capped.bytes
268
+ };
269
+ }
270
+ async function httpGetStreamWithRedirects(opts) {
271
+ let currentUrl = opts.url;
272
+ for (let redirects = 0; redirects <= MAX_REDIRECTS; redirects++) {
273
+ if (!opts.allowPrivateHosts && isPrivateHost(currentUrl.hostname)) {
274
+ throw new Error(`redirect to private host blocked: ${currentUrl.hostname}`);
275
+ }
276
+ const response = await opts.mediaTransfer.downloadStream({
277
+ url: currentUrl.toString(),
278
+ agent: opts.agent,
279
+ headers: {
280
+ 'user-agent': opts.userAgent,
281
+ accept: opts.accept
282
+ },
283
+ timeoutMs: opts.timeoutMs,
284
+ signal: opts.signal
285
+ });
286
+ const contentType = response.headers['content-type'] ?? '';
287
+ if (response.status >= 300 && response.status < 400) {
288
+ const location = response.headers['location'];
289
+ response.body?.destroy();
290
+ if (typeof location !== 'string' || location.length === 0) {
291
+ return {
292
+ status: response.status,
293
+ contentType,
294
+ contentLength: undefined,
295
+ body: null
296
+ };
297
+ }
298
+ try {
299
+ currentUrl = new URL(location, currentUrl);
300
+ }
301
+ catch {
302
+ return {
303
+ status: response.status,
304
+ contentType,
305
+ contentLength: undefined,
306
+ body: null
307
+ };
308
+ }
309
+ continue;
310
+ }
311
+ const contentLengthHeader = response.headers['content-length'];
312
+ const contentLength = (0, primitives_1.parseOptionalInt)(contentLengthHeader);
313
+ return {
314
+ status: response.status,
315
+ contentType,
316
+ contentLength,
317
+ body: response.body
318
+ };
319
+ }
320
+ throw new Error(`too many redirects (>${MAX_REDIRECTS})`);
321
+ }
322
+ async function readBodyCapped(body, maxBytes) {
323
+ if (!body)
324
+ return { bytes: new Uint8Array(0), truncated: false };
325
+ const chunks = [];
326
+ let total = 0;
327
+ let truncated = false;
328
+ try {
329
+ for await (const chunk of body) {
330
+ const view = chunk;
331
+ const room = maxBytes - total;
332
+ if (room <= 0) {
333
+ truncated = true;
334
+ break;
335
+ }
336
+ if (view.byteLength <= room) {
337
+ chunks.push(view);
338
+ total += view.byteLength;
339
+ }
340
+ else {
341
+ chunks.push(view.subarray(0, room));
342
+ total = maxBytes;
343
+ truncated = true;
344
+ break;
345
+ }
346
+ }
347
+ }
348
+ finally {
349
+ body.destroy();
350
+ }
351
+ const out = new Uint8Array(total);
352
+ let offset = 0;
353
+ for (const chunk of chunks) {
354
+ out.set(chunk, offset);
355
+ offset += chunk.byteLength;
356
+ }
357
+ return { bytes: out, truncated };
358
+ }
359
+ const PRIVATE_IPV4 = [
360
+ /^127\./,
361
+ /^10\./,
362
+ /^192\.168\./,
363
+ /^172\.(1[6-9]|2\d|3[01])\./,
364
+ /^169\.254\./,
365
+ /^0\./
366
+ ];
367
+ function isPrivateHost(hostname) {
368
+ const lower = hostname.toLowerCase();
369
+ // RFC 6761 §6.3: any name in the .localhost domain resolves to loopback.
370
+ if (lower === 'localhost' || lower.endsWith('.localhost'))
371
+ return true;
372
+ // URL.hostname strips brackets for IPv6, but tolerate either form.
373
+ const bare = lower.startsWith('[') && lower.endsWith(']') ? lower.slice(1, -1) : lower;
374
+ if (bare === '::1' || bare === '0:0:0:0:0:0:0:1' || bare === '::')
375
+ return true;
376
+ if (bare.startsWith('::ffff:')) {
377
+ return isPrivateHost(bare.slice('::ffff:'.length));
378
+ }
379
+ if (PRIVATE_IPV4.some((re) => re.test(bare)))
380
+ return true;
381
+ // IPv6: presence of ':' indicates an address. Match link-local (fe80::/10)
382
+ // and unique-local (fc00::/7) prefixes.
383
+ if (bare.includes(':')) {
384
+ if (bare.startsWith('fc') || bare.startsWith('fd'))
385
+ return true;
386
+ if (bare.startsWith('fe8') ||
387
+ bare.startsWith('fe9') ||
388
+ bare.startsWith('fea') ||
389
+ bare.startsWith('feb')) {
390
+ return true;
391
+ }
392
+ }
393
+ return false;
394
+ }
@@ -0,0 +1,2 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });