@open-e2ee/signal-protocol-sdk 0.1.0-alpha.4 → 0.1.0-alpha.5

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 (270) hide show
  1. package/CHANGELOG.md +54 -0
  2. package/README.md +4 -2
  3. package/dist/blocking/types.d.ts +1 -1
  4. package/dist/blocking/types.js +1 -1
  5. package/dist/client/client.d.ts +3 -3
  6. package/dist/client/client.js +4 -4
  7. package/dist/client/client.js.map +1 -1
  8. package/dist/client/compose.d.ts +1 -1
  9. package/dist/client/compose.d.ts.map +1 -1
  10. package/dist/client/config.d.ts +2 -2
  11. package/dist/client/event-hooks.d.ts +1 -1
  12. package/dist/client/headless.d.ts +2 -2
  13. package/dist/client/headless.js +2 -2
  14. package/dist/client/key-rotation-core.d.ts +4 -4
  15. package/dist/client/key-rotation-core.js +11 -11
  16. package/dist/client/key-rotation-core.js.map +1 -1
  17. package/dist/client/media.d.ts +2 -2
  18. package/dist/client/media.js +5 -5
  19. package/dist/client/media.js.map +1 -1
  20. package/dist/client/messages.js +2 -2
  21. package/dist/client/messages.js.map +1 -1
  22. package/dist/client/relay-subscription.js +17 -0
  23. package/dist/client/relay-subscription.js.map +1 -1
  24. package/dist/client/retry.js +1 -1
  25. package/dist/client/retry.js.map +1 -1
  26. package/dist/client/sealed-sender-ops.js +1 -1
  27. package/dist/client/sealed-sender-ops.js.map +1 -1
  28. package/dist/client/sessions.d.ts.map +1 -1
  29. package/dist/client/sessions.js +3 -0
  30. package/dist/client/sessions.js.map +1 -1
  31. package/dist/client/signal-service-cipher.d.ts +5 -1
  32. package/dist/client/signal-service-cipher.d.ts.map +1 -1
  33. package/dist/client/signal-service-cipher.js +19 -14
  34. package/dist/client/signal-service-cipher.js.map +1 -1
  35. package/dist/device/provisioning.d.ts +3 -3
  36. package/dist/device/provisioning.js +2 -2
  37. package/dist/device/provisioning.js.map +1 -1
  38. package/dist/hooks/use-connection-presence.d.ts +2 -2
  39. package/dist/hooks/use-connection-presence.d.ts.map +1 -1
  40. package/dist/hooks/use-connection-presence.js +1 -1
  41. package/dist/hooks/use-group-membership.d.ts +2 -2
  42. package/dist/index.d.ts +2 -2
  43. package/dist/index.js +3 -3
  44. package/dist/index.js.map +1 -1
  45. package/dist/internal/crypto/index.js +1 -1
  46. package/dist/internal/crypto/index.js.map +1 -1
  47. package/dist/internal/crypto/kdf/hkdf.d.ts +1 -1
  48. package/dist/internal/crypto/kdf/hkdf.d.ts.map +1 -1
  49. package/dist/internal/crypto/kdf/hkdf.js +2 -2
  50. package/dist/internal/crypto/kdf/hkdf.js.map +1 -1
  51. package/dist/internal/crypto/key-prefix.d.ts +1 -1
  52. package/dist/internal/crypto/key-prefix.js +1 -1
  53. package/dist/internal/crypto/pq/kyber.d.ts +1 -1
  54. package/dist/internal/crypto/pq/kyber.js +1 -1
  55. package/dist/internal/crypto/symmetric/aes-gcm-siv.d.ts +1 -1
  56. package/dist/internal/crypto/symmetric/aes-gcm-siv.js +1 -1
  57. package/dist/internal/crypto/utils.d.ts +2 -2
  58. package/dist/internal/crypto/utils.js +2 -2
  59. package/dist/internal/encoding/proto/index.js +1 -1
  60. package/dist/internal/encoding/proto/index.js.map +1 -1
  61. package/dist/internal/encoding/proto/pq-ratchet-serialize.d.ts +2 -2
  62. package/dist/internal/encoding/proto/pq-ratchet-serialize.d.ts.map +1 -1
  63. package/dist/internal/encoding/proto/pq-ratchet-serialize.js +2 -2
  64. package/dist/internal/encoding/proto/pq-ratchet-serialize.js.map +1 -1
  65. package/dist/internal/groups/group-id.d.ts +1 -1
  66. package/dist/internal/groups/group-id.js +1 -1
  67. package/dist/internal/groups/group-id.js.map +1 -1
  68. package/dist/internal/groups-v2/access-control.d.ts +8 -1
  69. package/dist/internal/groups-v2/access-control.d.ts.map +1 -1
  70. package/dist/internal/groups-v2/access-control.js +8 -1
  71. package/dist/internal/groups-v2/access-control.js.map +1 -1
  72. package/dist/internal/groups-v2/change-actions.d.ts +8 -3
  73. package/dist/internal/groups-v2/change-actions.d.ts.map +1 -1
  74. package/dist/internal/groups-v2/change-actions.js +8 -3
  75. package/dist/internal/groups-v2/change-actions.js.map +1 -1
  76. package/dist/internal/groups-v2/index.d.ts +7 -2
  77. package/dist/internal/groups-v2/index.d.ts.map +1 -1
  78. package/dist/internal/groups-v2/index.js.map +1 -1
  79. package/dist/internal/groups-v2/manager.d.ts +4 -2
  80. package/dist/internal/groups-v2/manager.d.ts.map +1 -1
  81. package/dist/internal/groups-v2/manager.js +5 -3
  82. package/dist/internal/groups-v2/manager.js.map +1 -1
  83. package/dist/internal/groups-v2/types.d.ts +10 -3
  84. package/dist/internal/groups-v2/types.d.ts.map +1 -1
  85. package/dist/internal/groups-v2/types.js.map +1 -1
  86. package/dist/internal/manager/manager.d.ts.map +1 -1
  87. package/dist/internal/manager/manager.js +25 -14
  88. package/dist/internal/manager/manager.js.map +1 -1
  89. package/dist/internal/protocol/double-ratchet/chains.d.ts +1 -1
  90. package/dist/internal/protocol/double-ratchet/chains.js +1 -1
  91. package/dist/internal/protocol/double-ratchet/ratchet.d.ts +1 -1
  92. package/dist/internal/protocol/double-ratchet/ratchet.js +1 -1
  93. package/dist/internal/protocol/sealed-sender/decryption.js +2 -2
  94. package/dist/internal/protocol/sealed-sender/decryption.js.map +1 -1
  95. package/dist/internal/protocol/sealed-sender/types.d.ts +1 -1
  96. package/dist/internal/protocol/sealed-sender/types.js +1 -1
  97. package/dist/internal/protocol/sender-keys/index.d.ts +1 -1
  98. package/dist/internal/protocol/sender-keys/manager.d.ts +2 -2
  99. package/dist/internal/protocol/sender-keys/manager.js +3 -3
  100. package/dist/internal/protocol/sender-keys/manager.js.map +1 -1
  101. package/dist/internal/protocol/spqr/index.d.ts +1 -1
  102. package/dist/internal/protocol/spqr/index.js +1 -1
  103. package/dist/internal/protocol/spqr/message.d.ts +1 -1
  104. package/dist/internal/protocol/spqr/message.js +1 -1
  105. package/dist/internal/protocol/spqr/ml-kem-braid/rs/codec.d.ts +3 -3
  106. package/dist/internal/protocol/spqr/ml-kem-braid/rs/codec.d.ts.map +1 -1
  107. package/dist/internal/protocol/spqr/ml-kem-braid/rs/index.js +2 -2
  108. package/dist/internal/protocol/spqr/ml-kem-braid/rs/index.js.map +1 -1
  109. package/dist/internal/protocol/spqr/ml-kem-braid/rs/lagrange.d.ts +1 -1
  110. package/dist/internal/protocol/spqr/ml-kem-braid/rs/lagrange.js +1 -1
  111. package/dist/internal/protocol/spqr/ml-kem-braid/rs/lagrange.js.map +1 -1
  112. package/dist/internal/protocol/spqr/ml-kem-braid/serialize.d.ts +1 -1
  113. package/dist/internal/protocol/spqr/ml-kem-braid/serialize.js +1 -1
  114. package/dist/internal/protocol/spqr/ml-kem-braid/state-machine.js +5 -5
  115. package/dist/internal/protocol/spqr/ml-kem-braid/state-machine.js.map +1 -1
  116. package/dist/internal/protocol/spqr/ml-kem-braid/types.d.ts +1 -1
  117. package/dist/internal/protocol/spqr/ml-kem-braid/types.d.ts.map +1 -1
  118. package/dist/internal/protocol/spqr/spqr.d.ts +9 -9
  119. package/dist/internal/protocol/spqr/spqr.d.ts.map +1 -1
  120. package/dist/internal/protocol/spqr/spqr.js +9 -9
  121. package/dist/internal/protocol/spqr/spqr.js.map +1 -1
  122. package/dist/internal/protocol/triple-ratchet/ratchet.d.ts +1 -1
  123. package/dist/internal/protocol/triple-ratchet/ratchet.js +1 -1
  124. package/dist/internal/protocol/username/generate.d.ts +1 -1
  125. package/dist/internal/protocol/username/generate.js +1 -1
  126. package/dist/internal/protocol/username/hash.d.ts +1 -1
  127. package/dist/internal/protocol/username/hash.js +1 -1
  128. package/dist/internal/protocol/username/link.d.ts +1 -1
  129. package/dist/internal/protocol/username/link.js +1 -1
  130. package/dist/internal/protocol/username/proof.d.ts +1 -1
  131. package/dist/internal/protocol/username/proof.js +1 -1
  132. package/dist/internal/protocol/x3dh/x3dh.js +3 -3
  133. package/dist/internal/protocol/x3dh/x3dh.js.map +1 -1
  134. package/dist/internal/protocol/zk/groups/client-zk-group-cipher.d.ts +2 -2
  135. package/dist/internal/protocol/zk/groups/client-zk-group-cipher.js +2 -2
  136. package/dist/internal/sesame/device-registry.d.ts +11 -6
  137. package/dist/internal/sesame/device-registry.d.ts.map +1 -1
  138. package/dist/internal/sesame/device-registry.js +11 -7
  139. package/dist/internal/sesame/device-registry.js.map +1 -1
  140. package/dist/internal/sesame/manager.js +1 -1
  141. package/dist/internal/sesame/manager.js.map +1 -1
  142. package/dist/internal/session/keys.d.ts +1 -1
  143. package/dist/keys/generation.d.ts +1 -1
  144. package/dist/keys/generation.js +1 -1
  145. package/dist/keys/types.d.ts +1 -1
  146. package/dist/keys/types.d.ts.map +1 -1
  147. package/dist/local/store/expo/adapter.d.ts +3 -3
  148. package/dist/local/store/expo/adapter.js +2 -2
  149. package/dist/local/store/expo/db.js +1 -1
  150. package/dist/local/store/expo/db.js.map +1 -1
  151. package/dist/local/store/expo/index.d.ts +1 -1
  152. package/dist/local/store/expo/models/local-identity.d.ts +1 -1
  153. package/dist/local/store/expo/models/local-identity.js +1 -1
  154. package/dist/local/store/expo/models/sender-key.d.ts +3 -3
  155. package/dist/local/store/expo/models/sender-key.d.ts.map +1 -1
  156. package/dist/local/store/expo/models/sender-key.js +3 -3
  157. package/dist/local/store/expo/models/sender-key.js.map +1 -1
  158. package/dist/local/store/expo/schema.d.ts +1 -1
  159. package/dist/local/store/expo/schema.js +1 -1
  160. package/dist/local/store/expo/secure-store-options.d.ts +1 -1
  161. package/dist/local/store/mock/adapter.d.ts +6 -0
  162. package/dist/local/store/mock/adapter.d.ts.map +1 -1
  163. package/dist/local/store/mock/adapter.js +117 -47
  164. package/dist/local/store/mock/adapter.js.map +1 -1
  165. package/dist/local/store/mock/failures.d.ts +34 -0
  166. package/dist/local/store/mock/failures.d.ts.map +1 -0
  167. package/dist/local/store/mock/failures.js +75 -0
  168. package/dist/local/store/mock/failures.js.map +1 -0
  169. package/dist/local/store/mock/index.d.ts +4 -3
  170. package/dist/local/store/mock/index.d.ts.map +1 -1
  171. package/dist/local/store/mock/index.js +3 -2
  172. package/dist/local/store/mock/index.js.map +1 -1
  173. package/dist/local/store/node/database-key.js +1 -1
  174. package/dist/local/store/react-native/adapter.js +2 -2
  175. package/dist/local/store/react-native/adapter.js.map +1 -1
  176. package/dist/local/store/react-native/storage.d.ts +1 -1
  177. package/dist/local/store/web/adapter.d.ts.map +1 -1
  178. package/dist/local/store/web/adapter.js +14 -2
  179. package/dist/local/store/web/adapter.js.map +1 -1
  180. package/dist/local/vault/index.d.ts +1 -1
  181. package/dist/logger.d.ts +1 -1
  182. package/dist/logger.js +1 -1
  183. package/dist/media/index.d.ts +2 -2
  184. package/dist/media/index.js +2 -2
  185. package/dist/profile/cipher.d.ts +1 -1
  186. package/dist/profile/cipher.js +1 -1
  187. package/dist/profile/contact-state.d.ts +1 -1
  188. package/dist/profile/contact-state.js +1 -1
  189. package/dist/profile/crypto.d.ts +1 -1
  190. package/dist/profile/crypto.js +1 -1
  191. package/dist/profile/profile-key.js +1 -1
  192. package/dist/profile/update-service.d.ts +2 -2
  193. package/dist/profile/update-service.d.ts.map +1 -1
  194. package/dist/remote/object-store/convex-r2/server.d.ts +1 -1
  195. package/dist/remote/relay/convex/index.d.ts +1 -1
  196. package/dist/remote/relay/convex/index.js +1 -1
  197. package/dist/remote/relay/convex/relay.d.ts +2 -2
  198. package/dist/remote/relay/convex/relay.js +2 -2
  199. package/dist/remote/relay/convex/types.d.ts +7 -7
  200. package/dist/remote/relay/convex/types.js +1 -1
  201. package/dist/remote/relay/mock/adapter.d.ts +13 -2
  202. package/dist/remote/relay/mock/adapter.d.ts.map +1 -1
  203. package/dist/remote/relay/mock/adapter.js +165 -51
  204. package/dist/remote/relay/mock/adapter.js.map +1 -1
  205. package/dist/remote/relay/mock/failures.d.ts +57 -0
  206. package/dist/remote/relay/mock/failures.d.ts.map +1 -0
  207. package/dist/remote/relay/mock/failures.js +118 -0
  208. package/dist/remote/relay/mock/failures.js.map +1 -0
  209. package/dist/remote/relay/mock/index.d.ts +4 -3
  210. package/dist/remote/relay/mock/index.d.ts.map +1 -1
  211. package/dist/remote/relay/mock/index.js +4 -3
  212. package/dist/remote/relay/mock/index.js.map +1 -1
  213. package/dist/remote/relay/types.d.ts +1 -1
  214. package/dist/remote/relay/types.js +1 -1
  215. package/dist/safety/protobuf.d.ts +1 -1
  216. package/dist/safety/protobuf.d.ts.map +1 -1
  217. package/dist/types/api.d.ts +6 -6
  218. package/dist/types/errors.d.ts +2 -2
  219. package/dist/types/errors.d.ts.map +1 -1
  220. package/dist/types/errors.js +2 -2
  221. package/dist/types/errors.js.map +1 -1
  222. package/dist/types/protocol-config.d.ts +3 -2
  223. package/dist/types/protocol-config.d.ts.map +1 -1
  224. package/dist/types/protocol-config.js.map +1 -1
  225. package/dist/types/protocol-constants.d.ts +1 -1
  226. package/dist/types/protocol-constants.js +1 -1
  227. package/dist/utils/binary-transfer.d.ts +1 -1
  228. package/dist/utils/errors.d.ts +2 -2
  229. package/dist/utils/errors.js +2 -2
  230. package/dist/utils/retry.d.ts +2 -1
  231. package/dist/utils/retry.d.ts.map +1 -1
  232. package/dist/utils/retry.js +3 -1
  233. package/dist/utils/retry.js.map +1 -1
  234. package/dist/zk/groups.d.ts +1 -1
  235. package/dist/zk/groups.js +1 -1
  236. package/docs/CLIENT_COMPOSITION.md +5 -3
  237. package/docs/DEVIATIONS.md +63 -62
  238. package/docs/GETTING_STARTED.md +10 -6
  239. package/docs/PACKAGE_SURFACE.md +2 -2
  240. package/docs/PROTOCOL_POLICY.md +2 -2
  241. package/docs/RECIPES.md +4 -0
  242. package/docs/api/classes/SignalProtocolClient.md +4 -4
  243. package/docs/api/functions/createDefaultSignalLogger.md +2 -2
  244. package/docs/api/functions/resolveSignalLogger.md +2 -2
  245. package/docs/api/interfaces/BlockedRecipientEntry.md +1 -1
  246. package/docs/api/interfaces/ILogger.md +1 -1
  247. package/docs/api/interfaces/ISignalLocalSecretVault.md +2 -2
  248. package/docs/api/interfaces/ISignalLocalStore.md +2 -2
  249. package/docs/api/interfaces/ISignalProtocolClient.md +2 -2
  250. package/docs/api/interfaces/MLKEMBraidAgentState.md +1 -1
  251. package/docs/api/interfaces/PreKeyMaintenanceStore.md +2 -1
  252. package/docs/api/interfaces/SealedSenderConfig.md +2 -2
  253. package/docs/api/interfaces/SignalProtocolClientCompositionOptions.md +2 -2
  254. package/docs/api/interfaces/SignalProtocolClientConfig.md +2 -2
  255. package/docs/api/interfaces/SignalProtocolClientHooks.md +1 -1
  256. package/docs/api/interfaces/SignalProtocolClientIdentityConfig.md +1 -1
  257. package/docs/api/interfaces/SignalProtocolClientMediaConfig.md +3 -3
  258. package/docs/api/interfaces/SignalProtocolConfig.md +1 -1
  259. package/docs/api/namespaces/encoding/functions/bytesToUrlSafeBase64.md +2 -2
  260. package/docs/api/namespaces/keys/functions/generateKemOneTimePreKeys.md +1 -1
  261. package/docs/api/namespaces/media/functions/prepareMediaAttachmentUpload.md +1 -1
  262. package/docs/api/namespaces/media/functions/resolveMediaAttachment.md +1 -1
  263. package/docs/api/namespaces/media/variables/downloadMediaAttachment.md +1 -1
  264. package/docs/api/type-aliases/GroupId.md +1 -1
  265. package/docs/api/variables/MAX_RECEIVER_CHAINS.md +1 -1
  266. package/docs/api/variables/ONE_TIME_PREKEY_BATCH_SIZE.md +1 -1
  267. package/docs/api/variables/defaultSignalLogger.md +2 -2
  268. package/local/store/mock/README.md +31 -0
  269. package/package.json +1 -1
  270. package/remote/relay/mock/README.md +37 -0
@@ -1,5 +1,5 @@
1
1
  /**
2
- * Mock Signal Relay Server
2
+ * Mock Signal Protocol Relay Server
3
3
  *
4
4
  * In-memory implementation of ISignalRelayServer for local development.
5
5
  * Simulates a backend server without any network calls.
@@ -18,7 +18,20 @@ import { defaultExpiration, deriveForExpiration, issueEndorsements, serializeEnd
18
18
  import { UidEncryptionDomain } from '../../../internal/protocol/zk/groups/uid-encryption.js';
19
19
  import { Ciphertext } from '../../../internal/protocol/zk/credentials/attributes.js';
20
20
  import { ristretto255 } from '@noble/curves/ed25519.js';
21
+ import { MAX_DEVICES } from '../../../device/constants.js';
22
+ import { SealedSenderAuthError } from '../../../types/errors.js';
23
+ import { MockRelayFailureController, } from './failures.js';
24
+ /**
25
+ * Simulate the serialization boundary of a real relay.
26
+ *
27
+ * Values entering or leaving the in-memory server must never share mutable
28
+ * references with caller-owned objects.
29
+ */
30
+ function cloneRelayValue(value) {
31
+ return structuredClone(value);
32
+ }
21
33
  export class MockSignalRelayServer {
34
+ failures;
22
35
  // Device registry
23
36
  devices = new Map(); // key: userId
24
37
  // Identity keys per account (ACI/PNI), shared across all devices
@@ -27,8 +40,10 @@ export class MockSignalRelayServer {
27
40
  registrationIds = new Map(); // key: `${userId}:${deviceId}:${identityType}`
28
41
  // Prekeys per device
29
42
  ecPreKeys = new Map(); // key: `${userId}:${deviceId}:${identityType}`
43
+ consumedEcPreKeyIds = new Map(); // key: `${userId}:${deviceId}:${identityType}`
30
44
  ecSignedPreKeys = new Map(); // key: `${userId}:${deviceId}:${identityType}`
31
45
  kemOneTimePreKeys = new Map(); // key: `${userId}:${deviceId}:${identityType}`
46
+ consumedKemOneTimePreKeyIds = new Map(); // key: `${userId}:${deviceId}:${identityType}`
32
47
  kemLastResortPreKeys = new Map(); // key: `${userId}:${deviceId}:${identityType}`
33
48
  // Messages/envelopes
34
49
  pendingMessages = new Map(); // key: `${userId}:${deviceId}`
@@ -52,6 +67,9 @@ export class MockSignalRelayServer {
52
67
  groupChangeLogs = new Map(); // key: hex(groupId)
53
68
  // Server secret params for signing and ZK auth (deterministic local seed)
54
69
  serverSecretParams = generateServerSecretParams(new Uint8Array(32));
70
+ constructor(options = {}) {
71
+ this.failures = new MockRelayFailureController(options.failures, (targetKey, envelope) => this.deliverEnvelope(targetKey, envelope), (targetKey) => this.deliverPending(targetKey));
72
+ }
55
73
  /** Build a storage key with explicit identity-type separation. */
56
74
  storageKey(userId, deviceId, identityType = 'aci') {
57
75
  return `${userId}:${deviceId}:${identityType}`;
@@ -68,7 +86,9 @@ export class MockSignalRelayServer {
68
86
  this.ecSignedPreKeys,
69
87
  this.kemLastResortPreKeys,
70
88
  this.ecPreKeys,
89
+ this.consumedEcPreKeyIds,
71
90
  this.kemOneTimePreKeys,
91
+ this.consumedKemOneTimePreKeyIds,
72
92
  this.ecSignedPreKeyMetadata,
73
93
  this.kemLastResortPreKeyMetadata,
74
94
  ];
@@ -86,18 +106,19 @@ export class MockSignalRelayServer {
86
106
  // Envelope Delivery
87
107
  // ============================================================================
88
108
  async send(envelope) {
109
+ await this.failures.waitForLatency();
89
110
  const targetKey = `${envelope.targetUserId}:${envelope.targetDeviceId}`;
90
111
  const receiptKey = envelope.clientMessageId ? `${targetKey}:${envelope.clientMessageId}` : null;
91
112
  if (receiptKey) {
92
113
  const existing = this.clientMessageReceipts.get(receiptKey);
93
114
  if (existing) {
94
- return existing;
115
+ return cloneRelayValue(existing);
95
116
  }
96
117
  }
97
118
  const id = `msg-${++this.messageCounter}`;
98
119
  const serverTimestamp = Date.now();
99
120
  const storedEnvelope = {
100
- ...envelope,
121
+ ...cloneRelayValue(envelope),
101
122
  id,
102
123
  serverTimestamp,
103
124
  };
@@ -105,25 +126,28 @@ export class MockSignalRelayServer {
105
126
  const pending = this.pendingMessages.get(targetKey) || [];
106
127
  pending.push(storedEnvelope);
107
128
  this.pendingMessages.set(targetKey, pending);
108
- // Notify subscribers
109
- const subscribers = this.subscriptions.get(targetKey) || [];
110
- for (const callback of subscribers) {
111
- callback(storedEnvelope);
129
+ // Notify live subscribers through the deterministic failure controller.
130
+ // With no subscriber, the pending mailbox alone owns the envelope.
131
+ if ((this.subscriptions.get(targetKey)?.length ?? 0) > 0) {
132
+ this.failures.deliver(targetKey, storedEnvelope);
112
133
  }
113
134
  if (receiptKey) {
114
135
  this.clientMessageReceipts.set(receiptKey, { messageId: id, serverTimestamp });
115
136
  }
116
- return { messageId: id, serverTimestamp };
137
+ return cloneRelayValue({ messageId: id, serverTimestamp });
117
138
  }
118
139
  subscribe(userId, deviceId, onEnvelope) {
119
140
  const key = `${userId}:${deviceId}`;
120
141
  const subscribers = this.subscriptions.get(key) || [];
121
142
  subscribers.push(onEnvelope);
122
143
  this.subscriptions.set(key, subscribers);
123
- // Deliver any pending messages
124
- const pending = this.pendingMessages.get(key) || [];
125
- for (const envelope of pending) {
126
- onEnvelope(envelope);
144
+ // Deliver any pending messages only to the newly added subscriber.
145
+ if (!this.failures.isDisconnected(key)) {
146
+ this.failures.discardReordered(key);
147
+ const pending = this.pendingMessages.get(key) || [];
148
+ for (const envelope of pending) {
149
+ onEnvelope(cloneRelayValue(envelope));
150
+ }
127
151
  }
128
152
  return () => {
129
153
  const subs = this.subscriptions.get(key) || [];
@@ -150,17 +174,32 @@ export class MockSignalRelayServer {
150
174
  // Device Registry
151
175
  // ============================================================================
152
176
  async getDevices(userId) {
153
- return this.devices.get(userId) || [];
177
+ return cloneRelayValue(this.devices.get(userId) || []);
154
178
  }
155
179
  async registerDevice(userId, device) {
156
180
  const existing = this.devices.get(userId) || [];
157
- // Assign device ID
158
- const deviceId = existing.length === 0 ? 1 : Math.max(...existing.map((d) => d.deviceId)) + 1;
181
+ const occupiedIds = new Set(existing
182
+ .filter((candidate) => candidate.registered)
183
+ .map((candidate) => candidate.deviceId));
184
+ const requestedDeviceId = device.deviceId;
185
+ if (requestedDeviceId !== undefined &&
186
+ (!Number.isInteger(requestedDeviceId) ||
187
+ requestedDeviceId < 1 ||
188
+ requestedDeviceId > MAX_DEVICES)) {
189
+ throw new Error(`Device ID must be between 1 and ${MAX_DEVICES}`);
190
+ }
191
+ const deviceId = requestedDeviceId ??
192
+ Array.from({ length: MAX_DEVICES }, (_, index) => index + 1).find((candidate) => !occupiedIds.has(candidate));
193
+ if (deviceId === undefined || occupiedIds.has(deviceId)) {
194
+ throw new Error('Maximum devices limit reached');
195
+ }
159
196
  const isPrimary = deviceId === 1;
160
197
  const now = Date.now();
161
198
  const deviceInfo = {
162
199
  deviceId,
163
- encryptedDeviceName: device.encryptedDeviceName,
200
+ encryptedDeviceName: device.encryptedDeviceName
201
+ ? cloneRelayValue(device.encryptedDeviceName)
202
+ : undefined,
164
203
  deviceType: device.deviceType,
165
204
  registered: true, // Setup complete
166
205
  linked: isPrimary ? false : true, // Primary is never "linked", secondary is linked
@@ -170,7 +209,13 @@ export class MockSignalRelayServer {
170
209
  createdAt: now,
171
210
  linkedAt: isPrimary ? undefined : now,
172
211
  };
173
- existing.push(deviceInfo);
212
+ const reusableIndex = existing.findIndex((candidate) => candidate.deviceId === deviceId);
213
+ if (reusableIndex >= 0) {
214
+ existing[reusableIndex] = deviceInfo;
215
+ }
216
+ else {
217
+ existing.push(deviceInfo);
218
+ }
174
219
  this.devices.set(userId, existing);
175
220
  return deviceId;
176
221
  }
@@ -189,8 +234,10 @@ export class MockSignalRelayServer {
189
234
  const deviceKey = this.storageKey(userId, deviceId, idType);
190
235
  this.registrationIds.delete(deviceKey);
191
236
  this.ecPreKeys.delete(deviceKey);
237
+ this.consumedEcPreKeyIds.delete(deviceKey);
192
238
  this.ecSignedPreKeys.delete(deviceKey);
193
239
  this.kemOneTimePreKeys.delete(deviceKey);
240
+ this.consumedKemOneTimePreKeyIds.delete(deviceKey);
194
241
  this.kemLastResortPreKeys.delete(deviceKey);
195
242
  this.ecSignedPreKeyMetadata.delete(deviceKey);
196
243
  this.kemLastResortPreKeyMetadata.delete(deviceKey);
@@ -272,7 +319,7 @@ export class MockSignalRelayServer {
272
319
  async getIdentityKey(userId, identityType) {
273
320
  const key = this.identityStorageKey(userId, identityType);
274
321
  const encoded = this.identityKeys.get(key);
275
- return encoded ? decodeCompositeIdentityV1(encoded) : null;
322
+ return encoded ? cloneRelayValue(decodeCompositeIdentityV1(encoded)) : null;
276
323
  }
277
324
  // ============================================================================
278
325
  // Prekey Management
@@ -284,13 +331,22 @@ export class MockSignalRelayServer {
284
331
  for (const preKey of keys) {
285
332
  switch (preKey.type) {
286
333
  case 'ecPreKey': {
334
+ if (this.failures.shouldExhaustOneTimePreKeys())
335
+ break;
336
+ if (this.consumedEcPreKeyIds.get(key)?.has(preKey.keyId))
337
+ break;
287
338
  const existing = this.ecPreKeys.get(key) || [];
288
- existing.push(preKey);
339
+ const stored = cloneRelayValue(preKey);
340
+ const index = existing.findIndex((candidate) => candidate.keyId === stored.keyId);
341
+ if (index >= 0)
342
+ existing[index] = stored;
343
+ else
344
+ existing.push(stored);
289
345
  this.ecPreKeys.set(key, existing);
290
346
  break;
291
347
  }
292
348
  case 'ecSignedPreKey': {
293
- this.ecSignedPreKeys.set(key, preKey);
349
+ this.ecSignedPreKeys.set(key, cloneRelayValue(preKey));
294
350
  // Auto-populate metadata for server key verification
295
351
  this.ecSignedPreKeyMetadata.set(key, {
296
352
  keyId: preKey.keyId,
@@ -301,13 +357,22 @@ export class MockSignalRelayServer {
301
357
  break;
302
358
  }
303
359
  case 'kemOneTimePreKey': {
360
+ if (this.failures.shouldExhaustOneTimePreKeys())
361
+ break;
362
+ if (this.consumedKemOneTimePreKeyIds.get(key)?.has(preKey.keyId))
363
+ break;
304
364
  const existing = this.kemOneTimePreKeys.get(key) || [];
305
- existing.push(preKey);
365
+ const stored = cloneRelayValue(preKey);
366
+ const index = existing.findIndex((candidate) => candidate.keyId === stored.keyId);
367
+ if (index >= 0)
368
+ existing[index] = stored;
369
+ else
370
+ existing.push(stored);
306
371
  this.kemOneTimePreKeys.set(key, existing);
307
372
  break;
308
373
  }
309
374
  case 'kemLastResortPreKey': {
310
- this.kemLastResortPreKeys.set(key, preKey);
375
+ this.kemLastResortPreKeys.set(key, cloneRelayValue(preKey));
311
376
  // Auto-populate metadata for server key verification
312
377
  this.kemLastResortPreKeyMetadata.set(key, {
313
378
  keyId: preKey.keyId,
@@ -336,14 +401,29 @@ export class MockSignalRelayServer {
336
401
  }
337
402
  // Get and consume one-time prekey (optional)
338
403
  const ecPreKeys = this.ecPreKeys.get(deviceKey) || [];
339
- const ecOneTimePreKey = ecPreKeys.length > 0 ? ecPreKeys.shift() : null;
404
+ const exhaustOneTimePreKeys = this.failures.shouldExhaustOneTimePreKeys();
405
+ if (exhaustOneTimePreKeys) {
406
+ this.recordConsumedPreKeyIds(this.consumedEcPreKeyIds, deviceKey, ecPreKeys);
407
+ this.recordConsumedPreKeyIds(this.consumedKemOneTimePreKeyIds, deviceKey, this.kemOneTimePreKeys.get(deviceKey) || []);
408
+ this.ecPreKeys.delete(deviceKey);
409
+ this.kemOneTimePreKeys.delete(deviceKey);
410
+ }
411
+ const ecOneTimePreKey = !exhaustOneTimePreKeys && ecPreKeys.length > 0 ? ecPreKeys.shift() : null;
412
+ if (ecOneTimePreKey) {
413
+ this.recordConsumedPreKeyIds(this.consumedEcPreKeyIds, deviceKey, [ecOneTimePreKey]);
414
+ }
340
415
  if (ecPreKeys.length === 0) {
341
416
  this.ecPreKeys.delete(deviceKey);
342
417
  }
343
418
  // Get KEM one-time prekey (consumed like EC one-time prekeys)
344
419
  // Per PQXDH spec Section 3.2: one-time KEM prekeys provide per-session PQ forward secrecy
345
420
  const kemOneTimePreKeys = this.kemOneTimePreKeys.get(deviceKey) || [];
346
- const kemOneTimePreKey = kemOneTimePreKeys.length > 0 ? kemOneTimePreKeys.shift() : null;
421
+ const kemOneTimePreKey = !exhaustOneTimePreKeys && kemOneTimePreKeys.length > 0
422
+ ? kemOneTimePreKeys.shift()
423
+ : null;
424
+ if (kemOneTimePreKey) {
425
+ this.recordConsumedPreKeyIds(this.consumedKemOneTimePreKeyIds, deviceKey, [kemOneTimePreKey]);
426
+ }
347
427
  if (kemOneTimePreKeys.length === 0) {
348
428
  this.kemOneTimePreKeys.delete(deviceKey);
349
429
  }
@@ -352,7 +432,7 @@ export class MockSignalRelayServer {
352
432
  const kemLastResortPreKey = this.kemLastResortPreKeys.get(deviceKey) || null;
353
433
  // Cast to branded types - ISignalRelayServer returns PreKeyBundle with branded types
354
434
  // Adapters handle the casting internally so callers don't need to
355
- return {
435
+ return cloneRelayValue({
356
436
  registrationId,
357
437
  deviceId,
358
438
  identity: decodeCompositeIdentityV1(encodedIdentity),
@@ -381,7 +461,7 @@ export class MockSignalRelayServer {
381
461
  signature: kemOneTimePreKey.signature,
382
462
  }
383
463
  : null,
384
- };
464
+ });
385
465
  }
386
466
  async getPreKeyCount(userId, deviceId, type, identityType) {
387
467
  const key = this.storageKey(userId, deviceId, identityType);
@@ -423,15 +503,13 @@ export class MockSignalRelayServer {
423
503
  ], identityType);
424
504
  }
425
505
  async getGroupMembers(groupId) {
426
- return this.groupMembers.get(groupId) || [];
506
+ return cloneRelayValue(this.groupMembers.get(groupId) || []);
427
507
  }
428
508
  async getActiveDevices(userId) {
429
509
  const deviceInfos = this.devices.get(userId) || [];
430
- if (deviceInfos.length > 0) {
431
- return deviceInfos.map((d) => ({ userId, deviceId: d.deviceId }));
432
- }
433
- // Default to device 1 if no devices registered
434
- return [{ userId, deviceId: 1 }];
510
+ return deviceInfos
511
+ .filter((device) => device.registered && device.enabled)
512
+ .map((device) => ({ userId, deviceId: device.deviceId }));
435
513
  }
436
514
  // ============================================================================
437
515
  // Provisioning Service (IProvisioningService)
@@ -478,7 +556,7 @@ export class MockSignalRelayServer {
478
556
  throw new Error(`Provisioning session ${sessionId} is not in waiting state`);
479
557
  }
480
558
  session.newDeviceEphemeralPublicKey = ephemeralPublicKey;
481
- session.deviceMetadata = deviceMetadata;
559
+ session.deviceMetadata = cloneRelayValue(deviceMetadata);
482
560
  session.status = 'connected';
483
561
  }
484
562
  async sendProvisioningMessage(sessionId, encryptedMessage, _userId) {
@@ -531,7 +609,7 @@ export class MockSignalRelayServer {
531
609
  const reusableDevice = existingDevices.find((device) => device.deviceId === session.assignedDeviceId);
532
610
  const nextState = {
533
611
  deviceId: session.assignedDeviceId,
534
- encryptedDeviceName: deviceMetadata.encryptedDeviceName,
612
+ encryptedDeviceName: cloneRelayValue(deviceMetadata.encryptedDeviceName),
535
613
  deviceType: 'mobile',
536
614
  registered: true,
537
615
  linked: true,
@@ -584,11 +662,13 @@ export class MockSignalRelayServer {
584
662
  // ============================================================================
585
663
  async getEcSignedPreKeyMetadata(userId, deviceId, identityType) {
586
664
  const key = this.storageKey(userId, deviceId, identityType);
587
- return this.ecSignedPreKeyMetadata.get(key) || null;
665
+ const metadata = this.ecSignedPreKeyMetadata.get(key);
666
+ return metadata ? cloneRelayValue(metadata) : null;
588
667
  }
589
668
  async getKemLastResortPreKeyMetadata(userId, deviceId, identityType) {
590
669
  const key = this.storageKey(userId, deviceId, identityType);
591
- return this.kemLastResortPreKeyMetadata.get(key) || null;
670
+ const metadata = this.kemLastResortPreKeyMetadata.get(key);
671
+ return metadata ? cloneRelayValue(metadata) : null;
592
672
  }
593
673
  // ============================================================================
594
674
  // Sealed Sender (Anonymous Delivery)
@@ -608,6 +688,9 @@ export class MockSignalRelayServer {
608
688
  * Same as send() but without sender identification.
609
689
  */
610
690
  async sendUnidentified(envelope, auth) {
691
+ if (this.failures.shouldRejectAuthorization()) {
692
+ throw new SealedSenderAuthError();
693
+ }
611
694
  // Mock: pass through without validation; callers can override if needed.
612
695
  void auth; // Accept but don't validate in mock
613
696
  return this.send({
@@ -669,12 +752,12 @@ export class MockSignalRelayServer {
669
752
  async sendRetryRequest(request) {
670
753
  const key = `${request.originalSenderUserId}:${request.originalSenderDeviceId}`;
671
754
  const existing = this.retryRequests.get(key) || [];
672
- existing.push(request);
755
+ existing.push(cloneRelayValue(request));
673
756
  this.retryRequests.set(key, existing);
674
757
  // Notify subscribers
675
758
  const subscribers = this.retryRequestSubscriptions.get(key) || [];
676
759
  for (const handler of subscribers) {
677
- await handler(request);
760
+ await handler(cloneRelayValue(request));
678
761
  }
679
762
  }
680
763
  subscribeRetryRequests(userId, deviceId, handler) {
@@ -685,7 +768,7 @@ export class MockSignalRelayServer {
685
768
  // Deliver any pending retry requests
686
769
  const pending = this.retryRequests.get(key) || [];
687
770
  for (const request of pending) {
688
- handler(request);
771
+ handler(cloneRelayValue(request));
689
772
  }
690
773
  return () => {
691
774
  const subs = this.retryRequestSubscriptions.get(key) || [];
@@ -700,17 +783,18 @@ export class MockSignalRelayServer {
700
783
  // ============================================================================
701
784
  async createGroupState(groupId, encryptedState, _authorization) {
702
785
  const key = this.groupIdToHex(groupId);
703
- this.groupStates.set(key, { encryptedState, version: 0 });
786
+ this.groupStates.set(key, { encryptedState: cloneRelayValue(encryptedState), version: 0 });
704
787
  this.groupChangeLogs.set(key, []);
705
788
  }
706
789
  async getGroupState(groupId, _authorization) {
707
790
  const key = this.groupIdToHex(groupId);
708
- return this.groupStates.get(key) ?? null;
791
+ const state = this.groupStates.get(key);
792
+ return state ? cloneRelayValue(state) : null;
709
793
  }
710
794
  async getGroupChanges(groupId, fromVersion, _authorization) {
711
795
  const key = this.groupIdToHex(groupId);
712
796
  const changes = this.groupChangeLogs.get(key) ?? [];
713
- return changes.filter((c) => c.version > fromVersion);
797
+ return cloneRelayValue(changes.filter((c) => c.version > fromVersion));
714
798
  }
715
799
  async submitGroupChange(groupId, expectedVersion, encryptedChange, updatedEncryptedState, _authorization) {
716
800
  const key = this.groupIdToHex(groupId);
@@ -726,16 +810,16 @@ export class MockSignalRelayServer {
726
810
  const serverSignature = serverSign(this.serverSecretParams, randomness, encryptedChange);
727
811
  const entry = {
728
812
  version: newVersion,
729
- encryptedChange,
813
+ encryptedChange: cloneRelayValue(encryptedChange),
730
814
  serverSignature,
731
815
  timestamp: Date.now(),
732
816
  };
733
- current.encryptedState = updatedEncryptedState;
817
+ current.encryptedState = cloneRelayValue(updatedEncryptedState);
734
818
  current.version = newVersion;
735
819
  const changes = this.groupChangeLogs.get(key) ?? [];
736
- changes.push(entry);
820
+ changes.push(cloneRelayValue(entry));
737
821
  this.groupChangeLogs.set(key, changes);
738
- return { serverSignature };
822
+ return cloneRelayValue({ serverSignature });
739
823
  }
740
824
  // ============================================================================
741
825
  // ZK Auth Credentials (anonymous group access)
@@ -824,10 +908,13 @@ export class MockSignalRelayServer {
824
908
  this.identityKeys.clear();
825
909
  this.registrationIds.clear();
826
910
  this.ecPreKeys.clear();
911
+ this.consumedEcPreKeyIds.clear();
827
912
  this.ecSignedPreKeys.clear();
828
913
  this.kemOneTimePreKeys.clear();
914
+ this.consumedKemOneTimePreKeyIds.clear();
829
915
  this.kemLastResortPreKeys.clear();
830
916
  this.pendingMessages.clear();
917
+ this.clientMessageReceipts.clear();
831
918
  this.subscriptions.clear();
832
919
  this.groupMembers.clear();
833
920
  this.provisioningSessions.clear();
@@ -839,6 +926,7 @@ export class MockSignalRelayServer {
839
926
  this.groupChangeLogs.clear();
840
927
  this.userIdentities.clear();
841
928
  this.senderCertificates.clear();
929
+ this.failures.reset();
842
930
  this.messageCounter = 0;
843
931
  this.provisioningCounter = 0;
844
932
  }
@@ -846,21 +934,21 @@ export class MockSignalRelayServer {
846
934
  * Set group members for deterministic local setup.
847
935
  */
848
936
  setGroupMembers(groupId, members) {
849
- this.groupMembers.set(groupId, members);
937
+ this.groupMembers.set(groupId, cloneRelayValue(members));
850
938
  }
851
939
  /**
852
940
  * Inspect pending messages for a device.
853
941
  */
854
942
  getPendingMessages(userId, deviceId) {
855
943
  const key = `${userId}:${deviceId}`;
856
- return this.pendingMessages.get(key) || [];
944
+ return cloneRelayValue(this.pendingMessages.get(key) || []);
857
945
  }
858
946
  /**
859
947
  * Inspect pending retry requests for a device.
860
948
  */
861
949
  getPendingRetryRequests(userId, deviceId) {
862
950
  const key = `${userId}:${deviceId}`;
863
- return this.retryRequests.get(key) || [];
951
+ return cloneRelayValue(this.retryRequests.get(key) || []);
864
952
  }
865
953
  /**
866
954
  * Mark a retry request as handled (remove from pending)
@@ -881,14 +969,14 @@ export class MockSignalRelayServer {
881
969
  */
882
970
  setEcSignedPreKeyMetadata(userId, deviceId, metadata, identityType = 'aci') {
883
971
  const key = this.storageKey(userId, deviceId, identityType);
884
- this.ecSignedPreKeyMetadata.set(key, metadata);
972
+ this.ecSignedPreKeyMetadata.set(key, cloneRelayValue(metadata));
885
973
  }
886
974
  /**
887
975
  * Set Kyber prekey metadata for deterministic key rotation.
888
976
  */
889
977
  setKemLastResortPreKeyMetadata(userId, deviceId, metadata, identityType = 'aci') {
890
978
  const key = this.storageKey(userId, deviceId, identityType);
891
- this.kemLastResortPreKeyMetadata.set(key, metadata);
979
+ this.kemLastResortPreKeyMetadata.set(key, cloneRelayValue(metadata));
892
980
  }
893
981
  /**
894
982
  * Set the prekey count for deterministic key rotation.
@@ -910,20 +998,46 @@ export class MockSignalRelayServer {
910
998
  publicKey: `placeholder-${i}`,
911
999
  }));
912
1000
  if (type === 'ec') {
1001
+ this.consumedEcPreKeyIds.delete(key);
913
1002
  this.ecPreKeys.set(key, placeholderKeys);
914
1003
  }
915
1004
  else {
1005
+ this.consumedKemOneTimePreKeyIds.delete(key);
916
1006
  this.kemOneTimePreKeys.set(key, placeholderKeys);
917
1007
  }
918
1008
  }
919
1009
  // ============================================================================
920
1010
  // Utility Methods
921
1011
  // ============================================================================
1012
+ recordConsumedPreKeyIds(consumed, storageKey, preKeys) {
1013
+ if (preKeys.length === 0)
1014
+ return;
1015
+ const keyIds = consumed.get(storageKey) || new Set();
1016
+ for (const preKey of preKeys) {
1017
+ keyIds.add(preKey.keyId);
1018
+ }
1019
+ consumed.set(storageKey, keyIds);
1020
+ }
922
1021
  groupIdToHex(groupId) {
923
1022
  return Array.from(groupId)
924
1023
  .map((b) => b.toString(16).padStart(2, '0'))
925
1024
  .join('');
926
1025
  }
1026
+ deliverEnvelope(targetKey, envelope) {
1027
+ const subscribers = this.subscriptions.get(targetKey) || [];
1028
+ for (const callback of subscribers) {
1029
+ callback(cloneRelayValue(envelope));
1030
+ }
1031
+ }
1032
+ deliverPending(targetKey) {
1033
+ if (this.failures.isDisconnected(targetKey))
1034
+ return;
1035
+ this.failures.discardReordered(targetKey);
1036
+ const pending = this.pendingMessages.get(targetKey) || [];
1037
+ for (const envelope of pending) {
1038
+ this.failures.deliver(targetKey, envelope);
1039
+ }
1040
+ }
927
1041
  uint8ArrayToBase64(data) {
928
1042
  if (typeof Buffer !== 'undefined') {
929
1043
  return Buffer.from(data).toString('base64');