next-bun-compile 0.7.1 → 0.9.0

package/README.md

@@ -1,6 +1,6 @@
 # next-bun-compile
 
-A Next.js Build Adapter that compiles your app into a single-file [Bun](https://bun.sh) executable.
+Compile your Next.js app into a single-file [Bun](https://bun.sh) executable.
 
 One command. One binary. No runtime dependencies.
 
@@ -23,30 +23,18 @@ bun add -D next-bun-compile
 
 ## Setup
 
-Add the adapter to your `next.config.ts`:
+Enable Next.js standalone output in your `next.config.ts`:
 
 ```ts
 import type { NextConfig } from "next";
 
 const nextConfig: NextConfig = {
-  adapterPath: import.meta.resolve("next-bun-compile"),
+  output: "standalone",
 };
 
 export default nextConfig;
 ```
 
-<details>
-<summary>Using Next.js 16.1? Use the experimental config instead</summary>
-
-```ts
-const nextConfig: NextConfig = {
-  experimental: {
-    adapterPath: import.meta.resolve("next-bun-compile"),
-  },
-};
-```
-</details>
-
 Update your build script in `package.json`:
 
 ```json
@@ -88,12 +76,12 @@ See the [Bun cross-compilation docs](https://bun.sh/docs/bundler/executables#cro
 
 ### CDN / `assetPrefix`
 
-If you configure `assetPrefix` in your `next.config.ts`, static assets (`/_next/static/`) are served from your CDN instead of the origin server. The adapter detects this automatically and skips embedding static assets in the binary — only public files are embedded. This results in a smaller binary.
+If you configure `assetPrefix` in your `next.config.ts`, static assets (`/_next/static/`) are served from your CDN instead of the origin server. `next-bun-compile` detects this from the build output and skips embedding static assets in the binary — only public files are embedded. This results in a smaller binary.
 
 ```ts
 const nextConfig: NextConfig = {
+  output: "standalone",
   assetPrefix: "https://cdn.example.com",
-  adapterPath: import.meta.resolve("next-bun-compile"),
 };
 ```
 
@@ -115,18 +103,17 @@ Startup improvements scale with codebase size — larger applications benefit mo
 
 ## How It Works
 
-1. **Adapter hook** — `modifyConfig()` sets `output: "standalone"` automatically so you don't need to configure it
-2. **Asset discovery** — Scans `.next/static/` and `public/` for all static files
-3. **Code generation** — Creates a `server-entry.js` that:
+1. **Asset discovery** — Scans `.next/static/` and `public/` for all static files
+2. **Code generation** — Creates a `server-entry.js` that:
    - Embeds all assets into the binary via Bun's `import ... with { type: "file" }`
    - Extracts them to disk on first run
    - Fixes `__dirname` for compiled binary context
    - Starts the Next.js server
-4. **Compilation** — Runs `bun build --compile` with `--define` flags to eliminate dead code branches (dev-only modules, non-turbo runtimes)
+3. **Compilation** — Runs `bun build --compile` with `--define` flags to eliminate dead code branches (dev-only modules, non-turbo runtimes)
 
 ### Module Stubs
 
-Some modules can't be resolved at compile time but are never reached in production (dev servers, optional dependencies). The adapter creates no-op stubs for these **only if** the real module isn't installed. If you actually use `@opentelemetry/api` or `critters`, the real package gets bundled instead.
+Some modules can't be resolved at compile time but are never reached in production (dev servers, optional dependencies). `next-bun-compile` creates no-op stubs for these **only if** the real module isn't installed. If you actually use `@opentelemetry/api` or `critters`, the real package gets bundled instead.
 
 ## Troubleshooting
 
@@ -152,8 +139,8 @@ Failed to load external module pino-142500b1eb3f4baf: Cannot find package ...
 
 ```ts
 const nextConfig: NextConfig = {
+  output: "standalone",
   transpilePackages: ["pino", "pino-pretty"],
-  adapterPath: import.meta.resolve("next-bun-compile"),
 };
 ```
 

package/dist/cli.js

@@ -2,7 +2,7 @@
 import {
   compile,
   generateEntryPoint
-} from "./index-jevfyh6f.js";
+} from "./index-45tzedws.js";
 
 // src/cli.ts
 import { existsSync } from "node:fs";
@@ -12,12 +12,8 @@ var projectDir = resolve(".");
 var distDir = join(projectDir, ".next");
 var standaloneDir = join(distDir, "standalone");
 if (!existsSync(standaloneDir)) {
-  console.error('next-bun-compile: No standalone output found. Run "next build" first with output: "standalone" in next.config.ts.');
+  console.error('next-bun-compile: No standalone output found. Add `output: "standalone"` to next.config.ts and re-run `next build`.');
   process.exit(1);
 }
-var ctxPath = join(distDir, "bun-compile-ctx.json");
-if (existsSync(ctxPath)) {
-  console.log("next-bun-compile: Using build context from adapter");
-}
 var serverDir = generateEntryPoint({ standaloneDir, distDir, projectDir });
 compile({ serverDir, outfile: join(projectDir, "server"), extraArgs });

package/dist/{index-jevfyh6f.js → index-45tzedws.js}

@@ -1,6 +1,3 @@
-import { createRequire } from "node:module";
-var __require = /* @__PURE__ */ createRequire(import.meta.url);
-
 // src/generate.ts
 import {
   writeFileSync,
@@ -10,10 +7,18 @@ import {
   statSync,
   lstatSync,
   realpathSync,
-  mkdirSync
+  mkdirSync,
+  copyFileSync
 } from "node:fs";
 import { join, relative, basename } from "node:path";
 import { createHash } from "node:crypto";
+function readAssetPrefix(distDir) {
+  const rsfPath = join(distDir, "required-server-files.json");
+  if (!existsSync(rsfPath))
+    return "";
+  const rsf = JSON.parse(readFileSync(rsfPath, "utf-8"));
+  return rsf.config?.assetPrefix ?? "";
+}
 function tryStat(p) {
   try {
     return statSync(p);
@@ -42,7 +47,7 @@ function walkDir(dir, base = dir) {
   return results;
 }
 function toVarName(filePath) {
-  const hash = createHash("md5").update(filePath).digest("hex").slice(0, 6);
+  const hash = createHash("sha256").update(filePath).digest("hex").slice(0, 6);
   const safe = filePath.replace(/[^a-zA-Z0-9]/g, "_").slice(0, 40);
   return `asset_${safe}_${hash}`;
 }
@@ -298,14 +303,14 @@ function validateAliasResolutions(aliases, resolutions) {
   return unresolved;
 }
 function rewriteTurbopackAliases(standaloneNextDir, aliases, resolutions) {
+  const rewrittenPaths = [];
   if (aliases.length === 0 || resolutions.size === 0)
-    return;
+    return rewrittenPaths;
   const serverDir = join(standaloneNextDir, "server");
   if (!existsSync(serverDir))
-    return;
+    return rewrittenPaths;
   const escape = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
   const pattern = new RegExp(`(["'])((?:` + aliases.map((a) => escape(a.alias)).join("|") + `)(?:/[^"']+)?)\\1`, "g");
-  let rewritten = 0;
   for (const f of walkDir(serverDir)) {
     if (!f.absolutePath.endsWith(".js"))
       continue;
@@ -323,12 +328,13 @@ function rewriteTurbopackAliases(standaloneNextDir, aliases, resolutions) {
     });
     if (next !== content) {
       writeFileSync(f.absolutePath, next);
-      rewritten++;
+      rewrittenPaths.push(`.next/server/${f.relativePath.replace(/\\/g, "/")}`);
     }
   }
-  if (rewritten > 0) {
-    console.log(`next-bun-compile: Rewrote turbopack-mangled aliases in ${rewritten} server chunks`);
+  if (rewrittenPaths.length > 0) {
+    console.log(`next-bun-compile: Rewrote turbopack-mangled aliases in ${rewrittenPaths.length} server chunks`);
   }
+  return rewrittenPaths;
 }
 function findServerDir(standaloneDir) {
   if (existsSync(join(standaloneDir, "server.js"))) {
@@ -465,7 +471,12 @@ function fixModuleResolution(standaloneDir) {
       const indexPath = join(dir, "index.js");
       if (!existsSync(pkgJsonPath) || existsSync(indexPath))
         continue;
-      const pkg = JSON.parse(readFileSync(pkgJsonPath, "utf-8"));
+      let pkg;
+      try {
+        pkg = JSON.parse(readFileSync(pkgJsonPath, "utf-8"));
+      } catch {
+        continue;
+      }
       if (pkg.main && pkg.main !== "index.js") {
         writeFileSync(indexPath, `module.exports = require("./${pkg.main}");`);
       }
@@ -521,7 +532,7 @@ function generateEntryPoint(options) {
       continue;
     const dest = join(externalDir, mod);
     mkdirSync(join(dest, ".."), { recursive: true });
-    writeFileSync(dest, readFileSync(src));
+    copyFileSync(src, dest);
     runtimeFiles.push({
       absolutePath: dest,
       relativePath: `__external/${mod}`,
@@ -533,14 +544,20 @@ function generateEntryPoint(options) {
   }
   const canonicalResolutions = buildCanonicalResolutions(externalDir, turbopackAliases);
   validateAliasResolutions(turbopackAliases, canonicalResolutions);
-  rewriteTurbopackAliases(standaloneNextDir, turbopackAliases, canonicalResolutions);
-  const ctx = JSON.parse(readFileSync(join(distDir, "bun-compile-ctx.json"), "utf-8"));
-  const { assetPrefix } = ctx;
+  const rewrittenChunks = rewriteTurbopackAliases(standaloneNextDir, turbopackAliases, canonicalResolutions);
+  const assetPrefix = readAssetPrefix(distDir);
   const assetsToEmbed = assetPrefix ? [...publicFiles, ...runtimeFiles] : [...staticFiles, ...publicFiles, ...runtimeFiles];
   if (assetPrefix) {
     console.log(`next-bun-compile: assetPrefix detected — skipping ${staticFiles.length} static assets (served from CDN)`);
   }
   console.log(`next-bun-compile: Embedding ${assetsToEmbed.length} assets (${staticFiles.length} static + ${publicFiles.length} public + ${runtimeFiles.length} runtime)`);
+  const hasher = createHash("sha256");
+  for (const asset of assetsToEmbed) {
+    hasher.update(asset.urlPath);
+    hasher.update("\x00");
+    hasher.update(readFileSync(asset.absolutePath));
+  }
+  const buildHash = hasher.digest("hex");
   const imports = [];
   const mapEntries = [];
   for (const asset of assetsToEmbed) {
@@ -747,45 +764,59 @@ process.env.__NEXT_PRIVATE_STANDALONE_CONFIG = JSON.stringify(nextConfig);
 const currentPort = parseInt(process.env.PORT, 10) || 3000;
 const hostname = process.env.HOSTNAME || "0.0.0.0";
 let keepAliveTimeout = parseInt(process.env.KEEP_ALIVE_TIMEOUT, 10);
-if (Number.isNaN(keepAliveTimeout) || !Number.isFinite(keepAliveTimeout) || keepAliveTimeout < 0) {
+if (!Number.isFinite(keepAliveTimeout) || keepAliveTimeout < 0) {
   keepAliveTimeout = undefined;
 }
 
 const extractions = ${JSON.stringify(assetExtractions)};
+// Chunks that got __NBC_BASE__ placeholders injected at build time by
+// rewriteTurbopackAliases — only these need text substitution on extract;
+// everything else streams straight from the binary.
+const rewrittenChunks = new Set(${JSON.stringify(rewrittenChunks)});
+// Written to the manifest after a complete extraction. Includes baseDir:
+// if the deploy directory moves, the substituted absolute paths in the
+// rewritten chunks are wrong and everything must be re-extracted.
+const buildStamp = ${JSON.stringify(buildHash)} + "\\n" + baseDir;
+const manifestPath = path.join(baseDir, ".next", ".nbc-extracted");
 async function extractAssets() {
-  // Collect everything that isn't already on disk, dedupe parent dirs
-  // for a single mkdir pass, then issue all writes concurrently.
-  // ~45% faster than serial extraction on a typical Next.js app with
-  // sharp; trivially correct because each write is to a distinct path.
-  const todo = [];
-  for (const [urlPath, diskPath] of extractions) {
-    const fullPath = path.join(baseDir, diskPath);
-    if (fs.existsSync(fullPath)) continue;
-    const embedded = assetMap.get(urlPath);
-    if (!embedded) continue;
-    todo.push({ diskPath, fullPath, embedded });
-  }
-  if (todo.length === 0) return;
+  // Fast path: a previous boot of this exact build in this exact directory
+  // finished extracting — one file read, no per-asset stats.
+  try {
+    if (fs.readFileSync(manifestPath, "utf-8") === buildStamp) return;
+  } catch {}
 
+  // Full extraction, overwriting whatever is on disk. Skipping existing
+  // files would let stale ones (crashed half-extraction, previous build,
+  // pre-placed tampering) shadow the embedded assets forever.
   const dirs = new Set();
-  for (const t of todo) dirs.add(path.dirname(t.fullPath));
+  for (const [, diskPath] of extractions) {
+    dirs.add(path.dirname(path.join(baseDir, diskPath)));
+  }
   for (const d of dirs) fs.mkdirSync(d, { recursive: true });
 
-  await Promise.all(todo.map(async ({ diskPath, fullPath, embedded }) => {
-    // Server chunks may contain __NBC_BASE__ placeholders injected at
-    // build time by rewriteTurbopackAliases. Substitute the real baseDir
-    // before writing so bun resolves the absolute paths at chunk load
-    // (works for both CJS require and ESM import).
-    if (diskPath.startsWith(".next/server/")) {
-      const text = await Bun.file(embedded).text();
-      if (text.indexOf("__NBC_BASE__") !== -1) {
+  // Concurrent writes, bounded so thousands of in-flight fds can't trip
+  // EMFILE under conservative ulimits.
+  let idx = 0;
+  async function worker() {
+    while (idx < extractions.length) {
+      const [urlPath, diskPath] = extractions[idx++];
+      const embedded = assetMap.get(urlPath);
+      if (!embedded) continue;
+      const fullPath = path.join(baseDir, diskPath);
+      if (rewrittenChunks.has(diskPath)) {
+        const text = await Bun.file(embedded).text();
         await Bun.write(fullPath, text.split("__NBC_BASE__").join(baseDir));
-        return;
+      } else {
+        await Bun.write(fullPath, Bun.file(embedded));
       }
     }
-    await Bun.write(fullPath, Bun.file(embedded));
-  }));
-  console.log(\`Extracted \${todo.length} assets\`);
+  }
+  await Promise.all(
+    Array.from({ length: Math.min(64, extractions.length) }, worker)
+  );
+  fs.mkdirSync(path.dirname(manifestPath), { recursive: true });
+  fs.writeFileSync(manifestPath, buildStamp);
+  console.log(\`Extracted \${extractions.length} assets\`);
 }
 
 extractAssets().then(() => {
@@ -826,8 +857,16 @@ function compile(options) {
     ...extraArgs
   ];
   console.log(`next-bun-compile: Compiling to ${outfile}...`);
-  execFileSync("bun", args, { stdio: "inherit" });
+  try {
+    execFileSync("bun", args, { stdio: "inherit" });
+  } catch (err) {
+    if (err.code === "ENOENT") {
+      console.error("next-bun-compile: `bun` was not found on PATH. Install it from https://bun.sh and re-run.");
+      process.exit(1);
+    }
+    throw err;
+  }
   console.log(`next-bun-compile: Done → ${outfile}`);
 }
 
-export { __require, generateEntryPoint, compile };
+export { generateEntryPoint, compile };

package/dist/index.js

@@ -1,46 +1,8 @@
 import {
-  __require,
   compile,
   generateEntryPoint
-} from "./index-jevfyh6f.js";
-
-// src/index.ts
-import { join } from "node:path";
-var knownTranspilePackages = ["pino", "pino-pretty"];
-var adapter = {
-  name: "next-bun-compile",
-  modifyConfig(config, ctx) {
-    if (!ctx) {
-      throw new Error("next-bun-compile: Next.js 16+ is required. Please upgrade your Next.js version.");
-    }
-    if (ctx.phase !== "phase-production-build")
-      return config;
-    if (process.argv.includes("--webpack")) {
-      throw new Error("next-bun-compile: Webpack builds are not supported. Remove --webpack to use Turbopack (default).");
-    }
-    if (config.output !== "standalone") {
-      console.warn('next-bun-compile: Setting output to "standalone" (required for compilation)');
-      config.output = "standalone";
-    }
-    const existing = config.transpilePackages ?? [];
-    const toAdd = knownTranspilePackages.filter((p) => !existing.includes(p));
-    if (toAdd.length > 0) {
-      config.transpilePackages = [...existing, ...toAdd];
-    }
-    return config;
-  },
-  async onBuildComplete(ctx) {
-    const { writeFileSync } = await import("node:fs");
-    writeFileSync(join(ctx.distDir, "bun-compile-ctx.json"), JSON.stringify({
-      distDir: ctx.distDir,
-      projectDir: ctx.projectDir,
-      assetPrefix: ctx.config.assetPrefix || ""
-    }));
-  }
-};
-var src_default = adapter;
+} from "./index-45tzedws.js";
 export {
   generateEntryPoint,
-  src_default as default,
   compile
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "next-bun-compile",
-  "version": "0.7.1",
-  "description": "Next.js Build Adapter that compiles your app into a Bun single-file executable",
+  "version": "0.9.0",
+  "description": "Compile your Next.js app into a Bun single-file executable",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -26,6 +26,7 @@
   },
   "devDependencies": {
     "next": "16.1.6",
+    "@types/bun": "^1",
     "@types/node": "^20",
     "typescript": "^5"
   },
@@ -34,8 +35,7 @@
     "bun",
     "compile",
     "standalone",
-    "executable",
-    "adapter"
+    "executable"
   ],
   "license": "MIT",
   "homepage": "https://github.com/ramonmalcolm10/next-bun-compile#readme",