@temporary-name/server 1.9.3-alpha.0d2fa3247b6b23bbc2e3097a95f631b86740e4d8 → 1.9.3-alpha.102eab0800942eb736f7669a86c850ebfdfcd4a3

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 (35) hide show
  1. package/dist/adapters/aws-lambda/index.d.mts +12 -6
  2. package/dist/adapters/aws-lambda/index.d.ts +12 -6
  3. package/dist/adapters/aws-lambda/index.mjs +13 -4
  4. package/dist/adapters/fetch/index.d.mts +12 -6
  5. package/dist/adapters/fetch/index.d.ts +12 -6
  6. package/dist/adapters/fetch/index.mjs +13 -11
  7. package/dist/adapters/node/index.d.mts +12 -6
  8. package/dist/adapters/node/index.d.ts +12 -6
  9. package/dist/adapters/node/index.mjs +13 -11
  10. package/dist/adapters/standard/index.d.mts +28 -13
  11. package/dist/adapters/standard/index.d.ts +28 -13
  12. package/dist/adapters/standard/index.mjs +9 -100
  13. package/dist/index.d.mts +69 -441
  14. package/dist/index.d.ts +69 -441
  15. package/dist/index.mjs +149 -356
  16. package/dist/openapi/index.d.mts +220 -0
  17. package/dist/openapi/index.d.ts +220 -0
  18. package/dist/openapi/index.mjs +760 -0
  19. package/dist/plugins/index.d.mts +2 -2
  20. package/dist/plugins/index.d.ts +2 -2
  21. package/dist/shared/{server.Btxrgkj5.d.ts → server.BCcLYvdF.d.mts} +7 -24
  22. package/dist/shared/server.CHV9AQHl.mjs +412 -0
  23. package/dist/shared/{server.Bo94xDTv.d.mts → server.CdeqmULw.d.ts} +7 -24
  24. package/dist/shared/server.DHezmW6C.d.mts +23 -0
  25. package/dist/shared/server.DN9mVGfv.mjs +11 -0
  26. package/dist/shared/server.DWwaAM-a.mjs +255 -0
  27. package/dist/shared/server.Da-qLzdU.d.ts +23 -0
  28. package/dist/shared/{server.C1YnHvvf.d.ts → server.DecvGKtb.d.mts} +125 -75
  29. package/dist/shared/{server.C1YnHvvf.d.mts → server.DecvGKtb.d.ts} +125 -75
  30. package/dist/shared/server.JtIZ8YG7.mjs +237 -0
  31. package/package.json +18 -11
  32. package/dist/shared/server.BEQrAa3A.mjs +0 -207
  33. package/dist/shared/server.D6K9uoPI.mjs +0 -35
  34. package/dist/shared/server.DZ5BIITo.mjs +0 -9
  35. package/dist/shared/server.X0YaZxSJ.mjs +0 -13
@@ -0,0 +1,255 @@
1
+ import { stringifyJSON, isObject, isORPCErrorStatus, tryDecodeURIComponent, toHttpPath, toArray, intercept, runWithSpan, ORPC_NAME, isAsyncIteratorObject, asyncIteratorWithSpan, setSpanError, ORPCError, toORPCError } from '@temporary-name/shared';
2
+ import { flattenHeader } from '@temporary-name/standard-server';
3
+ import { c as createProcedureClient } from './server.CHV9AQHl.mjs';
4
+ import { fallbackContractConfig } from '@temporary-name/contract';
5
+ import { d as deserialize, b as bracketNotationDeserialize, s as serialize } from './server.JtIZ8YG7.mjs';
6
+ import { traverseContractProcedures, isProcedure, getLazyMeta, unlazy, getRouter, createContractedProcedure } from '@temporary-name/server';
7
+ import { createRouter, addRoute, findRoute } from 'rou3';
8
+ import { s as standardizeHTTPPath } from './server.DN9mVGfv.mjs';
9
+
10
+ async function decode(request, pathParams) {
11
+ return {
12
+ path: pathParams ?? {},
13
+ query: bracketNotationDeserialize(Array.from(request.url.searchParams.entries())),
14
+ headers: request.headers,
15
+ body: deserialize(await request.body()) ?? {}
16
+ };
17
+ }
18
+ function encode(output, procedure) {
19
+ const successStatus = fallbackContractConfig(
20
+ "defaultSuccessStatus",
21
+ procedure["~orpc"].route.successStatus
22
+ );
23
+ const outputStructure = fallbackContractConfig(
24
+ "defaultOutputStructure",
25
+ procedure["~orpc"].route.outputStructure
26
+ );
27
+ if (outputStructure === "compact") {
28
+ return {
29
+ status: successStatus,
30
+ headers: {},
31
+ body: serialize(output)
32
+ };
33
+ }
34
+ if (!isDetailedOutput(output)) {
35
+ throw new Error(`
36
+ Invalid "detailed" output structure:
37
+ \u2022 Expected an object with optional properties:
38
+ - status (number 200-399)
39
+ - headers (Record<string, string | string[]>)
40
+ - body (any)
41
+ \u2022 No extra keys allowed.
42
+
43
+ Actual value:
44
+ ${stringifyJSON(output)}
45
+ `);
46
+ }
47
+ return {
48
+ status: output.status ?? successStatus,
49
+ headers: output.headers ?? {},
50
+ body: serialize(output.body)
51
+ };
52
+ }
53
+ function encodeError(error) {
54
+ return {
55
+ status: error.status,
56
+ headers: {},
57
+ body: serialize(error.toJSON(), { outputFormat: "plain" })
58
+ };
59
+ }
60
+ function isDetailedOutput(output) {
61
+ if (!isObject(output)) {
62
+ return false;
63
+ }
64
+ if (output.headers && !isObject(output.headers)) {
65
+ return false;
66
+ }
67
+ if (output.status !== void 0 && (typeof output.status !== "number" || !Number.isInteger(output.status) || isORPCErrorStatus(output.status))) {
68
+ return false;
69
+ }
70
+ return true;
71
+ }
72
+
73
+ function resolveFriendlyStandardHandleOptions(options) {
74
+ return {
75
+ ...options,
76
+ context: options.context ?? {}
77
+ // Context only optional if all fields are optional
78
+ };
79
+ }
80
+ function toRou3Pattern(path) {
81
+ return standardizeHTTPPath(path).replace(/\/\{\+([^}]+)\}/g, "/**:$1").replace(/\/\{([^}]+)\}/g, "/:$1");
82
+ }
83
+ function decodeParams(params) {
84
+ return Object.fromEntries(
85
+ Object.entries(params).map(([key, value]) => [key, tryDecodeURIComponent(value)])
86
+ );
87
+ }
88
+
89
+ class StandardOpenAPIMatcher {
90
+ tree = createRouter();
91
+ pendingRouters = [];
92
+ init(router, path = []) {
93
+ const laziedOptions = traverseContractProcedures({ router, path }, (traverseOptions) => {
94
+ const { path: path2, contract } = traverseOptions;
95
+ const method = fallbackContractConfig("defaultMethod", contract["~orpc"].route.method);
96
+ const httpPath = toRou3Pattern(contract["~orpc"].route.path ?? toHttpPath(path2));
97
+ if (isProcedure(contract)) {
98
+ addRoute(this.tree, method, httpPath, {
99
+ path: path2,
100
+ contract,
101
+ procedure: contract,
102
+ // this mean dev not used contract-first so we can used contract as procedure directly
103
+ router
104
+ });
105
+ } else {
106
+ addRoute(this.tree, method, httpPath, {
107
+ path: path2,
108
+ contract,
109
+ procedure: void 0,
110
+ router
111
+ });
112
+ }
113
+ });
114
+ this.pendingRouters.push(
115
+ ...laziedOptions.map((option) => ({
116
+ ...option,
117
+ httpPathPrefix: toHttpPath(option.path),
118
+ laziedPrefix: getLazyMeta(option.router).prefix
119
+ }))
120
+ );
121
+ }
122
+ async match(method, pathname) {
123
+ if (this.pendingRouters.length) {
124
+ const newPendingRouters = [];
125
+ for (const pendingRouter of this.pendingRouters) {
126
+ if (!pendingRouter.laziedPrefix || pathname.startsWith(pendingRouter.laziedPrefix) || pathname.startsWith(pendingRouter.httpPathPrefix)) {
127
+ const { default: router } = await unlazy(pendingRouter.router);
128
+ this.init(router, pendingRouter.path);
129
+ } else {
130
+ newPendingRouters.push(pendingRouter);
131
+ }
132
+ }
133
+ this.pendingRouters = newPendingRouters;
134
+ }
135
+ const match = findRoute(this.tree, method, pathname);
136
+ if (!match) {
137
+ return void 0;
138
+ }
139
+ if (!match.data.procedure) {
140
+ const { default: maybeProcedure } = await unlazy(getRouter(match.data.router, match.data.path));
141
+ if (!isProcedure(maybeProcedure)) {
142
+ throw new Error(`
143
+ [Contract-First] Missing or invalid implementation for procedure at path: ${toHttpPath(match.data.path)}.
144
+ Ensure that the procedure is correctly defined and matches the expected contract.
145
+ `);
146
+ }
147
+ match.data.procedure = createContractedProcedure(maybeProcedure, match.data.contract);
148
+ }
149
+ return {
150
+ path: match.data.path,
151
+ procedure: match.data.procedure,
152
+ params: match.params ? decodeParams(match.params) : void 0
153
+ };
154
+ }
155
+ }
156
+
157
+ class CompositeStandardHandlerPlugin {
158
+ plugins;
159
+ constructor(plugins = []) {
160
+ this.plugins = [...plugins].sort((a, b) => (a.order ?? 0) - (b.order ?? 0));
161
+ }
162
+ init(options, router) {
163
+ for (const plugin of this.plugins) {
164
+ plugin.init?.(options, router);
165
+ }
166
+ }
167
+ }
168
+
169
+ class StandardHandler {
170
+ interceptors;
171
+ clientInterceptors;
172
+ rootInterceptors;
173
+ matcher;
174
+ constructor(router, options) {
175
+ this.matcher = new StandardOpenAPIMatcher();
176
+ const plugins = new CompositeStandardHandlerPlugin(options.plugins);
177
+ plugins.init(options, router);
178
+ this.interceptors = toArray(options.interceptors);
179
+ this.clientInterceptors = toArray(options.clientInterceptors);
180
+ this.rootInterceptors = toArray(options.rootInterceptors);
181
+ this.matcher.init(router);
182
+ }
183
+ async handle(request, options) {
184
+ const prefix = options.prefix?.replace(/\/$/, "") || void 0;
185
+ if (prefix && !request.url.pathname.startsWith(`${prefix}/`) && request.url.pathname !== prefix) {
186
+ return { matched: false, response: void 0 };
187
+ }
188
+ return intercept(this.rootInterceptors, { ...options, request, prefix }, async (interceptorOptions) => {
189
+ return runWithSpan({ name: `${request.method} ${request.url.pathname}` }, async (span) => {
190
+ let step;
191
+ try {
192
+ return await intercept(
193
+ this.interceptors,
194
+ interceptorOptions,
195
+ async ({ request: request2, context, prefix: prefix2 }) => {
196
+ const method = request2.method;
197
+ const url = request2.url;
198
+ const pathname = prefix2 ? url.pathname.replace(prefix2, "") : url.pathname;
199
+ const match = await runWithSpan(
200
+ { name: "find_procedure" },
201
+ () => this.matcher.match(method, `/${pathname.replace(/^\/|\/$/g, "")}`)
202
+ );
203
+ if (!match) {
204
+ return { matched: false, response: void 0 };
205
+ }
206
+ span?.updateName(`${ORPC_NAME}.${match.path.join("/")}`);
207
+ span?.setAttribute("rpc.system", ORPC_NAME);
208
+ span?.setAttribute("rpc.method", match.path.join("."));
209
+ step = "decode_input";
210
+ const input = await runWithSpan({ name: "decode_input" }, () => decode(request2, match.params));
211
+ step = void 0;
212
+ if (isAsyncIteratorObject(input.body)) {
213
+ input.body = asyncIteratorWithSpan(
214
+ { name: "consume_event_iterator_input", signal: request2.signal },
215
+ input.body
216
+ );
217
+ }
218
+ const client = createProcedureClient(match.procedure, {
219
+ context,
220
+ path: match.path,
221
+ interceptors: this.clientInterceptors
222
+ });
223
+ step = "call_procedure";
224
+ const output = await client(input, {
225
+ signal: request2.signal,
226
+ lastEventId: flattenHeader(request2.headers["last-event-id"])
227
+ });
228
+ step = void 0;
229
+ const response = encode(output, match.procedure);
230
+ return {
231
+ matched: true,
232
+ response
233
+ };
234
+ }
235
+ );
236
+ } catch (e) {
237
+ if (step !== "call_procedure") {
238
+ setSpanError(span, e);
239
+ }
240
+ const error = step === "decode_input" && !(e instanceof ORPCError) ? new ORPCError("BAD_REQUEST", {
241
+ message: `Malformed request. Ensure the request body is properly formatted and the 'Content-Type' header is set correctly.`,
242
+ cause: e
243
+ }) : toORPCError(e);
244
+ const response = encodeError(error);
245
+ return {
246
+ matched: true,
247
+ response
248
+ };
249
+ }
250
+ });
251
+ });
252
+ }
253
+ }
254
+
255
+ export { CompositeStandardHandlerPlugin as C, StandardHandler as S, encodeError as a, StandardOpenAPIMatcher as b, decodeParams as c, decode as d, encode as e, resolveFriendlyStandardHandleOptions as r, toRou3Pattern as t };
@@ -0,0 +1,23 @@
1
+ import { HTTPPath } from '@temporary-name/shared';
2
+ import { C as Context } from './server.DecvGKtb.js';
3
+ import { c as StandardHandleOptions } from './server.CdeqmULw.js';
4
+
5
+ type FriendlyStandardHandleOptions<T extends Context> = Omit<StandardHandleOptions<T>, 'context'> & (Record<never, never> extends T ? {
6
+ context?: T;
7
+ } : {
8
+ context: T;
9
+ });
10
+ declare function resolveFriendlyStandardHandleOptions<T extends Context>(options: FriendlyStandardHandleOptions<T>): StandardHandleOptions<T>;
11
+ /**
12
+ * {@link https://github.com/unjs/rou3}
13
+ *
14
+ * @internal
15
+ */
16
+ declare function toRou3Pattern(path: HTTPPath): string;
17
+ /**
18
+ * @internal
19
+ */
20
+ declare function decodeParams(params: Record<string, string>): Record<string, string>;
21
+
22
+ export { decodeParams as d, resolveFriendlyStandardHandleOptions as r, toRou3Pattern as t };
23
+ export type { FriendlyStandardHandleOptions as F };
@@ -1,5 +1,5 @@
1
- import { ErrorMap, ErrorMapItem, InferSchemaInput, AnySchema, Meta, ContractProcedureDef, InferSchemaOutput, ErrorFromErrorMap, AnyContractRouter, ContractProcedure } from '@temporary-name/contract';
2
- import { ORPCErrorCode, MaybeOptionalOptions, ORPCErrorOptions, ORPCError, HTTPPath, Promisable, ClientContext, Interceptor, PromiseWithError, Value, Client } from '@temporary-name/shared';
1
+ import { ErrorMap, ErrorMapItem, InferSchemaInput, Schemas, Meta, ContractProcedureDef, AnyContractRouter, ContractProcedure, InferProcedureClientInputs, InferSchemaOutput, EnhanceRouteOptions, MergedErrorMap, AnyContractProcedure, ContractRouter, AnySchema, ErrorFromErrorMap } from '@temporary-name/contract';
2
+ import { ORPCErrorCode, MaybeOptionalOptions, ORPCErrorOptions, ORPCError, Promisable, HTTPPath, ClientContext, Interceptor, PromiseWithError, Value, Client } from '@temporary-name/shared';
3
3
 
4
4
  type Context = Record<PropertyKey, any>;
5
5
  type MergedInitialContext<TInitial extends Context, TAdditional extends Context, TCurrent extends Context> = TInitial & Omit<TAdditional, keyof TCurrent>;
@@ -13,46 +13,22 @@ type ORPCErrorConstructorMap<T extends ErrorMap> = {
13
13
  };
14
14
  declare function createORPCErrorConstructorMap<T extends ErrorMap>(errors: T): ORPCErrorConstructorMap<T>;
15
15
 
16
- declare const LAZY_SYMBOL: unique symbol;
17
- interface LazyMeta {
18
- prefix?: HTTPPath;
19
- }
20
- interface Lazy<T> {
21
- [LAZY_SYMBOL]: {
22
- loader: () => Promise<{
23
- default: T;
24
- }>;
25
- meta: LazyMeta;
26
- };
27
- }
28
- type Lazyable<T> = T | Lazy<T>;
29
- /**
30
- * Creates a lazy-loaded item.
31
- *
32
- * @warning The `prefix` in `meta` only holds metadata and does not apply the prefix to the lazy router, use `os.prefix(...).lazyRoute(...)` instead.
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> {
16
+ interface ProcedureHandlerOptions<TCurrentContext extends Context, TErrorConstructorMap extends ORPCErrorConstructorMap<any>, TMeta extends Meta> {
44
17
  context: TCurrentContext;
45
- input: TInput;
46
18
  path: readonly string[];
47
- procedure: Procedure<Context, Context, AnySchema, AnySchema, ErrorMap, TMeta>;
19
+ procedure: Procedure<Context, Context, Schemas, ErrorMap, TMeta>;
48
20
  signal?: AbortSignal;
49
21
  lastEventId: string | undefined;
50
22
  errors: TErrorConstructorMap;
51
23
  }
52
- interface ProcedureHandler<TCurrentContext extends Context, TInput, THandlerOutput, TErrorMap extends ErrorMap, TMeta extends Meta> {
53
- (opt: ProcedureHandlerOptions<TCurrentContext, TInput, ORPCErrorConstructorMap<TErrorMap>, TMeta>): Promisable<THandlerOutput>;
24
+ interface ProcedureHandler<TCurrentContext extends Context, TInput extends {
25
+ path: any;
26
+ query: any;
27
+ body: any;
28
+ }, THandlerOutput, TErrorMap extends ErrorMap, TMeta extends Meta> {
29
+ (input: TInput, opt: ProcedureHandlerOptions<TCurrentContext, ORPCErrorConstructorMap<TErrorMap>, TMeta>): Promisable<THandlerOutput>;
54
30
  }
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> {
31
+ interface ProcedureDef<TInitialContext extends Context, TCurrentContext extends Context, TSchemas extends Schemas, TErrorMap extends ErrorMap, TMeta extends Meta> extends ContractProcedureDef<TSchemas, TErrorMap, TMeta> {
56
32
  __initialContext?: (type: TInitialContext) => unknown;
57
33
  middlewares: readonly AnyMiddleware[];
58
34
  inputValidationIndex: number;
@@ -64,14 +40,14 @@ interface ProcedureDef<TInitialContext extends Context, TCurrentContext extends
64
40
  *
65
41
  * @see {@link https://orpc.unnoq.com/docs/procedure Procedure Docs}
66
42
  */
67
- declare class Procedure<TInitialContext extends Context, TCurrentContext extends Context, TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap, TMeta extends Meta> {
43
+ declare class Procedure<TInitialContext extends Context, TCurrentContext extends Context, TSchemas extends Schemas, TErrorMap extends ErrorMap, TMeta extends Meta> {
68
44
  /**
69
45
  * This property holds the defined options.
70
46
  */
71
- '~orpc': ProcedureDef<TInitialContext, TCurrentContext, TInputSchema, TOutputSchema, TErrorMap, TMeta>;
72
- constructor(def: ProcedureDef<TInitialContext, TCurrentContext, TInputSchema, TOutputSchema, TErrorMap, TMeta>);
47
+ '~orpc': ProcedureDef<TInitialContext, TCurrentContext, TSchemas, TErrorMap, TMeta>;
48
+ constructor(def: ProcedureDef<TInitialContext, TCurrentContext, TSchemas, TErrorMap, TMeta>);
73
49
  }
74
- type AnyProcedure = Procedure<any, any, any, any, any, any>;
50
+ type AnyProcedure = Procedure<any, any, Schemas, any, any>;
75
51
  declare function isProcedure(item: unknown): item is AnyProcedure;
76
52
 
77
53
  type MiddlewareResult<TOutContext extends Context, TOutput> = Promisable<{
@@ -92,7 +68,7 @@ interface MiddlewareOutputFn<TOutput> {
92
68
  interface MiddlewareOptions<TInContext extends Context, TOutput, TErrorConstructorMap extends ORPCErrorConstructorMap<any>, TMeta extends Meta> {
93
69
  context: TInContext;
94
70
  path: readonly string[];
95
- procedure: Procedure<Context, Context, AnySchema, AnySchema, ErrorMap, TMeta>;
71
+ procedure: Procedure<Context, Context, Schemas, ErrorMap, TMeta>;
96
72
  signal?: AbortSignal;
97
73
  lastEventId: string | undefined;
98
74
  next: MiddlewareNextFn<TOutput>;
@@ -112,41 +88,13 @@ interface MapInputMiddleware<TInput, TMappedInput> {
112
88
  }
113
89
  declare function middlewareOutputFn<TOutput>(output: TOutput): MiddlewareResult<Record<never, never>, TOutput>;
114
90
 
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>>, ...rest: MaybeOptionalOptions<CreateProcedureClientOptions<TInitialContext, TOutputSchema, TErrorMap, TMeta, TClientContext>>): ProcedureClient<TClientContext, TInputSchema, TOutputSchema, TErrorMap>;
142
-
143
91
  /**
144
92
  * Represents a router, which defines a hierarchical structure of procedures.
145
93
  *
146
94
  * @info A procedure is a router too.
147
95
  * @see {@link https://orpc.unnoq.com/docs/contract-first/define-contract#contract-router Contract Router Docs}
148
96
  */
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> : {
97
+ type Router<T extends AnyContractRouter, TInitialContext extends Context> = T extends ContractProcedure<infer USchemas, infer UErrorMap, infer UMeta> ? Procedure<TInitialContext, any, USchemas, UErrorMap, UMeta> : {
150
98
  [K in keyof T]: T[K] extends AnyContractRouter ? Lazyable<Router<T[K], TInitialContext>> : never;
151
99
  };
152
100
  type AnyRouter = Router<any, any>;
@@ -157,7 +105,7 @@ type InferRouterInitialContext<T extends AnyRouter> = T extends Router<any, infe
157
105
  * @info A procedure is a router too.
158
106
  * @see {@link https://orpc.unnoq.com/docs/router#utilities Router Utilities Docs}
159
107
  */
160
- type InferRouterInitialContexts<T extends AnyRouter> = T extends Procedure<infer UInitialContext, any, any, any, any, any> ? UInitialContext : {
108
+ type InferRouterInitialContexts<T extends AnyRouter> = T extends Procedure<infer UInitialContext, any, any, any, any> ? UInitialContext : {
161
109
  [K in keyof T]: T[K] extends Lazyable<infer U extends AnyRouter> ? InferRouterInitialContexts<U> : never;
162
110
  };
163
111
  /**
@@ -166,7 +114,7 @@ type InferRouterInitialContexts<T extends AnyRouter> = T extends Procedure<infer
166
114
  * @info A procedure is a router too.
167
115
  * @see {@link https://orpc.unnoq.com/docs/router#utilities Router Utilities Docs}
168
116
  */
169
- type InferRouterCurrentContexts<T extends AnyRouter> = T extends Procedure<any, infer UCurrentContext, any, any, any, any> ? UCurrentContext : {
117
+ type InferRouterCurrentContexts<T extends AnyRouter> = T extends Procedure<any, infer UCurrentContext, any, any, any> ? UCurrentContext : {
170
118
  [K in keyof T]: T[K] extends Lazyable<infer U extends AnyRouter> ? InferRouterCurrentContexts<U> : never;
171
119
  };
172
120
  /**
@@ -175,7 +123,7 @@ type InferRouterCurrentContexts<T extends AnyRouter> = T extends Procedure<any,
175
123
  * @info A procedure is a router too.
176
124
  * @see {@link https://orpc.unnoq.com/docs/router#utilities Router Utilities Docs}
177
125
  */
178
- type InferRouterInputs<T extends AnyRouter> = T extends Procedure<any, any, infer UInputSchema, any, any, any> ? InferSchemaInput<UInputSchema> : {
126
+ type InferRouterInputs<T extends AnyRouter> = T extends Procedure<any, any, infer USchemas, any, any> ? InferProcedureClientInputs<USchemas> : {
179
127
  [K in keyof T]: T[K] extends Lazyable<infer U extends AnyRouter> ? InferRouterInputs<U> : never;
180
128
  };
181
129
  /**
@@ -184,9 +132,111 @@ type InferRouterInputs<T extends AnyRouter> = T extends Procedure<any, any, infe
184
132
  * @info A procedure is a router too.
185
133
  * @see {@link https://orpc.unnoq.com/docs/router#utilities Router Utilities Docs}
186
134
  */
187
- type InferRouterOutputs<T extends AnyRouter> = T extends Procedure<any, any, any, infer UOutputSchema, any, any> ? InferSchemaOutput<UOutputSchema> : {
135
+ type InferRouterOutputs<T extends AnyRouter> = T extends Procedure<any, any, infer USchemas, any, any> ? InferSchemaOutput<USchemas['outputSchema']> : {
188
136
  [K in keyof T]: T[K] extends Lazyable<infer U extends AnyRouter> ? InferRouterOutputs<U> : never;
189
137
  };
190
138
 
191
- export { isProcedure as E, createProcedureClient as F, Procedure as b, mergeCurrentContext as m, createORPCErrorConstructorMap as n, LAZY_SYMBOL as o, lazy as q, isLazy as r, getLazyMeta as s, unlazy as u, middlewareOutputFn as z };
192
- export type { AnyRouter as A, ProcedureHandlerOptions as B, Context as C, ProcedureDef as D, InferRouterInitialContexts as G, InferRouterCurrentContexts as H, InferRouterInitialContext as I, InferRouterInputs as J, InferRouterOutputs as K, Lazyable as L, Middleware as M, ORPCErrorConstructorMap as O, ProcedureClientInterceptorOptions as P, Router as R, AnyProcedure as a, MergedInitialContext as c, MergedCurrentContext as d, MapInputMiddleware as e, CreateProcedureClientOptions as f, ProcedureClient as g, AnyMiddleware as h, Lazy as i, ProcedureHandler as j, ORPCErrorConstructorMapItemOptions as k, ORPCErrorConstructorMapItem as l, LazyMeta as p, MiddlewareResult as t, MiddlewareNextFnOptions as v, MiddlewareNextFn as w, MiddlewareOutputFn as x, MiddlewareOptions as y };
139
+ declare function getRouter<T extends Lazyable<AnyRouter | undefined>>(router: T, path: readonly string[]): T extends Lazy<any> ? Lazy<AnyRouter | undefined> : Lazyable<AnyRouter | undefined>;
140
+ type AccessibleLazyRouter<T extends Lazyable<AnyRouter | undefined>> = T extends Lazy<infer U extends AnyRouter | undefined | Lazy<AnyRouter | undefined>> ? AccessibleLazyRouter<U> : T extends AnyProcedure | undefined ? Lazy<T> : Lazy<T> & {
141
+ [K in keyof T]: T[K] extends Lazyable<AnyRouter> ? AccessibleLazyRouter<T[K]> : never;
142
+ };
143
+ declare function createAccessibleLazyRouter<T extends Lazy<AnyRouter | undefined>>(lazied: T): AccessibleLazyRouter<T>;
144
+ type EnhancedRouter<T extends Lazyable<AnyRouter>, TInitialContext extends Context, TCurrentContext extends Context, TErrorMap extends ErrorMap> = T extends Lazy<infer U extends AnyRouter> ? AccessibleLazyRouter<EnhancedRouter<U, TInitialContext, TCurrentContext, TErrorMap>> : T extends (Procedure<infer UInitialContext, infer UCurrentContext, infer USchemas, infer UErrorMap, infer UMeta>) ? Procedure<MergedInitialContext<TInitialContext, UInitialContext, TCurrentContext>, UCurrentContext, USchemas, MergedErrorMap<TErrorMap, UErrorMap>, UMeta> : {
145
+ [K in keyof T]: T[K] extends Lazyable<AnyRouter> ? EnhancedRouter<T[K], TInitialContext, TCurrentContext, TErrorMap> : never;
146
+ };
147
+ interface EnhanceRouterOptions<TErrorMap extends ErrorMap> extends EnhanceRouteOptions {
148
+ middlewares: readonly AnyMiddleware[];
149
+ errorMap: TErrorMap;
150
+ dedupeLeadingMiddlewares: boolean;
151
+ }
152
+ declare function enhanceRouter<T extends Lazyable<AnyRouter>, TInitialContext extends Context, TCurrentContext extends Context, TErrorMap extends ErrorMap>(router: T, options: EnhanceRouterOptions<TErrorMap>): EnhancedRouter<T, TInitialContext, TCurrentContext, TErrorMap>;
153
+ interface TraverseContractProceduresOptions {
154
+ router: AnyContractRouter | AnyRouter;
155
+ path: readonly string[];
156
+ }
157
+ interface TraverseContractProcedureCallbackOptions {
158
+ contract: AnyContractProcedure | AnyProcedure;
159
+ path: readonly string[];
160
+ }
161
+ /**
162
+ * @deprecated Use `TraverseContractProcedureCallbackOptions` instead.
163
+ */
164
+ type ContractProcedureCallbackOptions = TraverseContractProcedureCallbackOptions;
165
+ interface LazyTraverseContractProceduresOptions {
166
+ router: Lazy<AnyRouter>;
167
+ path: readonly string[];
168
+ }
169
+ declare function traverseContractProcedures(options: TraverseContractProceduresOptions, callback: (options: TraverseContractProcedureCallbackOptions) => void, lazyOptions?: LazyTraverseContractProceduresOptions[]): LazyTraverseContractProceduresOptions[];
170
+ declare function resolveContractProcedures(options: TraverseContractProceduresOptions, callback: (options: TraverseContractProcedureCallbackOptions) => void): Promise<void>;
171
+ type UnlaziedRouter<T extends AnyRouter> = T extends AnyProcedure ? T : {
172
+ [K in keyof T]: T[K] extends Lazyable<infer U extends AnyRouter> ? UnlaziedRouter<U> : never;
173
+ };
174
+ declare function unlazyRouter<T extends AnyRouter>(router: T): Promise<UnlaziedRouter<T>>;
175
+
176
+ declare const LAZY_SYMBOL: unique symbol;
177
+ interface LazyMeta {
178
+ prefix?: HTTPPath;
179
+ }
180
+ interface Lazy<T> {
181
+ [LAZY_SYMBOL]: {
182
+ loader: () => Promise<{
183
+ default: T;
184
+ }>;
185
+ meta: LazyMeta;
186
+ };
187
+ }
188
+ type Lazyable<T> = T | Lazy<T>;
189
+ /**
190
+ * @internal
191
+ */
192
+ declare function lazyInternal<T>(loader: () => Promise<{
193
+ default: T;
194
+ }>, meta?: LazyMeta): Lazy<T>;
195
+ /**
196
+ * Creates a lazy-loaded item.
197
+ *
198
+ * @warning The `prefix` in `meta` only holds metadata and does not apply the prefix to the lazy router, use `os.prefix(...).lazyRoute(...)` instead.
199
+ */
200
+ declare function lazy<T extends Router<ContractRouter<{}>, any>>(prefix: HTTPPath, loader: () => Promise<{
201
+ default: T;
202
+ }>): EnhancedRouter<Lazy<T>, {}, {}, {}>;
203
+ declare function isLazy(item: unknown): item is Lazy<any>;
204
+ declare function getLazyMeta(lazied: Lazy<any>): LazyMeta;
205
+ declare function unlazy<T extends Lazyable<any>>(lazied: T): Promise<{
206
+ default: T extends Lazy<infer U> ? U : T;
207
+ }>;
208
+
209
+ type ProcedureClient<TClientContext extends ClientContext, TSchemas extends Schemas, TErrorMap extends ErrorMap> = Client<TClientContext, InferProcedureClientInputs<TSchemas>, InferSchemaOutput<TSchemas['outputSchema']>, ErrorFromErrorMap<TErrorMap>>;
210
+ interface ProcedureClientInterceptorOptions<TInitialContext extends Context, TErrorMap extends ErrorMap, TMeta extends Meta> {
211
+ context: TInitialContext;
212
+ input: {
213
+ path: unknown;
214
+ query: unknown;
215
+ body: unknown;
216
+ };
217
+ errors: ORPCErrorConstructorMap<TErrorMap>;
218
+ path: readonly string[];
219
+ procedure: Procedure<Context, Context, Schemas, ErrorMap, TMeta>;
220
+ signal?: AbortSignal;
221
+ lastEventId: string | undefined;
222
+ }
223
+ type CreateProcedureClientOptions<TInitialContext extends Context, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap, TMeta extends Meta, TClientContext extends ClientContext> = {
224
+ /**
225
+ * This is helpful for logging and analytics.
226
+ */
227
+ path?: readonly string[];
228
+ interceptors?: Interceptor<ProcedureClientInterceptorOptions<TInitialContext, TErrorMap, TMeta>, PromiseWithError<InferSchemaOutput<TOutputSchema>, ErrorFromErrorMap<TErrorMap>>>[];
229
+ } & (Record<never, never> extends TInitialContext ? {
230
+ context?: Value<Promisable<TInitialContext>, [clientContext: TClientContext]>;
231
+ } : {
232
+ context: Value<Promisable<TInitialContext>, [clientContext: TClientContext]>;
233
+ });
234
+ /**
235
+ * Create Server-side client from a procedure.
236
+ *
237
+ * @see {@link https://orpc.unnoq.com/docs/client/server-side Server-side Client Docs}
238
+ */
239
+ declare function createProcedureClient<TInitialContext extends Context, TSchemas extends Schemas, TErrorMap extends ErrorMap, TMeta extends Meta, TClientContext extends ClientContext>(lazyableProcedure: Lazyable<Procedure<TInitialContext, any, TSchemas, TErrorMap, TMeta>>, ...rest: MaybeOptionalOptions<CreateProcedureClientOptions<TInitialContext, TSchemas['outputSchema'], TErrorMap, TMeta, TClientContext>>): ProcedureClient<TClientContext, TSchemas, TErrorMap>;
240
+
241
+ export { traverseContractProcedures as $, middlewareOutputFn as B, isProcedure as G, createProcedureClient as J, Procedure as P, getRouter as T, createAccessibleLazyRouter as V, enhanceRouter as W, resolveContractProcedures as a0, unlazyRouter as a2, mergeCurrentContext as m, createORPCErrorConstructorMap as n, LAZY_SYMBOL as o, lazyInternal as q, lazy as r, isLazy as s, getLazyMeta as t, unlazy as u };
242
+ export type { AnyMiddleware as A, Context as C, ProcedureHandlerOptions as D, EnhanceRouterOptions as E, ProcedureDef as F, ProcedureClientInterceptorOptions as H, InferRouterInitialContext as I, InferRouterInitialContexts as K, Lazy as L, Middleware as M, InferRouterCurrentContexts as N, ORPCErrorConstructorMap as O, InferRouterInputs as Q, Router as R, InferRouterOutputs as S, AccessibleLazyRouter as U, TraverseContractProceduresOptions as X, TraverseContractProcedureCallbackOptions as Y, ContractProcedureCallbackOptions as Z, LazyTraverseContractProceduresOptions as _, CreateProcedureClientOptions as a, UnlaziedRouter as a1, ProcedureClient as b, MergedInitialContext as c, MergedCurrentContext as d, ProcedureHandler as e, EnhancedRouter as f, MapInputMiddleware as g, AnyProcedure as h, Lazyable as i, AnyRouter as j, ORPCErrorConstructorMapItemOptions as k, ORPCErrorConstructorMapItem as l, LazyMeta as p, MiddlewareResult as v, MiddlewareNextFnOptions as w, MiddlewareNextFn as x, MiddlewareOutputFn as y, MiddlewareOptions as z };