@open-e2ee/signal-protocol-sdk 10.1.0 → 12.0.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 (595) hide show
  1. package/ADAPTERS.md +4 -4
  2. package/ARCHITECTURE.md +6 -8
  3. package/CHANGELOG.md +1413 -0
  4. package/README.md +1 -1
  5. package/SECURITY.md +2 -2
  6. package/TROUBLESHOOTING.md +1 -1
  7. package/client/README.md +84 -37
  8. package/device/README.md +39 -85
  9. package/dist/client/client.d.ts +342 -62
  10. package/dist/client/client.d.ts.map +1 -1
  11. package/dist/client/client.js +1195 -179
  12. package/dist/client/client.js.map +1 -1
  13. package/dist/client/config.d.ts +40 -32
  14. package/dist/client/config.d.ts.map +1 -1
  15. package/dist/client/config.js +1 -1
  16. package/dist/client/config.js.map +1 -1
  17. package/dist/client/constants.d.ts +42 -8
  18. package/dist/client/constants.d.ts.map +1 -1
  19. package/dist/client/constants.js +48 -3
  20. package/dist/client/constants.js.map +1 -1
  21. package/dist/client/content-adapter.d.ts +80 -0
  22. package/dist/client/content-adapter.d.ts.map +1 -1
  23. package/dist/client/content-adapter.js +225 -12
  24. package/dist/client/content-adapter.js.map +1 -1
  25. package/dist/client/delivery-error.d.ts +150 -0
  26. package/dist/client/delivery-error.d.ts.map +1 -0
  27. package/dist/client/delivery-error.js +226 -0
  28. package/dist/client/delivery-error.js.map +1 -0
  29. package/dist/client/delivery-status.d.ts +32 -6
  30. package/dist/client/delivery-status.d.ts.map +1 -1
  31. package/dist/client/delivery-status.js +61 -13
  32. package/dist/client/delivery-status.js.map +1 -1
  33. package/dist/client/device-set-reconciliation.d.ts +196 -0
  34. package/dist/client/device-set-reconciliation.d.ts.map +1 -0
  35. package/dist/client/device-set-reconciliation.js +282 -0
  36. package/dist/client/device-set-reconciliation.js.map +1 -0
  37. package/dist/client/distribution-records.d.ts +29 -0
  38. package/dist/client/distribution-records.d.ts.map +1 -0
  39. package/dist/client/distribution-records.js +33 -0
  40. package/dist/client/distribution-records.js.map +1 -0
  41. package/dist/client/event-hooks.d.ts +308 -6
  42. package/dist/client/event-hooks.d.ts.map +1 -1
  43. package/dist/client/event-hooks.js +9 -0
  44. package/dist/client/event-hooks.js.map +1 -1
  45. package/dist/client/group-device-set.d.ts +47 -0
  46. package/dist/client/group-device-set.d.ts.map +1 -0
  47. package/dist/client/group-device-set.js +65 -0
  48. package/dist/client/group-device-set.js.map +1 -0
  49. package/dist/client/group-fetcher.d.ts +116 -0
  50. package/dist/client/group-fetcher.d.ts.map +1 -0
  51. package/dist/client/group-fetcher.js +598 -0
  52. package/dist/client/group-fetcher.js.map +1 -0
  53. package/dist/client/group-outbox.d.ts +172 -10
  54. package/dist/client/group-outbox.d.ts.map +1 -1
  55. package/dist/client/group-outbox.js +915 -74
  56. package/dist/client/group-outbox.js.map +1 -1
  57. package/dist/client/group-receive-authorization.d.ts +127 -4
  58. package/dist/client/group-receive-authorization.d.ts.map +1 -1
  59. package/dist/client/group-receive-authorization.js +270 -20
  60. package/dist/client/group-receive-authorization.js.map +1 -1
  61. package/dist/client/group-sealed-sender.d.ts +3 -0
  62. package/dist/client/group-sealed-sender.d.ts.map +1 -1
  63. package/dist/client/group-sealed-sender.js +1 -0
  64. package/dist/client/group-sealed-sender.js.map +1 -1
  65. package/dist/client/group-sender-key-operations.d.ts +14 -3
  66. package/dist/client/group-sender-key-operations.d.ts.map +1 -1
  67. package/dist/client/group-sender-key-operations.js +26 -5
  68. package/dist/client/group-sender-key-operations.js.map +1 -1
  69. package/dist/client/groups.d.ts +5 -5
  70. package/dist/client/groups.d.ts.map +1 -1
  71. package/dist/client/groups.js +5 -4
  72. package/dist/client/groups.js.map +1 -1
  73. package/dist/client/hosted-anonymous-delivery.d.ts +61 -9
  74. package/dist/client/hosted-anonymous-delivery.d.ts.map +1 -1
  75. package/dist/client/hosted-anonymous-delivery.js +242 -48
  76. package/dist/client/hosted-anonymous-delivery.js.map +1 -1
  77. package/dist/client/hosted-assertion-id.d.ts +7 -0
  78. package/dist/client/hosted-assertion-id.d.ts.map +1 -0
  79. package/dist/client/hosted-assertion-id.js +51 -0
  80. package/dist/client/hosted-assertion-id.js.map +1 -0
  81. package/dist/client/hosted-device-standing.d.ts +52 -0
  82. package/dist/client/hosted-device-standing.d.ts.map +1 -0
  83. package/dist/client/hosted-device-standing.js +74 -0
  84. package/dist/client/hosted-device-standing.js.map +1 -0
  85. package/dist/client/hosted-mailbox-subscription.d.ts +48 -3
  86. package/dist/client/hosted-mailbox-subscription.d.ts.map +1 -1
  87. package/dist/client/hosted-mailbox-subscription.js +288 -74
  88. package/dist/client/hosted-mailbox-subscription.js.map +1 -1
  89. package/dist/client/hosted-push.d.ts +22 -4
  90. package/dist/client/hosted-push.d.ts.map +1 -1
  91. package/dist/client/hosted-push.js +75 -22
  92. package/dist/client/hosted-push.js.map +1 -1
  93. package/dist/client/hosted-transport.d.ts +22 -28
  94. package/dist/client/hosted-transport.d.ts.map +1 -1
  95. package/dist/client/hosted-transport.js +167 -69
  96. package/dist/client/hosted-transport.js.map +1 -1
  97. package/dist/client/hosted.d.ts +22 -5
  98. package/dist/client/hosted.d.ts.map +1 -1
  99. package/dist/client/hosted.js +122 -45
  100. package/dist/client/hosted.js.map +1 -1
  101. package/dist/client/index.d.ts +6 -4
  102. package/dist/client/index.d.ts.map +1 -1
  103. package/dist/client/index.js +3 -1
  104. package/dist/client/index.js.map +1 -1
  105. package/dist/client/messages.d.ts +25 -3
  106. package/dist/client/messages.d.ts.map +1 -1
  107. package/dist/client/messages.js +118 -17
  108. package/dist/client/messages.js.map +1 -1
  109. package/dist/client/one-time-prekey-refill.d.ts +7 -0
  110. package/dist/client/one-time-prekey-refill.d.ts.map +1 -1
  111. package/dist/client/one-time-prekey-refill.js +5 -1
  112. package/dist/client/one-time-prekey-refill.js.map +1 -1
  113. package/dist/client/receive-admission.d.ts +58 -0
  114. package/dist/client/receive-admission.d.ts.map +1 -0
  115. package/dist/client/receive-admission.js +78 -0
  116. package/dist/client/receive-admission.js.map +1 -0
  117. package/dist/client/receive-expiry.d.ts +31 -0
  118. package/dist/client/receive-expiry.d.ts.map +1 -0
  119. package/dist/client/receive-expiry.js +35 -0
  120. package/dist/client/receive-expiry.js.map +1 -0
  121. package/dist/client/receive-hook-bound.d.ts +50 -0
  122. package/dist/client/receive-hook-bound.d.ts.map +1 -0
  123. package/dist/client/receive-hook-bound.js +115 -0
  124. package/dist/client/receive-hook-bound.js.map +1 -0
  125. package/dist/client/receive-queue.d.ts +299 -0
  126. package/dist/client/receive-queue.d.ts.map +1 -0
  127. package/dist/client/receive-queue.js +1420 -0
  128. package/dist/client/receive-queue.js.map +1 -0
  129. package/dist/client/receive-work-seed.d.ts +54 -0
  130. package/dist/client/receive-work-seed.d.ts.map +1 -0
  131. package/dist/client/receive-work-seed.js +116 -0
  132. package/dist/client/receive-work-seed.js.map +1 -0
  133. package/dist/client/recovery-driver.d.ts +25 -0
  134. package/dist/client/recovery-driver.d.ts.map +1 -0
  135. package/dist/client/recovery-driver.js +121 -0
  136. package/dist/client/recovery-driver.js.map +1 -0
  137. package/dist/client/relay-acceptance.d.ts +30 -0
  138. package/dist/client/relay-acceptance.d.ts.map +1 -1
  139. package/dist/client/relay-acceptance.js +55 -0
  140. package/dist/client/relay-acceptance.js.map +1 -1
  141. package/dist/client/relay-device-refusal.d.ts +18 -0
  142. package/dist/client/relay-device-refusal.d.ts.map +1 -1
  143. package/dist/client/relay-device-refusal.js +31 -0
  144. package/dist/client/relay-device-refusal.js.map +1 -1
  145. package/dist/client/relay-sealed-route.d.ts +36 -0
  146. package/dist/client/relay-sealed-route.d.ts.map +1 -0
  147. package/dist/client/relay-sealed-route.js +45 -0
  148. package/dist/client/relay-sealed-route.js.map +1 -0
  149. package/dist/client/relay-subscription.d.ts +56 -13
  150. package/dist/client/relay-subscription.d.ts.map +1 -1
  151. package/dist/client/relay-subscription.js +220 -150
  152. package/dist/client/relay-subscription.js.map +1 -1
  153. package/dist/client/resendable-content.d.ts +98 -0
  154. package/dist/client/resendable-content.d.ts.map +1 -0
  155. package/dist/client/resendable-content.js +136 -0
  156. package/dist/client/resendable-content.js.map +1 -0
  157. package/dist/client/retry-family.d.ts +68 -19
  158. package/dist/client/retry-family.d.ts.map +1 -1
  159. package/dist/client/retry-family.js +59 -17
  160. package/dist/client/retry-family.js.map +1 -1
  161. package/dist/client/retry-request-envelope.d.ts +145 -18
  162. package/dist/client/retry-request-envelope.d.ts.map +1 -1
  163. package/dist/client/retry-request-envelope.js +301 -64
  164. package/dist/client/retry-request-envelope.js.map +1 -1
  165. package/dist/client/retry-request-lifecycle.d.ts +157 -0
  166. package/dist/client/retry-request-lifecycle.d.ts.map +1 -0
  167. package/dist/client/retry-request-lifecycle.js +437 -0
  168. package/dist/client/retry-request-lifecycle.js.map +1 -0
  169. package/dist/client/retry-terminal-recovery.d.ts +100 -0
  170. package/dist/client/retry-terminal-recovery.d.ts.map +1 -0
  171. package/dist/client/retry-terminal-recovery.js +164 -0
  172. package/dist/client/retry-terminal-recovery.js.map +1 -0
  173. package/dist/client/retry-utils.d.ts +27 -0
  174. package/dist/client/retry-utils.d.ts.map +1 -1
  175. package/dist/client/retry-utils.js +46 -0
  176. package/dist/client/retry-utils.js.map +1 -1
  177. package/dist/client/retry.d.ts +106 -18
  178. package/dist/client/retry.d.ts.map +1 -1
  179. package/dist/client/retry.js +687 -139
  180. package/dist/client/retry.js.map +1 -1
  181. package/dist/client/sealed-sender.d.ts +23 -6
  182. package/dist/client/sealed-sender.d.ts.map +1 -1
  183. package/dist/client/sealed-sender.js +30 -6
  184. package/dist/client/sealed-sender.js.map +1 -1
  185. package/dist/client/sessions.d.ts +2 -2
  186. package/dist/client/sessions.js +2 -2
  187. package/dist/client/signal-service-cipher.d.ts +726 -19
  188. package/dist/client/signal-service-cipher.d.ts.map +1 -1
  189. package/dist/client/signal-service-cipher.js +2265 -343
  190. package/dist/client/signal-service-cipher.js.map +1 -1
  191. package/dist/client/state.d.ts +5 -0
  192. package/dist/client/state.d.ts.map +1 -1
  193. package/dist/client/state.js +11 -1
  194. package/dist/client/state.js.map +1 -1
  195. package/dist/client/storage-protection.d.ts +64 -0
  196. package/dist/client/storage-protection.d.ts.map +1 -0
  197. package/dist/client/storage-protection.js +150 -0
  198. package/dist/client/storage-protection.js.map +1 -0
  199. package/dist/client/types.d.ts +149 -15
  200. package/dist/client/types.d.ts.map +1 -1
  201. package/dist/client/types.js +1 -1
  202. package/dist/client/types.js.map +1 -1
  203. package/dist/device/constants.d.ts +0 -5
  204. package/dist/device/constants.d.ts.map +1 -1
  205. package/dist/device/constants.js +0 -5
  206. package/dist/device/constants.js.map +1 -1
  207. package/dist/device/expo/index.d.ts +4 -17
  208. package/dist/device/expo/index.d.ts.map +1 -1
  209. package/dist/device/expo/index.js +4 -23
  210. package/dist/device/expo/index.js.map +1 -1
  211. package/dist/device/index.d.ts +0 -2
  212. package/dist/device/index.d.ts.map +1 -1
  213. package/dist/device/index.js +0 -7
  214. package/dist/device/index.js.map +1 -1
  215. package/dist/device/lifecycle/manager.d.ts +5 -4
  216. package/dist/device/lifecycle/manager.d.ts.map +1 -1
  217. package/dist/device/lifecycle/manager.js +16 -16
  218. package/dist/device/lifecycle/manager.js.map +1 -1
  219. package/dist/device/lifecycle/types.d.ts +2 -2
  220. package/dist/device/lifecycle/types.d.ts.map +1 -1
  221. package/dist/device/react-native/index.d.ts +4 -15
  222. package/dist/device/react-native/index.d.ts.map +1 -1
  223. package/dist/device/react-native/index.js +4 -21
  224. package/dist/device/react-native/index.js.map +1 -1
  225. package/dist/device/types.d.ts +1 -1
  226. package/dist/groups/index.d.ts +1 -1
  227. package/dist/groups/index.d.ts.map +1 -1
  228. package/dist/index.d.ts +8 -6
  229. package/dist/index.d.ts.map +1 -1
  230. package/dist/index.js +2 -1
  231. package/dist/index.js.map +1 -1
  232. package/dist/internal/crypto/ec/x25519-validation.d.ts +0 -1
  233. package/dist/internal/crypto/ec/x25519-validation.d.ts.map +1 -1
  234. package/dist/internal/crypto/ec/x25519-validation.js +0 -1
  235. package/dist/internal/crypto/ec/x25519-validation.js.map +1 -1
  236. package/dist/internal/crypto/validation.d.ts +2 -2
  237. package/dist/internal/groups/index.d.ts +1 -0
  238. package/dist/internal/groups/index.d.ts.map +1 -1
  239. package/dist/internal/groups/index.js +1 -0
  240. package/dist/internal/groups/index.js.map +1 -1
  241. package/dist/internal/groups/manager.d.ts +37 -16
  242. package/dist/internal/groups/manager.d.ts.map +1 -1
  243. package/dist/internal/groups/manager.js +46 -1
  244. package/dist/internal/groups/manager.js.map +1 -1
  245. package/dist/internal/groups/receive-record.d.ts +78 -0
  246. package/dist/internal/groups/receive-record.d.ts.map +1 -0
  247. package/dist/internal/groups/receive-record.js +43 -0
  248. package/dist/internal/groups/receive-record.js.map +1 -0
  249. package/dist/internal/groups/sdk-store.d.ts +27 -3
  250. package/dist/internal/groups/sdk-store.d.ts.map +1 -1
  251. package/dist/internal/groups/sdk-store.js +151 -19
  252. package/dist/internal/groups/sdk-store.js.map +1 -1
  253. package/dist/internal/groups/wire.d.ts +12 -1
  254. package/dist/internal/groups/wire.d.ts.map +1 -1
  255. package/dist/internal/groups/wire.js +36 -0
  256. package/dist/internal/groups/wire.js.map +1 -1
  257. package/dist/internal/manager/index.d.ts +1 -1
  258. package/dist/internal/manager/manager.d.ts +20 -19
  259. package/dist/internal/manager/manager.d.ts.map +1 -1
  260. package/dist/internal/manager/manager.js +56 -39
  261. package/dist/internal/manager/manager.js.map +1 -1
  262. package/dist/internal/protocol/double-ratchet/chains.d.ts +4 -18
  263. package/dist/internal/protocol/double-ratchet/chains.d.ts.map +1 -1
  264. package/dist/internal/protocol/double-ratchet/chains.js +23 -74
  265. package/dist/internal/protocol/double-ratchet/chains.js.map +1 -1
  266. package/dist/internal/protocol/double-ratchet/index.d.ts +1 -1
  267. package/dist/internal/protocol/double-ratchet/index.d.ts.map +1 -1
  268. package/dist/internal/protocol/double-ratchet/index.js +1 -1
  269. package/dist/internal/protocol/double-ratchet/index.js.map +1 -1
  270. package/dist/internal/protocol/double-ratchet/ratchet.d.ts +5 -7
  271. package/dist/internal/protocol/double-ratchet/ratchet.d.ts.map +1 -1
  272. package/dist/internal/protocol/double-ratchet/ratchet.js +4 -6
  273. package/dist/internal/protocol/double-ratchet/ratchet.js.map +1 -1
  274. package/dist/internal/protocol/pqxdh/pqxdh.d.ts.map +1 -1
  275. package/dist/internal/protocol/pqxdh/pqxdh.js +2 -1
  276. package/dist/internal/protocol/pqxdh/pqxdh.js.map +1 -1
  277. package/dist/internal/protocol/sealed-sender/types.d.ts +6 -8
  278. package/dist/internal/protocol/sealed-sender/types.d.ts.map +1 -1
  279. package/dist/internal/protocol/sealed-sender/types.js +8 -9
  280. package/dist/internal/protocol/sealed-sender/types.js.map +1 -1
  281. package/dist/internal/protocol/sender-keys/handoff-ledger.d.ts +110 -0
  282. package/dist/internal/protocol/sender-keys/handoff-ledger.d.ts.map +1 -0
  283. package/dist/internal/protocol/sender-keys/handoff-ledger.js +124 -0
  284. package/dist/internal/protocol/sender-keys/handoff-ledger.js.map +1 -0
  285. package/dist/internal/protocol/sender-keys/manager.d.ts +71 -62
  286. package/dist/internal/protocol/sender-keys/manager.d.ts.map +1 -1
  287. package/dist/internal/protocol/sender-keys/manager.js +228 -175
  288. package/dist/internal/protocol/sender-keys/manager.js.map +1 -1
  289. package/dist/internal/protocol/spqr/index.d.ts +2 -2
  290. package/dist/internal/protocol/spqr/index.d.ts.map +1 -1
  291. package/dist/internal/protocol/spqr/index.js +2 -2
  292. package/dist/internal/protocol/spqr/index.js.map +1 -1
  293. package/dist/internal/protocol/spqr/serialize.d.ts +9 -1
  294. package/dist/internal/protocol/spqr/serialize.d.ts.map +1 -1
  295. package/dist/internal/protocol/spqr/serialize.js +56 -16
  296. package/dist/internal/protocol/spqr/serialize.js.map +1 -1
  297. package/dist/internal/protocol/spqr/spqr.d.ts +1 -14
  298. package/dist/internal/protocol/spqr/spqr.d.ts.map +1 -1
  299. package/dist/internal/protocol/spqr/spqr.js +54 -42
  300. package/dist/internal/protocol/spqr/spqr.js.map +1 -1
  301. package/dist/internal/protocol/spqr/validate.d.ts +26 -6
  302. package/dist/internal/protocol/spqr/validate.d.ts.map +1 -1
  303. package/dist/internal/protocol/spqr/validate.js +49 -21
  304. package/dist/internal/protocol/spqr/validate.js.map +1 -1
  305. package/dist/internal/sesame/index.d.ts +1 -1
  306. package/dist/internal/sesame/index.d.ts.map +1 -1
  307. package/dist/internal/sesame/index.js.map +1 -1
  308. package/dist/internal/sesame/manager.d.ts +66 -13
  309. package/dist/internal/sesame/manager.d.ts.map +1 -1
  310. package/dist/internal/sesame/manager.js +221 -87
  311. package/dist/internal/sesame/manager.js.map +1 -1
  312. package/dist/internal/sesame/types.d.ts +95 -17
  313. package/dist/internal/sesame/types.d.ts.map +1 -1
  314. package/dist/internal/sesame/types.js +17 -0
  315. package/dist/internal/sesame/types.js.map +1 -1
  316. package/dist/internal/session/builder.d.ts +5 -5
  317. package/dist/internal/session/builder.d.ts.map +1 -1
  318. package/dist/internal/session/builder.js +12 -17
  319. package/dist/internal/session/builder.js.map +1 -1
  320. package/dist/internal/session/cipher.d.ts +13 -11
  321. package/dist/internal/session/cipher.d.ts.map +1 -1
  322. package/dist/internal/session/cipher.js +40 -22
  323. package/dist/internal/session/cipher.js.map +1 -1
  324. package/dist/internal/session/factory.d.ts +5 -5
  325. package/dist/internal/session/factory.d.ts.map +1 -1
  326. package/dist/internal/session/factory.js +4 -4
  327. package/dist/internal/session/factory.js.map +1 -1
  328. package/dist/internal/session/handshake.d.ts +14 -16
  329. package/dist/internal/session/handshake.d.ts.map +1 -1
  330. package/dist/internal/session/handshake.js +18 -75
  331. package/dist/internal/session/handshake.js.map +1 -1
  332. package/dist/internal/session/index.d.ts +1 -1
  333. package/dist/internal/session/index.js +1 -1
  334. package/dist/internal/session/record-locks.d.ts +17 -6
  335. package/dist/internal/session/record-locks.d.ts.map +1 -1
  336. package/dist/internal/session/record-locks.js +43 -7
  337. package/dist/internal/session/record-locks.js.map +1 -1
  338. package/dist/internal/session/session-resolver.d.ts +1 -1
  339. package/dist/internal/session/session-resolver.js +1 -1
  340. package/dist/internal/session/state.d.ts +2 -2
  341. package/dist/internal/session/state.js +1 -1
  342. package/dist/internal/session/types.d.ts +4 -12
  343. package/dist/internal/session/types.d.ts.map +1 -1
  344. package/dist/internal/session/types.js +1 -1
  345. package/dist/keys/generation.d.ts +2 -2
  346. package/dist/keys/generation.js +2 -2
  347. package/dist/keys/types.d.ts +5 -5
  348. package/dist/keys/types.d.ts.map +1 -1
  349. package/dist/keys/types.js +1 -1
  350. package/dist/layers.d.ts +1 -1
  351. package/dist/layers.js +2 -2
  352. package/dist/layers.js.map +1 -1
  353. package/dist/local/store/expo/adapter.d.ts.map +1 -1
  354. package/dist/local/store/expo/adapter.js +12 -8
  355. package/dist/local/store/expo/adapter.js.map +1 -1
  356. package/dist/local/store/key-value/adapter.d.ts +76 -10
  357. package/dist/local/store/key-value/adapter.d.ts.map +1 -1
  358. package/dist/local/store/key-value/adapter.js +367 -61
  359. package/dist/local/store/key-value/adapter.js.map +1 -1
  360. package/dist/local/store/key-value/backend-conformance.d.ts.map +1 -1
  361. package/dist/local/store/key-value/backend-conformance.js +74 -0
  362. package/dist/local/store/key-value/backend-conformance.js.map +1 -1
  363. package/dist/local/store/key-value/batch.d.ts +2 -0
  364. package/dist/local/store/key-value/batch.d.ts.map +1 -1
  365. package/dist/local/store/key-value/batch.js +26 -0
  366. package/dist/local/store/key-value/batch.js.map +1 -1
  367. package/dist/local/store/key-value/receive-work.d.ts +55 -0
  368. package/dist/local/store/key-value/receive-work.d.ts.map +1 -0
  369. package/dist/local/store/key-value/receive-work.js +162 -0
  370. package/dist/local/store/key-value/receive-work.js.map +1 -0
  371. package/dist/local/store/key-value/send-log.d.ts +61 -0
  372. package/dist/local/store/key-value/send-log.d.ts.map +1 -0
  373. package/dist/local/store/key-value/send-log.js +430 -0
  374. package/dist/local/store/key-value/send-log.js.map +1 -0
  375. package/dist/local/store/key-value/sender-key-handoff.d.ts +68 -0
  376. package/dist/local/store/key-value/sender-key-handoff.d.ts.map +1 -0
  377. package/dist/local/store/key-value/sender-key-handoff.js +189 -0
  378. package/dist/local/store/key-value/sender-key-handoff.js.map +1 -0
  379. package/dist/local/store/key-value/storage.d.ts +15 -0
  380. package/dist/local/store/key-value/storage.d.ts.map +1 -1
  381. package/dist/local/store/keyed-index.d.ts +23 -0
  382. package/dist/local/store/keyed-index.d.ts.map +1 -0
  383. package/dist/local/store/keyed-index.js +41 -0
  384. package/dist/local/store/keyed-index.js.map +1 -0
  385. package/dist/local/store/memory/adapter.d.ts +44 -12
  386. package/dist/local/store/memory/adapter.d.ts.map +1 -1
  387. package/dist/local/store/memory/adapter.js +197 -46
  388. package/dist/local/store/memory/adapter.js.map +1 -1
  389. package/dist/local/store/memory/send-log.d.ts +42 -0
  390. package/dist/local/store/memory/send-log.d.ts.map +1 -0
  391. package/dist/local/store/memory/send-log.js +190 -0
  392. package/dist/local/store/memory/send-log.js.map +1 -0
  393. package/dist/local/store/node/adapter.d.ts.map +1 -1
  394. package/dist/local/store/node/adapter.js +8 -6
  395. package/dist/local/store/node/adapter.js.map +1 -1
  396. package/dist/local/store/react-native/adapter.d.ts.map +1 -1
  397. package/dist/local/store/react-native/adapter.js +12 -8
  398. package/dist/local/store/react-native/adapter.js.map +1 -1
  399. package/dist/local/store/receive-work.d.ts +87 -0
  400. package/dist/local/store/receive-work.d.ts.map +1 -0
  401. package/dist/local/store/receive-work.js +204 -0
  402. package/dist/local/store/receive-work.js.map +1 -0
  403. package/dist/local/store/received-content.d.ts +3 -3
  404. package/dist/local/store/received-content.d.ts.map +1 -1
  405. package/dist/local/store/received-content.js +2 -11
  406. package/dist/local/store/received-content.js.map +1 -1
  407. package/dist/local/store/reliability.d.ts +411 -14
  408. package/dist/local/store/reliability.d.ts.map +1 -1
  409. package/dist/local/store/reliability.js +532 -58
  410. package/dist/local/store/reliability.js.map +1 -1
  411. package/dist/local/store/send-log-order.d.ts +15 -0
  412. package/dist/local/store/send-log-order.d.ts.map +1 -0
  413. package/dist/local/store/send-log-order.js +24 -0
  414. package/dist/local/store/send-log-order.js.map +1 -0
  415. package/dist/local/store/sender-key-handoff-index.d.ts +38 -0
  416. package/dist/local/store/sender-key-handoff-index.d.ts.map +1 -0
  417. package/dist/local/store/sender-key-handoff-index.js +101 -0
  418. package/dist/local/store/sender-key-handoff-index.js.map +1 -0
  419. package/dist/local/store/sender-key-handoff-table.d.ts +29 -0
  420. package/dist/local/store/sender-key-handoff-table.d.ts.map +1 -0
  421. package/dist/local/store/sender-key-handoff-table.js +97 -0
  422. package/dist/local/store/sender-key-handoff-table.js.map +1 -0
  423. package/dist/local/store/sqlite/encryption.d.ts +8 -1
  424. package/dist/local/store/sqlite/encryption.d.ts.map +1 -1
  425. package/dist/local/store/sqlite/encryption.js +9 -0
  426. package/dist/local/store/sqlite/encryption.js.map +1 -1
  427. package/dist/local/store/sqlite/key-storage/index.d.ts +25 -4
  428. package/dist/local/store/sqlite/key-storage/index.d.ts.map +1 -1
  429. package/dist/local/store/sqlite/key-storage/index.js +68 -7
  430. package/dist/local/store/sqlite/key-storage/index.js.map +1 -1
  431. package/dist/local/store/sqlite/key-storage/message-records.d.ts +16 -4
  432. package/dist/local/store/sqlite/key-storage/message-records.d.ts.map +1 -1
  433. package/dist/local/store/sqlite/key-storage/message-records.js +49 -6
  434. package/dist/local/store/sqlite/key-storage/message-records.js.map +1 -1
  435. package/dist/local/store/sqlite/key-storage/metadata.d.ts +8 -7
  436. package/dist/local/store/sqlite/key-storage/metadata.d.ts.map +1 -1
  437. package/dist/local/store/sqlite/key-storage/metadata.js +17 -15
  438. package/dist/local/store/sqlite/key-storage/metadata.js.map +1 -1
  439. package/dist/local/store/sqlite/key-storage/receive-work.d.ts +27 -0
  440. package/dist/local/store/sqlite/key-storage/receive-work.d.ts.map +1 -0
  441. package/dist/local/store/sqlite/key-storage/receive-work.js +98 -0
  442. package/dist/local/store/sqlite/key-storage/receive-work.js.map +1 -0
  443. package/dist/local/store/sqlite/key-storage/send-log.d.ts +27 -0
  444. package/dist/local/store/sqlite/key-storage/send-log.d.ts.map +1 -0
  445. package/dist/local/store/sqlite/key-storage/send-log.js +178 -0
  446. package/dist/local/store/sqlite/key-storage/send-log.js.map +1 -0
  447. package/dist/local/store/sqlite/key-storage/sender-key-handoff.d.ts +27 -0
  448. package/dist/local/store/sqlite/key-storage/sender-key-handoff.d.ts.map +1 -0
  449. package/dist/local/store/sqlite/key-storage/sender-key-handoff.js +75 -0
  450. package/dist/local/store/sqlite/key-storage/sender-key-handoff.js.map +1 -0
  451. package/dist/local/store/sqlite/key-storage/session-trust.d.ts +2 -2
  452. package/dist/local/store/sqlite/key-storage/session-trust.js +5 -5
  453. package/dist/local/store/sqlite/key-storage/session-trust.js.map +1 -1
  454. package/dist/local/store/sqlite/migrations.d.ts.map +1 -1
  455. package/dist/local/store/sqlite/migrations.js +101 -0
  456. package/dist/local/store/sqlite/migrations.js.map +1 -1
  457. package/dist/local/store/sqlite/models/index.d.ts +2 -1
  458. package/dist/local/store/sqlite/models/index.d.ts.map +1 -1
  459. package/dist/local/store/sqlite/models/index.js +5 -1
  460. package/dist/local/store/sqlite/models/index.js.map +1 -1
  461. package/dist/local/store/sqlite/models/message-record.d.ts +15 -0
  462. package/dist/local/store/sqlite/models/message-record.d.ts.map +1 -1
  463. package/dist/local/store/sqlite/models/message-record.js +24 -0
  464. package/dist/local/store/sqlite/models/message-record.js.map +1 -1
  465. package/dist/local/store/sqlite/models/send-log.d.ts +51 -0
  466. package/dist/local/store/sqlite/models/send-log.d.ts.map +1 -0
  467. package/dist/local/store/sqlite/models/send-log.js +206 -0
  468. package/dist/local/store/sqlite/models/send-log.js.map +1 -0
  469. package/dist/local/store/sqlite/open-store.d.ts +9 -1
  470. package/dist/local/store/sqlite/open-store.d.ts.map +1 -1
  471. package/dist/local/store/sqlite/open-store.js +20 -1
  472. package/dist/local/store/sqlite/open-store.js.map +1 -1
  473. package/dist/local/store/sqlite/schema.d.ts +34 -1
  474. package/dist/local/store/sqlite/schema.d.ts.map +1 -1
  475. package/dist/local/store/sqlite/schema.js +14 -0
  476. package/dist/local/store/sqlite/schema.js.map +1 -1
  477. package/dist/local/store/sqlite/store.d.ts +61 -11
  478. package/dist/local/store/sqlite/store.d.ts.map +1 -1
  479. package/dist/local/store/sqlite/store.js +191 -27
  480. package/dist/local/store/sqlite/store.js.map +1 -1
  481. package/dist/local/store/web/adapter.d.ts +76 -8
  482. package/dist/local/store/web/adapter.d.ts.map +1 -1
  483. package/dist/local/store/web/adapter.js +579 -127
  484. package/dist/local/store/web/adapter.js.map +1 -1
  485. package/dist/local/store/web/receive-work.d.ts +57 -0
  486. package/dist/local/store/web/receive-work.d.ts.map +1 -0
  487. package/dist/local/store/web/receive-work.js +99 -0
  488. package/dist/local/store/web/receive-work.js.map +1 -0
  489. package/dist/local/store/web/send-log.d.ts +92 -0
  490. package/dist/local/store/web/send-log.d.ts.map +1 -0
  491. package/dist/local/store/web/send-log.js +267 -0
  492. package/dist/local/store/web/send-log.js.map +1 -0
  493. package/dist/local/store/web/sender-key-handoff.d.ts +81 -0
  494. package/dist/local/store/web/sender-key-handoff.d.ts.map +1 -0
  495. package/dist/local/store/web/sender-key-handoff.js +156 -0
  496. package/dist/local/store/web/sender-key-handoff.js.map +1 -0
  497. package/dist/local/store/web-sqlite/adapter.d.ts +2 -0
  498. package/dist/local/store/web-sqlite/adapter.d.ts.map +1 -1
  499. package/dist/local/store/web-sqlite/adapter.js +12 -6
  500. package/dist/local/store/web-sqlite/adapter.js.map +1 -1
  501. package/dist/local/vault/custody.d.ts +8 -0
  502. package/dist/local/vault/custody.d.ts.map +1 -0
  503. package/dist/local/vault/custody.js +9 -0
  504. package/dist/local/vault/custody.js.map +1 -0
  505. package/dist/local/vault/electron-safe-storage.d.ts +3 -1
  506. package/dist/local/vault/electron-safe-storage.d.ts.map +1 -1
  507. package/dist/local/vault/electron-safe-storage.js +2 -0
  508. package/dist/local/vault/electron-safe-storage.js.map +1 -1
  509. package/dist/local/vault/expo-secure-store.d.ts +3 -1
  510. package/dist/local/vault/expo-secure-store.d.ts.map +1 -1
  511. package/dist/local/vault/expo-secure-store.js +2 -0
  512. package/dist/local/vault/expo-secure-store.js.map +1 -1
  513. package/dist/local/vault/indexed-db.d.ts +3 -1
  514. package/dist/local/vault/indexed-db.d.ts.map +1 -1
  515. package/dist/local/vault/indexed-db.js +2 -0
  516. package/dist/local/vault/indexed-db.js.map +1 -1
  517. package/dist/local/vault/react-native-keychain.d.ts +3 -1
  518. package/dist/local/vault/react-native-keychain.d.ts.map +1 -1
  519. package/dist/local/vault/react-native-keychain.js +2 -0
  520. package/dist/local/vault/react-native-keychain.js.map +1 -1
  521. package/dist/remote/relay/device-set.d.ts +94 -0
  522. package/dist/remote/relay/device-set.d.ts.map +1 -0
  523. package/dist/remote/relay/device-set.js +156 -0
  524. package/dist/remote/relay/device-set.js.map +1 -0
  525. package/dist/remote/relay/types.d.ts +104 -110
  526. package/dist/remote/relay/types.d.ts.map +1 -1
  527. package/dist/safety/core.d.ts +15 -6
  528. package/dist/safety/core.d.ts.map +1 -1
  529. package/dist/safety/core.js +41 -27
  530. package/dist/safety/core.js.map +1 -1
  531. package/dist/safety/index.d.ts +2 -1
  532. package/dist/safety/index.d.ts.map +1 -1
  533. package/dist/safety/index.js +12 -18
  534. package/dist/safety/index.js.map +1 -1
  535. package/dist/types/api.d.ts +707 -62
  536. package/dist/types/api.d.ts.map +1 -1
  537. package/dist/types/errors.d.ts +14 -33
  538. package/dist/types/errors.d.ts.map +1 -1
  539. package/dist/types/errors.js +14 -24
  540. package/dist/types/errors.js.map +1 -1
  541. package/dist/types/messages.d.ts +2 -2
  542. package/dist/types/messages.js +1 -1
  543. package/dist/types/protocol-config.d.ts +175 -42
  544. package/dist/types/protocol-config.d.ts.map +1 -1
  545. package/dist/types/protocol-config.js +19 -38
  546. package/dist/types/protocol-config.js.map +1 -1
  547. package/dist/types/protocol-constants.d.ts +6 -6
  548. package/dist/types/protocol-constants.js +6 -6
  549. package/dist/types/session.d.ts +7 -7
  550. package/dist/types/session.d.ts.map +1 -1
  551. package/dist/types/session.js +39 -21
  552. package/dist/types/session.js.map +1 -1
  553. package/dist/username/link.d.ts +2 -2
  554. package/dist/username/link.js +2 -2
  555. package/dist/utils/origin-lock.d.ts +45 -0
  556. package/dist/utils/origin-lock.d.ts.map +1 -0
  557. package/dist/utils/origin-lock.js +80 -0
  558. package/dist/utils/origin-lock.js.map +1 -0
  559. package/dist/utils/retry.d.ts +2 -0
  560. package/dist/utils/retry.d.ts.map +1 -1
  561. package/dist/utils/retry.js +7 -0
  562. package/dist/utils/retry.js.map +1 -1
  563. package/docs/ASSURANCE.md +6 -6
  564. package/docs/CLIENT_COMPOSITION.md +2 -2
  565. package/docs/DEVIATIONS.md +677 -182
  566. package/docs/E2EE.md +1 -1
  567. package/docs/ERROR_HANDLING.md +235 -2
  568. package/docs/GETTING_STARTED.md +7 -4
  569. package/docs/INTERFACES.md +1 -1
  570. package/docs/PACKAGE_SURFACE.md +6 -5
  571. package/docs/PROTOCOL_POLICY.md +102 -22
  572. package/docs/RECIPES.md +3 -15
  573. package/docs/SECURITY.md +90 -5
  574. package/keys/README.md +3 -3
  575. package/local/store/README.md +78 -14
  576. package/local/store/key-value/README.md +14 -3
  577. package/local/store/node/README.md +8 -3
  578. package/local/store/web/README.md +9 -0
  579. package/local/store/web-sqlite/README.md +14 -2
  580. package/local/vault/README.md +21 -0
  581. package/package.json +1 -6
  582. package/remote/README.md +0 -1
  583. package/remote/relay/README.md +2 -2
  584. package/dist/device/provisioning.d.ts +0 -242
  585. package/dist/device/provisioning.d.ts.map +0 -1
  586. package/dist/device/provisioning.js +0 -421
  587. package/dist/device/provisioning.js.map +0 -1
  588. package/dist/internal/protocol/x3dh/index.d.ts +0 -15
  589. package/dist/internal/protocol/x3dh/index.d.ts.map +0 -1
  590. package/dist/internal/protocol/x3dh/index.js +0 -13
  591. package/dist/internal/protocol/x3dh/index.js.map +0 -1
  592. package/dist/internal/protocol/x3dh/x3dh.d.ts +0 -131
  593. package/dist/internal/protocol/x3dh/x3dh.d.ts.map +0 -1
  594. package/dist/internal/protocol/x3dh/x3dh.js +0 -261
  595. package/dist/internal/protocol/x3dh/x3dh.js.map +0 -1
@@ -0,0 +1,98 @@
1
+ /**
2
+ * Resendable content and its retention.
3
+ *
4
+ * A sender keeps the plaintext of a resendable message to answer a retry
5
+ * request: each group send in the send log, and each pairwise message in a
6
+ * MessageRecord. The retention runs from the store clock when the store
7
+ * first wrote the content, and a retry never extends it. This module
8
+ * enforces the retention at each send log lookup and at each sweep. A sweep
9
+ * runs at client creation, at stop, and before the first resendable group
10
+ * send of each day.
11
+ *
12
+ * When content recovery is off, the client keeps no resendable content, and
13
+ * the start of each client clears the content that an earlier policy kept.
14
+ * A metadata marker records the clear, so a start with nothing kept since
15
+ * the last clear reads one value and scans nothing.
16
+ *
17
+ * An E2EE delivery receipt from a device deletes its row (see
18
+ * `DeliveryStatusTracker`). A Relay delivery receipt deletes nothing, because
19
+ * a device also acknowledges a copy that it could not decrypt.
20
+ *
21
+ * Deletion in an encrypted store is logical. The retention bounds the time
22
+ * that the client keeps the content. It does not promise erasure from the
23
+ * storage medium.
24
+ *
25
+ * @internal
26
+ */
27
+ /**
28
+ * The metadata key that records a clear of all resendable content. Its
29
+ * presence means the store kept no resendable content since that clear.
30
+ */
31
+ export declare const RESENDABLE_CONTENT_CLEARED_MARKER = "resendable-content:cleared";
32
+ type ResendableContentStore = Pick<SignalProtocolLocalStore, 'getMetadata' | 'setMetadata' | 'deleteMetadata' | 'clearAllMessageRecords' | 'clearSendLog' | 'deleteExpiredSendLog' | 'deleteExpiredMessageRecords' | 'getSendLogEntry' | 'findSendLogEntries' | 'getSendLogRecipients' | 'deleteSendLogEntry' | 'incrementSendLogResendCount'>;
33
+ /** The number of entries and records that one sweep deleted. */
34
+ export interface ResendableContentSweep {
35
+ readonly sendLogEntries: number;
36
+ readonly messageRecords: number;
37
+ }
38
+ export declare class ResendableContent {
39
+ private readonly store;
40
+ /** The retention of the content, from `protocol.contentRecovery`. */
41
+ readonly retentionMs: number;
42
+ private readonly now;
43
+ /** The day of the last sweep, in whole days since the epoch. */
44
+ private sweptDay;
45
+ constructor(store: ResendableContentStore,
46
+ /** The retention of the content, from `protocol.contentRecovery`. */
47
+ retentionMs: number, now?: () => number);
48
+ /** True when content that the store wrote at `createdAt` is past the retention. */
49
+ isExpired(createdAt: number): boolean;
50
+ /** Delete each send log entry and each message record past the retention. */
51
+ sweep(): Promise<ResendableContentSweep>;
52
+ /**
53
+ * Sweep when no sweep ran today. A long-running client that never stops
54
+ * still deletes expired content each day that it sends.
55
+ */
56
+ sweepDaily(): Promise<ResendableContentSweep | null>;
57
+ /**
58
+ * The logged entries that a retry request from one device names, after
59
+ * expired entries are deleted. The first message ID with a row for the
60
+ * device wins. With none, every entry of the device at the client
61
+ * timestamp answers, ordered by `clientMessageId`. Only the row of this
62
+ * exact device authorizes a resend.
63
+ */
64
+ lookup(device: SendLogDevice, clientMessageIds: readonly (string | undefined)[], clientTimestamp: number): Promise<SendLogEntry[]>;
65
+ /**
66
+ * The logged entry of one send and the row of one device, after expired
67
+ * entries are deleted, or null when the device has no row.
68
+ */
69
+ entry(clientMessageId: string, device: SendLogDevice): Promise<SendLogEntry | null>;
70
+ /**
71
+ * Count one resend of a logged send to one device. The count survives a
72
+ * restart. Returns the new count, or null when the device has no row.
73
+ */
74
+ countResend(clientMessageId: string, device: SendLogDevice): Promise<number | null>;
75
+ /**
76
+ * The devices that have not confirmed a logged send with an E2EE delivery
77
+ * receipt, after expired entries are deleted.
78
+ */
79
+ pendingRecipients(clientMessageId: string): Promise<SendLogDevice[]>;
80
+ /**
81
+ * Delete all resendable content, for a client with content recovery off.
82
+ * The clear is skipped when the store kept no content since the last
83
+ * clear. The marker is written only after the clear succeeds, and a
84
+ * failure propagates.
85
+ *
86
+ * @returns The deleted entries and records, or null for a skipped clear
87
+ */
88
+ clear(): Promise<ResendableContentSweep | null>;
89
+ /**
90
+ * Record that the client can keep resendable content, so the next clear
91
+ * runs. Call it before the client writes any content.
92
+ */
93
+ keepContent(): Promise<void>;
94
+ /** Delete the logged content of one send and its rows. */
95
+ forget(clientMessageId: string): Promise<boolean>;
96
+ }
97
+ export {};
98
+ //# sourceMappingURL=resendable-content.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resendable-content.d.ts","sourceRoot":"","sources":["../../client/resendable-content.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAUH;;;GAGG;AACH,eAAO,MAAM,iCAAiC,+BAA+B,CAAC;AAE9E,KAAK,sBAAsB,GAAG,IAAI,CAChC,wBAAwB,EACtB,aAAa,GACb,aAAa,GACb,gBAAgB,GAChB,wBAAwB,GACxB,cAAc,GACd,sBAAsB,GACtB,6BAA6B,GAC7B,iBAAiB,GACjB,oBAAoB,GACpB,sBAAsB,GACtB,oBAAoB,GACpB,6BAA6B,CAChC,CAAC;AAEF,gEAAgE;AAChE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,qBAAa,iBAAiB;IAK1B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,qEAAqE;aACrD,WAAW,EAAE,MAAM;IACnC,OAAO,CAAC,QAAQ,CAAC,GAAG;IAPtB,gEAAgE;IAChE,OAAO,CAAC,QAAQ,CAAqB;IAErC,YACmB,KAAK,EAAE,sBAAsB;IAC9C,qEAAqE;IACrD,WAAW,EAAE,MAAM,EAClB,GAAG,GAAE,MAAM,MAAiB,EAC3C;IAEJ,mFAAmF;IAC5E,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE3C;IAED,6EAA6E;IAChE,KAAK,IAAI,OAAO,CAAC,sBAAsB,CAAC,CAKpD;IAED;;;OAGG;IACU,UAAU,IAAI,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAEhE;IAED;;;;;;OAMG;IACU,MAAM,CACjB,MAAM,EAAE,aAAa,EACrB,gBAAgB,EAAE,SAAS,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,EACjD,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,YAAY,EAAE,CAAC,CAQzB;IAED;;;OAGG;IACU,KAAK,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAG/F;IAED;;;OAGG;IACU,WAAW,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAE/F;IAED;;;OAGG;IACU,iBAAiB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAMhF;IAED;;;;;;;OAOG;IACU,KAAK,IAAI,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAM3D;IAED;;;OAGG;IACU,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAExC;IAED,0DAA0D;IAC7C,MAAM,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE7D;CACF"}
@@ -0,0 +1,136 @@
1
+ /**
2
+ * Resendable content and its retention.
3
+ *
4
+ * A sender keeps the plaintext of a resendable message to answer a retry
5
+ * request: each group send in the send log, and each pairwise message in a
6
+ * MessageRecord. The retention runs from the store clock when the store
7
+ * first wrote the content, and a retry never extends it. This module
8
+ * enforces the retention at each send log lookup and at each sweep. A sweep
9
+ * runs at client creation, at stop, and before the first resendable group
10
+ * send of each day.
11
+ *
12
+ * When content recovery is off, the client keeps no resendable content, and
13
+ * the start of each client clears the content that an earlier policy kept.
14
+ * A metadata marker records the clear, so a start with nothing kept since
15
+ * the last clear reads one value and scans nothing.
16
+ *
17
+ * An E2EE delivery receipt from a device deletes its row (see
18
+ * `DeliveryStatusTracker`). A Relay delivery receipt deletes nothing, because
19
+ * a device also acknowledges a copy that it could not decrypt.
20
+ *
21
+ * Deletion in an encrypted store is logical. The retention bounds the time
22
+ * that the client keeps the content. It does not promise erasure from the
23
+ * storage medium.
24
+ *
25
+ * @internal
26
+ */
27
+ const DAY_MS = 24 * 60 * 60 * 1_000;
28
+ /**
29
+ * The metadata key that records a clear of all resendable content. Its
30
+ * presence means the store kept no resendable content since that clear.
31
+ */
32
+ export const RESENDABLE_CONTENT_CLEARED_MARKER = 'resendable-content:cleared';
33
+ export class ResendableContent {
34
+ store;
35
+ retentionMs;
36
+ now;
37
+ /** The day of the last sweep, in whole days since the epoch. */
38
+ sweptDay;
39
+ constructor(store,
40
+ /** The retention of the content, from `protocol.contentRecovery`. */
41
+ retentionMs, now = Date.now) {
42
+ this.store = store;
43
+ this.retentionMs = retentionMs;
44
+ this.now = now;
45
+ }
46
+ /** True when content that the store wrote at `createdAt` is past the retention. */
47
+ isExpired(createdAt) {
48
+ return this.now() - createdAt > this.retentionMs;
49
+ }
50
+ /** Delete each send log entry and each message record past the retention. */
51
+ async sweep() {
52
+ this.sweptDay = Math.floor(this.now() / DAY_MS);
53
+ const sendLogEntries = await this.store.deleteExpiredSendLog(this.retentionMs);
54
+ const messageRecords = await this.store.deleteExpiredMessageRecords(this.retentionMs);
55
+ return { sendLogEntries, messageRecords };
56
+ }
57
+ /**
58
+ * Sweep when no sweep ran today. A long-running client that never stops
59
+ * still deletes expired content each day that it sends.
60
+ */
61
+ async sweepDaily() {
62
+ return this.sweptDay === Math.floor(this.now() / DAY_MS) ? null : this.sweep();
63
+ }
64
+ /**
65
+ * The logged entries that a retry request from one device names, after
66
+ * expired entries are deleted. The first message ID with a row for the
67
+ * device wins. With none, every entry of the device at the client
68
+ * timestamp answers, ordered by `clientMessageId`. Only the row of this
69
+ * exact device authorizes a resend.
70
+ */
71
+ async lookup(device, clientMessageIds, clientTimestamp) {
72
+ await this.store.deleteExpiredSendLog(this.retentionMs);
73
+ for (const clientMessageId of clientMessageIds) {
74
+ if (clientMessageId === undefined)
75
+ continue;
76
+ const entry = await this.store.getSendLogEntry(clientMessageId, device);
77
+ if (entry)
78
+ return [entry];
79
+ }
80
+ return this.store.findSendLogEntries(device, clientTimestamp);
81
+ }
82
+ /**
83
+ * The logged entry of one send and the row of one device, after expired
84
+ * entries are deleted, or null when the device has no row.
85
+ */
86
+ async entry(clientMessageId, device) {
87
+ await this.store.deleteExpiredSendLog(this.retentionMs);
88
+ return this.store.getSendLogEntry(clientMessageId, device);
89
+ }
90
+ /**
91
+ * Count one resend of a logged send to one device. The count survives a
92
+ * restart. Returns the new count, or null when the device has no row.
93
+ */
94
+ async countResend(clientMessageId, device) {
95
+ return this.store.incrementSendLogResendCount(clientMessageId, device);
96
+ }
97
+ /**
98
+ * The devices that have not confirmed a logged send with an E2EE delivery
99
+ * receipt, after expired entries are deleted.
100
+ */
101
+ async pendingRecipients(clientMessageId) {
102
+ await this.store.deleteExpiredSendLog(this.retentionMs);
103
+ return (await this.store.getSendLogRecipients(clientMessageId)).map(({ userId, deviceId }) => ({
104
+ userId,
105
+ deviceId,
106
+ }));
107
+ }
108
+ /**
109
+ * Delete all resendable content, for a client with content recovery off.
110
+ * The clear is skipped when the store kept no content since the last
111
+ * clear. The marker is written only after the clear succeeds, and a
112
+ * failure propagates.
113
+ *
114
+ * @returns The deleted entries and records, or null for a skipped clear
115
+ */
116
+ async clear() {
117
+ if ((await this.store.getMetadata(RESENDABLE_CONTENT_CLEARED_MARKER)) !== null)
118
+ return null;
119
+ const messageRecords = await this.store.clearAllMessageRecords();
120
+ const sendLogEntries = await this.store.clearSendLog();
121
+ await this.store.setMetadata(RESENDABLE_CONTENT_CLEARED_MARKER, String(this.now()));
122
+ return { sendLogEntries, messageRecords };
123
+ }
124
+ /**
125
+ * Record that the client can keep resendable content, so the next clear
126
+ * runs. Call it before the client writes any content.
127
+ */
128
+ async keepContent() {
129
+ await this.store.deleteMetadata(RESENDABLE_CONTENT_CLEARED_MARKER);
130
+ }
131
+ /** Delete the logged content of one send and its rows. */
132
+ async forget(clientMessageId) {
133
+ return this.store.deleteSendLogEntry(clientMessageId);
134
+ }
135
+ }
136
+ //# sourceMappingURL=resendable-content.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resendable-content.js","sourceRoot":"","sources":["../../client/resendable-content.ts"],"names":[],"mappings":"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"}
@@ -12,6 +12,8 @@
12
12
  import type { Logger } from '../logger.js';
13
13
  import { withProcessedEnvelopeLock, type ResolvedRetryFamilyMember } from '../local/store/reliability.js';
14
14
  import type { RetryRequestFailure } from './retry-request-envelope.js';
15
+ import type { SignalProtocolClientHooks } from './event-hooks.js';
16
+ import type { RetryRequestOutcome } from './retry-request-lifecycle.js';
15
17
  type RetryFamilyStore = Parameters<typeof withProcessedEnvelopeLock>[0];
16
18
  /**
17
19
  * One received envelope in the retry family of its failed envelope. The
@@ -37,16 +39,56 @@ export interface RetryFamilyReceive {
37
39
  */
38
40
  admit(): Promise<boolean>;
39
41
  /**
40
- * Record a decrypt that succeeded. For a member, and for a failed
41
- * envelope with a request record, one write marks the failed envelope
42
- * processed and fulfilled. A redelivery of the failed envelope on either
43
- * path is then dropped, and so is each later member. When the write
44
- * fails, it writes one warning with the behavior
45
- * RETRY_FULFILL_WRITE_FAILED and returns, so the caller continues as for
46
- * any decrypted envelope. A redelivery of the failed envelope or of
47
- * another member can then give the content again.
42
+ * Tell which failed envelope a decrypt with this content fulfills: the
43
+ * failed envelope of a member, or of a failed envelope with a request
44
+ * record. Undefined when `fulfill` writes nothing for it. The receive
45
+ * record of the content names the result as its `failedEnvelopeId`.
46
+ * Call it after `admit`.
47
+ */
48
+ fulfills(decrypted?: {
49
+ readonly senderKeyDistribution: boolean;
50
+ readonly content: boolean;
51
+ }): string | undefined;
52
+ /**
53
+ * Record a decrypt that succeeded: outcome 1. The receive path calls it
54
+ * right after the commit of the receive record, before the
55
+ * acknowledgment or the return. For a member, and for a failed envelope
56
+ * with a request record, one write marks the failed envelope processed
57
+ * and fulfilled. That write stops the retry scheduler for the failed
58
+ * envelope. A redelivery of the failed envelope on either path is then
59
+ * dropped, and so is each later member. When the write fails, the error
60
+ * propagates: the caller does not acknowledge the envelope, and its
61
+ * redelivery finds the committed receive record and writes again.
62
+ *
63
+ * The fulfilled write does not run `onDeliveryRecovered`. That hook waits
64
+ * for the completion of the receive record (outcome 2), as
65
+ * `reportDeliveryRecovered` tells.
66
+ *
67
+ * A failed group message whose sender key was missing has a request
68
+ * record with no group. When the decrypt that gives its content resolves
69
+ * the group, the record gets it before the fulfilled write, so
70
+ * `onDeliveryRecovered` names it. A record that names a group keeps it.
71
+ *
72
+ * A member that brings only a sender-key distribution, for a failed
73
+ * envelope that is a sender-key group message, writes nothing and does
74
+ * not fulfill the failed envelope. The member installs the sender key and
75
+ * gives no content. A redelivery of the failed envelope then decrypts
76
+ * with that key and gives its content, and a later member is admitted.
77
+ * One debug line records the behavior RETRY_SENDER_KEY_RESEND. A member
78
+ * that brings content beside the distribution fulfills the failed
79
+ * envelope, as any other member does.
80
+ *
81
+ * @param decrypted - The decrypted content. `senderKeyDistribution` is
82
+ * true when the content carries a sender-key distribution. `content` is
83
+ * true when it carries content other than a distribution. `groupId` is
84
+ * the group that the decrypt resolved for group content, in the form
85
+ * of `DecryptedEnvelope.conversationId`.
48
86
  */
49
- fulfill(): Promise<void>;
87
+ fulfill(decrypted?: {
88
+ readonly senderKeyDistribution: boolean;
89
+ readonly content: boolean;
90
+ readonly groupId?: string;
91
+ }): Promise<void>;
50
92
  /**
51
93
  * Record a decrypted null message, in place of `fulfill`. A null
52
94
  * message carries no content, so the caller never gives it to the
@@ -67,7 +109,7 @@ export interface RetryFamilyReceive {
67
109
  * names no sender, and the request record that `admit` read names the
68
110
  * device that the request went to. The result is that envelope with the
69
111
  * sender of the record. Any other envelope, and a member with an
70
- * identified sender or with no request record, is returned as it is.
112
+ * identified sender or with no request envelope, is returned as it is.
71
113
  */
72
114
  withRequestedSender<E extends {
73
115
  senderUserId: string;
@@ -81,15 +123,16 @@ export interface RetryFamilyReceive {
81
123
  * failed envelope does not apply to it.
82
124
  *
83
125
  * @param fingerprint - The fingerprint of the received envelope.
84
- * @param post - Posts the request for the given failure. It returns false
85
- * when it posts nothing, for example under the rate limit.
86
- * @returns True when `post` posted the request. After the post, a member
87
- * is processed, so a redelivery of it on either path posts nothing. A
88
- * failed post leaves it unprocessed. False with no post, and one warn
89
- * line with the behavior RETRY_REQUEST_ENVELOPE_CHANGED, when the relay
90
- * changed the failed envelope after its retry request.
126
+ * @param post - Posts the request for the given failure, and gives what
127
+ * it did.
128
+ * @returns The outcome of `post`. After a `posted` or `terminal` outcome,
129
+ * a member is processed, so a redelivery of it on either path posts
130
+ * nothing. Any other outcome leaves it unprocessed. `skipped` with no
131
+ * post, and one warn line with the behavior
132
+ * RETRY_REQUEST_ENVELOPE_CHANGED, when the relay changed the failed
133
+ * envelope after its retry request.
91
134
  */
92
- requestRetry(fingerprint: string | undefined, post: (failed: RetryRequestFailure) => Promise<boolean>): Promise<boolean>;
135
+ requestRetry(fingerprint: string | undefined, post: (failed: RetryRequestFailure) => Promise<RetryRequestOutcome>): Promise<RetryRequestOutcome>;
93
136
  }
94
137
  /**
95
138
  * Receive one envelope in the retry family of its failed envelope.
@@ -105,13 +148,19 @@ export interface RetryFamilyReceive {
105
148
  * The processed record and the acknowledgment use the delivered envelope
106
149
  * ID.
107
150
  *
151
+ * Under the lock and before the receive, it runs `onDeliveryRecovered` for
152
+ * a failed envelope whose recovery the hook did not mark. An error from
153
+ * that hook propagates, so the receive path does not acknowledge the
154
+ * envelope, and its redelivery runs the hook again.
155
+ *
108
156
  * @param storage - The local store that keeps the retry records.
109
157
  * @param logger - The client logger.
158
+ * @param hooks - The client hooks, for `onDeliveryRecovered`.
110
159
  * @param envelope - The IDs of the received envelope: the delivered
111
160
  * envelope ID, and the client message ID when the relay delivers one.
112
161
  * @param receive - The receive path. It runs under the lock.
113
162
  */
114
- export declare function receiveInRetryFamily<T>(storage: RetryFamilyStore, logger: Required<Logger>, envelope: {
163
+ export declare function receiveInRetryFamily<T>(storage: RetryFamilyStore, logger: Required<Logger>, hooks: SignalProtocolClientHooks | undefined, envelope: {
115
164
  readonly id?: string;
116
165
  readonly clientMessageId?: string;
117
166
  }, receive: (family: RetryFamilyReceive) => Promise<T>): Promise<T>;
@@ -1 +1 @@
1
- {"version":3,"file":"retry-family.d.ts","sourceRoot":"","sources":["../../client/retry-family.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAOL,yBAAyB,EACzB,KAAK,yBAAyB,EAE/B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,KAAK,gBAAgB,GAAG,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC,CAAC,CAAC,CAAC;AAExE;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,yBAAyB,GAAG,SAAS,CAAC;IACvD;;;;;;;;;OASG;IACH,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1B;;;;;;;;;OASG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB;;;;;;;;;;;;;OAaG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D;;;;;;OAMG;IACH,mBAAmB,CAAC,CAAC,SAAS;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,EAC5E,QAAQ,EAAE,CAAC,GACV,CAAC,CAAC;IACL;;;;;;;;;;;;;;;OAeG;IACH,YAAY,CACV,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,IAAI,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,OAAO,CAAC,OAAO,CAAC,GACtD,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,oBAAoB,CAAC,CAAC,EAC1C,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EACxB,QAAQ,EAAE;IAAE,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,EACrE,OAAO,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,OAAO,CAAC,CAAC,CAAC,GAClD,OAAO,CAAC,CAAC,CAAC,CAUZ"}
1
+ {"version":3,"file":"retry-family.d.ts","sourceRoot":"","sources":["../../client/retry-family.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAQL,yBAAyB,EACzB,KAAK,yBAAyB,EAE/B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAE/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE,KAAK,gBAAgB,GAAG,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC,CAAC,CAAC,CAAC;AAExE;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,yBAAyB,GAAG,SAAS,CAAC;IACvD;;;;;;;;;OASG;IACH,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1B;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE;QACnB,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;QACxC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;KAC3B,GAAG,MAAM,GAAG,SAAS,CAAC;IACvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACH,OAAO,CAAC,SAAS,CAAC,EAAE;QAClB,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;QACxC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;QAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;KAC3B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClB;;;;;;;;;;;;;OAaG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D;;;;;;OAMG;IACH,mBAAmB,CAAC,CAAC,SAAS;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,EAC5E,QAAQ,EAAE,CAAC,GACV,CAAC,CAAC;IACL;;;;;;;;;;;;;;;;OAgBG;IACH,YAAY,CACV,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,IAAI,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,OAAO,CAAC,mBAAmB,CAAC,GAClE,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,oBAAoB,CAAC,CAAC,EAC1C,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EACxB,KAAK,EAAE,yBAAyB,GAAG,SAAS,EAC5C,QAAQ,EAAE;IAAE,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,EACrE,OAAO,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,OAAO,CAAC,CAAC,CAAC,GAClD,OAAO,CAAC,CAAC,CAAC,CAgBZ"}
@@ -9,7 +9,8 @@
9
9
  * gets the content of one failed envelope at most once, from the envelope
10
10
  * itself or from one family member.
11
11
  */
12
- import { getProcessedEnvelope, getRetryRequest, markRetryRequestAnswered, resolveRetryFamilyMember, RetryRequestedEnvelopeChangedError, storeProcessedEnvelope, withProcessedEnvelopeLock, } from '../local/store/reliability.js';
12
+ import { getProcessedEnvelope, getRetryRequest, markRetryRequestAnswered, resolveRetryFamilyMember, RetryRequestedEnvelopeChangedError, storeProcessedEnvelope, updateRetryRequest, withProcessedEnvelopeLock, } from '../local/store/reliability.js';
13
+ import { reportDeliveryRecovered } from './delivery-error.js';
13
14
  /**
14
15
  * Receive one envelope in the retry family of its failed envelope.
15
16
  *
@@ -24,23 +25,35 @@ import { getProcessedEnvelope, getRetryRequest, markRetryRequestAnswered, resolv
24
25
  * The processed record and the acknowledgment use the delivered envelope
25
26
  * ID.
26
27
  *
28
+ * Under the lock and before the receive, it runs `onDeliveryRecovered` for
29
+ * a failed envelope whose recovery the hook did not mark. An error from
30
+ * that hook propagates, so the receive path does not acknowledge the
31
+ * envelope, and its redelivery runs the hook again.
32
+ *
27
33
  * @param storage - The local store that keeps the retry records.
28
34
  * @param logger - The client logger.
35
+ * @param hooks - The client hooks, for `onDeliveryRecovered`.
29
36
  * @param envelope - The IDs of the received envelope: the delivered
30
37
  * envelope ID, and the client message ID when the relay delivers one.
31
38
  * @param receive - The receive path. It runs under the lock.
32
39
  */
33
- export async function receiveInRetryFamily(storage, logger, envelope, receive) {
40
+ export async function receiveInRetryFamily(storage, logger, hooks, envelope, receive) {
34
41
  const envelopeId = envelope.id;
35
- if (!envelopeId)
42
+ if (!envelopeId) {
36
43
  return receive(retryFamilyReceive(storage, logger, undefined, undefined));
44
+ }
37
45
  const member = await resolveRetryFamilyMember(storage, envelope.clientMessageId ?? envelopeId);
38
- return withProcessedEnvelopeLock(storage, member?.failedEnvelopeId ?? envelopeId, () => receive(retryFamilyReceive(storage, logger, envelopeId, member)));
46
+ const failedEnvelopeId = member?.failedEnvelopeId ?? envelopeId;
47
+ return withProcessedEnvelopeLock(storage, failedEnvelopeId, async () => {
48
+ // A recovery whose hook did not return runs again. An error from the
49
+ // hook fails the receive, so the envelope is delivered again.
50
+ await reportDeliveryRecovered(storage, hooks, failedEnvelopeId);
51
+ return receive(retryFamilyReceive(storage, logger, envelopeId, member));
52
+ });
39
53
  }
40
54
  function retryFamilyReceive(storage, logger, envelopeId, member) {
41
55
  const failedEnvelopeId = member?.failedEnvelopeId ?? envelopeId;
42
- // The read comes before the decrypt, so only writes follow the
43
- // application hook.
56
+ // The read comes before the decrypt, so only writes follow the commit.
44
57
  let request = null;
45
58
  return {
46
59
  member,
@@ -75,18 +88,46 @@ function retryFamilyReceive(storage, logger, envelopeId, member) {
75
88
  request = await getRetryRequest(storage, failedEnvelopeId);
76
89
  return true;
77
90
  },
78
- async fulfill() {
91
+ fulfills(decrypted) {
92
+ if (member &&
93
+ request?.groupMessage &&
94
+ decrypted?.senderKeyDistribution &&
95
+ !decrypted.content) {
96
+ return undefined;
97
+ }
98
+ if (failedEnvelopeId === undefined || !(member || request))
99
+ return undefined;
100
+ return failedEnvelopeId;
101
+ },
102
+ async fulfill(decrypted) {
103
+ if (member &&
104
+ request?.groupMessage &&
105
+ decrypted?.senderKeyDistribution &&
106
+ !decrypted.content) {
107
+ logger.debug('A resend gave the sender key of a failed group message', {
108
+ category: 'E2EE',
109
+ data: { envelopeId, behavior: 'RETRY_SENDER_KEY_RESEND' },
110
+ });
111
+ return;
112
+ }
113
+ if (failedEnvelopeId === undefined || !(member || request))
114
+ return;
79
115
  try {
116
+ const groupId = decrypted?.groupId;
117
+ if (request && request.groupId === undefined && groupId !== undefined) {
118
+ request =
119
+ (await updateRetryRequest(storage, failedEnvelopeId, request.retryId, request.attempt, {
120
+ groupId,
121
+ })) ?? request;
122
+ }
80
123
  // One write marks the failed envelope processed and fulfilled. A
81
124
  // redelivery of it is then acknowledged with no decrypt, and each
82
125
  // later member of its request is dropped.
83
- if (failedEnvelopeId !== undefined && (member || request)) {
84
- await storeProcessedEnvelope(storage, failedEnvelopeId, Date.now(), undefined, true);
85
- }
126
+ await storeProcessedEnvelope(storage, failedEnvelopeId, Date.now(), undefined, true);
86
127
  }
87
128
  catch (error) {
88
- // The application gets the plaintext. Only a redelivery can
89
- // decrypt the content again.
129
+ // The receive record holds the content. The caller does not
130
+ // acknowledge, so the redelivery writes outcome 1 again.
90
131
  logger.warn('The retry family record of a decrypted envelope failed to store', {
91
132
  category: 'E2EE',
92
133
  data: {
@@ -95,6 +136,7 @@ function retryFamilyReceive(storage, logger, envelopeId, member) {
95
136
  error: error.message,
96
137
  },
97
138
  });
139
+ throw error;
98
140
  }
99
141
  },
100
142
  async consumeNull(fingerprint) {
@@ -120,7 +162,7 @@ function retryFamilyReceive(storage, logger, envelopeId, member) {
120
162
  }
121
163
  },
122
164
  withRequestedSender(envelope) {
123
- if (!member || !request)
165
+ if (!member || !request?.envelope)
124
166
  return envelope;
125
167
  if (envelope.senderUserId && envelope.senderDeviceId >= 1)
126
168
  return envelope;
@@ -143,7 +185,7 @@ function retryFamilyReceive(storage, logger, envelopeId, member) {
143
185
  category: 'E2EE',
144
186
  data: { envelopeId, behavior: 'RETRY_REQUEST_ENVELOPE_CHANGED' },
145
187
  });
146
- return false;
188
+ return 'skipped';
147
189
  }
148
190
  return post({
149
191
  id: failedEnvelopeId,
@@ -154,16 +196,16 @@ function retryFamilyReceive(storage, logger, envelopeId, member) {
154
196
  // A member has its own content, so its fingerprint is not the
155
197
  // fingerprint of the failed envelope.
156
198
  const stored = await getRetryRequest(storage, failedEnvelopeId);
157
- const posted = await post({
199
+ const outcome = await post({
158
200
  id: failedEnvelopeId,
159
201
  ...(stored?.fingerprint !== undefined && { fingerprint: stored.fingerprint }),
160
202
  stored,
161
203
  ...(envelopeId !== undefined && { member: envelopeId }),
162
204
  });
163
- if (posted && envelopeId) {
205
+ if ((outcome === 'posted' || outcome === 'terminal') && envelopeId) {
164
206
  await storeProcessedEnvelope(storage, envelopeId, Date.now(), fingerprint);
165
207
  }
166
- return posted;
208
+ return outcome;
167
209
  },
168
210
  };
169
211
  }
@@ -1 +1 @@
1
- {"version":3,"file":"retry-family.js","sourceRoot":"","sources":["../../client/retry-family.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"retry-family.js","sourceRoot":"","sources":["../../client/retry-family.ts"],"names":[],"mappings":"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"}