@open-e2ee/signal-protocol-sdk 0.2.3 → 0.3.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 (601) hide show
  1. package/ADAPTERS.md +4 -4
  2. package/ARCHITECTURE.md +17 -16
  3. package/CHANGELOG.md +39 -0
  4. package/COMMERCIAL.md +6 -6
  5. package/NOTICE +1 -1
  6. package/README.md +44 -34
  7. package/SECURITY.md +16 -13
  8. package/TROUBLESHOOTING.md +5 -5
  9. package/blocking/README.md +6 -5
  10. package/client/README.md +5 -5
  11. package/device/README.md +8 -8
  12. package/dist/blocking/types.d.ts +2 -2
  13. package/dist/blocking/types.js +2 -2
  14. package/dist/client/client.d.ts +46 -45
  15. package/dist/client/client.d.ts.map +1 -1
  16. package/dist/client/client.js +61 -60
  17. package/dist/client/client.js.map +1 -1
  18. package/dist/client/config.d.ts +32 -32
  19. package/dist/client/constants.d.ts +7 -6
  20. package/dist/client/constants.d.ts.map +1 -1
  21. package/dist/client/constants.js +5 -4
  22. package/dist/client/constants.js.map +1 -1
  23. package/dist/client/dual-store.d.ts +2 -2
  24. package/dist/client/dual-store.js +2 -2
  25. package/dist/client/endorsement-manager.d.ts +14 -14
  26. package/dist/client/endorsement-manager.d.ts.map +1 -1
  27. package/dist/client/endorsement-manager.js +15 -15
  28. package/dist/client/endorsement-manager.js.map +1 -1
  29. package/dist/client/event-hooks.d.ts +16 -16
  30. package/dist/client/event-hooks.d.ts.map +1 -1
  31. package/dist/client/event-hooks.js +1 -1
  32. package/dist/client/event-hooks.js.map +1 -1
  33. package/dist/client/files.js +4 -4
  34. package/dist/client/files.js.map +1 -1
  35. package/dist/client/headless.d.ts +7 -7
  36. package/dist/client/headless.d.ts.map +1 -1
  37. package/dist/client/headless.js +4 -4
  38. package/dist/client/key-rotation-core.d.ts +19 -17
  39. package/dist/client/key-rotation-core.d.ts.map +1 -1
  40. package/dist/client/key-rotation-core.js +35 -31
  41. package/dist/client/key-rotation-core.js.map +1 -1
  42. package/dist/client/key-rotation.d.ts +8 -8
  43. package/dist/client/key-rotation.js +8 -8
  44. package/dist/client/media.d.ts +1 -1
  45. package/dist/client/messages.d.ts.map +1 -1
  46. package/dist/client/messages.js +13 -11
  47. package/dist/client/messages.js.map +1 -1
  48. package/dist/client/multi-device.d.ts +5 -4
  49. package/dist/client/multi-device.d.ts.map +1 -1
  50. package/dist/client/multi-device.js.map +1 -1
  51. package/dist/client/prekeys.d.ts +7 -7
  52. package/dist/client/prekeys.js +10 -10
  53. package/dist/client/prekeys.js.map +1 -1
  54. package/dist/client/relay-subscription.d.ts +3 -0
  55. package/dist/client/relay-subscription.d.ts.map +1 -1
  56. package/dist/client/relay-subscription.js +7 -4
  57. package/dist/client/relay-subscription.js.map +1 -1
  58. package/dist/client/retry-utils.d.ts +5 -6
  59. package/dist/client/retry-utils.d.ts.map +1 -1
  60. package/dist/client/retry-utils.js +5 -12
  61. package/dist/client/retry-utils.js.map +1 -1
  62. package/dist/client/retry.js +7 -7
  63. package/dist/client/retry.js.map +1 -1
  64. package/dist/client/sealed-sender-ops.d.ts +3 -3
  65. package/dist/client/sealed-sender-ops.js +5 -5
  66. package/dist/client/sealed-sender-ops.js.map +1 -1
  67. package/dist/client/sessions.d.ts +2 -2
  68. package/dist/client/sessions.js +2 -2
  69. package/dist/client/signal-service-cipher.d.ts +9 -9
  70. package/dist/client/signal-service-cipher.d.ts.map +1 -1
  71. package/dist/client/signal-service-cipher.js +41 -40
  72. package/dist/client/signal-service-cipher.js.map +1 -1
  73. package/dist/client/state.d.ts +1 -1
  74. package/dist/client/state.js +1 -1
  75. package/dist/client/types.d.ts +19 -19
  76. package/dist/client/types.d.ts.map +1 -1
  77. package/dist/device/connection.d.ts +1 -1
  78. package/dist/device/connection.js +2 -2
  79. package/dist/device/connection.js.map +1 -1
  80. package/dist/device/constants.d.ts +4 -4
  81. package/dist/device/constants.js +3 -3
  82. package/dist/device/device-id.d.ts +4 -4
  83. package/dist/device/device-id.js +4 -4
  84. package/dist/device/expo-metadata.d.ts +13 -11
  85. package/dist/device/expo-metadata.d.ts.map +1 -1
  86. package/dist/device/expo-metadata.js +13 -11
  87. package/dist/device/expo-metadata.js.map +1 -1
  88. package/dist/device/lifecycle/manager.d.ts +6 -6
  89. package/dist/device/lifecycle/manager.js +7 -7
  90. package/dist/device/lifecycle/types.d.ts +13 -13
  91. package/dist/device/lifecycle/types.d.ts.map +1 -1
  92. package/dist/device/lifecycle/utils.d.ts +2 -2
  93. package/dist/device/lifecycle/utils.js +5 -5
  94. package/dist/device/lifecycle/utils.js.map +1 -1
  95. package/dist/device/provisioning.d.ts +5 -4
  96. package/dist/device/provisioning.d.ts.map +1 -1
  97. package/dist/device/provisioning.js +5 -4
  98. package/dist/device/provisioning.js.map +1 -1
  99. package/dist/device/transfer.d.ts +2 -2
  100. package/dist/device/transfer.js +3 -3
  101. package/dist/device/transfer.js.map +1 -1
  102. package/dist/encoding/index.d.ts +3 -4
  103. package/dist/encoding/index.d.ts.map +1 -1
  104. package/dist/encoding/index.js.map +1 -1
  105. package/dist/files/index.d.ts +1 -1
  106. package/dist/files/index.js +1 -1
  107. package/dist/hooks/use-connection-presence.d.ts +1 -1
  108. package/dist/hooks/use-connection-presence.js +7 -7
  109. package/dist/hooks/use-connection-presence.js.map +1 -1
  110. package/dist/hooks/use-group-membership.d.ts +2 -2
  111. package/dist/hooks/use-group-membership.d.ts.map +1 -1
  112. package/dist/hooks/use-group-membership.js +6 -6
  113. package/dist/hooks/use-group-membership.js.map +1 -1
  114. package/dist/hooks/use-key-rotation.js +3 -3
  115. package/dist/hooks/use-key-rotation.js.map +1 -1
  116. package/dist/hooks/use-single-flight.d.ts +2 -2
  117. package/dist/hooks/use-single-flight.js +1 -1
  118. package/dist/index.d.ts +4 -3
  119. package/dist/index.d.ts.map +1 -1
  120. package/dist/index.js +22 -4
  121. package/dist/index.js.map +1 -1
  122. package/dist/internal/crypto/ec/ed25519.d.ts +6 -6
  123. package/dist/internal/crypto/ec/ed25519.js +6 -6
  124. package/dist/internal/crypto/ec/x25519-validation.d.ts.map +1 -1
  125. package/dist/internal/crypto/ec/x25519-validation.js +4 -2
  126. package/dist/internal/crypto/ec/x25519-validation.js.map +1 -1
  127. package/dist/internal/crypto/index.d.ts +2 -0
  128. package/dist/internal/crypto/index.d.ts.map +1 -1
  129. package/dist/internal/crypto/index.js +2 -0
  130. package/dist/internal/crypto/index.js.map +1 -1
  131. package/dist/internal/crypto/kdf/hkdf.d.ts +9 -8
  132. package/dist/internal/crypto/kdf/hkdf.d.ts.map +1 -1
  133. package/dist/internal/crypto/kdf/hkdf.js +11 -10
  134. package/dist/internal/crypto/kdf/hkdf.js.map +1 -1
  135. package/dist/internal/crypto/key-prefix.d.ts +3 -3
  136. package/dist/internal/crypto/key-prefix.js +3 -3
  137. package/dist/internal/crypto/pq/kyber.d.ts +7 -7
  138. package/dist/internal/crypto/pq/kyber.js +10 -10
  139. package/dist/internal/crypto/pq/kyber.js.map +1 -1
  140. package/dist/internal/crypto/random.d.ts +1 -1
  141. package/dist/internal/crypto/random.js +1 -1
  142. package/dist/internal/crypto/symmetric/aes-gcm-siv.js +1 -1
  143. package/dist/internal/crypto/symmetric/aes.js +4 -4
  144. package/dist/internal/crypto/symmetric/aes.js.map +1 -1
  145. package/dist/internal/crypto/symmetric/mac.d.ts +1 -1
  146. package/dist/internal/crypto/symmetric/mac.js +3 -3
  147. package/dist/internal/crypto/symmetric/padding.js +1 -1
  148. package/dist/internal/crypto/symmetric/padding.js.map +1 -1
  149. package/dist/internal/crypto/symmetric/streaming-aead.d.ts +7 -1
  150. package/dist/internal/crypto/symmetric/streaming-aead.d.ts.map +1 -1
  151. package/dist/internal/crypto/symmetric/streaming-aead.js +10 -4
  152. package/dist/internal/crypto/symmetric/streaming-aead.js.map +1 -1
  153. package/dist/internal/crypto/utils.d.ts +2 -2
  154. package/dist/internal/crypto/utils.d.ts.map +1 -1
  155. package/dist/internal/crypto/utils.js +16 -14
  156. package/dist/internal/crypto/utils.js.map +1 -1
  157. package/dist/internal/crypto/validation.d.ts +4 -4
  158. package/dist/internal/crypto/validation.js +2 -2
  159. package/dist/internal/encoding/proto/envelope.d.ts +1 -1
  160. package/dist/internal/encoding/proto/envelope.js +1 -1
  161. package/dist/internal/encoding/proto/index.d.ts +4 -4
  162. package/dist/internal/encoding/proto/index.js +4 -4
  163. package/dist/internal/encoding/proto/pq-ratchet-serialize.d.ts +28 -16
  164. package/dist/internal/encoding/proto/pq-ratchet-serialize.d.ts.map +1 -1
  165. package/dist/internal/encoding/proto/pq-ratchet-serialize.js +30 -18
  166. package/dist/internal/encoding/proto/pq-ratchet-serialize.js.map +1 -1
  167. package/dist/internal/encoding/proto/primitives.d.ts +45 -35
  168. package/dist/internal/encoding/proto/primitives.d.ts.map +1 -1
  169. package/dist/internal/encoding/proto/primitives.js +54 -43
  170. package/dist/internal/encoding/proto/primitives.js.map +1 -1
  171. package/dist/internal/encoding/proto/sender-key-message.d.ts +2 -2
  172. package/dist/internal/encoding/proto/sender-key-message.js +2 -2
  173. package/dist/internal/encoding/proto/signal-message.d.ts +13 -13
  174. package/dist/internal/encoding/proto/signal-message.d.ts.map +1 -1
  175. package/dist/internal/encoding/proto/signal-message.js +13 -13
  176. package/dist/internal/encoding/proto/signal-message.js.map +1 -1
  177. package/dist/internal/groups/access-control.d.ts +5 -5
  178. package/dist/internal/groups/access-control.js +6 -6
  179. package/dist/internal/groups/access-control.js.map +1 -1
  180. package/dist/internal/groups/change-actions.d.ts +4 -4
  181. package/dist/internal/groups/change-actions.js +3 -3
  182. package/dist/internal/groups/encrypted-state.js +1 -1
  183. package/dist/internal/groups/encrypted-state.js.map +1 -1
  184. package/dist/internal/groups/group-id.d.ts +1 -1
  185. package/dist/internal/groups/manager.d.ts +24 -23
  186. package/dist/internal/groups/manager.d.ts.map +1 -1
  187. package/dist/internal/groups/manager.js +40 -36
  188. package/dist/internal/groups/manager.js.map +1 -1
  189. package/dist/internal/groups/server-engine.d.ts +29 -21
  190. package/dist/internal/groups/server-engine.d.ts.map +1 -1
  191. package/dist/internal/groups/server-engine.js +55 -50
  192. package/dist/internal/groups/server-engine.js.map +1 -1
  193. package/dist/internal/groups/trust-root.d.ts +2 -2
  194. package/dist/internal/groups/trust-root.js +2 -2
  195. package/dist/internal/groups/types.d.ts +4 -4
  196. package/dist/internal/groups/types.d.ts.map +1 -1
  197. package/dist/internal/groups/wire.d.ts +6 -7
  198. package/dist/internal/groups/wire.d.ts.map +1 -1
  199. package/dist/internal/groups/wire.js +6 -7
  200. package/dist/internal/groups/wire.js.map +1 -1
  201. package/dist/internal/manager/manager.d.ts +14 -12
  202. package/dist/internal/manager/manager.d.ts.map +1 -1
  203. package/dist/internal/manager/manager.js +47 -41
  204. package/dist/internal/manager/manager.js.map +1 -1
  205. package/dist/internal/protocol/double-ratchet/chains.d.ts +8 -6
  206. package/dist/internal/protocol/double-ratchet/chains.d.ts.map +1 -1
  207. package/dist/internal/protocol/double-ratchet/chains.js +10 -8
  208. package/dist/internal/protocol/double-ratchet/chains.js.map +1 -1
  209. package/dist/internal/protocol/double-ratchet/index.d.ts +2 -2
  210. package/dist/internal/protocol/double-ratchet/index.js +2 -2
  211. package/dist/internal/protocol/double-ratchet/ratchet.d.ts +4 -4
  212. package/dist/internal/protocol/double-ratchet/ratchet.js +6 -6
  213. package/dist/internal/protocol/pqxdh/pqxdh.d.ts +21 -18
  214. package/dist/internal/protocol/pqxdh/pqxdh.d.ts.map +1 -1
  215. package/dist/internal/protocol/pqxdh/pqxdh.js +48 -42
  216. package/dist/internal/protocol/pqxdh/pqxdh.js.map +1 -1
  217. package/dist/internal/protocol/sealed-sender/decryption-v2.js +5 -5
  218. package/dist/internal/protocol/sealed-sender/decryption-v2.js.map +1 -1
  219. package/dist/internal/protocol/sealed-sender/decryption.d.ts.map +1 -1
  220. package/dist/internal/protocol/sealed-sender/decryption.js +11 -8
  221. package/dist/internal/protocol/sealed-sender/decryption.js.map +1 -1
  222. package/dist/internal/protocol/sealed-sender/delivery-token.d.ts +2 -2
  223. package/dist/internal/protocol/sealed-sender/delivery-token.js +2 -2
  224. package/dist/internal/protocol/sealed-sender/encryption-v2.js +1 -1
  225. package/dist/internal/protocol/sealed-sender/encryption-v2.js.map +1 -1
  226. package/dist/internal/protocol/sealed-sender/encryption.d.ts +2 -2
  227. package/dist/internal/protocol/sealed-sender/encryption.js +2 -2
  228. package/dist/internal/protocol/sealed-sender/proto/index.d.ts +25 -23
  229. package/dist/internal/protocol/sealed-sender/proto/index.d.ts.map +1 -1
  230. package/dist/internal/protocol/sealed-sender/proto/index.js +32 -30
  231. package/dist/internal/protocol/sealed-sender/proto/index.js.map +1 -1
  232. package/dist/internal/protocol/sealed-sender/trust-root.d.ts +10 -9
  233. package/dist/internal/protocol/sealed-sender/trust-root.d.ts.map +1 -1
  234. package/dist/internal/protocol/sealed-sender/trust-root.js +10 -9
  235. package/dist/internal/protocol/sealed-sender/trust-root.js.map +1 -1
  236. package/dist/internal/protocol/sealed-sender/types.d.ts +13 -14
  237. package/dist/internal/protocol/sealed-sender/types.d.ts.map +1 -1
  238. package/dist/internal/protocol/sealed-sender/types.js +7 -8
  239. package/dist/internal/protocol/sealed-sender/types.js.map +1 -1
  240. package/dist/internal/protocol/sealed-sender/v2-binary.d.ts +1 -1
  241. package/dist/internal/protocol/sealed-sender/v2-binary.js +2 -2
  242. package/dist/internal/protocol/sealed-sender/v2-binary.js.map +1 -1
  243. package/dist/internal/protocol/sender-keys/manager.d.ts +16 -14
  244. package/dist/internal/protocol/sender-keys/manager.d.ts.map +1 -1
  245. package/dist/internal/protocol/sender-keys/manager.js +37 -34
  246. package/dist/internal/protocol/sender-keys/manager.js.map +1 -1
  247. package/dist/internal/protocol/spqr/braid-serialize.d.ts +6 -6
  248. package/dist/internal/protocol/spqr/braid-serialize.js +5 -5
  249. package/dist/internal/protocol/spqr/braid-serialize.js.map +1 -1
  250. package/dist/internal/protocol/spqr/braid.d.ts +3 -3
  251. package/dist/internal/protocol/spqr/braid.js +7 -7
  252. package/dist/internal/protocol/spqr/braid.js.map +1 -1
  253. package/dist/internal/protocol/spqr/index.js +1 -1
  254. package/dist/internal/protocol/spqr/index.js.map +1 -1
  255. package/dist/internal/protocol/spqr/ml-kem-braid/chunk-domain.d.ts +3 -3
  256. package/dist/internal/protocol/spqr/ml-kem-braid/chunk-domain.js +3 -3
  257. package/dist/internal/protocol/spqr/ml-kem-braid/incremental-kem.js +1 -1
  258. package/dist/internal/protocol/spqr/ml-kem-braid/incremental-kem.js.map +1 -1
  259. package/dist/internal/protocol/spqr/ml-kem-braid/kdf.d.ts +1 -1
  260. package/dist/internal/protocol/spqr/ml-kem-braid/kdf.js +1 -1
  261. package/dist/internal/protocol/spqr/ml-kem-braid/kdf.js.map +1 -1
  262. package/dist/internal/protocol/spqr/ml-kem-braid/noble-pq/arithmetic.d.ts +4 -3
  263. package/dist/internal/protocol/spqr/ml-kem-braid/noble-pq/arithmetic.d.ts.map +1 -1
  264. package/dist/internal/protocol/spqr/ml-kem-braid/noble-pq/arithmetic.js +4 -3
  265. package/dist/internal/protocol/spqr/ml-kem-braid/noble-pq/arithmetic.js.map +1 -1
  266. package/dist/internal/protocol/spqr/ml-kem-braid/noble-pq/index.js +2 -2
  267. package/dist/internal/protocol/spqr/ml-kem-braid/progress.d.ts +1 -1
  268. package/dist/internal/protocol/spqr/ml-kem-braid/progress.js +1 -1
  269. package/dist/internal/protocol/spqr/ml-kem-braid/rs/codec.d.ts +15 -7
  270. package/dist/internal/protocol/spqr/ml-kem-braid/rs/codec.d.ts.map +1 -1
  271. package/dist/internal/protocol/spqr/ml-kem-braid/rs/codec.js +15 -7
  272. package/dist/internal/protocol/spqr/ml-kem-braid/rs/codec.js.map +1 -1
  273. package/dist/internal/protocol/spqr/ml-kem-braid/rs/galois/field.js +1 -1
  274. package/dist/internal/protocol/spqr/ml-kem-braid/rs/polynomial.d.ts +3 -3
  275. package/dist/internal/protocol/spqr/ml-kem-braid/rs/polynomial.js +1 -1
  276. package/dist/internal/protocol/spqr/ml-kem-braid/serialize.d.ts +7 -7
  277. package/dist/internal/protocol/spqr/ml-kem-braid/serialize.js +11 -11
  278. package/dist/internal/protocol/spqr/ml-kem-braid/serialize.js.map +1 -1
  279. package/dist/internal/protocol/spqr/ml-kem-braid/state-machine.d.ts +1 -1
  280. package/dist/internal/protocol/spqr/ml-kem-braid/state-machine.js +6 -6
  281. package/dist/internal/protocol/spqr/ml-kem-braid/state-machine.js.map +1 -1
  282. package/dist/internal/protocol/spqr/ml-kem-braid/types.d.ts +2 -2
  283. package/dist/internal/protocol/spqr/ml-kem-braid/types.d.ts.map +1 -1
  284. package/dist/internal/protocol/spqr/ml-kem-braid/types.js.map +1 -1
  285. package/dist/internal/protocol/spqr/serialize.d.ts +12 -12
  286. package/dist/internal/protocol/spqr/serialize.js +5 -5
  287. package/dist/internal/protocol/spqr/spqr.d.ts +6 -6
  288. package/dist/internal/protocol/spqr/spqr.d.ts.map +1 -1
  289. package/dist/internal/protocol/spqr/spqr.js +47 -42
  290. package/dist/internal/protocol/spqr/spqr.js.map +1 -1
  291. package/dist/internal/protocol/spqr/validate.d.ts +1 -1
  292. package/dist/internal/protocol/triple-ratchet/ratchet.d.ts +12 -12
  293. package/dist/internal/protocol/triple-ratchet/ratchet.d.ts.map +1 -1
  294. package/dist/internal/protocol/triple-ratchet/ratchet.js +11 -11
  295. package/dist/internal/protocol/triple-ratchet/ratchet.js.map +1 -1
  296. package/dist/internal/protocol/username/hash.d.ts.map +1 -1
  297. package/dist/internal/protocol/username/hash.js +6 -4
  298. package/dist/internal/protocol/username/hash.js.map +1 -1
  299. package/dist/internal/protocol/version.d.ts +3 -3
  300. package/dist/internal/protocol/version.js +1 -1
  301. package/dist/internal/protocol/x3dh/x3dh.d.ts +16 -16
  302. package/dist/internal/protocol/x3dh/x3dh.d.ts.map +1 -1
  303. package/dist/internal/protocol/x3dh/x3dh.js +15 -15
  304. package/dist/internal/protocol/x3dh/x3dh.js.map +1 -1
  305. package/dist/internal/protocol/zk/credentials/attributes.d.ts +7 -7
  306. package/dist/internal/protocol/zk/credentials/attributes.js +7 -7
  307. package/dist/internal/protocol/zk/credentials/credentials.d.ts +1 -1
  308. package/dist/internal/protocol/zk/credentials/credentials.js +1 -1
  309. package/dist/internal/protocol/zk/credentials/endorsements.d.ts +11 -11
  310. package/dist/internal/protocol/zk/credentials/endorsements.js +14 -14
  311. package/dist/internal/protocol/zk/credentials/issuance.d.ts +5 -1
  312. package/dist/internal/protocol/zk/credentials/issuance.d.ts.map +1 -1
  313. package/dist/internal/protocol/zk/credentials/issuance.js +5 -1
  314. package/dist/internal/protocol/zk/credentials/issuance.js.map +1 -1
  315. package/dist/internal/protocol/zk/credentials/presentation.d.ts +16 -16
  316. package/dist/internal/protocol/zk/credentials/presentation.d.ts.map +1 -1
  317. package/dist/internal/protocol/zk/credentials/presentation.js +18 -18
  318. package/dist/internal/protocol/zk/credentials/presentation.js.map +1 -1
  319. package/dist/internal/protocol/zk/groups/auth-credential.d.ts +22 -16
  320. package/dist/internal/protocol/zk/groups/auth-credential.d.ts.map +1 -1
  321. package/dist/internal/protocol/zk/groups/auth-credential.js +19 -14
  322. package/dist/internal/protocol/zk/groups/auth-credential.js.map +1 -1
  323. package/dist/internal/protocol/zk/groups/client-zk-group-cipher.d.ts +4 -4
  324. package/dist/internal/protocol/zk/groups/client-zk-group-cipher.js +4 -4
  325. package/dist/internal/protocol/zk/groups/group-params.d.ts +2 -2
  326. package/dist/internal/protocol/zk/groups/group-params.js +2 -2
  327. package/dist/internal/protocol/zk/groups/group-send-endorsement.d.ts +10 -9
  328. package/dist/internal/protocol/zk/groups/group-send-endorsement.d.ts.map +1 -1
  329. package/dist/internal/protocol/zk/groups/group-send-endorsement.js +9 -8
  330. package/dist/internal/protocol/zk/groups/group-send-endorsement.js.map +1 -1
  331. package/dist/internal/protocol/zk/groups/lizard.d.ts +1 -1
  332. package/dist/internal/protocol/zk/groups/lizard.js +4 -4
  333. package/dist/internal/protocol/zk/groups/lizard.js.map +1 -1
  334. package/dist/internal/protocol/zk/groups/profile-key-commitment.d.ts +3 -3
  335. package/dist/internal/protocol/zk/groups/profile-key-commitment.js +3 -3
  336. package/dist/internal/protocol/zk/groups/profile-key-credential.d.ts +11 -11
  337. package/dist/internal/protocol/zk/groups/profile-key-credential.js +7 -7
  338. package/dist/internal/protocol/zk/groups/profile-key-encryption.d.ts +2 -2
  339. package/dist/internal/protocol/zk/groups/profile-key-encryption.js +2 -2
  340. package/dist/internal/protocol/zk/groups/profile-key-struct.d.ts +2 -2
  341. package/dist/internal/protocol/zk/groups/profile-key-struct.js +2 -2
  342. package/dist/internal/protocol/zk/groups/profile-key-version.d.ts +2 -2
  343. package/dist/internal/protocol/zk/groups/profile-key-version.js +2 -2
  344. package/dist/internal/protocol/zk/groups/server-params.d.ts +1 -1
  345. package/dist/internal/protocol/zk/groups/server-params.js +1 -1
  346. package/dist/internal/protocol/zk/groups/uid-encryption.d.ts +4 -4
  347. package/dist/internal/protocol/zk/groups/uid-encryption.js +4 -4
  348. package/dist/internal/protocol/zk/groups/uid-struct.d.ts +2 -2
  349. package/dist/internal/protocol/zk/groups/uid-struct.js +3 -3
  350. package/dist/internal/protocol/zk/groups/uid-struct.js.map +1 -1
  351. package/dist/internal/protocol/zk/proofs/args.d.ts +3 -3
  352. package/dist/internal/protocol/zk/proofs/args.js +3 -3
  353. package/dist/internal/protocol/zk/proofs/sho-sha256.d.ts +3 -3
  354. package/dist/internal/protocol/zk/proofs/sho-sha256.js +3 -3
  355. package/dist/internal/protocol/zk/proofs/sho.d.ts +8 -7
  356. package/dist/internal/protocol/zk/proofs/sho.d.ts.map +1 -1
  357. package/dist/internal/protocol/zk/proofs/sho.js +8 -7
  358. package/dist/internal/protocol/zk/proofs/sho.js.map +1 -1
  359. package/dist/internal/protocol/zk/proofs/statement.d.ts +8 -6
  360. package/dist/internal/protocol/zk/proofs/statement.d.ts.map +1 -1
  361. package/dist/internal/protocol/zk/proofs/statement.js +8 -6
  362. package/dist/internal/protocol/zk/proofs/statement.js.map +1 -1
  363. package/dist/internal/sesame/manager.d.ts +23 -19
  364. package/dist/internal/sesame/manager.d.ts.map +1 -1
  365. package/dist/internal/sesame/manager.js +64 -54
  366. package/dist/internal/sesame/manager.js.map +1 -1
  367. package/dist/internal/sesame/types.d.ts +28 -25
  368. package/dist/internal/sesame/types.d.ts.map +1 -1
  369. package/dist/internal/sesame/types.js +2 -2
  370. package/dist/internal/sesame/types.js.map +1 -1
  371. package/dist/internal/sesame/validation.d.ts +2 -2
  372. package/dist/internal/sesame/validation.js +3 -3
  373. package/dist/internal/sesame/validation.js.map +1 -1
  374. package/dist/internal/session/builder.d.ts +8 -8
  375. package/dist/internal/session/builder.js +22 -22
  376. package/dist/internal/session/builder.js.map +1 -1
  377. package/dist/internal/session/cipher.d.ts +3 -3
  378. package/dist/internal/session/cipher.d.ts.map +1 -1
  379. package/dist/internal/session/cipher.js +51 -40
  380. package/dist/internal/session/cipher.js.map +1 -1
  381. package/dist/internal/session/decryption.js +11 -9
  382. package/dist/internal/session/decryption.js.map +1 -1
  383. package/dist/internal/session/factory.js +1 -1
  384. package/dist/internal/session/factory.js.map +1 -1
  385. package/dist/internal/session/handshake.d.ts +4 -4
  386. package/dist/internal/session/handshake.js +4 -4
  387. package/dist/internal/session/keys.d.ts +3 -4
  388. package/dist/internal/session/keys.d.ts.map +1 -1
  389. package/dist/internal/session/keys.js.map +1 -1
  390. package/dist/internal/session/ratchet.d.ts +8 -8
  391. package/dist/internal/session/ratchet.js +10 -10
  392. package/dist/internal/session/ratchet.js.map +1 -1
  393. package/dist/internal/session/session-resolver.d.ts +6 -6
  394. package/dist/internal/session/session-resolver.js +6 -6
  395. package/dist/internal/session/state.d.ts +12 -12
  396. package/dist/internal/session/state.d.ts.map +1 -1
  397. package/dist/internal/session/state.js +7 -7
  398. package/dist/internal/session/types.d.ts +20 -20
  399. package/dist/internal/session/types.d.ts.map +1 -1
  400. package/dist/internal/session/types.js +3 -3
  401. package/dist/internal/session/validation.d.ts +1 -1
  402. package/dist/internal/session/validation.js +4 -4
  403. package/dist/internal/session/validation.js.map +1 -1
  404. package/dist/keys/branded.d.ts +12 -12
  405. package/dist/keys/branded.js +3 -3
  406. package/dist/keys/generation.d.ts +4 -4
  407. package/dist/keys/generation.js +4 -4
  408. package/dist/keys/identity.d.ts +7 -7
  409. package/dist/keys/identity.d.ts.map +1 -1
  410. package/dist/keys/identity.js +7 -7
  411. package/dist/keys/identity.js.map +1 -1
  412. package/dist/keys/types.d.ts +16 -16
  413. package/dist/keys/types.d.ts.map +1 -1
  414. package/dist/layers.d.ts +1 -1
  415. package/dist/layers.js +1 -1
  416. package/dist/local/store/expo/adapter.d.ts +8 -8
  417. package/dist/local/store/expo/adapter.js +10 -10
  418. package/dist/local/store/expo/adapter.js.map +1 -1
  419. package/dist/local/store/expo/database-key.d.ts +7 -7
  420. package/dist/local/store/expo/database-key.js +7 -7
  421. package/dist/local/store/expo/key-storage.d.ts +1 -1
  422. package/dist/local/store/expo/key-storage.js +4 -4
  423. package/dist/local/store/expo/key-storage.js.map +1 -1
  424. package/dist/local/store/expo/models/kyber-prekey-used.d.ts +6 -6
  425. package/dist/local/store/expo/models/kyber-prekey-used.js +3 -3
  426. package/dist/local/store/expo/models/kyber-prekey.d.ts +1 -1
  427. package/dist/local/store/expo/models/kyber-prekey.js +1 -1
  428. package/dist/local/store/expo/models/message-record.d.ts +2 -2
  429. package/dist/local/store/expo/models/message-record.d.ts.map +1 -1
  430. package/dist/local/store/expo/models/message-record.js +1 -1
  431. package/dist/local/store/expo/models/message-record.js.map +1 -1
  432. package/dist/local/store/expo/models/sender-key.d.ts +11 -10
  433. package/dist/local/store/expo/models/sender-key.d.ts.map +1 -1
  434. package/dist/local/store/expo/models/sender-key.js +11 -10
  435. package/dist/local/store/expo/models/sender-key.js.map +1 -1
  436. package/dist/local/store/expo/schema.d.ts +2 -2
  437. package/dist/local/store/expo/schema.js +2 -2
  438. package/dist/local/store/expo/secure-store-options.d.ts +1 -1
  439. package/dist/local/store/memory/adapter.d.ts +2 -2
  440. package/dist/local/store/memory/adapter.js +12 -12
  441. package/dist/local/store/memory/adapter.js.map +1 -1
  442. package/dist/local/store/node/adapter.d.ts.map +1 -1
  443. package/dist/local/store/node/adapter.js +5 -4
  444. package/dist/local/store/node/adapter.js.map +1 -1
  445. package/dist/local/store/node/database-key.d.ts +8 -8
  446. package/dist/local/store/node/database-key.js +10 -10
  447. package/dist/local/store/node/database-key.js.map +1 -1
  448. package/dist/local/store/node/database.d.ts +5 -5
  449. package/dist/local/store/node/database.js +11 -11
  450. package/dist/local/store/node/database.js.map +1 -1
  451. package/dist/local/store/react-native/adapter.d.ts +6 -6
  452. package/dist/local/store/react-native/adapter.d.ts.map +1 -1
  453. package/dist/local/store/react-native/adapter.js +35 -32
  454. package/dist/local/store/react-native/adapter.js.map +1 -1
  455. package/dist/local/store/react-native/backend-conformance.d.ts +11 -10
  456. package/dist/local/store/react-native/backend-conformance.d.ts.map +1 -1
  457. package/dist/local/store/react-native/backend-conformance.js +13 -12
  458. package/dist/local/store/react-native/backend-conformance.js.map +1 -1
  459. package/dist/local/store/react-native/index.d.ts +1 -1
  460. package/dist/local/store/react-native/reference-backend.d.ts +14 -13
  461. package/dist/local/store/react-native/reference-backend.d.ts.map +1 -1
  462. package/dist/local/store/react-native/reference-backend.js +15 -14
  463. package/dist/local/store/react-native/reference-backend.js.map +1 -1
  464. package/dist/local/store/react-native/storage.d.ts +3 -3
  465. package/dist/local/store/web/adapter.d.ts +3 -3
  466. package/dist/local/store/web/adapter.d.ts.map +1 -1
  467. package/dist/local/store/web/adapter.js +30 -31
  468. package/dist/local/store/web/adapter.js.map +1 -1
  469. package/dist/local/store/web/index.d.ts +1 -1
  470. package/dist/local/vault/index.d.ts +2 -2
  471. package/dist/media/index.d.ts +11 -11
  472. package/dist/media/index.js +9 -9
  473. package/dist/profile/contact-state.d.ts +1 -1
  474. package/dist/profile/contact-state.js +1 -1
  475. package/dist/profile/profile-key.d.ts +2 -2
  476. package/dist/profile/profile-key.js +7 -6
  477. package/dist/profile/profile-key.js.map +1 -1
  478. package/dist/remote/object-store/index.d.ts +1 -1
  479. package/dist/remote/object-store/s3/storage.d.ts +1 -1
  480. package/dist/remote/object-store/types.d.ts +4 -4
  481. package/dist/remote/object-store/types.d.ts.map +1 -1
  482. package/dist/remote/relay/convex/backend.d.ts +4 -4
  483. package/dist/remote/relay/convex/backend.js +3 -3
  484. package/dist/remote/relay/convex/backend.js.map +1 -1
  485. package/dist/remote/relay/convex/component/accounts.d.ts +15 -13
  486. package/dist/remote/relay/convex/component/accounts.d.ts.map +1 -1
  487. package/dist/remote/relay/convex/component/accounts.js +31 -28
  488. package/dist/remote/relay/convex/component/accounts.js.map +1 -1
  489. package/dist/remote/relay/convex/component/certificates.js +1 -1
  490. package/dist/remote/relay/convex/component/cleanup.js +7 -7
  491. package/dist/remote/relay/convex/component/cleanup.js.map +1 -1
  492. package/dist/remote/relay/convex/component/convex.config.d.ts.map +1 -1
  493. package/dist/remote/relay/convex/component/convex.config.js +10 -8
  494. package/dist/remote/relay/convex/component/convex.config.js.map +1 -1
  495. package/dist/remote/relay/convex/component/devices.d.ts +21 -20
  496. package/dist/remote/relay/convex/component/devices.d.ts.map +1 -1
  497. package/dist/remote/relay/convex/component/devices.js +24 -23
  498. package/dist/remote/relay/convex/component/devices.js.map +1 -1
  499. package/dist/remote/relay/convex/component/groups.js +6 -6
  500. package/dist/remote/relay/convex/component/groups.js.map +1 -1
  501. package/dist/remote/relay/convex/component/messages.d.ts.map +1 -1
  502. package/dist/remote/relay/convex/component/messages.js +89 -82
  503. package/dist/remote/relay/convex/component/messages.js.map +1 -1
  504. package/dist/remote/relay/convex/component/provisioning.d.ts +3 -3
  505. package/dist/remote/relay/convex/component/provisioning.d.ts.map +1 -1
  506. package/dist/remote/relay/convex/component/provisioning.js +17 -16
  507. package/dist/remote/relay/convex/component/provisioning.js.map +1 -1
  508. package/dist/remote/relay/convex/component/runtime.d.ts.map +1 -1
  509. package/dist/remote/relay/convex/component/runtime.js +4 -2
  510. package/dist/remote/relay/convex/component/runtime.js.map +1 -1
  511. package/dist/remote/relay/convex/component/schema.js +25 -24
  512. package/dist/remote/relay/convex/component/schema.js.map +1 -1
  513. package/dist/remote/relay/convex/group-server.d.ts +3 -3
  514. package/dist/remote/relay/convex/group-server.js +3 -3
  515. package/dist/remote/relay/convex/relay.d.ts +3 -3
  516. package/dist/remote/relay/convex/relay.d.ts.map +1 -1
  517. package/dist/remote/relay/convex/relay.js +18 -17
  518. package/dist/remote/relay/convex/relay.js.map +1 -1
  519. package/dist/remote/relay/convex/types.d.ts +7 -7
  520. package/dist/remote/relay/convex/types.js +4 -4
  521. package/dist/remote/relay/memory/adapter.js +9 -9
  522. package/dist/remote/relay/memory/adapter.js.map +1 -1
  523. package/dist/remote/relay/types.d.ts +27 -27
  524. package/dist/remote/relay/types.d.ts.map +1 -1
  525. package/dist/safety/fingerprint.d.ts +7 -6
  526. package/dist/safety/fingerprint.d.ts.map +1 -1
  527. package/dist/safety/fingerprint.js +5 -4
  528. package/dist/safety/fingerprint.js.map +1 -1
  529. package/dist/safety/index.d.ts +6 -5
  530. package/dist/safety/index.d.ts.map +1 -1
  531. package/dist/safety/index.js +7 -6
  532. package/dist/safety/index.js.map +1 -1
  533. package/dist/safety/protobuf.js +2 -2
  534. package/dist/safety/protobuf.js.map +1 -1
  535. package/dist/safety/url.d.ts +5 -5
  536. package/dist/safety/url.js +6 -6
  537. package/dist/types/address.d.ts +2 -2
  538. package/dist/types/address.js +2 -2
  539. package/dist/types/api.d.ts +78 -73
  540. package/dist/types/api.d.ts.map +1 -1
  541. package/dist/types/errors.d.ts +63 -403
  542. package/dist/types/errors.d.ts.map +1 -1
  543. package/dist/types/errors.js +62 -537
  544. package/dist/types/errors.js.map +1 -1
  545. package/dist/types/messages.d.ts +16 -16
  546. package/dist/types/messages.d.ts.map +1 -1
  547. package/dist/types/messages.js +7 -7
  548. package/dist/types/messages.js.map +1 -1
  549. package/dist/types/protocol-config.d.ts +52 -49
  550. package/dist/types/protocol-config.d.ts.map +1 -1
  551. package/dist/types/protocol-config.js +36 -34
  552. package/dist/types/protocol-config.js.map +1 -1
  553. package/dist/types/protocol-constants.d.ts +2 -2
  554. package/dist/types/protocol-constants.js +2 -2
  555. package/dist/types/session.d.ts +62 -61
  556. package/dist/types/session.d.ts.map +1 -1
  557. package/dist/types/session.js +13 -14
  558. package/dist/types/session.js.map +1 -1
  559. package/dist/types/trust.d.ts +8 -8
  560. package/dist/types/trust.js +3 -3
  561. package/dist/utils/retry.d.ts.map +1 -1
  562. package/dist/utils/retry.js +2 -4
  563. package/dist/utils/retry.js.map +1 -1
  564. package/docs/ASSURANCE.md +82 -74
  565. package/docs/CLIENT_COMPOSITION.md +19 -15
  566. package/docs/DEVIATIONS.md +507 -425
  567. package/docs/DOCUMENTATION_STANDARDS.md +24 -24
  568. package/docs/E2EE.md +45 -42
  569. package/docs/ERROR_HANDLING.md +29 -105
  570. package/docs/GETTING_STARTED.md +24 -25
  571. package/docs/INTERFACES.md +27 -18
  572. package/docs/PACKAGE_SURFACE.md +23 -21
  573. package/docs/PROTOCOL_POLICY.md +19 -13
  574. package/docs/RECIPES.md +4 -4
  575. package/docs/SECURITY.md +72 -60
  576. package/encoding/README.md +2 -2
  577. package/files/README.md +1 -1
  578. package/groups/README.md +4 -3
  579. package/hooks/README.md +2 -2
  580. package/keys/README.md +15 -14
  581. package/local/store/README.md +82 -67
  582. package/local/store/expo/README.md +17 -12
  583. package/local/store/memory/README.md +4 -3
  584. package/local/store/node/README.md +8 -6
  585. package/local/store/react-native/README.md +14 -12
  586. package/local/store/web/README.md +31 -26
  587. package/local/vault/README.md +4 -4
  588. package/media/README.md +6 -5
  589. package/package.json +1 -1
  590. package/profile/README.md +7 -7
  591. package/remote/README.md +20 -18
  592. package/remote/object-store/README.md +8 -4
  593. package/remote/object-store/convex-r2/README.md +3 -3
  594. package/remote/object-store/s3/README.md +10 -5
  595. package/remote/relay/convex/README.md +5 -5
  596. package/remote/relay/convex/component/README.md +145 -124
  597. package/remote/relay/memory/README.md +6 -5
  598. package/safety/README.md +1 -1
  599. package/sealed-sender/README.md +3 -2
  600. package/types/README.md +1 -1
  601. package/utils/README.md +4 -4
@@ -30,7 +30,7 @@ without coupling the client to a database or platform.
30
30
 
31
31
  Use this for browser applications. It implements the full core store
32
32
  contract, including SESAME records, sender-key state, retry message records,
33
- and recovery helpers, and it graduated from experimental by completing every
33
+ and recovery helpers. It graduated from experimental by completing every
34
34
  gate on the checklist below. Deployment still requires the origin-security
35
35
  review described in the [web adapter guide](./web/README.md).
36
36
 
@@ -40,8 +40,8 @@ review described in the [web adapter guide](./web/README.md).
40
40
 
41
41
  Use this for bare React Native applications that supply their own key-value
42
42
  backend. It implements the full core store contract, including SESAME records,
43
- sender-key state, retry message records, and recovery helpers, and it
44
- graduated from experimental by completing every gate on the checklist below.
43
+ sender-key state, retry message records, and recovery helpers. It graduated
44
+ from experimental by completing every gate on the checklist below.
45
45
  The supplied backend is the application's responsibility: verify it with the
46
46
  exported backend-conformance kit described in the
47
47
  [React Native adapter guide](./react-native/README.md).
@@ -49,75 +49,88 @@ exported backend-conformance kit described in the
49
49
  #### Graduation checklist
50
50
 
51
51
  The experimental label comes off an adapter when every item below is a named,
52
- continuously running CI gate. Each gate tests the adapter's own contract —
53
- the promises `ISignalProtocolLocalStore` makes — never the platform under it:
54
- browsers, IndexedDB, and React Native are the environment an adapter must
55
- honor its promises in, not the subject of a test.
52
+ continuously running CI gate. Each gate tests the adapter's own contract,
53
+ which is the set of promises `ISignalProtocolLocalStore` makes. No gate tests
54
+ the platform under it. Browsers, IndexedDB, and React Native are the
55
+ environment an adapter must honor its promises in, not the subject of a test.
56
56
 
57
- `IndexedDbSignalProtocolStore` (graduated; the gates keep running):
57
+ `IndexedDbSignalProtocolStore` (graduated, and the gates keep running):
58
58
 
59
59
  - [x] Storage contract suites pass in real Chromium, Firefox, and WebKit on
60
60
  every change to the source repository. The suites are the same modules
61
61
  the jest gate runs, so a matcher means the same thing in both gates.
62
- - [x] Interruption tests: a real tab is destroyed while a write is in
63
- flight — atomic session/trust commit, identity rotation, fresh-database
64
- bootstrap, and a prekey batch — and the store reopened from a fresh tab
65
- is readable on the next `initialize()`, with each atomic security
66
- commit observed either fully applied or fully absent, never partial.
67
- Runs in all three engines on every change to the source repository.
68
- - [x] Multi-tab tests: concurrent revision-checked writes from two real
69
- tabs — two live IndexedDB connections — resolve per the contract's
70
- compare-and-set promise: one winner per create race, losers told
71
- instead of silently overwritten, rejected commits leave no partial
72
- state. Runs in all three engines on every change to the source
73
- repository.
62
+ - [x] Interruption tests. The gate destroys a real tab mid-write, then
63
+ reopens the store from a fresh tab. The interrupted writes are an
64
+ atomic session/trust commit, an identity rotation, a fresh-database
65
+ bootstrap, and a prekey batch. The reopened store is readable on the
66
+ next `initialize()`. The store shows each atomic security commit as
67
+ fully applied or fully absent, never partial. Runs in all three
68
+ engines on every change to the source repository.
69
+ - [x] Multi-tab tests. Concurrent revision-checked writes from two real
70
+ tabs, over two live IndexedDB connections, resolve per the contract's
71
+ compare-and-set promise. That promise gives one winner per create
72
+ race. It tells the losers instead of silently overwriting them. A
73
+ rejected commit leaves no partial state. Runs in all three engines on
74
+ every change to the source repository.
74
75
  - [x] Storage-pressure tests: quota exhaustion surfaces as the typed
75
76
  `StorageQuotaExceededError` (`STORAGE_QUOTA_EXCEEDED`), never a silent
76
77
  partial write. A jest suite drives quota-shaped backend failures
77
- through every write path in the adapter, and a real Chromium run
78
- exhausts a clamped origin quota and observes the typed rejection, no
78
+ through every write path in the adapter. A real Chromium run exhausts
79
+ a clamped origin quota. That run observes the typed rejection, no
79
80
  partial state, and a clean retry once space frees. Runs on every
80
81
  change to the source repository.
81
82
  - [x] Soak evidence: a long-run open/write/close cycle holds memory and
82
83
  latency flat. A soak runner drives 2,000 full
83
84
  construct/initialize/write/read/close cycles through the adapter in
84
- one real Chromium page, samples renderer memory - including
85
- ArrayBuffer backing stores - after forced garbage collection, and
86
- fails if the late-run median of memory or per-cycle latency grows
87
- beyond a small tolerance over the early-run median. Runs on every
88
- change to the source repository, and `npm run soak:web-store` runs
89
- longer sessions on demand.
90
-
91
- `ReactNativeSignalProtocolStore` (graduated; the gates keep running):
92
-
93
- - [x] Exported backend-conformance kit: the SDK cannot test an
94
- application-supplied `storage` backend, so it ships the contract suite
95
- the application runs against its own backend. `runBackendConformance`
96
- and `assertBackendConformance` execute thirteen cases against any
97
- `ReactNativeKeyValueStorage`: round-trips, key listing, batch removal,
98
- in-order atomic application, checks evaluated against pre-batch state,
99
- null-guarded creation, all-or-nothing failure, exact-userId session
100
- removal with in-batch visibility, one winner between concurrent
101
- guarded batches, and durability across reopen. A jest gate proves the
102
- kit catches a non-atomic backend, a prefix-matching session removal,
103
- and an unserialized backend, on every change to the source repository.
104
- - [x] Reference backend passes that kit on Hermes in CI.
105
- `createReferenceReactNativeBackend` is the executable specification of
106
- the backend contract, and a named gate bundles the kit with esbuild
107
- and runs it against the reference backend on the sha256-pinned Hermes
108
- CLI — the engine React Native ships with — on every change to the
109
- source repository. The runner requires an explicit pass sentinel
110
- because Hermes exits 0 on an unhandled async rejection.
111
- - [x] Interruption and storage-pressure tests against the reference
112
- backend. A simulated process kill before commit leaves each atomic
113
- security write — session/trust commit, identity rotation, trust
114
- verification — fully absent after reopen, and an identical retry lands
115
- it fully applied. Quota exhaustion surfaces as the typed
116
- `StorageQuotaExceededError` (`STORAGE_QUOTA_EXCEEDED`), never a silent
117
- partial write: a jest suite drives quota-shaped backend failures
118
- through every write path, and a real-quota run over the reference
119
- backend observes the typed rejection, no partial state, and a clean
120
- retry once space frees. Runs on every change to the source repository.
85
+ one real Chromium page. It samples renderer memory, including
86
+ ArrayBuffer backing stores, after forced garbage collection. It fails
87
+ if the late-run median of memory or per-cycle latency grows beyond a
88
+ small tolerance over the early-run median. Runs on every change to the
89
+ source repository, and `npm run soak:web-store` runs longer sessions
90
+ on demand.
91
+
92
+ `ReactNativeSignalProtocolStore` (graduated, and the gates keep running):
93
+
94
+ - [x] Exported backend-conformance kit. The SDK cannot test an
95
+ application-supplied `storage` backend. Instead it ships the contract
96
+ suite the application runs against its own backend. The kit exports
97
+ `runBackendConformance` and `assertBackendConformance`, which execute
98
+ thirteen cases against any `ReactNativeKeyValueStorage`:
99
+
100
+ - round-trips
101
+ - key listing
102
+ - batch removal
103
+ - in-order atomic application
104
+ - checks evaluated against pre-batch state
105
+ - null-guarded creation
106
+ - all-or-nothing failure
107
+ - exact-userId session removal with in-batch visibility
108
+ - one winner between concurrent guarded batches
109
+ - durability across reopen
110
+
111
+ A jest gate proves the kit catches a non-atomic backend, a
112
+ prefix-matching session removal, and an unserialized backend, on every
113
+ change to the source repository.
114
+ - [x] Reference backend passes that kit on Hermes in CI. The SDK ships
115
+ `createReferenceReactNativeBackend`, which specifies the backend
116
+ contract in executable form. A named gate bundles the kit with esbuild
117
+ and runs it against the reference backend. That gate uses the
118
+ sha256-pinned Hermes CLI, the engine React Native ships with. It runs
119
+ on every change to the source repository. The runner requires an
120
+ explicit pass sentinel because Hermes exits 0 on an unhandled async
121
+ rejection.
122
+ - [x] Interruption tests against the reference backend. A simulated process
123
+ kill before commit leaves each atomic security write fully absent
124
+ after reopen. Those writes are a session/trust commit, an identity
125
+ rotation, and a trust verification. An identical retry then lands the
126
+ write fully applied. Runs on every change to the source repository.
127
+ - [x] Storage-pressure tests against the reference backend. Quota
128
+ exhaustion surfaces as the typed `StorageQuotaExceededError`
129
+ (`STORAGE_QUOTA_EXCEEDED`), never a silent partial write. A jest suite
130
+ drives quota-shaped backend failures through every write path. A
131
+ real-quota run observes the typed rejection, no partial state, and a
132
+ clean retry once space frees. Runs on every change to the source
133
+ repository.
121
134
 
122
135
  ### Node
123
136
 
@@ -165,16 +178,17 @@ interface SessionRecord {
165
178
  }
166
179
  ```
167
180
 
168
- Older session formats are rejected and reset instead of migrated. Version 4
181
+ The SDK rejects and resets older session formats instead of migrating them.
182
+ Version 4
169
183
  binds both endpoint composite identities and their explicit identity types into
170
184
  every live session.
171
185
 
172
186
  ## Atomic Security Commits
173
187
 
174
- Contact trust and session creation/advancement share one atomic commit seam;
175
- responder one-time-prekey consumption joins that same transaction. Separately,
176
- accepted identity rotation and deletion of every bound device session share one
177
- logical transaction. An adapter must never publish only a subset of either
188
+ Contact trust and session creation/advancement share one atomic commit seam.
189
+ Responder one-time-prekey consumption joins that same transaction. Separately,
190
+ one logical transaction accepts an identity rotation and deletes every bound
191
+ device session. An adapter must never publish only a subset of either
178
192
  security transition. The shared adapter contract verifies
179
193
  failure rollback, compare-and-swap behavior, one-time-prekey replay rejection,
180
194
  and exact per-user session deletion.
@@ -183,8 +197,9 @@ For React Native, the supplied backend's `atomicWrite` is a security boundary,
183
197
  not a batching optimization. It must commit `check`, `set`, `remove`, and
184
198
  `removeSessionsForUser` operations in one crash-durable transaction. The final
185
199
  operation must enumerate exact plaintext session metadata inside that same
186
- transaction; prefix matching or enumeration performed before the transaction
187
- can leave a concurrently-created session trusted under a rotated identity.
200
+ transaction. An adapter that matches a prefix or enumerates before the
201
+ transaction can leave a concurrently-created session trusted under a rotated
202
+ identity.
188
203
 
189
204
  ## Design Notes
190
205
 
@@ -194,7 +209,7 @@ can leave a concurrently-created session trusted under a rotated identity.
194
209
  integration helpers that a real app composes directly.
195
210
  - An adapter carries the experimental label until every item on its
196
211
  graduation checklist is a named, continuously running CI gate. Both the web
197
- and bare React Native adapters have completed theirs.
212
+ and bare React Native adapters completed theirs.
198
213
  - Storage adapters should expose the real package contract instead of app-specific wrappers.
199
214
 
200
215
  ## Related Docs
@@ -6,8 +6,8 @@ the local secret-vault boundary.
6
6
 
7
7
  ## Why it exists
8
8
 
9
- Signal Protocol state is larger and more transactional than platform keychains
10
- are designed to hold. The adapter keeps a small database key in secure storage
9
+ Signal Protocol state is larger and more transactional than the values
10
+ platform keychains hold. The adapter keeps a small database key in secure storage
11
11
  and stores protocol records in the application's encrypted SQLite database.
12
12
  The host owns database creation so it can compose these tables into its own
13
13
  schema and transaction lifecycle.
@@ -44,19 +44,24 @@ configureSignalProtocolExpoDbBindings({
44
44
  ```
45
45
 
46
46
  `appDatabase.openEncryptedSignalProtocolDatabase` represents application-owned database
47
- bootstrap. It must enable SQLCipher through the `expo-sqlite` native
48
- configuration, apply the supplied key before schema access, create or migrate
49
- the exported tables, and return the matching raw and Drizzle handles. SQLCipher
50
- requires a development build and is not available in Expo Go.
47
+ bootstrap. It must:
48
+
49
+ - enable SQLCipher through the `expo-sqlite` native configuration
50
+ - apply the supplied key before schema access
51
+ - create or migrate the exported tables
52
+ - return the matching raw and Drizzle handles
53
+
54
+ SQLCipher requires a development build and is not available in Expo Go.
51
55
 
52
56
  Every table this store exports holds material that must not leave the device.
53
- That includes the group `sender_keys` and `skipped_sender_keys` tables, whose
57
+ That includes the group `sender_keys` and `skipped_sender_keys` tables. Their
54
58
  rows contain the sender chain key, the sender's private signature key, and
55
- individual message keys — enough to read and to forge a sender's group
56
- messages. They are stored unencrypted at the row level because SQLCipher
57
- encrypts the database file itself, so the database key is the only thing that
58
- protects them. Do not back these tables up to a server or sync them between
59
- devices.
59
+ individual message keys. That material is enough to read and to forge a
60
+ sender's group messages. The store writes those rows unencrypted at the row
61
+ level, because SQLCipher encrypts the database file itself. The database key is
62
+ therefore the only thing that protects them.
63
+
64
+ Do not back these tables up to a server or sync them between devices.
60
65
 
61
66
  ## Client usage
62
67
 
@@ -3,7 +3,8 @@
3
3
  `InMemorySignalProtocolStore` implements `ISignalProtocolLocalStore` in memory for examples, local
4
4
  development, and deterministic application prototypes.
5
5
 
6
- Real protocol and cryptography; simulated in-memory infrastructure.
6
+ The protocol and cryptography are real. The adapter simulates the
7
+ infrastructure in memory.
7
8
 
8
9
  ## Why it exists
9
10
 
@@ -24,8 +25,8 @@ const client = await createSignalProtocolClient({
24
25
  });
25
26
  ```
26
27
 
27
- All keys, sessions, and trust decisions disappear when the process or adapter
28
- is discarded. Never use this adapter for production accounts.
28
+ All keys, sessions, and trust decisions disappear when the process ends or the
29
+ application discards the adapter. Never use this adapter for production accounts.
29
30
 
30
31
  ## Deterministic storage failures
31
32
 
@@ -3,12 +3,14 @@
3
3
  `NodeSignalProtocolStore` provides Node.js protocol storage using encrypted,
4
4
  crash-durable filesystem state.
5
5
 
6
- It implements all of `ISignalProtocolLocalStore` — identity, prekeys, sessions,
7
- Kyber prekeys, Sesame device records, sender keys, and message records — so
8
- multi-device and group flows work in Node without a custom adapter. The class
9
- declares `implements ISignalProtocolLocalStore`, so the compiler rejects any
10
- build in which a member is missing or its signature drifts; that check is the
11
- guarantee behind this paragraph, not a manual audit.
6
+ It implements all of `ISignalProtocolLocalStore`. That covers identity,
7
+ prekeys, sessions, Kyber prekeys, Sesame device records, sender keys, and
8
+ message records. Multi-device and group flows therefore work in Node without a
9
+ custom adapter.
10
+
11
+ The class declares `implements ISignalProtocolLocalStore`, so the compiler
12
+ rejects any build that omits a member or changes its signature. That check is
13
+ the guarantee behind this paragraph, not a manual audit.
12
14
 
13
15
  ## Why it exists
14
16
 
@@ -30,15 +30,15 @@ const client = await createSignalProtocolClient({
30
30
  The injected backend's `atomicWrite()` is a security boundary. It must evaluate
31
31
  compare-and-swap checks and commit all writes, removals, and exact per-user
32
32
  session deletion atomically and durably, including across process termination.
33
- A batched sequence of independent writes is not sufficient.
33
+ Independent writes committed one after another are not sufficient.
34
34
 
35
35
  ## Verifying your backend
36
36
 
37
37
  The adapter's guarantees hold only over a backend that honors the
38
38
  `ReactNativeKeyValueStorage` contract, and the SDK cannot test the backend
39
39
  your application supplies. The package therefore exports a
40
- backend-conformance kit — run it against your backend from your
41
- application's own tests:
40
+ backend-conformance kit. Run it against your backend from your application's
41
+ own tests:
42
42
 
43
43
  ```ts
44
44
  import {
@@ -54,17 +54,19 @@ await assertBackendConformance({
54
54
  });
55
55
  ```
56
56
 
57
- `assertBackendConformance` throws one error naming every failing case;
58
- `runBackendConformance` returns the structured result instead.
59
- `createReferenceReactNativeBackend` is the executable specification of the
60
- contract: an in-memory backend that passes the kit, useful as a comparison
61
- point and as a test double. Continuous integration runs the kit against the
62
- reference backend on the Hermes engine, and drives the adapter over it
63
- through interruption and storage-pressure suites; the checklist that
64
- graduated this adapter is in the parent [storage guide](../README.md).
57
+ The function `assertBackendConformance` throws one error that names every
58
+ failing case. The function `runBackendConformance` returns the structured
59
+ result instead. The SDK also ships `createReferenceReactNativeBackend`, which
60
+ specifies the contract in executable form. It is an in-memory backend that
61
+ passes the kit, and it is useful as a comparison point and as a test double.
62
+
63
+ Continuous integration runs the kit against the reference backend on the Hermes
64
+ engine. It also drives the adapter over that backend through interruption and
65
+ storage-pressure suites. The parent [storage guide](../README.md) holds the
66
+ checklist that graduated this adapter.
65
67
 
66
68
  Key custody, crash durability, and backup behavior remain properties of your
67
- chosen native storage engine — the kit verifies contract semantics, and your
69
+ chosen native storage engine. The kit verifies contract semantics, and your
68
70
  deployment review must still cover the engine itself.
69
71
 
70
72
  See the parent [storage guide](../README.md), [adapter guide](../../../ADAPTERS.md),
@@ -24,8 +24,8 @@ const client = await createSignalProtocolClient({
24
24
  ```
25
25
 
26
26
  The adapter persists identity keys, contact trust, prekeys, sessions, sender
27
- keys, device records, and retry metadata. Records are encrypted with
28
- AES-256-GCM.
27
+ keys, device records, and retry metadata. The adapter encrypts every record
28
+ with AES-256-GCM.
29
29
 
30
30
  ## Security boundary
31
31
 
@@ -41,12 +41,12 @@ therefore not an XSS defense.
41
41
 
42
42
  Browser applications using this adapter should:
43
43
 
44
- - enforce a restrictive Content Security Policy with response headers;
45
- - avoid inline/evaluated scripts and minimize third-party script execution;
44
+ - enforce a restrictive Content Security Policy with response headers.
45
+ - avoid inline/evaluated scripts and minimize third-party script execution.
46
46
  - protect authentication with secure, HttpOnly cookies where the application
47
- architecture permits;
48
- - render untrusted content through framework escaping;
49
- - review dependency and service-worker update paths; and
47
+ architecture permits.
48
+ - render untrusted content through framework escaping.
49
+ - review dependency and service-worker update paths.
50
50
  - provide an account-reset path that deletes the IndexedDB database and other
51
51
  same-origin state.
52
52
 
@@ -66,27 +66,32 @@ above.
66
66
  When a write exhausts the origin's storage quota, it rejects with the typed
67
67
  `StorageQuotaExceededError` (code `STORAGE_QUOTA_EXCEEDED`). Every write
68
68
  commits in one atomic transaction, so the error always means the write did
69
- not persist — never a partial record. The application should free space or
70
- request more from the platform, then retry.
69
+ not persist. It never means a partial record. The application should free
70
+ space or request more from the platform, then retry.
71
71
 
72
72
  The storage contract suites run against this adapter in real Chromium,
73
- Firefox, and WebKit on every change to the source repository. A multi-tab
74
- suite drives concurrent revision-checked writes through two live
75
- connections on one origin — the state a deployed application enters when a
76
- user opens a second tab — an interruption suite destroys a tab while a
77
- write is in flight, then asserts the reopened store is readable and every
78
- atomic security commit landed all-or-nothing, and a storage-pressure suite
79
- clamps the origin's quota in Chromium, exhausts it, and asserts the typed
80
- rejection, intact prior state, and a clean retry once space frees, while a
81
- jest suite drives quota-shaped backend failures through every write path
82
- in the adapter. A soak runner drives thousands of full
83
- open/write/read/close cycles through the adapter in one Chromium page and
84
- fails if memory — including ArrayBuffer backing stores, sampled after
85
- forced garbage collection — or per-cycle latency drifts upward across the
86
- run. The contract suites are the same modules the jest gate runs, and
87
- every assertion targets this adapter's contract — the engines are the
88
- environment the adapter must honor its promises in, not the subject of
89
- the tests.
73
+ Firefox, and WebKit on every change to the source repository. Three more
74
+ suites run beside them.
75
+
76
+ - A multi-tab suite drives concurrent revision-checked writes through two
77
+ live connections on one origin. That is the state a deployed application
78
+ enters when a user opens a second tab.
79
+ - An interruption suite destroys a tab while a write is in flight. It then
80
+ asserts that the reopened store is readable, and that every atomic
81
+ security commit landed all-or-nothing.
82
+ - A storage-pressure suite clamps the origin's quota in Chromium and
83
+ exhausts it. It asserts the typed rejection, intact prior state, and a
84
+ clean retry once space frees. Beside it, a jest suite drives quota-shaped
85
+ backend failures through every write path in the adapter.
86
+
87
+ A soak runner drives thousands of full open/write/read/close cycles through
88
+ the adapter in one Chromium page. It fails if per-cycle latency drifts
89
+ upward across the run. It also fails if memory drifts upward, including
90
+ ArrayBuffer backing stores, sampled after forced garbage collection.
91
+
92
+ The contract suites are the same modules the jest gate runs. Every assertion
93
+ targets this adapter's contract. The engines are the environment the adapter
94
+ must honor its promises in, not the subject of the tests.
90
95
 
91
96
  See the parent [storage guide](../README.md), [adapter guide](../../../ADAPTERS.md),
92
97
  and [security model](../../../docs/SECURITY.md).
@@ -6,10 +6,10 @@ The local secret vault stores small bootstrap secrets through a minimal
6
6
  ## Why it exists
7
7
 
8
8
  Platform secret managers are appropriate for tiny keys and bootstrap values,
9
- but not full session databases. Separating the vault from
10
- `ISignalProtocolLocalStore` keeps platform limits explicit and lets a local store use a
11
- vault-held wrapping key without placing every protocol record in the platform
12
- keychain.
9
+ but not full session databases. A vault separate from
10
+ `ISignalProtocolLocalStore` keeps platform limits explicit. A local store can
11
+ then use a vault-held wrapping key without placing every protocol record in the
12
+ platform keychain.
13
13
 
14
14
  ## Expo usage
15
15
 
package/media/README.md CHANGED
@@ -6,12 +6,13 @@ cleanup.
6
6
 
7
7
  ## Why it exists
8
8
 
9
- Signal Protocol messages are suited to small encrypted payloads, not large
10
- binary objects. Media therefore uses two encryption layers:
9
+ Signal Protocol messages suit small encrypted payloads, not large binary
10
+ objects. Media therefore uses two encryption layers:
11
11
 
12
- 1. file bytes are encrypted locally and only ciphertext enters remote storage;
13
- 2. the key, digest, sizes, and opaque object identifier are carried inside the
14
- end-to-end encrypted message.
12
+ 1. the SDK encrypts file bytes locally, and only ciphertext enters the remote
13
+ object store.
14
+ 2. the end-to-end encrypted message carries the key, digest, sizes, and opaque
15
+ object identifier.
15
16
 
16
17
  The remote object store never receives the media key or plaintext.
17
18
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@open-e2ee/signal-protocol-sdk",
3
- "version": "0.2.3",
3
+ "version": "0.3.0",
4
4
  "description": "Signal Protocol E2EE SDK for TypeScript — Expo, React Native, browser, and Node. Post-quantum PQXDH and Double Ratchet.",
5
5
  "keywords": [
6
6
  "open-e2ee",
package/profile/README.md CHANGED
@@ -1,13 +1,13 @@
1
1
  # Encrypted Profiles
2
2
 
3
- The profile module generates profile keys, encrypts padded profile fields,
4
- stores the current user's profile key, tracks received contact profile state,
5
- and coordinates encrypted profile updates.
3
+ The profile module generates profile keys, encrypts padded profile fields, and
4
+ stores the current user's profile key. It also tracks received contact profile
5
+ state and coordinates encrypted profile updates.
6
6
 
7
7
  ## Why it exists
8
8
 
9
9
  Profile data is application content with its own key lifecycle. Profile keys
10
- travel only through end-to-end encrypted messages; the profile service stores
10
+ travel only through end-to-end encrypted messages. The profile service stores
11
11
  encrypted fields and does not receive those keys.
12
12
 
13
13
  ## Usage
@@ -28,13 +28,13 @@ const { name } = await decryptProfileName(profileKey, encryptedName);
28
28
  ```
29
29
 
30
30
  Use `updateEncryptedProfile()` to stage and upload an encrypted profile through
31
- an application-owned API. Profile-key rotation is a coordinated operation:
32
- persist the new encrypted snapshot, distribute the new key through encrypted
31
+ an application-owned API. Profile-key rotation is a coordinated operation.
32
+ Persist the new encrypted snapshot, distribute the new key through encrypted
33
33
  messages, and retain enough local state to recover from interruption.
34
34
 
35
35
  `appProfileKeyStorage` implements `ProfileKeyStorage` with `getItem`,
36
36
  `setItem`, and `deleteItem`. Configure it before the first profile-key call.
37
- The built-in React Native path uses Expo SecureStore; the browser fallback is
37
+ The built-in React Native path uses Expo SecureStore. The browser fallback is
38
38
  JavaScript-accessible localStorage. Node and server-side runtimes must provide a
39
39
  persistent implementation if profile keys need to survive process restarts.
40
40
  Storage confidentiality, backup, migration, and account-reset behavior remain
package/remote/README.md CHANGED
@@ -9,7 +9,7 @@ support.
9
9
  ## Why it exists
10
10
 
11
11
  Signal Protocol protects message content but does not provide account
12
- authentication, device discovery, mailbox delivery, or remote object storage.
12
+ authentication, device discovery, mailbox delivery, or a remote object store.
13
13
  Explicit relay and object-store contracts keep those application services
14
14
  replaceable and prevent them from owning private keys or plaintext.
15
15
 
@@ -21,7 +21,7 @@ replaceable and prevent them from owning private keys or plaintext.
21
21
  - `InMemorySignalProtocolRelayServer` from `@open-e2ee/signal-protocol-sdk/remote/relay/memory`
22
22
  - custom implementations via `ISignalProtocolRelayServer`
23
23
 
24
- ### Remote object storage
24
+ ### Remote object store
25
25
 
26
26
  - `ConvexR2ObjectStore` from `@open-e2ee/signal-protocol-sdk/remote/object-store/convex-r2`
27
27
  - `S3ObjectStore` from `@open-e2ee/signal-protocol-sdk/remote/object-store/s3`
@@ -76,13 +76,12 @@ Bundle fetch must preserve one-time-prekey consumption semantics for concurrent
76
76
  - readers need public-key access for session establishment
77
77
  - writers must only mutate their own account/device state
78
78
 
79
- ## Remote Object Storage
79
+ ## Remote Object Store
80
80
 
81
81
  `SignalProtocolRemoteObjectStore` is optional and only needed for encrypted attachment/file flows.
82
82
 
83
83
  In practice, attachment and encrypted file support is a common consumer path,
84
- so object-store adapters should be treated as first-class integrations
85
- alongside relay adapters.
84
+ so give object-store adapters the same standing as relay adapters.
86
85
 
87
86
  The port is deliberately brokered. An authenticated application backend maps a
88
87
  retry-stable `requestId` to a canonical `objectId` and a private provider key,
@@ -111,9 +110,10 @@ const signal = await SignalProtocolClient.create(userId, {
111
110
  });
112
111
  ```
113
112
 
114
- The generated module is accepted directly. `createDownload` and
115
- `completeUpload` are actions because they produce time-sensitive credentials or
116
- await provider metadata; `createUpload` and `deleteObject` are mutations.
113
+ The adapter accepts the generated module directly. The functions
114
+ `createDownload` and `completeUpload` are actions, because they produce
115
+ time-sensitive credentials or await provider metadata. The functions
116
+ `createUpload` and `deleteObject` are mutations.
117
117
 
118
118
  The optional server entry point removes repetitive broker plumbing without
119
119
  taking ownership away from the application:
@@ -154,20 +154,22 @@ The application defines the referenced internal functions in
154
154
  - `resolve` authorizes `download` or `complete` and returns the provider key
155
155
  plus the reserved content type and length.
156
156
  - `complete` re-authorizes the caller and idempotently marks an upload complete
157
- after the helper verifies synchronized R2 metadata. This second authorization
158
- is required because the action's query and mutation are separate transactions.
159
- - `remove` authorizes deletion, records the logical removal, and returns the
160
- stable provider key so component deletion can be scheduled transactionally.
161
-
162
- The helper supplies public validators, extracts expiry from the actual
163
- Signature Version 4 URLs, verifies uploaded size and content type, and calls
164
- the R2 component with the correct Convex contexts. It has no runtime import of
165
- `@convex-dev/r2`; S3-only consumers do not load the component.
157
+ after the helper verifies synchronized R2 metadata. The action needs this
158
+ second authorization because its query and mutation are separate
159
+ transactions.
160
+ - `remove` authorizes deletion and records the logical removal. It returns the
161
+ stable provider key, so the caller can schedule component deletion
162
+ transactionally.
163
+
164
+ The helper supplies public validators and extracts expiry from the actual
165
+ Signature Version 4 URLs. It verifies uploaded size and content type, and it
166
+ calls the R2 component with the correct Convex contexts. It has no runtime
167
+ import of `@convex-dev/r2`. S3-only consumers do not load the component.
166
168
 
167
169
  ### Amazon S3 and S3-compatible storage
168
170
 
169
171
  `S3ObjectStore` is framework-neutral. Supply an authenticated backend broker
170
- that creates presigned operations; AWS SDK clients and AWS credentials remain
172
+ that creates presigned operations. AWS SDK clients and AWS credentials remain
171
173
  on that backend. The broker follows the same identity contract: it receives a
172
174
  retry-stable `requestId`, reserves the private provider key, and returns the
173
175
  canonical `objectId`.
@@ -31,10 +31,14 @@ const remoteObjectStore: SignalProtocolRemoteObjectStore = {
31
31
  };
32
32
  ```
33
33
 
34
- The backend must scope `requestId` to the authenticated principal, return the
35
- same reservation for retries, generate the canonical `objectId`, keep the
36
- provider key private, enforce size/content-type policy, and authorize every
37
- download, completion, and deletion.
34
+ The backend must:
35
+
36
+ - scope `requestId` to the authenticated principal
37
+ - return the same reservation for retries
38
+ - generate the canonical `objectId`
39
+ - keep the provider key private
40
+ - enforce size and content-type policy
41
+ - authorize every download, completion, and deletion
38
42
 
39
43
  Provider adapters:
40
44