@tanstack/start-client-core 1.170.11 → 1.170.13

package/skills/start-core/server-functions/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: start-core/server-functions
 description: >-
-  createServerFn (GET/POST), inputValidator (Zod or function),
+  createServerFn (GET/POST), validator (Zod or function),
   useServerFn hook, server context utilities (getRequest,
   getRequestHeader, setResponseHeader, setResponseStatus), error
   handling (throw errors, redirect, notFound), streaming, FormData
@@ -75,7 +75,7 @@ Use the `useServerFn` hook to call server functions from event handlers:
 import { useServerFn } from '@tanstack/react-start'
 
 const deletePost = createServerFn({ method: 'POST' })
-  .inputValidator((data: { id: string }) => data)
+  .validator((data: { id: string }) => data)
   .handler(async ({ data }) => {
     await db.delete('posts').where({ id: data.id })
     return { success: true }
@@ -98,7 +98,7 @@ function DeleteButton({ postId }: { postId: string }) {
 
 ```tsx
 const greetUser = createServerFn({ method: 'GET' })
-  .inputValidator((data: { name: string }) => data)
+  .validator((data: { name: string }) => data)
   .handler(async ({ data }) => {
     return `Hello, ${data.name}!`
   })
@@ -112,7 +112,7 @@ await greetUser({ data: { name: 'John' } })
 import { z } from 'zod'
 
 const createUser = createServerFn({ method: 'POST' })
-  .inputValidator(
+  .validator(
     z.object({
       name: z.string().min(1),
       age: z.number().min(0),
@@ -127,7 +127,7 @@ const createUser = createServerFn({ method: 'POST' })
 
 ```tsx
 const submitForm = createServerFn({ method: 'POST' })
-  .inputValidator((data) => {
+  .validator((data) => {
     if (!(data instanceof FormData)) {
       throw new Error('Expected FormData')
     }
@@ -177,7 +177,7 @@ const requireAuth = createServerFn().handler(async () => {
 import { notFound } from '@tanstack/react-router'
 
 const getPost = createServerFn()
-  .inputValidator((data: { id: string }) => data)
+  .validator((data: { id: string }) => data)
   .handler(async ({ data }) => {
     const post = await db.findPost(data.id)
     if (!post) {
@@ -258,7 +258,7 @@ import { createServerFn } from '@tanstack/react-start'
 import { findUserById } from './users.server'
 
 export const getUser = createServerFn({ method: 'GET' })
-  .inputValidator((data: { id: string }) => data)
+  .validator((data: { id: string }) => data)
   .handler(async ({ data }) => {
     return findUserById(data.id)
   })

package/src/client-rpc/frame-decoder.ts

@@ -201,6 +201,25 @@ export function createFrameDecoder(
     function extractFlattened(count: number): Uint8Array {
       if (count === 0) return EMPTY_BUFFER
 
+      // Fast path: the requested bytes are fully contained in the first buffered
+      // chunk (the common case — most frames arrive within a single network
+      // read). Return a subarray view instead of allocating a new buffer and
+      // copying `count` bytes. The view shares the chunk's backing ArrayBuffer,
+      // which is safe because buffered chunks are never mutated in place after
+      // being read from the network.
+      const first = bufferList[0]
+      if (first && first.length >= count) {
+        const result = first.subarray(0, count)
+        if (first.length === count) {
+          bufferList.shift()
+        } else {
+          bufferList[0] = first.subarray(count)
+        }
+        totalLength -= count
+        return result
+      }
+
+      // Slow path: the requested bytes span multiple chunks — flatten by copying.
       const result = new Uint8Array(count)
       let offset = 0
       let remaining = count

package/src/createMiddleware.ts

@@ -36,6 +36,16 @@ export const createMiddleware: CreateMiddlewareFn<{}> = (options, __opts) => {
     type: 'request',
     ...(__opts || options),
   }
+  const setValidator = (validator: any) => {
+    return createMiddleware(
+      {},
+      Object.assign(resolvedOptions, {
+        validator,
+        // TODO remove upon stable
+        inputValidator: validator,
+      }),
+    )
+  }
 
   return {
     options: resolvedOptions,
@@ -45,12 +55,9 @@ export const createMiddleware: CreateMiddlewareFn<{}> = (options, __opts) => {
         Object.assign(resolvedOptions, { middleware }),
       )
     },
-    inputValidator: (inputValidator: any) => {
-      return createMiddleware(
-        {},
-        Object.assign(resolvedOptions, { inputValidator }),
-      )
-    },
+    validator: setValidator,
+    // TODO remove upon stable
+    inputValidator: setValidator,
     client: (client: any) => {
       return createMiddleware({}, Object.assign(resolvedOptions, { client }))
     },
@@ -170,6 +177,9 @@ export interface FunctionMiddlewareTypes<
     TMiddlewares,
     TClientSendContext
   >
+  validator: TInputValidator
+  // TODO remove upon stable
+  /** @deprecated Use `validator` instead. */
   inputValidator: TInputValidator
 }
 
@@ -379,6 +389,9 @@ export interface FunctionMiddlewareOptions<
   in out TClientContext,
 > {
   middleware?: TMiddlewares
+  validator?: ConstrainValidator<TRegister, 'GET', TInputValidator>
+  // TODO remove upon stable
+  /** @deprecated Use `validator` instead. */
   inputValidator?: ConstrainValidator<TRegister, 'GET', TInputValidator>
   client?: FunctionMiddlewareClientFn<
     TRegister,
@@ -668,8 +681,13 @@ export interface FunctionMiddlewareAfterClient<
     > {}
 
 export interface FunctionMiddlewareValidator<TRegister, TMiddlewares> {
+  validator: <TNewValidator>(
+    validator: ConstrainValidator<TRegister, 'GET', TNewValidator>,
+  ) => FunctionMiddlewareAfterValidator<TRegister, TMiddlewares, TNewValidator>
+  // TODO remove upon stable
+  /** @deprecated Use `validator` instead. */
   inputValidator: <TNewValidator>(
-    inputValidator: ConstrainValidator<TRegister, 'GET', TNewValidator>,
+    validator: ConstrainValidator<TRegister, 'GET', TNewValidator>,
   ) => FunctionMiddlewareAfterValidator<TRegister, TMiddlewares, TNewValidator>
 }
 

package/src/createServerFn.ts

@@ -85,6 +85,16 @@ export const createServerFn: CreateServerFn<Register> = (options, __opts) => {
     resolvedOptions.method = 'GET' as Method
   }
 
+  const setValidator = (validator: any) => {
+    // TODO remove upon stable
+    const newOptions = {
+      ...resolvedOptions,
+      validator,
+      inputValidator: validator,
+    }
+    return createServerFn(undefined, newOptions) as any
+  }
+
   const res: ServerFnBuilder<Register, Method, ServerFnStrict> = {
     options: resolvedOptions,
     middleware: (middleware) => {
@@ -110,10 +120,9 @@ export const createServerFn: CreateServerFn<Register> = (options, __opts) => {
       res[TSS_SERVER_FUNCTION_FACTORY] = true
       return res
     },
-    inputValidator: (inputValidator) => {
-      const newOptions = { ...resolvedOptions, inputValidator }
-      return createServerFn(undefined, newOptions) as any
-    },
+    validator: setValidator,
+    // TODO remove upon stable
+    inputValidator: setValidator,
     handler: (...args) => {
       // This function signature changes due to AST transformations
       // in the babel plugin. We need to cast it to the correct
@@ -249,16 +258,19 @@ export async function executeMiddleware(
 
     // Execute the middleware
     try {
-      if (
-        'inputValidator' in nextMiddleware.options &&
-        nextMiddleware.options.inputValidator &&
-        env === 'server'
-      ) {
+      let validator =
+        'validator' in nextMiddleware.options
+          ? nextMiddleware.options.validator
+          : undefined
+
+      // TODO remove upon stable
+      if (!validator && 'inputValidator' in nextMiddleware.options) {
+        validator = nextMiddleware.options.inputValidator
+      }
+
+      if (validator && env === 'server') {
         // Execute the middleware's input function
-        ctx.data = await execValidator(
-          nextMiddleware.options.inputValidator,
-          ctx.data,
-        )
+        ctx.data = await execValidator(validator as AnyValidator, ctx.data)
       }
 
       let middlewareFn: MiddlewareFn | undefined = undefined
@@ -494,6 +506,9 @@ export type ServerFnBaseOptions<
     TMiddlewares,
     ReadonlyArray<AnyFunctionMiddleware | AnyRequestMiddleware>
   >
+  validator?: ConstrainValidator<TRegister, TMethod, TInputValidator, TStrict>
+  // TODO remove upon stable
+  /** @deprecated Use `validator` instead. */
   inputValidator?: ConstrainValidator<
     TRegister,
     TMethod,
@@ -637,12 +652,7 @@ export type ValidatorFn<
   TMiddlewares,
   TStrict extends ServerFnStrict,
 > = <TInputValidator>(
-  inputValidator: ConstrainValidator<
-    TRegister,
-    TMethod,
-    TInputValidator,
-    TStrict
-  >,
+  validator: ConstrainValidator<TRegister, TMethod, TInputValidator, TStrict>,
 ) => ServerFnAfterValidator<
   TRegister,
   TMethod,
@@ -657,6 +667,9 @@ export interface ServerFnValidator<
   TMiddlewares,
   TStrict extends ServerFnStrict,
 > {
+  validator: ValidatorFn<TRegister, TMethod, TMiddlewares, TStrict>
+  // TODO remove upon stable
+  /** @deprecated Use `validator` instead. */
   inputValidator: ValidatorFn<TRegister, TMethod, TMiddlewares, TStrict>
 }
 
@@ -808,6 +821,9 @@ export interface ServerFnTypes<
   method: TMethod
   strict: TStrict
   middlewares: TMiddlewares
+  validator: TInputValidator
+  // TODO remove upon stable
+  /** @deprecated Use `validator` instead. */
   inputValidator: TInputValidator
   response: TResponse
   allServerContext: AssignAllServerFnContext<TRegister, TMiddlewares>
@@ -901,10 +917,14 @@ export async function execValidator(
 function serverFnBaseToMiddleware(
   options: ServerFnBaseOptions<any, any, any, any, any>,
 ): AnyFunctionMiddleware {
+  // TODO remove upon stable
+  const validator = options.validator ?? options.inputValidator
+
   return {
     '~types': undefined!,
     options: {
-      inputValidator: options.inputValidator,
+      // TODO remove upon stable
+      inputValidator: validator,
       client: async ({ next, sendContext, fetch, ...ctx }) => {
         const payload = {
           ...ctx,

package/src/tests/createServerFn.test-d.ts

@@ -20,6 +20,8 @@ import type {
 test('createServerFn without middleware', () => {
   expectTypeOf(createServerFn()).toHaveProperty('handler')
   expectTypeOf(createServerFn()).toHaveProperty('middleware')
+  expectTypeOf(createServerFn()).toHaveProperty('validator')
+  // TODO remove upon stable
   expectTypeOf(createServerFn()).toHaveProperty('inputValidator')
 
   createServerFn({ method: 'GET' }).handler((options) => {
@@ -35,13 +37,13 @@ test('createServerFn without middleware', () => {
 test('createServerFn with validator function', () => {
   const fnAfterValidator = createServerFn({
     method: 'GET',
-  }).inputValidator((input: { input: string }) => ({
+  }).validator((input: { input: string }) => ({
     a: input.input,
   }))
 
   expectTypeOf(fnAfterValidator).toHaveProperty('handler')
   expectTypeOf(fnAfterValidator).toHaveProperty('middleware')
-  expectTypeOf(fnAfterValidator).not.toHaveProperty('inputValidator')
+  expectTypeOf(fnAfterValidator).not.toHaveProperty('validator')
 
   const fn = fnAfterValidator.handler((options) => {
     expectTypeOf(options).toEqualTypeOf<{
@@ -67,11 +69,11 @@ test('createServerFn with validator function', () => {
 test('createServerFn with async validator function', () => {
   const fnAfterValidator = createServerFn({
     method: 'GET',
-  }).inputValidator((input: string) => Promise.resolve(input))
+  }).validator((input: string) => Promise.resolve(input))
 
   expectTypeOf(fnAfterValidator).toHaveProperty('handler')
   expectTypeOf(fnAfterValidator).toHaveProperty('middleware')
-  expectTypeOf(fnAfterValidator).not.toHaveProperty('inputValidator')
+  expectTypeOf(fnAfterValidator).not.toHaveProperty('validator')
 
   const fn = fnAfterValidator.handler((options) => {
     expectTypeOf(options).toEqualTypeOf<{
@@ -95,13 +97,13 @@ test('createServerFn with async validator function', () => {
 test('createServerFn with validator with parse method', () => {
   const fnAfterValidator = createServerFn({
     method: 'GET',
-  }).inputValidator({
+  }).validator({
     parse: (input: string) => input,
   })
 
   expectTypeOf(fnAfterValidator).toHaveProperty('handler')
   expectTypeOf(fnAfterValidator).toHaveProperty('middleware')
-  expectTypeOf(fnAfterValidator).not.toHaveProperty('inputValidator')
+  expectTypeOf(fnAfterValidator).not.toHaveProperty('validator')
 
   const fn = fnAfterValidator.handler((options) => {
     expectTypeOf(options).toEqualTypeOf<{
@@ -125,13 +127,13 @@ test('createServerFn with validator with parse method', () => {
 test('createServerFn with async validator with parse method', () => {
   const fnAfterValidator = createServerFn({
     method: 'GET',
-  }).inputValidator({
+  }).validator({
     parse: (input: string) => Promise.resolve(input),
   })
 
   expectTypeOf(fnAfterValidator).toHaveProperty('handler')
   expectTypeOf(fnAfterValidator).toHaveProperty('middleware')
-  expectTypeOf(fnAfterValidator).not.toHaveProperty('inputValidator')
+  expectTypeOf(fnAfterValidator).not.toHaveProperty('validator')
 
   const fn = fnAfterValidator.handler((options) => {
     expectTypeOf(options).toEqualTypeOf<{
@@ -174,11 +176,11 @@ test('createServerFn with standard validator', () => {
 
   const fnAfterValidator = createServerFn({
     method: 'GET',
-  }).inputValidator(validator)
+  }).validator(validator)
 
   expectTypeOf(fnAfterValidator).toHaveProperty('handler')
   expectTypeOf(fnAfterValidator).toHaveProperty('middleware')
-  expectTypeOf(fnAfterValidator).not.toHaveProperty('inputValidator')
+  expectTypeOf(fnAfterValidator).not.toHaveProperty('validator')
 
   const fn = fnAfterValidator.handler((options) => {
     expectTypeOf(options).toEqualTypeOf<{
@@ -222,11 +224,11 @@ test('createServerFn with async standard validator', () => {
 
   const fnAfterValidator = createServerFn({
     method: 'GET',
-  }).inputValidator(validator)
+  }).validator(validator)
 
   expectTypeOf(fnAfterValidator).toHaveProperty('handler')
   expectTypeOf(fnAfterValidator).toHaveProperty('middleware')
-  expectTypeOf(fnAfterValidator).not.toHaveProperty('inputValidator')
+  expectTypeOf(fnAfterValidator).not.toHaveProperty('validator')
 
   const fn = fnAfterValidator.handler((options) => {
     expectTypeOf(options).toEqualTypeOf<{
@@ -285,7 +287,7 @@ test('createServerFn with middleware and context', () => {
   ])
 
   expectTypeOf(fnWithMiddleware).toHaveProperty('handler')
-  expectTypeOf(fnWithMiddleware).toHaveProperty('inputValidator')
+  expectTypeOf(fnWithMiddleware).toHaveProperty('validator')
 
   fnWithMiddleware.handler((options) => {
     expectTypeOf(options).toEqualTypeOf<{
@@ -303,14 +305,14 @@ test('createServerFn with middleware and context', () => {
 })
 
 describe('createServerFn with middleware and validator', () => {
-  const middleware1 = createMiddleware({ type: 'function' }).inputValidator(
+  const middleware1 = createMiddleware({ type: 'function' }).validator(
     (input: { readonly inputA: 'inputA' }) =>
       ({
         outputA: 'outputA',
       }) as const,
   )
 
-  const middleware2 = createMiddleware({ type: 'function' }).inputValidator(
+  const middleware2 = createMiddleware({ type: 'function' }).validator(
     (input: { readonly inputB: 'inputB' }) =>
       ({
         outputB: 'outputB',
@@ -325,7 +327,7 @@ describe('createServerFn with middleware and validator', () => {
   test(`response`, () => {
     const fn = createServerFn({ method: 'GET' })
       .middleware([middleware3])
-      .inputValidator(
+      .validator(
         (input: { readonly inputC: 'inputC' }) =>
           ({
             outputC: 'outputC',
@@ -368,7 +370,7 @@ describe('createServerFn with middleware and validator', () => {
 
 test('createServerFn overrides properties', () => {
   const middleware1 = createMiddleware({ type: 'function' })
-    .inputValidator(
+    .validator(
       () =>
         ({
           input: 'a' as 'a' | 'b' | 'c',
@@ -393,7 +395,7 @@ test('createServerFn overrides properties', () => {
 
   const middleware2 = createMiddleware({ type: 'function' })
     .middleware([middleware1])
-    .inputValidator(
+    .validator(
       () =>
         ({
           input: 'b' as 'b' | 'c',
@@ -416,7 +418,7 @@ test('createServerFn overrides properties', () => {
 
   createServerFn()
     .middleware([middleware2])
-    .inputValidator(
+    .validator(
       () =>
         ({
           input: 'c',
@@ -432,7 +434,7 @@ test('createServerFn overrides properties', () => {
 
 test('createServerFn where validator is a primitive', () => {
   createServerFn({ method: 'GET' })
-    .inputValidator(() => 'c' as const)
+    .validator(() => 'c' as const)
     .handler((options) => {
       expectTypeOf(options).toEqualTypeOf<{
         context: undefined
@@ -445,7 +447,7 @@ test('createServerFn where validator is a primitive', () => {
 
 test('createServerFn where validator is optional if object is optional', () => {
   const fn = createServerFn({ method: 'GET' })
-    .inputValidator((input: 'c' | undefined) => input)
+    .validator((input: 'c' | undefined) => input)
     .handler((options) => {
       expectTypeOf(options).toEqualTypeOf<{
         context: undefined
@@ -520,7 +522,7 @@ test('createServerFn cannot return function', () => {
 
 test('createServerFn strict false can validate and return function', () => {
   const fn = createServerFn({ method: 'GET', strict: false })
-    .inputValidator((input: { func: () => 'input' }) => ({
+    .validator((input: { func: () => 'input' }) => ({
       output: input.func(),
     }))
     .handler(({ data }) => {
@@ -551,7 +553,7 @@ test('createServerFn strict false factory preserves strictness', () => {
   })
 
   const myServerFn = createServerFnWithoutSerializationCheck()
-    .inputValidator((input: { func: () => 'input' }) => ({
+    .validator((input: { func: () => 'input' }) => ({
       output: input.func(),
     }))
     .handler(({ data }) => {
@@ -578,7 +580,7 @@ test('createServerFn strict false factory preserves strictness', () => {
 
 test('createServerFn strict input false can validate function', () => {
   const fn = createServerFn({ strict: { input: false } })
-    .inputValidator((input: { func: () => 'input' }) => ({
+    .validator((input: { func: () => 'input' }) => ({
       output: input.func(),
     }))
     .handler(({ data }) => {
@@ -644,7 +646,7 @@ test('ServerFnReturnType skips serialization when strict output is false', () =>
 })
 
 test('createServerFn cannot validate function', () => {
-  const validator = createServerFn().inputValidator<
+  const validator = createServerFn().validator<
     (input: { func: () => 'string' }) => { output: 'string' }
   >
 
@@ -665,7 +667,7 @@ test('createServerFn strict output false still checks input', () => {
   const validator = createServerFn({
     method: 'GET',
     strict: { output: false },
-  }).inputValidator<(input: { func: () => 'string' }) => { output: 'string' }>
+  }).validator<(input: { func: () => 'string' }) => { output: 'string' }>
 
   expectTypeOf(validator)
     .parameter(0)
@@ -681,7 +683,7 @@ test('createServerFn strict output false still checks input', () => {
 })
 
 test('createServerFn can validate Date', () => {
-  const validator = createServerFn().inputValidator<
+  const validator = createServerFn().validator<
     (input: Date) => { output: 'string' }
   >
 
@@ -693,7 +695,7 @@ test('createServerFn can validate Date', () => {
 })
 
 test('createServerFn can validate FormData', () => {
-  const validator = createServerFn({ method: 'POST' }).inputValidator<
+  const validator = createServerFn({ method: 'POST' }).validator<
     (input: FormData) => { output: 'string' }
   >
 
@@ -701,7 +703,7 @@ test('createServerFn can validate FormData', () => {
 })
 
 test('createServerFn cannot validate FormData for GET', () => {
-  const validator = createServerFn({ method: 'GET' }).inputValidator<
+  const validator = createServerFn({ method: 'GET' }).validator<
     (input: FormData) => { output: 'string' }
   >
 
@@ -740,7 +742,7 @@ test('ServerFnReturnType distributes Response union', () => {
 
 test('createServerFn can be used as a mutation function', () => {
   const serverFn = createServerFn()
-    .inputValidator((data: number) => data)
+    .validator((data: number) => data)
     .handler(() => 'foo')
 
   type MutationFunction<TData = unknown, TVariables = unknown> = (
@@ -757,7 +759,7 @@ test('createServerFn can be used as a mutation function', () => {
 
 test('createServerFn validator infers unknown for default input type', () => {
   const fn = createServerFn()
-    .inputValidator((input) => {
+    .validator((input) => {
       expectTypeOf(input).toEqualTypeOf<unknown>()
 
       if (typeof input === 'number') return 'success' as const
@@ -807,7 +809,7 @@ test('incrementally building createServerFn with multiple middleware calls', ()
   ])
 
   expectTypeOf(builderWithMw1).toHaveProperty('handler')
-  expectTypeOf(builderWithMw1).toHaveProperty('inputValidator')
+  expectTypeOf(builderWithMw1).toHaveProperty('validator')
   expectTypeOf(builderWithMw1).toHaveProperty('middleware')
 
   builderWithMw1.handler((options) => {
@@ -827,7 +829,7 @@ test('incrementally building createServerFn with multiple middleware calls', ()
   ])
 
   expectTypeOf(builderWithMw2).toHaveProperty('handler')
-  expectTypeOf(builderWithMw2).toHaveProperty('inputValidator')
+  expectTypeOf(builderWithMw2).toHaveProperty('validator')
   expectTypeOf(builderWithMw2).toHaveProperty('middleware')
 
   builderWithMw2.handler((options) => {
@@ -848,7 +850,7 @@ test('incrementally building createServerFn with multiple middleware calls', ()
   ])
 
   expectTypeOf(builderWithMw3).toHaveProperty('handler')
-  expectTypeOf(builderWithMw3).toHaveProperty('inputValidator')
+  expectTypeOf(builderWithMw3).toHaveProperty('validator')
   expectTypeOf(builderWithMw3).toHaveProperty('middleware')
 
   builderWithMw3.handler((options) => {
@@ -916,7 +918,7 @@ test('createServerFn with request middleware and function middleware', () => {
   })
 
   const funMw = createMiddleware({ type: 'function' })
-    .inputValidator((x: string) => x)
+    .validator((x: string) => x)
     .server(({ next }) => {
       return next({ context: { a: 'a' } as const })
     })
@@ -927,7 +929,7 @@ test('createServerFn with request middleware and function middleware', () => {
   expectTypeOf(fn({ data: 'a' })).toEqualTypeOf<Promise<{}>>()
 })
 
-test('createServerFn with inputValidator and request middleware', () => {
+test('createServerFn with validator and request middleware', () => {
   const loggingMiddleware = createMiddleware().server(async ({ next }) => {
     console.log('Logging middleware executed on the server')
     const result = await next()
@@ -936,7 +938,7 @@ test('createServerFn with inputValidator and request middleware', () => {
 
   const fn = createServerFn()
     .middleware([loggingMiddleware])
-    .inputValidator(({ userName }: { userName: string }) => {
+    .validator(({ userName }: { userName: string }) => {
       return { userName }
     })
     .handler(async ({ data }) => {