@open-e2ee/signal-protocol-sdk 14.0.0 → 14.2.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 (406) hide show
  1. package/ADAPTERS.md +5 -5
  2. package/ARCHITECTURE.md +1 -1
  3. package/CHANGELOG.md +461 -0
  4. package/README.md +21 -15
  5. package/SECURITY.md +2 -2
  6. package/TROUBLESHOOTING.md +1 -1
  7. package/client/README.md +35 -22
  8. package/device/README.md +5 -5
  9. package/dist/client/client.d.ts +44 -34
  10. package/dist/client/client.d.ts.map +1 -1
  11. package/dist/client/client.js +221 -146
  12. package/dist/client/client.js.map +1 -1
  13. package/dist/client/compose.d.ts +7 -5
  14. package/dist/client/compose.d.ts.map +1 -1
  15. package/dist/client/compose.js +7 -2
  16. package/dist/client/compose.js.map +1 -1
  17. package/dist/client/config.d.ts +23 -14
  18. package/dist/client/config.d.ts.map +1 -1
  19. package/dist/client/config.js.map +1 -1
  20. package/dist/client/content-adapter.d.ts +9 -0
  21. package/dist/client/content-adapter.d.ts.map +1 -1
  22. package/dist/client/content-adapter.js +6 -0
  23. package/dist/client/content-adapter.js.map +1 -1
  24. package/dist/client/delivery-status.d.ts +2 -2
  25. package/dist/client/delivery-status.d.ts.map +1 -1
  26. package/dist/client/delivery-status.js +10 -4
  27. package/dist/client/delivery-status.js.map +1 -1
  28. package/dist/client/device-set-reconciliation.d.ts +24 -16
  29. package/dist/client/device-set-reconciliation.d.ts.map +1 -1
  30. package/dist/client/device-set-reconciliation.js +17 -14
  31. package/dist/client/device-set-reconciliation.js.map +1 -1
  32. package/dist/client/event-hooks.d.ts +22 -7
  33. package/dist/client/event-hooks.d.ts.map +1 -1
  34. package/dist/client/event-hooks.js +35 -5
  35. package/dist/client/event-hooks.js.map +1 -1
  36. package/dist/client/group-device-set.d.ts +1 -1
  37. package/dist/client/group-device-set.d.ts.map +1 -1
  38. package/dist/client/group-key-sync.js +1 -1
  39. package/dist/client/group-key-sync.js.map +1 -1
  40. package/dist/client/group-outbox.d.ts +7 -7
  41. package/dist/client/group-outbox.d.ts.map +1 -1
  42. package/dist/client/group-outbox.js +24 -24
  43. package/dist/client/group-outbox.js.map +1 -1
  44. package/dist/client/group-sealed-sender.d.ts +1 -1
  45. package/dist/client/group-sealed-sender.d.ts.map +1 -1
  46. package/dist/client/group-sender-key-operations.js +1 -1
  47. package/dist/client/group-sender-key-operations.js.map +1 -1
  48. package/dist/client/headless.d.ts +6 -6
  49. package/dist/client/headless.d.ts.map +1 -1
  50. package/dist/client/headless.js +7 -7
  51. package/dist/client/headless.js.map +1 -1
  52. package/dist/client/hosted-anonymous-delivery.d.ts +18 -6
  53. package/dist/client/hosted-anonymous-delivery.d.ts.map +1 -1
  54. package/dist/client/hosted-anonymous-delivery.js +63 -20
  55. package/dist/client/hosted-anonymous-delivery.js.map +1 -1
  56. package/dist/client/hosted-assertion-id.d.ts +1 -1
  57. package/dist/client/hosted-assertion-id.d.ts.map +1 -1
  58. package/dist/client/hosted-assertion-id.js +1 -1
  59. package/dist/client/hosted-assertion-id.js.map +1 -1
  60. package/dist/client/hosted-connection.d.ts +5 -5
  61. package/dist/client/hosted-connection.d.ts.map +1 -1
  62. package/dist/client/hosted-connection.js +32 -32
  63. package/dist/client/hosted-connection.js.map +1 -1
  64. package/dist/client/hosted-device-link-transport.d.ts +2 -2
  65. package/dist/client/hosted-device-link-transport.d.ts.map +1 -1
  66. package/dist/client/hosted-device-link-transport.js +1 -1
  67. package/dist/client/hosted-device-link-transport.js.map +1 -1
  68. package/dist/client/hosted-device-link.d.ts +5 -1
  69. package/dist/client/hosted-device-link.d.ts.map +1 -1
  70. package/dist/client/hosted-device-link.js +7 -4
  71. package/dist/client/hosted-device-link.js.map +1 -1
  72. package/dist/client/hosted-device-standing.d.ts +13 -5
  73. package/dist/client/hosted-device-standing.d.ts.map +1 -1
  74. package/dist/client/hosted-device-standing.js +11 -6
  75. package/dist/client/hosted-device-standing.js.map +1 -1
  76. package/dist/client/hosted-group-authority.d.ts +2 -2
  77. package/dist/client/hosted-group-authority.d.ts.map +1 -1
  78. package/dist/client/hosted-group-authority.js +8 -8
  79. package/dist/client/hosted-group-authority.js.map +1 -1
  80. package/dist/client/hosted-groups.d.ts +4 -4
  81. package/dist/client/hosted-groups.d.ts.map +1 -1
  82. package/dist/client/hosted-groups.js +8 -8
  83. package/dist/client/hosted-groups.js.map +1 -1
  84. package/dist/client/hosted-http-error.d.ts +8 -4
  85. package/dist/client/hosted-http-error.d.ts.map +1 -1
  86. package/dist/client/hosted-http-error.js +7 -4
  87. package/dist/client/hosted-http-error.js.map +1 -1
  88. package/dist/client/hosted-mailbox-subscription.d.ts +16 -15
  89. package/dist/client/hosted-mailbox-subscription.d.ts.map +1 -1
  90. package/dist/client/hosted-mailbox-subscription.js +21 -25
  91. package/dist/client/hosted-mailbox-subscription.js.map +1 -1
  92. package/dist/client/hosted-prekey-publication.d.ts +9 -9
  93. package/dist/client/hosted-prekey-publication.d.ts.map +1 -1
  94. package/dist/client/hosted-prekey-publication.js.map +1 -1
  95. package/dist/client/hosted-presence-frames.d.ts +62 -38
  96. package/dist/client/hosted-presence-frames.d.ts.map +1 -1
  97. package/dist/client/hosted-presence-frames.js +4 -2
  98. package/dist/client/hosted-presence-frames.js.map +1 -1
  99. package/dist/client/hosted-presence.d.ts +22 -14
  100. package/dist/client/hosted-presence.d.ts.map +1 -1
  101. package/dist/client/hosted-presence.js +26 -17
  102. package/dist/client/hosted-presence.js.map +1 -1
  103. package/dist/client/hosted-profile-keys.d.ts +3 -1
  104. package/dist/client/hosted-profile-keys.d.ts.map +1 -1
  105. package/dist/client/hosted-profile-keys.js +19 -15
  106. package/dist/client/hosted-profile-keys.js.map +1 -1
  107. package/dist/client/hosted-push.d.ts +38 -16
  108. package/dist/client/hosted-push.d.ts.map +1 -1
  109. package/dist/client/hosted-push.js +11 -5
  110. package/dist/client/hosted-push.js.map +1 -1
  111. package/dist/client/hosted-resume-error.d.ts +21 -9
  112. package/dist/client/hosted-resume-error.d.ts.map +1 -1
  113. package/dist/client/hosted-resume-error.js +4 -1
  114. package/dist/client/hosted-resume-error.js.map +1 -1
  115. package/dist/client/hosted-resume.d.ts +3 -3
  116. package/dist/client/hosted-resume.d.ts.map +1 -1
  117. package/dist/client/hosted-resume.js +12 -12
  118. package/dist/client/hosted-resume.js.map +1 -1
  119. package/dist/client/hosted-sandbox-identity.d.ts +82 -5
  120. package/dist/client/hosted-sandbox-identity.d.ts.map +1 -1
  121. package/dist/client/hosted-sandbox-identity.js +160 -50
  122. package/dist/client/hosted-sandbox-identity.js.map +1 -1
  123. package/dist/client/hosted-store-records.d.ts +46 -0
  124. package/dist/client/hosted-store-records.d.ts.map +1 -0
  125. package/dist/client/hosted-store-records.js +32 -0
  126. package/dist/client/hosted-store-records.js.map +1 -0
  127. package/dist/client/hosted-transport.d.ts +53 -33
  128. package/dist/client/hosted-transport.d.ts.map +1 -1
  129. package/dist/client/hosted-transport.js +225 -138
  130. package/dist/client/hosted-transport.js.map +1 -1
  131. package/dist/client/hosted-trust.d.ts +1 -1
  132. package/dist/client/hosted-trust.d.ts.map +1 -1
  133. package/dist/client/hosted-trust.js +1 -1
  134. package/dist/client/hosted-trust.js.map +1 -1
  135. package/dist/client/hosted.d.ts +144 -75
  136. package/dist/client/hosted.d.ts.map +1 -1
  137. package/dist/client/hosted.js +106 -61
  138. package/dist/client/hosted.js.map +1 -1
  139. package/dist/client/index.d.ts +4 -4
  140. package/dist/client/index.d.ts.map +1 -1
  141. package/dist/client/index.js +4 -4
  142. package/dist/client/index.js.map +1 -1
  143. package/dist/client/key-rotation-core.d.ts +4 -4
  144. package/dist/client/key-rotation-core.d.ts.map +1 -1
  145. package/dist/client/key-rotation-core.js +8 -8
  146. package/dist/client/key-rotation-core.js.map +1 -1
  147. package/dist/client/key-rotation.js +2 -2
  148. package/dist/client/key-rotation.js.map +1 -1
  149. package/dist/client/messages.d.ts +3 -3
  150. package/dist/client/messages.d.ts.map +1 -1
  151. package/dist/client/messages.js +18 -18
  152. package/dist/client/messages.js.map +1 -1
  153. package/dist/client/one-time-prekey-refill.d.ts +1 -1
  154. package/dist/client/one-time-prekey-refill.d.ts.map +1 -1
  155. package/dist/client/prekeys.js +17 -17
  156. package/dist/client/prekeys.js.map +1 -1
  157. package/dist/client/receive-queue.d.ts +4 -4
  158. package/dist/client/receive-queue.d.ts.map +1 -1
  159. package/dist/client/receive-queue.js +29 -29
  160. package/dist/client/receive-queue.js.map +1 -1
  161. package/dist/client/receive-work-seed.d.ts +6 -2
  162. package/dist/client/receive-work-seed.d.ts.map +1 -1
  163. package/dist/client/receive-work-seed.js.map +1 -1
  164. package/dist/client/recovery-driver.js +7 -7
  165. package/dist/client/recovery-driver.js.map +1 -1
  166. package/dist/client/retry-request-envelope.d.ts +3 -3
  167. package/dist/client/retry-request-envelope.d.ts.map +1 -1
  168. package/dist/client/retry-request-envelope.js +10 -10
  169. package/dist/client/retry-request-envelope.js.map +1 -1
  170. package/dist/client/retry-request-lifecycle.d.ts +1 -1
  171. package/dist/client/retry-request-lifecycle.d.ts.map +1 -1
  172. package/dist/client/retry-request-lifecycle.js +8 -8
  173. package/dist/client/retry-request-lifecycle.js.map +1 -1
  174. package/dist/client/retry-terminal-recovery.js +2 -2
  175. package/dist/client/retry-terminal-recovery.js.map +1 -1
  176. package/dist/client/retry.js +13 -13
  177. package/dist/client/retry.js.map +1 -1
  178. package/dist/client/sealed-sender.d.ts +13 -4
  179. package/dist/client/sealed-sender.d.ts.map +1 -1
  180. package/dist/client/sealed-sender.js +27 -15
  181. package/dist/client/sealed-sender.js.map +1 -1
  182. package/dist/client/send-deadline.d.ts +8 -7
  183. package/dist/client/send-deadline.d.ts.map +1 -1
  184. package/dist/client/send-deadline.js +41 -23
  185. package/dist/client/send-deadline.js.map +1 -1
  186. package/dist/client/send-intent-driver.js +9 -9
  187. package/dist/client/send-intent-driver.js.map +1 -1
  188. package/dist/client/sessions.js +11 -11
  189. package/dist/client/sessions.js.map +1 -1
  190. package/dist/client/{relay-acceptance.d.ts → signal-relay-acceptance.d.ts} +9 -9
  191. package/dist/client/signal-relay-acceptance.d.ts.map +1 -0
  192. package/dist/client/{relay-acceptance.js → signal-relay-acceptance.js} +7 -7
  193. package/dist/client/signal-relay-acceptance.js.map +1 -0
  194. package/dist/client/{relay-device-refusal.d.ts → signal-relay-device-refusal.d.ts} +7 -7
  195. package/dist/client/signal-relay-device-refusal.d.ts.map +1 -0
  196. package/dist/client/{relay-device-refusal.js → signal-relay-device-refusal.js} +9 -9
  197. package/dist/client/signal-relay-device-refusal.js.map +1 -0
  198. package/dist/client/{relay-lifecycle.d.ts → signal-relay-lifecycle.d.ts} +21 -11
  199. package/dist/client/signal-relay-lifecycle.d.ts.map +1 -0
  200. package/dist/client/{relay-lifecycle.js → signal-relay-lifecycle.js} +19 -9
  201. package/dist/client/signal-relay-lifecycle.js.map +1 -0
  202. package/dist/client/signal-relay-period-close.d.ts +35 -0
  203. package/dist/client/signal-relay-period-close.d.ts.map +1 -0
  204. package/dist/client/signal-relay-period-close.js +63 -0
  205. package/dist/client/signal-relay-period-close.js.map +1 -0
  206. package/dist/client/{relay-protocol.d.ts → signal-relay-protocol.d.ts} +12 -8
  207. package/dist/client/signal-relay-protocol.d.ts.map +1 -0
  208. package/dist/client/{relay-protocol.js → signal-relay-protocol.js} +13 -10
  209. package/dist/client/signal-relay-protocol.js.map +1 -0
  210. package/dist/client/{relay-receipt-intake.d.ts → signal-relay-receipt-intake.d.ts} +12 -12
  211. package/dist/client/signal-relay-receipt-intake.d.ts.map +1 -0
  212. package/dist/client/{relay-receipt-intake.js → signal-relay-receipt-intake.js} +9 -9
  213. package/dist/client/signal-relay-receipt-intake.js.map +1 -0
  214. package/dist/client/{relay-receipt-join.d.ts → signal-relay-receipt-join.d.ts} +8 -8
  215. package/dist/client/signal-relay-receipt-join.d.ts.map +1 -0
  216. package/dist/client/{relay-receipt-join.js → signal-relay-receipt-join.js} +11 -11
  217. package/dist/client/signal-relay-receipt-join.js.map +1 -0
  218. package/dist/client/{relay-request-deadline.d.ts → signal-relay-request-deadline.d.ts} +3 -3
  219. package/dist/client/signal-relay-request-deadline.d.ts.map +1 -0
  220. package/dist/client/{relay-request-deadline.js → signal-relay-request-deadline.js} +4 -4
  221. package/dist/client/signal-relay-request-deadline.js.map +1 -0
  222. package/dist/client/{relay-sealed-route.d.ts → signal-relay-sealed-route.d.ts} +1 -1
  223. package/dist/client/signal-relay-sealed-route.d.ts.map +1 -0
  224. package/dist/client/{relay-sealed-route.js → signal-relay-sealed-route.js} +1 -1
  225. package/dist/client/signal-relay-sealed-route.js.map +1 -0
  226. package/dist/client/{relay-subscription.d.ts → signal-relay-subscription.d.ts} +12 -12
  227. package/dist/client/signal-relay-subscription.d.ts.map +1 -0
  228. package/dist/client/{relay-subscription.js → signal-relay-subscription.js} +23 -23
  229. package/dist/client/signal-relay-subscription.js.map +1 -0
  230. package/dist/client/{relay-work.d.ts → signal-relay-work.d.ts} +7 -7
  231. package/dist/client/signal-relay-work.d.ts.map +1 -0
  232. package/dist/client/{relay-work.js → signal-relay-work.js} +13 -13
  233. package/dist/client/signal-relay-work.js.map +1 -0
  234. package/dist/client/signal-service-cipher.d.ts +11 -9
  235. package/dist/client/signal-service-cipher.d.ts.map +1 -1
  236. package/dist/client/signal-service-cipher.js +103 -98
  237. package/dist/client/signal-service-cipher.js.map +1 -1
  238. package/dist/client/state.d.ts +4 -4
  239. package/dist/client/state.d.ts.map +1 -1
  240. package/dist/client/state.js +3 -3
  241. package/dist/client/state.js.map +1 -1
  242. package/dist/client/types.d.ts +13 -4
  243. package/dist/client/types.d.ts.map +1 -1
  244. package/dist/client/types.js.map +1 -1
  245. package/dist/device/connection.d.ts +10 -4
  246. package/dist/device/connection.d.ts.map +1 -1
  247. package/dist/device/connection.js +8 -3
  248. package/dist/device/connection.js.map +1 -1
  249. package/dist/device/index.d.ts +2 -2
  250. package/dist/device/index.d.ts.map +1 -1
  251. package/dist/device/index.js +1 -1
  252. package/dist/device/index.js.map +1 -1
  253. package/dist/device/types.d.ts +3 -1
  254. package/dist/device/types.d.ts.map +1 -1
  255. package/dist/hooks/index.d.ts +2 -2
  256. package/dist/hooks/index.d.ts.map +1 -1
  257. package/dist/hooks/index.js +2 -2
  258. package/dist/hooks/index.js.map +1 -1
  259. package/dist/hooks/use-signal-relay-connection-state.d.ts +40 -0
  260. package/dist/hooks/use-signal-relay-connection-state.d.ts.map +1 -0
  261. package/dist/hooks/use-signal-relay-connection-state.js +45 -0
  262. package/dist/hooks/use-signal-relay-connection-state.js.map +1 -0
  263. package/dist/hooks/use-signal-relay-lifecycle.d.ts +43 -0
  264. package/dist/hooks/use-signal-relay-lifecycle.d.ts.map +1 -0
  265. package/dist/hooks/use-signal-relay-lifecycle.js +38 -0
  266. package/dist/hooks/use-signal-relay-lifecycle.js.map +1 -0
  267. package/dist/index.d.ts +18 -12
  268. package/dist/index.d.ts.map +1 -1
  269. package/dist/index.js +5 -5
  270. package/dist/index.js.map +1 -1
  271. package/dist/internal/groups/authority-certificate.d.ts +7 -1
  272. package/dist/internal/groups/authority-certificate.d.ts.map +1 -1
  273. package/dist/internal/groups/authority-certificate.js +29 -6
  274. package/dist/internal/groups/authority-certificate.js.map +1 -1
  275. package/dist/internal/protocol/sealed-sender/certificate.js +2 -2
  276. package/dist/internal/protocol/sealed-sender/certificate.js.map +1 -1
  277. package/dist/internal/protocol/sealed-sender/proto/index.d.ts +1 -1
  278. package/dist/internal/protocol/sealed-sender/proto/index.d.ts.map +1 -1
  279. package/dist/internal/protocol/sealed-sender/proto/index.js +5 -5
  280. package/dist/internal/protocol/sealed-sender/proto/index.js.map +1 -1
  281. package/dist/internal/sesame/device-registry.d.ts +13 -13
  282. package/dist/internal/sesame/device-registry.d.ts.map +1 -1
  283. package/dist/internal/sesame/device-registry.js +20 -20
  284. package/dist/internal/sesame/device-registry.js.map +1 -1
  285. package/dist/local/store/receive-work.d.ts +29 -0
  286. package/dist/local/store/receive-work.d.ts.map +1 -1
  287. package/dist/local/store/receive-work.js +58 -1
  288. package/dist/local/store/receive-work.js.map +1 -1
  289. package/dist/local/store/received-content.d.ts +1 -1
  290. package/dist/local/store/received-content.d.ts.map +1 -1
  291. package/dist/local/store/reliability.d.ts +11 -3
  292. package/dist/local/store/reliability.d.ts.map +1 -1
  293. package/dist/local/store/reliability.js +4 -0
  294. package/dist/local/store/reliability.js.map +1 -1
  295. package/dist/local/store/sqlite/key-storage/index.d.ts +3 -9
  296. package/dist/local/store/sqlite/key-storage/index.d.ts.map +1 -1
  297. package/dist/local/store/sqlite/key-storage/index.js.map +1 -1
  298. package/dist/local/store/sqlite/key-storage/signed-prekeys.d.ts +1 -7
  299. package/dist/local/store/sqlite/key-storage/signed-prekeys.d.ts.map +1 -1
  300. package/dist/local/store/sqlite/key-storage/signed-prekeys.js.map +1 -1
  301. package/dist/local/store/sqlite/models/kyber-prekey.d.ts +4 -9
  302. package/dist/local/store/sqlite/models/kyber-prekey.d.ts.map +1 -1
  303. package/dist/local/store/sqlite/models/kyber-prekey.js +4 -1
  304. package/dist/local/store/sqlite/models/kyber-prekey.js.map +1 -1
  305. package/dist/local/store/sqlite/store.d.ts.map +1 -1
  306. package/dist/local/store/sqlite/store.js +1 -2
  307. package/dist/local/store/sqlite/store.js.map +1 -1
  308. package/dist/remote/signal-relay/connection-state.d.ts +16 -0
  309. package/dist/remote/signal-relay/connection-state.d.ts.map +1 -0
  310. package/dist/remote/{relay → signal-relay}/connection-state.js +1 -1
  311. package/dist/remote/signal-relay/connection-state.js.map +1 -0
  312. package/dist/remote/{relay → signal-relay}/device-set.d.ts +3 -3
  313. package/dist/remote/signal-relay/device-set.d.ts.map +1 -0
  314. package/dist/remote/{relay → signal-relay}/device-set.js +7 -7
  315. package/dist/remote/signal-relay/device-set.js.map +1 -0
  316. package/dist/remote/{relay → signal-relay}/index.d.ts +3 -3
  317. package/dist/remote/signal-relay/index.d.ts.map +1 -0
  318. package/dist/remote/{relay → signal-relay}/index.js +2 -2
  319. package/dist/remote/signal-relay/index.js.map +1 -0
  320. package/dist/remote/{relay → signal-relay}/request-admission.d.ts +7 -5
  321. package/dist/remote/signal-relay/request-admission.d.ts.map +1 -0
  322. package/dist/remote/{relay → signal-relay}/request-admission.js +7 -6
  323. package/dist/remote/signal-relay/request-admission.js.map +1 -0
  324. package/dist/remote/{relay → signal-relay}/types.d.ts +30 -12
  325. package/dist/remote/signal-relay/types.d.ts.map +1 -0
  326. package/dist/remote/{relay → signal-relay}/types.js +1 -1
  327. package/dist/remote/signal-relay/types.js.map +1 -0
  328. package/dist/safety/core.d.ts +1 -1
  329. package/dist/safety/core.js +1 -1
  330. package/dist/types/api.d.ts +43 -20
  331. package/dist/types/api.d.ts.map +1 -1
  332. package/dist/types/errors.d.ts +55 -7
  333. package/dist/types/errors.d.ts.map +1 -1
  334. package/dist/types/errors.js +61 -8
  335. package/dist/types/errors.js.map +1 -1
  336. package/dist/types/renamed-member.d.ts +41 -0
  337. package/dist/types/renamed-member.d.ts.map +1 -0
  338. package/dist/types/renamed-member.js +73 -0
  339. package/dist/types/renamed-member.js.map +1 -0
  340. package/dist/utils/bounded-fan-out.d.ts +2 -2
  341. package/dist/utils/bounded-fan-out.d.ts.map +1 -1
  342. package/dist/utils/bounded-fan-out.js +2 -2
  343. package/dist/utils/bounded-fan-out.js.map +1 -1
  344. package/dist/utils/retry.d.ts +3 -3
  345. package/dist/utils/retry.d.ts.map +1 -1
  346. package/dist/utils/retry.js +4 -3
  347. package/dist/utils/retry.js.map +1 -1
  348. package/docs/ASSURANCE.md +8 -8
  349. package/docs/CLIENT_COMPOSITION.md +11 -7
  350. package/docs/DEVIATIONS.md +58 -8
  351. package/docs/ERROR_HANDLING.md +24 -24
  352. package/docs/GETTING_STARTED.md +25 -16
  353. package/docs/INTERFACES.md +5 -5
  354. package/docs/PACKAGE_SURFACE.md +14 -4
  355. package/docs/PROTOCOL_POLICY.md +4 -4
  356. package/docs/RECIPES.md +274 -15
  357. package/hooks/README.md +11 -11
  358. package/local/store/expo/README.md +1 -1
  359. package/local/store/key-value/README.md +2 -2
  360. package/local/store/node/README.md +1 -1
  361. package/local/store/react-native/README.md +1 -1
  362. package/local/store/web/README.md +1 -1
  363. package/local/store/web-sqlite/README.md +2 -2
  364. package/package.json +22 -7
  365. package/remote/README.md +4 -4
  366. package/remote/object-store/convex-r2/README.md +1 -1
  367. package/remote/{relay → signal-relay}/README.md +16 -6
  368. package/dist/client/relay-acceptance.d.ts.map +0 -1
  369. package/dist/client/relay-acceptance.js.map +0 -1
  370. package/dist/client/relay-device-refusal.d.ts.map +0 -1
  371. package/dist/client/relay-device-refusal.js.map +0 -1
  372. package/dist/client/relay-lifecycle.d.ts.map +0 -1
  373. package/dist/client/relay-lifecycle.js.map +0 -1
  374. package/dist/client/relay-protocol.d.ts.map +0 -1
  375. package/dist/client/relay-protocol.js.map +0 -1
  376. package/dist/client/relay-receipt-intake.d.ts.map +0 -1
  377. package/dist/client/relay-receipt-intake.js.map +0 -1
  378. package/dist/client/relay-receipt-join.d.ts.map +0 -1
  379. package/dist/client/relay-receipt-join.js.map +0 -1
  380. package/dist/client/relay-request-deadline.d.ts.map +0 -1
  381. package/dist/client/relay-request-deadline.js.map +0 -1
  382. package/dist/client/relay-sealed-route.d.ts.map +0 -1
  383. package/dist/client/relay-sealed-route.js.map +0 -1
  384. package/dist/client/relay-subscription.d.ts.map +0 -1
  385. package/dist/client/relay-subscription.js.map +0 -1
  386. package/dist/client/relay-work.d.ts.map +0 -1
  387. package/dist/client/relay-work.js.map +0 -1
  388. package/dist/hooks/use-relay-connection-state.d.ts +0 -32
  389. package/dist/hooks/use-relay-connection-state.d.ts.map +0 -1
  390. package/dist/hooks/use-relay-connection-state.js +0 -31
  391. package/dist/hooks/use-relay-connection-state.js.map +0 -1
  392. package/dist/hooks/use-relay-lifecycle.d.ts +0 -36
  393. package/dist/hooks/use-relay-lifecycle.d.ts.map +0 -1
  394. package/dist/hooks/use-relay-lifecycle.js +0 -35
  395. package/dist/hooks/use-relay-lifecycle.js.map +0 -1
  396. package/dist/remote/relay/connection-state.d.ts +0 -16
  397. package/dist/remote/relay/connection-state.d.ts.map +0 -1
  398. package/dist/remote/relay/connection-state.js.map +0 -1
  399. package/dist/remote/relay/device-set.d.ts.map +0 -1
  400. package/dist/remote/relay/device-set.js.map +0 -1
  401. package/dist/remote/relay/index.d.ts.map +0 -1
  402. package/dist/remote/relay/index.js.map +0 -1
  403. package/dist/remote/relay/request-admission.d.ts.map +0 -1
  404. package/dist/remote/relay/request-admission.js.map +0 -1
  405. package/dist/remote/relay/types.d.ts.map +0 -1
  406. package/dist/remote/relay/types.js.map +0 -1
package/docs/RECIPES.md CHANGED
@@ -10,9 +10,10 @@ uses public exports only.
10
10
 
11
11
  ## Hosted Client Setup
12
12
 
13
- The recipes require a configured Relay project, an identity-assertion callback,
14
- and device-local storage. Use a Sandbox environment for development, where
15
- `hostedRelaySandboxIdentity(storage)` supplies the callback. The
13
+ The recipes require a configured OpenE2EE Signal Protocol Relay project, an
14
+ identity-assertion callback, and device-local storage. Use a Sandbox
15
+ environment for development, where
16
+ `hostedSignalProtocolRelaySandboxIdentity(storage)` supplies the callback. The
16
17
  [getting-started guide](./GETTING_STARTED.md) describes these inputs.
17
18
 
18
19
  ## Application-bound identity callback
@@ -26,7 +27,7 @@ that assertion. Keep provider credentials and signing keys on the backend.
26
27
  import type { GetIdentityAssertion } from "@open-e2ee/signal-protocol-sdk";
27
28
 
28
29
  const getIdentityAssertion: GetIdentityAssertion = async (request) => {
29
- const response = await fetch("https://application.example/api/relay-identity", {
30
+ const response = await fetch("https://application.example/api/signal-relay-identity", {
30
31
  method: "POST",
31
32
  credentials: "include",
32
33
  headers: { "content-type": "application/json" },
@@ -49,17 +50,275 @@ Replace the example application origin with your authenticated backend.
49
50
  Configure its CSRF controls and cookie policy. Do not send a member ID or
50
51
  provider token from this callback as proof of membership.
51
52
 
52
- The [Better Auth recipe](https://docs.open-e2ee.dev/relay/better-auth) uses a
53
+ The browser callback above uses cookies. Native apps (React Native and Expo)
54
+ use the bearer-credential callback in
55
+ [native apps](https://docs.open-e2ee.dev/signal-relay/custom-token#native-apps-react-native-and-expo).
56
+
57
+ The [Better Auth recipe](https://docs.open-e2ee.dev/signal-relay/better-auth) uses a
53
58
  real server session with the cookie cache disabled. The
54
- [backend contract](https://docs.open-e2ee.dev/relay/backend-identity) lists
55
- other provider paths and their evidence levels. Those paths issue custom-token
56
- assertions. They are not native provider adapters in this package.
59
+ [backend contract](https://docs.open-e2ee.dev/signal-relay/backend-identity) lists
60
+ other provider paths and their evidence levels. Those backend paths issue
61
+ custom-token assertions. The [native provider profiles](#native-provider-profiles)
62
+ use the provider token instead.
57
63
 
58
64
  Application logout and assertion refusal do not revoke existing device proofs.
59
65
  To stop identified access on existing devices, follow the
60
- [suspension procedure](https://docs.open-e2ee.dev/relay/backend-identity#suspend-an-identified-account).
66
+ [suspension procedure](https://docs.open-e2ee.dev/signal-relay/backend-identity#suspend-an-identified-account).
61
67
  Anonymous capabilities retain their separate limits.
62
68
 
69
+ ## Native provider profiles
70
+
71
+ A native provider profile lets the OpenE2EE Signal Protocol Relay verify the
72
+ token of the identity provider itself. The browser callback returns that
73
+ token. No application backend signs a Relay-specific assertion.
74
+
75
+ The Signal Protocol Relay accepts Clerk and Firebase sign-in as native
76
+ identity providers in Sandbox and Production. Select Clerk or Firebase as the
77
+ identity source of the environment in the Console before the first device
78
+ registers. The recipes below give the callback and the Relay verifier contract
79
+ for each profile.
80
+
81
+ Relay applies these checks to both providers:
82
+
83
+ - The token is a JWT signed with RS256. Its header has a `kid`. It has no
84
+ `crit`, `jku`, `jwk`, `x5c`, or `x5u` parameter.
85
+ - The `iss` claim matches the configured issuer. The `sub` claim is the user
86
+ ID of the provider. The issuer and the subject together select one Relay
87
+ account.
88
+ - The `iat` and `exp` claims are integers. The token is not expired, and its
89
+ `nbf` claim, when present, is not in the future.
90
+ - Relay records an identifier for each accepted token. With a `jti` claim,
91
+ the identifier is that claim, and the same token in a second SDK operation
92
+ fails with `ASSERTION_REPLAY`. Without `jti`, Relay derives the identifier
93
+ from the token, the purpose, and the SDK operation.
94
+
95
+ The SDK calls the callback to register a device, to recover the account, and
96
+ to advance an identity migration. Each callback in these recipes asks the
97
+ provider for a new token on each call. It refuses a migration request, because
98
+ one provider session cannot serve as both the source and the target of a
99
+ migration.
100
+
101
+ ### Clerk session token callback
102
+
103
+ The profile names the issuer of the Clerk instance and its authorized
104
+ parties. Relay checks these claims of the Clerk session token:
105
+
106
+ | Claim | Relay rule |
107
+ |---|---|
108
+ | `iss` | The public HTTPS origin of the Clerk instance, with no path or port. |
109
+ | `azp` | One of the 1 to 16 configured authorized parties. A profile accepts a token without `azp` only when it also requires an audience. |
110
+ | `aud` | Absent, unless the profile sets an audience. Then it must match. |
111
+ | `sid`, `v`, `nbf` | Required. `v` is `2`. The `sts` claim, when present, is `active`. |
112
+ | `jti` | Optional. |
113
+ | `exp` | At most 10 minutes after `iat`. |
114
+
115
+ Return the session token itself. A token from a JWT template without the
116
+ session claims fails verification.
117
+
118
+ <!-- doc-snippet:run recipes-clerk-identity-callback expect="clerk register=clerk-session-token migration=This callback does not serve identity migration." -->
119
+ ```ts
120
+ // Real protocol and cryptography; simulated in-memory infrastructure.
121
+ import type {
122
+ GetIdentityAssertion,
123
+ IdentityAssertionRequest,
124
+ } from "@open-e2ee/signal-protocol-sdk";
125
+
126
+ // The part of a loaded Clerk instance that the callback reads.
127
+ interface ClerkSessionSource {
128
+ readonly session?: {
129
+ readonly user: { readonly id: string } | null;
130
+ getToken(options: { skipCache: boolean }): Promise<string | null>;
131
+ } | null;
132
+ }
133
+
134
+ function clerkIdentityAssertion(
135
+ clerk: ClerkSessionSource,
136
+ userId: string,
137
+ ): GetIdentityAssertion {
138
+ return async (request: IdentityAssertionRequest) => {
139
+ if (request.migration || request.purpose === "refresh") {
140
+ throw new Error("This callback does not serve identity migration.");
141
+ }
142
+ const session = clerk.session;
143
+ if (!session || session.user?.id !== userId) {
144
+ throw new Error("Sign in as the user of this device store.");
145
+ }
146
+ // Relay refuses an expired or reused token, so ask for a new one.
147
+ const token = await session.getToken({ skipCache: true });
148
+ if (clerk.session?.user?.id !== userId) {
149
+ throw new Error("The signed-in user changed.");
150
+ }
151
+ if (!token) throw new Error("Clerk returned no session token.");
152
+ return token;
153
+ };
154
+ }
155
+
156
+ // In-memory stand-in for a signed-in Clerk instance.
157
+ const clerk: ClerkSessionSource = {
158
+ session: {
159
+ user: { id: "user_example" },
160
+ getToken: async ({ skipCache }) => (skipCache ? "clerk-session-token" : null),
161
+ },
162
+ };
163
+ const getIdentityAssertion = clerkIdentityAssertion(clerk, "user_example");
164
+ const context = { environment: "sandbox", publishableKey: "example" } as const;
165
+ const token = await getIdentityAssertion({ ...context, purpose: "register" });
166
+ const migration = await getIdentityAssertion({
167
+ ...context,
168
+ purpose: "refresh",
169
+ migration: { action: "prepare", providerRole: "target" },
170
+ }).catch((error: Error) => error.message);
171
+ console.log(`clerk register=${token} migration=${migration}`);
172
+ ```
173
+
174
+ Pass the Clerk instance after it loads, and the user ID of the device store.
175
+ For recovery, Relay reads the factor verification ages in the `fva` claim.
176
+ By default, recovery needs a first-factor verification in the last 5 minutes.
177
+ A profile that requires step-up needs a second-factor verification in the
178
+ last 5 minutes. Otherwise, Relay refuses recovery with `AUTHORITY_DENIED`. Ask
179
+ the user to verify again before you start recovery.
180
+
181
+ ### Firebase ID token callback
182
+
183
+ The profile names the Firebase project. Relay checks these claims of the
184
+ Firebase ID token:
185
+
186
+ | Claim | Relay rule |
187
+ |---|---|
188
+ | `iss` | `https://securetoken.google.com/<project id>` |
189
+ | `aud` | The project ID. |
190
+ | `auth_time` | An integer sign-in time, not later than `iat`. |
191
+ | `firebase.sign_in_provider` | Required. |
192
+ | `firebase.tenant` | Absent. Relay refuses a tenant token. |
193
+ | `exp` | At most 1 hour after `iat`. |
194
+
195
+ Relay accepts project-level tokens only. Sign users in to the project itself,
196
+ not to a tenant.
197
+
198
+ <!-- doc-snippet:run recipes-firebase-identity-callback expect="firebase register=firebase-id-token migration=This callback does not serve identity migration." -->
199
+ ```ts
200
+ // Real protocol and cryptography; simulated in-memory infrastructure.
201
+ import type {
202
+ GetIdentityAssertion,
203
+ IdentityAssertionRequest,
204
+ } from "@open-e2ee/signal-protocol-sdk";
205
+
206
+ // The part of a Firebase Auth instance that the callback reads.
207
+ interface FirebaseUserSource {
208
+ readonly currentUser: {
209
+ readonly uid: string;
210
+ getIdToken(forceRefresh?: boolean): Promise<string>;
211
+ } | null;
212
+ }
213
+
214
+ function firebaseIdentityAssertion(
215
+ auth: FirebaseUserSource,
216
+ uid: string,
217
+ ): GetIdentityAssertion {
218
+ return async (request: IdentityAssertionRequest) => {
219
+ if (request.migration || request.purpose === "refresh") {
220
+ throw new Error("This callback does not serve identity migration.");
221
+ }
222
+ const user = auth.currentUser;
223
+ if (!user || user.uid !== uid) {
224
+ throw new Error("Sign in as the user of this device store.");
225
+ }
226
+ // Relay refuses an expired or reused token, so ask for a new one.
227
+ const token = await user.getIdToken(true);
228
+ if (auth.currentUser?.uid !== uid) {
229
+ throw new Error("The signed-in user changed.");
230
+ }
231
+ return token;
232
+ };
233
+ }
234
+
235
+ // In-memory stand-in for a signed-in Firebase Auth instance.
236
+ const auth: FirebaseUserSource = {
237
+ currentUser: {
238
+ uid: "uid-example",
239
+ getIdToken: async (forceRefresh) =>
240
+ forceRefresh ? "firebase-id-token" : "cached-id-token",
241
+ },
242
+ };
243
+ const getIdentityAssertion = firebaseIdentityAssertion(auth, "uid-example");
244
+ const context = { environment: "sandbox", publishableKey: "example" } as const;
245
+ const token = await getIdentityAssertion({ ...context, purpose: "register" });
246
+ const migration = await getIdentityAssertion({
247
+ ...context,
248
+ purpose: "refresh",
249
+ migration: { action: "prepare", providerRole: "target" },
250
+ }).catch((error: Error) => error.message);
251
+ console.log(`firebase register=${token} migration=${migration}`);
252
+ ```
253
+
254
+ Pass the Auth instance and the user ID of the device store. For recovery,
255
+ Relay reads the sign-in time in `auth_time`. By default, recovery needs a
256
+ sign-in in the last 5 minutes. A profile that requires step-up also needs the
257
+ `firebase.sign_in_second_factor` claim. Otherwise, Relay refuses recovery
258
+ with `AUTHORITY_DENIED`. Ask the user to sign in again before you start
259
+ recovery.
260
+
261
+ ### Native provider lifecycle
262
+
263
+ Open one device store for each provider user, and stop the client at sign-out:
264
+
265
+ <!-- doc-snippet:skip requires-external-context -->
266
+ ```ts
267
+ import { createHostedSignalProtocolClient } from "@open-e2ee/signal-protocol-sdk";
268
+ import { webSqliteStore } from "@open-e2ee/signal-protocol-sdk/local/store/web-sqlite";
269
+
270
+ // An application-chosen name for this provider user, within the store name rules.
271
+ const storage = await webSqliteStore({ name: storeName });
272
+ const signal = await createHostedSignalProtocolClient({
273
+ adapters: { storage },
274
+ hosted: {
275
+ signalProtocolRelayUrl,
276
+ getIdentityAssertion: firebaseIdentityAssertion(auth, uid),
277
+ },
278
+ });
279
+
280
+ // At provider sign-out, stop the client before another user signs in.
281
+ await signal.stop();
282
+ ```
283
+
284
+ These rules apply to Clerk and Firebase profiles:
285
+
286
+ - **Token refresh.** A registered device resumes its session with its device
287
+ key. The SDK does not call the callback for a resume. A provider token
288
+ refresh or expiry does not change a registered device.
289
+ - **Sign-out.** Provider sign-out does not revoke the device. The store
290
+ resumes its account without the callback. A shared store would give the
291
+ next user the account of the previous user. To stop access on existing
292
+ devices, follow the
293
+ [suspension procedure](https://docs.open-e2ee.dev/signal-relay/backend-identity#suspend-an-identified-account).
294
+ - **Reinstall or lost store.** A new store registers a new device of the same
295
+ account. It has a new Signal identity key, no earlier sessions, and no
296
+ message history. Peers must verify and accept the new key. The earlier
297
+ devices stay active with the old key. Until the earlier devices are removed,
298
+ or until recovery, peers cannot send to all devices of the account. A peer
299
+ that accepted the new key gets `UNTRUSTED_IDENTITY` when it sends to an
300
+ earlier device. A peer that has not accepted it cannot decrypt messages from
301
+ the new device. To keep the account identity, use device linking. Each
302
+ registration reserves one of the five device IDs of the account for good.
303
+ See [Signal Protocol Relay device errors](./ERROR_HANDLING.md#signal-protocol-relay-device-errors).
304
+ - **Device linking.** To keep the account identity on a new device, move the
305
+ identity from an existing device and call `linkHostedSignalProtocolRelayDevice`. Your
306
+ application owns that transfer.
307
+ - **Recovery.** Create the client with `assertionPurpose: "recover"` when no
308
+ device of the account remains. Recovery revokes all earlier devices of the
309
+ account and returns device ID 1. The device ID reservation applies to
310
+ registrations, so recovery starts again at device 1. Recovery does not
311
+ restore message plaintext or sessions. Your application decides when to
312
+ start it. Recovery needs a recent provider sign-in. Sign the user in again
313
+ before you start recovery. Relay refuses a sign-in older than the recovery
314
+ window with HTTP 401 `AUTHORITY_DENIED`. See
315
+ [device lifecycle and recovery](https://docs.open-e2ee.dev/signal-relay/device-lifecycle-and-recovery).
316
+ - **Provider change.** A different provider, Clerk instance, or Firebase
317
+ project gives a different issuer or subject. Relay treats it as a different
318
+ account. An environment keeps its identity profile after its first
319
+ registration. To use another provider, start a new project. See
320
+ [in-use environments](https://docs.open-e2ee.dev/signal-relay/identity#in-use-environments).
321
+
63
322
  ## Production composition with Expo on the Signal Protocol Relay
64
323
 
65
324
  <!-- doc-snippet:skip requires-external-context -->
@@ -74,8 +333,8 @@ const signal = await createHostedSignalProtocolClient({
74
333
  },
75
334
  hosted: {
76
335
  // The environment-scoped connection URL from the OpenE2EE console.
77
- relayUrl: process.env.EXPO_PUBLIC_OPEN_E2EE_RELAY_URL!,
78
- // Returns a short-lived signed assertion for the signed-in user.
336
+ signalProtocolRelayUrl: process.env.EXPO_PUBLIC_OPEN_E2EE_SIGNAL_RELAY_URL ?? process.env.EXPO_PUBLIC_OPEN_E2EE_RELAY_URL!,
337
+ // The native app callback: https://docs.open-e2ee.dev/signal-relay/custom-token#native-apps-react-native-and-expo
79
338
  getIdentityAssertion,
80
339
  },
81
340
  });
@@ -90,7 +349,7 @@ must complete the [database setup](../local/store/expo/README.md) first.
90
349
  ```ts
91
350
  const signal = await createSignalProtocolClient({
92
351
  identity: { userId },
93
- adapters: { storage, relay },
352
+ adapters: { storage, signalProtocolRelay },
94
353
  });
95
354
 
96
355
  // Upload public prekeys before other devices need to message this device.
@@ -107,7 +366,7 @@ signal.registerHook("onMessageDecrypted", async (message) => {
107
366
  });
108
367
 
109
368
  // Subscribing starts encrypted envelope delivery and local decryption.
110
- signal.startRelaySubscription();
369
+ signal.startSignalProtocolRelaySubscription();
111
370
 
112
371
  await signal.send(recipientUserId, "hello");
113
372
  ```
@@ -121,7 +380,7 @@ message storage through hooks.
121
380
  ```ts
122
381
  await createSignalProtocolClient({
123
382
  identity: { userId },
124
- adapters: { storage, relay },
383
+ adapters: { storage, signalProtocolRelay },
125
384
  protocol: {
126
385
  postQuantum: "required",
127
386
  braid: "required",
@@ -142,7 +401,7 @@ agreement, so a peer that advertises no post-quantum material fails with
142
401
  ```ts
143
402
  await createSignalProtocolClient({
144
403
  identity: { userId },
145
- adapters: { storage, relay },
404
+ adapters: { storage, signalProtocolRelay },
146
405
  protocol: {
147
406
  postQuantum: "required",
148
407
  braid: "disabled",
package/hooks/README.md CHANGED
@@ -24,21 +24,21 @@ npm install react react-native
24
24
 
25
25
  ```tsx
26
26
  import {
27
- useRelayConnectionState,
28
- useRelayLifecycle,
27
+ useSignalProtocolRelayConnectionState,
28
+ useSignalProtocolRelayLifecycle,
29
29
  useSessionHealth,
30
- type UseRelayLifecycleOptions,
31
- type UseRelayConnectionStateOptions,
30
+ type UseSignalProtocolRelayLifecycleOptions,
31
+ type UseSignalProtocolRelayConnectionStateOptions,
32
32
  type UseSessionHealthOptions,
33
33
  } from "@open-e2ee/signal-protocol-sdk/hooks";
34
34
 
35
- function SignalLifecycle({ signal }: Pick<UseRelayLifecycleOptions, "signal">) {
36
- useRelayLifecycle({ signal });
35
+ function SignalLifecycle({ signal }: Pick<UseSignalProtocolRelayLifecycleOptions, "signal">) {
36
+ useSignalProtocolRelayLifecycle({ signal });
37
37
  return null;
38
38
  }
39
39
 
40
- function OwnConnectionDot({ signal }: Pick<UseRelayConnectionStateOptions, "signal">) {
41
- const { state } = useRelayConnectionState({ signal });
40
+ function OwnConnectionDot({ signal }: Pick<UseSignalProtocolRelayConnectionStateOptions, "signal">) {
41
+ const { state } = useSignalProtocolRelayConnectionState({ signal });
42
42
  return <Dot online={state === "connected"} />;
43
43
  }
44
44
 
@@ -51,7 +51,7 @@ function ConversationStatus({ signal, userId }: Pick<UseSessionHealthOptions, "s
51
51
 
52
52
  ## Relay connection state
53
53
 
54
- `useRelayConnectionState({ signal })` returns the `RelayConnectionState` of
54
+ `useSignalProtocolRelayConnectionState({ signal })` returns the `SignalProtocolRelayConnectionState` of
55
55
  the relay subscription on this device. The component renders again on each
56
56
  transition, and the hook unsubscribes when the component unmounts. The state
57
57
  is `stopped`, `connecting`, `connected`, or `reconnecting`. A `reason` tells
@@ -60,7 +60,7 @@ is not presence and does not tell you about other users.
60
60
 
61
61
  ## Relay lifecycle
62
62
 
63
- `useRelayLifecycle({ signal })` stops the relay subscription when a React
63
+ `useSignalProtocolRelayLifecycle({ signal })` stops the relay subscription when a React
64
64
  Native app goes to the background and starts it again when the app becomes
65
65
  active. The stop closes the socket with code 1000, so the Relay records a
66
66
  client close. The Relay replays retained messages when the app becomes active.
@@ -69,7 +69,7 @@ a hidden desktop tab keeps its socket open by itself.
69
69
 
70
70
  Set `keepOpenInBackground: true` to keep the socket open in the background,
71
71
  for example while an Android foreground service runs. Outside React, call
72
- `bindRelayLifecycle(signal, AppState)` from
72
+ `bindSignalProtocolRelayLifecycle(signal, AppState)` from
73
73
  `@open-e2ee/signal-protocol-sdk/client`.
74
74
 
75
75
  Do not call these hooks outside React components or custom hooks. Event callbacks from
@@ -171,7 +171,7 @@ import { expoStore } from '@open-e2ee/signal-protocol-sdk/local/store/expo';
171
171
 
172
172
  const client = await createSignalProtocolClient({
173
173
  identity: { userId },
174
- adapters: { storage: await expoStore(), relay },
174
+ adapters: { storage: await expoStore(), signalProtocolRelay },
175
175
  });
176
176
  ```
177
177
 
@@ -21,7 +21,7 @@ The store gets random bytes from the global `crypto.getRandomValues`. Install
21
21
  it at app startup before the first SDK call. Without a global source, the SDK
22
22
  throws `SecureRandomUnavailableError`. The store needs no `crypto.subtle`
23
23
  polyfill. AES-256-GCM uses Web Crypto when `crypto.subtle` exists and the
24
- bundled Noble implementation otherwise. The [README](../../../README.md#use-your-apps-storage-and-relay)
24
+ bundled Noble implementation otherwise. The [README](../../../README.md#use-your-apps-storage-and-message-delivery)
25
25
  lists the supported React Native versions.
26
26
 
27
27
  The store also needs a `SignalProtocolLocalSecretVault` backed by the platform
@@ -47,7 +47,7 @@ const storage = await keyValueStore({ storage: keyValueStorage, vault });
47
47
 
48
48
  const client = await createSignalProtocolClient({
49
49
  identity: { userId },
50
- adapters: { storage, relay },
50
+ adapters: { storage, signalProtocolRelay },
51
51
  });
52
52
  ```
53
53
 
@@ -292,7 +292,7 @@ import { nodeStore } from '@open-e2ee/signal-protocol-sdk/local/store/node';
292
292
 
293
293
  const client = await createSignalProtocolClient({
294
294
  identity: { userId },
295
- adapters: { storage: await nodeStore({ directory, vault }), relay },
295
+ adapters: { storage: await nodeStore({ directory, vault }), signalProtocolRelay },
296
296
  });
297
297
  ```
298
298
 
@@ -189,7 +189,7 @@ import { reactNativeStore } from '@open-e2ee/signal-protocol-sdk/local/store/rea
189
189
 
190
190
  const client = await createSignalProtocolClient({
191
191
  identity: { userId },
192
- adapters: { storage: await reactNativeStore(), relay },
192
+ adapters: { storage: await reactNativeStore(), signalProtocolRelay },
193
193
  });
194
194
  ```
195
195
 
@@ -29,7 +29,7 @@ const storage = await indexedDbStore();
29
29
 
30
30
  const client = await createSignalProtocolClient({
31
31
  identity: { userId },
32
- adapters: { storage, relay },
32
+ adapters: { storage, signalProtocolRelay },
33
33
  });
34
34
  ```
35
35
 
@@ -28,7 +28,7 @@ const storage = await webSqliteStore();
28
28
 
29
29
  const client = await createSignalProtocolClient({
30
30
  identity: { userId },
31
- adapters: { storage, relay },
31
+ adapters: { storage, signalProtocolRelay },
32
32
  });
33
33
  ```
34
34
 
@@ -107,7 +107,7 @@ To recover, delete the file and link the device again:
107
107
  file, creates a new key, and returns the open, empty store. The identity
108
108
  and the sessions of the device go with the file.
109
109
  3. Put the account identity into the new store, then call
110
- `linkHostedRelayDevice()` with it. This needs another device that holds the
110
+ `linkHostedSignalProtocolRelayDevice()` with it. This needs another device that holds the
111
111
  account identity. See
112
112
  [Link a device](../../../device/README.md#link-a-device).
113
113
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@open-e2ee/signal-protocol-sdk",
3
- "version": "14.0.0",
3
+ "version": "14.2.0",
4
4
  "description": "Pure TypeScript Signal Protocol SDK for encrypted chat in Expo, React Native, browsers, and Node. Post-quantum by default.",
5
5
  "keywords": [
6
6
  "open-e2ee",
@@ -23,6 +23,8 @@
23
23
  "messaging",
24
24
  "sealed-sender",
25
25
  "sdk",
26
+ "clerk",
27
+ "firebase",
26
28
  "forward-secrecy"
27
29
  ],
28
30
  "license": "(MIT OR Apache-2.0)",
@@ -55,13 +57,21 @@
55
57
  "types": "./dist/index.d.ts",
56
58
  "default": "./dist/index.js"
57
59
  },
60
+ "./remote/signal-relay": {
61
+ "types": "./dist/remote/signal-relay/index.d.ts",
62
+ "default": "./dist/remote/signal-relay/index.js"
63
+ },
64
+ "./remote/signal-relay/types": {
65
+ "types": "./dist/remote/signal-relay/types.d.ts",
66
+ "default": "./dist/remote/signal-relay/types.js"
67
+ },
58
68
  "./remote/relay": {
59
- "types": "./dist/remote/relay/index.d.ts",
60
- "default": "./dist/remote/relay/index.js"
69
+ "types": "./dist/remote/signal-relay/index.d.ts",
70
+ "default": "./dist/remote/signal-relay/index.js"
61
71
  },
62
72
  "./remote/relay/types": {
63
- "types": "./dist/remote/relay/types.d.ts",
64
- "default": "./dist/remote/relay/types.js"
73
+ "types": "./dist/remote/signal-relay/types.d.ts",
74
+ "default": "./dist/remote/signal-relay/types.js"
65
75
  },
66
76
  "./client": {
67
77
  "types": "./dist/client/index.d.ts",
@@ -329,7 +339,7 @@
329
339
  "remote/object-store/README.md",
330
340
  "remote/object-store/convex-r2/README.md",
331
341
  "remote/object-store/s3/README.md",
332
- "remote/relay/README.md",
342
+ "remote/signal-relay/README.md",
333
343
  "safety/README.md",
334
344
  "sealed-sender/README.md",
335
345
  "types/README.md",
@@ -422,8 +432,13 @@
422
432
  "xcode": {
423
433
  "uuid": "11.1.1"
424
434
  },
435
+ "@expo/cli": {
436
+ "zod": "^4.6.6"
437
+ },
425
438
  "brace-expansion": "^5.0.12",
426
- "image-size": "file:./vendor/image-size-disabled"
439
+ "glob": "^14.0.2",
440
+ "image-size": "file:./vendor/image-size-disabled",
441
+ "minimatch": "^11.0.1"
427
442
  },
428
443
  "devDependencies": {
429
444
  "@op-engineering/op-sqlite": "^18.2.5",
package/remote/README.md CHANGED
@@ -40,7 +40,7 @@ const signal = await createHostedSignalProtocolClient({
40
40
  },
41
41
  hosted: {
42
42
  // The environment-scoped connection URL from the OpenE2EE console.
43
- relayUrl: process.env.EXPO_PUBLIC_OPEN_E2EE_RELAY_URL!,
43
+ signalProtocolRelayUrl: process.env.EXPO_PUBLIC_OPEN_E2EE_SIGNAL_RELAY_URL ?? process.env.EXPO_PUBLIC_OPEN_E2EE_RELAY_URL!,
44
44
  // Returns a short-lived signed assertion for the signed-in user.
45
45
  getIdentityAssertion,
46
46
  },
@@ -101,7 +101,7 @@ import { api } from "../convex/_generated/api";
101
101
 
102
102
  const signal = await DefaultSignalProtocolClient.create(userId, {
103
103
  storage,
104
- relay,
104
+ signalProtocolRelay,
105
105
  remoteObjectStore: convexR2ObjectStore({
106
106
  convex,
107
107
  api: api.signalObjectStore,
@@ -149,7 +149,7 @@ needed to authorize and construct short-lived operations.
149
149
  `oe new` writes a Sandbox connection URL to `.env.local`. Pass it to
150
150
  `createHostedSignalProtocolClient()` with the device-local store that your
151
151
  application uses for production. A Sandbox environment uses device-owned
152
- identity, so pass `hostedRelaySandboxIdentity(storage)` as
152
+ identity, so pass `hostedSignalProtocolRelaySandboxIdentity(storage)` as
153
153
  `hosted.getIdentityAssertion`.
154
154
 
155
155
  ## Related Docs
@@ -157,5 +157,5 @@ identity, so pass `hostedRelaySandboxIdentity(storage)` as
157
157
  - [README](../README.md)
158
158
  - [ADAPTERS](../ADAPTERS.md)
159
159
  - [local/store/README.md](../local/store/README.md)
160
- - [Relay Guide](./relay/README.md)
160
+ - [Relay Guide](./signal-relay/README.md)
161
161
  - [Object Store Guide](./object-store/README.md)
@@ -29,7 +29,7 @@ const client = await createSignalProtocolClient({
29
29
  identity: { userId },
30
30
  adapters: {
31
31
  storage,
32
- relay,
32
+ signalProtocolRelay,
33
33
  remoteObjectStore: convexR2ObjectStore({
34
34
  convex,
35
35
  api: api.signalObjectStore,
@@ -22,17 +22,21 @@ import { createHostedSignalProtocolClient } from "@open-e2ee/signal-protocol-sdk
22
22
  const signal = await createHostedSignalProtocolClient({
23
23
  adapters: { storage },
24
24
  hosted: {
25
- relayUrl,
25
+ signalProtocolRelayUrl,
26
26
  getIdentityAssertion,
27
27
  },
28
28
  });
29
29
  ```
30
30
 
31
- `oe new` writes `relayUrl` to `.env.local` as `OPEN_E2EE_RELAY_URL`, with the
32
- public prefix of the framework in a Next.js, Expo, or Vite application. Supply
33
- `storage` for this device and `getIdentityAssertion`. In a Sandbox environment,
34
- pass `hostedRelaySandboxIdentity(storage)`. In production, pass the callback of
35
- your identity provider.
31
+ `oe new` writes `signalProtocolRelayUrl` to `.env.local` as `OPEN_E2EE_SIGNAL_RELAY_URL`,
32
+ with the public prefix of the framework in a Next.js, Expo, or Vite
33
+ application. An `oe` release before 5.0.0 wrote the earlier name,
34
+ `OPEN_E2EE_RELAY_URL`. Read the new name first and the earlier name second.
35
+ Supply `storage` for this device and `getIdentityAssertion`. In a Sandbox environment,
36
+ pass `hostedSignalProtocolRelaySandboxIdentity(storage)`. In a production project in
37
+ device-owned mode, pass `hostedSignalProtocolRelayDeviceOwnedIdentity(storage)`. In a
38
+ production project in application-bound mode, pass a callback that returns an
39
+ assertion from your backend.
36
40
 
37
41
  For advanced integrations, implement the `SignalProtocolRelayServer` client
38
42
  transport against your own backend. That backend must authenticate
@@ -43,5 +47,11 @@ metadata.
43
47
  The published package contains client transports and contracts. It does not
44
48
  include a relay server implementation.
45
49
 
50
+ The module entry is `@open-e2ee/signal-protocol-sdk/remote/signal-relay`, and
51
+ its types are at `@open-e2ee/signal-protocol-sdk/remote/signal-relay/types`.
52
+ The earlier subpaths `@open-e2ee/signal-protocol-sdk/remote/relay` and
53
+ `@open-e2ee/signal-protocol-sdk/remote/relay/types` load the same modules. They
54
+ are deprecated, and SDK 15.0.0 removes them.
55
+
46
56
  See the [remote guide](../README.md), [interface guide](../../docs/INTERFACES.md),
47
57
  and [API reference](../../docs/api/README.md).
@@ -1 +0,0 @@
1
- {"version":3,"file":"relay-acceptance.d.ts","sourceRoot":"","sources":["../../client/relay-acceptance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAGxF,8DAA8D;AAC9D,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,qFAAqF;IACrF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,4EAA4E;IAC5E,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,SAAS,IAAI,CAAC,mBAAmB,EAAE,WAAW,GAAG,WAAW,CAAC,EAAE,GACrE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAY7C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,qBAAqB,GAC7B,mBAAmB,GACnB,gBAAgB,GAChB,2BAA2B,CAAC;AAIhC;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,eAAe,EAAE,MAAM,EACvB,eAAe,EAAE,MAAM,GACtB,mBAAmB,CAIrB;AAED,6DAA6D;AAC7D,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAE7E;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,SAAS,mBAAmB,EAAE,GAC1C,mBAAmB,GAAG,SAAS,CAEjC;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,qBAAqB,GAAG,SAAS,CAQvF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAG3D;AAED,iFAAiF;AACjF,MAAM,MAAM,uBAAuB,GAC/B;IAAE,QAAQ,EAAE,kBAAkB,CAAA;CAAE,GAChC;IAAE,KAAK,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAmBjC;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,OAAO,GAAG,uBAAuB,CAkBvF"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"relay-acceptance.js","sourceRoot":"","sources":["../../client/relay-acceptance.ts"],"names":[],"mappings":"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"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"relay-device-refusal.d.ts","sourceRoot":"","sources":["../../client/relay-device-refusal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,gDAAgD;AAChD,MAAM,WAAW,kBAAkB;IACjC,uFAAuF;IACvF,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAKD,gFAAgF;AAChF,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAEhE;AAED,sFAAsF;AACtF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,kFAAkF;AAClF,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,kBAAkB,GAAG,CAAC,CAGhG;AAED,6DAA6D;AAC7D,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,GAAG,SAAS,CAEjF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAS5D;AAED;;;;;GAKG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IAI/C,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM;IAJ3B,SAAkB,IAAI,8BAA8B;IAEpD,YACW,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EACzB,KAAK,EAAE,OAAO,EAGf;CACF"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"relay-device-refusal.js","sourceRoot":"","sources":["../../client/relay-device-refusal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAaH,MAAM,cAAc,GAAG,IAAI,OAAO,EAAU,CAAC;AAC7C,MAAM,QAAQ,GAAG,IAAI,OAAO,EAA8B,CAAC;AAE3D,gFAAgF;AAChF,MAAM,UAAU,4BAA4B,CAAC,KAAa;IACxD,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,OAAO,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,sBAAsB,CAAkB,KAAQ,EAAE,OAA2B;IAC3F,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACvF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,IAAI,KAAK,cAAc;QAAE,OAAO,IAAI,CAAC;IACpE,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACpF,MAAM,EAAE,IAAI,EAAE,GAAG,KAA0B,CAAC;IAC5C,OAAO,CACL,IAAI,KAAK,IAAI;QACb,OAAO,IAAI,KAAK,QAAQ;QACvB,IAA2B,CAAC,IAAI,KAAK,cAAc,CACrD,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IAItC,MAAM;IACN,QAAQ;IAJD,IAAI,GAAG,0BAA0B,CAAC;IAEpD,YACW,MAAc,EACd,QAAgB,EACzB,KAAc;QAEd,KAAK,CAAC,iCAAiC,QAAQ,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;sBAJ5D,MAAM;wBACN,QAAQ;IAInB,CAAC;CACF"}