@open-e2ee/signal-protocol-sdk 11.0.0 → 12.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (590) hide show
  1. package/ADAPTERS.md +4 -4
  2. package/ARCHITECTURE.md +6 -8
  3. package/CHANGELOG.md +1348 -0
  4. package/README.md +1 -1
  5. package/SECURITY.md +2 -2
  6. package/TROUBLESHOOTING.md +8 -8
  7. package/client/README.md +70 -37
  8. package/device/README.md +39 -85
  9. package/dist/client/client.d.ts +334 -63
  10. package/dist/client/client.d.ts.map +1 -1
  11. package/dist/client/client.js +1175 -186
  12. package/dist/client/client.js.map +1 -1
  13. package/dist/client/config.d.ts +57 -42
  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 +280 -14
  42. package/dist/client/event-hooks.d.ts.map +1 -1
  43. package/dist/client/event-hooks.js +8 -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-mailbox-subscription.d.ts +34 -2
  82. package/dist/client/hosted-mailbox-subscription.d.ts.map +1 -1
  83. package/dist/client/hosted-mailbox-subscription.js +87 -17
  84. package/dist/client/hosted-mailbox-subscription.js.map +1 -1
  85. package/dist/client/hosted-push.d.ts +22 -4
  86. package/dist/client/hosted-push.d.ts.map +1 -1
  87. package/dist/client/hosted-push.js +75 -22
  88. package/dist/client/hosted-push.js.map +1 -1
  89. package/dist/client/hosted-transport.d.ts +22 -28
  90. package/dist/client/hosted-transport.d.ts.map +1 -1
  91. package/dist/client/hosted-transport.js +115 -55
  92. package/dist/client/hosted-transport.js.map +1 -1
  93. package/dist/client/hosted.d.ts +10 -4
  94. package/dist/client/hosted.d.ts.map +1 -1
  95. package/dist/client/hosted.js +10 -4
  96. package/dist/client/hosted.js.map +1 -1
  97. package/dist/client/index.d.ts +5 -3
  98. package/dist/client/index.d.ts.map +1 -1
  99. package/dist/client/index.js +2 -0
  100. package/dist/client/index.js.map +1 -1
  101. package/dist/client/messages.d.ts +25 -3
  102. package/dist/client/messages.d.ts.map +1 -1
  103. package/dist/client/messages.js +111 -20
  104. package/dist/client/messages.js.map +1 -1
  105. package/dist/client/receive-admission.d.ts +58 -0
  106. package/dist/client/receive-admission.d.ts.map +1 -0
  107. package/dist/client/receive-admission.js +78 -0
  108. package/dist/client/receive-admission.js.map +1 -0
  109. package/dist/client/receive-expiry.d.ts +31 -0
  110. package/dist/client/receive-expiry.d.ts.map +1 -0
  111. package/dist/client/receive-expiry.js +35 -0
  112. package/dist/client/receive-expiry.js.map +1 -0
  113. package/dist/client/receive-hook-bound.d.ts +50 -0
  114. package/dist/client/receive-hook-bound.d.ts.map +1 -0
  115. package/dist/client/receive-hook-bound.js +115 -0
  116. package/dist/client/receive-hook-bound.js.map +1 -0
  117. package/dist/client/receive-queue.d.ts +299 -0
  118. package/dist/client/receive-queue.d.ts.map +1 -0
  119. package/dist/client/receive-queue.js +1420 -0
  120. package/dist/client/receive-queue.js.map +1 -0
  121. package/dist/client/receive-work-seed.d.ts +54 -0
  122. package/dist/client/receive-work-seed.d.ts.map +1 -0
  123. package/dist/client/receive-work-seed.js +116 -0
  124. package/dist/client/receive-work-seed.js.map +1 -0
  125. package/dist/client/recovery-driver.d.ts +25 -0
  126. package/dist/client/recovery-driver.d.ts.map +1 -0
  127. package/dist/client/recovery-driver.js +121 -0
  128. package/dist/client/recovery-driver.js.map +1 -0
  129. package/dist/client/relay-acceptance.d.ts +20 -7
  130. package/dist/client/relay-acceptance.d.ts.map +1 -1
  131. package/dist/client/relay-acceptance.js +30 -12
  132. package/dist/client/relay-acceptance.js.map +1 -1
  133. package/dist/client/relay-device-refusal.d.ts +18 -0
  134. package/dist/client/relay-device-refusal.d.ts.map +1 -1
  135. package/dist/client/relay-device-refusal.js +31 -0
  136. package/dist/client/relay-device-refusal.js.map +1 -1
  137. package/dist/client/relay-sealed-route.d.ts +36 -0
  138. package/dist/client/relay-sealed-route.d.ts.map +1 -0
  139. package/dist/client/relay-sealed-route.js +45 -0
  140. package/dist/client/relay-sealed-route.js.map +1 -0
  141. package/dist/client/relay-subscription.d.ts +56 -13
  142. package/dist/client/relay-subscription.d.ts.map +1 -1
  143. package/dist/client/relay-subscription.js +193 -123
  144. package/dist/client/relay-subscription.js.map +1 -1
  145. package/dist/client/resendable-content.d.ts +98 -0
  146. package/dist/client/resendable-content.d.ts.map +1 -0
  147. package/dist/client/resendable-content.js +136 -0
  148. package/dist/client/resendable-content.js.map +1 -0
  149. package/dist/client/retry-family.d.ts +57 -10
  150. package/dist/client/retry-family.d.ts.map +1 -1
  151. package/dist/client/retry-family.js +54 -12
  152. package/dist/client/retry-family.js.map +1 -1
  153. package/dist/client/retry-request-envelope.d.ts +107 -8
  154. package/dist/client/retry-request-envelope.d.ts.map +1 -1
  155. package/dist/client/retry-request-envelope.js +172 -23
  156. package/dist/client/retry-request-envelope.js.map +1 -1
  157. package/dist/client/retry-request-lifecycle.d.ts +70 -14
  158. package/dist/client/retry-request-lifecycle.d.ts.map +1 -1
  159. package/dist/client/retry-request-lifecycle.js +162 -32
  160. package/dist/client/retry-request-lifecycle.js.map +1 -1
  161. package/dist/client/retry-terminal-recovery.d.ts +100 -0
  162. package/dist/client/retry-terminal-recovery.d.ts.map +1 -0
  163. package/dist/client/retry-terminal-recovery.js +164 -0
  164. package/dist/client/retry-terminal-recovery.js.map +1 -0
  165. package/dist/client/retry-utils.d.ts +27 -0
  166. package/dist/client/retry-utils.d.ts.map +1 -1
  167. package/dist/client/retry-utils.js +46 -0
  168. package/dist/client/retry-utils.js.map +1 -1
  169. package/dist/client/retry.d.ts +100 -12
  170. package/dist/client/retry.d.ts.map +1 -1
  171. package/dist/client/retry.js +619 -116
  172. package/dist/client/retry.js.map +1 -1
  173. package/dist/client/sealed-sender.d.ts +23 -6
  174. package/dist/client/sealed-sender.d.ts.map +1 -1
  175. package/dist/client/sealed-sender.js +30 -6
  176. package/dist/client/sealed-sender.js.map +1 -1
  177. package/dist/client/sessions.d.ts +2 -2
  178. package/dist/client/sessions.js +2 -2
  179. package/dist/client/signal-service-cipher.d.ts +726 -19
  180. package/dist/client/signal-service-cipher.d.ts.map +1 -1
  181. package/dist/client/signal-service-cipher.js +2260 -342
  182. package/dist/client/signal-service-cipher.js.map +1 -1
  183. package/dist/client/state.d.ts +5 -0
  184. package/dist/client/state.d.ts.map +1 -1
  185. package/dist/client/state.js +11 -1
  186. package/dist/client/state.js.map +1 -1
  187. package/dist/client/storage-protection.d.ts +64 -0
  188. package/dist/client/storage-protection.d.ts.map +1 -0
  189. package/dist/client/storage-protection.js +150 -0
  190. package/dist/client/storage-protection.js.map +1 -0
  191. package/dist/client/types.d.ts +149 -15
  192. package/dist/client/types.d.ts.map +1 -1
  193. package/dist/client/types.js +1 -1
  194. package/dist/client/types.js.map +1 -1
  195. package/dist/device/constants.d.ts +0 -5
  196. package/dist/device/constants.d.ts.map +1 -1
  197. package/dist/device/constants.js +0 -5
  198. package/dist/device/constants.js.map +1 -1
  199. package/dist/device/expo/index.d.ts +4 -17
  200. package/dist/device/expo/index.d.ts.map +1 -1
  201. package/dist/device/expo/index.js +4 -23
  202. package/dist/device/expo/index.js.map +1 -1
  203. package/dist/device/index.d.ts +0 -2
  204. package/dist/device/index.d.ts.map +1 -1
  205. package/dist/device/index.js +0 -7
  206. package/dist/device/index.js.map +1 -1
  207. package/dist/device/lifecycle/manager.d.ts +5 -4
  208. package/dist/device/lifecycle/manager.d.ts.map +1 -1
  209. package/dist/device/lifecycle/manager.js +16 -16
  210. package/dist/device/lifecycle/manager.js.map +1 -1
  211. package/dist/device/lifecycle/types.d.ts +2 -2
  212. package/dist/device/lifecycle/types.d.ts.map +1 -1
  213. package/dist/device/react-native/index.d.ts +4 -15
  214. package/dist/device/react-native/index.d.ts.map +1 -1
  215. package/dist/device/react-native/index.js +4 -21
  216. package/dist/device/react-native/index.js.map +1 -1
  217. package/dist/device/types.d.ts +1 -1
  218. package/dist/groups/index.d.ts +1 -1
  219. package/dist/groups/index.d.ts.map +1 -1
  220. package/dist/index.d.ts +8 -6
  221. package/dist/index.d.ts.map +1 -1
  222. package/dist/index.js +2 -1
  223. package/dist/index.js.map +1 -1
  224. package/dist/internal/crypto/ec/x25519-validation.d.ts +0 -1
  225. package/dist/internal/crypto/ec/x25519-validation.d.ts.map +1 -1
  226. package/dist/internal/crypto/ec/x25519-validation.js +0 -1
  227. package/dist/internal/crypto/ec/x25519-validation.js.map +1 -1
  228. package/dist/internal/crypto/validation.d.ts +2 -2
  229. package/dist/internal/groups/index.d.ts +1 -0
  230. package/dist/internal/groups/index.d.ts.map +1 -1
  231. package/dist/internal/groups/index.js +1 -0
  232. package/dist/internal/groups/index.js.map +1 -1
  233. package/dist/internal/groups/manager.d.ts +37 -16
  234. package/dist/internal/groups/manager.d.ts.map +1 -1
  235. package/dist/internal/groups/manager.js +46 -1
  236. package/dist/internal/groups/manager.js.map +1 -1
  237. package/dist/internal/groups/receive-record.d.ts +78 -0
  238. package/dist/internal/groups/receive-record.d.ts.map +1 -0
  239. package/dist/internal/groups/receive-record.js +43 -0
  240. package/dist/internal/groups/receive-record.js.map +1 -0
  241. package/dist/internal/groups/sdk-store.d.ts +27 -3
  242. package/dist/internal/groups/sdk-store.d.ts.map +1 -1
  243. package/dist/internal/groups/sdk-store.js +151 -19
  244. package/dist/internal/groups/sdk-store.js.map +1 -1
  245. package/dist/internal/groups/wire.d.ts +12 -1
  246. package/dist/internal/groups/wire.d.ts.map +1 -1
  247. package/dist/internal/groups/wire.js +36 -0
  248. package/dist/internal/groups/wire.js.map +1 -1
  249. package/dist/internal/manager/index.d.ts +1 -1
  250. package/dist/internal/manager/manager.d.ts +26 -20
  251. package/dist/internal/manager/manager.d.ts.map +1 -1
  252. package/dist/internal/manager/manager.js +64 -41
  253. package/dist/internal/manager/manager.js.map +1 -1
  254. package/dist/internal/protocol/double-ratchet/chains.d.ts +4 -18
  255. package/dist/internal/protocol/double-ratchet/chains.d.ts.map +1 -1
  256. package/dist/internal/protocol/double-ratchet/chains.js +23 -74
  257. package/dist/internal/protocol/double-ratchet/chains.js.map +1 -1
  258. package/dist/internal/protocol/double-ratchet/index.d.ts +1 -1
  259. package/dist/internal/protocol/double-ratchet/index.d.ts.map +1 -1
  260. package/dist/internal/protocol/double-ratchet/index.js +1 -1
  261. package/dist/internal/protocol/double-ratchet/index.js.map +1 -1
  262. package/dist/internal/protocol/double-ratchet/ratchet.d.ts +5 -7
  263. package/dist/internal/protocol/double-ratchet/ratchet.d.ts.map +1 -1
  264. package/dist/internal/protocol/double-ratchet/ratchet.js +4 -6
  265. package/dist/internal/protocol/double-ratchet/ratchet.js.map +1 -1
  266. package/dist/internal/protocol/pqxdh/pqxdh.d.ts.map +1 -1
  267. package/dist/internal/protocol/pqxdh/pqxdh.js +2 -1
  268. package/dist/internal/protocol/pqxdh/pqxdh.js.map +1 -1
  269. package/dist/internal/protocol/sealed-sender/types.d.ts +6 -8
  270. package/dist/internal/protocol/sealed-sender/types.d.ts.map +1 -1
  271. package/dist/internal/protocol/sealed-sender/types.js +8 -9
  272. package/dist/internal/protocol/sealed-sender/types.js.map +1 -1
  273. package/dist/internal/protocol/sender-keys/handoff-ledger.d.ts +110 -0
  274. package/dist/internal/protocol/sender-keys/handoff-ledger.d.ts.map +1 -0
  275. package/dist/internal/protocol/sender-keys/handoff-ledger.js +124 -0
  276. package/dist/internal/protocol/sender-keys/handoff-ledger.js.map +1 -0
  277. package/dist/internal/protocol/sender-keys/manager.d.ts +71 -62
  278. package/dist/internal/protocol/sender-keys/manager.d.ts.map +1 -1
  279. package/dist/internal/protocol/sender-keys/manager.js +228 -175
  280. package/dist/internal/protocol/sender-keys/manager.js.map +1 -1
  281. package/dist/internal/protocol/spqr/index.d.ts +2 -2
  282. package/dist/internal/protocol/spqr/index.d.ts.map +1 -1
  283. package/dist/internal/protocol/spqr/index.js +2 -2
  284. package/dist/internal/protocol/spqr/index.js.map +1 -1
  285. package/dist/internal/protocol/spqr/serialize.d.ts +9 -1
  286. package/dist/internal/protocol/spqr/serialize.d.ts.map +1 -1
  287. package/dist/internal/protocol/spqr/serialize.js +56 -16
  288. package/dist/internal/protocol/spqr/serialize.js.map +1 -1
  289. package/dist/internal/protocol/spqr/spqr.d.ts +1 -14
  290. package/dist/internal/protocol/spqr/spqr.d.ts.map +1 -1
  291. package/dist/internal/protocol/spqr/spqr.js +54 -42
  292. package/dist/internal/protocol/spqr/spqr.js.map +1 -1
  293. package/dist/internal/protocol/spqr/validate.d.ts +26 -6
  294. package/dist/internal/protocol/spqr/validate.d.ts.map +1 -1
  295. package/dist/internal/protocol/spqr/validate.js +49 -21
  296. package/dist/internal/protocol/spqr/validate.js.map +1 -1
  297. package/dist/internal/sesame/index.d.ts +1 -1
  298. package/dist/internal/sesame/index.d.ts.map +1 -1
  299. package/dist/internal/sesame/index.js.map +1 -1
  300. package/dist/internal/sesame/manager.d.ts +66 -13
  301. package/dist/internal/sesame/manager.d.ts.map +1 -1
  302. package/dist/internal/sesame/manager.js +221 -87
  303. package/dist/internal/sesame/manager.js.map +1 -1
  304. package/dist/internal/sesame/types.d.ts +95 -17
  305. package/dist/internal/sesame/types.d.ts.map +1 -1
  306. package/dist/internal/sesame/types.js +17 -0
  307. package/dist/internal/sesame/types.js.map +1 -1
  308. package/dist/internal/session/builder.d.ts +5 -5
  309. package/dist/internal/session/builder.d.ts.map +1 -1
  310. package/dist/internal/session/builder.js +12 -17
  311. package/dist/internal/session/builder.js.map +1 -1
  312. package/dist/internal/session/cipher.d.ts +15 -13
  313. package/dist/internal/session/cipher.d.ts.map +1 -1
  314. package/dist/internal/session/cipher.js +41 -23
  315. package/dist/internal/session/cipher.js.map +1 -1
  316. package/dist/internal/session/factory.d.ts +5 -5
  317. package/dist/internal/session/factory.d.ts.map +1 -1
  318. package/dist/internal/session/factory.js +4 -4
  319. package/dist/internal/session/factory.js.map +1 -1
  320. package/dist/internal/session/handshake.d.ts +14 -16
  321. package/dist/internal/session/handshake.d.ts.map +1 -1
  322. package/dist/internal/session/handshake.js +18 -75
  323. package/dist/internal/session/handshake.js.map +1 -1
  324. package/dist/internal/session/index.d.ts +1 -1
  325. package/dist/internal/session/index.js +1 -1
  326. package/dist/internal/session/record-locks.d.ts +17 -6
  327. package/dist/internal/session/record-locks.d.ts.map +1 -1
  328. package/dist/internal/session/record-locks.js +43 -7
  329. package/dist/internal/session/record-locks.js.map +1 -1
  330. package/dist/internal/session/session-resolver.d.ts +1 -1
  331. package/dist/internal/session/session-resolver.js +1 -1
  332. package/dist/internal/session/state.d.ts +2 -2
  333. package/dist/internal/session/state.js +1 -1
  334. package/dist/internal/session/types.d.ts +5 -13
  335. package/dist/internal/session/types.d.ts.map +1 -1
  336. package/dist/internal/session/types.js +1 -1
  337. package/dist/keys/generation.d.ts +2 -2
  338. package/dist/keys/generation.js +2 -2
  339. package/dist/keys/types.d.ts +5 -5
  340. package/dist/keys/types.d.ts.map +1 -1
  341. package/dist/keys/types.js +1 -1
  342. package/dist/layers.d.ts +1 -1
  343. package/dist/layers.js +2 -2
  344. package/dist/layers.js.map +1 -1
  345. package/dist/local/store/expo/adapter.d.ts.map +1 -1
  346. package/dist/local/store/expo/adapter.js +12 -8
  347. package/dist/local/store/expo/adapter.js.map +1 -1
  348. package/dist/local/store/key-value/adapter.d.ts +76 -10
  349. package/dist/local/store/key-value/adapter.d.ts.map +1 -1
  350. package/dist/local/store/key-value/adapter.js +367 -61
  351. package/dist/local/store/key-value/adapter.js.map +1 -1
  352. package/dist/local/store/key-value/backend-conformance.d.ts.map +1 -1
  353. package/dist/local/store/key-value/backend-conformance.js +74 -0
  354. package/dist/local/store/key-value/backend-conformance.js.map +1 -1
  355. package/dist/local/store/key-value/batch.d.ts +2 -0
  356. package/dist/local/store/key-value/batch.d.ts.map +1 -1
  357. package/dist/local/store/key-value/batch.js +26 -0
  358. package/dist/local/store/key-value/batch.js.map +1 -1
  359. package/dist/local/store/key-value/receive-work.d.ts +55 -0
  360. package/dist/local/store/key-value/receive-work.d.ts.map +1 -0
  361. package/dist/local/store/key-value/receive-work.js +162 -0
  362. package/dist/local/store/key-value/receive-work.js.map +1 -0
  363. package/dist/local/store/key-value/send-log.d.ts +61 -0
  364. package/dist/local/store/key-value/send-log.d.ts.map +1 -0
  365. package/dist/local/store/key-value/send-log.js +430 -0
  366. package/dist/local/store/key-value/send-log.js.map +1 -0
  367. package/dist/local/store/key-value/sender-key-handoff.d.ts +68 -0
  368. package/dist/local/store/key-value/sender-key-handoff.d.ts.map +1 -0
  369. package/dist/local/store/key-value/sender-key-handoff.js +189 -0
  370. package/dist/local/store/key-value/sender-key-handoff.js.map +1 -0
  371. package/dist/local/store/key-value/storage.d.ts +15 -0
  372. package/dist/local/store/key-value/storage.d.ts.map +1 -1
  373. package/dist/local/store/keyed-index.d.ts +23 -0
  374. package/dist/local/store/keyed-index.d.ts.map +1 -0
  375. package/dist/local/store/keyed-index.js +41 -0
  376. package/dist/local/store/keyed-index.js.map +1 -0
  377. package/dist/local/store/memory/adapter.d.ts +44 -12
  378. package/dist/local/store/memory/adapter.d.ts.map +1 -1
  379. package/dist/local/store/memory/adapter.js +197 -46
  380. package/dist/local/store/memory/adapter.js.map +1 -1
  381. package/dist/local/store/memory/send-log.d.ts +42 -0
  382. package/dist/local/store/memory/send-log.d.ts.map +1 -0
  383. package/dist/local/store/memory/send-log.js +190 -0
  384. package/dist/local/store/memory/send-log.js.map +1 -0
  385. package/dist/local/store/node/adapter.d.ts.map +1 -1
  386. package/dist/local/store/node/adapter.js +8 -6
  387. package/dist/local/store/node/adapter.js.map +1 -1
  388. package/dist/local/store/react-native/adapter.d.ts.map +1 -1
  389. package/dist/local/store/react-native/adapter.js +12 -8
  390. package/dist/local/store/react-native/adapter.js.map +1 -1
  391. package/dist/local/store/receive-work.d.ts +87 -0
  392. package/dist/local/store/receive-work.d.ts.map +1 -0
  393. package/dist/local/store/receive-work.js +204 -0
  394. package/dist/local/store/receive-work.js.map +1 -0
  395. package/dist/local/store/received-content.d.ts +3 -3
  396. package/dist/local/store/received-content.d.ts.map +1 -1
  397. package/dist/local/store/received-content.js +2 -11
  398. package/dist/local/store/received-content.js.map +1 -1
  399. package/dist/local/store/reliability.d.ts +317 -18
  400. package/dist/local/store/reliability.d.ts.map +1 -1
  401. package/dist/local/store/reliability.js +371 -46
  402. package/dist/local/store/reliability.js.map +1 -1
  403. package/dist/local/store/send-log-order.d.ts +15 -0
  404. package/dist/local/store/send-log-order.d.ts.map +1 -0
  405. package/dist/local/store/send-log-order.js +24 -0
  406. package/dist/local/store/send-log-order.js.map +1 -0
  407. package/dist/local/store/sender-key-handoff-index.d.ts +38 -0
  408. package/dist/local/store/sender-key-handoff-index.d.ts.map +1 -0
  409. package/dist/local/store/sender-key-handoff-index.js +101 -0
  410. package/dist/local/store/sender-key-handoff-index.js.map +1 -0
  411. package/dist/local/store/sender-key-handoff-table.d.ts +29 -0
  412. package/dist/local/store/sender-key-handoff-table.d.ts.map +1 -0
  413. package/dist/local/store/sender-key-handoff-table.js +97 -0
  414. package/dist/local/store/sender-key-handoff-table.js.map +1 -0
  415. package/dist/local/store/sqlite/driver.d.ts +9 -0
  416. package/dist/local/store/sqlite/driver.d.ts.map +1 -1
  417. package/dist/local/store/sqlite/encryption.d.ts +8 -1
  418. package/dist/local/store/sqlite/encryption.d.ts.map +1 -1
  419. package/dist/local/store/sqlite/encryption.js +9 -0
  420. package/dist/local/store/sqlite/encryption.js.map +1 -1
  421. package/dist/local/store/sqlite/key-storage/index.d.ts +25 -4
  422. package/dist/local/store/sqlite/key-storage/index.d.ts.map +1 -1
  423. package/dist/local/store/sqlite/key-storage/index.js +68 -7
  424. package/dist/local/store/sqlite/key-storage/index.js.map +1 -1
  425. package/dist/local/store/sqlite/key-storage/message-records.d.ts +16 -4
  426. package/dist/local/store/sqlite/key-storage/message-records.d.ts.map +1 -1
  427. package/dist/local/store/sqlite/key-storage/message-records.js +49 -6
  428. package/dist/local/store/sqlite/key-storage/message-records.js.map +1 -1
  429. package/dist/local/store/sqlite/key-storage/metadata.d.ts +8 -7
  430. package/dist/local/store/sqlite/key-storage/metadata.d.ts.map +1 -1
  431. package/dist/local/store/sqlite/key-storage/metadata.js +17 -15
  432. package/dist/local/store/sqlite/key-storage/metadata.js.map +1 -1
  433. package/dist/local/store/sqlite/key-storage/receive-work.d.ts +27 -0
  434. package/dist/local/store/sqlite/key-storage/receive-work.d.ts.map +1 -0
  435. package/dist/local/store/sqlite/key-storage/receive-work.js +98 -0
  436. package/dist/local/store/sqlite/key-storage/receive-work.js.map +1 -0
  437. package/dist/local/store/sqlite/key-storage/send-log.d.ts +27 -0
  438. package/dist/local/store/sqlite/key-storage/send-log.d.ts.map +1 -0
  439. package/dist/local/store/sqlite/key-storage/send-log.js +178 -0
  440. package/dist/local/store/sqlite/key-storage/send-log.js.map +1 -0
  441. package/dist/local/store/sqlite/key-storage/sender-key-handoff.d.ts +27 -0
  442. package/dist/local/store/sqlite/key-storage/sender-key-handoff.d.ts.map +1 -0
  443. package/dist/local/store/sqlite/key-storage/sender-key-handoff.js +75 -0
  444. package/dist/local/store/sqlite/key-storage/sender-key-handoff.js.map +1 -0
  445. package/dist/local/store/sqlite/key-storage/session-trust.d.ts +2 -2
  446. package/dist/local/store/sqlite/key-storage/session-trust.js +5 -5
  447. package/dist/local/store/sqlite/key-storage/session-trust.js.map +1 -1
  448. package/dist/local/store/sqlite/migrations.d.ts.map +1 -1
  449. package/dist/local/store/sqlite/migrations.js +101 -0
  450. package/dist/local/store/sqlite/migrations.js.map +1 -1
  451. package/dist/local/store/sqlite/models/index.d.ts +2 -1
  452. package/dist/local/store/sqlite/models/index.d.ts.map +1 -1
  453. package/dist/local/store/sqlite/models/index.js +5 -1
  454. package/dist/local/store/sqlite/models/index.js.map +1 -1
  455. package/dist/local/store/sqlite/models/message-record.d.ts +15 -0
  456. package/dist/local/store/sqlite/models/message-record.d.ts.map +1 -1
  457. package/dist/local/store/sqlite/models/message-record.js +24 -0
  458. package/dist/local/store/sqlite/models/message-record.js.map +1 -1
  459. package/dist/local/store/sqlite/models/send-log.d.ts +51 -0
  460. package/dist/local/store/sqlite/models/send-log.d.ts.map +1 -0
  461. package/dist/local/store/sqlite/models/send-log.js +206 -0
  462. package/dist/local/store/sqlite/models/send-log.js.map +1 -0
  463. package/dist/local/store/sqlite/open-store.d.ts +9 -1
  464. package/dist/local/store/sqlite/open-store.d.ts.map +1 -1
  465. package/dist/local/store/sqlite/open-store.js +20 -1
  466. package/dist/local/store/sqlite/open-store.js.map +1 -1
  467. package/dist/local/store/sqlite/schema.d.ts +34 -1
  468. package/dist/local/store/sqlite/schema.d.ts.map +1 -1
  469. package/dist/local/store/sqlite/schema.js +14 -0
  470. package/dist/local/store/sqlite/schema.js.map +1 -1
  471. package/dist/local/store/sqlite/store.d.ts +61 -11
  472. package/dist/local/store/sqlite/store.d.ts.map +1 -1
  473. package/dist/local/store/sqlite/store.js +191 -27
  474. package/dist/local/store/sqlite/store.js.map +1 -1
  475. package/dist/local/store/sqlite/web/sqlite3mc/sqlite3.mjs +2 -1
  476. package/dist/local/store/sqlite/web/worker.d.ts +8 -0
  477. package/dist/local/store/sqlite/web/worker.d.ts.map +1 -1
  478. package/dist/local/store/sqlite/web/worker.js +64 -2
  479. package/dist/local/store/sqlite/web/worker.js.map +1 -1
  480. package/dist/local/store/web/adapter.d.ts +76 -8
  481. package/dist/local/store/web/adapter.d.ts.map +1 -1
  482. package/dist/local/store/web/adapter.js +579 -127
  483. package/dist/local/store/web/adapter.js.map +1 -1
  484. package/dist/local/store/web/receive-work.d.ts +57 -0
  485. package/dist/local/store/web/receive-work.d.ts.map +1 -0
  486. package/dist/local/store/web/receive-work.js +99 -0
  487. package/dist/local/store/web/receive-work.js.map +1 -0
  488. package/dist/local/store/web/send-log.d.ts +92 -0
  489. package/dist/local/store/web/send-log.d.ts.map +1 -0
  490. package/dist/local/store/web/send-log.js +267 -0
  491. package/dist/local/store/web/send-log.js.map +1 -0
  492. package/dist/local/store/web/sender-key-handoff.d.ts +81 -0
  493. package/dist/local/store/web/sender-key-handoff.d.ts.map +1 -0
  494. package/dist/local/store/web/sender-key-handoff.js +156 -0
  495. package/dist/local/store/web/sender-key-handoff.js.map +1 -0
  496. package/dist/local/store/web-sqlite/adapter.d.ts +2 -0
  497. package/dist/local/store/web-sqlite/adapter.d.ts.map +1 -1
  498. package/dist/local/store/web-sqlite/adapter.js +12 -6
  499. package/dist/local/store/web-sqlite/adapter.js.map +1 -1
  500. package/dist/local/vault/custody.d.ts +8 -0
  501. package/dist/local/vault/custody.d.ts.map +1 -0
  502. package/dist/local/vault/custody.js +9 -0
  503. package/dist/local/vault/custody.js.map +1 -0
  504. package/dist/local/vault/electron-safe-storage.d.ts +3 -1
  505. package/dist/local/vault/electron-safe-storage.d.ts.map +1 -1
  506. package/dist/local/vault/electron-safe-storage.js +2 -0
  507. package/dist/local/vault/electron-safe-storage.js.map +1 -1
  508. package/dist/local/vault/expo-secure-store.d.ts +3 -1
  509. package/dist/local/vault/expo-secure-store.d.ts.map +1 -1
  510. package/dist/local/vault/expo-secure-store.js +2 -0
  511. package/dist/local/vault/expo-secure-store.js.map +1 -1
  512. package/dist/local/vault/indexed-db.d.ts +3 -1
  513. package/dist/local/vault/indexed-db.d.ts.map +1 -1
  514. package/dist/local/vault/indexed-db.js +2 -0
  515. package/dist/local/vault/indexed-db.js.map +1 -1
  516. package/dist/local/vault/react-native-keychain.d.ts +3 -1
  517. package/dist/local/vault/react-native-keychain.d.ts.map +1 -1
  518. package/dist/local/vault/react-native-keychain.js +2 -0
  519. package/dist/local/vault/react-native-keychain.js.map +1 -1
  520. package/dist/remote/relay/device-set.d.ts +94 -0
  521. package/dist/remote/relay/device-set.d.ts.map +1 -0
  522. package/dist/remote/relay/device-set.js +156 -0
  523. package/dist/remote/relay/device-set.js.map +1 -0
  524. package/dist/remote/relay/types.d.ts +92 -107
  525. package/dist/remote/relay/types.d.ts.map +1 -1
  526. package/dist/safety/core.d.ts +15 -6
  527. package/dist/safety/core.d.ts.map +1 -1
  528. package/dist/safety/core.js +41 -27
  529. package/dist/safety/core.js.map +1 -1
  530. package/dist/safety/index.d.ts +2 -1
  531. package/dist/safety/index.d.ts.map +1 -1
  532. package/dist/safety/index.js +12 -18
  533. package/dist/safety/index.js.map +1 -1
  534. package/dist/types/api.d.ts +707 -62
  535. package/dist/types/api.d.ts.map +1 -1
  536. package/dist/types/errors.d.ts +14 -33
  537. package/dist/types/errors.d.ts.map +1 -1
  538. package/dist/types/errors.js +14 -24
  539. package/dist/types/errors.js.map +1 -1
  540. package/dist/types/messages.d.ts +2 -2
  541. package/dist/types/messages.js +1 -1
  542. package/dist/types/protocol-config.d.ts +175 -42
  543. package/dist/types/protocol-config.d.ts.map +1 -1
  544. package/dist/types/protocol-config.js +19 -38
  545. package/dist/types/protocol-config.js.map +1 -1
  546. package/dist/types/protocol-constants.d.ts +6 -6
  547. package/dist/types/protocol-constants.js +6 -6
  548. package/dist/types/session.d.ts +7 -7
  549. package/dist/types/session.d.ts.map +1 -1
  550. package/dist/types/session.js +39 -21
  551. package/dist/types/session.js.map +1 -1
  552. package/dist/username/link.d.ts +2 -2
  553. package/dist/username/link.js +2 -2
  554. package/dist/utils/origin-lock.d.ts +45 -0
  555. package/dist/utils/origin-lock.d.ts.map +1 -0
  556. package/dist/utils/origin-lock.js +80 -0
  557. package/dist/utils/origin-lock.js.map +1 -0
  558. package/docs/ASSURANCE.md +6 -6
  559. package/docs/CLIENT_COMPOSITION.md +2 -2
  560. package/docs/DEVIATIONS.md +677 -182
  561. package/docs/E2EE.md +1 -1
  562. package/docs/ERROR_HANDLING.md +165 -2
  563. package/docs/GETTING_STARTED.md +7 -4
  564. package/docs/INTERFACES.md +1 -1
  565. package/docs/PACKAGE_SURFACE.md +6 -5
  566. package/docs/PROTOCOL_POLICY.md +102 -22
  567. package/docs/RECIPES.md +3 -15
  568. package/docs/SECURITY.md +90 -5
  569. package/keys/README.md +3 -3
  570. package/local/store/README.md +78 -14
  571. package/local/store/key-value/README.md +14 -3
  572. package/local/store/node/README.md +8 -3
  573. package/local/store/web/README.md +9 -0
  574. package/local/store/web-sqlite/README.md +14 -2
  575. package/local/vault/README.md +21 -0
  576. package/package.json +1 -6
  577. package/remote/README.md +0 -1
  578. package/remote/relay/README.md +2 -2
  579. package/dist/device/provisioning.d.ts +0 -242
  580. package/dist/device/provisioning.d.ts.map +0 -1
  581. package/dist/device/provisioning.js +0 -421
  582. package/dist/device/provisioning.js.map +0 -1
  583. package/dist/internal/protocol/x3dh/index.d.ts +0 -15
  584. package/dist/internal/protocol/x3dh/index.d.ts.map +0 -1
  585. package/dist/internal/protocol/x3dh/index.js +0 -13
  586. package/dist/internal/protocol/x3dh/index.js.map +0 -1
  587. package/dist/internal/protocol/x3dh/x3dh.d.ts +0 -131
  588. package/dist/internal/protocol/x3dh/x3dh.d.ts.map +0 -1
  589. package/dist/internal/protocol/x3dh/x3dh.js +0 -261
  590. package/dist/internal/protocol/x3dh/x3dh.js.map +0 -1
@@ -28,11 +28,16 @@ import { acceptContactIdentityRotation as acceptRotation, createUnverifiedContac
28
28
  import { ProtocolAddress } from '../../../types/address.js';
29
29
  import { IdentityKeyChange, StorageQuotaExceededError } from '../../../types/index.js';
30
30
  import { assertCurrentSessionRecord } from '../../../types/session.js';
31
+ import { isExpiredRemovedDevice } from '../../../internal/sesame/types.js';
31
32
  import { withDeviceRecordLocks } from '../../../internal/session/record-locks.js';
32
33
  import { withSession } from '../device-record.js';
33
34
  import { decodeUserRecord, encodeUserRecord } from './device-record.js';
35
+ import { IndexedDbSendLog, SEND_LOG_STORE_NAMES, upgradeSendLogStores, } from './send-log.js';
36
+ import { IndexedDbReceiveWork, upgradeReceiveWorkStore, } from './receive-work.js';
37
+ import { IndexedDbSenderKeyHandoffs, upgradeSenderKeyHandoffStore, } from './sender-key-handoff.js';
34
38
  import { deserializeSessionRecord, serializeSessionRecord } from '../session-codec.js';
35
- import { receivedContentKey, parseReceivedContent } from '../received-content.js';
39
+ import { receivedContentKey } from '../received-content.js';
40
+ import { convertLegacyReceivedContent } from '../receive-work.js';
36
41
  import { createKyberPreKeyState, createKyberPreKeyInstanceId, getCurrentKyberPreKey, getRetainedKyberPreKey, recordKyberPreKeyUse, recordKyberPreKeyUseById, retainKyberPreKey, } from '../kyber-prekey-lifecycle.js';
37
42
  function equalBytes(left, right) {
38
43
  if (!left || !right)
@@ -41,6 +46,69 @@ function equalBytes(left, right) {
41
46
  return false;
42
47
  return left.every((value, index) => value === right[index]);
43
48
  }
49
+ /**
50
+ * The first byte of an encrypted metadata value. The record cipher's output
51
+ * follows it. A metadata value stored as a string is a clear value that an
52
+ * older SDK wrote.
53
+ */
54
+ const METADATA_CIPHER_VERSION = 1;
55
+ /**
56
+ * Set after every clear metadata value is encrypted. A crash before it is set
57
+ * runs the migration again at the next open.
58
+ */
59
+ const METADATA_CIPHER_MARKER_KEY = 'metadataCipherVersion';
60
+ function metadataStorageKey(key) {
61
+ return `meta:${key}`;
62
+ }
63
+ /** Compares two raw stored metadata values, clear or encrypted. */
64
+ function sameStoredMetadata(left, right) {
65
+ if (left instanceof Uint8Array && right instanceof Uint8Array)
66
+ return equalBytes(left, right);
67
+ return left === right;
68
+ }
69
+ /**
70
+ * The database as the send log types it. The schema extends
71
+ * `SendLogDBSchema`, so the send log stores have the same types in both. The
72
+ * idb types do not let a database with more stores stand in for one with
73
+ * fewer.
74
+ */
75
+ function sendLogView(db) {
76
+ return db;
77
+ }
78
+ /** The database as the receive records type it, for the same reason as `sendLogView`. */
79
+ function receiveWorkView(db) {
80
+ return db;
81
+ }
82
+ /** The database as the sender-key handoff rows type it, for the same reason as `sendLogView`. */
83
+ function senderKeyHandoffView(db) {
84
+ return db;
85
+ }
86
+ /**
87
+ * Run the reads and the mutations of one read-write transaction. `enter`
88
+ * reads what it needs, then pushes every mutation in one synchronous batch:
89
+ * a page that dies commits a transaction idle at an await, so an await
90
+ * between two mutations could land only some of them. A failure aborts the
91
+ * transaction, so no mutation of the batch commits.
92
+ */
93
+ async function commitTransaction(tx, enter) {
94
+ const writes = [];
95
+ const completed = tx.done;
96
+ void completed.catch(() => undefined);
97
+ try {
98
+ await enter(writes);
99
+ await Promise.all([...writes, completed]);
100
+ }
101
+ catch (error) {
102
+ try {
103
+ tx.abort();
104
+ }
105
+ catch {
106
+ /* The failed transaction can already be inactive. */
107
+ }
108
+ await Promise.allSettled([...writes, completed]);
109
+ throw error;
110
+ }
111
+ }
44
112
  /**
45
113
  * Compares stored ciphertext, not secret material - corrupt-row cleanup only
46
114
  * deletes a row whose bytes are still the ones that failed to deserialize.
@@ -142,10 +210,35 @@ function mapQuotaFailuresAtBoundary(store) {
142
210
  * - TOFU (Trust On First Use) for contact verification
143
211
  */
144
212
  export class IndexedDbSignalProtocolStore {
213
+ /** Each value is encrypted with a key that this database holds in the same origin. */
214
+ protection = Object.freeze({
215
+ atRest: 'record-cipher',
216
+ keyCustody: 'same-origin',
217
+ });
145
218
  db = null;
146
219
  databaseKey = null;
220
+ senderKeyHandoffs = new IndexedDbSenderKeyHandoffs(() => senderKeyHandoffView(this.db), {
221
+ encrypt: (plaintext) => this.encrypt(plaintext),
222
+ decrypt: (encrypted) => this.decrypt(encrypted),
223
+ databaseKey: () => this.getDatabaseKey(),
224
+ });
147
225
  dbName = 'signal-protocol-storage';
148
- dbVersion = 7; // v7 keys sender keys by arrays and indexes skipped keys by group
226
+ /** The database name. The tabs and workers of the origin share its locks. */
227
+ storeIdentity = this.dbName;
228
+ // v10 adds the sender-key handoff store. v11 adds `removedAt` to the
229
+ // device record. The encrypted record holds the field, so v11 changes no
230
+ // object store. It keeps an older SDK, which does not skip a removed
231
+ // device, from opening the database.
232
+ dbVersion = 11;
233
+ sendLog = new IndexedDbSendLog(() => sendLogView(this.db), {
234
+ encrypt: (plaintext) => this.encrypt(plaintext),
235
+ decrypt: (encrypted) => this.decrypt(encrypted),
236
+ });
237
+ receiveWork = new IndexedDbReceiveWork(() => receiveWorkView(this.db), {
238
+ encrypt: (plaintext) => this.encrypt(plaintext),
239
+ decrypt: (encrypted) => this.decrypt(encrypted),
240
+ databaseKey: () => this.getDatabaseKey(),
241
+ });
149
242
  constructor() {
150
243
  mapQuotaFailuresAtBoundary(this);
151
244
  }
@@ -238,6 +331,9 @@ export class IndexedDbSignalProtocolStore {
238
331
  messageStore.createIndex('by-session', 'sessionId');
239
332
  messageStore.createIndex('by-created', 'createdAt');
240
333
  }
334
+ upgradeSendLogStores(sendLogView(db));
335
+ upgradeReceiveWorkStore(receiveWorkView(db));
336
+ upgradeSenderKeyHandoffStore(senderKeyHandoffView(db));
241
337
  },
242
338
  });
243
339
  // Get or generate database encryption key
@@ -264,6 +360,8 @@ export class IndexedDbSignalProtocolStore {
264
360
  console.warn('[IndexedDbSignalProtocolStore] Database encryption key stored in IndexedDB. ' +
265
361
  'Ensure Content Security Policy (CSP) is configured to mitigate XSS risks.');
266
362
  }
363
+ await this.encryptClearMetadata();
364
+ await this.convertLegacyReceivedRows();
267
365
  }
268
366
  /**
269
367
  * Close the underlying IndexedDB connection and drop the in-memory copy of
@@ -394,31 +492,35 @@ export class IndexedDbSignalProtocolStore {
394
492
  const replacement = acceptRotation(existing, identity, Date.now(), suppliedCommitment);
395
493
  validateContactIdentityRecord(replacement);
396
494
  const encrypted = await this.encrypt(JSON.stringify(replacement));
397
- const tx = this.db.transaction(['contacts', 'sessions'], 'readwrite');
398
- const contacts = tx.objectStore('contacts');
399
- const current = await contacts.get(key);
400
- if (!current || current.revision !== existing.revision) {
401
- await tx.done;
402
- throw new Error('Contact identity changed concurrently during rotation');
403
- }
404
- // Read the doomed session keys before mutating, then enter every
405
- // mutation in one synchronous batch. A dying page closes its connection
406
- // gracefully, and a transaction that is idle at an await boundary then
407
- // commits the writes it already holds. A cursor walk that deletes as
408
- // it goes leaves windows where the new pin commits with sessions still
409
- // trusted under the old identity.
410
- const sessions = tx.objectStore('sessions');
411
- const doomedKeys = await sessions.index('by-user').getAllKeys(address.userId);
412
- await Promise.all([
413
- contacts.put({
495
+ const accountHash = (await this.senderKeyHandoffs.index()).account(address.userId);
496
+ const tx = this.db.transaction(['contacts', 'sessions', 'senderKeyHandoff'], 'readwrite');
497
+ await commitTransaction(tx, async (writes) => {
498
+ const contacts = tx.objectStore('contacts');
499
+ const current = await contacts.get(key);
500
+ if (!current || current.revision !== existing.revision) {
501
+ throw new Error('Contact identity changed concurrently during rotation');
502
+ }
503
+ // Read the doomed session and handoff keys before mutating, then enter
504
+ // every mutation in one synchronous batch. A cursor walk that deletes
505
+ // as it goes leaves windows where the new pin commits with sessions
506
+ // still trusted under the old identity.
507
+ const sessions = tx.objectStore('sessions');
508
+ const handoffs = tx.objectStore('senderKeyHandoff');
509
+ const doomedKeys = await sessions.index('by-user').getAllKeys(address.userId);
510
+ const doomedHandoffs = await handoffs.index('by-account').getAllKeys(accountHash);
511
+ writes.push(contacts.put({
414
512
  key,
415
513
  userId: address.userId,
416
514
  data: encrypted,
417
515
  revision: replacement.revision,
418
- }),
419
- ...doomedKeys.map((sessionKey) => sessions.delete(sessionKey)),
420
- tx.done,
421
- ]);
516
+ }));
517
+ // Push each request as it is created. A later synchronous throw must
518
+ // not leave an earlier request outside the settled set.
519
+ for (const sessionKey of doomedKeys)
520
+ writes.push(sessions.delete(sessionKey));
521
+ for (const handoffKey of doomedHandoffs)
522
+ writes.push(handoffs.delete(handoffKey));
523
+ });
422
524
  return replacement;
423
525
  }
424
526
  async verifyContactIdentity(address, identity, identityType, suppliedCommitment) {
@@ -712,9 +814,7 @@ export class IndexedDbSignalProtocolStore {
712
814
  ? await this.encrypt(JSON.stringify(newContact))
713
815
  : undefined;
714
816
  const encrypted = await this.encrypt(serializeSessionRecord(commit.record));
715
- const content = commit.receivedContent
716
- ? await this.encrypt(JSON.stringify(commit.receivedContent))
717
- : undefined;
817
+ const work = commit.receiveWork ? await this.receiveWork.seal(commit.receiveWork) : undefined;
718
818
  const kyberStorageKey = `kyber:${commit.localIdentityType}`;
719
819
  const storedKyberState = commit.kyberPreKeyUse
720
820
  ? await this.db.get('prekeys', kyberStorageKey)
@@ -727,7 +827,11 @@ export class IndexedDbSignalProtocolStore {
727
827
  recordKyberPreKeyUse(state, commit.localIdentityType, commit.kyberPreKeyUse);
728
828
  updatedKyberState = await this.encrypt(JSON.stringify(state));
729
829
  }
730
- const tx = this.db.transaction(['contacts', 'prekeys', 'sessions', 'metadata'], 'readwrite');
830
+ const invalidation = commit.senderKeyHandoffInvalidation;
831
+ const invalidatedHash = invalidation
832
+ ? (await this.senderKeyHandoffs.index()).recipient(invalidation)
833
+ : undefined;
834
+ const tx = this.db.transaction(['contacts', 'prekeys', 'sessions', 'receiveWork', 'senderKeyHandoff'], 'readwrite');
731
835
  const contacts = tx.objectStore('contacts');
732
836
  const prekeys = tx.objectStore('prekeys');
733
837
  const currentContactRow = await contacts.get(contactKey);
@@ -756,14 +860,18 @@ export class IndexedDbSignalProtocolStore {
756
860
  await tx.done;
757
861
  throw new Error('Kyber prekey state changed during atomic session/trust commit');
758
862
  }
863
+ const handoffs = tx.objectStore('senderKeyHandoff');
864
+ const doomedHandoffs = invalidatedHash === undefined
865
+ ? []
866
+ : await handoffs.index('by-recipient').getAllKeys(invalidatedHash);
759
867
  // Every mutation must enter the transaction in one synchronous batch.
760
868
  // A dying page closes its connection gracefully, and a transaction that
761
869
  // is idle at an await boundary then commits the writes it already holds.
762
870
  // An await between mutations is a window for a partial commit.
763
871
  const writes = [];
764
872
  try {
765
- if (content && commit.receivedContent)
766
- writes.push(tx.objectStore('metadata').put(content, receivedContentKey(commit.receivedContent.id)));
873
+ if (work)
874
+ writes.push(tx.objectStore('receiveWork').put(work));
767
875
  if (newContact && encryptedContact) {
768
876
  writes.push(contacts.put({
769
877
  key: contactKey,
@@ -787,6 +895,8 @@ export class IndexedDbSignalProtocolStore {
787
895
  writes.push(prekeys.delete(kemPreKeyStorageKey));
788
896
  if (updatedKyberState)
789
897
  writes.push(prekeys.put(updatedKyberState, kyberStorageKey));
898
+ for (const handoffKey of doomedHandoffs)
899
+ writes.push(handoffs.delete(handoffKey));
790
900
  await Promise.all([...writes, tx.done]);
791
901
  }
792
902
  catch (error) {
@@ -802,28 +912,56 @@ export class IndexedDbSignalProtocolStore {
802
912
  }
803
913
  async deleteSessionRecord(address) {
804
914
  this.ensureInitialized();
805
- const addressKey = this.serializeAddress(address);
806
- await this.db.delete('sessions', addressKey);
915
+ await this.replaceSessionAndDeleteHandoffs(address, null);
807
916
  }
808
917
  async archiveCurrentSession(address, newSession) {
809
918
  this.ensureInitialized();
810
919
  // With SessionRecord, archiving is handled via SessionRecord.archiveCurrent()
811
920
  // This method updates or replaces the session state
812
- if (newSession) {
813
- const record = await this.getSessionRecord(address);
814
- if (record) {
815
- // Update existing session with new state
816
- record.currentSession = newSession;
817
- if (record.metadata) {
818
- record.metadata.lastSentAt = Date.now();
819
- }
820
- await this.storeSessionRecord(address, record);
821
- }
822
- }
823
- else {
921
+ if (!newSession) {
824
922
  // If no new session, just delete the old one
825
- await this.deleteSessionRecord(address);
923
+ await this.replaceSessionAndDeleteHandoffs(address, null);
924
+ return;
826
925
  }
926
+ const record = await this.getSessionRecord(address);
927
+ if (record) {
928
+ // Update existing session with new state
929
+ record.currentSession = newSession;
930
+ if (record.metadata) {
931
+ record.metadata.lastSentAt = Date.now();
932
+ }
933
+ assertCurrentSessionRecord(record);
934
+ }
935
+ await this.replaceSessionAndDeleteHandoffs(address, record ? await this.encrypt(serializeSessionRecord(record)) : undefined);
936
+ }
937
+ /**
938
+ * Write or delete the session of one device and delete the handoff rows of
939
+ * that device in every group, in one transaction. `null` deletes the
940
+ * session, and `undefined` leaves it.
941
+ */
942
+ async replaceSessionAndDeleteHandoffs(address, encrypted) {
943
+ const addressKey = this.serializeAddress(address);
944
+ const recipientHash = (await this.senderKeyHandoffs.index()).recipient(address);
945
+ const tx = this.db.transaction(['sessions', 'senderKeyHandoff'], 'readwrite');
946
+ await commitTransaction(tx, async (writes) => {
947
+ const sessions = tx.objectStore('sessions');
948
+ const handoffs = tx.objectStore('senderKeyHandoff');
949
+ const doomedHandoffs = await handoffs.index('by-recipient').getAllKeys(recipientHash);
950
+ if (encrypted) {
951
+ writes.push(sessions.put({
952
+ key: addressKey,
953
+ userId: address.userId,
954
+ deviceId: address.deviceId,
955
+ data: encrypted,
956
+ updatedAt: Date.now(),
957
+ }));
958
+ }
959
+ else if (encrypted === null) {
960
+ writes.push(sessions.delete(addressKey));
961
+ }
962
+ for (const handoffKey of doomedHandoffs)
963
+ writes.push(handoffs.delete(handoffKey));
964
+ });
827
965
  }
828
966
  async getSessionsForUser(userId) {
829
967
  this.ensureInitialized();
@@ -889,6 +1027,10 @@ export class IndexedDbSignalProtocolStore {
889
1027
  await this.db.clear('senderKeyRecords');
890
1028
  await this.db.clear('skippedSenderKeys');
891
1029
  await this.db.clear('messageRecords');
1030
+ for (const name of SEND_LOG_STORE_NAMES)
1031
+ await this.db.clear(name);
1032
+ await this.db.clear('receiveWork');
1033
+ await this.db.clear('senderKeyHandoff');
892
1034
  // Generate new database encryption key after clearing
893
1035
  this.databaseKey = await generateRandomBytes(32);
894
1036
  await this.db.put('metadata', this.databaseKey, 'databaseKey');
@@ -898,30 +1040,38 @@ export class IndexedDbSignalProtocolStore {
898
1040
  // ============================================================================
899
1041
  async getMetadata(key) {
900
1042
  this.ensureInitialized();
901
- const stored = await this.db.get('metadata', `meta:${key}`);
902
- return typeof stored === 'string' ? stored : null;
1043
+ return await this.openMetadataValue(await this.db.get('metadata', metadataStorageKey(key)));
903
1044
  }
904
1045
  async setMetadata(key, value) {
905
1046
  this.ensureInitialized();
906
- await this.db.put('metadata', value, `meta:${key}`);
1047
+ const sealed = await this.sealMetadataValue(value);
1048
+ await this.db.put('metadata', sealed, metadataStorageKey(key));
907
1049
  }
908
1050
  async deleteMetadata(key) {
909
1051
  this.ensureInitialized();
910
- await this.db.delete('metadata', `meta:${key}`);
1052
+ await this.db.delete('metadata', metadataStorageKey(key));
911
1053
  }
912
1054
  async compareAndSetMetadata(key, expected, value) {
913
1055
  this.ensureInitialized();
1056
+ const storageKey = metadataStorageKey(key);
1057
+ // The cipher is not an IndexedDB request, and an await on it would let
1058
+ // the transaction commit. So the decrypt and the encrypt run first. The
1059
+ // transaction then compares the raw value that was read, so a writer that
1060
+ // changed the value since that read fails the check.
1061
+ const observed = await this.db.get('metadata', storageKey);
1062
+ if ((await this.openMetadataValue(observed)) !== expected)
1063
+ return false;
1064
+ const sealed = value === null ? null : await this.sealMetadataValue(value);
914
1065
  const tx = this.db.transaction('metadata', 'readwrite');
915
1066
  try {
916
- const stored = await tx.store.get(`meta:${key}`);
917
- if ((typeof stored === 'string' ? stored : null) !== expected) {
1067
+ if (!sameStoredMetadata(await tx.store.get(storageKey), observed)) {
918
1068
  await tx.done;
919
1069
  return false;
920
1070
  }
921
- if (value === null)
922
- await tx.store.delete(`meta:${key}`);
1071
+ if (sealed === null)
1072
+ await tx.store.delete(storageKey);
923
1073
  else
924
- await tx.store.put(value, `meta:${key}`);
1074
+ await tx.store.put(sealed, storageKey);
925
1075
  await tx.done;
926
1076
  return true;
927
1077
  }
@@ -930,6 +1080,65 @@ export class IndexedDbSignalProtocolStore {
930
1080
  throw error;
931
1081
  }
932
1082
  }
1083
+ /** Encrypt one metadata value with the record cipher, behind its version byte. */
1084
+ async sealMetadataValue(value) {
1085
+ const encrypted = await this.encrypt(value);
1086
+ const sealed = new Uint8Array(1 + encrypted.length);
1087
+ sealed[0] = METADATA_CIPHER_VERSION;
1088
+ sealed.set(encrypted, 1);
1089
+ return sealed;
1090
+ }
1091
+ /** Read one stored metadata value, encrypted or clear. */
1092
+ async openMetadataValue(stored) {
1093
+ if (typeof stored === 'string')
1094
+ return stored;
1095
+ if (!(stored instanceof Uint8Array))
1096
+ return null;
1097
+ if (stored[0] !== METADATA_CIPHER_VERSION) {
1098
+ throw new Error(`Unsupported metadata cipher version ${stored[0]}`);
1099
+ }
1100
+ return await this.decrypt(stored.subarray(1));
1101
+ }
1102
+ /**
1103
+ * Encrypt every clear metadata value, then set the marker. The marker is
1104
+ * set last, so a crash partway leaves it unset and the next open runs the
1105
+ * migration again. Each value is replaced only while it still holds the
1106
+ * clear value that was read, so a concurrent writer is never overwritten.
1107
+ *
1108
+ * A full origin stops the migration without the marker. The store still
1109
+ * opens, because a reader accepts clear values, and the next open
1110
+ * continues the migration.
1111
+ */
1112
+ async encryptClearMetadata() {
1113
+ const db = this.db;
1114
+ if ((await db.get('metadata', METADATA_CIPHER_MARKER_KEY)) === METADATA_CIPHER_VERSION)
1115
+ return;
1116
+ const prefix = metadataStorageKey('');
1117
+ const keys = (await db.getAllKeys('metadata')).filter((key) => key.startsWith(prefix));
1118
+ try {
1119
+ for (const key of keys) {
1120
+ const stored = await db.get('metadata', key);
1121
+ if (typeof stored !== 'string')
1122
+ continue;
1123
+ const sealed = await this.sealMetadataValue(stored);
1124
+ const tx = db.transaction('metadata', 'readwrite');
1125
+ try {
1126
+ if ((await tx.store.get(key)) === stored)
1127
+ await tx.store.put(sealed, key);
1128
+ await tx.done;
1129
+ }
1130
+ catch (error) {
1131
+ await tx.done.catch(() => undefined);
1132
+ throw error;
1133
+ }
1134
+ }
1135
+ await db.put('metadata', METADATA_CIPHER_VERSION, METADATA_CIPHER_MARKER_KEY);
1136
+ }
1137
+ catch (error) {
1138
+ if (!isQuotaExceededError(error))
1139
+ throw error;
1140
+ }
1141
+ }
933
1142
  // ============================================================================
934
1143
  // Private Helper Methods
935
1144
  // ============================================================================
@@ -1026,7 +1235,7 @@ export class IndexedDbSignalProtocolStore {
1026
1235
  const session = await this.getSessionRecord(ProtocolAddress.create(userId, deviceId));
1027
1236
  return withSession(userId, deviceId, stored, session);
1028
1237
  }
1029
- async setDeviceRecord(userId, deviceId, record) {
1238
+ async setDeviceRecord(userId, deviceId, record, options) {
1030
1239
  if (record.session)
1031
1240
  assertCurrentSessionRecord(record.session);
1032
1241
  const now = Date.now();
@@ -1044,20 +1253,29 @@ export class IndexedDbSignalProtocolStore {
1044
1253
  const session = record.session
1045
1254
  ? await this.encrypt(serializeSessionRecord(record.session))
1046
1255
  : null;
1047
- const tx = this.db.transaction(['sesameUsers', 'sessions'], 'readwrite');
1048
- const writes = [
1049
- tx.objectStore('sesameUsers').put({ key: userId, data: user, updatedAt: now }),
1050
- ];
1051
- if (session) {
1052
- writes.push(tx.objectStore('sessions').put({
1053
- key: this.serializeAddress(ProtocolAddress.create(userId, deviceId)),
1054
- userId,
1055
- deviceId,
1056
- data: session,
1057
- updatedAt: now,
1058
- }));
1059
- }
1060
- await Promise.all([...writes, tx.done]);
1256
+ const invalidation = options?.senderKeyHandoffInvalidation;
1257
+ const invalidatedHash = invalidation
1258
+ ? (await this.senderKeyHandoffs.index()).recipient(invalidation)
1259
+ : undefined;
1260
+ const tx = this.db.transaction(['sesameUsers', 'sessions', 'senderKeyHandoff'], 'readwrite');
1261
+ await commitTransaction(tx, async (writes) => {
1262
+ const handoffs = tx.objectStore('senderKeyHandoff');
1263
+ const doomedHandoffs = invalidatedHash === undefined
1264
+ ? []
1265
+ : await handoffs.index('by-recipient').getAllKeys(invalidatedHash);
1266
+ writes.push(tx.objectStore('sesameUsers').put({ key: userId, data: user, updatedAt: now }));
1267
+ if (session) {
1268
+ writes.push(tx.objectStore('sessions').put({
1269
+ key: this.serializeAddress(ProtocolAddress.create(userId, deviceId)),
1270
+ userId,
1271
+ deviceId,
1272
+ data: session,
1273
+ updatedAt: now,
1274
+ }));
1275
+ }
1276
+ for (const handoffKey of doomedHandoffs)
1277
+ writes.push(handoffs.delete(handoffKey));
1278
+ });
1061
1279
  }
1062
1280
  async deleteDeviceRecord(userId, deviceId) {
1063
1281
  const now = Date.now();
@@ -1069,14 +1287,20 @@ export class IndexedDbSignalProtocolStore {
1069
1287
  // A device can exist through its session alone, so the session goes even
1070
1288
  // when no stored user record names the device.
1071
1289
  const sessionKey = this.serializeAddress(ProtocolAddress.create(userId, deviceId));
1072
- const tx = this.db.transaction(['sesameUsers', 'sessions'], 'readwrite');
1073
- const users = tx.objectStore('sesameUsers');
1074
- const writes = [tx.objectStore('sessions').delete(sessionKey)];
1075
- if (user)
1076
- writes.push(users.put({ key: userId, data: user, updatedAt: now }));
1077
- else if (userRecord)
1078
- writes.push(users.delete(userId));
1079
- await Promise.all([...writes, tx.done]);
1290
+ const recipientHash = (await this.senderKeyHandoffs.index()).recipient({ userId, deviceId });
1291
+ const tx = this.db.transaction(['sesameUsers', 'sessions', 'senderKeyHandoff'], 'readwrite');
1292
+ await commitTransaction(tx, async (writes) => {
1293
+ const users = tx.objectStore('sesameUsers');
1294
+ const handoffs = tx.objectStore('senderKeyHandoff');
1295
+ const doomedHandoffs = await handoffs.index('by-recipient').getAllKeys(recipientHash);
1296
+ writes.push(tx.objectStore('sessions').delete(sessionKey));
1297
+ if (user)
1298
+ writes.push(users.put({ key: userId, data: user, updatedAt: now }));
1299
+ else if (userRecord)
1300
+ writes.push(users.delete(userId));
1301
+ for (const handoffKey of doomedHandoffs)
1302
+ writes.push(handoffs.delete(handoffKey));
1303
+ });
1080
1304
  }
1081
1305
  async getStoredUserRecord(userId) {
1082
1306
  this.ensureInitialized();
@@ -1176,9 +1400,21 @@ export class IndexedDbSignalProtocolStore {
1176
1400
  const record = await this.getSenderKeyRecord(groupId, userId, deviceId);
1177
1401
  return record?.[0] ?? null;
1178
1402
  }
1179
- async deleteSenderKey(groupId, userId, deviceId) {
1403
+ async deleteSenderKey(groupId, userId, deviceId, options) {
1180
1404
  this.ensureInitialized();
1181
- await this.db.delete('senderKeyRecords', [groupId, userId, deviceId]);
1405
+ if (!options?.deleteSenderKeyHandoffs) {
1406
+ await this.db.delete('senderKeyRecords', [groupId, userId, deviceId]);
1407
+ return;
1408
+ }
1409
+ const groupHash = (await this.senderKeyHandoffs.index()).group(groupId);
1410
+ const tx = this.db.transaction(['senderKeyRecords', 'senderKeyHandoff'], 'readwrite');
1411
+ await commitTransaction(tx, async (writes) => {
1412
+ const handoffs = tx.objectStore('senderKeyHandoff');
1413
+ const doomedHandoffs = await handoffs.index('by-group').getAllKeys(groupHash);
1414
+ writes.push(tx.objectStore('senderKeyRecords').delete([groupId, userId, deviceId]));
1415
+ for (const handoffKey of doomedHandoffs)
1416
+ writes.push(handoffs.delete(handoffKey));
1417
+ });
1182
1418
  }
1183
1419
  async resolveGroupForSenderKeyId(senderKeyId, userId, deviceId) {
1184
1420
  this.ensureInitialized();
@@ -1222,30 +1458,39 @@ export class IndexedDbSignalProtocolStore {
1222
1458
  async deleteAllSenderKeysForGroup(groupId) {
1223
1459
  this.ensureInitialized();
1224
1460
  // Read the doomed keys before mutating, then enter every delete in one
1225
- // synchronous batch, so the sender keys and skipped keys go together.
1226
- const tx = this.db.transaction(['senderKeyRecords', 'skippedSenderKeys'], 'readwrite');
1227
- const senderKeyRecords = tx.objectStore('senderKeyRecords');
1228
- const skippedSenderKeys = tx.objectStore('skippedSenderKeys');
1229
- const [recordKeys, skippedKeys] = await Promise.all([
1230
- senderKeyRecords.index('by-group').getAllKeys(groupId),
1231
- skippedSenderKeys.index('by-group').getAllKeys(groupId),
1232
- ]);
1233
- await Promise.all([
1234
- ...recordKeys.map((key) => senderKeyRecords.delete(key)),
1235
- ...skippedKeys.map((key) => skippedSenderKeys.delete(key)),
1236
- tx.done,
1237
- ]);
1238
- return recordKeys.length;
1239
- }
1240
- async storeSenderKeyRecord(groupId, userId, deviceId, states, receive) {
1461
+ // synchronous batch, so the sender keys, the skipped keys, and the
1462
+ // handoff rows go together.
1463
+ const groupHash = (await this.senderKeyHandoffs.index()).group(groupId);
1464
+ const tx = this.db.transaction(['senderKeyRecords', 'skippedSenderKeys', 'senderKeyHandoff'], 'readwrite');
1465
+ let deleted = 0;
1466
+ await commitTransaction(tx, async (writes) => {
1467
+ const senderKeyRecords = tx.objectStore('senderKeyRecords');
1468
+ const skippedSenderKeys = tx.objectStore('skippedSenderKeys');
1469
+ const handoffs = tx.objectStore('senderKeyHandoff');
1470
+ const [recordKeys, skippedKeys, handoffKeys] = await Promise.all([
1471
+ senderKeyRecords.index('by-group').getAllKeys(groupId),
1472
+ skippedSenderKeys.index('by-group').getAllKeys(groupId),
1473
+ handoffs.index('by-group').getAllKeys(groupHash),
1474
+ ]);
1475
+ deleted = recordKeys.length;
1476
+ // Push each request as it is created. A later synchronous throw must
1477
+ // not leave an earlier request outside the settled set.
1478
+ for (const key of recordKeys)
1479
+ writes.push(senderKeyRecords.delete(key));
1480
+ for (const key of skippedKeys)
1481
+ writes.push(skippedSenderKeys.delete(key));
1482
+ for (const key of handoffKeys)
1483
+ writes.push(handoffs.delete(key));
1484
+ });
1485
+ return deleted;
1486
+ }
1487
+ async storeSenderKeyRecord(groupId, userId, deviceId, states, receive, options) {
1241
1488
  this.ensureInitialized();
1242
1489
  if (states.length === 0) {
1243
1490
  return;
1244
1491
  }
1245
1492
  const encrypted = await this.encrypt(JSON.stringify(states));
1246
- const content = receive?.content
1247
- ? await this.encrypt(JSON.stringify(receive.content))
1248
- : undefined;
1493
+ const work = receive?.work ? await this.receiveWork.seal(receive.work) : undefined;
1249
1494
  // Finish encryption before opening the IDB transaction, which must not await crypto.
1250
1495
  const skippedKeys = await Promise.all((receive?.skippedKeys?.keys ?? []).map(async (skipped) => ({
1251
1496
  key: this.getSkippedSenderKeyStorageKey(groupId, userId, deviceId, skipped.senderKeyId, skipped.chainIndex),
@@ -1255,7 +1500,10 @@ export class IndexedDbSignalProtocolStore {
1255
1500
  data: await this.encrypt(JSON.stringify(skipped.messageKey)),
1256
1501
  createdAt: Date.now(),
1257
1502
  })));
1258
- const tx = this.db.transaction(['senderKeyRecords', 'skippedSenderKeys', 'metadata'], 'readwrite');
1503
+ const deletedGroupHash = options?.deleteSenderKeyHandoffs
1504
+ ? (await this.senderKeyHandoffs.index()).group(groupId)
1505
+ : undefined;
1506
+ const tx = this.db.transaction(['senderKeyRecords', 'skippedSenderKeys', 'receiveWork', 'senderKeyHandoff'], 'readwrite');
1259
1507
  // Observe aborts immediately, including while the skipped-key read is pending.
1260
1508
  const completed = tx.done;
1261
1509
  void completed.catch(() => undefined);
@@ -1271,6 +1519,10 @@ export class IndexedDbSignalProtocolStore {
1271
1519
  .index('by-sender')
1272
1520
  .getAll(this.getSkippedSenderKeyPrefix(groupId, userId, deviceId))).map(({ key, chainIndex }) => ({ key, chainIndex }))
1273
1521
  : [];
1522
+ const handoffs = tx.objectStore('senderKeyHandoff');
1523
+ const doomedHandoffs = deletedGroupHash === undefined
1524
+ ? []
1525
+ : await handoffs.index('by-group').getAllKeys(deletedGroupHash);
1274
1526
  const sameKey = (a, b) => a.every((part, index) => part === b[index]);
1275
1527
  const skippedWrites = [];
1276
1528
  for (const skipped of skippedKeys) {
@@ -1303,9 +1555,10 @@ export class IndexedDbSignalProtocolStore {
1303
1555
  for (const write of skippedWrites) {
1304
1556
  writes.push('put' in write ? skippedStore.put(write.put) : skippedStore.delete(write.delete));
1305
1557
  }
1306
- if (receive?.content && content) {
1307
- writes.push(tx.objectStore('metadata').put(content, receivedContentKey(receive.content.id)));
1308
- }
1558
+ if (work)
1559
+ writes.push(tx.objectStore('receiveWork').put(work));
1560
+ for (const handoffKey of doomedHandoffs)
1561
+ writes.push(handoffs.delete(handoffKey));
1309
1562
  await Promise.all([...writes, completed]);
1310
1563
  }
1311
1564
  catch (error) {
@@ -1319,34 +1572,124 @@ export class IndexedDbSignalProtocolStore {
1319
1572
  throw error;
1320
1573
  }
1321
1574
  }
1322
- async getReceivedContent(id) {
1575
+ // ============================================================================
1576
+ // Sender-Key Handoff Ledger
1577
+ // ============================================================================
1578
+ async recordSenderKeyHandoff(record) {
1323
1579
  this.ensureInitialized();
1324
- const value = await this.db.get('metadata', receivedContentKey(id));
1325
- if (value === undefined)
1326
- return null;
1327
- if (!(value instanceof Uint8Array))
1328
- throw new Error('Invalid encrypted received content');
1329
- return parseReceivedContent(await this.decrypt(value), id);
1580
+ await this.senderKeyHandoffs.record(record);
1330
1581
  }
1331
- async deleteReceivedContent(id) {
1582
+ async listSenderKeyHandoffs(groupId, generation) {
1332
1583
  this.ensureInitialized();
1333
- await this.db.delete('metadata', receivedContentKey(id));
1584
+ return this.senderKeyHandoffs.list(groupId, generation);
1334
1585
  }
1335
- async deleteExpiredReceivedContent(before) {
1586
+ async invalidateSenderKeyHandoff(groupId, device) {
1336
1587
  this.ensureInitialized();
1337
- const prefix = receivedContentKey('');
1338
- const keys = (await this.db.getAllKeys('metadata')).filter((key) => key.startsWith(prefix));
1339
- const expired = [];
1340
- for (const key of keys) {
1341
- const value = await this.getReceivedContent(key.slice(prefix.length));
1342
- if (value && value.receivedAt < before)
1343
- expired.push(key);
1588
+ return this.senderKeyHandoffs.deleteDeviceInGroup(groupId, device);
1589
+ }
1590
+ async invalidateAccountSenderKeyHandoffs(userId) {
1591
+ this.ensureInitialized();
1592
+ return this.senderKeyHandoffs.deleteAccount(userId);
1593
+ }
1594
+ async listSenderKeyHandoffGroupIds() {
1595
+ this.ensureInitialized();
1596
+ return this.senderKeyHandoffs.groupIds();
1597
+ }
1598
+ async retainSenderKeyHandoffs(groupId, senderKeyId) {
1599
+ this.ensureInitialized();
1600
+ return this.senderKeyHandoffs.retain(groupId, senderKeyId);
1601
+ }
1602
+ // ============================================================================
1603
+ // Receive records
1604
+ // ============================================================================
1605
+ async getReceiveWork(workId) {
1606
+ this.ensureInitialized();
1607
+ return await this.receiveWork.get(workId);
1608
+ }
1609
+ async putReceiveWork(record, expectedRevision) {
1610
+ this.ensureInitialized();
1611
+ return await this.receiveWork.put(record, expectedRevision);
1612
+ }
1613
+ async listReceiveWork(query) {
1614
+ this.ensureInitialized();
1615
+ return await this.receiveWork.list(query);
1616
+ }
1617
+ async receiveWorkUsage(query) {
1618
+ this.ensureInitialized();
1619
+ return await this.receiveWork.usage(query);
1620
+ }
1621
+ async completeReceiveWork(workId, expectedRevision, metadata = []) {
1622
+ this.ensureInitialized();
1623
+ // Seal every metadata value first: the transaction must not await the cipher.
1624
+ const metadataWrites = await Promise.all(metadata.map(async ({ key, value }) => ({
1625
+ storageKey: metadataStorageKey(key),
1626
+ sealed: value === null ? null : await this.sealMetadataValue(value),
1627
+ })));
1628
+ const tx = this.db.transaction(['receiveWork', 'metadata'], 'readwrite');
1629
+ const completed = tx.done;
1630
+ void completed.catch(() => undefined);
1631
+ const writes = [];
1632
+ try {
1633
+ const records = tx.objectStore('receiveWork');
1634
+ const current = await records.get(workId);
1635
+ if (current?.revision !== expectedRevision) {
1636
+ await completed;
1637
+ return false;
1638
+ }
1639
+ // Enter the delete and every metadata write in one synchronous batch.
1640
+ const metadataStore = tx.objectStore('metadata');
1641
+ writes.push(records.delete(workId));
1642
+ for (const { storageKey, sealed } of metadataWrites) {
1643
+ writes.push(sealed === null ? metadataStore.delete(storageKey) : metadataStore.put(sealed, storageKey));
1644
+ }
1645
+ await Promise.all([...writes, completed]);
1646
+ return true;
1344
1647
  }
1345
- if (expired.length) {
1346
- const tx = this.db.transaction('metadata', 'readwrite');
1347
- await Promise.all([...expired.map((key) => tx.store.delete(key)), tx.done]);
1648
+ catch (error) {
1649
+ try {
1650
+ tx.abort();
1651
+ }
1652
+ catch {
1653
+ /* The failed transaction can already be inactive. */
1654
+ }
1655
+ await Promise.allSettled([...writes, completed]);
1656
+ throw error;
1348
1657
  }
1349
- return expired.length;
1658
+ }
1659
+ /**
1660
+ * Convert the legacy received content rows to receive records. A full
1661
+ * origin stops the conversion without its marker. The store still opens,
1662
+ * and the next open continues the conversion.
1663
+ */
1664
+ async convertLegacyReceivedRows() {
1665
+ try {
1666
+ await convertLegacyReceivedContent(this, this.legacyReceivedContent());
1667
+ }
1668
+ catch (error) {
1669
+ if (!isQuotaExceededError(error) && !(error instanceof StorageQuotaExceededError)) {
1670
+ throw error;
1671
+ }
1672
+ }
1673
+ }
1674
+ /** The legacy rows: raw metadata keys `received-content:<id>`, each value from the record cipher. */
1675
+ legacyReceivedContent() {
1676
+ const prefix = receivedContentKey('');
1677
+ return {
1678
+ listIds: async () => (await this.db.getAllKeys('metadata'))
1679
+ .filter((key) => key.startsWith(prefix))
1680
+ .map((key) => key.slice(prefix.length)),
1681
+ read: async (id) => {
1682
+ const value = await this.db.get('metadata', receivedContentKey(id));
1683
+ if (value === undefined)
1684
+ return null;
1685
+ if (!(value instanceof Uint8Array))
1686
+ throw new Error('Invalid encrypted received content');
1687
+ return await this.decrypt(value);
1688
+ },
1689
+ delete: async (id) => {
1690
+ await this.db.delete('metadata', receivedContentKey(id));
1691
+ },
1692
+ };
1350
1693
  }
1351
1694
  async getSenderKeyRecord(groupId, userId, deviceId) {
1352
1695
  this.ensureInitialized();
@@ -1415,12 +1758,14 @@ export class IndexedDbSignalProtocolStore {
1415
1758
  // ============================================================================
1416
1759
  async storeMessageRecord(record) {
1417
1760
  this.ensureInitialized();
1418
- const encrypted = await this.encrypt(JSON.stringify(record));
1761
+ const key = this.getMessageRecordStorageKey(record.sessionId, record.timestamp);
1762
+ const createdAt = (await this.db.get('messageRecords', key))?.createdAt ?? Date.now();
1763
+ const encrypted = await this.encrypt(JSON.stringify({ ...record, createdAt }));
1419
1764
  await this.db.put('messageRecords', {
1420
- key: this.getMessageRecordStorageKey(record.sessionId, record.timestamp),
1765
+ key,
1421
1766
  sessionId: record.sessionId,
1422
1767
  timestamp: record.timestamp,
1423
- createdAt: record.createdAt,
1768
+ createdAt,
1424
1769
  data: encrypted,
1425
1770
  });
1426
1771
  }
@@ -1468,6 +1813,111 @@ export class IndexedDbSignalProtocolStore {
1468
1813
  await Promise.all(matches.map((key) => this.db.delete('messageRecords', key)));
1469
1814
  return matches.length;
1470
1815
  }
1816
+ /**
1817
+ * The records decrypt and encrypt outside a transaction, because IndexedDB
1818
+ * commits an idle transaction. The write transaction then changes a record
1819
+ * only when its stored bytes still equal the bytes that `rewrite` read.
1820
+ */
1821
+ async rewriteMessageRecords(rewrite) {
1822
+ this.ensureInitialized();
1823
+ const selected = [];
1824
+ for (const stored of await this.db.getAll('messageRecords')) {
1825
+ const record = JSON.parse(await this.decrypt(stored.data));
1826
+ const plaintext = rewrite(record);
1827
+ if (plaintext === record.plaintext)
1828
+ continue;
1829
+ const replacement = plaintext === null ? null : await this.encrypt(JSON.stringify({ ...record, plaintext }));
1830
+ selected.push({ key: stored.key, data: stored.data, replacement });
1831
+ }
1832
+ if (selected.length === 0)
1833
+ return 0;
1834
+ const tx = this.db.transaction('messageRecords', 'readwrite');
1835
+ const store = tx.objectStore('messageRecords');
1836
+ let changed = 0;
1837
+ for (const { key, data, replacement } of selected) {
1838
+ const current = await store.get(key);
1839
+ if (!current || !encryptedBytesEqual(current.data, data))
1840
+ continue;
1841
+ if (replacement === null) {
1842
+ await store.delete(key);
1843
+ }
1844
+ else {
1845
+ await store.put({ ...current, data: replacement });
1846
+ }
1847
+ changed++;
1848
+ }
1849
+ await tx.done;
1850
+ return changed;
1851
+ }
1852
+ // ============================================================================
1853
+ // Send Log (resendable group content)
1854
+ // The send log concept lives in ./send-log.ts. This store implements the
1855
+ // whole local store interface, so it keeps these delegates.
1856
+ // ============================================================================
1857
+ async storeSendLogEntry(payload, recipients) {
1858
+ this.ensureInitialized();
1859
+ return this.sendLog.storeSendLogEntry(payload, recipients);
1860
+ }
1861
+ async appendSendLogRecipients(clientMessageId, recipients) {
1862
+ this.ensureInitialized();
1863
+ return this.sendLog.appendSendLogRecipients(clientMessageId, recipients);
1864
+ }
1865
+ async markSendLogComplete(clientMessageId) {
1866
+ this.ensureInitialized();
1867
+ return this.sendLog.markSendLogComplete(clientMessageId);
1868
+ }
1869
+ async getSendLogEntry(clientMessageId, recipient) {
1870
+ this.ensureInitialized();
1871
+ return this.sendLog.getSendLogEntry(clientMessageId, recipient);
1872
+ }
1873
+ async findSendLogEntries(recipient, clientTimestamp) {
1874
+ this.ensureInitialized();
1875
+ return this.sendLog.findSendLogEntries(recipient, clientTimestamp);
1876
+ }
1877
+ async getSendLogRecipients(clientMessageId) {
1878
+ this.ensureInitialized();
1879
+ return this.sendLog.getSendLogRecipients(clientMessageId);
1880
+ }
1881
+ async deleteSendLogRecipient(clientMessageId, recipient) {
1882
+ this.ensureInitialized();
1883
+ return this.sendLog.deleteSendLogRecipient(clientMessageId, recipient);
1884
+ }
1885
+ async deleteSendLogRecipientsByTimestamp(recipient, clientTimestamps) {
1886
+ this.ensureInitialized();
1887
+ return this.sendLog.deleteSendLogRecipientsByTimestamp(recipient, clientTimestamps);
1888
+ }
1889
+ async incrementSendLogResendCount(clientMessageId, recipient) {
1890
+ this.ensureInitialized();
1891
+ return this.sendLog.incrementSendLogResendCount(clientMessageId, recipient);
1892
+ }
1893
+ async deleteSendLogEntry(clientMessageId) {
1894
+ this.ensureInitialized();
1895
+ return this.sendLog.deleteSendLogEntry(clientMessageId);
1896
+ }
1897
+ async deleteExpiredSendLog(maxAgeMs) {
1898
+ this.ensureInitialized();
1899
+ return this.sendLog.deleteExpiredSendLog(maxAgeMs);
1900
+ }
1901
+ async clearSendLog() {
1902
+ this.ensureInitialized();
1903
+ return this.sendLog.clearSendLog();
1904
+ }
1905
+ async storeResendJob(job) {
1906
+ this.ensureInitialized();
1907
+ return this.sendLog.storeResendJob(job);
1908
+ }
1909
+ async getResendJob(jobId) {
1910
+ this.ensureInitialized();
1911
+ return this.sendLog.getResendJob(jobId);
1912
+ }
1913
+ async getPendingResendJobs() {
1914
+ this.ensureInitialized();
1915
+ return this.sendLog.getPendingResendJobs();
1916
+ }
1917
+ async completeResendJob(jobId, state) {
1918
+ this.ensureInitialized();
1919
+ return this.sendLog.completeResendJob(jobId, state);
1920
+ }
1471
1921
  // ============================================================================
1472
1922
  // Key Recovery Methods (Bug #7 - Identifier Collision Recovery)
1473
1923
  // ============================================================================
@@ -1571,12 +2021,14 @@ export class IndexedDbSignalProtocolStore {
1571
2021
  }
1572
2022
  /**
1573
2023
  * A device record is stale when it has no current session and no archived
1574
- * session, and it has not been updated within `maxLatency`.
2024
+ * session, and it has not been updated within `maxLatency`, or when its
2025
+ * removal is older than `maxLatency`.
1575
2026
  */
1576
2027
  function isStaleDeviceRecord(record, now, maxLatency) {
1577
2028
  const hasNoSessions = !record.session ||
1578
2029
  (!record.session.currentSession && Object.keys(record.session.archivedSessions).length === 0);
1579
- return hasNoSessions && now - record.updatedAt > maxLatency;
2030
+ return ((hasNoSessions && now - record.updatedAt > maxLatency) ||
2031
+ isExpiredRemovedDevice(record, now, maxLatency));
1580
2032
  }
1581
2033
  /**
1582
2034
  * Delete the sessions of `record` that are older than `maxRecv`, and return