@flrande/browserctl 0.5.0-dev.22.1 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (136) hide show
  1. package/dist/client.d.ts +34 -0
  2. package/dist/client.js +138 -0
  3. package/dist/commandRegistry.d.ts +16 -0
  4. package/dist/commandRegistry.js +21 -0
  5. package/dist/help.d.ts +4 -0
  6. package/dist/help.js +24 -0
  7. package/dist/index.d.ts +3 -0
  8. package/dist/index.js +23 -0
  9. package/dist/runCli.d.ts +5 -0
  10. package/dist/runCli.js +170 -0
  11. package/package.json +32 -59
  12. package/INSTALL-CN.md +0 -92
  13. package/INSTALL.md +0 -92
  14. package/LICENSE +0 -21
  15. package/README-CN.md +0 -69
  16. package/README.md +0 -69
  17. package/apps/browserctl/src/commands/a11y-snapshot.ts +0 -20
  18. package/apps/browserctl/src/commands/act.test.ts +0 -71
  19. package/apps/browserctl/src/commands/act.ts +0 -64
  20. package/apps/browserctl/src/commands/command-wrappers.test.ts +0 -688
  21. package/apps/browserctl/src/commands/common.test.ts +0 -87
  22. package/apps/browserctl/src/commands/common.ts +0 -191
  23. package/apps/browserctl/src/commands/console-list.test.ts +0 -102
  24. package/apps/browserctl/src/commands/console-list.ts +0 -108
  25. package/apps/browserctl/src/commands/cookie-clear.ts +0 -18
  26. package/apps/browserctl/src/commands/cookie-get.ts +0 -18
  27. package/apps/browserctl/src/commands/cookie-set.ts +0 -22
  28. package/apps/browserctl/src/commands/dialog-arm.ts +0 -20
  29. package/apps/browserctl/src/commands/dom-query-all.ts +0 -18
  30. package/apps/browserctl/src/commands/dom-query.ts +0 -18
  31. package/apps/browserctl/src/commands/download-trigger.ts +0 -22
  32. package/apps/browserctl/src/commands/download-wait.test.ts +0 -67
  33. package/apps/browserctl/src/commands/download-wait.ts +0 -27
  34. package/apps/browserctl/src/commands/element-screenshot.ts +0 -20
  35. package/apps/browserctl/src/commands/frame-list.ts +0 -16
  36. package/apps/browserctl/src/commands/frame-snapshot.ts +0 -18
  37. package/apps/browserctl/src/commands/har-export.test.ts +0 -112
  38. package/apps/browserctl/src/commands/har-export.ts +0 -120
  39. package/apps/browserctl/src/commands/memory-delete.ts +0 -20
  40. package/apps/browserctl/src/commands/memory-inspect.ts +0 -20
  41. package/apps/browserctl/src/commands/memory-list.ts +0 -90
  42. package/apps/browserctl/src/commands/memory-mode-set.ts +0 -29
  43. package/apps/browserctl/src/commands/memory-purge.ts +0 -16
  44. package/apps/browserctl/src/commands/memory-resolve.ts +0 -56
  45. package/apps/browserctl/src/commands/memory-status.ts +0 -16
  46. package/apps/browserctl/src/commands/memory-ttl-set.ts +0 -28
  47. package/apps/browserctl/src/commands/memory-upsert.ts +0 -142
  48. package/apps/browserctl/src/commands/network-list.test.ts +0 -110
  49. package/apps/browserctl/src/commands/network-list.ts +0 -112
  50. package/apps/browserctl/src/commands/network-wait-for.test.ts +0 -90
  51. package/apps/browserctl/src/commands/network-wait-for.ts +0 -100
  52. package/apps/browserctl/src/commands/profile-list.ts +0 -16
  53. package/apps/browserctl/src/commands/profile-use.ts +0 -18
  54. package/apps/browserctl/src/commands/response-body.ts +0 -24
  55. package/apps/browserctl/src/commands/screenshot.ts +0 -16
  56. package/apps/browserctl/src/commands/session-drop.test.ts +0 -36
  57. package/apps/browserctl/src/commands/session-drop.ts +0 -16
  58. package/apps/browserctl/src/commands/session-list.test.ts +0 -81
  59. package/apps/browserctl/src/commands/session-list.ts +0 -70
  60. package/apps/browserctl/src/commands/snapshot.ts +0 -16
  61. package/apps/browserctl/src/commands/status.ts +0 -10
  62. package/apps/browserctl/src/commands/storage-get.ts +0 -20
  63. package/apps/browserctl/src/commands/storage-set.ts +0 -22
  64. package/apps/browserctl/src/commands/tab-close.ts +0 -20
  65. package/apps/browserctl/src/commands/tab-focus.ts +0 -20
  66. package/apps/browserctl/src/commands/tab-open.ts +0 -19
  67. package/apps/browserctl/src/commands/tabs.ts +0 -13
  68. package/apps/browserctl/src/commands/trace-get.test.ts +0 -61
  69. package/apps/browserctl/src/commands/trace-get.ts +0 -62
  70. package/apps/browserctl/src/commands/upload-arm.ts +0 -26
  71. package/apps/browserctl/src/commands/wait-element.test.ts +0 -80
  72. package/apps/browserctl/src/commands/wait-element.ts +0 -76
  73. package/apps/browserctl/src/commands/wait-text.test.ts +0 -110
  74. package/apps/browserctl/src/commands/wait-text.ts +0 -93
  75. package/apps/browserctl/src/commands/wait-url.test.ts +0 -80
  76. package/apps/browserctl/src/commands/wait-url.ts +0 -76
  77. package/apps/browserctl/src/daemon-client.test.ts +0 -512
  78. package/apps/browserctl/src/daemon-client.ts +0 -632
  79. package/apps/browserctl/src/e2e.test.ts +0 -103
  80. package/apps/browserctl/src/main.dispatch.test.ts +0 -461
  81. package/apps/browserctl/src/main.test.ts +0 -334
  82. package/apps/browserctl/src/main.ts +0 -957
  83. package/apps/browserctl/src/smoke.e2e.test.ts +0 -97
  84. package/apps/browserctl/src/test-port.ts +0 -26
  85. package/apps/browserd/src/bootstrap.ts +0 -432
  86. package/apps/browserd/src/chrome-relay-extension-bridge.test.ts +0 -250
  87. package/apps/browserd/src/chrome-relay-extension-bridge.ts +0 -506
  88. package/apps/browserd/src/container.ts +0 -3088
  89. package/apps/browserd/src/main.test.ts +0 -1522
  90. package/apps/browserd/src/main.ts +0 -7
  91. package/apps/browserd/src/test-port.ts +0 -26
  92. package/apps/browserd/src/tool-matrix.test.ts +0 -887
  93. package/bin/browserctl.cjs +0 -21
  94. package/bin/browserd.cjs +0 -21
  95. package/extensions/chrome-relay/README-CN.md +0 -39
  96. package/extensions/chrome-relay/README.md +0 -39
  97. package/extensions/chrome-relay/background.js +0 -1687
  98. package/extensions/chrome-relay/manifest.json +0 -15
  99. package/extensions/chrome-relay/popup.html +0 -369
  100. package/extensions/chrome-relay/popup.js +0 -972
  101. package/packages/core/src/bootstrap.test.ts +0 -10
  102. package/packages/core/src/driver-registry.test.ts +0 -45
  103. package/packages/core/src/driver-registry.ts +0 -22
  104. package/packages/core/src/driver.ts +0 -47
  105. package/packages/core/src/index.ts +0 -6
  106. package/packages/core/src/navigation-memory.test.ts +0 -259
  107. package/packages/core/src/navigation-memory.ts +0 -360
  108. package/packages/core/src/ref-cache.test.ts +0 -61
  109. package/packages/core/src/ref-cache.ts +0 -28
  110. package/packages/core/src/session-store.test.ts +0 -82
  111. package/packages/core/src/session-store.ts +0 -138
  112. package/packages/core/src/types.ts +0 -9
  113. package/packages/driver-chrome-relay/src/chrome-relay-driver.test.ts +0 -744
  114. package/packages/driver-chrome-relay/src/chrome-relay-driver.ts +0 -2429
  115. package/packages/driver-chrome-relay/src/chrome-relay-extension-runtime.test.ts +0 -264
  116. package/packages/driver-chrome-relay/src/chrome-relay-extension-runtime.ts +0 -521
  117. package/packages/driver-chrome-relay/src/index.ts +0 -26
  118. package/packages/driver-managed/src/index.ts +0 -22
  119. package/packages/driver-managed/src/managed-driver.test.ts +0 -183
  120. package/packages/driver-managed/src/managed-driver.ts +0 -341
  121. package/packages/driver-managed/src/managed-local-driver.test.ts +0 -608
  122. package/packages/driver-managed/src/managed-local-driver.ts +0 -2243
  123. package/packages/driver-remote-cdp/src/index.ts +0 -19
  124. package/packages/driver-remote-cdp/src/remote-cdp-driver.test.ts +0 -727
  125. package/packages/driver-remote-cdp/src/remote-cdp-driver.ts +0 -2264
  126. package/packages/protocol/src/envelope.test.ts +0 -25
  127. package/packages/protocol/src/envelope.ts +0 -31
  128. package/packages/protocol/src/errors.test.ts +0 -17
  129. package/packages/protocol/src/errors.ts +0 -11
  130. package/packages/protocol/src/index.ts +0 -3
  131. package/packages/protocol/src/tools.ts +0 -3
  132. package/packages/transport-mcp-stdio/src/index.ts +0 -3
  133. package/packages/transport-mcp-stdio/src/sdk-server.ts +0 -139
  134. package/packages/transport-mcp-stdio/src/server.test.ts +0 -281
  135. package/packages/transport-mcp-stdio/src/server.ts +0 -183
  136. package/packages/transport-mcp-stdio/src/tool-map.ts +0 -84
@@ -1,250 +0,0 @@
1
- import { afterEach, describe, expect, it } from "vitest";
2
- import { WebSocket } from "ws";
3
-
4
- import { createChromeRelayExtensionBridge } from "./chrome-relay-extension-bridge";
5
- import { reserveLoopbackPort } from "./test-port";
6
-
7
- async function waitForCondition(predicate: () => boolean, timeoutMs = 1000): Promise<void> {
8
- const start = Date.now();
9
- while (!predicate()) {
10
- if (Date.now() - start > timeoutMs) {
11
- throw new Error("Timed out waiting for condition.");
12
- }
13
-
14
- await new Promise<void>((resolve) => {
15
- setTimeout(resolve, 10);
16
- });
17
- }
18
- }
19
-
20
- type Closable = {
21
- close(): Promise<void> | void;
22
- };
23
-
24
- const closables: Closable[] = [];
25
-
26
- afterEach(async () => {
27
- while (closables.length > 0) {
28
- const item = closables.pop();
29
- if (item === undefined) {
30
- continue;
31
- }
32
-
33
- await item.close();
34
- }
35
- });
36
-
37
- describe("createChromeRelayExtensionBridge", () => {
38
- it("requires token configuration for extension bridge startup", async () => {
39
- const port = await reserveLoopbackPort();
40
-
41
- expect(() =>
42
- createChromeRelayExtensionBridge({
43
- relayUrl: `http://127.0.0.1:${port}`
44
- })
45
- ).toThrow("BROWSERD_CHROME_RELAY_EXTENSION_TOKEN");
46
- });
47
-
48
- it("sends requests to extension client and receives responses", async () => {
49
- const port = await reserveLoopbackPort();
50
- const bridge = createChromeRelayExtensionBridge({
51
- relayUrl: `http://127.0.0.1:${port}`,
52
- token: "secret-token",
53
- requestTimeoutMs: 500
54
- });
55
- closables.push(bridge);
56
-
57
- const socket = new WebSocket(`ws://127.0.0.1:${port}/bridge`);
58
- closables.push({
59
- async close() {
60
- if (socket.readyState === WebSocket.OPEN || socket.readyState === WebSocket.CONNECTING) {
61
- await new Promise<void>((resolve) => {
62
- socket.once("close", () => resolve());
63
- socket.close();
64
- });
65
- }
66
- }
67
- });
68
-
69
- await new Promise<void>((resolve, reject) => {
70
- socket.once("open", () => {
71
- socket.send(
72
- JSON.stringify({
73
- type: "hello",
74
- role: "extension",
75
- extensionId: "ext:test",
76
- token: "secret-token"
77
- })
78
- );
79
- resolve();
80
- });
81
- socket.once("error", reject);
82
- });
83
- await waitForCondition(() => bridge.isConnected());
84
-
85
- socket.on("message", (message) => {
86
- const parsed = JSON.parse(String(message)) as Record<string, unknown>;
87
- if (parsed.type !== "request") {
88
- return;
89
- }
90
-
91
- socket.send(
92
- JSON.stringify({
93
- type: "response",
94
- id: parsed.id,
95
- ok: true,
96
- result: {
97
- accepted: true,
98
- method: parsed.method
99
- }
100
- })
101
- );
102
- });
103
-
104
- await expect(bridge.invoke("tab.open", { url: "https://example.com" })).resolves.toEqual({
105
- accepted: true,
106
- method: "tab.open"
107
- });
108
- expect(bridge.isConnected()).toBe(true);
109
- });
110
-
111
- it("rejects invoke when extension is not connected", async () => {
112
- const port = await reserveLoopbackPort();
113
- const bridge = createChromeRelayExtensionBridge({
114
- relayUrl: `http://127.0.0.1:${port}`,
115
- token: "secret-token",
116
- requestTimeoutMs: 200
117
- });
118
- closables.push(bridge);
119
-
120
- await expect(bridge.invoke("tab.info", { tabId: 1 })).rejects.toThrowError(
121
- "Chrome relay extension is not connected."
122
- );
123
- });
124
-
125
- it("enforces token validation for extension websocket connection", async () => {
126
- const port = await reserveLoopbackPort();
127
- const bridge = createChromeRelayExtensionBridge({
128
- relayUrl: `http://127.0.0.1:${port}`,
129
- token: "secret-token",
130
- requestTimeoutMs: 500
131
- });
132
- closables.push(bridge);
133
-
134
- const socket = new WebSocket(`ws://127.0.0.1:${port}/bridge`);
135
- closables.push({
136
- async close() {
137
- if (socket.readyState === WebSocket.OPEN || socket.readyState === WebSocket.CONNECTING) {
138
- await new Promise<void>((resolve) => {
139
- socket.once("close", () => resolve());
140
- socket.close();
141
- });
142
- }
143
- }
144
- });
145
-
146
- await new Promise<void>((resolve, reject) => {
147
- socket.once("open", () => {
148
- socket.send(
149
- JSON.stringify({
150
- type: "hello",
151
- role: "extension",
152
- extensionId: "ext:test",
153
- token: "wrong-token"
154
- })
155
- );
156
- });
157
- socket.once("close", () => resolve());
158
- socket.once("error", reject);
159
- });
160
-
161
- expect(socket.readyState).not.toBe(WebSocket.OPEN);
162
- expect(bridge.isConnected()).toBe(false);
163
- });
164
-
165
- it("forwards extension event envelopes to bridge listeners", async () => {
166
- const port = await reserveLoopbackPort();
167
- const bridge = createChromeRelayExtensionBridge({
168
- relayUrl: `http://127.0.0.1:${port}`,
169
- token: "secret-token",
170
- requestTimeoutMs: 500
171
- });
172
- closables.push(bridge);
173
-
174
- const socket = new WebSocket(`ws://127.0.0.1:${port}/bridge`);
175
- closables.push({
176
- async close() {
177
- if (socket.readyState === WebSocket.OPEN || socket.readyState === WebSocket.CONNECTING) {
178
- await new Promise<void>((resolve) => {
179
- socket.once("close", () => resolve());
180
- socket.close();
181
- });
182
- }
183
- }
184
- });
185
-
186
- await new Promise<void>((resolve, reject) => {
187
- socket.once("open", () => {
188
- socket.send(
189
- JSON.stringify({
190
- type: "hello",
191
- role: "extension",
192
- extensionId: "ext:test",
193
- token: "secret-token"
194
- })
195
- );
196
- resolve();
197
- });
198
- socket.once("error", reject);
199
- });
200
- await waitForCondition(() => bridge.isConnected());
201
-
202
- const receivedEvents: Array<Record<string, unknown>> = [];
203
- const detach = bridge.onEvent((event) => {
204
- receivedEvents.push(event as unknown as Record<string, unknown>);
205
- });
206
- closables.push({
207
- close() {
208
- detach();
209
- }
210
- });
211
-
212
- socket.send(
213
- JSON.stringify({
214
- type: "event",
215
- event: {
216
- kind: "console",
217
- tabId: 7,
218
- entry: {
219
- type: "log",
220
- text: "hello-event"
221
- }
222
- }
223
- })
224
- );
225
-
226
- await new Promise<void>((resolve) => {
227
- const start = Date.now();
228
- const poll = () => {
229
- if (receivedEvents.length >= 1 || Date.now() - start > 1000) {
230
- resolve();
231
- return;
232
- }
233
-
234
- setTimeout(poll, 10);
235
- };
236
-
237
- poll();
238
- });
239
-
240
- expect(receivedEvents).toHaveLength(1);
241
- expect(receivedEvents[0]).toMatchObject({
242
- kind: "console",
243
- tabId: 7,
244
- entry: {
245
- type: "log",
246
- text: "hello-event"
247
- }
248
- });
249
- });
250
- });