v1.0.0-beta.1

📅6 months, 176,384 ++, 116,777 --
🎉 oRPC 1.0.0-beta.1 now available

✅ Typesafe Input/Output/Errors/File/Streaming
✅ Tanstack query (React, Vue, Solid, Svelte)
✅ React Server Action
✅ (Optional) Contract First Dev
✅ OpenAPI Spec
✅ Vue Pinia
✅ Standard Schema

Production ready?
🫡 99% APIs are stable
🫡 99% Test Coverage
🫡 30 days left until v1

Adding @beta at the end to install

   🚨 Breaking Changes

• client: Update onEventIteratorStatusChange  -  by @unnoq in #212 (371be)
• client, server: Improve RPC JSON Serializer Meta  -  by @unnoq in #242 (924a5)
• server: Remove dedupe middleware logic  -  by @unnoq in #225 (bf498)
• vue-colada: Remove deep ref in input & context options  -  by @unnoq in #238 (15d92)

   🚀 Features

• client:
  • Reexport hooks utilities  -  by @unnoq in #243 (9fc14)
• client, server:
  • Custom RPC JSON Serializer  -  by @unnoq in #241 (32f32)
• openapi:
  • Custom openapi json serializer  -  by @unnoq in #246 (5737a)
• server:
  • .$input  -  by @unnoq in #218 (1d331)
  • UnlazyRouter utility  -  by @unnoq in #219 (6c5bf)
  • Support chaining after .callable and .actionable  -  by @unnoq in #223 (69674)
  • Dedupe middlewares  -  by @unnoq in #236 (b45a5)
• solid-query:
  • Tanstack query integration for solid  -  by @unnoq in #227 (9b9ad)
• svelte-query:
  • Tanstack Query integration for Svelte  -  by @unnoq in #229 (999d6)
• zod:
  • Support readOnly, propertyNames in JSON schema  -  by @unnoq in #211 (25468)

   🐞 Bug Fixes

• contract, server:
  • has no properties in common with type ts-problem  -  by @unnoq in #247 (9dfce)
• server:
  • Reflect middleware initial context in procedure when use  -  by @unnoq in #234 (d4524)
  • has no properties in common with type ts-problem  -  by @unnoq in #244 (ba53a)
  • Return correct context from middleware next  -  by @unnoq in #245 (5d603)
• zod:
  • Apply propertyNames to string schemas in JSON Schema gen  -  by @unnoq in #217 (3b1da)

    View changes on GitHub

v0.48.0

For someone accidentally install latest version, can feel the same experience as 1.0.0-beta.1

   🚨 Breaking Changes

• client: Update onEventIteratorStatusChange  -  by @unnoq in #212 (371be)
• client, server: Improve RPC JSON Serializer Meta  -  by @unnoq in #242 (924a5)
• server: Remove dedupe middleware logic  -  by @unnoq in #225 (bf498)
• vue-colada: Remove deep ref in input & context options  -  by @unnoq in #238 (15d92)

   🚀 Features

• client:
  • Reexport hooks utilities  -  by @unnoq in #243 (9fc14)
• client, server:
  • Custom RPC JSON Serializer  -  by @unnoq in #241 (32f32)
• openapi:
  • Custom openapi json serializer  -  by @unnoq in #246 (5737a)
• server:
  • .$input  -  by @unnoq in #218 (1d331)
  • UnlazyRouter utility  -  by @unnoq in #219 (6c5bf)
  • Support chaining after .callable and .actionable  -  by @unnoq in #223 (69674)
  • Dedupe middlewares  -  by @unnoq in #236 (b45a5)
• solid-query:
  • Tanstack query integration for solid  -  by @unnoq in #227 (9b9ad)
• svelte-query:
  • Tanstack Query integration for Svelte  -  by @unnoq in #229 (999d6)
• zod:
  • Support readOnly, propertyNames in JSON schema  -  by @unnoq in #211 (25468)

   🐞 Bug Fixes

• contract, server:
  • has no properties in common with type ts-problem  -  by @unnoq in #247 (9dfce)
• server:
  • Reflect middleware initial context in procedure when use  -  by @unnoq in #234 (d4524)
  • has no properties in common with type ts-problem  -  by @unnoq in #244 (ba53a)
  • Return correct context from middleware next  -  by @unnoq in #245 (5d603)
• zod:
  • Apply propertyNames to string schemas in JSON Schema gen  -  by @unnoq in #217 (3b1da)

    View changes on GitHub

v0.47.0

🚀 OpenAPIGenerator and @orpc/zod Rewritten! 🚀

We've completely revamped OpenAPIGenerator and @orpc/zod, bringing:
✅ 95% test coverage for reliability
✅ Improved bundling: 25.4 kB (gzip) -> 8.64 (gzip)
✅ Improved performance
✅ Enhancements across all specifications

🚨 Breaking Changes 🚨

Some options have changed. Run tsc to check for any necessary updates.

   🚨 Breaking Changes

• client, server: Minify link and handler options  -  by @unnoq in #202 (68378)
• query, vue-colada: Update utils options  -  by @unnoq in #209 (c0088)

   🚀 Features

• openapi: Rewrite OpenAPIGenerator  -  by @unnoq in #208 (56cbd)
• server: InferRouterInitialContexts & InferRouterCurrentContexts  -  by @unnoq in #201 (df024)
• zod: Rewrite @orpc/zod  -  by @unnoq in #206 (14314)

   🐞 Bug Fixes

• query: Unable to infer mutation context when onMutate has args  -  by @unnoq in #200 (954e6)

    View changes on GitHub

v0.46.0

🚨 Breaking Changes 🚨

RPCLink, RPCHandler, OpenAPIHandler, ...

• Rename eventSourcePingEnabled option to eventIteratorKeepAliveEnabled
• Rename eventSourcePingInterval option to eventIteratorKeepAliveInterval
• Rename eventSourcePingContent option to eventIteratorKeepAliveComment

RPCLink

• Rename eventSourceMaxNumberOfRetries option to eventIteratorMaxRetries
• Rename eventSourceRetryDelay option to eventIteratorRetryDelay
• Rename eventSourceRetry option to eventIteratorShouldRetry

🌟 New APIs 🌟

RPCLink

• interceptors for intercept before call
• clientInterceptors for intercepting before send request

   🚨 Breaking Changes

• Update event-iterator options  -  by @unnoq in #199 (93e60)
• client: New StandardLink  -  by @unnoq in #193 (d16a1)

   🚀 Features

• server: Reexport common things from contract  -  by @unnoq in #194 (09ec5)

    View changes on GitHub

v0.45.1

   🐞 Bug Fixes

• openapi-client: Handle empty objects in bracket-notation deserialization  -  by @unnoq in #196 (1b155)

    View changes on GitHub

v0.45.0

🏎 Performance 🏎

Procedure with .output now dramatically enhance both type-checking and IDE-suggestion speed.

const example = os
  .output(type<string>())
  .handler(() => 'Hello word!')

   🐞 Bug Fixes

• query:
  • Correctly infer mutation context  -  by @unnoq in #189 (a05fb)
  • Conflict types when override options  -  by @unnoq in #190 (05ebc)
• vue-colada:
  • Correctly infer mutation context  -  by @unnoq in #191 (cd121)

   🏎 Performance

• server: Enhance type checking for builders  -  by @unnoq in #187 (2fcf6)

    View changes on GitHub

v0.44.0

🚀 Event-Source Ping Interval

New feature to keep Event Iterator alive.
RPCHandler periodically sends a ping comment to the client. You can configure this behavior using the following options:

• eventSourcePingEnabled (default: true) – Enables or disables pings.
• eventSourcePingInterval (default: 5000) – Time between pings (in milliseconds).
• eventSourcePingContent (default: '') – Custom content for ping messages.

const result = await handler.handle(request, {
  eventSourcePingEnabled: true,
  eventSourcePingInterval: 5000, // 5 seconds
  eventSourcePingContent: '',
})

   🚨 Breaking Changes

• Update standard server  -  by @unnoq in #179 (cc4cb)
• client, server: Update event-source errors and decode behavior  -  by @unnoq in #182 (92faa)

   🚀 Features

• client, server: Event-Source Ping Interval  -  by @unnoq in #183 (d0e42)

   🐞 Bug Fixes

• Make compatible with moduleResolution=node*  -  by @unnoq in #185 (84e58)

    View changes on GitHub

v0.43.0

🚨 Update safe utility 🚨

Before:

• safe return tuple [data, error, isDefined]
• error be undefined when success

Now:

• safe supports both tuple [error, data, isDefined] and object { error, data, isDefined } styles
• error be null when success

const [error, data, isDefined] = await safe(doSomething({ id: '123' }))
// or const { error, data, isDefined } = await safe(doSomething({ id: '123' }))

if (isDefinedError(error)) { // or isDefined
 // handle known error
 console.log(error.data.retryAfter)
}
else if (error) {
 // handle unknown error
}
else {
 // handle success
 console.log(data)
}

   🚨 Breaking Changes

• Not parse invalid bracket notation  -  by @unnoq in #175 (fd117)
• client: Update safe utility  -  by @unnoq in #174 (553ad)

    View changes on GitHub

v0.42.0

There breaking changes not change any visible APIs

   🚨 Breaking Changes

• Update rpc and openapi serializer  -  by @unnoq in #171 (7e904)

    View changes on GitHub

v0.41.2

🚨 Breaking Changes 🚨

This breaking changes not effect to end-user

• rename interceptorsRoot -> rootInterceptors
• add clientInterceptors
• remove beforeCreateClient in plugin

const handler = new RPCHandler(router, {
   rootInterceptors: [],
   clientInterceptors: [],
})

   🚨 Breaking Changes

• server: Update interceptors & plugins workflow  -  by @unnoq in #164 (ff590)

   🐞 Bug Fixes

• Dead links and clean url problems  -  by @unnoq in #165 (7d3bd)

    View changes on GitHub