nestjs-docfy 0.2.8 → 0.3.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/README.md +261 -0
- package/dist/attach-tag-groups.d.ts +14 -0
- package/dist/attach-tag-groups.js +24 -0
- package/dist/attach-tag-groups.js.map +1 -0
- package/dist/cli/build-openapi-patch.d.ts +45 -0
- package/dist/cli/build-openapi-patch.js +151 -0
- package/dist/cli/build-openapi-patch.js.map +1 -0
- package/dist/cli/coverage.d.ts +15 -0
- package/dist/cli/coverage.js +34 -0
- package/dist/cli/coverage.js.map +1 -0
- package/dist/cli/eval-decorator-args.d.ts +39 -0
- package/dist/cli/eval-decorator-args.js +115 -0
- package/dist/cli/eval-decorator-args.js.map +1 -0
- package/dist/cli/extract-docs-config.d.ts +19 -0
- package/dist/cli/extract-docs-config.js +89 -0
- package/dist/cli/extract-docs-config.js.map +1 -0
- package/dist/cli/index.js +287 -0
- package/dist/cli/index.js.map +1 -1
- package/dist/cli/lint.d.ts +33 -0
- package/dist/cli/lint.js +211 -0
- package/dist/cli/lint.js.map +1 -0
- package/dist/cli/merge-spec-patch.d.ts +57 -0
- package/dist/cli/merge-spec-patch.js +115 -0
- package/dist/cli/merge-spec-patch.js.map +1 -0
- package/dist/cli/patch-spec.d.ts +31 -0
- package/dist/cli/patch-spec.js +82 -0
- package/dist/cli/patch-spec.js.map +1 -0
- package/dist/docfy-ui.module.d.ts +48 -0
- package/dist/docfy-ui.module.js +72 -0
- package/dist/docfy-ui.module.js.map +1 -0
- package/dist/docfy.module.js +9 -5
- package/dist/docfy.module.js.map +1 -1
- package/dist/docs.d.ts +13 -0
- package/dist/docs.js +4 -0
- package/dist/docs.js.map +1 -1
- package/dist/index.d.ts +3 -0
- package/dist/index.js +5 -1
- package/dist/index.js.map +1 -1
- package/dist/registry.d.ts +2 -1
- package/dist/registry.js +11 -1
- package/dist/registry.js.map +1 -1
- package/dist/require-ts.d.ts +32 -0
- package/dist/require-ts.js +122 -0
- package/dist/require-ts.js.map +1 -0
- package/dist/resolve-docs-path.d.ts +10 -1
- package/dist/resolve-docs-path.js +18 -2
- package/dist/resolve-docs-path.js.map +1 -1
- package/dist/resolve-source-from-stack.d.ts +35 -0
- package/dist/resolve-source-from-stack.js +153 -0
- package/dist/resolve-source-from-stack.js.map +1 -0
- package/dist/tag-group-registry.d.ts +9 -0
- package/dist/tag-group-registry.js +32 -0
- package/dist/tag-group-registry.js.map +1 -0
- package/dist/testing.js +2 -0
- package/dist/testing.js.map +1 -1
- package/dist/with-docs.decorator.js +7 -1
- package/dist/with-docs.decorator.js.map +1 -1
- package/package.json +5 -1
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.isUnresolved = isUnresolved;
|
|
4
|
+
exports.evaluateExpression = evaluateExpression;
|
|
5
|
+
exports.evaluateDecoratorCall = evaluateDecoratorCall;
|
|
6
|
+
const ts_morph_1 = require("ts-morph");
|
|
7
|
+
function isUnresolved(value) {
|
|
8
|
+
return typeof value === 'object' && value !== null && !Array.isArray(value) && '__unresolved' in value;
|
|
9
|
+
}
|
|
10
|
+
/** Common `HttpStatus.X` members from @nestjs/common, for ApiResponse({ status: HttpStatus.CREATED }). */
|
|
11
|
+
const HTTP_STATUS_MEMBERS = {
|
|
12
|
+
CONTINUE: 100, OK: 200, CREATED: 201, ACCEPTED: 202, NO_CONTENT: 204,
|
|
13
|
+
MOVED_PERMANENTLY: 301, FOUND: 302, NOT_MODIFIED: 304,
|
|
14
|
+
BAD_REQUEST: 400, UNAUTHORIZED: 401, FORBIDDEN: 403, NOT_FOUND: 404,
|
|
15
|
+
METHOD_NOT_ALLOWED: 405, NOT_ACCEPTABLE: 406, REQUEST_TIMEOUT: 408,
|
|
16
|
+
CONFLICT: 409, GONE: 410, PAYLOAD_TOO_LARGE: 413, UNSUPPORTED_MEDIA_TYPE: 415,
|
|
17
|
+
UNPROCESSABLE_ENTITY: 422, TOO_MANY_REQUESTS: 429,
|
|
18
|
+
INTERNAL_SERVER_ERROR: 500, NOT_IMPLEMENTED: 501, BAD_GATEWAY: 502,
|
|
19
|
+
SERVICE_UNAVAILABLE: 503, GATEWAY_TIMEOUT: 504,
|
|
20
|
+
};
|
|
21
|
+
function unresolved(node) {
|
|
22
|
+
return { __unresolved: true, text: node.getText() };
|
|
23
|
+
}
|
|
24
|
+
function stripQuotes(text) {
|
|
25
|
+
return text.replace(/^['"`]/, '').replace(/['"`]$/, '');
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* Statically evaluates a ts-morph expression node into a plain JS value,
|
|
29
|
+
* without executing any code. Handles the literal shapes that actually
|
|
30
|
+
* appear in `.docs.ts` files written by hand or generated by this tool:
|
|
31
|
+
* string/number/boolean/null literals, array and object literals, and
|
|
32
|
+
* `HttpStatus.X` member access. Anything else (variable references,
|
|
33
|
+
* function calls, spreads, computed keys) becomes an `Unresolved` marker
|
|
34
|
+
* rather than throwing — callers decide what to do with it.
|
|
35
|
+
*/
|
|
36
|
+
function evaluateExpression(node) {
|
|
37
|
+
switch (node.getKind()) {
|
|
38
|
+
case ts_morph_1.SyntaxKind.StringLiteral:
|
|
39
|
+
case ts_morph_1.SyntaxKind.NoSubstitutionTemplateLiteral:
|
|
40
|
+
return stripQuotes(node.getText());
|
|
41
|
+
case ts_morph_1.SyntaxKind.NumericLiteral:
|
|
42
|
+
return Number(node.getText());
|
|
43
|
+
case ts_morph_1.SyntaxKind.TrueKeyword:
|
|
44
|
+
return true;
|
|
45
|
+
case ts_morph_1.SyntaxKind.FalseKeyword:
|
|
46
|
+
return false;
|
|
47
|
+
case ts_morph_1.SyntaxKind.NullKeyword:
|
|
48
|
+
return null;
|
|
49
|
+
case ts_morph_1.SyntaxKind.PrefixUnaryExpression: {
|
|
50
|
+
// Handles negative numeric literals, e.g. `-1`.
|
|
51
|
+
const text = node.getText();
|
|
52
|
+
const asNumber = Number(text);
|
|
53
|
+
return Number.isFinite(asNumber) ? asNumber : unresolved(node);
|
|
54
|
+
}
|
|
55
|
+
case ts_morph_1.SyntaxKind.ArrayLiteralExpression: {
|
|
56
|
+
const elements = node.asKindOrThrow(ts_morph_1.SyntaxKind.ArrayLiteralExpression).getElements();
|
|
57
|
+
return elements.map((el) => evaluateExpression(el));
|
|
58
|
+
}
|
|
59
|
+
case ts_morph_1.SyntaxKind.ObjectLiteralExpression: {
|
|
60
|
+
const result = {};
|
|
61
|
+
const props = node.asKindOrThrow(ts_morph_1.SyntaxKind.ObjectLiteralExpression).getProperties();
|
|
62
|
+
for (const prop of props) {
|
|
63
|
+
if (prop.getKind() === ts_morph_1.SyntaxKind.PropertyAssignment) {
|
|
64
|
+
const pa = prop.asKindOrThrow(ts_morph_1.SyntaxKind.PropertyAssignment);
|
|
65
|
+
const key = pa.getName();
|
|
66
|
+
const initializer = pa.getInitializer();
|
|
67
|
+
result[key] = initializer ? evaluateExpression(initializer) : unresolved(prop);
|
|
68
|
+
}
|
|
69
|
+
else {
|
|
70
|
+
// ShorthandPropertyAssignment, SpreadAssignment, MethodDeclaration, computed keys —
|
|
71
|
+
// none of these can be resolved without executing code.
|
|
72
|
+
const name = 'getName' in prop && typeof prop.getName === 'function' ? prop.getName() : '?';
|
|
73
|
+
result[name] = unresolved(prop);
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
return result;
|
|
77
|
+
}
|
|
78
|
+
case ts_morph_1.SyntaxKind.PropertyAccessExpression: {
|
|
79
|
+
const pae = node.asKindOrThrow(ts_morph_1.SyntaxKind.PropertyAccessExpression);
|
|
80
|
+
const objectText = pae.getExpression().getText();
|
|
81
|
+
const memberName = pae.getName();
|
|
82
|
+
if (objectText === 'HttpStatus' && memberName in HTTP_STATUS_MEMBERS) {
|
|
83
|
+
return HTTP_STATUS_MEMBERS[memberName];
|
|
84
|
+
}
|
|
85
|
+
return unresolved(node);
|
|
86
|
+
}
|
|
87
|
+
default:
|
|
88
|
+
return unresolved(node);
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
/**
|
|
92
|
+
* Evaluates a decorator factory call expression — e.g. the `ApiOperation({
|
|
93
|
+
* summary: 'X' })` inside an array literal `[ApiOperation({...}), ApiBearerAuth()]`
|
|
94
|
+
* — into a `{ name, args }` pair. Returns null if the expression isn't a
|
|
95
|
+
* recognizable `Identifier(...)` or `Identifier.member(...)` call.
|
|
96
|
+
*/
|
|
97
|
+
function evaluateDecoratorCall(node) {
|
|
98
|
+
if (node.getKind() !== ts_morph_1.SyntaxKind.CallExpression)
|
|
99
|
+
return null;
|
|
100
|
+
const call = node.asKindOrThrow(ts_morph_1.SyntaxKind.CallExpression);
|
|
101
|
+
const expr = call.getExpression();
|
|
102
|
+
let name;
|
|
103
|
+
if (expr.getKind() === ts_morph_1.SyntaxKind.Identifier) {
|
|
104
|
+
name = expr.getText();
|
|
105
|
+
}
|
|
106
|
+
else if (expr.getKind() === ts_morph_1.SyntaxKind.PropertyAccessExpression) {
|
|
107
|
+
name = expr.asKindOrThrow(ts_morph_1.SyntaxKind.PropertyAccessExpression).getName();
|
|
108
|
+
}
|
|
109
|
+
else {
|
|
110
|
+
return null;
|
|
111
|
+
}
|
|
112
|
+
const args = call.getArguments().map((arg) => evaluateExpression(arg));
|
|
113
|
+
return { name, args };
|
|
114
|
+
}
|
|
115
|
+
//# sourceMappingURL=eval-decorator-args.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"eval-decorator-args.js","sourceRoot":"","sources":["../../src/cli/eval-decorator-args.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import { DecoratorCall } from './eval-decorator-args';
|
|
2
|
+
export interface ExtractedDocsConfig {
|
|
3
|
+
classDecorators: DecoratorCall[];
|
|
4
|
+
methods: Record<string, DecoratorCall[]>;
|
|
5
|
+
}
|
|
6
|
+
/**
|
|
7
|
+
* Statically extracts the `docs(ControllerClass, { classDecorators, methods })`
|
|
8
|
+
* call from a `.controller.docs.ts` file's source text — without executing
|
|
9
|
+
* it. Used to compute an OpenAPI patch directly from the file (see
|
|
10
|
+
* build-openapi-patch.ts), bypassing the runtime require()/Reflect-metadata
|
|
11
|
+
* pipeline entirely. That's the whole point: this works under any build
|
|
12
|
+
* mode, including NestJS CLI's `webpack: true`, because it never requires
|
|
13
|
+
* the file, never touches require.cache, and never needs a live reference
|
|
14
|
+
* to the same class object the running app uses (see the README's "Not
|
|
15
|
+
* supported: webpack: true" section for why the runtime pipeline can't).
|
|
16
|
+
*
|
|
17
|
+
* Returns null if the file can't be parsed or no `docs(...)` call is found.
|
|
18
|
+
*/
|
|
19
|
+
export declare function extractDocsConfig(sourceText: string): ExtractedDocsConfig | null;
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.extractDocsConfig = extractDocsConfig;
|
|
4
|
+
const ts_morph_1 = require("ts-morph");
|
|
5
|
+
const eval_decorator_args_1 = require("./eval-decorator-args");
|
|
6
|
+
/**
|
|
7
|
+
* Statically extracts the `docs(ControllerClass, { classDecorators, methods })`
|
|
8
|
+
* call from a `.controller.docs.ts` file's source text — without executing
|
|
9
|
+
* it. Used to compute an OpenAPI patch directly from the file (see
|
|
10
|
+
* build-openapi-patch.ts), bypassing the runtime require()/Reflect-metadata
|
|
11
|
+
* pipeline entirely. That's the whole point: this works under any build
|
|
12
|
+
* mode, including NestJS CLI's `webpack: true`, because it never requires
|
|
13
|
+
* the file, never touches require.cache, and never needs a live reference
|
|
14
|
+
* to the same class object the running app uses (see the README's "Not
|
|
15
|
+
* supported: webpack: true" section for why the runtime pipeline can't).
|
|
16
|
+
*
|
|
17
|
+
* Returns null if the file can't be parsed or no `docs(...)` call is found.
|
|
18
|
+
*/
|
|
19
|
+
function extractDocsConfig(sourceText) {
|
|
20
|
+
let project;
|
|
21
|
+
try {
|
|
22
|
+
project = new ts_morph_1.Project({ useInMemoryFileSystem: true, skipFileDependencyResolution: true });
|
|
23
|
+
}
|
|
24
|
+
catch {
|
|
25
|
+
return null;
|
|
26
|
+
}
|
|
27
|
+
let sf;
|
|
28
|
+
try {
|
|
29
|
+
sf = project.createSourceFile('docs.ts', sourceText);
|
|
30
|
+
}
|
|
31
|
+
catch {
|
|
32
|
+
return null;
|
|
33
|
+
}
|
|
34
|
+
const docsCall = sf.getDescendantsOfKind(ts_morph_1.SyntaxKind.CallExpression).find((call) => {
|
|
35
|
+
try {
|
|
36
|
+
return call.getExpression().getText() === 'docs';
|
|
37
|
+
}
|
|
38
|
+
catch {
|
|
39
|
+
return false;
|
|
40
|
+
}
|
|
41
|
+
});
|
|
42
|
+
if (!docsCall)
|
|
43
|
+
return null;
|
|
44
|
+
const args = docsCall.getArguments();
|
|
45
|
+
if (args.length < 2)
|
|
46
|
+
return null;
|
|
47
|
+
const configArg = args[1];
|
|
48
|
+
if (configArg.getKind() !== ts_morph_1.SyntaxKind.ObjectLiteralExpression)
|
|
49
|
+
return null;
|
|
50
|
+
const configObj = configArg.asKindOrThrow(ts_morph_1.SyntaxKind.ObjectLiteralExpression);
|
|
51
|
+
const classDecorators = [];
|
|
52
|
+
const methods = {};
|
|
53
|
+
for (const prop of configObj.getProperties()) {
|
|
54
|
+
if (prop.getKind() !== ts_morph_1.SyntaxKind.PropertyAssignment)
|
|
55
|
+
continue;
|
|
56
|
+
const pa = prop.asKindOrThrow(ts_morph_1.SyntaxKind.PropertyAssignment);
|
|
57
|
+
const name = pa.getName();
|
|
58
|
+
const initializer = pa.getInitializer();
|
|
59
|
+
if (!initializer)
|
|
60
|
+
continue;
|
|
61
|
+
if (name === 'classDecorators' && initializer.getKind() === ts_morph_1.SyntaxKind.ArrayLiteralExpression) {
|
|
62
|
+
for (const el of initializer.asKindOrThrow(ts_morph_1.SyntaxKind.ArrayLiteralExpression).getElements()) {
|
|
63
|
+
const call = (0, eval_decorator_args_1.evaluateDecoratorCall)(el);
|
|
64
|
+
if (call)
|
|
65
|
+
classDecorators.push(call);
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
if (name === 'methods' && initializer.getKind() === ts_morph_1.SyntaxKind.ObjectLiteralExpression) {
|
|
69
|
+
for (const methodProp of initializer.asKindOrThrow(ts_morph_1.SyntaxKind.ObjectLiteralExpression).getProperties()) {
|
|
70
|
+
if (methodProp.getKind() !== ts_morph_1.SyntaxKind.PropertyAssignment)
|
|
71
|
+
continue;
|
|
72
|
+
const methodPa = methodProp.asKindOrThrow(ts_morph_1.SyntaxKind.PropertyAssignment);
|
|
73
|
+
const methodName = methodPa.getName();
|
|
74
|
+
const methodInit = methodPa.getInitializer();
|
|
75
|
+
if (!methodInit || methodInit.getKind() !== ts_morph_1.SyntaxKind.ArrayLiteralExpression)
|
|
76
|
+
continue;
|
|
77
|
+
const calls = [];
|
|
78
|
+
for (const el of methodInit.asKindOrThrow(ts_morph_1.SyntaxKind.ArrayLiteralExpression).getElements()) {
|
|
79
|
+
const call = (0, eval_decorator_args_1.evaluateDecoratorCall)(el);
|
|
80
|
+
if (call)
|
|
81
|
+
calls.push(call);
|
|
82
|
+
}
|
|
83
|
+
methods[methodName] = calls;
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
return { classDecorators, methods };
|
|
88
|
+
}
|
|
89
|
+
//# sourceMappingURL=extract-docs-config.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"extract-docs-config.js","sourceRoot":"","sources":["../../src/cli/extract-docs-config.ts"],"names":[],"mappings":"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"}
|
package/dist/cli/index.js
CHANGED
|
@@ -1,9 +1,43 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
"use strict";
|
|
3
|
+
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
|
|
4
|
+
if (k2 === undefined) k2 = k;
|
|
5
|
+
var desc = Object.getOwnPropertyDescriptor(m, k);
|
|
6
|
+
if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
|
|
7
|
+
desc = { enumerable: true, get: function() { return m[k]; } };
|
|
8
|
+
}
|
|
9
|
+
Object.defineProperty(o, k2, desc);
|
|
10
|
+
}) : (function(o, m, k, k2) {
|
|
11
|
+
if (k2 === undefined) k2 = k;
|
|
12
|
+
o[k2] = m[k];
|
|
13
|
+
}));
|
|
14
|
+
var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
|
|
15
|
+
Object.defineProperty(o, "default", { enumerable: true, value: v });
|
|
16
|
+
}) : function(o, v) {
|
|
17
|
+
o["default"] = v;
|
|
18
|
+
});
|
|
19
|
+
var __importStar = (this && this.__importStar) || (function () {
|
|
20
|
+
var ownKeys = function(o) {
|
|
21
|
+
ownKeys = Object.getOwnPropertyNames || function (o) {
|
|
22
|
+
var ar = [];
|
|
23
|
+
for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
|
|
24
|
+
return ar;
|
|
25
|
+
};
|
|
26
|
+
return ownKeys(o);
|
|
27
|
+
};
|
|
28
|
+
return function (mod) {
|
|
29
|
+
if (mod && mod.__esModule) return mod;
|
|
30
|
+
var result = {};
|
|
31
|
+
if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
|
|
32
|
+
__setModuleDefault(result, mod);
|
|
33
|
+
return result;
|
|
34
|
+
};
|
|
35
|
+
})();
|
|
3
36
|
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
4
37
|
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
5
38
|
};
|
|
6
39
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
40
|
+
const fs = __importStar(require("fs"));
|
|
7
41
|
const commander_1 = require("commander");
|
|
8
42
|
const picocolors_1 = __importDefault(require("picocolors"));
|
|
9
43
|
const parse_args_1 = require("./parse-args");
|
|
@@ -14,6 +48,9 @@ const scan_controllers_1 = require("./scan-controllers");
|
|
|
14
48
|
const writer_1 = require("./writer");
|
|
15
49
|
const watch_1 = require("./watch");
|
|
16
50
|
const check_1 = require("./check");
|
|
51
|
+
const coverage_1 = require("./coverage");
|
|
52
|
+
const lint_1 = require("./lint");
|
|
53
|
+
const patch_spec_1 = require("./patch-spec");
|
|
17
54
|
const program = new commander_1.Command();
|
|
18
55
|
program
|
|
19
56
|
.name('nestjs-docfy')
|
|
@@ -231,6 +268,256 @@ program
|
|
|
231
268
|
process.exit(2 /* CliExitCode.Fatal */);
|
|
232
269
|
}
|
|
233
270
|
});
|
|
271
|
+
// ---------------------------------------------------------------------------
|
|
272
|
+
// coverage command
|
|
273
|
+
// ---------------------------------------------------------------------------
|
|
274
|
+
program
|
|
275
|
+
.command('coverage')
|
|
276
|
+
.description('Report the percentage of endpoints with Swagger documentation')
|
|
277
|
+
.option('--root <path>', 'Project root directory', '.')
|
|
278
|
+
.option('--tsconfig <path>', 'Path to tsconfig.json (auto-detected if omitted)')
|
|
279
|
+
.option('--pattern <glob>', 'Glob pattern to find controllers', '**/*.controller.ts')
|
|
280
|
+
.option('--format <format>', 'Docs file format to look for: ts or js', 'ts')
|
|
281
|
+
.option('--min <percent>', 'Minimum coverage percentage required — exits 1 if below')
|
|
282
|
+
.option('--quiet', 'Suppress all output except errors', false)
|
|
283
|
+
.action(async (rawOpts) => {
|
|
284
|
+
try {
|
|
285
|
+
const options = (0, parse_args_1.parseAndValidateOptions)({
|
|
286
|
+
...rawOpts,
|
|
287
|
+
force: false,
|
|
288
|
+
dryRun: false,
|
|
289
|
+
out: undefined,
|
|
290
|
+
watch: false,
|
|
291
|
+
});
|
|
292
|
+
(0, logger_1.setQuiet)(options.quiet);
|
|
293
|
+
let min;
|
|
294
|
+
if (rawOpts.min !== undefined) {
|
|
295
|
+
min = Number(rawOpts.min);
|
|
296
|
+
if (!Number.isFinite(min) || min < 0 || min > 100) {
|
|
297
|
+
throw new errors_1.CliError(`Invalid --min value: ${String(rawOpts.min)} (must be a number between 0 and 100)`, 2 /* CliExitCode.Fatal */);
|
|
298
|
+
}
|
|
299
|
+
}
|
|
300
|
+
(0, logger_1.header)('nestjs-docfy coverage');
|
|
301
|
+
(0, logger_1.log)('info', `Root: ${options.root}`);
|
|
302
|
+
(0, logger_1.log)('info', `Pattern: ${options.pattern}`);
|
|
303
|
+
(0, logger_1.log)('info', `Format: ${options.format}`);
|
|
304
|
+
const context = (0, detect_project_1.detectProject)(options.root, options.tsconfig);
|
|
305
|
+
const scanResult = (0, scan_controllers_1.scanAllApps)(context.apps, context.root, options.pattern !== '**/*.controller.ts' ? options.pattern : undefined, options.format);
|
|
306
|
+
for (const err of scanResult.errors) {
|
|
307
|
+
(0, logger_1.log)('error', `${err.file}: ${err.message}`);
|
|
308
|
+
}
|
|
309
|
+
if (scanResult.controllers.length === 0) {
|
|
310
|
+
(0, logger_1.log)('warn', 'No controllers found matching the pattern.');
|
|
311
|
+
process.exit(0 /* CliExitCode.Ok */);
|
|
312
|
+
return;
|
|
313
|
+
}
|
|
314
|
+
const report = (0, coverage_1.computeCoverage)(scanResult.controllers, options.format);
|
|
315
|
+
const pctLabel = Number.isNaN(report.coveragePercent) ? 'n/a' : `${report.coveragePercent}%`;
|
|
316
|
+
process.stdout.write('\n');
|
|
317
|
+
process.stdout.write(`Controllers: ${report.totalControllers}\n`);
|
|
318
|
+
process.stdout.write(`Endpoints: ${report.totalEndpoints}\n\n`);
|
|
319
|
+
process.stdout.write(`Documented: ${report.documentedEndpoints}\n`);
|
|
320
|
+
process.stdout.write(`Missing docs: ${report.missingEndpoints}\n\n`);
|
|
321
|
+
process.stdout.write(`Coverage: ${pctLabel}\n\n`);
|
|
322
|
+
if (min !== undefined && (Number.isNaN(report.coveragePercent) || report.coveragePercent < min)) {
|
|
323
|
+
process.stderr.write(`${picocolors_1.default.red(`✖ Coverage ${pctLabel} is below the required minimum of ${min}%.`)}\n\n`);
|
|
324
|
+
process.exit(1 /* CliExitCode.PartialError */);
|
|
325
|
+
return;
|
|
326
|
+
}
|
|
327
|
+
process.exit(0 /* CliExitCode.Ok */);
|
|
328
|
+
}
|
|
329
|
+
catch (err) {
|
|
330
|
+
if (err instanceof errors_1.CliError) {
|
|
331
|
+
process.stderr.write(`\n${picocolors_1.default.red('✖ Error:')} ${err.message}\n\n`);
|
|
332
|
+
process.exit(err.exitCode);
|
|
333
|
+
}
|
|
334
|
+
if (err instanceof Error) {
|
|
335
|
+
process.stderr.write(`\n${picocolors_1.default.red('✖ Error:')} ${err.message}\n\n`);
|
|
336
|
+
}
|
|
337
|
+
else {
|
|
338
|
+
process.stderr.write(`\n${picocolors_1.default.red('✖ Unknown error')}\n\n`);
|
|
339
|
+
}
|
|
340
|
+
process.exit(2 /* CliExitCode.Fatal */);
|
|
341
|
+
}
|
|
342
|
+
});
|
|
343
|
+
// ---------------------------------------------------------------------------
|
|
344
|
+
// lint command
|
|
345
|
+
// ---------------------------------------------------------------------------
|
|
346
|
+
program
|
|
347
|
+
.command('lint')
|
|
348
|
+
.description('Check documentation quality — missing summaries, error responses, body descriptions')
|
|
349
|
+
.option('--root <path>', 'Project root directory', '.')
|
|
350
|
+
.option('--tsconfig <path>', 'Path to tsconfig.json (auto-detected if omitted)')
|
|
351
|
+
.option('--pattern <glob>', 'Glob pattern to find controllers', '**/*.controller.ts')
|
|
352
|
+
.option('--format <format>', 'Docs file format to look for: ts or js', 'ts')
|
|
353
|
+
.option('--quiet', 'Suppress all output except errors', false)
|
|
354
|
+
.action(async (rawOpts) => {
|
|
355
|
+
try {
|
|
356
|
+
const options = (0, parse_args_1.parseAndValidateOptions)({
|
|
357
|
+
...rawOpts,
|
|
358
|
+
force: false,
|
|
359
|
+
dryRun: false,
|
|
360
|
+
out: undefined,
|
|
361
|
+
watch: false,
|
|
362
|
+
});
|
|
363
|
+
(0, logger_1.setQuiet)(options.quiet);
|
|
364
|
+
(0, logger_1.header)('nestjs-docfy lint');
|
|
365
|
+
(0, logger_1.log)('info', `Root: ${options.root}`);
|
|
366
|
+
(0, logger_1.log)('info', `Pattern: ${options.pattern}`);
|
|
367
|
+
(0, logger_1.log)('info', `Format: ${options.format}`);
|
|
368
|
+
const context = (0, detect_project_1.detectProject)(options.root, options.tsconfig);
|
|
369
|
+
const scanResult = (0, scan_controllers_1.scanAllApps)(context.apps, context.root, options.pattern !== '**/*.controller.ts' ? options.pattern : undefined, options.format);
|
|
370
|
+
for (const err of scanResult.errors) {
|
|
371
|
+
(0, logger_1.log)('error', `${err.file}: ${err.message}`);
|
|
372
|
+
}
|
|
373
|
+
if (scanResult.controllers.length === 0) {
|
|
374
|
+
(0, logger_1.log)('warn', 'No controllers found matching the pattern.');
|
|
375
|
+
process.exit(0 /* CliExitCode.Ok */);
|
|
376
|
+
return;
|
|
377
|
+
}
|
|
378
|
+
const issues = (0, lint_1.lintControllers)(scanResult.controllers, options.format);
|
|
379
|
+
if (issues.length === 0) {
|
|
380
|
+
(0, logger_1.log)('success', 'No documentation quality issues found.');
|
|
381
|
+
process.exit(0 /* CliExitCode.Ok */);
|
|
382
|
+
return;
|
|
383
|
+
}
|
|
384
|
+
const grouped = new Map();
|
|
385
|
+
for (const issue of issues) {
|
|
386
|
+
const key = `${issue.controllerClass}::${issue.method}`;
|
|
387
|
+
const existing = grouped.get(key);
|
|
388
|
+
if (existing)
|
|
389
|
+
existing.push(issue);
|
|
390
|
+
else
|
|
391
|
+
grouped.set(key, [issue]);
|
|
392
|
+
}
|
|
393
|
+
for (const groupIssues of grouped.values()) {
|
|
394
|
+
(0, logger_1.log)('error', groupIssues[0].route);
|
|
395
|
+
for (const issue of groupIssues) {
|
|
396
|
+
(0, logger_1.log)('info', ` ${issue.message}`);
|
|
397
|
+
}
|
|
398
|
+
}
|
|
399
|
+
process.stderr.write(`\n${picocolors_1.default.red(`✖ ${issues.length} issue(s) found.`)}\n\n`);
|
|
400
|
+
process.exit(1 /* CliExitCode.PartialError */);
|
|
401
|
+
}
|
|
402
|
+
catch (err) {
|
|
403
|
+
if (err instanceof errors_1.CliError) {
|
|
404
|
+
process.stderr.write(`\n${picocolors_1.default.red('✖ Error:')} ${err.message}\n\n`);
|
|
405
|
+
process.exit(err.exitCode);
|
|
406
|
+
}
|
|
407
|
+
if (err instanceof Error) {
|
|
408
|
+
process.stderr.write(`\n${picocolors_1.default.red('✖ Error:')} ${err.message}\n\n`);
|
|
409
|
+
}
|
|
410
|
+
else {
|
|
411
|
+
process.stderr.write(`\n${picocolors_1.default.red('✖ Unknown error')}\n\n`);
|
|
412
|
+
}
|
|
413
|
+
process.exit(2 /* CliExitCode.Fatal */);
|
|
414
|
+
}
|
|
415
|
+
});
|
|
416
|
+
// ---------------------------------------------------------------------------
|
|
417
|
+
// patch-spec command
|
|
418
|
+
// ---------------------------------------------------------------------------
|
|
419
|
+
async function readSpecSource(source, root) {
|
|
420
|
+
let text;
|
|
421
|
+
if (/^https?:\/\//.test(source)) {
|
|
422
|
+
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
|
423
|
+
const fetchFn = globalThis.fetch;
|
|
424
|
+
if (!fetchFn) {
|
|
425
|
+
throw new errors_1.CliError('Fetching --spec from a URL requires a Node version with global fetch (Node 18+).', 2 /* CliExitCode.Fatal */);
|
|
426
|
+
}
|
|
427
|
+
const res = await fetchFn(source);
|
|
428
|
+
if (!res.ok) {
|
|
429
|
+
throw new errors_1.CliError(`Failed to fetch --spec from ${source}: HTTP ${res.status}`, 2 /* CliExitCode.Fatal */);
|
|
430
|
+
}
|
|
431
|
+
text = await res.text();
|
|
432
|
+
}
|
|
433
|
+
else {
|
|
434
|
+
const resolved = (0, parse_args_1.resolveAndValidate)(source, root, '--spec');
|
|
435
|
+
try {
|
|
436
|
+
text = fs.readFileSync(resolved, 'utf8');
|
|
437
|
+
}
|
|
438
|
+
catch (err) {
|
|
439
|
+
throw new errors_1.CliError(`Could not read --spec file at ${resolved}: ${err instanceof Error ? err.message : String(err)}`, 2 /* CliExitCode.Fatal */);
|
|
440
|
+
}
|
|
441
|
+
}
|
|
442
|
+
try {
|
|
443
|
+
return JSON.parse(text);
|
|
444
|
+
}
|
|
445
|
+
catch (err) {
|
|
446
|
+
throw new errors_1.CliError(`--spec did not contain valid JSON: ${err instanceof Error ? err.message : String(err)}`, 2 /* CliExitCode.Fatal */);
|
|
447
|
+
}
|
|
448
|
+
}
|
|
449
|
+
program
|
|
450
|
+
.command('patch-spec')
|
|
451
|
+
.description('Patch an already-built OpenAPI document with every controller\'s companion docs file, ' +
|
|
452
|
+
'using static analysis only — no runtime require(), no decorators applied to any class. ' +
|
|
453
|
+
'Works under any build mode, including NestJS CLI\'s "webpack: true" (see README).')
|
|
454
|
+
.requiredOption('--spec <path-or-url>', 'Path to a local openapi.json, or a URL (e.g. http://localhost:3000/api-json)')
|
|
455
|
+
.option('--out <path>', 'Where to write the patched document (default: stdout)')
|
|
456
|
+
.option('--root <path>', 'Project root directory', '.')
|
|
457
|
+
.option('--tsconfig <path>', 'Path to tsconfig.json (auto-detected if omitted)')
|
|
458
|
+
.option('--pattern <glob>', 'Glob pattern to find controllers', '**/*.controller.ts')
|
|
459
|
+
.option('--format <format>', 'Docs file format to look for: ts or js', 'ts')
|
|
460
|
+
.option('--quiet', 'Suppress all output except errors', false)
|
|
461
|
+
.action(async (rawOpts) => {
|
|
462
|
+
try {
|
|
463
|
+
const options = (0, parse_args_1.parseAndValidateOptions)({
|
|
464
|
+
...rawOpts,
|
|
465
|
+
force: false,
|
|
466
|
+
dryRun: false,
|
|
467
|
+
watch: false,
|
|
468
|
+
});
|
|
469
|
+
(0, logger_1.setQuiet)(options.quiet);
|
|
470
|
+
(0, logger_1.header)('nestjs-docfy patch-spec');
|
|
471
|
+
(0, logger_1.log)('info', `Root: ${options.root}`);
|
|
472
|
+
(0, logger_1.log)('info', `Spec: ${String(rawOpts.spec)}`);
|
|
473
|
+
const document = await readSpecSource(String(rawOpts.spec), options.root);
|
|
474
|
+
const context = (0, detect_project_1.detectProject)(options.root, options.tsconfig);
|
|
475
|
+
const scanResult = (0, scan_controllers_1.scanAllApps)(context.apps, context.root, options.pattern !== '**/*.controller.ts' ? options.pattern : undefined, options.format);
|
|
476
|
+
for (const err of scanResult.errors) {
|
|
477
|
+
(0, logger_1.log)('error', `${err.file}: ${err.message}`);
|
|
478
|
+
}
|
|
479
|
+
const result = (0, patch_spec_1.computePatchedDocument)(document, scanResult.controllers, options.format, (absPath) => {
|
|
480
|
+
try {
|
|
481
|
+
return fs.readFileSync(absPath, 'utf8');
|
|
482
|
+
}
|
|
483
|
+
catch {
|
|
484
|
+
return null;
|
|
485
|
+
}
|
|
486
|
+
});
|
|
487
|
+
(0, logger_1.log)('success', `Patched ${result.patchedOperationCount} operation(s).`);
|
|
488
|
+
if (result.controllersWithoutDocs.length > 0) {
|
|
489
|
+
(0, logger_1.log)('info', `No docs file: ${result.controllersWithoutDocs.join(', ')}`);
|
|
490
|
+
}
|
|
491
|
+
if (result.unparseableDocsFiles.length > 0) {
|
|
492
|
+
(0, logger_1.log)('warn', `Could not parse: ${result.unparseableDocsFiles.join(', ')}`);
|
|
493
|
+
}
|
|
494
|
+
if (result.unmatchedRoutes.length > 0) {
|
|
495
|
+
(0, logger_1.log)('warn', `Documented but not present in --spec: ${result.unmatchedRoutes.join(', ')}`);
|
|
496
|
+
}
|
|
497
|
+
const output = JSON.stringify(result.document, null, 2);
|
|
498
|
+
if (options.out) {
|
|
499
|
+
fs.writeFileSync(options.out, output);
|
|
500
|
+
(0, logger_1.log)('success', `Written to ${options.out}`);
|
|
501
|
+
}
|
|
502
|
+
else {
|
|
503
|
+
process.stdout.write(`${output}\n`);
|
|
504
|
+
}
|
|
505
|
+
process.exit(0 /* CliExitCode.Ok */);
|
|
506
|
+
}
|
|
507
|
+
catch (err) {
|
|
508
|
+
if (err instanceof errors_1.CliError) {
|
|
509
|
+
process.stderr.write(`\n${picocolors_1.default.red('✖ Error:')} ${err.message}\n\n`);
|
|
510
|
+
process.exit(err.exitCode);
|
|
511
|
+
}
|
|
512
|
+
if (err instanceof Error) {
|
|
513
|
+
process.stderr.write(`\n${picocolors_1.default.red('✖ Error:')} ${err.message}\n\n`);
|
|
514
|
+
}
|
|
515
|
+
else {
|
|
516
|
+
process.stderr.write(`\n${picocolors_1.default.red('✖ Unknown error')}\n\n`);
|
|
517
|
+
}
|
|
518
|
+
process.exit(2 /* CliExitCode.Fatal */);
|
|
519
|
+
}
|
|
520
|
+
});
|
|
234
521
|
program.parseAsync(process.argv).catch(() => {
|
|
235
522
|
process.exit(2 /* CliExitCode.Fatal */);
|
|
236
523
|
});
|
package/dist/cli/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import type { ControllerInfo } from './extract-methods';
|
|
2
|
+
export type LintRule = 'missing-summary' | 'missing-400-response' | 'missing-body-description';
|
|
3
|
+
export interface LintIssue {
|
|
4
|
+
controllerClass: string;
|
|
5
|
+
controllerFile: string;
|
|
6
|
+
method: string;
|
|
7
|
+
route: string;
|
|
8
|
+
rule: LintRule;
|
|
9
|
+
message: string;
|
|
10
|
+
}
|
|
11
|
+
interface MethodDocsInfo {
|
|
12
|
+
hasSummary: boolean;
|
|
13
|
+
responseStatuses: Set<number>;
|
|
14
|
+
hasApiBody: boolean;
|
|
15
|
+
hasBodyDescription: boolean;
|
|
16
|
+
}
|
|
17
|
+
/**
|
|
18
|
+
* Parses a docs file's `docs(Controller, { methods: { ... } })` call via AST
|
|
19
|
+
* (not regex) to inspect actual decorator arguments — needed to check for
|
|
20
|
+
* `summary`, `status`, and `description` properties rather than just names.
|
|
21
|
+
*/
|
|
22
|
+
export declare function parseDocsFileMethods(docsFilePath: string): Map<string, MethodDocsInfo>;
|
|
23
|
+
/**
|
|
24
|
+
* Checks documentation quality for already-documented HTTP methods:
|
|
25
|
+
* - Missing `summary` in `ApiOperation`
|
|
26
|
+
* - Missing `400` response for endpoints that accept a request body
|
|
27
|
+
* - Missing `description` on `ApiBody` for endpoints that accept a request body
|
|
28
|
+
*
|
|
29
|
+
* Controllers with no companion docs file, and methods not yet present in
|
|
30
|
+
* the docs file, are skipped — those are reported by the `check` command.
|
|
31
|
+
*/
|
|
32
|
+
export declare function lintControllers(controllers: ControllerInfo[], format: 'ts' | 'js'): LintIssue[];
|
|
33
|
+
export {};
|