@open-e2ee/signal-protocol-sdk 0.1.0-alpha.6 → 0.1.0-alpha.8

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 (730) hide show
  1. package/ADAPTERS.md +1 -1
  2. package/ARCHITECTURE.md +1 -1
  3. package/CHANGELOG.md +876 -3
  4. package/COMMERCIAL.md +56 -0
  5. package/README.md +13 -8
  6. package/SECURITY.md +15 -1
  7. package/client/README.md +1 -1
  8. package/dist/client/client.d.ts +32 -28
  9. package/dist/client/client.d.ts.map +1 -1
  10. package/dist/client/client.js +136 -80
  11. package/dist/client/client.js.map +1 -1
  12. package/dist/client/compose.d.ts +6 -1
  13. package/dist/client/compose.d.ts.map +1 -1
  14. package/dist/client/compose.js +2 -0
  15. package/dist/client/compose.js.map +1 -1
  16. package/dist/client/config.d.ts +53 -19
  17. package/dist/client/config.d.ts.map +1 -1
  18. package/dist/client/config.js.map +1 -1
  19. package/dist/client/endorsement-manager.d.ts +23 -2
  20. package/dist/client/endorsement-manager.d.ts.map +1 -1
  21. package/dist/client/endorsement-manager.js +35 -10
  22. package/dist/client/endorsement-manager.js.map +1 -1
  23. package/dist/client/groups.d.ts +29 -29
  24. package/dist/client/groups.d.ts.map +1 -1
  25. package/dist/client/groups.js +54 -37
  26. package/dist/client/groups.js.map +1 -1
  27. package/dist/client/headless.d.ts +1 -1
  28. package/dist/client/headless.js +1 -1
  29. package/dist/client/sealed-sender-ops.d.ts +27 -1
  30. package/dist/client/sealed-sender-ops.d.ts.map +1 -1
  31. package/dist/client/sealed-sender-ops.js +36 -6
  32. package/dist/client/sealed-sender-ops.js.map +1 -1
  33. package/dist/client/signal-service-cipher.d.ts +21 -2
  34. package/dist/client/signal-service-cipher.d.ts.map +1 -1
  35. package/dist/client/signal-service-cipher.js +119 -53
  36. package/dist/client/signal-service-cipher.js.map +1 -1
  37. package/dist/client/types.d.ts +20 -7
  38. package/dist/client/types.d.ts.map +1 -1
  39. package/dist/client/types.js.map +1 -1
  40. package/dist/groups/index.d.ts +4 -4
  41. package/dist/groups/index.d.ts.map +1 -1
  42. package/dist/groups/index.js +3 -3
  43. package/dist/groups/index.js.map +1 -1
  44. package/dist/index.d.ts +12 -5
  45. package/dist/index.d.ts.map +1 -1
  46. package/dist/index.js +10 -3
  47. package/dist/index.js.map +1 -1
  48. package/dist/internal/crypto/index.d.ts +1 -1
  49. package/dist/internal/crypto/index.d.ts.map +1 -1
  50. package/dist/internal/crypto/index.js +1 -1
  51. package/dist/internal/crypto/index.js.map +1 -1
  52. package/dist/internal/crypto/random.d.ts +9 -0
  53. package/dist/internal/crypto/random.d.ts.map +1 -1
  54. package/dist/internal/crypto/random.js +16 -0
  55. package/dist/internal/crypto/random.js.map +1 -1
  56. package/dist/internal/groups/access-control.d.ts +170 -0
  57. package/dist/internal/groups/access-control.d.ts.map +1 -0
  58. package/dist/internal/groups/access-control.js +284 -0
  59. package/dist/internal/groups/access-control.js.map +1 -0
  60. package/dist/internal/groups/change-actions.d.ts +57 -0
  61. package/dist/internal/groups/change-actions.d.ts.map +1 -0
  62. package/dist/internal/groups/change-actions.js +827 -0
  63. package/dist/internal/groups/change-actions.js.map +1 -0
  64. package/dist/internal/groups/change-authorization.d.ts +16 -0
  65. package/dist/internal/groups/change-authorization.d.ts.map +1 -0
  66. package/dist/internal/groups/change-authorization.js +120 -0
  67. package/dist/internal/groups/change-authorization.js.map +1 -0
  68. package/dist/internal/{groups-v2 → groups}/encrypted-state.d.ts +12 -2
  69. package/dist/internal/groups/encrypted-state.d.ts.map +1 -0
  70. package/dist/internal/{groups-v2 → groups}/encrypted-state.js +122 -22
  71. package/dist/internal/groups/encrypted-state.js.map +1 -0
  72. package/dist/internal/groups/group-id.d.ts +9 -9
  73. package/dist/internal/groups/group-id.d.ts.map +1 -1
  74. package/dist/internal/groups/group-id.js +11 -12
  75. package/dist/internal/groups/group-id.js.map +1 -1
  76. package/dist/internal/groups/index.d.ts +16 -6
  77. package/dist/internal/groups/index.d.ts.map +1 -1
  78. package/dist/internal/groups/index.js +9 -1
  79. package/dist/internal/groups/index.js.map +1 -1
  80. package/dist/internal/groups/invite-link.d.ts.map +1 -0
  81. package/dist/internal/groups/invite-link.js.map +1 -0
  82. package/dist/internal/{groups-v2 → groups}/manager.d.ts +188 -40
  83. package/dist/internal/groups/manager.d.ts.map +1 -0
  84. package/dist/internal/groups/manager.js +1923 -0
  85. package/dist/internal/groups/manager.js.map +1 -0
  86. package/dist/internal/groups/sdk-store.d.ts +32 -0
  87. package/dist/internal/groups/sdk-store.d.ts.map +1 -0
  88. package/dist/internal/groups/sdk-store.js +111 -0
  89. package/dist/internal/groups/sdk-store.js.map +1 -0
  90. package/dist/internal/groups/server-engine.d.ts +83 -0
  91. package/dist/internal/groups/server-engine.d.ts.map +1 -0
  92. package/dist/internal/groups/server-engine.js +1186 -0
  93. package/dist/internal/groups/server-engine.js.map +1 -0
  94. package/dist/internal/groups/trust-root.d.ts +32 -0
  95. package/dist/internal/groups/trust-root.d.ts.map +1 -0
  96. package/dist/internal/groups/trust-root.js +91 -0
  97. package/dist/internal/groups/trust-root.js.map +1 -0
  98. package/dist/internal/{groups-v2 → groups}/types.d.ts +188 -46
  99. package/dist/internal/groups/types.d.ts.map +1 -0
  100. package/dist/internal/{groups-v2 → groups}/types.js +3 -2
  101. package/dist/internal/groups/types.js.map +1 -0
  102. package/dist/internal/groups/wire.d.ts +68 -0
  103. package/dist/internal/groups/wire.d.ts.map +1 -0
  104. package/dist/internal/groups/wire.js +708 -0
  105. package/dist/internal/groups/wire.js.map +1 -0
  106. package/dist/internal/protocol/sealed-sender/decryption-v2.d.ts.map +1 -1
  107. package/dist/internal/protocol/sealed-sender/decryption-v2.js +32 -18
  108. package/dist/internal/protocol/sealed-sender/decryption-v2.js.map +1 -1
  109. package/dist/internal/protocol/sealed-sender/decryption.d.ts.map +1 -1
  110. package/dist/internal/protocol/sealed-sender/decryption.js +33 -19
  111. package/dist/internal/protocol/sealed-sender/decryption.js.map +1 -1
  112. package/dist/internal/protocol/sealed-sender/encryption-v2.d.ts.map +1 -1
  113. package/dist/internal/protocol/sealed-sender/encryption-v2.js +8 -14
  114. package/dist/internal/protocol/sealed-sender/encryption-v2.js.map +1 -1
  115. package/dist/internal/protocol/sealed-sender/encryption.d.ts +9 -4
  116. package/dist/internal/protocol/sealed-sender/encryption.d.ts.map +1 -1
  117. package/dist/internal/protocol/sealed-sender/encryption.js +7 -15
  118. package/dist/internal/protocol/sealed-sender/encryption.js.map +1 -1
  119. package/dist/internal/protocol/sealed-sender/proto/index.d.ts +6 -7
  120. package/dist/internal/protocol/sealed-sender/proto/index.d.ts.map +1 -1
  121. package/dist/internal/protocol/sealed-sender/proto/index.js +5 -7
  122. package/dist/internal/protocol/sealed-sender/proto/index.js.map +1 -1
  123. package/dist/internal/protocol/sealed-sender/trust-root.d.ts +45 -0
  124. package/dist/internal/protocol/sealed-sender/trust-root.d.ts.map +1 -0
  125. package/dist/internal/protocol/sealed-sender/trust-root.js +77 -0
  126. package/dist/internal/protocol/sealed-sender/trust-root.js.map +1 -0
  127. package/dist/internal/protocol/sealed-sender/types.d.ts +64 -9
  128. package/dist/internal/protocol/sealed-sender/types.d.ts.map +1 -1
  129. package/dist/internal/protocol/sealed-sender/types.js +43 -0
  130. package/dist/internal/protocol/sealed-sender/types.js.map +1 -1
  131. package/dist/internal/protocol/sender-keys/index.d.ts +1 -1
  132. package/dist/internal/protocol/sender-keys/manager.d.ts +38 -1
  133. package/dist/internal/protocol/sender-keys/manager.d.ts.map +1 -1
  134. package/dist/internal/protocol/sender-keys/manager.js +109 -8
  135. package/dist/internal/protocol/sender-keys/manager.js.map +1 -1
  136. package/dist/internal/protocol/zk/groups/auth-credential.d.ts +9 -7
  137. package/dist/internal/protocol/zk/groups/auth-credential.d.ts.map +1 -1
  138. package/dist/internal/protocol/zk/groups/auth-credential.js +68 -29
  139. package/dist/internal/protocol/zk/groups/auth-credential.js.map +1 -1
  140. package/dist/internal/protocol/zk/groups/server-params.d.ts +1 -1
  141. package/dist/internal/protocol/zk/groups/server-params.d.ts.map +1 -1
  142. package/dist/internal/protocol/zk/groups/server-params.js.map +1 -1
  143. package/dist/internal/protocol/zk/groups/uid-struct.d.ts +2 -0
  144. package/dist/internal/protocol/zk/groups/uid-struct.d.ts.map +1 -1
  145. package/dist/internal/protocol/zk/groups/uid-struct.js +4 -0
  146. package/dist/internal/protocol/zk/groups/uid-struct.js.map +1 -1
  147. package/dist/layers.d.ts +1 -1
  148. package/dist/layers.js +3 -3
  149. package/dist/layers.js.map +1 -1
  150. package/dist/local/store/expo/adapter.d.ts +14 -15
  151. package/dist/local/store/expo/adapter.d.ts.map +1 -1
  152. package/dist/local/store/expo/adapter.js +109 -102
  153. package/dist/local/store/expo/adapter.js.map +1 -1
  154. package/dist/local/store/expo/db.d.ts +4 -1
  155. package/dist/local/store/expo/db.d.ts.map +1 -1
  156. package/dist/local/store/expo/db.js +5 -0
  157. package/dist/local/store/expo/db.js.map +1 -1
  158. package/dist/local/store/expo/index.d.ts +0 -2
  159. package/dist/local/store/expo/index.d.ts.map +1 -1
  160. package/dist/local/store/expo/index.js +1 -1
  161. package/dist/local/store/expo/index.js.map +1 -1
  162. package/dist/local/store/expo/models/index.d.ts +1 -1
  163. package/dist/local/store/expo/models/index.d.ts.map +1 -1
  164. package/dist/local/store/expo/models/index.js +2 -2
  165. package/dist/local/store/expo/models/index.js.map +1 -1
  166. package/dist/local/store/expo/models/sender-key.d.ts +101 -77
  167. package/dist/local/store/expo/models/sender-key.d.ts.map +1 -1
  168. package/dist/local/store/expo/models/sender-key.js +154 -124
  169. package/dist/local/store/expo/models/sender-key.js.map +1 -1
  170. package/dist/local/store/expo/schema.d.ts +134 -32
  171. package/dist/local/store/expo/schema.d.ts.map +1 -1
  172. package/dist/local/store/expo/schema.js +36 -7
  173. package/dist/local/store/expo/schema.js.map +1 -1
  174. package/dist/local/store/mock/adapter.d.ts +1 -0
  175. package/dist/local/store/mock/adapter.d.ts.map +1 -1
  176. package/dist/local/store/mock/adapter.js +18 -0
  177. package/dist/local/store/mock/adapter.js.map +1 -1
  178. package/dist/local/store/react-native/adapter.d.ts +39 -0
  179. package/dist/local/store/react-native/adapter.d.ts.map +1 -1
  180. package/dist/local/store/react-native/adapter.js +163 -8
  181. package/dist/local/store/react-native/adapter.js.map +1 -1
  182. package/dist/local/store/web/adapter.d.ts +1 -0
  183. package/dist/local/store/web/adapter.d.ts.map +1 -1
  184. package/dist/local/store/web/adapter.js +33 -1
  185. package/dist/local/store/web/adapter.js.map +1 -1
  186. package/dist/remote/relay/convex/backend.d.ts +402 -0
  187. package/dist/remote/relay/convex/backend.d.ts.map +1 -0
  188. package/dist/remote/relay/convex/backend.js +684 -0
  189. package/dist/remote/relay/convex/backend.js.map +1 -0
  190. package/dist/remote/relay/convex/component/_generated/api.d.ts +58 -0
  191. package/dist/remote/relay/convex/component/_generated/api.d.ts.map +1 -0
  192. package/dist/remote/relay/convex/component/_generated/api.js +31 -0
  193. package/dist/remote/relay/convex/component/_generated/api.js.map +1 -0
  194. package/dist/remote/relay/convex/component/_generated/component.d.ts +480 -0
  195. package/dist/remote/relay/convex/component/_generated/component.d.ts.map +1 -0
  196. package/dist/remote/relay/convex/component/_generated/component.js +11 -0
  197. package/dist/remote/relay/convex/component/_generated/component.js.map +1 -0
  198. package/dist/remote/relay/convex/component/_generated/dataModel.d.ts +46 -0
  199. package/dist/remote/relay/convex/component/_generated/dataModel.d.ts.map +1 -0
  200. package/dist/remote/relay/convex/component/_generated/dataModel.js +11 -0
  201. package/dist/remote/relay/convex/component/_generated/dataModel.js.map +1 -0
  202. package/dist/remote/relay/convex/component/_generated/server.d.ts +129 -0
  203. package/dist/remote/relay/convex/component/_generated/server.d.ts.map +1 -0
  204. package/dist/remote/relay/convex/component/_generated/server.js +79 -0
  205. package/dist/remote/relay/convex/component/_generated/server.js.map +1 -0
  206. package/dist/remote/relay/convex/component/accounts.d.ts +43 -0
  207. package/dist/remote/relay/convex/component/accounts.d.ts.map +1 -0
  208. package/dist/remote/relay/convex/component/accounts.js +181 -0
  209. package/dist/remote/relay/convex/component/accounts.js.map +1 -0
  210. package/dist/remote/relay/convex/component/certificates.d.ts +10 -0
  211. package/dist/remote/relay/convex/component/certificates.d.ts.map +1 -0
  212. package/dist/remote/relay/convex/component/certificates.js +122 -0
  213. package/dist/remote/relay/convex/component/certificates.js.map +1 -0
  214. package/dist/remote/relay/convex/component/cleanup.d.ts +26 -0
  215. package/dist/remote/relay/convex/component/cleanup.d.ts.map +1 -0
  216. package/dist/remote/relay/convex/component/cleanup.js +127 -0
  217. package/dist/remote/relay/convex/component/cleanup.js.map +1 -0
  218. package/dist/remote/relay/convex/component/convex.config.d.ts +5 -0
  219. package/dist/remote/relay/convex/component/convex.config.d.ts.map +1 -0
  220. package/dist/remote/relay/convex/component/convex.config.js +33 -0
  221. package/dist/remote/relay/convex/component/convex.config.js.map +1 -0
  222. package/dist/remote/relay/convex/component/crons.d.ts +3 -0
  223. package/dist/remote/relay/convex/component/crons.d.ts.map +1 -0
  224. package/dist/remote/relay/convex/component/crons.js +9 -0
  225. package/dist/remote/relay/convex/component/crons.js.map +1 -0
  226. package/dist/remote/relay/convex/component/devices.d.ts +101 -0
  227. package/dist/remote/relay/convex/component/devices.d.ts.map +1 -0
  228. package/dist/remote/relay/convex/component/devices.js +299 -0
  229. package/dist/remote/relay/convex/component/devices.js.map +1 -0
  230. package/dist/remote/relay/convex/component/errors.d.ts +22 -0
  231. package/dist/remote/relay/convex/component/errors.d.ts.map +1 -0
  232. package/dist/remote/relay/convex/component/errors.js +17 -0
  233. package/dist/remote/relay/convex/component/errors.js.map +1 -0
  234. package/dist/remote/relay/convex/component/groups.d.ts +60 -0
  235. package/dist/remote/relay/convex/component/groups.d.ts.map +1 -0
  236. package/dist/remote/relay/convex/component/groups.js +331 -0
  237. package/dist/remote/relay/convex/component/groups.js.map +1 -0
  238. package/dist/remote/relay/convex/component/keys.d.ts +130 -0
  239. package/dist/remote/relay/convex/component/keys.d.ts.map +1 -0
  240. package/dist/remote/relay/convex/component/keys.js +578 -0
  241. package/dist/remote/relay/convex/component/keys.js.map +1 -0
  242. package/dist/remote/relay/convex/component/messages.d.ts +119 -0
  243. package/dist/remote/relay/convex/component/messages.d.ts.map +1 -0
  244. package/dist/remote/relay/convex/component/messages.js +649 -0
  245. package/dist/remote/relay/convex/component/messages.js.map +1 -0
  246. package/dist/remote/relay/convex/component/provisioning.d.ts +92 -0
  247. package/dist/remote/relay/convex/component/provisioning.d.ts.map +1 -0
  248. package/dist/remote/relay/convex/component/provisioning.js +359 -0
  249. package/dist/remote/relay/convex/component/provisioning.js.map +1 -0
  250. package/dist/remote/relay/convex/component/runtime.d.ts +18 -0
  251. package/dist/remote/relay/convex/component/runtime.d.ts.map +1 -0
  252. package/dist/remote/relay/convex/component/runtime.js +142 -0
  253. package/dist/remote/relay/convex/component/runtime.js.map +1 -0
  254. package/dist/remote/relay/convex/component/schema.d.ts +344 -0
  255. package/dist/remote/relay/convex/component/schema.d.ts.map +1 -0
  256. package/dist/remote/relay/convex/component/schema.js +266 -0
  257. package/dist/remote/relay/convex/component/schema.js.map +1 -0
  258. package/dist/remote/relay/convex/component/zkAuth.d.ts +12 -0
  259. package/dist/remote/relay/convex/component/zkAuth.d.ts.map +1 -0
  260. package/dist/remote/relay/convex/component/zkAuth.js +71 -0
  261. package/dist/remote/relay/convex/component/zkAuth.js.map +1 -0
  262. package/dist/remote/relay/convex/constants.d.ts +3 -0
  263. package/dist/remote/relay/convex/constants.d.ts.map +1 -0
  264. package/dist/remote/relay/convex/constants.js +3 -0
  265. package/dist/remote/relay/convex/constants.js.map +1 -0
  266. package/dist/remote/relay/convex/group-server.d.ts +25 -21
  267. package/dist/remote/relay/convex/group-server.d.ts.map +1 -1
  268. package/dist/remote/relay/convex/group-server.js +51 -21
  269. package/dist/remote/relay/convex/group-server.js.map +1 -1
  270. package/dist/remote/relay/convex/index.d.ts +4 -1
  271. package/dist/remote/relay/convex/index.d.ts.map +1 -1
  272. package/dist/remote/relay/convex/index.js +3 -1
  273. package/dist/remote/relay/convex/index.js.map +1 -1
  274. package/dist/remote/relay/convex/relay.d.ts +54 -67
  275. package/dist/remote/relay/convex/relay.d.ts.map +1 -1
  276. package/dist/remote/relay/convex/relay.js +123 -42
  277. package/dist/remote/relay/convex/relay.js.map +1 -1
  278. package/dist/remote/relay/convex/types.d.ts +16 -103
  279. package/dist/remote/relay/convex/types.d.ts.map +1 -1
  280. package/dist/remote/relay/convex/types.js +8 -13
  281. package/dist/remote/relay/convex/types.js.map +1 -1
  282. package/dist/remote/relay/index.d.ts +1 -1
  283. package/dist/remote/relay/index.d.ts.map +1 -1
  284. package/dist/remote/relay/mock/adapter.d.ts +33 -20
  285. package/dist/remote/relay/mock/adapter.d.ts.map +1 -1
  286. package/dist/remote/relay/mock/adapter.js +98 -81
  287. package/dist/remote/relay/mock/adapter.js.map +1 -1
  288. package/dist/remote/relay/mock/group-server.d.ts +9 -0
  289. package/dist/remote/relay/mock/group-server.d.ts.map +1 -0
  290. package/dist/remote/relay/mock/group-server.js +9 -0
  291. package/dist/remote/relay/mock/group-server.js.map +1 -0
  292. package/dist/remote/relay/types.d.ts +73 -79
  293. package/dist/remote/relay/types.d.ts.map +1 -1
  294. package/dist/remote/relay/types.js +0 -1
  295. package/dist/remote/relay/types.js.map +1 -1
  296. package/dist/types/api.d.ts +23 -2
  297. package/dist/types/api.d.ts.map +1 -1
  298. package/dist/types/protocol-config.d.ts +51 -0
  299. package/dist/types/protocol-config.d.ts.map +1 -1
  300. package/dist/types/protocol-config.js +46 -0
  301. package/dist/types/protocol-config.js.map +1 -1
  302. package/docs/ASSURANCE.md +10 -6
  303. package/docs/CLIENT_COMPOSITION.md +23 -69
  304. package/docs/DEVIATIONS.md +77 -41
  305. package/docs/E2EE.md +71 -6
  306. package/docs/GETTING_STARTED.md +1 -1
  307. package/docs/PACKAGE_SURFACE.md +6 -0
  308. package/docs/RECIPES.md +1 -1
  309. package/docs/SECURITY.md +8 -0
  310. package/groups/README.md +16 -5
  311. package/local/store/expo/README.md +10 -1
  312. package/local/store/node/README.md +10 -1
  313. package/package.json +20 -4
  314. package/remote/relay/convex/README.md +6 -0
  315. package/remote/relay/convex/component/README.md +428 -0
  316. package/scripts/oe-groups.mjs +162 -0
  317. package/dist/internal/groups-v2/access-control.d.ts +0 -108
  318. package/dist/internal/groups-v2/access-control.d.ts.map +0 -1
  319. package/dist/internal/groups-v2/access-control.js +0 -191
  320. package/dist/internal/groups-v2/access-control.js.map +0 -1
  321. package/dist/internal/groups-v2/change-actions.d.ts +0 -40
  322. package/dist/internal/groups-v2/change-actions.d.ts.map +0 -1
  323. package/dist/internal/groups-v2/change-actions.js +0 -363
  324. package/dist/internal/groups-v2/change-actions.js.map +0 -1
  325. package/dist/internal/groups-v2/encrypted-state.d.ts.map +0 -1
  326. package/dist/internal/groups-v2/encrypted-state.js.map +0 -1
  327. package/dist/internal/groups-v2/index.d.ts +0 -19
  328. package/dist/internal/groups-v2/index.d.ts.map +0 -1
  329. package/dist/internal/groups-v2/index.js +0 -11
  330. package/dist/internal/groups-v2/index.js.map +0 -1
  331. package/dist/internal/groups-v2/invite-link.d.ts.map +0 -1
  332. package/dist/internal/groups-v2/invite-link.js.map +0 -1
  333. package/dist/internal/groups-v2/manager.d.ts.map +0 -1
  334. package/dist/internal/groups-v2/manager.js +0 -1095
  335. package/dist/internal/groups-v2/manager.js.map +0 -1
  336. package/dist/internal/groups-v2/types.d.ts.map +0 -1
  337. package/dist/internal/groups-v2/types.js.map +0 -1
  338. package/docs/api/README.md +0 -471
  339. package/docs/api/classes/EncryptionError.md +0 -112
  340. package/docs/api/classes/EndorsementManager.md +0 -307
  341. package/docs/api/classes/SealedSenderAuthError.md +0 -127
  342. package/docs/api/classes/ServerDerivedKeyPair.md +0 -68
  343. package/docs/api/classes/ServerDerivedPublicKey.md +0 -33
  344. package/docs/api/classes/ServerRootKeyPair.md +0 -94
  345. package/docs/api/classes/ServerRootPublicKey.md +0 -72
  346. package/docs/api/classes/SignalProtocolBlockingManager.md +0 -106
  347. package/docs/api/classes/SignalProtocolClient.md +0 -2654
  348. package/docs/api/classes/VerificationFailure.md +0 -25
  349. package/docs/api/enumerations/ContentHint.md +0 -63
  350. package/docs/api/enumerations/EncryptionErrorCode.md +0 -488
  351. package/docs/api/enumerations/IdentityKeyChange.md +0 -65
  352. package/docs/api/enumerations/MessageType.md +0 -29
  353. package/docs/api/enumerations/TrustDirection.md +0 -33
  354. package/docs/api/enumerations/TypingAction.md +0 -31
  355. package/docs/api/functions/createDefaultSignalProtocolContentAdapter.md +0 -13
  356. package/docs/api/functions/createDefaultSignalProtocolLogger.md +0 -36
  357. package/docs/api/functions/createGroupId.md +0 -32
  358. package/docs/api/functions/createSignalProtocolClient.md +0 -36
  359. package/docs/api/functions/createSignalProtocolClientConfig.md +0 -24
  360. package/docs/api/functions/extractGroupId.md +0 -32
  361. package/docs/api/functions/formatVersion.md +0 -25
  362. package/docs/api/functions/isCompatible.md +0 -31
  363. package/docs/api/functions/isGroupId.md +0 -37
  364. package/docs/api/functions/isSealedSenderAuthError.md +0 -25
  365. package/docs/api/functions/parseVersion.md +0 -29
  366. package/docs/api/functions/resolveSPQRLimits.md +0 -21
  367. package/docs/api/functions/resolveSignalProtocolLogger.md +0 -42
  368. package/docs/api/interfaces/AccountIdentityProvisioning.md +0 -43
  369. package/docs/api/interfaces/AccountIdentityRotation.md +0 -69
  370. package/docs/api/interfaces/AttachmentTransferOptions.md +0 -49
  371. package/docs/api/interfaces/BlockedRecipientEntry.md +0 -25
  372. package/docs/api/interfaces/BlockedRecipientsSyncInput.md +0 -27
  373. package/docs/api/interfaces/ConfigurationSyncInput.md +0 -19
  374. package/docs/api/interfaces/CredentialPublicKey.md +0 -25
  375. package/docs/api/interfaces/DataMessageInput.md +0 -21
  376. package/docs/api/interfaces/DecryptedEnvelope.md +0 -95
  377. package/docs/api/interfaces/DecryptedGroup.md +0 -86
  378. package/docs/api/interfaces/DeviceInfo.md +0 -79
  379. package/docs/api/interfaces/DeviceRecord.md +0 -87
  380. package/docs/api/interfaces/DeviceRegistration.md +0 -27
  381. package/docs/api/interfaces/DoubleRatchetConfig.md +0 -36
  382. package/docs/api/interfaces/EcOneTimePreKey.md +0 -27
  383. package/docs/api/interfaces/EcSignedPreKey.md +0 -39
  384. package/docs/api/interfaces/EcSignedPreKeyUpload.md +0 -50
  385. package/docs/api/interfaces/EncryptionErrorContext.md +0 -51
  386. package/docs/api/interfaces/Envelope.md +0 -154
  387. package/docs/api/interfaces/ForceKeyResetResult.md +0 -37
  388. package/docs/api/interfaces/GroupAuthorization.md +0 -23
  389. package/docs/api/interfaces/GroupChangeEntry.md +0 -42
  390. package/docs/api/interfaces/GroupMemberDevice.md +0 -26
  391. package/docs/api/interfaces/IEcOneTimePreKeyStore.md +0 -86
  392. package/docs/api/interfaces/IEcSignedPreKeyStore.md +0 -133
  393. package/docs/api/interfaces/IGroupServer.md +0 -120
  394. package/docs/api/interfaces/IGroupStateStore.md +0 -128
  395. package/docs/api/interfaces/IIdentityKeyStore.md +0 -312
  396. package/docs/api/interfaces/IKemPreKeyStore.md +0 -144
  397. package/docs/api/interfaces/IKyberLastResortPreKeyStore.md +0 -112
  398. package/docs/api/interfaces/ILogger.md +0 -117
  399. package/docs/api/interfaces/IProtocolStore.md +0 -1033
  400. package/docs/api/interfaces/ISenderKeyStore.md +0 -417
  401. package/docs/api/interfaces/ISesameStore.md +0 -249
  402. package/docs/api/interfaces/ISessionStore.md +0 -178
  403. package/docs/api/interfaces/ISignalProtocolClient.md +0 -1185
  404. package/docs/api/interfaces/ISignalProtocolLocalSecretVault.md +0 -71
  405. package/docs/api/interfaces/ISignalProtocolLocalStore.md +0 -2053
  406. package/docs/api/interfaces/ISignalProtocolManager.md +0 -272
  407. package/docs/api/interfaces/ISignalProtocolRelayServer.md +0 -1329
  408. package/docs/api/interfaces/IdentityKeyPair.md +0 -49
  409. package/docs/api/interfaces/IncomingEnvelope.md +0 -91
  410. package/docs/api/interfaces/InspectedSignalProtocolContent.md +0 -43
  411. package/docs/api/interfaces/KDFChain.md +0 -31
  412. package/docs/api/interfaces/KemLastResortPreKeyUpload.md +0 -50
  413. package/docs/api/interfaces/KeyPair.md +0 -23
  414. package/docs/api/interfaces/KyberPreKey.md +0 -42
  415. package/docs/api/interfaces/MLKEMBraidAgentState.md +0 -191
  416. package/docs/api/interfaces/MLKEMBraidMessage.md +0 -49
  417. package/docs/api/interfaces/MediaAttachmentDeleteSyncInput.md +0 -31
  418. package/docs/api/interfaces/MessageHeader.md +0 -49
  419. package/docs/api/interfaces/MessageRecord.md +0 -86
  420. package/docs/api/interfaces/ParsedReceiptContent.md +0 -19
  421. package/docs/api/interfaces/ParsedTypingContent.md +0 -19
  422. package/docs/api/interfaces/PreKeyMaintenanceStore.md +0 -88
  423. package/docs/api/interfaces/PreKeyMessage.md +0 -159
  424. package/docs/api/interfaces/PreKeyStatusResult.md +0 -21
  425. package/docs/api/interfaces/PreKeyUpload.md +0 -42
  426. package/docs/api/interfaces/ProcessEnvelopeOptions.md +0 -72
  427. package/docs/api/interfaces/ProtocolAddress.md +0 -38
  428. package/docs/api/interfaces/ProtocolStrategyConfig.md +0 -91
  429. package/docs/api/interfaces/RatchetMessage.md +0 -96
  430. package/docs/api/interfaces/ReadSyncEntryInput.md +0 -19
  431. package/docs/api/interfaces/ReceiverChain.md +0 -43
  432. package/docs/api/interfaces/RecipientUsernameSyncInput.md +0 -31
  433. package/docs/api/interfaces/RelayPreKeyBundle.md +0 -254
  434. package/docs/api/interfaces/RemoteObjectDownload.md +0 -33
  435. package/docs/api/interfaces/RemoteObjectUpload.md +0 -49
  436. package/docs/api/interfaces/ResolvedSPQRInfoStrings.md +0 -27
  437. package/docs/api/interfaces/ResolvedSPQRLimits.md +0 -37
  438. package/docs/api/interfaces/RetryRequest.md +0 -80
  439. package/docs/api/interfaces/SCKAState.md +0 -65
  440. package/docs/api/interfaces/SPQRLimits.md +0 -40
  441. package/docs/api/interfaces/SPQRState.md +0 -191
  442. package/docs/api/interfaces/SafetyNumber.md +0 -60
  443. package/docs/api/interfaces/SafetyNumberConfirmation.md +0 -46
  444. package/docs/api/interfaces/SealedSenderConfig.md +0 -70
  445. package/docs/api/interfaces/SendOptions.md +0 -191
  446. package/docs/api/interfaces/SendResult.md +0 -93
  447. package/docs/api/interfaces/SenderKeyDistributionMessage.md +0 -43
  448. package/docs/api/interfaces/SenderKeyState.md +0 -76
  449. package/docs/api/interfaces/SenderKeysConfig.md +0 -65
  450. package/docs/api/interfaces/SentSyncTranscriptInput.md +0 -31
  451. package/docs/api/interfaces/ServiceId.md +0 -19
  452. package/docs/api/interfaces/SesameMessage.md +0 -84
  453. package/docs/api/interfaces/SesameStats.md +0 -57
  454. package/docs/api/interfaces/SessionHealthResult.md +0 -120
  455. package/docs/api/interfaces/SessionRecord.md +0 -80
  456. package/docs/api/interfaces/SessionRecordMetadata.md +0 -109
  457. package/docs/api/interfaces/SessionState.md +0 -368
  458. package/docs/api/interfaces/SessionTrustCommit.md +0 -58
  459. package/docs/api/interfaces/SignalProtocolBlockingHooks.md +0 -44
  460. package/docs/api/interfaces/SignalProtocolBlockingManagerOptions.md +0 -31
  461. package/docs/api/interfaces/SignalProtocolBlockingMirror.md +0 -30
  462. package/docs/api/interfaces/SignalProtocolBlockingStore.md +0 -83
  463. package/docs/api/interfaces/SignalProtocolClientAdapterConfig.md +0 -44
  464. package/docs/api/interfaces/SignalProtocolClientCompositionOptions.md +0 -693
  465. package/docs/api/interfaces/SignalProtocolClientConfig.md +0 -839
  466. package/docs/api/interfaces/SignalProtocolClientDeleteLocalAttachmentInput.md +0 -25
  467. package/docs/api/interfaces/SignalProtocolClientHooks.md +0 -506
  468. package/docs/api/interfaces/SignalProtocolClientIdentityConfig.md +0 -35
  469. package/docs/api/interfaces/SignalProtocolClientLoadLocalAttachmentInput.md +0 -187
  470. package/docs/api/interfaces/SignalProtocolClientLoadedLocalAttachment.md +0 -19
  471. package/docs/api/interfaces/SignalProtocolClientMedia.md +0 -83
  472. package/docs/api/interfaces/SignalProtocolClientMediaCompletedResult.md +0 -25
  473. package/docs/api/interfaces/SignalProtocolClientMediaConfig.md +0 -157
  474. package/docs/api/interfaces/SignalProtocolClientMediaDownloadCompletedResult.md +0 -37
  475. package/docs/api/interfaces/SignalProtocolClientMediaDownloadNotNeededResult.md +0 -25
  476. package/docs/api/interfaces/SignalProtocolClientMediaFailedResult.md +0 -19
  477. package/docs/api/interfaces/SignalProtocolClientMediaOperationOptions.md +0 -53
  478. package/docs/api/interfaces/SignalProtocolClientMediaPendingResult.md +0 -19
  479. package/docs/api/interfaces/SignalProtocolClientMediaProcessResult.md +0 -43
  480. package/docs/api/interfaces/SignalProtocolClientMediaSkippedResult.md +0 -25
  481. package/docs/api/interfaces/SignalProtocolClientMediaUploadCompletedResult.md +0 -31
  482. package/docs/api/interfaces/SignalProtocolClientProcessPendingMediaOptions.md +0 -87
  483. package/docs/api/interfaces/SignalProtocolClientSaveDownloadedAttachmentInput.md +0 -25
  484. package/docs/api/interfaces/SignalProtocolClientSaveUploadedAttachmentInput.md +0 -25
  485. package/docs/api/interfaces/SignalProtocolClientSyncDeleteInput.md +0 -19
  486. package/docs/api/interfaces/SignalProtocolConfig.md +0 -50
  487. package/docs/api/interfaces/SignalProtocolContentAdapter.md +0 -325
  488. package/docs/api/interfaces/SignalProtocolRemoteObjectStore.md +0 -88
  489. package/docs/api/interfaces/SkippedSenderMessageKey.md +0 -26
  490. package/docs/api/interfaces/TaskNotificationAckSyncInput.md +0 -31
  491. package/docs/api/interfaces/TripleRatchetState.md +0 -64
  492. package/docs/api/interfaces/UserRecord.md +0 -71
  493. package/docs/api/interfaces/UsernameStateSyncInput.md +0 -19
  494. package/docs/api/interfaces/VerificationStateSyncInput.md +0 -31
  495. package/docs/api/interfaces/VersionNegotiationState.md +0 -84
  496. package/docs/api/interfaces/ViewOnceOpenSyncInput.md +0 -19
  497. package/docs/api/namespaces/ProtocolAddress/README.md +0 -33
  498. package/docs/api/namespaces/ProtocolAddress/functions/create.md +0 -41
  499. package/docs/api/namespaces/ProtocolAddress/functions/equals.md +0 -39
  500. package/docs/api/namespaces/ProtocolAddress/functions/fromStorageKey.md +0 -36
  501. package/docs/api/namespaces/ProtocolAddress/functions/isUser.md +0 -39
  502. package/docs/api/namespaces/ProtocolAddress/functions/isValid.md +0 -34
  503. package/docs/api/namespaces/ProtocolAddress/functions/parse.md +0 -41
  504. package/docs/api/namespaces/ProtocolAddress/functions/toStorageKey.md +0 -38
  505. package/docs/api/namespaces/ProtocolAddress/functions/toString.md +0 -34
  506. package/docs/api/namespaces/SessionRecord/README.md +0 -30
  507. package/docs/api/namespaces/SessionRecord/functions/archiveCurrent.md +0 -40
  508. package/docs/api/namespaces/SessionRecord/functions/archiveCurrentState.md +0 -34
  509. package/docs/api/namespaces/SessionRecord/functions/create.md +0 -25
  510. package/docs/api/namespaces/SessionRecord/functions/deserialize.md +0 -29
  511. package/docs/api/namespaces/SessionRecord/functions/findSession.md +0 -34
  512. package/docs/api/namespaces/SessionRecord/functions/getAllSessions.md +0 -25
  513. package/docs/api/namespaces/SessionRecord/functions/getArchivedCount.md +0 -25
  514. package/docs/api/namespaces/SessionRecord/functions/hasCurrentSession.md +0 -25
  515. package/docs/api/namespaces/SessionRecord/functions/hasUsableSenderChain.md +0 -36
  516. package/docs/api/namespaces/SessionRecord/functions/promoteSession.md +0 -34
  517. package/docs/api/namespaces/SessionRecord/functions/serialize.md +0 -28
  518. package/docs/api/namespaces/SessionRecord/variables/MAX_ARCHIVED_SESSIONS.md +0 -14
  519. package/docs/api/namespaces/SessionState/README.md +0 -15
  520. package/docs/api/namespaces/SessionState/functions/getSessionId.md +0 -32
  521. package/docs/api/namespaces/blocking/README.md +0 -43
  522. package/docs/api/namespaces/encoding/README.md +0 -33
  523. package/docs/api/namespaces/encoding/functions/base64ToUrlSafe.md +0 -28
  524. package/docs/api/namespaces/encoding/functions/bytesToBase64.md +0 -21
  525. package/docs/api/namespaces/encoding/functions/bytesToString.md +0 -21
  526. package/docs/api/namespaces/encoding/functions/bytesToUrlSafeBase64.md +0 -33
  527. package/docs/api/namespaces/encoding/functions/concatBytes.md +0 -21
  528. package/docs/api/namespaces/encoding/functions/stringToBytes.md +0 -21
  529. package/docs/api/namespaces/encoding/functions/urlSafeToBase64.md +0 -27
  530. package/docs/api/namespaces/keys/README.md +0 -130
  531. package/docs/api/namespaces/keys/functions/acceptContactIdentityRotation.md +0 -33
  532. package/docs/api/namespaces/keys/functions/assertIdentityCommitment.md +0 -25
  533. package/docs/api/namespaces/keys/functions/canonicalizeDeviceIdentityKey.md +0 -30
  534. package/docs/api/namespaces/keys/functions/compareDeviceIdentityKeys.md +0 -28
  535. package/docs/api/namespaces/keys/functions/compositeIdentitiesEqual.md +0 -23
  536. package/docs/api/namespaces/keys/functions/createCompositeIdentityV1.md +0 -19
  537. package/docs/api/namespaces/keys/functions/createPreKeySignatureContext.md +0 -31
  538. package/docs/api/namespaces/keys/functions/createUnverifiedContactIdentityRecord.md +0 -23
  539. package/docs/api/namespaces/keys/functions/decodeCompositeIdentityV1.md +0 -19
  540. package/docs/api/namespaces/keys/functions/deriveIdentityCommitment.md +0 -19
  541. package/docs/api/namespaces/keys/functions/encodeCompositeIdentityV1.md +0 -19
  542. package/docs/api/namespaces/keys/functions/evaluateContactIdentityCandidate.md +0 -27
  543. package/docs/api/namespaces/keys/functions/generateEcOneTimePreKeys.md +0 -37
  544. package/docs/api/namespaces/keys/functions/generateEcSignedPreKey.md +0 -39
  545. package/docs/api/namespaces/keys/functions/generateEcSignedPreKeyId.md +0 -21
  546. package/docs/api/namespaces/keys/functions/generateIdentityKeyPair.md +0 -24
  547. package/docs/api/namespaces/keys/functions/generateKemOneTimePreKeys.md +0 -47
  548. package/docs/api/namespaces/keys/functions/generateKyberLastResortPreKey.md +0 -37
  549. package/docs/api/namespaces/keys/functions/generateRegistrationId.md +0 -13
  550. package/docs/api/namespaces/keys/functions/isValidDeviceIdentityKey.md +0 -22
  551. package/docs/api/namespaces/keys/functions/signMlKem1024PreKey.md +0 -29
  552. package/docs/api/namespaces/keys/functions/signPreKey.md +0 -31
  553. package/docs/api/namespaces/keys/functions/validateContactIdentityRecord.md +0 -19
  554. package/docs/api/namespaces/keys/functions/verifyContactIdentityRecord.md +0 -31
  555. package/docs/api/namespaces/keys/functions/verifyMlKem1024PreKey.md +0 -33
  556. package/docs/api/namespaces/keys/functions/verifyPreKeySignature.md +0 -35
  557. package/docs/api/namespaces/keys/interfaces/CompositeIdentityV1.md +0 -33
  558. package/docs/api/namespaces/keys/interfaces/ContactIdentityRecord.md +0 -53
  559. package/docs/api/namespaces/keys/interfaces/KemOneTimePreKey.md +0 -43
  560. package/docs/api/namespaces/keys/type-aliases/IdentityCandidateStatus.md +0 -9
  561. package/docs/api/namespaces/keys/type-aliases/IdentityTrustState.md +0 -9
  562. package/docs/api/namespaces/keys/type-aliases/IdentityType.md +0 -9
  563. package/docs/api/namespaces/keys/variables/COMPOSITE_IDENTITY_V1_ED25519_TAG.md +0 -9
  564. package/docs/api/namespaces/keys/variables/COMPOSITE_IDENTITY_V1_LENGTH.md +0 -9
  565. package/docs/api/namespaces/keys/variables/COMPOSITE_IDENTITY_V1_VERSION.md +0 -9
  566. package/docs/api/namespaces/keys/variables/COMPOSITE_IDENTITY_V1_X25519_TAG.md +0 -9
  567. package/docs/api/namespaces/keys/variables/IDENTITY_COMMITMENT_V1_DOMAIN.md +0 -9
  568. package/docs/api/namespaces/keys/variables/PREKEY_ALGORITHM_ML_KEM_1024.md +0 -9
  569. package/docs/api/namespaces/keys/variables/PREKEY_ALGORITHM_X25519.md +0 -9
  570. package/docs/api/namespaces/keys/variables/PREKEY_SIGNATURE_V1_DOMAIN.md +0 -9
  571. package/docs/api/namespaces/keys/variables/UNPINNED_DEVICE_IDENTITY_KEY.md +0 -18
  572. package/docs/api/namespaces/media/README.md +0 -105
  573. package/docs/api/namespaces/media/classes/MediaAttachmentError.md +0 -57
  574. package/docs/api/namespaces/media/functions/createByteRangeMediaAttachmentTransfer.md +0 -19
  575. package/docs/api/namespaces/media/functions/createMediaAttachmentDeliveryId.md +0 -29
  576. package/docs/api/namespaces/media/functions/createMediaAttachmentId.md +0 -19
  577. package/docs/api/namespaces/media/functions/createMediaAttachmentMessage.md +0 -25
  578. package/docs/api/namespaces/media/functions/createMediaAttachmentPointer.md +0 -19
  579. package/docs/api/namespaces/media/functions/createTusMediaAttachmentTransfer.md +0 -19
  580. package/docs/api/namespaces/media/functions/deleteMediaAttachment.md +0 -23
  581. package/docs/api/namespaces/media/functions/executeMediaAttachmentJob.md +0 -23
  582. package/docs/api/namespaces/media/functions/isMediaAttachmentFlagSet.md +0 -19
  583. package/docs/api/namespaces/media/functions/parseMediaAttachmentMessage.md +0 -19
  584. package/docs/api/namespaces/media/functions/planMediaAttachmentCleanup.md +0 -23
  585. package/docs/api/namespaces/media/functions/planMediaAttachmentCleanupJobs.md +0 -19
  586. package/docs/api/namespaces/media/functions/planMediaAttachmentDeleteSync.md +0 -19
  587. package/docs/api/namespaces/media/functions/planMediaAttachmentDownloadJob.md +0 -19
  588. package/docs/api/namespaces/media/functions/planMediaAttachmentOpen.md +0 -19
  589. package/docs/api/namespaces/media/functions/planMediaAttachmentProcessing.md +0 -19
  590. package/docs/api/namespaces/media/functions/planMediaAttachmentUploadJob.md +0 -19
  591. package/docs/api/namespaces/media/functions/prepareMediaAttachmentUpload.md +0 -30
  592. package/docs/api/namespaces/media/functions/resolveMediaAttachment.md +0 -30
  593. package/docs/api/namespaces/media/functions/serializeMediaAttachmentMessage.md +0 -25
  594. package/docs/api/namespaces/media/functions/validateMediaAttachmentPolicy.md +0 -23
  595. package/docs/api/namespaces/media/interfaces/ByteRangeMediaAttachmentPartialStore.md +0 -68
  596. package/docs/api/namespaces/media/interfaces/ByteRangeMediaAttachmentTransferOptions.md +0 -91
  597. package/docs/api/namespaces/media/interfaces/DeleteMediaAttachmentOptions.md +0 -25
  598. package/docs/api/namespaces/media/interfaces/DeleteMediaAttachmentResult.md +0 -19
  599. package/docs/api/namespaces/media/interfaces/ExecuteMediaAttachmentJobOptions.md +0 -157
  600. package/docs/api/namespaces/media/interfaces/MediaAttachmentBackgroundJob.md +0 -85
  601. package/docs/api/namespaces/media/interfaces/MediaAttachmentCleanupPlan.md +0 -37
  602. package/docs/api/namespaces/media/interfaces/MediaAttachmentJobExecutionResult.md +0 -55
  603. package/docs/api/namespaces/media/interfaces/MediaAttachmentMessage.md +0 -31
  604. package/docs/api/namespaces/media/interfaces/MediaAttachmentOpenDecision.md +0 -31
  605. package/docs/api/namespaces/media/interfaces/MediaAttachmentPointer.md +0 -133
  606. package/docs/api/namespaces/media/interfaces/MediaAttachmentPolicy.md +0 -67
  607. package/docs/api/namespaces/media/interfaces/MediaAttachmentProcessingPlan.md +0 -73
  608. package/docs/api/namespaces/media/interfaces/MediaAttachmentProgress.md +0 -69
  609. package/docs/api/namespaces/media/interfaces/MediaAttachmentResumeState.md +0 -37
  610. package/docs/api/namespaces/media/interfaces/MediaAttachmentRetryOptions.md +0 -31
  611. package/docs/api/namespaces/media/interfaces/MediaAttachmentTransfer.md +0 -51
  612. package/docs/api/namespaces/media/interfaces/MediaAttachmentTransferCheckpoint.md +0 -69
  613. package/docs/api/namespaces/media/interfaces/MediaAttachmentTransferOptions.md +0 -67
  614. package/docs/api/namespaces/media/interfaces/MediaAttachmentUploadJobData.md +0 -19
  615. package/docs/api/namespaces/media/interfaces/MediaAttachmentUploadResponse.md +0 -25
  616. package/docs/api/namespaces/media/interfaces/PlanMediaAttachmentCleanupJobsInput.md +0 -61
  617. package/docs/api/namespaces/media/interfaces/PlanMediaAttachmentDeleteSyncInput.md +0 -25
  618. package/docs/api/namespaces/media/interfaces/PlanMediaAttachmentDownloadJobInput.md +0 -161
  619. package/docs/api/namespaces/media/interfaces/PlanMediaAttachmentOpenInput.md +0 -25
  620. package/docs/api/namespaces/media/interfaces/PlanMediaAttachmentProcessingInput.md +0 -83
  621. package/docs/api/namespaces/media/interfaces/PlanMediaAttachmentUploadJobInput.md +0 -147
  622. package/docs/api/namespaces/media/interfaces/PrepareMediaAttachmentUploadOptions.md +0 -144
  623. package/docs/api/namespaces/media/interfaces/ResolveMediaAttachmentOptions.md +0 -55
  624. package/docs/api/namespaces/media/interfaces/ResolvedMediaAttachment.md +0 -109
  625. package/docs/api/namespaces/media/interfaces/TusMediaAttachmentTransferOptions.md +0 -85
  626. package/docs/api/namespaces/media/type-aliases/CreateMediaAttachmentPointerInput.md +0 -15
  627. package/docs/api/namespaces/media/type-aliases/MediaAttachmentCheckpointCallback.md +0 -19
  628. package/docs/api/namespaces/media/type-aliases/MediaAttachmentCleanupReason.md +0 -9
  629. package/docs/api/namespaces/media/type-aliases/MediaAttachmentErrorCode.md +0 -9
  630. package/docs/api/namespaces/media/type-aliases/MediaAttachmentFlag.md +0 -9
  631. package/docs/api/namespaces/media/type-aliases/MediaAttachmentJobExecutionStatus.md +0 -9
  632. package/docs/api/namespaces/media/type-aliases/MediaAttachmentJobOperation.md +0 -9
  633. package/docs/api/namespaces/media/type-aliases/MediaAttachmentJobPriority.md +0 -9
  634. package/docs/api/namespaces/media/type-aliases/MediaAttachmentJobSkipReason.md +0 -9
  635. package/docs/api/namespaces/media/type-aliases/MediaAttachmentJobSource.md +0 -9
  636. package/docs/api/namespaces/media/type-aliases/MediaAttachmentKnownIds.md +0 -9
  637. package/docs/api/namespaces/media/type-aliases/MediaAttachmentMessageType.md +0 -9
  638. package/docs/api/namespaces/media/type-aliases/MediaAttachmentProgressCallback.md +0 -19
  639. package/docs/api/namespaces/media/variables/MEDIA_ATTACHMENT_POLICY_DEFAULTS.md +0 -47
  640. package/docs/api/namespaces/media/variables/MEDIA_ATTACHMENT_POLICY_PRESETS.md +0 -95
  641. package/docs/api/namespaces/media/variables/MediaAttachmentCleanupReason.md +0 -27
  642. package/docs/api/namespaces/media/variables/MediaAttachmentErrorCode.md +0 -75
  643. package/docs/api/namespaces/media/variables/MediaAttachmentFlag.md +0 -23
  644. package/docs/api/namespaces/media/variables/MediaAttachmentJobExecutionStatus.md +0 -19
  645. package/docs/api/namespaces/media/variables/MediaAttachmentJobOperation.md +0 -31
  646. package/docs/api/namespaces/media/variables/MediaAttachmentJobPriority.md +0 -23
  647. package/docs/api/namespaces/media/variables/MediaAttachmentJobSource.md +0 -51
  648. package/docs/api/namespaces/media/variables/MediaAttachmentMessageType.md +0 -15
  649. package/docs/api/namespaces/media/variables/downloadMediaAttachment.md +0 -30
  650. package/docs/api/namespaces/safety/README.md +0 -61
  651. package/docs/api/namespaces/safety/classes/DisplayableFingerprint.md +0 -108
  652. package/docs/api/namespaces/safety/classes/Fingerprint.md +0 -104
  653. package/docs/api/namespaces/safety/classes/ScannableFingerprint.md +0 -209
  654. package/docs/api/namespaces/safety/functions/base64ToBytes.md +0 -21
  655. package/docs/api/namespaces/safety/functions/clearFingerprintCache.md +0 -15
  656. package/docs/api/namespaces/safety/functions/compareSafetyNumbers.md +0 -25
  657. package/docs/api/namespaces/safety/functions/createFingerprintData.md +0 -60
  658. package/docs/api/namespaces/safety/functions/extractQrData.md +0 -34
  659. package/docs/api/namespaces/safety/functions/generateCompositeSafetyNumber.md +0 -39
  660. package/docs/api/namespaces/safety/functions/generateEmojiFingerprint.md +0 -24
  661. package/docs/api/namespaces/safety/functions/generateSingleKeyReferenceSafetyNumber.md +0 -51
  662. package/docs/api/namespaces/safety/functions/generateVerifySchemeUrl.md +0 -32
  663. package/docs/api/namespaces/safety/functions/generateVerifyUrl.md +0 -49
  664. package/docs/api/namespaces/safety/functions/isValidSafetyNumber.md +0 -21
  665. package/docs/api/namespaces/safety/functions/isVerifyUrl.md +0 -45
  666. package/docs/api/namespaces/safety/functions/parseVerifyUrl.md +0 -31
  667. package/docs/api/namespaces/safety/interfaces/FingerprintData.md +0 -52
  668. package/docs/api/namespaces/safety/interfaces/SafetyNumber.md +0 -49
  669. package/docs/api/namespaces/safety/interfaces/VerifyLinkConfig.md +0 -28
  670. package/docs/api/namespaces/safety/interfaces/VerifyUrlParams.md +0 -49
  671. package/docs/api/namespaces/safety/type-aliases/CompareResult.md +0 -21
  672. package/docs/api/namespaces/safety/variables/DEFAULT_VERIFY_LINK_CONFIG.md +0 -12
  673. package/docs/api/namespaces/safety/variables/FINGERPRINT_ITERATIONS.md +0 -12
  674. package/docs/api/namespaces/safety/variables/FINGERPRINT_VERSION.md +0 -12
  675. package/docs/api/namespaces/safety/variables/VERIFY_BASE_URL.md +0 -11
  676. package/docs/api/namespaces/safety/variables/VERIFY_SCHEME_URL.md +0 -11
  677. package/docs/api/type-aliases/Base64.md +0 -20
  678. package/docs/api/type-aliases/BraidPolicy.md +0 -11
  679. package/docs/api/type-aliases/Bytes.md +0 -20
  680. package/docs/api/type-aliases/Ciphertext.md +0 -21
  681. package/docs/api/type-aliases/DeviceType.md +0 -11
  682. package/docs/api/type-aliases/DownloadedAttachment.md +0 -11
  683. package/docs/api/type-aliases/GroupId.md +0 -27
  684. package/docs/api/type-aliases/Hex.md +0 -20
  685. package/docs/api/type-aliases/HookName.md +0 -11
  686. package/docs/api/type-aliases/PostQuantumPolicy.md +0 -11
  687. package/docs/api/type-aliases/PreparedAttachmentUpload.md +0 -14
  688. package/docs/api/type-aliases/PrivateKey.md +0 -22
  689. package/docs/api/type-aliases/ProgressCallback.md +0 -45
  690. package/docs/api/type-aliases/PublicKey.md +0 -22
  691. package/docs/api/type-aliases/RemoteObjectCompleteUploadRequest.md +0 -19
  692. package/docs/api/type-aliases/RemoteObjectDeleteRequest.md +0 -19
  693. package/docs/api/type-aliases/RemoteObjectDownloadRequest.md +0 -19
  694. package/docs/api/type-aliases/RemoteObjectUploadRequest.md +0 -42
  695. package/docs/api/type-aliases/SCKAMode.md +0 -11
  696. package/docs/api/type-aliases/SealedSenderAuth.md +0 -15
  697. package/docs/api/type-aliases/SignalProtocolClientMediaCleanupInput.md +0 -9
  698. package/docs/api/type-aliases/SignalProtocolClientMediaCleanupResult.md +0 -9
  699. package/docs/api/type-aliases/SignalProtocolClientMediaDownloadInput.md +0 -9
  700. package/docs/api/type-aliases/SignalProtocolClientMediaDownloadResult.md +0 -9
  701. package/docs/api/type-aliases/SignalProtocolClientMediaOperationResult.md +0 -9
  702. package/docs/api/type-aliases/SignalProtocolClientMediaUploadInput.md +0 -9
  703. package/docs/api/type-aliases/SignalProtocolClientMediaUploadResult.md +0 -9
  704. package/docs/api/type-aliases/Signature.md +0 -21
  705. package/docs/api/type-aliases/Unsubscribe.md +0 -15
  706. package/docs/api/variables/BraidPolicy.md +0 -21
  707. package/docs/api/variables/DEFAULT_DEVICE_ID.md +0 -12
  708. package/docs/api/variables/DOUBLE_RATCHET_SPEC.md +0 -11
  709. package/docs/api/variables/GROUP_V2_PREFIX.md +0 -11
  710. package/docs/api/variables/KEY_REFRESH_INTERVAL_MS_DEFAULT.md +0 -11
  711. package/docs/api/variables/MAX_MESSAGE_KEYS.md +0 -14
  712. package/docs/api/variables/MAX_PREKEY_AGE_MS_DEFAULT.md +0 -11
  713. package/docs/api/variables/MAX_RECEIVER_CHAINS.md +0 -14
  714. package/docs/api/variables/MAX_REGISTRATION_ID.md +0 -16
  715. package/docs/api/variables/MAX_SKIP.md +0 -11
  716. package/docs/api/variables/MESSAGE_FORMAT.md +0 -11
  717. package/docs/api/variables/MIN_REGISTRATION_ID.md +0 -16
  718. package/docs/api/variables/ML_KEM_BRAID_SPEC.md +0 -11
  719. package/docs/api/variables/ONE_TIME_PREKEY_BATCH_SIZE.md +0 -21
  720. package/docs/api/variables/PQXDH_SPEC.md +0 -11
  721. package/docs/api/variables/PostQuantumPolicy.md +0 -21
  722. package/docs/api/variables/SENDER_KEY_FORMAT.md +0 -11
  723. package/docs/api/variables/SENDER_KEY_SPEC.md +0 -11
  724. package/docs/api/variables/SESAME_SPEC.md +0 -11
  725. package/docs/api/variables/SESSION_FORMAT.md +0 -11
  726. package/docs/api/variables/SPQR_LIMITS_DEFAULTS.md +0 -11
  727. package/docs/api/variables/X3DH_SPEC.md +0 -9
  728. package/docs/api/variables/defaultSignalProtocolLogger.md +0 -32
  729. /package/dist/internal/{groups-v2 → groups}/invite-link.d.ts +0 -0
  730. /package/dist/internal/{groups-v2 → groups}/invite-link.js +0 -0
@@ -0,0 +1,1186 @@
1
+ /**
2
+ * Shared enforcing engine for the group-server contract.
3
+ *
4
+ * The engine operates only on encrypted group state. Storage adapters hydrate
5
+ * one group into the engine, execute an operation, and persist the resulting
6
+ * canonical state, signed log, and versioned snapshots atomically.
7
+ */
8
+ import { AccessRequired, EnabledState, MemberRole, } from './types.js';
9
+ import { assertEncryptedGroupChangeForm, assertRecognizedEncryptedGroupChange, assertValidEncryptedGroupChangeWire, assertValidEncryptedGroupCreationSubmissionWire, assertValidEncryptedGroupWire, deserializeEncryptedGroupCreationSubmission, deserializeEncryptedGroup, deserializeEncryptedGroupChange, serializeEncryptedGroup, serializeEncryptedGroupChange, serializeEncryptedGroupJoinInfo, serializeGroupBaseline, serializeGroupChangeCommitment, requiredGroupChangeEpoch, } from './wire.js';
10
+ import { GroupAction, canRolePerformAction, isInviteLinkAccessRequirement, isRoleAccessRequirement, isStoredMemberRole, } from './access-control.js';
11
+ import { constantTimeEqual } from '../crypto/utils.js';
12
+ import { deserializeAuthCredentialPresentation, deserializeGroupPublicParams, serializeGroupPublicParams, verifyAuthCredentialPresentation, } from '../protocol/zk/groups/auth-credential.js';
13
+ import { SERVICE_ID_ACI, SERVICE_ID_PNI, } from '../protocol/zk/groups/uid-struct.js';
14
+ import { SECONDS_PER_DAY } from '../protocol/zk/groups/group-params.js';
15
+ import { getServerPublicParams, serverSign, } from '../protocol/zk/groups/server-params.js';
16
+ import { deserializeProfileKeyCredentialPresentation, verifyProfileKeyCredentialPresentation, } from '../protocol/zk/groups/profile-key-credential.js';
17
+ import { RistrettoPoint } from '../protocol/zk/proofs/sho.js';
18
+ const MAX_GROUP_SIZE = 1000;
19
+ const INVITE_LINK_PASSWORD_LENGTH = 16;
20
+ const defaultRuntime = {
21
+ now: () => Date.now(),
22
+ randomBytes: (length) => crypto.getRandomValues(new Uint8Array(length)),
23
+ };
24
+ class GroupServerError extends Error {
25
+ data;
26
+ constructor(code, status, message, reason) {
27
+ super(`${code}: ${message}`);
28
+ this.name = 'GroupServerError';
29
+ this.data = reason === undefined ? { code, status } : { code, status, reason };
30
+ }
31
+ }
32
+ function rejectBadRequest(message) {
33
+ throw new GroupServerError('INVALID_REQUEST', 400, message);
34
+ }
35
+ function rejectUnauthorized(message) {
36
+ throw new GroupServerError('UNAUTHORIZED', 403, message);
37
+ }
38
+ function rejectForbidden(message, reason) {
39
+ throw new GroupServerError('FORBIDDEN', 403, message, reason);
40
+ }
41
+ function rejectConflict(message) {
42
+ throw new GroupServerError('VERSION_CONFLICT', 409, message);
43
+ }
44
+ function equal(a, b) {
45
+ return constantTimeEqual(a, b);
46
+ }
47
+ function requireCiphertextEncoding(value, label, kind) {
48
+ if (!(value instanceof Uint8Array) || value.length !== 65) {
49
+ rejectBadRequest(`${label} must be a 65-byte ciphertext`);
50
+ }
51
+ if (kind === 'aci' && value[0] !== SERVICE_ID_ACI) {
52
+ rejectBadRequest(`${label} must carry an ACI ciphertext`);
53
+ }
54
+ if (kind === 'service-id' &&
55
+ value[0] !== SERVICE_ID_ACI &&
56
+ value[0] !== SERVICE_ID_PNI) {
57
+ rejectBadRequest(`${label} must carry an ACI or PNI ciphertext`);
58
+ }
59
+ if (kind === 'profile-key' && value[0] !== 0) {
60
+ rejectBadRequest(`${label} has an invalid reserved byte`);
61
+ }
62
+ try {
63
+ RistrettoPoint.fromBytes(value.slice(1, 33));
64
+ RistrettoPoint.fromBytes(value.slice(33, 65));
65
+ }
66
+ catch {
67
+ rejectBadRequest(`${label} contains an invalid Ristretto ciphertext point`);
68
+ }
69
+ }
70
+ function requireBlobEncoding(value, label, allowEmpty = true) {
71
+ if (!(value instanceof Uint8Array)) {
72
+ rejectBadRequest(`${label} must be ciphertext bytes`);
73
+ }
74
+ if (allowEmpty && value.length === 0)
75
+ return;
76
+ if (value.length < 65 ||
77
+ (value.length - 65) % 32 !== 0 ||
78
+ value[value.length - 1] !== 0) {
79
+ rejectBadRequest(`${label} has an invalid encrypted-blob envelope`);
80
+ }
81
+ }
82
+ function serializePresentationCiphertext(kind, ciphertext) {
83
+ const result = new Uint8Array(65);
84
+ result[0] = kind;
85
+ result.set(ciphertext.E_A1.toBytes(), 1);
86
+ result.set(ciphertext.E_A2.toBytes(), 33);
87
+ return result;
88
+ }
89
+ function serializeProfileKeyPresentationCiphertext(ciphertext) {
90
+ const result = new Uint8Array(65);
91
+ result[0] = 0;
92
+ result.set(ciphertext.E_A1.toBytes(), 1);
93
+ result.set(ciphertext.E_A2.toBytes(), 33);
94
+ return result;
95
+ }
96
+ function verifyProfileKeyPresentation(serverSecretParams, groupPublicParams, aciCiphertext, profileKeyCiphertext, presentationBytes, nowSeconds) {
97
+ if (presentationBytes.length === 0) {
98
+ rejectForbidden('Profile-key credential presentation is required');
99
+ }
100
+ try {
101
+ const presentation = deserializeProfileKeyCredentialPresentation(presentationBytes);
102
+ verifyProfileKeyCredentialPresentation(serverSecretParams.profileKeyCredentialKeyPair, groupPublicParams, presentation, nowSeconds);
103
+ if (!equal(aciCiphertext, serializePresentationCiphertext(SERVICE_ID_ACI, presentation.uidEncCiphertext)) ||
104
+ !equal(profileKeyCiphertext, serializeProfileKeyPresentationCiphertext(presentation.profileKeyEncCiphertext))) {
105
+ rejectForbidden('Profile-key presentation does not bind the submitted member');
106
+ }
107
+ }
108
+ catch (error) {
109
+ if (error instanceof GroupServerError)
110
+ throw error;
111
+ rejectForbidden('Profile-key credential presentation verification failed');
112
+ }
113
+ }
114
+ function stripStateProfileKeyPresentations(state) {
115
+ const stripped = structuredClone(state);
116
+ for (const member of stripped.members) {
117
+ member.presentation = new Uint8Array(0);
118
+ }
119
+ for (const member of stripped.membersPendingAdminApproval) {
120
+ member.presentation = new Uint8Array(0);
121
+ }
122
+ return stripped;
123
+ }
124
+ function stripChangeProfileKeyPresentations(change) {
125
+ const stripped = structuredClone(change);
126
+ for (const members of [
127
+ stripped.newMembers,
128
+ stripped.modifiedProfileKeys,
129
+ stripped.promotePendingMembers,
130
+ stripped.promotePendingPniAciMembers,
131
+ ]) {
132
+ for (const member of members) {
133
+ member.presentation = new Uint8Array(0);
134
+ }
135
+ }
136
+ for (const member of stripped.newRequestingMembers) {
137
+ member.presentation = new Uint8Array(0);
138
+ }
139
+ return stripped;
140
+ }
141
+ function verifyStateProfileKeyPresentations(state, serverSecretParams, nowSeconds) {
142
+ const groupPublicParams = deserializeGroupPublicParams(state.publicKey);
143
+ for (const member of state.members) {
144
+ verifyProfileKeyPresentation(serverSecretParams, groupPublicParams, member.userId, member.profileKey, member.presentation, nowSeconds);
145
+ }
146
+ for (const member of state.membersPendingAdminApproval) {
147
+ verifyProfileKeyPresentation(serverSecretParams, groupPublicParams, member.userId, member.profileKey, member.presentation, nowSeconds);
148
+ }
149
+ }
150
+ function verifyChangeProfileKeyPresentations(state, change, serverSecretParams, nowSeconds) {
151
+ const groupPublicParams = deserializeGroupPublicParams(state.publicKey);
152
+ const members = [
153
+ ...change.newMembers,
154
+ ...change.modifiedProfileKeys,
155
+ ...change.promotePendingMembers,
156
+ ...change.promotePendingPniAciMembers,
157
+ ];
158
+ for (const member of members) {
159
+ verifyProfileKeyPresentation(serverSecretParams, groupPublicParams, member.aciCiphertext, member.profileKeyCiphertext, member.presentation, nowSeconds);
160
+ }
161
+ for (const member of change.newRequestingMembers) {
162
+ verifyProfileKeyPresentation(serverSecretParams, groupPublicParams, member.aciCiphertext, member.profileKeyCiphertext, member.presentation, nowSeconds);
163
+ }
164
+ }
165
+ function memberFromAction(action, role, joinedAtVersion) {
166
+ return {
167
+ userId: action.aciCiphertext,
168
+ role,
169
+ profileKey: action.profileKeyCiphertext,
170
+ presentation: action.presentation,
171
+ joinedAtVersion,
172
+ labelEmoji: new Uint8Array(0),
173
+ labelString: new Uint8Array(0),
174
+ };
175
+ }
176
+ function validTimestamp(value) {
177
+ return Number.isSafeInteger(value) && value >= 0;
178
+ }
179
+ function assertRecognizedActionShape(change, form) {
180
+ try {
181
+ assertValidEncryptedGroupChangeWire(change, form);
182
+ assertRecognizedEncryptedGroupChange(change);
183
+ assertEncryptedGroupChangeForm(change, form);
184
+ }
185
+ catch (error) {
186
+ rejectBadRequest(error instanceof Error ? error.message : 'Actions are malformed');
187
+ }
188
+ if (!Number.isSafeInteger(change.revision) || change.revision < 1) {
189
+ rejectBadRequest('Actions revision must be a positive safe integer');
190
+ }
191
+ if (change.terminate !== undefined && change.terminate !== true) {
192
+ rejectBadRequest('Termination action must be true');
193
+ }
194
+ const requireProfileKeyAction = (member, label) => {
195
+ requireCiphertextEncoding(member.aciCiphertext, `${label}.aciCiphertext`, 'aci');
196
+ requireCiphertextEncoding(member.profileKeyCiphertext, `${label}.profileKeyCiphertext`, 'profile-key');
197
+ if (!(member.presentation instanceof Uint8Array)) {
198
+ rejectBadRequest(`${label}.presentation must be bytes`);
199
+ }
200
+ };
201
+ for (const [index, member] of change.newMembers.entries()) {
202
+ requireProfileKeyAction(member, `Actions.newMembers[${index}]`);
203
+ if (!isStoredMemberRole(member.role)) {
204
+ rejectBadRequest(`Actions.newMembers[${index}].role is invalid`);
205
+ }
206
+ if (form === 'canonical' && member.joinedAtRevision !== change.revision) {
207
+ rejectBadRequest(`Actions.newMembers[${index}].joinedAtRevision must equal the change revision`);
208
+ }
209
+ }
210
+ for (const [index, member] of change.modifiedProfileKeys.entries()) {
211
+ requireProfileKeyAction(member, `Actions.modifiedProfileKeys[${index}]`);
212
+ }
213
+ for (const [index, member] of change.promotePendingMembers.entries()) {
214
+ requireProfileKeyAction(member, `Actions.promotePendingMembers[${index}]`);
215
+ if (form === 'canonical' &&
216
+ (!isStoredMemberRole(member.role) ||
217
+ member.joinedAtRevision !== change.revision)) {
218
+ rejectBadRequest(`Actions.promotePendingMembers[${index}] has invalid derived role or joinedAtRevision`);
219
+ }
220
+ }
221
+ for (const [index, member] of change.promotePendingPniAciMembers.entries()) {
222
+ requireProfileKeyAction(member, `Actions.promotePendingPniAciMembers[${index}]`);
223
+ if (form === 'canonical' &&
224
+ (!isStoredMemberRole(member.role) ||
225
+ member.joinedAtRevision !== change.revision)) {
226
+ rejectBadRequest(`Actions.promotePendingPniAciMembers[${index}] has invalid derived role or joinedAtRevision`);
227
+ }
228
+ if (member.pniCiphertext.length !== 65) {
229
+ rejectBadRequest(`Actions.promotePendingPniAciMembers[${index}].pniCiphertext is required`);
230
+ }
231
+ }
232
+ for (const [index, ciphertext] of change.deleteMembers.entries()) {
233
+ requireCiphertextEncoding(ciphertext, `Actions.deleteMembers[${index}]`, 'aci');
234
+ }
235
+ for (const [index, member] of change.modifyMemberRoles.entries()) {
236
+ requireCiphertextEncoding(member.aciCiphertext, `Actions.modifyMemberRoles[${index}].aciCiphertext`, 'aci');
237
+ if (!isStoredMemberRole(member.role)) {
238
+ rejectBadRequest(`Actions.modifyMemberRoles[${index}].role is invalid`);
239
+ }
240
+ }
241
+ for (const [index, member] of change.modifyMemberLabels.entries()) {
242
+ requireCiphertextEncoding(member.aciCiphertext, `Actions.modifyMemberLabels[${index}].aciCiphertext`, 'aci');
243
+ requireBlobEncoding(member.labelEmojiCiphertext, `Actions.modifyMemberLabels[${index}].labelEmojiCiphertext`);
244
+ requireBlobEncoding(member.labelStringCiphertext, `Actions.modifyMemberLabels[${index}].labelStringCiphertext`);
245
+ }
246
+ for (const [index, member] of change.newPendingMembers.entries()) {
247
+ requireCiphertextEncoding(member.serviceIdCiphertext, `Actions.newPendingMembers[${index}].serviceIdCiphertext`, 'service-id');
248
+ if (!isStoredMemberRole(member.role)) {
249
+ rejectBadRequest(`Actions.newPendingMembers[${index}].role is invalid`);
250
+ }
251
+ if (form === 'canonical') {
252
+ requireCiphertextEncoding(member.addedByAciCiphertext, `Actions.newPendingMembers[${index}].addedByAciCiphertext`, 'aci');
253
+ if (!validTimestamp(member.timestamp)) {
254
+ rejectBadRequest(`Actions.newPendingMembers[${index}].timestamp is invalid`);
255
+ }
256
+ }
257
+ }
258
+ for (const [index, member] of change.deletePendingMembers.entries()) {
259
+ requireCiphertextEncoding(member.serviceIdCiphertext, `Actions.deletePendingMembers[${index}].serviceIdCiphertext`, 'service-id');
260
+ }
261
+ for (const [index, member] of change.newRequestingMembers.entries()) {
262
+ requireCiphertextEncoding(member.aciCiphertext, `Actions.newRequestingMembers[${index}].aciCiphertext`, 'aci');
263
+ requireCiphertextEncoding(member.profileKeyCiphertext, `Actions.newRequestingMembers[${index}].profileKeyCiphertext`, 'profile-key');
264
+ if (!(member.presentation instanceof Uint8Array)) {
265
+ rejectBadRequest(`Actions.newRequestingMembers[${index}].presentation must be bytes`);
266
+ }
267
+ if (form === 'canonical' && !validTimestamp(member.timestamp)) {
268
+ rejectBadRequest(`Actions.newRequestingMembers[${index}].timestamp is invalid`);
269
+ }
270
+ }
271
+ for (const [index, ciphertext] of change.deleteRequestingMembers.entries()) {
272
+ requireCiphertextEncoding(ciphertext, `Actions.deleteRequestingMembers[${index}]`, 'aci');
273
+ }
274
+ for (const [index, member] of change.promoteRequestingMembers.entries()) {
275
+ requireCiphertextEncoding(member.aciCiphertext, `Actions.promoteRequestingMembers[${index}].aciCiphertext`, 'aci');
276
+ if (!isStoredMemberRole(member.role)) {
277
+ rejectBadRequest(`Actions.promoteRequestingMembers[${index}].role is invalid`);
278
+ }
279
+ }
280
+ for (const [index, member] of change.newBannedMembers.entries()) {
281
+ requireCiphertextEncoding(member.serviceIdCiphertext, `Actions.newBannedMembers[${index}].serviceIdCiphertext`, 'service-id');
282
+ if (form === 'canonical' && !validTimestamp(member.timestamp)) {
283
+ rejectBadRequest(`Actions.newBannedMembers[${index}].timestamp is invalid`);
284
+ }
285
+ }
286
+ for (const [index, member] of change.deleteBannedMembers.entries()) {
287
+ requireCiphertextEncoding(member.serviceIdCiphertext, `Actions.deleteBannedMembers[${index}].serviceIdCiphertext`, 'service-id');
288
+ }
289
+ for (const [value, label] of [
290
+ [change.newTitle, 'Actions.newTitle'],
291
+ [change.newTimer, 'Actions.newTimer'],
292
+ [change.newDescription, 'Actions.newDescription'],
293
+ ]) {
294
+ if (value !== undefined) {
295
+ requireBlobEncoding(value, label, false);
296
+ }
297
+ }
298
+ if (change.newAvatar !== undefined &&
299
+ (typeof change.newAvatar !== 'object' ||
300
+ change.newAvatar === null ||
301
+ typeof change.newAvatar.value !== 'string')) {
302
+ rejectBadRequest('Actions.newAvatar must carry a string value');
303
+ }
304
+ for (const [value, label] of [
305
+ [change.newAttributeAccess, 'Actions.newAttributeAccess'],
306
+ [change.newMemberAccess, 'Actions.newMemberAccess'],
307
+ [change.newMemberLabelAccess, 'Actions.newMemberLabelAccess'],
308
+ ]) {
309
+ if (value !== undefined && !isRoleAccessRequirement(value)) {
310
+ rejectBadRequest(`${label} is outside its §6.7 domain`);
311
+ }
312
+ }
313
+ if (change.newInviteLinkAccess !== undefined &&
314
+ !isInviteLinkAccessRequirement(change.newInviteLinkAccess)) {
315
+ rejectBadRequest('Actions.newInviteLinkAccess is outside its §6.7 domain');
316
+ }
317
+ if (change.newIsAnnouncementGroup !== undefined &&
318
+ change.newIsAnnouncementGroup !== EnabledState.ENABLED &&
319
+ change.newIsAnnouncementGroup !== EnabledState.DISABLED) {
320
+ rejectBadRequest('Actions.newIsAnnouncementGroup is invalid');
321
+ }
322
+ const { newInviteLinkPassword } = change;
323
+ if (newInviteLinkPassword !== undefined &&
324
+ (!(newInviteLinkPassword instanceof Uint8Array) ||
325
+ newInviteLinkPassword.length !== 16)) {
326
+ rejectBadRequest('Actions.newInviteLinkPassword must be 16 bytes');
327
+ }
328
+ }
329
+ function assertEncryptedStateStructure(state) {
330
+ try {
331
+ assertValidEncryptedGroupWire(state);
332
+ }
333
+ catch (error) {
334
+ rejectBadRequest(error instanceof Error ? error.message : 'Encrypted group state is malformed');
335
+ }
336
+ if (!Number.isSafeInteger(state.version) || state.version < 0) {
337
+ rejectBadRequest('Group version must be a non-negative safe integer');
338
+ }
339
+ if (!Array.isArray(state.members) ||
340
+ !Array.isArray(state.membersPendingProfileKey) ||
341
+ !Array.isArray(state.membersPendingAdminApproval) ||
342
+ !Array.isArray(state.membersBanned)) {
343
+ rejectBadRequest('Group membership fields must be arrays');
344
+ }
345
+ if (state.members.length > MAX_GROUP_SIZE) {
346
+ rejectBadRequest(`Group exceeds the ${MAX_GROUP_SIZE}-member limit`);
347
+ }
348
+ if (state.membersPendingProfileKey.length > MAX_GROUP_SIZE) {
349
+ rejectBadRequest(`Group exceeds the ${MAX_GROUP_SIZE}-pending-member limit`);
350
+ }
351
+ if (state.membersPendingAdminApproval.length > MAX_GROUP_SIZE) {
352
+ rejectBadRequest(`Group exceeds the ${MAX_GROUP_SIZE}-requesting-member limit`);
353
+ }
354
+ if (state.membersBanned.length > MAX_GROUP_SIZE) {
355
+ rejectBadRequest(`Group exceeds the ${MAX_GROUP_SIZE}-banned-member limit`);
356
+ }
357
+ if (!(state.publicKey instanceof Uint8Array) ||
358
+ !(state.title instanceof Uint8Array) ||
359
+ !(state.description instanceof Uint8Array) ||
360
+ !(state.disappearingMessagesTimer instanceof Uint8Array) ||
361
+ !(state.inviteLinkPassword instanceof Uint8Array) ||
362
+ (state.inviteLinkPassword.length !== 0 &&
363
+ state.inviteLinkPassword.length !== 16) ||
364
+ typeof state.avatarUrl !== 'string' ||
365
+ typeof state.announcementsOnly !== 'boolean' ||
366
+ typeof state.terminated !== 'boolean') {
367
+ rejectBadRequest('Group scalar or encrypted attribute fields are malformed');
368
+ }
369
+ if (!isRoleAccessRequirement(state.accessControl?.attributes) ||
370
+ !isRoleAccessRequirement(state.accessControl?.members) ||
371
+ !isRoleAccessRequirement(state.accessControl?.memberLabel) ||
372
+ !isInviteLinkAccessRequirement(state.accessControl?.addFromInviteLink)) {
373
+ rejectBadRequest('Group access control is invalid');
374
+ }
375
+ const occupied = new Set();
376
+ const occupy = (ciphertext, label) => {
377
+ const key = Array.from(ciphertext, (byte) => byte.toString(16).padStart(2, '0')).join('');
378
+ if (occupied.has(key)) {
379
+ rejectBadRequest(`Principal appears in multiple group-state entries (${label})`);
380
+ }
381
+ occupied.add(key);
382
+ };
383
+ requireBlobEncoding(state.title, 'Group.title');
384
+ requireBlobEncoding(state.description, 'Group.description');
385
+ requireBlobEncoding(state.disappearingMessagesTimer, 'Group.disappearingMessagesTimer');
386
+ for (const member of state.members) {
387
+ requireCiphertextEncoding(member.userId, 'members.userId', 'aci');
388
+ requireCiphertextEncoding(member.profileKey, 'members.profileKey', 'profile-key');
389
+ if (!isStoredMemberRole(member.role) ||
390
+ !(member.presentation instanceof Uint8Array) ||
391
+ !Number.isSafeInteger(member.joinedAtVersion) ||
392
+ member.joinedAtVersion < 0 ||
393
+ member.joinedAtVersion > state.version ||
394
+ !(member.labelEmoji instanceof Uint8Array) ||
395
+ !(member.labelString instanceof Uint8Array)) {
396
+ rejectBadRequest('Stored member fields are malformed');
397
+ }
398
+ requireBlobEncoding(member.labelEmoji, 'members.labelEmoji');
399
+ requireBlobEncoding(member.labelString, 'members.labelString');
400
+ occupy(member.userId, 'members');
401
+ }
402
+ for (const pending of state.membersPendingProfileKey) {
403
+ requireCiphertextEncoding(pending.member.userId, 'membersPendingProfileKey.userId', 'service-id');
404
+ requireCiphertextEncoding(pending.addedByUserId, 'membersPendingProfileKey.addedByUserId', 'aci');
405
+ if (!isStoredMemberRole(pending.member.role) ||
406
+ !validTimestamp(pending.timestamp) ||
407
+ pending.member.profileKey.length !== 0 ||
408
+ pending.member.presentation.length !== 0) {
409
+ rejectBadRequest('Stored pending-member fields are malformed');
410
+ }
411
+ occupy(pending.member.userId, 'membersPendingProfileKey');
412
+ }
413
+ for (const requesting of state.membersPendingAdminApproval) {
414
+ requireCiphertextEncoding(requesting.userId, 'membersPendingAdminApproval.userId', 'aci');
415
+ requireCiphertextEncoding(requesting.profileKey, 'membersPendingAdminApproval.profileKey', 'profile-key');
416
+ if (!(requesting.presentation instanceof Uint8Array) ||
417
+ !validTimestamp(requesting.timestamp)) {
418
+ rejectBadRequest('Stored requesting-member fields are malformed');
419
+ }
420
+ occupy(requesting.userId, 'membersPendingAdminApproval');
421
+ }
422
+ for (const banned of state.membersBanned) {
423
+ requireCiphertextEncoding(banned.userId, 'membersBanned.userId', 'service-id');
424
+ if (!validTimestamp(banned.timestamp)) {
425
+ rejectBadRequest('Stored banned-member timestamp is invalid');
426
+ }
427
+ occupy(banned.userId, 'membersBanned');
428
+ }
429
+ }
430
+ function assertEncryptedCreationStateStructure(state) {
431
+ try {
432
+ assertValidEncryptedGroupCreationSubmissionWire(state);
433
+ }
434
+ catch (error) {
435
+ rejectBadRequest(error instanceof Error
436
+ ? error.message
437
+ : 'Encrypted group creation submission is malformed');
438
+ }
439
+ }
440
+ function requesterMatches(requester, userId) {
441
+ return (equal(userId, requester.aciCiphertext) ||
442
+ (requester.pniCiphertext !== undefined &&
443
+ equal(userId, requester.pniCiphertext)));
444
+ }
445
+ function roleForSource(state, sourceUserId) {
446
+ return (state.members.find((member) => equal(member.userId, sourceUserId))?.role ??
447
+ MemberRole.UNKNOWN);
448
+ }
449
+ function roleForRequesterAliases(state, requester) {
450
+ return (state.members.find((member) => requesterMatches(requester, member.userId))?.role ??
451
+ MemberRole.UNKNOWN);
452
+ }
453
+ function requesterIsBanned(state, requester) {
454
+ return state.membersBanned.some((member) => requesterMatches(requester, member.userId));
455
+ }
456
+ function matchingRequesterIds(state, requester) {
457
+ return [
458
+ ...state.members.map((member) => member.userId),
459
+ ...state.membersPendingProfileKey.map((pending) => pending.member.userId),
460
+ ...state.membersPendingAdminApproval.map((pending) => pending.userId),
461
+ ].filter((userId) => requesterMatches(requester, userId));
462
+ }
463
+ function sourceUserIdForChange(state, change, requester) {
464
+ const actionNamedRequesterIds = [
465
+ ...change.promotePendingPniAciMembers.map((promotion) => promotion.pniCiphertext),
466
+ ...change.deletePendingMembers
467
+ .map((removal) => removal.serviceIdCiphertext)
468
+ .filter((target) => requesterMatches(requester, target)),
469
+ ...change.deleteRequestingMembers.filter((target) => requesterMatches(requester, target)),
470
+ ].filter((candidate, index, candidates) => candidates.findIndex((other) => equal(candidate, other)) === index);
471
+ if (actionNamedRequesterIds.length > 1) {
472
+ rejectForbidden('A change cannot exercise self-rights under multiple requester aliases');
473
+ }
474
+ if (actionNamedRequesterIds.length === 1) {
475
+ return actionNamedRequesterIds[0];
476
+ }
477
+ const preChangeMatches = matchingRequesterIds(state, requester);
478
+ const matches = preChangeMatches.length > 0
479
+ ? preChangeMatches
480
+ : [
481
+ ...change.newMembers.map((member) => member.aciCiphertext),
482
+ ...change.newRequestingMembers.map((member) => member.aciCiphertext),
483
+ ].filter((userId) => requesterMatches(requester, userId));
484
+ const aciMatch = matches.find((userId) => equal(userId, requester.aciCiphertext));
485
+ const sourceUserId = aciMatch ?? matches[0];
486
+ if (!sourceUserId) {
487
+ rejectForbidden('Requester does not match the pre- or post-change group state');
488
+ }
489
+ return sourceUserId;
490
+ }
491
+ function pendingRole(state, userId, label) {
492
+ const pending = state.membersPendingProfileKey.find((member) => equal(member.member.userId, userId));
493
+ if (!pending) {
494
+ rejectBadRequest(`Cannot derive role for missing ${label}`);
495
+ }
496
+ return pending.member.role;
497
+ }
498
+ function canonicalizeAcceptedChange(state, submitted, sourceUserId, groupId, timestamp) {
499
+ const stripped = stripChangeProfileKeyPresentations(submitted);
500
+ return {
501
+ ...stripped,
502
+ sourceUserId,
503
+ groupId: new Uint8Array(groupId),
504
+ newMembers: stripped.newMembers.map((member) => ({
505
+ ...member,
506
+ joinedAtRevision: stripped.revision,
507
+ })),
508
+ newPendingMembers: stripped.newPendingMembers.map((member) => ({
509
+ ...member,
510
+ addedByAciCiphertext: new Uint8Array(sourceUserId),
511
+ timestamp,
512
+ })),
513
+ promotePendingMembers: stripped.promotePendingMembers.map((member) => ({
514
+ ...member,
515
+ role: pendingRole(state, member.aciCiphertext, 'pending ACI member'),
516
+ joinedAtRevision: stripped.revision,
517
+ })),
518
+ promotePendingPniAciMembers: stripped.promotePendingPniAciMembers.map((member) => ({
519
+ ...member,
520
+ role: pendingRole(state, member.pniCiphertext, 'pending PNI member'),
521
+ joinedAtRevision: stripped.revision,
522
+ })),
523
+ newRequestingMembers: stripped.newRequestingMembers.map((member) => ({
524
+ ...member,
525
+ timestamp,
526
+ })),
527
+ newBannedMembers: stripped.newBannedMembers.map((member) => ({
528
+ ...member,
529
+ timestamp,
530
+ })),
531
+ };
532
+ }
533
+ function targetIsRequester(target, sourceUserId) {
534
+ return equal(target, sourceUserId);
535
+ }
536
+ function authorizeEncryptedChange(state, change, sourceUserId, requester) {
537
+ const role = roleForSource(state, sourceUserId);
538
+ const banned = requesterIsBanned(state, requester);
539
+ const policyState = {
540
+ accessControl: state.accessControl,
541
+ isAnnouncementGroup: state.announcementsOnly
542
+ ? EnabledState.ENABLED
543
+ : EnabledState.DISABLED,
544
+ };
545
+ const check = (action, target, assignedRole) => {
546
+ if (!canRolePerformAction(policyState, role, action, {
547
+ requesterIsBanned: banned,
548
+ targetIsRequester: target
549
+ ? targetIsRequester(target, sourceUserId)
550
+ : false,
551
+ assignedRole,
552
+ })) {
553
+ rejectForbidden(`Requester cannot perform ${action}`);
554
+ }
555
+ };
556
+ for (const member of change.newMembers) {
557
+ check(GroupAction.ADD_MEMBER, member.aciCiphertext, member.role);
558
+ }
559
+ for (const member of change.deleteMembers)
560
+ check(GroupAction.REMOVE_MEMBER, member);
561
+ for (const member of change.modifyMemberRoles) {
562
+ check(GroupAction.MODIFY_MEMBER_ROLE, member.aciCiphertext);
563
+ }
564
+ for (const member of change.modifiedProfileKeys) {
565
+ check(GroupAction.MODIFY_MEMBER_PROFILE_KEY, member.aciCiphertext);
566
+ }
567
+ for (const member of change.newPendingMembers) {
568
+ check(GroupAction.ADD_MEMBER_PENDING_PROFILE_KEY, member.serviceIdCiphertext, member.role);
569
+ }
570
+ for (const member of change.deletePendingMembers) {
571
+ check(GroupAction.DELETE_MEMBER_PENDING_PROFILE_KEY, member.serviceIdCiphertext);
572
+ }
573
+ for (const member of change.promotePendingMembers) {
574
+ check(GroupAction.PROMOTE_MEMBER_PENDING_PROFILE_KEY, member.aciCiphertext);
575
+ }
576
+ for (const member of change.promotePendingPniAciMembers) {
577
+ const pniPending = state.membersPendingProfileKey.find((pending) => equal(pending.member.userId, member.pniCiphertext));
578
+ const aciPending = state.membersPendingProfileKey.find((pending) => equal(pending.member.userId, member.aciCiphertext));
579
+ if (pniPending &&
580
+ aciPending &&
581
+ pniPending.member.role !== aciPending.member.role) {
582
+ rejectForbidden('PNI-to-ACI promotion cannot consume pending aliases with different roles');
583
+ }
584
+ check(GroupAction.PROMOTE_MEMBER_PENDING_PNI_ACI_PROFILE_KEY, member.pniCiphertext);
585
+ }
586
+ if (change.newTitle !== undefined)
587
+ check(GroupAction.MODIFY_TITLE);
588
+ if (change.newAvatar !== undefined)
589
+ check(GroupAction.MODIFY_AVATAR);
590
+ if (change.newTimer !== undefined)
591
+ check(GroupAction.MODIFY_DISAPPEARING_MESSAGES);
592
+ if (change.newDescription !== undefined)
593
+ check(GroupAction.MODIFY_DESCRIPTION);
594
+ if (change.newAttributeAccess !== undefined)
595
+ check(GroupAction.MODIFY_ATTRIBUTES_ACCESS);
596
+ if (change.newMemberAccess !== undefined)
597
+ check(GroupAction.MODIFY_MEMBERS_ACCESS);
598
+ if (change.newInviteLinkAccess !== undefined) {
599
+ check(GroupAction.MODIFY_INVITE_LINK_ACCESS);
600
+ }
601
+ if (change.newMemberLabelAccess !== undefined) {
602
+ check(GroupAction.MODIFY_MEMBER_LABEL_ACCESS);
603
+ }
604
+ if (change['newInviteLinkPassword'] !== undefined) {
605
+ check(GroupAction.MODIFY_INVITE_LINK_PASSWORD);
606
+ }
607
+ if (change.newIsAnnouncementGroup !== undefined) {
608
+ check(GroupAction.MODIFY_ANNOUNCEMENTS);
609
+ }
610
+ for (const member of change.newRequestingMembers) {
611
+ check(GroupAction.ADD_MEMBER_PENDING_ADMIN_APPROVAL, member.aciCiphertext);
612
+ }
613
+ for (const member of change.deleteRequestingMembers) {
614
+ check(GroupAction.DELETE_MEMBER_PENDING_ADMIN_APPROVAL, member);
615
+ }
616
+ for (const member of change.promoteRequestingMembers) {
617
+ check(GroupAction.PROMOTE_MEMBER_PENDING_ADMIN_APPROVAL, member.aciCiphertext);
618
+ }
619
+ for (const member of change.newBannedMembers) {
620
+ check(GroupAction.BAN_MEMBER, member.serviceIdCiphertext);
621
+ }
622
+ for (const member of change.deleteBannedMembers) {
623
+ check(GroupAction.UNBAN_MEMBER, member.serviceIdCiphertext);
624
+ }
625
+ for (const member of change.modifyMemberLabels) {
626
+ check(GroupAction.MODIFY_MEMBER_LABEL, member.aciCiphertext);
627
+ }
628
+ if (change.terminate === true)
629
+ check(GroupAction.TERMINATE_GROUP);
630
+ }
631
+ function requirePniAciBinding(change, requester) {
632
+ for (const promotion of change.promotePendingPniAciMembers) {
633
+ if (!equal(promotion.aciCiphertext, requester.aciCiphertext) ||
634
+ requester.pniCiphertext === undefined ||
635
+ promotion.pniCiphertext.length === 0 ||
636
+ !equal(promotion.pniCiphertext, requester.pniCiphertext)) {
637
+ rejectForbidden('PNI-to-ACI promotion is not bound to the requester presentation');
638
+ }
639
+ }
640
+ }
641
+ function isLinkJoin(state, change, requester) {
642
+ if (roleForRequesterAliases(state, requester) !== MemberRole.UNKNOWN) {
643
+ return false;
644
+ }
645
+ return (change.newMembers.some((member) => equal(member.aciCiphertext, requester.aciCiphertext)) ||
646
+ change.newRequestingMembers.some((member) => equal(member.aciCiphertext, requester.aciCiphertext)));
647
+ }
648
+ function requireInviteLinkPassword(state, change, requester, password) {
649
+ if (isLinkJoin(state, change, requester) &&
650
+ (state.inviteLinkPassword.length !== INVITE_LINK_PASSWORD_LENGTH ||
651
+ password.length !== INVITE_LINK_PASSWORD_LENGTH ||
652
+ !constantTimeEqual(state.inviteLinkPassword, password))) {
653
+ rejectForbidden('Invite-link password is absent or invalid');
654
+ }
655
+ }
656
+ function applyEncryptedChange(state, change) {
657
+ if (state.terminated)
658
+ rejectBadRequest('Group is terminated');
659
+ const next = structuredClone(state);
660
+ const { newInviteLinkPassword } = change;
661
+ const missing = (description) => rejectBadRequest(`Action targets a missing ${description}`);
662
+ const duplicate = (description) => rejectBadRequest(`Action creates a duplicate ${description}`);
663
+ for (const removal of change.deletePendingMembers) {
664
+ const index = next.membersPendingProfileKey.findIndex((member) => equal(member.member.userId, removal.serviceIdCiphertext));
665
+ if (index < 0)
666
+ missing('pending member');
667
+ next.membersPendingProfileKey.splice(index, 1);
668
+ }
669
+ for (const userId of change.deleteRequestingMembers) {
670
+ const index = next.membersPendingAdminApproval.findIndex((member) => equal(member.userId, userId));
671
+ if (index < 0)
672
+ missing('requesting member');
673
+ next.membersPendingAdminApproval.splice(index, 1);
674
+ }
675
+ for (const removal of change.deleteBannedMembers) {
676
+ const index = next.membersBanned.findIndex((member) => equal(member.userId, removal.serviceIdCiphertext));
677
+ if (index < 0)
678
+ missing('banned member');
679
+ next.membersBanned.splice(index, 1);
680
+ }
681
+ for (const userId of change.deleteMembers) {
682
+ const index = next.members.findIndex((member) => equal(member.userId, userId));
683
+ if (index < 0)
684
+ missing('member');
685
+ next.members.splice(index, 1);
686
+ }
687
+ for (const addition of change.newBannedMembers) {
688
+ if (next.membersBanned.some((member) => equal(member.userId, addition.serviceIdCiphertext))) {
689
+ duplicate('banned member');
690
+ }
691
+ if (next.membersBanned.length >= MAX_GROUP_SIZE) {
692
+ rejectBadRequest('Group banned-member list is full');
693
+ }
694
+ next.membersBanned.push({
695
+ userId: addition.serviceIdCiphertext,
696
+ timestamp: addition.timestamp,
697
+ });
698
+ }
699
+ for (const promotion of change.promotePendingMembers) {
700
+ if (next.members.some((member) => equal(member.userId, promotion.aciCiphertext))) {
701
+ duplicate('member');
702
+ }
703
+ const index = next.membersPendingProfileKey.findIndex((member) => equal(member.member.userId, promotion.aciCiphertext));
704
+ if (index < 0)
705
+ missing('pending ACI member');
706
+ const [pending] = next.membersPendingProfileKey.splice(index, 1);
707
+ next.members.push(memberFromAction(promotion, pending.member.role, change.revision));
708
+ }
709
+ for (const promotion of change.promotePendingPniAciMembers) {
710
+ if (next.members.some((member) => equal(member.userId, promotion.aciCiphertext))) {
711
+ duplicate('member');
712
+ }
713
+ const index = next.membersPendingProfileKey.findIndex((member) => equal(member.member.userId, promotion.pniCiphertext));
714
+ if (index < 0)
715
+ missing('pending PNI member');
716
+ const [pending] = next.membersPendingProfileKey.splice(index, 1);
717
+ const aciAliasIndex = next.membersPendingProfileKey.findIndex((member) => equal(member.member.userId, promotion.aciCiphertext));
718
+ if (aciAliasIndex >= 0) {
719
+ const [aciPending] = next.membersPendingProfileKey.splice(aciAliasIndex, 1);
720
+ if (aciPending.member.role !== pending.member.role) {
721
+ rejectForbidden('PNI-to-ACI promotion cannot consume pending aliases with different roles');
722
+ }
723
+ }
724
+ next.members.push(memberFromAction(promotion, pending.member.role, change.revision));
725
+ }
726
+ for (const promotion of change.promoteRequestingMembers) {
727
+ if (next.members.some((member) => equal(member.userId, promotion.aciCiphertext))) {
728
+ duplicate('member');
729
+ }
730
+ const index = next.membersPendingAdminApproval.findIndex((member) => equal(member.userId, promotion.aciCiphertext));
731
+ if (index < 0)
732
+ missing('requesting member');
733
+ const [requesting] = next.membersPendingAdminApproval.splice(index, 1);
734
+ next.members.push({
735
+ userId: requesting.userId,
736
+ role: promotion.role,
737
+ profileKey: requesting.profileKey,
738
+ presentation: requesting.presentation,
739
+ joinedAtVersion: change.revision,
740
+ labelEmoji: new Uint8Array(0),
741
+ labelString: new Uint8Array(0),
742
+ });
743
+ }
744
+ for (const addition of change.newMembers) {
745
+ if (next.members.some((member) => equal(member.userId, addition.aciCiphertext))) {
746
+ duplicate('member');
747
+ }
748
+ if (next.members.length >= MAX_GROUP_SIZE)
749
+ rejectBadRequest('Group is full');
750
+ next.members.push(memberFromAction(addition, addition.role, addition.joinedAtRevision));
751
+ }
752
+ for (const addition of change.newPendingMembers) {
753
+ if (next.membersPendingProfileKey.some((member) => equal(member.member.userId, addition.serviceIdCiphertext))) {
754
+ duplicate('pending member');
755
+ }
756
+ if (next.membersPendingProfileKey.length >= MAX_GROUP_SIZE) {
757
+ rejectBadRequest('Group pending-member list is full');
758
+ }
759
+ next.membersPendingProfileKey.push({
760
+ member: {
761
+ userId: addition.serviceIdCiphertext,
762
+ role: addition.role,
763
+ profileKey: new Uint8Array(0),
764
+ presentation: new Uint8Array(0),
765
+ joinedAtVersion: 0,
766
+ labelEmoji: new Uint8Array(0),
767
+ labelString: new Uint8Array(0),
768
+ },
769
+ addedByUserId: addition.addedByAciCiphertext,
770
+ timestamp: addition.timestamp,
771
+ });
772
+ }
773
+ for (const addition of change.newRequestingMembers) {
774
+ if (next.membersPendingAdminApproval.some((member) => equal(member.userId, addition.aciCiphertext))) {
775
+ duplicate('requesting member');
776
+ }
777
+ if (next.membersPendingAdminApproval.length >= MAX_GROUP_SIZE) {
778
+ rejectBadRequest('Group requesting-member list is full');
779
+ }
780
+ next.membersPendingAdminApproval.push({
781
+ userId: addition.aciCiphertext,
782
+ profileKey: addition.profileKeyCiphertext,
783
+ presentation: addition.presentation,
784
+ timestamp: addition.timestamp,
785
+ });
786
+ }
787
+ for (const modification of change.modifyMemberRoles) {
788
+ const member = next.members.find((candidate) => equal(candidate.userId, modification.aciCiphertext));
789
+ if (!member)
790
+ return missing('member role target');
791
+ member.role = modification.role;
792
+ }
793
+ for (const modification of change.modifyMemberLabels) {
794
+ const member = next.members.find((candidate) => equal(candidate.userId, modification.aciCiphertext));
795
+ if (!member)
796
+ return missing('member label target');
797
+ member.labelEmoji = modification.labelEmojiCiphertext;
798
+ member.labelString = modification.labelStringCiphertext;
799
+ }
800
+ for (const modification of change.modifiedProfileKeys) {
801
+ const member = next.members.find((candidate) => equal(candidate.userId, modification.aciCiphertext));
802
+ if (!member)
803
+ return missing('member profile-key target');
804
+ member.profileKey = modification.profileKeyCiphertext;
805
+ member.presentation = modification.presentation;
806
+ }
807
+ if (change.newTitle !== undefined)
808
+ next.title = change.newTitle;
809
+ if (change.newAvatar !== undefined)
810
+ next.avatarUrl = change.newAvatar.value;
811
+ if (change.newTimer !== undefined)
812
+ next.disappearingMessagesTimer = change.newTimer;
813
+ if (change.newDescription !== undefined)
814
+ next.description = change.newDescription;
815
+ if (newInviteLinkPassword !== undefined) {
816
+ next.inviteLinkPassword = newInviteLinkPassword.slice();
817
+ }
818
+ if (change.newAttributeAccess !== undefined) {
819
+ next.accessControl.attributes = change.newAttributeAccess;
820
+ }
821
+ if (change.newMemberAccess !== undefined) {
822
+ next.accessControl.members = change.newMemberAccess;
823
+ }
824
+ if (change.newInviteLinkAccess !== undefined) {
825
+ next.accessControl.addFromInviteLink = change.newInviteLinkAccess;
826
+ }
827
+ if (change.newMemberLabelAccess !== undefined) {
828
+ next.accessControl.memberLabel = change.newMemberLabelAccess;
829
+ }
830
+ if (change.newIsAnnouncementGroup !== undefined) {
831
+ next.announcementsOnly = change.newIsAnnouncementGroup === EnabledState.ENABLED;
832
+ }
833
+ if (change.terminate === true)
834
+ next.terminated = true;
835
+ next.version = change.revision;
836
+ return next;
837
+ }
838
+ export class GroupAuthorizationServerEngine {
839
+ serverSecretParams;
840
+ runtime;
841
+ groups = new Map();
842
+ constructor(serverSecretParams, runtime = defaultRuntime) {
843
+ this.serverSecretParams = serverSecretParams;
844
+ this.runtime = runtime;
845
+ }
846
+ get publicParams() {
847
+ return getServerPublicParams(this.serverSecretParams);
848
+ }
849
+ clear() {
850
+ this.groups.clear();
851
+ }
852
+ inspectEncryptedState(groupId) {
853
+ const stored = this.groups.get(this.key(groupId));
854
+ return stored ? serializeEncryptedGroup(stored.state) : null;
855
+ }
856
+ restoreGroup(groupId, persisted) {
857
+ const state = deserializeEncryptedGroup(persisted.encryptedState);
858
+ const snapshots = new Map(persisted.snapshots.map((snapshot) => [
859
+ snapshot.version,
860
+ {
861
+ state: deserializeEncryptedGroup(snapshot.encryptedState),
862
+ baselineSignature: new Uint8Array(snapshot.baselineSignature),
863
+ },
864
+ ]));
865
+ this.groups.set(this.key(groupId), {
866
+ state,
867
+ changes: structuredClone(persisted.changes),
868
+ snapshots,
869
+ });
870
+ }
871
+ exportGroup(groupId) {
872
+ const stored = this.groups.get(this.key(groupId));
873
+ if (!stored)
874
+ return null;
875
+ return {
876
+ encryptedState: serializeEncryptedGroup(stored.state),
877
+ changes: structuredClone(stored.changes),
878
+ snapshots: [...stored.snapshots.entries()]
879
+ .sort(([left], [right]) => left - right)
880
+ .map(([version, snapshot]) => ({
881
+ version,
882
+ encryptedState: serializeEncryptedGroup(snapshot.state),
883
+ baselineSignature: new Uint8Array(snapshot.baselineSignature),
884
+ })),
885
+ };
886
+ }
887
+ key(groupId) {
888
+ return Array.from(groupId, (byte) => byte.toString(16).padStart(2, '0')).join('');
889
+ }
890
+ createStoredSnapshot(groupId, state) {
891
+ const encryptedState = serializeEncryptedGroup(state);
892
+ return {
893
+ state: structuredClone(state),
894
+ baselineSignature: serverSign(this.serverSecretParams, this.runtime.randomBytes(32), serializeGroupBaseline(groupId, state.version, encryptedState)),
895
+ };
896
+ }
897
+ authenticate(groupId, authorization, state) {
898
+ try {
899
+ const groupPublicParams = deserializeGroupPublicParams(new Uint8Array(authorization.groupPublicParams));
900
+ if (!equal(groupPublicParams.groupId, groupId)) {
901
+ rejectUnauthorized('Presentation is bound to a different group');
902
+ }
903
+ if (state &&
904
+ !equal(state.publicKey, serializeGroupPublicParams(groupPublicParams))) {
905
+ rejectUnauthorized('Presentation parameters do not match stored group parameters');
906
+ }
907
+ const presentation = deserializeAuthCredentialPresentation(new Uint8Array(authorization.presentation));
908
+ const nowSeconds = Math.floor(this.runtime.now() / 1000);
909
+ const today = Math.floor(nowSeconds / SECONDS_PER_DAY) * SECONDS_PER_DAY;
910
+ if (presentation.redemptionTime % SECONDS_PER_DAY !== 0 ||
911
+ Math.abs(presentation.redemptionTime - today) > SECONDS_PER_DAY) {
912
+ rejectUnauthorized('Credential redemption time is outside current day ± one day');
913
+ }
914
+ verifyAuthCredentialPresentation(this.serverSecretParams.credentialKeyPair, groupPublicParams, presentation, nowSeconds);
915
+ return {
916
+ aciCiphertext: serializePresentationCiphertext(SERVICE_ID_ACI, presentation.aciCiphertext),
917
+ pniCiphertext: presentation.pniCiphertext === undefined
918
+ ? undefined
919
+ : serializePresentationCiphertext(SERVICE_ID_PNI, presentation.pniCiphertext),
920
+ };
921
+ }
922
+ catch (error) {
923
+ if (error instanceof GroupServerError)
924
+ throw error;
925
+ rejectUnauthorized(error instanceof Error ? error.message : 'Credential presentation verification failed');
926
+ }
927
+ }
928
+ isReadable(state, requester) {
929
+ if (requesterIsBanned(state, requester))
930
+ return false;
931
+ return (state.members.some((member) => requesterMatches(requester, member.userId)) ||
932
+ state.membersPendingProfileKey.some((pending) => requesterMatches(requester, pending.member.userId)));
933
+ }
934
+ requireReadable(state, requester) {
935
+ if (!this.isReadable(state, requester)) {
936
+ rejectForbidden('Requester may not read full group state', 'not_readable');
937
+ }
938
+ }
939
+ /**
940
+ * The version at which the requester's current tenure began, or undefined
941
+ * when the requester has no tenure to read.
942
+ *
943
+ * Deliberately consults `members` only. A pending-profile-key entry is an
944
+ * invitation, not a tenure: its wire format pins `joinedAtVersion` to
945
+ * zero, so reading it here would hand every invitee a floor of "the
946
+ * beginning of time" — an invitee who never accepts could page through the
947
+ * group's entire pre-invitation history, which is more than acceptance
948
+ * itself would grant. An invitee reads the *current* state (that is what
949
+ * an invitation entitles, and what acceptance needs); versioned history
950
+ * starts existing for them when they join and their member entry records
951
+ * where.
952
+ */
953
+ requesterJoinedAtVersion(state, requester) {
954
+ return state.members.find((candidate) => requesterMatches(requester, candidate.userId))?.joinedAtVersion;
955
+ }
956
+ async createGroup(groupId, encryptedState, authorization) {
957
+ const key = this.key(groupId);
958
+ if (this.groups.has(key))
959
+ rejectConflict('Group already exists');
960
+ let submission;
961
+ try {
962
+ submission = deserializeEncryptedGroupCreationSubmission(encryptedState);
963
+ }
964
+ catch {
965
+ return rejectBadRequest('Encrypted group state is malformed');
966
+ }
967
+ const requester = this.authenticate(groupId, authorization);
968
+ if (!equal(submission.publicKey, authorization.groupPublicParams)) {
969
+ rejectBadRequest('Stored publicKey must be serialized GroupPublicParams');
970
+ }
971
+ assertEncryptedCreationStateStructure(submission);
972
+ const now = this.runtime.now();
973
+ const state = {
974
+ ...submission,
975
+ membersPendingProfileKey: submission.membersPendingProfileKey.map(({ userId, role }) => ({
976
+ member: {
977
+ userId,
978
+ role,
979
+ profileKey: new Uint8Array(0),
980
+ presentation: new Uint8Array(0),
981
+ joinedAtVersion: 0,
982
+ labelEmoji: new Uint8Array(0),
983
+ labelString: new Uint8Array(0),
984
+ },
985
+ addedByUserId: new Uint8Array(requester.aciCiphertext),
986
+ timestamp: now,
987
+ })),
988
+ membersPendingAdminApproval: [],
989
+ membersBanned: [],
990
+ };
991
+ assertEncryptedStateStructure(state);
992
+ verifyStateProfileKeyPresentations(state, this.serverSecretParams, Math.floor(now / 1000));
993
+ const creator = state.members.find((member) => equal(member.userId, requester.aciCiphertext));
994
+ if (!creator) {
995
+ rejectForbidden('Creator presentation is not an initial member');
996
+ }
997
+ if (creator.role !== MemberRole.ADMINISTRATOR) {
998
+ rejectForbidden('Creator must be an initial administrator');
999
+ }
1000
+ const storedState = stripStateProfileKeyPresentations(state);
1001
+ const initialSnapshot = this.createStoredSnapshot(groupId, storedState);
1002
+ this.groups.set(key, {
1003
+ state: storedState,
1004
+ changes: [],
1005
+ snapshots: new Map([[0, initialSnapshot]]),
1006
+ });
1007
+ }
1008
+ async getGroup(groupId, authorization, version) {
1009
+ const stored = this.groups.get(this.key(groupId));
1010
+ if (!stored)
1011
+ return null;
1012
+ // Authorization is evaluated against the group as it is *now*, never
1013
+ // against the requested snapshot. Historical snapshots each contain a
1014
+ // roster, and authorizing against the requested one let anyone removed or
1015
+ // banned at version N keep reading every version of their tenure forever
1016
+ // — a removal that does not revoke read access is not a removal. Current
1017
+ // membership answers "may you read this group"; the join-version floor
1018
+ // below answers "may you read this version of it".
1019
+ const requester = this.authenticate(groupId, authorization, stored.state);
1020
+ this.requireReadable(stored.state, requester);
1021
+ const snapshot = version === undefined
1022
+ ? stored.snapshots.get(stored.state.version)
1023
+ : stored.snapshots.get(version);
1024
+ if (!snapshot)
1025
+ return null;
1026
+ if (version !== undefined) {
1027
+ // Under snapshot-based authorization this floor was implicit — a
1028
+ // pre-join snapshot simply did not list the requester. Authorizing
1029
+ // against the current state removes that accident, so the floor has to
1030
+ // be stated: membership grants the group from when you joined, not its
1031
+ // history.
1032
+ const joinedAtVersion = this.requesterJoinedAtVersion(stored.state, requester);
1033
+ if (joinedAtVersion === undefined || version < joinedAtVersion) {
1034
+ rejectForbidden('Requester may not read state from before they joined', 'before_join');
1035
+ }
1036
+ }
1037
+ const { state } = snapshot;
1038
+ const encryptedState = serializeEncryptedGroup(state);
1039
+ return {
1040
+ encryptedState,
1041
+ version: state.version,
1042
+ baselineSignature: new Uint8Array(snapshot.baselineSignature),
1043
+ };
1044
+ }
1045
+ async getGroupJoinInfo(groupId, inviteLinkPassword, authorization) {
1046
+ const stored = this.groups.get(this.key(groupId));
1047
+ if (!stored)
1048
+ return null;
1049
+ const requester = this.authenticate(groupId, authorization, stored.state);
1050
+ if (requesterIsBanned(stored.state, requester)) {
1051
+ rejectForbidden('Banned requester may not read group join info');
1052
+ }
1053
+ if (stored.state.terminated) {
1054
+ rejectForbidden('Terminated group has no join info');
1055
+ }
1056
+ const pendingAdminApproval = stored.state.membersPendingAdminApproval.some((pending) => requesterMatches(requester, pending.userId));
1057
+ if (!pendingAdminApproval) {
1058
+ if (stored.state.accessControl.addFromInviteLink === AccessRequired.UNSATISFIABLE ||
1059
+ stored.state.accessControl.addFromInviteLink === AccessRequired.UNKNOWN) {
1060
+ rejectForbidden('Invite-link access is disabled or unknown');
1061
+ }
1062
+ if (stored.state.inviteLinkPassword.length !== INVITE_LINK_PASSWORD_LENGTH ||
1063
+ inviteLinkPassword.length !== INVITE_LINK_PASSWORD_LENGTH ||
1064
+ !constantTimeEqual(stored.state.inviteLinkPassword, inviteLinkPassword)) {
1065
+ rejectForbidden('Invite-link password is absent or invalid');
1066
+ }
1067
+ }
1068
+ const info = {
1069
+ publicKey: stored.state.publicKey,
1070
+ title: stored.state.title,
1071
+ avatar: stored.state.avatarUrl,
1072
+ memberCount: stored.state.members.length,
1073
+ addFromInviteLink: stored.state.accessControl.addFromInviteLink,
1074
+ revision: stored.state.version,
1075
+ pendingAdminApproval,
1076
+ description: stored.state.description,
1077
+ };
1078
+ return {
1079
+ encryptedJoinInfo: serializeEncryptedGroupJoinInfo(info),
1080
+ version: stored.state.version,
1081
+ };
1082
+ }
1083
+ async getGroupChanges(groupId, fromVersion, authorization) {
1084
+ // Unlike getGroup, this deliberately authorizes against the *requested*
1085
+ // snapshot. The walk below serves entries only while the requester stays
1086
+ // readable, stopping at — and including — the change that removed them,
1087
+ // which is how a removed member learns of their removal when they poll;
1088
+ // authorizing against the current state would 403 them into silence
1089
+ // instead. The exposure this leaves is bounded and not new: a former
1090
+ // member can re-fetch changes from within their own tenure, ending at
1091
+ // their removal — bytes they were served while entitled.
1092
+ //
1093
+ // The log is for members. A pending-profile-key entry entitles its
1094
+ // holder to the current state — acceptance needs that, and getGroup
1095
+ // serves it — but the log names the actor behind every change, and an
1096
+ // invitation is not a tenure, so a requester who is merely pending in
1097
+ // the snapshot at `fromVersion` is refused below even though that
1098
+ // snapshot lists them as readable. Pending principals catch up by
1099
+ // fetching a fresh signed snapshot instead (S10a), which is also how
1100
+ // the reference ecosystem's clients behave: their state processor
1101
+ // updates straight to the latest server state whenever the server does
1102
+ // not recognize the requester as a member. This membership requirement
1103
+ // is what closes history: for members it bounds the log at their
1104
+ // tenure (a pre-join snapshot does not list them in `members`), and
1105
+ // for invitees it closes the log outright.
1106
+ const stored = this.groups.get(this.key(groupId));
1107
+ if (!stored)
1108
+ return [];
1109
+ const snapshot = stored.snapshots.get(fromVersion);
1110
+ if (!snapshot) {
1111
+ rejectBadRequest(`Group snapshot ${fromVersion} does not exist`);
1112
+ }
1113
+ const requester = this.authenticate(groupId, authorization, snapshot.state);
1114
+ this.requireReadable(snapshot.state, requester);
1115
+ if (!snapshot.state.members.some((member) => requesterMatches(requester, member.userId))) {
1116
+ rejectForbidden('Only members may read the change log', 'not_a_member');
1117
+ }
1118
+ const readablePrefix = [];
1119
+ for (const entry of stored.changes) {
1120
+ if (entry.version <= fromVersion)
1121
+ continue;
1122
+ readablePrefix.push(entry);
1123
+ const postState = stored.snapshots.get(entry.version);
1124
+ if (!postState) {
1125
+ throw new Error(`Missing group snapshot ${entry.version}`);
1126
+ }
1127
+ if (!this.isReadable(postState.state, requester))
1128
+ break;
1129
+ }
1130
+ return structuredClone(readablePrefix);
1131
+ }
1132
+ async submitGroupChange(groupId, expectedVersion, actions, inviteLinkPassword, authorization) {
1133
+ if (arguments.length !== 5) {
1134
+ rejectBadRequest('Group change submission must not carry an epoch');
1135
+ }
1136
+ const stored = this.groups.get(this.key(groupId));
1137
+ if (!stored)
1138
+ rejectBadRequest('Group does not exist');
1139
+ const operationTime = this.runtime.now();
1140
+ const requester = this.authenticate(groupId, authorization, stored.state);
1141
+ if (stored.state.version !== expectedVersion) {
1142
+ rejectConflict(`Expected ${expectedVersion}, current version is ${stored.state.version}`);
1143
+ }
1144
+ let change;
1145
+ try {
1146
+ change = deserializeEncryptedGroupChange(actions);
1147
+ assertRecognizedActionShape(change, 'submission');
1148
+ }
1149
+ catch (error) {
1150
+ if (error instanceof GroupServerError)
1151
+ throw error;
1152
+ return rejectBadRequest('Actions are malformed');
1153
+ }
1154
+ if (change.groupId !== undefined) {
1155
+ rejectBadRequest('Client must not set Actions.groupId');
1156
+ }
1157
+ if (change.revision !== stored.state.version + 1) {
1158
+ rejectConflict(`Actions revision ${change.revision} does not follow ${stored.state.version}`);
1159
+ }
1160
+ verifyChangeProfileKeyPresentations(stored.state, change, this.serverSecretParams, Math.floor(operationTime / 1000));
1161
+ requirePniAciBinding(change, requester);
1162
+ const sourceUserId = sourceUserIdForChange(stored.state, change, requester);
1163
+ // All authorization facts are evaluated against the unchanged pre-state.
1164
+ authorizeEncryptedChange(stored.state, change, sourceUserId, requester);
1165
+ requireInviteLinkPassword(stored.state, change, requester, inviteLinkPassword);
1166
+ const acceptedChange = canonicalizeAcceptedChange(stored.state, change, sourceUserId, groupId, operationTime);
1167
+ assertRecognizedActionShape(acceptedChange, 'canonical');
1168
+ const nextState = applyEncryptedChange(stored.state, acceptedChange);
1169
+ assertEncryptedStateStructure(nextState);
1170
+ const acceptedActions = serializeEncryptedGroupChange(acceptedChange);
1171
+ const changeEpoch = requiredGroupChangeEpoch(acceptedChange);
1172
+ const signature = serverSign(this.serverSecretParams, this.runtime.randomBytes(32), serializeGroupChangeCommitment(changeEpoch, acceptedActions));
1173
+ const entry = {
1174
+ version: acceptedChange.revision,
1175
+ actions: acceptedActions,
1176
+ serverSignature: signature,
1177
+ changeEpoch,
1178
+ timestamp: operationTime,
1179
+ };
1180
+ stored.state = nextState;
1181
+ stored.snapshots.set(nextState.version, this.createStoredSnapshot(groupId, nextState));
1182
+ stored.changes.push(structuredClone(entry));
1183
+ return structuredClone(entry);
1184
+ }
1185
+ }
1186
+ //# sourceMappingURL=server-engine.js.map