@open-e2ee/signal-protocol-sdk 2.0.2 → 4.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (576) hide show
  1. package/ADAPTERS.md +14 -21
  2. package/ARCHITECTURE.md +1 -2
  3. package/CHANGELOG.md +90 -0
  4. package/LICENSE +11 -655
  5. package/LICENSE-APACHE +201 -0
  6. package/LICENSE-MIT +21 -0
  7. package/NOTICE +5 -7
  8. package/README.md +11 -11
  9. package/SECURITY.md +2 -2
  10. package/TROUBLESHOOTING.md +6 -10
  11. package/client/README.md +36 -18
  12. package/device/README.md +1 -1
  13. package/dist/blocking/manager.d.ts +2 -2
  14. package/dist/blocking/manager.d.ts.map +1 -1
  15. package/dist/blocking/manager.js.map +1 -1
  16. package/dist/client/client.d.ts +45 -34
  17. package/dist/client/client.d.ts.map +1 -1
  18. package/dist/client/client.js +178 -115
  19. package/dist/client/client.js.map +1 -1
  20. package/dist/client/compose.d.ts +7 -7
  21. package/dist/client/compose.d.ts.map +1 -1
  22. package/dist/client/compose.js +2 -2
  23. package/dist/client/compose.js.map +1 -1
  24. package/dist/client/config.d.ts +24 -28
  25. package/dist/client/config.d.ts.map +1 -1
  26. package/dist/client/config.js.map +1 -1
  27. package/dist/client/content-adapter.d.ts +2 -0
  28. package/dist/client/content-adapter.d.ts.map +1 -1
  29. package/dist/client/content-adapter.js +4 -0
  30. package/dist/client/content-adapter.js.map +1 -1
  31. package/dist/client/dual-store.d.ts +5 -5
  32. package/dist/client/dual-store.d.ts.map +1 -1
  33. package/dist/client/dual-store.js.map +1 -1
  34. package/dist/client/endorsement-manager.d.ts +6 -3
  35. package/dist/client/endorsement-manager.d.ts.map +1 -1
  36. package/dist/client/endorsement-manager.js +14 -6
  37. package/dist/client/endorsement-manager.js.map +1 -1
  38. package/dist/client/files.d.ts +1 -1
  39. package/dist/client/files.js +1 -1
  40. package/dist/client/group-authority.d.ts +8 -0
  41. package/dist/client/group-authority.d.ts.map +1 -0
  42. package/dist/client/group-authority.js +2 -0
  43. package/dist/client/group-authority.js.map +1 -0
  44. package/dist/client/group-outbox.d.ts +4 -4
  45. package/dist/client/group-outbox.d.ts.map +1 -1
  46. package/dist/client/group-sealed-sender.d.ts +2 -2
  47. package/dist/client/group-sealed-sender.d.ts.map +1 -1
  48. package/dist/client/groups.d.ts +1 -1
  49. package/dist/client/groups.js +1 -1
  50. package/dist/client/headless.d.ts +11 -16
  51. package/dist/client/headless.d.ts.map +1 -1
  52. package/dist/client/headless.js +4 -9
  53. package/dist/client/headless.js.map +1 -1
  54. package/dist/client/hosted-anonymous-delivery.d.ts +32 -0
  55. package/dist/client/hosted-anonymous-delivery.d.ts.map +1 -0
  56. package/dist/client/hosted-anonymous-delivery.js +239 -0
  57. package/dist/client/hosted-anonymous-delivery.js.map +1 -0
  58. package/dist/client/hosted-connection.d.ts +1 -1
  59. package/dist/client/hosted-connection.d.ts.map +1 -1
  60. package/dist/client/hosted-connection.js +18 -51
  61. package/dist/client/hosted-connection.js.map +1 -1
  62. package/dist/client/hosted-group-authority.d.ts +11 -0
  63. package/dist/client/hosted-group-authority.d.ts.map +1 -0
  64. package/dist/client/hosted-group-authority.js +96 -0
  65. package/dist/client/hosted-group-authority.js.map +1 -0
  66. package/dist/client/hosted-groups.d.ts +31 -0
  67. package/dist/client/hosted-groups.d.ts.map +1 -0
  68. package/dist/client/hosted-groups.js +217 -0
  69. package/dist/client/hosted-groups.js.map +1 -0
  70. package/dist/client/hosted-mailbox-subscription.d.ts +34 -0
  71. package/dist/client/hosted-mailbox-subscription.d.ts.map +1 -0
  72. package/dist/client/hosted-mailbox-subscription.js +257 -0
  73. package/dist/client/hosted-mailbox-subscription.js.map +1 -0
  74. package/dist/client/hosted-prekey-publication.d.ts +51 -0
  75. package/dist/client/hosted-prekey-publication.d.ts.map +1 -0
  76. package/dist/client/hosted-prekey-publication.js +249 -0
  77. package/dist/client/hosted-prekey-publication.js.map +1 -0
  78. package/dist/client/hosted-push.d.ts +5 -6
  79. package/dist/client/hosted-push.d.ts.map +1 -1
  80. package/dist/client/hosted-push.js +22 -22
  81. package/dist/client/hosted-push.js.map +1 -1
  82. package/dist/client/hosted-transport.d.ts +62 -40
  83. package/dist/client/hosted-transport.d.ts.map +1 -1
  84. package/dist/client/hosted-transport.js +666 -341
  85. package/dist/client/hosted-transport.js.map +1 -1
  86. package/dist/client/hosted-trust.d.ts +29 -0
  87. package/dist/client/hosted-trust.d.ts.map +1 -0
  88. package/dist/client/hosted-trust.js +28 -0
  89. package/dist/client/hosted-trust.js.map +1 -0
  90. package/dist/client/hosted.d.ts +26 -21
  91. package/dist/client/hosted.d.ts.map +1 -1
  92. package/dist/client/hosted.js +80 -36
  93. package/dist/client/hosted.js.map +1 -1
  94. package/dist/client/index.d.ts +15 -15
  95. package/dist/client/index.d.ts.map +1 -1
  96. package/dist/client/index.js +7 -7
  97. package/dist/client/index.js.map +1 -1
  98. package/dist/client/key-rotation-core.d.ts +16 -8
  99. package/dist/client/key-rotation-core.d.ts.map +1 -1
  100. package/dist/client/key-rotation-core.js +14 -3
  101. package/dist/client/key-rotation-core.js.map +1 -1
  102. package/dist/client/key-rotation.d.ts +3 -2
  103. package/dist/client/key-rotation.d.ts.map +1 -1
  104. package/dist/client/key-rotation.js +5 -5
  105. package/dist/client/key-rotation.js.map +1 -1
  106. package/dist/client/media-queue-persistence.d.ts +14 -0
  107. package/dist/client/media-queue-persistence.d.ts.map +1 -0
  108. package/dist/client/media-queue-persistence.js +123 -0
  109. package/dist/client/media-queue-persistence.js.map +1 -0
  110. package/dist/client/media-upload-budget.d.ts +3 -0
  111. package/dist/client/media-upload-budget.d.ts.map +1 -0
  112. package/dist/client/media-upload-budget.js +27 -0
  113. package/dist/client/media-upload-budget.js.map +1 -0
  114. package/dist/client/media.d.ts +51 -15
  115. package/dist/client/media.d.ts.map +1 -1
  116. package/dist/client/media.js +541 -73
  117. package/dist/client/media.js.map +1 -1
  118. package/dist/client/messages.d.ts +1 -1
  119. package/dist/client/messages.d.ts.map +1 -1
  120. package/dist/client/messages.js +14 -15
  121. package/dist/client/messages.js.map +1 -1
  122. package/dist/client/multi-device.d.ts +1 -1
  123. package/dist/client/multi-device.js +1 -1
  124. package/dist/client/prekeys.d.ts +1 -1
  125. package/dist/client/prekeys.d.ts.map +1 -1
  126. package/dist/client/prekeys.js +132 -44
  127. package/dist/client/prekeys.js.map +1 -1
  128. package/dist/client/relay-subscription.d.ts +5 -1
  129. package/dist/client/relay-subscription.d.ts.map +1 -1
  130. package/dist/client/relay-subscription.js +59 -26
  131. package/dist/client/relay-subscription.js.map +1 -1
  132. package/dist/client/retry.d.ts +3 -3
  133. package/dist/client/retry.d.ts.map +1 -1
  134. package/dist/client/retry.js +1 -1
  135. package/dist/client/retry.js.map +1 -1
  136. package/dist/client/sealed-sender.d.ts +5 -5
  137. package/dist/client/sealed-sender.d.ts.map +1 -1
  138. package/dist/client/sealed-sender.js.map +1 -1
  139. package/dist/client/sender-key-distribution.d.ts +8 -0
  140. package/dist/client/sender-key-distribution.d.ts.map +1 -0
  141. package/dist/client/sender-key-distribution.js +59 -0
  142. package/dist/client/sender-key-distribution.js.map +1 -0
  143. package/dist/client/sessions.d.ts +3 -3
  144. package/dist/client/sessions.d.ts.map +1 -1
  145. package/dist/client/sessions.js +1 -1
  146. package/dist/client/sessions.js.map +1 -1
  147. package/dist/client/signal-service-cipher.d.ts +12 -8
  148. package/dist/client/signal-service-cipher.d.ts.map +1 -1
  149. package/dist/client/signal-service-cipher.js +41 -16
  150. package/dist/client/signal-service-cipher.js.map +1 -1
  151. package/dist/client/state.d.ts +1 -1
  152. package/dist/client/state.js +1 -1
  153. package/dist/client/types.d.ts +10 -10
  154. package/dist/client/types.d.ts.map +1 -1
  155. package/dist/client/types.js +1 -1
  156. package/dist/device/connection.d.ts.map +1 -1
  157. package/dist/device/connection.js.map +1 -1
  158. package/dist/device/device-id.d.ts +2 -2
  159. package/dist/device/device-id.d.ts.map +1 -1
  160. package/dist/device/device-id.js.map +1 -1
  161. package/dist/device/{expo-metadata.d.ts → expo/index.d.ts} +3 -3
  162. package/dist/device/expo/index.d.ts.map +1 -0
  163. package/dist/device/{expo-metadata.js → expo/index.js} +2 -2
  164. package/dist/device/expo/index.js.map +1 -0
  165. package/dist/device/index.d.ts +1 -1
  166. package/dist/device/index.d.ts.map +1 -1
  167. package/dist/device/index.js +1 -1
  168. package/dist/device/index.js.map +1 -1
  169. package/dist/device/lifecycle/index.d.ts +1 -1
  170. package/dist/device/lifecycle/index.d.ts.map +1 -1
  171. package/dist/device/lifecycle/types.d.ts +8 -8
  172. package/dist/device/lifecycle/types.d.ts.map +1 -1
  173. package/dist/device/provisioning.d.ts +13 -13
  174. package/dist/device/provisioning.d.ts.map +1 -1
  175. package/dist/device/provisioning.js +1 -1
  176. package/dist/device/provisioning.js.map +1 -1
  177. package/dist/device/transfer.d.ts +13 -13
  178. package/dist/device/transfer.d.ts.map +1 -1
  179. package/dist/device/transfer.js.map +1 -1
  180. package/dist/device/types.d.ts +3 -3
  181. package/dist/device/types.d.ts.map +1 -1
  182. package/dist/groups/index.d.ts +1 -1
  183. package/dist/groups/index.d.ts.map +1 -1
  184. package/dist/groups/server.d.ts +10 -0
  185. package/dist/groups/server.d.ts.map +1 -0
  186. package/dist/groups/server.js +6 -0
  187. package/dist/groups/server.js.map +1 -0
  188. package/dist/hooks/use-connection-presence.d.ts +6 -8
  189. package/dist/hooks/use-connection-presence.d.ts.map +1 -1
  190. package/dist/hooks/use-connection-presence.js +2 -4
  191. package/dist/hooks/use-connection-presence.js.map +1 -1
  192. package/dist/hooks/use-group-membership.d.ts +2 -2
  193. package/dist/hooks/use-group-membership.d.ts.map +1 -1
  194. package/dist/hooks/use-group-membership.js.map +1 -1
  195. package/dist/hooks/use-key-rotation.d.ts +2 -2
  196. package/dist/hooks/use-key-rotation.d.ts.map +1 -1
  197. package/dist/hooks/use-session-health.d.ts +2 -2
  198. package/dist/hooks/use-session-health.d.ts.map +1 -1
  199. package/dist/index.d.ts +57 -55
  200. package/dist/index.d.ts.map +1 -1
  201. package/dist/index.js +27 -26
  202. package/dist/index.js.map +1 -1
  203. package/dist/internal/crypto/ec/x25519-validation.d.ts +4 -4
  204. package/dist/internal/crypto/ec/x25519-validation.d.ts.map +1 -1
  205. package/dist/internal/crypto/ec/x25519-validation.js.map +1 -1
  206. package/dist/internal/groups/authority-certificate.d.ts +22 -0
  207. package/dist/internal/groups/authority-certificate.d.ts.map +1 -0
  208. package/dist/internal/groups/authority-certificate.js +99 -0
  209. package/dist/internal/groups/authority-certificate.js.map +1 -0
  210. package/dist/internal/groups/error-details.d.ts +9 -0
  211. package/dist/internal/groups/error-details.d.ts.map +1 -0
  212. package/dist/internal/groups/error-details.js +30 -0
  213. package/dist/internal/groups/error-details.js.map +1 -0
  214. package/dist/internal/groups/index.d.ts +1 -1
  215. package/dist/internal/groups/index.d.ts.map +1 -1
  216. package/dist/internal/groups/manager.d.ts +9 -4
  217. package/dist/internal/groups/manager.d.ts.map +1 -1
  218. package/dist/internal/groups/manager.js +3 -0
  219. package/dist/internal/groups/manager.js.map +1 -1
  220. package/dist/internal/groups/sdk-store.d.ts +4 -4
  221. package/dist/internal/groups/sdk-store.d.ts.map +1 -1
  222. package/dist/internal/groups/sdk-store.js.map +1 -1
  223. package/dist/internal/groups/server-engine.d.ts +9 -2
  224. package/dist/internal/groups/server-engine.d.ts.map +1 -1
  225. package/dist/internal/groups/server-engine.js +51 -19
  226. package/dist/internal/groups/server-engine.js.map +1 -1
  227. package/dist/internal/groups/wire.d.ts.map +1 -1
  228. package/dist/internal/groups/wire.js +10 -9
  229. package/dist/internal/groups/wire.js.map +1 -1
  230. package/dist/internal/manager/index.d.ts +2 -2
  231. package/dist/internal/manager/index.d.ts.map +1 -1
  232. package/dist/internal/manager/index.js +1 -1
  233. package/dist/internal/manager/index.js.map +1 -1
  234. package/dist/internal/manager/manager.d.ts +23 -23
  235. package/dist/internal/manager/manager.d.ts.map +1 -1
  236. package/dist/internal/manager/manager.js +40 -43
  237. package/dist/internal/manager/manager.js.map +1 -1
  238. package/dist/internal/protocol/double-ratchet/chains.d.ts +9 -9
  239. package/dist/internal/protocol/double-ratchet/chains.d.ts.map +1 -1
  240. package/dist/internal/protocol/double-ratchet/chains.js.map +1 -1
  241. package/dist/internal/protocol/double-ratchet/ratchet.d.ts +2 -2
  242. package/dist/internal/protocol/double-ratchet/ratchet.d.ts.map +1 -1
  243. package/dist/internal/protocol/double-ratchet/ratchet.js.map +1 -1
  244. package/dist/internal/protocol/pqxdh/pqxdh.d.ts +3 -3
  245. package/dist/internal/protocol/pqxdh/pqxdh.d.ts.map +1 -1
  246. package/dist/internal/protocol/pqxdh/pqxdh.js.map +1 -1
  247. package/dist/internal/protocol/sender-keys/manager.d.ts +4 -4
  248. package/dist/internal/protocol/sender-keys/manager.d.ts.map +1 -1
  249. package/dist/internal/protocol/sender-keys/manager.js +27 -14
  250. package/dist/internal/protocol/sender-keys/manager.js.map +1 -1
  251. package/dist/internal/protocol/spqr/ml-kem-braid/authenticator.d.ts +3 -3
  252. package/dist/internal/protocol/spqr/ml-kem-braid/authenticator.d.ts.map +1 -1
  253. package/dist/internal/protocol/spqr/ml-kem-braid/incremental-kem.d.ts +3 -3
  254. package/dist/internal/protocol/spqr/ml-kem-braid/incremental-kem.d.ts.map +1 -1
  255. package/dist/internal/protocol/spqr/ml-kem-braid/index.d.ts +2 -2
  256. package/dist/internal/protocol/spqr/ml-kem-braid/index.d.ts.map +1 -1
  257. package/dist/internal/protocol/spqr/ml-kem-braid/index.js +1 -1
  258. package/dist/internal/protocol/spqr/ml-kem-braid/index.js.map +1 -1
  259. package/dist/internal/protocol/spqr/ml-kem-braid/state-machine.d.ts +3 -3
  260. package/dist/internal/protocol/spqr/ml-kem-braid/state-machine.d.ts.map +1 -1
  261. package/dist/internal/protocol/spqr/ml-kem-braid/state-machine.js +2 -2
  262. package/dist/internal/protocol/spqr/ml-kem-braid/state-machine.js.map +1 -1
  263. package/dist/internal/protocol/spqr/ml-kem-braid/types.d.ts +3 -3
  264. package/dist/internal/protocol/spqr/ml-kem-braid/types.d.ts.map +1 -1
  265. package/dist/internal/protocol/spqr/spqr.d.ts +5 -5
  266. package/dist/internal/protocol/spqr/spqr.d.ts.map +1 -1
  267. package/dist/internal/protocol/spqr/spqr.js.map +1 -1
  268. package/dist/internal/protocol/triple-ratchet/ratchet.d.ts +4 -4
  269. package/dist/internal/protocol/triple-ratchet/ratchet.d.ts.map +1 -1
  270. package/dist/internal/protocol/triple-ratchet/ratchet.js.map +1 -1
  271. package/dist/internal/protocol/x3dh/x3dh.d.ts +3 -3
  272. package/dist/internal/protocol/x3dh/x3dh.d.ts.map +1 -1
  273. package/dist/internal/protocol/x3dh/x3dh.js.map +1 -1
  274. package/dist/internal/sesame/device-registry.d.ts +16 -16
  275. package/dist/internal/sesame/device-registry.d.ts.map +1 -1
  276. package/dist/internal/sesame/device-registry.js +6 -6
  277. package/dist/internal/sesame/device-registry.js.map +1 -1
  278. package/dist/internal/sesame/index.d.ts +4 -4
  279. package/dist/internal/sesame/index.d.ts.map +1 -1
  280. package/dist/internal/sesame/index.js +2 -2
  281. package/dist/internal/sesame/index.js.map +1 -1
  282. package/dist/internal/sesame/manager.d.ts +10 -10
  283. package/dist/internal/sesame/manager.d.ts.map +1 -1
  284. package/dist/internal/sesame/manager.js +13 -13
  285. package/dist/internal/sesame/manager.js.map +1 -1
  286. package/dist/internal/sesame/types.d.ts +5 -5
  287. package/dist/internal/sesame/types.d.ts.map +1 -1
  288. package/dist/internal/session/cipher.d.ts +4 -4
  289. package/dist/internal/session/cipher.d.ts.map +1 -1
  290. package/dist/internal/session/cipher.js +31 -28
  291. package/dist/internal/session/cipher.js.map +1 -1
  292. package/dist/internal/session/decryption.js.map +1 -1
  293. package/dist/internal/session/factory.d.ts +3 -3
  294. package/dist/internal/session/factory.d.ts.map +1 -1
  295. package/dist/internal/session/factory.js.map +1 -1
  296. package/dist/internal/session/handshake.d.ts +2 -2
  297. package/dist/internal/session/handshake.d.ts.map +1 -1
  298. package/dist/internal/session/handshake.js.map +1 -1
  299. package/dist/internal/session/ratchet.d.ts +4 -4
  300. package/dist/internal/session/ratchet.d.ts.map +1 -1
  301. package/dist/internal/session/ratchet.js.map +1 -1
  302. package/dist/internal/session/types.d.ts +5 -5
  303. package/dist/internal/session/types.d.ts.map +1 -1
  304. package/dist/internal/session/validation.d.ts +3 -3
  305. package/dist/internal/session/validation.d.ts.map +1 -1
  306. package/dist/internal/session/validation.js.map +1 -1
  307. package/dist/layers.d.ts +4 -4
  308. package/dist/layers.d.ts.map +1 -1
  309. package/dist/layers.js +12 -12
  310. package/dist/layers.js.map +1 -1
  311. package/dist/local/store/expo/adapter.d.ts +15 -9
  312. package/dist/local/store/expo/adapter.d.ts.map +1 -1
  313. package/dist/local/store/expo/adapter.js +29 -10
  314. package/dist/local/store/expo/adapter.js.map +1 -1
  315. package/dist/local/store/expo/database-key.d.ts +5 -5
  316. package/dist/local/store/expo/database-key.d.ts.map +1 -1
  317. package/dist/local/store/expo/database-key.js.map +1 -1
  318. package/dist/local/store/expo/index.d.ts +3 -3
  319. package/dist/local/store/expo/index.d.ts.map +1 -1
  320. package/dist/local/store/expo/key-storage.d.ts +11 -5
  321. package/dist/local/store/expo/key-storage.d.ts.map +1 -1
  322. package/dist/local/store/expo/key-storage.js +82 -17
  323. package/dist/local/store/expo/key-storage.js.map +1 -1
  324. package/dist/local/store/expo/models/kyber-prekey-used.d.ts +1 -4
  325. package/dist/local/store/expo/models/kyber-prekey-used.d.ts.map +1 -1
  326. package/dist/local/store/expo/models/kyber-prekey-used.js +23 -9
  327. package/dist/local/store/expo/models/kyber-prekey-used.js.map +1 -1
  328. package/dist/local/store/expo/models/kyber-prekey.d.ts +4 -4
  329. package/dist/local/store/expo/models/kyber-prekey.d.ts.map +1 -1
  330. package/dist/local/store/expo/models/kyber-prekey.js +67 -26
  331. package/dist/local/store/expo/models/kyber-prekey.js.map +1 -1
  332. package/dist/local/store/expo/schema.d.ts +21 -2
  333. package/dist/local/store/expo/schema.d.ts.map +1 -1
  334. package/dist/local/store/expo/schema.js +10 -2
  335. package/dist/local/store/expo/schema.js.map +1 -1
  336. package/dist/local/store/index.d.ts +3 -3
  337. package/dist/local/store/index.d.ts.map +1 -1
  338. package/dist/local/store/index.js +1 -1
  339. package/dist/local/store/kyber-prekey-lifecycle.d.ts +46 -0
  340. package/dist/local/store/kyber-prekey-lifecycle.d.ts.map +1 -0
  341. package/dist/local/store/kyber-prekey-lifecycle.js +88 -0
  342. package/dist/local/store/kyber-prekey-lifecycle.js.map +1 -0
  343. package/dist/local/store/memory/adapter.d.ts +14 -6
  344. package/dist/local/store/memory/adapter.d.ts.map +1 -1
  345. package/dist/local/store/memory/adapter.js +114 -29
  346. package/dist/local/store/memory/adapter.js.map +1 -1
  347. package/dist/local/store/node/adapter.d.ts +9 -3
  348. package/dist/local/store/node/adapter.d.ts.map +1 -1
  349. package/dist/local/store/node/adapter.js +31 -13
  350. package/dist/local/store/node/adapter.js.map +1 -1
  351. package/dist/local/store/node/database-file-commit.d.ts +8 -0
  352. package/dist/local/store/node/database-file-commit.d.ts.map +1 -0
  353. package/dist/local/store/node/database-file-commit.js +62 -0
  354. package/dist/local/store/node/database-file-commit.js.map +1 -0
  355. package/dist/local/store/node/database-key.d.ts +6 -1
  356. package/dist/local/store/node/database-key.d.ts.map +1 -1
  357. package/dist/local/store/node/database-key.js +79 -44
  358. package/dist/local/store/node/database-key.js.map +1 -1
  359. package/dist/local/store/node/database-lock.d.ts +8 -0
  360. package/dist/local/store/node/database-lock.d.ts.map +1 -0
  361. package/dist/local/store/node/database-lock.js +44 -0
  362. package/dist/local/store/node/database-lock.js.map +1 -0
  363. package/dist/local/store/node/database.d.ts +17 -16
  364. package/dist/local/store/node/database.d.ts.map +1 -1
  365. package/dist/local/store/node/database.js +197 -202
  366. package/dist/local/store/node/database.js.map +1 -1
  367. package/dist/local/store/react-native/adapter.d.ts +10 -4
  368. package/dist/local/store/react-native/adapter.d.ts.map +1 -1
  369. package/dist/local/store/react-native/adapter.js +151 -66
  370. package/dist/local/store/react-native/adapter.js.map +1 -1
  371. package/dist/local/store/received-content.d.ts +9 -0
  372. package/dist/local/store/received-content.d.ts.map +1 -0
  373. package/dist/local/store/received-content.js +46 -0
  374. package/dist/local/store/received-content.js.map +1 -0
  375. package/dist/local/store/reliability.d.ts +4 -4
  376. package/dist/local/store/reliability.d.ts.map +1 -1
  377. package/dist/local/store/reliability.js +7 -4
  378. package/dist/local/store/reliability.js.map +1 -1
  379. package/dist/local/store/web/adapter.d.ts +11 -5
  380. package/dist/local/store/web/adapter.d.ts.map +1 -1
  381. package/dist/local/store/web/adapter.js +207 -74
  382. package/dist/local/store/web/adapter.js.map +1 -1
  383. package/dist/local/vault/expo-secure-store.d.ts +2 -2
  384. package/dist/local/vault/expo-secure-store.d.ts.map +1 -1
  385. package/dist/local/vault/index.d.ts +1 -1
  386. package/dist/local/vault/index.d.ts.map +1 -1
  387. package/dist/logger.d.ts +4 -4
  388. package/dist/logger.d.ts.map +1 -1
  389. package/dist/logger.js.map +1 -1
  390. package/dist/media/index.d.ts +71 -61
  391. package/dist/media/index.d.ts.map +1 -1
  392. package/dist/media/index.js +550 -386
  393. package/dist/media/index.js.map +1 -1
  394. package/dist/media/prepared-upload.d.ts +37 -0
  395. package/dist/media/prepared-upload.d.ts.map +1 -0
  396. package/dist/media/prepared-upload.js +46 -0
  397. package/dist/media/prepared-upload.js.map +1 -0
  398. package/dist/profile/contact-state.d.ts +2 -2
  399. package/dist/profile/contact-state.d.ts.map +1 -1
  400. package/dist/profile/contact-state.js.map +1 -1
  401. package/dist/profile/profile-key.d.ts +2 -2
  402. package/dist/profile/profile-key.d.ts.map +1 -1
  403. package/dist/profile/profile-key.js.map +1 -1
  404. package/dist/profile/update-service.d.ts +2 -2
  405. package/dist/profile/update-service.d.ts.map +1 -1
  406. package/dist/profile/update-service.js.map +1 -1
  407. package/dist/remote/object-store/convex-r2/server.d.ts +2 -1
  408. package/dist/remote/object-store/convex-r2/server.d.ts.map +1 -1
  409. package/dist/remote/object-store/convex-r2/server.js +4 -0
  410. package/dist/remote/object-store/convex-r2/server.js.map +1 -1
  411. package/dist/remote/object-store/convex-r2/storage.d.ts.map +1 -1
  412. package/dist/remote/object-store/convex-r2/storage.js +1 -0
  413. package/dist/remote/object-store/convex-r2/storage.js.map +1 -1
  414. package/dist/remote/object-store/index.d.ts +3 -1
  415. package/dist/remote/object-store/index.d.ts.map +1 -1
  416. package/dist/remote/object-store/index.js +1 -1
  417. package/dist/remote/object-store/index.js.map +1 -1
  418. package/dist/remote/object-store/s3/storage.d.ts +3 -1
  419. package/dist/remote/object-store/s3/storage.d.ts.map +1 -1
  420. package/dist/remote/object-store/s3/storage.js +9 -2
  421. package/dist/remote/object-store/s3/storage.js.map +1 -1
  422. package/dist/remote/object-store/types.d.ts +33 -4
  423. package/dist/remote/object-store/types.d.ts.map +1 -1
  424. package/dist/remote/object-store/upload-error.d.ts +23 -0
  425. package/dist/remote/object-store/upload-error.d.ts.map +1 -0
  426. package/dist/remote/object-store/upload-error.js +33 -0
  427. package/dist/remote/object-store/upload-error.js.map +1 -0
  428. package/dist/remote/object-store/validation.d.ts +7 -1
  429. package/dist/remote/object-store/validation.d.ts.map +1 -1
  430. package/dist/remote/object-store/validation.js +39 -25
  431. package/dist/remote/object-store/validation.js.map +1 -1
  432. package/dist/remote/relay/index.d.ts +7 -14
  433. package/dist/remote/relay/index.d.ts.map +1 -1
  434. package/dist/remote/relay/index.js +6 -13
  435. package/dist/remote/relay/index.js.map +1 -1
  436. package/dist/remote/relay/memory/adapter.d.ts +5 -4
  437. package/dist/remote/relay/memory/adapter.d.ts.map +1 -1
  438. package/dist/remote/relay/memory/adapter.js +14 -4
  439. package/dist/remote/relay/memory/adapter.js.map +1 -1
  440. package/dist/remote/relay/types.d.ts +36 -25
  441. package/dist/remote/relay/types.d.ts.map +1 -1
  442. package/dist/remote/relay/types.js +1 -1
  443. package/dist/types/api.d.ts +59 -24
  444. package/dist/types/api.d.ts.map +1 -1
  445. package/dist/types/index.js +1 -1
  446. package/dist/types/index.js.map +1 -1
  447. package/dist/types/session.d.ts +6 -0
  448. package/dist/types/session.d.ts.map +1 -1
  449. package/dist/types/session.js.map +1 -1
  450. package/docs/ASSURANCE.md +7 -7
  451. package/docs/CLIENT_COMPOSITION.md +16 -23
  452. package/docs/DEVIATIONS.md +1 -1
  453. package/docs/DOCUMENTATION_STANDARDS.md +4 -0
  454. package/docs/ERROR_HANDLING.md +2 -2
  455. package/docs/GETTING_STARTED.md +23 -38
  456. package/docs/INTERFACES.md +36 -27
  457. package/docs/PACKAGE_SURFACE.md +9 -16
  458. package/docs/RECIPES.md +10 -23
  459. package/examples/browser/index.html +2 -2
  460. package/groups/README.md +4 -4
  461. package/local/store/README.md +22 -7
  462. package/local/store/expo/README.md +24 -20
  463. package/local/store/memory/README.md +1 -1
  464. package/local/store/node/README.md +31 -2
  465. package/local/store/react-native/README.md +1 -1
  466. package/local/store/web/README.md +1 -1
  467. package/local/vault/README.md +1 -1
  468. package/media/README.md +94 -0
  469. package/package.json +17 -27
  470. package/remote/README.md +24 -24
  471. package/remote/object-store/README.md +8 -0
  472. package/remote/object-store/s3/README.md +10 -1
  473. package/remote/relay/README.md +4 -3
  474. package/remote/relay/memory/README.md +1 -1
  475. package/types/README.md +2 -2
  476. package/COMMERCIAL.md +0 -56
  477. package/dist/device/expo-metadata.d.ts.map +0 -1
  478. package/dist/device/expo-metadata.js.map +0 -1
  479. package/dist/remote/relay/convex/backend.d.ts +0 -394
  480. package/dist/remote/relay/convex/backend.d.ts.map +0 -1
  481. package/dist/remote/relay/convex/backend.js +0 -678
  482. package/dist/remote/relay/convex/backend.js.map +0 -1
  483. package/dist/remote/relay/convex/component/_generated/api.d.ts +0 -58
  484. package/dist/remote/relay/convex/component/_generated/api.d.ts.map +0 -1
  485. package/dist/remote/relay/convex/component/_generated/api.js +0 -31
  486. package/dist/remote/relay/convex/component/_generated/api.js.map +0 -1
  487. package/dist/remote/relay/convex/component/_generated/component.d.ts +0 -475
  488. package/dist/remote/relay/convex/component/_generated/component.d.ts.map +0 -1
  489. package/dist/remote/relay/convex/component/_generated/component.js +0 -11
  490. package/dist/remote/relay/convex/component/_generated/component.js.map +0 -1
  491. package/dist/remote/relay/convex/component/_generated/dataModel.d.ts +0 -46
  492. package/dist/remote/relay/convex/component/_generated/dataModel.d.ts.map +0 -1
  493. package/dist/remote/relay/convex/component/_generated/dataModel.js +0 -11
  494. package/dist/remote/relay/convex/component/_generated/dataModel.js.map +0 -1
  495. package/dist/remote/relay/convex/component/_generated/server.d.ts +0 -129
  496. package/dist/remote/relay/convex/component/_generated/server.d.ts.map +0 -1
  497. package/dist/remote/relay/convex/component/_generated/server.js +0 -79
  498. package/dist/remote/relay/convex/component/_generated/server.js.map +0 -1
  499. package/dist/remote/relay/convex/component/accounts.d.ts +0 -45
  500. package/dist/remote/relay/convex/component/accounts.d.ts.map +0 -1
  501. package/dist/remote/relay/convex/component/accounts.js +0 -184
  502. package/dist/remote/relay/convex/component/accounts.js.map +0 -1
  503. package/dist/remote/relay/convex/component/certificates.d.ts +0 -10
  504. package/dist/remote/relay/convex/component/certificates.d.ts.map +0 -1
  505. package/dist/remote/relay/convex/component/certificates.js +0 -126
  506. package/dist/remote/relay/convex/component/certificates.js.map +0 -1
  507. package/dist/remote/relay/convex/component/cleanup.d.ts +0 -32
  508. package/dist/remote/relay/convex/component/cleanup.d.ts.map +0 -1
  509. package/dist/remote/relay/convex/component/cleanup.js +0 -146
  510. package/dist/remote/relay/convex/component/cleanup.js.map +0 -1
  511. package/dist/remote/relay/convex/component/convex.config.d.ts +0 -5
  512. package/dist/remote/relay/convex/component/convex.config.d.ts.map +0 -1
  513. package/dist/remote/relay/convex/component/convex.config.js +0 -35
  514. package/dist/remote/relay/convex/component/convex.config.js.map +0 -1
  515. package/dist/remote/relay/convex/component/crons.d.ts +0 -3
  516. package/dist/remote/relay/convex/component/crons.d.ts.map +0 -1
  517. package/dist/remote/relay/convex/component/crons.js +0 -10
  518. package/dist/remote/relay/convex/component/crons.js.map +0 -1
  519. package/dist/remote/relay/convex/component/devices.d.ts +0 -102
  520. package/dist/remote/relay/convex/component/devices.d.ts.map +0 -1
  521. package/dist/remote/relay/convex/component/devices.js +0 -300
  522. package/dist/remote/relay/convex/component/devices.js.map +0 -1
  523. package/dist/remote/relay/convex/component/errors.d.ts +0 -22
  524. package/dist/remote/relay/convex/component/errors.d.ts.map +0 -1
  525. package/dist/remote/relay/convex/component/errors.js +0 -17
  526. package/dist/remote/relay/convex/component/errors.js.map +0 -1
  527. package/dist/remote/relay/convex/component/groups.d.ts +0 -63
  528. package/dist/remote/relay/convex/component/groups.d.ts.map +0 -1
  529. package/dist/remote/relay/convex/component/groups.js +0 -341
  530. package/dist/remote/relay/convex/component/groups.js.map +0 -1
  531. package/dist/remote/relay/convex/component/keys.d.ts +0 -130
  532. package/dist/remote/relay/convex/component/keys.d.ts.map +0 -1
  533. package/dist/remote/relay/convex/component/keys.js +0 -578
  534. package/dist/remote/relay/convex/component/keys.js.map +0 -1
  535. package/dist/remote/relay/convex/component/messages.d.ts +0 -105
  536. package/dist/remote/relay/convex/component/messages.d.ts.map +0 -1
  537. package/dist/remote/relay/convex/component/messages.js +0 -702
  538. package/dist/remote/relay/convex/component/messages.js.map +0 -1
  539. package/dist/remote/relay/convex/component/provisioning.d.ts +0 -92
  540. package/dist/remote/relay/convex/component/provisioning.d.ts.map +0 -1
  541. package/dist/remote/relay/convex/component/provisioning.js +0 -360
  542. package/dist/remote/relay/convex/component/provisioning.js.map +0 -1
  543. package/dist/remote/relay/convex/component/runtime.d.ts +0 -18
  544. package/dist/remote/relay/convex/component/runtime.d.ts.map +0 -1
  545. package/dist/remote/relay/convex/component/runtime.js +0 -144
  546. package/dist/remote/relay/convex/component/runtime.js.map +0 -1
  547. package/dist/remote/relay/convex/component/schema.d.ts +0 -358
  548. package/dist/remote/relay/convex/component/schema.d.ts.map +0 -1
  549. package/dist/remote/relay/convex/component/schema.js +0 -288
  550. package/dist/remote/relay/convex/component/schema.js.map +0 -1
  551. package/dist/remote/relay/convex/component/zkAuth.d.ts +0 -18
  552. package/dist/remote/relay/convex/component/zkAuth.d.ts.map +0 -1
  553. package/dist/remote/relay/convex/component/zkAuth.js +0 -86
  554. package/dist/remote/relay/convex/component/zkAuth.js.map +0 -1
  555. package/dist/remote/relay/convex/constants.d.ts +0 -3
  556. package/dist/remote/relay/convex/constants.d.ts.map +0 -1
  557. package/dist/remote/relay/convex/constants.js +0 -3
  558. package/dist/remote/relay/convex/constants.js.map +0 -1
  559. package/dist/remote/relay/convex/group-server.d.ts +0 -123
  560. package/dist/remote/relay/convex/group-server.d.ts.map +0 -1
  561. package/dist/remote/relay/convex/group-server.js +0 -184
  562. package/dist/remote/relay/convex/group-server.js.map +0 -1
  563. package/dist/remote/relay/convex/index.d.ts +0 -42
  564. package/dist/remote/relay/convex/index.d.ts.map +0 -1
  565. package/dist/remote/relay/convex/index.js +0 -38
  566. package/dist/remote/relay/convex/index.js.map +0 -1
  567. package/dist/remote/relay/convex/relay.d.ts +0 -323
  568. package/dist/remote/relay/convex/relay.d.ts.map +0 -1
  569. package/dist/remote/relay/convex/relay.js +0 -1144
  570. package/dist/remote/relay/convex/relay.js.map +0 -1
  571. package/dist/remote/relay/convex/types.d.ts +0 -24
  572. package/dist/remote/relay/convex/types.d.ts.map +0 -1
  573. package/dist/remote/relay/convex/types.js +0 -14
  574. package/dist/remote/relay/convex/types.js.map +0 -1
  575. package/remote/relay/convex/README.md +0 -61
  576. package/remote/relay/convex/component/README.md +0 -462
@@ -1,11 +1,11 @@
1
1
  /**
2
- * SignalProtocolClient - initialized client class for encrypted messaging.
2
+ * DefaultSignalProtocolClient - initialized client class for encrypted messaging.
3
3
  *
4
4
  * @layer 1 - API
5
- * @boundary ISignalProtocolClient
5
+ * @boundary SignalProtocolClient
6
6
  *
7
7
  * Application code should usually create clients with `createSignalProtocolClient()`.
8
- * Use `SignalProtocolClient.create()` directly when lower-level integration code already
8
+ * Use `DefaultSignalProtocolClient.create()` directly when lower-level integration code already
9
9
  * owns the flattened config shape.
10
10
  *
11
11
  * @example Basic usage
@@ -35,17 +35,17 @@
35
35
  *
36
36
  * @example Low-level factory
37
37
  * ```typescript
38
- * import { SignalProtocolClient } from '@open-e2ee/signal-protocol-sdk';
38
+ * import { DefaultSignalProtocolClient } from '@open-e2ee/signal-protocol-sdk';
39
39
  *
40
- * const signal = await SignalProtocolClient.create(userId, {
40
+ * const signal = await DefaultSignalProtocolClient.create(userId, {
41
41
  * storage,
42
42
  * relay,
43
43
  * });
44
44
  * ```
45
45
  */
46
46
  import AsyncLock from 'async-lock';
47
- import { SignalProtocolManager } from '../internal/manager/index.js';
48
- import { SesameManager } from '../internal/sesame/index.js';
47
+ import { DefaultSignalProtocolManager } from '../internal/manager/index.js';
48
+ import { DefaultSesameManager } from '../internal/sesame/index.js';
49
49
  import { createCompositeIdentityV1 } from '../keys/identity.js';
50
50
  import { EncryptionError, EncryptionErrorCode } from '../types/index.js';
51
51
  import { base64ToBytes, bytesToBase64, constantTimeEqual } from '../internal/crypto/index.js';
@@ -78,7 +78,7 @@ import { deriveAccessKey } from '../internal/protocol/sealed-sender/delivery-tok
78
78
  export { IMPLICIT_ENVELOPE_TYPES } from './constants.js';
79
79
  /**
80
80
  * Module-level lock for storage initialization.
81
- * Prevents multiple concurrent SignalProtocolClient.create() calls from creating
81
+ * Prevents multiple concurrent DefaultSignalProtocolClient.create() calls from creating
82
82
  * duplicate storage adapters that compete for database locks.
83
83
  */
84
84
  const storageLock = new AsyncLock({
@@ -106,12 +106,12 @@ function isDataMessage(content) {
106
106
  * - Clear error handling
107
107
  * - Type-safe API
108
108
  *
109
- * This client implements the ISignalProtocolClient interface and wraps
110
- * SignalProtocolManager with additional high-level functionality.
109
+ * This client implements the SignalProtocolClient interface and wraps
110
+ * DefaultSignalProtocolManager with additional high-level functionality.
111
111
  *
112
112
  * @category Primary API
113
113
  */
114
- export class SignalProtocolClient {
114
+ export class DefaultSignalProtocolClient {
115
115
  manager;
116
116
  _storage;
117
117
  relay;
@@ -125,7 +125,7 @@ export class SignalProtocolClient {
125
125
  deviceId; // 1 = primary, 2-5 = linked devices
126
126
  /**
127
127
  * Get user ID for this client instance
128
- * @see ISignalProtocolClient.userId
128
+ * @see SignalProtocolClient.userId
129
129
  */
130
130
  get userId() {
131
131
  return this._userId;
@@ -136,6 +136,7 @@ export class SignalProtocolClient {
136
136
  senderKeyManager;
137
137
  // Group state management
138
138
  groupManager;
139
+ groupSessionFor;
139
140
  groupStore;
140
141
  // Cipher coordination (encrypts/decrypts, routes to appropriate cipher)
141
142
  cipher;
@@ -176,7 +177,7 @@ export class SignalProtocolClient {
176
177
  // Constants are now imported from state.ts for single source of truth
177
178
  // See SIGNAL_PROTOCOL_CLIENT_CONSTANTS for timing and retry configuration
178
179
  /**
179
- * Private constructor - use SignalProtocolClient.create() to instantiate
180
+ * Private constructor - use DefaultSignalProtocolClient.create() to instantiate
180
181
  *
181
182
  * @param userId - User identifier
182
183
  * @param deviceId - Device identifier (1 = primary, 2-5 = linked devices)
@@ -195,7 +196,7 @@ export class SignalProtocolClient {
195
196
  this.remoteObjectStore = config.remoteObjectStore;
196
197
  // Dependency injection: Storage is always provided by create() callers.
197
198
  if (!config.storage) {
198
- throw new Error('Storage must be provided by SignalProtocolClient.create() callers');
199
+ throw new Error('Storage must be provided by DefaultSignalProtocolClient.create() callers');
199
200
  }
200
201
  this._storage = config.storage;
201
202
  this._storage.setLogger?.(this.logger);
@@ -207,13 +208,13 @@ export class SignalProtocolClient {
207
208
  // Dependency injection: Use provided protocol manager or create new one with our storage and protocol strategy
208
209
  this.manager =
209
210
  config.protocolManager ??
210
- new SignalProtocolManager(this._storage, config.protocolStrategy, this.logger);
211
+ new DefaultSignalProtocolManager(this._storage, config.protocolStrategy, this.logger);
211
212
  // Validate manager was created successfully before initializing Sesame
212
213
  if (!this.manager) {
213
214
  throw new EncryptionError('Protocol manager must be initialized before Sesame manager', EncryptionErrorCode.INITIALIZATION_FAILED);
214
215
  }
215
216
  // Initialize Sesame manager for multi-device support
216
- this.sesameManager = new SesameManager(this._storage, {}, // Use default Sesame config
217
+ this.sesameManager = new DefaultSesameManager(this._storage, {}, // Use default Sesame config
217
218
  this.manager, undefined, this.logger);
218
219
  // Wire up MessageRecord storage for retry request support (SESAME spec §6.2)
219
220
  this.sesameManager.setMessageRecordStore(this._storage);
@@ -221,56 +222,68 @@ export class SignalProtocolClient {
221
222
  this.senderKeyManager = new SenderKeyManager(this._storage, config?.senderKeys, this.logger);
222
223
  // Initialize the group manager if configured
223
224
  if (config?.groups) {
224
- const capability = this.relay?.groupServer;
225
- const server = config.groups.server ?? capability?.server;
226
- const issueCredential = config.groups.issueCredential ??
227
- (capability ? () => capability.issueAuthCredential(this._userId) : undefined);
228
- const issueProfileKeyCredential = config.groups.issueProfileKeyCredential ??
229
- (capability
230
- ? async (request) => {
231
- const accessKey = await deriveAccessKey(config.groups.profileKey);
232
- await capability.setUnidentifiedAccessKey(this._userId, accessKey);
233
- return capability.issueProfileKeyCredential(this._userId, request);
234
- }
235
- : undefined);
236
- if (!server || !issueCredential || !issueProfileKeyCredential) {
237
- const missing = [
238
- !server ? 'server' : undefined,
239
- !issueCredential ? 'issueCredential' : undefined,
240
- !issueProfileKeyCredential ? 'issueProfileKeyCredential' : undefined,
241
- ].filter((value) => value !== undefined);
242
- throw new Error(`Groups require the relay.groupServer capability or explicit overrides; missing: ${missing.join(', ')}`);
243
- }
244
- if (!config.aci) {
245
- throw new Error('Groups require the client identity ACI; set identity.aci');
246
- }
247
- const trustRoot = decodeGroupTrustRoot(config.groups.trustRoot);
225
+ const groupConfig = config.groups;
248
226
  this.groupStore = config.groups.store ?? new SignalProtocolGroupStateStore(this._storage);
249
- const endorsementManager = config.groups.endorsementManager;
250
- endorsementManager?.assertEndorsementRootPublicKey(trustRoot.endorsementRootPublicKey);
251
- this.groupManager = new GroupManager({
252
- store: this.groupStore,
253
- server,
254
- issueCredential,
255
- credentialPublicKey: trustRoot.credentialPublicKey,
256
- serverSigningPublicKey: trustRoot.serverSigningPublicKey,
257
- allowUnauthenticatedGroupHistory: config.groups.allowUnauthenticatedGroupHistory,
258
- onConfigurationWarning: config.groups.onConfigurationWarning,
259
- aci: config.aci,
260
- pni: config.pni,
261
- issueProfileKeyCredential,
262
- profileKeyCredentialPublicKey: trustRoot.profileKeyCredentialPublicKey,
263
- profileKey: config.groups.profileKey,
264
- onSenderKeyRotation: async (groupId) => {
265
- // Forward to existing sender key rotation
266
- await this.rotateGroupSenderKey(groupId);
267
- },
268
- onEndorsementsInvalidated: endorsementManager
269
- ? async (groupId) => {
270
- await endorsementManager.clearGroupEndorsements(groupId);
271
- }
272
- : undefined,
273
- });
227
+ const sessions = new WeakMap();
228
+ this.groupSessionFor = (authority) => {
229
+ const cached = sessions.get(authority);
230
+ if (cached)
231
+ return cached;
232
+ const capability = this.relay?.groupServer;
233
+ const server = groupConfig.server ?? capability?.server;
234
+ const issueCredential = groupConfig.issueCredential ??
235
+ (capability ? () => capability.issueAuthCredential(this._userId, authority.authorityKeyId) : undefined);
236
+ const issueProfileKeyCredential = groupConfig.issueProfileKeyCredential ??
237
+ (capability
238
+ ? async (request) => {
239
+ const accessKey = await deriveAccessKey(groupConfig.profileKey);
240
+ await capability.setUnidentifiedAccessKey(this._userId, accessKey);
241
+ return capability.issueProfileKeyCredential(this._userId, request, authority.authorityKeyId);
242
+ }
243
+ : undefined);
244
+ if (!server || !issueCredential || !issueProfileKeyCredential) {
245
+ const missing = [
246
+ !server ? 'server' : undefined,
247
+ !issueCredential ? 'issueCredential' : undefined,
248
+ !issueProfileKeyCredential ? 'issueProfileKeyCredential' : undefined,
249
+ ].filter((value) => value !== undefined);
250
+ throw new Error(`Groups require the relay.groupServer capability or explicit overrides; missing: ${missing.join(', ')}`);
251
+ }
252
+ if (!config.aci) {
253
+ throw new Error('Groups require the client identity ACI; set identity.aci');
254
+ }
255
+ const trustRoot = decodeGroupTrustRoot(authority.trustRoot);
256
+ const endorsementManager = authority.endorsementManager;
257
+ endorsementManager?.assertEndorsementRootPublicKey(trustRoot.endorsementRootPublicKey);
258
+ const manager = new GroupManager({
259
+ store: this.groupStore,
260
+ authorityKeyId: authority.authorityKeyId,
261
+ server,
262
+ issueCredential,
263
+ credentialPublicKey: trustRoot.credentialPublicKey,
264
+ serverSigningPublicKey: trustRoot.serverSigningPublicKey,
265
+ allowUnauthenticatedGroupHistory: groupConfig.allowUnauthenticatedGroupHistory,
266
+ onConfigurationWarning: groupConfig.onConfigurationWarning,
267
+ aci: config.aci,
268
+ pni: config.pni,
269
+ issueProfileKeyCredential,
270
+ profileKeyCredentialPublicKey: trustRoot.profileKeyCredentialPublicKey,
271
+ profileKey: groupConfig.profileKey,
272
+ onSenderKeyRotation: async (groupId) => {
273
+ // Forward to existing sender key rotation
274
+ await this.rotateGroupSenderKey(groupId);
275
+ },
276
+ onEndorsementsInvalidated: endorsementManager
277
+ ? async (groupId) => {
278
+ await endorsementManager.clearGroupEndorsements(groupId);
279
+ }
280
+ : undefined,
281
+ });
282
+ const session = { manager, endorsementManager };
283
+ sessions.set(authority, session);
284
+ return session;
285
+ };
286
+ this.groupManager = this.groupSessionFor(config.groups).manager;
274
287
  }
275
288
  // Initialize cipher for encrypt/decrypt coordination
276
289
  this.cipher = new SignalProtocolServiceCipher(this._userId, deviceId, this.sesameManager, this.senderKeyManager, this._storage, this.relay, this.remoteObjectStore, this.contentAdapter, this.logger);
@@ -359,11 +372,25 @@ export class SignalProtocolClient {
359
372
  }
360
373
  // Set up endorsement manager if configured
361
374
  if (config?.groups?.endorsementManager) {
362
- this.cipher.setEndorsementManager(config.groups.endorsementManager);
375
+ this.cipher.setEndorsementManager(config.groups.endorsementManager, config.groups.resolveAuthority ? async () => (await this.resolveGroupSession()).endorsementManager : undefined);
363
376
  }
364
377
  // Set up group secret params provider. Derives params from master key in store
365
378
  if (this.groupStore) {
366
379
  const store = this.groupStore;
380
+ const resolveAcis = config.groups?.resolveAciBytesByUserIds;
381
+ const localAci = config.aci?.uuid;
382
+ this.cipher.setGroupReceiveAuthorizer(async (groupId, senderId) => {
383
+ if (!resolveAcis || !localAci) {
384
+ throw new Error('Group reception requires authenticated account ACI resolution');
385
+ }
386
+ const state = await store.getGroupState(groupId);
387
+ const senderAci = (await resolveAcis([senderId])).get(senderId);
388
+ if (!state || !senderAci ||
389
+ !state.members.some((member) => constantTimeEqual(member.aciBytes, senderAci)) ||
390
+ !state.members.some((member) => constantTimeEqual(member.aciBytes, localAci))) {
391
+ throw new Error('Group sender and recipient must be members of the verified local group');
392
+ }
393
+ });
367
394
  this.cipher.setGroupSecretParamsProvider(async (groupId) => {
368
395
  const masterKey = await store.getMasterKey(groupId);
369
396
  if (!masterKey)
@@ -380,22 +407,23 @@ export class SignalProtocolClient {
380
407
  this.relay?.refreshGroupSendEndorsements &&
381
408
  this.groupManager) {
382
409
  const groupConfig = config.groups;
383
- const endorsementManager = groupConfig.endorsementManager;
384
410
  const groupStore = this.groupStore;
385
- const groupManager = this.groupManager;
386
411
  const relay = this.relay;
387
412
  const selfUserId = this._userId;
388
413
  this.cipher.setEndorsementRefresher(async (groupId, memberUserIds) => {
414
+ const { manager: groupManager, endorsementManager } = await this.resolveGroupSession();
415
+ if (!endorsementManager)
416
+ return false;
389
417
  // 1. Build ZK authorization (credential presentation + group public params)
390
418
  const authorization = await groupManager.getAuthorization(groupId);
391
419
  // 2. Get group secret params for endorsement processing
392
420
  const masterKey = await groupStore.getMasterKey(groupId);
393
421
  if (!masterKey)
394
422
  return false;
395
- const { deriveGroupSecretParams } = await import('../internal/protocol/zk/groups/index.js');
423
+ const { deriveGroupSecretParams, getGroupPublicParams } = await import('../internal/protocol/zk/groups/index.js');
396
424
  const secretParams = deriveGroupSecretParams(masterKey);
397
- // 3. Convert groupId to bytes for relay call
398
- const groupIdBytes = new TextEncoder().encode(groupId);
425
+ // 3. Derive the protocol identifier, not the display identifier's UTF-8 bytes.
426
+ const groupIdBytes = getGroupPublicParams(secretParams).groupId;
399
427
  // 4. Fetch fresh endorsements from server
400
428
  const { endorsements } = await relay.refreshGroupSendEndorsements(groupIdBytes, authorization);
401
429
  // 5. Get cached group state for member ordering (server order)
@@ -440,7 +468,7 @@ export class SignalProtocolClient {
440
468
  }
441
469
  // NOTE: hooks are initialized in constructor (this.hooks = config?.hooks || {})
442
470
  if (config?.enableDebugLogging) {
443
- this.logger.debug('SignalProtocolClient created', {
471
+ this.logger.debug('DefaultSignalProtocolClient created', {
444
472
  category: 'E2EE',
445
473
  data: { userId, deviceId, config: this.sanitizeConfig(config) },
446
474
  });
@@ -537,11 +565,17 @@ export class SignalProtocolClient {
537
565
  /**
538
566
  * Get GroupManager, throwing if not configured.
539
567
  */
540
- get groups() {
541
- if (!this.groupManager) {
542
- throw new EncryptionError('Groups not configured. Provide groups config to SignalProtocolClient.create().', EncryptionErrorCode.INITIALIZATION_FAILED);
568
+ async resolveGroupSession() {
569
+ if (!this.groupSessionFor || !this.config.groups) {
570
+ throw new EncryptionError('Groups not configured. Provide groups config to DefaultSignalProtocolClient.create().', EncryptionErrorCode.INITIALIZATION_FAILED);
543
571
  }
544
- return this.groupManager;
572
+ const authority = this.config.groups.resolveAuthority
573
+ ? await this.config.groups.resolveAuthority()
574
+ : this.config.groups;
575
+ return this.groupSessionFor(authority);
576
+ }
577
+ get groups() {
578
+ return this.resolveGroupSession().then((session) => session.manager);
545
579
  }
546
580
  /**
547
581
  * Get retry configuration for retry operations
@@ -577,7 +611,7 @@ export class SignalProtocolClient {
577
611
  return this.state.getRelaySubscriptionState();
578
612
  }
579
613
  /**
580
- * Get relay subscription callbacks (delegate back to SignalProtocolClient methods)
614
+ * Get relay subscription callbacks (delegate back to DefaultSignalProtocolClient methods)
581
615
  */
582
616
  get relaySubscriptionCallbacks() {
583
617
  return {
@@ -596,7 +630,7 @@ export class SignalProtocolClient {
596
630
  };
597
631
  }
598
632
  /**
599
- * Create and initialize a new SignalProtocolClient instance.
633
+ * Create and initialize a new DefaultSignalProtocolClient instance.
600
634
  *
601
635
  * This low-level factory fully initializes the client before it returns
602
636
  * it. Most app code should prefer `createSignalProtocolClient()`, which
@@ -607,27 +641,27 @@ export class SignalProtocolClient {
607
641
  *
608
642
  * @param userId - User identifier for this device/client
609
643
  * @param config - Optional configuration for the client
610
- * @returns Fully initialized SignalProtocolClient instance
644
+ * @returns Fully initialized DefaultSignalProtocolClient instance
611
645
  *
612
646
  * @example
613
647
  * ```typescript
614
- * import { SignalProtocolClient } from '@open-e2ee/signal-protocol-sdk';
615
- * import { convexRelay } from '@open-e2ee/signal-protocol-sdk/remote/relay/convex';
648
+ * import { DefaultSignalProtocolClient } from '@open-e2ee/signal-protocol-sdk';
649
+ * import { inMemoryRelay } from '@open-e2ee/signal-protocol-sdk/remote/relay/memory';
616
650
  *
617
651
  * // Local-only primary device.
618
- * const signal = await SignalProtocolClient.create('user-123', {
652
+ * const signal = await DefaultSignalProtocolClient.create('user-123', {
619
653
  * storage,
620
654
  * });
621
655
  *
622
656
  * // Linked device; storage must already contain provisioned identity material.
623
- * const signal = await SignalProtocolClient.create('user-123', {
657
+ * const signal = await DefaultSignalProtocolClient.create('user-123', {
624
658
  * deviceId: 2,
625
659
  * storage: provisionedLinkedDeviceStorage
626
660
  * });
627
661
  *
628
662
  * // With relay sync.
629
- * const relay = convexRelay({ convex, api: signalApi, currentUserId: userId });
630
- * const signal = await SignalProtocolClient.create('user-123', {
663
+ * const relay = inMemoryRelay();
664
+ * const signal = await DefaultSignalProtocolClient.create('user-123', {
631
665
  * storage,
632
666
  * relay,
633
667
  * onProgress: ({ stage, percent, message }) => {
@@ -636,7 +670,7 @@ export class SignalProtocolClient {
636
670
  * });
637
671
  *
638
672
  * // With full configuration
639
- * const signal = await SignalProtocolClient.create('user-123', {
673
+ * const signal = await DefaultSignalProtocolClient.create('user-123', {
640
674
  * deviceId: 1,
641
675
  * storage,
642
676
  * relay,
@@ -647,7 +681,7 @@ export class SignalProtocolClient {
647
681
  * });
648
682
  *
649
683
  * // For local development with in-memory adapters
650
- * const signal = await SignalProtocolClient.create('local-user', {
684
+ * const signal = await DefaultSignalProtocolClient.create('local-user', {
651
685
  * protocolManager: inMemoryManager,
652
686
  * storage: inMemoryStorage
653
687
  * });
@@ -659,10 +693,10 @@ export class SignalProtocolClient {
659
693
  // The lock allows only one storage instance per userId, which prevents database lock
660
694
  // contention and session state corruption.
661
695
  return storageLock.acquire(`storage-init-${userId}`, async () => {
662
- // Storage is required - SignalProtocolClient is platform-agnostic
696
+ // Storage is required - DefaultSignalProtocolClient is platform-agnostic
663
697
  // Each platform must provide its own storage implementation
664
698
  if (!config?.storage) {
665
- throw new Error('SignalProtocolClient.create() requires storage. ' +
699
+ throw new Error('DefaultSignalProtocolClient.create() requires storage. ' +
666
700
  'Expo: import { expoStore } from "@open-e2ee/signal-protocol-sdk/local/store/expo"; ' +
667
701
  'Web: import { indexedDbStore } from "@open-e2ee/signal-protocol-sdk/local/store/web"; ' +
668
702
  'Node: import { nodeStore } from "@open-e2ee/signal-protocol-sdk/local/store/node";');
@@ -682,7 +716,7 @@ export class SignalProtocolClient {
682
716
  }
683
717
  }
684
718
  }
685
- const client = new SignalProtocolClient(userId, deviceId, finalConfig);
719
+ const client = new DefaultSignalProtocolClient(userId, deviceId, finalConfig);
686
720
  await client.initialize();
687
721
  await client.hydratePersistedState();
688
722
  // Cleanup expired sessions and message records on startup.
@@ -906,8 +940,8 @@ export class SignalProtocolClient {
906
940
  *
907
941
  * @example
908
942
  * ```typescript
909
- * const alice = await SignalProtocolClient.create('alice', { storage: aliceStorage });
910
- * const bob = await SignalProtocolClient.create('bob', { storage: bobStorage });
943
+ * const alice = await DefaultSignalProtocolClient.create('alice', { storage: aliceStorage });
944
+ * const bob = await DefaultSignalProtocolClient.create('bob', { storage: bobStorage });
911
945
  *
912
946
  * // Use address() to reference the local device
913
947
  * await alice.encryptMessage(bob.address(), 'Hello');
@@ -1173,6 +1207,35 @@ export class SignalProtocolClient {
1173
1207
  }
1174
1208
  return results;
1175
1209
  }
1210
+ /**
1211
+ * Receive a pulled batch through the subscription content handler.
1212
+ * The application must register onMessageDecrypted before calling this method.
1213
+ * Successful IDs are ready for transport acknowledgment.
1214
+ */
1215
+ async receiveIncomingEnvelopes(envelopes) {
1216
+ if (!this.hooks?.onMessageDecrypted) {
1217
+ throw new Error('Register onMessageDecrypted before receiving Relay messages');
1218
+ }
1219
+ const processedMessageIds = [];
1220
+ const failedMessageIds = [];
1221
+ const context = { ...this.ctx, cipher: this.cipher };
1222
+ for (const envelope of sortEnvelopesForDecryption(envelopes)) {
1223
+ try {
1224
+ const processed = await RelaySubscriptionOps.processRelayMessage(context, {
1225
+ ...envelope,
1226
+ targetUserId: this.userId,
1227
+ targetDeviceId: this.deviceId,
1228
+ deliveryClass: 'user-visible',
1229
+ messageType: (envelope.messageType ?? 'ciphertext'),
1230
+ }, this.relaySubscriptionState, this.relaySubscriptionCallbacks, { ...this.relaySubscriptionConfig, acknowledgeFailures: false });
1231
+ (processed ? processedMessageIds : failedMessageIds).push(envelope.id);
1232
+ }
1233
+ catch {
1234
+ failedMessageIds.push(envelope.id);
1235
+ }
1236
+ }
1237
+ return { processedMessageIds, failedMessageIds };
1238
+ }
1176
1239
  /**
1177
1240
  * Internal: Send SESAME retry request for failed decryption.
1178
1241
  *
@@ -1306,7 +1369,7 @@ export class SignalProtocolClient {
1306
1369
  }
1307
1370
  async downloadAttachment(attachment, options) {
1308
1371
  if (!this.remoteObjectStore) {
1309
- throw new EncryptionError('Remote object storage not configured. Provide remoteObjectStore in SignalProtocolClient.create() config.', EncryptionErrorCode.INITIALIZATION_FAILED);
1372
+ throw new EncryptionError('Remote object storage not configured. Provide remoteObjectStore in DefaultSignalProtocolClient.create() config.', EncryptionErrorCode.INITIALIZATION_FAILED);
1310
1373
  }
1311
1374
  return resolveMediaAttachment(attachment, {
1312
1375
  remoteObjectStore: this.remoteObjectStore,
@@ -1321,7 +1384,7 @@ export class SignalProtocolClient {
1321
1384
  }
1322
1385
  async deleteRemoteAttachment(attachment, options) {
1323
1386
  if (!this.remoteObjectStore) {
1324
- throw new EncryptionError('Remote object storage not configured. Provide remoteObjectStore in SignalProtocolClient.create() config.', EncryptionErrorCode.INITIALIZATION_FAILED);
1387
+ throw new EncryptionError('Remote object storage not configured. Provide remoteObjectStore in DefaultSignalProtocolClient.create() config.', EncryptionErrorCode.INITIALIZATION_FAILED);
1325
1388
  }
1326
1389
  await deleteMediaAttachment(attachment, {
1327
1390
  remoteObjectStore: this.remoteObjectStore,
@@ -1407,7 +1470,7 @@ export class SignalProtocolClient {
1407
1470
  * Register a hook callback after construction
1408
1471
  *
1409
1472
  * Enables dependency injection patterns where callers register hooks
1410
- * after the SignalProtocolClient exists. ServicesProvider uses this
1473
+ * after the DefaultSignalProtocolClient exists. ServicesProvider uses this
1411
1474
  * to wire up ContentManager's decryption hook.
1412
1475
  *
1413
1476
  * @param name - The hook name to register
@@ -1416,14 +1479,14 @@ export class SignalProtocolClient {
1416
1479
  * @example
1417
1480
  * ```typescript
1418
1481
  * // In ServicesProvider: wire up ContentManager after creation
1419
- * const signal = await SignalProtocolClient.create(userId, { storage, relay });
1482
+ * const signal = await DefaultSignalProtocolClient.create(userId, { storage, relay });
1420
1483
  * const content = new ContentManager({ db, signal });
1421
1484
  *
1422
1485
  * signal.registerHook('onMessageDecrypted', content.getDecryptionHook());
1423
1486
  * signal.startRelaySubscription(); // Now safe to start
1424
1487
  * ```
1425
1488
  *
1426
- * @see ISignalProtocolClient.registerHook
1489
+ * @see SignalProtocolClient.registerHook
1427
1490
  */
1428
1491
  registerHook(name, callback) {
1429
1492
  this.hooks[name] = callback;
@@ -1438,7 +1501,7 @@ export class SignalProtocolClient {
1438
1501
  /**
1439
1502
  * Start relay subscription for automatic message decryption
1440
1503
  *
1441
- * When configured with both `relay` and `onMessageDecrypted` hook, SignalProtocolClient will:
1504
+ * When configured with both `relay` and `onMessageDecrypted` hook, DefaultSignalProtocolClient will:
1442
1505
  * 1. Subscribe to incoming envelopes from the relay
1443
1506
  * 2. Decrypt messages appropriately (pairwise vs group/sender key)
1444
1507
  * 3. Call onMessageDecrypted hook with DecryptedEnvelope (for ContentManager storage)
@@ -1450,7 +1513,7 @@ export class SignalProtocolClient {
1450
1513
  * Callers can run this manually after registering hooks via registerHook().
1451
1514
  * Called automatically by create() when relay + hook configured.
1452
1515
  *
1453
- * @see ISignalProtocolClient.startRelaySubscription
1516
+ * @see SignalProtocolClient.startRelaySubscription
1454
1517
  */
1455
1518
  startRelaySubscription() {
1456
1519
  if (!this.relay) {
@@ -1493,12 +1556,12 @@ export class SignalProtocolClient {
1493
1556
  * Stop the relay subscription
1494
1557
  *
1495
1558
  * Pauses message processing via the relay subscription without destroying
1496
- * SignalProtocolClient state. startRelaySubscription() restarts the subscription.
1559
+ * DefaultSignalProtocolClient state. startRelaySubscription() restarts the subscription.
1497
1560
  *
1498
1561
  * Use this when the app backgrounds to let the background task handle messages.
1499
1562
  * Resume when the app foregrounds for real-time message delivery.
1500
1563
  *
1501
- * @see ISignalProtocolClient.stopRelaySubscription
1564
+ * @see SignalProtocolClient.stopRelaySubscription
1502
1565
  */
1503
1566
  stopRelaySubscription() {
1504
1567
  // Flush any pending batched delivery receipts before unsubscribing
@@ -1792,7 +1855,7 @@ export class SignalProtocolClient {
1792
1855
  }
1793
1856
  // 5. Clear internal tracking state via state manager
1794
1857
  this.state.clearForStop();
1795
- this.logger.debug('SignalProtocolClient stopped', {
1858
+ this.logger.debug('DefaultSignalProtocolClient stopped', {
1796
1859
  category: 'E2EE',
1797
1860
  data: { userId: this.userId, deviceId: this.deviceId },
1798
1861
  });
@@ -2299,77 +2362,77 @@ export class SignalProtocolClient {
2299
2362
  * Create a new group.
2300
2363
  */
2301
2364
  async createGroup(creatorAci, creatorProfileKey, members, title, options) {
2302
- return GroupOps.createGroup(this.ctx, this.groups, creatorAci, creatorProfileKey, members, title, options);
2365
+ return GroupOps.createGroup(this.ctx, await this.groups, creatorAci, creatorProfileKey, members, title, options);
2303
2366
  }
2304
2367
  /**
2305
2368
  * Get decrypted group state (from cache or server).
2306
2369
  */
2307
2370
  async getGroupState(groupId) {
2308
- return GroupOps.getGroupState(this.ctx, this.groups, groupId);
2371
+ return GroupOps.getGroupState(this.ctx, await this.groups, groupId);
2309
2372
  }
2310
2373
  /**
2311
2374
  * Sync group state from server.
2312
2375
  */
2313
2376
  async syncGroup(groupId) {
2314
- return GroupOps.syncGroup(this.ctx, this.groups, groupId);
2377
+ return GroupOps.syncGroup(this.ctx, await this.groups, groupId);
2315
2378
  }
2316
2379
  /**
2317
2380
  * Add a member to a group.
2318
2381
  */
2319
2382
  async addGroupMember(groupId, editorAci, member) {
2320
- return GroupOps.addGroupMember(this.ctx, this.groups, groupId, editorAci, member);
2383
+ return GroupOps.addGroupMember(this.ctx, await this.groups, groupId, editorAci, member);
2321
2384
  }
2322
2385
  /** Accept this client's pending profile-key invitation. */
2323
2386
  async acceptGroupMemberInvitation(groupId) {
2324
- return GroupOps.acceptGroupMemberInvitation(this.ctx, this.groups, groupId);
2387
+ return GroupOps.acceptGroupMemberInvitation(this.ctx, await this.groups, groupId);
2325
2388
  }
2326
2389
  /**
2327
2390
  * Decline this account's ACI- or PNI-keyed pending invitation.
2328
2391
  */
2329
2392
  async declineGroupMemberInvitation(groupId, identity = 'aci') {
2330
- return GroupOps.declineGroupMemberInvitation(this.ctx, this.groups, groupId, identity);
2393
+ return GroupOps.declineGroupMemberInvitation(this.ctx, await this.groups, groupId, identity);
2331
2394
  }
2332
2395
  /**
2333
2396
  * Remove a member from a group. Triggers sender key rotation.
2334
2397
  */
2335
2398
  async removeGroupMember(groupId, editorAci, targetAci) {
2336
- return GroupOps.removeGroupMember(this.ctx, this.groups, groupId, editorAci, targetAci);
2399
+ return GroupOps.removeGroupMember(this.ctx, await this.groups, groupId, editorAci, targetAci);
2337
2400
  }
2338
2401
  /**
2339
2402
  * Leave a group.
2340
2403
  */
2341
2404
  async leaveGroup(groupId, userAci) {
2342
- return GroupOps.leaveGroup(this.ctx, this.groups, groupId, userAci);
2405
+ return GroupOps.leaveGroup(this.ctx, await this.groups, groupId, userAci);
2343
2406
  }
2344
2407
  /**
2345
2408
  * Update a group's title.
2346
2409
  */
2347
2410
  async updateGroupTitle(groupId, editorAci, title) {
2348
- return GroupOps.updateGroupTitle(this.ctx, this.groups, groupId, editorAci, title);
2411
+ return GroupOps.updateGroupTitle(this.ctx, await this.groups, groupId, editorAci, title);
2349
2412
  }
2350
2413
  /**
2351
2414
  * Update a group's description.
2352
2415
  */
2353
2416
  async updateGroupDescription(groupId, editorAci, description) {
2354
- return GroupOps.updateGroupDescription(this.ctx, this.groups, groupId, editorAci, description);
2417
+ return GroupOps.updateGroupDescription(this.ctx, await this.groups, groupId, editorAci, description);
2355
2418
  }
2356
2419
  /**
2357
2420
  * Update a group's access control.
2358
2421
  */
2359
2422
  async updateGroupAccessControl(groupId, editorAci, updates) {
2360
- return GroupOps.updateGroupAccessControl(this.ctx, this.groups, groupId, editorAci, updates);
2423
+ return GroupOps.updateGroupAccessControl(this.ctx, await this.groups, groupId, editorAci, updates);
2361
2424
  }
2362
2425
  /**
2363
2426
  * Create an invite link for a group.
2364
2427
  */
2365
2428
  async createGroupInviteLink(groupId, editorAci) {
2366
- return GroupOps.createGroupInviteLink(this.ctx, this.groups, groupId, editorAci);
2429
+ return GroupOps.createGroupInviteLink(this.ctx, await this.groups, groupId, editorAci);
2367
2430
  }
2368
2431
  /**
2369
2432
  * Join a group via invite link.
2370
2433
  */
2371
2434
  async joinGroupViaInviteLink(url, userAci, userProfileKey) {
2372
- return GroupOps.joinGroupViaInviteLink(this.ctx, this.groups, url, userAci, userProfileKey);
2435
+ return GroupOps.joinGroupViaInviteLink(this.ctx, await this.groups, url, userAci, userProfileKey);
2373
2436
  }
2374
2437
  // ============================================================================
2375
2438
  // PRIVATE METHODS