@open-e2ee/signal-protocol-sdk 0.2.3 → 0.3.0

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 (601) hide show
  1. package/ADAPTERS.md +4 -4
  2. package/ARCHITECTURE.md +17 -16
  3. package/CHANGELOG.md +39 -0
  4. package/COMMERCIAL.md +6 -6
  5. package/NOTICE +1 -1
  6. package/README.md +44 -34
  7. package/SECURITY.md +16 -13
  8. package/TROUBLESHOOTING.md +5 -5
  9. package/blocking/README.md +6 -5
  10. package/client/README.md +5 -5
  11. package/device/README.md +8 -8
  12. package/dist/blocking/types.d.ts +2 -2
  13. package/dist/blocking/types.js +2 -2
  14. package/dist/client/client.d.ts +46 -45
  15. package/dist/client/client.d.ts.map +1 -1
  16. package/dist/client/client.js +61 -60
  17. package/dist/client/client.js.map +1 -1
  18. package/dist/client/config.d.ts +32 -32
  19. package/dist/client/constants.d.ts +7 -6
  20. package/dist/client/constants.d.ts.map +1 -1
  21. package/dist/client/constants.js +5 -4
  22. package/dist/client/constants.js.map +1 -1
  23. package/dist/client/dual-store.d.ts +2 -2
  24. package/dist/client/dual-store.js +2 -2
  25. package/dist/client/endorsement-manager.d.ts +14 -14
  26. package/dist/client/endorsement-manager.d.ts.map +1 -1
  27. package/dist/client/endorsement-manager.js +15 -15
  28. package/dist/client/endorsement-manager.js.map +1 -1
  29. package/dist/client/event-hooks.d.ts +16 -16
  30. package/dist/client/event-hooks.d.ts.map +1 -1
  31. package/dist/client/event-hooks.js +1 -1
  32. package/dist/client/event-hooks.js.map +1 -1
  33. package/dist/client/files.js +4 -4
  34. package/dist/client/files.js.map +1 -1
  35. package/dist/client/headless.d.ts +7 -7
  36. package/dist/client/headless.d.ts.map +1 -1
  37. package/dist/client/headless.js +4 -4
  38. package/dist/client/key-rotation-core.d.ts +19 -17
  39. package/dist/client/key-rotation-core.d.ts.map +1 -1
  40. package/dist/client/key-rotation-core.js +35 -31
  41. package/dist/client/key-rotation-core.js.map +1 -1
  42. package/dist/client/key-rotation.d.ts +8 -8
  43. package/dist/client/key-rotation.js +8 -8
  44. package/dist/client/media.d.ts +1 -1
  45. package/dist/client/messages.d.ts.map +1 -1
  46. package/dist/client/messages.js +13 -11
  47. package/dist/client/messages.js.map +1 -1
  48. package/dist/client/multi-device.d.ts +5 -4
  49. package/dist/client/multi-device.d.ts.map +1 -1
  50. package/dist/client/multi-device.js.map +1 -1
  51. package/dist/client/prekeys.d.ts +7 -7
  52. package/dist/client/prekeys.js +10 -10
  53. package/dist/client/prekeys.js.map +1 -1
  54. package/dist/client/relay-subscription.d.ts +3 -0
  55. package/dist/client/relay-subscription.d.ts.map +1 -1
  56. package/dist/client/relay-subscription.js +7 -4
  57. package/dist/client/relay-subscription.js.map +1 -1
  58. package/dist/client/retry-utils.d.ts +5 -6
  59. package/dist/client/retry-utils.d.ts.map +1 -1
  60. package/dist/client/retry-utils.js +5 -12
  61. package/dist/client/retry-utils.js.map +1 -1
  62. package/dist/client/retry.js +7 -7
  63. package/dist/client/retry.js.map +1 -1
  64. package/dist/client/sealed-sender-ops.d.ts +3 -3
  65. package/dist/client/sealed-sender-ops.js +5 -5
  66. package/dist/client/sealed-sender-ops.js.map +1 -1
  67. package/dist/client/sessions.d.ts +2 -2
  68. package/dist/client/sessions.js +2 -2
  69. package/dist/client/signal-service-cipher.d.ts +9 -9
  70. package/dist/client/signal-service-cipher.d.ts.map +1 -1
  71. package/dist/client/signal-service-cipher.js +41 -40
  72. package/dist/client/signal-service-cipher.js.map +1 -1
  73. package/dist/client/state.d.ts +1 -1
  74. package/dist/client/state.js +1 -1
  75. package/dist/client/types.d.ts +19 -19
  76. package/dist/client/types.d.ts.map +1 -1
  77. package/dist/device/connection.d.ts +1 -1
  78. package/dist/device/connection.js +2 -2
  79. package/dist/device/connection.js.map +1 -1
  80. package/dist/device/constants.d.ts +4 -4
  81. package/dist/device/constants.js +3 -3
  82. package/dist/device/device-id.d.ts +4 -4
  83. package/dist/device/device-id.js +4 -4
  84. package/dist/device/expo-metadata.d.ts +13 -11
  85. package/dist/device/expo-metadata.d.ts.map +1 -1
  86. package/dist/device/expo-metadata.js +13 -11
  87. package/dist/device/expo-metadata.js.map +1 -1
  88. package/dist/device/lifecycle/manager.d.ts +6 -6
  89. package/dist/device/lifecycle/manager.js +7 -7
  90. package/dist/device/lifecycle/types.d.ts +13 -13
  91. package/dist/device/lifecycle/types.d.ts.map +1 -1
  92. package/dist/device/lifecycle/utils.d.ts +2 -2
  93. package/dist/device/lifecycle/utils.js +5 -5
  94. package/dist/device/lifecycle/utils.js.map +1 -1
  95. package/dist/device/provisioning.d.ts +5 -4
  96. package/dist/device/provisioning.d.ts.map +1 -1
  97. package/dist/device/provisioning.js +5 -4
  98. package/dist/device/provisioning.js.map +1 -1
  99. package/dist/device/transfer.d.ts +2 -2
  100. package/dist/device/transfer.js +3 -3
  101. package/dist/device/transfer.js.map +1 -1
  102. package/dist/encoding/index.d.ts +3 -4
  103. package/dist/encoding/index.d.ts.map +1 -1
  104. package/dist/encoding/index.js.map +1 -1
  105. package/dist/files/index.d.ts +1 -1
  106. package/dist/files/index.js +1 -1
  107. package/dist/hooks/use-connection-presence.d.ts +1 -1
  108. package/dist/hooks/use-connection-presence.js +7 -7
  109. package/dist/hooks/use-connection-presence.js.map +1 -1
  110. package/dist/hooks/use-group-membership.d.ts +2 -2
  111. package/dist/hooks/use-group-membership.d.ts.map +1 -1
  112. package/dist/hooks/use-group-membership.js +6 -6
  113. package/dist/hooks/use-group-membership.js.map +1 -1
  114. package/dist/hooks/use-key-rotation.js +3 -3
  115. package/dist/hooks/use-key-rotation.js.map +1 -1
  116. package/dist/hooks/use-single-flight.d.ts +2 -2
  117. package/dist/hooks/use-single-flight.js +1 -1
  118. package/dist/index.d.ts +4 -3
  119. package/dist/index.d.ts.map +1 -1
  120. package/dist/index.js +22 -4
  121. package/dist/index.js.map +1 -1
  122. package/dist/internal/crypto/ec/ed25519.d.ts +6 -6
  123. package/dist/internal/crypto/ec/ed25519.js +6 -6
  124. package/dist/internal/crypto/ec/x25519-validation.d.ts.map +1 -1
  125. package/dist/internal/crypto/ec/x25519-validation.js +4 -2
  126. package/dist/internal/crypto/ec/x25519-validation.js.map +1 -1
  127. package/dist/internal/crypto/index.d.ts +2 -0
  128. package/dist/internal/crypto/index.d.ts.map +1 -1
  129. package/dist/internal/crypto/index.js +2 -0
  130. package/dist/internal/crypto/index.js.map +1 -1
  131. package/dist/internal/crypto/kdf/hkdf.d.ts +9 -8
  132. package/dist/internal/crypto/kdf/hkdf.d.ts.map +1 -1
  133. package/dist/internal/crypto/kdf/hkdf.js +11 -10
  134. package/dist/internal/crypto/kdf/hkdf.js.map +1 -1
  135. package/dist/internal/crypto/key-prefix.d.ts +3 -3
  136. package/dist/internal/crypto/key-prefix.js +3 -3
  137. package/dist/internal/crypto/pq/kyber.d.ts +7 -7
  138. package/dist/internal/crypto/pq/kyber.js +10 -10
  139. package/dist/internal/crypto/pq/kyber.js.map +1 -1
  140. package/dist/internal/crypto/random.d.ts +1 -1
  141. package/dist/internal/crypto/random.js +1 -1
  142. package/dist/internal/crypto/symmetric/aes-gcm-siv.js +1 -1
  143. package/dist/internal/crypto/symmetric/aes.js +4 -4
  144. package/dist/internal/crypto/symmetric/aes.js.map +1 -1
  145. package/dist/internal/crypto/symmetric/mac.d.ts +1 -1
  146. package/dist/internal/crypto/symmetric/mac.js +3 -3
  147. package/dist/internal/crypto/symmetric/padding.js +1 -1
  148. package/dist/internal/crypto/symmetric/padding.js.map +1 -1
  149. package/dist/internal/crypto/symmetric/streaming-aead.d.ts +7 -1
  150. package/dist/internal/crypto/symmetric/streaming-aead.d.ts.map +1 -1
  151. package/dist/internal/crypto/symmetric/streaming-aead.js +10 -4
  152. package/dist/internal/crypto/symmetric/streaming-aead.js.map +1 -1
  153. package/dist/internal/crypto/utils.d.ts +2 -2
  154. package/dist/internal/crypto/utils.d.ts.map +1 -1
  155. package/dist/internal/crypto/utils.js +16 -14
  156. package/dist/internal/crypto/utils.js.map +1 -1
  157. package/dist/internal/crypto/validation.d.ts +4 -4
  158. package/dist/internal/crypto/validation.js +2 -2
  159. package/dist/internal/encoding/proto/envelope.d.ts +1 -1
  160. package/dist/internal/encoding/proto/envelope.js +1 -1
  161. package/dist/internal/encoding/proto/index.d.ts +4 -4
  162. package/dist/internal/encoding/proto/index.js +4 -4
  163. package/dist/internal/encoding/proto/pq-ratchet-serialize.d.ts +28 -16
  164. package/dist/internal/encoding/proto/pq-ratchet-serialize.d.ts.map +1 -1
  165. package/dist/internal/encoding/proto/pq-ratchet-serialize.js +30 -18
  166. package/dist/internal/encoding/proto/pq-ratchet-serialize.js.map +1 -1
  167. package/dist/internal/encoding/proto/primitives.d.ts +45 -35
  168. package/dist/internal/encoding/proto/primitives.d.ts.map +1 -1
  169. package/dist/internal/encoding/proto/primitives.js +54 -43
  170. package/dist/internal/encoding/proto/primitives.js.map +1 -1
  171. package/dist/internal/encoding/proto/sender-key-message.d.ts +2 -2
  172. package/dist/internal/encoding/proto/sender-key-message.js +2 -2
  173. package/dist/internal/encoding/proto/signal-message.d.ts +13 -13
  174. package/dist/internal/encoding/proto/signal-message.d.ts.map +1 -1
  175. package/dist/internal/encoding/proto/signal-message.js +13 -13
  176. package/dist/internal/encoding/proto/signal-message.js.map +1 -1
  177. package/dist/internal/groups/access-control.d.ts +5 -5
  178. package/dist/internal/groups/access-control.js +6 -6
  179. package/dist/internal/groups/access-control.js.map +1 -1
  180. package/dist/internal/groups/change-actions.d.ts +4 -4
  181. package/dist/internal/groups/change-actions.js +3 -3
  182. package/dist/internal/groups/encrypted-state.js +1 -1
  183. package/dist/internal/groups/encrypted-state.js.map +1 -1
  184. package/dist/internal/groups/group-id.d.ts +1 -1
  185. package/dist/internal/groups/manager.d.ts +24 -23
  186. package/dist/internal/groups/manager.d.ts.map +1 -1
  187. package/dist/internal/groups/manager.js +40 -36
  188. package/dist/internal/groups/manager.js.map +1 -1
  189. package/dist/internal/groups/server-engine.d.ts +29 -21
  190. package/dist/internal/groups/server-engine.d.ts.map +1 -1
  191. package/dist/internal/groups/server-engine.js +55 -50
  192. package/dist/internal/groups/server-engine.js.map +1 -1
  193. package/dist/internal/groups/trust-root.d.ts +2 -2
  194. package/dist/internal/groups/trust-root.js +2 -2
  195. package/dist/internal/groups/types.d.ts +4 -4
  196. package/dist/internal/groups/types.d.ts.map +1 -1
  197. package/dist/internal/groups/wire.d.ts +6 -7
  198. package/dist/internal/groups/wire.d.ts.map +1 -1
  199. package/dist/internal/groups/wire.js +6 -7
  200. package/dist/internal/groups/wire.js.map +1 -1
  201. package/dist/internal/manager/manager.d.ts +14 -12
  202. package/dist/internal/manager/manager.d.ts.map +1 -1
  203. package/dist/internal/manager/manager.js +47 -41
  204. package/dist/internal/manager/manager.js.map +1 -1
  205. package/dist/internal/protocol/double-ratchet/chains.d.ts +8 -6
  206. package/dist/internal/protocol/double-ratchet/chains.d.ts.map +1 -1
  207. package/dist/internal/protocol/double-ratchet/chains.js +10 -8
  208. package/dist/internal/protocol/double-ratchet/chains.js.map +1 -1
  209. package/dist/internal/protocol/double-ratchet/index.d.ts +2 -2
  210. package/dist/internal/protocol/double-ratchet/index.js +2 -2
  211. package/dist/internal/protocol/double-ratchet/ratchet.d.ts +4 -4
  212. package/dist/internal/protocol/double-ratchet/ratchet.js +6 -6
  213. package/dist/internal/protocol/pqxdh/pqxdh.d.ts +21 -18
  214. package/dist/internal/protocol/pqxdh/pqxdh.d.ts.map +1 -1
  215. package/dist/internal/protocol/pqxdh/pqxdh.js +48 -42
  216. package/dist/internal/protocol/pqxdh/pqxdh.js.map +1 -1
  217. package/dist/internal/protocol/sealed-sender/decryption-v2.js +5 -5
  218. package/dist/internal/protocol/sealed-sender/decryption-v2.js.map +1 -1
  219. package/dist/internal/protocol/sealed-sender/decryption.d.ts.map +1 -1
  220. package/dist/internal/protocol/sealed-sender/decryption.js +11 -8
  221. package/dist/internal/protocol/sealed-sender/decryption.js.map +1 -1
  222. package/dist/internal/protocol/sealed-sender/delivery-token.d.ts +2 -2
  223. package/dist/internal/protocol/sealed-sender/delivery-token.js +2 -2
  224. package/dist/internal/protocol/sealed-sender/encryption-v2.js +1 -1
  225. package/dist/internal/protocol/sealed-sender/encryption-v2.js.map +1 -1
  226. package/dist/internal/protocol/sealed-sender/encryption.d.ts +2 -2
  227. package/dist/internal/protocol/sealed-sender/encryption.js +2 -2
  228. package/dist/internal/protocol/sealed-sender/proto/index.d.ts +25 -23
  229. package/dist/internal/protocol/sealed-sender/proto/index.d.ts.map +1 -1
  230. package/dist/internal/protocol/sealed-sender/proto/index.js +32 -30
  231. package/dist/internal/protocol/sealed-sender/proto/index.js.map +1 -1
  232. package/dist/internal/protocol/sealed-sender/trust-root.d.ts +10 -9
  233. package/dist/internal/protocol/sealed-sender/trust-root.d.ts.map +1 -1
  234. package/dist/internal/protocol/sealed-sender/trust-root.js +10 -9
  235. package/dist/internal/protocol/sealed-sender/trust-root.js.map +1 -1
  236. package/dist/internal/protocol/sealed-sender/types.d.ts +13 -14
  237. package/dist/internal/protocol/sealed-sender/types.d.ts.map +1 -1
  238. package/dist/internal/protocol/sealed-sender/types.js +7 -8
  239. package/dist/internal/protocol/sealed-sender/types.js.map +1 -1
  240. package/dist/internal/protocol/sealed-sender/v2-binary.d.ts +1 -1
  241. package/dist/internal/protocol/sealed-sender/v2-binary.js +2 -2
  242. package/dist/internal/protocol/sealed-sender/v2-binary.js.map +1 -1
  243. package/dist/internal/protocol/sender-keys/manager.d.ts +16 -14
  244. package/dist/internal/protocol/sender-keys/manager.d.ts.map +1 -1
  245. package/dist/internal/protocol/sender-keys/manager.js +37 -34
  246. package/dist/internal/protocol/sender-keys/manager.js.map +1 -1
  247. package/dist/internal/protocol/spqr/braid-serialize.d.ts +6 -6
  248. package/dist/internal/protocol/spqr/braid-serialize.js +5 -5
  249. package/dist/internal/protocol/spqr/braid-serialize.js.map +1 -1
  250. package/dist/internal/protocol/spqr/braid.d.ts +3 -3
  251. package/dist/internal/protocol/spqr/braid.js +7 -7
  252. package/dist/internal/protocol/spqr/braid.js.map +1 -1
  253. package/dist/internal/protocol/spqr/index.js +1 -1
  254. package/dist/internal/protocol/spqr/index.js.map +1 -1
  255. package/dist/internal/protocol/spqr/ml-kem-braid/chunk-domain.d.ts +3 -3
  256. package/dist/internal/protocol/spqr/ml-kem-braid/chunk-domain.js +3 -3
  257. package/dist/internal/protocol/spqr/ml-kem-braid/incremental-kem.js +1 -1
  258. package/dist/internal/protocol/spqr/ml-kem-braid/incremental-kem.js.map +1 -1
  259. package/dist/internal/protocol/spqr/ml-kem-braid/kdf.d.ts +1 -1
  260. package/dist/internal/protocol/spqr/ml-kem-braid/kdf.js +1 -1
  261. package/dist/internal/protocol/spqr/ml-kem-braid/kdf.js.map +1 -1
  262. package/dist/internal/protocol/spqr/ml-kem-braid/noble-pq/arithmetic.d.ts +4 -3
  263. package/dist/internal/protocol/spqr/ml-kem-braid/noble-pq/arithmetic.d.ts.map +1 -1
  264. package/dist/internal/protocol/spqr/ml-kem-braid/noble-pq/arithmetic.js +4 -3
  265. package/dist/internal/protocol/spqr/ml-kem-braid/noble-pq/arithmetic.js.map +1 -1
  266. package/dist/internal/protocol/spqr/ml-kem-braid/noble-pq/index.js +2 -2
  267. package/dist/internal/protocol/spqr/ml-kem-braid/progress.d.ts +1 -1
  268. package/dist/internal/protocol/spqr/ml-kem-braid/progress.js +1 -1
  269. package/dist/internal/protocol/spqr/ml-kem-braid/rs/codec.d.ts +15 -7
  270. package/dist/internal/protocol/spqr/ml-kem-braid/rs/codec.d.ts.map +1 -1
  271. package/dist/internal/protocol/spqr/ml-kem-braid/rs/codec.js +15 -7
  272. package/dist/internal/protocol/spqr/ml-kem-braid/rs/codec.js.map +1 -1
  273. package/dist/internal/protocol/spqr/ml-kem-braid/rs/galois/field.js +1 -1
  274. package/dist/internal/protocol/spqr/ml-kem-braid/rs/polynomial.d.ts +3 -3
  275. package/dist/internal/protocol/spqr/ml-kem-braid/rs/polynomial.js +1 -1
  276. package/dist/internal/protocol/spqr/ml-kem-braid/serialize.d.ts +7 -7
  277. package/dist/internal/protocol/spqr/ml-kem-braid/serialize.js +11 -11
  278. package/dist/internal/protocol/spqr/ml-kem-braid/serialize.js.map +1 -1
  279. package/dist/internal/protocol/spqr/ml-kem-braid/state-machine.d.ts +1 -1
  280. package/dist/internal/protocol/spqr/ml-kem-braid/state-machine.js +6 -6
  281. package/dist/internal/protocol/spqr/ml-kem-braid/state-machine.js.map +1 -1
  282. package/dist/internal/protocol/spqr/ml-kem-braid/types.d.ts +2 -2
  283. package/dist/internal/protocol/spqr/ml-kem-braid/types.d.ts.map +1 -1
  284. package/dist/internal/protocol/spqr/ml-kem-braid/types.js.map +1 -1
  285. package/dist/internal/protocol/spqr/serialize.d.ts +12 -12
  286. package/dist/internal/protocol/spqr/serialize.js +5 -5
  287. package/dist/internal/protocol/spqr/spqr.d.ts +6 -6
  288. package/dist/internal/protocol/spqr/spqr.d.ts.map +1 -1
  289. package/dist/internal/protocol/spqr/spqr.js +47 -42
  290. package/dist/internal/protocol/spqr/spqr.js.map +1 -1
  291. package/dist/internal/protocol/spqr/validate.d.ts +1 -1
  292. package/dist/internal/protocol/triple-ratchet/ratchet.d.ts +12 -12
  293. package/dist/internal/protocol/triple-ratchet/ratchet.d.ts.map +1 -1
  294. package/dist/internal/protocol/triple-ratchet/ratchet.js +11 -11
  295. package/dist/internal/protocol/triple-ratchet/ratchet.js.map +1 -1
  296. package/dist/internal/protocol/username/hash.d.ts.map +1 -1
  297. package/dist/internal/protocol/username/hash.js +6 -4
  298. package/dist/internal/protocol/username/hash.js.map +1 -1
  299. package/dist/internal/protocol/version.d.ts +3 -3
  300. package/dist/internal/protocol/version.js +1 -1
  301. package/dist/internal/protocol/x3dh/x3dh.d.ts +16 -16
  302. package/dist/internal/protocol/x3dh/x3dh.d.ts.map +1 -1
  303. package/dist/internal/protocol/x3dh/x3dh.js +15 -15
  304. package/dist/internal/protocol/x3dh/x3dh.js.map +1 -1
  305. package/dist/internal/protocol/zk/credentials/attributes.d.ts +7 -7
  306. package/dist/internal/protocol/zk/credentials/attributes.js +7 -7
  307. package/dist/internal/protocol/zk/credentials/credentials.d.ts +1 -1
  308. package/dist/internal/protocol/zk/credentials/credentials.js +1 -1
  309. package/dist/internal/protocol/zk/credentials/endorsements.d.ts +11 -11
  310. package/dist/internal/protocol/zk/credentials/endorsements.js +14 -14
  311. package/dist/internal/protocol/zk/credentials/issuance.d.ts +5 -1
  312. package/dist/internal/protocol/zk/credentials/issuance.d.ts.map +1 -1
  313. package/dist/internal/protocol/zk/credentials/issuance.js +5 -1
  314. package/dist/internal/protocol/zk/credentials/issuance.js.map +1 -1
  315. package/dist/internal/protocol/zk/credentials/presentation.d.ts +16 -16
  316. package/dist/internal/protocol/zk/credentials/presentation.d.ts.map +1 -1
  317. package/dist/internal/protocol/zk/credentials/presentation.js +18 -18
  318. package/dist/internal/protocol/zk/credentials/presentation.js.map +1 -1
  319. package/dist/internal/protocol/zk/groups/auth-credential.d.ts +22 -16
  320. package/dist/internal/protocol/zk/groups/auth-credential.d.ts.map +1 -1
  321. package/dist/internal/protocol/zk/groups/auth-credential.js +19 -14
  322. package/dist/internal/protocol/zk/groups/auth-credential.js.map +1 -1
  323. package/dist/internal/protocol/zk/groups/client-zk-group-cipher.d.ts +4 -4
  324. package/dist/internal/protocol/zk/groups/client-zk-group-cipher.js +4 -4
  325. package/dist/internal/protocol/zk/groups/group-params.d.ts +2 -2
  326. package/dist/internal/protocol/zk/groups/group-params.js +2 -2
  327. package/dist/internal/protocol/zk/groups/group-send-endorsement.d.ts +10 -9
  328. package/dist/internal/protocol/zk/groups/group-send-endorsement.d.ts.map +1 -1
  329. package/dist/internal/protocol/zk/groups/group-send-endorsement.js +9 -8
  330. package/dist/internal/protocol/zk/groups/group-send-endorsement.js.map +1 -1
  331. package/dist/internal/protocol/zk/groups/lizard.d.ts +1 -1
  332. package/dist/internal/protocol/zk/groups/lizard.js +4 -4
  333. package/dist/internal/protocol/zk/groups/lizard.js.map +1 -1
  334. package/dist/internal/protocol/zk/groups/profile-key-commitment.d.ts +3 -3
  335. package/dist/internal/protocol/zk/groups/profile-key-commitment.js +3 -3
  336. package/dist/internal/protocol/zk/groups/profile-key-credential.d.ts +11 -11
  337. package/dist/internal/protocol/zk/groups/profile-key-credential.js +7 -7
  338. package/dist/internal/protocol/zk/groups/profile-key-encryption.d.ts +2 -2
  339. package/dist/internal/protocol/zk/groups/profile-key-encryption.js +2 -2
  340. package/dist/internal/protocol/zk/groups/profile-key-struct.d.ts +2 -2
  341. package/dist/internal/protocol/zk/groups/profile-key-struct.js +2 -2
  342. package/dist/internal/protocol/zk/groups/profile-key-version.d.ts +2 -2
  343. package/dist/internal/protocol/zk/groups/profile-key-version.js +2 -2
  344. package/dist/internal/protocol/zk/groups/server-params.d.ts +1 -1
  345. package/dist/internal/protocol/zk/groups/server-params.js +1 -1
  346. package/dist/internal/protocol/zk/groups/uid-encryption.d.ts +4 -4
  347. package/dist/internal/protocol/zk/groups/uid-encryption.js +4 -4
  348. package/dist/internal/protocol/zk/groups/uid-struct.d.ts +2 -2
  349. package/dist/internal/protocol/zk/groups/uid-struct.js +3 -3
  350. package/dist/internal/protocol/zk/groups/uid-struct.js.map +1 -1
  351. package/dist/internal/protocol/zk/proofs/args.d.ts +3 -3
  352. package/dist/internal/protocol/zk/proofs/args.js +3 -3
  353. package/dist/internal/protocol/zk/proofs/sho-sha256.d.ts +3 -3
  354. package/dist/internal/protocol/zk/proofs/sho-sha256.js +3 -3
  355. package/dist/internal/protocol/zk/proofs/sho.d.ts +8 -7
  356. package/dist/internal/protocol/zk/proofs/sho.d.ts.map +1 -1
  357. package/dist/internal/protocol/zk/proofs/sho.js +8 -7
  358. package/dist/internal/protocol/zk/proofs/sho.js.map +1 -1
  359. package/dist/internal/protocol/zk/proofs/statement.d.ts +8 -6
  360. package/dist/internal/protocol/zk/proofs/statement.d.ts.map +1 -1
  361. package/dist/internal/protocol/zk/proofs/statement.js +8 -6
  362. package/dist/internal/protocol/zk/proofs/statement.js.map +1 -1
  363. package/dist/internal/sesame/manager.d.ts +23 -19
  364. package/dist/internal/sesame/manager.d.ts.map +1 -1
  365. package/dist/internal/sesame/manager.js +64 -54
  366. package/dist/internal/sesame/manager.js.map +1 -1
  367. package/dist/internal/sesame/types.d.ts +28 -25
  368. package/dist/internal/sesame/types.d.ts.map +1 -1
  369. package/dist/internal/sesame/types.js +2 -2
  370. package/dist/internal/sesame/types.js.map +1 -1
  371. package/dist/internal/sesame/validation.d.ts +2 -2
  372. package/dist/internal/sesame/validation.js +3 -3
  373. package/dist/internal/sesame/validation.js.map +1 -1
  374. package/dist/internal/session/builder.d.ts +8 -8
  375. package/dist/internal/session/builder.js +22 -22
  376. package/dist/internal/session/builder.js.map +1 -1
  377. package/dist/internal/session/cipher.d.ts +3 -3
  378. package/dist/internal/session/cipher.d.ts.map +1 -1
  379. package/dist/internal/session/cipher.js +51 -40
  380. package/dist/internal/session/cipher.js.map +1 -1
  381. package/dist/internal/session/decryption.js +11 -9
  382. package/dist/internal/session/decryption.js.map +1 -1
  383. package/dist/internal/session/factory.js +1 -1
  384. package/dist/internal/session/factory.js.map +1 -1
  385. package/dist/internal/session/handshake.d.ts +4 -4
  386. package/dist/internal/session/handshake.js +4 -4
  387. package/dist/internal/session/keys.d.ts +3 -4
  388. package/dist/internal/session/keys.d.ts.map +1 -1
  389. package/dist/internal/session/keys.js.map +1 -1
  390. package/dist/internal/session/ratchet.d.ts +8 -8
  391. package/dist/internal/session/ratchet.js +10 -10
  392. package/dist/internal/session/ratchet.js.map +1 -1
  393. package/dist/internal/session/session-resolver.d.ts +6 -6
  394. package/dist/internal/session/session-resolver.js +6 -6
  395. package/dist/internal/session/state.d.ts +12 -12
  396. package/dist/internal/session/state.d.ts.map +1 -1
  397. package/dist/internal/session/state.js +7 -7
  398. package/dist/internal/session/types.d.ts +20 -20
  399. package/dist/internal/session/types.d.ts.map +1 -1
  400. package/dist/internal/session/types.js +3 -3
  401. package/dist/internal/session/validation.d.ts +1 -1
  402. package/dist/internal/session/validation.js +4 -4
  403. package/dist/internal/session/validation.js.map +1 -1
  404. package/dist/keys/branded.d.ts +12 -12
  405. package/dist/keys/branded.js +3 -3
  406. package/dist/keys/generation.d.ts +4 -4
  407. package/dist/keys/generation.js +4 -4
  408. package/dist/keys/identity.d.ts +7 -7
  409. package/dist/keys/identity.d.ts.map +1 -1
  410. package/dist/keys/identity.js +7 -7
  411. package/dist/keys/identity.js.map +1 -1
  412. package/dist/keys/types.d.ts +16 -16
  413. package/dist/keys/types.d.ts.map +1 -1
  414. package/dist/layers.d.ts +1 -1
  415. package/dist/layers.js +1 -1
  416. package/dist/local/store/expo/adapter.d.ts +8 -8
  417. package/dist/local/store/expo/adapter.js +10 -10
  418. package/dist/local/store/expo/adapter.js.map +1 -1
  419. package/dist/local/store/expo/database-key.d.ts +7 -7
  420. package/dist/local/store/expo/database-key.js +7 -7
  421. package/dist/local/store/expo/key-storage.d.ts +1 -1
  422. package/dist/local/store/expo/key-storage.js +4 -4
  423. package/dist/local/store/expo/key-storage.js.map +1 -1
  424. package/dist/local/store/expo/models/kyber-prekey-used.d.ts +6 -6
  425. package/dist/local/store/expo/models/kyber-prekey-used.js +3 -3
  426. package/dist/local/store/expo/models/kyber-prekey.d.ts +1 -1
  427. package/dist/local/store/expo/models/kyber-prekey.js +1 -1
  428. package/dist/local/store/expo/models/message-record.d.ts +2 -2
  429. package/dist/local/store/expo/models/message-record.d.ts.map +1 -1
  430. package/dist/local/store/expo/models/message-record.js +1 -1
  431. package/dist/local/store/expo/models/message-record.js.map +1 -1
  432. package/dist/local/store/expo/models/sender-key.d.ts +11 -10
  433. package/dist/local/store/expo/models/sender-key.d.ts.map +1 -1
  434. package/dist/local/store/expo/models/sender-key.js +11 -10
  435. package/dist/local/store/expo/models/sender-key.js.map +1 -1
  436. package/dist/local/store/expo/schema.d.ts +2 -2
  437. package/dist/local/store/expo/schema.js +2 -2
  438. package/dist/local/store/expo/secure-store-options.d.ts +1 -1
  439. package/dist/local/store/memory/adapter.d.ts +2 -2
  440. package/dist/local/store/memory/adapter.js +12 -12
  441. package/dist/local/store/memory/adapter.js.map +1 -1
  442. package/dist/local/store/node/adapter.d.ts.map +1 -1
  443. package/dist/local/store/node/adapter.js +5 -4
  444. package/dist/local/store/node/adapter.js.map +1 -1
  445. package/dist/local/store/node/database-key.d.ts +8 -8
  446. package/dist/local/store/node/database-key.js +10 -10
  447. package/dist/local/store/node/database-key.js.map +1 -1
  448. package/dist/local/store/node/database.d.ts +5 -5
  449. package/dist/local/store/node/database.js +11 -11
  450. package/dist/local/store/node/database.js.map +1 -1
  451. package/dist/local/store/react-native/adapter.d.ts +6 -6
  452. package/dist/local/store/react-native/adapter.d.ts.map +1 -1
  453. package/dist/local/store/react-native/adapter.js +35 -32
  454. package/dist/local/store/react-native/adapter.js.map +1 -1
  455. package/dist/local/store/react-native/backend-conformance.d.ts +11 -10
  456. package/dist/local/store/react-native/backend-conformance.d.ts.map +1 -1
  457. package/dist/local/store/react-native/backend-conformance.js +13 -12
  458. package/dist/local/store/react-native/backend-conformance.js.map +1 -1
  459. package/dist/local/store/react-native/index.d.ts +1 -1
  460. package/dist/local/store/react-native/reference-backend.d.ts +14 -13
  461. package/dist/local/store/react-native/reference-backend.d.ts.map +1 -1
  462. package/dist/local/store/react-native/reference-backend.js +15 -14
  463. package/dist/local/store/react-native/reference-backend.js.map +1 -1
  464. package/dist/local/store/react-native/storage.d.ts +3 -3
  465. package/dist/local/store/web/adapter.d.ts +3 -3
  466. package/dist/local/store/web/adapter.d.ts.map +1 -1
  467. package/dist/local/store/web/adapter.js +30 -31
  468. package/dist/local/store/web/adapter.js.map +1 -1
  469. package/dist/local/store/web/index.d.ts +1 -1
  470. package/dist/local/vault/index.d.ts +2 -2
  471. package/dist/media/index.d.ts +11 -11
  472. package/dist/media/index.js +9 -9
  473. package/dist/profile/contact-state.d.ts +1 -1
  474. package/dist/profile/contact-state.js +1 -1
  475. package/dist/profile/profile-key.d.ts +2 -2
  476. package/dist/profile/profile-key.js +7 -6
  477. package/dist/profile/profile-key.js.map +1 -1
  478. package/dist/remote/object-store/index.d.ts +1 -1
  479. package/dist/remote/object-store/s3/storage.d.ts +1 -1
  480. package/dist/remote/object-store/types.d.ts +4 -4
  481. package/dist/remote/object-store/types.d.ts.map +1 -1
  482. package/dist/remote/relay/convex/backend.d.ts +4 -4
  483. package/dist/remote/relay/convex/backend.js +3 -3
  484. package/dist/remote/relay/convex/backend.js.map +1 -1
  485. package/dist/remote/relay/convex/component/accounts.d.ts +15 -13
  486. package/dist/remote/relay/convex/component/accounts.d.ts.map +1 -1
  487. package/dist/remote/relay/convex/component/accounts.js +31 -28
  488. package/dist/remote/relay/convex/component/accounts.js.map +1 -1
  489. package/dist/remote/relay/convex/component/certificates.js +1 -1
  490. package/dist/remote/relay/convex/component/cleanup.js +7 -7
  491. package/dist/remote/relay/convex/component/cleanup.js.map +1 -1
  492. package/dist/remote/relay/convex/component/convex.config.d.ts.map +1 -1
  493. package/dist/remote/relay/convex/component/convex.config.js +10 -8
  494. package/dist/remote/relay/convex/component/convex.config.js.map +1 -1
  495. package/dist/remote/relay/convex/component/devices.d.ts +21 -20
  496. package/dist/remote/relay/convex/component/devices.d.ts.map +1 -1
  497. package/dist/remote/relay/convex/component/devices.js +24 -23
  498. package/dist/remote/relay/convex/component/devices.js.map +1 -1
  499. package/dist/remote/relay/convex/component/groups.js +6 -6
  500. package/dist/remote/relay/convex/component/groups.js.map +1 -1
  501. package/dist/remote/relay/convex/component/messages.d.ts.map +1 -1
  502. package/dist/remote/relay/convex/component/messages.js +89 -82
  503. package/dist/remote/relay/convex/component/messages.js.map +1 -1
  504. package/dist/remote/relay/convex/component/provisioning.d.ts +3 -3
  505. package/dist/remote/relay/convex/component/provisioning.d.ts.map +1 -1
  506. package/dist/remote/relay/convex/component/provisioning.js +17 -16
  507. package/dist/remote/relay/convex/component/provisioning.js.map +1 -1
  508. package/dist/remote/relay/convex/component/runtime.d.ts.map +1 -1
  509. package/dist/remote/relay/convex/component/runtime.js +4 -2
  510. package/dist/remote/relay/convex/component/runtime.js.map +1 -1
  511. package/dist/remote/relay/convex/component/schema.js +25 -24
  512. package/dist/remote/relay/convex/component/schema.js.map +1 -1
  513. package/dist/remote/relay/convex/group-server.d.ts +3 -3
  514. package/dist/remote/relay/convex/group-server.js +3 -3
  515. package/dist/remote/relay/convex/relay.d.ts +3 -3
  516. package/dist/remote/relay/convex/relay.d.ts.map +1 -1
  517. package/dist/remote/relay/convex/relay.js +18 -17
  518. package/dist/remote/relay/convex/relay.js.map +1 -1
  519. package/dist/remote/relay/convex/types.d.ts +7 -7
  520. package/dist/remote/relay/convex/types.js +4 -4
  521. package/dist/remote/relay/memory/adapter.js +9 -9
  522. package/dist/remote/relay/memory/adapter.js.map +1 -1
  523. package/dist/remote/relay/types.d.ts +27 -27
  524. package/dist/remote/relay/types.d.ts.map +1 -1
  525. package/dist/safety/fingerprint.d.ts +7 -6
  526. package/dist/safety/fingerprint.d.ts.map +1 -1
  527. package/dist/safety/fingerprint.js +5 -4
  528. package/dist/safety/fingerprint.js.map +1 -1
  529. package/dist/safety/index.d.ts +6 -5
  530. package/dist/safety/index.d.ts.map +1 -1
  531. package/dist/safety/index.js +7 -6
  532. package/dist/safety/index.js.map +1 -1
  533. package/dist/safety/protobuf.js +2 -2
  534. package/dist/safety/protobuf.js.map +1 -1
  535. package/dist/safety/url.d.ts +5 -5
  536. package/dist/safety/url.js +6 -6
  537. package/dist/types/address.d.ts +2 -2
  538. package/dist/types/address.js +2 -2
  539. package/dist/types/api.d.ts +78 -73
  540. package/dist/types/api.d.ts.map +1 -1
  541. package/dist/types/errors.d.ts +63 -403
  542. package/dist/types/errors.d.ts.map +1 -1
  543. package/dist/types/errors.js +62 -537
  544. package/dist/types/errors.js.map +1 -1
  545. package/dist/types/messages.d.ts +16 -16
  546. package/dist/types/messages.d.ts.map +1 -1
  547. package/dist/types/messages.js +7 -7
  548. package/dist/types/messages.js.map +1 -1
  549. package/dist/types/protocol-config.d.ts +52 -49
  550. package/dist/types/protocol-config.d.ts.map +1 -1
  551. package/dist/types/protocol-config.js +36 -34
  552. package/dist/types/protocol-config.js.map +1 -1
  553. package/dist/types/protocol-constants.d.ts +2 -2
  554. package/dist/types/protocol-constants.js +2 -2
  555. package/dist/types/session.d.ts +62 -61
  556. package/dist/types/session.d.ts.map +1 -1
  557. package/dist/types/session.js +13 -14
  558. package/dist/types/session.js.map +1 -1
  559. package/dist/types/trust.d.ts +8 -8
  560. package/dist/types/trust.js +3 -3
  561. package/dist/utils/retry.d.ts.map +1 -1
  562. package/dist/utils/retry.js +2 -4
  563. package/dist/utils/retry.js.map +1 -1
  564. package/docs/ASSURANCE.md +82 -74
  565. package/docs/CLIENT_COMPOSITION.md +19 -15
  566. package/docs/DEVIATIONS.md +507 -425
  567. package/docs/DOCUMENTATION_STANDARDS.md +24 -24
  568. package/docs/E2EE.md +45 -42
  569. package/docs/ERROR_HANDLING.md +29 -105
  570. package/docs/GETTING_STARTED.md +24 -25
  571. package/docs/INTERFACES.md +27 -18
  572. package/docs/PACKAGE_SURFACE.md +23 -21
  573. package/docs/PROTOCOL_POLICY.md +19 -13
  574. package/docs/RECIPES.md +4 -4
  575. package/docs/SECURITY.md +72 -60
  576. package/encoding/README.md +2 -2
  577. package/files/README.md +1 -1
  578. package/groups/README.md +4 -3
  579. package/hooks/README.md +2 -2
  580. package/keys/README.md +15 -14
  581. package/local/store/README.md +82 -67
  582. package/local/store/expo/README.md +17 -12
  583. package/local/store/memory/README.md +4 -3
  584. package/local/store/node/README.md +8 -6
  585. package/local/store/react-native/README.md +14 -12
  586. package/local/store/web/README.md +31 -26
  587. package/local/vault/README.md +4 -4
  588. package/media/README.md +6 -5
  589. package/package.json +1 -1
  590. package/profile/README.md +7 -7
  591. package/remote/README.md +20 -18
  592. package/remote/object-store/README.md +8 -4
  593. package/remote/object-store/convex-r2/README.md +3 -3
  594. package/remote/object-store/s3/README.md +10 -5
  595. package/remote/relay/convex/README.md +5 -5
  596. package/remote/relay/convex/component/README.md +145 -124
  597. package/remote/relay/memory/README.md +6 -5
  598. package/safety/README.md +1 -1
  599. package/sealed-sender/README.md +3 -2
  600. package/types/README.md +1 -1
  601. package/utils/README.md +4 -4
@@ -59,7 +59,7 @@ export interface DecryptedEnvelope {
59
59
  timestamp: number;
60
60
  /** Relay server timestamp when available */
61
61
  serverTimestamp?: number;
62
- /** When the message was received locally */
62
+ /** When the device received the message locally */
63
63
  receivedAt: number;
64
64
  /** Whether this is a group message */
65
65
  isGroup: boolean;
@@ -67,7 +67,7 @@ export interface DecryptedEnvelope {
67
67
  messageType?: string;
68
68
  }
69
69
  /**
70
- * Event hooks that can be registered with SignalProtocolClient
70
+ * Event hooks that SignalProtocolClient accepts
71
71
  *
72
72
  * All hooks are optional and support both sync and async implementations.
73
73
  */
@@ -90,9 +90,9 @@ export interface SignalProtocolClientHooks {
90
90
  */
91
91
  onSessionEstablished?: (sessionId: string, remoteAddress: string) => void | Promise<void>;
92
92
  /**
93
- * Called after a session is deleted
93
+ * Runs after the client deletes a session
94
94
  *
95
- * @param sessionId - The session identifier that was deleted
95
+ * @param sessionId - The identifier of the deleted session
96
96
  *
97
97
  * @example
98
98
  * ```typescript
@@ -106,13 +106,13 @@ export interface SignalProtocolClientHooks {
106
106
  */
107
107
  onSessionDeleted?: (sessionId: string) => void | Promise<void>;
108
108
  /**
109
- * Called after a session is archived (moved to inactive list)
109
+ * Runs after the client archives a session (moved to inactive list)
110
110
  *
111
111
  * Stale-device recovery archives the session so delayed messages can still
112
112
  * attempt decryption.
113
113
  * Per SESAME §3.2: "previously active session is moved to the head of the inactive sessions list"
114
114
  *
115
- * @param sessionId - The session identifier that was archived
115
+ * @param sessionId - The identifier of the archived session
116
116
  *
117
117
  * @example
118
118
  * ```typescript
@@ -125,7 +125,7 @@ export interface SignalProtocolClientHooks {
125
125
  /**
126
126
  * Called after a key rotation completes successfully
127
127
  *
128
- * @param keyType - Type of key that was rotated
128
+ * @param keyType - Type of the rotated key
129
129
  *
130
130
  * @example
131
131
  * ```typescript
@@ -244,13 +244,13 @@ export interface SignalProtocolClientHooks {
244
244
  */
245
245
  onKeysCleanedUp?: (sessionId: string, removedCount: number) => void | Promise<void>;
246
246
  /**
247
- * Called when a delivery receipt is received
247
+ * Runs when the client receives a delivery receipt
248
248
  *
249
249
  * Allows the app to update message status from 'sent' to 'delivered'.
250
250
  * The timestamps array contains server timestamps of delivered messages.
251
251
  *
252
252
  * @param senderId - The user who sent the delivery receipt (message recipient)
253
- * @param timestamps - Array of message timestamps that were delivered
253
+ * @param timestamps - Array of message timestamps for the delivered messages
254
254
  *
255
255
  * @example
256
256
  * ```typescript
@@ -263,13 +263,13 @@ export interface SignalProtocolClientHooks {
263
263
  */
264
264
  onDeliveryReceiptReceived?: (senderId: string, timestamps: number[]) => void | Promise<void>;
265
265
  /**
266
- * Called when a read receipt is received
266
+ * Runs when the client receives a read receipt
267
267
  *
268
268
  * Allows the app to update message status from 'delivered' to 'read'.
269
269
  * The timestamps array contains server timestamps of read messages.
270
270
  *
271
271
  * @param senderId - The user who sent the read receipt (message recipient who viewed messages)
272
- * @param timestamps - Array of message timestamps that were read
272
+ * @param timestamps - Array of message timestamps for the read messages
273
273
  *
274
274
  * @example
275
275
  * ```typescript
@@ -282,13 +282,13 @@ export interface SignalProtocolClientHooks {
282
282
  */
283
283
  onReadReceiptReceived?: (senderId: string, timestamps: number[]) => void | Promise<void>;
284
284
  /**
285
- * Called when a viewed receipt is received (e.g., view-once media)
285
+ * Runs when the client receives a viewed receipt (e.g., view-once media)
286
286
  *
287
287
  * Allows the app to update message status to 'viewed'.
288
288
  * The timestamps array contains server timestamps of viewed messages.
289
289
  *
290
290
  * @param senderId - The user who sent the viewed receipt (message recipient who viewed media)
291
- * @param timestamps - Array of message timestamps that were viewed
291
+ * @param timestamps - Array of message timestamps for the viewed messages
292
292
  *
293
293
  * @example
294
294
  * ```typescript
@@ -301,13 +301,13 @@ export interface SignalProtocolClientHooks {
301
301
  */
302
302
  onViewedReceiptReceived?: (senderId: string, timestamps: number[]) => void | Promise<void>;
303
303
  /**
304
- * Called when a typing indicator is received
304
+ * Runs when the client receives a typing indicator
305
305
  *
306
- * Allows the app to update UI to show who is typing.
306
+ * Allows the app to update UI with the users who type.
307
307
  * Typing indicators are transient - they auto-expire after 15 seconds.
308
308
  *
309
309
  * @param senderId - The user who sent the typing indicator
310
- * @param conversationId - The conversation where typing is occurring
310
+ * @param conversationId - The conversation the typing indicator belongs to
311
311
  * @param action - Whether user STARTED or STOPPED typing
312
312
  *
313
313
  * @example
@@ -1 +1 @@
1
- {"version":3,"file":"event-hooks.d.ts","sourceRoot":"","sources":["../../client/event-hooks.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"event-hooks.d.ts","sourceRoot":"","sources":["../../client/event-hooks.ts"],"names":[],"mappings":"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"}
@@ -52,7 +52,7 @@ export async function callHook(hooks, hookName, ...args) {
52
52
  await Promise.resolve(Reflect.apply(hook, undefined, args));
53
53
  }
54
54
  catch (error) {
55
- // Log hook error but don't let it break core functionality
55
+ // Log hook error but do not let it break core functionality
56
56
  console.error(`Hook ${hookName} failed:`, error);
57
57
  }
58
58
  }
@@ -1 +1 @@
1
- {"version":3,"file":"event-hooks.js","sourceRoot":"","sources":["../../client/event-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAyTH;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,KAA4C,EAC5C,QAAW,EACX,GAAG,IAA2D;IAE9D,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/B,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAA8C,CAAC;QAC1E,MAAM,OAAO,CAAC,OAAO,CACnB,OAAO,CAAC,KAAK,CAAC,IAA2C,EAAE,SAAS,EAAE,IAAiB,CAAC,CACzF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,2DAA2D;QAC3D,OAAO,CAAC,KAAK,CAAC,QAAQ,QAAQ,UAAU,EAAE,KAAK,CAAC,CAAC;IACnD,CAAC;AACH,CAAC"}
1
+ {"version":3,"file":"event-hooks.js","sourceRoot":"","sources":["../../client/event-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAyTH;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,KAA4C,EAC5C,QAAW,EACX,GAAG,IAA2D;IAE9D,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/B,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAA8C,CAAC;QAC1E,MAAM,OAAO,CAAC,OAAO,CACnB,OAAO,CAAC,KAAK,CAAC,IAA2C,EAAE,SAAS,EAAE,IAAiB,CAAC,CACzF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,4DAA4D;QAC5D,OAAO,CAAC,KAAK,CAAC,QAAQ,QAAQ,UAAU,EAAE,KAAK,CAAC,CAAC;IACnD,CAAC;AACH,CAAC"}
@@ -96,10 +96,10 @@ export async function decryptFile(ctx, remoteAddress, encryptedBlob, encryptedKe
96
96
  }
97
97
  // Decrypt file with AES-GCM
98
98
  const fileBytes = await CryptoUtils.aesGcmDecrypt(fileKey, asBase64(encrypted.ciphertext), asBase64(encrypted.iv), asBase64(encrypted.authTag));
99
- // Convert Uint8Array to Blob with correct MIME type from encrypted metadata
100
- // Use ArrayBuffer slice to satisfy TypeScript's strict BlobPart types
101
- // (Uint8Array.buffer may be larger than the view, so we slice to exact bounds)
102
- // Cast needed because .slice() returns ArrayBufferLike which includes SharedArrayBuffer
99
+ // Convert Uint8Array to Blob with correct MIME type from encrypted metadata.
100
+ // Use ArrayBuffer slice to satisfy TypeScript's strict BlobPart types.
101
+ // (Uint8Array.buffer may be larger than the view, so we slice to exact bounds).
102
+ // Cast needed because .slice() returns ArrayBufferLike, which includes SharedArrayBuffer.
103
103
  const finalMimeType = keyMetadata.mimeType || 'application/octet-stream';
104
104
  const arrayBuffer = fileBytes.buffer.slice(fileBytes.byteOffset, fileBytes.byteOffset + fileBytes.byteLength);
105
105
  return new Blob([arrayBuffer], { type: finalMimeType });
@@ -1 +1 @@
1
- {"version":3,"file":"files.js","sourceRoot":"","sources":["../../client/files.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"files.js","sourceRoot":"","sources":["../../client/files.ts"],"names":[],"mappings":"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"}
@@ -33,11 +33,11 @@ import { type PreKeyMaintenanceStore } from './config.js';
33
33
  */
34
34
  export {};
35
35
  export interface HeadlessRotationResult {
36
- /** Whether signed prekey was rotated */
36
+ /** Whether the call rotated the signed prekey */
37
37
  signedRotated: boolean;
38
- /** Whether Kyber prekey was rotated */
38
+ /** Whether the call rotated the Kyber prekey */
39
39
  kyberRotated: boolean;
40
- /** Whether one-time prekeys were replenished */
40
+ /** Whether the call replenished the one-time prekeys */
41
41
  oneTimeReplenished: boolean;
42
42
  /** Any errors that occurred (non-fatal) */
43
43
  errors: string[];
@@ -61,13 +61,13 @@ export interface HeadlessRotationOptions {
61
61
  * Per PQXDH spec Section 3.2, rotates BOTH signed and Kyber prekeys
62
62
  * together to maintain synchronized post-quantum forward secrecy.
63
63
  *
64
- * This function is designed for background tasks where no React
65
- * context is available. It uses the same core rotation logic
64
+ * This function suits background tasks that have no React
65
+ * context. It uses the same core rotation logic
66
66
  * as SignalProtocolClient but works with any ISignalProtocolRelayServer implementation.
67
67
  *
68
68
  * Features:
69
69
  * - Works with ConvexSignalProtocolRelayServer or any ISignalProtocolRelayServer implementation
70
- * - Checks if rotation is needed before performing it
70
+ * - Checks whether the keys need rotation before it rotates them
71
71
  * - Handles errors gracefully (returns partial success)
72
72
  * - Logs all operations for debugging
73
73
  *
@@ -83,7 +83,7 @@ export declare function rotateKeysHeadless(relay: ISignalProtocolRelayServer, us
83
83
  /**
84
84
  * Check if any keys need rotation
85
85
  *
86
- * Lightweight check that doesn't perform rotation.
86
+ * Lightweight check that does not rotate anything.
87
87
  * Useful for deciding whether to run the full rotation.
88
88
  *
89
89
  * @param relay - Signal Protocol relay server interface
@@ -1 +1 @@
1
- {"version":3,"file":"headless.d.ts","sourceRoot":"","sources":["../../client/headless.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAA+B,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAEtE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAqC,KAAK,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAQ1F;;GAEG;AACH,OAAO,EAAE,CAAC;AACV,MAAM,WAAW,sBAAsB;IACrC,wCAAwC;IACxC,aAAa,EAAE,OAAO,CAAC;IACvB,uCAAuC;IACvC,YAAY,EAAE,OAAO,CAAC;IACtB,gDAAgD;IAChD,kBAAkB,EAAE,OAAO,CAAC;IAC5B,2CAA2C;IAC3C,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,0DAA0D;IAC1D,OAAO,CAAC,EAAE,yBAAyB,CAAC;IACpC,4DAA4D;IAC5D,aAAa,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,sBAAsB,CAAC;IAC3C,yDAAyD;IACzD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,0BAA0B,EACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,sBAAsB,CAAC,CAiHjC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,0BAA0B,EACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IACT,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,oBAAoB,EAAE,OAAO,CAAC;CAC/B,CAAC,CAgBD"}
1
+ {"version":3,"file":"headless.d.ts","sourceRoot":"","sources":["../../client/headless.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAA+B,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAEtE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAqC,KAAK,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAQ1F;;GAEG;AACH,OAAO,EAAE,CAAC;AACV,MAAM,WAAW,sBAAsB;IACrC,iDAAiD;IACjD,aAAa,EAAE,OAAO,CAAC;IACvB,gDAAgD;IAChD,YAAY,EAAE,OAAO,CAAC;IACtB,wDAAwD;IACxD,kBAAkB,EAAE,OAAO,CAAC;IAC5B,2CAA2C;IAC3C,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,0DAA0D;IAC1D,OAAO,CAAC,EAAE,yBAAyB,CAAC;IACpC,4DAA4D;IAC5D,aAAa,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,sBAAsB,CAAC;IAC3C,yDAAyD;IACzD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,0BAA0B,EACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,sBAAsB,CAAC,CAiHjC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,0BAA0B,EACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IACT,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,oBAAoB,EAAE,OAAO,CAAC;CAC/B,CAAC,CAgBD"}
@@ -33,13 +33,13 @@ import { rotateEcSignedPreKeyCore, rotateKyberPreKeyCore, replenishOneTimePreKey
33
33
  * Per PQXDH spec Section 3.2, rotates BOTH signed and Kyber prekeys
34
34
  * together to maintain synchronized post-quantum forward secrecy.
35
35
  *
36
- * This function is designed for background tasks where no React
37
- * context is available. It uses the same core rotation logic
36
+ * This function suits background tasks that have no React
37
+ * context. It uses the same core rotation logic
38
38
  * as SignalProtocolClient but works with any ISignalProtocolRelayServer implementation.
39
39
  *
40
40
  * Features:
41
41
  * - Works with ConvexSignalProtocolRelayServer or any ISignalProtocolRelayServer implementation
42
- * - Checks if rotation is needed before performing it
42
+ * - Checks whether the keys need rotation before it rotates them
43
43
  * - Handles errors gracefully (returns partial success)
44
44
  * - Logs all operations for debugging
45
45
  *
@@ -137,7 +137,7 @@ export async function rotateKeysHeadless(relay, userId, deviceId, options) {
137
137
  /**
138
138
  * Check if any keys need rotation
139
139
  *
140
- * Lightweight check that doesn't perform rotation.
140
+ * Lightweight check that does not rotate anything.
141
141
  * Useful for deciding whether to run the full rotation.
142
142
  *
143
143
  * @param relay - Signal Protocol relay server interface
@@ -18,7 +18,7 @@
18
18
  * - Network requests completing out of order
19
19
  *
20
20
  * The lock wraps the entire check → generate → upload → store sequence
21
- * to ensure atomic key rotation operations.
21
+ * to make key rotation atomic.
22
22
  *
23
23
  * ## Transactional Pattern
24
24
  *
@@ -28,8 +28,8 @@
28
28
  * 3. Upload to server (may fail - local state unchanged)
29
29
  * 4. Store locally only after successful upload
30
30
  *
31
- * This ensures client and server stay in sync. If upload fails,
32
- * local state is unchanged and rotation can be safely retried.
31
+ * This keeps client and server in sync. If upload fails, local state does not
32
+ * change, and the caller can safely retry rotation.
33
33
  */
34
34
  import { type ILogger } from '../logger.js';
35
35
  import type { ISignalProtocolLocalStore } from '../types/index.js';
@@ -42,34 +42,35 @@ import { type PreKeyMaintenanceStore } from './config.js';
42
42
  * Prevents concurrent callers from both generating and uploading different keys,
43
43
  * which would result in one upload overwriting the other.
44
44
  *
45
- * Uses per-key-type locks so signed and Kyber rotations don't block each other.
45
+ * Uses per-key-type locks so signed and Kyber rotations do not block each other.
46
46
  */
47
47
  export {};
48
48
  /**
49
- * Minimum one-time prekeys before replenishment is triggered.
50
- * When count drops below this threshold, new prekeys are generated and uploaded.
49
+ * Minimum one-time prekeys before replenishment starts.
50
+ * When the count drops below this threshold, the client generates and uploads
51
+ * new prekeys.
51
52
  */
52
53
  export declare const MIN_PREKEY_REPLENISHMENT_THRESHOLD = 10;
53
54
  /**
54
55
  * Check if a key needs rotation based on age
55
56
  *
56
57
  * Used for BOTH signed and Kyber prekeys. Per PQXDH spec Section 3.2,
57
- * both key types use identical rotation thresholds to ensure synchronized
58
+ * both key types use identical rotation thresholds, which synchronizes
58
59
  * post-quantum security maintenance.
59
60
  *
60
61
  * @param createdAt - Key creation timestamp (milliseconds)
61
62
  * @param expiresAt - Key expiration timestamp (milliseconds)
62
63
  * @param refreshIntervalMs - Custom refresh interval (defaults to 2 days)
63
- * @returns true if key should be rotated
64
+ * @returns true if the key needs rotation
64
65
  *
65
66
  * @see https://signal.org/docs/specifications/pqxdh/#publishing-keys
66
67
  */
67
68
  export declare function shouldRotateKey(createdAt: number, expiresAt: number, refreshIntervalMs?: number): boolean;
68
69
  /**
69
- * Check if prekeys have exceeded maximum allowed age.
70
+ * Check whether prekeys exceed the maximum allowed age.
70
71
  *
71
- * If prekeys are older than MAX_PREKEY_AGE_MS (14 days), message sending
72
- * should be blocked until rotation succeeds.
72
+ * If prekeys are older than MAX_PREKEY_AGE_MS (14 days), the caller must block
73
+ * message sending until rotation succeeds.
73
74
  *
74
75
  * This provides a 12-day safety buffer above the 2-day refresh interval.
75
76
  *
@@ -91,7 +92,7 @@ export declare function isPreKeyExpired(createdAt: number, maxAgeMs?: number): b
91
92
  * @param deviceId - Device identifier
92
93
  * @param providedStorage - Local store instance for the current runtime
93
94
  * @param refreshIntervalMs - Custom refresh interval (defaults to 2 days)
94
- * @returns true if rotation was performed
95
+ * @returns true if the function rotated the key
95
96
  */
96
97
  export declare function rotateEcSignedPreKeyCore(relay: ISignalProtocolRelayServer, userId: string, deviceId: number, providedStorage?: ISignalProtocolLocalStore, refreshIntervalMs?: number, identityTypes?: readonly IdentityType[], logger?: Required<ILogger>): Promise<boolean>;
97
98
  /**
@@ -106,7 +107,7 @@ export declare function rotateEcSignedPreKeyCore(relay: ISignalProtocolRelayServ
106
107
  * @param deviceId - Device identifier
107
108
  * @param providedStorage - Local store instance for the current runtime
108
109
  * @param refreshIntervalMs - Custom refresh interval (defaults to 2 days)
109
- * @returns true if rotation was performed
110
+ * @returns true if the function rotated the key
110
111
  */
111
112
  export declare function rotateKyberPreKeyCore(relay: ISignalProtocolRelayServer, userId: string, deviceId: number, providedStorage?: ISignalProtocolLocalStore, refreshIntervalMs?: number, identityTypes?: readonly IdentityType[], logger?: Required<ILogger>): Promise<boolean>;
112
113
  /**
@@ -120,7 +121,7 @@ export declare function rotateKyberPreKeyCore(relay: ISignalProtocolRelayServer,
120
121
  * @param deviceId - Device identifier
121
122
  * @param storage - Key storage for local persistence
122
123
  * @param threshold - Minimum number of prekeys before replenishment (default: 10)
123
- * @returns true if replenishment was performed for both identity types
124
+ * @returns true if the function replenished both identity types
124
125
  */
125
126
  export declare function replenishOneTimePreKeysCore(relay: ISignalProtocolRelayServer, userId: string, deviceId: number, storage: ISignalProtocolLocalStore, threshold?: number, identityTypes?: readonly IdentityType[], preKeyMaintenance?: PreKeyMaintenanceStore, logger?: Required<ILogger>): Promise<boolean>;
126
127
  /**
@@ -129,7 +130,7 @@ export declare function replenishOneTimePreKeysCore(relay: ISignalProtocolRelayS
129
130
  export interface PreKeySendCheckResult {
130
131
  /** Whether sending should proceed */
131
132
  canSend: boolean;
132
- /** Whether rotation was attempted */
133
+ /** Whether the check attempted a rotation */
133
134
  rotationAttempted: boolean;
134
135
  /** Whether rotation succeeded (if attempted) */
135
136
  rotationSucceeded: boolean;
@@ -139,8 +140,9 @@ export interface PreKeySendCheckResult {
139
140
  /**
140
141
  * Check prekey age and rotate if needed before sending a message.
141
142
  *
142
- * If prekeys exceed MAX_PREKEY_AGE_MS (14 days), rotation is attempted.
143
- * If rotation fails, sending should be blocked to maintain security.
143
+ * If prekeys exceed MAX_PREKEY_AGE_MS (14 days), this function attempts a
144
+ * rotation. If rotation fails, the caller must block sending to maintain
145
+ * security.
144
146
  *
145
147
  * @param relay - Signal Protocol relay server interface
146
148
  * @param userId - User identifier
@@ -1 +1 @@
1
- {"version":3,"file":"key-rotation-core.d.ts","sourceRoot":"","sources":["../../client/key-rotation-core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAGH,OAAO,EAA+B,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAE1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGlD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,UAAU,CAAC;AAElB;;;;;;;GAOG;AACH,OAAO,EAAE,CAAC;AA+GV;;;GAGG;AACH,eAAO,MAAM,kCAAkC,KAAK,CAAC;AAErD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,iBAAiB,GAAE,MAAwC,GAC1D,OAAO,CAMT;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,MAAkC,GAC3C,OAAO,CAGT;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,0BAA0B,EACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,eAAe,CAAC,EAAE,yBAAyB,EAC3C,iBAAiB,GAAE,MAAwC,EAC3D,aAAa,GAAE,SAAS,YAAY,EAAmB,EACvD,MAAM,GAAE,QAAQ,CAAC,OAAO,CAA+B,GACtD,OAAO,CAAC,OAAO,CAAC,CAmBlB;AAgFD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,0BAA0B,EACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,eAAe,CAAC,EAAE,yBAAyB,EAC3C,iBAAiB,GAAE,MAAwC,EAC3D,aAAa,GAAE,SAAS,YAAY,EAAmB,EACvD,MAAM,GAAE,QAAQ,CAAC,OAAO,CAA+B,GACtD,OAAO,CAAC,OAAO,CAAC,CAmBlB;AAqFD;;;;;;;;;;;;GAYG;AACH,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,0BAA0B,EACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,yBAAyB,EAClC,SAAS,GAAE,MAA2C,EACtD,aAAa,GAAE,SAAS,YAAY,EAAmB,EACvD,iBAAiB,CAAC,EAAE,sBAAsB,EAC1C,MAAM,GAAE,QAAQ,CAAC,OAAO,CAA+B,GACtD,OAAO,CAAC,OAAO,CAAC,CAiBlB;AAkFD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,qCAAqC;IACrC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,gDAAgD;IAChD,iBAAiB,EAAE,OAAO,CAAC;IAC3B,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,0BAA0B,EACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,yBAAyB,EACnC,QAAQ,GAAE,MAAkC,EAC5C,YAAY,GAAE,YAAoB,EAClC,MAAM,GAAE,QAAQ,CAAC,OAAO,CAA+B,GACtD,OAAO,CAAC,qBAAqB,CAAC,CAkGhC"}
1
+ {"version":3,"file":"key-rotation-core.d.ts","sourceRoot":"","sources":["../../client/key-rotation-core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAGH,OAAO,EAA+B,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAE1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGlD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,UAAU,CAAC;AAElB;;;;;;;GAOG;AACH,OAAO,EAAE,CAAC;AA+GV;;;;GAIG;AACH,eAAO,MAAM,kCAAkC,KAAK,CAAC;AAErD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,iBAAiB,GAAE,MAAwC,GAC1D,OAAO,CAMT;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,MAAkC,GAC3C,OAAO,CAGT;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,0BAA0B,EACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,eAAe,CAAC,EAAE,yBAAyB,EAC3C,iBAAiB,GAAE,MAAwC,EAC3D,aAAa,GAAE,SAAS,YAAY,EAAmB,EACvD,MAAM,GAAE,QAAQ,CAAC,OAAO,CAA+B,GACtD,OAAO,CAAC,OAAO,CAAC,CAoBlB;AAgFD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,0BAA0B,EACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,eAAe,CAAC,EAAE,yBAAyB,EAC3C,iBAAiB,GAAE,MAAwC,EAC3D,aAAa,GAAE,SAAS,YAAY,EAAmB,EACvD,MAAM,GAAE,QAAQ,CAAC,OAAO,CAA+B,GACtD,OAAO,CAAC,OAAO,CAAC,CAoBlB;AAqFD;;;;;;;;;;;;GAYG;AACH,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,0BAA0B,EACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,yBAAyB,EAClC,SAAS,GAAE,MAA2C,EACtD,aAAa,GAAE,SAAS,YAAY,EAAmB,EACvD,iBAAiB,CAAC,EAAE,sBAAsB,EAC1C,MAAM,GAAE,QAAQ,CAAC,OAAO,CAA+B,GACtD,OAAO,CAAC,OAAO,CAAC,CAiBlB;AAkFD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,6CAA6C;IAC7C,iBAAiB,EAAE,OAAO,CAAC;IAC3B,gDAAgD;IAChD,iBAAiB,EAAE,OAAO,CAAC;IAC3B,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,0BAA0B,EACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,yBAAyB,EACnC,QAAQ,GAAE,MAAkC,EAC5C,YAAY,GAAE,YAAoB,EAClC,MAAM,GAAE,QAAQ,CAAC,OAAO,CAA+B,GACtD,OAAO,CAAC,qBAAqB,CAAC,CAkGhC"}
@@ -18,7 +18,7 @@
18
18
  * - Network requests completing out of order
19
19
  *
20
20
  * The lock wraps the entire check → generate → upload → store sequence
21
- * to ensure atomic key rotation operations.
21
+ * to make key rotation atomic.
22
22
  *
23
23
  * ## Transactional Pattern
24
24
  *
@@ -28,8 +28,8 @@
28
28
  * 3. Upload to server (may fail - local state unchanged)
29
29
  * 4. Store locally only after successful upload
30
30
  *
31
- * This ensures client and server stay in sync. If upload fails,
32
- * local state is unchanged and rotation can be safely retried.
31
+ * This keeps client and server in sync. If upload fails, local state does not
32
+ * change, and the caller can safely retry rotation.
33
33
  */
34
34
  import AsyncLock from 'async-lock';
35
35
  import { defaultSignalProtocolLogger } from '../logger.js';
@@ -103,21 +103,22 @@ function checkRotationNeeded(metadata, refreshIntervalMs, keyTypeName, logger) {
103
103
  // EXPORTS
104
104
  // ============================================================================
105
105
  /**
106
- * Minimum one-time prekeys before replenishment is triggered.
107
- * When count drops below this threshold, new prekeys are generated and uploaded.
106
+ * Minimum one-time prekeys before replenishment starts.
107
+ * When the count drops below this threshold, the client generates and uploads
108
+ * new prekeys.
108
109
  */
109
110
  export const MIN_PREKEY_REPLENISHMENT_THRESHOLD = 10;
110
111
  /**
111
112
  * Check if a key needs rotation based on age
112
113
  *
113
114
  * Used for BOTH signed and Kyber prekeys. Per PQXDH spec Section 3.2,
114
- * both key types use identical rotation thresholds to ensure synchronized
115
+ * both key types use identical rotation thresholds, which synchronizes
115
116
  * post-quantum security maintenance.
116
117
  *
117
118
  * @param createdAt - Key creation timestamp (milliseconds)
118
119
  * @param expiresAt - Key expiration timestamp (milliseconds)
119
120
  * @param refreshIntervalMs - Custom refresh interval (defaults to 2 days)
120
- * @returns true if key should be rotated
121
+ * @returns true if the key needs rotation
121
122
  *
122
123
  * @see https://signal.org/docs/specifications/pqxdh/#publishing-keys
123
124
  */
@@ -128,10 +129,10 @@ export function shouldRotateKey(createdAt, expiresAt, refreshIntervalMs = KEY_RE
128
129
  return age >= refreshIntervalMs || now >= expiresAt;
129
130
  }
130
131
  /**
131
- * Check if prekeys have exceeded maximum allowed age.
132
+ * Check whether prekeys exceed the maximum allowed age.
132
133
  *
133
- * If prekeys are older than MAX_PREKEY_AGE_MS (14 days), message sending
134
- * should be blocked until rotation succeeds.
134
+ * If prekeys are older than MAX_PREKEY_AGE_MS (14 days), the caller must block
135
+ * message sending until rotation succeeds.
135
136
  *
136
137
  * This provides a 12-day safety buffer above the 2-day refresh interval.
137
138
  *
@@ -156,13 +157,14 @@ export function isPreKeyExpired(createdAt, maxAgeMs = MAX_PREKEY_AGE_MS_DEFAULT)
156
157
  * @param deviceId - Device identifier
157
158
  * @param providedStorage - Local store instance for the current runtime
158
159
  * @param refreshIntervalMs - Custom refresh interval (defaults to 2 days)
159
- * @returns true if rotation was performed
160
+ * @returns true if the function rotated the key
160
161
  */
161
162
  export async function rotateEcSignedPreKeyCore(relay, userId, deviceId, providedStorage, refreshIntervalMs = KEY_REFRESH_INTERVAL_MS_DEFAULT, identityTypes = ['aci', 'pni'], logger = defaultSignalProtocolLogger) {
162
- // Rotate for active identity types (the reference implementation rotates PNI on the same schedule as ACI)
163
+ // Rotate for active identity types. The reference implementation rotates PNI
164
+ // on the same schedule as ACI.
163
165
  // Use && so the function only returns true when ALL identities succeed.
164
- // The reference implementation uses exception propagation — if any identity fails, the entire job
165
- // fails and is retried on the next rotation cycle.
166
+ // The reference implementation uses exception propagation. If any identity fails, the entire job
167
+ // fails, and the next rotation cycle retries it.
166
168
  let allRotated = true;
167
169
  for (const type of identityTypes) {
168
170
  const rotated = await rotateEcSignedPreKeyForIdentity(relay, userId, deviceId, type, providedStorage, refreshIntervalMs, logger);
@@ -179,11 +181,11 @@ export async function rotateEcSignedPreKeyCore(relay, userId, deviceId, provided
179
181
  * @param identityType - 'aci' or 'pni'
180
182
  * @param providedStorage - Optional storage instance
181
183
  * @param refreshIntervalMs - Custom refresh interval
182
- * @returns true if rotation was performed
184
+ * @returns true if the function rotated the key
183
185
  */
184
186
  async function rotateEcSignedPreKeyForIdentity(relay, userId, deviceId, identityType, providedStorage, refreshIntervalMs = KEY_REFRESH_INTERVAL_MS_DEFAULT, logger = defaultSignalProtocolLogger) {
185
187
  return withRotationLock(userId, deviceId, `signed:${identityType}`, async () => {
186
- // Check if rotation is needed for this identity type
188
+ // Check whether this identity type needs rotation
187
189
  const metadata = await relay.getEcSignedPreKeyMetadata(userId, deviceId, identityType);
188
190
  if (!checkRotationNeeded(metadata, refreshIntervalMs, `EC signed prekey (${identityType})`, logger)) {
189
191
  return false;
@@ -195,10 +197,10 @@ async function rotateEcSignedPreKeyForIdentity(relay, userId, deviceId, identity
195
197
  const { generateEcSignedPreKey } = await import('../keys/index.js');
196
198
  const storage = await resolveStorage(providedStorage, logger);
197
199
  const identityKey = await getRequiredIdentityKey(storage, identityType);
198
- // Generate new EC signed prekey (but don't store yet)
200
+ // Generate new EC signed prekey (but do not store yet)
199
201
  const newSignedPreKey = await generateEcSignedPreKey(identityKey);
200
202
  // TRANSACTIONAL PATTERN: Upload first, then commit locally
201
- // If upload fails, local state is unchanged - safe to retry.
203
+ // If upload fails, local state does not change, so a retry is safe.
202
204
  await relay.uploadEcSignedPreKey(userId, {
203
205
  keyId: newSignedPreKey.keyId,
204
206
  deviceId,
@@ -226,13 +228,14 @@ async function rotateEcSignedPreKeyForIdentity(relay, userId, deviceId, identity
226
228
  * @param deviceId - Device identifier
227
229
  * @param providedStorage - Local store instance for the current runtime
228
230
  * @param refreshIntervalMs - Custom refresh interval (defaults to 2 days)
229
- * @returns true if rotation was performed
231
+ * @returns true if the function rotated the key
230
232
  */
231
233
  export async function rotateKyberPreKeyCore(relay, userId, deviceId, providedStorage, refreshIntervalMs = KEY_REFRESH_INTERVAL_MS_DEFAULT, identityTypes = ['aci', 'pni'], logger = defaultSignalProtocolLogger) {
232
- // Rotate for active identity types (the reference implementation rotates PNI on the same schedule as ACI)
234
+ // Rotate for active identity types. The reference implementation rotates PNI
235
+ // on the same schedule as ACI.
233
236
  // Use && so the function only returns true when ALL identities succeed.
234
- // The reference implementation uses exception propagation — if any identity fails, the entire job
235
- // fails and is retried on the next rotation cycle.
237
+ // The reference implementation uses exception propagation. If any identity fails, the entire job
238
+ // fails, and the next rotation cycle retries it.
236
239
  let allRotated = true;
237
240
  for (const type of identityTypes) {
238
241
  const rotated = await rotateKyberPreKeyForIdentity(relay, userId, deviceId, type, providedStorage, refreshIntervalMs, logger);
@@ -249,11 +252,11 @@ export async function rotateKyberPreKeyCore(relay, userId, deviceId, providedSto
249
252
  * @param identityType - 'aci' or 'pni'
250
253
  * @param providedStorage - Optional storage instance
251
254
  * @param refreshIntervalMs - Custom refresh interval
252
- * @returns true if rotation was performed
255
+ * @returns true if the function rotated the key
253
256
  */
254
257
  async function rotateKyberPreKeyForIdentity(relay, userId, deviceId, identityType, providedStorage, refreshIntervalMs = KEY_REFRESH_INTERVAL_MS_DEFAULT, logger = defaultSignalProtocolLogger) {
255
258
  return withRotationLock(userId, deviceId, `kyber:${identityType}`, async () => {
256
- // Check if rotation is needed for this identity type
259
+ // Check whether this identity type needs rotation
257
260
  const metadata = await relay.getKemLastResortPreKeyMetadata(userId, deviceId, identityType);
258
261
  if (!checkRotationNeeded(metadata, refreshIntervalMs, `Kyber prekey (${identityType})`, logger)) {
259
262
  return false;
@@ -267,7 +270,7 @@ async function rotateKyberPreKeyForIdentity(relay, userId, deviceId, identityTyp
267
270
  const { generateKyberLastResortPreKey } = await import('../keys/generation.js');
268
271
  const kyberPreKey = await generateKyberLastResortPreKey(identityKey, 1);
269
272
  // TRANSACTIONAL PATTERN: Upload first, then commit locally
270
- // If upload fails, local state is unchanged - safe to retry.
273
+ // If upload fails, local state does not change, so a retry is safe.
271
274
  const publicKyberPreKey = {
272
275
  keyId: kyberPreKey.keyId,
273
276
  publicKey: kyberPreKey.publicKey,
@@ -299,7 +302,7 @@ async function rotateKyberPreKeyForIdentity(relay, userId, deviceId, identityTyp
299
302
  * @param deviceId - Device identifier
300
303
  * @param storage - Key storage for local persistence
301
304
  * @param threshold - Minimum number of prekeys before replenishment (default: 10)
302
- * @returns true if replenishment was performed for both identity types
305
+ * @returns true if the function replenished both identity types
303
306
  */
304
307
  export async function replenishOneTimePreKeysCore(relay, userId, deviceId, storage, threshold = MIN_PREKEY_REPLENISHMENT_THRESHOLD, identityTypes = ['aci', 'pni'], preKeyMaintenance, logger = defaultSignalProtocolLogger) {
305
308
  // Replenish for active identity types (consistent with rotateEcSignedPreKeyCore/rotateKyberPreKeyCore)
@@ -319,7 +322,7 @@ export async function replenishOneTimePreKeysCore(relay, userId, deviceId, stora
319
322
  * @param storage - Key storage for local persistence
320
323
  * @param threshold - Minimum number of prekeys before replenishment
321
324
  * @param identityType - 'aci' or 'pni'
322
- * @returns true if replenishment was performed
325
+ * @returns true if the function replenished the prekeys
323
326
  */
324
327
  async function replenishOneTimePreKeysForIdentity(relay, userId, deviceId, storage, threshold, identityType, preKeyMaintenance, logger = defaultSignalProtocolLogger) {
325
328
  return withRotationLock(userId, deviceId, `prekeys:${identityType}`, async () => {
@@ -359,8 +362,9 @@ async function replenishOneTimePreKeysForIdentity(relay, userId, deviceId, stora
359
362
  /**
360
363
  * Check prekey age and rotate if needed before sending a message.
361
364
  *
362
- * If prekeys exceed MAX_PREKEY_AGE_MS (14 days), rotation is attempted.
363
- * If rotation fails, sending should be blocked to maintain security.
365
+ * If prekeys exceed MAX_PREKEY_AGE_MS (14 days), this function attempts a
366
+ * rotation. If rotation fails, the caller must block sending to maintain
367
+ * security.
364
368
  *
365
369
  * @param relay - Signal Protocol relay server interface
366
370
  * @param userId - User identifier
@@ -390,7 +394,7 @@ export async function ensurePreKeysValid(relay, userId, deviceId, storage, maxAg
390
394
  // Check Kyber prekey metadata for the specified identity type
391
395
  const kyberMetadata = await relay.getKemLastResortPreKeyMetadata(userId, deviceId, identityType);
392
396
  const kyberExpired = kyberMetadata ? isPreKeyExpired(kyberMetadata.createdAt, maxAgeMs) : true;
393
- // If neither is expired, sending can proceed
397
+ // If neither key expired, sending can proceed
394
398
  if (!signedExpired && !kyberExpired) {
395
399
  return {
396
400
  canSend: true,
@@ -398,7 +402,7 @@ export async function ensurePreKeysValid(relay, userId, deviceId, storage, maxAg
398
402
  rotationSucceeded: false,
399
403
  };
400
404
  }
401
- // Prekeys are expired - attempt rotation (rotate before blocking)
405
+ // The prekeys expired - attempt rotation (rotate before blocking)
402
406
  logger.warn('Prekeys expired, attempting rotation before send', {
403
407
  category: 'E2EE',
404
408
  data: {