npm - @flrande/browserctl - Versions diffs - 0.1.0 - Mend

@flrande/browserctl 0.1.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 (90) hide show

package/LICENSE +21 -0
package/README-CN.md +1155 -0
package/README.md +1155 -0
package/apps/browserctl/src/commands/a11y-snapshot.ts +20 -0
package/apps/browserctl/src/commands/act.ts +20 -0
package/apps/browserctl/src/commands/common.test.ts +87 -0
package/apps/browserctl/src/commands/common.ts +191 -0
package/apps/browserctl/src/commands/console-list.ts +20 -0
package/apps/browserctl/src/commands/cookie-clear.ts +18 -0
package/apps/browserctl/src/commands/cookie-get.ts +18 -0
package/apps/browserctl/src/commands/cookie-set.ts +22 -0
package/apps/browserctl/src/commands/dialog-arm.ts +20 -0
package/apps/browserctl/src/commands/dom-query-all.ts +18 -0
package/apps/browserctl/src/commands/dom-query.ts +18 -0
package/apps/browserctl/src/commands/download-trigger.ts +22 -0
package/apps/browserctl/src/commands/download-wait.test.ts +67 -0
package/apps/browserctl/src/commands/download-wait.ts +27 -0
package/apps/browserctl/src/commands/element-screenshot.ts +20 -0
package/apps/browserctl/src/commands/frame-list.ts +16 -0
package/apps/browserctl/src/commands/frame-snapshot.ts +18 -0
package/apps/browserctl/src/commands/network-wait-for.ts +100 -0
package/apps/browserctl/src/commands/profile-list.ts +16 -0
package/apps/browserctl/src/commands/profile-use.ts +18 -0
package/apps/browserctl/src/commands/response-body.ts +24 -0
package/apps/browserctl/src/commands/screenshot.ts +16 -0
package/apps/browserctl/src/commands/snapshot.ts +16 -0
package/apps/browserctl/src/commands/status.ts +10 -0
package/apps/browserctl/src/commands/storage-get.ts +20 -0
package/apps/browserctl/src/commands/storage-set.ts +22 -0
package/apps/browserctl/src/commands/tab-close.ts +20 -0
package/apps/browserctl/src/commands/tab-focus.ts +20 -0
package/apps/browserctl/src/commands/tab-open.ts +19 -0
package/apps/browserctl/src/commands/tabs.ts +13 -0
package/apps/browserctl/src/commands/upload-arm.ts +26 -0
package/apps/browserctl/src/daemon-client.test.ts +253 -0
package/apps/browserctl/src/daemon-client.ts +632 -0
package/apps/browserctl/src/e2e.test.ts +99 -0
package/apps/browserctl/src/main.test.ts +215 -0
package/apps/browserctl/src/main.ts +372 -0
package/apps/browserctl/src/smoke.test.ts +16 -0
package/apps/browserctl/src/smoke.ts +5 -0
package/apps/browserd/src/bootstrap.ts +432 -0
package/apps/browserd/src/chrome-relay-extension-bridge.test.ts +275 -0
package/apps/browserd/src/chrome-relay-extension-bridge.ts +506 -0
package/apps/browserd/src/container.ts +1531 -0
package/apps/browserd/src/main.test.ts +864 -0
package/apps/browserd/src/main.ts +7 -0
package/bin/browserctl.cjs +21 -0
package/bin/browserd.cjs +21 -0
package/extensions/chrome-relay/README.md +36 -0
package/extensions/chrome-relay/background.js +1687 -0
package/extensions/chrome-relay/manifest.json +15 -0
package/extensions/chrome-relay/popup.html +369 -0
package/extensions/chrome-relay/popup.js +972 -0
package/package.json +51 -0
package/packages/core/src/bootstrap.test.ts +10 -0
package/packages/core/src/driver-registry.test.ts +45 -0
package/packages/core/src/driver-registry.ts +22 -0
package/packages/core/src/driver.ts +47 -0
package/packages/core/src/index.ts +5 -0
package/packages/core/src/ref-cache.test.ts +61 -0
package/packages/core/src/ref-cache.ts +28 -0
package/packages/core/src/session-store.test.ts +49 -0
package/packages/core/src/session-store.ts +33 -0
package/packages/core/src/types.ts +9 -0
package/packages/driver-chrome-relay/src/chrome-relay-driver.test.ts +634 -0
package/packages/driver-chrome-relay/src/chrome-relay-driver.ts +2206 -0
package/packages/driver-chrome-relay/src/chrome-relay-extension-runtime.test.ts +264 -0
package/packages/driver-chrome-relay/src/chrome-relay-extension-runtime.ts +521 -0
package/packages/driver-chrome-relay/src/index.ts +26 -0
package/packages/driver-managed/src/index.ts +22 -0
package/packages/driver-managed/src/managed-driver.test.ts +59 -0
package/packages/driver-managed/src/managed-driver.ts +125 -0
package/packages/driver-managed/src/managed-local-driver.test.ts +506 -0
package/packages/driver-managed/src/managed-local-driver.ts +2021 -0
package/packages/driver-remote-cdp/src/index.ts +19 -0
package/packages/driver-remote-cdp/src/remote-cdp-driver.test.ts +617 -0
package/packages/driver-remote-cdp/src/remote-cdp-driver.ts +2042 -0
package/packages/protocol/src/envelope.test.ts +25 -0
package/packages/protocol/src/envelope.ts +31 -0
package/packages/protocol/src/errors.test.ts +17 -0
package/packages/protocol/src/errors.ts +11 -0
package/packages/protocol/src/index.ts +3 -0
package/packages/protocol/src/tools.ts +3 -0
package/packages/transport-mcp-stdio/src/index.ts +3 -0
package/packages/transport-mcp-stdio/src/sdk-server.ts +139 -0
package/packages/transport-mcp-stdio/src/server.test.ts +281 -0
package/packages/transport-mcp-stdio/src/server.ts +183 -0
package/packages/transport-mcp-stdio/src/tool-map.ts +67 -0
package/scripts/smoke.ps1 +127 -0

package/extensions/chrome-relay/manifest.json ADDED Viewed

@@ -0,0 +1,15 @@
+{
+  "manifest_version": 3,
+  "name": "BrowserCtl Relay",
+  "version": "0.1.0",
+  "description": "BrowserCtl local relay extension for chrome-relay extension mode.",
+  "permissions": ["tabs", "scripting", "storage", "debugger", "cookies"],
+  "host_permissions": ["<all_urls>"],
+  "background": {
+    "service_worker": "background.js"
+  },
+  "action": {
+    "default_title": "BrowserCtl Relay",
+    "default_popup": "popup.html"
+  }
+}

package/extensions/chrome-relay/popup.html ADDED Viewed

@@ -0,0 +1,369 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>BrowserCtl Relay</title>
+    <style>
+      :root {
+        --bg: #f3f6fa;
+        --surface: #ffffff;
+        --surface-muted: #f8fafc;
+        --text: #1f2937;
+        --text-muted: #6b7280;
+        --border: #d1d9e6;
+        --primary: #0f6fda;
+        --primary-hover: #095ec1;
+        --secondary: #4b5563;
+        --secondary-hover: #374151;
+        --ok: #1f8f3a;
+        --ok-soft: #e8f6ec;
+        --error: #b02a37;
+        --error-soft: #fdecec;
+      }
+      body {
+        margin: 0;
+        padding: 12px 12px 14px;
+        font-family: "Segoe UI", sans-serif;
+        width: 360px;
+        color: var(--text);
+        background: radial-gradient(
+            circle at top right,
+            rgba(15, 111, 218, 0.15),
+            transparent 50%
+          ),
+          var(--bg);
+      }
+      .layout {
+        display: grid;
+        gap: 12px;
+      }
+      .header {
+        display: flex;
+        justify-content: space-between;
+        align-items: flex-start;
+        gap: 10px;
+        padding: 10px;
+        border: 1px solid var(--border);
+        border-radius: 10px;
+        background: linear-gradient(180deg, #ffffff, #f8fbff);
+        box-shadow: 0 6px 14px rgba(15, 23, 42, 0.06);
+      }
+      .header-title {
+        display: grid;
+        gap: 2px;
+      }
+      .title {
+        font-size: 14px;
+        font-weight: 700;
+      }
+      .subtitle {
+        font-size: 11px;
+        color: var(--text-muted);
+      }
+      .pill {
+        align-self: center;
+        padding: 4px 8px;
+        border-radius: 999px;
+        font-size: 11px;
+        font-weight: 700;
+        border: 1px solid var(--border);
+        background: var(--surface-muted);
+        color: var(--text-muted);
+      }
+      .pill.ok {
+        border-color: #9ad5a9;
+        color: var(--ok);
+        background: var(--ok-soft);
+      }
+      .pill.error {
+        border-color: #f0b7bf;
+        color: var(--error);
+        background: var(--error-soft);
+      }
+      .toolbar {
+        display: flex;
+        justify-content: flex-start;
+      }
+      .language-control {
+        display: grid;
+        gap: 4px;
+        font-size: 11px;
+        font-weight: 600;
+        color: #555;
+      }
+      select {
+        height: 28px;
+        border: 1px solid var(--border);
+        border-radius: 6px;
+        padding: 0 8px;
+        font-size: 12px;
+        background: var(--surface);
+        color: var(--text);
+      }
+      .section-title {
+        font-size: 11px;
+        font-weight: 700;
+        color: var(--text-muted);
+        letter-spacing: 0.02em;
+        text-transform: uppercase;
+      }
+      .panel {
+        display: grid;
+        gap: 8px;
+        border: 1px solid var(--border);
+        border-radius: 10px;
+        background: var(--surface);
+        padding: 10px;
+      }
+      label {
+        display: grid;
+        gap: 4px;
+        font-size: 12px;
+        font-weight: 600;
+      }
+      input {
+        height: 30px;
+        border: 1px solid var(--border);
+        border-radius: 6px;
+        padding: 0 8px;
+        font-size: 12px;
+        background: var(--surface);
+        color: var(--text);
+      }
+      .buttons {
+        display: flex;
+        gap: 8px;
+      }
+      button {
+        flex: 1;
+        height: 30px;
+        border: 0;
+        border-radius: 6px;
+        background: var(--primary);
+        color: #fff;
+        font-size: 12px;
+        font-weight: 600;
+        cursor: pointer;
+        transition: background-color 120ms ease;
+      }
+      button:hover:not(:disabled) {
+        background: var(--primary-hover);
+      }
+      button.secondary {
+        background: var(--secondary);
+      }
+      button.secondary:hover:not(:disabled) {
+        background: var(--secondary-hover);
+      }
+      button:disabled {
+        opacity: 0.6;
+        cursor: not-allowed;
+      }
+      .metrics {
+        display: grid;
+        grid-template-columns: repeat(2, minmax(0, 1fr));
+        gap: 8px;
+      }
+      .metric {
+        border: 1px solid var(--border);
+        border-radius: 8px;
+        background: var(--surface-muted);
+        padding: 8px;
+        display: grid;
+        gap: 4px;
+      }
+      .metric-label {
+        font-size: 10px;
+        letter-spacing: 0.02em;
+        text-transform: uppercase;
+        color: var(--text-muted);
+        font-weight: 700;
+      }
+      .metric-value {
+        font-size: 12px;
+        font-weight: 700;
+        color: var(--text);
+        word-break: break-word;
+      }
+      .metric-value.ok {
+        color: var(--ok);
+      }
+      .metric-value.error {
+        color: var(--error);
+      }
+      .details-block {
+        border: 1px solid var(--border);
+        border-radius: 8px;
+        background: var(--surface-muted);
+        overflow: hidden;
+      }
+      .details-block summary {
+        cursor: pointer;
+        padding: 8px 10px;
+        font-size: 12px;
+        font-weight: 700;
+        color: var(--text-muted);
+      }
+      .status {
+        font-size: 12px;
+        line-height: 1.4;
+        background: #fff;
+        border-top: 1px solid var(--border);
+        padding: 8px 10px;
+        white-space: pre-wrap;
+        margin: 0;
+      }
+      .status.ok {
+        background: var(--ok-soft);
+      }
+      .status.error {
+        background: var(--error-soft);
+      }
+      .hint {
+        font-size: 11px;
+        color: var(--text-muted);
+      }
+      .guidance {
+        margin: 0 0 0 2px;
+        padding-left: 18px;
+        display: grid;
+        gap: 4px;
+        font-size: 12px;
+      }
+      .guidance li {
+        line-height: 1.35;
+      }
+      .feedback {
+        font-size: 12px;
+        border-radius: 7px;
+        padding: 7px 9px;
+        border: 1px solid var(--border);
+        background: var(--surface-muted);
+      }
+      .feedback.ok {
+        border-color: #9ad5a9;
+        color: var(--ok);
+        background: var(--ok-soft);
+      }
+      .feedback.error {
+        border-color: #f0b7bf;
+        color: var(--error);
+        background: var(--error-soft);
+      }
+    </style>
+  </head>
+  <body>
+    <div class="layout">
+      <div class="header">
+        <div class="header-title">
+          <div id="headerTitle" class="title">BrowserCtl Relay</div>
+          <div id="headerSubtitle" class="subtitle">Local browser bridge console</div>
+        </div>
+        <div id="headerConnectionPill" class="pill">Unknown</div>
+      </div>
+      <div class="panel">
+        <div class="toolbar">
+          <label class="language-control">
+            <span id="languageLabel">Language</span>
+            <select id="languageSelect">
+              <option value="en">English</option>
+              <option value="zh-CN">中文</option>
+            </select>
+          </label>
+        </div>
+      </div>
+      <div class="panel">
+        <div id="connectionSectionTitle" class="section-title">Connection</div>
+        <label>
+          <span id="bridgeUrlLabel">Bridge URL</span>
+          <input id="bridgeUrl" type="text" placeholder="ws://127.0.0.1:9223/bridge" />
+        </label>
+        <label>
+          <span id="tokenLabel">Token (required)</span>
+          <input id="token" type="password" placeholder="BROWSERD_CHROME_RELAY_EXTENSION_TOKEN" />
+        </label>
+        <div class="buttons">
+          <button id="saveButton" type="button">Save</button>
+          <button id="reconnectButton" class="secondary" type="button">Reconnect</button>
+        </div>
+      </div>
+      <div class="panel">
+        <div id="statusSectionTitle" class="section-title">Live Status</div>
+        <div id="statusSummary" class="metrics"></div>
+        <details class="details-block">
+          <summary id="statusDetailsLabel">Status details</summary>
+          <div id="statusBox" class="status">Loading relay status...</div>
+        </details>
+      </div>
+      <div class="panel">
+        <div id="troubleshootingSectionTitle" class="section-title">Troubleshooting</div>
+        <div id="diagnosticsHighlights" class="metrics"></div>
+        <div class="buttons">
+          <button id="diagnoseButton" class="secondary" type="button">Run Diagnostics</button>
+          <button id="copyReportButton" class="secondary" type="button">Copy Report</button>
+        </div>
+        <details class="details-block">
+          <summary id="diagnosticsDetailsLabel">Diagnostics details</summary>
+          <div id="diagnosticsBox" class="status">No diagnostics yet.</div>
+        </details>
+        <ul id="guidanceList" class="guidance">
+          <li>Run diagnostics when status and CLI result look inconsistent.</li>
+        </ul>
+      </div>
+      <div id="actionFeedback" class="feedback" hidden></div>
+      <div id="hintText" class="hint">
+        Keep this extension enabled while using browserctl chrome-relay extension mode.
+      </div>
+    </div>
+    <script src="popup.js"></script>
+  </body>
+</html>