@open-e2ee/signal-protocol-sdk 7.1.0 → 8.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 (698) hide show
  1. package/ADAPTERS.md +55 -6
  2. package/ARCHITECTURE.md +1 -0
  3. package/CHANGELOG.md +565 -0
  4. package/README.md +19 -5
  5. package/SECURITY.md +2 -2
  6. package/THIRD_PARTY_NOTICES.md +429 -0
  7. package/TROUBLESHOOTING.md +10 -0
  8. package/client/README.md +1 -2
  9. package/device/README.md +50 -19
  10. package/dist/client/client.d.ts +31 -5
  11. package/dist/client/client.d.ts.map +1 -1
  12. package/dist/client/client.js +149 -90
  13. package/dist/client/client.js.map +1 -1
  14. package/dist/client/event-hooks.d.ts.map +1 -1
  15. package/dist/client/event-hooks.js +2 -0
  16. package/dist/client/event-hooks.js.map +1 -1
  17. package/dist/client/files.d.ts.map +1 -1
  18. package/dist/client/files.js +19 -2
  19. package/dist/client/files.js.map +1 -1
  20. package/dist/client/headless.d.ts +1 -1
  21. package/dist/client/headless.js +1 -1
  22. package/dist/client/hosted-anonymous-delivery.d.ts.map +1 -1
  23. package/dist/client/hosted-anonymous-delivery.js +2 -1
  24. package/dist/client/hosted-anonymous-delivery.js.map +1 -1
  25. package/dist/client/hosted-connection.d.ts +1 -1
  26. package/dist/client/hosted-connection.d.ts.map +1 -1
  27. package/dist/client/hosted-connection.js +8 -12
  28. package/dist/client/hosted-connection.js.map +1 -1
  29. package/dist/client/hosted-group-authority.d.ts.map +1 -1
  30. package/dist/client/hosted-group-authority.js +2 -1
  31. package/dist/client/hosted-group-authority.js.map +1 -1
  32. package/dist/client/hosted-groups.d.ts.map +1 -1
  33. package/dist/client/hosted-groups.js +2 -1
  34. package/dist/client/hosted-groups.js.map +1 -1
  35. package/dist/client/hosted-push.d.ts.map +1 -1
  36. package/dist/client/hosted-push.js +2 -1
  37. package/dist/client/hosted-push.js.map +1 -1
  38. package/dist/client/hosted-transport.d.ts.map +1 -1
  39. package/dist/client/hosted-transport.js +10 -11
  40. package/dist/client/hosted-transport.js.map +1 -1
  41. package/dist/client/hosted-trust.d.ts +11 -11
  42. package/dist/client/hosted-trust.d.ts.map +1 -1
  43. package/dist/client/hosted-trust.js +12 -12
  44. package/dist/client/hosted-trust.js.map +1 -1
  45. package/dist/client/messages.d.ts.map +1 -1
  46. package/dist/client/messages.js +6 -1
  47. package/dist/client/messages.js.map +1 -1
  48. package/dist/client/multi-device.d.ts.map +1 -1
  49. package/dist/client/multi-device.js +2 -1
  50. package/dist/client/multi-device.js.map +1 -1
  51. package/dist/client/relay-lifecycle.d.ts +6 -2
  52. package/dist/client/relay-lifecycle.d.ts.map +1 -1
  53. package/dist/client/relay-lifecycle.js.map +1 -1
  54. package/dist/client/relay-work.d.ts +30 -0
  55. package/dist/client/relay-work.d.ts.map +1 -0
  56. package/dist/client/relay-work.js +189 -0
  57. package/dist/client/relay-work.js.map +1 -0
  58. package/dist/client/retry.d.ts.map +1 -1
  59. package/dist/client/retry.js +2 -0
  60. package/dist/client/retry.js.map +1 -1
  61. package/dist/client/sessions.d.ts.map +1 -1
  62. package/dist/client/sessions.js +3 -0
  63. package/dist/client/sessions.js.map +1 -1
  64. package/dist/client/signal-service-cipher.d.ts +39 -16
  65. package/dist/client/signal-service-cipher.d.ts.map +1 -1
  66. package/dist/client/signal-service-cipher.js +100 -60
  67. package/dist/client/signal-service-cipher.js.map +1 -1
  68. package/dist/client/state.d.ts +8 -0
  69. package/dist/client/state.d.ts.map +1 -1
  70. package/dist/client/state.js +11 -0
  71. package/dist/client/state.js.map +1 -1
  72. package/dist/client/types.d.ts +5 -1
  73. package/dist/client/types.d.ts.map +1 -1
  74. package/dist/client/types.js.map +1 -1
  75. package/dist/device/connection.d.ts +1 -1
  76. package/dist/device/connection.d.ts.map +1 -1
  77. package/dist/device/connection.js +4 -11
  78. package/dist/device/connection.js.map +1 -1
  79. package/dist/device/device-id.d.ts +10 -4
  80. package/dist/device/device-id.d.ts.map +1 -1
  81. package/dist/device/device-id.js +15 -9
  82. package/dist/device/device-id.js.map +1 -1
  83. package/dist/device/device-name-crypto.d.ts.map +1 -1
  84. package/dist/device/device-name-crypto.js +2 -2
  85. package/dist/device/device-name-crypto.js.map +1 -1
  86. package/dist/device/expo/index.d.ts +25 -8
  87. package/dist/device/expo/index.d.ts.map +1 -1
  88. package/dist/device/expo/index.js +58 -8
  89. package/dist/device/expo/index.js.map +1 -1
  90. package/dist/device/index.d.ts +2 -2
  91. package/dist/device/index.d.ts.map +1 -1
  92. package/dist/device/index.js +3 -2
  93. package/dist/device/index.js.map +1 -1
  94. package/dist/device/lifecycle/index.d.ts +4 -2
  95. package/dist/device/lifecycle/index.d.ts.map +1 -1
  96. package/dist/device/lifecycle/index.js.map +1 -1
  97. package/dist/device/lifecycle/manager.d.ts +12 -14
  98. package/dist/device/lifecycle/manager.d.ts.map +1 -1
  99. package/dist/device/lifecycle/manager.js +52 -97
  100. package/dist/device/lifecycle/manager.js.map +1 -1
  101. package/dist/device/lifecycle/types.d.ts +26 -16
  102. package/dist/device/lifecycle/types.d.ts.map +1 -1
  103. package/dist/device/lifecycle/utils.d.ts +8 -4
  104. package/dist/device/lifecycle/utils.d.ts.map +1 -1
  105. package/dist/device/lifecycle/utils.js +12 -16
  106. package/dist/device/lifecycle/utils.js.map +1 -1
  107. package/dist/device/provisioning.d.ts.map +1 -1
  108. package/dist/device/provisioning.js +6 -8
  109. package/dist/device/provisioning.js.map +1 -1
  110. package/dist/device/react-native/index.d.ts +40 -0
  111. package/dist/device/react-native/index.d.ts.map +1 -0
  112. package/dist/device/react-native/index.js +74 -0
  113. package/dist/device/react-native/index.js.map +1 -0
  114. package/dist/device/transfer.d.ts +15 -7
  115. package/dist/device/transfer.d.ts.map +1 -1
  116. package/dist/device/transfer.js +30 -22
  117. package/dist/device/transfer.js.map +1 -1
  118. package/dist/device/types.d.ts +15 -7
  119. package/dist/device/types.d.ts.map +1 -1
  120. package/dist/device/types.js.map +1 -1
  121. package/dist/device/vault-text.d.ts +13 -0
  122. package/dist/device/vault-text.d.ts.map +1 -0
  123. package/dist/device/vault-text.js +17 -0
  124. package/dist/device/vault-text.js.map +1 -0
  125. package/dist/hooks/use-key-rotation.d.ts.map +1 -1
  126. package/dist/hooks/use-key-rotation.js +2 -1
  127. package/dist/hooks/use-key-rotation.js.map +1 -1
  128. package/dist/index.d.ts +9 -5
  129. package/dist/index.d.ts.map +1 -1
  130. package/dist/index.js +9 -5
  131. package/dist/index.js.map +1 -1
  132. package/dist/internal/crypto/index.d.ts +3 -3
  133. package/dist/internal/crypto/index.d.ts.map +1 -1
  134. package/dist/internal/crypto/index.js +3 -3
  135. package/dist/internal/crypto/index.js.map +1 -1
  136. package/dist/internal/crypto/random-host.d.ts +1 -1
  137. package/dist/internal/crypto/random-host.d.ts.map +1 -1
  138. package/dist/internal/crypto/random-host.js +3 -2
  139. package/dist/internal/crypto/random-host.js.map +1 -1
  140. package/dist/internal/crypto/random-host.native.d.ts +6 -1
  141. package/dist/internal/crypto/random-host.native.d.ts.map +1 -1
  142. package/dist/internal/crypto/random-host.native.js +14 -10
  143. package/dist/internal/crypto/random-host.native.js.map +1 -1
  144. package/dist/internal/crypto/random-host.node.d.ts +1 -1
  145. package/dist/internal/crypto/random-host.node.d.ts.map +1 -1
  146. package/dist/internal/crypto/random-host.node.js +1 -1
  147. package/dist/internal/crypto/random-host.node.js.map +1 -1
  148. package/dist/internal/crypto/random.d.ts +12 -3
  149. package/dist/internal/crypto/random.d.ts.map +1 -1
  150. package/dist/internal/crypto/random.js +14 -3
  151. package/dist/internal/crypto/random.js.map +1 -1
  152. package/dist/internal/crypto/utils.d.ts.map +1 -1
  153. package/dist/internal/crypto/utils.js +10 -6
  154. package/dist/internal/crypto/utils.js.map +1 -1
  155. package/dist/internal/encoding/proto/primitives.d.ts +2 -0
  156. package/dist/internal/encoding/proto/primitives.d.ts.map +1 -1
  157. package/dist/internal/encoding/proto/primitives.js +2 -1
  158. package/dist/internal/encoding/proto/primitives.js.map +1 -1
  159. package/dist/internal/encoding/proto/signal-message.d.ts +1 -0
  160. package/dist/internal/encoding/proto/signal-message.d.ts.map +1 -1
  161. package/dist/internal/encoding/proto/signal-message.js +2 -1
  162. package/dist/internal/encoding/proto/signal-message.js.map +1 -1
  163. package/dist/internal/groups/authority-certificate.d.ts.map +1 -1
  164. package/dist/internal/groups/authority-certificate.js +2 -1
  165. package/dist/internal/groups/authority-certificate.js.map +1 -1
  166. package/dist/internal/groups/encrypted-state.d.ts.map +1 -1
  167. package/dist/internal/groups/encrypted-state.js +9 -7
  168. package/dist/internal/groups/encrypted-state.js.map +1 -1
  169. package/dist/internal/groups/invite-link.d.ts.map +1 -1
  170. package/dist/internal/groups/invite-link.js +2 -1
  171. package/dist/internal/groups/invite-link.js.map +1 -1
  172. package/dist/internal/groups/manager.d.ts.map +1 -1
  173. package/dist/internal/groups/manager.js +5 -5
  174. package/dist/internal/groups/manager.js.map +1 -1
  175. package/dist/internal/groups/sdk-store.d.ts.map +1 -1
  176. package/dist/internal/groups/sdk-store.js +4 -3
  177. package/dist/internal/groups/sdk-store.js.map +1 -1
  178. package/dist/internal/groups/server-engine.d.ts +6 -1
  179. package/dist/internal/groups/server-engine.d.ts.map +1 -1
  180. package/dist/internal/groups/server-engine.js +11 -15
  181. package/dist/internal/groups/server-engine.js.map +1 -1
  182. package/dist/internal/groups/wire.d.ts.map +1 -1
  183. package/dist/internal/groups/wire.js +2 -1
  184. package/dist/internal/groups/wire.js.map +1 -1
  185. package/dist/internal/platform/blob.d.ts +10 -0
  186. package/dist/internal/platform/blob.d.ts.map +1 -0
  187. package/dist/internal/platform/blob.js +30 -0
  188. package/dist/internal/platform/blob.js.map +1 -0
  189. package/dist/internal/platform/env.d.ts +13 -0
  190. package/dist/internal/platform/env.d.ts.map +1 -0
  191. package/dist/internal/platform/env.js +17 -0
  192. package/dist/internal/platform/env.js.map +1 -0
  193. package/dist/internal/platform/index.d.ts +5 -0
  194. package/dist/internal/platform/index.d.ts.map +1 -0
  195. package/dist/internal/platform/index.js +5 -0
  196. package/dist/internal/platform/index.js.map +1 -0
  197. package/dist/internal/platform/url.d.ts +72 -0
  198. package/dist/internal/platform/url.d.ts.map +1 -0
  199. package/dist/internal/platform/url.js +275 -0
  200. package/dist/internal/platform/url.js.map +1 -0
  201. package/dist/internal/platform/utf8.d.ts +28 -0
  202. package/dist/internal/platform/utf8.d.ts.map +1 -0
  203. package/dist/internal/platform/utf8.js +167 -0
  204. package/dist/internal/platform/utf8.js.map +1 -0
  205. package/dist/internal/protocol/sealed-sender/delivery-token.d.ts +1 -1
  206. package/dist/internal/protocol/sealed-sender/delivery-token.d.ts.map +1 -1
  207. package/dist/internal/protocol/sealed-sender/delivery-token.js +5 -10
  208. package/dist/internal/protocol/sealed-sender/delivery-token.js.map +1 -1
  209. package/dist/internal/protocol/sealed-sender/proto/index.d.ts.map +1 -1
  210. package/dist/internal/protocol/sealed-sender/proto/index.js +2 -4
  211. package/dist/internal/protocol/sealed-sender/proto/index.js.map +1 -1
  212. package/dist/internal/protocol/sender-keys/manager.d.ts.map +1 -1
  213. package/dist/internal/protocol/sender-keys/manager.js +4 -3
  214. package/dist/internal/protocol/sender-keys/manager.js.map +1 -1
  215. package/dist/internal/protocol/spqr/ml-kem-braid/noble-pq/index.d.ts +4 -4
  216. package/dist/internal/protocol/spqr/ml-kem-braid/noble-pq/index.d.ts.map +1 -1
  217. package/dist/internal/protocol/spqr/ml-kem-braid/noble-pq/index.js +8 -10
  218. package/dist/internal/protocol/spqr/ml-kem-braid/noble-pq/index.js.map +1 -1
  219. package/dist/internal/protocol/username/hash.d.ts.map +1 -1
  220. package/dist/internal/protocol/username/hash.js +18 -3
  221. package/dist/internal/protocol/username/hash.js.map +1 -1
  222. package/dist/internal/protocol/username/link.d.ts.map +1 -1
  223. package/dist/internal/protocol/username/link.js +2 -1
  224. package/dist/internal/protocol/username/link.js.map +1 -1
  225. package/dist/internal/protocol/username/proof.d.ts.map +1 -1
  226. package/dist/internal/protocol/username/proof.js +2 -1
  227. package/dist/internal/protocol/username/proof.js.map +1 -1
  228. package/dist/internal/sesame/device-registry.d.ts +22 -6
  229. package/dist/internal/sesame/device-registry.d.ts.map +1 -1
  230. package/dist/internal/sesame/device-registry.js +18 -12
  231. package/dist/internal/sesame/device-registry.js.map +1 -1
  232. package/dist/internal/sesame/index.d.ts +1 -1
  233. package/dist/internal/sesame/index.d.ts.map +1 -1
  234. package/dist/internal/sesame/manager.d.ts.map +1 -1
  235. package/dist/internal/sesame/manager.js +3 -2
  236. package/dist/internal/sesame/manager.js.map +1 -1
  237. package/dist/internal/session/index.d.ts +1 -2
  238. package/dist/internal/session/index.d.ts.map +1 -1
  239. package/dist/internal/session/index.js +1 -1
  240. package/dist/internal/session/index.js.map +1 -1
  241. package/dist/internal/session/validation.d.ts +0 -80
  242. package/dist/internal/session/validation.d.ts.map +1 -1
  243. package/dist/internal/session/validation.js +0 -134
  244. package/dist/internal/session/validation.js.map +1 -1
  245. package/dist/local/store/device-record.d.ts +18 -0
  246. package/dist/local/store/device-record.d.ts.map +1 -0
  247. package/dist/local/store/device-record.js +34 -0
  248. package/dist/local/store/device-record.js.map +1 -0
  249. package/dist/local/store/expo/adapter.d.ts +59 -238
  250. package/dist/local/store/expo/adapter.d.ts.map +1 -1
  251. package/dist/local/store/expo/adapter.js +83 -640
  252. package/dist/local/store/expo/adapter.js.map +1 -1
  253. package/dist/local/store/expo/driver.d.ts +16 -0
  254. package/dist/local/store/expo/driver.d.ts.map +1 -0
  255. package/dist/local/store/expo/driver.js +141 -0
  256. package/dist/local/store/expo/driver.js.map +1 -0
  257. package/dist/local/store/expo/index.d.ts +3 -12
  258. package/dist/local/store/expo/index.d.ts.map +1 -1
  259. package/dist/local/store/expo/index.js +1 -8
  260. package/dist/local/store/expo/index.js.map +1 -1
  261. package/dist/local/store/expo/maintenance.d.ts +3 -2
  262. package/dist/local/store/expo/maintenance.d.ts.map +1 -1
  263. package/dist/local/store/expo/maintenance.js +5 -34
  264. package/dist/local/store/expo/maintenance.js.map +1 -1
  265. package/dist/local/store/index.d.ts +10 -5
  266. package/dist/local/store/index.d.ts.map +1 -1
  267. package/dist/local/store/index.js +10 -5
  268. package/dist/local/store/index.js.map +1 -1
  269. package/dist/local/store/key-value/adapter.d.ts +326 -0
  270. package/dist/local/store/key-value/adapter.d.ts.map +1 -0
  271. package/dist/local/store/key-value/adapter.js +1472 -0
  272. package/dist/local/store/key-value/adapter.js.map +1 -0
  273. package/dist/local/store/{react-native → key-value}/backend-conformance.d.ts +7 -8
  274. package/dist/local/store/key-value/backend-conformance.d.ts.map +1 -0
  275. package/dist/local/store/{react-native → key-value}/backend-conformance.js +4 -5
  276. package/dist/local/store/key-value/backend-conformance.js.map +1 -0
  277. package/dist/local/store/key-value/batch.d.ts +41 -0
  278. package/dist/local/store/key-value/batch.d.ts.map +1 -0
  279. package/dist/local/store/key-value/batch.js +77 -0
  280. package/dist/local/store/key-value/batch.js.map +1 -0
  281. package/dist/local/store/key-value/device-record.d.ts +23 -0
  282. package/dist/local/store/key-value/device-record.d.ts.map +1 -0
  283. package/dist/local/store/key-value/device-record.js +33 -0
  284. package/dist/local/store/key-value/device-record.js.map +1 -0
  285. package/dist/local/store/key-value/index.d.ts +24 -0
  286. package/dist/local/store/key-value/index.d.ts.map +1 -0
  287. package/dist/local/store/key-value/index.js +8 -0
  288. package/dist/local/store/key-value/index.js.map +1 -0
  289. package/dist/local/store/key-value/realm/index.d.ts +83 -0
  290. package/dist/local/store/key-value/realm/index.d.ts.map +1 -0
  291. package/dist/local/store/key-value/realm/index.js +102 -0
  292. package/dist/local/store/key-value/realm/index.js.map +1 -0
  293. package/dist/local/store/{react-native → key-value}/storage.d.ts +6 -6
  294. package/dist/local/store/key-value/storage.d.ts.map +1 -0
  295. package/dist/local/store/key-value/storage.js.map +1 -0
  296. package/dist/local/store/key-value/transactional-backend.d.ts +50 -0
  297. package/dist/local/store/key-value/transactional-backend.d.ts.map +1 -0
  298. package/dist/local/store/key-value/transactional-backend.js +90 -0
  299. package/dist/local/store/key-value/transactional-backend.js.map +1 -0
  300. package/dist/local/store/key-value/value-key.d.ts +34 -0
  301. package/dist/local/store/key-value/value-key.d.ts.map +1 -0
  302. package/dist/local/store/key-value/value-key.js +83 -0
  303. package/dist/local/store/key-value/value-key.js.map +1 -0
  304. package/dist/local/store/memory/adapter.d.ts +8 -0
  305. package/dist/local/store/memory/adapter.d.ts.map +1 -1
  306. package/dist/local/store/memory/adapter.js +60 -75
  307. package/dist/local/store/memory/adapter.js.map +1 -1
  308. package/dist/local/store/node/adapter.d.ts +74 -130
  309. package/dist/local/store/node/adapter.d.ts.map +1 -1
  310. package/dist/local/store/node/adapter.js +83 -727
  311. package/dist/local/store/node/adapter.js.map +1 -1
  312. package/dist/local/store/node/index.d.ts +8 -6
  313. package/dist/local/store/node/index.d.ts.map +1 -1
  314. package/dist/local/store/node/index.js +3 -7
  315. package/dist/local/store/node/index.js.map +1 -1
  316. package/dist/local/store/node/maintenance.d.ts +5 -0
  317. package/dist/local/store/node/maintenance.d.ts.map +1 -0
  318. package/dist/local/store/node/maintenance.js +7 -0
  319. package/dist/local/store/node/maintenance.js.map +1 -0
  320. package/dist/local/store/node/owner-lock.d.ts +26 -0
  321. package/dist/local/store/node/owner-lock.d.ts.map +1 -0
  322. package/dist/local/store/node/owner-lock.js +88 -0
  323. package/dist/local/store/node/owner-lock.js.map +1 -0
  324. package/dist/local/store/react-native/adapter.d.ts +63 -273
  325. package/dist/local/store/react-native/adapter.d.ts.map +1 -1
  326. package/dist/local/store/react-native/adapter.js +80 -1405
  327. package/dist/local/store/react-native/adapter.js.map +1 -1
  328. package/dist/local/store/react-native/index.d.ts +7 -19
  329. package/dist/local/store/react-native/index.d.ts.map +1 -1
  330. package/dist/local/store/react-native/index.js +2 -7
  331. package/dist/local/store/react-native/index.js.map +1 -1
  332. package/dist/local/store/react-native/maintenance.d.ts +5 -0
  333. package/dist/local/store/react-native/maintenance.d.ts.map +1 -0
  334. package/dist/local/store/react-native/maintenance.js +7 -0
  335. package/dist/local/store/react-native/maintenance.js.map +1 -0
  336. package/dist/local/store/sqlite/better-sqlite3-multiple-ciphers-driver.d.ts +38 -0
  337. package/dist/local/store/sqlite/better-sqlite3-multiple-ciphers-driver.d.ts.map +1 -0
  338. package/dist/local/store/sqlite/better-sqlite3-multiple-ciphers-driver.js +196 -0
  339. package/dist/local/store/sqlite/better-sqlite3-multiple-ciphers-driver.js.map +1 -0
  340. package/dist/local/store/sqlite/database.d.ts +20 -0
  341. package/dist/local/store/sqlite/database.d.ts.map +1 -0
  342. package/dist/local/store/sqlite/database.js +41 -0
  343. package/dist/local/store/sqlite/database.js.map +1 -0
  344. package/dist/local/store/sqlite/driver.d.ts +138 -0
  345. package/dist/local/store/sqlite/driver.d.ts.map +1 -0
  346. package/dist/local/store/sqlite/driver.js +10 -0
  347. package/dist/local/store/sqlite/driver.js.map +1 -0
  348. package/dist/local/store/sqlite/encryption.d.ts +61 -0
  349. package/dist/local/store/sqlite/encryption.d.ts.map +1 -0
  350. package/dist/local/store/sqlite/encryption.js +98 -0
  351. package/dist/local/store/sqlite/encryption.js.map +1 -0
  352. package/dist/local/store/sqlite/errors.d.ts +70 -0
  353. package/dist/local/store/sqlite/errors.d.ts.map +1 -0
  354. package/dist/local/store/sqlite/errors.js +101 -0
  355. package/dist/local/store/sqlite/errors.js.map +1 -0
  356. package/dist/local/store/sqlite/executor.d.ts +22 -0
  357. package/dist/local/store/sqlite/executor.d.ts.map +1 -0
  358. package/dist/local/store/sqlite/executor.js +129 -0
  359. package/dist/local/store/sqlite/executor.js.map +1 -0
  360. package/dist/local/store/sqlite/index.d.ts +20 -0
  361. package/dist/local/store/sqlite/index.d.ts.map +1 -0
  362. package/dist/local/store/sqlite/index.js +18 -0
  363. package/dist/local/store/sqlite/index.js.map +1 -0
  364. package/dist/local/store/sqlite/key-storage/account.d.ts +45 -0
  365. package/dist/local/store/sqlite/key-storage/account.d.ts.map +1 -0
  366. package/dist/local/store/sqlite/key-storage/account.js +125 -0
  367. package/dist/local/store/sqlite/key-storage/account.js.map +1 -0
  368. package/dist/local/store/sqlite/key-storage/contact-identities.d.ts +19 -0
  369. package/dist/local/store/sqlite/key-storage/contact-identities.d.ts.map +1 -0
  370. package/dist/local/store/sqlite/key-storage/contact-identities.js +85 -0
  371. package/dist/local/store/sqlite/key-storage/contact-identities.js.map +1 -0
  372. package/dist/local/store/sqlite/key-storage/context.d.ts +19 -0
  373. package/dist/local/store/sqlite/key-storage/context.d.ts.map +1 -0
  374. package/dist/local/store/sqlite/key-storage/context.js +18 -0
  375. package/dist/local/store/sqlite/key-storage/context.js.map +1 -0
  376. package/dist/local/store/sqlite/key-storage/identity-keys.d.ts +18 -0
  377. package/dist/local/store/sqlite/key-storage/identity-keys.d.ts.map +1 -0
  378. package/dist/local/store/sqlite/key-storage/identity-keys.js +88 -0
  379. package/dist/local/store/sqlite/key-storage/identity-keys.js.map +1 -0
  380. package/dist/local/store/sqlite/key-storage/index.d.ts +108 -0
  381. package/dist/local/store/sqlite/key-storage/index.d.ts.map +1 -0
  382. package/dist/local/store/sqlite/key-storage/index.js +241 -0
  383. package/dist/local/store/sqlite/key-storage/index.js.map +1 -0
  384. package/dist/local/store/sqlite/key-storage/message-records.d.ts +41 -0
  385. package/dist/local/store/sqlite/key-storage/message-records.d.ts.map +1 -0
  386. package/dist/local/store/sqlite/key-storage/message-records.js +133 -0
  387. package/dist/local/store/sqlite/key-storage/message-records.js.map +1 -0
  388. package/dist/local/store/sqlite/key-storage/metadata.d.ts +16 -0
  389. package/dist/local/store/sqlite/key-storage/metadata.d.ts.map +1 -0
  390. package/dist/local/store/sqlite/key-storage/metadata.js +53 -0
  391. package/dist/local/store/sqlite/key-storage/metadata.js.map +1 -0
  392. package/dist/local/store/sqlite/key-storage/one-time-prekeys.d.ts +36 -0
  393. package/dist/local/store/sqlite/key-storage/one-time-prekeys.d.ts.map +1 -0
  394. package/dist/local/store/sqlite/key-storage/one-time-prekeys.js +129 -0
  395. package/dist/local/store/sqlite/key-storage/one-time-prekeys.js.map +1 -0
  396. package/dist/local/store/sqlite/key-storage/session-trust.d.ts +10 -0
  397. package/dist/local/store/sqlite/key-storage/session-trust.d.ts.map +1 -0
  398. package/dist/local/store/sqlite/key-storage/session-trust.js +88 -0
  399. package/dist/local/store/sqlite/key-storage/session-trust.js.map +1 -0
  400. package/dist/local/store/sqlite/key-storage/sessions.d.ts +50 -0
  401. package/dist/local/store/sqlite/key-storage/sessions.d.ts.map +1 -0
  402. package/dist/local/store/sqlite/key-storage/sessions.js +209 -0
  403. package/dist/local/store/sqlite/key-storage/sessions.js.map +1 -0
  404. package/dist/local/store/sqlite/key-storage/signed-prekeys.d.ts +69 -0
  405. package/dist/local/store/sqlite/key-storage/signed-prekeys.d.ts.map +1 -0
  406. package/dist/local/store/sqlite/key-storage/signed-prekeys.js +219 -0
  407. package/dist/local/store/sqlite/key-storage/signed-prekeys.js.map +1 -0
  408. package/dist/local/store/sqlite/maintenance.d.ts +7 -0
  409. package/dist/local/store/sqlite/maintenance.d.ts.map +1 -0
  410. package/dist/local/store/sqlite/maintenance.js +32 -0
  411. package/dist/local/store/sqlite/maintenance.js.map +1 -0
  412. package/dist/local/store/sqlite/migrations.d.ts +31 -0
  413. package/dist/local/store/sqlite/migrations.d.ts.map +1 -0
  414. package/dist/local/store/sqlite/migrations.js +232 -0
  415. package/dist/local/store/sqlite/migrations.js.map +1 -0
  416. package/dist/local/store/{expo → sqlite}/models/ec-one-time-prekey.d.ts +17 -22
  417. package/dist/local/store/sqlite/models/ec-one-time-prekey.d.ts.map +1 -0
  418. package/dist/local/store/{expo → sqlite}/models/ec-one-time-prekey.js +61 -99
  419. package/dist/local/store/sqlite/models/ec-one-time-prekey.js.map +1 -0
  420. package/dist/local/store/{expo → sqlite}/models/ec-signed-prekey.d.ts +22 -25
  421. package/dist/local/store/sqlite/models/ec-signed-prekey.d.ts.map +1 -0
  422. package/dist/local/store/{expo → sqlite}/models/ec-signed-prekey.js +82 -128
  423. package/dist/local/store/sqlite/models/ec-signed-prekey.js.map +1 -0
  424. package/dist/local/store/sqlite/models/identity-key-id.d.ts.map +1 -0
  425. package/dist/local/store/sqlite/models/identity-key-id.js.map +1 -0
  426. package/dist/local/store/{expo → sqlite}/models/index.d.ts +5 -5
  427. package/dist/local/store/sqlite/models/index.d.ts.map +1 -0
  428. package/dist/local/store/{expo → sqlite}/models/index.js +12 -5
  429. package/dist/local/store/sqlite/models/index.js.map +1 -0
  430. package/dist/local/store/{expo → sqlite}/models/kyber-one-time-prekey.d.ts +17 -20
  431. package/dist/local/store/sqlite/models/kyber-one-time-prekey.d.ts.map +1 -0
  432. package/dist/local/store/{expo → sqlite}/models/kyber-one-time-prekey.js +65 -105
  433. package/dist/local/store/sqlite/models/kyber-one-time-prekey.js.map +1 -0
  434. package/dist/local/store/{expo → sqlite}/models/kyber-prekey-used.d.ts +3 -3
  435. package/dist/local/store/sqlite/models/kyber-prekey-used.d.ts.map +1 -0
  436. package/dist/local/store/{expo → sqlite}/models/kyber-prekey-used.js +13 -25
  437. package/dist/local/store/sqlite/models/kyber-prekey-used.js.map +1 -0
  438. package/dist/local/store/{expo → sqlite}/models/kyber-prekey.d.ts +16 -19
  439. package/dist/local/store/sqlite/models/kyber-prekey.d.ts.map +1 -0
  440. package/dist/local/store/{expo → sqlite}/models/kyber-prekey.js +67 -111
  441. package/dist/local/store/sqlite/models/kyber-prekey.js.map +1 -0
  442. package/dist/local/store/sqlite/models/local-identity.d.ts +51 -0
  443. package/dist/local/store/sqlite/models/local-identity.d.ts.map +1 -0
  444. package/dist/local/store/sqlite/models/local-identity.js +150 -0
  445. package/dist/local/store/sqlite/models/local-identity.js.map +1 -0
  446. package/dist/local/store/{expo → sqlite}/models/message-record.d.ts +15 -44
  447. package/dist/local/store/sqlite/models/message-record.d.ts.map +1 -0
  448. package/dist/local/store/{expo → sqlite}/models/message-record.js +43 -109
  449. package/dist/local/store/sqlite/models/message-record.js.map +1 -0
  450. package/dist/local/store/sqlite/models/recipient-identity.d.ts +21 -0
  451. package/dist/local/store/sqlite/models/recipient-identity.d.ts.map +1 -0
  452. package/dist/local/store/sqlite/models/recipient-identity.js +59 -0
  453. package/dist/local/store/sqlite/models/recipient-identity.js.map +1 -0
  454. package/dist/local/store/sqlite/models/replaced-prekeys.d.ts +23 -0
  455. package/dist/local/store/sqlite/models/replaced-prekeys.d.ts.map +1 -0
  456. package/dist/local/store/sqlite/models/replaced-prekeys.js +42 -0
  457. package/dist/local/store/sqlite/models/replaced-prekeys.js.map +1 -0
  458. package/dist/local/store/{expo → sqlite}/models/sender-key.d.ts +22 -23
  459. package/dist/local/store/sqlite/models/sender-key.d.ts.map +1 -0
  460. package/dist/local/store/{expo → sqlite}/models/sender-key.js +66 -94
  461. package/dist/local/store/sqlite/models/sender-key.js.map +1 -0
  462. package/dist/local/store/sqlite/models/sesame-user-record.d.ts +32 -0
  463. package/dist/local/store/sqlite/models/sesame-user-record.d.ts.map +1 -0
  464. package/dist/local/store/sqlite/models/sesame-user-record.js +78 -0
  465. package/dist/local/store/sqlite/models/sesame-user-record.js.map +1 -0
  466. package/dist/local/store/{expo → sqlite}/models/session.d.ts +24 -20
  467. package/dist/local/store/sqlite/models/session.d.ts.map +1 -0
  468. package/dist/local/store/{expo → sqlite}/models/session.js +54 -72
  469. package/dist/local/store/sqlite/models/session.js.map +1 -0
  470. package/dist/local/store/sqlite/models/skipped-sender-key.d.ts +24 -0
  471. package/dist/local/store/sqlite/models/skipped-sender-key.d.ts.map +1 -0
  472. package/dist/local/store/sqlite/models/skipped-sender-key.js +62 -0
  473. package/dist/local/store/sqlite/models/skipped-sender-key.js.map +1 -0
  474. package/dist/local/store/sqlite/op-sqlite-driver.d.ts +14 -0
  475. package/dist/local/store/sqlite/op-sqlite-driver.d.ts.map +1 -0
  476. package/dist/local/store/sqlite/op-sqlite-driver.js +180 -0
  477. package/dist/local/store/sqlite/op-sqlite-driver.js.map +1 -0
  478. package/dist/local/store/sqlite/open-store.d.ts +83 -0
  479. package/dist/local/store/sqlite/open-store.d.ts.map +1 -0
  480. package/dist/local/store/sqlite/open-store.js +177 -0
  481. package/dist/local/store/sqlite/open-store.js.map +1 -0
  482. package/dist/local/store/sqlite/schema.d.ts +102 -0
  483. package/dist/local/store/sqlite/schema.d.ts.map +1 -0
  484. package/dist/local/store/sqlite/schema.js +61 -0
  485. package/dist/local/store/sqlite/schema.js.map +1 -0
  486. package/dist/local/store/sqlite/store.d.ts +199 -0
  487. package/dist/local/store/sqlite/store.d.ts.map +1 -0
  488. package/dist/local/store/sqlite/store.js +494 -0
  489. package/dist/local/store/sqlite/store.js.map +1 -0
  490. package/dist/local/store/sqlite/web/driver.d.ts +50 -0
  491. package/dist/local/store/sqlite/web/driver.d.ts.map +1 -0
  492. package/dist/local/store/sqlite/web/driver.js +169 -0
  493. package/dist/local/store/sqlite/web/driver.js.map +1 -0
  494. package/dist/local/store/sqlite/web/protocol.d.ts +80 -0
  495. package/dist/local/store/sqlite/web/protocol.d.ts.map +1 -0
  496. package/dist/local/store/sqlite/web/protocol.js +13 -0
  497. package/dist/local/store/sqlite/web/protocol.js.map +1 -0
  498. package/dist/local/store/sqlite/web/sqlite3mc/sqlite3.mjs +14526 -0
  499. package/dist/local/store/sqlite/web/sqlite3mc/sqlite3.wasm +0 -0
  500. package/dist/local/store/sqlite/web/worker.d.ts +36 -0
  501. package/dist/local/store/sqlite/web/worker.d.ts.map +1 -0
  502. package/dist/local/store/sqlite/web/worker.js +616 -0
  503. package/dist/local/store/sqlite/web/worker.js.map +1 -0
  504. package/dist/local/store/web/adapter.d.ts +5 -14
  505. package/dist/local/store/web/adapter.d.ts.map +1 -1
  506. package/dist/local/store/web/adapter.js +119 -106
  507. package/dist/local/store/web/adapter.js.map +1 -1
  508. package/dist/local/store/web/device-record.d.ts +23 -0
  509. package/dist/local/store/web/device-record.d.ts.map +1 -0
  510. package/dist/local/store/web/device-record.js +31 -0
  511. package/dist/local/store/web/device-record.js.map +1 -0
  512. package/dist/local/store/web-sqlite/adapter.d.ts +98 -0
  513. package/dist/local/store/web-sqlite/adapter.d.ts.map +1 -0
  514. package/dist/local/store/web-sqlite/adapter.js +151 -0
  515. package/dist/local/store/web-sqlite/adapter.js.map +1 -0
  516. package/dist/local/store/web-sqlite/index.d.ts +14 -0
  517. package/dist/local/store/web-sqlite/index.d.ts.map +1 -0
  518. package/dist/local/store/web-sqlite/index.js +3 -0
  519. package/dist/local/store/web-sqlite/index.js.map +1 -0
  520. package/dist/local/store/web-sqlite/maintenance.d.ts +5 -0
  521. package/dist/local/store/web-sqlite/maintenance.d.ts.map +1 -0
  522. package/dist/local/store/web-sqlite/maintenance.js +7 -0
  523. package/dist/local/store/web-sqlite/maintenance.js.map +1 -0
  524. package/dist/local/store/web-sqlite/store-locks.d.ts +33 -0
  525. package/dist/local/store/web-sqlite/store-locks.d.ts.map +1 -0
  526. package/dist/local/store/web-sqlite/store-locks.js +60 -0
  527. package/dist/local/store/web-sqlite/store-locks.js.map +1 -0
  528. package/dist/local/vault/electron-safe-storage.d.ts +45 -0
  529. package/dist/local/vault/electron-safe-storage.d.ts.map +1 -0
  530. package/dist/local/vault/electron-safe-storage.js +212 -0
  531. package/dist/local/vault/electron-safe-storage.js.map +1 -0
  532. package/dist/local/vault/index.d.ts +4 -2
  533. package/dist/local/vault/index.d.ts.map +1 -1
  534. package/dist/local/vault/indexed-db.d.ts +37 -0
  535. package/dist/local/vault/indexed-db.d.ts.map +1 -0
  536. package/dist/local/vault/indexed-db.js +102 -0
  537. package/dist/local/vault/indexed-db.js.map +1 -0
  538. package/dist/local/vault/react-native-keychain.d.ts +12 -0
  539. package/dist/local/vault/react-native-keychain.d.ts.map +1 -0
  540. package/dist/local/vault/react-native-keychain.js +71 -0
  541. package/dist/local/vault/react-native-keychain.js.map +1 -0
  542. package/dist/local/vault/require.d.ts +10 -0
  543. package/dist/local/vault/require.d.ts.map +1 -0
  544. package/dist/local/vault/require.js +16 -0
  545. package/dist/local/vault/require.js.map +1 -0
  546. package/dist/logger.d.ts.map +1 -1
  547. package/dist/logger.js +2 -1
  548. package/dist/logger.js.map +1 -1
  549. package/dist/media/index.d.ts.map +1 -1
  550. package/dist/media/index.js +2 -1
  551. package/dist/media/index.js.map +1 -1
  552. package/dist/profile/contact-state.d.ts.map +1 -1
  553. package/dist/profile/contact-state.js +2 -4
  554. package/dist/profile/contact-state.js.map +1 -1
  555. package/dist/profile/index.d.ts +0 -1
  556. package/dist/profile/index.d.ts.map +1 -1
  557. package/dist/profile/index.js +0 -2
  558. package/dist/profile/index.js.map +1 -1
  559. package/dist/profile/profile-key.d.ts +16 -11
  560. package/dist/profile/profile-key.d.ts.map +1 -1
  561. package/dist/profile/profile-key.js +29 -29
  562. package/dist/profile/profile-key.js.map +1 -1
  563. package/dist/profile/update-service.d.ts +6 -0
  564. package/dist/profile/update-service.d.ts.map +1 -1
  565. package/dist/profile/update-service.js +3 -1
  566. package/dist/profile/update-service.js.map +1 -1
  567. package/dist/remote/object-store/validation.d.ts.map +1 -1
  568. package/dist/remote/object-store/validation.js +2 -1
  569. package/dist/remote/object-store/validation.js.map +1 -1
  570. package/dist/remote/relay/memory/adapter.d.ts +2 -3
  571. package/dist/remote/relay/memory/adapter.d.ts.map +1 -1
  572. package/dist/remote/relay/memory/adapter.js +22 -30
  573. package/dist/remote/relay/memory/adapter.js.map +1 -1
  574. package/dist/remote/relay/memory/failures.d.ts.map +1 -1
  575. package/dist/remote/relay/memory/failures.js +2 -1
  576. package/dist/remote/relay/memory/failures.js.map +1 -1
  577. package/dist/remote/relay/memory/group-server.d.ts +5 -1
  578. package/dist/remote/relay/memory/group-server.d.ts.map +1 -1
  579. package/dist/remote/relay/memory/group-server.js +11 -1
  580. package/dist/remote/relay/memory/group-server.js.map +1 -1
  581. package/dist/safety/url.d.ts.map +1 -1
  582. package/dist/safety/url.js +21 -26
  583. package/dist/safety/url.js.map +1 -1
  584. package/dist/types/api.d.ts +15 -2
  585. package/dist/types/api.d.ts.map +1 -1
  586. package/dist/types/errors.d.ts +97 -1
  587. package/dist/types/errors.d.ts.map +1 -1
  588. package/dist/types/errors.js +105 -1
  589. package/dist/types/errors.js.map +1 -1
  590. package/dist/types/session.d.ts.map +1 -1
  591. package/dist/types/session.js +2 -1
  592. package/dist/types/session.js.map +1 -1
  593. package/dist/utils/retry.d.ts +2 -0
  594. package/dist/utils/retry.d.ts.map +1 -1
  595. package/dist/utils/retry.js +4 -2
  596. package/dist/utils/retry.js.map +1 -1
  597. package/docs/ASSURANCE.md +81 -8
  598. package/docs/CLIENT_COMPOSITION.md +1 -2
  599. package/docs/DEVIATIONS.md +27 -3
  600. package/docs/ERROR_HANDLING.md +6 -0
  601. package/docs/GETTING_STARTED.md +1 -2
  602. package/docs/PACKAGE_SURFACE.md +29 -11
  603. package/docs/RECIPES.md +1 -2
  604. package/examples/browser/index.html +1 -1
  605. package/local/store/README.md +117 -34
  606. package/local/store/expo/README.md +67 -47
  607. package/local/store/key-value/README.md +278 -0
  608. package/local/store/node/README.md +206 -45
  609. package/local/store/react-native/README.md +121 -52
  610. package/local/store/web/README.md +9 -0
  611. package/local/store/web-sqlite/README.md +202 -0
  612. package/local/vault/README.md +115 -2
  613. package/package.json +61 -42
  614. package/profile/README.md +9 -11
  615. package/remote/README.md +1 -2
  616. package/dist/local/store/expo/database-key.d.ts +0 -142
  617. package/dist/local/store/expo/database-key.d.ts.map +0 -1
  618. package/dist/local/store/expo/database-key.js +0 -312
  619. package/dist/local/store/expo/database-key.js.map +0 -1
  620. package/dist/local/store/expo/db.d.ts +0 -95
  621. package/dist/local/store/expo/db.d.ts.map +0 -1
  622. package/dist/local/store/expo/db.js +0 -147
  623. package/dist/local/store/expo/db.js.map +0 -1
  624. package/dist/local/store/expo/key-storage.d.ts +0 -429
  625. package/dist/local/store/expo/key-storage.d.ts.map +0 -1
  626. package/dist/local/store/expo/key-storage.js +0 -1361
  627. package/dist/local/store/expo/key-storage.js.map +0 -1
  628. package/dist/local/store/expo/models/ec-one-time-prekey.d.ts.map +0 -1
  629. package/dist/local/store/expo/models/ec-one-time-prekey.js.map +0 -1
  630. package/dist/local/store/expo/models/ec-signed-prekey.d.ts.map +0 -1
  631. package/dist/local/store/expo/models/ec-signed-prekey.js.map +0 -1
  632. package/dist/local/store/expo/models/identity-key-id.d.ts.map +0 -1
  633. package/dist/local/store/expo/models/identity-key-id.js.map +0 -1
  634. package/dist/local/store/expo/models/index.d.ts.map +0 -1
  635. package/dist/local/store/expo/models/index.js.map +0 -1
  636. package/dist/local/store/expo/models/kyber-one-time-prekey.d.ts.map +0 -1
  637. package/dist/local/store/expo/models/kyber-one-time-prekey.js.map +0 -1
  638. package/dist/local/store/expo/models/kyber-prekey-used.d.ts.map +0 -1
  639. package/dist/local/store/expo/models/kyber-prekey-used.js.map +0 -1
  640. package/dist/local/store/expo/models/kyber-prekey.d.ts.map +0 -1
  641. package/dist/local/store/expo/models/kyber-prekey.js.map +0 -1
  642. package/dist/local/store/expo/models/local-identity.d.ts +0 -52
  643. package/dist/local/store/expo/models/local-identity.d.ts.map +0 -1
  644. package/dist/local/store/expo/models/local-identity.js +0 -166
  645. package/dist/local/store/expo/models/local-identity.js.map +0 -1
  646. package/dist/local/store/expo/models/message-record.d.ts.map +0 -1
  647. package/dist/local/store/expo/models/message-record.js.map +0 -1
  648. package/dist/local/store/expo/models/recipient-identity.d.ts +0 -21
  649. package/dist/local/store/expo/models/recipient-identity.d.ts.map +0 -1
  650. package/dist/local/store/expo/models/recipient-identity.js +0 -66
  651. package/dist/local/store/expo/models/recipient-identity.js.map +0 -1
  652. package/dist/local/store/expo/models/replaced-prekey-utils.d.ts +0 -33
  653. package/dist/local/store/expo/models/replaced-prekey-utils.d.ts.map +0 -1
  654. package/dist/local/store/expo/models/replaced-prekey-utils.js +0 -54
  655. package/dist/local/store/expo/models/replaced-prekey-utils.js.map +0 -1
  656. package/dist/local/store/expo/models/sender-key.d.ts.map +0 -1
  657. package/dist/local/store/expo/models/sender-key.js.map +0 -1
  658. package/dist/local/store/expo/models/session.d.ts.map +0 -1
  659. package/dist/local/store/expo/models/session.js.map +0 -1
  660. package/dist/local/store/expo/schema.d.ts +0 -1917
  661. package/dist/local/store/expo/schema.d.ts.map +0 -1
  662. package/dist/local/store/expo/schema.js +0 -197
  663. package/dist/local/store/expo/schema.js.map +0 -1
  664. package/dist/local/store/node/database-encryption.d.ts +0 -109
  665. package/dist/local/store/node/database-encryption.d.ts.map +0 -1
  666. package/dist/local/store/node/database-encryption.js +0 -202
  667. package/dist/local/store/node/database-encryption.js.map +0 -1
  668. package/dist/local/store/node/database-file-commit.d.ts +0 -8
  669. package/dist/local/store/node/database-file-commit.d.ts.map +0 -1
  670. package/dist/local/store/node/database-file-commit.js +0 -62
  671. package/dist/local/store/node/database-file-commit.js.map +0 -1
  672. package/dist/local/store/node/database-key.d.ts +0 -129
  673. package/dist/local/store/node/database-key.d.ts.map +0 -1
  674. package/dist/local/store/node/database-key.js +0 -293
  675. package/dist/local/store/node/database-key.js.map +0 -1
  676. package/dist/local/store/node/database-lock.d.ts +0 -8
  677. package/dist/local/store/node/database-lock.d.ts.map +0 -1
  678. package/dist/local/store/node/database-lock.js +0 -44
  679. package/dist/local/store/node/database-lock.js.map +0 -1
  680. package/dist/local/store/node/database.d.ts +0 -226
  681. package/dist/local/store/node/database.d.ts.map +0 -1
  682. package/dist/local/store/node/database.js +0 -813
  683. package/dist/local/store/node/database.js.map +0 -1
  684. package/dist/local/store/react-native/backend-conformance.d.ts.map +0 -1
  685. package/dist/local/store/react-native/backend-conformance.js.map +0 -1
  686. package/dist/local/store/react-native/reference-backend.d.ts +0 -43
  687. package/dist/local/store/react-native/reference-backend.d.ts.map +0 -1
  688. package/dist/local/store/react-native/reference-backend.js +0 -178
  689. package/dist/local/store/react-native/reference-backend.js.map +0 -1
  690. package/dist/local/store/react-native/storage.d.ts.map +0 -1
  691. package/dist/local/store/react-native/storage.js.map +0 -1
  692. package/dist/profile/storage.d.ts +0 -61
  693. package/dist/profile/storage.d.ts.map +0 -1
  694. package/dist/profile/storage.js +0 -145
  695. package/dist/profile/storage.js.map +0 -1
  696. /package/dist/local/store/{react-native → key-value}/storage.js +0 -0
  697. /package/dist/local/store/{expo → sqlite}/models/identity-key-id.d.ts +0 -0
  698. /package/dist/local/store/{expo → sqlite}/models/identity-key-id.js +0 -0
@@ -1,813 +0,0 @@
1
- /**
2
- * Encrypted Filesystem Database for Node.js
3
- *
4
- * Provides encrypted JSON file storage with AES-256-GCM encryption.
5
- *
6
- * Layer 1: Single database encryption key in secure file (NodeDatabaseKeyManager)
7
- * Layer 2: All Signal Protocol keys in encrypted JSON files (this file)
8
- *
9
- * Security-critical mutable state (contact trust, one-time prekeys, and
10
- * sessions) is committed through one encrypted, versioned state file. A
11
- * write-fsync/rename/directory-fsync sequence provides a crash-durable commit
12
- * point. A kernel file lock serializes state transactions across processes.
13
- * Other independent collections remain encrypted JSON records.
14
- *
15
- * All sensitive data encrypted before storage.
16
- */
17
- import { access, mkdir, readFile, readdir, rm, unlink } from 'node:fs/promises';
18
- import { join, resolve } from 'node:path';
19
- import { homedir } from 'node:os';
20
- import { EncryptionError, EncryptionErrorCode } from '../../../types/index.js';
21
- import { receivedContentKey, parseReceivedContent } from '../received-content.js';
22
- import { resolveSignalProtocolLogger } from '../../../logger.js';
23
- import { MAX_UNACKNOWLEDGED_SESSION_AGE_MS } from '../../../types/protocol-config.js';
24
- import { encryptRecord, decryptRecord } from './database-encryption.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';
29
- const DEFAULT_DATA_DIR = join(homedir(), '.config', 'open-e2ee', 'signal-protocol');
30
- function emptyDictionary() {
31
- return Object.create(null);
32
- }
33
- function createEmptySecurityState() {
34
- return {
35
- version: 2,
36
- contacts: emptyDictionary(),
37
- ecOneTimePreKeys: emptyDictionary(),
38
- kemOneTimePreKeys: emptyDictionary(),
39
- sessions: emptyDictionary(),
40
- sesameUsers: emptyDictionary(),
41
- senderKeys: emptyDictionary(),
42
- senderKeyRecords: emptyDictionary(),
43
- skippedSenderKeys: emptyDictionary(),
44
- messageRecords: emptyDictionary(),
45
- metadata: emptyDictionary(),
46
- registrationIds: emptyDictionary(),
47
- kyberPreKeyStates: emptyDictionary(),
48
- };
49
- }
50
- /**
51
- * Rebuild a decoded dictionary with a null prototype, `depth` levels down.
52
- *
53
- * `JSON.parse` produces ordinary objects, on which `__proto__` and
54
- * `constructor` are not plain data keys: assigning to them either invokes an
55
- * inherited setter or is silently dropped. Every dictionary here is keyed by
56
- * identifiers the application supplies: user, group, device, session, and
57
- * metadata names. Each level is therefore rebuilt before it is indexed.
58
- */
59
- function toNullPrototype(value, depth) {
60
- const source = (value ?? {});
61
- const result = emptyDictionary();
62
- for (const key of Object.keys(source)) {
63
- result[key] = depth > 1 ? toNullPrototype(source[key], depth - 1) : source[key];
64
- }
65
- return result;
66
- }
67
- /**
68
- * Node.js Encrypted Filesystem Database
69
- *
70
- * Handles all storage operations with automatic encryption/decryption.
71
- */
72
- export class NodeEncryptedDatabase {
73
- dbKey = null;
74
- initPromise = null;
75
- dataDir;
76
- sessionsDir;
77
- securityStatePath;
78
- logger;
79
- securityStateMutation = Promise.resolve();
80
- /**
81
- * Create a new NodeEncryptedDatabase instance
82
- *
83
- * @param dataDir Optional data directory (defaults to ~/.config/signal)
84
- */
85
- constructor(dataDir = DEFAULT_DATA_DIR, providedLogger) {
86
- this.dataDir = dataDir;
87
- this.sessionsDir = join(dataDir, 'sessions');
88
- this.securityStatePath = join(dataDir, 'protocol_security_state_v1.json');
89
- this.logger = resolveSignalProtocolLogger(providedLogger);
90
- }
91
- /**
92
- * Initialize the database
93
- *
94
- * Creates directory structure and retrieves database encryption key.
95
- * This is called automatically on first operation.
96
- */
97
- async initialize() {
98
- // Return existing initialization promise if already initializing
99
- if (this.initPromise) {
100
- return this.initPromise;
101
- }
102
- // Create new initialization promise
103
- this.initPromise = this._initialize().catch((error) => {
104
- this.initPromise = null;
105
- throw error;
106
- });
107
- return this.initPromise;
108
- }
109
- async _initialize() {
110
- try {
111
- const dbKeyManager = getNodeDatabaseKeyManager(this.dataDir);
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);
117
- }
118
- catch (error) {
119
- this.dbKey = null;
120
- throw new EncryptionError('Failed to initialize encrypted database', EncryptionErrorCode.INITIALIZATION_FAILED, { originalError: error });
121
- }
122
- }
123
- /**
124
- * Initialize the database if it is not initialized yet
125
- */
126
- async ensureInitialized() {
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
- });
136
- }
137
- /**
138
- * Direct pre-1.0 format reset. Contacts, one-time prekeys, and sessions now
139
- * share one encrypted document so security-sensitive multi-record commits are
140
- * one atomic filesystem replacement.
141
- */
142
- async initializeAtomicSecurityState() {
143
- try {
144
- await access(this.securityStatePath);
145
- await this.readSecurityStateFile();
146
- return;
147
- }
148
- catch (error) {
149
- if (error.code !== 'ENOENT')
150
- throw error;
151
- }
152
- const legacyCollections = [
153
- 'contact_identities_v1.json',
154
- 'one_time_prekeys_aci.json',
155
- 'one_time_prekeys_pni.json',
156
- 'kem_one_time_prekeys_aci.json',
157
- 'kem_one_time_prekeys_pni.json',
158
- ];
159
- await Promise.all(legacyCollections.map(async (filename) => {
160
- try {
161
- await unlink(join(this.dataDir, filename));
162
- }
163
- catch (error) {
164
- if (error.code !== 'ENOENT')
165
- throw error;
166
- }
167
- }));
168
- await rm(this.sessionsDir, { recursive: true, force: true });
169
- await mkdir(this.sessionsDir, { recursive: true, mode: 0o700 });
170
- await this.writeSecurityStateFile(createEmptySecurityState());
171
- }
172
- assertSecurityState(value) {
173
- if (!value || typeof value !== 'object')
174
- throw new Error('Invalid Node security state');
175
- const state = value;
176
- if ((state.version !== 1 && state.version !== 2) ||
177
- !state.contacts ||
178
- typeof state.contacts !== 'object' ||
179
- !state.ecOneTimePreKeys ||
180
- typeof state.ecOneTimePreKeys !== 'object' ||
181
- !state.kemOneTimePreKeys ||
182
- typeof state.kemOneTimePreKeys !== 'object' ||
183
- !state.sessions ||
184
- typeof state.sessions !== 'object') {
185
- throw new Error('Invalid Node security state structure');
186
- }
187
- }
188
- async readSecurityStateFile() {
189
- const fileData = await readFile(this.securityStatePath, 'utf8');
190
- const encrypted = JSON.parse(fileData);
191
- const decoded = decryptRecord(encrypted, this.dbKey);
192
- this.assertSecurityState(decoded);
193
- // A version 1 document predates the SESAME, group, message-record, and
194
- // metadata namespaces. It is widened here rather than reset. Discarding it
195
- // would drop pinned contact identities, and an unpinned contact is one
196
- // whose next identity change goes undetected.
197
- return {
198
- version: 2,
199
- contacts: toNullPrototype(decoded.contacts, 1),
200
- ecOneTimePreKeys: toNullPrototype(decoded.ecOneTimePreKeys, 1),
201
- kemOneTimePreKeys: toNullPrototype(decoded.kemOneTimePreKeys, 1),
202
- sessions: toNullPrototype(decoded.sessions, 1),
203
- sesameUsers: toNullPrototype(decoded.sesameUsers, 1),
204
- senderKeys: toNullPrototype(decoded.senderKeys, 3),
205
- senderKeyRecords: toNullPrototype(decoded.senderKeyRecords, 3),
206
- skippedSenderKeys: toNullPrototype(decoded.skippedSenderKeys, 4),
207
- messageRecords: toNullPrototype(decoded.messageRecords, 2),
208
- metadata: toNullPrototype(decoded.metadata, 1),
209
- registrationIds: toNullPrototype(decoded.registrationIds, 1),
210
- kyberPreKeyStates: toNullPrototype(decoded.kyberPreKeyStates, 1),
211
- };
212
- }
213
- async writeSecurityStateFile(state) {
214
- const encrypted = encryptRecord(state, this.dbKey);
215
- try {
216
- await commitNodeDatabaseFile(this.securityStatePath, JSON.stringify(encrypted));
217
- }
218
- catch (error) {
219
- throw new EncryptionError('Failed to atomically write Node protocol security state', EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
220
- }
221
- }
222
- async readSecurityState() {
223
- await this.ensureInitialized();
224
- await this.securityStateMutation;
225
- return this.withCurrentKey(() => this.readSecurityStateFile());
226
- }
227
- async mutateSecurityState(mutation, commitWhen = () => true) {
228
- await this.ensureInitialized();
229
- const operation = this.securityStateMutation.then(() => this.withCurrentKey(async () => {
230
- const state = await this.readSecurityStateFile();
231
- const result = mutation(state);
232
- if (commitWhen(result))
233
- await this.writeSecurityStateFile(state);
234
- return result;
235
- }));
236
- this.securityStateMutation = operation.then(() => undefined, () => undefined);
237
- return await operation;
238
- }
239
- /**
240
- * Get file path for a collection
241
- */
242
- getCollectionPath(collection) {
243
- const name = `${collection}.json`;
244
- if (!isNodeDatabaseRecord(name))
245
- throw new Error('Invalid Node database collection.');
246
- return join(this.dataDir, name);
247
- }
248
- // ============================================================================
249
- // Generic Collection Operations
250
- // ============================================================================
251
- /**
252
- * Read a collection from disk
253
- */
254
- async readCollection(collection) {
255
- await this.ensureInitialized();
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);
262
- }
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
- });
270
- }
271
- /**
272
- * Write a collection to disk
273
- */
274
- async writeCollection(collection, data) {
275
- await this.ensureInitialized();
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
- });
286
- }
287
- /**
288
- * Delete a collection from disk
289
- */
290
- async deleteCollection(collection) {
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);
297
- }
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
- });
304
- }
305
- // ============================================================================
306
- // Identity Keys
307
- // ============================================================================
308
- async storeIdentityKey(key, identityType = 'aci') {
309
- const collection = `identity_keys_${identityType}`;
310
- await this.writeCollection(collection, [key]);
311
- }
312
- async getIdentityKey(identityType = 'aci') {
313
- const collection = `identity_keys_${identityType}`;
314
- const keys = await this.readCollection(collection);
315
- return keys.length > 0 ? keys[0] : null;
316
- }
317
- async deleteIdentityKey(identityType) {
318
- if (identityType) {
319
- await this.deleteCollection(`identity_keys_${identityType}`);
320
- }
321
- else {
322
- await this.deleteCollection('identity_keys_aci');
323
- await this.deleteCollection('identity_keys_pni');
324
- }
325
- }
326
- async getContactIdentity(key) {
327
- const state = await this.readSecurityState();
328
- return state.contacts[key] ?? null;
329
- }
330
- async storeContactIdentity(key, record) {
331
- await this.mutateSecurityState((state) => {
332
- state.contacts[key] = record;
333
- });
334
- }
335
- async mutateContactIdentity(key, mutation) {
336
- return await this.mutateSecurityState((state) => {
337
- const replacement = mutation(state.contacts[key] ?? null);
338
- state.contacts[key] = replacement;
339
- return replacement;
340
- });
341
- }
342
- async mutateContactIdentityAndDeleteSessions(key, userId, mutation) {
343
- return await this.mutateSecurityState((state) => {
344
- const replacement = mutation(state.contacts[key] ?? null);
345
- state.contacts[key] = replacement;
346
- for (const [sessionId, stored] of Object.entries(state.sessions)) {
347
- if (stored.userId === userId)
348
- delete state.sessions[sessionId];
349
- }
350
- return replacement;
351
- });
352
- }
353
- // ============================================================================
354
- // Signed PreKeys
355
- // Per X3DH Spec Section 4.4: Keep old signed prekeys for ~30 days
356
- // ============================================================================
357
- async storeEcSignedPreKey(key, identityType = 'aci') {
358
- const collection = `signed_prekeys_${identityType}`;
359
- const keys = await this.readCollection(collection);
360
- // Update existing or add new (keep old prekeys for grace period)
361
- const existingIndex = keys.findIndex((k) => k.keyId === key.keyId);
362
- if (existingIndex >= 0) {
363
- keys[existingIndex] = key;
364
- }
365
- else {
366
- keys.push(key);
367
- }
368
- await this.writeCollection(collection, keys);
369
- await this.cleanupExpiredEcSignedPreKeys(identityType);
370
- }
371
- async getEcSignedPreKey(keyId, identityType = 'aci') {
372
- const collection = `signed_prekeys_${identityType}`;
373
- const keys = await this.readCollection(collection);
374
- if (keys.length === 0)
375
- return null;
376
- if (keyId !== undefined) {
377
- // Look up by specific keyId
378
- return keys.find((k) => k.keyId === keyId) ?? null;
379
- }
380
- // Return the most recent (highest keyId)
381
- return keys.reduce((latest, current) => (current.keyId > latest.keyId ? current : latest));
382
- }
383
- async getAllEcSignedPreKeys(identityType = 'aci') {
384
- const collection = `signed_prekeys_${identityType}`;
385
- return await this.readCollection(collection);
386
- }
387
- async removeEcSignedPreKey(keyId, identityType = 'aci') {
388
- const collection = `signed_prekeys_${identityType}`;
389
- const keys = await this.readCollection(collection);
390
- await this.writeCollection(collection, keys.filter((k) => k.keyId !== keyId));
391
- }
392
- async deleteSignedPreKey(identityType) {
393
- if (identityType) {
394
- await this.deleteCollection(`signed_prekeys_${identityType}`);
395
- }
396
- else {
397
- await this.deleteCollection('signed_prekeys_aci');
398
- await this.deleteCollection('signed_prekeys_pni');
399
- }
400
- }
401
- async cleanupExpiredEcSignedPreKeys(identityType = 'aci') {
402
- const collection = `signed_prekeys_${identityType}`;
403
- const keys = await this.readCollection(collection);
404
- if (keys.length <= 1)
405
- return; // Keep at least one
406
- const cutoff = Date.now() - MAX_UNACKNOWLEDGED_SESSION_AGE_MS;
407
- const newest = keys.reduce((a, b) => (a.keyId > b.keyId ? a : b));
408
- const filtered = keys.filter((k) => k.keyId === newest.keyId || (k.timestamp && k.timestamp > cutoff));
409
- if (filtered.length < keys.length) {
410
- await this.writeCollection(collection, filtered);
411
- }
412
- }
413
- // ============================================================================
414
- // One-Time PreKeys
415
- // ============================================================================
416
- async storeEcOneTimePreKeys(prekeys, identityType = 'aci') {
417
- await this.mutateSecurityState((state) => {
418
- const existing = (state.ecOneTimePreKeys[identityType] ?? []);
419
- state.ecOneTimePreKeys[identityType] = [...existing, ...prekeys];
420
- });
421
- }
422
- async getEcOneTimePreKeys(identityType = 'aci') {
423
- const state = await this.readSecurityState();
424
- return (state.ecOneTimePreKeys[identityType] ?? []);
425
- }
426
- async removeEcOneTimePreKey(predicate, identityType = 'aci') {
427
- await this.mutateSecurityState((state) => {
428
- const keys = (state.ecOneTimePreKeys[identityType] ?? []);
429
- state.ecOneTimePreKeys[identityType] = keys.filter((key) => !predicate(key));
430
- });
431
- }
432
- async deleteOneTimePreKeys(identityType) {
433
- await this.mutateSecurityState((state) => {
434
- if (identityType)
435
- delete state.ecOneTimePreKeys[identityType];
436
- else
437
- state.ecOneTimePreKeys = emptyDictionary();
438
- });
439
- }
440
- async storeKemOneTimePreKeys(prekeys, identityType = 'aci') {
441
- await this.mutateSecurityState((state) => {
442
- const existing = (state.kemOneTimePreKeys[identityType] ?? []);
443
- state.kemOneTimePreKeys[identityType] = [...existing, ...prekeys];
444
- });
445
- }
446
- async getKemOneTimePreKeys(identityType = 'aci') {
447
- const state = await this.readSecurityState();
448
- return (state.kemOneTimePreKeys[identityType] ?? []);
449
- }
450
- async removeKemOneTimePreKey(keyId, identityType = 'aci') {
451
- await this.mutateSecurityState((state) => {
452
- const keys = (state.kemOneTimePreKeys[identityType] ?? []);
453
- state.kemOneTimePreKeys[identityType] = keys.filter((key) => key.keyId !== keyId);
454
- });
455
- }
456
- // ============================================================================
457
- // Kyber PreKeys
458
- // ============================================================================
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
- });
466
- }
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);
474
- }
475
- async deleteKyberPreKey(id, identityType = 'aci') {
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
- });
484
- }
485
- async deleteAllKyberPreKeys(identityType) {
486
- await this.mutateSecurityState((state) => {
487
- if (identityType)
488
- delete state.kyberPreKeyStates[identityType];
489
- else
490
- state.kyberPreKeyStates = emptyDictionary();
491
- });
492
- }
493
- // ============================================================================
494
- // Sessions
495
- // ============================================================================
496
- async storeSession(sessionId, userId, deviceId, serializedRecord) {
497
- await this.mutateSecurityState((state) => {
498
- state.sessions[sessionId] = { userId, deviceId, serializedRecord };
499
- });
500
- }
501
- async getSession(sessionId) {
502
- const state = await this.readSecurityState();
503
- return state.sessions[sessionId]?.serializedRecord ?? null;
504
- }
505
- async getSessionsForUser(userId) {
506
- const state = await this.readSecurityState();
507
- return Object.values(state.sessions)
508
- .filter((session) => session.userId === userId)
509
- .map((session) => session.serializedRecord);
510
- }
511
- async deleteSession(sessionId) {
512
- await this.mutateSecurityState((state) => {
513
- delete state.sessions[sessionId];
514
- });
515
- }
516
- async deleteAllSessions() {
517
- await this.mutateSecurityState((state) => {
518
- state.sessions = emptyDictionary();
519
- });
520
- }
521
- async commitSessionTrust(sessionId, userId, deviceId, serializedRecord, localIdentityType, contactKey, contactMutation, oneTimePreKeyId, kemOneTimePreKeyId, receivedContent, kyberPreKeyUse) {
522
- await this.mutateSecurityState((state) => {
523
- if (oneTimePreKeyId !== undefined &&
524
- !(state.ecOneTimePreKeys[localIdentityType] ?? []).some((key) => key.keyId === oneTimePreKeyId)) {
525
- throw new Error('Atomic session/trust commit cannot consume a missing EC one-time prekey');
526
- }
527
- if (kemOneTimePreKeyId !== undefined &&
528
- !(state.kemOneTimePreKeys[localIdentityType] ?? []).some((key) => key.keyId === kemOneTimePreKeyId)) {
529
- throw new Error('Atomic session/trust commit cannot consume a missing KEM one-time prekey');
530
- }
531
- if (kyberPreKeyUse) {
532
- recordKyberPreKeyUse(state.kyberPreKeyStates[localIdentityType], localIdentityType, kyberPreKeyUse);
533
- }
534
- state.contacts[contactKey] = contactMutation(state.contacts[contactKey] ?? null);
535
- state.sessions[sessionId] = { userId, deviceId, serializedRecord };
536
- if (receivedContent)
537
- state.metadata[receivedContentKey(receivedContent.id)] = JSON.stringify(receivedContent);
538
- if (oneTimePreKeyId !== undefined) {
539
- state.ecOneTimePreKeys[localIdentityType] = (state.ecOneTimePreKeys[localIdentityType] ?? []).filter((key) => key.keyId !== oneTimePreKeyId);
540
- }
541
- if (kemOneTimePreKeyId !== undefined) {
542
- state.kemOneTimePreKeys[localIdentityType] = (state.kemOneTimePreKeys[localIdentityType] ?? []).filter((key) => key.keyId !== kemOneTimePreKeyId);
543
- }
544
- });
545
- }
546
- // ============================================================================
547
- // SESAME Device State
548
- //
549
- // Device records and the sessions they own are one mutation domain. A device
550
- // record naming a session that is not in `sessions`, or the reverse, is a
551
- // divergence no later read can repair. Both therefore move under one commit.
552
- // ============================================================================
553
- async readSesameState() {
554
- const state = await this.readSecurityState();
555
- return { users: state.sesameUsers, sessions: state.sessions };
556
- }
557
- /** Drop every session and every SESAME device record in one commit. */
558
- async clearSesameState() {
559
- await this.mutateSecurityState((state) => {
560
- state.sessions = emptyDictionary();
561
- state.sesameUsers = emptyDictionary();
562
- });
563
- }
564
- async mutateSesameState(mutation) {
565
- return await this.mutateSecurityState((state) => mutation({ users: state.sesameUsers, sessions: state.sessions }));
566
- }
567
- // ============================================================================
568
- // Sender Keys (Group Messaging)
569
- // ============================================================================
570
- async readSenderKeyState() {
571
- const state = await this.readSecurityState();
572
- return {
573
- current: state.senderKeys,
574
- records: state.senderKeyRecords,
575
- skipped: state.skippedSenderKeys,
576
- };
577
- }
578
- /**
579
- * Atomically update the group-messaging namespaces.
580
- *
581
- * A rotation writes the new current state and the retained previous states
582
- * together. A crash between them would leave a sender key whose in-flight
583
- * messages can no longer be resolved.
584
- */
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
- });
596
- }
597
- // ============================================================================
598
- // Message Records (SESAME Retry Support)
599
- // ============================================================================
600
- async readMessageRecords() {
601
- const state = await this.readSecurityState();
602
- return state.messageRecords;
603
- }
604
- async mutateMessageRecords(mutation) {
605
- return await this.mutateSecurityState((state) => mutation(state.messageRecords));
606
- }
607
- // ============================================================================
608
- // Metadata, Registration IDs, and Kyber Usage
609
- // ============================================================================
610
- async getMetadataValue(key) {
611
- const state = await this.readSecurityState();
612
- return state.metadata[key] ?? null;
613
- }
614
- async setMetadataValue(key, value) {
615
- await this.mutateSecurityState((state) => {
616
- state.metadata[key] = value;
617
- });
618
- }
619
- async deleteMetadataValue(key) {
620
- await this.mutateSecurityState((state) => {
621
- delete state.metadata[key];
622
- });
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
- }
650
- async getRegistrationId(identityType) {
651
- const state = await this.readSecurityState();
652
- return state.registrationIds[identityType] ?? 0;
653
- }
654
- async setRegistrationId(identityType, id) {
655
- await this.mutateSecurityState((state) => {
656
- state.registrationIds[identityType] = id;
657
- });
658
- }
659
- async markKyberPreKeyUsed(identityType, usage) {
660
- await this.mutateSecurityState((state) => {
661
- recordKyberPreKeyUseById(state.kyberPreKeyStates[identityType], identityType, usage);
662
- });
663
- }
664
- // ============================================================================
665
- // Key Recovery (PQXDH §4.13 identifier-collision recovery)
666
- // ============================================================================
667
- async getEcSignedPreKeyMaxId(identityType = 'aci') {
668
- const keys = await this.readCollection(`signed_prekeys_${identityType}`);
669
- return keys.reduce((max, key) => (key.keyId > max ? key.keyId : max), 0);
670
- }
671
- async getKyberPreKeyMaxId(identityType = 'aci') {
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);
675
- }
676
- async deleteAllPreKeys(identityType = 'aci') {
677
- const signedPreKeys = await this.readCollection(`signed_prekeys_${identityType}`);
678
- const oneTimeCounts = await this.mutateSecurityState((state) => {
679
- const ec = (state.ecOneTimePreKeys[identityType] ?? []).length;
680
- const kem = (state.kemOneTimePreKeys[identityType] ?? []).length;
681
- const kyber = Object.keys(state.kyberPreKeyStates[identityType]?.instances ?? {}).length;
682
- delete state.ecOneTimePreKeys[identityType];
683
- delete state.kemOneTimePreKeys[identityType];
684
- delete state.kyberPreKeyStates[identityType];
685
- return { ec, kem, kyber };
686
- });
687
- await Promise.all([this.deleteCollection(`signed_prekeys_${identityType}`)]);
688
- return {
689
- ecSignedPreKeys: signedPreKeys.length,
690
- ecOneTimePreKeys: oneTimeCounts.ec,
691
- kyberPreKeys: oneTimeCounts.kyber,
692
- kemOneTimePreKeys: oneTimeCounts.kem,
693
- };
694
- }
695
- async getDetailedStats() {
696
- const state = await this.readSecurityState();
697
- const [signedAci, signedPni] = await Promise.all([
698
- this.readCollection(`signed_prekeys_aci`).then((keys) => keys.length),
699
- this.readCollection(`signed_prekeys_pni`).then((keys) => keys.length),
700
- ]);
701
- const total = (collection) => Object.values(collection).reduce((count, keys) => count + keys.length, 0);
702
- return {
703
- sessions: Object.keys(state.sessions).length,
704
- ecSignedPreKeys: signedAci + signedPni,
705
- ecOneTimePreKeys: total(state.ecOneTimePreKeys),
706
- kyberPreKeys: Object.values(state.kyberPreKeyStates).reduce((count, kyberState) => count + Object.keys(kyberState.instances).length, 0),
707
- kemOneTimePreKeys: total(state.kemOneTimePreKeys),
708
- users: Object.keys(state.sesameUsers).length,
709
- };
710
- }
711
- // ============================================================================
712
- // Statistics
713
- // ============================================================================
714
- async getStats() {
715
- await this.ensureInitialized();
716
- const securityState = await this.readSecurityState();
717
- const [identityAci, identityPni, signedAci, signedPni] = await Promise.all([
718
- this.readCollection('identity_keys_aci')
719
- .then((keys) => keys.length)
720
- .catch(() => 0),
721
- this.readCollection('identity_keys_pni')
722
- .then((keys) => keys.length)
723
- .catch(() => 0),
724
- this.readCollection('signed_prekeys_aci')
725
- .then((keys) => keys.length)
726
- .catch(() => 0),
727
- this.readCollection('signed_prekeys_pni')
728
- .then((keys) => keys.length)
729
- .catch(() => 0),
730
- ]);
731
- return {
732
- identityKeys: identityAci + identityPni,
733
- signedPreKeys: signedAci + signedPni,
734
- oneTimePreKeys: Object.values(securityState.ecOneTimePreKeys).reduce((count, keys) => count + keys.length, 0),
735
- kyberPreKeys: Object.values(securityState.kyberPreKeyStates).reduce((count, kyberState) => count + Object.keys(kyberState.instances).length, 0),
736
- sessions: Object.keys(securityState.sessions).length,
737
- };
738
- }
739
- // ============================================================================
740
- // Maintenance
741
- // ============================================================================
742
- /**
743
- * Close database (cleanup)
744
- */
745
- async close() {
746
- await this.initPromise?.catch(() => undefined);
747
- await this.securityStateMutation;
748
- this.dbKey = null;
749
- this.initPromise = null;
750
- }
751
- /**
752
- * Delete entire database (⚠️ DANGEROUS)
753
- *
754
- * Only for controlled local reset or factory reset.
755
- * This method is safe to call even if database does not exist.
756
- *
757
- * @returns true if database was deleted, false if it did not exist
758
- */
759
- async deleteDatabase() {
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)
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
- }
771
- }
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');
784
- return true;
785
- });
786
- }
787
- }
788
- /**
789
- * Singleton instance
790
- */
791
- const encryptedDatabaseInstances = new Map();
792
- /**
793
- * Get singleton NodeEncryptedDatabase instance
794
- *
795
- * @param dataDir Optional custom data directory
796
- */
797
- export function getNodeEncryptedDatabase(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);
803
- }
804
- return instance;
805
- }
806
- /**
807
- * Reset the singleton for controlled local teardown.
808
- */
809
- export async function resetNodeEncryptedDatabase() {
810
- await Promise.all([...encryptedDatabaseInstances.values()].map((instance) => instance.close()));
811
- encryptedDatabaseInstances.clear();
812
- }
813
- //# sourceMappingURL=database.js.map