local-browser-bridge 0.1.0

package/dist/tests/public-root-consumer-smoke.test.js

@@ -0,0 +1,214 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const strict_1 = __importDefault(require("node:assert/strict"));
+const node_child_process_1 = require("node:child_process");
+const node_http_1 = require("node:http");
+const node_path_1 = require("node:path");
+const node_util_1 = require("node:util");
+const node_test_1 = __importDefault(require("node:test"));
+const execFileAsync = (0, node_util_1.promisify)(node_child_process_1.execFile);
+const capabilities = {
+    schemaVersion: 1,
+    kind: "local-browser-bridge",
+    product: { name: "local-browser-bridge", version: "0.1.0" }
+};
+const diagnostics = {
+    browser: "chrome",
+    checkedAt: "2026-03-30T12:00:00.000Z",
+    runtime: {
+        platform: "darwin",
+        arch: "arm64",
+        nodeVersion: "v25.8.0",
+        safariRunning: true
+    },
+    host: {
+        osascriptAvailable: true,
+        screencaptureAvailable: true,
+        safariApplicationAvailable: true
+    },
+    supportedFeatures: {
+        inspectTabs: true,
+        attach: true,
+        activate: true,
+        navigate: true,
+        screenshot: true,
+        savedSessions: true,
+        cli: true,
+        httpApi: true
+    },
+    constraints: [],
+    attach: {
+        direct: {
+            mode: "direct",
+            source: "user-browser",
+            scope: "browser",
+            supported: true,
+            ready: false,
+            state: "attention-required",
+            blockers: []
+        },
+        relay: {
+            mode: "relay",
+            source: "extension-relay",
+            scope: "tab",
+            supported: true,
+            ready: true,
+            state: "ready",
+            blockers: []
+        }
+    }
+};
+const session = {
+    schemaVersion: 1,
+    id: "sess-http-relay",
+    kind: "chrome-readonly",
+    browser: "chrome",
+    target: { type: "front" },
+    tab: {
+        browser: "chrome",
+        windowIndex: 1,
+        tabIndex: 1,
+        title: "Shared tab",
+        url: "https://example.com",
+        attachedAt: "2026-03-30T12:00:00.000Z",
+        identity: {
+            signature: "sig",
+            urlKey: "https://example.com",
+            titleKey: "Shared tab",
+            origin: "https://example.com",
+            pathname: "/"
+        }
+    },
+    frontTab: {
+        browser: "chrome",
+        windowIndex: 1,
+        tabIndex: 1,
+        title: "Shared tab",
+        url: "https://example.com",
+        attachedAt: "2026-03-30T12:00:00.000Z",
+        identity: {
+            signature: "sig",
+            urlKey: "https://example.com",
+            titleKey: "Shared tab",
+            origin: "https://example.com",
+            pathname: "/"
+        }
+    },
+    attach: {
+        mode: "relay",
+        source: "extension-relay",
+        scope: "tab",
+        resumable: true
+    },
+    semantics: {
+        inspect: "shared-tab-only",
+        list: "saved-session",
+        resume: "current-shared-tab",
+        tabReference: {
+            windowIndex: "synthetic-shared-tab-position",
+            tabIndex: "synthetic-shared-tab-position"
+        }
+    },
+    capabilities: {
+        resume: true,
+        activate: false,
+        navigate: false,
+        screenshot: false
+    },
+    status: {
+        state: "read-only",
+        canAct: false
+    },
+    createdAt: "2026-03-30T12:00:00.000Z"
+};
+const resumedSession = {
+    session: {
+        ...session,
+        id: "sess-cli-relay"
+    },
+    tab: session.tab,
+    resumedAt: "2026-03-30T12:05:00.000Z",
+    resolution: {
+        strategy: "front",
+        matched: true,
+        attachMode: "relay",
+        semantics: "current-shared-tab"
+    }
+};
+async function readJsonBody(request) {
+    const chunks = [];
+    for await (const chunk of request) {
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+    }
+    if (chunks.length === 0) {
+        return undefined;
+    }
+    return JSON.parse(Buffer.concat(chunks).toString("utf8"));
+}
+async function withStubBridge(state, run) {
+    const server = (0, node_http_1.createServer)(async (request, response) => {
+        const url = new URL(request.url ?? "/", "http://127.0.0.1");
+        const body = request.method === "POST" ? await readJsonBody(request) : undefined;
+        state.requests.push({ method: request.method, url: `${url.pathname}${url.search}`, body });
+        if (request.method === "GET" && url.pathname === "/v1/capabilities") {
+            response.writeHead(200, { "content-type": "application/json" });
+            response.end(JSON.stringify({ capabilities }));
+            return;
+        }
+        if (request.method === "GET" && url.pathname === "/v1/diagnostics") {
+            response.writeHead(200, { "content-type": "application/json" });
+            response.end(JSON.stringify({ diagnostics }));
+            return;
+        }
+        if (request.method === "POST" && url.pathname === "/v1/attach") {
+            response.writeHead(200, { "content-type": "application/json" });
+            response.end(JSON.stringify({ session }));
+            return;
+        }
+        response.writeHead(404, { "content-type": "application/json" });
+        response.end(JSON.stringify({ error: { code: "not_found", message: "not found" } }));
+    });
+    await new Promise((resolvePromise) => server.listen(0, "127.0.0.1", resolvePromise));
+    const address = server.address();
+    strict_1.default.ok(address && typeof address === "object");
+    try {
+        return await run(`http://127.0.0.1:${address.port}`);
+    }
+    finally {
+        await new Promise((resolvePromise, reject) => server.close((error) => (error ? reject(error) : resolvePromise())));
+    }
+}
+async function runPublicConsumer(transport, arg1, route, sessionId) {
+    const fixtureEntrypoint = (0, node_path_1.resolve)(process.cwd(), "tests/fixtures/public-root-consumer-runner.js");
+    const result = await execFileAsync(process.execPath, [fixtureEntrypoint, transport, arg1, route, ...(sessionId ? [sessionId] : [])], {
+        cwd: process.cwd()
+    });
+    return JSON.parse(result.stdout);
+}
+(0, node_test_1.default)("public-root smoke: external-style HTTP and CLI consumers traverse the shared adapter stack", async (t) => {
+    await t.test("http attach via package root import returns shared-tab session UX", async () => {
+        const state = { requests: [] };
+        await withStubBridge(state, async (baseUrl) => {
+            const connection = await runPublicConsumer("http", baseUrl, "chrome-relay");
+            strict_1.default.equal(connection.routeUx.label, "Chrome (shared tab, read-only)");
+            strict_1.default.equal(connection.sessionUx.sharedTabScoped, true);
+            strict_1.default.equal(connection.session.id, "sess-http-relay");
+            strict_1.default.deepEqual(state.requests.map((entry) => `${entry.method} ${entry.url}`), ["GET /v1/capabilities", "GET /v1/diagnostics?browser=chrome", "POST /v1/attach"]);
+            strict_1.default.deepEqual(state.requests[2]?.body, {
+                browser: "chrome",
+                attach: { mode: "relay" }
+            });
+        });
+    });
+    await t.test("cli resume via package root import returns resumed shared-tab semantics", async () => {
+        const cliEntrypoint = (0, node_path_1.resolve)(__dirname, "fixtures/public-root-cli-stub.js");
+        const connection = await runPublicConsumer("cli", cliEntrypoint, "chrome-relay", "sess-cli-relay");
+        strict_1.default.equal(connection.operation, "resumeSession");
+        strict_1.default.equal(connection.routeUx.label, "Chrome (shared tab, read-only)");
+        strict_1.default.equal(connection.session.id, resumedSession.session.id);
+        strict_1.default.equal(connection.session.semantics.resume, "current-shared-tab");
+    });
+});

package/dist/tests/reference-adapter.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/reference-adapter.test.js

@@ -0,0 +1,220 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const strict_1 = __importDefault(require("node:assert/strict"));
+const node_test_1 = __importDefault(require("node:test"));
+const reference_adapter_1 = require("../src/reference-adapter");
+(0, node_test_1.default)("connectViaBridge preserves a transport-neutral adapter loop for attach", async () => {
+    const adapter = (0, reference_adapter_1.createBridgeAdapter)({
+        async getCapabilities() {
+            return { schemaVersion: 1, product: { name: "test-bridge" } };
+        },
+        async getDiagnostics(browser) {
+            return {
+                browser,
+                checkedAt: "2026-03-30T12:00:00.000Z",
+                runtime: {
+                    platform: "darwin",
+                    arch: "arm64",
+                    nodeVersion: "v25.8.0",
+                    safariRunning: true
+                },
+                host: {
+                    osascriptAvailable: true,
+                    screencaptureAvailable: true,
+                    safariApplicationAvailable: true
+                },
+                supportedFeatures: {
+                    inspectTabs: true,
+                    attach: true,
+                    activate: true,
+                    navigate: true,
+                    screenshot: true,
+                    savedSessions: true,
+                    cli: true,
+                    httpApi: true
+                },
+                constraints: [],
+                attach: {
+                    direct: {
+                        mode: "direct",
+                        source: "user-browser",
+                        scope: "browser",
+                        supported: true,
+                        ready: true,
+                        state: "ready",
+                        blockers: []
+                    },
+                    relay: {
+                        mode: "relay",
+                        source: "extension-relay",
+                        scope: "tab",
+                        supported: true,
+                        ready: false,
+                        state: "attention-required",
+                        blockers: []
+                    }
+                }
+            };
+        },
+        async attach({ browser, attachMode }) {
+            strict_1.default.equal(browser, "chrome");
+            strict_1.default.equal(attachMode, "relay");
+            return {
+                session: {
+                    schemaVersion: 1,
+                    id: "sess-1",
+                    kind: "chrome-readonly",
+                    browser: "chrome",
+                    target: { type: "front" },
+                    tab: {
+                        browser: "chrome",
+                        windowIndex: 1,
+                        tabIndex: 1,
+                        title: "Shared tab",
+                        url: "https://example.com",
+                        attachedAt: "2026-03-30T12:00:00.000Z",
+                        identity: {
+                            signature: "sig",
+                            urlKey: "https://example.com",
+                            titleKey: "Shared tab",
+                            origin: "https://example.com",
+                            pathname: "/"
+                        }
+                    },
+                    frontTab: {
+                        browser: "chrome",
+                        windowIndex: 1,
+                        tabIndex: 1,
+                        title: "Shared tab",
+                        url: "https://example.com",
+                        attachedAt: "2026-03-30T12:00:00.000Z",
+                        identity: {
+                            signature: "sig",
+                            urlKey: "https://example.com",
+                            titleKey: "Shared tab",
+                            origin: "https://example.com",
+                            pathname: "/"
+                        }
+                    },
+                    attach: {
+                        mode: "relay",
+                        source: "extension-relay",
+                        scope: "tab",
+                        resumable: true
+                    },
+                    semantics: {
+                        inspect: "shared-tab-only",
+                        list: "saved-session",
+                        resume: "current-shared-tab",
+                        tabReference: {
+                            windowIndex: "synthetic-shared-tab-position",
+                            tabIndex: "synthetic-shared-tab-position"
+                        }
+                    },
+                    capabilities: {
+                        resume: true,
+                        activate: false,
+                        navigate: false,
+                        screenshot: false
+                    },
+                    status: {
+                        state: "read-only",
+                        canAct: false
+                    },
+                    createdAt: "2026-03-30T12:00:00.000Z"
+                }
+            };
+        },
+        async resume() {
+            throw new Error("resume should not be called");
+        }
+    });
+    const result = await (0, reference_adapter_1.connectViaBridge)(adapter, {
+        browser: "chrome",
+        attachMode: "relay"
+    });
+    strict_1.default.equal(result.operation, "attach");
+    strict_1.default.equal(result.routeUx.label, "Chrome (shared tab, read-only)");
+    strict_1.default.equal(result.sessionUx.sharedTabScoped, true);
+    strict_1.default.equal(result.session.id, "sess-1");
+    strict_1.default.equal(result.capabilities.schemaVersion, 1);
+});
+(0, node_test_1.default)("sessionFromBridgeResult supports raw sessions and resumed-session envelopes", () => {
+    const rawSession = {
+        schemaVersion: 1,
+        id: "sess-raw",
+        kind: "safari-actionable",
+        browser: "safari",
+        target: { type: "front" },
+        tab: {
+            browser: "safari",
+            windowIndex: 1,
+            tabIndex: 1,
+            title: "Example",
+            url: "https://example.com",
+            attachedAt: "2026-03-30T12:00:00.000Z",
+            identity: {
+                signature: "sig",
+                urlKey: "https://example.com",
+                titleKey: "Example",
+                origin: "https://example.com",
+                pathname: "/"
+            }
+        },
+        frontTab: {
+            browser: "safari",
+            windowIndex: 1,
+            tabIndex: 1,
+            title: "Example",
+            url: "https://example.com",
+            attachedAt: "2026-03-30T12:00:00.000Z",
+            identity: {
+                signature: "sig",
+                urlKey: "https://example.com",
+                titleKey: "Example",
+                origin: "https://example.com",
+                pathname: "/"
+            }
+        },
+        attach: {
+            mode: "direct",
+            source: "user-browser",
+            scope: "browser"
+        },
+        semantics: {
+            inspect: "browser-tabs",
+            list: "saved-session",
+            resume: "saved-browser-target",
+            tabReference: {
+                windowIndex: "browser-position",
+                tabIndex: "browser-position"
+            }
+        },
+        capabilities: {
+            resume: true,
+            activate: true,
+            navigate: true,
+            screenshot: true
+        },
+        status: {
+            state: "actionable",
+            canAct: true
+        },
+        createdAt: "2026-03-30T12:00:00.000Z"
+    };
+    strict_1.default.equal((0, reference_adapter_1.sessionFromBridgeResult)(rawSession).id, "sess-raw");
+    strict_1.default.equal((0, reference_adapter_1.sessionFromBridgeResult)({
+        session: rawSession,
+        tab: rawSession.tab,
+        resumedAt: "2026-03-30T12:05:00.000Z",
+        resolution: {
+            strategy: "front",
+            matched: true,
+            attachMode: "direct",
+            semantics: "saved-browser-target"
+        }
+    }).id, "sess-raw");
+});

package/dist/tests/transport-reference-adapters.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/transport-reference-adapters.test.js

@@ -0,0 +1,214 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const strict_1 = __importDefault(require("node:assert/strict"));
+const node_test_1 = __importDefault(require("node:test"));
+const cli_reference_adapter_1 = require("../src/cli-reference-adapter");
+const http_reference_adapter_1 = require("../src/http-reference-adapter");
+const capabilities = {
+    schemaVersion: 1,
+    kind: "local-browser-bridge",
+    product: { name: "local-browser-bridge", version: "0.1.0" }
+};
+const diagnostics = {
+    browser: "chrome",
+    checkedAt: "2026-03-30T12:00:00.000Z",
+    runtime: {
+        platform: "darwin",
+        arch: "arm64",
+        nodeVersion: "v25.8.0",
+        safariRunning: true
+    },
+    host: {
+        osascriptAvailable: true,
+        screencaptureAvailable: true,
+        safariApplicationAvailable: true
+    },
+    supportedFeatures: {
+        inspectTabs: true,
+        attach: true,
+        activate: true,
+        navigate: true,
+        screenshot: true,
+        savedSessions: true,
+        cli: true,
+        httpApi: true
+    },
+    constraints: [],
+    attach: {
+        direct: {
+            mode: "direct",
+            source: "user-browser",
+            scope: "browser",
+            supported: true,
+            ready: true,
+            state: "ready",
+            blockers: []
+        },
+        relay: {
+            mode: "relay",
+            source: "extension-relay",
+            scope: "tab",
+            supported: true,
+            ready: true,
+            state: "ready",
+            blockers: []
+        }
+    }
+};
+const session = {
+    schemaVersion: 1,
+    id: "sess-1",
+    kind: "chrome-readonly",
+    browser: "chrome",
+    target: { type: "front" },
+    tab: {
+        browser: "chrome",
+        windowIndex: 1,
+        tabIndex: 1,
+        title: "Shared tab",
+        url: "https://example.com",
+        attachedAt: "2026-03-30T12:00:00.000Z",
+        identity: {
+            signature: "sig",
+            urlKey: "https://example.com",
+            titleKey: "Shared tab",
+            origin: "https://example.com",
+            pathname: "/"
+        }
+    },
+    frontTab: {
+        browser: "chrome",
+        windowIndex: 1,
+        tabIndex: 1,
+        title: "Shared tab",
+        url: "https://example.com",
+        attachedAt: "2026-03-30T12:00:00.000Z",
+        identity: {
+            signature: "sig",
+            urlKey: "https://example.com",
+            titleKey: "Shared tab",
+            origin: "https://example.com",
+            pathname: "/"
+        }
+    },
+    attach: {
+        mode: "relay",
+        source: "extension-relay",
+        scope: "tab",
+        resumable: true
+    },
+    semantics: {
+        inspect: "shared-tab-only",
+        list: "saved-session",
+        resume: "current-shared-tab",
+        tabReference: {
+            windowIndex: "synthetic-shared-tab-position",
+            tabIndex: "synthetic-shared-tab-position"
+        }
+    },
+    capabilities: {
+        resume: true,
+        activate: false,
+        navigate: false,
+        screenshot: false
+    },
+    status: {
+        state: "read-only",
+        canAct: false
+    },
+    createdAt: "2026-03-30T12:00:00.000Z"
+};
+const resumedSession = {
+    session,
+    tab: session.tab,
+    resumedAt: "2026-03-30T12:05:00.000Z",
+    resolution: {
+        strategy: "front",
+        matched: true,
+        attachMode: "relay",
+        semantics: "current-shared-tab"
+    }
+};
+(0, node_test_1.default)("createHttpBridgeAdapter maps bridge operations into HTTP envelopes", async () => {
+    const requests = [];
+    const adapter = (0, http_reference_adapter_1.createHttpBridgeAdapter)({
+        async execute(request) {
+            requests.push(request);
+            if (request.method === "GET" && request.path === "/v1/capabilities") {
+                return { body: { capabilities } };
+            }
+            if (request.method === "GET" && request.path === "/v1/diagnostics?browser=chrome") {
+                return { body: { diagnostics } };
+            }
+            if (request.method === "POST" && request.path === "/v1/attach") {
+                return { body: { session } };
+            }
+            if (request.method === "POST" && request.path === "/v1/sessions/sess-1/resume") {
+                return { body: { resumedSession } };
+            }
+            throw new Error(`Unexpected request: ${request.method} ${request.path}`);
+        }
+    });
+    strict_1.default.deepEqual(await adapter.getCapabilities(), capabilities);
+    strict_1.default.deepEqual(await adapter.getDiagnostics("chrome"), diagnostics);
+    strict_1.default.deepEqual(await adapter.attach({ browser: "chrome", attachMode: "relay" }), session);
+    strict_1.default.deepEqual(await adapter.resume("sess-1"), resumedSession);
+    strict_1.default.deepEqual(requests, [
+        { method: "GET", path: "/v1/capabilities" },
+        { method: "GET", path: "/v1/diagnostics?browser=chrome" },
+        {
+            method: "POST",
+            path: "/v1/attach",
+            body: { browser: "chrome", attach: { mode: "relay" } }
+        },
+        { method: "POST", path: "/v1/sessions/sess-1/resume" }
+    ]);
+});
+(0, node_test_1.default)("createCliBridgeAdapter maps bridge operations into CLI commands", async () => {
+    const commands = [];
+    const adapter = (0, cli_reference_adapter_1.createCliBridgeAdapter)({
+        async execute(command) {
+            commands.push(command.args);
+            if (command.args[0] === "capabilities") {
+                return { stdout: JSON.stringify({ capabilities }) };
+            }
+            if (command.args[0] === "diagnostics") {
+                return { stdout: JSON.stringify({ diagnostics }) };
+            }
+            if (command.args[0] === "attach") {
+                return { stdout: JSON.stringify({ session }) };
+            }
+            if (command.args[0] === "resume") {
+                return { stdout: JSON.stringify({ resumedSession }) };
+            }
+            throw new Error(`Unexpected command: ${command.args.join(" ")}`);
+        }
+    });
+    strict_1.default.deepEqual(await adapter.getCapabilities(), capabilities);
+    strict_1.default.deepEqual(await adapter.getDiagnostics("chrome"), diagnostics);
+    strict_1.default.deepEqual(await adapter.attach({ browser: "chrome", attachMode: "relay" }), session);
+    strict_1.default.deepEqual(await adapter.resume("sess-1"), resumedSession);
+    strict_1.default.deepEqual(commands, [
+        ["capabilities"],
+        ["diagnostics", "--browser", "chrome"],
+        ["attach", "--browser", "chrome", "--attach-mode", "relay"],
+        ["resume", "--id", "sess-1"]
+    ]);
+});
+(0, node_test_1.default)("transport adapters fail clearly when required envelopes are missing", async () => {
+    const httpAdapter = (0, http_reference_adapter_1.createHttpBridgeAdapter)({
+        async execute() {
+            return { body: {} };
+        }
+    });
+    const cliAdapter = (0, cli_reference_adapter_1.createCliBridgeAdapter)({
+        async execute() {
+            return { stdout: JSON.stringify({}) };
+        }
+    });
+    await strict_1.default.rejects(() => httpAdapter.getCapabilities(), /Expected capabilities response to include capabilities\./);
+    await strict_1.default.rejects(() => cliAdapter.resume("sess-1"), /Expected resumeSession command output to include resumedSession\./);
+});