@open-e2ee/signal-protocol-sdk 8.1.0 → 9.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (387) hide show
  1. package/ADAPTERS.md +13 -31
  2. package/ARCHITECTURE.md +5 -7
  3. package/CHANGELOG.md +258 -0
  4. package/README.md +36 -48
  5. package/SECURITY.md +2 -2
  6. package/client/README.md +9 -0
  7. package/device/README.md +16 -7
  8. package/dist/client/client.d.ts +25 -16
  9. package/dist/client/client.d.ts.map +1 -1
  10. package/dist/client/client.js +115 -95
  11. package/dist/client/client.js.map +1 -1
  12. package/dist/client/config.d.ts +10 -17
  13. package/dist/client/config.d.ts.map +1 -1
  14. package/dist/client/config.js.map +1 -1
  15. package/dist/client/event-hooks.js +27 -0
  16. package/dist/client/event-hooks.js.map +1 -1
  17. package/dist/client/group-outbox.d.ts +31 -1
  18. package/dist/client/group-outbox.d.ts.map +1 -1
  19. package/dist/client/group-outbox.js +67 -58
  20. package/dist/client/group-outbox.js.map +1 -1
  21. package/dist/client/group-receive-authorization.d.ts +5 -0
  22. package/dist/client/group-receive-authorization.d.ts.map +1 -0
  23. package/dist/client/group-receive-authorization.js +32 -0
  24. package/dist/client/group-receive-authorization.js.map +1 -0
  25. package/dist/client/group-sender-key-operations.d.ts +15 -0
  26. package/dist/client/group-sender-key-operations.d.ts.map +1 -0
  27. package/dist/client/group-sender-key-operations.js +31 -0
  28. package/dist/client/group-sender-key-operations.js.map +1 -0
  29. package/dist/client/groups.d.ts +3 -1
  30. package/dist/client/groups.d.ts.map +1 -1
  31. package/dist/client/groups.js +5 -2
  32. package/dist/client/groups.js.map +1 -1
  33. package/dist/client/hosted-anonymous-delivery.d.ts +9 -1
  34. package/dist/client/hosted-anonymous-delivery.d.ts.map +1 -1
  35. package/dist/client/hosted-anonymous-delivery.js +61 -22
  36. package/dist/client/hosted-anonymous-delivery.js.map +1 -1
  37. package/dist/client/hosted-transport.d.ts +7 -0
  38. package/dist/client/hosted-transport.d.ts.map +1 -1
  39. package/dist/client/hosted-transport.js +44 -6
  40. package/dist/client/hosted-transport.js.map +1 -1
  41. package/dist/client/key-rotation.d.ts.map +1 -1
  42. package/dist/client/key-rotation.js +2 -4
  43. package/dist/client/key-rotation.js.map +1 -1
  44. package/dist/client/prekeys.d.ts.map +1 -1
  45. package/dist/client/prekeys.js +1 -1
  46. package/dist/client/prekeys.js.map +1 -1
  47. package/dist/client/relay-device-refusal.d.ts +32 -0
  48. package/dist/client/relay-device-refusal.d.ts.map +1 -0
  49. package/dist/client/relay-device-refusal.js +36 -0
  50. package/dist/client/relay-device-refusal.js.map +1 -0
  51. package/dist/client/relay-subscription.d.ts +2 -0
  52. package/dist/client/relay-subscription.d.ts.map +1 -1
  53. package/dist/client/relay-subscription.js +3 -1
  54. package/dist/client/relay-subscription.js.map +1 -1
  55. package/dist/client/relay-work.d.ts +26 -0
  56. package/dist/client/relay-work.d.ts.map +1 -1
  57. package/dist/client/relay-work.js +37 -0
  58. package/dist/client/relay-work.js.map +1 -1
  59. package/dist/client/sealed-sender.d.ts.map +1 -1
  60. package/dist/client/sealed-sender.js +12 -17
  61. package/dist/client/sealed-sender.js.map +1 -1
  62. package/dist/client/sender-key-distribution.d.ts.map +1 -1
  63. package/dist/client/sender-key-distribution.js +4 -1
  64. package/dist/client/sender-key-distribution.js.map +1 -1
  65. package/dist/client/sessions.d.ts.map +1 -1
  66. package/dist/client/sessions.js +2 -4
  67. package/dist/client/sessions.js.map +1 -1
  68. package/dist/client/signal-service-cipher.d.ts +94 -6
  69. package/dist/client/signal-service-cipher.d.ts.map +1 -1
  70. package/dist/client/signal-service-cipher.js +483 -184
  71. package/dist/client/signal-service-cipher.js.map +1 -1
  72. package/dist/client/types.d.ts +7 -0
  73. package/dist/client/types.d.ts.map +1 -1
  74. package/dist/client/types.js.map +1 -1
  75. package/dist/index.d.ts +27 -21
  76. package/dist/index.d.ts.map +1 -1
  77. package/dist/index.js +8 -17
  78. package/dist/index.js.map +1 -1
  79. package/dist/internal/crypto/pq/kyber.d.ts +1 -1
  80. package/dist/internal/crypto/pq/kyber.js +1 -1
  81. package/dist/internal/encoding/proto/sender-key-message.d.ts +2 -2
  82. package/dist/internal/encoding/proto/sender-key-message.d.ts.map +1 -1
  83. package/dist/internal/encoding/proto/sender-key-message.js +5 -2
  84. package/dist/internal/encoding/proto/sender-key-message.js.map +1 -1
  85. package/dist/internal/groups/manager.d.ts.map +1 -1
  86. package/dist/internal/groups/manager.js +5 -2
  87. package/dist/internal/groups/manager.js.map +1 -1
  88. package/dist/internal/groups/wire.d.ts +0 -2
  89. package/dist/internal/groups/wire.d.ts.map +1 -1
  90. package/dist/internal/groups/wire.js +0 -6
  91. package/dist/internal/groups/wire.js.map +1 -1
  92. package/dist/internal/manager/manager.d.ts +8 -7
  93. package/dist/internal/manager/manager.d.ts.map +1 -1
  94. package/dist/internal/manager/manager.js +34 -37
  95. package/dist/internal/manager/manager.js.map +1 -1
  96. package/dist/internal/protocol/double-ratchet/ratchet.d.ts +0 -17
  97. package/dist/internal/protocol/double-ratchet/ratchet.d.ts.map +1 -1
  98. package/dist/internal/protocol/double-ratchet/ratchet.js +0 -4
  99. package/dist/internal/protocol/double-ratchet/ratchet.js.map +1 -1
  100. package/dist/internal/protocol/sealed-sender/certificate.d.ts +2 -32
  101. package/dist/internal/protocol/sealed-sender/certificate.d.ts.map +1 -1
  102. package/dist/internal/protocol/sealed-sender/certificate.js +4 -85
  103. package/dist/internal/protocol/sealed-sender/certificate.js.map +1 -1
  104. package/dist/internal/protocol/sealed-sender/index.d.ts +2 -2
  105. package/dist/internal/protocol/sealed-sender/index.d.ts.map +1 -1
  106. package/dist/internal/protocol/sealed-sender/index.js +2 -6
  107. package/dist/internal/protocol/sealed-sender/index.js.map +1 -1
  108. package/dist/internal/protocol/sealed-sender/proto/index.d.ts +0 -19
  109. package/dist/internal/protocol/sealed-sender/proto/index.d.ts.map +1 -1
  110. package/dist/internal/protocol/sealed-sender/proto/index.js +1 -48
  111. package/dist/internal/protocol/sealed-sender/proto/index.js.map +1 -1
  112. package/dist/internal/protocol/sender-keys/manager.d.ts +9 -13
  113. package/dist/internal/protocol/sender-keys/manager.d.ts.map +1 -1
  114. package/dist/internal/protocol/sender-keys/manager.js +90 -95
  115. package/dist/internal/protocol/sender-keys/manager.js.map +1 -1
  116. package/dist/internal/protocol/spqr/index.d.ts +1 -1
  117. package/dist/internal/protocol/spqr/index.d.ts.map +1 -1
  118. package/dist/internal/protocol/spqr/index.js +2 -2
  119. package/dist/internal/protocol/spqr/index.js.map +1 -1
  120. package/dist/internal/protocol/spqr/ml-kem-braid/incremental-kem.d.ts +0 -2
  121. package/dist/internal/protocol/spqr/ml-kem-braid/incremental-kem.d.ts.map +1 -1
  122. package/dist/internal/protocol/spqr/ml-kem-braid/incremental-kem.js +4 -12
  123. package/dist/internal/protocol/spqr/ml-kem-braid/incremental-kem.js.map +1 -1
  124. package/dist/internal/protocol/spqr/ml-kem-braid/rs/codec.d.ts.map +1 -1
  125. package/dist/internal/protocol/spqr/ml-kem-braid/rs/codec.js +1 -3
  126. package/dist/internal/protocol/spqr/ml-kem-braid/rs/codec.js.map +1 -1
  127. package/dist/internal/protocol/spqr/ml-kem-braid/types.d.ts +1 -0
  128. package/dist/internal/protocol/spqr/ml-kem-braid/types.d.ts.map +1 -1
  129. package/dist/internal/protocol/spqr/serialize.d.ts.map +1 -1
  130. package/dist/internal/protocol/spqr/serialize.js +1 -4
  131. package/dist/internal/protocol/spqr/serialize.js.map +1 -1
  132. package/dist/internal/protocol/spqr/spqr.d.ts +1 -1
  133. package/dist/internal/protocol/spqr/spqr.d.ts.map +1 -1
  134. package/dist/internal/protocol/spqr/spqr.js +2 -3
  135. package/dist/internal/protocol/spqr/spqr.js.map +1 -1
  136. package/dist/internal/protocol/x3dh/x3dh.d.ts.map +1 -1
  137. package/dist/internal/protocol/x3dh/x3dh.js +1 -1
  138. package/dist/internal/protocol/x3dh/x3dh.js.map +1 -1
  139. package/dist/internal/protocol/zk/credentials/credentials.d.ts +3 -54
  140. package/dist/internal/protocol/zk/credentials/credentials.d.ts.map +1 -1
  141. package/dist/internal/protocol/zk/credentials/credentials.js +4 -91
  142. package/dist/internal/protocol/zk/credentials/credentials.js.map +1 -1
  143. package/dist/internal/protocol/zk/credentials/endorsements.d.ts +3 -64
  144. package/dist/internal/protocol/zk/credentials/endorsements.d.ts.map +1 -1
  145. package/dist/internal/protocol/zk/credentials/endorsements.js +4 -134
  146. package/dist/internal/protocol/zk/credentials/endorsements.js.map +1 -1
  147. package/dist/internal/protocol/zk/credentials/index.d.ts +3 -3
  148. package/dist/internal/protocol/zk/credentials/index.d.ts.map +1 -1
  149. package/dist/internal/protocol/zk/credentials/index.js +3 -3
  150. package/dist/internal/protocol/zk/credentials/index.js.map +1 -1
  151. package/dist/internal/protocol/zk/credentials/issuance.d.ts +3 -26
  152. package/dist/internal/protocol/zk/credentials/issuance.d.ts.map +1 -1
  153. package/dist/internal/protocol/zk/credentials/issuance.js +3 -80
  154. package/dist/internal/protocol/zk/credentials/issuance.js.map +1 -1
  155. package/dist/internal/protocol/zk/credentials/presentation.d.ts +4 -73
  156. package/dist/internal/protocol/zk/credentials/presentation.d.ts.map +1 -1
  157. package/dist/internal/protocol/zk/credentials/presentation.js +4 -152
  158. package/dist/internal/protocol/zk/credentials/presentation.js.map +1 -1
  159. package/dist/internal/protocol/zk/groups/auth-credential.d.ts +1 -61
  160. package/dist/internal/protocol/zk/groups/auth-credential.d.ts.map +1 -1
  161. package/dist/internal/protocol/zk/groups/auth-credential.js +2 -196
  162. package/dist/internal/protocol/zk/groups/auth-credential.js.map +1 -1
  163. package/dist/internal/protocol/zk/groups/group-send-endorsement.d.ts +1 -86
  164. package/dist/internal/protocol/zk/groups/group-send-endorsement.d.ts.map +1 -1
  165. package/dist/internal/protocol/zk/groups/group-send-endorsement.js +1 -152
  166. package/dist/internal/protocol/zk/groups/group-send-endorsement.js.map +1 -1
  167. package/dist/internal/protocol/zk/groups/index.d.ts +4 -4
  168. package/dist/internal/protocol/zk/groups/index.d.ts.map +1 -1
  169. package/dist/internal/protocol/zk/groups/index.js +4 -4
  170. package/dist/internal/protocol/zk/groups/index.js.map +1 -1
  171. package/dist/internal/protocol/zk/groups/profile-key-credential.d.ts +2 -57
  172. package/dist/internal/protocol/zk/groups/profile-key-credential.d.ts.map +1 -1
  173. package/dist/internal/protocol/zk/groups/profile-key-credential.js +2 -174
  174. package/dist/internal/protocol/zk/groups/profile-key-credential.js.map +1 -1
  175. package/dist/internal/protocol/zk/groups/server-params.d.ts +8 -72
  176. package/dist/internal/protocol/zk/groups/server-params.d.ts.map +1 -1
  177. package/dist/internal/protocol/zk/groups/server-params.js +8 -108
  178. package/dist/internal/protocol/zk/groups/server-params.js.map +1 -1
  179. package/dist/internal/protocol/zk/proofs/sign.d.ts +1 -2
  180. package/dist/internal/protocol/zk/proofs/sign.d.ts.map +1 -1
  181. package/dist/internal/protocol/zk/proofs/sign.js +2 -11
  182. package/dist/internal/protocol/zk/proofs/sign.js.map +1 -1
  183. package/dist/internal/sesame/device-registry.d.ts +24 -4
  184. package/dist/internal/sesame/device-registry.d.ts.map +1 -1
  185. package/dist/internal/sesame/device-registry.js +55 -28
  186. package/dist/internal/sesame/device-registry.js.map +1 -1
  187. package/dist/internal/sesame/manager.d.ts +79 -11
  188. package/dist/internal/sesame/manager.d.ts.map +1 -1
  189. package/dist/internal/sesame/manager.js +381 -280
  190. package/dist/internal/sesame/manager.js.map +1 -1
  191. package/dist/internal/session/cipher.d.ts +0 -5
  192. package/dist/internal/session/cipher.d.ts.map +1 -1
  193. package/dist/internal/session/cipher.js +3 -9
  194. package/dist/internal/session/cipher.js.map +1 -1
  195. package/dist/internal/session/ratchet.d.ts.map +1 -1
  196. package/dist/internal/session/ratchet.js +0 -2
  197. package/dist/internal/session/ratchet.js.map +1 -1
  198. package/dist/internal/session/record-locks.d.ts +46 -0
  199. package/dist/internal/session/record-locks.d.ts.map +1 -0
  200. package/dist/internal/session/record-locks.js +72 -0
  201. package/dist/internal/session/record-locks.js.map +1 -0
  202. package/dist/local/store/expo/adapter.d.ts +8 -2
  203. package/dist/local/store/expo/adapter.d.ts.map +1 -1
  204. package/dist/local/store/expo/adapter.js +24 -3
  205. package/dist/local/store/expo/adapter.js.map +1 -1
  206. package/dist/local/store/expo/driver.d.ts +7 -0
  207. package/dist/local/store/expo/driver.d.ts.map +1 -1
  208. package/dist/local/store/expo/driver.js +16 -0
  209. package/dist/local/store/expo/driver.js.map +1 -1
  210. package/dist/local/store/key-value/adapter.d.ts +3 -3
  211. package/dist/local/store/key-value/adapter.d.ts.map +1 -1
  212. package/dist/local/store/key-value/adapter.js +91 -53
  213. package/dist/local/store/key-value/adapter.js.map +1 -1
  214. package/dist/local/store/key-value/backend-conformance.d.ts.map +1 -1
  215. package/dist/local/store/key-value/backend-conformance.js +25 -0
  216. package/dist/local/store/key-value/backend-conformance.js.map +1 -1
  217. package/dist/local/store/key-value/batch.d.ts +3 -1
  218. package/dist/local/store/key-value/batch.d.ts.map +1 -1
  219. package/dist/local/store/key-value/batch.js +9 -1
  220. package/dist/local/store/key-value/batch.js.map +1 -1
  221. package/dist/local/store/key-value/storage.d.ts +6 -0
  222. package/dist/local/store/key-value/storage.d.ts.map +1 -1
  223. package/dist/local/store/key-value/transactional-backend.d.ts +1 -1
  224. package/dist/local/store/key-value/transactional-backend.js +1 -1
  225. package/dist/local/store/memory/adapter.d.ts +13 -3
  226. package/dist/local/store/memory/adapter.d.ts.map +1 -1
  227. package/dist/local/store/memory/adapter.js +122 -73
  228. package/dist/local/store/memory/adapter.js.map +1 -1
  229. package/dist/local/store/reliability.d.ts +16 -0
  230. package/dist/local/store/reliability.d.ts.map +1 -1
  231. package/dist/local/store/reliability.js +58 -28
  232. package/dist/local/store/reliability.js.map +1 -1
  233. package/dist/local/store/sqlite/migrations.d.ts.map +1 -1
  234. package/dist/local/store/sqlite/migrations.js +18 -0
  235. package/dist/local/store/sqlite/migrations.js.map +1 -1
  236. package/dist/local/store/sqlite/models/skipped-sender-key.d.ts +3 -3
  237. package/dist/local/store/sqlite/models/skipped-sender-key.d.ts.map +1 -1
  238. package/dist/local/store/sqlite/models/skipped-sender-key.js +13 -17
  239. package/dist/local/store/sqlite/models/skipped-sender-key.js.map +1 -1
  240. package/dist/local/store/sqlite/store.d.ts +3 -3
  241. package/dist/local/store/sqlite/store.d.ts.map +1 -1
  242. package/dist/local/store/sqlite/store.js +53 -23
  243. package/dist/local/store/sqlite/store.js.map +1 -1
  244. package/dist/local/store/web/adapter.d.ts +3 -3
  245. package/dist/local/store/web/adapter.d.ts.map +1 -1
  246. package/dist/local/store/web/adapter.js +122 -73
  247. package/dist/local/store/web/adapter.js.map +1 -1
  248. package/dist/local/vault/electron-safe-storage.d.ts.map +1 -1
  249. package/dist/local/vault/electron-safe-storage.js +15 -2
  250. package/dist/local/vault/electron-safe-storage.js.map +1 -1
  251. package/dist/profile/index.d.ts +2 -1
  252. package/dist/profile/index.d.ts.map +1 -1
  253. package/dist/profile/index.js +2 -1
  254. package/dist/profile/index.js.map +1 -1
  255. package/dist/profile/own-profile-key.d.ts +42 -0
  256. package/dist/profile/own-profile-key.d.ts.map +1 -0
  257. package/dist/profile/own-profile-key.js +64 -0
  258. package/dist/profile/own-profile-key.js.map +1 -0
  259. package/dist/profile/profile-key.d.ts +1 -34
  260. package/dist/profile/profile-key.d.ts.map +1 -1
  261. package/dist/profile/profile-key.js +3 -63
  262. package/dist/profile/profile-key.js.map +1 -1
  263. package/dist/profile/update-service.js +1 -1
  264. package/dist/profile/update-service.js.map +1 -1
  265. package/dist/remote/relay/index.d.ts +4 -7
  266. package/dist/remote/relay/index.d.ts.map +1 -1
  267. package/dist/remote/relay/index.js +5 -7
  268. package/dist/remote/relay/index.js.map +1 -1
  269. package/dist/remote/relay/types.d.ts +3 -3
  270. package/dist/types/api.d.ts +29 -8
  271. package/dist/types/api.d.ts.map +1 -1
  272. package/dist/username/link.d.ts.map +1 -1
  273. package/dist/username/link.js +1 -5
  274. package/dist/username/link.js.map +1 -1
  275. package/dist/utils/bounded-fan-out.d.ts +99 -0
  276. package/dist/utils/bounded-fan-out.d.ts.map +1 -0
  277. package/dist/utils/bounded-fan-out.js +180 -0
  278. package/dist/utils/bounded-fan-out.js.map +1 -0
  279. package/dist/utils/keyed-lock.d.ts +16 -0
  280. package/dist/utils/keyed-lock.d.ts.map +1 -0
  281. package/dist/utils/keyed-lock.js +39 -0
  282. package/dist/utils/keyed-lock.js.map +1 -0
  283. package/dist/versions.d.ts +3 -3
  284. package/dist/versions.js +3 -3
  285. package/dist/zk/credentials.d.ts +2 -2
  286. package/dist/zk/credentials.js +2 -2
  287. package/dist/zk/groups.d.ts +3 -3
  288. package/dist/zk/groups.d.ts.map +1 -1
  289. package/dist/zk/groups.js +3 -3
  290. package/dist/zk/groups.js.map +1 -1
  291. package/docs/ASSURANCE.md +69 -28
  292. package/docs/CLIENT_COMPOSITION.md +9 -3
  293. package/docs/DEVIATIONS.md +45 -27
  294. package/docs/GETTING_STARTED.md +42 -320
  295. package/docs/INTERFACES.md +7 -7
  296. package/docs/PACKAGE_SURFACE.md +14 -16
  297. package/docs/RECIPES.md +6 -112
  298. package/groups/README.md +9 -1
  299. package/hooks/README.md +11 -2
  300. package/local/store/README.md +26 -6
  301. package/local/store/expo/README.md +18 -5
  302. package/local/store/key-value/README.md +5 -3
  303. package/local/store/node/README.md +2 -1
  304. package/local/store/web-sqlite/README.md +28 -8
  305. package/local/vault/README.md +21 -2
  306. package/package.json +1 -30
  307. package/remote/README.md +12 -78
  308. package/remote/object-store/convex-r2/README.md +20 -42
  309. package/remote/relay/README.md +21 -18
  310. package/zk/README.md +6 -7
  311. package/dist/client/dual-store.d.ts +0 -70
  312. package/dist/client/dual-store.d.ts.map +0 -1
  313. package/dist/client/dual-store.js +0 -123
  314. package/dist/client/dual-store.js.map +0 -1
  315. package/dist/client/multi-device.d.ts +0 -74
  316. package/dist/client/multi-device.d.ts.map +0 -1
  317. package/dist/client/multi-device.js +0 -105
  318. package/dist/client/multi-device.js.map +0 -1
  319. package/dist/groups/server.d.ts +0 -10
  320. package/dist/groups/server.d.ts.map +0 -1
  321. package/dist/groups/server.js +0 -6
  322. package/dist/groups/server.js.map +0 -1
  323. package/dist/internal/encoding/index.d.ts +0 -2
  324. package/dist/internal/encoding/index.d.ts.map +0 -1
  325. package/dist/internal/encoding/index.js +0 -2
  326. package/dist/internal/encoding/index.js.map +0 -1
  327. package/dist/internal/groups/server-engine.d.ts +0 -118
  328. package/dist/internal/groups/server-engine.d.ts.map +0 -1
  329. package/dist/internal/groups/server-engine.js +0 -1268
  330. package/dist/internal/groups/server-engine.js.map +0 -1
  331. package/dist/internal/protocol/index.d.ts +0 -24
  332. package/dist/internal/protocol/index.d.ts.map +0 -1
  333. package/dist/internal/protocol/index.js +0 -9
  334. package/dist/internal/protocol/index.js.map +0 -1
  335. package/dist/internal/protocol/sealed-sender/trust-root.d.ts +0 -56
  336. package/dist/internal/protocol/sealed-sender/trust-root.d.ts.map +0 -1
  337. package/dist/internal/protocol/sealed-sender/trust-root.js +0 -90
  338. package/dist/internal/protocol/sealed-sender/trust-root.js.map +0 -1
  339. package/dist/internal/protocol/triple-ratchet/index.d.ts +0 -21
  340. package/dist/internal/protocol/triple-ratchet/index.d.ts.map +0 -1
  341. package/dist/internal/protocol/triple-ratchet/index.js +0 -19
  342. package/dist/internal/protocol/triple-ratchet/index.js.map +0 -1
  343. package/dist/internal/protocol/triple-ratchet/ratchet.d.ts +0 -233
  344. package/dist/internal/protocol/triple-ratchet/ratchet.d.ts.map +0 -1
  345. package/dist/internal/protocol/triple-ratchet/ratchet.js +0 -254
  346. package/dist/internal/protocol/triple-ratchet/ratchet.js.map +0 -1
  347. package/dist/internal/protocol/zk/proofs/index.d.ts +0 -13
  348. package/dist/internal/protocol/zk/proofs/index.d.ts.map +0 -1
  349. package/dist/internal/protocol/zk/proofs/index.js +0 -7
  350. package/dist/internal/protocol/zk/proofs/index.js.map +0 -1
  351. package/dist/local/store/sqlite/index.d.ts +0 -20
  352. package/dist/local/store/sqlite/index.d.ts.map +0 -1
  353. package/dist/local/store/sqlite/index.js +0 -18
  354. package/dist/local/store/sqlite/index.js.map +0 -1
  355. package/dist/remote/object-store/convex-r2/server/index.d.ts +0 -2
  356. package/dist/remote/object-store/convex-r2/server/index.d.ts.map +0 -1
  357. package/dist/remote/object-store/convex-r2/server/index.js +0 -2
  358. package/dist/remote/object-store/convex-r2/server/index.js.map +0 -1
  359. package/dist/remote/object-store/convex-r2/server.d.ts +0 -129
  360. package/dist/remote/object-store/convex-r2/server.d.ts.map +0 -1
  361. package/dist/remote/object-store/convex-r2/server.js +0 -244
  362. package/dist/remote/object-store/convex-r2/server.js.map +0 -1
  363. package/dist/remote/relay/memory/adapter.d.ts +0 -252
  364. package/dist/remote/relay/memory/adapter.d.ts.map +0 -1
  365. package/dist/remote/relay/memory/adapter.js +0 -1058
  366. package/dist/remote/relay/memory/adapter.js.map +0 -1
  367. package/dist/remote/relay/memory/failures.d.ts +0 -58
  368. package/dist/remote/relay/memory/failures.d.ts.map +0 -1
  369. package/dist/remote/relay/memory/failures.js +0 -124
  370. package/dist/remote/relay/memory/failures.js.map +0 -1
  371. package/dist/remote/relay/memory/group-server.d.ts +0 -13
  372. package/dist/remote/relay/memory/group-server.d.ts.map +0 -1
  373. package/dist/remote/relay/memory/group-server.js +0 -19
  374. package/dist/remote/relay/memory/group-server.js.map +0 -1
  375. package/dist/remote/relay/memory/index.d.ts +0 -11
  376. package/dist/remote/relay/memory/index.d.ts.map +0 -1
  377. package/dist/remote/relay/memory/index.js +0 -7
  378. package/dist/remote/relay/memory/index.js.map +0 -1
  379. package/examples/browser/README.md +0 -35
  380. package/examples/browser/index.html +0 -27
  381. package/examples/browser/src/exchange.ts +0 -69
  382. package/examples/browser/src/main.ts +0 -63
  383. package/examples/browser/src/style.css +0 -9
  384. package/examples/browser/src/worker.ts +0 -10
  385. package/examples/browser/vite.config.ts +0 -9
  386. package/remote/relay/memory/README.md +0 -72
  387. package/scripts/oe-groups.mjs +0 -166
@@ -1,1058 +0,0 @@
1
- /**
2
- * In-Memory Signal Protocol Relay Server
3
- *
4
- * Implementation of SignalProtocolRelayServer for local development.
5
- * Simulates a backend server without any network calls.
6
- *
7
- * WARNING: All data is lost when the adapter is destroyed.
8
- * DO NOT use in production.
9
- */
10
- import { utf8Decode } from '../../../internal/platform/index.js';
11
- import { RelayConnectionStateOwner } from '../connection-state.js';
12
- import { compositeIdentitiesEqual, decodeCompositeIdentityV1, deriveIdentityCommitment, encodeCompositeIdentityV1, } from '../../../keys/identity.js';
13
- import { generateRandomBytes, generateUuidV4 } from '../../../internal/crypto/random.js';
14
- import { cloneProtocolState, constantTimeEqual } from '../../../internal/crypto/utils.js';
15
- import { PROVISIONING_SESSION_TTL_MS } from '../../../device/constants.js';
16
- import { generateServerSecretParams, } from '../../../internal/protocol/zk/groups/server-params.js';
17
- import { issueAuthCredential as issueAuthCredentialZk, serializeAuthCredentialResponse, } from '../../../internal/protocol/zk/groups/auth-credential.js';
18
- import { deserializeProfileKeyCredentialRequest, issueProfileKeyCredential as issueProfileKeyCredentialZk, serializeProfileKeyCredentialResponse, } from '../../../internal/protocol/zk/groups/profile-key-credential.js';
19
- import { SERVICE_ID_ACI, SERVICE_ID_PNI, uuidToBytes, } from '../../../internal/protocol/zk/groups/uid-struct.js';
20
- import { SECONDS_PER_DAY } from '../../../internal/protocol/zk/groups/group-params.js';
21
- import { defaultExpiration, deriveForExpiration, issueEndorsements, serializeEndorsementsResponse, } from '../../../internal/protocol/zk/groups/group-send-endorsement.js';
22
- import { UidEncryptionDomain } from '../../../internal/protocol/zk/groups/uid-encryption.js';
23
- import { Ciphertext } from '../../../internal/protocol/zk/credentials/attributes.js';
24
- import { ristretto255 } from '@noble/curves/ed25519.js';
25
- import { MAX_DEVICES } from '../../../device/constants.js';
26
- import { SealedSenderAuthError } from '../../../types/errors.js';
27
- import { RelayFailureController } from './failures.js';
28
- import { InMemoryGroupAuthorizationServer } from './group-server.js';
29
- /**
30
- * Simulate the serialization boundary of a real relay.
31
- *
32
- * Values entering or leaving the in-memory server must never share mutable
33
- * references with caller-owned objects.
34
- */
35
- function cloneRelayValue(value) {
36
- return cloneProtocolState(value);
37
- }
38
- /**
39
- * Reject an expired provisioning session. Throw-only, mirroring the Convex
40
- * component: expiry is never stored, only computed. Sessions that lapse are
41
- * rejected here and reported as `expired` by `getProvisioningMessage`.
42
- */
43
- function requireLiveProvisioningSession(session, sessionId) {
44
- if (session.expiresAt <= Date.now()) {
45
- throw new Error(`Provisioning session ${sessionId} expired`);
46
- }
47
- }
48
- export class InMemorySignalProtocolRelayServer {
49
- failures;
50
- // Device registry
51
- devices = new Map(); // key: userId
52
- // Identity keys per account (ACI/PNI), shared across all devices
53
- identityKeys = new Map(); // key: `${userId}:${identityType}`
54
- // Registration IDs remain per-device even though identity keys are account-level
55
- registrationIds = new Map(); // key: `${userId}:${deviceId}:${identityType}`
56
- // Prekeys per device
57
- ecPreKeys = new Map(); // key: `${userId}:${deviceId}:${identityType}`
58
- consumedEcPreKeyIds = new Map(); // key: `${userId}:${deviceId}:${identityType}`
59
- ecSignedPreKeys = new Map(); // key: `${userId}:${deviceId}:${identityType}`
60
- kemOneTimePreKeys = new Map(); // key: `${userId}:${deviceId}:${identityType}`
61
- consumedKemOneTimePreKeyIds = new Map(); // key: `${userId}:${deviceId}:${identityType}`
62
- kemLastResortPreKeys = new Map(); // key: `${userId}:${deviceId}:${identityType}`
63
- // Messages/envelopes
64
- pendingMessages = new Map(); // key: `${userId}:${deviceId}`
65
- clientMessageReceipts = new Map(); // key: `${userId}:${deviceId}:${senderUserId}:${clientMessageId}`
66
- // Subscriptions
67
- subscriptions = new Map();
68
- liveSubscriptions = new Set();
69
- connectionState = new RelayConnectionStateOwner();
70
- // Provisioning sessions
71
- provisioningSessions = new Map();
72
- provisioningCounter = 0;
73
- // Key metadata (for key rotation checks and server key verification)
74
- ecSignedPreKeyMetadata = new Map(); // key: `${userId}:${deviceId}:${identityType}`
75
- kemLastResortPreKeyMetadata = new Map(); // key: `${userId}:${deviceId}:${identityType}`
76
- // Retry requests (SESAME spec §6.2)
77
- retryRequests = new Map(); // key: `${originalSenderUserId}:${originalSenderDeviceId}`
78
- retryRequestSubscriptions = new Map();
79
- // Server secret params for signing and ZK auth (deterministic local seed)
80
- serverSecretParams = generateServerSecretParams(new Uint8Array(32));
81
- groupAuthorizationServer = new InMemoryGroupAuthorizationServer(this.serverSecretParams);
82
- unidentifiedAccessKeys = new Map();
83
- groupServer;
84
- constructor(options = {}) {
85
- this.failures = new RelayFailureController(options.failures, (targetKey, envelope) => this.deliverEnvelope(targetKey, envelope), (targetKey) => this.deliverPending(targetKey));
86
- this.groupServer = {
87
- server: this.groupAuthorizationServer,
88
- issueAuthCredential: (userId) => this.issueAuthCredential(userId),
89
- setUnidentifiedAccessKey: (userId, accessKey) => this.setUnidentifiedAccessKey(userId, accessKey),
90
- issueProfileKeyCredential: (userId, request) => this.issueProfileKeyCredential(userId, request),
91
- };
92
- }
93
- /** Build a storage key with explicit identity-type separation. */
94
- storageKey(userId, deviceId, identityType = 'aci') {
95
- return `${userId}:${deviceId}:${identityType}`;
96
- }
97
- /** Identity key storage is account-scoped, not device-scoped. */
98
- identityStorageKey(userId, identityType = 'aci') {
99
- return `${userId}:${identityType}`;
100
- }
101
- /** Remove every device-scoped prekey bound to one retired account identity. */
102
- clearIdentityPreKeys(userId, identityType) {
103
- const prefix = `${userId}:`;
104
- const suffix = `:${identityType}`;
105
- const stores = [
106
- this.ecSignedPreKeys,
107
- this.kemLastResortPreKeys,
108
- this.ecPreKeys,
109
- this.consumedEcPreKeyIds,
110
- this.kemOneTimePreKeys,
111
- this.consumedKemOneTimePreKeyIds,
112
- this.ecSignedPreKeyMetadata,
113
- this.kemLastResortPreKeyMetadata,
114
- ];
115
- // The prekey tables are authoritative. Device registration is a separate
116
- // service and may be incomplete or temporarily unavailable during reset.
117
- for (const store of stores) {
118
- for (const key of store.keys()) {
119
- if (key.startsWith(prefix) && key.endsWith(suffix)) {
120
- store.delete(key);
121
- }
122
- }
123
- }
124
- }
125
- // ============================================================================
126
- // Envelope Delivery
127
- // ============================================================================
128
- async send(envelope) {
129
- await this.failures.waitForLatency();
130
- const id = await generateUuidV4();
131
- const targetKey = `${envelope.targetUserId}:${envelope.targetDeviceId}`;
132
- // Sender-scoped like the Convex backend's dedup index: a
133
- // clientMessageId collapses retries from the same sender only, never
134
- // two senders that happen to reuse a value.
135
- const receiptKey = envelope.clientMessageId
136
- ? `${targetKey}:${envelope.senderUserId ?? ''}:${envelope.clientMessageId}`
137
- : null;
138
- if (receiptKey) {
139
- const existing = this.clientMessageReceipts.get(receiptKey);
140
- if (existing) {
141
- return cloneRelayValue(existing);
142
- }
143
- }
144
- const serverTimestamp = Date.now();
145
- const storedEnvelope = {
146
- ...cloneRelayValue(envelope),
147
- id,
148
- serverTimestamp,
149
- };
150
- // Ephemeral work is a live hint. It never enters the offline mailbox or
151
- // the durable retry receipt map. Missing or disconnected recipients lose
152
- // it by design.
153
- if (envelope.deliveryClass === 'ephemeral') {
154
- if ((this.subscriptions.get(targetKey)?.length ?? 0) > 0) {
155
- this.failures.deliver(targetKey, storedEnvelope);
156
- }
157
- return cloneRelayValue({ messageId: id, serverTimestamp });
158
- }
159
- // Store in pending messages
160
- const pending = this.pendingMessages.get(targetKey) || [];
161
- pending.push(storedEnvelope);
162
- this.pendingMessages.set(targetKey, pending);
163
- // Notify live subscribers through the deterministic failure controller.
164
- // With no subscriber, the pending mailbox alone owns the envelope.
165
- if ((this.subscriptions.get(targetKey)?.length ?? 0) > 0) {
166
- this.failures.deliver(targetKey, storedEnvelope);
167
- }
168
- if (receiptKey) {
169
- this.clientMessageReceipts.set(receiptKey, {
170
- messageId: id,
171
- serverTimestamp,
172
- });
173
- }
174
- return cloneRelayValue({ messageId: id, serverTimestamp });
175
- }
176
- subscribe(userId, deviceId, onEnvelope) {
177
- const key = `${userId}:${deviceId}`;
178
- const subscribers = this.subscriptions.get(key) || [];
179
- const isFirstSubscriber = subscribers.length === 0;
180
- subscribers.push(onEnvelope);
181
- this.subscriptions.set(key, subscribers);
182
- const live = {};
183
- this.liveSubscriptions.add(live);
184
- this.connectionState.move('connected');
185
- // Deliver any pending messages only to the newly added subscriber.
186
- if (!this.failures.isDisconnected(key)) {
187
- if (isFirstSubscriber) {
188
- this.failures.discardReordered(key);
189
- }
190
- const pending = this.pendingMessages.get(key) || [];
191
- for (const envelope of pending) {
192
- if (this.failures.isReorderBuffered(key, envelope.id))
193
- continue;
194
- onEnvelope(cloneRelayValue(envelope));
195
- }
196
- }
197
- return () => {
198
- const subs = this.subscriptions.get(key) || [];
199
- const idx = subs.indexOf(onEnvelope);
200
- if (idx >= 0) {
201
- subs.splice(idx, 1);
202
- }
203
- this.liveSubscriptions.delete(live);
204
- if (this.liveSubscriptions.size === 0)
205
- this.connectionState.move('stopped');
206
- };
207
- }
208
- /**
209
- * `connected` while any envelope subscription on this server is live, and
210
- * `stopped` otherwise. Every client that shares this server reads the same
211
- * value. The in-memory relay has no connection to lose, so it never reads
212
- * `connecting` or `reconnecting`.
213
- */
214
- get relayConnectionState() {
215
- return this.connectionState.current;
216
- }
217
- subscribeRelayConnectionState(listener) {
218
- return this.connectionState.subscribe(listener);
219
- }
220
- async markDelivered(envelopeId) {
221
- // Remove from all pending message queues
222
- for (const [key, messages] of this.pendingMessages.entries()) {
223
- const idx = messages.findIndex((m) => m.id === envelopeId);
224
- if (idx >= 0) {
225
- messages.splice(idx, 1);
226
- if (messages.length === 0) {
227
- this.pendingMessages.delete(key);
228
- }
229
- break;
230
- }
231
- }
232
- }
233
- // ============================================================================
234
- // Device Registry
235
- // ============================================================================
236
- async getDevices(userId) {
237
- return cloneRelayValue(this.devices.get(userId) || []);
238
- }
239
- async registerDevice(userId, device) {
240
- const existing = this.devices.get(userId) || [];
241
- const occupiedIds = new Set(existing.filter((candidate) => candidate.registered).map((candidate) => candidate.deviceId));
242
- const requestedDeviceId = device.deviceId;
243
- if (requestedDeviceId !== undefined &&
244
- (!Number.isInteger(requestedDeviceId) ||
245
- requestedDeviceId < 1 ||
246
- requestedDeviceId > MAX_DEVICES)) {
247
- throw new Error(`Device ID must be between 1 and ${MAX_DEVICES}`);
248
- }
249
- const deviceId = requestedDeviceId ??
250
- Array.from({ length: MAX_DEVICES }, (_, index) => index + 1).find((candidate) => !occupiedIds.has(candidate));
251
- if (deviceId === undefined || occupiedIds.has(deviceId)) {
252
- throw new Error('Maximum devices limit reached');
253
- }
254
- const isPrimary = deviceId === 1;
255
- const now = Date.now();
256
- const deviceInfo = {
257
- deviceId,
258
- encryptedDeviceName: device.encryptedDeviceName
259
- ? cloneRelayValue(device.encryptedDeviceName)
260
- : undefined,
261
- deviceType: device.deviceType,
262
- registered: true, // Setup complete
263
- linked: isPrimary ? false : true, // Primary is never "linked", secondary is linked
264
- enabled: true, // Can receive messages
265
- createdAt: now,
266
- linkedAt: isPrimary ? undefined : now,
267
- };
268
- const reusableIndex = existing.findIndex((candidate) => candidate.deviceId === deviceId);
269
- if (reusableIndex >= 0) {
270
- existing[reusableIndex] = deviceInfo;
271
- }
272
- else {
273
- existing.push(deviceInfo);
274
- }
275
- this.devices.set(userId, existing);
276
- return deviceId;
277
- }
278
- async removeDevice(userId, deviceId) {
279
- const devices = this.devices.get(userId) || [];
280
- const device = devices.find((d) => d.deviceId === deviceId);
281
- if (device) {
282
- // Soft delete: mark as unregistered
283
- device.registered = false;
284
- device.linked = false;
285
- device.enabled = false;
286
- }
287
- // Clean up device-scoped keys for both identity types
288
- for (const idType of ['aci', 'pni']) {
289
- const deviceKey = this.storageKey(userId, deviceId, idType);
290
- this.registrationIds.delete(deviceKey);
291
- this.ecPreKeys.delete(deviceKey);
292
- this.consumedEcPreKeyIds.delete(deviceKey);
293
- this.ecSignedPreKeys.delete(deviceKey);
294
- this.kemOneTimePreKeys.delete(deviceKey);
295
- this.consumedKemOneTimePreKeyIds.delete(deviceKey);
296
- this.kemLastResortPreKeys.delete(deviceKey);
297
- this.ecSignedPreKeyMetadata.delete(deviceKey);
298
- this.kemLastResortPreKeyMetadata.delete(deviceKey);
299
- }
300
- this.pendingMessages.delete(`${userId}:${deviceId}`);
301
- }
302
- // Note: updatePushToken removed - push tokens are managed by convex/signal/push.ts
303
- // ============================================================================
304
- // Identity Keys
305
- // ============================================================================
306
- async provisionIdentityKey(request) {
307
- const { userId, deviceId, identity, registrationId, identityType = 'aci' } = request;
308
- const accountKey = this.identityStorageKey(userId, identityType);
309
- const deviceKey = this.storageKey(userId, deviceId, identityType);
310
- const encodedCurrent = this.identityKeys.get(accountKey);
311
- if (encodedCurrent) {
312
- const current = decodeCompositeIdentityV1(encodedCurrent);
313
- if (!compositeIdentitiesEqual(current, identity)) {
314
- throw new Error('Account identity already exists with a different composite tuple; explicit rotation required');
315
- }
316
- }
317
- const encodedIdentity = encodeCompositeIdentityV1(identity);
318
- this.identityKeys.set(accountKey, encodedIdentity);
319
- this.registrationIds.set(deviceKey, registrationId);
320
- }
321
- async rotateIdentityKey(request) {
322
- const { userId, deviceId, identity, registrationId, identityType = 'aci', expectedCurrentCommitment, } = request;
323
- const accountKey = this.identityStorageKey(userId, identityType);
324
- const encodedCurrent = this.identityKeys.get(accountKey);
325
- if (!encodedCurrent) {
326
- throw new Error('Cannot rotate an account identity that has not been provisioned');
327
- }
328
- const current = decodeCompositeIdentityV1(encodedCurrent);
329
- if (!constantTimeEqual(deriveIdentityCommitment(current), expectedCurrentCommitment)) {
330
- throw new Error('Account identity rotation compare-and-swap failed');
331
- }
332
- if (compositeIdentitiesEqual(current, identity)) {
333
- throw new Error('Account identity rotation requires a different composite tuple');
334
- }
335
- const encodedIdentity = encodeCompositeIdentityV1(identity);
336
- const deviceKey = this.storageKey(userId, deviceId, identityType);
337
- // Commit only after every precondition and input has been validated.
338
- this.identityKeys.set(accountKey, encodedIdentity);
339
- this.registrationIds.set(deviceKey, registrationId);
340
- // Every device's prekeys are bound to the retired account identity.
341
- this.clearIdentityPreKeys(userId, identityType);
342
- }
343
- async getIdentityKey(userId, identityType) {
344
- const key = this.identityStorageKey(userId, identityType);
345
- const encoded = this.identityKeys.get(key);
346
- return encoded ? cloneRelayValue(decodeCompositeIdentityV1(encoded)) : null;
347
- }
348
- // ============================================================================
349
- // Prekey Management
350
- // ============================================================================
351
- async uploadPreKeys(userId, deviceId, keys, identityType) {
352
- const key = this.storageKey(userId, deviceId, identityType);
353
- const now = Date.now();
354
- const THIRTY_DAYS_MS = 30 * 24 * 60 * 60 * 1000;
355
- for (const preKey of keys) {
356
- switch (preKey.type) {
357
- case 'ecPreKey': {
358
- if (this.failures.shouldExhaustOneTimePreKeys())
359
- break;
360
- if (this.consumedEcPreKeyIds.get(key)?.has(preKey.keyId))
361
- break;
362
- const existing = this.ecPreKeys.get(key) || [];
363
- const stored = cloneRelayValue(preKey);
364
- const index = existing.findIndex((candidate) => candidate.keyId === stored.keyId);
365
- if (index >= 0)
366
- existing[index] = stored;
367
- else
368
- existing.push(stored);
369
- this.ecPreKeys.set(key, existing);
370
- break;
371
- }
372
- case 'ecSignedPreKey': {
373
- this.ecSignedPreKeys.set(key, cloneRelayValue(preKey));
374
- // Auto-populate metadata for server key verification
375
- this.ecSignedPreKeyMetadata.set(key, {
376
- keyId: preKey.keyId,
377
- createdAt: now,
378
- expiresAt: now + THIRTY_DAYS_MS,
379
- publicKey: preKey.publicKey,
380
- });
381
- break;
382
- }
383
- case 'kemOneTimePreKey': {
384
- if (this.failures.shouldExhaustOneTimePreKeys())
385
- break;
386
- if (this.consumedKemOneTimePreKeyIds.get(key)?.has(preKey.keyId))
387
- break;
388
- const existing = this.kemOneTimePreKeys.get(key) || [];
389
- const stored = cloneRelayValue(preKey);
390
- const index = existing.findIndex((candidate) => candidate.keyId === stored.keyId);
391
- if (index >= 0)
392
- existing[index] = stored;
393
- else
394
- existing.push(stored);
395
- this.kemOneTimePreKeys.set(key, existing);
396
- break;
397
- }
398
- case 'kemLastResortPreKey': {
399
- this.kemLastResortPreKeys.set(key, cloneRelayValue(preKey));
400
- // Auto-populate metadata for server key verification
401
- this.kemLastResortPreKeyMetadata.set(key, {
402
- keyId: preKey.keyId,
403
- createdAt: now,
404
- expiresAt: now + THIRTY_DAYS_MS,
405
- publicKey: preKey.publicKey,
406
- });
407
- break;
408
- }
409
- }
410
- }
411
- }
412
- async fetchPreKeyBundle(userId, deviceId, _fetcherUserId, identityType) {
413
- const deviceKey = this.storageKey(userId, deviceId, identityType);
414
- const accountKey = this.identityStorageKey(userId, identityType);
415
- // Identity keys are account-level. Registration IDs are device-level.
416
- const encodedIdentity = this.identityKeys.get(accountKey);
417
- const registrationId = this.registrationIds.get(deviceKey);
418
- if (!encodedIdentity || registrationId === undefined) {
419
- return null;
420
- }
421
- // Get signed prekey (required)
422
- const ecSignedPreKey = this.ecSignedPreKeys.get(deviceKey);
423
- if (!ecSignedPreKey) {
424
- return null;
425
- }
426
- // Get and consume one-time prekey (optional)
427
- const ecPreKeys = this.ecPreKeys.get(deviceKey) || [];
428
- const exhaustOneTimePreKeys = this.failures.shouldExhaustOneTimePreKeys();
429
- if (exhaustOneTimePreKeys) {
430
- this.recordConsumedPreKeyIds(this.consumedEcPreKeyIds, deviceKey, ecPreKeys);
431
- this.recordConsumedPreKeyIds(this.consumedKemOneTimePreKeyIds, deviceKey, this.kemOneTimePreKeys.get(deviceKey) || []);
432
- this.ecPreKeys.delete(deviceKey);
433
- this.kemOneTimePreKeys.delete(deviceKey);
434
- }
435
- const ecOneTimePreKey = !exhaustOneTimePreKeys && ecPreKeys.length > 0 ? ecPreKeys.shift() : null;
436
- if (ecOneTimePreKey) {
437
- this.recordConsumedPreKeyIds(this.consumedEcPreKeyIds, deviceKey, [ecOneTimePreKey]);
438
- }
439
- if (ecPreKeys.length === 0) {
440
- this.ecPreKeys.delete(deviceKey);
441
- }
442
- // Get KEM one-time prekey (consumed like EC one-time prekeys)
443
- // Per PQXDH spec Section 3.2: one-time KEM prekeys provide per-session PQ forward secrecy
444
- const kemOneTimePreKeys = this.kemOneTimePreKeys.get(deviceKey) || [];
445
- const kemOneTimePreKey = !exhaustOneTimePreKeys && kemOneTimePreKeys.length > 0 ? kemOneTimePreKeys.shift() : null;
446
- if (kemOneTimePreKey) {
447
- this.recordConsumedPreKeyIds(this.consumedKemOneTimePreKeyIds, deviceKey, [kemOneTimePreKey]);
448
- }
449
- if (kemOneTimePreKeys.length === 0) {
450
- this.kemOneTimePreKeys.delete(deviceKey);
451
- }
452
- // Get last-resort Kyber prekey (always returned if available)
453
- // This is SEPARATE from the one-time KEM prekeys
454
- const kemLastResortPreKey = this.kemLastResortPreKeys.get(deviceKey) || null;
455
- // Cast to branded types - SignalProtocolRelayServer returns PreKeyBundle with branded types
456
- // Adapters handle the casting internally so callers do not need to
457
- return cloneRelayValue({
458
- registrationId,
459
- deviceId,
460
- identity: decodeCompositeIdentityV1(encodedIdentity),
461
- ecSignedPreKey: {
462
- keyId: ecSignedPreKey.keyId,
463
- publicKey: ecSignedPreKey.publicKey,
464
- signature: ecSignedPreKey.signature,
465
- },
466
- ecOneTimePreKey: ecOneTimePreKey
467
- ? {
468
- keyId: ecOneTimePreKey.keyId,
469
- publicKey: ecOneTimePreKey.publicKey,
470
- }
471
- : null,
472
- kemLastResortPreKey: kemLastResortPreKey
473
- ? {
474
- keyId: kemLastResortPreKey.keyId,
475
- publicKey: kemLastResortPreKey.publicKey,
476
- signature: kemLastResortPreKey.signature,
477
- }
478
- : null,
479
- kemOneTimePreKey: kemOneTimePreKey
480
- ? {
481
- keyId: kemOneTimePreKey.keyId,
482
- publicKey: kemOneTimePreKey.publicKey,
483
- signature: kemOneTimePreKey.signature,
484
- }
485
- : null,
486
- });
487
- }
488
- async getPreKeyInventory(userId, deviceId, identityType) {
489
- const key = this.storageKey(userId, deviceId, identityType);
490
- // Copy all values without yielding to a concurrent mutation.
491
- return cloneRelayValue({
492
- ecSignedPreKey: this.ecSignedPreKeyMetadata.get(key) ?? null,
493
- kemLastResortPreKey: this.kemLastResortPreKeyMetadata.get(key) ?? null,
494
- ecOneTimePreKeyCount: this.ecPreKeys.get(key)?.length ?? 0,
495
- kemOneTimePreKeyCount: this.kemOneTimePreKeys.get(key)?.length ?? 0,
496
- });
497
- }
498
- async getPreKeyCount(userId, deviceId, type, identityType) {
499
- const key = this.storageKey(userId, deviceId, identityType);
500
- if (type === 'ec') {
501
- return (this.ecPreKeys.get(key) || []).length;
502
- }
503
- else {
504
- return (this.kemOneTimePreKeys.get(key) || []).length;
505
- }
506
- }
507
- async clearStaleKemPreKeys(userId, deviceId, identityType) {
508
- const key = this.storageKey(userId, deviceId, identityType);
509
- const kemKeys = this.kemOneTimePreKeys.get(key) || [];
510
- const clearedCount = kemKeys.length;
511
- this.kemOneTimePreKeys.set(key, []);
512
- return { cleared: clearedCount };
513
- }
514
- async publishPlannedPreKeys(userId, deviceId, plan, identityType) {
515
- const uploads = await plan(await this.getPreKeyInventory(userId, deviceId, identityType));
516
- if (uploads.length === 0)
517
- return;
518
- await this.uploadPreKeys(userId, deviceId, [...uploads], identityType);
519
- }
520
- async getActiveDevices(userId) {
521
- const deviceInfos = this.devices.get(userId) || [];
522
- return deviceInfos
523
- .filter((device) => device.registered && device.enabled)
524
- .map((device) => ({ userId, deviceId: device.deviceId }));
525
- }
526
- // ============================================================================
527
- // Provisioning Service (ProvisioningService)
528
- // ============================================================================
529
- async createProvisioningSession(userId, ephemeralPublicKey) {
530
- const sessionId = `prov-${++this.provisioningCounter}`;
531
- const now = Date.now();
532
- const reservedDeviceIds = new Set();
533
- for (const device of this.devices.get(userId) || []) {
534
- if (device.deviceId !== 1 && device.registered && device.linked) {
535
- reservedDeviceIds.add(device.deviceId);
536
- }
537
- }
538
- for (const session of this.provisioningSessions.values()) {
539
- const sessionExpired = session.expiresAt <= now;
540
- if (session.userId === userId &&
541
- session.assignedDeviceId &&
542
- !sessionExpired &&
543
- session.status !== 'completed' &&
544
- session.status !== 'rolled_back' &&
545
- session.status !== 'expired') {
546
- reservedDeviceIds.add(session.assignedDeviceId);
547
- }
548
- }
549
- const assignedDeviceId = [2, 3, 4, 5].find((deviceId) => !reservedDeviceIds.has(deviceId));
550
- if (!assignedDeviceId) {
551
- throw new Error(`No linked device slots available for ${userId}`);
552
- }
553
- this.provisioningSessions.set(sessionId, {
554
- userId,
555
- ephemeralPublicKey,
556
- status: 'waiting',
557
- expiresAt: now + PROVISIONING_SESSION_TTL_MS,
558
- assignedDeviceId,
559
- });
560
- return { sessionId };
561
- }
562
- async connectNewDevice(sessionId, ephemeralPublicKey, deviceMetadata) {
563
- const session = this.provisioningSessions.get(sessionId);
564
- if (!session) {
565
- throw new Error(`Provisioning session ${sessionId} not found`);
566
- }
567
- if (session.status !== 'waiting') {
568
- throw new Error(`Provisioning session ${sessionId} is not in waiting state`);
569
- }
570
- requireLiveProvisioningSession(session, sessionId);
571
- session.newDeviceEphemeralPublicKey = ephemeralPublicKey;
572
- session.deviceMetadata = cloneRelayValue(deviceMetadata);
573
- session.status = 'connected';
574
- }
575
- async sendProvisioningMessage(sessionId, encryptedMessage, _userId) {
576
- const session = this.provisioningSessions.get(sessionId);
577
- if (!session) {
578
- throw new Error(`Provisioning session ${sessionId} not found`);
579
- }
580
- requireLiveProvisioningSession(session, sessionId);
581
- if (session.status !== 'connected') {
582
- throw new Error(`Provisioning session ${sessionId} is not in connected state`);
583
- }
584
- session.encryptedMessage = encryptedMessage;
585
- session.status = 'ready';
586
- }
587
- async getProvisioningMessage(sessionId) {
588
- const session = this.provisioningSessions.get(sessionId);
589
- if (!session) {
590
- return { status: 'expired', message: null, expiresAt: null };
591
- }
592
- // Expiry is a computed status, never a stored one. Reads do not mutate.
593
- // Mirrors the Convex component, where a `patch` before a throw would be
594
- // rolled back anyway and the cleanup cron deletes expired rows outright.
595
- if (session.status !== 'completed' &&
596
- session.status !== 'rolled_back' &&
597
- session.expiresAt <= Date.now()) {
598
- return { status: 'expired', message: null, expiresAt: session.expiresAt };
599
- }
600
- return {
601
- status: session.status,
602
- message: session.status === 'ready' || session.status === 'linked_pending_ack'
603
- ? session.encryptedMessage || null
604
- : null,
605
- expiresAt: session.expiresAt,
606
- };
607
- }
608
- async completeProvisioning(sessionId, deviceMetadata) {
609
- const session = this.provisioningSessions.get(sessionId);
610
- if (!session) {
611
- throw new Error(`Provisioning session ${sessionId} not found`);
612
- }
613
- // Reject completion of an expired session. Including one already in
614
- // `linked_pending_ack`, whose device the cleanup cron is entitled to reap.
615
- requireLiveProvisioningSession(session, sessionId);
616
- if (session.status !== 'ready' && session.status !== 'linked_pending_ack') {
617
- throw new Error(`Provisioning session ${sessionId} is not ready`);
618
- }
619
- if (!session.assignedDeviceId) {
620
- throw new Error(`Provisioning session ${sessionId} has no assigned device ID`);
621
- }
622
- if (session.status === 'linked_pending_ack') {
623
- return { deviceId: session.assignedDeviceId };
624
- }
625
- const existingDevices = this.devices.get(session.userId) ?? [];
626
- const now = Date.now();
627
- const activeExistingDevice = existingDevices.find((device) => device.deviceId === session.assignedDeviceId && device.registered && device.linked);
628
- if (activeExistingDevice) {
629
- throw new Error(`Provisioning session ${sessionId} has no available linked device slot`);
630
- }
631
- const reusableDevice = existingDevices.find((device) => device.deviceId === session.assignedDeviceId);
632
- const nextState = {
633
- deviceId: session.assignedDeviceId,
634
- encryptedDeviceName: cloneRelayValue(deviceMetadata.encryptedDeviceName),
635
- deviceType: 'mobile',
636
- registered: true,
637
- linked: true,
638
- enabled: true,
639
- createdAt: now,
640
- linkedAt: now,
641
- };
642
- if (reusableDevice) {
643
- Object.assign(reusableDevice, nextState);
644
- }
645
- else {
646
- existingDevices.push(nextState);
647
- }
648
- this.devices.set(session.userId, existingDevices);
649
- session.status = 'linked_pending_ack';
650
- // Grant the acknowledgment its own full TTL window rather than whatever
651
- // remains of the original session.
652
- session.expiresAt = now + PROVISIONING_SESSION_TTL_MS;
653
- return { deviceId: session.assignedDeviceId };
654
- }
655
- async acknowledgeProvisioning(sessionId) {
656
- const session = this.provisioningSessions.get(sessionId);
657
- if (!session) {
658
- throw new Error(`Provisioning session ${sessionId} not found`);
659
- }
660
- if (session.status !== 'linked_pending_ack') {
661
- throw new Error(`Provisioning session ${sessionId} is not awaiting acknowledgment`);
662
- }
663
- // An expired ack window is a rolled-back link, not a race the ack can win.
664
- requireLiveProvisioningSession(session, sessionId);
665
- session.status = 'completed';
666
- delete session.encryptedMessage;
667
- delete session.newDeviceEphemeralPublicKey;
668
- }
669
- async rollbackProvisioning(sessionId) {
670
- const session = this.provisioningSessions.get(sessionId);
671
- if (!session || !session.assignedDeviceId || session.status !== 'linked_pending_ack') {
672
- return;
673
- }
674
- const existingDevices = this.devices.get(session.userId) ?? [];
675
- this.devices.set(session.userId, existingDevices.filter((device) => device.deviceId !== session.assignedDeviceId));
676
- session.status = 'rolled_back';
677
- }
678
- async deleteProvisioningSession(sessionId, _userId) {
679
- const session = this.provisioningSessions.get(sessionId);
680
- if (session?.assignedDeviceId && session.status === 'linked_pending_ack') {
681
- await this.rollbackProvisioning(sessionId);
682
- }
683
- this.provisioningSessions.delete(sessionId);
684
- }
685
- // ============================================================================
686
- // Key Rotation Service (KeyRotationService)
687
- // ============================================================================
688
- async getEcSignedPreKeyMetadata(userId, deviceId, identityType) {
689
- const key = this.storageKey(userId, deviceId, identityType);
690
- const metadata = this.ecSignedPreKeyMetadata.get(key);
691
- return metadata ? cloneRelayValue(metadata) : null;
692
- }
693
- async getKemLastResortPreKeyMetadata(userId, deviceId, identityType) {
694
- const key = this.storageKey(userId, deviceId, identityType);
695
- const metadata = this.kemLastResortPreKeyMetadata.get(key);
696
- return metadata ? cloneRelayValue(metadata) : null;
697
- }
698
- // ============================================================================
699
- // Sealed Sender (Anonymous Delivery)
700
- // ============================================================================
701
- /** Sender certificate store (base64 cert per userId:deviceId) */
702
- senderCertificates = new Map();
703
- /** Return the sender certificate configured for this device. */
704
- async fetchSenderCertificate(deviceId) {
705
- const key = `cert:${deviceId}`;
706
- const cert = this.senderCertificates.get(key);
707
- if (cert)
708
- return cert;
709
- throw new Error(`No sender certificate configured for device ${deviceId}; call setSenderCertificate() first`);
710
- }
711
- /**
712
- * Send a multi-recipient sealed sender message.
713
- * Parses the binary blob, constructs per-device ReceivedMessages,
714
- * and fans out via send().
715
- */
716
- async sendMultiRecipientUnidentified(sentMessageBase64, auth, timestamp, deliveryClass, recipientUserIds, clientMessageId) {
717
- if (this.failures.shouldRejectAuthorization()) {
718
- throw new SealedSenderAuthError();
719
- }
720
- void auth; // Accept but do not validate in the in-memory relay
721
- const { base64ToBytes, bytesToBase64 } = await import('../../../internal/crypto/index.js');
722
- const { asBase64 } = await import('../../../types/utils.js');
723
- const { deserializeSentMessage, serializeReceivedMessage } = await import('../../../internal/protocol/sealed-sender/multi-recipient-message.js');
724
- const parsed = deserializeSentMessage(base64ToBytes(asBase64(sentMessageBase64)));
725
- let firstResult;
726
- const uuids404 = [];
727
- for (let i = 0; i < parsed.recipients.length; i++) {
728
- const recipient = parsed.recipients[i];
729
- const userId = recipientUserIds?.[i] ?? recipient.serviceId;
730
- for (const device of recipient.devices) {
731
- // Construct per-device ReceivedMessage
732
- const receivedMsg = serializeReceivedMessage(recipient.encryptedMessageKey, recipient.authenticationTag, parsed.ephemeralPublic, parsed.messageCiphertext);
733
- const result = await this.send({
734
- targetUserId: userId,
735
- targetDeviceId: device.deviceId,
736
- senderUserId: '',
737
- senderDeviceId: 0,
738
- ciphertext: bytesToBase64(receivedMsg),
739
- messageType: 'unidentified_sender',
740
- deliveryClass,
741
- timestamp,
742
- clientMessageId,
743
- });
744
- if (!firstResult)
745
- firstResult = result;
746
- }
747
- }
748
- return {
749
- messageId: firstResult?.messageId ?? `multi-${Date.now()}`,
750
- serverTimestamp: firstResult?.serverTimestamp ?? Date.now(),
751
- uuids404,
752
- };
753
- }
754
- /**
755
- * Set a sender certificate for deterministic local development.
756
- */
757
- setSenderCertificate(deviceId, certificate) {
758
- this.senderCertificates.set(`cert:${deviceId}`, certificate);
759
- }
760
- // ============================================================================
761
- // Retry Requests (SESAME Spec §6.2)
762
- // ============================================================================
763
- async sendRetryRequest(request) {
764
- const key = `${request.originalSenderUserId}:${request.originalSenderDeviceId}`;
765
- const existing = this.retryRequests.get(key) || [];
766
- existing.push(cloneRelayValue(request));
767
- this.retryRequests.set(key, existing);
768
- // Notify subscribers
769
- const subscribers = this.retryRequestSubscriptions.get(key) || [];
770
- for (const handler of subscribers) {
771
- await handler(cloneRelayValue(request));
772
- }
773
- }
774
- subscribeRetryRequests(userId, deviceId, handler) {
775
- const key = `${userId}:${deviceId}`;
776
- const subscribers = this.retryRequestSubscriptions.get(key) || [];
777
- subscribers.push(handler);
778
- this.retryRequestSubscriptions.set(key, subscribers);
779
- // Deliver any pending retry requests
780
- const pending = this.retryRequests.get(key) || [];
781
- for (const request of pending) {
782
- handler(cloneRelayValue(request));
783
- }
784
- return () => {
785
- const subs = this.retryRequestSubscriptions.get(key) || [];
786
- const idx = subs.indexOf(handler);
787
- if (idx >= 0) {
788
- subs.splice(idx, 1);
789
- }
790
- };
791
- }
792
- // ============================================================================
793
- // Group state (encrypted, server-opaque)
794
- // ============================================================================
795
- async createGroupState(groupId, encryptedState, authorization) {
796
- await this.groupAuthorizationServer.createGroup(groupId, encryptedState, authorization);
797
- }
798
- async createGroup(groupId, encryptedState, authorization) {
799
- await this.createGroupState(groupId, encryptedState, authorization);
800
- }
801
- async getGroupState(groupId, authorization, version) {
802
- return this.groupAuthorizationServer.getGroup(groupId, authorization, version);
803
- }
804
- async getGroup(groupId, authorization, version) {
805
- return this.getGroupState(groupId, authorization, version);
806
- }
807
- async getGroupJoinInfo(groupId, inviteLinkPassword, authorization) {
808
- return this.groupAuthorizationServer.getGroupJoinInfo(groupId, inviteLinkPassword, authorization);
809
- }
810
- async getGroupChanges(groupId, fromVersion, authorization) {
811
- return this.groupAuthorizationServer.getGroupChanges(groupId, fromVersion, authorization);
812
- }
813
- async submitGroupChange(groupId, expectedVersion, actions, inviteLinkPassword, authorization) {
814
- return this.groupAuthorizationServer.submitGroupChange(groupId, expectedVersion, actions, inviteLinkPassword, authorization);
815
- }
816
- // ============================================================================
817
- // ZK Auth Credentials (anonymous group access)
818
- // ============================================================================
819
- userIdentities = new Map();
820
- async getOrCreateIdentity(userId) {
821
- const existing = this.userIdentities.get(userId);
822
- if (existing)
823
- return existing;
824
- const uuid = await generateUuidV4();
825
- // A concurrent call can create the identity during the await; keep the first.
826
- // No phoneNumberIdentifier. Matches the username-based (non-phone) app pattern
827
- const identity = this.userIdentities.get(userId) ?? { uuid };
828
- this.userIdentities.set(userId, identity);
829
- return identity;
830
- }
831
- async issueAuthCredential(userId) {
832
- const identity = await this.getOrCreateIdentity(userId);
833
- const aci = {
834
- kind: SERVICE_ID_ACI,
835
- uuid: uuidToBytes(identity.uuid),
836
- };
837
- const pni = identity.phoneNumberIdentifier
838
- ? {
839
- kind: SERVICE_ID_PNI,
840
- uuid: uuidToBytes(identity.phoneNumberIdentifier),
841
- }
842
- : undefined;
843
- const redemptionTime = Math.floor(Date.now() / 1000 / SECONDS_PER_DAY) * SECONDS_PER_DAY;
844
- const randomness = await generateRandomBytes(32);
845
- const response = issueAuthCredentialZk(this.serverSecretParams.credentialKeyPair, aci, pni, redemptionTime, randomness);
846
- return serializeAuthCredentialResponse(response);
847
- }
848
- async setUnidentifiedAccessKey(userId, accessKey) {
849
- if (accessKey.length !== 16) {
850
- throw new Error(`Unidentified access key must be 16 bytes, got ${accessKey.length}`);
851
- }
852
- await this.getOrCreateIdentity(userId);
853
- this.unidentifiedAccessKeys.set(userId, new Uint8Array(accessKey));
854
- }
855
- async issueProfileKeyCredential(userId, requestBytes) {
856
- const { aci } = await this.getGroupServiceIds(userId);
857
- const request = deserializeProfileKeyCredentialRequest(requestBytes);
858
- const now = Math.floor(Date.now() / 1000);
859
- const redemptionTime = Math.floor(now / SECONDS_PER_DAY) * SECONDS_PER_DAY + 2 * SECONDS_PER_DAY;
860
- const response = issueProfileKeyCredentialZk(this.serverSecretParams.profileKeyCredentialKeyPair, aci, request, redemptionTime, await generateRandomBytes(32));
861
- return serializeProfileKeyCredentialResponse(response);
862
- }
863
- /** Published parameters for wiring the executable reference group server. */
864
- getGroupServerPublicParams() {
865
- return this.groupAuthorizationServer.publicParams;
866
- }
867
- /** Service IDs deterministically associated with an in-memory relay account. */
868
- async getGroupServiceIds(userId) {
869
- const identity = await this.getOrCreateIdentity(userId);
870
- return {
871
- aci: { kind: SERVICE_ID_ACI, uuid: uuidToBytes(identity.uuid) },
872
- pni: identity.phoneNumberIdentifier
873
- ? {
874
- kind: SERVICE_ID_PNI,
875
- uuid: uuidToBytes(identity.phoneNumberIdentifier),
876
- }
877
- : undefined,
878
- };
879
- }
880
- async refreshGroupSendEndorsements(groupId, authorization) {
881
- const group = await this.groupAuthorizationServer.getGroup(groupId, authorization);
882
- if (!group) {
883
- throw new Error('Group not found');
884
- }
885
- // Extract UidEncCiphertext objects from the serialized encrypted state.
886
- // Matches the same parsing logic used by convex/signal/groups.ts.
887
- const memberCiphertexts = this.extractMemberCiphertexts(group.encryptedState);
888
- if (memberCiphertexts.length === 0) {
889
- throw new Error('Empty group');
890
- }
891
- const nowSeconds = Math.floor(Date.now() / 1000);
892
- const expiration = defaultExpiration(nowSeconds);
893
- const derivedKeyPair = deriveForExpiration(this.serverSecretParams.endorsementKeyPair, expiration);
894
- const randomness = await generateRandomBytes(32);
895
- const endorsementsResponse = issueEndorsements(memberCiphertexts, derivedKeyPair, randomness);
896
- const serialized = serializeEndorsementsResponse(endorsementsResponse);
897
- return { endorsements: serialized, expiration };
898
- }
899
- /**
900
- * Extract UidEncCiphertext objects from serialized encrypted group state JSON.
901
- *
902
- * The encrypted state is JSON with `{ __bytes: hex }` markers for binary fields.
903
- * Each member's `userId` is a 65-byte UuidCiphertext:
904
- * [ServiceIdKind (1 byte)] [E_A1 (32 bytes)] [E_A2 (32 bytes)].
905
- */
906
- extractMemberCiphertexts(encryptedState) {
907
- const json = utf8Decode(encryptedState);
908
- const parsed = JSON.parse(json);
909
- if (!parsed.members || !Array.isArray(parsed.members)) {
910
- throw new Error('Invalid group state: missing members array');
911
- }
912
- const RistrettoPoint = ristretto255.Point;
913
- return parsed.members.map((member) => {
914
- const hex = member.userId.__bytes;
915
- const len = hex.length >>> 1;
916
- const bytes = new Uint8Array(len);
917
- for (let i = 0; i < len; i++) {
918
- bytes[i] = parseInt(hex.substring(i * 2, i * 2 + 2), 16);
919
- }
920
- if (bytes.length !== 65) {
921
- throw new Error(`Invalid UuidCiphertext length: ${bytes.length}`);
922
- }
923
- const E_A1 = RistrettoPoint.fromBytes(bytes.slice(1, 33));
924
- const E_A2 = RistrettoPoint.fromBytes(bytes.slice(33, 65));
925
- return new Ciphertext(E_A1, E_A2, UidEncryptionDomain);
926
- });
927
- }
928
- // ============================================================================
929
- // Deterministic inspection and setup
930
- // ============================================================================
931
- /**
932
- * Clear all in-memory data.
933
- */
934
- clear() {
935
- this.devices.clear();
936
- this.identityKeys.clear();
937
- this.registrationIds.clear();
938
- this.ecPreKeys.clear();
939
- this.consumedEcPreKeyIds.clear();
940
- this.ecSignedPreKeys.clear();
941
- this.kemOneTimePreKeys.clear();
942
- this.consumedKemOneTimePreKeyIds.clear();
943
- this.kemLastResortPreKeys.clear();
944
- this.pendingMessages.clear();
945
- this.clientMessageReceipts.clear();
946
- this.subscriptions.clear();
947
- this.liveSubscriptions.clear();
948
- this.connectionState.move('stopped');
949
- this.provisioningSessions.clear();
950
- this.ecSignedPreKeyMetadata.clear();
951
- this.kemLastResortPreKeyMetadata.clear();
952
- this.retryRequests.clear();
953
- this.retryRequestSubscriptions.clear();
954
- this.groupAuthorizationServer.clear();
955
- this.userIdentities.clear();
956
- this.senderCertificates.clear();
957
- this.failures.reset();
958
- this.provisioningCounter = 0;
959
- }
960
- /**
961
- * Inspect pending messages for a device.
962
- */
963
- getPendingMessages(userId, deviceId) {
964
- const key = `${userId}:${deviceId}`;
965
- return cloneRelayValue(this.pendingMessages.get(key) || []);
966
- }
967
- /**
968
- * Inspect pending retry requests for a device.
969
- */
970
- getPendingRetryRequests(userId, deviceId) {
971
- const key = `${userId}:${deviceId}`;
972
- return cloneRelayValue(this.retryRequests.get(key) || []);
973
- }
974
- /**
975
- * Mark a retry request as handled (remove from pending)
976
- */
977
- markRetryRequestHandled(userId, deviceId, failedTimestamp) {
978
- const key = `${userId}:${deviceId}`;
979
- const requests = this.retryRequests.get(key) || [];
980
- const idx = requests.findIndex((r) => r.failedTimestamp === failedTimestamp);
981
- if (idx >= 0) {
982
- requests.splice(idx, 1);
983
- if (requests.length === 0) {
984
- this.retryRequests.delete(key);
985
- }
986
- }
987
- }
988
- /**
989
- * Set EC signed-prekey metadata for deterministic key rotation.
990
- */
991
- setEcSignedPreKeyMetadata(userId, deviceId, metadata, identityType = 'aci') {
992
- const key = this.storageKey(userId, deviceId, identityType);
993
- this.ecSignedPreKeyMetadata.set(key, cloneRelayValue(metadata));
994
- }
995
- /**
996
- * Set Kyber prekey metadata for deterministic key rotation.
997
- */
998
- setKemLastResortPreKeyMetadata(userId, deviceId, metadata, identityType = 'aci') {
999
- const key = this.storageKey(userId, deviceId, identityType);
1000
- this.kemLastResortPreKeyMetadata.set(key, cloneRelayValue(metadata));
1001
- }
1002
- /**
1003
- * Set the prekey count for deterministic key rotation.
1004
- *
1005
- * Creates placeholder prekeys to simulate a specific count.
1006
- * Exposes exact threshold behavior without a remote backend.
1007
- *
1008
- * @param userId - User ID
1009
- * @param deviceId - Device ID
1010
- * @param type - Key type ('ec' for classical, 'kem' for post-quantum)
1011
- * @param count - Number of prekeys to simulate
1012
- */
1013
- setPreKeyCount(userId, deviceId, type, count, identityType = 'aci') {
1014
- const key = this.storageKey(userId, deviceId, identityType);
1015
- // Create placeholder prekeys to set the count
1016
- const placeholderKeys = Array.from({ length: count }, (_, i) => ({
1017
- type: type === 'ec' ? 'ecPreKey' : 'kemOneTimePreKey',
1018
- keyId: i + 1,
1019
- publicKey: `placeholder-${i}`,
1020
- }));
1021
- if (type === 'ec') {
1022
- this.consumedEcPreKeyIds.delete(key);
1023
- this.ecPreKeys.set(key, placeholderKeys);
1024
- }
1025
- else {
1026
- this.consumedKemOneTimePreKeyIds.delete(key);
1027
- this.kemOneTimePreKeys.set(key, placeholderKeys);
1028
- }
1029
- }
1030
- // ============================================================================
1031
- // Utility Methods
1032
- // ============================================================================
1033
- recordConsumedPreKeyIds(consumed, storageKey, preKeys) {
1034
- if (preKeys.length === 0)
1035
- return;
1036
- const keyIds = consumed.get(storageKey) || new Set();
1037
- for (const preKey of preKeys) {
1038
- keyIds.add(preKey.keyId);
1039
- }
1040
- consumed.set(storageKey, keyIds);
1041
- }
1042
- deliverEnvelope(targetKey, envelope) {
1043
- const subscribers = this.subscriptions.get(targetKey) || [];
1044
- for (const callback of subscribers) {
1045
- callback(cloneRelayValue(envelope));
1046
- }
1047
- }
1048
- deliverPending(targetKey) {
1049
- if (this.failures.isDisconnected(targetKey))
1050
- return;
1051
- this.failures.discardReordered(targetKey);
1052
- const pending = this.pendingMessages.get(targetKey) || [];
1053
- for (const envelope of pending) {
1054
- this.failures.deliver(targetKey, envelope);
1055
- }
1056
- }
1057
- }
1058
- //# sourceMappingURL=adapter.js.map