@open-e2ee/signal-protocol-sdk 0.1.0-alpha.1 → 0.1.0-alpha.10

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 (1086) hide show
  1. package/ADAPTERS.md +24 -24
  2. package/ARCHITECTURE.md +4 -4
  3. package/CHANGELOG.md +1319 -0
  4. package/COMMERCIAL.md +56 -0
  5. package/NOTICE +3 -1
  6. package/README.md +40 -35
  7. package/SECURITY.md +15 -1
  8. package/blocking/README.md +5 -5
  9. package/client/README.md +5 -5
  10. package/dist/blocking/index.d.ts +2 -2
  11. package/dist/blocking/index.d.ts.map +1 -1
  12. package/dist/blocking/index.js +1 -1
  13. package/dist/blocking/index.js.map +1 -1
  14. package/dist/blocking/manager.d.ts +7 -7
  15. package/dist/blocking/manager.d.ts.map +1 -1
  16. package/dist/blocking/manager.js +3 -3
  17. package/dist/blocking/manager.js.map +1 -1
  18. package/dist/blocking/types.d.ts +4 -4
  19. package/dist/blocking/types.d.ts.map +1 -1
  20. package/dist/blocking/types.js +1 -1
  21. package/dist/client/client.d.ts +48 -41
  22. package/dist/client/client.d.ts.map +1 -1
  23. package/dist/client/client.js +160 -101
  24. package/dist/client/client.js.map +1 -1
  25. package/dist/client/compose.d.ts +15 -10
  26. package/dist/client/compose.d.ts.map +1 -1
  27. package/dist/client/compose.js +2 -0
  28. package/dist/client/compose.js.map +1 -1
  29. package/dist/client/config.d.ts +68 -34
  30. package/dist/client/config.d.ts.map +1 -1
  31. package/dist/client/config.js.map +1 -1
  32. package/dist/client/content-adapter.d.ts +4 -4
  33. package/dist/client/content-adapter.d.ts.map +1 -1
  34. package/dist/client/content-adapter.js +1 -1
  35. package/dist/client/content-adapter.js.map +1 -1
  36. package/dist/client/dual-store.d.ts +5 -5
  37. package/dist/client/dual-store.d.ts.map +1 -1
  38. package/dist/client/dual-store.js.map +1 -1
  39. package/dist/client/endorsement-manager.d.ts +23 -2
  40. package/dist/client/endorsement-manager.d.ts.map +1 -1
  41. package/dist/client/endorsement-manager.js +37 -12
  42. package/dist/client/endorsement-manager.js.map +1 -1
  43. package/dist/client/event-hooks.d.ts +1 -1
  44. package/dist/client/groups.d.ts +29 -29
  45. package/dist/client/groups.d.ts.map +1 -1
  46. package/dist/client/groups.js +54 -37
  47. package/dist/client/groups.js.map +1 -1
  48. package/dist/client/headless.d.ts +12 -12
  49. package/dist/client/headless.d.ts.map +1 -1
  50. package/dist/client/headless.js +9 -9
  51. package/dist/client/headless.js.map +1 -1
  52. package/dist/client/index.d.ts +4 -4
  53. package/dist/client/index.d.ts.map +1 -1
  54. package/dist/client/index.js +1 -1
  55. package/dist/client/index.js.map +1 -1
  56. package/dist/client/key-rotation-core.d.ts +11 -11
  57. package/dist/client/key-rotation-core.d.ts.map +1 -1
  58. package/dist/client/key-rotation-core.js +22 -22
  59. package/dist/client/key-rotation-core.js.map +1 -1
  60. package/dist/client/media.d.ts +2 -2
  61. package/dist/client/media.js +5 -5
  62. package/dist/client/media.js.map +1 -1
  63. package/dist/client/messages.js +2 -2
  64. package/dist/client/messages.js.map +1 -1
  65. package/dist/client/prekeys.js +1 -1
  66. package/dist/client/prekeys.js.map +1 -1
  67. package/dist/client/relay-subscription.d.ts +2 -2
  68. package/dist/client/relay-subscription.d.ts.map +1 -1
  69. package/dist/client/relay-subscription.js +18 -1
  70. package/dist/client/relay-subscription.js.map +1 -1
  71. package/dist/client/retry.js +1 -1
  72. package/dist/client/retry.js.map +1 -1
  73. package/dist/client/sealed-sender-ops.d.ts +28 -2
  74. package/dist/client/sealed-sender-ops.d.ts.map +1 -1
  75. package/dist/client/sealed-sender-ops.js +40 -10
  76. package/dist/client/sealed-sender-ops.js.map +1 -1
  77. package/dist/client/sessions.d.ts.map +1 -1
  78. package/dist/client/sessions.js +3 -0
  79. package/dist/client/sessions.js.map +1 -1
  80. package/dist/client/signal-service-cipher.d.ts +34 -11
  81. package/dist/client/signal-service-cipher.d.ts.map +1 -1
  82. package/dist/client/signal-service-cipher.js +149 -75
  83. package/dist/client/signal-service-cipher.js.map +1 -1
  84. package/dist/client/types.d.ts +28 -15
  85. package/dist/client/types.d.ts.map +1 -1
  86. package/dist/client/types.js.map +1 -1
  87. package/dist/device/connection.js +2 -2
  88. package/dist/device/connection.js.map +1 -1
  89. package/dist/device/device-id.d.ts.map +1 -1
  90. package/dist/device/device-id.js +4 -4
  91. package/dist/device/device-id.js.map +1 -1
  92. package/dist/device/provisioning.d.ts +5 -5
  93. package/dist/device/provisioning.d.ts.map +1 -1
  94. package/dist/device/provisioning.js +9 -9
  95. package/dist/device/provisioning.js.map +1 -1
  96. package/dist/device/transfer.d.ts.map +1 -1
  97. package/dist/device/transfer.js +14 -14
  98. package/dist/device/transfer.js.map +1 -1
  99. package/dist/files/index.d.ts +1 -1
  100. package/dist/files/index.js +1 -1
  101. package/dist/groups/index.d.ts +4 -4
  102. package/dist/groups/index.d.ts.map +1 -1
  103. package/dist/groups/index.js +3 -3
  104. package/dist/groups/index.js.map +1 -1
  105. package/dist/hooks/use-connection-presence.d.ts +5 -5
  106. package/dist/hooks/use-connection-presence.d.ts.map +1 -1
  107. package/dist/hooks/use-connection-presence.js +5 -5
  108. package/dist/hooks/use-connection-presence.js.map +1 -1
  109. package/dist/hooks/use-group-membership.d.ts +2 -2
  110. package/dist/hooks/use-key-rotation.js +2 -2
  111. package/dist/hooks/use-key-rotation.js.map +1 -1
  112. package/dist/index.d.ts +29 -22
  113. package/dist/index.d.ts.map +1 -1
  114. package/dist/index.js +20 -13
  115. package/dist/index.js.map +1 -1
  116. package/dist/internal/crypto/ec/x25519-validation.d.ts.map +1 -1
  117. package/dist/internal/crypto/ec/x25519-validation.js +4 -4
  118. package/dist/internal/crypto/ec/x25519-validation.js.map +1 -1
  119. package/dist/internal/crypto/index.d.ts +1 -1
  120. package/dist/internal/crypto/index.d.ts.map +1 -1
  121. package/dist/internal/crypto/index.js +2 -2
  122. package/dist/internal/crypto/index.js.map +1 -1
  123. package/dist/internal/crypto/kdf/hkdf.d.ts +1 -1
  124. package/dist/internal/crypto/kdf/hkdf.d.ts.map +1 -1
  125. package/dist/internal/crypto/kdf/hkdf.js +2 -2
  126. package/dist/internal/crypto/kdf/hkdf.js.map +1 -1
  127. package/dist/internal/crypto/key-prefix.d.ts +1 -1
  128. package/dist/internal/crypto/key-prefix.js +1 -1
  129. package/dist/internal/crypto/pq/kyber.d.ts +1 -1
  130. package/dist/internal/crypto/pq/kyber.js +1 -1
  131. package/dist/internal/crypto/random.d.ts +9 -0
  132. package/dist/internal/crypto/random.d.ts.map +1 -1
  133. package/dist/internal/crypto/random.js +16 -0
  134. package/dist/internal/crypto/random.js.map +1 -1
  135. package/dist/internal/crypto/symmetric/aes-gcm-siv.d.ts +1 -1
  136. package/dist/internal/crypto/symmetric/aes-gcm-siv.js +1 -1
  137. package/dist/internal/crypto/symmetric/mac.d.ts +3 -3
  138. package/dist/internal/crypto/symmetric/mac.js +3 -3
  139. package/dist/internal/crypto/utils.d.ts +2 -2
  140. package/dist/internal/crypto/utils.js +2 -2
  141. package/dist/internal/encoding/proto/envelope.d.ts +21 -21
  142. package/dist/internal/encoding/proto/envelope.d.ts.map +1 -1
  143. package/dist/internal/encoding/proto/envelope.js +25 -25
  144. package/dist/internal/encoding/proto/envelope.js.map +1 -1
  145. package/dist/internal/encoding/proto/index.d.ts +2 -2
  146. package/dist/internal/encoding/proto/index.d.ts.map +1 -1
  147. package/dist/internal/encoding/proto/index.js +3 -3
  148. package/dist/internal/encoding/proto/index.js.map +1 -1
  149. package/dist/internal/encoding/proto/pq-ratchet-serialize.d.ts +5 -5
  150. package/dist/internal/encoding/proto/pq-ratchet-serialize.d.ts.map +1 -1
  151. package/dist/internal/encoding/proto/pq-ratchet-serialize.js +4 -4
  152. package/dist/internal/encoding/proto/pq-ratchet-serialize.js.map +1 -1
  153. package/dist/internal/encoding/proto/primitives.d.ts +261 -6
  154. package/dist/internal/encoding/proto/primitives.d.ts.map +1 -1
  155. package/dist/internal/encoding/proto/primitives.js +468 -6
  156. package/dist/internal/encoding/proto/primitives.js.map +1 -1
  157. package/dist/internal/encoding/proto/sender-key-message.d.ts +4 -3
  158. package/dist/internal/encoding/proto/sender-key-message.d.ts.map +1 -1
  159. package/dist/internal/encoding/proto/sender-key-message.js +97 -76
  160. package/dist/internal/encoding/proto/sender-key-message.js.map +1 -1
  161. package/dist/internal/encoding/proto/signal-message.d.ts +39 -34
  162. package/dist/internal/encoding/proto/signal-message.d.ts.map +1 -1
  163. package/dist/internal/encoding/proto/signal-message.js +236 -152
  164. package/dist/internal/encoding/proto/signal-message.js.map +1 -1
  165. package/dist/internal/groups/access-control.d.ts +170 -0
  166. package/dist/internal/groups/access-control.d.ts.map +1 -0
  167. package/dist/internal/groups/access-control.js +284 -0
  168. package/dist/internal/groups/access-control.js.map +1 -0
  169. package/dist/internal/groups/change-actions.d.ts +57 -0
  170. package/dist/internal/groups/change-actions.d.ts.map +1 -0
  171. package/dist/internal/groups/change-actions.js +827 -0
  172. package/dist/internal/groups/change-actions.js.map +1 -0
  173. package/dist/internal/groups/change-authorization.d.ts +16 -0
  174. package/dist/internal/groups/change-authorization.d.ts.map +1 -0
  175. package/dist/internal/groups/change-authorization.js +120 -0
  176. package/dist/internal/groups/change-authorization.js.map +1 -0
  177. package/dist/internal/{groups-v2 → groups}/encrypted-state.d.ts +12 -2
  178. package/dist/internal/groups/encrypted-state.d.ts.map +1 -0
  179. package/dist/internal/{groups-v2 → groups}/encrypted-state.js +122 -22
  180. package/dist/internal/groups/encrypted-state.js.map +1 -0
  181. package/dist/internal/groups/group-id.d.ts +9 -9
  182. package/dist/internal/groups/group-id.d.ts.map +1 -1
  183. package/dist/internal/groups/group-id.js +11 -12
  184. package/dist/internal/groups/group-id.js.map +1 -1
  185. package/dist/internal/groups/index.d.ts +16 -6
  186. package/dist/internal/groups/index.d.ts.map +1 -1
  187. package/dist/internal/groups/index.js +9 -1
  188. package/dist/internal/groups/index.js.map +1 -1
  189. package/dist/internal/groups/invite-link.d.ts.map +1 -0
  190. package/dist/internal/groups/invite-link.js.map +1 -0
  191. package/dist/internal/{groups-v2 → groups}/manager.d.ts +212 -43
  192. package/dist/internal/groups/manager.d.ts.map +1 -0
  193. package/dist/internal/groups/manager.js +1945 -0
  194. package/dist/internal/groups/manager.js.map +1 -0
  195. package/dist/internal/groups/sdk-store.d.ts +32 -0
  196. package/dist/internal/groups/sdk-store.d.ts.map +1 -0
  197. package/dist/internal/groups/sdk-store.js +111 -0
  198. package/dist/internal/groups/sdk-store.js.map +1 -0
  199. package/dist/internal/groups/server-engine.d.ts +98 -0
  200. package/dist/internal/groups/server-engine.d.ts.map +1 -0
  201. package/dist/internal/groups/server-engine.js +1235 -0
  202. package/dist/internal/groups/server-engine.js.map +1 -0
  203. package/dist/internal/groups/trust-root.d.ts +32 -0
  204. package/dist/internal/groups/trust-root.d.ts.map +1 -0
  205. package/dist/internal/groups/trust-root.js +91 -0
  206. package/dist/internal/groups/trust-root.js.map +1 -0
  207. package/dist/internal/{groups-v2 → groups}/types.d.ts +190 -41
  208. package/dist/internal/groups/types.d.ts.map +1 -0
  209. package/dist/internal/{groups-v2 → groups}/types.js +3 -2
  210. package/dist/internal/groups/types.js.map +1 -0
  211. package/dist/internal/groups/wire.d.ts +68 -0
  212. package/dist/internal/groups/wire.d.ts.map +1 -0
  213. package/dist/internal/groups/wire.js +708 -0
  214. package/dist/internal/groups/wire.js.map +1 -0
  215. package/dist/internal/manager/manager.d.ts +4 -4
  216. package/dist/internal/manager/manager.d.ts.map +1 -1
  217. package/dist/internal/manager/manager.js +28 -17
  218. package/dist/internal/manager/manager.js.map +1 -1
  219. package/dist/internal/protocol/double-ratchet/chains.d.ts +1 -1
  220. package/dist/internal/protocol/double-ratchet/chains.d.ts.map +1 -1
  221. package/dist/internal/protocol/double-ratchet/chains.js +10 -10
  222. package/dist/internal/protocol/double-ratchet/chains.js.map +1 -1
  223. package/dist/internal/protocol/double-ratchet/ratchet.d.ts +3 -3
  224. package/dist/internal/protocol/double-ratchet/ratchet.d.ts.map +1 -1
  225. package/dist/internal/protocol/double-ratchet/ratchet.js +3 -3
  226. package/dist/internal/protocol/double-ratchet/ratchet.js.map +1 -1
  227. package/dist/internal/protocol/pqxdh/pqxdh.d.ts.map +1 -1
  228. package/dist/internal/protocol/pqxdh/pqxdh.js +3 -3
  229. package/dist/internal/protocol/pqxdh/pqxdh.js.map +1 -1
  230. package/dist/internal/protocol/sealed-sender/decryption-v2.d.ts.map +1 -1
  231. package/dist/internal/protocol/sealed-sender/decryption-v2.js +32 -18
  232. package/dist/internal/protocol/sealed-sender/decryption-v2.js.map +1 -1
  233. package/dist/internal/protocol/sealed-sender/decryption.d.ts.map +1 -1
  234. package/dist/internal/protocol/sealed-sender/decryption.js +35 -21
  235. package/dist/internal/protocol/sealed-sender/decryption.js.map +1 -1
  236. package/dist/internal/protocol/sealed-sender/encryption-v2.d.ts.map +1 -1
  237. package/dist/internal/protocol/sealed-sender/encryption-v2.js +8 -14
  238. package/dist/internal/protocol/sealed-sender/encryption-v2.js.map +1 -1
  239. package/dist/internal/protocol/sealed-sender/encryption.d.ts +9 -4
  240. package/dist/internal/protocol/sealed-sender/encryption.d.ts.map +1 -1
  241. package/dist/internal/protocol/sealed-sender/encryption.js +7 -15
  242. package/dist/internal/protocol/sealed-sender/encryption.js.map +1 -1
  243. package/dist/internal/protocol/sealed-sender/proto/index.d.ts +56 -11
  244. package/dist/internal/protocol/sealed-sender/proto/index.d.ts.map +1 -1
  245. package/dist/internal/protocol/sealed-sender/proto/index.js +272 -157
  246. package/dist/internal/protocol/sealed-sender/proto/index.js.map +1 -1
  247. package/dist/internal/protocol/sealed-sender/trust-root.d.ts +45 -0
  248. package/dist/internal/protocol/sealed-sender/trust-root.d.ts.map +1 -0
  249. package/dist/internal/protocol/sealed-sender/trust-root.js +77 -0
  250. package/dist/internal/protocol/sealed-sender/trust-root.js.map +1 -0
  251. package/dist/internal/protocol/sealed-sender/types.d.ts +65 -10
  252. package/dist/internal/protocol/sealed-sender/types.d.ts.map +1 -1
  253. package/dist/internal/protocol/sealed-sender/types.js +44 -1
  254. package/dist/internal/protocol/sealed-sender/types.js.map +1 -1
  255. package/dist/internal/protocol/sender-keys/index.d.ts +1 -1
  256. package/dist/internal/protocol/sender-keys/manager.d.ts +41 -4
  257. package/dist/internal/protocol/sender-keys/manager.d.ts.map +1 -1
  258. package/dist/internal/protocol/sender-keys/manager.js +113 -12
  259. package/dist/internal/protocol/sender-keys/manager.js.map +1 -1
  260. package/dist/internal/protocol/spqr/index.d.ts +1 -1
  261. package/dist/internal/protocol/spqr/index.js +1 -1
  262. package/dist/internal/protocol/spqr/message.d.ts +1 -1
  263. package/dist/internal/protocol/spqr/message.js +1 -1
  264. package/dist/internal/protocol/spqr/ml-kem-braid/rs/codec.d.ts +3 -3
  265. package/dist/internal/protocol/spqr/ml-kem-braid/rs/codec.d.ts.map +1 -1
  266. package/dist/internal/protocol/spqr/ml-kem-braid/rs/index.js +2 -2
  267. package/dist/internal/protocol/spqr/ml-kem-braid/rs/index.js.map +1 -1
  268. package/dist/internal/protocol/spqr/ml-kem-braid/rs/lagrange.d.ts +1 -1
  269. package/dist/internal/protocol/spqr/ml-kem-braid/rs/lagrange.js +1 -1
  270. package/dist/internal/protocol/spqr/ml-kem-braid/rs/lagrange.js.map +1 -1
  271. package/dist/internal/protocol/spqr/ml-kem-braid/serialize.d.ts +8 -2
  272. package/dist/internal/protocol/spqr/ml-kem-braid/serialize.d.ts.map +1 -1
  273. package/dist/internal/protocol/spqr/ml-kem-braid/serialize.js +335 -152
  274. package/dist/internal/protocol/spqr/ml-kem-braid/serialize.js.map +1 -1
  275. package/dist/internal/protocol/spqr/ml-kem-braid/state-machine.js +5 -5
  276. package/dist/internal/protocol/spqr/ml-kem-braid/state-machine.js.map +1 -1
  277. package/dist/internal/protocol/spqr/ml-kem-braid/types.d.ts +1 -1
  278. package/dist/internal/protocol/spqr/ml-kem-braid/types.d.ts.map +1 -1
  279. package/dist/internal/protocol/spqr/spqr.d.ts +10 -10
  280. package/dist/internal/protocol/spqr/spqr.d.ts.map +1 -1
  281. package/dist/internal/protocol/spqr/spqr.js +14 -14
  282. package/dist/internal/protocol/spqr/spqr.js.map +1 -1
  283. package/dist/internal/protocol/triple-ratchet/ratchet.d.ts +3 -3
  284. package/dist/internal/protocol/triple-ratchet/ratchet.d.ts.map +1 -1
  285. package/dist/internal/protocol/triple-ratchet/ratchet.js +5 -5
  286. package/dist/internal/protocol/triple-ratchet/ratchet.js.map +1 -1
  287. package/dist/internal/protocol/username/generate.d.ts +1 -1
  288. package/dist/internal/protocol/username/generate.js +1 -1
  289. package/dist/internal/protocol/username/hash.d.ts +1 -1
  290. package/dist/internal/protocol/username/hash.js +1 -1
  291. package/dist/internal/protocol/username/link.d.ts +1 -1
  292. package/dist/internal/protocol/username/link.js +1 -1
  293. package/dist/internal/protocol/username/proof.d.ts +1 -1
  294. package/dist/internal/protocol/username/proof.js +1 -1
  295. package/dist/internal/protocol/x3dh/x3dh.d.ts.map +1 -1
  296. package/dist/internal/protocol/x3dh/x3dh.js +6 -6
  297. package/dist/internal/protocol/x3dh/x3dh.js.map +1 -1
  298. package/dist/internal/protocol/zk/groups/auth-credential.d.ts +14 -11
  299. package/dist/internal/protocol/zk/groups/auth-credential.d.ts.map +1 -1
  300. package/dist/internal/protocol/zk/groups/auth-credential.js +68 -29
  301. package/dist/internal/protocol/zk/groups/auth-credential.js.map +1 -1
  302. package/dist/internal/protocol/zk/groups/client-zk-group-cipher.d.ts +2 -2
  303. package/dist/internal/protocol/zk/groups/client-zk-group-cipher.js +2 -2
  304. package/dist/internal/protocol/zk/groups/server-params.d.ts +1 -1
  305. package/dist/internal/protocol/zk/groups/server-params.d.ts.map +1 -1
  306. package/dist/internal/protocol/zk/groups/server-params.js.map +1 -1
  307. package/dist/internal/protocol/zk/groups/uid-struct.d.ts +2 -0
  308. package/dist/internal/protocol/zk/groups/uid-struct.d.ts.map +1 -1
  309. package/dist/internal/protocol/zk/groups/uid-struct.js +4 -0
  310. package/dist/internal/protocol/zk/groups/uid-struct.js.map +1 -1
  311. package/dist/internal/sesame/device-registry.d.ts +18 -13
  312. package/dist/internal/sesame/device-registry.d.ts.map +1 -1
  313. package/dist/internal/sesame/device-registry.js +13 -9
  314. package/dist/internal/sesame/device-registry.js.map +1 -1
  315. package/dist/internal/sesame/manager.d.ts +1 -1
  316. package/dist/internal/sesame/manager.d.ts.map +1 -1
  317. package/dist/internal/sesame/manager.js +66 -34
  318. package/dist/internal/sesame/manager.js.map +1 -1
  319. package/dist/internal/sesame/types.d.ts.map +1 -1
  320. package/dist/internal/sesame/types.js +7 -2
  321. package/dist/internal/sesame/types.js.map +1 -1
  322. package/dist/internal/session/builder.js +3 -3
  323. package/dist/internal/session/builder.js.map +1 -1
  324. package/dist/internal/session/cipher.d.ts +2 -2
  325. package/dist/internal/session/cipher.d.ts.map +1 -1
  326. package/dist/internal/session/cipher.js +38 -30
  327. package/dist/internal/session/cipher.js.map +1 -1
  328. package/dist/internal/session/decryption.d.ts +1 -1
  329. package/dist/internal/session/decryption.js +10 -10
  330. package/dist/internal/session/decryption.js.map +1 -1
  331. package/dist/internal/session/factory.d.ts.map +1 -1
  332. package/dist/internal/session/factory.js +3 -3
  333. package/dist/internal/session/factory.js.map +1 -1
  334. package/dist/internal/session/handshake.d.ts.map +1 -1
  335. package/dist/internal/session/handshake.js +3 -3
  336. package/dist/internal/session/handshake.js.map +1 -1
  337. package/dist/internal/session/keys.d.ts +1 -1
  338. package/dist/internal/session/ratchet.d.ts.map +1 -1
  339. package/dist/internal/session/ratchet.js +4 -4
  340. package/dist/internal/session/ratchet.js.map +1 -1
  341. package/dist/internal/session/types.d.ts +2 -2
  342. package/dist/internal/session/types.d.ts.map +1 -1
  343. package/dist/internal/session/validation.d.ts.map +1 -1
  344. package/dist/internal/session/validation.js +3 -3
  345. package/dist/internal/session/validation.js.map +1 -1
  346. package/dist/keys/generation.d.ts +4 -3
  347. package/dist/keys/generation.d.ts.map +1 -1
  348. package/dist/keys/generation.js +2 -2
  349. package/dist/keys/generation.js.map +1 -1
  350. package/dist/keys/identity.d.ts +32 -0
  351. package/dist/keys/identity.d.ts.map +1 -1
  352. package/dist/keys/identity.js +55 -0
  353. package/dist/keys/identity.js.map +1 -1
  354. package/dist/keys/index.d.ts +1 -1
  355. package/dist/keys/index.d.ts.map +1 -1
  356. package/dist/keys/index.js +1 -1
  357. package/dist/keys/index.js.map +1 -1
  358. package/dist/keys/types.d.ts +1 -1
  359. package/dist/keys/types.d.ts.map +1 -1
  360. package/dist/layers.d.ts +5 -5
  361. package/dist/layers.d.ts.map +1 -1
  362. package/dist/layers.js +9 -9
  363. package/dist/layers.js.map +1 -1
  364. package/dist/local/store/expo/adapter.d.ts +28 -25
  365. package/dist/local/store/expo/adapter.d.ts.map +1 -1
  366. package/dist/local/store/expo/adapter.js +125 -113
  367. package/dist/local/store/expo/adapter.js.map +1 -1
  368. package/dist/local/store/expo/database-key.d.ts +2 -2
  369. package/dist/local/store/expo/database-key.d.ts.map +1 -1
  370. package/dist/local/store/expo/database-key.js +5 -5
  371. package/dist/local/store/expo/database-key.js.map +1 -1
  372. package/dist/local/store/expo/db.d.ts +13 -10
  373. package/dist/local/store/expo/db.d.ts.map +1 -1
  374. package/dist/local/store/expo/db.js +8 -3
  375. package/dist/local/store/expo/db.js.map +1 -1
  376. package/dist/local/store/expo/index.d.ts +5 -7
  377. package/dist/local/store/expo/index.d.ts.map +1 -1
  378. package/dist/local/store/expo/index.js +3 -3
  379. package/dist/local/store/expo/index.js.map +1 -1
  380. package/dist/local/store/expo/key-storage.d.ts +1 -1
  381. package/dist/local/store/expo/key-storage.d.ts.map +1 -1
  382. package/dist/local/store/expo/key-storage.js +4 -4
  383. package/dist/local/store/expo/key-storage.js.map +1 -1
  384. package/dist/local/store/expo/models/index.d.ts +1 -1
  385. package/dist/local/store/expo/models/index.d.ts.map +1 -1
  386. package/dist/local/store/expo/models/index.js +2 -2
  387. package/dist/local/store/expo/models/index.js.map +1 -1
  388. package/dist/local/store/expo/models/local-identity.d.ts +1 -1
  389. package/dist/local/store/expo/models/local-identity.js +1 -1
  390. package/dist/local/store/expo/models/sender-key.d.ts +101 -77
  391. package/dist/local/store/expo/models/sender-key.d.ts.map +1 -1
  392. package/dist/local/store/expo/models/sender-key.js +154 -124
  393. package/dist/local/store/expo/models/sender-key.js.map +1 -1
  394. package/dist/local/store/expo/schema.d.ts +135 -33
  395. package/dist/local/store/expo/schema.d.ts.map +1 -1
  396. package/dist/local/store/expo/schema.js +37 -8
  397. package/dist/local/store/expo/schema.js.map +1 -1
  398. package/dist/local/store/expo/secure-store-options.d.ts +2 -2
  399. package/dist/local/store/expo/secure-store-options.d.ts.map +1 -1
  400. package/dist/local/store/expo/secure-store-options.js +1 -1
  401. package/dist/local/store/expo/secure-store-options.js.map +1 -1
  402. package/dist/local/store/index.d.ts +9 -9
  403. package/dist/local/store/index.d.ts.map +1 -1
  404. package/dist/local/store/index.js +9 -9
  405. package/dist/local/store/index.js.map +1 -1
  406. package/dist/local/store/{mock → memory}/adapter.d.ts +14 -7
  407. package/dist/local/store/memory/adapter.d.ts.map +1 -0
  408. package/dist/local/store/{mock → memory}/adapter.js +156 -58
  409. package/dist/local/store/memory/adapter.js.map +1 -0
  410. package/dist/local/store/memory/failures.d.ts +34 -0
  411. package/dist/local/store/memory/failures.d.ts.map +1 -0
  412. package/dist/local/store/memory/failures.js +75 -0
  413. package/dist/local/store/memory/failures.js.map +1 -0
  414. package/dist/local/store/memory/index.d.ts +11 -0
  415. package/dist/local/store/memory/index.d.ts.map +1 -0
  416. package/dist/local/store/memory/index.js +7 -0
  417. package/dist/local/store/memory/index.js.map +1 -0
  418. package/dist/local/store/node/adapter.d.ts +56 -7
  419. package/dist/local/store/node/adapter.d.ts.map +1 -1
  420. package/dist/local/store/node/adapter.js +458 -11
  421. package/dist/local/store/node/adapter.js.map +1 -1
  422. package/dist/local/store/node/database-key.js +1 -1
  423. package/dist/local/store/node/database.d.ts +68 -0
  424. package/dist/local/store/node/database.d.ts.map +1 -1
  425. package/dist/local/store/node/database.js +203 -20
  426. package/dist/local/store/node/database.js.map +1 -1
  427. package/dist/local/store/node/index.d.ts +4 -4
  428. package/dist/local/store/node/index.d.ts.map +1 -1
  429. package/dist/local/store/node/index.js +3 -3
  430. package/dist/local/store/node/index.js.map +1 -1
  431. package/dist/local/store/react-native/adapter.d.ts +44 -5
  432. package/dist/local/store/react-native/adapter.d.ts.map +1 -1
  433. package/dist/local/store/react-native/adapter.js +177 -22
  434. package/dist/local/store/react-native/adapter.js.map +1 -1
  435. package/dist/local/store/react-native/index.d.ts +4 -4
  436. package/dist/local/store/react-native/index.d.ts.map +1 -1
  437. package/dist/local/store/react-native/index.js +3 -3
  438. package/dist/local/store/react-native/index.js.map +1 -1
  439. package/dist/local/store/react-native/storage.d.ts +2 -2
  440. package/dist/local/store/web/adapter.d.ts +5 -4
  441. package/dist/local/store/web/adapter.d.ts.map +1 -1
  442. package/dist/local/store/web/adapter.js +54 -10
  443. package/dist/local/store/web/adapter.js.map +1 -1
  444. package/dist/local/store/web/index.d.ts +4 -4
  445. package/dist/local/store/web/index.d.ts.map +1 -1
  446. package/dist/local/store/web/index.js +3 -3
  447. package/dist/local/store/web/index.js.map +1 -1
  448. package/dist/local/vault/expo-secure-store.d.ts +2 -2
  449. package/dist/local/vault/expo-secure-store.d.ts.map +1 -1
  450. package/dist/local/vault/expo-secure-store.js +5 -5
  451. package/dist/local/vault/expo-secure-store.js.map +1 -1
  452. package/dist/local/vault/index.d.ts +3 -3
  453. package/dist/local/vault/index.d.ts.map +1 -1
  454. package/dist/local/vault/index.js +1 -1
  455. package/dist/local/vault/index.js.map +1 -1
  456. package/dist/logger.d.ts +4 -4
  457. package/dist/logger.d.ts.map +1 -1
  458. package/dist/logger.js +5 -5
  459. package/dist/logger.js.map +1 -1
  460. package/dist/media/index.d.ts +7 -7
  461. package/dist/media/index.d.ts.map +1 -1
  462. package/dist/media/index.js +2 -2
  463. package/dist/profile/cipher.d.ts +1 -1
  464. package/dist/profile/cipher.js +1 -1
  465. package/dist/profile/contact-state.d.ts +1 -1
  466. package/dist/profile/contact-state.d.ts.map +1 -1
  467. package/dist/profile/contact-state.js +3 -3
  468. package/dist/profile/contact-state.js.map +1 -1
  469. package/dist/profile/crypto.d.ts +1 -1
  470. package/dist/profile/crypto.js +1 -1
  471. package/dist/profile/profile-key.d.ts.map +1 -1
  472. package/dist/profile/profile-key.js +3 -3
  473. package/dist/profile/profile-key.js.map +1 -1
  474. package/dist/profile/update-service.d.ts +2 -2
  475. package/dist/profile/update-service.d.ts.map +1 -1
  476. package/dist/profile/update-service.js +2 -2
  477. package/dist/profile/update-service.js.map +1 -1
  478. package/dist/remote/object-store/convex-r2/server.d.ts +1 -1
  479. package/dist/remote/object-store/convex-r2/storage.d.ts +2 -2
  480. package/dist/remote/object-store/convex-r2/storage.d.ts.map +1 -1
  481. package/dist/remote/object-store/index.d.ts +1 -1
  482. package/dist/remote/object-store/index.d.ts.map +1 -1
  483. package/dist/remote/object-store/s3/storage.d.ts +3 -3
  484. package/dist/remote/object-store/s3/storage.d.ts.map +1 -1
  485. package/dist/remote/object-store/s3/storage.js +1 -1
  486. package/dist/remote/object-store/types.d.ts +1 -1
  487. package/dist/remote/object-store/types.d.ts.map +1 -1
  488. package/dist/remote/relay/convex/backend.d.ts +405 -0
  489. package/dist/remote/relay/convex/backend.d.ts.map +1 -0
  490. package/dist/remote/relay/convex/backend.js +687 -0
  491. package/dist/remote/relay/convex/backend.js.map +1 -0
  492. package/dist/remote/relay/convex/component/_generated/api.d.ts +58 -0
  493. package/dist/remote/relay/convex/component/_generated/api.d.ts.map +1 -0
  494. package/dist/remote/relay/convex/component/_generated/api.js +31 -0
  495. package/dist/remote/relay/convex/component/_generated/api.js.map +1 -0
  496. package/dist/remote/relay/convex/component/_generated/component.d.ts +483 -0
  497. package/dist/remote/relay/convex/component/_generated/component.d.ts.map +1 -0
  498. package/dist/remote/relay/convex/component/_generated/component.js +11 -0
  499. package/dist/remote/relay/convex/component/_generated/component.js.map +1 -0
  500. package/dist/remote/relay/convex/component/_generated/dataModel.d.ts +46 -0
  501. package/dist/remote/relay/convex/component/_generated/dataModel.d.ts.map +1 -0
  502. package/dist/remote/relay/convex/component/_generated/dataModel.js +11 -0
  503. package/dist/remote/relay/convex/component/_generated/dataModel.js.map +1 -0
  504. package/dist/remote/relay/convex/component/_generated/server.d.ts +129 -0
  505. package/dist/remote/relay/convex/component/_generated/server.d.ts.map +1 -0
  506. package/dist/remote/relay/convex/component/_generated/server.js +79 -0
  507. package/dist/remote/relay/convex/component/_generated/server.js.map +1 -0
  508. package/dist/remote/relay/convex/component/accounts.d.ts +43 -0
  509. package/dist/remote/relay/convex/component/accounts.d.ts.map +1 -0
  510. package/dist/remote/relay/convex/component/accounts.js +181 -0
  511. package/dist/remote/relay/convex/component/accounts.js.map +1 -0
  512. package/dist/remote/relay/convex/component/certificates.d.ts +10 -0
  513. package/dist/remote/relay/convex/component/certificates.d.ts.map +1 -0
  514. package/dist/remote/relay/convex/component/certificates.js +117 -0
  515. package/dist/remote/relay/convex/component/certificates.js.map +1 -0
  516. package/dist/remote/relay/convex/component/cleanup.d.ts +32 -0
  517. package/dist/remote/relay/convex/component/cleanup.d.ts.map +1 -0
  518. package/dist/remote/relay/convex/component/cleanup.js +146 -0
  519. package/dist/remote/relay/convex/component/cleanup.js.map +1 -0
  520. package/dist/remote/relay/convex/component/convex.config.d.ts +5 -0
  521. package/dist/remote/relay/convex/component/convex.config.d.ts.map +1 -0
  522. package/dist/remote/relay/convex/component/convex.config.js +33 -0
  523. package/dist/remote/relay/convex/component/convex.config.js.map +1 -0
  524. package/dist/remote/relay/convex/component/crons.d.ts +3 -0
  525. package/dist/remote/relay/convex/component/crons.d.ts.map +1 -0
  526. package/dist/remote/relay/convex/component/crons.js +10 -0
  527. package/dist/remote/relay/convex/component/crons.js.map +1 -0
  528. package/dist/remote/relay/convex/component/devices.d.ts +101 -0
  529. package/dist/remote/relay/convex/component/devices.d.ts.map +1 -0
  530. package/dist/remote/relay/convex/component/devices.js +299 -0
  531. package/dist/remote/relay/convex/component/devices.js.map +1 -0
  532. package/dist/remote/relay/convex/component/errors.d.ts +22 -0
  533. package/dist/remote/relay/convex/component/errors.d.ts.map +1 -0
  534. package/dist/remote/relay/convex/component/errors.js +17 -0
  535. package/dist/remote/relay/convex/component/errors.js.map +1 -0
  536. package/dist/remote/relay/convex/component/groups.d.ts +63 -0
  537. package/dist/remote/relay/convex/component/groups.d.ts.map +1 -0
  538. package/dist/remote/relay/convex/component/groups.js +341 -0
  539. package/dist/remote/relay/convex/component/groups.js.map +1 -0
  540. package/dist/remote/relay/convex/component/keys.d.ts +130 -0
  541. package/dist/remote/relay/convex/component/keys.d.ts.map +1 -0
  542. package/dist/remote/relay/convex/component/keys.js +578 -0
  543. package/dist/remote/relay/convex/component/keys.js.map +1 -0
  544. package/dist/remote/relay/convex/component/messages.d.ts +119 -0
  545. package/dist/remote/relay/convex/component/messages.d.ts.map +1 -0
  546. package/dist/remote/relay/convex/component/messages.js +723 -0
  547. package/dist/remote/relay/convex/component/messages.js.map +1 -0
  548. package/dist/remote/relay/convex/component/provisioning.d.ts +92 -0
  549. package/dist/remote/relay/convex/component/provisioning.d.ts.map +1 -0
  550. package/dist/remote/relay/convex/component/provisioning.js +359 -0
  551. package/dist/remote/relay/convex/component/provisioning.js.map +1 -0
  552. package/dist/remote/relay/convex/component/runtime.d.ts +18 -0
  553. package/dist/remote/relay/convex/component/runtime.d.ts.map +1 -0
  554. package/dist/remote/relay/convex/component/runtime.js +142 -0
  555. package/dist/remote/relay/convex/component/runtime.js.map +1 -0
  556. package/dist/remote/relay/convex/component/schema.d.ts +358 -0
  557. package/dist/remote/relay/convex/component/schema.d.ts.map +1 -0
  558. package/dist/remote/relay/convex/component/schema.js +287 -0
  559. package/dist/remote/relay/convex/component/schema.js.map +1 -0
  560. package/dist/remote/relay/convex/component/zkAuth.d.ts +12 -0
  561. package/dist/remote/relay/convex/component/zkAuth.d.ts.map +1 -0
  562. package/dist/remote/relay/convex/component/zkAuth.js +71 -0
  563. package/dist/remote/relay/convex/component/zkAuth.js.map +1 -0
  564. package/dist/remote/relay/convex/constants.d.ts +3 -0
  565. package/dist/remote/relay/convex/constants.d.ts.map +1 -0
  566. package/dist/remote/relay/convex/constants.js +3 -0
  567. package/dist/remote/relay/convex/constants.js.map +1 -0
  568. package/dist/remote/relay/convex/group-server.d.ts +29 -24
  569. package/dist/remote/relay/convex/group-server.d.ts.map +1 -1
  570. package/dist/remote/relay/convex/group-server.js +62 -28
  571. package/dist/remote/relay/convex/group-server.js.map +1 -1
  572. package/dist/remote/relay/convex/index.d.ts +14 -11
  573. package/dist/remote/relay/convex/index.d.ts.map +1 -1
  574. package/dist/remote/relay/convex/index.js +9 -7
  575. package/dist/remote/relay/convex/index.js.map +1 -1
  576. package/dist/remote/relay/convex/relay.d.ts +67 -80
  577. package/dist/remote/relay/convex/relay.d.ts.map +1 -1
  578. package/dist/remote/relay/convex/relay.js +143 -59
  579. package/dist/remote/relay/convex/relay.js.map +1 -1
  580. package/dist/remote/relay/convex/types.d.ts +16 -103
  581. package/dist/remote/relay/convex/types.d.ts.map +1 -1
  582. package/dist/remote/relay/convex/types.js +8 -13
  583. package/dist/remote/relay/convex/types.js.map +1 -1
  584. package/dist/remote/relay/index.d.ts +7 -7
  585. package/dist/remote/relay/index.d.ts.map +1 -1
  586. package/dist/remote/relay/index.js +7 -7
  587. package/dist/remote/relay/index.js.map +1 -1
  588. package/dist/remote/relay/{mock → memory}/adapter.d.ts +55 -31
  589. package/dist/remote/relay/memory/adapter.d.ts.map +1 -0
  590. package/dist/remote/relay/{mock → memory}/adapter.js +276 -135
  591. package/dist/remote/relay/memory/adapter.js.map +1 -0
  592. package/dist/remote/relay/memory/failures.d.ts +58 -0
  593. package/dist/remote/relay/memory/failures.d.ts.map +1 -0
  594. package/dist/remote/relay/memory/failures.js +123 -0
  595. package/dist/remote/relay/memory/failures.js.map +1 -0
  596. package/dist/remote/relay/memory/group-server.d.ts +9 -0
  597. package/dist/remote/relay/memory/group-server.d.ts.map +1 -0
  598. package/dist/remote/relay/memory/group-server.js +9 -0
  599. package/dist/remote/relay/memory/group-server.js.map +1 -0
  600. package/dist/remote/relay/memory/index.d.ts +11 -0
  601. package/dist/remote/relay/memory/index.d.ts.map +1 -0
  602. package/dist/remote/relay/memory/index.js +7 -0
  603. package/dist/remote/relay/memory/index.js.map +1 -0
  604. package/dist/remote/relay/types.d.ts +99 -86
  605. package/dist/remote/relay/types.d.ts.map +1 -1
  606. package/dist/remote/relay/types.js +2 -3
  607. package/dist/remote/relay/types.js.map +1 -1
  608. package/dist/safety/protobuf.d.ts +1 -1
  609. package/dist/safety/protobuf.d.ts.map +1 -1
  610. package/dist/types/api.d.ts +42 -17
  611. package/dist/types/api.d.ts.map +1 -1
  612. package/dist/types/errors.d.ts +2 -2
  613. package/dist/types/errors.d.ts.map +1 -1
  614. package/dist/types/errors.js +2 -2
  615. package/dist/types/errors.js.map +1 -1
  616. package/dist/types/messages.d.ts +1 -1
  617. package/dist/types/protocol-config.d.ts +71 -4
  618. package/dist/types/protocol-config.d.ts.map +1 -1
  619. package/dist/types/protocol-config.js +63 -2
  620. package/dist/types/protocol-config.js.map +1 -1
  621. package/dist/types/protocol-constants.d.ts +1 -1
  622. package/dist/types/protocol-constants.js +1 -1
  623. package/dist/utils/binary-transfer.d.ts +1 -1
  624. package/dist/utils/errors.d.ts +2 -2
  625. package/dist/utils/errors.js +2 -2
  626. package/dist/utils/retry.d.ts +4 -3
  627. package/dist/utils/retry.d.ts.map +1 -1
  628. package/dist/utils/retry.js +20 -1
  629. package/dist/utils/retry.js.map +1 -1
  630. package/dist/zk/groups.d.ts +1 -1
  631. package/dist/zk/groups.js +1 -1
  632. package/docs/ASSURANCE.md +12 -8
  633. package/docs/CLIENT_COMPOSITION.md +32 -76
  634. package/docs/DEVIATIONS.md +944 -0
  635. package/docs/E2EE.md +71 -6
  636. package/docs/ERROR_HANDLING.md +8 -1
  637. package/docs/GETTING_STARTED.md +22 -18
  638. package/docs/INTERFACES.md +22 -22
  639. package/docs/PACKAGE_SURFACE.md +22 -16
  640. package/docs/PROTOCOL_POLICY.md +11 -2
  641. package/docs/RECIPES.md +17 -13
  642. package/docs/SECURITY.md +8 -0
  643. package/files/README.md +1 -1
  644. package/groups/README.md +16 -5
  645. package/local/store/README.md +14 -12
  646. package/local/store/expo/README.md +15 -6
  647. package/local/store/memory/README.md +58 -0
  648. package/local/store/node/README.md +8 -1
  649. package/local/store/react-native/README.md +1 -1
  650. package/local/store/web/README.md +1 -1
  651. package/local/vault/README.md +3 -3
  652. package/package.json +29 -13
  653. package/remote/README.md +19 -19
  654. package/remote/object-store/README.md +3 -3
  655. package/remote/object-store/convex-r2/README.md +1 -1
  656. package/remote/object-store/s3/README.md +1 -1
  657. package/remote/relay/README.md +7 -7
  658. package/remote/relay/convex/README.md +10 -4
  659. package/remote/relay/convex/component/README.md +428 -0
  660. package/remote/relay/memory/README.md +69 -0
  661. package/scripts/oe-groups.mjs +162 -0
  662. package/types/README.md +1 -1
  663. package/dist/internal/groups-v2/access-control.d.ts +0 -101
  664. package/dist/internal/groups-v2/access-control.d.ts.map +0 -1
  665. package/dist/internal/groups-v2/access-control.js +0 -184
  666. package/dist/internal/groups-v2/access-control.js.map +0 -1
  667. package/dist/internal/groups-v2/change-actions.d.ts +0 -35
  668. package/dist/internal/groups-v2/change-actions.d.ts.map +0 -1
  669. package/dist/internal/groups-v2/change-actions.js +0 -358
  670. package/dist/internal/groups-v2/change-actions.js.map +0 -1
  671. package/dist/internal/groups-v2/encrypted-state.d.ts.map +0 -1
  672. package/dist/internal/groups-v2/encrypted-state.js.map +0 -1
  673. package/dist/internal/groups-v2/index.d.ts +0 -14
  674. package/dist/internal/groups-v2/index.d.ts.map +0 -1
  675. package/dist/internal/groups-v2/index.js +0 -11
  676. package/dist/internal/groups-v2/index.js.map +0 -1
  677. package/dist/internal/groups-v2/invite-link.d.ts.map +0 -1
  678. package/dist/internal/groups-v2/invite-link.js.map +0 -1
  679. package/dist/internal/groups-v2/manager.d.ts.map +0 -1
  680. package/dist/internal/groups-v2/manager.js +0 -1093
  681. package/dist/internal/groups-v2/manager.js.map +0 -1
  682. package/dist/internal/groups-v2/types.d.ts.map +0 -1
  683. package/dist/internal/groups-v2/types.js.map +0 -1
  684. package/dist/local/store/mock/adapter.d.ts.map +0 -1
  685. package/dist/local/store/mock/adapter.js.map +0 -1
  686. package/dist/local/store/mock/index.d.ts +0 -10
  687. package/dist/local/store/mock/index.d.ts.map +0 -1
  688. package/dist/local/store/mock/index.js +0 -6
  689. package/dist/local/store/mock/index.js.map +0 -1
  690. package/dist/remote/relay/mock/adapter.d.ts.map +0 -1
  691. package/dist/remote/relay/mock/adapter.js.map +0 -1
  692. package/dist/remote/relay/mock/index.d.ts +0 -10
  693. package/dist/remote/relay/mock/index.d.ts.map +0 -1
  694. package/dist/remote/relay/mock/index.js +0 -6
  695. package/dist/remote/relay/mock/index.js.map +0 -1
  696. package/docs/api/README.md +0 -471
  697. package/docs/api/classes/EncryptionError.md +0 -112
  698. package/docs/api/classes/EndorsementManager.md +0 -307
  699. package/docs/api/classes/SealedSenderAuthError.md +0 -127
  700. package/docs/api/classes/ServerDerivedKeyPair.md +0 -68
  701. package/docs/api/classes/ServerDerivedPublicKey.md +0 -33
  702. package/docs/api/classes/ServerRootKeyPair.md +0 -94
  703. package/docs/api/classes/ServerRootPublicKey.md +0 -72
  704. package/docs/api/classes/SignalBlockingManager.md +0 -106
  705. package/docs/api/classes/SignalProtocolClient.md +0 -2651
  706. package/docs/api/classes/VerificationFailure.md +0 -25
  707. package/docs/api/enumerations/ContentHint.md +0 -63
  708. package/docs/api/enumerations/EncryptionErrorCode.md +0 -488
  709. package/docs/api/enumerations/IdentityKeyChange.md +0 -65
  710. package/docs/api/enumerations/MessageType.md +0 -29
  711. package/docs/api/enumerations/TrustDirection.md +0 -33
  712. package/docs/api/enumerations/TypingAction.md +0 -31
  713. package/docs/api/functions/createDefaultSignalContentAdapter.md +0 -13
  714. package/docs/api/functions/createDefaultSignalLogger.md +0 -36
  715. package/docs/api/functions/createGroupId.md +0 -32
  716. package/docs/api/functions/createSignalProtocolClient.md +0 -36
  717. package/docs/api/functions/createSignalProtocolClientConfig.md +0 -24
  718. package/docs/api/functions/extractGroupId.md +0 -32
  719. package/docs/api/functions/formatVersion.md +0 -25
  720. package/docs/api/functions/isCompatible.md +0 -31
  721. package/docs/api/functions/isGroupId.md +0 -37
  722. package/docs/api/functions/isSealedSenderAuthError.md +0 -25
  723. package/docs/api/functions/parseVersion.md +0 -29
  724. package/docs/api/functions/resolveSPQRLimits.md +0 -21
  725. package/docs/api/functions/resolveSignalLogger.md +0 -42
  726. package/docs/api/interfaces/AccountIdentityProvisioning.md +0 -43
  727. package/docs/api/interfaces/AccountIdentityRotation.md +0 -69
  728. package/docs/api/interfaces/AttachmentTransferOptions.md +0 -49
  729. package/docs/api/interfaces/BlockedRecipientEntry.md +0 -25
  730. package/docs/api/interfaces/BlockedRecipientsSyncInput.md +0 -27
  731. package/docs/api/interfaces/ConfigurationSyncInput.md +0 -19
  732. package/docs/api/interfaces/CredentialPublicKey.md +0 -25
  733. package/docs/api/interfaces/DataMessageInput.md +0 -21
  734. package/docs/api/interfaces/DecryptedEnvelope.md +0 -95
  735. package/docs/api/interfaces/DecryptedGroup.md +0 -86
  736. package/docs/api/interfaces/DeviceInfo.md +0 -79
  737. package/docs/api/interfaces/DeviceRecord.md +0 -87
  738. package/docs/api/interfaces/DeviceRegistration.md +0 -27
  739. package/docs/api/interfaces/DoubleRatchetConfig.md +0 -36
  740. package/docs/api/interfaces/EcOneTimePreKey.md +0 -27
  741. package/docs/api/interfaces/EcSignedPreKey.md +0 -39
  742. package/docs/api/interfaces/EcSignedPreKeyUpload.md +0 -50
  743. package/docs/api/interfaces/EncryptionErrorContext.md +0 -51
  744. package/docs/api/interfaces/Envelope.md +0 -154
  745. package/docs/api/interfaces/ForceKeyResetResult.md +0 -37
  746. package/docs/api/interfaces/GroupAuthorization.md +0 -23
  747. package/docs/api/interfaces/GroupChangeEntry.md +0 -42
  748. package/docs/api/interfaces/GroupMemberDevice.md +0 -26
  749. package/docs/api/interfaces/IEcOneTimePreKeyStore.md +0 -86
  750. package/docs/api/interfaces/IEcSignedPreKeyStore.md +0 -132
  751. package/docs/api/interfaces/IGroupServer.md +0 -120
  752. package/docs/api/interfaces/IGroupStateStore.md +0 -128
  753. package/docs/api/interfaces/IIdentityKeyStore.md +0 -312
  754. package/docs/api/interfaces/IKemPreKeyStore.md +0 -144
  755. package/docs/api/interfaces/IKyberLastResortPreKeyStore.md +0 -111
  756. package/docs/api/interfaces/ILogger.md +0 -117
  757. package/docs/api/interfaces/IProtocolStore.md +0 -1033
  758. package/docs/api/interfaces/ISenderKeyStore.md +0 -417
  759. package/docs/api/interfaces/ISesameStore.md +0 -249
  760. package/docs/api/interfaces/ISessionStore.md +0 -178
  761. package/docs/api/interfaces/ISignalLocalSecretVault.md +0 -71
  762. package/docs/api/interfaces/ISignalLocalStore.md +0 -2053
  763. package/docs/api/interfaces/ISignalProtocolClient.md +0 -1183
  764. package/docs/api/interfaces/ISignalProtocolManager.md +0 -272
  765. package/docs/api/interfaces/ISignalRelayServer.md +0 -1329
  766. package/docs/api/interfaces/IdentityKeyPair.md +0 -49
  767. package/docs/api/interfaces/IncomingEnvelope.md +0 -91
  768. package/docs/api/interfaces/InspectedSignalContent.md +0 -43
  769. package/docs/api/interfaces/KDFChain.md +0 -31
  770. package/docs/api/interfaces/KemLastResortPreKeyUpload.md +0 -50
  771. package/docs/api/interfaces/KeyPair.md +0 -23
  772. package/docs/api/interfaces/KyberPreKey.md +0 -42
  773. package/docs/api/interfaces/MLKEMBraidAgentState.md +0 -191
  774. package/docs/api/interfaces/MLKEMBraidMessage.md +0 -49
  775. package/docs/api/interfaces/MediaAttachmentDeleteSyncInput.md +0 -31
  776. package/docs/api/interfaces/MessageHeader.md +0 -49
  777. package/docs/api/interfaces/MessageRecord.md +0 -86
  778. package/docs/api/interfaces/ParsedReceiptContent.md +0 -19
  779. package/docs/api/interfaces/ParsedTypingContent.md +0 -19
  780. package/docs/api/interfaces/PreKeyMaintenanceStore.md +0 -87
  781. package/docs/api/interfaces/PreKeyMessage.md +0 -159
  782. package/docs/api/interfaces/PreKeyStatusResult.md +0 -21
  783. package/docs/api/interfaces/PreKeyUpload.md +0 -42
  784. package/docs/api/interfaces/ProcessEnvelopeOptions.md +0 -72
  785. package/docs/api/interfaces/ProtocolAddress.md +0 -38
  786. package/docs/api/interfaces/ProtocolStrategyConfig.md +0 -91
  787. package/docs/api/interfaces/RatchetMessage.md +0 -96
  788. package/docs/api/interfaces/ReadSyncEntryInput.md +0 -19
  789. package/docs/api/interfaces/ReceiverChain.md +0 -43
  790. package/docs/api/interfaces/RecipientUsernameSyncInput.md +0 -31
  791. package/docs/api/interfaces/RelayPreKeyBundle.md +0 -254
  792. package/docs/api/interfaces/RemoteObjectDownload.md +0 -33
  793. package/docs/api/interfaces/RemoteObjectUpload.md +0 -49
  794. package/docs/api/interfaces/ResolvedSPQRInfoStrings.md +0 -27
  795. package/docs/api/interfaces/ResolvedSPQRLimits.md +0 -37
  796. package/docs/api/interfaces/RetryRequest.md +0 -80
  797. package/docs/api/interfaces/SCKAState.md +0 -65
  798. package/docs/api/interfaces/SPQRLimits.md +0 -40
  799. package/docs/api/interfaces/SPQRState.md +0 -191
  800. package/docs/api/interfaces/SafetyNumber.md +0 -60
  801. package/docs/api/interfaces/SafetyNumberConfirmation.md +0 -46
  802. package/docs/api/interfaces/SealedSenderConfig.md +0 -70
  803. package/docs/api/interfaces/SendOptions.md +0 -191
  804. package/docs/api/interfaces/SendResult.md +0 -93
  805. package/docs/api/interfaces/SenderKeyDistributionMessage.md +0 -43
  806. package/docs/api/interfaces/SenderKeyState.md +0 -76
  807. package/docs/api/interfaces/SenderKeysConfig.md +0 -65
  808. package/docs/api/interfaces/SentSyncTranscriptInput.md +0 -31
  809. package/docs/api/interfaces/ServiceId.md +0 -19
  810. package/docs/api/interfaces/SesameMessage.md +0 -84
  811. package/docs/api/interfaces/SesameStats.md +0 -57
  812. package/docs/api/interfaces/SessionHealthResult.md +0 -120
  813. package/docs/api/interfaces/SessionRecord.md +0 -80
  814. package/docs/api/interfaces/SessionRecordMetadata.md +0 -109
  815. package/docs/api/interfaces/SessionState.md +0 -368
  816. package/docs/api/interfaces/SessionTrustCommit.md +0 -58
  817. package/docs/api/interfaces/SignalBlockingHooks.md +0 -44
  818. package/docs/api/interfaces/SignalBlockingManagerOptions.md +0 -31
  819. package/docs/api/interfaces/SignalBlockingMirror.md +0 -30
  820. package/docs/api/interfaces/SignalBlockingStore.md +0 -83
  821. package/docs/api/interfaces/SignalContentAdapter.md +0 -325
  822. package/docs/api/interfaces/SignalProtocolClientAdapterConfig.md +0 -44
  823. package/docs/api/interfaces/SignalProtocolClientCompositionOptions.md +0 -693
  824. package/docs/api/interfaces/SignalProtocolClientConfig.md +0 -839
  825. package/docs/api/interfaces/SignalProtocolClientDeleteLocalAttachmentInput.md +0 -25
  826. package/docs/api/interfaces/SignalProtocolClientHooks.md +0 -506
  827. package/docs/api/interfaces/SignalProtocolClientIdentityConfig.md +0 -35
  828. package/docs/api/interfaces/SignalProtocolClientLoadLocalAttachmentInput.md +0 -187
  829. package/docs/api/interfaces/SignalProtocolClientLoadedLocalAttachment.md +0 -19
  830. package/docs/api/interfaces/SignalProtocolClientMedia.md +0 -83
  831. package/docs/api/interfaces/SignalProtocolClientMediaCompletedResult.md +0 -25
  832. package/docs/api/interfaces/SignalProtocolClientMediaConfig.md +0 -157
  833. package/docs/api/interfaces/SignalProtocolClientMediaDownloadCompletedResult.md +0 -37
  834. package/docs/api/interfaces/SignalProtocolClientMediaDownloadNotNeededResult.md +0 -25
  835. package/docs/api/interfaces/SignalProtocolClientMediaFailedResult.md +0 -19
  836. package/docs/api/interfaces/SignalProtocolClientMediaOperationOptions.md +0 -53
  837. package/docs/api/interfaces/SignalProtocolClientMediaPendingResult.md +0 -19
  838. package/docs/api/interfaces/SignalProtocolClientMediaProcessResult.md +0 -43
  839. package/docs/api/interfaces/SignalProtocolClientMediaSkippedResult.md +0 -25
  840. package/docs/api/interfaces/SignalProtocolClientMediaUploadCompletedResult.md +0 -31
  841. package/docs/api/interfaces/SignalProtocolClientProcessPendingMediaOptions.md +0 -87
  842. package/docs/api/interfaces/SignalProtocolClientSaveDownloadedAttachmentInput.md +0 -25
  843. package/docs/api/interfaces/SignalProtocolClientSaveUploadedAttachmentInput.md +0 -25
  844. package/docs/api/interfaces/SignalProtocolClientSyncDeleteInput.md +0 -19
  845. package/docs/api/interfaces/SignalProtocolConfig.md +0 -50
  846. package/docs/api/interfaces/SignalRemoteObjectStore.md +0 -88
  847. package/docs/api/interfaces/SkippedSenderMessageKey.md +0 -26
  848. package/docs/api/interfaces/TaskNotificationAckSyncInput.md +0 -31
  849. package/docs/api/interfaces/TripleRatchetState.md +0 -64
  850. package/docs/api/interfaces/UserRecord.md +0 -71
  851. package/docs/api/interfaces/UsernameStateSyncInput.md +0 -19
  852. package/docs/api/interfaces/VerificationStateSyncInput.md +0 -31
  853. package/docs/api/interfaces/VersionNegotiationState.md +0 -84
  854. package/docs/api/interfaces/ViewOnceOpenSyncInput.md +0 -19
  855. package/docs/api/namespaces/ProtocolAddress/README.md +0 -33
  856. package/docs/api/namespaces/ProtocolAddress/functions/create.md +0 -41
  857. package/docs/api/namespaces/ProtocolAddress/functions/equals.md +0 -39
  858. package/docs/api/namespaces/ProtocolAddress/functions/fromStorageKey.md +0 -36
  859. package/docs/api/namespaces/ProtocolAddress/functions/isUser.md +0 -39
  860. package/docs/api/namespaces/ProtocolAddress/functions/isValid.md +0 -34
  861. package/docs/api/namespaces/ProtocolAddress/functions/parse.md +0 -41
  862. package/docs/api/namespaces/ProtocolAddress/functions/toStorageKey.md +0 -38
  863. package/docs/api/namespaces/ProtocolAddress/functions/toString.md +0 -34
  864. package/docs/api/namespaces/SessionRecord/README.md +0 -30
  865. package/docs/api/namespaces/SessionRecord/functions/archiveCurrent.md +0 -40
  866. package/docs/api/namespaces/SessionRecord/functions/archiveCurrentState.md +0 -34
  867. package/docs/api/namespaces/SessionRecord/functions/create.md +0 -25
  868. package/docs/api/namespaces/SessionRecord/functions/deserialize.md +0 -29
  869. package/docs/api/namespaces/SessionRecord/functions/findSession.md +0 -34
  870. package/docs/api/namespaces/SessionRecord/functions/getAllSessions.md +0 -25
  871. package/docs/api/namespaces/SessionRecord/functions/getArchivedCount.md +0 -25
  872. package/docs/api/namespaces/SessionRecord/functions/hasCurrentSession.md +0 -25
  873. package/docs/api/namespaces/SessionRecord/functions/hasUsableSenderChain.md +0 -36
  874. package/docs/api/namespaces/SessionRecord/functions/promoteSession.md +0 -34
  875. package/docs/api/namespaces/SessionRecord/functions/serialize.md +0 -28
  876. package/docs/api/namespaces/SessionRecord/variables/MAX_ARCHIVED_SESSIONS.md +0 -14
  877. package/docs/api/namespaces/SessionState/README.md +0 -15
  878. package/docs/api/namespaces/SessionState/functions/getSessionId.md +0 -32
  879. package/docs/api/namespaces/blocking/README.md +0 -43
  880. package/docs/api/namespaces/encoding/README.md +0 -33
  881. package/docs/api/namespaces/encoding/functions/base64ToUrlSafe.md +0 -28
  882. package/docs/api/namespaces/encoding/functions/bytesToBase64.md +0 -21
  883. package/docs/api/namespaces/encoding/functions/bytesToString.md +0 -21
  884. package/docs/api/namespaces/encoding/functions/bytesToUrlSafeBase64.md +0 -33
  885. package/docs/api/namespaces/encoding/functions/concatBytes.md +0 -21
  886. package/docs/api/namespaces/encoding/functions/stringToBytes.md +0 -21
  887. package/docs/api/namespaces/encoding/functions/urlSafeToBase64.md +0 -27
  888. package/docs/api/namespaces/keys/README.md +0 -126
  889. package/docs/api/namespaces/keys/functions/acceptContactIdentityRotation.md +0 -33
  890. package/docs/api/namespaces/keys/functions/assertIdentityCommitment.md +0 -25
  891. package/docs/api/namespaces/keys/functions/compositeIdentitiesEqual.md +0 -23
  892. package/docs/api/namespaces/keys/functions/createCompositeIdentityV1.md +0 -19
  893. package/docs/api/namespaces/keys/functions/createPreKeySignatureContext.md +0 -31
  894. package/docs/api/namespaces/keys/functions/createUnverifiedContactIdentityRecord.md +0 -23
  895. package/docs/api/namespaces/keys/functions/decodeCompositeIdentityV1.md +0 -19
  896. package/docs/api/namespaces/keys/functions/deriveIdentityCommitment.md +0 -19
  897. package/docs/api/namespaces/keys/functions/encodeCompositeIdentityV1.md +0 -19
  898. package/docs/api/namespaces/keys/functions/evaluateContactIdentityCandidate.md +0 -27
  899. package/docs/api/namespaces/keys/functions/generateEcOneTimePreKeys.md +0 -37
  900. package/docs/api/namespaces/keys/functions/generateEcSignedPreKey.md +0 -39
  901. package/docs/api/namespaces/keys/functions/generateEcSignedPreKeyId.md +0 -21
  902. package/docs/api/namespaces/keys/functions/generateIdentityKeyPair.md +0 -24
  903. package/docs/api/namespaces/keys/functions/generateKemOneTimePreKeys.md +0 -47
  904. package/docs/api/namespaces/keys/functions/generateKyberLastResortPreKey.md +0 -37
  905. package/docs/api/namespaces/keys/functions/generateRegistrationId.md +0 -13
  906. package/docs/api/namespaces/keys/functions/signMlKem1024PreKey.md +0 -29
  907. package/docs/api/namespaces/keys/functions/signPreKey.md +0 -31
  908. package/docs/api/namespaces/keys/functions/validateContactIdentityRecord.md +0 -19
  909. package/docs/api/namespaces/keys/functions/verifyContactIdentityRecord.md +0 -31
  910. package/docs/api/namespaces/keys/functions/verifyMlKem1024PreKey.md +0 -33
  911. package/docs/api/namespaces/keys/functions/verifyPreKeySignature.md +0 -35
  912. package/docs/api/namespaces/keys/interfaces/CompositeIdentityV1.md +0 -33
  913. package/docs/api/namespaces/keys/interfaces/ContactIdentityRecord.md +0 -53
  914. package/docs/api/namespaces/keys/interfaces/KemOneTimePreKey.md +0 -43
  915. package/docs/api/namespaces/keys/type-aliases/IdentityCandidateStatus.md +0 -9
  916. package/docs/api/namespaces/keys/type-aliases/IdentityTrustState.md +0 -9
  917. package/docs/api/namespaces/keys/type-aliases/IdentityType.md +0 -9
  918. package/docs/api/namespaces/keys/variables/COMPOSITE_IDENTITY_V1_ED25519_TAG.md +0 -9
  919. package/docs/api/namespaces/keys/variables/COMPOSITE_IDENTITY_V1_LENGTH.md +0 -9
  920. package/docs/api/namespaces/keys/variables/COMPOSITE_IDENTITY_V1_VERSION.md +0 -9
  921. package/docs/api/namespaces/keys/variables/COMPOSITE_IDENTITY_V1_X25519_TAG.md +0 -9
  922. package/docs/api/namespaces/keys/variables/IDENTITY_COMMITMENT_V1_DOMAIN.md +0 -9
  923. package/docs/api/namespaces/keys/variables/PREKEY_ALGORITHM_ML_KEM_1024.md +0 -9
  924. package/docs/api/namespaces/keys/variables/PREKEY_ALGORITHM_X25519.md +0 -9
  925. package/docs/api/namespaces/keys/variables/PREKEY_SIGNATURE_V1_DOMAIN.md +0 -9
  926. package/docs/api/namespaces/media/README.md +0 -105
  927. package/docs/api/namespaces/media/classes/MediaAttachmentError.md +0 -57
  928. package/docs/api/namespaces/media/functions/createByteRangeMediaAttachmentTransfer.md +0 -19
  929. package/docs/api/namespaces/media/functions/createMediaAttachmentDeliveryId.md +0 -29
  930. package/docs/api/namespaces/media/functions/createMediaAttachmentId.md +0 -19
  931. package/docs/api/namespaces/media/functions/createMediaAttachmentMessage.md +0 -25
  932. package/docs/api/namespaces/media/functions/createMediaAttachmentPointer.md +0 -19
  933. package/docs/api/namespaces/media/functions/createTusMediaAttachmentTransfer.md +0 -19
  934. package/docs/api/namespaces/media/functions/deleteMediaAttachment.md +0 -23
  935. package/docs/api/namespaces/media/functions/executeMediaAttachmentJob.md +0 -23
  936. package/docs/api/namespaces/media/functions/isMediaAttachmentFlagSet.md +0 -19
  937. package/docs/api/namespaces/media/functions/parseMediaAttachmentMessage.md +0 -19
  938. package/docs/api/namespaces/media/functions/planMediaAttachmentCleanup.md +0 -23
  939. package/docs/api/namespaces/media/functions/planMediaAttachmentCleanupJobs.md +0 -19
  940. package/docs/api/namespaces/media/functions/planMediaAttachmentDeleteSync.md +0 -19
  941. package/docs/api/namespaces/media/functions/planMediaAttachmentDownloadJob.md +0 -19
  942. package/docs/api/namespaces/media/functions/planMediaAttachmentOpen.md +0 -19
  943. package/docs/api/namespaces/media/functions/planMediaAttachmentProcessing.md +0 -19
  944. package/docs/api/namespaces/media/functions/planMediaAttachmentUploadJob.md +0 -19
  945. package/docs/api/namespaces/media/functions/prepareMediaAttachmentUpload.md +0 -30
  946. package/docs/api/namespaces/media/functions/resolveMediaAttachment.md +0 -30
  947. package/docs/api/namespaces/media/functions/serializeMediaAttachmentMessage.md +0 -25
  948. package/docs/api/namespaces/media/functions/validateMediaAttachmentPolicy.md +0 -23
  949. package/docs/api/namespaces/media/interfaces/ByteRangeMediaAttachmentPartialStore.md +0 -68
  950. package/docs/api/namespaces/media/interfaces/ByteRangeMediaAttachmentTransferOptions.md +0 -91
  951. package/docs/api/namespaces/media/interfaces/DeleteMediaAttachmentOptions.md +0 -25
  952. package/docs/api/namespaces/media/interfaces/DeleteMediaAttachmentResult.md +0 -19
  953. package/docs/api/namespaces/media/interfaces/ExecuteMediaAttachmentJobOptions.md +0 -157
  954. package/docs/api/namespaces/media/interfaces/MediaAttachmentBackgroundJob.md +0 -85
  955. package/docs/api/namespaces/media/interfaces/MediaAttachmentCleanupPlan.md +0 -37
  956. package/docs/api/namespaces/media/interfaces/MediaAttachmentJobExecutionResult.md +0 -55
  957. package/docs/api/namespaces/media/interfaces/MediaAttachmentMessage.md +0 -31
  958. package/docs/api/namespaces/media/interfaces/MediaAttachmentOpenDecision.md +0 -31
  959. package/docs/api/namespaces/media/interfaces/MediaAttachmentPointer.md +0 -133
  960. package/docs/api/namespaces/media/interfaces/MediaAttachmentPolicy.md +0 -67
  961. package/docs/api/namespaces/media/interfaces/MediaAttachmentProcessingPlan.md +0 -73
  962. package/docs/api/namespaces/media/interfaces/MediaAttachmentProgress.md +0 -69
  963. package/docs/api/namespaces/media/interfaces/MediaAttachmentResumeState.md +0 -37
  964. package/docs/api/namespaces/media/interfaces/MediaAttachmentRetryOptions.md +0 -31
  965. package/docs/api/namespaces/media/interfaces/MediaAttachmentTransfer.md +0 -51
  966. package/docs/api/namespaces/media/interfaces/MediaAttachmentTransferCheckpoint.md +0 -69
  967. package/docs/api/namespaces/media/interfaces/MediaAttachmentTransferOptions.md +0 -67
  968. package/docs/api/namespaces/media/interfaces/MediaAttachmentUploadJobData.md +0 -19
  969. package/docs/api/namespaces/media/interfaces/MediaAttachmentUploadResponse.md +0 -25
  970. package/docs/api/namespaces/media/interfaces/PlanMediaAttachmentCleanupJobsInput.md +0 -61
  971. package/docs/api/namespaces/media/interfaces/PlanMediaAttachmentDeleteSyncInput.md +0 -25
  972. package/docs/api/namespaces/media/interfaces/PlanMediaAttachmentDownloadJobInput.md +0 -161
  973. package/docs/api/namespaces/media/interfaces/PlanMediaAttachmentOpenInput.md +0 -25
  974. package/docs/api/namespaces/media/interfaces/PlanMediaAttachmentProcessingInput.md +0 -83
  975. package/docs/api/namespaces/media/interfaces/PlanMediaAttachmentUploadJobInput.md +0 -147
  976. package/docs/api/namespaces/media/interfaces/PrepareMediaAttachmentUploadOptions.md +0 -144
  977. package/docs/api/namespaces/media/interfaces/ResolveMediaAttachmentOptions.md +0 -55
  978. package/docs/api/namespaces/media/interfaces/ResolvedMediaAttachment.md +0 -109
  979. package/docs/api/namespaces/media/interfaces/TusMediaAttachmentTransferOptions.md +0 -85
  980. package/docs/api/namespaces/media/type-aliases/CreateMediaAttachmentPointerInput.md +0 -15
  981. package/docs/api/namespaces/media/type-aliases/MediaAttachmentCheckpointCallback.md +0 -19
  982. package/docs/api/namespaces/media/type-aliases/MediaAttachmentCleanupReason.md +0 -9
  983. package/docs/api/namespaces/media/type-aliases/MediaAttachmentErrorCode.md +0 -9
  984. package/docs/api/namespaces/media/type-aliases/MediaAttachmentFlag.md +0 -9
  985. package/docs/api/namespaces/media/type-aliases/MediaAttachmentJobExecutionStatus.md +0 -9
  986. package/docs/api/namespaces/media/type-aliases/MediaAttachmentJobOperation.md +0 -9
  987. package/docs/api/namespaces/media/type-aliases/MediaAttachmentJobPriority.md +0 -9
  988. package/docs/api/namespaces/media/type-aliases/MediaAttachmentJobSkipReason.md +0 -9
  989. package/docs/api/namespaces/media/type-aliases/MediaAttachmentJobSource.md +0 -9
  990. package/docs/api/namespaces/media/type-aliases/MediaAttachmentKnownIds.md +0 -9
  991. package/docs/api/namespaces/media/type-aliases/MediaAttachmentMessageType.md +0 -9
  992. package/docs/api/namespaces/media/type-aliases/MediaAttachmentProgressCallback.md +0 -19
  993. package/docs/api/namespaces/media/variables/MEDIA_ATTACHMENT_POLICY_DEFAULTS.md +0 -47
  994. package/docs/api/namespaces/media/variables/MEDIA_ATTACHMENT_POLICY_PRESETS.md +0 -95
  995. package/docs/api/namespaces/media/variables/MediaAttachmentCleanupReason.md +0 -27
  996. package/docs/api/namespaces/media/variables/MediaAttachmentErrorCode.md +0 -75
  997. package/docs/api/namespaces/media/variables/MediaAttachmentFlag.md +0 -23
  998. package/docs/api/namespaces/media/variables/MediaAttachmentJobExecutionStatus.md +0 -19
  999. package/docs/api/namespaces/media/variables/MediaAttachmentJobOperation.md +0 -31
  1000. package/docs/api/namespaces/media/variables/MediaAttachmentJobPriority.md +0 -23
  1001. package/docs/api/namespaces/media/variables/MediaAttachmentJobSource.md +0 -51
  1002. package/docs/api/namespaces/media/variables/MediaAttachmentMessageType.md +0 -15
  1003. package/docs/api/namespaces/media/variables/downloadMediaAttachment.md +0 -30
  1004. package/docs/api/namespaces/safety/README.md +0 -61
  1005. package/docs/api/namespaces/safety/classes/DisplayableFingerprint.md +0 -108
  1006. package/docs/api/namespaces/safety/classes/Fingerprint.md +0 -104
  1007. package/docs/api/namespaces/safety/classes/ScannableFingerprint.md +0 -209
  1008. package/docs/api/namespaces/safety/functions/base64ToBytes.md +0 -21
  1009. package/docs/api/namespaces/safety/functions/clearFingerprintCache.md +0 -15
  1010. package/docs/api/namespaces/safety/functions/compareSafetyNumbers.md +0 -25
  1011. package/docs/api/namespaces/safety/functions/createFingerprintData.md +0 -60
  1012. package/docs/api/namespaces/safety/functions/extractQrData.md +0 -34
  1013. package/docs/api/namespaces/safety/functions/generateCompositeSafetyNumber.md +0 -39
  1014. package/docs/api/namespaces/safety/functions/generateEmojiFingerprint.md +0 -24
  1015. package/docs/api/namespaces/safety/functions/generateSingleKeyReferenceSafetyNumber.md +0 -51
  1016. package/docs/api/namespaces/safety/functions/generateVerifySchemeUrl.md +0 -32
  1017. package/docs/api/namespaces/safety/functions/generateVerifyUrl.md +0 -49
  1018. package/docs/api/namespaces/safety/functions/isValidSafetyNumber.md +0 -21
  1019. package/docs/api/namespaces/safety/functions/isVerifyUrl.md +0 -45
  1020. package/docs/api/namespaces/safety/functions/parseVerifyUrl.md +0 -31
  1021. package/docs/api/namespaces/safety/interfaces/FingerprintData.md +0 -52
  1022. package/docs/api/namespaces/safety/interfaces/SafetyNumber.md +0 -49
  1023. package/docs/api/namespaces/safety/interfaces/VerifyLinkConfig.md +0 -28
  1024. package/docs/api/namespaces/safety/interfaces/VerifyUrlParams.md +0 -49
  1025. package/docs/api/namespaces/safety/type-aliases/CompareResult.md +0 -21
  1026. package/docs/api/namespaces/safety/variables/DEFAULT_VERIFY_LINK_CONFIG.md +0 -12
  1027. package/docs/api/namespaces/safety/variables/FINGERPRINT_ITERATIONS.md +0 -12
  1028. package/docs/api/namespaces/safety/variables/FINGERPRINT_VERSION.md +0 -12
  1029. package/docs/api/namespaces/safety/variables/VERIFY_BASE_URL.md +0 -11
  1030. package/docs/api/namespaces/safety/variables/VERIFY_SCHEME_URL.md +0 -11
  1031. package/docs/api/type-aliases/Base64.md +0 -20
  1032. package/docs/api/type-aliases/BraidPolicy.md +0 -11
  1033. package/docs/api/type-aliases/Bytes.md +0 -20
  1034. package/docs/api/type-aliases/Ciphertext.md +0 -21
  1035. package/docs/api/type-aliases/DeviceType.md +0 -11
  1036. package/docs/api/type-aliases/DownloadedAttachment.md +0 -11
  1037. package/docs/api/type-aliases/GroupId.md +0 -27
  1038. package/docs/api/type-aliases/Hex.md +0 -20
  1039. package/docs/api/type-aliases/HookName.md +0 -11
  1040. package/docs/api/type-aliases/PostQuantumPolicy.md +0 -11
  1041. package/docs/api/type-aliases/PreparedAttachmentUpload.md +0 -14
  1042. package/docs/api/type-aliases/PrivateKey.md +0 -22
  1043. package/docs/api/type-aliases/ProgressCallback.md +0 -45
  1044. package/docs/api/type-aliases/PublicKey.md +0 -22
  1045. package/docs/api/type-aliases/RemoteObjectCompleteUploadRequest.md +0 -19
  1046. package/docs/api/type-aliases/RemoteObjectDeleteRequest.md +0 -19
  1047. package/docs/api/type-aliases/RemoteObjectDownloadRequest.md +0 -19
  1048. package/docs/api/type-aliases/RemoteObjectUploadRequest.md +0 -42
  1049. package/docs/api/type-aliases/SCKAMode.md +0 -11
  1050. package/docs/api/type-aliases/SealedSenderAuth.md +0 -15
  1051. package/docs/api/type-aliases/SignalProtocolClientMediaCleanupInput.md +0 -9
  1052. package/docs/api/type-aliases/SignalProtocolClientMediaCleanupResult.md +0 -9
  1053. package/docs/api/type-aliases/SignalProtocolClientMediaDownloadInput.md +0 -9
  1054. package/docs/api/type-aliases/SignalProtocolClientMediaDownloadResult.md +0 -9
  1055. package/docs/api/type-aliases/SignalProtocolClientMediaOperationResult.md +0 -9
  1056. package/docs/api/type-aliases/SignalProtocolClientMediaUploadInput.md +0 -9
  1057. package/docs/api/type-aliases/SignalProtocolClientMediaUploadResult.md +0 -9
  1058. package/docs/api/type-aliases/Signature.md +0 -21
  1059. package/docs/api/type-aliases/Unsubscribe.md +0 -15
  1060. package/docs/api/variables/BraidPolicy.md +0 -21
  1061. package/docs/api/variables/DEFAULT_DEVICE_ID.md +0 -12
  1062. package/docs/api/variables/DOUBLE_RATCHET_SPEC.md +0 -11
  1063. package/docs/api/variables/GROUP_V2_PREFIX.md +0 -11
  1064. package/docs/api/variables/KEY_REFRESH_INTERVAL_MS_DEFAULT.md +0 -11
  1065. package/docs/api/variables/MAX_MESSAGE_KEYS.md +0 -14
  1066. package/docs/api/variables/MAX_PREKEY_AGE_MS_DEFAULT.md +0 -11
  1067. package/docs/api/variables/MAX_RECEIVER_CHAINS.md +0 -14
  1068. package/docs/api/variables/MAX_REGISTRATION_ID.md +0 -16
  1069. package/docs/api/variables/MAX_SKIP.md +0 -11
  1070. package/docs/api/variables/MESSAGE_FORMAT.md +0 -11
  1071. package/docs/api/variables/MIN_REGISTRATION_ID.md +0 -16
  1072. package/docs/api/variables/ML_KEM_BRAID_SPEC.md +0 -11
  1073. package/docs/api/variables/ONE_TIME_PREKEY_BATCH_SIZE.md +0 -21
  1074. package/docs/api/variables/PQXDH_SPEC.md +0 -11
  1075. package/docs/api/variables/PostQuantumPolicy.md +0 -21
  1076. package/docs/api/variables/SENDER_KEY_FORMAT.md +0 -11
  1077. package/docs/api/variables/SENDER_KEY_SPEC.md +0 -11
  1078. package/docs/api/variables/SESAME_SPEC.md +0 -11
  1079. package/docs/api/variables/SESSION_FORMAT.md +0 -11
  1080. package/docs/api/variables/SPQR_LIMITS_DEFAULTS.md +0 -11
  1081. package/docs/api/variables/X3DH_SPEC.md +0 -9
  1082. package/docs/api/variables/defaultSignalLogger.md +0 -32
  1083. package/local/store/mock/README.md +0 -27
  1084. package/remote/relay/mock/README.md +0 -32
  1085. /package/dist/internal/{groups-v2 → groups}/invite-link.d.ts +0 -0
  1086. /package/dist/internal/{groups-v2 → groups}/invite-link.js +0 -0
package/docs/E2EE.md CHANGED
@@ -1,13 +1,21 @@
1
1
  # End-to-End Encryption
2
2
 
3
- `@open-e2ee/signal-protocol-sdk` provides end-to-end encryption based on the Signal
4
- Protocol: X3DH / PQXDH key agreement and the Double Ratchet, extended with the
5
- Sparse Post-Quantum Ratchet (SPQR / ML-KEM-BRAID).
3
+ > Navigation: [README](../README.md) | [Getting Started](./GETTING_STARTED.md) |
4
+ > [Security Model](./SECURITY.md) | [Architecture](../ARCHITECTURE.md)
5
+
6
+ `@open-e2ee/signal-protocol-sdk` provides end-to-end encryption based on the
7
+ Signal Protocol: X3DH / PQXDH key agreement and the Double Ratchet, extended
8
+ with the Sparse Post-Quantum Ratchet (SPQR / ML-KEM Braid).
6
9
 
7
10
  End-to-end encryption means plaintext exists only on the sender's and
8
11
  recipient's devices. A relay or server sees ciphertext envelopes and routing
9
12
  metadata, never message contents or long-term private keys.
10
13
 
14
+ This page explains what that changes about how you build. If you have only ever
15
+ built server-authoritative applications, most of the work of adopting E2EE is
16
+ absorbing these changes — the cryptography itself is the part the SDK already
17
+ did.
18
+
11
19
  ## Security Guarantees
12
20
 
13
21
  - **End-to-end encryption** — message contents are encrypted on the sender's
@@ -20,11 +28,67 @@ metadata, never message contents or long-term private keys.
20
28
  heals the session after a key compromise, so future messages regain
21
29
  confidentiality once fresh ratchet keys are exchanged.
22
30
  - **Post-quantum confidentiality** — PQXDH and the SPQR ratchet mix ML-KEM
23
- (Kyber) shared secrets into key agreement and continuous ratcheting, providing
24
- resistance against harvest-now-decrypt-later adversaries.
31
+ (FIPS 203) shared secrets into key agreement and continuous ratcheting,
32
+ providing resistance against harvest-now-decrypt-later adversaries.
25
33
  - **Authentication & integrity** — messages are authenticated (AEAD + MACs) and
26
34
  identities are verifiable through safety numbers.
27
35
 
36
+ ## What changes about your architecture
37
+
38
+ ### The server becomes a relay
39
+
40
+ In a server-authoritative app, the database holds the truth and the backend
41
+ reads it to do its job. With E2EE the relay carries sealed envelopes: it can
42
+ route, store, and meter them, but it cannot read, search, filter, moderate, or
43
+ render them. Server-side features that assume plaintext — full-text search,
44
+ content previews, server-rendered notifications, analytics over message
45
+ content — do not degrade; they stop existing, and their replacements live on
46
+ the device. The [architecture overview](../ARCHITECTURE.md) shows exactly which
47
+ responsibilities sit on which side of that line.
48
+
49
+ ### The device becomes the source of truth
50
+
51
+ Message history, session state, and keys live in device-local storage — that is
52
+ why the `storage` adapter is required, not optional. Ratchet state mutates on
53
+ every decrypt and must persist atomically; treating local storage as a cache
54
+ that can be dropped and refetched corrupts sessions irrecoverably. The
55
+ [integration interfaces](./INTERFACES.md) exist to make that contract explicit.
56
+
57
+ ### Identity becomes a set of device keys
58
+
59
+ A user is no longer a row with a password hash; a user is a set of devices,
60
+ each with its own identity key. Adding a second device is a protocol operation
61
+ (linking), not a login. Removing one is revocation, not a session delete. Trust
62
+ is established per `(userId, identityType)` and verified with safety numbers —
63
+ see [Recipes](./RECIPES.md) for the multi-device and verification flows.
64
+
65
+ ### Recovery becomes a product decision
66
+
67
+ When the server never has the keys, "forgot password" cannot restore content.
68
+ What recovery looks like — device-to-device transfer, an encrypted backup a
69
+ user can lose, or accepting history loss — is an application policy with real
70
+ security tradeoffs in every direction. The SDK does not silently choose one for
71
+ you. The considerations are laid out in the hosted guides at
72
+ [docs.open-e2ee.dev](https://docs.open-e2ee.dev).
73
+
74
+ ### Metadata remains visible
75
+
76
+ E2EE protects content, not existence. The relay still observes envelope sizes,
77
+ timing, and routing — who is talking to whom, when, and how much. Sealed sender
78
+ narrows what the relay learns about senders, with published limits stated
79
+ plainly in the [security model](./SECURITY.md). Do not describe an E2EE product
80
+ as anonymous; the two properties are different, and conflating them is the most
81
+ common overclaim in this space.
82
+
83
+ ### Failure modes are new
84
+
85
+ Sessions can desynchronize; identity keys change when someone reinstalls;
86
+ messages arrive out of order or reference skipped keys; one-time prekeys run
87
+ out. These are protocol realities, not bugs, and the SDK surfaces them as
88
+ explicit states and errors rather than hiding them — see
89
+ [Error Handling](./ERROR_HANDLING.md) for what each one means and what your
90
+ application should do about it.
91
+
28
92
  ## Verifiability
29
93
 
30
94
  The implementation uses narrow protocol seams, explicit state transitions, and
@@ -32,4 +96,5 @@ injectable storage and relay boundaries so security properties can be evaluated
32
96
  independently. This documentation describes intended behavior; it is not a
33
97
  third-party security certification.
34
98
 
35
- See also [SECURITY.md](../SECURITY.md) and [ARCHITECTURE.md](../ARCHITECTURE.md).
99
+ See also [SECURITY.md](./SECURITY.md), [ASSURANCE.md](./ASSURANCE.md), and
100
+ [ARCHITECTURE.md](../ARCHITECTURE.md).
@@ -368,7 +368,14 @@ if (isIdentityKeyChangedError(error)) {
368
368
  // Don't silently accept - show security dialog
369
369
  const accepted = await showSecurityWarningDialog(error);
370
370
  if (accepted) {
371
- await signal.trustIdentity(error.changedAddress, error.newIdentityKey);
371
+ // acceptIdentityRotation() takes the peer's new composite identity tuple,
372
+ // not the bare key carried on the error, and resets the sessions bound to
373
+ // the retired identity.
374
+ const userId = error.changedAddress.userId;
375
+ const identity = await relay.getIdentityKey(userId);
376
+ if (identity) {
377
+ await signal.acceptIdentityRotation(userId, identity);
378
+ }
372
379
  }
373
380
  }
374
381
  ```
@@ -107,12 +107,14 @@ This is the target DX the package is moving toward. It is shown here so app
107
107
  developers can understand the intended mental model while the current stable API
108
108
  still uses `storage`, `remoteObjectStore`, hooks, and transition-only media helpers.
109
109
 
110
+ <!-- doc-snippet:skip target-message-api-not-yet-shipped -->
110
111
  ```ts
112
+ // Real protocol and cryptography; simulated in-memory infrastructure.
111
113
  import { createSignalProtocolClient } from "@open-e2ee/signal-protocol-sdk";
112
114
  import { createInMemoryDeviceStorage } from "@open-e2ee/signal-protocol-sdk/device/storage/memory";
113
- import { mockRelay } from "@open-e2ee/signal-protocol-sdk/remote/relay/mock";
115
+ import { inMemoryRelay } from "@open-e2ee/signal-protocol-sdk/remote/relay/memory";
114
116
 
115
- const relay = mockRelay();
117
+ const relay = inMemoryRelay();
116
118
 
117
119
  const alice = await createSignalProtocolClient({
118
120
  identity: { userId: "alice", deviceId: 1 },
@@ -180,8 +182,8 @@ const signal = await createSignalProtocolClient({
180
182
  ```
181
183
 
182
184
  Attachments use the same message API. On Expo, pass the picker URI; the Signal
183
- client copies or persists the bytes through `deviceStorage.files` before upload
184
- so retry can continue after restart:
185
+ Protocol client copies or persists the bytes through `deviceStorage.files`
186
+ before upload so retry can continue after restart:
185
187
 
186
188
  ```ts
187
189
  await signal.messages.send({
@@ -222,16 +224,18 @@ current `signal.media.*` examples into lower-level transition or migration docs.
222
224
 
223
225
  ## Current Stable Local Clients
224
226
 
225
- Use mock adapters for local examples and development:
227
+ Use the in-memory adapters for local examples and development:
226
228
  the demo sends while Bob is offline, inspects the relay-visible ciphertext, and
227
229
  then starts Bob's subscription to show the decrypted plaintext entering the app.
228
230
 
231
+ <!-- doc-snippet:run getting-started-stable-local-clients expect="bob decrypted: alice: hello" -->
229
232
  ```ts
233
+ // Real protocol and cryptography; simulated in-memory infrastructure.
230
234
  import { createSignalProtocolClient } from "@open-e2ee/signal-protocol-sdk";
231
- import { mockStore } from "@open-e2ee/signal-protocol-sdk/local/store/mock";
232
- import { mockRelay } from "@open-e2ee/signal-protocol-sdk/remote/relay/mock";
235
+ import { inMemoryStore } from "@open-e2ee/signal-protocol-sdk/local/store/memory";
236
+ import { inMemoryRelay } from "@open-e2ee/signal-protocol-sdk/remote/relay/memory";
233
237
 
234
- const relay = mockRelay();
238
+ const relay = inMemoryRelay();
235
239
 
236
240
  // The relay knows which devices exist, but it does not get plaintext.
237
241
  await relay.registerDevice("alice", {
@@ -242,12 +246,12 @@ await relay.registerDevice("bob", { encryptedDeviceName: new ArrayBuffer(0) });
242
246
  // Each client represents one device. Its protocol storage is local to that device.
243
247
  const alice = await createSignalProtocolClient({
244
248
  identity: { userId: "alice" },
245
- adapters: { storage: mockStore(), relay },
249
+ adapters: { storage: inMemoryStore(), relay },
246
250
  });
247
251
 
248
252
  const bob = await createSignalProtocolClient({
249
253
  identity: { userId: "bob" },
250
- adapters: { storage: mockStore(), relay },
254
+ adapters: { storage: inMemoryStore(), relay },
251
255
  });
252
256
 
253
257
  await alice.syncToServer();
@@ -299,7 +303,7 @@ relay sees encrypted envelope: {
299
303
  bob decrypted: alice: hello
300
304
  ```
301
305
 
302
- The mock relay lets the example inspect what a server can see. The relay sees
306
+ The in-memory relay lets the example inspect what a server can see. The relay sees
303
307
  metadata plus encrypted envelope bytes; it does not receive Bob's decrypted
304
308
  message content. The first message often uses `prekey_bundle` to establish a
305
309
  session, and later messages use `ciphertext`.
@@ -315,11 +319,11 @@ import { createSignalProtocolClient } from "@open-e2ee/signal-protocol-sdk";
315
319
  import { expoStore } from "@open-e2ee/signal-protocol-sdk/local/store/expo";
316
320
  import {
317
321
  convexRelay,
318
- type ConvexSignalRelayApi,
322
+ type ConvexSignalProtocolRelayApi,
319
323
  } from "@open-e2ee/signal-protocol-sdk/remote/relay/convex";
320
324
  import { api } from "../convex/_generated/api";
321
325
 
322
- const signalApi = api.signal satisfies ConvexSignalRelayApi;
326
+ const signalApi = api.signal satisfies ConvexSignalProtocolRelayApi;
323
327
 
324
328
  // The relay handles server-side public keys, devices, and encrypted envelopes.
325
329
  const relay = convexRelay({
@@ -332,7 +336,7 @@ const signal = await createSignalProtocolClient({
332
336
  identity: { userId },
333
337
  adapters: {
334
338
  // Storage owns this device's private keys and session state.
335
- storage: expoStore({ relay }),
339
+ storage: expoStore(),
336
340
  relay,
337
341
  },
338
342
  });
@@ -522,8 +526,8 @@ partial-byte store. Native background download code should implement the same
522
526
  `MediaAttachmentTransfer` interface.
523
527
 
524
528
  For background-safe uploads, use the durable client operation. The current API
525
- persists bounded recovery metadata through the existing Signal storage adapter;
526
- the target message-first API moves that responsibility behind
529
+ persists bounded recovery metadata through the existing Signal Protocol storage
530
+ adapter; the target message-first API moves that responsibility behind
527
531
  `deviceStorage.messages`. The operation tries the upload when it is due and
528
532
  returns either a completed pointer or a pending job id for later recovery:
529
533
 
@@ -560,8 +564,8 @@ await signal.media.processPending({
560
564
  ```
561
565
 
562
566
  On receive, ask the media planner what work this device should do. Your app
563
- supplies the IDs it has already processed or cached; the Signal package returns
564
- the safe next step without taking ownership of your app database:
567
+ supplies the IDs it has already processed or cached; the Signal Protocol package
568
+ returns the safe next step without taking ownership of your app database:
565
569
 
566
570
  ```ts
567
571
  const mediaWork = media.planMediaAttachmentProcessing({
@@ -12,30 +12,30 @@ policy.
12
12
 
13
13
  ```text
14
14
  SignalProtocolClient
15
- ├── ISignalLocalStore device-local protocol state
16
- ├── ISignalRelayServer authenticated device, prekey, and envelope service
17
- ├── SignalRemoteObjectStore brokered encrypted-object operations (optional)
15
+ ├── ISignalProtocolLocalStore device-local protocol state
16
+ ├── ISignalProtocolRelayServer authenticated device, prekey, and envelope service
17
+ ├── SignalProtocolRemoteObjectStore brokered encrypted-object operations (optional)
18
18
  ├── media callbacks application-owned attachment bytes and caches
19
19
  └── lifecycle hooks application reactions and observability
20
20
 
21
21
  Local-store bootstrap
22
- └── ISignalLocalSecretVault small platform-managed bootstrap secrets
22
+ └── ISignalProtocolLocalSecretVault small platform-managed bootstrap secrets
23
23
  ```
24
24
 
25
25
  The interfaces are public contracts, but they do not make an implementation
26
26
  secure by themselves. Each adapter must preserve the ownership and atomicity
27
27
  requirements described below.
28
28
 
29
- ## `ISignalLocalStore`
29
+ ## `ISignalProtocolLocalStore`
30
30
 
31
- `ISignalLocalStore` persists the current device's identities, prekeys, sessions,
31
+ `ISignalProtocolLocalStore` persists the current device's identities, prekeys, sessions,
32
32
  sender keys, contact trust, retry records, and operational metadata.
33
33
 
34
34
  ```ts
35
- import type { ISignalLocalStore } from "@open-e2ee/signal-protocol-sdk/local/store";
35
+ import type { ISignalProtocolLocalStore } from "@open-e2ee/signal-protocol-sdk/local/store";
36
36
  import { createSignalProtocolClient } from "@open-e2ee/signal-protocol-sdk";
37
37
 
38
- const storage: ISignalLocalStore = appProtocolStore;
38
+ const storage: ISignalProtocolLocalStore = appProtocolStore;
39
39
 
40
40
  const client = await createSignalProtocolClient({
41
41
  identity: { userId },
@@ -56,16 +56,16 @@ A production implementation must:
56
56
  Available adapters and their status are documented in the
57
57
  [local-store guide](../local/store/README.md).
58
58
 
59
- ## `ISignalLocalSecretVault`
59
+ ## `ISignalProtocolLocalSecretVault`
60
60
 
61
- `ISignalLocalSecretVault` is a deliberately small interface for bootstrap
61
+ `ISignalProtocolLocalSecretVault` is a deliberately small interface for bootstrap
62
62
  secrets that must live outside the main local store, such as a database
63
63
  encryption key.
64
64
 
65
65
  ```ts
66
- import type { ISignalLocalSecretVault } from "@open-e2ee/signal-protocol-sdk";
66
+ import type { ISignalProtocolLocalSecretVault } from "@open-e2ee/signal-protocol-sdk";
67
67
 
68
- const vault: ISignalLocalSecretVault = {
68
+ const vault: ISignalProtocolLocalSecretVault = {
69
69
  getSecret: (name) => platformSecrets.getBytes(name),
70
70
  setSecret: (name, value) => platformSecrets.setBytes(name, value),
71
71
  deleteSecret: (name) => platformSecrets.delete(name),
@@ -77,23 +77,23 @@ device migration, uninstall persistence, and deletion behavior depend on the
77
77
  selected platform service and host configuration. See the
78
78
  [secret-vault guide](../local/vault/README.md).
79
79
 
80
- ## `ISignalRelayServer`
80
+ ## `ISignalProtocolRelayServer`
81
81
 
82
- `ISignalRelayServer` represents the authenticated application backend used for
82
+ `ISignalProtocolRelayServer` represents the authenticated application backend used for
83
83
  device registration, account identity state, public prekeys, encrypted-envelope
84
84
  delivery, provisioning, key rotation, and encrypted group coordination.
85
85
 
86
86
  ```ts
87
- import type { ISignalRelayServer } from "@open-e2ee/signal-protocol-sdk/remote/relay";
87
+ import type { ISignalProtocolRelayServer } from "@open-e2ee/signal-protocol-sdk/remote/relay";
88
88
  import {
89
89
  convexRelay,
90
- type ConvexSignalRelayApi,
90
+ type ConvexSignalProtocolRelayApi,
91
91
  } from "@open-e2ee/signal-protocol-sdk/remote/relay/convex";
92
92
  import { api } from "../convex/_generated/api";
93
93
 
94
- const signalApi = api.signal satisfies ConvexSignalRelayApi;
94
+ const signalApi = api.signal satisfies ConvexSignalProtocolRelayApi;
95
95
 
96
- const relay: ISignalRelayServer = convexRelay({
96
+ const relay: ISignalProtocolRelayServer = convexRelay({
97
97
  convex,
98
98
  api: signalApi,
99
99
  currentUserId: userId,
@@ -110,17 +110,17 @@ The relay stores public protocol material, ciphertext, and required routing
110
110
  metadata. It must not require device private keys or decrypted message content.
111
111
  See the [relay guide](../remote/relay/README.md).
112
112
 
113
- ## `SignalRemoteObjectStore`
113
+ ## `SignalProtocolRemoteObjectStore`
114
114
 
115
- `SignalRemoteObjectStore` supplies short-lived upload and download operations
115
+ `SignalProtocolRemoteObjectStore` supplies short-lived upload and download operations
116
116
  for already encrypted objects. It is provider-neutral and optional.
117
117
 
118
118
  ```ts
119
119
  import type {
120
- SignalRemoteObjectStore,
120
+ SignalProtocolRemoteObjectStore,
121
121
  } from "@open-e2ee/signal-protocol-sdk/remote/object-store";
122
122
 
123
- const remoteObjectStore: SignalRemoteObjectStore = {
123
+ const remoteObjectStore: SignalProtocolRemoteObjectStore = {
124
124
  createUpload: (request) => appObjectBroker.createUpload(request),
125
125
  createDownload: (request) => appObjectBroker.createDownload(request),
126
126
  completeUpload: (request) => appObjectBroker.completeUpload(request),
@@ -64,7 +64,8 @@ Expo storage or Convex helpers.
64
64
  - `@open-e2ee/signal-protocol-sdk/remote/relay`
65
65
  - `@open-e2ee/signal-protocol-sdk/remote/relay/convex`
66
66
  - `@open-e2ee/signal-protocol-sdk/remote/relay/convex/relay`
67
- - `@open-e2ee/signal-protocol-sdk/remote/relay/mock`
67
+ - `@open-e2ee/signal-protocol-sdk/convex.config`
68
+ - `@open-e2ee/signal-protocol-sdk/remote/relay/memory`
68
69
  - `@open-e2ee/signal-protocol-sdk/remote/relay/types`
69
70
  - `@open-e2ee/signal-protocol-sdk/remote/object-store`
70
71
  - `@open-e2ee/signal-protocol-sdk/remote/object-store/convex-r2`
@@ -102,7 +103,7 @@ Expo storage or Convex helpers.
102
103
  - `@open-e2ee/signal-protocol-sdk/local/store/expo`
103
104
  - `@open-e2ee/signal-protocol-sdk/local/store/expo/db`
104
105
  - `@open-e2ee/signal-protocol-sdk/local/store/expo/schema`
105
- - `@open-e2ee/signal-protocol-sdk/local/store/mock`
106
+ - `@open-e2ee/signal-protocol-sdk/local/store/memory`
106
107
  - `@open-e2ee/signal-protocol-sdk/local/store/node`
107
108
  - `@open-e2ee/signal-protocol-sdk/local/store/react-native`
108
109
  - `@open-e2ee/signal-protocol-sdk/local/store/web`
@@ -120,8 +121,8 @@ Expo storage or Convex helpers.
120
121
 
121
122
  ### Development adapters
122
123
 
123
- - `@open-e2ee/signal-protocol-sdk/remote/relay/mock`
124
- - `@open-e2ee/signal-protocol-sdk/local/store/mock`
124
+ - `@open-e2ee/signal-protocol-sdk/remote/relay/memory`
125
+ - `@open-e2ee/signal-protocol-sdk/local/store/memory`
125
126
 
126
127
  `internal/**` is implementation-only and not part of the supported external API.
127
128
 
@@ -142,24 +143,29 @@ Expo storage or Convex helpers.
142
143
 
143
144
  ### Relay implementations
144
145
 
145
- - `ConvexSignalRelayServer` for Convex-backed apps
146
+ - `ConvexSignalProtocolRelayServer` for Convex-backed apps
146
147
  - `convexRelay()` for Convex-backed composition
147
- - `MockSignalRelayServer` / `mockRelay()` for local development
148
- - custom implementations via `ISignalRelayServer`
148
+ - the installable component from
149
+ `@open-e2ee/signal-protocol-sdk/convex.config`, with public handlers from
150
+ `defineConvexSignalProtocolBackend()` and the `oe-groups` CLI
151
+ (`npx oe-groups trust-root`) for secret initialization and trust-root
152
+ export
153
+ - `InMemorySignalProtocolRelayServer` / `inMemoryRelay()` for local development
154
+ - custom implementations via `ISignalProtocolRelayServer`
149
155
 
150
156
  ### Storage implementations
151
157
 
152
- - `ExpoSignalStore` for Expo / React Native
158
+ - `ExpoSignalProtocolStore` for Expo / React Native
153
159
  - `expoStore()` for Expo / React Native composition
154
160
  - `@open-e2ee/signal-protocol-sdk/local/store/expo` also exports the Expo helpers
155
161
  Signal Protocol composes directly: `getKeyStorage`, `getDatabaseKeyManager`,
156
162
  `clearDatabaseKeyCache`, and `createPreKeyMaintenanceStore`
157
- - `IndexedDbSignalStore` / `indexedDbStore()` for browsers (experimental)
158
- - `ReactNativeSignalStore` / `reactNativeStore()` for bare React Native
163
+ - `IndexedDbSignalProtocolStore` / `indexedDbStore()` for browsers (experimental)
164
+ - `ReactNativeSignalProtocolStore` / `reactNativeStore()` for bare React Native
159
165
  (experimental; provide your own key-value backend)
160
- - `NodeSignalStore` / `nodeStore()` for Node environments
161
- - `MockSignalStore` / `mockStore()` for local development
162
- - custom implementations via `ISignalLocalStore`
166
+ - `NodeSignalProtocolStore` / `nodeStore()` for Node environments
167
+ - `InMemorySignalProtocolStore` / `inMemoryStore()` for local development
168
+ - custom implementations via `ISignalProtocolLocalStore`
163
169
 
164
170
  ### Remote object storage
165
171
 
@@ -171,7 +177,7 @@ Expo storage or Convex helpers.
171
177
  point
172
178
  - `S3ObjectStore` via `@open-e2ee/signal-protocol-sdk/remote/object-store/s3`
173
179
  - `s3ObjectStore()` for brokered Amazon S3 or S3-compatible storage
174
- - custom implementations via `SignalRemoteObjectStore`
180
+ - custom implementations via `SignalProtocolRemoteObjectStore`
175
181
 
176
182
  `ConvexR2ObjectStore` is a client adapter for authenticated app-owned Convex
177
183
  functions that wrap `@convex-dev/r2`; it is not the Convex component itself.
@@ -183,8 +189,8 @@ Both concrete adapters keep provider credentials in the application backend.
183
189
  Remote object storage is a normal first-class integration point for encrypted
184
190
  attachments and files, not a niche or internal-only adapter. Use
185
191
  `attachment.transfer` when your app has a foreground, background, resumable, or
186
- platform-native byte transfer implementation. The Signal package still owns
187
- encryption, digest verification, retry decisions, and pointer metadata.
192
+ platform-native byte transfer implementation. The Signal Protocol package still
193
+ owns encryption, digest verification, retry decisions, and pointer metadata.
188
194
 
189
195
  Object stores can return signed upload headers, and stores that return
190
196
  `protocol: 'tus'` automatically use the built-in resumable TUS transfer helper.
@@ -1,6 +1,12 @@
1
1
  # Protocol Policy Guide
2
2
 
3
- > Navigation: [README](../README.md) | [ARCHITECTURE](../ARCHITECTURE.md) | [Security](./SECURITY.md) | [Getting Started](./GETTING_STARTED.md) | **Protocol Policy**
3
+ > Navigation: [README](../README.md) | [ARCHITECTURE](../ARCHITECTURE.md) | [Security](./SECURITY.md) | [Getting Started](./GETTING_STARTED.md) | **Protocol Policy** | [Deviations](./DEVIATIONS.md)
4
+
5
+ This document covers **which protocol modes run** and which fail closed. For
6
+ **how the profile differs from the published specifications and from
7
+ `libsignal`** — the composite identity, the Ed25519-instead-of-XEdDSA signature
8
+ scheme, the ML-KEM Braid `hek` operand order, and the rest — see
9
+ [Deviations](./DEVIATIONS.md).
4
10
 
5
11
  The public Signal Protocol client policy is:
6
12
 
@@ -65,7 +71,10 @@ await createSignalProtocolClient({
65
71
 
66
72
  `braid: 'required'` uses the specification-defined ML-KEM Braid SPQR profile
67
73
  and is the default. HEK is `SHA3-256(ek_seed || ek_vector)`; that operand order
68
- is part of the public compatibility boundary.
74
+ is part of the public compatibility boundary. It follows the ML-KEM Braid
75
+ specification text and is the reverse of `libsignal`'s implementation, which means
76
+ braid sessions do not interoperate with `libsignal`'s and the KEM in this mode is not
77
+ stock FIPS 203 — see [Deviations §4.1](./DEVIATIONS.md#41-the-hek-operand-order-diverges).
69
78
 
70
79
  ```ts
71
80
  await createSignalProtocolClient({
package/docs/RECIPES.md CHANGED
@@ -13,12 +13,14 @@ uses public exports only.
13
13
  This local demo sends while Bob is offline so you can see the relay's encrypted
14
14
  envelope and Bob's decrypted plaintext in the same workflow.
15
15
 
16
+ <!-- doc-snippet:run recipes-two-local-clients expect="bob decrypted: alice: hello" -->
16
17
  ```ts
18
+ // Real protocol and cryptography; simulated in-memory infrastructure.
17
19
  import { createSignalProtocolClient } from "@open-e2ee/signal-protocol-sdk";
18
- import { mockStore } from "@open-e2ee/signal-protocol-sdk/local/store/mock";
19
- import { mockRelay } from "@open-e2ee/signal-protocol-sdk/remote/relay/mock";
20
+ import { inMemoryStore } from "@open-e2ee/signal-protocol-sdk/local/store/memory";
21
+ import { inMemoryRelay } from "@open-e2ee/signal-protocol-sdk/remote/relay/memory";
20
22
 
21
- const relay = mockRelay();
23
+ const relay = inMemoryRelay();
22
24
 
23
25
  // The relay knows which devices exist, but it does not get plaintext.
24
26
  await relay.registerDevice("alice", {
@@ -29,12 +31,12 @@ await relay.registerDevice("bob", { encryptedDeviceName: new ArrayBuffer(0) });
29
31
  // Each client represents one device. Its storage is local to that device.
30
32
  const alice = await createSignalProtocolClient({
31
33
  identity: { userId: "alice" },
32
- adapters: { storage: mockStore(), relay },
34
+ adapters: { storage: inMemoryStore(), relay },
33
35
  });
34
36
 
35
37
  const bob = await createSignalProtocolClient({
36
38
  identity: { userId: "bob" },
37
- adapters: { storage: mockStore(), relay },
39
+ adapters: { storage: inMemoryStore(), relay },
38
40
  });
39
41
 
40
42
  await alice.syncToServer();
@@ -97,12 +99,12 @@ Bob through the `onMessageDecrypted` hook.
97
99
  import { createSignalProtocolClient } from "@open-e2ee/signal-protocol-sdk";
98
100
  import {
99
101
  convexRelay,
100
- type ConvexSignalRelayApi,
102
+ type ConvexSignalProtocolRelayApi,
101
103
  } from "@open-e2ee/signal-protocol-sdk/remote/relay/convex";
102
104
  import { expoStore } from "@open-e2ee/signal-protocol-sdk/local/store/expo";
103
105
  import { api } from "../convex/_generated/api";
104
106
 
105
- const signalApi = api.signal satisfies ConvexSignalRelayApi;
107
+ const signalApi = api.signal satisfies ConvexSignalProtocolRelayApi;
106
108
 
107
109
  // The relay handles server-side public keys, devices, and encrypted envelopes.
108
110
  const relay = convexRelay({
@@ -116,7 +118,7 @@ const signal = await createSignalProtocolClient({
116
118
  identity: { userId },
117
119
  adapters: {
118
120
  // Storage owns this device's private keys and session state.
119
- storage: expoStore({ relay }),
121
+ storage: expoStore(),
120
122
  relay,
121
123
  },
122
124
  });
@@ -133,23 +135,25 @@ before creating the client.
133
135
 
134
136
  ## Local development
135
137
 
138
+ <!-- doc-snippet:run recipes-local-development expect="" -->
136
139
  ```ts
140
+ // Real protocol and cryptography; simulated in-memory infrastructure.
137
141
  import { createSignalProtocolClient } from "@open-e2ee/signal-protocol-sdk";
138
- import { mockRelay } from "@open-e2ee/signal-protocol-sdk/remote/relay/mock";
139
- import { mockStore } from "@open-e2ee/signal-protocol-sdk/local/store/mock";
142
+ import { inMemoryRelay } from "@open-e2ee/signal-protocol-sdk/remote/relay/memory";
143
+ import { inMemoryStore } from "@open-e2ee/signal-protocol-sdk/local/store/memory";
140
144
 
141
- const relay = mockRelay();
145
+ const relay = inMemoryRelay();
142
146
 
143
147
  const alice = await createSignalProtocolClient({
144
148
  // `identity` is the app account/device being represented.
145
149
  identity: { userId: "alice" },
146
150
  // `adapters` are the concrete storage/relay implementation for this run.
147
- adapters: { storage: mockStore(), relay },
151
+ adapters: { storage: inMemoryStore(), relay },
148
152
  });
149
153
 
150
154
  const bob = await createSignalProtocolClient({
151
155
  identity: { userId: "bob" },
152
- adapters: { storage: mockStore(), relay },
156
+ adapters: { storage: inMemoryStore(), relay },
153
157
  });
154
158
  ```
155
159
 
package/docs/SECURITY.md CHANGED
@@ -140,6 +140,14 @@ compromised application code, a stolen unlocked device, or an attacker who also
140
140
  obtains the adapter encryption key. Browser IndexedDB and caller-provided React
141
141
  Native storage inherit their host application's security boundary.
142
142
 
143
+ Group sender key state never leaves the device. A sender key record holds the
144
+ chain key every message key on that chain derives from and the sender's private
145
+ signature key; together they are enough to read a sender's group messages and to
146
+ forge new ones, so no adapter transmits them and no relay contract accepts them.
147
+ The same rule covers the message keys held for out-of-order group messages.
148
+ Local adapters bound that skipped-key store so a peer cannot grow it without
149
+ limit by skipping ever further ahead.
150
+
143
151
  Relay and remote object-store adapters receive public key material, routing
144
152
  metadata, and opaque ciphertext required by their contracts. TLS,
145
153
  authorization, abuse controls, atomic prekey consumption, and access logging
package/files/README.md CHANGED
@@ -29,7 +29,7 @@ const plaintext = await streamingDecrypt(
29
29
  For a complete attachment workflow with upload brokering, retries, pointer
30
30
  validation, and cleanup, use the
31
31
  [`media`](../media/README.md) module with a
32
- [`SignalRemoteObjectStore`](../remote/object-store/README.md).
32
+ [`SignalProtocolRemoteObjectStore`](../remote/object-store/README.md).
33
33
 
34
34
  Applications remain responsible for file-system permissions, cache lifetime,
35
35
  content rendering, and securely disposing of decrypted temporary files.
package/groups/README.md CHANGED
@@ -1,8 +1,8 @@
1
1
  # Groups
2
2
 
3
- The groups module provides group identifiers, encrypted Groups V2 state,
3
+ The groups module provides group identifiers, encrypted group state,
4
4
  membership transitions, access-control checks, invite links, and the
5
- `GroupsV2Manager` orchestration API.
5
+ `GroupManager` orchestration API.
6
6
 
7
7
  ## Why it exists
8
8
 
@@ -15,18 +15,23 @@ and sender-key rotation.
15
15
 
16
16
  ```ts
17
17
  import {
18
- GroupsV2Manager,
18
+ GroupManager,
19
19
  createGroupId,
20
20
  type IGroupServer,
21
21
  type IGroupStateStore,
22
22
  } from "@open-e2ee/signal-protocol-sdk/groups";
23
23
 
24
- const groups = new GroupsV2Manager({
24
+ const groups = new GroupManager({
25
25
  store: appGroupStore as IGroupStateStore,
26
26
  server: appGroupServer as IGroupServer,
27
27
  issueCredential: () => appGroupCredentials.issue(),
28
28
  credentialPublicKey,
29
+ serverSigningPublicKey,
29
30
  aci: localAccountServiceId,
31
+ pni: localPhoneNumberServiceId,
32
+ issueProfileKeyCredential: () => appGroupCredentials.issueProfileKey(),
33
+ profileKeyCredentialPublicKey,
34
+ profileKey: localProfileKey,
30
35
  });
31
36
 
32
37
  const groupId = createGroupId(rawGroupId);
@@ -36,7 +41,13 @@ const state = await groups.syncGroup(groupId);
36
41
  The server must enforce authenticated access and version sequencing without
37
42
  receiving plaintext group attributes or group master keys. Membership removal
38
43
  must also invalidate or rotate group messaging state through the callbacks
39
- required by `GroupsV2ManagerOptions`.
44
+ required by `GroupManagerOptions`. Every `getGroup()` response must include a
45
+ baseline signature over the group ID, version, and exact encrypted-state bytes;
46
+ the client verifies it before installing a first or post-revocation baseline.
47
+
48
+ Deployments whose server does not yet sign group changes must opt in explicitly
49
+ with `allowUnauthenticatedGroupHistory: true`; the SDK emits a security warning
50
+ because that mode has no authenticated group history.
40
51
 
41
52
  See the [API reference](../docs/api/README.md) and
42
53
  [security model](../docs/SECURITY.md).