feat(server): extend .actionable error handling for tanstack router compatibility

apps/content/docs/server-action.md

@@ -35,6 +35,10 @@ export const ping = os
 We recommend using [Runtime Context](/docs/context#execution-context) instead of [Initial Context](/docs/context#initial-context) when working with Server Actions.
 :::
 
+:::warning
+Special errors such as `redirect`, `notFound`, and similar are **only supported in [Next.js](https://nextjs.org/) and [TanStack Start](https://tanstack.com/start/latest)** at the moment.
+:::
+
 ## Client Side
 
 On the client, import and call your procedure as follows:

packages/server/package.json

@@ -136,6 +136,7 @@
     "cookie": "^1.0.2"
   },
   "devDependencies": {
+    "@tanstack/router-core": "^1.132.19",
     "@types/ws": "^8.18.1",
     "crossws": "^0.4.1",
     "next": "^15.5.4",

packages/server/src/procedure-action.test.ts

@@ -1,5 +1,6 @@
 import { ORPCError } from '@orpc/client'
-import { forbidden, notFound, redirect, unauthorized } from 'next/navigation'
+import * as tanstackRouter from '@tanstack/router-core'
+import * as next from 'next/navigation'
 import { createActionableClient } from './procedure-action'
 
 describe('createActionableClient', () => {
@@ -37,17 +38,27 @@ describe('createActionableClient', () => {
   })
 
   it.each([
-    [() => redirect('/foo')],
-    [() => forbidden()],
-    [() => unauthorized()],
-    [() => notFound()],
-  ])('should rethrow next.js error', async (error) => {
+    [() => next.redirect('/foo')],
+    [() => next.forbidden()],
+    [() => next.unauthorized()],
+    [() => next.notFound()],
+    [() => tanstackRouter.redirect({ to: '.login' })],
+    [() => tanstackRouter.notFound()],
+  ])('should rethrow next.js or tanstack router error', async (createError) => {
     (process as any).env.__NEXT_EXPERIMENTAL_AUTH_INTERRUPTS = true
 
+    let error
+
     client.mockImplementationOnce(() => {
-      error()
+      try {
+        throw createError()
+      }
+      catch (e) {
+        error = e
+        throw e
+      }
     })
 
-    await expect(action('input')).rejects.toThrowError()
+    await expect(action('input')).rejects.toBe(error)
   })
 })

packages/server/src/procedure-action.ts

@@ -2,6 +2,7 @@ import type { Client, ORPCError, ORPCErrorJSON } from '@orpc/client'
 import type { AnySchema, ErrorFromErrorMap, ErrorMap, InferSchemaInput, InferSchemaOutput } from '@orpc/contract'
 import type { ThrowableError } from '@orpc/shared'
 import { toORPCError } from '@orpc/client'
+import { isObject } from '@orpc/shared'
 
 export type ActionableError<T> = T extends ORPCError<infer U, infer V> ? ORPCErrorJSON<U, V> & { defined: true } : ORPCErrorJSON<string, unknown> & { defined: false }
 
@@ -35,6 +36,7 @@ export function createActionableClient<TInput, TOutput, TError>(
       return [null, await client(input)]
     }
     catch (error) {
+      // special next.js errors
       if (
         error instanceof Error
         && 'digest' in error
@@ -44,6 +46,14 @@ export function createActionableClient<TInput, TOutput, TError>(
         throw error
       }
 
+      // special tanstack router errors
+      if (
+        (error instanceof Response && 'options' in error && isObject(error.options))
+        || (isObject(error) && error.isNotFound === true)
+      ) {
+        throw error
+      }
+
       return [toORPCError(error).toJSON(), undefined]
     }
   }