@open-e2ee/signal-protocol-sdk 0.1.0-alpha.4 → 0.1.0-alpha.6

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 (497) hide show
  1. package/ADAPTERS.md +15 -15
  2. package/CHANGELOG.md +109 -0
  3. package/README.md +4 -2
  4. package/blocking/README.md +5 -5
  5. package/client/README.md +2 -2
  6. package/dist/blocking/index.d.ts +2 -2
  7. package/dist/blocking/index.d.ts.map +1 -1
  8. package/dist/blocking/index.js +1 -1
  9. package/dist/blocking/index.js.map +1 -1
  10. package/dist/blocking/manager.d.ts +7 -7
  11. package/dist/blocking/manager.d.ts.map +1 -1
  12. package/dist/blocking/manager.js +3 -3
  13. package/dist/blocking/manager.js.map +1 -1
  14. package/dist/blocking/types.d.ts +4 -4
  15. package/dist/blocking/types.d.ts.map +1 -1
  16. package/dist/blocking/types.js +1 -1
  17. package/dist/client/client.d.ts +3 -3
  18. package/dist/client/client.d.ts.map +1 -1
  19. package/dist/client/client.js +11 -11
  20. package/dist/client/client.js.map +1 -1
  21. package/dist/client/compose.d.ts +7 -7
  22. package/dist/client/compose.d.ts.map +1 -1
  23. package/dist/client/config.d.ts +15 -15
  24. package/dist/client/config.d.ts.map +1 -1
  25. package/dist/client/content-adapter.d.ts +4 -4
  26. package/dist/client/content-adapter.d.ts.map +1 -1
  27. package/dist/client/content-adapter.js +1 -1
  28. package/dist/client/content-adapter.js.map +1 -1
  29. package/dist/client/dual-store.d.ts +5 -5
  30. package/dist/client/dual-store.d.ts.map +1 -1
  31. package/dist/client/dual-store.js.map +1 -1
  32. package/dist/client/endorsement-manager.d.ts.map +1 -1
  33. package/dist/client/endorsement-manager.js +2 -2
  34. package/dist/client/endorsement-manager.js.map +1 -1
  35. package/dist/client/event-hooks.d.ts +1 -1
  36. package/dist/client/headless.d.ts +11 -11
  37. package/dist/client/headless.d.ts.map +1 -1
  38. package/dist/client/headless.js +8 -8
  39. package/dist/client/headless.js.map +1 -1
  40. package/dist/client/index.d.ts +2 -2
  41. package/dist/client/index.d.ts.map +1 -1
  42. package/dist/client/index.js +1 -1
  43. package/dist/client/index.js.map +1 -1
  44. package/dist/client/key-rotation-core.d.ts +11 -11
  45. package/dist/client/key-rotation-core.d.ts.map +1 -1
  46. package/dist/client/key-rotation-core.js +22 -22
  47. package/dist/client/key-rotation-core.js.map +1 -1
  48. package/dist/client/media.d.ts +2 -2
  49. package/dist/client/media.js +5 -5
  50. package/dist/client/media.js.map +1 -1
  51. package/dist/client/messages.js +2 -2
  52. package/dist/client/messages.js.map +1 -1
  53. package/dist/client/relay-subscription.d.ts +2 -2
  54. package/dist/client/relay-subscription.d.ts.map +1 -1
  55. package/dist/client/relay-subscription.js +18 -1
  56. package/dist/client/relay-subscription.js.map +1 -1
  57. package/dist/client/retry.js +1 -1
  58. package/dist/client/retry.js.map +1 -1
  59. package/dist/client/sealed-sender-ops.d.ts +1 -1
  60. package/dist/client/sealed-sender-ops.d.ts.map +1 -1
  61. package/dist/client/sealed-sender-ops.js +4 -4
  62. package/dist/client/sealed-sender-ops.js.map +1 -1
  63. package/dist/client/sessions.d.ts.map +1 -1
  64. package/dist/client/sessions.js +3 -0
  65. package/dist/client/sessions.js.map +1 -1
  66. package/dist/client/signal-service-cipher.d.ts +14 -10
  67. package/dist/client/signal-service-cipher.d.ts.map +1 -1
  68. package/dist/client/signal-service-cipher.js +31 -23
  69. package/dist/client/signal-service-cipher.js.map +1 -1
  70. package/dist/client/types.d.ts +8 -8
  71. package/dist/client/types.d.ts.map +1 -1
  72. package/dist/device/connection.js +2 -2
  73. package/dist/device/connection.js.map +1 -1
  74. package/dist/device/device-id.d.ts.map +1 -1
  75. package/dist/device/device-id.js +4 -4
  76. package/dist/device/device-id.js.map +1 -1
  77. package/dist/device/provisioning.d.ts +5 -5
  78. package/dist/device/provisioning.d.ts.map +1 -1
  79. package/dist/device/provisioning.js +9 -9
  80. package/dist/device/provisioning.js.map +1 -1
  81. package/dist/device/transfer.d.ts.map +1 -1
  82. package/dist/device/transfer.js +14 -14
  83. package/dist/device/transfer.js.map +1 -1
  84. package/dist/files/index.d.ts +1 -1
  85. package/dist/files/index.js +1 -1
  86. package/dist/hooks/use-connection-presence.d.ts +5 -5
  87. package/dist/hooks/use-connection-presence.d.ts.map +1 -1
  88. package/dist/hooks/use-connection-presence.js +5 -5
  89. package/dist/hooks/use-connection-presence.js.map +1 -1
  90. package/dist/hooks/use-group-membership.d.ts +2 -2
  91. package/dist/hooks/use-key-rotation.js +2 -2
  92. package/dist/hooks/use-key-rotation.js.map +1 -1
  93. package/dist/index.d.ts +13 -13
  94. package/dist/index.d.ts.map +1 -1
  95. package/dist/index.js +6 -6
  96. package/dist/index.js.map +1 -1
  97. package/dist/internal/crypto/ec/x25519-validation.d.ts.map +1 -1
  98. package/dist/internal/crypto/ec/x25519-validation.js +4 -4
  99. package/dist/internal/crypto/ec/x25519-validation.js.map +1 -1
  100. package/dist/internal/crypto/index.js +1 -1
  101. package/dist/internal/crypto/index.js.map +1 -1
  102. package/dist/internal/crypto/kdf/hkdf.d.ts +1 -1
  103. package/dist/internal/crypto/kdf/hkdf.d.ts.map +1 -1
  104. package/dist/internal/crypto/kdf/hkdf.js +2 -2
  105. package/dist/internal/crypto/kdf/hkdf.js.map +1 -1
  106. package/dist/internal/crypto/key-prefix.d.ts +1 -1
  107. package/dist/internal/crypto/key-prefix.js +1 -1
  108. package/dist/internal/crypto/pq/kyber.d.ts +1 -1
  109. package/dist/internal/crypto/pq/kyber.js +1 -1
  110. package/dist/internal/crypto/symmetric/aes-gcm-siv.d.ts +1 -1
  111. package/dist/internal/crypto/symmetric/aes-gcm-siv.js +1 -1
  112. package/dist/internal/crypto/symmetric/mac.d.ts +3 -3
  113. package/dist/internal/crypto/symmetric/mac.js +3 -3
  114. package/dist/internal/crypto/utils.d.ts +2 -2
  115. package/dist/internal/crypto/utils.js +2 -2
  116. package/dist/internal/encoding/proto/envelope.d.ts +21 -21
  117. package/dist/internal/encoding/proto/envelope.d.ts.map +1 -1
  118. package/dist/internal/encoding/proto/envelope.js +25 -25
  119. package/dist/internal/encoding/proto/envelope.js.map +1 -1
  120. package/dist/internal/encoding/proto/index.d.ts +2 -2
  121. package/dist/internal/encoding/proto/index.d.ts.map +1 -1
  122. package/dist/internal/encoding/proto/index.js +3 -3
  123. package/dist/internal/encoding/proto/index.js.map +1 -1
  124. package/dist/internal/encoding/proto/pq-ratchet-serialize.d.ts +5 -5
  125. package/dist/internal/encoding/proto/pq-ratchet-serialize.d.ts.map +1 -1
  126. package/dist/internal/encoding/proto/pq-ratchet-serialize.js +4 -4
  127. package/dist/internal/encoding/proto/pq-ratchet-serialize.js.map +1 -1
  128. package/dist/internal/encoding/proto/signal-message.d.ts +33 -33
  129. package/dist/internal/encoding/proto/signal-message.d.ts.map +1 -1
  130. package/dist/internal/encoding/proto/signal-message.js +58 -58
  131. package/dist/internal/encoding/proto/signal-message.js.map +1 -1
  132. package/dist/internal/groups/group-id.d.ts +1 -1
  133. package/dist/internal/groups/group-id.js +1 -1
  134. package/dist/internal/groups/group-id.js.map +1 -1
  135. package/dist/internal/groups-v2/access-control.d.ts +8 -1
  136. package/dist/internal/groups-v2/access-control.d.ts.map +1 -1
  137. package/dist/internal/groups-v2/access-control.js +8 -1
  138. package/dist/internal/groups-v2/access-control.js.map +1 -1
  139. package/dist/internal/groups-v2/change-actions.d.ts +8 -3
  140. package/dist/internal/groups-v2/change-actions.d.ts.map +1 -1
  141. package/dist/internal/groups-v2/change-actions.js +8 -3
  142. package/dist/internal/groups-v2/change-actions.js.map +1 -1
  143. package/dist/internal/groups-v2/index.d.ts +7 -2
  144. package/dist/internal/groups-v2/index.d.ts.map +1 -1
  145. package/dist/internal/groups-v2/index.js.map +1 -1
  146. package/dist/internal/groups-v2/manager.d.ts +4 -2
  147. package/dist/internal/groups-v2/manager.d.ts.map +1 -1
  148. package/dist/internal/groups-v2/manager.js +5 -3
  149. package/dist/internal/groups-v2/manager.js.map +1 -1
  150. package/dist/internal/groups-v2/types.d.ts +10 -3
  151. package/dist/internal/groups-v2/types.d.ts.map +1 -1
  152. package/dist/internal/groups-v2/types.js.map +1 -1
  153. package/dist/internal/manager/manager.d.ts +3 -3
  154. package/dist/internal/manager/manager.d.ts.map +1 -1
  155. package/dist/internal/manager/manager.js +28 -17
  156. package/dist/internal/manager/manager.js.map +1 -1
  157. package/dist/internal/protocol/double-ratchet/chains.d.ts +1 -1
  158. package/dist/internal/protocol/double-ratchet/chains.d.ts.map +1 -1
  159. package/dist/internal/protocol/double-ratchet/chains.js +10 -10
  160. package/dist/internal/protocol/double-ratchet/chains.js.map +1 -1
  161. package/dist/internal/protocol/double-ratchet/ratchet.d.ts +3 -3
  162. package/dist/internal/protocol/double-ratchet/ratchet.d.ts.map +1 -1
  163. package/dist/internal/protocol/double-ratchet/ratchet.js +3 -3
  164. package/dist/internal/protocol/double-ratchet/ratchet.js.map +1 -1
  165. package/dist/internal/protocol/pqxdh/pqxdh.d.ts.map +1 -1
  166. package/dist/internal/protocol/pqxdh/pqxdh.js +3 -3
  167. package/dist/internal/protocol/pqxdh/pqxdh.js.map +1 -1
  168. package/dist/internal/protocol/sealed-sender/decryption.js +2 -2
  169. package/dist/internal/protocol/sealed-sender/decryption.js.map +1 -1
  170. package/dist/internal/protocol/sealed-sender/types.d.ts +1 -1
  171. package/dist/internal/protocol/sealed-sender/types.js +1 -1
  172. package/dist/internal/protocol/sender-keys/index.d.ts +1 -1
  173. package/dist/internal/protocol/sender-keys/manager.d.ts +4 -4
  174. package/dist/internal/protocol/sender-keys/manager.d.ts.map +1 -1
  175. package/dist/internal/protocol/sender-keys/manager.js +5 -5
  176. package/dist/internal/protocol/sender-keys/manager.js.map +1 -1
  177. package/dist/internal/protocol/spqr/index.d.ts +1 -1
  178. package/dist/internal/protocol/spqr/index.js +1 -1
  179. package/dist/internal/protocol/spqr/message.d.ts +1 -1
  180. package/dist/internal/protocol/spqr/message.js +1 -1
  181. package/dist/internal/protocol/spqr/ml-kem-braid/rs/codec.d.ts +3 -3
  182. package/dist/internal/protocol/spqr/ml-kem-braid/rs/codec.d.ts.map +1 -1
  183. package/dist/internal/protocol/spqr/ml-kem-braid/rs/index.js +2 -2
  184. package/dist/internal/protocol/spqr/ml-kem-braid/rs/index.js.map +1 -1
  185. package/dist/internal/protocol/spqr/ml-kem-braid/rs/lagrange.d.ts +1 -1
  186. package/dist/internal/protocol/spqr/ml-kem-braid/rs/lagrange.js +1 -1
  187. package/dist/internal/protocol/spqr/ml-kem-braid/rs/lagrange.js.map +1 -1
  188. package/dist/internal/protocol/spqr/ml-kem-braid/serialize.d.ts +1 -1
  189. package/dist/internal/protocol/spqr/ml-kem-braid/serialize.js +1 -1
  190. package/dist/internal/protocol/spqr/ml-kem-braid/state-machine.js +5 -5
  191. package/dist/internal/protocol/spqr/ml-kem-braid/state-machine.js.map +1 -1
  192. package/dist/internal/protocol/spqr/ml-kem-braid/types.d.ts +1 -1
  193. package/dist/internal/protocol/spqr/ml-kem-braid/types.d.ts.map +1 -1
  194. package/dist/internal/protocol/spqr/spqr.d.ts +10 -10
  195. package/dist/internal/protocol/spqr/spqr.d.ts.map +1 -1
  196. package/dist/internal/protocol/spqr/spqr.js +14 -14
  197. package/dist/internal/protocol/spqr/spqr.js.map +1 -1
  198. package/dist/internal/protocol/triple-ratchet/ratchet.d.ts +3 -3
  199. package/dist/internal/protocol/triple-ratchet/ratchet.d.ts.map +1 -1
  200. package/dist/internal/protocol/triple-ratchet/ratchet.js +5 -5
  201. package/dist/internal/protocol/triple-ratchet/ratchet.js.map +1 -1
  202. package/dist/internal/protocol/username/generate.d.ts +1 -1
  203. package/dist/internal/protocol/username/generate.js +1 -1
  204. package/dist/internal/protocol/username/hash.d.ts +1 -1
  205. package/dist/internal/protocol/username/hash.js +1 -1
  206. package/dist/internal/protocol/username/link.d.ts +1 -1
  207. package/dist/internal/protocol/username/link.js +1 -1
  208. package/dist/internal/protocol/username/proof.d.ts +1 -1
  209. package/dist/internal/protocol/username/proof.js +1 -1
  210. package/dist/internal/protocol/x3dh/x3dh.d.ts.map +1 -1
  211. package/dist/internal/protocol/x3dh/x3dh.js +6 -6
  212. package/dist/internal/protocol/x3dh/x3dh.js.map +1 -1
  213. package/dist/internal/protocol/zk/groups/client-zk-group-cipher.d.ts +2 -2
  214. package/dist/internal/protocol/zk/groups/client-zk-group-cipher.js +2 -2
  215. package/dist/internal/sesame/device-registry.d.ts +18 -13
  216. package/dist/internal/sesame/device-registry.d.ts.map +1 -1
  217. package/dist/internal/sesame/device-registry.js +13 -9
  218. package/dist/internal/sesame/device-registry.js.map +1 -1
  219. package/dist/internal/sesame/manager.d.ts +1 -1
  220. package/dist/internal/sesame/manager.d.ts.map +1 -1
  221. package/dist/internal/sesame/manager.js +16 -16
  222. package/dist/internal/sesame/manager.js.map +1 -1
  223. package/dist/internal/session/builder.js +3 -3
  224. package/dist/internal/session/builder.js.map +1 -1
  225. package/dist/internal/session/cipher.d.ts +2 -2
  226. package/dist/internal/session/cipher.d.ts.map +1 -1
  227. package/dist/internal/session/cipher.js +30 -30
  228. package/dist/internal/session/cipher.js.map +1 -1
  229. package/dist/internal/session/decryption.d.ts +1 -1
  230. package/dist/internal/session/decryption.js +10 -10
  231. package/dist/internal/session/decryption.js.map +1 -1
  232. package/dist/internal/session/factory.d.ts.map +1 -1
  233. package/dist/internal/session/factory.js +3 -3
  234. package/dist/internal/session/factory.js.map +1 -1
  235. package/dist/internal/session/handshake.d.ts.map +1 -1
  236. package/dist/internal/session/handshake.js +3 -3
  237. package/dist/internal/session/handshake.js.map +1 -1
  238. package/dist/internal/session/keys.d.ts +1 -1
  239. package/dist/internal/session/ratchet.d.ts.map +1 -1
  240. package/dist/internal/session/ratchet.js +4 -4
  241. package/dist/internal/session/ratchet.js.map +1 -1
  242. package/dist/internal/session/types.d.ts +2 -2
  243. package/dist/internal/session/types.d.ts.map +1 -1
  244. package/dist/internal/session/validation.d.ts.map +1 -1
  245. package/dist/internal/session/validation.js +3 -3
  246. package/dist/internal/session/validation.js.map +1 -1
  247. package/dist/keys/generation.d.ts +1 -1
  248. package/dist/keys/generation.js +1 -1
  249. package/dist/keys/types.d.ts +1 -1
  250. package/dist/keys/types.d.ts.map +1 -1
  251. package/dist/layers.d.ts +2 -2
  252. package/dist/layers.d.ts.map +1 -1
  253. package/dist/layers.js +4 -4
  254. package/dist/layers.js.map +1 -1
  255. package/dist/local/store/expo/adapter.d.ts +11 -11
  256. package/dist/local/store/expo/adapter.d.ts.map +1 -1
  257. package/dist/local/store/expo/adapter.js +9 -9
  258. package/dist/local/store/expo/adapter.js.map +1 -1
  259. package/dist/local/store/expo/database-key.d.ts +2 -2
  260. package/dist/local/store/expo/database-key.d.ts.map +1 -1
  261. package/dist/local/store/expo/database-key.js +5 -5
  262. package/dist/local/store/expo/database-key.js.map +1 -1
  263. package/dist/local/store/expo/db.d.ts +9 -9
  264. package/dist/local/store/expo/db.d.ts.map +1 -1
  265. package/dist/local/store/expo/db.js +3 -3
  266. package/dist/local/store/expo/db.js.map +1 -1
  267. package/dist/local/store/expo/index.d.ts +7 -7
  268. package/dist/local/store/expo/index.d.ts.map +1 -1
  269. package/dist/local/store/expo/index.js +3 -3
  270. package/dist/local/store/expo/index.js.map +1 -1
  271. package/dist/local/store/expo/key-storage.d.ts +1 -1
  272. package/dist/local/store/expo/key-storage.d.ts.map +1 -1
  273. package/dist/local/store/expo/key-storage.js +4 -4
  274. package/dist/local/store/expo/key-storage.js.map +1 -1
  275. package/dist/local/store/expo/models/local-identity.d.ts +1 -1
  276. package/dist/local/store/expo/models/local-identity.js +1 -1
  277. package/dist/local/store/expo/models/sender-key.d.ts +3 -3
  278. package/dist/local/store/expo/models/sender-key.d.ts.map +1 -1
  279. package/dist/local/store/expo/models/sender-key.js +3 -3
  280. package/dist/local/store/expo/models/sender-key.js.map +1 -1
  281. package/dist/local/store/expo/schema.d.ts +1 -1
  282. package/dist/local/store/expo/schema.js +1 -1
  283. package/dist/local/store/expo/secure-store-options.d.ts +2 -2
  284. package/dist/local/store/expo/secure-store-options.d.ts.map +1 -1
  285. package/dist/local/store/expo/secure-store-options.js +1 -1
  286. package/dist/local/store/expo/secure-store-options.js.map +1 -1
  287. package/dist/local/store/index.d.ts +9 -9
  288. package/dist/local/store/index.d.ts.map +1 -1
  289. package/dist/local/store/index.js +8 -8
  290. package/dist/local/store/index.js.map +1 -1
  291. package/dist/local/store/mock/adapter.d.ts +10 -4
  292. package/dist/local/store/mock/adapter.d.ts.map +1 -1
  293. package/dist/local/store/mock/adapter.js +119 -49
  294. package/dist/local/store/mock/adapter.js.map +1 -1
  295. package/dist/local/store/mock/failures.d.ts +34 -0
  296. package/dist/local/store/mock/failures.d.ts.map +1 -0
  297. package/dist/local/store/mock/failures.js +75 -0
  298. package/dist/local/store/mock/failures.js.map +1 -0
  299. package/dist/local/store/mock/index.d.ts +4 -3
  300. package/dist/local/store/mock/index.d.ts.map +1 -1
  301. package/dist/local/store/mock/index.js +5 -4
  302. package/dist/local/store/mock/index.js.map +1 -1
  303. package/dist/local/store/node/adapter.d.ts +4 -4
  304. package/dist/local/store/node/adapter.d.ts.map +1 -1
  305. package/dist/local/store/node/adapter.js +2 -2
  306. package/dist/local/store/node/adapter.js.map +1 -1
  307. package/dist/local/store/node/database-key.js +1 -1
  308. package/dist/local/store/node/database.d.ts.map +1 -1
  309. package/dist/local/store/node/database.js +2 -2
  310. package/dist/local/store/node/database.js.map +1 -1
  311. package/dist/local/store/node/index.d.ts +4 -4
  312. package/dist/local/store/node/index.d.ts.map +1 -1
  313. package/dist/local/store/node/index.js +3 -3
  314. package/dist/local/store/node/index.js.map +1 -1
  315. package/dist/local/store/react-native/adapter.d.ts +5 -5
  316. package/dist/local/store/react-native/adapter.d.ts.map +1 -1
  317. package/dist/local/store/react-native/adapter.js +14 -14
  318. package/dist/local/store/react-native/adapter.js.map +1 -1
  319. package/dist/local/store/react-native/index.d.ts +4 -4
  320. package/dist/local/store/react-native/index.d.ts.map +1 -1
  321. package/dist/local/store/react-native/index.js +3 -3
  322. package/dist/local/store/react-native/index.js.map +1 -1
  323. package/dist/local/store/react-native/storage.d.ts +2 -2
  324. package/dist/local/store/web/adapter.d.ts +4 -4
  325. package/dist/local/store/web/adapter.d.ts.map +1 -1
  326. package/dist/local/store/web/adapter.js +21 -9
  327. package/dist/local/store/web/adapter.js.map +1 -1
  328. package/dist/local/store/web/index.d.ts +4 -4
  329. package/dist/local/store/web/index.d.ts.map +1 -1
  330. package/dist/local/store/web/index.js +3 -3
  331. package/dist/local/store/web/index.js.map +1 -1
  332. package/dist/local/vault/expo-secure-store.d.ts +2 -2
  333. package/dist/local/vault/expo-secure-store.d.ts.map +1 -1
  334. package/dist/local/vault/expo-secure-store.js +5 -5
  335. package/dist/local/vault/expo-secure-store.js.map +1 -1
  336. package/dist/local/vault/index.d.ts +3 -3
  337. package/dist/local/vault/index.d.ts.map +1 -1
  338. package/dist/local/vault/index.js +1 -1
  339. package/dist/local/vault/index.js.map +1 -1
  340. package/dist/logger.d.ts +4 -4
  341. package/dist/logger.d.ts.map +1 -1
  342. package/dist/logger.js +5 -5
  343. package/dist/logger.js.map +1 -1
  344. package/dist/media/index.d.ts +7 -7
  345. package/dist/media/index.d.ts.map +1 -1
  346. package/dist/media/index.js +2 -2
  347. package/dist/profile/cipher.d.ts +1 -1
  348. package/dist/profile/cipher.js +1 -1
  349. package/dist/profile/contact-state.d.ts +1 -1
  350. package/dist/profile/contact-state.d.ts.map +1 -1
  351. package/dist/profile/contact-state.js +3 -3
  352. package/dist/profile/contact-state.js.map +1 -1
  353. package/dist/profile/crypto.d.ts +1 -1
  354. package/dist/profile/crypto.js +1 -1
  355. package/dist/profile/profile-key.d.ts.map +1 -1
  356. package/dist/profile/profile-key.js +3 -3
  357. package/dist/profile/profile-key.js.map +1 -1
  358. package/dist/profile/update-service.d.ts +2 -2
  359. package/dist/profile/update-service.d.ts.map +1 -1
  360. package/dist/profile/update-service.js +2 -2
  361. package/dist/profile/update-service.js.map +1 -1
  362. package/dist/remote/object-store/convex-r2/server.d.ts +1 -1
  363. package/dist/remote/object-store/convex-r2/storage.d.ts +2 -2
  364. package/dist/remote/object-store/convex-r2/storage.d.ts.map +1 -1
  365. package/dist/remote/object-store/index.d.ts +1 -1
  366. package/dist/remote/object-store/index.d.ts.map +1 -1
  367. package/dist/remote/object-store/s3/storage.d.ts +3 -3
  368. package/dist/remote/object-store/s3/storage.d.ts.map +1 -1
  369. package/dist/remote/object-store/s3/storage.js +1 -1
  370. package/dist/remote/object-store/types.d.ts +1 -1
  371. package/dist/remote/object-store/types.d.ts.map +1 -1
  372. package/dist/remote/relay/convex/index.d.ts +10 -10
  373. package/dist/remote/relay/convex/index.d.ts.map +1 -1
  374. package/dist/remote/relay/convex/index.js +6 -6
  375. package/dist/remote/relay/convex/index.js.map +1 -1
  376. package/dist/remote/relay/convex/relay.d.ts +13 -13
  377. package/dist/remote/relay/convex/relay.d.ts.map +1 -1
  378. package/dist/remote/relay/convex/relay.js +12 -12
  379. package/dist/remote/relay/convex/relay.js.map +1 -1
  380. package/dist/remote/relay/convex/types.d.ts +7 -7
  381. package/dist/remote/relay/convex/types.js +1 -1
  382. package/dist/remote/relay/index.d.ts +7 -7
  383. package/dist/remote/relay/index.d.ts.map +1 -1
  384. package/dist/remote/relay/index.js +6 -6
  385. package/dist/remote/relay/index.js.map +1 -1
  386. package/dist/remote/relay/mock/adapter.d.ts +17 -6
  387. package/dist/remote/relay/mock/adapter.d.ts.map +1 -1
  388. package/dist/remote/relay/mock/adapter.js +173 -54
  389. package/dist/remote/relay/mock/adapter.js.map +1 -1
  390. package/dist/remote/relay/mock/failures.d.ts +58 -0
  391. package/dist/remote/relay/mock/failures.d.ts.map +1 -0
  392. package/dist/remote/relay/mock/failures.js +123 -0
  393. package/dist/remote/relay/mock/failures.js.map +1 -0
  394. package/dist/remote/relay/mock/index.d.ts +4 -3
  395. package/dist/remote/relay/mock/index.d.ts.map +1 -1
  396. package/dist/remote/relay/mock/index.js +5 -4
  397. package/dist/remote/relay/mock/index.js.map +1 -1
  398. package/dist/remote/relay/types.d.ts +12 -12
  399. package/dist/remote/relay/types.d.ts.map +1 -1
  400. package/dist/remote/relay/types.js +3 -3
  401. package/dist/safety/protobuf.d.ts +1 -1
  402. package/dist/safety/protobuf.d.ts.map +1 -1
  403. package/dist/types/api.d.ts +8 -8
  404. package/dist/types/api.d.ts.map +1 -1
  405. package/dist/types/errors.d.ts +2 -2
  406. package/dist/types/errors.d.ts.map +1 -1
  407. package/dist/types/errors.js +2 -2
  408. package/dist/types/errors.js.map +1 -1
  409. package/dist/types/messages.d.ts +1 -1
  410. package/dist/types/protocol-config.d.ts +20 -4
  411. package/dist/types/protocol-config.d.ts.map +1 -1
  412. package/dist/types/protocol-config.js +17 -2
  413. package/dist/types/protocol-config.js.map +1 -1
  414. package/dist/types/protocol-constants.d.ts +1 -1
  415. package/dist/types/protocol-constants.js +1 -1
  416. package/dist/utils/binary-transfer.d.ts +1 -1
  417. package/dist/utils/errors.d.ts +2 -2
  418. package/dist/utils/errors.js +2 -2
  419. package/dist/utils/retry.d.ts +4 -3
  420. package/dist/utils/retry.d.ts.map +1 -1
  421. package/dist/utils/retry.js +20 -1
  422. package/dist/utils/retry.js.map +1 -1
  423. package/dist/zk/groups.d.ts +1 -1
  424. package/dist/zk/groups.js +1 -1
  425. package/docs/CLIENT_COMPOSITION.md +7 -5
  426. package/docs/DEVIATIONS.md +97 -80
  427. package/docs/GETTING_STARTED.md +12 -8
  428. package/docs/INTERFACES.md +22 -22
  429. package/docs/PACKAGE_SURFACE.md +12 -12
  430. package/docs/PROTOCOL_POLICY.md +2 -2
  431. package/docs/RECIPES.md +6 -2
  432. package/docs/api/classes/EndorsementManager.md +1 -1
  433. package/docs/api/classes/{SignalBlockingManager.md → SignalProtocolBlockingManager.md} +5 -5
  434. package/docs/api/classes/SignalProtocolClient.md +4 -4
  435. package/docs/api/functions/createDefaultSignalProtocolContentAdapter.md +13 -0
  436. package/docs/api/functions/{createDefaultSignalLogger.md → createDefaultSignalProtocolLogger.md} +5 -5
  437. package/docs/api/functions/{resolveSignalLogger.md → resolveSignalProtocolLogger.md} +5 -5
  438. package/docs/api/interfaces/BlockedRecipientEntry.md +1 -1
  439. package/docs/api/interfaces/ILogger.md +1 -1
  440. package/docs/api/interfaces/IProtocolStore.md +1 -1
  441. package/docs/api/interfaces/ISenderKeyStore.md +1 -1
  442. package/docs/api/interfaces/ISesameStore.md +1 -1
  443. package/docs/api/interfaces/ISignalProtocolClient.md +2 -2
  444. package/docs/api/interfaces/{ISignalLocalSecretVault.md → ISignalProtocolLocalSecretVault.md} +4 -4
  445. package/docs/api/interfaces/{ISignalLocalStore.md → ISignalProtocolLocalStore.md} +4 -4
  446. package/docs/api/interfaces/{ISignalRelayServer.md → ISignalProtocolRelayServer.md} +3 -3
  447. package/docs/api/interfaces/{InspectedSignalContent.md → InspectedSignalProtocolContent.md} +2 -2
  448. package/docs/api/interfaces/MLKEMBraidAgentState.md +1 -1
  449. package/docs/api/interfaces/MessageHeader.md +1 -1
  450. package/docs/api/interfaces/PreKeyMaintenanceStore.md +2 -1
  451. package/docs/api/interfaces/SealedSenderConfig.md +1 -1
  452. package/docs/api/interfaces/{SignalBlockingHooks.md → SignalProtocolBlockingHooks.md} +2 -2
  453. package/docs/api/interfaces/SignalProtocolBlockingManagerOptions.md +31 -0
  454. package/docs/api/interfaces/{SignalBlockingMirror.md → SignalProtocolBlockingMirror.md} +2 -2
  455. package/docs/api/interfaces/{SignalBlockingStore.md → SignalProtocolBlockingStore.md} +2 -2
  456. package/docs/api/interfaces/SignalProtocolClientAdapterConfig.md +3 -3
  457. package/docs/api/interfaces/SignalProtocolClientCompositionOptions.md +2 -2
  458. package/docs/api/interfaces/SignalProtocolClientConfig.md +10 -10
  459. package/docs/api/interfaces/SignalProtocolClientHooks.md +1 -1
  460. package/docs/api/interfaces/SignalProtocolClientIdentityConfig.md +1 -1
  461. package/docs/api/interfaces/SignalProtocolClientMediaConfig.md +2 -2
  462. package/docs/api/interfaces/SignalProtocolConfig.md +1 -1
  463. package/docs/api/interfaces/{SignalContentAdapter.md → SignalProtocolContentAdapter.md} +4 -4
  464. package/docs/api/interfaces/{SignalRemoteObjectStore.md → SignalProtocolRemoteObjectStore.md} +2 -2
  465. package/docs/api/namespaces/blocking/README.md +10 -10
  466. package/docs/api/namespaces/encoding/functions/bytesToUrlSafeBase64.md +2 -2
  467. package/docs/api/namespaces/keys/functions/generateKemOneTimePreKeys.md +1 -1
  468. package/docs/api/namespaces/media/functions/prepareMediaAttachmentUpload.md +1 -1
  469. package/docs/api/namespaces/media/functions/resolveMediaAttachment.md +1 -1
  470. package/docs/api/namespaces/media/interfaces/DeleteMediaAttachmentOptions.md +1 -1
  471. package/docs/api/namespaces/media/interfaces/ExecuteMediaAttachmentJobOptions.md +1 -1
  472. package/docs/api/namespaces/media/interfaces/PrepareMediaAttachmentUploadOptions.md +1 -1
  473. package/docs/api/namespaces/media/interfaces/ResolveMediaAttachmentOptions.md +1 -1
  474. package/docs/api/namespaces/media/variables/downloadMediaAttachment.md +1 -1
  475. package/docs/api/type-aliases/GroupId.md +1 -1
  476. package/docs/api/variables/MAX_RECEIVER_CHAINS.md +1 -1
  477. package/docs/api/variables/ONE_TIME_PREKEY_BATCH_SIZE.md +1 -1
  478. package/docs/api/variables/{defaultSignalLogger.md → defaultSignalProtocolLogger.md} +5 -5
  479. package/files/README.md +1 -1
  480. package/local/store/README.md +10 -10
  481. package/local/store/expo/README.md +5 -5
  482. package/local/store/mock/README.md +32 -1
  483. package/local/store/node/README.md +1 -1
  484. package/local/store/react-native/README.md +1 -1
  485. package/local/store/web/README.md +1 -1
  486. package/local/vault/README.md +3 -3
  487. package/package.json +1 -1
  488. package/remote/README.md +19 -19
  489. package/remote/object-store/README.md +3 -3
  490. package/remote/object-store/convex-r2/README.md +1 -1
  491. package/remote/object-store/s3/README.md +1 -1
  492. package/remote/relay/README.md +2 -2
  493. package/remote/relay/convex/README.md +4 -4
  494. package/remote/relay/mock/README.md +38 -1
  495. package/types/README.md +1 -1
  496. package/docs/api/functions/createDefaultSignalContentAdapter.md +0 -13
  497. package/docs/api/interfaces/SignalBlockingManagerOptions.md +0 -31
@@ -1,7 +1,7 @@
1
1
  /**
2
- * Mock Signal Relay Server
2
+ * Mock Signal Protocol Relay Server
3
3
  *
4
- * In-memory implementation of ISignalRelayServer for local development.
4
+ * In-memory implementation of ISignalProtocolRelayServer for local development.
5
5
  * Simulates a backend server without any network calls.
6
6
  *
7
7
  * WARNING: All data is lost when the adapter is destroyed.
@@ -18,7 +18,20 @@ import { defaultExpiration, deriveForExpiration, issueEndorsements, serializeEnd
18
18
  import { UidEncryptionDomain } from '../../../internal/protocol/zk/groups/uid-encryption.js';
19
19
  import { Ciphertext } from '../../../internal/protocol/zk/credentials/attributes.js';
20
20
  import { ristretto255 } from '@noble/curves/ed25519.js';
21
- export class MockSignalRelayServer {
21
+ import { MAX_DEVICES } from '../../../device/constants.js';
22
+ import { SealedSenderAuthError } from '../../../types/errors.js';
23
+ import { MockRelayFailureController, } from './failures.js';
24
+ /**
25
+ * Simulate the serialization boundary of a real relay.
26
+ *
27
+ * Values entering or leaving the in-memory server must never share mutable
28
+ * references with caller-owned objects.
29
+ */
30
+ function cloneRelayValue(value) {
31
+ return structuredClone(value);
32
+ }
33
+ export class MockSignalProtocolRelayServer {
34
+ failures;
22
35
  // Device registry
23
36
  devices = new Map(); // key: userId
24
37
  // Identity keys per account (ACI/PNI), shared across all devices
@@ -27,8 +40,10 @@ export class MockSignalRelayServer {
27
40
  registrationIds = new Map(); // key: `${userId}:${deviceId}:${identityType}`
28
41
  // Prekeys per device
29
42
  ecPreKeys = new Map(); // key: `${userId}:${deviceId}:${identityType}`
43
+ consumedEcPreKeyIds = new Map(); // key: `${userId}:${deviceId}:${identityType}`
30
44
  ecSignedPreKeys = new Map(); // key: `${userId}:${deviceId}:${identityType}`
31
45
  kemOneTimePreKeys = new Map(); // key: `${userId}:${deviceId}:${identityType}`
46
+ consumedKemOneTimePreKeyIds = new Map(); // key: `${userId}:${deviceId}:${identityType}`
32
47
  kemLastResortPreKeys = new Map(); // key: `${userId}:${deviceId}:${identityType}`
33
48
  // Messages/envelopes
34
49
  pendingMessages = new Map(); // key: `${userId}:${deviceId}`
@@ -52,6 +67,9 @@ export class MockSignalRelayServer {
52
67
  groupChangeLogs = new Map(); // key: hex(groupId)
53
68
  // Server secret params for signing and ZK auth (deterministic local seed)
54
69
  serverSecretParams = generateServerSecretParams(new Uint8Array(32));
70
+ constructor(options = {}) {
71
+ this.failures = new MockRelayFailureController(options.failures, (targetKey, envelope) => this.deliverEnvelope(targetKey, envelope), (targetKey) => this.deliverPending(targetKey));
72
+ }
55
73
  /** Build a storage key with explicit identity-type separation. */
56
74
  storageKey(userId, deviceId, identityType = 'aci') {
57
75
  return `${userId}:${deviceId}:${identityType}`;
@@ -68,7 +86,9 @@ export class MockSignalRelayServer {
68
86
  this.ecSignedPreKeys,
69
87
  this.kemLastResortPreKeys,
70
88
  this.ecPreKeys,
89
+ this.consumedEcPreKeyIds,
71
90
  this.kemOneTimePreKeys,
91
+ this.consumedKemOneTimePreKeyIds,
72
92
  this.ecSignedPreKeyMetadata,
73
93
  this.kemLastResortPreKeyMetadata,
74
94
  ];
@@ -86,18 +106,19 @@ export class MockSignalRelayServer {
86
106
  // Envelope Delivery
87
107
  // ============================================================================
88
108
  async send(envelope) {
109
+ await this.failures.waitForLatency();
89
110
  const targetKey = `${envelope.targetUserId}:${envelope.targetDeviceId}`;
90
111
  const receiptKey = envelope.clientMessageId ? `${targetKey}:${envelope.clientMessageId}` : null;
91
112
  if (receiptKey) {
92
113
  const existing = this.clientMessageReceipts.get(receiptKey);
93
114
  if (existing) {
94
- return existing;
115
+ return cloneRelayValue(existing);
95
116
  }
96
117
  }
97
118
  const id = `msg-${++this.messageCounter}`;
98
119
  const serverTimestamp = Date.now();
99
120
  const storedEnvelope = {
100
- ...envelope,
121
+ ...cloneRelayValue(envelope),
101
122
  id,
102
123
  serverTimestamp,
103
124
  };
@@ -105,25 +126,33 @@ export class MockSignalRelayServer {
105
126
  const pending = this.pendingMessages.get(targetKey) || [];
106
127
  pending.push(storedEnvelope);
107
128
  this.pendingMessages.set(targetKey, pending);
108
- // Notify subscribers
109
- const subscribers = this.subscriptions.get(targetKey) || [];
110
- for (const callback of subscribers) {
111
- callback(storedEnvelope);
129
+ // Notify live subscribers through the deterministic failure controller.
130
+ // With no subscriber, the pending mailbox alone owns the envelope.
131
+ if ((this.subscriptions.get(targetKey)?.length ?? 0) > 0) {
132
+ this.failures.deliver(targetKey, storedEnvelope);
112
133
  }
113
134
  if (receiptKey) {
114
135
  this.clientMessageReceipts.set(receiptKey, { messageId: id, serverTimestamp });
115
136
  }
116
- return { messageId: id, serverTimestamp };
137
+ return cloneRelayValue({ messageId: id, serverTimestamp });
117
138
  }
118
139
  subscribe(userId, deviceId, onEnvelope) {
119
140
  const key = `${userId}:${deviceId}`;
120
141
  const subscribers = this.subscriptions.get(key) || [];
142
+ const isFirstSubscriber = subscribers.length === 0;
121
143
  subscribers.push(onEnvelope);
122
144
  this.subscriptions.set(key, subscribers);
123
- // Deliver any pending messages
124
- const pending = this.pendingMessages.get(key) || [];
125
- for (const envelope of pending) {
126
- onEnvelope(envelope);
145
+ // Deliver any pending messages only to the newly added subscriber.
146
+ if (!this.failures.isDisconnected(key)) {
147
+ if (isFirstSubscriber) {
148
+ this.failures.discardReordered(key);
149
+ }
150
+ const pending = this.pendingMessages.get(key) || [];
151
+ for (const envelope of pending) {
152
+ if (this.failures.isReorderBuffered(key, envelope.id))
153
+ continue;
154
+ onEnvelope(cloneRelayValue(envelope));
155
+ }
127
156
  }
128
157
  return () => {
129
158
  const subs = this.subscriptions.get(key) || [];
@@ -150,17 +179,32 @@ export class MockSignalRelayServer {
150
179
  // Device Registry
151
180
  // ============================================================================
152
181
  async getDevices(userId) {
153
- return this.devices.get(userId) || [];
182
+ return cloneRelayValue(this.devices.get(userId) || []);
154
183
  }
155
184
  async registerDevice(userId, device) {
156
185
  const existing = this.devices.get(userId) || [];
157
- // Assign device ID
158
- const deviceId = existing.length === 0 ? 1 : Math.max(...existing.map((d) => d.deviceId)) + 1;
186
+ const occupiedIds = new Set(existing
187
+ .filter((candidate) => candidate.registered)
188
+ .map((candidate) => candidate.deviceId));
189
+ const requestedDeviceId = device.deviceId;
190
+ if (requestedDeviceId !== undefined &&
191
+ (!Number.isInteger(requestedDeviceId) ||
192
+ requestedDeviceId < 1 ||
193
+ requestedDeviceId > MAX_DEVICES)) {
194
+ throw new Error(`Device ID must be between 1 and ${MAX_DEVICES}`);
195
+ }
196
+ const deviceId = requestedDeviceId ??
197
+ Array.from({ length: MAX_DEVICES }, (_, index) => index + 1).find((candidate) => !occupiedIds.has(candidate));
198
+ if (deviceId === undefined || occupiedIds.has(deviceId)) {
199
+ throw new Error('Maximum devices limit reached');
200
+ }
159
201
  const isPrimary = deviceId === 1;
160
202
  const now = Date.now();
161
203
  const deviceInfo = {
162
204
  deviceId,
163
- encryptedDeviceName: device.encryptedDeviceName,
205
+ encryptedDeviceName: device.encryptedDeviceName
206
+ ? cloneRelayValue(device.encryptedDeviceName)
207
+ : undefined,
164
208
  deviceType: device.deviceType,
165
209
  registered: true, // Setup complete
166
210
  linked: isPrimary ? false : true, // Primary is never "linked", secondary is linked
@@ -170,7 +214,13 @@ export class MockSignalRelayServer {
170
214
  createdAt: now,
171
215
  linkedAt: isPrimary ? undefined : now,
172
216
  };
173
- existing.push(deviceInfo);
217
+ const reusableIndex = existing.findIndex((candidate) => candidate.deviceId === deviceId);
218
+ if (reusableIndex >= 0) {
219
+ existing[reusableIndex] = deviceInfo;
220
+ }
221
+ else {
222
+ existing.push(deviceInfo);
223
+ }
174
224
  this.devices.set(userId, existing);
175
225
  return deviceId;
176
226
  }
@@ -189,8 +239,10 @@ export class MockSignalRelayServer {
189
239
  const deviceKey = this.storageKey(userId, deviceId, idType);
190
240
  this.registrationIds.delete(deviceKey);
191
241
  this.ecPreKeys.delete(deviceKey);
242
+ this.consumedEcPreKeyIds.delete(deviceKey);
192
243
  this.ecSignedPreKeys.delete(deviceKey);
193
244
  this.kemOneTimePreKeys.delete(deviceKey);
245
+ this.consumedKemOneTimePreKeyIds.delete(deviceKey);
194
246
  this.kemLastResortPreKeys.delete(deviceKey);
195
247
  this.ecSignedPreKeyMetadata.delete(deviceKey);
196
248
  this.kemLastResortPreKeyMetadata.delete(deviceKey);
@@ -272,7 +324,7 @@ export class MockSignalRelayServer {
272
324
  async getIdentityKey(userId, identityType) {
273
325
  const key = this.identityStorageKey(userId, identityType);
274
326
  const encoded = this.identityKeys.get(key);
275
- return encoded ? decodeCompositeIdentityV1(encoded) : null;
327
+ return encoded ? cloneRelayValue(decodeCompositeIdentityV1(encoded)) : null;
276
328
  }
277
329
  // ============================================================================
278
330
  // Prekey Management
@@ -284,13 +336,22 @@ export class MockSignalRelayServer {
284
336
  for (const preKey of keys) {
285
337
  switch (preKey.type) {
286
338
  case 'ecPreKey': {
339
+ if (this.failures.shouldExhaustOneTimePreKeys())
340
+ break;
341
+ if (this.consumedEcPreKeyIds.get(key)?.has(preKey.keyId))
342
+ break;
287
343
  const existing = this.ecPreKeys.get(key) || [];
288
- existing.push(preKey);
344
+ const stored = cloneRelayValue(preKey);
345
+ const index = existing.findIndex((candidate) => candidate.keyId === stored.keyId);
346
+ if (index >= 0)
347
+ existing[index] = stored;
348
+ else
349
+ existing.push(stored);
289
350
  this.ecPreKeys.set(key, existing);
290
351
  break;
291
352
  }
292
353
  case 'ecSignedPreKey': {
293
- this.ecSignedPreKeys.set(key, preKey);
354
+ this.ecSignedPreKeys.set(key, cloneRelayValue(preKey));
294
355
  // Auto-populate metadata for server key verification
295
356
  this.ecSignedPreKeyMetadata.set(key, {
296
357
  keyId: preKey.keyId,
@@ -301,13 +362,22 @@ export class MockSignalRelayServer {
301
362
  break;
302
363
  }
303
364
  case 'kemOneTimePreKey': {
365
+ if (this.failures.shouldExhaustOneTimePreKeys())
366
+ break;
367
+ if (this.consumedKemOneTimePreKeyIds.get(key)?.has(preKey.keyId))
368
+ break;
304
369
  const existing = this.kemOneTimePreKeys.get(key) || [];
305
- existing.push(preKey);
370
+ const stored = cloneRelayValue(preKey);
371
+ const index = existing.findIndex((candidate) => candidate.keyId === stored.keyId);
372
+ if (index >= 0)
373
+ existing[index] = stored;
374
+ else
375
+ existing.push(stored);
306
376
  this.kemOneTimePreKeys.set(key, existing);
307
377
  break;
308
378
  }
309
379
  case 'kemLastResortPreKey': {
310
- this.kemLastResortPreKeys.set(key, preKey);
380
+ this.kemLastResortPreKeys.set(key, cloneRelayValue(preKey));
311
381
  // Auto-populate metadata for server key verification
312
382
  this.kemLastResortPreKeyMetadata.set(key, {
313
383
  keyId: preKey.keyId,
@@ -336,23 +406,38 @@ export class MockSignalRelayServer {
336
406
  }
337
407
  // Get and consume one-time prekey (optional)
338
408
  const ecPreKeys = this.ecPreKeys.get(deviceKey) || [];
339
- const ecOneTimePreKey = ecPreKeys.length > 0 ? ecPreKeys.shift() : null;
409
+ const exhaustOneTimePreKeys = this.failures.shouldExhaustOneTimePreKeys();
410
+ if (exhaustOneTimePreKeys) {
411
+ this.recordConsumedPreKeyIds(this.consumedEcPreKeyIds, deviceKey, ecPreKeys);
412
+ this.recordConsumedPreKeyIds(this.consumedKemOneTimePreKeyIds, deviceKey, this.kemOneTimePreKeys.get(deviceKey) || []);
413
+ this.ecPreKeys.delete(deviceKey);
414
+ this.kemOneTimePreKeys.delete(deviceKey);
415
+ }
416
+ const ecOneTimePreKey = !exhaustOneTimePreKeys && ecPreKeys.length > 0 ? ecPreKeys.shift() : null;
417
+ if (ecOneTimePreKey) {
418
+ this.recordConsumedPreKeyIds(this.consumedEcPreKeyIds, deviceKey, [ecOneTimePreKey]);
419
+ }
340
420
  if (ecPreKeys.length === 0) {
341
421
  this.ecPreKeys.delete(deviceKey);
342
422
  }
343
423
  // Get KEM one-time prekey (consumed like EC one-time prekeys)
344
424
  // Per PQXDH spec Section 3.2: one-time KEM prekeys provide per-session PQ forward secrecy
345
425
  const kemOneTimePreKeys = this.kemOneTimePreKeys.get(deviceKey) || [];
346
- const kemOneTimePreKey = kemOneTimePreKeys.length > 0 ? kemOneTimePreKeys.shift() : null;
426
+ const kemOneTimePreKey = !exhaustOneTimePreKeys && kemOneTimePreKeys.length > 0
427
+ ? kemOneTimePreKeys.shift()
428
+ : null;
429
+ if (kemOneTimePreKey) {
430
+ this.recordConsumedPreKeyIds(this.consumedKemOneTimePreKeyIds, deviceKey, [kemOneTimePreKey]);
431
+ }
347
432
  if (kemOneTimePreKeys.length === 0) {
348
433
  this.kemOneTimePreKeys.delete(deviceKey);
349
434
  }
350
435
  // Get last-resort Kyber prekey (always returned if available)
351
436
  // This is SEPARATE from the one-time KEM prekeys
352
437
  const kemLastResortPreKey = this.kemLastResortPreKeys.get(deviceKey) || null;
353
- // Cast to branded types - ISignalRelayServer returns PreKeyBundle with branded types
438
+ // Cast to branded types - ISignalProtocolRelayServer returns PreKeyBundle with branded types
354
439
  // Adapters handle the casting internally so callers don't need to
355
- return {
440
+ return cloneRelayValue({
356
441
  registrationId,
357
442
  deviceId,
358
443
  identity: decodeCompositeIdentityV1(encodedIdentity),
@@ -381,7 +466,7 @@ export class MockSignalRelayServer {
381
466
  signature: kemOneTimePreKey.signature,
382
467
  }
383
468
  : null,
384
- };
469
+ });
385
470
  }
386
471
  async getPreKeyCount(userId, deviceId, type, identityType) {
387
472
  const key = this.storageKey(userId, deviceId, identityType);
@@ -423,15 +508,13 @@ export class MockSignalRelayServer {
423
508
  ], identityType);
424
509
  }
425
510
  async getGroupMembers(groupId) {
426
- return this.groupMembers.get(groupId) || [];
511
+ return cloneRelayValue(this.groupMembers.get(groupId) || []);
427
512
  }
428
513
  async getActiveDevices(userId) {
429
514
  const deviceInfos = this.devices.get(userId) || [];
430
- if (deviceInfos.length > 0) {
431
- return deviceInfos.map((d) => ({ userId, deviceId: d.deviceId }));
432
- }
433
- // Default to device 1 if no devices registered
434
- return [{ userId, deviceId: 1 }];
515
+ return deviceInfos
516
+ .filter((device) => device.registered && device.enabled)
517
+ .map((device) => ({ userId, deviceId: device.deviceId }));
435
518
  }
436
519
  // ============================================================================
437
520
  // Provisioning Service (IProvisioningService)
@@ -478,7 +561,7 @@ export class MockSignalRelayServer {
478
561
  throw new Error(`Provisioning session ${sessionId} is not in waiting state`);
479
562
  }
480
563
  session.newDeviceEphemeralPublicKey = ephemeralPublicKey;
481
- session.deviceMetadata = deviceMetadata;
564
+ session.deviceMetadata = cloneRelayValue(deviceMetadata);
482
565
  session.status = 'connected';
483
566
  }
484
567
  async sendProvisioningMessage(sessionId, encryptedMessage, _userId) {
@@ -531,7 +614,7 @@ export class MockSignalRelayServer {
531
614
  const reusableDevice = existingDevices.find((device) => device.deviceId === session.assignedDeviceId);
532
615
  const nextState = {
533
616
  deviceId: session.assignedDeviceId,
534
- encryptedDeviceName: deviceMetadata.encryptedDeviceName,
617
+ encryptedDeviceName: cloneRelayValue(deviceMetadata.encryptedDeviceName),
535
618
  deviceType: 'mobile',
536
619
  registered: true,
537
620
  linked: true,
@@ -584,11 +667,13 @@ export class MockSignalRelayServer {
584
667
  // ============================================================================
585
668
  async getEcSignedPreKeyMetadata(userId, deviceId, identityType) {
586
669
  const key = this.storageKey(userId, deviceId, identityType);
587
- return this.ecSignedPreKeyMetadata.get(key) || null;
670
+ const metadata = this.ecSignedPreKeyMetadata.get(key);
671
+ return metadata ? cloneRelayValue(metadata) : null;
588
672
  }
589
673
  async getKemLastResortPreKeyMetadata(userId, deviceId, identityType) {
590
674
  const key = this.storageKey(userId, deviceId, identityType);
591
- return this.kemLastResortPreKeyMetadata.get(key) || null;
675
+ const metadata = this.kemLastResortPreKeyMetadata.get(key);
676
+ return metadata ? cloneRelayValue(metadata) : null;
592
677
  }
593
678
  // ============================================================================
594
679
  // Sealed Sender (Anonymous Delivery)
@@ -608,6 +693,9 @@ export class MockSignalRelayServer {
608
693
  * Same as send() but without sender identification.
609
694
  */
610
695
  async sendUnidentified(envelope, auth) {
696
+ if (this.failures.shouldRejectAuthorization()) {
697
+ throw new SealedSenderAuthError();
698
+ }
611
699
  // Mock: pass through without validation; callers can override if needed.
612
700
  void auth; // Accept but don't validate in mock
613
701
  return this.send({
@@ -669,12 +757,12 @@ export class MockSignalRelayServer {
669
757
  async sendRetryRequest(request) {
670
758
  const key = `${request.originalSenderUserId}:${request.originalSenderDeviceId}`;
671
759
  const existing = this.retryRequests.get(key) || [];
672
- existing.push(request);
760
+ existing.push(cloneRelayValue(request));
673
761
  this.retryRequests.set(key, existing);
674
762
  // Notify subscribers
675
763
  const subscribers = this.retryRequestSubscriptions.get(key) || [];
676
764
  for (const handler of subscribers) {
677
- await handler(request);
765
+ await handler(cloneRelayValue(request));
678
766
  }
679
767
  }
680
768
  subscribeRetryRequests(userId, deviceId, handler) {
@@ -685,7 +773,7 @@ export class MockSignalRelayServer {
685
773
  // Deliver any pending retry requests
686
774
  const pending = this.retryRequests.get(key) || [];
687
775
  for (const request of pending) {
688
- handler(request);
776
+ handler(cloneRelayValue(request));
689
777
  }
690
778
  return () => {
691
779
  const subs = this.retryRequestSubscriptions.get(key) || [];
@@ -700,17 +788,18 @@ export class MockSignalRelayServer {
700
788
  // ============================================================================
701
789
  async createGroupState(groupId, encryptedState, _authorization) {
702
790
  const key = this.groupIdToHex(groupId);
703
- this.groupStates.set(key, { encryptedState, version: 0 });
791
+ this.groupStates.set(key, { encryptedState: cloneRelayValue(encryptedState), version: 0 });
704
792
  this.groupChangeLogs.set(key, []);
705
793
  }
706
794
  async getGroupState(groupId, _authorization) {
707
795
  const key = this.groupIdToHex(groupId);
708
- return this.groupStates.get(key) ?? null;
796
+ const state = this.groupStates.get(key);
797
+ return state ? cloneRelayValue(state) : null;
709
798
  }
710
799
  async getGroupChanges(groupId, fromVersion, _authorization) {
711
800
  const key = this.groupIdToHex(groupId);
712
801
  const changes = this.groupChangeLogs.get(key) ?? [];
713
- return changes.filter((c) => c.version > fromVersion);
802
+ return cloneRelayValue(changes.filter((c) => c.version > fromVersion));
714
803
  }
715
804
  async submitGroupChange(groupId, expectedVersion, encryptedChange, updatedEncryptedState, _authorization) {
716
805
  const key = this.groupIdToHex(groupId);
@@ -726,16 +815,16 @@ export class MockSignalRelayServer {
726
815
  const serverSignature = serverSign(this.serverSecretParams, randomness, encryptedChange);
727
816
  const entry = {
728
817
  version: newVersion,
729
- encryptedChange,
818
+ encryptedChange: cloneRelayValue(encryptedChange),
730
819
  serverSignature,
731
820
  timestamp: Date.now(),
732
821
  };
733
- current.encryptedState = updatedEncryptedState;
822
+ current.encryptedState = cloneRelayValue(updatedEncryptedState);
734
823
  current.version = newVersion;
735
824
  const changes = this.groupChangeLogs.get(key) ?? [];
736
- changes.push(entry);
825
+ changes.push(cloneRelayValue(entry));
737
826
  this.groupChangeLogs.set(key, changes);
738
- return { serverSignature };
827
+ return cloneRelayValue({ serverSignature });
739
828
  }
740
829
  // ============================================================================
741
830
  // ZK Auth Credentials (anonymous group access)
@@ -824,10 +913,13 @@ export class MockSignalRelayServer {
824
913
  this.identityKeys.clear();
825
914
  this.registrationIds.clear();
826
915
  this.ecPreKeys.clear();
916
+ this.consumedEcPreKeyIds.clear();
827
917
  this.ecSignedPreKeys.clear();
828
918
  this.kemOneTimePreKeys.clear();
919
+ this.consumedKemOneTimePreKeyIds.clear();
829
920
  this.kemLastResortPreKeys.clear();
830
921
  this.pendingMessages.clear();
922
+ this.clientMessageReceipts.clear();
831
923
  this.subscriptions.clear();
832
924
  this.groupMembers.clear();
833
925
  this.provisioningSessions.clear();
@@ -839,6 +931,7 @@ export class MockSignalRelayServer {
839
931
  this.groupChangeLogs.clear();
840
932
  this.userIdentities.clear();
841
933
  this.senderCertificates.clear();
934
+ this.failures.reset();
842
935
  this.messageCounter = 0;
843
936
  this.provisioningCounter = 0;
844
937
  }
@@ -846,21 +939,21 @@ export class MockSignalRelayServer {
846
939
  * Set group members for deterministic local setup.
847
940
  */
848
941
  setGroupMembers(groupId, members) {
849
- this.groupMembers.set(groupId, members);
942
+ this.groupMembers.set(groupId, cloneRelayValue(members));
850
943
  }
851
944
  /**
852
945
  * Inspect pending messages for a device.
853
946
  */
854
947
  getPendingMessages(userId, deviceId) {
855
948
  const key = `${userId}:${deviceId}`;
856
- return this.pendingMessages.get(key) || [];
949
+ return cloneRelayValue(this.pendingMessages.get(key) || []);
857
950
  }
858
951
  /**
859
952
  * Inspect pending retry requests for a device.
860
953
  */
861
954
  getPendingRetryRequests(userId, deviceId) {
862
955
  const key = `${userId}:${deviceId}`;
863
- return this.retryRequests.get(key) || [];
956
+ return cloneRelayValue(this.retryRequests.get(key) || []);
864
957
  }
865
958
  /**
866
959
  * Mark a retry request as handled (remove from pending)
@@ -881,14 +974,14 @@ export class MockSignalRelayServer {
881
974
  */
882
975
  setEcSignedPreKeyMetadata(userId, deviceId, metadata, identityType = 'aci') {
883
976
  const key = this.storageKey(userId, deviceId, identityType);
884
- this.ecSignedPreKeyMetadata.set(key, metadata);
977
+ this.ecSignedPreKeyMetadata.set(key, cloneRelayValue(metadata));
885
978
  }
886
979
  /**
887
980
  * Set Kyber prekey metadata for deterministic key rotation.
888
981
  */
889
982
  setKemLastResortPreKeyMetadata(userId, deviceId, metadata, identityType = 'aci') {
890
983
  const key = this.storageKey(userId, deviceId, identityType);
891
- this.kemLastResortPreKeyMetadata.set(key, metadata);
984
+ this.kemLastResortPreKeyMetadata.set(key, cloneRelayValue(metadata));
892
985
  }
893
986
  /**
894
987
  * Set the prekey count for deterministic key rotation.
@@ -910,20 +1003,46 @@ export class MockSignalRelayServer {
910
1003
  publicKey: `placeholder-${i}`,
911
1004
  }));
912
1005
  if (type === 'ec') {
1006
+ this.consumedEcPreKeyIds.delete(key);
913
1007
  this.ecPreKeys.set(key, placeholderKeys);
914
1008
  }
915
1009
  else {
1010
+ this.consumedKemOneTimePreKeyIds.delete(key);
916
1011
  this.kemOneTimePreKeys.set(key, placeholderKeys);
917
1012
  }
918
1013
  }
919
1014
  // ============================================================================
920
1015
  // Utility Methods
921
1016
  // ============================================================================
1017
+ recordConsumedPreKeyIds(consumed, storageKey, preKeys) {
1018
+ if (preKeys.length === 0)
1019
+ return;
1020
+ const keyIds = consumed.get(storageKey) || new Set();
1021
+ for (const preKey of preKeys) {
1022
+ keyIds.add(preKey.keyId);
1023
+ }
1024
+ consumed.set(storageKey, keyIds);
1025
+ }
922
1026
  groupIdToHex(groupId) {
923
1027
  return Array.from(groupId)
924
1028
  .map((b) => b.toString(16).padStart(2, '0'))
925
1029
  .join('');
926
1030
  }
1031
+ deliverEnvelope(targetKey, envelope) {
1032
+ const subscribers = this.subscriptions.get(targetKey) || [];
1033
+ for (const callback of subscribers) {
1034
+ callback(cloneRelayValue(envelope));
1035
+ }
1036
+ }
1037
+ deliverPending(targetKey) {
1038
+ if (this.failures.isDisconnected(targetKey))
1039
+ return;
1040
+ this.failures.discardReordered(targetKey);
1041
+ const pending = this.pendingMessages.get(targetKey) || [];
1042
+ for (const envelope of pending) {
1043
+ this.failures.deliver(targetKey, envelope);
1044
+ }
1045
+ }
927
1046
  uint8ArrayToBase64(data) {
928
1047
  if (typeof Buffer !== 'undefined') {
929
1048
  return Buffer.from(data).toString('base64');