@peers-app/peers-sdk 0.27.2 → 0.27.4

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 (260) hide show
  1. package/dist/contracts/contract-proxy.d.ts +7 -0
  2. package/dist/contracts/contract-proxy.js +19 -2
  3. package/dist/contracts/create-local-consumer.js +16 -1
  4. package/dist/contracts/index.d.ts +2 -0
  5. package/dist/contracts/index.js +2 -0
  6. package/dist/contracts/system/index.d.ts +2 -0
  7. package/dist/contracts/system/index.js +2 -0
  8. package/dist/contracts/system/invites-contract.js +2 -1
  9. package/dist/contracts/system/sync-check-contract.d.ts +97 -0
  10. package/dist/contracts/system/sync-check-contract.js +115 -0
  11. package/dist/contracts/tool-arguments.d.ts +15 -0
  12. package/dist/contracts/tool-arguments.js +41 -0
  13. package/dist/contracts/tool-catalog-service.js +2 -12
  14. package/dist/data/change-tracking.d.ts +40 -0
  15. package/dist/data/change-tracking.js +89 -0
  16. package/dist/data/orm/types.d.ts +24 -7
  17. package/dist/data/orm/types.js +97 -24
  18. package/dist/data/persistent-vars.d.ts +5 -0
  19. package/dist/data/persistent-vars.js +24 -6
  20. package/dist/define/manifest.js +6 -34
  21. package/dist/package-loader/package-loader.js +27 -22
  22. package/dist/system-ids.d.ts +5 -0
  23. package/dist/system-ids.js +6 -1
  24. package/package.json +4 -2
  25. package/dist/context/user-context-identity.test.d.ts +0 -1
  26. package/dist/context/user-context-identity.test.js +0 -220
  27. package/dist/contracts/__tests__/action-dispatch.test.d.ts +0 -1
  28. package/dist/contracts/__tests__/action-dispatch.test.js +0 -319
  29. package/dist/contracts/__tests__/also-implements.test.d.ts +0 -1
  30. package/dist/contracts/__tests__/also-implements.test.js +0 -110
  31. package/dist/contracts/__tests__/builder.test.d.ts +0 -1
  32. package/dist/contracts/__tests__/builder.test.js +0 -669
  33. package/dist/contracts/__tests__/contract-events.test.d.ts +0 -1
  34. package/dist/contracts/__tests__/contract-events.test.js +0 -199
  35. package/dist/contracts/__tests__/contract-observables.test.d.ts +0 -1
  36. package/dist/contracts/__tests__/contract-observables.test.js +0 -290
  37. package/dist/contracts/__tests__/contract-provider-router.test.d.ts +0 -1
  38. package/dist/contracts/__tests__/contract-provider-router.test.js +0 -315
  39. package/dist/contracts/__tests__/contract-proxy.test.d.ts +0 -1
  40. package/dist/contracts/__tests__/contract-proxy.test.js +0 -657
  41. package/dist/contracts/__tests__/contract-resolvers.test.d.ts +0 -1
  42. package/dist/contracts/__tests__/contract-resolvers.test.js +0 -758
  43. package/dist/contracts/__tests__/contract-subscription-lifecycle.test.d.ts +0 -1
  44. package/dist/contracts/__tests__/contract-subscription-lifecycle.test.js +0 -353
  45. package/dist/contracts/__tests__/contract-table-events.test.d.ts +0 -1
  46. package/dist/contracts/__tests__/contract-table-events.test.js +0 -209
  47. package/dist/contracts/__tests__/contract-transport.test.d.ts +0 -1
  48. package/dist/contracts/__tests__/contract-transport.test.js +0 -163
  49. package/dist/contracts/__tests__/extract.test.d.ts +0 -1
  50. package/dist/contracts/__tests__/extract.test.js +0 -145
  51. package/dist/contracts/__tests__/frozen-contracts.test.d.ts +0 -1
  52. package/dist/contracts/__tests__/frozen-contracts.test.js +0 -191
  53. package/dist/contracts/__tests__/generic-tool-dispatch.test.d.ts +0 -1
  54. package/dist/contracts/__tests__/generic-tool-dispatch.test.js +0 -130
  55. package/dist/contracts/__tests__/host-contract-client.test.d.ts +0 -1
  56. package/dist/contracts/__tests__/host-contract-client.test.js +0 -793
  57. package/dist/contracts/__tests__/host-contract-consumer.test.d.ts +0 -1
  58. package/dist/contracts/__tests__/host-contract-consumer.test.js +0 -163
  59. package/dist/contracts/__tests__/host-contract-transport.test.d.ts +0 -1
  60. package/dist/contracts/__tests__/host-contract-transport.test.js +0 -66
  61. package/dist/contracts/__tests__/integration.test.d.ts +0 -1
  62. package/dist/contracts/__tests__/integration.test.js +0 -348
  63. package/dist/contracts/__tests__/legacy-removal.test.d.ts +0 -1
  64. package/dist/contracts/__tests__/legacy-removal.test.js +0 -128
  65. package/dist/contracts/__tests__/persistent-registry.test.d.ts +0 -1
  66. package/dist/contracts/__tests__/persistent-registry.test.js +0 -109
  67. package/dist/contracts/__tests__/playground.test.d.ts +0 -1
  68. package/dist/contracts/__tests__/playground.test.js +0 -216
  69. package/dist/contracts/__tests__/registry.test.d.ts +0 -1
  70. package/dist/contracts/__tests__/registry.test.js +0 -238
  71. package/dist/contracts/__tests__/remote-contract-transport.test.d.ts +0 -1
  72. package/dist/contracts/__tests__/remote-contract-transport.test.js +0 -119
  73. package/dist/contracts/__tests__/system-contracts.test.d.ts +0 -1
  74. package/dist/contracts/__tests__/system-contracts.test.js +0 -247
  75. package/dist/contracts/__tests__/target-dispatch.d.ts +0 -11
  76. package/dist/contracts/__tests__/target-dispatch.js +0 -24
  77. package/dist/contracts/__tests__/tool-catalog-inventory.test.d.ts +0 -1
  78. package/dist/contracts/__tests__/tool-catalog-inventory.test.js +0 -44
  79. package/dist/contracts/__tests__/tool-catalog-service.test.d.ts +0 -1
  80. package/dist/contracts/__tests__/tool-catalog-service.test.js +0 -482
  81. package/dist/contracts/__tests__/tool-catalog.test.d.ts +0 -1
  82. package/dist/contracts/__tests__/tool-catalog.test.js +0 -1199
  83. package/dist/contracts/__tests__/validate.test.d.ts +0 -1
  84. package/dist/contracts/__tests__/validate.test.js +0 -991
  85. package/dist/contracts/__tests__/workflow-context.test.d.ts +0 -1
  86. package/dist/contracts/__tests__/workflow-context.test.js +0 -50
  87. package/dist/data/access-level.test.d.ts +0 -1
  88. package/dist/data/access-level.test.js +0 -53
  89. package/dist/data/change-tracking.test.d.ts +0 -1
  90. package/dist/data/change-tracking.test.js +0 -62
  91. package/dist/data/files/files.test.d.ts +0 -1
  92. package/dist/data/files/files.test.js +0 -770
  93. package/dist/data/group-members.test.d.ts +0 -1
  94. package/dist/data/group-members.test.js +0 -336
  95. package/dist/data/group-share.test.d.ts +0 -1
  96. package/dist/data/group-share.test.js +0 -110
  97. package/dist/data/groups.test.d.ts +0 -1
  98. package/dist/data/groups.test.js +0 -153
  99. package/dist/data/orm/cursor.test.d.ts +0 -1
  100. package/dist/data/orm/cursor.test.js +0 -314
  101. package/dist/data/orm/data-query.mongo.test.d.ts +0 -1
  102. package/dist/data/orm/data-query.mongo.test.js +0 -367
  103. package/dist/data/orm/data-query.sqlite.test.d.ts +0 -1
  104. package/dist/data/orm/data-query.sqlite.test.js +0 -365
  105. package/dist/data/orm/data-query.test.d.ts +0 -1
  106. package/dist/data/orm/data-query.test.js +0 -545
  107. package/dist/data/orm/dependency-injection.test.d.ts +0 -1
  108. package/dist/data/orm/dependency-injection.test.js +0 -171
  109. package/dist/data/orm/event-registry.test.d.ts +0 -1
  110. package/dist/data/orm/event-registry.test.js +0 -44
  111. package/dist/data/orm/multi-cursors.test.d.ts +0 -1
  112. package/dist/data/orm/multi-cursors.test.js +0 -463
  113. package/dist/data/orm/sql.data-source.test.d.ts +0 -1
  114. package/dist/data/orm/sql.data-source.test.js +0 -731
  115. package/dist/data/orm/table-container-events.test.d.ts +0 -1
  116. package/dist/data/orm/table-container-events.test.js +0 -101
  117. package/dist/data/orm/table-container.test.d.ts +0 -1
  118. package/dist/data/orm/table-container.test.js +0 -273
  119. package/dist/data/orm/table.event-source.test.d.ts +0 -1
  120. package/dist/data/orm/table.event-source.test.js +0 -331
  121. package/dist/data/orm/types.test.d.ts +0 -1
  122. package/dist/data/orm/types.test.js +0 -409
  123. package/dist/data/package-table-identity.test.d.ts +0 -1
  124. package/dist/data/package-table-identity.test.js +0 -46
  125. package/dist/data/package-version-permissions.test.d.ts +0 -1
  126. package/dist/data/package-version-permissions.test.js +0 -107
  127. package/dist/data/package-version-resolver.test.d.ts +0 -4
  128. package/dist/data/package-version-resolver.test.js +0 -543
  129. package/dist/data/package-versions.test.d.ts +0 -1
  130. package/dist/data/package-versions.test.js +0 -227
  131. package/dist/data/persistent-vars.conflict.test.d.ts +0 -1
  132. package/dist/data/persistent-vars.conflict.test.js +0 -126
  133. package/dist/data/persistent-vars.migration.test.d.ts +0 -1
  134. package/dist/data/persistent-vars.migration.test.js +0 -133
  135. package/dist/data/persistent-vars.package-scope.test.d.ts +0 -1
  136. package/dist/data/persistent-vars.package-scope.test.js +0 -27
  137. package/dist/data/sync-recovery-queue.test.d.ts +0 -1
  138. package/dist/data/sync-recovery-queue.test.js +0 -215
  139. package/dist/data/table-signing.test.d.ts +0 -1
  140. package/dist/data/table-signing.test.js +0 -118
  141. package/dist/data/tool-access.test.d.ts +0 -1
  142. package/dist/data/tool-access.test.js +0 -166
  143. package/dist/data/user-permissions.test.d.ts +0 -1
  144. package/dist/data/user-permissions.test.js +0 -305
  145. package/dist/data/user-trust-levels.test.d.ts +0 -1
  146. package/dist/data/user-trust-levels.test.js +0 -37
  147. package/dist/define/also-implements.test.d.ts +0 -1
  148. package/dist/define/also-implements.test.js +0 -123
  149. package/dist/define/declare-contract.test.d.ts +0 -1
  150. package/dist/define/declare-contract.test.js +0 -573
  151. package/dist/define/define.test.d.ts +0 -1
  152. package/dist/define/define.test.js +0 -1010
  153. package/dist/define/empty-fields.test.d.ts +0 -1
  154. package/dist/define/empty-fields.test.js +0 -55
  155. package/dist/define/events-observables.test.d.ts +0 -1
  156. package/dist/define/events-observables.test.js +0 -1013
  157. package/dist/define/serve-members.test.d.ts +0 -1
  158. package/dist/define/serve-members.test.js +0 -630
  159. package/dist/define/vars.test.d.ts +0 -1
  160. package/dist/define/vars.test.js +0 -39
  161. package/dist/device/binary-peer-connection-v2.test.d.ts +0 -1
  162. package/dist/device/binary-peer-connection-v2.test.js +0 -730
  163. package/dist/device/binary-peer-connection.test.d.ts +0 -1
  164. package/dist/device/binary-peer-connection.test.js +0 -184
  165. package/dist/device/connection.test.d.ts +0 -1
  166. package/dist/device/connection.test.js +0 -613
  167. package/dist/device/device-election.test.d.ts +0 -1
  168. package/dist/device/device-election.test.js +0 -516
  169. package/dist/device/device.test.d.ts +0 -1
  170. package/dist/device/device.test.js +0 -243
  171. package/dist/device/frame-cipher.test.d.ts +0 -1
  172. package/dist/device/frame-cipher.test.js +0 -219
  173. package/dist/device/get-trust-level-fn.test.d.ts +0 -1
  174. package/dist/device/get-trust-level-fn.test.js +0 -685
  175. package/dist/device/streamed-socket.test.d.ts +0 -1
  176. package/dist/device/streamed-socket.test.js +0 -216
  177. package/dist/device/tx-encoding.test.d.ts +0 -1
  178. package/dist/device/tx-encoding.test.js +0 -295
  179. package/dist/device-pairing/cpace.test.d.ts +0 -1
  180. package/dist/device-pairing/cpace.test.js +0 -116
  181. package/dist/device-pairing/device-pairing.test.d.ts +0 -1
  182. package/dist/device-pairing/device-pairing.test.js +0 -211
  183. package/dist/hlc.test.d.ts +0 -1
  184. package/dist/hlc.test.js +0 -45
  185. package/dist/host-credentials.test.d.ts +0 -1
  186. package/dist/host-credentials.test.js +0 -88
  187. package/dist/identity/account-email.test.d.ts +0 -1
  188. package/dist/identity/account-email.test.js +0 -59
  189. package/dist/identity/anchor-document.test.d.ts +0 -1
  190. package/dist/identity/anchor-document.test.js +0 -16
  191. package/dist/identity/anchor-resolution.test.d.ts +0 -1
  192. package/dist/identity/anchor-resolution.test.js +0 -130
  193. package/dist/identity/key-change.test.d.ts +0 -1
  194. package/dist/identity/key-change.test.js +0 -811
  195. package/dist/invites/group-approval.test.d.ts +0 -1
  196. package/dist/invites/group-approval.test.js +0 -223
  197. package/dist/invites/invite-token.test.d.ts +0 -1
  198. package/dist/invites/invite-token.test.js +0 -123
  199. package/dist/keys.test.d.ts +0 -1
  200. package/dist/keys.test.js +0 -336
  201. package/dist/logging/console-logger.test.d.ts +0 -1
  202. package/dist/logging/console-logger.test.js +0 -300
  203. package/dist/logging/console-logs.table.test.d.ts +0 -1
  204. package/dist/logging/console-logs.table.test.js +0 -156
  205. package/dist/observable.test.d.ts +0 -1
  206. package/dist/observable.test.js +0 -309
  207. package/dist/package-build/build-package.test.d.ts +0 -1
  208. package/dist/package-build/build-package.test.js +0 -204
  209. package/dist/package-build/contract-add.test.d.ts +0 -1
  210. package/dist/package-build/contract-add.test.js +0 -467
  211. package/dist/package-build/freeze-contracts.test.d.ts +0 -1
  212. package/dist/package-build/freeze-contracts.test.js +0 -355
  213. package/dist/package-installer/package-author-signing.test.d.ts +0 -1
  214. package/dist/package-installer/package-author-signing.test.js +0 -200
  215. package/dist/package-installer/package-cloner.test.d.ts +0 -1
  216. package/dist/package-installer/package-cloner.test.js +0 -278
  217. package/dist/package-installer/package-creator.test.d.ts +0 -1
  218. package/dist/package-installer/package-creator.test.js +0 -908
  219. package/dist/package-installer/package-dev-tools.test.d.ts +0 -1
  220. package/dist/package-installer/package-dev-tools.test.js +0 -64
  221. package/dist/package-installer/package-installer.test.d.ts +0 -1
  222. package/dist/package-installer/package-installer.test.js +0 -882
  223. package/dist/package-installer/package-propagation.test.d.ts +0 -1
  224. package/dist/package-installer/package-propagation.test.js +0 -1269
  225. package/dist/package-installer/package-publisher.test.d.ts +0 -1
  226. package/dist/package-installer/package-publisher.test.js +0 -153
  227. package/dist/package-installer/package-remote-checker.test.d.ts +0 -1
  228. package/dist/package-installer/package-remote-checker.test.js +0 -334
  229. package/dist/package-installer/package-seed-installer.test.d.ts +0 -1
  230. package/dist/package-installer/package-seed-installer.test.js +0 -123
  231. package/dist/package-installer/package-tarball.test.d.ts +0 -1
  232. package/dist/package-installer/package-tarball.test.js +0 -75
  233. package/dist/package-installer/peers-core-installer.test.d.ts +0 -1
  234. package/dist/package-installer/peers-core-installer.test.js +0 -49
  235. package/dist/package-installer/peers-core-trust-anchor.test.d.ts +0 -1
  236. package/dist/package-installer/peers-core-trust-anchor.test.js +0 -155
  237. package/dist/package-loader/contract-package-loader.test.d.ts +0 -1
  238. package/dist/package-loader/contract-package-loader.test.js +0 -274
  239. package/dist/package-loader/host-authority-loading.test.d.ts +0 -1
  240. package/dist/package-loader/host-authority-loading.test.js +0 -104
  241. package/dist/package-loader/host-dispatch-policy.test.d.ts +0 -1
  242. package/dist/package-loader/host-dispatch-policy.test.js +0 -56
  243. package/dist/package-loader/isolated-artifact.test.d.ts +0 -1
  244. package/dist/package-loader/isolated-artifact.test.js +0 -688
  245. package/dist/package-loader/isolated-persistent-var-gateway.test.d.ts +0 -1
  246. package/dist/package-loader/isolated-persistent-var-gateway.test.js +0 -56
  247. package/dist/package-loader/isolated-table-gateway.test.d.ts +0 -1
  248. package/dist/package-loader/isolated-table-gateway.test.js +0 -633
  249. package/dist/package-loader/package-loader.test.d.ts +0 -1
  250. package/dist/package-loader/package-loader.test.js +0 -1764
  251. package/dist/package-loader/resolve-consumed-contracts.test.d.ts +0 -1
  252. package/dist/package-loader/resolve-consumed-contracts.test.js +0 -166
  253. package/dist/serial-json.compat.test.d.ts +0 -1
  254. package/dist/serial-json.compat.test.js +0 -369
  255. package/dist/serial-json.test.d.ts +0 -1
  256. package/dist/serial-json.test.js +0 -401
  257. package/dist/testing/mock-host-contract.test.d.ts +0 -1
  258. package/dist/testing/mock-host-contract.test.js +0 -782
  259. package/dist/utils.test.d.ts +0 -1
  260. package/dist/utils.test.js +0 -232
@@ -1,613 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- const nacl = require("tweetnacl");
4
- const keys_1 = require("../keys");
5
- const utils_1 = require("../utils");
6
- const binary_peer_connection_v2_1 = require("./binary-peer-connection-v2");
7
- const connection_1 = require("./connection");
8
- const device_1 = require("./device");
9
- const frame_cipher_1 = require("./frame-cipher");
10
- const socket_type_1 = require("./socket.type");
11
- function createTestSocket(localHandlers, remoteHandlers) {
12
- const socket = {
13
- id: (0, utils_1.newid)(),
14
- emit(eventName, args, callback) {
15
- const matching = remoteHandlers.filter(({ eventName: _eventName }) => eventName === _eventName);
16
- if (matching.length === 0) {
17
- // Same answer the real transports give for an event nobody handles.
18
- callback?.(`No handler registered for event: ${eventName}`);
19
- return;
20
- }
21
- matching.forEach(async ({ handler }) => {
22
- handler(args, callback);
23
- });
24
- },
25
- on(eventName, handler) {
26
- localHandlers.push({
27
- eventName,
28
- handler: async (...args) => handler(...args),
29
- });
30
- },
31
- removeAllListeners(eventName) {
32
- while (localHandlers.find(({ eventName: _eventName }) => eventName === _eventName)) {
33
- const index = localHandlers.findIndex(({ eventName: _eventName }) => eventName === _eventName);
34
- localHandlers.splice(index, 1);
35
- }
36
- },
37
- disconnect() {
38
- // Simulate disconnection logic if needed
39
- },
40
- };
41
- return socket;
42
- }
43
- function createTestSocketPair() {
44
- const clientHandlers = [];
45
- const serverHandlers = [];
46
- const clientSocket = createTestSocket(clientHandlers, serverHandlers);
47
- const serverSocket = createTestSocket(serverHandlers, clientHandlers);
48
- const connectionId = (0, utils_1.newid)();
49
- clientSocket.id = connectionId;
50
- serverSocket.id = connectionId;
51
- return {
52
- clientSocket,
53
- serverSocket,
54
- };
55
- }
56
- describe(connection_1.Connection, () => {
57
- it("should allow simulating a client and server connection handshake", async () => {
58
- const { clientSocket, serverSocket } = createTestSocketPair();
59
- const clientDevice = new device_1.Device(undefined, undefined, undefined, {
60
- userName: "Client user",
61
- deviceName: "Client laptop",
62
- });
63
- const serverDevice = new device_1.Device(undefined, undefined, undefined, {
64
- userName: "Server user",
65
- deviceName: "Server desktop",
66
- });
67
- const clientConnection = new connection_1.Connection(clientSocket, clientDevice);
68
- const serverConnection = new connection_1.Connection(serverSocket, serverDevice, ["localhost"]);
69
- expect(clientConnection.connectionId).toBe(serverConnection.connectionId);
70
- const response = await clientConnection.doHandshake("localhost");
71
- expect(response.userId).toBe(serverDevice.userId);
72
- expect(response.deviceId).toBe(serverDevice.deviceId);
73
- expect(response.publicKey).toBe(serverDevice.publicKey);
74
- expect(response.publicBoxKey).toBe(serverDevice.publicBoxKey);
75
- expect(response.serverAddress).toBe("localhost");
76
- expect(response.connectionId).toBe(serverConnection.connectionId);
77
- expect(response.userName).toBe("Server user");
78
- expect(response.deviceName).toBe("Server desktop");
79
- expect(clientConnection.remoteDeviceInfo).toMatchObject({
80
- userName: "Server user",
81
- deviceName: "Server desktop",
82
- });
83
- expect(serverConnection.remoteDeviceInfo).toMatchObject({
84
- userName: "Client user",
85
- deviceName: "Client laptop",
86
- });
87
- serverConnection.removeAllListeners("ping");
88
- serverConnection.exposeRPC("ping", async (n, s) => `pong - ${n}, ${s}`);
89
- const pong = await clientConnection.emit("ping", 1, "hello");
90
- expect(pong).toBe("pong - 1, hello");
91
- });
92
- it("should create a new id if socket doesn't have one", async () => {
93
- const socket = {
94
- id: (0, utils_1.newid)(),
95
- emit(_eventName, _args, _callback) {
96
- // do nothing
97
- },
98
- on(_eventName, _handler) {
99
- // do nothing
100
- },
101
- removeAllListeners(_eventName) {
102
- // do nothing
103
- },
104
- disconnect() {
105
- // do nothing
106
- },
107
- };
108
- const connection = new connection_1.Connection(socket, new device_1.Device());
109
- expect(connection.connectionId).toBeTruthy();
110
- });
111
- it("client should requestSecure if both are using https", async () => {
112
- const { clientSocket, serverSocket } = createTestSocketPair();
113
- const clientDevice = new device_1.Device();
114
- const serverDevice = new device_1.Device();
115
- const clientConnection = new connection_1.Connection(clientSocket, clientDevice);
116
- const _serverConnection = new connection_1.Connection(serverSocket, serverDevice, ["https://localhost"]);
117
- await clientConnection.doHandshake("https://localhost");
118
- expect(clientConnection.encryptTraffic).toBe(false);
119
- // and allow forcing insecure
120
- clientConnection.overrideEncryption = "encrypt-traffic-regardless-of-protocol";
121
- expect(clientConnection.encryptTraffic).toBe(true);
122
- // and only return a copy of the remoteDeviceInfo
123
- expect(clientConnection.remoteDeviceInfo).not.toBe(clientConnection.remoteDeviceInfo);
124
- });
125
- it("should gracefully handle remote errors for secure connections", async () => {
126
- const { clientSocket, serverSocket } = createTestSocketPair();
127
- const clientDevice = new device_1.Device();
128
- const serverDevice = new device_1.Device();
129
- const clientConnection = new connection_1.Connection(clientSocket, clientDevice);
130
- const serverConnection = new connection_1.Connection(serverSocket, serverDevice, ["https://localhost"]);
131
- await clientConnection.doHandshake("https://localhost");
132
- expect(clientConnection.encryptTraffic).toBe(false);
133
- expect(serverConnection.encryptTraffic).toBe(false);
134
- serverConnection.removeAllListeners("ping");
135
- serverConnection.exposeRPC("ping", async () => {
136
- throw new Error("fake error");
137
- });
138
- const response = await clientConnection.emit("ping").catch((err) => err);
139
- expect(response).toEqual({
140
- errorType: "RPC_ERROR",
141
- error: "fake error",
142
- });
143
- });
144
- it("should gracefully handle remote errors for unsecure connections", async () => {
145
- const { clientSocket, serverSocket } = createTestSocketPair();
146
- const clientDevice = new device_1.Device();
147
- const serverDevice = new device_1.Device();
148
- const clientConnection = new connection_1.Connection(clientSocket, clientDevice);
149
- const serverConnection = new connection_1.Connection(serverSocket, serverDevice, ["http://localhost"]);
150
- await clientConnection.doHandshake("http://localhost");
151
- expect(clientConnection.encryptTraffic).toBe(true);
152
- expect(serverConnection.encryptTraffic).toBe(true);
153
- serverConnection.removeAllListeners("ping");
154
- serverConnection.exposeRPC("ping", async () => {
155
- throw new Error("fake error");
156
- });
157
- const response = await clientConnection.emit("ping").catch((err) => err);
158
- expect(response).toEqual({
159
- errorType: "RPC_ERROR",
160
- error: "fake error",
161
- });
162
- });
163
- it("should ignore other events before the handshake is finished", async () => {
164
- const { clientSocket, serverSocket } = createTestSocketPair();
165
- const clientDevice = new device_1.Device();
166
- const serverDevice = new device_1.Device();
167
- const clientConnection = new connection_1.Connection(clientSocket, clientDevice);
168
- const serverConnection = new connection_1.Connection(serverSocket, serverDevice, ["https://localhost"]);
169
- serverConnection.exposeRPC("ping", async () => "pong");
170
- expect(serverConnection.verified).toBe(false);
171
- expect(clientConnection.verified).toBe(false);
172
- const response = await clientConnection.emit("ping").catch((err) => err);
173
- expect(response).toMatch(/Connection not verified/);
174
- });
175
- it("client should detect different connection ids during handshake", async () => {
176
- const serverAddress = "http://localhost";
177
- const { clientSocket, serverSocket } = createTestSocketPair();
178
- const clientDevice = new device_1.Device();
179
- const serverDevice = new device_1.Device();
180
- const clientConnection = new connection_1.Connection(clientSocket, clientDevice);
181
- const serverConnection = new connection_1.Connection(serverSocket, serverDevice, [serverAddress]);
182
- serverConnection.exposeRPC("ping", async () => "pong");
183
- serverConnection.socket.removeAllListeners("completeHandshake");
184
- serverConnection.exposeRPC("completeHandshake", async (handshakeBox) => {
185
- const handshake = await serverConnection.completeHandshake(handshakeBox);
186
- handshake.connectionId = "fake";
187
- return handshake;
188
- });
189
- const result = await clientConnection.doHandshake(serverAddress).catch((err) => String(err));
190
- expect(result).toMatch(/Invalid connectionId/);
191
- });
192
- it("client should detect different device ids during handshake", async () => {
193
- const serverAddress = "http://localhost";
194
- const { clientSocket, serverSocket } = createTestSocketPair();
195
- const clientDevice = new device_1.Device();
196
- const serverDevice = new device_1.Device();
197
- const clientConnection = new connection_1.Connection(clientSocket, clientDevice);
198
- const serverConnection = new connection_1.Connection(serverSocket, serverDevice, [serverAddress]);
199
- serverConnection.exposeRPC("ping", async () => "pong");
200
- serverConnection.socket.removeAllListeners("completeHandshake");
201
- serverConnection.exposeRPC("completeHandshake", async (handshakeBox) => {
202
- const handshake = await serverConnection.completeHandshake(handshakeBox);
203
- handshake.deviceId = (0, utils_1.newid)();
204
- return handshake;
205
- });
206
- const result = await clientConnection.doHandshake(serverAddress).catch((err) => String(err));
207
- expect(result).toMatch(/Inconsistent device info/);
208
- });
209
- it("client should detect different device ids during handshake", async () => {
210
- const serverAddress = "http://localhost";
211
- const { clientSocket, serverSocket } = createTestSocketPair();
212
- const clientDevice = new device_1.Device();
213
- const serverDevice = new device_1.Device();
214
- const clientConnection = new connection_1.Connection(clientSocket, clientDevice);
215
- const serverConnection = new connection_1.Connection(serverSocket, serverDevice, [serverAddress]);
216
- serverConnection.exposeRPC("ping", async () => "pong");
217
- serverConnection.socket.removeAllListeners("completeHandshake");
218
- serverConnection.exposeRPC("completeHandshake", async (handshakeBox) => {
219
- const handshake = await serverConnection.completeHandshake(handshakeBox);
220
- handshake.userId = (0, utils_1.newid)();
221
- return handshake;
222
- });
223
- const result = await clientConnection.doHandshake(serverAddress).catch((err) => String(err));
224
- expect(result).toMatch(/Inconsistent device info/);
225
- });
226
- it("client should detect different box key during handshake", async () => {
227
- const serverAddress = "http://localhost";
228
- const { clientSocket, serverSocket } = createTestSocketPair();
229
- const clientDevice = new device_1.Device();
230
- const serverDevice = new device_1.Device();
231
- const clientConnection = new connection_1.Connection(clientSocket, clientDevice);
232
- const serverConnection = new connection_1.Connection(serverSocket, serverDevice, [serverAddress]);
233
- serverConnection.exposeRPC("ping", async () => "pong");
234
- serverConnection.socket.removeAllListeners("completeHandshake");
235
- serverConnection.exposeRPC("completeHandshake", async (handshakeBox) => {
236
- const handshake = await serverConnection.completeHandshake(handshakeBox);
237
- const _keys = (0, keys_1.newKeys)();
238
- handshake.publicBoxKey = _keys.publicBoxKey;
239
- return handshake;
240
- });
241
- const result = await clientConnection.doHandshake(serverAddress).catch((err) => String(err));
242
- expect(result).toMatch(/Inconsistent public keys/);
243
- });
244
- it("client should detect different public key during handshake", async () => {
245
- const serverAddress = "http://localhost";
246
- const { clientSocket, serverSocket } = createTestSocketPair();
247
- const clientDevice = new device_1.Device();
248
- const serverDevice = new device_1.Device();
249
- const clientConnection = new connection_1.Connection(clientSocket, clientDevice);
250
- const serverConnection = new connection_1.Connection(serverSocket, serverDevice, [serverAddress]);
251
- serverConnection.exposeRPC("ping", async () => "pong");
252
- serverConnection.socket.removeAllListeners("completeHandshake");
253
- serverConnection.exposeRPC("completeHandshake", async (handshakeBox) => {
254
- const handshake = await serverConnection.completeHandshake(handshakeBox);
255
- const _keys = (0, keys_1.newKeys)();
256
- handshake.publicKey = _keys.publicKey;
257
- return handshake;
258
- });
259
- const result = await clientConnection.doHandshake(serverAddress).catch((err) => String(err));
260
- expect(result).toMatch(/Inconsistent public keys/);
261
- });
262
- it("refuses an untrusted client without leaving an unhandled rejection behind", async () => {
263
- // The server tells the client to reset as a courtesy. A client that is not itself a
264
- // server has no `reset` handler, so that call fails; the failure must not escape as an
265
- // unhandled rejection, which would take down a host with no process-level handler
266
- // (peers-services) every time a device presents a retired key.
267
- const serverAddress = "http://localhost";
268
- const { clientSocket, serverSocket } = createTestSocketPair();
269
- const clientConnection = new connection_1.Connection(clientSocket, new device_1.Device());
270
- const serverConnection = new connection_1.Connection(serverSocket, new device_1.Device(), [serverAddress], () => Promise.resolve(socket_type_1.TrustLevel.Untrusted));
271
- const unhandled = jest.fn();
272
- process.on("unhandledRejection", unhandled);
273
- try {
274
- const result = await clientConnection
275
- .doHandshake(serverAddress)
276
- .catch((err) => err?.error ?? String(err));
277
- expect(result).toMatch(/Untrusted connection/);
278
- await (0, utils_1.sleep)(20);
279
- expect(unhandled).not.toHaveBeenCalled();
280
- expect(serverConnection.verified).toBe(false);
281
- }
282
- finally {
283
- process.off("unhandledRejection", unhandled);
284
- }
285
- });
286
- it("should handle RPC calls with large arguments and responses", async () => {
287
- const { clientSocket, serverSocket } = createTestSocketPair();
288
- const clientDevice = new device_1.Device();
289
- const serverDevice = new device_1.Device();
290
- const clientConnection = new connection_1.Connection(clientSocket, clientDevice);
291
- const serverConnection = new connection_1.Connection(serverSocket, serverDevice, ["localhost"]);
292
- await clientConnection.doHandshake("localhost");
293
- // Create large data
294
- const largeData = {
295
- message: "A".repeat(500),
296
- metadata: "B".repeat(300),
297
- payload: "C".repeat(400),
298
- };
299
- serverConnection.exposeRPC("processLargeData", async (data) => {
300
- return {
301
- received: data,
302
- processedSize: JSON.stringify(data).length,
303
- };
304
- });
305
- const result = await clientConnection.emit("processLargeData", largeData);
306
- expect(result.received.message).toBe("A".repeat(500));
307
- expect(result.received.metadata).toBe("B".repeat(300));
308
- expect(result.received.payload).toBe("C".repeat(400));
309
- expect(result.processedSize).toBe(JSON.stringify(largeData).length);
310
- });
311
- it("should reject handshake if device timestamps are too far apart", async () => {
312
- const { clientSocket, serverSocket } = createTestSocketPair();
313
- const clientDevice = new device_1.Device();
314
- const serverDevice = new device_1.Device();
315
- const clientConnection = new connection_1.Connection(clientSocket, clientDevice);
316
- const serverConnection = new connection_1.Connection(serverSocket, serverDevice, ["localhost"]);
317
- // Set a very strict timestamp tolerance (1 second) to make test reliable
318
- serverConnection.handshakeTimestampToleranceMs = 1000;
319
- // Mock the client device to send an old timestamp
320
- const originalGetHandshake = clientDevice.getHandshake.bind(clientDevice);
321
- clientDevice.getHandshake = (connectionId, serverAddress) => {
322
- const handshake = originalGetHandshake(connectionId, serverAddress);
323
- return clientDevice.signObjectWithSecretKey({
324
- ...handshake.contents,
325
- // Make timestamp 2 seconds in the past (beyond tolerance)
326
- timestamp: Date.now() - 2000,
327
- });
328
- };
329
- const result = await clientConnection
330
- .doHandshake("localhost")
331
- .catch((err) => err.message || err.error || String(err));
332
- expect(result).toMatch(/Remote device's system clock is too far out of sync/);
333
- });
334
- it.todo("should handle RPC calls that return undefined");
335
- // ─── Security: key confusion attack ────────────────────────────────────────
336
- //
337
- // openSignedObject verifies the signature using signedObj.publicKey (the
338
- // envelope key — the ACTUAL signer). Identity is then recorded from
339
- // contents.publicKey (the CLAIMED key). There is no check that these match.
340
- //
341
- // A malicious peer can sign a handshake with their real key KA while
342
- // claiming victim's publicKey KV in the payload contents. The signature
343
- // check passes, but the server registers KV as the connected identity.
344
- //
345
- // Fix: after openSignedObject succeeds, assert
346
- // signedHandshake.publicKey === signedHandshake.contents.publicKey
347
- //
348
- describe("Security: key confusion — signing key vs claimed identity key", () => {
349
- it("rejects handshake where signing key (KA) differs from claimed identity key in contents (KV)", async () => {
350
- const serverAddress = "http://localhost";
351
- const { clientSocket, serverSocket } = createTestSocketPair();
352
- const attackerDevice = new device_1.Device();
353
- const victimDevice = new device_1.Device(); // identity the attacker wants to impersonate
354
- const serverDevice = new device_1.Device();
355
- const attackerConnection = new connection_1.Connection(clientSocket, attackerDevice);
356
- const serverConnection = new connection_1.Connection(serverSocket, serverDevice, [serverAddress]);
357
- // Craft a malicious handshake:
358
- // signedObj.publicKey = KA (attacker's real signing key — used for verification)
359
- // contents.publicKey = KV (victim's signing key — recorded as identity)
360
- // contents.userId = victim's userId
361
- // contents.publicBoxKey = KA_box (attacker's box key, kept so the server
362
- // boxes its response for the attacker and
363
- // the attacker can decrypt it to finish the
364
- // handshake — making the whole flow succeed)
365
- const originalGetHandshake = attackerDevice.getHandshake.bind(attackerDevice);
366
- attackerDevice.getHandshake = (connectionId, addr) => {
367
- const real = originalGetHandshake(connectionId, addr);
368
- const maliciousContents = {
369
- ...real.contents, // keep connectionId, timestamp, serverAddress
370
- userId: victimDevice.userId, // claim victim's userId
371
- publicKey: victimDevice.publicKey, // claim victim's Ed25519 key (KV)
372
- // publicBoxKey stays as attacker's own box key (KA_box) so the server
373
- // encrypts its handshake response for a key the attacker can open
374
- };
375
- // Sign with attacker's secret key:
376
- // signedObj.publicKey = KA (actual signer)
377
- // contents.publicKey = KV (claimed identity) — DIFFERENT
378
- return attackerDevice.signObjectWithSecretKey(maliciousContents);
379
- };
380
- // The server must reject this — the signing key (KA) does not match the
381
- // claimed identity key in the payload contents (KV).
382
- // Server-side errors travel back through the RPC layer as plain objects
383
- // { error: '...', errorType: 'RPC_ERROR' } rather than Error instances.
384
- const result = await attackerConnection.doHandshake(serverAddress).catch((err) => err);
385
- const errorMessage = result instanceof Error ? result.message : (result?.error ?? String(result));
386
- expect(errorMessage).toMatch(/signing key does not match claimed identity key/i);
387
- // Neither side should be left in a verified state
388
- expect(attackerConnection.verified).toBe(false);
389
- expect(serverConnection.verified).toBe(false);
390
- });
391
- });
392
- // ─── Frame cipher ──────────────────────────────────────────────────────────
393
- //
394
- // These run over real binary peer sockets (the production framing) so the
395
- // handshake actually arms the cipher and the wire can be inspected.
396
- describe("frame cipher", () => {
397
- class TapPeer {
398
- other;
399
- sent = [];
400
- destroyed = false;
401
- dataHandlers = [];
402
- closeHandlers = [];
403
- on(event, handler) {
404
- if (event === "data")
405
- this.dataHandlers.push(handler);
406
- if (event === "close")
407
- this.closeHandlers.push(handler);
408
- }
409
- send(data) {
410
- const bytes = Buffer.from(data);
411
- this.sent.push(bytes);
412
- const target = this.other;
413
- if (target) {
414
- setImmediate(() => {
415
- for (const h of target.dataHandlers)
416
- h(bytes);
417
- });
418
- }
419
- }
420
- destroy() {
421
- this.destroyed = true;
422
- for (const h of this.closeHandlers)
423
- h();
424
- }
425
- }
426
- function pair(protocol, opts = {}) {
427
- const clientPeer = new TapPeer();
428
- const serverPeer = new TapPeer();
429
- clientPeer.other = serverPeer;
430
- serverPeer.other = clientPeer;
431
- const connectionId = (0, utils_1.newid)();
432
- const userId = (0, utils_1.newid)();
433
- const clientDevice = new device_1.Device(userId, (0, utils_1.newid)(), (0, keys_1.newKeys)());
434
- const serverDevice = new device_1.Device(userId, (0, utils_1.newid)(), (0, keys_1.newKeys)());
435
- const client = (0, binary_peer_connection_v2_1.wrapBinaryPeer)(connectionId, clientPeer, clientDevice, true, { protocol });
436
- const server = (0, binary_peer_connection_v2_1.wrapBinaryPeer)(connectionId, serverPeer, serverDevice, false, { protocol });
437
- // A "legacy" peer is one whose socket cannot arm a cipher, so it never advertises frameCrypto.
438
- if (opts.legacyClient)
439
- delete client.socket.armFrameCipher;
440
- if (opts.legacyServer)
441
- delete server.socket.armFrameCipher;
442
- return {
443
- clientPeer,
444
- serverPeer,
445
- client,
446
- server,
447
- clientDevice,
448
- serverDevice,
449
- address: `${protocol}://${connectionId}`,
450
- };
451
- }
452
- function wire(...peers) {
453
- return peers.flatMap((p) => p.sent);
454
- }
455
- for (const protocol of ["ws", "wrtc"]) {
456
- it(`arms both sides after the handshake on ${protocol} and stops boxing RPC`, async () => {
457
- const { client, server, clientDevice, serverDevice, clientPeer, serverPeer, address } = pair(protocol);
458
- const clientBox = jest.spyOn(clientDevice, "signAndBoxDataForDevice");
459
- const serverBox = jest.spyOn(serverDevice, "signAndBoxDataForDevice");
460
- const warn = jest.spyOn(console, "warn").mockImplementation(() => { });
461
- try {
462
- await client.doHandshake(address);
463
- expect(client.frameCipherArmed).toBe(true);
464
- expect(server.frameCipherArmed).toBe(true);
465
- expect(client.verified).toBe(true);
466
- expect(server.verified).toBe(true);
467
- expect(client.encryptTraffic).toBe(false);
468
- expect(server.encryptTraffic).toBe(false);
469
- expect(warn).not.toHaveBeenCalledWith(expect.stringContaining("does not support frame encryption"), expect.anything());
470
- // The only box+sign so far is the server's handshake response.
471
- expect(serverBox).toHaveBeenCalledTimes(1);
472
- expect(clientBox).toHaveBeenCalledTimes(0);
473
- // Application RPC: no envelope, but sealed on the wire.
474
- const marker = `marker-${(0, utils_1.newid)()}`;
475
- server.exposeRPC("echo", async (s) => `${s}!`);
476
- const clientBefore = clientPeer.sent.length;
477
- const serverBefore = serverPeer.sent.length;
478
- expect(await client.emit("echo", marker)).toBe(`${marker}!`);
479
- expect(clientBox).toHaveBeenCalledTimes(0);
480
- expect(serverBox).toHaveBeenCalledTimes(1);
481
- const rpcFrames = [
482
- ...clientPeer.sent.slice(clientBefore),
483
- ...serverPeer.sent.slice(serverBefore),
484
- ];
485
- expect(rpcFrames.length).toBe(2);
486
- for (const frame of rpcFrames) {
487
- expect(frame[0]).toBe(frame_cipher_1.FRAME_ENC);
488
- expect(frame.indexOf(Buffer.from(marker))).toBe(-1);
489
- }
490
- // Streams: delivered and sealed.
491
- const payload = nacl.randomBytes(48);
492
- const received = new Promise((resolve) => server.socket.onRawBytes?.("s", (d) => resolve(d)));
493
- await client.socket.sendRawBytes?.("s", payload);
494
- expect(Buffer.from(await received)).toEqual(Buffer.from(payload));
495
- const last = clientPeer.sent[clientPeer.sent.length - 1];
496
- expect(last[0]).toBe(frame_cipher_1.FRAME_ENC);
497
- expect(last.indexOf(Buffer.from(payload))).toBe(-1);
498
- }
499
- finally {
500
- warn.mockRestore();
501
- clientPeer.destroy();
502
- serverPeer.destroy();
503
- }
504
- });
505
- }
506
- it("no longer double-encrypts over wrtc (finding 2)", async () => {
507
- const { client, server, clientPeer, serverPeer, address } = pair("wrtc");
508
- const warn = jest.spyOn(console, "warn").mockImplementation(() => { });
509
- try {
510
- await client.doHandshake(address);
511
- // Before: client {secureLocal: true, secureRemote: false}, server the
512
- // reverse, encryptTraffic true on both. Now the cipher decides.
513
- expect(client.encryptTraffic).toBe(false);
514
- expect(server.encryptTraffic).toBe(false);
515
- expect(client.frameCipherArmed).toBe(true);
516
- // requestSecure is never sent when the cipher is armed.
517
- const plaintextFrames = wire(clientPeer, serverPeer).filter((f) => f[0] !== frame_cipher_1.FRAME_ENC);
518
- for (const frame of plaintextFrames) {
519
- expect(frame.indexOf(Buffer.from("requestSecure"))).toBe(-1);
520
- }
521
- }
522
- finally {
523
- warn.mockRestore();
524
- clientPeer.destroy();
525
- serverPeer.destroy();
526
- }
527
- });
528
- it("only the handshake frames are plaintext, and the ephemeral keys are never in the clear", async () => {
529
- const { client, clientPeer, serverPeer, address } = pair("ws");
530
- await client.doHandshake(address);
531
- const frames = wire(clientPeer, serverPeer);
532
- // reset, requestDeviceInfo, completeHandshake: 3 requests + 3 replies in the clear.
533
- const plaintext = frames.filter((f) => f[0] !== frame_cipher_1.FRAME_ENC);
534
- expect(plaintext.length).toBe(6);
535
- for (const frame of plaintext) {
536
- expect(frame.indexOf(Buffer.from("ephemeralBoxKey"))).toBe(-1);
537
- }
538
- clientPeer.destroy();
539
- serverPeer.destroy();
540
- });
541
- it("drops plaintext stream frames before the handshake completes", async () => {
542
- const { client, server, clientPeer, serverPeer, address } = pair("ws");
543
- let delivered = 0;
544
- server.socket.onRawBytes?.("early", () => delivered++);
545
- await client.socket.sendRawBytes?.("early", new Uint8Array([1, 2, 3]));
546
- await (0, utils_1.sleep)(20);
547
- expect(delivered).toBe(0);
548
- expect(serverPeer.destroyed).toBe(false);
549
- await client.doHandshake(address);
550
- await client.socket.sendRawBytes?.("early", new Uint8Array([4]));
551
- await (0, utils_1.sleep)(20);
552
- expect(delivered).toBe(1);
553
- clientPeer.destroy();
554
- serverPeer.destroy();
555
- });
556
- for (const [label, opts] of [
557
- ["legacy client", { legacyClient: true }],
558
- ["legacy server", { legacyServer: true }],
559
- ]) {
560
- it(`falls back to the legacy envelope and warns against a ${label}`, async () => {
561
- const { client, server, clientDevice, clientPeer, serverPeer, address } = pair("ws", opts);
562
- const warn = jest.spyOn(console, "warn").mockImplementation(() => { });
563
- const clientBox = jest.spyOn(clientDevice, "signAndBoxDataForDevice");
564
- try {
565
- await client.doHandshake(address);
566
- expect(client.verified).toBe(true);
567
- expect(server.verified).toBe(true);
568
- expect(client.frameCipherArmed).toBe(false);
569
- expect(server.frameCipherArmed).toBe(false);
570
- // ws://: legacy classification says encrypt per message.
571
- expect(client.encryptTraffic).toBe(true);
572
- expect(server.encryptTraffic).toBe(true);
573
- expect(warn).toHaveBeenCalledWith(expect.stringContaining("does not support frame encryption"), expect.objectContaining({ transport: "ws" }));
574
- server.exposeRPC("echo", async (s) => `${s}!`);
575
- expect(await client.emit("echo", "hi")).toBe("hi!");
576
- expect(clientBox).toHaveBeenCalled();
577
- for (const frame of wire(clientPeer, serverPeer)) {
578
- expect(frame[0]).not.toBe(frame_cipher_1.FRAME_ENC);
579
- }
580
- // Plaintext streams are delivered once the legacy handshake verified the peer.
581
- let delivered = 0;
582
- server.socket.onRawBytes?.("legacy", () => delivered++);
583
- await client.socket.sendRawBytes?.("legacy", new Uint8Array([1]));
584
- await (0, utils_1.sleep)(20);
585
- expect(delivered).toBe(1);
586
- }
587
- finally {
588
- warn.mockRestore();
589
- clientPeer.destroy();
590
- serverPeer.destroy();
591
- }
592
- });
593
- }
594
- it("ignores dont-encrypt-traffic-after-handshake outside NODE_ENV=test", async () => {
595
- const { client, clientPeer, serverPeer, address } = pair("ws", { legacyServer: true });
596
- const warn = jest.spyOn(console, "warn").mockImplementation(() => { });
597
- const previous = process.env.NODE_ENV;
598
- try {
599
- await client.doHandshake(address);
600
- client.overrideEncryption = "dont-encrypt-traffic-after-handshake";
601
- expect(client.encryptTraffic).toBe(false);
602
- process.env.NODE_ENV = "production";
603
- expect(client.encryptTraffic).toBe(true);
604
- }
605
- finally {
606
- process.env.NODE_ENV = previous;
607
- warn.mockRestore();
608
- clientPeer.destroy();
609
- serverPeer.destroy();
610
- }
611
- });
612
- });
613
- });
@@ -1 +0,0 @@
1
- export {};