next-bun-compile 0.1.1 → 0.2.1

package/README.md

@@ -62,6 +62,35 @@ The binary is fully self-contained — static assets, public files, and the Next
 | `HOSTNAME` | `0.0.0.0` | Server hostname |
 | `KEEP_ALIVE_TIMEOUT` | — | HTTP keep-alive timeout (ms) |
 
+### 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.
+
+```ts
+const nextConfig: NextConfig = {
+  assetPrefix: "https://cdn.example.com",
+  experimental: {
+    adapterPath: require.resolve("next-bun-compile"),
+  },
+};
+```
+
+You'll need to upload `.next/static/` to your CDN separately.
+
+## Performance
+
+The compiled binary uses Bun's `--bytecode` flag to pre-compile JavaScript to bytecode at build time, skipping the parsing step at startup. Code is also minified and dead code paths (dev-only modules, non-turbo runtimes) are eliminated via `--define` flags.
+
+Benchmarks on a real Next.js app (both running on Bun's runtime):
+
+| | Standalone | Compiled Binary |
+|---|---|---|
+| **Startup** | 84ms | **45ms (1.9x faster)** |
+| **Memory (RSS)** | 60 MB | 72 MB |
+| **Size** | 91 MB (directory) | 99 MB (single file) |
+
+Startup improvements scale with codebase size — larger applications benefit more since there's more code to parse.
+
 ## How It Works
 
 1. **Adapter hook** — `modifyConfig()` sets `output: "standalone"` automatically so you don't need to configure it

package/dist/cli.js

@@ -73,18 +73,23 @@ function generateEntryPoint(options) {
   const staticDir = join(distDir, "static");
   const staticFiles = walkDir(staticDir).map((f) => ({
     ...f,
-    urlPath: `/_next/static/${f.relativePath}`
+    urlPath: `/_next/static/${f.relativePath.replace(/\\/g, "/")}`
   }));
   const publicDir = join(projectDir, "public");
   const publicFiles = walkDir(publicDir).map((f) => ({
     ...f,
-    urlPath: `/${f.relativePath}`
+    urlPath: `/${f.relativePath.replace(/\\/g, "/")}`
   }));
-  const allAssets = [...staticFiles, ...publicFiles];
-  console.log(`next-bun-compile: Found ${staticFiles.length} static + ${publicFiles.length} public = ${allAssets.length} assets`);
+  const ctx = JSON.parse(readFileSync(join(distDir, "bun-compile-ctx.json"), "utf-8"));
+  const { assetPrefix } = ctx;
+  const assetsToEmbed = assetPrefix ? publicFiles : [...staticFiles, ...publicFiles];
+  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 (${assetPrefix ? "public only" : `${staticFiles.length} static + ${publicFiles.length} public`})`);
   const imports = [];
   const mapEntries = [];
-  for (const asset of allAssets) {
+  for (const asset of assetsToEmbed) {
     const varName = toVarName(asset.urlPath);
     const importPath = relative(standaloneDir, asset.absolutePath).replace(/\\/g, "/");
     imports.push(`import ${varName} from "./${importPath}" with { type: "file" };`);
@@ -102,7 +107,7 @@ ${mapEntries.join(`
   if (!configMatch) {
     throw new Error("next-bun-compile: Could not extract nextConfig from standalone server.js");
   }
-  const assetExtractions = allAssets.map((a) => {
+  const assetExtractions = assetsToEmbed.map((a) => {
     const diskPath = a.urlPath.startsWith("/_next/static/") ? ".next/static/" + a.relativePath : "public/" + a.relativePath;
     return [a.urlPath, diskPath];
   });
@@ -147,7 +152,6 @@ extractAssets().then(() => {
 }).catch((err) => { console.error(err); process.exit(1); });
 `;
   writeFileSync(join(standaloneDir, "server-entry.js"), serverEntry);
-  console.log("next-bun-compile: Generated server-entry.js + assets.generated.js");
 }
 
 // src/compile.ts

package/dist/generate.js

@@ -72,18 +72,23 @@ function generateEntryPoint(options) {
   const staticDir = join(distDir, "static");
   const staticFiles = walkDir(staticDir).map((f) => ({
     ...f,
-    urlPath: `/_next/static/${f.relativePath}`
+    urlPath: `/_next/static/${f.relativePath.replace(/\\/g, "/")}`
   }));
   const publicDir = join(projectDir, "public");
   const publicFiles = walkDir(publicDir).map((f) => ({
     ...f,
-    urlPath: `/${f.relativePath}`
+    urlPath: `/${f.relativePath.replace(/\\/g, "/")}`
   }));
-  const allAssets = [...staticFiles, ...publicFiles];
-  console.log(`next-bun-compile: Found ${staticFiles.length} static + ${publicFiles.length} public = ${allAssets.length} assets`);
+  const ctx = JSON.parse(readFileSync(join(distDir, "bun-compile-ctx.json"), "utf-8"));
+  const { assetPrefix } = ctx;
+  const assetsToEmbed = assetPrefix ? publicFiles : [...staticFiles, ...publicFiles];
+  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 (${assetPrefix ? "public only" : `${staticFiles.length} static + ${publicFiles.length} public`})`);
   const imports = [];
   const mapEntries = [];
-  for (const asset of allAssets) {
+  for (const asset of assetsToEmbed) {
     const varName = toVarName(asset.urlPath);
     const importPath = relative(standaloneDir, asset.absolutePath).replace(/\\/g, "/");
     imports.push(`import ${varName} from "./${importPath}" with { type: "file" };`);
@@ -101,7 +106,7 @@ ${mapEntries.join(`
   if (!configMatch) {
     throw new Error("next-bun-compile: Could not extract nextConfig from standalone server.js");
   }
-  const assetExtractions = allAssets.map((a) => {
+  const assetExtractions = assetsToEmbed.map((a) => {
     const diskPath = a.urlPath.startsWith("/_next/static/") ? ".next/static/" + a.relativePath : "public/" + a.relativePath;
     return [a.urlPath, diskPath];
   });
@@ -146,7 +151,6 @@ extractAssets().then(() => {
 }).catch((err) => { console.error(err); process.exit(1); });
 `;
   writeFileSync(join(standaloneDir, "server-entry.js"), serverEntry);
-  console.log("next-bun-compile: Generated server-entry.js + assets.generated.js");
 }
 export {
   generateEntryPoint

package/dist/index.js

@@ -72,18 +72,23 @@ function generateEntryPoint(options) {
   const staticDir = join(distDir, "static");
   const staticFiles = walkDir(staticDir).map((f) => ({
     ...f,
-    urlPath: `/_next/static/${f.relativePath}`
+    urlPath: `/_next/static/${f.relativePath.replace(/\\/g, "/")}`
   }));
   const publicDir = join(projectDir, "public");
   const publicFiles = walkDir(publicDir).map((f) => ({
     ...f,
-    urlPath: `/${f.relativePath}`
+    urlPath: `/${f.relativePath.replace(/\\/g, "/")}`
   }));
-  const allAssets = [...staticFiles, ...publicFiles];
-  console.log(`next-bun-compile: Found ${staticFiles.length} static + ${publicFiles.length} public = ${allAssets.length} assets`);
+  const ctx = JSON.parse(readFileSync(join(distDir, "bun-compile-ctx.json"), "utf-8"));
+  const { assetPrefix } = ctx;
+  const assetsToEmbed = assetPrefix ? publicFiles : [...staticFiles, ...publicFiles];
+  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 (${assetPrefix ? "public only" : `${staticFiles.length} static + ${publicFiles.length} public`})`);
   const imports = [];
   const mapEntries = [];
-  for (const asset of allAssets) {
+  for (const asset of assetsToEmbed) {
     const varName = toVarName(asset.urlPath);
     const importPath = relative(standaloneDir, asset.absolutePath).replace(/\\/g, "/");
     imports.push(`import ${varName} from "./${importPath}" with { type: "file" };`);
@@ -101,7 +106,7 @@ ${mapEntries.join(`
   if (!configMatch) {
     throw new Error("next-bun-compile: Could not extract nextConfig from standalone server.js");
   }
-  const assetExtractions = allAssets.map((a) => {
+  const assetExtractions = assetsToEmbed.map((a) => {
     const diskPath = a.urlPath.startsWith("/_next/static/") ? ".next/static/" + a.relativePath : "public/" + a.relativePath;
     return [a.urlPath, diskPath];
   });
@@ -146,7 +151,6 @@ extractAssets().then(() => {
 }).catch((err) => { console.error(err); process.exit(1); });
 `;
   writeFileSync(join(standaloneDir, "server-entry.js"), serverEntry);
-  console.log("next-bun-compile: Generated server-entry.js + assets.generated.js");
 }
 
 // src/compile.ts
@@ -182,8 +186,8 @@ import { join as join3 } from "node:path";
 var knownTranspilePackages = ["pino", "pino-pretty"];
 var adapter = {
   name: "next-bun-compile",
-  modifyConfig(config, { phase }) {
-    if (phase !== "phase-production-build")
+  modifyConfig(config, ctx) {
+    if (ctx?.phase && ctx.phase !== "phase-production-build")
       return config;
     if (config.output !== "standalone") {
       console.warn('next-bun-compile: Setting output to "standalone" (required for compilation)');
@@ -200,7 +204,8 @@ var adapter = {
     const { writeFileSync: writeFileSync2 } = await import("node:fs");
     writeFileSync2(join3(ctx.distDir, "bun-compile-ctx.json"), JSON.stringify({
       distDir: ctx.distDir,
-      projectDir: ctx.projectDir
+      projectDir: ctx.projectDir,
+      assetPrefix: ctx.config.assetPrefix || ""
     }));
   }
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "next-bun-compile",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "Next.js Build Adapter that compiles your app into a Bun single-file executable",
   "type": "module",
   "main": "./dist/index.js",