@open-e2ee/signal-protocol-sdk 10.1.0 → 12.0.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 (595) hide show
  1. package/ADAPTERS.md +4 -4
  2. package/ARCHITECTURE.md +6 -8
  3. package/CHANGELOG.md +1413 -0
  4. package/README.md +1 -1
  5. package/SECURITY.md +2 -2
  6. package/TROUBLESHOOTING.md +1 -1
  7. package/client/README.md +84 -37
  8. package/device/README.md +39 -85
  9. package/dist/client/client.d.ts +342 -62
  10. package/dist/client/client.d.ts.map +1 -1
  11. package/dist/client/client.js +1195 -179
  12. package/dist/client/client.js.map +1 -1
  13. package/dist/client/config.d.ts +40 -32
  14. package/dist/client/config.d.ts.map +1 -1
  15. package/dist/client/config.js +1 -1
  16. package/dist/client/config.js.map +1 -1
  17. package/dist/client/constants.d.ts +42 -8
  18. package/dist/client/constants.d.ts.map +1 -1
  19. package/dist/client/constants.js +48 -3
  20. package/dist/client/constants.js.map +1 -1
  21. package/dist/client/content-adapter.d.ts +80 -0
  22. package/dist/client/content-adapter.d.ts.map +1 -1
  23. package/dist/client/content-adapter.js +225 -12
  24. package/dist/client/content-adapter.js.map +1 -1
  25. package/dist/client/delivery-error.d.ts +150 -0
  26. package/dist/client/delivery-error.d.ts.map +1 -0
  27. package/dist/client/delivery-error.js +226 -0
  28. package/dist/client/delivery-error.js.map +1 -0
  29. package/dist/client/delivery-status.d.ts +32 -6
  30. package/dist/client/delivery-status.d.ts.map +1 -1
  31. package/dist/client/delivery-status.js +61 -13
  32. package/dist/client/delivery-status.js.map +1 -1
  33. package/dist/client/device-set-reconciliation.d.ts +196 -0
  34. package/dist/client/device-set-reconciliation.d.ts.map +1 -0
  35. package/dist/client/device-set-reconciliation.js +282 -0
  36. package/dist/client/device-set-reconciliation.js.map +1 -0
  37. package/dist/client/distribution-records.d.ts +29 -0
  38. package/dist/client/distribution-records.d.ts.map +1 -0
  39. package/dist/client/distribution-records.js +33 -0
  40. package/dist/client/distribution-records.js.map +1 -0
  41. package/dist/client/event-hooks.d.ts +308 -6
  42. package/dist/client/event-hooks.d.ts.map +1 -1
  43. package/dist/client/event-hooks.js +9 -0
  44. package/dist/client/event-hooks.js.map +1 -1
  45. package/dist/client/group-device-set.d.ts +47 -0
  46. package/dist/client/group-device-set.d.ts.map +1 -0
  47. package/dist/client/group-device-set.js +65 -0
  48. package/dist/client/group-device-set.js.map +1 -0
  49. package/dist/client/group-fetcher.d.ts +116 -0
  50. package/dist/client/group-fetcher.d.ts.map +1 -0
  51. package/dist/client/group-fetcher.js +598 -0
  52. package/dist/client/group-fetcher.js.map +1 -0
  53. package/dist/client/group-outbox.d.ts +172 -10
  54. package/dist/client/group-outbox.d.ts.map +1 -1
  55. package/dist/client/group-outbox.js +915 -74
  56. package/dist/client/group-outbox.js.map +1 -1
  57. package/dist/client/group-receive-authorization.d.ts +127 -4
  58. package/dist/client/group-receive-authorization.d.ts.map +1 -1
  59. package/dist/client/group-receive-authorization.js +270 -20
  60. package/dist/client/group-receive-authorization.js.map +1 -1
  61. package/dist/client/group-sealed-sender.d.ts +3 -0
  62. package/dist/client/group-sealed-sender.d.ts.map +1 -1
  63. package/dist/client/group-sealed-sender.js +1 -0
  64. package/dist/client/group-sealed-sender.js.map +1 -1
  65. package/dist/client/group-sender-key-operations.d.ts +14 -3
  66. package/dist/client/group-sender-key-operations.d.ts.map +1 -1
  67. package/dist/client/group-sender-key-operations.js +26 -5
  68. package/dist/client/group-sender-key-operations.js.map +1 -1
  69. package/dist/client/groups.d.ts +5 -5
  70. package/dist/client/groups.d.ts.map +1 -1
  71. package/dist/client/groups.js +5 -4
  72. package/dist/client/groups.js.map +1 -1
  73. package/dist/client/hosted-anonymous-delivery.d.ts +61 -9
  74. package/dist/client/hosted-anonymous-delivery.d.ts.map +1 -1
  75. package/dist/client/hosted-anonymous-delivery.js +242 -48
  76. package/dist/client/hosted-anonymous-delivery.js.map +1 -1
  77. package/dist/client/hosted-assertion-id.d.ts +7 -0
  78. package/dist/client/hosted-assertion-id.d.ts.map +1 -0
  79. package/dist/client/hosted-assertion-id.js +51 -0
  80. package/dist/client/hosted-assertion-id.js.map +1 -0
  81. package/dist/client/hosted-device-standing.d.ts +52 -0
  82. package/dist/client/hosted-device-standing.d.ts.map +1 -0
  83. package/dist/client/hosted-device-standing.js +74 -0
  84. package/dist/client/hosted-device-standing.js.map +1 -0
  85. package/dist/client/hosted-mailbox-subscription.d.ts +48 -3
  86. package/dist/client/hosted-mailbox-subscription.d.ts.map +1 -1
  87. package/dist/client/hosted-mailbox-subscription.js +288 -74
  88. package/dist/client/hosted-mailbox-subscription.js.map +1 -1
  89. package/dist/client/hosted-push.d.ts +22 -4
  90. package/dist/client/hosted-push.d.ts.map +1 -1
  91. package/dist/client/hosted-push.js +75 -22
  92. package/dist/client/hosted-push.js.map +1 -1
  93. package/dist/client/hosted-transport.d.ts +22 -28
  94. package/dist/client/hosted-transport.d.ts.map +1 -1
  95. package/dist/client/hosted-transport.js +167 -69
  96. package/dist/client/hosted-transport.js.map +1 -1
  97. package/dist/client/hosted.d.ts +22 -5
  98. package/dist/client/hosted.d.ts.map +1 -1
  99. package/dist/client/hosted.js +122 -45
  100. package/dist/client/hosted.js.map +1 -1
  101. package/dist/client/index.d.ts +6 -4
  102. package/dist/client/index.d.ts.map +1 -1
  103. package/dist/client/index.js +3 -1
  104. package/dist/client/index.js.map +1 -1
  105. package/dist/client/messages.d.ts +25 -3
  106. package/dist/client/messages.d.ts.map +1 -1
  107. package/dist/client/messages.js +118 -17
  108. package/dist/client/messages.js.map +1 -1
  109. package/dist/client/one-time-prekey-refill.d.ts +7 -0
  110. package/dist/client/one-time-prekey-refill.d.ts.map +1 -1
  111. package/dist/client/one-time-prekey-refill.js +5 -1
  112. package/dist/client/one-time-prekey-refill.js.map +1 -1
  113. package/dist/client/receive-admission.d.ts +58 -0
  114. package/dist/client/receive-admission.d.ts.map +1 -0
  115. package/dist/client/receive-admission.js +78 -0
  116. package/dist/client/receive-admission.js.map +1 -0
  117. package/dist/client/receive-expiry.d.ts +31 -0
  118. package/dist/client/receive-expiry.d.ts.map +1 -0
  119. package/dist/client/receive-expiry.js +35 -0
  120. package/dist/client/receive-expiry.js.map +1 -0
  121. package/dist/client/receive-hook-bound.d.ts +50 -0
  122. package/dist/client/receive-hook-bound.d.ts.map +1 -0
  123. package/dist/client/receive-hook-bound.js +115 -0
  124. package/dist/client/receive-hook-bound.js.map +1 -0
  125. package/dist/client/receive-queue.d.ts +299 -0
  126. package/dist/client/receive-queue.d.ts.map +1 -0
  127. package/dist/client/receive-queue.js +1420 -0
  128. package/dist/client/receive-queue.js.map +1 -0
  129. package/dist/client/receive-work-seed.d.ts +54 -0
  130. package/dist/client/receive-work-seed.d.ts.map +1 -0
  131. package/dist/client/receive-work-seed.js +116 -0
  132. package/dist/client/receive-work-seed.js.map +1 -0
  133. package/dist/client/recovery-driver.d.ts +25 -0
  134. package/dist/client/recovery-driver.d.ts.map +1 -0
  135. package/dist/client/recovery-driver.js +121 -0
  136. package/dist/client/recovery-driver.js.map +1 -0
  137. package/dist/client/relay-acceptance.d.ts +30 -0
  138. package/dist/client/relay-acceptance.d.ts.map +1 -1
  139. package/dist/client/relay-acceptance.js +55 -0
  140. package/dist/client/relay-acceptance.js.map +1 -1
  141. package/dist/client/relay-device-refusal.d.ts +18 -0
  142. package/dist/client/relay-device-refusal.d.ts.map +1 -1
  143. package/dist/client/relay-device-refusal.js +31 -0
  144. package/dist/client/relay-device-refusal.js.map +1 -1
  145. package/dist/client/relay-sealed-route.d.ts +36 -0
  146. package/dist/client/relay-sealed-route.d.ts.map +1 -0
  147. package/dist/client/relay-sealed-route.js +45 -0
  148. package/dist/client/relay-sealed-route.js.map +1 -0
  149. package/dist/client/relay-subscription.d.ts +56 -13
  150. package/dist/client/relay-subscription.d.ts.map +1 -1
  151. package/dist/client/relay-subscription.js +220 -150
  152. package/dist/client/relay-subscription.js.map +1 -1
  153. package/dist/client/resendable-content.d.ts +98 -0
  154. package/dist/client/resendable-content.d.ts.map +1 -0
  155. package/dist/client/resendable-content.js +136 -0
  156. package/dist/client/resendable-content.js.map +1 -0
  157. package/dist/client/retry-family.d.ts +68 -19
  158. package/dist/client/retry-family.d.ts.map +1 -1
  159. package/dist/client/retry-family.js +59 -17
  160. package/dist/client/retry-family.js.map +1 -1
  161. package/dist/client/retry-request-envelope.d.ts +145 -18
  162. package/dist/client/retry-request-envelope.d.ts.map +1 -1
  163. package/dist/client/retry-request-envelope.js +301 -64
  164. package/dist/client/retry-request-envelope.js.map +1 -1
  165. package/dist/client/retry-request-lifecycle.d.ts +157 -0
  166. package/dist/client/retry-request-lifecycle.d.ts.map +1 -0
  167. package/dist/client/retry-request-lifecycle.js +437 -0
  168. package/dist/client/retry-request-lifecycle.js.map +1 -0
  169. package/dist/client/retry-terminal-recovery.d.ts +100 -0
  170. package/dist/client/retry-terminal-recovery.d.ts.map +1 -0
  171. package/dist/client/retry-terminal-recovery.js +164 -0
  172. package/dist/client/retry-terminal-recovery.js.map +1 -0
  173. package/dist/client/retry-utils.d.ts +27 -0
  174. package/dist/client/retry-utils.d.ts.map +1 -1
  175. package/dist/client/retry-utils.js +46 -0
  176. package/dist/client/retry-utils.js.map +1 -1
  177. package/dist/client/retry.d.ts +106 -18
  178. package/dist/client/retry.d.ts.map +1 -1
  179. package/dist/client/retry.js +687 -139
  180. package/dist/client/retry.js.map +1 -1
  181. package/dist/client/sealed-sender.d.ts +23 -6
  182. package/dist/client/sealed-sender.d.ts.map +1 -1
  183. package/dist/client/sealed-sender.js +30 -6
  184. package/dist/client/sealed-sender.js.map +1 -1
  185. package/dist/client/sessions.d.ts +2 -2
  186. package/dist/client/sessions.js +2 -2
  187. package/dist/client/signal-service-cipher.d.ts +726 -19
  188. package/dist/client/signal-service-cipher.d.ts.map +1 -1
  189. package/dist/client/signal-service-cipher.js +2265 -343
  190. package/dist/client/signal-service-cipher.js.map +1 -1
  191. package/dist/client/state.d.ts +5 -0
  192. package/dist/client/state.d.ts.map +1 -1
  193. package/dist/client/state.js +11 -1
  194. package/dist/client/state.js.map +1 -1
  195. package/dist/client/storage-protection.d.ts +64 -0
  196. package/dist/client/storage-protection.d.ts.map +1 -0
  197. package/dist/client/storage-protection.js +150 -0
  198. package/dist/client/storage-protection.js.map +1 -0
  199. package/dist/client/types.d.ts +149 -15
  200. package/dist/client/types.d.ts.map +1 -1
  201. package/dist/client/types.js +1 -1
  202. package/dist/client/types.js.map +1 -1
  203. package/dist/device/constants.d.ts +0 -5
  204. package/dist/device/constants.d.ts.map +1 -1
  205. package/dist/device/constants.js +0 -5
  206. package/dist/device/constants.js.map +1 -1
  207. package/dist/device/expo/index.d.ts +4 -17
  208. package/dist/device/expo/index.d.ts.map +1 -1
  209. package/dist/device/expo/index.js +4 -23
  210. package/dist/device/expo/index.js.map +1 -1
  211. package/dist/device/index.d.ts +0 -2
  212. package/dist/device/index.d.ts.map +1 -1
  213. package/dist/device/index.js +0 -7
  214. package/dist/device/index.js.map +1 -1
  215. package/dist/device/lifecycle/manager.d.ts +5 -4
  216. package/dist/device/lifecycle/manager.d.ts.map +1 -1
  217. package/dist/device/lifecycle/manager.js +16 -16
  218. package/dist/device/lifecycle/manager.js.map +1 -1
  219. package/dist/device/lifecycle/types.d.ts +2 -2
  220. package/dist/device/lifecycle/types.d.ts.map +1 -1
  221. package/dist/device/react-native/index.d.ts +4 -15
  222. package/dist/device/react-native/index.d.ts.map +1 -1
  223. package/dist/device/react-native/index.js +4 -21
  224. package/dist/device/react-native/index.js.map +1 -1
  225. package/dist/device/types.d.ts +1 -1
  226. package/dist/groups/index.d.ts +1 -1
  227. package/dist/groups/index.d.ts.map +1 -1
  228. package/dist/index.d.ts +8 -6
  229. package/dist/index.d.ts.map +1 -1
  230. package/dist/index.js +2 -1
  231. package/dist/index.js.map +1 -1
  232. package/dist/internal/crypto/ec/x25519-validation.d.ts +0 -1
  233. package/dist/internal/crypto/ec/x25519-validation.d.ts.map +1 -1
  234. package/dist/internal/crypto/ec/x25519-validation.js +0 -1
  235. package/dist/internal/crypto/ec/x25519-validation.js.map +1 -1
  236. package/dist/internal/crypto/validation.d.ts +2 -2
  237. package/dist/internal/groups/index.d.ts +1 -0
  238. package/dist/internal/groups/index.d.ts.map +1 -1
  239. package/dist/internal/groups/index.js +1 -0
  240. package/dist/internal/groups/index.js.map +1 -1
  241. package/dist/internal/groups/manager.d.ts +37 -16
  242. package/dist/internal/groups/manager.d.ts.map +1 -1
  243. package/dist/internal/groups/manager.js +46 -1
  244. package/dist/internal/groups/manager.js.map +1 -1
  245. package/dist/internal/groups/receive-record.d.ts +78 -0
  246. package/dist/internal/groups/receive-record.d.ts.map +1 -0
  247. package/dist/internal/groups/receive-record.js +43 -0
  248. package/dist/internal/groups/receive-record.js.map +1 -0
  249. package/dist/internal/groups/sdk-store.d.ts +27 -3
  250. package/dist/internal/groups/sdk-store.d.ts.map +1 -1
  251. package/dist/internal/groups/sdk-store.js +151 -19
  252. package/dist/internal/groups/sdk-store.js.map +1 -1
  253. package/dist/internal/groups/wire.d.ts +12 -1
  254. package/dist/internal/groups/wire.d.ts.map +1 -1
  255. package/dist/internal/groups/wire.js +36 -0
  256. package/dist/internal/groups/wire.js.map +1 -1
  257. package/dist/internal/manager/index.d.ts +1 -1
  258. package/dist/internal/manager/manager.d.ts +20 -19
  259. package/dist/internal/manager/manager.d.ts.map +1 -1
  260. package/dist/internal/manager/manager.js +56 -39
  261. package/dist/internal/manager/manager.js.map +1 -1
  262. package/dist/internal/protocol/double-ratchet/chains.d.ts +4 -18
  263. package/dist/internal/protocol/double-ratchet/chains.d.ts.map +1 -1
  264. package/dist/internal/protocol/double-ratchet/chains.js +23 -74
  265. package/dist/internal/protocol/double-ratchet/chains.js.map +1 -1
  266. package/dist/internal/protocol/double-ratchet/index.d.ts +1 -1
  267. package/dist/internal/protocol/double-ratchet/index.d.ts.map +1 -1
  268. package/dist/internal/protocol/double-ratchet/index.js +1 -1
  269. package/dist/internal/protocol/double-ratchet/index.js.map +1 -1
  270. package/dist/internal/protocol/double-ratchet/ratchet.d.ts +5 -7
  271. package/dist/internal/protocol/double-ratchet/ratchet.d.ts.map +1 -1
  272. package/dist/internal/protocol/double-ratchet/ratchet.js +4 -6
  273. package/dist/internal/protocol/double-ratchet/ratchet.js.map +1 -1
  274. package/dist/internal/protocol/pqxdh/pqxdh.d.ts.map +1 -1
  275. package/dist/internal/protocol/pqxdh/pqxdh.js +2 -1
  276. package/dist/internal/protocol/pqxdh/pqxdh.js.map +1 -1
  277. package/dist/internal/protocol/sealed-sender/types.d.ts +6 -8
  278. package/dist/internal/protocol/sealed-sender/types.d.ts.map +1 -1
  279. package/dist/internal/protocol/sealed-sender/types.js +8 -9
  280. package/dist/internal/protocol/sealed-sender/types.js.map +1 -1
  281. package/dist/internal/protocol/sender-keys/handoff-ledger.d.ts +110 -0
  282. package/dist/internal/protocol/sender-keys/handoff-ledger.d.ts.map +1 -0
  283. package/dist/internal/protocol/sender-keys/handoff-ledger.js +124 -0
  284. package/dist/internal/protocol/sender-keys/handoff-ledger.js.map +1 -0
  285. package/dist/internal/protocol/sender-keys/manager.d.ts +71 -62
  286. package/dist/internal/protocol/sender-keys/manager.d.ts.map +1 -1
  287. package/dist/internal/protocol/sender-keys/manager.js +228 -175
  288. package/dist/internal/protocol/sender-keys/manager.js.map +1 -1
  289. package/dist/internal/protocol/spqr/index.d.ts +2 -2
  290. package/dist/internal/protocol/spqr/index.d.ts.map +1 -1
  291. package/dist/internal/protocol/spqr/index.js +2 -2
  292. package/dist/internal/protocol/spqr/index.js.map +1 -1
  293. package/dist/internal/protocol/spqr/serialize.d.ts +9 -1
  294. package/dist/internal/protocol/spqr/serialize.d.ts.map +1 -1
  295. package/dist/internal/protocol/spqr/serialize.js +56 -16
  296. package/dist/internal/protocol/spqr/serialize.js.map +1 -1
  297. package/dist/internal/protocol/spqr/spqr.d.ts +1 -14
  298. package/dist/internal/protocol/spqr/spqr.d.ts.map +1 -1
  299. package/dist/internal/protocol/spqr/spqr.js +54 -42
  300. package/dist/internal/protocol/spqr/spqr.js.map +1 -1
  301. package/dist/internal/protocol/spqr/validate.d.ts +26 -6
  302. package/dist/internal/protocol/spqr/validate.d.ts.map +1 -1
  303. package/dist/internal/protocol/spqr/validate.js +49 -21
  304. package/dist/internal/protocol/spqr/validate.js.map +1 -1
  305. package/dist/internal/sesame/index.d.ts +1 -1
  306. package/dist/internal/sesame/index.d.ts.map +1 -1
  307. package/dist/internal/sesame/index.js.map +1 -1
  308. package/dist/internal/sesame/manager.d.ts +66 -13
  309. package/dist/internal/sesame/manager.d.ts.map +1 -1
  310. package/dist/internal/sesame/manager.js +221 -87
  311. package/dist/internal/sesame/manager.js.map +1 -1
  312. package/dist/internal/sesame/types.d.ts +95 -17
  313. package/dist/internal/sesame/types.d.ts.map +1 -1
  314. package/dist/internal/sesame/types.js +17 -0
  315. package/dist/internal/sesame/types.js.map +1 -1
  316. package/dist/internal/session/builder.d.ts +5 -5
  317. package/dist/internal/session/builder.d.ts.map +1 -1
  318. package/dist/internal/session/builder.js +12 -17
  319. package/dist/internal/session/builder.js.map +1 -1
  320. package/dist/internal/session/cipher.d.ts +13 -11
  321. package/dist/internal/session/cipher.d.ts.map +1 -1
  322. package/dist/internal/session/cipher.js +40 -22
  323. package/dist/internal/session/cipher.js.map +1 -1
  324. package/dist/internal/session/factory.d.ts +5 -5
  325. package/dist/internal/session/factory.d.ts.map +1 -1
  326. package/dist/internal/session/factory.js +4 -4
  327. package/dist/internal/session/factory.js.map +1 -1
  328. package/dist/internal/session/handshake.d.ts +14 -16
  329. package/dist/internal/session/handshake.d.ts.map +1 -1
  330. package/dist/internal/session/handshake.js +18 -75
  331. package/dist/internal/session/handshake.js.map +1 -1
  332. package/dist/internal/session/index.d.ts +1 -1
  333. package/dist/internal/session/index.js +1 -1
  334. package/dist/internal/session/record-locks.d.ts +17 -6
  335. package/dist/internal/session/record-locks.d.ts.map +1 -1
  336. package/dist/internal/session/record-locks.js +43 -7
  337. package/dist/internal/session/record-locks.js.map +1 -1
  338. package/dist/internal/session/session-resolver.d.ts +1 -1
  339. package/dist/internal/session/session-resolver.js +1 -1
  340. package/dist/internal/session/state.d.ts +2 -2
  341. package/dist/internal/session/state.js +1 -1
  342. package/dist/internal/session/types.d.ts +4 -12
  343. package/dist/internal/session/types.d.ts.map +1 -1
  344. package/dist/internal/session/types.js +1 -1
  345. package/dist/keys/generation.d.ts +2 -2
  346. package/dist/keys/generation.js +2 -2
  347. package/dist/keys/types.d.ts +5 -5
  348. package/dist/keys/types.d.ts.map +1 -1
  349. package/dist/keys/types.js +1 -1
  350. package/dist/layers.d.ts +1 -1
  351. package/dist/layers.js +2 -2
  352. package/dist/layers.js.map +1 -1
  353. package/dist/local/store/expo/adapter.d.ts.map +1 -1
  354. package/dist/local/store/expo/adapter.js +12 -8
  355. package/dist/local/store/expo/adapter.js.map +1 -1
  356. package/dist/local/store/key-value/adapter.d.ts +76 -10
  357. package/dist/local/store/key-value/adapter.d.ts.map +1 -1
  358. package/dist/local/store/key-value/adapter.js +367 -61
  359. package/dist/local/store/key-value/adapter.js.map +1 -1
  360. package/dist/local/store/key-value/backend-conformance.d.ts.map +1 -1
  361. package/dist/local/store/key-value/backend-conformance.js +74 -0
  362. package/dist/local/store/key-value/backend-conformance.js.map +1 -1
  363. package/dist/local/store/key-value/batch.d.ts +2 -0
  364. package/dist/local/store/key-value/batch.d.ts.map +1 -1
  365. package/dist/local/store/key-value/batch.js +26 -0
  366. package/dist/local/store/key-value/batch.js.map +1 -1
  367. package/dist/local/store/key-value/receive-work.d.ts +55 -0
  368. package/dist/local/store/key-value/receive-work.d.ts.map +1 -0
  369. package/dist/local/store/key-value/receive-work.js +162 -0
  370. package/dist/local/store/key-value/receive-work.js.map +1 -0
  371. package/dist/local/store/key-value/send-log.d.ts +61 -0
  372. package/dist/local/store/key-value/send-log.d.ts.map +1 -0
  373. package/dist/local/store/key-value/send-log.js +430 -0
  374. package/dist/local/store/key-value/send-log.js.map +1 -0
  375. package/dist/local/store/key-value/sender-key-handoff.d.ts +68 -0
  376. package/dist/local/store/key-value/sender-key-handoff.d.ts.map +1 -0
  377. package/dist/local/store/key-value/sender-key-handoff.js +189 -0
  378. package/dist/local/store/key-value/sender-key-handoff.js.map +1 -0
  379. package/dist/local/store/key-value/storage.d.ts +15 -0
  380. package/dist/local/store/key-value/storage.d.ts.map +1 -1
  381. package/dist/local/store/keyed-index.d.ts +23 -0
  382. package/dist/local/store/keyed-index.d.ts.map +1 -0
  383. package/dist/local/store/keyed-index.js +41 -0
  384. package/dist/local/store/keyed-index.js.map +1 -0
  385. package/dist/local/store/memory/adapter.d.ts +44 -12
  386. package/dist/local/store/memory/adapter.d.ts.map +1 -1
  387. package/dist/local/store/memory/adapter.js +197 -46
  388. package/dist/local/store/memory/adapter.js.map +1 -1
  389. package/dist/local/store/memory/send-log.d.ts +42 -0
  390. package/dist/local/store/memory/send-log.d.ts.map +1 -0
  391. package/dist/local/store/memory/send-log.js +190 -0
  392. package/dist/local/store/memory/send-log.js.map +1 -0
  393. package/dist/local/store/node/adapter.d.ts.map +1 -1
  394. package/dist/local/store/node/adapter.js +8 -6
  395. package/dist/local/store/node/adapter.js.map +1 -1
  396. package/dist/local/store/react-native/adapter.d.ts.map +1 -1
  397. package/dist/local/store/react-native/adapter.js +12 -8
  398. package/dist/local/store/react-native/adapter.js.map +1 -1
  399. package/dist/local/store/receive-work.d.ts +87 -0
  400. package/dist/local/store/receive-work.d.ts.map +1 -0
  401. package/dist/local/store/receive-work.js +204 -0
  402. package/dist/local/store/receive-work.js.map +1 -0
  403. package/dist/local/store/received-content.d.ts +3 -3
  404. package/dist/local/store/received-content.d.ts.map +1 -1
  405. package/dist/local/store/received-content.js +2 -11
  406. package/dist/local/store/received-content.js.map +1 -1
  407. package/dist/local/store/reliability.d.ts +411 -14
  408. package/dist/local/store/reliability.d.ts.map +1 -1
  409. package/dist/local/store/reliability.js +532 -58
  410. package/dist/local/store/reliability.js.map +1 -1
  411. package/dist/local/store/send-log-order.d.ts +15 -0
  412. package/dist/local/store/send-log-order.d.ts.map +1 -0
  413. package/dist/local/store/send-log-order.js +24 -0
  414. package/dist/local/store/send-log-order.js.map +1 -0
  415. package/dist/local/store/sender-key-handoff-index.d.ts +38 -0
  416. package/dist/local/store/sender-key-handoff-index.d.ts.map +1 -0
  417. package/dist/local/store/sender-key-handoff-index.js +101 -0
  418. package/dist/local/store/sender-key-handoff-index.js.map +1 -0
  419. package/dist/local/store/sender-key-handoff-table.d.ts +29 -0
  420. package/dist/local/store/sender-key-handoff-table.d.ts.map +1 -0
  421. package/dist/local/store/sender-key-handoff-table.js +97 -0
  422. package/dist/local/store/sender-key-handoff-table.js.map +1 -0
  423. package/dist/local/store/sqlite/encryption.d.ts +8 -1
  424. package/dist/local/store/sqlite/encryption.d.ts.map +1 -1
  425. package/dist/local/store/sqlite/encryption.js +9 -0
  426. package/dist/local/store/sqlite/encryption.js.map +1 -1
  427. package/dist/local/store/sqlite/key-storage/index.d.ts +25 -4
  428. package/dist/local/store/sqlite/key-storage/index.d.ts.map +1 -1
  429. package/dist/local/store/sqlite/key-storage/index.js +68 -7
  430. package/dist/local/store/sqlite/key-storage/index.js.map +1 -1
  431. package/dist/local/store/sqlite/key-storage/message-records.d.ts +16 -4
  432. package/dist/local/store/sqlite/key-storage/message-records.d.ts.map +1 -1
  433. package/dist/local/store/sqlite/key-storage/message-records.js +49 -6
  434. package/dist/local/store/sqlite/key-storage/message-records.js.map +1 -1
  435. package/dist/local/store/sqlite/key-storage/metadata.d.ts +8 -7
  436. package/dist/local/store/sqlite/key-storage/metadata.d.ts.map +1 -1
  437. package/dist/local/store/sqlite/key-storage/metadata.js +17 -15
  438. package/dist/local/store/sqlite/key-storage/metadata.js.map +1 -1
  439. package/dist/local/store/sqlite/key-storage/receive-work.d.ts +27 -0
  440. package/dist/local/store/sqlite/key-storage/receive-work.d.ts.map +1 -0
  441. package/dist/local/store/sqlite/key-storage/receive-work.js +98 -0
  442. package/dist/local/store/sqlite/key-storage/receive-work.js.map +1 -0
  443. package/dist/local/store/sqlite/key-storage/send-log.d.ts +27 -0
  444. package/dist/local/store/sqlite/key-storage/send-log.d.ts.map +1 -0
  445. package/dist/local/store/sqlite/key-storage/send-log.js +178 -0
  446. package/dist/local/store/sqlite/key-storage/send-log.js.map +1 -0
  447. package/dist/local/store/sqlite/key-storage/sender-key-handoff.d.ts +27 -0
  448. package/dist/local/store/sqlite/key-storage/sender-key-handoff.d.ts.map +1 -0
  449. package/dist/local/store/sqlite/key-storage/sender-key-handoff.js +75 -0
  450. package/dist/local/store/sqlite/key-storage/sender-key-handoff.js.map +1 -0
  451. package/dist/local/store/sqlite/key-storage/session-trust.d.ts +2 -2
  452. package/dist/local/store/sqlite/key-storage/session-trust.js +5 -5
  453. package/dist/local/store/sqlite/key-storage/session-trust.js.map +1 -1
  454. package/dist/local/store/sqlite/migrations.d.ts.map +1 -1
  455. package/dist/local/store/sqlite/migrations.js +101 -0
  456. package/dist/local/store/sqlite/migrations.js.map +1 -1
  457. package/dist/local/store/sqlite/models/index.d.ts +2 -1
  458. package/dist/local/store/sqlite/models/index.d.ts.map +1 -1
  459. package/dist/local/store/sqlite/models/index.js +5 -1
  460. package/dist/local/store/sqlite/models/index.js.map +1 -1
  461. package/dist/local/store/sqlite/models/message-record.d.ts +15 -0
  462. package/dist/local/store/sqlite/models/message-record.d.ts.map +1 -1
  463. package/dist/local/store/sqlite/models/message-record.js +24 -0
  464. package/dist/local/store/sqlite/models/message-record.js.map +1 -1
  465. package/dist/local/store/sqlite/models/send-log.d.ts +51 -0
  466. package/dist/local/store/sqlite/models/send-log.d.ts.map +1 -0
  467. package/dist/local/store/sqlite/models/send-log.js +206 -0
  468. package/dist/local/store/sqlite/models/send-log.js.map +1 -0
  469. package/dist/local/store/sqlite/open-store.d.ts +9 -1
  470. package/dist/local/store/sqlite/open-store.d.ts.map +1 -1
  471. package/dist/local/store/sqlite/open-store.js +20 -1
  472. package/dist/local/store/sqlite/open-store.js.map +1 -1
  473. package/dist/local/store/sqlite/schema.d.ts +34 -1
  474. package/dist/local/store/sqlite/schema.d.ts.map +1 -1
  475. package/dist/local/store/sqlite/schema.js +14 -0
  476. package/dist/local/store/sqlite/schema.js.map +1 -1
  477. package/dist/local/store/sqlite/store.d.ts +61 -11
  478. package/dist/local/store/sqlite/store.d.ts.map +1 -1
  479. package/dist/local/store/sqlite/store.js +191 -27
  480. package/dist/local/store/sqlite/store.js.map +1 -1
  481. package/dist/local/store/web/adapter.d.ts +76 -8
  482. package/dist/local/store/web/adapter.d.ts.map +1 -1
  483. package/dist/local/store/web/adapter.js +579 -127
  484. package/dist/local/store/web/adapter.js.map +1 -1
  485. package/dist/local/store/web/receive-work.d.ts +57 -0
  486. package/dist/local/store/web/receive-work.d.ts.map +1 -0
  487. package/dist/local/store/web/receive-work.js +99 -0
  488. package/dist/local/store/web/receive-work.js.map +1 -0
  489. package/dist/local/store/web/send-log.d.ts +92 -0
  490. package/dist/local/store/web/send-log.d.ts.map +1 -0
  491. package/dist/local/store/web/send-log.js +267 -0
  492. package/dist/local/store/web/send-log.js.map +1 -0
  493. package/dist/local/store/web/sender-key-handoff.d.ts +81 -0
  494. package/dist/local/store/web/sender-key-handoff.d.ts.map +1 -0
  495. package/dist/local/store/web/sender-key-handoff.js +156 -0
  496. package/dist/local/store/web/sender-key-handoff.js.map +1 -0
  497. package/dist/local/store/web-sqlite/adapter.d.ts +2 -0
  498. package/dist/local/store/web-sqlite/adapter.d.ts.map +1 -1
  499. package/dist/local/store/web-sqlite/adapter.js +12 -6
  500. package/dist/local/store/web-sqlite/adapter.js.map +1 -1
  501. package/dist/local/vault/custody.d.ts +8 -0
  502. package/dist/local/vault/custody.d.ts.map +1 -0
  503. package/dist/local/vault/custody.js +9 -0
  504. package/dist/local/vault/custody.js.map +1 -0
  505. package/dist/local/vault/electron-safe-storage.d.ts +3 -1
  506. package/dist/local/vault/electron-safe-storage.d.ts.map +1 -1
  507. package/dist/local/vault/electron-safe-storage.js +2 -0
  508. package/dist/local/vault/electron-safe-storage.js.map +1 -1
  509. package/dist/local/vault/expo-secure-store.d.ts +3 -1
  510. package/dist/local/vault/expo-secure-store.d.ts.map +1 -1
  511. package/dist/local/vault/expo-secure-store.js +2 -0
  512. package/dist/local/vault/expo-secure-store.js.map +1 -1
  513. package/dist/local/vault/indexed-db.d.ts +3 -1
  514. package/dist/local/vault/indexed-db.d.ts.map +1 -1
  515. package/dist/local/vault/indexed-db.js +2 -0
  516. package/dist/local/vault/indexed-db.js.map +1 -1
  517. package/dist/local/vault/react-native-keychain.d.ts +3 -1
  518. package/dist/local/vault/react-native-keychain.d.ts.map +1 -1
  519. package/dist/local/vault/react-native-keychain.js +2 -0
  520. package/dist/local/vault/react-native-keychain.js.map +1 -1
  521. package/dist/remote/relay/device-set.d.ts +94 -0
  522. package/dist/remote/relay/device-set.d.ts.map +1 -0
  523. package/dist/remote/relay/device-set.js +156 -0
  524. package/dist/remote/relay/device-set.js.map +1 -0
  525. package/dist/remote/relay/types.d.ts +104 -110
  526. package/dist/remote/relay/types.d.ts.map +1 -1
  527. package/dist/safety/core.d.ts +15 -6
  528. package/dist/safety/core.d.ts.map +1 -1
  529. package/dist/safety/core.js +41 -27
  530. package/dist/safety/core.js.map +1 -1
  531. package/dist/safety/index.d.ts +2 -1
  532. package/dist/safety/index.d.ts.map +1 -1
  533. package/dist/safety/index.js +12 -18
  534. package/dist/safety/index.js.map +1 -1
  535. package/dist/types/api.d.ts +707 -62
  536. package/dist/types/api.d.ts.map +1 -1
  537. package/dist/types/errors.d.ts +14 -33
  538. package/dist/types/errors.d.ts.map +1 -1
  539. package/dist/types/errors.js +14 -24
  540. package/dist/types/errors.js.map +1 -1
  541. package/dist/types/messages.d.ts +2 -2
  542. package/dist/types/messages.js +1 -1
  543. package/dist/types/protocol-config.d.ts +175 -42
  544. package/dist/types/protocol-config.d.ts.map +1 -1
  545. package/dist/types/protocol-config.js +19 -38
  546. package/dist/types/protocol-config.js.map +1 -1
  547. package/dist/types/protocol-constants.d.ts +6 -6
  548. package/dist/types/protocol-constants.js +6 -6
  549. package/dist/types/session.d.ts +7 -7
  550. package/dist/types/session.d.ts.map +1 -1
  551. package/dist/types/session.js +39 -21
  552. package/dist/types/session.js.map +1 -1
  553. package/dist/username/link.d.ts +2 -2
  554. package/dist/username/link.js +2 -2
  555. package/dist/utils/origin-lock.d.ts +45 -0
  556. package/dist/utils/origin-lock.d.ts.map +1 -0
  557. package/dist/utils/origin-lock.js +80 -0
  558. package/dist/utils/origin-lock.js.map +1 -0
  559. package/dist/utils/retry.d.ts +2 -0
  560. package/dist/utils/retry.d.ts.map +1 -1
  561. package/dist/utils/retry.js +7 -0
  562. package/dist/utils/retry.js.map +1 -1
  563. package/docs/ASSURANCE.md +6 -6
  564. package/docs/CLIENT_COMPOSITION.md +2 -2
  565. package/docs/DEVIATIONS.md +677 -182
  566. package/docs/E2EE.md +1 -1
  567. package/docs/ERROR_HANDLING.md +235 -2
  568. package/docs/GETTING_STARTED.md +7 -4
  569. package/docs/INTERFACES.md +1 -1
  570. package/docs/PACKAGE_SURFACE.md +6 -5
  571. package/docs/PROTOCOL_POLICY.md +102 -22
  572. package/docs/RECIPES.md +3 -15
  573. package/docs/SECURITY.md +90 -5
  574. package/keys/README.md +3 -3
  575. package/local/store/README.md +78 -14
  576. package/local/store/key-value/README.md +14 -3
  577. package/local/store/node/README.md +8 -3
  578. package/local/store/web/README.md +9 -0
  579. package/local/store/web-sqlite/README.md +14 -2
  580. package/local/vault/README.md +21 -0
  581. package/package.json +1 -6
  582. package/remote/README.md +0 -1
  583. package/remote/relay/README.md +2 -2
  584. package/dist/device/provisioning.d.ts +0 -242
  585. package/dist/device/provisioning.d.ts.map +0 -1
  586. package/dist/device/provisioning.js +0 -421
  587. package/dist/device/provisioning.js.map +0 -1
  588. package/dist/internal/protocol/x3dh/index.d.ts +0 -15
  589. package/dist/internal/protocol/x3dh/index.d.ts.map +0 -1
  590. package/dist/internal/protocol/x3dh/index.js +0 -13
  591. package/dist/internal/protocol/x3dh/index.js.map +0 -1
  592. package/dist/internal/protocol/x3dh/x3dh.d.ts +0 -131
  593. package/dist/internal/protocol/x3dh/x3dh.d.ts.map +0 -1
  594. package/dist/internal/protocol/x3dh/x3dh.js +0 -261
  595. package/dist/internal/protocol/x3dh/x3dh.js.map +0 -1
@@ -1,421 +0,0 @@
1
- /**
2
- * Device Provisioning Manager
3
- *
4
- * Implements Signal Protocol's device linking flow:
5
- * 1. Primary device generates ephemeral key pair and QR code
6
- * 2. New device scans QR code and generates own ephemeral key pair
7
- * 3. Both devices perform ECDH key agreement to establish shared secret
8
- * 4. Primary device encrypts provisioned identity keys with shared secret
9
- * 5. New device decrypts and stores those identities, then initializes
10
- *
11
- * Security Properties:
12
- * - Physical proximity authentication (QR code)
13
- * - Ephemeral ECDH key agreement (forward secrecy)
14
- * - AES-256-GCM encryption
15
- * - 5-minute session TTL
16
- * - Account identity sharing (not full backup)
17
- * - The provisioning service carries only encrypted key material
18
- *
19
- * Differences from Device Transfer:
20
- * - Shares identity key only (not full backup with sessions)
21
- * - Adds new device (does not migrate/wipe old device)
22
- * - Multiple devices remain active
23
- *
24
- * This module is platform-free on purpose. The device's own description arrives
25
- * as a `LocalDeviceMetadata` parameter, so nothing here needs to ask a platform
26
- * what it is running on. The `./expo` module supplies that for Expo
27
- * hosts.
28
- */
29
- import * as crypto from '../internal/crypto/index.js';
30
- import { parseUrl, queryValues } from '../internal/platform/index.js';
31
- import { resolveSignalProtocolLogger } from '../logger.js';
32
- import { asBase64 } from '../types/utils.js';
33
- import { DEVICE_ID_KEY, LOCAL_IDENTITY_KEY } from './constants.js';
34
- import { encryptDeviceName } from './device-name-crypto.js';
35
- // ============================================================================
36
- // Primary Device Flow
37
- // ============================================================================
38
- const DEFAULT_PROVISIONING_IDENTITY_TYPES = ['aci', 'pni'];
39
- function toProvisionedIdentityKeyPair(identityKey) {
40
- return {
41
- dhPublicKey: identityKey.dhKey.publicKey,
42
- dhPrivateKey: identityKey.dhKey.privateKey,
43
- signingPublicKey: identityKey.signingKey.publicKey,
44
- signingPrivateKey: identityKey.signingKey.privateKey,
45
- registrationId: identityKey.registrationId,
46
- };
47
- }
48
- function fromProvisionedIdentityKeyPair(identityKey) {
49
- return {
50
- dhKey: {
51
- publicKey: asBase64(identityKey.dhPublicKey),
52
- privateKey: asBase64(identityKey.dhPrivateKey),
53
- },
54
- signingKey: {
55
- publicKey: asBase64(identityKey.signingPublicKey),
56
- privateKey: asBase64(identityKey.signingPrivateKey),
57
- },
58
- registrationId: identityKey.registrationId,
59
- };
60
- }
61
- async function collectProvisioningIdentityKeys(identityStore, explicitIdentityTypes) {
62
- const requestedIdentityTypes = explicitIdentityTypes ?? DEFAULT_PROVISIONING_IDENTITY_TYPES;
63
- const identityKeys = {};
64
- for (const identityType of requestedIdentityTypes) {
65
- const identityKey = await identityStore.getIdentityKey(identityType);
66
- if (!identityKey) {
67
- if (identityType === 'aci' || explicitIdentityTypes) {
68
- throw new Error(`Identity key not found for primary device (${identityType})`);
69
- }
70
- continue;
71
- }
72
- identityKeys[identityType] = toProvisionedIdentityKeyPair(identityKey);
73
- }
74
- if (!identityKeys.aci) {
75
- throw new Error('Provisioning requires an ACI identity key');
76
- }
77
- return identityKeys;
78
- }
79
- /**
80
- * Default custom URL scheme prefix for device-linking QR codes, targeting the
81
- * `signalprotocol://` scheme. Override per call via the `linkPrefix` parameter.
82
- */
83
- export const DEFAULT_PROVISIONING_LINK_PREFIX = 'signalprotocol://link-device';
84
- /**
85
- * Generate QR Code for Device Linking (Primary Device)
86
- *
87
- * Creates a provisioning session and generates QR code data.
88
- * The QR code contains the session ID and ephemeral public key.
89
- *
90
- * @param relay - Provisioning service interface
91
- * @param userId - Current user ID
92
- * @param providedLogger - Optional logger
93
- * @param linkPrefix - Custom scheme prefix (defaults to {@link DEFAULT_PROVISIONING_LINK_PREFIX})
94
- * @returns QR code URL and ephemeral key pair
95
- */
96
- export async function generateProvisioningQR(relay, userId, providedLogger, linkPrefix = DEFAULT_PROVISIONING_LINK_PREFIX) {
97
- const logger = resolveSignalProtocolLogger(providedLogger);
98
- try {
99
- // Generate ephemeral ECDH key pair
100
- const ephemeralKeyPair = await crypto.generateECDHKeyPair();
101
- // Create provisioning session on backend
102
- const { sessionId } = await relay.createProvisioningSession(userId, ephemeralKeyPair.publicKey);
103
- // Build QR code URL
104
- // URL-encode the base64 key to handle +, /, and = characters
105
- const qrCodeUrl = `${linkPrefix}?session=${encodeURIComponent(sessionId)}&key=${encodeURIComponent(ephemeralKeyPair.publicKey)}`;
106
- logger.info('[Provisioning] QR code generated', { sessionId });
107
- return {
108
- qrCodeUrl,
109
- sessionId,
110
- ephemeralKeyPair,
111
- };
112
- }
113
- catch (error) {
114
- logger.error('[Provisioning] Failed to generate QR code', error);
115
- throw error;
116
- }
117
- }
118
- /**
119
- * Send Provisioning Payload to New Device (Primary Device)
120
- *
121
- * Called after new device connects to provisioning session.
122
- * Encrypts and sends all provisioned identity keys to the new device.
123
- *
124
- * @param relay - Provisioning service interface
125
- * @param userProfile - User profile data (name, username, avatarUrl)
126
- * @param sessionId - Provisioning session ID
127
- * @param ephemeralPrivateKey - Primary's ephemeral private key
128
- * @param newDeviceEphemeralPublicKey - New device's ephemeral public key
129
- * @param userId - User ID
130
- */
131
- export async function provisionDevice(relay, userProfile, sessionId, ephemeralPrivateKey, newDeviceEphemeralPublicKey, userId, options) {
132
- const logger = resolveSignalProtocolLogger(options.logger);
133
- try {
134
- const identityKeys = await collectProvisioningIdentityKeys(options.identityStore, options.identityTypes);
135
- // Gather group master keys for cross-device sync
136
- const groupKeys = options.groupStateStore
137
- ? await options.groupStateStore.getAllMasterKeys()
138
- : [];
139
- // Build provisioning message
140
- const provisioningMessage = {
141
- identityKeys,
142
- userId,
143
- userProfile: {
144
- name: userProfile.name,
145
- username: userProfile.username,
146
- usernameLink: userProfile.usernameLink ?? undefined,
147
- },
148
- groupMasterKeys: groupKeys.length > 0 ? groupKeys : undefined,
149
- };
150
- // Derive shared secret using ECDH
151
- const sharedSecret = await crypto.computeSharedSecret(asBase64(ephemeralPrivateKey), asBase64(newDeviceEphemeralPublicKey));
152
- // Derive encryption key from shared secret using HKDF
153
- const encryptionKey = await crypto.hkdf(sharedSecret, new Uint8Array(32), // salt
154
- crypto.stringToBytes('DeviceProvisioning'), 32 // key length
155
- );
156
- // Encrypt provisioning message with AES-256-GCM
157
- const plaintextBytes = crypto.stringToBytes(JSON.stringify(provisioningMessage));
158
- const encrypted = await crypto.aesGcmEncrypt(encryptionKey, plaintextBytes);
159
- // Send encrypted message to backend
160
- await relay.sendProvisioningMessage(sessionId, JSON.stringify(encrypted), userId);
161
- logger.info('[Provisioning] Identities sent to new device', {
162
- sessionId,
163
- identityTypes: Object.keys(identityKeys),
164
- });
165
- // Wipe ephemeral keys for security
166
- // Note: ephemeralPrivateKey is Base64 string, cannot be securely zeroed
167
- crypto.secureZeroBytes(sharedSecret);
168
- crypto.secureZeroBytes(encryptionKey);
169
- }
170
- catch (error) {
171
- logger.error('[Provisioning] Failed to provision device', error);
172
- throw error;
173
- }
174
- }
175
- // ============================================================================
176
- // New Device Flow
177
- // ============================================================================
178
- /**
179
- * Parse Provisioning QR Code (New Device)
180
- *
181
- * Extracts session ID and ephemeral public key from QR code URL.
182
- *
183
- * @param qrCodeData - QR code data (URL format)
184
- * @returns Session ID and primary's ephemeral public key (Base64)
185
- */
186
- export function parseProvisioningQR(qrCodeData, providedLogger, linkPrefix = DEFAULT_PROVISIONING_LINK_PREFIX) {
187
- const logger = resolveSignalProtocolLogger(providedLogger);
188
- try {
189
- // Parse URL: signalprotocol://link-device?session=xxx&key=xxx
190
- const url = parseUrl(qrCodeData);
191
- const expected = parseUrl(linkPrefix);
192
- if (url.protocol !== expected.protocol ||
193
- url.hostname !== expected.hostname ||
194
- url.port !== expected.port ||
195
- url.pathname !== expected.pathname) {
196
- throw new Error('Invalid provisioning QR code prefix');
197
- }
198
- const sessionId = queryValues(url, 'session')[0];
199
- const keyBase64 = queryValues(url, 'key')[0];
200
- if (!sessionId || !keyBase64) {
201
- throw new Error('Invalid provisioning QR code: missing session or key');
202
- }
203
- let decodedKey;
204
- try {
205
- decodedKey = crypto.base64ToBytes(asBase64(keyBase64));
206
- }
207
- catch {
208
- throw new Error('Invalid provisioning QR code key');
209
- }
210
- if (decodedKey.length !== 32 || crypto.bytesToBase64(decodedKey) !== keyBase64) {
211
- throw new Error('Invalid provisioning QR code key: expected 32-byte X25519 key');
212
- }
213
- return {
214
- sessionId,
215
- primaryEphemeralPublicKey: keyBase64,
216
- };
217
- }
218
- catch (error) {
219
- logger.error('[Provisioning] Failed to parse QR code', error);
220
- throw new Error('Invalid provisioning QR code format');
221
- }
222
- }
223
- /**
224
- * Connect to Provisioning Session (New Device)
225
- *
226
- * Generates ephemeral key pair and connects to provisioning session.
227
- *
228
- * @param relay - Provisioning service interface
229
- * @param sessionId - Provisioning session ID
230
- * @param deviceMetadata - New device metadata
231
- * @returns Ephemeral key pair for decryption
232
- */
233
- export async function connectToProvisioningSession(relay, sessionId, deviceMetadata, providedLogger) {
234
- const logger = resolveSignalProtocolLogger(providedLogger);
235
- try {
236
- // Generate ephemeral key pair
237
- const ephemeralKeyPair = await crypto.generateECDHKeyPair();
238
- // Connect to provisioning session
239
- await relay.connectNewDevice(sessionId, ephemeralKeyPair.publicKey, toProvisioningConnectionMetadata(deviceMetadata));
240
- logger.info('[Provisioning] Connected to session', { sessionId });
241
- return ephemeralKeyPair;
242
- }
243
- catch (error) {
244
- logger.error('[Provisioning] Failed to connect', error);
245
- throw error;
246
- }
247
- }
248
- /**
249
- * Receive Provisioning Message (New Device)
250
- *
251
- * Polls for and decrypts provisioning message from primary device.
252
- * Finalizes the server-side device link, then stores the received bootstrap
253
- * state in the caller-provided Signal Protocol key store.
254
- *
255
- * @param relay - Provisioning service interface
256
- * @param sessionId - Provisioning session ID
257
- * @param ephemeralPrivateKey - New device's ephemeral private key
258
- * @param primaryEphemeralPublicKey - Primary device's ephemeral public key
259
- * @returns Provisioning message with identity keys and user info
260
- */
261
- export async function receiveProvisioningMessage(relay, sessionId, ephemeralPrivateKey, primaryEphemeralPublicKey, options) {
262
- const logger = resolveSignalProtocolLogger(options.logger);
263
- const storedIdentityTypes = [];
264
- const storedGroupIds = [];
265
- let storedDeviceId = false;
266
- let storedLocalIdentity = false;
267
- let storedUsernameState = false;
268
- let serverLinkedDeviceId = null;
269
- const rollbackLocalProvisioningState = async () => {
270
- for (const identityType of storedIdentityTypes.slice().reverse()) {
271
- await options.identityStore.deleteIdentityKey(identityType);
272
- }
273
- if (storedLocalIdentity && options.localStateStore) {
274
- await options.localStateStore.deleteItemAsync(LOCAL_IDENTITY_KEY);
275
- }
276
- if (storedDeviceId && options.localStateStore) {
277
- await options.localStateStore.deleteItemAsync(DEVICE_ID_KEY);
278
- }
279
- if (storedUsernameState && options.usernameStateStore) {
280
- await options.usernameStateStore.clearUsernameState();
281
- }
282
- for (const groupId of storedGroupIds.slice().reverse()) {
283
- await options.groupStateStore?.deleteMasterKey(groupId);
284
- }
285
- };
286
- let sharedSecret = null;
287
- let decryptionKey = null;
288
- try {
289
- // Poll for provisioning message
290
- const result = await relay.getProvisioningMessage(sessionId);
291
- if (result.status !== 'ready' || !result.message) {
292
- throw new Error(`Provisioning message not ready: ${result.status}`);
293
- }
294
- // Parse encrypted message
295
- const encrypted = JSON.parse(result.message);
296
- // Derive shared secret (same as primary device)
297
- sharedSecret = await crypto.computeSharedSecret(asBase64(ephemeralPrivateKey), asBase64(primaryEphemeralPublicKey));
298
- // Derive decryption key (same as primary device)
299
- decryptionKey = await crypto.hkdf(sharedSecret, new Uint8Array(32), crypto.stringToBytes('DeviceProvisioning'), 32);
300
- // Decrypt provisioning message
301
- const plaintextBytes = await crypto.aesGcmDecrypt(decryptionKey, encrypted.ciphertext, encrypted.iv, encrypted.authTag);
302
- const provisioningPayload = JSON.parse(crypto.bytesToString(plaintextBytes));
303
- const aciIdentityKey = provisioningPayload.identityKeys.aci;
304
- if (!aciIdentityKey) {
305
- throw new Error('Provisioning message missing ACI identity key');
306
- }
307
- const encryptedDeviceName = await encryptDeviceName(options.deviceMetadata.deviceName, asBase64(aciIdentityKey.dhPublicKey));
308
- // Finalize the server-side link before mutating local Signal Protocol state.
309
- const completion = await relay.completeProvisioning(sessionId, {
310
- encryptedDeviceName,
311
- platform: options.deviceMetadata.platform,
312
- appVersion: options.deviceMetadata.appVersion,
313
- osVersion: options.deviceMetadata.osVersion,
314
- });
315
- serverLinkedDeviceId = completion.deviceId;
316
- for (const identityType of DEFAULT_PROVISIONING_IDENTITY_TYPES) {
317
- const identityKey = provisioningPayload.identityKeys[identityType];
318
- if (!identityKey) {
319
- continue;
320
- }
321
- await options.identityStore.storeIdentityKey(fromProvisionedIdentityKeyPair(identityKey), identityType);
322
- storedIdentityTypes.push(identityType);
323
- }
324
- if (options.localStateStore) {
325
- await options.localStateStore.setItemAsync(DEVICE_ID_KEY, completion.deviceId.toString());
326
- storedDeviceId = true;
327
- await options.localStateStore.setItemAsync(LOCAL_IDENTITY_KEY, aciIdentityKey.dhPublicKey);
328
- storedLocalIdentity = true;
329
- }
330
- if (options.usernameStateStore) {
331
- await options.usernameStateStore.setUsernameState({
332
- fullUsername: provisioningPayload.userProfile.username ?? null,
333
- usernameLink: provisioningPayload.userProfile.usernameLink ?? null,
334
- });
335
- storedUsernameState = true;
336
- }
337
- if (provisioningPayload.groupMasterKeys && options.groupStateStore) {
338
- for (const entry of provisioningPayload.groupMasterKeys) {
339
- const keyBytes = crypto.base64ToBytes(asBase64(entry.masterKey));
340
- await options.groupStateStore.storeMasterKey(entry.groupId, keyBytes);
341
- crypto.secureZeroBytes(keyBytes);
342
- storedGroupIds.push(entry.groupId);
343
- }
344
- logger.info('[Provisioning] Stored group master keys', {
345
- count: provisioningPayload.groupMasterKeys.length,
346
- });
347
- }
348
- await relay.acknowledgeProvisioning(sessionId);
349
- logger.info('[Provisioning] Provisioned identities stored after server link', {
350
- deviceId: completion.deviceId,
351
- identityTypes: storedIdentityTypes,
352
- });
353
- return {
354
- ...provisioningPayload,
355
- deviceId: completion.deviceId,
356
- };
357
- }
358
- catch (error) {
359
- if (serverLinkedDeviceId !== null) {
360
- try {
361
- await relay.rollbackProvisioning(sessionId);
362
- }
363
- catch (rollbackError) {
364
- logger.error('[Provisioning] Failed to roll back server-side provisioning', rollbackError);
365
- }
366
- }
367
- if (storedIdentityTypes.length > 0 ||
368
- storedGroupIds.length > 0 ||
369
- storedDeviceId ||
370
- storedLocalIdentity ||
371
- storedUsernameState) {
372
- try {
373
- await rollbackLocalProvisioningState();
374
- }
375
- catch (rollbackError) {
376
- logger.error('[Provisioning] Failed to roll back local provisioning state', rollbackError);
377
- }
378
- }
379
- logger.error('[Provisioning] Failed to receive provisioning message', error);
380
- throw error;
381
- }
382
- finally {
383
- if (sharedSecret) {
384
- crypto.secureZeroBytes(sharedSecret);
385
- }
386
- if (decryptionKey) {
387
- crypto.secureZeroBytes(decryptionKey);
388
- }
389
- // Note: ephemeralPrivateKey is a Base64 string that will be garbage collected
390
- }
391
- }
392
- // ============================================================================
393
- // Utilities
394
- // ============================================================================
395
- function toProvisioningConnectionMetadata(metadata) {
396
- return {
397
- platform: metadata.platform,
398
- appVersion: metadata.appVersion,
399
- osVersion: metadata.osVersion,
400
- };
401
- }
402
- /**
403
- * Cancel Provisioning Session
404
- *
405
- * Deletes provisioning session and cleans up.
406
- *
407
- * @param relay - Provisioning service interface
408
- * @param sessionId - Session ID to cancel
409
- */
410
- export async function cancelProvisioning(relay, sessionId, userId, providedLogger) {
411
- const logger = resolveSignalProtocolLogger(providedLogger);
412
- try {
413
- await relay.deleteProvisioningSession(sessionId, userId);
414
- logger.info('[Provisioning] Session cancelled', { sessionId });
415
- }
416
- catch (error) {
417
- logger.error('[Provisioning] Failed to cancel session', error);
418
- // Do not throw - cleanup is best-effort
419
- }
420
- }
421
- //# sourceMappingURL=provisioning.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"provisioning.js","sourceRoot":"","sources":["../../device/provisioning.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,EAAE,2BAA2B,EAAe,MAAM,WAAW,CAAC;AAErE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAiJzD,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E,MAAM,mCAAmC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAU,CAAC;AAIpE,SAAS,4BAA4B,CAAC,WAA4B;IAChE,OAAO;QACL,WAAW,EAAE,WAAW,CAAC,KAAK,CAAC,SAAS;QACxC,YAAY,EAAE,WAAW,CAAC,KAAK,CAAC,UAAU;QAC1C,gBAAgB,EAAE,WAAW,CAAC,UAAU,CAAC,SAAS;QAClD,iBAAiB,EAAE,WAAW,CAAC,UAAU,CAAC,UAAU;QACpD,cAAc,EAAE,WAAW,CAAC,cAAc;KAC3C,CAAC;AACJ,CAAC;AAED,SAAS,8BAA8B,CAAC,WAAuC;IAC7E,OAAO;QACL,KAAK,EAAE;YACL,SAAS,EAAE,QAAQ,CAAC,WAAW,CAAC,WAAW,CAA0C;YACrF,UAAU,EAAE,QAAQ,CAAC,WAAW,CAAC,YAAY,CAA2C;SACzF;QACD,UAAU,EAAE;YACV,SAAS,EAAE,QAAQ,CACjB,WAAW,CAAC,gBAAgB,CACiB;YAC/C,UAAU,EAAE,QAAQ,CAClB,WAAW,CAAC,iBAAiB,CACiB;SACjD;QACD,cAAc,EAAE,WAAW,CAAC,cAAc;KAC3C,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,+BAA+B,CAC5C,aAAwC,EACxC,qBAA+C;IAE/C,MAAM,sBAAsB,GAAG,qBAAqB,IAAI,mCAAmC,CAAC;IAC5F,MAAM,YAAY,GAAwC,EAAE,CAAC;IAE7D,KAAK,MAAM,YAAY,IAAI,sBAAsB,EAAE,CAAC;QAClD,MAAM,WAAW,GAAG,MAAM,aAAa,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;QACrE,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,IAAI,YAAY,KAAK,KAAK,IAAI,qBAAqB,EAAE,CAAC;gBACpD,MAAM,IAAI,KAAK,CAAC,8CAA8C,YAAY,GAAG,CAAC,CAAC;YACjF,CAAC;YACD,SAAS;QACX,CAAC;QAED,YAAY,CAAC,YAAY,CAAC,GAAG,4BAA4B,CAAC,WAAW,CAAC,CAAC;IACzE,CAAC;IAED,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,8BAA8B,CAAC;AAE/E;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,KAA0B,EAC1B,MAAc,EACd,cAAuB,EACvB,UAAU,GAAW,gCAAgC;IAMrD,MAAM,MAAM,GAAG,2BAA2B,CAAC,cAAc,CAAC,CAAC;IAC3D,IAAI,CAAC;QACH,mCAAmC;QACnC,MAAM,gBAAgB,GAAG,MAAM,MAAM,CAAC,mBAAmB,EAAE,CAAC;QAE5D,yCAAyC;QACzC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,KAAK,CAAC,yBAAyB,CAAC,MAAM,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAEhG,oBAAoB;QACpB,6DAA6D;QAC7D,MAAM,SAAS,GAAG,GAAG,UAAU,YAAY,kBAAkB,CAAC,SAAS,CAAC,QAAQ,kBAAkB,CAAC,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC;QAEjI,MAAM,CAAC,IAAI,CAAC,kCAAkC,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QAE/D,OAAO;YACL,SAAS;YACT,SAAS;YACT,gBAAgB;SACjB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,2CAA2C,EAAE,KAAK,CAAC,CAAC;QACjE,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAA0B,EAC1B,WAAwB,EACxB,SAAiB,EACjB,mBAA2B,EAC3B,2BAAmC,EACnC,MAAc,EACd,OAAgC;IAEhC,MAAM,MAAM,GAAG,2BAA2B,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3D,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,MAAM,+BAA+B,CACxD,OAAO,CAAC,aAAa,EACrB,OAAO,CAAC,aAAa,CACtB,CAAC;QAEF,iDAAiD;QACjD,MAAM,SAAS,GAAG,OAAO,CAAC,eAAe;YACvC,CAAC,CAAC,MAAM,OAAO,CAAC,eAAe,CAAC,gBAAgB,EAAE;YAClD,CAAC,CAAC,EAAE,CAAC;QAEP,6BAA6B;QAC7B,MAAM,mBAAmB,GAAkC;YACzD,YAAY;YACZ,MAAM;YACN,WAAW,EAAE;gBACX,IAAI,EAAE,WAAW,CAAC,IAAI;gBACtB,QAAQ,EAAE,WAAW,CAAC,QAAQ;gBAC9B,YAAY,EAAE,WAAW,CAAC,YAAY,IAAI,SAAS;aACpD;YACD,eAAe,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;SAC9D,CAAC;QAEF,kCAAkC;QAClC,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,mBAAmB,CACnD,QAAQ,CAAC,mBAAmB,CAAC,EAC7B,QAAQ,CAAC,2BAA2B,CAAC,CACtC,CAAC;QAEF,sDAAsD;QACtD,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,IAAI,CACrC,YAAY,EACZ,IAAI,UAAU,CAAC,EAAE,CAAC,EAAE,OAAO;QAC3B,MAAM,CAAC,aAAa,CAAC,oBAAoB,CAAC,EAC1C,EAAE,CAAC,aAAa;SACjB,CAAC;QAEF,gDAAgD;QAChD,MAAM,cAAc,GAAG,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC,CAAC;QACjF,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;QAE5E,oCAAoC;QACpC,MAAM,KAAK,CAAC,uBAAuB,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC;QAElF,MAAM,CAAC,IAAI,CAAC,8CAA8C,EAAE;YAC1D,SAAS;YACT,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC;SACzC,CAAC,CAAC;QAEH,mCAAmC;QACnC,wEAAwE;QACxE,MAAM,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;QACrC,MAAM,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,2CAA2C,EAAE,KAAK,CAAC,CAAC;QACjE,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,UAAkB,EAClB,cAAuB,EACvB,UAAU,GAAW,gCAAgC;IAKrD,MAAM,MAAM,GAAG,2BAA2B,CAAC,cAAc,CAAC,CAAC;IAC3D,IAAI,CAAC;QACH,8DAA8D;QAC9D,MAAM,GAAG,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;QACjC,MAAM,QAAQ,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;QACtC,IACE,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,QAAQ;YAClC,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,QAAQ;YAClC,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI;YAC1B,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,QAAQ,EAClC,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACzD,CAAC;QAED,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QACjD,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAE7C,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;QAED,IAAI,UAAsB,CAAC;QAC3B,IAAI,CAAC;YACH,UAAU,GAAG,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;QACzD,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,UAAU,CAAC,MAAM,KAAK,EAAE,IAAI,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,KAAK,SAAS,EAAE,CAAC;YAC/E,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;QACnF,CAAC;QAED,OAAO;YACL,SAAS;YACT,yBAAyB,EAAE,SAAS;SACrC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,wCAAwC,EAAE,KAAK,CAAC,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,KAA0B,EAC1B,SAAiB,EACjB,cAAmC,EACnC,cAAuB;IAEvB,MAAM,MAAM,GAAG,2BAA2B,CAAC,cAAc,CAAC,CAAC;IAC3D,IAAI,CAAC;QACH,8BAA8B;QAC9B,MAAM,gBAAgB,GAAG,MAAM,MAAM,CAAC,mBAAmB,EAAE,CAAC;QAE5D,kCAAkC;QAClC,MAAM,KAAK,CAAC,gBAAgB,CAC1B,SAAS,EACT,gBAAgB,CAAC,SAAS,EAC1B,gCAAgC,CAAC,cAAc,CAAC,CACjD,CAAC;QAEF,MAAM,CAAC,IAAI,CAAC,qCAAqC,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QAElE,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE,KAAK,CAAC,CAAC;QACxD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,KAA0B,EAC1B,SAAiB,EACjB,mBAA2B,EAC3B,yBAAiC,EACjC,OAAmC;IAEnC,MAAM,MAAM,GAAG,2BAA2B,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3D,MAAM,mBAAmB,GAAmB,EAAE,CAAC;IAC/C,MAAM,cAAc,GAAa,EAAE,CAAC;IACpC,IAAI,cAAc,GAAG,KAAK,CAAC;IAC3B,IAAI,mBAAmB,GAAG,KAAK,CAAC;IAChC,IAAI,mBAAmB,GAAG,KAAK,CAAC;IAChC,IAAI,oBAAoB,GAAkB,IAAI,CAAC;IAE/C,MAAM,8BAA8B,GAAG,KAAK,IAAmB,EAAE;QAC/D,KAAK,MAAM,YAAY,IAAI,mBAAmB,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC;YACjE,MAAM,OAAO,CAAC,aAAa,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,mBAAmB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;YACnD,MAAM,OAAO,CAAC,eAAe,CAAC,eAAe,CAAC,kBAAkB,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,cAAc,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;YAC9C,MAAM,OAAO,CAAC,eAAe,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,mBAAmB,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;YACtD,MAAM,OAAO,CAAC,kBAAkB,CAAC,kBAAkB,EAAE,CAAC;QACxD,CAAC;QACD,KAAK,MAAM,OAAO,IAAI,cAAc,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC;YACvD,MAAM,OAAO,CAAC,eAAe,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC,CAAC;IAEF,IAAI,YAAY,GAAsB,IAAI,CAAC;IAC3C,IAAI,aAAa,GAAsB,IAAI,CAAC;IAC5C,IAAI,CAAC;QACH,gCAAgC;QAChC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC;QAE7D,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACjD,MAAM,IAAI,KAAK,CAAC,mCAAmC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACtE,CAAC;QAED,0BAA0B;QAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAE7C,gDAAgD;QAChD,YAAY,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAC7C,QAAQ,CAAC,mBAAmB,CAAC,EAC7B,QAAQ,CAAC,yBAAyB,CAAC,CACpC,CAAC;QAEF,iDAAiD;QACjD,aAAa,GAAG,MAAM,MAAM,CAAC,IAAI,CAC/B,YAAY,EACZ,IAAI,UAAU,CAAC,EAAE,CAAC,EAClB,MAAM,CAAC,aAAa,CAAC,oBAAoB,CAAC,EAC1C,EAAE,CACH,CAAC;QAEF,+BAA+B;QAC/B,MAAM,cAAc,GAAG,MAAM,MAAM,CAAC,aAAa,CAC/C,aAAa,EACb,SAAS,CAAC,UAAU,EACpB,SAAS,CAAC,EAAE,EACZ,SAAS,CAAC,OAAO,CAClB,CAAC;QACF,MAAM,mBAAmB,GAAkC,IAAI,CAAC,KAAK,CACnE,MAAM,CAAC,aAAa,CAAC,cAAc,CAAC,CACrC,CAAC;QAEF,MAAM,cAAc,GAAG,mBAAmB,CAAC,YAAY,CAAC,GAAG,CAAC;QAC5D,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACnE,CAAC;QAED,MAAM,mBAAmB,GAAG,MAAM,iBAAiB,CACjD,OAAO,CAAC,cAAc,CAAC,UAAU,EACjC,QAAQ,CAAC,cAAc,CAAC,WAAW,CAAC,CACrC,CAAC;QAEF,6EAA6E;QAC7E,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,oBAAoB,CAAC,SAAS,EAAE;YAC7D,mBAAmB;YACnB,QAAQ,EAAE,OAAO,CAAC,cAAc,CAAC,QAAQ;YACzC,UAAU,EAAE,OAAO,CAAC,cAAc,CAAC,UAAU;YAC7C,SAAS,EAAE,OAAO,CAAC,cAAc,CAAC,SAAS;SAC5C,CAAC,CAAC;QACH,oBAAoB,GAAG,UAAU,CAAC,QAAQ,CAAC;QAE3C,KAAK,MAAM,YAAY,IAAI,mCAAmC,EAAE,CAAC;YAC/D,MAAM,WAAW,GAAG,mBAAmB,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;YACnE,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,SAAS;YACX,CAAC;YAED,MAAM,OAAO,CAAC,aAAa,CAAC,gBAAgB,CAC1C,8BAA8B,CAAC,WAAW,CAAC,EAC3C,YAAY,CACb,CAAC;YACF,mBAAmB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;YAC5B,MAAM,OAAO,CAAC,eAAe,CAAC,YAAY,CAAC,aAAa,EAAE,UAAU,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC1F,cAAc,GAAG,IAAI,CAAC;YACtB,MAAM,OAAO,CAAC,eAAe,CAAC,YAAY,CAAC,kBAAkB,EAAE,cAAc,CAAC,WAAW,CAAC,CAAC;YAC3F,mBAAmB,GAAG,IAAI,CAAC;QAC7B,CAAC;QAED,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;YAC/B,MAAM,OAAO,CAAC,kBAAkB,CAAC,gBAAgB,CAAC;gBAChD,YAAY,EAAE,mBAAmB,CAAC,WAAW,CAAC,QAAQ,IAAI,IAAI;gBAC9D,YAAY,EAAE,mBAAmB,CAAC,WAAW,CAAC,YAAY,IAAI,IAAI;aACnE,CAAC,CAAC;YACH,mBAAmB,GAAG,IAAI,CAAC;QAC7B,CAAC;QAED,IAAI,mBAAmB,CAAC,eAAe,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;YACnE,KAAK,MAAM,KAAK,IAAI,mBAAmB,CAAC,eAAe,EAAE,CAAC;gBACxD,MAAM,QAAQ,GAAG,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;gBACjE,MAAM,OAAO,CAAC,eAAe,CAAC,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;gBACtE,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;gBACjC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACrC,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,yCAAyC,EAAE;gBACrD,KAAK,EAAE,mBAAmB,CAAC,eAAe,CAAC,MAAM;aAClD,CAAC,CAAC;QACL,CAAC;QAED,MAAM,KAAK,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;QAE/C,MAAM,CAAC,IAAI,CAAC,gEAAgE,EAAE;YAC5E,QAAQ,EAAE,UAAU,CAAC,QAAQ;YAC7B,aAAa,EAAE,mBAAmB;SACnC,CAAC,CAAC;QAEH,OAAO;YACL,GAAG,mBAAmB;YACtB,QAAQ,EAAE,UAAU,CAAC,QAAQ;SAC9B,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,oBAAoB,KAAK,IAAI,EAAE,CAAC;YAClC,IAAI,CAAC;gBACH,MAAM,KAAK,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC;YAC9C,CAAC;YAAC,OAAO,aAAa,EAAE,CAAC;gBACvB,MAAM,CAAC,KAAK,CAAC,6DAA6D,EAAE,aAAa,CAAC,CAAC;YAC7F,CAAC;QACH,CAAC;QACD,IACE,mBAAmB,CAAC,MAAM,GAAG,CAAC;YAC9B,cAAc,CAAC,MAAM,GAAG,CAAC;YACzB,cAAc;YACd,mBAAmB;YACnB,mBAAmB,EACnB,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,8BAA8B,EAAE,CAAC;YACzC,CAAC;YAAC,OAAO,aAAa,EAAE,CAAC;gBACvB,MAAM,CAAC,KAAK,CAAC,6DAA6D,EAAE,aAAa,CAAC,CAAC;YAC7F,CAAC;QACH,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,uDAAuD,EAAE,KAAK,CAAC,CAAC;QAC7E,MAAM,KAAK,CAAC;IACd,CAAC;YAAS,CAAC;QACT,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;QACvC,CAAC;QACD,IAAI,aAAa,EAAE,CAAC;YAClB,MAAM,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;QACxC,CAAC;QACD,8EAA8E;IAChF,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,SAAS,gCAAgC,CACvC,QAA6B;IAE7B,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,SAAS,EAAE,QAAQ,CAAC,SAAS;KAC9B,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAA0B,EAC1B,SAAiB,EACjB,MAAc,EACd,cAAuB;IAEvB,MAAM,MAAM,GAAG,2BAA2B,CAAC,cAAc,CAAC,CAAC;IAC3D,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,yBAAyB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAEzD,MAAM,CAAC,IAAI,CAAC,kCAAkC,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IACjE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,yCAAyC,EAAE,KAAK,CAAC,CAAC;QAC/D,wCAAwC;IAC1C,CAAC;AACH,CAAC"}
@@ -1,15 +0,0 @@
1
- /**
2
- * X3DH (Extended Triple Diffie-Hellman)
3
- *
4
- * @layer 4 - Domain/Algorithms
5
- *
6
- * X3DH is the key agreement protocol used in the Signal Protocol to establish
7
- * shared secrets between two parties. It provides mutual authentication,
8
- * forward secrecy, and cryptographic deniability.
9
- *
10
- * @see https://signal.org/docs/specifications/x3dh/
11
- */
12
- export {};
13
- export { performX3DH, performX3DHResponder, calculateX3DHSharedSecret } from './x3dh.js';
14
- export type { EphemeralKeyPair, X3DHResult, X3DHResponderResult, X3DHResponderInput } from './x3dh.js';
15
- //# sourceMappingURL=index.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../internal/protocol/x3dh/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,EAAE,CAAC;AACV,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,QAAQ,CAAC;AAEtF,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC"}
@@ -1,13 +0,0 @@
1
- /**
2
- * X3DH (Extended Triple Diffie-Hellman)
3
- *
4
- * @layer 4 - Domain/Algorithms
5
- *
6
- * X3DH is the key agreement protocol used in the Signal Protocol to establish
7
- * shared secrets between two parties. It provides mutual authentication,
8
- * forward secrecy, and cryptographic deniability.
9
- *
10
- * @see https://signal.org/docs/specifications/x3dh/
11
- */
12
- export { performX3DH, performX3DHResponder, calculateX3DHSharedSecret } from './x3dh.js';
13
- //# sourceMappingURL=index.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../internal/protocol/x3dh/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,QAAQ,CAAC"}
@@ -1,131 +0,0 @@
1
- /**
2
- * X3DH (Extended Triple Diffie-Hellman) Key Agreement
3
- *
4
- * Implements the X3DH key agreement protocol for establishing shared secrets
5
- * between two parties. X3DH provides mutual authentication and forward secrecy.
6
- *
7
- * X3DH runs 3-4 ECDH operations:
8
- * - DH1: Initiator's identity key × Responder's signed prekey
9
- * - DH2: Initiator's ephemeral key × Responder's identity key
10
- * - DH3: Initiator's ephemeral key × Responder's signed prekey
11
- * - DH4: Initiator's ephemeral key × Responder's one-time prekey (if available)
12
- *
13
- * @see https://signal.org/docs/specifications/x3dh/
14
- */
15
- import { type Logger } from '../../../logger.js';
16
- import type { IdentityKeyPair, EcSignedPreKey, EcOneTimePreKey, PreKeyBundle, PublicKey, PrivateKey } from '../../../keys/index.js';
17
- import type { Base64 } from '../../../types/index.js';
18
- /**
19
- * Ephemeral key pair for X3DH protocol
20
- */
21
- export {};
22
- export interface EphemeralKeyPair {
23
- publicKey: PublicKey;
24
- privateKey: PrivateKey;
25
- }
26
- /**
27
- * X3DH key agreement result
28
- */
29
- export interface X3DHResult {
30
- /** The shared secret derived from X3DH (32 bytes) - initial root key (SK) */
31
- sharedSecret: Uint8Array;
32
- /**
33
- * Additional derived bytes from HKDF for compatibility.
34
- * Bytes 32-64: Reserved by this wire format
35
- * Bytes 64-96: Compatibility receiving chain key (the DH ratchet replaces it)
36
- *
37
- * Only present when derived with extended output size.
38
- */
39
- additionalDerivedBytes?: Uint8Array;
40
- /** Our ephemeral public key (sent to partner) */
41
- ephemeralPublicKey: PublicKey;
42
- /** Our ephemeral key pair (needed for session initialization as DHs) */
43
- ephemeralKeyPair: EphemeralKeyPair;
44
- /** ID of the signed prekey we used */
45
- usedSignedPreKeyId: number;
46
- /** ID of the one-time prekey we used (if any) */
47
- usedOneTimePreKeyId?: number;
48
- /** Kyber ciphertext for PQXDH (Kyber sessions only) */
49
- kyberCiphertext?: Base64;
50
- /** ID of the Kyber prekey we used (if any) */
51
- usedKyberPreKeyId?: number;
52
- /** Whether the session used PQXDH */
53
- usedPQXDH: boolean;
54
- }
55
- /**
56
- * X3DH responder result
57
- */
58
- export interface X3DHResponderResult {
59
- /** The shared secret derived from X3DH (32 bytes) - initial root key (SK) */
60
- sharedSecret: Uint8Array;
61
- /**
62
- * Additional derived bytes from HKDF for compatibility.
63
- * Only present when derived with extended output size.
64
- */
65
- additionalDerivedBytes?: Uint8Array;
66
- /** Whether the session used PQXDH */
67
- usedPQXDH: boolean;
68
- }
69
- /**
70
- * Information needed for X3DH responder to derive shared secret
71
- */
72
- export interface X3DHResponderInput {
73
- /** Sender's identity DH public key */
74
- senderIdentityKey: PublicKey;
75
- /** Sender's ephemeral public key from PreKeyMessage */
76
- senderEphemeralKey: PublicKey;
77
- /** ID of our signed prekey for this session */
78
- usedSignedPreKeyId: number;
79
- /** ID of our one-time prekey for this session (if any) */
80
- usedOneTimePreKeyId?: number;
81
- /** Kyber ciphertext for PQXDH (if any) */
82
- kyberCiphertext?: Base64;
83
- /** ID of our Kyber prekey for this session (if any) */
84
- usedKyberPreKeyId?: number;
85
- }
86
- /**
87
- * Run the X3DH key agreement as initiator (Alice)
88
- *
89
- * The caller invokes this when Alice wants to establish a session with Bob.
90
- * Alice uses Bob's prekey bundle for the key agreement.
91
- *
92
- * @param myIdentityKey My identity key pair
93
- * @param theirBundle Partner's prekey bundle
94
- * @param infoString HKDF info string for key derivation
95
- * @returns X3DH result containing shared secret and metadata
96
- *
97
- * @see https://signal.org/docs/specifications/x3dh/#the-x3dh-protocol
98
- */
99
- export declare function performX3DH(myIdentityKey: IdentityKeyPair, theirBundle: PreKeyBundle, infoString: string, logger?: Required<Logger>): Promise<X3DHResult>;
100
- /**
101
- * Run the X3DH key agreement as responder (Bob)
102
- *
103
- * The caller invokes this when Bob receives Alice's PreKeyMessage.
104
- * Bob uses his own prekeys and Alice's keys to derive the same shared secret.
105
- *
106
- * @param myIdentityKey My identity key pair
107
- * @param mySignedPreKey My signed prekey for this session
108
- * @param myOneTimePreKey My one-time prekey for this session (if any)
109
- * @param input Information from Alice's PreKeyMessage
110
- * @param infoString HKDF info string for key derivation
111
- * @returns X3DH responder result containing shared secret
112
- *
113
- * @see https://signal.org/docs/specifications/x3dh/#the-x3dh-protocol
114
- */
115
- export declare function performX3DHResponder(myIdentityKey: IdentityKeyPair, mySignedPreKey: EcSignedPreKey, myOneTimePreKey: EcOneTimePreKey | null, input: X3DHResponderInput, infoString: string, logger?: Required<Logger>): Promise<X3DHResponderResult>;
116
- /**
117
- * Calculate X3DH shared secret from DH outputs
118
- *
119
- * This is a lower-level function that takes pre-computed DH outputs
120
- * and derives the shared secret. Useful when a caller runs the DH operations
121
- * separately (e.g., with hardware security modules).
122
- *
123
- * @param dh1 DH1 output (IKa × SPKb or SPKb × IKa)
124
- * @param dh2 DH2 output (EKa × IKb or IKb × EKa)
125
- * @param dh3 DH3 output (EKa × SPKb or SPKb × EKa)
126
- * @param dh4 DH4 output (EKa × OPKb or OPKb × EKa), optional
127
- * @param infoString HKDF info string for key derivation
128
- * @returns Shared secret (32 bytes)
129
- */
130
- export declare function calculateX3DHSharedSecret(dh1: Uint8Array, dh2: Uint8Array, dh3: Uint8Array, dh4: Uint8Array | undefined, infoString: string): Promise<Uint8Array>;
131
- //# sourceMappingURL=x3dh.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"x3dh.d.ts","sourceRoot":"","sources":["../../../../internal/protocol/x3dh/x3dh.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAA+B,KAAK,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAI3E,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,eAAe,EACf,YAAY,EACZ,SAAS,EACT,UAAU,EACX,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAM7C;;GAEG;AACH,OAAO,EAAE,CAAC;AACV,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,SAAS,CAAC;IACrB,UAAU,EAAE,UAAU,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,6EAA6E;IAC7E,YAAY,EAAE,UAAU,CAAC;IACzB;;;;;;OAMG;IACH,sBAAsB,CAAC,EAAE,UAAU,CAAC;IACpC,iDAAiD;IACjD,kBAAkB,EAAE,SAAS,CAAC;IAC9B,wEAAwE;IACxE,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,sCAAsC;IACtC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iDAAiD;IACjD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,8CAA8C;IAC9C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,qCAAqC;IACrC,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,6EAA6E;IAC7E,YAAY,EAAE,UAAU,CAAC;IACzB;;;OAGG;IACH,sBAAsB,CAAC,EAAE,UAAU,CAAC;IACpC,qCAAqC;IACrC,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,iBAAiB,EAAE,SAAS,CAAC;IAC7B,uDAAuD;IACvD,kBAAkB,EAAE,SAAS,CAAC;IAC9B,+CAA+C;IAC/C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,0DAA0D;IAC1D,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,0CAA0C;IAC1C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uDAAuD;IACvD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAsB,WAAW,CAC/B,aAAa,EAAE,eAAe,EAC9B,WAAW,EAAE,YAAY,EACzB,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,QAAQ,CAAC,MAAM,CAA+B,GACrD,OAAO,CAAC,UAAU,CAAC,CA6IrB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,oBAAoB,CACxC,aAAa,EAAE,eAAe,EAC9B,cAAc,EAAE,cAAc,EAC9B,eAAe,EAAE,eAAe,GAAG,IAAI,EACvC,KAAK,EAAE,kBAAkB,EACzB,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,QAAQ,CAAC,MAAM,CAA+B,GACrD,OAAO,CAAC,mBAAmB,CAAC,CA6F9B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,UAAU,EACf,GAAG,EAAE,UAAU,EACf,GAAG,EAAE,UAAU,EACf,GAAG,EAAE,UAAU,GAAG,SAAS,EAC3B,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,UAAU,CAAC,CAcrB"}