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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (387) hide show
  1. package/ADAPTERS.md +13 -31
  2. package/ARCHITECTURE.md +5 -7
  3. package/CHANGELOG.md +258 -0
  4. package/README.md +36 -48
  5. package/SECURITY.md +2 -2
  6. package/client/README.md +9 -0
  7. package/device/README.md +16 -7
  8. package/dist/client/client.d.ts +25 -16
  9. package/dist/client/client.d.ts.map +1 -1
  10. package/dist/client/client.js +115 -95
  11. package/dist/client/client.js.map +1 -1
  12. package/dist/client/config.d.ts +10 -17
  13. package/dist/client/config.d.ts.map +1 -1
  14. package/dist/client/config.js.map +1 -1
  15. package/dist/client/event-hooks.js +27 -0
  16. package/dist/client/event-hooks.js.map +1 -1
  17. package/dist/client/group-outbox.d.ts +31 -1
  18. package/dist/client/group-outbox.d.ts.map +1 -1
  19. package/dist/client/group-outbox.js +67 -58
  20. package/dist/client/group-outbox.js.map +1 -1
  21. package/dist/client/group-receive-authorization.d.ts +5 -0
  22. package/dist/client/group-receive-authorization.d.ts.map +1 -0
  23. package/dist/client/group-receive-authorization.js +32 -0
  24. package/dist/client/group-receive-authorization.js.map +1 -0
  25. package/dist/client/group-sender-key-operations.d.ts +15 -0
  26. package/dist/client/group-sender-key-operations.d.ts.map +1 -0
  27. package/dist/client/group-sender-key-operations.js +31 -0
  28. package/dist/client/group-sender-key-operations.js.map +1 -0
  29. package/dist/client/groups.d.ts +3 -1
  30. package/dist/client/groups.d.ts.map +1 -1
  31. package/dist/client/groups.js +5 -2
  32. package/dist/client/groups.js.map +1 -1
  33. package/dist/client/hosted-anonymous-delivery.d.ts +9 -1
  34. package/dist/client/hosted-anonymous-delivery.d.ts.map +1 -1
  35. package/dist/client/hosted-anonymous-delivery.js +61 -22
  36. package/dist/client/hosted-anonymous-delivery.js.map +1 -1
  37. package/dist/client/hosted-transport.d.ts +7 -0
  38. package/dist/client/hosted-transport.d.ts.map +1 -1
  39. package/dist/client/hosted-transport.js +44 -6
  40. package/dist/client/hosted-transport.js.map +1 -1
  41. package/dist/client/key-rotation.d.ts.map +1 -1
  42. package/dist/client/key-rotation.js +2 -4
  43. package/dist/client/key-rotation.js.map +1 -1
  44. package/dist/client/prekeys.d.ts.map +1 -1
  45. package/dist/client/prekeys.js +1 -1
  46. package/dist/client/prekeys.js.map +1 -1
  47. package/dist/client/relay-device-refusal.d.ts +32 -0
  48. package/dist/client/relay-device-refusal.d.ts.map +1 -0
  49. package/dist/client/relay-device-refusal.js +36 -0
  50. package/dist/client/relay-device-refusal.js.map +1 -0
  51. package/dist/client/relay-subscription.d.ts +2 -0
  52. package/dist/client/relay-subscription.d.ts.map +1 -1
  53. package/dist/client/relay-subscription.js +3 -1
  54. package/dist/client/relay-subscription.js.map +1 -1
  55. package/dist/client/relay-work.d.ts +26 -0
  56. package/dist/client/relay-work.d.ts.map +1 -1
  57. package/dist/client/relay-work.js +37 -0
  58. package/dist/client/relay-work.js.map +1 -1
  59. package/dist/client/sealed-sender.d.ts.map +1 -1
  60. package/dist/client/sealed-sender.js +12 -17
  61. package/dist/client/sealed-sender.js.map +1 -1
  62. package/dist/client/sender-key-distribution.d.ts.map +1 -1
  63. package/dist/client/sender-key-distribution.js +4 -1
  64. package/dist/client/sender-key-distribution.js.map +1 -1
  65. package/dist/client/sessions.d.ts.map +1 -1
  66. package/dist/client/sessions.js +2 -4
  67. package/dist/client/sessions.js.map +1 -1
  68. package/dist/client/signal-service-cipher.d.ts +94 -6
  69. package/dist/client/signal-service-cipher.d.ts.map +1 -1
  70. package/dist/client/signal-service-cipher.js +483 -184
  71. package/dist/client/signal-service-cipher.js.map +1 -1
  72. package/dist/client/types.d.ts +7 -0
  73. package/dist/client/types.d.ts.map +1 -1
  74. package/dist/client/types.js.map +1 -1
  75. package/dist/index.d.ts +27 -21
  76. package/dist/index.d.ts.map +1 -1
  77. package/dist/index.js +8 -17
  78. package/dist/index.js.map +1 -1
  79. package/dist/internal/crypto/pq/kyber.d.ts +1 -1
  80. package/dist/internal/crypto/pq/kyber.js +1 -1
  81. package/dist/internal/encoding/proto/sender-key-message.d.ts +2 -2
  82. package/dist/internal/encoding/proto/sender-key-message.d.ts.map +1 -1
  83. package/dist/internal/encoding/proto/sender-key-message.js +5 -2
  84. package/dist/internal/encoding/proto/sender-key-message.js.map +1 -1
  85. package/dist/internal/groups/manager.d.ts.map +1 -1
  86. package/dist/internal/groups/manager.js +5 -2
  87. package/dist/internal/groups/manager.js.map +1 -1
  88. package/dist/internal/groups/wire.d.ts +0 -2
  89. package/dist/internal/groups/wire.d.ts.map +1 -1
  90. package/dist/internal/groups/wire.js +0 -6
  91. package/dist/internal/groups/wire.js.map +1 -1
  92. package/dist/internal/manager/manager.d.ts +8 -7
  93. package/dist/internal/manager/manager.d.ts.map +1 -1
  94. package/dist/internal/manager/manager.js +34 -37
  95. package/dist/internal/manager/manager.js.map +1 -1
  96. package/dist/internal/protocol/double-ratchet/ratchet.d.ts +0 -17
  97. package/dist/internal/protocol/double-ratchet/ratchet.d.ts.map +1 -1
  98. package/dist/internal/protocol/double-ratchet/ratchet.js +0 -4
  99. package/dist/internal/protocol/double-ratchet/ratchet.js.map +1 -1
  100. package/dist/internal/protocol/sealed-sender/certificate.d.ts +2 -32
  101. package/dist/internal/protocol/sealed-sender/certificate.d.ts.map +1 -1
  102. package/dist/internal/protocol/sealed-sender/certificate.js +4 -85
  103. package/dist/internal/protocol/sealed-sender/certificate.js.map +1 -1
  104. package/dist/internal/protocol/sealed-sender/index.d.ts +2 -2
  105. package/dist/internal/protocol/sealed-sender/index.d.ts.map +1 -1
  106. package/dist/internal/protocol/sealed-sender/index.js +2 -6
  107. package/dist/internal/protocol/sealed-sender/index.js.map +1 -1
  108. package/dist/internal/protocol/sealed-sender/proto/index.d.ts +0 -19
  109. package/dist/internal/protocol/sealed-sender/proto/index.d.ts.map +1 -1
  110. package/dist/internal/protocol/sealed-sender/proto/index.js +1 -48
  111. package/dist/internal/protocol/sealed-sender/proto/index.js.map +1 -1
  112. package/dist/internal/protocol/sender-keys/manager.d.ts +9 -13
  113. package/dist/internal/protocol/sender-keys/manager.d.ts.map +1 -1
  114. package/dist/internal/protocol/sender-keys/manager.js +90 -95
  115. package/dist/internal/protocol/sender-keys/manager.js.map +1 -1
  116. package/dist/internal/protocol/spqr/index.d.ts +1 -1
  117. package/dist/internal/protocol/spqr/index.d.ts.map +1 -1
  118. package/dist/internal/protocol/spqr/index.js +2 -2
  119. package/dist/internal/protocol/spqr/index.js.map +1 -1
  120. package/dist/internal/protocol/spqr/ml-kem-braid/incremental-kem.d.ts +0 -2
  121. package/dist/internal/protocol/spqr/ml-kem-braid/incremental-kem.d.ts.map +1 -1
  122. package/dist/internal/protocol/spqr/ml-kem-braid/incremental-kem.js +4 -12
  123. package/dist/internal/protocol/spqr/ml-kem-braid/incremental-kem.js.map +1 -1
  124. package/dist/internal/protocol/spqr/ml-kem-braid/rs/codec.d.ts.map +1 -1
  125. package/dist/internal/protocol/spqr/ml-kem-braid/rs/codec.js +1 -3
  126. package/dist/internal/protocol/spqr/ml-kem-braid/rs/codec.js.map +1 -1
  127. package/dist/internal/protocol/spqr/ml-kem-braid/types.d.ts +1 -0
  128. package/dist/internal/protocol/spqr/ml-kem-braid/types.d.ts.map +1 -1
  129. package/dist/internal/protocol/spqr/serialize.d.ts.map +1 -1
  130. package/dist/internal/protocol/spqr/serialize.js +1 -4
  131. package/dist/internal/protocol/spqr/serialize.js.map +1 -1
  132. package/dist/internal/protocol/spqr/spqr.d.ts +1 -1
  133. package/dist/internal/protocol/spqr/spqr.d.ts.map +1 -1
  134. package/dist/internal/protocol/spqr/spqr.js +2 -3
  135. package/dist/internal/protocol/spqr/spqr.js.map +1 -1
  136. package/dist/internal/protocol/x3dh/x3dh.d.ts.map +1 -1
  137. package/dist/internal/protocol/x3dh/x3dh.js +1 -1
  138. package/dist/internal/protocol/x3dh/x3dh.js.map +1 -1
  139. package/dist/internal/protocol/zk/credentials/credentials.d.ts +3 -54
  140. package/dist/internal/protocol/zk/credentials/credentials.d.ts.map +1 -1
  141. package/dist/internal/protocol/zk/credentials/credentials.js +4 -91
  142. package/dist/internal/protocol/zk/credentials/credentials.js.map +1 -1
  143. package/dist/internal/protocol/zk/credentials/endorsements.d.ts +3 -64
  144. package/dist/internal/protocol/zk/credentials/endorsements.d.ts.map +1 -1
  145. package/dist/internal/protocol/zk/credentials/endorsements.js +4 -134
  146. package/dist/internal/protocol/zk/credentials/endorsements.js.map +1 -1
  147. package/dist/internal/protocol/zk/credentials/index.d.ts +3 -3
  148. package/dist/internal/protocol/zk/credentials/index.d.ts.map +1 -1
  149. package/dist/internal/protocol/zk/credentials/index.js +3 -3
  150. package/dist/internal/protocol/zk/credentials/index.js.map +1 -1
  151. package/dist/internal/protocol/zk/credentials/issuance.d.ts +3 -26
  152. package/dist/internal/protocol/zk/credentials/issuance.d.ts.map +1 -1
  153. package/dist/internal/protocol/zk/credentials/issuance.js +3 -80
  154. package/dist/internal/protocol/zk/credentials/issuance.js.map +1 -1
  155. package/dist/internal/protocol/zk/credentials/presentation.d.ts +4 -73
  156. package/dist/internal/protocol/zk/credentials/presentation.d.ts.map +1 -1
  157. package/dist/internal/protocol/zk/credentials/presentation.js +4 -152
  158. package/dist/internal/protocol/zk/credentials/presentation.js.map +1 -1
  159. package/dist/internal/protocol/zk/groups/auth-credential.d.ts +1 -61
  160. package/dist/internal/protocol/zk/groups/auth-credential.d.ts.map +1 -1
  161. package/dist/internal/protocol/zk/groups/auth-credential.js +2 -196
  162. package/dist/internal/protocol/zk/groups/auth-credential.js.map +1 -1
  163. package/dist/internal/protocol/zk/groups/group-send-endorsement.d.ts +1 -86
  164. package/dist/internal/protocol/zk/groups/group-send-endorsement.d.ts.map +1 -1
  165. package/dist/internal/protocol/zk/groups/group-send-endorsement.js +1 -152
  166. package/dist/internal/protocol/zk/groups/group-send-endorsement.js.map +1 -1
  167. package/dist/internal/protocol/zk/groups/index.d.ts +4 -4
  168. package/dist/internal/protocol/zk/groups/index.d.ts.map +1 -1
  169. package/dist/internal/protocol/zk/groups/index.js +4 -4
  170. package/dist/internal/protocol/zk/groups/index.js.map +1 -1
  171. package/dist/internal/protocol/zk/groups/profile-key-credential.d.ts +2 -57
  172. package/dist/internal/protocol/zk/groups/profile-key-credential.d.ts.map +1 -1
  173. package/dist/internal/protocol/zk/groups/profile-key-credential.js +2 -174
  174. package/dist/internal/protocol/zk/groups/profile-key-credential.js.map +1 -1
  175. package/dist/internal/protocol/zk/groups/server-params.d.ts +8 -72
  176. package/dist/internal/protocol/zk/groups/server-params.d.ts.map +1 -1
  177. package/dist/internal/protocol/zk/groups/server-params.js +8 -108
  178. package/dist/internal/protocol/zk/groups/server-params.js.map +1 -1
  179. package/dist/internal/protocol/zk/proofs/sign.d.ts +1 -2
  180. package/dist/internal/protocol/zk/proofs/sign.d.ts.map +1 -1
  181. package/dist/internal/protocol/zk/proofs/sign.js +2 -11
  182. package/dist/internal/protocol/zk/proofs/sign.js.map +1 -1
  183. package/dist/internal/sesame/device-registry.d.ts +24 -4
  184. package/dist/internal/sesame/device-registry.d.ts.map +1 -1
  185. package/dist/internal/sesame/device-registry.js +55 -28
  186. package/dist/internal/sesame/device-registry.js.map +1 -1
  187. package/dist/internal/sesame/manager.d.ts +79 -11
  188. package/dist/internal/sesame/manager.d.ts.map +1 -1
  189. package/dist/internal/sesame/manager.js +381 -280
  190. package/dist/internal/sesame/manager.js.map +1 -1
  191. package/dist/internal/session/cipher.d.ts +0 -5
  192. package/dist/internal/session/cipher.d.ts.map +1 -1
  193. package/dist/internal/session/cipher.js +3 -9
  194. package/dist/internal/session/cipher.js.map +1 -1
  195. package/dist/internal/session/ratchet.d.ts.map +1 -1
  196. package/dist/internal/session/ratchet.js +0 -2
  197. package/dist/internal/session/ratchet.js.map +1 -1
  198. package/dist/internal/session/record-locks.d.ts +46 -0
  199. package/dist/internal/session/record-locks.d.ts.map +1 -0
  200. package/dist/internal/session/record-locks.js +72 -0
  201. package/dist/internal/session/record-locks.js.map +1 -0
  202. package/dist/local/store/expo/adapter.d.ts +8 -2
  203. package/dist/local/store/expo/adapter.d.ts.map +1 -1
  204. package/dist/local/store/expo/adapter.js +24 -3
  205. package/dist/local/store/expo/adapter.js.map +1 -1
  206. package/dist/local/store/expo/driver.d.ts +7 -0
  207. package/dist/local/store/expo/driver.d.ts.map +1 -1
  208. package/dist/local/store/expo/driver.js +16 -0
  209. package/dist/local/store/expo/driver.js.map +1 -1
  210. package/dist/local/store/key-value/adapter.d.ts +3 -3
  211. package/dist/local/store/key-value/adapter.d.ts.map +1 -1
  212. package/dist/local/store/key-value/adapter.js +91 -53
  213. package/dist/local/store/key-value/adapter.js.map +1 -1
  214. package/dist/local/store/key-value/backend-conformance.d.ts.map +1 -1
  215. package/dist/local/store/key-value/backend-conformance.js +25 -0
  216. package/dist/local/store/key-value/backend-conformance.js.map +1 -1
  217. package/dist/local/store/key-value/batch.d.ts +3 -1
  218. package/dist/local/store/key-value/batch.d.ts.map +1 -1
  219. package/dist/local/store/key-value/batch.js +9 -1
  220. package/dist/local/store/key-value/batch.js.map +1 -1
  221. package/dist/local/store/key-value/storage.d.ts +6 -0
  222. package/dist/local/store/key-value/storage.d.ts.map +1 -1
  223. package/dist/local/store/key-value/transactional-backend.d.ts +1 -1
  224. package/dist/local/store/key-value/transactional-backend.js +1 -1
  225. package/dist/local/store/memory/adapter.d.ts +13 -3
  226. package/dist/local/store/memory/adapter.d.ts.map +1 -1
  227. package/dist/local/store/memory/adapter.js +122 -73
  228. package/dist/local/store/memory/adapter.js.map +1 -1
  229. package/dist/local/store/reliability.d.ts +16 -0
  230. package/dist/local/store/reliability.d.ts.map +1 -1
  231. package/dist/local/store/reliability.js +58 -28
  232. package/dist/local/store/reliability.js.map +1 -1
  233. package/dist/local/store/sqlite/migrations.d.ts.map +1 -1
  234. package/dist/local/store/sqlite/migrations.js +18 -0
  235. package/dist/local/store/sqlite/migrations.js.map +1 -1
  236. package/dist/local/store/sqlite/models/skipped-sender-key.d.ts +3 -3
  237. package/dist/local/store/sqlite/models/skipped-sender-key.d.ts.map +1 -1
  238. package/dist/local/store/sqlite/models/skipped-sender-key.js +13 -17
  239. package/dist/local/store/sqlite/models/skipped-sender-key.js.map +1 -1
  240. package/dist/local/store/sqlite/store.d.ts +3 -3
  241. package/dist/local/store/sqlite/store.d.ts.map +1 -1
  242. package/dist/local/store/sqlite/store.js +53 -23
  243. package/dist/local/store/sqlite/store.js.map +1 -1
  244. package/dist/local/store/web/adapter.d.ts +3 -3
  245. package/dist/local/store/web/adapter.d.ts.map +1 -1
  246. package/dist/local/store/web/adapter.js +122 -73
  247. package/dist/local/store/web/adapter.js.map +1 -1
  248. package/dist/local/vault/electron-safe-storage.d.ts.map +1 -1
  249. package/dist/local/vault/electron-safe-storage.js +15 -2
  250. package/dist/local/vault/electron-safe-storage.js.map +1 -1
  251. package/dist/profile/index.d.ts +2 -1
  252. package/dist/profile/index.d.ts.map +1 -1
  253. package/dist/profile/index.js +2 -1
  254. package/dist/profile/index.js.map +1 -1
  255. package/dist/profile/own-profile-key.d.ts +42 -0
  256. package/dist/profile/own-profile-key.d.ts.map +1 -0
  257. package/dist/profile/own-profile-key.js +64 -0
  258. package/dist/profile/own-profile-key.js.map +1 -0
  259. package/dist/profile/profile-key.d.ts +1 -34
  260. package/dist/profile/profile-key.d.ts.map +1 -1
  261. package/dist/profile/profile-key.js +3 -63
  262. package/dist/profile/profile-key.js.map +1 -1
  263. package/dist/profile/update-service.js +1 -1
  264. package/dist/profile/update-service.js.map +1 -1
  265. package/dist/remote/relay/index.d.ts +4 -7
  266. package/dist/remote/relay/index.d.ts.map +1 -1
  267. package/dist/remote/relay/index.js +5 -7
  268. package/dist/remote/relay/index.js.map +1 -1
  269. package/dist/remote/relay/types.d.ts +3 -3
  270. package/dist/types/api.d.ts +29 -8
  271. package/dist/types/api.d.ts.map +1 -1
  272. package/dist/username/link.d.ts.map +1 -1
  273. package/dist/username/link.js +1 -5
  274. package/dist/username/link.js.map +1 -1
  275. package/dist/utils/bounded-fan-out.d.ts +99 -0
  276. package/dist/utils/bounded-fan-out.d.ts.map +1 -0
  277. package/dist/utils/bounded-fan-out.js +180 -0
  278. package/dist/utils/bounded-fan-out.js.map +1 -0
  279. package/dist/utils/keyed-lock.d.ts +16 -0
  280. package/dist/utils/keyed-lock.d.ts.map +1 -0
  281. package/dist/utils/keyed-lock.js +39 -0
  282. package/dist/utils/keyed-lock.js.map +1 -0
  283. package/dist/versions.d.ts +3 -3
  284. package/dist/versions.js +3 -3
  285. package/dist/zk/credentials.d.ts +2 -2
  286. package/dist/zk/credentials.js +2 -2
  287. package/dist/zk/groups.d.ts +3 -3
  288. package/dist/zk/groups.d.ts.map +1 -1
  289. package/dist/zk/groups.js +3 -3
  290. package/dist/zk/groups.js.map +1 -1
  291. package/docs/ASSURANCE.md +69 -28
  292. package/docs/CLIENT_COMPOSITION.md +9 -3
  293. package/docs/DEVIATIONS.md +45 -27
  294. package/docs/GETTING_STARTED.md +42 -320
  295. package/docs/INTERFACES.md +7 -7
  296. package/docs/PACKAGE_SURFACE.md +14 -16
  297. package/docs/RECIPES.md +6 -112
  298. package/groups/README.md +9 -1
  299. package/hooks/README.md +11 -2
  300. package/local/store/README.md +26 -6
  301. package/local/store/expo/README.md +18 -5
  302. package/local/store/key-value/README.md +5 -3
  303. package/local/store/node/README.md +2 -1
  304. package/local/store/web-sqlite/README.md +28 -8
  305. package/local/vault/README.md +21 -2
  306. package/package.json +1 -30
  307. package/remote/README.md +12 -78
  308. package/remote/object-store/convex-r2/README.md +20 -42
  309. package/remote/relay/README.md +21 -18
  310. package/zk/README.md +6 -7
  311. package/dist/client/dual-store.d.ts +0 -70
  312. package/dist/client/dual-store.d.ts.map +0 -1
  313. package/dist/client/dual-store.js +0 -123
  314. package/dist/client/dual-store.js.map +0 -1
  315. package/dist/client/multi-device.d.ts +0 -74
  316. package/dist/client/multi-device.d.ts.map +0 -1
  317. package/dist/client/multi-device.js +0 -105
  318. package/dist/client/multi-device.js.map +0 -1
  319. package/dist/groups/server.d.ts +0 -10
  320. package/dist/groups/server.d.ts.map +0 -1
  321. package/dist/groups/server.js +0 -6
  322. package/dist/groups/server.js.map +0 -1
  323. package/dist/internal/encoding/index.d.ts +0 -2
  324. package/dist/internal/encoding/index.d.ts.map +0 -1
  325. package/dist/internal/encoding/index.js +0 -2
  326. package/dist/internal/encoding/index.js.map +0 -1
  327. package/dist/internal/groups/server-engine.d.ts +0 -118
  328. package/dist/internal/groups/server-engine.d.ts.map +0 -1
  329. package/dist/internal/groups/server-engine.js +0 -1268
  330. package/dist/internal/groups/server-engine.js.map +0 -1
  331. package/dist/internal/protocol/index.d.ts +0 -24
  332. package/dist/internal/protocol/index.d.ts.map +0 -1
  333. package/dist/internal/protocol/index.js +0 -9
  334. package/dist/internal/protocol/index.js.map +0 -1
  335. package/dist/internal/protocol/sealed-sender/trust-root.d.ts +0 -56
  336. package/dist/internal/protocol/sealed-sender/trust-root.d.ts.map +0 -1
  337. package/dist/internal/protocol/sealed-sender/trust-root.js +0 -90
  338. package/dist/internal/protocol/sealed-sender/trust-root.js.map +0 -1
  339. package/dist/internal/protocol/triple-ratchet/index.d.ts +0 -21
  340. package/dist/internal/protocol/triple-ratchet/index.d.ts.map +0 -1
  341. package/dist/internal/protocol/triple-ratchet/index.js +0 -19
  342. package/dist/internal/protocol/triple-ratchet/index.js.map +0 -1
  343. package/dist/internal/protocol/triple-ratchet/ratchet.d.ts +0 -233
  344. package/dist/internal/protocol/triple-ratchet/ratchet.d.ts.map +0 -1
  345. package/dist/internal/protocol/triple-ratchet/ratchet.js +0 -254
  346. package/dist/internal/protocol/triple-ratchet/ratchet.js.map +0 -1
  347. package/dist/internal/protocol/zk/proofs/index.d.ts +0 -13
  348. package/dist/internal/protocol/zk/proofs/index.d.ts.map +0 -1
  349. package/dist/internal/protocol/zk/proofs/index.js +0 -7
  350. package/dist/internal/protocol/zk/proofs/index.js.map +0 -1
  351. package/dist/local/store/sqlite/index.d.ts +0 -20
  352. package/dist/local/store/sqlite/index.d.ts.map +0 -1
  353. package/dist/local/store/sqlite/index.js +0 -18
  354. package/dist/local/store/sqlite/index.js.map +0 -1
  355. package/dist/remote/object-store/convex-r2/server/index.d.ts +0 -2
  356. package/dist/remote/object-store/convex-r2/server/index.d.ts.map +0 -1
  357. package/dist/remote/object-store/convex-r2/server/index.js +0 -2
  358. package/dist/remote/object-store/convex-r2/server/index.js.map +0 -1
  359. package/dist/remote/object-store/convex-r2/server.d.ts +0 -129
  360. package/dist/remote/object-store/convex-r2/server.d.ts.map +0 -1
  361. package/dist/remote/object-store/convex-r2/server.js +0 -244
  362. package/dist/remote/object-store/convex-r2/server.js.map +0 -1
  363. package/dist/remote/relay/memory/adapter.d.ts +0 -252
  364. package/dist/remote/relay/memory/adapter.d.ts.map +0 -1
  365. package/dist/remote/relay/memory/adapter.js +0 -1058
  366. package/dist/remote/relay/memory/adapter.js.map +0 -1
  367. package/dist/remote/relay/memory/failures.d.ts +0 -58
  368. package/dist/remote/relay/memory/failures.d.ts.map +0 -1
  369. package/dist/remote/relay/memory/failures.js +0 -124
  370. package/dist/remote/relay/memory/failures.js.map +0 -1
  371. package/dist/remote/relay/memory/group-server.d.ts +0 -13
  372. package/dist/remote/relay/memory/group-server.d.ts.map +0 -1
  373. package/dist/remote/relay/memory/group-server.js +0 -19
  374. package/dist/remote/relay/memory/group-server.js.map +0 -1
  375. package/dist/remote/relay/memory/index.d.ts +0 -11
  376. package/dist/remote/relay/memory/index.d.ts.map +0 -1
  377. package/dist/remote/relay/memory/index.js +0 -7
  378. package/dist/remote/relay/memory/index.js.map +0 -1
  379. package/examples/browser/README.md +0 -35
  380. package/examples/browser/index.html +0 -27
  381. package/examples/browser/src/exchange.ts +0 -69
  382. package/examples/browser/src/main.ts +0 -63
  383. package/examples/browser/src/style.css +0 -9
  384. package/examples/browser/src/worker.ts +0 -10
  385. package/examples/browser/vite.config.ts +0 -9
  386. package/remote/relay/memory/README.md +0 -72
  387. package/scripts/oe-groups.mjs +0 -166
@@ -11,6 +11,12 @@ operates inside the application backend. This adapter maps that generated API
11
11
  to `SignalProtocolRemoteObjectStore` without moving storage policy, provider keys, or
12
12
  component ownership into the SDK.
13
13
 
14
+ ## Setup
15
+
16
+ The application supplies a Convex client and generated function references.
17
+ The adapter loads no Convex runtime dependency. The application installs and
18
+ mounts the `@convex-dev/r2` component in its own backend.
19
+
14
20
  ## Client usage
15
21
 
16
22
  <!-- doc-snippet:skip requires-external-context -->
@@ -36,52 +42,24 @@ const client = await createSignalProtocolClient({
36
42
  `completeUpload`, and `deleteObject` with the function kinds and values defined
37
43
  by `ConvexR2ObjectStoreApi`.
38
44
 
39
- ## Optional server helper
40
-
41
- The server-only subpath supplies validators and broker mechanics while keeping
42
- authorization and persistence in application callbacks:
43
-
44
- <!-- doc-snippet:skip requires-external-context -->
45
- ```ts
46
- import { R2 } from "@convex-dev/r2";
47
- import {
48
- defineConvexR2ObjectStore,
49
- type ConvexR2ObjectCallbacks,
50
- } from "@open-e2ee/signal-protocol-sdk/remote/object-store/convex-r2/server";
51
- import { components, internal } from "./_generated/api";
52
-
53
- const objects =
54
- internal.signalObjectStoreModel satisfies ConvexR2ObjectCallbacks;
45
+ ## Broker contract
55
46
 
56
- export const {
57
- createUpload,
58
- createDownload,
59
- completeUpload,
60
- deleteObject,
61
- } = defineConvexR2ObjectStore({
62
- r2: new R2(components.r2),
63
- limits: {
64
- maxContentLength: 50 * 1024 * 1024,
65
- allowedContentTypes: ["application/octet-stream"],
66
- downloadExpiresInSeconds: 15 * 60,
67
- },
68
- objects,
69
- });
70
- ```
47
+ The application supplies the four Convex functions. Their types follow
48
+ `ConvexR2ObjectStoreApi`:
71
49
 
72
- The callbacks must authenticate and authorize each operation and persist the
73
- `requestId -> objectId -> providerKey` mapping. The helper derives expiry from
74
- the actual signed operation and synchronizes provider metadata in an action. It
75
- also checks the reserved content type and byte length before completion.
50
+ - `createUpload` is a mutation that reserves an upload for the authenticated caller.
51
+ - `createDownload` is an action that returns a short-lived download operation.
52
+ - `completeUpload` is an action that validates provider metadata before completion.
53
+ - `deleteObject` is a mutation that authorizes and records deletion.
76
54
 
77
- Deletion is asynchronous at the provider boundary. The public mutation
78
- atomically records the application removal and asks the R2 component to schedule
79
- its retried deletion action. Applications that need confirmed physical removal
80
- must track that completion separately.
55
+ The broker owns the `requestId -> objectId -> providerKey` mapping. It scopes
56
+ retry identifiers to the authenticated caller and returns stable object IDs for
57
+ retries. It checks the reserved ciphertext size and content type before marking
58
+ an upload complete. Provider credentials and keys stay on the backend.
81
59
 
82
- The server helper uses structural types and does not import
83
- `@convex-dev/r2` at runtime. Consumers that use only S3 do not load that
84
- component.
60
+ The published SDK supplies the client adapter and its types. The application
61
+ supplies the broker implementation. If the application must confirm physical
62
+ removal, it tracks provider deletion.
85
63
 
86
64
  See the [object-store guide](../README.md) and
87
65
  [remote guide](../../README.md).
@@ -11,31 +11,34 @@ authenticated service to publish public key material and deliver ciphertext.
11
11
  The relay boundary keeps that service replaceable without moving private-key or
12
12
  plaintext ownership to the backend.
13
13
 
14
- ## Local usage
14
+ ## Hosted usage
15
15
 
16
- <!-- doc-snippet:run relay-memory-client expect="" -->
17
- ```ts
18
- // Real protocol and cryptography; simulated in-memory infrastructure.
19
- import { createSignalProtocolClient } from "@open-e2ee/signal-protocol-sdk";
20
- import { inMemoryStore } from "@open-e2ee/signal-protocol-sdk/local/store/memory";
21
- import { inMemoryRelay } from "@open-e2ee/signal-protocol-sdk/remote/relay/memory";
22
-
23
- const relay = inMemoryRelay();
16
+ Use the OpenE2EE Signal Protocol Relay through the hosted client factory:
24
17
 
25
- const client = await createSignalProtocolClient({
26
- identity: { userId: "alice" },
27
- adapters: { storage: inMemoryStore(), relay },
18
+ <!-- doc-snippet:skip requires-external-context -->
19
+ ```ts
20
+ import { createHostedSignalProtocolClient } from "@open-e2ee/signal-protocol-sdk";
21
+
22
+ const signal = await createHostedSignalProtocolClient({
23
+ adapters: { storage },
24
+ hosted: {
25
+ relayUrl,
26
+ getIdentityAssertion,
27
+ },
28
28
  });
29
-
30
- await client.syncToServer();
31
29
  ```
32
30
 
33
- For production, connect to the OpenE2EE Signal Protocol Relay through
34
- `createHostedSignalProtocolClient()` from the package root, or implement
35
- `SignalProtocolRelayServer` against your own backend. That backend must authenticate
31
+ Get `relayUrl` from the OpenE2EE console. Supply `storage` for this device and
32
+ `getIdentityAssertion` for the configured identity provider.
33
+
34
+ For advanced integrations, implement the `SignalProtocolRelayServer` client
35
+ transport against your own backend. That backend must authenticate
36
36
  mutations, allocate linked-device IDs, consume one-time prekeys atomically,
37
37
  enforce access policy, and store only encrypted envelopes plus required routing
38
38
  metadata.
39
39
 
40
+ The published package contains client transports and contracts. It does not
41
+ include a relay server implementation.
42
+
40
43
  See the [remote guide](../README.md), [interface guide](../../docs/INTERFACES.md),
41
- [in-memory relay guide](./memory/README.md), and [API reference](../../docs/api/README.md).
44
+ and [API reference](../../docs/api/README.md).
package/zk/README.md CHANGED
@@ -1,8 +1,7 @@
1
1
  # Zero-Knowledge Credentials and Groups
2
2
 
3
- The `zk` subpaths expose credential issuance, presentation, verification, and
4
- group cryptographic primitives used by privacy-preserving application
5
- features.
3
+ The `zk` subpaths expose client credential requests, response verification,
4
+ presentation creation, and group cryptographic primitives.
6
5
 
7
6
  ## Why it exists
8
7
 
@@ -28,10 +27,10 @@ const profileKeyVersion = computeProfileKeyVersion(
28
27
  );
29
28
  ```
30
29
 
31
- Credential issuers and verifiers must use one agreed parameter set, validate
32
- expiration, and bind presentations to the intended application context. These
33
- low-level APIs do not supply authentication, persistence, replay prevention, or
34
- product authorization policy.
30
+ Clients use trusted public parameters to verify credential responses and create
31
+ presentations. Credential issuance and server-side presentation checks belong
32
+ to the relay. The published package excludes server secret-key generation,
33
+ credential issuance, and server signing implementations.
35
34
 
36
35
  See the [groups guide](../groups/README.md), [protocol policy](../docs/PROTOCOL_POLICY.md),
37
36
  and [API reference](../docs/api/README.md).
@@ -1,70 +0,0 @@
1
- /**
2
- * Dual Protocol Store: ACI/PNI Identity Router
3
- *
4
- * Thin wrapper providing .aci() and .pni() views over KeyStorage,
5
- * each pre-filling identityType for all operations.
6
- *
7
- */
8
- import type { IdentityType, IdentityKeyPair, EcSignedPreKey, EcOneTimePreKey, KyberPreKey, KemOneTimePreKey } from '../keys/types.js';
9
- import type { SignalProtocolLocalStore } from '../types/api.js';
10
- /**
11
- * A view of SignalProtocolLocalStore scoped to a specific identity type.
12
- * All identity-type-aware methods are pre-filled with the given type.
13
- */
14
- export {};
15
- export declare class IdentityTypedStore {
16
- private readonly store;
17
- readonly identityType: IdentityType;
18
- constructor(store: SignalProtocolLocalStore, identityType: IdentityType);
19
- storeIdentityKey(keyPair: IdentityKeyPair): Promise<void>;
20
- getIdentityKey(): Promise<IdentityKeyPair | null>;
21
- hasIdentityKey(): Promise<boolean>;
22
- getLocalRegistrationId(): Promise<number>;
23
- setLocalRegistrationId(id: number): Promise<void>;
24
- storeEcSignedPreKey(signedPreKey: EcSignedPreKey): Promise<void>;
25
- getEcSignedPreKey(keyId?: number): Promise<EcSignedPreKey | null>;
26
- getAllEcSignedPreKeys(): Promise<EcSignedPreKey[]> | undefined;
27
- removeEcSignedPreKey(keyId: number): Promise<void> | undefined;
28
- getEcSignedPreKeyMaxId(): Promise<number>;
29
- storeEcOneTimePreKeys(prekeys: EcOneTimePreKey[]): Promise<void>;
30
- getEcOneTimePreKeys(): Promise<EcOneTimePreKey[]>;
31
- removeEcOneTimePreKey(keyId: number): Promise<void>;
32
- storeKyberPreKey(prekey: KyberPreKey): Promise<void>;
33
- getKyberPreKey(): Promise<KyberPreKey | null>;
34
- markKyberPreKeyUsed(kyberPreKeyId: number, signedPreKeyId: number, baseKeyBytes: Uint8Array): Promise<void>;
35
- getKyberPreKeyMaxId(): Promise<number>;
36
- storeKemOneTimePreKeys(prekeys: KemOneTimePreKey[]): Promise<void>;
37
- getKemOneTimePreKeys(): Promise<KemOneTimePreKey[]>;
38
- getKemOneTimePreKey(keyId: number): Promise<KemOneTimePreKey | null>;
39
- removeKemOneTimePreKey(keyId: number): Promise<void>;
40
- getKemOneTimePreKeyCount(): Promise<number>;
41
- deleteAllPreKeys(): Promise<{
42
- ecSignedPreKeys: number;
43
- ecOneTimePreKeys: number;
44
- kyberPreKeys: number;
45
- kemOneTimePreKeys: number;
46
- }>;
47
- }
48
- /**
49
- * Dual protocol store. Routes operations to ACI or PNI identity stores.
50
- *
51
- * Usage:
52
- * ```typescript
53
- * const dual = new DualProtocolStore(localStore);
54
- * await dual.aci().getIdentityKey(); // ACI identity key
55
- * await dual.pni().getIdentityKey(); // PNI identity key
56
- * ```
57
- */
58
- export declare class DualProtocolStore {
59
- private readonly localStore;
60
- private readonly aciStore;
61
- private readonly pniStore;
62
- constructor(localStore: SignalProtocolLocalStore);
63
- /** ACI (Account Identity) protocol store */
64
- aci(): IdentityTypedStore;
65
- /** PNI (Phone/discoverable Number Identity) protocol store */
66
- pni(): IdentityTypedStore;
67
- /** Access the underlying unscoped store (for identity-agnostic operations) */
68
- get unscoped(): SignalProtocolLocalStore;
69
- }
70
- //# sourceMappingURL=dual-store.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"dual-store.d.ts","sourceRoot":"","sources":["../../client/dual-store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,cAAc,EACd,eAAe,EACf,WAAW,EACX,gBAAgB,EACjB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAE7D;;;GAGG;AACH,OAAO,EAAE,CAAC;AACV,qBAAa,kBAAkB;IAE3B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,QAAQ,CAAC,YAAY,EAAE,YAAY;IAFrC,YACmB,KAAK,EAAE,wBAAwB,EACvC,YAAY,EAAE,YAAY,EACjC;IAGJ,gBAAgB,CAAC,OAAO,EAAE,eAAe,iBAExC;IAED,cAAc,oCAEb;IAED,cAAc,qBAEb;IAED,sBAAsB,oBAErB;IAED,sBAAsB,CAAC,EAAE,EAAE,MAAM,iBAEhC;IAGD,mBAAmB,CAAC,YAAY,EAAE,cAAc,iBAE/C;IAED,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,kCAE/B;IAED,qBAAqB,0CAEpB;IAED,oBAAoB,CAAC,KAAK,EAAE,MAAM,6BAEjC;IAED,sBAAsB,oBAErB;IAGD,qBAAqB,CAAC,OAAO,EAAE,eAAe,EAAE,iBAE/C;IAED,mBAAmB,+BAElB;IAED,qBAAqB,CAAC,KAAK,EAAE,MAAM,iBAElC;IAGD,gBAAgB,CAAC,MAAM,EAAE,WAAW,iBAEnC;IAED,cAAc,gCAEb;IAED,mBAAmB,CAAC,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,iBAO1F;IAED,mBAAmB,oBAElB;IAGD,sBAAsB,CAAC,OAAO,EAAE,gBAAgB,EAAE,iBAEjD;IAED,oBAAoB,gCAEnB;IAED,mBAAmB,CAAC,KAAK,EAAE,MAAM,oCAEhC;IAED,sBAAsB,CAAC,KAAK,EAAE,MAAM,iBAEnC;IAED,wBAAwB,oBAEvB;IAGD,gBAAgB;;;;;OAEf;CACF;AAED;;;;;;;;;GASG;AACH,qBAAa,iBAAiB;IAIhB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAHvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAE9C,YAA6B,UAAU,EAAE,wBAAwB,EAGhE;IAED,4CAA4C;IAC5C,GAAG,IAAI,kBAAkB,CAExB;IAED,8DAA8D;IAC9D,GAAG,IAAI,kBAAkB,CAExB;IAED,8EAA8E;IAC9E,IAAI,QAAQ,IAAI,wBAAwB,CAEvC;CACF"}
@@ -1,123 +0,0 @@
1
- /**
2
- * Dual Protocol Store: ACI/PNI Identity Router
3
- *
4
- * Thin wrapper providing .aci() and .pni() views over KeyStorage,
5
- * each pre-filling identityType for all operations.
6
- *
7
- */
8
- export class IdentityTypedStore {
9
- store;
10
- identityType;
11
- constructor(store, identityType) {
12
- this.store = store;
13
- this.identityType = identityType;
14
- }
15
- // Identity keys
16
- storeIdentityKey(keyPair) {
17
- return this.store.storeIdentityKey(keyPair, this.identityType);
18
- }
19
- getIdentityKey() {
20
- return this.store.getIdentityKey(this.identityType);
21
- }
22
- hasIdentityKey() {
23
- return this.store.hasIdentityKey(this.identityType);
24
- }
25
- getLocalRegistrationId() {
26
- return this.store.getLocalRegistrationId(this.identityType);
27
- }
28
- setLocalRegistrationId(id) {
29
- return this.store.setLocalRegistrationId(id, this.identityType);
30
- }
31
- // EC signed prekeys
32
- storeEcSignedPreKey(signedPreKey) {
33
- return this.store.storeEcSignedPreKey(signedPreKey, this.identityType);
34
- }
35
- getEcSignedPreKey(keyId) {
36
- return this.store.getEcSignedPreKey(keyId, this.identityType);
37
- }
38
- getAllEcSignedPreKeys() {
39
- return this.store.getAllEcSignedPreKeys?.(this.identityType);
40
- }
41
- removeEcSignedPreKey(keyId) {
42
- return this.store.removeEcSignedPreKey?.(keyId, this.identityType);
43
- }
44
- getEcSignedPreKeyMaxId() {
45
- return this.store.getEcSignedPreKeyMaxId(this.identityType);
46
- }
47
- // EC one-time prekeys
48
- storeEcOneTimePreKeys(prekeys) {
49
- return this.store.storeEcOneTimePreKeys(prekeys, this.identityType);
50
- }
51
- getEcOneTimePreKeys() {
52
- return this.store.getEcOneTimePreKeys(this.identityType);
53
- }
54
- removeEcOneTimePreKey(keyId) {
55
- return this.store.removeEcOneTimePreKey(keyId, this.identityType);
56
- }
57
- // Kyber last-resort prekey
58
- storeKyberPreKey(prekey) {
59
- return this.store.storeKyberPreKey(prekey, this.identityType);
60
- }
61
- getKyberPreKey() {
62
- return this.store.getKyberPreKey(this.identityType);
63
- }
64
- markKyberPreKeyUsed(kyberPreKeyId, signedPreKeyId, baseKeyBytes) {
65
- return this.store.markKyberPreKeyUsed(kyberPreKeyId, signedPreKeyId, baseKeyBytes, this.identityType);
66
- }
67
- getKyberPreKeyMaxId() {
68
- return this.store.getKyberPreKeyMaxId(this.identityType);
69
- }
70
- // KEM one-time prekeys
71
- storeKemOneTimePreKeys(prekeys) {
72
- return this.store.storeKemOneTimePreKeys(prekeys, this.identityType);
73
- }
74
- getKemOneTimePreKeys() {
75
- return this.store.getKemOneTimePreKeys(this.identityType);
76
- }
77
- getKemOneTimePreKey(keyId) {
78
- return this.store.getKemOneTimePreKey(keyId, this.identityType);
79
- }
80
- removeKemOneTimePreKey(keyId) {
81
- return this.store.removeKemOneTimePreKey(keyId, this.identityType);
82
- }
83
- getKemOneTimePreKeyCount() {
84
- return this.store.getKemOneTimePreKeyCount(this.identityType);
85
- }
86
- // Bulk operations
87
- deleteAllPreKeys() {
88
- return this.store.deleteAllPreKeys(this.identityType);
89
- }
90
- }
91
- /**
92
- * Dual protocol store. Routes operations to ACI or PNI identity stores.
93
- *
94
- * Usage:
95
- * ```typescript
96
- * const dual = new DualProtocolStore(localStore);
97
- * await dual.aci().getIdentityKey(); // ACI identity key
98
- * await dual.pni().getIdentityKey(); // PNI identity key
99
- * ```
100
- */
101
- export class DualProtocolStore {
102
- localStore;
103
- aciStore;
104
- pniStore;
105
- constructor(localStore) {
106
- this.localStore = localStore;
107
- this.aciStore = new IdentityTypedStore(localStore, 'aci');
108
- this.pniStore = new IdentityTypedStore(localStore, 'pni');
109
- }
110
- /** ACI (Account Identity) protocol store */
111
- aci() {
112
- return this.aciStore;
113
- }
114
- /** PNI (Phone/discoverable Number Identity) protocol store */
115
- pni() {
116
- return this.pniStore;
117
- }
118
- /** Access the underlying unscoped store (for identity-agnostic operations) */
119
- get unscoped() {
120
- return this.localStore;
121
- }
122
- }
123
- //# sourceMappingURL=dual-store.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"dual-store.js","sourceRoot":"","sources":["../../client/dual-store.ts"],"names":[],"mappings":"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"}
@@ -1,74 +0,0 @@
1
- /**
2
- * Multi-device (SESAME) operations for SignalProtocolClient
3
- *
4
- * Extracted from DefaultSignalProtocolClient class to reduce file size.
5
- * Implements the SESAME protocol for multi-device session management.
6
- *
7
- * @see https://signal.org/docs/specifications/sesame/
8
- */
9
- import type { SesameMessage, SesameStats, OutgoingMessageBatch } from '../internal/sesame/types.js';
10
- import type { SignalProtocolClientContext } from './types.js';
11
- /**
12
- * Send message to all devices of a user (multi-device support).
13
- *
14
- * Implements the 3-phase sending process from SESAME spec:
15
- *
16
- * - Phase 1: Identify devices with non-stale active sessions
17
- * - Phase 2: Encrypt message for each device using Double Ratchet
18
- * - Phase 3: Validate device list is current before sending
19
- *
20
- * Returns an OutgoingMessageBatch that separates:
21
- * - deviceMessages: Messages for recipient's devices
22
- * - syncMessages: Messages for our own other devices (multi-device sync)
23
- *
24
- * Device-targeted messages remain separate from linked-device sync
25
- * transcripts.
26
- *
27
- * Note: This method does NOT upload messages to the server automatically.
28
- * You must call the backend API to upload the returned messages.
29
- *
30
- * @param ctx - Client context with dependencies
31
- * @param recipientUserId - The user ID to send to (all their active devices)
32
- * @param plaintext - The message to encrypt
33
- * @param includeSyncMessages - Whether to include sync messages for our own devices (default: true)
34
- * @returns OutgoingMessageBatch with separated device and sync messages
35
- *
36
- * @throws {EncryptionError} If encryption fails or user has no devices
37
- */
38
- export {};
39
- export declare function send(ctx: SignalProtocolClientContext, recipientUserId: string, plaintext: string, includeSyncMessages?: boolean): Promise<OutgoingMessageBatch>;
40
- /**
41
- * Receive and decrypt message from another device (multi-device support)
42
- *
43
- * Implements session convergence per SESAME spec:
44
- * - Try to decrypt with active session first
45
- * - If that fails, try inactive sessions
46
- * - If decryption succeeds on inactive session, that session becomes active
47
- *
48
- * @param ctx - Client context with dependencies
49
- * @param message - The encrypted Sesame message envelope
50
- * @returns Decrypted plaintext
51
- *
52
- * @throws {EncryptionError} If decryption fails
53
- */
54
- export declare function receive(ctx: SignalProtocolClientContext, message: SesameMessage): Promise<string>;
55
- /**
56
- * Get Sesame session statistics (for debugging)
57
- *
58
- * Returns information about users, devices, and sessions.
59
- *
60
- * @param ctx - Client context with dependencies
61
- * @returns Session statistics
62
- */
63
- export declare function getSesameStats(ctx: SignalProtocolClientContext): Promise<SesameStats>;
64
- /**
65
- * Cleanup expired Sesame sessions
66
- *
67
- * Removes inactive sessions that are older than the configured TTL.
68
- * Should be called periodically (e.g., daily) to prevent database bloat.
69
- *
70
- * @param ctx - Client context with dependencies
71
- * @returns Number of sessions cleaned up
72
- */
73
- export declare function cleanupExpiredSesameSessions(ctx: SignalProtocolClientContext): Promise<number>;
74
- //# sourceMappingURL=multi-device.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"multi-device.d.ts","sourceRoot":"","sources":["../../client/multi-device.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEjG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,EAAE,CAAC;AACV,wBAAsB,IAAI,CACxB,GAAG,EAAE,2BAA2B,EAChC,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,MAAM,EACjB,mBAAmB,GAAE,OAAc,GAClC,OAAO,CAAC,oBAAoB,CAAC,CA+B/B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,OAAO,CAC3B,GAAG,EAAE,2BAA2B,EAChC,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,CAAC,CA0BjB;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,2BAA2B,GAAG,OAAO,CAAC,WAAW,CAAC,CAE3F;AAED;;;;;;;;GAQG;AACH,wBAAsB,4BAA4B,CAChD,GAAG,EAAE,2BAA2B,GAC/B,OAAO,CAAC,MAAM,CAAC,CAOjB"}
@@ -1,105 +0,0 @@
1
- /**
2
- * Multi-device (SESAME) operations for SignalProtocolClient
3
- *
4
- * Extracted from DefaultSignalProtocolClient class to reduce file size.
5
- * Implements the SESAME protocol for multi-device session management.
6
- *
7
- * @see https://signal.org/docs/specifications/sesame/
8
- */
9
- import { utf8Decode } from '../internal/platform/index.js';
10
- import { EncryptionError, EncryptionErrorCode } from '../types/index.js';
11
- export async function send(ctx, recipientUserId, plaintext, includeSyncMessages = true) {
12
- try {
13
- // Convert plaintext to Uint8Array
14
- const plaintextBytes = new TextEncoder().encode(plaintext);
15
- // Delegate to Sesame manager (encrypts for all devices)
16
- const batch = await ctx.sesameManager.send(recipientUserId, plaintextBytes, {
17
- includeSyncMessages,
18
- });
19
- ctx.logger.debug('Message encrypted for user devices', {
20
- category: 'E2EE',
21
- data: {
22
- recipientUserId,
23
- deviceCount: batch.deviceMessages.length,
24
- syncCount: batch.syncMessages.length,
25
- },
26
- });
27
- return batch;
28
- }
29
- catch (error) {
30
- // Preserve EncryptionError codes
31
- if (error instanceof EncryptionError) {
32
- throw error;
33
- }
34
- throw new EncryptionError('Failed to encrypt message for user', EncryptionErrorCode.ENCRYPTION_FAILED, { originalError: error, recipientUserId });
35
- }
36
- }
37
- /**
38
- * Receive and decrypt message from another device (multi-device support)
39
- *
40
- * Implements session convergence per SESAME spec:
41
- * - Try to decrypt with active session first
42
- * - If that fails, try inactive sessions
43
- * - If decryption succeeds on inactive session, that session becomes active
44
- *
45
- * @param ctx - Client context with dependencies
46
- * @param message - The encrypted Sesame message envelope
47
- * @returns Decrypted plaintext
48
- *
49
- * @throws {EncryptionError} If decryption fails
50
- */
51
- export async function receive(ctx, message) {
52
- try {
53
- // Delegate to Sesame manager (handles session convergence)
54
- const plaintextBytes = await ctx.sesameManager.receive(message);
55
- const plaintext = utf8Decode(plaintextBytes);
56
- ctx.logger.debug('Message received and decrypted', {
57
- category: 'E2EE',
58
- data: {
59
- senderUserId: message.senderUserId,
60
- senderDeviceId: message.senderDeviceId,
61
- },
62
- });
63
- return plaintext;
64
- }
65
- catch (error) {
66
- // Preserve EncryptionError for client-layer handling
67
- // (e.g., PREKEY_NOT_FOUND triggers key rotation).
68
- if (error instanceof EncryptionError) {
69
- throw error;
70
- }
71
- throw new EncryptionError('Failed to decrypt message', EncryptionErrorCode.DECRYPTION_FAILED, {
72
- originalError: error,
73
- senderUserId: message.senderUserId,
74
- });
75
- }
76
- }
77
- /**
78
- * Get Sesame session statistics (for debugging)
79
- *
80
- * Returns information about users, devices, and sessions.
81
- *
82
- * @param ctx - Client context with dependencies
83
- * @returns Session statistics
84
- */
85
- export async function getSesameStats(ctx) {
86
- return ctx.sesameManager.getStats();
87
- }
88
- /**
89
- * Cleanup expired Sesame sessions
90
- *
91
- * Removes inactive sessions that are older than the configured TTL.
92
- * Should be called periodically (e.g., daily) to prevent database bloat.
93
- *
94
- * @param ctx - Client context with dependencies
95
- * @returns Number of sessions cleaned up
96
- */
97
- export async function cleanupExpiredSesameSessions(ctx) {
98
- const cleaned = await ctx.sesameManager.cleanupExpiredSessions();
99
- ctx.logger.debug('Expired Sesame sessions cleaned up', {
100
- category: 'E2EE',
101
- data: { count: cleaned },
102
- });
103
- return cleaned;
104
- }
105
- //# sourceMappingURL=multi-device.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"multi-device.js","sourceRoot":"","sources":["../../client/multi-device.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AA+BhE,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,GAAgC,EAChC,eAAuB,EACvB,SAAiB,EACjB,mBAAmB,GAAY,IAAI;IAEnC,IAAI,CAAC;QACH,kCAAkC;QAClC,MAAM,cAAc,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAE3D,wDAAwD;QACxD,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,eAAe,EAAE,cAAc,EAAE;YAC1E,mBAAmB;SACpB,CAAC,CAAC;QAEH,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE;YACrD,QAAQ,EAAE,MAAM;YAChB,IAAI,EAAE;gBACJ,eAAe;gBACf,WAAW,EAAE,KAAK,CAAC,cAAc,CAAC,MAAM;gBACxC,SAAS,EAAE,KAAK,CAAC,YAAY,CAAC,MAAM;aACrC;SACF,CAAC,CAAC;QAEH,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,iCAAiC;QACjC,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;YACrC,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,IAAI,eAAe,CACvB,oCAAoC,EACpC,mBAAmB,CAAC,iBAAiB,EACrC,EAAE,aAAa,EAAE,KAAc,EAAE,eAAe,EAAE,CACnD,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,GAAgC,EAChC,OAAsB;IAEtB,IAAI,CAAC;QACH,2DAA2D;QAC3D,MAAM,cAAc,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAChE,MAAM,SAAS,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC;QAE7C,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE;YACjD,QAAQ,EAAE,MAAM;YAChB,IAAI,EAAE;gBACJ,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,cAAc,EAAE,OAAO,CAAC,cAAc;aACvC;SACF,CAAC,CAAC;QAEH,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,qDAAqD;QACrD,kDAAkD;QAClD,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;YACrC,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,IAAI,eAAe,CAAC,2BAA2B,EAAE,mBAAmB,CAAC,iBAAiB,EAAE;YAC5F,aAAa,EAAE,KAAc;YAC7B,YAAY,EAAE,OAAO,CAAC,YAAY;SACnC,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAgC;IACnE,OAAO,GAAG,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC;AACtC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,GAAgC;IAEhC,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC,sBAAsB,EAAE,CAAC;IACjE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE;QACrD,QAAQ,EAAE,MAAM;QAChB,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE;KACzB,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}
@@ -1,10 +0,0 @@
1
- /** Encrypted group authorization for server-owned persistence adapters. */
2
- export { GROUP_CHANGE_LOG_PAGE_LIMIT, GroupAuthorizationServerEngine, } from '../internal/groups/server-engine.js';
3
- export type { GroupForbiddenReason, GroupServerEngineRuntime, GroupServerPersistedGroup, GroupServerPersistedSnapshot, } from '../internal/groups/server-engine.js';
4
- export type { GroupAuthorization, GroupChangeLogEntry, GroupChangeLogPage, GroupSnapshot, GroupServer, } from '../internal/groups/manager.js';
5
- export { isGroupErrorDetail } from '../internal/groups/error-details.js';
6
- export type { GroupErrorDetail } from '../internal/groups/error-details.js';
7
- export { encodeGroupAuthority } from '../internal/groups/authority-certificate.js';
8
- export type { GroupAuthorityFields, SignedGroupAuthority, } from '../internal/groups/authority-certificate.js';
9
- export { serializeGroupBaseline, serializeGroupChangeCommitment, } from '../internal/groups/wire.js';
10
- //# sourceMappingURL=server.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../groups/server.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,OAAO,EACL,2BAA2B,EAC3B,8BAA8B,GAC/B,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EACV,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,WAAW,GACZ,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,YAAY,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAChF,YAAY,EACV,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EACL,sBAAsB,EACtB,8BAA8B,GAC/B,MAAM,yBAAyB,CAAC"}
@@ -1,6 +0,0 @@
1
- /** Encrypted group authorization for server-owned persistence adapters. */
2
- export { GROUP_CHANGE_LOG_PAGE_LIMIT, GroupAuthorizationServerEngine, } from '../internal/groups/server-engine.js';
3
- export { isGroupErrorDetail } from '../internal/groups/error-details.js';
4
- export { encodeGroupAuthority } from '../internal/groups/authority-certificate.js';
5
- export { serializeGroupBaseline, serializeGroupChangeCommitment, } from '../internal/groups/wire.js';
6
- //# sourceMappingURL=server.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"server.js","sourceRoot":"","sources":["../../groups/server.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,OAAO,EACL,2BAA2B,EAC3B,8BAA8B,GAC/B,MAAM,kCAAkC,CAAC;AAc1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAEtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAKhF,OAAO,EACL,sBAAsB,EACtB,8BAA8B,GAC/B,MAAM,yBAAyB,CAAC"}
@@ -1,2 +0,0 @@
1
- export * from './proto/index.js';
2
- //# sourceMappingURL=index.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../internal/encoding/index.ts"],"names":[],"mappings":"AAQA,cAAc,SAAS,CAAC"}
@@ -1,2 +0,0 @@
1
- export * from './proto/index.js';
2
- //# sourceMappingURL=index.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../internal/encoding/index.ts"],"names":[],"mappings":"AAQA,cAAc,SAAS,CAAC"}