@swf2es/desktop 0.1.19 → 0.1.21

package/dist/main/switches.js

@@ -0,0 +1,69 @@
+// The command line's switches for this run alone, and what they make:
+// --trace and the network's logs, --ignore-certificate-errors and --proxy,
+// the network judged through them and what opens an AIR application's
+// WebSockets. Each said on stderr as the app starts.
+import { Network } from "./network.js";
+import { unverifiedHosts } from "./network-rules.js";
+import { describeProxy, proxyArgument } from "./proxy.js";
+import { dispatchedOpener, proxiedDispatcher, unverifiedDispatcher, webSocketOpener, } from "./websocket-connections.js";
+/** --trace: what the page logs, a SWF's trace() among it, goes to the terminal. */
+export const trace = process.argv.includes("--trace");
+// Each request and socket of the SWF's said on stderr: the page's DevTools show none of them.
+// --log-sockets says what each socket sends and receives as well, and so the rest too.
+export const logSockets = process.argv.includes("--log-sockets");
+const logNetwork = logSockets || process.argv.includes("--log-network");
+export const netLog = logNetwork ? (line) => process.stderr.write(`${line}\n`) : null;
+/** The SWF's http and https requests, judged as Flash's sandboxes had them. */
+/**
+ * --ignore-certificate-errors[=host,...]: HTTPS servers whose certificates go
+ * unchecked, for one's own with a certificate it signed itself. For this
+ * run alone, never kept, and said aloud: anyone on the way to such a host
+ * can read and change what the SWF loads from it.
+ */
+const unverified = unverifiedHosts(process.argv.slice(1));
+if (unverified) {
+    process.stderr.write(unverified.all
+        ? "swf2es: --ignore-certificate-errors: no HTTPS or WSS server's certificate is verified\n"
+        : `swf2es: --ignore-certificate-errors: certificates are not verified for ${unverified.hosts.join(", ") || "no host"}\n`);
+}
+const unverifiedHost = (host) => !!unverified && (unverified.all || unverified.hosts.includes(host.toLowerCase()));
+/**
+ * --proxy=<url>: what the SWF's requests, sockets and WebSockets go
+ * through. For this run alone, never kept, and said aloud, without its
+ * credentials. One that does not parse stops the app rather than letting
+ * it run without.
+ */
+export const proxied = proxyArgument(process.argv.slice(1));
+if (proxied && "error" in proxied) {
+    process.stderr.write(`swf2es: ${proxied.error}\n`);
+    process.exit(2);
+}
+export const proxy = proxied?.proxy ?? null;
+if (proxy) {
+    process.stderr.write(`swf2es: --proxy: the SWF's requests, sockets and WebSockets go through ${describeProxy(proxy)}\n`);
+}
+/** What --log-network adds to a line of a connection that went through the proxy. */
+export const via = proxy ? " via proxy" : "";
+export const warn = (message) => process.stderr.write(`swf2es: ${message}\n`);
+export const network = new Network({ unverified: unverifiedHost, proxy });
+// What opens an AIR application's WebSockets: the global's client, a wss: server's certificate
+// unchecked where the switch names its host; or every one through the proxy.
+const insecureWebSockets = unverified && !proxy ? unverifiedDispatcher() : null;
+if (unverified && !proxy && !insecureWebSockets) {
+    process.stderr.write("swf2es: --ignore-certificate-errors: a WebSocket's certificate is verified all the same\n");
+}
+export const proxiedWebSockets = proxy ? proxiedDispatcher(proxy, unverifiedHost, warn) : null;
+// Never past the proxy: where none can be made, no WebSocket opens.
+export const webSocketOpen = proxy
+    ? proxiedWebSockets
+        ? dispatchedOpener(proxiedWebSockets)
+        : () => {
+            throw new Error("no WebSocket through the proxy");
+        }
+    : insecureWebSockets
+        ? webSocketOpener(unverifiedHost, insecureWebSockets)
+        : undefined;
+if (proxy && !proxiedWebSockets) {
+    process.stderr.write("swf2es: --proxy: this Electron's WebSocket cannot go through a proxy\n");
+}
+//# sourceMappingURL=switches.js.map

package/dist/main/switches.js.map

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

package/dist/renderer/index.js

@@ -91,7 +91,7 @@ document.addEventListener("drop", (event) => {
         desktop.openDropped(file);
     }
 });
-// An open or close during optional backend loading takes precedence over the startup snapshot.
+// An open or close while the page starts takes precedence over the startup snapshot.
 let started = false;
 let pending;
 desktop.onOpen((movie) => {
@@ -113,13 +113,16 @@ desktop.onClose(() => {
 const state = await desktop.start();
 configure({ build: state.build ?? undefined });
 if (state.stage3D) {
-    try {
-        const { createStage3D } = await import("./stage3d.js");
-        configure({ stage3D: createStage3D });
-    }
-    catch (error) {
-        console.warn("swf2es: Stage3D backend could not be loaded; using default playback.", error);
-    }
+    // The WebGL2 backend loads when a SWF first asks for a context, so that one that never does
+    // starts without waiting for it.
+    configure({
+        stage3D: {
+            load: () => import("./stage3d.js").then((backend) => backend.createStage3D, (error) => {
+                console.warn("swf2es: Stage3D backend could not be loaded; Context3D unavailable.", error);
+                throw error;
+            }),
+        },
+    });
 }
 useLibraries(state.libraries);
 started = true;

package/dist/renderer/index.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swf2es/desktop",
-  "version": "0.1.19",
+  "version": "0.1.21",
   "description": "swf2es's desktop app: local and remote SWFs, and AIR applications, in an Electron window",
   "keywords": [
     "swf",
@@ -35,12 +35,12 @@
   ],
   "dependencies": {
     "electron": "44.10.2",
-    "@swf2es/codegen": "0.1.19",
-    "@swf2es/context3d": "0.1.19",
-    "@swf2es/format": "0.1.19",
-    "@swf2es/player-hosts": "0.1.19",
-    "@swf2es/player": "0.1.19",
-    "@swf2es/web": "0.1.19"
+    "@swf2es/codegen": "0.1.21",
+    "@swf2es/context3d": "0.1.21",
+    "@swf2es/format": "0.1.21",
+    "@swf2es/player": "0.1.21",
+    "@swf2es/player-hosts": "0.1.21",
+    "@swf2es/web": "0.1.21"
   },
   "scripts": {
     "fetch-electron": "node node_modules/electron/install.js",

package/src/main/air-bridge.ts

@@ -0,0 +1,185 @@
+// An AIR application's reach through the main process (shared/api.ts
+// DesktopAir): its file system, its EncryptedLocalStore, its window and
+// the screens. air.ts does the work apart from Electron.
+import { readFile, realpath } from "node:fs/promises";
+import {
+  app,
+  type BrowserWindow,
+  type IpcMainEvent,
+  type IpcMainInvokeEvent,
+  ipcMain,
+  screen,
+} from "electron";
+import type { AirScreenState, AirWindowState } from "../shared/api.js";
+import { createDirectoryOf, listOf, moveOf, readOf, removeOf, statOf, writeOf } from "./air.ts";
+import { resolveCase } from "./case-paths.ts";
+import { air, encryptedItems } from "./open.ts";
+import { sandbox, trusted, window } from "./state.ts";
+
+/** The window as an AIR application's NativeWindow reads it. */
+function windowState(w: BrowserWindow): AirWindowState {
+  const bounds = w.getBounds();
+  const content = w.getContentBounds();
+  return {
+    bounds,
+    contentOffset: { x: content.x - bounds.x, y: content.y - bounds.y },
+    title: w.getTitle(),
+    displayState: w.isMinimized() ? "minimized" : w.isMaximized() ? "maximized" : "normal",
+    active: w.isFocused(),
+    visible: w.isVisible(),
+  };
+}
+
+/** The displays as an AIR application's Screen reads them: the work area is past the system's bars. */
+function screenStates(): AirScreenState[] {
+  const primary = screen.getPrimaryDisplay().id;
+  return screen.getAllDisplays().map((display) => ({
+    bounds: display.bounds,
+    visibleBounds: display.workArea,
+    colorDepth: display.colorDepth,
+    main: display.id === primary,
+  }));
+}
+
+/**
+ * An AIR application's reach, shared/api.ts DesktopAir: the file system
+ * and the window, only while one the user opened plays and only for its
+ * page. The file system is read synchronously where File reads it so.
+ */
+export function listenForAir(): void {
+  const playing = (event: IpcMainEvent | IpcMainInvokeEvent) =>
+    trusted(event) && sandbox.application;
+  ipcMain.on("air:stat", (event, path: unknown) => {
+    event.returnValue = playing(event) && typeof path === "string" ? statOf(path) : null;
+  });
+  ipcMain.on("air:list", (event, path: unknown) => {
+    event.returnValue = playing(event) && typeof path === "string" ? listOf(path) : null;
+  });
+  // FileStream's open, which reads a file at once, as stat does: only once the application plays.
+  ipcMain.on("air:read-sync", (event, path: unknown) => {
+    event.returnValue = playing(event) && typeof path === "string" ? readOf(path) : null;
+  });
+  // EncryptedLocalStore, at once as its methods are: only the application playing's.
+  const items = (event: IpcMainEvent) => (playing(event) ? encryptedItems : null);
+  ipcMain.on("air:item-get", (event, name: unknown) => {
+    event.returnValue = typeof name === "string" ? (items(event)?.get(name) ?? null) : null;
+  });
+  ipcMain.on("air:item-set", (event, name: unknown, bytes: unknown) => {
+    if (typeof name === "string" && bytes instanceof Uint8Array) {
+      items(event)?.set(name, bytes);
+    }
+
+    event.returnValue = null;
+  });
+  ipcMain.on("air:item-remove", (event, name: unknown) => {
+    if (typeof name === "string") {
+      items(event)?.remove(name);
+    }
+
+    event.returnValue = null;
+  });
+  ipcMain.on("air:items-reset", (event) => {
+    items(event)?.reset();
+    event.returnValue = null;
+  });
+  // FileStream's writes and File's changes, at once as adl's: only once the application plays.
+  ipcMain.on(
+    "air:write-sync",
+    (event, path: unknown, bytes: unknown, offset: unknown, length: unknown) => {
+      event.returnValue =
+        playing(event) &&
+        typeof path === "string" &&
+        bytes instanceof Uint8Array &&
+        Number.isSafeInteger(offset) &&
+        Number.isSafeInteger(length) &&
+        (offset as number) >= 0 &&
+        (length as number) >= 0 &&
+        writeOf(path, bytes, offset as number, length as number);
+    },
+  );
+  ipcMain.on("air:create-directory", (event, path: unknown) => {
+    event.returnValue = playing(event) && typeof path === "string" && createDirectoryOf(path);
+  });
+  ipcMain.on("air:remove", (event, path: unknown) => {
+    event.returnValue = playing(event) && typeof path === "string" && removeOf(path);
+  });
+  ipcMain.on("air:move", (event, from: unknown, to: unknown) => {
+    event.returnValue =
+      playing(event) && typeof from === "string" && typeof to === "string" && moveOf(from, to);
+  });
+  // A read is what starts the application's grant: the page reads its content SWF first.
+  ipcMain.handle("air:read", async (event, path: unknown) => {
+    if (!trusted(event) || typeof path !== "string" || !air) {
+      return null;
+    }
+
+    try {
+      const real = await realpath(resolveCase(path));
+      return sandbox.startApplication(real) ? new Uint8Array(await readFile(real)) : null;
+    } catch {
+      return null;
+    }
+  });
+  ipcMain.on("air:window", (event) => {
+    event.returnValue = playing(event) && window ? windowState(window) : null;
+  });
+  ipcMain.on("air:screens", (event) => {
+    event.returnValue = playing(event) ? screenStates() : [];
+  });
+  ipcMain.on("air:set-bounds", (event, bounds: unknown) => {
+    const b = bounds as { x?: unknown; y?: unknown; width?: unknown; height?: unknown } | null;
+    const n = (v: unknown) => (typeof v === "number" && Number.isFinite(v) ? Math.round(v) : null);
+    const [x, y, width, height] = [n(b?.x), n(b?.y), n(b?.width), n(b?.height)];
+    if (
+      playing(event) &&
+      window &&
+      x !== null &&
+      y !== null &&
+      width &&
+      height &&
+      width > 0 &&
+      height > 0
+    ) {
+      window.setBounds({ x, y, width, height });
+    }
+  });
+  ipcMain.on("air:set-title", (event, title: unknown) => {
+    if (playing(event) && window && typeof title === "string") {
+      window.setTitle(title.slice(0, 1024));
+    }
+  });
+  ipcMain.on("air:window-do", (event, what: unknown) => {
+    if (!playing(event) || !window) {
+      return;
+    }
+
+    switch (what) {
+      case "minimize":
+        window.minimize();
+        break;
+      case "maximize":
+        window.maximize();
+        break;
+      case "restore":
+        window.restore();
+        break;
+      case "activate":
+        window.focus();
+        break;
+      case "show":
+        window.show();
+        break;
+      case "hide":
+        window.hide();
+        break;
+      case "close":
+        window.close();
+        break;
+    }
+  });
+  ipcMain.on("air:exit", (event, code: unknown) => {
+    if (playing(event)) {
+      app.exit(typeof code === "number" ? code | 0 : 0);
+    }
+  });
+}

package/src/main/dialogs.ts

@@ -0,0 +1,147 @@
+// The app's dialogs: an error, File › Open, the library chooser, and the
+// URL dialog, a window of its own.
+import { basename } from "node:path";
+import { fileURLToPath } from "node:url";
+import { BrowserWindow, dialog, type IpcMainEvent, type IpcMainInvokeEvent } from "electron";
+import type { LibraryName } from "../shared/api.js";
+import { buildMenu } from "./menu.ts";
+import { openChosen, readStart } from "./open.ts";
+import { APP_ORIGIN } from "./protocol.ts";
+import { settings, window } from "./state.ts";
+
+const promptPreload = fileURLToPath(new URL("../preload/prompt.cjs", import.meta.url));
+const PROMPT_URL = `${APP_ORIGIN}/open-url.html`;
+
+/** The dialog that asks for a URL, while it is open. */
+export let prompt: BrowserWindow | null = null;
+
+export function refuse(message: string, detail: string): void {
+  if (window) {
+    void dialog.showMessageBox(window, { type: "error", message, detail });
+  }
+}
+
+export async function showOpenDialog(): Promise<void> {
+  if (!window) {
+    return;
+  }
+
+  const result = await dialog.showOpenDialog(window, {
+    title: "Open a SWF or an AIR application",
+    properties: ["openFile"],
+    filters: [
+      { name: "SWF and AIR application descriptors", extensions: ["swf", "xml"] },
+      { name: "All files", extensions: ["*"] },
+    ],
+  });
+  if (!result.canceled && result.filePaths[0]) {
+    await openChosen(result.filePaths[0]);
+  }
+}
+
+/** Ask for a library, check that it is ABC, keep its path, and start the page again with it. */
+export async function chooseLibrary(name: LibraryName): Promise<void> {
+  if (!window) {
+    return;
+  }
+
+  const result = await dialog.showOpenDialog(window, {
+    title: `Choose ${name}.abc`,
+    properties: ["openFile"],
+    filters: [
+      { name: "ActionScript bytecode", extensions: ["abc"] },
+      { name: "All files", extensions: ["*"] },
+    ],
+  });
+  const path = result.filePaths[0];
+  if (result.canceled || !path) {
+    return;
+  }
+
+  // An ABC starts with its minor version, then its major one, 46.
+  const head = await readStart(path, 4);
+  if (head?.[2] !== 46 || head[3] !== 0) {
+    refuse(`${basename(path)} is not an ABC file.`, `swf2es needs ${name}.abc itself.`);
+    return;
+  }
+
+  if (!settings.setLibrary(name, path)) {
+    refuse("The settings could not be saved.", `swf2es uses ${path} until it quits.`);
+  }
+
+  buildMenu();
+
+  // The page fetched the libraries once; a fresh page fetches the new one.
+  window.webContents.reload();
+}
+
+/** Play on the library the app ships again, in place of one the user chose. */
+export function resetLibrary(name: LibraryName): void {
+  if (!settings.clearLibrary(name)) {
+    refuse("The settings could not be saved.", `swf2es uses its own ${name} until it quits.`);
+  }
+
+  buildMenu();
+  window?.webContents.reload();
+}
+
+/**
+ * The dialog that asks for a SWF's URL: a window of its own, apart from the
+ * page, so that only the user, and never a SWF, opens one by its URL.
+ */
+export function showUrlDialog(): void {
+  if (!window) {
+    return;
+  }
+
+  if (prompt) {
+    prompt.focus();
+    return;
+  }
+
+  const dialogWindow = new BrowserWindow({
+    parent: window,
+    modal: true,
+    width: 560,
+    height: 180,
+    resizable: false,
+    minimizable: false,
+    maximizable: false,
+    fullscreenable: false,
+    title: "Open URL",
+    show: false,
+    webPreferences: {
+      preload: promptPreload,
+      contextIsolation: true,
+      sandbox: true,
+      nodeIntegration: false,
+      webSecurity: true,
+      spellcheck: false,
+    },
+  });
+  prompt = dialogWindow;
+  dialogWindow.setMenu(null);
+  dialogWindow.on("page-title-updated", (event) => event.preventDefault());
+  dialogWindow.once("ready-to-show", () => dialogWindow.show());
+  dialogWindow.on("closed", () => {
+    if (prompt === dialogWindow) {
+      prompt = null;
+    }
+  });
+  const contents = dialogWindow.webContents;
+  contents.on("will-navigate", (event) => event.preventDefault());
+  contents.setWindowOpenHandler(() => ({ action: "deny" }));
+  void dialogWindow.loadURL(PROMPT_URL);
+}
+
+/** Whether a message comes from the URL dialog's own page. */
+export function fromPrompt(event: IpcMainEvent | IpcMainInvokeEvent): boolean {
+  const frame = event.senderFrame;
+  return (
+    prompt !== null &&
+    event.sender === prompt.webContents &&
+    frame !== null &&
+    frame.parent === null &&
+    frame.url === PROMPT_URL
+  );
+}