@open-e2ee/signal-protocol-sdk 7.2.0 → 8.1.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 (721) hide show
  1. package/ADAPTERS.md +55 -8
  2. package/ARCHITECTURE.md +1 -0
  3. package/CHANGELOG.md +538 -0
  4. package/README.md +10 -6
  5. package/SECURITY.md +2 -2
  6. package/THIRD_PARTY_NOTICES.md +429 -0
  7. package/client/README.md +1 -2
  8. package/device/README.md +50 -19
  9. package/dist/client/client.d.ts +31 -5
  10. package/dist/client/client.d.ts.map +1 -1
  11. package/dist/client/client.js +151 -91
  12. package/dist/client/client.js.map +1 -1
  13. package/dist/client/event-hooks.d.ts.map +1 -1
  14. package/dist/client/event-hooks.js +2 -0
  15. package/dist/client/event-hooks.js.map +1 -1
  16. package/dist/client/files.d.ts.map +1 -1
  17. package/dist/client/files.js +19 -2
  18. package/dist/client/files.js.map +1 -1
  19. package/dist/client/headless.d.ts +1 -1
  20. package/dist/client/headless.js +1 -1
  21. package/dist/client/hosted-anonymous-delivery.d.ts.map +1 -1
  22. package/dist/client/hosted-anonymous-delivery.js +2 -1
  23. package/dist/client/hosted-anonymous-delivery.js.map +1 -1
  24. package/dist/client/hosted-connection.d.ts +1 -1
  25. package/dist/client/hosted-connection.d.ts.map +1 -1
  26. package/dist/client/hosted-connection.js +8 -12
  27. package/dist/client/hosted-connection.js.map +1 -1
  28. package/dist/client/hosted-group-authority.d.ts.map +1 -1
  29. package/dist/client/hosted-group-authority.js +2 -1
  30. package/dist/client/hosted-group-authority.js.map +1 -1
  31. package/dist/client/hosted-groups.d.ts.map +1 -1
  32. package/dist/client/hosted-groups.js +2 -1
  33. package/dist/client/hosted-groups.js.map +1 -1
  34. package/dist/client/hosted-push.d.ts.map +1 -1
  35. package/dist/client/hosted-push.js +2 -1
  36. package/dist/client/hosted-push.js.map +1 -1
  37. package/dist/client/hosted-transport.d.ts +9 -0
  38. package/dist/client/hosted-transport.d.ts.map +1 -1
  39. package/dist/client/hosted-transport.js +59 -24
  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-work.d.ts +30 -0
  52. package/dist/client/relay-work.d.ts.map +1 -0
  53. package/dist/client/relay-work.js +189 -0
  54. package/dist/client/relay-work.js.map +1 -0
  55. package/dist/client/retry.d.ts.map +1 -1
  56. package/dist/client/retry.js +2 -0
  57. package/dist/client/retry.js.map +1 -1
  58. package/dist/client/sessions.d.ts.map +1 -1
  59. package/dist/client/sessions.js +3 -0
  60. package/dist/client/sessions.js.map +1 -1
  61. package/dist/client/signal-service-cipher.d.ts +19 -11
  62. package/dist/client/signal-service-cipher.d.ts.map +1 -1
  63. package/dist/client/signal-service-cipher.js +48 -46
  64. package/dist/client/signal-service-cipher.js.map +1 -1
  65. package/dist/client/state.d.ts +8 -0
  66. package/dist/client/state.d.ts.map +1 -1
  67. package/dist/client/state.js +11 -0
  68. package/dist/client/state.js.map +1 -1
  69. package/dist/device/connection.d.ts +1 -1
  70. package/dist/device/connection.d.ts.map +1 -1
  71. package/dist/device/connection.js +4 -11
  72. package/dist/device/connection.js.map +1 -1
  73. package/dist/device/device-id.d.ts +10 -4
  74. package/dist/device/device-id.d.ts.map +1 -1
  75. package/dist/device/device-id.js +15 -9
  76. package/dist/device/device-id.js.map +1 -1
  77. package/dist/device/device-name-crypto.d.ts.map +1 -1
  78. package/dist/device/device-name-crypto.js +2 -2
  79. package/dist/device/device-name-crypto.js.map +1 -1
  80. package/dist/device/expo/index.d.ts +25 -8
  81. package/dist/device/expo/index.d.ts.map +1 -1
  82. package/dist/device/expo/index.js +58 -8
  83. package/dist/device/expo/index.js.map +1 -1
  84. package/dist/device/index.d.ts +2 -2
  85. package/dist/device/index.d.ts.map +1 -1
  86. package/dist/device/index.js +3 -2
  87. package/dist/device/index.js.map +1 -1
  88. package/dist/device/lifecycle/index.d.ts +4 -2
  89. package/dist/device/lifecycle/index.d.ts.map +1 -1
  90. package/dist/device/lifecycle/index.js.map +1 -1
  91. package/dist/device/lifecycle/manager.d.ts +12 -14
  92. package/dist/device/lifecycle/manager.d.ts.map +1 -1
  93. package/dist/device/lifecycle/manager.js +52 -97
  94. package/dist/device/lifecycle/manager.js.map +1 -1
  95. package/dist/device/lifecycle/types.d.ts +26 -16
  96. package/dist/device/lifecycle/types.d.ts.map +1 -1
  97. package/dist/device/lifecycle/utils.d.ts +8 -4
  98. package/dist/device/lifecycle/utils.d.ts.map +1 -1
  99. package/dist/device/lifecycle/utils.js +12 -16
  100. package/dist/device/lifecycle/utils.js.map +1 -1
  101. package/dist/device/provisioning.d.ts.map +1 -1
  102. package/dist/device/provisioning.js +6 -8
  103. package/dist/device/provisioning.js.map +1 -1
  104. package/dist/device/react-native/index.d.ts +40 -0
  105. package/dist/device/react-native/index.d.ts.map +1 -0
  106. package/dist/device/react-native/index.js +74 -0
  107. package/dist/device/react-native/index.js.map +1 -0
  108. package/dist/device/transfer.d.ts +15 -7
  109. package/dist/device/transfer.d.ts.map +1 -1
  110. package/dist/device/transfer.js +30 -22
  111. package/dist/device/transfer.js.map +1 -1
  112. package/dist/device/types.d.ts +15 -7
  113. package/dist/device/types.d.ts.map +1 -1
  114. package/dist/device/types.js.map +1 -1
  115. package/dist/device/vault-text.d.ts +13 -0
  116. package/dist/device/vault-text.d.ts.map +1 -0
  117. package/dist/device/vault-text.js +17 -0
  118. package/dist/device/vault-text.js.map +1 -0
  119. package/dist/index.d.ts +9 -5
  120. package/dist/index.d.ts.map +1 -1
  121. package/dist/index.js +9 -5
  122. package/dist/index.js.map +1 -1
  123. package/dist/internal/crypto/index.d.ts +3 -3
  124. package/dist/internal/crypto/index.d.ts.map +1 -1
  125. package/dist/internal/crypto/index.js +3 -3
  126. package/dist/internal/crypto/index.js.map +1 -1
  127. package/dist/internal/crypto/random-host.d.ts +1 -1
  128. package/dist/internal/crypto/random-host.d.ts.map +1 -1
  129. package/dist/internal/crypto/random-host.js +3 -2
  130. package/dist/internal/crypto/random-host.js.map +1 -1
  131. package/dist/internal/crypto/random-host.native.d.ts +6 -1
  132. package/dist/internal/crypto/random-host.native.d.ts.map +1 -1
  133. package/dist/internal/crypto/random-host.native.js +14 -10
  134. package/dist/internal/crypto/random-host.native.js.map +1 -1
  135. package/dist/internal/crypto/random-host.node.d.ts +1 -1
  136. package/dist/internal/crypto/random-host.node.d.ts.map +1 -1
  137. package/dist/internal/crypto/random-host.node.js +1 -1
  138. package/dist/internal/crypto/random-host.node.js.map +1 -1
  139. package/dist/internal/crypto/random.d.ts +12 -3
  140. package/dist/internal/crypto/random.d.ts.map +1 -1
  141. package/dist/internal/crypto/random.js +14 -3
  142. package/dist/internal/crypto/random.js.map +1 -1
  143. package/dist/internal/crypto/utils.d.ts.map +1 -1
  144. package/dist/internal/crypto/utils.js +10 -6
  145. package/dist/internal/crypto/utils.js.map +1 -1
  146. package/dist/internal/encoding/proto/primitives.d.ts +2 -0
  147. package/dist/internal/encoding/proto/primitives.d.ts.map +1 -1
  148. package/dist/internal/encoding/proto/primitives.js +2 -1
  149. package/dist/internal/encoding/proto/primitives.js.map +1 -1
  150. package/dist/internal/encoding/proto/signal-message.d.ts +1 -0
  151. package/dist/internal/encoding/proto/signal-message.d.ts.map +1 -1
  152. package/dist/internal/encoding/proto/signal-message.js +2 -1
  153. package/dist/internal/encoding/proto/signal-message.js.map +1 -1
  154. package/dist/internal/groups/authority-certificate.d.ts.map +1 -1
  155. package/dist/internal/groups/authority-certificate.js +2 -1
  156. package/dist/internal/groups/authority-certificate.js.map +1 -1
  157. package/dist/internal/groups/encrypted-state.d.ts.map +1 -1
  158. package/dist/internal/groups/encrypted-state.js +9 -7
  159. package/dist/internal/groups/encrypted-state.js.map +1 -1
  160. package/dist/internal/groups/invite-link.d.ts.map +1 -1
  161. package/dist/internal/groups/invite-link.js +2 -1
  162. package/dist/internal/groups/invite-link.js.map +1 -1
  163. package/dist/internal/groups/manager.d.ts.map +1 -1
  164. package/dist/internal/groups/manager.js +5 -5
  165. package/dist/internal/groups/manager.js.map +1 -1
  166. package/dist/internal/groups/sdk-store.d.ts.map +1 -1
  167. package/dist/internal/groups/sdk-store.js +4 -3
  168. package/dist/internal/groups/sdk-store.js.map +1 -1
  169. package/dist/internal/groups/server-engine.d.ts +6 -1
  170. package/dist/internal/groups/server-engine.d.ts.map +1 -1
  171. package/dist/internal/groups/server-engine.js +11 -15
  172. package/dist/internal/groups/server-engine.js.map +1 -1
  173. package/dist/internal/groups/wire.d.ts.map +1 -1
  174. package/dist/internal/groups/wire.js +2 -1
  175. package/dist/internal/groups/wire.js.map +1 -1
  176. package/dist/internal/platform/blob.d.ts +10 -0
  177. package/dist/internal/platform/blob.d.ts.map +1 -0
  178. package/dist/internal/platform/blob.js +30 -0
  179. package/dist/internal/platform/blob.js.map +1 -0
  180. package/dist/internal/platform/env.d.ts +13 -0
  181. package/dist/internal/platform/env.d.ts.map +1 -0
  182. package/dist/internal/platform/env.js +17 -0
  183. package/dist/internal/platform/env.js.map +1 -0
  184. package/dist/internal/platform/index.d.ts +5 -0
  185. package/dist/internal/platform/index.d.ts.map +1 -0
  186. package/dist/internal/platform/index.js +5 -0
  187. package/dist/internal/platform/index.js.map +1 -0
  188. package/dist/internal/platform/url.d.ts +72 -0
  189. package/dist/internal/platform/url.d.ts.map +1 -0
  190. package/dist/internal/platform/url.js +275 -0
  191. package/dist/internal/platform/url.js.map +1 -0
  192. package/dist/internal/platform/utf8.d.ts +28 -0
  193. package/dist/internal/platform/utf8.d.ts.map +1 -0
  194. package/dist/internal/platform/utf8.js +167 -0
  195. package/dist/internal/platform/utf8.js.map +1 -0
  196. package/dist/internal/protocol/sealed-sender/delivery-token.d.ts +1 -1
  197. package/dist/internal/protocol/sealed-sender/delivery-token.d.ts.map +1 -1
  198. package/dist/internal/protocol/sealed-sender/delivery-token.js +5 -10
  199. package/dist/internal/protocol/sealed-sender/delivery-token.js.map +1 -1
  200. package/dist/internal/protocol/sealed-sender/proto/index.d.ts.map +1 -1
  201. package/dist/internal/protocol/sealed-sender/proto/index.js +2 -4
  202. package/dist/internal/protocol/sealed-sender/proto/index.js.map +1 -1
  203. package/dist/internal/protocol/sender-keys/manager.d.ts.map +1 -1
  204. package/dist/internal/protocol/sender-keys/manager.js +4 -3
  205. package/dist/internal/protocol/sender-keys/manager.js.map +1 -1
  206. package/dist/internal/protocol/spqr/ml-kem-braid/noble-pq/index.d.ts +4 -4
  207. package/dist/internal/protocol/spqr/ml-kem-braid/noble-pq/index.d.ts.map +1 -1
  208. package/dist/internal/protocol/spqr/ml-kem-braid/noble-pq/index.js +8 -10
  209. package/dist/internal/protocol/spqr/ml-kem-braid/noble-pq/index.js.map +1 -1
  210. package/dist/internal/protocol/username/hash.d.ts.map +1 -1
  211. package/dist/internal/protocol/username/hash.js +18 -3
  212. package/dist/internal/protocol/username/hash.js.map +1 -1
  213. package/dist/internal/protocol/username/link.d.ts.map +1 -1
  214. package/dist/internal/protocol/username/link.js +2 -1
  215. package/dist/internal/protocol/username/link.js.map +1 -1
  216. package/dist/internal/protocol/username/proof.d.ts.map +1 -1
  217. package/dist/internal/protocol/username/proof.js +2 -1
  218. package/dist/internal/protocol/username/proof.js.map +1 -1
  219. package/dist/internal/protocol/zk/credentials/attributes.d.ts.map +1 -1
  220. package/dist/internal/protocol/zk/credentials/attributes.js +2 -1
  221. package/dist/internal/protocol/zk/credentials/attributes.js.map +1 -1
  222. package/dist/internal/protocol/zk/credentials/credentials.d.ts.map +1 -1
  223. package/dist/internal/protocol/zk/credentials/credentials.js +8 -6
  224. package/dist/internal/protocol/zk/credentials/credentials.js.map +1 -1
  225. package/dist/internal/protocol/zk/credentials/presentation.d.ts.map +1 -1
  226. package/dist/internal/protocol/zk/credentials/presentation.js +19 -13
  227. package/dist/internal/protocol/zk/credentials/presentation.js.map +1 -1
  228. package/dist/internal/protocol/zk/groups/lizard.d.ts +8 -0
  229. package/dist/internal/protocol/zk/groups/lizard.d.ts.map +1 -1
  230. package/dist/internal/protocol/zk/groups/lizard.js +18 -5
  231. package/dist/internal/protocol/zk/groups/lizard.js.map +1 -1
  232. package/dist/internal/protocol/zk/groups/profile-key-commitment.d.ts.map +1 -1
  233. package/dist/internal/protocol/zk/groups/profile-key-commitment.js +7 -6
  234. package/dist/internal/protocol/zk/groups/profile-key-commitment.js.map +1 -1
  235. package/dist/internal/protocol/zk/groups/profile-key-encryption.d.ts.map +1 -1
  236. package/dist/internal/protocol/zk/groups/profile-key-encryption.js +3 -2
  237. package/dist/internal/protocol/zk/groups/profile-key-encryption.js.map +1 -1
  238. package/dist/internal/protocol/zk/groups/uid-encryption.d.ts.map +1 -1
  239. package/dist/internal/protocol/zk/groups/uid-encryption.js +3 -2
  240. package/dist/internal/protocol/zk/groups/uid-encryption.js.map +1 -1
  241. package/dist/internal/protocol/zk/proofs/point-multiplication.d.ts +53 -0
  242. package/dist/internal/protocol/zk/proofs/point-multiplication.d.ts.map +1 -0
  243. package/dist/internal/protocol/zk/proofs/point-multiplication.js +164 -0
  244. package/dist/internal/protocol/zk/proofs/point-multiplication.js.map +1 -0
  245. package/dist/internal/protocol/zk/proofs/sho.d.ts +1 -0
  246. package/dist/internal/protocol/zk/proofs/sho.d.ts.map +1 -1
  247. package/dist/internal/protocol/zk/proofs/sho.js.map +1 -1
  248. package/dist/internal/protocol/zk/proofs/statement.d.ts.map +1 -1
  249. package/dist/internal/protocol/zk/proofs/statement.js +11 -11
  250. package/dist/internal/protocol/zk/proofs/statement.js.map +1 -1
  251. package/dist/internal/sesame/device-registry.d.ts +16 -3
  252. package/dist/internal/sesame/device-registry.d.ts.map +1 -1
  253. package/dist/internal/sesame/device-registry.js +10 -7
  254. package/dist/internal/sesame/device-registry.js.map +1 -1
  255. package/dist/internal/sesame/index.d.ts +1 -1
  256. package/dist/internal/sesame/index.d.ts.map +1 -1
  257. package/dist/internal/sesame/manager.d.ts.map +1 -1
  258. package/dist/internal/sesame/manager.js +3 -2
  259. package/dist/internal/sesame/manager.js.map +1 -1
  260. package/dist/internal/session/index.d.ts +1 -2
  261. package/dist/internal/session/index.d.ts.map +1 -1
  262. package/dist/internal/session/index.js +1 -1
  263. package/dist/internal/session/index.js.map +1 -1
  264. package/dist/internal/session/validation.d.ts +0 -80
  265. package/dist/internal/session/validation.d.ts.map +1 -1
  266. package/dist/internal/session/validation.js +0 -134
  267. package/dist/internal/session/validation.js.map +1 -1
  268. package/dist/local/store/device-record.d.ts +18 -0
  269. package/dist/local/store/device-record.d.ts.map +1 -0
  270. package/dist/local/store/device-record.js +34 -0
  271. package/dist/local/store/device-record.js.map +1 -0
  272. package/dist/local/store/expo/adapter.d.ts +59 -238
  273. package/dist/local/store/expo/adapter.d.ts.map +1 -1
  274. package/dist/local/store/expo/adapter.js +83 -640
  275. package/dist/local/store/expo/adapter.js.map +1 -1
  276. package/dist/local/store/expo/driver.d.ts +16 -0
  277. package/dist/local/store/expo/driver.d.ts.map +1 -0
  278. package/dist/local/store/expo/driver.js +141 -0
  279. package/dist/local/store/expo/driver.js.map +1 -0
  280. package/dist/local/store/expo/index.d.ts +3 -12
  281. package/dist/local/store/expo/index.d.ts.map +1 -1
  282. package/dist/local/store/expo/index.js +1 -8
  283. package/dist/local/store/expo/index.js.map +1 -1
  284. package/dist/local/store/expo/maintenance.d.ts +3 -2
  285. package/dist/local/store/expo/maintenance.d.ts.map +1 -1
  286. package/dist/local/store/expo/maintenance.js +5 -34
  287. package/dist/local/store/expo/maintenance.js.map +1 -1
  288. package/dist/local/store/index.d.ts +11 -6
  289. package/dist/local/store/index.d.ts.map +1 -1
  290. package/dist/local/store/index.js +11 -6
  291. package/dist/local/store/index.js.map +1 -1
  292. package/dist/local/store/key-value/adapter.d.ts +326 -0
  293. package/dist/local/store/key-value/adapter.d.ts.map +1 -0
  294. package/dist/local/store/key-value/adapter.js +1472 -0
  295. package/dist/local/store/key-value/adapter.js.map +1 -0
  296. package/dist/local/store/{react-native → key-value}/backend-conformance.d.ts +6 -6
  297. package/dist/local/store/key-value/backend-conformance.d.ts.map +1 -0
  298. package/dist/local/store/{react-native → key-value}/backend-conformance.js +3 -3
  299. package/dist/local/store/key-value/backend-conformance.js.map +1 -0
  300. package/dist/local/store/key-value/batch.d.ts +41 -0
  301. package/dist/local/store/key-value/batch.d.ts.map +1 -0
  302. package/dist/local/store/key-value/batch.js +77 -0
  303. package/dist/local/store/key-value/batch.js.map +1 -0
  304. package/dist/local/store/key-value/device-record.d.ts +23 -0
  305. package/dist/local/store/key-value/device-record.d.ts.map +1 -0
  306. package/dist/local/store/key-value/device-record.js +33 -0
  307. package/dist/local/store/key-value/device-record.js.map +1 -0
  308. package/dist/local/store/key-value/index.d.ts +24 -0
  309. package/dist/local/store/key-value/index.d.ts.map +1 -0
  310. package/dist/local/store/key-value/index.js +8 -0
  311. package/dist/local/store/key-value/index.js.map +1 -0
  312. package/dist/local/store/key-value/realm/index.d.ts +83 -0
  313. package/dist/local/store/key-value/realm/index.d.ts.map +1 -0
  314. package/dist/local/store/key-value/realm/index.js +102 -0
  315. package/dist/local/store/key-value/realm/index.js.map +1 -0
  316. package/dist/local/store/{react-native → key-value}/storage.d.ts +6 -6
  317. package/dist/local/store/key-value/storage.d.ts.map +1 -0
  318. package/dist/local/store/key-value/storage.js.map +1 -0
  319. package/dist/local/store/key-value/transactional-backend.d.ts +50 -0
  320. package/dist/local/store/key-value/transactional-backend.d.ts.map +1 -0
  321. package/dist/local/store/key-value/transactional-backend.js +90 -0
  322. package/dist/local/store/key-value/transactional-backend.js.map +1 -0
  323. package/dist/local/store/key-value/value-key.d.ts +34 -0
  324. package/dist/local/store/key-value/value-key.d.ts.map +1 -0
  325. package/dist/local/store/key-value/value-key.js +83 -0
  326. package/dist/local/store/key-value/value-key.js.map +1 -0
  327. package/dist/local/store/memory/adapter.d.ts +8 -0
  328. package/dist/local/store/memory/adapter.d.ts.map +1 -1
  329. package/dist/local/store/memory/adapter.js +60 -75
  330. package/dist/local/store/memory/adapter.js.map +1 -1
  331. package/dist/local/store/node/adapter.d.ts +74 -130
  332. package/dist/local/store/node/adapter.d.ts.map +1 -1
  333. package/dist/local/store/node/adapter.js +83 -727
  334. package/dist/local/store/node/adapter.js.map +1 -1
  335. package/dist/local/store/node/index.d.ts +8 -6
  336. package/dist/local/store/node/index.d.ts.map +1 -1
  337. package/dist/local/store/node/index.js +3 -7
  338. package/dist/local/store/node/index.js.map +1 -1
  339. package/dist/local/store/node/maintenance.d.ts +5 -0
  340. package/dist/local/store/node/maintenance.d.ts.map +1 -0
  341. package/dist/local/store/node/maintenance.js +7 -0
  342. package/dist/local/store/node/maintenance.js.map +1 -0
  343. package/dist/local/store/node/owner-lock.d.ts +26 -0
  344. package/dist/local/store/node/owner-lock.d.ts.map +1 -0
  345. package/dist/local/store/node/owner-lock.js +88 -0
  346. package/dist/local/store/node/owner-lock.js.map +1 -0
  347. package/dist/local/store/react-native/adapter.d.ts +63 -274
  348. package/dist/local/store/react-native/adapter.d.ts.map +1 -1
  349. package/dist/local/store/react-native/adapter.js +80 -1406
  350. package/dist/local/store/react-native/adapter.js.map +1 -1
  351. package/dist/local/store/react-native/index.d.ts +7 -19
  352. package/dist/local/store/react-native/index.d.ts.map +1 -1
  353. package/dist/local/store/react-native/index.js +2 -7
  354. package/dist/local/store/react-native/index.js.map +1 -1
  355. package/dist/local/store/react-native/maintenance.d.ts +5 -0
  356. package/dist/local/store/react-native/maintenance.d.ts.map +1 -0
  357. package/dist/local/store/react-native/maintenance.js +7 -0
  358. package/dist/local/store/react-native/maintenance.js.map +1 -0
  359. package/dist/local/store/sqlite/better-sqlite3-multiple-ciphers-driver.d.ts +38 -0
  360. package/dist/local/store/sqlite/better-sqlite3-multiple-ciphers-driver.d.ts.map +1 -0
  361. package/dist/local/store/sqlite/better-sqlite3-multiple-ciphers-driver.js +196 -0
  362. package/dist/local/store/sqlite/better-sqlite3-multiple-ciphers-driver.js.map +1 -0
  363. package/dist/local/store/sqlite/database.d.ts +20 -0
  364. package/dist/local/store/sqlite/database.d.ts.map +1 -0
  365. package/dist/local/store/sqlite/database.js +41 -0
  366. package/dist/local/store/sqlite/database.js.map +1 -0
  367. package/dist/local/store/sqlite/driver.d.ts +138 -0
  368. package/dist/local/store/sqlite/driver.d.ts.map +1 -0
  369. package/dist/local/store/sqlite/driver.js +10 -0
  370. package/dist/local/store/sqlite/driver.js.map +1 -0
  371. package/dist/local/store/sqlite/encryption.d.ts +61 -0
  372. package/dist/local/store/sqlite/encryption.d.ts.map +1 -0
  373. package/dist/local/store/sqlite/encryption.js +98 -0
  374. package/dist/local/store/sqlite/encryption.js.map +1 -0
  375. package/dist/local/store/sqlite/errors.d.ts +70 -0
  376. package/dist/local/store/sqlite/errors.d.ts.map +1 -0
  377. package/dist/local/store/sqlite/errors.js +101 -0
  378. package/dist/local/store/sqlite/errors.js.map +1 -0
  379. package/dist/local/store/sqlite/executor.d.ts +22 -0
  380. package/dist/local/store/sqlite/executor.d.ts.map +1 -0
  381. package/dist/local/store/sqlite/executor.js +129 -0
  382. package/dist/local/store/sqlite/executor.js.map +1 -0
  383. package/dist/local/store/sqlite/index.d.ts +20 -0
  384. package/dist/local/store/sqlite/index.d.ts.map +1 -0
  385. package/dist/local/store/sqlite/index.js +18 -0
  386. package/dist/local/store/sqlite/index.js.map +1 -0
  387. package/dist/local/store/sqlite/key-storage/account.d.ts +45 -0
  388. package/dist/local/store/sqlite/key-storage/account.d.ts.map +1 -0
  389. package/dist/local/store/sqlite/key-storage/account.js +125 -0
  390. package/dist/local/store/sqlite/key-storage/account.js.map +1 -0
  391. package/dist/local/store/sqlite/key-storage/contact-identities.d.ts +19 -0
  392. package/dist/local/store/sqlite/key-storage/contact-identities.d.ts.map +1 -0
  393. package/dist/local/store/sqlite/key-storage/contact-identities.js +85 -0
  394. package/dist/local/store/sqlite/key-storage/contact-identities.js.map +1 -0
  395. package/dist/local/store/sqlite/key-storage/context.d.ts +19 -0
  396. package/dist/local/store/sqlite/key-storage/context.d.ts.map +1 -0
  397. package/dist/local/store/sqlite/key-storage/context.js +18 -0
  398. package/dist/local/store/sqlite/key-storage/context.js.map +1 -0
  399. package/dist/local/store/sqlite/key-storage/identity-keys.d.ts +18 -0
  400. package/dist/local/store/sqlite/key-storage/identity-keys.d.ts.map +1 -0
  401. package/dist/local/store/sqlite/key-storage/identity-keys.js +88 -0
  402. package/dist/local/store/sqlite/key-storage/identity-keys.js.map +1 -0
  403. package/dist/local/store/sqlite/key-storage/index.d.ts +108 -0
  404. package/dist/local/store/sqlite/key-storage/index.d.ts.map +1 -0
  405. package/dist/local/store/sqlite/key-storage/index.js +241 -0
  406. package/dist/local/store/sqlite/key-storage/index.js.map +1 -0
  407. package/dist/local/store/sqlite/key-storage/message-records.d.ts +41 -0
  408. package/dist/local/store/sqlite/key-storage/message-records.d.ts.map +1 -0
  409. package/dist/local/store/sqlite/key-storage/message-records.js +133 -0
  410. package/dist/local/store/sqlite/key-storage/message-records.js.map +1 -0
  411. package/dist/local/store/sqlite/key-storage/metadata.d.ts +16 -0
  412. package/dist/local/store/sqlite/key-storage/metadata.d.ts.map +1 -0
  413. package/dist/local/store/sqlite/key-storage/metadata.js +53 -0
  414. package/dist/local/store/sqlite/key-storage/metadata.js.map +1 -0
  415. package/dist/local/store/sqlite/key-storage/one-time-prekeys.d.ts +36 -0
  416. package/dist/local/store/sqlite/key-storage/one-time-prekeys.d.ts.map +1 -0
  417. package/dist/local/store/sqlite/key-storage/one-time-prekeys.js +129 -0
  418. package/dist/local/store/sqlite/key-storage/one-time-prekeys.js.map +1 -0
  419. package/dist/local/store/sqlite/key-storage/session-trust.d.ts +10 -0
  420. package/dist/local/store/sqlite/key-storage/session-trust.d.ts.map +1 -0
  421. package/dist/local/store/sqlite/key-storage/session-trust.js +88 -0
  422. package/dist/local/store/sqlite/key-storage/session-trust.js.map +1 -0
  423. package/dist/local/store/sqlite/key-storage/sessions.d.ts +50 -0
  424. package/dist/local/store/sqlite/key-storage/sessions.d.ts.map +1 -0
  425. package/dist/local/store/sqlite/key-storage/sessions.js +209 -0
  426. package/dist/local/store/sqlite/key-storage/sessions.js.map +1 -0
  427. package/dist/local/store/sqlite/key-storage/signed-prekeys.d.ts +69 -0
  428. package/dist/local/store/sqlite/key-storage/signed-prekeys.d.ts.map +1 -0
  429. package/dist/local/store/sqlite/key-storage/signed-prekeys.js +219 -0
  430. package/dist/local/store/sqlite/key-storage/signed-prekeys.js.map +1 -0
  431. package/dist/local/store/sqlite/maintenance.d.ts +7 -0
  432. package/dist/local/store/sqlite/maintenance.d.ts.map +1 -0
  433. package/dist/local/store/sqlite/maintenance.js +32 -0
  434. package/dist/local/store/sqlite/maintenance.js.map +1 -0
  435. package/dist/local/store/sqlite/migrations.d.ts +31 -0
  436. package/dist/local/store/sqlite/migrations.d.ts.map +1 -0
  437. package/dist/local/store/sqlite/migrations.js +232 -0
  438. package/dist/local/store/sqlite/migrations.js.map +1 -0
  439. package/dist/local/store/{expo → sqlite}/models/ec-one-time-prekey.d.ts +17 -22
  440. package/dist/local/store/sqlite/models/ec-one-time-prekey.d.ts.map +1 -0
  441. package/dist/local/store/{expo → sqlite}/models/ec-one-time-prekey.js +61 -99
  442. package/dist/local/store/sqlite/models/ec-one-time-prekey.js.map +1 -0
  443. package/dist/local/store/{expo → sqlite}/models/ec-signed-prekey.d.ts +22 -25
  444. package/dist/local/store/sqlite/models/ec-signed-prekey.d.ts.map +1 -0
  445. package/dist/local/store/{expo → sqlite}/models/ec-signed-prekey.js +82 -128
  446. package/dist/local/store/sqlite/models/ec-signed-prekey.js.map +1 -0
  447. package/dist/local/store/sqlite/models/identity-key-id.d.ts.map +1 -0
  448. package/dist/local/store/sqlite/models/identity-key-id.js.map +1 -0
  449. package/dist/local/store/{expo → sqlite}/models/index.d.ts +5 -5
  450. package/dist/local/store/sqlite/models/index.d.ts.map +1 -0
  451. package/dist/local/store/{expo → sqlite}/models/index.js +12 -5
  452. package/dist/local/store/sqlite/models/index.js.map +1 -0
  453. package/dist/local/store/{expo → sqlite}/models/kyber-one-time-prekey.d.ts +17 -20
  454. package/dist/local/store/sqlite/models/kyber-one-time-prekey.d.ts.map +1 -0
  455. package/dist/local/store/{expo → sqlite}/models/kyber-one-time-prekey.js +65 -105
  456. package/dist/local/store/sqlite/models/kyber-one-time-prekey.js.map +1 -0
  457. package/dist/local/store/{expo → sqlite}/models/kyber-prekey-used.d.ts +3 -3
  458. package/dist/local/store/sqlite/models/kyber-prekey-used.d.ts.map +1 -0
  459. package/dist/local/store/{expo → sqlite}/models/kyber-prekey-used.js +13 -25
  460. package/dist/local/store/sqlite/models/kyber-prekey-used.js.map +1 -0
  461. package/dist/local/store/{expo → sqlite}/models/kyber-prekey.d.ts +16 -19
  462. package/dist/local/store/sqlite/models/kyber-prekey.d.ts.map +1 -0
  463. package/dist/local/store/{expo → sqlite}/models/kyber-prekey.js +67 -111
  464. package/dist/local/store/sqlite/models/kyber-prekey.js.map +1 -0
  465. package/dist/local/store/sqlite/models/local-identity.d.ts +51 -0
  466. package/dist/local/store/sqlite/models/local-identity.d.ts.map +1 -0
  467. package/dist/local/store/sqlite/models/local-identity.js +150 -0
  468. package/dist/local/store/sqlite/models/local-identity.js.map +1 -0
  469. package/dist/local/store/{expo → sqlite}/models/message-record.d.ts +15 -44
  470. package/dist/local/store/sqlite/models/message-record.d.ts.map +1 -0
  471. package/dist/local/store/{expo → sqlite}/models/message-record.js +43 -109
  472. package/dist/local/store/sqlite/models/message-record.js.map +1 -0
  473. package/dist/local/store/sqlite/models/recipient-identity.d.ts +21 -0
  474. package/dist/local/store/sqlite/models/recipient-identity.d.ts.map +1 -0
  475. package/dist/local/store/sqlite/models/recipient-identity.js +59 -0
  476. package/dist/local/store/sqlite/models/recipient-identity.js.map +1 -0
  477. package/dist/local/store/sqlite/models/replaced-prekeys.d.ts +23 -0
  478. package/dist/local/store/sqlite/models/replaced-prekeys.d.ts.map +1 -0
  479. package/dist/local/store/sqlite/models/replaced-prekeys.js +42 -0
  480. package/dist/local/store/sqlite/models/replaced-prekeys.js.map +1 -0
  481. package/dist/local/store/{expo → sqlite}/models/sender-key.d.ts +22 -23
  482. package/dist/local/store/sqlite/models/sender-key.d.ts.map +1 -0
  483. package/dist/local/store/{expo → sqlite}/models/sender-key.js +66 -94
  484. package/dist/local/store/sqlite/models/sender-key.js.map +1 -0
  485. package/dist/local/store/sqlite/models/sesame-user-record.d.ts +32 -0
  486. package/dist/local/store/sqlite/models/sesame-user-record.d.ts.map +1 -0
  487. package/dist/local/store/sqlite/models/sesame-user-record.js +78 -0
  488. package/dist/local/store/sqlite/models/sesame-user-record.js.map +1 -0
  489. package/dist/local/store/{expo → sqlite}/models/session.d.ts +24 -20
  490. package/dist/local/store/sqlite/models/session.d.ts.map +1 -0
  491. package/dist/local/store/{expo → sqlite}/models/session.js +54 -72
  492. package/dist/local/store/sqlite/models/session.js.map +1 -0
  493. package/dist/local/store/sqlite/models/skipped-sender-key.d.ts +24 -0
  494. package/dist/local/store/sqlite/models/skipped-sender-key.d.ts.map +1 -0
  495. package/dist/local/store/sqlite/models/skipped-sender-key.js +62 -0
  496. package/dist/local/store/sqlite/models/skipped-sender-key.js.map +1 -0
  497. package/dist/local/store/sqlite/op-sqlite-driver.d.ts +14 -0
  498. package/dist/local/store/sqlite/op-sqlite-driver.d.ts.map +1 -0
  499. package/dist/local/store/sqlite/op-sqlite-driver.js +180 -0
  500. package/dist/local/store/sqlite/op-sqlite-driver.js.map +1 -0
  501. package/dist/local/store/sqlite/open-store.d.ts +83 -0
  502. package/dist/local/store/sqlite/open-store.d.ts.map +1 -0
  503. package/dist/local/store/sqlite/open-store.js +177 -0
  504. package/dist/local/store/sqlite/open-store.js.map +1 -0
  505. package/dist/local/store/sqlite/schema.d.ts +102 -0
  506. package/dist/local/store/sqlite/schema.d.ts.map +1 -0
  507. package/dist/local/store/sqlite/schema.js +61 -0
  508. package/dist/local/store/sqlite/schema.js.map +1 -0
  509. package/dist/local/store/sqlite/store.d.ts +199 -0
  510. package/dist/local/store/sqlite/store.d.ts.map +1 -0
  511. package/dist/local/store/sqlite/store.js +494 -0
  512. package/dist/local/store/sqlite/store.js.map +1 -0
  513. package/dist/local/store/sqlite/web/driver.d.ts +50 -0
  514. package/dist/local/store/sqlite/web/driver.d.ts.map +1 -0
  515. package/dist/local/store/sqlite/web/driver.js +171 -0
  516. package/dist/local/store/sqlite/web/driver.js.map +1 -0
  517. package/dist/local/store/sqlite/web/protocol.d.ts +80 -0
  518. package/dist/local/store/sqlite/web/protocol.d.ts.map +1 -0
  519. package/dist/local/store/sqlite/web/protocol.js +13 -0
  520. package/dist/local/store/sqlite/web/protocol.js.map +1 -0
  521. package/dist/local/store/sqlite/web/sqlite3mc/sqlite3.mjs +14526 -0
  522. package/dist/local/store/sqlite/web/sqlite3mc/sqlite3.wasm +0 -0
  523. package/dist/local/store/sqlite/web/worker.d.ts +39 -0
  524. package/dist/local/store/sqlite/web/worker.d.ts.map +1 -0
  525. package/dist/local/store/sqlite/web/worker.js +646 -0
  526. package/dist/local/store/sqlite/web/worker.js.map +1 -0
  527. package/dist/local/store/web/adapter.d.ts +5 -14
  528. package/dist/local/store/web/adapter.d.ts.map +1 -1
  529. package/dist/local/store/web/adapter.js +119 -106
  530. package/dist/local/store/web/adapter.js.map +1 -1
  531. package/dist/local/store/web/device-record.d.ts +23 -0
  532. package/dist/local/store/web/device-record.d.ts.map +1 -0
  533. package/dist/local/store/web/device-record.js +31 -0
  534. package/dist/local/store/web/device-record.js.map +1 -0
  535. package/dist/local/store/web-sqlite/adapter.d.ts +101 -0
  536. package/dist/local/store/web-sqlite/adapter.d.ts.map +1 -0
  537. package/dist/local/store/web-sqlite/adapter.js +154 -0
  538. package/dist/local/store/web-sqlite/adapter.js.map +1 -0
  539. package/dist/local/store/web-sqlite/index.d.ts +14 -0
  540. package/dist/local/store/web-sqlite/index.d.ts.map +1 -0
  541. package/dist/local/store/web-sqlite/index.js +3 -0
  542. package/dist/local/store/web-sqlite/index.js.map +1 -0
  543. package/dist/local/store/web-sqlite/maintenance.d.ts +5 -0
  544. package/dist/local/store/web-sqlite/maintenance.d.ts.map +1 -0
  545. package/dist/local/store/web-sqlite/maintenance.js +7 -0
  546. package/dist/local/store/web-sqlite/maintenance.js.map +1 -0
  547. package/dist/local/store/web-sqlite/store-locks.d.ts +33 -0
  548. package/dist/local/store/web-sqlite/store-locks.d.ts.map +1 -0
  549. package/dist/local/store/web-sqlite/store-locks.js +60 -0
  550. package/dist/local/store/web-sqlite/store-locks.js.map +1 -0
  551. package/dist/local/vault/electron-safe-storage.d.ts +45 -0
  552. package/dist/local/vault/electron-safe-storage.d.ts.map +1 -0
  553. package/dist/local/vault/electron-safe-storage.js +212 -0
  554. package/dist/local/vault/electron-safe-storage.js.map +1 -0
  555. package/dist/local/vault/index.d.ts +4 -2
  556. package/dist/local/vault/index.d.ts.map +1 -1
  557. package/dist/local/vault/indexed-db.d.ts +37 -0
  558. package/dist/local/vault/indexed-db.d.ts.map +1 -0
  559. package/dist/local/vault/indexed-db.js +102 -0
  560. package/dist/local/vault/indexed-db.js.map +1 -0
  561. package/dist/local/vault/react-native-keychain.d.ts +12 -0
  562. package/dist/local/vault/react-native-keychain.d.ts.map +1 -0
  563. package/dist/local/vault/react-native-keychain.js +71 -0
  564. package/dist/local/vault/react-native-keychain.js.map +1 -0
  565. package/dist/local/vault/require.d.ts +10 -0
  566. package/dist/local/vault/require.d.ts.map +1 -0
  567. package/dist/local/vault/require.js +16 -0
  568. package/dist/local/vault/require.js.map +1 -0
  569. package/dist/logger.d.ts.map +1 -1
  570. package/dist/logger.js +2 -1
  571. package/dist/logger.js.map +1 -1
  572. package/dist/media/index.d.ts.map +1 -1
  573. package/dist/media/index.js +2 -1
  574. package/dist/media/index.js.map +1 -1
  575. package/dist/profile/contact-state.d.ts.map +1 -1
  576. package/dist/profile/contact-state.js +2 -4
  577. package/dist/profile/contact-state.js.map +1 -1
  578. package/dist/profile/index.d.ts +0 -1
  579. package/dist/profile/index.d.ts.map +1 -1
  580. package/dist/profile/index.js +0 -2
  581. package/dist/profile/index.js.map +1 -1
  582. package/dist/profile/profile-key.d.ts +16 -11
  583. package/dist/profile/profile-key.d.ts.map +1 -1
  584. package/dist/profile/profile-key.js +29 -29
  585. package/dist/profile/profile-key.js.map +1 -1
  586. package/dist/profile/update-service.d.ts +6 -0
  587. package/dist/profile/update-service.d.ts.map +1 -1
  588. package/dist/profile/update-service.js +3 -1
  589. package/dist/profile/update-service.js.map +1 -1
  590. package/dist/remote/object-store/validation.d.ts.map +1 -1
  591. package/dist/remote/object-store/validation.js +2 -1
  592. package/dist/remote/object-store/validation.js.map +1 -1
  593. package/dist/remote/relay/memory/adapter.d.ts +2 -3
  594. package/dist/remote/relay/memory/adapter.d.ts.map +1 -1
  595. package/dist/remote/relay/memory/adapter.js +22 -30
  596. package/dist/remote/relay/memory/adapter.js.map +1 -1
  597. package/dist/remote/relay/memory/failures.d.ts.map +1 -1
  598. package/dist/remote/relay/memory/failures.js +2 -1
  599. package/dist/remote/relay/memory/failures.js.map +1 -1
  600. package/dist/remote/relay/memory/group-server.d.ts +5 -1
  601. package/dist/remote/relay/memory/group-server.d.ts.map +1 -1
  602. package/dist/remote/relay/memory/group-server.js +11 -1
  603. package/dist/remote/relay/memory/group-server.js.map +1 -1
  604. package/dist/safety/url.d.ts.map +1 -1
  605. package/dist/safety/url.js +21 -26
  606. package/dist/safety/url.js.map +1 -1
  607. package/dist/types/api.d.ts +15 -2
  608. package/dist/types/api.d.ts.map +1 -1
  609. package/dist/types/errors.d.ts +97 -1
  610. package/dist/types/errors.d.ts.map +1 -1
  611. package/dist/types/errors.js +105 -1
  612. package/dist/types/errors.js.map +1 -1
  613. package/dist/types/session.d.ts.map +1 -1
  614. package/dist/types/session.js +2 -1
  615. package/dist/types/session.js.map +1 -1
  616. package/dist/utils/retry.d.ts +2 -0
  617. package/dist/utils/retry.d.ts.map +1 -1
  618. package/dist/utils/retry.js +4 -2
  619. package/dist/utils/retry.js.map +1 -1
  620. package/docs/ASSURANCE.md +84 -11
  621. package/docs/CLIENT_COMPOSITION.md +1 -2
  622. package/docs/DEVIATIONS.md +1 -1
  623. package/docs/ERROR_HANDLING.md +7 -1
  624. package/docs/GETTING_STARTED.md +1 -2
  625. package/docs/PACKAGE_SURFACE.md +32 -12
  626. package/docs/RECIPES.md +1 -2
  627. package/examples/browser/index.html +1 -1
  628. package/local/store/README.md +142 -42
  629. package/local/store/expo/README.md +67 -47
  630. package/local/store/key-value/README.md +278 -0
  631. package/local/store/node/README.md +206 -46
  632. package/local/store/react-native/README.md +120 -61
  633. package/local/store/web/README.md +14 -0
  634. package/local/store/web-sqlite/README.md +210 -0
  635. package/local/vault/README.md +115 -2
  636. package/package.json +42 -23
  637. package/profile/README.md +9 -11
  638. package/remote/README.md +1 -2
  639. package/dist/local/store/expo/database-key.d.ts +0 -142
  640. package/dist/local/store/expo/database-key.d.ts.map +0 -1
  641. package/dist/local/store/expo/database-key.js +0 -312
  642. package/dist/local/store/expo/database-key.js.map +0 -1
  643. package/dist/local/store/expo/db.d.ts +0 -95
  644. package/dist/local/store/expo/db.d.ts.map +0 -1
  645. package/dist/local/store/expo/db.js +0 -147
  646. package/dist/local/store/expo/db.js.map +0 -1
  647. package/dist/local/store/expo/key-storage.d.ts +0 -429
  648. package/dist/local/store/expo/key-storage.d.ts.map +0 -1
  649. package/dist/local/store/expo/key-storage.js +0 -1361
  650. package/dist/local/store/expo/key-storage.js.map +0 -1
  651. package/dist/local/store/expo/models/ec-one-time-prekey.d.ts.map +0 -1
  652. package/dist/local/store/expo/models/ec-one-time-prekey.js.map +0 -1
  653. package/dist/local/store/expo/models/ec-signed-prekey.d.ts.map +0 -1
  654. package/dist/local/store/expo/models/ec-signed-prekey.js.map +0 -1
  655. package/dist/local/store/expo/models/identity-key-id.d.ts.map +0 -1
  656. package/dist/local/store/expo/models/identity-key-id.js.map +0 -1
  657. package/dist/local/store/expo/models/index.d.ts.map +0 -1
  658. package/dist/local/store/expo/models/index.js.map +0 -1
  659. package/dist/local/store/expo/models/kyber-one-time-prekey.d.ts.map +0 -1
  660. package/dist/local/store/expo/models/kyber-one-time-prekey.js.map +0 -1
  661. package/dist/local/store/expo/models/kyber-prekey-used.d.ts.map +0 -1
  662. package/dist/local/store/expo/models/kyber-prekey-used.js.map +0 -1
  663. package/dist/local/store/expo/models/kyber-prekey.d.ts.map +0 -1
  664. package/dist/local/store/expo/models/kyber-prekey.js.map +0 -1
  665. package/dist/local/store/expo/models/local-identity.d.ts +0 -52
  666. package/dist/local/store/expo/models/local-identity.d.ts.map +0 -1
  667. package/dist/local/store/expo/models/local-identity.js +0 -166
  668. package/dist/local/store/expo/models/local-identity.js.map +0 -1
  669. package/dist/local/store/expo/models/message-record.d.ts.map +0 -1
  670. package/dist/local/store/expo/models/message-record.js.map +0 -1
  671. package/dist/local/store/expo/models/recipient-identity.d.ts +0 -21
  672. package/dist/local/store/expo/models/recipient-identity.d.ts.map +0 -1
  673. package/dist/local/store/expo/models/recipient-identity.js +0 -66
  674. package/dist/local/store/expo/models/recipient-identity.js.map +0 -1
  675. package/dist/local/store/expo/models/replaced-prekey-utils.d.ts +0 -33
  676. package/dist/local/store/expo/models/replaced-prekey-utils.d.ts.map +0 -1
  677. package/dist/local/store/expo/models/replaced-prekey-utils.js +0 -54
  678. package/dist/local/store/expo/models/replaced-prekey-utils.js.map +0 -1
  679. package/dist/local/store/expo/models/sender-key.d.ts.map +0 -1
  680. package/dist/local/store/expo/models/sender-key.js.map +0 -1
  681. package/dist/local/store/expo/models/session.d.ts.map +0 -1
  682. package/dist/local/store/expo/models/session.js.map +0 -1
  683. package/dist/local/store/expo/schema.d.ts +0 -1917
  684. package/dist/local/store/expo/schema.d.ts.map +0 -1
  685. package/dist/local/store/expo/schema.js +0 -197
  686. package/dist/local/store/expo/schema.js.map +0 -1
  687. package/dist/local/store/node/database-encryption.d.ts +0 -109
  688. package/dist/local/store/node/database-encryption.d.ts.map +0 -1
  689. package/dist/local/store/node/database-encryption.js +0 -202
  690. package/dist/local/store/node/database-encryption.js.map +0 -1
  691. package/dist/local/store/node/database-file-commit.d.ts +0 -8
  692. package/dist/local/store/node/database-file-commit.d.ts.map +0 -1
  693. package/dist/local/store/node/database-file-commit.js +0 -62
  694. package/dist/local/store/node/database-file-commit.js.map +0 -1
  695. package/dist/local/store/node/database-key.d.ts +0 -129
  696. package/dist/local/store/node/database-key.d.ts.map +0 -1
  697. package/dist/local/store/node/database-key.js +0 -293
  698. package/dist/local/store/node/database-key.js.map +0 -1
  699. package/dist/local/store/node/database-lock.d.ts +0 -8
  700. package/dist/local/store/node/database-lock.d.ts.map +0 -1
  701. package/dist/local/store/node/database-lock.js +0 -44
  702. package/dist/local/store/node/database-lock.js.map +0 -1
  703. package/dist/local/store/node/database.d.ts +0 -226
  704. package/dist/local/store/node/database.d.ts.map +0 -1
  705. package/dist/local/store/node/database.js +0 -813
  706. package/dist/local/store/node/database.js.map +0 -1
  707. package/dist/local/store/react-native/backend-conformance.d.ts.map +0 -1
  708. package/dist/local/store/react-native/backend-conformance.js.map +0 -1
  709. package/dist/local/store/react-native/reference-backend.d.ts +0 -43
  710. package/dist/local/store/react-native/reference-backend.d.ts.map +0 -1
  711. package/dist/local/store/react-native/reference-backend.js +0 -178
  712. package/dist/local/store/react-native/reference-backend.js.map +0 -1
  713. package/dist/local/store/react-native/storage.d.ts.map +0 -1
  714. package/dist/local/store/react-native/storage.js.map +0 -1
  715. package/dist/profile/storage.d.ts +0 -61
  716. package/dist/profile/storage.d.ts.map +0 -1
  717. package/dist/profile/storage.js +0 -145
  718. package/dist/profile/storage.js.map +0 -1
  719. /package/dist/local/store/{react-native → key-value}/storage.js +0 -0
  720. /package/dist/local/store/{expo → sqlite}/models/identity-key-id.d.ts +0 -0
  721. /package/dist/local/store/{expo → sqlite}/models/identity-key-id.js +0 -0
@@ -1,1361 +0,0 @@
1
- /**
2
- * Key Storage using Unified SQLCipher Database
3
- *
4
- * Implements a single encrypted database for local protocol state:
5
- * - SQLCipher handles full-database encryption (no per-record encryption)
6
- * - All keys stored as base64 in direct columns
7
- * - Unified database for Signal Protocol data
8
- *
9
- * Architecture:
10
- * - Layer 1 (secret vault): Single database encryption key (DatabaseKeyManager)
11
- * - Layer 2 (SQLCipher): Full database encryption
12
- * - Storage: Direct columns for all key data
13
- *
14
- * See docs/E2EE.md for architecture details.
15
- */
16
- import { acceptContactIdentityRotation as acceptRotation, createUnverifiedContactIdentityRecord, evaluateContactIdentityCandidate, verifyContactIdentityRecord, validateContactIdentityRecord, } from '../../../keys/identity.js';
17
- import { assertCurrentSessionRecord, CURRENT_SESSION_RECORD_VERSION, SessionRecord, } from '../../../types/session.js';
18
- import { EncryptionError, EncryptionErrorCode } from '../../../types/index.js';
19
- import { ProtocolAddress } from '../../../types/address.js';
20
- import { getDatabaseKeyManager } from './database-key.js';
21
- import { 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 {
25
- // Local identity
26
- getPrimaryIdentityKey, deletePrimaryIdentityKey, createPrimaryIdentityKey, getLocalRegistrationId as modelGetLocalRegistrationId, setLocalRegistrationId as modelSetLocalRegistrationId,
27
- // Recipient identity
28
- saveContactIdentity as modelSaveContactIdentity, getContactIdentity as modelGetContactIdentity,
29
- // EC Signed Prekey
30
- getEcSignedPreKeyByKeyId, getCurrentEcSignedPreKey, getAllEcSignedPreKeys, deleteEcSignedPreKeyByKeyId, getMaxEcSignedPreKeyId, storeReplacingEcSignedPreKey, createEcSignedPreKey,
31
- // EC One-Time Prekey
32
- getEcOneTimePreKeyByKeyId, getAllEcOneTimePreKeys, countEcOneTimePreKeys, deleteEcOneTimePreKeyByKeyId, storeBatchEcOneTimePreKeys, createEcOneTimePreKey,
33
- // Kyber Prekey
34
- getCurrentKyberPreKey, getKyberPreKeyByKeyId, deleteKyberPreKeyByKeyId, getMaxKyberPreKeyId, createKyberPreKey,
35
- // Kyber One-Time Prekey
36
- getKyberOneTimePreKeyByKeyId, getAllKyberOneTimePreKeys, countKyberOneTimePreKeys, deleteKyberOneTimePreKeyByKeyId, storeBatchKyberOneTimePreKeys, createKyberOneTimePreKey,
37
- // Session
38
- getSessionById, getSessionsByIds, getSessionIdsByUserId, getAllSessionIds as modelGetAllSessionIds, sessionExists, countSessions, deleteSessionById, deleteAllSessions, createSession, createSessionFromRecord, deserializeSessionRecord, serializeSessionRecord,
39
- // Message records indexed by peer session and client timestamp
40
- getMessageRecord as modelGetMessageRecord, countMessageRecords, deleteMessageRecord as modelDeleteMessageRecord, deleteExpiredMessageRecords as modelDeleteExpiredMessageRecords, deleteAllMessageRecords as modelDeleteAllMessageRecords, deleteMessageRecordsBySessionId as modelDeleteMessageRecordsBySessionId, createMessageRecord,
41
- // Kyber Prekey Used (PQXDH replay detection)
42
- ReusedBaseKeyError,
43
- // Database access for complex queries
44
- getRawDatabase, } from './models/index.js';
45
- import { buildContactIdentityId } from './models/identity-key-id.js';
46
- const SESSION_VERSION = CURRENT_SESSION_RECORD_VERSION;
47
- // ============================================================================
48
- // KeyStorage
49
- // ============================================================================
50
- /**
51
- * KeyStorage implementation using Unified SQLCipher Database
52
- *
53
- * Provides secure storage for all Signal Protocol keys with:
54
- * - SQLCipher full-database encryption
55
- * - Database key custody through the configured local secret vault
56
- * - Direct SQL queries (no per-record encryption overhead)
57
- * - Unified storage with content tables
58
- */
59
- export class KeyStorage {
60
- logger;
61
- constructor(providedLogger) {
62
- this.logger = resolveSignalProtocolLogger(providedLogger);
63
- }
64
- setLogger(providedLogger) {
65
- this.logger = resolveSignalProtocolLogger(providedLogger);
66
- }
67
- // ============================================================================
68
- // Identity Keys
69
- // ============================================================================
70
- /**
71
- * Store identity key pair (only done once per device per identity type)
72
- *
73
- * IdentityKeyPair has nested structure:
74
- * - dhKey: { publicKey, privateKey } (X25519 for DH)
75
- * - signingKey: { publicKey, privateKey } (Ed25519 for signatures)
76
- * - registrationId: number
77
- *
78
- */
79
- async storeIdentityKey(keyPair, identityType = 'aci') {
80
- try {
81
- const identity = createPrimaryIdentityKey({
82
- publicKey: keyPair.dhKey.publicKey,
83
- dhKey: keyPair.dhKey,
84
- signingKey: keyPair.signingKey,
85
- registrationId: keyPair.registrationId,
86
- identityType,
87
- });
88
- await identity.save();
89
- }
90
- catch (error) {
91
- this.logger.error('[KeyStorage] storeIdentityKey failed', {
92
- category: 'E2EE',
93
- error: error instanceof Error ? error : new Error(String(error)),
94
- });
95
- throw new EncryptionError('Failed to store identity key', EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
96
- }
97
- }
98
- /**
99
- * Retrieve identity key pair
100
- *
101
- */
102
- async getIdentityKey(identityType = 'aci') {
103
- try {
104
- const identity = await getPrimaryIdentityKey(identityType);
105
- if (!identity) {
106
- return null;
107
- }
108
- const dhKeyRaw = identity.dhKey;
109
- const signingKeyRaw = identity.signingKey;
110
- const registrationId = identity.registrationId;
111
- if (!dhKeyRaw || !signingKeyRaw || registrationId === undefined) {
112
- return null;
113
- }
114
- // Cast strings to branded types for type safety
115
- const dhKey = {
116
- publicKey: dhKeyRaw.publicKey,
117
- privateKey: dhKeyRaw.privateKey,
118
- };
119
- const signingKey = {
120
- publicKey: signingKeyRaw.publicKey,
121
- privateKey: signingKeyRaw.privateKey,
122
- };
123
- return { dhKey, signingKey, registrationId };
124
- }
125
- catch (error) {
126
- this.logger.error('[KeyStorage] getIdentityKey failed', {
127
- category: 'E2EE',
128
- error: error instanceof Error ? error : new Error(String(error)),
129
- });
130
- throw new EncryptionError('Failed to retrieve identity key', EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
131
- }
132
- }
133
- async deleteIdentityKey(identityType = 'aci') {
134
- try {
135
- await deletePrimaryIdentityKey(identityType);
136
- }
137
- catch (error) {
138
- throw new EncryptionError('Failed to delete identity key', EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
139
- }
140
- }
141
- // ============================================================================
142
- // EC Signed Prekeys
143
- // ============================================================================
144
- /**
145
- * Store EC signed prekey.
146
- *
147
- * IMPORTANT: This DELETES all existing EC signed prekeys before inserting.
148
- * This matches the server-side behavior and prevents the "stale keyId" bug.
149
- *
150
- */
151
- async storeEcSignedPreKey(signedPreKey, identityType = 'aci') {
152
- try {
153
- const publicKey = typeof signedPreKey.publicKey === 'string'
154
- ? signedPreKey.publicKey
155
- : Buffer.from(signedPreKey.publicKey).toString('base64');
156
- const privateKey = typeof signedPreKey.privateKey === 'string'
157
- ? signedPreKey.privateKey
158
- : Buffer.from(signedPreKey.privateKey).toString('base64');
159
- const signature = typeof signedPreKey.signature === 'string'
160
- ? signedPreKey.signature
161
- : Buffer.from(signedPreKey.signature).toString('base64');
162
- const prekey = createEcSignedPreKey({
163
- keyId: signedPreKey.keyId,
164
- publicKey,
165
- privateKey,
166
- signature,
167
- timestamp: signedPreKey.timestamp,
168
- identityType,
169
- });
170
- // storeReplacingEcSignedPreKey handles DELETE all + INSERT in transaction
171
- await storeReplacingEcSignedPreKey(prekey, identityType);
172
- // DIAGNOSTIC: Log EC signed prekey storage for tracing
173
- this.logger.debug('storeEcSignedPreKey: Stored EC signed prekey', {
174
- category: 'E2EE',
175
- data: {
176
- keyId: signedPreKey.keyId,
177
- publicKeyPrefix: publicKey.substring(0, 20),
178
- timestamp: Date.now(),
179
- identityType,
180
- },
181
- });
182
- }
183
- catch (error) {
184
- throw new EncryptionError('Failed to store EC signed prekey', EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
185
- }
186
- }
187
- /**
188
- * Retrieve EC signed prekey by ID.
189
- *
190
- * @param keyId - Optional key ID to retrieve. If not provided, returns the current (most recent) EC signed prekey.
191
- * @param identityType - 'aci' or 'pni' (defaults to 'aci')
192
- * @returns The EC signed prekey, or null if not found
193
- *
194
- */
195
- async getEcSignedPreKey(keyId, identityType = 'aci') {
196
- try {
197
- let prekey;
198
- if (keyId !== undefined) {
199
- prekey = await getEcSignedPreKeyByKeyId(keyId, identityType);
200
- // DIAGNOSTIC: Log lookup result for debugging EC signed prekey issues
201
- if (!prekey) {
202
- const allPreKeys = await getAllEcSignedPreKeys(identityType);
203
- this.logger.warn('getEcSignedPreKey: Key not found by ID', {
204
- category: 'E2EE',
205
- data: {
206
- requestedKeyId: keyId,
207
- availableKeyIds: allPreKeys.map((k) => k.keyId),
208
- totalAvailable: allPreKeys.length,
209
- identityType,
210
- },
211
- });
212
- }
213
- }
214
- else {
215
- prekey = await getCurrentEcSignedPreKey(identityType);
216
- }
217
- if (!prekey) {
218
- return null;
219
- }
220
- return prekey.toEcSignedPreKey();
221
- }
222
- catch (error) {
223
- throw new EncryptionError('Failed to retrieve EC signed prekey', EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
224
- }
225
- }
226
- /**
227
- * Get all stored EC signed prekeys (current + archived).
228
- *
229
- */
230
- async getAllEcSignedPreKeys(identityType = 'aci') {
231
- try {
232
- const prekeys = await getAllEcSignedPreKeys(identityType);
233
- return prekeys.map((prekey) => prekey.toEcSignedPreKey());
234
- }
235
- catch (error) {
236
- throw new EncryptionError('Failed to retrieve all EC signed prekeys', EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
237
- }
238
- }
239
- /**
240
- * Mark an EC signed prekey as stale by ID.
241
- *
242
- * Called during cleanup to retire expired archived prekeys.
243
- * The prekey is retained for in-flight message decryption and
244
- * can be permanently purged later via purgeStaleEcSignedPreKeys().
245
- *
246
- */
247
- async removeEcSignedPreKey(keyId, identityType = 'aci') {
248
- try {
249
- await deleteEcSignedPreKeyByKeyId(keyId, identityType);
250
- }
251
- catch (error) {
252
- throw new EncryptionError('Failed to mark EC signed prekey as stale', EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
253
- }
254
- }
255
- /**
256
- * Clean up expired EC signed prekeys outside the grace period.
257
- *
258
- * Marks expired prekeys as stale. Keeps the most recent active
259
- * prekey and any prekeys within the grace period.
260
- * Stale prekeys are retained for in-flight message decryption.
261
- *
262
- */
263
- async cleanupExpiredEcSignedPreKeys(identityType = 'aci') {
264
- try {
265
- const db = getRawDatabase();
266
- const cutoff = Date.now() - MAX_UNACKNOWLEDGED_SESSION_AGE_MS;
267
- const now = Date.now();
268
- // Get active prekeys that will be marked replaced for logging
269
- const toMarkReplaced = await db.getAllAsync(`SELECT prekey_id, created_at FROM ec_signed_prekeys
270
- WHERE identity_type = ?
271
- AND created_at < ?
272
- AND replaced_at IS NULL
273
- AND prekey_id NOT IN (
274
- SELECT prekey_id FROM ec_signed_prekeys WHERE identity_type = ? AND replaced_at IS NULL ORDER BY created_at DESC LIMIT 1
275
- )`, [identityType, cutoff, identityType]);
276
- if (toMarkReplaced.length > 0) {
277
- this.logger.debug('cleanupExpiredEcSignedPreKeys: Marking expired prekeys as replaced', {
278
- category: 'E2EE',
279
- data: {
280
- markingReplacedKeyIds: toMarkReplaced.map((k) => k.prekey_id),
281
- cutoffTimestamp: cutoff,
282
- identityType,
283
- },
284
- });
285
- }
286
- // Mark expired prekeys as replaced, but keep the most recent active one
287
- await db.runAsync(`UPDATE ec_signed_prekeys SET replaced_at = ?
288
- WHERE identity_type = ?
289
- AND created_at < ?
290
- AND replaced_at IS NULL
291
- AND prekey_id NOT IN (
292
- SELECT prekey_id FROM ec_signed_prekeys WHERE identity_type = ? AND replaced_at IS NULL ORDER BY created_at DESC LIMIT 1
293
- )`, [now, identityType, cutoff, identityType]);
294
- }
295
- catch (error) {
296
- // Log but do not throw - cleanup is best-effort
297
- this.logger.warn('Failed to cleanup expired EC signed prekeys', {
298
- category: 'E2EE',
299
- data: { error, identityType },
300
- });
301
- }
302
- }
303
- // ============================================================================
304
- // EC One-Time Prekeys
305
- // ============================================================================
306
- /**
307
- * Store EC one-time prekeys (batch storage)
308
- *
309
- */
310
- async storeEcOneTimePreKeys(prekeys, identityType = 'aci') {
311
- try {
312
- const modelPreKeys = prekeys.map((pk) => createEcOneTimePreKey({
313
- keyId: pk.keyId,
314
- publicKey: pk.publicKey,
315
- privateKey: pk.privateKey,
316
- identityType,
317
- }));
318
- await storeBatchEcOneTimePreKeys(modelPreKeys);
319
- }
320
- catch (error) {
321
- throw new EncryptionError('Failed to store EC one-time prekeys', EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
322
- }
323
- }
324
- /**
325
- * Retrieve all EC one-time prekeys
326
- *
327
- */
328
- async getEcOneTimePreKeys(identityType = 'aci') {
329
- try {
330
- const prekeys = await getAllEcOneTimePreKeys(identityType);
331
- return prekeys.map((pk) => pk.toEcOneTimePreKey());
332
- }
333
- catch (error) {
334
- throw new EncryptionError('Failed to retrieve EC one-time prekeys', EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
335
- }
336
- }
337
- /**
338
- * Remove consumed EC one-time prekey
339
- *
340
- */
341
- async removeEcOneTimePreKey(preKeyId, identityType = 'aci') {
342
- try {
343
- await deleteEcOneTimePreKeyByKeyId(preKeyId, identityType);
344
- }
345
- catch (error) {
346
- throw new EncryptionError('Failed to remove EC one-time prekey', EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
347
- }
348
- }
349
- /**
350
- * Get EC one-time prekey count
351
- *
352
- */
353
- async getEcOneTimePreKeyCount(identityType = 'aci') {
354
- try {
355
- return await countEcOneTimePreKeys(identityType);
356
- }
357
- catch (error) {
358
- throw new EncryptionError('Failed to get EC one-time prekey count', EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
359
- }
360
- }
361
- // ============================================================================
362
- // Kyber Prekeys (Post-Quantum)
363
- // ============================================================================
364
- /**
365
- * Store Kyber prekey (post-quantum resistance)
366
- *
367
- */
368
- async storeKyberPreKey(kyberPreKey, identityType = 'aci') {
369
- try {
370
- const prekey = createKyberPreKey({
371
- keyId: kyberPreKey.keyId,
372
- publicKey: kyberPreKey.publicKey,
373
- privateKey: kyberPreKey.privateKey,
374
- signature: kyberPreKey.signature,
375
- timestamp: kyberPreKey.timestamp,
376
- identityType,
377
- });
378
- await prekey.save();
379
- }
380
- catch (error) {
381
- throw new EncryptionError(`Failed to store Kyber prekey ${kyberPreKey.keyId}`, EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
382
- }
383
- }
384
- /**
385
- * Retrieve Kyber prekey
386
- *
387
- */
388
- async getKyberPreKey(identityType = 'aci') {
389
- try {
390
- const prekey = await getCurrentKyberPreKey(identityType);
391
- if (!prekey) {
392
- return null;
393
- }
394
- return prekey.toKyberPreKey();
395
- }
396
- catch (error) {
397
- throw new EncryptionError('Failed to retrieve Kyber prekey', EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
398
- }
399
- }
400
- async getKyberPreKeyById(keyId, identityType = 'aci') {
401
- try {
402
- const prekey = await getKyberPreKeyByKeyId(keyId, identityType);
403
- return prekey
404
- ? { preKey: prekey.toKyberPreKey(), instanceId: prekey.instanceId }
405
- : null;
406
- }
407
- catch (error) {
408
- throw new EncryptionError(`Failed to retrieve Kyber prekey ${keyId}`, EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
409
- }
410
- }
411
- /**
412
- * Mark Kyber prekey as used: PQXDH replay detection
413
- *
414
- * Inserts a (kyberPreKeyId, signedPreKeyIdentity, signedPreKeyId, baseKey) tuple.
415
- * Duplicate tuple = replay attack -> throws ReusedBaseKeyError.
416
- *
417
- */
418
- async markKyberPreKeyUsed(kyberPreKeyId, signedPreKeyId, baseKeyBytes, identityType = 'aci') {
419
- try {
420
- const db = getRawDatabase();
421
- const baseKey = Buffer.from(baseKeyBytes).toString('base64');
422
- const parent = await db.getFirstAsync(`SELECT id FROM kyber_prekeys WHERE identity_type = ? AND prekey_id = ?`, [identityType, kyberPreKeyId]);
423
- if (!parent)
424
- throw new Error(`Kyber prekey ${kyberPreKeyId} is not retained`);
425
- await db.runAsync(`INSERT INTO kyber_prekey_used
426
- (kyber_prekey_row_id, signed_prekey_identity, signed_prekey_id, base_key)
427
- VALUES (?, ?, ?, ?)`, [parent.id, identityType, signedPreKeyId, baseKey]);
428
- }
429
- catch (error) {
430
- const errorMessage = error instanceof Error ? error.message : String(error);
431
- // Duplicate tuple = PQXDH replay attack
432
- if (errorMessage.includes('UNIQUE constraint failed') ||
433
- errorMessage.includes('PRIMARY KEY')) {
434
- throw new ReusedBaseKeyError(kyberPreKeyId, signedPreKeyId);
435
- }
436
- throw new EncryptionError(`Failed to mark Kyber prekey ${kyberPreKeyId} as used`, EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
437
- }
438
- }
439
- /**
440
- * Delete Kyber prekey
441
- *
442
- */
443
- async deleteKyberPreKey(id, identityType = 'aci') {
444
- try {
445
- await deleteKyberPreKeyByKeyId(id, identityType);
446
- }
447
- catch (error) {
448
- throw new EncryptionError(`Failed to delete Kyber prekey ${id}`, EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
449
- }
450
- }
451
- // ============================================================================
452
- // Kyber One-Time Prekeys (Post-Quantum, Consumed on Use)
453
- // ============================================================================
454
- /**
455
- * Store one-time KEM prekeys (batch storage)
456
- *
457
- * Per PQXDH spec Section 3.2, these are signed one-time pqkem prekeys
458
- * that provide per-session post-quantum forward secrecy.
459
- *
460
- */
461
- async storeKemOneTimePreKeys(prekeys, identityType = 'aci') {
462
- try {
463
- const modelPreKeys = prekeys.map((pk) => createKyberOneTimePreKey({
464
- keyId: pk.keyId,
465
- publicKey: pk.publicKey,
466
- privateKey: pk.privateKey,
467
- signature: pk.signature,
468
- timestamp: pk.timestamp,
469
- identityType,
470
- }));
471
- await storeBatchKyberOneTimePreKeys(modelPreKeys);
472
- }
473
- catch (error) {
474
- throw new EncryptionError('Failed to store one-time Kyber prekeys', EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
475
- }
476
- }
477
- /**
478
- * Retrieve all one-time KEM prekeys
479
- *
480
- */
481
- async getKemOneTimePreKeys(identityType = 'aci') {
482
- try {
483
- const prekeys = await getAllKyberOneTimePreKeys(identityType);
484
- return prekeys.map((pk) => pk.toKemOneTimePreKey());
485
- }
486
- catch (error) {
487
- throw new EncryptionError('Failed to retrieve one-time Kyber prekeys', EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
488
- }
489
- }
490
- /**
491
- * Retrieve a specific one-time KEM prekey by ID
492
- * Used during session establishment for decapsulation
493
- *
494
- */
495
- async getKemOneTimePreKey(keyId, identityType = 'aci') {
496
- try {
497
- const prekey = await getKyberOneTimePreKeyByKeyId(keyId, identityType);
498
- if (!prekey) {
499
- return null;
500
- }
501
- return prekey.toKemOneTimePreKey();
502
- }
503
- catch (error) {
504
- throw new EncryptionError(`Failed to retrieve one-time Kyber prekey ${keyId}`, EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
505
- }
506
- }
507
- /**
508
- * Remove one-time KEM prekey after consumption
509
- *
510
- * CRITICAL: Must be called immediately after successful decapsulation
511
- * to provide per-session post-quantum forward secrecy.
512
- *
513
- */
514
- async removeKemOneTimePreKey(keyId, identityType = 'aci') {
515
- try {
516
- await deleteKyberOneTimePreKeyByKeyId(keyId, identityType);
517
- this.logger.debug('Removed one-time KEM prekey after consumption', {
518
- category: 'KeyStorage',
519
- data: { keyId },
520
- });
521
- }
522
- catch (error) {
523
- throw new EncryptionError(`Failed to remove one-time Kyber prekey ${keyId}`, EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
524
- }
525
- }
526
- /**
527
- * Get count of available one-time KEM prekeys
528
- *
529
- */
530
- async getKemOneTimePreKeyCount(identityType = 'aci') {
531
- try {
532
- return await countKyberOneTimePreKeys(identityType);
533
- }
534
- catch (error) {
535
- throw new EncryptionError('Failed to get one-time Kyber prekey count', EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
536
- }
537
- }
538
- // ============================================================================
539
- // Session Storage
540
- // ============================================================================
541
- /**
542
- * Store session state
543
- *
544
- * Accepts either a SessionState (wraps in SessionRecord) or a SessionRecord (stores directly).
545
- *
546
- */
547
- async storeSession(sessionId, session) {
548
- try {
549
- // If already a SessionRecord (has currentSession property), use createSessionFromRecord
550
- // Otherwise wrap the SessionState using createSession
551
- const sessionModel = 'currentSession' in session
552
- ? createSessionFromRecord(sessionId, session)
553
- : createSession(sessionId, session);
554
- await sessionModel.save();
555
- }
556
- catch (error) {
557
- throw new EncryptionError(`Failed to store session ${sessionId}`, EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
558
- }
559
- }
560
- /**
561
- * Retrieve session state
562
- *
563
- */
564
- async getSession(sessionId) {
565
- try {
566
- const session = await getSessionById(sessionId);
567
- if (!session) {
568
- return null;
569
- }
570
- if (session.version !== SESSION_VERSION) {
571
- this.logger.warn('Session version mismatch', {
572
- category: 'KeyStorage',
573
- data: { sessionId, expected: SESSION_VERSION, actual: session.version },
574
- });
575
- return null;
576
- }
577
- return session.currentSession;
578
- }
579
- catch (error) {
580
- throw new EncryptionError(`Failed to retrieve session ${sessionId}`, EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
581
- }
582
- }
583
- /**
584
- * Delete session after best-effort overwrite of decoded key bytes.
585
- *
586
- * Delegates deletion to the Session model's best-effort decoded-byte overwrite.
587
- */
588
- async deleteSession(sessionId) {
589
- try {
590
- await deleteSessionById(sessionId);
591
- }
592
- catch (error) {
593
- throw new EncryptionError(`Failed to delete session ${sessionId}`, EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
594
- }
595
- }
596
- /**
597
- * Clear all sessions for logout or controlled local reset.
598
- *
599
- */
600
- async clearAllSessions() {
601
- try {
602
- await deleteAllSessions();
603
- }
604
- catch (error) {
605
- throw new EncryptionError('Failed to clear all sessions', EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
606
- }
607
- }
608
- /**
609
- * Get all session IDs from the database.
610
- *
611
- * Used by SESAME session management to enumerate all users with sessions.
612
- * Session IDs follow Signal Protocol format: "userId:deviceId"
613
- *
614
- * @returns Array of all session IDs in the database
615
- * @throws {EncryptionError} If database query fails
616
- *
617
- */
618
- async getAllSessionIds() {
619
- try {
620
- return await modelGetAllSessionIds();
621
- }
622
- catch (error) {
623
- throw new EncryptionError('Failed to get all session IDs', EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
624
- }
625
- }
626
- /**
627
- * Get all session IDs for a user
628
- * Uses Signal Protocol standard colon separator (userId:deviceId)
629
- *
630
- */
631
- async getSessionIdsForUser(userId) {
632
- try {
633
- return await getSessionIdsByUserId(userId);
634
- }
635
- catch (error) {
636
- throw new EncryptionError(`Failed to get session IDs for user ${userId}`, EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
637
- }
638
- }
639
- /**
640
- * Get all sessions by IDs
641
- *
642
- */
643
- async getAllSessions(sessionIds) {
644
- try {
645
- if (sessionIds.length === 0) {
646
- return {};
647
- }
648
- return await getSessionsByIds(sessionIds);
649
- }
650
- catch (error) {
651
- this.logger.warn('Failed to fetch sessions', {
652
- category: 'KeyStorage',
653
- error: error,
654
- });
655
- return {};
656
- }
657
- }
658
- // ============================================================================
659
- // Utility Methods
660
- // ============================================================================
661
- /**
662
- * Check if identity key exists
663
- */
664
- async hasIdentityKey(identityType = 'aci') {
665
- try {
666
- const key = await this.getIdentityKey(identityType);
667
- return key !== null;
668
- }
669
- catch {
670
- return false;
671
- }
672
- }
673
- // ============================================================================
674
- // Metadata storage
675
- // ============================================================================
676
- async getMetadata(key) {
677
- const db = getRawDatabase();
678
- const row = await db.getFirstAsync('SELECT value FROM metadata WHERE key = ?', [key]);
679
- return row?.value ?? null;
680
- }
681
- async getReceivedContent(id) {
682
- const value = await this.getMetadata(`received-content:${id}`);
683
- return value ? parseReceivedContent(value, id) : null;
684
- }
685
- async deleteReceivedContent(id) {
686
- await this.deleteMetadata(`received-content:${id}`);
687
- }
688
- async deleteExpiredReceivedContent(before) {
689
- const db = getRawDatabase();
690
- const result = await db.runAsync("DELETE FROM metadata WHERE key LIKE 'received-content:%' AND CAST(json_extract(value, '$.receivedAt') AS INTEGER) < ?", [before]);
691
- return result.changes;
692
- }
693
- async setMetadata(key, value) {
694
- const db = getRawDatabase();
695
- await db.runAsync('INSERT OR REPLACE INTO metadata (key, value, updated_at) VALUES (?, ?, ?)', [
696
- key,
697
- value,
698
- Date.now(),
699
- ]);
700
- }
701
- async deleteMetadata(key) {
702
- const db = getRawDatabase();
703
- await db.runAsync('DELETE FROM metadata WHERE key = ?', [key]);
704
- }
705
- async compareAndSetMetadata(key, expected, value) {
706
- const db = getRawDatabase();
707
- if (expected === null && value === null)
708
- return (await this.getMetadata(key)) === null;
709
- const result = expected === null
710
- ? await db.runAsync('INSERT OR IGNORE INTO metadata (key, value, updated_at) VALUES (?, ?, ?)', [key, value, Date.now()])
711
- : value === null
712
- ? await db.runAsync('DELETE FROM metadata WHERE key = ? AND value = ?', [key, expected])
713
- : await db.runAsync('UPDATE metadata SET value = ?, updated_at = ? WHERE key = ? AND value = ?', [value, Date.now(), key, expected]);
714
- return result.changes === 1;
715
- }
716
- /**
717
- * Clear all encryption keys
718
- *
719
- */
720
- async clearAllKeys() {
721
- try {
722
- const db = getRawDatabase();
723
- // Wrap all DELETEs in one transaction, so the operation is atomic
724
- // If any DELETE fails, entire operation is rolled back
725
- await db.withTransactionAsync(async () => {
726
- await db.runAsync(`DELETE FROM identity_keys`);
727
- await db.runAsync(`DELETE FROM recipient_identities`);
728
- await db.runAsync(`DELETE FROM ec_signed_prekeys`);
729
- await db.runAsync(`DELETE FROM ec_one_time_prekeys`);
730
- await db.runAsync(`DELETE FROM kyber_prekeys`);
731
- await db.runAsync(`DELETE FROM kyber_prekey_used`);
732
- await db.runAsync(`DELETE FROM sessions`);
733
- });
734
- // Secret-vault deletion cannot join the SQLite transaction. A failure is
735
- // surfaced so the application can retry coordinated account teardown.
736
- const dbKeyManager = getDatabaseKeyManager(this.logger);
737
- await dbKeyManager.deleteKey();
738
- this.logger.warn('All keys cleared', { category: 'KeyStorage' });
739
- }
740
- catch (error) {
741
- throw new EncryptionError('Failed to clear all keys', EncryptionErrorCode.KEY_STORAGE_ERROR, {
742
- originalError: error,
743
- });
744
- }
745
- }
746
- /**
747
- * Wipe all Signal Protocol data
748
- *
749
- */
750
- async wipeAllSignalProtocolData() {
751
- try {
752
- const stats = await this.getDetailedStats();
753
- const db = getRawDatabase();
754
- // Wrap all DELETEs in one transaction, so the operation is atomic
755
- // If any DELETE fails, entire operation is rolled back
756
- await db.withTransactionAsync(async () => {
757
- await db.runAsync(`DELETE FROM identity_keys`);
758
- await db.runAsync(`DELETE FROM recipient_identities`);
759
- await db.runAsync(`DELETE FROM ec_signed_prekeys`);
760
- await db.runAsync(`DELETE FROM ec_one_time_prekeys`);
761
- await db.runAsync(`DELETE FROM kyber_prekeys`);
762
- await db.runAsync(`DELETE FROM kyber_prekey_used`);
763
- await db.runAsync(`DELETE FROM kyber_one_time_prekeys`);
764
- await db.runAsync(`DELETE FROM sessions`);
765
- await db.runAsync(`DELETE FROM sesame_device_records`);
766
- });
767
- this.logger.info('All Signal Protocol data wiped', { category: 'KeyStorage', data: stats });
768
- return stats;
769
- }
770
- catch (error) {
771
- throw new EncryptionError('Failed to wipe Signal Protocol data', EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
772
- }
773
- }
774
- /**
775
- * Get storage statistics
776
- */
777
- async getStorageStats() {
778
- try {
779
- const hasIdentityKey = await this.hasIdentityKey();
780
- const ecSignedPreKey = await this.getEcSignedPreKey();
781
- const ecOneTimePreKeysCount = await this.getEcOneTimePreKeyCount();
782
- return { hasIdentityKey, hasEcSignedPreKey: ecSignedPreKey !== null, ecOneTimePreKeysCount };
783
- }
784
- catch (error) {
785
- throw new EncryptionError('Failed to get storage stats', EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
786
- }
787
- }
788
- /**
789
- * Get detailed statistics
790
- *
791
- */
792
- async getDetailedStats() {
793
- try {
794
- const db = getRawDatabase();
795
- const [ecSigned, ecOneTime, kyber, kemOneTime, sessions, users] = await Promise.all([
796
- db.getFirstAsync(`SELECT COUNT(*) as count FROM ec_signed_prekeys`),
797
- db.getFirstAsync(`SELECT COUNT(*) as count FROM ec_one_time_prekeys`),
798
- db.getFirstAsync(`SELECT COUNT(*) as count FROM kyber_prekeys`),
799
- db.getFirstAsync(`SELECT COUNT(*) as count FROM kyber_one_time_prekeys`),
800
- db.getFirstAsync(`SELECT COUNT(*) as count FROM sessions`),
801
- db.getFirstAsync(`SELECT COUNT(DISTINCT user_id) as count FROM sesame_device_records`),
802
- ]);
803
- return {
804
- sessions: sessions?.count ?? 0,
805
- ecSignedPreKeys: ecSigned?.count ?? 0,
806
- ecOneTimePreKeys: ecOneTime?.count ?? 0,
807
- kyberPreKeys: kyber?.count ?? 0,
808
- kemOneTimePreKeys: kemOneTime?.count ?? 0,
809
- users: users?.count ?? 0,
810
- };
811
- }
812
- catch (error) {
813
- throw new EncryptionError('Failed to get detailed stats', EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
814
- }
815
- }
816
- /**
817
- * Validate session integrity
818
- *
819
- */
820
- async validateSession(sessionId) {
821
- try {
822
- const session = await getSessionById(sessionId);
823
- if (!session) {
824
- return false;
825
- }
826
- return await session.validate();
827
- }
828
- catch (error) {
829
- this.logger.error('Session validation error', {
830
- category: 'KeyStorage',
831
- error: error,
832
- });
833
- return false;
834
- }
835
- }
836
- // ============================================================================
837
- // Registration ID Management
838
- // ============================================================================
839
- /**
840
- */
841
- async getLocalRegistrationId(identityType = 'aci') {
842
- const registrationId = await modelGetLocalRegistrationId(identityType);
843
- return registrationId ?? 0;
844
- }
845
- /**
846
- */
847
- async setLocalRegistrationId(id, identityType = 'aci') {
848
- await modelSetLocalRegistrationId(id, identityType);
849
- }
850
- // ============================================================================
851
- // Contact Identity Management
852
- // ============================================================================
853
- /**
854
- */
855
- async saveContactIdentity(address, identity, identityType = 'aci', suppliedCommitment) {
856
- try {
857
- const { IdentityKeyChange } = await import('../../../types/trust.js');
858
- const existing = await modelGetContactIdentity(address.userId, identityType);
859
- const status = evaluateContactIdentityCandidate(existing, identity, suppliedCommitment);
860
- if (status === 'NEW') {
861
- await modelSaveContactIdentity(address.userId, createUnverifiedContactIdentityRecord(identity, Date.now()), identityType);
862
- return IdentityKeyChange.NEW_IDENTITY;
863
- }
864
- if (status === 'MATCH')
865
- return IdentityKeyChange.UNCHANGED;
866
- if (status === 'ROLLBACK')
867
- return IdentityKeyChange.ROLLBACK;
868
- return IdentityKeyChange.CHANGED;
869
- }
870
- catch (error) {
871
- throw new EncryptionError('Failed to save contact identity', EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
872
- }
873
- }
874
- /**
875
- */
876
- async getContactIdentity(address, identityType = 'aci') {
877
- try {
878
- return await modelGetContactIdentity(address.userId, identityType);
879
- }
880
- catch (error) {
881
- throw new EncryptionError('Failed to get contact identity', EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
882
- }
883
- }
884
- async acceptContactIdentityRotation(address, identity, identityType = 'aci', suppliedCommitment) {
885
- return await this.acceptContactIdentityRotationAndDeleteSessions(ProtocolAddress.create(address.userId, address.deviceId), identity, identityType, suppliedCommitment);
886
- }
887
- async acceptContactIdentityRotationAndDeleteSessions(address, identity, identityType = 'aci', suppliedCommitment) {
888
- const db = getRawDatabase();
889
- let replacement;
890
- await db.withTransactionAsync(async () => {
891
- const recipientId = buildContactIdentityId(address.userId, identityType);
892
- const row = await db.getFirstAsync(`SELECT record_json AS recordJson FROM recipient_identities WHERE recipient_id = ?`, [recipientId]);
893
- if (!row)
894
- throw new Error('Cannot rotate an unseen identity');
895
- const existing = JSON.parse(row.recordJson);
896
- validateContactIdentityRecord(existing);
897
- replacement = acceptRotation(existing, identity, Date.now(), suppliedCommitment);
898
- validateContactIdentityRecord(replacement);
899
- await db.runAsync(`INSERT OR REPLACE INTO recipient_identities
900
- (recipient_id, identity_type, record_json, updated_at) VALUES (?, ?, ?, ?)`, [recipientId, identityType, JSON.stringify(replacement), Date.now()]);
901
- const sessions = await db.getAllAsync(`SELECT session_id AS sessionId FROM sessions`);
902
- for (const session of sessions) {
903
- let parsed;
904
- try {
905
- parsed = ProtocolAddress.parse(session.sessionId);
906
- }
907
- catch {
908
- continue;
909
- }
910
- if (parsed.userId === address.userId) {
911
- await db.runAsync(`DELETE FROM sessions WHERE session_id = ?`, [session.sessionId]);
912
- }
913
- }
914
- });
915
- if (!replacement)
916
- throw new Error('Identity rotation transaction produced no replacement');
917
- return replacement;
918
- }
919
- async verifyContactIdentity(address, identity, identityType = 'aci', suppliedCommitment) {
920
- const db = getRawDatabase();
921
- let verified;
922
- await db.withTransactionAsync(async () => {
923
- const recipientId = buildContactIdentityId(address.userId, identityType);
924
- const row = await db.getFirstAsync(`SELECT record_json AS recordJson FROM recipient_identities WHERE recipient_id = ?`, [recipientId]);
925
- if (!row)
926
- throw new Error('Cannot verify an unseen identity');
927
- const existing = JSON.parse(row.recordJson);
928
- validateContactIdentityRecord(existing);
929
- verified = verifyContactIdentityRecord(existing, identity, Date.now(), suppliedCommitment);
930
- validateContactIdentityRecord(verified);
931
- await db.runAsync(`INSERT OR REPLACE INTO recipient_identities
932
- (recipient_id, identity_type, record_json, updated_at) VALUES (?, ?, ?, ?)`, [recipientId, identityType, JSON.stringify(verified), Date.now()]);
933
- });
934
- if (!verified)
935
- throw new Error('Identity verification transaction produced no result');
936
- return verified;
937
- }
938
- /**
939
- */
940
- async isTrustedIdentity(address, identity, _direction, identityType = 'aci') {
941
- const status = evaluateContactIdentityCandidate(await modelGetContactIdentity(address.userId, identityType), identity);
942
- return status === 'NEW' || status === 'MATCH';
943
- }
944
- // ============================================================================
945
- // Session record management
946
- // ============================================================================
947
- async storeSessionRecord(address, record) {
948
- // Use colon separator to match ProtocolAddress.toString() format
949
- const sessionId = `${address.userId}:${address.deviceId}`;
950
- assertCurrentSessionRecord(record);
951
- await createSessionFromRecord(sessionId, record).save();
952
- }
953
- async commitSessionTrust(commit) {
954
- assertCurrentSessionRecord(commit.record);
955
- const db = getRawDatabase();
956
- const sessionId = ProtocolAddress.toString(commit.address);
957
- const serialized = serializeSessionRecord(commit.record);
958
- const now = Date.now();
959
- await db.withTransactionAsync(async () => {
960
- const existingContact = await modelGetContactIdentity(commit.address.userId, commit.contactIdentityType);
961
- const contactStatus = evaluateContactIdentityCandidate(existingContact, commit.contactIdentity);
962
- if (contactStatus !== 'NEW' && contactStatus !== 'MATCH') {
963
- throw new Error(`Atomic session/trust commit rejected contact identity status ${contactStatus}`);
964
- }
965
- if (commit.oneTimePreKeyId !== undefined &&
966
- !(await getEcOneTimePreKeyByKeyId(commit.oneTimePreKeyId, commit.localIdentityType))) {
967
- throw new Error('Atomic session/trust commit cannot consume a missing EC one-time prekey');
968
- }
969
- if (commit.kemOneTimePreKeyId !== undefined &&
970
- !(await getKyberOneTimePreKeyByKeyId(commit.kemOneTimePreKeyId, commit.localIdentityType))) {
971
- throw new Error('Atomic session/trust commit cannot consume a missing KEM one-time prekey');
972
- }
973
- let kyberParentRowId;
974
- let kyberBaseKey;
975
- if (commit.kyberPreKeyUse) {
976
- const parent = await db.getFirstAsync(`SELECT id FROM kyber_prekeys
977
- WHERE identity_type = ? AND prekey_id = ? AND instance_id = ?`, [
978
- commit.localIdentityType,
979
- commit.kyberPreKeyUse.kyberPreKeyId,
980
- commit.kyberPreKeyUse.kyberPreKeyInstanceId,
981
- ]);
982
- if (!parent) {
983
- throw new Error('Atomic session/trust commit rejected a Kyber prekey instance mismatch');
984
- }
985
- kyberParentRowId = parent.id;
986
- kyberBaseKey = Buffer.from(commit.kyberPreKeyUse.baseKeyBytes).toString('base64');
987
- const reused = await db.getFirstAsync(`SELECT 1 AS present FROM kyber_prekey_used
988
- WHERE kyber_prekey_row_id = ? AND signed_prekey_identity = ?
989
- AND signed_prekey_id = ? AND base_key = ?`, [
990
- kyberParentRowId,
991
- commit.localIdentityType,
992
- commit.kyberPreKeyUse.signedPreKeyId,
993
- kyberBaseKey,
994
- ]);
995
- if (reused) {
996
- throw new ReusedBaseKeyError(commit.kyberPreKeyUse.kyberPreKeyId, commit.kyberPreKeyUse.signedPreKeyId);
997
- }
998
- }
999
- if (contactStatus === 'NEW') {
1000
- await modelSaveContactIdentity(commit.address.userId, createUnverifiedContactIdentityRecord(commit.contactIdentity, now), commit.contactIdentityType);
1001
- }
1002
- await db.runAsync(`INSERT INTO sessions (session_id, identity_type, record, created_at, updated_at)
1003
- VALUES (?, ?, ?, ?, ?)
1004
- ON CONFLICT(session_id) DO UPDATE SET
1005
- identity_type = excluded.identity_type,
1006
- record = excluded.record,
1007
- updated_at = excluded.updated_at`, [sessionId, commit.contactIdentityType, serialized, now, now]);
1008
- if (commit.oneTimePreKeyId !== undefined) {
1009
- await db.runAsync(`DELETE FROM ec_one_time_prekeys WHERE identity_type = ? AND prekey_id = ?`, [commit.localIdentityType, commit.oneTimePreKeyId]);
1010
- }
1011
- if (commit.kemOneTimePreKeyId !== undefined) {
1012
- await db.runAsync(`DELETE FROM kyber_one_time_prekeys WHERE identity_type = ? AND prekey_id = ?`, [commit.localIdentityType, commit.kemOneTimePreKeyId]);
1013
- }
1014
- if (commit.kyberPreKeyUse && kyberParentRowId !== undefined && kyberBaseKey) {
1015
- await db.runAsync(`INSERT INTO kyber_prekey_used
1016
- (kyber_prekey_row_id, signed_prekey_identity, signed_prekey_id, base_key)
1017
- VALUES (?, ?, ?, ?)`, [
1018
- kyberParentRowId,
1019
- commit.localIdentityType,
1020
- commit.kyberPreKeyUse.signedPreKeyId,
1021
- kyberBaseKey,
1022
- ]);
1023
- }
1024
- if (commit.receivedContent)
1025
- await this.setMetadata(`received-content:${commit.receivedContent.id}`, JSON.stringify(commit.receivedContent));
1026
- });
1027
- }
1028
- /**
1029
- * Get session record by address
1030
- *
1031
- */
1032
- async getSessionRecord(address) {
1033
- try {
1034
- // Use colon separator to match ProtocolAddress.toString() format
1035
- const sessionId = `${address.userId}:${address.deviceId}`;
1036
- const db = getRawDatabase();
1037
- const row = await db.getFirstAsync(`SELECT record FROM sessions WHERE session_id = ?`, [sessionId]);
1038
- if (!row) {
1039
- return null;
1040
- }
1041
- let record;
1042
- try {
1043
- record = deserializeSessionRecord(row.record);
1044
- assertCurrentSessionRecord(record);
1045
- }
1046
- catch {
1047
- await db.runAsync(`DELETE FROM sessions WHERE session_id = ?`, [sessionId]);
1048
- return null;
1049
- }
1050
- return {
1051
- currentSession: record.currentSession,
1052
- archivedSessions: record.archivedSessions,
1053
- version: record.version,
1054
- metadata: record.metadata,
1055
- };
1056
- }
1057
- catch (error) {
1058
- throw new EncryptionError(`Failed to retrieve session record for ${address.userId}:${address.deviceId}`, EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
1059
- }
1060
- }
1061
- async deleteSessionRecord(address) {
1062
- // Use colon separator to match ProtocolAddress.toString() format
1063
- const sessionId = `${address.userId}:${address.deviceId}`;
1064
- await this.deleteSession(sessionId);
1065
- }
1066
- async archiveCurrentSession(address, newSession) {
1067
- const sessionId = ProtocolAddress.toString(address);
1068
- if (newSession) {
1069
- const existing = await this.getSessionRecord(address);
1070
- const record = existing ?? SessionRecord.create(newSession);
1071
- if (existing) {
1072
- SessionRecord.archiveCurrent(record, newSession);
1073
- }
1074
- await createSessionFromRecord(sessionId, record).save();
1075
- }
1076
- else {
1077
- await this.deleteSession(sessionId);
1078
- }
1079
- }
1080
- async getSessionsForUser(userId) {
1081
- try {
1082
- const sessionIds = await this.getSessionIdsForUser(userId);
1083
- if (sessionIds.length === 0)
1084
- return [];
1085
- const records = [];
1086
- for (const sessionId of sessionIds) {
1087
- const session = await getSessionById(sessionId);
1088
- if (!session || session.version !== SESSION_VERSION)
1089
- continue;
1090
- records.push(session.record);
1091
- }
1092
- return records;
1093
- }
1094
- catch (error) {
1095
- throw new EncryptionError(`Failed to get sessions for user ${userId}`, EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
1096
- }
1097
- }
1098
- /**
1099
- */
1100
- async hasSession(address) {
1101
- // Use Signal Protocol standard colon separator
1102
- const sessionId = `${address.userId}:${address.deviceId}`;
1103
- return await sessionExists(sessionId);
1104
- }
1105
- /**
1106
- */
1107
- async getSessionCount() {
1108
- return await countSessions();
1109
- }
1110
- // ============================================================================
1111
- // MessageRecord Storage (SESAME Retry Request Support)
1112
- // Per SESAME Specification Section 6.2
1113
- //
1114
- // Retry records are indexed by the client timestamp assigned before encryption.
1115
- // The primary lookup method is getMessageRecord().
1116
- // ============================================================================
1117
- /**
1118
- * Store a message record for potential retry resending
1119
- *
1120
- * Called after successful encryption to store the plaintext.
1121
- * Record is deleted after confirmed delivery or expiration.
1122
- *
1123
- */
1124
- async storeMessageRecord(record) {
1125
- try {
1126
- const messageRecordModel = createMessageRecord({
1127
- sessionId: record.sessionId,
1128
- timestamp: record.timestamp,
1129
- recipientUserId: record.recipientUserId,
1130
- recipientDeviceId: record.recipientDeviceId,
1131
- plaintext: record.plaintext,
1132
- sessionStateId: record.sessionStateId,
1133
- createdAt: record.createdAt,
1134
- });
1135
- await messageRecordModel.save();
1136
- this.logger.debug('Stored message record for retry support', {
1137
- category: 'KeyStorage',
1138
- data: {
1139
- sessionId: record.sessionId,
1140
- timestamp: record.timestamp,
1141
- recipient: `${record.recipientUserId}:${record.recipientDeviceId}`,
1142
- },
1143
- });
1144
- }
1145
- catch (error) {
1146
- throw new EncryptionError(`Failed to store message record ${record.sessionId}:${record.timestamp}`, EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
1147
- }
1148
- }
1149
- /**
1150
- * Get a message record by session and timestamp
1151
- *
1152
- */
1153
- async getMessageRecord(sessionId, timestamp) {
1154
- try {
1155
- const record = await modelGetMessageRecord(sessionId, timestamp);
1156
- return record?.toStoredMessageRecord() ?? null;
1157
- }
1158
- catch (error) {
1159
- throw new EncryptionError(`Failed to get message record ${sessionId}:${timestamp}`, EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
1160
- }
1161
- }
1162
- /**
1163
- * Delete all expired message records older than maxAgeMs
1164
- *
1165
- * Called periodically to clean up old records.
1166
- * Per SESAME spec: "The maxLatency setting serves as an upper bound on message age"
1167
- *
1168
- */
1169
- async deleteExpiredMessageRecords(maxAgeMs) {
1170
- try {
1171
- const deleted = await modelDeleteExpiredMessageRecords(maxAgeMs);
1172
- if (deleted > 0) {
1173
- this.logger.info('Deleted expired message records', {
1174
- category: 'KeyStorage',
1175
- data: { deleted, maxAgeMs },
1176
- });
1177
- }
1178
- return deleted;
1179
- }
1180
- catch (error) {
1181
- throw new EncryptionError('Failed to delete expired message records', EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
1182
- }
1183
- }
1184
- /**
1185
- * Clear all message records
1186
- *
1187
- * Called when device re-registers and all local sessions are cleared.
1188
- * All stored message records become orphaned and should be deleted.
1189
- *
1190
- */
1191
- async clearAllMessageRecords() {
1192
- try {
1193
- const deleted = await modelDeleteAllMessageRecords();
1194
- if (deleted > 0) {
1195
- this.logger.info('Cleared all message records', {
1196
- category: 'KeyStorage',
1197
- data: { deleted },
1198
- });
1199
- }
1200
- return deleted;
1201
- }
1202
- catch (error) {
1203
- throw new EncryptionError('Failed to clear message records', EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
1204
- }
1205
- }
1206
- /**
1207
- * Delete all message records for a session
1208
- *
1209
- * Called when a session is archived or deleted.
1210
- *
1211
- */
1212
- async deleteMessageRecordsForSession(sessionId) {
1213
- try {
1214
- const deleted = await modelDeleteMessageRecordsBySessionId(sessionId);
1215
- if (deleted > 0) {
1216
- this.logger.debug('Deleted message records for session', {
1217
- category: 'KeyStorage',
1218
- data: { sessionId, deleted },
1219
- });
1220
- }
1221
- return deleted;
1222
- }
1223
- catch (error) {
1224
- throw new EncryptionError(`Failed to delete message records for session ${sessionId}`, EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
1225
- }
1226
- }
1227
- /**
1228
- * Get count of message records (for statistics)
1229
- *
1230
- */
1231
- async getMessageRecordCount() {
1232
- try {
1233
- return await countMessageRecords();
1234
- }
1235
- catch (error) {
1236
- throw new EncryptionError('Failed to get message record count', EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
1237
- }
1238
- }
1239
- /**
1240
- * Delete a message record by session and timestamp.
1241
- *
1242
- * Called when processing delivery receipts to clean up confirmed messages.
1243
- * Per Signal Protocol, messages are identified by client timestamp.
1244
- *
1245
- * @param sessionId - Session identifier (userId:deviceId)
1246
- * @param timestamp - Client timestamp (set before encryption)
1247
- */
1248
- async deleteMessageRecord(sessionId, timestamp) {
1249
- try {
1250
- await modelDeleteMessageRecord(sessionId, timestamp);
1251
- this.logger.debug('Deleted message record after delivery receipt', {
1252
- category: 'KeyStorage',
1253
- data: { sessionId, timestamp },
1254
- });
1255
- }
1256
- catch (error) {
1257
- throw new EncryptionError(`Failed to delete message record ${sessionId}:${timestamp}`, EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
1258
- }
1259
- }
1260
- // ============================================================================
1261
- // Key Recovery Support (Bug #7 - PQXDH §4.13 Identifier Collision Recovery)
1262
- // ============================================================================
1263
- /**
1264
- * Get the maximum signed prekey ID in storage.
1265
- *
1266
- * Used during key recovery to generate new prekeys with fresh IDs
1267
- * that avoid identifier collisions (PQXDH §4.13).
1268
- *
1269
- * @returns The highest prekey_id, or 0 if no signed prekeys exist
1270
- */
1271
- /**
1272
- */
1273
- async getEcSignedPreKeyMaxId(identityType = 'aci') {
1274
- try {
1275
- return await getMaxEcSignedPreKeyId(identityType);
1276
- }
1277
- catch (error) {
1278
- throw new EncryptionError('Failed to get max signed prekey ID', EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
1279
- }
1280
- }
1281
- /**
1282
- * Get the maximum Kyber prekey ID in storage.
1283
- *
1284
- * Used during key recovery to generate new prekeys with fresh IDs
1285
- * that avoid identifier collisions (PQXDH §4.13).
1286
- *
1287
- * @returns The highest prekey_id, or 0 if no Kyber prekeys exist
1288
- *
1289
- */
1290
- async getKyberPreKeyMaxId(identityType = 'aci') {
1291
- try {
1292
- return await getMaxKyberPreKeyId(identityType);
1293
- }
1294
- catch (error) {
1295
- throw new EncryptionError('Failed to get max Kyber prekey ID', EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
1296
- }
1297
- }
1298
- /**
1299
- * Delete all prekeys (signed, one-time, Kyber, KEM one-time).
1300
- *
1301
- * Used during key recovery when persistent MAC failures indicate
1302
- * identifier collision (same keyId, different publicKey).
1303
- * Per PQXDH §4.13, this forces fresh key generation with new IDs.
1304
- *
1305
- * NOTE: This preserves identity keys and sessions.
1306
- *
1307
- */
1308
- async deleteAllPreKeys(identityType = 'aci') {
1309
- try {
1310
- const db = getRawDatabase();
1311
- // Get counts before deletion for logging
1312
- const [ecSigned, ecOneTime, kyber, kemOneTime] = await Promise.all([
1313
- db.getFirstAsync(`SELECT COUNT(*) as count FROM ec_signed_prekeys WHERE identity_type = ?`, [identityType]),
1314
- db.getFirstAsync(`SELECT COUNT(*) as count FROM ec_one_time_prekeys WHERE identity_type = ?`, [identityType]),
1315
- db.getFirstAsync(`SELECT COUNT(*) as count FROM kyber_prekeys WHERE identity_type = ?`, [identityType]),
1316
- db.getFirstAsync(`SELECT COUNT(*) as count FROM kyber_one_time_prekeys WHERE identity_type = ?`, [identityType]),
1317
- ]);
1318
- const stats = {
1319
- ecSignedPreKeys: ecSigned?.count ?? 0,
1320
- ecOneTimePreKeys: ecOneTime?.count ?? 0,
1321
- kyberPreKeys: kyber?.count ?? 0,
1322
- kemOneTimePreKeys: kemOneTime?.count ?? 0,
1323
- };
1324
- // Delete prekeys for the specified identity type
1325
- await db.runAsync(`DELETE FROM ec_signed_prekeys WHERE identity_type = ?`, [identityType]);
1326
- await db.runAsync(`DELETE FROM ec_one_time_prekeys WHERE identity_type = ?`, [identityType]);
1327
- await db.runAsync(`DELETE FROM kyber_prekeys WHERE identity_type = ?`, [identityType]);
1328
- await db.runAsync(`DELETE FROM kyber_prekey_used WHERE signed_prekey_identity = ?`, [
1329
- identityType,
1330
- ]);
1331
- await db.runAsync(`DELETE FROM kyber_one_time_prekeys WHERE identity_type = ?`, [
1332
- identityType,
1333
- ]);
1334
- this.logger.warn('Deleted all prekeys for key recovery', {
1335
- category: 'KeyStorage',
1336
- data: { ...stats, identityType },
1337
- });
1338
- return stats;
1339
- }
1340
- catch (error) {
1341
- throw new EncryptionError('Failed to delete all prekeys', EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
1342
- }
1343
- }
1344
- }
1345
- // ============================================================================
1346
- // Singleton
1347
- // ============================================================================
1348
- let keyStorageInstance = null;
1349
- export function getKeyStorage(providedLogger) {
1350
- if (!keyStorageInstance) {
1351
- keyStorageInstance = new KeyStorage(providedLogger);
1352
- }
1353
- else if (providedLogger) {
1354
- keyStorageInstance.setLogger(providedLogger);
1355
- }
1356
- return keyStorageInstance;
1357
- }
1358
- export async function resetKeyStorage() {
1359
- keyStorageInstance = null;
1360
- }
1361
- //# sourceMappingURL=key-storage.js.map