@open-e2ee/signal-protocol-sdk 8.2.0 → 9.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (311) hide show
  1. package/ADAPTERS.md +15 -31
  2. package/ARCHITECTURE.md +5 -7
  3. package/CHANGELOG.md +128 -0
  4. package/README.md +52 -49
  5. package/SECURITY.md +2 -2
  6. package/client/README.md +11 -0
  7. package/dist/client/client.d.ts +21 -14
  8. package/dist/client/client.d.ts.map +1 -1
  9. package/dist/client/client.js +93 -78
  10. package/dist/client/client.js.map +1 -1
  11. package/dist/client/config.d.ts +10 -17
  12. package/dist/client/config.d.ts.map +1 -1
  13. package/dist/client/config.js.map +1 -1
  14. package/dist/client/event-hooks.js +27 -0
  15. package/dist/client/event-hooks.js.map +1 -1
  16. package/dist/client/group-receive-authorization.d.ts +5 -0
  17. package/dist/client/group-receive-authorization.d.ts.map +1 -0
  18. package/dist/client/group-receive-authorization.js +32 -0
  19. package/dist/client/group-receive-authorization.js.map +1 -0
  20. package/dist/client/group-sender-key-operations.d.ts +15 -0
  21. package/dist/client/group-sender-key-operations.d.ts.map +1 -0
  22. package/dist/client/group-sender-key-operations.js +31 -0
  23. package/dist/client/group-sender-key-operations.js.map +1 -0
  24. package/dist/client/groups.d.ts +3 -1
  25. package/dist/client/groups.d.ts.map +1 -1
  26. package/dist/client/groups.js +5 -2
  27. package/dist/client/groups.js.map +1 -1
  28. package/dist/client/hosted-sandbox-identity.d.ts +32 -0
  29. package/dist/client/hosted-sandbox-identity.d.ts.map +1 -0
  30. package/dist/client/hosted-sandbox-identity.js +157 -0
  31. package/dist/client/hosted-sandbox-identity.js.map +1 -0
  32. package/dist/client/hosted.d.ts +12 -2
  33. package/dist/client/hosted.d.ts.map +1 -1
  34. package/dist/client/hosted.js +12 -2
  35. package/dist/client/hosted.js.map +1 -1
  36. package/dist/client/index.d.ts +1 -1
  37. package/dist/client/index.d.ts.map +1 -1
  38. package/dist/client/index.js +1 -1
  39. package/dist/client/index.js.map +1 -1
  40. package/dist/client/relay-subscription.d.ts +2 -0
  41. package/dist/client/relay-subscription.d.ts.map +1 -1
  42. package/dist/client/relay-subscription.js +3 -1
  43. package/dist/client/relay-subscription.js.map +1 -1
  44. package/dist/client/sender-key-distribution.d.ts.map +1 -1
  45. package/dist/client/sender-key-distribution.js +4 -1
  46. package/dist/client/sender-key-distribution.js.map +1 -1
  47. package/dist/client/signal-service-cipher.d.ts +4 -2
  48. package/dist/client/signal-service-cipher.d.ts.map +1 -1
  49. package/dist/client/signal-service-cipher.js +61 -51
  50. package/dist/client/signal-service-cipher.js.map +1 -1
  51. package/dist/client/types.d.ts +0 -3
  52. package/dist/client/types.d.ts.map +1 -1
  53. package/dist/client/types.js.map +1 -1
  54. package/dist/index.d.ts +28 -22
  55. package/dist/index.d.ts.map +1 -1
  56. package/dist/index.js +9 -18
  57. package/dist/index.js.map +1 -1
  58. package/dist/internal/crypto/pq/kyber.d.ts +1 -1
  59. package/dist/internal/crypto/pq/kyber.js +1 -1
  60. package/dist/internal/encoding/proto/sender-key-message.d.ts +2 -2
  61. package/dist/internal/encoding/proto/sender-key-message.d.ts.map +1 -1
  62. package/dist/internal/encoding/proto/sender-key-message.js +5 -2
  63. package/dist/internal/encoding/proto/sender-key-message.js.map +1 -1
  64. package/dist/internal/groups/manager.d.ts.map +1 -1
  65. package/dist/internal/groups/manager.js +5 -2
  66. package/dist/internal/groups/manager.js.map +1 -1
  67. package/dist/internal/groups/wire.d.ts +0 -2
  68. package/dist/internal/groups/wire.d.ts.map +1 -1
  69. package/dist/internal/groups/wire.js +0 -6
  70. package/dist/internal/groups/wire.js.map +1 -1
  71. package/dist/internal/manager/manager.d.ts.map +1 -1
  72. package/dist/internal/manager/manager.js +0 -1
  73. package/dist/internal/manager/manager.js.map +1 -1
  74. package/dist/internal/protocol/double-ratchet/ratchet.d.ts +0 -17
  75. package/dist/internal/protocol/double-ratchet/ratchet.d.ts.map +1 -1
  76. package/dist/internal/protocol/double-ratchet/ratchet.js +0 -4
  77. package/dist/internal/protocol/double-ratchet/ratchet.js.map +1 -1
  78. package/dist/internal/protocol/sealed-sender/certificate.d.ts +2 -32
  79. package/dist/internal/protocol/sealed-sender/certificate.d.ts.map +1 -1
  80. package/dist/internal/protocol/sealed-sender/certificate.js +4 -85
  81. package/dist/internal/protocol/sealed-sender/certificate.js.map +1 -1
  82. package/dist/internal/protocol/sealed-sender/index.d.ts +2 -2
  83. package/dist/internal/protocol/sealed-sender/index.d.ts.map +1 -1
  84. package/dist/internal/protocol/sealed-sender/index.js +2 -6
  85. package/dist/internal/protocol/sealed-sender/index.js.map +1 -1
  86. package/dist/internal/protocol/sealed-sender/proto/index.d.ts +0 -19
  87. package/dist/internal/protocol/sealed-sender/proto/index.d.ts.map +1 -1
  88. package/dist/internal/protocol/sealed-sender/proto/index.js +1 -48
  89. package/dist/internal/protocol/sealed-sender/proto/index.js.map +1 -1
  90. package/dist/internal/protocol/sender-keys/manager.d.ts +9 -13
  91. package/dist/internal/protocol/sender-keys/manager.d.ts.map +1 -1
  92. package/dist/internal/protocol/sender-keys/manager.js +90 -95
  93. package/dist/internal/protocol/sender-keys/manager.js.map +1 -1
  94. package/dist/internal/protocol/spqr/ml-kem-braid/incremental-kem.d.ts +0 -2
  95. package/dist/internal/protocol/spqr/ml-kem-braid/incremental-kem.d.ts.map +1 -1
  96. package/dist/internal/protocol/spqr/ml-kem-braid/incremental-kem.js +4 -12
  97. package/dist/internal/protocol/spqr/ml-kem-braid/incremental-kem.js.map +1 -1
  98. package/dist/internal/protocol/spqr/ml-kem-braid/types.d.ts +1 -0
  99. package/dist/internal/protocol/spqr/ml-kem-braid/types.d.ts.map +1 -1
  100. package/dist/internal/protocol/spqr/spqr.d.ts +1 -1
  101. package/dist/internal/protocol/spqr/spqr.js +1 -1
  102. package/dist/internal/protocol/x3dh/x3dh.d.ts.map +1 -1
  103. package/dist/internal/protocol/x3dh/x3dh.js +1 -1
  104. package/dist/internal/protocol/x3dh/x3dh.js.map +1 -1
  105. package/dist/internal/protocol/zk/credentials/credentials.d.ts +3 -54
  106. package/dist/internal/protocol/zk/credentials/credentials.d.ts.map +1 -1
  107. package/dist/internal/protocol/zk/credentials/credentials.js +4 -91
  108. package/dist/internal/protocol/zk/credentials/credentials.js.map +1 -1
  109. package/dist/internal/protocol/zk/credentials/endorsements.d.ts +3 -64
  110. package/dist/internal/protocol/zk/credentials/endorsements.d.ts.map +1 -1
  111. package/dist/internal/protocol/zk/credentials/endorsements.js +4 -134
  112. package/dist/internal/protocol/zk/credentials/endorsements.js.map +1 -1
  113. package/dist/internal/protocol/zk/credentials/index.d.ts +3 -3
  114. package/dist/internal/protocol/zk/credentials/index.d.ts.map +1 -1
  115. package/dist/internal/protocol/zk/credentials/index.js +3 -3
  116. package/dist/internal/protocol/zk/credentials/index.js.map +1 -1
  117. package/dist/internal/protocol/zk/credentials/issuance.d.ts +3 -26
  118. package/dist/internal/protocol/zk/credentials/issuance.d.ts.map +1 -1
  119. package/dist/internal/protocol/zk/credentials/issuance.js +3 -80
  120. package/dist/internal/protocol/zk/credentials/issuance.js.map +1 -1
  121. package/dist/internal/protocol/zk/credentials/presentation.d.ts +4 -73
  122. package/dist/internal/protocol/zk/credentials/presentation.d.ts.map +1 -1
  123. package/dist/internal/protocol/zk/credentials/presentation.js +4 -152
  124. package/dist/internal/protocol/zk/credentials/presentation.js.map +1 -1
  125. package/dist/internal/protocol/zk/groups/auth-credential.d.ts +1 -61
  126. package/dist/internal/protocol/zk/groups/auth-credential.d.ts.map +1 -1
  127. package/dist/internal/protocol/zk/groups/auth-credential.js +2 -196
  128. package/dist/internal/protocol/zk/groups/auth-credential.js.map +1 -1
  129. package/dist/internal/protocol/zk/groups/group-send-endorsement.d.ts +1 -86
  130. package/dist/internal/protocol/zk/groups/group-send-endorsement.d.ts.map +1 -1
  131. package/dist/internal/protocol/zk/groups/group-send-endorsement.js +1 -152
  132. package/dist/internal/protocol/zk/groups/group-send-endorsement.js.map +1 -1
  133. package/dist/internal/protocol/zk/groups/index.d.ts +4 -4
  134. package/dist/internal/protocol/zk/groups/index.d.ts.map +1 -1
  135. package/dist/internal/protocol/zk/groups/index.js +4 -4
  136. package/dist/internal/protocol/zk/groups/index.js.map +1 -1
  137. package/dist/internal/protocol/zk/groups/profile-key-credential.d.ts +2 -57
  138. package/dist/internal/protocol/zk/groups/profile-key-credential.d.ts.map +1 -1
  139. package/dist/internal/protocol/zk/groups/profile-key-credential.js +2 -174
  140. package/dist/internal/protocol/zk/groups/profile-key-credential.js.map +1 -1
  141. package/dist/internal/protocol/zk/groups/server-params.d.ts +8 -72
  142. package/dist/internal/protocol/zk/groups/server-params.d.ts.map +1 -1
  143. package/dist/internal/protocol/zk/groups/server-params.js +8 -108
  144. package/dist/internal/protocol/zk/groups/server-params.js.map +1 -1
  145. package/dist/internal/protocol/zk/proofs/sign.d.ts +1 -2
  146. package/dist/internal/protocol/zk/proofs/sign.d.ts.map +1 -1
  147. package/dist/internal/protocol/zk/proofs/sign.js +2 -11
  148. package/dist/internal/protocol/zk/proofs/sign.js.map +1 -1
  149. package/dist/internal/session/ratchet.d.ts.map +1 -1
  150. package/dist/internal/session/ratchet.js +0 -2
  151. package/dist/internal/session/ratchet.js.map +1 -1
  152. package/dist/local/store/key-value/adapter.d.ts +3 -3
  153. package/dist/local/store/key-value/adapter.d.ts.map +1 -1
  154. package/dist/local/store/key-value/adapter.js +30 -15
  155. package/dist/local/store/key-value/adapter.js.map +1 -1
  156. package/dist/local/store/key-value/backend-conformance.d.ts.map +1 -1
  157. package/dist/local/store/key-value/backend-conformance.js +25 -0
  158. package/dist/local/store/key-value/backend-conformance.js.map +1 -1
  159. package/dist/local/store/key-value/batch.d.ts +3 -1
  160. package/dist/local/store/key-value/batch.d.ts.map +1 -1
  161. package/dist/local/store/key-value/batch.js +9 -1
  162. package/dist/local/store/key-value/batch.js.map +1 -1
  163. package/dist/local/store/key-value/storage.d.ts +6 -0
  164. package/dist/local/store/key-value/storage.d.ts.map +1 -1
  165. package/dist/local/store/key-value/transactional-backend.d.ts +1 -1
  166. package/dist/local/store/key-value/transactional-backend.js +1 -1
  167. package/dist/local/store/memory/adapter.d.ts +3 -3
  168. package/dist/local/store/memory/adapter.d.ts.map +1 -1
  169. package/dist/local/store/memory/adapter.js +43 -18
  170. package/dist/local/store/memory/adapter.js.map +1 -1
  171. package/dist/local/store/sqlite/errors.d.ts +6 -0
  172. package/dist/local/store/sqlite/errors.d.ts.map +1 -1
  173. package/dist/local/store/sqlite/errors.js +6 -6
  174. package/dist/local/store/sqlite/errors.js.map +1 -1
  175. package/dist/local/store/sqlite/migrations.d.ts.map +1 -1
  176. package/dist/local/store/sqlite/migrations.js +18 -0
  177. package/dist/local/store/sqlite/migrations.js.map +1 -1
  178. package/dist/local/store/sqlite/models/skipped-sender-key.d.ts +3 -3
  179. package/dist/local/store/sqlite/models/skipped-sender-key.d.ts.map +1 -1
  180. package/dist/local/store/sqlite/models/skipped-sender-key.js +13 -17
  181. package/dist/local/store/sqlite/models/skipped-sender-key.js.map +1 -1
  182. package/dist/local/store/sqlite/store.d.ts +3 -3
  183. package/dist/local/store/sqlite/store.d.ts.map +1 -1
  184. package/dist/local/store/sqlite/store.js +17 -9
  185. package/dist/local/store/sqlite/store.js.map +1 -1
  186. package/dist/local/store/web/adapter.d.ts +3 -3
  187. package/dist/local/store/web/adapter.d.ts.map +1 -1
  188. package/dist/local/store/web/adapter.js +59 -20
  189. package/dist/local/store/web/adapter.js.map +1 -1
  190. package/dist/profile/contact-state.d.ts +0 -3
  191. package/dist/profile/contact-state.d.ts.map +1 -1
  192. package/dist/profile/contact-state.js +1 -32
  193. package/dist/profile/contact-state.js.map +1 -1
  194. package/dist/profile/index.d.ts +2 -1
  195. package/dist/profile/index.d.ts.map +1 -1
  196. package/dist/profile/index.js +2 -1
  197. package/dist/profile/index.js.map +1 -1
  198. package/dist/profile/unidentified-access.d.ts +12 -0
  199. package/dist/profile/unidentified-access.d.ts.map +1 -0
  200. package/dist/profile/unidentified-access.js +42 -0
  201. package/dist/profile/unidentified-access.js.map +1 -0
  202. package/dist/remote/relay/index.d.ts +4 -7
  203. package/dist/remote/relay/index.d.ts.map +1 -1
  204. package/dist/remote/relay/index.js +5 -7
  205. package/dist/remote/relay/index.js.map +1 -1
  206. package/dist/remote/relay/types.d.ts +3 -3
  207. package/dist/types/api.d.ts +29 -8
  208. package/dist/types/api.d.ts.map +1 -1
  209. package/dist/types/errors.d.ts +6 -0
  210. package/dist/types/errors.d.ts.map +1 -1
  211. package/dist/types/errors.js +6 -6
  212. package/dist/types/errors.js.map +1 -1
  213. package/dist/versions.d.ts +3 -3
  214. package/dist/versions.js +3 -3
  215. package/dist/zk/credentials.d.ts +2 -2
  216. package/dist/zk/credentials.js +2 -2
  217. package/dist/zk/groups.d.ts +3 -3
  218. package/dist/zk/groups.d.ts.map +1 -1
  219. package/dist/zk/groups.js +3 -3
  220. package/dist/zk/groups.js.map +1 -1
  221. package/docs/ASSURANCE.md +12 -14
  222. package/docs/CLIENT_COMPOSITION.md +11 -3
  223. package/docs/DEVIATIONS.md +24 -25
  224. package/docs/GETTING_STARTED.md +61 -323
  225. package/docs/INTERFACES.md +7 -7
  226. package/docs/PACKAGE_SURFACE.md +14 -16
  227. package/docs/RECIPES.md +7 -112
  228. package/groups/README.md +9 -1
  229. package/local/store/README.md +26 -6
  230. package/package.json +2 -31
  231. package/remote/README.md +14 -78
  232. package/remote/object-store/convex-r2/README.md +17 -49
  233. package/remote/relay/README.md +24 -18
  234. package/zk/README.md +6 -7
  235. package/dist/client/dual-store.d.ts +0 -70
  236. package/dist/client/dual-store.d.ts.map +0 -1
  237. package/dist/client/dual-store.js +0 -123
  238. package/dist/client/dual-store.js.map +0 -1
  239. package/dist/client/multi-device.d.ts +0 -74
  240. package/dist/client/multi-device.d.ts.map +0 -1
  241. package/dist/client/multi-device.js +0 -105
  242. package/dist/client/multi-device.js.map +0 -1
  243. package/dist/groups/server.d.ts +0 -10
  244. package/dist/groups/server.d.ts.map +0 -1
  245. package/dist/groups/server.js +0 -6
  246. package/dist/groups/server.js.map +0 -1
  247. package/dist/internal/encoding/index.d.ts +0 -2
  248. package/dist/internal/encoding/index.d.ts.map +0 -1
  249. package/dist/internal/encoding/index.js +0 -2
  250. package/dist/internal/encoding/index.js.map +0 -1
  251. package/dist/internal/groups/server-engine.d.ts +0 -118
  252. package/dist/internal/groups/server-engine.d.ts.map +0 -1
  253. package/dist/internal/groups/server-engine.js +0 -1268
  254. package/dist/internal/groups/server-engine.js.map +0 -1
  255. package/dist/internal/protocol/index.d.ts +0 -24
  256. package/dist/internal/protocol/index.d.ts.map +0 -1
  257. package/dist/internal/protocol/index.js +0 -9
  258. package/dist/internal/protocol/index.js.map +0 -1
  259. package/dist/internal/protocol/sealed-sender/trust-root.d.ts +0 -56
  260. package/dist/internal/protocol/sealed-sender/trust-root.d.ts.map +0 -1
  261. package/dist/internal/protocol/sealed-sender/trust-root.js +0 -90
  262. package/dist/internal/protocol/sealed-sender/trust-root.js.map +0 -1
  263. package/dist/internal/protocol/triple-ratchet/index.d.ts +0 -21
  264. package/dist/internal/protocol/triple-ratchet/index.d.ts.map +0 -1
  265. package/dist/internal/protocol/triple-ratchet/index.js +0 -19
  266. package/dist/internal/protocol/triple-ratchet/index.js.map +0 -1
  267. package/dist/internal/protocol/triple-ratchet/ratchet.d.ts +0 -233
  268. package/dist/internal/protocol/triple-ratchet/ratchet.d.ts.map +0 -1
  269. package/dist/internal/protocol/triple-ratchet/ratchet.js +0 -254
  270. package/dist/internal/protocol/triple-ratchet/ratchet.js.map +0 -1
  271. package/dist/internal/protocol/zk/proofs/index.d.ts +0 -13
  272. package/dist/internal/protocol/zk/proofs/index.d.ts.map +0 -1
  273. package/dist/internal/protocol/zk/proofs/index.js +0 -7
  274. package/dist/internal/protocol/zk/proofs/index.js.map +0 -1
  275. package/dist/local/store/sqlite/index.d.ts +0 -20
  276. package/dist/local/store/sqlite/index.d.ts.map +0 -1
  277. package/dist/local/store/sqlite/index.js +0 -18
  278. package/dist/local/store/sqlite/index.js.map +0 -1
  279. package/dist/remote/object-store/convex-r2/server/index.d.ts +0 -2
  280. package/dist/remote/object-store/convex-r2/server/index.d.ts.map +0 -1
  281. package/dist/remote/object-store/convex-r2/server/index.js +0 -2
  282. package/dist/remote/object-store/convex-r2/server/index.js.map +0 -1
  283. package/dist/remote/object-store/convex-r2/server.d.ts +0 -129
  284. package/dist/remote/object-store/convex-r2/server.d.ts.map +0 -1
  285. package/dist/remote/object-store/convex-r2/server.js +0 -244
  286. package/dist/remote/object-store/convex-r2/server.js.map +0 -1
  287. package/dist/remote/relay/memory/adapter.d.ts +0 -252
  288. package/dist/remote/relay/memory/adapter.d.ts.map +0 -1
  289. package/dist/remote/relay/memory/adapter.js +0 -1057
  290. package/dist/remote/relay/memory/adapter.js.map +0 -1
  291. package/dist/remote/relay/memory/failures.d.ts +0 -58
  292. package/dist/remote/relay/memory/failures.d.ts.map +0 -1
  293. package/dist/remote/relay/memory/failures.js +0 -124
  294. package/dist/remote/relay/memory/failures.js.map +0 -1
  295. package/dist/remote/relay/memory/group-server.d.ts +0 -13
  296. package/dist/remote/relay/memory/group-server.d.ts.map +0 -1
  297. package/dist/remote/relay/memory/group-server.js +0 -19
  298. package/dist/remote/relay/memory/group-server.js.map +0 -1
  299. package/dist/remote/relay/memory/index.d.ts +0 -11
  300. package/dist/remote/relay/memory/index.d.ts.map +0 -1
  301. package/dist/remote/relay/memory/index.js +0 -7
  302. package/dist/remote/relay/memory/index.js.map +0 -1
  303. package/examples/browser/README.md +0 -35
  304. package/examples/browser/index.html +0 -27
  305. package/examples/browser/src/exchange.ts +0 -69
  306. package/examples/browser/src/main.ts +0 -63
  307. package/examples/browser/src/style.css +0 -9
  308. package/examples/browser/src/worker.ts +0 -10
  309. package/examples/browser/vite.config.ts +0 -9
  310. package/remote/relay/memory/README.md +0 -72
  311. package/scripts/oe-groups.mjs +0 -166
@@ -1,1268 +0,0 @@
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 { cloneProtocolState, 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 { UidEncryptionDomain } from '../protocol/zk/groups/uid-encryption.js';
18
- import { Ciphertext } from '../protocol/zk/credentials/attributes.js';
19
- import { defaultExpiration, deriveForExpiration, issueEndorsements, serializeEndorsementsResponse } from '../protocol/zk/groups/group-send-endorsement.js';
20
- import { RistrettoPoint } from '../protocol/zk/proofs/sho.js';
21
- import { GroupWireValidationError } from './error-details.js';
22
- const MAX_GROUP_SIZE = 1000;
23
- const INVITE_LINK_PASSWORD_LENGTH = 16;
24
- // One change-log page. The reference paginates this endpoint. Its clients
25
- // carry an explicit paging loop driven by a has-more signal. This limit
26
- // follows that shape, not a verified reference constant, because the group
27
- // server's page size is not visible from the client sources. 64 sits well
28
- // above any realistic burst of unsynced changes and well below a request
29
- // that carries a group's whole history. Exported so a storage-backed
30
- // transport can bound its restore at one page plus the single look-ahead
31
- // entry that decides `hasMore`.
32
- export const GROUP_CHANGE_LOG_PAGE_LIMIT = 64;
33
- class GroupServerError extends Error {
34
- data;
35
- constructor(code, status, message, reason, detail) {
36
- super(`${code}: ${message}`);
37
- this.name = 'GroupServerError';
38
- this.data = reason === undefined ? { code, status } : { code, status, reason };
39
- if (detail !== undefined)
40
- this.data.detail = detail;
41
- }
42
- }
43
- function rejectBadRequest(message, detail) {
44
- throw new GroupServerError('INVALID_REQUEST', 400, message, undefined, detail);
45
- }
46
- function rejectUnauthorized(message) {
47
- throw new GroupServerError('UNAUTHORIZED', 403, message);
48
- }
49
- function rejectForbidden(message, reason, detail) {
50
- throw new GroupServerError('FORBIDDEN', 403, message, reason, detail);
51
- }
52
- function rejectConflict(message) {
53
- throw new GroupServerError('VERSION_CONFLICT', 409, message);
54
- }
55
- function equal(a, b) {
56
- return constantTimeEqual(a, b);
57
- }
58
- function requireCiphertextEncoding(value, label, kind) {
59
- if (!(value instanceof Uint8Array) || value.length !== 65) {
60
- rejectBadRequest(`${label} must be a 65-byte ciphertext`);
61
- }
62
- if (kind === 'aci' && value[0] !== SERVICE_ID_ACI) {
63
- rejectBadRequest(`${label} must carry an ACI ciphertext`, 'invalid_ciphertext_kind');
64
- }
65
- if (kind === 'service-id' &&
66
- value[0] !== SERVICE_ID_ACI &&
67
- value[0] !== SERVICE_ID_PNI) {
68
- rejectBadRequest(`${label} must carry an ACI or PNI ciphertext`);
69
- }
70
- if (kind === 'profile-key' && value[0] !== 0) {
71
- rejectBadRequest(`${label} has an invalid reserved byte`);
72
- }
73
- try {
74
- RistrettoPoint.fromBytes(value.slice(1, 33));
75
- RistrettoPoint.fromBytes(value.slice(33, 65));
76
- }
77
- catch {
78
- rejectBadRequest(`${label} contains an invalid Ristretto ciphertext point`, 'invalid_ciphertext_point');
79
- }
80
- }
81
- function requireBlobEncoding(value, label, allowEmpty = true) {
82
- if (!(value instanceof Uint8Array)) {
83
- rejectBadRequest(`${label} must be ciphertext bytes`);
84
- }
85
- if (allowEmpty && value.length === 0)
86
- return;
87
- if (value.length < 65 ||
88
- (value.length - 65) % 32 !== 0 ||
89
- value[value.length - 1] !== 0) {
90
- rejectBadRequest(`${label} has an invalid encrypted-blob envelope`, 'invalid_encrypted_blob');
91
- }
92
- }
93
- function serializePresentationCiphertext(kind, ciphertext) {
94
- const result = new Uint8Array(65);
95
- result[0] = kind;
96
- result.set(ciphertext.E_A1.toBytes(), 1);
97
- result.set(ciphertext.E_A2.toBytes(), 33);
98
- return result;
99
- }
100
- function serializeProfileKeyPresentationCiphertext(ciphertext) {
101
- const result = new Uint8Array(65);
102
- result[0] = 0;
103
- result.set(ciphertext.E_A1.toBytes(), 1);
104
- result.set(ciphertext.E_A2.toBytes(), 33);
105
- return result;
106
- }
107
- function verifyProfileKeyPresentation(serverSecretParams, groupPublicParams, aciCiphertext, profileKeyCiphertext, presentationBytes, nowSeconds) {
108
- if (presentationBytes.length === 0) {
109
- rejectForbidden('Profile-key credential presentation is required', undefined, 'profile_presentation_required');
110
- }
111
- try {
112
- const presentation = deserializeProfileKeyCredentialPresentation(presentationBytes);
113
- verifyProfileKeyCredentialPresentation(serverSecretParams.profileKeyCredentialKeyPair, groupPublicParams, presentation, nowSeconds);
114
- if (!equal(aciCiphertext, serializePresentationCiphertext(SERVICE_ID_ACI, presentation.uidEncCiphertext)) ||
115
- !equal(profileKeyCiphertext, serializeProfileKeyPresentationCiphertext(presentation.profileKeyEncCiphertext))) {
116
- rejectForbidden('Profile-key presentation does not bind the submitted member', undefined, 'profile_presentation_binding');
117
- }
118
- }
119
- catch (error) {
120
- if (error instanceof GroupServerError)
121
- throw error;
122
- rejectForbidden('Profile-key credential presentation verification failed');
123
- }
124
- }
125
- function stripStateProfileKeyPresentations(state) {
126
- const stripped = cloneProtocolState(state);
127
- for (const member of stripped.members) {
128
- member.presentation = new Uint8Array(0);
129
- }
130
- for (const member of stripped.membersPendingAdminApproval) {
131
- member.presentation = new Uint8Array(0);
132
- }
133
- return stripped;
134
- }
135
- function stripChangeProfileKeyPresentations(change) {
136
- const stripped = cloneProtocolState(change);
137
- for (const members of [
138
- stripped.newMembers,
139
- stripped.modifiedProfileKeys,
140
- stripped.promotePendingMembers,
141
- stripped.promotePendingPniAciMembers,
142
- ]) {
143
- for (const member of members) {
144
- member.presentation = new Uint8Array(0);
145
- }
146
- }
147
- for (const member of stripped.newRequestingMembers) {
148
- member.presentation = new Uint8Array(0);
149
- }
150
- return stripped;
151
- }
152
- function verifyStateProfileKeyPresentations(state, serverSecretParams, nowSeconds) {
153
- const groupPublicParams = deserializeGroupPublicParams(state.publicKey);
154
- for (const member of state.members) {
155
- verifyProfileKeyPresentation(serverSecretParams, groupPublicParams, member.userId, member.profileKey, member.presentation, nowSeconds);
156
- }
157
- for (const member of state.membersPendingAdminApproval) {
158
- verifyProfileKeyPresentation(serverSecretParams, groupPublicParams, member.userId, member.profileKey, member.presentation, nowSeconds);
159
- }
160
- }
161
- function verifyChangeProfileKeyPresentations(state, change, serverSecretParams, nowSeconds) {
162
- const groupPublicParams = deserializeGroupPublicParams(state.publicKey);
163
- const members = [
164
- ...change.newMembers,
165
- ...change.modifiedProfileKeys,
166
- ...change.promotePendingMembers,
167
- ...change.promotePendingPniAciMembers,
168
- ];
169
- for (const member of members) {
170
- verifyProfileKeyPresentation(serverSecretParams, groupPublicParams, member.aciCiphertext, member.profileKeyCiphertext, member.presentation, nowSeconds);
171
- }
172
- for (const member of change.newRequestingMembers) {
173
- verifyProfileKeyPresentation(serverSecretParams, groupPublicParams, member.aciCiphertext, member.profileKeyCiphertext, member.presentation, nowSeconds);
174
- }
175
- }
176
- function memberFromAction(action, role, joinedAtVersion) {
177
- return {
178
- userId: action.aciCiphertext,
179
- role,
180
- profileKey: action.profileKeyCiphertext,
181
- presentation: action.presentation,
182
- joinedAtVersion,
183
- labelEmoji: new Uint8Array(0),
184
- labelString: new Uint8Array(0),
185
- };
186
- }
187
- function validTimestamp(value) {
188
- return Number.isSafeInteger(value) && value >= 0;
189
- }
190
- function assertRecognizedActionShape(change, form) {
191
- try {
192
- assertValidEncryptedGroupChangeWire(change, form);
193
- assertRecognizedEncryptedGroupChange(change);
194
- assertEncryptedGroupChangeForm(change, form);
195
- }
196
- catch (error) {
197
- rejectBadRequest(error instanceof Error ? error.message : 'Actions are malformed', error instanceof GroupWireValidationError ? error.detail : undefined);
198
- }
199
- if (!Number.isSafeInteger(change.revision) || change.revision < 1) {
200
- rejectBadRequest('Actions revision must be a positive safe integer');
201
- }
202
- if (change.terminate !== undefined && change.terminate !== true) {
203
- rejectBadRequest('Termination action must be true');
204
- }
205
- const requireProfileKeyAction = (member, label) => {
206
- requireCiphertextEncoding(member.aciCiphertext, `${label}.aciCiphertext`, 'aci');
207
- requireCiphertextEncoding(member.profileKeyCiphertext, `${label}.profileKeyCiphertext`, 'profile-key');
208
- if (!(member.presentation instanceof Uint8Array)) {
209
- rejectBadRequest(`${label}.presentation must be bytes`);
210
- }
211
- };
212
- for (const [index, member] of change.newMembers.entries()) {
213
- requireProfileKeyAction(member, `Actions.newMembers[${index}]`);
214
- if (!isStoredMemberRole(member.role)) {
215
- rejectBadRequest(`Actions.newMembers[${index}].role is invalid`);
216
- }
217
- if (form === 'canonical' && member.joinedAtRevision !== change.revision) {
218
- rejectBadRequest(`Actions.newMembers[${index}].joinedAtRevision must equal the change revision`);
219
- }
220
- }
221
- for (const [index, member] of change.modifiedProfileKeys.entries()) {
222
- requireProfileKeyAction(member, `Actions.modifiedProfileKeys[${index}]`);
223
- }
224
- for (const [index, member] of change.promotePendingMembers.entries()) {
225
- requireProfileKeyAction(member, `Actions.promotePendingMembers[${index}]`);
226
- if (form === 'canonical' &&
227
- (!isStoredMemberRole(member.role) ||
228
- member.joinedAtRevision !== change.revision)) {
229
- rejectBadRequest(`Actions.promotePendingMembers[${index}] has invalid derived role or joinedAtRevision`);
230
- }
231
- }
232
- for (const [index, member] of change.promotePendingPniAciMembers.entries()) {
233
- requireProfileKeyAction(member, `Actions.promotePendingPniAciMembers[${index}]`);
234
- if (form === 'canonical' &&
235
- (!isStoredMemberRole(member.role) ||
236
- member.joinedAtRevision !== change.revision)) {
237
- rejectBadRequest(`Actions.promotePendingPniAciMembers[${index}] has invalid derived role or joinedAtRevision`);
238
- }
239
- if (member.pniCiphertext.length !== 65) {
240
- rejectBadRequest(`Actions.promotePendingPniAciMembers[${index}].pniCiphertext is required`);
241
- }
242
- }
243
- for (const [index, ciphertext] of change.deleteMembers.entries()) {
244
- requireCiphertextEncoding(ciphertext, `Actions.deleteMembers[${index}]`, 'aci');
245
- }
246
- for (const [index, member] of change.modifyMemberRoles.entries()) {
247
- requireCiphertextEncoding(member.aciCiphertext, `Actions.modifyMemberRoles[${index}].aciCiphertext`, 'aci');
248
- if (!isStoredMemberRole(member.role)) {
249
- rejectBadRequest(`Actions.modifyMemberRoles[${index}].role is invalid`);
250
- }
251
- }
252
- for (const [index, member] of change.modifyMemberLabels.entries()) {
253
- requireCiphertextEncoding(member.aciCiphertext, `Actions.modifyMemberLabels[${index}].aciCiphertext`, 'aci');
254
- requireBlobEncoding(member.labelEmojiCiphertext, `Actions.modifyMemberLabels[${index}].labelEmojiCiphertext`);
255
- requireBlobEncoding(member.labelStringCiphertext, `Actions.modifyMemberLabels[${index}].labelStringCiphertext`);
256
- }
257
- for (const [index, member] of change.newPendingMembers.entries()) {
258
- requireCiphertextEncoding(member.serviceIdCiphertext, `Actions.newPendingMembers[${index}].serviceIdCiphertext`, 'service-id');
259
- if (!isStoredMemberRole(member.role)) {
260
- rejectBadRequest(`Actions.newPendingMembers[${index}].role is invalid`);
261
- }
262
- if (form === 'canonical') {
263
- requireCiphertextEncoding(member.addedByAciCiphertext, `Actions.newPendingMembers[${index}].addedByAciCiphertext`, 'aci');
264
- if (!validTimestamp(member.timestamp)) {
265
- rejectBadRequest(`Actions.newPendingMembers[${index}].timestamp is invalid`);
266
- }
267
- }
268
- }
269
- for (const [index, member] of change.deletePendingMembers.entries()) {
270
- requireCiphertextEncoding(member.serviceIdCiphertext, `Actions.deletePendingMembers[${index}].serviceIdCiphertext`, 'service-id');
271
- }
272
- for (const [index, member] of change.newRequestingMembers.entries()) {
273
- requireCiphertextEncoding(member.aciCiphertext, `Actions.newRequestingMembers[${index}].aciCiphertext`, 'aci');
274
- requireCiphertextEncoding(member.profileKeyCiphertext, `Actions.newRequestingMembers[${index}].profileKeyCiphertext`, 'profile-key');
275
- if (!(member.presentation instanceof Uint8Array)) {
276
- rejectBadRequest(`Actions.newRequestingMembers[${index}].presentation must be bytes`);
277
- }
278
- if (form === 'canonical' && !validTimestamp(member.timestamp)) {
279
- rejectBadRequest(`Actions.newRequestingMembers[${index}].timestamp is invalid`);
280
- }
281
- }
282
- for (const [index, ciphertext] of change.deleteRequestingMembers.entries()) {
283
- requireCiphertextEncoding(ciphertext, `Actions.deleteRequestingMembers[${index}]`, 'aci');
284
- }
285
- for (const [index, member] of change.promoteRequestingMembers.entries()) {
286
- requireCiphertextEncoding(member.aciCiphertext, `Actions.promoteRequestingMembers[${index}].aciCiphertext`, 'aci');
287
- if (!isStoredMemberRole(member.role)) {
288
- rejectBadRequest(`Actions.promoteRequestingMembers[${index}].role is invalid`);
289
- }
290
- }
291
- for (const [index, member] of change.newBannedMembers.entries()) {
292
- requireCiphertextEncoding(member.serviceIdCiphertext, `Actions.newBannedMembers[${index}].serviceIdCiphertext`, 'service-id');
293
- if (form === 'canonical' && !validTimestamp(member.timestamp)) {
294
- rejectBadRequest(`Actions.newBannedMembers[${index}].timestamp is invalid`);
295
- }
296
- }
297
- for (const [index, member] of change.deleteBannedMembers.entries()) {
298
- requireCiphertextEncoding(member.serviceIdCiphertext, `Actions.deleteBannedMembers[${index}].serviceIdCiphertext`, 'service-id');
299
- }
300
- for (const [value, label] of [
301
- [change.newTitle, 'Actions.newTitle'],
302
- [change.newTimer, 'Actions.newTimer'],
303
- [change.newDescription, 'Actions.newDescription'],
304
- ]) {
305
- if (value !== undefined) {
306
- requireBlobEncoding(value, label, false);
307
- }
308
- }
309
- if (change.newAvatar !== undefined &&
310
- (typeof change.newAvatar !== 'object' ||
311
- change.newAvatar === null ||
312
- typeof change.newAvatar.value !== 'string')) {
313
- rejectBadRequest('Actions.newAvatar must carry a string value');
314
- }
315
- for (const [value, label] of [
316
- [change.newAttributeAccess, 'Actions.newAttributeAccess'],
317
- [change.newMemberAccess, 'Actions.newMemberAccess'],
318
- [change.newMemberLabelAccess, 'Actions.newMemberLabelAccess'],
319
- ]) {
320
- if (value !== undefined && !isRoleAccessRequirement(value)) {
321
- rejectBadRequest(`${label} is outside its §6.7 domain`);
322
- }
323
- }
324
- if (change.newInviteLinkAccess !== undefined &&
325
- !isInviteLinkAccessRequirement(change.newInviteLinkAccess)) {
326
- rejectBadRequest('Actions.newInviteLinkAccess is outside its §6.7 domain');
327
- }
328
- if (change.newIsAnnouncementGroup !== undefined &&
329
- change.newIsAnnouncementGroup !== EnabledState.ENABLED &&
330
- change.newIsAnnouncementGroup !== EnabledState.DISABLED) {
331
- rejectBadRequest('Actions.newIsAnnouncementGroup is invalid');
332
- }
333
- const { newInviteLinkPassword } = change;
334
- if (newInviteLinkPassword !== undefined &&
335
- (!(newInviteLinkPassword instanceof Uint8Array) ||
336
- newInviteLinkPassword.length !== 16)) {
337
- rejectBadRequest('Actions.newInviteLinkPassword must be 16 bytes');
338
- }
339
- }
340
- function assertEncryptedStateStructure(state) {
341
- try {
342
- assertValidEncryptedGroupWire(state);
343
- }
344
- catch (error) {
345
- rejectBadRequest(error instanceof Error ? error.message : 'Encrypted group state is malformed', error instanceof GroupWireValidationError ? error.detail : undefined);
346
- }
347
- if (!Number.isSafeInteger(state.version) || state.version < 0) {
348
- rejectBadRequest('Group version must be a non-negative safe integer');
349
- }
350
- if (!Array.isArray(state.members) ||
351
- !Array.isArray(state.membersPendingProfileKey) ||
352
- !Array.isArray(state.membersPendingAdminApproval) ||
353
- !Array.isArray(state.membersBanned)) {
354
- rejectBadRequest('Group membership fields must be arrays');
355
- }
356
- if (state.members.length > MAX_GROUP_SIZE) {
357
- rejectBadRequest(`Group exceeds the ${MAX_GROUP_SIZE}-member limit`);
358
- }
359
- if (state.membersPendingProfileKey.length > MAX_GROUP_SIZE) {
360
- rejectBadRequest(`Group exceeds the ${MAX_GROUP_SIZE}-pending-member limit`);
361
- }
362
- if (state.membersPendingAdminApproval.length > MAX_GROUP_SIZE) {
363
- rejectBadRequest(`Group exceeds the ${MAX_GROUP_SIZE}-requesting-member limit`);
364
- }
365
- if (state.membersBanned.length > MAX_GROUP_SIZE) {
366
- rejectBadRequest(`Group exceeds the ${MAX_GROUP_SIZE}-banned-member limit`);
367
- }
368
- if (!(state.publicKey instanceof Uint8Array) ||
369
- !(state.title instanceof Uint8Array) ||
370
- !(state.description instanceof Uint8Array) ||
371
- !(state.disappearingMessagesTimer instanceof Uint8Array) ||
372
- !(state.inviteLinkPassword instanceof Uint8Array) ||
373
- (state.inviteLinkPassword.length !== 0 &&
374
- state.inviteLinkPassword.length !== 16) ||
375
- typeof state.avatarUrl !== 'string' ||
376
- typeof state.announcementsOnly !== 'boolean' ||
377
- typeof state.terminated !== 'boolean') {
378
- rejectBadRequest('Group scalar or encrypted attribute fields are malformed');
379
- }
380
- if (!isRoleAccessRequirement(state.accessControl?.attributes) ||
381
- !isRoleAccessRequirement(state.accessControl?.members) ||
382
- !isRoleAccessRequirement(state.accessControl?.memberLabel) ||
383
- !isInviteLinkAccessRequirement(state.accessControl?.addFromInviteLink)) {
384
- rejectBadRequest('Group access control is invalid');
385
- }
386
- const occupied = new Set();
387
- const occupy = (ciphertext, label) => {
388
- const key = Array.from(ciphertext, (byte) => byte.toString(16).padStart(2, '0')).join('');
389
- if (occupied.has(key)) {
390
- rejectBadRequest(`Principal appears in multiple group-state entries (${label})`);
391
- }
392
- occupied.add(key);
393
- };
394
- requireBlobEncoding(state.title, 'Group.title');
395
- requireBlobEncoding(state.description, 'Group.description');
396
- requireBlobEncoding(state.disappearingMessagesTimer, 'Group.disappearingMessagesTimer');
397
- for (const member of state.members) {
398
- requireCiphertextEncoding(member.userId, 'members.userId', 'aci');
399
- requireCiphertextEncoding(member.profileKey, 'members.profileKey', 'profile-key');
400
- if (!isStoredMemberRole(member.role) ||
401
- !(member.presentation instanceof Uint8Array) ||
402
- !Number.isSafeInteger(member.joinedAtVersion) ||
403
- member.joinedAtVersion < 0 ||
404
- member.joinedAtVersion > state.version ||
405
- !(member.labelEmoji instanceof Uint8Array) ||
406
- !(member.labelString instanceof Uint8Array)) {
407
- rejectBadRequest('Stored member fields are malformed');
408
- }
409
- requireBlobEncoding(member.labelEmoji, 'members.labelEmoji');
410
- requireBlobEncoding(member.labelString, 'members.labelString');
411
- occupy(member.userId, 'members');
412
- }
413
- for (const pending of state.membersPendingProfileKey) {
414
- requireCiphertextEncoding(pending.member.userId, 'membersPendingProfileKey.userId', 'service-id');
415
- requireCiphertextEncoding(pending.addedByUserId, 'membersPendingProfileKey.addedByUserId', 'aci');
416
- if (!isStoredMemberRole(pending.member.role) ||
417
- !validTimestamp(pending.timestamp) ||
418
- pending.member.profileKey.length !== 0 ||
419
- pending.member.presentation.length !== 0) {
420
- rejectBadRequest('Stored pending-member fields are malformed');
421
- }
422
- occupy(pending.member.userId, 'membersPendingProfileKey');
423
- }
424
- for (const requesting of state.membersPendingAdminApproval) {
425
- requireCiphertextEncoding(requesting.userId, 'membersPendingAdminApproval.userId', 'aci');
426
- requireCiphertextEncoding(requesting.profileKey, 'membersPendingAdminApproval.profileKey', 'profile-key');
427
- if (!(requesting.presentation instanceof Uint8Array) ||
428
- !validTimestamp(requesting.timestamp)) {
429
- rejectBadRequest('Stored requesting-member fields are malformed');
430
- }
431
- occupy(requesting.userId, 'membersPendingAdminApproval');
432
- }
433
- for (const banned of state.membersBanned) {
434
- requireCiphertextEncoding(banned.userId, 'membersBanned.userId', 'service-id');
435
- if (!validTimestamp(banned.timestamp)) {
436
- rejectBadRequest('Stored banned-member timestamp is invalid');
437
- }
438
- occupy(banned.userId, 'membersBanned');
439
- }
440
- }
441
- function assertEncryptedCreationStateStructure(state) {
442
- try {
443
- assertValidEncryptedGroupCreationSubmissionWire(state);
444
- }
445
- catch (error) {
446
- rejectBadRequest(error instanceof Error
447
- ? error.message
448
- : 'Encrypted group creation submission is malformed', error instanceof GroupWireValidationError ? error.detail : undefined);
449
- }
450
- }
451
- function requesterMatches(requester, userId) {
452
- return (equal(userId, requester.aciCiphertext) ||
453
- (requester.pniCiphertext !== undefined &&
454
- equal(userId, requester.pniCiphertext)));
455
- }
456
- function roleForSource(state, sourceUserId) {
457
- return (state.members.find((member) => equal(member.userId, sourceUserId))?.role ??
458
- MemberRole.UNKNOWN);
459
- }
460
- function roleForRequesterAliases(state, requester) {
461
- return (state.members.find((member) => requesterMatches(requester, member.userId))?.role ??
462
- MemberRole.UNKNOWN);
463
- }
464
- function requesterIsBanned(state, requester) {
465
- return state.membersBanned.some((member) => requesterMatches(requester, member.userId));
466
- }
467
- function matchingRequesterIds(state, requester) {
468
- return [
469
- ...state.members.map((member) => member.userId),
470
- ...state.membersPendingProfileKey.map((pending) => pending.member.userId),
471
- ...state.membersPendingAdminApproval.map((pending) => pending.userId),
472
- ].filter((userId) => requesterMatches(requester, userId));
473
- }
474
- function sourceUserIdForChange(state, change, requester) {
475
- const actionNamedRequesterIds = [
476
- ...change.promotePendingPniAciMembers.map((promotion) => promotion.pniCiphertext),
477
- ...change.deletePendingMembers
478
- .map((removal) => removal.serviceIdCiphertext)
479
- .filter((target) => requesterMatches(requester, target)),
480
- ...change.deleteRequestingMembers.filter((target) => requesterMatches(requester, target)),
481
- ].filter((candidate, index, candidates) => candidates.findIndex((other) => equal(candidate, other)) === index);
482
- if (actionNamedRequesterIds.length > 1) {
483
- rejectForbidden('A change cannot exercise self-rights under multiple requester aliases', undefined, 'multiple_requester_aliases');
484
- }
485
- if (actionNamedRequesterIds.length === 1) {
486
- return actionNamedRequesterIds[0];
487
- }
488
- const preChangeMatches = matchingRequesterIds(state, requester);
489
- const matches = preChangeMatches.length > 0
490
- ? preChangeMatches
491
- : [
492
- ...change.newMembers.map((member) => member.aciCiphertext),
493
- ...change.newRequestingMembers.map((member) => member.aciCiphertext),
494
- ].filter((userId) => requesterMatches(requester, userId));
495
- const aciMatch = matches.find((userId) => equal(userId, requester.aciCiphertext));
496
- const sourceUserId = aciMatch ?? matches[0];
497
- if (!sourceUserId) {
498
- rejectForbidden('Requester does not match the pre- or post-change group state');
499
- }
500
- return sourceUserId;
501
- }
502
- function pendingRole(state, userId, label) {
503
- const pending = state.membersPendingProfileKey.find((member) => equal(member.member.userId, userId));
504
- if (!pending) {
505
- rejectBadRequest(`Cannot derive role for missing ${label}`);
506
- }
507
- return pending.member.role;
508
- }
509
- function canonicalizeAcceptedChange(state, submitted, sourceUserId, groupId, timestamp) {
510
- const stripped = stripChangeProfileKeyPresentations(submitted);
511
- return {
512
- ...stripped,
513
- sourceUserId,
514
- groupId: new Uint8Array(groupId),
515
- newMembers: stripped.newMembers.map((member) => ({
516
- ...member,
517
- joinedAtRevision: stripped.revision,
518
- })),
519
- newPendingMembers: stripped.newPendingMembers.map((member) => ({
520
- ...member,
521
- addedByAciCiphertext: new Uint8Array(sourceUserId),
522
- timestamp,
523
- })),
524
- promotePendingMembers: stripped.promotePendingMembers.map((member) => ({
525
- ...member,
526
- role: pendingRole(state, member.aciCiphertext, 'pending ACI member'),
527
- joinedAtRevision: stripped.revision,
528
- })),
529
- promotePendingPniAciMembers: stripped.promotePendingPniAciMembers.map((member) => ({
530
- ...member,
531
- role: pendingRole(state, member.pniCiphertext, 'pending PNI member'),
532
- joinedAtRevision: stripped.revision,
533
- })),
534
- newRequestingMembers: stripped.newRequestingMembers.map((member) => ({
535
- ...member,
536
- timestamp,
537
- })),
538
- newBannedMembers: stripped.newBannedMembers.map((member) => ({
539
- ...member,
540
- timestamp,
541
- })),
542
- };
543
- }
544
- function targetIsRequester(target, sourceUserId) {
545
- return equal(target, sourceUserId);
546
- }
547
- function authorizeEncryptedChange(state, change, sourceUserId, requester) {
548
- const role = roleForSource(state, sourceUserId);
549
- const banned = requesterIsBanned(state, requester);
550
- const policyState = {
551
- accessControl: state.accessControl,
552
- isAnnouncementGroup: state.announcementsOnly
553
- ? EnabledState.ENABLED
554
- : EnabledState.DISABLED,
555
- };
556
- const check = (action, target, assignedRole) => {
557
- if (!canRolePerformAction(policyState, role, action, {
558
- requesterIsBanned: banned,
559
- targetIsRequester: target
560
- ? targetIsRequester(target, sourceUserId)
561
- : false,
562
- assignedRole,
563
- })) {
564
- rejectForbidden(`Requester cannot perform ${action}`, undefined, 'action_not_allowed');
565
- }
566
- };
567
- for (const member of change.newMembers) {
568
- check(GroupAction.ADD_MEMBER, member.aciCiphertext, member.role);
569
- }
570
- for (const member of change.deleteMembers)
571
- check(GroupAction.REMOVE_MEMBER, member);
572
- for (const member of change.modifyMemberRoles) {
573
- check(GroupAction.MODIFY_MEMBER_ROLE, member.aciCiphertext);
574
- }
575
- for (const member of change.modifiedProfileKeys) {
576
- check(GroupAction.MODIFY_MEMBER_PROFILE_KEY, member.aciCiphertext);
577
- }
578
- for (const member of change.newPendingMembers) {
579
- check(GroupAction.ADD_MEMBER_PENDING_PROFILE_KEY, member.serviceIdCiphertext, member.role);
580
- }
581
- for (const member of change.deletePendingMembers) {
582
- check(GroupAction.DELETE_MEMBER_PENDING_PROFILE_KEY, member.serviceIdCiphertext);
583
- }
584
- for (const member of change.promotePendingMembers) {
585
- check(GroupAction.PROMOTE_MEMBER_PENDING_PROFILE_KEY, member.aciCiphertext);
586
- }
587
- for (const member of change.promotePendingPniAciMembers) {
588
- const pniPending = state.membersPendingProfileKey.find((pending) => equal(pending.member.userId, member.pniCiphertext));
589
- const aciPending = state.membersPendingProfileKey.find((pending) => equal(pending.member.userId, member.aciCiphertext));
590
- if (pniPending &&
591
- aciPending &&
592
- pniPending.member.role !== aciPending.member.role) {
593
- rejectForbidden('PNI-to-ACI promotion cannot consume pending aliases with different roles', undefined, 'invitation_role_conflict');
594
- }
595
- check(GroupAction.PROMOTE_MEMBER_PENDING_PNI_ACI_PROFILE_KEY, member.pniCiphertext);
596
- }
597
- if (change.newTitle !== undefined)
598
- check(GroupAction.MODIFY_TITLE);
599
- if (change.newAvatar !== undefined)
600
- check(GroupAction.MODIFY_AVATAR);
601
- if (change.newTimer !== undefined)
602
- check(GroupAction.MODIFY_DISAPPEARING_MESSAGES);
603
- if (change.newDescription !== undefined)
604
- check(GroupAction.MODIFY_DESCRIPTION);
605
- if (change.newAttributeAccess !== undefined)
606
- check(GroupAction.MODIFY_ATTRIBUTES_ACCESS);
607
- if (change.newMemberAccess !== undefined)
608
- check(GroupAction.MODIFY_MEMBERS_ACCESS);
609
- if (change.newInviteLinkAccess !== undefined) {
610
- check(GroupAction.MODIFY_INVITE_LINK_ACCESS);
611
- }
612
- if (change.newMemberLabelAccess !== undefined) {
613
- check(GroupAction.MODIFY_MEMBER_LABEL_ACCESS);
614
- }
615
- if (change['newInviteLinkPassword'] !== undefined) {
616
- check(GroupAction.MODIFY_INVITE_LINK_PASSWORD);
617
- }
618
- if (change.newIsAnnouncementGroup !== undefined) {
619
- check(GroupAction.MODIFY_ANNOUNCEMENTS);
620
- }
621
- for (const member of change.newRequestingMembers) {
622
- check(GroupAction.ADD_MEMBER_PENDING_ADMIN_APPROVAL, member.aciCiphertext);
623
- }
624
- for (const member of change.deleteRequestingMembers) {
625
- check(GroupAction.DELETE_MEMBER_PENDING_ADMIN_APPROVAL, member);
626
- }
627
- for (const member of change.promoteRequestingMembers) {
628
- check(GroupAction.PROMOTE_MEMBER_PENDING_ADMIN_APPROVAL, member.aciCiphertext);
629
- }
630
- for (const member of change.newBannedMembers) {
631
- check(GroupAction.BAN_MEMBER, member.serviceIdCiphertext);
632
- }
633
- for (const member of change.deleteBannedMembers) {
634
- check(GroupAction.UNBAN_MEMBER, member.serviceIdCiphertext);
635
- }
636
- for (const member of change.modifyMemberLabels) {
637
- check(GroupAction.MODIFY_MEMBER_LABEL, member.aciCiphertext);
638
- }
639
- if (change.terminate === true)
640
- check(GroupAction.TERMINATE_GROUP);
641
- }
642
- function requirePniAciBinding(change, requester) {
643
- for (const promotion of change.promotePendingPniAciMembers) {
644
- if (!equal(promotion.aciCiphertext, requester.aciCiphertext) ||
645
- requester.pniCiphertext === undefined ||
646
- promotion.pniCiphertext.length === 0 ||
647
- !equal(promotion.pniCiphertext, requester.pniCiphertext)) {
648
- rejectForbidden('PNI-to-ACI promotion is not bound to the requester presentation', undefined, 'pni_aci_binding');
649
- }
650
- }
651
- }
652
- function isLinkJoin(state, change, requester) {
653
- if (roleForRequesterAliases(state, requester) !== MemberRole.UNKNOWN) {
654
- return false;
655
- }
656
- return (change.newMembers.some((member) => equal(member.aciCiphertext, requester.aciCiphertext)) ||
657
- change.newRequestingMembers.some((member) => equal(member.aciCiphertext, requester.aciCiphertext)));
658
- }
659
- function requireInviteLinkPassword(state, change, requester, password) {
660
- if (isLinkJoin(state, change, requester) &&
661
- (state.inviteLinkPassword.length !== INVITE_LINK_PASSWORD_LENGTH ||
662
- password.length !== INVITE_LINK_PASSWORD_LENGTH ||
663
- !constantTimeEqual(state.inviteLinkPassword, password))) {
664
- rejectForbidden('Invite-link password is absent or invalid');
665
- }
666
- }
667
- function applyEncryptedChange(state, change) {
668
- if (state.terminated)
669
- rejectBadRequest('Group is terminated');
670
- const next = cloneProtocolState(state);
671
- const { newInviteLinkPassword } = change;
672
- const missing = (description) => rejectBadRequest(`Action targets a missing ${description}`);
673
- const duplicate = (description) => rejectBadRequest(`Action creates a duplicate ${description}`);
674
- for (const removal of change.deletePendingMembers) {
675
- const index = next.membersPendingProfileKey.findIndex((member) => equal(member.member.userId, removal.serviceIdCiphertext));
676
- if (index < 0)
677
- missing('pending member');
678
- next.membersPendingProfileKey.splice(index, 1);
679
- }
680
- for (const userId of change.deleteRequestingMembers) {
681
- const index = next.membersPendingAdminApproval.findIndex((member) => equal(member.userId, userId));
682
- if (index < 0)
683
- missing('requesting member');
684
- next.membersPendingAdminApproval.splice(index, 1);
685
- }
686
- for (const removal of change.deleteBannedMembers) {
687
- const index = next.membersBanned.findIndex((member) => equal(member.userId, removal.serviceIdCiphertext));
688
- if (index < 0)
689
- missing('banned member');
690
- next.membersBanned.splice(index, 1);
691
- }
692
- for (const userId of change.deleteMembers) {
693
- const index = next.members.findIndex((member) => equal(member.userId, userId));
694
- if (index < 0)
695
- missing('member');
696
- next.members.splice(index, 1);
697
- }
698
- for (const addition of change.newBannedMembers) {
699
- if (next.membersBanned.some((member) => equal(member.userId, addition.serviceIdCiphertext))) {
700
- duplicate('banned member');
701
- }
702
- if (next.membersBanned.length >= MAX_GROUP_SIZE) {
703
- rejectBadRequest('Group banned-member list is full');
704
- }
705
- next.membersBanned.push({
706
- userId: addition.serviceIdCiphertext,
707
- timestamp: addition.timestamp,
708
- });
709
- }
710
- for (const promotion of change.promotePendingMembers) {
711
- if (next.members.some((member) => equal(member.userId, promotion.aciCiphertext))) {
712
- duplicate('member');
713
- }
714
- const index = next.membersPendingProfileKey.findIndex((member) => equal(member.member.userId, promotion.aciCiphertext));
715
- if (index < 0)
716
- missing('pending ACI member');
717
- const [pending] = next.membersPendingProfileKey.splice(index, 1);
718
- next.members.push(memberFromAction(promotion, pending.member.role, change.revision));
719
- }
720
- for (const promotion of change.promotePendingPniAciMembers) {
721
- if (next.members.some((member) => equal(member.userId, promotion.aciCiphertext))) {
722
- duplicate('member');
723
- }
724
- const index = next.membersPendingProfileKey.findIndex((member) => equal(member.member.userId, promotion.pniCiphertext));
725
- if (index < 0)
726
- missing('pending PNI member');
727
- const [pending] = next.membersPendingProfileKey.splice(index, 1);
728
- const aciAliasIndex = next.membersPendingProfileKey.findIndex((member) => equal(member.member.userId, promotion.aciCiphertext));
729
- if (aciAliasIndex >= 0) {
730
- const [aciPending] = next.membersPendingProfileKey.splice(aciAliasIndex, 1);
731
- if (aciPending.member.role !== pending.member.role) {
732
- rejectForbidden('PNI-to-ACI promotion cannot consume pending aliases with different roles', undefined, 'invitation_role_conflict');
733
- }
734
- }
735
- next.members.push(memberFromAction(promotion, pending.member.role, change.revision));
736
- }
737
- for (const promotion of change.promoteRequestingMembers) {
738
- if (next.members.some((member) => equal(member.userId, promotion.aciCiphertext))) {
739
- duplicate('member');
740
- }
741
- const index = next.membersPendingAdminApproval.findIndex((member) => equal(member.userId, promotion.aciCiphertext));
742
- if (index < 0)
743
- missing('requesting member');
744
- const [requesting] = next.membersPendingAdminApproval.splice(index, 1);
745
- next.members.push({
746
- userId: requesting.userId,
747
- role: promotion.role,
748
- profileKey: requesting.profileKey,
749
- presentation: requesting.presentation,
750
- joinedAtVersion: change.revision,
751
- labelEmoji: new Uint8Array(0),
752
- labelString: new Uint8Array(0),
753
- });
754
- }
755
- for (const addition of change.newMembers) {
756
- if (next.members.some((member) => equal(member.userId, addition.aciCiphertext))) {
757
- duplicate('member');
758
- }
759
- if (next.members.length >= MAX_GROUP_SIZE)
760
- rejectBadRequest('Group is full');
761
- next.members.push(memberFromAction(addition, addition.role, addition.joinedAtRevision));
762
- }
763
- for (const addition of change.newPendingMembers) {
764
- if (next.membersPendingProfileKey.some((member) => equal(member.member.userId, addition.serviceIdCiphertext))) {
765
- duplicate('pending member');
766
- }
767
- if (next.membersPendingProfileKey.length >= MAX_GROUP_SIZE) {
768
- rejectBadRequest('Group pending-member list is full');
769
- }
770
- next.membersPendingProfileKey.push({
771
- member: {
772
- userId: addition.serviceIdCiphertext,
773
- role: addition.role,
774
- profileKey: new Uint8Array(0),
775
- presentation: new Uint8Array(0),
776
- joinedAtVersion: 0,
777
- labelEmoji: new Uint8Array(0),
778
- labelString: new Uint8Array(0),
779
- },
780
- addedByUserId: addition.addedByAciCiphertext,
781
- timestamp: addition.timestamp,
782
- });
783
- }
784
- for (const addition of change.newRequestingMembers) {
785
- if (next.membersPendingAdminApproval.some((member) => equal(member.userId, addition.aciCiphertext))) {
786
- duplicate('requesting member');
787
- }
788
- if (next.membersPendingAdminApproval.length >= MAX_GROUP_SIZE) {
789
- rejectBadRequest('Group requesting-member list is full');
790
- }
791
- next.membersPendingAdminApproval.push({
792
- userId: addition.aciCiphertext,
793
- profileKey: addition.profileKeyCiphertext,
794
- presentation: addition.presentation,
795
- timestamp: addition.timestamp,
796
- });
797
- }
798
- for (const modification of change.modifyMemberRoles) {
799
- const member = next.members.find((candidate) => equal(candidate.userId, modification.aciCiphertext));
800
- if (!member)
801
- return missing('member role target');
802
- member.role = modification.role;
803
- }
804
- for (const modification of change.modifyMemberLabels) {
805
- const member = next.members.find((candidate) => equal(candidate.userId, modification.aciCiphertext));
806
- if (!member)
807
- return missing('member label target');
808
- member.labelEmoji = modification.labelEmojiCiphertext;
809
- member.labelString = modification.labelStringCiphertext;
810
- }
811
- for (const modification of change.modifiedProfileKeys) {
812
- const member = next.members.find((candidate) => equal(candidate.userId, modification.aciCiphertext));
813
- if (!member)
814
- return missing('member profile-key target');
815
- member.profileKey = modification.profileKeyCiphertext;
816
- member.presentation = modification.presentation;
817
- }
818
- if (change.newTitle !== undefined)
819
- next.title = change.newTitle;
820
- if (change.newAvatar !== undefined)
821
- next.avatarUrl = change.newAvatar.value;
822
- if (change.newTimer !== undefined)
823
- next.disappearingMessagesTimer = change.newTimer;
824
- if (change.newDescription !== undefined)
825
- next.description = change.newDescription;
826
- if (newInviteLinkPassword !== undefined) {
827
- next.inviteLinkPassword = newInviteLinkPassword.slice();
828
- }
829
- if (change.newAttributeAccess !== undefined) {
830
- next.accessControl.attributes = change.newAttributeAccess;
831
- }
832
- if (change.newMemberAccess !== undefined) {
833
- next.accessControl.members = change.newMemberAccess;
834
- }
835
- if (change.newInviteLinkAccess !== undefined) {
836
- next.accessControl.addFromInviteLink = change.newInviteLinkAccess;
837
- }
838
- if (change.newMemberLabelAccess !== undefined) {
839
- next.accessControl.memberLabel = change.newMemberLabelAccess;
840
- }
841
- if (change.newIsAnnouncementGroup !== undefined) {
842
- next.announcementsOnly = change.newIsAnnouncementGroup === EnabledState.ENABLED;
843
- }
844
- if (change.terminate === true)
845
- next.terminated = true;
846
- next.version = change.revision;
847
- return next;
848
- }
849
- export class GroupAuthorizationServerEngine {
850
- serverSecretParams;
851
- runtime;
852
- groups = new Map();
853
- constructor(serverSecretParams, runtime) {
854
- this.serverSecretParams = serverSecretParams;
855
- this.runtime = runtime;
856
- }
857
- get publicParams() {
858
- return getServerPublicParams(this.serverSecretParams);
859
- }
860
- clear() {
861
- this.groups.clear();
862
- }
863
- /** Verify a retry's identity. The persistence adapter must also match its accepted request digest. */
864
- verifyRetryAuthorization(groupId, authorization) {
865
- this.authenticate(groupId, authorization, this.groups.get(this.key(groupId))?.state);
866
- }
867
- inspectEncryptedState(groupId) {
868
- const stored = this.groups.get(this.key(groupId));
869
- return stored ? serializeEncryptedGroup(stored.state) : null;
870
- }
871
- restoreGroup(groupId, persisted) {
872
- const state = deserializeEncryptedGroup(persisted.encryptedState);
873
- const snapshots = new Map(persisted.snapshots.map((snapshot) => [
874
- snapshot.version,
875
- {
876
- state: deserializeEncryptedGroup(snapshot.encryptedState),
877
- baselineSignature: new Uint8Array(snapshot.baselineSignature),
878
- },
879
- ]));
880
- this.groups.set(this.key(groupId), {
881
- state,
882
- changes: cloneProtocolState(persisted.changes),
883
- snapshots,
884
- });
885
- }
886
- exportGroup(groupId) {
887
- const stored = this.groups.get(this.key(groupId));
888
- if (!stored)
889
- return null;
890
- return {
891
- encryptedState: serializeEncryptedGroup(stored.state),
892
- changes: cloneProtocolState(stored.changes),
893
- snapshots: [...stored.snapshots.entries()]
894
- .sort(([left], [right]) => left - right)
895
- .map(([version, snapshot]) => ({
896
- version,
897
- encryptedState: serializeEncryptedGroup(snapshot.state),
898
- baselineSignature: new Uint8Array(snapshot.baselineSignature),
899
- })),
900
- };
901
- }
902
- key(groupId) {
903
- return Array.from(groupId, (byte) => byte.toString(16).padStart(2, '0')).join('');
904
- }
905
- createStoredSnapshot(groupId, state) {
906
- const encryptedState = serializeEncryptedGroup(state);
907
- return {
908
- state: cloneProtocolState(state),
909
- baselineSignature: serverSign(this.serverSecretParams, this.runtime.randomBytes(32), serializeGroupBaseline(groupId, state.version, encryptedState)),
910
- };
911
- }
912
- authenticate(groupId, authorization, state) {
913
- try {
914
- const groupPublicParams = deserializeGroupPublicParams(new Uint8Array(authorization.groupPublicParams));
915
- if (!equal(groupPublicParams.groupId, groupId)) {
916
- rejectUnauthorized('Presentation is bound to a different group');
917
- }
918
- if (state &&
919
- !equal(state.publicKey, serializeGroupPublicParams(groupPublicParams))) {
920
- rejectUnauthorized('Presentation parameters do not match stored group parameters');
921
- }
922
- const presentation = deserializeAuthCredentialPresentation(new Uint8Array(authorization.presentation));
923
- const nowSeconds = Math.floor(this.runtime.now() / 1000);
924
- const today = Math.floor(nowSeconds / SECONDS_PER_DAY) * SECONDS_PER_DAY;
925
- if (presentation.redemptionTime % SECONDS_PER_DAY !== 0 ||
926
- Math.abs(presentation.redemptionTime - today) > SECONDS_PER_DAY) {
927
- rejectUnauthorized('Credential redemption time is outside current day ± one day');
928
- }
929
- verifyAuthCredentialPresentation(this.serverSecretParams.credentialKeyPair, groupPublicParams, presentation, nowSeconds);
930
- return {
931
- aciCiphertext: serializePresentationCiphertext(SERVICE_ID_ACI, presentation.aciCiphertext),
932
- pniCiphertext: presentation.pniCiphertext === undefined
933
- ? undefined
934
- : serializePresentationCiphertext(SERVICE_ID_PNI, presentation.pniCiphertext),
935
- };
936
- }
937
- catch (error) {
938
- if (error instanceof GroupServerError)
939
- throw error;
940
- rejectUnauthorized(error instanceof Error ? error.message : 'Credential presentation verification failed');
941
- }
942
- }
943
- isReadable(state, requester) {
944
- if (requesterIsBanned(state, requester))
945
- return false;
946
- return (this.isMemberOf(state, requester) ||
947
- state.membersPendingProfileKey.some((pending) => requesterMatches(requester, pending.member.userId)));
948
- }
949
- /**
950
- * Whether the requester holds a member entry in this state. This is the
951
- * change-log predicate: the log is a member read (S10), so the walk both
952
- * admits and continues on membership. The same requester can hold a
953
- * member entry under one alias and a pending entry under another (§7.6).
954
- * Continuing on the weaker readable-set would keep serving the log
955
- * after the transition that ended their tenure.
956
- */
957
- isMemberOf(state, requester) {
958
- return state.members.some((member) => requesterMatches(requester, member.userId));
959
- }
960
- /** Issue send authorization only for a current, non-banned group member. */
961
- refreshGroupSendEndorsements(groupId, authorization, maximumExpiration) {
962
- const stored = this.groups.get(this.key(groupId));
963
- const requester = this.authenticate(groupId, authorization, stored?.state);
964
- if (!stored || !this.isMemberOf(stored.state, requester) || requesterIsBanned(stored.state, requester))
965
- rejectForbidden('Group send endorsements require current membership', 'not_a_member');
966
- if (stored.state.terminated)
967
- rejectForbidden('Terminated group cannot issue send endorsements');
968
- const members = stored.state.members.map((member) => new Ciphertext(RistrettoPoint.fromBytes(member.userId.subarray(1, 33)), RistrettoPoint.fromBytes(member.userId.subarray(33, 65)), UidEncryptionDomain));
969
- const nowSeconds = Math.floor(this.runtime.now() / 1000);
970
- let expiration = defaultExpiration(nowSeconds);
971
- if (maximumExpiration !== undefined) {
972
- if (!Number.isSafeInteger(maximumExpiration) || maximumExpiration <= 0)
973
- rejectBadRequest('The endorsement issuer expiry is invalid');
974
- // Client verification requires a UTC-day boundary and at least two hours of remaining lifetime.
975
- expiration = Math.min(expiration, Math.floor(maximumExpiration / 86400) * 86400);
976
- if (expiration - nowSeconds < 2 * 3600)
977
- rejectForbidden('The endorsement issuer expires too soon');
978
- }
979
- const result = issueEndorsements(members, deriveForExpiration(this.serverSecretParams.endorsementKeyPair, expiration), this.runtime.randomBytes(32));
980
- return { expiration, endorsements: serializeEndorsementsResponse(result) };
981
- }
982
- requireReadable(state, requester) {
983
- if (!this.isReadable(state, requester)) {
984
- rejectForbidden('Requester may not read full group state', 'not_readable');
985
- }
986
- }
987
- /**
988
- * The version at which the requester's current tenure began, or undefined
989
- * when the requester has no tenure to read.
990
- *
991
- * Deliberately consults `members` only. A pending-profile-key entry is an
992
- * invitation, not a tenure. Its wire format pins `joinedAtVersion` to
993
- * zero, so reading it here would hand every invitee a floor of "the
994
- * beginning of time". An invitee who never accepts could page through the
995
- * group's entire pre-invitation history, which is more than acceptance
996
- * itself would grant. An invitee reads the *current* state (that is what
997
- * an invitation entitles, and what acceptance needs). Versioned history
998
- * starts existing for them when they join and their member entry records
999
- * where.
1000
- */
1001
- requesterJoinedAtVersion(state, requester) {
1002
- return state.members.find((candidate) => requesterMatches(requester, candidate.userId))?.joinedAtVersion;
1003
- }
1004
- async createGroup(groupId, encryptedState, authorization) {
1005
- const key = this.key(groupId);
1006
- if (this.groups.has(key))
1007
- rejectConflict('Group already exists');
1008
- let submission;
1009
- try {
1010
- submission = deserializeEncryptedGroupCreationSubmission(encryptedState);
1011
- }
1012
- catch {
1013
- return rejectBadRequest('Encrypted group state is malformed');
1014
- }
1015
- const requester = this.authenticate(groupId, authorization);
1016
- if (!equal(submission.publicKey, authorization.groupPublicParams)) {
1017
- rejectBadRequest('Stored publicKey must be serialized GroupPublicParams');
1018
- }
1019
- assertEncryptedCreationStateStructure(submission);
1020
- const now = this.runtime.now();
1021
- const state = {
1022
- ...submission,
1023
- membersPendingProfileKey: submission.membersPendingProfileKey.map(({ userId, role }) => ({
1024
- member: {
1025
- userId,
1026
- role,
1027
- profileKey: new Uint8Array(0),
1028
- presentation: new Uint8Array(0),
1029
- joinedAtVersion: 0,
1030
- labelEmoji: new Uint8Array(0),
1031
- labelString: new Uint8Array(0),
1032
- },
1033
- addedByUserId: new Uint8Array(requester.aciCiphertext),
1034
- timestamp: now,
1035
- })),
1036
- membersPendingAdminApproval: [],
1037
- membersBanned: [],
1038
- };
1039
- assertEncryptedStateStructure(state);
1040
- verifyStateProfileKeyPresentations(state, this.serverSecretParams, Math.floor(now / 1000));
1041
- const creator = state.members.find((member) => equal(member.userId, requester.aciCiphertext));
1042
- if (!creator) {
1043
- rejectForbidden('Creator presentation is not an initial member');
1044
- }
1045
- if (creator.role !== MemberRole.ADMINISTRATOR) {
1046
- rejectForbidden('Creator must be an initial administrator', undefined, 'creator_not_administrator');
1047
- }
1048
- const storedState = stripStateProfileKeyPresentations(state);
1049
- const initialSnapshot = this.createStoredSnapshot(groupId, storedState);
1050
- this.groups.set(key, {
1051
- state: storedState,
1052
- changes: [],
1053
- snapshots: new Map([[0, initialSnapshot]]),
1054
- });
1055
- }
1056
- async getGroup(groupId, authorization, version) {
1057
- const stored = this.groups.get(this.key(groupId));
1058
- if (!stored)
1059
- return null;
1060
- // Authorization is evaluated against the group as it is *now*, never
1061
- // against the requested snapshot. Historical snapshots each contain a
1062
- // roster. Authorizing against the requested one let anyone removed or
1063
- // banned at version N keep reading every version of their tenure forever.
1064
- // A removal that does not revoke read access is not a removal. Current
1065
- // membership answers "may you read this group". The join-version floor
1066
- // below answers "may you read this version of it".
1067
- const requester = this.authenticate(groupId, authorization, stored.state);
1068
- this.requireReadable(stored.state, requester);
1069
- const snapshot = version === undefined
1070
- ? stored.snapshots.get(stored.state.version)
1071
- : stored.snapshots.get(version);
1072
- if (!snapshot)
1073
- return null;
1074
- if (version !== undefined) {
1075
- // Under snapshot-based authorization this floor was implicit. A
1076
- // pre-join snapshot simply did not list the requester. Authorizing
1077
- // against the current state removes that accident, so the floor has to
1078
- // be stated. Membership grants the group from when you joined, not its
1079
- // history.
1080
- const joinedAtVersion = this.requesterJoinedAtVersion(stored.state, requester);
1081
- if (joinedAtVersion === undefined) {
1082
- // Readable but not a member, a pending principal. Versioned
1083
- // history is a member read, and S10a grants an invitee the current
1084
- // state only. This is a different answer than `before_join`. That
1085
- // reason promises the membership itself is fine, which is exactly
1086
- // wrong for a former member whose re-invitation left them pending.
1087
- // The `not_a_member` reason is accurate in both directions. A live
1088
- // invitee probing history is not told they were revoked, and a
1089
- // revoked-then-re-invited member is not told their membership is
1090
- // intact.
1091
- rejectForbidden('Only members may read versioned group state', 'not_a_member');
1092
- }
1093
- if (version < joinedAtVersion) {
1094
- rejectForbidden('Requester may not read state from before they joined', 'before_join');
1095
- }
1096
- }
1097
- const { state } = snapshot;
1098
- const encryptedState = serializeEncryptedGroup(state);
1099
- return {
1100
- encryptedState,
1101
- version: state.version,
1102
- baselineSignature: new Uint8Array(snapshot.baselineSignature),
1103
- };
1104
- }
1105
- async getGroupJoinInfo(groupId, inviteLinkPassword, authorization) {
1106
- const stored = this.groups.get(this.key(groupId));
1107
- if (!stored)
1108
- return null;
1109
- const requester = this.authenticate(groupId, authorization, stored.state);
1110
- if (requesterIsBanned(stored.state, requester)) {
1111
- rejectForbidden('Banned requester may not read group join info');
1112
- }
1113
- if (stored.state.terminated) {
1114
- rejectForbidden('Terminated group has no join info');
1115
- }
1116
- const pendingAdminApproval = stored.state.membersPendingAdminApproval.some((pending) => requesterMatches(requester, pending.userId));
1117
- if (!pendingAdminApproval) {
1118
- if (stored.state.accessControl.addFromInviteLink === AccessRequired.UNSATISFIABLE ||
1119
- stored.state.accessControl.addFromInviteLink === AccessRequired.UNKNOWN) {
1120
- rejectForbidden('Invite-link access is disabled or unknown');
1121
- }
1122
- if (stored.state.inviteLinkPassword.length !== INVITE_LINK_PASSWORD_LENGTH ||
1123
- inviteLinkPassword.length !== INVITE_LINK_PASSWORD_LENGTH ||
1124
- !constantTimeEqual(stored.state.inviteLinkPassword, inviteLinkPassword)) {
1125
- rejectForbidden('Invite-link password is absent or invalid');
1126
- }
1127
- }
1128
- const info = {
1129
- publicKey: stored.state.publicKey,
1130
- title: stored.state.title,
1131
- avatar: stored.state.avatarUrl,
1132
- memberCount: stored.state.members.length,
1133
- addFromInviteLink: stored.state.accessControl.addFromInviteLink,
1134
- revision: stored.state.version,
1135
- pendingAdminApproval,
1136
- description: stored.state.description,
1137
- };
1138
- return {
1139
- encryptedJoinInfo: serializeEncryptedGroupJoinInfo(info),
1140
- version: stored.state.version,
1141
- };
1142
- }
1143
- async getGroupChanges(groupId, fromVersion, authorization) {
1144
- // Unlike getGroup, this deliberately authorizes against the *requested*
1145
- // snapshot. The walk below serves entries only while the requester stays
1146
- // a member. It stops at, and includes, the change that ended their
1147
- // tenure, which is how a removed member learns of their removal when
1148
- // they poll. Authorizing against the current state would 403 them into
1149
- // silence instead.
1150
- //
1151
- // The exposure this leaves is bounded and not new. A former member can
1152
- // re-fetch changes from within their own tenure, ending at the change
1153
- // that ended it. Bytes they were served while entitled.
1154
- //
1155
- // The log is for members. A pending-profile-key entry entitles its
1156
- // holder to the current state, because acceptance needs that and
1157
- // getGroup serves it. The log names the actor behind every change, and
1158
- // an invitation is not a tenure. A requester who is merely pending in
1159
- // the snapshot at `fromVersion` is therefore refused below, even though
1160
- // that snapshot lists them as readable.
1161
- //
1162
- // Pending principals catch up by fetching a fresh signed snapshot
1163
- // instead (S10a). The reference ecosystem's clients behave the same
1164
- // way. Their state processor updates straight to the latest server
1165
- // state whenever the server does not recognize the requester as a
1166
- // member. This membership requirement is what closes history. For
1167
- // members it bounds the log at their tenure, because a pre-join
1168
- // snapshot does not list them in `members`. For invitees it closes the
1169
- // log outright.
1170
- const stored = this.groups.get(this.key(groupId));
1171
- if (!stored)
1172
- return { entries: [], hasMore: false };
1173
- const snapshot = stored.snapshots.get(fromVersion);
1174
- if (!snapshot) {
1175
- rejectBadRequest(`Group snapshot ${fromVersion} does not exist`);
1176
- }
1177
- const requester = this.authenticate(groupId, authorization, snapshot.state);
1178
- this.requireReadable(snapshot.state, requester);
1179
- if (!this.isMemberOf(snapshot.state, requester)) {
1180
- rejectForbidden('Only members may read the change log', 'not_a_member');
1181
- }
1182
- // Paged: one request must not be made to carry a group's whole history.
1183
- // The `hasMore` flag is set only on a size cut with the requester still
1184
- // a member. The client resumes from the last served version, and each
1185
- // resumed page re-authorizes at its own fromVersion snapshot. A walk
1186
- // ending at the log's tip or at the requester's own tenure-ending
1187
- // transition is complete. A removed member therefore never sees
1188
- // `hasMore` dangle past the change that removed them.
1189
- //
1190
- // The continue condition is the same membership predicate as the entry
1191
- // gate above. Continuing on the weaker readable-set would serve
1192
- // post-tenure history to a requester whose removal left an alias
1193
- // pending (§7.6). The resumed page's entry gate would then refuse the
1194
- // very request this page invited.
1195
- const memberPrefix = [];
1196
- let hasMore = false;
1197
- for (const entry of stored.changes) {
1198
- if (entry.version <= fromVersion)
1199
- continue;
1200
- if (memberPrefix.length >= GROUP_CHANGE_LOG_PAGE_LIMIT) {
1201
- hasMore = true;
1202
- break;
1203
- }
1204
- memberPrefix.push(entry);
1205
- const postState = stored.snapshots.get(entry.version);
1206
- if (!postState) {
1207
- throw new Error(`Missing group snapshot ${entry.version}`);
1208
- }
1209
- if (!this.isMemberOf(postState.state, requester))
1210
- break;
1211
- }
1212
- return { entries: cloneProtocolState(memberPrefix), hasMore };
1213
- }
1214
- async submitGroupChange(groupId, expectedVersion, actions, inviteLinkPassword, authorization) {
1215
- if (arguments.length !== 5) {
1216
- rejectBadRequest('Group change submission must not carry an epoch');
1217
- }
1218
- const stored = this.groups.get(this.key(groupId));
1219
- if (!stored)
1220
- rejectBadRequest('Group does not exist');
1221
- const operationTime = this.runtime.now();
1222
- const requester = this.authenticate(groupId, authorization, stored.state);
1223
- if (stored.state.version !== expectedVersion) {
1224
- rejectConflict(`Expected ${expectedVersion}, current version is ${stored.state.version}`);
1225
- }
1226
- let change;
1227
- try {
1228
- change = deserializeEncryptedGroupChange(actions);
1229
- assertRecognizedActionShape(change, 'submission');
1230
- }
1231
- catch (error) {
1232
- if (error instanceof GroupServerError)
1233
- throw error;
1234
- return rejectBadRequest('Actions are malformed');
1235
- }
1236
- if (change.groupId !== undefined) {
1237
- rejectBadRequest('Client must not set Actions.groupId');
1238
- }
1239
- if (change.revision !== stored.state.version + 1) {
1240
- rejectConflict(`Actions revision ${change.revision} does not follow ${stored.state.version}`);
1241
- }
1242
- verifyChangeProfileKeyPresentations(stored.state, change, this.serverSecretParams, Math.floor(operationTime / 1000));
1243
- requirePniAciBinding(change, requester);
1244
- const sourceUserId = sourceUserIdForChange(stored.state, change, requester);
1245
- // All authorization facts are evaluated against the unchanged pre-state.
1246
- authorizeEncryptedChange(stored.state, change, sourceUserId, requester);
1247
- requireInviteLinkPassword(stored.state, change, requester, inviteLinkPassword);
1248
- const acceptedChange = canonicalizeAcceptedChange(stored.state, change, sourceUserId, groupId, operationTime);
1249
- assertRecognizedActionShape(acceptedChange, 'canonical');
1250
- const nextState = applyEncryptedChange(stored.state, acceptedChange);
1251
- assertEncryptedStateStructure(nextState);
1252
- const acceptedActions = serializeEncryptedGroupChange(acceptedChange);
1253
- const changeEpoch = requiredGroupChangeEpoch(acceptedChange);
1254
- const signature = serverSign(this.serverSecretParams, this.runtime.randomBytes(32), serializeGroupChangeCommitment(changeEpoch, acceptedActions));
1255
- const entry = {
1256
- version: acceptedChange.revision,
1257
- actions: acceptedActions,
1258
- serverSignature: signature,
1259
- changeEpoch,
1260
- timestamp: operationTime,
1261
- };
1262
- stored.state = nextState;
1263
- stored.snapshots.set(nextState.version, this.createStoredSnapshot(groupId, nextState));
1264
- stored.changes.push(cloneProtocolState(entry));
1265
- return cloneProtocolState(entry);
1266
- }
1267
- }
1268
- //# sourceMappingURL=server-engine.js.map