orpc

name	orpc
description	Type-safe API development with oRPC — end-to-end typesafe procedures, OpenAPI support, streaming, and multi-framework integrations
metadata	{"author":"Minsu Lee","version":"2026.3.30","source":"Generated from https://github.com/middleapi/orpc, scripts located at https://github.com/amondnet/skills"}

The skill is based on oRPC v1.13.13, generated at 2026-03-30.

oRPC is a TypeScript-first RPC framework for building end-to-end typesafe APIs. It provides procedure-based API definitions with input/output validation (Zod, Valibot, ArkType), middleware chains, type-safe error handling, OpenAPI 3.1.1 spec generation, streaming via Event Iterators (SSE), contract-first development, and integrations with TanStack Query, AI SDK, React Server Actions, and more.

Core References

Topic	Description	Reference
Procedure	Defining procedures with validation, middleware, and handlers	core-procedure
Router	Router composition, lazy loading, and type inference	core-router
Middleware	Context injection, guards, input/output interception, lifecycle hooks	core-middleware
Context	Type-safe dependency injection with initial and execution context	core-context
Error Handling	ORPCError, type-safe errors, HTTP status mappings, client error handling	core-error-handling

Features

Handlers & Transport

Topic	Description	Reference
Handlers	RPCHandler and OpenAPIHandler setup, data types, lifecycle	features-handler
Client	RPCLink, OpenAPILink, DynamicLink, server/client-side clients	features-client
OpenAPI	Spec generation, routing, input/output structure, operation metadata	features-openapi

Real-time & Streaming

Topic	Description	Reference
Event Iterator	Streaming/SSE with async generators, EventPublisher, resume support	features-event-iterator

Framework Integration

Topic	Description	Reference
Server Action	React Server Actions with useServerAction, optimistic updates, forms	features-server-action
Contract First	Define, implement, and convert contracts for API-first development	features-contract-first
TanStack Query	Query/mutation options, hydration, streaming queries, key management	features-tanstack-query

Plugins

Topic	Description	Reference
Server Plugins	CORS, batch, body limit, CSRF, compression, strict GET, rethrow, response/request headers	plugins-server
Client Plugins	Retry, batch, dedupe, retry-after, request/response validation	plugins-client

Integrations

Topic	Description	Reference
AI SDK	Vercel AI SDK streaming, tool creation, chat patterns	integrations-ai-sdk
Observability	OpenTelemetry instrumentation, Pino logging	integrations-observability

Best Practices & Advanced

Topic	Description	Reference
Best Practices	Middleware dedup, SSR optimization, testing/mocking, metadata	best-practices-patterns
Custom Plugins	Building handler and link plugins with interceptors	advanced-custom-plugins
Validation Errors	Customizing validation error responses	advanced-validation-errors
Helpers	Rate limiting, publisher, cookie, encryption, signing, form data	advanced-helpers