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]>

src/utils/grab-redirect-response.ts

@@ -0,0 +1,36 @@
+import type { BunextPageModuleServerReturn, BunxRouteParams } from "../types";
+
+type Params = {
+    serverRes: BunextPageModuleServerReturn;
+    routeParams?: BunxRouteParams;
+};
+
+/**
+ * Builds the redirect Response for a server function that returned
+ * `redirect`. An explicit `status_code` wins; otherwise `permanent` picks
+ * 301, and the default is 302. Headers from `response_options` (e.g. a
+ * Set-Cookie on login) and `res_transform` apply to the redirect too.
+ */
+export default async function grabRedirectResponse({
+    serverRes,
+    routeParams,
+}: Params): Promise<Response> {
+    const redirect = serverRes.redirect!;
+    const status = redirect.status_code || (redirect.permanent ? 301 : 302);
+
+    const headers = new Headers(serverRes.response_options?.headers);
+    headers.set("Location", redirect.destination);
+
+    const res = new Response(null, { status, headers });
+
+    // Same precedence as HTML responses
+    if (routeParams?.res_transform) {
+        return await routeParams.res_transform(res);
+    }
+
+    if (serverRes.res_transform) {
+        return await serverRes.res_transform(res);
+    }
+
+    return res;
+}