@open-e2ee/signal-protocol-sdk 2.0.2 → 4.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 (576) hide show
  1. package/ADAPTERS.md +14 -21
  2. package/ARCHITECTURE.md +1 -2
  3. package/CHANGELOG.md +90 -0
  4. package/LICENSE +11 -655
  5. package/LICENSE-APACHE +201 -0
  6. package/LICENSE-MIT +21 -0
  7. package/NOTICE +5 -7
  8. package/README.md +11 -11
  9. package/SECURITY.md +2 -2
  10. package/TROUBLESHOOTING.md +6 -10
  11. package/client/README.md +36 -18
  12. package/device/README.md +1 -1
  13. package/dist/blocking/manager.d.ts +2 -2
  14. package/dist/blocking/manager.d.ts.map +1 -1
  15. package/dist/blocking/manager.js.map +1 -1
  16. package/dist/client/client.d.ts +45 -34
  17. package/dist/client/client.d.ts.map +1 -1
  18. package/dist/client/client.js +178 -115
  19. package/dist/client/client.js.map +1 -1
  20. package/dist/client/compose.d.ts +7 -7
  21. package/dist/client/compose.d.ts.map +1 -1
  22. package/dist/client/compose.js +2 -2
  23. package/dist/client/compose.js.map +1 -1
  24. package/dist/client/config.d.ts +24 -28
  25. package/dist/client/config.d.ts.map +1 -1
  26. package/dist/client/config.js.map +1 -1
  27. package/dist/client/content-adapter.d.ts +2 -0
  28. package/dist/client/content-adapter.d.ts.map +1 -1
  29. package/dist/client/content-adapter.js +4 -0
  30. package/dist/client/content-adapter.js.map +1 -1
  31. package/dist/client/dual-store.d.ts +5 -5
  32. package/dist/client/dual-store.d.ts.map +1 -1
  33. package/dist/client/dual-store.js.map +1 -1
  34. package/dist/client/endorsement-manager.d.ts +6 -3
  35. package/dist/client/endorsement-manager.d.ts.map +1 -1
  36. package/dist/client/endorsement-manager.js +14 -6
  37. package/dist/client/endorsement-manager.js.map +1 -1
  38. package/dist/client/files.d.ts +1 -1
  39. package/dist/client/files.js +1 -1
  40. package/dist/client/group-authority.d.ts +8 -0
  41. package/dist/client/group-authority.d.ts.map +1 -0
  42. package/dist/client/group-authority.js +2 -0
  43. package/dist/client/group-authority.js.map +1 -0
  44. package/dist/client/group-outbox.d.ts +4 -4
  45. package/dist/client/group-outbox.d.ts.map +1 -1
  46. package/dist/client/group-sealed-sender.d.ts +2 -2
  47. package/dist/client/group-sealed-sender.d.ts.map +1 -1
  48. package/dist/client/groups.d.ts +1 -1
  49. package/dist/client/groups.js +1 -1
  50. package/dist/client/headless.d.ts +11 -16
  51. package/dist/client/headless.d.ts.map +1 -1
  52. package/dist/client/headless.js +4 -9
  53. package/dist/client/headless.js.map +1 -1
  54. package/dist/client/hosted-anonymous-delivery.d.ts +32 -0
  55. package/dist/client/hosted-anonymous-delivery.d.ts.map +1 -0
  56. package/dist/client/hosted-anonymous-delivery.js +239 -0
  57. package/dist/client/hosted-anonymous-delivery.js.map +1 -0
  58. package/dist/client/hosted-connection.d.ts +1 -1
  59. package/dist/client/hosted-connection.d.ts.map +1 -1
  60. package/dist/client/hosted-connection.js +18 -51
  61. package/dist/client/hosted-connection.js.map +1 -1
  62. package/dist/client/hosted-group-authority.d.ts +11 -0
  63. package/dist/client/hosted-group-authority.d.ts.map +1 -0
  64. package/dist/client/hosted-group-authority.js +96 -0
  65. package/dist/client/hosted-group-authority.js.map +1 -0
  66. package/dist/client/hosted-groups.d.ts +31 -0
  67. package/dist/client/hosted-groups.d.ts.map +1 -0
  68. package/dist/client/hosted-groups.js +217 -0
  69. package/dist/client/hosted-groups.js.map +1 -0
  70. package/dist/client/hosted-mailbox-subscription.d.ts +34 -0
  71. package/dist/client/hosted-mailbox-subscription.d.ts.map +1 -0
  72. package/dist/client/hosted-mailbox-subscription.js +257 -0
  73. package/dist/client/hosted-mailbox-subscription.js.map +1 -0
  74. package/dist/client/hosted-prekey-publication.d.ts +51 -0
  75. package/dist/client/hosted-prekey-publication.d.ts.map +1 -0
  76. package/dist/client/hosted-prekey-publication.js +249 -0
  77. package/dist/client/hosted-prekey-publication.js.map +1 -0
  78. package/dist/client/hosted-push.d.ts +5 -6
  79. package/dist/client/hosted-push.d.ts.map +1 -1
  80. package/dist/client/hosted-push.js +22 -22
  81. package/dist/client/hosted-push.js.map +1 -1
  82. package/dist/client/hosted-transport.d.ts +62 -40
  83. package/dist/client/hosted-transport.d.ts.map +1 -1
  84. package/dist/client/hosted-transport.js +666 -341
  85. package/dist/client/hosted-transport.js.map +1 -1
  86. package/dist/client/hosted-trust.d.ts +29 -0
  87. package/dist/client/hosted-trust.d.ts.map +1 -0
  88. package/dist/client/hosted-trust.js +28 -0
  89. package/dist/client/hosted-trust.js.map +1 -0
  90. package/dist/client/hosted.d.ts +26 -21
  91. package/dist/client/hosted.d.ts.map +1 -1
  92. package/dist/client/hosted.js +80 -36
  93. package/dist/client/hosted.js.map +1 -1
  94. package/dist/client/index.d.ts +15 -15
  95. package/dist/client/index.d.ts.map +1 -1
  96. package/dist/client/index.js +7 -7
  97. package/dist/client/index.js.map +1 -1
  98. package/dist/client/key-rotation-core.d.ts +16 -8
  99. package/dist/client/key-rotation-core.d.ts.map +1 -1
  100. package/dist/client/key-rotation-core.js +14 -3
  101. package/dist/client/key-rotation-core.js.map +1 -1
  102. package/dist/client/key-rotation.d.ts +3 -2
  103. package/dist/client/key-rotation.d.ts.map +1 -1
  104. package/dist/client/key-rotation.js +5 -5
  105. package/dist/client/key-rotation.js.map +1 -1
  106. package/dist/client/media-queue-persistence.d.ts +14 -0
  107. package/dist/client/media-queue-persistence.d.ts.map +1 -0
  108. package/dist/client/media-queue-persistence.js +123 -0
  109. package/dist/client/media-queue-persistence.js.map +1 -0
  110. package/dist/client/media-upload-budget.d.ts +3 -0
  111. package/dist/client/media-upload-budget.d.ts.map +1 -0
  112. package/dist/client/media-upload-budget.js +27 -0
  113. package/dist/client/media-upload-budget.js.map +1 -0
  114. package/dist/client/media.d.ts +51 -15
  115. package/dist/client/media.d.ts.map +1 -1
  116. package/dist/client/media.js +541 -73
  117. package/dist/client/media.js.map +1 -1
  118. package/dist/client/messages.d.ts +1 -1
  119. package/dist/client/messages.d.ts.map +1 -1
  120. package/dist/client/messages.js +14 -15
  121. package/dist/client/messages.js.map +1 -1
  122. package/dist/client/multi-device.d.ts +1 -1
  123. package/dist/client/multi-device.js +1 -1
  124. package/dist/client/prekeys.d.ts +1 -1
  125. package/dist/client/prekeys.d.ts.map +1 -1
  126. package/dist/client/prekeys.js +132 -44
  127. package/dist/client/prekeys.js.map +1 -1
  128. package/dist/client/relay-subscription.d.ts +5 -1
  129. package/dist/client/relay-subscription.d.ts.map +1 -1
  130. package/dist/client/relay-subscription.js +59 -26
  131. package/dist/client/relay-subscription.js.map +1 -1
  132. package/dist/client/retry.d.ts +3 -3
  133. package/dist/client/retry.d.ts.map +1 -1
  134. package/dist/client/retry.js +1 -1
  135. package/dist/client/retry.js.map +1 -1
  136. package/dist/client/sealed-sender.d.ts +5 -5
  137. package/dist/client/sealed-sender.d.ts.map +1 -1
  138. package/dist/client/sealed-sender.js.map +1 -1
  139. package/dist/client/sender-key-distribution.d.ts +8 -0
  140. package/dist/client/sender-key-distribution.d.ts.map +1 -0
  141. package/dist/client/sender-key-distribution.js +59 -0
  142. package/dist/client/sender-key-distribution.js.map +1 -0
  143. package/dist/client/sessions.d.ts +3 -3
  144. package/dist/client/sessions.d.ts.map +1 -1
  145. package/dist/client/sessions.js +1 -1
  146. package/dist/client/sessions.js.map +1 -1
  147. package/dist/client/signal-service-cipher.d.ts +12 -8
  148. package/dist/client/signal-service-cipher.d.ts.map +1 -1
  149. package/dist/client/signal-service-cipher.js +41 -16
  150. package/dist/client/signal-service-cipher.js.map +1 -1
  151. package/dist/client/state.d.ts +1 -1
  152. package/dist/client/state.js +1 -1
  153. package/dist/client/types.d.ts +10 -10
  154. package/dist/client/types.d.ts.map +1 -1
  155. package/dist/client/types.js +1 -1
  156. package/dist/device/connection.d.ts.map +1 -1
  157. package/dist/device/connection.js.map +1 -1
  158. package/dist/device/device-id.d.ts +2 -2
  159. package/dist/device/device-id.d.ts.map +1 -1
  160. package/dist/device/device-id.js.map +1 -1
  161. package/dist/device/{expo-metadata.d.ts → expo/index.d.ts} +3 -3
  162. package/dist/device/expo/index.d.ts.map +1 -0
  163. package/dist/device/{expo-metadata.js → expo/index.js} +2 -2
  164. package/dist/device/expo/index.js.map +1 -0
  165. package/dist/device/index.d.ts +1 -1
  166. package/dist/device/index.d.ts.map +1 -1
  167. package/dist/device/index.js +1 -1
  168. package/dist/device/index.js.map +1 -1
  169. package/dist/device/lifecycle/index.d.ts +1 -1
  170. package/dist/device/lifecycle/index.d.ts.map +1 -1
  171. package/dist/device/lifecycle/types.d.ts +8 -8
  172. package/dist/device/lifecycle/types.d.ts.map +1 -1
  173. package/dist/device/provisioning.d.ts +13 -13
  174. package/dist/device/provisioning.d.ts.map +1 -1
  175. package/dist/device/provisioning.js +1 -1
  176. package/dist/device/provisioning.js.map +1 -1
  177. package/dist/device/transfer.d.ts +13 -13
  178. package/dist/device/transfer.d.ts.map +1 -1
  179. package/dist/device/transfer.js.map +1 -1
  180. package/dist/device/types.d.ts +3 -3
  181. package/dist/device/types.d.ts.map +1 -1
  182. package/dist/groups/index.d.ts +1 -1
  183. package/dist/groups/index.d.ts.map +1 -1
  184. package/dist/groups/server.d.ts +10 -0
  185. package/dist/groups/server.d.ts.map +1 -0
  186. package/dist/groups/server.js +6 -0
  187. package/dist/groups/server.js.map +1 -0
  188. package/dist/hooks/use-connection-presence.d.ts +6 -8
  189. package/dist/hooks/use-connection-presence.d.ts.map +1 -1
  190. package/dist/hooks/use-connection-presence.js +2 -4
  191. package/dist/hooks/use-connection-presence.js.map +1 -1
  192. package/dist/hooks/use-group-membership.d.ts +2 -2
  193. package/dist/hooks/use-group-membership.d.ts.map +1 -1
  194. package/dist/hooks/use-group-membership.js.map +1 -1
  195. package/dist/hooks/use-key-rotation.d.ts +2 -2
  196. package/dist/hooks/use-key-rotation.d.ts.map +1 -1
  197. package/dist/hooks/use-session-health.d.ts +2 -2
  198. package/dist/hooks/use-session-health.d.ts.map +1 -1
  199. package/dist/index.d.ts +57 -55
  200. package/dist/index.d.ts.map +1 -1
  201. package/dist/index.js +27 -26
  202. package/dist/index.js.map +1 -1
  203. package/dist/internal/crypto/ec/x25519-validation.d.ts +4 -4
  204. package/dist/internal/crypto/ec/x25519-validation.d.ts.map +1 -1
  205. package/dist/internal/crypto/ec/x25519-validation.js.map +1 -1
  206. package/dist/internal/groups/authority-certificate.d.ts +22 -0
  207. package/dist/internal/groups/authority-certificate.d.ts.map +1 -0
  208. package/dist/internal/groups/authority-certificate.js +99 -0
  209. package/dist/internal/groups/authority-certificate.js.map +1 -0
  210. package/dist/internal/groups/error-details.d.ts +9 -0
  211. package/dist/internal/groups/error-details.d.ts.map +1 -0
  212. package/dist/internal/groups/error-details.js +30 -0
  213. package/dist/internal/groups/error-details.js.map +1 -0
  214. package/dist/internal/groups/index.d.ts +1 -1
  215. package/dist/internal/groups/index.d.ts.map +1 -1
  216. package/dist/internal/groups/manager.d.ts +9 -4
  217. package/dist/internal/groups/manager.d.ts.map +1 -1
  218. package/dist/internal/groups/manager.js +3 -0
  219. package/dist/internal/groups/manager.js.map +1 -1
  220. package/dist/internal/groups/sdk-store.d.ts +4 -4
  221. package/dist/internal/groups/sdk-store.d.ts.map +1 -1
  222. package/dist/internal/groups/sdk-store.js.map +1 -1
  223. package/dist/internal/groups/server-engine.d.ts +9 -2
  224. package/dist/internal/groups/server-engine.d.ts.map +1 -1
  225. package/dist/internal/groups/server-engine.js +51 -19
  226. package/dist/internal/groups/server-engine.js.map +1 -1
  227. package/dist/internal/groups/wire.d.ts.map +1 -1
  228. package/dist/internal/groups/wire.js +10 -9
  229. package/dist/internal/groups/wire.js.map +1 -1
  230. package/dist/internal/manager/index.d.ts +2 -2
  231. package/dist/internal/manager/index.d.ts.map +1 -1
  232. package/dist/internal/manager/index.js +1 -1
  233. package/dist/internal/manager/index.js.map +1 -1
  234. package/dist/internal/manager/manager.d.ts +23 -23
  235. package/dist/internal/manager/manager.d.ts.map +1 -1
  236. package/dist/internal/manager/manager.js +40 -43
  237. package/dist/internal/manager/manager.js.map +1 -1
  238. package/dist/internal/protocol/double-ratchet/chains.d.ts +9 -9
  239. package/dist/internal/protocol/double-ratchet/chains.d.ts.map +1 -1
  240. package/dist/internal/protocol/double-ratchet/chains.js.map +1 -1
  241. package/dist/internal/protocol/double-ratchet/ratchet.d.ts +2 -2
  242. package/dist/internal/protocol/double-ratchet/ratchet.d.ts.map +1 -1
  243. package/dist/internal/protocol/double-ratchet/ratchet.js.map +1 -1
  244. package/dist/internal/protocol/pqxdh/pqxdh.d.ts +3 -3
  245. package/dist/internal/protocol/pqxdh/pqxdh.d.ts.map +1 -1
  246. package/dist/internal/protocol/pqxdh/pqxdh.js.map +1 -1
  247. package/dist/internal/protocol/sender-keys/manager.d.ts +4 -4
  248. package/dist/internal/protocol/sender-keys/manager.d.ts.map +1 -1
  249. package/dist/internal/protocol/sender-keys/manager.js +27 -14
  250. package/dist/internal/protocol/sender-keys/manager.js.map +1 -1
  251. package/dist/internal/protocol/spqr/ml-kem-braid/authenticator.d.ts +3 -3
  252. package/dist/internal/protocol/spqr/ml-kem-braid/authenticator.d.ts.map +1 -1
  253. package/dist/internal/protocol/spqr/ml-kem-braid/incremental-kem.d.ts +3 -3
  254. package/dist/internal/protocol/spqr/ml-kem-braid/incremental-kem.d.ts.map +1 -1
  255. package/dist/internal/protocol/spqr/ml-kem-braid/index.d.ts +2 -2
  256. package/dist/internal/protocol/spqr/ml-kem-braid/index.d.ts.map +1 -1
  257. package/dist/internal/protocol/spqr/ml-kem-braid/index.js +1 -1
  258. package/dist/internal/protocol/spqr/ml-kem-braid/index.js.map +1 -1
  259. package/dist/internal/protocol/spqr/ml-kem-braid/state-machine.d.ts +3 -3
  260. package/dist/internal/protocol/spqr/ml-kem-braid/state-machine.d.ts.map +1 -1
  261. package/dist/internal/protocol/spqr/ml-kem-braid/state-machine.js +2 -2
  262. package/dist/internal/protocol/spqr/ml-kem-braid/state-machine.js.map +1 -1
  263. package/dist/internal/protocol/spqr/ml-kem-braid/types.d.ts +3 -3
  264. package/dist/internal/protocol/spqr/ml-kem-braid/types.d.ts.map +1 -1
  265. package/dist/internal/protocol/spqr/spqr.d.ts +5 -5
  266. package/dist/internal/protocol/spqr/spqr.d.ts.map +1 -1
  267. package/dist/internal/protocol/spqr/spqr.js.map +1 -1
  268. package/dist/internal/protocol/triple-ratchet/ratchet.d.ts +4 -4
  269. package/dist/internal/protocol/triple-ratchet/ratchet.d.ts.map +1 -1
  270. package/dist/internal/protocol/triple-ratchet/ratchet.js.map +1 -1
  271. package/dist/internal/protocol/x3dh/x3dh.d.ts +3 -3
  272. package/dist/internal/protocol/x3dh/x3dh.d.ts.map +1 -1
  273. package/dist/internal/protocol/x3dh/x3dh.js.map +1 -1
  274. package/dist/internal/sesame/device-registry.d.ts +16 -16
  275. package/dist/internal/sesame/device-registry.d.ts.map +1 -1
  276. package/dist/internal/sesame/device-registry.js +6 -6
  277. package/dist/internal/sesame/device-registry.js.map +1 -1
  278. package/dist/internal/sesame/index.d.ts +4 -4
  279. package/dist/internal/sesame/index.d.ts.map +1 -1
  280. package/dist/internal/sesame/index.js +2 -2
  281. package/dist/internal/sesame/index.js.map +1 -1
  282. package/dist/internal/sesame/manager.d.ts +10 -10
  283. package/dist/internal/sesame/manager.d.ts.map +1 -1
  284. package/dist/internal/sesame/manager.js +13 -13
  285. package/dist/internal/sesame/manager.js.map +1 -1
  286. package/dist/internal/sesame/types.d.ts +5 -5
  287. package/dist/internal/sesame/types.d.ts.map +1 -1
  288. package/dist/internal/session/cipher.d.ts +4 -4
  289. package/dist/internal/session/cipher.d.ts.map +1 -1
  290. package/dist/internal/session/cipher.js +31 -28
  291. package/dist/internal/session/cipher.js.map +1 -1
  292. package/dist/internal/session/decryption.js.map +1 -1
  293. package/dist/internal/session/factory.d.ts +3 -3
  294. package/dist/internal/session/factory.d.ts.map +1 -1
  295. package/dist/internal/session/factory.js.map +1 -1
  296. package/dist/internal/session/handshake.d.ts +2 -2
  297. package/dist/internal/session/handshake.d.ts.map +1 -1
  298. package/dist/internal/session/handshake.js.map +1 -1
  299. package/dist/internal/session/ratchet.d.ts +4 -4
  300. package/dist/internal/session/ratchet.d.ts.map +1 -1
  301. package/dist/internal/session/ratchet.js.map +1 -1
  302. package/dist/internal/session/types.d.ts +5 -5
  303. package/dist/internal/session/types.d.ts.map +1 -1
  304. package/dist/internal/session/validation.d.ts +3 -3
  305. package/dist/internal/session/validation.d.ts.map +1 -1
  306. package/dist/internal/session/validation.js.map +1 -1
  307. package/dist/layers.d.ts +4 -4
  308. package/dist/layers.d.ts.map +1 -1
  309. package/dist/layers.js +12 -12
  310. package/dist/layers.js.map +1 -1
  311. package/dist/local/store/expo/adapter.d.ts +15 -9
  312. package/dist/local/store/expo/adapter.d.ts.map +1 -1
  313. package/dist/local/store/expo/adapter.js +29 -10
  314. package/dist/local/store/expo/adapter.js.map +1 -1
  315. package/dist/local/store/expo/database-key.d.ts +5 -5
  316. package/dist/local/store/expo/database-key.d.ts.map +1 -1
  317. package/dist/local/store/expo/database-key.js.map +1 -1
  318. package/dist/local/store/expo/index.d.ts +3 -3
  319. package/dist/local/store/expo/index.d.ts.map +1 -1
  320. package/dist/local/store/expo/key-storage.d.ts +11 -5
  321. package/dist/local/store/expo/key-storage.d.ts.map +1 -1
  322. package/dist/local/store/expo/key-storage.js +82 -17
  323. package/dist/local/store/expo/key-storage.js.map +1 -1
  324. package/dist/local/store/expo/models/kyber-prekey-used.d.ts +1 -4
  325. package/dist/local/store/expo/models/kyber-prekey-used.d.ts.map +1 -1
  326. package/dist/local/store/expo/models/kyber-prekey-used.js +23 -9
  327. package/dist/local/store/expo/models/kyber-prekey-used.js.map +1 -1
  328. package/dist/local/store/expo/models/kyber-prekey.d.ts +4 -4
  329. package/dist/local/store/expo/models/kyber-prekey.d.ts.map +1 -1
  330. package/dist/local/store/expo/models/kyber-prekey.js +67 -26
  331. package/dist/local/store/expo/models/kyber-prekey.js.map +1 -1
  332. package/dist/local/store/expo/schema.d.ts +21 -2
  333. package/dist/local/store/expo/schema.d.ts.map +1 -1
  334. package/dist/local/store/expo/schema.js +10 -2
  335. package/dist/local/store/expo/schema.js.map +1 -1
  336. package/dist/local/store/index.d.ts +3 -3
  337. package/dist/local/store/index.d.ts.map +1 -1
  338. package/dist/local/store/index.js +1 -1
  339. package/dist/local/store/kyber-prekey-lifecycle.d.ts +46 -0
  340. package/dist/local/store/kyber-prekey-lifecycle.d.ts.map +1 -0
  341. package/dist/local/store/kyber-prekey-lifecycle.js +88 -0
  342. package/dist/local/store/kyber-prekey-lifecycle.js.map +1 -0
  343. package/dist/local/store/memory/adapter.d.ts +14 -6
  344. package/dist/local/store/memory/adapter.d.ts.map +1 -1
  345. package/dist/local/store/memory/adapter.js +114 -29
  346. package/dist/local/store/memory/adapter.js.map +1 -1
  347. package/dist/local/store/node/adapter.d.ts +9 -3
  348. package/dist/local/store/node/adapter.d.ts.map +1 -1
  349. package/dist/local/store/node/adapter.js +31 -13
  350. package/dist/local/store/node/adapter.js.map +1 -1
  351. package/dist/local/store/node/database-file-commit.d.ts +8 -0
  352. package/dist/local/store/node/database-file-commit.d.ts.map +1 -0
  353. package/dist/local/store/node/database-file-commit.js +62 -0
  354. package/dist/local/store/node/database-file-commit.js.map +1 -0
  355. package/dist/local/store/node/database-key.d.ts +6 -1
  356. package/dist/local/store/node/database-key.d.ts.map +1 -1
  357. package/dist/local/store/node/database-key.js +79 -44
  358. package/dist/local/store/node/database-key.js.map +1 -1
  359. package/dist/local/store/node/database-lock.d.ts +8 -0
  360. package/dist/local/store/node/database-lock.d.ts.map +1 -0
  361. package/dist/local/store/node/database-lock.js +44 -0
  362. package/dist/local/store/node/database-lock.js.map +1 -0
  363. package/dist/local/store/node/database.d.ts +17 -16
  364. package/dist/local/store/node/database.d.ts.map +1 -1
  365. package/dist/local/store/node/database.js +197 -202
  366. package/dist/local/store/node/database.js.map +1 -1
  367. package/dist/local/store/react-native/adapter.d.ts +10 -4
  368. package/dist/local/store/react-native/adapter.d.ts.map +1 -1
  369. package/dist/local/store/react-native/adapter.js +151 -66
  370. package/dist/local/store/react-native/adapter.js.map +1 -1
  371. package/dist/local/store/received-content.d.ts +9 -0
  372. package/dist/local/store/received-content.d.ts.map +1 -0
  373. package/dist/local/store/received-content.js +46 -0
  374. package/dist/local/store/received-content.js.map +1 -0
  375. package/dist/local/store/reliability.d.ts +4 -4
  376. package/dist/local/store/reliability.d.ts.map +1 -1
  377. package/dist/local/store/reliability.js +7 -4
  378. package/dist/local/store/reliability.js.map +1 -1
  379. package/dist/local/store/web/adapter.d.ts +11 -5
  380. package/dist/local/store/web/adapter.d.ts.map +1 -1
  381. package/dist/local/store/web/adapter.js +207 -74
  382. package/dist/local/store/web/adapter.js.map +1 -1
  383. package/dist/local/vault/expo-secure-store.d.ts +2 -2
  384. package/dist/local/vault/expo-secure-store.d.ts.map +1 -1
  385. package/dist/local/vault/index.d.ts +1 -1
  386. package/dist/local/vault/index.d.ts.map +1 -1
  387. package/dist/logger.d.ts +4 -4
  388. package/dist/logger.d.ts.map +1 -1
  389. package/dist/logger.js.map +1 -1
  390. package/dist/media/index.d.ts +71 -61
  391. package/dist/media/index.d.ts.map +1 -1
  392. package/dist/media/index.js +550 -386
  393. package/dist/media/index.js.map +1 -1
  394. package/dist/media/prepared-upload.d.ts +37 -0
  395. package/dist/media/prepared-upload.d.ts.map +1 -0
  396. package/dist/media/prepared-upload.js +46 -0
  397. package/dist/media/prepared-upload.js.map +1 -0
  398. package/dist/profile/contact-state.d.ts +2 -2
  399. package/dist/profile/contact-state.d.ts.map +1 -1
  400. package/dist/profile/contact-state.js.map +1 -1
  401. package/dist/profile/profile-key.d.ts +2 -2
  402. package/dist/profile/profile-key.d.ts.map +1 -1
  403. package/dist/profile/profile-key.js.map +1 -1
  404. package/dist/profile/update-service.d.ts +2 -2
  405. package/dist/profile/update-service.d.ts.map +1 -1
  406. package/dist/profile/update-service.js.map +1 -1
  407. package/dist/remote/object-store/convex-r2/server.d.ts +2 -1
  408. package/dist/remote/object-store/convex-r2/server.d.ts.map +1 -1
  409. package/dist/remote/object-store/convex-r2/server.js +4 -0
  410. package/dist/remote/object-store/convex-r2/server.js.map +1 -1
  411. package/dist/remote/object-store/convex-r2/storage.d.ts.map +1 -1
  412. package/dist/remote/object-store/convex-r2/storage.js +1 -0
  413. package/dist/remote/object-store/convex-r2/storage.js.map +1 -1
  414. package/dist/remote/object-store/index.d.ts +3 -1
  415. package/dist/remote/object-store/index.d.ts.map +1 -1
  416. package/dist/remote/object-store/index.js +1 -1
  417. package/dist/remote/object-store/index.js.map +1 -1
  418. package/dist/remote/object-store/s3/storage.d.ts +3 -1
  419. package/dist/remote/object-store/s3/storage.d.ts.map +1 -1
  420. package/dist/remote/object-store/s3/storage.js +9 -2
  421. package/dist/remote/object-store/s3/storage.js.map +1 -1
  422. package/dist/remote/object-store/types.d.ts +33 -4
  423. package/dist/remote/object-store/types.d.ts.map +1 -1
  424. package/dist/remote/object-store/upload-error.d.ts +23 -0
  425. package/dist/remote/object-store/upload-error.d.ts.map +1 -0
  426. package/dist/remote/object-store/upload-error.js +33 -0
  427. package/dist/remote/object-store/upload-error.js.map +1 -0
  428. package/dist/remote/object-store/validation.d.ts +7 -1
  429. package/dist/remote/object-store/validation.d.ts.map +1 -1
  430. package/dist/remote/object-store/validation.js +39 -25
  431. package/dist/remote/object-store/validation.js.map +1 -1
  432. package/dist/remote/relay/index.d.ts +7 -14
  433. package/dist/remote/relay/index.d.ts.map +1 -1
  434. package/dist/remote/relay/index.js +6 -13
  435. package/dist/remote/relay/index.js.map +1 -1
  436. package/dist/remote/relay/memory/adapter.d.ts +5 -4
  437. package/dist/remote/relay/memory/adapter.d.ts.map +1 -1
  438. package/dist/remote/relay/memory/adapter.js +14 -4
  439. package/dist/remote/relay/memory/adapter.js.map +1 -1
  440. package/dist/remote/relay/types.d.ts +36 -25
  441. package/dist/remote/relay/types.d.ts.map +1 -1
  442. package/dist/remote/relay/types.js +1 -1
  443. package/dist/types/api.d.ts +59 -24
  444. package/dist/types/api.d.ts.map +1 -1
  445. package/dist/types/index.js +1 -1
  446. package/dist/types/index.js.map +1 -1
  447. package/dist/types/session.d.ts +6 -0
  448. package/dist/types/session.d.ts.map +1 -1
  449. package/dist/types/session.js.map +1 -1
  450. package/docs/ASSURANCE.md +7 -7
  451. package/docs/CLIENT_COMPOSITION.md +16 -23
  452. package/docs/DEVIATIONS.md +1 -1
  453. package/docs/DOCUMENTATION_STANDARDS.md +4 -0
  454. package/docs/ERROR_HANDLING.md +2 -2
  455. package/docs/GETTING_STARTED.md +23 -38
  456. package/docs/INTERFACES.md +36 -27
  457. package/docs/PACKAGE_SURFACE.md +9 -16
  458. package/docs/RECIPES.md +10 -23
  459. package/examples/browser/index.html +2 -2
  460. package/groups/README.md +4 -4
  461. package/local/store/README.md +22 -7
  462. package/local/store/expo/README.md +24 -20
  463. package/local/store/memory/README.md +1 -1
  464. package/local/store/node/README.md +31 -2
  465. package/local/store/react-native/README.md +1 -1
  466. package/local/store/web/README.md +1 -1
  467. package/local/vault/README.md +1 -1
  468. package/media/README.md +94 -0
  469. package/package.json +17 -27
  470. package/remote/README.md +24 -24
  471. package/remote/object-store/README.md +8 -0
  472. package/remote/object-store/s3/README.md +10 -1
  473. package/remote/relay/README.md +4 -3
  474. package/remote/relay/memory/README.md +1 -1
  475. package/types/README.md +2 -2
  476. package/COMMERCIAL.md +0 -56
  477. package/dist/device/expo-metadata.d.ts.map +0 -1
  478. package/dist/device/expo-metadata.js.map +0 -1
  479. package/dist/remote/relay/convex/backend.d.ts +0 -394
  480. package/dist/remote/relay/convex/backend.d.ts.map +0 -1
  481. package/dist/remote/relay/convex/backend.js +0 -678
  482. package/dist/remote/relay/convex/backend.js.map +0 -1
  483. package/dist/remote/relay/convex/component/_generated/api.d.ts +0 -58
  484. package/dist/remote/relay/convex/component/_generated/api.d.ts.map +0 -1
  485. package/dist/remote/relay/convex/component/_generated/api.js +0 -31
  486. package/dist/remote/relay/convex/component/_generated/api.js.map +0 -1
  487. package/dist/remote/relay/convex/component/_generated/component.d.ts +0 -475
  488. package/dist/remote/relay/convex/component/_generated/component.d.ts.map +0 -1
  489. package/dist/remote/relay/convex/component/_generated/component.js +0 -11
  490. package/dist/remote/relay/convex/component/_generated/component.js.map +0 -1
  491. package/dist/remote/relay/convex/component/_generated/dataModel.d.ts +0 -46
  492. package/dist/remote/relay/convex/component/_generated/dataModel.d.ts.map +0 -1
  493. package/dist/remote/relay/convex/component/_generated/dataModel.js +0 -11
  494. package/dist/remote/relay/convex/component/_generated/dataModel.js.map +0 -1
  495. package/dist/remote/relay/convex/component/_generated/server.d.ts +0 -129
  496. package/dist/remote/relay/convex/component/_generated/server.d.ts.map +0 -1
  497. package/dist/remote/relay/convex/component/_generated/server.js +0 -79
  498. package/dist/remote/relay/convex/component/_generated/server.js.map +0 -1
  499. package/dist/remote/relay/convex/component/accounts.d.ts +0 -45
  500. package/dist/remote/relay/convex/component/accounts.d.ts.map +0 -1
  501. package/dist/remote/relay/convex/component/accounts.js +0 -184
  502. package/dist/remote/relay/convex/component/accounts.js.map +0 -1
  503. package/dist/remote/relay/convex/component/certificates.d.ts +0 -10
  504. package/dist/remote/relay/convex/component/certificates.d.ts.map +0 -1
  505. package/dist/remote/relay/convex/component/certificates.js +0 -126
  506. package/dist/remote/relay/convex/component/certificates.js.map +0 -1
  507. package/dist/remote/relay/convex/component/cleanup.d.ts +0 -32
  508. package/dist/remote/relay/convex/component/cleanup.d.ts.map +0 -1
  509. package/dist/remote/relay/convex/component/cleanup.js +0 -146
  510. package/dist/remote/relay/convex/component/cleanup.js.map +0 -1
  511. package/dist/remote/relay/convex/component/convex.config.d.ts +0 -5
  512. package/dist/remote/relay/convex/component/convex.config.d.ts.map +0 -1
  513. package/dist/remote/relay/convex/component/convex.config.js +0 -35
  514. package/dist/remote/relay/convex/component/convex.config.js.map +0 -1
  515. package/dist/remote/relay/convex/component/crons.d.ts +0 -3
  516. package/dist/remote/relay/convex/component/crons.d.ts.map +0 -1
  517. package/dist/remote/relay/convex/component/crons.js +0 -10
  518. package/dist/remote/relay/convex/component/crons.js.map +0 -1
  519. package/dist/remote/relay/convex/component/devices.d.ts +0 -102
  520. package/dist/remote/relay/convex/component/devices.d.ts.map +0 -1
  521. package/dist/remote/relay/convex/component/devices.js +0 -300
  522. package/dist/remote/relay/convex/component/devices.js.map +0 -1
  523. package/dist/remote/relay/convex/component/errors.d.ts +0 -22
  524. package/dist/remote/relay/convex/component/errors.d.ts.map +0 -1
  525. package/dist/remote/relay/convex/component/errors.js +0 -17
  526. package/dist/remote/relay/convex/component/errors.js.map +0 -1
  527. package/dist/remote/relay/convex/component/groups.d.ts +0 -63
  528. package/dist/remote/relay/convex/component/groups.d.ts.map +0 -1
  529. package/dist/remote/relay/convex/component/groups.js +0 -341
  530. package/dist/remote/relay/convex/component/groups.js.map +0 -1
  531. package/dist/remote/relay/convex/component/keys.d.ts +0 -130
  532. package/dist/remote/relay/convex/component/keys.d.ts.map +0 -1
  533. package/dist/remote/relay/convex/component/keys.js +0 -578
  534. package/dist/remote/relay/convex/component/keys.js.map +0 -1
  535. package/dist/remote/relay/convex/component/messages.d.ts +0 -105
  536. package/dist/remote/relay/convex/component/messages.d.ts.map +0 -1
  537. package/dist/remote/relay/convex/component/messages.js +0 -702
  538. package/dist/remote/relay/convex/component/messages.js.map +0 -1
  539. package/dist/remote/relay/convex/component/provisioning.d.ts +0 -92
  540. package/dist/remote/relay/convex/component/provisioning.d.ts.map +0 -1
  541. package/dist/remote/relay/convex/component/provisioning.js +0 -360
  542. package/dist/remote/relay/convex/component/provisioning.js.map +0 -1
  543. package/dist/remote/relay/convex/component/runtime.d.ts +0 -18
  544. package/dist/remote/relay/convex/component/runtime.d.ts.map +0 -1
  545. package/dist/remote/relay/convex/component/runtime.js +0 -144
  546. package/dist/remote/relay/convex/component/runtime.js.map +0 -1
  547. package/dist/remote/relay/convex/component/schema.d.ts +0 -358
  548. package/dist/remote/relay/convex/component/schema.d.ts.map +0 -1
  549. package/dist/remote/relay/convex/component/schema.js +0 -288
  550. package/dist/remote/relay/convex/component/schema.js.map +0 -1
  551. package/dist/remote/relay/convex/component/zkAuth.d.ts +0 -18
  552. package/dist/remote/relay/convex/component/zkAuth.d.ts.map +0 -1
  553. package/dist/remote/relay/convex/component/zkAuth.js +0 -86
  554. package/dist/remote/relay/convex/component/zkAuth.js.map +0 -1
  555. package/dist/remote/relay/convex/constants.d.ts +0 -3
  556. package/dist/remote/relay/convex/constants.d.ts.map +0 -1
  557. package/dist/remote/relay/convex/constants.js +0 -3
  558. package/dist/remote/relay/convex/constants.js.map +0 -1
  559. package/dist/remote/relay/convex/group-server.d.ts +0 -123
  560. package/dist/remote/relay/convex/group-server.d.ts.map +0 -1
  561. package/dist/remote/relay/convex/group-server.js +0 -184
  562. package/dist/remote/relay/convex/group-server.js.map +0 -1
  563. package/dist/remote/relay/convex/index.d.ts +0 -42
  564. package/dist/remote/relay/convex/index.d.ts.map +0 -1
  565. package/dist/remote/relay/convex/index.js +0 -38
  566. package/dist/remote/relay/convex/index.js.map +0 -1
  567. package/dist/remote/relay/convex/relay.d.ts +0 -323
  568. package/dist/remote/relay/convex/relay.d.ts.map +0 -1
  569. package/dist/remote/relay/convex/relay.js +0 -1144
  570. package/dist/remote/relay/convex/relay.js.map +0 -1
  571. package/dist/remote/relay/convex/types.d.ts +0 -24
  572. package/dist/remote/relay/convex/types.d.ts.map +0 -1
  573. package/dist/remote/relay/convex/types.js +0 -14
  574. package/dist/remote/relay/convex/types.js.map +0 -1
  575. package/remote/relay/convex/README.md +0 -61
  576. package/remote/relay/convex/component/README.md +0 -462
@@ -9,25 +9,24 @@
9
9
  * Security-critical mutable state (contact trust, one-time prekeys, and
10
10
  * sessions) is committed through one encrypted, versioned state file. A
11
11
  * write-fsync/rename/directory-fsync sequence provides a crash-durable commit
12
- * point, and an in-process mutation queue serializes compare-and-swap updates.
12
+ * point. A kernel file lock serializes state transactions across processes.
13
13
  * Other independent collections remain encrypted JSON records.
14
14
  *
15
15
  * All sensitive data encrypted before storage.
16
16
  */
17
- import { access, mkdir, open, readFile, rename, rm, unlink, writeFile } from 'node:fs/promises';
18
- import { join } from 'node:path';
17
+ import { access, mkdir, readFile, readdir, rm, unlink } from 'node:fs/promises';
18
+ import { join, resolve } from 'node:path';
19
19
  import { homedir } from 'node:os';
20
20
  import { EncryptionError, EncryptionErrorCode } from '../../../types/index.js';
21
+ import { receivedContentKey, parseReceivedContent } from '../received-content.js';
21
22
  import { resolveSignalProtocolLogger } from '../../../logger.js';
22
23
  import { MAX_UNACKNOWLEDGED_SESSION_AGE_MS } from '../../../types/protocol-config.js';
23
- import { getErrorMessage } from '../../../utils/errors.js';
24
24
  import { encryptRecord, decryptRecord } from './database-encryption.js';
25
- import { getNodeDatabaseKeyManager } from './database-key.js';
25
+ import { getNodeDatabaseKeyManager, NODE_DATABASE_RESET_FILE } from './database-key.js';
26
+ import { withNodeDatabaseLock } from './database-lock.js';
27
+ import { commitNodeDatabaseFile, isNodeDatabaseDataEntry, isNodeDatabaseRecord, syncNodeDatabaseDirectory, } from './database-file-commit.js';
28
+ import { createKyberPreKeyState, createKyberPreKeyInstanceId, getCurrentKyberPreKey, getRetainedKyberPreKey, retainKyberPreKey, recordKyberPreKeyUse, recordKyberPreKeyUseById, } from '../kyber-prekey-lifecycle.js';
26
29
  const DEFAULT_DATA_DIR = join(homedir(), '.config', 'open-e2ee', 'signal-protocol');
27
- /**
28
- * File permissions for encrypted data (0600 = owner read/write only)
29
- */
30
- const SECURE_FILE_MODE = 0o600;
31
30
  function emptyDictionary() {
32
31
  return Object.create(null);
33
32
  }
@@ -45,7 +44,7 @@ function createEmptySecurityState() {
45
44
  messageRecords: emptyDictionary(),
46
45
  metadata: emptyDictionary(),
47
46
  registrationIds: emptyDictionary(),
48
- kyberUsage: emptyDictionary(),
47
+ kyberPreKeyStates: emptyDictionary(),
49
48
  };
50
49
  }
51
50
  /**
@@ -78,7 +77,6 @@ export class NodeEncryptedDatabase {
78
77
  securityStatePath;
79
78
  logger;
80
79
  securityStateMutation = Promise.resolve();
81
- atomicWriteCounter = 0;
82
80
  /**
83
81
  * Create a new NodeEncryptedDatabase instance
84
82
  *
@@ -102,25 +100,23 @@ export class NodeEncryptedDatabase {
102
100
  return this.initPromise;
103
101
  }
104
102
  // Create new initialization promise
105
- this.initPromise = this._initialize();
103
+ this.initPromise = this._initialize().catch((error) => {
104
+ this.initPromise = null;
105
+ throw error;
106
+ });
106
107
  return this.initPromise;
107
108
  }
108
109
  async _initialize() {
109
110
  try {
110
- // Create directory structure
111
- await mkdir(this.dataDir, { recursive: true, mode: 0o700 });
112
- await mkdir(this.sessionsDir, { recursive: true, mode: 0o700 });
113
- // Get database encryption key
114
111
  const dbKeyManager = getNodeDatabaseKeyManager(this.dataDir);
115
- const hasKey = await dbKeyManager.hasKey();
116
- if (!hasKey) {
117
- // First initialization - generate database key
118
- await dbKeyManager.initialize();
119
- }
120
- this.dbKey = await dbKeyManager.getKeyOrThrow();
121
- await this.initializeAtomicSecurityState();
112
+ await dbKeyManager.withKey(async (key) => {
113
+ await mkdir(this.sessionsDir, { recursive: true, mode: 0o700 });
114
+ this.dbKey = key;
115
+ await this.initializeAtomicSecurityState();
116
+ }, true);
122
117
  }
123
118
  catch (error) {
119
+ this.dbKey = null;
124
120
  throw new EncryptionError('Failed to initialize encrypted database', EncryptionErrorCode.INITIALIZATION_FAILED, { originalError: error });
125
121
  }
126
122
  }
@@ -128,9 +124,15 @@ export class NodeEncryptedDatabase {
128
124
  * Initialize the database if it is not initialized yet
129
125
  */
130
126
  async ensureInitialized() {
131
- if (!this.dbKey) {
132
- await this.initialize();
133
- }
127
+ await this.initialize();
128
+ }
129
+ async withCurrentKey(operation) {
130
+ return getNodeDatabaseKeyManager(this.dataDir).withKey(async (key) => {
131
+ if (!this.dbKey || !Buffer.from(key).equals(Buffer.from(this.dbKey))) {
132
+ throw new Error('Node database authority changed. Close and reopen the store before retrying.');
133
+ }
134
+ return operation();
135
+ });
134
136
  }
135
137
  /**
136
138
  * Direct pre-1.0 format reset. Contacts, one-time prekeys, and sessions now
@@ -205,56 +207,32 @@ export class NodeEncryptedDatabase {
205
207
  messageRecords: toNullPrototype(decoded.messageRecords, 2),
206
208
  metadata: toNullPrototype(decoded.metadata, 1),
207
209
  registrationIds: toNullPrototype(decoded.registrationIds, 1),
208
- kyberUsage: toNullPrototype(decoded.kyberUsage, 1),
210
+ kyberPreKeyStates: toNullPrototype(decoded.kyberPreKeyStates, 1),
209
211
  };
210
212
  }
211
213
  async writeSecurityStateFile(state) {
212
214
  const encrypted = encryptRecord(state, this.dbKey);
213
- const tempPath = `${this.securityStatePath}.${process.pid}.${this.atomicWriteCounter++}.tmp`;
214
215
  try {
215
- await writeFile(tempPath, JSON.stringify(encrypted), {
216
- mode: SECURE_FILE_MODE,
217
- encoding: 'utf8',
218
- });
219
- const handle = await open(tempPath, 'r');
220
- try {
221
- await handle.sync();
222
- }
223
- finally {
224
- await handle.close();
225
- }
226
- await rename(tempPath, this.securityStatePath);
227
- // POSIX rename is atomic, but the containing directory must also be
228
- // synchronized for the new directory entry to survive sudden power loss.
229
- // Windows does not support opening directories this way.
230
- if (process.platform !== 'win32') {
231
- const directoryHandle = await open(this.dataDir, 'r');
232
- try {
233
- await directoryHandle.sync();
234
- }
235
- finally {
236
- await directoryHandle.close();
237
- }
238
- }
216
+ await commitNodeDatabaseFile(this.securityStatePath, JSON.stringify(encrypted));
239
217
  }
240
218
  catch (error) {
241
- await unlink(tempPath).catch(() => undefined);
242
219
  throw new EncryptionError('Failed to atomically write Node protocol security state', EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
243
220
  }
244
221
  }
245
222
  async readSecurityState() {
246
223
  await this.ensureInitialized();
247
224
  await this.securityStateMutation;
248
- return await this.readSecurityStateFile();
225
+ return this.withCurrentKey(() => this.readSecurityStateFile());
249
226
  }
250
- async mutateSecurityState(mutation) {
227
+ async mutateSecurityState(mutation, commitWhen = () => true) {
251
228
  await this.ensureInitialized();
252
- const operation = this.securityStateMutation.then(async () => {
229
+ const operation = this.securityStateMutation.then(() => this.withCurrentKey(async () => {
253
230
  const state = await this.readSecurityStateFile();
254
231
  const result = mutation(state);
255
- await this.writeSecurityStateFile(state);
232
+ if (commitWhen(result))
233
+ await this.writeSecurityStateFile(state);
256
234
  return result;
257
- });
235
+ }));
258
236
  this.securityStateMutation = operation.then(() => undefined, () => undefined);
259
237
  return await operation;
260
238
  }
@@ -262,7 +240,10 @@ export class NodeEncryptedDatabase {
262
240
  * Get file path for a collection
263
241
  */
264
242
  getCollectionPath(collection) {
265
- return join(this.dataDir, `${collection}.json`);
243
+ const name = `${collection}.json`;
244
+ if (!isNodeDatabaseRecord(name))
245
+ throw new Error('Invalid Node database collection.');
246
+ return join(this.dataDir, name);
266
247
  }
267
248
  // ============================================================================
268
249
  // Generic Collection Operations
@@ -272,49 +253,54 @@ export class NodeEncryptedDatabase {
272
253
  */
273
254
  async readCollection(collection) {
274
255
  await this.ensureInitialized();
275
- const filePath = this.getCollectionPath(collection);
276
- try {
277
- const fileData = await readFile(filePath, 'utf8');
278
- const encrypted = JSON.parse(fileData);
279
- return decryptRecord(encrypted, this.dbKey);
280
- }
281
- catch (error) {
282
- if (error.code === 'ENOENT') {
283
- return [];
256
+ return this.withCurrentKey(async () => {
257
+ const filePath = this.getCollectionPath(collection);
258
+ try {
259
+ const fileData = await readFile(filePath, 'utf8');
260
+ const encrypted = JSON.parse(fileData);
261
+ return decryptRecord(encrypted, this.dbKey);
284
262
  }
285
- throw new EncryptionError(`Failed to read collection: ${collection}`, EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
286
- }
263
+ catch (error) {
264
+ if (error.code === 'ENOENT') {
265
+ return [];
266
+ }
267
+ throw new EncryptionError(`Failed to read collection: ${collection}`, EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
268
+ }
269
+ });
287
270
  }
288
271
  /**
289
272
  * Write a collection to disk
290
273
  */
291
274
  async writeCollection(collection, data) {
292
275
  await this.ensureInitialized();
293
- const filePath = this.getCollectionPath(collection);
294
- const encrypted = encryptRecord(data, this.dbKey);
295
- try {
296
- await writeFile(filePath, JSON.stringify(encrypted), {
297
- mode: SECURE_FILE_MODE,
298
- encoding: 'utf8',
299
- });
300
- }
301
- catch (error) {
302
- throw new EncryptionError(`Failed to write collection: ${collection}`, EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
303
- }
276
+ return this.withCurrentKey(async () => {
277
+ const filePath = this.getCollectionPath(collection);
278
+ const encrypted = encryptRecord(data, this.dbKey);
279
+ try {
280
+ await commitNodeDatabaseFile(filePath, JSON.stringify(encrypted));
281
+ }
282
+ catch (error) {
283
+ throw new EncryptionError(`Failed to write collection: ${collection}`, EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
284
+ }
285
+ });
304
286
  }
305
287
  /**
306
288
  * Delete a collection from disk
307
289
  */
308
290
  async deleteCollection(collection) {
309
- const filePath = this.getCollectionPath(collection);
310
- try {
311
- await unlink(filePath);
312
- }
313
- catch (error) {
314
- if (error.code !== 'ENOENT') {
315
- throw new EncryptionError(`Failed to delete collection: ${collection}`, EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
291
+ await this.ensureInitialized();
292
+ return this.withCurrentKey(async () => {
293
+ const filePath = this.getCollectionPath(collection);
294
+ try {
295
+ await unlink(filePath);
296
+ await syncNodeDatabaseDirectory(this.dataDir);
316
297
  }
317
- }
298
+ catch (error) {
299
+ if (error.code !== 'ENOENT') {
300
+ throw new EncryptionError(`Failed to delete collection: ${collection}`, EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
301
+ }
302
+ }
303
+ });
318
304
  }
319
305
  // ============================================================================
320
306
  // Identity Keys
@@ -470,34 +456,39 @@ export class NodeEncryptedDatabase {
470
456
  // ============================================================================
471
457
  // Kyber PreKeys
472
458
  // ============================================================================
473
- async storeKyberPreKey(id, key, identityType = 'aci') {
474
- const collection = `kyber_prekeys_${identityType}`;
475
- const keys = await this.readCollection(collection);
476
- // Replace existing key with same ID
477
- const filtered = keys.filter((k) => k.id !== id);
478
- filtered.push({ id, data: key });
479
- await this.writeCollection(collection, filtered);
459
+ async storeKyberPreKey(key, identityType = 'aci') {
460
+ const instanceId = await createKyberPreKeyInstanceId();
461
+ await this.mutateSecurityState((state) => {
462
+ const kyberState = state.kyberPreKeyStates[identityType] ??
463
+ (state.kyberPreKeyStates[identityType] = createKyberPreKeyState());
464
+ retainKyberPreKey(kyberState, key, identityType, Date.now(), instanceId);
465
+ });
480
466
  }
481
- async getKyberPreKey(id, identityType = 'aci') {
482
- const collection = `kyber_prekeys_${identityType}`;
483
- const keys = await this.readCollection(collection);
484
- const found = keys.find((k) => k.id === id);
485
- return found ? found.data : null;
467
+ async getCurrentKyberPreKey(identityType = 'aci') {
468
+ const state = await this.readSecurityState();
469
+ return getCurrentKyberPreKey(state.kyberPreKeyStates[identityType]);
470
+ }
471
+ async getKyberPreKeyById(id, identityType = 'aci') {
472
+ const state = await this.readSecurityState();
473
+ return getRetainedKyberPreKey(state.kyberPreKeyStates[identityType], id);
486
474
  }
487
475
  async deleteKyberPreKey(id, identityType = 'aci') {
488
- const collection = `kyber_prekeys_${identityType}`;
489
- const keys = await this.readCollection(collection);
490
- const filtered = keys.filter((k) => k.id !== id);
491
- await this.writeCollection(collection, filtered);
476
+ await this.mutateSecurityState((state) => {
477
+ const kyberState = state.kyberPreKeyStates[identityType];
478
+ if (!kyberState)
479
+ return;
480
+ delete kyberState.instances[String(id)];
481
+ if (kyberState.currentKeyId === id)
482
+ kyberState.currentKeyId = null;
483
+ });
492
484
  }
493
485
  async deleteAllKyberPreKeys(identityType) {
494
- if (identityType) {
495
- await this.deleteCollection(`kyber_prekeys_${identityType}`);
496
- }
497
- else {
498
- await this.deleteCollection('kyber_prekeys_aci');
499
- await this.deleteCollection('kyber_prekeys_pni');
500
- }
486
+ await this.mutateSecurityState((state) => {
487
+ if (identityType)
488
+ delete state.kyberPreKeyStates[identityType];
489
+ else
490
+ state.kyberPreKeyStates = emptyDictionary();
491
+ });
501
492
  }
502
493
  // ============================================================================
503
494
  // Sessions
@@ -527,7 +518,7 @@ export class NodeEncryptedDatabase {
527
518
  state.sessions = emptyDictionary();
528
519
  });
529
520
  }
530
- async commitSessionTrust(sessionId, userId, deviceId, serializedRecord, localIdentityType, contactKey, contactMutation, oneTimePreKeyId, kemOneTimePreKeyId) {
521
+ async commitSessionTrust(sessionId, userId, deviceId, serializedRecord, localIdentityType, contactKey, contactMutation, oneTimePreKeyId, kemOneTimePreKeyId, receivedContent, kyberPreKeyUse) {
531
522
  await this.mutateSecurityState((state) => {
532
523
  if (oneTimePreKeyId !== undefined &&
533
524
  !(state.ecOneTimePreKeys[localIdentityType] ?? []).some((key) => key.keyId === oneTimePreKeyId)) {
@@ -537,8 +528,13 @@ export class NodeEncryptedDatabase {
537
528
  !(state.kemOneTimePreKeys[localIdentityType] ?? []).some((key) => key.keyId === kemOneTimePreKeyId)) {
538
529
  throw new Error('Atomic session/trust commit cannot consume a missing KEM one-time prekey');
539
530
  }
531
+ if (kyberPreKeyUse) {
532
+ recordKyberPreKeyUse(state.kyberPreKeyStates[localIdentityType], localIdentityType, kyberPreKeyUse);
533
+ }
540
534
  state.contacts[contactKey] = contactMutation(state.contacts[contactKey] ?? null);
541
535
  state.sessions[sessionId] = { userId, deviceId, serializedRecord };
536
+ if (receivedContent)
537
+ state.metadata[receivedContentKey(receivedContent.id)] = JSON.stringify(receivedContent);
542
538
  if (oneTimePreKeyId !== undefined) {
543
539
  state.ecOneTimePreKeys[localIdentityType] = (state.ecOneTimePreKeys[localIdentityType] ?? []).filter((key) => key.keyId !== oneTimePreKeyId);
544
540
  }
@@ -556,10 +552,7 @@ export class NodeEncryptedDatabase {
556
552
  // ============================================================================
557
553
  async readSesameState() {
558
554
  const state = await this.readSecurityState();
559
- return {
560
- users: state.sesameUsers,
561
- sessions: state.sessions,
562
- };
555
+ return { users: state.sesameUsers, sessions: state.sessions };
563
556
  }
564
557
  /** Drop every session and every SESAME device record in one commit. */
565
558
  async clearSesameState() {
@@ -569,10 +562,7 @@ export class NodeEncryptedDatabase {
569
562
  });
570
563
  }
571
564
  async mutateSesameState(mutation) {
572
- return await this.mutateSecurityState((state) => mutation({
573
- users: state.sesameUsers,
574
- sessions: state.sessions,
575
- }));
565
+ return await this.mutateSecurityState((state) => mutation({ users: state.sesameUsers, sessions: state.sessions }));
576
566
  }
577
567
  // ============================================================================
578
568
  // Sender Keys (Group Messaging)
@@ -592,12 +582,17 @@ export class NodeEncryptedDatabase {
592
582
  * together. A crash between them would leave a sender key whose in-flight
593
583
  * messages can no longer be resolved.
594
584
  */
595
- async mutateSenderKeyState(mutation) {
596
- return await this.mutateSecurityState((state) => mutation({
597
- current: state.senderKeys,
598
- records: state.senderKeyRecords,
599
- skipped: state.skippedSenderKeys,
600
- }));
585
+ async mutateSenderKeyState(mutation, receivedContent) {
586
+ return await this.mutateSecurityState((state) => {
587
+ const result = mutation({
588
+ current: state.senderKeys,
589
+ records: state.senderKeyRecords,
590
+ skipped: state.skippedSenderKeys,
591
+ });
592
+ if (receivedContent)
593
+ state.metadata[receivedContentKey(receivedContent.id)] = JSON.stringify(receivedContent);
594
+ return result;
595
+ });
601
596
  }
602
597
  // ============================================================================
603
598
  // Message Records (SESAME Retry Support)
@@ -626,6 +621,32 @@ export class NodeEncryptedDatabase {
626
621
  delete state.metadata[key];
627
622
  });
628
623
  }
624
+ async deleteExpiredReceivedContent(before) {
625
+ return this.mutateSecurityState((state) => {
626
+ let count = 0;
627
+ const prefix = receivedContentKey('');
628
+ for (const [key, value] of Object.entries(state.metadata)) {
629
+ if (!key.startsWith(prefix))
630
+ continue;
631
+ if (parseReceivedContent(value, key.slice(prefix.length)).receivedAt < before) {
632
+ delete state.metadata[key];
633
+ count++;
634
+ }
635
+ }
636
+ return count;
637
+ });
638
+ }
639
+ async compareAndSetMetadataValue(key, expected, value) {
640
+ return this.mutateSecurityState((state) => {
641
+ if ((state.metadata[key] ?? null) !== expected)
642
+ return false;
643
+ if (value === null)
644
+ delete state.metadata[key];
645
+ else
646
+ state.metadata[key] = value;
647
+ return true;
648
+ }, (changed) => changed);
649
+ }
629
650
  async getRegistrationId(identityType) {
630
651
  const state = await this.readSecurityState();
631
652
  return state.registrationIds[identityType] ?? 0;
@@ -635,9 +656,9 @@ export class NodeEncryptedDatabase {
635
656
  state.registrationIds[identityType] = id;
636
657
  });
637
658
  }
638
- async markKyberPreKeyUsed(key, usage) {
659
+ async markKyberPreKeyUsed(identityType, usage) {
639
660
  await this.mutateSecurityState((state) => {
640
- state.kyberUsage[key] = usage;
661
+ recordKyberPreKeyUseById(state.kyberPreKeyStates[identityType], identityType, usage);
641
662
  });
642
663
  }
643
664
  // ============================================================================
@@ -648,50 +669,41 @@ export class NodeEncryptedDatabase {
648
669
  return keys.reduce((max, key) => (key.keyId > max ? key.keyId : max), 0);
649
670
  }
650
671
  async getKyberPreKeyMaxId(identityType = 'aci') {
651
- const keys = await this.readCollection(`kyber_prekeys_${identityType}`);
652
- return keys.reduce((max, key) => (key.id > max ? key.id : max), 0);
672
+ const state = await this.readSecurityState();
673
+ const instances = state.kyberPreKeyStates[identityType]?.instances ?? {};
674
+ return Object.keys(instances).reduce((max, id) => Math.max(max, Number(id)), 0);
653
675
  }
654
676
  async deleteAllPreKeys(identityType = 'aci') {
655
- const [signedPreKeys, kyberPreKeys] = await Promise.all([
656
- this.readCollection(`signed_prekeys_${identityType}`),
657
- this.readCollection(`kyber_prekeys_${identityType}`),
658
- ]);
677
+ const signedPreKeys = await this.readCollection(`signed_prekeys_${identityType}`);
659
678
  const oneTimeCounts = await this.mutateSecurityState((state) => {
660
679
  const ec = (state.ecOneTimePreKeys[identityType] ?? []).length;
661
680
  const kem = (state.kemOneTimePreKeys[identityType] ?? []).length;
681
+ const kyber = Object.keys(state.kyberPreKeyStates[identityType]?.instances ?? {}).length;
662
682
  delete state.ecOneTimePreKeys[identityType];
663
683
  delete state.kemOneTimePreKeys[identityType];
664
- for (const key of Object.keys(state.kyberUsage)) {
665
- if (key.startsWith(`${identityType}:`))
666
- delete state.kyberUsage[key];
667
- }
668
- return { ec, kem };
684
+ delete state.kyberPreKeyStates[identityType];
685
+ return { ec, kem, kyber };
669
686
  });
670
- await Promise.all([
671
- this.deleteCollection(`signed_prekeys_${identityType}`),
672
- this.deleteCollection(`kyber_prekeys_${identityType}`),
673
- ]);
687
+ await Promise.all([this.deleteCollection(`signed_prekeys_${identityType}`)]);
674
688
  return {
675
689
  ecSignedPreKeys: signedPreKeys.length,
676
690
  ecOneTimePreKeys: oneTimeCounts.ec,
677
- kyberPreKeys: kyberPreKeys.length,
691
+ kyberPreKeys: oneTimeCounts.kyber,
678
692
  kemOneTimePreKeys: oneTimeCounts.kem,
679
693
  };
680
694
  }
681
695
  async getDetailedStats() {
682
696
  const state = await this.readSecurityState();
683
- const [signedAci, signedPni, kyberAci, kyberPni] = await Promise.all([
697
+ const [signedAci, signedPni] = await Promise.all([
684
698
  this.readCollection(`signed_prekeys_aci`).then((keys) => keys.length),
685
699
  this.readCollection(`signed_prekeys_pni`).then((keys) => keys.length),
686
- this.readCollection(`kyber_prekeys_aci`).then((keys) => keys.length),
687
- this.readCollection(`kyber_prekeys_pni`).then((keys) => keys.length),
688
700
  ]);
689
701
  const total = (collection) => Object.values(collection).reduce((count, keys) => count + keys.length, 0);
690
702
  return {
691
703
  sessions: Object.keys(state.sessions).length,
692
704
  ecSignedPreKeys: signedAci + signedPni,
693
705
  ecOneTimePreKeys: total(state.ecOneTimePreKeys),
694
- kyberPreKeys: kyberAci + kyberPni,
706
+ kyberPreKeys: Object.values(state.kyberPreKeyStates).reduce((count, kyberState) => count + Object.keys(kyberState.instances).length, 0),
695
707
  kemOneTimePreKeys: total(state.kemOneTimePreKeys),
696
708
  users: Object.keys(state.sesameUsers).length,
697
709
  };
@@ -702,7 +714,7 @@ export class NodeEncryptedDatabase {
702
714
  async getStats() {
703
715
  await this.ensureInitialized();
704
716
  const securityState = await this.readSecurityState();
705
- const [identityAci, identityPni, signedAci, signedPni, kyberAci, kyberPni,] = await Promise.all([
717
+ const [identityAci, identityPni, signedAci, signedPni] = await Promise.all([
706
718
  this.readCollection('identity_keys_aci')
707
719
  .then((keys) => keys.length)
708
720
  .catch(() => 0),
@@ -715,18 +727,12 @@ export class NodeEncryptedDatabase {
715
727
  this.readCollection('signed_prekeys_pni')
716
728
  .then((keys) => keys.length)
717
729
  .catch(() => 0),
718
- this.readCollection('kyber_prekeys_aci')
719
- .then((keys) => keys.length)
720
- .catch(() => 0),
721
- this.readCollection('kyber_prekeys_pni')
722
- .then((keys) => keys.length)
723
- .catch(() => 0),
724
730
  ]);
725
731
  return {
726
732
  identityKeys: identityAci + identityPni,
727
733
  signedPreKeys: signedAci + signedPni,
728
734
  oneTimePreKeys: Object.values(securityState.ecOneTimePreKeys).reduce((count, keys) => count + keys.length, 0),
729
- kyberPreKeys: kyberAci + kyberPni,
735
+ kyberPreKeys: Object.values(securityState.kyberPreKeyStates).reduce((count, kyberState) => count + Object.keys(kyberState.instances).length, 0),
730
736
  sessions: Object.keys(securityState.sessions).length,
731
737
  };
732
738
  }
@@ -737,6 +743,8 @@ export class NodeEncryptedDatabase {
737
743
  * Close database (cleanup)
738
744
  */
739
745
  async close() {
746
+ await this.initPromise?.catch(() => undefined);
747
+ await this.securityStateMutation;
740
748
  this.dbKey = null;
741
749
  this.initPromise = null;
742
750
  }
@@ -749,70 +757,57 @@ export class NodeEncryptedDatabase {
749
757
  * @returns true if database was deleted, false if it did not exist
750
758
  */
751
759
  async deleteDatabase() {
752
- try {
753
- // Close database connection if open
754
- await this.close();
755
- // Check if directory exists
756
- const exists = await this.databaseExists();
757
- if (!exists) {
758
- this.logger.info('[NodeEncryptedDatabase] Database does not exist, skipping deletion', {
759
- dataDir: this.dataDir,
760
- });
760
+ await this.initPromise?.catch(() => undefined);
761
+ await this.securityStateMutation;
762
+ return withNodeDatabaseLock(this.dataDir, async () => {
763
+ const entries = (await readdir(this.dataDir)).filter(isNodeDatabaseDataEntry);
764
+ if (entries.length === 0)
761
765
  return false;
766
+ if (this.dbKey && !entries.includes(NODE_DATABASE_RESET_FILE)) {
767
+ const key = await readFile(join(this.dataDir, 'db.key'));
768
+ if (!key.equals(Buffer.from(this.dbKey))) {
769
+ throw new Error('Node database authority changed. Refusing reset from a stale handle.');
770
+ }
762
771
  }
763
- // Delete the database directory recursively
764
- await rm(this.dataDir, { recursive: true, force: true });
765
- this.logger.info('[NodeEncryptedDatabase] Database deleted successfully', {
766
- dataDir: this.dataDir,
767
- });
768
- return true;
769
- }
770
- catch (error) {
771
- // Log error but do not throw - safe deletion should be idempotent
772
- this.logger.warn('[NodeEncryptedDatabase] Error during database deletion (safe to ignore)', {
773
- dataDir: this.dataDir,
774
- error: getErrorMessage(error),
775
- });
776
- return false;
777
- }
778
- }
779
- /**
780
- * Check if database directory exists
781
- *
782
- * @returns true if database directory exists on filesystem
783
- */
784
- async databaseExists() {
785
- try {
786
- await access(this.dataDir);
772
+ const marker = join(this.dataDir, NODE_DATABASE_RESET_FILE);
773
+ await commitNodeDatabaseFile(marker, 'reset');
774
+ for (const entry of entries) {
775
+ if (entry !== NODE_DATABASE_RESET_FILE)
776
+ await rm(join(this.dataDir, entry), { recursive: true, force: true });
777
+ }
778
+ await syncNodeDatabaseDirectory(this.dataDir);
779
+ await unlink(marker);
780
+ await syncNodeDatabaseDirectory(this.dataDir);
781
+ this.dbKey = null;
782
+ this.initPromise = null;
783
+ this.logger.info('[NodeEncryptedDatabase] Database reset complete');
787
784
  return true;
788
- }
789
- catch {
790
- return false;
791
- }
785
+ });
792
786
  }
793
787
  }
794
788
  /**
795
789
  * Singleton instance
796
790
  */
797
- let encryptedDatabaseInstance = null;
791
+ const encryptedDatabaseInstances = new Map();
798
792
  /**
799
793
  * Get singleton NodeEncryptedDatabase instance
800
794
  *
801
795
  * @param dataDir Optional custom data directory
802
796
  */
803
797
  export function getNodeEncryptedDatabase(dataDir) {
804
- if (!encryptedDatabaseInstance || (dataDir && encryptedDatabaseInstance['dataDir'] !== dataDir)) {
805
- encryptedDatabaseInstance = new NodeEncryptedDatabase(dataDir);
798
+ const path = resolve(dataDir ?? DEFAULT_DATA_DIR);
799
+ let instance = encryptedDatabaseInstances.get(path);
800
+ if (!instance) {
801
+ instance = new NodeEncryptedDatabase(path);
802
+ encryptedDatabaseInstances.set(path, instance);
806
803
  }
807
- return encryptedDatabaseInstance;
804
+ return instance;
808
805
  }
809
806
  /**
810
807
  * Reset the singleton for controlled local teardown.
811
808
  */
812
809
  export async function resetNodeEncryptedDatabase() {
813
- if (encryptedDatabaseInstance) {
814
- await encryptedDatabaseInstance.close();
815
- }
816
- encryptedDatabaseInstance = null;
810
+ await Promise.all([...encryptedDatabaseInstances.values()].map((instance) => instance.close()));
811
+ encryptedDatabaseInstances.clear();
817
812
  }
818
813
  //# sourceMappingURL=database.js.map