v1.2.0

Websocket Support

We have adapters for Bun, Node, Deno, Crossws, ... docs here

import { experimental_RPCHandler as RPCHandler } from '@orpc/server/bun-ws'

const handler = new RPCHandler(router)

Bun.serve({
  fetch(req, server) {
    if (server.upgrade(req)) {
      return
    }

    return new Response('Upgrade failed', { status: 500 })
  },
  websocket: {
    message(ws, message) {
      handler.message(ws, message, {
        context: {}, // Provide initial context if needed
      })
    },
    close(ws) {
      handler.close(ws)
    },
  },
})

Zod 4 support

import {
  experimental_ZodSmartCoercionPlugin as ZodSmartCoercionPlugin
} from '@orpc/zod/zod4' // <-- zod v4
import {
  experimental_ZodToJsonSchemaConverter as ZodToJsonSchemaConverter
} from '@orpc/zod/zod4' // <-- zod v4

---

   🚀 Features

• Support HEAD method  -  by @unnoq in #468 (075ee)
• openapi: CreateJsonifiedRouterClient  -  by @unnoq in #449 (a2fc0)
• react: Use useTransition within useServerAction  -  by @unnoq in #459 (95b67)
• standard-server: Server adapter for connected peers  -  by @unnoq in #456 (98784)
• zod: Experimental support zod v4  -  by @unnoq in #462 (d5f6b)

   🐞 Bug Fixes

• openapi: Inline spec into scalar html (OpenAPI Reference Plugin)  -  by @unnoq in #469 (77566)
• server: SSE with keepalive crashes server on client disconnect  -  by @unnoq in #464 (13307)
• standard-server: Improve event-iterator cleanup  -  by @unnoq in #466 (24429)

    View changes on GitHub

v1.1.1

   🐞 Bug Fixes

• server: Ensure .actionable throws Next.js errors  -  by @unnoq in #452 (f6359)

    View changes on GitHub

v1.1.0

✨ [NEW] OpenAPI Reference Plugin (Swagger/Scalar)

Easy serve beautiful OpenAPI Reference Client UI powered by Scalar

const handler = new OpenAPIHandler(router, {
  plugins: [
    new OpenAPIReferencePlugin({
      schemaConverters: [
        new ZodToJsonSchemaConverter(),
      ],
      specGenerateOptions: {
        info: {
          title: 'ORPC Playground',
          version: '1.0.0',
        },
      },
    }),
  ]
})

✨ [NEW] Partical React Native Support

React Native includes a Fetch API, so you can use oRPC out of the box. However, the Fetch API in React Native has limitations. oRPC features like File, Blob, and AsyncIteratorObject aren't supported. Follow Support Stream #27741 for updates.

---

   🚀 Features

• client: Batch Plugin auto‑infer context from link  -  by @unnoq in #427 (ff41b)
• openapi: OpenAPI Reference Plugin  -  by @unnoq in #442 (7336c)
• server: Allow .concat middlewares with narrowed input types  -  by @unnoq in #420 (2d41a)
• standard-server: Support React Native by explicitly checking body  -  by @unnoq in #445 (41631)

   🐞 Bug Fixes

• deps: Update dependency rou3 to ^0.6.0  -  in #423 (16739)

    View changes on GitHub

v1.0.3

Finally oRPC v1 here ❤️‍🔥❤️‍🔥

Read announcement and oRPC story here: https://orpc.unnoq.com/blog/v1-announcement

oRPC vs X

• oRPC is 1,6 times typecheck faster (5.9s vs 9.3s)
• oRPC is 2,8 times runtime faster (295k reqs vs 104k reqs / 20 sec)
• oRPC is 1,26 times less max cpu usage (102% vs 129%)
• oRPC is 2,6 times less max ram usage (103MB vs 268MB)
• oRPC is 2 times smaller in bundle size (32.3 kB vs 65.5 kB)

---

   🚀 Features

• openapi: Async json schema converter support  -  by @unnoq in #407 (6f0af)

    View changes on GitHub

v1.0.0-beta.7

🚀 Improve and bug fixed for BatchPlugin and RetryPlugin

🚨 Remove built-in hono.dev and nextjs.org integrations (check the docs to create your own)

---

No significant changes

    View changes on GitHub

v0.54.0

   🚨 Breaking Changes

• server: Remove built-in next and hono integrations  -  by @unnoq in #363 (cf06e)

   🚀 Features

• client: Pass isSuccess to ClientRetryPlugin onRetry returned callback  -  by @unnoq in #389 (b3c3a)
• server: Error on unsupported batch response types  -  by @unnoq in #355 (bb258)

   🐞 Bug Fixes

• standard-server: Batch signal  -  by @unnoq in #353 (05d8f)

   🏎 Performance

• standard-server:
  • Reduce payload size for batch request/response  -  by @unnoq in #352 (57d90)
  • Reduce payload size for batch responses  -  by @unnoq in #354 (a6dec)

    View changes on GitHub

v1.0.0-beta.6

✨ Batch Reqeusts/Responses

The Batch Request/Response Plugin allows you to combine multiple requests and responses into a single batch, reducing the overhead of sending each one separately. Read more

🚨 Breaking Changes 🚨

• Renamed success to isSuccess in the safe utility for clarity.
• Updated the onFinish callback state to align with the safe utility's output.
• Revised configuration options for RPCLink, OpenAPILink, interceptors, and plugins.
• Included the full response data in MalformedResponseError to simplify debugging.

✨ Features ✨

• Added dynamic retry logic support to the ClientRetry plugin.
• Introduced StrictGetMethodPlugin (enabled by default for RPCHandler) to enforce GET usage.
• Added a simple CSRF protection plugin.
• Added a request/response batching plugin.
• Links (RPCLink, OpenAPILink) now support search queries directly in the base URL.
• Made plugin execution order configurable.

🐞 Bug Fixes 🐞

• Fixed OpenAPI spec generation for optional response bodies.
• Fixed file deserialization errors involving empty filenames.
• Resolved issues using onSuccess/onError hooks as middleware.
• Improved type inference in certain scenarios.
• Fixed issues resulting from repeated .next calls.
• Corrected server-side URL prefix handling.

🏎 Performance 🏎

• Optimized the payload size for void returns in event-iterator.

---

No significant changes

    View changes on GitHub

v0.53.0

✨ Batch Reqeusts/Responses

The Batch Request/Response Plugin allows you to combine multiple requests and responses into a single batch, reducing the overhead of sending each one separately. Read more

🚨 Breaking Changes 🚨

• Renamed success to isSuccess in the safe utility for clarity.
• Updated the onFinish callback state to align with the safe utility's output.
• Revised configuration options for RPCLink, OpenAPILink, interceptors, and plugins.
• Included the full response data in MalformedResponseError to simplify debugging.

✨ Features ✨

• Added dynamic retry logic support to the ClientRetry plugin.
• Introduced StrictGetMethodPlugin (enabled by default for RPCHandler) to enforce GET usage.
• Added a simple CSRF protection plugin.
• Added a request/response batching plugin.
• Links (RPCLink, OpenAPILink) now support search queries directly in the base URL.
• Made plugin execution order configurable.

🐞 Bug Fixes 🐞

• Fixed OpenAPI spec generation for optional response bodies.
• Fixed file deserialization errors involving empty filenames.
• Resolved issues using onSuccess/onError hooks as middleware.
• Improved type inference in certain scenarios.
• Fixed issues resulting from repeated .next calls.
• Corrected server-side URL prefix handling.

🏎 Performance 🏎

• Optimized the payload size for void returns in event-iterator.

---

   🚨 Breaking Changes

• Update onFinish state  -  by @unnoq in #332 (aa59d)
• client:
  • Rename success property to isSuccess in safe utility  -  by @unnoq (ee46d)
  • Update standard link interceptors and plugins options  -  by @unnoq in #333 (6b06c)
  • Update standard link options  -  by @unnoq in #338 (4c9dd)
  • Include entire response in malformed response error data  -  by @unnoq in #341 (96f9d)

   🚀 Features

• client:
  • Dynamic retry for "Client Retry Plugin"  -  by @unnoq in #318 (05a8f)
  • Support search query in base url  -  by @unnoq in #324 (4038f)
• client, server:
  • Batch request/response plugin  -  by @unnoq in #329 (32a6d)
  • Make plugin execution order configurable  -  by @unnoq in #344 (350a1)
  • Simple csrf protection plugin  -  by @unnoq in #346 (2f2db)
• server:
  • GET method guard plugin  -  by @unnoq in #347 (3ee2e)
  • Renamed to StrictGetMethodPlugin and enabled it by default in RPCHandler  -  by @unnoq in #348 (c72b9)

   🐞 Bug Fixes

• .next broken when calling multiple times  -  by @unnoq in #337 (25532)
• openapi:
  • Correct success response spec for optional body  -  by @unnoq in #319 (c0ca4)
• server:
  • Cannot infer without reference issue  -  by @unnoq in #321 (bdd21)
  • Handle prefix problem  -  by @unnoq in #326 (655ea)
  • OnSuccess, onError, ... cannot use as a middleware  -  by @unnoq in #331 (31916)
• standard-server:
  • Handle empty filename during file deserialization  -  by @unnoq in #320 (910f9)

   🏎 Performance

• standard-server: Optimize event-iterator payload for void returns  -  by @unnoq (f4735)

    View changes on GitHub

v1.0.0-beta.5

🚨 Breaking Change Server Action 🚨

The Server Action has been completely remake and you need upgrade your code to reflect new changes

Tuple return

'use client'

// before
const data = await ping({ name })
// now
const [error, data] = await ping({ name })

Support Typesafe error handling

'use client'

const [error, data] = await someAction({ name: 'John' })

if (error) {
  if (error.defined) {
    console.log(error.data)
    //                 ^ Typed error data
  }
  // Handle unknown errors
}
else {
  // Handle success
  console.log(data)
}

useServerAction Hook

The useServerAction hook simplifies invoking server actions in React.

const { execute, data, error, status } = useServerAction(someAction, {
  interceptors: [
    onError((error) => {
      if (isDefinedError(error)) {
        console.error(error.data)
        //                   ^ Typed error data
      }
    }),
  ],
})

createFormAction Utility

The createFormAction utility accepts a procedure and returns a function to handle form submissions. It uses Bracket Notation to deserialize form data.

import { createFormAction } from '@orpc/react'

const dosomething = os
  .input(
    z.object({
      user: z.object({
        name: z.string(),
        age: z.coerce.number(),
      }),
    })
  )
  .handler(({ input }) => {
    console.log('Form action called!')
    console.log(input)
  })

export const redirectSomeWhereForm = createFormAction(dosomething, {
  interceptors: [
    onSuccess(async () => {
      redirect('/some-where')
    }),
  ],
})

export function MyComponent() {
  return (
    <form action={redirectSomeWhereForm}>
      <input type="text" name="user[name]" required />
      <input type="number" name="user[age]" required />
      <button type="submit">Submit</button>
    </form>
  )
}

🚀 Features

OpenAPILink

OpenAPILink enables communication with an OpenAPIHandler on your server using HTTP/Fetch.

const link = new OpenAPILink(contract, {
  url: 'http://localhost:3000/api',
  headers: () => ({
    'x-api-key': 'my-api-key',
  }),
  // fetch: <-- polyfill fetch if needed
})

Support 3xx response

By combining the successStatus and outputStructure options, you can return a standard HTTP redirect response.

const redirect = os
  .route({
    method: 'GET',
    path: '/redirect',
    successStatus: 307, 
    outputStructure: 'detailed'
  })
  .handler(async () => {
    return {
      headers: {
        location: 'https://orpc.unnoq.com', 
      },
    }
  })

And many other improvements

---

No significant changes

    View changes on GitHub

v0.52.0

🚨 Breaking Change Server Action 🚨

The Server Action has been completely remake and you need upgrade your code to reflect new changes

Tuple return

'use client'

// before
const data = await ping({ name })
// now
const [error, data] = await ping({ name })

Support Typesafe error handling

'use client'

const [error, data] = await someAction({ name: 'John' })

if (error) {
  if (error.defined) {
    console.log(error.data)
    //                 ^ Typed error data
  }
  // Handle unknown errors
}
else {
  // Handle success
  console.log(data)
}

useServerAction Hook

The useServerAction hook simplifies invoking server actions in React.

const { execute, data, error, status } = useServerAction(someAction, {
  interceptors: [
    onError((error) => {
      if (isDefinedError(error)) {
        console.error(error.data)
        //                   ^ Typed error data
      }
    }),
  ],
})

createFormAction Utility

The createFormAction utility accepts a procedure and returns a function to handle form submissions. It uses Bracket Notation to deserialize form data.

import { createFormAction } from '@orpc/react'

const dosomething = os
  .input(
    z.object({
      user: z.object({
        name: z.string(),
        age: z.coerce.number(),
      }),
    })
  )
  .handler(({ input }) => {
    console.log('Form action called!')
    console.log(input)
  })

export const redirectSomeWhereForm = createFormAction(dosomething, {
  interceptors: [
    onSuccess(async () => {
      redirect('/some-where')
    }),
  ],
})

export function MyComponent() {
  return (
    <form action={redirectSomeWhereForm}>
      <input type="text" name="user[name]" required />
      <input type="number" name="user[age]" required />
      <button type="submit">Submit</button>
    </form>
  )
}

🚀 Features

OpenAPILink

OpenAPILink enables communication with an OpenAPIHandler on your server using HTTP/Fetch.

const link = new OpenAPILink(contract, {
  url: 'http://localhost:3000/api',
  headers: () => ({
    'x-api-key': 'my-api-key',
  }),
  // fetch: <-- polyfill fetch if needed
})

Support 3xx response

By combining the successStatus and outputStructure options, you can return a standard HTTP redirect response.

const redirect = os
  .route({
    method: 'GET',
    path: '/redirect',
    successStatus: 307, 
    outputStructure: 'detailed'
  })
  .handler(async () => {
    return {
      headers: {
        location: 'https://orpc.unnoq.com', 
      },
    }
  })

And many other improvements

---

   🚨 Breaking Changes

• client:
  • Improve malformed response errors  -  by @unnoq in #317 (48a56)
• server:
  • Remove input type in client interceptors  -  by @unnoq in #309 (783ae)
  • Prevent middleware context conflicts  -  by @unnoq in #313 (85e5d)
• server, react:
  • Remake server action  -  by @unnoq in #308 (9486a)
• standard-server:
  • Remove unused raw  -  by @unnoq in #298 (427bf)

   🚀 Features

• client, contract, openapi: Support 3xx response  -  by @unnoq in #304 (30c0e)
• client, server: Allow numbers and symbols as context keys  -  by @unnoq in #312 (10ace)
• openapi: OpenAPILink  -  by @unnoq in #303 (a2467)
• server: Support config ThrowableError  -  by @unnoq in #311 (d1f8e)

   🐞 Bug Fixes

• server: Cannot infer without reference issue  -  by @unnoq in #315 (00fb0)

    View changes on GitHub