@hyperframes/engine 0.8.50 → 0.8.52

package/dist/utils/processRss.js

@@ -0,0 +1,93 @@
+import { execFile } from "node:child_process";
+import { readFile } from "node:fs/promises";
+import { promisify } from "node:util";
+const KB_PER_MB = 1024;
+const defaultReadFile = (path) => readFile(path, "utf8");
+function defaultExec() {
+    // promisify lazily so vitest module mocks of child_process still take effect
+    // (same reason psnr.ts does this).
+    const execFileP = promisify(execFile);
+    return async (file, args) => {
+        const { stdout } = await execFileP(file, [...args], { windowsHide: true, timeout: 5_000 });
+        return { stdout: String(stdout) };
+    };
+}
+/** `ps -o pid=,rss=` output: one "<pid> <rss-kb>" pair per line. */
+export function parsePsRss(stdout) {
+    const samples = [];
+    for (const line of stdout.split("\n")) {
+        const match = /^\s*(\d+)\s+(\d+)\s*$/.exec(line);
+        if (!match)
+            continue;
+        const pid = Number(match[1]);
+        const rssKb = Number(match[2]);
+        if (!Number.isFinite(pid) || !Number.isFinite(rssKb))
+            continue;
+        samples.push({ pid, rssMb: Math.round(rssKb / KB_PER_MB) });
+    }
+    return samples;
+}
+/** `tasklist /FO CSV /NH /FI "PID eq N"`: `"image","pid","session","sess#","12,345 K"`. */
+export function parseTasklistCsv(pid, stdout) {
+    const line = stdout.split(/\r?\n/).find((l) => l.startsWith('"'));
+    if (!line)
+        return [];
+    const cells = line.split('","').map((c) => c.replace(/^"|"$/g, ""));
+    const memCell = cells[4];
+    if (typeof memCell !== "string")
+        return [];
+    const kb = Number(memCell.replace(/[^0-9]/g, ""));
+    if (!Number.isFinite(kb) || kb <= 0)
+        return [];
+    return [{ pid, rssMb: Math.round(kb / KB_PER_MB) }];
+}
+/** `/proc/<pid>/status` line `VmRSS:\t  12345 kB`; absent for a zombie. */
+export function parseProcStatusRss(pid, status) {
+    const match = /^VmRSS:\s*(\d+)\s*kB/m.exec(status);
+    if (!match)
+        return [];
+    const kb = Number(match[1]);
+    if (!Number.isFinite(kb) || kb <= 0)
+        return [];
+    return [{ pid, rssMb: Math.round(kb / KB_PER_MB) }];
+}
+/**
+ * Resident set size per pid, in MiB. Zero dependencies: `/proc/<pid>/status`
+ * on Linux (the render images are `node:*-slim` and ship no `ps`; same
+ * precedent as the CLI's orphanCleanup / processTree), `ps` on other POSIX
+ * (one call for all pids), `tasklist` on Windows (one call per pid). Never
+ * rejects; a pid that exited between discovery and sampling is simply absent.
+ */
+export async function sampleProcessRss(pids, exec = defaultExec(), platform = process.platform, readStatus = defaultReadFile) {
+    const unique = [...new Set(pids.filter((p) => Number.isInteger(p) && p > 0))];
+    if (unique.length === 0)
+        return [];
+    if (platform === "linux") {
+        // Per-pid catch: one exited pid must not erase the others' samples.
+        const perPid = await Promise.all(unique.map(async (pid) => {
+            try {
+                return parseProcStatusRss(pid, await readStatus(`/proc/${pid}/status`));
+            }
+            catch {
+                return [];
+            }
+        }));
+        return perPid.flat();
+    }
+    try {
+        if (platform === "win32") {
+            const results = [];
+            for (const pid of unique) {
+                const { stdout } = await exec("tasklist", ["/FO", "CSV", "/NH", "/FI", `PID eq ${pid}`]);
+                results.push(...parseTasklistCsv(pid, stdout));
+            }
+            return results;
+        }
+        const { stdout } = await exec("ps", ["-o", "pid=,rss=", "-p", unique.join(",")]);
+        return parsePsRss(stdout);
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=processRss.js.map

package/dist/utils/processRss.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processRss.js","sourceRoot":"","sources":["../../src/utils/processRss.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAUtC,MAAM,SAAS,GAAG,IAAI,CAAC;AAEvB,MAAM,eAAe,GAAiB,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAEvE,SAAS,WAAW;IAClB,6EAA6E;IAC7E,mCAAmC;IACnC,MAAM,SAAS,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IACtC,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;QAC1B,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3F,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;IACpC,CAAC,CAAC;AACJ,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,MAAM,OAAO,GAAuB,EAAE,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAS;QAC/D,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,MAAc;IAC1D,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IAClE,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;IACpE,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACzB,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IAC3C,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;IAClD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAC/C,OAAO,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,kBAAkB,CAAC,GAAW,EAAE,MAAc;IAC5D,MAAM,KAAK,GAAG,uBAAuB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAC/C,OAAO,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC;AACtD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAuB,EACvB,OAAqB,WAAW,EAAE,EAClC,WAA4B,OAAO,CAAC,QAAQ,EAC5C,aAA2B,eAAe;IAE1C,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9E,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,oEAAoE;QACpE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YACvB,IAAI,CAAC;gBACH,OAAO,kBAAkB,CAAC,GAAG,EAAE,MAAM,UAAU,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC;YAC1E,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC,CAAC,CACH,CAAC;QACF,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IACD,IAAI,CAAC;QACH,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;YACzB,MAAM,OAAO,GAAuB,EAAE,CAAC;YACvC,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;gBACzB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,GAAG,EAAE,CAAC,CAAC,CAAC;gBACzF,OAAO,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;YACjD,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACjF,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/engine",
-  "version": "0.8.50",
+  "version": "0.8.52",
   "description": "Seekable web page to video rendering engine (Puppeteer + FFmpeg)",
   "repository": {
     "type": "git",
@@ -23,6 +23,10 @@
       "import": "./dist/utils/alphaBlit.js",
       "types": "./dist/utils/alphaBlit.d.ts"
     },
+    "./chrome-host-ceiling": {
+      "import": "./dist/services/chromeHostCeiling.js",
+      "types": "./dist/services/chromeHostCeiling.d.ts"
+    },
     "./shader-transitions": {
       "import": "./dist/utils/shaderTransitions.js",
       "types": "./dist/utils/shaderTransitions.d.ts"
@@ -38,8 +42,8 @@
     "linkedom": "^0.18.12",
     "puppeteer": "^25.8.0",
     "puppeteer-core": "^25.8.0",
-    "@hyperframes/core": "^0.8.50",
-    "@hyperframes/parsers": "^0.8.50"
+    "@hyperframes/parsers": "^0.8.52",
+    "@hyperframes/core": "^0.8.52"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",