@takazudo/zfb 0.1.0-next.75 → 0.1.0-next.76

package/bin/detect-musl.mjs

@@ -0,0 +1,55 @@
+// Extracted from zfb.mjs so the detection decision can be unit-tested
+// without triggering zfb.mjs's top-level exec/spawn side effects. Pure and
+// dependency-injectable: production callers can omit every option.
+import { readdirSync } from "node:fs";
+
+const MUSL_LOADER_DIR = "/lib";
+const MUSL_LOADER_PREFIX = "ld-musl-";
+
+// True if a musl dynamic loader file is present (e.g. Alpine's
+// /lib/ld-musl-x86_64.so.1). Reading the directory and matching the prefix
+// covers every arch's loader filename with one probe instead of hardcoding
+// an existsSync path per arch. Mirrors the loader-file probe used by the
+// widely-adopted `detect-libc` npm package.
+function hasMuslLoaderFile(readdirSyncFn) {
+  try {
+    return readdirSyncFn(MUSL_LOADER_DIR).some((name) => name.startsWith(MUSL_LOADER_PREFIX));
+  } catch {
+    return false;
+  }
+}
+
+function defaultGetReport() {
+  return process.report?.getReport?.();
+}
+
+// True if Node's process.report exposes a glibc runtime version. glibc-built
+// Node populates header.glibcVersionRuntime; musl-built Node does not. Used
+// only as a fallback signal when the loader-file probe above is inconclusive.
+function hasGlibcVersionRuntime(getReportFn) {
+  try {
+    return Boolean(getReportFn()?.header?.glibcVersionRuntime);
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Detects musl libc (e.g. Alpine) on Linux, where the gnu-built platform
+ * binary would otherwise fail with an opaque dynamic-loader exec error
+ * instead of a clear "not supported" message. Always returns false on
+ * non-linux platforms (darwin, win32) — zero behavior change there.
+ */
+export function detectMuslLinux({
+  platform = process.platform,
+  readdirSyncFn = readdirSync,
+  getReportFn = defaultGetReport,
+} = {}) {
+  if (platform !== "linux") return false;
+  // The glibc runtime report is authoritative when present: a Node process
+  // that reports a glibc version is definitely glibc-linked and will work,
+  // regardless of an unrelated musl loader file sitting on the filesystem
+  // (e.g. a `musl` package installed on Debian/Ubuntu for other reasons).
+  if (hasGlibcVersionRuntime(getReportFn)) return false;
+  return hasMuslLoaderFile(readdirSyncFn);
+}

package/bin/zfb.mjs

@@ -10,6 +10,7 @@ import { spawn } from "node:child_process";
 import { createRequire } from "node:module";
 import { constants as osConstants } from "node:os";
 import { join } from "node:path";
+import { detectMuslLinux } from "./detect-musl.mjs";
 
 const require = createRequire(import.meta.url);
 
@@ -32,6 +33,18 @@ if (!pkg) {
   process.exit(1);
 }
 
+// The gnu-built binary above matches on os/cpu but not on libc: an
+// Alpine/musl-libc Linux install passes the os/cpu check yet would still
+// fail to exec, with a raw, confusing dynamic-loader error. Detect and fail
+// with a clear message before attempting to resolve/spawn the binary.
+if (detectMuslLinux()) {
+  console.error(
+    "[zfb] musl/Alpine is not supported yet — no @takazudo/zfb-linux-*-musl package exists.\n" +
+      "      Use a glibc-based Linux image (e.g. Debian/Ubuntu) instead of Alpine.",
+  );
+  process.exit(1);
+}
+
 let binPath;
 try {
   // Resolve the platform package's package.json to get the install directory.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takazudo/zfb",
-  "version": "0.1.0-next.75",
+  "version": "0.1.0-next.76",
   "private": false,
   "type": "module",
   "description": "Rust-built static-site engine for Astro and Next.js users — millisecond rebuilds, single binary. SDK with islands, content collections, pagination, and config helpers.",
@@ -74,11 +74,11 @@
     "LICENSE"
   ],
   "optionalDependencies": {
-    "@takazudo/zfb-darwin-arm64": "0.1.0-next.75",
-    "@takazudo/zfb-darwin-x64": "0.1.0-next.75",
-    "@takazudo/zfb-linux-arm64-gnu": "0.1.0-next.75",
-    "@takazudo/zfb-linux-x64-gnu": "0.1.0-next.75",
-    "@takazudo/zfb-win32-x64-msvc": "0.1.0-next.75"
+    "@takazudo/zfb-darwin-arm64": "0.1.0-next.76",
+    "@takazudo/zfb-darwin-x64": "0.1.0-next.76",
+    "@takazudo/zfb-linux-arm64-gnu": "0.1.0-next.76",
+    "@takazudo/zfb-linux-x64-gnu": "0.1.0-next.76",
+    "@takazudo/zfb-win32-x64-msvc": "0.1.0-next.76"
   },
   "publishConfig": {
     "access": "public"