1.4.0: not_found, server-only response options, compression

- Server functions can return not_found: true to render the 404 page
  with status 404.
- Page components and window.__PAGE_PROPS__ (and HMR updates) only get
  props, query, url and error. response_options, redirect, cache settings
  and res_transform stay on the server, so cookies and private headers no
  longer end up in the HTML. BunextPageProps is narrowed to match
  (breaking for code that read server-only fields from component props).
- response_options headers go through a Headers object, so repeated
  headers such as several Set-Cookie survive.
- Redirects: status_code wins over permanent; response_options headers
  and res_transform apply to redirects too.
- Gzip for compressible text responses; compress: false to turn it off.
- Files the router matches but never bundles (.server.ts, __root,
  excluded paths and directories) return 404 instead of looping through
  dev rebuild retries.
- Missing public files return 404 rather than 403, so dotted page paths
  like /users/john.doe fall through to pages again.
- importFresh detects rewrites within the filesystem's mtime granularity.
- README: self-hosted React (not esm.sh), snake_case option names, static
  file serving, cache headers, the new options.

Co-Authored-By: Claude Opus 5.5 <[email protected]>

dist/commands/build/index.js

@@ -1,4 +1,5 @@
 import { Command } from "commander";
+import { DistDirOptionDescription, DistDirOptionFlags, } from "../dist-dir-option";
 import { log } from "../../utils/log";
 import grabDirNames from "../../utils/grab-dir-names";
 import { rmSync, writeFileSync } from "fs";
@@ -6,11 +7,12 @@ import bunextInit from "../../functions/bunext-init";
 import { v4 } from "uuid";
 import { updatePageLastmodRecord } from "../../utils/page-lastmod-record";
 import disposeBundlerContexts from "../../functions/bundler/dispose-bundler-contexts";
-const { HYDRATION_DST_DIR, BUNX_CWD_PAGES_REWRITE_DIR, BUNDLER_CTX_MAP_JSON, SSR_BUNDLER_CTX_MAP_JSON, BUNX_CWD_MODULE_CACHE_DIR, BUILD_INFO_JSON, } = grabDirNames();
 export default function () {
     return new Command("build")
         .description("Build Project")
+        .option(DistDirOptionFlags, DistDirOptionDescription)
         .action(async () => {
+        const { HYDRATION_DST_DIR, BUNX_CWD_PAGES_REWRITE_DIR, BUNDLER_CTX_MAP_JSON, SSR_BUNDLER_CTX_MAP_JSON, BUNX_CWD_MODULE_CACHE_DIR, BUILD_INFO_JSON, } = grabDirNames();
         try {
             rmSync(HYDRATION_DST_DIR, { recursive: true });
             rmSync(BUNX_CWD_PAGES_REWRITE_DIR, { recursive: true });

dist/commands/dev/dev-spawn.js

@@ -4,7 +4,6 @@ import bunextInit from "../../functions/bunext-init";
 import grabDirNames from "../../utils/grab-dir-names";
 import writeErrorFile from "../../functions/write-error-file";
 import { rmSync } from "fs";
-const { HYDRATION_DST_DIR, BUNX_CWD_PAGES_REWRITE_DIR } = grabDirNames();
 // The supervisor only restarts the dev server when this process actually
 // exits with a code. Registering a listener that merely logs (the previous
 // behavior) keeps Bun from exiting: the crash is swallowed, no error file is
@@ -22,6 +21,8 @@ process.on("unhandledRejection", (reason) => {
 });
 log.info("Running development server ...");
 try {
+    // The dist directory comes from the parent (`BUNEXT_DIST_DIR`).
+    const { HYDRATION_DST_DIR, BUNX_CWD_PAGES_REWRITE_DIR } = grabDirNames();
     rmSync(HYDRATION_DST_DIR, { recursive: true });
     rmSync(BUNX_CWD_PAGES_REWRITE_DIR, { recursive: true });
 }

dist/commands/dev/index.js

@@ -1,15 +1,17 @@
 import { Command } from "commander";
+import { DistDirOptionDescription, DistDirOptionFlags, } from "../dist-dir-option";
 import path from "path";
 import grabDirNames from "../../utils/grab-dir-names";
 import writeErrorFile from "../../functions/write-error-file";
 import { existsSync, rmSync } from "fs";
-const { BUNDLER_CTX_MAP_JSON, SSR_BUNDLER_CTX_MAP_JSON, BUNX_BUNDLER_ERROR_EXIT_FILE, } = grabDirNames();
 const MAX_RETRIES = 5;
 const RETRY_RESET_AFTER_MS = 10000;
 export default function () {
     return new Command("dev")
         .description("Run development server")
+        .option(DistDirOptionFlags, DistDirOptionDescription)
         .action(async () => {
+        const { BUNDLER_CTX_MAP_JSON, SSR_BUNDLER_CTX_MAP_JSON, BUNX_BUNDLER_ERROR_EXIT_FILE, } = grabDirNames();
         try {
             rmSync(SSR_BUNDLER_CTX_MAP_JSON, { recursive: true });
             rmSync(BUNDLER_CTX_MAP_JSON, { recursive: true });

dist/commands/dist-dir-option.d.ts

@@ -0,0 +1,2 @@
+export declare const DistDirOptionFlags = "--dist-dir <path>";
+export declare const DistDirOptionDescription: string;

dist/commands/dist-dir-option.js

@@ -0,0 +1,3 @@
+export const DistDirOptionFlags = "--dist-dir <path>";
+export const DistDirOptionDescription = "Build artifact directory, relative to the project root " +
+    "(default: `dist_dir` from bunext.config.ts, else .bunext)";

dist/commands/index.js

@@ -5,6 +5,7 @@ import dev from "./dev";
 import build from "./build";
 import sitemap from "./sitemap";
 import { log } from "../utils/log";
+import setupDistDir from "../functions/setup-dist-dir";
 /**
  * # Describe Program
  */
@@ -19,6 +20,20 @@ program.addCommand(dev());
 program.addCommand(start());
 program.addCommand(build());
 program.addCommand(sitemap());
+/**
+ * # Resolve the Dist Directory
+ * Before any command runs, from `--dist-dir` or the config. Child server
+ * processes inherit it through `BUNEXT_DIST_DIR`.
+ */
+program.hook("preAction", async (_program, action_command) => {
+    try {
+        await setupDistDir({ dist_dir: action_command.opts().distDir });
+    }
+    catch (error) {
+        log.error(error?.message || String(error));
+        process.exit(1);
+    }
+});
 /**
  * # Handle Unavailable Commands
  */
@@ -31,4 +46,4 @@ program.on("command:*", () => {
 /**
  * # Parse Arguments
  */
-program.parse(Bun.argv);
+await program.parseAsync(Bun.argv);

dist/commands/sitemap/index.js

@@ -1,4 +1,5 @@
 import { Command } from "commander";
+import { DistDirOptionDescription, DistDirOptionFlags, } from "../dist-dir-option";
 import { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync, } from "fs";
 import path from "path";
 import { log } from "../../utils/log";
@@ -15,6 +16,7 @@ export default function () {
         .option("-o, --output <path>", "Output file relative to the project root (default: public/sitemap.xml)")
         .option("--origin <url>", "Base URL for sitemap links")
         .option("--no-robots", "Skip generating robots.txt")
+        .option(DistDirOptionFlags, DistDirOptionDescription)
         .action(async (options) => {
         const { ROOT_DIR, PUBLIC_DIR } = grabDirNames();
         global.BUNEXT_CONFIG = (await grabConfig()) || {};

dist/commands/start/index.js

@@ -1,15 +1,17 @@
 import { Command } from "commander";
+import { DistDirOptionDescription, DistDirOptionFlags, } from "../dist-dir-option";
 import path from "path";
 import writeErrorFile from "../../functions/write-error-file";
 import grabDirNames from "../../utils/grab-dir-names";
 import { existsSync, rmSync } from "fs";
-const { BUNX_BUNDLER_ERROR_EXIT_FILE } = grabDirNames();
 const MAX_RETRIES = 5;
 const RETRY_RESET_AFTER_MS = 10000;
 export default function () {
     return new Command("start")
         .description("Start production server")
+        .option(DistDirOptionFlags, DistDirOptionDescription)
         .action(async () => {
+        const { BUNX_BUNDLER_ERROR_EXIT_FILE } = grabDirNames();
         // A stale error file from a previous session makes the bundler
         // run in "silent" mode and pages fail with misleading messages.
         rmSync(BUNX_BUNDLER_ERROR_EXIT_FILE, { force: true });