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

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 (655) hide show
  1. package/ADAPTERS.md +1 -1
  2. package/CHANGELOG.md +767 -2
  3. package/COMMERCIAL.md +56 -0
  4. package/README.md +13 -8
  5. package/SECURITY.md +15 -1
  6. package/client/README.md +1 -1
  7. package/dist/client/client.d.ts.map +1 -1
  8. package/dist/client/client.js +16 -8
  9. package/dist/client/client.js.map +1 -1
  10. package/dist/client/config.d.ts +12 -2
  11. package/dist/client/config.d.ts.map +1 -1
  12. package/dist/client/config.js.map +1 -1
  13. package/dist/client/endorsement-manager.d.ts +19 -2
  14. package/dist/client/endorsement-manager.d.ts.map +1 -1
  15. package/dist/client/endorsement-manager.js +26 -10
  16. package/dist/client/endorsement-manager.js.map +1 -1
  17. package/dist/client/headless.d.ts +1 -1
  18. package/dist/client/headless.js +1 -1
  19. package/dist/client/sealed-sender-ops.d.ts +27 -1
  20. package/dist/client/sealed-sender-ops.d.ts.map +1 -1
  21. package/dist/client/sealed-sender-ops.js +36 -6
  22. package/dist/client/sealed-sender-ops.js.map +1 -1
  23. package/dist/client/signal-service-cipher.d.ts +16 -1
  24. package/dist/client/signal-service-cipher.d.ts.map +1 -1
  25. package/dist/client/signal-service-cipher.js +112 -52
  26. package/dist/client/signal-service-cipher.js.map +1 -1
  27. package/dist/client/types.d.ts +20 -7
  28. package/dist/client/types.d.ts.map +1 -1
  29. package/dist/client/types.js.map +1 -1
  30. package/dist/index.d.ts +7 -0
  31. package/dist/index.d.ts.map +1 -1
  32. package/dist/index.js +7 -0
  33. package/dist/index.js.map +1 -1
  34. package/dist/internal/crypto/index.d.ts +1 -1
  35. package/dist/internal/crypto/index.d.ts.map +1 -1
  36. package/dist/internal/crypto/index.js +1 -1
  37. package/dist/internal/crypto/index.js.map +1 -1
  38. package/dist/internal/crypto/random.d.ts +9 -0
  39. package/dist/internal/crypto/random.d.ts.map +1 -1
  40. package/dist/internal/crypto/random.js +16 -0
  41. package/dist/internal/crypto/random.js.map +1 -1
  42. package/dist/internal/groups/manager.d.ts +37 -5
  43. package/dist/internal/groups/manager.d.ts.map +1 -1
  44. package/dist/internal/groups/manager.js +98 -15
  45. package/dist/internal/groups/manager.js.map +1 -1
  46. package/dist/internal/groups/server-engine.d.ts +48 -2
  47. package/dist/internal/groups/server-engine.d.ts.map +1 -1
  48. package/dist/internal/groups/server-engine.js +122 -13
  49. package/dist/internal/groups/server-engine.js.map +1 -1
  50. package/dist/internal/protocol/sealed-sender/decryption-v2.d.ts.map +1 -1
  51. package/dist/internal/protocol/sealed-sender/decryption-v2.js +32 -18
  52. package/dist/internal/protocol/sealed-sender/decryption-v2.js.map +1 -1
  53. package/dist/internal/protocol/sealed-sender/decryption.d.ts.map +1 -1
  54. package/dist/internal/protocol/sealed-sender/decryption.js +33 -19
  55. package/dist/internal/protocol/sealed-sender/decryption.js.map +1 -1
  56. package/dist/internal/protocol/sealed-sender/encryption-v2.d.ts.map +1 -1
  57. package/dist/internal/protocol/sealed-sender/encryption-v2.js +8 -14
  58. package/dist/internal/protocol/sealed-sender/encryption-v2.js.map +1 -1
  59. package/dist/internal/protocol/sealed-sender/encryption.d.ts +9 -4
  60. package/dist/internal/protocol/sealed-sender/encryption.d.ts.map +1 -1
  61. package/dist/internal/protocol/sealed-sender/encryption.js +7 -15
  62. package/dist/internal/protocol/sealed-sender/encryption.js.map +1 -1
  63. package/dist/internal/protocol/sealed-sender/proto/index.d.ts +6 -7
  64. package/dist/internal/protocol/sealed-sender/proto/index.d.ts.map +1 -1
  65. package/dist/internal/protocol/sealed-sender/proto/index.js +5 -7
  66. package/dist/internal/protocol/sealed-sender/proto/index.js.map +1 -1
  67. package/dist/internal/protocol/sealed-sender/trust-root.d.ts +45 -0
  68. package/dist/internal/protocol/sealed-sender/trust-root.d.ts.map +1 -0
  69. package/dist/internal/protocol/sealed-sender/trust-root.js +77 -0
  70. package/dist/internal/protocol/sealed-sender/trust-root.js.map +1 -0
  71. package/dist/internal/protocol/sealed-sender/types.d.ts +64 -9
  72. package/dist/internal/protocol/sealed-sender/types.d.ts.map +1 -1
  73. package/dist/internal/protocol/sealed-sender/types.js +43 -0
  74. package/dist/internal/protocol/sealed-sender/types.js.map +1 -1
  75. package/dist/internal/protocol/sender-keys/manager.d.ts +37 -0
  76. package/dist/internal/protocol/sender-keys/manager.d.ts.map +1 -1
  77. package/dist/internal/protocol/sender-keys/manager.js +108 -7
  78. package/dist/internal/protocol/sender-keys/manager.js.map +1 -1
  79. package/dist/local/store/expo/adapter.d.ts +14 -15
  80. package/dist/local/store/expo/adapter.d.ts.map +1 -1
  81. package/dist/local/store/expo/adapter.js +109 -102
  82. package/dist/local/store/expo/adapter.js.map +1 -1
  83. package/dist/local/store/expo/db.d.ts +4 -1
  84. package/dist/local/store/expo/db.d.ts.map +1 -1
  85. package/dist/local/store/expo/db.js +5 -0
  86. package/dist/local/store/expo/db.js.map +1 -1
  87. package/dist/local/store/expo/index.d.ts +0 -2
  88. package/dist/local/store/expo/index.d.ts.map +1 -1
  89. package/dist/local/store/expo/index.js +1 -1
  90. package/dist/local/store/expo/index.js.map +1 -1
  91. package/dist/local/store/expo/models/index.d.ts +1 -1
  92. package/dist/local/store/expo/models/index.d.ts.map +1 -1
  93. package/dist/local/store/expo/models/index.js +2 -2
  94. package/dist/local/store/expo/models/index.js.map +1 -1
  95. package/dist/local/store/expo/models/sender-key.d.ts +101 -77
  96. package/dist/local/store/expo/models/sender-key.d.ts.map +1 -1
  97. package/dist/local/store/expo/models/sender-key.js +154 -124
  98. package/dist/local/store/expo/models/sender-key.js.map +1 -1
  99. package/dist/local/store/expo/schema.d.ts +134 -32
  100. package/dist/local/store/expo/schema.d.ts.map +1 -1
  101. package/dist/local/store/expo/schema.js +36 -7
  102. package/dist/local/store/expo/schema.js.map +1 -1
  103. package/dist/local/store/mock/adapter.d.ts +1 -0
  104. package/dist/local/store/mock/adapter.d.ts.map +1 -1
  105. package/dist/local/store/mock/adapter.js +18 -0
  106. package/dist/local/store/mock/adapter.js.map +1 -1
  107. package/dist/local/store/node/adapter.d.ts +53 -4
  108. package/dist/local/store/node/adapter.d.ts.map +1 -1
  109. package/dist/local/store/node/adapter.js +456 -9
  110. package/dist/local/store/node/adapter.js.map +1 -1
  111. package/dist/local/store/node/database.d.ts +68 -0
  112. package/dist/local/store/node/database.d.ts.map +1 -1
  113. package/dist/local/store/node/database.js +201 -18
  114. package/dist/local/store/node/database.js.map +1 -1
  115. package/dist/local/store/react-native/adapter.d.ts +39 -0
  116. package/dist/local/store/react-native/adapter.d.ts.map +1 -1
  117. package/dist/local/store/react-native/adapter.js +163 -8
  118. package/dist/local/store/react-native/adapter.js.map +1 -1
  119. package/dist/local/store/web/adapter.d.ts +1 -0
  120. package/dist/local/store/web/adapter.d.ts.map +1 -1
  121. package/dist/local/store/web/adapter.js +33 -1
  122. package/dist/local/store/web/adapter.js.map +1 -1
  123. package/dist/remote/relay/convex/backend.d.ts +405 -0
  124. package/dist/remote/relay/convex/backend.d.ts.map +1 -0
  125. package/dist/remote/relay/convex/backend.js +687 -0
  126. package/dist/remote/relay/convex/backend.js.map +1 -0
  127. package/dist/remote/relay/convex/component/_generated/api.d.ts +58 -0
  128. package/dist/remote/relay/convex/component/_generated/api.d.ts.map +1 -0
  129. package/dist/remote/relay/convex/component/_generated/api.js +31 -0
  130. package/dist/remote/relay/convex/component/_generated/api.js.map +1 -0
  131. package/dist/remote/relay/convex/component/_generated/component.d.ts +483 -0
  132. package/dist/remote/relay/convex/component/_generated/component.d.ts.map +1 -0
  133. package/dist/remote/relay/convex/component/_generated/component.js +11 -0
  134. package/dist/remote/relay/convex/component/_generated/component.js.map +1 -0
  135. package/dist/remote/relay/convex/component/_generated/dataModel.d.ts +46 -0
  136. package/dist/remote/relay/convex/component/_generated/dataModel.d.ts.map +1 -0
  137. package/dist/remote/relay/convex/component/_generated/dataModel.js +11 -0
  138. package/dist/remote/relay/convex/component/_generated/dataModel.js.map +1 -0
  139. package/dist/remote/relay/convex/component/_generated/server.d.ts +129 -0
  140. package/dist/remote/relay/convex/component/_generated/server.d.ts.map +1 -0
  141. package/dist/remote/relay/convex/component/_generated/server.js +79 -0
  142. package/dist/remote/relay/convex/component/_generated/server.js.map +1 -0
  143. package/dist/remote/relay/convex/component/accounts.d.ts +43 -0
  144. package/dist/remote/relay/convex/component/accounts.d.ts.map +1 -0
  145. package/dist/remote/relay/convex/component/accounts.js +181 -0
  146. package/dist/remote/relay/convex/component/accounts.js.map +1 -0
  147. package/dist/remote/relay/convex/component/certificates.d.ts +10 -0
  148. package/dist/remote/relay/convex/component/certificates.d.ts.map +1 -0
  149. package/dist/remote/relay/convex/component/certificates.js +122 -0
  150. package/dist/remote/relay/convex/component/certificates.js.map +1 -0
  151. package/dist/remote/relay/convex/component/cleanup.d.ts +32 -0
  152. package/dist/remote/relay/convex/component/cleanup.d.ts.map +1 -0
  153. package/dist/remote/relay/convex/component/cleanup.js +146 -0
  154. package/dist/remote/relay/convex/component/cleanup.js.map +1 -0
  155. package/dist/remote/relay/convex/component/convex.config.d.ts +5 -0
  156. package/dist/remote/relay/convex/component/convex.config.d.ts.map +1 -0
  157. package/dist/remote/relay/convex/component/convex.config.js +33 -0
  158. package/dist/remote/relay/convex/component/convex.config.js.map +1 -0
  159. package/dist/remote/relay/convex/component/crons.d.ts +3 -0
  160. package/dist/remote/relay/convex/component/crons.d.ts.map +1 -0
  161. package/dist/remote/relay/convex/component/crons.js +10 -0
  162. package/dist/remote/relay/convex/component/crons.js.map +1 -0
  163. package/dist/remote/relay/convex/component/devices.d.ts +101 -0
  164. package/dist/remote/relay/convex/component/devices.d.ts.map +1 -0
  165. package/dist/remote/relay/convex/component/devices.js +299 -0
  166. package/dist/remote/relay/convex/component/devices.js.map +1 -0
  167. package/dist/remote/relay/convex/component/errors.d.ts +22 -0
  168. package/dist/remote/relay/convex/component/errors.d.ts.map +1 -0
  169. package/dist/remote/relay/convex/component/errors.js +17 -0
  170. package/dist/remote/relay/convex/component/errors.js.map +1 -0
  171. package/dist/remote/relay/convex/component/groups.d.ts +63 -0
  172. package/dist/remote/relay/convex/component/groups.d.ts.map +1 -0
  173. package/dist/remote/relay/convex/component/groups.js +341 -0
  174. package/dist/remote/relay/convex/component/groups.js.map +1 -0
  175. package/dist/remote/relay/convex/component/keys.d.ts +130 -0
  176. package/dist/remote/relay/convex/component/keys.d.ts.map +1 -0
  177. package/dist/remote/relay/convex/component/keys.js +578 -0
  178. package/dist/remote/relay/convex/component/keys.js.map +1 -0
  179. package/dist/remote/relay/convex/component/messages.d.ts +119 -0
  180. package/dist/remote/relay/convex/component/messages.d.ts.map +1 -0
  181. package/dist/remote/relay/convex/component/messages.js +723 -0
  182. package/dist/remote/relay/convex/component/messages.js.map +1 -0
  183. package/dist/remote/relay/convex/component/provisioning.d.ts +92 -0
  184. package/dist/remote/relay/convex/component/provisioning.d.ts.map +1 -0
  185. package/dist/remote/relay/convex/component/provisioning.js +359 -0
  186. package/dist/remote/relay/convex/component/provisioning.js.map +1 -0
  187. package/dist/remote/relay/convex/component/runtime.d.ts +18 -0
  188. package/dist/remote/relay/convex/component/runtime.d.ts.map +1 -0
  189. package/dist/remote/relay/convex/component/runtime.js +142 -0
  190. package/dist/remote/relay/convex/component/runtime.js.map +1 -0
  191. package/dist/remote/relay/convex/component/schema.d.ts +358 -0
  192. package/dist/remote/relay/convex/component/schema.d.ts.map +1 -0
  193. package/dist/remote/relay/convex/component/schema.js +287 -0
  194. package/dist/remote/relay/convex/component/schema.js.map +1 -0
  195. package/dist/remote/relay/convex/component/zkAuth.d.ts +12 -0
  196. package/dist/remote/relay/convex/component/zkAuth.d.ts.map +1 -0
  197. package/dist/remote/relay/convex/component/zkAuth.js +71 -0
  198. package/dist/remote/relay/convex/component/zkAuth.js.map +1 -0
  199. package/dist/remote/relay/convex/constants.d.ts +3 -0
  200. package/dist/remote/relay/convex/constants.d.ts.map +1 -0
  201. package/dist/remote/relay/convex/constants.js +3 -0
  202. package/dist/remote/relay/convex/constants.js.map +1 -0
  203. package/dist/remote/relay/convex/group-server.d.ts +9 -6
  204. package/dist/remote/relay/convex/group-server.d.ts.map +1 -1
  205. package/dist/remote/relay/convex/group-server.js +17 -11
  206. package/dist/remote/relay/convex/group-server.js.map +1 -1
  207. package/dist/remote/relay/convex/index.d.ts +4 -1
  208. package/dist/remote/relay/convex/index.d.ts.map +1 -1
  209. package/dist/remote/relay/convex/index.js +3 -1
  210. package/dist/remote/relay/convex/index.js.map +1 -1
  211. package/dist/remote/relay/convex/relay.d.ts +44 -65
  212. package/dist/remote/relay/convex/relay.d.ts.map +1 -1
  213. package/dist/remote/relay/convex/relay.js +61 -36
  214. package/dist/remote/relay/convex/relay.js.map +1 -1
  215. package/dist/remote/relay/convex/types.d.ts +16 -103
  216. package/dist/remote/relay/convex/types.d.ts.map +1 -1
  217. package/dist/remote/relay/convex/types.js +8 -13
  218. package/dist/remote/relay/convex/types.js.map +1 -1
  219. package/dist/remote/relay/index.d.ts +1 -1
  220. package/dist/remote/relay/index.d.ts.map +1 -1
  221. package/dist/remote/relay/index.js.map +1 -1
  222. package/dist/remote/relay/mock/adapter.d.ts +4 -9
  223. package/dist/remote/relay/mock/adapter.d.ts.map +1 -1
  224. package/dist/remote/relay/mock/adapter.js +39 -22
  225. package/dist/remote/relay/mock/adapter.js.map +1 -1
  226. package/dist/remote/relay/types.d.ts +57 -75
  227. package/dist/remote/relay/types.d.ts.map +1 -1
  228. package/dist/remote/relay/types.js +0 -1
  229. package/dist/remote/relay/types.js.map +1 -1
  230. package/dist/types/api.d.ts +21 -0
  231. package/dist/types/api.d.ts.map +1 -1
  232. package/dist/types/protocol-config.d.ts +51 -0
  233. package/dist/types/protocol-config.d.ts.map +1 -1
  234. package/dist/types/protocol-config.js +46 -0
  235. package/dist/types/protocol-config.js.map +1 -1
  236. package/docs/ASSURANCE.md +10 -6
  237. package/docs/CLIENT_COMPOSITION.md +23 -69
  238. package/docs/DEVIATIONS.md +44 -11
  239. package/docs/E2EE.md +71 -6
  240. package/docs/GETTING_STARTED.md +1 -1
  241. package/docs/PACKAGE_SURFACE.md +6 -5
  242. package/docs/RECIPES.md +1 -1
  243. package/docs/SECURITY.md +8 -0
  244. package/local/store/README.md +3 -1
  245. package/local/store/expo/README.md +10 -1
  246. package/local/store/node/README.md +8 -1
  247. package/package.json +12 -7
  248. package/remote/relay/convex/README.md +1 -1
  249. package/remote/relay/convex/component/README.md +428 -0
  250. package/scripts/oe-groups.mjs +21 -1
  251. package/dist/remote/relay/convex/server/index.d.ts +0 -2
  252. package/dist/remote/relay/convex/server/index.d.ts.map +0 -1
  253. package/dist/remote/relay/convex/server/index.js +0 -2
  254. package/dist/remote/relay/convex/server/index.js.map +0 -1
  255. package/dist/remote/relay/convex/server.d.ts +0 -150
  256. package/dist/remote/relay/convex/server.d.ts.map +0 -1
  257. package/dist/remote/relay/convex/server.js +0 -506
  258. package/dist/remote/relay/convex/server.js.map +0 -1
  259. package/docs/api/README.md +0 -471
  260. package/docs/api/classes/EncryptionError.md +0 -112
  261. package/docs/api/classes/EndorsementManager.md +0 -325
  262. package/docs/api/classes/SealedSenderAuthError.md +0 -127
  263. package/docs/api/classes/ServerDerivedKeyPair.md +0 -68
  264. package/docs/api/classes/ServerDerivedPublicKey.md +0 -33
  265. package/docs/api/classes/ServerRootKeyPair.md +0 -94
  266. package/docs/api/classes/ServerRootPublicKey.md +0 -72
  267. package/docs/api/classes/SignalProtocolBlockingManager.md +0 -106
  268. package/docs/api/classes/SignalProtocolClient.md +0 -2654
  269. package/docs/api/classes/VerificationFailure.md +0 -25
  270. package/docs/api/enumerations/ContentHint.md +0 -63
  271. package/docs/api/enumerations/EncryptionErrorCode.md +0 -488
  272. package/docs/api/enumerations/IdentityKeyChange.md +0 -65
  273. package/docs/api/enumerations/MessageType.md +0 -29
  274. package/docs/api/enumerations/TrustDirection.md +0 -33
  275. package/docs/api/enumerations/TypingAction.md +0 -31
  276. package/docs/api/functions/createDefaultSignalProtocolContentAdapter.md +0 -13
  277. package/docs/api/functions/createDefaultSignalProtocolLogger.md +0 -36
  278. package/docs/api/functions/createGroupId.md +0 -32
  279. package/docs/api/functions/createSignalProtocolClient.md +0 -36
  280. package/docs/api/functions/createSignalProtocolClientConfig.md +0 -24
  281. package/docs/api/functions/decodeGroupTrustRoot.md +0 -21
  282. package/docs/api/functions/encodeGroupTrustRoot.md +0 -28
  283. package/docs/api/functions/extractGroupId.md +0 -32
  284. package/docs/api/functions/formatVersion.md +0 -25
  285. package/docs/api/functions/isCompatible.md +0 -31
  286. package/docs/api/functions/isGroupId.md +0 -37
  287. package/docs/api/functions/isSealedSenderAuthError.md +0 -25
  288. package/docs/api/functions/parseVersion.md +0 -29
  289. package/docs/api/functions/resolveSPQRLimits.md +0 -21
  290. package/docs/api/functions/resolveSignalProtocolLogger.md +0 -42
  291. package/docs/api/interfaces/AccountIdentityProvisioning.md +0 -43
  292. package/docs/api/interfaces/AccountIdentityRotation.md +0 -69
  293. package/docs/api/interfaces/AttachmentTransferOptions.md +0 -49
  294. package/docs/api/interfaces/BlockedRecipientEntry.md +0 -25
  295. package/docs/api/interfaces/BlockedRecipientsSyncInput.md +0 -27
  296. package/docs/api/interfaces/ConfigurationSyncInput.md +0 -19
  297. package/docs/api/interfaces/CredentialPublicKey.md +0 -25
  298. package/docs/api/interfaces/DataMessageInput.md +0 -21
  299. package/docs/api/interfaces/DecryptedEnvelope.md +0 -95
  300. package/docs/api/interfaces/DecryptedGroup.md +0 -86
  301. package/docs/api/interfaces/DeviceInfo.md +0 -79
  302. package/docs/api/interfaces/DeviceRecord.md +0 -87
  303. package/docs/api/interfaces/DeviceRegistration.md +0 -27
  304. package/docs/api/interfaces/DoubleRatchetConfig.md +0 -36
  305. package/docs/api/interfaces/EcOneTimePreKey.md +0 -27
  306. package/docs/api/interfaces/EcSignedPreKey.md +0 -39
  307. package/docs/api/interfaces/EcSignedPreKeyUpload.md +0 -50
  308. package/docs/api/interfaces/EncryptionErrorContext.md +0 -51
  309. package/docs/api/interfaces/Envelope.md +0 -154
  310. package/docs/api/interfaces/ForceKeyResetResult.md +0 -37
  311. package/docs/api/interfaces/GroupAuthorization.md +0 -23
  312. package/docs/api/interfaces/GroupChangeEntry.md +0 -42
  313. package/docs/api/interfaces/GroupMemberDevice.md +0 -26
  314. package/docs/api/interfaces/GroupTrustRoot.md +0 -33
  315. package/docs/api/interfaces/IEcOneTimePreKeyStore.md +0 -86
  316. package/docs/api/interfaces/IEcSignedPreKeyStore.md +0 -133
  317. package/docs/api/interfaces/IGroupServer.md +0 -120
  318. package/docs/api/interfaces/IGroupStateStore.md +0 -128
  319. package/docs/api/interfaces/IIdentityKeyStore.md +0 -312
  320. package/docs/api/interfaces/IKemPreKeyStore.md +0 -144
  321. package/docs/api/interfaces/IKyberLastResortPreKeyStore.md +0 -112
  322. package/docs/api/interfaces/ILogger.md +0 -117
  323. package/docs/api/interfaces/IProtocolStore.md +0 -1033
  324. package/docs/api/interfaces/IRelayGroupServer.md +0 -60
  325. package/docs/api/interfaces/ISenderKeyStore.md +0 -417
  326. package/docs/api/interfaces/ISesameStore.md +0 -249
  327. package/docs/api/interfaces/ISessionStore.md +0 -178
  328. package/docs/api/interfaces/ISignalProtocolClient.md +0 -1185
  329. package/docs/api/interfaces/ISignalProtocolLocalSecretVault.md +0 -71
  330. package/docs/api/interfaces/ISignalProtocolLocalStore.md +0 -2053
  331. package/docs/api/interfaces/ISignalProtocolManager.md +0 -272
  332. package/docs/api/interfaces/ISignalProtocolRelayServer.md +0 -1337
  333. package/docs/api/interfaces/IdentityKeyPair.md +0 -49
  334. package/docs/api/interfaces/IncomingEnvelope.md +0 -91
  335. package/docs/api/interfaces/InspectedSignalProtocolContent.md +0 -43
  336. package/docs/api/interfaces/KDFChain.md +0 -31
  337. package/docs/api/interfaces/KemLastResortPreKeyUpload.md +0 -50
  338. package/docs/api/interfaces/KeyPair.md +0 -23
  339. package/docs/api/interfaces/KyberPreKey.md +0 -42
  340. package/docs/api/interfaces/MLKEMBraidAgentState.md +0 -191
  341. package/docs/api/interfaces/MLKEMBraidMessage.md +0 -49
  342. package/docs/api/interfaces/MediaAttachmentDeleteSyncInput.md +0 -31
  343. package/docs/api/interfaces/MessageHeader.md +0 -49
  344. package/docs/api/interfaces/MessageRecord.md +0 -86
  345. package/docs/api/interfaces/ParsedReceiptContent.md +0 -19
  346. package/docs/api/interfaces/ParsedTypingContent.md +0 -19
  347. package/docs/api/interfaces/PreKeyMaintenanceStore.md +0 -88
  348. package/docs/api/interfaces/PreKeyMessage.md +0 -159
  349. package/docs/api/interfaces/PreKeyStatusResult.md +0 -21
  350. package/docs/api/interfaces/PreKeyUpload.md +0 -42
  351. package/docs/api/interfaces/ProcessEnvelopeOptions.md +0 -72
  352. package/docs/api/interfaces/ProtocolAddress.md +0 -38
  353. package/docs/api/interfaces/ProtocolStrategyConfig.md +0 -91
  354. package/docs/api/interfaces/RatchetMessage.md +0 -96
  355. package/docs/api/interfaces/ReadSyncEntryInput.md +0 -19
  356. package/docs/api/interfaces/ReceiverChain.md +0 -43
  357. package/docs/api/interfaces/RecipientUsernameSyncInput.md +0 -31
  358. package/docs/api/interfaces/RelayPreKeyBundle.md +0 -254
  359. package/docs/api/interfaces/RemoteObjectDownload.md +0 -33
  360. package/docs/api/interfaces/RemoteObjectUpload.md +0 -49
  361. package/docs/api/interfaces/ResolvedSPQRInfoStrings.md +0 -27
  362. package/docs/api/interfaces/ResolvedSPQRLimits.md +0 -37
  363. package/docs/api/interfaces/RetryRequest.md +0 -80
  364. package/docs/api/interfaces/SCKAState.md +0 -65
  365. package/docs/api/interfaces/SPQRLimits.md +0 -40
  366. package/docs/api/interfaces/SPQRState.md +0 -191
  367. package/docs/api/interfaces/SafetyNumber.md +0 -60
  368. package/docs/api/interfaces/SafetyNumberConfirmation.md +0 -46
  369. package/docs/api/interfaces/SealedSenderConfig.md +0 -70
  370. package/docs/api/interfaces/SendOptions.md +0 -191
  371. package/docs/api/interfaces/SendResult.md +0 -93
  372. package/docs/api/interfaces/SenderKeyDistributionMessage.md +0 -43
  373. package/docs/api/interfaces/SenderKeyState.md +0 -76
  374. package/docs/api/interfaces/SenderKeysConfig.md +0 -65
  375. package/docs/api/interfaces/SentSyncTranscriptInput.md +0 -31
  376. package/docs/api/interfaces/ServiceId.md +0 -19
  377. package/docs/api/interfaces/SesameMessage.md +0 -84
  378. package/docs/api/interfaces/SesameStats.md +0 -57
  379. package/docs/api/interfaces/SessionHealthResult.md +0 -120
  380. package/docs/api/interfaces/SessionRecord.md +0 -80
  381. package/docs/api/interfaces/SessionRecordMetadata.md +0 -109
  382. package/docs/api/interfaces/SessionState.md +0 -368
  383. package/docs/api/interfaces/SessionTrustCommit.md +0 -58
  384. package/docs/api/interfaces/SignalProtocolBlockingHooks.md +0 -44
  385. package/docs/api/interfaces/SignalProtocolBlockingManagerOptions.md +0 -31
  386. package/docs/api/interfaces/SignalProtocolBlockingMirror.md +0 -30
  387. package/docs/api/interfaces/SignalProtocolBlockingStore.md +0 -83
  388. package/docs/api/interfaces/SignalProtocolClientAdapterConfig.md +0 -44
  389. package/docs/api/interfaces/SignalProtocolClientCompositionOptions.md +0 -731
  390. package/docs/api/interfaces/SignalProtocolClientConfig.md +0 -895
  391. package/docs/api/interfaces/SignalProtocolClientDeleteLocalAttachmentInput.md +0 -25
  392. package/docs/api/interfaces/SignalProtocolClientHooks.md +0 -506
  393. package/docs/api/interfaces/SignalProtocolClientIdentityConfig.md +0 -51
  394. package/docs/api/interfaces/SignalProtocolClientLoadLocalAttachmentInput.md +0 -187
  395. package/docs/api/interfaces/SignalProtocolClientLoadedLocalAttachment.md +0 -19
  396. package/docs/api/interfaces/SignalProtocolClientMedia.md +0 -83
  397. package/docs/api/interfaces/SignalProtocolClientMediaCompletedResult.md +0 -25
  398. package/docs/api/interfaces/SignalProtocolClientMediaConfig.md +0 -157
  399. package/docs/api/interfaces/SignalProtocolClientMediaDownloadCompletedResult.md +0 -37
  400. package/docs/api/interfaces/SignalProtocolClientMediaDownloadNotNeededResult.md +0 -25
  401. package/docs/api/interfaces/SignalProtocolClientMediaFailedResult.md +0 -19
  402. package/docs/api/interfaces/SignalProtocolClientMediaOperationOptions.md +0 -53
  403. package/docs/api/interfaces/SignalProtocolClientMediaPendingResult.md +0 -19
  404. package/docs/api/interfaces/SignalProtocolClientMediaProcessResult.md +0 -43
  405. package/docs/api/interfaces/SignalProtocolClientMediaSkippedResult.md +0 -25
  406. package/docs/api/interfaces/SignalProtocolClientMediaUploadCompletedResult.md +0 -31
  407. package/docs/api/interfaces/SignalProtocolClientProcessPendingMediaOptions.md +0 -87
  408. package/docs/api/interfaces/SignalProtocolClientSaveDownloadedAttachmentInput.md +0 -25
  409. package/docs/api/interfaces/SignalProtocolClientSaveUploadedAttachmentInput.md +0 -25
  410. package/docs/api/interfaces/SignalProtocolClientSyncDeleteInput.md +0 -19
  411. package/docs/api/interfaces/SignalProtocolConfig.md +0 -50
  412. package/docs/api/interfaces/SignalProtocolContentAdapter.md +0 -325
  413. package/docs/api/interfaces/SignalProtocolRemoteObjectStore.md +0 -88
  414. package/docs/api/interfaces/SkippedSenderMessageKey.md +0 -26
  415. package/docs/api/interfaces/TaskNotificationAckSyncInput.md +0 -31
  416. package/docs/api/interfaces/TripleRatchetState.md +0 -64
  417. package/docs/api/interfaces/UserRecord.md +0 -71
  418. package/docs/api/interfaces/UsernameStateSyncInput.md +0 -19
  419. package/docs/api/interfaces/VerificationStateSyncInput.md +0 -31
  420. package/docs/api/interfaces/VersionNegotiationState.md +0 -84
  421. package/docs/api/interfaces/ViewOnceOpenSyncInput.md +0 -19
  422. package/docs/api/namespaces/ProtocolAddress/README.md +0 -33
  423. package/docs/api/namespaces/ProtocolAddress/functions/create.md +0 -41
  424. package/docs/api/namespaces/ProtocolAddress/functions/equals.md +0 -39
  425. package/docs/api/namespaces/ProtocolAddress/functions/fromStorageKey.md +0 -36
  426. package/docs/api/namespaces/ProtocolAddress/functions/isUser.md +0 -39
  427. package/docs/api/namespaces/ProtocolAddress/functions/isValid.md +0 -34
  428. package/docs/api/namespaces/ProtocolAddress/functions/parse.md +0 -41
  429. package/docs/api/namespaces/ProtocolAddress/functions/toStorageKey.md +0 -38
  430. package/docs/api/namespaces/ProtocolAddress/functions/toString.md +0 -34
  431. package/docs/api/namespaces/SessionRecord/README.md +0 -30
  432. package/docs/api/namespaces/SessionRecord/functions/archiveCurrent.md +0 -40
  433. package/docs/api/namespaces/SessionRecord/functions/archiveCurrentState.md +0 -34
  434. package/docs/api/namespaces/SessionRecord/functions/create.md +0 -25
  435. package/docs/api/namespaces/SessionRecord/functions/deserialize.md +0 -29
  436. package/docs/api/namespaces/SessionRecord/functions/findSession.md +0 -34
  437. package/docs/api/namespaces/SessionRecord/functions/getAllSessions.md +0 -25
  438. package/docs/api/namespaces/SessionRecord/functions/getArchivedCount.md +0 -25
  439. package/docs/api/namespaces/SessionRecord/functions/hasCurrentSession.md +0 -25
  440. package/docs/api/namespaces/SessionRecord/functions/hasUsableSenderChain.md +0 -36
  441. package/docs/api/namespaces/SessionRecord/functions/promoteSession.md +0 -34
  442. package/docs/api/namespaces/SessionRecord/functions/serialize.md +0 -28
  443. package/docs/api/namespaces/SessionRecord/variables/MAX_ARCHIVED_SESSIONS.md +0 -14
  444. package/docs/api/namespaces/SessionState/README.md +0 -15
  445. package/docs/api/namespaces/SessionState/functions/getSessionId.md +0 -32
  446. package/docs/api/namespaces/blocking/README.md +0 -43
  447. package/docs/api/namespaces/encoding/README.md +0 -33
  448. package/docs/api/namespaces/encoding/functions/base64ToUrlSafe.md +0 -28
  449. package/docs/api/namespaces/encoding/functions/bytesToBase64.md +0 -21
  450. package/docs/api/namespaces/encoding/functions/bytesToString.md +0 -21
  451. package/docs/api/namespaces/encoding/functions/bytesToUrlSafeBase64.md +0 -33
  452. package/docs/api/namespaces/encoding/functions/concatBytes.md +0 -21
  453. package/docs/api/namespaces/encoding/functions/stringToBytes.md +0 -21
  454. package/docs/api/namespaces/encoding/functions/urlSafeToBase64.md +0 -27
  455. package/docs/api/namespaces/keys/README.md +0 -130
  456. package/docs/api/namespaces/keys/functions/acceptContactIdentityRotation.md +0 -33
  457. package/docs/api/namespaces/keys/functions/assertIdentityCommitment.md +0 -25
  458. package/docs/api/namespaces/keys/functions/canonicalizeDeviceIdentityKey.md +0 -30
  459. package/docs/api/namespaces/keys/functions/compareDeviceIdentityKeys.md +0 -28
  460. package/docs/api/namespaces/keys/functions/compositeIdentitiesEqual.md +0 -23
  461. package/docs/api/namespaces/keys/functions/createCompositeIdentityV1.md +0 -19
  462. package/docs/api/namespaces/keys/functions/createPreKeySignatureContext.md +0 -31
  463. package/docs/api/namespaces/keys/functions/createUnverifiedContactIdentityRecord.md +0 -23
  464. package/docs/api/namespaces/keys/functions/decodeCompositeIdentityV1.md +0 -19
  465. package/docs/api/namespaces/keys/functions/deriveIdentityCommitment.md +0 -19
  466. package/docs/api/namespaces/keys/functions/encodeCompositeIdentityV1.md +0 -19
  467. package/docs/api/namespaces/keys/functions/evaluateContactIdentityCandidate.md +0 -27
  468. package/docs/api/namespaces/keys/functions/generateEcOneTimePreKeys.md +0 -37
  469. package/docs/api/namespaces/keys/functions/generateEcSignedPreKey.md +0 -39
  470. package/docs/api/namespaces/keys/functions/generateEcSignedPreKeyId.md +0 -21
  471. package/docs/api/namespaces/keys/functions/generateIdentityKeyPair.md +0 -24
  472. package/docs/api/namespaces/keys/functions/generateKemOneTimePreKeys.md +0 -47
  473. package/docs/api/namespaces/keys/functions/generateKyberLastResortPreKey.md +0 -37
  474. package/docs/api/namespaces/keys/functions/generateRegistrationId.md +0 -13
  475. package/docs/api/namespaces/keys/functions/isValidDeviceIdentityKey.md +0 -22
  476. package/docs/api/namespaces/keys/functions/signMlKem1024PreKey.md +0 -29
  477. package/docs/api/namespaces/keys/functions/signPreKey.md +0 -31
  478. package/docs/api/namespaces/keys/functions/validateContactIdentityRecord.md +0 -19
  479. package/docs/api/namespaces/keys/functions/verifyContactIdentityRecord.md +0 -31
  480. package/docs/api/namespaces/keys/functions/verifyMlKem1024PreKey.md +0 -33
  481. package/docs/api/namespaces/keys/functions/verifyPreKeySignature.md +0 -35
  482. package/docs/api/namespaces/keys/interfaces/CompositeIdentityV1.md +0 -33
  483. package/docs/api/namespaces/keys/interfaces/ContactIdentityRecord.md +0 -53
  484. package/docs/api/namespaces/keys/interfaces/KemOneTimePreKey.md +0 -43
  485. package/docs/api/namespaces/keys/type-aliases/IdentityCandidateStatus.md +0 -9
  486. package/docs/api/namespaces/keys/type-aliases/IdentityTrustState.md +0 -9
  487. package/docs/api/namespaces/keys/type-aliases/IdentityType.md +0 -9
  488. package/docs/api/namespaces/keys/variables/COMPOSITE_IDENTITY_V1_ED25519_TAG.md +0 -9
  489. package/docs/api/namespaces/keys/variables/COMPOSITE_IDENTITY_V1_LENGTH.md +0 -9
  490. package/docs/api/namespaces/keys/variables/COMPOSITE_IDENTITY_V1_VERSION.md +0 -9
  491. package/docs/api/namespaces/keys/variables/COMPOSITE_IDENTITY_V1_X25519_TAG.md +0 -9
  492. package/docs/api/namespaces/keys/variables/IDENTITY_COMMITMENT_V1_DOMAIN.md +0 -9
  493. package/docs/api/namespaces/keys/variables/PREKEY_ALGORITHM_ML_KEM_1024.md +0 -9
  494. package/docs/api/namespaces/keys/variables/PREKEY_ALGORITHM_X25519.md +0 -9
  495. package/docs/api/namespaces/keys/variables/PREKEY_SIGNATURE_V1_DOMAIN.md +0 -9
  496. package/docs/api/namespaces/keys/variables/UNPINNED_DEVICE_IDENTITY_KEY.md +0 -18
  497. package/docs/api/namespaces/media/README.md +0 -105
  498. package/docs/api/namespaces/media/classes/MediaAttachmentError.md +0 -57
  499. package/docs/api/namespaces/media/functions/createByteRangeMediaAttachmentTransfer.md +0 -19
  500. package/docs/api/namespaces/media/functions/createMediaAttachmentDeliveryId.md +0 -29
  501. package/docs/api/namespaces/media/functions/createMediaAttachmentId.md +0 -19
  502. package/docs/api/namespaces/media/functions/createMediaAttachmentMessage.md +0 -25
  503. package/docs/api/namespaces/media/functions/createMediaAttachmentPointer.md +0 -19
  504. package/docs/api/namespaces/media/functions/createTusMediaAttachmentTransfer.md +0 -19
  505. package/docs/api/namespaces/media/functions/deleteMediaAttachment.md +0 -23
  506. package/docs/api/namespaces/media/functions/executeMediaAttachmentJob.md +0 -23
  507. package/docs/api/namespaces/media/functions/isMediaAttachmentFlagSet.md +0 -19
  508. package/docs/api/namespaces/media/functions/parseMediaAttachmentMessage.md +0 -19
  509. package/docs/api/namespaces/media/functions/planMediaAttachmentCleanup.md +0 -23
  510. package/docs/api/namespaces/media/functions/planMediaAttachmentCleanupJobs.md +0 -19
  511. package/docs/api/namespaces/media/functions/planMediaAttachmentDeleteSync.md +0 -19
  512. package/docs/api/namespaces/media/functions/planMediaAttachmentDownloadJob.md +0 -19
  513. package/docs/api/namespaces/media/functions/planMediaAttachmentOpen.md +0 -19
  514. package/docs/api/namespaces/media/functions/planMediaAttachmentProcessing.md +0 -19
  515. package/docs/api/namespaces/media/functions/planMediaAttachmentUploadJob.md +0 -19
  516. package/docs/api/namespaces/media/functions/prepareMediaAttachmentUpload.md +0 -30
  517. package/docs/api/namespaces/media/functions/resolveMediaAttachment.md +0 -30
  518. package/docs/api/namespaces/media/functions/serializeMediaAttachmentMessage.md +0 -25
  519. package/docs/api/namespaces/media/functions/validateMediaAttachmentPolicy.md +0 -23
  520. package/docs/api/namespaces/media/interfaces/ByteRangeMediaAttachmentPartialStore.md +0 -68
  521. package/docs/api/namespaces/media/interfaces/ByteRangeMediaAttachmentTransferOptions.md +0 -91
  522. package/docs/api/namespaces/media/interfaces/DeleteMediaAttachmentOptions.md +0 -25
  523. package/docs/api/namespaces/media/interfaces/DeleteMediaAttachmentResult.md +0 -19
  524. package/docs/api/namespaces/media/interfaces/ExecuteMediaAttachmentJobOptions.md +0 -157
  525. package/docs/api/namespaces/media/interfaces/MediaAttachmentBackgroundJob.md +0 -85
  526. package/docs/api/namespaces/media/interfaces/MediaAttachmentCleanupPlan.md +0 -37
  527. package/docs/api/namespaces/media/interfaces/MediaAttachmentJobExecutionResult.md +0 -55
  528. package/docs/api/namespaces/media/interfaces/MediaAttachmentMessage.md +0 -31
  529. package/docs/api/namespaces/media/interfaces/MediaAttachmentOpenDecision.md +0 -31
  530. package/docs/api/namespaces/media/interfaces/MediaAttachmentPointer.md +0 -133
  531. package/docs/api/namespaces/media/interfaces/MediaAttachmentPolicy.md +0 -67
  532. package/docs/api/namespaces/media/interfaces/MediaAttachmentProcessingPlan.md +0 -73
  533. package/docs/api/namespaces/media/interfaces/MediaAttachmentProgress.md +0 -69
  534. package/docs/api/namespaces/media/interfaces/MediaAttachmentResumeState.md +0 -37
  535. package/docs/api/namespaces/media/interfaces/MediaAttachmentRetryOptions.md +0 -31
  536. package/docs/api/namespaces/media/interfaces/MediaAttachmentTransfer.md +0 -51
  537. package/docs/api/namespaces/media/interfaces/MediaAttachmentTransferCheckpoint.md +0 -69
  538. package/docs/api/namespaces/media/interfaces/MediaAttachmentTransferOptions.md +0 -67
  539. package/docs/api/namespaces/media/interfaces/MediaAttachmentUploadJobData.md +0 -19
  540. package/docs/api/namespaces/media/interfaces/MediaAttachmentUploadResponse.md +0 -25
  541. package/docs/api/namespaces/media/interfaces/PlanMediaAttachmentCleanupJobsInput.md +0 -61
  542. package/docs/api/namespaces/media/interfaces/PlanMediaAttachmentDeleteSyncInput.md +0 -25
  543. package/docs/api/namespaces/media/interfaces/PlanMediaAttachmentDownloadJobInput.md +0 -161
  544. package/docs/api/namespaces/media/interfaces/PlanMediaAttachmentOpenInput.md +0 -25
  545. package/docs/api/namespaces/media/interfaces/PlanMediaAttachmentProcessingInput.md +0 -83
  546. package/docs/api/namespaces/media/interfaces/PlanMediaAttachmentUploadJobInput.md +0 -147
  547. package/docs/api/namespaces/media/interfaces/PrepareMediaAttachmentUploadOptions.md +0 -144
  548. package/docs/api/namespaces/media/interfaces/ResolveMediaAttachmentOptions.md +0 -55
  549. package/docs/api/namespaces/media/interfaces/ResolvedMediaAttachment.md +0 -109
  550. package/docs/api/namespaces/media/interfaces/TusMediaAttachmentTransferOptions.md +0 -85
  551. package/docs/api/namespaces/media/type-aliases/CreateMediaAttachmentPointerInput.md +0 -15
  552. package/docs/api/namespaces/media/type-aliases/MediaAttachmentCheckpointCallback.md +0 -19
  553. package/docs/api/namespaces/media/type-aliases/MediaAttachmentCleanupReason.md +0 -9
  554. package/docs/api/namespaces/media/type-aliases/MediaAttachmentErrorCode.md +0 -9
  555. package/docs/api/namespaces/media/type-aliases/MediaAttachmentFlag.md +0 -9
  556. package/docs/api/namespaces/media/type-aliases/MediaAttachmentJobExecutionStatus.md +0 -9
  557. package/docs/api/namespaces/media/type-aliases/MediaAttachmentJobOperation.md +0 -9
  558. package/docs/api/namespaces/media/type-aliases/MediaAttachmentJobPriority.md +0 -9
  559. package/docs/api/namespaces/media/type-aliases/MediaAttachmentJobSkipReason.md +0 -9
  560. package/docs/api/namespaces/media/type-aliases/MediaAttachmentJobSource.md +0 -9
  561. package/docs/api/namespaces/media/type-aliases/MediaAttachmentKnownIds.md +0 -9
  562. package/docs/api/namespaces/media/type-aliases/MediaAttachmentMessageType.md +0 -9
  563. package/docs/api/namespaces/media/type-aliases/MediaAttachmentProgressCallback.md +0 -19
  564. package/docs/api/namespaces/media/variables/MEDIA_ATTACHMENT_POLICY_DEFAULTS.md +0 -47
  565. package/docs/api/namespaces/media/variables/MEDIA_ATTACHMENT_POLICY_PRESETS.md +0 -95
  566. package/docs/api/namespaces/media/variables/MediaAttachmentCleanupReason.md +0 -27
  567. package/docs/api/namespaces/media/variables/MediaAttachmentErrorCode.md +0 -75
  568. package/docs/api/namespaces/media/variables/MediaAttachmentFlag.md +0 -23
  569. package/docs/api/namespaces/media/variables/MediaAttachmentJobExecutionStatus.md +0 -19
  570. package/docs/api/namespaces/media/variables/MediaAttachmentJobOperation.md +0 -31
  571. package/docs/api/namespaces/media/variables/MediaAttachmentJobPriority.md +0 -23
  572. package/docs/api/namespaces/media/variables/MediaAttachmentJobSource.md +0 -51
  573. package/docs/api/namespaces/media/variables/MediaAttachmentMessageType.md +0 -15
  574. package/docs/api/namespaces/media/variables/downloadMediaAttachment.md +0 -30
  575. package/docs/api/namespaces/safety/README.md +0 -61
  576. package/docs/api/namespaces/safety/classes/DisplayableFingerprint.md +0 -108
  577. package/docs/api/namespaces/safety/classes/Fingerprint.md +0 -104
  578. package/docs/api/namespaces/safety/classes/ScannableFingerprint.md +0 -209
  579. package/docs/api/namespaces/safety/functions/base64ToBytes.md +0 -21
  580. package/docs/api/namespaces/safety/functions/clearFingerprintCache.md +0 -15
  581. package/docs/api/namespaces/safety/functions/compareSafetyNumbers.md +0 -25
  582. package/docs/api/namespaces/safety/functions/createFingerprintData.md +0 -60
  583. package/docs/api/namespaces/safety/functions/extractQrData.md +0 -34
  584. package/docs/api/namespaces/safety/functions/generateCompositeSafetyNumber.md +0 -39
  585. package/docs/api/namespaces/safety/functions/generateEmojiFingerprint.md +0 -24
  586. package/docs/api/namespaces/safety/functions/generateSingleKeyReferenceSafetyNumber.md +0 -51
  587. package/docs/api/namespaces/safety/functions/generateVerifySchemeUrl.md +0 -32
  588. package/docs/api/namespaces/safety/functions/generateVerifyUrl.md +0 -49
  589. package/docs/api/namespaces/safety/functions/isValidSafetyNumber.md +0 -21
  590. package/docs/api/namespaces/safety/functions/isVerifyUrl.md +0 -45
  591. package/docs/api/namespaces/safety/functions/parseVerifyUrl.md +0 -31
  592. package/docs/api/namespaces/safety/interfaces/FingerprintData.md +0 -52
  593. package/docs/api/namespaces/safety/interfaces/SafetyNumber.md +0 -49
  594. package/docs/api/namespaces/safety/interfaces/VerifyLinkConfig.md +0 -28
  595. package/docs/api/namespaces/safety/interfaces/VerifyUrlParams.md +0 -49
  596. package/docs/api/namespaces/safety/type-aliases/CompareResult.md +0 -21
  597. package/docs/api/namespaces/safety/variables/DEFAULT_VERIFY_LINK_CONFIG.md +0 -12
  598. package/docs/api/namespaces/safety/variables/FINGERPRINT_ITERATIONS.md +0 -12
  599. package/docs/api/namespaces/safety/variables/FINGERPRINT_VERSION.md +0 -12
  600. package/docs/api/namespaces/safety/variables/VERIFY_BASE_URL.md +0 -11
  601. package/docs/api/namespaces/safety/variables/VERIFY_SCHEME_URL.md +0 -11
  602. package/docs/api/type-aliases/Base64.md +0 -20
  603. package/docs/api/type-aliases/BraidPolicy.md +0 -11
  604. package/docs/api/type-aliases/Bytes.md +0 -20
  605. package/docs/api/type-aliases/Ciphertext.md +0 -21
  606. package/docs/api/type-aliases/DeviceType.md +0 -11
  607. package/docs/api/type-aliases/DownloadedAttachment.md +0 -11
  608. package/docs/api/type-aliases/GroupId.md +0 -27
  609. package/docs/api/type-aliases/Hex.md +0 -20
  610. package/docs/api/type-aliases/HookName.md +0 -11
  611. package/docs/api/type-aliases/PostQuantumPolicy.md +0 -11
  612. package/docs/api/type-aliases/PreparedAttachmentUpload.md +0 -14
  613. package/docs/api/type-aliases/PrivateKey.md +0 -22
  614. package/docs/api/type-aliases/ProgressCallback.md +0 -45
  615. package/docs/api/type-aliases/PublicKey.md +0 -22
  616. package/docs/api/type-aliases/RemoteObjectCompleteUploadRequest.md +0 -19
  617. package/docs/api/type-aliases/RemoteObjectDeleteRequest.md +0 -19
  618. package/docs/api/type-aliases/RemoteObjectDownloadRequest.md +0 -19
  619. package/docs/api/type-aliases/RemoteObjectUploadRequest.md +0 -42
  620. package/docs/api/type-aliases/SCKAMode.md +0 -11
  621. package/docs/api/type-aliases/SealedSenderAuth.md +0 -15
  622. package/docs/api/type-aliases/SignalProtocolClientMediaCleanupInput.md +0 -9
  623. package/docs/api/type-aliases/SignalProtocolClientMediaCleanupResult.md +0 -9
  624. package/docs/api/type-aliases/SignalProtocolClientMediaDownloadInput.md +0 -9
  625. package/docs/api/type-aliases/SignalProtocolClientMediaDownloadResult.md +0 -9
  626. package/docs/api/type-aliases/SignalProtocolClientMediaOperationResult.md +0 -9
  627. package/docs/api/type-aliases/SignalProtocolClientMediaUploadInput.md +0 -9
  628. package/docs/api/type-aliases/SignalProtocolClientMediaUploadResult.md +0 -9
  629. package/docs/api/type-aliases/Signature.md +0 -21
  630. package/docs/api/type-aliases/Unsubscribe.md +0 -15
  631. package/docs/api/variables/BraidPolicy.md +0 -21
  632. package/docs/api/variables/DEFAULT_DEVICE_ID.md +0 -12
  633. package/docs/api/variables/DOUBLE_RATCHET_SPEC.md +0 -11
  634. package/docs/api/variables/GROUP_ID_PREFIX.md +0 -11
  635. package/docs/api/variables/GROUP_TRUST_ROOT_VERSION.md +0 -11
  636. package/docs/api/variables/KEY_REFRESH_INTERVAL_MS_DEFAULT.md +0 -11
  637. package/docs/api/variables/MAX_MESSAGE_KEYS.md +0 -14
  638. package/docs/api/variables/MAX_PREKEY_AGE_MS_DEFAULT.md +0 -11
  639. package/docs/api/variables/MAX_RECEIVER_CHAINS.md +0 -14
  640. package/docs/api/variables/MAX_REGISTRATION_ID.md +0 -16
  641. package/docs/api/variables/MAX_SKIP.md +0 -11
  642. package/docs/api/variables/MESSAGE_FORMAT.md +0 -11
  643. package/docs/api/variables/MIN_REGISTRATION_ID.md +0 -16
  644. package/docs/api/variables/ML_KEM_BRAID_SPEC.md +0 -11
  645. package/docs/api/variables/ONE_TIME_PREKEY_BATCH_SIZE.md +0 -21
  646. package/docs/api/variables/PQXDH_SPEC.md +0 -11
  647. package/docs/api/variables/PostQuantumPolicy.md +0 -21
  648. package/docs/api/variables/SENDER_KEY_FORMAT.md +0 -11
  649. package/docs/api/variables/SENDER_KEY_SPEC.md +0 -11
  650. package/docs/api/variables/SESAME_SPEC.md +0 -11
  651. package/docs/api/variables/SESSION_FORMAT.md +0 -11
  652. package/docs/api/variables/SPQR_LIMITS_DEFAULTS.md +0 -11
  653. package/docs/api/variables/X3DH_SPEC.md +0 -9
  654. package/docs/api/variables/defaultSignalProtocolLogger.md +0 -32
  655. package/remote/relay/convex/server/README.md +0 -146
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@open-e2ee/signal-protocol-sdk",
3
- "version": "0.1.0-alpha.7",
3
+ "version": "0.1.0-alpha.9",
4
4
  "description": "Signal Protocol E2EE SDK for TypeScript — Expo, React Native, browser, and Node. Post-quantum PQXDH and Double Ratchet.",
5
5
  "keywords": [
6
6
  "open-e2ee",
@@ -63,9 +63,9 @@
63
63
  "types": "./dist/remote/relay/convex/relay.d.ts",
64
64
  "default": "./dist/remote/relay/convex/relay.js"
65
65
  },
66
- "./remote/relay/convex/server": {
67
- "types": "./dist/remote/relay/convex/server/index.d.ts",
68
- "default": "./dist/remote/relay/convex/server/index.js"
66
+ "./convex.config": {
67
+ "types": "./dist/remote/relay/convex/component/convex.config.d.ts",
68
+ "default": "./dist/remote/relay/convex/component/convex.config.js"
69
69
  },
70
70
  "./remote/relay/mock": {
71
71
  "types": "./dist/remote/relay/mock/index.d.ts",
@@ -285,11 +285,12 @@
285
285
  "ADAPTERS.md",
286
286
  "ARCHITECTURE.md",
287
287
  "CHANGELOG.md",
288
+ "COMMERCIAL.md",
288
289
  "LICENSE",
289
290
  "NOTICE",
290
- "THIRD_PARTY_NOTICES.md",
291
291
  "README.md",
292
292
  "SECURITY.md",
293
+ "THIRD_PARTY_NOTICES.md",
293
294
  "TROUBLESHOOTING.md",
294
295
  "blocking/README.md",
295
296
  "client/README.md",
@@ -307,7 +308,6 @@
307
308
  "docs/PROTOCOL_POLICY.md",
308
309
  "docs/RECIPES.md",
309
310
  "docs/SECURITY.md",
310
- "docs/api",
311
311
  "encoding/README.md",
312
312
  "files/README.md",
313
313
  "groups/README.md",
@@ -328,7 +328,7 @@
328
328
  "remote/object-store/s3/README.md",
329
329
  "remote/relay/README.md",
330
330
  "remote/relay/convex/README.md",
331
- "remote/relay/convex/server/README.md",
331
+ "remote/relay/convex/component/README.md",
332
332
  "remote/relay/mock/README.md",
333
333
  "safety/README.md",
334
334
  "scripts/oe-groups.mjs",
@@ -355,6 +355,7 @@
355
355
  },
356
356
  "peerDependencies": {
357
357
  "@convex-dev/r2": "^0.10.2",
358
+ "@convex-dev/rate-limiter": "^0.3.2",
358
359
  "convex": "^1.42.1",
359
360
  "drizzle-orm": "^0.45.1",
360
361
  "expo": "~55.0.27",
@@ -372,6 +373,9 @@
372
373
  "@convex-dev/r2": {
373
374
  "optional": true
374
375
  },
376
+ "@convex-dev/rate-limiter": {
377
+ "optional": true
378
+ },
375
379
  "convex": {
376
380
  "optional": true
377
381
  },
@@ -426,6 +430,7 @@
426
430
  },
427
431
  "devDependencies": {
428
432
  "@convex-dev/r2": "^0.10.2",
433
+ "@convex-dev/rate-limiter": "^0.3.2",
429
434
  "@types/async-lock": "^1.4.0",
430
435
  "@types/node": "^22.0.0",
431
436
  "@types/react": "^19.0.0",
@@ -47,7 +47,7 @@ by `ConvexSignalProtocolRelayApi`. Use `satisfies` to get a compile-time diagnos
47
47
  without widening the generated references.
48
48
 
49
49
  To serve groups from this deployment, also mount the
50
- [Convex group server](./server/README.md) inside the same namespace
50
+ [Convex Signal Protocol component](./component/README.md) inside the same namespace
51
51
  (`convex/signal/groups.ts` and `convex/signal/zkAuth.ts`); the relay
52
52
  advertises its `groupServer` capability only when both modules are
53
53
  configured.
@@ -0,0 +1,428 @@
1
+ # Convex Signal Protocol component
2
+
3
+ This installable Convex component owns the complete relay backend: account and
4
+ device registration, identity and prekey storage, message queues, sealed-sender
5
+ delivery, retry requests, provisioning, sender certificates, canonical
6
+ encrypted group state, anonymous group authorization, credential issuance, and
7
+ group-send endorsements. The app owns only its
8
+ authentication-to-protocol-identity mapping and thin public wrappers.
9
+
10
+ ## Install the component
11
+
12
+ Mount the component in the app's Convex configuration:
13
+
14
+ ```ts
15
+ // convex/convex.config.ts
16
+ import { defineApp } from 'convex/server';
17
+ import { v } from 'convex/values';
18
+ import signalProtocol from '@open-e2ee/signal-protocol-sdk/convex.config';
19
+
20
+ const app = defineApp({
21
+ env: { OE_GROUPS_SERVER_SECRET: v.optional(v.string()) },
22
+ });
23
+ app.use(signalProtocol, {
24
+ env: { OE_GROUPS_SERVER_SECRET: app.env.OE_GROUPS_SERVER_SECRET },
25
+ });
26
+ export default app;
27
+ ```
28
+
29
+ The `env` forwarding is load-bearing: Convex components are isolated from the
30
+ app's environment variables, so without it the component cannot see the
31
+ deployment's `OE_GROUPS_SERVER_SECRET` and every group, credential-issuance,
32
+ and sender-certificate call fails at runtime. The messaging, device, key, and
33
+ provisioning namespaces work without the secret.
34
+
35
+ The component owns these isolated tables. They do not appear in the app schema
36
+ and need no package-specific prefixes:
37
+
38
+ - `accounts`: reverse lookup from application account IDs to protocol service
39
+ identifiers and sealed-sender access keys.
40
+ - `devices` and `deviceHeartbeats`: device lifecycle and presence state.
41
+ - `identityKeys` and `identityRegistrations`: account-scoped composite
42
+ identities and device-scoped registration IDs.
43
+ - `ecPreKeys`, `ecSignedPreKeys`, `kemOneTimePreKeys`, and
44
+ `kemLastResortPreKeys`: the four prekey kinds, including durable one-time-key
45
+ consumption tombstones.
46
+ - `messages` and `retryRequests`: device delivery and retry queues.
47
+ - `provisioningSessions`: the linked-device provisioning state machine.
48
+ - `senderCertificates`: cached account/device certificate material.
49
+ - `groups`, `groupChanges`, and `groupSnapshots`: canonical encrypted group
50
+ state, immutable signed changes, and per-version signed snapshots.
51
+
52
+ The component derives **no** membership map from group state. Group reads and
53
+ writes are authorized entirely by zero-knowledge presentations, so `groups`,
54
+ `groupChanges`, and `groupSnapshots` never name an account, and there is no
55
+ `getGroupMembers` endpoint anywhere in the relay surface. Membership is
56
+ local-first: each client resolves fan-out recipients from its own decrypted
57
+ group state and passes their user IDs with the send
58
+ (`SendOptions.groupMemberUserIds`); the relay expands users to devices via
59
+ `getActiveDevices`.
60
+
61
+ See [Group metadata privacy](#group-metadata-privacy) for what the relay can
62
+ still infer from delivery traffic. The absence of a membership endpoint is not
63
+ by itself a metadata-privacy guarantee.
64
+
65
+ The mounted `@convex-dev/rate-limiter` child component separately owns its
66
+ isolated `rateLimits` table.
67
+
68
+ The tables store the latest canonical encrypted state, the exact accepted and
69
+ signed action bytes, and every historical encrypted snapshot with its cached
70
+ S14 baseline signature. They never store the group master key, group secret
71
+ parameters, plaintext group attributes, or the server secret.
72
+
73
+ Storage grows with one full encrypted snapshot per accepted version and is
74
+ never pruned. Old snapshots are load-bearing: `getGroupChanges` serves signed
75
+ history from them, so deleting rows breaks catch-up for clients behind that
76
+ version. A snapshot-compaction protocol is future work; budget storage as
77
+ O(versions × state size) per group.
78
+
79
+ ## Mount the public wrappers
80
+
81
+ Create the wrapper once with the mounted component reference and the app's
82
+ authentication hook:
83
+
84
+ ```ts
85
+ // convex/relayBackend.ts
86
+ import { components } from './_generated/api';
87
+ import { defineConvexSignalProtocolBackend } from '@open-e2ee/signal-protocol-sdk/remote/relay/convex';
88
+ import { resolveProtocolIdentity } from './auth';
89
+
90
+ export const signalRelay = defineConvexSignalProtocolBackend(
91
+ components.signalProtocol,
92
+ {
93
+ identify: async (ctx) => {
94
+ const identity = await resolveProtocolIdentity(ctx);
95
+ return {
96
+ userId: identity.userId,
97
+ aciBytes: identity.aciBytes,
98
+ pniBytes: identity.pniBytes,
99
+ };
100
+ },
101
+ }
102
+ );
103
+ ```
104
+
105
+ The relay reads these functions through `api.signal`, so the modules must live
106
+ inside that namespace rather than at the top of `convex/`:
107
+
108
+ ```ts
109
+ // convex/signal/groups.ts
110
+ import { signalRelay } from '../relayBackend';
111
+
112
+ export const {
113
+ createGroup,
114
+ getGroup,
115
+ getGroupJoinInfo,
116
+ getGroupChanges,
117
+ submitGroupChange,
118
+ refreshGroupSendEndorsements,
119
+ } = signalRelay.groups;
120
+ ```
121
+
122
+ ```ts
123
+ // convex/signal/zkAuth.ts
124
+ import { signalRelay } from '../relayBackend';
125
+
126
+ export const {
127
+ issueAuthCredentialMutation,
128
+ issueProfileKeyCredentialMutation,
129
+ } = signalRelay.zkAuth;
130
+ ```
131
+
132
+ Mount the remaining relay namespaces alongside those group modules:
133
+
134
+ ```ts
135
+ // convex/signal/messages.ts
136
+ import { signalRelay } from '../relayBackend';
137
+ export const {
138
+ send,
139
+ getPendingMessages,
140
+ markDelivered,
141
+ getActiveDevices,
142
+ sendUnidentified,
143
+ sendMultiRecipientUnidentified,
144
+ sendRetryRequest,
145
+ getPendingRetryRequests,
146
+ markRetryRequestHandled,
147
+ } = signalRelay.messages;
148
+ ```
149
+
150
+ ```ts
151
+ // convex/signal/devices.ts
152
+ import { signalRelay } from '../relayBackend';
153
+ export const {
154
+ getDevices,
155
+ registerDevice,
156
+ removeDevice,
157
+ markDeviceConnected,
158
+ markDeviceDisconnected,
159
+ presenceHeartbeat,
160
+ } = signalRelay.devices;
161
+ ```
162
+
163
+ ```ts
164
+ // convex/signal/keys.ts
165
+ import { signalRelay } from '../relayBackend';
166
+ export const {
167
+ uploadIdentityKey,
168
+ getIdentityKey,
169
+ uploadPreKeys,
170
+ fetchPreKeyBundle,
171
+ getPreKeyCount,
172
+ clearStaleKemPreKeys,
173
+ uploadEcSignedPreKey,
174
+ uploadKemLastResortPreKey,
175
+ getEcSignedPreKeyMetadata,
176
+ getKemLastResortPreKeyMetadata,
177
+ } = signalRelay.keys;
178
+ ```
179
+
180
+ ```ts
181
+ // convex/signal/certificates.ts
182
+ import { signalRelay } from '../relayBackend';
183
+ export const { issueSenderCertificate } = signalRelay.certificates;
184
+ ```
185
+
186
+ ```ts
187
+ // convex/signal/provisioning.ts
188
+ import { signalRelay } from '../relayBackend';
189
+ export const {
190
+ createProvisioningSession,
191
+ connectNewDevice,
192
+ sendProvisioningMessage,
193
+ getProvisioningMessage,
194
+ completeProvisioning,
195
+ acknowledgeProvisioning,
196
+ rollbackProvisioning,
197
+ deleteProvisioningSession,
198
+ } = signalRelay.provisioning;
199
+ ```
200
+
201
+ `messages` owns identified and sealed delivery, multi-recipient fan-out, retry
202
+ queues, and message/device lookup reads. `devices` owns registration, removal,
203
+ connection state, and presence. `keys` owns identity provisioning and
204
+ compare-and-swap rotation, prekey upload, atomic one-time-key consumption, and
205
+ key metadata. `certificates` issues sender certificates for registered
206
+ account/device identities. `provisioning` owns the linked-device session state
207
+ machine through acknowledgment or rollback.
208
+
209
+ The account-scoped wrappers resolve the caller identity on the server and
210
+ inject the application `userId`, raw ACI, and optional PNI bytes into the
211
+ isolated component. Client-supplied owner IDs are never trusted. Credential
212
+ issuance also resolves identity. Group wrappers pass client arguments through
213
+ untouched because group reads and writes authenticate membership solely through
214
+ the supplied zero-knowledge presentation.
215
+
216
+ `sendUnidentified` and `sendMultiRecipientUnidentified` are the deliberate
217
+ exception: those sealed-sender paths do **not** call `identify`. They authorize
218
+ the bearer request with the target's unidentified-access key or verified group
219
+ send material, preserving delivery without an authenticated application
220
+ session. Rejections are structured `ConvexError` data, and the relay adapter
221
+ decides whether to fall back to identified delivery by reading
222
+ `data.code === 'UNAUTHORIZED'` — not by matching on the message text. A
223
+ deployment that wraps or re-throws component rejections must preserve `code`,
224
+ or a sealed send that should have retried on the identified path will surface
225
+ as a hard failure instead.
226
+
227
+ A recipient's unidentified-access key is registered as a side effect of the
228
+ zero-knowledge profile-key credential flow
229
+ (`issueProfileKeyCredentialMutation`). Until a recipient has completed that
230
+ flow, access-key-authorized sealed sends to them are rejected and the client
231
+ falls back to identified delivery — messages still arrive, but without sender
232
+ anonymity. Deployments that want sealed sender for 1:1 messaging must drive
233
+ the profile-key credential flow during account setup, not lazily.
234
+
235
+ `identify` must return the authenticated account's real ACI, and its real PNI
236
+ or **no PNI at all**, plus the application-owned `userId` used for relay
237
+ routing. Never substitute a shared placeholder value for accounts without a
238
+ PNI: credentials are matched by ACI-or-PNI alias, so a constant PNI issued to
239
+ every account would let any authenticated user act on any PNI-addressed pending
240
+ membership. An absent PNI must be absent.
241
+
242
+ ## Retention and rate limiting
243
+
244
+ Component-owned interval jobs delete expired seven-day messages hourly,
245
+ expired seven-day retry requests hourly, expired provisioning sessions every
246
+ minute, and stale KEM prekeys daily. Cleanup mutations delete bounded batches
247
+ and schedule immediate continuations until the indexed range is empty.
248
+
249
+ Completing a provisioning session grants the acknowledgment its own full
250
+ session TTL. A link that is never acknowledged within that window is rolled
251
+ back by the cron: the device it created is deleted together with all of its
252
+ key material, queued messages, and heartbeats. Teardown matches the device's
253
+ `linkedAt` stamp recorded at completion, so a device legitimately
254
+ re-registered into a freed slot is never reaped by a stale session.
255
+
256
+ Prekey-bundle fetches use the mounted `@convex-dev/rate-limiter` child
257
+ component. Each authenticated fetcher/target-account pair receives ten fetches
258
+ per fixed one-minute window. The eleventh request fails with structured
259
+ `RATE_LIMITED` data and HTTP-equivalent status 429.
260
+
261
+ ## Upgrading: clear `messages` before deploying this version
262
+
263
+ This version drops two shapes from the `messages` table: the optional
264
+ `groupId` field, and `plaintext_content` from the `messageType` union.
265
+
266
+ Convex validates every existing document against the new schema **during the
267
+ push**, before any of your code runs. A stored row carrying a `groupId`, or
268
+ one whose `messageType` is `plaintext_content`, therefore fails the deploy —
269
+ and no migration mutation can fix it, because the deploy that would ship the
270
+ mutation is the deploy that fails. The order has to be: clear first, deploy
271
+ second.
272
+
273
+ Messages are transient by design. The table has a seven-day TTL and an hourly
274
+ cleanup cron, and undelivered messages are re-requested by clients through the
275
+ retry path, so clearing it is a normal operation rather than data loss.
276
+
277
+ Check whether the deployment has anything to clear — still on the previous
278
+ version, since the table lives inside the component rather than the app:
279
+
280
+ ```sh
281
+ npx convex data messages --component signalProtocol
282
+ ```
283
+
284
+ Add `--prod` or `--deployment <name-or-reference>` to target a deployment other
285
+ than your dev one. A deployment that has never relayed a group message and
286
+ never had a caller pass `plaintext_content` has no affected rows and needs no
287
+ action — no send path in this SDK ever produced the latter.
288
+
289
+ If there are rows, either wait or clear:
290
+
291
+ - **Wait.** Stop sending, and the hourly cleanup cron drains the table as the
292
+ seven-day retention window expires. No manual step, but it takes a week.
293
+ - **Clear.** In the Convex dashboard, select the `signalProtocol` component,
294
+ open the `messages` table, and clear it. Undelivered messages are lost;
295
+ clients re-request them over the retry path.
296
+
297
+ Deploy once the table is empty.
298
+
299
+ ## Secret initialization and pinned trust root
300
+
301
+ From the Convex app directory, run:
302
+
303
+ ```sh
304
+ npx oe-groups trust-root
305
+ ```
306
+
307
+ Add `--prod` for the default production deployment or
308
+ `--deployment <name-or-reference>` for another deployment. The command checks
309
+ `OE_GROUPS_SERVER_SECRET`, generates a cryptographically random 32-byte seed
310
+ only when it is absent, writes it to the selected Convex deployment through
311
+ stdin, and prints two labelled base64 roots — the serialized group trust root
312
+ and the Ed25519 sender-certificate root. Pin both in the client build; see
313
+ [Sender certificate trust root](#sender-certificate-trust-root) for where each
314
+ one goes. Never fetch and trust either at runtime.
315
+
316
+ The seed remains in the Convex environment and deterministically derives all
317
+ four server keypairs. It is never written to a Convex table or log. Back up the
318
+ deployment secret: deleting or replacing it rotates the trust root and strands
319
+ clients pinned to the previous deployment.
320
+
321
+ ## Sender certificate trust root
322
+
323
+ `certificates.issueSenderCertificate` signs sender certificates with an Ed25519
324
+ key pair deterministically derived from the deployment secret, domain-separated
325
+ from the group signing key by distinct KDF labels
326
+ (`open-e2ee:sealed-sender:root:v1` / `:server:v1`). Clients verify inbound
327
+ sealed-sender certificates against the matching Ed25519 **root** public key.
328
+
329
+ `oe-groups trust-root` prints both roots, labelled:
330
+
331
+ ```
332
+ group trust root: <base64>
333
+ sealed sender trust root: <base64>
334
+ ```
335
+
336
+ They are pinned in different places and are not interchangeable — the group
337
+ trust root goes into the group configuration, and the sealed-sender root into
338
+ `sealedSender.trustRoots` in the client build. Pin both at build time; never
339
+ fetch either from a relay at runtime, since a relay that chooses the root it is
340
+ validated against can mint certificates for any sender.
341
+
342
+ Both are derived from the same deployment secret, so rotating
343
+ `OE_GROUPS_SERVER_SECRET` rotates both and strands clients pinned to either
344
+ previous value.
345
+
346
+ With `trustRoots` left empty, inbound sealed-sender validation stays disabled
347
+ and sends fall back to identified delivery — messages still arrive, but the
348
+ sender is disclosed to the relay.
349
+
350
+ ## Group metadata privacy
351
+
352
+ The relay cannot read message contents, cannot derive membership from group
353
+ state, and no longer sees a group identifier on the two channels that used to
354
+ carry one.
355
+
356
+ **Closed: the distribution identifier in the frame.** The identified send path
357
+ stores the framed `SenderKeyMessage` as its `ciphertext`, and that frame's
358
+ `distributionUuid` is **not** encrypted. It used to embed
359
+ `groupId:senderUserId:senderDeviceId:timestamp`, so the group and the sender's
360
+ device were readable straight out of the ciphertext column — and, worse than a
361
+ column, off every message in flight to any relay on the path. Sealed sender did
362
+ not help: it hides the frame from the relay but not from the rest of the path,
363
+ and it is disabled until the trust root is exported (see above), so group
364
+ traffic takes the identified path anyway. Distribution identifiers are now
365
+ opaque random UUIDs carrying no group, sender, device, or clock, as the
366
+ reference implementation uses, as the sender-keys specification now requires.
367
+
368
+ **Closed: the `groupId` column.** Every `messages` row used to store a plaintext
369
+ `groupId` next to `targetUserId` for the seven-day retention window. The column
370
+ is gone. What replaces it is a `sender_key` message type, which tells the
371
+ receiver to decrypt the payload as a framed `SenderKeyMessage` and nothing more:
372
+ the receiver reads the opaque distribution identifier out of the frame and
373
+ resolves the group against its own sender key store. No group identifier
374
+ travels on an envelope, sealed or not.
375
+
376
+ **Open: the group partition itself.** Removing the identifier removed the
377
+ group's *name*, not the ability to group rows. Be precise about what is left,
378
+ because the difference matters and it is easy to overstate:
379
+
380
+ - The frame's `distributionUuid` is unencrypted and is stored verbatim inside
381
+ `messages.ciphertext` — the paragraph above says as much. It is opaque, but
382
+ it is stable for the life of a sender key, and nothing rotates keys on a
383
+ timer. Grouping rows by it recovers the recipient set for a sender's group
384
+ traffic.
385
+ - Sender keys encrypt once and fan out, so every recipient row of one send
386
+ carries a byte-identical `ciphertext`. Grouping by that recovers the
387
+ recipient set of a single send, which is sharper than the old column.
388
+ - The fan-out stamps one `timestamp` across every recipient row, and passes
389
+ through one `clientMessageId` when the application supplies one.
390
+ - `sendMultiRecipientUnidentified` hands the relay the roster explicitly, in
391
+ one call — the sealed-sender path names the recipient set outright.
392
+
393
+ So the relay cannot learn *which* group, or its name, membership list, or
394
+ attributes — but it can still partition delivery pairs into unlabeled groups,
395
+ and any one of those channels suffices. That is a real improvement on a
396
+ plaintext `groupId`, which handed over a stable, meaningful, cross-send label;
397
+ it is not anonymity of the partition. The `sender_key` type is also a
398
+ single-column filter isolating group traffic from pairwise traffic, which the
399
+ old design did not offer — group messages used to hide among `ciphertext` rows.
400
+
401
+ **Still visible.** Delivery metadata itself: who sent to whom, when, and how
402
+ much. Every relay sees this. Sealed sender removes the sender from the
403
+ identified half of it.
404
+
405
+ ## Authorization is account-scoped, not device-scoped
406
+
407
+ `identify` maps an authenticated session to an account (`userId`), with no
408
+ device. Every account-scoped endpoint therefore authorizes at account
409
+ granularity, and the `deviceId` arguments are routing selectors chosen by the
410
+ caller rather than authenticated claims. Concretely, any session for an account
411
+ can read and delete **any** of that account's device queues
412
+ (`getPendingMessages`, `markDelivered`), send as any of its device IDs
413
+ (`send.senderDeviceId`), and upload or rotate key material for any of its
414
+ devices (`keys`).
415
+
416
+ This is the intended model — a compromised session already holds the account —
417
+ but it means the component provides no isolation *between* an account's own
418
+ devices. Deployments that need device isolation must issue device-scoped
419
+ sessions and enforce the binding in their own `identify` wrapper; the component
420
+ cannot do it while its identity has no device field.
421
+
422
+ ## Profile-key issuance threat model
423
+
424
+ `issueProfileKeyCredentialMutation` receives the raw 32-byte profile key. The
425
+ group server therefore sees the plaintext profile key at issuance time. The
426
+ credential proof hides it in later group presentations, but issuance in this
427
+ credential layer is not blinded. Blinded issuance is a future credential-layer
428
+ candidate and is explicitly outside this component's scope.
@@ -94,6 +94,7 @@ async function printTrustRoot(args) {
94
94
  const [
95
95
  { generateServerSecretParams, getServerPublicParams },
96
96
  { encodeGroupTrustRoot },
97
+ { deriveSealedSenderRootPublicKey },
97
98
  ] = await Promise.all([
98
99
  // pathToFileURL: dynamic import of a bare absolute path fails on
99
100
  // Windows, where the ESM loader requires a file:// URL.
@@ -113,6 +114,14 @@ async function printTrustRoot(args) {
113
114
  )
114
115
  ).href
115
116
  ),
117
+ import(
118
+ pathToFileURL(
119
+ path.join(
120
+ scriptDirectory,
121
+ '../dist/internal/protocol/sealed-sender/trust-root.js'
122
+ )
123
+ ).href
124
+ ),
116
125
  ]);
117
126
  const secretParams = generateServerSecretParams(seed);
118
127
  seed.fill(0);
@@ -124,7 +133,18 @@ async function printTrustRoot(args) {
124
133
  publicParams.profileKeyCredentialPublicKey,
125
134
  endorsementRootPublicKey: publicParams.endorsementPublicKey,
126
135
  });
127
- process.stdout.write(`${Buffer.from(trustRoot).toString('base64')}\n`);
136
+ const sealedSenderRoot = await deriveSealedSenderRootPublicKey(
137
+ secretParams.signingKeyPair.signingKey
138
+ );
139
+
140
+ // Two independently pinned roots, printed with labels because they go to
141
+ // different places in the client build and are not interchangeable.
142
+ process.stdout.write(
143
+ `group trust root: ${Buffer.from(trustRoot).toString('base64')}\n`
144
+ );
145
+ process.stdout.write(
146
+ `sealed sender trust root: ${Buffer.from(sealedSenderRoot).toString('base64')}\n`
147
+ );
128
148
  }
129
149
 
130
150
  const [command, ...args] = process.argv.slice(2);
@@ -1,2 +0,0 @@
1
- export { CONVEX_GROUP_SERVER_SECRET_ENV_VAR, convexGroupServerTables, defineConvexGroupServer, type ConvexGroupServerIdentity, type DefineConvexGroupServerConfig, } from '../server.js';
2
- //# sourceMappingURL=index.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../remote/relay/convex/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kCAAkC,EAClC,uBAAuB,EACvB,uBAAuB,EACvB,KAAK,yBAAyB,EAC9B,KAAK,6BAA6B,GACnC,MAAM,WAAW,CAAC"}
@@ -1,2 +0,0 @@
1
- export { CONVEX_GROUP_SERVER_SECRET_ENV_VAR, convexGroupServerTables, defineConvexGroupServer, } from '../server.js';
2
- //# sourceMappingURL=index.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../remote/relay/convex/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kCAAkC,EAClC,uBAAuB,EACvB,uBAAuB,GAGxB,MAAM,WAAW,CAAC"}