@juxtapose/core 0.2.0 → 0.5.0

package/dist/browser/cdp.js

@@ -0,0 +1,230 @@
+// packages/core/src/browser/cdp.ts
+//
+// The whole protocol client: ids out, replies back, events routed by
+// sessionId. Playwright's CRConnection does the same in ~300 lines plus
+// the parts we never use.
+//
+// Every send has a Node-side timeout. Chrome answers Runtime.evaluate only
+// when the script returns, so a story with a synchronous infinite loop would
+// otherwise hang the worker and the run.
+export const SEND_TIMEOUT_MS = 30_000;
+export class CdpError extends Error {
+    code;
+    constructor(code, method, message) {
+        super(`${method}: ${message}`);
+        this.code = code;
+        this.name = 'CdpError';
+    }
+}
+export class TargetClosedError extends Error {
+    constructor(reason = 'browser closed', method) {
+        super(`jux: browser connection closed (${reason})${method ? ` while waiting for ${method}` : ''}`);
+        this.name = 'TargetClosedError';
+    }
+}
+export class SendTimeoutError extends Error {
+    constructor(method, timeout) {
+        super(`jux: ${method} got no reply from the browser within ${timeout} ms`);
+        this.name = 'SendTimeoutError';
+    }
+}
+export class CdpConnection {
+    transport;
+    lastId = 0;
+    pending = new Map();
+    /** key = `${sessionId ?? ''}\n${method}` */
+    handlers = new Map();
+    closeWaiters = new Set();
+    _closed = false;
+    closeReason;
+    onClose = null;
+    /** Every parsed frame, before routing. The PR 2 supervisor proxies from here. */
+    onRaw = null;
+    /**
+     * A throwing event handler or onRaw must not escape into the stream's data
+     * event (an uncaught exception would kill the daemon) nor skip the rest of
+     * the chunk. Default: one line on stderr.
+     */
+    onError = (error, where) => {
+        const msg = error instanceof Error ? error.message : String(error);
+        process.stderr.write(`jux: ${where} threw: ${msg}\n`);
+    };
+    constructor(transport) {
+        this.transport = transport;
+        transport.onMessage = (m) => this.dispatch(m);
+        transport.onClose = (reason) => this.handleClose(reason);
+    }
+    get closed() {
+        return this._closed;
+    }
+    get pendingCount() {
+        return this.pending.size;
+    }
+    /** Number of distinct (session, method) handler keys; empty sets are pruned. */
+    get handlerKeyCount() {
+        return this.handlers.size;
+    }
+    /** Total registered handlers, summed over every key; a leak test's yardstick. */
+    get handlerCount() {
+        let n = 0;
+        for (const set of this.handlers.values())
+            n += set.size;
+        return n;
+    }
+    /**
+     * Call `listener` once when the connection closes (at once if it already
+     * has); returns the unsubscribe. Pages use it to fail in-flight work fast
+     * instead of waiting out each send's timeout.
+     */
+    onClosed(listener) {
+        if (this._closed) {
+            listener(new TargetClosedError(this.closeReason));
+            return () => { };
+        }
+        this.closeWaiters.add(listener);
+        return () => this.closeWaiters.delete(listener);
+    }
+    allocateId() {
+        return ++this.lastId;
+    }
+    /**
+     * Throws TargetClosedError once the connection is closed, so a proxying
+     * caller (the PR 2 supervisor) learns its client message was not delivered
+     * instead of waiting for a reply that cannot come.
+     */
+    sendRaw(message) {
+        if (this._closed)
+            throw new TargetClosedError(this.closeReason, message.method);
+        this.transport.send(JSON.stringify(message));
+    }
+    send(method, params = {}, sessionId, opts = {}) {
+        if (this._closed)
+            return Promise.reject(new TargetClosedError(this.closeReason, method));
+        const id = this.allocateId();
+        const timeout = opts.timeout ?? SEND_TIMEOUT_MS;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new SendTimeoutError(method, timeout));
+            }, timeout);
+            timer.unref();
+            this.pending.set(id, {
+                method,
+                resolve: resolve,
+                reject,
+                timer,
+            });
+            try {
+                this.sendRaw(sessionId ? { id, method, params, sessionId } : { id, method, params });
+            }
+            catch (e) {
+                clearTimeout(timer);
+                this.pending.delete(id);
+                reject(e instanceof Error ? e : new Error(String(e)));
+            }
+        });
+    }
+    on(method, handler, sessionId) {
+        const key = `${sessionId ?? ''}\n${method}`;
+        let set = this.handlers.get(key);
+        if (!set)
+            this.handlers.set(key, (set = new Set()));
+        set.add(handler);
+        return () => {
+            set.delete(handler);
+            if (set.size === 0 && this.handlers.get(key) === set)
+                this.handlers.delete(key);
+        };
+    }
+    /**
+     * Without a sessionId this listens on the browser session only, where
+     * session-scoped events never arrive; pass the page's sessionId for page
+     * events.
+     */
+    once(method, sessionId, predicate = () => true) {
+        if (this._closed)
+            return Promise.reject(new TargetClosedError(this.closeReason, method));
+        return new Promise((resolve, reject) => {
+            const onClosed = (e) => {
+                off();
+                reject(e);
+            };
+            const off = this.on(method, (params) => {
+                if (!predicate(params))
+                    return;
+                off();
+                this.closeWaiters.delete(onClosed);
+                resolve(params);
+            }, sessionId);
+            this.closeWaiters.add(onClosed);
+        });
+    }
+    close() {
+        this.transport.close();
+    }
+    dispatch(raw) {
+        let m;
+        try {
+            m = JSON.parse(raw);
+        }
+        catch {
+            return; // Chrome never sends non-JSON frames; nothing to do but ignore.
+        }
+        try {
+            this.onRaw?.(m);
+        }
+        catch (e) {
+            this.onError(e, 'onRaw');
+        }
+        if (m.id !== undefined) {
+            const p = this.pending.get(m.id);
+            if (!p)
+                return; // a raw (proxied) id, or a reply after its timeout
+            this.pending.delete(m.id);
+            clearTimeout(p.timer);
+            if (m.error)
+                p.reject(new CdpError(m.error.code, p.method, m.error.message));
+            else
+                p.resolve(m.result);
+            return;
+        }
+        if (m.method) {
+            const set = this.handlers.get(`${m.sessionId ?? ''}\n${m.method}`);
+            if (set)
+                this.runHandlers(set, m);
+            // Session-less listeners see every event (the browser session's Target.* events).
+            if (m.sessionId) {
+                const all = this.handlers.get(`\n${m.method}`);
+                if (all)
+                    this.runHandlers(all, m);
+            }
+        }
+    }
+    runHandlers(set, m) {
+        for (const h of [...set]) {
+            try {
+                h(m.params, m.sessionId);
+            }
+            catch (e) {
+                this.onError(e, 'handler');
+            }
+        }
+    }
+    handleClose(reason) {
+        if (this._closed)
+            return;
+        this._closed = true;
+        this.closeReason = reason;
+        for (const p of this.pending.values()) {
+            clearTimeout(p.timer);
+            p.reject(new TargetClosedError(reason, p.method));
+        }
+        this.pending.clear();
+        const err = new TargetClosedError(reason);
+        for (const w of [...this.closeWaiters])
+            w(err);
+        this.closeWaiters.clear();
+        this.onClose?.(reason);
+    }
+}
+//# sourceMappingURL=cdp.js.map

package/dist/browser/cdp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp.js","sourceRoot":"","sources":["../../src/browser/cdp.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,EAAE;AACF,qEAAqE;AACrE,wEAAwE;AACxE,0BAA0B;AAC1B,EAAE;AACF,2EAA2E;AAC3E,6EAA6E;AAC7E,yCAAyC;AAazC,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC;AAEtC,MAAM,OAAO,QAAS,SAAQ,KAAK;IAEf;IADlB,YACkB,IAAY,EAC5B,MAAc,EACd,OAAe;QAEf,KAAK,CAAC,GAAG,MAAM,KAAK,OAAO,EAAE,CAAC,CAAC;QAJf,SAAI,GAAJ,IAAI,CAAQ;QAK5B,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,MAAM,GAAG,gBAAgB,EAAE,MAAe;QACpD,KAAK,CACH,mCAAmC,MAAM,IAAI,MAAM,CAAC,CAAC,CAAC,sBAAsB,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAC5F,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC,YAAY,MAAc,EAAE,OAAe;QACzC,KAAK,CAAC,QAAQ,MAAM,yCAAyC,OAAO,KAAK,CAAC,CAAC;QAC3E,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAWD,MAAM,OAAO,aAAa;IAqBK;IApBrB,MAAM,GAAG,CAAC,CAAC;IACF,OAAO,GAAG,IAAI,GAAG,EAAmB,CAAC;IACtD,4CAA4C;IAC3B,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC3C,YAAY,GAAG,IAAI,GAAG,EAAsB,CAAC;IACtD,OAAO,GAAG,KAAK,CAAC;IAChB,WAAW,CAAqB;IACxC,OAAO,GAAuC,IAAI,CAAC;IACnD,iFAAiF;IACjF,KAAK,GAAqC,IAAI,CAAC;IAC/C;;;;OAIG;IACH,OAAO,GAAyD,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC/E,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,KAAK,WAAW,GAAG,IAAI,CAAC,CAAC;IACxD,CAAC,CAAC;IAEF,YAA6B,SAAoB;QAApB,cAAS,GAAT,SAAS,CAAW;QAC/C,SAAS,CAAC,SAAS,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC9C,SAAS,CAAC,OAAO,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED,gFAAgF;IAChF,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5B,CAAC;IAED,iFAAiF;IACjF,IAAI,YAAY;QACd,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE;YAAE,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC;QACxD,OAAO,CAAC,CAAC;IACX,CAAC;IAED;;;;OAIG;IACH,QAAQ,CAAC,QAA4B;QACnC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,QAAQ,CAAC,IAAI,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;YAClD,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;QAClB,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAChC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED,UAAU;QACR,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,OAAoD;QAC1D,IAAI,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,iBAAiB,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAChF,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,CACF,MAAc,EACd,SAAiB,EAAE,EACnB,SAAkB,EAClB,OAA6B,EAAE;QAE/B,IAAI,IAAI,CAAC,OAAO;YACd,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,iBAAiB,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;QACzE,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,eAAe,CAAC;QAChD,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACxC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACxB,MAAM,CAAC,IAAI,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;YAChD,CAAC,EAAE,OAAO,CAAC,CAAC;YACZ,KAAK,CAAC,KAAK,EAAE,CAAC;YACd,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE;gBACnB,MAAM;gBACN,OAAO,EAAE,OAA+B;gBACxC,MAAM;gBACN,KAAK;aACN,CAAC,CAAC;YACH,IAAI,CAAC;gBACH,IAAI,CAAC,OAAO,CACV,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CACvE,CAAC;YACJ,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACxB,MAAM,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACxD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,EAAE,CAAC,MAAc,EAAE,OAAgB,EAAE,SAAkB;QACrD,MAAM,GAAG,GAAG,GAAG,SAAS,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC;QAC5C,IAAI,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC,GAAG;YAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC;QACpD,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACjB,OAAO,GAAG,EAAE;YACV,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACpB,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,GAAG;gBAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAClF,CAAC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,IAAI,CACF,MAAc,EACd,SAAkB,EAClB,YAA+B,GAAG,EAAE,CAAC,IAAI;QAEzC,IAAI,IAAI,CAAC,OAAO;YACd,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,iBAAiB,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;QACzE,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACxC,MAAM,QAAQ,GAAG,CAAC,CAAQ,EAAE,EAAE;gBAC5B,GAAG,EAAE,CAAC;gBACN,MAAM,CAAC,CAAC,CAAC,CAAC;YACZ,CAAC,CAAC;YACF,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CACjB,MAAM,EACN,CAAC,MAAM,EAAE,EAAE;gBACT,IAAI,CAAC,SAAS,CAAC,MAAW,CAAC;oBAAE,OAAO;gBACpC,GAAG,EAAE,CAAC;gBACN,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBACnC,OAAO,CAAC,MAAW,CAAC,CAAC;YACvB,CAAC,EACD,SAAS,CACV,CAAC;YACF,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAEO,QAAQ,CAAC,GAAW;QAC1B,IAAI,CAAa,CAAC;QAClB,IAAI,CAAC;YACH,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAe,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,gEAAgE;QAC1E,CAAC;QACD,IAAI,CAAC;YACH,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAC3B,CAAC;QACD,IAAI,CAAC,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACjC,IAAI,CAAC,CAAC;gBAAE,OAAO,CAAC,mDAAmD;YACnE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC1B,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACtB,IAAI,CAAC,CAAC,KAAK;gBAAE,CAAC,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;;gBACxE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YACzB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,SAAS,IAAI,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YACnE,IAAI,GAAG;gBAAE,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YAClC,kFAAkF;YAClF,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;gBAChB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC/C,IAAI,GAAG;oBAAE,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,GAAiB,EAAE,CAAa;QAClD,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;YAC3B,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,MAAe;QACjC,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC;QAC1B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YACtC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC,CAAC,MAAM,CAAC,IAAI,iBAAiB,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,MAAM,GAAG,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC1C,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC;YAAE,CAAC,CAAC,GAAG,CAAC,CAAC;QAC/C,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC;IACzB,CAAC;CACF"}

package/dist/browser/index.d.ts

@@ -0,0 +1,9 @@
+export { Browser, BrowserContext, type ContextOptions } from './browser.js';
+export { CdpPage, PageCrashedError, TimeoutError, type Page } from './page.js';
+export { CdpConnection, CdpError, SendTimeoutError, TargetClosedError, SEND_TIMEOUT_MS, type RawMessage, } from './cdp.js';
+export { PipeTransport, SocketTransport, FramedTransport, NullFramer, type Transport, } from './transport.js';
+export { launchChrome, terminateAll, type LaunchedChrome, type SpawnFn, } from './launch.js';
+export { resolveChrome, juxCacheDir, chromeInstallDir, chromeBinaryPath, msPlaywrightBinaryPath, noBrowserMessage, NO_BROWSER_MESSAGE, INSTALL_MARKER, type ResolvedChrome, type ResolveOptions, type ChromeSource, } from './resolve.js';
+export { installChrome, proxyHint, type InstallOptions, type InstallResult, } from './install.js';
+export { CHROME_VERSION, CHROME_PINS, MS_PLAYWRIGHT_REVISION, chromePlatform, type ChromePlatform, type ChromePin, } from './pins.js';
+export { isCssSelector, assertCssSelector, QUERY_ALL_SOURCE, queryAllExpression, } from './selectors.js';

package/dist/browser/index.js

@@ -0,0 +1,10 @@
+export { Browser, BrowserContext } from './browser.js';
+export { CdpPage, PageCrashedError, TimeoutError } from './page.js';
+export { CdpConnection, CdpError, SendTimeoutError, TargetClosedError, SEND_TIMEOUT_MS, } from './cdp.js';
+export { PipeTransport, SocketTransport, FramedTransport, NullFramer, } from './transport.js';
+export { launchChrome, terminateAll, } from './launch.js';
+export { resolveChrome, juxCacheDir, chromeInstallDir, chromeBinaryPath, msPlaywrightBinaryPath, noBrowserMessage, NO_BROWSER_MESSAGE, INSTALL_MARKER, } from './resolve.js';
+export { installChrome, proxyHint, } from './install.js';
+export { CHROME_VERSION, CHROME_PINS, MS_PLAYWRIGHT_REVISION, chromePlatform, } from './pins.js';
+export { isCssSelector, assertCssSelector, QUERY_ALL_SOURCE, queryAllExpression, } from './selectors.js';
+//# sourceMappingURL=index.js.map

package/dist/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAuB,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAa,MAAM,WAAW,CAAC;AAC/E,OAAO,EACL,aAAa,EACb,QAAQ,EACR,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,GAEhB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,aAAa,EACb,eAAe,EACf,eAAe,EACf,UAAU,GAEX,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,YAAY,EACZ,YAAY,GAGb,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,GAIf,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,aAAa,EACb,SAAS,GAGV,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,cAAc,EACd,WAAW,EACX,sBAAsB,EACtB,cAAc,GAGf,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC"}

package/dist/browser/install.d.ts

@@ -0,0 +1,33 @@
+import { type ChromePin, type ChromePlatform } from './pins.js';
+import { type ChromeSource } from './resolve.js';
+import { installZip } from './zip.js';
+export interface InstallOptions {
+    cacheDir: string;
+    platform?: ChromePlatform;
+    fetch?: typeof fetch;
+    env?: NodeJS.ProcessEnv;
+    onProgress?: (received: number, total: number | null) => void;
+    /** Test seam: a pin for a fixture zip. */
+    pin?: ChromePin;
+    /** Reinstall even when a usable browser is already in the jux or Playwright cache. */
+    force?: boolean;
+    /** Test seams: the flags this Node accepts, and the zip installer. */
+    nodeFlags?: ReadonlySet<string>;
+    installZip?: typeof installZip;
+}
+export interface InstallResult {
+    path: string;
+    version: string;
+    alreadyInstalled: boolean;
+    /** Where an existing browser was found; absent after a fresh install. */
+    source?: ChromeSource;
+}
+export declare function proxyHint(env: NodeJS.ProcessEnv, nodeFlags?: ReadonlySet<string>): string;
+/**
+ * Extra node args for the CLI to re-exec with, or null. Detects the flag
+ * rather than comparing versions: it is whatever this Node accepts.
+ */
+export declare function proxyReexecArgs(env: NodeJS.ProcessEnv, nodeFlags?: ReadonlySet<string>, execArgv?: readonly string[]): string[] | null;
+/** A progress callback for stderr, or undefined when stderr is not a TTY. */
+export declare function stderrProgress(stream?: Pick<NodeJS.WriteStream, 'isTTY' | 'write'>): InstallOptions['onProgress'];
+export declare function installChrome(opts: InstallOptions): Promise<InstallResult>;

package/dist/browser/install.js

@@ -0,0 +1,167 @@
+// packages/core/src/browser/install.ts
+//
+// Download -> sha256 + byte length -> installZip (extract to a temp sibling,
+// marker written inside it, atomic swap) -> verify the result runs. The marker
+// is what resolve.ts trusts, so it goes in before the swap and an interrupted
+// install can never be mistaken for a working one.
+//
+// Proxies: Node's global fetch ignores HTTPS_PROXY unless the process runs
+// with NODE_USE_ENV_PROXY=1 / --use-env-proxy (Node 24+). We cannot set that
+// inside a running process, so the CLI re-executes itself with the flag when
+// a proxy variable is present (`proxyReexecArgs`), and this module names the
+// variable in the error for every other caller (Node 22 included).
+import { execFile } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { stat, rm } from 'node:fs/promises';
+import path from 'node:path';
+import { CHROME_PINS, CHROME_VERSION, chromePlatform, } from './pins.js';
+import { chromeBinaryPath, chromeInstallDir, INSTALL_MARKER, resolveChrome, } from './resolve.js';
+import { installZip } from './zip.js';
+const PROXY_VARS = ['HTTPS_PROXY', 'https_proxy', 'HTTP_PROXY', 'http_proxy'];
+const PROXY_FLAG = '--use-env-proxy';
+export function proxyHint(env, nodeFlags = process.allowedNodeEnvironmentFlags) {
+    const set = PROXY_VARS.find((v) => env[v]);
+    if (!set)
+        return '';
+    const fix = nodeFlags.has(PROXY_FLAG)
+        ? 're-run with NODE_USE_ENV_PROXY=1, or'
+        : `this Node lacks ${PROXY_FLAG}, so`;
+    return ` ${set} is set but Node's fetch does not use it by default: ${fix} download the zip yourself and set JUX_CHROME.`;
+}
+/**
+ * Extra node args for the CLI to re-exec with, or null. Detects the flag
+ * rather than comparing versions: it is whatever this Node accepts.
+ */
+export function proxyReexecArgs(env, nodeFlags = process.allowedNodeEnvironmentFlags, execArgv = process.execArgv) {
+    if (!PROXY_VARS.some((v) => env[v]))
+        return null;
+    if (env.NODE_USE_ENV_PROXY === '1' || execArgv.includes(PROXY_FLAG))
+        return null;
+    return nodeFlags.has(PROXY_FLAG) ? [PROXY_FLAG] : null;
+}
+/** A progress callback for stderr, or undefined when stderr is not a TTY. */
+export function stderrProgress(stream = process.stderr) {
+    if (!stream.isTTY)
+        return undefined;
+    return (received, total) => {
+        const mb = (received / 1048576).toFixed(1);
+        const of = total ? ` / ${(total / 1048576).toFixed(1)}` : '';
+        stream.write(`\rjux: downloading chrome-headless-shell ${mb}${of} MB`);
+        if (total !== null && received >= total)
+            stream.write('\n');
+    };
+}
+// resolveChrome speaks Node's platform/arch, not Chrome for Testing's.
+const NODE_TARGET = {
+    linux64: { platform: 'linux', arch: 'x64' },
+    'mac-arm64': { platform: 'darwin', arch: 'arm64' },
+    'mac-x64': { platform: 'darwin', arch: 'x64' },
+    win64: { platform: 'win32', arch: 'x64' },
+};
+export async function installChrome(opts) {
+    const platform = opts.platform ?? chromePlatform();
+    const pin = opts.pin ?? CHROME_PINS[platform];
+    const env = opts.env ?? process.env;
+    const installDir = chromeInstallDir(opts.cacheDir, CHROME_VERSION);
+    const binary = chromeBinaryPath(installDir, platform);
+    if (!opts.force) {
+        // JUX_CHROME is not "installed": it may point anywhere, so ignore it here.
+        const { JUX_CHROME: _ignored, ...rest } = env;
+        const found = resolveChrome({
+            ...NODE_TARGET[platform],
+            env: { ...rest, JUX_CACHE_DIR: opts.cacheDir },
+        });
+        if (found) {
+            return {
+                path: found.path,
+                version: CHROME_VERSION,
+                alreadyInstalled: true,
+                source: found.source,
+            };
+        }
+    }
+    const nodeFlags = opts.nodeFlags ?? process.allowedNodeEnvironmentFlags;
+    const nextStep = `Retry with \`npx -p @juxtapose/cli jux browser install\`, or download ${pin.url} yourself and set JUX_CHROME to the chrome-headless-shell binary inside it.`;
+    const doFetch = opts.fetch ?? fetch;
+    let res;
+    try {
+        res = await doFetch(pin.url);
+    }
+    catch (err) {
+        throw new Error(`jux: download failed for ${pin.url}: ${err.message}.${proxyHint(env, nodeFlags)} ${nextStep}`, { cause: err });
+    }
+    if (!res.ok || !res.body)
+        throw new Error(`jux: download failed: HTTP ${res.status} for ${pin.url}. ${nextStep}`);
+    const total = Number(res.headers.get('content-length')) || null;
+    // Streamed into the hash and a chunk list: ~120 MB held once, not twice.
+    const chunks = [];
+    let received = 0;
+    let overLength = false;
+    const hash = createHash('sha256');
+    try {
+        for await (const chunk of res.body) {
+            const b = Buffer.from(chunk);
+            received += b.length;
+            // A server streaming past the pinned size is wrong already; stop buffering.
+            if (received > pin.bytes) {
+                overLength = true;
+                break;
+            }
+            chunks.push(b);
+            hash.update(b);
+            opts.onProgress?.(received, total);
+        }
+    }
+    catch (err) {
+        throw new Error(`jux: download interrupted for ${pin.url}: ${err.message}.${proxyHint(env, nodeFlags)} ${nextStep}`, { cause: err });
+    }
+    const digest = hash.digest('hex');
+    if (!overLength && digest !== pin.sha256) {
+        throw new Error(`jux: sha256 mismatch for ${pin.url}: expected ${pin.sha256}, got ${digest}. ` +
+            `The download is corrupt or the published file changed; nothing was installed. ${nextStep}`);
+    }
+    if (overLength || received !== pin.bytes) {
+        throw new Error(`jux: length mismatch for ${pin.url}: expected ${pin.bytes} bytes, got ${overLength ? `more than ${pin.bytes}` : received} bytes. ` +
+            `The download is truncated or the published file changed; nothing was installed. ${nextStep}`);
+    }
+    await (opts.installZip ?? installZip)(Buffer.concat(chunks), installDir, {
+        marker: INSTALL_MARKER,
+    });
+    await verifyInstall(installDir, binary);
+    return { path: binary, version: CHROME_VERSION, alreadyInstalled: false };
+}
+/**
+ * installZip resolves when a concurrent installer "won" the swap, which can
+ * also mask a permission error. Trust only what is on disk and runs.
+ */
+async function verifyInstall(installDir, binary) {
+    const fail = async (why) => {
+        // Also removes a concurrent installer's dir when that one is the broken one: it is unusable either way.
+        await rm(installDir, { recursive: true, force: true });
+        throw new Error(`jux: install of chrome-headless-shell ${CHROME_VERSION} into ${installDir} is not usable: ${why}. ` +
+            'Check permissions on the cache directory (JUX_CACHE_DIR) and retry.');
+    };
+    if (!(await exists(path.join(installDir, INSTALL_MARKER))))
+        return fail(`${INSTALL_MARKER} marker is missing`);
+    if (!(await exists(binary)))
+        return fail(`${binary} is missing`);
+    let out;
+    try {
+        out = await new Promise((resolve, reject) => execFile(binary, ['--version'], { timeout: 15_000 }, (err, stdout) => err ? reject(err) : resolve(stdout)));
+    }
+    catch (err) {
+        return fail(`\`${binary} --version\` failed: ${err.message}`);
+    }
+    if (!out.includes(CHROME_VERSION))
+        return fail(`\`--version\` printed ${JSON.stringify(out.trim())}, expected ${CHROME_VERSION}`);
+}
+async function exists(p) {
+    try {
+        await stat(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=install.js.map

package/dist/browser/install.js.map

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

package/dist/browser/launch.d.ts

@@ -0,0 +1,37 @@
+import { spawn as nodeSpawn } from 'node:child_process';
+import { CdpConnection } from './cdp.js';
+export type SpawnFn = typeof nodeSpawn;
+export interface LaunchedChrome {
+    connection: CdpConnection;
+    pid: number;
+    userDataDir: string;
+    close(): Promise<void>;
+}
+/** Kill every live Chrome and remove its profile, synchronously. Exported for tests. */
+export declare function terminateAll(): void;
+/**
+ * Remove profiles left by a jux that was SIGKILLed or lost power: named
+ * `jux-chrome-<pid>-…`, owner pid dead, untouched for 10 minutes. Anything
+ * else in the directory is not ours to touch.
+ */
+export declare function sweepStaleProfiles(dir: string): Promise<void>;
+/**
+ * The per-user directory every profile lives in. A shared tmpdir lets another
+ * user plant `jux-chrome-<dead pid>-x` (or swap one under us) and have our
+ * sweep delete through it, so profiles and the sweep stay inside a directory
+ * only we can write. Verified with lstat, never chmod/chown'd: a dir that is
+ * not ours is refused, not repaired. Windows has no uid; its tmpdir is already
+ * per-user.
+ */
+export declare function privateProfileRoot(opts?: {
+    base?: string;
+    uid?: number | undefined;
+}): Promise<string>;
+export declare function launchChrome(opts: {
+    executablePath: string;
+    args?: string[];
+    headless?: boolean;
+    spawn?: SpawnFn;
+    /** Test seam: how long to wait for Browser.getVersion before giving up. */
+    handshakeTimeoutMs?: number;
+}): Promise<LaunchedChrome>;