@tanstack/react-start 1.168.60 → 1.169.0

package/dist/default-entry/esm/server.d.ts

@@ -3,6 +3,6 @@ import { RequestHandler } from '@tanstack/react-start/server';
 export type ServerEntry = {
     fetch: RequestHandler<Register>;
 };
-export declare function createServerEntry(entry: ServerEntry): ServerEntry;
+export declare const createServerEntry: (entry: ServerEntry) => ServerEntry;
 declare const _default: ServerEntry;
 export default _default;

package/dist/default-entry/esm/server.js

@@ -1,11 +1,7 @@
-import { createStartHandler, defaultStreamHandler } from "@tanstack/react-start/server";
+import { createServerEntry as createServerEntry$1, createStartHandler, defaultStreamHandler } from "@tanstack/react-start/server";
 //#region src/default-entry/server.ts
 var fetch = createStartHandler(defaultStreamHandler);
-function createServerEntry(entry) {
-	return { async fetch(...args) {
-		return await entry.fetch(...args);
-	} };
-}
+var createServerEntry = createServerEntry$1;
 var server_default = createServerEntry({ fetch });
 //#endregion
 export { createServerEntry, server_default as default };

package/dist/default-entry/esm/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","names":[],"sources":["../../../src/default-entry/server.ts"],"sourcesContent":["import {\n  createStartHandler,\n  defaultStreamHandler,\n} from '@tanstack/react-start/server'\nimport type { Register } from '@tanstack/react-router'\nimport type { RequestHandler } from '@tanstack/react-start/server'\n\nconst fetch = createStartHandler(defaultStreamHandler)\n\n// Providing `RequestHandler` from `@tanstack/react-start/server` is required so that the output types don't import it from `@tanstack/start-server-core`\nexport type ServerEntry = { fetch: RequestHandler<Register> }\n\nexport function createServerEntry(entry: ServerEntry): ServerEntry {\n  return {\n    async fetch(...args) {\n      return await entry.fetch(...args)\n    },\n  }\n}\n\nexport default createServerEntry({ fetch })\n"],"mappings":";;AAOA,IAAM,QAAQ,mBAAmB,oBAAoB;AAKrD,SAAgB,kBAAkB,OAAiC;CACjE,OAAO,EACL,MAAM,MAAM,GAAG,MAAM;EACnB,OAAO,MAAM,MAAM,MAAM,GAAG,IAAI;CAClC,EACF;AACF;AAEA,IAAA,iBAAe,kBAAkB,EAAE,MAAM,CAAC"}
+{"version":3,"file":"server.js","names":["createCoreServerEntry"],"sources":["../../../src/default-entry/server.ts"],"sourcesContent":["import {\n  createStartHandler,\n  defaultStreamHandler,\n  createServerEntry as createCoreServerEntry,\n} from '@tanstack/react-start/server'\nimport type { Register } from '@tanstack/react-router'\nimport type { RequestHandler } from '@tanstack/react-start/server'\n\nconst fetch = createStartHandler(defaultStreamHandler)\n\n// Providing `RequestHandler` from `@tanstack/react-start/server` is required so that the output types don't import it from `@tanstack/start-server-core`\nexport type ServerEntry = { fetch: RequestHandler<Register> }\n\n// Bind the shared request context and fallback error handling to React's Register.\nexport const createServerEntry: (entry: ServerEntry) => ServerEntry =\n  createCoreServerEntry<Register>\n\nexport default createServerEntry({ fetch })\n"],"mappings":";;AAQA,IAAM,QAAQ,mBAAmB,oBAAoB;AAMrD,IAAa,oBACXA;AAEF,IAAA,iBAAe,kBAAkB,EAAE,MAAM,CAAC"}

package/dist/esm/hydration.js

@@ -1,2 +1 @@
-import { condition, idle, interaction, load, media, never, visible } from "@tanstack/react-start-client/hydration";
-export { condition, idle, interaction, load, media, never, visible };
+export { condition, idle, interaction, load, media, never, visible } from "@tanstack/react-start-client/hydration";

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

@@ -1 +1 @@
-{"version":3,"file":"shared.js","names":[],"sources":["../../../src/plugin/shared.ts"],"sourcesContent":["import { fileURLToPath } from 'node:url'\nimport path from 'pathe'\n\nconst currentDir = path.dirname(fileURLToPath(import.meta.url))\nexport const reactStartPluginDir = currentDir\nconst defaultEntryDir = path.resolve(\n  currentDir,\n  '..',\n  '..',\n  'plugin',\n  'default-entry',\n)\n\nexport const reactStartDefaultEntryPaths = {\n  client: path.resolve(defaultEntryDir, 'client.tsx'),\n  server: path.resolve(defaultEntryDir, 'server.ts'),\n  start: path.resolve(defaultEntryDir, 'start.ts'),\n}\n\nexport function resolvePackageEntryPath(packageName: string): string {\n  return fileURLToPath(import.meta.resolve(packageName))\n}\n"],"mappings":";;;AAGA,IAAM,aAAa,KAAK,QAAQ,cAAc,OAAO,KAAK,GAAG,CAAC;AAC9D,IAAa,sBAAsB;AACnC,IAAM,kBAAkB,KAAK,QAC3B,YACA,MACA,MACA,UACA,eACF;AAEA,IAAa,8BAA8B;CACzC,QAAQ,KAAK,QAAQ,iBAAiB,YAAY;CAClD,QAAQ,KAAK,QAAQ,iBAAiB,WAAW;CACjD,OAAO,KAAK,QAAQ,iBAAiB,UAAU;AACjD"}
+{"version":3,"file":"shared.js","names":[],"sources":["../../../src/plugin/shared.ts"],"sourcesContent":["import { fileURLToPath } from 'node:url'\nimport path from 'pathe'\n\nconst currentDir = path.dirname(fileURLToPath(import.meta.url))\nexport const reactStartPluginDir = currentDir\nconst defaultEntryDir = path.resolve(\n  currentDir,\n  '..',\n  '..',\n  'plugin',\n  'default-entry',\n)\n\nexport const reactStartDefaultEntryPaths = {\n  client: path.resolve(defaultEntryDir, 'client.tsx'),\n  server: path.resolve(defaultEntryDir, 'server.ts'),\n  start: path.resolve(defaultEntryDir, 'start.ts'),\n}\n\nexport function resolvePackageEntryPath(packageName: string): string {\n  return fileURLToPath(import.meta.resolve(packageName))\n}\n"],"mappings":";;;AAGA,IAAM,aAAa,KAAK,QAAQ,cAAc,YAAY,GAAG,CAAC;AAC9D,IAAa,sBAAsB;AACnC,IAAM,kBAAkB,KAAK,QAC3B,YACA,MACA,MACA,UACA,eACF;AAEA,IAAa,8BAA8B;CACzC,QAAQ,KAAK,QAAQ,iBAAiB,YAAY;CAClD,QAAQ,KAAK,QAAQ,iBAAiB,WAAW;CACjD,OAAO,KAAK,QAAQ,iBAAiB,UAAU;AACjD"}

package/dist/esm/rsc/serialization/client.js

@@ -1,2 +1 @@
-import { rscSerializationAdapter } from "@tanstack/react-start-rsc/serialization.client";
-export { rscSerializationAdapter };
+export { rscSerializationAdapter } from "@tanstack/react-start-rsc/serialization.client";

package/dist/esm/rsc/serialization/server.js

@@ -1,2 +1 @@
-import { rscSerializationAdapter } from "@tanstack/react-start-rsc/serialization.server";
-export { rscSerializationAdapter };
+export { rscSerializationAdapter } from "@tanstack/react-start-rsc/serialization.server";

package/dist/esm/server-rpc.js

@@ -1,2 +1 @@
-import { createServerRpc } from "@tanstack/start-server-core/createServerRpc";
-export { createServerRpc };
+export { createServerRpc } from "@tanstack/start-server-core/createServerRpc";

package/dist/esm/ssr-rpc.js

@@ -1,2 +1 @@
-import { createSsrRpc } from "@tanstack/start-server-core/createSsrRpc";
-export { createSsrRpc };
+export { createSsrRpc } from "@tanstack/start-server-core/createSsrRpc";

package/dist/esm/useServerFn.js.map

@@ -1 +1 @@
-{"version":3,"file":"useServerFn.js","names":[],"sources":["../../src/useServerFn.ts"],"sourcesContent":["import * as React from 'react'\nimport { isRedirect, useRouter } from '@tanstack/react-router'\n\nexport function useServerFn<T extends (...deps: Array<any>) => Promise<any>>(\n  serverFn: T,\n): (...args: Parameters<T>) => ReturnType<T> {\n  const router = useRouter()\n\n  return React.useCallback(\n    async (...args: Array<any>) => {\n      try {\n        const res = await serverFn(...args)\n\n        if (isRedirect(res)) {\n          throw res\n        }\n\n        return res\n      } catch (err) {\n        if (isRedirect(err)) {\n          err.options._fromLocation = router.stores.location.get()\n          return router.navigate(router.resolveRedirect(err).options)\n        }\n\n        throw err\n      }\n    },\n    [router, serverFn],\n  ) as any\n}\n"],"mappings":";;;AAGA,SAAgB,YACd,UAC2C;CAC3C,MAAM,SAAS,UAAU;CAEzB,OAAO,MAAM,YACX,OAAO,GAAG,SAAqB;EAC7B,IAAI;GACF,MAAM,MAAM,MAAM,SAAS,GAAG,IAAI;GAElC,IAAI,WAAW,GAAG,GAChB,MAAM;GAGR,OAAO;EACT,SAAS,KAAK;GACZ,IAAI,WAAW,GAAG,GAAG;IACnB,IAAI,QAAQ,gBAAgB,OAAO,OAAO,SAAS,IAAI;IACvD,OAAO,OAAO,SAAS,OAAO,gBAAgB,GAAG,EAAE,OAAO;GAC5D;GAEA,MAAM;EACR;CACF,GACA,CAAC,QAAQ,QAAQ,CACnB;AACF"}
+{"version":3,"file":"useServerFn.js","names":[],"sources":["../../src/useServerFn.ts"],"sourcesContent":["import * as React from 'react'\nimport { isRedirect, useRouter } from '@tanstack/react-router'\n\nexport function useServerFn<T extends (...deps: Array<any>) => Promise<any>>(\n  serverFn: T,\n): (...args: Parameters<T>) => ReturnType<T> {\n  const router = useRouter()\n\n  return React.useCallback(\n    async (...args: Array<any>) => {\n      try {\n        const res = await serverFn(...args)\n\n        if (isRedirect(res)) {\n          throw res\n        }\n\n        return res\n      } catch (err) {\n        if (isRedirect(err)) {\n          err.options._fromLocation = router.stores.location.get()\n          return router.navigate(router.resolveRedirect(err).options)\n        }\n\n        throw err\n      }\n    },\n    [router, serverFn],\n  ) as any\n}\n"],"mappings":";;;AAGA,SAAgB,YACd,UAC2C;CAC3C,MAAM,SAAS,UAAU;CAEzB,OAAO,MAAM,YACX,OAAO,GAAG,SAAqB;EAC7B,IAAI;GACF,MAAM,MAAM,MAAM,SAAS,GAAG,IAAI;GAElC,IAAI,WAAW,GAAG,GAChB,MAAM;GAGR,OAAO;EACT,SAAS,KAAK;GACZ,IAAI,WAAW,GAAG,GAAG;IACnB,IAAI,QAAQ,gBAAgB,OAAO,OAAO,SAAS,IAAI;IACvD,OAAO,OAAO,SAAS,OAAO,gBAAgB,GAAG,CAAC,CAAC,OAAO;GAC5D;GAEA,MAAM;EACR;CACF,GACA,CAAC,QAAQ,QAAQ,CACnB;AACF"}

package/dist/plugin/default-entry/server.ts

@@ -1,6 +1,7 @@
 import {
   createStartHandler,
   defaultStreamHandler,
+  createServerEntry as createCoreServerEntry,
 } from '@tanstack/react-start/server'
 import type { Register } from '@tanstack/react-router'
 import type { RequestHandler } from '@tanstack/react-start/server'
@@ -10,12 +11,8 @@ const fetch = createStartHandler(defaultStreamHandler)
 // Providing `RequestHandler` from `@tanstack/react-start/server` is required so that the output types don't import it from `@tanstack/start-server-core`
 export type ServerEntry = { fetch: RequestHandler<Register> }
 
-export function createServerEntry(entry: ServerEntry): ServerEntry {
-  return {
-    async fetch(...args) {
-      return await entry.fetch(...args)
-    },
-  }
-}
+// Bind the shared request context and fallback error handling to React's Register.
+export const createServerEntry: (entry: ServerEntry) => ServerEntry =
+  createCoreServerEntry<Register>
 
 export default createServerEntry({ fetch })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/react-start",
-  "version": "1.168.60",
+  "version": "1.169.0",
   "description": "Modern and scalable routing for React applications",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -155,20 +155,20 @@
   },
   "dependencies": {
     "pathe": "^2.0.3",
-    "@tanstack/react-router": "1.170.41",
-    "@tanstack/react-start-client": "1.168.39",
-    "@tanstack/react-start-rsc": "0.1.59",
-    "@tanstack/react-start-server": "1.167.46",
+    "@tanstack/react-router": "1.170.43",
+    "@tanstack/react-start-client": "1.168.41",
+    "@tanstack/react-start-rsc": "0.1.61",
+    "@tanstack/react-start-server": "1.167.48",
     "@tanstack/router-utils": "1.162.3",
-    "@tanstack/start-client-core": "1.170.34",
-    "@tanstack/start-plugin-core": "1.171.49",
-    "@tanstack/start-server-core": "1.169.39"
+    "@tanstack/start-client-core": "1.170.36",
+    "@tanstack/start-plugin-core": "1.171.51",
+    "@tanstack/start-server-core": "1.169.41"
   },
   "peerDependencies": {
     "@rsbuild/core": "^2.0.0",
     "react": ">=18.0.0 || >=19.0.0",
     "react-dom": ">=18.0.0 || >=19.0.0",
-    "vite": ">=7.0.0"
+    "vite": ">=8.0.0"
   },
   "peerDependenciesMeta": {
     "@rsbuild/core": {

package/skills/react-start/server-components/SKILL.md

@@ -74,10 +74,10 @@ Treat TanStack Start RSCs as fetchable React Flight payloads, not as a framework
 
 - Simple server fragment in a route loader -> `renderServerComponent`
 - Interactive slot inside server markup -> `createCompositeComponent`
-- Route component needs browser APIs but loader can still prefetch on the server -> `ssr: 'data-only'`
+- Route component needs browser APIs but loader can still query on the server -> `ssr: 'data-only'`
 - Loader itself needs browser APIs -> `ssr: false`
 - Route cache key must include search params -> `loaderDeps`
-- Query-managed RSC -> `useSuspenseQuery` + SSR `ensureQueryData`
+- Query-managed RSC -> `useSuspenseQuery` + SSR `query` with `staleTime: 'static'`
 - Multiple independent RSCs -> separate server functions + `Promise.all`
 - Multiple RSCs sharing data or invalidating together -> one server function returning many renderables or sources
 - Need isolated widget failures or staggered reveal -> return promises from the loader and resolve with `use()` inside Suspense

package/skills/react-start/server-components/docs/caching-refresh-ssr.md

@@ -73,10 +73,13 @@ const postQueryOptions = (postId: string) => ({
 })
 ```
 
-For SSR reuse, prefetch in the route loader:
+For SSR reuse, run a static query in the route loader so cached data is reused without a stale refetch:
 
 ```tsx
-await context.queryClient.ensureQueryData(postQueryOptions(params.postId))
+await context.queryClient.query({
+  ...postQueryOptions(params.postId),
+  staleTime: 'static',
+})
 ```
 
 Then read it with `useSuspenseQuery` in the component.

package/skills/react-start/server-components/examples/03-query-owned-rsc.tsx

@@ -1,5 +1,5 @@
 // Query-owned RSC pattern.
-// Assumes your router context provides a queryClient for SSR prefetch.
+// Assumes your router context provides a queryClient for SSR queries.
 
 import type { ReactNode } from 'react'
 import { createFileRoute } from '@tanstack/react-router'
@@ -68,7 +68,10 @@ const postQueryOptions = (postId: string) => ({
 
 export const Route = createFileRoute('/posts/$postId')({
   loader: async ({ context, params }) => {
-    await context.queryClient.ensureQueryData(postQueryOptions(params.postId))
+    await context.queryClient.query({
+      ...postQueryOptions(params.postId),
+      staleTime: 'static',
+    })
   },
   component: PostPage,
 })

package/src/default-entry/server.ts

@@ -1,6 +1,7 @@
 import {
   createStartHandler,
   defaultStreamHandler,
+  createServerEntry as createCoreServerEntry,
 } from '@tanstack/react-start/server'
 import type { Register } from '@tanstack/react-router'
 import type { RequestHandler } from '@tanstack/react-start/server'
@@ -10,12 +11,8 @@ const fetch = createStartHandler(defaultStreamHandler)
 // Providing `RequestHandler` from `@tanstack/react-start/server` is required so that the output types don't import it from `@tanstack/start-server-core`
 export type ServerEntry = { fetch: RequestHandler<Register> }
 
-export function createServerEntry(entry: ServerEntry): ServerEntry {
-  return {
-    async fetch(...args) {
-      return await entry.fetch(...args)
-    },
-  }
-}
+// Bind the shared request context and fallback error handling to React's Register.
+export const createServerEntry: (entry: ServerEntry) => ServerEntry =
+  createCoreServerEntry<Register>
 
 export default createServerEntry({ fetch })