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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (494) hide show
  1. package/ADAPTERS.md +15 -15
  2. package/ARCHITECTURE.md +1 -1
  3. package/CHANGELOG.md +252 -2
  4. package/README.md +1 -1
  5. package/blocking/README.md +5 -5
  6. package/client/README.md +2 -2
  7. package/dist/blocking/index.d.ts +2 -2
  8. package/dist/blocking/index.d.ts.map +1 -1
  9. package/dist/blocking/index.js +1 -1
  10. package/dist/blocking/index.js.map +1 -1
  11. package/dist/blocking/manager.d.ts +7 -7
  12. package/dist/blocking/manager.d.ts.map +1 -1
  13. package/dist/blocking/manager.js +3 -3
  14. package/dist/blocking/manager.js.map +1 -1
  15. package/dist/blocking/types.d.ts +3 -3
  16. package/dist/blocking/types.d.ts.map +1 -1
  17. package/dist/client/client.d.ts +32 -28
  18. package/dist/client/client.d.ts.map +1 -1
  19. package/dist/client/client.js +127 -79
  20. package/dist/client/client.js.map +1 -1
  21. package/dist/client/compose.d.ts +12 -7
  22. package/dist/client/compose.d.ts.map +1 -1
  23. package/dist/client/compose.js +2 -0
  24. package/dist/client/compose.js.map +1 -1
  25. package/dist/client/config.d.ts +54 -30
  26. package/dist/client/config.d.ts.map +1 -1
  27. package/dist/client/config.js.map +1 -1
  28. package/dist/client/content-adapter.d.ts +4 -4
  29. package/dist/client/content-adapter.d.ts.map +1 -1
  30. package/dist/client/content-adapter.js +1 -1
  31. package/dist/client/content-adapter.js.map +1 -1
  32. package/dist/client/dual-store.d.ts +5 -5
  33. package/dist/client/dual-store.d.ts.map +1 -1
  34. package/dist/client/dual-store.js.map +1 -1
  35. package/dist/client/endorsement-manager.d.ts +4 -0
  36. package/dist/client/endorsement-manager.d.ts.map +1 -1
  37. package/dist/client/endorsement-manager.js +11 -2
  38. package/dist/client/endorsement-manager.js.map +1 -1
  39. package/dist/client/groups.d.ts +29 -29
  40. package/dist/client/groups.d.ts.map +1 -1
  41. package/dist/client/groups.js +54 -37
  42. package/dist/client/groups.js.map +1 -1
  43. package/dist/client/headless.d.ts +9 -9
  44. package/dist/client/headless.d.ts.map +1 -1
  45. package/dist/client/headless.js +6 -6
  46. package/dist/client/headless.js.map +1 -1
  47. package/dist/client/index.d.ts +2 -2
  48. package/dist/client/index.d.ts.map +1 -1
  49. package/dist/client/index.js +1 -1
  50. package/dist/client/index.js.map +1 -1
  51. package/dist/client/key-rotation-core.d.ts +7 -7
  52. package/dist/client/key-rotation-core.d.ts.map +1 -1
  53. package/dist/client/key-rotation-core.js +11 -11
  54. package/dist/client/key-rotation-core.js.map +1 -1
  55. package/dist/client/media.js.map +1 -1
  56. package/dist/client/relay-subscription.d.ts +2 -2
  57. package/dist/client/relay-subscription.d.ts.map +1 -1
  58. package/dist/client/relay-subscription.js +1 -1
  59. package/dist/client/relay-subscription.js.map +1 -1
  60. package/dist/client/retry.js.map +1 -1
  61. package/dist/client/sealed-sender-ops.d.ts +1 -1
  62. package/dist/client/sealed-sender-ops.d.ts.map +1 -1
  63. package/dist/client/sealed-sender-ops.js +3 -3
  64. package/dist/client/sealed-sender-ops.js.map +1 -1
  65. package/dist/client/signal-service-cipher.d.ts +15 -11
  66. package/dist/client/signal-service-cipher.d.ts.map +1 -1
  67. package/dist/client/signal-service-cipher.js +24 -15
  68. package/dist/client/signal-service-cipher.js.map +1 -1
  69. package/dist/client/types.d.ts +8 -8
  70. package/dist/client/types.d.ts.map +1 -1
  71. package/dist/device/connection.js +2 -2
  72. package/dist/device/connection.js.map +1 -1
  73. package/dist/device/device-id.d.ts.map +1 -1
  74. package/dist/device/device-id.js +4 -4
  75. package/dist/device/device-id.js.map +1 -1
  76. package/dist/device/provisioning.d.ts +2 -2
  77. package/dist/device/provisioning.d.ts.map +1 -1
  78. package/dist/device/provisioning.js +7 -7
  79. package/dist/device/provisioning.js.map +1 -1
  80. package/dist/device/transfer.d.ts.map +1 -1
  81. package/dist/device/transfer.js +14 -14
  82. package/dist/device/transfer.js.map +1 -1
  83. package/dist/files/index.d.ts +1 -1
  84. package/dist/files/index.js +1 -1
  85. package/dist/groups/index.d.ts +4 -4
  86. package/dist/groups/index.d.ts.map +1 -1
  87. package/dist/groups/index.js +3 -3
  88. package/dist/groups/index.js.map +1 -1
  89. package/dist/hooks/use-connection-presence.d.ts +3 -3
  90. package/dist/hooks/use-connection-presence.d.ts.map +1 -1
  91. package/dist/hooks/use-connection-presence.js +4 -4
  92. package/dist/hooks/use-connection-presence.js.map +1 -1
  93. package/dist/hooks/use-key-rotation.js +2 -2
  94. package/dist/hooks/use-key-rotation.js.map +1 -1
  95. package/dist/index.d.ts +15 -15
  96. package/dist/index.d.ts.map +1 -1
  97. package/dist/index.js +6 -6
  98. package/dist/index.js.map +1 -1
  99. package/dist/internal/crypto/ec/x25519-validation.d.ts.map +1 -1
  100. package/dist/internal/crypto/ec/x25519-validation.js +4 -4
  101. package/dist/internal/crypto/ec/x25519-validation.js.map +1 -1
  102. package/dist/internal/crypto/symmetric/mac.d.ts +3 -3
  103. package/dist/internal/crypto/symmetric/mac.js +3 -3
  104. package/dist/internal/encoding/proto/envelope.d.ts +21 -21
  105. package/dist/internal/encoding/proto/envelope.d.ts.map +1 -1
  106. package/dist/internal/encoding/proto/envelope.js +25 -25
  107. package/dist/internal/encoding/proto/envelope.js.map +1 -1
  108. package/dist/internal/encoding/proto/index.d.ts +2 -2
  109. package/dist/internal/encoding/proto/index.d.ts.map +1 -1
  110. package/dist/internal/encoding/proto/index.js +2 -2
  111. package/dist/internal/encoding/proto/index.js.map +1 -1
  112. package/dist/internal/encoding/proto/pq-ratchet-serialize.d.ts +3 -3
  113. package/dist/internal/encoding/proto/pq-ratchet-serialize.js +2 -2
  114. package/dist/internal/encoding/proto/signal-message.d.ts +33 -33
  115. package/dist/internal/encoding/proto/signal-message.d.ts.map +1 -1
  116. package/dist/internal/encoding/proto/signal-message.js +58 -58
  117. package/dist/internal/encoding/proto/signal-message.js.map +1 -1
  118. package/dist/internal/groups/access-control.d.ts +170 -0
  119. package/dist/internal/groups/access-control.d.ts.map +1 -0
  120. package/dist/internal/groups/access-control.js +284 -0
  121. package/dist/internal/groups/access-control.js.map +1 -0
  122. package/dist/internal/groups/change-actions.d.ts +57 -0
  123. package/dist/internal/groups/change-actions.d.ts.map +1 -0
  124. package/dist/internal/groups/change-actions.js +827 -0
  125. package/dist/internal/groups/change-actions.js.map +1 -0
  126. package/dist/internal/groups/change-authorization.d.ts +16 -0
  127. package/dist/internal/groups/change-authorization.d.ts.map +1 -0
  128. package/dist/internal/groups/change-authorization.js +120 -0
  129. package/dist/internal/groups/change-authorization.js.map +1 -0
  130. package/dist/internal/{groups-v2 → groups}/encrypted-state.d.ts +12 -2
  131. package/dist/internal/groups/encrypted-state.d.ts.map +1 -0
  132. package/dist/internal/{groups-v2 → groups}/encrypted-state.js +122 -22
  133. package/dist/internal/groups/encrypted-state.js.map +1 -0
  134. package/dist/internal/groups/group-id.d.ts +9 -9
  135. package/dist/internal/groups/group-id.d.ts.map +1 -1
  136. package/dist/internal/groups/group-id.js +11 -12
  137. package/dist/internal/groups/group-id.js.map +1 -1
  138. package/dist/internal/groups/index.d.ts +16 -6
  139. package/dist/internal/groups/index.d.ts.map +1 -1
  140. package/dist/internal/groups/index.js +9 -1
  141. package/dist/internal/groups/index.js.map +1 -1
  142. package/dist/internal/groups/invite-link.d.ts.map +1 -0
  143. package/dist/internal/groups/invite-link.js.map +1 -0
  144. package/dist/internal/{groups-v2 → groups}/manager.d.ts +175 -40
  145. package/dist/internal/groups/manager.d.ts.map +1 -0
  146. package/dist/internal/groups/manager.js +1862 -0
  147. package/dist/internal/groups/manager.js.map +1 -0
  148. package/dist/internal/groups/sdk-store.d.ts +32 -0
  149. package/dist/internal/groups/sdk-store.d.ts.map +1 -0
  150. package/dist/internal/groups/sdk-store.js +111 -0
  151. package/dist/internal/groups/sdk-store.js.map +1 -0
  152. package/dist/internal/groups/server-engine.d.ts +52 -0
  153. package/dist/internal/groups/server-engine.d.ts.map +1 -0
  154. package/dist/internal/groups/server-engine.js +1126 -0
  155. package/dist/internal/groups/server-engine.js.map +1 -0
  156. package/dist/internal/groups/trust-root.d.ts +32 -0
  157. package/dist/internal/groups/trust-root.d.ts.map +1 -0
  158. package/dist/internal/groups/trust-root.js +91 -0
  159. package/dist/internal/groups/trust-root.js.map +1 -0
  160. package/dist/internal/{groups-v2 → groups}/types.d.ts +188 -46
  161. package/dist/internal/groups/types.d.ts.map +1 -0
  162. package/dist/internal/{groups-v2 → groups}/types.js +3 -2
  163. package/dist/internal/groups/types.js.map +1 -0
  164. package/dist/internal/groups/wire.d.ts +68 -0
  165. package/dist/internal/groups/wire.d.ts.map +1 -0
  166. package/dist/internal/groups/wire.js +708 -0
  167. package/dist/internal/groups/wire.js.map +1 -0
  168. package/dist/internal/manager/manager.d.ts +3 -3
  169. package/dist/internal/manager/manager.d.ts.map +1 -1
  170. package/dist/internal/manager/manager.js +3 -3
  171. package/dist/internal/manager/manager.js.map +1 -1
  172. package/dist/internal/protocol/double-ratchet/chains.d.ts.map +1 -1
  173. package/dist/internal/protocol/double-ratchet/chains.js +9 -9
  174. package/dist/internal/protocol/double-ratchet/chains.js.map +1 -1
  175. package/dist/internal/protocol/double-ratchet/ratchet.d.ts +2 -2
  176. package/dist/internal/protocol/double-ratchet/ratchet.d.ts.map +1 -1
  177. package/dist/internal/protocol/double-ratchet/ratchet.js +2 -2
  178. package/dist/internal/protocol/double-ratchet/ratchet.js.map +1 -1
  179. package/dist/internal/protocol/pqxdh/pqxdh.d.ts.map +1 -1
  180. package/dist/internal/protocol/pqxdh/pqxdh.js +3 -3
  181. package/dist/internal/protocol/pqxdh/pqxdh.js.map +1 -1
  182. package/dist/internal/protocol/sender-keys/index.d.ts +1 -1
  183. package/dist/internal/protocol/sender-keys/manager.d.ts +3 -3
  184. package/dist/internal/protocol/sender-keys/manager.d.ts.map +1 -1
  185. package/dist/internal/protocol/sender-keys/manager.js +3 -3
  186. package/dist/internal/protocol/sender-keys/manager.js.map +1 -1
  187. package/dist/internal/protocol/spqr/spqr.d.ts +1 -1
  188. package/dist/internal/protocol/spqr/spqr.d.ts.map +1 -1
  189. package/dist/internal/protocol/spqr/spqr.js +5 -5
  190. package/dist/internal/protocol/spqr/spqr.js.map +1 -1
  191. package/dist/internal/protocol/triple-ratchet/ratchet.d.ts +2 -2
  192. package/dist/internal/protocol/triple-ratchet/ratchet.d.ts.map +1 -1
  193. package/dist/internal/protocol/triple-ratchet/ratchet.js +4 -4
  194. package/dist/internal/protocol/triple-ratchet/ratchet.js.map +1 -1
  195. package/dist/internal/protocol/x3dh/x3dh.d.ts.map +1 -1
  196. package/dist/internal/protocol/x3dh/x3dh.js +3 -3
  197. package/dist/internal/protocol/x3dh/x3dh.js.map +1 -1
  198. package/dist/internal/protocol/zk/groups/auth-credential.d.ts +9 -7
  199. package/dist/internal/protocol/zk/groups/auth-credential.d.ts.map +1 -1
  200. package/dist/internal/protocol/zk/groups/auth-credential.js +68 -29
  201. package/dist/internal/protocol/zk/groups/auth-credential.js.map +1 -1
  202. package/dist/internal/protocol/zk/groups/server-params.d.ts +1 -1
  203. package/dist/internal/protocol/zk/groups/server-params.d.ts.map +1 -1
  204. package/dist/internal/protocol/zk/groups/server-params.js.map +1 -1
  205. package/dist/internal/protocol/zk/groups/uid-struct.d.ts +2 -0
  206. package/dist/internal/protocol/zk/groups/uid-struct.d.ts.map +1 -1
  207. package/dist/internal/protocol/zk/groups/uid-struct.js +4 -0
  208. package/dist/internal/protocol/zk/groups/uid-struct.js.map +1 -1
  209. package/dist/internal/sesame/device-registry.d.ts +7 -7
  210. package/dist/internal/sesame/device-registry.d.ts.map +1 -1
  211. package/dist/internal/sesame/device-registry.js +2 -2
  212. package/dist/internal/sesame/device-registry.js.map +1 -1
  213. package/dist/internal/sesame/manager.d.ts +1 -1
  214. package/dist/internal/sesame/manager.d.ts.map +1 -1
  215. package/dist/internal/sesame/manager.js +15 -15
  216. package/dist/internal/sesame/manager.js.map +1 -1
  217. package/dist/internal/session/builder.js +3 -3
  218. package/dist/internal/session/builder.js.map +1 -1
  219. package/dist/internal/session/cipher.d.ts +2 -2
  220. package/dist/internal/session/cipher.d.ts.map +1 -1
  221. package/dist/internal/session/cipher.js +30 -30
  222. package/dist/internal/session/cipher.js.map +1 -1
  223. package/dist/internal/session/decryption.d.ts +1 -1
  224. package/dist/internal/session/decryption.js +10 -10
  225. package/dist/internal/session/decryption.js.map +1 -1
  226. package/dist/internal/session/factory.d.ts.map +1 -1
  227. package/dist/internal/session/factory.js +3 -3
  228. package/dist/internal/session/factory.js.map +1 -1
  229. package/dist/internal/session/handshake.d.ts.map +1 -1
  230. package/dist/internal/session/handshake.js +3 -3
  231. package/dist/internal/session/handshake.js.map +1 -1
  232. package/dist/internal/session/ratchet.d.ts.map +1 -1
  233. package/dist/internal/session/ratchet.js +4 -4
  234. package/dist/internal/session/ratchet.js.map +1 -1
  235. package/dist/internal/session/types.d.ts +2 -2
  236. package/dist/internal/session/types.d.ts.map +1 -1
  237. package/dist/internal/session/validation.d.ts.map +1 -1
  238. package/dist/internal/session/validation.js +3 -3
  239. package/dist/internal/session/validation.js.map +1 -1
  240. package/dist/layers.d.ts +3 -3
  241. package/dist/layers.d.ts.map +1 -1
  242. package/dist/layers.js +7 -7
  243. package/dist/layers.js.map +1 -1
  244. package/dist/local/store/expo/adapter.d.ts +8 -8
  245. package/dist/local/store/expo/adapter.d.ts.map +1 -1
  246. package/dist/local/store/expo/adapter.js +7 -7
  247. package/dist/local/store/expo/adapter.js.map +1 -1
  248. package/dist/local/store/expo/database-key.d.ts +2 -2
  249. package/dist/local/store/expo/database-key.d.ts.map +1 -1
  250. package/dist/local/store/expo/database-key.js +5 -5
  251. package/dist/local/store/expo/database-key.js.map +1 -1
  252. package/dist/local/store/expo/db.d.ts +9 -9
  253. package/dist/local/store/expo/db.d.ts.map +1 -1
  254. package/dist/local/store/expo/db.js +2 -2
  255. package/dist/local/store/expo/db.js.map +1 -1
  256. package/dist/local/store/expo/index.d.ts +6 -6
  257. package/dist/local/store/expo/index.d.ts.map +1 -1
  258. package/dist/local/store/expo/index.js +3 -3
  259. package/dist/local/store/expo/index.js.map +1 -1
  260. package/dist/local/store/expo/key-storage.d.ts +1 -1
  261. package/dist/local/store/expo/key-storage.d.ts.map +1 -1
  262. package/dist/local/store/expo/key-storage.js +4 -4
  263. package/dist/local/store/expo/key-storage.js.map +1 -1
  264. package/dist/local/store/expo/secure-store-options.d.ts +1 -1
  265. package/dist/local/store/expo/secure-store-options.d.ts.map +1 -1
  266. package/dist/local/store/expo/secure-store-options.js +1 -1
  267. package/dist/local/store/expo/secure-store-options.js.map +1 -1
  268. package/dist/local/store/index.d.ts +9 -9
  269. package/dist/local/store/index.d.ts.map +1 -1
  270. package/dist/local/store/index.js +8 -8
  271. package/dist/local/store/index.js.map +1 -1
  272. package/dist/local/store/mock/adapter.d.ts +6 -6
  273. package/dist/local/store/mock/adapter.d.ts.map +1 -1
  274. package/dist/local/store/mock/adapter.js +2 -2
  275. package/dist/local/store/mock/adapter.js.map +1 -1
  276. package/dist/local/store/mock/index.d.ts +3 -3
  277. package/dist/local/store/mock/index.d.ts.map +1 -1
  278. package/dist/local/store/mock/index.js +3 -3
  279. package/dist/local/store/mock/index.js.map +1 -1
  280. package/dist/local/store/node/adapter.d.ts +4 -4
  281. package/dist/local/store/node/adapter.d.ts.map +1 -1
  282. package/dist/local/store/node/adapter.js +2 -2
  283. package/dist/local/store/node/adapter.js.map +1 -1
  284. package/dist/local/store/node/database.d.ts.map +1 -1
  285. package/dist/local/store/node/database.js +2 -2
  286. package/dist/local/store/node/database.js.map +1 -1
  287. package/dist/local/store/node/index.d.ts +4 -4
  288. package/dist/local/store/node/index.d.ts.map +1 -1
  289. package/dist/local/store/node/index.js +3 -3
  290. package/dist/local/store/node/index.js.map +1 -1
  291. package/dist/local/store/react-native/adapter.d.ts +5 -5
  292. package/dist/local/store/react-native/adapter.d.ts.map +1 -1
  293. package/dist/local/store/react-native/adapter.js +12 -12
  294. package/dist/local/store/react-native/adapter.js.map +1 -1
  295. package/dist/local/store/react-native/index.d.ts +4 -4
  296. package/dist/local/store/react-native/index.d.ts.map +1 -1
  297. package/dist/local/store/react-native/index.js +3 -3
  298. package/dist/local/store/react-native/index.js.map +1 -1
  299. package/dist/local/store/react-native/storage.d.ts +1 -1
  300. package/dist/local/store/web/adapter.d.ts +4 -4
  301. package/dist/local/store/web/adapter.d.ts.map +1 -1
  302. package/dist/local/store/web/adapter.js +7 -7
  303. package/dist/local/store/web/adapter.js.map +1 -1
  304. package/dist/local/store/web/index.d.ts +4 -4
  305. package/dist/local/store/web/index.d.ts.map +1 -1
  306. package/dist/local/store/web/index.js +3 -3
  307. package/dist/local/store/web/index.js.map +1 -1
  308. package/dist/local/vault/expo-secure-store.d.ts +2 -2
  309. package/dist/local/vault/expo-secure-store.d.ts.map +1 -1
  310. package/dist/local/vault/expo-secure-store.js +5 -5
  311. package/dist/local/vault/expo-secure-store.js.map +1 -1
  312. package/dist/local/vault/index.d.ts +2 -2
  313. package/dist/local/vault/index.d.ts.map +1 -1
  314. package/dist/local/vault/index.js +1 -1
  315. package/dist/local/vault/index.js.map +1 -1
  316. package/dist/logger.d.ts +3 -3
  317. package/dist/logger.d.ts.map +1 -1
  318. package/dist/logger.js +4 -4
  319. package/dist/logger.js.map +1 -1
  320. package/dist/media/index.d.ts +5 -5
  321. package/dist/media/index.d.ts.map +1 -1
  322. package/dist/profile/contact-state.d.ts.map +1 -1
  323. package/dist/profile/contact-state.js +2 -2
  324. package/dist/profile/contact-state.js.map +1 -1
  325. package/dist/profile/profile-key.d.ts.map +1 -1
  326. package/dist/profile/profile-key.js +2 -2
  327. package/dist/profile/profile-key.js.map +1 -1
  328. package/dist/profile/update-service.d.ts.map +1 -1
  329. package/dist/profile/update-service.js +2 -2
  330. package/dist/profile/update-service.js.map +1 -1
  331. package/dist/remote/object-store/convex-r2/storage.d.ts +2 -2
  332. package/dist/remote/object-store/convex-r2/storage.d.ts.map +1 -1
  333. package/dist/remote/object-store/index.d.ts +1 -1
  334. package/dist/remote/object-store/index.d.ts.map +1 -1
  335. package/dist/remote/object-store/s3/storage.d.ts +3 -3
  336. package/dist/remote/object-store/s3/storage.d.ts.map +1 -1
  337. package/dist/remote/object-store/s3/storage.js +1 -1
  338. package/dist/remote/object-store/types.d.ts +1 -1
  339. package/dist/remote/object-store/types.d.ts.map +1 -1
  340. package/dist/remote/relay/convex/group-server.d.ts +23 -21
  341. package/dist/remote/relay/convex/group-server.d.ts.map +1 -1
  342. package/dist/remote/relay/convex/group-server.js +49 -21
  343. package/dist/remote/relay/convex/group-server.js.map +1 -1
  344. package/dist/remote/relay/convex/index.d.ts +9 -9
  345. package/dist/remote/relay/convex/index.d.ts.map +1 -1
  346. package/dist/remote/relay/convex/index.js +5 -5
  347. package/dist/remote/relay/convex/index.js.map +1 -1
  348. package/dist/remote/relay/convex/relay.d.ts +26 -18
  349. package/dist/remote/relay/convex/relay.d.ts.map +1 -1
  350. package/dist/remote/relay/convex/relay.js +82 -23
  351. package/dist/remote/relay/convex/relay.js.map +1 -1
  352. package/dist/remote/relay/convex/server/index.d.ts +2 -0
  353. package/dist/remote/relay/convex/server/index.d.ts.map +1 -0
  354. package/dist/remote/relay/convex/server/index.js +2 -0
  355. package/dist/remote/relay/convex/server/index.js.map +1 -0
  356. package/dist/remote/relay/convex/server.d.ts +150 -0
  357. package/dist/remote/relay/convex/server.d.ts.map +1 -0
  358. package/dist/remote/relay/convex/server.js +506 -0
  359. package/dist/remote/relay/convex/server.js.map +1 -0
  360. package/dist/remote/relay/index.d.ts +7 -7
  361. package/dist/remote/relay/index.d.ts.map +1 -1
  362. package/dist/remote/relay/index.js +6 -6
  363. package/dist/remote/relay/index.js.map +1 -1
  364. package/dist/remote/relay/mock/adapter.d.ts +36 -18
  365. package/dist/remote/relay/mock/adapter.d.ts.map +1 -1
  366. package/dist/remote/relay/mock/adapter.js +75 -65
  367. package/dist/remote/relay/mock/adapter.js.map +1 -1
  368. package/dist/remote/relay/mock/failures.d.ts +1 -0
  369. package/dist/remote/relay/mock/failures.d.ts.map +1 -1
  370. package/dist/remote/relay/mock/failures.js +5 -0
  371. package/dist/remote/relay/mock/failures.js.map +1 -1
  372. package/dist/remote/relay/mock/group-server.d.ts +9 -0
  373. package/dist/remote/relay/mock/group-server.d.ts.map +1 -0
  374. package/dist/remote/relay/mock/group-server.js +9 -0
  375. package/dist/remote/relay/mock/group-server.js.map +1 -0
  376. package/dist/remote/relay/mock/index.d.ts +3 -3
  377. package/dist/remote/relay/mock/index.d.ts.map +1 -1
  378. package/dist/remote/relay/mock/index.js +3 -3
  379. package/dist/remote/relay/mock/index.js.map +1 -1
  380. package/dist/remote/relay/types.d.ts +56 -25
  381. package/dist/remote/relay/types.d.ts.map +1 -1
  382. package/dist/remote/relay/types.js +2 -2
  383. package/dist/types/api.d.ts +4 -4
  384. package/dist/types/api.d.ts.map +1 -1
  385. package/dist/types/messages.d.ts +1 -1
  386. package/dist/types/protocol-config.d.ts +17 -2
  387. package/dist/types/protocol-config.d.ts.map +1 -1
  388. package/dist/types/protocol-config.js +17 -2
  389. package/dist/types/protocol-config.js.map +1 -1
  390. package/dist/utils/retry.d.ts +2 -2
  391. package/dist/utils/retry.d.ts.map +1 -1
  392. package/dist/utils/retry.js +17 -0
  393. package/dist/utils/retry.js.map +1 -1
  394. package/docs/CLIENT_COMPOSITION.md +3 -3
  395. package/docs/DEVIATIONS.md +69 -50
  396. package/docs/GETTING_STARTED.md +3 -3
  397. package/docs/INTERFACES.md +22 -22
  398. package/docs/PACKAGE_SURFACE.md +15 -10
  399. package/docs/RECIPES.md +4 -4
  400. package/docs/api/classes/EndorsementManager.md +19 -1
  401. package/docs/api/classes/{SignalBlockingManager.md → SignalProtocolBlockingManager.md} +5 -5
  402. package/docs/api/classes/SignalProtocolClient.md +78 -78
  403. package/docs/api/functions/createDefaultSignalProtocolContentAdapter.md +13 -0
  404. package/docs/api/functions/{createDefaultSignalLogger.md → createDefaultSignalProtocolLogger.md} +5 -5
  405. package/docs/api/functions/createGroupId.md +1 -1
  406. package/docs/api/functions/decodeGroupTrustRoot.md +21 -0
  407. package/docs/api/functions/encodeGroupTrustRoot.md +28 -0
  408. package/docs/api/functions/extractGroupId.md +2 -2
  409. package/docs/api/functions/isGroupId.md +1 -1
  410. package/docs/api/functions/{resolveSignalLogger.md → resolveSignalProtocolLogger.md} +5 -5
  411. package/docs/api/interfaces/GroupTrustRoot.md +33 -0
  412. package/docs/api/interfaces/IProtocolStore.md +1 -1
  413. package/docs/api/interfaces/IRelayGroupServer.md +60 -0
  414. package/docs/api/interfaces/ISenderKeyStore.md +1 -1
  415. package/docs/api/interfaces/ISesameStore.md +1 -1
  416. package/docs/api/interfaces/ISignalProtocolClient.md +1 -1
  417. package/docs/api/interfaces/{ISignalLocalSecretVault.md → ISignalProtocolLocalSecretVault.md} +2 -2
  418. package/docs/api/interfaces/{ISignalLocalStore.md → ISignalProtocolLocalStore.md} +2 -2
  419. package/docs/api/interfaces/{ISignalRelayServer.md → ISignalProtocolRelayServer.md} +11 -3
  420. package/docs/api/interfaces/{InspectedSignalContent.md → InspectedSignalProtocolContent.md} +2 -2
  421. package/docs/api/interfaces/MLKEMBraidAgentState.md +1 -1
  422. package/docs/api/interfaces/MessageHeader.md +1 -1
  423. package/docs/api/interfaces/PreKeyMaintenanceStore.md +2 -2
  424. package/docs/api/interfaces/SealedSenderConfig.md +2 -2
  425. package/docs/api/interfaces/{SignalBlockingHooks.md → SignalProtocolBlockingHooks.md} +2 -2
  426. package/docs/api/interfaces/SignalProtocolBlockingManagerOptions.md +31 -0
  427. package/docs/api/interfaces/{SignalBlockingMirror.md → SignalProtocolBlockingMirror.md} +2 -2
  428. package/docs/api/interfaces/{SignalBlockingStore.md → SignalProtocolBlockingStore.md} +2 -2
  429. package/docs/api/interfaces/SignalProtocolClientAdapterConfig.md +3 -3
  430. package/docs/api/interfaces/SignalProtocolClientCompositionOptions.md +69 -31
  431. package/docs/api/interfaces/SignalProtocolClientConfig.md +93 -37
  432. package/docs/api/interfaces/SignalProtocolClientHooks.md +1 -1
  433. package/docs/api/interfaces/SignalProtocolClientIdentityConfig.md +16 -0
  434. package/docs/api/interfaces/SignalProtocolClientMediaConfig.md +2 -2
  435. package/docs/api/interfaces/{SignalContentAdapter.md → SignalProtocolContentAdapter.md} +4 -4
  436. package/docs/api/interfaces/{SignalRemoteObjectStore.md → SignalProtocolRemoteObjectStore.md} +2 -2
  437. package/docs/api/namespaces/blocking/README.md +10 -10
  438. package/docs/api/namespaces/keys/functions/generateKemOneTimePreKeys.md +1 -1
  439. package/docs/api/namespaces/media/interfaces/DeleteMediaAttachmentOptions.md +1 -1
  440. package/docs/api/namespaces/media/interfaces/ExecuteMediaAttachmentJobOptions.md +1 -1
  441. package/docs/api/namespaces/media/interfaces/PrepareMediaAttachmentUploadOptions.md +1 -1
  442. package/docs/api/namespaces/media/interfaces/ResolveMediaAttachmentOptions.md +1 -1
  443. package/docs/api/type-aliases/GroupId.md +2 -2
  444. package/docs/api/variables/GROUP_ID_PREFIX.md +11 -0
  445. package/docs/api/variables/GROUP_TRUST_ROOT_VERSION.md +11 -0
  446. package/docs/api/variables/MAX_RECEIVER_CHAINS.md +1 -1
  447. package/docs/api/variables/ONE_TIME_PREKEY_BATCH_SIZE.md +1 -1
  448. package/docs/api/variables/{defaultSignalLogger.md → defaultSignalProtocolLogger.md} +5 -5
  449. package/files/README.md +1 -1
  450. package/groups/README.md +16 -5
  451. package/local/store/README.md +10 -10
  452. package/local/store/expo/README.md +5 -5
  453. package/local/store/mock/README.md +1 -1
  454. package/local/store/node/README.md +1 -1
  455. package/local/store/react-native/README.md +1 -1
  456. package/local/store/web/README.md +1 -1
  457. package/local/vault/README.md +3 -3
  458. package/package.json +13 -2
  459. package/remote/README.md +19 -19
  460. package/remote/object-store/README.md +3 -3
  461. package/remote/object-store/convex-r2/README.md +1 -1
  462. package/remote/object-store/s3/README.md +1 -1
  463. package/remote/relay/README.md +2 -2
  464. package/remote/relay/convex/README.md +10 -4
  465. package/remote/relay/convex/server/README.md +146 -0
  466. package/remote/relay/mock/README.md +1 -1
  467. package/scripts/oe-groups.mjs +142 -0
  468. package/types/README.md +1 -1
  469. package/dist/internal/groups-v2/access-control.d.ts +0 -108
  470. package/dist/internal/groups-v2/access-control.d.ts.map +0 -1
  471. package/dist/internal/groups-v2/access-control.js +0 -191
  472. package/dist/internal/groups-v2/access-control.js.map +0 -1
  473. package/dist/internal/groups-v2/change-actions.d.ts +0 -40
  474. package/dist/internal/groups-v2/change-actions.d.ts.map +0 -1
  475. package/dist/internal/groups-v2/change-actions.js +0 -363
  476. package/dist/internal/groups-v2/change-actions.js.map +0 -1
  477. package/dist/internal/groups-v2/encrypted-state.d.ts.map +0 -1
  478. package/dist/internal/groups-v2/encrypted-state.js.map +0 -1
  479. package/dist/internal/groups-v2/index.d.ts +0 -19
  480. package/dist/internal/groups-v2/index.d.ts.map +0 -1
  481. package/dist/internal/groups-v2/index.js +0 -11
  482. package/dist/internal/groups-v2/index.js.map +0 -1
  483. package/dist/internal/groups-v2/invite-link.d.ts.map +0 -1
  484. package/dist/internal/groups-v2/invite-link.js.map +0 -1
  485. package/dist/internal/groups-v2/manager.d.ts.map +0 -1
  486. package/dist/internal/groups-v2/manager.js +0 -1095
  487. package/dist/internal/groups-v2/manager.js.map +0 -1
  488. package/dist/internal/groups-v2/types.d.ts.map +0 -1
  489. package/dist/internal/groups-v2/types.js.map +0 -1
  490. package/docs/api/functions/createDefaultSignalContentAdapter.md +0 -13
  491. package/docs/api/interfaces/SignalBlockingManagerOptions.md +0 -31
  492. package/docs/api/variables/GROUP_V2_PREFIX.md +0 -11
  493. /package/dist/internal/{groups-v2 → groups}/invite-link.d.ts +0 -0
  494. /package/dist/internal/{groups-v2 → groups}/invite-link.js +0 -0
@@ -0,0 +1,827 @@
1
+ /**
2
+ * Group Change Application
3
+ *
4
+ * Pure functions for applying DecryptedGroupChange operations to DecryptedGroup state.
5
+ *
6
+ * Operations are applied in the normative order from the group-system
7
+ * specification: deletions, bans, promotions, additions, modifications,
8
+ * then attributes and access control.
9
+ *
10
+ * @module change-actions
11
+ */
12
+ import { AccessRequired, EnabledState, emptyGroupChange, } from './types.js';
13
+ import { constantTimeEqual as bytesEqual } from '../crypto/utils.js';
14
+ import { SERVICE_ID_ACI, SERVICE_ID_PNI, isNilUuid, } from '../protocol/zk/groups/uid-struct.js';
15
+ import { isInviteLinkAccessRequirement, isRoleAccessRequirement, isStoredMemberRole, } from './access-control.js';
16
+ function nilUuidError(value, label, errors) {
17
+ if (isNilUuid(value)) {
18
+ errors.push(`${label} uses the reserved nil UUID`);
19
+ }
20
+ }
21
+ function nilServiceIdError(value, label, errors) {
22
+ if (value.length === 17 && isNilUuid(value.subarray(1))) {
23
+ errors.push(`${label} uses the reserved nil UUID`);
24
+ }
25
+ }
26
+ /** Validate C6's non-nil identifier invariant over decrypted group state. */
27
+ export function validateGroupIdentifiers(group) {
28
+ const errors = [];
29
+ for (const [index, member] of group.members.entries()) {
30
+ nilUuidError(member.aciBytes, `members[${index}].aciBytes`, errors);
31
+ if (member.pniBytes.length > 0) {
32
+ nilUuidError(member.pniBytes, `members[${index}].pniBytes`, errors);
33
+ }
34
+ }
35
+ for (const [index, member] of group.pendingMembers.entries()) {
36
+ nilServiceIdError(member.serviceIdBytes, `pendingMembers[${index}].serviceIdBytes`, errors);
37
+ nilUuidError(member.addedByAci, `pendingMembers[${index}].addedByAci`, errors);
38
+ }
39
+ for (const [index, member] of group.requestingMembers.entries()) {
40
+ nilUuidError(member.aciBytes, `requestingMembers[${index}].aciBytes`, errors);
41
+ }
42
+ for (const [index, member] of group.bannedMembers.entries()) {
43
+ nilServiceIdError(member.serviceIdBytes, `bannedMembers[${index}].serviceIdBytes`, errors);
44
+ }
45
+ return errors;
46
+ }
47
+ /** Validate §6.7's field-specific access-control domains. */
48
+ export function validateGroupAccessControl(group) {
49
+ const errors = [];
50
+ if (!isRoleAccessRequirement(group.accessControl.attributes)) {
51
+ errors.push('accessControl.attributes is outside its §6.7 domain');
52
+ }
53
+ if (!isRoleAccessRequirement(group.accessControl.members)) {
54
+ errors.push('accessControl.members is outside its §6.7 domain');
55
+ }
56
+ if (!isRoleAccessRequirement(group.accessControl.memberLabel)) {
57
+ errors.push('accessControl.memberLabel is outside its §6.7 domain');
58
+ }
59
+ if (!isInviteLinkAccessRequirement(group.accessControl.addFromInviteLink)) {
60
+ errors.push('accessControl.addFromInviteLink is outside its §6.7 domain');
61
+ }
62
+ return errors;
63
+ }
64
+ /** Validate §6.8's stored member and pending-member role domain. */
65
+ export function validateGroupMemberRoles(group) {
66
+ const errors = [];
67
+ for (const [index, member] of group.members.entries()) {
68
+ if (!isStoredMemberRole(member.role)) {
69
+ errors.push(`members[${index}].role is outside its §6.8 domain`);
70
+ }
71
+ }
72
+ for (const [index, member] of group.pendingMembers.entries()) {
73
+ if (!isStoredMemberRole(member.role)) {
74
+ errors.push(`pendingMembers[${index}].role is outside its §6.8 domain`);
75
+ }
76
+ }
77
+ return errors;
78
+ }
79
+ function isCanonicalTimestamp(value) {
80
+ return Number.isSafeInteger(value) && value >= 0;
81
+ }
82
+ /** Validate §7.8's plaintext stored-state domains. */
83
+ export function validateGroupCanonicalFields(group) {
84
+ const errors = [];
85
+ if (!Number.isSafeInteger(group.revision) || group.revision < 0) {
86
+ errors.push('revision must be a non-negative safe integer');
87
+ }
88
+ if (group.isAnnouncementGroup !== EnabledState.ENABLED &&
89
+ group.isAnnouncementGroup !== EnabledState.DISABLED) {
90
+ errors.push('isAnnouncementGroup is outside its §7.8 domain');
91
+ }
92
+ if (typeof group.terminated !== 'boolean') {
93
+ errors.push('terminated must be a boolean');
94
+ }
95
+ if (group.inviteLinkPassword.length !== 0 &&
96
+ group.inviteLinkPassword.length !== 16) {
97
+ errors.push('inviteLinkPassword must be empty or exactly 16 bytes');
98
+ }
99
+ for (const [index, member] of group.members.entries()) {
100
+ if (!Number.isSafeInteger(member.joinedAtRevision) ||
101
+ member.joinedAtRevision < 0 ||
102
+ member.joinedAtRevision > group.revision) {
103
+ errors.push(`members[${index}].joinedAtRevision is outside its §7.8 domain`);
104
+ }
105
+ }
106
+ for (const [label, entries] of [
107
+ ['pendingMembers', group.pendingMembers],
108
+ ['requestingMembers', group.requestingMembers],
109
+ ['bannedMembers', group.bannedMembers],
110
+ ]) {
111
+ for (const [index, entry] of entries.entries()) {
112
+ if (!isCanonicalTimestamp(entry.timestamp)) {
113
+ errors.push(`${label}[${index}].timestamp is outside its §7.8 domain`);
114
+ }
115
+ }
116
+ }
117
+ return errors;
118
+ }
119
+ /** Validate C6's non-nil identifier invariant over a decrypted change. */
120
+ export function validateChangeIdentifiers(change) {
121
+ const errors = [];
122
+ nilServiceIdError(change.editorServiceIdBytes, 'editorServiceIdBytes', errors);
123
+ const members = [
124
+ ['newMembers', change.newMembers],
125
+ ['modifiedProfileKeys', change.modifiedProfileKeys],
126
+ ['promotePendingMembers', change.promotePendingMembers],
127
+ ['promotePendingPniAciMembers', change.promotePendingPniAciMembers],
128
+ ];
129
+ for (const [label, entries] of members) {
130
+ for (const [index, member] of entries.entries()) {
131
+ nilUuidError(member.aciBytes, `${label}[${index}].aciBytes`, errors);
132
+ if (member.pniBytes !== undefined && member.pniBytes.length > 0) {
133
+ nilUuidError(member.pniBytes, `${label}[${index}].pniBytes`, errors);
134
+ }
135
+ }
136
+ }
137
+ for (const [index, aciBytes] of change.deleteMembers.entries()) {
138
+ nilUuidError(aciBytes, `deleteMembers[${index}]`, errors);
139
+ }
140
+ for (const [index, member] of change.modifyMemberRoles.entries()) {
141
+ nilUuidError(member.aciBytes, `modifyMemberRoles[${index}].aciBytes`, errors);
142
+ }
143
+ for (const [index, member] of change.newPendingMembers.entries()) {
144
+ nilServiceIdError(member.serviceIdBytes, `newPendingMembers[${index}].serviceIdBytes`, errors);
145
+ if (member.addedByAci !== undefined) {
146
+ nilUuidError(member.addedByAci, `newPendingMembers[${index}].addedByAci`, errors);
147
+ }
148
+ }
149
+ for (const [index, member] of change.deletePendingMembers.entries()) {
150
+ nilServiceIdError(member.serviceIdBytes, `deletePendingMembers[${index}].serviceIdBytes`, errors);
151
+ }
152
+ for (const [index, member] of change.newRequestingMembers.entries()) {
153
+ nilUuidError(member.aciBytes, `newRequestingMembers[${index}].aciBytes`, errors);
154
+ }
155
+ for (const [index, aciBytes] of change.deleteRequestingMembers.entries()) {
156
+ nilUuidError(aciBytes, `deleteRequestingMembers[${index}]`, errors);
157
+ }
158
+ for (const [index, member] of change.promoteRequestingMembers.entries()) {
159
+ nilUuidError(member.aciBytes, `promoteRequestingMembers[${index}].aciBytes`, errors);
160
+ }
161
+ const banned = [
162
+ ['newBannedMembers', change.newBannedMembers],
163
+ ['deleteBannedMembers', change.deleteBannedMembers],
164
+ ];
165
+ for (const [label, entries] of banned) {
166
+ for (const [index, member] of entries.entries()) {
167
+ nilServiceIdError(member.serviceIdBytes, `${label}[${index}].serviceIdBytes`, errors);
168
+ }
169
+ }
170
+ for (const [index, member] of change.modifyMemberLabels.entries()) {
171
+ nilUuidError(member.aciBytes, `modifyMemberLabels[${index}].aciBytes`, errors);
172
+ }
173
+ return errors;
174
+ }
175
+ /** Validate access-control values introduced by a change under §6.7. */
176
+ export function validateChangeAccessControl(change) {
177
+ const errors = [];
178
+ for (const [label, value] of [
179
+ ['newAttributeAccess', change.newAttributeAccess],
180
+ ['newMemberAccess', change.newMemberAccess],
181
+ ['newMemberLabelAccess', change.newMemberLabelAccess],
182
+ ]) {
183
+ if (value !== undefined && !isRoleAccessRequirement(value)) {
184
+ errors.push(`${label} is outside its §6.7 domain`);
185
+ }
186
+ }
187
+ if (change.newInviteLinkAccess !== undefined &&
188
+ !isInviteLinkAccessRequirement(change.newInviteLinkAccess)) {
189
+ errors.push('newInviteLinkAccess is outside its §6.7 domain');
190
+ }
191
+ return errors;
192
+ }
193
+ /** Validate every role-bearing action field under §6.8. */
194
+ export function validateChangeMemberRoles(change) {
195
+ const errors = [];
196
+ for (const [label, members] of [
197
+ ['newMembers', change.newMembers],
198
+ ['promotePendingMembers', change.promotePendingMembers],
199
+ ['promotePendingPniAciMembers', change.promotePendingPniAciMembers],
200
+ ]) {
201
+ for (const [index, member] of members.entries()) {
202
+ if (member.role !== undefined && !isStoredMemberRole(member.role)) {
203
+ errors.push(`${label}[${index}].role is outside its §6.8 domain`);
204
+ }
205
+ }
206
+ }
207
+ for (const [index, member] of change.newPendingMembers.entries()) {
208
+ if (!isStoredMemberRole(member.role)) {
209
+ errors.push(`newPendingMembers[${index}].role is outside its §6.8 domain`);
210
+ }
211
+ }
212
+ for (const [index, member] of change.modifyMemberRoles.entries()) {
213
+ if (!isStoredMemberRole(member.role)) {
214
+ errors.push(`modifyMemberRoles[${index}].role is outside its §6.8 domain`);
215
+ }
216
+ }
217
+ for (const [index, member] of change.promoteRequestingMembers.entries()) {
218
+ if (!isStoredMemberRole(member.role)) {
219
+ errors.push(`promoteRequestingMembers[${index}].role is outside its §6.8 domain`);
220
+ }
221
+ }
222
+ return errors;
223
+ }
224
+ /** Validate §7.8's derived-field presence and plaintext action domains. */
225
+ export function validateChangeCanonicalFields(state, change, form) {
226
+ const errors = [];
227
+ const canonical = form === 'canonical';
228
+ const expectDerived = (present, label) => {
229
+ if (present !== canonical) {
230
+ errors.push(`${label} must be ${canonical ? 'present' : 'absent'} in ${form} form`);
231
+ }
232
+ };
233
+ if (!Number.isSafeInteger(change.revision) || change.revision < 1) {
234
+ errors.push('change revision must be a positive safe integer');
235
+ }
236
+ if (change.newIsAnnouncementGroup !== undefined &&
237
+ change.newIsAnnouncementGroup !== EnabledState.ENABLED &&
238
+ change.newIsAnnouncementGroup !== EnabledState.DISABLED) {
239
+ errors.push('newIsAnnouncementGroup is outside its §7.8 domain');
240
+ }
241
+ const { newInviteLinkPassword: actionPw } = change;
242
+ if (actionPw !== undefined && actionPw.length !== 16) {
243
+ errors.push('newInviteLinkPassword must be exactly 16 bytes');
244
+ }
245
+ for (const [index, member] of change.newMembers.entries()) {
246
+ expectDerived(member.joinedAtRevision !== undefined, `newMembers[${index}].joinedAtRevision`);
247
+ if (canonical &&
248
+ member.joinedAtRevision !== change.revision) {
249
+ errors.push(`newMembers[${index}].joinedAtRevision must equal the change revision`);
250
+ }
251
+ }
252
+ const promotions = [
253
+ [
254
+ 'promotePendingMembers',
255
+ change.promotePendingMembers,
256
+ (index) => {
257
+ const aci = change.promotePendingMembers[index].aciBytes;
258
+ return state.pendingMembers.find((member) => member.serviceIdBytes[0] === SERVICE_ID_ACI &&
259
+ bytesEqual(member.serviceIdBytes.subarray(1), aci))?.role;
260
+ },
261
+ ],
262
+ [
263
+ 'promotePendingPniAciMembers',
264
+ change.promotePendingPniAciMembers,
265
+ (index) => {
266
+ const pni = change.promotePendingPniAciMembers[index].pniBytes;
267
+ return state.pendingMembers.find((member) => member.serviceIdBytes[0] === SERVICE_ID_PNI &&
268
+ bytesEqual(member.serviceIdBytes.subarray(1), pni))?.role;
269
+ },
270
+ ],
271
+ ];
272
+ for (const [label, entries, expectedRole] of promotions) {
273
+ for (const [index, promotion] of entries.entries()) {
274
+ expectDerived(promotion.role !== undefined, `${label}[${index}].role`);
275
+ expectDerived(promotion.joinedAtRevision !== undefined, `${label}[${index}].joinedAtRevision`);
276
+ if (canonical && promotion.role !== expectedRole(index)) {
277
+ errors.push(`${label}[${index}].role must equal the pending role`);
278
+ }
279
+ if (canonical &&
280
+ promotion.joinedAtRevision !== change.revision) {
281
+ errors.push(`${label}[${index}].joinedAtRevision must equal the change revision`);
282
+ }
283
+ }
284
+ }
285
+ for (const [index, pending] of change.newPendingMembers.entries()) {
286
+ expectDerived(pending.addedByAci !== undefined, `newPendingMembers[${index}].addedByAci`);
287
+ expectDerived(pending.timestamp !== undefined, `newPendingMembers[${index}].timestamp`);
288
+ if (canonical) {
289
+ if (change.editorServiceIdBytes[0] !== SERVICE_ID_ACI ||
290
+ !bytesEqual(pending.addedByAci, change.editorServiceIdBytes.subarray(1))) {
291
+ errors.push(`newPendingMembers[${index}].addedByAci must equal sourceUserId`);
292
+ }
293
+ if (!isCanonicalTimestamp(pending.timestamp)) {
294
+ errors.push(`newPendingMembers[${index}].timestamp is outside its §7.8 domain`);
295
+ }
296
+ }
297
+ }
298
+ for (const [label, entries] of [
299
+ ['newRequestingMembers', change.newRequestingMembers],
300
+ ['newBannedMembers', change.newBannedMembers],
301
+ ]) {
302
+ for (const [index, entry] of entries.entries()) {
303
+ expectDerived(entry.timestamp !== undefined, `${label}[${index}].timestamp`);
304
+ if (canonical && !isCanonicalTimestamp(entry.timestamp)) {
305
+ errors.push(`${label}[${index}].timestamp is outside its §7.8 domain`);
306
+ }
307
+ }
308
+ }
309
+ return errors;
310
+ }
311
+ function cloneGroup(group) {
312
+ return {
313
+ ...group,
314
+ members: group.members.map((m) => ({ ...m })),
315
+ pendingMembers: group.pendingMembers.map((m) => ({ ...m })),
316
+ requestingMembers: group.requestingMembers.map((m) => ({ ...m })),
317
+ bannedMembers: group.bannedMembers.map((m) => ({ ...m })),
318
+ accessControl: { ...group.accessControl },
319
+ };
320
+ }
321
+ function pendingTargetMatches(member, target) {
322
+ return ((target.serviceIdCipherText.length > 0 &&
323
+ bytesEqual(member.serviceIdCipherText, target.serviceIdCipherText)) ||
324
+ (member.quarantined !== true &&
325
+ bytesEqual(member.serviceIdBytes, target.serviceIdBytes)));
326
+ }
327
+ function requestingTargetMatches(member, target) {
328
+ return target.length === 65
329
+ ? member.aciCipherText !== undefined &&
330
+ bytesEqual(member.aciCipherText, target)
331
+ : member.quarantined !== true && bytesEqual(member.aciBytes, target);
332
+ }
333
+ function bannedTargetMatches(member, target) {
334
+ return target.serviceIdCipherText !== undefined
335
+ ? member.serviceIdCipherText !== undefined &&
336
+ bytesEqual(member.serviceIdCipherText, target.serviceIdCipherText)
337
+ : member.quarantined !== true &&
338
+ bytesEqual(member.serviceIdBytes, target.serviceIdBytes);
339
+ }
340
+ /**
341
+ * Apply a DecryptedGroupChange to a DecryptedGroup state.
342
+ *
343
+ * This is a pure function that returns a new state object without mutating the input.
344
+ * Changes are applied in the normative order from §7.4.
345
+ *
346
+ * @param state - Current group state
347
+ * @param change - Change to apply
348
+ * @returns New group state with changes applied
349
+ * @throws Error if revision is not sequential
350
+ */
351
+ export function applyGroupChange(state, change) {
352
+ if (state.terminated) {
353
+ throw new Error('INVALID_CHANGE: Group is terminated');
354
+ }
355
+ if (change.revision !== state.revision + 1) {
356
+ throw new Error(`Invalid revision: expected ${state.revision + 1}, got ${change.revision}`);
357
+ }
358
+ const newState = cloneGroup(state);
359
+ applyDeletions(newState, change);
360
+ applyBans(newState, change);
361
+ applyPromotions(newState, change);
362
+ applyAdditions(newState, change);
363
+ applyMemberModifications(newState, change);
364
+ applyAttributesAndAccessControl(newState, change);
365
+ applyTermination(newState, change);
366
+ newState.revision = change.revision;
367
+ return newState;
368
+ }
369
+ function applyTermination(state, change) {
370
+ if (change.terminate !== undefined) {
371
+ if (change.terminate !== true) {
372
+ throw new Error('INVALID_CHANGE: Termination action must be true');
373
+ }
374
+ state.terminated = true;
375
+ }
376
+ }
377
+ function applyDeletions(state, change) {
378
+ for (const removal of change.deletePendingMembers) {
379
+ if (!state.pendingMembers.some((member) => pendingTargetMatches(member, removal))) {
380
+ throw new Error('INVALID_CHANGE: Attempted to delete non-existent pending member');
381
+ }
382
+ state.pendingMembers = state.pendingMembers.filter((member) => !pendingTargetMatches(member, removal));
383
+ }
384
+ for (const target of change.deleteRequestingMembers) {
385
+ if (!state.requestingMembers.some((member) => requestingTargetMatches(member, target))) {
386
+ throw new Error('INVALID_CHANGE: Attempted to delete non-existent requesting member');
387
+ }
388
+ state.requestingMembers = state.requestingMembers.filter((member) => !requestingTargetMatches(member, target));
389
+ }
390
+ for (const removal of change.deleteBannedMembers) {
391
+ if (!state.bannedMembers.some((member) => bannedTargetMatches(member, removal))) {
392
+ throw new Error('INVALID_CHANGE: Attempted to unban non-existent banned member');
393
+ }
394
+ state.bannedMembers = state.bannedMembers.filter((member) => !bannedTargetMatches(member, removal));
395
+ }
396
+ for (const aciBytes of change.deleteMembers) {
397
+ if (!state.members.some((member) => bytesEqual(member.aciBytes, aciBytes))) {
398
+ throw new Error('INVALID_CHANGE: Attempted to delete non-existent member');
399
+ }
400
+ state.members = state.members.filter((member) => !bytesEqual(member.aciBytes, aciBytes));
401
+ }
402
+ }
403
+ function applyBans(state, change) {
404
+ for (const banned of change.newBannedMembers) {
405
+ if (state.bannedMembers.some((member) => banned.serviceIdCipherText !== undefined
406
+ ? member.serviceIdCipherText !== undefined &&
407
+ bytesEqual(member.serviceIdCipherText, banned.serviceIdCipherText)
408
+ : member.quarantined !== true &&
409
+ bytesEqual(member.serviceIdBytes, banned.serviceIdBytes))) {
410
+ throw new Error('INVALID_CHANGE: Attempted to ban already-banned member');
411
+ }
412
+ state.bannedMembers = [
413
+ ...state.bannedMembers,
414
+ {
415
+ serviceIdBytes: banned.serviceIdBytes,
416
+ timestamp: banned.timestamp,
417
+ ...(banned.serviceIdCipherText === undefined
418
+ ? {}
419
+ : {
420
+ serviceIdCipherText: banned.serviceIdCipherText,
421
+ quarantined: true,
422
+ }),
423
+ },
424
+ ];
425
+ }
426
+ }
427
+ function assertMemberDestinationAvailable(state, aciBytes, errorMessage) {
428
+ if (state.members.some((member) => bytesEqual(member.aciBytes, aciBytes))) {
429
+ throw new Error(`INVALID_CHANGE: ${errorMessage}`);
430
+ }
431
+ }
432
+ function memberFromPromotion(promotion, role, revision) {
433
+ return {
434
+ aciBytes: promotion.aciBytes,
435
+ role,
436
+ profileKey: promotion.profileKey,
437
+ joinedAtRevision: revision,
438
+ pniBytes: new Uint8Array(0),
439
+ labelEmoji: '',
440
+ labelString: '',
441
+ };
442
+ }
443
+ function applyPromotions(state, change) {
444
+ for (const promotion of change.promotePendingMembers) {
445
+ if (promotion.aciBytes.length !== 16) {
446
+ throw new Error(`INVALID_CHANGE: Pending promotion ACI must be 16 bytes, got ${promotion.aciBytes.length}`);
447
+ }
448
+ assertMemberDestinationAvailable(state, promotion.aciBytes, 'Attempted to promote pending member who is already a member');
449
+ const pendingServiceIdBytes = new Uint8Array([SERVICE_ID_ACI, ...promotion.aciBytes]);
450
+ const pendingIndex = state.pendingMembers.findIndex((member) => bytesEqual(member.serviceIdBytes, pendingServiceIdBytes));
451
+ if (pendingIndex === -1) {
452
+ throw new Error('INVALID_CHANGE: Attempted to promote non-existent pending member');
453
+ }
454
+ const pending = state.pendingMembers[pendingIndex];
455
+ state.pendingMembers = state.pendingMembers.filter((_, index) => index !== pendingIndex);
456
+ state.members = [
457
+ ...state.members,
458
+ memberFromPromotion(promotion, pending.role, change.revision),
459
+ ];
460
+ }
461
+ for (const promotion of change.promotePendingPniAciMembers) {
462
+ if (promotion.aciBytes.length !== 16) {
463
+ throw new Error(`INVALID_CHANGE: Pending PNI promotion ACI must be 16 bytes, got ${promotion.aciBytes.length}`);
464
+ }
465
+ if (promotion.pniBytes.length !== 16) {
466
+ throw new Error(`INVALID_CHANGE: Pending promotion PNI must be 16 bytes, got ${promotion.pniBytes.length}`);
467
+ }
468
+ assertMemberDestinationAvailable(state, promotion.aciBytes, 'Attempted to promote PNI/ACI member who is already a member');
469
+ const pendingServiceIdBytes = new Uint8Array([SERVICE_ID_PNI, ...promotion.pniBytes]);
470
+ const pendingIndex = state.pendingMembers.findIndex((member) => bytesEqual(member.serviceIdBytes, pendingServiceIdBytes));
471
+ if (pendingIndex === -1) {
472
+ throw new Error('INVALID_CHANGE: Attempted to promote PNI/ACI member not in pending list');
473
+ }
474
+ const pending = state.pendingMembers[pendingIndex];
475
+ const aciServiceIdBytes = new Uint8Array([
476
+ SERVICE_ID_ACI,
477
+ ...promotion.aciBytes,
478
+ ]);
479
+ const aciPending = state.pendingMembers.find((member) => bytesEqual(member.serviceIdBytes, aciServiceIdBytes));
480
+ if (aciPending && aciPending.role !== pending.role) {
481
+ throw new Error('INVALID_CHANGE: PNI-to-ACI promotion cannot consume pending aliases with different roles');
482
+ }
483
+ state.pendingMembers = state.pendingMembers.filter((member, index) => index !== pendingIndex &&
484
+ !bytesEqual(member.serviceIdBytes, aciServiceIdBytes));
485
+ state.members = [
486
+ ...state.members,
487
+ memberFromPromotion(promotion, pending.role, change.revision),
488
+ ];
489
+ }
490
+ for (const approval of change.promoteRequestingMembers) {
491
+ assertMemberDestinationAvailable(state, approval.aciBytes, 'Attempted to promote requesting member who is already a member');
492
+ const requestingIndex = state.requestingMembers.findIndex((member) => bytesEqual(member.aciBytes, approval.aciBytes));
493
+ if (requestingIndex === -1) {
494
+ throw new Error('INVALID_CHANGE: Attempted to promote non-existent requesting member');
495
+ }
496
+ const requestingMember = state.requestingMembers[requestingIndex];
497
+ state.requestingMembers = state.requestingMembers.filter((_, index) => index !== requestingIndex);
498
+ state.members = [
499
+ ...state.members,
500
+ {
501
+ aciBytes: approval.aciBytes,
502
+ role: approval.role,
503
+ profileKey: requestingMember.profileKey,
504
+ joinedAtRevision: change.revision,
505
+ pniBytes: new Uint8Array(0),
506
+ labelEmoji: '',
507
+ labelString: '',
508
+ },
509
+ ];
510
+ }
511
+ }
512
+ function applyAdditions(state, change) {
513
+ for (const member of change.newMembers) {
514
+ assertMemberDestinationAvailable(state, member.aciBytes, 'Attempted to add existing member');
515
+ state.members = [
516
+ ...state.members,
517
+ {
518
+ aciBytes: member.aciBytes,
519
+ role: member.role,
520
+ profileKey: member.profileKey,
521
+ joinedAtRevision: member.joinedAtRevision,
522
+ pniBytes: new Uint8Array(0),
523
+ labelEmoji: '',
524
+ labelString: '',
525
+ },
526
+ ];
527
+ }
528
+ for (const pending of change.newPendingMembers) {
529
+ if (state.pendingMembers.some((member) => pending.serviceIdCipherText !== undefined &&
530
+ pending.quarantined === true
531
+ ? bytesEqual(member.serviceIdCipherText, pending.serviceIdCipherText)
532
+ : member.quarantined !== true &&
533
+ bytesEqual(member.serviceIdBytes, pending.serviceIdBytes))) {
534
+ throw new Error('INVALID_CHANGE: Attempted to add existing pending member');
535
+ }
536
+ state.pendingMembers = [
537
+ ...state.pendingMembers,
538
+ {
539
+ serviceIdBytes: pending.serviceIdBytes,
540
+ role: pending.role,
541
+ addedByAci: pending.addedByAci,
542
+ timestamp: pending.timestamp,
543
+ serviceIdCipherText: pending.serviceIdCipherText ?? new Uint8Array(0),
544
+ ...(pending.quarantined === true
545
+ ? { quarantined: true }
546
+ : {}),
547
+ },
548
+ ];
549
+ }
550
+ for (const requesting of change.newRequestingMembers) {
551
+ if (state.requestingMembers.some((member) => requesting.quarantined === true &&
552
+ requesting.aciCipherText !== undefined
553
+ ? member.aciCipherText !== undefined &&
554
+ bytesEqual(member.aciCipherText, requesting.aciCipherText)
555
+ : member.quarantined !== true &&
556
+ bytesEqual(member.aciBytes, requesting.aciBytes))) {
557
+ throw new Error('INVALID_CHANGE: Attempted to add existing requesting member');
558
+ }
559
+ state.requestingMembers = [
560
+ ...state.requestingMembers,
561
+ {
562
+ aciBytes: requesting.aciBytes,
563
+ profileKey: requesting.profileKey,
564
+ timestamp: requesting.timestamp,
565
+ ...(requesting.quarantined === true
566
+ ? {
567
+ aciCipherText: requesting.aciCipherText,
568
+ profileKeyCipherText: requesting.profileKeyCipherText,
569
+ quarantined: true,
570
+ }
571
+ : {}),
572
+ },
573
+ ];
574
+ }
575
+ }
576
+ function applyMemberModifications(state, change) {
577
+ for (const modification of change.modifyMemberRoles) {
578
+ const memberIndex = state.members.findIndex((member) => bytesEqual(member.aciBytes, modification.aciBytes));
579
+ if (memberIndex !== -1) {
580
+ state.members[memberIndex] = {
581
+ ...state.members[memberIndex],
582
+ role: modification.role,
583
+ };
584
+ }
585
+ else {
586
+ throw new Error('INVALID_CHANGE: Attempted to modify role of non-existent member');
587
+ }
588
+ }
589
+ for (const modification of change.modifyMemberLabels) {
590
+ const memberIndex = state.members.findIndex((member) => bytesEqual(member.aciBytes, modification.aciBytes));
591
+ if (memberIndex !== -1) {
592
+ state.members[memberIndex] = {
593
+ ...state.members[memberIndex],
594
+ labelEmoji: modification.labelEmoji ?? '',
595
+ labelString: modification.labelString ?? '',
596
+ };
597
+ }
598
+ else {
599
+ throw new Error('INVALID_CHANGE: Attempted to modify labels of non-existent member');
600
+ }
601
+ }
602
+ for (const modification of change.modifiedProfileKeys) {
603
+ const memberIndex = state.members.findIndex((member) => bytesEqual(member.aciBytes, modification.aciBytes));
604
+ if (memberIndex !== -1) {
605
+ state.members[memberIndex] = {
606
+ ...state.members[memberIndex],
607
+ profileKey: modification.profileKey,
608
+ };
609
+ }
610
+ else {
611
+ throw new Error('INVALID_CHANGE: Attempted to modify profile key of non-existent member');
612
+ }
613
+ }
614
+ }
615
+ function applyAttributesAndAccessControl(state, change) {
616
+ if (change.newTitle !== undefined)
617
+ state.title = change.newTitle.value;
618
+ if (change.newAvatar !== undefined)
619
+ state.avatar = change.newAvatar.value;
620
+ if (change.newTimer !== undefined)
621
+ state.disappearingMessagesTimer = change.newTimer;
622
+ if (change.newDescription !== undefined)
623
+ state.description = change.newDescription.value;
624
+ if (change.newInviteLinkPassword !== undefined) {
625
+ state.inviteLinkPassword = change.newInviteLinkPassword;
626
+ }
627
+ if (change.newIsAnnouncementGroup !== undefined &&
628
+ change.newIsAnnouncementGroup !== EnabledState.UNKNOWN) {
629
+ state.isAnnouncementGroup = change.newIsAnnouncementGroup;
630
+ }
631
+ if (change.newAttributeAccess !== undefined &&
632
+ change.newAttributeAccess !== AccessRequired.UNKNOWN) {
633
+ state.accessControl = { ...state.accessControl, attributes: change.newAttributeAccess };
634
+ }
635
+ if (change.newMemberAccess !== undefined && change.newMemberAccess !== AccessRequired.UNKNOWN) {
636
+ state.accessControl = { ...state.accessControl, members: change.newMemberAccess };
637
+ }
638
+ if (change.newInviteLinkAccess !== undefined &&
639
+ change.newInviteLinkAccess !== AccessRequired.UNKNOWN) {
640
+ state.accessControl = {
641
+ ...state.accessControl,
642
+ addFromInviteLink: change.newInviteLinkAccess,
643
+ };
644
+ }
645
+ if (change.newMemberLabelAccess !== undefined &&
646
+ change.newMemberLabelAccess !== AccessRequired.UNKNOWN) {
647
+ state.accessControl = { ...state.accessControl, memberLabel: change.newMemberLabelAccess };
648
+ }
649
+ }
650
+ /**
651
+ * Validate the structure of a DecryptedGroupChange against current group state.
652
+ *
653
+ * This answers only whether the change is well-formed. It does not determine
654
+ * whether the editor was authorized to perform the actions.
655
+ *
656
+ * @param state - Current group state
657
+ * @param change - Change to validate
658
+ * @returns Array of validation error strings (empty if valid)
659
+ */
660
+ export function validateChangeStructure(state, change, form = 'canonical') {
661
+ const errors = [
662
+ ...validateGroupIdentifiers(state),
663
+ ...validateGroupAccessControl(state),
664
+ ...validateGroupMemberRoles(state),
665
+ ...validateGroupCanonicalFields(state),
666
+ ...validateChangeIdentifiers(change),
667
+ ...validateChangeAccessControl(change),
668
+ ...validateChangeMemberRoles(change),
669
+ ...validateChangeCanonicalFields(state, change, form),
670
+ ];
671
+ if (change.revision !== state.revision + 1) {
672
+ errors.push(`Invalid revision: expected ${state.revision + 1}, got ${change.revision}`);
673
+ }
674
+ if (state.terminated) {
675
+ errors.push('Group is terminated');
676
+ return errors;
677
+ }
678
+ const hasArrayAction = change.newMembers.length > 0 ||
679
+ change.deleteMembers.length > 0 ||
680
+ change.modifyMemberRoles.length > 0 ||
681
+ change.modifiedProfileKeys.length > 0 ||
682
+ change.newPendingMembers.length > 0 ||
683
+ change.deletePendingMembers.length > 0 ||
684
+ change.promotePendingMembers.length > 0 ||
685
+ change.promotePendingPniAciMembers.length > 0 ||
686
+ change.newRequestingMembers.length > 0 ||
687
+ change.deleteRequestingMembers.length > 0 ||
688
+ change.promoteRequestingMembers.length > 0 ||
689
+ change.newBannedMembers.length > 0 ||
690
+ change.deleteBannedMembers.length > 0 ||
691
+ change.modifyMemberLabels.length > 0;
692
+ const hasScalarAction = change.newTitle !== undefined ||
693
+ change.newAvatar !== undefined ||
694
+ change.newTimer !== undefined ||
695
+ change.newAttributeAccess !== undefined ||
696
+ change.newMemberAccess !== undefined ||
697
+ change.newInviteLinkAccess !== undefined ||
698
+ change.newMemberLabelAccess !== undefined ||
699
+ change['newInviteLinkPassword'] !== undefined ||
700
+ change.newDescription !== undefined ||
701
+ change.newIsAnnouncementGroup !== undefined ||
702
+ change.terminate !== undefined;
703
+ if (!hasArrayAction && !hasScalarAction) {
704
+ errors.push('Change contains no actions');
705
+ return errors;
706
+ }
707
+ const shadow = cloneGroup(state);
708
+ const step = () => emptyGroupChange(change.editorServiceIdBytes, change.revision);
709
+ const validateStep = (apply) => {
710
+ try {
711
+ apply();
712
+ }
713
+ catch (error) {
714
+ const message = error instanceof Error ? error.message : String(error);
715
+ errors.push(message.replace(/^INVALID_CHANGE: /, ''));
716
+ }
717
+ };
718
+ // Mirror §7.4 exactly so validation and application cannot disagree about
719
+ // which targets exist at each phase.
720
+ for (const removal of change.deletePendingMembers) {
721
+ validateStep(() => {
722
+ const current = step();
723
+ current.deletePendingMembers = [removal];
724
+ applyDeletions(shadow, current);
725
+ });
726
+ }
727
+ for (const aciBytes of change.deleteRequestingMembers) {
728
+ validateStep(() => {
729
+ const current = step();
730
+ current.deleteRequestingMembers = [aciBytes];
731
+ applyDeletions(shadow, current);
732
+ });
733
+ }
734
+ for (const removal of change.deleteBannedMembers) {
735
+ validateStep(() => {
736
+ const current = step();
737
+ current.deleteBannedMembers = [removal];
738
+ applyDeletions(shadow, current);
739
+ });
740
+ }
741
+ for (const aciBytes of change.deleteMembers) {
742
+ validateStep(() => {
743
+ const current = step();
744
+ current.deleteMembers = [aciBytes];
745
+ applyDeletions(shadow, current);
746
+ });
747
+ }
748
+ for (const banned of change.newBannedMembers) {
749
+ validateStep(() => {
750
+ const current = step();
751
+ current.newBannedMembers = [banned];
752
+ applyBans(shadow, current);
753
+ });
754
+ }
755
+ for (const promotion of change.promotePendingMembers) {
756
+ validateStep(() => {
757
+ const current = step();
758
+ current.promotePendingMembers = [promotion];
759
+ applyPromotions(shadow, current);
760
+ });
761
+ }
762
+ for (const promotion of change.promotePendingPniAciMembers) {
763
+ validateStep(() => {
764
+ const current = step();
765
+ current.promotePendingPniAciMembers = [promotion];
766
+ applyPromotions(shadow, current);
767
+ });
768
+ }
769
+ for (const approval of change.promoteRequestingMembers) {
770
+ validateStep(() => {
771
+ const current = step();
772
+ current.promoteRequestingMembers = [approval];
773
+ applyPromotions(shadow, current);
774
+ });
775
+ }
776
+ for (const member of change.newMembers) {
777
+ validateStep(() => {
778
+ const current = step();
779
+ current.newMembers = [member];
780
+ applyAdditions(shadow, current);
781
+ });
782
+ }
783
+ for (const pending of change.newPendingMembers) {
784
+ validateStep(() => {
785
+ const current = step();
786
+ current.newPendingMembers = [pending];
787
+ applyAdditions(shadow, current);
788
+ });
789
+ }
790
+ for (const requesting of change.newRequestingMembers) {
791
+ validateStep(() => {
792
+ const current = step();
793
+ current.newRequestingMembers = [requesting];
794
+ applyAdditions(shadow, current);
795
+ });
796
+ }
797
+ for (const modification of change.modifyMemberRoles) {
798
+ validateStep(() => {
799
+ const current = step();
800
+ current.modifyMemberRoles = [modification];
801
+ applyMemberModifications(shadow, current);
802
+ });
803
+ }
804
+ for (const modification of change.modifyMemberLabels) {
805
+ validateStep(() => {
806
+ const current = step();
807
+ current.modifyMemberLabels = [modification];
808
+ applyMemberModifications(shadow, current);
809
+ });
810
+ }
811
+ for (const modification of change.modifiedProfileKeys) {
812
+ validateStep(() => {
813
+ const current = step();
814
+ current.modifiedProfileKeys = [modification];
815
+ applyMemberModifications(shadow, current);
816
+ });
817
+ }
818
+ if (change.terminate !== undefined) {
819
+ validateStep(() => {
820
+ const current = step();
821
+ current.terminate = change.terminate;
822
+ applyTermination(shadow, current);
823
+ });
824
+ }
825
+ return errors;
826
+ }
827
+ //# sourceMappingURL=change-actions.js.map