Server-Side Clients

Call your procedures in the same environment as your server, no proxies required like native functions.

Calling Procedures

oRPC offers multiple methods to invoke a procedure.

Using .callable

Define your procedure and turn it into a callable procedure:

import {  } from '@orpc/server'
import * as  from 'zod'

const  = 
  .(.({ : .() }))
  .(async ({  }) => ({ : . }))
  .({
    : {} // Provide initial context if needed
  })

const  = await ({ : '123' })

Using the call Utility

Alternatively, call your procedure using the call helper:

import * as  from 'zod'
import { ,  } from '@orpc/server'

const  = 
  .(.({ : .() }))
  .(async ({  }) => ({ : . }))

const  = await (, { : '123' }, {
  : {} // Provide initial context if needed
})

Router Client

Create a router based client to access multiple procedures:

import { ,  } from '@orpc/server'

const  = .(() => 'pong')
const  = .(() => 'ping')

const  = ({ ,  }, {
  : {} // Provide initial context if needed
})

const  = await .()

Client Context

You can define a client context to pass additional information when calling procedures. This is useful for modifying procedure behavior dynamically.

interface ClientContext {
  ?: boolean
}

const  = .(() => 'pong')
const  = .(() => 'ping')

const  = ({ ,  }, {
  : ({  }: ClientContext) => { 
    if () {
      return {} // <-- context when cache enabled
    }

    return {} // <-- context when cache disabled
  }
})

const  = await .(, { : { : true } })

INFO

If ClientContext contains a required property, oRPC enforces that the client provides it when calling a procedure.

Lifecycle

Middlewares Order

To ensure that all middlewares run after input validation and before output validation, apply the following configuration:

const base = os.$config({
  initialInputValidationIndex: Number.NEGATIVE_INFINITY,
  initialOutputValidationIndex: Number.NEGATIVE_INFINITY,
})

INFO

By default, oRPC executes middlewares based on their registration order relative to validation steps. Middlewares registered before .input run before input validation, and those registered after .output run before output validation.