@orpc/server 0.0.0-next.93e6063 → 0.0.0-next.93fa264

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.
Files changed (64) hide show
  1. package/README.md +28 -20
  2. package/dist/adapters/aws-lambda/index.d.mts +45 -0
  3. package/dist/adapters/aws-lambda/index.d.ts +45 -0
  4. package/dist/adapters/aws-lambda/index.mjs +41 -0
  5. package/dist/adapters/bun-ws/index.d.mts +35 -0
  6. package/dist/adapters/bun-ws/index.d.ts +35 -0
  7. package/dist/adapters/bun-ws/index.mjs +46 -0
  8. package/dist/adapters/crossws/index.d.mts +30 -0
  9. package/dist/adapters/crossws/index.d.ts +30 -0
  10. package/dist/adapters/crossws/index.mjs +46 -0
  11. package/dist/adapters/fetch/index.d.mts +62 -11
  12. package/dist/adapters/fetch/index.d.ts +62 -11
  13. package/dist/adapters/fetch/index.mjs +108 -7
  14. package/dist/adapters/message-port/index.d.mts +28 -0
  15. package/dist/adapters/message-port/index.d.ts +28 -0
  16. package/dist/adapters/message-port/index.mjs +41 -0
  17. package/dist/adapters/node/index.d.mts +64 -22
  18. package/dist/adapters/node/index.d.ts +64 -22
  19. package/dist/adapters/node/index.mjs +86 -21
  20. package/dist/adapters/standard/index.d.mts +12 -15
  21. package/dist/adapters/standard/index.d.ts +12 -15
  22. package/dist/adapters/standard/index.mjs +4 -4
  23. package/dist/adapters/websocket/index.d.mts +51 -0
  24. package/dist/adapters/websocket/index.d.ts +51 -0
  25. package/dist/adapters/websocket/index.mjs +69 -0
  26. package/dist/adapters/ws/index.d.mts +28 -0
  27. package/dist/adapters/ws/index.d.ts +28 -0
  28. package/dist/adapters/ws/index.mjs +39 -0
  29. package/dist/hibernation/index.d.mts +44 -0
  30. package/dist/hibernation/index.d.ts +44 -0
  31. package/dist/hibernation/index.mjs +65 -0
  32. package/dist/index.d.mts +711 -132
  33. package/dist/index.d.ts +711 -132
  34. package/dist/index.mjs +207 -52
  35. package/dist/plugins/index.d.mts +144 -19
  36. package/dist/plugins/index.d.ts +144 -19
  37. package/dist/plugins/index.mjs +165 -15
  38. package/dist/shared/server.-ACo36I0.d.ts +74 -0
  39. package/dist/shared/server.BPAWobQg.d.ts +12 -0
  40. package/dist/shared/server.BW-nUGgA.mjs +36 -0
  41. package/dist/shared/server.Bd52nNaH.d.mts +12 -0
  42. package/dist/shared/server.BliFSTnG.d.mts +10 -0
  43. package/dist/shared/{server.BBGuTxHE.mjs → server.CHvOkcM3.mjs} +69 -46
  44. package/dist/shared/server.DD2C4ujN.d.mts +192 -0
  45. package/dist/shared/server.DD2C4ujN.d.ts +192 -0
  46. package/dist/shared/{server.V6zT5iYQ.mjs → server.DG7Tamti.mjs} +161 -173
  47. package/dist/shared/server.DZ5BIITo.mjs +9 -0
  48. package/dist/shared/server.Dq8xr7PQ.d.mts +74 -0
  49. package/dist/shared/server.IG2MjhrD.d.ts +10 -0
  50. package/package.json +59 -20
  51. package/dist/adapters/hono/index.d.mts +0 -20
  52. package/dist/adapters/hono/index.d.ts +0 -20
  53. package/dist/adapters/hono/index.mjs +0 -32
  54. package/dist/adapters/next/index.d.mts +0 -27
  55. package/dist/adapters/next/index.d.ts +0 -27
  56. package/dist/adapters/next/index.mjs +0 -29
  57. package/dist/shared/server.B-ewprcf.d.ts +0 -77
  58. package/dist/shared/server.CA-o8cUY.d.mts +0 -9
  59. package/dist/shared/server.Cn9ybJtE.d.mts +0 -152
  60. package/dist/shared/server.Cn9ybJtE.d.ts +0 -152
  61. package/dist/shared/server.DJrh0Ceu.d.mts +0 -77
  62. package/dist/shared/server.DPQt9YYq.d.ts +0 -9
  63. package/dist/shared/server.KwueCzFr.mjs +0 -26
  64. package/dist/shared/server.Q6ZmnTgO.mjs +0 -12
@@ -1,52 +1,69 @@
1
+ import { toHttpPath, StandardRPCJsonSerializer, StandardRPCSerializer } from '@orpc/client/standard';
1
2
  import { ORPCError, toORPCError } from '@orpc/client';
2
- import { intercept, trim, parseEmptyableJSON } from '@orpc/shared';
3
- import { C as CompositePlugin } from './server.Q6ZmnTgO.mjs';
4
- import { c as createProcedureClient, e as eachContractProcedure, a as convertPathToHttpPath, i as isProcedure, u as unlazy, g as getRouterChild, b as createContractedProcedure } from './server.V6zT5iYQ.mjs';
5
- import { RPCSerializer } from '@orpc/client/standard';
3
+ import { toArray, intercept, parseEmptyableJSON, NullProtoObj } from '@orpc/shared';
4
+ import { flattenHeader } from '@orpc/standard-server';
5
+ import { c as createProcedureClient, t as traverseContractProcedures, i as isProcedure, u as unlazy, g as getRouter, a as createContractedProcedure } from './server.DG7Tamti.mjs';
6
+
7
+ class CompositeStandardHandlerPlugin {
8
+ plugins;
9
+ constructor(plugins = []) {
10
+ this.plugins = [...plugins].sort((a, b) => (a.order ?? 0) - (b.order ?? 0));
11
+ }
12
+ init(options, router) {
13
+ for (const plugin of this.plugins) {
14
+ plugin.init?.(options, router);
15
+ }
16
+ }
17
+ }
6
18
 
7
19
  class StandardHandler {
8
- constructor(router, matcher, codec, options = {}) {
20
+ constructor(router, matcher, codec, options) {
9
21
  this.matcher = matcher;
10
22
  this.codec = codec;
11
- this.options = options;
12
- this.plugin = new CompositePlugin(options.plugins);
13
- this.plugin.init(this.options);
23
+ const plugins = new CompositeStandardHandlerPlugin(options.plugins);
24
+ plugins.init(options, router);
25
+ this.interceptors = toArray(options.interceptors);
26
+ this.clientInterceptors = toArray(options.clientInterceptors);
27
+ this.rootInterceptors = toArray(options.rootInterceptors);
14
28
  this.matcher.init(router);
15
29
  }
16
- plugin;
17
- handle(request, ...[options]) {
30
+ interceptors;
31
+ clientInterceptors;
32
+ rootInterceptors;
33
+ async handle(request, options) {
34
+ const prefix = options.prefix?.replace(/\/$/, "") || void 0;
35
+ if (prefix && !request.url.pathname.startsWith(`${prefix}/`) && request.url.pathname !== prefix) {
36
+ return { matched: false, response: void 0 };
37
+ }
18
38
  return intercept(
19
- this.options.rootInterceptors ?? [],
20
- {
21
- request,
22
- ...options,
23
- context: options?.context ?? {}
24
- // context is optional only when all fields are optional so we can safely force it to have a context
25
- },
39
+ this.rootInterceptors,
40
+ { ...options, request, prefix },
26
41
  async (interceptorOptions) => {
27
42
  let isDecoding = false;
28
43
  try {
29
44
  return await intercept(
30
- this.options.interceptors ?? [],
45
+ this.interceptors,
31
46
  interceptorOptions,
32
- async (interceptorOptions2) => {
33
- const method = interceptorOptions2.request.method;
34
- const url = interceptorOptions2.request.url;
35
- const pathname = `/${trim(url.pathname.replace(interceptorOptions2.prefix ?? "", ""), "/")}`;
36
- const match = await this.matcher.match(method, pathname);
47
+ async ({ request: request2, context, prefix: prefix2 }) => {
48
+ const method = request2.method;
49
+ const url = request2.url;
50
+ const pathname = prefix2 ? url.pathname.replace(prefix2, "") : url.pathname;
51
+ const match = await this.matcher.match(method, `/${pathname.replace(/^\/|\/$/g, "")}`);
37
52
  if (!match) {
38
53
  return { matched: false, response: void 0 };
39
54
  }
40
55
  const client = createProcedureClient(match.procedure, {
41
- context: interceptorOptions2.context,
56
+ context,
42
57
  path: match.path,
43
- interceptors: this.options.clientInterceptors
58
+ interceptors: this.clientInterceptors
44
59
  });
45
60
  isDecoding = true;
46
- const input = await this.codec.decode(request, match.params, match.procedure);
61
+ const input = await this.codec.decode(request2, match.params, match.procedure);
47
62
  isDecoding = false;
48
- const lastEventId = Array.isArray(request.headers["last-event-id"]) ? request.headers["last-event-id"].at(-1) : request.headers["last-event-id"];
49
- const output = await client(input, { signal: request.signal, lastEventId });
63
+ const output = await client(input, {
64
+ signal: request2.signal,
65
+ lastEventId: flattenHeader(request2.headers["last-event-id"])
66
+ });
50
67
  const response = this.codec.encode(output, match.procedure);
51
68
  return {
52
69
  matched: true,
@@ -55,7 +72,7 @@ class StandardHandler {
55
72
  }
56
73
  );
57
74
  } catch (e) {
58
- const error = isDecoding ? new ORPCError("BAD_REQUEST", {
75
+ const error = isDecoding && !(e instanceof ORPCError) ? new ORPCError("BAD_REQUEST", {
59
76
  message: `Malformed request. Ensure the request body is properly formatted and the 'Content-Type' header is set correctly.`,
60
77
  cause: e
61
78
  }) : toORPCError(e);
@@ -70,10 +87,9 @@ class StandardHandler {
70
87
  }
71
88
  }
72
89
 
73
- class RPCCodec {
74
- serializer;
75
- constructor(options = {}) {
76
- this.serializer = options.serializer ?? new RPCSerializer();
90
+ class StandardRPCCodec {
91
+ constructor(serializer) {
92
+ this.serializer = serializer;
77
93
  }
78
94
  async decode(request, _params, _procedure) {
79
95
  const serialized = request.method === "GET" ? parseEmptyableJSON(request.url.searchParams.getAll("data").at(-1)) : await request.body();
@@ -95,15 +111,12 @@ class RPCCodec {
95
111
  }
96
112
  }
97
113
 
98
- class RPCMatcher {
99
- tree = {};
114
+ class StandardRPCMatcher {
115
+ tree = new NullProtoObj();
100
116
  pendingRouters = [];
101
117
  init(router, path = []) {
102
- const laziedOptions = eachContractProcedure({
103
- router,
104
- path
105
- }, ({ path: path2, contract }) => {
106
- const httpPath = convertPathToHttpPath(path2);
118
+ const laziedOptions = traverseContractProcedures({ router, path }, ({ path: path2, contract }) => {
119
+ const httpPath = toHttpPath(path2);
107
120
  if (isProcedure(contract)) {
108
121
  this.tree[httpPath] = {
109
122
  path: path2,
@@ -123,7 +136,7 @@ class RPCMatcher {
123
136
  });
124
137
  this.pendingRouters.push(...laziedOptions.map((option) => ({
125
138
  ...option,
126
- httpPathPrefix: convertPathToHttpPath(option.path)
139
+ httpPathPrefix: toHttpPath(option.path)
127
140
  })));
128
141
  }
129
142
  async match(_method, pathname) {
@@ -131,7 +144,7 @@ class RPCMatcher {
131
144
  const newPendingRouters = [];
132
145
  for (const pendingRouter of this.pendingRouters) {
133
146
  if (pathname.startsWith(pendingRouter.httpPathPrefix)) {
134
- const { default: router } = await unlazy(pendingRouter.lazied);
147
+ const { default: router } = await unlazy(pendingRouter.router);
135
148
  this.init(router, pendingRouter.path);
136
149
  } else {
137
150
  newPendingRouters.push(pendingRouter);
@@ -144,14 +157,14 @@ class RPCMatcher {
144
157
  return void 0;
145
158
  }
146
159
  if (!match.procedure) {
147
- const { default: maybeProcedure } = await unlazy(getRouterChild(match.router, ...match.path));
160
+ const { default: maybeProcedure } = await unlazy(getRouter(match.router, match.path));
148
161
  if (!isProcedure(maybeProcedure)) {
149
162
  throw new Error(`
150
- [Contract-First] Missing or invalid implementation for procedure at path: ${convertPathToHttpPath(match.path)}.
163
+ [Contract-First] Missing or invalid implementation for procedure at path: ${toHttpPath(match.path)}.
151
164
  Ensure that the procedure is correctly defined and matches the expected contract.
152
165
  `);
153
166
  }
154
- match.procedure = createContractedProcedure(match.contract, maybeProcedure);
167
+ match.procedure = createContractedProcedure(maybeProcedure, match.contract);
155
168
  }
156
169
  return {
157
170
  path: match.path,
@@ -160,4 +173,14 @@ class RPCMatcher {
160
173
  }
161
174
  }
162
175
 
163
- export { RPCCodec as R, StandardHandler as S, RPCMatcher as a };
176
+ class StandardRPCHandler extends StandardHandler {
177
+ constructor(router, options = {}) {
178
+ const jsonSerializer = new StandardRPCJsonSerializer(options);
179
+ const serializer = new StandardRPCSerializer(jsonSerializer);
180
+ const matcher = new StandardRPCMatcher();
181
+ const codec = new StandardRPCCodec(serializer);
182
+ super(router, matcher, codec, options);
183
+ }
184
+ }
185
+
186
+ export { CompositeStandardHandlerPlugin as C, StandardHandler as S, StandardRPCCodec as a, StandardRPCHandler as b, StandardRPCMatcher as c };
@@ -0,0 +1,192 @@
1
+ import { ORPCErrorCode, ORPCErrorOptions, ORPCError, HTTPPath, ClientContext, Client } from '@orpc/client';
2
+ import { ErrorMap, ErrorMapItem, InferSchemaInput, AnySchema, Meta, ContractProcedureDef, InferSchemaOutput, ErrorFromErrorMap, AnyContractRouter, ContractProcedure } from '@orpc/contract';
3
+ import { MaybeOptionalOptions, Promisable, Interceptor, PromiseWithError, Value } from '@orpc/shared';
4
+
5
+ type Context = Record<PropertyKey, any>;
6
+ type MergedInitialContext<TInitial extends Context, TAdditional extends Context, TCurrent extends Context> = TInitial & Omit<TAdditional, keyof TCurrent>;
7
+ type MergedCurrentContext<T extends Context, U extends Context> = Omit<T, keyof U> & U;
8
+ declare function mergeCurrentContext<T extends Context, U extends Context>(context: T, other: U): MergedCurrentContext<T, U>;
9
+
10
+ type ORPCErrorConstructorMapItemOptions<TData> = Omit<ORPCErrorOptions<TData>, 'defined' | 'status'>;
11
+ type ORPCErrorConstructorMapItem<TCode extends ORPCErrorCode, TInData> = (...rest: MaybeOptionalOptions<ORPCErrorConstructorMapItemOptions<TInData>>) => ORPCError<TCode, TInData>;
12
+ type ORPCErrorConstructorMap<T extends ErrorMap> = {
13
+ [K in keyof T]: K extends ORPCErrorCode ? T[K] extends ErrorMapItem<infer UInputSchema> ? ORPCErrorConstructorMapItem<K, InferSchemaInput<UInputSchema>> : never : never;
14
+ };
15
+ declare function createORPCErrorConstructorMap<T extends ErrorMap>(errors: T): ORPCErrorConstructorMap<T>;
16
+ declare function validateORPCError(map: ErrorMap, error: ORPCError<any, any>): Promise<ORPCError<string, unknown>>;
17
+
18
+ declare const LAZY_SYMBOL: unique symbol;
19
+ interface LazyMeta {
20
+ prefix?: HTTPPath;
21
+ }
22
+ interface Lazy<T> {
23
+ [LAZY_SYMBOL]: {
24
+ loader: () => Promise<{
25
+ default: T;
26
+ }>;
27
+ meta: LazyMeta;
28
+ };
29
+ }
30
+ type Lazyable<T> = T | Lazy<T>;
31
+ /**
32
+ * Create a lazy thing.
33
+ */
34
+ declare function lazy<T>(loader: () => Promise<{
35
+ default: T;
36
+ }>, meta?: LazyMeta): Lazy<T>;
37
+ declare function isLazy(item: unknown): item is Lazy<any>;
38
+ declare function getLazyMeta(lazied: Lazy<any>): LazyMeta;
39
+ declare function unlazy<T extends Lazyable<any>>(lazied: T): Promise<{
40
+ default: T extends Lazy<infer U> ? U : T;
41
+ }>;
42
+
43
+ interface ProcedureHandlerOptions<TCurrentContext extends Context, TInput, TErrorConstructorMap extends ORPCErrorConstructorMap<any>, TMeta extends Meta> {
44
+ context: TCurrentContext;
45
+ input: TInput;
46
+ path: readonly string[];
47
+ procedure: Procedure<Context, Context, AnySchema, AnySchema, ErrorMap, TMeta>;
48
+ signal?: AbortSignal;
49
+ lastEventId: string | undefined;
50
+ errors: TErrorConstructorMap;
51
+ }
52
+ interface ProcedureHandler<TCurrentContext extends Context, TInput, THandlerOutput, TErrorMap extends ErrorMap, TMeta extends Meta> {
53
+ (opt: ProcedureHandlerOptions<TCurrentContext, TInput, ORPCErrorConstructorMap<TErrorMap>, TMeta>): Promisable<THandlerOutput>;
54
+ }
55
+ interface ProcedureDef<TInitialContext extends Context, TCurrentContext extends Context, TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap, TMeta extends Meta> extends ContractProcedureDef<TInputSchema, TOutputSchema, TErrorMap, TMeta> {
56
+ __initialContext?: (type: TInitialContext) => unknown;
57
+ middlewares: readonly AnyMiddleware[];
58
+ inputValidationIndex: number;
59
+ outputValidationIndex: number;
60
+ handler: ProcedureHandler<TCurrentContext, any, any, any, any>;
61
+ }
62
+ /**
63
+ * This class represents a procedure.
64
+ *
65
+ * @see {@link https://orpc.unnoq.com/docs/procedure Procedure Docs}
66
+ */
67
+ declare class Procedure<TInitialContext extends Context, TCurrentContext extends Context, TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap, TMeta extends Meta> {
68
+ /**
69
+ * This property holds the defined options.
70
+ */
71
+ '~orpc': ProcedureDef<TInitialContext, TCurrentContext, TInputSchema, TOutputSchema, TErrorMap, TMeta>;
72
+ constructor(def: ProcedureDef<TInitialContext, TCurrentContext, TInputSchema, TOutputSchema, TErrorMap, TMeta>);
73
+ }
74
+ type AnyProcedure = Procedure<any, any, any, any, any, any>;
75
+ declare function isProcedure(item: unknown): item is AnyProcedure;
76
+
77
+ type MiddlewareResult<TOutContext extends Context, TOutput> = Promisable<{
78
+ output: TOutput;
79
+ context: TOutContext;
80
+ }>;
81
+ type MiddlewareNextFnOptions<TOutContext extends Context> = Record<never, never> extends TOutContext ? {
82
+ context?: TOutContext;
83
+ } : {
84
+ context: TOutContext;
85
+ };
86
+ interface MiddlewareNextFn<TOutput> {
87
+ <U extends Context = Record<never, never>>(...rest: MaybeOptionalOptions<MiddlewareNextFnOptions<U>>): MiddlewareResult<U, TOutput>;
88
+ }
89
+ interface MiddlewareOutputFn<TOutput> {
90
+ (output: TOutput): MiddlewareResult<Record<never, never>, TOutput>;
91
+ }
92
+ interface MiddlewareOptions<TInContext extends Context, TOutput, TErrorConstructorMap extends ORPCErrorConstructorMap<any>, TMeta extends Meta> {
93
+ context: TInContext;
94
+ path: readonly string[];
95
+ procedure: Procedure<Context, Context, AnySchema, AnySchema, ErrorMap, TMeta>;
96
+ signal?: AbortSignal;
97
+ lastEventId: string | undefined;
98
+ next: MiddlewareNextFn<TOutput>;
99
+ errors: TErrorConstructorMap;
100
+ }
101
+ /**
102
+ * A function that represents a middleware.
103
+ *
104
+ * @see {@link https://orpc.unnoq.com/docs/middleware Middleware Docs}
105
+ */
106
+ interface Middleware<TInContext extends Context, TOutContext extends Context, TInput, TOutput, TErrorConstructorMap extends ORPCErrorConstructorMap<any>, TMeta extends Meta> {
107
+ (options: MiddlewareOptions<TInContext, TOutput, TErrorConstructorMap, TMeta>, input: TInput, output: MiddlewareOutputFn<TOutput>): Promisable<MiddlewareResult<TOutContext, TOutput>>;
108
+ }
109
+ type AnyMiddleware = Middleware<any, any, any, any, any, any>;
110
+ interface MapInputMiddleware<TInput, TMappedInput> {
111
+ (input: TInput): TMappedInput;
112
+ }
113
+ declare function middlewareOutputFn<TOutput>(output: TOutput): MiddlewareResult<Record<never, never>, TOutput>;
114
+
115
+ type ProcedureClient<TClientContext extends ClientContext, TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap> = Client<TClientContext, InferSchemaInput<TInputSchema>, InferSchemaOutput<TOutputSchema>, ErrorFromErrorMap<TErrorMap>>;
116
+ interface ProcedureClientInterceptorOptions<TInitialContext extends Context, TErrorMap extends ErrorMap, TMeta extends Meta> {
117
+ context: TInitialContext;
118
+ input: unknown;
119
+ errors: ORPCErrorConstructorMap<TErrorMap>;
120
+ path: readonly string[];
121
+ procedure: Procedure<Context, Context, AnySchema, AnySchema, ErrorMap, TMeta>;
122
+ signal?: AbortSignal;
123
+ lastEventId: string | undefined;
124
+ }
125
+ type CreateProcedureClientOptions<TInitialContext extends Context, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap, TMeta extends Meta, TClientContext extends ClientContext> = {
126
+ /**
127
+ * This is helpful for logging and analytics.
128
+ */
129
+ path?: readonly string[];
130
+ interceptors?: Interceptor<ProcedureClientInterceptorOptions<TInitialContext, TErrorMap, TMeta>, PromiseWithError<InferSchemaOutput<TOutputSchema>, ErrorFromErrorMap<TErrorMap>>>[];
131
+ } & (Record<never, never> extends TInitialContext ? {
132
+ context?: Value<Promisable<TInitialContext>, [clientContext: TClientContext]>;
133
+ } : {
134
+ context: Value<Promisable<TInitialContext>, [clientContext: TClientContext]>;
135
+ });
136
+ /**
137
+ * Create Server-side client from a procedure.
138
+ *
139
+ * @see {@link https://orpc.unnoq.com/docs/client/server-side Server-side Client Docs}
140
+ */
141
+ declare function createProcedureClient<TInitialContext extends Context, TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap, TMeta extends Meta, TClientContext extends ClientContext>(lazyableProcedure: Lazyable<Procedure<TInitialContext, any, TInputSchema, TOutputSchema, TErrorMap, TMeta>>, ...[options]: MaybeOptionalOptions<CreateProcedureClientOptions<TInitialContext, TOutputSchema, TErrorMap, TMeta, TClientContext>>): ProcedureClient<TClientContext, TInputSchema, TOutputSchema, TErrorMap>;
142
+
143
+ /**
144
+ * Represents a router, which defines a hierarchical structure of procedures.
145
+ *
146
+ * @info A procedure is a router too.
147
+ * @see {@link https://orpc.unnoq.com/docs/contract-first/define-contract#contract-router Contract Router Docs}
148
+ */
149
+ type Router<T extends AnyContractRouter, TInitialContext extends Context> = T extends ContractProcedure<infer UInputSchema, infer UOutputSchema, infer UErrorMap, infer UMeta> ? Procedure<TInitialContext, any, UInputSchema, UOutputSchema, UErrorMap, UMeta> : {
150
+ [K in keyof T]: T[K] extends AnyContractRouter ? Lazyable<Router<T[K], TInitialContext>> : never;
151
+ };
152
+ type AnyRouter = Router<any, any>;
153
+ type InferRouterInitialContext<T extends AnyRouter> = T extends Router<any, infer UInitialContext> ? UInitialContext : never;
154
+ /**
155
+ * Infer all initial context of the router.
156
+ *
157
+ * @info A procedure is a router too.
158
+ * @see {@link https://orpc.unnoq.com/docs/router#utilities Router Utilities Docs}
159
+ */
160
+ type InferRouterInitialContexts<T extends AnyRouter> = T extends Procedure<infer UInitialContext, any, any, any, any, any> ? UInitialContext : {
161
+ [K in keyof T]: T[K] extends Lazyable<infer U extends AnyRouter> ? InferRouterInitialContexts<U> : never;
162
+ };
163
+ /**
164
+ * Infer all current context of the router.
165
+ *
166
+ * @info A procedure is a router too.
167
+ * @see {@link https://orpc.unnoq.com/docs/router#utilities Router Utilities Docs}
168
+ */
169
+ type InferRouterCurrentContexts<T extends AnyRouter> = T extends Procedure<any, infer UCurrentContext, any, any, any, any> ? UCurrentContext : {
170
+ [K in keyof T]: T[K] extends Lazyable<infer U extends AnyRouter> ? InferRouterCurrentContexts<U> : never;
171
+ };
172
+ /**
173
+ * Infer all router inputs
174
+ *
175
+ * @info A procedure is a router too.
176
+ * @see {@link https://orpc.unnoq.com/docs/router#utilities Router Utilities Docs}
177
+ */
178
+ type InferRouterInputs<T extends AnyRouter> = T extends Procedure<any, any, infer UInputSchema, any, any, any> ? InferSchemaInput<UInputSchema> : {
179
+ [K in keyof T]: T[K] extends Lazyable<infer U extends AnyRouter> ? InferRouterInputs<U> : never;
180
+ };
181
+ /**
182
+ * Infer all router outputs
183
+ *
184
+ * @info A procedure is a router too.
185
+ * @see {@link https://orpc.unnoq.com/docs/router#utilities Router Utilities Docs}
186
+ */
187
+ type InferRouterOutputs<T extends AnyRouter> = T extends Procedure<any, any, any, infer UOutputSchema, any, any> ? InferSchemaOutput<UOutputSchema> : {
188
+ [K in keyof T]: T[K] extends Lazyable<infer U extends AnyRouter> ? InferRouterOutputs<U> : never;
189
+ };
190
+
191
+ export { isProcedure as E, createProcedureClient as G, Procedure as P, createORPCErrorConstructorMap as l, mergeCurrentContext as m, LAZY_SYMBOL as n, lazy as p, isLazy as q, getLazyMeta as r, unlazy as u, validateORPCError as v, middlewareOutputFn as z };
192
+ export type { AnyMiddleware as A, ProcedureHandlerOptions as B, Context as C, ProcedureDef as D, ProcedureClientInterceptorOptions as F, InferRouterInitialContexts as H, InferRouterInitialContext as I, InferRouterCurrentContexts as J, InferRouterInputs as K, Lazyable as L, Middleware as M, InferRouterOutputs as N, ORPCErrorConstructorMap as O, Router as R, MergedInitialContext as a, MergedCurrentContext as b, MapInputMiddleware as c, CreateProcedureClientOptions as d, ProcedureClient as e, AnyRouter as f, Lazy as g, AnyProcedure as h, ProcedureHandler as i, ORPCErrorConstructorMapItemOptions as j, ORPCErrorConstructorMapItem as k, LazyMeta as o, MiddlewareResult as s, MiddlewareNextFnOptions as t, MiddlewareNextFn as w, MiddlewareOutputFn as x, MiddlewareOptions as y };
@@ -0,0 +1,192 @@
1
+ import { ORPCErrorCode, ORPCErrorOptions, ORPCError, HTTPPath, ClientContext, Client } from '@orpc/client';
2
+ import { ErrorMap, ErrorMapItem, InferSchemaInput, AnySchema, Meta, ContractProcedureDef, InferSchemaOutput, ErrorFromErrorMap, AnyContractRouter, ContractProcedure } from '@orpc/contract';
3
+ import { MaybeOptionalOptions, Promisable, Interceptor, PromiseWithError, Value } from '@orpc/shared';
4
+
5
+ type Context = Record<PropertyKey, any>;
6
+ type MergedInitialContext<TInitial extends Context, TAdditional extends Context, TCurrent extends Context> = TInitial & Omit<TAdditional, keyof TCurrent>;
7
+ type MergedCurrentContext<T extends Context, U extends Context> = Omit<T, keyof U> & U;
8
+ declare function mergeCurrentContext<T extends Context, U extends Context>(context: T, other: U): MergedCurrentContext<T, U>;
9
+
10
+ type ORPCErrorConstructorMapItemOptions<TData> = Omit<ORPCErrorOptions<TData>, 'defined' | 'status'>;
11
+ type ORPCErrorConstructorMapItem<TCode extends ORPCErrorCode, TInData> = (...rest: MaybeOptionalOptions<ORPCErrorConstructorMapItemOptions<TInData>>) => ORPCError<TCode, TInData>;
12
+ type ORPCErrorConstructorMap<T extends ErrorMap> = {
13
+ [K in keyof T]: K extends ORPCErrorCode ? T[K] extends ErrorMapItem<infer UInputSchema> ? ORPCErrorConstructorMapItem<K, InferSchemaInput<UInputSchema>> : never : never;
14
+ };
15
+ declare function createORPCErrorConstructorMap<T extends ErrorMap>(errors: T): ORPCErrorConstructorMap<T>;
16
+ declare function validateORPCError(map: ErrorMap, error: ORPCError<any, any>): Promise<ORPCError<string, unknown>>;
17
+
18
+ declare const LAZY_SYMBOL: unique symbol;
19
+ interface LazyMeta {
20
+ prefix?: HTTPPath;
21
+ }
22
+ interface Lazy<T> {
23
+ [LAZY_SYMBOL]: {
24
+ loader: () => Promise<{
25
+ default: T;
26
+ }>;
27
+ meta: LazyMeta;
28
+ };
29
+ }
30
+ type Lazyable<T> = T | Lazy<T>;
31
+ /**
32
+ * Create a lazy thing.
33
+ */
34
+ declare function lazy<T>(loader: () => Promise<{
35
+ default: T;
36
+ }>, meta?: LazyMeta): Lazy<T>;
37
+ declare function isLazy(item: unknown): item is Lazy<any>;
38
+ declare function getLazyMeta(lazied: Lazy<any>): LazyMeta;
39
+ declare function unlazy<T extends Lazyable<any>>(lazied: T): Promise<{
40
+ default: T extends Lazy<infer U> ? U : T;
41
+ }>;
42
+
43
+ interface ProcedureHandlerOptions<TCurrentContext extends Context, TInput, TErrorConstructorMap extends ORPCErrorConstructorMap<any>, TMeta extends Meta> {
44
+ context: TCurrentContext;
45
+ input: TInput;
46
+ path: readonly string[];
47
+ procedure: Procedure<Context, Context, AnySchema, AnySchema, ErrorMap, TMeta>;
48
+ signal?: AbortSignal;
49
+ lastEventId: string | undefined;
50
+ errors: TErrorConstructorMap;
51
+ }
52
+ interface ProcedureHandler<TCurrentContext extends Context, TInput, THandlerOutput, TErrorMap extends ErrorMap, TMeta extends Meta> {
53
+ (opt: ProcedureHandlerOptions<TCurrentContext, TInput, ORPCErrorConstructorMap<TErrorMap>, TMeta>): Promisable<THandlerOutput>;
54
+ }
55
+ interface ProcedureDef<TInitialContext extends Context, TCurrentContext extends Context, TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap, TMeta extends Meta> extends ContractProcedureDef<TInputSchema, TOutputSchema, TErrorMap, TMeta> {
56
+ __initialContext?: (type: TInitialContext) => unknown;
57
+ middlewares: readonly AnyMiddleware[];
58
+ inputValidationIndex: number;
59
+ outputValidationIndex: number;
60
+ handler: ProcedureHandler<TCurrentContext, any, any, any, any>;
61
+ }
62
+ /**
63
+ * This class represents a procedure.
64
+ *
65
+ * @see {@link https://orpc.unnoq.com/docs/procedure Procedure Docs}
66
+ */
67
+ declare class Procedure<TInitialContext extends Context, TCurrentContext extends Context, TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap, TMeta extends Meta> {
68
+ /**
69
+ * This property holds the defined options.
70
+ */
71
+ '~orpc': ProcedureDef<TInitialContext, TCurrentContext, TInputSchema, TOutputSchema, TErrorMap, TMeta>;
72
+ constructor(def: ProcedureDef<TInitialContext, TCurrentContext, TInputSchema, TOutputSchema, TErrorMap, TMeta>);
73
+ }
74
+ type AnyProcedure = Procedure<any, any, any, any, any, any>;
75
+ declare function isProcedure(item: unknown): item is AnyProcedure;
76
+
77
+ type MiddlewareResult<TOutContext extends Context, TOutput> = Promisable<{
78
+ output: TOutput;
79
+ context: TOutContext;
80
+ }>;
81
+ type MiddlewareNextFnOptions<TOutContext extends Context> = Record<never, never> extends TOutContext ? {
82
+ context?: TOutContext;
83
+ } : {
84
+ context: TOutContext;
85
+ };
86
+ interface MiddlewareNextFn<TOutput> {
87
+ <U extends Context = Record<never, never>>(...rest: MaybeOptionalOptions<MiddlewareNextFnOptions<U>>): MiddlewareResult<U, TOutput>;
88
+ }
89
+ interface MiddlewareOutputFn<TOutput> {
90
+ (output: TOutput): MiddlewareResult<Record<never, never>, TOutput>;
91
+ }
92
+ interface MiddlewareOptions<TInContext extends Context, TOutput, TErrorConstructorMap extends ORPCErrorConstructorMap<any>, TMeta extends Meta> {
93
+ context: TInContext;
94
+ path: readonly string[];
95
+ procedure: Procedure<Context, Context, AnySchema, AnySchema, ErrorMap, TMeta>;
96
+ signal?: AbortSignal;
97
+ lastEventId: string | undefined;
98
+ next: MiddlewareNextFn<TOutput>;
99
+ errors: TErrorConstructorMap;
100
+ }
101
+ /**
102
+ * A function that represents a middleware.
103
+ *
104
+ * @see {@link https://orpc.unnoq.com/docs/middleware Middleware Docs}
105
+ */
106
+ interface Middleware<TInContext extends Context, TOutContext extends Context, TInput, TOutput, TErrorConstructorMap extends ORPCErrorConstructorMap<any>, TMeta extends Meta> {
107
+ (options: MiddlewareOptions<TInContext, TOutput, TErrorConstructorMap, TMeta>, input: TInput, output: MiddlewareOutputFn<TOutput>): Promisable<MiddlewareResult<TOutContext, TOutput>>;
108
+ }
109
+ type AnyMiddleware = Middleware<any, any, any, any, any, any>;
110
+ interface MapInputMiddleware<TInput, TMappedInput> {
111
+ (input: TInput): TMappedInput;
112
+ }
113
+ declare function middlewareOutputFn<TOutput>(output: TOutput): MiddlewareResult<Record<never, never>, TOutput>;
114
+
115
+ type ProcedureClient<TClientContext extends ClientContext, TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap> = Client<TClientContext, InferSchemaInput<TInputSchema>, InferSchemaOutput<TOutputSchema>, ErrorFromErrorMap<TErrorMap>>;
116
+ interface ProcedureClientInterceptorOptions<TInitialContext extends Context, TErrorMap extends ErrorMap, TMeta extends Meta> {
117
+ context: TInitialContext;
118
+ input: unknown;
119
+ errors: ORPCErrorConstructorMap<TErrorMap>;
120
+ path: readonly string[];
121
+ procedure: Procedure<Context, Context, AnySchema, AnySchema, ErrorMap, TMeta>;
122
+ signal?: AbortSignal;
123
+ lastEventId: string | undefined;
124
+ }
125
+ type CreateProcedureClientOptions<TInitialContext extends Context, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap, TMeta extends Meta, TClientContext extends ClientContext> = {
126
+ /**
127
+ * This is helpful for logging and analytics.
128
+ */
129
+ path?: readonly string[];
130
+ interceptors?: Interceptor<ProcedureClientInterceptorOptions<TInitialContext, TErrorMap, TMeta>, PromiseWithError<InferSchemaOutput<TOutputSchema>, ErrorFromErrorMap<TErrorMap>>>[];
131
+ } & (Record<never, never> extends TInitialContext ? {
132
+ context?: Value<Promisable<TInitialContext>, [clientContext: TClientContext]>;
133
+ } : {
134
+ context: Value<Promisable<TInitialContext>, [clientContext: TClientContext]>;
135
+ });
136
+ /**
137
+ * Create Server-side client from a procedure.
138
+ *
139
+ * @see {@link https://orpc.unnoq.com/docs/client/server-side Server-side Client Docs}
140
+ */
141
+ declare function createProcedureClient<TInitialContext extends Context, TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap, TMeta extends Meta, TClientContext extends ClientContext>(lazyableProcedure: Lazyable<Procedure<TInitialContext, any, TInputSchema, TOutputSchema, TErrorMap, TMeta>>, ...[options]: MaybeOptionalOptions<CreateProcedureClientOptions<TInitialContext, TOutputSchema, TErrorMap, TMeta, TClientContext>>): ProcedureClient<TClientContext, TInputSchema, TOutputSchema, TErrorMap>;
142
+
143
+ /**
144
+ * Represents a router, which defines a hierarchical structure of procedures.
145
+ *
146
+ * @info A procedure is a router too.
147
+ * @see {@link https://orpc.unnoq.com/docs/contract-first/define-contract#contract-router Contract Router Docs}
148
+ */
149
+ type Router<T extends AnyContractRouter, TInitialContext extends Context> = T extends ContractProcedure<infer UInputSchema, infer UOutputSchema, infer UErrorMap, infer UMeta> ? Procedure<TInitialContext, any, UInputSchema, UOutputSchema, UErrorMap, UMeta> : {
150
+ [K in keyof T]: T[K] extends AnyContractRouter ? Lazyable<Router<T[K], TInitialContext>> : never;
151
+ };
152
+ type AnyRouter = Router<any, any>;
153
+ type InferRouterInitialContext<T extends AnyRouter> = T extends Router<any, infer UInitialContext> ? UInitialContext : never;
154
+ /**
155
+ * Infer all initial context of the router.
156
+ *
157
+ * @info A procedure is a router too.
158
+ * @see {@link https://orpc.unnoq.com/docs/router#utilities Router Utilities Docs}
159
+ */
160
+ type InferRouterInitialContexts<T extends AnyRouter> = T extends Procedure<infer UInitialContext, any, any, any, any, any> ? UInitialContext : {
161
+ [K in keyof T]: T[K] extends Lazyable<infer U extends AnyRouter> ? InferRouterInitialContexts<U> : never;
162
+ };
163
+ /**
164
+ * Infer all current context of the router.
165
+ *
166
+ * @info A procedure is a router too.
167
+ * @see {@link https://orpc.unnoq.com/docs/router#utilities Router Utilities Docs}
168
+ */
169
+ type InferRouterCurrentContexts<T extends AnyRouter> = T extends Procedure<any, infer UCurrentContext, any, any, any, any> ? UCurrentContext : {
170
+ [K in keyof T]: T[K] extends Lazyable<infer U extends AnyRouter> ? InferRouterCurrentContexts<U> : never;
171
+ };
172
+ /**
173
+ * Infer all router inputs
174
+ *
175
+ * @info A procedure is a router too.
176
+ * @see {@link https://orpc.unnoq.com/docs/router#utilities Router Utilities Docs}
177
+ */
178
+ type InferRouterInputs<T extends AnyRouter> = T extends Procedure<any, any, infer UInputSchema, any, any, any> ? InferSchemaInput<UInputSchema> : {
179
+ [K in keyof T]: T[K] extends Lazyable<infer U extends AnyRouter> ? InferRouterInputs<U> : never;
180
+ };
181
+ /**
182
+ * Infer all router outputs
183
+ *
184
+ * @info A procedure is a router too.
185
+ * @see {@link https://orpc.unnoq.com/docs/router#utilities Router Utilities Docs}
186
+ */
187
+ type InferRouterOutputs<T extends AnyRouter> = T extends Procedure<any, any, any, infer UOutputSchema, any, any> ? InferSchemaOutput<UOutputSchema> : {
188
+ [K in keyof T]: T[K] extends Lazyable<infer U extends AnyRouter> ? InferRouterOutputs<U> : never;
189
+ };
190
+
191
+ export { isProcedure as E, createProcedureClient as G, Procedure as P, createORPCErrorConstructorMap as l, mergeCurrentContext as m, LAZY_SYMBOL as n, lazy as p, isLazy as q, getLazyMeta as r, unlazy as u, validateORPCError as v, middlewareOutputFn as z };
192
+ export type { AnyMiddleware as A, ProcedureHandlerOptions as B, Context as C, ProcedureDef as D, ProcedureClientInterceptorOptions as F, InferRouterInitialContexts as H, InferRouterInitialContext as I, InferRouterCurrentContexts as J, InferRouterInputs as K, Lazyable as L, Middleware as M, InferRouterOutputs as N, ORPCErrorConstructorMap as O, Router as R, MergedInitialContext as a, MergedCurrentContext as b, MapInputMiddleware as c, CreateProcedureClientOptions as d, ProcedureClient as e, AnyRouter as f, Lazy as g, AnyProcedure as h, ProcedureHandler as i, ORPCErrorConstructorMapItemOptions as j, ORPCErrorConstructorMapItem as k, LazyMeta as o, MiddlewareResult as s, MiddlewareNextFnOptions as t, MiddlewareNextFn as w, MiddlewareOutputFn as x, MiddlewareOptions as y };