@orpc/openapi 0.0.0-next.f17a1a0 → 0.0.0-next.f47352c
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 +15 -2
- package/dist/adapters/fetch/index.d.mts +11 -0
- package/dist/adapters/fetch/index.d.ts +11 -0
- package/dist/adapters/fetch/index.mjs +10 -0
- package/dist/adapters/hono/index.d.mts +6 -0
- package/dist/adapters/hono/index.d.ts +6 -0
- package/dist/adapters/hono/index.mjs +10 -0
- package/dist/adapters/next/index.d.mts +6 -0
- package/dist/adapters/next/index.d.ts +6 -0
- package/dist/adapters/next/index.mjs +10 -0
- package/dist/adapters/node/index.d.mts +11 -0
- package/dist/adapters/node/index.d.ts +11 -0
- package/dist/adapters/node/index.mjs +22 -0
- package/dist/adapters/standard/index.d.mts +34 -0
- package/dist/adapters/standard/index.d.ts +34 -0
- package/dist/adapters/standard/index.mjs +7 -0
- package/dist/index.d.mts +114 -0
- package/dist/index.d.ts +114 -0
- package/dist/index.mjs +536 -0
- package/dist/shared/openapi.CGZ7t-VN.mjs +17 -0
- package/dist/shared/openapi.IfmmOyba.d.mts +8 -0
- package/dist/shared/openapi.IfmmOyba.d.ts +8 -0
- package/dist/{chunk-PGCWJMRO.js → shared/openapi.sdeu0I7N.mjs} +28 -39
- package/package.json +28 -34
- package/dist/chunk-ATDLVTJE.js +0 -32
- package/dist/chunk-XGHV4TH3.js +0 -13
- package/dist/fetch.js +0 -9
- package/dist/hono.js +0 -9
- package/dist/index.js +0 -701
- package/dist/next.js +0 -9
- package/dist/node.js +0 -30
- package/dist/src/adapters/fetch/index.d.ts +0 -2
- package/dist/src/adapters/fetch/openapi-handler.d.ts +0 -11
- package/dist/src/adapters/hono/index.d.ts +0 -2
- package/dist/src/adapters/next/index.d.ts +0 -2
- package/dist/src/adapters/node/index.d.ts +0 -2
- package/dist/src/adapters/node/openapi-handler.d.ts +0 -11
- package/dist/src/adapters/standard/index.d.ts +0 -4
- package/dist/src/adapters/standard/openapi-codec.d.ts +0 -13
- package/dist/src/adapters/standard/openapi-handler.d.ts +0 -5
- package/dist/src/adapters/standard/openapi-matcher.d.ts +0 -10
- package/dist/src/index.d.ts +0 -16
- package/dist/src/openapi-content-builder.d.ts +0 -10
- package/dist/src/openapi-error.d.ts +0 -3
- package/dist/src/openapi-generator.d.ts +0 -67
- package/dist/src/openapi-input-structure-parser.d.ts +0 -22
- package/dist/src/openapi-operation-extender.d.ts +0 -7
- package/dist/src/openapi-output-structure-parser.d.ts +0 -18
- package/dist/src/openapi-parameters-builder.d.ts +0 -12
- package/dist/src/openapi-path-parser.d.ts +0 -8
- package/dist/src/openapi.d.ts +0 -3
- package/dist/src/schema-converter.d.ts +0 -16
- package/dist/src/schema-utils.d.ts +0 -11
- package/dist/src/schema.d.ts +0 -12
- package/dist/src/utils.d.ts +0 -4
- package/dist/standard.js +0 -10
package/dist/index.mjs
ADDED
|
@@ -0,0 +1,536 @@
|
|
|
1
|
+
import { isProcedure, resolveContractProcedures } from '@orpc/server';
|
|
2
|
+
import { fallbackORPCErrorStatus, fallbackORPCErrorMessage } from '@orpc/client';
|
|
3
|
+
import { toHttpPath } from '@orpc/client/standard';
|
|
4
|
+
import { fallbackContractConfig, getEventIteratorSchemaDetails } from '@orpc/contract';
|
|
5
|
+
import { standardizeHTTPPath, StandardOpenAPIJsonSerializer, getDynamicParams } from '@orpc/openapi-client/standard';
|
|
6
|
+
import { isObject, findDeepMatches, toArray, clone } from '@orpc/shared';
|
|
7
|
+
export { Format as JSONSchemaFormat } from 'json-schema-typed/draft-2020-12';
|
|
8
|
+
|
|
9
|
+
const OPERATION_EXTENDER_SYMBOL = Symbol("ORPC_OPERATION_EXTENDER");
|
|
10
|
+
function customOpenAPIOperation(o, extend) {
|
|
11
|
+
return new Proxy(o, {
|
|
12
|
+
get(target, prop, receiver) {
|
|
13
|
+
if (prop === OPERATION_EXTENDER_SYMBOL) {
|
|
14
|
+
return extend;
|
|
15
|
+
}
|
|
16
|
+
return Reflect.get(target, prop, receiver);
|
|
17
|
+
}
|
|
18
|
+
});
|
|
19
|
+
}
|
|
20
|
+
function getCustomOpenAPIOperation(o) {
|
|
21
|
+
return o[OPERATION_EXTENDER_SYMBOL];
|
|
22
|
+
}
|
|
23
|
+
function applyCustomOpenAPIOperation(operation, contract) {
|
|
24
|
+
const operationCustoms = [];
|
|
25
|
+
for (const errorItem of Object.values(contract["~orpc"].errorMap)) {
|
|
26
|
+
const maybeExtender = errorItem ? getCustomOpenAPIOperation(errorItem) : void 0;
|
|
27
|
+
if (maybeExtender) {
|
|
28
|
+
operationCustoms.push(maybeExtender);
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
if (isProcedure(contract)) {
|
|
32
|
+
for (const middleware of contract["~orpc"].middlewares) {
|
|
33
|
+
const maybeExtender = getCustomOpenAPIOperation(middleware);
|
|
34
|
+
if (maybeExtender) {
|
|
35
|
+
operationCustoms.push(maybeExtender);
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
let currentOperation = operation;
|
|
40
|
+
for (const custom of operationCustoms) {
|
|
41
|
+
if (typeof custom === "function") {
|
|
42
|
+
currentOperation = custom(currentOperation, contract);
|
|
43
|
+
} else {
|
|
44
|
+
currentOperation = {
|
|
45
|
+
...currentOperation,
|
|
46
|
+
...custom
|
|
47
|
+
};
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
return currentOperation;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
const LOGIC_KEYWORDS = [
|
|
54
|
+
"$dynamicRef",
|
|
55
|
+
"$ref",
|
|
56
|
+
"additionalItems",
|
|
57
|
+
"additionalProperties",
|
|
58
|
+
"allOf",
|
|
59
|
+
"anyOf",
|
|
60
|
+
"const",
|
|
61
|
+
"contains",
|
|
62
|
+
"contentEncoding",
|
|
63
|
+
"contentMediaType",
|
|
64
|
+
"contentSchema",
|
|
65
|
+
"dependencies",
|
|
66
|
+
"dependentRequired",
|
|
67
|
+
"dependentSchemas",
|
|
68
|
+
"else",
|
|
69
|
+
"enum",
|
|
70
|
+
"exclusiveMaximum",
|
|
71
|
+
"exclusiveMinimum",
|
|
72
|
+
"format",
|
|
73
|
+
"if",
|
|
74
|
+
"items",
|
|
75
|
+
"maxContains",
|
|
76
|
+
"maximum",
|
|
77
|
+
"maxItems",
|
|
78
|
+
"maxLength",
|
|
79
|
+
"maxProperties",
|
|
80
|
+
"minContains",
|
|
81
|
+
"minimum",
|
|
82
|
+
"minItems",
|
|
83
|
+
"minLength",
|
|
84
|
+
"minProperties",
|
|
85
|
+
"multipleOf",
|
|
86
|
+
"not",
|
|
87
|
+
"oneOf",
|
|
88
|
+
"pattern",
|
|
89
|
+
"patternProperties",
|
|
90
|
+
"prefixItems",
|
|
91
|
+
"properties",
|
|
92
|
+
"propertyNames",
|
|
93
|
+
"required",
|
|
94
|
+
"then",
|
|
95
|
+
"type",
|
|
96
|
+
"unevaluatedItems",
|
|
97
|
+
"unevaluatedProperties",
|
|
98
|
+
"uniqueItems"
|
|
99
|
+
];
|
|
100
|
+
|
|
101
|
+
function isFileSchema(schema) {
|
|
102
|
+
return isObject(schema) && schema.type === "string" && typeof schema.contentMediaType === "string";
|
|
103
|
+
}
|
|
104
|
+
function isObjectSchema(schema) {
|
|
105
|
+
return isObject(schema) && schema.type === "object";
|
|
106
|
+
}
|
|
107
|
+
function isAnySchema(schema) {
|
|
108
|
+
if (schema === true) {
|
|
109
|
+
return true;
|
|
110
|
+
}
|
|
111
|
+
if (Object.keys(schema).every((k) => !LOGIC_KEYWORDS.includes(k))) {
|
|
112
|
+
return true;
|
|
113
|
+
}
|
|
114
|
+
return false;
|
|
115
|
+
}
|
|
116
|
+
function separateObjectSchema(schema, separatedProperties) {
|
|
117
|
+
if (Object.keys(schema).some((k) => k !== "type" && k !== "properties" && k !== "required" && LOGIC_KEYWORDS.includes(k))) {
|
|
118
|
+
return [{ type: "object" }, schema];
|
|
119
|
+
}
|
|
120
|
+
const matched = { ...schema };
|
|
121
|
+
const rest = { ...schema };
|
|
122
|
+
matched.properties = schema.properties && Object.entries(schema.properties).filter(([key]) => separatedProperties.includes(key)).reduce((acc, [key, value]) => {
|
|
123
|
+
acc[key] = value;
|
|
124
|
+
return acc;
|
|
125
|
+
}, {});
|
|
126
|
+
matched.required = schema.required?.filter((key) => separatedProperties.includes(key));
|
|
127
|
+
matched.examples = schema.examples?.map((example) => {
|
|
128
|
+
if (!isObject(example)) {
|
|
129
|
+
return example;
|
|
130
|
+
}
|
|
131
|
+
return Object.entries(example).reduce((acc, [key, value]) => {
|
|
132
|
+
if (separatedProperties.includes(key)) {
|
|
133
|
+
acc[key] = value;
|
|
134
|
+
}
|
|
135
|
+
return acc;
|
|
136
|
+
}, {});
|
|
137
|
+
});
|
|
138
|
+
rest.properties = schema.properties && Object.entries(schema.properties).filter(([key]) => !separatedProperties.includes(key)).reduce((acc, [key, value]) => {
|
|
139
|
+
acc[key] = value;
|
|
140
|
+
return acc;
|
|
141
|
+
}, {});
|
|
142
|
+
rest.required = schema.required?.filter((key) => !separatedProperties.includes(key));
|
|
143
|
+
rest.examples = schema.examples?.map((example) => {
|
|
144
|
+
if (!isObject(example)) {
|
|
145
|
+
return example;
|
|
146
|
+
}
|
|
147
|
+
return Object.entries(example).reduce((acc, [key, value]) => {
|
|
148
|
+
if (!separatedProperties.includes(key)) {
|
|
149
|
+
acc[key] = value;
|
|
150
|
+
}
|
|
151
|
+
return acc;
|
|
152
|
+
}, {});
|
|
153
|
+
});
|
|
154
|
+
return [matched, rest];
|
|
155
|
+
}
|
|
156
|
+
function filterSchemaBranches(schema, check, matches = []) {
|
|
157
|
+
if (check(schema)) {
|
|
158
|
+
matches.push(schema);
|
|
159
|
+
return [matches, void 0];
|
|
160
|
+
}
|
|
161
|
+
if (isObject(schema)) {
|
|
162
|
+
for (const keyword of ["anyOf", "oneOf"]) {
|
|
163
|
+
if (schema[keyword] && Object.keys(schema).every(
|
|
164
|
+
(k) => k === keyword || !LOGIC_KEYWORDS.includes(k)
|
|
165
|
+
)) {
|
|
166
|
+
const rest = schema[keyword].map((s) => filterSchemaBranches(s, check, matches)[1]).filter((v) => !!v);
|
|
167
|
+
if (rest.length === 1 && typeof rest[0] === "object") {
|
|
168
|
+
return [matches, { ...schema, [keyword]: void 0, ...rest[0] }];
|
|
169
|
+
}
|
|
170
|
+
return [matches, { ...schema, [keyword]: rest }];
|
|
171
|
+
}
|
|
172
|
+
}
|
|
173
|
+
}
|
|
174
|
+
return [matches, schema];
|
|
175
|
+
}
|
|
176
|
+
function applySchemaOptionality(required, schema) {
|
|
177
|
+
if (required) {
|
|
178
|
+
return schema;
|
|
179
|
+
}
|
|
180
|
+
return {
|
|
181
|
+
anyOf: [
|
|
182
|
+
schema,
|
|
183
|
+
{ not: {} }
|
|
184
|
+
]
|
|
185
|
+
};
|
|
186
|
+
}
|
|
187
|
+
|
|
188
|
+
function toOpenAPIPath(path) {
|
|
189
|
+
return standardizeHTTPPath(path).replace(/\/\{\+([^}]+)\}/g, "/{$1}");
|
|
190
|
+
}
|
|
191
|
+
function toOpenAPIMethod(method) {
|
|
192
|
+
return method.toLocaleLowerCase();
|
|
193
|
+
}
|
|
194
|
+
function toOpenAPIContent(schema) {
|
|
195
|
+
const content = {};
|
|
196
|
+
const [matches, restSchema] = filterSchemaBranches(schema, isFileSchema);
|
|
197
|
+
for (const file of matches) {
|
|
198
|
+
content[file.contentMediaType] = {
|
|
199
|
+
schema: toOpenAPISchema(file)
|
|
200
|
+
};
|
|
201
|
+
}
|
|
202
|
+
if (restSchema !== void 0) {
|
|
203
|
+
content["application/json"] = {
|
|
204
|
+
schema: toOpenAPISchema(restSchema)
|
|
205
|
+
};
|
|
206
|
+
const isStillHasFileSchema = findDeepMatches((v) => isObject(v) && isFileSchema(v), restSchema).values.length > 0;
|
|
207
|
+
if (isStillHasFileSchema) {
|
|
208
|
+
content["multipart/form-data"] = {
|
|
209
|
+
schema: toOpenAPISchema(restSchema)
|
|
210
|
+
};
|
|
211
|
+
}
|
|
212
|
+
}
|
|
213
|
+
return content;
|
|
214
|
+
}
|
|
215
|
+
function toOpenAPIEventIteratorContent([yieldsRequired, yieldsSchema], [returnsRequired, returnsSchema]) {
|
|
216
|
+
return {
|
|
217
|
+
"text/event-stream": {
|
|
218
|
+
schema: toOpenAPISchema({
|
|
219
|
+
oneOf: [
|
|
220
|
+
{
|
|
221
|
+
type: "object",
|
|
222
|
+
properties: {
|
|
223
|
+
event: { const: "message" },
|
|
224
|
+
data: yieldsSchema,
|
|
225
|
+
id: { type: "string" },
|
|
226
|
+
retry: { type: "number" }
|
|
227
|
+
},
|
|
228
|
+
required: yieldsRequired ? ["event", "data"] : ["event"]
|
|
229
|
+
},
|
|
230
|
+
{
|
|
231
|
+
type: "object",
|
|
232
|
+
properties: {
|
|
233
|
+
event: { const: "done" },
|
|
234
|
+
data: returnsSchema,
|
|
235
|
+
id: { type: "string" },
|
|
236
|
+
retry: { type: "number" }
|
|
237
|
+
},
|
|
238
|
+
required: returnsRequired ? ["event", "data"] : ["event"]
|
|
239
|
+
},
|
|
240
|
+
{
|
|
241
|
+
type: "object",
|
|
242
|
+
properties: {
|
|
243
|
+
event: { const: "error" },
|
|
244
|
+
data: {},
|
|
245
|
+
id: { type: "string" },
|
|
246
|
+
retry: { type: "number" }
|
|
247
|
+
},
|
|
248
|
+
required: ["event"]
|
|
249
|
+
}
|
|
250
|
+
]
|
|
251
|
+
})
|
|
252
|
+
}
|
|
253
|
+
};
|
|
254
|
+
}
|
|
255
|
+
function toOpenAPIParameters(schema, parameterIn) {
|
|
256
|
+
const parameters = [];
|
|
257
|
+
for (const key in schema.properties) {
|
|
258
|
+
const keySchema = schema.properties[key];
|
|
259
|
+
parameters.push({
|
|
260
|
+
name: key,
|
|
261
|
+
in: parameterIn,
|
|
262
|
+
required: schema.required?.includes(key),
|
|
263
|
+
style: parameterIn === "query" ? "deepObject" : void 0,
|
|
264
|
+
explode: parameterIn === "query" ? true : void 0,
|
|
265
|
+
schema: toOpenAPISchema(keySchema)
|
|
266
|
+
});
|
|
267
|
+
}
|
|
268
|
+
return parameters;
|
|
269
|
+
}
|
|
270
|
+
function checkParamsSchema(schema, params) {
|
|
271
|
+
const properties = Object.keys(schema.properties ?? {});
|
|
272
|
+
const required = schema.required ?? [];
|
|
273
|
+
if (properties.length !== params.length || properties.some((v) => !params.includes(v))) {
|
|
274
|
+
return false;
|
|
275
|
+
}
|
|
276
|
+
if (required.length !== params.length || required.some((v) => !params.includes(v))) {
|
|
277
|
+
return false;
|
|
278
|
+
}
|
|
279
|
+
return true;
|
|
280
|
+
}
|
|
281
|
+
function toOpenAPISchema(schema) {
|
|
282
|
+
return schema === true ? {} : schema === false ? { not: {} } : schema;
|
|
283
|
+
}
|
|
284
|
+
|
|
285
|
+
class CompositeSchemaConverter {
|
|
286
|
+
converters;
|
|
287
|
+
constructor(converters) {
|
|
288
|
+
this.converters = converters;
|
|
289
|
+
}
|
|
290
|
+
convert(schema, options) {
|
|
291
|
+
for (const converter of this.converters) {
|
|
292
|
+
if (converter.condition(schema, options)) {
|
|
293
|
+
return converter.convert(schema, options);
|
|
294
|
+
}
|
|
295
|
+
}
|
|
296
|
+
return [false, {}];
|
|
297
|
+
}
|
|
298
|
+
}
|
|
299
|
+
|
|
300
|
+
class OpenAPIGeneratorError extends Error {
|
|
301
|
+
}
|
|
302
|
+
class OpenAPIGenerator {
|
|
303
|
+
serializer;
|
|
304
|
+
converter;
|
|
305
|
+
constructor(options = {}) {
|
|
306
|
+
this.serializer = new StandardOpenAPIJsonSerializer(options);
|
|
307
|
+
this.converter = new CompositeSchemaConverter(toArray(options.schemaConverters));
|
|
308
|
+
}
|
|
309
|
+
async generate(router, base) {
|
|
310
|
+
const doc = clone(base);
|
|
311
|
+
doc.openapi = "3.1.1";
|
|
312
|
+
const errors = [];
|
|
313
|
+
await resolveContractProcedures({ path: [], router }, ({ contract, path }) => {
|
|
314
|
+
const operationId = path.join(".");
|
|
315
|
+
try {
|
|
316
|
+
const def = contract["~orpc"];
|
|
317
|
+
const method = toOpenAPIMethod(fallbackContractConfig("defaultMethod", def.route.method));
|
|
318
|
+
const httpPath = toOpenAPIPath(def.route.path ?? toHttpPath(path));
|
|
319
|
+
const operationObjectRef = {
|
|
320
|
+
operationId,
|
|
321
|
+
summary: def.route.summary,
|
|
322
|
+
description: def.route.description,
|
|
323
|
+
deprecated: def.route.deprecated,
|
|
324
|
+
tags: def.route.tags?.map((tag) => tag)
|
|
325
|
+
};
|
|
326
|
+
this.#request(operationObjectRef, def);
|
|
327
|
+
this.#successResponse(operationObjectRef, def);
|
|
328
|
+
this.#errorResponse(operationObjectRef, def);
|
|
329
|
+
doc.paths ??= {};
|
|
330
|
+
doc.paths[httpPath] ??= {};
|
|
331
|
+
doc.paths[httpPath][method] = applyCustomOpenAPIOperation(operationObjectRef, contract);
|
|
332
|
+
} catch (e) {
|
|
333
|
+
if (!(e instanceof OpenAPIGeneratorError)) {
|
|
334
|
+
throw e;
|
|
335
|
+
}
|
|
336
|
+
errors.push(
|
|
337
|
+
`[OpenAPIGenerator] Error occurred while generating OpenAPI for procedure at path: ${operationId}
|
|
338
|
+
${e.message}`
|
|
339
|
+
);
|
|
340
|
+
}
|
|
341
|
+
});
|
|
342
|
+
if (errors.length) {
|
|
343
|
+
throw new OpenAPIGeneratorError(
|
|
344
|
+
`Some error occurred during OpenAPI generation:
|
|
345
|
+
|
|
346
|
+
${errors.join("\n\n")}`
|
|
347
|
+
);
|
|
348
|
+
}
|
|
349
|
+
return this.serializer.serialize(doc)[0];
|
|
350
|
+
}
|
|
351
|
+
#request(ref, def) {
|
|
352
|
+
const method = fallbackContractConfig("defaultMethod", def.route.method);
|
|
353
|
+
const details = getEventIteratorSchemaDetails(def.inputSchema);
|
|
354
|
+
if (details) {
|
|
355
|
+
ref.requestBody = {
|
|
356
|
+
required: true,
|
|
357
|
+
content: toOpenAPIEventIteratorContent(
|
|
358
|
+
this.converter.convert(details.yields, { strategy: "input" }),
|
|
359
|
+
this.converter.convert(details.returns, { strategy: "input" })
|
|
360
|
+
)
|
|
361
|
+
};
|
|
362
|
+
return;
|
|
363
|
+
}
|
|
364
|
+
const dynamicParams = getDynamicParams(def.route.path)?.map((v) => v.name);
|
|
365
|
+
const inputStructure = fallbackContractConfig("defaultInputStructure", def.route.inputStructure);
|
|
366
|
+
let [required, schema] = this.converter.convert(def.inputSchema, { strategy: "input" });
|
|
367
|
+
if (isAnySchema(schema) && !dynamicParams?.length) {
|
|
368
|
+
return;
|
|
369
|
+
}
|
|
370
|
+
if (inputStructure === "compact") {
|
|
371
|
+
if (dynamicParams?.length) {
|
|
372
|
+
const error2 = new OpenAPIGeneratorError(
|
|
373
|
+
'When input structure is "compact", and path has dynamic params, input schema must be an object with all dynamic params as required.'
|
|
374
|
+
);
|
|
375
|
+
if (!isObjectSchema(schema)) {
|
|
376
|
+
throw error2;
|
|
377
|
+
}
|
|
378
|
+
const [paramsSchema, rest] = separateObjectSchema(schema, dynamicParams);
|
|
379
|
+
schema = rest;
|
|
380
|
+
required = rest.required ? rest.required.length !== 0 : false;
|
|
381
|
+
if (!checkParamsSchema(paramsSchema, dynamicParams)) {
|
|
382
|
+
throw error2;
|
|
383
|
+
}
|
|
384
|
+
ref.parameters ??= [];
|
|
385
|
+
ref.parameters.push(...toOpenAPIParameters(paramsSchema, "path"));
|
|
386
|
+
}
|
|
387
|
+
if (method === "GET") {
|
|
388
|
+
if (!isObjectSchema(schema)) {
|
|
389
|
+
throw new OpenAPIGeneratorError(
|
|
390
|
+
'When method is "GET", input schema must satisfy: object | any | unknown'
|
|
391
|
+
);
|
|
392
|
+
}
|
|
393
|
+
ref.parameters ??= [];
|
|
394
|
+
ref.parameters.push(...toOpenAPIParameters(schema, "query"));
|
|
395
|
+
} else {
|
|
396
|
+
ref.requestBody = {
|
|
397
|
+
required,
|
|
398
|
+
content: toOpenAPIContent(schema)
|
|
399
|
+
};
|
|
400
|
+
}
|
|
401
|
+
return;
|
|
402
|
+
}
|
|
403
|
+
const error = new OpenAPIGeneratorError(
|
|
404
|
+
'When input structure is "detailed", input schema must satisfy: { params?: Record<string, unknown>, query?: Record<string, unknown>, headers?: Record<string, unknown>, body?: unknown }'
|
|
405
|
+
);
|
|
406
|
+
if (!isObjectSchema(schema)) {
|
|
407
|
+
throw error;
|
|
408
|
+
}
|
|
409
|
+
if (dynamicParams?.length && (schema.properties?.params === void 0 || !isObjectSchema(schema.properties.params) || !checkParamsSchema(schema.properties.params, dynamicParams))) {
|
|
410
|
+
throw new OpenAPIGeneratorError(
|
|
411
|
+
'When input structure is "detailed" and path has dynamic params, the "params" schema must be an object with all dynamic params as required.'
|
|
412
|
+
);
|
|
413
|
+
}
|
|
414
|
+
for (const from of ["params", "query", "headers"]) {
|
|
415
|
+
const fromSchema = schema.properties?.[from];
|
|
416
|
+
if (fromSchema !== void 0) {
|
|
417
|
+
if (!isObjectSchema(fromSchema)) {
|
|
418
|
+
throw error;
|
|
419
|
+
}
|
|
420
|
+
const parameterIn = from === "params" ? "path" : from === "headers" ? "header" : "query";
|
|
421
|
+
ref.parameters ??= [];
|
|
422
|
+
ref.parameters.push(...toOpenAPIParameters(fromSchema, parameterIn));
|
|
423
|
+
}
|
|
424
|
+
}
|
|
425
|
+
if (schema.properties?.body !== void 0) {
|
|
426
|
+
ref.requestBody = {
|
|
427
|
+
required: schema.required?.includes("body"),
|
|
428
|
+
content: toOpenAPIContent(schema.properties.body)
|
|
429
|
+
};
|
|
430
|
+
}
|
|
431
|
+
}
|
|
432
|
+
#successResponse(ref, def) {
|
|
433
|
+
const outputSchema = def.outputSchema;
|
|
434
|
+
const status = fallbackContractConfig("defaultSuccessStatus", def.route.successStatus);
|
|
435
|
+
const description = fallbackContractConfig("defaultSuccessDescription", def.route?.successDescription);
|
|
436
|
+
const eventIteratorSchemaDetails = getEventIteratorSchemaDetails(outputSchema);
|
|
437
|
+
const outputStructure = fallbackContractConfig("defaultOutputStructure", def.route.outputStructure);
|
|
438
|
+
if (eventIteratorSchemaDetails) {
|
|
439
|
+
ref.responses ??= {};
|
|
440
|
+
ref.responses[status] = {
|
|
441
|
+
description,
|
|
442
|
+
content: toOpenAPIEventIteratorContent(
|
|
443
|
+
this.converter.convert(eventIteratorSchemaDetails.yields, { strategy: "output" }),
|
|
444
|
+
this.converter.convert(eventIteratorSchemaDetails.returns, { strategy: "output" })
|
|
445
|
+
)
|
|
446
|
+
};
|
|
447
|
+
return;
|
|
448
|
+
}
|
|
449
|
+
const [required, json] = this.converter.convert(outputSchema, { strategy: "output" });
|
|
450
|
+
ref.responses ??= {};
|
|
451
|
+
ref.responses[status] = {
|
|
452
|
+
description
|
|
453
|
+
};
|
|
454
|
+
if (outputStructure === "compact") {
|
|
455
|
+
ref.responses[status].content = toOpenAPIContent(applySchemaOptionality(required, json));
|
|
456
|
+
return;
|
|
457
|
+
}
|
|
458
|
+
const error = new OpenAPIGeneratorError(
|
|
459
|
+
'When output structure is "detailed", output schema must satisfy: { headers?: Record<string, unknown>, body?: unknown }'
|
|
460
|
+
);
|
|
461
|
+
if (!isObjectSchema(json)) {
|
|
462
|
+
throw error;
|
|
463
|
+
}
|
|
464
|
+
if (json.properties?.headers !== void 0) {
|
|
465
|
+
if (!isObjectSchema(json.properties.headers)) {
|
|
466
|
+
throw error;
|
|
467
|
+
}
|
|
468
|
+
for (const key in json.properties.headers.properties) {
|
|
469
|
+
ref.responses[status].headers ??= {};
|
|
470
|
+
ref.responses[status].headers[key] = {
|
|
471
|
+
schema: toOpenAPISchema(json.properties.headers.properties[key]),
|
|
472
|
+
required: json.properties.headers.required?.includes(key)
|
|
473
|
+
};
|
|
474
|
+
}
|
|
475
|
+
}
|
|
476
|
+
if (json.properties?.body !== void 0) {
|
|
477
|
+
ref.responses[status].content = toOpenAPIContent(
|
|
478
|
+
applySchemaOptionality(json.required?.includes("body") ?? false, json.properties.body)
|
|
479
|
+
);
|
|
480
|
+
}
|
|
481
|
+
}
|
|
482
|
+
#errorResponse(ref, def) {
|
|
483
|
+
const errorMap = def.errorMap;
|
|
484
|
+
const errors = {};
|
|
485
|
+
for (const code in errorMap) {
|
|
486
|
+
const config = errorMap[code];
|
|
487
|
+
if (!config) {
|
|
488
|
+
continue;
|
|
489
|
+
}
|
|
490
|
+
const status = fallbackORPCErrorStatus(code, config.status);
|
|
491
|
+
const message = fallbackORPCErrorMessage(code, config.message);
|
|
492
|
+
const [dataRequired, dataSchema] = this.converter.convert(config.data, { strategy: "output" });
|
|
493
|
+
errors[status] ??= [];
|
|
494
|
+
errors[status].push({
|
|
495
|
+
type: "object",
|
|
496
|
+
properties: {
|
|
497
|
+
defined: { const: true },
|
|
498
|
+
code: { const: code },
|
|
499
|
+
status: { const: status },
|
|
500
|
+
message: { type: "string", default: message },
|
|
501
|
+
data: dataSchema
|
|
502
|
+
},
|
|
503
|
+
required: dataRequired ? ["defined", "code", "status", "message", "data"] : ["defined", "code", "status", "message"]
|
|
504
|
+
});
|
|
505
|
+
}
|
|
506
|
+
ref.responses ??= {};
|
|
507
|
+
for (const status in errors) {
|
|
508
|
+
const schemas = errors[status];
|
|
509
|
+
ref.responses[status] = {
|
|
510
|
+
description: status,
|
|
511
|
+
content: toOpenAPIContent({
|
|
512
|
+
oneOf: [
|
|
513
|
+
...schemas,
|
|
514
|
+
{
|
|
515
|
+
type: "object",
|
|
516
|
+
properties: {
|
|
517
|
+
defined: { const: false },
|
|
518
|
+
code: { type: "string" },
|
|
519
|
+
status: { type: "number" },
|
|
520
|
+
message: { type: "string" },
|
|
521
|
+
data: {}
|
|
522
|
+
},
|
|
523
|
+
required: ["defined", "code", "status", "message"]
|
|
524
|
+
}
|
|
525
|
+
]
|
|
526
|
+
})
|
|
527
|
+
};
|
|
528
|
+
}
|
|
529
|
+
}
|
|
530
|
+
}
|
|
531
|
+
|
|
532
|
+
const oo = {
|
|
533
|
+
spec: customOpenAPIOperation
|
|
534
|
+
};
|
|
535
|
+
|
|
536
|
+
export { CompositeSchemaConverter, LOGIC_KEYWORDS, OpenAPIGenerator, applyCustomOpenAPIOperation, applySchemaOptionality, checkParamsSchema, customOpenAPIOperation, filterSchemaBranches, getCustomOpenAPIOperation, isAnySchema, isFileSchema, isObjectSchema, oo, separateObjectSchema, toOpenAPIContent, toOpenAPIEventIteratorContent, toOpenAPIMethod, toOpenAPIParameters, toOpenAPIPath, toOpenAPISchema };
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import { StandardOpenAPIJsonSerializer, StandardBracketNotationSerializer, StandardOpenAPISerializer } from '@orpc/openapi-client/standard';
|
|
2
|
+
import { FetchHandler } from '@orpc/server/fetch';
|
|
3
|
+
import { StandardHandler } from '@orpc/server/standard';
|
|
4
|
+
import { a as StandardOpenAPIMatcher, S as StandardOpenAPICodec } from './openapi.sdeu0I7N.mjs';
|
|
5
|
+
|
|
6
|
+
class OpenAPIHandler extends FetchHandler {
|
|
7
|
+
constructor(router, options = {}) {
|
|
8
|
+
const jsonSerializer = new StandardOpenAPIJsonSerializer(options);
|
|
9
|
+
const bracketNotationSerializer = new StandardBracketNotationSerializer();
|
|
10
|
+
const serializer = new StandardOpenAPISerializer(jsonSerializer, bracketNotationSerializer);
|
|
11
|
+
const matcher = new StandardOpenAPIMatcher();
|
|
12
|
+
const codec = new StandardOpenAPICodec(serializer);
|
|
13
|
+
super(new StandardHandler(router, matcher, codec, options), options);
|
|
14
|
+
}
|
|
15
|
+
}
|
|
16
|
+
|
|
17
|
+
export { OpenAPIHandler as O };
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import { StandardOpenAPIJsonSerializerOptions } from '@orpc/openapi-client/standard';
|
|
2
|
+
import { Context } from '@orpc/server';
|
|
3
|
+
import { StandardHandlerOptions } from '@orpc/server/standard';
|
|
4
|
+
|
|
5
|
+
interface StandardOpenAPIHandlerOptions<T extends Context> extends StandardHandlerOptions<T>, StandardOpenAPIJsonSerializerOptions {
|
|
6
|
+
}
|
|
7
|
+
|
|
8
|
+
export type { StandardOpenAPIHandlerOptions as S };
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import { StandardOpenAPIJsonSerializerOptions } from '@orpc/openapi-client/standard';
|
|
2
|
+
import { Context } from '@orpc/server';
|
|
3
|
+
import { StandardHandlerOptions } from '@orpc/server/standard';
|
|
4
|
+
|
|
5
|
+
interface StandardOpenAPIHandlerOptions<T extends Context> extends StandardHandlerOptions<T>, StandardOpenAPIJsonSerializerOptions {
|
|
6
|
+
}
|
|
7
|
+
|
|
8
|
+
export type { StandardOpenAPIHandlerOptions as S };
|
|
@@ -1,13 +1,12 @@
|
|
|
1
|
-
import {
|
|
2
|
-
|
|
3
|
-
} from
|
|
1
|
+
import { fallbackContractConfig } from '@orpc/contract';
|
|
2
|
+
import { isObject } from '@orpc/shared';
|
|
3
|
+
import { toHttpPath } from '@orpc/client/standard';
|
|
4
|
+
import { traverseContractProcedures, isProcedure, getLazyMeta, unlazy, getRouter, createContractedProcedure } from '@orpc/server';
|
|
5
|
+
import { createRouter, addRoute, findRoute } from 'rou3';
|
|
6
|
+
import { standardizeHTTPPath } from '@orpc/openapi-client/standard';
|
|
4
7
|
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
import { fallbackContractConfig } from "@orpc/contract";
|
|
8
|
-
import { isObject } from "@orpc/shared";
|
|
9
|
-
var OpenAPICodec = class {
|
|
10
|
-
constructor(serializer = new OpenAPISerializer()) {
|
|
8
|
+
class StandardOpenAPICodec {
|
|
9
|
+
constructor(serializer) {
|
|
11
10
|
this.serializer = serializer;
|
|
12
11
|
}
|
|
13
12
|
async decode(request, params, procedure) {
|
|
@@ -67,25 +66,25 @@ var OpenAPICodec = class {
|
|
|
67
66
|
return {
|
|
68
67
|
status: error.status,
|
|
69
68
|
headers: {},
|
|
70
|
-
body: this.serializer.serialize(error.toJSON())
|
|
69
|
+
body: this.serializer.serialize(error.toJSON(), { outputFormat: "plain" })
|
|
71
70
|
};
|
|
72
71
|
}
|
|
73
|
-
}
|
|
72
|
+
}
|
|
74
73
|
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
74
|
+
function toRou3Pattern(path) {
|
|
75
|
+
return standardizeHTTPPath(path).replace(/\/\{\+([^}]+)\}/g, "/**:$1").replace(/\/\{([^}]+)\}/g, "/:$1");
|
|
76
|
+
}
|
|
77
|
+
function decodeParams(params) {
|
|
78
|
+
return Object.fromEntries(Object.entries(params).map(([key, value]) => [key, decodeURIComponent(value)]));
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
class StandardOpenAPIMatcher {
|
|
80
82
|
tree = createRouter();
|
|
81
83
|
pendingRouters = [];
|
|
82
84
|
init(router, path = []) {
|
|
83
|
-
const laziedOptions =
|
|
84
|
-
|
|
85
|
-
path
|
|
86
|
-
}, ({ path: path2, contract }) => {
|
|
87
|
-
const method = fallbackContractConfig2("defaultMethod", contract["~orpc"].route.method);
|
|
88
|
-
const httpPath = contract["~orpc"].route.path ? toRou3Pattern(contract["~orpc"].route.path) : convertPathToHttpPath(path2);
|
|
85
|
+
const laziedOptions = traverseContractProcedures({ router, path }, ({ path: path2, contract }) => {
|
|
86
|
+
const method = fallbackContractConfig("defaultMethod", contract["~orpc"].route.method);
|
|
87
|
+
const httpPath = toRou3Pattern(contract["~orpc"].route.path ?? toHttpPath(path2));
|
|
89
88
|
if (isProcedure(contract)) {
|
|
90
89
|
addRoute(this.tree, method, httpPath, {
|
|
91
90
|
path: path2,
|
|
@@ -105,8 +104,8 @@ var OpenAPIMatcher = class {
|
|
|
105
104
|
});
|
|
106
105
|
this.pendingRouters.push(...laziedOptions.map((option) => ({
|
|
107
106
|
...option,
|
|
108
|
-
httpPathPrefix:
|
|
109
|
-
laziedPrefix:
|
|
107
|
+
httpPathPrefix: toHttpPath(option.path),
|
|
108
|
+
laziedPrefix: getLazyMeta(option.router).prefix
|
|
110
109
|
})));
|
|
111
110
|
}
|
|
112
111
|
async match(method, pathname) {
|
|
@@ -114,7 +113,7 @@ var OpenAPIMatcher = class {
|
|
|
114
113
|
const newPendingRouters = [];
|
|
115
114
|
for (const pendingRouter of this.pendingRouters) {
|
|
116
115
|
if (!pendingRouter.laziedPrefix || pathname.startsWith(pendingRouter.laziedPrefix) || pathname.startsWith(pendingRouter.httpPathPrefix)) {
|
|
117
|
-
const { default: router } = await unlazy(pendingRouter.
|
|
116
|
+
const { default: router } = await unlazy(pendingRouter.router);
|
|
118
117
|
this.init(router, pendingRouter.path);
|
|
119
118
|
} else {
|
|
120
119
|
newPendingRouters.push(pendingRouter);
|
|
@@ -127,14 +126,14 @@ var OpenAPIMatcher = class {
|
|
|
127
126
|
return void 0;
|
|
128
127
|
}
|
|
129
128
|
if (!match.data.procedure) {
|
|
130
|
-
const { default: maybeProcedure } = await unlazy(
|
|
129
|
+
const { default: maybeProcedure } = await unlazy(getRouter(match.data.router, match.data.path));
|
|
131
130
|
if (!isProcedure(maybeProcedure)) {
|
|
132
131
|
throw new Error(`
|
|
133
|
-
[Contract-First] Missing or invalid implementation for procedure at path: ${
|
|
132
|
+
[Contract-First] Missing or invalid implementation for procedure at path: ${toHttpPath(match.data.path)}.
|
|
134
133
|
Ensure that the procedure is correctly defined and matches the expected contract.
|
|
135
134
|
`);
|
|
136
135
|
}
|
|
137
|
-
match.data.procedure = createContractedProcedure(match.data.contract
|
|
136
|
+
match.data.procedure = createContractedProcedure(maybeProcedure, match.data.contract);
|
|
138
137
|
}
|
|
139
138
|
return {
|
|
140
139
|
path: match.data.path,
|
|
@@ -142,16 +141,6 @@ var OpenAPIMatcher = class {
|
|
|
142
141
|
params: match.params ? decodeParams(match.params) : void 0
|
|
143
142
|
};
|
|
144
143
|
}
|
|
145
|
-
};
|
|
146
|
-
function toRou3Pattern(path) {
|
|
147
|
-
return standardizeHTTPPath(path).replace(/\{\+([^}]+)\}/g, "**:$1").replace(/\{([^}]+)\}/g, ":$1");
|
|
148
|
-
}
|
|
149
|
-
function decodeParams(params) {
|
|
150
|
-
return Object.fromEntries(Object.entries(params).map(([key, value]) => [key, decodeURIComponent(value)]));
|
|
151
144
|
}
|
|
152
145
|
|
|
153
|
-
export {
|
|
154
|
-
OpenAPICodec,
|
|
155
|
-
OpenAPIMatcher
|
|
156
|
-
};
|
|
157
|
-
//# sourceMappingURL=chunk-PGCWJMRO.js.map
|
|
146
|
+
export { StandardOpenAPICodec as S, StandardOpenAPIMatcher as a, decodeParams as d, toRou3Pattern as t };
|