zapo-js 0.1.2 → 0.3.0

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 (630) hide show
  1. package/README.md +16 -4
  2. package/dist/appstate/WaAppStateCrypto.js +50 -42
  3. package/dist/appstate/WaAppStateSyncClient.js +215 -133
  4. package/dist/appstate/{store/sqlite.js → encoding.js} +13 -8
  5. package/dist/appstate/index.js +9 -7
  6. package/dist/appstate/utils.js +0 -5
  7. package/dist/auth/WaAuthClient.js +55 -57
  8. package/dist/auth/credentials-flow.js +195 -0
  9. package/dist/auth/index.js +1 -6
  10. package/dist/auth/pairing/WaPairingFlow.js +39 -32
  11. package/dist/auth/pairing/{WaPairingCodeCrypto.js → pairing-code-crypto.js} +35 -17
  12. package/dist/client/WaClient.js +338 -174
  13. package/dist/client/WaClientFactory.js +399 -66
  14. package/dist/client/connection/WaConnectionManager.js +23 -11
  15. package/dist/client/coordinators/WaAbPropsCoordinator.js +141 -0
  16. package/dist/client/coordinators/WaBusinessCoordinator.js +232 -0
  17. package/dist/client/coordinators/WaEmailCoordinator.js +63 -0
  18. package/dist/client/coordinators/WaGroupCoordinator.js +11 -7
  19. package/dist/client/coordinators/WaIncomingNodeCoordinator.js +34 -8
  20. package/dist/client/coordinators/WaMessageDispatchCoordinator.js +341 -118
  21. package/dist/client/coordinators/WaOfflineResumeCoordinator.js +114 -0
  22. package/dist/client/coordinators/WaPassiveTasksCoordinator.js +97 -36
  23. package/dist/client/coordinators/WaPrivacyCoordinator.js +134 -0
  24. package/dist/client/coordinators/WaProfileCoordinator.js +214 -0
  25. package/dist/client/coordinators/WaRetryCoordinator.js +184 -30
  26. package/dist/client/coordinators/WaStreamControlCoordinator.js +18 -11
  27. package/dist/client/coordinators/WaTrustedContactTokenCoordinator.js +184 -0
  28. package/dist/client/dirty.js +41 -21
  29. package/dist/client/events/abprops.js +43 -0
  30. package/dist/client/events/devices.js +72 -0
  31. package/dist/client/events/group.js +3 -11
  32. package/dist/client/events/identity.js +22 -0
  33. package/dist/client/events/privacy-token.js +38 -0
  34. package/dist/client/events/registration.js +42 -0
  35. package/dist/client/history-sync.js +50 -9
  36. package/dist/client/incoming.js +74 -7
  37. package/dist/client/mailbox.js +40 -23
  38. package/dist/client/media.js +243 -0
  39. package/dist/client/messages.js +245 -92
  40. package/dist/client/messaging/fanout.js +21 -11
  41. package/dist/client/messaging/participants.js +6 -4
  42. package/dist/client/persistence/WriteBehindPersistence.js +129 -0
  43. package/dist/client/tokens/cs-token.js +50 -0
  44. package/dist/client/tokens/tc-token.js +25 -0
  45. package/dist/crypto/core/index.js +5 -2
  46. package/dist/crypto/core/keys.js +4 -4
  47. package/dist/crypto/core/nonce.js +2 -0
  48. package/dist/crypto/core/primitives.js +0 -8
  49. package/dist/crypto/core/random.js +24 -8
  50. package/dist/crypto/core/xeddsa.js +57 -0
  51. package/dist/crypto/curves/X25519.js +43 -6
  52. package/dist/crypto/curves/constants.js +2 -1
  53. package/dist/crypto/index.js +3 -0
  54. package/dist/crypto/math/constants.js +13 -36
  55. package/dist/crypto/math/edwards.js +171 -44
  56. package/dist/crypto/math/fe.js +706 -0
  57. package/dist/crypto/math/mod.js +10 -3
  58. package/dist/esm/appstate/WaAppStateCrypto.js +40 -32
  59. package/dist/esm/appstate/WaAppStateSyncClient.js +206 -124
  60. package/dist/esm/appstate/{store/sqlite.js → encoding.js} +13 -8
  61. package/dist/esm/appstate/index.js +2 -2
  62. package/dist/esm/appstate/{WaAppStateSyncResponseParser.js → response-parser.js} +1 -1
  63. package/dist/esm/appstate/utils.js +2 -5
  64. package/dist/esm/auth/WaAuthClient.js +52 -54
  65. package/dist/esm/auth/credentials-flow.js +190 -0
  66. package/dist/esm/auth/index.js +0 -2
  67. package/dist/esm/auth/pairing/WaPairingFlow.js +39 -32
  68. package/dist/esm/auth/pairing/{WaPairingCodeCrypto.js → pairing-code-crypto.js} +26 -10
  69. package/dist/esm/client/WaClient.js +339 -175
  70. package/dist/esm/client/WaClientFactory.js +401 -68
  71. package/dist/esm/client/connection/WaConnectionManager.js +23 -11
  72. package/dist/esm/client/coordinators/WaAbPropsCoordinator.js +137 -0
  73. package/dist/esm/client/coordinators/WaBusinessCoordinator.js +229 -0
  74. package/dist/esm/client/coordinators/WaEmailCoordinator.js +60 -0
  75. package/dist/esm/client/coordinators/WaGroupCoordinator.js +11 -7
  76. package/dist/esm/client/coordinators/WaIncomingNodeCoordinator.js +36 -10
  77. package/dist/esm/client/coordinators/WaMessageDispatchCoordinator.js +337 -114
  78. package/dist/esm/client/coordinators/WaOfflineResumeCoordinator.js +110 -0
  79. package/dist/esm/client/coordinators/WaPassiveTasksCoordinator.js +97 -36
  80. package/dist/esm/client/coordinators/WaPrivacyCoordinator.js +131 -0
  81. package/dist/esm/client/coordinators/WaProfileCoordinator.js +211 -0
  82. package/dist/esm/client/coordinators/WaRetryCoordinator.js +186 -32
  83. package/dist/esm/client/coordinators/WaStreamControlCoordinator.js +19 -12
  84. package/dist/esm/client/coordinators/WaTrustedContactTokenCoordinator.js +180 -0
  85. package/dist/esm/client/dirty.js +41 -21
  86. package/dist/esm/client/events/abprops.js +40 -0
  87. package/dist/esm/client/events/devices.js +68 -0
  88. package/dist/esm/client/events/group.js +3 -11
  89. package/dist/esm/client/events/identity.js +19 -0
  90. package/dist/esm/client/events/privacy-token.js +35 -0
  91. package/dist/esm/client/events/registration.js +39 -0
  92. package/dist/esm/client/history-sync.js +50 -9
  93. package/dist/esm/client/incoming.js +74 -8
  94. package/dist/esm/client/mailbox.js +40 -23
  95. package/dist/esm/client/media.js +234 -0
  96. package/dist/esm/client/messages.js +244 -91
  97. package/dist/esm/client/messaging/fanout.js +22 -12
  98. package/dist/esm/client/messaging/participants.js +6 -4
  99. package/dist/esm/client/persistence/WriteBehindPersistence.js +125 -0
  100. package/dist/esm/client/tokens/cs-token.js +46 -0
  101. package/dist/esm/client/tokens/tc-token.js +18 -0
  102. package/dist/esm/crypto/core/index.js +3 -2
  103. package/dist/esm/crypto/core/keys.js +1 -1
  104. package/dist/esm/crypto/core/nonce.js +2 -0
  105. package/dist/esm/crypto/core/primitives.js +0 -7
  106. package/dist/esm/crypto/core/random.js +23 -7
  107. package/dist/esm/crypto/core/xeddsa.js +53 -0
  108. package/dist/esm/crypto/curves/X25519.js +45 -8
  109. package/dist/esm/crypto/curves/constants.js +1 -0
  110. package/dist/esm/crypto/index.js +1 -0
  111. package/dist/esm/crypto/math/constants.js +12 -35
  112. package/dist/esm/crypto/math/edwards.js +174 -47
  113. package/dist/esm/crypto/math/fe.js +691 -0
  114. package/dist/esm/crypto/math/mod.js +10 -1
  115. package/dist/esm/index.js +1 -1
  116. package/dist/esm/infra/perf/BackgroundQueue.js +478 -0
  117. package/dist/esm/infra/perf/BoundedTaskQueue.js +3 -1
  118. package/dist/esm/infra/perf/PromiseDedup.js +20 -0
  119. package/dist/esm/infra/perf/SharedExclusiveGate.js +109 -0
  120. package/dist/esm/infra/perf/StoreLock.js +80 -0
  121. package/dist/esm/media/WaMediaCrypto.js +332 -55
  122. package/dist/esm/media/WaMediaTransferClient.js +69 -220
  123. package/dist/esm/media/constants.js +4 -1
  124. package/dist/esm/media/processor.js +1 -0
  125. package/dist/esm/message/WaMessageClient.js +26 -19
  126. package/dist/esm/message/addon-crypto.js +130 -3
  127. package/dist/esm/message/content.js +206 -14
  128. package/dist/esm/message/icdc.js +76 -0
  129. package/dist/esm/message/incoming.js +38 -24
  130. package/dist/esm/message/phash.js +35 -13
  131. package/dist/esm/message/reporting-token.js +17 -30
  132. package/dist/esm/message/use-case-secret.js +1 -1
  133. package/dist/esm/protocol/abprops.js +159 -0
  134. package/dist/esm/protocol/appstate.js +9 -40
  135. package/dist/esm/protocol/browser.js +24 -18
  136. package/dist/esm/protocol/constants.js +8 -4
  137. package/dist/esm/protocol/defaults.js +6 -0
  138. package/dist/esm/protocol/email.js +30 -0
  139. package/dist/esm/protocol/index.js +1 -2
  140. package/dist/esm/protocol/jid.js +142 -39
  141. package/dist/esm/protocol/message.js +61 -1
  142. package/dist/esm/protocol/nodes.js +8 -2
  143. package/dist/esm/protocol/notification.js +9 -1
  144. package/dist/esm/protocol/privacy-token.js +17 -0
  145. package/dist/esm/protocol/privacy.js +55 -0
  146. package/dist/esm/protocol/stream.js +26 -1
  147. package/dist/esm/retry/codec.js +216 -0
  148. package/dist/esm/retry/constants.js +1 -1
  149. package/dist/esm/retry/index.js +2 -2
  150. package/dist/esm/retry/parse.js +50 -30
  151. package/dist/esm/retry/reason.js +1 -1
  152. package/dist/esm/retry/replay.js +11 -7
  153. package/dist/esm/retry/tracker.js +50 -12
  154. package/dist/esm/signal/api/SignalDeviceSyncApi.js +52 -32
  155. package/dist/esm/signal/api/SignalDigestSyncApi.js +21 -15
  156. package/dist/esm/signal/api/SignalIdentitySyncApi.js +30 -15
  157. package/dist/esm/signal/api/SignalMissingPreKeysSyncApi.js +19 -8
  158. package/dist/esm/signal/api/SignalRotateKeyApi.js +4 -2
  159. package/dist/esm/signal/api/SignalSessionSyncApi.js +17 -8
  160. package/dist/esm/signal/api/result-map.js +10 -0
  161. package/dist/esm/signal/constants.js +0 -4
  162. package/dist/esm/signal/crypto/WaAdvSignature.js +5 -45
  163. package/dist/esm/signal/crypto/constants.js +0 -4
  164. package/dist/esm/signal/{store/sqlite.js → encoding.js} +40 -29
  165. package/dist/esm/signal/group/SenderKeyChain.js +3 -3
  166. package/dist/esm/signal/group/SenderKeyCodec.js +8 -8
  167. package/dist/esm/signal/group/SenderKeyManager.js +131 -109
  168. package/dist/esm/signal/index.js +1 -0
  169. package/dist/esm/signal/registration/keygen.js +8 -5
  170. package/dist/esm/signal/registration/utils.js +3 -2
  171. package/dist/esm/signal/session/SignalProtocol.js +158 -81
  172. package/dist/esm/signal/session/SignalRatchet.js +21 -10
  173. package/dist/esm/signal/session/SignalSerializer.js +5 -6
  174. package/dist/esm/signal/session/SignalSession.js +11 -9
  175. package/dist/esm/signal/session/resolver.js +140 -105
  176. package/dist/esm/store/contracts/identity.store.js +1 -0
  177. package/dist/esm/store/contracts/message-secret.store.js +1 -0
  178. package/dist/esm/store/contracts/pre-key.store.js +1 -0
  179. package/dist/esm/store/contracts/privacy-token.store.js +1 -0
  180. package/dist/esm/store/contracts/session.store.js +1 -0
  181. package/dist/esm/store/createStore.js +143 -193
  182. package/dist/esm/store/index.js +5 -10
  183. package/dist/esm/store/locks/appstate.lock.js +26 -0
  184. package/dist/esm/store/locks/auth.lock.js +15 -0
  185. package/dist/esm/store/locks/contact.lock.js +20 -0
  186. package/dist/esm/store/locks/device-list.lock.js +20 -0
  187. package/dist/esm/store/locks/identity.lock.js +16 -0
  188. package/dist/esm/store/locks/message-secret.lock.js +17 -0
  189. package/dist/esm/store/locks/message.lock.js +21 -0
  190. package/dist/esm/store/locks/participants.lock.js +20 -0
  191. package/dist/esm/store/locks/pre-key.lock.js +27 -0
  192. package/dist/esm/store/locks/privacy-token.lock.js +18 -0
  193. package/dist/esm/store/locks/retry.lock.js +29 -0
  194. package/dist/esm/store/locks/sender-key.lock.js +52 -0
  195. package/dist/esm/store/locks/session.lock.js +19 -0
  196. package/dist/esm/store/locks/signal.lock.js +39 -0
  197. package/dist/esm/store/locks/thread.lock.js +21 -0
  198. package/dist/esm/store/noop.store.js +21 -1
  199. package/dist/esm/store/providers/memory/appstate.store.js +22 -24
  200. package/dist/esm/store/providers/memory/device-list.store.js +13 -5
  201. package/dist/esm/store/providers/memory/identity.store.js +31 -0
  202. package/dist/esm/store/providers/memory/message-secret.store.js +81 -0
  203. package/dist/esm/store/providers/memory/participants.store.js +3 -0
  204. package/dist/esm/store/providers/memory/pre-key.store.js +97 -0
  205. package/dist/esm/store/providers/memory/privacy-token.store.js +43 -0
  206. package/dist/esm/store/providers/memory/retry.store.js +99 -10
  207. package/dist/esm/store/providers/memory/sender-key.store.js +6 -1
  208. package/dist/esm/store/providers/memory/session.store.js +45 -0
  209. package/dist/esm/store/providers/memory/signal.store.js +1 -147
  210. package/dist/esm/transport/WaComms.js +7 -4
  211. package/dist/esm/transport/WaWebSocket.js +9 -7
  212. package/dist/esm/transport/binary/constants.js +0 -30
  213. package/dist/esm/transport/binary/decoder.js +4 -4
  214. package/dist/esm/transport/binary/encoder.js +8 -15
  215. package/dist/esm/transport/binary/index.js +0 -1
  216. package/dist/esm/transport/index.js +6 -0
  217. package/dist/esm/transport/keepalive/WaKeepAlive.js +17 -8
  218. package/dist/esm/transport/node/WaMobileTcpSocket.js +114 -0
  219. package/dist/esm/transport/node/WaNodeOrchestrator.js +37 -22
  220. package/dist/esm/transport/node/builders/abprops.js +20 -0
  221. package/dist/esm/transport/node/builders/business.js +129 -0
  222. package/dist/esm/transport/node/builders/device.js +11 -0
  223. package/dist/esm/transport/node/builders/email.js +65 -0
  224. package/dist/esm/transport/node/builders/global.js +370 -0
  225. package/dist/esm/transport/node/builders/message.js +63 -239
  226. package/dist/esm/transport/node/builders/offline.js +14 -0
  227. package/dist/esm/transport/node/builders/pairing.js +0 -24
  228. package/dist/esm/transport/node/builders/prekeys.js +37 -40
  229. package/dist/esm/transport/node/builders/presence.js +13 -0
  230. package/dist/esm/transport/node/builders/privacy-token.js +37 -0
  231. package/dist/esm/transport/node/builders/privacy.js +48 -0
  232. package/dist/esm/transport/node/builders/profile.js +70 -0
  233. package/dist/esm/transport/node/builders/retry.js +11 -23
  234. package/dist/esm/transport/node/builders/usync.js +6 -2
  235. package/dist/esm/transport/node/helpers.js +43 -1
  236. package/dist/esm/transport/node/mex/argo-decoder.js +152 -0
  237. package/dist/esm/transport/node/mex/client.js +83 -0
  238. package/dist/esm/transport/node/mex/persist-ids.js +10 -0
  239. package/dist/esm/transport/node/usync.js +3 -33
  240. package/dist/esm/transport/node/xml.js +35 -14
  241. package/dist/esm/transport/noise/WaClientPayload.js +24 -19
  242. package/dist/esm/transport/noise/WaFrameCodec.js +2 -2
  243. package/dist/esm/transport/noise/WaMobileClientPayload.js +53 -0
  244. package/dist/esm/transport/noise/WaNoiseCert.js +9 -27
  245. package/dist/esm/transport/noise/WaNoiseSession.js +76 -34
  246. package/dist/esm/transport/noise/WaNoiseSocket.js +8 -4
  247. package/dist/esm/transport/stream/parse.js +8 -4
  248. package/dist/esm/util/bytes.js +22 -18
  249. package/dist/esm/util/index.js +5 -0
  250. package/dist/esm/util/primitives.js +3 -2
  251. package/dist/index.js +7 -1
  252. package/dist/infra/perf/BackgroundQueue.js +482 -0
  253. package/dist/infra/perf/BoundedTaskQueue.js +3 -1
  254. package/dist/infra/perf/PromiseDedup.js +24 -0
  255. package/dist/infra/perf/SharedExclusiveGate.js +113 -0
  256. package/dist/infra/perf/StoreLock.js +84 -0
  257. package/dist/media/WaMediaCrypto.js +328 -51
  258. package/dist/media/WaMediaTransferClient.js +72 -253
  259. package/dist/media/constants.js +5 -2
  260. package/dist/media/processor.js +2 -0
  261. package/dist/message/WaMessageClient.js +26 -19
  262. package/dist/message/addon-crypto.js +131 -0
  263. package/dist/message/content.js +211 -14
  264. package/dist/message/icdc.js +81 -0
  265. package/dist/message/incoming.js +38 -24
  266. package/dist/message/phash.js +35 -13
  267. package/dist/message/reporting-token.js +16 -30
  268. package/dist/message/use-case-secret.js +1 -1
  269. package/dist/protocol/abprops.js +163 -0
  270. package/dist/protocol/appstate.js +10 -41
  271. package/dist/protocol/browser.js +25 -18
  272. package/dist/protocol/constants.js +33 -2
  273. package/dist/protocol/defaults.js +6 -0
  274. package/dist/protocol/email.js +33 -0
  275. package/dist/protocol/index.js +8 -5
  276. package/dist/protocol/jid.js +149 -39
  277. package/dist/protocol/message.js +62 -2
  278. package/dist/protocol/nodes.js +8 -2
  279. package/dist/protocol/notification.js +10 -2
  280. package/dist/protocol/privacy-token.js +20 -0
  281. package/dist/protocol/privacy.js +58 -0
  282. package/dist/protocol/stream.js +27 -2
  283. package/dist/retry/codec.js +220 -0
  284. package/dist/retry/constants.js +1 -1
  285. package/dist/retry/index.js +5 -5
  286. package/dist/retry/parse.js +51 -30
  287. package/dist/retry/reason.js +1 -1
  288. package/dist/retry/replay.js +10 -6
  289. package/dist/retry/tracker.js +50 -12
  290. package/dist/signal/api/SignalDeviceSyncApi.js +51 -31
  291. package/dist/signal/api/SignalDigestSyncApi.js +21 -15
  292. package/dist/signal/api/SignalIdentitySyncApi.js +29 -14
  293. package/dist/signal/api/SignalMissingPreKeysSyncApi.js +17 -6
  294. package/dist/signal/api/SignalRotateKeyApi.js +4 -2
  295. package/dist/signal/api/SignalSessionSyncApi.js +16 -7
  296. package/dist/signal/api/result-map.js +13 -0
  297. package/dist/signal/constants.js +1 -5
  298. package/dist/signal/crypto/WaAdvSignature.js +2 -44
  299. package/dist/signal/crypto/constants.js +1 -5
  300. package/dist/signal/{store/sqlite.js → encoding.js} +41 -25
  301. package/dist/signal/group/SenderKeyChain.js +2 -2
  302. package/dist/signal/group/SenderKeyCodec.js +8 -8
  303. package/dist/signal/group/SenderKeyManager.js +130 -108
  304. package/dist/signal/index.js +13 -1
  305. package/dist/signal/registration/keygen.js +7 -4
  306. package/dist/signal/registration/utils.js +3 -2
  307. package/dist/signal/session/SignalProtocol.js +158 -81
  308. package/dist/signal/session/SignalRatchet.js +19 -8
  309. package/dist/signal/session/SignalSerializer.js +5 -6
  310. package/dist/signal/session/SignalSession.js +11 -9
  311. package/dist/signal/session/resolver.js +138 -103
  312. package/dist/store/contracts/identity.store.js +2 -0
  313. package/dist/store/contracts/message-secret.store.js +2 -0
  314. package/dist/store/contracts/pre-key.store.js +2 -0
  315. package/dist/store/contracts/privacy-token.store.js +2 -0
  316. package/dist/store/contracts/session.store.js +2 -0
  317. package/dist/store/createStore.js +142 -192
  318. package/dist/store/index.js +23 -33
  319. package/dist/store/locks/appstate.lock.js +29 -0
  320. package/dist/store/locks/auth.lock.js +18 -0
  321. package/dist/store/locks/contact.lock.js +23 -0
  322. package/dist/store/locks/device-list.lock.js +23 -0
  323. package/dist/store/locks/identity.lock.js +19 -0
  324. package/dist/store/locks/message-secret.lock.js +20 -0
  325. package/dist/store/locks/message.lock.js +24 -0
  326. package/dist/store/locks/participants.lock.js +23 -0
  327. package/dist/store/locks/pre-key.lock.js +30 -0
  328. package/dist/store/locks/privacy-token.lock.js +21 -0
  329. package/dist/store/locks/retry.lock.js +32 -0
  330. package/dist/store/locks/sender-key.lock.js +55 -0
  331. package/dist/store/locks/session.lock.js +22 -0
  332. package/dist/store/locks/signal.lock.js +42 -0
  333. package/dist/store/locks/thread.lock.js +24 -0
  334. package/dist/store/noop.store.js +22 -2
  335. package/dist/store/providers/memory/appstate.store.js +22 -24
  336. package/dist/store/providers/memory/device-list.store.js +13 -5
  337. package/dist/store/providers/memory/identity.store.js +35 -0
  338. package/dist/store/providers/memory/message-secret.store.js +85 -0
  339. package/dist/store/providers/memory/participants.store.js +3 -0
  340. package/dist/store/providers/memory/pre-key.store.js +101 -0
  341. package/dist/store/providers/memory/privacy-token.store.js +47 -0
  342. package/dist/store/providers/memory/retry.store.js +98 -9
  343. package/dist/store/providers/memory/sender-key.store.js +6 -1
  344. package/dist/store/providers/memory/session.store.js +49 -0
  345. package/dist/store/providers/memory/signal.store.js +1 -147
  346. package/dist/transport/WaComms.js +7 -4
  347. package/dist/transport/WaWebSocket.js +9 -7
  348. package/dist/transport/binary/constants.js +1 -31
  349. package/dist/transport/binary/decoder.js +4 -4
  350. package/dist/transport/binary/encoder.js +8 -15
  351. package/dist/transport/binary/index.js +0 -4
  352. package/dist/transport/index.js +17 -1
  353. package/dist/transport/keepalive/WaKeepAlive.js +17 -8
  354. package/dist/transport/node/WaMobileTcpSocket.js +118 -0
  355. package/dist/transport/node/WaNodeOrchestrator.js +36 -21
  356. package/dist/transport/node/builders/abprops.js +23 -0
  357. package/dist/transport/node/builders/business.js +137 -0
  358. package/dist/transport/node/builders/device.js +14 -0
  359. package/dist/transport/node/builders/email.js +72 -0
  360. package/dist/transport/node/builders/global.js +375 -0
  361. package/dist/transport/node/builders/message.js +64 -245
  362. package/dist/transport/node/builders/offline.js +17 -0
  363. package/dist/transport/node/builders/pairing.js +0 -26
  364. package/dist/transport/node/builders/prekeys.js +36 -39
  365. package/dist/transport/node/builders/presence.js +16 -0
  366. package/dist/transport/node/builders/privacy-token.js +42 -0
  367. package/dist/transport/node/builders/privacy.js +55 -0
  368. package/dist/transport/node/builders/profile.js +78 -0
  369. package/dist/transport/node/builders/retry.js +10 -22
  370. package/dist/transport/node/builders/usync.js +6 -2
  371. package/dist/transport/node/helpers.js +46 -1
  372. package/dist/transport/node/mex/argo-decoder.js +189 -0
  373. package/dist/transport/node/mex/client.js +86 -0
  374. package/dist/transport/node/mex/persist-ids.js +13 -0
  375. package/dist/transport/node/usync.js +2 -32
  376. package/dist/transport/node/xml.js +35 -14
  377. package/dist/transport/noise/WaClientPayload.js +26 -21
  378. package/dist/transport/noise/WaFrameCodec.js +1 -1
  379. package/dist/transport/noise/WaMobileClientPayload.js +56 -0
  380. package/dist/transport/noise/WaNoiseCert.js +8 -26
  381. package/dist/transport/noise/WaNoiseSession.js +75 -33
  382. package/dist/transport/noise/WaNoiseSocket.js +8 -4
  383. package/dist/transport/stream/parse.js +7 -3
  384. package/dist/types/appstate/WaAppStateCrypto.d.ts +11 -8
  385. package/dist/types/appstate/WaAppStateSyncClient.d.ts +6 -2
  386. package/dist/types/appstate/encoding.d.ts +7 -0
  387. package/dist/types/appstate/index.d.ts +3 -3
  388. package/dist/types/appstate/{WaAppStateSyncResponseParser.d.ts → response-parser.d.ts} +1 -1
  389. package/dist/types/appstate/types.d.ts +1 -1
  390. package/dist/types/appstate/utils.d.ts +0 -2
  391. package/dist/types/auth/WaAuthClient.d.ts +9 -3
  392. package/dist/types/auth/credentials-flow.d.ts +20 -0
  393. package/dist/types/auth/index.d.ts +0 -2
  394. package/dist/types/auth/pairing/WaPairingFlow.d.ts +3 -2
  395. package/dist/types/auth/pairing/{WaPairingCodeCrypto.d.ts → pairing-code-crypto.d.ts} +6 -1
  396. package/dist/types/auth/types.d.ts +41 -0
  397. package/dist/types/client/WaClient.d.ts +44 -18
  398. package/dist/types/client/WaClientFactory.d.ts +22 -8
  399. package/dist/types/client/connection/WaConnectionManager.d.ts +2 -0
  400. package/dist/types/client/coordinators/WaAbPropsCoordinator.d.ts +26 -0
  401. package/dist/types/client/coordinators/WaBusinessCoordinator.d.ts +57 -0
  402. package/dist/types/client/coordinators/WaEmailCoordinator.d.ts +24 -0
  403. package/dist/types/client/coordinators/WaIncomingNodeCoordinator.d.ts +9 -2
  404. package/dist/types/client/coordinators/WaMessageDispatchCoordinator.d.ts +29 -2
  405. package/dist/types/client/coordinators/WaOfflineResumeCoordinator.d.ts +31 -0
  406. package/dist/types/client/coordinators/WaPassiveTasksCoordinator.d.ts +16 -1
  407. package/dist/types/client/coordinators/WaPrivacyCoordinator.d.ts +26 -0
  408. package/dist/types/client/coordinators/WaProfileCoordinator.d.ts +38 -0
  409. package/dist/types/client/coordinators/WaRetryCoordinator.d.ts +12 -0
  410. package/dist/types/client/coordinators/WaStreamControlCoordinator.d.ts +3 -2
  411. package/dist/types/client/coordinators/WaTrustedContactTokenCoordinator.d.ts +55 -0
  412. package/dist/types/client/dirty.d.ts +3 -1
  413. package/dist/types/client/events/abprops.d.ts +14 -0
  414. package/dist/types/client/events/devices.d.ts +20 -0
  415. package/dist/types/client/events/identity.d.ts +9 -0
  416. package/dist/types/client/events/privacy-token.d.ts +7 -0
  417. package/dist/types/client/events/registration.d.ts +17 -0
  418. package/dist/types/client/history-sync.d.ts +9 -6
  419. package/dist/types/client/incoming.d.ts +9 -2
  420. package/dist/types/client/index.d.ts +1 -1
  421. package/dist/types/client/mailbox.d.ts +5 -5
  422. package/dist/types/client/media.d.ts +31 -0
  423. package/dist/types/client/messages.d.ts +3 -2
  424. package/dist/types/client/persistence/WriteBehindPersistence.d.ts +34 -0
  425. package/dist/types/client/tokens/cs-token.d.ts +10 -0
  426. package/dist/types/client/tokens/tc-token.d.ts +5 -0
  427. package/dist/types/client/types.d.ts +151 -4
  428. package/dist/types/crypto/core/index.d.ts +3 -2
  429. package/dist/types/crypto/core/nonce.d.ts +2 -0
  430. package/dist/types/crypto/core/primitives.d.ts +1 -2
  431. package/dist/types/crypto/core/random.d.ts +2 -1
  432. package/dist/types/crypto/core/xeddsa.d.ts +2 -0
  433. package/dist/types/crypto/curves/constants.d.ts +1 -0
  434. package/dist/types/crypto/index.d.ts +2 -0
  435. package/dist/types/crypto/math/constants.d.ts +4 -2
  436. package/dist/types/crypto/math/fe.d.ts +30 -0
  437. package/dist/types/crypto/math/mod.d.ts +0 -2
  438. package/dist/types/crypto/math/types.d.ts +11 -4
  439. package/dist/types/index.d.ts +6 -3
  440. package/dist/types/infra/log/ConsoleLogger.d.ts +1 -1
  441. package/dist/types/infra/log/PinoLogger.d.ts +1 -1
  442. package/dist/types/infra/perf/BackgroundQueue.d.ts +58 -0
  443. package/dist/types/infra/perf/PromiseDedup.d.ts +4 -0
  444. package/dist/types/infra/perf/SharedExclusiveGate.d.ts +17 -0
  445. package/dist/types/infra/perf/StoreLock.d.ts +11 -0
  446. package/dist/types/media/WaMediaCrypto.d.ts +16 -6
  447. package/dist/types/media/WaMediaTransferClient.d.ts +6 -23
  448. package/dist/types/media/constants.d.ts +3 -1
  449. package/dist/types/media/index.d.ts +2 -1
  450. package/dist/types/media/processor.d.ts +28 -0
  451. package/dist/types/media/types.d.ts +19 -5
  452. package/dist/types/message/addon-crypto.d.ts +34 -3
  453. package/dist/types/message/content.d.ts +11 -1
  454. package/dist/types/message/icdc.d.ts +13 -0
  455. package/dist/types/message/reporting-token.d.ts +0 -1
  456. package/dist/types/message/types.d.ts +42 -11
  457. package/dist/types/protocol/abprops.d.ts +142 -0
  458. package/dist/types/protocol/appstate.d.ts +0 -11
  459. package/dist/types/protocol/browser.d.ts +1 -0
  460. package/dist/types/protocol/constants.d.ts +12 -4
  461. package/dist/types/protocol/defaults.d.ts +6 -0
  462. package/dist/types/protocol/email.d.ts +32 -0
  463. package/dist/types/protocol/index.d.ts +1 -2
  464. package/dist/types/protocol/jid.d.ts +20 -2
  465. package/dist/types/protocol/message.d.ts +60 -0
  466. package/dist/types/protocol/nodes.d.ts +6 -0
  467. package/dist/types/protocol/notification.d.ts +8 -0
  468. package/dist/types/protocol/privacy-token.d.ts +17 -0
  469. package/dist/types/protocol/privacy.d.ts +75 -0
  470. package/dist/types/protocol/stream.d.ts +31 -0
  471. package/dist/types/retry/codec.d.ts +3 -0
  472. package/dist/types/retry/index.d.ts +3 -3
  473. package/dist/types/retry/parse.d.ts +5 -2
  474. package/dist/types/retry/reason.d.ts +1 -1
  475. package/dist/types/retry/tracker.d.ts +1 -0
  476. package/dist/types/retry/types.d.ts +6 -1
  477. package/dist/types/signal/api/SignalDeviceSyncApi.d.ts +2 -1
  478. package/dist/types/signal/api/SignalDigestSyncApi.d.ts +9 -0
  479. package/dist/types/signal/api/SignalIdentitySyncApi.d.ts +5 -3
  480. package/dist/types/signal/api/SignalRotateKeyApi.d.ts +4 -5
  481. package/dist/types/signal/api/SignalSessionSyncApi.d.ts +8 -6
  482. package/dist/types/signal/api/result-map.d.ts +1 -0
  483. package/dist/types/signal/constants.d.ts +0 -3
  484. package/dist/types/signal/crypto/WaAdvSignature.d.ts +0 -2
  485. package/dist/types/signal/crypto/constants.d.ts +0 -1
  486. package/dist/types/signal/{store/sqlite.d.ts → encoding.d.ts} +9 -3
  487. package/dist/types/signal/group/SenderKeyChain.d.ts +1 -1
  488. package/dist/types/signal/group/SenderKeyManager.d.ts +17 -7
  489. package/dist/types/signal/index.d.ts +2 -0
  490. package/dist/types/signal/registration/utils.d.ts +2 -1
  491. package/dist/types/signal/session/SignalProtocol.d.ts +21 -6
  492. package/dist/types/signal/session/SignalSerializer.d.ts +2 -1
  493. package/dist/types/signal/session/resolver.d.ts +11 -4
  494. package/dist/types/signal/types.d.ts +16 -4
  495. package/dist/types/store/contracts/appstate.store.d.ts +1 -1
  496. package/dist/types/store/contracts/identity.store.d.ts +11 -0
  497. package/dist/types/store/contracts/message-secret.store.d.ts +16 -0
  498. package/dist/types/store/contracts/pre-key.store.d.ts +13 -0
  499. package/dist/types/store/contracts/privacy-token.store.d.ts +16 -0
  500. package/dist/types/store/contracts/retry.store.d.ts +7 -0
  501. package/dist/types/store/contracts/session.store.d.ts +14 -0
  502. package/dist/types/store/contracts/signal.store.d.ts +1 -27
  503. package/dist/types/store/createStore.d.ts +1 -1
  504. package/dist/types/store/index.d.ts +12 -12
  505. package/dist/types/store/locks/appstate.lock.d.ts +3 -0
  506. package/dist/types/store/locks/auth.lock.d.ts +3 -0
  507. package/dist/types/store/locks/contact.lock.d.ts +3 -0
  508. package/dist/types/store/locks/device-list.lock.d.ts +2 -0
  509. package/dist/types/store/locks/identity.lock.d.ts +3 -0
  510. package/dist/types/store/locks/message-secret.lock.d.ts +3 -0
  511. package/dist/types/store/locks/message.lock.d.ts +3 -0
  512. package/dist/types/store/locks/participants.lock.d.ts +2 -0
  513. package/dist/types/store/locks/pre-key.lock.d.ts +3 -0
  514. package/dist/types/store/locks/privacy-token.lock.d.ts +2 -0
  515. package/dist/types/store/locks/retry.lock.d.ts +2 -0
  516. package/dist/types/store/locks/sender-key.lock.d.ts +3 -0
  517. package/dist/types/store/locks/session.lock.d.ts +3 -0
  518. package/dist/types/store/locks/signal.lock.d.ts +3 -0
  519. package/dist/types/store/locks/thread.lock.d.ts +3 -0
  520. package/dist/types/store/noop.store.d.ts +4 -0
  521. package/dist/types/store/providers/memory/appstate.store.d.ts +1 -1
  522. package/dist/types/store/providers/memory/identity.store.d.ts +18 -0
  523. package/dist/types/store/providers/memory/message-secret.store.d.ts +21 -0
  524. package/dist/types/store/providers/memory/pre-key.store.d.ts +23 -0
  525. package/dist/types/store/providers/memory/privacy-token.store.d.ts +13 -0
  526. package/dist/types/store/providers/memory/retry.store.d.ts +15 -1
  527. package/dist/types/store/providers/memory/session.store.d.ts +21 -0
  528. package/dist/types/store/providers/memory/signal.store.d.ts +2 -43
  529. package/dist/types/store/providers/memory/thread.store.d.ts +1 -1
  530. package/dist/types/store/types.d.ts +69 -61
  531. package/dist/types/transport/WaWebSocket.d.ts +1 -1
  532. package/dist/types/transport/binary/constants.d.ts +0 -30
  533. package/dist/types/transport/binary/index.d.ts +0 -1
  534. package/dist/types/transport/index.d.ts +8 -1
  535. package/dist/types/transport/keepalive/WaKeepAlive.d.ts +4 -1
  536. package/dist/types/transport/node/WaMobileTcpSocket.d.ts +18 -0
  537. package/dist/types/transport/node/WaNodeOrchestrator.d.ts +9 -6
  538. package/dist/types/transport/node/builders/abprops.d.ts +5 -0
  539. package/dist/types/transport/node/builders/business.d.ts +29 -0
  540. package/dist/types/transport/node/builders/device.d.ts +2 -0
  541. package/dist/types/transport/node/builders/email.d.ts +11 -0
  542. package/dist/types/transport/node/builders/global.d.ts +102 -0
  543. package/dist/types/transport/node/builders/message.d.ts +8 -7
  544. package/dist/types/transport/node/builders/offline.d.ts +2 -0
  545. package/dist/types/transport/node/builders/pairing.d.ts +0 -2
  546. package/dist/types/transport/node/builders/prekeys.d.ts +4 -3
  547. package/dist/types/transport/node/builders/presence.d.ts +6 -0
  548. package/dist/types/transport/node/builders/privacy-token.d.ts +9 -0
  549. package/dist/types/transport/node/builders/privacy.d.ts +7 -0
  550. package/dist/types/transport/node/builders/profile.d.ts +8 -0
  551. package/dist/types/transport/node/builders/retry.d.ts +0 -1
  552. package/dist/types/transport/node/helpers.d.ts +8 -0
  553. package/dist/types/transport/node/mex/argo-decoder.d.ts +11 -0
  554. package/dist/types/transport/node/mex/client.d.ts +18 -0
  555. package/dist/types/transport/node/mex/persist-ids.d.ts +14 -0
  556. package/dist/types/transport/noise/WaMobileClientPayload.d.ts +29 -0
  557. package/dist/types/transport/noise/WaNoiseCert.d.ts +7 -1
  558. package/dist/types/transport/noise/WaNoiseSession.d.ts +4 -2
  559. package/dist/types/transport/noise/WaNoiseSocket.d.ts +4 -2
  560. package/dist/types/transport/types.d.ts +8 -0
  561. package/dist/types/util/bytes.d.ts +1 -1
  562. package/dist/types/util/index.d.ts +5 -0
  563. package/dist/types/util/primitives.d.ts +0 -1
  564. package/dist/util/bytes.js +22 -18
  565. package/dist/util/index.js +23 -0
  566. package/dist/util/primitives.js +2 -2
  567. package/package.json +34 -10
  568. package/proto/index.js +1 -1
  569. package/dist/auth/flow/WaAuthCredentialsFlow.js +0 -130
  570. package/dist/auth/pairing/constants.js +0 -5
  571. package/dist/client/connection/WaKeyShareCoordinator.js +0 -63
  572. package/dist/crypto/core/constants.js +0 -4
  573. package/dist/esm/auth/flow/WaAuthCredentialsFlow.js +0 -125
  574. package/dist/esm/auth/pairing/constants.js +0 -2
  575. package/dist/esm/client/connection/WaKeyShareCoordinator.js +0 -59
  576. package/dist/esm/crypto/core/constants.js +0 -1
  577. package/dist/esm/retry/outbound.js +0 -82
  578. package/dist/esm/store/providers/sqlite/BaseSqliteStore.js +0 -37
  579. package/dist/esm/store/providers/sqlite/appstate.store.js +0 -250
  580. package/dist/esm/store/providers/sqlite/auth.store.js +0 -176
  581. package/dist/esm/store/providers/sqlite/connection.js +0 -245
  582. package/dist/esm/store/providers/sqlite/contact.store.js +0 -74
  583. package/dist/esm/store/providers/sqlite/device-list.store.js +0 -127
  584. package/dist/esm/store/providers/sqlite/message.store.js +0 -132
  585. package/dist/esm/store/providers/sqlite/migrations.js +0 -347
  586. package/dist/esm/store/providers/sqlite/participants.store.js +0 -77
  587. package/dist/esm/store/providers/sqlite/retry.store.js +0 -141
  588. package/dist/esm/store/providers/sqlite/sender-key.store.js +0 -198
  589. package/dist/esm/store/providers/sqlite/signal.store.js +0 -435
  590. package/dist/esm/store/providers/sqlite/table-names.js +0 -107
  591. package/dist/esm/store/providers/sqlite/thread.store.js +0 -85
  592. package/dist/esm/transport/node/builders/index.js +0 -8
  593. package/dist/retry/outbound.js +0 -87
  594. package/dist/store/providers/sqlite/BaseSqliteStore.js +0 -41
  595. package/dist/store/providers/sqlite/appstate.store.js +0 -254
  596. package/dist/store/providers/sqlite/auth.store.js +0 -180
  597. package/dist/store/providers/sqlite/connection.js +0 -281
  598. package/dist/store/providers/sqlite/contact.store.js +0 -78
  599. package/dist/store/providers/sqlite/device-list.store.js +0 -131
  600. package/dist/store/providers/sqlite/message.store.js +0 -136
  601. package/dist/store/providers/sqlite/migrations.js +0 -350
  602. package/dist/store/providers/sqlite/participants.store.js +0 -81
  603. package/dist/store/providers/sqlite/retry.store.js +0 -145
  604. package/dist/store/providers/sqlite/sender-key.store.js +0 -202
  605. package/dist/store/providers/sqlite/signal.store.js +0 -439
  606. package/dist/store/providers/sqlite/table-names.js +0 -113
  607. package/dist/store/providers/sqlite/thread.store.js +0 -89
  608. package/dist/transport/node/builders/index.js +0 -42
  609. package/dist/types/appstate/store/sqlite.d.ts +0 -7
  610. package/dist/types/auth/flow/WaAuthCredentialsFlow.d.ts +0 -14
  611. package/dist/types/auth/pairing/constants.d.ts +0 -2
  612. package/dist/types/client/connection/WaKeyShareCoordinator.d.ts +0 -14
  613. package/dist/types/crypto/core/constants.d.ts +0 -1
  614. package/dist/types/retry/outbound.d.ts +0 -4
  615. package/dist/types/store/providers/sqlite/BaseSqliteStore.d.ts +0 -12
  616. package/dist/types/store/providers/sqlite/appstate.store.d.ts +0 -17
  617. package/dist/types/store/providers/sqlite/auth.store.d.ts +0 -10
  618. package/dist/types/store/providers/sqlite/connection.d.ts +0 -10
  619. package/dist/types/store/providers/sqlite/contact.store.d.ts +0 -12
  620. package/dist/types/store/providers/sqlite/device-list.store.d.ts +0 -15
  621. package/dist/types/store/providers/sqlite/message.store.d.ts +0 -13
  622. package/dist/types/store/providers/sqlite/migrations.d.ts +0 -3
  623. package/dist/types/store/providers/sqlite/participants.store.d.ts +0 -12
  624. package/dist/types/store/providers/sqlite/retry.store.d.ts +0 -15
  625. package/dist/types/store/providers/sqlite/sender-key.store.d.ts +0 -24
  626. package/dist/types/store/providers/sqlite/signal.store.d.ts +0 -53
  627. package/dist/types/store/providers/sqlite/table-names.d.ts +0 -5
  628. package/dist/types/store/providers/sqlite/thread.store.d.ts +0 -13
  629. package/dist/types/transport/node/builders/index.d.ts +0 -8
  630. /package/dist/appstate/{WaAppStateSyncResponseParser.js → response-parser.js} +0 -0
@@ -2,6 +2,7 @@ import { WaComms } from '../../transport/WaComms.js';
2
2
  import { toError } from '../../util/primitives.js';
3
3
  export class WaConnectionManager {
4
4
  constructor(options) {
5
+ this.lastConnectWasNewLogin = false;
5
6
  this.logger = options.logger;
6
7
  this.options = options.options;
7
8
  this.authClient = options.authClient;
@@ -30,11 +31,12 @@ export class WaConnectionManager {
30
31
  const operation = this.runLifecycleOperation(async () => {
31
32
  await this.connectInternal(frameHandler, lifecycleGeneration);
32
33
  });
33
- this.connectPromise = operation.finally(() => {
34
- if (this.connectPromise === operation) {
34
+ const promise = operation.finally(() => {
35
+ if (this.connectPromise === promise) {
35
36
  this.connectPromise = null;
36
37
  }
37
38
  });
39
+ this.connectPromise = promise;
38
40
  return this.connectPromise;
39
41
  }
40
42
  scheduleReconnectAfterPairing() {
@@ -64,6 +66,9 @@ export class WaConnectionManager {
64
66
  isConnected() {
65
67
  return !!(this.comms && this.comms.getCommsState().connected);
66
68
  }
69
+ wasNewLogin() {
70
+ return this.lastConnectWasNewLogin;
71
+ }
67
72
  getComms() {
68
73
  return this.comms;
69
74
  }
@@ -93,6 +98,7 @@ export class WaConnectionManager {
93
98
  }
94
99
  this.logger.info('wa client connect start');
95
100
  let credentials = await this.authClient.loadOrCreateCredentials();
101
+ this.lastConnectWasNewLogin = !credentials.meJid;
96
102
  this.assertLifecycleCurrent(lifecycleGeneration, 'connect');
97
103
  try {
98
104
  await this.startCommsWithCredentials(credentials, frameHandler, lifecycleGeneration);
@@ -127,11 +133,12 @@ export class WaConnectionManager {
127
133
  const operation = this.runLifecycleOperation(async () => {
128
134
  await this.reconnectAsRegisteredAfterPairingInternal();
129
135
  });
130
- this.pairingReconnectPromise = operation.finally(() => {
131
- if (this.pairingReconnectPromise === operation) {
136
+ const promise = operation.finally(() => {
137
+ if (this.pairingReconnectPromise === promise) {
132
138
  this.pairingReconnectPromise = null;
133
139
  }
134
140
  });
141
+ this.pairingReconnectPromise = promise;
135
142
  return this.pairingReconnectPromise;
136
143
  }
137
144
  async reconnectAsRegisteredAfterPairingInternal() {
@@ -176,12 +183,14 @@ export class WaConnectionManager {
176
183
  this.pendingComms = null;
177
184
  this.clearCommsBinding(currentComms ?? undefined);
178
185
  await this.authClient.clearTransientState();
179
- if (pendingComms) {
180
- await this.stopCommsQuietly(pendingComms, 'failed to stop pending comms during disconnect');
181
- }
182
- if (currentComms) {
183
- await this.stopCommsQuietly(currentComms, 'failed to stop comms during disconnect');
184
- }
186
+ await Promise.all([
187
+ pendingComms && pendingComms !== currentComms
188
+ ? this.stopCommsQuietly(pendingComms, 'failed to stop pending comms during disconnect')
189
+ : Promise.resolve(),
190
+ currentComms
191
+ ? this.stopCommsQuietly(currentComms, 'failed to stop comms during disconnect')
192
+ : Promise.resolve()
193
+ ]);
185
194
  if (this.isLifecycleCurrent(lifecycleGeneration)) {
186
195
  this.logger.info('wa client disconnected');
187
196
  }
@@ -191,7 +200,10 @@ export class WaConnectionManager {
191
200
  this.logger.debug('starting comms with credentials', {
192
201
  registered: credentials.meJid !== null && credentials.meJid !== undefined
193
202
  });
194
- const commsConfig = this.authClient.buildCommsConfig(this.options);
203
+ const commsConfig = this.authClient.buildCommsConfig(this.options, {
204
+ noiseTrustedRootCa: this.options.testHooks?.noiseRootCa,
205
+ disableNoiseCertificateChainVerification: this.options.dangerous?.disableNoiseCertificateChainVerification
206
+ });
195
207
  const comms = new WaComms(commsConfig, this.logger);
196
208
  this.pendingComms = comms;
197
209
  this.mediaConnCache = null;
@@ -0,0 +1,137 @@
1
+ import { parseAbPropsIqResult } from '../events/abprops.js';
2
+ import { AB_PROP_CONFIGS, resolveAbPropNameByCode, WA_ABPROPS_REFRESH_BOUNDS } from '../../protocol/abprops.js';
3
+ import { WA_DEFAULTS } from '../../protocol/constants.js';
4
+ import { buildGetAbPropsIq } from '../../transport/node/builders/abprops.js';
5
+ import { toError } from '../../util/primitives.js';
6
+ export class WaAbPropsCoordinator {
7
+ constructor(options) {
8
+ this.logger = options.logger;
9
+ this.runtime = options.runtime;
10
+ this.cache = new Map();
11
+ this.syncState = { hash: null, abKey: null, refreshId: null };
12
+ this.syncPromise = null;
13
+ this.syncEpoch = 0;
14
+ this.pendingSync = false;
15
+ }
16
+ getConfigValue(name) {
17
+ const cached = this.cache.get(name);
18
+ if (cached !== undefined) {
19
+ return cached;
20
+ }
21
+ return AB_PROP_CONFIGS[name].defaultValue;
22
+ }
23
+ sync() {
24
+ if (this.syncPromise) {
25
+ this.pendingSync = true;
26
+ return;
27
+ }
28
+ this.startSync();
29
+ }
30
+ reset() {
31
+ this.cache.clear();
32
+ this.syncState.hash = null;
33
+ this.syncState.abKey = null;
34
+ this.syncState.refreshId = null;
35
+ this.syncPromise = null;
36
+ this.pendingSync = false;
37
+ this.syncEpoch += 1;
38
+ }
39
+ startSync() {
40
+ const epoch = this.syncEpoch;
41
+ this.pendingSync = false;
42
+ this.syncPromise = this.executeSyncWithRetry(epoch)
43
+ .catch((error) => {
44
+ this.logger.warn('ab props sync failed', {
45
+ message: toError(error).message
46
+ });
47
+ })
48
+ .finally(() => {
49
+ if (this.syncEpoch !== epoch) {
50
+ return;
51
+ }
52
+ this.syncPromise = null;
53
+ if (this.pendingSync) {
54
+ this.startSync();
55
+ }
56
+ });
57
+ }
58
+ async executeSyncWithRetry(epoch) {
59
+ const maxRetries = 3;
60
+ for (let attempt = 0; attempt < maxRetries; attempt += 1) {
61
+ if (this.syncEpoch !== epoch) {
62
+ return;
63
+ }
64
+ try {
65
+ await this.executeSync(epoch);
66
+ return;
67
+ }
68
+ catch (error) {
69
+ if (attempt === maxRetries - 1) {
70
+ throw error;
71
+ }
72
+ this.logger.debug('ab props sync retrying', {
73
+ attempt: attempt + 1,
74
+ message: toError(error).message
75
+ });
76
+ }
77
+ }
78
+ }
79
+ async executeSync(epoch) {
80
+ const iqNode = buildGetAbPropsIq({
81
+ hash: this.syncState.hash,
82
+ refreshId: this.syncState.refreshId
83
+ });
84
+ const response = await this.runtime.queryWithContext('abprops.sync', iqNode, WA_DEFAULTS.IQ_TIMEOUT_MS);
85
+ if (this.syncEpoch !== epoch) {
86
+ return;
87
+ }
88
+ const result = parseAbPropsIqResult(response);
89
+ if (result.abKey !== null) {
90
+ this.syncState.abKey = result.abKey;
91
+ }
92
+ if (result.hash !== null) {
93
+ this.syncState.hash = result.hash;
94
+ }
95
+ if (result.refreshId !== null) {
96
+ this.syncState.refreshId = result.refreshId;
97
+ }
98
+ if (!result.isDeltaUpdate) {
99
+ this.cache.clear();
100
+ }
101
+ let applied = 0;
102
+ for (let i = 0; i < result.props.length; i += 1) {
103
+ const entry = result.props[i];
104
+ const name = resolveAbPropNameByCode(entry.configCode);
105
+ if (!name) {
106
+ continue;
107
+ }
108
+ const config = AB_PROP_CONFIGS[name];
109
+ const parsed = parseConfigValue(entry.configValue, config.type, config.defaultValue);
110
+ this.cache.set(name, parsed);
111
+ applied += 1;
112
+ }
113
+ this.logger.info('ab props synced', {
114
+ received: result.props.length,
115
+ applied,
116
+ isDelta: result.isDeltaUpdate,
117
+ abKey: result.abKey,
118
+ refresh: result.refresh !== null ? clampRefresh(result.refresh) : null
119
+ });
120
+ }
121
+ }
122
+ function parseConfigValue(value, type, defaultValue) {
123
+ if (value === null) {
124
+ return defaultValue;
125
+ }
126
+ if (type === 'bool') {
127
+ return value === '1' || value === 'true' || value === 'True';
128
+ }
129
+ if (type === 'int') {
130
+ const parsed = Number.parseInt(value, 10);
131
+ return Number.isSafeInteger(parsed) ? parsed : defaultValue;
132
+ }
133
+ return value;
134
+ }
135
+ function clampRefresh(seconds) {
136
+ return Math.max(WA_ABPROPS_REFRESH_BOUNDS.MIN_S, Math.min(WA_ABPROPS_REFRESH_BOUNDS.MAX_S, seconds));
137
+ }
@@ -0,0 +1,229 @@
1
+ import { proto } from '../../proto.js';
2
+ import { buildDeleteCoverPhotoIq, buildEditBusinessProfileIq, buildGetBusinessProfileIq, buildGetVerifiedNameIq, buildUpdateCoverPhotoIq } from '../../transport/node/builders/business.js';
3
+ import { findNodeChild, getNodeChildren, getNodeTextContent } from '../../transport/node/helpers.js';
4
+ import { assertIqResult } from '../../transport/node/query.js';
5
+ import { longToNumber } from '../../util/primitives.js';
6
+ function parseBusinessProfiles(result) {
7
+ const bizNode = findNodeChild(result, 'business_profile');
8
+ if (!bizNode) {
9
+ return [];
10
+ }
11
+ const profileNodes = getNodeChildren(bizNode);
12
+ const results = new Array(profileNodes.length);
13
+ let count = 0;
14
+ for (let i = 0; i < profileNodes.length; i += 1) {
15
+ const profileNode = profileNodes[i];
16
+ if (profileNode.tag !== 'profile')
17
+ continue;
18
+ const jid = profileNode.attrs.jid;
19
+ if (!jid)
20
+ continue;
21
+ const entry = { jid };
22
+ const tag = profileNode.attrs.tag;
23
+ if (tag)
24
+ entry.tag = tag;
25
+ const children = profileNode.content;
26
+ if (!Array.isArray(children)) {
27
+ results[count] = entry;
28
+ count += 1;
29
+ continue;
30
+ }
31
+ const websites = [];
32
+ for (let j = 0; j < children.length; j += 1) {
33
+ const child = children[j];
34
+ const text = getNodeTextContent(child);
35
+ switch (child.tag) {
36
+ case 'description':
37
+ if (text !== undefined)
38
+ entry.description = text;
39
+ break;
40
+ case 'address':
41
+ if (text !== undefined)
42
+ entry.address = text;
43
+ break;
44
+ case 'email':
45
+ if (text !== undefined)
46
+ entry.email = text;
47
+ break;
48
+ case 'website':
49
+ if (text !== undefined)
50
+ websites.push({ url: text });
51
+ break;
52
+ case 'latitude':
53
+ if (text !== undefined) {
54
+ const val = Number.parseFloat(text);
55
+ if (!Number.isNaN(val))
56
+ entry.latitude = val;
57
+ }
58
+ break;
59
+ case 'longitude':
60
+ if (text !== undefined) {
61
+ const val = Number.parseFloat(text);
62
+ if (!Number.isNaN(val))
63
+ entry.longitude = val;
64
+ }
65
+ break;
66
+ case 'categories':
67
+ entry.categories = parseBusinessCategories(child);
68
+ break;
69
+ case 'business_hours':
70
+ entry.businessHours = parseBusinessHoursNode(child);
71
+ break;
72
+ case 'profile_options':
73
+ entry.profileOptions = parseProfileOptions(child);
74
+ break;
75
+ }
76
+ }
77
+ if (websites.length > 0)
78
+ entry.websites = websites;
79
+ results[count] = entry;
80
+ count += 1;
81
+ }
82
+ results.length = count;
83
+ return results;
84
+ }
85
+ function parseBusinessCategories(node) {
86
+ const children = getNodeChildren(node);
87
+ const categories = new Array(children.length);
88
+ let count = 0;
89
+ for (let i = 0; i < children.length; i += 1) {
90
+ const child = children[i];
91
+ if (child.tag !== 'category')
92
+ continue;
93
+ const id = child.attrs.id;
94
+ if (!id)
95
+ continue;
96
+ categories[count] = { id, name: getNodeTextContent(child) ?? '' };
97
+ count += 1;
98
+ }
99
+ categories.length = count;
100
+ return categories;
101
+ }
102
+ function parseBusinessHoursNode(node) {
103
+ const timezone = node.attrs.timezone;
104
+ const children = getNodeChildren(node);
105
+ const config = new Array(children.length);
106
+ let count = 0;
107
+ for (let i = 0; i < children.length; i += 1) {
108
+ const child = children[i];
109
+ if (child.tag !== 'business_hours_config')
110
+ continue;
111
+ const dayOfWeek = child.attrs.day_of_week;
112
+ const mode = child.attrs.mode;
113
+ if (!dayOfWeek || !mode)
114
+ continue;
115
+ const entry = { dayOfWeek, mode };
116
+ const openTime = child.attrs.open_time;
117
+ const closeTime = child.attrs.close_time;
118
+ if (openTime)
119
+ entry.openTime = Number.parseInt(openTime, 10);
120
+ if (closeTime)
121
+ entry.closeTime = Number.parseInt(closeTime, 10);
122
+ config[count] = entry;
123
+ count += 1;
124
+ }
125
+ config.length = count;
126
+ return { timezone, config };
127
+ }
128
+ function parseProfileOptions(node) {
129
+ const children = getNodeChildren(node);
130
+ const options = {};
131
+ for (let i = 0; i < children.length; i += 1) {
132
+ const child = children[i];
133
+ const text = getNodeTextContent(child);
134
+ if (text !== undefined) {
135
+ options[child.tag] = text;
136
+ }
137
+ }
138
+ return options;
139
+ }
140
+ const VN_ISSUER_API = 'ent:wa';
141
+ const VN_ISSUER_SMB = 'smb:wa';
142
+ function parseCertificateContent(contentBytes) {
143
+ try {
144
+ const cert = proto.VerifiedNameCertificate.decode(contentBytes);
145
+ if (!cert.details)
146
+ return null;
147
+ const details = proto.VerifiedNameCertificate.Details.decode(cert.details);
148
+ return {
149
+ name: details.verifiedName ?? undefined,
150
+ serial: details.serial !== null && details.serial !== undefined
151
+ ? String(longToNumber(details.serial))
152
+ : undefined,
153
+ isApi: details.issuer === VN_ISSUER_API,
154
+ isSmb: details.issuer === VN_ISSUER_SMB
155
+ };
156
+ }
157
+ catch {
158
+ return null;
159
+ }
160
+ }
161
+ function parseVerifiedName(result) {
162
+ const vnNode = findNodeChild(result, 'verified_name');
163
+ if (!vnNode)
164
+ return null;
165
+ const level = vnNode.attrs.verified_level;
166
+ const attrSerial = vnNode.attrs.serial;
167
+ const contentBytes = vnNode.content instanceof Uint8Array ? vnNode.content : undefined;
168
+ const certData = contentBytes !== undefined ? parseCertificateContent(contentBytes) : null;
169
+ const entry = {
170
+ name: certData?.name,
171
+ level,
172
+ serial: attrSerial ?? certData?.serial,
173
+ isApi: certData?.isApi === true,
174
+ isSmb: certData?.isSmb === true
175
+ };
176
+ const actualActors = vnNode.attrs.actual_actors;
177
+ const hostStorage = vnNode.attrs.host_storage;
178
+ const privacyModeTs = vnNode.attrs.privacy_mode_ts;
179
+ if (actualActors !== undefined && hostStorage !== undefined && privacyModeTs !== undefined) {
180
+ entry.privacyMode = {
181
+ actualActors: Number.parseInt(actualActors, 10),
182
+ hostStorage: Number.parseInt(hostStorage, 10),
183
+ privacyModeTs: Number.parseInt(privacyModeTs, 10)
184
+ };
185
+ }
186
+ return entry;
187
+ }
188
+ export function createBusinessCoordinator(options) {
189
+ const { queryWithContext } = options;
190
+ return {
191
+ getBusinessProfile: async (jids) => {
192
+ if (jids.length === 0)
193
+ return [];
194
+ const node = buildGetBusinessProfileIq(jids);
195
+ const result = await queryWithContext('business.getProfile', node, undefined, {
196
+ count: jids.length
197
+ });
198
+ assertIqResult(result, 'business.getProfile');
199
+ return parseBusinessProfiles(result);
200
+ },
201
+ editBusinessProfile: async (input) => {
202
+ const node = buildEditBusinessProfileIq(input);
203
+ const result = await queryWithContext('business.editProfile', node);
204
+ assertIqResult(result, 'business.editProfile');
205
+ },
206
+ getVerifiedName: async (jid) => {
207
+ const node = buildGetVerifiedNameIq(jid);
208
+ const result = await queryWithContext('business.getVerifiedName', node, undefined, {
209
+ jid
210
+ });
211
+ assertIqResult(result, 'business.getVerifiedName');
212
+ return parseVerifiedName(result);
213
+ },
214
+ updateCoverPhoto: async (id, timestamp, token) => {
215
+ const node = buildUpdateCoverPhotoIq(id, timestamp, token);
216
+ const result = await queryWithContext('business.updateCoverPhoto', node, undefined, {
217
+ id
218
+ });
219
+ assertIqResult(result, 'business.updateCoverPhoto');
220
+ },
221
+ deleteCoverPhoto: async (id) => {
222
+ const node = buildDeleteCoverPhotoIq(id);
223
+ const result = await queryWithContext('business.deleteCoverPhoto', node, undefined, {
224
+ id
225
+ });
226
+ assertIqResult(result, 'business.deleteCoverPhoto');
227
+ }
228
+ };
229
+ }
@@ -0,0 +1,60 @@
1
+ import { WA_EMAIL_TAGS } from '../../protocol/email.js';
2
+ import { buildConfirmEmailIq, buildGetEmailIq, buildRequestEmailVerificationCodeIq, buildSetEmailIq, buildVerifyEmailCodeIq } from '../../transport/node/builders/email.js';
3
+ import { findNodeChild, getNodeTextContent } from '../../transport/node/helpers.js';
4
+ import { assertIqResult } from '../../transport/node/query.js';
5
+ export function createEmailCoordinator(options) {
6
+ const { queryWithContext } = options;
7
+ return {
8
+ getStatus: async () => {
9
+ const result = await queryWithContext('email.getStatus', buildGetEmailIq());
10
+ assertIqResult(result, 'email.getStatus');
11
+ return parseEmailStatus(result);
12
+ },
13
+ setEmail: async (email, context) => {
14
+ const result = await queryWithContext('email.set', buildSetEmailIq(email, context), undefined, context !== undefined ? { context } : {});
15
+ assertIqResult(result, 'email.set');
16
+ return parseEmailStatus(result);
17
+ },
18
+ requestVerificationCode: async (input) => {
19
+ const result = await queryWithContext('email.requestCode', buildRequestEmailVerificationCodeIq(input), undefined, { languageCode: input.languageCode, localeCode: input.localeCode });
20
+ assertIqResult(result, 'email.requestCode');
21
+ },
22
+ verifyCode: async (code) => {
23
+ const result = await queryWithContext('email.verifyCode', buildVerifyEmailCodeIq(code));
24
+ assertIqResult(result, 'email.verifyCode');
25
+ return parseVerifyCodeResult(result);
26
+ },
27
+ confirm: async (context) => {
28
+ const result = await queryWithContext('email.confirm', buildConfirmEmailIq(context), undefined, context !== undefined ? { context } : {});
29
+ assertIqResult(result, 'email.confirm');
30
+ }
31
+ };
32
+ }
33
+ function parseEmailStatus(result) {
34
+ const emailNode = findNodeChild(result, WA_EMAIL_TAGS.EMAIL);
35
+ if (!emailNode) {
36
+ return { email: null, verified: false, confirmed: false };
37
+ }
38
+ const verifiedAttr = emailNode.attrs.verified;
39
+ const addressNode = findNodeChild(emailNode, WA_EMAIL_TAGS.EMAIL_ADDRESS);
40
+ const confirmedNode = findNodeChild(emailNode, WA_EMAIL_TAGS.CONFIRMED);
41
+ return {
42
+ email: addressNode ? (getNodeTextContent(addressNode) ?? null) : null,
43
+ verified: verifiedAttr === 'true',
44
+ confirmed: confirmedNode ? getNodeTextContent(confirmedNode) === 'true' : false
45
+ };
46
+ }
47
+ function parseVerifyCodeResult(result) {
48
+ const emailNode = findNodeChild(result, WA_EMAIL_TAGS.EMAIL);
49
+ if (!emailNode) {
50
+ return { verified: false, autoVerifyFailed: false, email: null };
51
+ }
52
+ const doVerify = emailNode.attrs.do_verify;
53
+ const autoVerifyNode = findNodeChild(emailNode, WA_EMAIL_TAGS.AUTO_VERIFY);
54
+ const addressNode = findNodeChild(emailNode, WA_EMAIL_TAGS.EMAIL_ADDRESS);
55
+ return {
56
+ verified: doVerify === 'true',
57
+ autoVerifyFailed: autoVerifyNode ? getNodeTextContent(autoVerifyNode) === 'fail' : false,
58
+ email: addressNode ? (getNodeTextContent(addressNode) ?? null) : null
59
+ };
60
+ }
@@ -7,20 +7,24 @@ import { findNodeChild, getNodeChildrenByTagFromChildren, hasNodeChild } from '.
7
7
  import { assertIqResult, buildIqNode } from '../../transport/node/query.js';
8
8
  function parseGroupParticipants(node) {
9
9
  const parsed = parseGroupEventParticipants(node);
10
- const participants = [];
11
- for (const participant of parsed) {
10
+ const participants = new Array(parsed.length);
11
+ let participantsCount = 0;
12
+ for (let index = 0; index < parsed.length; index += 1) {
13
+ const participant = parsed[index];
12
14
  if (!participant.jid) {
13
15
  continue;
14
16
  }
15
17
  const type = participant.role ?? WA_GROUP_PARTICIPANT_TYPES.REGULAR;
16
- participants.push({
18
+ participants[participantsCount] = {
17
19
  jid: participant.jid,
18
20
  type,
19
21
  isAdmin: type === WA_GROUP_PARTICIPANT_TYPES.ADMIN ||
20
22
  type === WA_GROUP_PARTICIPANT_TYPES.SUPERADMIN,
21
23
  isSuperAdmin: type === WA_GROUP_PARTICIPANT_TYPES.SUPERADMIN
22
- });
24
+ };
25
+ participantsCount += 1;
23
26
  }
27
+ participants.length = participantsCount;
24
28
  return participants;
25
29
  }
26
30
  function parseGroupMetadata(node) {
@@ -101,9 +105,9 @@ export function createGroupCoordinator(options) {
101
105
  const result = await queryWithContext('group.list', node);
102
106
  assertIqResult(result, 'group.list');
103
107
  const groupNodes = getNodeChildrenByTagFromChildren(result, WA_NODE_TAGS.GROUP);
104
- const metadata = [];
105
- for (const groupNode of groupNodes) {
106
- metadata.push(parseGroupMetadata(groupNode));
108
+ const metadata = new Array(groupNodes.length);
109
+ for (let index = 0; index < groupNodes.length; index += 1) {
110
+ metadata[index] = parseGroupMetadata(groupNodes[index]);
107
111
  }
108
112
  return metadata;
109
113
  },
@@ -1,9 +1,9 @@
1
- import { createIncomingBaseEvent, createIncomingFailureHandler, createIncomingGroupNotificationHandler, createIncomingNotificationHandler, createIncomingReceiptHandler, createInfoBulletinNotificationEvent, createUnhandledIncomingNodeEvent } from '../incoming.js';
1
+ import { createIncomingBaseEvent, createIncomingFailureHandler, createIncomingGroupNotificationHandler, createIncomingNotificationHandler, createIncomingReceiptHandler, createIncomingRegistrationNotificationHandler, createInfoBulletinNotificationEvent, createUnhandledIncomingNodeEvent } from '../incoming.js';
2
2
  import { WA_IQ_TYPES, WA_MESSAGE_TAGS, WA_NODE_TAGS, WA_NOTIFICATION_TYPES, WA_SIGNALING } from '../../protocol/constants.js';
3
- import { decodeNodeContentBase64OrBytes, findNodeChild, getNodeChildrenByTag } from '../../transport/node/helpers.js';
3
+ import { decodeNodeContentBase64OrBytes, findNodeChild, getNodeChildren, getNodeChildrenByTag } from '../../transport/node/helpers.js';
4
4
  import { parseStreamControlNode, parseSuccessPersistAttributes } from '../../transport/stream/parse.js';
5
5
  import { parseOptionalInt, toError } from '../../util/primitives.js';
6
- const INFO_BULLETIN_NOTIFICATION_TYPES = new Set([
6
+ const INFO_BULLETIN_CHILD_TAGS = new Set([
7
7
  'offline',
8
8
  'offline_preview',
9
9
  'priority_offline_complete',
@@ -15,6 +15,7 @@ export class WaIncomingNodeCoordinator {
15
15
  constructor(options) {
16
16
  this.logger = options.logger;
17
17
  this.runtime = options.runtime;
18
+ this.offlineResume = options.offlineResume;
18
19
  this.nodeHandlerRegistry = new Map();
19
20
  this.registerDefaultIncomingHandlers();
20
21
  this.mediaConnWarmupPromise = null;
@@ -25,6 +26,9 @@ export class WaIncomingNodeCoordinator {
25
26
  id: node.attrs.id,
26
27
  type: node.attrs.type
27
28
  });
29
+ if (node.attrs.offline !== undefined) {
30
+ this.offlineResume.trackOfflineStanza();
31
+ }
28
32
  const streamControlResult = parseStreamControlNode(node);
29
33
  if (streamControlResult) {
30
34
  await this.runtime.handleStreamControlResult(streamControlResult);
@@ -144,6 +148,16 @@ export class WaIncomingNodeCoordinator {
144
148
  emitUnhandledStanza: runtime.emitUnhandledIncomingNode
145
149
  })
146
150
  });
151
+ this.registerIncomingHandler({
152
+ tag: WA_NODE_TAGS.NOTIFICATION,
153
+ subtype: WA_NOTIFICATION_TYPES.REGISTRATION,
154
+ handler: createIncomingRegistrationNotificationHandler({
155
+ logger: this.logger,
156
+ sendNode: runtime.sendNode,
157
+ emitRegistrationCode: runtime.emitRegistrationCode,
158
+ emitAccountTakeoverNotice: runtime.emitAccountTakeoverNotice
159
+ })
160
+ });
147
161
  this.registerIncomingHandler({
148
162
  tag: WA_NODE_TAGS.NOTIFICATION,
149
163
  handler: createIncomingNotificationHandler({
@@ -197,6 +211,7 @@ export class WaIncomingNodeCoordinator {
197
211
  handler: createIncomingFailureHandler({
198
212
  logger: this.logger,
199
213
  emitIncomingFailure: runtime.emitIncomingFailure,
214
+ stopComms: runtime.stopComms,
200
215
  disconnect: runtime.disconnect,
201
216
  clearStoredCredentials: runtime.clearStoredCredentials
202
217
  })
@@ -262,13 +277,24 @@ export class WaIncomingNodeCoordinator {
262
277
  return false;
263
278
  }
264
279
  let handled = false;
265
- const ibType = node.attrs.type;
266
- if (ibType && INFO_BULLETIN_NOTIFICATION_TYPES.has(ibType)) {
267
- this.runtime.emitIncomingNotification(createInfoBulletinNotificationEvent(node, ibType, {
268
- count: parseOptionalInt(node.attrs.count),
269
- t: parseOptionalInt(node.attrs.t)
270
- }));
271
- handled = true;
280
+ const children = getNodeChildren(node);
281
+ for (const child of children) {
282
+ if (INFO_BULLETIN_CHILD_TAGS.has(child.tag)) {
283
+ this.runtime.emitIncomingNotification(createInfoBulletinNotificationEvent(node, child.tag, {
284
+ count: parseOptionalInt(child.attrs.count),
285
+ message: parseOptionalInt(child.attrs.message),
286
+ receipt: parseOptionalInt(child.attrs.receipt),
287
+ notification: parseOptionalInt(child.attrs.notification),
288
+ t: parseOptionalInt(child.attrs.t)
289
+ }));
290
+ if (child.tag === 'offline_preview') {
291
+ this.offlineResume.handleOfflinePreview(parseOptionalInt(child.attrs.count) ?? 0);
292
+ }
293
+ if (child.tag === 'offline') {
294
+ this.offlineResume.handleOfflineComplete(parseOptionalInt(child.attrs.count) ?? 0);
295
+ }
296
+ handled = true;
297
+ }
272
298
  }
273
299
  const edgeRoutingNode = findNodeChild(node, WA_NODE_TAGS.EDGE_ROUTING);
274
300
  if (edgeRoutingNode) {