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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (730) hide show
  1. package/ADAPTERS.md +1 -1
  2. package/ARCHITECTURE.md +1 -1
  3. package/CHANGELOG.md +876 -3
  4. package/COMMERCIAL.md +56 -0
  5. package/README.md +13 -8
  6. package/SECURITY.md +15 -1
  7. package/client/README.md +1 -1
  8. package/dist/client/client.d.ts +32 -28
  9. package/dist/client/client.d.ts.map +1 -1
  10. package/dist/client/client.js +136 -80
  11. package/dist/client/client.js.map +1 -1
  12. package/dist/client/compose.d.ts +6 -1
  13. package/dist/client/compose.d.ts.map +1 -1
  14. package/dist/client/compose.js +2 -0
  15. package/dist/client/compose.js.map +1 -1
  16. package/dist/client/config.d.ts +53 -19
  17. package/dist/client/config.d.ts.map +1 -1
  18. package/dist/client/config.js.map +1 -1
  19. package/dist/client/endorsement-manager.d.ts +23 -2
  20. package/dist/client/endorsement-manager.d.ts.map +1 -1
  21. package/dist/client/endorsement-manager.js +35 -10
  22. package/dist/client/endorsement-manager.js.map +1 -1
  23. package/dist/client/groups.d.ts +29 -29
  24. package/dist/client/groups.d.ts.map +1 -1
  25. package/dist/client/groups.js +54 -37
  26. package/dist/client/groups.js.map +1 -1
  27. package/dist/client/headless.d.ts +1 -1
  28. package/dist/client/headless.js +1 -1
  29. package/dist/client/sealed-sender-ops.d.ts +27 -1
  30. package/dist/client/sealed-sender-ops.d.ts.map +1 -1
  31. package/dist/client/sealed-sender-ops.js +36 -6
  32. package/dist/client/sealed-sender-ops.js.map +1 -1
  33. package/dist/client/signal-service-cipher.d.ts +21 -2
  34. package/dist/client/signal-service-cipher.d.ts.map +1 -1
  35. package/dist/client/signal-service-cipher.js +119 -53
  36. package/dist/client/signal-service-cipher.js.map +1 -1
  37. package/dist/client/types.d.ts +20 -7
  38. package/dist/client/types.d.ts.map +1 -1
  39. package/dist/client/types.js.map +1 -1
  40. package/dist/groups/index.d.ts +4 -4
  41. package/dist/groups/index.d.ts.map +1 -1
  42. package/dist/groups/index.js +3 -3
  43. package/dist/groups/index.js.map +1 -1
  44. package/dist/index.d.ts +12 -5
  45. package/dist/index.d.ts.map +1 -1
  46. package/dist/index.js +10 -3
  47. package/dist/index.js.map +1 -1
  48. package/dist/internal/crypto/index.d.ts +1 -1
  49. package/dist/internal/crypto/index.d.ts.map +1 -1
  50. package/dist/internal/crypto/index.js +1 -1
  51. package/dist/internal/crypto/index.js.map +1 -1
  52. package/dist/internal/crypto/random.d.ts +9 -0
  53. package/dist/internal/crypto/random.d.ts.map +1 -1
  54. package/dist/internal/crypto/random.js +16 -0
  55. package/dist/internal/crypto/random.js.map +1 -1
  56. package/dist/internal/groups/access-control.d.ts +170 -0
  57. package/dist/internal/groups/access-control.d.ts.map +1 -0
  58. package/dist/internal/groups/access-control.js +284 -0
  59. package/dist/internal/groups/access-control.js.map +1 -0
  60. package/dist/internal/groups/change-actions.d.ts +57 -0
  61. package/dist/internal/groups/change-actions.d.ts.map +1 -0
  62. package/dist/internal/groups/change-actions.js +827 -0
  63. package/dist/internal/groups/change-actions.js.map +1 -0
  64. package/dist/internal/groups/change-authorization.d.ts +16 -0
  65. package/dist/internal/groups/change-authorization.d.ts.map +1 -0
  66. package/dist/internal/groups/change-authorization.js +120 -0
  67. package/dist/internal/groups/change-authorization.js.map +1 -0
  68. package/dist/internal/{groups-v2 → groups}/encrypted-state.d.ts +12 -2
  69. package/dist/internal/groups/encrypted-state.d.ts.map +1 -0
  70. package/dist/internal/{groups-v2 → groups}/encrypted-state.js +122 -22
  71. package/dist/internal/groups/encrypted-state.js.map +1 -0
  72. package/dist/internal/groups/group-id.d.ts +9 -9
  73. package/dist/internal/groups/group-id.d.ts.map +1 -1
  74. package/dist/internal/groups/group-id.js +11 -12
  75. package/dist/internal/groups/group-id.js.map +1 -1
  76. package/dist/internal/groups/index.d.ts +16 -6
  77. package/dist/internal/groups/index.d.ts.map +1 -1
  78. package/dist/internal/groups/index.js +9 -1
  79. package/dist/internal/groups/index.js.map +1 -1
  80. package/dist/internal/groups/invite-link.d.ts.map +1 -0
  81. package/dist/internal/groups/invite-link.js.map +1 -0
  82. package/dist/internal/{groups-v2 → groups}/manager.d.ts +188 -40
  83. package/dist/internal/groups/manager.d.ts.map +1 -0
  84. package/dist/internal/groups/manager.js +1923 -0
  85. package/dist/internal/groups/manager.js.map +1 -0
  86. package/dist/internal/groups/sdk-store.d.ts +32 -0
  87. package/dist/internal/groups/sdk-store.d.ts.map +1 -0
  88. package/dist/internal/groups/sdk-store.js +111 -0
  89. package/dist/internal/groups/sdk-store.js.map +1 -0
  90. package/dist/internal/groups/server-engine.d.ts +83 -0
  91. package/dist/internal/groups/server-engine.d.ts.map +1 -0
  92. package/dist/internal/groups/server-engine.js +1186 -0
  93. package/dist/internal/groups/server-engine.js.map +1 -0
  94. package/dist/internal/groups/trust-root.d.ts +32 -0
  95. package/dist/internal/groups/trust-root.d.ts.map +1 -0
  96. package/dist/internal/groups/trust-root.js +91 -0
  97. package/dist/internal/groups/trust-root.js.map +1 -0
  98. package/dist/internal/{groups-v2 → groups}/types.d.ts +188 -46
  99. package/dist/internal/groups/types.d.ts.map +1 -0
  100. package/dist/internal/{groups-v2 → groups}/types.js +3 -2
  101. package/dist/internal/groups/types.js.map +1 -0
  102. package/dist/internal/groups/wire.d.ts +68 -0
  103. package/dist/internal/groups/wire.d.ts.map +1 -0
  104. package/dist/internal/groups/wire.js +708 -0
  105. package/dist/internal/groups/wire.js.map +1 -0
  106. package/dist/internal/protocol/sealed-sender/decryption-v2.d.ts.map +1 -1
  107. package/dist/internal/protocol/sealed-sender/decryption-v2.js +32 -18
  108. package/dist/internal/protocol/sealed-sender/decryption-v2.js.map +1 -1
  109. package/dist/internal/protocol/sealed-sender/decryption.d.ts.map +1 -1
  110. package/dist/internal/protocol/sealed-sender/decryption.js +33 -19
  111. package/dist/internal/protocol/sealed-sender/decryption.js.map +1 -1
  112. package/dist/internal/protocol/sealed-sender/encryption-v2.d.ts.map +1 -1
  113. package/dist/internal/protocol/sealed-sender/encryption-v2.js +8 -14
  114. package/dist/internal/protocol/sealed-sender/encryption-v2.js.map +1 -1
  115. package/dist/internal/protocol/sealed-sender/encryption.d.ts +9 -4
  116. package/dist/internal/protocol/sealed-sender/encryption.d.ts.map +1 -1
  117. package/dist/internal/protocol/sealed-sender/encryption.js +7 -15
  118. package/dist/internal/protocol/sealed-sender/encryption.js.map +1 -1
  119. package/dist/internal/protocol/sealed-sender/proto/index.d.ts +6 -7
  120. package/dist/internal/protocol/sealed-sender/proto/index.d.ts.map +1 -1
  121. package/dist/internal/protocol/sealed-sender/proto/index.js +5 -7
  122. package/dist/internal/protocol/sealed-sender/proto/index.js.map +1 -1
  123. package/dist/internal/protocol/sealed-sender/trust-root.d.ts +45 -0
  124. package/dist/internal/protocol/sealed-sender/trust-root.d.ts.map +1 -0
  125. package/dist/internal/protocol/sealed-sender/trust-root.js +77 -0
  126. package/dist/internal/protocol/sealed-sender/trust-root.js.map +1 -0
  127. package/dist/internal/protocol/sealed-sender/types.d.ts +64 -9
  128. package/dist/internal/protocol/sealed-sender/types.d.ts.map +1 -1
  129. package/dist/internal/protocol/sealed-sender/types.js +43 -0
  130. package/dist/internal/protocol/sealed-sender/types.js.map +1 -1
  131. package/dist/internal/protocol/sender-keys/index.d.ts +1 -1
  132. package/dist/internal/protocol/sender-keys/manager.d.ts +38 -1
  133. package/dist/internal/protocol/sender-keys/manager.d.ts.map +1 -1
  134. package/dist/internal/protocol/sender-keys/manager.js +109 -8
  135. package/dist/internal/protocol/sender-keys/manager.js.map +1 -1
  136. package/dist/internal/protocol/zk/groups/auth-credential.d.ts +9 -7
  137. package/dist/internal/protocol/zk/groups/auth-credential.d.ts.map +1 -1
  138. package/dist/internal/protocol/zk/groups/auth-credential.js +68 -29
  139. package/dist/internal/protocol/zk/groups/auth-credential.js.map +1 -1
  140. package/dist/internal/protocol/zk/groups/server-params.d.ts +1 -1
  141. package/dist/internal/protocol/zk/groups/server-params.d.ts.map +1 -1
  142. package/dist/internal/protocol/zk/groups/server-params.js.map +1 -1
  143. package/dist/internal/protocol/zk/groups/uid-struct.d.ts +2 -0
  144. package/dist/internal/protocol/zk/groups/uid-struct.d.ts.map +1 -1
  145. package/dist/internal/protocol/zk/groups/uid-struct.js +4 -0
  146. package/dist/internal/protocol/zk/groups/uid-struct.js.map +1 -1
  147. package/dist/layers.d.ts +1 -1
  148. package/dist/layers.js +3 -3
  149. package/dist/layers.js.map +1 -1
  150. package/dist/local/store/expo/adapter.d.ts +14 -15
  151. package/dist/local/store/expo/adapter.d.ts.map +1 -1
  152. package/dist/local/store/expo/adapter.js +109 -102
  153. package/dist/local/store/expo/adapter.js.map +1 -1
  154. package/dist/local/store/expo/db.d.ts +4 -1
  155. package/dist/local/store/expo/db.d.ts.map +1 -1
  156. package/dist/local/store/expo/db.js +5 -0
  157. package/dist/local/store/expo/db.js.map +1 -1
  158. package/dist/local/store/expo/index.d.ts +0 -2
  159. package/dist/local/store/expo/index.d.ts.map +1 -1
  160. package/dist/local/store/expo/index.js +1 -1
  161. package/dist/local/store/expo/index.js.map +1 -1
  162. package/dist/local/store/expo/models/index.d.ts +1 -1
  163. package/dist/local/store/expo/models/index.d.ts.map +1 -1
  164. package/dist/local/store/expo/models/index.js +2 -2
  165. package/dist/local/store/expo/models/index.js.map +1 -1
  166. package/dist/local/store/expo/models/sender-key.d.ts +101 -77
  167. package/dist/local/store/expo/models/sender-key.d.ts.map +1 -1
  168. package/dist/local/store/expo/models/sender-key.js +154 -124
  169. package/dist/local/store/expo/models/sender-key.js.map +1 -1
  170. package/dist/local/store/expo/schema.d.ts +134 -32
  171. package/dist/local/store/expo/schema.d.ts.map +1 -1
  172. package/dist/local/store/expo/schema.js +36 -7
  173. package/dist/local/store/expo/schema.js.map +1 -1
  174. package/dist/local/store/mock/adapter.d.ts +1 -0
  175. package/dist/local/store/mock/adapter.d.ts.map +1 -1
  176. package/dist/local/store/mock/adapter.js +18 -0
  177. package/dist/local/store/mock/adapter.js.map +1 -1
  178. package/dist/local/store/react-native/adapter.d.ts +39 -0
  179. package/dist/local/store/react-native/adapter.d.ts.map +1 -1
  180. package/dist/local/store/react-native/adapter.js +163 -8
  181. package/dist/local/store/react-native/adapter.js.map +1 -1
  182. package/dist/local/store/web/adapter.d.ts +1 -0
  183. package/dist/local/store/web/adapter.d.ts.map +1 -1
  184. package/dist/local/store/web/adapter.js +33 -1
  185. package/dist/local/store/web/adapter.js.map +1 -1
  186. package/dist/remote/relay/convex/backend.d.ts +402 -0
  187. package/dist/remote/relay/convex/backend.d.ts.map +1 -0
  188. package/dist/remote/relay/convex/backend.js +684 -0
  189. package/dist/remote/relay/convex/backend.js.map +1 -0
  190. package/dist/remote/relay/convex/component/_generated/api.d.ts +58 -0
  191. package/dist/remote/relay/convex/component/_generated/api.d.ts.map +1 -0
  192. package/dist/remote/relay/convex/component/_generated/api.js +31 -0
  193. package/dist/remote/relay/convex/component/_generated/api.js.map +1 -0
  194. package/dist/remote/relay/convex/component/_generated/component.d.ts +480 -0
  195. package/dist/remote/relay/convex/component/_generated/component.d.ts.map +1 -0
  196. package/dist/remote/relay/convex/component/_generated/component.js +11 -0
  197. package/dist/remote/relay/convex/component/_generated/component.js.map +1 -0
  198. package/dist/remote/relay/convex/component/_generated/dataModel.d.ts +46 -0
  199. package/dist/remote/relay/convex/component/_generated/dataModel.d.ts.map +1 -0
  200. package/dist/remote/relay/convex/component/_generated/dataModel.js +11 -0
  201. package/dist/remote/relay/convex/component/_generated/dataModel.js.map +1 -0
  202. package/dist/remote/relay/convex/component/_generated/server.d.ts +129 -0
  203. package/dist/remote/relay/convex/component/_generated/server.d.ts.map +1 -0
  204. package/dist/remote/relay/convex/component/_generated/server.js +79 -0
  205. package/dist/remote/relay/convex/component/_generated/server.js.map +1 -0
  206. package/dist/remote/relay/convex/component/accounts.d.ts +43 -0
  207. package/dist/remote/relay/convex/component/accounts.d.ts.map +1 -0
  208. package/dist/remote/relay/convex/component/accounts.js +181 -0
  209. package/dist/remote/relay/convex/component/accounts.js.map +1 -0
  210. package/dist/remote/relay/convex/component/certificates.d.ts +10 -0
  211. package/dist/remote/relay/convex/component/certificates.d.ts.map +1 -0
  212. package/dist/remote/relay/convex/component/certificates.js +122 -0
  213. package/dist/remote/relay/convex/component/certificates.js.map +1 -0
  214. package/dist/remote/relay/convex/component/cleanup.d.ts +26 -0
  215. package/dist/remote/relay/convex/component/cleanup.d.ts.map +1 -0
  216. package/dist/remote/relay/convex/component/cleanup.js +127 -0
  217. package/dist/remote/relay/convex/component/cleanup.js.map +1 -0
  218. package/dist/remote/relay/convex/component/convex.config.d.ts +5 -0
  219. package/dist/remote/relay/convex/component/convex.config.d.ts.map +1 -0
  220. package/dist/remote/relay/convex/component/convex.config.js +33 -0
  221. package/dist/remote/relay/convex/component/convex.config.js.map +1 -0
  222. package/dist/remote/relay/convex/component/crons.d.ts +3 -0
  223. package/dist/remote/relay/convex/component/crons.d.ts.map +1 -0
  224. package/dist/remote/relay/convex/component/crons.js +9 -0
  225. package/dist/remote/relay/convex/component/crons.js.map +1 -0
  226. package/dist/remote/relay/convex/component/devices.d.ts +101 -0
  227. package/dist/remote/relay/convex/component/devices.d.ts.map +1 -0
  228. package/dist/remote/relay/convex/component/devices.js +299 -0
  229. package/dist/remote/relay/convex/component/devices.js.map +1 -0
  230. package/dist/remote/relay/convex/component/errors.d.ts +22 -0
  231. package/dist/remote/relay/convex/component/errors.d.ts.map +1 -0
  232. package/dist/remote/relay/convex/component/errors.js +17 -0
  233. package/dist/remote/relay/convex/component/errors.js.map +1 -0
  234. package/dist/remote/relay/convex/component/groups.d.ts +60 -0
  235. package/dist/remote/relay/convex/component/groups.d.ts.map +1 -0
  236. package/dist/remote/relay/convex/component/groups.js +331 -0
  237. package/dist/remote/relay/convex/component/groups.js.map +1 -0
  238. package/dist/remote/relay/convex/component/keys.d.ts +130 -0
  239. package/dist/remote/relay/convex/component/keys.d.ts.map +1 -0
  240. package/dist/remote/relay/convex/component/keys.js +578 -0
  241. package/dist/remote/relay/convex/component/keys.js.map +1 -0
  242. package/dist/remote/relay/convex/component/messages.d.ts +119 -0
  243. package/dist/remote/relay/convex/component/messages.d.ts.map +1 -0
  244. package/dist/remote/relay/convex/component/messages.js +649 -0
  245. package/dist/remote/relay/convex/component/messages.js.map +1 -0
  246. package/dist/remote/relay/convex/component/provisioning.d.ts +92 -0
  247. package/dist/remote/relay/convex/component/provisioning.d.ts.map +1 -0
  248. package/dist/remote/relay/convex/component/provisioning.js +359 -0
  249. package/dist/remote/relay/convex/component/provisioning.js.map +1 -0
  250. package/dist/remote/relay/convex/component/runtime.d.ts +18 -0
  251. package/dist/remote/relay/convex/component/runtime.d.ts.map +1 -0
  252. package/dist/remote/relay/convex/component/runtime.js +142 -0
  253. package/dist/remote/relay/convex/component/runtime.js.map +1 -0
  254. package/dist/remote/relay/convex/component/schema.d.ts +344 -0
  255. package/dist/remote/relay/convex/component/schema.d.ts.map +1 -0
  256. package/dist/remote/relay/convex/component/schema.js +266 -0
  257. package/dist/remote/relay/convex/component/schema.js.map +1 -0
  258. package/dist/remote/relay/convex/component/zkAuth.d.ts +12 -0
  259. package/dist/remote/relay/convex/component/zkAuth.d.ts.map +1 -0
  260. package/dist/remote/relay/convex/component/zkAuth.js +71 -0
  261. package/dist/remote/relay/convex/component/zkAuth.js.map +1 -0
  262. package/dist/remote/relay/convex/constants.d.ts +3 -0
  263. package/dist/remote/relay/convex/constants.d.ts.map +1 -0
  264. package/dist/remote/relay/convex/constants.js +3 -0
  265. package/dist/remote/relay/convex/constants.js.map +1 -0
  266. package/dist/remote/relay/convex/group-server.d.ts +25 -21
  267. package/dist/remote/relay/convex/group-server.d.ts.map +1 -1
  268. package/dist/remote/relay/convex/group-server.js +51 -21
  269. package/dist/remote/relay/convex/group-server.js.map +1 -1
  270. package/dist/remote/relay/convex/index.d.ts +4 -1
  271. package/dist/remote/relay/convex/index.d.ts.map +1 -1
  272. package/dist/remote/relay/convex/index.js +3 -1
  273. package/dist/remote/relay/convex/index.js.map +1 -1
  274. package/dist/remote/relay/convex/relay.d.ts +54 -67
  275. package/dist/remote/relay/convex/relay.d.ts.map +1 -1
  276. package/dist/remote/relay/convex/relay.js +123 -42
  277. package/dist/remote/relay/convex/relay.js.map +1 -1
  278. package/dist/remote/relay/convex/types.d.ts +16 -103
  279. package/dist/remote/relay/convex/types.d.ts.map +1 -1
  280. package/dist/remote/relay/convex/types.js +8 -13
  281. package/dist/remote/relay/convex/types.js.map +1 -1
  282. package/dist/remote/relay/index.d.ts +1 -1
  283. package/dist/remote/relay/index.d.ts.map +1 -1
  284. package/dist/remote/relay/mock/adapter.d.ts +33 -20
  285. package/dist/remote/relay/mock/adapter.d.ts.map +1 -1
  286. package/dist/remote/relay/mock/adapter.js +98 -81
  287. package/dist/remote/relay/mock/adapter.js.map +1 -1
  288. package/dist/remote/relay/mock/group-server.d.ts +9 -0
  289. package/dist/remote/relay/mock/group-server.d.ts.map +1 -0
  290. package/dist/remote/relay/mock/group-server.js +9 -0
  291. package/dist/remote/relay/mock/group-server.js.map +1 -0
  292. package/dist/remote/relay/types.d.ts +73 -79
  293. package/dist/remote/relay/types.d.ts.map +1 -1
  294. package/dist/remote/relay/types.js +0 -1
  295. package/dist/remote/relay/types.js.map +1 -1
  296. package/dist/types/api.d.ts +23 -2
  297. package/dist/types/api.d.ts.map +1 -1
  298. package/dist/types/protocol-config.d.ts +51 -0
  299. package/dist/types/protocol-config.d.ts.map +1 -1
  300. package/dist/types/protocol-config.js +46 -0
  301. package/dist/types/protocol-config.js.map +1 -1
  302. package/docs/ASSURANCE.md +10 -6
  303. package/docs/CLIENT_COMPOSITION.md +23 -69
  304. package/docs/DEVIATIONS.md +77 -41
  305. package/docs/E2EE.md +71 -6
  306. package/docs/GETTING_STARTED.md +1 -1
  307. package/docs/PACKAGE_SURFACE.md +6 -0
  308. package/docs/RECIPES.md +1 -1
  309. package/docs/SECURITY.md +8 -0
  310. package/groups/README.md +16 -5
  311. package/local/store/expo/README.md +10 -1
  312. package/local/store/node/README.md +10 -1
  313. package/package.json +20 -4
  314. package/remote/relay/convex/README.md +6 -0
  315. package/remote/relay/convex/component/README.md +428 -0
  316. package/scripts/oe-groups.mjs +162 -0
  317. package/dist/internal/groups-v2/access-control.d.ts +0 -108
  318. package/dist/internal/groups-v2/access-control.d.ts.map +0 -1
  319. package/dist/internal/groups-v2/access-control.js +0 -191
  320. package/dist/internal/groups-v2/access-control.js.map +0 -1
  321. package/dist/internal/groups-v2/change-actions.d.ts +0 -40
  322. package/dist/internal/groups-v2/change-actions.d.ts.map +0 -1
  323. package/dist/internal/groups-v2/change-actions.js +0 -363
  324. package/dist/internal/groups-v2/change-actions.js.map +0 -1
  325. package/dist/internal/groups-v2/encrypted-state.d.ts.map +0 -1
  326. package/dist/internal/groups-v2/encrypted-state.js.map +0 -1
  327. package/dist/internal/groups-v2/index.d.ts +0 -19
  328. package/dist/internal/groups-v2/index.d.ts.map +0 -1
  329. package/dist/internal/groups-v2/index.js +0 -11
  330. package/dist/internal/groups-v2/index.js.map +0 -1
  331. package/dist/internal/groups-v2/invite-link.d.ts.map +0 -1
  332. package/dist/internal/groups-v2/invite-link.js.map +0 -1
  333. package/dist/internal/groups-v2/manager.d.ts.map +0 -1
  334. package/dist/internal/groups-v2/manager.js +0 -1095
  335. package/dist/internal/groups-v2/manager.js.map +0 -1
  336. package/dist/internal/groups-v2/types.d.ts.map +0 -1
  337. package/dist/internal/groups-v2/types.js.map +0 -1
  338. package/docs/api/README.md +0 -471
  339. package/docs/api/classes/EncryptionError.md +0 -112
  340. package/docs/api/classes/EndorsementManager.md +0 -307
  341. package/docs/api/classes/SealedSenderAuthError.md +0 -127
  342. package/docs/api/classes/ServerDerivedKeyPair.md +0 -68
  343. package/docs/api/classes/ServerDerivedPublicKey.md +0 -33
  344. package/docs/api/classes/ServerRootKeyPair.md +0 -94
  345. package/docs/api/classes/ServerRootPublicKey.md +0 -72
  346. package/docs/api/classes/SignalProtocolBlockingManager.md +0 -106
  347. package/docs/api/classes/SignalProtocolClient.md +0 -2654
  348. package/docs/api/classes/VerificationFailure.md +0 -25
  349. package/docs/api/enumerations/ContentHint.md +0 -63
  350. package/docs/api/enumerations/EncryptionErrorCode.md +0 -488
  351. package/docs/api/enumerations/IdentityKeyChange.md +0 -65
  352. package/docs/api/enumerations/MessageType.md +0 -29
  353. package/docs/api/enumerations/TrustDirection.md +0 -33
  354. package/docs/api/enumerations/TypingAction.md +0 -31
  355. package/docs/api/functions/createDefaultSignalProtocolContentAdapter.md +0 -13
  356. package/docs/api/functions/createDefaultSignalProtocolLogger.md +0 -36
  357. package/docs/api/functions/createGroupId.md +0 -32
  358. package/docs/api/functions/createSignalProtocolClient.md +0 -36
  359. package/docs/api/functions/createSignalProtocolClientConfig.md +0 -24
  360. package/docs/api/functions/extractGroupId.md +0 -32
  361. package/docs/api/functions/formatVersion.md +0 -25
  362. package/docs/api/functions/isCompatible.md +0 -31
  363. package/docs/api/functions/isGroupId.md +0 -37
  364. package/docs/api/functions/isSealedSenderAuthError.md +0 -25
  365. package/docs/api/functions/parseVersion.md +0 -29
  366. package/docs/api/functions/resolveSPQRLimits.md +0 -21
  367. package/docs/api/functions/resolveSignalProtocolLogger.md +0 -42
  368. package/docs/api/interfaces/AccountIdentityProvisioning.md +0 -43
  369. package/docs/api/interfaces/AccountIdentityRotation.md +0 -69
  370. package/docs/api/interfaces/AttachmentTransferOptions.md +0 -49
  371. package/docs/api/interfaces/BlockedRecipientEntry.md +0 -25
  372. package/docs/api/interfaces/BlockedRecipientsSyncInput.md +0 -27
  373. package/docs/api/interfaces/ConfigurationSyncInput.md +0 -19
  374. package/docs/api/interfaces/CredentialPublicKey.md +0 -25
  375. package/docs/api/interfaces/DataMessageInput.md +0 -21
  376. package/docs/api/interfaces/DecryptedEnvelope.md +0 -95
  377. package/docs/api/interfaces/DecryptedGroup.md +0 -86
  378. package/docs/api/interfaces/DeviceInfo.md +0 -79
  379. package/docs/api/interfaces/DeviceRecord.md +0 -87
  380. package/docs/api/interfaces/DeviceRegistration.md +0 -27
  381. package/docs/api/interfaces/DoubleRatchetConfig.md +0 -36
  382. package/docs/api/interfaces/EcOneTimePreKey.md +0 -27
  383. package/docs/api/interfaces/EcSignedPreKey.md +0 -39
  384. package/docs/api/interfaces/EcSignedPreKeyUpload.md +0 -50
  385. package/docs/api/interfaces/EncryptionErrorContext.md +0 -51
  386. package/docs/api/interfaces/Envelope.md +0 -154
  387. package/docs/api/interfaces/ForceKeyResetResult.md +0 -37
  388. package/docs/api/interfaces/GroupAuthorization.md +0 -23
  389. package/docs/api/interfaces/GroupChangeEntry.md +0 -42
  390. package/docs/api/interfaces/GroupMemberDevice.md +0 -26
  391. package/docs/api/interfaces/IEcOneTimePreKeyStore.md +0 -86
  392. package/docs/api/interfaces/IEcSignedPreKeyStore.md +0 -133
  393. package/docs/api/interfaces/IGroupServer.md +0 -120
  394. package/docs/api/interfaces/IGroupStateStore.md +0 -128
  395. package/docs/api/interfaces/IIdentityKeyStore.md +0 -312
  396. package/docs/api/interfaces/IKemPreKeyStore.md +0 -144
  397. package/docs/api/interfaces/IKyberLastResortPreKeyStore.md +0 -112
  398. package/docs/api/interfaces/ILogger.md +0 -117
  399. package/docs/api/interfaces/IProtocolStore.md +0 -1033
  400. package/docs/api/interfaces/ISenderKeyStore.md +0 -417
  401. package/docs/api/interfaces/ISesameStore.md +0 -249
  402. package/docs/api/interfaces/ISessionStore.md +0 -178
  403. package/docs/api/interfaces/ISignalProtocolClient.md +0 -1185
  404. package/docs/api/interfaces/ISignalProtocolLocalSecretVault.md +0 -71
  405. package/docs/api/interfaces/ISignalProtocolLocalStore.md +0 -2053
  406. package/docs/api/interfaces/ISignalProtocolManager.md +0 -272
  407. package/docs/api/interfaces/ISignalProtocolRelayServer.md +0 -1329
  408. package/docs/api/interfaces/IdentityKeyPair.md +0 -49
  409. package/docs/api/interfaces/IncomingEnvelope.md +0 -91
  410. package/docs/api/interfaces/InspectedSignalProtocolContent.md +0 -43
  411. package/docs/api/interfaces/KDFChain.md +0 -31
  412. package/docs/api/interfaces/KemLastResortPreKeyUpload.md +0 -50
  413. package/docs/api/interfaces/KeyPair.md +0 -23
  414. package/docs/api/interfaces/KyberPreKey.md +0 -42
  415. package/docs/api/interfaces/MLKEMBraidAgentState.md +0 -191
  416. package/docs/api/interfaces/MLKEMBraidMessage.md +0 -49
  417. package/docs/api/interfaces/MediaAttachmentDeleteSyncInput.md +0 -31
  418. package/docs/api/interfaces/MessageHeader.md +0 -49
  419. package/docs/api/interfaces/MessageRecord.md +0 -86
  420. package/docs/api/interfaces/ParsedReceiptContent.md +0 -19
  421. package/docs/api/interfaces/ParsedTypingContent.md +0 -19
  422. package/docs/api/interfaces/PreKeyMaintenanceStore.md +0 -88
  423. package/docs/api/interfaces/PreKeyMessage.md +0 -159
  424. package/docs/api/interfaces/PreKeyStatusResult.md +0 -21
  425. package/docs/api/interfaces/PreKeyUpload.md +0 -42
  426. package/docs/api/interfaces/ProcessEnvelopeOptions.md +0 -72
  427. package/docs/api/interfaces/ProtocolAddress.md +0 -38
  428. package/docs/api/interfaces/ProtocolStrategyConfig.md +0 -91
  429. package/docs/api/interfaces/RatchetMessage.md +0 -96
  430. package/docs/api/interfaces/ReadSyncEntryInput.md +0 -19
  431. package/docs/api/interfaces/ReceiverChain.md +0 -43
  432. package/docs/api/interfaces/RecipientUsernameSyncInput.md +0 -31
  433. package/docs/api/interfaces/RelayPreKeyBundle.md +0 -254
  434. package/docs/api/interfaces/RemoteObjectDownload.md +0 -33
  435. package/docs/api/interfaces/RemoteObjectUpload.md +0 -49
  436. package/docs/api/interfaces/ResolvedSPQRInfoStrings.md +0 -27
  437. package/docs/api/interfaces/ResolvedSPQRLimits.md +0 -37
  438. package/docs/api/interfaces/RetryRequest.md +0 -80
  439. package/docs/api/interfaces/SCKAState.md +0 -65
  440. package/docs/api/interfaces/SPQRLimits.md +0 -40
  441. package/docs/api/interfaces/SPQRState.md +0 -191
  442. package/docs/api/interfaces/SafetyNumber.md +0 -60
  443. package/docs/api/interfaces/SafetyNumberConfirmation.md +0 -46
  444. package/docs/api/interfaces/SealedSenderConfig.md +0 -70
  445. package/docs/api/interfaces/SendOptions.md +0 -191
  446. package/docs/api/interfaces/SendResult.md +0 -93
  447. package/docs/api/interfaces/SenderKeyDistributionMessage.md +0 -43
  448. package/docs/api/interfaces/SenderKeyState.md +0 -76
  449. package/docs/api/interfaces/SenderKeysConfig.md +0 -65
  450. package/docs/api/interfaces/SentSyncTranscriptInput.md +0 -31
  451. package/docs/api/interfaces/ServiceId.md +0 -19
  452. package/docs/api/interfaces/SesameMessage.md +0 -84
  453. package/docs/api/interfaces/SesameStats.md +0 -57
  454. package/docs/api/interfaces/SessionHealthResult.md +0 -120
  455. package/docs/api/interfaces/SessionRecord.md +0 -80
  456. package/docs/api/interfaces/SessionRecordMetadata.md +0 -109
  457. package/docs/api/interfaces/SessionState.md +0 -368
  458. package/docs/api/interfaces/SessionTrustCommit.md +0 -58
  459. package/docs/api/interfaces/SignalProtocolBlockingHooks.md +0 -44
  460. package/docs/api/interfaces/SignalProtocolBlockingManagerOptions.md +0 -31
  461. package/docs/api/interfaces/SignalProtocolBlockingMirror.md +0 -30
  462. package/docs/api/interfaces/SignalProtocolBlockingStore.md +0 -83
  463. package/docs/api/interfaces/SignalProtocolClientAdapterConfig.md +0 -44
  464. package/docs/api/interfaces/SignalProtocolClientCompositionOptions.md +0 -693
  465. package/docs/api/interfaces/SignalProtocolClientConfig.md +0 -839
  466. package/docs/api/interfaces/SignalProtocolClientDeleteLocalAttachmentInput.md +0 -25
  467. package/docs/api/interfaces/SignalProtocolClientHooks.md +0 -506
  468. package/docs/api/interfaces/SignalProtocolClientIdentityConfig.md +0 -35
  469. package/docs/api/interfaces/SignalProtocolClientLoadLocalAttachmentInput.md +0 -187
  470. package/docs/api/interfaces/SignalProtocolClientLoadedLocalAttachment.md +0 -19
  471. package/docs/api/interfaces/SignalProtocolClientMedia.md +0 -83
  472. package/docs/api/interfaces/SignalProtocolClientMediaCompletedResult.md +0 -25
  473. package/docs/api/interfaces/SignalProtocolClientMediaConfig.md +0 -157
  474. package/docs/api/interfaces/SignalProtocolClientMediaDownloadCompletedResult.md +0 -37
  475. package/docs/api/interfaces/SignalProtocolClientMediaDownloadNotNeededResult.md +0 -25
  476. package/docs/api/interfaces/SignalProtocolClientMediaFailedResult.md +0 -19
  477. package/docs/api/interfaces/SignalProtocolClientMediaOperationOptions.md +0 -53
  478. package/docs/api/interfaces/SignalProtocolClientMediaPendingResult.md +0 -19
  479. package/docs/api/interfaces/SignalProtocolClientMediaProcessResult.md +0 -43
  480. package/docs/api/interfaces/SignalProtocolClientMediaSkippedResult.md +0 -25
  481. package/docs/api/interfaces/SignalProtocolClientMediaUploadCompletedResult.md +0 -31
  482. package/docs/api/interfaces/SignalProtocolClientProcessPendingMediaOptions.md +0 -87
  483. package/docs/api/interfaces/SignalProtocolClientSaveDownloadedAttachmentInput.md +0 -25
  484. package/docs/api/interfaces/SignalProtocolClientSaveUploadedAttachmentInput.md +0 -25
  485. package/docs/api/interfaces/SignalProtocolClientSyncDeleteInput.md +0 -19
  486. package/docs/api/interfaces/SignalProtocolConfig.md +0 -50
  487. package/docs/api/interfaces/SignalProtocolContentAdapter.md +0 -325
  488. package/docs/api/interfaces/SignalProtocolRemoteObjectStore.md +0 -88
  489. package/docs/api/interfaces/SkippedSenderMessageKey.md +0 -26
  490. package/docs/api/interfaces/TaskNotificationAckSyncInput.md +0 -31
  491. package/docs/api/interfaces/TripleRatchetState.md +0 -64
  492. package/docs/api/interfaces/UserRecord.md +0 -71
  493. package/docs/api/interfaces/UsernameStateSyncInput.md +0 -19
  494. package/docs/api/interfaces/VerificationStateSyncInput.md +0 -31
  495. package/docs/api/interfaces/VersionNegotiationState.md +0 -84
  496. package/docs/api/interfaces/ViewOnceOpenSyncInput.md +0 -19
  497. package/docs/api/namespaces/ProtocolAddress/README.md +0 -33
  498. package/docs/api/namespaces/ProtocolAddress/functions/create.md +0 -41
  499. package/docs/api/namespaces/ProtocolAddress/functions/equals.md +0 -39
  500. package/docs/api/namespaces/ProtocolAddress/functions/fromStorageKey.md +0 -36
  501. package/docs/api/namespaces/ProtocolAddress/functions/isUser.md +0 -39
  502. package/docs/api/namespaces/ProtocolAddress/functions/isValid.md +0 -34
  503. package/docs/api/namespaces/ProtocolAddress/functions/parse.md +0 -41
  504. package/docs/api/namespaces/ProtocolAddress/functions/toStorageKey.md +0 -38
  505. package/docs/api/namespaces/ProtocolAddress/functions/toString.md +0 -34
  506. package/docs/api/namespaces/SessionRecord/README.md +0 -30
  507. package/docs/api/namespaces/SessionRecord/functions/archiveCurrent.md +0 -40
  508. package/docs/api/namespaces/SessionRecord/functions/archiveCurrentState.md +0 -34
  509. package/docs/api/namespaces/SessionRecord/functions/create.md +0 -25
  510. package/docs/api/namespaces/SessionRecord/functions/deserialize.md +0 -29
  511. package/docs/api/namespaces/SessionRecord/functions/findSession.md +0 -34
  512. package/docs/api/namespaces/SessionRecord/functions/getAllSessions.md +0 -25
  513. package/docs/api/namespaces/SessionRecord/functions/getArchivedCount.md +0 -25
  514. package/docs/api/namespaces/SessionRecord/functions/hasCurrentSession.md +0 -25
  515. package/docs/api/namespaces/SessionRecord/functions/hasUsableSenderChain.md +0 -36
  516. package/docs/api/namespaces/SessionRecord/functions/promoteSession.md +0 -34
  517. package/docs/api/namespaces/SessionRecord/functions/serialize.md +0 -28
  518. package/docs/api/namespaces/SessionRecord/variables/MAX_ARCHIVED_SESSIONS.md +0 -14
  519. package/docs/api/namespaces/SessionState/README.md +0 -15
  520. package/docs/api/namespaces/SessionState/functions/getSessionId.md +0 -32
  521. package/docs/api/namespaces/blocking/README.md +0 -43
  522. package/docs/api/namespaces/encoding/README.md +0 -33
  523. package/docs/api/namespaces/encoding/functions/base64ToUrlSafe.md +0 -28
  524. package/docs/api/namespaces/encoding/functions/bytesToBase64.md +0 -21
  525. package/docs/api/namespaces/encoding/functions/bytesToString.md +0 -21
  526. package/docs/api/namespaces/encoding/functions/bytesToUrlSafeBase64.md +0 -33
  527. package/docs/api/namespaces/encoding/functions/concatBytes.md +0 -21
  528. package/docs/api/namespaces/encoding/functions/stringToBytes.md +0 -21
  529. package/docs/api/namespaces/encoding/functions/urlSafeToBase64.md +0 -27
  530. package/docs/api/namespaces/keys/README.md +0 -130
  531. package/docs/api/namespaces/keys/functions/acceptContactIdentityRotation.md +0 -33
  532. package/docs/api/namespaces/keys/functions/assertIdentityCommitment.md +0 -25
  533. package/docs/api/namespaces/keys/functions/canonicalizeDeviceIdentityKey.md +0 -30
  534. package/docs/api/namespaces/keys/functions/compareDeviceIdentityKeys.md +0 -28
  535. package/docs/api/namespaces/keys/functions/compositeIdentitiesEqual.md +0 -23
  536. package/docs/api/namespaces/keys/functions/createCompositeIdentityV1.md +0 -19
  537. package/docs/api/namespaces/keys/functions/createPreKeySignatureContext.md +0 -31
  538. package/docs/api/namespaces/keys/functions/createUnverifiedContactIdentityRecord.md +0 -23
  539. package/docs/api/namespaces/keys/functions/decodeCompositeIdentityV1.md +0 -19
  540. package/docs/api/namespaces/keys/functions/deriveIdentityCommitment.md +0 -19
  541. package/docs/api/namespaces/keys/functions/encodeCompositeIdentityV1.md +0 -19
  542. package/docs/api/namespaces/keys/functions/evaluateContactIdentityCandidate.md +0 -27
  543. package/docs/api/namespaces/keys/functions/generateEcOneTimePreKeys.md +0 -37
  544. package/docs/api/namespaces/keys/functions/generateEcSignedPreKey.md +0 -39
  545. package/docs/api/namespaces/keys/functions/generateEcSignedPreKeyId.md +0 -21
  546. package/docs/api/namespaces/keys/functions/generateIdentityKeyPair.md +0 -24
  547. package/docs/api/namespaces/keys/functions/generateKemOneTimePreKeys.md +0 -47
  548. package/docs/api/namespaces/keys/functions/generateKyberLastResortPreKey.md +0 -37
  549. package/docs/api/namespaces/keys/functions/generateRegistrationId.md +0 -13
  550. package/docs/api/namespaces/keys/functions/isValidDeviceIdentityKey.md +0 -22
  551. package/docs/api/namespaces/keys/functions/signMlKem1024PreKey.md +0 -29
  552. package/docs/api/namespaces/keys/functions/signPreKey.md +0 -31
  553. package/docs/api/namespaces/keys/functions/validateContactIdentityRecord.md +0 -19
  554. package/docs/api/namespaces/keys/functions/verifyContactIdentityRecord.md +0 -31
  555. package/docs/api/namespaces/keys/functions/verifyMlKem1024PreKey.md +0 -33
  556. package/docs/api/namespaces/keys/functions/verifyPreKeySignature.md +0 -35
  557. package/docs/api/namespaces/keys/interfaces/CompositeIdentityV1.md +0 -33
  558. package/docs/api/namespaces/keys/interfaces/ContactIdentityRecord.md +0 -53
  559. package/docs/api/namespaces/keys/interfaces/KemOneTimePreKey.md +0 -43
  560. package/docs/api/namespaces/keys/type-aliases/IdentityCandidateStatus.md +0 -9
  561. package/docs/api/namespaces/keys/type-aliases/IdentityTrustState.md +0 -9
  562. package/docs/api/namespaces/keys/type-aliases/IdentityType.md +0 -9
  563. package/docs/api/namespaces/keys/variables/COMPOSITE_IDENTITY_V1_ED25519_TAG.md +0 -9
  564. package/docs/api/namespaces/keys/variables/COMPOSITE_IDENTITY_V1_LENGTH.md +0 -9
  565. package/docs/api/namespaces/keys/variables/COMPOSITE_IDENTITY_V1_VERSION.md +0 -9
  566. package/docs/api/namespaces/keys/variables/COMPOSITE_IDENTITY_V1_X25519_TAG.md +0 -9
  567. package/docs/api/namespaces/keys/variables/IDENTITY_COMMITMENT_V1_DOMAIN.md +0 -9
  568. package/docs/api/namespaces/keys/variables/PREKEY_ALGORITHM_ML_KEM_1024.md +0 -9
  569. package/docs/api/namespaces/keys/variables/PREKEY_ALGORITHM_X25519.md +0 -9
  570. package/docs/api/namespaces/keys/variables/PREKEY_SIGNATURE_V1_DOMAIN.md +0 -9
  571. package/docs/api/namespaces/keys/variables/UNPINNED_DEVICE_IDENTITY_KEY.md +0 -18
  572. package/docs/api/namespaces/media/README.md +0 -105
  573. package/docs/api/namespaces/media/classes/MediaAttachmentError.md +0 -57
  574. package/docs/api/namespaces/media/functions/createByteRangeMediaAttachmentTransfer.md +0 -19
  575. package/docs/api/namespaces/media/functions/createMediaAttachmentDeliveryId.md +0 -29
  576. package/docs/api/namespaces/media/functions/createMediaAttachmentId.md +0 -19
  577. package/docs/api/namespaces/media/functions/createMediaAttachmentMessage.md +0 -25
  578. package/docs/api/namespaces/media/functions/createMediaAttachmentPointer.md +0 -19
  579. package/docs/api/namespaces/media/functions/createTusMediaAttachmentTransfer.md +0 -19
  580. package/docs/api/namespaces/media/functions/deleteMediaAttachment.md +0 -23
  581. package/docs/api/namespaces/media/functions/executeMediaAttachmentJob.md +0 -23
  582. package/docs/api/namespaces/media/functions/isMediaAttachmentFlagSet.md +0 -19
  583. package/docs/api/namespaces/media/functions/parseMediaAttachmentMessage.md +0 -19
  584. package/docs/api/namespaces/media/functions/planMediaAttachmentCleanup.md +0 -23
  585. package/docs/api/namespaces/media/functions/planMediaAttachmentCleanupJobs.md +0 -19
  586. package/docs/api/namespaces/media/functions/planMediaAttachmentDeleteSync.md +0 -19
  587. package/docs/api/namespaces/media/functions/planMediaAttachmentDownloadJob.md +0 -19
  588. package/docs/api/namespaces/media/functions/planMediaAttachmentOpen.md +0 -19
  589. package/docs/api/namespaces/media/functions/planMediaAttachmentProcessing.md +0 -19
  590. package/docs/api/namespaces/media/functions/planMediaAttachmentUploadJob.md +0 -19
  591. package/docs/api/namespaces/media/functions/prepareMediaAttachmentUpload.md +0 -30
  592. package/docs/api/namespaces/media/functions/resolveMediaAttachment.md +0 -30
  593. package/docs/api/namespaces/media/functions/serializeMediaAttachmentMessage.md +0 -25
  594. package/docs/api/namespaces/media/functions/validateMediaAttachmentPolicy.md +0 -23
  595. package/docs/api/namespaces/media/interfaces/ByteRangeMediaAttachmentPartialStore.md +0 -68
  596. package/docs/api/namespaces/media/interfaces/ByteRangeMediaAttachmentTransferOptions.md +0 -91
  597. package/docs/api/namespaces/media/interfaces/DeleteMediaAttachmentOptions.md +0 -25
  598. package/docs/api/namespaces/media/interfaces/DeleteMediaAttachmentResult.md +0 -19
  599. package/docs/api/namespaces/media/interfaces/ExecuteMediaAttachmentJobOptions.md +0 -157
  600. package/docs/api/namespaces/media/interfaces/MediaAttachmentBackgroundJob.md +0 -85
  601. package/docs/api/namespaces/media/interfaces/MediaAttachmentCleanupPlan.md +0 -37
  602. package/docs/api/namespaces/media/interfaces/MediaAttachmentJobExecutionResult.md +0 -55
  603. package/docs/api/namespaces/media/interfaces/MediaAttachmentMessage.md +0 -31
  604. package/docs/api/namespaces/media/interfaces/MediaAttachmentOpenDecision.md +0 -31
  605. package/docs/api/namespaces/media/interfaces/MediaAttachmentPointer.md +0 -133
  606. package/docs/api/namespaces/media/interfaces/MediaAttachmentPolicy.md +0 -67
  607. package/docs/api/namespaces/media/interfaces/MediaAttachmentProcessingPlan.md +0 -73
  608. package/docs/api/namespaces/media/interfaces/MediaAttachmentProgress.md +0 -69
  609. package/docs/api/namespaces/media/interfaces/MediaAttachmentResumeState.md +0 -37
  610. package/docs/api/namespaces/media/interfaces/MediaAttachmentRetryOptions.md +0 -31
  611. package/docs/api/namespaces/media/interfaces/MediaAttachmentTransfer.md +0 -51
  612. package/docs/api/namespaces/media/interfaces/MediaAttachmentTransferCheckpoint.md +0 -69
  613. package/docs/api/namespaces/media/interfaces/MediaAttachmentTransferOptions.md +0 -67
  614. package/docs/api/namespaces/media/interfaces/MediaAttachmentUploadJobData.md +0 -19
  615. package/docs/api/namespaces/media/interfaces/MediaAttachmentUploadResponse.md +0 -25
  616. package/docs/api/namespaces/media/interfaces/PlanMediaAttachmentCleanupJobsInput.md +0 -61
  617. package/docs/api/namespaces/media/interfaces/PlanMediaAttachmentDeleteSyncInput.md +0 -25
  618. package/docs/api/namespaces/media/interfaces/PlanMediaAttachmentDownloadJobInput.md +0 -161
  619. package/docs/api/namespaces/media/interfaces/PlanMediaAttachmentOpenInput.md +0 -25
  620. package/docs/api/namespaces/media/interfaces/PlanMediaAttachmentProcessingInput.md +0 -83
  621. package/docs/api/namespaces/media/interfaces/PlanMediaAttachmentUploadJobInput.md +0 -147
  622. package/docs/api/namespaces/media/interfaces/PrepareMediaAttachmentUploadOptions.md +0 -144
  623. package/docs/api/namespaces/media/interfaces/ResolveMediaAttachmentOptions.md +0 -55
  624. package/docs/api/namespaces/media/interfaces/ResolvedMediaAttachment.md +0 -109
  625. package/docs/api/namespaces/media/interfaces/TusMediaAttachmentTransferOptions.md +0 -85
  626. package/docs/api/namespaces/media/type-aliases/CreateMediaAttachmentPointerInput.md +0 -15
  627. package/docs/api/namespaces/media/type-aliases/MediaAttachmentCheckpointCallback.md +0 -19
  628. package/docs/api/namespaces/media/type-aliases/MediaAttachmentCleanupReason.md +0 -9
  629. package/docs/api/namespaces/media/type-aliases/MediaAttachmentErrorCode.md +0 -9
  630. package/docs/api/namespaces/media/type-aliases/MediaAttachmentFlag.md +0 -9
  631. package/docs/api/namespaces/media/type-aliases/MediaAttachmentJobExecutionStatus.md +0 -9
  632. package/docs/api/namespaces/media/type-aliases/MediaAttachmentJobOperation.md +0 -9
  633. package/docs/api/namespaces/media/type-aliases/MediaAttachmentJobPriority.md +0 -9
  634. package/docs/api/namespaces/media/type-aliases/MediaAttachmentJobSkipReason.md +0 -9
  635. package/docs/api/namespaces/media/type-aliases/MediaAttachmentJobSource.md +0 -9
  636. package/docs/api/namespaces/media/type-aliases/MediaAttachmentKnownIds.md +0 -9
  637. package/docs/api/namespaces/media/type-aliases/MediaAttachmentMessageType.md +0 -9
  638. package/docs/api/namespaces/media/type-aliases/MediaAttachmentProgressCallback.md +0 -19
  639. package/docs/api/namespaces/media/variables/MEDIA_ATTACHMENT_POLICY_DEFAULTS.md +0 -47
  640. package/docs/api/namespaces/media/variables/MEDIA_ATTACHMENT_POLICY_PRESETS.md +0 -95
  641. package/docs/api/namespaces/media/variables/MediaAttachmentCleanupReason.md +0 -27
  642. package/docs/api/namespaces/media/variables/MediaAttachmentErrorCode.md +0 -75
  643. package/docs/api/namespaces/media/variables/MediaAttachmentFlag.md +0 -23
  644. package/docs/api/namespaces/media/variables/MediaAttachmentJobExecutionStatus.md +0 -19
  645. package/docs/api/namespaces/media/variables/MediaAttachmentJobOperation.md +0 -31
  646. package/docs/api/namespaces/media/variables/MediaAttachmentJobPriority.md +0 -23
  647. package/docs/api/namespaces/media/variables/MediaAttachmentJobSource.md +0 -51
  648. package/docs/api/namespaces/media/variables/MediaAttachmentMessageType.md +0 -15
  649. package/docs/api/namespaces/media/variables/downloadMediaAttachment.md +0 -30
  650. package/docs/api/namespaces/safety/README.md +0 -61
  651. package/docs/api/namespaces/safety/classes/DisplayableFingerprint.md +0 -108
  652. package/docs/api/namespaces/safety/classes/Fingerprint.md +0 -104
  653. package/docs/api/namespaces/safety/classes/ScannableFingerprint.md +0 -209
  654. package/docs/api/namespaces/safety/functions/base64ToBytes.md +0 -21
  655. package/docs/api/namespaces/safety/functions/clearFingerprintCache.md +0 -15
  656. package/docs/api/namespaces/safety/functions/compareSafetyNumbers.md +0 -25
  657. package/docs/api/namespaces/safety/functions/createFingerprintData.md +0 -60
  658. package/docs/api/namespaces/safety/functions/extractQrData.md +0 -34
  659. package/docs/api/namespaces/safety/functions/generateCompositeSafetyNumber.md +0 -39
  660. package/docs/api/namespaces/safety/functions/generateEmojiFingerprint.md +0 -24
  661. package/docs/api/namespaces/safety/functions/generateSingleKeyReferenceSafetyNumber.md +0 -51
  662. package/docs/api/namespaces/safety/functions/generateVerifySchemeUrl.md +0 -32
  663. package/docs/api/namespaces/safety/functions/generateVerifyUrl.md +0 -49
  664. package/docs/api/namespaces/safety/functions/isValidSafetyNumber.md +0 -21
  665. package/docs/api/namespaces/safety/functions/isVerifyUrl.md +0 -45
  666. package/docs/api/namespaces/safety/functions/parseVerifyUrl.md +0 -31
  667. package/docs/api/namespaces/safety/interfaces/FingerprintData.md +0 -52
  668. package/docs/api/namespaces/safety/interfaces/SafetyNumber.md +0 -49
  669. package/docs/api/namespaces/safety/interfaces/VerifyLinkConfig.md +0 -28
  670. package/docs/api/namespaces/safety/interfaces/VerifyUrlParams.md +0 -49
  671. package/docs/api/namespaces/safety/type-aliases/CompareResult.md +0 -21
  672. package/docs/api/namespaces/safety/variables/DEFAULT_VERIFY_LINK_CONFIG.md +0 -12
  673. package/docs/api/namespaces/safety/variables/FINGERPRINT_ITERATIONS.md +0 -12
  674. package/docs/api/namespaces/safety/variables/FINGERPRINT_VERSION.md +0 -12
  675. package/docs/api/namespaces/safety/variables/VERIFY_BASE_URL.md +0 -11
  676. package/docs/api/namespaces/safety/variables/VERIFY_SCHEME_URL.md +0 -11
  677. package/docs/api/type-aliases/Base64.md +0 -20
  678. package/docs/api/type-aliases/BraidPolicy.md +0 -11
  679. package/docs/api/type-aliases/Bytes.md +0 -20
  680. package/docs/api/type-aliases/Ciphertext.md +0 -21
  681. package/docs/api/type-aliases/DeviceType.md +0 -11
  682. package/docs/api/type-aliases/DownloadedAttachment.md +0 -11
  683. package/docs/api/type-aliases/GroupId.md +0 -27
  684. package/docs/api/type-aliases/Hex.md +0 -20
  685. package/docs/api/type-aliases/HookName.md +0 -11
  686. package/docs/api/type-aliases/PostQuantumPolicy.md +0 -11
  687. package/docs/api/type-aliases/PreparedAttachmentUpload.md +0 -14
  688. package/docs/api/type-aliases/PrivateKey.md +0 -22
  689. package/docs/api/type-aliases/ProgressCallback.md +0 -45
  690. package/docs/api/type-aliases/PublicKey.md +0 -22
  691. package/docs/api/type-aliases/RemoteObjectCompleteUploadRequest.md +0 -19
  692. package/docs/api/type-aliases/RemoteObjectDeleteRequest.md +0 -19
  693. package/docs/api/type-aliases/RemoteObjectDownloadRequest.md +0 -19
  694. package/docs/api/type-aliases/RemoteObjectUploadRequest.md +0 -42
  695. package/docs/api/type-aliases/SCKAMode.md +0 -11
  696. package/docs/api/type-aliases/SealedSenderAuth.md +0 -15
  697. package/docs/api/type-aliases/SignalProtocolClientMediaCleanupInput.md +0 -9
  698. package/docs/api/type-aliases/SignalProtocolClientMediaCleanupResult.md +0 -9
  699. package/docs/api/type-aliases/SignalProtocolClientMediaDownloadInput.md +0 -9
  700. package/docs/api/type-aliases/SignalProtocolClientMediaDownloadResult.md +0 -9
  701. package/docs/api/type-aliases/SignalProtocolClientMediaOperationResult.md +0 -9
  702. package/docs/api/type-aliases/SignalProtocolClientMediaUploadInput.md +0 -9
  703. package/docs/api/type-aliases/SignalProtocolClientMediaUploadResult.md +0 -9
  704. package/docs/api/type-aliases/Signature.md +0 -21
  705. package/docs/api/type-aliases/Unsubscribe.md +0 -15
  706. package/docs/api/variables/BraidPolicy.md +0 -21
  707. package/docs/api/variables/DEFAULT_DEVICE_ID.md +0 -12
  708. package/docs/api/variables/DOUBLE_RATCHET_SPEC.md +0 -11
  709. package/docs/api/variables/GROUP_V2_PREFIX.md +0 -11
  710. package/docs/api/variables/KEY_REFRESH_INTERVAL_MS_DEFAULT.md +0 -11
  711. package/docs/api/variables/MAX_MESSAGE_KEYS.md +0 -14
  712. package/docs/api/variables/MAX_PREKEY_AGE_MS_DEFAULT.md +0 -11
  713. package/docs/api/variables/MAX_RECEIVER_CHAINS.md +0 -14
  714. package/docs/api/variables/MAX_REGISTRATION_ID.md +0 -16
  715. package/docs/api/variables/MAX_SKIP.md +0 -11
  716. package/docs/api/variables/MESSAGE_FORMAT.md +0 -11
  717. package/docs/api/variables/MIN_REGISTRATION_ID.md +0 -16
  718. package/docs/api/variables/ML_KEM_BRAID_SPEC.md +0 -11
  719. package/docs/api/variables/ONE_TIME_PREKEY_BATCH_SIZE.md +0 -21
  720. package/docs/api/variables/PQXDH_SPEC.md +0 -11
  721. package/docs/api/variables/PostQuantumPolicy.md +0 -21
  722. package/docs/api/variables/SENDER_KEY_FORMAT.md +0 -11
  723. package/docs/api/variables/SENDER_KEY_SPEC.md +0 -11
  724. package/docs/api/variables/SESAME_SPEC.md +0 -11
  725. package/docs/api/variables/SESSION_FORMAT.md +0 -11
  726. package/docs/api/variables/SPQR_LIMITS_DEFAULTS.md +0 -11
  727. package/docs/api/variables/X3DH_SPEC.md +0 -9
  728. package/docs/api/variables/defaultSignalProtocolLogger.md +0 -32
  729. /package/dist/internal/{groups-v2 → groups}/invite-link.d.ts +0 -0
  730. /package/dist/internal/{groups-v2 → groups}/invite-link.js +0 -0
@@ -1,1095 +0,0 @@
1
- /**
2
- * GroupsV2 Manager
3
- *
4
- * Orchestrates group lifecycle operations:
5
- * - Group creation/deletion
6
- * - Membership changes (add, remove, promote, ban)
7
- * - Attribute updates (title, description, avatar, timer)
8
- * - State sync from server (change log replay)
9
- * - Invite link management
10
- * - Sender key rotation on membership removal
11
- *
12
- * The manager coordinates between:
13
- * - zero-knowledge group cryptography for encryption/decryption
14
- * - Encrypted state layer for serialization
15
- * - Change actions for state transitions
16
- * - Access control for authorization
17
- * - SenderKeyManager for group messaging key rotation
18
- * - Server relay for state storage
19
- *
20
- * @module groups-v2/manager
21
- */
22
- import { SERVICE_ID_ACI, SERVICE_ID_PNI, serviceIdBinary, groupMasterKey, deriveGroupSecretParams, getGroupPublicParams, GROUP_MASTER_KEY_LEN, encryptUuid, decryptUuid, encryptProfileKeyCiphertext, decryptProfileKeyCiphertext, } from '../protocol/zk/groups/index.js';
23
- import { MemberRole, AccessRequired, EnabledState, defaultAccessControl, emptyGroupChange, } from './types.js';
24
- import { encryptGroupState, decryptGroupState } from './encrypted-state.js';
25
- import { applyGroupChange, validateChange } from './change-actions.js';
26
- import { canPerformAction, GroupAction, isMember, isBanned } from './access-control.js';
27
- import { createGroupInviteLink, parseGroupInviteLink, generateInviteLinkPassword, } from './invite-link.js';
28
- import { createGroupId, extractGroupId } from '../groups/group-id.js';
29
- import { constantTimeEqual as bytesEqual } from '../crypto/utils.js';
30
- import { bytesToHex, hexToBytes } from '../../encoding/hex.js';
31
- import { receiveAuthCredential, presentAuthCredential, deserializeAuthCredentialResponse, serializeAuthCredentialPresentation, serializeGroupPublicParams, } from '../protocol/zk/groups/auth-credential.js';
32
- import { receiveProfileKeyCredential, deserializeProfileKeyCredentialResponse, } from '../protocol/zk/groups/profile-key-credential.js';
33
- import { SECONDS_PER_DAY } from '../protocol/zk/groups/group-params.js';
34
- import AsyncLock from 'async-lock';
35
- // ---------------------------------------------------------------------------
36
- // GroupsV2Manager
37
- // ---------------------------------------------------------------------------
38
- /**
39
- * Manages GroupsV2 lifecycle and state.
40
- *
41
- * This is the primary entry point for group operations. It coordinates
42
- * between crypto primitives, storage, and server communication.
43
- */
44
- /** Default maximum group size enforced by the manager. */
45
- export const MAX_GROUP_SIZE = 1000;
46
- export class GroupsV2Manager {
47
- store;
48
- server;
49
- onSenderKeyRotation;
50
- onEndorsementsInvalidated;
51
- issueCredential;
52
- credentialPublicKey;
53
- aci;
54
- pni;
55
- issueProfileKeyCredentialFn;
56
- profileKeyCredentialPublicKey;
57
- profileKey;
58
- cachedCredential = null;
59
- cachedProfileKeyCredential = null;
60
- /** Serializes credential fetches to prevent duplicate network requests. */
61
- credentialLock = new AsyncLock();
62
- constructor(options) {
63
- this.store = options.store;
64
- this.server = options.server;
65
- this.onSenderKeyRotation = options.onSenderKeyRotation;
66
- this.onEndorsementsInvalidated = options.onEndorsementsInvalidated;
67
- this.issueCredential = options.issueCredential;
68
- this.credentialPublicKey = options.credentialPublicKey;
69
- this.aci = options.aci;
70
- // Nil PNI for non-phone apps — credential math only needs consistency between issuance and reception
71
- this.pni = options.pni ?? { kind: SERVICE_ID_PNI, uuid: new Uint8Array(16) };
72
- this.issueProfileKeyCredentialFn = options.issueProfileKeyCredential;
73
- this.profileKeyCredentialPublicKey = options.profileKeyCredentialPublicKey;
74
- this.profileKey = options.profileKey;
75
- }
76
- // =========================================================================
77
- // Authorization
78
- // =========================================================================
79
- /**
80
- * Build authorization for a group operation.
81
- *
82
- * Flow: issue credential -> receive (verify issuance) -> present (create ZK proof)
83
- *
84
- * Public so the endorsement refresher (SignalProtocolClient) can build auth for
85
- * relay.refreshGroupSendEndorsements(). Safe because:
86
- * - Credential is day-cached (one server round-trip per UTC day max)
87
- * - Each presentation uses fresh randomness → unlinkable
88
- * - No secret material is exposed; only the ZK proof + group public params
89
- */
90
- async getAuthorization(rawGroupId) {
91
- const secretParams = await this.getSecretParams(rawGroupId);
92
- const groupPublicParams = getGroupPublicParams(secretParams);
93
- // Get or refresh credential (day-aligned).
94
- // The lock prevents concurrent fetches for the same day-scoped credential.
95
- const credential = await this.credentialLock.acquire('credential', async () => {
96
- const today = Math.floor(Date.now() / 1000 / SECONDS_PER_DAY) * SECONDS_PER_DAY;
97
- if (this.cachedCredential?.redemptionTime === today) {
98
- return this.cachedCredential.credential;
99
- }
100
- const responseBytes = await this.issueCredential();
101
- const response = deserializeAuthCredentialResponse(new Uint8Array(responseBytes));
102
- const cred = receiveAuthCredential(this.credentialPublicKey, response, this.aci, this.pni, today);
103
- this.cachedCredential = { redemptionTime: today, credential: cred };
104
- return cred;
105
- });
106
- // Create fresh presentation (new randomness each time for unlinkability)
107
- const presentation = presentAuthCredential(this.credentialPublicKey, credential, secretParams, crypto.getRandomValues(new Uint8Array(32)));
108
- return {
109
- presentation: serializeAuthCredentialPresentation(presentation),
110
- groupPublicParams: serializeGroupPublicParams(groupPublicParams),
111
- };
112
- }
113
- /**
114
- * Get or refresh the profile key credential for the current user.
115
- * Returns a PresentationContext if profile key credentials are configured,
116
- * otherwise undefined.
117
- */
118
- async getPresentationContext() {
119
- if (!this.issueProfileKeyCredentialFn ||
120
- !this.profileKeyCredentialPublicKey ||
121
- !this.profileKey) {
122
- return undefined;
123
- }
124
- const today = Math.floor(Date.now() / 1000 / SECONDS_PER_DAY) * SECONDS_PER_DAY;
125
- if (!this.cachedProfileKeyCredential ||
126
- this.cachedProfileKeyCredential.redemptionTime !== today) {
127
- const responseBytes = await this.issueProfileKeyCredentialFn();
128
- const response = deserializeProfileKeyCredentialResponse(new Uint8Array(responseBytes));
129
- const credential = receiveProfileKeyCredential(this.profileKeyCredentialPublicKey, response, this.aci, this.profileKey, response.redemptionTime, Math.floor(Date.now() / 1000));
130
- this.cachedProfileKeyCredential = { redemptionTime: today, credential };
131
- }
132
- return {
133
- credential: this.cachedProfileKeyCredential.credential,
134
- credentialPublicKey: this.profileKeyCredentialPublicKey,
135
- };
136
- }
137
- /**
138
- * Execute a group server operation with one credential-refresh retry.
139
- * On `UNAUTHORIZED`, clears the credential cache and retries once.
140
- *
141
- * This is an SDK transport convenience, not specified behaviour: day-aligned
142
- * auth credentials can expire mid-flight, and one refresh is cheaper than
143
- * surfacing a spurious authorization failure.
144
- */
145
- async withAuthRetry(rawGroupId, operation) {
146
- const authorization = await this.getAuthorization(rawGroupId);
147
- try {
148
- return await operation(authorization);
149
- }
150
- catch (err) {
151
- const isUnauthorized = err instanceof Error && err.message.includes('UNAUTHORIZED');
152
- if (!isUnauthorized)
153
- throw err;
154
- // Clear stale credential and retry once
155
- this.cachedCredential = null;
156
- const freshAuth = await this.getAuthorization(rawGroupId);
157
- return await operation(freshAuth);
158
- }
159
- }
160
- /**
161
- * Invalidate endorsement cache for a group (non-fatal).
162
- *
163
- * Called after membership changes. Failures are logged but do not
164
- * propagate — endorsements are lazily refreshed on next send.
165
- */
166
- async invalidateEndorsements(rawGroupId) {
167
- if (!this.onEndorsementsInvalidated)
168
- return;
169
- try {
170
- await this.onEndorsementsInvalidated(rawGroupId);
171
- }
172
- catch {
173
- // Non-fatal — endorsements will be refreshed on next send
174
- }
175
- }
176
- // =========================================================================
177
- // Group Creation
178
- // =========================================================================
179
- /**
180
- * Create a new group.
181
- *
182
- * Generates a GroupMasterKey, derives all secrets, creates the initial
183
- * encrypted state, and uploads to the server.
184
- *
185
- * @param creatorAci - 16-byte ACI of the group creator
186
- * @param creatorProfileKey - 32-byte profile key of the creator
187
- * @param members - Additional members to add (ACI + profile key + role)
188
- * @param title - Group title
189
- * @param options - Optional settings (description, access control, avatar, timer)
190
- * @returns GroupId and master key
191
- */
192
- async createGroup(creatorAci, creatorProfileKey, members, title, options) {
193
- // Generate random master key
194
- const masterKeyBytes = new Uint8Array(GROUP_MASTER_KEY_LEN);
195
- crypto.getRandomValues(masterKeyBytes);
196
- const mk = groupMasterKey(masterKeyBytes);
197
- // Derive all group secrets
198
- const secretParams = deriveGroupSecretParams(mk);
199
- // Build initial decrypted state
200
- const ac = {
201
- ...defaultAccessControl(),
202
- ...options?.accessControl,
203
- };
204
- const creatorMember = {
205
- aciBytes: creatorAci,
206
- role: MemberRole.ADMINISTRATOR,
207
- profileKey: creatorProfileKey,
208
- joinedAtRevision: 0,
209
- pniBytes: new Uint8Array(0),
210
- labelEmoji: '',
211
- labelString: '',
212
- };
213
- const additionalMembers = members.map((m) => ({
214
- aciBytes: m.aciBytes,
215
- role: m.role ?? MemberRole.DEFAULT,
216
- profileKey: m.profileKey,
217
- joinedAtRevision: 0,
218
- pniBytes: new Uint8Array(0),
219
- labelEmoji: '',
220
- labelString: '',
221
- }));
222
- const initialState = {
223
- title,
224
- avatar: options?.avatarUrl ?? '',
225
- disappearingMessagesTimer: {
226
- duration: options?.disappearingMessagesDuration ?? 0,
227
- },
228
- accessControl: ac,
229
- revision: 0,
230
- members: [creatorMember, ...additionalMembers],
231
- pendingMembers: [],
232
- requestingMembers: [],
233
- inviteLinkPassword: new Uint8Array(0),
234
- description: options?.description ?? '',
235
- isAnnouncementGroup: EnabledState.DISABLED,
236
- bannedMembers: [],
237
- };
238
- // Get presentation context for the creator's member entry
239
- const presentationCtx = await this.getPresentationContext();
240
- const memberContexts = new Map();
241
- if (presentationCtx) {
242
- const creatorAciHex = Array.from(creatorAci)
243
- .map((b) => b.toString(16).padStart(2, '0'))
244
- .join('');
245
- memberContexts.set(creatorAciHex, presentationCtx);
246
- }
247
- // Encrypt the initial state
248
- const encryptedState = encryptGroupState(secretParams, initialState, memberContexts.size > 0 ? memberContexts : undefined);
249
- // Serialize encrypted state for server storage
250
- const serialized = serializeEncryptedGroup(encryptedState);
251
- // Derive group identifier
252
- const groupIdHex = bytesToHex(secretParams.groupId);
253
- const groupId = createGroupId(groupIdHex);
254
- // Store master key first so getAuthorization can derive secret params
255
- await this.store.storeMasterKey(groupIdHex, masterKeyBytes);
256
- try {
257
- // Upload to server with auth credential (+ retry on UNAUTHORIZED)
258
- await this.withAuthRetry(groupIdHex, (auth) => this.server.createGroup(secretParams.groupId, serialized, auth));
259
- }
260
- catch (err) {
261
- // Clean up orphan master key — server doesn't have this group
262
- await this.store.deleteMasterKey(groupIdHex);
263
- throw err;
264
- }
265
- // Store local state (only after server confirms group exists)
266
- await this.store.storeGroupState(groupIdHex, initialState);
267
- return { groupId, masterKey: masterKeyBytes };
268
- }
269
- // =========================================================================
270
- // State Retrieval
271
- // =========================================================================
272
- /**
273
- * Get the decrypted group state.
274
- *
275
- * Returns cached state if available, otherwise fetches from server.
276
- *
277
- * @param groupId - Group identifier
278
- * @returns Decrypted group state
279
- */
280
- async getGroupState(groupId) {
281
- const rawId = extractGroupId(groupId);
282
- // Try cache first
283
- const cached = await this.store.getGroupState(rawId);
284
- if (cached)
285
- return cached;
286
- // Fetch from server
287
- return this.syncGroup(groupId);
288
- }
289
- /**
290
- * Sync group state from server.
291
- *
292
- * Fetches the latest state or change log and applies updates.
293
- *
294
- * @param groupId - Group identifier
295
- * @returns Updated decrypted group state
296
- */
297
- async syncGroup(groupId) {
298
- const rawId = extractGroupId(groupId);
299
- const secretParams = await this.getSecretParams(rawId);
300
- // Check current cached revision
301
- const cached = await this.store.getGroupState(rawId);
302
- const currentRevision = cached?.revision ?? -1;
303
- if (currentRevision >= 0) {
304
- // Try incremental sync via change log
305
- const changes = await this.withAuthRetry(rawId, (auth) => this.server.getGroupChanges(secretParams.groupId, currentRevision, auth));
306
- if (changes.length > 0) {
307
- let state = cached;
308
- let membershipChanged = false;
309
- for (const entry of changes) {
310
- const decryptedChange = deserializeAndDecryptChange(entry.encryptedChange, secretParams);
311
- const errors = validateChange(state, decryptedChange);
312
- if (errors.length > 0) {
313
- // Skip invalid changes (server may have sent stale data)
314
- continue;
315
- }
316
- // Detect membership changes that invalidate endorsements
317
- if (decryptedChange.newMembers.length > 0 ||
318
- decryptedChange.deleteMembers.length > 0 ||
319
- decryptedChange.promotePendingMembers.length > 0 ||
320
- decryptedChange.promoteRequestingMembers.length > 0 ||
321
- decryptedChange.newBannedMembers.length > 0 ||
322
- decryptedChange.promotePendingPniAciMembers.length > 0) {
323
- membershipChanged = true;
324
- }
325
- state = applyGroupChange(state, decryptedChange);
326
- }
327
- await this.store.storeGroupState(rawId, state);
328
- // Invalidate endorsement cache if membership changed during sync
329
- if (membershipChanged) {
330
- await this.invalidateEndorsements(rawId);
331
- }
332
- return state;
333
- }
334
- }
335
- // Full state fetch
336
- const result = await this.withAuthRetry(rawId, (auth) => this.server.getGroup(secretParams.groupId, auth));
337
- if (!result) {
338
- throw new Error(`GROUP_NOT_FOUND: Group ${rawId} not found on server`);
339
- }
340
- const encryptedState = deserializeEncryptedGroup(result.encryptedState);
341
- const state = decryptGroupState(secretParams, encryptedState);
342
- await this.store.storeGroupState(rawId, state);
343
- return state;
344
- }
345
- // =========================================================================
346
- // Membership Operations
347
- // =========================================================================
348
- /**
349
- * Add a member to the group.
350
- *
351
- * @param groupId - Group identifier
352
- * @param editorAci - ACI of the user performing the action
353
- * @param newMemberAci - ACI of the new member
354
- * @param newMemberProfileKey - Profile key of the new member
355
- * @param role - Role for the new member (default: DEFAULT)
356
- */
357
- async addMember(groupId, editorAci, newMemberAci, newMemberProfileKey, role = MemberRole.DEFAULT) {
358
- const rawId = extractGroupId(groupId);
359
- const state = await this.getGroupState(groupId);
360
- // Authorization check
361
- if (!canPerformAction(state, editorAci, GroupAction.ADD_MEMBER)) {
362
- throw new Error('UNAUTHORIZED: Insufficient permissions to add member');
363
- }
364
- // Check if already a member or banned
365
- if (isMember(state, newMemberAci)) {
366
- throw new Error('ALREADY_MEMBER: User is already a group member');
367
- }
368
- if (isBanned(state, newMemberAci)) {
369
- throw new Error('BANNED_MEMBER: User is banned from this group');
370
- }
371
- const change = emptyGroupChange(editorAci, state.revision + 1);
372
- change.newMembers = [
373
- {
374
- aciBytes: newMemberAci,
375
- role,
376
- profileKey: newMemberProfileKey,
377
- joinedAtRevision: state.revision + 1,
378
- pniBytes: new Uint8Array(0),
379
- labelEmoji: '',
380
- labelString: '',
381
- },
382
- ];
383
- await this.submitChange(rawId, state, change);
384
- // Invalidate endorsement cache — new member needs fresh endorsements
385
- await this.invalidateEndorsements(rawId);
386
- }
387
- /**
388
- * Remove a member from the group.
389
- *
390
- * Triggers sender key rotation for forward secrecy.
391
- *
392
- * @param groupId - Group identifier
393
- * @param editorAci - ACI of the user performing the action
394
- * @param targetAci - ACI of the member to remove
395
- */
396
- async removeMember(groupId, editorAci, targetAci) {
397
- const rawId = extractGroupId(groupId);
398
- const state = await this.getGroupState(groupId);
399
- // Self-leave: any member can leave
400
- const isSelfLeave = bytesEqual(editorAci, targetAci);
401
- if (!isSelfLeave) {
402
- // Remove others: need permission
403
- if (!canPerformAction(state, editorAci, GroupAction.REMOVE_MEMBER)) {
404
- throw new Error('UNAUTHORIZED: Insufficient permissions to remove member');
405
- }
406
- }
407
- if (!isMember(state, targetAci)) {
408
- throw new Error('NOT_MEMBER: User is not a group member');
409
- }
410
- const change = emptyGroupChange(editorAci, state.revision + 1);
411
- change.deleteMembers = [targetAci];
412
- await this.submitChange(rawId, state, change);
413
- // Trigger sender key rotation for forward secrecy
414
- if (this.onSenderKeyRotation) {
415
- await this.onSenderKeyRotation(groupId);
416
- }
417
- // Invalidate endorsement cache — removed member's endorsement is stale
418
- await this.invalidateEndorsements(rawId);
419
- }
420
- /**
421
- * Leave the group (self-remove).
422
- *
423
- * @param groupId - Group identifier
424
- * @param userAci - ACI of the user leaving
425
- */
426
- async leaveGroup(groupId, userAci) {
427
- await this.removeMember(groupId, userAci, userAci);
428
- }
429
- /**
430
- * Modify a member's role.
431
- *
432
- * @param groupId - Group identifier
433
- * @param editorAci - ACI of the admin performing the action
434
- * @param targetAci - ACI of the member to modify
435
- * @param newRole - New role
436
- */
437
- async modifyMemberRole(groupId, editorAci, targetAci, newRole) {
438
- const rawId = extractGroupId(groupId);
439
- const state = await this.getGroupState(groupId);
440
- if (!canPerformAction(state, editorAci, GroupAction.MODIFY_MEMBER_ROLE)) {
441
- throw new Error('UNAUTHORIZED: Only admins can modify member roles');
442
- }
443
- if (!isMember(state, targetAci)) {
444
- throw new Error('NOT_MEMBER: User is not a group member');
445
- }
446
- const change = emptyGroupChange(editorAci, state.revision + 1);
447
- change.modifyMemberRoles = [{ aciBytes: targetAci, role: newRole }];
448
- await this.submitChange(rawId, state, change);
449
- }
450
- /**
451
- * Ban a member from the group.
452
- *
453
- * Removes the member if present and adds to ban list.
454
- * Triggers sender key rotation.
455
- *
456
- * @param groupId - Group identifier
457
- * @param editorAci - ACI of the admin
458
- * @param targetServiceId - ServiceId bytes of the user to ban
459
- */
460
- async banMember(groupId, editorAci, targetServiceId) {
461
- const rawId = extractGroupId(groupId);
462
- const state = await this.getGroupState(groupId);
463
- if (!canPerformAction(state, editorAci, GroupAction.BAN_MEMBER)) {
464
- throw new Error('UNAUTHORIZED: Only admins can ban members');
465
- }
466
- const change = emptyGroupChange(editorAci, state.revision + 1);
467
- // Remove from members if present (extract ACI from ServiceId)
468
- const targetAci = targetServiceId.length === 17 ? targetServiceId.slice(1) : targetServiceId;
469
- if (isMember(state, targetAci)) {
470
- change.deleteMembers = [targetAci];
471
- }
472
- change.newBannedMembers = [{ serviceIdBytes: targetServiceId, timestamp: Date.now() }];
473
- await this.submitChange(rawId, state, change);
474
- // Trigger sender key rotation
475
- if (this.onSenderKeyRotation) {
476
- await this.onSenderKeyRotation(groupId);
477
- }
478
- // Invalidate endorsement cache — banned member's endorsement is stale
479
- await this.invalidateEndorsements(rawId);
480
- }
481
- // =========================================================================
482
- // Attribute Updates
483
- // =========================================================================
484
- /**
485
- * Apply a single attribute change to a group.
486
- *
487
- * Handles the common pattern: load state, check permissions, create change,
488
- * apply mutation, submit to server.
489
- */
490
- async applyAttributeChange(groupId, editorAci, action, mutate) {
491
- const rawId = extractGroupId(groupId);
492
- const state = await this.getGroupState(groupId);
493
- if (!canPerformAction(state, editorAci, action)) {
494
- throw new Error(`UNAUTHORIZED: Cannot perform ${action} — insufficient permissions`);
495
- }
496
- const change = emptyGroupChange(editorAci, state.revision + 1);
497
- mutate(change);
498
- await this.submitChange(rawId, state, change);
499
- }
500
- /**
501
- * Update the group title.
502
- */
503
- async updateTitle(groupId, editorAci, title) {
504
- await this.applyAttributeChange(groupId, editorAci, GroupAction.MODIFY_TITLE, (change) => {
505
- change.newTitle = { value: title };
506
- });
507
- }
508
- /**
509
- * Update the group description.
510
- */
511
- async updateDescription(groupId, editorAci, description) {
512
- await this.applyAttributeChange(groupId, editorAci, GroupAction.MODIFY_DESCRIPTION, (change) => {
513
- change.newDescription = { value: description };
514
- });
515
- }
516
- /**
517
- * Update the disappearing messages timer.
518
- */
519
- async updateDisappearingMessagesTimer(groupId, editorAci, duration) {
520
- await this.applyAttributeChange(groupId, editorAci, GroupAction.MODIFY_DISAPPEARING_MESSAGES, (change) => {
521
- change.newTimer = { duration };
522
- });
523
- }
524
- /**
525
- * Update access control settings.
526
- */
527
- async updateAccessControl(groupId, editorAci, updates) {
528
- const rawId = extractGroupId(groupId);
529
- const state = await this.getGroupState(groupId);
530
- // All access control changes require admin
531
- const actions = [
532
- updates.attributes !== undefined && GroupAction.MODIFY_ATTRIBUTES_ACCESS,
533
- updates.members !== undefined && GroupAction.MODIFY_MEMBERS_ACCESS,
534
- updates.addFromInviteLink !== undefined && GroupAction.MODIFY_INVITE_LINK_ACCESS,
535
- ].filter(Boolean);
536
- for (const action of actions) {
537
- if (!canPerformAction(state, editorAci, action)) {
538
- throw new Error('UNAUTHORIZED: Only admins can modify access control');
539
- }
540
- }
541
- const change = emptyGroupChange(editorAci, state.revision + 1);
542
- if (updates.attributes !== undefined) {
543
- change.newAttributeAccess = updates.attributes;
544
- }
545
- if (updates.members !== undefined) {
546
- change.newMemberAccess = updates.members;
547
- }
548
- if (updates.addFromInviteLink !== undefined) {
549
- change.newInviteLinkAccess = updates.addFromInviteLink;
550
- }
551
- await this.submitChange(rawId, state, change);
552
- }
553
- /**
554
- * Toggle announcement-only mode.
555
- */
556
- async setAnnouncementMode(groupId, editorAci, enabled) {
557
- await this.applyAttributeChange(groupId, editorAci, GroupAction.MODIFY_ANNOUNCEMENTS, (change) => {
558
- change.newIsAnnouncementGroup = enabled ? EnabledState.ENABLED : EnabledState.DISABLED;
559
- });
560
- }
561
- // =========================================================================
562
- // Invite Links
563
- // =========================================================================
564
- /**
565
- * Create an invite link for the group.
566
- *
567
- * @param groupId - Group identifier
568
- * @param editorAci - ACI of the admin
569
- * @returns The invite link URL
570
- */
571
- async createInviteLink(groupId, editorAci) {
572
- const rawId = extractGroupId(groupId);
573
- const state = await this.getGroupState(groupId);
574
- if (!canPerformAction(state, editorAci, GroupAction.MODIFY_INVITE_LINK_PASSWORD)) {
575
- throw new Error('UNAUTHORIZED: Only admins can create invite links');
576
- }
577
- const masterKeyBytes = await this.store.getMasterKey(rawId);
578
- if (!masterKeyBytes) {
579
- throw new Error('MASTER_KEY_NOT_FOUND: No master key for group');
580
- }
581
- const password = generateInviteLinkPassword();
582
- // Update group state with new invite link password
583
- // editorServiceIdBytes must be 17 bytes (1 byte kind + 16 byte UUID)
584
- const editorServiceIdBytes = editorAci.length === 17 ? editorAci : aciToServiceIdBytes(editorAci);
585
- const change = emptyGroupChange(editorServiceIdBytes, state.revision + 1);
586
- change.newInviteLinkPassword = password;
587
- // Enable invite link access if not already
588
- if (state.accessControl.addFromInviteLink === AccessRequired.UNSATISFIABLE) {
589
- change.newInviteLinkAccess = AccessRequired.ANY;
590
- }
591
- await this.submitChange(rawId, state, change);
592
- return createGroupInviteLink(masterKeyBytes, password);
593
- }
594
- /**
595
- * Join a group via invite link.
596
- *
597
- * When `addFromInviteLink` is `AccessRequired.ADMINISTRATOR`, the user is
598
- * added to `requestingMembers` instead of `members`, requiring admin approval.
599
- *
600
- * @param url - Invite link URL
601
- * @param userAci - ACI of the joining user
602
- * @param userProfileKey - Profile key of the joining user
603
- * @returns GroupId and join status ('joined' or 'pending_approval')
604
- */
605
- async joinViaInviteLink(url, userAci, userProfileKey) {
606
- const parsed = parseGroupInviteLink(url);
607
- if (!parsed) {
608
- throw new Error('INVALID_INVITE_LINK: Could not parse invite link');
609
- }
610
- const mk = groupMasterKey(parsed.masterKey);
611
- const secretParams = deriveGroupSecretParams(mk);
612
- const groupIdHex = bytesToHex(secretParams.groupId);
613
- const groupIdPrefixed = createGroupId(groupIdHex);
614
- // Store master key locally (needed for getAuthorization)
615
- await this.store.storeMasterKey(groupIdHex, parsed.masterKey);
616
- // Fetch current state to validate invite link
617
- const result = await this.withAuthRetry(groupIdHex, (auth) => this.server.getGroup(secretParams.groupId, auth));
618
- if (!result) {
619
- throw new Error('GROUP_NOT_FOUND: Group no longer exists');
620
- }
621
- const encryptedState = deserializeEncryptedGroup(result.encryptedState);
622
- const state = decryptGroupState(secretParams, encryptedState);
623
- // Validate invite link access is enabled
624
- if (state.accessControl.addFromInviteLink === AccessRequired.UNSATISFIABLE) {
625
- throw new Error('INVITE_LINK_DISABLED: Invite links are disabled');
626
- }
627
- // Validate invite link password
628
- if (!bytesEqual(state.inviteLinkPassword, parsed.inviteLinkPassword)) {
629
- throw new Error('INVALID_INVITE_PASSWORD: Invite link password mismatch');
630
- }
631
- // Check if banned
632
- if (isBanned(state, userAci)) {
633
- throw new Error('BANNED: User is banned from this group');
634
- }
635
- // Check if already a member
636
- if (isMember(state, userAci)) {
637
- await this.store.storeGroupState(groupIdHex, state);
638
- return { groupId: groupIdPrefixed, status: 'joined' };
639
- }
640
- // Check group capacity
641
- if (state.members.length >= MAX_GROUP_SIZE) {
642
- throw new Error(`GROUP_FULL: Group has reached maximum capacity of ${MAX_GROUP_SIZE} members`);
643
- }
644
- // editorServiceIdBytes must be 17 bytes (1 byte kind + 16 byte UUID)
645
- const editorServiceIdBytes = aciToServiceIdBytes(userAci);
646
- const change = emptyGroupChange(editorServiceIdBytes, state.revision + 1);
647
- // Admin approval path: add to requestingMembers instead of members
648
- if (state.accessControl.addFromInviteLink === AccessRequired.ADMINISTRATOR) {
649
- change.newRequestingMembers = [
650
- {
651
- aciBytes: userAci,
652
- profileKey: userProfileKey,
653
- timestamp: Date.now(),
654
- },
655
- ];
656
- // Submit to server first (server is source of truth)
657
- const newState = applyGroupChange(state, change);
658
- const encryptedChange = encryptAndSerializeChange(change, secretParams);
659
- const updatedState = encryptGroupState(secretParams, newState);
660
- const updatedEncryptedState = serializeEncryptedGroup(updatedState);
661
- await this.withAuthRetry(groupIdHex, (auth) => this.server.submitGroupChange(secretParams.groupId, state.revision, encryptedChange, updatedEncryptedState, auth));
662
- await this.store.storeGroupState(groupIdHex, newState);
663
- return { groupId: groupIdPrefixed, status: 'pending_approval' };
664
- }
665
- // Direct join path: add self as member
666
- change.newMembers = [
667
- {
668
- aciBytes: userAci,
669
- role: MemberRole.DEFAULT,
670
- profileKey: userProfileKey,
671
- joinedAtRevision: state.revision + 1,
672
- pniBytes: new Uint8Array(0),
673
- labelEmoji: '',
674
- labelString: '',
675
- },
676
- ];
677
- // Get self-presentation for the new member entry (The reference implementation always includes
678
- // a presentation when adding a full member)
679
- const presentationCtx = await this.getPresentationContext();
680
- let memberContexts;
681
- if (presentationCtx) {
682
- memberContexts = new Map();
683
- const aciHex = Array.from(userAci)
684
- .map((b) => b.toString(16).padStart(2, '0'))
685
- .join('');
686
- memberContexts.set(aciHex, presentationCtx);
687
- }
688
- // Submit to server first (server is source of truth)
689
- const newState = applyGroupChange(state, change);
690
- const encryptedChange = encryptAndSerializeChange(change, secretParams);
691
- const updatedState = encryptGroupState(secretParams, newState, memberContexts);
692
- const updatedEncryptedState = serializeEncryptedGroup(updatedState);
693
- await this.withAuthRetry(groupIdHex, (auth) => this.server.submitGroupChange(secretParams.groupId, state.revision, encryptedChange, updatedEncryptedState, auth));
694
- // Update local state only after server confirms
695
- await this.store.storeGroupState(groupIdHex, newState);
696
- return { groupId: groupIdPrefixed, status: 'joined' };
697
- }
698
- // =========================================================================
699
- // Internal helpers
700
- // =========================================================================
701
- /**
702
- * Get GroupSecretParams for a group from stored master key.
703
- */
704
- async getSecretParams(rawGroupId) {
705
- const masterKeyBytes = await this.store.getMasterKey(rawGroupId);
706
- if (!masterKeyBytes) {
707
- throw new Error(`MASTER_KEY_NOT_FOUND: No master key for group ${rawGroupId}`);
708
- }
709
- const mk = groupMasterKey(masterKeyBytes);
710
- return deriveGroupSecretParams(mk);
711
- }
712
- /**
713
- * Submit a change to the server and update local state.
714
- *
715
- * @param memberPresentationContexts - Optional presentation contexts for members
716
- * being added. Keyed by ACI hex. The reference implementation always includes a presentation when
717
- * adding a full member (AddMemberAction, PromotePending, etc.).
718
- */
719
- async submitChange(rawGroupId, currentState, change, memberPresentationContexts) {
720
- const MAX_VERSION_CONFLICT_RETRIES = 3;
721
- let state = currentState;
722
- for (let attempt = 0; attempt <= MAX_VERSION_CONFLICT_RETRIES; attempt++) {
723
- // Re-base the change onto the current state revision
724
- const rebasedChange = { ...change, revision: state.revision + 1 };
725
- // Validate locally first
726
- const errors = validateChange(state, rebasedChange);
727
- if (errors.length > 0) {
728
- throw new Error(`INVALID_CHANGE: ${errors.join(', ')}`);
729
- }
730
- // Apply locally
731
- const newState = applyGroupChange(state, rebasedChange);
732
- // Encrypt change and updated state for server
733
- const secretParams = await this.getSecretParams(rawGroupId);
734
- const encryptedChange = encryptAndSerializeChange(rebasedChange, secretParams);
735
- const updatedEncState = encryptGroupState(secretParams, newState, memberPresentationContexts);
736
- const updatedEncryptedState = serializeEncryptedGroup(updatedEncState);
737
- try {
738
- await this.withAuthRetry(rawGroupId, (auth) => this.server.submitGroupChange(secretParams.groupId, state.revision, encryptedChange, updatedEncryptedState, auth));
739
- // Update local cache on success
740
- await this.store.storeGroupState(rawGroupId, newState);
741
- return;
742
- }
743
- catch (err) {
744
- const conflictData = err != null && typeof err === 'object' && 'data' in err
745
- ? err.data
746
- : undefined;
747
- // Detect VERSION_CONFLICT from ConvexError structured data
748
- const isVersionConflict = conflictData?.code === 'VERSION_CONFLICT';
749
- if (!isVersionConflict || attempt === MAX_VERSION_CONFLICT_RETRIES) {
750
- throw err;
751
- }
752
- // Re-sync group state from server and retry
753
- const groupId = createGroupId(rawGroupId);
754
- state = await this.syncGroup(groupId);
755
- }
756
- }
757
- }
758
- }
759
- // ---------------------------------------------------------------------------
760
- // Serialization helpers
761
- // ---------------------------------------------------------------------------
762
- /**
763
- * Serialize any object to JSON, converting Uint8Array fields to `{ __bytes: hex }`.
764
- *
765
- * This is the single serialization primitive used by all group wire formats.
766
- * Pairs with {@link deserializeFromJson} for round-trip fidelity.
767
- */
768
- function serializeToJson(obj) {
769
- return JSON.stringify(obj, (_key, value) => {
770
- if (value instanceof Uint8Array) {
771
- return { __bytes: bytesToHex(value) };
772
- }
773
- return value;
774
- });
775
- }
776
- /**
777
- * Deserialize JSON produced by {@link serializeToJson}, restoring
778
- * `{ __bytes: hex }` markers back to Uint8Array instances.
779
- */
780
- function deserializeFromJson(json) {
781
- return JSON.parse(json, (_key, value) => {
782
- if (value && typeof value === 'object' && '__bytes' in value) {
783
- return hexToBytes(value.__bytes);
784
- }
785
- return value;
786
- });
787
- }
788
- function serializeEncryptedGroup(group) {
789
- return new TextEncoder().encode(serializeToJson(group));
790
- }
791
- function deserializeEncryptedGroup(bytes) {
792
- return deserializeFromJson(new TextDecoder().decode(bytes));
793
- }
794
- /**
795
- * Encrypt and serialize a DecryptedGroupChange for server submission.
796
- *
797
- * Encrypts identity fields (ACI, PNI, profileKey) using zkgroup primitives,
798
- * then serializes as JSON with hex-encoded binary fields.
799
- * The server treats the resulting bytes as opaque.
800
- */
801
- export function encryptAndSerializeChange(change, secretParams) {
802
- const encrypted = encryptChangeFields(change, secretParams);
803
- return new TextEncoder().encode(serializeToJson(encrypted));
804
- }
805
- /**
806
- * Deserialize and decrypt a change from server.
807
- *
808
- * Restores JSON from bytes, then decrypts identity fields back to plaintext.
809
- */
810
- export function deserializeAndDecryptChange(bytes, secretParams) {
811
- const encrypted = deserializeFromJson(new TextDecoder().decode(bytes));
812
- return decryptChangeFields(encrypted, secretParams);
813
- }
814
- // ---------------------------------------------------------------------------
815
- // Change field encryption helpers
816
- // ---------------------------------------------------------------------------
817
- /** Encrypt a 16-byte ACI as a UuidCiphertext. */
818
- function encryptAci(secretParams, aciBytes) {
819
- const serviceId = { kind: SERVICE_ID_ACI, uuid: aciBytes };
820
- return encryptUuid(secretParams, serviceId);
821
- }
822
- /** Encrypt a 17-byte ServiceId (kind + uuid) as a UuidCiphertext. */
823
- function encryptServiceIdBytes(secretParams, serviceIdBytes) {
824
- if (serviceIdBytes.length !== 17) {
825
- throw new Error(`ServiceIdBytes must be 17 bytes, got ${serviceIdBytes.length}`);
826
- }
827
- const kind = serviceIdBytes[0];
828
- if (kind !== SERVICE_ID_ACI && kind !== SERVICE_ID_PNI) {
829
- throw new Error(`Invalid ServiceId kind byte: 0x${kind.toString(16).padStart(2, '0')}`);
830
- }
831
- const serviceId = { kind, uuid: serviceIdBytes.slice(1) };
832
- return encryptUuid(secretParams, serviceId);
833
- }
834
- /** Decrypt a UuidCiphertext back to 16-byte ACI UUID. */
835
- function decryptAci(secretParams, ciphertext) {
836
- const serviceId = decryptUuid(secretParams, ciphertext);
837
- if (serviceId.kind !== SERVICE_ID_ACI) {
838
- throw new Error(`Expected ACI service ID, got kind ${serviceId.kind}`);
839
- }
840
- return serviceId.uuid;
841
- }
842
- /** Decrypt a UuidCiphertext back to 17-byte ServiceId binary. */
843
- function decryptServiceIdBytes(secretParams, ciphertext) {
844
- const serviceId = decryptUuid(secretParams, ciphertext);
845
- return serviceIdBinary(serviceId);
846
- }
847
- // ---------------------------------------------------------------------------
848
- // Member-level encryption/decryption for change actions
849
- // ---------------------------------------------------------------------------
850
- function encryptChangeMember(secretParams, member) {
851
- const aciCiphertext = encryptAci(secretParams, member.aciBytes);
852
- const profileKeyCiphertext = member.profileKey.length > 0
853
- ? encryptProfileKeyCiphertext(secretParams, member.profileKey, member.aciBytes)
854
- : new Uint8Array(0);
855
- const pniCiphertext = member.pniBytes.length > 0
856
- ? encryptUuid(secretParams, {
857
- kind: SERVICE_ID_PNI,
858
- uuid: member.pniBytes,
859
- })
860
- : new Uint8Array(0);
861
- return {
862
- aciCiphertext,
863
- role: member.role,
864
- profileKeyCiphertext,
865
- joinedAtRevision: member.joinedAtRevision,
866
- pniCiphertext,
867
- labelEmoji: member.labelEmoji,
868
- labelString: member.labelString,
869
- };
870
- }
871
- function decryptChangeMember(secretParams, member) {
872
- const aciBytes = decryptAci(secretParams, member.aciCiphertext);
873
- const profileKey = member.profileKeyCiphertext.length > 0
874
- ? decryptProfileKeyCiphertext(secretParams, member.profileKeyCiphertext, aciBytes)
875
- : new Uint8Array(0);
876
- let pniBytes = new Uint8Array(0);
877
- if (member.pniCiphertext.length > 0) {
878
- const pniServiceId = decryptUuid(secretParams, member.pniCiphertext);
879
- pniBytes = pniServiceId.uuid;
880
- }
881
- return {
882
- aciBytes,
883
- role: member.role,
884
- profileKey,
885
- joinedAtRevision: member.joinedAtRevision,
886
- pniBytes,
887
- labelEmoji: member.labelEmoji,
888
- labelString: member.labelString,
889
- };
890
- }
891
- function encryptChangePendingMember(secretParams, pending) {
892
- return {
893
- serviceIdCiphertext: encryptServiceIdBytes(secretParams, pending.serviceIdBytes),
894
- role: pending.role,
895
- addedByAciCiphertext: encryptAci(secretParams, pending.addedByAci),
896
- timestamp: pending.timestamp,
897
- };
898
- }
899
- function decryptChangePendingMember(secretParams, pending) {
900
- return {
901
- serviceIdBytes: decryptServiceIdBytes(secretParams, pending.serviceIdCiphertext),
902
- role: pending.role,
903
- addedByAci: decryptAci(secretParams, pending.addedByAciCiphertext),
904
- timestamp: pending.timestamp,
905
- // Preserve ciphertext for re-encryption on removal
906
- serviceIdCipherText: pending.serviceIdCiphertext,
907
- };
908
- }
909
- function encryptChangePendingMemberRemoval(secretParams, removal) {
910
- // Use the preserved ciphertext if available; otherwise encrypt from plaintext
911
- if (removal.serviceIdCipherText.length > 0) {
912
- return { serviceIdCiphertext: removal.serviceIdCipherText };
913
- }
914
- return {
915
- serviceIdCiphertext: encryptServiceIdBytes(secretParams, removal.serviceIdBytes),
916
- };
917
- }
918
- function decryptChangePendingMemberRemoval(secretParams, removal) {
919
- return {
920
- serviceIdBytes: decryptServiceIdBytes(secretParams, removal.serviceIdCiphertext),
921
- serviceIdCipherText: removal.serviceIdCiphertext,
922
- };
923
- }
924
- function encryptChangeRequestingMember(secretParams, member) {
925
- return {
926
- aciCiphertext: encryptAci(secretParams, member.aciBytes),
927
- profileKeyCiphertext: encryptProfileKeyCiphertext(secretParams, member.profileKey, member.aciBytes),
928
- timestamp: member.timestamp,
929
- };
930
- }
931
- function decryptChangeRequestingMember(secretParams, member) {
932
- const aciBytes = decryptAci(secretParams, member.aciCiphertext);
933
- const profileKey = decryptProfileKeyCiphertext(secretParams, member.profileKeyCiphertext, aciBytes);
934
- return { aciBytes, profileKey, timestamp: member.timestamp };
935
- }
936
- function encryptChangeApproveMember(secretParams, member) {
937
- return {
938
- aciCiphertext: encryptAci(secretParams, member.aciBytes),
939
- role: member.role,
940
- };
941
- }
942
- function decryptChangeApproveMember(secretParams, member) {
943
- return {
944
- aciBytes: decryptAci(secretParams, member.aciCiphertext),
945
- role: member.role,
946
- };
947
- }
948
- function encryptChangeModifyMemberRole(secretParams, modify) {
949
- return {
950
- aciCiphertext: encryptAci(secretParams, modify.aciBytes),
951
- role: modify.role,
952
- };
953
- }
954
- function decryptChangeModifyMemberRole(secretParams, modify) {
955
- return {
956
- aciBytes: decryptAci(secretParams, modify.aciCiphertext),
957
- role: modify.role,
958
- };
959
- }
960
- function encryptChangeBannedMember(secretParams, member) {
961
- return {
962
- serviceIdCiphertext: encryptServiceIdBytes(secretParams, member.serviceIdBytes),
963
- timestamp: member.timestamp,
964
- };
965
- }
966
- function decryptChangeBannedMember(secretParams, member) {
967
- return {
968
- serviceIdBytes: decryptServiceIdBytes(secretParams, member.serviceIdCiphertext),
969
- timestamp: member.timestamp,
970
- };
971
- }
972
- function encryptChangeModifyMemberLabel(secretParams, modify) {
973
- return {
974
- aciCiphertext: encryptAci(secretParams, modify.aciBytes),
975
- labelEmoji: modify.labelEmoji,
976
- labelString: modify.labelString,
977
- };
978
- }
979
- function decryptChangeModifyMemberLabel(secretParams, modify) {
980
- return {
981
- aciBytes: decryptAci(secretParams, modify.aciCiphertext),
982
- labelEmoji: modify.labelEmoji,
983
- labelString: modify.labelString,
984
- };
985
- }
986
- // ---------------------------------------------------------------------------
987
- // Top-level change encryption/decryption
988
- // ---------------------------------------------------------------------------
989
- /**
990
- * Encrypt all identity fields in a DecryptedGroupChange.
991
- *
992
- * Walks each action type and encrypts ACI, PNI, and profileKey fields
993
- * using zkgroup primitives. Non-identity fields pass through unchanged.
994
- */
995
- function encryptChangeFields(change, secretParams) {
996
- return {
997
- editorCiphertext: encryptServiceIdBytes(secretParams, change.editorServiceIdBytes),
998
- revision: change.revision,
999
- // Membership
1000
- newMembers: change.newMembers.map((m) => encryptChangeMember(secretParams, m)),
1001
- deleteMembers: change.deleteMembers.map((aci) => encryptAci(secretParams, aci)),
1002
- modifyMemberRoles: change.modifyMemberRoles.map((m) => encryptChangeModifyMemberRole(secretParams, m)),
1003
- modifiedProfileKeys: change.modifiedProfileKeys.map((m) => encryptChangeMember(secretParams, m)),
1004
- // Pending members
1005
- newPendingMembers: change.newPendingMembers.map((m) => encryptChangePendingMember(secretParams, m)),
1006
- deletePendingMembers: change.deletePendingMembers.map((m) => encryptChangePendingMemberRemoval(secretParams, m)),
1007
- promotePendingMembers: change.promotePendingMembers.map((m) => encryptChangeMember(secretParams, m)),
1008
- // Attributes (pass through)
1009
- newTitle: change.newTitle,
1010
- newAvatar: change.newAvatar,
1011
- newTimer: change.newTimer,
1012
- // Access control (pass through)
1013
- newAttributeAccess: change.newAttributeAccess,
1014
- newMemberAccess: change.newMemberAccess,
1015
- newInviteLinkAccess: change.newInviteLinkAccess,
1016
- // Requesting members
1017
- newRequestingMembers: change.newRequestingMembers.map((m) => encryptChangeRequestingMember(secretParams, m)),
1018
- deleteRequestingMembers: change.deleteRequestingMembers.map((aci) => encryptAci(secretParams, aci)),
1019
- promoteRequestingMembers: change.promoteRequestingMembers.map((m) => encryptChangeApproveMember(secretParams, m)),
1020
- // Invite link (pass through)
1021
- newInviteLinkPassword: change.newInviteLinkPassword,
1022
- // Description (pass through)
1023
- newDescription: change.newDescription,
1024
- // Announcements (pass through)
1025
- newIsAnnouncementGroup: change.newIsAnnouncementGroup,
1026
- // Ban list
1027
- newBannedMembers: change.newBannedMembers.map((m) => encryptChangeBannedMember(secretParams, m)),
1028
- deleteBannedMembers: change.deleteBannedMembers.map((m) => encryptChangeBannedMember(secretParams, m)),
1029
- // PNI-ACI promotion
1030
- promotePendingPniAciMembers: change.promotePendingPniAciMembers.map((m) => encryptChangeMember(secretParams, m)),
1031
- // Labels
1032
- modifyMemberLabels: change.modifyMemberLabels.map((m) => encryptChangeModifyMemberLabel(secretParams, m)),
1033
- };
1034
- }
1035
- /**
1036
- * Decrypt all identity fields in an EncryptedGroupChange.
1037
- *
1038
- * Reverses the encryption performed by encryptChangeFields().
1039
- */
1040
- function decryptChangeFields(encrypted, secretParams) {
1041
- return {
1042
- editorServiceIdBytes: decryptServiceIdBytes(secretParams, encrypted.editorCiphertext),
1043
- revision: encrypted.revision,
1044
- // Membership
1045
- newMembers: encrypted.newMembers.map((m) => decryptChangeMember(secretParams, m)),
1046
- deleteMembers: encrypted.deleteMembers.map((ct) => decryptAci(secretParams, ct)),
1047
- modifyMemberRoles: encrypted.modifyMemberRoles.map((m) => decryptChangeModifyMemberRole(secretParams, m)),
1048
- modifiedProfileKeys: encrypted.modifiedProfileKeys.map((m) => decryptChangeMember(secretParams, m)),
1049
- // Pending members
1050
- newPendingMembers: encrypted.newPendingMembers.map((m) => decryptChangePendingMember(secretParams, m)),
1051
- deletePendingMembers: encrypted.deletePendingMembers.map((m) => decryptChangePendingMemberRemoval(secretParams, m)),
1052
- promotePendingMembers: encrypted.promotePendingMembers.map((m) => decryptChangeMember(secretParams, m)),
1053
- // Attributes (pass through)
1054
- newTitle: encrypted.newTitle,
1055
- newAvatar: encrypted.newAvatar,
1056
- newTimer: encrypted.newTimer,
1057
- // Access control (pass through)
1058
- newAttributeAccess: encrypted.newAttributeAccess,
1059
- newMemberAccess: encrypted.newMemberAccess,
1060
- newInviteLinkAccess: encrypted.newInviteLinkAccess,
1061
- // Requesting members
1062
- newRequestingMembers: encrypted.newRequestingMembers.map((m) => decryptChangeRequestingMember(secretParams, m)),
1063
- deleteRequestingMembers: encrypted.deleteRequestingMembers.map((ct) => decryptAci(secretParams, ct)),
1064
- promoteRequestingMembers: encrypted.promoteRequestingMembers.map((m) => decryptChangeApproveMember(secretParams, m)),
1065
- // Invite link (pass through)
1066
- newInviteLinkPassword: encrypted.newInviteLinkPassword,
1067
- // Description (pass through)
1068
- newDescription: encrypted.newDescription,
1069
- // Announcements (pass through)
1070
- newIsAnnouncementGroup: encrypted.newIsAnnouncementGroup,
1071
- // Ban list
1072
- newBannedMembers: encrypted.newBannedMembers.map((m) => decryptChangeBannedMember(secretParams, m)),
1073
- deleteBannedMembers: encrypted.deleteBannedMembers.map((m) => decryptChangeBannedMember(secretParams, m)),
1074
- // PNI-ACI promotion
1075
- promotePendingPniAciMembers: encrypted.promotePendingPniAciMembers.map((m) => decryptChangeMember(secretParams, m)),
1076
- // Labels
1077
- modifyMemberLabels: encrypted.modifyMemberLabels.map((m) => decryptChangeModifyMemberLabel(secretParams, m)),
1078
- };
1079
- }
1080
- // ---------------------------------------------------------------------------
1081
- // Utility helpers
1082
- // ---------------------------------------------------------------------------
1083
- /**
1084
- * Convert a 16-byte ACI UUID to a 17-byte ServiceId binary (ACI kind prefix + UUID).
1085
- *
1086
- * Used for `editorServiceIdBytes` in DecryptedGroupChange, which requires
1087
- * the full ServiceId format for encryption.
1088
- */
1089
- function aciToServiceIdBytes(aciBytes) {
1090
- const sid = new Uint8Array(17);
1091
- sid[0] = SERVICE_ID_ACI;
1092
- sid.set(aciBytes, 1);
1093
- return sid;
1094
- }
1095
- //# sourceMappingURL=manager.js.map