@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
@@ -1,7 +1,7 @@
1
1
  /**
2
- * Canonical prefix for version 2 group identifiers.
2
+ * Canonical prefix for group identifiers.
3
3
  */
4
- export const GROUP_V2_PREFIX = '__signal_group__v2__!';
4
+ export const GROUP_ID_PREFIX = 'open-e2ee:group:';
5
5
  /**
6
6
  * Check if an ID is a group ID (has group prefix)
7
7
  *
@@ -12,7 +12,7 @@ export const GROUP_V2_PREFIX = '__signal_group__v2__!';
12
12
  *
13
13
  * @example
14
14
  * ```typescript
15
- * const id = '__signal_group__v2__!abc123';
15
+ * const id = 'open-e2ee:group:abc123';
16
16
  * if (isGroupId(id)) {
17
17
  * // id is now typed as GroupId
18
18
  * const raw = extractGroupId(id);
@@ -20,7 +20,7 @@ export const GROUP_V2_PREFIX = '__signal_group__v2__!';
20
20
  * ```
21
21
  */
22
22
  export function isGroupId(id) {
23
- return id.startsWith(GROUP_V2_PREFIX);
23
+ return id.startsWith(GROUP_ID_PREFIX);
24
24
  }
25
25
  /**
26
26
  * Create a prefixed group ID from a raw group ID
@@ -31,14 +31,14 @@ export function isGroupId(id) {
31
31
  * @example
32
32
  * ```typescript
33
33
  * const groupId = createGroupId('abc123');
34
- * // groupId is '__signal_group__v2__!abc123' with GroupId type
34
+ * // groupId is 'open-e2ee:group:abc123' with GroupId type
35
35
  * ```
36
36
  */
37
37
  export function createGroupId(rawId) {
38
- if (rawId.startsWith(GROUP_V2_PREFIX)) {
38
+ if (rawId.startsWith(GROUP_ID_PREFIX)) {
39
39
  return rawId; // Already prefixed
40
40
  }
41
- return `${GROUP_V2_PREFIX}${rawId}`;
41
+ return `${GROUP_ID_PREFIX}${rawId}`;
42
42
  }
43
43
  /**
44
44
  * Extract raw group ID from prefixed group ID
@@ -48,14 +48,13 @@ export function createGroupId(rawId) {
48
48
  *
49
49
  * @example
50
50
  * ```typescript
51
- * extractGroupId('__signal_group__v2__!abc123'); // 'abc123'
52
- * extractGroupId('abc123'); // 'abc123' (no prefix)
51
+ * extractGroupId('open-e2ee:group:abc123'); // 'abc123'
52
+ * extractGroupId('abc123'); // 'abc123' (no prefix)
53
53
  * ```
54
54
  */
55
55
  export function extractGroupId(groupId) {
56
- // Handle Signal Protocol V2 prefix
57
- if (groupId.startsWith(GROUP_V2_PREFIX)) {
58
- return groupId.slice(GROUP_V2_PREFIX.length);
56
+ if (groupId.startsWith(GROUP_ID_PREFIX)) {
57
+ return groupId.slice(GROUP_ID_PREFIX.length);
59
58
  }
60
59
  // Already unprefixed
61
60
  return groupId;
@@ -1 +1 @@
1
- {"version":3,"file":"group-id.js","sourceRoot":"","sources":["../../../internal/groups/group-id.ts"],"names":[],"mappings":"AAyBA;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,uBAAuB,CAAC;AAEvD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,SAAS,CAAC,EAAU;IAClC,OAAO,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,IAAI,KAAK,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QACtC,OAAO,KAAgB,CAAC,CAAC,mBAAmB;IAC9C,CAAC;IACD,OAAO,GAAG,eAAe,GAAG,KAAK,EAAa,CAAC;AACjD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAAC,OAAyB;IACtD,mCAAmC;IACnC,IAAI,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QACxC,OAAO,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC;IACD,qBAAqB;IACrB,OAAO,OAAO,CAAC;AACjB,CAAC"}
1
+ {"version":3,"file":"group-id.js","sourceRoot":"","sources":["../../../internal/groups/group-id.ts"],"names":[],"mappings":"AAyBA;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,kBAAkB,CAAC;AAElD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,SAAS,CAAC,EAAU;IAClC,OAAO,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,IAAI,KAAK,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QACtC,OAAO,KAAgB,CAAC,CAAC,mBAAmB;IAC9C,CAAC;IACD,OAAO,GAAG,eAAe,GAAG,KAAK,EAAa,CAAC;AACjD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAAC,OAAyB;IACtD,IAAI,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QACxC,OAAO,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC;IACD,qBAAqB;IACrB,OAAO,OAAO,CAAC;AACjB,CAAC"}
@@ -1,15 +1,25 @@
1
1
  /**
2
- * Group Module
2
+ * Group state management
3
3
  *
4
4
  * @module groups
5
5
  *
6
- * Utilities for group identifiers and group messaging.
7
- *
8
- * - **group-id.ts**: Group ID prefix handling (V2 format)
9
- * - Future: cipher.ts for GroupCipher wrapper
6
+ * Group identifiers, encrypted state, changes, access control, invite links,
7
+ * and orchestration.
10
8
  *
9
+ * The anonymous-credential layer beneath this follows "The Signal Private
10
+ * Group System" (Chase, Perrin, Zaverucha, eprint 2019/1416). The group state
11
+ * and change formats above it are this SDK's own and are not interoperable
12
+ * with other implementations. See docs/DEVIATIONS.md.
11
13
  */
12
14
  export {};
13
- export { GROUP_V2_PREFIX, isGroupId, createGroupId, extractGroupId } from './group-id.js';
15
+ export { GROUP_ID_PREFIX, isGroupId, createGroupId, extractGroupId } from './group-id.js';
14
16
  export type { GroupId } from './group-id.js';
17
+ export { MemberRole, AccessRequired, EnabledState, type AccessControl, type EncryptedGroup, type EncryptedMember, type EncryptedPendingMember, type EncryptedRequestingMember, type EncryptedBannedMember, type GroupAttributeBlob, type DecryptedGroup, type DecryptedMember, type DecryptedPendingMember, type DecryptedRequestingMember, type DecryptedBannedMember, type DecryptedGroupChange, type DecryptedTimer, type DecryptedString, type DecryptedModifyMemberRole, type DecryptedModifyMemberLabel, type DecryptedPendingMemberRemoval, type DecryptedApproveMember, type GroupChangeState, type SerializedGroupChange, type GroupResponse, type GroupChangesResponse, type GroupChangeResponse, type DecryptedGroupJoinInfo, type EncryptedGroupJoinInfo, defaultAccessControl, emptyGroupChange, } from './types.js';
18
+ export { encryptGroupState, decryptGroupState, decryptGroupJoinInfo, encryptGroupTitle, decryptGroupTitle, encryptGroupDescription, decryptGroupDescription, encryptDisappearingMessagesTimer, decryptDisappearingMessagesTimer, encryptMember, decryptMember, encryptRequestingMember, } from './encrypted-state.js';
19
+ export { applyGroupChange, validateChangeStructure } from './change-actions.js';
20
+ export { validateChangeAuthorization } from './change-authorization.js';
21
+ export { GroupAction, type GroupActionContext, type GroupActionAuthorizationContext, canPerformAction, canRolePerformAction, meetsAccessRequirement, isRoleAccessRequirement, isInviteLinkAccessRequirement, isStoredMemberRole, findMember, getMemberRole, isAdmin, isMember, isPending, isBanned, } from './access-control.js';
22
+ export { createGroupInviteLink, parseGroupInviteLink, generateInviteLinkPassword, INVITE_LINK_PASSWORD_LEN, INVITE_LINK_VERSION, INVITE_LINK_PREFIX, } from './invite-link.js';
23
+ export { GROUP_TRUST_ROOT_VERSION, decodeGroupTrustRoot, encodeGroupTrustRoot, type GroupTrustRoot, } from './trust-root.js';
24
+ export { GroupManager, MAX_GROUP_SIZE, MAX_SUPPORTED_CHANGE_EPOCH, type IGroupStateStore, type IGroupServer, type GroupSnapshot, type GroupChangeLogEntry, type OnSenderKeyRotation, type OnEndorsementsInvalidated, type GroupManagerOptions, type GroupConfigurationWarning, type GroupMemberInput, type PresentedGroupMemberInput, type InvitedGroupMemberInput, } from './manager.js';
15
25
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../internal/groups/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,CAAC;AACV,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEvF,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../internal/groups/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,CAAC;AACV,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACvF,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,OAAO,EACL,UAAU,EACV,cAAc,EACd,YAAY,EACZ,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,6BAA6B,EAClC,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,EACvB,gCAAgC,EAChC,gCAAgC,EAChC,aAAa,EACb,aAAa,EACb,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAErE,OAAO,EACL,WAAW,EACX,KAAK,kBAAkB,EACvB,KAAK,+BAA+B,EACpC,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,EACvB,6BAA6B,EAC7B,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,OAAO,EACP,QAAQ,EACR,SAAS,EACT,QAAQ,GACT,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,0BAA0B,EAC1B,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EACpB,KAAK,cAAc,GACpB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,0BAA0B,EAC1B,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,gBAAgB,EACrB,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,GAC7B,MAAM,WAAW,CAAC"}
@@ -1,2 +1,10 @@
1
- export { GROUP_V2_PREFIX, isGroupId, createGroupId, extractGroupId } from './group-id.js';
1
+ export { GROUP_ID_PREFIX, isGroupId, createGroupId, extractGroupId } from './group-id.js';
2
+ export { MemberRole, AccessRequired, EnabledState, defaultAccessControl, emptyGroupChange, } from './types.js';
3
+ export { encryptGroupState, decryptGroupState, decryptGroupJoinInfo, encryptGroupTitle, decryptGroupTitle, encryptGroupDescription, decryptGroupDescription, encryptDisappearingMessagesTimer, decryptDisappearingMessagesTimer, encryptMember, decryptMember, encryptRequestingMember, } from './encrypted-state.js';
4
+ export { applyGroupChange, validateChangeStructure } from './change-actions.js';
5
+ export { validateChangeAuthorization } from './change-authorization.js';
6
+ export { GroupAction, canPerformAction, canRolePerformAction, meetsAccessRequirement, isRoleAccessRequirement, isInviteLinkAccessRequirement, isStoredMemberRole, findMember, getMemberRole, isAdmin, isMember, isPending, isBanned, } from './access-control.js';
7
+ export { createGroupInviteLink, parseGroupInviteLink, generateInviteLinkPassword, INVITE_LINK_PASSWORD_LEN, INVITE_LINK_VERSION, INVITE_LINK_PREFIX, } from './invite-link.js';
8
+ export { GROUP_TRUST_ROOT_VERSION, decodeGroupTrustRoot, encodeGroupTrustRoot, } from './trust-root.js';
9
+ export { GroupManager, MAX_GROUP_SIZE, MAX_SUPPORTED_CHANGE_EPOCH, } from './manager.js';
2
10
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../internal/groups/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../internal/groups/index.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGvF,OAAO,EACL,UAAU,EACV,cAAc,EACd,YAAY,EA2BZ,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,EACvB,gCAAgC,EAChC,gCAAgC,EAChC,aAAa,EACb,aAAa,EACb,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAErE,OAAO,EACL,WAAW,EAGX,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,EACvB,6BAA6B,EAC7B,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,OAAO,EACP,QAAQ,EACR,SAAS,EACT,QAAQ,GACT,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,0BAA0B,EAC1B,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,GAErB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,0BAA0B,GAY3B,MAAM,WAAW,CAAC"}
@@ -0,0 +1 @@
1
+ {"version":3,"file":"invite-link.d.ts","sourceRoot":"","sources":["../../../internal/groups/invite-link.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH;;GAEG;AACH,OAAO,EAAE,CAAC;AACV,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,mBAAmB,IAAO,CAAC;AAExC;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,iCAAiC,CAAC;AAQjE;;;;GAIG;AACH,wBAAgB,0BAA0B,IAAI,UAAU,CAEvD;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,UAAU,EACrB,kBAAkB,EAAE,UAAU,EAC9B,UAAU,GAAE,MAA2B,GACtC,MAAM,CAqBR;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,EACX,UAAU,GAAE,MAA2B,GACtC;IACD,SAAS,EAAE,UAAU,CAAC;IACtB,kBAAkB,EAAE,UAAU,CAAC;CAChC,GAAG,IAAI,CA2BP"}
@@ -0,0 +1 @@
1
+ {"version":3,"file":"invite-link.js","sourceRoot":"","sources":["../../../internal/groups/invite-link.ts"],"names":[],"mappings":"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"}
@@ -1,5 +1,5 @@
1
1
  /**
2
- * GroupsV2 Manager
2
+ * Group manager
3
3
  *
4
4
  * Orchestrates group lifecycle operations:
5
5
  * - Group creation/deletion
@@ -17,12 +17,14 @@
17
17
  * - SenderKeyManager for group messaging key rotation
18
18
  * - Server relay for state storage
19
19
  *
20
- * @module groups-v2/manager
20
+ * @module groups/manager
21
21
  */
22
22
  import { type GroupSecretParams, type ServiceId } from '../protocol/zk/groups/index.js';
23
23
  import { type DecryptedGroup, type DecryptedGroupChange, type AccessControl, MemberRole } from './types.js';
24
24
  import type { GroupId } from '../groups/group-id.js';
25
25
  import type { CredentialPublicKey } from '../protocol/zk/credentials/credentials.js';
26
+ import { receiveProfileKeyCredential } from '../protocol/zk/groups/profile-key-credential.js';
27
+ import type { PresentationContext } from './encrypted-state.js';
26
28
  /**
27
29
  * Serialized auth credential for server verification.
28
30
  *
@@ -51,37 +53,69 @@ export interface IGroupStateStore {
51
53
  deleteMasterKey(groupId: string): Promise<void>;
52
54
  /** Store decrypted group state cache. */
53
55
  storeGroupState(groupId: string, state: DecryptedGroup): Promise<void>;
56
+ /**
57
+ * Atomically store accepted group state and establish C7's sender-key
58
+ * rotation barrier at that state's revision.
59
+ */
60
+ storeGroupStateWithSenderKeyRotationBarrier(groupId: string, state: DecryptedGroup): Promise<void>;
54
61
  /** Get cached decrypted group state. */
55
62
  getGroupState(groupId: string): Promise<DecryptedGroup | null>;
63
+ /** Get the accepted revision whose C7 rotation is still pending. */
64
+ getSenderKeyRotationBarrier(groupId: string): Promise<number | null>;
65
+ /**
66
+ * Clear C7's barrier only when it still names `expectedRevision`.
67
+ * A stale completion must never clear a newer accepted transition.
68
+ */
69
+ clearSenderKeyRotationBarrier(groupId: string, expectedRevision: number): Promise<void>;
56
70
  /** Delete cached group state. */
57
71
  deleteGroupState(groupId: string): Promise<void>;
58
72
  }
59
73
  /**
60
74
  * Interface for server-side group operations.
61
75
  *
62
- * The server stores encrypted (opaque) group state and enforces
63
- * version sequencing. It never decrypts group content.
76
+ * The server stores encrypted group state, verifies presentations, evaluates
77
+ * policy through deterministic ciphertext comparison, and enforces version
78
+ * sequencing. It never decrypts group content.
64
79
  */
65
80
  export interface IGroupServer {
66
81
  /** Create a new group on the server. */
67
82
  createGroup(groupId: Uint8Array, encryptedState: Uint8Array, authorization: GroupAuthorization): Promise<void>;
68
- /** Get the latest encrypted group state. */
69
- getGroup(groupId: Uint8Array, authorization: GroupAuthorization): Promise<{
70
- encryptedState: Uint8Array;
83
+ /**
84
+ * Get encrypted group state.
85
+ *
86
+ * When `version` is supplied, the server must return that exact historical
87
+ * snapshot or null. Versioned reads make the post-join baseline race-safe:
88
+ * clients must not jump over unverified changes to a newer snapshot.
89
+ */
90
+ getGroup(groupId: Uint8Array, authorization: GroupAuthorization, version?: number): Promise<GroupSnapshot | null>;
91
+ /** Get the reduced invite-link projection after server-side password verification. */
92
+ getGroupJoinInfo(groupId: Uint8Array, inviteLinkPassword: Uint8Array, authorization: GroupAuthorization): Promise<{
93
+ encryptedJoinInfo: Uint8Array;
71
94
  version: number;
72
95
  } | null>;
73
- /** Get change log entries from a given version. */
96
+ /**
97
+ * Get the authorized change-log prefix after a historical version.
98
+ *
99
+ * Authorization is evaluated at the `fromVersion` snapshot. The response
100
+ * includes the first transition that makes the requester unreadable, then
101
+ * stops; a requester already unreadable at that snapshot is refused.
102
+ */
74
103
  getGroupChanges(groupId: Uint8Array, fromVersion: number, authorization: GroupAuthorization): Promise<GroupChangeLogEntry[]>;
75
104
  /** Submit a group change (optimistic concurrency). */
76
- submitGroupChange(groupId: Uint8Array, expectedVersion: number, encryptedChange: Uint8Array, updatedEncryptedState: Uint8Array, authorization: GroupAuthorization): Promise<{
77
- serverSignature: Uint8Array;
78
- }>;
105
+ submitGroupChange(groupId: Uint8Array, expectedVersion: number, actions: Uint8Array, inviteLinkPassword: Uint8Array, authorization: GroupAuthorization): Promise<GroupChangeLogEntry>;
106
+ }
107
+ /** A canonical encrypted state and the server's S14 commitment to it. */
108
+ export interface GroupSnapshot {
109
+ encryptedState: Uint8Array;
110
+ version: number;
111
+ baselineSignature: Uint8Array;
79
112
  }
80
113
  /** A single change log entry from the server. */
81
114
  export interface GroupChangeLogEntry {
82
115
  version: number;
83
- encryptedChange: Uint8Array;
116
+ actions: Uint8Array;
84
117
  serverSignature: Uint8Array;
118
+ changeEpoch: number;
85
119
  timestamp: number;
86
120
  }
87
121
  /**
@@ -99,7 +133,7 @@ export type OnSenderKeyRotation = (groupId: GroupId) => Promise<void>;
99
133
  * Non-fatal — endorsements are lazily refreshed on next send.
100
134
  */
101
135
  export type OnEndorsementsInvalidated = (groupId: string) => Promise<void>;
102
- export interface GroupsV2ManagerOptions {
136
+ export interface GroupManagerOptions {
103
137
  /** Local group state storage. */
104
138
  store: IGroupStateStore;
105
139
  /** Server-side group operations. */
@@ -112,42 +146,79 @@ export interface GroupsV2ManagerOptions {
112
146
  issueCredential: () => Promise<Uint8Array>;
113
147
  /** Server's credential public key for verifying issuance proofs. */
114
148
  credentialPublicKey: CredentialPublicKey;
149
+ /**
150
+ * Pinned server change-signing key.
151
+ *
152
+ * When omitted, `allowUnauthenticatedGroupHistory` must be explicitly set
153
+ * to enter the documented non-conforming deployment mode.
154
+ */
155
+ serverSigningPublicKey?: Uint8Array;
156
+ /**
157
+ * Explicitly accept group history without server signatures.
158
+ *
159
+ * This is a security downgrade for deployments whose group server does not
160
+ * implement the enforcing-server obligations. It is consulted only when
161
+ * `serverSigningPublicKey` is absent.
162
+ */
163
+ allowUnauthenticatedGroupHistory?: boolean;
164
+ /** Receive non-conforming group-server configuration warnings. */
165
+ onConfigurationWarning?: (warning: GroupConfigurationWarning) => void;
115
166
  /** User's ACI for credential presentation. */
116
167
  aci: ServiceId;
117
- /** User's PNI for credential presentation (optional — nil UUID used for non-phone apps). */
168
+ /** User's PNI for credential presentation, when the account has one. */
118
169
  pni?: ServiceId;
119
170
  /** Issue a fresh profile key credential from the server. Returns serialized response. */
120
- issueProfileKeyCredential?: () => Promise<Uint8Array>;
171
+ issueProfileKeyCredential: () => Promise<Uint8Array>;
121
172
  /** Server's profile key credential public key. */
122
- profileKeyCredentialPublicKey?: CredentialPublicKey;
173
+ profileKeyCredentialPublicKey: CredentialPublicKey;
123
174
  /** User's 32-byte profile key for profile key credential. */
124
- profileKey?: Uint8Array;
175
+ profileKey: Uint8Array;
176
+ }
177
+ /** A target whose profile-key credential is available for an immediate add. */
178
+ export interface PresentedGroupMemberInput {
179
+ aciBytes: Uint8Array;
180
+ profileKey: Uint8Array;
181
+ profileKeyCredential: ReturnType<typeof receiveProfileKeyCredential>;
182
+ role?: MemberRole;
183
+ }
184
+ /** A target invited without a profile key; they present when accepting. */
185
+ export interface InvitedGroupMemberInput {
186
+ serviceIdBytes: Uint8Array;
187
+ role?: MemberRole;
188
+ }
189
+ /** A member introduction accepted by createGroup() and addMember(). */
190
+ export type GroupMemberInput = PresentedGroupMemberInput | InvitedGroupMemberInput;
191
+ export interface GroupConfigurationWarning {
192
+ code: 'GROUP_SERVER_SIGNATURE_VERIFICATION_DISABLED';
193
+ message: string;
125
194
  }
126
195
  /**
127
- * Manages GroupsV2 lifecycle and state.
196
+ * Manages group lifecycle and state.
128
197
  *
129
198
  * This is the primary entry point for group operations. It coordinates
130
199
  * between crypto primitives, storage, and server communication.
131
200
  */
132
201
  /** Default maximum group size enforced by the manager. */
133
202
  export declare const MAX_GROUP_SIZE = 1000;
134
- export declare class GroupsV2Manager {
203
+ export declare const MAX_SUPPORTED_CHANGE_EPOCH = 6;
204
+ export declare class GroupManager {
135
205
  private readonly store;
136
206
  private readonly server;
137
207
  private readonly onSenderKeyRotation?;
138
208
  private readonly onEndorsementsInvalidated?;
139
209
  private readonly issueCredential;
140
210
  private readonly credentialPublicKey;
211
+ private readonly serverSigningPublicKey?;
141
212
  private readonly aci;
142
- private readonly pni;
143
- private readonly issueProfileKeyCredentialFn?;
144
- private readonly profileKeyCredentialPublicKey?;
145
- private readonly profileKey?;
213
+ private readonly pni?;
214
+ private readonly issueProfileKeyCredentialFn;
215
+ private readonly profileKeyCredentialPublicKey;
216
+ private readonly profileKey;
146
217
  private cachedCredential;
147
218
  private cachedProfileKeyCredential;
148
219
  /** Serializes credential fetches to prevent duplicate network requests. */
149
220
  private readonly credentialLock;
150
- constructor(options: GroupsV2ManagerOptions);
221
+ constructor(options: GroupManagerOptions);
151
222
  /**
152
223
  * Build authorization for a group operation.
153
224
  *
@@ -162,8 +233,7 @@ export declare class GroupsV2Manager {
162
233
  getAuthorization(rawGroupId: string): Promise<GroupAuthorization>;
163
234
  /**
164
235
  * Get or refresh the profile key credential for the current user.
165
- * Returns a PresentationContext if profile key credentials are configured,
166
- * otherwise undefined.
236
+ * Group profile-key introductions are never permitted without this proof.
167
237
  */
168
238
  private getPresentationContext;
169
239
  /**
@@ -190,16 +260,13 @@ export declare class GroupsV2Manager {
190
260
  *
191
261
  * @param creatorAci - 16-byte ACI of the group creator
192
262
  * @param creatorProfileKey - 32-byte profile key of the creator
193
- * @param members - Additional members to add (ACI + profile key + role)
263
+ * @param members - Targets with presentation material to add, or ServiceIds
264
+ * to invite without profile material
194
265
  * @param title - Group title
195
266
  * @param options - Optional settings (description, access control, avatar, timer)
196
267
  * @returns GroupId and master key
197
268
  */
198
- createGroup(creatorAci: Uint8Array, creatorProfileKey: Uint8Array, members: Array<{
199
- aciBytes: Uint8Array;
200
- profileKey: Uint8Array;
201
- role?: MemberRole;
202
- }>, title: string, options?: {
269
+ createGroup(creatorAci: Uint8Array, creatorProfileKey: Uint8Array, members: GroupMemberInput[], title: string, options?: {
203
270
  description?: string;
204
271
  accessControl?: Partial<AccessControl>;
205
272
  avatarUrl?: string;
@@ -226,16 +293,58 @@ export declare class GroupsV2Manager {
226
293
  * @returns Updated decrypted group state
227
294
  */
228
295
  syncGroup(groupId: GroupId): Promise<DecryptedGroup>;
296
+ /**
297
+ * Verify, authorize, structurally validate, and apply one server change.
298
+ *
299
+ * This is the only path by which a signed Actions value advances cached
300
+ * state. Each successful prefix is persisted before the next entry is read.
301
+ */
302
+ private applyVerifiedChange;
303
+ /**
304
+ * Revision 20's two §11 projection-only action surfaces.
305
+ *
306
+ * The normal C6 path evaluates result-state invariants against complete
307
+ * verified state. A prospective link joiner cannot see the member list, so
308
+ * only these additive self-actions may skip predicates that need it.
309
+ */
310
+ private isRestrictedGroupJoinInfoChange;
311
+ private changesMembership;
312
+ private requiresSenderKeyRotation;
313
+ private securityReactionPendingError;
314
+ private completePendingSenderKeyRotation;
315
+ /**
316
+ * Retry and clear a durable C7 barrier, including after reconstruction.
317
+ */
318
+ retryPendingSenderKeyRotation(groupId: GroupId | string): Promise<void>;
319
+ /**
320
+ * Enforce C7 rotation readiness and C10 send eligibility.
321
+ */
322
+ assertGroupSendAllowed(groupId: GroupId | string): Promise<void>;
229
323
  /**
230
324
  * Add a member to the group.
231
325
  *
232
326
  * @param groupId - Group identifier
233
327
  * @param editorAci - ACI of the user performing the action
234
- * @param newMemberAci - ACI of the new member
235
- * @param newMemberProfileKey - Profile key of the new member
236
- * @param role - Role for the new member (default: DEFAULT)
328
+ * A target with presentation material is added immediately. Otherwise the
329
+ * target is invited without a profile key and presents when accepting.
330
+ */
331
+ addMember(groupId: GroupId, editorAci: Uint8Array, member: GroupMemberInput): Promise<void>;
332
+ /**
333
+ * Accept this client's pending profile-key invitation.
334
+ *
335
+ * The pending entry carries no profile key. Acceptance introduces the
336
+ * client's own profile-key ciphertext together with the mandatory S12
337
+ * presentation, using the PNI-to-ACI promotion when the invitation is
338
+ * keyed by this account's PNI.
237
339
  */
238
- addMember(groupId: GroupId, editorAci: Uint8Array, newMemberAci: Uint8Array, newMemberProfileKey: Uint8Array, role?: MemberRole): Promise<void>;
340
+ acceptMemberInvitation(groupId: GroupId): Promise<void>;
341
+ /**
342
+ * Decline one of this account's pending profile-key invitations.
343
+ *
344
+ * Selecting the ACI invitation is the self-service resolution for a
345
+ * conflicting dual ACI+PNI invitation before accepting the PNI invitation.
346
+ */
347
+ declineMemberInvitation(groupId: GroupId, identity?: 'aci' | 'pni'): Promise<void>;
239
348
  /**
240
349
  * Remove a member from the group.
241
350
  *
@@ -300,6 +409,13 @@ export declare class GroupsV2Manager {
300
409
  * Toggle announcement-only mode.
301
410
  */
302
411
  setAnnouncementMode(groupId: GroupId, editorAci: Uint8Array, enabled: boolean): Promise<void>;
412
+ /**
413
+ * Permanently terminate a group.
414
+ *
415
+ * Termination is an administrator-only, irreversible state transition and
416
+ * triggers sender-key rotation through the verified-change reaction path.
417
+ */
418
+ terminateGroup(groupId: GroupId, editorAci: Uint8Array): Promise<void>;
303
419
  /**
304
420
  * Create an invite link for the group.
305
421
  *
@@ -323,6 +439,12 @@ export declare class GroupsV2Manager {
323
439
  groupId: GroupId;
324
440
  status: 'joined' | 'pending_approval';
325
441
  }>;
442
+ /** Whether this client's verified local span still carries full-state read access. */
443
+ private isReadableBySelf;
444
+ /** Verify the S14 commitment before parsing or installing a snapshot. */
445
+ private verifyBaselineSignature;
446
+ /** Verify, bind, and decrypt one canonical full-state response. */
447
+ private decryptVerifiedSnapshot;
326
448
  /**
327
449
  * Get GroupSecretParams for a group from stored master key.
328
450
  */
@@ -335,15 +457,28 @@ export declare class GroupsV2Manager {
335
457
  * adding a full member (AddMemberAction, PromotePending, etc.).
336
458
  */
337
459
  private submitChange;
460
+ /**
461
+ * Mirror S3's action-named attribution before falling back to state lookup.
462
+ *
463
+ * A self-targeted pending delete exercises the named alias, as does a
464
+ * PNI-to-ACI promotion. One accepted change may exercise only one alias.
465
+ */
466
+ private actionNamedSourceServiceId;
467
+ /**
468
+ * Mirror S3's deterministic pre-state attribution for ordinary actions.
469
+ *
470
+ * ACI wins when both aliases occur in state; a PNI-only pending invitee is
471
+ * attributed to that PNI so self-decline remains possible.
472
+ */
473
+ private sourceServiceIdForState;
338
474
  }
339
475
  /**
340
476
  * Encrypt and serialize a DecryptedGroupChange for server submission.
341
477
  *
342
- * Encrypts identity fields (ACI, PNI, profileKey) using zkgroup primitives,
343
- * then serializes as JSON with hex-encoded binary fields.
344
- * The server treats the resulting bytes as opaque.
478
+ * The client deliberately leaves sourceUserId and groupId unset. A conforming
479
+ * server derives and sets both before signing the accepted Actions.
345
480
  */
346
- export declare function encryptAndSerializeChange(change: DecryptedGroupChange, secretParams: GroupSecretParams): Uint8Array;
481
+ export declare function encryptAndSerializeChange(change: DecryptedGroupChange, secretParams: GroupSecretParams, memberPresentationContexts?: ReadonlyMap<string, PresentationContext>): Uint8Array;
347
482
  /**
348
483
  * Deserialize and decrypt a change from server.
349
484
  *
@@ -0,0 +1 @@
1
+ {"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../internal/groups/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,SAAS,EAYf,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,KAAK,cAAc,EAMnB,KAAK,oBAAoB,EAyBzB,KAAK,aAAa,EAClB,UAAU,EAKX,MAAM,SAAS,CAAC;AAwCjB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAIlD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAUlF,OAAO,EACL,2BAA2B,EAE5B,MAAM,8CAA8C,CAAC;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAmB7D;;;;;GAKG;AACH,OAAO,EAAE,CAAC;AACV,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,YAAY,EAAE,UAAU,CAAC;IACzB,uFAAuF;IACvF,iBAAiB,EAAE,UAAU,CAAC;CAC/B;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,8BAA8B;IAC9B,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAC1D,iCAAiC;IACjC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD,yCAAyC;IACzC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE;;;OAGG;IACH,2CAA2C,CACzC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,wCAAwC;IACxC,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC/D,oEAAoE;IACpE,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACrE;;;OAGG;IACH,6BAA6B,CAC3B,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,iCAAiC;IACjC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,WAAW,CACT,OAAO,EAAE,UAAU,EACnB,cAAc,EAAE,UAAU,EAC1B,aAAa,EAAE,kBAAkB,GAChC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;OAMG;IACH,QAAQ,CACN,OAAO,EAAE,UAAU,EACnB,aAAa,EAAE,kBAAkB,EACjC,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAEjC,sFAAsF;IACtF,gBAAgB,CACd,OAAO,EAAE,UAAU,EACnB,kBAAkB,EAAE,UAAU,EAC9B,aAAa,EAAE,kBAAkB,GAChC,OAAO,CAAC;QAAE,iBAAiB,EAAE,UAAU,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAEtE;;;;;;OAMG;IACH,eAAe,CACb,OAAO,EAAE,UAAU,EACnB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,kBAAkB,GAChC,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAElC,sDAAsD;IACtD,iBAAiB,CACf,OAAO,EAAE,UAAU,EACnB,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,UAAU,EACnB,kBAAkB,EAAE,UAAU,EAC9B,aAAa,EAAE,kBAAkB,GAChC,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACjC;AAED,yEAAyE;AACzE,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,UAAU,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,UAAU,CAAC;CAC/B;AAED,iDAAiD;AACjD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,UAAU,CAAC;IACpB,eAAe,EAAE,UAAU,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEtE;;;;;;GAMG;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAM3E,MAAM,WAAW,mBAAmB;IAClC,iCAAiC;IACjC,KAAK,EAAE,gBAAgB,CAAC;IACxB,oCAAoC;IACpC,MAAM,EAAE,YAAY,CAAC;IACrB,8DAA8D;IAC9D,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,sEAAsE;IACtE,yBAAyB,CAAC,EAAE,yBAAyB,CAAC;IACtD,uFAAuF;IACvF,eAAe,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3C,oEAAoE;IACpE,mBAAmB,EAAE,mBAAmB,CAAC;IACzC;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,UAAU,CAAC;IACpC;;;;;;OAMG;IACH,gCAAgC,CAAC,EAAE,OAAO,CAAC;IAC3C,kEAAkE;IAClE,sBAAsB,CAAC,EAAE,CAAC,OAAO,EAAE,yBAAyB,KAAK,IAAI,CAAC;IACtE,8CAA8C;IAC9C,GAAG,EAAE,SAAS,CAAC;IACf,wEAAwE;IACxE,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,yFAAyF;IACzF,yBAAyB,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;IACrD,kDAAkD;IAClD,6BAA6B,EAAE,mBAAmB,CAAC;IACnD,6DAA6D;IAC7D,UAAU,EAAE,UAAU,CAAC;CACxB;AAED,+EAA+E;AAC/E,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,UAAU,CAAC;IACrB,UAAU,EAAE,UAAU,CAAC;IACvB,oBAAoB,EAAE,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAAC;IACrE,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED,2EAA2E;AAC3E,MAAM,WAAW,uBAAuB;IACtC,cAAc,EAAE,UAAU,CAAC;IAC3B,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED,uEAAuE;AACvE,MAAM,MAAM,gBAAgB,GACxB,yBAAyB,GACzB,uBAAuB,CAAC;AA8F5B,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,8CAA8C,CAAC;IACrD,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD;;;;;GAKG;AACH,0DAA0D;AAC1D,eAAO,MAAM,cAAc,OAAO,CAAC;AACnC,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAsB;IAC3D,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAA4B;IACvE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA4B;IAC5D,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAsB;IAC1D,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAa;IACrD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAY;IAChC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAY;IACjC,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAA4B;IACxE,OAAO,CAAC,QAAQ,CAAC,6BAA6B,CAAsB;IACpE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,gBAAgB,CACjB;IACP,OAAO,CAAC,0BAA0B,CAGlB;IAChB,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAmB;IAElD,YAAY,OAAO,EAAE,mBAAmB,EAwCvC;IAMD;;;;;;;;;;OAUG;IACG,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAsCtE;IAED;;;OAGG;YACW,sBAAsB;IA0BpC;;;;;;;OAOG;YACW,aAAa;IAkB3B;;;;;OAKG;YACW,sBAAsB;IAapC;;;;;;;;;;;;;OAaG;IACG,WAAW,CACf,UAAU,EAAE,UAAU,EACtB,iBAAiB,EAAE,UAAU,EAC7B,OAAO,EAAE,gBAAgB,EAAE,EAC3B,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;QACvC,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,4BAA4B,CAAC,EAAE,MAAM,CAAC;KACvC,GACA,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,UAAU,CAAA;KAAE,CAAC,CAoItD;IAMD;;;;;;;OAOG;IACG,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CAS7D;IAED;;;;;;;OAOG;IACG,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CAqFzD;IAED;;;;;OAKG;YACW,mBAAmB;IAgHjC;;;;;;OAMG;IACH,OAAO,CAAC,+BAA+B;IAwBvC,OAAO,CAAC,iBAAiB;IAkBzB,OAAO,CAAC,yBAAyB;IAUjC,OAAO,CAAC,4BAA4B;YAetB,gCAAgC;IAuB9C;;OAEG;IACG,6BAA6B,CACjC,OAAO,EAAE,OAAO,GAAG,MAAM,GACxB,OAAO,CAAC,IAAI,CAAC,CAOf;IAED;;OAEG;IACG,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA2CrE;IAMD;;;;;;;OAOG;IACG,SAAS,CACb,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,UAAU,EACrB,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,IAAI,CAAC,CA2Ef;IAED;;;;;;;OAOG;IACG,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAoD5D;IAED;;;;;OAKG;IACG,uBAAuB,CAC3B,OAAO,EAAE,OAAO,EAChB,QAAQ,GAAE,KAAK,GAAG,KAAa,GAC9B,OAAO,CAAC,IAAI,CAAC,CA8Bf;IAED;;;;;;;;OAQG;IACG,YAAY,CAChB,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,UAAU,EACrB,SAAS,EAAE,UAAU,GACpB,OAAO,CAAC,IAAI,CAAC,CAoBf;IAED;;;;;OAKG;IACG,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAErE;IAED;;;;;;;OAOG;IACG,gBAAgB,CACpB,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,UAAU,EACrB,SAAS,EAAE,UAAU,EACrB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,IAAI,CAAC,CAiBf;IAED;;;;;;;;;OASG;IACG,SAAS,CACb,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,UAAU,EACrB,eAAe,EAAE,UAAU,GAC1B,OAAO,CAAC,IAAI,CAAC,CAuBf;IAMD;;;;;OAKG;YACW,oBAAoB;IAiBlC;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIvF;IAED;;OAEG;IACG,iBAAiB,CACrB,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,UAAU,EACrB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CASf;IAED;;OAEG;IACG,+BAA+B,CACnC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,UAAU,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CASf;IAED;;OAEG;IACG,mBAAmB,CACvB,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,UAAU,EACrB,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAC9B,OAAO,CAAC,IAAI,CAAC,CAiCf;IAED;;OAEG;IACG,mBAAmB,CACvB,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,UAAU,EACrB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC,CASf;IAED;;;;;OAKG;IACG,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAS3E;IAMD;;;;;;OAMG;IACG,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAkC/E;IAED;;;;;;;;;;OAUG;IACG,iBAAiB,CACrB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,UAAU,EACnB,cAAc,EAAE,UAAU,GACzB,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,QAAQ,GAAG,kBAAkB,CAAA;KAAE,CAAC,CAsQtE;IAMD,sFAAsF;IACtF,OAAO,CAAC,gBAAgB;IAiBxB,yEAAyE;IACzE,OAAO,CAAC,uBAAuB;IAsB/B,mEAAmE;IACnE,OAAO,CAAC,uBAAuB;IAqC/B;;OAEG;YACW,eAAe;IAS7B;;;;;;OAMG;YACW,YAAY;IA6E1B;;;;;OAKG;IACH,OAAO,CAAC,0BAA0B;IA+ClC;;;;;OAKG;IACH,OAAO,CAAC,uBAAuB;CAehC;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,oBAAoB,EAC5B,YAAY,EAAE,iBAAiB,EAC/B,0BAA0B,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,mBAAmB,CAAC,GACpE,UAAU,CAuCZ;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,UAAU,EACjB,YAAY,EAAE,iBAAiB,GAC9B,oBAAoB,CAEtB"}