@tanstack/start-plugin-core 1.166.12 → 1.166.14

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

@@ -1,38 +1,28 @@
 import * as t from "@babel/types";
+//#region src/start-compiler-plugin/handleEnvOnly.ts
 function capitalize(str) {
-  return str.charAt(0).toUpperCase() + str.slice(1).toLowerCase();
+	if (!str) return "";
+	return str.charAt(0).toUpperCase() + str.slice(1).toLowerCase();
 }
+/**
+* Handles serverOnly/clientOnly function transformations for a batch of candidates.
+*
+* @param candidates - All EnvOnly candidates to process (all same kind)
+* @param context - The compilation context
+* @param kind - The specific kind (ServerOnlyFn or ClientOnlyFn)
+*/
 function handleEnvOnlyFn(candidates, context, kind) {
-  const targetEnv = kind === "ClientOnlyFn" ? "client" : "server";
-  for (const candidate of candidates) {
-    const { path } = candidate;
-    if (context.env === targetEnv) {
-      const innerFn = path.node.arguments[0];
-      if (!t.isExpression(innerFn)) {
-        throw new Error(
-          `create${capitalize(targetEnv)}OnlyFn() must be called with a function!`
-        );
-      }
-      path.replaceWith(innerFn);
-    } else {
-      path.replaceWith(
-        t.arrowFunctionExpression(
-          [],
-          t.blockStatement([
-            t.throwStatement(
-              t.newExpression(t.identifier("Error"), [
-                t.stringLiteral(
-                  `create${capitalize(targetEnv)}OnlyFn() functions can only be called on the ${targetEnv}!`
-                )
-              ])
-            )
-          ])
-        )
-      );
-    }
-  }
+	const targetEnv = kind === "ClientOnlyFn" ? "client" : "server";
+	for (const candidate of candidates) {
+		const { path } = candidate;
+		if (context.env === targetEnv) {
+			const innerFn = path.node.arguments[0];
+			if (!t.isExpression(innerFn)) throw new Error(`create${capitalize(targetEnv)}OnlyFn() must be called with a function!`);
+			path.replaceWith(innerFn);
+		} else path.replaceWith(t.arrowFunctionExpression([], t.blockStatement([t.throwStatement(t.newExpression(t.identifier("Error"), [t.stringLiteral(`create${capitalize(targetEnv)}OnlyFn() functions can only be called on the ${targetEnv}!`)]))])));
+	}
 }
-export {
-  handleEnvOnlyFn
-};
-//# sourceMappingURL=handleEnvOnly.js.map
+//#endregion
+export { handleEnvOnlyFn };
+
+//# sourceMappingURL=handleEnvOnly.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"handleEnvOnly.js","sources":["../../../src/start-compiler-plugin/handleEnvOnly.ts"],"sourcesContent":["import * as t from '@babel/types'\nimport type { CompilationContext, RewriteCandidate } from './types'\nimport type { LookupKind } from './compiler'\n\nfunction capitalize(str: string) {\n  if (!str) return ''\n  return str.charAt(0).toUpperCase() + str.slice(1).toLowerCase()\n}\n\n/**\n * Handles serverOnly/clientOnly function transformations for a batch of candidates.\n *\n * @param candidates - All EnvOnly candidates to process (all same kind)\n * @param context - The compilation context\n * @param kind - The specific kind (ServerOnlyFn or ClientOnlyFn)\n */\nexport function handleEnvOnlyFn(\n  candidates: Array<RewriteCandidate>,\n  context: CompilationContext,\n  kind: LookupKind,\n): void {\n  const targetEnv = kind === 'ClientOnlyFn' ? 'client' : 'server'\n\n  for (const candidate of candidates) {\n    const { path } = candidate\n\n    if (context.env === targetEnv) {\n      // Matching environment - extract the inner function\n      const innerFn = path.node.arguments[0]\n\n      if (!t.isExpression(innerFn)) {\n        throw new Error(\n          `create${capitalize(targetEnv)}OnlyFn() must be called with a function!`,\n        )\n      }\n\n      path.replaceWith(innerFn)\n    } else {\n      // Wrong environment - replace with a function that throws an error\n      path.replaceWith(\n        t.arrowFunctionExpression(\n          [],\n          t.blockStatement([\n            t.throwStatement(\n              t.newExpression(t.identifier('Error'), [\n                t.stringLiteral(\n                  `create${capitalize(targetEnv)}OnlyFn() functions can only be called on the ${targetEnv}!`,\n                ),\n              ]),\n            ),\n          ]),\n        ),\n      )\n    }\n  }\n}\n"],"names":[],"mappings":";AAIA,SAAS,WAAW,KAAa;AAE/B,SAAO,IAAI,OAAO,CAAC,EAAE,gBAAgB,IAAI,MAAM,CAAC,EAAE,YAAA;AACpD;AASO,SAAS,gBACd,YACA,SACA,MACM;AACN,QAAM,YAAY,SAAS,iBAAiB,WAAW;AAEvD,aAAW,aAAa,YAAY;AAClC,UAAM,EAAE,SAAS;AAEjB,QAAI,QAAQ,QAAQ,WAAW;AAE7B,YAAM,UAAU,KAAK,KAAK,UAAU,CAAC;AAErC,UAAI,CAAC,EAAE,aAAa,OAAO,GAAG;AAC5B,cAAM,IAAI;AAAA,UACR,SAAS,WAAW,SAAS,CAAC;AAAA,QAAA;AAAA,MAElC;AAEA,WAAK,YAAY,OAAO;AAAA,IAC1B,OAAO;AAEL,WAAK;AAAA,QACH,EAAE;AAAA,UACA,CAAA;AAAA,UACA,EAAE,eAAe;AAAA,YACf,EAAE;AAAA,cACA,EAAE,cAAc,EAAE,WAAW,OAAO,GAAG;AAAA,gBACrC,EAAE;AAAA,kBACA,SAAS,WAAW,SAAS,CAAC,gDAAgD,SAAS;AAAA,gBAAA;AAAA,cACzF,CACD;AAAA,YAAA;AAAA,UACH,CACD;AAAA,QAAA;AAAA,MACH;AAAA,IAEJ;AAAA,EACF;AACF;"}
+{"version":3,"file":"handleEnvOnly.js","names":[],"sources":["../../../src/start-compiler-plugin/handleEnvOnly.ts"],"sourcesContent":["import * as t from '@babel/types'\nimport type { CompilationContext, RewriteCandidate } from './types'\nimport type { LookupKind } from './compiler'\n\nfunction capitalize(str: string) {\n  if (!str) return ''\n  return str.charAt(0).toUpperCase() + str.slice(1).toLowerCase()\n}\n\n/**\n * Handles serverOnly/clientOnly function transformations for a batch of candidates.\n *\n * @param candidates - All EnvOnly candidates to process (all same kind)\n * @param context - The compilation context\n * @param kind - The specific kind (ServerOnlyFn or ClientOnlyFn)\n */\nexport function handleEnvOnlyFn(\n  candidates: Array<RewriteCandidate>,\n  context: CompilationContext,\n  kind: LookupKind,\n): void {\n  const targetEnv = kind === 'ClientOnlyFn' ? 'client' : 'server'\n\n  for (const candidate of candidates) {\n    const { path } = candidate\n\n    if (context.env === targetEnv) {\n      // Matching environment - extract the inner function\n      const innerFn = path.node.arguments[0]\n\n      if (!t.isExpression(innerFn)) {\n        throw new Error(\n          `create${capitalize(targetEnv)}OnlyFn() must be called with a function!`,\n        )\n      }\n\n      path.replaceWith(innerFn)\n    } else {\n      // Wrong environment - replace with a function that throws an error\n      path.replaceWith(\n        t.arrowFunctionExpression(\n          [],\n          t.blockStatement([\n            t.throwStatement(\n              t.newExpression(t.identifier('Error'), [\n                t.stringLiteral(\n                  `create${capitalize(targetEnv)}OnlyFn() functions can only be called on the ${targetEnv}!`,\n                ),\n              ]),\n            ),\n          ]),\n        ),\n      )\n    }\n  }\n}\n"],"mappings":";;AAIA,SAAS,WAAW,KAAa;AAC/B,KAAI,CAAC,IAAK,QAAO;AACjB,QAAO,IAAI,OAAO,EAAE,CAAC,aAAa,GAAG,IAAI,MAAM,EAAE,CAAC,aAAa;;;;;;;;;AAUjE,SAAgB,gBACd,YACA,SACA,MACM;CACN,MAAM,YAAY,SAAS,iBAAiB,WAAW;AAEvD,MAAK,MAAM,aAAa,YAAY;EAClC,MAAM,EAAE,SAAS;AAEjB,MAAI,QAAQ,QAAQ,WAAW;GAE7B,MAAM,UAAU,KAAK,KAAK,UAAU;AAEpC,OAAI,CAAC,EAAE,aAAa,QAAQ,CAC1B,OAAM,IAAI,MACR,SAAS,WAAW,UAAU,CAAC,0CAChC;AAGH,QAAK,YAAY,QAAQ;QAGzB,MAAK,YACH,EAAE,wBACA,EAAE,EACF,EAAE,eAAe,CACf,EAAE,eACA,EAAE,cAAc,EAAE,WAAW,QAAQ,EAAE,CACrC,EAAE,cACA,SAAS,WAAW,UAAU,CAAC,+CAA+C,UAAU,GACzF,CACF,CAAC,CACH,CACF,CAAC,CACH,CACF"}

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

@@ -1,102 +1,101 @@
-import assert from "node:assert";
-import { VIRTUAL_MODULES } from "@tanstack/start-server-core";
-import { resolve } from "pathe";
-import { VITE_ENVIRONMENT_NAMES, SERVER_FN_LOOKUP, TRANSFORM_ID_REGEX } from "../constants.js";
-import { StartCompiler, LookupKindsPerEnv, detectKindsInCode, KindDetectionPatterns } from "./compiler.js";
+import { SERVER_FN_LOOKUP, TRANSFORM_ID_REGEX, VITE_ENVIRONMENT_NAMES } from "../constants.js";
 import { cleanId } from "./utils.js";
+import { KindDetectionPatterns, LookupKindsPerEnv, StartCompiler, detectKindsInCode } from "./compiler.js";
+import { resolve } from "pathe";
+import { VIRTUAL_MODULES } from "@tanstack/start-server-core";
+import assert from "node:assert";
+//#region src/start-compiler-plugin/plugin.ts
 function getTransformCodeFilterForEnv(env) {
-  const validKinds = LookupKindsPerEnv[env];
-  const patterns = [];
-  for (const [kind, pattern] of Object.entries(KindDetectionPatterns)) {
-    if (validKinds.has(kind)) {
-      patterns.push(pattern);
-    }
-  }
-  return patterns;
+	const validKinds = LookupKindsPerEnv[env];
+	const patterns = [];
+	for (const [kind, pattern] of Object.entries(KindDetectionPatterns)) if (validKinds.has(kind)) patterns.push(pattern);
+	return patterns;
 }
-const getLookupConfigurationsForEnv = (env, framework) => {
-  const commonConfigs = [
-    {
-      libName: `@tanstack/${framework}-start`,
-      rootExport: "createServerFn",
-      kind: "Root"
-    },
-    {
-      libName: `@tanstack/${framework}-start`,
-      rootExport: "createIsomorphicFn",
-      kind: "IsomorphicFn"
-    },
-    {
-      libName: `@tanstack/${framework}-start`,
-      rootExport: "createServerOnlyFn",
-      kind: "ServerOnlyFn"
-    },
-    {
-      libName: `@tanstack/${framework}-start`,
-      rootExport: "createClientOnlyFn",
-      kind: "ClientOnlyFn"
-    }
-  ];
-  if (env === "client") {
-    return [
-      {
-        libName: `@tanstack/${framework}-start`,
-        rootExport: "createMiddleware",
-        kind: "Root"
-      },
-      {
-        libName: `@tanstack/${framework}-start`,
-        rootExport: "createStart",
-        kind: "Root"
-      },
-      ...commonConfigs
-    ];
-  } else {
-    return [
-      ...commonConfigs,
-      {
-        libName: `@tanstack/${framework}-router`,
-        rootExport: "ClientOnly",
-        kind: "ClientOnlyJSX"
-      }
-    ];
-  }
+var getLookupConfigurationsForEnv = (env, framework) => {
+	const commonConfigs = [
+		{
+			libName: `@tanstack/${framework}-start`,
+			rootExport: "createServerFn",
+			kind: "Root"
+		},
+		{
+			libName: `@tanstack/${framework}-start`,
+			rootExport: "createIsomorphicFn",
+			kind: "IsomorphicFn"
+		},
+		{
+			libName: `@tanstack/${framework}-start`,
+			rootExport: "createServerOnlyFn",
+			kind: "ServerOnlyFn"
+		},
+		{
+			libName: `@tanstack/${framework}-start`,
+			rootExport: "createClientOnlyFn",
+			kind: "ClientOnlyFn"
+		}
+	];
+	if (env === "client") return [
+		{
+			libName: `@tanstack/${framework}-start`,
+			rootExport: "createMiddleware",
+			kind: "Root"
+		},
+		{
+			libName: `@tanstack/${framework}-start`,
+			rootExport: "createStart",
+			kind: "Root"
+		},
+		...commonConfigs
+	];
+	else return [...commonConfigs, {
+		libName: `@tanstack/${framework}-router`,
+		rootExport: "ClientOnly",
+		kind: "ClientOnlyJSX"
+	}];
 };
 function resolveViteId(id) {
-  return `\0${id}`;
+	return `\0${id}`;
 }
-const validateServerFnIdVirtualModule = `virtual:tanstack-start-validate-server-fn-id`;
+var validateServerFnIdVirtualModule = `virtual:tanstack-start-validate-server-fn-id`;
 function parseIdQuery(id) {
-  if (!id.includes("?")) return { filename: id, query: {} };
-  const [filename, rawQuery] = id.split(`?`, 2);
-  const query = Object.fromEntries(new URLSearchParams(rawQuery));
-  return { filename, query };
+	if (!id.includes("?")) return {
+		filename: id,
+		query: {}
+	};
+	const [filename, rawQuery] = id.split(`?`, 2);
+	return {
+		filename,
+		query: Object.fromEntries(new URLSearchParams(rawQuery))
+	};
 }
+/**
+* Generates the manifest module code for server functions.
+* @param serverFnsById - Map of function IDs to their server function info
+* @param includeClientReferencedCheck - Whether to include isClientReferenced flag and runtime check.
+*   This is needed when SSR is NOT the provider, so server-only-referenced functions in the manifest
+*   can be blocked from client HTTP requests.
+*/
 function generateManifestModule(serverFnsById, includeClientReferencedCheck) {
-  const manifestEntries = Object.entries(serverFnsById).map(([id, fn]) => {
-    const baseEntry = `'${id}': {
+	return `
+    const manifest = {${Object.entries(serverFnsById).map(([id, fn]) => {
+		return `'${id}': {
                 functionName: '${fn.functionName}',
         importer: () => import(${JSON.stringify(fn.extractedFilename)})${includeClientReferencedCheck ? `,
         isClientReferenced: ${fn.isClientReferenced ?? true}` : ""}
       }`;
-    return baseEntry;
-  }).join(",");
-  const getServerFnByIdParams = includeClientReferencedCheck ? "id, opts" : "id";
-  const clientReferencedCheck = includeClientReferencedCheck ? `
-      // If called from client, only allow client-referenced functions
-      if (opts?.fromClient && !serverFnInfo.isClientReferenced) {
-        throw new Error('Server function not accessible from client: ' + id)
-      }
-` : "";
-  return `
-    const manifest = {${manifestEntries}}
+	}).join(",")}}
 
-    export async function getServerFnById(${getServerFnByIdParams}) {
+    export async function getServerFnById(${includeClientReferencedCheck ? "id, opts" : "id"}) {
               const serverFnInfo = manifest[id]
               if (!serverFnInfo) {
                 throw new Error('Server function info not found for ' + id)
               }
-${clientReferencedCheck}
+${includeClientReferencedCheck ? `
+      // If called from client, only allow client-referenced functions
+      if (opts?.fromClient && !serverFnInfo.isClientReferenced) {
+        throw new Error('Server function not accessible from client: ' + id)
+      }
+` : ""}
               const fnModule = await serverFnInfo.importer()
 
               if (!fnModule) {
@@ -119,200 +118,164 @@ ${clientReferencedCheck}
           `;
 }
 function startCompilerPlugin(opts) {
-  const compilers = {};
-  const serverFnsById = {};
-  const onServerFnsById = (d) => {
-    Object.assign(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]
-  );
-  function perEnvServerFnPlugin(environment) {
-    const transformCodeFilter = getTransformCodeFilterForEnv(environment.type);
-    return {
-      name: `tanstack-start-core::server-fn:${environment.name}`,
-      enforce: "pre",
-      applyToEnvironment(env) {
-        return env.name === environment.name;
-      },
-      configResolved(config) {
-        root = config.root;
-        config.command;
-      },
-      transform: {
-        filter: {
-          id: {
-            exclude: new RegExp(`${SERVER_FN_LOOKUP}$`),
-            include: TRANSFORM_ID_REGEX
-          },
-          code: {
-            include: transformCodeFilter
-          }
-        },
-        async handler(code, id) {
-          let compiler = compilers[this.environment.name];
-          if (!compiler) {
-            const mode = this.environment.mode === "build" ? "build" : "dev";
-            compiler = new StartCompiler({
-              env: environment.type,
-              envName: environment.name,
-              root,
-              lookupKinds: LookupKindsPerEnv[environment.type],
-              lookupConfigurations: getLookupConfigurationsForEnv(
-                environment.type,
-                opts.framework
-              ),
-              mode,
-              framework: opts.framework,
-              providerEnvName: opts.providerEnvName,
-              generateFunctionId: opts.generateFunctionId,
-              onServerFnsById,
-              getKnownServerFns: () => serverFnsById,
-              loadModule: async (id2) => {
-                if (this.environment.mode === "build") {
-                  const loaded = await this.load({ id: id2 });
-                  const code2 = loaded.code ?? "";
-                  compiler.ingestModule({ code: code2, id: id2 });
-                } else if (this.environment.mode === "dev") {
-                  await this.environment.fetchModule(
-                    id2 + "?" + SERVER_FN_LOOKUP
-                  );
-                } else {
-                  throw new Error(
-                    `could not load module ${id2}: unknown environment mode ${this.environment.mode}`
-                  );
-                }
-              },
-              resolveId: async (source, importer) => {
-                const r = await this.resolve(source, importer);
-                if (r) {
-                  if (!r.external) {
-                    return cleanId(r.id);
-                  }
-                }
-                return null;
-              }
-            });
-            compilers[this.environment.name] = compiler;
-          }
-          const detectedKinds = detectKindsInCode(code, environment.type);
-          const result = await compiler.compile({
-            id,
-            code,
-            detectedKinds
-          });
-          return result;
-        }
-      },
-      hotUpdate(ctx) {
-        const compiler = compilers[this.environment.name];
-        ctx.modules.forEach((m) => {
-          if (m.id) {
-            const deleted = compiler?.invalidateModule(m.id);
-            if (deleted) {
-              m.importers.forEach((importer) => {
-                if (importer.id) {
-                  compiler?.invalidateModule(importer.id);
-                }
-              });
-            }
-          }
-        });
-      }
-    };
-  }
-  return [
-    ...opts.environments.map(perEnvServerFnPlugin),
-    {
-      name: "tanstack-start-core:capture-server-fn-module-lookup",
-      // we only need this plugin in dev mode
-      apply: "serve",
-      applyToEnvironment(env) {
-        return !!opts.environments.find((e) => e.name === env.name);
-      },
-      transform: {
-        filter: {
-          id: new RegExp(`${SERVER_FN_LOOKUP}$`)
-        },
-        handler(code, id) {
-          const compiler = compilers[this.environment.name];
-          compiler?.ingestModule({ code, id: cleanId(id) });
-        }
-      }
-    },
-    // Validate server function ID in dev mode
-    {
-      name: "tanstack-start-core:validate-server-fn-id",
-      apply: "serve",
-      load: {
-        filter: {
-          id: new RegExp(resolveViteId(validateServerFnIdVirtualModule))
-        },
-        async handler(id) {
-          const parsed = parseIdQuery(id);
-          const fnId = parsed.query.id;
-          if (fnId && serverFnsById[fnId]) {
-            return `export {}`;
-          }
-          if (fnId) {
-            try {
-              const decoded = JSON.parse(
-                Buffer.from(fnId, "base64url").toString("utf8")
-              );
-              if (typeof decoded.file === "string" && typeof decoded.export === "string") {
-                let sourceFile = decoded.file;
-                if (sourceFile.startsWith("/@id/")) {
-                  sourceFile = sourceFile.slice("/@id/".length);
-                }
-                const qIdx = sourceFile.indexOf("?");
-                if (qIdx !== -1) {
-                  sourceFile = sourceFile.slice(0, qIdx);
-                }
-                const absPath = resolve(root, sourceFile);
-                assert(this.environment.mode === "dev");
-                await this.environment.fetchModule(absPath);
-                if (serverFnsById[fnId]) {
-                  return `export {}`;
-                }
-              }
-            } catch {
-            }
-          }
-          this.error(`Invalid server function ID: ${fnId}`);
-        }
-      }
-    },
-    // Manifest plugin for server environments
-    {
-      name: "tanstack-start-core:server-fn-resolver",
-      enforce: "pre",
-      applyToEnvironment: (env) => {
-        return appliedResolverEnvironments.has(env.name);
-      },
-      configResolved(config) {
-        root = config.root;
-        config.command;
-      },
-      resolveId: {
-        filter: { id: new RegExp(VIRTUAL_MODULES.serverFnResolver) },
-        handler() {
-          return resolvedResolverVirtualImportId;
-        }
-      },
-      load: {
-        filter: { id: new RegExp(resolvedResolverVirtualImportId) },
-        handler() {
-          if (this.environment.name !== opts.providerEnvName) {
-            return `export { getServerFnById } from '@tanstack/start-server-core/server-fn-ssr-caller'`;
-          }
-          if (this.environment.mode !== "build") {
-            const mod = `
+	const compilers = {};
+	const serverFnsById = {};
+	const onServerFnsById = (d) => {
+		Object.assign(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]);
+	function perEnvServerFnPlugin(environment) {
+		const transformCodeFilter = getTransformCodeFilterForEnv(environment.type);
+		return {
+			name: `tanstack-start-core::server-fn:${environment.name}`,
+			enforce: "pre",
+			applyToEnvironment(env) {
+				return env.name === environment.name;
+			},
+			configResolved(config) {
+				root = config.root;
+				config.command;
+			},
+			transform: {
+				filter: {
+					id: {
+						exclude: new RegExp(`${SERVER_FN_LOOKUP}$`),
+						include: TRANSFORM_ID_REGEX
+					},
+					code: { include: transformCodeFilter }
+				},
+				async handler(code, id) {
+					let compiler = compilers[this.environment.name];
+					if (!compiler) {
+						const mode = this.environment.mode === "build" ? "build" : "dev";
+						compiler = new StartCompiler({
+							env: environment.type,
+							envName: environment.name,
+							root,
+							lookupKinds: LookupKindsPerEnv[environment.type],
+							lookupConfigurations: getLookupConfigurationsForEnv(environment.type, opts.framework),
+							mode,
+							framework: opts.framework,
+							providerEnvName: opts.providerEnvName,
+							generateFunctionId: opts.generateFunctionId,
+							onServerFnsById,
+							getKnownServerFns: () => serverFnsById,
+							loadModule: async (id) => {
+								if (this.environment.mode === "build") {
+									const code = (await this.load({ id })).code ?? "";
+									compiler.ingestModule({
+										code,
+										id
+									});
+								} else if (this.environment.mode === "dev")
+ /**
+								* in dev, vite does not return code from `ctx.load()`
+								* so instead, we need to take a different approach
+								* we must force vite to load the module and run it through the vite plugin pipeline
+								* we can do this by using the `fetchModule` method
+								* the `captureServerFnModuleLookupPlugin` captures the module code via its transform hook and invokes analyzeModuleAST
+								*/
+								await this.environment.fetchModule(id + "?" + SERVER_FN_LOOKUP);
+								else throw new Error(`could not load module ${id}: unknown environment mode ${this.environment.mode}`);
+							},
+							resolveId: async (source, importer) => {
+								const r = await this.resolve(source, importer);
+								if (r) {
+									if (!r.external) return cleanId(r.id);
+								}
+								return null;
+							}
+						});
+						compilers[this.environment.name] = compiler;
+					}
+					const detectedKinds = detectKindsInCode(code, environment.type);
+					return await compiler.compile({
+						id,
+						code,
+						detectedKinds
+					});
+				}
+			},
+			hotUpdate(ctx) {
+				const compiler = compilers[this.environment.name];
+				ctx.modules.forEach((m) => {
+					if (m.id) {
+						if (compiler?.invalidateModule(m.id)) m.importers.forEach((importer) => {
+							if (importer.id) compiler?.invalidateModule(importer.id);
+						});
+					}
+				});
+			}
+		};
+	}
+	return [
+		...opts.environments.map(perEnvServerFnPlugin),
+		{
+			name: "tanstack-start-core:capture-server-fn-module-lookup",
+			apply: "serve",
+			applyToEnvironment(env) {
+				return !!opts.environments.find((e) => e.name === env.name);
+			},
+			transform: {
+				filter: { id: new RegExp(`${SERVER_FN_LOOKUP}$`) },
+				handler(code, id) {
+					compilers[this.environment.name]?.ingestModule({
+						code,
+						id: cleanId(id)
+					});
+				}
+			}
+		},
+		{
+			name: "tanstack-start-core:validate-server-fn-id",
+			apply: "serve",
+			load: {
+				filter: { id: new RegExp(resolveViteId(validateServerFnIdVirtualModule)) },
+				async handler(id) {
+					const fnId = parseIdQuery(id).query.id;
+					if (fnId && serverFnsById[fnId]) return `export {}`;
+					if (fnId) try {
+						const decoded = JSON.parse(Buffer.from(fnId, "base64url").toString("utf8"));
+						if (typeof decoded.file === "string" && typeof decoded.export === "string") {
+							let sourceFile = decoded.file;
+							if (sourceFile.startsWith("/@id/")) sourceFile = sourceFile.slice(5);
+							const qIdx = sourceFile.indexOf("?");
+							if (qIdx !== -1) sourceFile = sourceFile.slice(0, qIdx);
+							const absPath = resolve(root, sourceFile);
+							assert(this.environment.mode === "dev");
+							await this.environment.fetchModule(absPath);
+							if (serverFnsById[fnId]) return `export {}`;
+						}
+					} catch {}
+					this.error(`Invalid server function ID: ${fnId}`);
+				}
+			}
+		},
+		{
+			name: "tanstack-start-core:server-fn-resolver",
+			enforce: "pre",
+			applyToEnvironment: (env) => {
+				return appliedResolverEnvironments.has(env.name);
+			},
+			configResolved(config) {
+				root = config.root;
+				config.command;
+			},
+			resolveId: {
+				filter: { id: new RegExp(VIRTUAL_MODULES.serverFnResolver) },
+				handler() {
+					return resolvedResolverVirtualImportId;
+				}
+			},
+			load: {
+				filter: { id: new RegExp(resolvedResolverVirtualImportId) },
+				handler() {
+					if (this.environment.name !== opts.providerEnvName) return `export { getServerFnById } from '@tanstack/start-server-core/server-fn-ssr-caller'`;
+					if (this.environment.mode !== "build") return `
             export async function getServerFnById(id) {
               const validateIdImport = ${JSON.stringify(validateServerFnIdVirtualModule)} + '?id=' + id
               await import(/* @vite-ignore */ '/@id/__x00__' + validateIdImport)
@@ -322,20 +285,13 @@ function startCompilerPlugin(opts) {
               return mod[devServerFn.export]
             }
             `;
-            return mod;
-          }
-          const includeClientReferencedCheck = !ssrIsProvider;
-          return generateManifestModule(
-            serverFnsById,
-            includeClientReferencedCheck
-          );
-        }
-      }
-    }
-  ];
+					return generateManifestModule(serverFnsById, !ssrIsProvider);
+				}
+			}
+		}
+	];
 }
-export {
-  SERVER_FN_LOOKUP,
-  startCompilerPlugin
-};
-//# sourceMappingURL=plugin.js.map
+//#endregion
+export { startCompilerPlugin };
+
+//# sourceMappingURL=plugin.js.map