8000 orpc/packages/openapi at main ยท ctjhoa/orpc ยท GitHub
[go: up one dir, main page]

Skip to content

Latest commit

ย 

History

History
ย 
ย 

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

README.md

oRPC logo

Typesafe APIs Made Simple ๐Ÿช„

oRPC is a powerful combination of RPC and OpenAPI, makes it easy to build APIs that are end-to-end type-safe and adhere to OpenAPI standards


Highlights

  • ๐Ÿ”— End-to-End Type Safety: Ensure type-safe inputs, outputs, and errors from client to server.
  • ๐Ÿ“˜ First-Class OpenAPI: Built-in support that fully adheres to the OpenAPI standard.
  • ๐Ÿ“ Contract-First Development: Optionally define your API contract before implementation.
  • ๐Ÿ” First-Class OpenTelemetry: Seamlessly integrate with OpenTelemetry for observability.
  • โš™๏ธ Framework Integrations: Seamlessly integrate with TanStack Query (React, Vue, Solid, Svelte, Angular), SWR, Pinia Colada, and more.
  • ๐Ÿš€ Server Actions: Fully compatible with React Server Actions on Next.js, TanStack Start, and other platforms.
  • ๐Ÿ”  Standard Schema Support: Works out of the box with Zod, Valibot, ArkType, and other schema validators.
  • ๐Ÿ—ƒ๏ธ Native Types: Supports native types like Date, File, Blob, BigInt, URL, and more.
  • โฑ๏ธ Lazy Router: Enhance cold start times with our lazy routing feature.
  • ๐Ÿ“ก SSE & Streaming: Enjoy full type-safe support for SSE and streaming.
  • ๐ŸŒ Multi-Runtime Support: Fast and lightweight on Cloudflare, Deno, Bun, Node.js, and beyond.
  • ๐Ÿ”Œ Extendability: Easily extend functionality with plugins, middleware, and interceptors.

Documentation

You can find the full documentation here.

Packages

@orpc/openapi

Generate OpenAPI specs and handle OpenAPI requests. Read the documentation for more information.

import { createServer } from 'node:http'
import { OpenAPIHandler } from '@orpc/openapi/node'
import { CORSPlugin } from '@orpc/server/plugins'

const handler = new OpenAPIHandler(router, {
  plugins: [new CORSPlugin()]
})

const server = createServer(async (req, res) => {
  const result = await handler.handle(req, res, {
    context: { headers: req.headers }
  })

  if (!result.matched) {
    res.statusCode = 404
    res.end('No procedure matched')
  }
})

server.listen(3000, '127.0.0.1', () => console.log('Listening on 127.0.0.1:3000'))

Sponsors

License

Distributed under the MIT License. See LICENSE for more information.

0