Stop per-request module re-imports leaking memory in production

Page rendering imported the SSR bundle and .server.ts modules with a
unique ?t= query on every request, in production too. Each one became a
new, never-evicted module record (and re-ran module top-level code), so
RSS grew with request count. Cache-bust only in dev via importFresh.

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

src/functions/server/web-pages/grab-page-bundled-react-component.tsx

@@ -7,6 +7,7 @@ import grabRootFilePath from "./grab-root-file-path";
 import path from "path";
 import grabDirNames from "../../../utils/grab-dir-names";
 import grabRelativePath from "../../../utils/grab-relative-path";
+import importFresh from "../../../utils/import-fresh";
 
 const { ROOT_DIR } = grabDirNames();
 
@@ -28,7 +29,7 @@ export default async function grabPageBundledReactComponent({
                 global.BUNEXT_SSR_BUNDLER_CTX_MAP[relative_path].path,
             );
             // Loader.registry.delete(abs);
-            const mod = await import(`${abs}?t=${Date.now()}`);
+            const mod = await importFresh(abs);
 
             const Main = mod.default as FC;
 

src/functions/server/web-pages/grab-page-combined-server-res.ts

@@ -11,6 +11,7 @@ import grabPageServerPath from "./grab-page-server-path";
 import path from "path";
 import grabDirNames from "../../../utils/grab-dir-names";
 import grabRelativePath from "../../../utils/grab-relative-path";
+import importFresh from "../../../utils/import-fresh";
 
 const { ROOT_DIR } = grabDirNames();
 
@@ -29,8 +30,6 @@ export default async function grabPageCombinedServerRes({
     query,
     routeParams,
 }: Params) {
-    const now = Date.now();
-
     const { root_file_path } = grabRootFilePath();
     const { server_file_path: root_server_file_path } = root_file_path
         ? grabPageServerPath({ file_path: root_file_path })
@@ -48,8 +47,9 @@ export default async function grabPageCombinedServerRes({
     if (final_root_server_path) {
         // Loader.registry.delete(final_root_server_path);
     }
-    const root_server_module: BunextPageServerModule = final_root_server_path
-        ? await import(`${final_root_server_path}?t=${now}`)
+    const root_server_module: BunextPageServerModule | undefined =
+        final_root_server_path
+        ? await importFresh(final_root_server_path)
         : undefined;
 
     const root_server_fn =
@@ -78,8 +78,9 @@ export default async function grabPageCombinedServerRes({
     if (final_page_server_path) {
         // Loader.registry.delete(final_page_server_path);
     }
-    const server_module: BunextPageServerModule = final_page_server_path
-        ? await import(`${final_page_server_path}?t=${now}`)
+    const server_module: BunextPageServerModule | undefined =
+        final_page_server_path
+        ? await importFresh(final_page_server_path)
         : undefined;
 
     const server_fn = server_module?.default || server_module?.server;

src/functions/server/web-pages/grab-page-modules.tsx

@@ -10,6 +10,7 @@ import { log } from "../../../utils/log";
 import grabRootFilePath from "./grab-root-file-path";
 import grabPageCombinedServerRes from "./grab-page-combined-server-res";
 import type { FC } from "react";
+import importFresh from "../../../utils/import-fresh";
 
 type Params = {
     file_path: string;
@@ -35,8 +36,6 @@ export default async function grabPageModules({
     routeParams,
     skip_server_res,
 }: Params): Promise<Return | Response> {
-    const now = Date.now();
-
     const { serverRes } = skip_server_res
         ? {}
         : await grabPageCombinedServerRes({
@@ -77,10 +76,10 @@ export default async function grabPageModules({
     const { root_file_path } = grabRootFilePath();
     const root_module: BunextRootModule | undefined = !root_file_path
         ? undefined
-        : bundled_root_module || (await import(`${root_file_path}?t=${now}`));
+        : bundled_root_module || (await importFresh(root_file_path));
 
     const module: BunextPageModule =
-        page_module || (await import(`${file_path}?t=${now}`));
+        page_module || (await importFresh(file_path));
 
     if (debug) {
         log.info(`module:`, module);

src/utils/import-fresh.ts

@@ -0,0 +1,13 @@
+import isDevelopment from "./is-development";
+
+/**
+ * Dev: bypass Bun's module registry so rebuilt files are picked up.
+ * Prod: import by stable path so each module is loaded (and kept) once.
+ * A unique `?t=` per call creates a new, never-evicted module record, so
+ * using it in production leaks memory on every request.
+ */
+export default function importFresh<T = any>(file_path: string): Promise<T> {
+    return import(
+        isDevelopment() ? `${file_path}?t=${Date.now()}` : file_path
+    );
+}