@orpc/server 0.0.0-next.db1f26d → 0.0.0-next.df024bb
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 +118 -0
- package/dist/adapters/fetch/index.d.mts +27 -0
- package/dist/adapters/fetch/index.d.ts +27 -0
- package/dist/adapters/fetch/index.mjs +9 -0
- package/dist/adapters/hono/index.d.mts +20 -0
- package/dist/adapters/hono/index.d.ts +20 -0
- package/dist/adapters/hono/index.mjs +32 -0
- package/dist/adapters/next/index.d.mts +27 -0
- package/dist/adapters/next/index.d.ts +27 -0
- package/dist/adapters/next/index.mjs +29 -0
- package/dist/adapters/node/index.d.mts +35 -0
- package/dist/adapters/node/index.d.ts +35 -0
- package/dist/adapters/node/index.mjs +30 -0
- package/dist/adapters/standard/index.d.mts +29 -0
- package/dist/adapters/standard/index.d.ts +29 -0
- package/dist/adapters/standard/index.mjs +7 -0
- package/dist/index.d.mts +255 -0
- package/dist/index.d.ts +255 -0
- package/dist/index.mjs +333 -0
- package/dist/plugins/index.d.mts +31 -0
- package/dist/plugins/index.d.ts +31 -0
- package/dist/plugins/index.mjs +103 -0
- package/dist/shared/server.BBGuTxHE.mjs +163 -0
- package/dist/shared/server.BMaJxq9W.d.mts +9 -0
- package/dist/shared/server.BT-fqIEm.d.mts +77 -0
- package/dist/shared/server.DpdgHO1j.d.ts +9 -0
- package/dist/shared/server.KwueCzFr.mjs +26 -0
- package/dist/shared/server.Q6ZmnTgO.mjs +12 -0
- package/dist/shared/server.V6zT5iYQ.mjs +379 -0
- package/dist/shared/server.ptXwNGQr.d.mts +158 -0
- package/dist/shared/server.ptXwNGQr.d.ts +158 -0
- package/dist/shared/server.xL87pHsk.d.ts +77 -0
- package/package.json +41 -18
- package/dist/chunk-FL4ZAGNE.js +0 -267
- package/dist/fetch.js +0 -107
- package/dist/index.js +0 -468
- package/dist/src/builder.d.ts +0 -53
- package/dist/src/fetch/handle.d.ts +0 -7
- package/dist/src/fetch/handler.d.ts +0 -3
- package/dist/src/fetch/index.d.ts +0 -4
- package/dist/src/fetch/types.d.ts +0 -35
- package/dist/src/index.d.ts +0 -17
- package/dist/src/lazy.d.ts +0 -23
- package/dist/src/middleware.d.ts +0 -26
- package/dist/src/procedure-builder.d.ts +0 -31
- package/dist/src/procedure-caller.d.ts +0 -20
- package/dist/src/procedure-implementer.d.ts +0 -22
- package/dist/src/procedure.d.ts +0 -32
- package/dist/src/router-builder.d.ts +0 -27
- package/dist/src/router-caller.d.ts +0 -22
- package/dist/src/router-implementer.d.ts +0 -24
- package/dist/src/router.d.ts +0 -21
- package/dist/src/types.d.ts +0 -8
- package/dist/src/utils.d.ts +0 -3
@@ -0,0 +1,77 @@
|
|
1
|
+
import { HTTPPath, Schema, Meta, SchemaOutput, ErrorFromErrorMap } from '@orpc/contract';
|
2
|
+
import { Interceptor, MaybeOptionalOptions } from '@orpc/shared';
|
3
|
+
import { StandardResponse, StandardLazyRequest } from '@orpc/standard-server';
|
4
|
+
import { a as AnyRouter, A as AnyProcedure, C as Context, P as ProcedureClientInterceptorOptions, R as Router } from './server.ptXwNGQr.mjs';
|
5
|
+
import { ORPCError } from '@orpc/client';
|
6
|
+
|
7
|
+
type StandardParams = Record<string, string>;
|
8
|
+
type StandardMatchResult = {
|
9
|
+
path: string[];
|
10
|
+
procedure: AnyProcedure;
|
11
|
+
params?: StandardParams;
|
12
|
+
} | undefined;
|
13
|
+
interface StandardMatcher {
|
14
|
+
init(router: AnyRouter): void;
|
15
|
+
match(method: string, pathname: HTTPPath): Promise<StandardMatchResult>;
|
16
|
+
}
|
17
|
+
interface StandardCodec {
|
18
|
+
encode(output: unknown, procedure: AnyProcedure): StandardResponse;
|
19
|
+
encodeError(error: ORPCError<any, any>): StandardResponse;
|
20
|
+
decode(request: StandardLazyRequest, params: StandardParams | undefined, procedure: AnyProcedure): Promise<unknown>;
|
21
|
+
}
|
22
|
+
|
23
|
+
type StandardHandleOptions<T extends Context> = {
|
24
|
+
prefix?: HTTPPath;
|
25
|
+
} & (Record<never, never> extends T ? {
|
26
|
+
context?: T;
|
27
|
+
} : {
|
28
|
+
context: T;
|
29
|
+
});
|
30
|
+
type WellStandardHandleOptions<T extends Context> = StandardHandleOptions<T> & {
|
31
|
+
context: T;
|
32
|
+
};
|
33
|
+
type StandardHandleResult = {
|
34
|
+
matched: true;
|
35
|
+
response: StandardResponse;
|
36
|
+
} | {
|
37
|
+
matched: false;
|
38
|
+
response: undefined;
|
39
|
+
};
|
40
|
+
type StandardHandlerInterceptorOptions<TContext extends Context> = WellStandardHandleOptions<TContext> & {
|
41
|
+
request: StandardLazyRequest;
|
42
|
+
};
|
43
|
+
interface StandardHandlerOptions<TContext extends Context> {
|
44
|
+
plugins?: Plugin<TContext>[];
|
45
|
+
/**
|
46
|
+
* Interceptors at the request level, helpful when you want catch errors
|
47
|
+
*/
|
48
|
+
interceptors?: Interceptor<StandardHandlerInterceptorOptions<TContext>, StandardHandleResult, unknown>[];
|
49
|
+
/**
|
50
|
+
* Interceptors at the root level, helpful when you want override the request/response
|
51
|
+
*/
|
52
|
+
rootInterceptors?: Interceptor<StandardHandlerInterceptorOptions<TContext>, StandardHandleResult, unknown>[];
|
53
|
+
/**
|
54
|
+
*
|
55
|
+
* Interceptors for procedure client.
|
56
|
+
*/
|
57
|
+
clientInterceptors?: Interceptor<ProcedureClientInterceptorOptions<TContext, Schema, Record<never, never>, Meta>, SchemaOutput<Schema, unknown>, ErrorFromErrorMap<Record<never, never>>>[];
|
58
|
+
}
|
59
|
+
declare class StandardHandler<T extends Context> {
|
60
|
+
private readonly matcher;
|
61
|
+
private readonly codec;
|
62
|
+
private readonly options;
|
63
|
+
private readonly plugin;
|
64
|
+
constructor(router: Router<T, any>, matcher: StandardMatcher, codec: StandardCodec, options?: NoInfer<StandardHandlerOptions<T>>);
|
65
|
+
handle(request: StandardLazyRequest, ...[options]: MaybeOptionalOptions<StandardHandleOptions<T>>): Promise<StandardHandleResult>;
|
66
|
+
}
|
67
|
+
|
68
|
+
interface Plugin<TContext extends Context> {
|
69
|
+
init?(options: StandardHandlerOptions<TContext>): void;
|
70
|
+
}
|
71
|
+
declare class CompositePlugin<TContext extends Context> implements Plugin<TContext> {
|
72
|
+
private readonly plugins;
|
73
|
+
constructor(plugins?: Plugin<TContext>[]);
|
74
|
+
init(options: StandardHandlerOptions<TContext>): void;
|
75
|
+
}
|
76
|
+
|
77
|
+
export { CompositePlugin as C, type Plugin as P, type StandardHandleOptions as S, type WellStandardHandleOptions as W, type StandardHandlerOptions as a, type StandardMatcher as b, type StandardCodec as c, type StandardHandlerInterceptorOptions as d, type StandardParams as e, type StandardMatchResult as f, type StandardHandleResult as g, StandardHandler as h };
|
@@ -0,0 +1,9 @@
|
|
1
|
+
import { C as Context } from './server.ptXwNGQr.js';
|
2
|
+
import { a as StandardHandlerOptions, b as StandardMatcher, c as StandardCodec } from './server.xL87pHsk.js';
|
3
|
+
|
4
|
+
interface RPCHandlerOptions<T extends Context> extends StandardHandlerOptions<T> {
|
5
|
+
matcher?: StandardMatcher;
|
6
|
+
codec?: StandardCodec;
|
7
|
+
}
|
8
|
+
|
9
|
+
export type { RPCHandlerOptions as R };
|
@@ -0,0 +1,26 @@
|
|
1
|
+
import { toStandardLazyRequest, toFetchResponse } from '@orpc/standard-server-fetch';
|
2
|
+
import { a as RPCMatcher, R as RPCCodec, S as StandardHandler } from './server.BBGuTxHE.mjs';
|
3
|
+
|
4
|
+
class RPCHandler {
|
5
|
+
standardHandler;
|
6
|
+
constructor(router, options) {
|
7
|
+
const matcher = options?.matcher ?? new RPCMatcher();
|
8
|
+
const codec = options?.codec ?? new RPCCodec();
|
9
|
+
this.standardHandler = new StandardHandler(router, matcher, codec, options);
|
10
|
+
}
|
11
|
+
async handle(request, ...[
|
12
|
+
options = {}
|
13
|
+
]) {
|
14
|
+
const standardRequest = toStandardLazyRequest(request);
|
15
|
+
const result = await this.standardHandler.handle(standardRequest, options);
|
16
|
+
if (!result.matched) {
|
17
|
+
return result;
|
18
|
+
}
|
19
|
+
return {
|
20
|
+
matched: true,
|
21
|
+
response: toFetchResponse(result.response, options)
|
22
|
+
};
|
23
|
+
}
|
24
|
+
}
|
25
|
+
|
26
|
+
export { RPCHandler as R };
|
@@ -0,0 +1,379 @@
|
|
1
|
+
import { fallbackORPCErrorStatus, ORPCError } from '@orpc/client';
|
2
|
+
import { isContractProcedure, ValidationError, mergePrefix, mergeErrorMap, adaptRoute } from '@orpc/contract';
|
3
|
+
import { value, intercept, toError } from '@orpc/shared';
|
4
|
+
|
5
|
+
const LAZY_LOADER_SYMBOL = Symbol("ORPC_LAZY_LOADER");
|
6
|
+
function lazy(loader) {
|
7
|
+
return {
|
8
|
+
[LAZY_LOADER_SYMBOL]: loader
|
9
|
+
};
|
10
|
+
}
|
11
|
+
function isLazy(item) {
|
12
|
+
return (typeof item === "object" || typeof item === "function") && item !== null && LAZY_LOADER_SYMBOL in item && typeof item[LAZY_LOADER_SYMBOL] === "function";
|
13
|
+
}
|
14
|
+
function unlazy(lazied) {
|
15
|
+
return isLazy(lazied) ? lazied[LAZY_LOADER_SYMBOL]() : Promise.resolve({ default: lazied });
|
16
|
+
}
|
17
|
+
|
18
|
+
class Procedure {
|
19
|
+
"~orpc";
|
20
|
+
constructor(def) {
|
21
|
+
this["~orpc"] = def;
|
22
|
+
}
|
23
|
+
}
|
24
|
+
function isProcedure(item) {
|
25
|
+
if (item instanceof Procedure) {
|
26
|
+
return true;
|
27
|
+
}
|
28
|
+
return isContractProcedure(item) && "middlewares" in item["~orpc"] && "inputValidationIndex" in item["~orpc"] && "outputValidationIndex" in item["~orpc"] && "handler" in item["~orpc"];
|
29
|
+
}
|
30
|
+
|
31
|
+
function flatLazy(lazied) {
|
32
|
+
const flattenLoader = async () => {
|
33
|
+
let current = await unlazy(lazied);
|
34
|
+
while (true) {
|
35
|
+
if (!isLazy(current.default)) {
|
36
|
+
break;
|
37
|
+
}
|
38
|
+
current = await unlazy(current.default);
|
39
|
+
}
|
40
|
+
return current;
|
41
|
+
};
|
42
|
+
return lazy(flattenLoader);
|
43
|
+
}
|
44
|
+
function createLazyProcedureFormAnyLazy(lazied) {
|
45
|
+
const lazyProcedure = lazy(async () => {
|
46
|
+
const { default: maybeProcedure } = await unlazy(flatLazy(lazied));
|
47
|
+
if (!isProcedure(maybeProcedure)) {
|
48
|
+
throw new Error(`
|
49
|
+
Expected a lazy<procedure> but got lazy<unknown>.
|
50
|
+
This should be caught by TypeScript compilation.
|
51
|
+
Please report this issue if this makes you feel uncomfortable.
|
52
|
+
`);
|
53
|
+
}
|
54
|
+
return { default: maybeProcedure };
|
55
|
+
});
|
56
|
+
return lazyProcedure;
|
57
|
+
}
|
58
|
+
|
59
|
+
function dedupeMiddlewares(compare, middlewares) {
|
60
|
+
let min = 0;
|
61
|
+
for (let i = 0; i < middlewares.length; i++) {
|
62
|
+
const index = compare.indexOf(middlewares[i], min);
|
63
|
+
if (index === -1) {
|
64
|
+
return middlewares.slice(i);
|
65
|
+
}
|
66
|
+
min = index + 1;
|
67
|
+
}
|
68
|
+
return [];
|
69
|
+
}
|
70
|
+
function mergeMiddlewares(first, second) {
|
71
|
+
return [...first, ...dedupeMiddlewares(first, second)];
|
72
|
+
}
|
73
|
+
function addMiddleware(middlewares, addition) {
|
74
|
+
return [...middlewares, addition];
|
75
|
+
}
|
76
|
+
|
77
|
+
function createORPCErrorConstructorMap(errors) {
|
78
|
+
const proxy = new Proxy(errors, {
|
79
|
+
get(target, code) {
|
80
|
+
if (typeof code !== "string") {
|
81
|
+
return Reflect.get(target, code);
|
82
|
+
}
|
83
|
+
const item = (...[options]) => {
|
84
|
+
const config = errors[code];
|
85
|
+
return new ORPCError(code, {
|
86
|
+
defined: Boolean(config),
|
87
|
+
status: config?.status,
|
88
|
+
message: options?.message ?? config?.message,
|
89
|
+
data: options?.data,
|
90
|
+
cause: options?.cause
|
91
|
+
});
|
92
|
+
};
|
93
|
+
return item;
|
94
|
+
}
|
95
|
+
});
|
96
|
+
return proxy;
|
97
|
+
}
|
98
|
+
async function validateORPCError(map, error) {
|
99
|
+
const { code, status, message, data, cause, defined } = error;
|
100
|
+
const config = map?.[error.code];
|
101
|
+
if (!config || fallbackORPCErrorStatus(error.code, config.status) !== error.status) {
|
102
|
+
return defined ? new ORPCError(code, { defined: false, status, message, data, cause }) : error;
|
103
|
+
}
|
104
|
+
if (!config.data) {
|
105
|
+
return defined ? error : new ORPCError(code, { defined: true, status, message, data, cause });
|
106
|
+
}
|
107
|
+
const validated = await config.data["~standard"].validate(error.data);
|
108
|
+
if (validated.issues) {
|
109
|
+
return defined ? new ORPCError(code, { defined: false, status, message, data, cause }) : error;
|
110
|
+
}
|
111
|
+
return new ORPCError(code, { defined: true, status, message, data: validated.value, cause });
|
112
|
+
}
|
113
|
+
|
114
|
+
function middlewareOutputFn(output) {
|
115
|
+
return { output, context: {} };
|
116
|
+
}
|
117
|
+
|
118
|
+
function createProcedureClient(lazyableProcedure, ...[options]) {
|
119
|
+
return async (...[input, callerOptions]) => {
|
120
|
+
const path = options?.path ?? [];
|
121
|
+
const { default: procedure } = await unlazy(lazyableProcedure);
|
122
|
+
const clientContext = callerOptions?.context ?? {};
|
123
|
+
const context = await value(options?.context ?? {}, clientContext);
|
124
|
+
const errors = createORPCErrorConstructorMap(procedure["~orpc"].errorMap);
|
125
|
+
try {
|
126
|
+
return await intercept(
|
127
|
+
options?.interceptors ?? [],
|
128
|
+
{
|
129
|
+
context,
|
130
|
+
input,
|
131
|
+
// input only optional when it undefinable so we can safely cast it
|
132
|
+
errors,
|
133
|
+
path,
|
134
|
+
procedure,
|
135
|
+
signal: callerOptions?.signal,
|
136
|
+
lastEventId: callerOptions?.lastEventId
|
137
|
+
},
|
138
|
+
(interceptorOptions) => executeProcedureInternal(interceptorOptions.procedure, interceptorOptions)
|
139
|
+
);
|
140
|
+
} catch (e) {
|
141
|
+
if (!(e instanceof ORPCError)) {
|
142
|
+
throw toError(e);
|
143
|
+
}
|
144
|
+
const validated = await validateORPCError(procedure["~orpc"].errorMap, e);
|
145
|
+
throw validated;
|
146
|
+
}
|
147
|
+
};
|
148
|
+
}
|
149
|
+
async function validateInput(procedure, input) {
|
150
|
+
const schema = procedure["~orpc"].inputSchema;
|
151
|
+
if (!schema) {
|
152
|
+
return input;
|
153
|
+
}
|
154
|
+
const result = await schema["~standard"].validate(input);
|
155
|
+
if (result.issues) {
|
156
|
+
throw new ORPCError("BAD_REQUEST", {
|
157
|
+
message: "Input validation failed",
|
158
|
+
data: {
|
159
|
+
issues: result.issues
|
160
|
+
},
|
161
|
+
cause: new ValidationError({ message: "Input validation failed", issues: result.issues })
|
162
|
+
});
|
163
|
+
}
|
164
|
+
return result.value;
|
165
|
+
}
|
166
|
+
async function validateOutput(procedure, output) {
|
167
|
+
const schema = procedure["~orpc"].outputSchema;
|
168
|
+
if (!schema) {
|
169
|
+
return output;
|
170
|
+
}
|
171
|
+
const result = await schema["~standard"].validate(output);
|
172
|
+
if (result.issues) {
|
173
|
+
throw new ORPCError("INTERNAL_SERVER_ERROR", {
|
174
|
+
message: "Output validation failed",
|
175
|
+
cause: new ValidationError({ message: "Output validation failed", issues: result.issues })
|
176
|
+
});
|
177
|
+
}
|
178
|
+
return result.value;
|
179
|
+
}
|
180
|
+
async function executeProcedureInternal(procedure, options) {
|
181
|
+
const middlewares = procedure["~orpc"].middlewares;
|
182
|
+
const inputValidationIndex = Math.min(Math.max(0, procedure["~orpc"].inputValidationIndex), middlewares.length);
|
183
|
+
const outputValidationIndex = Math.min(Math.max(0, procedure["~orpc"].outputValidationIndex), middlewares.length);
|
184
|
+
let currentIndex = 0;
|
185
|
+
let currentContext = options.context;
|
186
|
+
let currentInput = options.input;
|
187
|
+
const next = async (...[nextOptions]) => {
|
188
|
+
const index = currentIndex;
|
189
|
+
currentIndex += 1;
|
190
|
+
currentContext = { ...currentContext, ...nextOptions?.context };
|
191
|
+
if (index === inputValidationIndex) {
|
192
|
+
currentInput = await validateInput(procedure, currentInput);
|
193
|
+
}
|
194
|
+
const mid = middlewares[index];
|
195
|
+
const result = mid ? await mid({ ...options, context: currentContext, next }, currentInput, middlewareOutputFn) : { output: await procedure["~orpc"].handler({ ...options, context: currentContext, input: currentInput }), context: currentContext };
|
196
|
+
if (index === outputValidationIndex) {
|
197
|
+
const validatedOutput = await validateOutput(procedure, result.output);
|
198
|
+
return {
|
199
|
+
...result,
|
200
|
+
output: validatedOutput
|
201
|
+
};
|
202
|
+
}
|
203
|
+
return result;
|
204
|
+
};
|
205
|
+
return (await next({})).output;
|
206
|
+
}
|
207
|
+
|
208
|
+
const ROUTER_CONTRACT_SYMBOL = Symbol("ORPC_ROUTER_CONTRACT");
|
209
|
+
function setRouterContract(obj, contract) {
|
210
|
+
return new Proxy(obj, {
|
211
|
+
get(target, key) {
|
212
|
+
if (key === ROUTER_CONTRACT_SYMBOL) {
|
213
|
+
return contract;
|
214
|
+
}
|
215
|
+
return Reflect.get(target, key);
|
216
|
+
}
|
217
|
+
});
|
218
|
+
}
|
219
|
+
function getRouterContract(obj) {
|
220
|
+
return obj[ROUTER_CONTRACT_SYMBOL];
|
221
|
+
}
|
222
|
+
const LAZY_ROUTER_PREFIX_SYMBOL = Symbol("ORPC_LAZY_ROUTER_PREFIX");
|
223
|
+
function deepSetLazyRouterPrefix(router, prefix) {
|
224
|
+
return new Proxy(router, {
|
225
|
+
get(target, key) {
|
226
|
+
if (key !== LAZY_ROUTER_PREFIX_SYMBOL) {
|
227
|
+
const val = Reflect.get(target, key);
|
228
|
+
if (isLazy(val)) {
|
229
|
+
return deepSetLazyRouterPrefix(val, prefix);
|
230
|
+
}
|
231
|
+
return val;
|
232
|
+
}
|
233
|
+
return prefix;
|
234
|
+
}
|
235
|
+
});
|
236
|
+
}
|
237
|
+
function getLazyRouterPrefix(obj) {
|
238
|
+
return obj[LAZY_ROUTER_PREFIX_SYMBOL];
|
239
|
+
}
|
240
|
+
|
241
|
+
function createAccessibleLazyRouter(lazied) {
|
242
|
+
const flattenLazy = flatLazy(lazied);
|
243
|
+
const recursive = new Proxy(flattenLazy, {
|
244
|
+
get(target, key) {
|
245
|
+
if (typeof key !== "string") {
|
246
|
+
return Reflect.get(target, key);
|
247
|
+
}
|
248
|
+
const next = getRouterChild(flattenLazy, key);
|
249
|
+
return createAccessibleLazyRouter(next);
|
250
|
+
}
|
251
|
+
});
|
252
|
+
return recursive;
|
253
|
+
}
|
254
|
+
|
255
|
+
function adaptRouter(router, options) {
|
256
|
+
if (isLazy(router)) {
|
257
|
+
const adapted2 = lazy(async () => {
|
258
|
+
const unlaziedRouter = (await unlazy(router)).default;
|
259
|
+
const adapted3 = adaptRouter(unlaziedRouter, options);
|
260
|
+
return { default: adapted3 };
|
261
|
+
});
|
262
|
+
const accessible = createAccessibleLazyRouter(adapted2);
|
263
|
+
const currentPrefix = getLazyRouterPrefix(router);
|
264
|
+
const prefix = currentPrefix ? mergePrefix(options.prefix, currentPrefix) : options.prefix;
|
265
|
+
if (prefix) {
|
266
|
+
return deepSetLazyRouterPrefix(accessible, prefix);
|
267
|
+
}
|
268
|
+
return accessible;
|
269
|
+
}
|
270
|
+
if (isProcedure(router)) {
|
271
|
+
const newMiddlewares = mergeMiddlewares(options.middlewares, router["~orpc"].middlewares);
|
272
|
+
const newMiddlewareAdded = newMiddlewares.length - router["~orpc"].middlewares.length;
|
273
|
+
const adapted2 = new Procedure({
|
274
|
+
...router["~orpc"],
|
275
|
+
route: adaptRoute(router["~orpc"].route, options),
|
276
|
+
errorMap: mergeErrorMap(options.errorMap, router["~orpc"].errorMap),
|
277
|
+
middlewares: newMiddlewares,
|
278
|
+
inputValidationIndex: router["~orpc"].inputValidationIndex + newMiddlewareAdded,
|
279
|
+
outputValidationIndex: router["~orpc"].outputValidationIndex + newMiddlewareAdded
|
280
|
+
});
|
281
|
+
return adapted2;
|
282
|
+
}
|
283
|
+
const adapted = {};
|
284
|
+
for (const key in router) {
|
285
|
+
adapted[key] = adaptRouter(router[key], options);
|
286
|
+
}
|
287
|
+
return adapted;
|
288
|
+
}
|
289
|
+
function getRouterChild(router, ...path) {
|
290
|
+
let current = router;
|
291
|
+
for (let i = 0; i < path.length; i++) {
|
292
|
+
const segment = path[i];
|
293
|
+
if (!current) {
|
294
|
+
return void 0;
|
295
|
+
}
|
296
|
+
if (isProcedure(current)) {
|
297
|
+
return void 0;
|
298
|
+
}
|
299
|
+
if (!isLazy(current)) {
|
300
|
+
current = current[segment];
|
301
|
+
continue;
|
302
|
+
}
|
303
|
+
const lazied = current;
|
304
|
+
const rest = path.slice(i);
|
305
|
+
const newLazy = lazy(async () => {
|
306
|
+
const unwrapped = await unlazy(lazied);
|
307
|
+
if (!unwrapped.default) {
|
308
|
+
return unwrapped;
|
309
|
+
}
|
310
|
+
const next = getRouterChild(unwrapped.default, ...rest);
|
311
|
+
return { default: next };
|
312
|
+
});
|
313
|
+
return flatLazy(newLazy);
|
314
|
+
}
|
315
|
+
return current;
|
316
|
+
}
|
317
|
+
|
318
|
+
function eachContractProcedure(options, callback, laziedOptions = []) {
|
319
|
+
const hiddenContract = getRouterContract(options.router);
|
320
|
+
if (hiddenContract) {
|
321
|
+
return eachContractProcedure(
|
322
|
+
{
|
323
|
+
router: hiddenContract,
|
324
|
+
path: options.path
|
325
|
+
},
|
326
|
+
callback,
|
327
|
+
laziedOptions
|
328
|
+
);
|
329
|
+
}
|
330
|
+
if (isLazy(options.router)) {
|
331
|
+
laziedOptions.push({
|
332
|
+
lazied: options.router,
|
333
|
+
path: options.path
|
334
|
+
});
|
335
|
+
} else if (isContractProcedure(options.router)) {
|
336
|
+
callback({
|
337
|
+
contract: options.router,
|
338
|
+
path: options.path
|
339
|
+
});
|
340
|
+
} else {
|
341
|
+
for (const key in options.router) {
|
342
|
+
eachContractProcedure(
|
343
|
+
{
|
344
|
+
router: options.router[key],
|
345
|
+
path: [...options.path, key]
|
346
|
+
},
|
347
|
+
callback,
|
348
|
+
laziedOptions
|
349
|
+
);
|
350
|
+
}
|
351
|
+
}
|
352
|
+
return laziedOptions;
|
353
|
+
}
|
354
|
+
async function eachAllContractProcedure(options, callback) {
|
355
|
+
const pending = [options];
|
356
|
+
for (const item of pending) {
|
357
|
+
const lazies = eachContractProcedure(item, callback);
|
358
|
+
for (const lazy of lazies) {
|
359
|
+
const { default: router } = await unlazy(lazy.lazied);
|
360
|
+
pending.push({
|
361
|
+
path: lazy.path,
|
362
|
+
router
|
363
|
+
});
|
364
|
+
}
|
365
|
+
}
|
366
|
+
}
|
367
|
+
function convertPathToHttpPath(path) {
|
368
|
+
return `/${path.map(encodeURIComponent).join("/")}`;
|
369
|
+
}
|
370
|
+
function createContractedProcedure(contract, procedure) {
|
371
|
+
return new Procedure({
|
372
|
+
...procedure["~orpc"],
|
373
|
+
errorMap: contract["~orpc"].errorMap,
|
374
|
+
route: contract["~orpc"].route,
|
375
|
+
meta: contract["~orpc"].meta
|
376
|
+
});
|
377
|
+
}
|
378
|
+
|
379
|
+
export { LAZY_LOADER_SYMBOL as L, Procedure as P, convertPathToHttpPath as a, createContractedProcedure as b, createProcedureClient as c, addMiddleware as d, eachContractProcedure as e, adaptRouter as f, getRouterChild as g, flatLazy as h, isProcedure as i, isLazy as j, createLazyProcedureFormAnyLazy as k, lazy as l, getRouterContract as m, deepSetLazyRouterPrefix as n, getLazyRouterPrefix as o, middlewareOutputFn as p, createAccessibleLazyRouter as q, eachAllContractProcedure as r, setRouterContract as s, unlazy as u };
|
@@ -0,0 +1,158 @@
|
|
1
|
+
import { ORPCErrorCode, ORPCErrorOptions, ORPCError, ClientContext, Client } from '@orpc/client';
|
2
|
+
import { IsNever, MaybeOptionalOptions, Promisable, Interceptor, Value } from '@orpc/shared';
|
3
|
+
import { ErrorMap, ErrorMapItem, SchemaInput, HTTPPath, Meta, Schema, ContractProcedureDef, SchemaOutput, ErrorFromErrorMap, AnyContractRouter, ContractProcedure, MergedErrorMap } from '@orpc/contract';
|
4
|
+
|
5
|
+
type Context = Record<string, any>;
|
6
|
+
type MergedContext<T extends Context, U extends Context> = T & U;
|
7
|
+
declare function mergeContext<T extends Context, U extends Context>(context: T, other: U): MergedContext<T, U>;
|
8
|
+
type ConflictContextGuard<T extends Context> = true extends IsNever<T> | {
|
9
|
+
[K in keyof T]: IsNever<T[K]>;
|
10
|
+
}[keyof T] ? never : unknown;
|
11
|
+
|
12
|
+
type ORPCErrorConstructorMapItemOptions<TData> = Omit<ORPCErrorOptions<TData>, 'defined' | 'status'>;
|
13
|
+
type ORPCErrorConstructorMapItem<TCode extends ORPCErrorCode, TInData> = (...rest: MaybeOptionalOptions<ORPCErrorConstructorMapItemOptions<TInData>>) => ORPCError<TCode, TInData>;
|
14
|
+
type ORPCErrorConstructorMap<T extends ErrorMap> = {
|
15
|
+
[K in keyof T]: K extends ORPCErrorCode ? T[K] extends ErrorMapItem<infer UInputSchema> ? ORPCErrorConstructorMapItem<K, SchemaInput<UInputSchema>> : never : never;
|
16
|
+
};
|
17
|
+
|
18
|
+
declare const LAZY_LOADER_SYMBOL: unique symbol;
|
19
|
+
interface LazyMeta {
|
20
|
+
prefix?: HTTPPath;
|
21
|
+
}
|
22
|
+
interface Lazy<T> {
|
23
|
+
[LAZY_LOADER_SYMBOL](): Promise<{
|
24
|
+
default: T;
|
25
|
+
}>;
|
26
|
+
}
|
27
|
+
type Lazyable<T> = T | Lazy<T>;
|
28
|
+
interface LazyOptions {
|
29
|
+
prefix?: HTTPPath;
|
30
|
+
}
|
31
|
+
declare function lazy<T>(loader: () => Promise<{
|
32
|
+
default: T;
|
33
|
+
}>): Lazy<T>;
|
34
|
+
declare function isLazy(item: unknown): item is Lazy<any>;
|
35
|
+
declare function unlazy<T extends Lazyable<any>>(lazied: T): Promise<{
|
36
|
+
default: T extends Lazy<infer U> ? U : T;
|
37
|
+
}>;
|
38
|
+
|
39
|
+
type MiddlewareResult<TOutContext extends Context, TOutput> = Promisable<{
|
40
|
+
output: TOutput;
|
41
|
+
context: TOutContext;
|
42
|
+
}>;
|
43
|
+
type MiddlewareNextFnOptions<TOutContext extends Context> = Record<never, never> extends TOutContext ? {
|
44
|
+
context?: TOutContext;
|
45
|
+
} : {
|
46
|
+
context: TOutContext;
|
47
|
+
};
|
48
|
+
interface MiddlewareNextFn<TInContext extends Context, TOutput> {
|
49
|
+
<U extends Context & Partial<TInContext> = Record<never, never>>(...rest: MaybeOptionalOptions<MiddlewareNextFnOptions<U>>): MiddlewareResult<U, TOutput>;
|
50
|
+
}
|
51
|
+
interface MiddlewareOutputFn<TOutput> {
|
52
|
+
(output: TOutput): MiddlewareResult<Record<never, never>, TOutput>;
|
53
|
+
}
|
54
|
+
interface MiddlewareOptions<TInContext extends Context, TOutput, TErrorConstructorMap extends ORPCErrorConstructorMap<any>, TMeta extends Meta> {
|
55
|
+
context: TInContext;
|
56
|
+
path: string[];
|
57
|
+
procedure: Procedure<Context, Context, Schema, Schema, unknown, ErrorMap, TMeta>;
|
58
|
+
signal?: AbortSignal;
|
59
|
+
lastEventId: string | undefined;
|
60
|
+
next: MiddlewareNextFn<TInContext, TOutput>;
|
61
|
+
errors: TErrorConstructorMap;
|
62
|
+
}
|
63
|
+
interface Middleware<TInContext extends Context, TOutContext extends Context, TInput, TOutput, TErrorConstructorMap extends ORPCErrorConstructorMap<any>, TMeta extends Meta> {
|
64
|
+
(options: MiddlewareOptions<TInContext, TOutput, TErrorConstructorMap, TMeta>, input: TInput, output: MiddlewareOutputFn<TOutput>): Promisable<MiddlewareResult<TOutContext, TOutput>>;
|
65
|
+
}
|
66
|
+
type AnyMiddleware = Middleware<any, any, any, any, any, any>;
|
67
|
+
interface MapInputMiddleware<TInput, TMappedInput> {
|
68
|
+
(input: TInput): TMappedInput;
|
69
|
+
}
|
70
|
+
declare function middlewareOutputFn<TOutput>(output: TOutput): MiddlewareResult<Record<never, never>, TOutput>;
|
71
|
+
|
72
|
+
interface ProcedureHandlerOptions<TCurrentContext extends Context, TInput, TErrorConstructorMap extends ORPCErrorConstructorMap<any>, TMeta extends Meta> {
|
73
|
+
context: TCurrentContext;
|
74
|
+
input: TInput;
|
75
|
+
path: string[];
|
76
|
+
procedure: Procedure<Context, Context, Schema, Schema, unknown, ErrorMap, TMeta>;
|
77
|
+
signal?: AbortSignal;
|
78
|
+
lastEventId: string | undefined;
|
79
|
+
errors: TErrorConstructorMap;
|
80
|
+
}
|
81
|
+
interface ProcedureHandler<TCurrentContext extends Context, TInput, THandlerOutput, TErrorMap extends ErrorMap, TMeta extends Meta> {
|
82
|
+
(opt: ProcedureHandlerOptions<TCurrentContext, TInput, ORPCErrorConstructorMap<TErrorMap>, TMeta>): Promisable<THandlerOutput>;
|
83
|
+
}
|
84
|
+
interface ProcedureDef<TInitialContext extends Context, TCurrentContext extends Context, TInputSchema extends Schema, TOutputSchema extends Schema, THandlerOutput, TErrorMap extends ErrorMap, TMeta extends Meta> extends ContractProcedureDef<TInputSchema, TOutputSchema, TErrorMap, TMeta> {
|
85
|
+
__initialContext?: (type: TInitialContext) => unknown;
|
86
|
+
middlewares: AnyMiddleware[];
|
87
|
+
inputValidationIndex: number;
|
88
|
+
outputValidationIndex: number;
|
89
|
+
handler: ProcedureHandler<TCurrentContext, any, THandlerOutput, any, any>;
|
90
|
+
}
|
91
|
+
declare class Procedure<TInitialContext extends Context, TCurrentContext extends Context, TInputSchema extends Schema, TOutputSchema extends Schema, THandlerOutput, TErrorMap extends ErrorMap, TMeta extends Meta> {
|
92
|
+
'~orpc': ProcedureDef<TInitialContext, TCurrentContext, TInputSchema, TOutputSchema, THandlerOutput, TErrorMap, TMeta>;
|
93
|
+
constructor(def: ProcedureDef<TInitialContext, TCurrentContext, TInputSchema, TOutputSchema, THandlerOutput, TErrorMap, TMeta>);
|
94
|
+
}
|
95
|
+
type AnyProcedure = Procedure<any, any, any, any, any, any, any>;
|
96
|
+
declare function isProcedure(item: unknown): item is AnyProcedure;
|
97
|
+
|
98
|
+
type ProcedureClient<TClientContext extends ClientContext, TInputSchema extends Schema, TOutputSchema extends Schema, THandlerOutput, TErrorMap extends ErrorMap> = Client<TClientContext, SchemaInput<TInputSchema>, SchemaOutput<TOutputSchema, THandlerOutput>, ErrorFromErrorMap<TErrorMap>>;
|
99
|
+
interface ProcedureClientInterceptorOptions<TInitialContext extends Context, TInputSchema extends Schema, TErrorMap extends ErrorMap, TMeta extends Meta> {
|
100
|
+
context: TInitialContext;
|
101
|
+
input: SchemaInput<TInputSchema>;
|
102
|
+
errors: ORPCErrorConstructorMap<TErrorMap>;
|
103
|
+
path: string[];
|
104
|
+
procedure: Procedure<Context, Context, Schema, Schema, unknown, ErrorMap, TMeta>;
|
105
|
+
signal?: AbortSignal;
|
106
|
+
lastEventId: string | undefined;
|
107
|
+
}
|
108
|
+
/**
|
109
|
+
* Options for creating a procedure caller with comprehensive type safety
|
110
|
+
*/
|
111
|
+
type CreateProcedureClientOptions<TInitialContext extends Context, TInputSchema extends Schema, TOutputSchema extends Schema, THandlerOutput, TErrorMap extends ErrorMap, TMeta extends Meta, TClientContext extends ClientContext> = {
|
112
|
+
/**
|
113
|
+
* This is helpful for logging and analytics.
|
114
|
+
*/
|
115
|
+
path?: string[];
|
116
|
+
interceptors?: Interceptor<ProcedureClientInterceptorOptions<TInitialContext, TInputSchema, TErrorMap, TMeta>, SchemaOutput<TOutputSchema, THandlerOutput>, ErrorFromErrorMap<TErrorMap>>[];
|
117
|
+
} & (Record<never, never> extends TInitialContext ? {
|
118
|
+
context?: Value<TInitialContext, [clientContext: TClientContext]>;
|
119
|
+
} : {
|
120
|
+
context: Value<TInitialContext, [clientContext: TClientContext]>;
|
121
|
+
});
|
122
|
+
declare function createProcedureClient<TInitialContext extends Context, TInputSchema extends Schema, TOutputSchema extends Schema, THandlerOutput, TErrorMap extends ErrorMap, TMeta extends Meta, TClientContext extends ClientContext>(lazyableProcedure: Lazyable<Procedure<TInitialContext, any, TInputSchema, TOutputSchema, THandlerOutput, TErrorMap, TMeta>>, ...[options]: MaybeOptionalOptions<CreateProcedureClientOptions<TInitialContext, TInputSchema, TOutputSchema, THandlerOutput, TErrorMap, TMeta, TClientContext>>): ProcedureClient<TClientContext, TInputSchema, TOutputSchema, THandlerOutput, TErrorMap>;
|
123
|
+
|
124
|
+
type AccessibleLazyRouter<T extends AnyRouter | undefined | Lazy<AnyRouter | undefined>> = T extends Lazy<infer U extends AnyRouter | undefined | Lazy<AnyRouter | undefined>> ? AccessibleLazyRouter<U> : Lazy<T> & (T extends AnyProcedure | undefined ? unknown : {
|
125
|
+
[K in keyof T]: T[K] extends AnyRouter ? AccessibleLazyRouter<T[K]> : never;
|
126
|
+
});
|
127
|
+
declare function createAccessibleLazyRouter<T extends Lazy<AnyRouter | undefined>>(lazied: T): AccessibleLazyRouter<T>;
|
128
|
+
|
129
|
+
type Router<TInitialContext extends Context, TContract extends AnyContractRouter> = Lazyable<TContract extends ContractProcedure<infer UInputSchema, infer UOutputSchema, infer UErrorMap, infer UMeta> ? Procedure<TInitialContext, any, UInputSchema, UOutputSchema, any, UErrorMap, UMeta> : {
|
130
|
+
[K in keyof TContract]: TContract[K] extends AnyContractRouter ? Router<TInitialContext, TContract[K]> : never;
|
131
|
+
}>;
|
132
|
+
type AnyRouter = Router<any, any>;
|
133
|
+
type InferRouterInitialContext<T extends AnyRouter> = T extends Router<infer UInitialContext, any> ? UInitialContext : never;
|
134
|
+
type InferRouterInitialContexts<T extends AnyRouter> = T extends Lazy<infer U extends AnyRouter> ? InferRouterInitialContexts<U> : T extends Procedure<infer UInitialContext, any, any, any, any, any, any> ? UInitialContext : {
|
135
|
+
[K in keyof T]: T[K] extends AnyRouter ? InferRouterInitialContexts<T[K]> : never;
|
136
|
+
};
|
137
|
+
type InferRouterCurrentContexts<T extends AnyRouter> = T extends Lazy<infer U extends AnyRouter> ? InferRouterCurrentContexts<U> : T extends Procedure<any, infer UCurrentContext, any, any, any, any, any> ? UCurrentContext : {
|
138
|
+
[K in keyof T]: T[K] extends AnyRouter ? InferRouterCurrentContexts<T[K]> : never;
|
139
|
+
};
|
140
|
+
type InferRouterInputs<T extends AnyRouter> = T extends Lazy<infer U extends AnyRouter> ? InferRouterInputs<U> : T extends Procedure<any, any, infer UInputSchema, any, any, any, any> ? SchemaInput<UInputSchema> : {
|
141
|
+
[K in keyof T]: T[K] extends AnyRouter ? InferRouterInputs<T[K]> : never;
|
142
|
+
};
|
143
|
+
type InferRouterOutputs<T extends AnyRouter> = T extends Lazy<infer U extends AnyRouter> ? InferRouterOutputs<U> : T extends Procedure<any, any, any, infer UOutputSchema, infer UFuncOutput, any, any> ? SchemaOutput<UOutputSchema, UFuncOutput> : {
|
144
|
+
[K in keyof T]: T[K] extends AnyRouter ? InferRouterOutputs<T[K]> : never;
|
145
|
+
};
|
146
|
+
type AdaptedRouter<TRouter extends AnyRouter, TInitialContext extends Context, TErrorMap extends ErrorMap> = TRouter extends Lazy<infer U extends AnyRouter> ? AccessibleLazyRouter<AdaptedRouter<U, TInitialContext, TErrorMap>> : TRouter extends Procedure<any, infer UCurrentContext, infer UInputSchema, infer UOutputSchema, infer UFuncOutput, infer UErrorMap, infer UMeta> ? Procedure<TInitialContext, UCurrentContext, UInputSchema, UOutputSchema, UFuncOutput, MergedErrorMap<TErrorMap, UErrorMap>, UMeta> : {
|
147
|
+
[K in keyof TRouter]: TRouter[K] extends AnyRouter ? AdaptedRouter<TRouter[K], TInitialContext, TErrorMap> : never;
|
148
|
+
};
|
149
|
+
interface AdaptRouterOptions<TErrorMap extends ErrorMap> {
|
150
|
+
middlewares: AnyMiddleware[];
|
151
|
+
tags?: readonly string[];
|
152
|
+
prefix?: HTTPPath;
|
153
|
+
errorMap: TErrorMap;
|
154
|
+
}
|
155
|
+
declare function adaptRouter<TRouter extends AnyRouter, TInitialContext extends Context, TErrorMap extends ErrorMap>(router: TRouter, options: AdaptRouterOptions<TErrorMap>): AdaptedRouter<TRouter, TInitialContext, TErrorMap>;
|
156
|
+
declare function getRouterChild<T extends AnyRouter | Lazy<undefined>>(router: T, ...path: string[]): T extends Lazy<any> ? Lazy<AnyProcedure> | Lazy<Record<string, AnyRouter>> | Lazy<undefined> : AnyRouter | Lazy<undefined> | undefined;
|
157
|
+
|
158
|
+
export { type AnyProcedure as A, type ProcedureDef as B, type Context as C, isProcedure as D, createProcedureClient as E, type InferRouterInitialContexts as F, type InferRouterCurrentContexts as G, type InferRouterInputs as H, type InferRouterInitialContext as I, type InferRouterOutputs as J, adaptRouter as K, type Lazy as L, type Middleware as M, getRouterChild as N, type ORPCErrorConstructorMap as O, type ProcedureClientInterceptorOptions as P, type AccessibleLazyRouter as Q, type Router as R, createAccessibleLazyRouter as S, type AnyRouter as a, Procedure as b, type ConflictContextGuard as c, type MergedContext as d, type MapInputMiddleware as e, type CreateProcedureClientOptions as f, type ProcedureClient as g, type ProcedureHandler as h, type AdaptRouterOptions as i, type AdaptedRouter as j, type AnyMiddleware as k, type Lazyable as l, mergeContext as m, LAZY_LOADER_SYMBOL as n, type LazyMeta as o, type LazyOptions as p, lazy as q, isLazy as r, type MiddlewareResult as s, type MiddlewareNextFnOptions as t, unlazy as u, type MiddlewareNextFn as v, type MiddlewareOutputFn as w, type MiddlewareOptions as x, middlewareOutputFn as y, type ProcedureHandlerOptions as z };
|