@orpc/contract 0.0.0-next.f56d2b3 → 0.0.0-next.f677f1d
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +114 -0
- package/dist/index.d.mts +307 -0
- package/dist/index.d.ts +307 -0
- package/dist/index.mjs +326 -0
- package/dist/plugins/index.d.mts +43 -0
- package/dist/plugins/index.d.ts +43 -0
- package/dist/plugins/index.mjs +81 -0
- package/dist/shared/contract.CvRxURhn.d.mts +254 -0
- package/dist/shared/contract.CvRxURhn.d.ts +254 -0
- package/dist/shared/contract.D_dZrO__.mjs +53 -0
- package/package.json +16 -14
- package/dist/index.js +0 -402
- package/dist/src/builder-variants.d.ts +0 -38
- package/dist/src/builder.d.ts +0 -32
- package/dist/src/client-utils.d.ts +0 -5
- package/dist/src/client.d.ts +0 -21
- package/dist/src/config.d.ts +0 -10
- package/dist/src/error-map.d.ts +0 -14
- package/dist/src/error-orpc.d.ts +0 -109
- package/dist/src/error-utils.d.ts +0 -14
- package/dist/src/error.d.ts +0 -13
- package/dist/src/index.d.ts +0 -19
- package/dist/src/meta.d.ts +0 -3
- package/dist/src/procedure-client.d.ts +0 -6
- package/dist/src/procedure.d.ts +0 -18
- package/dist/src/route.d.ts +0 -79
- package/dist/src/router-client.d.ts +0 -7
- package/dist/src/router.d.ts +0 -29
- package/dist/src/schema.d.ts +0 -8
- package/dist/src/types.d.ts +0 -3
package/README.md
ADDED
|
@@ -0,0 +1,114 @@
|
|
|
1
|
+
<div align="center">
|
|
2
|
+
<image align="center" src="https://orpc.unnoq.com/logo.webp" width=280 alt="oRPC logo" />
|
|
3
|
+
</div>
|
|
4
|
+
|
|
5
|
+
<h1></h1>
|
|
6
|
+
|
|
7
|
+
<div align="center">
|
|
8
|
+
<a href="https://codecov.io/gh/unnoq/orpc">
|
|
9
|
+
<img alt="codecov" src="https://codecov.io/gh/unnoq/orpc/branch/main/graph/badge.svg">
|
|
10
|
+
</a>
|
|
11
|
+
<a href="https://www.npmjs.com/package/@orpc/contract">
|
|
12
|
+
<img alt="weekly downloads" src="https://img.shields.io/npm/dw/%40orpc%2Fcontract?logo=npm" />
|
|
13
|
+
</a>
|
|
14
|
+
<a href="https://github.com/unnoq/orpc/blob/main/LICENSE">
|
|
15
|
+
<img alt="MIT License" src="https://img.shields.io/github/license/unnoq/orpc?logo=open-source-initiative" />
|
|
16
|
+
</a>
|
|
17
|
+
<a href="https://discord.gg/TXEbwRBvQn">
|
|
18
|
+
<img alt="Discord" src="https://img.shields.io/discord/1308966753044398161?color=7389D8&label&logo=discord&logoColor=ffffff" />
|
|
19
|
+
</a>
|
|
20
|
+
<a href="https://deepwiki.com/unnoq/orpc">
|
|
21
|
+
<img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki">
|
|
22
|
+
</a>
|
|
23
|
+
</div>
|
|
24
|
+
|
|
25
|
+
<h3 align="center">Typesafe APIs Made Simple 🪄</h3>
|
|
26
|
+
|
|
27
|
+
**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
|
|
28
|
+
|
|
29
|
+
---
|
|
30
|
+
|
|
31
|
+
## Highlights
|
|
32
|
+
|
|
33
|
+
- **🔗 End-to-End Type Safety**: Ensure type-safe inputs, outputs, and errors from client to server.
|
|
34
|
+
- **📘 First-Class OpenAPI**: Built-in support that fully adheres to the OpenAPI standard.
|
|
35
|
+
- **📝 Contract-First Development**: Optionally define your API contract before implementation.
|
|
36
|
+
- **🔍 First-Class OpenTelemetry**: Seamlessly integrate with OpenTelemetry for observability.
|
|
37
|
+
- **⚙️ Framework Integrations**: Seamlessly integrate with TanStack Query (React, Vue, Solid, Svelte, Angular), SWR, Pinia Colada, and more.
|
|
38
|
+
- **🚀 Server Actions**: Fully compatible with React Server Actions on Next.js, TanStack Start, and other platforms.
|
|
39
|
+
- **🔠 Standard Schema Support**: Works out of the box with Zod, Valibot, ArkType, and other schema validators.
|
|
40
|
+
- **🗃️ Native Types**: Supports native types like Date, File, Blob, BigInt, URL, and more.
|
|
41
|
+
- **⏱️ Lazy Router**: Enhance cold start times with our lazy routing feature.
|
|
42
|
+
- **📡 SSE & Streaming**: Enjoy full type-safe support for SSE and streaming.
|
|
43
|
+
- **🌍 Multi-Runtime Support**: Fast and lightweight on Cloudflare, Deno, Bun, Node.js, and beyond.
|
|
44
|
+
- **🔌 Extendability**: Easily extend functionality with plugins, middleware, and interceptors.
|
|
45
|
+
|
|
46
|
+
## Documentation
|
|
47
|
+
|
|
48
|
+
You can find the full documentation [here](https://orpc.unnoq.com).
|
|
49
|
+
|
|
50
|
+
## Packages
|
|
51
|
+
|
|
52
|
+
- [@orpc/contract](https://www.npmjs.com/package/@orpc/contract): Build your API contract.
|
|
53
|
+
- [@orpc/server](https://www.npmjs.com/package/@orpc/server): Build your API or implement API contract.
|
|
54
|
+
- [@orpc/client](https://www.npmjs.com/package/@orpc/client): Consume your API on the client with type-safety.
|
|
55
|
+
- [@orpc/openapi](https://www.npmjs.com/package/@orpc/openapi): Generate OpenAPI specs and handle OpenAPI requests.
|
|
56
|
+
- [@orpc/otel](https://www.npmjs.com/package/@orpc/otel): [OpenTelemetry](https://opentelemetry.io/) integration for observability.
|
|
57
|
+
- [@orpc/nest](https://www.npmjs.com/package/@orpc/nest): Deeply integrate oRPC with [NestJS](https://nestjs.com/).
|
|
58
|
+
- [@orpc/react](https://www.npmjs.com/package/@orpc/react): Utilities for integrating oRPC with React and React Server Actions.
|
|
59
|
+
- [@orpc/tanstack-query](https://www.npmjs.com/package/@orpc/tanstack-query): [TanStack Query](https://tanstack.com/query/latest) integration.
|
|
60
|
+
- [@orpc/experimental-react-swr](https://www.npmjs.com/package/@orpc/experimental-react-swr): [SWR](https://swr.vercel.app/) integration.
|
|
61
|
+
- [@orpc/vue-colada](https://www.npmjs.com/package/@orpc/vue-colada): Integration with [Pinia Colada](https://pinia-colada.esm.dev/).
|
|
62
|
+
- [@orpc/hey-api](https://www.npmjs.com/package/@orpc/hey-api): [Hey API](https://heyapi.dev/) integration.
|
|
63
|
+
- [@orpc/zod](https://www.npmjs.com/package/@orpc/zod): More schemas that [Zod](https://zod.dev/) doesn't support yet.
|
|
64
|
+
- [@orpc/valibot](https://www.npmjs.com/package/@orpc/valibot): OpenAPI spec generation from [Valibot](https://valibot.dev/).
|
|
65
|
+
- [@orpc/arktype](https://www.npmjs.com/package/@orpc/arktype): OpenAPI spec generation from [ArkType](https://arktype.io/).
|
|
66
|
+
|
|
67
|
+
## `@orpc/contract`
|
|
68
|
+
|
|
69
|
+
Build your API contract. Read the [documentation](https://orpc.unnoq.com/docs/contract-first/define-contract) for more information.
|
|
70
|
+
|
|
71
|
+
```ts
|
|
72
|
+
export const PlanetSchema = z.object({
|
|
73
|
+
id: z.number().int().min(1),
|
|
74
|
+
name: z.string(),
|
|
75
|
+
description: z.string().optional(),
|
|
76
|
+
})
|
|
77
|
+
|
|
78
|
+
export const listPlanetContract = oc
|
|
79
|
+
.input(
|
|
80
|
+
z.object({
|
|
81
|
+
limit: z.number().int().min(1).max(100).optional(),
|
|
82
|
+
cursor: z.number().int().min(0).default(0),
|
|
83
|
+
}),
|
|
84
|
+
)
|
|
85
|
+
.output(z.array(PlanetSchema))
|
|
86
|
+
|
|
87
|
+
export const findPlanetContract = oc
|
|
88
|
+
.input(PlanetSchema.pick({ id: true }))
|
|
89
|
+
.output(PlanetSchema)
|
|
90
|
+
|
|
91
|
+
export const createPlanetContract = oc
|
|
92
|
+
.input(PlanetSchema.omit({ id: true }))
|
|
93
|
+
.output(PlanetSchema)
|
|
94
|
+
|
|
95
|
+
export const contract = {
|
|
96
|
+
planet: {
|
|
97
|
+
list: listPlanetContract,
|
|
98
|
+
find: findPlanetContract,
|
|
99
|
+
create: createPlanetContract,
|
|
100
|
+
},
|
|
101
|
+
}
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
## Sponsors
|
|
105
|
+
|
|
106
|
+
<p align="center">
|
|
107
|
+
<a href="https://cdn.jsdelivr.net/gh/unnoq/unnoq/sponsors.svg">
|
|
108
|
+
<img src='https://cdn.jsdelivr.net/gh/unnoq/unnoq/sponsors.svg'/>
|
|
109
|
+
</a>
|
|
110
|
+
</p>
|
|
111
|
+
|
|
112
|
+
## License
|
|
113
|
+
|
|
114
|
+
Distributed under the MIT License. See [LICENSE](https://github.com/unnoq/orpc/blob/main/LICENSE) for more information.
|
package/dist/index.d.mts
ADDED
|
@@ -0,0 +1,307 @@
|
|
|
1
|
+
import { HTTPPath, HTTPMethod, ClientContext, Client } from '@orpc/client';
|
|
2
|
+
export { HTTPMethod, HTTPPath, ORPCError } from '@orpc/client';
|
|
3
|
+
import { E as ErrorMap, a as EnhanceRouteOptions, A as AnyContractRouter, C as ContractProcedure, M as MergedErrorMap, b as AnySchema, c as Meta, R as Route, d as ContractRouter, e as ContractProcedureDef, S as Schema, I as InputStructure, O as OutputStructure, f as InferSchemaInput, g as InferSchemaOutput, h as ErrorFromErrorMap, i as SchemaIssue } from './shared/contract.CvRxURhn.mjs';
|
|
4
|
+
export { o as AnyContractProcedure, k as ErrorMapItem, z as InferContractRouterErrorMap, x as InferContractRouterInputs, B as InferContractRouterMeta, y as InferContractRouterOutputs, l as ORPCErrorFromErrorMap, T as TypeRest, j as ValidationError, V as ValidationErrorOptions, w as enhanceRoute, p as isContractProcedure, m as mergeErrorMap, n as mergeMeta, s as mergePrefix, q as mergeRoute, t as mergeTags, r as prefixRoute, D as type, u as unshiftTagRoute, v as validateORPCError } from './shared/contract.CvRxURhn.mjs';
|
|
5
|
+
import { AsyncIteratorClass } from '@orpc/shared';
|
|
6
|
+
export { AsyncIteratorClass, Registry, ThrowableError } from '@orpc/shared';
|
|
7
|
+
export { OpenAPIV3_1 as OpenAPI } from 'openapi-types';
|
|
8
|
+
import '@standard-schema/spec';
|
|
9
|
+
|
|
10
|
+
declare function getContractRouter(router: AnyContractRouter, path: readonly string[]): AnyContractRouter | undefined;
|
|
11
|
+
type EnhancedContractRouter<T extends AnyContractRouter, TErrorMap extends ErrorMap> = T extends ContractProcedure<infer UInputSchema, infer UOutputSchema, infer UErrors, infer UMeta> ? ContractProcedure<UInputSchema, UOutputSchema, MergedErrorMap<TErrorMap, UErrors>, UMeta> : {
|
|
12
|
+
[K in keyof T]: T[K] extends AnyContractRouter ? EnhancedContractRouter<T[K], TErrorMap> : never;
|
|
13
|
+
};
|
|
14
|
+
interface EnhanceContractRouterOptions<TErrorMap extends ErrorMap> extends EnhanceRouteOptions {
|
|
15
|
+
errorMap: TErrorMap;
|
|
16
|
+
}
|
|
17
|
+
declare function enhanceContractRouter<T extends AnyContractRouter, TErrorMap extends ErrorMap>(router: T, options: EnhanceContractRouterOptions<TErrorMap>): EnhancedContractRouter<T, TErrorMap>;
|
|
18
|
+
/**
|
|
19
|
+
* Minify a contract router into a smaller object.
|
|
20
|
+
*
|
|
21
|
+
* You should export the result to a JSON file. On the client side, you can import this JSON file and use it as a contract router.
|
|
22
|
+
* This reduces the size of the contract and helps prevent leaking internal details of the router to the client.
|
|
23
|
+
*
|
|
24
|
+
* @see {@link https://orpc.unnoq.com/docs/contract-first/router-to-contract#minify-export-the-contract-router-for-the-client Router to Contract Docs}
|
|
25
|
+
*/
|
|
26
|
+
declare function minifyContractRouter(router: AnyContractRouter): AnyContractRouter;
|
|
27
|
+
|
|
28
|
+
interface ContractProcedureBuilder<TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap, TMeta extends Meta> extends ContractProcedure<TInputSchema, TOutputSchema, TErrorMap, TMeta> {
|
|
29
|
+
/**
|
|
30
|
+
* Adds type-safe custom errors to the contract.
|
|
31
|
+
* The provided errors are spared-merged with any existing errors in the contract.
|
|
32
|
+
*
|
|
33
|
+
* @see {@link https://orpc.unnoq.com/docs/error-handling#type%E2%80%90safe-error-handling Type-Safe Error Handling Docs}
|
|
34
|
+
*/
|
|
35
|
+
errors<U extends ErrorMap>(errors: U): ContractProcedureBuilder<TInputSchema, TOutputSchema, MergedErrorMap<TErrorMap, U>, TMeta>;
|
|
36
|
+
/**
|
|
37
|
+
* Sets or updates the metadata for the contract.
|
|
38
|
+
* The provided metadata is spared-merged with any existing metadata in the contract.
|
|
39
|
+
*
|
|
40
|
+
* @see {@link https://orpc.unnoq.com/docs/metadata Metadata Docs}
|
|
41
|
+
*/
|
|
42
|
+
meta(meta: TMeta): ContractProcedureBuilder<TInputSchema, TOutputSchema, TErrorMap, TMeta>;
|
|
43
|
+
/**
|
|
44
|
+
* Sets or updates the route definition for the contract.
|
|
45
|
+
* The provided route is spared-merged with any existing route in the contract.
|
|
46
|
+
* This option is typically relevant when integrating with OpenAPI.
|
|
47
|
+
*
|
|
48
|
+
* @see {@link https://orpc.unnoq.com/docs/openapi/routing OpenAPI Routing Docs}
|
|
49
|
+
* @see {@link https://orpc.unnoq.com/docs/openapi/input-output-structure OpenAPI Input/Output Structure Docs}
|
|
50
|
+
*/
|
|
51
|
+
route(route: Route): ContractProcedureBuilder<TInputSchema, TOutputSchema, TErrorMap, TMeta>;
|
|
52
|
+
/**
|
|
53
|
+
* Defines the input validation schema for the contract.
|
|
54
|
+
*
|
|
55
|
+
* @see {@link https://orpc.unnoq.com/docs/procedure#input-output-validation Input Validation Docs}
|
|
56
|
+
*/
|
|
57
|
+
input<U extends AnySchema>(schema: U): ContractProcedureBuilderWithInput<U, TOutputSchema, TErrorMap, TMeta>;
|
|
58
|
+
/**
|
|
59
|
+
* Defines the output validation schema for the contract.
|
|
60
|
+
*
|
|
61
|
+
* @see {@link https://orpc.unnoq.com/docs/procedure#input-output-validation Output Validation Docs}
|
|
62
|
+
*/
|
|
63
|
+
output<U extends AnySchema>(schema: U): ContractProcedureBuilderWithOutput<TInputSchema, U, TErrorMap, TMeta>;
|
|
64
|
+
}
|
|
65
|
+
interface ContractProcedureBuilderWithInput<TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap, TMeta extends Meta> extends ContractProcedure<TInputSchema, TOutputSchema, TErrorMap, TMeta> {
|
|
66
|
+
/**
|
|
67
|
+
* Adds type-safe custom errors to the contract.
|
|
68
|
+
* The provided errors are spared-merged with any existing errors in the contract.
|
|
69
|
+
*
|
|
70
|
+
* @see {@link https://orpc.unnoq.com/docs/error-handling#type%E2%80%90safe-error-handling Type-Safe Error Handling Docs}
|
|
71
|
+
*/
|
|
72
|
+
errors<U extends ErrorMap>(errors: U): ContractProcedureBuilderWithInput<TInputSchema, TOutputSchema, MergedErrorMap<TErrorMap, U>, TMeta>;
|
|
73
|
+
/**
|
|
74
|
+
* Sets or updates the metadata for the contract.
|
|
75
|
+
* The provided metadata is spared-merged with any existing metadata in the contract.
|
|
76
|
+
*
|
|
77
|
+
* @see {@link https://orpc.unnoq.com/docs/metadata Metadata Docs}
|
|
78
|
+
*/
|
|
79
|
+
meta(meta: TMeta): ContractProcedureBuilderWithInput<TInputSchema, TOutputSchema, TErrorMap, TMeta>;
|
|
80
|
+
/**
|
|
81
|
+
* Sets or updates the route definition for the contract.
|
|
82
|
+
* The provided route is spared-merged with any existing route in the contract.
|
|
83
|
+
* This option is typically relevant when integrating with OpenAPI.
|
|
84
|
+
*
|
|
85
|
+
* @see {@link https://orpc.unnoq.com/docs/openapi/routing OpenAPI Routing Docs}
|
|
86
|
+
* @see {@link https://orpc.unnoq.com/docs/openapi/input-output-structure OpenAPI Input/Output Structure Docs}
|
|
87
|
+
*/
|
|
88
|
+
route(route: Route): ContractProcedureBuilderWithInput<TInputSchema, TOutputSchema, TErrorMap, TMeta>;
|
|
89
|
+
/**
|
|
90
|
+
* Defines the output validation schema for the contract.
|
|
91
|
+
*
|
|
92
|
+
* @see {@link https://orpc.unnoq.com/docs/procedure#input-output-validation Output Validation Docs}
|
|
93
|
+
*/
|
|
94
|
+
output<U extends AnySchema>(schema: U): ContractProcedureBuilderWithInputOutput<TInputSchema, U, TErrorMap, TMeta>;
|
|
95
|
+
}
|
|
96
|
+
interface ContractProcedureBuilderWithOutput<TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap, TMeta extends Meta> extends ContractProcedure<TInputSchema, TOutputSchema, TErrorMap, TMeta> {
|
|
97
|
+
/**
|
|
98
|
+
* Adds type-safe custom errors to the contract.
|
|
99
|
+
* The provided errors are spared-merged with any existing errors in the contract.
|
|
100
|
+
*
|
|
101
|
+
* @see {@link https://orpc.unnoq.com/docs/error-handling#type%E2%80%90safe-error-handling Type-Safe Error Handling Docs}
|
|
102
|
+
*/
|
|
103
|
+
errors<U extends ErrorMap>(errors: U): ContractProcedureBuilderWithOutput<TInputSchema, TOutputSchema, MergedErrorMap<TErrorMap, U>, TMeta>;
|
|
104
|
+
/**
|
|
105
|
+
* Sets or updates the metadata for the contract.
|
|
106
|
+
* The provided metadata is spared-merged with any existing metadata in the contract.
|
|
107
|
+
*
|
|
108
|
+
* @see {@link https://orpc.unnoq.com/docs/metadata Metadata Docs}
|
|
109
|
+
*/
|
|
110
|
+
meta(meta: TMeta): ContractProcedureBuilderWithOutput<TInputSchema, TOutputSchema, TErrorMap, TMeta>;
|
|
111
|
+
/**
|
|
112
|
+
* Sets or updates the route definition for the contract.
|
|
113
|
+
* The provided route is spared-merged with any existing route in the contract.
|
|
114
|
+
* This option is typically relevant when integrating with OpenAPI.
|
|
115
|
+
*
|
|
116
|
+
* @see {@link https://orpc.unnoq.com/docs/openapi/routing OpenAPI Routing Docs}
|
|
117
|
+
* @see {@link https://orpc.unnoq.com/docs/openapi/input-output-structure OpenAPI Input/Output Structure Docs}
|
|
118
|
+
*/
|
|
119
|
+
route(route: Route): ContractProcedureBuilderWithOutput<TInputSchema, TOutputSchema, TErrorMap, TMeta>;
|
|
120
|
+
/**
|
|
121
|
+
* Defines the input validation schema for the contract.
|
|
122
|
+
*
|
|
123
|
+
* @see {@link https://orpc.unnoq.com/docs/procedure#input-output-validation Input Validation Docs}
|
|
124
|
+
*/
|
|
125
|
+
input<U extends AnySchema>(schema: U): ContractProcedureBuilderWithInputOutput<U, TOutputSchema, TErrorMap, TMeta>;
|
|
126
|
+
}
|
|
127
|
+
interface ContractProcedureBuilderWithInputOutput<TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap, TMeta extends Meta> extends ContractProcedure<TInputSchema, TOutputSchema, TErrorMap, TMeta> {
|
|
128
|
+
/**
|
|
129
|
+
* Adds type-safe custom errors to the contract.
|
|
130
|
+
* The provided errors are spared-merged with any existing errors in the contract.
|
|
131
|
+
*
|
|
132
|
+
* @see {@link https://orpc.unnoq.com/docs/error-handling#type%E2%80%90safe-error-handling Type-Safe Error Handling Docs}
|
|
133
|
+
*/
|
|
134
|
+
errors<U extends ErrorMap>(errors: U): ContractProcedureBuilderWithInputOutput<TInputSchema, TOutputSchema, MergedErrorMap<TErrorMap, U>, TMeta>;
|
|
135
|
+
/**
|
|
136
|
+
* Sets or updates the metadata for the contract.
|
|
137
|
+
* The provided metadata is spared-merged with any existing metadata in the contract.
|
|
138
|
+
*
|
|
139
|
+
* @see {@link https://orpc.unnoq.com/docs/metadata Metadata Docs}
|
|
140
|
+
*/
|
|
141
|
+
meta(meta: TMeta): ContractProcedureBuilderWithInputOutput<TInputSchema, TOutputSchema, TErrorMap, TMeta>;
|
|
142
|
+
/**
|
|
143
|
+
* Sets or updates the route definition for the contract.
|
|
144
|
+
* The provided route is spared-merged with any existing route in the contract.
|
|
145
|
+
* This option is typically relevant when integrating with OpenAPI.
|
|
146
|
+
*
|
|
147
|
+
* @see {@link https://orpc.unnoq.com/docs/openapi/routing OpenAPI Routing Docs}
|
|
148
|
+
* @see {@link https://orpc.unnoq.com/docs/openapi/input-output-structure OpenAPI Input/Output Structure Docs}
|
|
149
|
+
*/
|
|
150
|
+
route(route: Route): ContractProcedureBuilderWithInputOutput<TInputSchema, TOutputSchema, TErrorMap, TMeta>;
|
|
151
|
+
}
|
|
152
|
+
interface ContractRouterBuilder<TErrorMap extends ErrorMap, TMeta extends Meta> {
|
|
153
|
+
/**
|
|
154
|
+
* This property holds the defined options for the contract router.
|
|
155
|
+
*/
|
|
156
|
+
'~orpc': EnhanceContractRouterOptions<TErrorMap>;
|
|
157
|
+
/**
|
|
158
|
+
* Adds type-safe custom errors to the contract.
|
|
159
|
+
* The provided errors are spared-merged with any existing errors in the contract.
|
|
160
|
+
*
|
|
161
|
+
* @see {@link https://orpc.unnoq.com/docs/error-handling#type%E2%80%90safe-error-handling Type-Safe Error Handling Docs}
|
|
162
|
+
*/
|
|
163
|
+
'errors'<U extends ErrorMap>(errors: U): ContractRouterBuilder<MergedErrorMap<TErrorMap, U>, TMeta>;
|
|
164
|
+
/**
|
|
165
|
+
* Prefixes all procedures in the contract router.
|
|
166
|
+
* The provided prefix is post-appended to any existing router prefix.
|
|
167
|
+
*
|
|
168
|
+
* @note This option does not affect procedures that do not define a path in their route definition.
|
|
169
|
+
*
|
|
170
|
+
* @see {@link https://orpc.unnoq.com/docs/openapi/routing#route-prefixes OpenAPI Route Prefixes Docs}
|
|
171
|
+
*/
|
|
172
|
+
'prefix'(prefix: HTTPPath): ContractRouterBuilder<TErrorMap, TMeta>;
|
|
173
|
+
/**
|
|
174
|
+
* Adds tags to all procedures in the contract router.
|
|
175
|
+
* This helpful when you want to group procedures together in the OpenAPI specification.
|
|
176
|
+
*
|
|
177
|
+
* @see {@link https://orpc.unnoq.com/docs/openapi/openapi-specification#operation-metadata OpenAPI Operation Metadata Docs}
|
|
178
|
+
*/
|
|
179
|
+
'tag'(...tags: string[]): ContractRouterBuilder<TErrorMap, TMeta>;
|
|
180
|
+
/**
|
|
181
|
+
* Applies all of the previously defined options to the specified contract router.
|
|
182
|
+
*
|
|
183
|
+
* @see {@link https://orpc.unnoq.com/docs/router#extending-router Extending Router Docs}
|
|
184
|
+
*/
|
|
185
|
+
'router'<T extends ContractRouter<TMeta>>(router: T): EnhancedContractRouter<T, TErrorMap>;
|
|
186
|
+
}
|
|
187
|
+
|
|
188
|
+
interface ContractBuilderDef<TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap, TMeta extends Meta> extends ContractProcedureDef<TInputSchema, TOutputSchema, TErrorMap, TMeta>, EnhanceContractRouterOptions<TErrorMap> {
|
|
189
|
+
}
|
|
190
|
+
declare class ContractBuilder<TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap, TMeta extends Meta> extends ContractProcedure<TInputSchema, TOutputSchema, TErrorMap, TMeta> {
|
|
191
|
+
/**
|
|
192
|
+
* This property holds the defined options for the contract.
|
|
193
|
+
*/
|
|
194
|
+
'~orpc': ContractBuilderDef<TInputSchema, TOutputSchema, TErrorMap, TMeta>;
|
|
195
|
+
constructor(def: ContractBuilderDef<TInputSchema, TOutputSchema, TErrorMap, TMeta>);
|
|
196
|
+
/**
|
|
197
|
+
* Sets or overrides the initial meta.
|
|
198
|
+
*
|
|
199
|
+
* @see {@link https://orpc.unnoq.com/docs/metadata Metadata Docs}
|
|
200
|
+
*/
|
|
201
|
+
$meta<U extends Meta>(initialMeta: U): ContractBuilder<TInputSchema, TOutputSchema, TErrorMap, U & Record<never, never>>;
|
|
202
|
+
/**
|
|
203
|
+
* Sets or overrides the initial route.
|
|
204
|
+
* This option is typically relevant when integrating with OpenAPI.
|
|
205
|
+
*
|
|
206
|
+
* @see {@link https://orpc.unnoq.com/docs/openapi/routing OpenAPI Routing Docs}
|
|
207
|
+
* @see {@link https://orpc.unnoq.com/docs/openapi/input-output-structure OpenAPI Input/Output Structure Docs}
|
|
208
|
+
*/
|
|
209
|
+
$route(initialRoute: Route): ContractBuilder<TInputSchema, TOutputSchema, TErrorMap, TMeta>;
|
|
210
|
+
/**
|
|
211
|
+
* Adds type-safe custom errors to the contract.
|
|
212
|
+
* The provided errors are spared-merged with any existing errors in the contract.
|
|
213
|
+
*
|
|
214
|
+
* @see {@link https://orpc.unnoq.com/docs/error-handling#type%E2%80%90safe-error-handling Type-Safe Error Handling Docs}
|
|
215
|
+
*/
|
|
216
|
+
errors<U extends ErrorMap>(errors: U): ContractBuilder<TInputSchema, TOutputSchema, MergedErrorMap<TErrorMap, U>, TMeta>;
|
|
217
|
+
/**
|
|
218
|
+
* Sets or updates the metadata for the contract.
|
|
219
|
+
* The provided metadata is spared-merged with any existing metadata in the contract.
|
|
220
|
+
*
|
|
221
|
+
* @see {@link https://orpc.unnoq.com/docs/metadata Metadata Docs}
|
|
222
|
+
*/
|
|
223
|
+
meta(meta: TMeta): ContractProcedureBuilder<TInputSchema, TOutputSchema, TErrorMap, TMeta>;
|
|
224
|
+
/**
|
|
225
|
+
* Sets or updates the route definition for the contract.
|
|
226
|
+
* The provided route is spared-merged with any existing route in the contract.
|
|
227
|
+
* This option is typically relevant when integrating with OpenAPI.
|
|
228
|
+
*
|
|
229
|
+
* @see {@link https://orpc.unnoq.com/docs/openapi/routing OpenAPI Routing Docs}
|
|
230
|
+
* @see {@link https://orpc.unnoq.com/docs/openapi/input-output-structure OpenAPI Input/Output Structure Docs}
|
|
231
|
+
*/
|
|
232
|
+
route(route: Route): ContractProcedureBuilder<TInputSchema, TOutputSchema, TErrorMap, TMeta>;
|
|
233
|
+
/**
|
|
234
|
+
* Defines the input validation schema for the contract.
|
|
235
|
+
*
|
|
236
|
+
* @see {@link https://orpc.unnoq.com/docs/procedure#input-output-validation Input Validation Docs}
|
|
237
|
+
*/
|
|
238
|
+
input<U extends AnySchema>(schema: U): ContractProcedureBuilderWithInput<U, TOutputSchema, TErrorMap, TMeta>;
|
|
239
|
+
/**
|
|
240
|
+
* Defines the output validation schema for the contract.
|
|
241
|
+
*
|
|
242
|
+
* @see {@link https://orpc.unnoq.com/docs/procedure#input-output-validation Output Validation Docs}
|
|
243
|
+
*/
|
|
244
|
+
output<U extends AnySchema>(schema: U): ContractProcedureBuilderWithOutput<TInputSchema, U, TErrorMap, TMeta>;
|
|
245
|
+
/**
|
|
246
|
+
* Prefixes all procedures in the contract router.
|
|
247
|
+
* The provided prefix is post-appended to any existing router prefix.
|
|
248
|
+
*
|
|
249
|
+
* @note This option does not affect procedures that do not define a path in their route definition.
|
|
250
|
+
*
|
|
251
|
+
* @see {@link https://orpc.unnoq.com/docs/openapi/routing#route-prefixes OpenAPI Route Prefixes Docs}
|
|
252
|
+
*/
|
|
253
|
+
prefix(prefix: HTTPPath): ContractRouterBuilder<TErrorMap, TMeta>;
|
|
254
|
+
/**
|
|
255
|
+
* Adds tags to all procedures in the contract router.
|
|
256
|
+
* This helpful when you want to group procedures together in the OpenAPI specification.
|
|
257
|
+
*
|
|
258
|
+
* @see {@link https://orpc.unnoq.com/docs/openapi/openapi-specification#operation-metadata OpenAPI Operation Metadata Docs}
|
|
259
|
+
*/
|
|
260
|
+
tag(...tags: string[]): ContractRouterBuilder<TErrorMap, TMeta>;
|
|
261
|
+
/**
|
|
262
|
+
* Applies all of the previously defined options to the specified contract router.
|
|
263
|
+
*
|
|
264
|
+
* @see {@link https://orpc.unnoq.com/docs/router#extending-router Extending Router Docs}
|
|
265
|
+
*/
|
|
266
|
+
router<T extends ContractRouter<TMeta>>(router: T): EnhancedContractRouter<T, TErrorMap>;
|
|
267
|
+
}
|
|
268
|
+
declare const oc: ContractBuilder<Schema<unknown, unknown>, Schema<unknown, unknown>, Record<never, never>, Record<never, never>>;
|
|
269
|
+
|
|
270
|
+
interface ContractConfig {
|
|
271
|
+
defaultMethod: HTTPMethod;
|
|
272
|
+
defaultSuccessStatus: number;
|
|
273
|
+
defaultSuccessDescription: string;
|
|
274
|
+
defaultInputStructure: InputStructure;
|
|
275
|
+
defaultOutputStructure: OutputStructure;
|
|
276
|
+
}
|
|
277
|
+
declare function fallbackContractConfig<T extends keyof ContractConfig>(key: T, value: ContractConfig[T] | undefined): ContractConfig[T];
|
|
278
|
+
|
|
279
|
+
interface EventIteratorSchemaDetails {
|
|
280
|
+
yields: AnySchema;
|
|
281
|
+
returns?: AnySchema;
|
|
282
|
+
}
|
|
283
|
+
/**
|
|
284
|
+
* Define schema for an event iterator.
|
|
285
|
+
*
|
|
286
|
+
* @see {@link https://orpc.unnoq.com/docs/event-iterator#validate-event-iterator Validate Event Iterator Docs}
|
|
287
|
+
*/
|
|
288
|
+
declare function eventIterator<TYieldIn, TYieldOut, TReturnIn = unknown, TReturnOut = unknown>(yields: Schema<TYieldIn, TYieldOut>, returns?: Schema<TReturnIn, TReturnOut>): Schema<AsyncIteratorObject<TYieldIn, TReturnIn, void>, AsyncIteratorClass<TYieldOut, TReturnOut, void>>;
|
|
289
|
+
declare function getEventIteratorSchemaDetails(schema: AnySchema | undefined): undefined | EventIteratorSchemaDetails;
|
|
290
|
+
|
|
291
|
+
/**
|
|
292
|
+
* Help RPCLink automatically send requests using the specified HTTP method in the contract.
|
|
293
|
+
*
|
|
294
|
+
* @see {@link https://orpc.unnoq.com/docs/client/rpc-link#custom-request-method RPCLink Custom Request Method}
|
|
295
|
+
*/
|
|
296
|
+
declare function inferRPCMethodFromContractRouter(contract: AnyContractRouter): (options: unknown, path: readonly string[]) => Exclude<HTTPMethod, 'HEAD'>;
|
|
297
|
+
|
|
298
|
+
type ContractProcedureClient<TClientContext extends ClientContext, TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap> = Client<TClientContext, InferSchemaInput<TInputSchema>, InferSchemaOutput<TOutputSchema>, ErrorFromErrorMap<TErrorMap>>;
|
|
299
|
+
|
|
300
|
+
type ContractRouterClient<TRouter extends AnyContractRouter, TClientContext extends ClientContext = Record<never, never>> = TRouter extends ContractProcedure<infer UInputSchema, infer UOutputSchema, infer UErrorMap, any> ? ContractProcedureClient<TClientContext, UInputSchema, UOutputSchema, UErrorMap> : {
|
|
301
|
+
[K in keyof TRouter]: TRouter[K] extends AnyContractRouter ? ContractRouterClient<TRouter[K], TClientContext> : never;
|
|
302
|
+
};
|
|
303
|
+
|
|
304
|
+
declare function isSchemaIssue(issue: unknown): issue is SchemaIssue;
|
|
305
|
+
|
|
306
|
+
export { AnyContractRouter, AnySchema, ContractBuilder, ContractProcedure, ContractProcedureDef, ContractRouter, EnhanceRouteOptions, ErrorFromErrorMap, ErrorMap, InferSchemaInput, InferSchemaOutput, InputStructure, MergedErrorMap, Meta, OutputStructure, Route, Schema, SchemaIssue, enhanceContractRouter, eventIterator, fallbackContractConfig, getContractRouter, getEventIteratorSchemaDetails, inferRPCMethodFromContractRouter, isSchemaIssue, minifyContractRouter, oc };
|
|
307
|
+
export type { ContractBuilderDef, ContractConfig, ContractProcedureBuilder, ContractProcedureBuilderWithInput, ContractProcedureBuilderWithInputOutput, ContractProcedureBuilderWithOutput, ContractProcedureClient, ContractRouterBuilder, ContractRouterClient, EnhanceContractRouterOptions, EnhancedContractRouter, EventIteratorSchemaDetails };
|