@openchamber/web 1.18.2 → 1.18.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 (140) hide show
  1. package/bin/lib/commands-models.js +1 -1
  2. package/dist/assets/{CodeMirrorCommentWidgets-CxcJ5x9h.js → CodeMirrorCommentWidgets-4qZbrEXU.js} +1 -1
  3. package/dist/assets/{CommitSection-C9sBBYAJ.js → CommitSection-MJmntVPJ.js} +1 -1
  4. package/dist/assets/{DiagramEditor-C7nUw7p3.js → DiagramEditor-jnG3Hbxg.js} +1 -1
  5. package/dist/assets/{DiagramView-cYxZP-HS.js → DiagramView-CFXxgg_a.js} +1 -1
  6. package/dist/assets/{DiffView-1zd0slLu.js → DiffView-DZIoOnV7.js} +2 -2
  7. package/dist/assets/FilesView-BKL6YlKG.js +14 -0
  8. package/dist/assets/{GitView-OSVIn5V1.js → GitView-DBFrDDBv.js} +1 -1
  9. package/dist/assets/{JsonTreeView-Kgepz4pR.js → JsonTreeView-DLW2Wy1g.js} +1 -1
  10. package/dist/assets/MarkdownImageGallery-DKIylIK7.js +1 -0
  11. package/dist/assets/MarkdownRendererImpl-CLv8hxvv.js +12 -0
  12. package/dist/assets/OnboardingScreen-D2Y6djMw.js +1 -0
  13. package/dist/assets/{PatchDiff-Cddz02Ya.js → PatchDiff-BuLPx7AN.js} +1 -1
  14. package/dist/assets/{PierreDiffViewer-B5k0KvPW.js → PierreDiffViewer-BHm4Yr0X.js} +2 -2
  15. package/dist/assets/{PlanView-BYgHBHDt.js → PlanView-ZYEJn8A_.js} +3 -3
  16. package/dist/assets/{SessionSwitcherDropdown-ig2OT22Z.js → SessionSwitcherDropdown-rro-SsaO.js} +1 -1
  17. package/dist/assets/SettingsView-5RmswFZe.js +28 -0
  18. package/dist/assets/{SettingsWindow-CNHM8ifT.js → SettingsWindow-BZhAYFdS.js} +1 -1
  19. package/dist/assets/{ToolOutputDialog-DrGeYq2p.js → ToolOutputDialog-Za6V4VMJ.js} +7 -7
  20. package/dist/assets/{ToolPartDiffPreview-BRmPpe94.js → ToolPartDiffPreview-BL-9ixyC.js} +1 -1
  21. package/dist/assets/{VirtualizedFileDiff-Dcu8Q-5P.js → VirtualizedFileDiff-CwGocYQd.js} +1 -1
  22. package/dist/assets/{WalkthroughView-HStEYdD2.js → WalkthroughView-5DyvN03T.js} +2 -2
  23. package/dist/assets/{computeVirtualFileMetrics-DQE7R9IY.js → computeVirtualFileMetrics-Da00Jg7M.js} +2 -2
  24. package/dist/assets/contextPanelEmbeddedChat-B-bSg3P5.js +1 -0
  25. package/dist/assets/de-u7gSnqWs.js +9 -0
  26. package/dist/assets/es-T9O7aAOr.js +15 -0
  27. package/dist/assets/fr-Oor7ewbE.js +13 -0
  28. package/dist/assets/index-BzIpNlNE.css +1 -0
  29. package/dist/assets/{index-BgQEgA2a.js → index-C0yNhuZw.js} +1 -1
  30. package/dist/assets/index-DRpChWux.js +7 -0
  31. package/dist/assets/{isDiffPlainText-XyBCe4eD.js → isDiffPlainText-D9YpoLrV.js} +1 -1
  32. package/dist/assets/{isFilePlainText-JbqDfa3n.js → isFilePlainText-gTibdNIe.js} +1 -1
  33. package/dist/assets/ja-DHpqbVmr.js +15 -0
  34. package/dist/assets/ko-CwLkS3nx.js +15 -0
  35. package/dist/assets/{main-LfcbGv7C.js → main-D7UcL3VQ.js} +2 -2
  36. package/dist/assets/main-DPMd2iKS.js +915 -0
  37. package/dist/assets/markdownCore-DDrHVneM.js +2 -0
  38. package/dist/assets/{miniChat-CUp_elRz.js → miniChat-O_GVoEbc.js} +2 -2
  39. package/dist/assets/{mobile-CBSN7BsH.js → mobile-Br4TtAqc.js} +2 -2
  40. package/dist/assets/{patchFileDiff-DCIXUHRJ.js → patchFileDiff-KNkxM1C1.js} +2 -2
  41. package/dist/assets/{pl-tHTP6XQx.js → pl-CcZILN8q.js} +4 -4
  42. package/dist/assets/pt-BR-DYHhVK6o.js +15 -0
  43. package/dist/assets/{renderElectronMiniChatApp-eZl-5STF.js → renderElectronMiniChatApp-CJpdxTT1.js} +2 -2
  44. package/dist/assets/renderMobileApp-toj9cXoh.js +25 -0
  45. package/dist/assets/runtimeEndpointReset-BVmispdD.js +13 -0
  46. package/dist/assets/scheduledTasksApi-ByKya3Un.js +1 -0
  47. package/dist/assets/{shikiHighlight-eU8abJ3T.js → shikiHighlight-C7LTbwFx.js} +1 -1
  48. package/dist/assets/uk-BA2kZR38.js +15 -0
  49. package/dist/assets/{useAppFontEffects-Bbpz77To.js → useAppFontEffects-BikB6enL.js} +138 -138
  50. package/dist/assets/useInlineCommentController-CYPvYJDt.js +2 -0
  51. package/dist/assets/{vendor-codemirror-language-data-Dzt9rWZZ.js → vendor-codemirror-language-data-CLHw8NWn.js} +2 -2
  52. package/dist/assets/{vendor-marked-i_gIkIP3.js → vendor-marked-CX41MkDF.js} +1 -1
  53. package/dist/assets/{web-components-DGvnI0zx.js → web-components-GMc3oR3i.js} +1 -1
  54. package/dist/assets/zh-CN-dlOQK6v9.js +15 -0
  55. package/dist/assets/zh-TW-BnqQ-WL5.js +15 -0
  56. package/dist/index.html +4 -4
  57. package/dist/mini-chat.html +3 -3
  58. package/dist/mobile.html +3 -3
  59. package/package.json +2 -2
  60. package/server/index.js +65 -19
  61. package/server/lib/agent-tool/DOCUMENTATION.md +21 -6
  62. package/server/lib/agent-tool/runtime.js +90 -16
  63. package/server/lib/agent-tool/runtime.test.js +86 -0
  64. package/server/lib/browser-control/DOCUMENTATION.md +50 -0
  65. package/server/lib/browser-control/broker.js +154 -0
  66. package/server/lib/browser-control/broker.test.js +191 -0
  67. package/server/lib/browser-control/routes.js +48 -0
  68. package/server/lib/browser-control/routes.test.js +108 -0
  69. package/server/lib/dev-servers/parse.js +203 -0
  70. package/server/lib/dev-servers/parse.test.js +174 -0
  71. package/server/lib/dev-servers/routes.js +135 -0
  72. package/server/lib/dev-tunnel/DOCUMENTATION.md +57 -0
  73. package/server/lib/dev-tunnel/client.js +193 -0
  74. package/server/lib/dev-tunnel/runtime.js +189 -0
  75. package/server/lib/dev-tunnel/tunnel.test.js +291 -0
  76. package/server/lib/git/credentials.js +0 -33
  77. package/server/lib/github/DOCUMENTATION.md +1 -1
  78. package/server/lib/markdown-image-grants/DOCUMENTATION.md +36 -0
  79. package/server/lib/markdown-image-grants/routes.js +340 -0
  80. package/server/lib/markdown-image-grants/routes.test.js +221 -0
  81. package/server/lib/openchamber-control/DOCUMENTATION.md +9 -0
  82. package/server/lib/openchamber-control/actions.js +33 -1
  83. package/server/lib/openchamber-control/screenshots.js +83 -0
  84. package/server/lib/openchamber-control/screenshots.test.js +84 -0
  85. package/server/lib/openchamber-control/service.js +141 -2
  86. package/server/lib/openchamber-control/service.test.js +55 -0
  87. package/server/lib/opencode/core-routes.js +31 -52
  88. package/server/lib/opencode/core-routes.test.js +37 -9
  89. package/server/lib/opencode/feature-routes-runtime.js +15 -0
  90. package/server/lib/opencode/server-startup-runtime.js +22 -1
  91. package/server/lib/opencode/server-startup-runtime.test.js +44 -0
  92. package/server/lib/opencode/settings-helpers.js +3 -9
  93. package/server/lib/projects/project-config.js +181 -2
  94. package/server/lib/projects/project-config.test.js +295 -0
  95. package/server/lib/quota/DOCUMENTATION.md +4 -2
  96. package/server/lib/quota/credentials/providers.js +0 -7
  97. package/server/lib/quota/credentials/store.js +11 -1
  98. package/server/lib/quota/credentials/store.test.js +9 -1
  99. package/server/lib/quota/providers/opencode-go.js +35 -35
  100. package/server/lib/quota/providers/opencode-go.test.js +52 -7
  101. package/server/lib/quota/routes.js +0 -2
  102. package/server/lib/relay/DOCUMENTATION.md +2 -0
  103. package/server/lib/relay/tunnel-host.js +157 -33
  104. package/server/lib/relay/tunnel-host.test.js +147 -0
  105. package/server/lib/scheduled-tasks/DOCUMENTATION.md +49 -0
  106. package/server/lib/scheduled-tasks/issue-2710-double-execution.test.js +488 -0
  107. package/server/lib/scheduled-tasks/routes.js +6 -0
  108. package/server/lib/scheduled-tasks/runtime.js +369 -108
  109. package/server/lib/scheduled-tasks/service.js +7 -1
  110. package/server/lib/scheduled-tasks/service.test.js +20 -0
  111. package/server/lib/walkthrough/index.js +0 -2
  112. package/server/sse-routes.test.js +3 -0
  113. package/dist/assets/FilesView-WkxsWHBE.js +0 -14
  114. package/dist/assets/MarkdownRendererImpl-CKAsRfIk.js +0 -12
  115. package/dist/assets/OnboardingScreen-BCgYA7J5.js +0 -1
  116. package/dist/assets/SettingsView-e7Fmxnz8.js +0 -28
  117. package/dist/assets/contextPanelEmbeddedChat-5VGWIT_J.js +0 -1
  118. package/dist/assets/de-B6t6T54h.js +0 -9
  119. package/dist/assets/es-DH9NUKge.js +0 -15
  120. package/dist/assets/fr-Do4t2KmA.js +0 -13
  121. package/dist/assets/index-B45s9aAX.css +0 -1
  122. package/dist/assets/index-CNrN5qDs.js +0 -7
  123. package/dist/assets/ja-DJT9EM80.js +0 -15
  124. package/dist/assets/ko-CfWRq2p4.js +0 -15
  125. package/dist/assets/main-B4oBRI9u.js +0 -193
  126. package/dist/assets/markdownCore-A3_L34oS.js +0 -2
  127. package/dist/assets/pt-BR-BDEzzltP.js +0 -15
  128. package/dist/assets/renderMobileApp-DA7wpIBi.js +0 -23
  129. package/dist/assets/runtimeEndpointReset-D5izT-u5.js +0 -13
  130. package/dist/assets/scheduledTasksApi-CTJdfSWc.js +0 -1
  131. package/dist/assets/uk-B6Q32nyk.js +0 -15
  132. package/dist/assets/useInlineCommentController-D7zs7-BQ.js +0 -2
  133. package/dist/assets/vendor-zumer-snapdom-Btyu_Xi2.js +0 -8
  134. package/dist/assets/zh-CN-7MGcwGaC.js +0 -15
  135. package/dist/assets/zh-TW-CFPfqxlL.js +0 -15
  136. package/server/lib/preview/proxy-runtime.js +0 -1604
  137. package/server/lib/preview/proxy-runtime.test.js +0 -528
  138. package/server/lib/quota/opencode-go-credentials.js +0 -11
  139. package/server/lib/quota/opencode-go-credentials.test.js +0 -32
  140. package/server/lib/quota/routes.test.js +0 -40
@@ -0,0 +1,193 @@
1
+ /**
2
+ * Local end of the dev-server tunnel.
3
+ *
4
+ * Binds a loopback listener on this machine and pipes every connection to a
5
+ * dev server on the OpenChamber host. The point of binding a real local port —
6
+ * rather than serving the remote page under a path on some other origin — is
7
+ * that the page then has its own origin at the root of its own host. Absolute
8
+ * URLs resolve, cookies scope correctly, HMR sockets connect, and nothing has
9
+ * to be rewritten.
10
+ *
11
+ * Lives in the web package because it needs a WebSocket client, which this
12
+ * package already depends on; the desktop shell drives it over IPC.
13
+ */
14
+ import net from 'node:net';
15
+ import { WebSocket } from 'ws';
16
+
17
+ /**
18
+ * What one connection may buffer while its WebSocket is still connecting.
19
+ *
20
+ * Enough for a request with generous headers, far short of a body worth
21
+ * holding: a local process could otherwise keep writing into a stalled
22
+ * handshake and grow the desktop app's memory without limit.
23
+ */
24
+ const MAX_PENDING_BYTES = 256 * 1024;
25
+ /** A handshake that has not completed by now is not going to. */
26
+ const HANDSHAKE_TIMEOUT_MS = 15_000;
27
+
28
+ const toWebSocketUrl = (baseUrl, port) => {
29
+ const parsed = new URL('/api/dev-tunnel', baseUrl);
30
+ // WHATWG URL silently ignores a protocol assignment that crosses from a
31
+ // non-special scheme (custom app protocols, relay-virtual URLs) to `ws:`.
32
+ // Without this check the stale scheme survives into `new WebSocket(...)`,
33
+ // which then throws inside the connection handler and takes the whole
34
+ // process down; rejecting here fails the open() call cleanly instead.
35
+ if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
36
+ throw new Error(`The remote base URL must be http(s); got "${parsed.protocol}"`);
37
+ }
38
+ parsed.protocol = parsed.protocol === 'https:' ? 'wss:' : 'ws:';
39
+ parsed.searchParams.set('port', String(port));
40
+ return parsed.toString();
41
+ };
42
+
43
+ export const createDevTunnelClient = ({
44
+ logger = console,
45
+ handshakeTimeoutMs = HANDSHAKE_TIMEOUT_MS,
46
+ maxPendingBytes = MAX_PENDING_BYTES,
47
+ } = {}) => {
48
+ /** Keyed by `${baseUrl}|${remotePort}` so repeat opens reuse one listener. */
49
+ const tunnels = new Map();
50
+
51
+ const closeTunnel = (key) => {
52
+ const tunnel = tunnels.get(key);
53
+ if (!tunnel) return false;
54
+ tunnels.delete(key);
55
+ for (const socket of tunnel.sockets) {
56
+ try { socket.destroy(); } catch { /* already gone */ }
57
+ }
58
+ try { tunnel.server.close(); } catch { /* already closing */ }
59
+ return true;
60
+ };
61
+
62
+ return {
63
+ /**
64
+ * Opens (or reuses) a tunnel and resolves with the local port to browse.
65
+ * Rejects if the listener cannot bind; per-connection failures close only
66
+ * that connection, so one failed request cannot take the tunnel down.
67
+ */
68
+ async open({ baseUrl, port, headers = {} }) {
69
+ const remotePort = Number.parseInt(String(port), 10);
70
+ if (!Number.isInteger(remotePort) || remotePort <= 0 || remotePort > 65535) {
71
+ throw new Error('A valid remote port is required');
72
+ }
73
+ const base = String(baseUrl || '').trim();
74
+ if (!base) throw new Error('A remote base URL is required');
75
+
76
+ const key = `${base}|${remotePort}`;
77
+ const existing = tunnels.get(key);
78
+ if (existing) return { localPort: existing.localPort, reused: true };
79
+
80
+ const target = toWebSocketUrl(base, remotePort);
81
+ const sockets = new Set();
82
+
83
+ const server = net.createServer((socket) => {
84
+ socket.setNoDelay(true);
85
+ sockets.add(socket);
86
+
87
+ // A synchronous throw here would be an uncaught exception in the
88
+ // connection handler and crash the process; one bad connection must
89
+ // fail alone.
90
+ let upstream;
91
+ try {
92
+ upstream = new WebSocket(target, { headers, perMessageDeflate: false });
93
+ } catch (error) {
94
+ logger.warn?.(`[dev-tunnel] failed to dial upstream for port ${remotePort}: ${error?.message || error}`);
95
+ sockets.delete(socket);
96
+ try { socket.destroy(); } catch { /* already gone */ }
97
+ return;
98
+ }
99
+ upstream.binaryType = 'nodebuffer';
100
+ let pendingWrites = [];
101
+ let pendingBytes = 0;
102
+
103
+ const handshakeTimer = setTimeout(() => {
104
+ logger.warn?.(`[dev-tunnel] handshake timed out for port ${remotePort}`);
105
+ teardown();
106
+ }, handshakeTimeoutMs);
107
+
108
+ function teardown() {
109
+ clearTimeout(handshakeTimer);
110
+ pendingWrites = [];
111
+ pendingBytes = 0;
112
+ sockets.delete(socket);
113
+ try { socket.destroy(); } catch { /* already gone */ }
114
+ try { upstream.close(); } catch { /* already closing */ }
115
+ }
116
+
117
+ upstream.on('open', () => {
118
+ clearTimeout(handshakeTimer);
119
+ for (const chunk of pendingWrites) upstream.send(chunk);
120
+ pendingWrites = [];
121
+ pendingBytes = 0;
122
+ // The local end was held back while there was nowhere to put its
123
+ // bytes; there is somewhere now.
124
+ socket.resume();
125
+ });
126
+ upstream.on('message', (data) => {
127
+ if (socket.destroyed) return;
128
+ socket.write(data);
129
+ });
130
+ upstream.on('error', (error) => {
131
+ logger.warn?.(`[dev-tunnel] upstream failed for port ${remotePort}: ${error?.message || error}`);
132
+ teardown();
133
+ });
134
+ upstream.on('close', teardown);
135
+
136
+ socket.on('data', (chunk) => {
137
+ // Bytes can arrive before the WebSocket handshake completes; buffering
138
+ // them is what keeps the first HTTP request intact. The buffer is
139
+ // bounded, and the local end is paused rather than trusted to stop.
140
+ if (upstream.readyState === WebSocket.OPEN) {
141
+ upstream.send(chunk);
142
+ return;
143
+ }
144
+ if (upstream.readyState !== WebSocket.CONNECTING) return;
145
+
146
+ pendingWrites.push(chunk);
147
+ pendingBytes += chunk.length;
148
+ if (pendingBytes > maxPendingBytes) {
149
+ logger.warn?.(`[dev-tunnel] dropped a connection that buffered too much for port ${remotePort}`);
150
+ teardown();
151
+ return;
152
+ }
153
+ socket.pause();
154
+ });
155
+ socket.on('error', teardown);
156
+ socket.on('close', teardown);
157
+ });
158
+
159
+ const localPort = await new Promise((resolve, reject) => {
160
+ server.once('error', reject);
161
+ server.listen(0, '127.0.0.1', () => {
162
+ server.off('error', reject);
163
+ const address = server.address();
164
+ if (!address || typeof address === 'string') {
165
+ reject(new Error('Failed to bind a local tunnel port'));
166
+ return;
167
+ }
168
+ resolve(address.port);
169
+ });
170
+ });
171
+
172
+ server.on('error', (error) => {
173
+ logger.warn?.(`[dev-tunnel] listener error for port ${remotePort}: ${error?.message || error}`);
174
+ });
175
+
176
+ tunnels.set(key, { server, sockets, localPort, remotePort, baseUrl: base });
177
+ return { localPort, reused: false };
178
+ },
179
+
180
+ close({ baseUrl, port }) {
181
+ return closeTunnel(`${String(baseUrl || '').trim()}|${Number.parseInt(String(port), 10)}`);
182
+ },
183
+
184
+ /** Closes every tunnel; used when the desktop switches runtime or quits. */
185
+ closeAll() {
186
+ for (const key of [...tunnels.keys()]) closeTunnel(key);
187
+ },
188
+
189
+ list() {
190
+ return [...tunnels.values()].map(({ localPort, remotePort, baseUrl }) => ({ localPort, remotePort, baseUrl }));
191
+ },
192
+ };
193
+ };
@@ -0,0 +1,189 @@
1
+ /**
2
+ * Raw byte tunnel to a dev server running on the OpenChamber host.
3
+ *
4
+ * This is what lets a desktop client preview a dev server that lives on another
5
+ * machine without rewriting anything. The client binds its own local port and
6
+ * pipes it here; the page is then served from a real origin at the root of its
7
+ * own host, so absolute URLs, cookies, HMR sockets, and DevTools all behave
8
+ * exactly as they do locally. No HTML is inspected or modified.
9
+ *
10
+ * Security posture: the reachable set is the same list dev-server discovery
11
+ * offers the user, not "any loopback port". Without that restriction an
12
+ * authenticated client could dial arbitrary local services on the host —
13
+ * databases, admin panels, the OpenCode API — through this socket.
14
+ *
15
+ * Authentication differs from the browser-facing sockets on purpose. Those
16
+ * demand an allowed `Origin`, which is a CSRF defence: a hostile page can make
17
+ * a browser open a WebSocket carrying the user's ambient cookies, and the
18
+ * origin is what exposes it. This tunnel's client is the desktop shell, not a
19
+ * browser, and it authenticates with an explicit bearer token. So:
20
+ *
21
+ * - With an `Origin` header, the request came from a browser context and the
22
+ * usual origin check applies unchanged.
23
+ * - With no `Origin`, the request must carry client-token auth. A browser
24
+ * cannot reach this path: the WebSocket API always sends an origin and never
25
+ * lets a page set an `Authorization` header.
26
+ */
27
+ import net from 'node:net';
28
+ import { WebSocketServer } from 'ws';
29
+
30
+ const DEV_TUNNEL_WS_PATH = '/api/dev-tunnel';
31
+ /** One page load opens many sockets; the cap is per host, not per page. */
32
+ const MAX_CONCURRENT_SOCKETS = 64;
33
+ const CONNECT_TIMEOUT_MS = 5_000;
34
+
35
+ const parseRequestedPort = (url) => {
36
+ try {
37
+ const parsed = new URL(String(url || ''), 'http://localhost');
38
+ if (parsed.pathname !== DEV_TUNNEL_WS_PATH) return null;
39
+ const port = Number.parseInt(parsed.searchParams.get('port') || '', 10);
40
+ return Number.isInteger(port) && port > 0 && port <= 65535 ? port : null;
41
+ } catch {
42
+ return null;
43
+ }
44
+ };
45
+
46
+ export const isDevTunnelPath = (url) => {
47
+ try {
48
+ return new URL(String(url || ''), 'http://localhost').pathname === DEV_TUNNEL_WS_PATH;
49
+ } catch {
50
+ return false;
51
+ }
52
+ };
53
+
54
+ export function createDevTunnelRuntime({
55
+ server,
56
+ discoverDevServers,
57
+ uiAuthController,
58
+ isRequestOriginAllowed,
59
+ rejectWebSocketUpgrade,
60
+ logger = console,
61
+ }) {
62
+ const wsServer = new WebSocketServer({ noServer: true });
63
+ let openSockets = 0;
64
+
65
+ /**
66
+ * A port is reachable only while discovery still reports it. Re-checked on
67
+ * every upgrade rather than cached, so a dev server that stops listening
68
+ * stops being reachable.
69
+ */
70
+ const isAllowedPort = async (port) => {
71
+ const result = await discoverDevServers();
72
+ if (!result?.ok) return false;
73
+ return result.servers.some((entry) => entry.port === port);
74
+ };
75
+
76
+ wsServer.on('connection', (socket, req) => {
77
+ const port = parseRequestedPort(req.url);
78
+ if (port === null) {
79
+ socket.close(1008, 'Invalid port');
80
+ return;
81
+ }
82
+
83
+ openSockets += 1;
84
+ const upstream = net.connect({ host: '127.0.0.1', port });
85
+ upstream.setNoDelay(true);
86
+
87
+ let settled = false;
88
+ const teardown = () => {
89
+ if (settled) return;
90
+ settled = true;
91
+ openSockets -= 1;
92
+ try { upstream.destroy(); } catch { /* already gone */ }
93
+ try { socket.close(); } catch { /* already closing */ }
94
+ };
95
+
96
+ const connectTimer = setTimeout(() => {
97
+ if (!upstream.connecting) return;
98
+ logger.warn?.(`[dev-tunnel] timed out connecting to 127.0.0.1:${port}`);
99
+ teardown();
100
+ }, CONNECT_TIMEOUT_MS);
101
+
102
+ upstream.on('connect', () => clearTimeout(connectTimer));
103
+ upstream.on('data', (chunk) => {
104
+ if (socket.readyState !== socket.OPEN) return;
105
+ socket.send(chunk);
106
+ // Stop reading from the dev server while the socket drains, otherwise a
107
+ // fast response against a slow client buffers the whole body in memory.
108
+ if (socket.bufferedAmount > 1_000_000) {
109
+ upstream.pause();
110
+ const resume = () => {
111
+ if (socket.bufferedAmount > 1_000_000) {
112
+ setTimeout(resume, 20);
113
+ return;
114
+ }
115
+ upstream.resume();
116
+ };
117
+ setTimeout(resume, 20);
118
+ }
119
+ });
120
+ upstream.on('error', () => { clearTimeout(connectTimer); teardown(); });
121
+ upstream.on('close', () => { clearTimeout(connectTimer); teardown(); });
122
+
123
+ socket.on('message', (data) => {
124
+ if (upstream.destroyed) return;
125
+ upstream.write(data);
126
+ });
127
+ socket.on('close', teardown);
128
+ socket.on('error', teardown);
129
+ });
130
+
131
+ const upgradeHandler = (req, socket, head) => {
132
+ if (!isDevTunnelPath(req.url)) return;
133
+ void (async () => {
134
+ try {
135
+ if (uiAuthController?.enabled) {
136
+ const auth = await uiAuthController.resolveAuthContext(req, null, { allowUrlToken: false });
137
+ if (!auth) {
138
+ rejectWebSocketUpgrade(socket, 401, 'UI authentication required');
139
+ return;
140
+ }
141
+ const hasOrigin = typeof req.headers?.origin === 'string' && req.headers.origin.trim() !== '';
142
+ if (hasOrigin) {
143
+ if (!await isRequestOriginAllowed(req)) {
144
+ rejectWebSocketUpgrade(socket, 403, 'Invalid origin');
145
+ return;
146
+ }
147
+ } else if (auth.type !== 'client') {
148
+ rejectWebSocketUpgrade(socket, 403, 'Client authentication required');
149
+ return;
150
+ }
151
+ }
152
+
153
+ const port = parseRequestedPort(req.url);
154
+ if (port === null) {
155
+ rejectWebSocketUpgrade(socket, 400, 'Invalid port');
156
+ return;
157
+ }
158
+ if (openSockets >= MAX_CONCURRENT_SOCKETS) {
159
+ rejectWebSocketUpgrade(socket, 503, 'Too many tunnel connections');
160
+ return;
161
+ }
162
+ if (!await isAllowedPort(port)) {
163
+ // Says which port, because the alternative is an empty response in
164
+ // the panel with nothing anywhere explaining why.
165
+ logger.warn?.(`[dev-tunnel] refused port ${port}: not reported by dev-server discovery`);
166
+ rejectWebSocketUpgrade(socket, 403, 'That port is not an available dev server');
167
+ return;
168
+ }
169
+
170
+ wsServer.handleUpgrade(req, socket, head, (ws) => wsServer.emit('connection', ws, req));
171
+ } catch {
172
+ rejectWebSocketUpgrade(socket, 500, 'Upgrade failed');
173
+ }
174
+ })();
175
+ };
176
+
177
+ server.on('upgrade', upgradeHandler);
178
+
179
+ return {
180
+ path: DEV_TUNNEL_WS_PATH,
181
+ get openSocketCount() {
182
+ return openSockets;
183
+ },
184
+ dispose() {
185
+ server.off('upgrade', upgradeHandler);
186
+ wsServer.close();
187
+ },
188
+ };
189
+ }
@@ -0,0 +1,291 @@
1
+ import { afterEach, describe, expect, test } from 'bun:test';
2
+ import http from 'node:http';
3
+ import net from 'node:net';
4
+
5
+ import { createDevTunnelClient } from './client.js';
6
+ import { createDevTunnelRuntime, isDevTunnelPath } from './runtime.js';
7
+
8
+ /**
9
+ * These exercise the real socket path end to end: a dev server, an OpenChamber
10
+ * host tunnelling to it, and a client binding a local port. Anything less would
11
+ * not prove the thing that matters — that a page loads over the tunnel exactly
12
+ * as it does locally.
13
+ */
14
+
15
+ const started = [];
16
+
17
+ const listen = (server, host = '127.0.0.1') => new Promise((resolve) => {
18
+ server.listen(0, host, () => resolve(server.address().port));
19
+ });
20
+
21
+ const trackSockets = (server) => {
22
+ const sockets = new Set();
23
+ server.on('connection', (socket) => {
24
+ sockets.add(socket);
25
+ socket.on('close', () => sockets.delete(socket));
26
+ });
27
+ return sockets;
28
+ };
29
+
30
+ const stopServer = (server, sockets) => async () => {
31
+ for (const socket of sockets) {
32
+ socket.destroy();
33
+ }
34
+ await new Promise((resolve) => server.close(resolve));
35
+ };
36
+
37
+ const startDevServer = async (handler) => {
38
+ const server = http.createServer(handler);
39
+ const sockets = trackSockets(server);
40
+ const port = await listen(server);
41
+ started.push(stopServer(server, sockets));
42
+ return port;
43
+ };
44
+
45
+ const startHost = async ({ allowedPorts, auth = null, discoveryOk = true }) => {
46
+ const server = http.createServer((_req, res) => res.end('host'));
47
+ const sockets = trackSockets(server);
48
+ const port = await listen(server);
49
+ const runtime = createDevTunnelRuntime({
50
+ server,
51
+ discoverDevServers: async () => (discoveryOk
52
+ ? {
53
+ ok: true,
54
+ servers: allowedPorts.map((value) => ({ port: value, url: `http://localhost:${value}/`, command: 'node', pid: 1 })),
55
+ }
56
+ : { ok: false, reason: 'no-listener-source' }),
57
+ uiAuthController: auth ?? { enabled: false },
58
+ isRequestOriginAllowed: async (req) => req.headers.origin === 'http://allowed.example',
59
+ rejectWebSocketUpgrade: (socket, status, message) => {
60
+ socket.write(`HTTP/1.1 ${status} ${message}\r\n\r\n`);
61
+ socket.destroy();
62
+ },
63
+ logger: { warn: () => {} },
64
+ });
65
+ started.push(async () => {
66
+ runtime.dispose();
67
+ await stopServer(server, sockets)();
68
+ });
69
+ return { port, baseUrl: `http://127.0.0.1:${port}`, runtime, sockets };
70
+ };
71
+
72
+ const httpGet = (port, path = '/') => new Promise((resolve, reject) => {
73
+ const request = http.get({ host: '127.0.0.1', port, path }, (response) => {
74
+ let body = '';
75
+ response.on('data', (chunk) => { body += chunk; });
76
+ response.on('end', () => resolve({ status: response.statusCode, body, headers: response.headers }));
77
+ });
78
+ request.on('error', reject);
79
+ request.setTimeout(5_000, () => request.destroy(new Error('timeout')));
80
+ });
81
+
82
+ afterEach(async () => {
83
+ while (started.length) {
84
+ const stop = started.pop();
85
+ await stop();
86
+ }
87
+ });
88
+
89
+ describe('dev tunnel path matching', () => {
90
+ test('only claims its own upgrade path', () => {
91
+ expect(isDevTunnelPath('/api/dev-tunnel?port=5173')).toBe(true);
92
+ expect(isDevTunnelPath('/api/terminal/ws')).toBe(false);
93
+ expect(isDevTunnelPath('')).toBe(false);
94
+ });
95
+ });
96
+
97
+ describe('dev tunnel end to end', () => {
98
+ test('serves the dev server through a local port, unmodified', async () => {
99
+ const devPort = await startDevServer((req, res) => {
100
+ res.setHeader('content-type', 'text/html');
101
+ res.setHeader('x-dev-header', 'kept');
102
+ res.end(`<html><body>path:${req.url}</body></html>`);
103
+ });
104
+ const host = await startHost({ allowedPorts: [devPort] });
105
+
106
+ const client = createDevTunnelClient({ logger: { warn: () => {} } });
107
+ started.push(() => client.closeAll());
108
+ const { localPort } = await client.open({ baseUrl: host.baseUrl, port: devPort });
109
+
110
+ const response = await httpGet(localPort, '/some/page?q=1');
111
+ expect(response.status).toBe(200);
112
+ expect(response.body).toBe('<html><body>path:/some/page?q=1</body></html>');
113
+ expect(response.headers['x-dev-header']).toBe('kept');
114
+ });
115
+
116
+ test('drops a connection that floods a handshake that never completes', async () => {
117
+ // A host that accepts the TCP connection and then says nothing: the
118
+ // WebSocket handshake hangs, which is when buffering could run away.
119
+ const stalled = net.createServer(() => {});
120
+ const stalledSockets = trackSockets(stalled);
121
+ const stalledPort = await listen(stalled);
122
+ started.push(stopServer(stalled, stalledSockets));
123
+
124
+ const client = createDevTunnelClient({
125
+ logger: { warn: () => {} },
126
+ handshakeTimeoutMs: 300,
127
+ });
128
+ started.push(() => client.closeAll());
129
+ const { localPort } = await client.open({ baseUrl: `http://127.0.0.1:${stalledPort}`, port: 4321 });
130
+
131
+ const closed = await new Promise((resolve) => {
132
+ const socket = net.createConnection({ port: localPort, host: '127.0.0.1' }, () => {
133
+ const chunk = Buffer.alloc(64 * 1024, 0x61);
134
+ const write = () => {
135
+ // Keep writing while the handshake hangs; the tunnel must stop this
136
+ // rather than hold every byte in the desktop app's memory.
137
+ if (socket.destroyed) return;
138
+ socket.write(chunk, () => setTimeout(write, 1));
139
+ };
140
+ write();
141
+ });
142
+ socket.on('close', () => resolve(true));
143
+ socket.on('error', () => resolve(true));
144
+ setTimeout(() => resolve(false), 3_000);
145
+ });
146
+
147
+ expect(closed).toBe(true);
148
+ });
149
+
150
+ test('reuses one listener for repeat opens of the same target', async () => {
151
+ const devPort = await startDevServer((_req, res) => res.end('ok'));
152
+ const host = await startHost({ allowedPorts: [devPort] });
153
+ const client = createDevTunnelClient({ logger: { warn: () => {} } });
154
+ started.push(() => client.closeAll());
155
+
156
+ const first = await client.open({ baseUrl: host.baseUrl, port: devPort });
157
+ const second = await client.open({ baseUrl: host.baseUrl, port: devPort });
158
+
159
+ expect(second.localPort).toBe(first.localPort);
160
+ expect(second.reused).toBe(true);
161
+ });
162
+
163
+ test('refuses a port discovery does not report, so it is not a loopback proxy', async () => {
164
+ const secret = await startDevServer((_req, res) => res.end('secret service'));
165
+ const host = await startHost({ allowedPorts: [] });
166
+ const client = createDevTunnelClient({ logger: { warn: () => {} } });
167
+ started.push(() => client.closeAll());
168
+
169
+ const { localPort } = await client.open({ baseUrl: host.baseUrl, port: secret });
170
+ await expect(httpGet(localPort, '/')).rejects.toThrow();
171
+ });
172
+
173
+ test('closing a tunnel frees its local port', async () => {
174
+ const devPort = await startDevServer((_req, res) => res.end('ok'));
175
+ const host = await startHost({ allowedPorts: [devPort] });
176
+ const client = createDevTunnelClient({ logger: { warn: () => {} } });
177
+
178
+ const { localPort } = await client.open({ baseUrl: host.baseUrl, port: devPort });
179
+ expect(client.close({ baseUrl: host.baseUrl, port: devPort })).toBe(true);
180
+ expect(client.list()).toEqual([]);
181
+
182
+ // The port is free again: binding it back succeeds.
183
+ const probe = net.createServer();
184
+ await new Promise((resolve, reject) => {
185
+ probe.once('error', reject);
186
+ probe.listen(localPort, '127.0.0.1', resolve);
187
+ });
188
+ await new Promise((resolve) => probe.close(resolve));
189
+ });
190
+
191
+ test('rejects an invalid remote port before binding anything', async () => {
192
+ const client = createDevTunnelClient({ logger: { warn: () => {} } });
193
+ await expect(client.open({ baseUrl: 'http://127.0.0.1:1', port: 0 })).rejects.toThrow('valid remote port');
194
+ await expect(client.open({ baseUrl: '', port: 5173 })).rejects.toThrow('base URL');
195
+ expect(client.list()).toEqual([]);
196
+ });
197
+
198
+ test('rejects a non-http(s) base URL instead of crashing on first connection', async () => {
199
+ // A non-special scheme survives the `ws:` protocol assignment (WHATWG URL
200
+ // ignores it), so `new WebSocket(...)` used to throw inside the connection
201
+ // handler and take the whole process down.
202
+ const client = createDevTunnelClient({ logger: { warn: () => {} } });
203
+ await expect(client.open({ baseUrl: 'openchamber-ui://index', port: 5173 })).rejects.toThrow('must be http(s)');
204
+ expect(client.list()).toEqual([]);
205
+ });
206
+
207
+ // Not covered here: recovery after a request the dev server kills mid-flight.
208
+ // The behaviour is real (each connection tears down independently), but the
209
+ // abandoned socket makes this harness's teardown unreliable, and a flaky test
210
+ // is worse than a documented gap. Verify it by hand against a restarting dev
211
+ // server.
212
+ });
213
+
214
+ /**
215
+ * The desktop shell dials this from the main process, where there is no browser
216
+ * and therefore no Origin header. Requiring one — as the browser-facing sockets
217
+ * rightly do — silently rejected every tunnel and surfaced as an empty response
218
+ * in the panel, with nothing to connect it back to authentication.
219
+ */
220
+ describe('dev tunnel authentication', () => {
221
+ const clientAuth = {
222
+ enabled: true,
223
+ resolveAuthContext: async (req) => (
224
+ req.headers.authorization === 'Bearer good' ? { type: 'client' } : null
225
+ ),
226
+ };
227
+ const sessionAuth = {
228
+ enabled: true,
229
+ resolveAuthContext: async () => ({ type: 'session' }),
230
+ };
231
+
232
+ test('accepts a bearer-authenticated client that sends no origin', async () => {
233
+ const devPort = await startDevServer((_req, res) => res.end('ok'));
234
+ const host = await startHost({ allowedPorts: [devPort], auth: clientAuth });
235
+ const client = createDevTunnelClient({ logger: { warn: () => {} } });
236
+ started.push(() => client.closeAll());
237
+
238
+ const { localPort } = await client.open({
239
+ baseUrl: host.baseUrl,
240
+ port: devPort,
241
+ headers: { Authorization: 'Bearer good' },
242
+ });
243
+ expect((await httpGet(localPort, '/')).body).toBe('ok');
244
+ });
245
+
246
+ test('rejects a client with no credentials', async () => {
247
+ const devPort = await startDevServer((_req, res) => res.end('ok'));
248
+ const host = await startHost({ allowedPorts: [devPort], auth: clientAuth });
249
+ const client = createDevTunnelClient({ logger: { warn: () => {} } });
250
+ started.push(() => client.closeAll());
251
+
252
+ const { localPort } = await client.open({ baseUrl: host.baseUrl, port: devPort });
253
+ await expect(httpGet(localPort, '/')).rejects.toThrow();
254
+ });
255
+
256
+ test('still refuses a session-authenticated request that sends no origin', async () => {
257
+ // Only an explicit bearer may skip the origin check; ambient session
258
+ // credentials are exactly what the origin check exists to protect.
259
+ const devPort = await startDevServer((_req, res) => res.end('ok'));
260
+ const host = await startHost({ allowedPorts: [devPort], auth: sessionAuth });
261
+ const client = createDevTunnelClient({ logger: { warn: () => {} } });
262
+ started.push(() => client.closeAll());
263
+
264
+ const { localPort } = await client.open({ baseUrl: host.baseUrl, port: devPort });
265
+ await expect(httpGet(localPort, '/')).rejects.toThrow();
266
+ });
267
+
268
+ test('rejects a disallowed origin even with valid credentials', async () => {
269
+ const devPort = await startDevServer((_req, res) => res.end('ok'));
270
+ const host = await startHost({ allowedPorts: [devPort], auth: clientAuth });
271
+ const client = createDevTunnelClient({ logger: { warn: () => {} } });
272
+ started.push(() => client.closeAll());
273
+
274
+ const { localPort } = await client.open({
275
+ baseUrl: host.baseUrl,
276
+ port: devPort,
277
+ headers: { Authorization: 'Bearer good', Origin: 'http://evil.example' },
278
+ });
279
+ await expect(httpGet(localPort, '/')).rejects.toThrow();
280
+ });
281
+
282
+ test('refuses every port when discovery itself is unavailable', async () => {
283
+ const devPort = await startDevServer((_req, res) => res.end('ok'));
284
+ const host = await startHost({ allowedPorts: [devPort], discoveryOk: false });
285
+ const client = createDevTunnelClient({ logger: { warn: () => {} } });
286
+ started.push(() => client.closeAll());
287
+
288
+ const { localPort } = await client.open({ baseUrl: host.baseUrl, port: devPort });
289
+ await expect(httpGet(localPort, '/')).rejects.toThrow();
290
+ });
291
+ });