Mismatched documentation on server routes in Tanstack Start?

[robinaugh]

The documentation at https://tanstack.com/start/latest/docs/framework/react/guide/server-routes describes how to define server routes using createFileRoute with a server property containing HTTP method handlers (GET, POST, etc.):

import { createFileRoute } from '@tanstack/react-router'

export const Route = createFileRoute('/hello')({
  server: {
    handlers: {
      GET: async ({ request }) => {
        return new Response('Hello, World!')
      },
    },
  },
})

However, this feature appears to not be supported in the @tanstack/react-router package implementation.

The FileBaseRouteOptions type (which createFileRoute accepts) does not include a server property. The type definition in @tanstack/router-core/dist/esm/route.d.ts shows:

export interface FilebaseRouteOptionsInterface<...> {
    validateSearch?: ...
    shouldReload?: ...
    context?: ...
    ssr?: ...
    beforeLoad?: ...
    loaderDeps?: ...
    remountDeps?: ...
    loader?: ...
    // No 'server' property
}

I also don't see any reference to a server property on the web documentation at https://tanstack.com/router/latest/docs/framework/react/api/router/createFileRouteFunction#createfileroute-returns.

Am I just setting something up incorrectly? We're using the following tanstack packages:

"@tanstack/react-router": "^1.135.0",
"@tanstack/react-router-devtools": "^1.134.13",
"@tanstack/react-start": "^1.135.0",
"@tanstack/react-table": "^8.21.3",
"@tanstack/router-plugin": "^1.134.13",
"@tanstack/router-vite-plugin": "^1.134.13",
"@tanstack/start": "^1.120.20",

Thanks in advance!

[schiller-manuel]

its a feature that start adds. it is not implemented in router

[robinaugh]

Thanks @schiller-manuel - what's the best place to dig in deeper on start's implementation for further debugging of this type issue? https://www.npmjs.com/package/@tanstack/start links back to this repo. 🙃

[schiller-manuel]

which type issue? the impl is here https://github.com/TanStack/router/blob/main/packages/start-client-core/src/serverRoute.ts