@swf2es/desktop 0.1.14 → 0.1.16

package/dist/main/netlog.js

@@ -0,0 +1,90 @@
+// --log-network's lines: what a SWF asked of the network, as the terminal
+// shows it. The page has no network of its own, so its DevTools' Network
+// tab shows none of this; the main process, which sends the requests, says
+// them here instead. Apart from Electron, so that node tests it.
+/** A size as a person reads it: bytes, then kB and MB to one decimal. */
+function size(bytes) {
+    if (bytes < 1024) {
+        return `${bytes} B`;
+    }
+    return bytes < 1024 * 1024
+        ? `${(bytes / 1024).toFixed(1)} kB`
+        : `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+/** A URL short enough for a line, and with nothing a terminal would act on. */
+function shown(url) {
+    // biome-ignore lint/suspicious/noControlCharactersInRegex: control characters are what is taken out
+    return url.slice(0, 2048).replace(/[\u0000-\u001f\u007f]/g, "?");
+}
+/** A request answered: its method, URL, status, body's size and how long it took. */
+export function requestLine(method, url, status, bytes, ms) {
+    const body = bytes === null ? "no body" : size(bytes);
+    return `swf2es: net ${method} ${shown(url)} ${status} ${body} ${Math.round(ms)} ms`;
+}
+/** A request that got no answer: refused, failed or aborted, and why. */
+export function failureLine(method, url, why, ms) {
+    return `swf2es: net ${method} ${shown(url)} ${why} ${Math.round(ms)} ms`;
+}
+/** A socket's connection asked for, opened, refused or closed. */
+export function socketLine(id, what) {
+    return `swf2es: socket #${id} ${shown(what)}`;
+}
+/** How much of a message --log-sockets shows. */
+const PREVIEW = 512;
+/** The start of `bytes`: as text where it is text, bytes that are no printable ASCII as dots, else in hex. */
+function preview(bytes) {
+    const shownBytes = bytes.subarray(0, PREVIEW);
+    let printable = 0;
+    for (let i = 0; i < shownBytes.length; i++) {
+        const b = shownBytes[i];
+        if ((b >= 32 && b < 127) || b === 9 || b === 10 || b === 13 || b === 0) {
+            printable++;
+        }
+    }
+    let text = "";
+    // Mostly text, as a line protocol's messages are, a NUL ending each: shown as text.
+    if (printable * 10 >= shownBytes.length * 9) {
+        for (let i = 0; i < shownBytes.length; i++) {
+            const b = shownBytes[i];
+            text += b >= 32 && b < 127 ? String.fromCharCode(b) : ".";
+        }
+    }
+    else {
+        for (let i = 0; i < shownBytes.length; i++) {
+            text += (i > 0 ? " " : "") + shownBytes[i].toString(16).padStart(2, "0");
+        }
+    }
+    return text + (bytes.length > PREVIEW ? "…" : "");
+}
+/**
+ * What a socket sent (">") or received ("<"): its size and its start, as
+ * text where it is text, bytes that are no printable ASCII as dots, else
+ * in hex. A message past PREVIEW bytes ends in an ellipsis.
+ */
+export function socketDataLine(id, sent, bytes) {
+    return `swf2es: socket #${id} ${sent ? ">" : "<"} ${bytes.length} B  ${preview(bytes)}`;
+}
+/** A WebSocket's connection asked for, opened, refused, failed or closed. */
+export function webSocketLine(id, what) {
+    return `swf2es: websocket #${id} ${shown(what)}`;
+}
+/**
+ * What a WebSocket sent (">") or received ("<"): a text message's size
+ * in UTF-8 and its first PREVIEW characters, control characters as dots;
+ * a binary one's as a socket's.
+ */
+export function webSocketDataLine(id, sent, data) {
+    const head = `swf2es: websocket #${id} ${sent ? ">" : "<"}`;
+    if (typeof data !== "string") {
+        return `${head} binary ${data.length} B  ${preview(data)}`;
+    }
+    // By code point, so that no pair is cut in two.
+    const characters = Array.from(data.slice(0, PREVIEW * 2)).slice(0, PREVIEW);
+    const text = characters
+        .join("")
+        // biome-ignore lint/suspicious/noControlCharactersInRegex: control characters are what is taken out
+        .replace(/[\u0000-\u001f\u007f-\u009f\u2028\u2029]/g, ".");
+    const more = text.length < data.length ? "…" : "";
+    return `${head} text ${Buffer.byteLength(data)} B  ${text}${more}`;
+}
+//# sourceMappingURL=netlog.js.map

package/dist/main/netlog.js.map

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

package/dist/main/sockets.d.ts

@@ -2,9 +2,11 @@ import { type IpcMainEvent } from "electron";
 /**
  * Carry socket messages from pages that `trusted` accepts, each connection
  * made only as `permit` allows it, to the address it gives where it gives
- * one; null refuses it.
+ * one; null refuses it. `log`, where given, is told each connection asked
+ * for, opened, refused, failed and closed (--log-network), and with
+ * `data` what each sends and receives too (--log-sockets).
  */
 export declare function bridgeSockets(trusted: (event: IpcMainEvent) => boolean, permit: (host: string, port: number) => Promise<{
     address?: string;
-} | null>): void;
+} | null>, log?: ((line: string) => void) | null, data?: boolean): void;
 //# sourceMappingURL=sockets.d.ts.map

package/dist/main/sockets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sockets.d.ts","sourceRoot":"","sources":["../../src/main/sockets.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,YAAY,EAA6B,MAAM,UAAU,CAAC;AAGxE;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,EACzC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,GAC3E,IAAI,CAkEN"}
+{"version":3,"file":"sockets.d.ts","sourceRoot":"","sources":["../../src/main/sockets.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,YAAY,EAA6B,MAAM,UAAU,CAAC;AAIxE;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,EACzC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,EAC5E,GAAG,GAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAW,EAC3C,IAAI,UAAQ,GACX,IAAI,CA6EN"}

package/dist/main/sockets.js

@@ -3,12 +3,15 @@
 // connections (connections.ts) close as it navigates, reloads or goes.
 import { ipcMain } from "electron";
 import { Connections, validEndpoint } from "./connections.js";
+import { socketDataLine, socketLine } from "./netlog.js";
 /**
  * Carry socket messages from pages that `trusted` accepts, each connection
  * made only as `permit` allows it, to the address it gives where it gives
- * one; null refuses it.
+ * one; null refuses it. `log`, where given, is told each connection asked
+ * for, opened, refused, failed and closed (--log-network), and with
+ * `data` what each sends and receives too (--log-sockets).
  */
-export function bridgeSockets(trusted, permit) {
+export function bridgeSockets(trusted, permit, log = null, data = false) {
     const pages = new Map();
     const connectionsOf = (contents) => {
         const known = pages.get(contents);
@@ -16,6 +19,12 @@ export function bridgeSockets(trusted, permit) {
             return known;
         }
         const connections = new Connections((id, event) => {
+            if (log && event.type !== "data") {
+                log(socketLine(id, event.type === "error" ? `error: ${event.message}` : event.type));
+            }
+            else if (log && data && event.type === "data") {
+                log(socketDataLine(id, false, event.bytes));
+            }
             if (!contents.isDestroyed()) {
                 contents.send("socket:event", id, event);
             }
@@ -49,6 +58,7 @@ export function bridgeSockets(trusted, permit) {
             if (connections.generation !== generation) {
                 return;
             }
+            log?.(socketLine(id, `${allowed ? "connecting to" : "refused"} ${host}:${port}`));
             if (allowed) {
                 connections.connect(id, host, port, allowed.address);
             }
@@ -59,6 +69,9 @@ export function bridgeSockets(trusted, permit) {
     });
     ipcMain.on("socket:send", (event, id, bytes) => {
         if (trusted(event) && typeof id === "number" && bytes instanceof Uint8Array) {
+            if (log && data) {
+                log(socketDataLine(id, true, bytes));
+            }
             pages.get(event.sender)?.send(id, bytes);
         }
     });

package/dist/main/sockets.js.map

@@ -1 +1 @@
-{"version":3,"file":"sockets.js","sourceRoot":"","sources":["../../src/main/sockets.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sockets.js","sourceRoot":"","sources":["../../src/main/sockets.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,wEAAwE;AACxE,uEAAuE;AACvE,OAAO,EAAqB,OAAO,EAAoB,MAAM,UAAU,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAyC,EACzC,MAA4E,EAC5E,GAAG,GAAoC,IAAI,EAC3C,IAAI,GAAG,KAAK;IAEZ,MAAM,KAAK,GAAG,IAAI,GAAG,EAA4B,CAAC;IAElD,MAAM,aAAa,GAAG,CAAC,QAAqB,EAAe,EAAE;QAC3D,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAClC,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE;YAChD,IAAI,GAAG,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACjC,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YACvF,CAAC;iBAAM,IAAI,GAAG,IAAI,IAAI,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAChD,GAAG,CAAC,cAAc,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;YAC9C,CAAC;YAED,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;gBAC5B,QAAQ,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QACjC,QAAQ,CAAC,EAAE,CAAC,sBAAsB,EAAE,CAAC,OAAO,EAAE,EAAE;YAC9C,IAAI,OAAO,CAAC,WAAW,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;gBACnD,WAAW,CAAC,QAAQ,EAAE,CAAC;YACzB,CAAC;QACH,CAAC,CAAC,CAAC;QACH,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;YAC9B,WAAW,CAAC,QAAQ,EAAE,CAAC;YACvB,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;QACH,OAAO,WAAW,CAAC;IACrB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,EAAW,EAAE,IAAa,EAAE,IAAa,EAAE,EAAE;QAChF,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;YAC9C,OAAO;QACT,CAAC;QAED,MAAM,WAAW,GAAG,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;YAC/B,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACvB,OAAO;QACT,CAAC;QAED,MAAM,UAAU,GAAG,WAAW,CAAC,UAAU,CAAC;QAC1C,KAAK,MAAM,CAAC,IAAI,EAAE,IAAc,CAAC;aAC9B,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;aACjB,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;YAChB,8DAA8D;YAC9D,IAAI,WAAW,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;gBAC1C,OAAO;YACT,CAAC;YAED,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;YAClF,IAAI,OAAO,EAAE,CAAC;gBACZ,WAAW,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;YACvD,CAAC;iBAAM,CAAC;gBACN,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACzB,CAAC;QACH,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,EAAW,EAAE,KAAc,EAAE,EAAE;QAC/D,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;YAC5E,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;gBAChB,GAAG,CAAC,cAAc,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;YACvC,CAAC;YAED,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,cAAc,EAAE,CAAC,KAAK,EAAE,EAAW,EAAE,EAAE;QAChD,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;YAC7C,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;QACrC,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/main/websocket-connections.d.ts

@@ -0,0 +1,62 @@
+import type { WebSocketEvent } from "../shared/api.js";
+/**
+ * The bytes a connection may hold unsent, as a socket's (connections.ts)
+ * but for whole messages, which are larger than a socket's writes: a peer
+ * that stops reading would otherwise have the main process buffer all an
+ * application sends. Past this the connection fails.
+ */
+export declare const MAX_BUFFERED: number;
+/** Opens a client; throws as the WebSocket constructor does. */
+export type Opener = (url: string, protocols: string[]) => unknown;
+/** Whether this Node has the WHATWG WebSocket (22 and later, Electron's among them). */
+export declare function hasWebSocket(): boolean;
+/**
+ * What sends a client's requests with no certificate verified, for
+ * --ignore-certificate-errors; null where this Node gives no way to make
+ * one. The WHATWG WebSocket has no option for it: Node's is undici's,
+ * which takes a dispatcher, and Node exports no class of one, so it is
+ * made from the class of the dispatcher undici keeps for everything else.
+ */
+export declare function unverifiedDispatcher(): unknown;
+/**
+ * An opener that leaves a wss: server's certificate unverified where
+ * `unverified` says so of its host, through `dispatcher`
+ * (unverifiedDispatcher's); any other connection is the global's as it is.
+ */
+export declare function webSocketOpener(unverified: (host: string) => boolean, dispatcher: unknown): Opener;
+/** Whether the page asked for a ws: or wss: URL with a host, of a length a server takes. */
+export declare function validWebSocketUrl(url: unknown): url is string;
+export declare function validProtocols(protocols: unknown): protocols is string[];
+export declare class WebSocketConnections {
+    private readonly clients;
+    private readonly tell;
+    private readonly open;
+    /** `tell` carries each connection's events to its page; `open` makes a client, the global's by default. */
+    constructor(tell: (id: number, event: WebSocketEvent) => void, open?: Opener);
+    get size(): number;
+    /** Counts closeAll's: a connection decided on before one belongs to a page that is gone. */
+    generation: number;
+    /**
+     * Connect `id` to `url`, offering `protocols`, each checked, as the page
+     * asks; a refusal, a URL or protocols the client throws for among them,
+     * is an error, then a close.
+     */
+    connect(id: number, url: unknown, protocols: unknown): void;
+    /**
+     * Send a text message for a string, a binary one for bytes, once the
+     * connection is open, unless the peer has left more than MAX_BUFFERED
+     * unread: then the connection fails.
+     */
+    send(id: number, data: string | Uint8Array): void;
+    /** Refuse `id`, as a server that took no connection: an error, then a close with no frame. */
+    refuse(id: number): void;
+    /** A close frame with `code` where the client sends it, 1000 or 3000 to 4999, else with none. */
+    close(id: number, code?: unknown): void;
+    /**
+     * Close every connection without a word: the page that held them is
+     * gone, and the next numbers its own from 1.
+     */
+    closeAll(): void;
+    private silence;
+}
+//# sourceMappingURL=websocket-connections.d.ts.map

package/dist/main/websocket-connections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-connections.d.ts","sourceRoot":"","sources":["../../src/main/websocket-connections.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAUvD;;;;;GAKG;AACH,eAAO,MAAM,YAAY,QAAmB,CAAC;AAwB7C,gEAAgE;AAChE,MAAM,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC;AAKnE,wFAAwF;AACxF,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAoB9C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,EACrC,UAAU,EAAE,OAAO,GAClB,MAAM,CASR;AAED,4FAA4F;AAC5F,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,MAAM,CAW7D;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,OAAO,GAAG,SAAS,IAAI,MAAM,EAAE,CAMxE;AAMD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA8C;IACnE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAE9B,2GAA2G;IAC3G,YACE,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,KAAK,IAAI,EACjD,IAAI,GAAE,MAAsF,EAI7F;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,4FAA4F;IAC5F,UAAU,SAAK;IAEf;;;;OAIG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI,CAqC1D;IAED;;;;OAIG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAkBhD;IAED,8FAA8F;IAC9F,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAGvB;IAED,iGAAiG;IACjG,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAWtC;IAED;;;OAGG;IACH,QAAQ,IAAI,IAAI,CAOf;IAED,OAAO,CAAC,OAAO;CAWhB"}

package/dist/main/websocket-connections.js

@@ -0,0 +1,198 @@
+/** As many as a page may hold open at once; past it a connection is refused. */
+const MAX_OPEN = 64;
+/** The longest URL, and the most and longest subprotocols, a page may ask for. */
+const MAX_URL = 8192;
+const MAX_PROTOCOLS = 32;
+const MAX_PROTOCOL = 256;
+/**
+ * The bytes a connection may hold unsent, as a socket's (connections.ts)
+ * but for whole messages, which are larger than a socket's writes: a peer
+ * that stops reading would otherwise have the main process buffer all an
+ * application sends. Past this the connection fails.
+ */
+export const MAX_BUFFERED = 16 * 1024 * 1024;
+const OPEN = 1;
+const globalClient = () => globalThis.WebSocket;
+/** Whether this Node has the WHATWG WebSocket (22 and later, Electron's among them). */
+export function hasWebSocket() {
+    return typeof globalClient() === "function";
+}
+/**
+ * What sends a client's requests with no certificate verified, for
+ * --ignore-certificate-errors; null where this Node gives no way to make
+ * one. The WHATWG WebSocket has no option for it: Node's is undici's,
+ * which takes a dispatcher, and Node exports no class of one, so it is
+ * made from the class of the dispatcher undici keeps for everything else.
+ */
+export function unverifiedDispatcher() {
+    // Naming the global loads undici, which then sets its dispatcher.
+    if (!hasWebSocket()) {
+        return null;
+    }
+    const shared = globalThis[Symbol.for("undici.globalDispatcher.1")];
+    const Agent = shared?.constructor;
+    if (typeof Agent !== "function" || Agent.name !== "Agent") {
+        return null;
+    }
+    try {
+        const agent = new Agent({
+            connect: { rejectUnauthorized: false },
+        });
+        return typeof agent.dispatch === "function" ? agent : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * An opener that leaves a wss: server's certificate unverified where
+ * `unverified` says so of its host, through `dispatcher`
+ * (unverifiedDispatcher's); any other connection is the global's as it is.
+ */
+export function webSocketOpener(unverified, dispatcher) {
+    return (url, protocols) => {
+        const Client = globalClient();
+        const parsed = new URL(url);
+        const host = parsed.hostname.replace(/^\[(.*)\]$/, "$1").toLowerCase();
+        return dispatcher && parsed.protocol === "wss:" && unverified(host)
+            ? new Client(url, { protocols, dispatcher })
+            : new Client(url, protocols);
+    };
+}
+/** Whether the page asked for a ws: or wss: URL with a host, of a length a server takes. */
+export function validWebSocketUrl(url) {
+    if (typeof url !== "string" || url.length > MAX_URL) {
+        return false;
+    }
+    try {
+        const parsed = new URL(url);
+        return (parsed.protocol === "ws:" || parsed.protocol === "wss:") && parsed.hostname !== "";
+    }
+    catch {
+        return false;
+    }
+}
+export function validProtocols(protocols) {
+    return (Array.isArray(protocols) &&
+        protocols.length <= MAX_PROTOCOLS &&
+        protocols.every((p) => typeof p === "string" && p.length <= MAX_PROTOCOL));
+}
+/** The close codes the WHATWG WebSocket sends; any other throws. */
+const sendable = (code) => code === 1000 || (typeof code === "number" && code >= 3000 && code <= 4999);
+export class WebSocketConnections {
+    clients = new Map();
+    tell;
+    open;
+    /** `tell` carries each connection's events to its page; `open` makes a client, the global's by default. */
+    constructor(tell, open = (url, protocols) => new (globalClient())(url, protocols)) {
+        this.tell = tell;
+        this.open = open;
+    }
+    get size() {
+        return this.clients.size;
+    }
+    /** Counts closeAll's: a connection decided on before one belongs to a page that is gone. */
+    generation = 0;
+    /**
+     * Connect `id` to `url`, offering `protocols`, each checked, as the page
+     * asks; a refusal, a URL or protocols the client throws for among them,
+     * is an error, then a close.
+     */
+    connect(id, url, protocols) {
+        if (!validWebSocketUrl(url) ||
+            !validProtocols(protocols) ||
+            this.clients.has(id) ||
+            this.clients.size >= MAX_OPEN ||
+            !hasWebSocket()) {
+            this.refuse(id);
+            return;
+        }
+        let client;
+        try {
+            client = this.open(url, protocols);
+        }
+        catch {
+            this.refuse(id);
+            return;
+        }
+        client.binaryType = "arraybuffer";
+        this.clients.set(id, client);
+        client.onopen = () => this.tell(id, { type: "open", protocol: client.protocol });
+        client.onmessage = ({ data }) => this.tell(id, {
+            type: "message",
+            data: typeof data === "string" ? data : new Uint8Array(data),
+        });
+        client.onerror = () => this.tell(id, { type: "error" });
+        client.onclose = ({ code }) => {
+            // Only the client under this id: a page that reused it has another by now.
+            if (this.clients.get(id) === client) {
+                this.clients.delete(id);
+            }
+            this.tell(id, { type: "close", code });
+        };
+    }
+    /**
+     * Send a text message for a string, a binary one for bytes, once the
+     * connection is open, unless the peer has left more than MAX_BUFFERED
+     * unread: then the connection fails.
+     */
+    send(id, data) {
+        const client = this.clients.get(id);
+        if (!client || client.readyState !== OPEN) {
+            return;
+        }
+        const size = typeof data === "string" ? Buffer.byteLength(data) : data.length;
+        if (client.bufferedAmount + size > MAX_BUFFERED) {
+            // The client has no way to drop a connection: its close waits behind
+            // what is buffered, so the page is told now and the client left to it.
+            this.silence(client);
+            this.clients.delete(id);
+            this.tell(id, { type: "error" });
+            this.tell(id, { type: "close", code: 1006 });
+            return;
+        }
+        client.send(data);
+    }
+    /** Refuse `id`, as a server that took no connection: an error, then a close with no frame. */
+    refuse(id) {
+        this.tell(id, { type: "error" });
+        this.tell(id, { type: "close", code: 1006 });
+    }
+    /** A close frame with `code` where the client sends it, 1000 or 3000 to 4999, else with none. */
+    close(id, code) {
+        const client = this.clients.get(id);
+        if (!client) {
+            return;
+        }
+        try {
+            client.close(sendable(code) ? code : undefined);
+        }
+        catch {
+            // Already closing.
+        }
+    }
+    /**
+     * Close every connection without a word: the page that held them is
+     * gone, and the next numbers its own from 1.
+     */
+    closeAll() {
+        for (const client of this.clients.values()) {
+            this.silence(client);
+        }
+        this.clients.clear();
+        this.generation++;
+    }
+    silence(client) {
+        client.onopen = null;
+        client.onmessage = null;
+        client.onerror = null;
+        client.onclose = null;
+        try {
+            client.close();
+        }
+        catch {
+            // Already closing.
+        }
+    }
+}
+//# sourceMappingURL=websocket-connections.js.map

package/dist/main/websocket-connections.js.map

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

package/dist/main/websockets.d.ts

@@ -0,0 +1,11 @@
+import { type IpcMainEvent } from "electron";
+import { type Opener } from "./websocket-connections.ts";
+/**
+ * Carry WebSocket messages from pages that `trusted` accepts, each
+ * connection made only where `permit` allows its URL, with `open` if
+ * given. `log`, where given, is told each connection asked for, opened,
+ * refused, failed and closed (--log-network), and with `data` what each
+ * sends and receives too (--log-sockets).
+ */
+export declare function bridgeWebSockets(trusted: (event: IpcMainEvent) => boolean, permit: (url: string) => boolean, open: Opener | undefined, log?: ((line: string) => void) | null, data?: boolean): void;
+//# sourceMappingURL=websockets.d.ts.map

package/dist/main/websockets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websockets.d.ts","sourceRoot":"","sources":["../../src/main/websockets.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,YAAY,EAA6B,MAAM,UAAU,CAAC;AAExE,OAAO,EACL,KAAK,MAAM,EAIZ,MAAM,4BAA4B,CAAC;AAEpC;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,EACzC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,EAChC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,GAAG,GAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAW,EAC3C,IAAI,UAAQ,GACX,IAAI,CAwFN"}

package/dist/main/websockets.js

@@ -0,0 +1,93 @@
+// air.net.WebSocket's connections, made here for the page, which has no
+// network of its own, and carried over IPC as flash.net.Socket's are
+// (sockets.ts). Each page's connections (websocket-connections.ts) close
+// as it navigates, reloads or goes.
+import { ipcMain } from "electron";
+import { webSocketDataLine, webSocketLine } from "./netlog.js";
+import { validProtocols, validWebSocketUrl, WebSocketConnections, } from "./websocket-connections.js";
+/**
+ * Carry WebSocket messages from pages that `trusted` accepts, each
+ * connection made only where `permit` allows its URL, with `open` if
+ * given. `log`, where given, is told each connection asked for, opened,
+ * refused, failed and closed (--log-network), and with `data` what each
+ * sends and receives too (--log-sockets).
+ */
+export function bridgeWebSockets(trusted, permit, open, log = null, data = false) {
+    const pages = new Map();
+    const connectionsOf = (contents) => {
+        const known = pages.get(contents);
+        if (known) {
+            return known;
+        }
+        const connections = new WebSocketConnections((id, event) => {
+            if (log) {
+                switch (event.type) {
+                    case "open":
+                        log(webSocketLine(id, event.protocol === "" ? "open" : `open ${event.protocol}`));
+                        break;
+                    case "message":
+                        if (data) {
+                            log(webSocketDataLine(id, false, event.data));
+                        }
+                        break;
+                    case "close":
+                        log(webSocketLine(id, `close ${event.code}`));
+                        break;
+                    case "error":
+                        log(webSocketLine(id, "error"));
+                        break;
+                }
+            }
+            if (!contents.isDestroyed()) {
+                contents.send("websocket:event", id, event);
+            }
+        }, open);
+        pages.set(contents, connections);
+        contents.on("did-start-navigation", (details) => {
+            if (details.isMainFrame && !details.isSameDocument) {
+                connections.closeAll();
+            }
+        });
+        contents.once("destroyed", () => {
+            connections.closeAll();
+            pages.delete(contents);
+        });
+        return connections;
+    };
+    ipcMain.on("websocket:connect", (event, id, url, protocols) => {
+        if (!trusted(event) || typeof id !== "number") {
+            return;
+        }
+        const connections = connectionsOf(event.sender);
+        if (!validWebSocketUrl(url) || !validProtocols(protocols)) {
+            connections.refuse(id);
+            return;
+        }
+        // As the client will read it: what is said of it has nothing a terminal would act on.
+        const href = new URL(url).href;
+        const allowed = permit(href);
+        log?.(webSocketLine(id, `${allowed ? "connecting to" : "refused"} ${href}`));
+        if (allowed) {
+            connections.connect(id, href, protocols);
+        }
+        else {
+            connections.refuse(id);
+        }
+    });
+    ipcMain.on("websocket:send", (event, id, message) => {
+        if (trusted(event) &&
+            typeof id === "number" &&
+            (typeof message === "string" || message instanceof Uint8Array)) {
+            if (log && data) {
+                log(webSocketDataLine(id, true, message));
+            }
+            pages.get(event.sender)?.send(id, message);
+        }
+    });
+    ipcMain.on("websocket:close", (event, id, code) => {
+        if (trusted(event) && typeof id === "number") {
+            pages.get(event.sender)?.close(id, code);
+        }
+    });
+}
+//# sourceMappingURL=websockets.js.map

package/dist/main/websockets.js.map

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

package/dist/preload/preload.cjs

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const { contextBridge, ipcRenderer, webUtils } = require("electron");
 let nextSocket = 1;
+let nextWebSocket = 1;
 let nextRequest = 1;
 /** The requests waiting for their response, by number. */
 const responses = new Map();
@@ -14,6 +15,12 @@ const api = {
         write: (id, bytes) => ipcRenderer.invoke("files:write", id, bytes),
         release: (id) => ipcRenderer.send("files:release", id),
     },
+    fullScreen: {
+        set: (fullScreen) => ipcRenderer.send("desktop:full-screen", fullScreen === true),
+        onChange: (listener) => {
+            ipcRenderer.on("desktop:full-screen", (_event, fullScreen) => listener(fullScreen));
+        },
+    },
     start: () => ipcRenderer.invoke("desktop:start"),
     onOpen: (listener) => {
         ipcRenderer.on("desktop:open", (_event, movie) => listener(movie));
@@ -38,6 +45,18 @@ const api = {
             ipcRenderer.on("socket:event", (_event, id, event) => listener(id, event));
         },
     },
+    webSockets: {
+        connect: (url, protocols) => {
+            const id = nextWebSocket++;
+            ipcRenderer.send("websocket:connect", id, String(url), Array.from(protocols, String));
+            return id;
+        },
+        send: (id, data) => ipcRenderer.send("websocket:send", id, data),
+        close: (id, code) => ipcRenderer.send("websocket:close", id, code),
+        onEvent: (listener) => {
+            ipcRenderer.on("websocket:event", (_event, id, event) => listener(id, event));
+        },
+    },
     network: {
         fetch: (request, cancel) => {
             const id = nextRequest++;
@@ -76,6 +95,7 @@ const api = {
         remove: (path) => ipcRenderer.sendSync("air:remove", String(path)),
         move: (from, to) => ipcRenderer.sendSync("air:move", String(from), String(to)),
         window: () => ipcRenderer.sendSync("air:window"),
+        screens: () => ipcRenderer.sendSync("air:screens"),
         setBounds: (bounds) => ipcRenderer.send("air:set-bounds", bounds),
         setTitle: (title) => ipcRenderer.send("air:set-title", String(title)),
         minimize: () => ipcRenderer.send("air:window-do", "minimize"),