@orpc/contract 0.0.0-next.b15d206 → 0.0.0-next.b4e6d3a
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/dist/index.js +363 -130
- package/dist/src/builder-variants.d.ts +38 -0
- package/dist/src/builder.d.ts +30 -11
- package/dist/src/client-utils.d.ts +5 -0
- package/dist/src/client.d.ts +21 -0
- package/dist/src/config.d.ts +10 -0
- package/dist/src/error-map.d.ts +14 -0
- package/dist/src/error-orpc.d.ts +109 -0
- package/dist/src/error-utils.d.ts +15 -0
- package/dist/src/error.d.ts +13 -0
- package/dist/src/index.d.ts +13 -5
- package/dist/src/meta.d.ts +3 -0
- package/dist/src/procedure-client.d.ts +6 -0
- package/dist/src/procedure.d.ts +15 -43
- package/dist/src/route.d.ts +79 -0
- package/dist/src/router-client.d.ts +8 -0
- package/dist/src/router.d.ts +25 -12
- package/dist/src/schema.d.ts +8 -0
- package/package.json +13 -14
- package/dist/index.js.map +0 -1
- package/dist/src/builder.d.ts.map +0 -1
- package/dist/src/constants.d.ts +0 -3
- package/dist/src/constants.d.ts.map +0 -1
- package/dist/src/index.d.ts.map +0 -1
- package/dist/src/procedure.d.ts.map +0 -1
- package/dist/src/router-builder.d.ts +0 -16
- package/dist/src/router-builder.d.ts.map +0 -1
- package/dist/src/router.d.ts.map +0 -1
- package/dist/src/types.d.ts +0 -8
- package/dist/src/types.d.ts.map +0 -1
- package/dist/src/utils.d.ts +0 -4
- package/dist/src/utils.d.ts.map +0 -1
- package/dist/tsconfig.tsbuildinfo +0 -1
- package/src/builder.test.ts +0 -179
- package/src/builder.ts +0 -52
- package/src/constants.ts +0 -2
- package/src/index.ts +0 -12
- package/src/procedure.test.ts +0 -99
- package/src/procedure.ts +0 -125
- package/src/router-builder.test.ts +0 -70
- package/src/router-builder.ts +0 -46
- package/src/router.test-d.ts +0 -63
- package/src/router.test.ts +0 -24
- package/src/router.ts +0 -55
- package/src/types.test-d.ts +0 -16
- package/src/types.ts +0 -25
- package/src/utils.test.ts +0 -18
- package/src/utils.ts +0 -17
package/dist/index.js
CHANGED
|
@@ -1,176 +1,409 @@
|
|
|
1
|
+
// src/error-map.ts
|
|
2
|
+
function mergeErrorMap(errorMap1, errorMap2) {
|
|
3
|
+
return { ...errorMap1, ...errorMap2 };
|
|
4
|
+
}
|
|
5
|
+
|
|
6
|
+
// src/meta.ts
|
|
7
|
+
function mergeMeta(meta1, meta2) {
|
|
8
|
+
return { ...meta1, ...meta2 };
|
|
9
|
+
}
|
|
10
|
+
|
|
1
11
|
// src/procedure.ts
|
|
2
12
|
var ContractProcedure = class {
|
|
3
|
-
|
|
4
|
-
|
|
13
|
+
"~orpc";
|
|
14
|
+
constructor(def) {
|
|
15
|
+
if (def.route?.successStatus && (def.route.successStatus < 200 || def.route?.successStatus > 299)) {
|
|
16
|
+
throw new Error("[ContractProcedure] The successStatus must be between 200 and 299");
|
|
17
|
+
}
|
|
18
|
+
if (Object.values(def.errorMap).some((val) => val && val.status && (val.status < 400 || val.status > 599))) {
|
|
19
|
+
throw new Error("[ContractProcedure] The error status code must be in the 400-599 range.");
|
|
20
|
+
}
|
|
21
|
+
this["~orpc"] = def;
|
|
5
22
|
}
|
|
6
23
|
};
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
return cp;
|
|
11
|
-
return new _DecoratedContractProcedure(cp.zz$cp);
|
|
12
|
-
}
|
|
13
|
-
route(opts) {
|
|
14
|
-
return new _DecoratedContractProcedure({
|
|
15
|
-
...this.zz$cp,
|
|
16
|
-
...opts,
|
|
17
|
-
method: opts.method,
|
|
18
|
-
path: opts.path
|
|
19
|
-
});
|
|
24
|
+
function isContractProcedure(item) {
|
|
25
|
+
if (item instanceof ContractProcedure) {
|
|
26
|
+
return true;
|
|
20
27
|
}
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
+
return (typeof item === "object" || typeof item === "function") && item !== null && "~orpc" in item && typeof item["~orpc"] === "object" && item["~orpc"] !== null && "inputSchema" in item["~orpc"] && "outputSchema" in item["~orpc"] && "errorMap" in item["~orpc"] && "route" in item["~orpc"] && "meta" in item["~orpc"];
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
// src/route.ts
|
|
32
|
+
function mergeRoute(a, b) {
|
|
33
|
+
return { ...a, ...b };
|
|
34
|
+
}
|
|
35
|
+
function prefixRoute(route, prefix) {
|
|
36
|
+
if (!route.path) {
|
|
37
|
+
return route;
|
|
28
38
|
}
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
39
|
+
return {
|
|
40
|
+
...route,
|
|
41
|
+
path: `${prefix}${route.path}`
|
|
42
|
+
};
|
|
43
|
+
}
|
|
44
|
+
function unshiftTagRoute(route, tags) {
|
|
45
|
+
return {
|
|
46
|
+
...route,
|
|
47
|
+
tags: [...tags, ...route.tags ?? []]
|
|
48
|
+
};
|
|
49
|
+
}
|
|
50
|
+
function mergePrefix(a, b) {
|
|
51
|
+
return a ? `${a}${b}` : b;
|
|
52
|
+
}
|
|
53
|
+
function mergeTags(a, b) {
|
|
54
|
+
return a ? [...a, ...b] : b;
|
|
55
|
+
}
|
|
56
|
+
function adaptRoute(route, options) {
|
|
57
|
+
let router = route;
|
|
58
|
+
if (options.prefix) {
|
|
59
|
+
router = prefixRoute(router, options.prefix);
|
|
36
60
|
}
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
...this.zz$cp,
|
|
40
|
-
InputSchema: schema,
|
|
41
|
-
inputExample: example
|
|
42
|
-
});
|
|
61
|
+
if (options.tags) {
|
|
62
|
+
router = unshiftTagRoute(router, options.tags);
|
|
43
63
|
}
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
64
|
+
return router;
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
// src/router.ts
|
|
68
|
+
function adaptContractRouter(contract, options) {
|
|
69
|
+
if (isContractProcedure(contract)) {
|
|
70
|
+
const adapted2 = new ContractProcedure({
|
|
71
|
+
...contract["~orpc"],
|
|
72
|
+
errorMap: mergeErrorMap(options.errorMap, contract["~orpc"].errorMap),
|
|
73
|
+
route: adaptRoute(contract["~orpc"].route, options)
|
|
49
74
|
});
|
|
75
|
+
return adapted2;
|
|
50
76
|
}
|
|
51
|
-
};
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
return
|
|
77
|
+
const adapted = {};
|
|
78
|
+
for (const key in contract) {
|
|
79
|
+
adapted[key] = adaptContractRouter(contract[key], options);
|
|
80
|
+
}
|
|
81
|
+
return adapted;
|
|
56
82
|
}
|
|
57
83
|
|
|
58
|
-
// src/
|
|
59
|
-
var
|
|
60
|
-
constructor(
|
|
61
|
-
|
|
84
|
+
// src/builder.ts
|
|
85
|
+
var ContractBuilder = class _ContractBuilder extends ContractProcedure {
|
|
86
|
+
constructor(def) {
|
|
87
|
+
super(def);
|
|
88
|
+
this["~orpc"].prefix = def.prefix;
|
|
89
|
+
this["~orpc"].tags = def.tags;
|
|
62
90
|
}
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
91
|
+
/**
|
|
92
|
+
* Reset initial meta
|
|
93
|
+
*/
|
|
94
|
+
$meta(initialMeta) {
|
|
95
|
+
return new _ContractBuilder({
|
|
96
|
+
...this["~orpc"],
|
|
97
|
+
meta: initialMeta
|
|
67
98
|
});
|
|
68
99
|
}
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
100
|
+
/**
|
|
101
|
+
* Reset initial route
|
|
102
|
+
*/
|
|
103
|
+
$route(initialRoute) {
|
|
104
|
+
return new _ContractBuilder({
|
|
105
|
+
...this["~orpc"],
|
|
106
|
+
route: initialRoute
|
|
75
107
|
});
|
|
76
108
|
}
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
const decorated = DecoratedContractProcedure.decorate(item).addTags(
|
|
83
|
-
...this.zz$crb.tags ?? []
|
|
84
|
-
);
|
|
85
|
-
handled[key] = this.zz$crb.prefix ? decorated.prefix(this.zz$crb.prefix) : decorated;
|
|
86
|
-
} else {
|
|
87
|
-
handled[key] = this.router(item);
|
|
88
|
-
}
|
|
89
|
-
}
|
|
90
|
-
return handled;
|
|
109
|
+
errors(errors) {
|
|
110
|
+
return new _ContractBuilder({
|
|
111
|
+
...this["~orpc"],
|
|
112
|
+
errorMap: mergeErrorMap(this["~orpc"].errorMap, errors)
|
|
113
|
+
});
|
|
91
114
|
}
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
prefix(prefix) {
|
|
97
|
-
return new ContractRouterBuilder({
|
|
98
|
-
prefix
|
|
115
|
+
meta(meta) {
|
|
116
|
+
return new _ContractBuilder({
|
|
117
|
+
...this["~orpc"],
|
|
118
|
+
meta: mergeMeta(this["~orpc"].meta, meta)
|
|
99
119
|
});
|
|
100
120
|
}
|
|
101
|
-
|
|
102
|
-
return new
|
|
103
|
-
|
|
121
|
+
route(route) {
|
|
122
|
+
return new _ContractBuilder({
|
|
123
|
+
...this["~orpc"],
|
|
124
|
+
route: mergeRoute(this["~orpc"].route, route)
|
|
104
125
|
});
|
|
105
126
|
}
|
|
106
|
-
|
|
107
|
-
return new
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
...opts
|
|
127
|
+
input(schema) {
|
|
128
|
+
return new _ContractBuilder({
|
|
129
|
+
...this["~orpc"],
|
|
130
|
+
inputSchema: schema
|
|
111
131
|
});
|
|
112
132
|
}
|
|
113
|
-
|
|
114
|
-
return new
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
133
|
+
output(schema) {
|
|
134
|
+
return new _ContractBuilder({
|
|
135
|
+
...this["~orpc"],
|
|
136
|
+
outputSchema: schema
|
|
137
|
+
});
|
|
138
|
+
}
|
|
139
|
+
prefix(prefix) {
|
|
140
|
+
return new _ContractBuilder({
|
|
141
|
+
...this["~orpc"],
|
|
142
|
+
prefix: mergePrefix(this["~orpc"].prefix, prefix)
|
|
118
143
|
});
|
|
119
144
|
}
|
|
120
|
-
|
|
121
|
-
return new
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
outputExample: example
|
|
145
|
+
tag(...tags) {
|
|
146
|
+
return new _ContractBuilder({
|
|
147
|
+
...this["~orpc"],
|
|
148
|
+
tags: mergeTags(this["~orpc"].tags, tags)
|
|
125
149
|
});
|
|
126
150
|
}
|
|
127
151
|
router(router) {
|
|
128
|
-
return router;
|
|
152
|
+
return adaptContractRouter(router, this["~orpc"]);
|
|
129
153
|
}
|
|
130
154
|
};
|
|
155
|
+
var oc = new ContractBuilder({
|
|
156
|
+
errorMap: {},
|
|
157
|
+
inputSchema: void 0,
|
|
158
|
+
outputSchema: void 0,
|
|
159
|
+
route: {},
|
|
160
|
+
meta: {}
|
|
161
|
+
});
|
|
131
162
|
|
|
132
|
-
// src/
|
|
133
|
-
|
|
134
|
-
var
|
|
163
|
+
// src/error-orpc.ts
|
|
164
|
+
import { isObject } from "@orpc/shared";
|
|
165
|
+
var COMMON_ORPC_ERROR_DEFS = {
|
|
166
|
+
BAD_REQUEST: {
|
|
167
|
+
status: 400,
|
|
168
|
+
message: "Bad Request"
|
|
169
|
+
},
|
|
170
|
+
UNAUTHORIZED: {
|
|
171
|
+
status: 401,
|
|
172
|
+
message: "Unauthorized"
|
|
173
|
+
},
|
|
174
|
+
FORBIDDEN: {
|
|
175
|
+
status: 403,
|
|
176
|
+
message: "Forbidden"
|
|
177
|
+
},
|
|
178
|
+
NOT_FOUND: {
|
|
179
|
+
status: 404,
|
|
180
|
+
message: "Not Found"
|
|
181
|
+
},
|
|
182
|
+
METHOD_NOT_SUPPORTED: {
|
|
183
|
+
status: 405,
|
|
184
|
+
message: "Method Not Supported"
|
|
185
|
+
},
|
|
186
|
+
NOT_ACCEPTABLE: {
|
|
187
|
+
status: 406,
|
|
188
|
+
message: "Not Acceptable"
|
|
189
|
+
},
|
|
190
|
+
TIMEOUT: {
|
|
191
|
+
status: 408,
|
|
192
|
+
message: "Request Timeout"
|
|
193
|
+
},
|
|
194
|
+
CONFLICT: {
|
|
195
|
+
status: 409,
|
|
196
|
+
message: "Conflict"
|
|
197
|
+
},
|
|
198
|
+
PRECONDITION_FAILED: {
|
|
199
|
+
status: 412,
|
|
200
|
+
message: "Precondition Failed"
|
|
201
|
+
},
|
|
202
|
+
PAYLOAD_TOO_LARGE: {
|
|
203
|
+
status: 413,
|
|
204
|
+
message: "Payload Too Large"
|
|
205
|
+
},
|
|
206
|
+
UNSUPPORTED_MEDIA_TYPE: {
|
|
207
|
+
status: 415,
|
|
208
|
+
message: "Unsupported Media Type"
|
|
209
|
+
},
|
|
210
|
+
UNPROCESSABLE_CONTENT: {
|
|
211
|
+
status: 422,
|
|
212
|
+
message: "Unprocessable Content"
|
|
213
|
+
},
|
|
214
|
+
TOO_MANY_REQUESTS: {
|
|
215
|
+
status: 429,
|
|
216
|
+
message: "Too Many Requests"
|
|
217
|
+
},
|
|
218
|
+
CLIENT_CLOSED_REQUEST: {
|
|
219
|
+
status: 499,
|
|
220
|
+
message: "Client Closed Request"
|
|
221
|
+
},
|
|
222
|
+
INTERNAL_SERVER_ERROR: {
|
|
223
|
+
status: 500,
|
|
224
|
+
message: "Internal Server Error"
|
|
225
|
+
},
|
|
226
|
+
NOT_IMPLEMENTED: {
|
|
227
|
+
status: 501,
|
|
228
|
+
message: "Not Implemented"
|
|
229
|
+
},
|
|
230
|
+
BAD_GATEWAY: {
|
|
231
|
+
status: 502,
|
|
232
|
+
message: "Bad Gateway"
|
|
233
|
+
},
|
|
234
|
+
SERVICE_UNAVAILABLE: {
|
|
235
|
+
status: 503,
|
|
236
|
+
message: "Service Unavailable"
|
|
237
|
+
},
|
|
238
|
+
GATEWAY_TIMEOUT: {
|
|
239
|
+
status: 504,
|
|
240
|
+
message: "Gateway Timeout"
|
|
241
|
+
}
|
|
242
|
+
};
|
|
243
|
+
function fallbackORPCErrorStatus(code, status) {
|
|
244
|
+
return status ?? COMMON_ORPC_ERROR_DEFS[code]?.status ?? 500;
|
|
245
|
+
}
|
|
246
|
+
function fallbackORPCErrorMessage(code, message) {
|
|
247
|
+
return message || COMMON_ORPC_ERROR_DEFS[code]?.message || code;
|
|
248
|
+
}
|
|
249
|
+
var ORPCError = class _ORPCError extends Error {
|
|
250
|
+
defined;
|
|
251
|
+
code;
|
|
252
|
+
status;
|
|
253
|
+
data;
|
|
254
|
+
constructor(code, ...[options]) {
|
|
255
|
+
if (options?.status && (options.status < 400 || options.status >= 600)) {
|
|
256
|
+
throw new Error("[ORPCError] The error status code must be in the 400-599 range.");
|
|
257
|
+
}
|
|
258
|
+
const message = fallbackORPCErrorMessage(code, options?.message);
|
|
259
|
+
super(message, options);
|
|
260
|
+
this.code = code;
|
|
261
|
+
this.status = fallbackORPCErrorStatus(code, options?.status);
|
|
262
|
+
this.defined = options?.defined ?? false;
|
|
263
|
+
this.data = options?.data;
|
|
264
|
+
}
|
|
265
|
+
toJSON() {
|
|
266
|
+
return {
|
|
267
|
+
defined: this.defined,
|
|
268
|
+
code: this.code,
|
|
269
|
+
status: this.status,
|
|
270
|
+
message: this.message,
|
|
271
|
+
data: this.data
|
|
272
|
+
};
|
|
273
|
+
}
|
|
274
|
+
static fromJSON(json) {
|
|
275
|
+
return new _ORPCError(json.code, json);
|
|
276
|
+
}
|
|
277
|
+
static isValidJSON(json) {
|
|
278
|
+
return isObject(json) && "defined" in json && typeof json.defined === "boolean" && "code" in json && typeof json.code === "string" && "status" in json && typeof json.status === "number" && "message" in json && typeof json.message === "string";
|
|
279
|
+
}
|
|
280
|
+
};
|
|
135
281
|
|
|
136
|
-
// src/
|
|
137
|
-
function
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
282
|
+
// src/error-utils.ts
|
|
283
|
+
function isDefinedError(error) {
|
|
284
|
+
return error instanceof ORPCError && error.defined;
|
|
285
|
+
}
|
|
286
|
+
function createORPCErrorConstructorMap(errors) {
|
|
287
|
+
const proxy = new Proxy(errors, {
|
|
288
|
+
get(target, code) {
|
|
289
|
+
if (typeof code !== "string") {
|
|
290
|
+
return Reflect.get(target, code);
|
|
291
|
+
}
|
|
292
|
+
const item = (...[options]) => {
|
|
293
|
+
const config = errors[code];
|
|
294
|
+
return new ORPCError(code, {
|
|
295
|
+
defined: Boolean(config),
|
|
296
|
+
status: config?.status,
|
|
297
|
+
message: options?.message ?? config?.message,
|
|
298
|
+
data: options?.data,
|
|
299
|
+
cause: options?.cause
|
|
300
|
+
});
|
|
301
|
+
};
|
|
302
|
+
return item;
|
|
144
303
|
}
|
|
304
|
+
});
|
|
305
|
+
return proxy;
|
|
306
|
+
}
|
|
307
|
+
async function validateORPCError(map, error) {
|
|
308
|
+
const { code, status, message, data, cause, defined } = error;
|
|
309
|
+
const config = map?.[error.code];
|
|
310
|
+
if (!config || fallbackORPCErrorStatus(error.code, config.status) !== error.status) {
|
|
311
|
+
return defined ? new ORPCError(code, { defined: false, status, message, data, cause }) : error;
|
|
312
|
+
}
|
|
313
|
+
if (!config.data) {
|
|
314
|
+
return defined ? error : new ORPCError(code, { defined: true, status, message, data, cause });
|
|
145
315
|
}
|
|
316
|
+
const validated = await config.data["~standard"].validate(error.data);
|
|
317
|
+
if (validated.issues) {
|
|
318
|
+
return defined ? new ORPCError(code, { defined: false, status, message, data, cause }) : error;
|
|
319
|
+
}
|
|
320
|
+
return new ORPCError(code, { defined: true, status, message, data: validated.value, cause });
|
|
321
|
+
}
|
|
322
|
+
function toORPCError(error) {
|
|
323
|
+
return error instanceof ORPCError ? error : new ORPCError("INTERNAL_SERVER_ERROR", {
|
|
324
|
+
message: "Internal server error",
|
|
325
|
+
cause: error
|
|
326
|
+
});
|
|
146
327
|
}
|
|
147
328
|
|
|
148
|
-
// src/utils.ts
|
|
149
|
-
function
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
return
|
|
159
|
-
|
|
329
|
+
// src/client-utils.ts
|
|
330
|
+
async function safe(promise) {
|
|
331
|
+
try {
|
|
332
|
+
const output = await promise;
|
|
333
|
+
return [output, void 0, false];
|
|
334
|
+
} catch (e) {
|
|
335
|
+
const error = e;
|
|
336
|
+
if (isDefinedError(error)) {
|
|
337
|
+
return [void 0, error, true];
|
|
338
|
+
}
|
|
339
|
+
return [void 0, error, false];
|
|
340
|
+
}
|
|
160
341
|
}
|
|
161
342
|
|
|
162
|
-
// src/
|
|
163
|
-
var
|
|
343
|
+
// src/config.ts
|
|
344
|
+
var DEFAULT_CONFIG = {
|
|
345
|
+
defaultMethod: "POST",
|
|
346
|
+
defaultSuccessStatus: 200,
|
|
347
|
+
defaultSuccessDescription: "OK",
|
|
348
|
+
defaultInputStructure: "compact",
|
|
349
|
+
defaultOutputStructure: "compact"
|
|
350
|
+
};
|
|
351
|
+
function fallbackContractConfig(key, value) {
|
|
352
|
+
if (value === void 0) {
|
|
353
|
+
return DEFAULT_CONFIG[key];
|
|
354
|
+
}
|
|
355
|
+
return value;
|
|
356
|
+
}
|
|
357
|
+
|
|
358
|
+
// src/error.ts
|
|
359
|
+
var ValidationError = class extends Error {
|
|
360
|
+
issues;
|
|
361
|
+
constructor(options) {
|
|
362
|
+
super(options.message, options);
|
|
363
|
+
this.issues = options.issues;
|
|
364
|
+
}
|
|
365
|
+
};
|
|
366
|
+
|
|
367
|
+
// src/schema.ts
|
|
368
|
+
function type(...[map]) {
|
|
369
|
+
return {
|
|
370
|
+
"~standard": {
|
|
371
|
+
vendor: "custom",
|
|
372
|
+
version: 1,
|
|
373
|
+
async validate(value) {
|
|
374
|
+
if (map) {
|
|
375
|
+
return { value: await map(value) };
|
|
376
|
+
}
|
|
377
|
+
return { value };
|
|
378
|
+
}
|
|
379
|
+
}
|
|
380
|
+
};
|
|
381
|
+
}
|
|
164
382
|
export {
|
|
383
|
+
COMMON_ORPC_ERROR_DEFS,
|
|
165
384
|
ContractBuilder,
|
|
166
385
|
ContractProcedure,
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
386
|
+
ORPCError,
|
|
387
|
+
ValidationError,
|
|
388
|
+
adaptContractRouter,
|
|
389
|
+
adaptRoute,
|
|
390
|
+
createORPCErrorConstructorMap,
|
|
391
|
+
fallbackContractConfig,
|
|
392
|
+
fallbackORPCErrorMessage,
|
|
393
|
+
fallbackORPCErrorStatus,
|
|
171
394
|
isContractProcedure,
|
|
395
|
+
isDefinedError,
|
|
396
|
+
mergeErrorMap,
|
|
397
|
+
mergeMeta,
|
|
398
|
+
mergePrefix,
|
|
399
|
+
mergeRoute,
|
|
400
|
+
mergeTags,
|
|
172
401
|
oc,
|
|
173
|
-
|
|
174
|
-
|
|
402
|
+
prefixRoute,
|
|
403
|
+
safe,
|
|
404
|
+
toORPCError,
|
|
405
|
+
type,
|
|
406
|
+
unshiftTagRoute,
|
|
407
|
+
validateORPCError
|
|
175
408
|
};
|
|
176
409
|
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
import type { ErrorMap, MergedErrorMap } from './error-map';
|
|
2
|
+
import type { Meta } from './meta';
|
|
3
|
+
import type { ContractProcedure } from './procedure';
|
|
4
|
+
import type { HTTPPath, Route } from './route';
|
|
5
|
+
import type { AdaptContractRouterOptions, AdaptedContractRouter, ContractRouter } from './router';
|
|
6
|
+
import type { Schema } from './schema';
|
|
7
|
+
export interface ContractProcedureBuilder<TInputSchema extends Schema, TOutputSchema extends Schema, TErrorMap extends ErrorMap, TMeta extends Meta> extends ContractProcedure<TInputSchema, TOutputSchema, TErrorMap, TMeta> {
|
|
8
|
+
errors<U extends ErrorMap>(errors: U): ContractProcedureBuilder<TInputSchema, TOutputSchema, MergedErrorMap<TErrorMap, U>, TMeta>;
|
|
9
|
+
meta(meta: TMeta): ContractProcedureBuilder<TInputSchema, TOutputSchema, TErrorMap, TMeta>;
|
|
10
|
+
route(route: Route): ContractProcedureBuilder<TInputSchema, TOutputSchema, TErrorMap, TMeta>;
|
|
11
|
+
input<U extends Schema>(schema: U): ContractProcedureBuilderWithInput<U, TOutputSchema, TErrorMap, TMeta>;
|
|
12
|
+
output<U extends Schema>(schema: U): ContractProcedureBuilderWithOutput<TInputSchema, U, TErrorMap, TMeta>;
|
|
13
|
+
}
|
|
14
|
+
export interface ContractProcedureBuilderWithInput<TInputSchema extends Schema, TOutputSchema extends Schema, TErrorMap extends ErrorMap, TMeta extends Meta> extends ContractProcedure<TInputSchema, TOutputSchema, TErrorMap, TMeta> {
|
|
15
|
+
errors<U extends ErrorMap>(errors: U): ContractProcedureBuilderWithInput<TInputSchema, TOutputSchema, MergedErrorMap<TErrorMap, U>, TMeta>;
|
|
16
|
+
meta(meta: TMeta): ContractProcedureBuilderWithInput<TInputSchema, TOutputSchema, TErrorMap, TMeta>;
|
|
17
|
+
route(route: Route): ContractProcedureBuilderWithInput<TInputSchema, TOutputSchema, TErrorMap, TMeta>;
|
|
18
|
+
output<U extends Schema>(schema: U): ContractProcedureBuilderWithInputOutput<TInputSchema, U, TErrorMap, TMeta>;
|
|
19
|
+
}
|
|
20
|
+
export interface ContractProcedureBuilderWithOutput<TInputSchema extends Schema, TOutputSchema extends Schema, TErrorMap extends ErrorMap, TMeta extends Meta> extends ContractProcedure<TInputSchema, TOutputSchema, TErrorMap, TMeta> {
|
|
21
|
+
errors<U extends ErrorMap>(errors: U): ContractProcedureBuilderWithOutput<TInputSchema, TOutputSchema, MergedErrorMap<TErrorMap, U>, TMeta>;
|
|
22
|
+
meta(meta: TMeta): ContractProcedureBuilderWithOutput<TInputSchema, TOutputSchema, TErrorMap, TMeta>;
|
|
23
|
+
route(route: Route): ContractProcedureBuilderWithOutput<TInputSchema, TOutputSchema, TErrorMap, TMeta>;
|
|
24
|
+
input<U extends Schema>(schema: U): ContractProcedureBuilderWithInputOutput<U, TOutputSchema, TErrorMap, TMeta>;
|
|
25
|
+
}
|
|
26
|
+
export interface ContractProcedureBuilderWithInputOutput<TInputSchema extends Schema, TOutputSchema extends Schema, TErrorMap extends ErrorMap, TMeta extends Meta> extends ContractProcedure<TInputSchema, TOutputSchema, TErrorMap, TMeta> {
|
|
27
|
+
errors<U extends ErrorMap>(errors: U): ContractProcedureBuilderWithInputOutput<TInputSchema, TOutputSchema, MergedErrorMap<TErrorMap, U>, TMeta>;
|
|
28
|
+
meta(meta: TMeta): ContractProcedureBuilderWithInputOutput<TInputSchema, TOutputSchema, TErrorMap, TMeta>;
|
|
29
|
+
route(route: Route): ContractProcedureBuilderWithInputOutput<TInputSchema, TOutputSchema, TErrorMap, TMeta>;
|
|
30
|
+
}
|
|
31
|
+
export interface ContractRouterBuilder<TErrorMap extends ErrorMap, TMeta extends Meta> {
|
|
32
|
+
'~orpc': AdaptContractRouterOptions<TErrorMap>;
|
|
33
|
+
'errors'<U extends ErrorMap>(errors: U): ContractRouterBuilder<MergedErrorMap<TErrorMap, U>, TMeta>;
|
|
34
|
+
'prefix'(prefix: HTTPPath): ContractRouterBuilder<TErrorMap, TMeta>;
|
|
35
|
+
'tag'(...tags: string[]): ContractRouterBuilder<TErrorMap, TMeta>;
|
|
36
|
+
'router'<T extends ContractRouter<TMeta>>(router: T): AdaptedContractRouter<T, TErrorMap>;
|
|
37
|
+
}
|
|
38
|
+
//# sourceMappingURL=builder-variants.d.ts.map
|
package/dist/src/builder.d.ts
CHANGED
|
@@ -1,13 +1,32 @@
|
|
|
1
|
-
import type {
|
|
2
|
-
import type {
|
|
3
|
-
import {
|
|
4
|
-
import {
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
output<USchema extends Schema>(schema: USchema, example?: SchemaOutput<USchema>): DecoratedContractProcedure<undefined, USchema>;
|
|
11
|
-
router<T extends ContractRouter>(router: T): T;
|
|
1
|
+
import type { ContractProcedureBuilder, ContractProcedureBuilderWithInput, ContractProcedureBuilderWithOutput, ContractRouterBuilder } from './builder-variants';
|
|
2
|
+
import type { ContractProcedureDef } from './procedure';
|
|
3
|
+
import type { AdaptContractRouterOptions, AdaptedContractRouter, ContractRouter } from './router';
|
|
4
|
+
import type { Schema } from './schema';
|
|
5
|
+
import { type ErrorMap, type MergedErrorMap } from './error-map';
|
|
6
|
+
import { type Meta } from './meta';
|
|
7
|
+
import { ContractProcedure } from './procedure';
|
|
8
|
+
import { type HTTPPath, type Route } from './route';
|
|
9
|
+
export interface ContractBuilderDef<TInputSchema extends Schema, TOutputSchema extends Schema, TErrorMap extends ErrorMap, TMeta extends Meta> extends ContractProcedureDef<TInputSchema, TOutputSchema, TErrorMap, TMeta>, AdaptContractRouterOptions<TErrorMap> {
|
|
12
10
|
}
|
|
11
|
+
export declare class ContractBuilder<TInputSchema extends Schema, TOutputSchema extends Schema, TErrorMap extends ErrorMap, TMeta extends Meta> extends ContractProcedure<TInputSchema, TOutputSchema, TErrorMap, TMeta> {
|
|
12
|
+
'~orpc': ContractBuilderDef<TInputSchema, TOutputSchema, TErrorMap, TMeta>;
|
|
13
|
+
constructor(def: ContractBuilderDef<TInputSchema, TOutputSchema, TErrorMap, TMeta>);
|
|
14
|
+
/**
|
|
15
|
+
* Reset initial meta
|
|
16
|
+
*/
|
|
17
|
+
$meta<U extends Meta>(initialMeta: U): ContractBuilder<TInputSchema, TOutputSchema, TErrorMap, U>;
|
|
18
|
+
/**
|
|
19
|
+
* Reset initial route
|
|
20
|
+
*/
|
|
21
|
+
$route(initialRoute: Route): ContractBuilder<TInputSchema, TOutputSchema, TErrorMap, TMeta>;
|
|
22
|
+
errors<U extends ErrorMap>(errors: U): ContractBuilder<TInputSchema, TOutputSchema, MergedErrorMap<TErrorMap, U>, TMeta>;
|
|
23
|
+
meta(meta: TMeta): ContractProcedureBuilder<TInputSchema, TOutputSchema, TErrorMap, TMeta>;
|
|
24
|
+
route(route: Route): ContractProcedureBuilder<TInputSchema, TOutputSchema, TErrorMap, TMeta>;
|
|
25
|
+
input<U extends Schema>(schema: U): ContractProcedureBuilderWithInput<U, TOutputSchema, TErrorMap, TMeta>;
|
|
26
|
+
output<U extends Schema>(schema: U): ContractProcedureBuilderWithOutput<TInputSchema, U, TErrorMap, TMeta>;
|
|
27
|
+
prefix(prefix: HTTPPath): ContractRouterBuilder<TErrorMap, TMeta>;
|
|
28
|
+
tag(...tags: string[]): ContractRouterBuilder<TErrorMap, TMeta>;
|
|
29
|
+
router<T extends ContractRouter<TMeta>>(router: T): AdaptedContractRouter<T, TErrorMap>;
|
|
30
|
+
}
|
|
31
|
+
export declare const oc: ContractBuilder<undefined, undefined, {}, {}>;
|
|
13
32
|
//# sourceMappingURL=builder.d.ts.map
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
import type { ClientPromiseResult } from './client';
|
|
2
|
+
import type { ORPCError } from './error-orpc';
|
|
3
|
+
export type SafeResult<TOutput, TError extends Error> = [output: TOutput, error: undefined, isDefinedError: false] | [output: undefined, error: TError, isDefinedError: false] | [output: undefined, error: Extract<TError, ORPCError<any, any>>, isDefinedError: true];
|
|
4
|
+
export declare function safe<TOutput, TError extends Error>(promise: ClientPromiseResult<TOutput, TError>): Promise<SafeResult<TOutput, TError>>;
|
|
5
|
+
//# sourceMappingURL=client-utils.d.ts.map
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
export type ClientContext = Record<string, any>;
|
|
2
|
+
export type ClientOptions<TClientContext extends ClientContext> = {
|
|
3
|
+
signal?: AbortSignal;
|
|
4
|
+
} & (Record<never, never> extends TClientContext ? {
|
|
5
|
+
context?: TClientContext;
|
|
6
|
+
} : {
|
|
7
|
+
context: TClientContext;
|
|
8
|
+
});
|
|
9
|
+
export type ClientRest<TClientContext extends ClientContext, TInput> = [input: TInput, options: ClientOptions<TClientContext>] | (Record<never, never> extends TClientContext ? (undefined extends TInput ? [input?: TInput] : [input: TInput]) : never);
|
|
10
|
+
export type ClientPromiseResult<TOutput, TError extends Error> = Promise<TOutput> & {
|
|
11
|
+
__error?: {
|
|
12
|
+
type: TError;
|
|
13
|
+
};
|
|
14
|
+
};
|
|
15
|
+
export interface Client<TClientContext extends ClientContext, TInput, TOutput, TError extends Error> {
|
|
16
|
+
(...rest: ClientRest<TClientContext, TInput>): ClientPromiseResult<TOutput, TError>;
|
|
17
|
+
}
|
|
18
|
+
export type NestedClient<TClientContext extends ClientContext> = Client<TClientContext, any, any, any> | {
|
|
19
|
+
[k: string]: NestedClient<TClientContext>;
|
|
20
|
+
};
|
|
21
|
+
//# sourceMappingURL=client.d.ts.map
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import type { HTTPMethod, InputStructure } from './route';
|
|
2
|
+
export interface ContractConfig {
|
|
3
|
+
defaultMethod: HTTPMethod;
|
|
4
|
+
defaultSuccessStatus: number;
|
|
5
|
+
defaultSuccessDescription: string;
|
|
6
|
+
defaultInputStructure: InputStructure;
|
|
7
|
+
defaultOutputStructure: InputStructure;
|
|
8
|
+
}
|
|
9
|
+
export declare function fallbackContractConfig<T extends keyof ContractConfig>(key: T, value: ContractConfig[T] | undefined): ContractConfig[T];
|
|
10
|
+
//# sourceMappingURL=config.d.ts.map
|