@jobshimo/browser-link 0.39.0 → 0.41.0

package/dist/extension/version-status.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Version facts the popup shows, computed from what the server reported in
+ * `tab.registered`. Pure on purpose: background.ts gathers the inputs, this
+ * module decides, and popup.ts only renders.
+ *
+ * Three versions are in play:
+ * - `extension`: this extension's manifest version.
+ * - `server`: the version the running server booted with (`serverVersion`).
+ * - `installed`: the package version on disk right now (`installedVersion`,
+ *   servers from 0.41.0). When it is newer than `server`, the package was
+ *   updated while an old process kept serving: the server is outdated.
+ */
+/**
+ * Compare two `major.minor.patch` versions numerically. A leading `v` and any
+ * prerelease or build suffix are ignored; missing or non-numeric parts count
+ * as 0. Returns a negative number, 0 or a positive number like a sort
+ * comparator.
+ */
+export declare function compareSemver(a: string, b: string): number;
+export interface VersionCheckInput {
+    extension: string;
+    server: string | null;
+    installed: string | null;
+}
+/** What background.ts answers to the popup's `versionCheck`. `extension`,
+ * `server` and `aligned` keep their pre-0.41.0 meaning; `installed` and
+ * `serverOutdated` are additive. */
+export interface VersionCheck {
+    extension: string;
+    server: string | null;
+    installed: string | null;
+    /** Extension and server run the same version; null while no server has
+     * reported one. */
+    aligned: boolean | null;
+    /** The installed package is newer than the code the server is running. */
+    serverOutdated: boolean;
+}
+export declare function computeVersionCheck(input: VersionCheckInput): VersionCheck;
+/** The existing "Version mismatch" banner: shown only when a server version
+ * is known and differs from the extension's. Unchanged by 0.41.0. */
+export declare function shouldShowVersionBanner(check: VersionCheck): boolean;
+/** "Server running X · installed Y" when the server runs a different version
+ * than the one installed on disk; null when they match or either is unknown. */
+export declare function runningInstalledLine(check: VersionCheck): string | null;

package/dist/extension/version-status.js

@@ -0,0 +1,60 @@
+/**
+ * Version facts the popup shows, computed from what the server reported in
+ * `tab.registered`. Pure on purpose: background.ts gathers the inputs, this
+ * module decides, and popup.ts only renders.
+ *
+ * Three versions are in play:
+ * - `extension`: this extension's manifest version.
+ * - `server`: the version the running server booted with (`serverVersion`).
+ * - `installed`: the package version on disk right now (`installedVersion`,
+ *   servers from 0.41.0). When it is newer than `server`, the package was
+ *   updated while an old process kept serving: the server is outdated.
+ */
+/**
+ * Compare two `major.minor.patch` versions numerically. A leading `v` and any
+ * prerelease or build suffix are ignored; missing or non-numeric parts count
+ * as 0. Returns a negative number, 0 or a positive number like a sort
+ * comparator.
+ */
+export function compareSemver(a, b) {
+    const pa = semverParts(a);
+    const pb = semverParts(b);
+    for (let i = 0; i < 3; i += 1) {
+        const diff = (pa[i] ?? 0) - (pb[i] ?? 0);
+        if (diff !== 0)
+            return diff;
+    }
+    return 0;
+}
+function semverParts(version) {
+    const core = version.trim().replace(/^v/i, '').split(/[-+]/, 1)[0] ?? '';
+    return core.split('.').map((part) => {
+        const n = Number.parseInt(part, 10);
+        return Number.isFinite(n) && n >= 0 ? n : 0;
+    });
+}
+export function computeVersionCheck(input) {
+    const { extension, server, installed } = input;
+    return {
+        extension,
+        server,
+        installed,
+        aligned: server === null ? null : server === extension,
+        serverOutdated: server !== null && installed !== null && compareSemver(installed, server) > 0,
+    };
+}
+/** The existing "Version mismatch" banner: shown only when a server version
+ * is known and differs from the extension's. Unchanged by 0.41.0. */
+export function shouldShowVersionBanner(check) {
+    return check.server !== null && check.aligned === false;
+}
+/** "Server running X · installed Y" when the server runs a different version
+ * than the one installed on disk; null when they match or either is unknown. */
+export function runningInstalledLine(check) {
+    if (check.server === null || check.installed === null)
+        return null;
+    if (check.installed === check.server)
+        return null;
+    return `Server running ${check.server} · installed ${check.installed}`;
+}
+//# sourceMappingURL=version-status.js.map

package/dist/extension/version-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-status.js","sourceRoot":"","sources":["../src/version-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,CAAS,EAAE,CAAS;IAChD,MAAM,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IAC1B,MAAM,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACzC,IAAI,IAAI,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;IAC9B,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,WAAW,CAAC,OAAe;IAClC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACzE,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAClC,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACpC,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;AACL,CAAC;AAsBD,MAAM,UAAU,mBAAmB,CAAC,KAAwB;IAC1D,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;IAC/C,OAAO;QACL,SAAS;QACT,MAAM;QACN,SAAS;QACT,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS;QACtD,cAAc,EAAE,MAAM,KAAK,IAAI,IAAI,SAAS,KAAK,IAAI,IAAI,aAAa,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC;KAC9F,CAAC;AACJ,CAAC;AAED;qEACqE;AACrE,MAAM,UAAU,uBAAuB,CAAC,KAAmB;IACzD,OAAO,KAAK,CAAC,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,KAAK,KAAK,CAAC;AAC1D,CAAC;AAED;gFACgF;AAChF,MAAM,UAAU,oBAAoB,CAAC,KAAmB;IACtD,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,SAAS,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACnE,IAAI,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAClD,OAAO,kBAAkB,KAAK,CAAC,MAAM,gBAAgB,KAAK,CAAC,SAAS,EAAE,CAAC;AACzE,CAAC"}

package/dist/lifecycle/election.d.ts

@@ -0,0 +1,98 @@
+import { type ExecFileLike } from './processes.js';
+/**
+ * Version-aware primary election.
+ *
+ * Without this, the primary is simply whoever bound 127.0.0.1:17529 first,
+ * so an old server kept serving after an update until somebody killed it.
+ * When a starting process finds the port taken it probes the running
+ * primary's `GET /version` (see `version-endpoint.ts`) and decides:
+ *
+ *   (a) remote version known and older than ours           → take over;
+ *   (b) remote answers HTTP but has no `/version` (a primary older than
+ *       0.41.0) and its process started before the installed code was last
+ *       written: it is necessarily running stale code       → take over;
+ *   (c) anything else (same or newer version, unknown start
+ *       time, nothing answering HTTP)                       → defer.
+ *
+ * Deferring is the existing behaviour: proxy mode with multi-agent on, the
+ * existing error otherwise. Taking over = step the owner down (a kill: old
+ * primaries understand no step-down frame), then bind with retries. The hard
+ * kill closes the extension sockets uncleanly, which is exactly what the
+ * extension's auto-reconnect waits for.
+ *
+ * Every effect is injected so the decision is testable without killing or
+ * binding anything real; `server.ts` only wires the real implementations.
+ */
+export interface VersionInfo {
+    name: string;
+    version: string;
+    pid: number;
+    startedAt: string;
+    installedVersion: string | null;
+}
+export type VersionProbe = 
+/** The primary answered `/version`. */
+{
+    kind: 'version';
+    info: VersionInfo;
+}
+/** Something answered HTTP on the port, but not a valid `/version`. */
+ | {
+    kind: 'no-endpoint';
+}
+/** Nothing answered HTTP (refused, timeout, not an HTTP server). */
+ | {
+    kind: 'unreachable';
+};
+export type ElectionDecision = 'take-over' | 'defer';
+export interface ElectionOutcome {
+    decision: ElectionDecision;
+    /** The process stepped down (take-over) or that would have been. */
+    pid: number | null;
+    reason: string;
+}
+export interface DecideInput {
+    local: string;
+    probe: VersionProbe;
+    ownerPid: number | null;
+    ownerStartedAt: number | null;
+    installedCodeMtime: number | null;
+}
+/** The pure decision table (a)/(b)/(c) above. */
+export declare function decideElection(input: DecideInput): ElectionOutcome;
+export interface ElectionDeps {
+    localVersion: string;
+    probe: () => Promise<VersionProbe>;
+    /** Pid listening on the bridge port; used only when `/version` is absent. */
+    findOwnerPid: () => number | null;
+    processStartTime: (pid: number) => number | null;
+    installedCodeMtime: () => number | null;
+    stepDown: (pid: number) => Promise<void>;
+}
+/** Probe, decide and, on take-over, step the owner down. The caller binds
+ * afterwards (see `retryBind`). A step-down that fails turns into `defer`. */
+export declare function runElection(deps: ElectionDeps): Promise<ElectionOutcome>;
+/** `GET http://<host>:<port>/version`. Never rejects. */
+export declare function probeVersion(port: number, timeoutMs?: number, host?: string): Promise<VersionProbe>;
+/** Run `bind` until it succeeds, retrying only errors `isRetryable` accepts
+ * (a busy port), at most `attempts` times with `delayMs` between tries. */
+export declare function retryBind<T>(bind: () => Promise<T>, opts: {
+    attempts: number;
+    delayMs: number;
+    isRetryable: (err: unknown) => boolean;
+    sleep?: (ms: number) => Promise<void>;
+}): Promise<T>;
+/** Unix grace period between SIGTERM and SIGKILL. */
+export declare const STEP_DOWN_GRACE_MS = 3000;
+/**
+ * Stop a process: Windows `taskkill /PID n /F`; Unix `SIGTERM`, wait up to
+ * 3 s for it to exit, then `SIGKILL`. Throws when the kill itself fails.
+ */
+export declare function stepDownProcess(pid: number, deps?: {
+    os?: NodeJS.Platform;
+    execFile?: ExecFileLike;
+    kill?: (pid: number, signal: NodeJS.Signals) => void;
+    isAlive?: (pid: number) => boolean;
+    sleep?: (ms: number) => Promise<void>;
+    now?: () => number;
+}): Promise<void>;

package/dist/lifecycle/election.js

@@ -0,0 +1,187 @@
+import { request } from 'node:http';
+import { platform } from 'node:os';
+import { compareSemver } from '../utils/semver.js';
+import { defaultExecFile } from './processes.js';
+/** The pure decision table (a)/(b)/(c) above. */
+export function decideElection(input) {
+    const { probe } = input;
+    if (probe.kind === 'version') {
+        const remote = probe.info.version;
+        if (compareSemver(remote, input.local) < 0) {
+            return {
+                decision: 'take-over',
+                pid: probe.info.pid,
+                reason: `running primary ${remote} is older than ${input.local}`,
+            };
+        }
+        return {
+            decision: 'defer',
+            pid: probe.info.pid,
+            reason: `running primary ${remote} is not older than ${input.local}`,
+        };
+    }
+    if (probe.kind === 'unreachable') {
+        return { decision: 'defer', pid: input.ownerPid, reason: 'port holder does not answer HTTP' };
+    }
+    const { ownerPid, ownerStartedAt, installedCodeMtime } = input;
+    if (ownerPid === null || ownerStartedAt === null || installedCodeMtime === null) {
+        return {
+            decision: 'defer',
+            pid: ownerPid,
+            reason: 'primary has no /version and its start time cannot be compared',
+        };
+    }
+    if (ownerStartedAt < installedCodeMtime) {
+        return {
+            decision: 'take-over',
+            pid: ownerPid,
+            reason: 'primary has no /version and started before the installed code was written',
+        };
+    }
+    return {
+        decision: 'defer',
+        pid: ownerPid,
+        reason: 'primary has no /version but started after the installed code was written',
+    };
+}
+/** Probe, decide and, on take-over, step the owner down. The caller binds
+ * afterwards (see `retryBind`). A step-down that fails turns into `defer`. */
+export async function runElection(deps) {
+    const probe = await deps.probe();
+    let ownerPid = null;
+    let ownerStartedAt = null;
+    let installedCodeMtime = null;
+    if (probe.kind === 'no-endpoint') {
+        ownerPid = deps.findOwnerPid();
+        ownerStartedAt = ownerPid === null ? null : deps.processStartTime(ownerPid);
+        installedCodeMtime = deps.installedCodeMtime();
+    }
+    const outcome = decideElection({
+        local: deps.localVersion,
+        probe,
+        ownerPid,
+        ownerStartedAt,
+        installedCodeMtime,
+    });
+    if (outcome.decision !== 'take-over' || outcome.pid === null)
+        return outcome;
+    try {
+        await deps.stepDown(outcome.pid);
+        return outcome;
+    }
+    catch (err) {
+        return {
+            decision: 'defer',
+            pid: outcome.pid,
+            reason: `step-down of PID ${outcome.pid} failed: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+}
+function isVersionInfo(v) {
+    if (typeof v !== 'object' || v === null)
+        return false;
+    const o = v;
+    return (typeof o.name === 'string' &&
+        typeof o.version === 'string' &&
+        typeof o.pid === 'number' &&
+        Number.isInteger(o.pid) &&
+        o.pid > 0 &&
+        typeof o.startedAt === 'string' &&
+        (o.installedVersion === null || typeof o.installedVersion === 'string'));
+}
+/** `GET http://<host>:<port>/version`. Never rejects. */
+export function probeVersion(port, timeoutMs = 1000, host = '127.0.0.1') {
+    return new Promise((resolve) => {
+        let settled = false;
+        const done = (probe) => {
+            if (settled)
+                return;
+            settled = true;
+            resolve(probe);
+        };
+        const req = request({ host, port, path: '/version', method: 'GET', timeout: timeoutMs }, (res) => {
+            const chunks = [];
+            res.on('data', (c) => chunks.push(c));
+            res.on('end', () => {
+                if (res.statusCode !== 200) {
+                    done({ kind: 'no-endpoint' });
+                    return;
+                }
+                try {
+                    const body = JSON.parse(Buffer.concat(chunks).toString('utf8'));
+                    done(isVersionInfo(body) ? { kind: 'version', info: body } : { kind: 'no-endpoint' });
+                }
+                catch {
+                    done({ kind: 'no-endpoint' });
+                }
+            });
+            res.on('error', () => {
+                done({ kind: 'no-endpoint' });
+            });
+        });
+        req.on('timeout', () => {
+            req.destroy();
+            done({ kind: 'unreachable' });
+        });
+        req.on('error', () => {
+            done({ kind: 'unreachable' });
+        });
+        req.end();
+    });
+}
+const sleepReal = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/** Run `bind` until it succeeds, retrying only errors `isRetryable` accepts
+ * (a busy port), at most `attempts` times with `delayMs` between tries. */
+export async function retryBind(bind, opts) {
+    const sleep = opts.sleep ?? sleepReal;
+    for (let attempt = 1;; attempt++) {
+        try {
+            return await bind();
+        }
+        catch (err) {
+            if (!opts.isRetryable(err) || attempt >= opts.attempts)
+                throw err;
+            await sleep(opts.delayMs);
+        }
+    }
+}
+/** Unix grace period between SIGTERM and SIGKILL. */
+export const STEP_DOWN_GRACE_MS = 3000;
+const STEP_DOWN_POLL_MS = 100;
+function isAliveReal(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        // EPERM: it exists but belongs to someone else.
+        return err.code === 'EPERM';
+    }
+}
+/**
+ * Stop a process: Windows `taskkill /PID n /F`; Unix `SIGTERM`, wait up to
+ * 3 s for it to exit, then `SIGKILL`. Throws when the kill itself fails.
+ */
+export async function stepDownProcess(pid, deps = {}) {
+    const os = deps.os ?? platform();
+    if (os === 'win32') {
+        (deps.execFile ?? defaultExecFile)('taskkill', ['/PID', String(pid), '/F'], {
+            timeout: 5000,
+        });
+        return;
+    }
+    const kill = deps.kill ?? ((p, s) => void process.kill(p, s));
+    const isAlive = deps.isAlive ?? isAliveReal;
+    const sleep = deps.sleep ?? sleepReal;
+    const now = deps.now ?? Date.now;
+    kill(pid, 'SIGTERM');
+    const deadline = now() + STEP_DOWN_GRACE_MS;
+    while (isAlive(pid)) {
+        if (now() >= deadline) {
+            kill(pid, 'SIGKILL');
+            return;
+        }
+        await sleep(STEP_DOWN_POLL_MS);
+    }
+}
+//# sourceMappingURL=election.js.map

package/dist/lifecycle/election.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"election.js","sourceRoot":"","sources":["../../src/lifecycle/election.ts"],"names":[],"mappings":"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"}

package/dist/lifecycle/processes.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Process enumeration for the lifecycle features: `browser-link stop`
+ * (kill every live bridge, not only the port owner), `doctor` (list them)
+ * and the primary election (when did the port owner start?).
+ *
+ * Every OS call goes through an injectable `ExecFileLike`, the same
+ * dependency-injection pattern `auth/silent-debugger.ts` uses, but
+ * synchronous: `runFreePort` is synchronous and consumed as such by the CLI,
+ * the TUI and `self-update`. Nothing in this module throws: a failed or
+ * unparseable listing degrades to "no processes" / `null`.
+ *
+ * Windows uses `Get-CimInstance Win32_Process` (never `wmic`: deprecated and
+ * absent on newer Windows 11 installs). Unix uses BSD-style `ps -axo`,
+ * accepted by both macOS and procps.
+ */
+/** `execFileSync`-shaped primitive: argv array, no shell, stdout as text. */
+export type ExecFileLike = (file: string, args: readonly string[], options: {
+    timeout: number;
+}) => string;
+/** One row of the OS process table. `startedAt` is epoch milliseconds, or
+ * `null` when the OS did not report a usable start time. */
+export interface ProcessEntry {
+    pid: number;
+    ppid: number;
+    startedAt: number | null;
+    command: string;
+}
+export declare const defaultExecFile: ExecFileLike;
+/**
+ * Parse a process start time in any of the forms the OS tools print:
+ * PowerShell 5.1's JSON `/Date(ms)/`, ISO 8601 (PowerShell 7 JSON,
+ * `ToString('o')`), a WMI datetime `yyyyMMddHHmmss.ffffff±UUU` (offset in
+ * minutes) and `ps`'s `lstart` (`Mon Nov  9 02:17:44 2026`, local time).
+ */
+export declare function parseProcessTime(raw: string): number | null;
+/** Parse `Get-CimInstance … | ConvertTo-Json -Compress`. One process comes
+ * out as a bare object, several as an array; both are accepted. */
+export declare function parseWindowsProcessList(stdout: string): ProcessEntry[];
+/** Parse `ps -axo pid=,ppid=,lstart=,command=` (C locale). */
+export declare function parseUnixProcessList(stdout: string): ProcessEntry[];
+/** The whole process table, or `[]` when it cannot be read. */
+export declare function listProcesses(os?: NodeJS.Platform, exec?: ExecFileLike): ProcessEntry[];
+/** Start time of one process (epoch ms), or `null` when unknown. */
+export declare function readProcessStartTime(pid: number, opts?: {
+    os?: NodeJS.Platform;
+    exec?: ExecFileLike;
+}): number | null;
+/**
+ * Whether a command line runs this package, and with which subcommand
+ * (`null` = none, i.e. the MCP server or the TUI). Only the script argument
+ * counts (the first non-flag argument after the runtime, or the package
+ * spec after npm's `npx-cli.js`), so a process that merely mentions a
+ * browser-link path as an option value is never matched.
+ */
+export declare function matchBrowserLinkCommand(command: string): {
+    subcommand: string | null;
+} | null;
+/** Live browser-link bridges in `list`, excluding `selfPid`, its ancestor
+ * chain (the shell or client that launched it) and non-bridge commands. */
+export declare function findBridgeProcesses(list: readonly ProcessEntry[], selfPid: number): ProcessEntry[];
+export declare function listBridgeProcesses(opts?: {
+    os?: NodeJS.Platform;
+    exec?: ExecFileLike;
+    selfPid?: number;
+}): ProcessEntry[];
+/** Short, display-only form: runtime name, `browser-link`, then arguments. */
+export declare function shortCommand(command: string, max?: number): string;