@tanstack/start-plugin-core 1.167.31 → 1.167.33

package/dist/esm/index.d.ts

@@ -1,6 +1,7 @@
 export type { TanStackStartInputConfig } from './schema.js';
 export type { TanStackStartCoreOptions } from './types.js';
-export type { TanStackStartVitePluginCoreOptions } from './vite/types.js';
+export type { TanStackStartVitePluginCoreOptions, ViteRscForwardSsrResolverStrategy, } from './vite/types.js';
 export type { TanStackStartViteInputConfig } from './vite/schema.js';
 export { START_ENVIRONMENT_NAMES, VITE_ENVIRONMENT_NAMES } from './constants.js';
+export { createVirtualModule } from './vite/createVirtualModule.js';
 export { tanStackStartVite } from './vite/plugin.js';

package/dist/esm/index.js

@@ -1,3 +1,4 @@
 import { START_ENVIRONMENT_NAMES, VITE_ENVIRONMENT_NAMES } from "./constants.js";
+import { createVirtualModule } from "./vite/createVirtualModule.js";
 import { tanStackStartVite } from "./vite/plugin.js";
-export { START_ENVIRONMENT_NAMES, VITE_ENVIRONMENT_NAMES, tanStackStartVite };
+export { START_ENVIRONMENT_NAMES, VITE_ENVIRONMENT_NAMES, createVirtualModule, tanStackStartVite };

package/dist/esm/vite/createVirtualModule.d.ts

@@ -0,0 +1,12 @@
+import { Plugin } from 'vite';
+type VirtualModuleLoadHandler = (this: any, id: string) => string | null | undefined | Promise<string | null | undefined>;
+export declare function createVirtualModule(opts: {
+    name: string;
+    moduleId: string;
+    load: VirtualModuleLoadHandler;
+    apply?: Plugin['apply'];
+    applyToEnvironment?: Plugin['applyToEnvironment'];
+    enforce?: Plugin['enforce'];
+    sharedDuringBuild?: boolean;
+}): Plugin;
+export {};

package/dist/esm/vite/createVirtualModule.js

@@ -0,0 +1,32 @@
+import { resolveViteId } from "../utils.js";
+//#region src/vite/createVirtualModule.ts
+function escapeRegExp(value) {
+	return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function createVirtualModule(opts) {
+	const resolvedId = resolveViteId(opts.moduleId.replaceAll("#", "%23"));
+	return {
+		name: opts.name,
+		apply: opts.apply,
+		applyToEnvironment: opts.applyToEnvironment,
+		enforce: opts.enforce,
+		sharedDuringBuild: opts.sharedDuringBuild,
+		resolveId: {
+			filter: { id: new RegExp(escapeRegExp(opts.moduleId)) },
+			handler(id) {
+				if (id === opts.moduleId) return resolvedId;
+			}
+		},
+		load: {
+			filter: { id: new RegExp(escapeRegExp(resolvedId)) },
+			handler(id) {
+				if (id !== resolvedId) return;
+				return opts.load.call(this, id);
+			}
+		}
+	};
+}
+//#endregion
+export { createVirtualModule };
+
+//# sourceMappingURL=createVirtualModule.js.map

package/dist/esm/vite/createVirtualModule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createVirtualModule.js","names":[],"sources":["../../../src/vite/createVirtualModule.ts"],"sourcesContent":["import { resolveViteId } from '../utils'\nimport type { Plugin } from 'vite'\n\ntype VirtualModuleLoadHandler = (\n  this: any,\n  id: string,\n) => string | null | undefined | Promise<string | null | undefined>\n\nfunction escapeRegExp(value: string): string {\n  return value.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n}\n\nexport function createVirtualModule(opts: {\n  name: string\n  moduleId: string\n  load: VirtualModuleLoadHandler\n  apply?: Plugin['apply']\n  applyToEnvironment?: Plugin['applyToEnvironment']\n  enforce?: Plugin['enforce']\n  sharedDuringBuild?: boolean\n}): Plugin {\n  // Encode '#' as '%23' in the resolved ID to avoid browser treating it as URL fragment.\n  // The browser requests /@id/__x00__%23tanstack-start-plugin-adapters instead of\n  // /@id/__x00__#tanstack-start-plugin-adapters (which would truncate at #).\n  const resolvedId = resolveViteId(opts.moduleId.replaceAll('#', '%23'))\n\n  return {\n    name: opts.name,\n    apply: opts.apply,\n    applyToEnvironment: opts.applyToEnvironment,\n    enforce: opts.enforce,\n    sharedDuringBuild: opts.sharedDuringBuild,\n    resolveId: {\n      filter: { id: new RegExp(escapeRegExp(opts.moduleId)) },\n      handler(id) {\n        if (id === opts.moduleId) {\n          return resolvedId\n        }\n\n        return undefined\n      },\n    },\n    load: {\n      filter: { id: new RegExp(escapeRegExp(resolvedId)) },\n      handler(id) {\n        if (id !== resolvedId) {\n          return undefined\n        }\n\n        return opts.load.call(this, id)\n      },\n    },\n  }\n}\n"],"mappings":";;AAQA,SAAS,aAAa,OAAuB;AAC3C,QAAO,MAAM,QAAQ,uBAAuB,OAAO;;AAGrD,SAAgB,oBAAoB,MAQzB;CAIT,MAAM,aAAa,cAAc,KAAK,SAAS,WAAW,KAAK,MAAM,CAAC;AAEtE,QAAO;EACL,MAAM,KAAK;EACX,OAAO,KAAK;EACZ,oBAAoB,KAAK;EACzB,SAAS,KAAK;EACd,mBAAmB,KAAK;EACxB,WAAW;GACT,QAAQ,EAAE,IAAI,IAAI,OAAO,aAAa,KAAK,SAAS,CAAC,EAAE;GACvD,QAAQ,IAAI;AACV,QAAI,OAAO,KAAK,SACd,QAAO;;GAKZ;EACD,MAAM;GACJ,QAAQ,EAAE,IAAI,IAAI,OAAO,aAAa,WAAW,CAAC,EAAE;GACpD,QAAQ,IAAI;AACV,QAAI,OAAO,WACT;AAGF,WAAO,KAAK,KAAK,KAAK,MAAM,GAAG;;GAElC;EACF"}

package/dist/esm/vite/dev-server-plugin/plugin.js

@@ -1,5 +1,5 @@
 import { ENTRY_POINTS, VITE_ENVIRONMENT_NAMES } from "../../constants.js";
-import { resolveViteId } from "../../utils.js";
+import { createVirtualModule } from "../createVirtualModule.js";
 import { extractHtmlScripts } from "./extract-html-scripts.js";
 import { CSS_MODULES_REGEX, collectDevStyles, normalizeCssModuleCacheKey } from "./dev-styles.js";
 import { isRunnableDevEnvironment } from "vite";
@@ -105,24 +105,16 @@ function devServerPlugin({ getConfig: _getConfig, devSsrStylesEnabled, installDe
 				});
 			};
 		}
-	}, {
+	}, createVirtualModule({
 		name: "tanstack-start-core:dev-server:injected-head-scripts",
 		sharedDuringBuild: true,
 		applyToEnvironment: (env) => env.config.consumer === "server",
-		resolveId: {
-			filter: { id: new RegExp(VIRTUAL_MODULES.injectedHeadScripts) },
-			handler(_id) {
-				return resolveViteId(VIRTUAL_MODULES.injectedHeadScripts);
-			}
-		},
-		load: {
-			filter: { id: new RegExp(resolveViteId(VIRTUAL_MODULES.injectedHeadScripts)) },
-			handler() {
-				return `
+		moduleId: VIRTUAL_MODULES.injectedHeadScripts,
+		load() {
+			return `
         export const injectedHeadScripts = ${JSON.stringify(injectedHeadScripts) || "undefined"}`;
-			}
 		}
-	}];
+	})];
 }
 /**
 * Formats error for SSR message in error overlay

package/dist/esm/vite/dev-server-plugin/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","names":[],"sources":["../../../../src/vite/dev-server-plugin/plugin.ts"],"sourcesContent":["import { isRunnableDevEnvironment } from 'vite'\nimport { VIRTUAL_MODULES } from '@tanstack/start-server-core'\nimport { NodeRequest, sendNodeResponse } from 'srvx/node'\nimport { ENTRY_POINTS, VITE_ENVIRONMENT_NAMES } from '../../constants'\nimport { resolveViteId } from '../../utils'\nimport { extractHtmlScripts } from './extract-html-scripts'\nimport {\n  CSS_MODULES_REGEX,\n  collectDevStyles,\n  normalizeCssModuleCacheKey,\n} from './dev-styles'\nimport type { Connect, DevEnvironment, PluginOption } from 'vite'\nimport type { GetConfigFn } from '../../types'\n\nexport function devServerPlugin({\n  getConfig: _getConfig,\n  devSsrStylesEnabled,\n  installDevServerMiddleware,\n}: {\n  getConfig: GetConfigFn\n  devSsrStylesEnabled: boolean\n  installDevServerMiddleware: boolean | undefined\n}): PluginOption {\n  let isTest = false\n\n  let injectedHeadScripts: string | undefined\n\n  // Cache CSS modules content during transform hook.\n  // For CSS modules, the transform hook receives the raw CSS content before\n  // Vite wraps it in JS. We capture this to use during SSR style collection.\n  const cssModulesCache: Record<string, string> = {}\n\n  return [\n    {\n      name: 'tanstack-start-core:dev-server',\n      config(_userConfig, { mode }) {\n        isTest = isTest ? isTest : mode === 'test'\n      },\n      // Capture CSS modules content during transform\n      transform: {\n        filter: {\n          id: CSS_MODULES_REGEX,\n        },\n        handler(code, id) {\n          cssModulesCache[normalizeCssModuleCacheKey(id)] = code\n        },\n      },\n      async configureServer(viteDevServer) {\n        if (isTest) {\n          return\n        }\n\n        // Extract the scripts that Vite plugins would inject into the initial HTML\n        const templateHtml = `<html><head></head><body></body></html>`\n        const transformedHtml = await viteDevServer.transformIndexHtml(\n          '/',\n          templateHtml,\n        )\n        const scripts = extractHtmlScripts(transformedHtml)\n        injectedHeadScripts = scripts\n          .flatMap((script) => script.content ?? [])\n          .join(';')\n\n        // CSS middleware registered in PRE-PHASE (before Vite's internal middlewares)\n        // This ensures it handles /@tanstack-start/styles.css before any catch-all middleware\n        // from other plugins (like nitro) that may be registered in the post-phase.\n        // This makes the CSS endpoint work regardless of plugin order in the Vite config.\n        // We check pathname.endsWith() to handle basepaths (e.g., /my-app/@tanstack-start/styles.css)\n        // since pre-phase runs before Vite's base middleware strips the basepath.\n        if (devSsrStylesEnabled) {\n          viteDevServer.middlewares.use(async (req, res, next) => {\n            const url = req.url ?? ''\n            const pathname = url.split('?')[0]\n            if (!pathname?.endsWith('/@tanstack-start/styles.css')) {\n              return next()\n            }\n\n            try {\n              // Parse route IDs from query param\n              const urlObj = new URL(url, 'http://localhost')\n              const routesParam = urlObj.searchParams.get('routes')\n              const routeIds = routesParam ? routesParam.split(',') : []\n\n              // Build entries list from route file paths\n              const entries: Array<string> = []\n\n              // Look up route file paths from manifest\n              // Only routes registered in the manifest are used - this prevents path injection\n              const routesManifest = (globalThis as any).TSS_ROUTES_MANIFEST as\n                | Record<string, { filePath: string; children?: Array<string> }>\n                | undefined\n\n              if (routesManifest && routeIds.length > 0) {\n                for (const routeId of routeIds) {\n                  const route = routesManifest[routeId]\n                  if (route?.filePath) {\n                    entries.push(route.filePath)\n                  }\n                }\n              }\n\n              const css =\n                entries.length > 0\n                  ? await collectDevStyles({\n                      viteDevServer,\n                      entries,\n                      cssModulesCache,\n                    })\n                  : undefined\n\n              res.setHeader('Content-Type', 'text/css')\n              res.setHeader('Cache-Control', 'no-store')\n              res.end(css ?? '')\n            } catch (e) {\n              // Log error but still return valid CSS response to avoid MIME type issues\n              console.error('[tanstack-start] Error collecting dev styles:', e)\n              res.setHeader('Content-Type', 'text/css')\n              res.setHeader('Cache-Control', 'no-store')\n              res.end(\n                `/* Error collecting styles: ${e instanceof Error ? e.message : String(e)} */`,\n              )\n            }\n          })\n        }\n\n        return () => {\n          const serverEnv = viteDevServer.environments[\n            VITE_ENVIRONMENT_NAMES.server\n          ] as DevEnvironment | undefined\n\n          if (!serverEnv) {\n            throw new Error(\n              `Server environment ${VITE_ENVIRONMENT_NAMES.server} not found`,\n            )\n          }\n\n          const installMiddleware = installDevServerMiddleware\n          if (installMiddleware === false) {\n            return\n          }\n          if (installMiddleware == undefined) {\n            // do not install middleware in middlewareMode by default\n            if (viteDevServer.config.server.middlewareMode) {\n              return\n            }\n\n            // do not install middleware if SSR env in case another plugin already did\n            if (\n              !isRunnableDevEnvironment(serverEnv) ||\n              // do not check via `isFetchableDevEnvironment` since nitro does implement the `FetchableDevEnvironment` interface but not via inheritance (which this helper checks)\n              'dispatchFetch' in serverEnv\n            ) {\n              return\n            }\n          }\n\n          if (!isRunnableDevEnvironment(serverEnv)) {\n            throw new Error(\n              'cannot install vite dev server middleware for TanStack Start since the SSR environment is not a RunnableDevEnvironment',\n            )\n          }\n\n          viteDevServer.middlewares.use(async (req, res) => {\n            // fix the request URL to match the original URL\n            // otherwise, the request URL will '/index.html'\n            if (req.originalUrl) {\n              req.url = req.originalUrl\n            }\n            const webReq = new NodeRequest({ req, res })\n\n            try {\n              // Import and resolve the request by running the server request entry point\n              // this request entry point must implement the `fetch` API as follows:\n              /**\n               * export default {\n               *  fetch(req: Request): Promise<Response>\n               * }\n               */\n              const serverEntry = await serverEnv.runner.import(\n                ENTRY_POINTS.server,\n              )\n              const webRes = await serverEntry['default'].fetch(webReq)\n\n              return sendNodeResponse(res, webRes)\n            } catch (e) {\n              console.error(e)\n              try {\n                viteDevServer.ssrFixStacktrace(e as Error)\n              } catch {}\n\n              if (\n                webReq.headers.get('content-type')?.includes('application/json')\n              ) {\n                return sendNodeResponse(\n                  res,\n                  new Response(\n                    JSON.stringify(\n                      {\n                        status: 500,\n                        error: 'Internal Server Error',\n                        message:\n                          'An unexpected error occurred. Please try again later.',\n                        timestamp: new Date().toISOString(),\n                      },\n                      null,\n                      2,\n                    ),\n                    {\n                      status: 500,\n                      headers: {\n                        'Content-Type': 'application/json',\n                      },\n                    },\n                  ),\n                )\n              }\n\n              return sendNodeResponse(\n                res,\n                new Response(\n                  `\n              <!DOCTYPE html>\n              <html lang=\"en\">\n                <head>\n                  <meta charset=\"UTF-8\" />\n                  <title>Error</title>\n                  <script type=\"module\">\n                    import { ErrorOverlay } from '/@vite/client'\n                    document.body.appendChild(new ErrorOverlay(${JSON.stringify(\n                      prepareError(req, e),\n                    ).replace(/</g, '\\\\u003c')}))\n                  </script>\n                </head>\n                <body>\n                </body>\n              </html>\n            `,\n                  {\n                    status: 500,\n                    headers: {\n                      'Content-Type': 'text/html',\n                    },\n                  },\n                ),\n              )\n            }\n          })\n        }\n      },\n    },\n    {\n      name: 'tanstack-start-core:dev-server:injected-head-scripts',\n      sharedDuringBuild: true,\n      applyToEnvironment: (env) => env.config.consumer === 'server',\n      resolveId: {\n        filter: { id: new RegExp(VIRTUAL_MODULES.injectedHeadScripts) },\n        handler(_id) {\n          return resolveViteId(VIRTUAL_MODULES.injectedHeadScripts)\n        },\n      },\n      load: {\n        filter: {\n          id: new RegExp(resolveViteId(VIRTUAL_MODULES.injectedHeadScripts)),\n        },\n        handler() {\n          const mod = `\n        export const injectedHeadScripts = ${JSON.stringify(injectedHeadScripts) || 'undefined'}`\n          return mod\n        },\n      },\n    },\n  ]\n}\n\n/**\n * Formats error for SSR message in error overlay\n * @param req\n * @param error\n * @returns\n */\nfunction prepareError(req: Connect.IncomingMessage, error: unknown) {\n  const e = error as Error\n  return {\n    message: `An error occurred while server rendering ${req.url}:\\n\\n\\t${\n      typeof e === 'string' ? e : e.message\n    } `,\n    stack: typeof e === 'string' ? '' : e.stack,\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"plugin.js","names":[],"sources":["../../../../src/vite/dev-server-plugin/plugin.ts"],"sourcesContent":["import { isRunnableDevEnvironment } from 'vite'\nimport { VIRTUAL_MODULES } from '@tanstack/start-server-core'\nimport { NodeRequest, sendNodeResponse } from 'srvx/node'\nimport { ENTRY_POINTS, VITE_ENVIRONMENT_NAMES } from '../../constants'\nimport { createVirtualModule } from '../createVirtualModule'\nimport { extractHtmlScripts } from './extract-html-scripts'\nimport {\n  CSS_MODULES_REGEX,\n  collectDevStyles,\n  normalizeCssModuleCacheKey,\n} from './dev-styles'\nimport type { Connect, DevEnvironment, PluginOption } from 'vite'\nimport type { GetConfigFn } from '../../types'\n\nexport function devServerPlugin({\n  getConfig: _getConfig,\n  devSsrStylesEnabled,\n  installDevServerMiddleware,\n}: {\n  getConfig: GetConfigFn\n  devSsrStylesEnabled: boolean\n  installDevServerMiddleware: boolean | undefined\n}): PluginOption {\n  let isTest = false\n\n  let injectedHeadScripts: string | undefined\n\n  // Cache CSS modules content during transform hook.\n  // For CSS modules, the transform hook receives the raw CSS content before\n  // Vite wraps it in JS. We capture this to use during SSR style collection.\n  const cssModulesCache: Record<string, string> = {}\n\n  return [\n    {\n      name: 'tanstack-start-core:dev-server',\n      config(_userConfig, { mode }) {\n        isTest = isTest ? isTest : mode === 'test'\n      },\n      // Capture CSS modules content during transform\n      transform: {\n        filter: {\n          id: CSS_MODULES_REGEX,\n        },\n        handler(code, id) {\n          cssModulesCache[normalizeCssModuleCacheKey(id)] = code\n        },\n      },\n      async configureServer(viteDevServer) {\n        if (isTest) {\n          return\n        }\n\n        // Extract the scripts that Vite plugins would inject into the initial HTML\n        const templateHtml = `<html><head></head><body></body></html>`\n        const transformedHtml = await viteDevServer.transformIndexHtml(\n          '/',\n          templateHtml,\n        )\n        const scripts = extractHtmlScripts(transformedHtml)\n        injectedHeadScripts = scripts\n          .flatMap((script) => script.content ?? [])\n          .join(';')\n\n        // CSS middleware registered in PRE-PHASE (before Vite's internal middlewares)\n        // This ensures it handles /@tanstack-start/styles.css before any catch-all middleware\n        // from other plugins (like nitro) that may be registered in the post-phase.\n        // This makes the CSS endpoint work regardless of plugin order in the Vite config.\n        // We check pathname.endsWith() to handle basepaths (e.g., /my-app/@tanstack-start/styles.css)\n        // since pre-phase runs before Vite's base middleware strips the basepath.\n        if (devSsrStylesEnabled) {\n          viteDevServer.middlewares.use(async (req, res, next) => {\n            const url = req.url ?? ''\n            const pathname = url.split('?')[0]\n            if (!pathname?.endsWith('/@tanstack-start/styles.css')) {\n              return next()\n            }\n\n            try {\n              // Parse route IDs from query param\n              const urlObj = new URL(url, 'http://localhost')\n              const routesParam = urlObj.searchParams.get('routes')\n              const routeIds = routesParam ? routesParam.split(',') : []\n\n              // Build entries list from route file paths\n              const entries: Array<string> = []\n\n              // Look up route file paths from manifest\n              // Only routes registered in the manifest are used - this prevents path injection\n              const routesManifest = (globalThis as any).TSS_ROUTES_MANIFEST as\n                | Record<string, { filePath: string; children?: Array<string> }>\n                | undefined\n\n              if (routesManifest && routeIds.length > 0) {\n                for (const routeId of routeIds) {\n                  const route = routesManifest[routeId]\n                  if (route?.filePath) {\n                    entries.push(route.filePath)\n                  }\n                }\n              }\n\n              const css =\n                entries.length > 0\n                  ? await collectDevStyles({\n                      viteDevServer,\n                      entries,\n                      cssModulesCache,\n                    })\n                  : undefined\n\n              res.setHeader('Content-Type', 'text/css')\n              res.setHeader('Cache-Control', 'no-store')\n              res.end(css ?? '')\n            } catch (e) {\n              // Log error but still return valid CSS response to avoid MIME type issues\n              console.error('[tanstack-start] Error collecting dev styles:', e)\n              res.setHeader('Content-Type', 'text/css')\n              res.setHeader('Cache-Control', 'no-store')\n              res.end(\n                `/* Error collecting styles: ${e instanceof Error ? e.message : String(e)} */`,\n              )\n            }\n          })\n        }\n\n        return () => {\n          const serverEnv = viteDevServer.environments[\n            VITE_ENVIRONMENT_NAMES.server\n          ] as DevEnvironment | undefined\n\n          if (!serverEnv) {\n            throw new Error(\n              `Server environment ${VITE_ENVIRONMENT_NAMES.server} not found`,\n            )\n          }\n\n          const installMiddleware = installDevServerMiddleware\n          if (installMiddleware === false) {\n            return\n          }\n          if (installMiddleware == undefined) {\n            // do not install middleware in middlewareMode by default\n            if (viteDevServer.config.server.middlewareMode) {\n              return\n            }\n\n            // do not install middleware if SSR env in case another plugin already did\n            if (\n              !isRunnableDevEnvironment(serverEnv) ||\n              // do not check via `isFetchableDevEnvironment` since nitro does implement the `FetchableDevEnvironment` interface but not via inheritance (which this helper checks)\n              'dispatchFetch' in serverEnv\n            ) {\n              return\n            }\n          }\n\n          if (!isRunnableDevEnvironment(serverEnv)) {\n            throw new Error(\n              'cannot install vite dev server middleware for TanStack Start since the SSR environment is not a RunnableDevEnvironment',\n            )\n          }\n\n          viteDevServer.middlewares.use(async (req, res) => {\n            // fix the request URL to match the original URL\n            // otherwise, the request URL will '/index.html'\n            if (req.originalUrl) {\n              req.url = req.originalUrl\n            }\n            const webReq = new NodeRequest({ req, res })\n\n            try {\n              // Import and resolve the request by running the server request entry point\n              // this request entry point must implement the `fetch` API as follows:\n              /**\n               * export default {\n               *  fetch(req: Request): Promise<Response>\n               * }\n               */\n              const serverEntry = await serverEnv.runner.import(\n                ENTRY_POINTS.server,\n              )\n              const webRes = await serverEntry['default'].fetch(webReq)\n\n              return sendNodeResponse(res, webRes)\n            } catch (e) {\n              console.error(e)\n              try {\n                viteDevServer.ssrFixStacktrace(e as Error)\n              } catch {}\n\n              if (\n                webReq.headers.get('content-type')?.includes('application/json')\n              ) {\n                return sendNodeResponse(\n                  res,\n                  new Response(\n                    JSON.stringify(\n                      {\n                        status: 500,\n                        error: 'Internal Server Error',\n                        message:\n                          'An unexpected error occurred. Please try again later.',\n                        timestamp: new Date().toISOString(),\n                      },\n                      null,\n                      2,\n                    ),\n                    {\n                      status: 500,\n                      headers: {\n                        'Content-Type': 'application/json',\n                      },\n                    },\n                  ),\n                )\n              }\n\n              return sendNodeResponse(\n                res,\n                new Response(\n                  `\n              <!DOCTYPE html>\n              <html lang=\"en\">\n                <head>\n                  <meta charset=\"UTF-8\" />\n                  <title>Error</title>\n                  <script type=\"module\">\n                    import { ErrorOverlay } from '/@vite/client'\n                    document.body.appendChild(new ErrorOverlay(${JSON.stringify(\n                      prepareError(req, e),\n                    ).replace(/</g, '\\\\u003c')}))\n                  </script>\n                </head>\n                <body>\n                </body>\n              </html>\n            `,\n                  {\n                    status: 500,\n                    headers: {\n                      'Content-Type': 'text/html',\n                    },\n                  },\n                ),\n              )\n            }\n          })\n        }\n      },\n    },\n    createVirtualModule({\n      name: 'tanstack-start-core:dev-server:injected-head-scripts',\n      sharedDuringBuild: true,\n      applyToEnvironment: (env) => env.config.consumer === 'server',\n      moduleId: VIRTUAL_MODULES.injectedHeadScripts,\n      load() {\n        const mod = `\n        export const injectedHeadScripts = ${JSON.stringify(injectedHeadScripts) || 'undefined'}`\n        return mod\n      },\n    }),\n  ]\n}\n\n/**\n * Formats error for SSR message in error overlay\n * @param req\n * @param error\n * @returns\n */\nfunction prepareError(req: Connect.IncomingMessage, error: unknown) {\n  const e = error as Error\n  return {\n    message: `An error occurred while server rendering ${req.url}:\\n\\n\\t${\n      typeof e === 'string' ? e : e.message\n    } `,\n    stack: typeof e === 'string' ? '' : e.stack,\n  }\n}\n"],"mappings":";;;;;;;;AAcA,SAAgB,gBAAgB,EAC9B,WAAW,YACX,qBACA,8BAKe;CACf,IAAI,SAAS;CAEb,IAAI;CAKJ,MAAM,kBAA0C,EAAE;AAElD,QAAO,CACL;EACE,MAAM;EACN,OAAO,aAAa,EAAE,QAAQ;AAC5B,YAAS,SAAS,SAAS,SAAS;;EAGtC,WAAW;GACT,QAAQ,EACN,IAAI,mBACL;GACD,QAAQ,MAAM,IAAI;AAChB,oBAAgB,2BAA2B,GAAG,IAAI;;GAErD;EACD,MAAM,gBAAgB,eAAe;AACnC,OAAI,OACF;AAUF,yBADgB,mBAJQ,MAAM,cAAc,mBAC1C,KAFmB,0CAIpB,CACkD,CAEhD,SAAS,WAAW,OAAO,WAAW,EAAE,CAAC,CACzC,KAAK,IAAI;AAQZ,OAAI,oBACF,eAAc,YAAY,IAAI,OAAO,KAAK,KAAK,SAAS;IACtD,MAAM,MAAM,IAAI,OAAO;AAEvB,QAAI,CADa,IAAI,MAAM,IAAI,CAAC,IACjB,SAAS,8BAA8B,CACpD,QAAO,MAAM;AAGf,QAAI;KAGF,MAAM,cADS,IAAI,IAAI,KAAK,mBAAmB,CACpB,aAAa,IAAI,SAAS;KACrD,MAAM,WAAW,cAAc,YAAY,MAAM,IAAI,GAAG,EAAE;KAG1D,MAAM,UAAyB,EAAE;KAIjC,MAAM,iBAAkB,WAAmB;AAI3C,SAAI,kBAAkB,SAAS,SAAS,EACtC,MAAK,MAAM,WAAW,UAAU;MAC9B,MAAM,QAAQ,eAAe;AAC7B,UAAI,OAAO,SACT,SAAQ,KAAK,MAAM,SAAS;;KAKlC,MAAM,MACJ,QAAQ,SAAS,IACb,MAAM,iBAAiB;MACrB;MACA;MACA;MACD,CAAC,GACF,KAAA;AAEN,SAAI,UAAU,gBAAgB,WAAW;AACzC,SAAI,UAAU,iBAAiB,WAAW;AAC1C,SAAI,IAAI,OAAO,GAAG;aACX,GAAG;AAEV,aAAQ,MAAM,iDAAiD,EAAE;AACjE,SAAI,UAAU,gBAAgB,WAAW;AACzC,SAAI,UAAU,iBAAiB,WAAW;AAC1C,SAAI,IACF,+BAA+B,aAAa,QAAQ,EAAE,UAAU,OAAO,EAAE,CAAC,KAC3E;;KAEH;AAGJ,gBAAa;IACX,MAAM,YAAY,cAAc,aAC9B,uBAAuB;AAGzB,QAAI,CAAC,UACH,OAAM,IAAI,MACR,sBAAsB,uBAAuB,OAAO,YACrD;IAGH,MAAM,oBAAoB;AAC1B,QAAI,sBAAsB,MACxB;AAEF,QAAI,qBAAqB,KAAA,GAAW;AAElC,SAAI,cAAc,OAAO,OAAO,eAC9B;AAIF,SACE,CAAC,yBAAyB,UAAU,IAEpC,mBAAmB,UAEnB;;AAIJ,QAAI,CAAC,yBAAyB,UAAU,CACtC,OAAM,IAAI,MACR,yHACD;AAGH,kBAAc,YAAY,IAAI,OAAO,KAAK,QAAQ;AAGhD,SAAI,IAAI,YACN,KAAI,MAAM,IAAI;KAEhB,MAAM,SAAS,IAAI,YAAY;MAAE;MAAK;MAAK,CAAC;AAE5C,SAAI;AAaF,aAAO,iBAAiB,KAFT,OAHK,MAAM,UAAU,OAAO,OACzC,aAAa,OACd,EACgC,WAAW,MAAM,OAAO,CAErB;cAC7B,GAAG;AACV,cAAQ,MAAM,EAAE;AAChB,UAAI;AACF,qBAAc,iBAAiB,EAAW;cACpC;AAER,UACE,OAAO,QAAQ,IAAI,eAAe,EAAE,SAAS,mBAAmB,CAEhE,QAAO,iBACL,KACA,IAAI,SACF,KAAK,UACH;OACE,QAAQ;OACR,OAAO;OACP,SACE;OACF,4BAAW,IAAI,MAAM,EAAC,aAAa;OACpC,EACD,MACA,EACD,EACD;OACE,QAAQ;OACR,SAAS,EACP,gBAAgB,oBACjB;OACF,CACF,CACF;AAGH,aAAO,iBACL,KACA,IAAI,SACF;;;;;;;;iEAQ+C,KAAK,UAChD,aAAa,KAAK,EAAE,CACrB,CAAC,QAAQ,MAAM,UAAU,CAAC;;;;;;eAO7B;OACE,QAAQ;OACR,SAAS,EACP,gBAAgB,aACjB;OACF,CACF,CACF;;MAEH;;;EAGP,EACD,oBAAoB;EAClB,MAAM;EACN,mBAAmB;EACnB,qBAAqB,QAAQ,IAAI,OAAO,aAAa;EACrD,UAAU,gBAAgB;EAC1B,OAAO;AAGL,UAFY;6CACyB,KAAK,UAAU,oBAAoB,IAAI;;EAG/E,CAAC,CACH;;;;;;;;AASH,SAAS,aAAa,KAA8B,OAAgB;CAClE,MAAM,IAAI;AACV,QAAO;EACL,SAAS,4CAA4C,IAAI,IAAI,SAC3D,OAAO,MAAM,WAAW,IAAI,EAAE,QAC/B;EACD,OAAO,OAAO,MAAM,WAAW,KAAK,EAAE;EACvC"}

package/dist/esm/vite/plugin.js

@@ -8,7 +8,7 @@ import { buildStartViteEnvironments, createViteConfigPlan, createViteDefineConfi
 import { devServerPlugin } from "./dev-server-plugin/plugin.js";
 import { getClientOutputDirectory, getServerOutputDirectory } from "./output-directory.js";
 import { previewServerPlugin } from "./preview-server-plugin/plugin.js";
-import { createCaptureClientBuildPlugin, createDevBaseRewritePlugin, createPostBuildPlugin } from "./plugins.js";
+import { createCaptureClientBuildPlugin, createDevBaseRewritePlugin, createPostBuildPlugin, createVirtualClientEntryPlugin } from "./plugins.js";
 import { parseStartConfig } from "./schema.js";
 import { startManifestPlugin } from "./start-manifest-plugin/plugin.js";
 import { tanStackStartRouter } from "./start-router-plugin/plugin.js";
@@ -139,6 +139,7 @@ function tanStackStartVite(corePluginOpts, startPluginOpts) {
 		}),
 		tanStackStartRouter(normalizedStartPluginOpts, getConfig, corePluginOpts),
 		loadEnvPlugin(),
+		createVirtualClientEntryPlugin({ getClientEntry: () => configContext.resolveEntries().entryPaths.client }),
 		startManifestPlugin({
 			getClientBuild: () => getClientBuild(START_ENVIRONMENT_NAMES.client),
 			getConfig

package/dist/esm/vite/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","names":[],"sources":["../../../src/vite/plugin.ts"],"sourcesContent":["import { crawlFrameworkPkgs } from 'vitefu'\nimport {\n  applyResolvedBaseAndOutput,\n  applyResolvedRouterBasepath,\n  createStartConfigContext,\n} from '../config-context'\nimport { START_ENVIRONMENT_NAMES } from '../constants'\nimport { importProtectionPlugin } from '../import-protection-plugin/plugin'\nimport {\n  createServerFnBasePath,\n  normalizePublicBase,\n  shouldRewriteDevBasepath,\n} from '../planning'\nimport { startCompilerPlugin } from './start-compiler-plugin/plugin'\nimport { loadEnvPlugin } from './load-env-plugin/plugin'\nimport {\n  buildStartViteEnvironments,\n  createViteConfigPlan,\n  createViteDefineConfig,\n  createViteResolvedEntryAliases,\n} from './planning'\nimport { devServerPlugin } from './dev-server-plugin/plugin'\nimport { previewServerPlugin } from './preview-server-plugin/plugin'\nimport {\n  createCaptureClientBuildPlugin,\n  createDevBaseRewritePlugin,\n  createPostBuildPlugin,\n} from './plugins'\nimport { parseStartConfig } from './schema'\nimport { startManifestPlugin } from './start-manifest-plugin/plugin'\nimport { tanStackStartRouter } from './start-router-plugin/plugin'\nimport {\n  getClientOutputDirectory,\n  getServerOutputDirectory,\n} from './output-directory'\nimport { postServerBuild } from './post-server-build'\nimport { serializationAdaptersPlugin } from './serialization-adapters-plugin'\nimport type { NormalizedClientBuild } from '../types'\nimport type {\n  TanStackStartVitePluginCoreOptions,\n  ViteRscForwardSsrResolverStrategy,\n} from './types'\nimport type { StartEnvironmentName } from '../constants'\nimport type { TanStackStartViteInputConfig } from './schema'\nimport type { PluginOption } from 'vite'\n\nexport function tanStackStartVite(\n  corePluginOpts: TanStackStartVitePluginCoreOptions,\n  startPluginOpts: TanStackStartViteInputConfig | undefined,\n): Array<PluginOption> {\n  const normalizedStartPluginOpts = startPluginOpts ?? {}\n\n  const configContext = createStartConfigContext({\n    corePluginOpts,\n    startPluginOpts: normalizedStartPluginOpts,\n    parseConfig: parseStartConfig,\n  })\n  const { getConfig, resolvedStartConfig } = configContext\n  const serverFnProviderEnv = corePluginOpts.providerEnvironmentName\n  const ssrIsProvider = corePluginOpts.ssrIsProvider\n\n  // When the router basepath and vite base are misaligned during dev,\n  // we install a URL rewrite middleware instead of erroring.\n  let needsDevBaseRewrite = false\n\n  const capturedClientBuild: Partial<\n    Record<StartEnvironmentName, NormalizedClientBuild>\n  > = {}\n\n  function getClientBuild(\n    envName: StartEnvironmentName,\n  ): NormalizedClientBuild | undefined {\n    return capturedClientBuild[envName]\n  }\n\n  const environments: Array<{\n    name: string\n    type: 'client' | 'server'\n    getServerFnById?: string\n  }> = [\n    { name: START_ENVIRONMENT_NAMES.client, type: 'client' },\n    {\n      name: START_ENVIRONMENT_NAMES.server,\n      type: 'server',\n      getServerFnById:\n        corePluginOpts.ssrResolverStrategy.type === 'vite-rsc-forward'\n          ? createViteRscForwarder(corePluginOpts.ssrResolverStrategy)\n          : undefined,\n    },\n  ]\n  if (\n    serverFnProviderEnv !== START_ENVIRONMENT_NAMES.server &&\n    !environments.find((e) => e.name === serverFnProviderEnv)\n  ) {\n    environments.push({\n      name: serverFnProviderEnv,\n      type: 'server',\n    })\n  }\n  return [\n    {\n      name: 'tanstack-start-core:config',\n      enforce: 'pre',\n      async config(viteConfig, { command }) {\n        const publicBase = normalizePublicBase(viteConfig.base)\n        applyResolvedBaseAndOutput({\n          resolvedStartConfig,\n          root: viteConfig.root || process.cwd(),\n          publicBase,\n          clientOutputDirectory: getClientOutputDirectory(viteConfig),\n          serverOutputDirectory: getServerOutputDirectory(viteConfig),\n        })\n        const { startConfig } = getConfig()\n        const routerBasepath = applyResolvedRouterBasepath({\n          resolvedStartConfig,\n          startConfig,\n        })\n\n        if (\n          shouldRewriteDevBasepath({\n            command,\n            middlewareMode: Boolean(viteConfig.server?.middlewareMode),\n            routerBasepath,\n            publicBase: resolvedStartConfig.basePaths.publicBase,\n          })\n        ) {\n          // The router basepath and vite base are misaligned.\n          // Instead of erroring, we install a dev-server middleware that\n          // rewrites incoming request URLs to prepend the vite base prefix.\n          // This allows users to have e.g. base: '/_ui/' for asset URLs\n          // while keeping router basepath at '/' for page navigation.\n          needsDevBaseRewrite = true\n        }\n\n        const TSS_SERVER_FN_BASE = createServerFnBasePath({\n          routerBasepath,\n          serverFnBase: startConfig.serverFns.base,\n        })\n        const resolvedEntryPlan = configContext.resolveEntries()\n\n        const entryAliases = createViteResolvedEntryAliases({\n          entryPaths: resolvedEntryPlan.entryPaths,\n        })\n\n        const startPackageName =\n          `@tanstack/${corePluginOpts.framework}-start` as const\n\n        // crawl packages that have start in \"peerDependencies\"\n        // see https://github.com/svitejs/vitefu/blob/d8d82fa121e3b2215ba437107093c77bde51b63b/src/index.js#L95-L101\n\n        // this is currently uncached; could be implemented similarly as vite handles lock file changes\n        // see https://github.com/vitejs/vite/blob/557f797d29422027e8c451ca50dd84bf8c41b5f0/packages/vite/src/node/optimizer/index.ts#L1282\n\n        const crawlFrameworkPkgsResult = await crawlFrameworkPkgs({\n          root: process.cwd(),\n          isBuild: command === 'build',\n          isFrameworkPkgByJson(pkgJson) {\n            const peerDependencies = pkgJson['peerDependencies']\n\n            if (peerDependencies) {\n              if (\n                startPackageName in peerDependencies ||\n                '@tanstack/start-client-core' in peerDependencies\n              ) {\n                return true\n              }\n            }\n\n            return false\n          },\n        })\n\n        const viteConfigPlan = createViteConfigPlan({\n          viteConfig,\n          framework: corePluginOpts.framework,\n          entryAliases,\n          clientOutputDirectory: resolvedStartConfig.outputDirectories.client,\n          serverOutputDirectory: resolvedStartConfig.outputDirectories.server,\n          serverFnProviderEnv,\n          optimizeDepsExclude: crawlFrameworkPkgsResult.optimizeDeps.exclude,\n          noExternal: crawlFrameworkPkgsResult.ssr.noExternal.sort(),\n        })\n\n        return {\n          // see https://vite.dev/config/shared-options.html#apptype\n          // this will prevent vite from injecting middlewares that we don't want\n          appType: viteConfig.appType ?? 'custom',\n          environments: viteConfigPlan.environments,\n          resolve: viteConfigPlan.resolve,\n          define: createViteDefineConfig({\n            command,\n            mode: viteConfig.mode,\n            serverFnBase: TSS_SERVER_FN_BASE,\n            routerBasepath,\n            spaEnabled: startConfig.spa?.enabled,\n            devSsrStylesEnabled: startConfig.dev.ssrStyles.enabled,\n            devSsrStylesBasepath:\n              startConfig.dev.ssrStyles.basepath ??\n              resolvedStartConfig.basePaths.publicBase,\n            staticNodeEnv: startConfig.server.build.staticNodeEnv,\n          }),\n          builder: {\n            sharedPlugins: true,\n            async buildApp(builder) {\n              await buildStartViteEnvironments({\n                builder,\n                providerEnvironmentName: serverFnProviderEnv,\n                ssrIsProvider,\n              })\n            },\n          },\n        }\n      },\n    },\n    createPostBuildPlugin({\n      getConfig,\n      postServerBuild,\n    }),\n    // Server function plugin handles:\n    // 1. Identifying createServerFn().handler() calls\n    // 2. Extracting server functions to separate modules\n    // 3. Replacing call sites with RPC stubs\n    // 4. Generating the server function manifest\n    // Also handles createIsomorphicFn, createServerOnlyFn, createClientOnlyFn, createMiddleware\n    startCompilerPlugin({\n      framework: corePluginOpts.framework,\n      environments,\n      generateFunctionId:\n        normalizedStartPluginOpts.serverFns?.generateFunctionId,\n      providerEnvName: serverFnProviderEnv,\n    }),\n    importProtectionPlugin({\n      getConfig,\n      framework: corePluginOpts.framework,\n      environments,\n      providerEnvName: serverFnProviderEnv,\n    }),\n    tanStackStartRouter(normalizedStartPluginOpts, getConfig, corePluginOpts),\n    loadEnvPlugin(),\n    startManifestPlugin({\n      getClientBuild: () => getClientBuild(START_ENVIRONMENT_NAMES.client),\n      getConfig,\n    }),\n    // When the vite base and router basepath are misaligned (e.g. base: '/_ui/', basepath: '/'),\n    // install a middleware that rewrites incoming request URLs to prepend the vite base prefix.\n    // This allows Vite's internal base middleware to accept the requests, then strips the prefix\n    // before passing to the SSR handler.\n    // Registered BEFORE devServerPlugin so this middleware is added to the Connect stack first,\n    // ensuring all subsequent middlewares (CSS, SSR, etc.) see the rewritten URL.\n    createDevBaseRewritePlugin({\n      shouldRewriteDevBase: () => needsDevBaseRewrite,\n      resolvedStartConfig,\n    }),\n    devServerPlugin({\n      getConfig,\n      devSsrStylesEnabled:\n        normalizedStartPluginOpts.dev?.ssrStyles?.enabled ?? true,\n      installDevServerMiddleware:\n        normalizedStartPluginOpts.vite?.installDevServerMiddleware,\n    }),\n    previewServerPlugin(),\n    serializationAdaptersPlugin({\n      adapters: corePluginOpts.serializationAdapters,\n    }),\n    createCaptureClientBuildPlugin({\n      capturedClientBuild,\n    }),\n  ]\n}\n\nfunction createViteRscForwarder(strategy: ViteRscForwardSsrResolverStrategy) {\n  return `export async function getServerFnById(id, access) {\n  const m = await import.meta.viteRsc.loadModule(${JSON.stringify(strategy.sourceEnvironmentName)}, ${JSON.stringify(strategy.sourceEntry)})\n  return m[${JSON.stringify(strategy.exportName)}](id, access)\n}`\n}\n"],"mappings":"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"}
+{"version":3,"file":"plugin.js","names":[],"sources":["../../../src/vite/plugin.ts"],"sourcesContent":["import { crawlFrameworkPkgs } from 'vitefu'\nimport {\n  applyResolvedBaseAndOutput,\n  applyResolvedRouterBasepath,\n  createStartConfigContext,\n} from '../config-context'\nimport { START_ENVIRONMENT_NAMES } from '../constants'\nimport { importProtectionPlugin } from '../import-protection-plugin/plugin'\nimport {\n  createServerFnBasePath,\n  normalizePublicBase,\n  shouldRewriteDevBasepath,\n} from '../planning'\nimport { startCompilerPlugin } from './start-compiler-plugin/plugin'\nimport { loadEnvPlugin } from './load-env-plugin/plugin'\nimport {\n  buildStartViteEnvironments,\n  createViteConfigPlan,\n  createViteDefineConfig,\n  createViteResolvedEntryAliases,\n} from './planning'\nimport { devServerPlugin } from './dev-server-plugin/plugin'\nimport { previewServerPlugin } from './preview-server-plugin/plugin'\nimport {\n  createCaptureClientBuildPlugin,\n  createDevBaseRewritePlugin,\n  createPostBuildPlugin,\n  createVirtualClientEntryPlugin,\n} from './plugins'\nimport { parseStartConfig } from './schema'\nimport { startManifestPlugin } from './start-manifest-plugin/plugin'\nimport { tanStackStartRouter } from './start-router-plugin/plugin'\nimport {\n  getClientOutputDirectory,\n  getServerOutputDirectory,\n} from './output-directory'\nimport { postServerBuild } from './post-server-build'\nimport { serializationAdaptersPlugin } from './serialization-adapters-plugin'\nimport type { NormalizedClientBuild } from '../types'\nimport type {\n  TanStackStartVitePluginCoreOptions,\n  ViteRscForwardSsrResolverStrategy,\n} from './types'\nimport type { StartEnvironmentName } from '../constants'\nimport type { TanStackStartViteInputConfig } from './schema'\nimport type { PluginOption } from 'vite'\n\nexport function tanStackStartVite(\n  corePluginOpts: TanStackStartVitePluginCoreOptions,\n  startPluginOpts: TanStackStartViteInputConfig | undefined,\n): Array<PluginOption> {\n  const normalizedStartPluginOpts = startPluginOpts ?? {}\n\n  const configContext = createStartConfigContext({\n    corePluginOpts,\n    startPluginOpts: normalizedStartPluginOpts,\n    parseConfig: parseStartConfig,\n  })\n  const { getConfig, resolvedStartConfig } = configContext\n  const serverFnProviderEnv = corePluginOpts.providerEnvironmentName\n  const ssrIsProvider = corePluginOpts.ssrIsProvider\n\n  // When the router basepath and vite base are misaligned during dev,\n  // we install a URL rewrite middleware instead of erroring.\n  let needsDevBaseRewrite = false\n\n  const capturedClientBuild: Partial<\n    Record<StartEnvironmentName, NormalizedClientBuild>\n  > = {}\n\n  function getClientBuild(\n    envName: StartEnvironmentName,\n  ): NormalizedClientBuild | undefined {\n    return capturedClientBuild[envName]\n  }\n\n  const environments: Array<{\n    name: string\n    type: 'client' | 'server'\n    getServerFnById?: string\n  }> = [\n    { name: START_ENVIRONMENT_NAMES.client, type: 'client' },\n    {\n      name: START_ENVIRONMENT_NAMES.server,\n      type: 'server',\n      getServerFnById:\n        corePluginOpts.ssrResolverStrategy.type === 'vite-rsc-forward'\n          ? createViteRscForwarder(corePluginOpts.ssrResolverStrategy)\n          : undefined,\n    },\n  ]\n  if (\n    serverFnProviderEnv !== START_ENVIRONMENT_NAMES.server &&\n    !environments.find((e) => e.name === serverFnProviderEnv)\n  ) {\n    environments.push({\n      name: serverFnProviderEnv,\n      type: 'server',\n    })\n  }\n  return [\n    {\n      name: 'tanstack-start-core:config',\n      enforce: 'pre',\n      async config(viteConfig, { command }) {\n        const publicBase = normalizePublicBase(viteConfig.base)\n        applyResolvedBaseAndOutput({\n          resolvedStartConfig,\n          root: viteConfig.root || process.cwd(),\n          publicBase,\n          clientOutputDirectory: getClientOutputDirectory(viteConfig),\n          serverOutputDirectory: getServerOutputDirectory(viteConfig),\n        })\n        const { startConfig } = getConfig()\n        const routerBasepath = applyResolvedRouterBasepath({\n          resolvedStartConfig,\n          startConfig,\n        })\n\n        if (\n          shouldRewriteDevBasepath({\n            command,\n            middlewareMode: Boolean(viteConfig.server?.middlewareMode),\n            routerBasepath,\n            publicBase: resolvedStartConfig.basePaths.publicBase,\n          })\n        ) {\n          // The router basepath and vite base are misaligned.\n          // Instead of erroring, we install a dev-server middleware that\n          // rewrites incoming request URLs to prepend the vite base prefix.\n          // This allows users to have e.g. base: '/_ui/' for asset URLs\n          // while keeping router basepath at '/' for page navigation.\n          needsDevBaseRewrite = true\n        }\n\n        const TSS_SERVER_FN_BASE = createServerFnBasePath({\n          routerBasepath,\n          serverFnBase: startConfig.serverFns.base,\n        })\n        const resolvedEntryPlan = configContext.resolveEntries()\n\n        const entryAliases = createViteResolvedEntryAliases({\n          entryPaths: resolvedEntryPlan.entryPaths,\n        })\n\n        const startPackageName =\n          `@tanstack/${corePluginOpts.framework}-start` as const\n\n        // crawl packages that have start in \"peerDependencies\"\n        // see https://github.com/svitejs/vitefu/blob/d8d82fa121e3b2215ba437107093c77bde51b63b/src/index.js#L95-L101\n\n        // this is currently uncached; could be implemented similarly as vite handles lock file changes\n        // see https://github.com/vitejs/vite/blob/557f797d29422027e8c451ca50dd84bf8c41b5f0/packages/vite/src/node/optimizer/index.ts#L1282\n\n        const crawlFrameworkPkgsResult = await crawlFrameworkPkgs({\n          root: process.cwd(),\n          isBuild: command === 'build',\n          isFrameworkPkgByJson(pkgJson) {\n            const peerDependencies = pkgJson['peerDependencies']\n\n            if (peerDependencies) {\n              if (\n                startPackageName in peerDependencies ||\n                '@tanstack/start-client-core' in peerDependencies\n              ) {\n                return true\n              }\n            }\n\n            return false\n          },\n        })\n\n        const viteConfigPlan = createViteConfigPlan({\n          viteConfig,\n          framework: corePluginOpts.framework,\n          entryAliases,\n          clientOutputDirectory: resolvedStartConfig.outputDirectories.client,\n          serverOutputDirectory: resolvedStartConfig.outputDirectories.server,\n          serverFnProviderEnv,\n          optimizeDepsExclude: crawlFrameworkPkgsResult.optimizeDeps.exclude,\n          noExternal: crawlFrameworkPkgsResult.ssr.noExternal.sort(),\n        })\n\n        return {\n          // see https://vite.dev/config/shared-options.html#apptype\n          // this will prevent vite from injecting middlewares that we don't want\n          appType: viteConfig.appType ?? 'custom',\n          environments: viteConfigPlan.environments,\n          resolve: viteConfigPlan.resolve,\n          define: createViteDefineConfig({\n            command,\n            mode: viteConfig.mode,\n            serverFnBase: TSS_SERVER_FN_BASE,\n            routerBasepath,\n            spaEnabled: startConfig.spa?.enabled,\n            devSsrStylesEnabled: startConfig.dev.ssrStyles.enabled,\n            devSsrStylesBasepath:\n              startConfig.dev.ssrStyles.basepath ??\n              resolvedStartConfig.basePaths.publicBase,\n            staticNodeEnv: startConfig.server.build.staticNodeEnv,\n          }),\n          builder: {\n            sharedPlugins: true,\n            async buildApp(builder) {\n              await buildStartViteEnvironments({\n                builder,\n                providerEnvironmentName: serverFnProviderEnv,\n                ssrIsProvider,\n              })\n            },\n          },\n        }\n      },\n    },\n    createPostBuildPlugin({\n      getConfig,\n      postServerBuild,\n    }),\n    // Server function plugin handles:\n    // 1. Identifying createServerFn().handler() calls\n    // 2. Extracting server functions to separate modules\n    // 3. Replacing call sites with RPC stubs\n    // 4. Generating the server function manifest\n    // Also handles createIsomorphicFn, createServerOnlyFn, createClientOnlyFn, createMiddleware\n    startCompilerPlugin({\n      framework: corePluginOpts.framework,\n      environments,\n      generateFunctionId:\n        normalizedStartPluginOpts.serverFns?.generateFunctionId,\n      providerEnvName: serverFnProviderEnv,\n    }),\n    importProtectionPlugin({\n      getConfig,\n      framework: corePluginOpts.framework,\n      environments,\n      providerEnvName: serverFnProviderEnv,\n    }),\n    tanStackStartRouter(normalizedStartPluginOpts, getConfig, corePluginOpts),\n    loadEnvPlugin(),\n    createVirtualClientEntryPlugin({\n      getClientEntry: () => configContext.resolveEntries().entryPaths.client,\n    }),\n    startManifestPlugin({\n      getClientBuild: () => getClientBuild(START_ENVIRONMENT_NAMES.client),\n      getConfig,\n    }),\n    // When the vite base and router basepath are misaligned (e.g. base: '/_ui/', basepath: '/'),\n    // install a middleware that rewrites incoming request URLs to prepend the vite base prefix.\n    // This allows Vite's internal base middleware to accept the requests, then strips the prefix\n    // before passing to the SSR handler.\n    // Registered BEFORE devServerPlugin so this middleware is added to the Connect stack first,\n    // ensuring all subsequent middlewares (CSS, SSR, etc.) see the rewritten URL.\n    createDevBaseRewritePlugin({\n      shouldRewriteDevBase: () => needsDevBaseRewrite,\n      resolvedStartConfig,\n    }),\n    devServerPlugin({\n      getConfig,\n      devSsrStylesEnabled:\n        normalizedStartPluginOpts.dev?.ssrStyles?.enabled ?? true,\n      installDevServerMiddleware:\n        normalizedStartPluginOpts.vite?.installDevServerMiddleware,\n    }),\n    previewServerPlugin(),\n    serializationAdaptersPlugin({\n      adapters: corePluginOpts.serializationAdapters,\n    }),\n    createCaptureClientBuildPlugin({\n      capturedClientBuild,\n    }),\n  ]\n}\n\nfunction createViteRscForwarder(strategy: ViteRscForwardSsrResolverStrategy) {\n  return `export async function getServerFnById(id, access) {\n  const m = await import.meta.viteRsc.loadModule(${JSON.stringify(strategy.sourceEnvironmentName)}, ${JSON.stringify(strategy.sourceEntry)})\n  return m[${JSON.stringify(strategy.exportName)}](id, access)\n}`\n}\n"],"mappings":"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"}

package/dist/esm/vite/plugins.d.ts

@@ -1,6 +1,9 @@
 import { GetConfigFn, NormalizedClientBuild, ResolvedStartConfig } from '../types.js';
 import { StartEnvironmentName } from '../constants.js';
 import { PluginOption, ViteBuilder } from 'vite';
+export declare function createVirtualClientEntryPlugin(opts: {
+    getClientEntry: () => string;
+}): PluginOption;
 export declare function createPostBuildPlugin(opts: {
     getConfig: GetConfigFn;
     postServerBuild: (opts: {

package/dist/esm/vite/plugins.js

@@ -1,6 +1,18 @@
-import { START_ENVIRONMENT_NAMES } from "../constants.js";
+import { ENTRY_POINTS, START_ENVIRONMENT_NAMES } from "../constants.js";
+import { createVirtualModule } from "./createVirtualModule.js";
 import { normalizeViteClientBuild } from "./start-manifest-plugin/normalized-client-build.js";
+import { normalizePath } from "vite";
 //#region src/vite/plugins.ts
+function createVirtualClientEntryPlugin(opts) {
+	return createVirtualModule({
+		name: "tanstack-start-core:virtual-client-entry",
+		moduleId: ENTRY_POINTS.client,
+		enforce: "pre",
+		load() {
+			return `import ${JSON.stringify(normalizePath(opts.getClientEntry()).replaceAll("\\", "/"))}`;
+		}
+	});
+}
 function createPostBuildPlugin(opts) {
 	return {
 		name: "tanstack-start-core:post-build",
@@ -45,6 +57,6 @@ function createCaptureClientBuildPlugin(opts) {
 	};
 }
 //#endregion
-export { createCaptureClientBuildPlugin, createDevBaseRewritePlugin, createPostBuildPlugin };
+export { createCaptureClientBuildPlugin, createDevBaseRewritePlugin, createPostBuildPlugin, createVirtualClientEntryPlugin };
 
 //# sourceMappingURL=plugins.js.map

package/dist/esm/vite/plugins.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugins.js","names":[],"sources":["../../../src/vite/plugins.ts"],"sourcesContent":["import { START_ENVIRONMENT_NAMES } from '../constants'\nimport { normalizeViteClientBuild } from './start-manifest-plugin/normalized-client-build'\nimport type {\n  GetConfigFn,\n  NormalizedClientBuild,\n  ResolvedStartConfig,\n} from '../types'\nimport type { StartEnvironmentName } from '../constants'\nimport type { PluginOption, ViteBuilder } from 'vite'\n\nexport function createPostBuildPlugin(opts: {\n  getConfig: GetConfigFn\n  postServerBuild: (opts: {\n    startConfig: ReturnType<GetConfigFn>['startConfig']\n    builder: ViteBuilder\n  }) => Promise<void>\n}): PluginOption {\n  return {\n    name: 'tanstack-start-core:post-build',\n    enforce: 'post',\n    buildApp: {\n      order: 'post',\n      async handler(builder) {\n        const { startConfig } = opts.getConfig()\n        await opts.postServerBuild({ builder, startConfig })\n      },\n    },\n  }\n}\n\nexport function createDevBaseRewritePlugin(opts: {\n  shouldRewriteDevBase: () => boolean\n  resolvedStartConfig: ResolvedStartConfig\n}): PluginOption {\n  return {\n    name: 'tanstack-start-core:dev-base-rewrite',\n    configureServer(server) {\n      if (!opts.shouldRewriteDevBase()) {\n        return\n      }\n\n      const basePrefix = opts.resolvedStartConfig.basePaths.publicBase.replace(\n        /\\/$/,\n        '',\n      )\n\n      server.middlewares.use((req, _res, next) => {\n        if (req.url && !req.url.startsWith(basePrefix)) {\n          req.url = basePrefix + req.url\n        }\n\n        next()\n      })\n    },\n  }\n}\n\nexport function createCaptureClientBuildPlugin(opts: {\n  capturedClientBuild: Partial<\n    Record<StartEnvironmentName, NormalizedClientBuild>\n  >\n}): PluginOption {\n  return {\n    name: 'tanstack-start:core:capture-bundle',\n    applyToEnvironment(environment) {\n      return environment.name === START_ENVIRONMENT_NAMES.client\n    },\n    enforce: 'post',\n    generateBundle(_options, bundle) {\n      const environment = this.environment.name as StartEnvironmentName\n\n      if (environment !== START_ENVIRONMENT_NAMES.client) {\n        throw new Error(\n          `Unexpected environment for client build capture: ${environment}`,\n        )\n      }\n\n      opts.capturedClientBuild[environment] = normalizeViteClientBuild(bundle)\n    },\n  }\n}\n"],"mappings":";;;AAUA,SAAgB,sBAAsB,MAMrB;AACf,QAAO;EACL,MAAM;EACN,SAAS;EACT,UAAU;GACR,OAAO;GACP,MAAM,QAAQ,SAAS;IACrB,MAAM,EAAE,gBAAgB,KAAK,WAAW;AACxC,UAAM,KAAK,gBAAgB;KAAE;KAAS;KAAa,CAAC;;GAEvD;EACF;;AAGH,SAAgB,2BAA2B,MAG1B;AACf,QAAO;EACL,MAAM;EACN,gBAAgB,QAAQ;AACtB,OAAI,CAAC,KAAK,sBAAsB,CAC9B;GAGF,MAAM,aAAa,KAAK,oBAAoB,UAAU,WAAW,QAC/D,OACA,GACD;AAED,UAAO,YAAY,KAAK,KAAK,MAAM,SAAS;AAC1C,QAAI,IAAI,OAAO,CAAC,IAAI,IAAI,WAAW,WAAW,CAC5C,KAAI,MAAM,aAAa,IAAI;AAG7B,UAAM;KACN;;EAEL;;AAGH,SAAgB,+BAA+B,MAI9B;AACf,QAAO;EACL,MAAM;EACN,mBAAmB,aAAa;AAC9B,UAAO,YAAY,SAAS,wBAAwB;;EAEtD,SAAS;EACT,eAAe,UAAU,QAAQ;GAC/B,MAAM,cAAc,KAAK,YAAY;AAErC,OAAI,gBAAgB,wBAAwB,OAC1C,OAAM,IAAI,MACR,oDAAoD,cACrD;AAGH,QAAK,oBAAoB,eAAe,yBAAyB,OAAO;;EAE3E"}
+{"version":3,"file":"plugins.js","names":[],"sources":["../../../src/vite/plugins.ts"],"sourcesContent":["import { normalizePath } from 'vite'\nimport { ENTRY_POINTS, START_ENVIRONMENT_NAMES } from '../constants'\nimport { createVirtualModule } from './createVirtualModule'\nimport { normalizeViteClientBuild } from './start-manifest-plugin/normalized-client-build'\nimport type {\n  GetConfigFn,\n  NormalizedClientBuild,\n  ResolvedStartConfig,\n} from '../types'\nimport type { StartEnvironmentName } from '../constants'\nimport type { PluginOption, ViteBuilder } from 'vite'\n\nexport function createVirtualClientEntryPlugin(opts: {\n  getClientEntry: () => string\n}): PluginOption {\n  return createVirtualModule({\n    name: 'tanstack-start-core:virtual-client-entry',\n    moduleId: ENTRY_POINTS.client,\n    enforce: 'pre',\n    load() {\n      return `import ${JSON.stringify(normalizePath(opts.getClientEntry()).replaceAll('\\\\', '/'))}`\n    },\n  })\n}\n\nexport function createPostBuildPlugin(opts: {\n  getConfig: GetConfigFn\n  postServerBuild: (opts: {\n    startConfig: ReturnType<GetConfigFn>['startConfig']\n    builder: ViteBuilder\n  }) => Promise<void>\n}): PluginOption {\n  return {\n    name: 'tanstack-start-core:post-build',\n    enforce: 'post',\n    buildApp: {\n      order: 'post',\n      async handler(builder) {\n        const { startConfig } = opts.getConfig()\n        await opts.postServerBuild({ builder, startConfig })\n      },\n    },\n  }\n}\n\nexport function createDevBaseRewritePlugin(opts: {\n  shouldRewriteDevBase: () => boolean\n  resolvedStartConfig: ResolvedStartConfig\n}): PluginOption {\n  return {\n    name: 'tanstack-start-core:dev-base-rewrite',\n    configureServer(server) {\n      if (!opts.shouldRewriteDevBase()) {\n        return\n      }\n\n      const basePrefix = opts.resolvedStartConfig.basePaths.publicBase.replace(\n        /\\/$/,\n        '',\n      )\n\n      server.middlewares.use((req, _res, next) => {\n        if (req.url && !req.url.startsWith(basePrefix)) {\n          req.url = basePrefix + req.url\n        }\n\n        next()\n      })\n    },\n  }\n}\n\nexport function createCaptureClientBuildPlugin(opts: {\n  capturedClientBuild: Partial<\n    Record<StartEnvironmentName, NormalizedClientBuild>\n  >\n}): PluginOption {\n  return {\n    name: 'tanstack-start:core:capture-bundle',\n    applyToEnvironment(environment) {\n      return environment.name === START_ENVIRONMENT_NAMES.client\n    },\n    enforce: 'post',\n    generateBundle(_options, bundle) {\n      const environment = this.environment.name as StartEnvironmentName\n\n      if (environment !== START_ENVIRONMENT_NAMES.client) {\n        throw new Error(\n          `Unexpected environment for client build capture: ${environment}`,\n        )\n      }\n\n      opts.capturedClientBuild[environment] = normalizeViteClientBuild(bundle)\n    },\n  }\n}\n"],"mappings":";;;;;AAYA,SAAgB,+BAA+B,MAE9B;AACf,QAAO,oBAAoB;EACzB,MAAM;EACN,UAAU,aAAa;EACvB,SAAS;EACT,OAAO;AACL,UAAO,UAAU,KAAK,UAAU,cAAc,KAAK,gBAAgB,CAAC,CAAC,WAAW,MAAM,IAAI,CAAC;;EAE9F,CAAC;;AAGJ,SAAgB,sBAAsB,MAMrB;AACf,QAAO;EACL,MAAM;EACN,SAAS;EACT,UAAU;GACR,OAAO;GACP,MAAM,QAAQ,SAAS;IACrB,MAAM,EAAE,gBAAgB,KAAK,WAAW;AACxC,UAAM,KAAK,gBAAgB;KAAE;KAAS;KAAa,CAAC;;GAEvD;EACF;;AAGH,SAAgB,2BAA2B,MAG1B;AACf,QAAO;EACL,MAAM;EACN,gBAAgB,QAAQ;AACtB,OAAI,CAAC,KAAK,sBAAsB,CAC9B;GAGF,MAAM,aAAa,KAAK,oBAAoB,UAAU,WAAW,QAC/D,OACA,GACD;AAED,UAAO,YAAY,KAAK,KAAK,MAAM,SAAS;AAC1C,QAAI,IAAI,OAAO,CAAC,IAAI,IAAI,WAAW,WAAW,CAC5C,KAAI,MAAM,aAAa,IAAI;AAG7B,UAAM;KACN;;EAEL;;AAGH,SAAgB,+BAA+B,MAI9B;AACf,QAAO;EACL,MAAM;EACN,mBAAmB,aAAa;AAC9B,UAAO,YAAY,SAAS,wBAAwB;;EAEtD,SAAS;EACT,eAAe,UAAU,QAAQ;GAC/B,MAAM,cAAc,KAAK,YAAY;AAErC,OAAI,gBAAgB,wBAAwB,OAC1C,OAAM,IAAI,MACR,oDAAoD,cACrD;AAGH,QAAK,oBAAoB,eAAe,yBAAyB,OAAO;;EAE3E"}

package/dist/esm/vite/serialization-adapters-plugin.js

@@ -1,40 +1,27 @@
 import { START_ENVIRONMENT_NAMES } from "../constants.js";
-import { resolveViteId } from "../utils.js";
+import { createVirtualModule } from "./createVirtualModule.js";
 import { EMPTY_SERIALIZATION_ADAPTERS_MODULE, generateSerializationAdaptersModule } from "../serialization-adapters-module.js";
 import { VIRTUAL_MODULES } from "@tanstack/start-server-core";
 //#region src/vite/serialization-adapters-plugin.ts
-var resolvedModuleId = resolveViteId(VIRTUAL_MODULES.pluginAdapters.replace("#", "%23"));
-function escapeRegex(str) {
-	return str.replace(/[.*+?^${}()|[\]\\#]/g, "\\$&");
-}
 function serializationAdaptersPlugin(opts) {
-	return {
+	return createVirtualModule({
 		name: "tanstack-start:plugin-adapters",
+		moduleId: VIRTUAL_MODULES.pluginAdapters,
 		enforce: "pre",
-		resolveId: {
-			filter: { id: new RegExp(escapeRegex(VIRTUAL_MODULES.pluginAdapters)) },
-			handler(id) {
-				if (id === VIRTUAL_MODULES.pluginAdapters) return resolvedModuleId;
-			}
-		},
-		load: {
-			filter: { id: new RegExp(escapeRegex(resolvedModuleId)) },
-			handler(id) {
-				if (id !== resolvedModuleId) return;
-				const adapters = opts.adapters;
-				if (!adapters || adapters.length === 0) return EMPTY_SERIALIZATION_ADAPTERS_MODULE;
-				if (this.environment.name === START_ENVIRONMENT_NAMES.client) return generateSerializationAdaptersModule({
-					adapters,
-					runtime: "client"
-				});
-				if (this.environment.name === START_ENVIRONMENT_NAMES.server) return generateSerializationAdaptersModule({
-					adapters,
-					runtime: "server"
-				});
-				return EMPTY_SERIALIZATION_ADAPTERS_MODULE;
-			}
+		load() {
+			const adapters = opts.adapters;
+			if (!adapters || adapters.length === 0) return EMPTY_SERIALIZATION_ADAPTERS_MODULE;
+			if (this.environment.name === START_ENVIRONMENT_NAMES.client) return generateSerializationAdaptersModule({
+				adapters,
+				runtime: "client"
+			});
+			if (this.environment.name === START_ENVIRONMENT_NAMES.server) return generateSerializationAdaptersModule({
+				adapters,
+				runtime: "server"
+			});
+			return EMPTY_SERIALIZATION_ADAPTERS_MODULE;
 		}
-	};
+	});
 }
 //#endregion
 export { serializationAdaptersPlugin };

package/dist/esm/vite/serialization-adapters-plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"serialization-adapters-plugin.js","names":[],"sources":["../../../src/vite/serialization-adapters-plugin.ts"],"sourcesContent":["import { VIRTUAL_MODULES } from '@tanstack/start-server-core'\nimport {\n  EMPTY_SERIALIZATION_ADAPTERS_MODULE,\n  generateSerializationAdaptersModule,\n} from '../serialization-adapters-module'\nimport { START_ENVIRONMENT_NAMES } from '../constants'\nimport { resolveViteId } from '../utils'\nimport type { SerializationAdapterConfig } from '../types'\nimport type { PluginOption } from 'vite'\n\n// Encode '#' as '%23' in the resolved ID to avoid browser treating it as URL fragment.\n// The browser requests /@id/__x00__%23tanstack-start-plugin-adapters instead of\n// /@id/__x00__#tanstack-start-plugin-adapters (which would truncate at #).\nconst resolvedModuleId = resolveViteId(\n  VIRTUAL_MODULES.pluginAdapters.replace('#', '%23'),\n)\n\nfunction escapeRegex(str: string): string {\n  return str.replace(/[.*+?^${}()|[\\]\\\\#]/g, '\\\\$&')\n}\n\nexport function serializationAdaptersPlugin(opts: {\n  adapters: Array<SerializationAdapterConfig> | undefined\n}): PluginOption {\n  return {\n    name: 'tanstack-start:plugin-adapters',\n    enforce: 'pre',\n    resolveId: {\n      filter: { id: new RegExp(escapeRegex(VIRTUAL_MODULES.pluginAdapters)) },\n      handler(id: string) {\n        if (id === VIRTUAL_MODULES.pluginAdapters) {\n          return resolvedModuleId\n        }\n        return undefined\n      },\n    },\n    load: {\n      filter: {\n        id: new RegExp(escapeRegex(resolvedModuleId)),\n      },\n      handler(this: { environment: { name: string } }, id: string) {\n        if (id !== resolvedModuleId) {\n          return undefined\n        }\n\n        const adapters = opts.adapters\n        if (!adapters || adapters.length === 0) {\n          return EMPTY_SERIALIZATION_ADAPTERS_MODULE\n        }\n\n        if (this.environment.name === START_ENVIRONMENT_NAMES.client) {\n          return generateSerializationAdaptersModule({\n            adapters,\n            runtime: 'client',\n          })\n        }\n\n        if (this.environment.name === START_ENVIRONMENT_NAMES.server) {\n          return generateSerializationAdaptersModule({\n            adapters,\n            runtime: 'server',\n          })\n        }\n\n        return EMPTY_SERIALIZATION_ADAPTERS_MODULE\n      },\n    },\n  }\n}\n"],"mappings":";;;;;AAaA,IAAM,mBAAmB,cACvB,gBAAgB,eAAe,QAAQ,KAAK,MAAM,CACnD;AAED,SAAS,YAAY,KAAqB;AACxC,QAAO,IAAI,QAAQ,wBAAwB,OAAO;;AAGpD,SAAgB,4BAA4B,MAE3B;AACf,QAAO;EACL,MAAM;EACN,SAAS;EACT,WAAW;GACT,QAAQ,EAAE,IAAI,IAAI,OAAO,YAAY,gBAAgB,eAAe,CAAC,EAAE;GACvE,QAAQ,IAAY;AAClB,QAAI,OAAO,gBAAgB,eACzB,QAAO;;GAIZ;EACD,MAAM;GACJ,QAAQ,EACN,IAAI,IAAI,OAAO,YAAY,iBAAiB,CAAC,EAC9C;GACD,QAAiD,IAAY;AAC3D,QAAI,OAAO,iBACT;IAGF,MAAM,WAAW,KAAK;AACtB,QAAI,CAAC,YAAY,SAAS,WAAW,EACnC,QAAO;AAGT,QAAI,KAAK,YAAY,SAAS,wBAAwB,OACpD,QAAO,oCAAoC;KACzC;KACA,SAAS;KACV,CAAC;AAGJ,QAAI,KAAK,YAAY,SAAS,wBAAwB,OACpD,QAAO,oCAAoC;KACzC;KACA,SAAS;KACV,CAAC;AAGJ,WAAO;;GAEV;EACF"}
+{"version":3,"file":"serialization-adapters-plugin.js","names":[],"sources":["../../../src/vite/serialization-adapters-plugin.ts"],"sourcesContent":["import { VIRTUAL_MODULES } from '@tanstack/start-server-core'\nimport {\n  EMPTY_SERIALIZATION_ADAPTERS_MODULE,\n  generateSerializationAdaptersModule,\n} from '../serialization-adapters-module'\nimport { START_ENVIRONMENT_NAMES } from '../constants'\nimport { createVirtualModule } from './createVirtualModule'\nimport type { SerializationAdapterConfig } from '../types'\nimport type { PluginOption } from 'vite'\n\nexport function serializationAdaptersPlugin(opts: {\n  adapters: Array<SerializationAdapterConfig> | undefined\n}): PluginOption {\n  return createVirtualModule({\n    name: 'tanstack-start:plugin-adapters',\n    moduleId: VIRTUAL_MODULES.pluginAdapters,\n    enforce: 'pre',\n    load() {\n      const adapters = opts.adapters\n      if (!adapters || adapters.length === 0) {\n        return EMPTY_SERIALIZATION_ADAPTERS_MODULE\n      }\n\n      if (this.environment.name === START_ENVIRONMENT_NAMES.client) {\n        return generateSerializationAdaptersModule({\n          adapters,\n          runtime: 'client',\n        })\n      }\n\n      if (this.environment.name === START_ENVIRONMENT_NAMES.server) {\n        return generateSerializationAdaptersModule({\n          adapters,\n          runtime: 'server',\n        })\n      }\n\n      return EMPTY_SERIALIZATION_ADAPTERS_MODULE\n    },\n  })\n}\n"],"mappings":";;;;;AAUA,SAAgB,4BAA4B,MAE3B;AACf,QAAO,oBAAoB;EACzB,MAAM;EACN,UAAU,gBAAgB;EAC1B,SAAS;EACT,OAAO;GACL,MAAM,WAAW,KAAK;AACtB,OAAI,CAAC,YAAY,SAAS,WAAW,EACnC,QAAO;AAGT,OAAI,KAAK,YAAY,SAAS,wBAAwB,OACpD,QAAO,oCAAoC;IACzC;IACA,SAAS;IACV,CAAC;AAGJ,OAAI,KAAK,YAAY,SAAS,wBAAwB,OACpD,QAAO,oCAAoC;IACzC;IACA,SAAS;IACV,CAAC;AAGJ,UAAO;;EAEV,CAAC"}

package/dist/esm/vite/start-compiler-plugin/plugin.js

@@ -1,4 +1,6 @@
 import { SERVER_FN_LOOKUP, TRANSFORM_ID_REGEX, VITE_ENVIRONMENT_NAMES } from "../../constants.js";
+import { resolveViteId } from "../../utils.js";
+import { createVirtualModule } from "../createVirtualModule.js";
 import { cleanId } from "../../start-compiler/utils.js";
 import { detectKindsInCode } from "../../start-compiler/compiler.js";
 import { getTransformCodeFilterForEnv } from "../../start-compiler/config.js";
@@ -10,9 +12,6 @@ import { resolve } from "pathe";
 import assert from "node:assert";
 import { VIRTUAL_MODULES } from "@tanstack/start-server-core";
 //#region src/vite/start-compiler-plugin/plugin.ts
-function resolveViteId(id) {
-	return `\0${id}`;
-}
 var validateServerFnIdVirtualModule = `virtual:tanstack-start-validate-server-fn-id`;
 function getDevServerFnValidatorModule() {
 	return `
@@ -44,7 +43,6 @@ function startCompilerPlugin(opts) {
 		mergeServerFnsById(serverFnsById, d);
 	};
 	let root = process.cwd();
-	const resolvedResolverVirtualImportId = resolveViteId(VIRTUAL_MODULES.serverFnResolver);
 	const ssrEnvName = VITE_ENVIRONMENT_NAMES.server;
 	const ssrIsProvider = opts.providerEnvName === ssrEnvName;
 	const appliedResolverEnvironments = new Set(ssrIsProvider ? [opts.providerEnvName] : [ssrEnvName, opts.providerEnvName]);
@@ -163,37 +161,26 @@ function startCompilerPlugin(opts) {
 				}
 			}
 		},
-		{
+		createVirtualModule({
 			name: "tanstack-start-core:server-fn-resolver",
+			moduleId: VIRTUAL_MODULES.serverFnResolver,
 			enforce: "pre",
 			applyToEnvironment: (env) => {
 				return appliedResolverEnvironments.has(env.name);
 			},
-			configResolved(config) {
-				root = config.root;
-			},
-			resolveId: {
-				filter: { id: new RegExp(VIRTUAL_MODULES.serverFnResolver) },
-				handler() {
-					return resolvedResolverVirtualImportId;
-				}
-			},
-			load: {
-				filter: { id: new RegExp(resolvedResolverVirtualImportId) },
-				handler() {
-					if (this.environment.name !== opts.providerEnvName) {
-						const mod = opts.environments.find((e) => e.name === this.environment.name)?.getServerFnById;
-						if (mod) return mod;
-						else this.error(`No getServerFnById implementation found for caller environment: ${this.environment.name}`);
-					}
-					if (this.environment.mode !== "build") return getDevServerFnValidatorModule();
-					return generateServerFnResolverModule({
-						serverFnsById,
-						includeClientReferencedCheck: !ssrIsProvider
-					});
+			load() {
+				if (this.environment.name !== opts.providerEnvName) {
+					const mod = opts.environments.find((e) => e.name === this.environment.name)?.getServerFnById;
+					if (mod) return mod;
+					this.error(`No getServerFnById implementation found for caller environment: ${this.environment.name}`);
 				}
+				if (this.environment.mode !== "build") return getDevServerFnValidatorModule();
+				return generateServerFnResolverModule({
+					serverFnsById,
+					includeClientReferencedCheck: !ssrIsProvider
+				});
 			}
-		}
+		})
 	];
 }
 //#endregion

package/dist/esm/vite/start-compiler-plugin/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","names":[],"sources":["../../../../src/vite/start-compiler-plugin/plugin.ts"],"sourcesContent":["import assert from 'node:assert'\nimport { VIRTUAL_MODULES } from '@tanstack/start-server-core'\nimport { resolve as resolvePath } from 'pathe'\nimport {\n  SERVER_FN_LOOKUP,\n  TRANSFORM_ID_REGEX,\n  VITE_ENVIRONMENT_NAMES,\n} from '../../constants'\nimport { detectKindsInCode } from '../../start-compiler/compiler'\nimport { getTransformCodeFilterForEnv } from '../../start-compiler/config'\nimport {\n  createStartCompiler,\n  mergeServerFnsById,\n} from '../../start-compiler/host'\nimport { loadModuleForViteCompiler } from '../../start-compiler/load-module'\nimport { generateServerFnResolverModule } from '../../start-compiler/server-fn-resolver-module'\nimport { cleanId } from '../../start-compiler/utils'\nimport {\n  createViteDevServerFnModuleSpecifierEncoder,\n  decodeViteDevServerModuleSpecifier,\n} from './module-specifier'\nimport type { CompileStartFrameworkOptions } from '../../types'\nimport type {\n  GenerateFunctionIdFnOptional,\n  ServerFn,\n} from '../../start-compiler/types'\nimport type { PluginOption } from 'vite'\n\n// Re-export from shared constants for backwards compatibility\nexport { SERVER_FN_LOOKUP }\n\nfunction resolveViteId(id: string) {\n  return `\\0${id}`\n}\n\nconst validateServerFnIdVirtualModule = `virtual:tanstack-start-validate-server-fn-id`\n\nfunction getDevServerFnValidatorModule(): string {\n  return `\nexport async function getServerFnById(id, _access) {\n  const validateIdImport = ${JSON.stringify(validateServerFnIdVirtualModule)} + '?id=' + id\n  await import(/* @vite-ignore */ '/@id/__x00__' + validateIdImport)\n  const decoded = Buffer.from(id, 'base64url').toString('utf8')\n  const devServerFn = JSON.parse(decoded)\n  const mod = await import(/* @vite-ignore */ devServerFn.file)\n  return mod[devServerFn.export]\n}\n`\n}\n\nfunction parseIdQuery(id: string): {\n  filename: string\n  query: {\n    [k: string]: string\n  }\n} {\n  if (!id.includes('?')) return { filename: id, query: {} }\n  const [filename, rawQuery] = id.split(`?`, 2) as [string, string]\n  const query = Object.fromEntries(new URLSearchParams(rawQuery))\n  return { filename, query }\n}\n\nexport interface StartCompilerPluginOptions {\n  framework: CompileStartFrameworkOptions\n  environments: Array<{\n    name: string\n    type: 'client' | 'server'\n    getServerFnById?: string\n  }>\n  /**\n   * Custom function ID generator (optional).\n   */\n  generateFunctionId?: GenerateFunctionIdFnOptional\n  /**\n   * The Vite environment name for the server function provider.\n   */\n  providerEnvName: string\n}\n\nexport function startCompilerPlugin(\n  opts: StartCompilerPluginOptions,\n): PluginOption {\n  const compilers = new Map<string, ReturnType<typeof createStartCompiler>>()\n\n  // Shared registry of server functions across all environments\n  const serverFnsById: Record<string, ServerFn> = {}\n\n  const onServerFnsById = (d: Record<string, ServerFn>) => {\n    mergeServerFnsById(serverFnsById, d)\n  }\n\n  let root = process.cwd()\n  const resolvedResolverVirtualImportId = resolveViteId(\n    VIRTUAL_MODULES.serverFnResolver,\n  )\n\n  // Determine which environments need the resolver (getServerFnById)\n  // SSR environment always needs the resolver for server-side calls\n  // Provider environment needs it for the actual implementation\n  const ssrEnvName = VITE_ENVIRONMENT_NAMES.server\n\n  // SSR is the provider when the provider environment is the default server environment\n  const ssrIsProvider = opts.providerEnvName === ssrEnvName\n\n  // Environments that need the resolver: SSR (for server calls) and provider (for implementation)\n  const appliedResolverEnvironments = new Set(\n    ssrIsProvider ? [opts.providerEnvName] : [ssrEnvName, opts.providerEnvName],\n  )\n\n  function perEnvServerFnPlugin(environment: {\n    name: string\n    type: 'client' | 'server'\n  }): PluginOption {\n    // Derive transform code filter from KindDetectionPatterns (single source of truth)\n    const transformCodeFilter = getTransformCodeFilterForEnv(environment.type)\n    return {\n      name: `tanstack-start-core::server-fn:${environment.name}`,\n      enforce: 'pre',\n      applyToEnvironment(env) {\n        return env.name === environment.name\n      },\n      configResolved(config) {\n        root = config.root\n      },\n      transform: {\n        filter: {\n          id: {\n            exclude: new RegExp(`${SERVER_FN_LOOKUP}$`),\n            include: TRANSFORM_ID_REGEX,\n          },\n          code: {\n            include: transformCodeFilter,\n          },\n        },\n        async handler(code, id) {\n          let compiler = compilers.get(this.environment.name)\n\n          if (!compiler) {\n            // Default to 'dev' mode for unknown environments (conservative: no caching)\n            const mode = this.environment.mode === 'build' ? 'build' : 'dev'\n\n            compiler = createStartCompiler({\n              env: environment.type,\n              envName: environment.name,\n              root,\n              mode,\n              framework: opts.framework,\n              providerEnvName: opts.providerEnvName,\n              generateFunctionId: opts.generateFunctionId,\n              onServerFnsById,\n              getKnownServerFns: () => serverFnsById,\n              encodeModuleSpecifierInDev:\n                mode === 'dev'\n                  ? createViteDevServerFnModuleSpecifierEncoder(root)\n                  : undefined,\n              loadModule: async (id: string) => {\n                await loadModuleForViteCompiler({\n                  compiler: compiler!,\n                  mode: this.environment.mode,\n                  fetchModule:\n                    this.environment.mode === 'dev'\n                      ? this.environment.fetchModule.bind(this.environment)\n                      : undefined,\n                  loadModule: this.load.bind(this),\n                  id,\n                })\n              },\n\n              resolveId: async (source: string, importer?: string) => {\n                const r = await this.resolve(source, importer)\n\n                if (r) {\n                  if (!r.external) {\n                    return cleanId(r.id)\n                  }\n                }\n\n                return null\n              },\n            })\n\n            compilers.set(this.environment.name, compiler)\n          }\n\n          // Detect which kinds are present in this file before parsing\n          const detectedKinds = detectKindsInCode(code, environment.type)\n\n          const result = await compiler.compile({\n            id,\n            code,\n            detectedKinds,\n          })\n          return result\n        },\n      },\n\n      hotUpdate(ctx) {\n        const compiler = compilers.get(this.environment.name)\n\n        ctx.modules.forEach((m) => {\n          if (m.id) {\n            const deleted = compiler?.invalidateModule(m.id)\n            if (deleted) {\n              m.importers.forEach((importer) => {\n                if (importer.id) {\n                  compiler?.invalidateModule(importer.id)\n                }\n              })\n            }\n          }\n        })\n      },\n    }\n  }\n\n  return [\n    ...opts.environments.map(perEnvServerFnPlugin),\n    {\n      name: 'tanstack-start-core:capture-server-fn-module-lookup',\n      // we only need this plugin in dev mode\n      apply: 'serve',\n      applyToEnvironment(env) {\n        return !!opts.environments.find((e) => e.name === env.name)\n      },\n      transform: {\n        filter: {\n          id: new RegExp(`${SERVER_FN_LOOKUP}$`),\n        },\n        handler(code, id) {\n          const compiler = compilers.get(this.environment.name)\n          compiler?.ingestModule({ code, id: cleanId(id) })\n        },\n      },\n    },\n    // Validate server function ID in dev mode\n    {\n      name: 'tanstack-start-core:validate-server-fn-id',\n      apply: 'serve',\n      load: {\n        filter: {\n          id: new RegExp(resolveViteId(validateServerFnIdVirtualModule)),\n        },\n        async handler(id) {\n          const parsed = parseIdQuery(id)\n          const fnId = parsed.query.id\n          if (fnId && serverFnsById[fnId]) {\n            return `export {}`\n          }\n\n          // ID not yet registered — the source file may not have been\n          // transformed in this dev session yet (e.g. cold restart with\n          // cached client). Try to decode the ID, discover the source\n          // file, trigger its compilation, and re-check.\n          if (fnId) {\n            try {\n              const decoded = JSON.parse(\n                Buffer.from(fnId, 'base64url').toString('utf8'),\n              )\n              if (\n                typeof decoded.file === 'string' &&\n                typeof decoded.export === 'string'\n              ) {\n                // Use the Vite strategy to decode the module specifier\n                // back to the original source file path.\n                const sourceFile = decodeViteDevServerModuleSpecifier(\n                  decoded.file,\n                )\n\n                if (sourceFile) {\n                  // Resolve to absolute path\n                  const absPath = resolvePath(root, sourceFile)\n\n                  // Trigger transform of the source file in this environment,\n                  // which will compile createServerFn calls and populate\n                  // serverFnsById as a side effect.\n                  // This plugin only runs in dev (apply: 'serve'), so mode\n                  // must be 'dev' — assert to narrow to DevEnvironment.\n                  assert(this.environment.mode === 'dev')\n                  await this.environment.fetchModule(absPath)\n\n                  // Re-check after lazy compilation\n                  if (serverFnsById[fnId]) {\n                    return `export {}`\n                  }\n                }\n              }\n            } catch {\n              // Decoding or fetching failed — fall through to error\n            }\n          }\n\n          this.error(`Invalid server function ID: ${fnId}`)\n        },\n      },\n    },\n    // Manifest plugin for server environments\n    {\n      name: 'tanstack-start-core:server-fn-resolver',\n      enforce: 'pre',\n      applyToEnvironment: (env) => {\n        return appliedResolverEnvironments.has(env.name)\n      },\n      configResolved(config) {\n        root = config.root\n      },\n      resolveId: {\n        filter: { id: new RegExp(VIRTUAL_MODULES.serverFnResolver) },\n        handler() {\n          return resolvedResolverVirtualImportId\n        },\n      },\n      load: {\n        filter: { id: new RegExp(resolvedResolverVirtualImportId) },\n        handler() {\n          if (this.environment.name !== opts.providerEnvName) {\n            const mod = opts.environments.find(\n              (e) => e.name === this.environment.name,\n            )?.getServerFnById\n            if (mod) {\n              return mod\n            } else {\n              this.error(\n                `No getServerFnById implementation found for caller environment: ${this.environment.name}`,\n              )\n            }\n          }\n\n          if (this.environment.mode !== 'build') {\n            return getDevServerFnValidatorModule()\n          }\n\n          // When SSR is the provider, server-only-referenced functions aren't in the manifest,\n          // so no isClientReferenced check is needed.\n          // When SSR is NOT the provider (custom provider env), server-only-referenced\n          // functions ARE in the manifest and need the isClientReferenced check to\n          // block direct client HTTP requests to server-only-referenced functions.\n          return generateServerFnResolverModule({\n            serverFnsById,\n            includeClientReferencedCheck: !ssrIsProvider,\n          })\n        },\n      },\n    },\n  ]\n}\n"],"mappings":"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"}
+{"version":3,"file":"plugin.js","names":[],"sources":["../../../../src/vite/start-compiler-plugin/plugin.ts"],"sourcesContent":["import assert from 'node:assert'\nimport { VIRTUAL_MODULES } from '@tanstack/start-server-core'\nimport { resolve as resolvePath } from 'pathe'\nimport {\n  SERVER_FN_LOOKUP,\n  TRANSFORM_ID_REGEX,\n  VITE_ENVIRONMENT_NAMES,\n} from '../../constants'\nimport { detectKindsInCode } from '../../start-compiler/compiler'\nimport { getTransformCodeFilterForEnv } from '../../start-compiler/config'\nimport {\n  createStartCompiler,\n  mergeServerFnsById,\n} from '../../start-compiler/host'\nimport { loadModuleForViteCompiler } from '../../start-compiler/load-module'\nimport { generateServerFnResolverModule } from '../../start-compiler/server-fn-resolver-module'\nimport { cleanId } from '../../start-compiler/utils'\nimport { createVirtualModule } from '../createVirtualModule'\nimport { resolveViteId } from '../../utils'\nimport {\n  createViteDevServerFnModuleSpecifierEncoder,\n  decodeViteDevServerModuleSpecifier,\n} from './module-specifier'\nimport type { CompileStartFrameworkOptions } from '../../types'\nimport type {\n  GenerateFunctionIdFnOptional,\n  ServerFn,\n} from '../../start-compiler/types'\nimport type { PluginOption } from 'vite'\n\n// Re-export from shared constants for backwards compatibility\nexport { SERVER_FN_LOOKUP }\n\nconst validateServerFnIdVirtualModule = `virtual:tanstack-start-validate-server-fn-id`\n\nfunction getDevServerFnValidatorModule(): string {\n  return `\nexport async function getServerFnById(id, _access) {\n  const validateIdImport = ${JSON.stringify(validateServerFnIdVirtualModule)} + '?id=' + id\n  await import(/* @vite-ignore */ '/@id/__x00__' + validateIdImport)\n  const decoded = Buffer.from(id, 'base64url').toString('utf8')\n  const devServerFn = JSON.parse(decoded)\n  const mod = await import(/* @vite-ignore */ devServerFn.file)\n  return mod[devServerFn.export]\n}\n`\n}\n\nfunction parseIdQuery(id: string): {\n  filename: string\n  query: {\n    [k: string]: string\n  }\n} {\n  if (!id.includes('?')) return { filename: id, query: {} }\n  const [filename, rawQuery] = id.split(`?`, 2) as [string, string]\n  const query = Object.fromEntries(new URLSearchParams(rawQuery))\n  return { filename, query }\n}\n\nexport interface StartCompilerPluginOptions {\n  framework: CompileStartFrameworkOptions\n  environments: Array<{\n    name: string\n    type: 'client' | 'server'\n    getServerFnById?: string\n  }>\n  /**\n   * Custom function ID generator (optional).\n   */\n  generateFunctionId?: GenerateFunctionIdFnOptional\n  /**\n   * The Vite environment name for the server function provider.\n   */\n  providerEnvName: string\n}\n\nexport function startCompilerPlugin(\n  opts: StartCompilerPluginOptions,\n): PluginOption {\n  const compilers = new Map<string, ReturnType<typeof createStartCompiler>>()\n\n  // Shared registry of server functions across all environments\n  const serverFnsById: Record<string, ServerFn> = {}\n\n  const onServerFnsById = (d: Record<string, ServerFn>) => {\n    mergeServerFnsById(serverFnsById, d)\n  }\n\n  let root = process.cwd()\n  // Determine which environments need the resolver (getServerFnById)\n  // SSR environment always needs the resolver for server-side calls\n  // Provider environment needs it for the actual implementation\n  const ssrEnvName = VITE_ENVIRONMENT_NAMES.server\n\n  // SSR is the provider when the provider environment is the default server environment\n  const ssrIsProvider = opts.providerEnvName === ssrEnvName\n\n  // Environments that need the resolver: SSR (for server calls) and provider (for implementation)\n  const appliedResolverEnvironments = new Set(\n    ssrIsProvider ? [opts.providerEnvName] : [ssrEnvName, opts.providerEnvName],\n  )\n\n  function perEnvServerFnPlugin(environment: {\n    name: string\n    type: 'client' | 'server'\n  }): PluginOption {\n    // Derive transform code filter from KindDetectionPatterns (single source of truth)\n    const transformCodeFilter = getTransformCodeFilterForEnv(environment.type)\n    return {\n      name: `tanstack-start-core::server-fn:${environment.name}`,\n      enforce: 'pre',\n      applyToEnvironment(env) {\n        return env.name === environment.name\n      },\n      configResolved(config) {\n        root = config.root\n      },\n      transform: {\n        filter: {\n          id: {\n            exclude: new RegExp(`${SERVER_FN_LOOKUP}$`),\n            include: TRANSFORM_ID_REGEX,\n          },\n          code: {\n            include: transformCodeFilter,\n          },\n        },\n        async handler(code, id) {\n          let compiler = compilers.get(this.environment.name)\n\n          if (!compiler) {\n            // Default to 'dev' mode for unknown environments (conservative: no caching)\n            const mode = this.environment.mode === 'build' ? 'build' : 'dev'\n\n            compiler = createStartCompiler({\n              env: environment.type,\n              envName: environment.name,\n              root,\n              mode,\n              framework: opts.framework,\n              providerEnvName: opts.providerEnvName,\n              generateFunctionId: opts.generateFunctionId,\n              onServerFnsById,\n              getKnownServerFns: () => serverFnsById,\n              encodeModuleSpecifierInDev:\n                mode === 'dev'\n                  ? createViteDevServerFnModuleSpecifierEncoder(root)\n                  : undefined,\n              loadModule: async (id: string) => {\n                await loadModuleForViteCompiler({\n                  compiler: compiler!,\n                  mode: this.environment.mode,\n                  fetchModule:\n                    this.environment.mode === 'dev'\n                      ? this.environment.fetchModule.bind(this.environment)\n                      : undefined,\n                  loadModule: this.load.bind(this),\n                  id,\n                })\n              },\n\n              resolveId: async (source: string, importer?: string) => {\n                const r = await this.resolve(source, importer)\n\n                if (r) {\n                  if (!r.external) {\n                    return cleanId(r.id)\n                  }\n                }\n\n                return null\n              },\n            })\n\n            compilers.set(this.environment.name, compiler)\n          }\n\n          // Detect which kinds are present in this file before parsing\n          const detectedKinds = detectKindsInCode(code, environment.type)\n\n          const result = await compiler.compile({\n            id,\n            code,\n            detectedKinds,\n          })\n          return result\n        },\n      },\n\n      hotUpdate(ctx) {\n        const compiler = compilers.get(this.environment.name)\n\n        ctx.modules.forEach((m) => {\n          if (m.id) {\n            const deleted = compiler?.invalidateModule(m.id)\n            if (deleted) {\n              m.importers.forEach((importer) => {\n                if (importer.id) {\n                  compiler?.invalidateModule(importer.id)\n                }\n              })\n            }\n          }\n        })\n      },\n    }\n  }\n\n  return [\n    ...opts.environments.map(perEnvServerFnPlugin),\n    {\n      name: 'tanstack-start-core:capture-server-fn-module-lookup',\n      // we only need this plugin in dev mode\n      apply: 'serve',\n      applyToEnvironment(env) {\n        return !!opts.environments.find((e) => e.name === env.name)\n      },\n      transform: {\n        filter: {\n          id: new RegExp(`${SERVER_FN_LOOKUP}$`),\n        },\n        handler(code, id) {\n          const compiler = compilers.get(this.environment.name)\n          compiler?.ingestModule({ code, id: cleanId(id) })\n        },\n      },\n    },\n    // Validate server function ID in dev mode\n    {\n      name: 'tanstack-start-core:validate-server-fn-id',\n      apply: 'serve',\n      load: {\n        filter: {\n          id: new RegExp(resolveViteId(validateServerFnIdVirtualModule)),\n        },\n        async handler(id) {\n          const parsed = parseIdQuery(id)\n          const fnId = parsed.query.id\n          if (fnId && serverFnsById[fnId]) {\n            return `export {}`\n          }\n\n          // ID not yet registered — the source file may not have been\n          // transformed in this dev session yet (e.g. cold restart with\n          // cached client). Try to decode the ID, discover the source\n          // file, trigger its compilation, and re-check.\n          if (fnId) {\n            try {\n              const decoded = JSON.parse(\n                Buffer.from(fnId, 'base64url').toString('utf8'),\n              )\n              if (\n                typeof decoded.file === 'string' &&\n                typeof decoded.export === 'string'\n              ) {\n                // Use the Vite strategy to decode the module specifier\n                // back to the original source file path.\n                const sourceFile = decodeViteDevServerModuleSpecifier(\n                  decoded.file,\n                )\n\n                if (sourceFile) {\n                  // Resolve to absolute path\n                  const absPath = resolvePath(root, sourceFile)\n\n                  // Trigger transform of the source file in this environment,\n                  // which will compile createServerFn calls and populate\n                  // serverFnsById as a side effect.\n                  // This plugin only runs in dev (apply: 'serve'), so mode\n                  // must be 'dev' — assert to narrow to DevEnvironment.\n                  assert(this.environment.mode === 'dev')\n                  await this.environment.fetchModule(absPath)\n\n                  // Re-check after lazy compilation\n                  if (serverFnsById[fnId]) {\n                    return `export {}`\n                  }\n                }\n              }\n            } catch {\n              // Decoding or fetching failed — fall through to error\n            }\n          }\n\n          this.error(`Invalid server function ID: ${fnId}`)\n        },\n      },\n    },\n    // Manifest plugin for server environments\n    createVirtualModule({\n      name: 'tanstack-start-core:server-fn-resolver',\n      moduleId: VIRTUAL_MODULES.serverFnResolver,\n      enforce: 'pre',\n      applyToEnvironment: (env) => {\n        return appliedResolverEnvironments.has(env.name)\n      },\n      load() {\n        if (this.environment.name !== opts.providerEnvName) {\n          const mod = opts.environments.find(\n            (e) => e.name === this.environment.name,\n          )?.getServerFnById\n          if (mod) {\n            return mod\n          }\n\n          this.error(\n            `No getServerFnById implementation found for caller environment: ${this.environment.name}`,\n          )\n        }\n\n        if (this.environment.mode !== 'build') {\n          return getDevServerFnValidatorModule()\n        }\n\n        // When SSR is the provider, server-only-referenced functions aren't in the manifest,\n        // so no isClientReferenced check is needed.\n        // When SSR is NOT the provider (custom provider env), server-only-referenced\n        // functions ARE in the manifest and need the isClientReferenced check to\n        // block direct client HTTP requests to server-only-referenced functions.\n        return generateServerFnResolverModule({\n          serverFnsById,\n          includeClientReferencedCheck: !ssrIsProvider,\n        })\n      },\n    }),\n  ]\n}\n"],"mappings":"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"}

package/dist/esm/vite/start-manifest-plugin/plugin.js

@@ -1,45 +1,34 @@
 import { ENTRY_POINTS, START_ENVIRONMENT_NAMES } from "../../constants.js";
-import { resolveViteId } from "../../utils.js";
+import { createVirtualModule } from "../createVirtualModule.js";
 import { buildStartManifest, serializeStartManifest } from "../../start-manifest-plugin/manifestBuilder.js";
 import { VIRTUAL_MODULES } from "@tanstack/start-server-core";
 import { joinURL } from "ufo";
 //#region src/vite/start-manifest-plugin/plugin.ts
-var resolvedModuleId = resolveViteId(VIRTUAL_MODULES.startManifest);
 function startManifestPlugin(opts) {
-	return {
+	return createVirtualModule({
 		name: "tanstack-start:start-manifest-plugin",
+		moduleId: VIRTUAL_MODULES.startManifest,
 		enforce: "pre",
-		resolveId: {
-			filter: { id: new RegExp(VIRTUAL_MODULES.startManifest) },
-			handler(id) {
-				if (id === VIRTUAL_MODULES.startManifest) return resolvedModuleId;
-			}
-		},
-		load: {
-			filter: { id: new RegExp(resolvedModuleId) },
-			handler(id) {
-				const { resolvedStartConfig } = opts.getConfig();
-				if (id === resolvedModuleId) {
-					if (this.environment.name !== START_ENVIRONMENT_NAMES.server) return "export default {}";
-					if (this.environment.config.command === "serve") return `export const tsrStartManifest = () => ({
+		load() {
+			const { resolvedStartConfig } = opts.getConfig();
+			if (this.environment.name !== START_ENVIRONMENT_NAMES.server) return "export default {}";
+			if (this.environment.config.command === "serve") return `export const tsrStartManifest = () => ({
             routes: {},
             clientEntry: '${joinURL(resolvedStartConfig.basePaths.publicBase, "@id", ENTRY_POINTS.client)}',
           })`;
-					const routeTreeRoutes = globalThis.TSS_ROUTES_MANIFEST;
-					const clientBuild = opts.getClientBuild();
-					if (!clientBuild) return `export const tsrStartManifest = () => ({
+			const routeTreeRoutes = globalThis.TSS_ROUTES_MANIFEST;
+			const clientBuild = opts.getClientBuild();
+			if (!clientBuild) return `export const tsrStartManifest = () => ({
               routes: {},
               clientEntry: '${joinURL(resolvedStartConfig.basePaths.publicBase, "@id", ENTRY_POINTS.client)}',
               })`;
-					return `export const tsrStartManifest = () => (${serializeStartManifest(buildStartManifest({
-						clientBuild,
-						routeTreeRoutes,
-						basePath: resolvedStartConfig.basePaths.publicBase
-					}))})`;
-				}
-			}
+			return `export const tsrStartManifest = () => (${serializeStartManifest(buildStartManifest({
+				clientBuild,
+				routeTreeRoutes,
+				basePath: resolvedStartConfig.basePaths.publicBase
+			}))})`;
 		}
-	};
+	});
 }
 //#endregion
 export { startManifestPlugin };

package/dist/esm/vite/start-manifest-plugin/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","names":[],"sources":["../../../../src/vite/start-manifest-plugin/plugin.ts"],"sourcesContent":["import { joinURL } from 'ufo'\nimport { VIRTUAL_MODULES } from '@tanstack/start-server-core'\nimport { resolveViteId } from '../../utils'\nimport { ENTRY_POINTS, START_ENVIRONMENT_NAMES } from '../../constants'\nimport {\n  buildStartManifest,\n  serializeStartManifest,\n} from '../../start-manifest-plugin/manifestBuilder'\nimport type { GetConfigFn, NormalizedClientBuild } from '../../types'\nimport type { PluginOption } from 'vite'\n\nconst resolvedModuleId = resolveViteId(VIRTUAL_MODULES.startManifest)\n\nexport function startManifestPlugin(opts: {\n  getClientBuild: () => NormalizedClientBuild | undefined\n  getConfig: GetConfigFn\n}): PluginOption {\n  return {\n    name: 'tanstack-start:start-manifest-plugin',\n    enforce: 'pre',\n    resolveId: {\n      filter: { id: new RegExp(VIRTUAL_MODULES.startManifest) },\n      handler(id) {\n        if (id === VIRTUAL_MODULES.startManifest) {\n          return resolvedModuleId\n        }\n        return undefined\n      },\n    },\n    load: {\n      filter: {\n        id: new RegExp(resolvedModuleId),\n      },\n      handler(id) {\n        const { resolvedStartConfig } = opts.getConfig()\n        if (id === resolvedModuleId) {\n          if (this.environment.name !== START_ENVIRONMENT_NAMES.server) {\n            return 'export default {}'\n          }\n\n          if (this.environment.config.command === 'serve') {\n            return `export const tsrStartManifest = () => ({\n            routes: {},\n            clientEntry: '${joinURL(resolvedStartConfig.basePaths.publicBase, '@id', ENTRY_POINTS.client)}',\n          })`\n          }\n\n          const routeTreeRoutes = globalThis.TSS_ROUTES_MANIFEST\n          const clientBuild = opts.getClientBuild()\n          // TODO this needs further discussion with vite-rsc, this is a temporary workaround\n          // If the client bundle isn't available yet (e.g., during RSC scan builds),\n          // return a dummy manifest. The real manifest will be generated in the actual build.\n          if (!clientBuild) {\n            return `export const tsrStartManifest = () => ({\n              routes: {},\n              clientEntry: '${joinURL(resolvedStartConfig.basePaths.publicBase, '@id', ENTRY_POINTS.client)}',\n              })`\n          }\n          const startManifest = buildStartManifest({\n            clientBuild,\n            routeTreeRoutes,\n            basePath: resolvedStartConfig.basePaths.publicBase,\n          })\n\n          return `export const tsrStartManifest = () => (${serializeStartManifest(startManifest)})`\n        }\n\n        return undefined\n      },\n    },\n  }\n}\n"],"mappings":";;;;;;AAWA,IAAM,mBAAmB,cAAc,gBAAgB,cAAc;AAErE,SAAgB,oBAAoB,MAGnB;AACf,QAAO;EACL,MAAM;EACN,SAAS;EACT,WAAW;GACT,QAAQ,EAAE,IAAI,IAAI,OAAO,gBAAgB,cAAc,EAAE;GACzD,QAAQ,IAAI;AACV,QAAI,OAAO,gBAAgB,cACzB,QAAO;;GAIZ;EACD,MAAM;GACJ,QAAQ,EACN,IAAI,IAAI,OAAO,iBAAiB,EACjC;GACD,QAAQ,IAAI;IACV,MAAM,EAAE,wBAAwB,KAAK,WAAW;AAChD,QAAI,OAAO,kBAAkB;AAC3B,SAAI,KAAK,YAAY,SAAS,wBAAwB,OACpD,QAAO;AAGT,SAAI,KAAK,YAAY,OAAO,YAAY,QACtC,QAAO;;4BAES,QAAQ,oBAAoB,UAAU,YAAY,OAAO,aAAa,OAAO,CAAC;;KAIhG,MAAM,kBAAkB,WAAW;KACnC,MAAM,cAAc,KAAK,gBAAgB;AAIzC,SAAI,CAAC,YACH,QAAO;;8BAEW,QAAQ,oBAAoB,UAAU,YAAY,OAAO,aAAa,OAAO,CAAC;;AASlG,YAAO,0CAA0C,uBAN3B,mBAAmB;MACvC;MACA;MACA,UAAU,oBAAoB,UAAU;MACzC,CAAC,CAEoF,CAAC;;;GAK5F;EACF"}
+{"version":3,"file":"plugin.js","names":[],"sources":["../../../../src/vite/start-manifest-plugin/plugin.ts"],"sourcesContent":["import { joinURL } from 'ufo'\nimport { VIRTUAL_MODULES } from '@tanstack/start-server-core'\nimport { ENTRY_POINTS, START_ENVIRONMENT_NAMES } from '../../constants'\nimport {\n  buildStartManifest,\n  serializeStartManifest,\n} from '../../start-manifest-plugin/manifestBuilder'\nimport { createVirtualModule } from '../createVirtualModule'\nimport type { GetConfigFn, NormalizedClientBuild } from '../../types'\nimport type { PluginOption } from 'vite'\n\nexport function startManifestPlugin(opts: {\n  getClientBuild: () => NormalizedClientBuild | undefined\n  getConfig: GetConfigFn\n}): PluginOption {\n  return createVirtualModule({\n    name: 'tanstack-start:start-manifest-plugin',\n    moduleId: VIRTUAL_MODULES.startManifest,\n    enforce: 'pre',\n    load() {\n      const { resolvedStartConfig } = opts.getConfig()\n      if (this.environment.name !== START_ENVIRONMENT_NAMES.server) {\n        return 'export default {}'\n      }\n\n      if (this.environment.config.command === 'serve') {\n        return `export const tsrStartManifest = () => ({\n            routes: {},\n            clientEntry: '${joinURL(resolvedStartConfig.basePaths.publicBase, '@id', ENTRY_POINTS.client)}',\n          })`\n      }\n\n      const routeTreeRoutes = globalThis.TSS_ROUTES_MANIFEST\n      const clientBuild = opts.getClientBuild()\n      // TODO this needs further discussion with vite-rsc, this is a temporary workaround\n      // If the client bundle isn't available yet (e.g., during RSC scan builds),\n      // return a dummy manifest. The real manifest will be generated in the actual build.\n      if (!clientBuild) {\n        return `export const tsrStartManifest = () => ({\n              routes: {},\n              clientEntry: '${joinURL(resolvedStartConfig.basePaths.publicBase, '@id', ENTRY_POINTS.client)}',\n              })`\n      }\n      const startManifest = buildStartManifest({\n        clientBuild,\n        routeTreeRoutes,\n        basePath: resolvedStartConfig.basePaths.publicBase,\n      })\n\n      return `export const tsrStartManifest = () => (${serializeStartManifest(startManifest)})`\n    },\n  })\n}\n"],"mappings":";;;;;;AAWA,SAAgB,oBAAoB,MAGnB;AACf,QAAO,oBAAoB;EACzB,MAAM;EACN,UAAU,gBAAgB;EAC1B,SAAS;EACT,OAAO;GACL,MAAM,EAAE,wBAAwB,KAAK,WAAW;AAChD,OAAI,KAAK,YAAY,SAAS,wBAAwB,OACpD,QAAO;AAGT,OAAI,KAAK,YAAY,OAAO,YAAY,QACtC,QAAO;;4BAEa,QAAQ,oBAAoB,UAAU,YAAY,OAAO,aAAa,OAAO,CAAC;;GAIpG,MAAM,kBAAkB,WAAW;GACnC,MAAM,cAAc,KAAK,gBAAgB;AAIzC,OAAI,CAAC,YACH,QAAO;;8BAEe,QAAQ,oBAAoB,UAAU,YAAY,OAAO,aAAa,OAAO,CAAC;;AAStG,UAAO,0CAA0C,uBAN3B,mBAAmB;IACvC;IACA;IACA,UAAU,oBAAoB,UAAU;IACzC,CAAC,CAEoF,CAAC;;EAE1F,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/start-plugin-core",
-  "version": "1.167.31",
+  "version": "1.167.33",
   "description": "Modern and scalable routing for React applications",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -40,11 +40,6 @@
         "default": "./dist/esm/utils.js"
       }
     },
-    "./vite/types": {
-      "import": {
-        "types": "./dist/esm/vite/types.d.ts"
-      }
-    },
     "./package.json": "./package.json"
   },
   "sideEffects": false,
@@ -73,8 +68,8 @@
     "xmlbuilder2": "^4.0.3",
     "zod": "^3.24.2",
     "@tanstack/router-core": "1.168.14",
-    "@tanstack/router-generator": "1.166.30",
-    "@tanstack/router-plugin": "1.167.20",
+    "@tanstack/router-generator": "1.166.31",
+    "@tanstack/router-plugin": "1.167.21",
     "@tanstack/router-utils": "1.161.6",
     "@tanstack/start-client-core": "1.167.16",
     "@tanstack/start-server-core": "1.167.18"

package/src/index.ts

@@ -1,6 +1,10 @@
 export type { TanStackStartInputConfig } from './schema'
 export type { TanStackStartCoreOptions } from './types'
-export type { TanStackStartVitePluginCoreOptions } from './vite/types'
+export type {
+  TanStackStartVitePluginCoreOptions,
+  ViteRscForwardSsrResolverStrategy,
+} from './vite/types'
 export type { TanStackStartViteInputConfig } from './vite/schema'
 export { START_ENVIRONMENT_NAMES, VITE_ENVIRONMENT_NAMES } from './constants'
+export { createVirtualModule } from './vite/createVirtualModule'
 export { tanStackStartVite } from './vite/plugin'

package/src/vite/createVirtualModule.ts

@@ -0,0 +1,54 @@
+import { resolveViteId } from '../utils'
+import type { Plugin } from 'vite'
+
+type VirtualModuleLoadHandler = (
+  this: any,
+  id: string,
+) => string | null | undefined | Promise<string | null | undefined>
+
+function escapeRegExp(value: string): string {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+}
+
+export function createVirtualModule(opts: {
+  name: string
+  moduleId: string
+  load: VirtualModuleLoadHandler
+  apply?: Plugin['apply']
+  applyToEnvironment?: Plugin['applyToEnvironment']
+  enforce?: Plugin['enforce']
+  sharedDuringBuild?: boolean
+}): Plugin {
+  // Encode '#' as '%23' in the resolved ID to avoid browser treating it as URL fragment.
+  // The browser requests /@id/__x00__%23tanstack-start-plugin-adapters instead of
+  // /@id/__x00__#tanstack-start-plugin-adapters (which would truncate at #).
+  const resolvedId = resolveViteId(opts.moduleId.replaceAll('#', '%23'))
+
+  return {
+    name: opts.name,
+    apply: opts.apply,
+    applyToEnvironment: opts.applyToEnvironment,
+    enforce: opts.enforce,
+    sharedDuringBuild: opts.sharedDuringBuild,
+    resolveId: {
+      filter: { id: new RegExp(escapeRegExp(opts.moduleId)) },
+      handler(id) {
+        if (id === opts.moduleId) {
+          return resolvedId
+        }
+
+        return undefined
+      },
+    },
+    load: {
+      filter: { id: new RegExp(escapeRegExp(resolvedId)) },
+      handler(id) {
+        if (id !== resolvedId) {
+          return undefined
+        }
+
+        return opts.load.call(this, id)
+      },
+    },
+  }
+}

package/src/vite/dev-server-plugin/plugin.ts

@@ -2,7 +2,7 @@ import { isRunnableDevEnvironment } from 'vite'
 import { VIRTUAL_MODULES } from '@tanstack/start-server-core'
 import { NodeRequest, sendNodeResponse } from 'srvx/node'
 import { ENTRY_POINTS, VITE_ENVIRONMENT_NAMES } from '../../constants'
-import { resolveViteId } from '../../utils'
+import { createVirtualModule } from '../createVirtualModule'
 import { extractHtmlScripts } from './extract-html-scripts'
 import {
   CSS_MODULES_REGEX,
@@ -248,27 +248,17 @@ export function devServerPlugin({
         }
       },
     },
-    {
+    createVirtualModule({
       name: 'tanstack-start-core:dev-server:injected-head-scripts',
       sharedDuringBuild: true,
       applyToEnvironment: (env) => env.config.consumer === 'server',
-      resolveId: {
-        filter: { id: new RegExp(VIRTUAL_MODULES.injectedHeadScripts) },
-        handler(_id) {
-          return resolveViteId(VIRTUAL_MODULES.injectedHeadScripts)
-        },
-      },
-      load: {
-        filter: {
-          id: new RegExp(resolveViteId(VIRTUAL_MODULES.injectedHeadScripts)),
-        },
-        handler() {
-          const mod = `
+      moduleId: VIRTUAL_MODULES.injectedHeadScripts,
+      load() {
+        const mod = `
         export const injectedHeadScripts = ${JSON.stringify(injectedHeadScripts) || 'undefined'}`
-          return mod
-        },
+        return mod
       },
-    },
+    }),
   ]
 }
 

package/src/vite/plugin.ts

@@ -25,6 +25,7 @@ import {
   createCaptureClientBuildPlugin,
   createDevBaseRewritePlugin,
   createPostBuildPlugin,
+  createVirtualClientEntryPlugin,
 } from './plugins'
 import { parseStartConfig } from './schema'
 import { startManifestPlugin } from './start-manifest-plugin/plugin'
@@ -237,6 +238,9 @@ export function tanStackStartVite(
     }),
     tanStackStartRouter(normalizedStartPluginOpts, getConfig, corePluginOpts),
     loadEnvPlugin(),
+    createVirtualClientEntryPlugin({
+      getClientEntry: () => configContext.resolveEntries().entryPaths.client,
+    }),
     startManifestPlugin({
       getClientBuild: () => getClientBuild(START_ENVIRONMENT_NAMES.client),
       getConfig,

package/src/vite/plugins.ts

@@ -1,4 +1,6 @@
-import { START_ENVIRONMENT_NAMES } from '../constants'
+import { normalizePath } from 'vite'
+import { ENTRY_POINTS, START_ENVIRONMENT_NAMES } from '../constants'
+import { createVirtualModule } from './createVirtualModule'
 import { normalizeViteClientBuild } from './start-manifest-plugin/normalized-client-build'
 import type {
   GetConfigFn,
@@ -8,6 +10,19 @@ import type {
 import type { StartEnvironmentName } from '../constants'
 import type { PluginOption, ViteBuilder } from 'vite'
 
+export function createVirtualClientEntryPlugin(opts: {
+  getClientEntry: () => string
+}): PluginOption {
+  return createVirtualModule({
+    name: 'tanstack-start-core:virtual-client-entry',
+    moduleId: ENTRY_POINTS.client,
+    enforce: 'pre',
+    load() {
+      return `import ${JSON.stringify(normalizePath(opts.getClientEntry()).replaceAll('\\', '/'))}`
+    },
+  })
+}
+
 export function createPostBuildPlugin(opts: {
   getConfig: GetConfigFn
   postServerBuild: (opts: {

package/src/vite/serialization-adapters-plugin.ts

@@ -4,66 +4,38 @@ import {
   generateSerializationAdaptersModule,
 } from '../serialization-adapters-module'
 import { START_ENVIRONMENT_NAMES } from '../constants'
-import { resolveViteId } from '../utils'
+import { createVirtualModule } from './createVirtualModule'
 import type { SerializationAdapterConfig } from '../types'
 import type { PluginOption } from 'vite'
 
-// Encode '#' as '%23' in the resolved ID to avoid browser treating it as URL fragment.
-// The browser requests /@id/__x00__%23tanstack-start-plugin-adapters instead of
-// /@id/__x00__#tanstack-start-plugin-adapters (which would truncate at #).
-const resolvedModuleId = resolveViteId(
-  VIRTUAL_MODULES.pluginAdapters.replace('#', '%23'),
-)
-
-function escapeRegex(str: string): string {
-  return str.replace(/[.*+?^${}()|[\]\\#]/g, '\\$&')
-}
-
 export function serializationAdaptersPlugin(opts: {
   adapters: Array<SerializationAdapterConfig> | undefined
 }): PluginOption {
-  return {
+  return createVirtualModule({
     name: 'tanstack-start:plugin-adapters',
+    moduleId: VIRTUAL_MODULES.pluginAdapters,
     enforce: 'pre',
-    resolveId: {
-      filter: { id: new RegExp(escapeRegex(VIRTUAL_MODULES.pluginAdapters)) },
-      handler(id: string) {
-        if (id === VIRTUAL_MODULES.pluginAdapters) {
-          return resolvedModuleId
-        }
-        return undefined
-      },
-    },
-    load: {
-      filter: {
-        id: new RegExp(escapeRegex(resolvedModuleId)),
-      },
-      handler(this: { environment: { name: string } }, id: string) {
-        if (id !== resolvedModuleId) {
-          return undefined
-        }
-
-        const adapters = opts.adapters
-        if (!adapters || adapters.length === 0) {
-          return EMPTY_SERIALIZATION_ADAPTERS_MODULE
-        }
+    load() {
+      const adapters = opts.adapters
+      if (!adapters || adapters.length === 0) {
+        return EMPTY_SERIALIZATION_ADAPTERS_MODULE
+      }
 
-        if (this.environment.name === START_ENVIRONMENT_NAMES.client) {
-          return generateSerializationAdaptersModule({
-            adapters,
-            runtime: 'client',
-          })
-        }
+      if (this.environment.name === START_ENVIRONMENT_NAMES.client) {
+        return generateSerializationAdaptersModule({
+          adapters,
+          runtime: 'client',
+        })
+      }
 
-        if (this.environment.name === START_ENVIRONMENT_NAMES.server) {
-          return generateSerializationAdaptersModule({
-            adapters,
-            runtime: 'server',
-          })
-        }
+      if (this.environment.name === START_ENVIRONMENT_NAMES.server) {
+        return generateSerializationAdaptersModule({
+          adapters,
+          runtime: 'server',
+        })
+      }
 
-        return EMPTY_SERIALIZATION_ADAPTERS_MODULE
-      },
+      return EMPTY_SERIALIZATION_ADAPTERS_MODULE
     },
-  }
+  })
 }

package/src/vite/start-compiler-plugin/plugin.ts

@@ -15,6 +15,8 @@ import {
 import { loadModuleForViteCompiler } from '../../start-compiler/load-module'
 import { generateServerFnResolverModule } from '../../start-compiler/server-fn-resolver-module'
 import { cleanId } from '../../start-compiler/utils'
+import { createVirtualModule } from '../createVirtualModule'
+import { resolveViteId } from '../../utils'
 import {
   createViteDevServerFnModuleSpecifierEncoder,
   decodeViteDevServerModuleSpecifier,
@@ -29,10 +31,6 @@ import type { PluginOption } from 'vite'
 // Re-export from shared constants for backwards compatibility
 export { SERVER_FN_LOOKUP }
 
-function resolveViteId(id: string) {
-  return `\0${id}`
-}
-
 const validateServerFnIdVirtualModule = `virtual:tanstack-start-validate-server-fn-id`
 
 function getDevServerFnValidatorModule(): string {
@@ -90,10 +88,6 @@ export function startCompilerPlugin(
   }
 
   let root = process.cwd()
-  const resolvedResolverVirtualImportId = resolveViteId(
-    VIRTUAL_MODULES.serverFnResolver,
-  )
-
   // Determine which environments need the resolver (getServerFnById)
   // SSR environment always needs the resolver for server-side calls
   // Provider environment needs it for the actual implementation
@@ -294,52 +288,41 @@ export function startCompilerPlugin(
       },
     },
     // Manifest plugin for server environments
-    {
+    createVirtualModule({
       name: 'tanstack-start-core:server-fn-resolver',
+      moduleId: VIRTUAL_MODULES.serverFnResolver,
       enforce: 'pre',
       applyToEnvironment: (env) => {
         return appliedResolverEnvironments.has(env.name)
       },
-      configResolved(config) {
-        root = config.root
-      },
-      resolveId: {
-        filter: { id: new RegExp(VIRTUAL_MODULES.serverFnResolver) },
-        handler() {
-          return resolvedResolverVirtualImportId
-        },
-      },
-      load: {
-        filter: { id: new RegExp(resolvedResolverVirtualImportId) },
-        handler() {
-          if (this.environment.name !== opts.providerEnvName) {
-            const mod = opts.environments.find(
-              (e) => e.name === this.environment.name,
-            )?.getServerFnById
-            if (mod) {
-              return mod
-            } else {
-              this.error(
-                `No getServerFnById implementation found for caller environment: ${this.environment.name}`,
-              )
-            }
-          }
-
-          if (this.environment.mode !== 'build') {
-            return getDevServerFnValidatorModule()
+      load() {
+        if (this.environment.name !== opts.providerEnvName) {
+          const mod = opts.environments.find(
+            (e) => e.name === this.environment.name,
+          )?.getServerFnById
+          if (mod) {
+            return mod
           }
 
-          // When SSR is the provider, server-only-referenced functions aren't in the manifest,
-          // so no isClientReferenced check is needed.
-          // When SSR is NOT the provider (custom provider env), server-only-referenced
-          // functions ARE in the manifest and need the isClientReferenced check to
-          // block direct client HTTP requests to server-only-referenced functions.
-          return generateServerFnResolverModule({
-            serverFnsById,
-            includeClientReferencedCheck: !ssrIsProvider,
-          })
-        },
+          this.error(
+            `No getServerFnById implementation found for caller environment: ${this.environment.name}`,
+          )
+        }
+
+        if (this.environment.mode !== 'build') {
+          return getDevServerFnValidatorModule()
+        }
+
+        // When SSR is the provider, server-only-referenced functions aren't in the manifest,
+        // so no isClientReferenced check is needed.
+        // When SSR is NOT the provider (custom provider env), server-only-referenced
+        // functions ARE in the manifest and need the isClientReferenced check to
+        // block direct client HTTP requests to server-only-referenced functions.
+        return generateServerFnResolverModule({
+          serverFnsById,
+          includeClientReferencedCheck: !ssrIsProvider,
+        })
       },
-    },
+    }),
   ]
 }

package/src/vite/start-manifest-plugin/plugin.ts

@@ -1,72 +1,53 @@
 import { joinURL } from 'ufo'
 import { VIRTUAL_MODULES } from '@tanstack/start-server-core'
-import { resolveViteId } from '../../utils'
 import { ENTRY_POINTS, START_ENVIRONMENT_NAMES } from '../../constants'
 import {
   buildStartManifest,
   serializeStartManifest,
 } from '../../start-manifest-plugin/manifestBuilder'
+import { createVirtualModule } from '../createVirtualModule'
 import type { GetConfigFn, NormalizedClientBuild } from '../../types'
 import type { PluginOption } from 'vite'
 
-const resolvedModuleId = resolveViteId(VIRTUAL_MODULES.startManifest)
-
 export function startManifestPlugin(opts: {
   getClientBuild: () => NormalizedClientBuild | undefined
   getConfig: GetConfigFn
 }): PluginOption {
-  return {
+  return createVirtualModule({
     name: 'tanstack-start:start-manifest-plugin',
+    moduleId: VIRTUAL_MODULES.startManifest,
     enforce: 'pre',
-    resolveId: {
-      filter: { id: new RegExp(VIRTUAL_MODULES.startManifest) },
-      handler(id) {
-        if (id === VIRTUAL_MODULES.startManifest) {
-          return resolvedModuleId
-        }
-        return undefined
-      },
-    },
-    load: {
-      filter: {
-        id: new RegExp(resolvedModuleId),
-      },
-      handler(id) {
-        const { resolvedStartConfig } = opts.getConfig()
-        if (id === resolvedModuleId) {
-          if (this.environment.name !== START_ENVIRONMENT_NAMES.server) {
-            return 'export default {}'
-          }
+    load() {
+      const { resolvedStartConfig } = opts.getConfig()
+      if (this.environment.name !== START_ENVIRONMENT_NAMES.server) {
+        return 'export default {}'
+      }
 
-          if (this.environment.config.command === 'serve') {
-            return `export const tsrStartManifest = () => ({
+      if (this.environment.config.command === 'serve') {
+        return `export const tsrStartManifest = () => ({
             routes: {},
             clientEntry: '${joinURL(resolvedStartConfig.basePaths.publicBase, '@id', ENTRY_POINTS.client)}',
           })`
-          }
+      }
 
-          const routeTreeRoutes = globalThis.TSS_ROUTES_MANIFEST
-          const clientBuild = opts.getClientBuild()
-          // TODO this needs further discussion with vite-rsc, this is a temporary workaround
-          // If the client bundle isn't available yet (e.g., during RSC scan builds),
-          // return a dummy manifest. The real manifest will be generated in the actual build.
-          if (!clientBuild) {
-            return `export const tsrStartManifest = () => ({
+      const routeTreeRoutes = globalThis.TSS_ROUTES_MANIFEST
+      const clientBuild = opts.getClientBuild()
+      // TODO this needs further discussion with vite-rsc, this is a temporary workaround
+      // If the client bundle isn't available yet (e.g., during RSC scan builds),
+      // return a dummy manifest. The real manifest will be generated in the actual build.
+      if (!clientBuild) {
+        return `export const tsrStartManifest = () => ({
               routes: {},
               clientEntry: '${joinURL(resolvedStartConfig.basePaths.publicBase, '@id', ENTRY_POINTS.client)}',
               })`
-          }
-          const startManifest = buildStartManifest({
-            clientBuild,
-            routeTreeRoutes,
-            basePath: resolvedStartConfig.basePaths.publicBase,
-          })
-
-          return `export const tsrStartManifest = () => (${serializeStartManifest(startManifest)})`
-        }
+      }
+      const startManifest = buildStartManifest({
+        clientBuild,
+        routeTreeRoutes,
+        basePath: resolvedStartConfig.basePaths.publicBase,
+      })
 
-        return undefined
-      },
+      return `export const tsrStartManifest = () => (${serializeStartManifest(startManifest)})`
     },
-  }
+  })
 }