@hypersocial/decks-cli 0.9.4 → 0.9.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hypersocial/decks-cli",
-  "version": "0.9.4",
+  "version": "0.9.5",
   "description": "Command-line client for Hypersocial Decks live analytics and share management.",
   "type": "module",
   "main": "./src/commands.mjs",

package/src/export-video.mjs

@@ -19,7 +19,7 @@ import { tmpdir } from 'node:os';
 import { dirname, extname, join } from 'node:path';
 import { execFile } from 'node:child_process';
 import { promisify } from 'node:util';
-import { allowCaptureDestination, installChromium, isMissingBrowser, routeCaptureRequest } from './preview-capture.mjs';
+import { allowCaptureDestination, installChromium, isMissingBrowser, noteSoftwareWebgl, recorderArgs, routeCaptureRequest } from './preview-capture.mjs';
 import { installFrameClock } from './frame-clock.mjs';
 
 const run = promisify(execFile);
@@ -272,9 +272,11 @@ export async function recordVideo(config, { log = () => {}, chromium: injected,
     browser = await launchRecorder(chromium, {
       // config.sandbox: false only for CI runners whose AppArmor blocks Chromium's sandbox (the smoke suite).
       headless: true, timeout: 30000, chromiumSandbox: config.sandbox ?? process.platform === 'linux',
-      args: ['--autoplay-policy=no-user-gesture-required', '--mute-audio', '--enable-unsafe-swiftshader'],
+      // On a Mac the head is drawn on the graphics card (recorderArgs); elsewhere in software.
+      args: ['--autoplay-policy=no-user-gesture-required', '--mute-audio', ...recorderArgs()],
       env: { ...(process.platform === 'win32' ? { SystemRoot: process.env.SystemRoot } : {}), PATH: process.env.PATH, TMPDIR: temp, HOME: temp },
     }, { log, ...(install ? { install } : {}) });
+    await noteSoftwareWebgl(browser, log);
     const pageUrl = exportPageUrl(config.url, config);
     const context = await browser.newContext({ viewport: geometry.viewport, deviceScaleFactor: geometry.scale, serviceWorkers: 'block', acceptDownloads: false });
     const blockedUrls = [];

package/src/preview-capture.mjs

@@ -22,6 +22,42 @@ export async function installChromium({ exec = run } = {}) {
 }
 // Playwright's launch error when the browser build is not on disk.
 export const isMissingBrowser = (e) => /Executable doesn't exist/.test(String(e?.message ?? e));
+// Chromium's WebGL flags for capture and video export. On a Mac, ANGLE's Metal
+// backend draws WebGL (the live head) on the graphics card: the investor deck's
+// 1080p export rendered in 7 min instead of 48 (docs/spikes/mac-video-export-gpu.md).
+// Elsewhere (Linux, the render worker's GPU-less machines) WebGL stays in
+// SwiftShader, on the CPU. --enable-unsafe-swiftshader is kept on every
+// platform: it is what Chromium falls back to when it cannot use the GPU.
+export function recorderArgs(platform = process.platform) {
+  return platform === 'darwin' ? ['--use-angle=metal', '--enable-unsafe-swiftshader'] : ['--enable-unsafe-swiftshader'];
+}
+// The WebGL renderer (UNMASKED_RENDERER_WEBGL) a launched browser draws with,
+// or null when it cannot tell (no WebGL, or no answer within `ms`).
+export async function webglRenderer(browser, ms = 10000) {
+  let page, timer;
+  try {
+    const read = (async () => {
+      page = await browser.newPage();
+      return page.evaluate(() => {
+        const gl = document.createElement('canvas').getContext('webgl');
+        const info = gl?.getExtension('WEBGL_debug_renderer_info');
+        return gl ? String(gl.getParameter(info ? info.UNMASKED_RENDERER_WEBGL : gl.RENDERER)) : null;
+      });
+    })();
+    read.catch(() => {});
+    return await Promise.race([read, new Promise((ok) => { timer = setTimeout(() => ok(null), ms); })]);
+  } catch { return null; }
+  finally { clearTimeout(timer); await page?.close().catch(() => {}); }
+}
+export const isSoftwareRenderer = (renderer) => /swiftshader/i.test(renderer ?? '');
+// On a Mac, one line when Chromium could not use the graphics card and fell
+// back to drawing WebGL in software. Returns the renderer it read.
+export async function noteSoftwareWebgl(browser, log, platform = process.platform) {
+  if (platform !== 'darwin') return null;
+  const renderer = await webglRenderer(browser);
+  if (isSoftwareRenderer(renderer)) log('Chromium could not use this Mac\'s graphics card; the head is drawn in software, so the export runs several times slower');
+  return renderer;
+}
 export async function setupCapture(pos, opts) {
   if (pos.length || Object.keys(opts).some(k => !['json', 'dev', 'convex', 'prod'].includes(k))) throw new Error('usage: preview setup');
   await installChromium();
@@ -207,7 +243,7 @@ export async function capturePreview(config) {
   try {
     temp = await mkdtemp(join(tmpdir(), 'hyperdecks-preview-'));
     try {
-      browser = await chromium.launch({ headless: true, timeout:30000, chromiumSandbox: process.platform === 'linux', args: ['--mute-audio', '--enable-unsafe-swiftshader'], env: { ...(process.platform === 'win32' ? { SystemRoot: process.env.SystemRoot } : {}), PATH: process.env.PATH, TMPDIR: temp, HOME: temp } });
+      browser = await chromium.launch({ headless: true, timeout:30000, chromiumSandbox: process.platform === 'linux', args: ['--mute-audio', ...recorderArgs()], env: { ...(process.platform === 'win32' ? { SystemRoot: process.env.SystemRoot } : {}), PATH: process.env.PATH, TMPDIR: temp, HOME: temp } });
     } catch { throw new Error(`Could not launch isolated Chromium. ${SETUP}`); }
     deadline = setTimeout(() => { timedOut = true; browser.close().catch(() => {}); }, 60000);
     server = await serveSource(config);

package/src/runtime.mjs

@@ -8,7 +8,7 @@ import { fileURLToPath } from "node:url";
 import { ConvexHttpClient } from "convex/browser";
 import { makeFunctionReference } from "convex/server";
 
-export const VERSION = "0.9.4";
+export const VERSION = "0.9.5";
 const UPLOAD_TIMEOUT_MS = 125_000;
 
 export const PROD = {