@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,284 @@
1
+ /**
2
+ * Group access control
3
+ *
4
+ * Authorization checks for group operations based on member roles and
5
+ * access control settings.
6
+ *
7
+ * The plaintext client and ciphertext-only reference server both delegate to
8
+ * the representation-independent policy in this module. The server identifies
9
+ * principals by deterministic UID ciphertext and never decrypts group state.
10
+ *
11
+ * @module groups/access-control
12
+ */
13
+ import { MemberRole, AccessRequired, EnabledState, } from './types.js';
14
+ import { constantTimeEqual as bytesEqual } from '../crypto/utils.js';
15
+ import { SERVICE_ID_ACI, SERVICE_ID_PNI } from '../protocol/zk/groups/uid-struct.js';
16
+ export var GroupAction;
17
+ (function (GroupAction) {
18
+ // Attribute modifications
19
+ GroupAction["MODIFY_TITLE"] = "MODIFY_TITLE";
20
+ GroupAction["MODIFY_AVATAR"] = "MODIFY_AVATAR";
21
+ GroupAction["MODIFY_DESCRIPTION"] = "MODIFY_DESCRIPTION";
22
+ GroupAction["MODIFY_DISAPPEARING_MESSAGES"] = "MODIFY_DISAPPEARING_MESSAGES";
23
+ // Membership operations
24
+ GroupAction["ADD_MEMBER"] = "ADD_MEMBER";
25
+ GroupAction["REMOVE_MEMBER"] = "REMOVE_MEMBER";
26
+ GroupAction["MODIFY_MEMBER_ROLE"] = "MODIFY_MEMBER_ROLE";
27
+ GroupAction["MODIFY_MEMBER_LABEL"] = "MODIFY_MEMBER_LABEL";
28
+ GroupAction["MODIFY_MEMBER_PROFILE_KEY"] = "MODIFY_MEMBER_PROFILE_KEY";
29
+ // Access control modifications (admin only)
30
+ GroupAction["MODIFY_ATTRIBUTES_ACCESS"] = "MODIFY_ATTRIBUTES_ACCESS";
31
+ GroupAction["MODIFY_MEMBERS_ACCESS"] = "MODIFY_MEMBERS_ACCESS";
32
+ GroupAction["MODIFY_INVITE_LINK_ACCESS"] = "MODIFY_INVITE_LINK_ACCESS";
33
+ GroupAction["MODIFY_INVITE_LINK_PASSWORD"] = "MODIFY_INVITE_LINK_PASSWORD";
34
+ // Announcement mode (admin only)
35
+ GroupAction["MODIFY_ANNOUNCEMENTS"] = "MODIFY_ANNOUNCEMENTS";
36
+ // Member-label access modification (admin only)
37
+ GroupAction["MODIFY_MEMBER_LABEL_ACCESS"] = "MODIFY_MEMBER_LABEL_ACCESS";
38
+ // Ban operations (admin only)
39
+ GroupAction["BAN_MEMBER"] = "BAN_MEMBER";
40
+ GroupAction["UNBAN_MEMBER"] = "UNBAN_MEMBER";
41
+ // Pending profile-key membership
42
+ GroupAction["ADD_MEMBER_PENDING_PROFILE_KEY"] = "ADD_MEMBER_PENDING_PROFILE_KEY";
43
+ GroupAction["DELETE_MEMBER_PENDING_PROFILE_KEY"] = "DELETE_MEMBER_PENDING_PROFILE_KEY";
44
+ GroupAction["PROMOTE_MEMBER_PENDING_PROFILE_KEY"] = "PROMOTE_MEMBER_PENDING_PROFILE_KEY";
45
+ GroupAction["PROMOTE_MEMBER_PENDING_PNI_ACI_PROFILE_KEY"] = "PROMOTE_MEMBER_PENDING_PNI_ACI_PROFILE_KEY";
46
+ // Pending administrator approval
47
+ GroupAction["ADD_MEMBER_PENDING_ADMIN_APPROVAL"] = "ADD_MEMBER_PENDING_ADMIN_APPROVAL";
48
+ GroupAction["DELETE_MEMBER_PENDING_ADMIN_APPROVAL"] = "DELETE_MEMBER_PENDING_ADMIN_APPROVAL";
49
+ GroupAction["PROMOTE_MEMBER_PENDING_ADMIN_APPROVAL"] = "PROMOTE_MEMBER_PENDING_ADMIN_APPROVAL";
50
+ // Group lifecycle
51
+ GroupAction["TERMINATE_GROUP"] = "TERMINATE_GROUP";
52
+ // Message sending
53
+ GroupAction["SEND_MESSAGE"] = "SEND_MESSAGE";
54
+ })(GroupAction || (GroupAction = {}));
55
+ /**
56
+ * §6.9: a live group must retain at least one stored administrator.
57
+ *
58
+ * The state representations share the only fields this result-state invariant
59
+ * needs, so clients and the ciphertext-only reference server use one check.
60
+ */
61
+ export function satisfiesLiveGroupAdministratorInvariant(group) {
62
+ return (group.terminated ||
63
+ group.members.some((member) => member.role === MemberRole.ADMINISTRATOR));
64
+ }
65
+ /**
66
+ * Find a member in the group by their ACI (Account Identity).
67
+ *
68
+ * @param group - Decrypted group state
69
+ * @param aciBytes - Member's ACI as 16 raw UUID bytes
70
+ * @returns Member object if found, undefined otherwise
71
+ */
72
+ export function findMember(group, aciBytes) {
73
+ return group.members.find((member) => bytesEqual(member.aciBytes, aciBytes));
74
+ }
75
+ /**
76
+ * Get a member's role in the group.
77
+ *
78
+ * @param group - Decrypted group state
79
+ * @param aciBytes - Member's ACI as 16 raw UUID bytes
80
+ * @returns Member's role, or UNKNOWN if not a member
81
+ */
82
+ export function getMemberRole(group, aciBytes) {
83
+ const member = findMember(group, aciBytes);
84
+ return member?.role ?? MemberRole.UNKNOWN;
85
+ }
86
+ /**
87
+ * Check if a member role satisfies an access requirement.
88
+ *
89
+ * @param memberRole - The member's current role
90
+ * @param requirement - The required access level
91
+ * @returns True if the member role meets the requirement
92
+ */
93
+ export function meetsAccessRequirement(memberRole, requirement) {
94
+ switch (requirement) {
95
+ case AccessRequired.ANY:
96
+ return true;
97
+ case AccessRequired.MEMBER:
98
+ return memberRole === MemberRole.DEFAULT || memberRole === MemberRole.ADMINISTRATOR;
99
+ case AccessRequired.ADMINISTRATOR:
100
+ // Only administrators can perform the action
101
+ return memberRole === MemberRole.ADMINISTRATOR;
102
+ case AccessRequired.UNSATISFIABLE:
103
+ // Feature is disabled, no one can perform the action
104
+ return false;
105
+ case AccessRequired.UNKNOWN:
106
+ default:
107
+ // Unknown access level, deny by default
108
+ return false;
109
+ }
110
+ }
111
+ /**
112
+ * Whether a role-gated access-control field contains a legal §6.7 value.
113
+ *
114
+ * `ANY` remains part of the shared lattice for invite-link evaluation, but is
115
+ * deliberately not a legal value for fields consumed through `meets()`.
116
+ */
117
+ export function isRoleAccessRequirement(requirement) {
118
+ return (requirement === AccessRequired.MEMBER ||
119
+ requirement === AccessRequired.ADMINISTRATOR);
120
+ }
121
+ /** Whether the invite-link mode contains a legal §6.7 value. */
122
+ export function isInviteLinkAccessRequirement(requirement) {
123
+ return (requirement === AccessRequired.UNSATISFIABLE ||
124
+ requirement === AccessRequired.ANY ||
125
+ requirement === AccessRequired.ADMINISTRATOR);
126
+ }
127
+ /** Whether a stored member or pending-member role is legal under §6.8. */
128
+ export function isStoredMemberRole(role) {
129
+ return role === MemberRole.DEFAULT || role === MemberRole.ADMINISTRATOR;
130
+ }
131
+ function canAssignInitialRole(requesterRole, assignedRole) {
132
+ return (assignedRole === MemberRole.DEFAULT ||
133
+ (assignedRole === MemberRole.ADMINISTRATOR &&
134
+ requesterRole === MemberRole.ADMINISTRATOR));
135
+ }
136
+ function meetsRoleAccessRequirement(memberRole, requirement) {
137
+ return (isRoleAccessRequirement(requirement) &&
138
+ meetsAccessRequirement(memberRole, requirement));
139
+ }
140
+ /**
141
+ * Check if a member can perform a specific action on the group.
142
+ * Core authorization function for all group operations.
143
+ *
144
+ * @param group - Decrypted group state
145
+ * @param requesterServiceIdBytes - Requester's 17-byte ServiceId
146
+ * @param action - The action to check
147
+ * @param context - Target and invite-link facts required by some actions
148
+ * @returns True if the member is authorized to perform the action
149
+ */
150
+ export function canPerformAction(group, requesterServiceIdBytes, action, context = {}) {
151
+ if (requesterServiceIdBytes.length !== 17 ||
152
+ (requesterServiceIdBytes[0] !== SERVICE_ID_ACI && requesterServiceIdBytes[0] !== SERVICE_ID_PNI)) {
153
+ return false;
154
+ }
155
+ const requesterAciBytes = requesterServiceIdBytes[0] === SERVICE_ID_ACI ? requesterServiceIdBytes.slice(1) : undefined;
156
+ const role = requesterAciBytes === undefined ? MemberRole.UNKNOWN : getMemberRole(group, requesterAciBytes);
157
+ const targetsRequesterAci = requesterAciBytes !== undefined &&
158
+ context.targetAciBytes !== undefined &&
159
+ bytesEqual(context.targetAciBytes, requesterAciBytes);
160
+ const targetsRequesterServiceId = context.targetServiceIdBytes !== undefined &&
161
+ bytesEqual(context.targetServiceIdBytes, requesterServiceIdBytes);
162
+ return canRolePerformAction(group, role, action, {
163
+ requesterIsBanned: isBanned(group, requesterServiceIdBytes),
164
+ targetIsRequester: targetsRequesterAci || targetsRequesterServiceId,
165
+ assignedRole: context.assignedRole,
166
+ });
167
+ }
168
+ /**
169
+ * Evaluate the normative §6.4 table from state-decidable facts.
170
+ *
171
+ * Keeping this policy independent of identifier representation lets the
172
+ * plaintext client and ciphertext-only reference server enforce one table.
173
+ */
174
+ export function canRolePerformAction(group, role, action, context = {}) {
175
+ if (context.requesterIsBanned === true) {
176
+ return false;
177
+ }
178
+ switch (action) {
179
+ // Message sending
180
+ case GroupAction.SEND_MESSAGE:
181
+ // In announcement groups, only admins can send messages
182
+ if (group.isAnnouncementGroup === EnabledState.ENABLED) {
183
+ return role === MemberRole.ADMINISTRATOR;
184
+ }
185
+ return role === MemberRole.DEFAULT || role === MemberRole.ADMINISTRATOR;
186
+ // Attribute modifications
187
+ case GroupAction.MODIFY_TITLE:
188
+ case GroupAction.MODIFY_AVATAR:
189
+ case GroupAction.MODIFY_DESCRIPTION:
190
+ case GroupAction.MODIFY_DISAPPEARING_MESSAGES:
191
+ return meetsRoleAccessRequirement(role, group.accessControl.attributes);
192
+ // Membership operations
193
+ case GroupAction.ADD_MEMBER:
194
+ return (canAssignInitialRole(role, context.assignedRole) &&
195
+ (meetsRoleAccessRequirement(role, group.accessControl.members) ||
196
+ (context.targetIsRequester === true &&
197
+ group.accessControl.addFromInviteLink === AccessRequired.ANY)));
198
+ case GroupAction.REMOVE_MEMBER:
199
+ return role === MemberRole.ADMINISTRATOR || context.targetIsRequester === true;
200
+ case GroupAction.MODIFY_MEMBER_ROLE:
201
+ return role === MemberRole.ADMINISTRATOR;
202
+ case GroupAction.MODIFY_MEMBER_LABEL:
203
+ return (context.targetIsRequester === true ||
204
+ meetsRoleAccessRequirement(role, group.accessControl.memberLabel));
205
+ case GroupAction.MODIFY_MEMBER_PROFILE_KEY:
206
+ return context.targetIsRequester === true;
207
+ // Access control modifications (admin only)
208
+ case GroupAction.MODIFY_ATTRIBUTES_ACCESS:
209
+ case GroupAction.MODIFY_MEMBERS_ACCESS:
210
+ case GroupAction.MODIFY_INVITE_LINK_ACCESS:
211
+ case GroupAction.MODIFY_INVITE_LINK_PASSWORD:
212
+ case GroupAction.MODIFY_MEMBER_LABEL_ACCESS:
213
+ return role === MemberRole.ADMINISTRATOR;
214
+ // Announcement mode (admin only)
215
+ case GroupAction.MODIFY_ANNOUNCEMENTS:
216
+ return role === MemberRole.ADMINISTRATOR;
217
+ // Ban operations (admin only)
218
+ case GroupAction.BAN_MEMBER:
219
+ case GroupAction.UNBAN_MEMBER:
220
+ return role === MemberRole.ADMINISTRATOR;
221
+ case GroupAction.ADD_MEMBER_PENDING_PROFILE_KEY:
222
+ return (canAssignInitialRole(role, context.assignedRole) &&
223
+ meetsRoleAccessRequirement(role, group.accessControl.members));
224
+ case GroupAction.DELETE_MEMBER_PENDING_PROFILE_KEY:
225
+ return role === MemberRole.ADMINISTRATOR || context.targetIsRequester === true;
226
+ case GroupAction.PROMOTE_MEMBER_PENDING_PROFILE_KEY:
227
+ case GroupAction.PROMOTE_MEMBER_PENDING_PNI_ACI_PROFILE_KEY:
228
+ return context.targetIsRequester === true;
229
+ case GroupAction.ADD_MEMBER_PENDING_ADMIN_APPROVAL:
230
+ return (context.targetIsRequester === true &&
231
+ group.accessControl.addFromInviteLink === AccessRequired.ADMINISTRATOR);
232
+ case GroupAction.DELETE_MEMBER_PENDING_ADMIN_APPROVAL:
233
+ return role === MemberRole.ADMINISTRATOR || context.targetIsRequester === true;
234
+ case GroupAction.PROMOTE_MEMBER_PENDING_ADMIN_APPROVAL:
235
+ case GroupAction.TERMINATE_GROUP:
236
+ return role === MemberRole.ADMINISTRATOR;
237
+ default:
238
+ // Unknown action, deny by default
239
+ return false;
240
+ }
241
+ }
242
+ /**
243
+ * Check if a member is an administrator of the group.
244
+ * Convenience function for common authorization check.
245
+ *
246
+ * @param group - Decrypted group state
247
+ * @param aciBytes - Member's ACI as bytes
248
+ * @returns True if the member is an administrator
249
+ */
250
+ export function isAdmin(group, aciBytes) {
251
+ return getMemberRole(group, aciBytes) === MemberRole.ADMINISTRATOR;
252
+ }
253
+ /**
254
+ * Check if a user is a member of the group.
255
+ * Convenience function to check membership status.
256
+ *
257
+ * @param group - Decrypted group state
258
+ * @param aciBytes - User's ACI as bytes
259
+ * @returns True if the user is a member
260
+ */
261
+ export function isMember(group, aciBytes) {
262
+ return findMember(group, aciBytes) !== undefined;
263
+ }
264
+ /**
265
+ * Check if a user has a pending membership invitation.
266
+ *
267
+ * @param group - Decrypted group state
268
+ * @param serviceIdBytes - User's service ID (ACI or PNI) as bytes
269
+ * @returns True if the user has a pending invitation
270
+ */
271
+ export function isPending(group, serviceIdBytes) {
272
+ return group.pendingMembers.some((pending) => bytesEqual(pending.serviceIdBytes, serviceIdBytes));
273
+ }
274
+ /**
275
+ * Check if a user is banned from the group.
276
+ *
277
+ * @param group - Decrypted group state
278
+ * @param serviceIdBytes - User's service ID (ACI or PNI) as bytes
279
+ * @returns True if the user is banned
280
+ */
281
+ export function isBanned(group, serviceIdBytes) {
282
+ return group.bannedMembers.some((banned) => bytesEqual(banned.serviceIdBytes, serviceIdBytes));
283
+ }
284
+ //# sourceMappingURL=access-control.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"access-control.js","sourceRoot":"","sources":["../../../internal/groups/access-control.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,57 @@
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 { type DecryptedGroup, type DecryptedGroupChange } from './types.js';
13
+ /** Validate C6's non-nil identifier invariant over decrypted group state. */
14
+ export declare function validateGroupIdentifiers(group: DecryptedGroup): string[];
15
+ /** Validate §6.7's field-specific access-control domains. */
16
+ export declare function validateGroupAccessControl(group: DecryptedGroup): string[];
17
+ /** Validate §6.8's stored member and pending-member role domain. */
18
+ export declare function validateGroupMemberRoles(group: DecryptedGroup): string[];
19
+ /** Validate §7.8's plaintext stored-state domains. */
20
+ export declare function validateGroupCanonicalFields(group: DecryptedGroup): string[];
21
+ /** Validate C6's non-nil identifier invariant over a decrypted change. */
22
+ export declare function validateChangeIdentifiers(change: DecryptedGroupChange): string[];
23
+ /** Validate access-control values introduced by a change under §6.7. */
24
+ export declare function validateChangeAccessControl(change: DecryptedGroupChange): string[];
25
+ /** Validate every role-bearing action field under §6.8. */
26
+ export declare function validateChangeMemberRoles(change: DecryptedGroupChange): string[];
27
+ export type DecryptedGroupChangeForm = 'submission' | 'canonical';
28
+ /** Validate §7.8's derived-field presence and plaintext action domains. */
29
+ export declare function validateChangeCanonicalFields(state: DecryptedGroup, change: DecryptedGroupChange, form: DecryptedGroupChangeForm): string[];
30
+ /**
31
+ * Deep clone a DecryptedGroup to ensure immutability.
32
+ */
33
+ export {};
34
+ /**
35
+ * Apply a DecryptedGroupChange to a DecryptedGroup state.
36
+ *
37
+ * This is a pure function that returns a new state object without mutating the input.
38
+ * Changes are applied in the normative order from §7.4.
39
+ *
40
+ * @param state - Current group state
41
+ * @param change - Change to apply
42
+ * @returns New group state with changes applied
43
+ * @throws Error if revision is not sequential
44
+ */
45
+ export declare function applyGroupChange(state: DecryptedGroup, change: DecryptedGroupChange): DecryptedGroup;
46
+ /**
47
+ * Validate the structure of a DecryptedGroupChange against current group state.
48
+ *
49
+ * This answers only whether the change is well-formed. It does not determine
50
+ * whether the editor was authorized to perform the actions.
51
+ *
52
+ * @param state - Current group state
53
+ * @param change - Change to validate
54
+ * @returns Array of validation error strings (empty if valid)
55
+ */
56
+ export declare function validateChangeStructure(state: DecryptedGroup, change: DecryptedGroupChange, form?: DecryptedGroupChangeForm): string[];
57
+ //# sourceMappingURL=change-actions.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"change-actions.d.ts","sourceRoot":"","sources":["../../../internal/groups/change-actions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,KAAK,cAAc,EAGnB,KAAK,oBAAoB,EAK1B,MAAM,SAAS,CAAC;AA6BjB,6EAA6E;AAC7E,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,EAAE,CAmCxE;AAED,6DAA6D;AAC7D,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,EAAE,CAe1E;AAED,oEAAoE;AACpE,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,EAAE,CAaxE;AAMD,sDAAsD;AACtD,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,EAAE,CA2C5E;AAED,0EAA0E;AAC1E,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,EAAE,CA+FhF;AAED,wEAAwE;AACxE,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,oBAAoB,GAC3B,MAAM,EAAE,CAkBV;AAED,2DAA2D;AAC3D,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,oBAAoB,GAC3B,MAAM,EAAE,CAmCV;AAED,MAAM,MAAM,wBAAwB,GAAG,YAAY,GAAG,WAAW,CAAC;AAElE,2EAA2E;AAC3E,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,oBAAoB,EAC5B,IAAI,EAAE,wBAAwB,GAC7B,MAAM,EAAE,CA6IV;AAED;;GAEG;AACH,OAAO,EAAE,CAAC;AA6CV;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,oBAAoB,GAC3B,cAAc,CAoBhB;AAoYD;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,oBAAoB,EAC5B,IAAI,GAAE,wBAAsC,GAC3C,MAAM,EAAE,CA2KV"}