@open-e2ee/signal-protocol-sdk 11.0.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 (583) hide show
  1. package/ADAPTERS.md +4 -4
  2. package/ARCHITECTURE.md +6 -8
  3. package/CHANGELOG.md +1315 -0
  4. package/README.md +1 -1
  5. package/SECURITY.md +2 -2
  6. package/TROUBLESHOOTING.md +1 -1
  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 +1168 -184
  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 +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 +20 -19
  251. package/dist/internal/manager/manager.d.ts.map +1 -1
  252. package/dist/internal/manager/manager.js +56 -39
  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 +13 -11
  313. package/dist/internal/session/cipher.d.ts.map +1 -1
  314. package/dist/internal/session/cipher.js +40 -22
  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 +4 -12
  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/encryption.d.ts +8 -1
  416. package/dist/local/store/sqlite/encryption.d.ts.map +1 -1
  417. package/dist/local/store/sqlite/encryption.js +9 -0
  418. package/dist/local/store/sqlite/encryption.js.map +1 -1
  419. package/dist/local/store/sqlite/key-storage/index.d.ts +25 -4
  420. package/dist/local/store/sqlite/key-storage/index.d.ts.map +1 -1
  421. package/dist/local/store/sqlite/key-storage/index.js +68 -7
  422. package/dist/local/store/sqlite/key-storage/index.js.map +1 -1
  423. package/dist/local/store/sqlite/key-storage/message-records.d.ts +16 -4
  424. package/dist/local/store/sqlite/key-storage/message-records.d.ts.map +1 -1
  425. package/dist/local/store/sqlite/key-storage/message-records.js +49 -6
  426. package/dist/local/store/sqlite/key-storage/message-records.js.map +1 -1
  427. package/dist/local/store/sqlite/key-storage/metadata.d.ts +8 -7
  428. package/dist/local/store/sqlite/key-storage/metadata.d.ts.map +1 -1
  429. package/dist/local/store/sqlite/key-storage/metadata.js +17 -15
  430. package/dist/local/store/sqlite/key-storage/metadata.js.map +1 -1
  431. package/dist/local/store/sqlite/key-storage/receive-work.d.ts +27 -0
  432. package/dist/local/store/sqlite/key-storage/receive-work.d.ts.map +1 -0
  433. package/dist/local/store/sqlite/key-storage/receive-work.js +98 -0
  434. package/dist/local/store/sqlite/key-storage/receive-work.js.map +1 -0
  435. package/dist/local/store/sqlite/key-storage/send-log.d.ts +27 -0
  436. package/dist/local/store/sqlite/key-storage/send-log.d.ts.map +1 -0
  437. package/dist/local/store/sqlite/key-storage/send-log.js +178 -0
  438. package/dist/local/store/sqlite/key-storage/send-log.js.map +1 -0
  439. package/dist/local/store/sqlite/key-storage/sender-key-handoff.d.ts +27 -0
  440. package/dist/local/store/sqlite/key-storage/sender-key-handoff.d.ts.map +1 -0
  441. package/dist/local/store/sqlite/key-storage/sender-key-handoff.js +75 -0
  442. package/dist/local/store/sqlite/key-storage/sender-key-handoff.js.map +1 -0
  443. package/dist/local/store/sqlite/key-storage/session-trust.d.ts +2 -2
  444. package/dist/local/store/sqlite/key-storage/session-trust.js +5 -5
  445. package/dist/local/store/sqlite/key-storage/session-trust.js.map +1 -1
  446. package/dist/local/store/sqlite/migrations.d.ts.map +1 -1
  447. package/dist/local/store/sqlite/migrations.js +101 -0
  448. package/dist/local/store/sqlite/migrations.js.map +1 -1
  449. package/dist/local/store/sqlite/models/index.d.ts +2 -1
  450. package/dist/local/store/sqlite/models/index.d.ts.map +1 -1
  451. package/dist/local/store/sqlite/models/index.js +5 -1
  452. package/dist/local/store/sqlite/models/index.js.map +1 -1
  453. package/dist/local/store/sqlite/models/message-record.d.ts +15 -0
  454. package/dist/local/store/sqlite/models/message-record.d.ts.map +1 -1
  455. package/dist/local/store/sqlite/models/message-record.js +24 -0
  456. package/dist/local/store/sqlite/models/message-record.js.map +1 -1
  457. package/dist/local/store/sqlite/models/send-log.d.ts +51 -0
  458. package/dist/local/store/sqlite/models/send-log.d.ts.map +1 -0
  459. package/dist/local/store/sqlite/models/send-log.js +206 -0
  460. package/dist/local/store/sqlite/models/send-log.js.map +1 -0
  461. package/dist/local/store/sqlite/open-store.d.ts +9 -1
  462. package/dist/local/store/sqlite/open-store.d.ts.map +1 -1
  463. package/dist/local/store/sqlite/open-store.js +20 -1
  464. package/dist/local/store/sqlite/open-store.js.map +1 -1
  465. package/dist/local/store/sqlite/schema.d.ts +34 -1
  466. package/dist/local/store/sqlite/schema.d.ts.map +1 -1
  467. package/dist/local/store/sqlite/schema.js +14 -0
  468. package/dist/local/store/sqlite/schema.js.map +1 -1
  469. package/dist/local/store/sqlite/store.d.ts +61 -11
  470. package/dist/local/store/sqlite/store.d.ts.map +1 -1
  471. package/dist/local/store/sqlite/store.js +191 -27
  472. package/dist/local/store/sqlite/store.js.map +1 -1
  473. package/dist/local/store/web/adapter.d.ts +76 -8
  474. package/dist/local/store/web/adapter.d.ts.map +1 -1
  475. package/dist/local/store/web/adapter.js +579 -127
  476. package/dist/local/store/web/adapter.js.map +1 -1
  477. package/dist/local/store/web/receive-work.d.ts +57 -0
  478. package/dist/local/store/web/receive-work.d.ts.map +1 -0
  479. package/dist/local/store/web/receive-work.js +99 -0
  480. package/dist/local/store/web/receive-work.js.map +1 -0
  481. package/dist/local/store/web/send-log.d.ts +92 -0
  482. package/dist/local/store/web/send-log.d.ts.map +1 -0
  483. package/dist/local/store/web/send-log.js +267 -0
  484. package/dist/local/store/web/send-log.js.map +1 -0
  485. package/dist/local/store/web/sender-key-handoff.d.ts +81 -0
  486. package/dist/local/store/web/sender-key-handoff.d.ts.map +1 -0
  487. package/dist/local/store/web/sender-key-handoff.js +156 -0
  488. package/dist/local/store/web/sender-key-handoff.js.map +1 -0
  489. package/dist/local/store/web-sqlite/adapter.d.ts +2 -0
  490. package/dist/local/store/web-sqlite/adapter.d.ts.map +1 -1
  491. package/dist/local/store/web-sqlite/adapter.js +12 -6
  492. package/dist/local/store/web-sqlite/adapter.js.map +1 -1
  493. package/dist/local/vault/custody.d.ts +8 -0
  494. package/dist/local/vault/custody.d.ts.map +1 -0
  495. package/dist/local/vault/custody.js +9 -0
  496. package/dist/local/vault/custody.js.map +1 -0
  497. package/dist/local/vault/electron-safe-storage.d.ts +3 -1
  498. package/dist/local/vault/electron-safe-storage.d.ts.map +1 -1
  499. package/dist/local/vault/electron-safe-storage.js +2 -0
  500. package/dist/local/vault/electron-safe-storage.js.map +1 -1
  501. package/dist/local/vault/expo-secure-store.d.ts +3 -1
  502. package/dist/local/vault/expo-secure-store.d.ts.map +1 -1
  503. package/dist/local/vault/expo-secure-store.js +2 -0
  504. package/dist/local/vault/expo-secure-store.js.map +1 -1
  505. package/dist/local/vault/indexed-db.d.ts +3 -1
  506. package/dist/local/vault/indexed-db.d.ts.map +1 -1
  507. package/dist/local/vault/indexed-db.js +2 -0
  508. package/dist/local/vault/indexed-db.js.map +1 -1
  509. package/dist/local/vault/react-native-keychain.d.ts +3 -1
  510. package/dist/local/vault/react-native-keychain.d.ts.map +1 -1
  511. package/dist/local/vault/react-native-keychain.js +2 -0
  512. package/dist/local/vault/react-native-keychain.js.map +1 -1
  513. package/dist/remote/relay/device-set.d.ts +94 -0
  514. package/dist/remote/relay/device-set.d.ts.map +1 -0
  515. package/dist/remote/relay/device-set.js +156 -0
  516. package/dist/remote/relay/device-set.js.map +1 -0
  517. package/dist/remote/relay/types.d.ts +92 -107
  518. package/dist/remote/relay/types.d.ts.map +1 -1
  519. package/dist/safety/core.d.ts +15 -6
  520. package/dist/safety/core.d.ts.map +1 -1
  521. package/dist/safety/core.js +41 -27
  522. package/dist/safety/core.js.map +1 -1
  523. package/dist/safety/index.d.ts +2 -1
  524. package/dist/safety/index.d.ts.map +1 -1
  525. package/dist/safety/index.js +12 -18
  526. package/dist/safety/index.js.map +1 -1
  527. package/dist/types/api.d.ts +707 -62
  528. package/dist/types/api.d.ts.map +1 -1
  529. package/dist/types/errors.d.ts +14 -33
  530. package/dist/types/errors.d.ts.map +1 -1
  531. package/dist/types/errors.js +14 -24
  532. package/dist/types/errors.js.map +1 -1
  533. package/dist/types/messages.d.ts +2 -2
  534. package/dist/types/messages.js +1 -1
  535. package/dist/types/protocol-config.d.ts +175 -42
  536. package/dist/types/protocol-config.d.ts.map +1 -1
  537. package/dist/types/protocol-config.js +19 -38
  538. package/dist/types/protocol-config.js.map +1 -1
  539. package/dist/types/protocol-constants.d.ts +6 -6
  540. package/dist/types/protocol-constants.js +6 -6
  541. package/dist/types/session.d.ts +7 -7
  542. package/dist/types/session.d.ts.map +1 -1
  543. package/dist/types/session.js +39 -21
  544. package/dist/types/session.js.map +1 -1
  545. package/dist/username/link.d.ts +2 -2
  546. package/dist/username/link.js +2 -2
  547. package/dist/utils/origin-lock.d.ts +45 -0
  548. package/dist/utils/origin-lock.d.ts.map +1 -0
  549. package/dist/utils/origin-lock.js +80 -0
  550. package/dist/utils/origin-lock.js.map +1 -0
  551. package/docs/ASSURANCE.md +6 -6
  552. package/docs/CLIENT_COMPOSITION.md +2 -2
  553. package/docs/DEVIATIONS.md +677 -182
  554. package/docs/E2EE.md +1 -1
  555. package/docs/ERROR_HANDLING.md +165 -2
  556. package/docs/GETTING_STARTED.md +7 -4
  557. package/docs/INTERFACES.md +1 -1
  558. package/docs/PACKAGE_SURFACE.md +6 -5
  559. package/docs/PROTOCOL_POLICY.md +102 -22
  560. package/docs/RECIPES.md +3 -15
  561. package/docs/SECURITY.md +90 -5
  562. package/keys/README.md +3 -3
  563. package/local/store/README.md +78 -14
  564. package/local/store/key-value/README.md +14 -3
  565. package/local/store/node/README.md +8 -3
  566. package/local/store/web/README.md +9 -0
  567. package/local/store/web-sqlite/README.md +14 -2
  568. package/local/vault/README.md +21 -0
  569. package/package.json +1 -6
  570. package/remote/README.md +0 -1
  571. package/remote/relay/README.md +2 -2
  572. package/dist/device/provisioning.d.ts +0 -242
  573. package/dist/device/provisioning.d.ts.map +0 -1
  574. package/dist/device/provisioning.js +0 -421
  575. package/dist/device/provisioning.js.map +0 -1
  576. package/dist/internal/protocol/x3dh/index.d.ts +0 -15
  577. package/dist/internal/protocol/x3dh/index.d.ts.map +0 -1
  578. package/dist/internal/protocol/x3dh/index.js +0 -13
  579. package/dist/internal/protocol/x3dh/index.js.map +0 -1
  580. package/dist/internal/protocol/x3dh/x3dh.d.ts +0 -131
  581. package/dist/internal/protocol/x3dh/x3dh.d.ts.map +0 -1
  582. package/dist/internal/protocol/x3dh/x3dh.js +0 -261
  583. package/dist/internal/protocol/x3dh/x3dh.js.map +0 -1
@@ -257,6 +257,10 @@ An `SignalProtocolLocalStore` implementation must preserve:
257
257
  - session record persistence
258
258
  - message record persistence used by retry and resend flows
259
259
  - local recovery helpers required by the client lifecycle
260
+ - a `protection` declaration that states what the store does: its
261
+ encryption at rest and the custody of its key. Client creation fails
262
+ without one, and [Content Recovery](../../docs/PROTOCOL_POLICY.md#content-recovery)
263
+ reads it
260
264
 
261
265
  ## Session Record Shape
262
266
 
@@ -288,8 +292,9 @@ failure rollback, compare-and-swap behavior, one-time-prekey replay rejection,
288
292
  and exact per-user session deletion.
289
293
 
290
294
  For the key-value store, the supplied backend's `atomicWrite` is a security boundary.
291
- It must commit `check`, `set`, `remove`, `removeSessionsForUser`, and
292
- `pruneSkippedSenderKeys` operations in one crash-durable transaction.
295
+ It must commit `check`, `set`, `remove`, `removeSessionsForUser`,
296
+ `pruneSkippedSenderKeys`, and `removeSenderKeyHandoffs` operations in one
297
+ crash-durable transaction.
293
298
  The `removeSessionsForUser` operation must enumerate exact plaintext session
294
299
  metadata inside that transaction. An adapter that matches a prefix or enumerates before the
295
300
  transaction can leave a concurrently-created session trusted under a rotated
@@ -301,6 +306,15 @@ inside the transaction. It removes the lowest numeric chain indexes until
301
306
  The operation observes earlier writes in the same batch. Equal indexes belong
302
307
  to distinct generations and remain separate entries.
303
308
 
309
+ The `removeSenderKeyHandoffs` operation enumerates keys under its exact
310
+ `keyPrefix` inside the transaction. The part of a key after the prefix has five
311
+ colon-separated segments: the group hash, the generation, the account hash, the
312
+ recipient hash, and the entry hash. The operation removes every key whose group,
313
+ account, and recipient segments equal each hash that it gives. A hash that it
314
+ omits matches every value. A key of another shape stays. The operation observes
315
+ earlier writes in the same batch, and `assertBackendConformance` checks that
316
+ rule.
317
+
304
318
  For eviction ties, the store may remove either generation.
305
319
  Use `createTransactionalKeyValueBackend` to apply
306
320
  these operations through the shared interpreter, and verify custom backends
@@ -308,18 +322,20 @@ with `assertBackendConformance`.
308
322
 
309
323
  ## Design Notes
310
324
 
311
- Received content uses the same encryption and transaction boundary as protocol state.
325
+ Reviewed: 2026-10-20.
326
+
327
+ Receive records use the same encryption and transaction boundary as protocol state.
312
328
 
313
- The `commitSessionTrust` method commits received content, ratchet state, contact trust, and consumed prekeys together.
329
+ The `commitSessionTrust` method commits the receive record, ratchet state, contact trust, and consumed prekeys together.
314
330
  The `storeSenderKeyRecord` method commits the full sender-key record and every
315
331
  `SenderKeyReceiveCommit` effect together. These effects include skipped-key
316
- additions, capacity eviction, skipped-key consumption, and optional received
317
- content. The manager stages additions until authentication and decryption
332
+ additions, capacity eviction, skipped-key consumption, and an optional receive
333
+ record. The manager stages additions until authentication and decryption
318
334
  succeed.
319
335
 
320
336
  The store applies additions in order, with capacity eviction before
321
337
  each addition. A rejected commit preserves the prior record, skipped keys,
322
- and received content. This applies to current and archived generations and
338
+ and receive records. This applies to current and archived generations and
323
339
  to receives without a durable ID. A retry uses that preserved state.
324
340
 
325
341
  An adapter must reject the complete transaction if any write fails.
@@ -327,15 +343,63 @@ When the database file of a SQLite store cannot grow because the disk or the
327
343
  storage quota is full, the write rejects with `StorageQuotaExceededError`
328
344
  (`STORAGE_QUOTA_EXCEEDED`). SQLite rolls the write back, and the store stays
329
345
  open. Free space, then retry the write.
330
- `getReceivedContent`, `deleteReceivedContent`, and `deleteExpiredReceivedContent`
331
- own recovery and cleanup. Generic unencrypted metadata cannot hold this content.
332
- Expo, bare React Native, and Node use SQLCipher, and the web SQLite store
333
- encrypts its whole file with SQLite3 Multiple Ciphers. The IndexedDB web store
334
- and the key-value store encrypt each content record with their existing store
335
- key.
346
+
347
+ A receive record keeps one decrypted message until the client completes it.
348
+ `commitSessionTrust` with `receiveWork` and `storeSenderKeyRecord` with `work`
349
+ write the record in the same transaction as the ratchet state. Generic
350
+ metadata cannot hold this record, because a metadata write does not join the
351
+ ratchet transaction. Five methods own the records:
352
+
353
+ - `getReceiveWork(workId)` reads one record.
354
+ - `putReceiveWork(record, expectedRevision)` inserts the record when
355
+ `expectedRevision` is `null`. Otherwise it replaces the record that has
356
+ that revision. On a mismatch it returns `false` and writes nothing.
357
+ - `listReceiveWork(query)` lists the records in ascending `(arrivalSeq,
358
+ workId)` order, and compares `workId` values by UTF-16 code unit. It
359
+ filters by `stage`, `dueBy`, and the `after` cursor, and returns at most
360
+ `limit` records (100 when not set). A record passes the cursor when its
361
+ `arrivalSeq` is above the cursor `arrivalSeq`, or equal to it with a
362
+ `workId` above the cursor `workId`.
363
+ - `receiveWorkUsage({ groupId })` counts the records and their bytes. With a
364
+ `groupId`, it counts only the records that wait for an update of that group.
365
+ - `completeReceiveWork(workId, expectedRevision, metadata)` deletes the record
366
+ and applies the metadata writes in one atomic write. On a revision mismatch
367
+ it returns `false` and writes nothing.
368
+
369
+ Each store keeps the arrival order, the stage, the due time, and the size in
370
+ clear index fields beside the record, so a listing or a usage count does not
371
+ decrypt each record. Expo, bare React Native, and Node use SQLCipher, and the
372
+ web SQLite store encrypts its whole file with SQLite3 Multiple Ciphers. The
373
+ IndexedDB web store and the key-value store encrypt each record with their
374
+ existing store key. For a record that waits for its group, they keep a keyed
375
+ hash of the group ID, not the group ID. A SQLite store with
376
+ `encryptionAtRest: false` and the in-memory store keep the records without
377
+ encryption.
378
+
379
+ At the first open after an upgrade from an earlier SDK, each durable store
380
+ converts the legacy received-content rows to receive records, and writes the
381
+ conversion marker last. An interrupted conversion continues at the next open,
382
+ and skips each row that already has a record. A row that does not parse stays
383
+ under its legacy key. The store logs the key, never the value, and keeps the
384
+ key in the marker.
385
+
386
+ The IndexedDB web store and the key-value store also encrypt each metadata
387
+ value with their store key. Their metadata key names stay in clear text. Some
388
+ names hold a group ID, a recipient user ID, or a message ID. These stores
389
+ encrypt clear metadata values from an earlier SDK when they open, and they
390
+ write the migration marker last.
391
+ An earlier SDK cannot read the encrypted values. An encrypted SQLite store
392
+ keeps the metadata keys and values inside its file cipher.
393
+
394
+ `protocol.contentRecovery` does not decide whether a store keeps receive
395
+ records. That policy covers only the content that a sender keeps to answer
396
+ a retry request. Every store keeps receive records, also a store whose
397
+ `protection` is `none`.
336
398
 
337
399
  The SDK removes content after durable handling and retains separate bounded
338
- duplicate evidence. Cleanup uses the existing thirty-day retry horizon.
400
+ duplicate evidence. The receive queue deletes a receive record whose content
401
+ waited 30 days, after `onReceiveExpired` runs. A deletion does not erase the
402
+ bytes. See the [security model](../../docs/SECURITY.md#storage-boundary).
339
403
  The host application must use idempotent writes keyed by message ID.
340
404
 
341
405
  - The Expo adapter is the primary supported mobile implementation. Deployment
@@ -52,9 +52,20 @@ const client = await createSignalProtocolClient({
52
52
  ```
53
53
 
54
54
  The injected backend's `atomicWrite()` is a security boundary. It must evaluate
55
- compare-and-swap checks and commit all writes, removals, and exact per-user
56
- session deletion atomically and durably, including across process termination.
57
- Independent writes committed one after another are not sufficient.
55
+ compare-and-swap checks and commit all writes, removals, exact per-user session
56
+ deletion (`removeSessionsForUser`), skipped sender-key pruning
57
+ (`pruneSkippedSenderKeys`), and sender-key handoff removal
58
+ (`removeSenderKeyHandoffs`) atomically and durably, including across process
59
+ termination. Independent writes committed one after another are not sufficient.
60
+
61
+ The `removeSenderKeyHandoffs` operation enumerates keys under its exact
62
+ `keyPrefix` inside the transaction. The part of a key after the prefix has five
63
+ colon-separated segments: the group hash, the generation, the account hash, the
64
+ recipient hash, and the entry hash. The operation removes every key whose group,
65
+ account, and recipient segments equal each hash that it gives. A hash that it
66
+ omits matches every value. A key of another shape stays. The operation observes
67
+ earlier writes in the same batch, and `assertBackendConformance` checks that
68
+ rule.
58
69
 
59
70
  ## Key custody
60
71
 
@@ -44,14 +44,19 @@ Options:
44
44
  - `directory`: the directory of the database file. Use a private directory on
45
45
  a local file system. Do not use a network file system.
46
46
  - `vault`: the `SignalProtocolLocalSecretVault` that holds the database key.
47
- Required. In Electron, use the safeStorage vault (see below).
47
+ Required. In Electron, use the safeStorage vault (see below). The store
48
+ reports the custody of the vault in its `protection`. The level is
49
+ `protected` with a vault that declares `os-keychain`, such as the
50
+ safeStorage vault, or `app-vault`. A vault that declares no custody counts
51
+ as `same-origin`, and the level is then `co-located`.
48
52
  - `name`: the database file name in `directory`. Letters, digits, `.`, `_`,
49
53
  and `-` only, and no `.lock`, `-wal`, `-shm`, or `-journal` ending.
50
54
  Default: `open-e2ee-signal-protocol.db`.
51
55
  - `encryptionAtRest`: pass `false` to store the database without encryption.
52
56
  The store then does not use the vault, and it logs a warning at each open. A
53
- database created with one setting does not open with the other. Default:
54
- `true`.
57
+ database created with one setting does not open with the other. The store
58
+ reports `none` protection, so the client keeps no resendable content.
59
+ Default: `true`.
55
60
  - `logger`: receives the warning of each open without encryption.
56
61
 
57
62
  Keep application tables in a separate database file. The SDK database holds
@@ -39,12 +39,21 @@ with AES-256-GCM.
39
39
 
40
40
  ## Security boundary
41
41
 
42
+ Reviewed: 2026-10-12.
43
+
42
44
  The adapter generates a random 32-byte database encryption key and persists it
43
45
  in the IndexedDB metadata store. This protects record contents from a copy that
44
46
  does not also contain the metadata key. It does not protect against JavaScript
45
47
  running with the application's origin, because that code can access both the
46
48
  encrypted records and their encryption key.
47
49
 
50
+ The store therefore reports its `protection` as `record-cipher` with
51
+ `same-origin` custody, and its level is `co-located`. The default content
52
+ recovery mode, `require-protected`, keeps no resendable content in this
53
+ store. Set `protocol.contentRecovery.mode` to `allow-co-located-key` only
54
+ after a product review accepts that key custody. See
55
+ [Content Recovery](../../../docs/PROTOCOL_POLICY.md#content-recovery).
56
+
48
57
  A script-injection or compromised-dependency incident can also observe
49
58
  plaintext and invoke the client as the signed-in user. Encryption at rest is
50
59
  therefore not an XSS defense.
@@ -209,11 +209,14 @@ IPC sources to `connect-src`:
209
209
  WebView 133 on an Android API 36 emulator, and every check passes. The
210
210
  origin of the webview is `http://tauri.localhost`.
211
211
  - **Key custody.** The default vault keeps the key in IndexedDB in the same
212
- origin as the database. An app that needs OS keychain custody passes its own
213
- vault. See [Security boundary](#security-boundary).
212
+ origin as the database, so the store reports `same-origin` custody. An app
213
+ that needs other custody passes its own vault. See
214
+ [Security boundary](#security-boundary).
214
215
 
215
216
  ## Security boundary
216
217
 
218
+ Reviewed: 2026-10-12.
219
+
217
220
  The default vault keeps the database key as raw bytes in IndexedDB, in the
218
221
  same origin as the database file. The key protects a copy of the database
219
222
  file that does not also include that IndexedDB record. It does not protect
@@ -226,5 +229,14 @@ origin-security controls that a deployment needs.
226
229
  An application with a different key custody passes its own
227
230
  `SignalProtocolLocalSecretVault` as `vault`.
228
231
 
232
+ The store reports its `protection` from the database file and the vault:
233
+ `file-cipher` with the custody of the vault, or `none` with
234
+ `encryptionAtRest: false`. With the default vault, the level is
235
+ `co-located`. The default content recovery mode, `require-protected`, then
236
+ keeps no resendable content. Set `protocol.contentRecovery.mode` to
237
+ `allow-co-located-key` only after a product review accepts that key
238
+ custody, or pass a vault that declares `os-keychain` or `app-vault`. See
239
+ [Content Recovery](../../../docs/PROTOCOL_POLICY.md#content-recovery).
240
+
229
241
  See the parent [storage guide](../README.md), [adapter guide](../../../ADAPTERS.md),
230
242
  and [security model](../../../docs/SECURITY.md).
@@ -11,6 +11,27 @@ but not full session databases. A vault separate from
11
11
  then use a vault-held wrapping key without placing every protocol record in the
12
12
  platform keychain.
13
13
 
14
+ ## Key custody
15
+
16
+ Reviewed: 2026-10-12.
17
+
18
+ A vault can declare `custody`: where it keeps its secrets. A SQLite or
19
+ key-value store reports the custody of its vault in its `protection`, and
20
+ [Content Recovery](../../docs/PROTOCOL_POLICY.md#content-recovery) reads it.
21
+
22
+ | Vault | `custody` |
23
+ | --- | --- |
24
+ | `ExpoSecureStoreSignalProtocolSecretVault` | `os-keychain` |
25
+ | `ReactNativeKeychainSignalProtocolSecretVault` | `os-keychain` |
26
+ | `ElectronSafeStorageSignalProtocolSecretVault` | `os-keychain` |
27
+ | The IndexedDB vault, the default of the web SQLite store | `same-origin` |
28
+
29
+ A vault that declares no custody counts as `same-origin`, so a stronger
30
+ level needs a declaration. A vault that the application controls, and
31
+ that keeps its secrets apart from the storage of the store data, declares
32
+ `app-vault`. The SDK cannot check that declaration. The application owns
33
+ it.
34
+
14
35
  ## Expo usage
15
36
 
16
37
  Install the optional peer `expo-secure-store` 55.0.15 or later.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@open-e2ee/signal-protocol-sdk",
3
- "version": "11.0.0",
3
+ "version": "12.0.0",
4
4
  "description": "Pure TypeScript Signal Protocol SDK for encrypted chat in Expo, React Native, browsers, and Node. Post-quantum by default.",
5
5
  "keywords": [
6
6
  "open-e2ee",
@@ -10,7 +10,6 @@
10
10
  "end-to-end-encryption",
11
11
  "e2ee",
12
12
  "double-ratchet",
13
- "x3dh",
14
13
  "pqxdh",
15
14
  "post-quantum",
16
15
  "kyber",
@@ -112,10 +111,6 @@
112
111
  "types": "./dist/device/lifecycle/index.d.ts",
113
112
  "default": "./dist/device/lifecycle/index.js"
114
113
  },
115
- "./device/provisioning": {
116
- "types": "./dist/device/provisioning.d.ts",
117
- "default": "./dist/device/provisioning.js"
118
- },
119
114
  "./device/react-native": {
120
115
  "types": "./dist/device/react-native/index.d.ts",
121
116
  "default": "./dist/device/react-native/index.js"
package/remote/README.md CHANGED
@@ -55,7 +55,6 @@ An `SignalProtocolRelayServer` implementation must preserve the package’s prot
55
55
  - prekey bundle fetch
56
56
  - device registration and listing
57
57
  - envelope delivery
58
- - linked-device provisioning state
59
58
  - stale-device and unlink cleanup
60
59
 
61
60
  ## Security Invariants
@@ -1,8 +1,8 @@
1
1
  # Relay
2
2
 
3
3
  The relay module defines `SignalProtocolRelayServer`, the application-backend contract
4
- for device discovery, public prekeys, encrypted envelopes, key rotation,
5
- provisioning, and related synchronization.
4
+ for device discovery, public prekeys, encrypted envelopes, key rotation, and
5
+ related synchronization.
6
6
 
7
7
  ## Why it exists
8
8
 
@@ -1,242 +0,0 @@
1
- /**
2
- * Device Provisioning Manager
3
- *
4
- * Implements Signal Protocol's device linking flow:
5
- * 1. Primary device generates ephemeral key pair and QR code
6
- * 2. New device scans QR code and generates own ephemeral key pair
7
- * 3. Both devices perform ECDH key agreement to establish shared secret
8
- * 4. Primary device encrypts provisioned identity keys with shared secret
9
- * 5. New device decrypts and stores those identities, then initializes
10
- *
11
- * Security Properties:
12
- * - Physical proximity authentication (QR code)
13
- * - Ephemeral ECDH key agreement (forward secrecy)
14
- * - AES-256-GCM encryption
15
- * - 5-minute session TTL
16
- * - Account identity sharing (not full backup)
17
- * - The provisioning service carries only encrypted key material
18
- *
19
- * Differences from Device Transfer:
20
- * - Shares identity key only (not full backup with sessions)
21
- * - Adds new device (does not migrate/wipe old device)
22
- * - Multiple devices remain active
23
- *
24
- * This module is platform-free on purpose. The device's own description arrives
25
- * as a `LocalDeviceMetadata` parameter, so nothing here needs to ask a platform
26
- * what it is running on. The `./expo` module supplies that for Expo
27
- * hosts.
28
- */
29
- import type { ProvisioningService } from '../remote/relay/types.js';
30
- import type { IdentityType } from '../keys/index.js';
31
- import { type Logger } from '../logger.js';
32
- import type { SignalProtocolLocalStore } from '../types/index.js';
33
- import type { SerializedUsernameLinkComponents } from '../username/link.js';
34
- /**
35
- * User profile data for provisioning message.
36
- * Passed as a parameter to avoid coupling to user storage.
37
- */
38
- export {};
39
- export interface UserProfile {
40
- name?: string;
41
- username?: string | null;
42
- usernameLink?: SerializedUsernameLinkComponents | null;
43
- }
44
- /**
45
- * Optional local group-state store used to sync group master keys during provisioning.
46
- *
47
- * The Signal Protocol SDK owns the provisioning semantics. The host app owns the concrete SQLite store.
48
- */
49
- export interface ProvisioningGroupStateStore {
50
- getAllMasterKeys(): Promise<Array<{
51
- groupId: string;
52
- masterKey: string;
53
- }>>;
54
- storeMasterKey(groupId: string, masterKey: Uint8Array): Promise<void>;
55
- deleteMasterKey(groupId: string): Promise<void>;
56
- }
57
- /**
58
- * Identity-key storage used during provisioning.
59
- *
60
- * The Signal Protocol SDK owns the provisioning semantics. Callers provide their concrete
61
- * storage adapter so provisioning writes into the same key store used by the
62
- * runtime client.
63
- */
64
- export interface ProvisioningIdentityStore extends Pick<SignalProtocolLocalStore, 'getIdentityKey' | 'storeIdentityKey'> {
65
- deleteIdentityKey(identityType: IdentityType): Promise<void>;
66
- }
67
- /**
68
- * Minimal local state store used to persist linked-device bootstrap state.
69
- *
70
- * This lets provisioning record the assigned device ID and identity public key
71
- * without depending on a platform-specific SecureStore implementation.
72
- */
73
- export interface ProvisioningLocalStateStore {
74
- setItemAsync(key: string, value: string): Promise<void>;
75
- deleteItemAsync(key: string): Promise<void>;
76
- }
77
- export interface ProvisioningUsernameStateStore {
78
- setUsernameState(state: {
79
- fullUsername: string | null;
80
- usernameLink: SerializedUsernameLinkComponents | null;
81
- }): Promise<void>;
82
- clearUsernameState(): Promise<void>;
83
- }
84
- export interface ProvisioningSendOptions {
85
- identityStore: ProvisioningIdentityStore;
86
- /**
87
- * Identity types to provision onto the linked device.
88
- *
89
- * Defaults to probing both `aci` and `pni`, always requiring `aci` and
90
- * including `pni` when present. Hosts may pass an explicit list when they
91
- * want to require a specific set.
92
- */
93
- identityTypes?: readonly IdentityType[];
94
- groupStateStore?: ProvisioningGroupStateStore;
95
- logger?: Logger;
96
- }
97
- export interface ProvisioningReceiveOptions {
98
- identityStore: ProvisioningIdentityStore;
99
- localStateStore?: ProvisioningLocalStateStore;
100
- groupStateStore?: ProvisioningGroupStateStore;
101
- usernameStateStore?: ProvisioningUsernameStateStore;
102
- deviceMetadata: LocalDeviceMetadata;
103
- logger?: Logger;
104
- }
105
- /**
106
- * Ephemeral key pair for provisioning session
107
- * Generated fresh for each linking session
108
- */
109
- export interface ProvisioningKeyPair {
110
- publicKey: string;
111
- privateKey: string;
112
- }
113
- /**
114
- * QR code data for device linking
115
- * Encoded as URL: signalprotocol://link-device?session=xxx&key=xxx
116
- */
117
- export interface ProvisioningQRData {
118
- sessionId: string;
119
- ephemeralPublicKey: string;
120
- }
121
- /**
122
- * Device metadata collected locally on the new device.
123
- *
124
- * `deviceName` stays local until provisioning has delivered the account
125
- * identity key needed to encrypt it for server storage.
126
- */
127
- export interface LocalDeviceMetadata {
128
- deviceName: string;
129
- platform: string;
130
- appVersion: string;
131
- osVersion: string;
132
- }
133
- /**
134
- * Provisioning message sent from primary to new device
135
- * Contains provisioned identity keys and user profile
136
- */
137
- export interface ProvisioningMessage {
138
- identityKeys: Partial<{
139
- [K in IdentityType]: {
140
- dhPublicKey: string;
141
- dhPrivateKey: string;
142
- signingPublicKey: string;
143
- signingPrivateKey: string;
144
- registrationId: number;
145
- };
146
- }>;
147
- userId: string;
148
- deviceId: number;
149
- userProfile: {
150
- name?: string;
151
- username?: string | null;
152
- usernameLink?: SerializedUsernameLinkComponents | null;
153
- };
154
- /** Group master keys for cross-device sync (base64-encoded). */
155
- groupMasterKeys?: Array<{
156
- groupId: string;
157
- masterKey: string;
158
- }>;
159
- }
160
- /**
161
- * Default custom URL scheme prefix for device-linking QR codes, targeting the
162
- * `signalprotocol://` scheme. Override per call via the `linkPrefix` parameter.
163
- */
164
- export declare const DEFAULT_PROVISIONING_LINK_PREFIX = "signalprotocol://link-device";
165
- /**
166
- * Generate QR Code for Device Linking (Primary Device)
167
- *
168
- * Creates a provisioning session and generates QR code data.
169
- * The QR code contains the session ID and ephemeral public key.
170
- *
171
- * @param relay - Provisioning service interface
172
- * @param userId - Current user ID
173
- * @param providedLogger - Optional logger
174
- * @param linkPrefix - Custom scheme prefix (defaults to {@link DEFAULT_PROVISIONING_LINK_PREFIX})
175
- * @returns QR code URL and ephemeral key pair
176
- */
177
- export declare function generateProvisioningQR(relay: ProvisioningService, userId: string, providedLogger?: Logger, linkPrefix?: string): Promise<{
178
- qrCodeUrl: string;
179
- sessionId: string;
180
- ephemeralKeyPair: ProvisioningKeyPair;
181
- }>;
182
- /**
183
- * Send Provisioning Payload to New Device (Primary Device)
184
- *
185
- * Called after new device connects to provisioning session.
186
- * Encrypts and sends all provisioned identity keys to the new device.
187
- *
188
- * @param relay - Provisioning service interface
189
- * @param userProfile - User profile data (name, username, avatarUrl)
190
- * @param sessionId - Provisioning session ID
191
- * @param ephemeralPrivateKey - Primary's ephemeral private key
192
- * @param newDeviceEphemeralPublicKey - New device's ephemeral public key
193
- * @param userId - User ID
194
- */
195
- export declare function provisionDevice(relay: ProvisioningService, userProfile: UserProfile, sessionId: string, ephemeralPrivateKey: string, newDeviceEphemeralPublicKey: string, userId: string, options: ProvisioningSendOptions): Promise<void>;
196
- /**
197
- * Parse Provisioning QR Code (New Device)
198
- *
199
- * Extracts session ID and ephemeral public key from QR code URL.
200
- *
201
- * @param qrCodeData - QR code data (URL format)
202
- * @returns Session ID and primary's ephemeral public key (Base64)
203
- */
204
- export declare function parseProvisioningQR(qrCodeData: string, providedLogger?: Logger, linkPrefix?: string): {
205
- sessionId: string;
206
- primaryEphemeralPublicKey: string;
207
- };
208
- /**
209
- * Connect to Provisioning Session (New Device)
210
- *
211
- * Generates ephemeral key pair and connects to provisioning session.
212
- *
213
- * @param relay - Provisioning service interface
214
- * @param sessionId - Provisioning session ID
215
- * @param deviceMetadata - New device metadata
216
- * @returns Ephemeral key pair for decryption
217
- */
218
- export declare function connectToProvisioningSession(relay: ProvisioningService, sessionId: string, deviceMetadata: LocalDeviceMetadata, providedLogger?: Logger): Promise<ProvisioningKeyPair>;
219
- /**
220
- * Receive Provisioning Message (New Device)
221
- *
222
- * Polls for and decrypts provisioning message from primary device.
223
- * Finalizes the server-side device link, then stores the received bootstrap
224
- * state in the caller-provided Signal Protocol key store.
225
- *
226
- * @param relay - Provisioning service interface
227
- * @param sessionId - Provisioning session ID
228
- * @param ephemeralPrivateKey - New device's ephemeral private key
229
- * @param primaryEphemeralPublicKey - Primary device's ephemeral public key
230
- * @returns Provisioning message with identity keys and user info
231
- */
232
- export declare function receiveProvisioningMessage(relay: ProvisioningService, sessionId: string, ephemeralPrivateKey: string, primaryEphemeralPublicKey: string, options: ProvisioningReceiveOptions): Promise<ProvisioningMessage>;
233
- /**
234
- * Cancel Provisioning Session
235
- *
236
- * Deletes provisioning session and cleans up.
237
- *
238
- * @param relay - Provisioning service interface
239
- * @param sessionId - Session ID to cancel
240
- */
241
- export declare function cancelProvisioning(relay: ProvisioningService, sessionId: string, userId: string, providedLogger?: Logger): Promise<void>;
242
- //# sourceMappingURL=provisioning.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"provisioning.d.ts","sourceRoot":"","sources":["../../device/provisioning.ts"],"names":[],"mappings":"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"}