@tanstack/react-start 1.168.59 → 1.168.61

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/react-start",
-  "version": "1.168.59",
+  "version": "1.168.61",
   "description": "Modern and scalable routing for React applications",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -155,14 +155,14 @@
   },
   "dependencies": {
     "pathe": "^2.0.3",
-    "@tanstack/react-router": "1.170.40",
-    "@tanstack/react-start-client": "1.168.38",
-    "@tanstack/react-start-rsc": "0.1.58",
-    "@tanstack/react-start-server": "1.167.45",
+    "@tanstack/react-router": "1.170.42",
+    "@tanstack/react-start-client": "1.168.40",
+    "@tanstack/react-start-server": "1.167.47",
     "@tanstack/router-utils": "1.162.3",
-    "@tanstack/start-client-core": "1.170.33",
-    "@tanstack/start-plugin-core": "1.171.48",
-    "@tanstack/start-server-core": "1.169.38"
+    "@tanstack/start-client-core": "1.170.35",
+    "@tanstack/start-server-core": "1.169.40",
+    "@tanstack/start-plugin-core": "1.171.50",
+    "@tanstack/react-start-rsc": "0.1.60"
   },
   "peerDependencies": {
     "@rsbuild/core": "^2.0.0",

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,
 })