@celljs/openapi 0.0.0-stage → 4.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (116) hide show
  1. package/README.md +85 -2
  2. package/cell.schema.json +41 -0
  3. package/cell.yml +12 -0
  4. package/esm/common/annotation.d.ts +60 -0
  5. package/esm/common/annotation.js +73 -0
  6. package/esm/common/annotation.js.map +1 -0
  7. package/esm/common/constants.d.ts +11 -0
  8. package/esm/common/constants.js +12 -0
  9. package/esm/common/constants.js.map +1 -0
  10. package/esm/common/index.d.ts +3 -0
  11. package/esm/common/index.js +4 -0
  12. package/esm/common/index.js.map +1 -0
  13. package/esm/common/openapi-protocol.d.ts +143 -0
  14. package/esm/common/openapi-protocol.js +2 -0
  15. package/esm/common/openapi-protocol.js.map +1 -0
  16. package/esm/node/index.d.ts +6 -0
  17. package/esm/node/index.js +7 -0
  18. package/esm/node/index.js.map +1 -0
  19. package/esm/node/module.d.ts +3 -0
  20. package/esm/node/module.js +4 -0
  21. package/esm/node/module.js.map +1 -0
  22. package/esm/node/openapi-document-provider.d.ts +39 -0
  23. package/esm/node/openapi-document-provider.js +310 -0
  24. package/esm/node/openapi-document-provider.js.map +1 -0
  25. package/esm/node/openapi-middleware.d.ts +17 -0
  26. package/esm/node/openapi-middleware.js +76 -0
  27. package/esm/node/openapi-middleware.js.map +1 -0
  28. package/esm/node/openapi-node-protocol.d.ts +7 -0
  29. package/esm/node/openapi-node-protocol.js +4 -0
  30. package/esm/node/openapi-node-protocol.js.map +1 -0
  31. package/esm/node/openapi-path-util.d.ts +10 -0
  32. package/esm/node/openapi-path-util.js +84 -0
  33. package/esm/node/openapi-path-util.js.map +1 -0
  34. package/esm/node/schema-builder.d.ts +39 -0
  35. package/esm/node/schema-builder.js +271 -0
  36. package/esm/node/schema-builder.js.map +1 -0
  37. package/esm/node/swagger-ui.d.ts +10 -0
  38. package/esm/node/swagger-ui.js +31 -0
  39. package/esm/node/swagger-ui.js.map +1 -0
  40. package/esm/package.json +3 -0
  41. package/lib/common/annotation.d.ts +61 -0
  42. package/lib/common/annotation.d.ts.map +1 -0
  43. package/lib/common/annotation.js +86 -0
  44. package/lib/common/annotation.js.map +1 -0
  45. package/lib/common/constants.d.ts +12 -0
  46. package/lib/common/constants.d.ts.map +1 -0
  47. package/lib/common/constants.js +15 -0
  48. package/lib/common/constants.js.map +1 -0
  49. package/lib/common/index.d.ts +4 -0
  50. package/lib/common/index.d.ts.map +1 -0
  51. package/lib/common/index.js +20 -0
  52. package/lib/common/index.js.map +1 -0
  53. package/lib/common/openapi-protocol.d.ts +144 -0
  54. package/lib/common/openapi-protocol.d.ts.map +1 -0
  55. package/lib/common/openapi-protocol.js +3 -0
  56. package/lib/common/openapi-protocol.js.map +1 -0
  57. package/lib/node/index.d.ts +7 -0
  58. package/lib/node/index.d.ts.map +1 -0
  59. package/lib/node/index.js +23 -0
  60. package/lib/node/index.js.map +1 -0
  61. package/lib/node/module.d.ts +4 -0
  62. package/lib/node/module.d.ts.map +1 -0
  63. package/lib/node/module.js +6 -0
  64. package/lib/node/module.js.map +1 -0
  65. package/lib/node/openapi-document-provider.d.ts +40 -0
  66. package/lib/node/openapi-document-provider.d.ts.map +1 -0
  67. package/lib/node/openapi-document-provider.js +313 -0
  68. package/lib/node/openapi-document-provider.js.map +1 -0
  69. package/lib/node/openapi-middleware.d.ts +18 -0
  70. package/lib/node/openapi-middleware.d.ts.map +1 -0
  71. package/lib/node/openapi-middleware.js +79 -0
  72. package/lib/node/openapi-middleware.js.map +1 -0
  73. package/lib/node/openapi-node-protocol.d.ts +8 -0
  74. package/lib/node/openapi-node-protocol.d.ts.map +1 -0
  75. package/lib/node/openapi-node-protocol.js +7 -0
  76. package/lib/node/openapi-node-protocol.js.map +1 -0
  77. package/lib/node/openapi-path-util.d.ts +11 -0
  78. package/lib/node/openapi-path-util.d.ts.map +1 -0
  79. package/lib/node/openapi-path-util.js +87 -0
  80. package/lib/node/openapi-path-util.js.map +1 -0
  81. package/lib/node/openapi.spec.d.ts +30 -0
  82. package/lib/node/openapi.spec.d.ts.map +1 -0
  83. package/lib/node/openapi.spec.js +268 -0
  84. package/lib/node/openapi.spec.js.map +1 -0
  85. package/lib/node/schema-builder.d.ts +40 -0
  86. package/lib/node/schema-builder.d.ts.map +1 -0
  87. package/lib/node/schema-builder.js +275 -0
  88. package/lib/node/schema-builder.js.map +1 -0
  89. package/lib/node/schema-builder.spec.d.ts +2 -0
  90. package/lib/node/schema-builder.spec.d.ts.map +1 -0
  91. package/lib/node/schema-builder.spec.js +143 -0
  92. package/lib/node/schema-builder.spec.js.map +1 -0
  93. package/lib/node/swagger-ui.d.ts +11 -0
  94. package/lib/node/swagger-ui.d.ts.map +1 -0
  95. package/lib/node/swagger-ui.js +34 -0
  96. package/lib/node/swagger-ui.js.map +1 -0
  97. package/lib/package.spec.d.ts +2 -0
  98. package/lib/package.spec.d.ts.map +1 -0
  99. package/lib/package.spec.js +7 -0
  100. package/lib/package.spec.js.map +1 -0
  101. package/package.json +78 -4
  102. package/src/common/annotation.ts +130 -0
  103. package/src/common/constants.ts +12 -0
  104. package/src/common/index.ts +3 -0
  105. package/src/common/openapi-protocol.ts +154 -0
  106. package/src/node/index.ts +6 -0
  107. package/src/node/module.ts +4 -0
  108. package/src/node/openapi-document-provider.ts +334 -0
  109. package/src/node/openapi-middleware.ts +59 -0
  110. package/src/node/openapi-node-protocol.ts +11 -0
  111. package/src/node/openapi-path-util.ts +75 -0
  112. package/src/node/openapi.spec.ts +219 -0
  113. package/src/node/schema-builder.spec.ts +124 -0
  114. package/src/node/schema-builder.ts +282 -0
  115. package/src/node/swagger-ui.ts +38 -0
  116. package/src/package.spec.ts +5 -0
@@ -0,0 +1,310 @@
1
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
2
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
3
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
4
+ else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
5
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
6
+ };
7
+ var __metadata = (this && this.__metadata) || function (k, v) {
8
+ if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
9
+ };
10
+ import { Autowired, Component, Value } from '@celljs/core';
11
+ import { RouteProvider } from '@celljs/mvc/lib/node';
12
+ import { DEFAULT_BEARER_SCHEME, OPENAPI_METADATA_KEY, } from '../common/index.js';
13
+ import { OpenApiDocumentProvider } from './openapi-node-protocol.js';
14
+ import { OpenApiPathUtil } from './openapi-path-util.js';
15
+ import { SchemaBuilder, SchemaUtil } from './schema-builder.js';
16
+ const METHOD_ORDER = ['get', 'post', 'put', 'patch', 'delete', 'head', 'options', 'trace'];
17
+ const STATUS_DESCRIPTIONS = {
18
+ 200: 'OK',
19
+ 201: 'Created',
20
+ 202: 'Accepted',
21
+ 204: 'No Content',
22
+ 301: 'Moved Permanently',
23
+ 302: 'Found',
24
+ 304: 'Not Modified',
25
+ 400: 'Bad Request',
26
+ 401: 'Unauthorized',
27
+ 403: 'Forbidden',
28
+ 404: 'Not Found',
29
+ 409: 'Conflict',
30
+ 422: 'Unprocessable Entity',
31
+ 429: 'Too Many Requests',
32
+ 500: 'Internal Server Error',
33
+ default: 'Unexpected error',
34
+ };
35
+ const VIEW_CONTENT_TYPES = {
36
+ json: 'application/json',
37
+ text: 'text/plain',
38
+ html: 'text/html',
39
+ file: 'application/octet-stream',
40
+ };
41
+ /** Types that are not classes of the application. */
42
+ const BUILT_IN_TYPES = [String, Number, Boolean, Date, Object, Array, Promise, Function, Symbol];
43
+ /**
44
+ * Builds the OpenAPI document from the routes of `@celljs/mvc` (the same metadata that serves the requests)
45
+ * and the `@Api*` decorators; `openapi.document` is merged over it.
46
+ */
47
+ let OpenApiDocumentProviderImpl = class OpenApiDocumentProviderImpl {
48
+ provide() {
49
+ if (!this.document) {
50
+ this.document = this.routeProvider.provide().then(route => this.build(route));
51
+ }
52
+ return this.document;
53
+ }
54
+ build(route) {
55
+ var _a, _b, _c;
56
+ const base = ((_a = this.options) === null || _a === void 0 ? void 0 : _a.document) || {};
57
+ const schemas = new SchemaBuilder();
58
+ const routes = [];
59
+ for (const [method, metadatas] of route.mapping) {
60
+ for (const metadata of metadatas) {
61
+ if (typeof metadata.path === 'string' && !this.isExcluded(metadata)) {
62
+ routes.push({ method: method.toLowerCase(), pattern: metadata.path, operation: this.buildOperation(metadata, schemas) });
63
+ }
64
+ }
65
+ }
66
+ const paths = this.buildPaths(routes);
67
+ const securitySchemes = { ...(_b = base.components) === null || _b === void 0 ? void 0 : _b.securitySchemes };
68
+ if (this.usesScheme(paths, DEFAULT_BEARER_SCHEME) && !securitySchemes[DEFAULT_BEARER_SCHEME]) {
69
+ securitySchemes[DEFAULT_BEARER_SCHEME] = { type: 'http', scheme: 'bearer', bearerFormat: 'JWT' };
70
+ }
71
+ const components = { ...base.components, schemas: { ...schemas.schemas, ...(_c = base.components) === null || _c === void 0 ? void 0 : _c.schemas }, securitySchemes };
72
+ for (const key of ['schemas', 'securitySchemes']) {
73
+ if (!Object.keys(components[key]).length) {
74
+ delete components[key];
75
+ }
76
+ }
77
+ const document = {
78
+ ...base,
79
+ openapi: base.openapi || '3.0.3',
80
+ info: { title: 'API', version: '1.0.0', ...base.info },
81
+ paths: { ...paths, ...base.paths },
82
+ };
83
+ if (Object.keys(components).length) {
84
+ document.components = components;
85
+ }
86
+ return document;
87
+ }
88
+ /** Places the operations under their OpenAPI paths, sorted by path then by method; operation ids stay unique. */
89
+ buildPaths(routes) {
90
+ const items = {};
91
+ const operationIds = new Set();
92
+ for (const { method, pattern, operation } of routes) {
93
+ for (const expanded of OpenApiPathUtil.expand(pattern)) {
94
+ const { path, names } = OpenApiPathUtil.convert(expanded);
95
+ items[path] = items[path] || {};
96
+ const item = items[path];
97
+ if (item[method]) {
98
+ continue;
99
+ }
100
+ item[method] = this.withPathParameters({ ...operation }, names, operationIds);
101
+ }
102
+ }
103
+ const sorted = {};
104
+ for (const path of Object.keys(items).sort()) {
105
+ sorted[path] = {};
106
+ for (const method of Object.keys(items[path]).sort((a, b) => METHOD_ORDER.indexOf(a) - METHOD_ORDER.indexOf(b))) {
107
+ sorted[path][method] = items[path][method];
108
+ }
109
+ }
110
+ return sorted;
111
+ }
112
+ /** Keeps the path parameters of this path (optional parts differ), adds the undeclared ones as strings. */
113
+ withPathParameters(operation, names, operationIds) {
114
+ const declared = operation.parameters || [];
115
+ const parameters = declared.filter(p => p.in !== 'path' || names.includes(p.name));
116
+ for (const name of names) {
117
+ if (!parameters.some(p => p.in === 'path' && p.name === name)) {
118
+ parameters.push({ name, in: 'path', required: true, schema: { type: 'string' } });
119
+ }
120
+ }
121
+ parameters.sort((a, b) => Number(b.in === 'path') - Number(a.in === 'path'));
122
+ if (parameters.length) {
123
+ operation.parameters = parameters;
124
+ }
125
+ else {
126
+ delete operation.parameters;
127
+ }
128
+ if (operation.operationId) {
129
+ let id = operation.operationId;
130
+ for (let i = 2; operationIds.has(id); i++) {
131
+ id = `${operation.operationId}_${i}`;
132
+ }
133
+ operationIds.add(id);
134
+ operation.operationId = id;
135
+ }
136
+ return operation;
137
+ }
138
+ buildOperation(metadata, schemas) {
139
+ const target = metadata.controllerMetadata.target;
140
+ const key = metadata.methodMetadata.key;
141
+ const options = this.getMetadata(OPENAPI_METADATA_KEY.operation, target, key) || {};
142
+ const tags = this.getMetadata(OPENAPI_METADATA_KEY.tags, target, key) ||
143
+ this.getMetadata(OPENAPI_METADATA_KEY.tags, target) || [target.name.replace(/Controller$/, '') || target.name];
144
+ const operation = {
145
+ tags,
146
+ summary: options.summary,
147
+ description: options.description,
148
+ operationId: options.operationId || `${target.name}_${key.toString()}`,
149
+ parameters: this.buildParameters(metadata, schemas),
150
+ requestBody: this.buildRequestBody(metadata, schemas),
151
+ responses: this.buildResponses(metadata, schemas),
152
+ deprecated: options.deprecated,
153
+ security: this.getMetadata(OPENAPI_METADATA_KEY.security, target, key) || this.getMetadata(OPENAPI_METADATA_KEY.security, target),
154
+ };
155
+ for (const name of Object.keys(operation)) {
156
+ if (operation[name] === undefined) {
157
+ delete operation[name];
158
+ }
159
+ }
160
+ return operation;
161
+ }
162
+ buildParameters(metadata, schemas) {
163
+ const types = this.parameterTypes(metadata);
164
+ const parameters = [];
165
+ const add = (location, list = []) => {
166
+ var _a;
167
+ for (const { name, parameterIndex } of list) {
168
+ const type = types[parameterIndex];
169
+ if (name) {
170
+ parameters.push({ name, in: location, required: location === 'path' || undefined, schema: this.scalarSchema(schemas.resolve(type)) });
171
+ }
172
+ else if (location === 'query' && this.isClass(type)) {
173
+ // `@Query() filter: Filter`: the properties of the class are the query parameters.
174
+ const schema = schemas.build(type);
175
+ for (const [property, propertySchema] of Object.entries(schema.properties || {})) {
176
+ const { description, example, deprecated, ...rest } = propertySchema;
177
+ const required = ((_a = schema.required) === null || _a === void 0 ? void 0 : _a.includes(property)) || undefined;
178
+ parameters.push({ name: property, in: 'query', description, required, deprecated, example, schema: rest });
179
+ }
180
+ }
181
+ }
182
+ };
183
+ add('path', metadata.paramMetadata);
184
+ add('query', metadata.queryMetadata);
185
+ add('header', metadata.requestHeaderMetadata);
186
+ add('cookie', metadata.requestCookieMetadata);
187
+ const explicit = this.getMetadata(OPENAPI_METADATA_KEY.parameters, metadata.controllerMetadata.target, this.methodKey(metadata)) || [];
188
+ for (const { name, in: location, description, example, deprecated, ...schemaOptions } of explicit) {
189
+ const index = parameters.findIndex(p => p.name === name && p.in === location);
190
+ const found = index === -1 ? { name, in: location, schema: { type: 'string' } } : parameters[index];
191
+ const { required } = schemaOptions;
192
+ const parameter = {
193
+ ...found,
194
+ description: description !== null && description !== void 0 ? description : found.description,
195
+ required: location === 'path' ? true : (required !== null && required !== void 0 ? required : found.required),
196
+ deprecated: deprecated !== null && deprecated !== void 0 ? deprecated : found.deprecated,
197
+ example: example !== null && example !== void 0 ? example : found.example,
198
+ schema: SchemaUtil.normalize(schemas.fromOptions(schemaOptions, found.schema)),
199
+ };
200
+ if (index === -1) {
201
+ parameters.push(parameter);
202
+ }
203
+ else {
204
+ parameters[index] = parameter;
205
+ }
206
+ }
207
+ for (const parameter of parameters) {
208
+ for (const field of ['description', 'required', 'deprecated', 'example']) {
209
+ if (parameter[field] === undefined) {
210
+ delete parameter[field];
211
+ }
212
+ }
213
+ }
214
+ return parameters;
215
+ }
216
+ buildRequestBody(metadata, schemas) {
217
+ const bodies = metadata.bodyMetadata || [];
218
+ if (!bodies.length) {
219
+ return undefined;
220
+ }
221
+ const types = this.parameterTypes(metadata);
222
+ const whole = bodies.find(body => !body.name);
223
+ let schema;
224
+ if (whole) {
225
+ schema = schemas.resolve(types[whole.parameterIndex]) || { type: 'object' };
226
+ }
227
+ else {
228
+ const properties = {};
229
+ for (const { name, parameterIndex } of bodies) {
230
+ properties[name] = schemas.resolve(types[parameterIndex]) || {};
231
+ }
232
+ schema = { type: 'object', properties, required: Object.keys(properties) };
233
+ }
234
+ return { required: true, content: { 'application/json': { schema } } };
235
+ }
236
+ buildResponses(metadata, schemas) {
237
+ var _a;
238
+ var _b;
239
+ const target = metadata.controllerMetadata.target;
240
+ const key = this.methodKey(metadata);
241
+ const contentType = VIEW_CONTENT_TYPES[((_a = metadata.viewMetadata) === null || _a === void 0 ? void 0 : _a.viewName) || this.defaultViewName] || VIEW_CONTENT_TYPES.json;
242
+ const declared = [
243
+ ...(this.getMetadata(OPENAPI_METADATA_KEY.responses, target) || []),
244
+ ...(this.getMetadata(OPENAPI_METADATA_KEY.responses, target, key) || []),
245
+ ];
246
+ const responses = {};
247
+ for (const options of declared) {
248
+ const status = String((_b = options.status) !== null && _b !== void 0 ? _b : 200);
249
+ const response = { description: options.description || STATUS_DESCRIPTIONS[status] || 'Response' };
250
+ const schema = options.schema || schemas.resolve(options.type);
251
+ if (schema) {
252
+ response.content = { [options.contentType || contentType]: { schema } };
253
+ }
254
+ responses[status] = response;
255
+ }
256
+ if (!Object.keys(responses).some(status => status.startsWith('2'))) {
257
+ const returnType = Reflect.getMetadata('design:returntype', target.prototype, key);
258
+ const response = { description: 'OK' };
259
+ if (returnType !== undefined) {
260
+ const schema = contentType === VIEW_CONTENT_TYPES.text ? { type: 'string' } : schemas.resolve(returnType);
261
+ response.content = { [contentType]: schema ? { schema } : {} };
262
+ }
263
+ responses['200'] = response;
264
+ }
265
+ return Object.fromEntries(Object.entries(responses).sort(([a], [b]) => a.localeCompare(b)));
266
+ }
267
+ isExcluded(metadata) {
268
+ const target = metadata.controllerMetadata.target;
269
+ return !!(this.getMetadata(OPENAPI_METADATA_KEY.exclude, target) || this.getMetadata(OPENAPI_METADATA_KEY.exclude, target, this.methodKey(metadata)));
270
+ }
271
+ usesScheme(paths, scheme) {
272
+ return Object.values(paths).some(item => Object.values(item).some(operation => (operation.security || []).some((requirement) => scheme in requirement)));
273
+ }
274
+ /** Path, query, header and cookie values are strings on the wire; a class or `any` there is documented as one. */
275
+ scalarSchema(schema) {
276
+ if (!schema || schema.$ref || schema.type === 'object') {
277
+ return { type: 'string' };
278
+ }
279
+ return schema;
280
+ }
281
+ isClass(type) {
282
+ return typeof type === 'function' && !BUILT_IN_TYPES.includes(type);
283
+ }
284
+ parameterTypes(metadata) {
285
+ return Reflect.getMetadata('design:paramtypes', metadata.controllerMetadata.target.prototype, this.methodKey(metadata)) || [];
286
+ }
287
+ methodKey(metadata) {
288
+ return metadata.methodMetadata.key;
289
+ }
290
+ getMetadata(key, target, propertyKey) {
291
+ return propertyKey === undefined ? Reflect.getMetadata(key, target) : Reflect.getMetadata(key, target, propertyKey);
292
+ }
293
+ };
294
+ __decorate([
295
+ Autowired(RouteProvider),
296
+ __metadata("design:type", Object)
297
+ ], OpenApiDocumentProviderImpl.prototype, "routeProvider", void 0);
298
+ __decorate([
299
+ Value('openapi'),
300
+ __metadata("design:type", Object)
301
+ ], OpenApiDocumentProviderImpl.prototype, "options", void 0);
302
+ __decorate([
303
+ Value('mvc.defaultViewName'),
304
+ __metadata("design:type", String)
305
+ ], OpenApiDocumentProviderImpl.prototype, "defaultViewName", void 0);
306
+ OpenApiDocumentProviderImpl = __decorate([
307
+ Component(OpenApiDocumentProvider)
308
+ ], OpenApiDocumentProviderImpl);
309
+ export { OpenApiDocumentProviderImpl };
310
+ //# sourceMappingURL=openapi-document-provider.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"openapi-document-provider.js","sourceRoot":"","sources":["../../src/node/openapi-document-provider.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,17 @@
1
+ import { PathResolver } from '@celljs/web';
2
+ import { type Context, Middleware, RequestMatcher } from '@celljs/web/lib/node';
3
+ import type { OpenApiOptions } from '../common/index.js';
4
+ import { OpenApiDocumentProvider } from './openapi-node-protocol.js';
5
+ /**
6
+ * Serves the document (`openapi.url`) and the Swagger UI page (`openapi.ui.url`) for GET requests
7
+ * that no controller answered, so it costs nothing to the other requests.
8
+ */
9
+ export declare class OpenApiMiddleware implements Middleware {
10
+ protected readonly documentProvider: OpenApiDocumentProvider;
11
+ protected readonly requestMatcher: RequestMatcher;
12
+ protected readonly pathResolver: PathResolver;
13
+ protected readonly options: OpenApiOptions;
14
+ readonly priority: number;
15
+ handle(ctx: Context, next: () => Promise<void>): Promise<void>;
16
+ protected serve({ response }: Context): Promise<boolean>;
17
+ }
@@ -0,0 +1,76 @@
1
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
2
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
3
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
4
+ else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
5
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
6
+ };
7
+ var __metadata = (this && this.__metadata) || function (k, v) {
8
+ if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
9
+ };
10
+ import { Autowired, Component, Value } from '@celljs/core';
11
+ import { HttpHeaders, MediaType } from '@celljs/http';
12
+ import { PathResolver } from '@celljs/web';
13
+ import { Middleware, NotFoundError, RequestMatcher } from '@celljs/web/lib/node';
14
+ import { OPENAPI_MIDDLEWARE_PRIORITY, OpenApiDocumentProvider } from './openapi-node-protocol.js';
15
+ import { SwaggerUiUtil } from './swagger-ui.js';
16
+ /**
17
+ * Serves the document (`openapi.url`) and the Swagger UI page (`openapi.ui.url`) for GET requests
18
+ * that no controller answered, so it costs nothing to the other requests.
19
+ */
20
+ let OpenApiMiddleware = class OpenApiMiddleware {
21
+ constructor() {
22
+ this.priority = OPENAPI_MIDDLEWARE_PRIORITY;
23
+ }
24
+ async handle(ctx, next) {
25
+ var _a;
26
+ try {
27
+ await next();
28
+ }
29
+ catch (error) {
30
+ if (error instanceof NotFoundError && !ctx.response.writableEnded && ((_a = this.options) === null || _a === void 0 ? void 0 : _a.enabled) !== false && (await this.serve(ctx))) {
31
+ return;
32
+ }
33
+ throw error;
34
+ }
35
+ }
36
+ async serve({ response }) {
37
+ const url = await this.pathResolver.resolve(this.options.url);
38
+ if (await this.requestMatcher.match(url, 'GET')) {
39
+ const document = await this.documentProvider.provide();
40
+ response.statusCode = 200;
41
+ response.setHeader(HttpHeaders.CONTENT_TYPE, MediaType.APPLICATION_JSON_UTF8);
42
+ response.body = JSON.stringify(document);
43
+ return true;
44
+ }
45
+ const { ui } = this.options;
46
+ if ((ui === null || ui === void 0 ? void 0 : ui.enabled) !== false && (ui === null || ui === void 0 ? void 0 : ui.url) && (await this.requestMatcher.match(await this.pathResolver.resolve(ui.url), 'GET'))) {
47
+ const document = await this.documentProvider.provide();
48
+ response.statusCode = 200;
49
+ response.setHeader(HttpHeaders.CONTENT_TYPE, `${MediaType.TEXT_HTML};charset=UTF-8`);
50
+ response.body = SwaggerUiUtil.render({ title: document.info.title, url, cdn: ui.cdn });
51
+ return true;
52
+ }
53
+ return false;
54
+ }
55
+ };
56
+ __decorate([
57
+ Autowired(OpenApiDocumentProvider),
58
+ __metadata("design:type", Object)
59
+ ], OpenApiMiddleware.prototype, "documentProvider", void 0);
60
+ __decorate([
61
+ Autowired(RequestMatcher),
62
+ __metadata("design:type", Object)
63
+ ], OpenApiMiddleware.prototype, "requestMatcher", void 0);
64
+ __decorate([
65
+ Autowired(PathResolver),
66
+ __metadata("design:type", Object)
67
+ ], OpenApiMiddleware.prototype, "pathResolver", void 0);
68
+ __decorate([
69
+ Value('openapi'),
70
+ __metadata("design:type", Object)
71
+ ], OpenApiMiddleware.prototype, "options", void 0);
72
+ OpenApiMiddleware = __decorate([
73
+ Component(Middleware)
74
+ ], OpenApiMiddleware);
75
+ export { OpenApiMiddleware };
76
+ //# sourceMappingURL=openapi-middleware.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"openapi-middleware.js","sourceRoot":"","sources":["../../src/node/openapi-middleware.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAgB,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE/F,OAAO,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAC/F,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C;;;GAGG;AAEI,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAAvB;QAaM,aAAQ,GAAG,2BAA2B,CAAC;IAgCpD,CAAC;IA9BG,KAAK,CAAC,MAAM,CAAC,GAAY,EAAE,IAAyB;;QAChD,IAAI,CAAC;YACD,MAAM,IAAI,EAAE,CAAC;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,KAAK,YAAY,aAAa,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,aAAa,IAAI,CAAA,MAAA,IAAI,CAAC,OAAO,0CAAE,OAAO,MAAK,KAAK,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBAC9H,OAAO;YACX,CAAC;YACD,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;IAES,KAAK,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAW;QACvC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9D,IAAI,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC;YAC9C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC;YACvD,QAAQ,CAAC,UAAU,GAAG,GAAG,CAAC;YAC1B,QAAQ,CAAC,SAAS,CAAC,WAAW,CAAC,YAAY,EAAE,SAAS,CAAC,qBAAqB,CAAC,CAAC;YAC9E,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YACzC,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,MAAM,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAA,EAAE,aAAF,EAAE,uBAAF,EAAE,CAAE,OAAO,MAAK,KAAK,KAAI,EAAE,aAAF,EAAE,uBAAF,EAAE,CAAE,GAAG,CAAA,IAAI,CAAC,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;YACxH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC;YACvD,QAAQ,CAAC,UAAU,GAAG,GAAG,CAAC;YAC1B,QAAQ,CAAC,SAAS,CAAC,WAAW,CAAC,YAAY,EAAE,GAAG,SAAS,CAAC,SAAS,gBAAgB,CAAC,CAAC;YACrF,QAAQ,CAAC,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;YACvF,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,OAAO,KAAK,CAAC;IACjB,CAAC;CACJ,CAAA;AA3CsB;IADlB,SAAS,CAAC,uBAAuB,CAAC;;2DAC0B;AAG1C;IADlB,SAAS,CAAC,cAAc,CAAC;;yDACwB;AAG/B;IADlB,SAAS,CAAC,YAAY,CAAC;;uDACsB;AAG3B;IADlB,KAAK,CAAC,SAAS,CAAC;;kDAC0B;AAXlC,iBAAiB;IAD7B,SAAS,CAAC,UAAU,CAAC;GACT,iBAAiB,CA6C7B"}
@@ -0,0 +1,7 @@
1
+ import type { OpenApiDocument } from '../common/index.js';
2
+ export declare const OpenApiDocumentProvider: unique symbol;
3
+ export declare const OPENAPI_MIDDLEWARE_PRIORITY: number;
4
+ export interface OpenApiDocumentProvider {
5
+ /** The document of the controllers of the application; built on the first call. */
6
+ provide(): Promise<OpenApiDocument>;
7
+ }
@@ -0,0 +1,4 @@
1
+ import { HEALTH_MIDDLEWARE_PRIORITY } from '@celljs/web/lib/node';
2
+ export const OpenApiDocumentProvider = Symbol('OpenApiDocumentProvider');
3
+ export const OPENAPI_MIDDLEWARE_PRIORITY = HEALTH_MIDDLEWARE_PRIORITY;
4
+ //# sourceMappingURL=openapi-node-protocol.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"openapi-node-protocol.js","sourceRoot":"","sources":["../../src/node/openapi-node-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAGlE,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAC;AAEzE,MAAM,CAAC,MAAM,2BAA2B,GAAG,0BAA0B,CAAC"}
@@ -0,0 +1,10 @@
1
+ /** Turns Cell route patterns (`/users/:id`, `/users(/:id)`, `/files/*`) into OpenAPI paths. */
2
+ export declare namespace OpenApiPathUtil {
3
+ /** One pattern per combination of its optional parts: `/users(/:id)` gives `/users` and `/users/:id`. */
4
+ function expand(pattern: string): string[];
5
+ /** `/users/:id` → `/users/{id}`; `*` is the parameter `_` (as in the values the route matcher gives). */
6
+ function convert(pattern: string): {
7
+ path: string;
8
+ names: string[];
9
+ };
10
+ }
@@ -0,0 +1,84 @@
1
+ const NAME = /^[a-zA-Z0-9]+/;
2
+ /** Turns Cell route patterns (`/users/:id`, `/users(/:id)`, `/files/*`) into OpenAPI paths. */
3
+ export var OpenApiPathUtil;
4
+ (function (OpenApiPathUtil) {
5
+ /** One pattern per combination of its optional parts: `/users(/:id)` gives `/users` and `/users/:id`. */
6
+ function expand(pattern) {
7
+ const start = indexOfUnescaped(pattern, '(');
8
+ if (start === -1) {
9
+ return [pattern];
10
+ }
11
+ let depth = 0;
12
+ let end = -1;
13
+ for (let i = start; i < pattern.length; i++) {
14
+ if (pattern[i] === '\\') {
15
+ i++;
16
+ }
17
+ else if (pattern[i] === '(') {
18
+ depth++;
19
+ }
20
+ else if (pattern[i] === ')' && --depth === 0) {
21
+ end = i;
22
+ break;
23
+ }
24
+ }
25
+ if (end === -1) {
26
+ return [pattern];
27
+ }
28
+ const prefix = pattern.slice(0, start);
29
+ const inner = expand(pattern.slice(start + 1, end));
30
+ const result = [];
31
+ for (const rest of expand(pattern.slice(end + 1))) {
32
+ result.push(prefix + rest);
33
+ for (const part of inner) {
34
+ result.push(prefix + part + rest);
35
+ }
36
+ }
37
+ return result;
38
+ }
39
+ OpenApiPathUtil.expand = expand;
40
+ /** `/users/:id` → `/users/{id}`; `*` is the parameter `_` (as in the values the route matcher gives). */
41
+ function convert(pattern) {
42
+ var _a;
43
+ var _b;
44
+ let path = '';
45
+ const names = [];
46
+ for (let i = 0; i < pattern.length; i++) {
47
+ const c = pattern[i];
48
+ if (c === '\\') {
49
+ path += (_b = pattern[++i]) !== null && _b !== void 0 ? _b : '';
50
+ }
51
+ else if (c === ':') {
52
+ const name = (_a = NAME.exec(pattern.slice(i + 1))) === null || _a === void 0 ? void 0 : _a[0];
53
+ if (!name) {
54
+ path += c;
55
+ continue;
56
+ }
57
+ path += `{${name}}`;
58
+ names.push(name);
59
+ i += name.length;
60
+ }
61
+ else if (c === '*') {
62
+ path += '{_}';
63
+ names.push('_');
64
+ }
65
+ else {
66
+ path += c;
67
+ }
68
+ }
69
+ return { path, names: [...new Set(names)] };
70
+ }
71
+ OpenApiPathUtil.convert = convert;
72
+ function indexOfUnescaped(text, char) {
73
+ for (let i = 0; i < text.length; i++) {
74
+ if (text[i] === '\\') {
75
+ i++;
76
+ }
77
+ else if (text[i] === char) {
78
+ return i;
79
+ }
80
+ }
81
+ return -1;
82
+ }
83
+ })(OpenApiPathUtil || (OpenApiPathUtil = {}));
84
+ //# sourceMappingURL=openapi-path-util.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"openapi-path-util.js","sourceRoot":"","sources":["../../src/node/openapi-path-util.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,39 @@
1
+ import { type ApiPropertyMetadata, type ApiPropertyOptions, type Constructor, type SchemaObject, type TypeRef } from '../common/index.js';
2
+ export declare namespace EnumUtil {
3
+ /** The values of a list or a TypeScript enum (without the reverse entries of numeric enums). */
4
+ function values(enumOrValues: any[] | Record<string, any>): any[];
5
+ }
6
+ /** The part of class-validator's metadata Cell reads; found on `globalThis`, so class-validator is not a dependency. */
7
+ interface ValidationMetadata {
8
+ type: string;
9
+ name?: string;
10
+ propertyName: string;
11
+ constraints?: any[];
12
+ each?: boolean;
13
+ }
14
+ export declare namespace ClassValidatorUtil {
15
+ function metadatas(target: Constructor): ValidationMetadata[];
16
+ }
17
+ /**
18
+ * Turns types into schemas; classes become `components.schemas` entries referred to by `$ref`.
19
+ * One instance builds one document.
20
+ */
21
+ export declare class SchemaBuilder {
22
+ readonly schemas: Record<string, SchemaObject>;
23
+ protected readonly names: Map<Constructor, string>;
24
+ /** The schema of a type, or undefined when the type says nothing (`Promise`, `void`). */
25
+ resolve(type: TypeRef | undefined): SchemaObject | undefined;
26
+ /** The schema of a class, inline: its properties from @ApiProperty and class-validator decorators. */
27
+ build(target: Constructor): SchemaObject;
28
+ /** Applies @ApiProperty-like options to the schema found from the TypeScript type. */
29
+ fromOptions(options: ApiPropertyOptions, found?: SchemaObject): SchemaObject;
30
+ protected designType(target: Constructor, key: string): SchemaObject;
31
+ /** @ApiProperty metadata of the class and its parents, parents first; a subclass entry replaces the parent's. */
32
+ protected apiProperties(target: Constructor): ApiPropertyMetadata[];
33
+ protected define(target: Constructor): string;
34
+ }
35
+ export declare namespace SchemaUtil {
36
+ /** OpenAPI 3.0 ignores the siblings of `$ref`: keep them by wrapping the reference in `allOf`. */
37
+ function normalize(schema: SchemaObject): SchemaObject;
38
+ }
39
+ export {};