howcode 0.1.0 → 0.1.1

package/README.md

@@ -13,6 +13,16 @@ howcode
 
 On first run, the launcher downloads the matching desktop build from GitHub Releases and caches it locally.
 
+## Linux note
+
+If the Linux build hits a WebKit/GBM white-screen issue, the launcher retries with `WEBKIT_DISABLE_DMABUF_RENDERER=1` automatically.
+
+If you are launching a downloaded Linux release asset manually, use:
+
+```bash
+WEBKIT_DISABLE_DMABUF_RENDERER=1 ./howcode/bin/launcher
+```
+
 ## Cache location
 
 - macOS: `~/Library/Caches/howcode`

package/lib/howcode.js

@@ -44,6 +44,8 @@ const TARGETS = {
   },
 };
 
+const LINUX_DMABUF_FAILURE_PATTERNS = [/Failed to create GBM buffer/i, /GLXBadWindow/i, /dmabuf/i];
+
 function readJsonIfPresent(filePath) {
   try {
     return JSON.parse(fs.readFileSync(filePath, "utf8"));
@@ -203,15 +205,135 @@ async function pruneOldVersions(cacheRoot, keepDir) {
   );
 }
 
-function launch(executablePath) {
-  const child = spawn(executablePath, [], {
+function spawnLauncherProcess(executablePath, options = {}) {
+  return spawn(executablePath, [], {
     detached: true,
-    stdio: "ignore",
+    stdio: options.stdio || "ignore",
     windowsHide: true,
     cwd: path.dirname(executablePath),
+    env: {
+      ...process.env,
+      ...(options.env || {}),
+    },
+  });
+}
+
+function killDetachedProcess(child) {
+  if (!child.pid) {
+    return;
+  }
+
+  try {
+    if (process.platform !== "win32") {
+      process.kill(-child.pid, "SIGTERM");
+      return;
+    }
+  } catch {}
+
+  try {
+    child.kill("SIGTERM");
+  } catch {}
+}
+
+function hasLinuxDmabufFailure(output) {
+  return LINUX_DMABUF_FAILURE_PATTERNS.some((pattern) => pattern.test(output));
+}
+
+function trimLauncherLog(output) {
+  return output.trim().split(/\r?\n/).slice(-10).join("\n");
+}
+
+async function launch(executablePath) {
+  if (process.platform !== "linux" || process.env.WEBKIT_DISABLE_DMABUF_RENDERER === "1") {
+    const child = spawnLauncherProcess(executablePath);
+    child.unref();
+    return;
+  }
+
+  const child = spawnLauncherProcess(executablePath, {
+    stdio: ["ignore", "pipe", "pipe"],
   });
 
+  let output = "";
+  const appendOutput = (chunk) => {
+    output += chunk.toString();
+    if (output.length > 32_000) {
+      output = output.slice(-32_000);
+    }
+  };
+
+  child.stdout?.on("data", appendOutput);
+  child.stderr?.on("data", appendOutput);
+
+  const outcome = await new Promise((resolve) => {
+    let settled = false;
+
+    const finish = (value) => {
+      if (settled) {
+        return;
+      }
+
+      settled = true;
+      clearTimeout(timer);
+      resolve(value);
+    };
+
+    const checkForFallback = () => {
+      if (hasLinuxDmabufFailure(output)) {
+        finish({ type: "fallback" });
+      }
+    };
+
+    const timer = setTimeout(() => finish({ type: "ok" }), 4_000);
+
+    child.stdout?.on("data", checkForFallback);
+    child.stderr?.on("data", checkForFallback);
+    child.once("error", (error) => finish({ type: "error", error }));
+    child.once("exit", (code, signal) => {
+      if (hasLinuxDmabufFailure(output)) {
+        finish({ type: "fallback" });
+        return;
+      }
+
+      finish({ type: "exit", code, signal });
+    });
+  });
+
+  child.stdout?.destroy();
+  child.stderr?.destroy();
   child.unref();
+
+  if (outcome.type === "fallback") {
+    killDetachedProcess(child);
+
+    const fallbackChild = spawnLauncherProcess(executablePath, {
+      env: {
+        WEBKIT_DISABLE_DMABUF_RENDERER: "1",
+      },
+    });
+
+    fallbackChild.unref();
+    return;
+  }
+
+  if (outcome.type === "ok") {
+    return;
+  }
+
+  if (outcome.type === "error") {
+    throw outcome.error;
+  }
+
+  if (outcome.code === 0) {
+    return;
+  }
+
+  const logTail = trimLauncherLog(output);
+  throw new Error(
+    logTail
+      ? `Desktop launcher exited early.\n${logTail}`
+      : `Desktop launcher exited early with code ${outcome.code ?? "unknown"}.`,
+  );
 }
 
 async function main() {
@@ -226,7 +348,7 @@ async function main() {
     releaseInfo = await resolveLatestRelease(target);
   } catch (error) {
     if (current?.executablePath && fs.existsSync(current.executablePath)) {
-      launch(current.executablePath);
+      await launch(current.executablePath);
       return;
     }
 
@@ -239,7 +361,7 @@ async function main() {
   }
 
   await pruneOldVersions(cacheRoot, paths.installDir);
-  launch(paths.executablePath);
+  await launch(paths.executablePath);
 }
 
 module.exports = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "howcode",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Launch the Howcode desktop app from npm or npx.",
   "license": "MIT",
   "author": "Igor Warzocha",