nestjs-docfy 0.3.6 → 1.0.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.
- package/LICENSE +21 -0
- package/README.md +122 -67
- package/dist/apply-docfy-metadata.d.ts +37 -0
- package/dist/apply-docfy-metadata.js +55 -0
- package/dist/apply-docfy-metadata.js.map +1 -0
- package/dist/cli/build-openapi-patch.d.ts +16 -12
- package/dist/cli/build-openapi-patch.js +98 -15
- package/dist/cli/build-openapi-patch.js.map +1 -1
- package/dist/cli/check.js.map +1 -1
- package/dist/cli/coverage.js +1 -3
- package/dist/cli/coverage.js.map +1 -1
- package/dist/cli/detect-project.js +1 -5
- package/dist/cli/detect-project.js.map +1 -1
- package/dist/cli/errors.js.map +1 -1
- package/dist/cli/eval-decorator-args.d.ts +5 -3
- package/dist/cli/eval-decorator-args.js +64 -11
- package/dist/cli/eval-decorator-args.js.map +1 -1
- package/dist/cli/extract-docs-config.d.ts +21 -1
- package/dist/cli/extract-docs-config.js +18 -6
- package/dist/cli/extract-docs-config.js.map +1 -1
- package/dist/cli/extract-methods.d.ts +11 -0
- package/dist/cli/extract-methods.js +113 -29
- package/dist/cli/extract-methods.js.map +1 -1
- package/dist/cli/generate-file.js +24 -24
- package/dist/cli/generate-file.js.map +1 -1
- package/dist/cli/index.js +5 -6
- package/dist/cli/index.js.map +1 -1
- package/dist/cli/lint.js +1 -3
- package/dist/cli/lint.js.map +1 -1
- package/dist/cli/logger.js +12 -6
- package/dist/cli/logger.js.map +1 -1
- package/dist/cli/merge-docs.js.map +1 -1
- package/dist/cli/merge-spec-patch.d.ts +15 -8
- package/dist/cli/merge-spec-patch.js +20 -4
- package/dist/cli/merge-spec-patch.js.map +1 -1
- package/dist/cli/parse-args.js +2 -6
- package/dist/cli/parse-args.js.map +1 -1
- package/dist/cli/patch-spec.d.ts +32 -8
- package/dist/cli/patch-spec.js +37 -15
- package/dist/cli/patch-spec.js.map +1 -1
- package/dist/cli/resolve-tsconfig.js +1 -5
- package/dist/cli/resolve-tsconfig.js.map +1 -1
- package/dist/cli/scan-controllers.d.ts +11 -0
- package/dist/cli/scan-controllers.js +10 -3
- package/dist/cli/scan-controllers.js.map +1 -1
- package/dist/cli/watch.js +3 -1
- package/dist/cli/watch.js.map +1 -1
- package/dist/cli/writer.js.map +1 -1
- package/dist/docfy-ui.module.d.ts +26 -10
- package/dist/docfy-ui.module.js +42 -6
- package/dist/docfy-ui.module.js.map +1 -1
- package/dist/docfy.module.js +1 -1
- package/dist/docfy.module.js.map +1 -1
- package/dist/docs.js.map +1 -1
- package/dist/index.d.ts +2 -1
- package/dist/index.js +3 -1
- package/dist/index.js.map +1 -1
- package/dist/plugin/generate-metadata.d.ts +35 -0
- package/dist/plugin/generate-metadata.js +46 -0
- package/dist/plugin/generate-metadata.js.map +1 -0
- package/dist/plugin/index.d.ts +30 -0
- package/dist/plugin/index.js +62 -0
- package/dist/plugin/index.js.map +1 -0
- package/dist/registry.d.ts +3 -3
- package/dist/registry.js.map +1 -1
- package/dist/resolve-docs-path.d.ts +1 -1
- package/dist/resolve-docs-path.js.map +1 -1
- package/dist/resolve-source-from-stack.js.map +1 -1
- package/dist/with-docs.decorator.js.map +1 -1
- package/package.json +32 -3
- package/dist/require-ts.d.ts +0 -32
- package/dist/require-ts.js +0 -122
- package/dist/require-ts.js.map +0 -1
|
@@ -3,18 +3,40 @@ Object.defineProperty(exports, "__esModule", { value: true });
|
|
|
3
3
|
exports.buildOpenApiPatch = buildOpenApiPatch;
|
|
4
4
|
const eval_decorator_args_1 = require("./eval-decorator-args");
|
|
5
5
|
const HTTP_METHODS_OPENAPI = new Set(['get', 'post', 'put', 'patch', 'delete', 'head', 'options']);
|
|
6
|
+
/**
|
|
7
|
+
* Converts NestJS's Express-style route param syntax (`:id`) to OpenAPI's
|
|
8
|
+
* path templating syntax (`{id}`) — the format `@nestjs/swagger`'s generated
|
|
9
|
+
* base document actually uses for `paths` keys. Without this, patch-spec/the
|
|
10
|
+
* CLI plugin would compute a route key that never matches any parameterized
|
|
11
|
+
* route in the real document (`/users/:id` vs `/users/{id}`), silently
|
|
12
|
+
* dropping the patch for every such route rather than erroring loudly —
|
|
13
|
+
* exactly the kind of failure `unmatchedRoutes` exists to surface, except
|
|
14
|
+
* this bypassed it entirely by producing an internally-consistent but
|
|
15
|
+
* wrong key on both sides of the CLI's own tests.
|
|
16
|
+
*/
|
|
17
|
+
function toOpenApiPathParams(path) {
|
|
18
|
+
return path.replace(/:([A-Za-z0-9_]+)/g, '{$1}');
|
|
19
|
+
}
|
|
6
20
|
function joinPaths(controllerPath, methodPath) {
|
|
7
21
|
const a = (controllerPath ?? '').replace(/^\/+|\/+$/g, '');
|
|
8
22
|
const b = (methodPath ?? '').replace(/^\/+|\/+$/g, '');
|
|
9
23
|
const joined = [a, b].filter(Boolean).join('/');
|
|
10
|
-
return `/${joined}
|
|
24
|
+
return toOpenApiPathParams(`/${joined}`);
|
|
11
25
|
}
|
|
12
26
|
function schemaFromResponseType(info) {
|
|
13
27
|
if (!info)
|
|
14
28
|
return undefined;
|
|
29
|
+
if (info.unionMembers) {
|
|
30
|
+
const base = { oneOf: info.unionMembers.map((m) => schemaFromResponseType(m)) };
|
|
31
|
+
return info.isArray ? { type: 'array', items: base } : base;
|
|
32
|
+
}
|
|
15
33
|
const inline = info.classSchema ?? info.inlineSchema;
|
|
16
34
|
const base = inline
|
|
17
|
-
? {
|
|
35
|
+
? {
|
|
36
|
+
type: 'object',
|
|
37
|
+
properties: inline.properties,
|
|
38
|
+
...(inline.required.length ? { required: inline.required } : {}),
|
|
39
|
+
}
|
|
18
40
|
: { $ref: `#/components/schemas/${info.name}` };
|
|
19
41
|
return info.isArray ? { type: 'array', items: base } : base;
|
|
20
42
|
}
|
|
@@ -22,17 +44,43 @@ function findBodyResponseType(method) {
|
|
|
22
44
|
const bodyParam = method.params.find((p) => p.nestDecorator === '@Body' && p.bodyType);
|
|
23
45
|
return bodyParam?.bodyType ?? null;
|
|
24
46
|
}
|
|
47
|
+
/**
|
|
48
|
+
* True when `value` is itself Unresolved, or is an array/object containing an
|
|
49
|
+
* Unresolved marker anywhere inside it. A shallow check isn't enough here —
|
|
50
|
+
* `evaluateExpression` recurses into nested object/array literals, so a
|
|
51
|
+
* single non-literal sub-value (a variable, a function call) buried inside
|
|
52
|
+
* an otherwise-literal `schema`/`example` object still needs to bail the
|
|
53
|
+
* whole value rather than leak the internal `{ __unresolved, text }` marker
|
|
54
|
+
* shape into the emitted OpenAPI document as if it were real data.
|
|
55
|
+
*/
|
|
56
|
+
function containsUnresolved(value) {
|
|
57
|
+
if ((0, eval_decorator_args_1.isUnresolved)(value))
|
|
58
|
+
return true;
|
|
59
|
+
if (Array.isArray(value))
|
|
60
|
+
return value.some(containsUnresolved);
|
|
61
|
+
if (value !== null && typeof value === 'object')
|
|
62
|
+
return Object.values(value).some(containsUnresolved);
|
|
63
|
+
return false;
|
|
64
|
+
}
|
|
25
65
|
/** Resolves a schema for an ApiBody/ApiResponse `type`/`schema` argument value. */
|
|
26
66
|
function resolveSchemaArg(value, fallback) {
|
|
27
67
|
if (value === undefined)
|
|
28
68
|
return schemaFromResponseType(fallback);
|
|
29
|
-
if (
|
|
30
|
-
return schemaFromResponseType(fallback);
|
|
31
|
-
if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
|
|
69
|
+
if (typeof value === 'object' && value !== null && !Array.isArray(value) && !containsUnresolved(value)) {
|
|
32
70
|
return value;
|
|
33
71
|
}
|
|
34
72
|
return schemaFromResponseType(fallback);
|
|
35
73
|
}
|
|
74
|
+
/**
|
|
75
|
+
* Resolves an ApiResponse/ApiBody `example`/`examples` option to a plain
|
|
76
|
+
* literal value, or undefined if it's absent or contains any unresolved
|
|
77
|
+
* (non-literal) part — same "don't guess" rule as `resolveSchemaArg`.
|
|
78
|
+
*/
|
|
79
|
+
function literalValue(value) {
|
|
80
|
+
if (value === undefined || containsUnresolved(value))
|
|
81
|
+
return undefined;
|
|
82
|
+
return value;
|
|
83
|
+
}
|
|
36
84
|
function asRecord(value) {
|
|
37
85
|
if (value && typeof value === 'object' && !Array.isArray(value) && !(0, eval_decorator_args_1.isUnresolved)(value)) {
|
|
38
86
|
return value;
|
|
@@ -44,6 +92,20 @@ function plain(value) {
|
|
|
44
92
|
return undefined;
|
|
45
93
|
return value;
|
|
46
94
|
}
|
|
95
|
+
/**
|
|
96
|
+
* Extracts an ApiParam/ApiQuery/ApiHeader/ApiProperty `enum` option into an
|
|
97
|
+
* OpenAPI-ready array of string/number values. Handles both shapes that
|
|
98
|
+
* reach here as an already-evaluated array: a literal `enum: ['a', 'b']`
|
|
99
|
+
* and `enum: Role` (a TS enum reference resolved by eval-decorator-args to
|
|
100
|
+
* its member values). Anything else (unresolved, not an array, empty) is
|
|
101
|
+
* left out of the schema rather than guessed at.
|
|
102
|
+
*/
|
|
103
|
+
function enumSchemaValues(value) {
|
|
104
|
+
if (!Array.isArray(value))
|
|
105
|
+
return undefined;
|
|
106
|
+
const values = value.filter((v) => typeof v === 'string' || typeof v === 'number');
|
|
107
|
+
return values.length > 0 ? values : undefined;
|
|
108
|
+
}
|
|
47
109
|
/**
|
|
48
110
|
* Computes the OpenAPI fragment a controller's `.docs.ts` file represents,
|
|
49
111
|
* purely from statically-extracted data — no decorators are applied to any
|
|
@@ -51,12 +113,15 @@ function plain(value) {
|
|
|
51
113
|
*
|
|
52
114
|
* This intentionally does not aim for full parity with what `@nestjs/swagger`
|
|
53
115
|
* decorators would produce when actually applied (that's a much larger
|
|
54
|
-
* surface —
|
|
55
|
-
* the common path: tags,
|
|
56
|
-
*
|
|
57
|
-
*
|
|
58
|
-
*
|
|
59
|
-
*
|
|
116
|
+
* surface — links, callbacks, etc. that `@nestjs/swagger` itself doesn't
|
|
117
|
+
* expose a decorator option for anyway). It covers the common path: tags,
|
|
118
|
+
* operation summary/description, responses with a status + description +
|
|
119
|
+
* schema (including a `oneOf` when the return type or `@Body()` payload is a
|
|
120
|
+
* union of named DTOs) + example/examples, request bodies, bearer auth, and
|
|
121
|
+
* enum-valued params/headers — enough to validate that statically-computed
|
|
122
|
+
* patches can stand in for runtime decoration where the latter is
|
|
123
|
+
* structurally impossible (see the README's "Not supported: webpack: true"
|
|
124
|
+
* section).
|
|
60
125
|
*/
|
|
61
126
|
function buildOpenApiPatch(ctrl, config) {
|
|
62
127
|
const patch = {};
|
|
@@ -95,10 +160,17 @@ function buildOpenApiPatch(ctrl, config) {
|
|
|
95
160
|
const statusKey = typeof status === 'number' ? String(status) : 'default';
|
|
96
161
|
const description = plain(arg.description);
|
|
97
162
|
const schema = resolveSchemaArg(arg.schema ?? arg.type, method.responseType);
|
|
163
|
+
const example = literalValue(arg.example);
|
|
164
|
+
const examples = literalValue(arg.examples);
|
|
165
|
+
const mediaType = {
|
|
166
|
+
...(schema ? { schema } : {}),
|
|
167
|
+
...(example !== undefined ? { example } : {}),
|
|
168
|
+
...(examples !== undefined ? { examples: examples } : {}),
|
|
169
|
+
};
|
|
98
170
|
op.responses ?? (op.responses = {});
|
|
99
171
|
op.responses[statusKey] = {
|
|
100
172
|
...(typeof description === 'string' ? { description } : {}),
|
|
101
|
-
...(
|
|
173
|
+
...(Object.keys(mediaType).length > 0 ? { content: { 'application/json': mediaType } } : {}),
|
|
102
174
|
};
|
|
103
175
|
break;
|
|
104
176
|
}
|
|
@@ -106,10 +178,19 @@ function buildOpenApiPatch(ctrl, config) {
|
|
|
106
178
|
const arg = asRecord(call.args[0]);
|
|
107
179
|
const fallback = findBodyResponseType(method);
|
|
108
180
|
const schema = resolveSchemaArg(arg.schema ?? arg.type, fallback);
|
|
109
|
-
|
|
181
|
+
// @nestjs/swagger's real ApiBodyOptions type only has `examples`
|
|
182
|
+
// (a map), never a singular `example` — unlike ApiResponse, which
|
|
183
|
+
// supports both. Reading `example` here would be dead code: no
|
|
184
|
+
// type-checked docs file could ever legitimately pass it.
|
|
185
|
+
const examples = literalValue(arg.examples);
|
|
186
|
+
const mediaType = {
|
|
187
|
+
...(schema ? { schema } : {}),
|
|
188
|
+
...(examples !== undefined ? { examples: examples } : {}),
|
|
189
|
+
};
|
|
190
|
+
if (Object.keys(mediaType).length > 0) {
|
|
110
191
|
op.requestBody = {
|
|
111
192
|
required: true,
|
|
112
|
-
content: { 'application/json':
|
|
193
|
+
content: { 'application/json': mediaType },
|
|
113
194
|
};
|
|
114
195
|
}
|
|
115
196
|
break;
|
|
@@ -127,13 +208,15 @@ function buildOpenApiPatch(ctrl, config) {
|
|
|
127
208
|
break;
|
|
128
209
|
const paramIn = call.name === 'ApiParam' ? 'path' : call.name === 'ApiQuery' ? 'query' : 'header';
|
|
129
210
|
const required = plain(arg.required);
|
|
211
|
+
const enumValues = enumSchemaValues(arg.enum);
|
|
212
|
+
const schemaType = enumValues?.every((v) => typeof v === 'number') ? 'number' : 'string';
|
|
130
213
|
op.parameters = [
|
|
131
214
|
...(op.parameters ?? []),
|
|
132
215
|
{
|
|
133
216
|
name,
|
|
134
217
|
in: paramIn,
|
|
135
218
|
...(typeof required === 'boolean' ? { required } : {}),
|
|
136
|
-
schema: { type:
|
|
219
|
+
schema: { type: schemaType, ...(enumValues ? { enum: enumValues } : {}) },
|
|
137
220
|
},
|
|
138
221
|
];
|
|
139
222
|
break;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"build-openapi-patch.js","sourceRoot":"","sources":["../../src/cli/build-openapi-patch.ts"],"names":[],"mappings":";;
|
|
1
|
+
{"version":3,"file":"build-openapi-patch.js","sourceRoot":"","sources":["../../src/cli/build-openapi-patch.ts"],"names":[],"mappings":"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"}
|
package/dist/cli/check.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"check.js","sourceRoot":"","sources":["../../src/cli/check.ts"],"names":[],"mappings":";;;;;AA8CA,oDAsBC;AASD,
|
|
1
|
+
{"version":3,"file":"check.js","sourceRoot":"","sources":["../../src/cli/check.ts"],"names":[],"mappings":"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"}
|
package/dist/cli/coverage.js
CHANGED
|
@@ -20,9 +20,7 @@ function computeCoverage(controllers, format) {
|
|
|
20
20
|
}
|
|
21
21
|
}
|
|
22
22
|
const missingEndpoints = totalEndpoints - documentedEndpoints;
|
|
23
|
-
const coveragePercent = totalEndpoints === 0
|
|
24
|
-
? NaN
|
|
25
|
-
: Math.round((documentedEndpoints / totalEndpoints) * 1000) / 10;
|
|
23
|
+
const coveragePercent = totalEndpoints === 0 ? NaN : Math.round((documentedEndpoints / totalEndpoints) * 1000) / 10;
|
|
26
24
|
return {
|
|
27
25
|
totalControllers: controllers.length,
|
|
28
26
|
totalEndpoints,
|
package/dist/cli/coverage.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"coverage.js","sourceRoot":"","sources":["../../src/cli/coverage.ts"],"names":[],"mappings":";;AAkBA,
|
|
1
|
+
{"version":3,"file":"coverage.js","sourceRoot":"","sources":["../../src/cli/coverage.ts"],"names":[],"mappings":";;AAkBA,0CAyBC;AA3CD,yDAAwD;AACxD,mCAA+C;AAa/C;;;GAGG;AACH,SAAgB,eAAe,CAAC,WAA6B,EAAE,MAAmB;IAChF,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,IAAI,mBAAmB,GAAG,CAAC,CAAC;IAE5B,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,KAAK,IAAI,CAAC,CAAC;QACzE,cAAc,IAAI,WAAW,CAAC,MAAM,CAAC;QAErC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,MAAM,QAAQ,GAAG,IAAA,qCAAkB,EAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC3D,MAAM,UAAU,GAAG,IAAA,4BAAoB,EAAC,QAAQ,CAAC,CAAC;YAClD,mBAAmB,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;QAClF,CAAC;IACH,CAAC;IAED,MAAM,gBAAgB,GAAG,cAAc,GAAG,mBAAmB,CAAC;IAC9D,MAAM,eAAe,GAAG,cAAc,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,mBAAmB,GAAG,cAAc,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEpH,OAAO;QACL,gBAAgB,EAAE,WAAW,CAAC,MAAM;QACpC,cAAc;QACd,mBAAmB;QACnB,gBAAgB;QAChB,eAAe;KAChB,CAAC;AACJ,CAAC"}
|
|
@@ -38,11 +38,7 @@ function exists(filePath) {
|
|
|
38
38
|
// ---------------------------------------------------------------------------
|
|
39
39
|
// Tsconfig candidate resolution (project-type-agnostic helper)
|
|
40
40
|
// ---------------------------------------------------------------------------
|
|
41
|
-
const TSCONFIG_CANDIDATES = [
|
|
42
|
-
'tsconfig.build.json',
|
|
43
|
-
'tsconfig.app.json',
|
|
44
|
-
'tsconfig.json',
|
|
45
|
-
];
|
|
41
|
+
const TSCONFIG_CANDIDATES = ['tsconfig.build.json', 'tsconfig.app.json', 'tsconfig.json'];
|
|
46
42
|
function findTsconfig(appRoot, projectRoot) {
|
|
47
43
|
for (const candidate of TSCONFIG_CANDIDATES) {
|
|
48
44
|
const resolved = path_1.default.join(appRoot, candidate);
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"detect-project.js","sourceRoot":"","sources":["../../src/cli/detect-project.ts"],"names":[],"mappings":";;;;;
|
|
1
|
+
{"version":3,"file":"detect-project.js","sourceRoot":"","sources":["../../src/cli/detect-project.ts"],"names":[],"mappings":"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"}
|
package/dist/cli/errors.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/cli/errors.ts"],"names":[],"mappings":";;;AAMA,MAAa,QAAS,SAAQ,KAAK;IACjC,YACE,OAAe,EACC,oCAAyC;QAEzD,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,aAAQ,GAAR,QAAQ,CAAiC;QAGzD,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AARD,4BAQC;AAED,MAAa,kBAAmB,SAAQ,QAAQ;IAC9C,YAAY,aAAqB;QAC/B,KAAK,
|
|
1
|
+
{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/cli/errors.ts"],"names":[],"mappings":";;;AAMA,MAAa,QAAS,SAAQ,KAAK;IACjC,YACE,OAAe,EACC,oCAAyC;QAEzD,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,aAAQ,GAAR,QAAQ,CAAiC;QAGzD,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AARD,4BAQC;AAED,MAAa,kBAAmB,SAAQ,QAAQ;IAC9C,YAAY,aAAqB;QAC/B,KAAK,CAAC,6BAA6B,aAAa,sCAAsC,4BAAoB,CAAC;QAC3G,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AALD,gDAKC;AAED,MAAa,mBAAoB,SAAQ,QAAQ;IAC/C,YAAY,MAAc;QACxB,KAAK,CAAC,+BAA+B,MAAM,EAAE,4BAAoB,CAAC;QAClE,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AALD,kDAKC"}
|
|
@@ -18,9 +18,11 @@ export declare function isUnresolved(value: EvaluatedValue): value is Unresolved
|
|
|
18
18
|
* Statically evaluates a ts-morph expression node into a plain JS value,
|
|
19
19
|
* without executing any code. Handles the literal shapes that actually
|
|
20
20
|
* appear in `.docs.ts` files written by hand or generated by this tool:
|
|
21
|
-
* string/number/boolean/null literals, array and object literals,
|
|
22
|
-
* `HttpStatus.X` member access
|
|
23
|
-
*
|
|
21
|
+
* string/number/boolean/null literals, array and object literals,
|
|
22
|
+
* `HttpStatus.X` member access, and a bare identifier referring to a TS
|
|
23
|
+
* `enum` declaration (e.g. `enum: Role`), resolved to its member values.
|
|
24
|
+
* Anything else (variable references, function calls, spreads, computed
|
|
25
|
+
* keys) becomes an `Unresolved` marker
|
|
24
26
|
* rather than throwing — callers decide what to do with it.
|
|
25
27
|
*/
|
|
26
28
|
export declare function evaluateExpression(node: Node): EvaluatedValue;
|
|
@@ -9,18 +9,67 @@ function isUnresolved(value) {
|
|
|
9
9
|
}
|
|
10
10
|
/** Common `HttpStatus.X` members from @nestjs/common, for ApiResponse({ status: HttpStatus.CREATED }). */
|
|
11
11
|
const HTTP_STATUS_MEMBERS = {
|
|
12
|
-
CONTINUE: 100,
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
12
|
+
CONTINUE: 100,
|
|
13
|
+
OK: 200,
|
|
14
|
+
CREATED: 201,
|
|
15
|
+
ACCEPTED: 202,
|
|
16
|
+
NO_CONTENT: 204,
|
|
17
|
+
MOVED_PERMANENTLY: 301,
|
|
18
|
+
FOUND: 302,
|
|
19
|
+
NOT_MODIFIED: 304,
|
|
20
|
+
BAD_REQUEST: 400,
|
|
21
|
+
UNAUTHORIZED: 401,
|
|
22
|
+
FORBIDDEN: 403,
|
|
23
|
+
NOT_FOUND: 404,
|
|
24
|
+
METHOD_NOT_ALLOWED: 405,
|
|
25
|
+
NOT_ACCEPTABLE: 406,
|
|
26
|
+
REQUEST_TIMEOUT: 408,
|
|
27
|
+
CONFLICT: 409,
|
|
28
|
+
GONE: 410,
|
|
29
|
+
PAYLOAD_TOO_LARGE: 413,
|
|
30
|
+
UNSUPPORTED_MEDIA_TYPE: 415,
|
|
31
|
+
UNPROCESSABLE_ENTITY: 422,
|
|
32
|
+
TOO_MANY_REQUESTS: 429,
|
|
33
|
+
INTERNAL_SERVER_ERROR: 500,
|
|
34
|
+
NOT_IMPLEMENTED: 501,
|
|
35
|
+
BAD_GATEWAY: 502,
|
|
36
|
+
SERVICE_UNAVAILABLE: 503,
|
|
37
|
+
GATEWAY_TIMEOUT: 504,
|
|
20
38
|
};
|
|
21
39
|
function unresolved(node) {
|
|
22
40
|
return { __unresolved: true, text: node.getText() };
|
|
23
41
|
}
|
|
42
|
+
/**
|
|
43
|
+
* If `node` is a bare identifier referring to a TS `enum` declaration (the
|
|
44
|
+
* common `ApiProperty({ enum: Role })` / `ApiQuery({ enum: Status })` shape),
|
|
45
|
+
* resolves it to the array of the enum's constant values via ts-morph's
|
|
46
|
+
* compiler-backed `EnumMember.getValue()` — no code execution, just the
|
|
47
|
+
* already-parsed declaration. Returns undefined for anything else (plain
|
|
48
|
+
* variables, unresolved symbols, computed enum members), leaving those to
|
|
49
|
+
* fall through to `unresolved()` as before.
|
|
50
|
+
*/
|
|
51
|
+
function resolveEnumIdentifier(node) {
|
|
52
|
+
if (node.getKind() !== ts_morph_1.SyntaxKind.Identifier)
|
|
53
|
+
return undefined;
|
|
54
|
+
const rawSymbol = node.asKindOrThrow(ts_morph_1.SyntaxKind.Identifier).getSymbol();
|
|
55
|
+
// A bare reference to an *imported* enum resolves, via getSymbol(), to the
|
|
56
|
+
// local ImportSpecifier binding, not the real EnumDeclaration — that only
|
|
57
|
+
// comes from following the alias to whatever it actually points at.
|
|
58
|
+
// getAliasedSymbol() is a no-op (returns undefined) for a non-alias
|
|
59
|
+
// symbol, so this is safe for the same-file case too.
|
|
60
|
+
const symbol = rawSymbol?.getAliasedSymbol() ?? rawSymbol;
|
|
61
|
+
const enumDecl = symbol
|
|
62
|
+
?.getDeclarations()
|
|
63
|
+
.find((d) => d.getKind() === ts_morph_1.SyntaxKind.EnumDeclaration);
|
|
64
|
+
if (!enumDecl)
|
|
65
|
+
return undefined;
|
|
66
|
+
const values = enumDecl
|
|
67
|
+
.asKindOrThrow(ts_morph_1.SyntaxKind.EnumDeclaration)
|
|
68
|
+
.getMembers()
|
|
69
|
+
.map((member) => member.getValue())
|
|
70
|
+
.filter((value) => value !== undefined);
|
|
71
|
+
return values.length > 0 ? values : undefined;
|
|
72
|
+
}
|
|
24
73
|
function stripQuotes(text) {
|
|
25
74
|
return text.replace(/^['"`]/, '').replace(/['"`]$/, '');
|
|
26
75
|
}
|
|
@@ -28,9 +77,11 @@ function stripQuotes(text) {
|
|
|
28
77
|
* Statically evaluates a ts-morph expression node into a plain JS value,
|
|
29
78
|
* without executing any code. Handles the literal shapes that actually
|
|
30
79
|
* appear in `.docs.ts` files written by hand or generated by this tool:
|
|
31
|
-
* string/number/boolean/null literals, array and object literals,
|
|
32
|
-
* `HttpStatus.X` member access
|
|
33
|
-
*
|
|
80
|
+
* string/number/boolean/null literals, array and object literals,
|
|
81
|
+
* `HttpStatus.X` member access, and a bare identifier referring to a TS
|
|
82
|
+
* `enum` declaration (e.g. `enum: Role`), resolved to its member values.
|
|
83
|
+
* Anything else (variable references, function calls, spreads, computed
|
|
84
|
+
* keys) becomes an `Unresolved` marker
|
|
34
85
|
* rather than throwing — callers decide what to do with it.
|
|
35
86
|
*/
|
|
36
87
|
function evaluateExpression(node) {
|
|
@@ -84,6 +135,8 @@ function evaluateExpression(node) {
|
|
|
84
135
|
}
|
|
85
136
|
return unresolved(node);
|
|
86
137
|
}
|
|
138
|
+
case ts_morph_1.SyntaxKind.Identifier:
|
|
139
|
+
return resolveEnumIdentifier(node) ?? unresolved(node);
|
|
87
140
|
default:
|
|
88
141
|
return unresolved(node);
|
|
89
142
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"eval-decorator-args.js","sourceRoot":"","sources":["../../src/cli/eval-decorator-args.ts"],"names":[],"mappings":";;
|
|
1
|
+
{"version":3,"file":"eval-decorator-args.js","sourceRoot":"","sources":["../../src/cli/eval-decorator-args.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,8 +1,23 @@
|
|
|
1
|
+
import { Project } from 'ts-morph';
|
|
1
2
|
import { DecoratorCall } from './eval-decorator-args';
|
|
2
3
|
export interface ExtractedDocsConfig {
|
|
3
4
|
classDecorators: DecoratorCall[];
|
|
4
5
|
methods: Record<string, DecoratorCall[]>;
|
|
5
6
|
}
|
|
7
|
+
/**
|
|
8
|
+
* A real, disk-backed project + the docs file's absolute path — when given,
|
|
9
|
+
* `extractDocsConfig` parses the file inside that project instead of an
|
|
10
|
+
* isolated one, so a decorator argument that references a symbol imported
|
|
11
|
+
* from another file (e.g. `enum: Role` where `Role` comes from
|
|
12
|
+
* `./role.enum`) resolves for real. Callers that already scanned the
|
|
13
|
+
* project's controllers (`scanApp`/`scanAllApps`) already have this project
|
|
14
|
+
* sitting around with every relevant file loaded — see
|
|
15
|
+
* `ScanResult.projectsByControllerPath`.
|
|
16
|
+
*/
|
|
17
|
+
export interface DocsFileProjectContext {
|
|
18
|
+
project: Project;
|
|
19
|
+
absolutePath: string;
|
|
20
|
+
}
|
|
6
21
|
/**
|
|
7
22
|
* Statically extracts the `docs(ControllerClass, { classDecorators, methods })`
|
|
8
23
|
* call from a `.controller.docs.ts` file's source text — without executing
|
|
@@ -14,6 +29,11 @@ export interface ExtractedDocsConfig {
|
|
|
14
29
|
* to the same class object the running app uses (see the README's "Not
|
|
15
30
|
* supported: webpack: true" section for why the runtime pipeline can't).
|
|
16
31
|
*
|
|
32
|
+
* Without `context`, the file is parsed in an isolated in-memory project
|
|
33
|
+
* with nothing else in scope — fine for the `docs(...)` call's own literal
|
|
34
|
+
* structure, but a decorator argument referencing an imported symbol will
|
|
35
|
+
* never resolve (see `DocsFileProjectContext`). Pass `context` to fix that.
|
|
36
|
+
*
|
|
17
37
|
* Returns null if the file can't be parsed or no `docs(...)` call is found.
|
|
18
38
|
*/
|
|
19
|
-
export declare function extractDocsConfig(sourceText: string): ExtractedDocsConfig | null;
|
|
39
|
+
export declare function extractDocsConfig(sourceText: string, context?: DocsFileProjectContext): ExtractedDocsConfig | null;
|
|
@@ -14,19 +14,31 @@ const eval_decorator_args_1 = require("./eval-decorator-args");
|
|
|
14
14
|
* to the same class object the running app uses (see the README's "Not
|
|
15
15
|
* supported: webpack: true" section for why the runtime pipeline can't).
|
|
16
16
|
*
|
|
17
|
+
* Without `context`, the file is parsed in an isolated in-memory project
|
|
18
|
+
* with nothing else in scope — fine for the `docs(...)` call's own literal
|
|
19
|
+
* structure, but a decorator argument referencing an imported symbol will
|
|
20
|
+
* never resolve (see `DocsFileProjectContext`). Pass `context` to fix that.
|
|
21
|
+
*
|
|
17
22
|
* Returns null if the file can't be parsed or no `docs(...)` call is found.
|
|
18
23
|
*/
|
|
19
|
-
function extractDocsConfig(sourceText) {
|
|
24
|
+
function extractDocsConfig(sourceText, context) {
|
|
20
25
|
let project;
|
|
21
|
-
|
|
22
|
-
project =
|
|
26
|
+
if (context) {
|
|
27
|
+
project = context.project;
|
|
23
28
|
}
|
|
24
|
-
|
|
25
|
-
|
|
29
|
+
else {
|
|
30
|
+
try {
|
|
31
|
+
project = new ts_morph_1.Project({ useInMemoryFileSystem: true, skipFileDependencyResolution: true });
|
|
32
|
+
}
|
|
33
|
+
catch {
|
|
34
|
+
return null;
|
|
35
|
+
}
|
|
26
36
|
}
|
|
27
37
|
let sf;
|
|
28
38
|
try {
|
|
29
|
-
sf =
|
|
39
|
+
sf = context
|
|
40
|
+
? project.createSourceFile(context.absolutePath, sourceText, { overwrite: true })
|
|
41
|
+
: project.createSourceFile('docs.ts', sourceText);
|
|
30
42
|
}
|
|
31
43
|
catch {
|
|
32
44
|
return null;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"extract-docs-config.js","sourceRoot":"","sources":["../../src/cli/extract-docs-config.ts"],"names":[],"mappings":";;
|
|
1
|
+
{"version":3,"file":"extract-docs-config.js","sourceRoot":"","sources":["../../src/cli/extract-docs-config.ts"],"names":[],"mappings":"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"}
|
|
@@ -19,6 +19,7 @@ export interface SchemaProperty {
|
|
|
19
19
|
minLength?: number;
|
|
20
20
|
maxLength?: number;
|
|
21
21
|
enum?: (string | number)[];
|
|
22
|
+
oneOf?: SchemaProperty[];
|
|
22
23
|
}
|
|
23
24
|
export interface InlineSchema {
|
|
24
25
|
properties: Record<string, SchemaProperty>;
|
|
@@ -50,6 +51,16 @@ export interface ResponseTypeInfo {
|
|
|
50
51
|
* Used to emit `schema:` instead of `type:` so docs are accurate even without @ApiProperty.
|
|
51
52
|
*/
|
|
52
53
|
classSchema?: InlineSchema;
|
|
54
|
+
/**
|
|
55
|
+
* Set when the original type was a union of ≥2 named DTO/entity types
|
|
56
|
+
* (e.g. `UserDto | AdminDto`), each resolved the same way a single named
|
|
57
|
+
* type would be. `name` becomes a ` | `-joined, non-identifier placeholder
|
|
58
|
+
* so the existing `IDENTIFIER_RE` guards in generate-file.ts continue to
|
|
59
|
+
* treat this like any other unresolvable type (no import, no `type:`
|
|
60
|
+
* codegen) — only patch-spec's schema synthesis reads `unionMembers`, to
|
|
61
|
+
* build an OpenAPI `oneOf`.
|
|
62
|
+
*/
|
|
63
|
+
unionMembers?: ResponseTypeInfo[];
|
|
53
64
|
}
|
|
54
65
|
export interface MethodInfo {
|
|
55
66
|
name: string;
|