@open-e2ee/signal-protocol-sdk 0.1.0-alpha.5 → 0.1.0-alpha.7

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 (494) hide show
  1. package/ADAPTERS.md +15 -15
  2. package/ARCHITECTURE.md +1 -1
  3. package/CHANGELOG.md +252 -2
  4. package/README.md +1 -1
  5. package/blocking/README.md +5 -5
  6. package/client/README.md +2 -2
  7. package/dist/blocking/index.d.ts +2 -2
  8. package/dist/blocking/index.d.ts.map +1 -1
  9. package/dist/blocking/index.js +1 -1
  10. package/dist/blocking/index.js.map +1 -1
  11. package/dist/blocking/manager.d.ts +7 -7
  12. package/dist/blocking/manager.d.ts.map +1 -1
  13. package/dist/blocking/manager.js +3 -3
  14. package/dist/blocking/manager.js.map +1 -1
  15. package/dist/blocking/types.d.ts +3 -3
  16. package/dist/blocking/types.d.ts.map +1 -1
  17. package/dist/client/client.d.ts +32 -28
  18. package/dist/client/client.d.ts.map +1 -1
  19. package/dist/client/client.js +127 -79
  20. package/dist/client/client.js.map +1 -1
  21. package/dist/client/compose.d.ts +12 -7
  22. package/dist/client/compose.d.ts.map +1 -1
  23. package/dist/client/compose.js +2 -0
  24. package/dist/client/compose.js.map +1 -1
  25. package/dist/client/config.d.ts +54 -30
  26. package/dist/client/config.d.ts.map +1 -1
  27. package/dist/client/config.js.map +1 -1
  28. package/dist/client/content-adapter.d.ts +4 -4
  29. package/dist/client/content-adapter.d.ts.map +1 -1
  30. package/dist/client/content-adapter.js +1 -1
  31. package/dist/client/content-adapter.js.map +1 -1
  32. package/dist/client/dual-store.d.ts +5 -5
  33. package/dist/client/dual-store.d.ts.map +1 -1
  34. package/dist/client/dual-store.js.map +1 -1
  35. package/dist/client/endorsement-manager.d.ts +4 -0
  36. package/dist/client/endorsement-manager.d.ts.map +1 -1
  37. package/dist/client/endorsement-manager.js +11 -2
  38. package/dist/client/endorsement-manager.js.map +1 -1
  39. package/dist/client/groups.d.ts +29 -29
  40. package/dist/client/groups.d.ts.map +1 -1
  41. package/dist/client/groups.js +54 -37
  42. package/dist/client/groups.js.map +1 -1
  43. package/dist/client/headless.d.ts +9 -9
  44. package/dist/client/headless.d.ts.map +1 -1
  45. package/dist/client/headless.js +6 -6
  46. package/dist/client/headless.js.map +1 -1
  47. package/dist/client/index.d.ts +2 -2
  48. package/dist/client/index.d.ts.map +1 -1
  49. package/dist/client/index.js +1 -1
  50. package/dist/client/index.js.map +1 -1
  51. package/dist/client/key-rotation-core.d.ts +7 -7
  52. package/dist/client/key-rotation-core.d.ts.map +1 -1
  53. package/dist/client/key-rotation-core.js +11 -11
  54. package/dist/client/key-rotation-core.js.map +1 -1
  55. package/dist/client/media.js.map +1 -1
  56. package/dist/client/relay-subscription.d.ts +2 -2
  57. package/dist/client/relay-subscription.d.ts.map +1 -1
  58. package/dist/client/relay-subscription.js +1 -1
  59. package/dist/client/relay-subscription.js.map +1 -1
  60. package/dist/client/retry.js.map +1 -1
  61. package/dist/client/sealed-sender-ops.d.ts +1 -1
  62. package/dist/client/sealed-sender-ops.d.ts.map +1 -1
  63. package/dist/client/sealed-sender-ops.js +3 -3
  64. package/dist/client/sealed-sender-ops.js.map +1 -1
  65. package/dist/client/signal-service-cipher.d.ts +15 -11
  66. package/dist/client/signal-service-cipher.d.ts.map +1 -1
  67. package/dist/client/signal-service-cipher.js +24 -15
  68. package/dist/client/signal-service-cipher.js.map +1 -1
  69. package/dist/client/types.d.ts +8 -8
  70. package/dist/client/types.d.ts.map +1 -1
  71. package/dist/device/connection.js +2 -2
  72. package/dist/device/connection.js.map +1 -1
  73. package/dist/device/device-id.d.ts.map +1 -1
  74. package/dist/device/device-id.js +4 -4
  75. package/dist/device/device-id.js.map +1 -1
  76. package/dist/device/provisioning.d.ts +2 -2
  77. package/dist/device/provisioning.d.ts.map +1 -1
  78. package/dist/device/provisioning.js +7 -7
  79. package/dist/device/provisioning.js.map +1 -1
  80. package/dist/device/transfer.d.ts.map +1 -1
  81. package/dist/device/transfer.js +14 -14
  82. package/dist/device/transfer.js.map +1 -1
  83. package/dist/files/index.d.ts +1 -1
  84. package/dist/files/index.js +1 -1
  85. package/dist/groups/index.d.ts +4 -4
  86. package/dist/groups/index.d.ts.map +1 -1
  87. package/dist/groups/index.js +3 -3
  88. package/dist/groups/index.js.map +1 -1
  89. package/dist/hooks/use-connection-presence.d.ts +3 -3
  90. package/dist/hooks/use-connection-presence.d.ts.map +1 -1
  91. package/dist/hooks/use-connection-presence.js +4 -4
  92. package/dist/hooks/use-connection-presence.js.map +1 -1
  93. package/dist/hooks/use-key-rotation.js +2 -2
  94. package/dist/hooks/use-key-rotation.js.map +1 -1
  95. package/dist/index.d.ts +15 -15
  96. package/dist/index.d.ts.map +1 -1
  97. package/dist/index.js +6 -6
  98. package/dist/index.js.map +1 -1
  99. package/dist/internal/crypto/ec/x25519-validation.d.ts.map +1 -1
  100. package/dist/internal/crypto/ec/x25519-validation.js +4 -4
  101. package/dist/internal/crypto/ec/x25519-validation.js.map +1 -1
  102. package/dist/internal/crypto/symmetric/mac.d.ts +3 -3
  103. package/dist/internal/crypto/symmetric/mac.js +3 -3
  104. package/dist/internal/encoding/proto/envelope.d.ts +21 -21
  105. package/dist/internal/encoding/proto/envelope.d.ts.map +1 -1
  106. package/dist/internal/encoding/proto/envelope.js +25 -25
  107. package/dist/internal/encoding/proto/envelope.js.map +1 -1
  108. package/dist/internal/encoding/proto/index.d.ts +2 -2
  109. package/dist/internal/encoding/proto/index.d.ts.map +1 -1
  110. package/dist/internal/encoding/proto/index.js +2 -2
  111. package/dist/internal/encoding/proto/index.js.map +1 -1
  112. package/dist/internal/encoding/proto/pq-ratchet-serialize.d.ts +3 -3
  113. package/dist/internal/encoding/proto/pq-ratchet-serialize.js +2 -2
  114. package/dist/internal/encoding/proto/signal-message.d.ts +33 -33
  115. package/dist/internal/encoding/proto/signal-message.d.ts.map +1 -1
  116. package/dist/internal/encoding/proto/signal-message.js +58 -58
  117. package/dist/internal/encoding/proto/signal-message.js.map +1 -1
  118. package/dist/internal/groups/access-control.d.ts +170 -0
  119. package/dist/internal/groups/access-control.d.ts.map +1 -0
  120. package/dist/internal/groups/access-control.js +284 -0
  121. package/dist/internal/groups/access-control.js.map +1 -0
  122. package/dist/internal/groups/change-actions.d.ts +57 -0
  123. package/dist/internal/groups/change-actions.d.ts.map +1 -0
  124. package/dist/internal/groups/change-actions.js +827 -0
  125. package/dist/internal/groups/change-actions.js.map +1 -0
  126. package/dist/internal/groups/change-authorization.d.ts +16 -0
  127. package/dist/internal/groups/change-authorization.d.ts.map +1 -0
  128. package/dist/internal/groups/change-authorization.js +120 -0
  129. package/dist/internal/groups/change-authorization.js.map +1 -0
  130. package/dist/internal/{groups-v2 → groups}/encrypted-state.d.ts +12 -2
  131. package/dist/internal/groups/encrypted-state.d.ts.map +1 -0
  132. package/dist/internal/{groups-v2 → groups}/encrypted-state.js +122 -22
  133. package/dist/internal/groups/encrypted-state.js.map +1 -0
  134. package/dist/internal/groups/group-id.d.ts +9 -9
  135. package/dist/internal/groups/group-id.d.ts.map +1 -1
  136. package/dist/internal/groups/group-id.js +11 -12
  137. package/dist/internal/groups/group-id.js.map +1 -1
  138. package/dist/internal/groups/index.d.ts +16 -6
  139. package/dist/internal/groups/index.d.ts.map +1 -1
  140. package/dist/internal/groups/index.js +9 -1
  141. package/dist/internal/groups/index.js.map +1 -1
  142. package/dist/internal/groups/invite-link.d.ts.map +1 -0
  143. package/dist/internal/groups/invite-link.js.map +1 -0
  144. package/dist/internal/{groups-v2 → groups}/manager.d.ts +175 -40
  145. package/dist/internal/groups/manager.d.ts.map +1 -0
  146. package/dist/internal/groups/manager.js +1862 -0
  147. package/dist/internal/groups/manager.js.map +1 -0
  148. package/dist/internal/groups/sdk-store.d.ts +32 -0
  149. package/dist/internal/groups/sdk-store.d.ts.map +1 -0
  150. package/dist/internal/groups/sdk-store.js +111 -0
  151. package/dist/internal/groups/sdk-store.js.map +1 -0
  152. package/dist/internal/groups/server-engine.d.ts +52 -0
  153. package/dist/internal/groups/server-engine.d.ts.map +1 -0
  154. package/dist/internal/groups/server-engine.js +1126 -0
  155. package/dist/internal/groups/server-engine.js.map +1 -0
  156. package/dist/internal/groups/trust-root.d.ts +32 -0
  157. package/dist/internal/groups/trust-root.d.ts.map +1 -0
  158. package/dist/internal/groups/trust-root.js +91 -0
  159. package/dist/internal/groups/trust-root.js.map +1 -0
  160. package/dist/internal/{groups-v2 → groups}/types.d.ts +188 -46
  161. package/dist/internal/groups/types.d.ts.map +1 -0
  162. package/dist/internal/{groups-v2 → groups}/types.js +3 -2
  163. package/dist/internal/groups/types.js.map +1 -0
  164. package/dist/internal/groups/wire.d.ts +68 -0
  165. package/dist/internal/groups/wire.d.ts.map +1 -0
  166. package/dist/internal/groups/wire.js +708 -0
  167. package/dist/internal/groups/wire.js.map +1 -0
  168. package/dist/internal/manager/manager.d.ts +3 -3
  169. package/dist/internal/manager/manager.d.ts.map +1 -1
  170. package/dist/internal/manager/manager.js +3 -3
  171. package/dist/internal/manager/manager.js.map +1 -1
  172. package/dist/internal/protocol/double-ratchet/chains.d.ts.map +1 -1
  173. package/dist/internal/protocol/double-ratchet/chains.js +9 -9
  174. package/dist/internal/protocol/double-ratchet/chains.js.map +1 -1
  175. package/dist/internal/protocol/double-ratchet/ratchet.d.ts +2 -2
  176. package/dist/internal/protocol/double-ratchet/ratchet.d.ts.map +1 -1
  177. package/dist/internal/protocol/double-ratchet/ratchet.js +2 -2
  178. package/dist/internal/protocol/double-ratchet/ratchet.js.map +1 -1
  179. package/dist/internal/protocol/pqxdh/pqxdh.d.ts.map +1 -1
  180. package/dist/internal/protocol/pqxdh/pqxdh.js +3 -3
  181. package/dist/internal/protocol/pqxdh/pqxdh.js.map +1 -1
  182. package/dist/internal/protocol/sender-keys/index.d.ts +1 -1
  183. package/dist/internal/protocol/sender-keys/manager.d.ts +3 -3
  184. package/dist/internal/protocol/sender-keys/manager.d.ts.map +1 -1
  185. package/dist/internal/protocol/sender-keys/manager.js +3 -3
  186. package/dist/internal/protocol/sender-keys/manager.js.map +1 -1
  187. package/dist/internal/protocol/spqr/spqr.d.ts +1 -1
  188. package/dist/internal/protocol/spqr/spqr.d.ts.map +1 -1
  189. package/dist/internal/protocol/spqr/spqr.js +5 -5
  190. package/dist/internal/protocol/spqr/spqr.js.map +1 -1
  191. package/dist/internal/protocol/triple-ratchet/ratchet.d.ts +2 -2
  192. package/dist/internal/protocol/triple-ratchet/ratchet.d.ts.map +1 -1
  193. package/dist/internal/protocol/triple-ratchet/ratchet.js +4 -4
  194. package/dist/internal/protocol/triple-ratchet/ratchet.js.map +1 -1
  195. package/dist/internal/protocol/x3dh/x3dh.d.ts.map +1 -1
  196. package/dist/internal/protocol/x3dh/x3dh.js +3 -3
  197. package/dist/internal/protocol/x3dh/x3dh.js.map +1 -1
  198. package/dist/internal/protocol/zk/groups/auth-credential.d.ts +9 -7
  199. package/dist/internal/protocol/zk/groups/auth-credential.d.ts.map +1 -1
  200. package/dist/internal/protocol/zk/groups/auth-credential.js +68 -29
  201. package/dist/internal/protocol/zk/groups/auth-credential.js.map +1 -1
  202. package/dist/internal/protocol/zk/groups/server-params.d.ts +1 -1
  203. package/dist/internal/protocol/zk/groups/server-params.d.ts.map +1 -1
  204. package/dist/internal/protocol/zk/groups/server-params.js.map +1 -1
  205. package/dist/internal/protocol/zk/groups/uid-struct.d.ts +2 -0
  206. package/dist/internal/protocol/zk/groups/uid-struct.d.ts.map +1 -1
  207. package/dist/internal/protocol/zk/groups/uid-struct.js +4 -0
  208. package/dist/internal/protocol/zk/groups/uid-struct.js.map +1 -1
  209. package/dist/internal/sesame/device-registry.d.ts +7 -7
  210. package/dist/internal/sesame/device-registry.d.ts.map +1 -1
  211. package/dist/internal/sesame/device-registry.js +2 -2
  212. package/dist/internal/sesame/device-registry.js.map +1 -1
  213. package/dist/internal/sesame/manager.d.ts +1 -1
  214. package/dist/internal/sesame/manager.d.ts.map +1 -1
  215. package/dist/internal/sesame/manager.js +15 -15
  216. package/dist/internal/sesame/manager.js.map +1 -1
  217. package/dist/internal/session/builder.js +3 -3
  218. package/dist/internal/session/builder.js.map +1 -1
  219. package/dist/internal/session/cipher.d.ts +2 -2
  220. package/dist/internal/session/cipher.d.ts.map +1 -1
  221. package/dist/internal/session/cipher.js +30 -30
  222. package/dist/internal/session/cipher.js.map +1 -1
  223. package/dist/internal/session/decryption.d.ts +1 -1
  224. package/dist/internal/session/decryption.js +10 -10
  225. package/dist/internal/session/decryption.js.map +1 -1
  226. package/dist/internal/session/factory.d.ts.map +1 -1
  227. package/dist/internal/session/factory.js +3 -3
  228. package/dist/internal/session/factory.js.map +1 -1
  229. package/dist/internal/session/handshake.d.ts.map +1 -1
  230. package/dist/internal/session/handshake.js +3 -3
  231. package/dist/internal/session/handshake.js.map +1 -1
  232. package/dist/internal/session/ratchet.d.ts.map +1 -1
  233. package/dist/internal/session/ratchet.js +4 -4
  234. package/dist/internal/session/ratchet.js.map +1 -1
  235. package/dist/internal/session/types.d.ts +2 -2
  236. package/dist/internal/session/types.d.ts.map +1 -1
  237. package/dist/internal/session/validation.d.ts.map +1 -1
  238. package/dist/internal/session/validation.js +3 -3
  239. package/dist/internal/session/validation.js.map +1 -1
  240. package/dist/layers.d.ts +3 -3
  241. package/dist/layers.d.ts.map +1 -1
  242. package/dist/layers.js +7 -7
  243. package/dist/layers.js.map +1 -1
  244. package/dist/local/store/expo/adapter.d.ts +8 -8
  245. package/dist/local/store/expo/adapter.d.ts.map +1 -1
  246. package/dist/local/store/expo/adapter.js +7 -7
  247. package/dist/local/store/expo/adapter.js.map +1 -1
  248. package/dist/local/store/expo/database-key.d.ts +2 -2
  249. package/dist/local/store/expo/database-key.d.ts.map +1 -1
  250. package/dist/local/store/expo/database-key.js +5 -5
  251. package/dist/local/store/expo/database-key.js.map +1 -1
  252. package/dist/local/store/expo/db.d.ts +9 -9
  253. package/dist/local/store/expo/db.d.ts.map +1 -1
  254. package/dist/local/store/expo/db.js +2 -2
  255. package/dist/local/store/expo/db.js.map +1 -1
  256. package/dist/local/store/expo/index.d.ts +6 -6
  257. package/dist/local/store/expo/index.d.ts.map +1 -1
  258. package/dist/local/store/expo/index.js +3 -3
  259. package/dist/local/store/expo/index.js.map +1 -1
  260. package/dist/local/store/expo/key-storage.d.ts +1 -1
  261. package/dist/local/store/expo/key-storage.d.ts.map +1 -1
  262. package/dist/local/store/expo/key-storage.js +4 -4
  263. package/dist/local/store/expo/key-storage.js.map +1 -1
  264. package/dist/local/store/expo/secure-store-options.d.ts +1 -1
  265. package/dist/local/store/expo/secure-store-options.d.ts.map +1 -1
  266. package/dist/local/store/expo/secure-store-options.js +1 -1
  267. package/dist/local/store/expo/secure-store-options.js.map +1 -1
  268. package/dist/local/store/index.d.ts +9 -9
  269. package/dist/local/store/index.d.ts.map +1 -1
  270. package/dist/local/store/index.js +8 -8
  271. package/dist/local/store/index.js.map +1 -1
  272. package/dist/local/store/mock/adapter.d.ts +6 -6
  273. package/dist/local/store/mock/adapter.d.ts.map +1 -1
  274. package/dist/local/store/mock/adapter.js +2 -2
  275. package/dist/local/store/mock/adapter.js.map +1 -1
  276. package/dist/local/store/mock/index.d.ts +3 -3
  277. package/dist/local/store/mock/index.d.ts.map +1 -1
  278. package/dist/local/store/mock/index.js +3 -3
  279. package/dist/local/store/mock/index.js.map +1 -1
  280. package/dist/local/store/node/adapter.d.ts +4 -4
  281. package/dist/local/store/node/adapter.d.ts.map +1 -1
  282. package/dist/local/store/node/adapter.js +2 -2
  283. package/dist/local/store/node/adapter.js.map +1 -1
  284. package/dist/local/store/node/database.d.ts.map +1 -1
  285. package/dist/local/store/node/database.js +2 -2
  286. package/dist/local/store/node/database.js.map +1 -1
  287. package/dist/local/store/node/index.d.ts +4 -4
  288. package/dist/local/store/node/index.d.ts.map +1 -1
  289. package/dist/local/store/node/index.js +3 -3
  290. package/dist/local/store/node/index.js.map +1 -1
  291. package/dist/local/store/react-native/adapter.d.ts +5 -5
  292. package/dist/local/store/react-native/adapter.d.ts.map +1 -1
  293. package/dist/local/store/react-native/adapter.js +12 -12
  294. package/dist/local/store/react-native/adapter.js.map +1 -1
  295. package/dist/local/store/react-native/index.d.ts +4 -4
  296. package/dist/local/store/react-native/index.d.ts.map +1 -1
  297. package/dist/local/store/react-native/index.js +3 -3
  298. package/dist/local/store/react-native/index.js.map +1 -1
  299. package/dist/local/store/react-native/storage.d.ts +1 -1
  300. package/dist/local/store/web/adapter.d.ts +4 -4
  301. package/dist/local/store/web/adapter.d.ts.map +1 -1
  302. package/dist/local/store/web/adapter.js +7 -7
  303. package/dist/local/store/web/adapter.js.map +1 -1
  304. package/dist/local/store/web/index.d.ts +4 -4
  305. package/dist/local/store/web/index.d.ts.map +1 -1
  306. package/dist/local/store/web/index.js +3 -3
  307. package/dist/local/store/web/index.js.map +1 -1
  308. package/dist/local/vault/expo-secure-store.d.ts +2 -2
  309. package/dist/local/vault/expo-secure-store.d.ts.map +1 -1
  310. package/dist/local/vault/expo-secure-store.js +5 -5
  311. package/dist/local/vault/expo-secure-store.js.map +1 -1
  312. package/dist/local/vault/index.d.ts +2 -2
  313. package/dist/local/vault/index.d.ts.map +1 -1
  314. package/dist/local/vault/index.js +1 -1
  315. package/dist/local/vault/index.js.map +1 -1
  316. package/dist/logger.d.ts +3 -3
  317. package/dist/logger.d.ts.map +1 -1
  318. package/dist/logger.js +4 -4
  319. package/dist/logger.js.map +1 -1
  320. package/dist/media/index.d.ts +5 -5
  321. package/dist/media/index.d.ts.map +1 -1
  322. package/dist/profile/contact-state.d.ts.map +1 -1
  323. package/dist/profile/contact-state.js +2 -2
  324. package/dist/profile/contact-state.js.map +1 -1
  325. package/dist/profile/profile-key.d.ts.map +1 -1
  326. package/dist/profile/profile-key.js +2 -2
  327. package/dist/profile/profile-key.js.map +1 -1
  328. package/dist/profile/update-service.d.ts.map +1 -1
  329. package/dist/profile/update-service.js +2 -2
  330. package/dist/profile/update-service.js.map +1 -1
  331. package/dist/remote/object-store/convex-r2/storage.d.ts +2 -2
  332. package/dist/remote/object-store/convex-r2/storage.d.ts.map +1 -1
  333. package/dist/remote/object-store/index.d.ts +1 -1
  334. package/dist/remote/object-store/index.d.ts.map +1 -1
  335. package/dist/remote/object-store/s3/storage.d.ts +3 -3
  336. package/dist/remote/object-store/s3/storage.d.ts.map +1 -1
  337. package/dist/remote/object-store/s3/storage.js +1 -1
  338. package/dist/remote/object-store/types.d.ts +1 -1
  339. package/dist/remote/object-store/types.d.ts.map +1 -1
  340. package/dist/remote/relay/convex/group-server.d.ts +23 -21
  341. package/dist/remote/relay/convex/group-server.d.ts.map +1 -1
  342. package/dist/remote/relay/convex/group-server.js +49 -21
  343. package/dist/remote/relay/convex/group-server.js.map +1 -1
  344. package/dist/remote/relay/convex/index.d.ts +9 -9
  345. package/dist/remote/relay/convex/index.d.ts.map +1 -1
  346. package/dist/remote/relay/convex/index.js +5 -5
  347. package/dist/remote/relay/convex/index.js.map +1 -1
  348. package/dist/remote/relay/convex/relay.d.ts +26 -18
  349. package/dist/remote/relay/convex/relay.d.ts.map +1 -1
  350. package/dist/remote/relay/convex/relay.js +82 -23
  351. package/dist/remote/relay/convex/relay.js.map +1 -1
  352. package/dist/remote/relay/convex/server/index.d.ts +2 -0
  353. package/dist/remote/relay/convex/server/index.d.ts.map +1 -0
  354. package/dist/remote/relay/convex/server/index.js +2 -0
  355. package/dist/remote/relay/convex/server/index.js.map +1 -0
  356. package/dist/remote/relay/convex/server.d.ts +150 -0
  357. package/dist/remote/relay/convex/server.d.ts.map +1 -0
  358. package/dist/remote/relay/convex/server.js +506 -0
  359. package/dist/remote/relay/convex/server.js.map +1 -0
  360. package/dist/remote/relay/index.d.ts +7 -7
  361. package/dist/remote/relay/index.d.ts.map +1 -1
  362. package/dist/remote/relay/index.js +6 -6
  363. package/dist/remote/relay/index.js.map +1 -1
  364. package/dist/remote/relay/mock/adapter.d.ts +36 -18
  365. package/dist/remote/relay/mock/adapter.d.ts.map +1 -1
  366. package/dist/remote/relay/mock/adapter.js +75 -65
  367. package/dist/remote/relay/mock/adapter.js.map +1 -1
  368. package/dist/remote/relay/mock/failures.d.ts +1 -0
  369. package/dist/remote/relay/mock/failures.d.ts.map +1 -1
  370. package/dist/remote/relay/mock/failures.js +5 -0
  371. package/dist/remote/relay/mock/failures.js.map +1 -1
  372. package/dist/remote/relay/mock/group-server.d.ts +9 -0
  373. package/dist/remote/relay/mock/group-server.d.ts.map +1 -0
  374. package/dist/remote/relay/mock/group-server.js +9 -0
  375. package/dist/remote/relay/mock/group-server.js.map +1 -0
  376. package/dist/remote/relay/mock/index.d.ts +3 -3
  377. package/dist/remote/relay/mock/index.d.ts.map +1 -1
  378. package/dist/remote/relay/mock/index.js +3 -3
  379. package/dist/remote/relay/mock/index.js.map +1 -1
  380. package/dist/remote/relay/types.d.ts +56 -25
  381. package/dist/remote/relay/types.d.ts.map +1 -1
  382. package/dist/remote/relay/types.js +2 -2
  383. package/dist/types/api.d.ts +4 -4
  384. package/dist/types/api.d.ts.map +1 -1
  385. package/dist/types/messages.d.ts +1 -1
  386. package/dist/types/protocol-config.d.ts +17 -2
  387. package/dist/types/protocol-config.d.ts.map +1 -1
  388. package/dist/types/protocol-config.js +17 -2
  389. package/dist/types/protocol-config.js.map +1 -1
  390. package/dist/utils/retry.d.ts +2 -2
  391. package/dist/utils/retry.d.ts.map +1 -1
  392. package/dist/utils/retry.js +17 -0
  393. package/dist/utils/retry.js.map +1 -1
  394. package/docs/CLIENT_COMPOSITION.md +3 -3
  395. package/docs/DEVIATIONS.md +69 -50
  396. package/docs/GETTING_STARTED.md +3 -3
  397. package/docs/INTERFACES.md +22 -22
  398. package/docs/PACKAGE_SURFACE.md +15 -10
  399. package/docs/RECIPES.md +4 -4
  400. package/docs/api/classes/EndorsementManager.md +19 -1
  401. package/docs/api/classes/{SignalBlockingManager.md → SignalProtocolBlockingManager.md} +5 -5
  402. package/docs/api/classes/SignalProtocolClient.md +78 -78
  403. package/docs/api/functions/createDefaultSignalProtocolContentAdapter.md +13 -0
  404. package/docs/api/functions/{createDefaultSignalLogger.md → createDefaultSignalProtocolLogger.md} +5 -5
  405. package/docs/api/functions/createGroupId.md +1 -1
  406. package/docs/api/functions/decodeGroupTrustRoot.md +21 -0
  407. package/docs/api/functions/encodeGroupTrustRoot.md +28 -0
  408. package/docs/api/functions/extractGroupId.md +2 -2
  409. package/docs/api/functions/isGroupId.md +1 -1
  410. package/docs/api/functions/{resolveSignalLogger.md → resolveSignalProtocolLogger.md} +5 -5
  411. package/docs/api/interfaces/GroupTrustRoot.md +33 -0
  412. package/docs/api/interfaces/IProtocolStore.md +1 -1
  413. package/docs/api/interfaces/IRelayGroupServer.md +60 -0
  414. package/docs/api/interfaces/ISenderKeyStore.md +1 -1
  415. package/docs/api/interfaces/ISesameStore.md +1 -1
  416. package/docs/api/interfaces/ISignalProtocolClient.md +1 -1
  417. package/docs/api/interfaces/{ISignalLocalSecretVault.md → ISignalProtocolLocalSecretVault.md} +2 -2
  418. package/docs/api/interfaces/{ISignalLocalStore.md → ISignalProtocolLocalStore.md} +2 -2
  419. package/docs/api/interfaces/{ISignalRelayServer.md → ISignalProtocolRelayServer.md} +11 -3
  420. package/docs/api/interfaces/{InspectedSignalContent.md → InspectedSignalProtocolContent.md} +2 -2
  421. package/docs/api/interfaces/MLKEMBraidAgentState.md +1 -1
  422. package/docs/api/interfaces/MessageHeader.md +1 -1
  423. package/docs/api/interfaces/PreKeyMaintenanceStore.md +2 -2
  424. package/docs/api/interfaces/SealedSenderConfig.md +2 -2
  425. package/docs/api/interfaces/{SignalBlockingHooks.md → SignalProtocolBlockingHooks.md} +2 -2
  426. package/docs/api/interfaces/SignalProtocolBlockingManagerOptions.md +31 -0
  427. package/docs/api/interfaces/{SignalBlockingMirror.md → SignalProtocolBlockingMirror.md} +2 -2
  428. package/docs/api/interfaces/{SignalBlockingStore.md → SignalProtocolBlockingStore.md} +2 -2
  429. package/docs/api/interfaces/SignalProtocolClientAdapterConfig.md +3 -3
  430. package/docs/api/interfaces/SignalProtocolClientCompositionOptions.md +69 -31
  431. package/docs/api/interfaces/SignalProtocolClientConfig.md +93 -37
  432. package/docs/api/interfaces/SignalProtocolClientHooks.md +1 -1
  433. package/docs/api/interfaces/SignalProtocolClientIdentityConfig.md +16 -0
  434. package/docs/api/interfaces/SignalProtocolClientMediaConfig.md +2 -2
  435. package/docs/api/interfaces/{SignalContentAdapter.md → SignalProtocolContentAdapter.md} +4 -4
  436. package/docs/api/interfaces/{SignalRemoteObjectStore.md → SignalProtocolRemoteObjectStore.md} +2 -2
  437. package/docs/api/namespaces/blocking/README.md +10 -10
  438. package/docs/api/namespaces/keys/functions/generateKemOneTimePreKeys.md +1 -1
  439. package/docs/api/namespaces/media/interfaces/DeleteMediaAttachmentOptions.md +1 -1
  440. package/docs/api/namespaces/media/interfaces/ExecuteMediaAttachmentJobOptions.md +1 -1
  441. package/docs/api/namespaces/media/interfaces/PrepareMediaAttachmentUploadOptions.md +1 -1
  442. package/docs/api/namespaces/media/interfaces/ResolveMediaAttachmentOptions.md +1 -1
  443. package/docs/api/type-aliases/GroupId.md +2 -2
  444. package/docs/api/variables/GROUP_ID_PREFIX.md +11 -0
  445. package/docs/api/variables/GROUP_TRUST_ROOT_VERSION.md +11 -0
  446. package/docs/api/variables/MAX_RECEIVER_CHAINS.md +1 -1
  447. package/docs/api/variables/ONE_TIME_PREKEY_BATCH_SIZE.md +1 -1
  448. package/docs/api/variables/{defaultSignalLogger.md → defaultSignalProtocolLogger.md} +5 -5
  449. package/files/README.md +1 -1
  450. package/groups/README.md +16 -5
  451. package/local/store/README.md +10 -10
  452. package/local/store/expo/README.md +5 -5
  453. package/local/store/mock/README.md +1 -1
  454. package/local/store/node/README.md +1 -1
  455. package/local/store/react-native/README.md +1 -1
  456. package/local/store/web/README.md +1 -1
  457. package/local/vault/README.md +3 -3
  458. package/package.json +13 -2
  459. package/remote/README.md +19 -19
  460. package/remote/object-store/README.md +3 -3
  461. package/remote/object-store/convex-r2/README.md +1 -1
  462. package/remote/object-store/s3/README.md +1 -1
  463. package/remote/relay/README.md +2 -2
  464. package/remote/relay/convex/README.md +10 -4
  465. package/remote/relay/convex/server/README.md +146 -0
  466. package/remote/relay/mock/README.md +1 -1
  467. package/scripts/oe-groups.mjs +142 -0
  468. package/types/README.md +1 -1
  469. package/dist/internal/groups-v2/access-control.d.ts +0 -108
  470. package/dist/internal/groups-v2/access-control.d.ts.map +0 -1
  471. package/dist/internal/groups-v2/access-control.js +0 -191
  472. package/dist/internal/groups-v2/access-control.js.map +0 -1
  473. package/dist/internal/groups-v2/change-actions.d.ts +0 -40
  474. package/dist/internal/groups-v2/change-actions.d.ts.map +0 -1
  475. package/dist/internal/groups-v2/change-actions.js +0 -363
  476. package/dist/internal/groups-v2/change-actions.js.map +0 -1
  477. package/dist/internal/groups-v2/encrypted-state.d.ts.map +0 -1
  478. package/dist/internal/groups-v2/encrypted-state.js.map +0 -1
  479. package/dist/internal/groups-v2/index.d.ts +0 -19
  480. package/dist/internal/groups-v2/index.d.ts.map +0 -1
  481. package/dist/internal/groups-v2/index.js +0 -11
  482. package/dist/internal/groups-v2/index.js.map +0 -1
  483. package/dist/internal/groups-v2/invite-link.d.ts.map +0 -1
  484. package/dist/internal/groups-v2/invite-link.js.map +0 -1
  485. package/dist/internal/groups-v2/manager.d.ts.map +0 -1
  486. package/dist/internal/groups-v2/manager.js +0 -1095
  487. package/dist/internal/groups-v2/manager.js.map +0 -1
  488. package/dist/internal/groups-v2/types.d.ts.map +0 -1
  489. package/dist/internal/groups-v2/types.js.map +0 -1
  490. package/docs/api/functions/createDefaultSignalContentAdapter.md +0 -13
  491. package/docs/api/interfaces/SignalBlockingManagerOptions.md +0 -31
  492. package/docs/api/variables/GROUP_V2_PREFIX.md +0 -11
  493. /package/dist/internal/{groups-v2 → groups}/invite-link.d.ts +0 -0
  494. /package/dist/internal/{groups-v2 → groups}/invite-link.js +0 -0
@@ -0,0 +1,150 @@
1
+ import { type GenericDataModel, type GenericMutationCtx } from 'convex/server';
2
+ import { type GroupServerEngineRuntime } from '../../../internal/groups/server-engine.js';
3
+ import { type ServerSecretParams } from '../../../internal/protocol/zk/groups/server-params.js';
4
+ /** Convex environment variable containing the deployment's base64 32-byte seed. */
5
+ export declare const CONVEX_GROUP_SERVER_SECRET_ENV_VAR = "OE_GROUPS_SERVER_SECRET";
6
+ /**
7
+ * Tables owned by `defineConvexGroupServer`.
8
+ *
9
+ * Spread this object into the application's `defineSchema` call. The names are
10
+ * package-scoped so the enforcing server can be mounted without app callbacks.
11
+ */
12
+ export declare const convexGroupServerTables: {
13
+ oeGroupServerGroups: import("convex/server").TableDefinition<import("convex/values").VObject<{
14
+ encryptedState: ArrayBuffer;
15
+ groupId: string;
16
+ version: number;
17
+ }, {
18
+ groupId: import("convex/values").VString<string, "required">;
19
+ encryptedState: import("convex/values").VBytes<ArrayBuffer, "required">;
20
+ version: import("convex/values").VFloat64<number, "required">;
21
+ }, "required", "encryptedState" | "groupId" | "version">, {
22
+ by_group_id: ["groupId", "_creationTime"];
23
+ }, {}, {}>;
24
+ oeGroupServerChanges: import("convex/server").TableDefinition<import("convex/values").VObject<{
25
+ actions: ArrayBuffer;
26
+ changeEpoch: number;
27
+ groupId: string;
28
+ serverSignature: ArrayBuffer;
29
+ timestamp: number;
30
+ version: number;
31
+ }, {
32
+ groupId: import("convex/values").VString<string, "required">;
33
+ version: import("convex/values").VFloat64<number, "required">;
34
+ actions: import("convex/values").VBytes<ArrayBuffer, "required">;
35
+ serverSignature: import("convex/values").VBytes<ArrayBuffer, "required">;
36
+ changeEpoch: import("convex/values").VFloat64<number, "required">;
37
+ timestamp: import("convex/values").VFloat64<number, "required">;
38
+ }, "required", "actions" | "changeEpoch" | "groupId" | "serverSignature" | "timestamp" | "version">, {
39
+ by_group_id_version: ["groupId", "version", "_creationTime"];
40
+ }, {}, {}>;
41
+ oeGroupServerSnapshots: import("convex/server").TableDefinition<import("convex/values").VObject<{
42
+ baselineSignature: ArrayBuffer;
43
+ encryptedState: ArrayBuffer;
44
+ groupId: string;
45
+ version: number;
46
+ }, {
47
+ groupId: import("convex/values").VString<string, "required">;
48
+ version: import("convex/values").VFloat64<number, "required">;
49
+ encryptedState: import("convex/values").VBytes<ArrayBuffer, "required">;
50
+ baselineSignature: import("convex/values").VBytes<ArrayBuffer, "required">;
51
+ }, "required", "baselineSignature" | "encryptedState" | "groupId" | "version">, {
52
+ by_group_id_version: ["groupId", "version", "_creationTime"];
53
+ }, {}, {}>;
54
+ };
55
+ export interface ConvexGroupServerIdentity {
56
+ /** Raw 16-byte ACI UUID. */
57
+ aciBytes: Uint8Array;
58
+ /** Raw 16-byte PNI UUID, absent when the deployment has no PNI concept. */
59
+ pniBytes?: Uint8Array;
60
+ }
61
+ export interface DefineConvexGroupServerConfig<Context = GenericMutationCtx<GenericDataModel>> {
62
+ /**
63
+ * Resolve the authenticated app session to protocol identifiers.
64
+ *
65
+ * This hook is used only by credential issuance. Anonymous group operations
66
+ * authenticate exclusively through their zero-knowledge presentation.
67
+ */
68
+ identify(ctx: Context): Promise<ConvexGroupServerIdentity>;
69
+ }
70
+ interface InternalDefineConvexGroupServerConfig<Context> extends DefineConvexGroupServerConfig<Context> {
71
+ secretParams?: ServerSecretParams;
72
+ runtime?: GroupServerEngineRuntime;
73
+ }
74
+ declare function buildConvexGroupServer<Context>(config: InternalDefineConvexGroupServerConfig<Context>): {
75
+ createGroup: import("convex/server").RegisteredMutation<"public", {
76
+ encryptedState: ArrayBuffer;
77
+ groupId: ArrayBuffer;
78
+ groupPublicParams: ArrayBuffer;
79
+ presentation: ArrayBuffer;
80
+ }, Promise<null>>;
81
+ getGroup: import("convex/server").RegisteredQuery<"public", {
82
+ groupId: ArrayBuffer;
83
+ groupPublicParams: ArrayBuffer;
84
+ presentation: ArrayBuffer;
85
+ version?: number | undefined;
86
+ }, Promise<{
87
+ encryptedState: ArrayBuffer;
88
+ version: number;
89
+ baselineSignature: ArrayBuffer;
90
+ } | null>>;
91
+ getGroupJoinInfo: import("convex/server").RegisteredQuery<"public", {
92
+ groupId: ArrayBuffer;
93
+ groupPublicParams: ArrayBuffer;
94
+ inviteLinkPassword: ArrayBuffer;
95
+ presentation: ArrayBuffer;
96
+ }, Promise<{
97
+ encryptedJoinInfo: ArrayBuffer;
98
+ version: number;
99
+ } | null>>;
100
+ getGroupChanges: import("convex/server").RegisteredQuery<"public", {
101
+ fromVersion: number;
102
+ groupId: ArrayBuffer;
103
+ groupPublicParams: ArrayBuffer;
104
+ presentation: ArrayBuffer;
105
+ }, Promise<{
106
+ version: number;
107
+ actions: ArrayBuffer;
108
+ serverSignature: ArrayBuffer;
109
+ changeEpoch: number;
110
+ timestamp: number;
111
+ }[]>>;
112
+ submitGroupChange: import("convex/server").RegisteredMutation<"public", {
113
+ actions: ArrayBuffer;
114
+ expectedVersion: number;
115
+ groupId: ArrayBuffer;
116
+ groupPublicParams: ArrayBuffer;
117
+ inviteLinkPassword: ArrayBuffer;
118
+ presentation: ArrayBuffer;
119
+ }, Promise<{
120
+ version: number;
121
+ actions: ArrayBuffer;
122
+ serverSignature: ArrayBuffer;
123
+ changeEpoch: number;
124
+ timestamp: number;
125
+ }>>;
126
+ refreshGroupSendEndorsements: import("convex/server").RegisteredMutation<"public", {
127
+ groupId: ArrayBuffer;
128
+ groupPublicParams: ArrayBuffer;
129
+ presentation: ArrayBuffer;
130
+ }, Promise<{
131
+ endorsements: ArrayBuffer;
132
+ expiration: number;
133
+ }>>;
134
+ issueAuthCredentialMutation: import("convex/server").RegisteredMutation<"public", {}, Promise<ArrayBuffer>>;
135
+ issueProfileKeyCredentialMutation: import("convex/server").RegisteredMutation<"public", {
136
+ profileKey: ArrayBuffer;
137
+ }, Promise<ArrayBuffer>>;
138
+ };
139
+ /**
140
+ * Define the production Convex group-server functions.
141
+ *
142
+ * The returned registered functions own S1–S14 enforcement and persistence.
143
+ * The application supplies only the app-auth-to-protocol-identity hook used
144
+ * by the two credential issuance mutations.
145
+ */
146
+ type ConvexGroupServerHandlers = ReturnType<typeof buildConvexGroupServer>;
147
+ export declare function defineConvexGroupServer(config: DefineConvexGroupServerConfig): ConvexGroupServerHandlers;
148
+ export declare function defineConvexGroupServer<Context>(config: DefineConvexGroupServerConfig<Context>): ConvexGroupServerHandlers;
149
+ export {};
150
+ //# sourceMappingURL=server.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../remote/relay/convex/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EAExB,MAAM,eAAe,CAAC;AAMvB,OAAO,EAEL,KAAK,wBAAwB,EAG9B,MAAM,wCAAwC,CAAC;AAOhD,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,oDAAoD,CAAC;AAyB5D,mFAAmF;AACnF,eAAO,MAAM,kCAAkC,4BACpB,CAAC;AAQ5B;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoBnC,CAAC;AAWF,MAAM,WAAW,yBAAyB;IACxC,4BAA4B;IAC5B,QAAQ,EAAE,UAAU,CAAC;IACrB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,UAAU,CAAC;CACvB;AAED,MAAM,WAAW,6BAA6B,CAC5C,OAAO,GAAG,kBAAkB,CAAC,gBAAgB,CAAC;IAE9C;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;CAC5D;AAED,UAAU,qCAAqC,CAAC,OAAO,CACrD,SAAQ,6BAA6B,CAAC,OAAO,CAAC;IAC9C,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,OAAO,CAAC,EAAE,wBAAwB,CAAC;CACpC;AAmUD,iBAAS,sBAAsB,CAAC,OAAO,EACrC,MAAM,EAAE,qCAAqC,CAAC,OAAO,CAAC;IAOpD,WAAW;;;;;;IA+CX,QAAQ;;;;;;;;;;IAoCR,gBAAgB;;;;;;;;;IAuChB,eAAe;;;;;;;;;;;;IAsCf,iBAAiB;;;;;;;;;;;;;;IA0DjB,4BAA4B;;;;;;;;IAkD5B,2BAA2B;IAsB3B,iCAAiC;;;EAyBpC;AAED;;;;;;GAMG;AACH,KAAK,yBAAyB,GAAG,UAAU,CACzC,OAAO,sBAAsB,CAC9B,CAAC;AAEF,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,6BAA6B,GACpC,yBAAyB,CAAC;AAC7B,wBAAgB,uBAAuB,CAAC,OAAO,EAC7C,MAAM,EAAE,6BAA6B,CAAC,OAAO,CAAC,GAC7C,yBAAyB,CAAC"}
@@ -0,0 +1,506 @@
1
+ import { defineTable, mutationGeneric, queryGeneric, } from 'convex/server';
2
+ import { ConvexError, v } from 'convex/values';
3
+ import { GroupAuthorizationServerEngine, } from '../../../internal/groups/server-engine.js';
4
+ import { deserializeEncryptedGroup } from '../../../internal/groups/wire.js';
5
+ import { base64ToBytes, bytesToBase64, } from '../../../internal/crypto/utils.js';
6
+ import { asBase64 } from '../../../types/utils.js';
7
+ import { generateServerSecretParams, } from '../../../internal/protocol/zk/groups/server-params.js';
8
+ import { issueAuthCredential, serializeAuthCredentialResponse, } from '../../../internal/protocol/zk/groups/auth-credential.js';
9
+ import { issueProfileKeyCredential, serializeProfileKeyCredentialResponse, } from '../../../internal/protocol/zk/groups/profile-key-credential.js';
10
+ import { SERVICE_ID_ACI, SERVICE_ID_PNI, } from '../../../internal/protocol/zk/groups/uid-struct.js';
11
+ import { SECONDS_PER_DAY } from '../../../internal/protocol/zk/groups/group-params.js';
12
+ import { defaultExpiration, deriveForExpiration, issueEndorsements, serializeEndorsementsResponse, } from '../../../internal/protocol/zk/groups/group-send-endorsement.js';
13
+ import { UidEncryptionDomain } from '../../../internal/protocol/zk/groups/uid-encryption.js';
14
+ import { Ciphertext } from '../../../internal/protocol/zk/credentials/attributes.js';
15
+ import { RistrettoPoint } from '../../../internal/protocol/zk/proofs/sho.js';
16
+ /** Convex environment variable containing the deployment's base64 32-byte seed. */
17
+ export const CONVEX_GROUP_SERVER_SECRET_ENV_VAR = 'OE_GROUPS_SERVER_SECRET';
18
+ const GROUPS_TABLE = 'oeGroupServerGroups';
19
+ const CHANGES_TABLE = 'oeGroupServerChanges';
20
+ const SNAPSHOTS_TABLE = 'oeGroupServerSnapshots';
21
+ const UUID_LENGTH = 16;
22
+ const PROFILE_KEY_LENGTH = 32;
23
+ /**
24
+ * Tables owned by `defineConvexGroupServer`.
25
+ *
26
+ * Spread this object into the application's `defineSchema` call. The names are
27
+ * package-scoped so the enforcing server can be mounted without app callbacks.
28
+ */
29
+ export const convexGroupServerTables = {
30
+ [GROUPS_TABLE]: defineTable({
31
+ groupId: v.string(),
32
+ encryptedState: v.bytes(),
33
+ version: v.number(),
34
+ }).index('by_group_id', ['groupId']),
35
+ [CHANGES_TABLE]: defineTable({
36
+ groupId: v.string(),
37
+ version: v.number(),
38
+ actions: v.bytes(),
39
+ serverSignature: v.bytes(),
40
+ changeEpoch: v.number(),
41
+ timestamp: v.number(),
42
+ }).index('by_group_id_version', ['groupId', 'version']),
43
+ [SNAPSHOTS_TABLE]: defineTable({
44
+ groupId: v.string(),
45
+ version: v.number(),
46
+ encryptedState: v.bytes(),
47
+ baselineSignature: v.bytes(),
48
+ }).index('by_group_id_version', ['groupId', 'version']),
49
+ };
50
+ const changeResultValidator = v.object({
51
+ version: v.number(),
52
+ actions: v.bytes(),
53
+ serverSignature: v.bytes(),
54
+ changeEpoch: v.number(),
55
+ timestamp: v.number(),
56
+ });
57
+ const snapshotResultValidator = v.object({
58
+ encryptedState: v.bytes(),
59
+ version: v.number(),
60
+ baselineSignature: v.bytes(),
61
+ });
62
+ function toUint8Array(value) {
63
+ return new Uint8Array(value);
64
+ }
65
+ function toArrayBuffer(value) {
66
+ return value.buffer.slice(value.byteOffset, value.byteOffset + value.byteLength);
67
+ }
68
+ function groupIdKey(groupId) {
69
+ return Array.from(groupId, (byte) => byte.toString(16).padStart(2, '0')).join('');
70
+ }
71
+ function authorization(input) {
72
+ return {
73
+ presentation: toUint8Array(input.presentation),
74
+ groupPublicParams: toUint8Array(input.groupPublicParams),
75
+ };
76
+ }
77
+ function defaultConvexRuntime() {
78
+ return {
79
+ now: () => Date.now(),
80
+ randomBytes: (length) => crypto.getRandomValues(new Uint8Array(length)),
81
+ };
82
+ }
83
+ /**
84
+ * Derived server parameters, cached per isolate and keyed by the exact
85
+ * environment value so a rotated secret is picked up on the next request.
86
+ * Derivation costs tens of milliseconds; without the cache every query and
87
+ * mutation would pay it before doing any work.
88
+ */
89
+ let cachedSecretParams = null;
90
+ function secretParamsFromEnvironment() {
91
+ const encoded = process.env[CONVEX_GROUP_SERVER_SECRET_ENV_VAR];
92
+ if (!encoded) {
93
+ throw new Error(`${CONVEX_GROUP_SERVER_SECRET_ENV_VAR} is not configured; run npx oe-groups trust-root before deploying the group server`);
94
+ }
95
+ if (cachedSecretParams && cachedSecretParams.encoded === encoded) {
96
+ return cachedSecretParams.params;
97
+ }
98
+ let seed;
99
+ try {
100
+ seed = base64ToBytes(asBase64(encoded));
101
+ }
102
+ catch {
103
+ throw new Error(`${CONVEX_GROUP_SERVER_SECRET_ENV_VAR} must be canonical base64`);
104
+ }
105
+ try {
106
+ if (seed.length !== 32) {
107
+ throw new Error(`${CONVEX_GROUP_SERVER_SECRET_ENV_VAR} must decode to exactly 32 bytes`);
108
+ }
109
+ if (bytesToBase64(seed) !== encoded) {
110
+ throw new Error(`${CONVEX_GROUP_SERVER_SECRET_ENV_VAR} must be canonical base64`);
111
+ }
112
+ const params = generateServerSecretParams(seed);
113
+ cachedSecretParams = { encoded, params };
114
+ return params;
115
+ }
116
+ finally {
117
+ seed.fill(0);
118
+ }
119
+ }
120
+ function requireUuid(value, label) {
121
+ if (!(value instanceof Uint8Array) || value.length !== UUID_LENGTH) {
122
+ throw new Error(`${label} must be a ${UUID_LENGTH}-byte UUID`);
123
+ }
124
+ if (value.every((byte) => byte === 0)) {
125
+ throw new Error(`${label} must not be the nil UUID`);
126
+ }
127
+ return value;
128
+ }
129
+ function requireProfileKey(value) {
130
+ const profileKey = toUint8Array(value);
131
+ if (profileKey.length !== PROFILE_KEY_LENGTH) {
132
+ throw new Error(`profileKey must be ${PROFILE_KEY_LENGTH} bytes`);
133
+ }
134
+ return profileKey;
135
+ }
136
+ /**
137
+ * Translate an engine rejection into a `ConvexError` so its structured
138
+ * `{ code, status }` data survives serialization to real deployments.
139
+ * Production Convex strips custom properties (including `data`) from plain
140
+ * `Error`s and replaces their messages with a generic server error; only
141
+ * `ConvexError` payloads reach the client, and the client's VERSION_CONFLICT
142
+ * rebase-and-retry loop depends on reading `error.data.code`.
143
+ */
144
+ async function translateEngineErrors(operation) {
145
+ try {
146
+ return await operation();
147
+ }
148
+ catch (error) {
149
+ if (!(error instanceof ConvexError) && error instanceof Error) {
150
+ const data = error
151
+ .data;
152
+ if (data !== null &&
153
+ typeof data === 'object' &&
154
+ typeof data.code === 'string' &&
155
+ typeof data.status === 'number') {
156
+ throw new ConvexError({
157
+ code: data.code,
158
+ status: data.status,
159
+ message: error.message,
160
+ });
161
+ }
162
+ }
163
+ throw error;
164
+ }
165
+ }
166
+ function serviceIds(identity) {
167
+ if (identity === null || typeof identity !== 'object') {
168
+ throw new ConvexError({
169
+ code: 'UNAUTHORIZED',
170
+ status: 401,
171
+ message: 'identify() returned no identity',
172
+ });
173
+ }
174
+ const aci = {
175
+ kind: SERVICE_ID_ACI,
176
+ uuid: requireUuid(identity.aciBytes, 'identify().aciBytes'),
177
+ };
178
+ const pni = identity.pniBytes === undefined
179
+ ? undefined
180
+ : {
181
+ kind: SERVICE_ID_PNI,
182
+ uuid: requireUuid(identity.pniBytes, 'identify().pniBytes'),
183
+ };
184
+ return { aci, pni };
185
+ }
186
+ async function getGroupDocument(ctx, key) {
187
+ return await ctx.db
188
+ .query(GROUPS_TABLE)
189
+ .withIndex('by_group_id', (query) => query.eq('groupId', key))
190
+ .unique();
191
+ }
192
+ async function getSnapshotDocument(ctx, key, version) {
193
+ return await ctx.db
194
+ .query(SNAPSHOTS_TABLE)
195
+ // The generic data model loses the chained index-range builder type;
196
+ // the runtime builder supports the full compound range.
197
+ .withIndex('by_group_id_version', (query) => query.eq('groupId', key).eq('version', version))
198
+ .unique();
199
+ }
200
+ function persistedSnapshot(document) {
201
+ return {
202
+ version: document.version,
203
+ encryptedState: toUint8Array(document.encryptedState),
204
+ baselineSignature: toUint8Array(document.baselineSignature),
205
+ };
206
+ }
207
+ async function loadEngine(ctx, groupId, secretParams, runtime, options = {}) {
208
+ const engine = new GroupAuthorizationServerEngine(secretParams, runtime);
209
+ const key = groupIdKey(groupId);
210
+ const groupDocument = await getGroupDocument(ctx, key);
211
+ if (!groupDocument)
212
+ return { engine, groupDocument: null };
213
+ const snapshots = [];
214
+ for (const version of new Set(options.snapshotVersions ?? [])) {
215
+ const snapshot = await getSnapshotDocument(ctx, key, version);
216
+ if (snapshot)
217
+ snapshots.push(persistedSnapshot(snapshot));
218
+ }
219
+ const changes = [];
220
+ if (options.changesAfterVersion !== undefined) {
221
+ const documents = await ctx.db
222
+ .query(CHANGES_TABLE)
223
+ // The generic data model loses the chained index-range builder type;
224
+ // the runtime builder supports the full compound range.
225
+ .withIndex('by_group_id_version', (query) => query
226
+ .eq('groupId', key)
227
+ .gt('version', options.changesAfterVersion))
228
+ .order('asc')
229
+ .collect();
230
+ for (const document of documents) {
231
+ changes.push({
232
+ version: document.version,
233
+ actions: toUint8Array(document.actions),
234
+ serverSignature: toUint8Array(document.serverSignature),
235
+ changeEpoch: document.changeEpoch,
236
+ timestamp: document.timestamp,
237
+ });
238
+ const snapshot = await getSnapshotDocument(ctx, key, document.version);
239
+ if (!snapshot) {
240
+ throw new Error(`Missing group snapshot ${document.version}`);
241
+ }
242
+ snapshots.push(persistedSnapshot(snapshot));
243
+ }
244
+ }
245
+ const persisted = {
246
+ encryptedState: toUint8Array(groupDocument.encryptedState),
247
+ changes,
248
+ snapshots,
249
+ };
250
+ engine.restoreGroup(groupId, persisted);
251
+ return { engine, groupDocument };
252
+ }
253
+ async function insertSnapshot(ctx, key, snapshot) {
254
+ await ctx.db.insert(SNAPSHOTS_TABLE, {
255
+ groupId: key,
256
+ version: snapshot.version,
257
+ encryptedState: toArrayBuffer(snapshot.encryptedState),
258
+ baselineSignature: toArrayBuffer(snapshot.baselineSignature),
259
+ });
260
+ }
261
+ async function insertChange(ctx, key, change) {
262
+ await ctx.db.insert(CHANGES_TABLE, {
263
+ groupId: key,
264
+ version: change.version,
265
+ actions: toArrayBuffer(change.actions),
266
+ serverSignature: toArrayBuffer(change.serverSignature),
267
+ changeEpoch: change.changeEpoch,
268
+ timestamp: change.timestamp,
269
+ });
270
+ }
271
+ function memberCiphertexts(encryptedState) {
272
+ const state = deserializeEncryptedGroup(encryptedState);
273
+ return state.members.map((member) => {
274
+ if (member.userId.length !== 65) {
275
+ throw new Error('Stored member identifier must be 65 bytes');
276
+ }
277
+ return new Ciphertext(RistrettoPoint.fromBytes(member.userId.slice(1, 33)), RistrettoPoint.fromBytes(member.userId.slice(33, 65)), UidEncryptionDomain);
278
+ });
279
+ }
280
+ function buildConvexGroupServer(config) {
281
+ const runtime = config.runtime ?? defaultConvexRuntime();
282
+ const getSecretParams = () => config.secretParams ?? secretParamsFromEnvironment();
283
+ return {
284
+ createGroup: mutationGeneric({
285
+ args: {
286
+ groupId: v.bytes(),
287
+ encryptedState: v.bytes(),
288
+ presentation: v.bytes(),
289
+ groupPublicParams: v.bytes(),
290
+ },
291
+ returns: v.null(),
292
+ handler: async (ctx, input) => {
293
+ const groupId = toUint8Array(input.groupId);
294
+ const secretParams = getSecretParams();
295
+ const { engine, groupDocument } = await loadEngine(ctx, groupId, secretParams, runtime);
296
+ if (groupDocument) {
297
+ throw new ConvexError({
298
+ code: 'VERSION_CONFLICT',
299
+ status: 409,
300
+ message: 'Group already exists',
301
+ });
302
+ }
303
+ await translateEngineErrors(() => engine.createGroup(groupId, toUint8Array(input.encryptedState), authorization(input)));
304
+ const persisted = engine.exportGroup(groupId);
305
+ if (!persisted || persisted.snapshots.length !== 1) {
306
+ throw new Error('Group creation did not produce one snapshot');
307
+ }
308
+ const key = groupIdKey(groupId);
309
+ const state = deserializeEncryptedGroup(persisted.encryptedState);
310
+ await ctx.db.insert(GROUPS_TABLE, {
311
+ groupId: key,
312
+ encryptedState: toArrayBuffer(persisted.encryptedState),
313
+ version: state.version,
314
+ });
315
+ await insertSnapshot(ctx, key, persisted.snapshots[0]);
316
+ return null;
317
+ },
318
+ }),
319
+ getGroup: queryGeneric({
320
+ args: {
321
+ groupId: v.bytes(),
322
+ presentation: v.bytes(),
323
+ groupPublicParams: v.bytes(),
324
+ version: v.optional(v.number()),
325
+ },
326
+ returns: v.union(snapshotResultValidator, v.null()),
327
+ handler: async (ctx, input) => {
328
+ const groupId = toUint8Array(input.groupId);
329
+ const key = groupIdKey(groupId);
330
+ const groupDocument = await getGroupDocument(ctx, key);
331
+ if (!groupDocument)
332
+ return null;
333
+ const version = input.version ?? groupDocument.version;
334
+ const secretParams = getSecretParams();
335
+ const { engine } = await loadEngine(ctx, groupId, secretParams, runtime, { snapshotVersions: [version] });
336
+ const result = await translateEngineErrors(() => engine.getGroup(groupId, authorization(input), input.version));
337
+ return result
338
+ ? {
339
+ encryptedState: toArrayBuffer(result.encryptedState),
340
+ version: result.version,
341
+ baselineSignature: toArrayBuffer(result.baselineSignature),
342
+ }
343
+ : null;
344
+ },
345
+ }),
346
+ getGroupJoinInfo: queryGeneric({
347
+ args: {
348
+ groupId: v.bytes(),
349
+ inviteLinkPassword: v.bytes(),
350
+ presentation: v.bytes(),
351
+ groupPublicParams: v.bytes(),
352
+ },
353
+ returns: v.union(v.object({
354
+ encryptedJoinInfo: v.bytes(),
355
+ version: v.number(),
356
+ }), v.null()),
357
+ handler: async (ctx, input) => {
358
+ const groupId = toUint8Array(input.groupId);
359
+ const { engine, groupDocument } = await loadEngine(ctx, groupId, getSecretParams(), runtime);
360
+ if (!groupDocument)
361
+ return null;
362
+ const result = await translateEngineErrors(() => engine.getGroupJoinInfo(groupId, toUint8Array(input.inviteLinkPassword), authorization(input)));
363
+ return result
364
+ ? {
365
+ encryptedJoinInfo: toArrayBuffer(result.encryptedJoinInfo),
366
+ version: result.version,
367
+ }
368
+ : null;
369
+ },
370
+ }),
371
+ getGroupChanges: queryGeneric({
372
+ args: {
373
+ groupId: v.bytes(),
374
+ fromVersion: v.number(),
375
+ presentation: v.bytes(),
376
+ groupPublicParams: v.bytes(),
377
+ },
378
+ returns: v.array(changeResultValidator),
379
+ handler: async (ctx, input) => {
380
+ const groupId = toUint8Array(input.groupId);
381
+ const { engine, groupDocument } = await loadEngine(ctx, groupId, getSecretParams(), runtime, {
382
+ snapshotVersions: [input.fromVersion],
383
+ changesAfterVersion: input.fromVersion,
384
+ });
385
+ if (!groupDocument)
386
+ return [];
387
+ const result = await translateEngineErrors(() => engine.getGroupChanges(groupId, input.fromVersion, authorization(input)));
388
+ return result.map((entry) => ({
389
+ version: entry.version,
390
+ actions: toArrayBuffer(entry.actions),
391
+ serverSignature: toArrayBuffer(entry.serverSignature),
392
+ changeEpoch: entry.changeEpoch,
393
+ timestamp: entry.timestamp,
394
+ }));
395
+ },
396
+ }),
397
+ submitGroupChange: mutationGeneric({
398
+ args: {
399
+ groupId: v.bytes(),
400
+ expectedVersion: v.number(),
401
+ actions: v.bytes(),
402
+ inviteLinkPassword: v.bytes(),
403
+ presentation: v.bytes(),
404
+ groupPublicParams: v.bytes(),
405
+ },
406
+ returns: changeResultValidator,
407
+ handler: async (ctx, input) => {
408
+ const groupId = toUint8Array(input.groupId);
409
+ const { engine, groupDocument } = await loadEngine(ctx, groupId, getSecretParams(), runtime);
410
+ if (!groupDocument) {
411
+ throw new ConvexError({
412
+ code: 'INVALID_REQUEST',
413
+ status: 400,
414
+ message: 'Group does not exist',
415
+ });
416
+ }
417
+ const result = await translateEngineErrors(() => engine.submitGroupChange(groupId, input.expectedVersion, toUint8Array(input.actions), toUint8Array(input.inviteLinkPassword), authorization(input)));
418
+ const persisted = engine.exportGroup(groupId);
419
+ const nextSnapshot = persisted?.snapshots.find((snapshot) => snapshot.version === result.version);
420
+ if (!persisted || !nextSnapshot) {
421
+ throw new Error('Accepted change did not produce a snapshot');
422
+ }
423
+ const key = groupIdKey(groupId);
424
+ await ctx.db.patch(groupDocument._id, {
425
+ encryptedState: toArrayBuffer(persisted.encryptedState),
426
+ version: result.version,
427
+ });
428
+ await insertChange(ctx, key, result);
429
+ await insertSnapshot(ctx, key, nextSnapshot);
430
+ return {
431
+ version: result.version,
432
+ actions: toArrayBuffer(result.actions),
433
+ serverSignature: toArrayBuffer(result.serverSignature),
434
+ changeEpoch: result.changeEpoch,
435
+ timestamp: result.timestamp,
436
+ };
437
+ },
438
+ }),
439
+ refreshGroupSendEndorsements: mutationGeneric({
440
+ args: {
441
+ groupId: v.bytes(),
442
+ presentation: v.bytes(),
443
+ groupPublicParams: v.bytes(),
444
+ },
445
+ returns: v.object({
446
+ endorsements: v.bytes(),
447
+ expiration: v.number(),
448
+ }),
449
+ handler: async (ctx, input) => {
450
+ const groupId = toUint8Array(input.groupId);
451
+ const key = groupIdKey(groupId);
452
+ const groupDocument = await getGroupDocument(ctx, key);
453
+ if (!groupDocument)
454
+ throw new Error('Group not found');
455
+ const version = groupDocument.version;
456
+ const secretParams = getSecretParams();
457
+ const { engine } = await loadEngine(ctx, groupId, secretParams, runtime, { snapshotVersions: [version] });
458
+ const group = await translateEngineErrors(() => engine.getGroup(groupId, authorization(input)));
459
+ if (!group)
460
+ throw new Error('Group not found');
461
+ const members = memberCiphertexts(group.encryptedState);
462
+ if (members.length === 0)
463
+ throw new Error('Empty group');
464
+ const expiration = defaultExpiration(Math.floor(runtime.now() / 1000));
465
+ const response = issueEndorsements(members, deriveForExpiration(secretParams.endorsementKeyPair, expiration), runtime.randomBytes(32));
466
+ return {
467
+ endorsements: toArrayBuffer(serializeEndorsementsResponse(response)),
468
+ expiration,
469
+ };
470
+ },
471
+ }),
472
+ issueAuthCredentialMutation: mutationGeneric({
473
+ args: {},
474
+ returns: v.bytes(),
475
+ handler: async (ctx) => {
476
+ const { aci, pni } = serviceIds(await config.identify(ctx));
477
+ const nowSeconds = Math.floor(runtime.now() / 1000);
478
+ const redemptionTime = Math.floor(nowSeconds / SECONDS_PER_DAY) *
479
+ SECONDS_PER_DAY;
480
+ const response = issueAuthCredential(getSecretParams().credentialKeyPair, aci, pni, redemptionTime, runtime.randomBytes(32));
481
+ return toArrayBuffer(serializeAuthCredentialResponse(response));
482
+ },
483
+ }),
484
+ issueProfileKeyCredentialMutation: mutationGeneric({
485
+ args: { profileKey: v.bytes() },
486
+ returns: v.bytes(),
487
+ handler: async (ctx, input) => {
488
+ const { aci } = serviceIds(await config.identify(ctx));
489
+ const nowSeconds = Math.floor(runtime.now() / 1000);
490
+ const redemptionTime = Math.floor(nowSeconds / SECONDS_PER_DAY) *
491
+ SECONDS_PER_DAY +
492
+ 2 * SECONDS_PER_DAY;
493
+ const response = issueProfileKeyCredential(getSecretParams().profileKeyCredentialKeyPair, aci, requireProfileKey(input.profileKey), redemptionTime, runtime.randomBytes(32));
494
+ return toArrayBuffer(serializeProfileKeyCredentialResponse(response));
495
+ },
496
+ }),
497
+ };
498
+ }
499
+ export function defineConvexGroupServer(config) {
500
+ return buildConvexGroupServer(config);
501
+ }
502
+ /** @internal Test-only deterministic secret/runtime injection seam. */
503
+ export function defineConvexGroupServerForTest(config) {
504
+ return buildConvexGroupServer(config);
505
+ }
506
+ //# sourceMappingURL=server.js.map