@open-e2ee/signal-protocol-sdk 2.0.1 → 3.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 (410) hide show
  1. package/ADAPTERS.md +10 -17
  2. package/ARCHITECTURE.md +1 -2
  3. package/CHANGELOG.md +80 -0
  4. package/LICENSE +11 -655
  5. package/LICENSE-APACHE +201 -0
  6. package/LICENSE-MIT +21 -0
  7. package/NOTICE +5 -7
  8. package/README.md +11 -11
  9. package/SECURITY.md +2 -2
  10. package/TROUBLESHOOTING.md +2 -6
  11. package/client/README.md +34 -16
  12. package/device/README.md +1 -1
  13. package/dist/client/client.d.ts +13 -2
  14. package/dist/client/client.d.ts.map +1 -1
  15. package/dist/client/client.js +136 -73
  16. package/dist/client/client.js.map +1 -1
  17. package/dist/client/config.d.ts +14 -18
  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 +2 -0
  21. package/dist/client/content-adapter.d.ts.map +1 -1
  22. package/dist/client/content-adapter.js +4 -0
  23. package/dist/client/content-adapter.js.map +1 -1
  24. package/dist/client/endorsement-manager.d.ts +4 -1
  25. package/dist/client/endorsement-manager.d.ts.map +1 -1
  26. package/dist/client/endorsement-manager.js +14 -6
  27. package/dist/client/endorsement-manager.js.map +1 -1
  28. package/dist/client/group-authority.d.ts +8 -0
  29. package/dist/client/group-authority.d.ts.map +1 -0
  30. package/dist/client/group-authority.js +2 -0
  31. package/dist/client/group-authority.js.map +1 -0
  32. package/dist/client/headless.d.ts +3 -8
  33. package/dist/client/headless.d.ts.map +1 -1
  34. package/dist/client/headless.js +3 -8
  35. package/dist/client/headless.js.map +1 -1
  36. package/dist/client/hosted-anonymous-delivery.d.ts +32 -0
  37. package/dist/client/hosted-anonymous-delivery.d.ts.map +1 -0
  38. package/dist/client/hosted-anonymous-delivery.js +239 -0
  39. package/dist/client/hosted-anonymous-delivery.js.map +1 -0
  40. package/dist/client/hosted-connection.d.ts +1 -1
  41. package/dist/client/hosted-connection.d.ts.map +1 -1
  42. package/dist/client/hosted-connection.js +18 -51
  43. package/dist/client/hosted-connection.js.map +1 -1
  44. package/dist/client/hosted-group-authority.d.ts +11 -0
  45. package/dist/client/hosted-group-authority.d.ts.map +1 -0
  46. package/dist/client/hosted-group-authority.js +96 -0
  47. package/dist/client/hosted-group-authority.js.map +1 -0
  48. package/dist/client/hosted-groups.d.ts +31 -0
  49. package/dist/client/hosted-groups.d.ts.map +1 -0
  50. package/dist/client/hosted-groups.js +217 -0
  51. package/dist/client/hosted-groups.js.map +1 -0
  52. package/dist/client/hosted-mailbox-subscription.d.ts +34 -0
  53. package/dist/client/hosted-mailbox-subscription.d.ts.map +1 -0
  54. package/dist/client/hosted-mailbox-subscription.js +257 -0
  55. package/dist/client/hosted-mailbox-subscription.js.map +1 -0
  56. package/dist/client/hosted-prekey-publication.d.ts +51 -0
  57. package/dist/client/hosted-prekey-publication.d.ts.map +1 -0
  58. package/dist/client/hosted-prekey-publication.js +249 -0
  59. package/dist/client/hosted-prekey-publication.js.map +1 -0
  60. package/dist/client/hosted-push.d.ts +4 -5
  61. package/dist/client/hosted-push.d.ts.map +1 -1
  62. package/dist/client/hosted-push.js +22 -22
  63. package/dist/client/hosted-push.js.map +1 -1
  64. package/dist/client/hosted-transport.d.ts +57 -35
  65. package/dist/client/hosted-transport.d.ts.map +1 -1
  66. package/dist/client/hosted-transport.js +666 -341
  67. package/dist/client/hosted-transport.js.map +1 -1
  68. package/dist/client/hosted-trust.d.ts +29 -0
  69. package/dist/client/hosted-trust.d.ts.map +1 -0
  70. package/dist/client/hosted-trust.js +28 -0
  71. package/dist/client/hosted-trust.js.map +1 -0
  72. package/dist/client/hosted.d.ts +18 -13
  73. package/dist/client/hosted.d.ts.map +1 -1
  74. package/dist/client/hosted.js +78 -34
  75. package/dist/client/hosted.js.map +1 -1
  76. package/dist/client/index.d.ts +14 -14
  77. package/dist/client/index.d.ts.map +1 -1
  78. package/dist/client/index.js +7 -7
  79. package/dist/client/index.js.map +1 -1
  80. package/dist/client/key-rotation-core.d.ts +8 -0
  81. package/dist/client/key-rotation-core.d.ts.map +1 -1
  82. package/dist/client/key-rotation-core.js +12 -1
  83. package/dist/client/key-rotation-core.js.map +1 -1
  84. package/dist/client/key-rotation.d.ts +2 -1
  85. package/dist/client/key-rotation.d.ts.map +1 -1
  86. package/dist/client/key-rotation.js +4 -4
  87. package/dist/client/key-rotation.js.map +1 -1
  88. package/dist/client/media-queue-persistence.d.ts +14 -0
  89. package/dist/client/media-queue-persistence.d.ts.map +1 -0
  90. package/dist/client/media-queue-persistence.js +123 -0
  91. package/dist/client/media-queue-persistence.js.map +1 -0
  92. package/dist/client/media-upload-budget.d.ts +3 -0
  93. package/dist/client/media-upload-budget.d.ts.map +1 -0
  94. package/dist/client/media-upload-budget.js +27 -0
  95. package/dist/client/media-upload-budget.js.map +1 -0
  96. package/dist/client/media.d.ts +51 -15
  97. package/dist/client/media.d.ts.map +1 -1
  98. package/dist/client/media.js +541 -73
  99. package/dist/client/media.js.map +1 -1
  100. package/dist/client/messages.d.ts.map +1 -1
  101. package/dist/client/messages.js +13 -14
  102. package/dist/client/messages.js.map +1 -1
  103. package/dist/client/prekeys.d.ts.map +1 -1
  104. package/dist/client/prekeys.js +131 -43
  105. package/dist/client/prekeys.js.map +1 -1
  106. package/dist/client/relay-subscription.d.ts +4 -0
  107. package/dist/client/relay-subscription.d.ts.map +1 -1
  108. package/dist/client/relay-subscription.js +58 -25
  109. package/dist/client/relay-subscription.js.map +1 -1
  110. package/dist/client/sender-key-distribution.d.ts +8 -0
  111. package/dist/client/sender-key-distribution.d.ts.map +1 -0
  112. package/dist/client/sender-key-distribution.js +59 -0
  113. package/dist/client/sender-key-distribution.js.map +1 -0
  114. package/dist/client/signal-service-cipher.d.ts +7 -3
  115. package/dist/client/signal-service-cipher.d.ts.map +1 -1
  116. package/dist/client/signal-service-cipher.js +41 -16
  117. package/dist/client/signal-service-cipher.js.map +1 -1
  118. package/dist/device/{expo-metadata.d.ts → expo/index.d.ts} +3 -3
  119. package/dist/device/expo/index.d.ts.map +1 -0
  120. package/dist/device/{expo-metadata.js → expo/index.js} +2 -2
  121. package/dist/device/expo/index.js.map +1 -0
  122. package/dist/device/index.js +1 -1
  123. package/dist/device/index.js.map +1 -1
  124. package/dist/device/provisioning.d.ts +1 -1
  125. package/dist/device/provisioning.js +1 -1
  126. package/dist/device/types.d.ts +1 -1
  127. package/dist/groups/server.d.ts +10 -0
  128. package/dist/groups/server.d.ts.map +1 -0
  129. package/dist/groups/server.js +6 -0
  130. package/dist/groups/server.js.map +1 -0
  131. package/dist/hooks/use-connection-presence.d.ts +2 -4
  132. package/dist/hooks/use-connection-presence.d.ts.map +1 -1
  133. package/dist/hooks/use-connection-presence.js +2 -4
  134. package/dist/hooks/use-connection-presence.js.map +1 -1
  135. package/dist/index.d.ts +51 -49
  136. package/dist/index.d.ts.map +1 -1
  137. package/dist/index.js +25 -24
  138. package/dist/index.js.map +1 -1
  139. package/dist/internal/groups/authority-certificate.d.ts +22 -0
  140. package/dist/internal/groups/authority-certificate.d.ts.map +1 -0
  141. package/dist/internal/groups/authority-certificate.js +99 -0
  142. package/dist/internal/groups/authority-certificate.js.map +1 -0
  143. package/dist/internal/groups/error-details.d.ts +9 -0
  144. package/dist/internal/groups/error-details.d.ts.map +1 -0
  145. package/dist/internal/groups/error-details.js +30 -0
  146. package/dist/internal/groups/error-details.js.map +1 -0
  147. package/dist/internal/groups/manager.d.ts +5 -0
  148. package/dist/internal/groups/manager.d.ts.map +1 -1
  149. package/dist/internal/groups/manager.js +3 -0
  150. package/dist/internal/groups/manager.js.map +1 -1
  151. package/dist/internal/groups/server-engine.d.ts +7 -0
  152. package/dist/internal/groups/server-engine.d.ts.map +1 -1
  153. package/dist/internal/groups/server-engine.js +51 -19
  154. package/dist/internal/groups/server-engine.js.map +1 -1
  155. package/dist/internal/groups/wire.d.ts.map +1 -1
  156. package/dist/internal/groups/wire.js +10 -9
  157. package/dist/internal/groups/wire.js.map +1 -1
  158. package/dist/internal/manager/manager.d.ts +1 -1
  159. package/dist/internal/manager/manager.d.ts.map +1 -1
  160. package/dist/internal/manager/manager.js +22 -25
  161. package/dist/internal/manager/manager.js.map +1 -1
  162. package/dist/internal/protocol/sender-keys/manager.d.ts +1 -1
  163. package/dist/internal/protocol/sender-keys/manager.d.ts.map +1 -1
  164. package/dist/internal/protocol/sender-keys/manager.js +27 -14
  165. package/dist/internal/protocol/sender-keys/manager.js.map +1 -1
  166. package/dist/internal/sesame/manager.d.ts +2 -2
  167. package/dist/internal/sesame/manager.d.ts.map +1 -1
  168. package/dist/internal/sesame/manager.js +6 -6
  169. package/dist/internal/sesame/manager.js.map +1 -1
  170. package/dist/internal/sesame/types.d.ts +1 -1
  171. package/dist/internal/sesame/types.d.ts.map +1 -1
  172. package/dist/internal/session/cipher.d.ts +1 -1
  173. package/dist/internal/session/cipher.d.ts.map +1 -1
  174. package/dist/internal/session/cipher.js +31 -28
  175. package/dist/internal/session/cipher.js.map +1 -1
  176. package/dist/layers.d.ts +1 -1
  177. package/dist/layers.d.ts.map +1 -1
  178. package/dist/layers.js +1 -1
  179. package/dist/layers.js.map +1 -1
  180. package/dist/local/store/expo/adapter.d.ts +8 -2
  181. package/dist/local/store/expo/adapter.d.ts.map +1 -1
  182. package/dist/local/store/expo/adapter.js +28 -9
  183. package/dist/local/store/expo/adapter.js.map +1 -1
  184. package/dist/local/store/expo/key-storage.d.ts +7 -1
  185. package/dist/local/store/expo/key-storage.d.ts.map +1 -1
  186. package/dist/local/store/expo/key-storage.js +82 -17
  187. package/dist/local/store/expo/key-storage.js.map +1 -1
  188. package/dist/local/store/expo/models/kyber-prekey-used.d.ts +1 -4
  189. package/dist/local/store/expo/models/kyber-prekey-used.d.ts.map +1 -1
  190. package/dist/local/store/expo/models/kyber-prekey-used.js +23 -9
  191. package/dist/local/store/expo/models/kyber-prekey-used.js.map +1 -1
  192. package/dist/local/store/expo/models/kyber-prekey.d.ts +4 -4
  193. package/dist/local/store/expo/models/kyber-prekey.d.ts.map +1 -1
  194. package/dist/local/store/expo/models/kyber-prekey.js +67 -26
  195. package/dist/local/store/expo/models/kyber-prekey.js.map +1 -1
  196. package/dist/local/store/expo/schema.d.ts +21 -2
  197. package/dist/local/store/expo/schema.d.ts.map +1 -1
  198. package/dist/local/store/expo/schema.js +10 -2
  199. package/dist/local/store/expo/schema.js.map +1 -1
  200. package/dist/local/store/kyber-prekey-lifecycle.d.ts +46 -0
  201. package/dist/local/store/kyber-prekey-lifecycle.d.ts.map +1 -0
  202. package/dist/local/store/kyber-prekey-lifecycle.js +88 -0
  203. package/dist/local/store/kyber-prekey-lifecycle.js.map +1 -0
  204. package/dist/local/store/memory/adapter.d.ts +11 -3
  205. package/dist/local/store/memory/adapter.d.ts.map +1 -1
  206. package/dist/local/store/memory/adapter.js +113 -28
  207. package/dist/local/store/memory/adapter.js.map +1 -1
  208. package/dist/local/store/node/adapter.d.ts +8 -2
  209. package/dist/local/store/node/adapter.d.ts.map +1 -1
  210. package/dist/local/store/node/adapter.js +31 -13
  211. package/dist/local/store/node/adapter.js.map +1 -1
  212. package/dist/local/store/node/database-file-commit.d.ts +8 -0
  213. package/dist/local/store/node/database-file-commit.d.ts.map +1 -0
  214. package/dist/local/store/node/database-file-commit.js +62 -0
  215. package/dist/local/store/node/database-file-commit.js.map +1 -0
  216. package/dist/local/store/node/database-key.d.ts +6 -1
  217. package/dist/local/store/node/database-key.d.ts.map +1 -1
  218. package/dist/local/store/node/database-key.js +79 -44
  219. package/dist/local/store/node/database-key.js.map +1 -1
  220. package/dist/local/store/node/database-lock.d.ts +8 -0
  221. package/dist/local/store/node/database-lock.d.ts.map +1 -0
  222. package/dist/local/store/node/database-lock.js +44 -0
  223. package/dist/local/store/node/database-lock.js.map +1 -0
  224. package/dist/local/store/node/database.d.ts +15 -14
  225. package/dist/local/store/node/database.d.ts.map +1 -1
  226. package/dist/local/store/node/database.js +197 -202
  227. package/dist/local/store/node/database.js.map +1 -1
  228. package/dist/local/store/react-native/adapter.d.ts +8 -2
  229. package/dist/local/store/react-native/adapter.d.ts.map +1 -1
  230. package/dist/local/store/react-native/adapter.js +151 -66
  231. package/dist/local/store/react-native/adapter.js.map +1 -1
  232. package/dist/local/store/received-content.d.ts +9 -0
  233. package/dist/local/store/received-content.d.ts.map +1 -0
  234. package/dist/local/store/received-content.js +46 -0
  235. package/dist/local/store/received-content.js.map +1 -0
  236. package/dist/local/store/reliability.d.ts +2 -2
  237. package/dist/local/store/reliability.d.ts.map +1 -1
  238. package/dist/local/store/reliability.js +7 -4
  239. package/dist/local/store/reliability.js.map +1 -1
  240. package/dist/local/store/web/adapter.d.ts +8 -2
  241. package/dist/local/store/web/adapter.d.ts.map +1 -1
  242. package/dist/local/store/web/adapter.js +206 -73
  243. package/dist/local/store/web/adapter.js.map +1 -1
  244. package/dist/media/index.d.ts +71 -61
  245. package/dist/media/index.d.ts.map +1 -1
  246. package/dist/media/index.js +550 -386
  247. package/dist/media/index.js.map +1 -1
  248. package/dist/media/prepared-upload.d.ts +37 -0
  249. package/dist/media/prepared-upload.d.ts.map +1 -0
  250. package/dist/media/prepared-upload.js +46 -0
  251. package/dist/media/prepared-upload.js.map +1 -0
  252. package/dist/remote/object-store/convex-r2/server.d.ts +2 -1
  253. package/dist/remote/object-store/convex-r2/server.d.ts.map +1 -1
  254. package/dist/remote/object-store/convex-r2/server.js +4 -0
  255. package/dist/remote/object-store/convex-r2/server.js.map +1 -1
  256. package/dist/remote/object-store/convex-r2/storage.d.ts.map +1 -1
  257. package/dist/remote/object-store/convex-r2/storage.js +1 -0
  258. package/dist/remote/object-store/convex-r2/storage.js.map +1 -1
  259. package/dist/remote/object-store/index.d.ts +3 -1
  260. package/dist/remote/object-store/index.d.ts.map +1 -1
  261. package/dist/remote/object-store/index.js +1 -1
  262. package/dist/remote/object-store/index.js.map +1 -1
  263. package/dist/remote/object-store/s3/storage.d.ts +3 -1
  264. package/dist/remote/object-store/s3/storage.d.ts.map +1 -1
  265. package/dist/remote/object-store/s3/storage.js +9 -2
  266. package/dist/remote/object-store/s3/storage.js.map +1 -1
  267. package/dist/remote/object-store/types.d.ts +33 -4
  268. package/dist/remote/object-store/types.d.ts.map +1 -1
  269. package/dist/remote/object-store/upload-error.d.ts +23 -0
  270. package/dist/remote/object-store/upload-error.d.ts.map +1 -0
  271. package/dist/remote/object-store/upload-error.js +33 -0
  272. package/dist/remote/object-store/upload-error.js.map +1 -0
  273. package/dist/remote/object-store/validation.d.ts +7 -1
  274. package/dist/remote/object-store/validation.d.ts.map +1 -1
  275. package/dist/remote/object-store/validation.js +39 -25
  276. package/dist/remote/object-store/validation.js.map +1 -1
  277. package/dist/remote/relay/index.d.ts +5 -12
  278. package/dist/remote/relay/index.d.ts.map +1 -1
  279. package/dist/remote/relay/index.js +4 -11
  280. package/dist/remote/relay/index.js.map +1 -1
  281. package/dist/remote/relay/memory/adapter.d.ts +2 -1
  282. package/dist/remote/relay/memory/adapter.d.ts.map +1 -1
  283. package/dist/remote/relay/memory/adapter.js +10 -0
  284. package/dist/remote/relay/memory/adapter.js.map +1 -1
  285. package/dist/remote/relay/types.d.ts +28 -17
  286. package/dist/remote/relay/types.d.ts.map +1 -1
  287. package/dist/types/api.d.ts +36 -1
  288. package/dist/types/api.d.ts.map +1 -1
  289. package/dist/types/session.d.ts +6 -0
  290. package/dist/types/session.d.ts.map +1 -1
  291. package/dist/types/session.js.map +1 -1
  292. package/docs/ASSURANCE.md +7 -7
  293. package/docs/CLIENT_COMPOSITION.md +12 -19
  294. package/docs/DEVIATIONS.md +1 -1
  295. package/docs/DOCUMENTATION_STANDARDS.md +4 -0
  296. package/docs/GETTING_STARTED.md +23 -38
  297. package/docs/INTERFACES.md +22 -13
  298. package/docs/PACKAGE_SURFACE.md +5 -12
  299. package/docs/RECIPES.md +10 -23
  300. package/examples/browser/index.html +2 -2
  301. package/local/store/README.md +16 -1
  302. package/local/store/expo/README.md +23 -19
  303. package/local/store/node/README.md +29 -0
  304. package/media/README.md +94 -0
  305. package/package.json +17 -27
  306. package/remote/README.md +16 -16
  307. package/remote/object-store/README.md +8 -0
  308. package/remote/object-store/s3/README.md +10 -1
  309. package/remote/relay/README.md +3 -2
  310. package/COMMERCIAL.md +0 -56
  311. package/dist/device/expo-metadata.d.ts.map +0 -1
  312. package/dist/device/expo-metadata.js.map +0 -1
  313. package/dist/remote/relay/convex/backend.d.ts +0 -394
  314. package/dist/remote/relay/convex/backend.d.ts.map +0 -1
  315. package/dist/remote/relay/convex/backend.js +0 -678
  316. package/dist/remote/relay/convex/backend.js.map +0 -1
  317. package/dist/remote/relay/convex/component/_generated/api.d.ts +0 -58
  318. package/dist/remote/relay/convex/component/_generated/api.d.ts.map +0 -1
  319. package/dist/remote/relay/convex/component/_generated/api.js +0 -31
  320. package/dist/remote/relay/convex/component/_generated/api.js.map +0 -1
  321. package/dist/remote/relay/convex/component/_generated/component.d.ts +0 -475
  322. package/dist/remote/relay/convex/component/_generated/component.d.ts.map +0 -1
  323. package/dist/remote/relay/convex/component/_generated/component.js +0 -11
  324. package/dist/remote/relay/convex/component/_generated/component.js.map +0 -1
  325. package/dist/remote/relay/convex/component/_generated/dataModel.d.ts +0 -46
  326. package/dist/remote/relay/convex/component/_generated/dataModel.d.ts.map +0 -1
  327. package/dist/remote/relay/convex/component/_generated/dataModel.js +0 -11
  328. package/dist/remote/relay/convex/component/_generated/dataModel.js.map +0 -1
  329. package/dist/remote/relay/convex/component/_generated/server.d.ts +0 -129
  330. package/dist/remote/relay/convex/component/_generated/server.d.ts.map +0 -1
  331. package/dist/remote/relay/convex/component/_generated/server.js +0 -79
  332. package/dist/remote/relay/convex/component/_generated/server.js.map +0 -1
  333. package/dist/remote/relay/convex/component/accounts.d.ts +0 -45
  334. package/dist/remote/relay/convex/component/accounts.d.ts.map +0 -1
  335. package/dist/remote/relay/convex/component/accounts.js +0 -184
  336. package/dist/remote/relay/convex/component/accounts.js.map +0 -1
  337. package/dist/remote/relay/convex/component/certificates.d.ts +0 -10
  338. package/dist/remote/relay/convex/component/certificates.d.ts.map +0 -1
  339. package/dist/remote/relay/convex/component/certificates.js +0 -126
  340. package/dist/remote/relay/convex/component/certificates.js.map +0 -1
  341. package/dist/remote/relay/convex/component/cleanup.d.ts +0 -32
  342. package/dist/remote/relay/convex/component/cleanup.d.ts.map +0 -1
  343. package/dist/remote/relay/convex/component/cleanup.js +0 -146
  344. package/dist/remote/relay/convex/component/cleanup.js.map +0 -1
  345. package/dist/remote/relay/convex/component/convex.config.d.ts +0 -5
  346. package/dist/remote/relay/convex/component/convex.config.d.ts.map +0 -1
  347. package/dist/remote/relay/convex/component/convex.config.js +0 -35
  348. package/dist/remote/relay/convex/component/convex.config.js.map +0 -1
  349. package/dist/remote/relay/convex/component/crons.d.ts +0 -3
  350. package/dist/remote/relay/convex/component/crons.d.ts.map +0 -1
  351. package/dist/remote/relay/convex/component/crons.js +0 -10
  352. package/dist/remote/relay/convex/component/crons.js.map +0 -1
  353. package/dist/remote/relay/convex/component/devices.d.ts +0 -102
  354. package/dist/remote/relay/convex/component/devices.d.ts.map +0 -1
  355. package/dist/remote/relay/convex/component/devices.js +0 -300
  356. package/dist/remote/relay/convex/component/devices.js.map +0 -1
  357. package/dist/remote/relay/convex/component/errors.d.ts +0 -22
  358. package/dist/remote/relay/convex/component/errors.d.ts.map +0 -1
  359. package/dist/remote/relay/convex/component/errors.js +0 -17
  360. package/dist/remote/relay/convex/component/errors.js.map +0 -1
  361. package/dist/remote/relay/convex/component/groups.d.ts +0 -63
  362. package/dist/remote/relay/convex/component/groups.d.ts.map +0 -1
  363. package/dist/remote/relay/convex/component/groups.js +0 -341
  364. package/dist/remote/relay/convex/component/groups.js.map +0 -1
  365. package/dist/remote/relay/convex/component/keys.d.ts +0 -130
  366. package/dist/remote/relay/convex/component/keys.d.ts.map +0 -1
  367. package/dist/remote/relay/convex/component/keys.js +0 -578
  368. package/dist/remote/relay/convex/component/keys.js.map +0 -1
  369. package/dist/remote/relay/convex/component/messages.d.ts +0 -105
  370. package/dist/remote/relay/convex/component/messages.d.ts.map +0 -1
  371. package/dist/remote/relay/convex/component/messages.js +0 -702
  372. package/dist/remote/relay/convex/component/messages.js.map +0 -1
  373. package/dist/remote/relay/convex/component/provisioning.d.ts +0 -92
  374. package/dist/remote/relay/convex/component/provisioning.d.ts.map +0 -1
  375. package/dist/remote/relay/convex/component/provisioning.js +0 -360
  376. package/dist/remote/relay/convex/component/provisioning.js.map +0 -1
  377. package/dist/remote/relay/convex/component/runtime.d.ts +0 -18
  378. package/dist/remote/relay/convex/component/runtime.d.ts.map +0 -1
  379. package/dist/remote/relay/convex/component/runtime.js +0 -144
  380. package/dist/remote/relay/convex/component/runtime.js.map +0 -1
  381. package/dist/remote/relay/convex/component/schema.d.ts +0 -358
  382. package/dist/remote/relay/convex/component/schema.d.ts.map +0 -1
  383. package/dist/remote/relay/convex/component/schema.js +0 -288
  384. package/dist/remote/relay/convex/component/schema.js.map +0 -1
  385. package/dist/remote/relay/convex/component/zkAuth.d.ts +0 -18
  386. package/dist/remote/relay/convex/component/zkAuth.d.ts.map +0 -1
  387. package/dist/remote/relay/convex/component/zkAuth.js +0 -86
  388. package/dist/remote/relay/convex/component/zkAuth.js.map +0 -1
  389. package/dist/remote/relay/convex/constants.d.ts +0 -3
  390. package/dist/remote/relay/convex/constants.d.ts.map +0 -1
  391. package/dist/remote/relay/convex/constants.js +0 -3
  392. package/dist/remote/relay/convex/constants.js.map +0 -1
  393. package/dist/remote/relay/convex/group-server.d.ts +0 -123
  394. package/dist/remote/relay/convex/group-server.d.ts.map +0 -1
  395. package/dist/remote/relay/convex/group-server.js +0 -184
  396. package/dist/remote/relay/convex/group-server.js.map +0 -1
  397. package/dist/remote/relay/convex/index.d.ts +0 -42
  398. package/dist/remote/relay/convex/index.d.ts.map +0 -1
  399. package/dist/remote/relay/convex/index.js +0 -38
  400. package/dist/remote/relay/convex/index.js.map +0 -1
  401. package/dist/remote/relay/convex/relay.d.ts +0 -323
  402. package/dist/remote/relay/convex/relay.d.ts.map +0 -1
  403. package/dist/remote/relay/convex/relay.js +0 -1144
  404. package/dist/remote/relay/convex/relay.js.map +0 -1
  405. package/dist/remote/relay/convex/types.d.ts +0 -24
  406. package/dist/remote/relay/convex/types.d.ts.map +0 -1
  407. package/dist/remote/relay/convex/types.js +0 -14
  408. package/dist/remote/relay/convex/types.js.map +0 -1
  409. package/remote/relay/convex/README.md +0 -61
  410. package/remote/relay/convex/component/README.md +0 -462
@@ -0,0 +1,217 @@
1
+ import { base64ToBytes, bytesToBase64 } from '../internal/crypto/index.js';
2
+ import { isGroupErrorDetail, } from '../internal/groups/error-details.js';
3
+ const MAXIMUM_RESPONSE_BYTES = 8 * 1024 * 1024;
4
+ const MAXIMUM_CHANGE_ENTRIES = 64;
5
+ const GROUP_ERROR_STATUS = {
6
+ INVALID_REQUEST: 400,
7
+ UNAUTHORIZED: 403,
8
+ FORBIDDEN: 403,
9
+ VERSION_CONFLICT: 409,
10
+ };
11
+ function record(value) {
12
+ return value !== null && typeof value === 'object' && !Array.isArray(value);
13
+ }
14
+ function invalidResponse() {
15
+ throw new Error('Relay returned an invalid group response');
16
+ }
17
+ function integer(value) {
18
+ if (typeof value !== 'number' || !Number.isSafeInteger(value) || value < 0)
19
+ invalidResponse();
20
+ return value;
21
+ }
22
+ function bytes(value) {
23
+ if (typeof value !== 'string')
24
+ invalidResponse();
25
+ try {
26
+ const result = base64ToBytes(value);
27
+ if (bytesToBase64(result) !== value)
28
+ invalidResponse();
29
+ return result;
30
+ }
31
+ catch {
32
+ invalidResponse();
33
+ }
34
+ }
35
+ function change(value) {
36
+ if (!record(value))
37
+ invalidResponse();
38
+ const result = {
39
+ version: integer(value.version),
40
+ actions: bytes(value.actions),
41
+ serverSignature: bytes(value.serverSignature),
42
+ changeEpoch: integer(value.changeEpoch),
43
+ timestamp: integer(value.timestamp),
44
+ };
45
+ if (result.serverSignature.byteLength !== 64)
46
+ invalidResponse();
47
+ return result;
48
+ }
49
+ async function readResponse(response) {
50
+ const reader = response.body?.getReader();
51
+ if (!reader) {
52
+ if (response.status === 204)
53
+ return undefined;
54
+ invalidResponse();
55
+ }
56
+ let length = 0;
57
+ const chunks = [];
58
+ try {
59
+ for (;;) {
60
+ const part = await reader.read();
61
+ if (part.done)
62
+ break;
63
+ length += part.value.byteLength;
64
+ if (length > MAXIMUM_RESPONSE_BYTES) {
65
+ await reader.cancel();
66
+ invalidResponse();
67
+ }
68
+ chunks.push(part.value);
69
+ }
70
+ }
71
+ finally {
72
+ reader.releaseLock();
73
+ }
74
+ if (response.status === 204) {
75
+ if (length !== 0)
76
+ invalidResponse();
77
+ return undefined;
78
+ }
79
+ const body = new Uint8Array(length);
80
+ let offset = 0;
81
+ for (const chunk of chunks) {
82
+ body.set(chunk, offset);
83
+ offset += chunk.byteLength;
84
+ }
85
+ try {
86
+ return JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(body));
87
+ }
88
+ catch {
89
+ invalidResponse();
90
+ }
91
+ }
92
+ export class HostedGroupError extends Error {
93
+ data;
94
+ constructor(status, value) {
95
+ const error = record(value) && record(value.error) ? value.error : {};
96
+ const code = typeof error.code === 'string' &&
97
+ Object.hasOwn(GROUP_ERROR_STATUS, error.code) &&
98
+ GROUP_ERROR_STATUS[error.code] === status
99
+ ? error.code
100
+ : 'GROUP_REQUEST_FAILED';
101
+ super(`${code}: Relay group request failed`);
102
+ this.name = 'HostedGroupError';
103
+ this.data = { code, status };
104
+ if (code !== 'GROUP_REQUEST_FAILED' && isGroupErrorDetail(error.detail))
105
+ this.data.detail = error.detail;
106
+ if (code === 'FORBIDDEN' &&
107
+ typeof error.reason === 'string' &&
108
+ ['not_readable', 'before_join', 'not_a_member'].includes(error.reason))
109
+ this.data.reason = error.reason;
110
+ }
111
+ }
112
+ /** Presentation-authorized group state. Device credentials never enter this transport. */
113
+ export class HostedGroupServer {
114
+ connection;
115
+ constructor(connection) {
116
+ this.connection = connection;
117
+ }
118
+ async request(operation, groupId, authorization, fields = {}) {
119
+ if (!authorization.authorityKeyId || !/^[A-Za-z0-9_-]{1,128}$/.test(authorization.authorityKeyId))
120
+ throw new Error('Managed group requests require a verified authority selection');
121
+ const response = await fetch(`${this.connection.protocolEndpoint}/anonymous/groups/${operation}`, {
122
+ method: 'POST',
123
+ credentials: 'omit',
124
+ redirect: 'error',
125
+ headers: {
126
+ accept: 'application/json',
127
+ 'content-type': 'application/json',
128
+ },
129
+ body: JSON.stringify({
130
+ publishableKey: this.connection.publishableKey,
131
+ authorityKeyId: authorization.authorityKeyId,
132
+ groupId: bytesToBase64(groupId),
133
+ presentation: bytesToBase64(authorization.presentation),
134
+ groupPublicParams: bytesToBase64(authorization.groupPublicParams),
135
+ ...fields,
136
+ }),
137
+ });
138
+ const value = await readResponse(response);
139
+ if (!response.ok)
140
+ throw new HostedGroupError(response.status, value);
141
+ return value;
142
+ }
143
+ async refreshGroupSendEndorsements(groupId, authorization) {
144
+ const value = await this.request('endorsements', groupId, authorization);
145
+ if (!record(value))
146
+ invalidResponse();
147
+ const expiration = integer(value.expiration);
148
+ const endorsements = bytes(value.endorsements);
149
+ if (expiration % 86400 !== 0 || endorsements.length < 1)
150
+ invalidResponse();
151
+ return { endorsements, expiration };
152
+ }
153
+ async createGroup(groupId, encryptedState, authorization) {
154
+ const value = await this.request('create', groupId, authorization, {
155
+ encryptedState: bytesToBase64(encryptedState),
156
+ });
157
+ if (value !== undefined)
158
+ invalidResponse();
159
+ }
160
+ async getGroup(groupId, authorization, version) {
161
+ const value = await this.request('state', groupId, authorization, version === undefined ? {} : { version });
162
+ if (value === null)
163
+ return null;
164
+ if (!record(value))
165
+ invalidResponse();
166
+ const result = {
167
+ encryptedState: bytes(value.encryptedState),
168
+ version: integer(value.version),
169
+ baselineSignature: bytes(value.baselineSignature),
170
+ };
171
+ if (result.baselineSignature.byteLength !== 64 ||
172
+ (version !== undefined && result.version !== version))
173
+ invalidResponse();
174
+ return result;
175
+ }
176
+ async getGroupJoinInfo(groupId, inviteLinkPassword, authorization) {
177
+ const value = await this.request('join-info', groupId, authorization, {
178
+ inviteLinkPassword: bytesToBase64(inviteLinkPassword),
179
+ });
180
+ if (value === null)
181
+ return null;
182
+ if (!record(value))
183
+ invalidResponse();
184
+ return {
185
+ encryptedJoinInfo: bytes(value.encryptedJoinInfo),
186
+ version: integer(value.version),
187
+ };
188
+ }
189
+ async getGroupChanges(groupId, fromVersion, authorization) {
190
+ const value = await this.request('changes', groupId, authorization, {
191
+ fromVersion,
192
+ });
193
+ if (!record(value) ||
194
+ !Array.isArray(value.entries) ||
195
+ value.entries.length > MAXIMUM_CHANGE_ENTRIES ||
196
+ typeof value.hasMore !== 'boolean')
197
+ invalidResponse();
198
+ const entries = value.entries.map(change);
199
+ if ((value.hasMore && entries.length === 0) ||
200
+ entries.some((entry, index) => entry.version !== fromVersion + index + 1))
201
+ invalidResponse();
202
+ return { entries, hasMore: value.hasMore };
203
+ }
204
+ async submitGroupChange(groupId, expectedVersion, actions, inviteLinkPassword, authorization) {
205
+ if (arguments.length !== 5)
206
+ throw new Error('INVALID_REQUEST: Group change submission must not carry an epoch');
207
+ const result = change(await this.request('change', groupId, authorization, {
208
+ expectedVersion,
209
+ actions: bytesToBase64(actions),
210
+ inviteLinkPassword: bytesToBase64(inviteLinkPassword),
211
+ }));
212
+ if (result.version !== expectedVersion + 1)
213
+ invalidResponse();
214
+ return result;
215
+ }
216
+ }
217
+ //# sourceMappingURL=hosted-groups.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hosted-groups.js","sourceRoot":"","sources":["../../client/hosted-groups.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,34 @@
1
+ import type { Envelope, Unsubscribe } from "../remote/relay/types.js";
2
+ interface MailboxSubscription {
3
+ authenticate(): Promise<{
4
+ url: string;
5
+ token: string;
6
+ renewAt: number;
7
+ }>;
8
+ /** Decodes the `message` of a `durable-message` frame. */
9
+ decodeDurable(message: unknown): Envelope;
10
+ /** Recovers retained messages over HTTP while no socket delivers them. */
11
+ pull(): Promise<readonly Envelope[]>;
12
+ /** Acknowledges over HTTP when queued socket acknowledgments lose their socket. */
13
+ acknowledge(messageIds: readonly string[]): Promise<void>;
14
+ receive(envelope: Envelope): void | Promise<void>;
15
+ receiveEphemeral(message: unknown, current: () => boolean): Promise<string>;
16
+ onBatchStart?(): void;
17
+ onBatchEnd?(): void;
18
+ }
19
+ export interface MailboxSubscriptionHandle {
20
+ readonly unsubscribe: Unsubscribe;
21
+ /**
22
+ * Queues a socket acknowledgment and returns true while a socket is live.
23
+ * Queued ids leave in one frame when the delivered frames are drained.
24
+ */
25
+ acknowledge(messageId: string): boolean;
26
+ }
27
+ /**
28
+ * Delivers durable and ephemeral frames from the mailbox socket and acknowledges
29
+ * durable frames over the same socket. HTTP pull recovers retained messages
30
+ * only while the socket is down or after a handler failure.
31
+ */
32
+ export declare function subscribeHostedMailbox(options: MailboxSubscription): MailboxSubscriptionHandle;
33
+ export {};
34
+ //# sourceMappingURL=hosted-mailbox-subscription.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hosted-mailbox-subscription.d.ts","sourceRoot":"","sources":["../../client/hosted-mailbox-subscription.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAUnE,UAAU,mBAAmB;IAC3B,YAAY,IAAI,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzE,0DAA0D;IAC1D,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC1C,0EAA0E;IAC1E,IAAI,IAAI,OAAO,CAAC,SAAS,QAAQ,EAAE,CAAC,CAAC;IACrC,mFAAmF;IACnF,WAAW,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5E,YAAY,CAAC,IAAI,IAAI,CAAC;IACtB,UAAU,CAAC,IAAI,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC;;;OAGG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;CACzC;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,mBAAmB,GAC3B,yBAAyB,CAwP3B"}
@@ -0,0 +1,257 @@
1
+ const MAILBOX_PROTOCOL = "open-e2ee-relay.v1";
2
+ const AUTH_PROTOCOL_PREFIX = "open-e2ee-relay.auth.";
3
+ const RECOVERY_MILLISECONDS = 2_000;
4
+ const MAXIMUM_FRAME_CHARACTERS = 1024 * 1024;
5
+ const MAXIMUM_PENDING_FRAMES = 100;
6
+ /** The Relay refuses an acknowledgment frame that carries more ids. */
7
+ const MAXIMUM_ACKNOWLEDGMENT_IDS = 100;
8
+ /**
9
+ * Delivers durable and ephemeral frames from the mailbox socket and acknowledges
10
+ * durable frames over the same socket. HTTP pull recovers retained messages
11
+ * only while the socket is down or after a handler failure.
12
+ */
13
+ export function subscribeHostedMailbox(options) {
14
+ let active = true;
15
+ let socket;
16
+ let connectionGeneration = 0;
17
+ let reconnectDelay = 1_000;
18
+ let reconnectTimer;
19
+ let handshakeTimer;
20
+ let renewalTimer;
21
+ let recoveryTimer;
22
+ let acknowledgmentTimer;
23
+ let draining = false;
24
+ let pullRequested = false;
25
+ const ephemeral = [];
26
+ const durable = [];
27
+ const acknowledgments = [];
28
+ const liveSocket = () => active && socket?.readyState === 1 ? socket : undefined;
29
+ const flushAcknowledgments = () => {
30
+ clearTimeout(acknowledgmentTimer);
31
+ acknowledgmentTimer = undefined;
32
+ while (acknowledgments.length > 0) {
33
+ const messageIds = acknowledgments.splice(0, MAXIMUM_ACKNOWLEDGMENT_IDS);
34
+ const live = socket?.readyState === 1 ? socket : undefined;
35
+ if (live !== undefined) {
36
+ live.send(JSON.stringify({ type: "acknowledge", messageIds }));
37
+ continue;
38
+ }
39
+ // The socket left after delivery. Reconnect redelivery re-acknowledges
40
+ // anything this request loses.
41
+ options.acknowledge(messageIds).catch(() => undefined);
42
+ }
43
+ };
44
+ const recoverLater = () => {
45
+ if (!active || recoveryTimer !== undefined)
46
+ return;
47
+ recoveryTimer = setTimeout(() => {
48
+ recoveryTimer = undefined;
49
+ requestPull();
50
+ }, RECOVERY_MILLISECONDS);
51
+ };
52
+ const receiveBatch = async (messages) => {
53
+ if (!active || messages.length === 0)
54
+ return;
55
+ options.onBatchStart?.();
56
+ try {
57
+ for (const message of messages) {
58
+ if (!active)
59
+ break;
60
+ await options.receive(message);
61
+ }
62
+ }
63
+ finally {
64
+ options.onBatchEnd?.();
65
+ }
66
+ };
67
+ const drain = async () => {
68
+ if (draining || !active)
69
+ return;
70
+ draining = true;
71
+ try {
72
+ while (active &&
73
+ (pullRequested || ephemeral.length > 0 || durable.length > 0)) {
74
+ const live = ephemeral.shift();
75
+ if (live !== undefined) {
76
+ const current = () => active && socket === live.socket && live.socket.readyState === 1;
77
+ if (!current())
78
+ continue;
79
+ const messageId = await options.receiveEphemeral(live.message, current);
80
+ if (current())
81
+ live.socket.send(JSON.stringify({ type: "ephemeral-accepted", messageId }));
82
+ continue;
83
+ }
84
+ if (durable.length > 0) {
85
+ await receiveBatch(durable.splice(0));
86
+ // One frame acknowledges the whole burst once nothing is queued.
87
+ if (durable.length === 0)
88
+ flushAcknowledgments();
89
+ continue;
90
+ }
91
+ pullRequested = false;
92
+ flushAcknowledgments();
93
+ const messages = await options.pull();
94
+ await receiveBatch(messages);
95
+ flushAcknowledgments();
96
+ // A full page can leave more retained work behind it.
97
+ if (messages.length >= MAXIMUM_PENDING_FRAMES)
98
+ recoverLater();
99
+ }
100
+ }
101
+ catch {
102
+ // Failed durable work stays in the mailbox. Ephemeral work can be lost.
103
+ recoverLater();
104
+ }
105
+ finally {
106
+ draining = false;
107
+ if (active &&
108
+ (pullRequested || ephemeral.length > 0 || durable.length > 0))
109
+ void drain();
110
+ else
111
+ flushAcknowledgments();
112
+ }
113
+ };
114
+ const requestPull = () => {
115
+ if (!active)
116
+ return;
117
+ pullRequested = true;
118
+ void drain();
119
+ };
120
+ const disconnect = () => {
121
+ const previous = socket;
122
+ socket = undefined;
123
+ connectionGeneration++;
124
+ ephemeral.length = 0;
125
+ durable.length = 0;
126
+ clearTimeout(handshakeTimer);
127
+ clearTimeout(renewalTimer);
128
+ try {
129
+ previous?.close(1000, "Subscription connection ended.");
130
+ }
131
+ catch {
132
+ /* Already closed. */
133
+ }
134
+ };
135
+ const retryConnection = () => {
136
+ if (!active || reconnectTimer !== undefined)
137
+ return;
138
+ disconnect();
139
+ // One recovery pull per reconnect attempt, paced by the reconnect backoff.
140
+ recoverLater();
141
+ const delay = reconnectDelay;
142
+ reconnectDelay = Math.min(30_000, reconnectDelay * 2);
143
+ reconnectTimer = setTimeout(() => {
144
+ reconnectTimer = undefined;
145
+ void connect();
146
+ }, delay);
147
+ };
148
+ const queueDurable = (candidate, message) => {
149
+ const envelope = options.decodeDurable(message);
150
+ if (durable.length >= MAXIMUM_PENDING_FRAMES) {
151
+ // The frame stays retained in the mailbox; the recovery pull collects it.
152
+ recoverLater();
153
+ return;
154
+ }
155
+ if (socket === candidate)
156
+ durable.push(envelope);
157
+ void drain();
158
+ };
159
+ const connect = async () => {
160
+ const generation = ++connectionGeneration;
161
+ try {
162
+ const authority = await options.authenticate();
163
+ if (!active || generation !== connectionGeneration)
164
+ return;
165
+ const candidate = new WebSocket(authority.url, [
166
+ MAILBOX_PROTOCOL,
167
+ `${AUTH_PROTOCOL_PREFIX}${authority.token}`,
168
+ ]);
169
+ socket = candidate;
170
+ const current = () => active && socket === candidate;
171
+ handshakeTimer = setTimeout(() => {
172
+ if (current())
173
+ retryConnection();
174
+ }, 10_000);
175
+ candidate.addEventListener("open", () => {
176
+ if (!current())
177
+ return;
178
+ if (candidate.protocol !== MAILBOX_PROTOCOL) {
179
+ retryConnection();
180
+ return;
181
+ }
182
+ clearTimeout(handshakeTimer);
183
+ // The Relay replays retained messages over the socket on connect.
184
+ clearTimeout(recoveryTimer);
185
+ recoveryTimer = undefined;
186
+ reconnectDelay = 1_000;
187
+ renewalTimer = setTimeout(() => {
188
+ if (!current())
189
+ return;
190
+ disconnect();
191
+ void connect();
192
+ }, Math.max(1_000, Math.min(2_147_483_647, authority.renewAt - Date.now())));
193
+ });
194
+ candidate.addEventListener("message", (event) => {
195
+ if (!current())
196
+ return;
197
+ try {
198
+ if (typeof event.data !== "string" ||
199
+ event.data.length > MAXIMUM_FRAME_CHARACTERS)
200
+ throw new Error("Invalid mailbox frame.");
201
+ const frame = JSON.parse(event.data);
202
+ if (typeof frame !== "object" || frame === null || !("type" in frame))
203
+ throw new Error("Invalid mailbox frame.");
204
+ if (frame.type === "durable-message" && "message" in frame)
205
+ queueDurable(candidate, frame.message);
206
+ else if (frame.type === "ephemeral-message" && "message" in frame) {
207
+ if (ephemeral.length >= MAXIMUM_PENDING_FRAMES)
208
+ throw new Error("Mailbox frame queue is full.");
209
+ ephemeral.push({ socket: candidate, message: frame.message });
210
+ void drain();
211
+ }
212
+ else if (frame.type !== "acknowledged")
213
+ throw new Error("Invalid mailbox frame.");
214
+ }
215
+ catch {
216
+ retryConnection();
217
+ }
218
+ });
219
+ candidate.addEventListener("close", () => {
220
+ if (current())
221
+ retryConnection();
222
+ });
223
+ candidate.addEventListener("error", () => {
224
+ if (current())
225
+ retryConnection();
226
+ });
227
+ }
228
+ catch {
229
+ if (active && generation === connectionGeneration)
230
+ retryConnection();
231
+ }
232
+ };
233
+ void connect();
234
+ return {
235
+ acknowledge: (messageId) => {
236
+ if (liveSocket() === undefined)
237
+ return false;
238
+ acknowledgments.push(messageId);
239
+ if (acknowledgments.length >= MAXIMUM_ACKNOWLEDGMENT_IDS)
240
+ flushAcknowledgments();
241
+ else if (!draining && acknowledgmentTimer === undefined)
242
+ // An acknowledgment outside a delivery batch leaves on its own.
243
+ acknowledgmentTimer = setTimeout(flushAcknowledgments, 0);
244
+ return true;
245
+ },
246
+ unsubscribe: () => {
247
+ if (!active)
248
+ return;
249
+ flushAcknowledgments();
250
+ active = false;
251
+ clearTimeout(reconnectTimer);
252
+ clearTimeout(recoveryTimer);
253
+ disconnect();
254
+ },
255
+ };
256
+ }
257
+ //# sourceMappingURL=hosted-mailbox-subscription.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hosted-mailbox-subscription.js","sourceRoot":"","sources":["../../client/hosted-mailbox-subscription.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,51 @@
1
+ import type { PreKeyUpload } from '../remote/relay/types.js';
2
+ import type { HostedRelayRegistrationPreKey, HostedRelayRegistrationPreKeys } from './hosted.js';
3
+ export interface StoredHostedPreKey {
4
+ algorithm: 'ec-x25519' | 'kem-ml-kem-1024';
5
+ keyId: number;
6
+ publicKey: string;
7
+ signature?: string;
8
+ }
9
+ export interface StoredHostedPreKeyPublication {
10
+ authorityGeneration: number;
11
+ materialFingerprint: string;
12
+ oneTimePreKeys: readonly StoredHostedPreKey[];
13
+ operationId: string;
14
+ revision: number;
15
+ signedPreKeys: readonly StoredHostedPreKey[];
16
+ }
17
+ export interface StoredHostedPendingPreKeyPublication {
18
+ materialFingerprint: string;
19
+ oneTimePreKeys: readonly StoredHostedPreKey[];
20
+ operationId: string;
21
+ predecessorRevision: number;
22
+ signedPreKeys: readonly StoredHostedPreKey[];
23
+ }
24
+ export interface HostedPreKeyStatus {
25
+ authorityGeneration: number;
26
+ currentOperationId: string;
27
+ identityPublicMaterial: Uint8Array;
28
+ materialFingerprint: string;
29
+ oneTimePreKeys: readonly HostedRelayRegistrationPreKey[];
30
+ oneTimePreKeyCounts: Readonly<Record<string, number>>;
31
+ publicationRevision: number;
32
+ profile: string;
33
+ registrationId: number;
34
+ signedPreKeys: readonly {
35
+ acceptedAtMilliseconds: number;
36
+ algorithm: HostedRelayRegistrationPreKey['algorithm'];
37
+ keyId: number;
38
+ publicKey: Uint8Array;
39
+ signature: Uint8Array;
40
+ }[];
41
+ }
42
+ export declare function storedPreKey(prekey: HostedRelayRegistrationPreKey): StoredHostedPreKey;
43
+ export declare function registrationPreKey(prekey: StoredHostedPreKey): HostedRelayRegistrationPreKey;
44
+ export declare function storedPublication(authorityGeneration: number, materialFingerprint: string, operationId: string, revision: number, prekeys: HostedRelayRegistrationPreKeys): StoredHostedPreKeyPublication;
45
+ export declare function parseStoredPublication(value: unknown): StoredHostedPreKeyPublication;
46
+ export declare function parseStoredPendingPublication(value: unknown): StoredHostedPendingPreKeyPublication | null;
47
+ export declare function parseHostedPreKeyStatus(value: unknown): HostedPreKeyStatus;
48
+ export declare function statusPreKeys(status: HostedPreKeyStatus): HostedRelayRegistrationPreKeys;
49
+ export declare function publicationMatchesStatus(publication: StoredHostedPreKeyPublication, status: HostedPreKeyStatus): boolean;
50
+ export declare function applyPreKeyUploads(current: HostedRelayRegistrationPreKeys, uploads: readonly PreKeyUpload[]): HostedRelayRegistrationPreKeys;
51
+ //# sourceMappingURL=hosted-prekey-publication.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hosted-prekey-publication.d.ts","sourceRoot":"","sources":["../../client/hosted-prekey-publication.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EACV,6BAA6B,EAC7B,8BAA8B,EAC/B,MAAM,UAAU,CAAC;AAMlB,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,WAAW,GAAG,iBAAiB,CAAC;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,6BAA6B;IAC5C,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,SAAS,kBAAkB,EAAE,CAAC;CAC9C;AAED,MAAM,WAAW,oCAAoC;IACnD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,SAAS,kBAAkB,EAAE,CAAC;CAC9C;AAED,MAAM,WAAW,kBAAkB;IACjC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sBAAsB,EAAE,UAAU,CAAC;IACnC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,SAAS,6BAA6B,EAAE,CAAC;IACzD,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACtD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,SAAS;QACtB,sBAAsB,EAAE,MAAM,CAAC;QAC/B,SAAS,EAAE,6BAA6B,CAAC,WAAW,CAAC,CAAC;QACtD,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,UAAU,CAAC;QACtB,SAAS,EAAE,UAAU,CAAC;KACvB,EAAE,CAAC;CACL;AA2BD,wBAAgB,YAAY,CAC1B,MAAM,EAAE,6BAA6B,GACpC,kBAAkB,CASpB;AA0BD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,kBAAkB,GACzB,6BAA6B,CAiB/B;AAED,wBAAgB,iBAAiB,CAC/B,mBAAmB,EAAE,MAAM,EAC3B,mBAAmB,EAAE,MAAM,EAC3B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,8BAA8B,GACtC,6BAA6B,CAS/B;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,GACb,6BAA6B,CAwB/B;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,GACb,oCAAoC,GAAG,IAAI,CAsB7C;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAuE1E;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,kBAAkB,GACzB,8BAA8B,CAUhC;AAED,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,6BAA6B,EAC1C,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAOT;AA4BD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,8BAA8B,EACvC,OAAO,EAAE,SAAS,YAAY,EAAE,GAC/B,8BAA8B,CAyChC"}