gitspace 0.2.0-rc.2 → 0.2.0-rc.21

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 (316) hide show
  1. package/README.md +68 -38
  2. package/package.json +36 -25
  3. package/.claude/settings.local.json +0 -21
  4. package/.gitspace/bundle.json +0 -50
  5. package/.gitspace/select/01-status.sh +0 -40
  6. package/.gitspace/setup/01-install-deps.sh +0 -12
  7. package/.gitspace/setup/02-typecheck.sh +0 -16
  8. package/AGENTS.md +0 -439
  9. package/CLAUDE.md +0 -1
  10. package/bun.lock +0 -647
  11. package/docs/CONNECTION.md +0 -623
  12. package/docs/GATEWAY-WORKER.md +0 -319
  13. package/docs/GETTING-STARTED.md +0 -448
  14. package/docs/GITSPACE-PLATFORM.md +0 -1819
  15. package/docs/INFRASTRUCTURE.md +0 -1347
  16. package/docs/PROTOCOL.md +0 -619
  17. package/docs/QUICKSTART.md +0 -174
  18. package/docs/RELAY.md +0 -327
  19. package/docs/REMOTE-DESIGN.md +0 -549
  20. package/docs/ROADMAP.md +0 -564
  21. package/docs/SITE_DOCS_FIGMA_MAKE.md +0 -1167
  22. package/docs/STACK-DESIGN.md +0 -588
  23. package/docs/UNIFIED_ARCHITECTURE.md +0 -292
  24. package/experiments/pty-benchmark.ts +0 -148
  25. package/experiments/pty-latency.ts +0 -100
  26. package/experiments/router/client.ts +0 -199
  27. package/experiments/router/protocol.ts +0 -74
  28. package/experiments/router/router.ts +0 -217
  29. package/experiments/router/session.ts +0 -180
  30. package/experiments/router/test.ts +0 -133
  31. package/experiments/socket-bandwidth.ts +0 -77
  32. package/homebrew/gitspace.rb +0 -45
  33. package/landing-page/ATTRIBUTIONS.md +0 -3
  34. package/landing-page/README.md +0 -11
  35. package/landing-page/bun.lock +0 -801
  36. package/landing-page/guidelines/Guidelines.md +0 -61
  37. package/landing-page/index.html +0 -37
  38. package/landing-page/package.json +0 -90
  39. package/landing-page/postcss.config.mjs +0 -15
  40. package/landing-page/public/_redirects +0 -1
  41. package/landing-page/public/favicon.png +0 -0
  42. package/landing-page/src/app/App.tsx +0 -53
  43. package/landing-page/src/app/components/figma/ImageWithFallback.tsx +0 -27
  44. package/landing-page/src/app/components/ui/accordion.tsx +0 -66
  45. package/landing-page/src/app/components/ui/alert-dialog.tsx +0 -157
  46. package/landing-page/src/app/components/ui/alert.tsx +0 -66
  47. package/landing-page/src/app/components/ui/aspect-ratio.tsx +0 -11
  48. package/landing-page/src/app/components/ui/avatar.tsx +0 -53
  49. package/landing-page/src/app/components/ui/badge.tsx +0 -46
  50. package/landing-page/src/app/components/ui/breadcrumb.tsx +0 -109
  51. package/landing-page/src/app/components/ui/button.tsx +0 -57
  52. package/landing-page/src/app/components/ui/calendar.tsx +0 -75
  53. package/landing-page/src/app/components/ui/card.tsx +0 -92
  54. package/landing-page/src/app/components/ui/carousel.tsx +0 -241
  55. package/landing-page/src/app/components/ui/chart.tsx +0 -353
  56. package/landing-page/src/app/components/ui/checkbox.tsx +0 -32
  57. package/landing-page/src/app/components/ui/collapsible.tsx +0 -33
  58. package/landing-page/src/app/components/ui/command.tsx +0 -177
  59. package/landing-page/src/app/components/ui/context-menu.tsx +0 -252
  60. package/landing-page/src/app/components/ui/dialog.tsx +0 -135
  61. package/landing-page/src/app/components/ui/drawer.tsx +0 -132
  62. package/landing-page/src/app/components/ui/dropdown-menu.tsx +0 -257
  63. package/landing-page/src/app/components/ui/form.tsx +0 -168
  64. package/landing-page/src/app/components/ui/hover-card.tsx +0 -44
  65. package/landing-page/src/app/components/ui/input-otp.tsx +0 -77
  66. package/landing-page/src/app/components/ui/input.tsx +0 -21
  67. package/landing-page/src/app/components/ui/label.tsx +0 -24
  68. package/landing-page/src/app/components/ui/menubar.tsx +0 -276
  69. package/landing-page/src/app/components/ui/navigation-menu.tsx +0 -168
  70. package/landing-page/src/app/components/ui/pagination.tsx +0 -127
  71. package/landing-page/src/app/components/ui/popover.tsx +0 -48
  72. package/landing-page/src/app/components/ui/progress.tsx +0 -31
  73. package/landing-page/src/app/components/ui/radio-group.tsx +0 -45
  74. package/landing-page/src/app/components/ui/resizable.tsx +0 -56
  75. package/landing-page/src/app/components/ui/scroll-area.tsx +0 -58
  76. package/landing-page/src/app/components/ui/select.tsx +0 -189
  77. package/landing-page/src/app/components/ui/separator.tsx +0 -28
  78. package/landing-page/src/app/components/ui/sheet.tsx +0 -139
  79. package/landing-page/src/app/components/ui/sidebar.tsx +0 -726
  80. package/landing-page/src/app/components/ui/skeleton.tsx +0 -13
  81. package/landing-page/src/app/components/ui/slider.tsx +0 -63
  82. package/landing-page/src/app/components/ui/sonner.tsx +0 -25
  83. package/landing-page/src/app/components/ui/switch.tsx +0 -31
  84. package/landing-page/src/app/components/ui/table.tsx +0 -116
  85. package/landing-page/src/app/components/ui/tabs.tsx +0 -66
  86. package/landing-page/src/app/components/ui/textarea.tsx +0 -18
  87. package/landing-page/src/app/components/ui/toggle-group.tsx +0 -73
  88. package/landing-page/src/app/components/ui/toggle.tsx +0 -47
  89. package/landing-page/src/app/components/ui/tooltip.tsx +0 -61
  90. package/landing-page/src/app/components/ui/use-mobile.ts +0 -21
  91. package/landing-page/src/app/components/ui/utils.ts +0 -6
  92. package/landing-page/src/components/docs/DocsContent.tsx +0 -718
  93. package/landing-page/src/components/docs/DocsSidebar.tsx +0 -84
  94. package/landing-page/src/components/landing/CTA.tsx +0 -59
  95. package/landing-page/src/components/landing/Comparison.tsx +0 -84
  96. package/landing-page/src/components/landing/FaultyTerminal.tsx +0 -424
  97. package/landing-page/src/components/landing/Features.tsx +0 -201
  98. package/landing-page/src/components/landing/Hero.tsx +0 -142
  99. package/landing-page/src/components/landing/Pricing.tsx +0 -140
  100. package/landing-page/src/components/landing/Roadmap.tsx +0 -86
  101. package/landing-page/src/components/landing/Security.tsx +0 -81
  102. package/landing-page/src/components/landing/TerminalWindow.tsx +0 -27
  103. package/landing-page/src/components/landing/UseCases.tsx +0 -55
  104. package/landing-page/src/components/landing/Workflow.tsx +0 -101
  105. package/landing-page/src/components/layout/DashboardNavbar.tsx +0 -37
  106. package/landing-page/src/components/layout/Footer.tsx +0 -55
  107. package/landing-page/src/components/layout/LandingNavbar.tsx +0 -82
  108. package/landing-page/src/components/ui/badge.tsx +0 -39
  109. package/landing-page/src/components/ui/breadcrumb.tsx +0 -115
  110. package/landing-page/src/components/ui/button.tsx +0 -57
  111. package/landing-page/src/components/ui/card.tsx +0 -79
  112. package/landing-page/src/components/ui/mock-terminal.tsx +0 -68
  113. package/landing-page/src/components/ui/separator.tsx +0 -28
  114. package/landing-page/src/lib/utils.ts +0 -6
  115. package/landing-page/src/main.tsx +0 -10
  116. package/landing-page/src/pages/Dashboard.tsx +0 -133
  117. package/landing-page/src/pages/DocsPage.tsx +0 -79
  118. package/landing-page/src/pages/LandingPage.tsx +0 -31
  119. package/landing-page/src/pages/TerminalView.tsx +0 -106
  120. package/landing-page/src/styles/fonts.css +0 -0
  121. package/landing-page/src/styles/index.css +0 -3
  122. package/landing-page/src/styles/tailwind.css +0 -4
  123. package/landing-page/src/styles/theme.css +0 -181
  124. package/landing-page/vite.config.ts +0 -19
  125. package/npm/darwin-arm64/bin/gssh +0 -0
  126. package/npm/darwin-arm64/package.json +0 -20
  127. package/scripts/build.ts +0 -298
  128. package/scripts/release.ts +0 -140
  129. package/src/__tests__/test-utils.ts +0 -298
  130. package/src/commands/__tests__/serve-messages.test.ts +0 -190
  131. package/src/commands/access.ts +0 -298
  132. package/src/commands/add.ts +0 -452
  133. package/src/commands/auth.ts +0 -364
  134. package/src/commands/connect.ts +0 -287
  135. package/src/commands/directory.ts +0 -16
  136. package/src/commands/host.ts +0 -396
  137. package/src/commands/identity.ts +0 -184
  138. package/src/commands/list.ts +0 -200
  139. package/src/commands/relay.ts +0 -315
  140. package/src/commands/remove.ts +0 -241
  141. package/src/commands/serve.ts +0 -1493
  142. package/src/commands/share.ts +0 -456
  143. package/src/commands/status.ts +0 -125
  144. package/src/commands/switch.ts +0 -353
  145. package/src/commands/tmux.ts +0 -317
  146. package/src/core/__tests__/access.test.ts +0 -240
  147. package/src/core/access.ts +0 -277
  148. package/src/core/bundle.ts +0 -342
  149. package/src/core/config.ts +0 -510
  150. package/src/core/git.ts +0 -317
  151. package/src/core/github.ts +0 -151
  152. package/src/core/identity.ts +0 -631
  153. package/src/core/linear.ts +0 -225
  154. package/src/core/shell.ts +0 -161
  155. package/src/core/trusted-relays.ts +0 -315
  156. package/src/index.ts +0 -810
  157. package/src/lib/remote-session/index.ts +0 -7
  158. package/src/lib/remote-session/protocol.ts +0 -267
  159. package/src/lib/remote-session/session-handler.ts +0 -581
  160. package/src/lib/remote-session/workspace-scanner.ts +0 -167
  161. package/src/lib/tmux-lite/README.md +0 -81
  162. package/src/lib/tmux-lite/cli.ts +0 -796
  163. package/src/lib/tmux-lite/crypto/__tests__/helpers/handshake-runner.ts +0 -349
  164. package/src/lib/tmux-lite/crypto/__tests__/helpers/mock-relay.ts +0 -291
  165. package/src/lib/tmux-lite/crypto/__tests__/helpers/test-identities.ts +0 -142
  166. package/src/lib/tmux-lite/crypto/__tests__/integration/authorization.integration.test.ts +0 -339
  167. package/src/lib/tmux-lite/crypto/__tests__/integration/e2e-communication.integration.test.ts +0 -477
  168. package/src/lib/tmux-lite/crypto/__tests__/integration/error-handling.integration.test.ts +0 -499
  169. package/src/lib/tmux-lite/crypto/__tests__/integration/handshake.integration.test.ts +0 -371
  170. package/src/lib/tmux-lite/crypto/__tests__/integration/security.integration.test.ts +0 -573
  171. package/src/lib/tmux-lite/crypto/access-control.test.ts +0 -512
  172. package/src/lib/tmux-lite/crypto/access-control.ts +0 -320
  173. package/src/lib/tmux-lite/crypto/frames.test.ts +0 -262
  174. package/src/lib/tmux-lite/crypto/frames.ts +0 -141
  175. package/src/lib/tmux-lite/crypto/handshake.ts +0 -894
  176. package/src/lib/tmux-lite/crypto/identity.test.ts +0 -220
  177. package/src/lib/tmux-lite/crypto/identity.ts +0 -286
  178. package/src/lib/tmux-lite/crypto/index.ts +0 -51
  179. package/src/lib/tmux-lite/crypto/invites.test.ts +0 -381
  180. package/src/lib/tmux-lite/crypto/invites.ts +0 -215
  181. package/src/lib/tmux-lite/crypto/keyexchange.ts +0 -435
  182. package/src/lib/tmux-lite/crypto/keys.test.ts +0 -58
  183. package/src/lib/tmux-lite/crypto/keys.ts +0 -47
  184. package/src/lib/tmux-lite/crypto/secretbox.test.ts +0 -169
  185. package/src/lib/tmux-lite/crypto/secretbox.ts +0 -124
  186. package/src/lib/tmux-lite/handshake-handler.ts +0 -451
  187. package/src/lib/tmux-lite/protocol.test.ts +0 -307
  188. package/src/lib/tmux-lite/protocol.ts +0 -266
  189. package/src/lib/tmux-lite/relay-client.ts +0 -506
  190. package/src/lib/tmux-lite/server.ts +0 -1250
  191. package/src/lib/tmux-lite/shell-integration.sh +0 -37
  192. package/src/lib/tmux-lite/terminal-queries.test.ts +0 -54
  193. package/src/lib/tmux-lite/terminal-queries.ts +0 -49
  194. package/src/relay/__tests__/e2e-flow.test.ts +0 -1284
  195. package/src/relay/__tests__/helpers/auth.ts +0 -354
  196. package/src/relay/__tests__/helpers/ports.ts +0 -51
  197. package/src/relay/__tests__/protocol-validation.test.ts +0 -265
  198. package/src/relay/authorization.ts +0 -303
  199. package/src/relay/embedded-assets.generated.d.ts +0 -15
  200. package/src/relay/identity.ts +0 -352
  201. package/src/relay/index.ts +0 -57
  202. package/src/relay/pipes.test.ts +0 -427
  203. package/src/relay/pipes.ts +0 -195
  204. package/src/relay/protocol.ts +0 -804
  205. package/src/relay/registries.test.ts +0 -437
  206. package/src/relay/registries.ts +0 -593
  207. package/src/relay/server.test.ts +0 -1323
  208. package/src/relay/server.ts +0 -1092
  209. package/src/relay/signing.ts +0 -238
  210. package/src/relay/types.ts +0 -69
  211. package/src/serve/client-session-manager.ts +0 -622
  212. package/src/serve/daemon.ts +0 -497
  213. package/src/serve/pty-session.ts +0 -236
  214. package/src/serve/types.ts +0 -169
  215. package/src/shared/components/Flow.tsx +0 -453
  216. package/src/shared/components/Flow.tui.tsx +0 -343
  217. package/src/shared/components/Flow.web.tsx +0 -442
  218. package/src/shared/components/Inbox.tsx +0 -446
  219. package/src/shared/components/Inbox.tui.tsx +0 -262
  220. package/src/shared/components/Inbox.web.tsx +0 -329
  221. package/src/shared/components/MachineList.tsx +0 -187
  222. package/src/shared/components/MachineList.tui.tsx +0 -161
  223. package/src/shared/components/MachineList.web.tsx +0 -210
  224. package/src/shared/components/ProjectList.tsx +0 -176
  225. package/src/shared/components/ProjectList.tui.tsx +0 -109
  226. package/src/shared/components/ProjectList.web.tsx +0 -143
  227. package/src/shared/components/SpacesBrowser.tsx +0 -332
  228. package/src/shared/components/SpacesBrowser.tui.tsx +0 -163
  229. package/src/shared/components/SpacesBrowser.web.tsx +0 -221
  230. package/src/shared/components/index.ts +0 -103
  231. package/src/shared/hooks/index.ts +0 -16
  232. package/src/shared/hooks/useNavigation.ts +0 -226
  233. package/src/shared/index.ts +0 -122
  234. package/src/shared/providers/LocalMachineProvider.ts +0 -425
  235. package/src/shared/providers/MachineProvider.ts +0 -165
  236. package/src/shared/providers/RemoteMachineProvider.ts +0 -444
  237. package/src/shared/providers/index.ts +0 -26
  238. package/src/shared/types.ts +0 -145
  239. package/src/tui/adapters.ts +0 -120
  240. package/src/tui/app.tsx +0 -1816
  241. package/src/tui/components/Terminal.tsx +0 -580
  242. package/src/tui/hooks/index.ts +0 -35
  243. package/src/tui/hooks/useAppState.ts +0 -314
  244. package/src/tui/hooks/useDaemonStatus.ts +0 -174
  245. package/src/tui/hooks/useInboxTUI.ts +0 -113
  246. package/src/tui/hooks/useRemoteMachines.ts +0 -209
  247. package/src/tui/index.ts +0 -24
  248. package/src/tui/state.ts +0 -299
  249. package/src/tui/terminal-bracketed-paste.test.ts +0 -45
  250. package/src/tui/terminal-bracketed-paste.ts +0 -47
  251. package/src/types/bundle.ts +0 -112
  252. package/src/types/config.ts +0 -89
  253. package/src/types/errors.ts +0 -206
  254. package/src/types/identity.ts +0 -284
  255. package/src/types/workspace-fuzzy.ts +0 -49
  256. package/src/types/workspace.ts +0 -151
  257. package/src/utils/bun-socket-writer.ts +0 -80
  258. package/src/utils/deps.ts +0 -127
  259. package/src/utils/fuzzy-match.ts +0 -125
  260. package/src/utils/logger.ts +0 -127
  261. package/src/utils/markdown.ts +0 -254
  262. package/src/utils/onboarding.ts +0 -229
  263. package/src/utils/prompts.ts +0 -114
  264. package/src/utils/run-commands.ts +0 -112
  265. package/src/utils/run-scripts.ts +0 -142
  266. package/src/utils/sanitize.ts +0 -98
  267. package/src/utils/secrets.ts +0 -122
  268. package/src/utils/shell-escape.ts +0 -40
  269. package/src/utils/utf8.ts +0 -79
  270. package/src/utils/workspace-state.ts +0 -47
  271. package/src/web/README.md +0 -73
  272. package/src/web/bun.lock +0 -575
  273. package/src/web/eslint.config.js +0 -23
  274. package/src/web/index.html +0 -16
  275. package/src/web/package.json +0 -37
  276. package/src/web/public/vite.svg +0 -1
  277. package/src/web/src/App.tsx +0 -604
  278. package/src/web/src/assets/react.svg +0 -1
  279. package/src/web/src/components/Terminal.tsx +0 -207
  280. package/src/web/src/hooks/useRelayConnection.ts +0 -224
  281. package/src/web/src/hooks/useTerminal.ts +0 -699
  282. package/src/web/src/index.css +0 -55
  283. package/src/web/src/lib/crypto/__tests__/web-terminal.test.ts +0 -1158
  284. package/src/web/src/lib/crypto/frames.ts +0 -205
  285. package/src/web/src/lib/crypto/handshake.ts +0 -396
  286. package/src/web/src/lib/crypto/identity.ts +0 -128
  287. package/src/web/src/lib/crypto/keyexchange.ts +0 -246
  288. package/src/web/src/lib/crypto/relay-signing.ts +0 -53
  289. package/src/web/src/lib/invite.ts +0 -58
  290. package/src/web/src/lib/storage/identity-store.ts +0 -94
  291. package/src/web/src/main.tsx +0 -10
  292. package/src/web/src/types/identity.ts +0 -45
  293. package/src/web/tsconfig.app.json +0 -28
  294. package/src/web/tsconfig.json +0 -7
  295. package/src/web/tsconfig.node.json +0 -26
  296. package/src/web/vite.config.ts +0 -31
  297. package/todo-security.md +0 -92
  298. package/tsconfig.json +0 -23
  299. package/worker/.wrangler/state/v3/d1/miniflare-D1DatabaseObject/12b7107e435bf1b9a8713a7f320472a63e543104d633d89a26f8d21f4e4ef182.sqlite +0 -0
  300. package/worker/.wrangler/state/v3/d1/miniflare-D1DatabaseObject/12b7107e435bf1b9a8713a7f320472a63e543104d633d89a26f8d21f4e4ef182.sqlite-shm +0 -0
  301. package/worker/.wrangler/state/v3/d1/miniflare-D1DatabaseObject/12b7107e435bf1b9a8713a7f320472a63e543104d633d89a26f8d21f4e4ef182.sqlite-wal +0 -0
  302. package/worker/.wrangler/state/v3/d1/miniflare-D1DatabaseObject/1a1ac3db1ab86ecf712f90322868a9aabc2c7dc9fe2dfbe94f9b075096276b0f.sqlite +0 -0
  303. package/worker/.wrangler/state/v3/d1/miniflare-D1DatabaseObject/1a1ac3db1ab86ecf712f90322868a9aabc2c7dc9fe2dfbe94f9b075096276b0f.sqlite-shm +0 -0
  304. package/worker/.wrangler/state/v3/d1/miniflare-D1DatabaseObject/1a1ac3db1ab86ecf712f90322868a9aabc2c7dc9fe2dfbe94f9b075096276b0f.sqlite-wal +0 -0
  305. package/worker/bun.lock +0 -237
  306. package/worker/package.json +0 -22
  307. package/worker/schema.sql +0 -96
  308. package/worker/src/handlers/auth.ts +0 -451
  309. package/worker/src/handlers/subdomains.ts +0 -376
  310. package/worker/src/handlers/user.ts +0 -98
  311. package/worker/src/index.ts +0 -70
  312. package/worker/src/middleware/auth.ts +0 -152
  313. package/worker/src/services/cloudflare.ts +0 -609
  314. package/worker/src/types.ts +0 -96
  315. package/worker/tsconfig.json +0 -15
  316. package/worker/wrangler.toml +0 -26
@@ -1,1323 +0,0 @@
1
- import { describe, expect, test, beforeAll, afterAll, beforeEach } from "bun:test";
2
- import { createRelayServer } from "./server";
3
- import { generateRelayIdentity } from "./identity";
4
- import { clearAllRegistries } from "./registries";
5
- import {
6
- createTestIdentity,
7
- toPublicIdentity,
8
- } from "../lib/tmux-lite/crypto/__tests__/helpers/test-identities";
9
- import {
10
- signChallenge,
11
- getSigningKeyBase64,
12
- connectMachineWithAuth,
13
- connectClient,
14
- signClientMessage,
15
- sendAndWait,
16
- waitForMessage,
17
- } from "./__tests__/helpers/auth";
18
- import { startRelayServer } from "./__tests__/helpers/ports";
19
- import type { Server } from "bun";
20
- import type { Identity } from "../types/identity";
21
-
22
- const TEST_HOST = "127.0.0.1";
23
- let relayUrl = "";
24
- let relayHttpBase = "";
25
-
26
- // Generate identities for testing
27
- const testRelayIdentity = generateRelayIdentity("test-relay");
28
- const testMachine1 = createTestIdentity("Test Machine 1");
29
- const testMachine2 = createTestIdentity("Test Machine 2");
30
- const testClient1 = createTestIdentity("Test Client 1");
31
- const testClient2 = createTestIdentity("Test Client 2");
32
-
33
- let server: Server<any>;
34
-
35
- beforeAll(async () => {
36
- server = startRelayServer({
37
- bind: TEST_HOST,
38
- hostname: TEST_HOST,
39
- disableRateLimit: true,
40
- identity: testRelayIdentity,
41
- preAuthorizedMachines: new Set([
42
- getSigningKeyBase64(testMachine1),
43
- getSigningKeyBase64(testMachine2),
44
- ]),
45
- });
46
- relayUrl = `ws://${TEST_HOST}:${server.port}/ws`;
47
- relayHttpBase = `http://${TEST_HOST}:${server.port}`;
48
-
49
- // Wait for server to start accepting requests to avoid flakiness.
50
- const deadline = Date.now() + 3000;
51
- // eslint-disable-next-line no-constant-condition
52
- while (true) {
53
- try {
54
- const res = await fetch(`${relayHttpBase}/health`);
55
- if (res.ok) break;
56
- } catch {
57
- // ignore until deadline
58
- }
59
- if (Date.now() > deadline) {
60
- throw new Error("Relay server did not become healthy in time");
61
- }
62
- await new Promise((r) => setTimeout(r, 50));
63
- }
64
- });
65
-
66
- afterAll(() => {
67
- server.stop(true);
68
- });
69
-
70
- beforeEach(() => {
71
- // Clear registries between tests
72
- clearAllRegistries();
73
- });
74
-
75
- // ============================================================================
76
- // Helper to connect a machine with full challenge-response flow
77
- // ============================================================================
78
-
79
- async function connectAndRegisterMachine(
80
- identity: Identity,
81
- options?: { label?: string }
82
- ): Promise<WebSocket> {
83
- const { label = identity.label } = options ?? {};
84
-
85
- const url = new URL(relayUrl);
86
- url.searchParams.set("role", "machine");
87
-
88
- const ws = new WebSocket(url.toString());
89
- ws.binaryType = "arraybuffer";
90
-
91
- // Wait for open
92
- await new Promise<void>((resolve, reject) => {
93
- ws.onopen = () => resolve();
94
- ws.onerror = () => reject(new Error("Connection failed"));
95
- setTimeout(() => reject(new Error("Timeout")), 5000);
96
- });
97
-
98
- // Wait for relay_identity with challenge
99
- const challenge = await new Promise<Uint8Array>((resolve, reject) => {
100
- const timeout = setTimeout(() => reject(new Error("Challenge timeout")), 5000);
101
- ws.onmessage = (event) => {
102
- try {
103
- const data = typeof event.data === "string" ? event.data : new TextDecoder().decode(event.data);
104
- const msg = JSON.parse(data);
105
- if (msg.type === "relay_identity" && msg.challenge) {
106
- clearTimeout(timeout);
107
- resolve(Buffer.from(msg.challenge, "base64"));
108
- }
109
- } catch {
110
- // Ignore
111
- }
112
- };
113
- });
114
-
115
- // Sign challenge
116
- const signature = signChallenge(challenge, identity.signing.secretKey);
117
- const publicIdentity = toPublicIdentity(identity);
118
-
119
- // Send register_machine
120
- ws.send(JSON.stringify({
121
- type: "register_machine",
122
- machineId: identity.id,
123
- signingKey: publicIdentity.signingPublicKey,
124
- keyExchangeKey: publicIdentity.keyExchangePublicKey,
125
- challengeResponse: signature,
126
- label,
127
- }));
128
-
129
- // Wait for registered
130
- await new Promise<void>((resolve, reject) => {
131
- const timeout = setTimeout(() => reject(new Error("Registration timeout")), 5000);
132
- ws.onmessage = (event) => {
133
- try {
134
- const data = typeof event.data === "string" ? event.data : new TextDecoder().decode(event.data);
135
- const msg = JSON.parse(data);
136
- if (msg.type === "registered") {
137
- clearTimeout(timeout);
138
- resolve();
139
- } else if (msg.type === "error") {
140
- clearTimeout(timeout);
141
- reject(new Error(msg.message || "Registration failed"));
142
- }
143
- } catch {
144
- // Ignore
145
- }
146
- };
147
- });
148
-
149
- return ws;
150
- }
151
-
152
- // ============================================================================
153
- // HTTP Endpoints
154
- // ============================================================================
155
-
156
- describe("HTTP endpoints", () => {
157
- test("GET /health returns stats", async () => {
158
- const res = await fetch(`${relayHttpBase}/health`);
159
- expect(res.status).toBe(200);
160
-
161
- const data = await res.json();
162
- expect(data.status).toBe("ok");
163
- expect(typeof data.machineCount).toBe("number");
164
- expect(typeof data.connectedClients).toBe("number");
165
- });
166
-
167
- test("GET /unknown returns 404", async () => {
168
- const res = await fetch(`${relayHttpBase}/unknown`);
169
- expect(res.status).toBe(404);
170
- });
171
- });
172
-
173
- // ============================================================================
174
- // WebSocket Connections
175
- // ============================================================================
176
-
177
- describe("WebSocket connections", () => {
178
- test("rejects connection without role", async () => {
179
- // No role parameter - should be rejected with 400
180
- const ws = new WebSocket(relayUrl);
181
-
182
- const result = await new Promise<{ opened: boolean; error?: string }>((resolve) => {
183
- ws.onerror = () => {
184
- resolve({ opened: false, error: "Connection error" });
185
- };
186
- ws.onclose = (event) => {
187
- resolve({ opened: false, error: `Closed: ${event.code}` });
188
- };
189
- ws.onopen = () => {
190
- ws.close();
191
- resolve({ opened: true });
192
- };
193
- setTimeout(() => {
194
- ws.close();
195
- resolve({ opened: false, error: "Timeout" });
196
- }, 1000);
197
- });
198
-
199
- // Should be rejected at upgrade (role missing)
200
- expect(result.opened).toBe(false);
201
- });
202
-
203
- test("accepts machine connection and sends relay_identity", async () => {
204
- const ws = new WebSocket(`${relayUrl}?role=machine`);
205
-
206
- await new Promise<void>((resolve, reject) => {
207
- ws.onopen = () => resolve();
208
- ws.onerror = () => reject(new Error("Connection failed"));
209
- setTimeout(() => reject(new Error("Timeout")), 2000);
210
- });
211
-
212
- expect(ws.readyState).toBe(WebSocket.OPEN);
213
-
214
- // Should receive relay_identity with challenge
215
- const relayIdentity = await new Promise<any>((resolve, reject) => {
216
- ws.onmessage = (event) => {
217
- const msg = JSON.parse(event.data);
218
- if (msg.type === "relay_identity") {
219
- resolve(msg);
220
- }
221
- };
222
- setTimeout(() => reject(new Error("Timeout waiting for relay_identity")), 2000);
223
- });
224
-
225
- expect(relayIdentity.type).toBe("relay_identity");
226
- expect(relayIdentity.publicKey).toBeDefined();
227
- expect(relayIdentity.fingerprint).toBeDefined();
228
- expect(relayIdentity.challenge).toBeDefined();
229
-
230
- ws.close();
231
- });
232
-
233
- test("accepts client connection", async () => {
234
- const ws = new WebSocket(`${relayUrl}?role=client`);
235
-
236
- await new Promise<void>((resolve, reject) => {
237
- ws.onopen = () => resolve();
238
- ws.onerror = () => reject(new Error("Connection failed"));
239
- setTimeout(() => reject(new Error("Timeout")), 2000);
240
- });
241
-
242
- expect(ws.readyState).toBe(WebSocket.OPEN);
243
- ws.close();
244
- });
245
- });
246
-
247
- // ============================================================================
248
- // Challenge-Response Authentication
249
- // ============================================================================
250
-
251
- describe("Challenge-response authentication", () => {
252
- test("machine registration with valid challenge response succeeds", async () => {
253
- const ws = await connectAndRegisterMachine(testMachine1);
254
- expect(ws.readyState).toBe(WebSocket.OPEN);
255
- ws.close();
256
- });
257
-
258
- test("machine registration with invalid challenge response fails", async () => {
259
- const ws = new WebSocket(`${relayUrl}?role=machine`);
260
-
261
- await new Promise<void>((resolve) => {
262
- ws.onopen = () => resolve();
263
- });
264
-
265
- // Wait for challenge
266
- await new Promise<void>((resolve) => {
267
- ws.onmessage = (event) => {
268
- const msg = JSON.parse(event.data);
269
- if (msg.type === "relay_identity") resolve();
270
- };
271
- });
272
-
273
- // Send register_machine with invalid signature
274
- ws.send(JSON.stringify({
275
- type: "register_machine",
276
- machineId: testMachine1.id,
277
- signingKey: toPublicIdentity(testMachine1).signingPublicKey,
278
- keyExchangeKey: toPublicIdentity(testMachine1).keyExchangePublicKey,
279
- challengeResponse: Buffer.from("invalid-signature").toString("base64"),
280
- label: "Test",
281
- }));
282
-
283
- const response = await new Promise<any>((resolve) => {
284
- ws.onmessage = (event) => {
285
- resolve(JSON.parse(event.data));
286
- };
287
- ws.onclose = () => {
288
- resolve({ type: "closed" });
289
- };
290
- setTimeout(() => resolve({ type: "timeout" }), 2000);
291
- });
292
-
293
- expect(response.type).toBe("error");
294
- expect(response.message?.toLowerCase()).toMatch(/signature|verification|challenge/);
295
-
296
- ws.close();
297
- });
298
-
299
- test("unauthorized machine is rejected", async () => {
300
- // Create a machine that's not pre-authorized
301
- const unauthorizedMachine = createTestIdentity("Unauthorized Machine");
302
-
303
- const ws = new WebSocket(`${relayUrl}?role=machine`);
304
-
305
- await new Promise<void>((resolve) => {
306
- ws.onopen = () => resolve();
307
- });
308
-
309
- // Wait for challenge
310
- const challenge = await new Promise<Uint8Array>((resolve) => {
311
- ws.onmessage = (event) => {
312
- const msg = JSON.parse(event.data);
313
- if (msg.type === "relay_identity") {
314
- resolve(Buffer.from(msg.challenge, "base64"));
315
- }
316
- };
317
- });
318
-
319
- // Sign correctly but with unauthorized key
320
- const signature = signChallenge(challenge, unauthorizedMachine.signing.secretKey);
321
- const publicIdentity = toPublicIdentity(unauthorizedMachine);
322
-
323
- ws.send(JSON.stringify({
324
- type: "register_machine",
325
- machineId: unauthorizedMachine.id,
326
- signingKey: publicIdentity.signingPublicKey,
327
- keyExchangeKey: publicIdentity.keyExchangePublicKey,
328
- challengeResponse: signature,
329
- label: "Unauthorized",
330
- }));
331
-
332
- const response = await new Promise<any>((resolve) => {
333
- ws.onmessage = (event) => {
334
- resolve(JSON.parse(event.data));
335
- };
336
- ws.onclose = () => resolve({ type: "closed" });
337
- setTimeout(() => resolve({ type: "timeout" }), 2000);
338
- });
339
-
340
- expect(response.type).toBe("error");
341
- expect(response.message?.toLowerCase()).toMatch(/not authorized|unauthorized/);
342
-
343
- ws.close();
344
- });
345
-
346
- test("missing challengeResponse is rejected", async () => {
347
- const ws = new WebSocket(`${relayUrl}?role=machine`);
348
-
349
- await new Promise<void>((resolve) => {
350
- ws.onopen = () => resolve();
351
- });
352
-
353
- // Wait for challenge
354
- await new Promise<void>((resolve) => {
355
- ws.onmessage = (event) => {
356
- const msg = JSON.parse(event.data);
357
- if (msg.type === "relay_identity") resolve();
358
- };
359
- });
360
-
361
- // Send register_machine WITHOUT challengeResponse
362
- ws.send(JSON.stringify({
363
- type: "register_machine",
364
- machineId: testMachine1.id,
365
- signingKey: toPublicIdentity(testMachine1).signingPublicKey,
366
- keyExchangeKey: toPublicIdentity(testMachine1).keyExchangePublicKey,
367
- // challengeResponse is missing
368
- label: "Test",
369
- }));
370
-
371
- const response = await new Promise<any>((resolve) => {
372
- ws.onmessage = (event) => {
373
- resolve(JSON.parse(event.data));
374
- };
375
- setTimeout(() => resolve({ type: "timeout" }), 2000);
376
- });
377
-
378
- expect(response.type).toBe("error");
379
- expect(response.message?.toLowerCase()).toContain("challenge");
380
-
381
- ws.close();
382
- });
383
- });
384
-
385
- // ============================================================================
386
- // Protocol Messages
387
- // ============================================================================
388
-
389
- describe("Protocol messages", () => {
390
- test("invite registration flow", async () => {
391
- const machineWs = await connectAndRegisterMachine(testMachine1);
392
- const inviteId = "test-invite-001";
393
-
394
- // Register invite
395
- machineWs.send(JSON.stringify({
396
- type: "register_invite",
397
- inviteId,
398
- machineId: testMachine1.id,
399
- expiresAt: Date.now() + 3600000,
400
- maxUses: 5,
401
- }));
402
-
403
- const response = await new Promise<any>((resolve, reject) => {
404
- machineWs.onmessage = (event) => {
405
- resolve(JSON.parse(event.data));
406
- };
407
- setTimeout(() => reject(new Error("Timeout")), 2000);
408
- });
409
-
410
- expect(response.type).toBe("registered");
411
- expect(response.machineId).toBe(testMachine1.id);
412
-
413
- machineWs.close();
414
- });
415
-
416
- test("client connect with invite flow", async () => {
417
- const machineWs = await connectAndRegisterMachine(testMachine1);
418
- const inviteId = "test-invite-002";
419
- const clientIdentityId = testClient1.id;
420
-
421
- // Register invite
422
- machineWs.send(JSON.stringify({
423
- type: "register_invite",
424
- inviteId,
425
- machineId: testMachine1.id,
426
- expiresAt: Date.now() + 3600000,
427
- maxUses: null,
428
- }));
429
-
430
- await new Promise<void>((resolve) => {
431
- machineWs.onmessage = () => resolve();
432
- });
433
-
434
- // Set up machine to receive client_connected
435
- const machineReceivedConnection = new Promise<any>((resolve) => {
436
- machineWs.onmessage = (event) => {
437
- resolve(JSON.parse(event.data));
438
- };
439
- });
440
-
441
- // Connect client (no token needed)
442
- const clientWs = new WebSocket(`${relayUrl}?role=client`);
443
-
444
- await new Promise<void>((resolve, reject) => {
445
- clientWs.onopen = () => resolve();
446
- clientWs.onerror = () => reject(new Error("Client connection failed"));
447
- setTimeout(() => reject(new Error("Timeout")), 2000);
448
- });
449
-
450
- // Client connects with invite
451
- const signedConnect = signClientMessage({
452
- type: "connect_with_invite",
453
- inviteId,
454
- clientIdentityId,
455
- }, testClient1);
456
- clientWs.send(JSON.stringify(signedConnect));
457
-
458
- // Wait for connection_established
459
- const clientResponse = await new Promise<any>((resolve, reject) => {
460
- clientWs.onmessage = (event) => {
461
- resolve(JSON.parse(event.data));
462
- };
463
- setTimeout(() => reject(new Error("Timeout")), 2000);
464
- });
465
-
466
- expect(clientResponse.type).toBe("connection_established");
467
- expect(clientResponse.machineId).toBe(testMachine1.id);
468
-
469
- // Machine should have received client_connected
470
- const machineMsg = await machineReceivedConnection;
471
- expect(machineMsg.type).toBe("client_connected");
472
- expect(machineMsg.clientIdentityId).toBe(clientIdentityId);
473
- expect(machineMsg.viaInvite).toBe(inviteId);
474
-
475
- machineWs.close();
476
- clientWs.close();
477
- });
478
-
479
- test("machine to client data routing", async () => {
480
- const machineWs = await connectAndRegisterMachine(testMachine1);
481
- const inviteId = "test-invite-003";
482
- const clientIdentityId = testClient1.id;
483
-
484
- // Register invite
485
- machineWs.send(JSON.stringify({
486
- type: "register_invite",
487
- inviteId,
488
- machineId: testMachine1.id,
489
- expiresAt: Date.now() + 3600000,
490
- maxUses: null,
491
- }));
492
-
493
- await new Promise<void>((resolve) => {
494
- machineWs.onmessage = () => resolve();
495
- });
496
-
497
- // Store connectionId when machine receives client_connected
498
- let clientConnectionId = "";
499
- const gotConnectionId = new Promise<void>((resolve) => {
500
- machineWs.onmessage = (event) => {
501
- const msg = JSON.parse(event.data);
502
- if (msg.type === "client_connected") {
503
- clientConnectionId = msg.connectionId;
504
- resolve();
505
- }
506
- };
507
- });
508
-
509
- // Connect client
510
- const clientWs = new WebSocket(`${relayUrl}?role=client`);
511
-
512
- await new Promise<void>((resolve, reject) => {
513
- clientWs.onopen = () => resolve();
514
- clientWs.onerror = () => reject(new Error("Client connection failed"));
515
- setTimeout(() => reject(new Error("Timeout")), 2000);
516
- });
517
-
518
- const signedConnect = signClientMessage({
519
- type: "connect_with_invite",
520
- inviteId,
521
- clientIdentityId,
522
- }, testClient1);
523
- clientWs.send(JSON.stringify(signedConnect));
524
-
525
- // Wait for connection established
526
- await new Promise<void>((resolve) => {
527
- clientWs.onmessage = (event) => {
528
- const msg = JSON.parse(event.data);
529
- if (msg.type === "connection_established") resolve();
530
- };
531
- });
532
-
533
- await gotConnectionId;
534
-
535
- // Set up client to receive data
536
- const clientReceivedData = new Promise<any>((resolve) => {
537
- clientWs.onmessage = (event) => {
538
- resolve(JSON.parse(event.data));
539
- };
540
- });
541
-
542
- // Machine sends data to client
543
- const testData = Buffer.from("Hello from machine").toString("base64");
544
- machineWs.send(JSON.stringify({
545
- type: "data",
546
- connectionId: clientConnectionId,
547
- data: testData,
548
- }));
549
-
550
- const receivedMsg = await clientReceivedData;
551
- expect(receivedMsg.type).toBe("data");
552
- expect(receivedMsg.data).toBe(testData);
553
-
554
- machineWs.close();
555
- clientWs.close();
556
- });
557
-
558
- test("client to machine data routing", async () => {
559
- const machineWs = await connectAndRegisterMachine(testMachine1);
560
- const inviteId = "test-invite-004";
561
- const clientIdentityId = testClient1.id;
562
-
563
- // Register invite
564
- machineWs.send(JSON.stringify({
565
- type: "register_invite",
566
- inviteId,
567
- machineId: testMachine1.id,
568
- expiresAt: Date.now() + 3600000,
569
- maxUses: null,
570
- }));
571
-
572
- await new Promise<void>((resolve) => {
573
- machineWs.onmessage = () => resolve();
574
- });
575
-
576
- // Wait for client_connected
577
- let expectedClientConnectionId = "";
578
- const clientConnectedPromise = new Promise<void>((resolve) => {
579
- machineWs.onmessage = (event) => {
580
- const msg = JSON.parse(event.data);
581
- if (msg.type === "client_connected") {
582
- expectedClientConnectionId = msg.connectionId;
583
- resolve();
584
- }
585
- };
586
- });
587
-
588
- // Connect client
589
- const clientWs = new WebSocket(`${relayUrl}?role=client`);
590
-
591
- await new Promise<void>((resolve, reject) => {
592
- clientWs.onopen = () => resolve();
593
- clientWs.onerror = () => reject(new Error("Client connection failed"));
594
- setTimeout(() => reject(new Error("Timeout")), 2000);
595
- });
596
-
597
- const signedConnect = signClientMessage({
598
- type: "connect_with_invite",
599
- inviteId,
600
- clientIdentityId,
601
- }, testClient1);
602
- clientWs.send(JSON.stringify(signedConnect));
603
-
604
- // Wait for connection established
605
- await new Promise<void>((resolve) => {
606
- clientWs.onmessage = (event) => {
607
- const msg = JSON.parse(event.data);
608
- if (msg.type === "connection_established") resolve();
609
- };
610
- });
611
-
612
- await clientConnectedPromise;
613
-
614
- // Set up machine to receive data
615
- const machineReceivedData = new Promise<any>((resolve) => {
616
- machineWs.onmessage = (event) => {
617
- resolve(JSON.parse(event.data));
618
- };
619
- });
620
-
621
- // Client sends data to machine
622
- const testData = Buffer.from("Hello from client").toString("base64");
623
- clientWs.send(JSON.stringify({
624
- type: "data",
625
- data: testData,
626
- }));
627
-
628
- const receivedMsg = await machineReceivedData;
629
- expect(receivedMsg.type).toBe("data");
630
- expect(receivedMsg.data).toBe(testData);
631
- expect(receivedMsg.connectionId).toBe(expectedClientConnectionId);
632
-
633
- machineWs.close();
634
- clientWs.close();
635
- });
636
- });
637
-
638
- // ============================================================================
639
- // Client Signature Enforcement
640
- // ============================================================================
641
-
642
- describe("Client signature enforcement", () => {
643
- test("list_machines rejects missing signature", async () => {
644
- const clientWs = await connectClient(relayUrl);
645
-
646
- const response = await sendAndWait<any>(
647
- clientWs,
648
- {
649
- type: "list_machines",
650
- clientIdentityId: testClient1.id,
651
- },
652
- "error"
653
- );
654
-
655
- expect(response.type).toBe("error");
656
- expect(response.code).toBe("INVALID_SIGNATURE");
657
-
658
- clientWs.close();
659
- });
660
-
661
- test("connect_with_invite rejects missing signature", async () => {
662
- const machineWs = await connectAndRegisterMachine(testMachine1);
663
- const inviteId = "test-invite-unsigned";
664
-
665
- machineWs.send(JSON.stringify({
666
- type: "register_invite",
667
- inviteId,
668
- machineId: testMachine1.id,
669
- expiresAt: Date.now() + 3600000,
670
- maxUses: 1,
671
- }));
672
-
673
- await new Promise<void>((resolve) => {
674
- machineWs.onmessage = () => resolve();
675
- });
676
-
677
- const clientWs = await connectClient(relayUrl);
678
-
679
- const response = await sendAndWait<any>(
680
- clientWs,
681
- {
682
- type: "connect_with_invite",
683
- inviteId,
684
- clientIdentityId: testClient1.id,
685
- },
686
- "error"
687
- );
688
-
689
- expect(response.type).toBe("error");
690
- expect(response.code).toBe("INVALID_SIGNATURE");
691
-
692
- machineWs.close();
693
- clientWs.close();
694
- });
695
-
696
- test("connect_to_machine rejects mismatched signature", async () => {
697
- const machineWs = await connectAndRegisterMachine(testMachine1);
698
- const clientWs = await connectClient(relayUrl);
699
-
700
- const signed = signClientMessage({
701
- type: "connect_to_machine",
702
- machineId: testMachine1.id,
703
- clientIdentityId: testClient2.id,
704
- }, testClient1);
705
-
706
- const response = await sendAndWait<any>(clientWs, signed, "error");
707
-
708
- expect(response.type).toBe("error");
709
- expect(response.code).toBe("INVALID_SIGNATURE");
710
-
711
- machineWs.close();
712
- clientWs.close();
713
- });
714
- });
715
-
716
- // ============================================================================
717
- // Machine Listing
718
- // ============================================================================
719
-
720
- describe("Machine listing flow", () => {
721
- test("client can list machines they are authorized for", async () => {
722
- const clientIdentityId = testClient1.id;
723
-
724
- // Register two machines
725
- const machine1Ws = await connectAndRegisterMachine(testMachine1, { label: "Machine One" });
726
- const machine2Ws = await connectAndRegisterMachine(testMachine2, { label: "Machine Two" });
727
-
728
- // Authorize client on both machines
729
- machine1Ws.send(JSON.stringify({
730
- type: "authorize_client",
731
- machineId: testMachine1.id,
732
- clientIdentityId,
733
- signingKey: "client-key",
734
- keyExchangeKey: "client-kx",
735
- accessType: "full",
736
- }));
737
-
738
- await new Promise<void>((resolve) => {
739
- machine1Ws.onmessage = () => resolve();
740
- });
741
-
742
- machine2Ws.send(JSON.stringify({
743
- type: "authorize_client",
744
- machineId: testMachine2.id,
745
- clientIdentityId,
746
- signingKey: "client-key",
747
- keyExchangeKey: "client-kx",
748
- accessType: "full",
749
- }));
750
-
751
- await new Promise<void>((resolve) => {
752
- machine2Ws.onmessage = () => resolve();
753
- });
754
-
755
- // Connect client and list machines
756
- const clientWs = new WebSocket(`${relayUrl}?role=client`);
757
-
758
- await new Promise<void>((resolve) => {
759
- clientWs.onopen = () => resolve();
760
- });
761
-
762
- const signedList = signClientMessage({
763
- type: "list_machines",
764
- clientIdentityId,
765
- }, testClient1);
766
- clientWs.send(JSON.stringify(signedList));
767
-
768
- const response = await new Promise<any>((resolve, reject) => {
769
- clientWs.onmessage = (event) => {
770
- resolve(JSON.parse(event.data));
771
- };
772
- setTimeout(() => reject(new Error("Timeout")), 2000);
773
- });
774
-
775
- expect(response.type).toBe("machine_list");
776
- expect(response.machines).toHaveLength(2);
777
-
778
- const machineIds = response.machines.map((m: any) => m.machineId).sort();
779
- expect(machineIds).toEqual([testMachine1.id, testMachine2.id].sort());
780
-
781
- // Both should be online
782
- expect(response.machines.every((m: any) => m.online)).toBe(true);
783
-
784
- machine1Ws.close();
785
- machine2Ws.close();
786
- clientWs.close();
787
- });
788
-
789
- test("client sees empty list when not authorized for any machine", async () => {
790
- const clientIdentityId = testClient2.id;
791
-
792
- // Register a machine but don't authorize the client
793
- const machineWs = await connectAndRegisterMachine(testMachine1);
794
-
795
- // Connect client and list machines
796
- const clientWs = new WebSocket(`${relayUrl}?role=client`);
797
-
798
- await new Promise<void>((resolve) => {
799
- clientWs.onopen = () => resolve();
800
- });
801
-
802
- const signedList = signClientMessage({
803
- type: "list_machines",
804
- clientIdentityId,
805
- }, testClient2);
806
- clientWs.send(JSON.stringify(signedList));
807
-
808
- const response = await new Promise<any>((resolve, reject) => {
809
- clientWs.onmessage = (event) => {
810
- resolve(JSON.parse(event.data));
811
- };
812
- setTimeout(() => reject(new Error("Timeout")), 2000);
813
- });
814
-
815
- expect(response.type).toBe("machine_list");
816
- expect(response.machines).toHaveLength(0);
817
-
818
- machineWs.close();
819
- clientWs.close();
820
- });
821
-
822
- test("machine shows offline status when disconnected", async () => {
823
- const clientIdentityId = testClient2.id;
824
-
825
- // Register machine
826
- const machineWs = await connectAndRegisterMachine(testMachine1, { label: "Offline Test Machine" });
827
-
828
- // Authorize client
829
- machineWs.send(JSON.stringify({
830
- type: "authorize_client",
831
- machineId: testMachine1.id,
832
- clientIdentityId,
833
- signingKey: "client-key",
834
- keyExchangeKey: "client-kx",
835
- accessType: "full",
836
- }));
837
-
838
- await new Promise<void>((resolve) => {
839
- machineWs.onmessage = () => resolve();
840
- });
841
-
842
- // Disconnect machine
843
- machineWs.close();
844
-
845
- // Give server time to process disconnect
846
- await new Promise((resolve) => setTimeout(resolve, 100));
847
-
848
- // Connect client and list machines
849
- const clientWs = new WebSocket(`${relayUrl}?role=client`);
850
-
851
- await new Promise<void>((resolve) => {
852
- clientWs.onopen = () => resolve();
853
- });
854
-
855
- const signedList = signClientMessage({
856
- type: "list_machines",
857
- clientIdentityId,
858
- }, testClient2);
859
- clientWs.send(JSON.stringify(signedList));
860
-
861
- const response = await new Promise<any>((resolve, reject) => {
862
- clientWs.onmessage = (event) => {
863
- resolve(JSON.parse(event.data));
864
- };
865
- setTimeout(() => reject(new Error("Timeout")), 2000);
866
- });
867
-
868
- expect(response.type).toBe("machine_list");
869
- expect(response.machines).toHaveLength(1);
870
- expect(response.machines[0].machineId).toBe(testMachine1.id);
871
- expect(response.machines[0].online).toBe(false);
872
-
873
- clientWs.close();
874
- });
875
- });
876
-
877
- // ============================================================================
878
- // Direct Machine Connection
879
- // ============================================================================
880
-
881
- describe("Direct machine connection", () => {
882
- test("client can connect directly to machine", async () => {
883
- const clientIdentityId = testClient1.id;
884
-
885
- // Register machine
886
- const machineWs = await connectAndRegisterMachine(testMachine1);
887
-
888
- // Set up machine to receive client_connected
889
- const machineReceivedConnection = new Promise<any>((resolve) => {
890
- machineWs.onmessage = (event) => {
891
- resolve(JSON.parse(event.data));
892
- };
893
- });
894
-
895
- // Connect client directly (no invite needed in new flow - auth at X3DH level)
896
- const clientWs = new WebSocket(`${relayUrl}?role=client`);
897
-
898
- await new Promise<void>((resolve) => {
899
- clientWs.onopen = () => resolve();
900
- });
901
-
902
- const signedConnect = signClientMessage({
903
- type: "connect_to_machine",
904
- machineId: testMachine1.id,
905
- clientIdentityId,
906
- }, testClient1);
907
- clientWs.send(JSON.stringify(signedConnect));
908
-
909
- const response = await new Promise<any>((resolve, reject) => {
910
- clientWs.onmessage = (event) => {
911
- resolve(JSON.parse(event.data));
912
- };
913
- setTimeout(() => reject(new Error("Timeout")), 2000);
914
- });
915
-
916
- // In new auth model, connect_to_machine succeeds - auth happens via X3DH
917
- expect(response.type).toBe("connection_established");
918
- expect(response.machineId).toBe(testMachine1.id);
919
-
920
- // Machine should receive client_connected WITHOUT viaInvite
921
- const machineMsg = await machineReceivedConnection;
922
- expect(machineMsg.type).toBe("client_connected");
923
- expect(machineMsg.clientIdentityId).toBe(clientIdentityId);
924
- expect(machineMsg.viaInvite).toBeUndefined();
925
-
926
- machineWs.close();
927
- clientWs.close();
928
- });
929
-
930
- test("client cannot connect to non-existent machine", async () => {
931
- const clientIdentityId = testClient2.id;
932
-
933
- const clientWs = new WebSocket(`${relayUrl}?role=client`);
934
-
935
- await new Promise<void>((resolve) => {
936
- clientWs.onopen = () => resolve();
937
- });
938
-
939
- const signedConnect = signClientMessage({
940
- type: "connect_to_machine",
941
- machineId: "non-existent-machine",
942
- clientIdentityId,
943
- }, testClient2);
944
- clientWs.send(JSON.stringify(signedConnect));
945
-
946
- const response = await new Promise<any>((resolve, reject) => {
947
- clientWs.onmessage = (event) => {
948
- resolve(JSON.parse(event.data));
949
- };
950
- setTimeout(() => reject(new Error("Timeout")), 2000);
951
- });
952
-
953
- expect(response.type).toBe("error");
954
- expect(response.message.toLowerCase()).toContain("not found");
955
-
956
- clientWs.close();
957
- });
958
-
959
- test("client cannot connect to offline machine", async () => {
960
- const clientIdentityId = testClient2.id;
961
-
962
- // Register machine then disconnect
963
- const machineWs = await connectAndRegisterMachine(testMachine1);
964
- machineWs.close();
965
- await new Promise((resolve) => setTimeout(resolve, 100));
966
-
967
- // Try to connect
968
- const clientWs = new WebSocket(`${relayUrl}?role=client`);
969
-
970
- await new Promise<void>((resolve) => {
971
- clientWs.onopen = () => resolve();
972
- });
973
-
974
- const signedConnect = signClientMessage({
975
- type: "connect_to_machine",
976
- machineId: testMachine1.id,
977
- clientIdentityId,
978
- }, testClient2);
979
- clientWs.send(JSON.stringify(signedConnect));
980
-
981
- const response = await new Promise<any>((resolve, reject) => {
982
- clientWs.onmessage = (event) => {
983
- resolve(JSON.parse(event.data));
984
- };
985
- setTimeout(() => reject(new Error("Timeout")), 2000);
986
- });
987
-
988
- expect(response.type).toBe("error");
989
- expect(response.message.toLowerCase()).toContain("offline");
990
-
991
- clientWs.close();
992
- });
993
- });
994
-
995
- // ============================================================================
996
- // Authorization Management
997
- // ============================================================================
998
-
999
- describe("Authorization management", () => {
1000
- test("machine can authorize a client", async () => {
1001
- const clientIdentityId = testClient1.id;
1002
-
1003
- // Register machine
1004
- const machineWs = await connectAndRegisterMachine(testMachine1);
1005
-
1006
- // Authorize client
1007
- machineWs.send(JSON.stringify({
1008
- type: "authorize_client",
1009
- machineId: testMachine1.id,
1010
- clientIdentityId,
1011
- signingKey: "client-key",
1012
- keyExchangeKey: "client-kx",
1013
- accessType: "full",
1014
- }));
1015
-
1016
- const response = await new Promise<any>((resolve, reject) => {
1017
- machineWs.onmessage = (event) => {
1018
- resolve(JSON.parse(event.data));
1019
- };
1020
- setTimeout(() => reject(new Error("Timeout")), 2000);
1021
- });
1022
-
1023
- expect(response.type).toBe("client_authorized");
1024
- expect(response.clientIdentityId).toBe(clientIdentityId);
1025
-
1026
- // Verify by listing machines from client
1027
- const clientWs = new WebSocket(`${relayUrl}?role=client`);
1028
-
1029
- await new Promise<void>((resolve) => {
1030
- clientWs.onopen = () => resolve();
1031
- });
1032
-
1033
- const signedList = signClientMessage({
1034
- type: "list_machines",
1035
- clientIdentityId,
1036
- }, testClient1);
1037
- clientWs.send(JSON.stringify(signedList));
1038
-
1039
- const listResponse = await new Promise<any>((resolve, reject) => {
1040
- clientWs.onmessage = (event) => {
1041
- resolve(JSON.parse(event.data));
1042
- };
1043
- setTimeout(() => reject(new Error("Timeout")), 2000);
1044
- });
1045
-
1046
- expect(listResponse.machines).toHaveLength(1);
1047
- expect(listResponse.machines[0].machineId).toBe(testMachine1.id);
1048
-
1049
- machineWs.close();
1050
- clientWs.close();
1051
- });
1052
-
1053
- test("machine can revoke client authorization", async () => {
1054
- const clientIdentityId = testClient2.id;
1055
-
1056
- // Register machine
1057
- const machineWs = await connectAndRegisterMachine(testMachine1);
1058
-
1059
- // Authorize client
1060
- machineWs.send(JSON.stringify({
1061
- type: "authorize_client",
1062
- machineId: testMachine1.id,
1063
- clientIdentityId,
1064
- signingKey: "client-key",
1065
- keyExchangeKey: "client-kx",
1066
- accessType: "full",
1067
- }));
1068
-
1069
- await new Promise<void>((resolve) => {
1070
- machineWs.onmessage = () => resolve();
1071
- });
1072
-
1073
- // Now revoke
1074
- machineWs.send(JSON.stringify({
1075
- type: "revoke_client",
1076
- machineId: testMachine1.id,
1077
- clientIdentityId,
1078
- }));
1079
-
1080
- const response = await new Promise<any>((resolve, reject) => {
1081
- machineWs.onmessage = (event) => {
1082
- resolve(JSON.parse(event.data));
1083
- };
1084
- setTimeout(() => reject(new Error("Timeout")), 2000);
1085
- });
1086
-
1087
- expect(response.type).toBe("client_revoked");
1088
- expect(response.clientIdentityId).toBe(clientIdentityId);
1089
-
1090
- // Verify by listing machines from client - should be empty
1091
- const clientWs = new WebSocket(`${relayUrl}?role=client`);
1092
-
1093
- await new Promise<void>((resolve) => {
1094
- clientWs.onopen = () => resolve();
1095
- });
1096
-
1097
- const signedList = signClientMessage({
1098
- type: "list_machines",
1099
- clientIdentityId,
1100
- }, testClient2);
1101
- clientWs.send(JSON.stringify(signedList));
1102
-
1103
- const listResponse = await new Promise<any>((resolve, reject) => {
1104
- clientWs.onmessage = (event) => {
1105
- resolve(JSON.parse(event.data));
1106
- };
1107
- setTimeout(() => reject(new Error("Timeout")), 2000);
1108
- });
1109
-
1110
- expect(listResponse.machines).toHaveLength(0);
1111
-
1112
- machineWs.close();
1113
- clientWs.close();
1114
- });
1115
- });
1116
-
1117
- // ============================================================================
1118
- // Invite Edge Cases
1119
- // ============================================================================
1120
-
1121
- describe("Invite edge cases", () => {
1122
- test("rejects expired invite", async () => {
1123
- const machineWs = await connectAndRegisterMachine(testMachine1);
1124
- const inviteId = "expired-invite-001";
1125
- const clientIdentityId = testClient1.id;
1126
-
1127
- // Register expired invite
1128
- machineWs.send(JSON.stringify({
1129
- type: "register_invite",
1130
- inviteId,
1131
- machineId: testMachine1.id,
1132
- expiresAt: Date.now() - 1000, // Already expired
1133
- maxUses: null,
1134
- }));
1135
-
1136
- await new Promise<void>((resolve) => {
1137
- machineWs.onmessage = () => resolve();
1138
- });
1139
-
1140
- // Try to use expired invite
1141
- const clientWs = new WebSocket(`${relayUrl}?role=client`);
1142
-
1143
- await new Promise<void>((resolve) => {
1144
- clientWs.onopen = () => resolve();
1145
- });
1146
-
1147
- const signedConnect = signClientMessage({
1148
- type: "connect_with_invite",
1149
- inviteId,
1150
- clientIdentityId,
1151
- }, testClient1);
1152
- clientWs.send(JSON.stringify(signedConnect));
1153
-
1154
- const response = await new Promise<any>((resolve, reject) => {
1155
- clientWs.onmessage = (event) => {
1156
- resolve(JSON.parse(event.data));
1157
- };
1158
- setTimeout(() => reject(new Error("Timeout")), 2000);
1159
- });
1160
-
1161
- expect(response.type).toBe("error");
1162
- expect(response.message.toLowerCase()).toMatch(/expired|invalid/);
1163
-
1164
- machineWs.close();
1165
- clientWs.close();
1166
- });
1167
-
1168
- test("rejects invite after max uses exhausted", async () => {
1169
- const machineWs = await connectAndRegisterMachine(testMachine1);
1170
- const inviteId = "limited-invite-001";
1171
-
1172
- // Register invite with maxUses = 1
1173
- machineWs.send(JSON.stringify({
1174
- type: "register_invite",
1175
- inviteId,
1176
- machineId: testMachine1.id,
1177
- expiresAt: Date.now() + 3600000,
1178
- maxUses: 1,
1179
- }));
1180
-
1181
- await new Promise<void>((resolve) => {
1182
- machineWs.onmessage = () => resolve();
1183
- });
1184
-
1185
- // Set up machine to receive client_connected
1186
- const machineReceivedFirst = new Promise<void>((resolve) => {
1187
- machineWs.onmessage = (event) => {
1188
- const msg = JSON.parse(event.data);
1189
- if (msg.type === "client_connected") resolve();
1190
- };
1191
- });
1192
-
1193
- // First client uses the invite
1194
- const client1Ws = new WebSocket(`${relayUrl}?role=client`);
1195
-
1196
- await new Promise<void>((resolve) => {
1197
- client1Ws.onopen = () => resolve();
1198
- });
1199
-
1200
- const signedFirst = signClientMessage({
1201
- type: "connect_with_invite",
1202
- inviteId,
1203
- clientIdentityId: testClient1.id,
1204
- }, testClient1);
1205
- client1Ws.send(JSON.stringify(signedFirst));
1206
-
1207
- await new Promise<void>((resolve) => {
1208
- client1Ws.onmessage = (event) => {
1209
- const msg = JSON.parse(event.data);
1210
- if (msg.type === "connection_established") resolve();
1211
- };
1212
- });
1213
-
1214
- await machineReceivedFirst;
1215
-
1216
- // Second client tries to use the same invite
1217
- const client2Ws = new WebSocket(`${relayUrl}?role=client`);
1218
-
1219
- await new Promise<void>((resolve) => {
1220
- client2Ws.onopen = () => resolve();
1221
- });
1222
-
1223
- const signedSecond = signClientMessage({
1224
- type: "connect_with_invite",
1225
- inviteId,
1226
- clientIdentityId: testClient2.id,
1227
- }, testClient2);
1228
- client2Ws.send(JSON.stringify(signedSecond));
1229
-
1230
- const response = await new Promise<any>((resolve, reject) => {
1231
- client2Ws.onmessage = (event) => {
1232
- resolve(JSON.parse(event.data));
1233
- };
1234
- setTimeout(() => reject(new Error("Timeout")), 2000);
1235
- });
1236
-
1237
- expect(response.type).toBe("error");
1238
- expect(response.message.toLowerCase()).toMatch(/not found|invalid|expired|exhausted/);
1239
-
1240
- machineWs.close();
1241
- client1Ws.close();
1242
- client2Ws.close();
1243
- });
1244
-
1245
- test("rejects non-existent invite", async () => {
1246
- const clientIdentityId = testClient1.id;
1247
-
1248
- const clientWs = new WebSocket(`${relayUrl}?role=client`);
1249
-
1250
- await new Promise<void>((resolve) => {
1251
- clientWs.onopen = () => resolve();
1252
- });
1253
-
1254
- const signedConnect = signClientMessage({
1255
- type: "connect_with_invite",
1256
- inviteId: "non-existent-invite",
1257
- clientIdentityId,
1258
- }, testClient1);
1259
- clientWs.send(JSON.stringify(signedConnect));
1260
-
1261
- const response = await new Promise<any>((resolve, reject) => {
1262
- clientWs.onmessage = (event) => {
1263
- resolve(JSON.parse(event.data));
1264
- };
1265
- setTimeout(() => reject(new Error("Timeout")), 2000);
1266
- });
1267
-
1268
- expect(response.type).toBe("error");
1269
- expect(response.message.toLowerCase()).toContain("not found");
1270
-
1271
- clientWs.close();
1272
- });
1273
-
1274
- test("invite fails when machine is offline", async () => {
1275
- const machineWs = await connectAndRegisterMachine(testMachine1);
1276
- const inviteId = "offline-machine-invite";
1277
- const clientIdentityId = testClient1.id;
1278
-
1279
- // Register invite
1280
- machineWs.send(JSON.stringify({
1281
- type: "register_invite",
1282
- inviteId,
1283
- machineId: testMachine1.id,
1284
- expiresAt: Date.now() + 3600000,
1285
- maxUses: null,
1286
- }));
1287
-
1288
- await new Promise<void>((resolve) => {
1289
- machineWs.onmessage = () => resolve();
1290
- });
1291
-
1292
- // Disconnect machine
1293
- machineWs.close();
1294
- await new Promise((resolve) => setTimeout(resolve, 100));
1295
-
1296
- // Try to use invite while machine is offline
1297
- const clientWs = new WebSocket(`${relayUrl}?role=client`);
1298
-
1299
- await new Promise<void>((resolve) => {
1300
- clientWs.onopen = () => resolve();
1301
- });
1302
-
1303
- const signedConnect = signClientMessage({
1304
- type: "connect_with_invite",
1305
- inviteId,
1306
- clientIdentityId,
1307
- }, testClient1);
1308
- clientWs.send(JSON.stringify(signedConnect));
1309
-
1310
- const response = await new Promise<any>((resolve, reject) => {
1311
- clientWs.onmessage = (event) => {
1312
- resolve(JSON.parse(event.data));
1313
- };
1314
- setTimeout(() => reject(new Error("Timeout")), 2000);
1315
- });
1316
-
1317
- // Should fail because machine is offline
1318
- expect(response.type).toBe("error");
1319
- expect(response.message.toLowerCase()).toContain("offline");
1320
-
1321
- clientWs.close();
1322
- });
1323
- });