@swf2es/player-hosts 0.0.0-stage → 0.1.0

package/dist/workers.js

@@ -0,0 +1,171 @@
+/**
+ * How long after a Web Worker's terminate it is taken to have stopped. A
+ * browser does not say, and Chrome lets a busy worker's script run on for
+ * some seconds (2.5 to 4 s measured, in Chrome 156) before it stops it by
+ * force; Firefox's and Safari's were not measured. The player stops a
+ * terminated worker's thread so only when the worker has not stopped
+ * itself first (scripting/workers.ts).
+ */
+const STOPPED_GRACE = 8000;
+/** The workers started ahead, by script URL. */
+const pools = new Map();
+/** How many hosts not yet released use each pool, and the timer that lets an unused one go. */
+const users = new Map();
+/** How long a pool no player uses keeps its workers, for the next player a page makes. */
+const IDLE = 10_000;
+function use(url) {
+    const key = String(url);
+    const u = users.get(key) ?? { count: 0, idle: null };
+    if (u.idle !== null) {
+        clearTimeout(u.idle);
+        u.idle = null;
+    }
+    u.count++;
+    users.set(key, u);
+}
+function release(url) {
+    const key = String(url);
+    const u = users.get(key);
+    if (!u || --u.count > 0) {
+        return;
+    }
+    u.idle = setTimeout(() => {
+        for (const spare of pools.get(key) ?? []) {
+            spare.settle();
+            spare.worker.terminate();
+        }
+        pools.delete(key);
+        users.delete(key);
+    }, IDLE);
+}
+/** The page's own modules that import a worker script from another origin, by its URL. */
+const importers = new Map();
+function spawn(url) {
+    const worker = construct(url);
+    // Answered with "ready" once the page's messages reach the worker.
+    worker.postMessage({ type: "ping" });
+    return worker;
+}
+function construct(url) {
+    try {
+        return new Worker(url, { type: "module" });
+    }
+    catch (error) {
+        // A browser starts a worker only on a script of the page's origin.
+        if (!(error instanceof DOMException && error.name === "SecurityError")) {
+            throw error;
+        }
+        const href = new URL(url, globalThis.location?.href).href;
+        let importer = importers.get(href);
+        if (importer === undefined) {
+            const source = `import ${JSON.stringify(href)};`;
+            importer = URL.createObjectURL(new Blob([source], { type: "text/javascript" }));
+            importers.set(href, importer);
+        }
+        return new Worker(importer, { type: "module" });
+    }
+}
+/** Keep `count` workers started ahead for `url`; where the page cannot start one, fewer. */
+function fill(url, count) {
+    const key = String(url);
+    let pool = pools.get(key);
+    if (!pool) {
+        pool = [];
+        pools.set(key, pool);
+    }
+    while (pool.length < count) {
+        let worker;
+        try {
+            worker = spawn(url);
+        }
+        catch {
+            // A policy that forbids the script: start() reports it.
+            break;
+        }
+        let settle = () => { };
+        const spare = {
+            worker,
+            ready: false,
+            failed: null,
+            settled: new Promise((resolve) => {
+                settle = resolve;
+            }),
+            settle: () => settle(),
+        };
+        worker.onmessage = (event) => {
+            if (event.data?.type === "ready") {
+                spare.ready = true;
+                spare.settle();
+            }
+        };
+        worker.onerror = (event) => {
+            event.preventDefault();
+            spare.failed = event.message;
+            spare.settle();
+        };
+        pool.push(spare);
+    }
+    return pool;
+}
+/** The pool's first worker that has loaded, else its first that has not failed. */
+function take(pool) {
+    for (const spare of pool.filter((s) => s.failed !== null)) {
+        spare.worker.terminate();
+        pool.splice(pool.indexOf(spare), 1);
+    }
+    const at = Math.max(pool.findIndex((s) => s.ready), 0);
+    return pool.splice(at, 1)[0];
+}
+/** Background workers on module Web Workers. */
+export function webWorkerHost(options) {
+    const url = options.url ?? new URL("./thread/player-hosts/web-worker.js", import.meta.url);
+    const cores = globalThis.navigator
+        ?.hardwareConcurrency;
+    const spares = options.spares ?? Math.min(4, Math.max(2, cores ?? 2));
+    use(url);
+    const pool = fill(url, spares);
+    let released = false;
+    return {
+        ready: Promise.all(pool.map((s) => s.settled)).then(() => { }),
+        release() {
+            if (!released) {
+                released = true;
+                release(url);
+            }
+        },
+        start(init, receive, failed) {
+            const spare = take(fill(url, spares));
+            const worker = spare?.worker ?? spawn(url);
+            // One in its place, loaded once the page's thread is free.
+            fill(url, spares);
+            // Taken before it loaded, it still settles the ready of the host that started it ahead.
+            worker.onmessage = (event) => {
+                // A worker taken before it loaded says so first.
+                if (event.data?.type === "ready") {
+                    spare?.settle();
+                }
+                else {
+                    receive(event.data);
+                }
+            };
+            worker.onerror = (event) => {
+                event.preventDefault();
+                spare?.settle();
+                worker.terminate();
+                failed(new Error(`a background worker's thread failed: ${event.message}`));
+            };
+            const start = { codegen: options.codegen, init };
+            worker.postMessage(start);
+            return {
+                post: (message) => worker.postMessage(message),
+                // A browser tells nobody when a Web Worker has stopped.
+                terminate: () => {
+                    spare?.settle();
+                    worker.terminate();
+                    return new Promise((resolve) => setTimeout(resolve, STOPPED_GRACE));
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=workers.js.map

package/dist/workers.js.map

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

package/package.json

@@ -1,6 +1,65 @@
 {
   "name": "@swf2es/player-hosts",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Optional Node and WebSocket transports, worker threads, an IndexedDB module cache and precompiled modules for the swf2es player",
+  "keywords": [
+    "swf",
+    "flash",
+    "player",
+    "websocket",
+    "web-worker",
+    "indexeddb"
+  ],
+  "homepage": "https://swf2es.github.io/swf2es/",
+  "bugs": "https://github.com/swf2es/swf2es/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/swf2es/swf2es.git",
+    "directory": "packages/player-hosts"
+  },
+  "license": "Apache-2.0 AND (Apache-2.0 OR MIT) AND MPL-2.0 AND W3C-20150513 AND Zlib AND LicenseRef-LZMA-SDK-Public-Domain AND CC0-1.0 AND SGI-B-2.0 AND BSD-2-Clause AND MIT",
+  "type": "module",
+  "exports": {
+    "./stage3d": {
+      "types": "./dist/stage3d.d.ts",
+      "default": "./dist/stage3d.js"
+    },
+    "./indexeddb": {
+      "types": "./dist/indexeddb.d.ts",
+      "default": "./dist/indexeddb.js"
+    },
+    "./precompiled": {
+      "types": "./dist/precompiled.d.ts",
+      "default": "./dist/precompiled.js"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "default": "./dist/node.js"
+    },
+    "./workers": {
+      "types": "./dist/workers.d.ts",
+      "default": "./dist/workers.js"
+    },
+    "./web-worker": {
+      "types": "./dist/web-worker.d.ts",
+      "default": "./dist/web-worker.js"
+    },
+    "./node-worker": {
+      "types": "./dist/node-worker.d.ts",
+      "default": "./dist/node-worker.js"
+    },
+    "./websocket": {
+      "types": "./dist/websocket.d.ts",
+      "default": "./dist/websocket.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/**/.tsbuildinfo",
+    "src",
+    "LICENSE.third-party"
+  ],
+  "dependencies": {
+    "@swf2es/player": "0.1.0"
+  }
 }

package/src/indexeddb.ts

@@ -0,0 +1,227 @@
+// A ModuleCache in the browser's IndexedDB: the modules the compiler wrote
+// for a page's SWFs, kept for its next load. A large application's module
+// took 250 ms to compile and 10 ms to read back (see docs/architecture/modules.md,
+// Caching modules). Anything that fails, a database that will not open, a
+// quota, a store that is gone, makes a miss, and the player compiles.
+import type { CachedModule, ModuleCache } from "@swf2es/player";
+
+export interface IndexedDbModuleCacheOptions {
+  /** The database's name. */
+  name?: string;
+  /** About how many bytes the modules may take, as UTF-16; the least recently used go first. */
+  maxBytes?: number;
+  /** The IndexedDB to use: the global one by default. */
+  indexedDB?: IDBFactory;
+  /** How long to wait for the database to open, in ms, before doing without it. */
+  openTimeout?: number;
+  /** How long, in ms, to do without a database that did not open before trying again. */
+  retryAfter?: number;
+}
+
+/** A ModuleCache that a host can close, letting go of its database. */
+export interface IndexedDbModuleCache extends ModuleCache {
+  /** Close the database; a later get or put opens it again. */
+  close(): void;
+}
+
+/** The database's version: 2 kept each module with its compile's log, 3 with their lengths too. */
+const VERSION = 3;
+const MODULES = "modules";
+/** Each module's size and last use, apart from it, so that evicting reads no module. */
+const ENTRIES = "entries";
+const USED = "used";
+
+interface Entry {
+  key: string;
+  bytes: number;
+  used: number;
+}
+
+/**
+ * A ModuleCache kept in IndexedDB, opened on its first use. A get marks its
+ * module used; a put evicts the least recently used until the modules fit
+ * in `maxBytes`, and stores nothing larger than that, once the page is
+ * idle: a large module's write that a load's next get waited behind took
+ * that get from 4 to 45 ms.
+ */
+export function indexedDbModuleCache(
+  options: IndexedDbModuleCacheOptions = {},
+): IndexedDbModuleCache {
+  const {
+    name = "swf2es-modules",
+    maxBytes = 256 * 1024 * 1024,
+    openTimeout = 2000,
+    retryAfter = 30_000,
+  } = options;
+  let opened: Promise<IDBDatabase> | null = null;
+  // When a database that did not open may be tried again.
+  let retryAt = 0;
+  const database = () => {
+    if (opened === null || (retryAt !== 0 && Date.now() >= retryAt)) {
+      retryAt = 0;
+      const attempt = open(options.indexedDB ?? globalThis.indexedDB, name, openTimeout);
+      opened = attempt;
+      attempt.then(
+        (db) => {
+          // Another tab opening a later version: let go, and open again
+          // next time, unless this was let go of already for another.
+          db.onversionchange = () => {
+            db.close();
+            if (opened === attempt) {
+              opened = null;
+            }
+          };
+        },
+        () => {
+          if (opened === attempt) {
+            retryAt = Date.now() + retryAfter;
+          }
+        },
+      );
+    }
+
+    return opened;
+  };
+
+  return {
+    async get(key) {
+      const db = await database();
+      const stored = await request<unknown>(db.transaction(MODULES).objectStore(MODULES).get(key));
+      const module = stored as CachedModule | undefined;
+      if (
+        typeof module?.module !== "string" ||
+        typeof module.log !== "string" ||
+        !Array.isArray(module.lengths)
+      ) {
+        return undefined;
+      }
+
+      // Marked used apart, in a store no get reads, and not waited for: a
+      // mark that fails leaves the module as read and its last use as it was.
+      try {
+        const entries = db.transaction(ENTRIES, "readwrite").objectStore(ENTRIES);
+        request<Entry | undefined>(entries.get(key)).then(
+          (entry) => {
+            if (entry) {
+              entries.put({ ...entry, used: Date.now() });
+            }
+          },
+          () => {},
+        );
+      } catch {
+        // No transaction: its last use stays as it was.
+      }
+
+      return {
+        module: module.module,
+        log: module.log,
+        lengths: [...module.lengths] as [number, number],
+      };
+    },
+    async put(key, module) {
+      const bytes = (module.module.length + module.log.length) * 2;
+      if (bytes > maxBytes) {
+        return;
+      }
+
+      const db = await database();
+      await new Promise<void>((resolve) => idle(resolve));
+      const tx = db.transaction([MODULES, ENTRIES], "readwrite");
+      const modules = tx.objectStore(MODULES);
+      const entries = tx.objectStore(ENTRIES);
+      modules.put({ module: module.module, log: module.log, lengths: module.lengths }, key);
+      entries.put({ key, bytes, used: Date.now() } as Entry);
+      // Oldest first, the one just put among them.
+      const all = await request<Entry[]>(entries.index(USED).getAll());
+      let total = 0;
+      for (const entry of all) {
+        total += entry.bytes;
+      }
+
+      for (const entry of all) {
+        if (total <= maxBytes) {
+          break;
+        }
+
+        if (entry.key !== key) {
+          modules.delete(entry.key);
+          entries.delete(entry.key);
+          total -= entry.bytes;
+        }
+      }
+
+      await done(tx);
+    },
+    async delete(key) {
+      const tx = (await database()).transaction([MODULES, ENTRIES], "readwrite");
+      tx.objectStore(MODULES).delete(key);
+      tx.objectStore(ENTRIES).delete(key);
+      await done(tx);
+    },
+    close() {
+      const was = opened;
+      opened = null;
+      was?.then((db) => db.close()).catch(() => {});
+    },
+  };
+}
+
+/** Run `f` when the page is next idle, or within a second; soon, where there is no requestIdleCallback. */
+function idle(f: () => void): void {
+  if (typeof requestIdleCallback === "function") {
+    requestIdleCallback(() => f(), { timeout: 1000 });
+  } else {
+    setTimeout(f, 0);
+  }
+}
+
+/** The database, made if new; rejected if it does not open within `timeout` ms, as when another tab blocks an upgrade. */
+function open(factory: IDBFactory, name: string, timeout: number): Promise<IDBDatabase> {
+  return new Promise((resolve, reject) => {
+    let late = false;
+    const timer = setTimeout(() => {
+      late = true;
+      reject(new Error(`IndexedDB ${name} did not open`));
+    }, timeout);
+    const opening = factory.open(name, VERSION);
+    opening.onupgradeneeded = () => {
+      // An older version's modules are another format's: dropped.
+      const db = opening.result;
+      for (const store of [...db.objectStoreNames]) {
+        db.deleteObjectStore(store);
+      }
+
+      db.createObjectStore(MODULES);
+      db.createObjectStore(ENTRIES, { keyPath: "key" }).createIndex(USED, USED);
+    };
+    opening.onsuccess = () => {
+      clearTimeout(timer);
+      // Given up on already, it is closed.
+      if (late) {
+        opening.result.close();
+      } else {
+        resolve(opening.result);
+      }
+    };
+    opening.onerror = () => {
+      clearTimeout(timer);
+      reject(opening.error);
+    };
+  });
+}
+
+function request<T>(r: IDBRequest): Promise<T> {
+  return new Promise((resolve, reject) => {
+    r.onsuccess = () => resolve(r.result as T);
+    r.onerror = () => reject(r.error);
+  });
+}
+
+/** Resolves once `tx` has committed; rejects if it aborts, a quota exceeded say. */
+function done(tx: IDBTransaction): Promise<void> {
+  return new Promise((resolve, reject) => {
+    tx.oncomplete = () => resolve();
+    tx.onerror = () => reject(tx.error);
+    tx.onabort = () => reject(tx.error ?? new Error("IndexedDB transaction aborted"));
+  });
+}

package/src/node-worker.ts

@@ -0,0 +1,13 @@
+// A worker_threads Worker running one background flash.system.Worker (node.ts).
+import { parentPort } from "node:worker_threads";
+import { runWorkerThread } from "@swf2es/player/worker";
+
+const port = parentPort;
+if (!port) {
+  throw new Error("node-worker.js runs only as a worker_threads Worker");
+}
+
+runWorkerThread({
+  post: (message) => port.postMessage(message),
+  listen: (receive) => port.on("message", receive),
+});

package/src/node.ts

@@ -0,0 +1,49 @@
+// Node's TCP transport for flash.net.Socket, and its threads for
+// flash.system.Worker; imported only by hosts that opt in.
+import { connect } from "node:net";
+import { Worker } from "node:worker_threads";
+import type { SocketHost, WorkerHost } from "@swf2es/player";
+import type { ThreadStart } from "@swf2es/player/worker";
+
+/** A host that connects ActionScript sockets to TCP directly from Node. */
+export function nodeSocketHost(): SocketHost {
+  return {
+    connect(host, port, events) {
+      const socket = connect({ host, port });
+      socket.on("connect", () =>
+        events.open({
+          localAddress: socket.localAddress ?? "",
+          localPort: socket.localPort ?? 0,
+          remoteAddress: socket.remoteAddress ?? "",
+          remotePort: socket.remotePort ?? 0,
+        }),
+      );
+      socket.on("data", (bytes) => events.data(bytes));
+      socket.on("close", () => events.close());
+      socket.on("error", () => events.error("Error #2031: Socket Error."));
+
+      return {
+        // Socket.flush has already combined its pending bytes into one chunk.
+        send: (bytes) => socket.write(bytes),
+        close: () => socket.destroy(),
+      };
+    },
+  };
+}
+
+/** Background workers on worker_threads Workers running node-worker.js, given codegen compiled. */
+export function nodeWorkerHost(options: { codegen: WebAssembly.Module }): WorkerHost {
+  return {
+    start(init, receive, failed) {
+      const worker = new Worker(new URL("./node-worker.js", import.meta.url));
+      worker.on("message", receive);
+      worker.on("error", failed);
+      const start: ThreadStart = { codegen: options.codegen, init };
+      worker.postMessage(start);
+      return {
+        post: (message) => worker.postMessage(message),
+        terminate: () => worker.terminate(),
+      };
+    },
+  };
+}