nestjs-docfy 0.2.1 → 0.2.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cli/extract-methods.d.ts +22 -1
- package/dist/cli/extract-methods.js +172 -4
- package/dist/cli/extract-methods.js.map +1 -1
- package/dist/cli/generate-file.d.ts +3 -6
- package/dist/cli/generate-file.js +180 -35
- package/dist/cli/generate-file.js.map +1 -1
- package/dist/cli/index.js +97 -58
- package/dist/cli/index.js.map +1 -1
- package/dist/cli/parse-args.d.ts +2 -0
- package/dist/cli/parse-args.js +1 -0
- package/dist/cli/parse-args.js.map +1 -1
- package/dist/cli/scan-controllers.js +3 -1
- package/dist/cli/scan-controllers.js.map +1 -1
- package/dist/cli/watch.d.ts +12 -0
- package/dist/cli/watch.js +112 -0
- package/dist/cli/watch.js.map +1 -0
- package/package.json +1 -1
|
@@ -3,6 +3,21 @@ export interface ParamInfo {
|
|
|
3
3
|
name: string;
|
|
4
4
|
type: string;
|
|
5
5
|
nestDecorator: string | null;
|
|
6
|
+
nestDecoratorArg: string | null;
|
|
7
|
+
bodyType: ResponseTypeInfo | null;
|
|
8
|
+
}
|
|
9
|
+
/**
|
|
10
|
+
* A resolved DTO/entity type suitable for use in ApiResponse/ApiBody({ type: ... }).
|
|
11
|
+
* Only set when the type resolves to a named class or interface from
|
|
12
|
+
* a source file — primitives, inline objects, and unresolvable types are null.
|
|
13
|
+
*/
|
|
14
|
+
export interface ResponseTypeInfo {
|
|
15
|
+
/** Short identifier name, e.g. "RegisterResponseDto" */
|
|
16
|
+
name: string;
|
|
17
|
+
/** Absolute path to the file that declares the type */
|
|
18
|
+
absolutePath: string;
|
|
19
|
+
/** True when the original type was an array, e.g. Promise<User[]> */
|
|
20
|
+
isArray: boolean;
|
|
6
21
|
}
|
|
7
22
|
export interface MethodInfo {
|
|
8
23
|
name: string;
|
|
@@ -10,9 +25,11 @@ export interface MethodInfo {
|
|
|
10
25
|
httpPath: string | null;
|
|
11
26
|
params: ParamInfo[];
|
|
12
27
|
returnType: string;
|
|
28
|
+
responseType: ResponseTypeInfo | null;
|
|
13
29
|
isAsync: boolean;
|
|
14
30
|
isInherited: boolean;
|
|
15
31
|
inheritedFrom: string | null;
|
|
32
|
+
requiresAuth: boolean;
|
|
16
33
|
}
|
|
17
34
|
export interface ControllerInfo {
|
|
18
35
|
className: string;
|
|
@@ -20,13 +37,17 @@ export interface ControllerInfo {
|
|
|
20
37
|
controllerPath: string | null;
|
|
21
38
|
methods: MethodInfo[];
|
|
22
39
|
hasDocsFile: boolean;
|
|
40
|
+
controllerRequiresAuth: boolean;
|
|
23
41
|
}
|
|
24
42
|
/**
|
|
25
43
|
* Extracts public, non-static methods from a controller class declaration.
|
|
26
44
|
* Marks inherited methods (from base classes) but still includes them.
|
|
27
45
|
* Private and protected methods are ignored.
|
|
46
|
+
* controllerAuth: whether the controller-level @UseGuards was detected as JWT.
|
|
28
47
|
*/
|
|
29
|
-
export declare function extractMethods(cls: ClassDeclaration): MethodInfo[];
|
|
48
|
+
export declare function extractMethods(cls: ClassDeclaration, controllerAuth: boolean): MethodInfo[];
|
|
49
|
+
/** Detects whether a controller class itself has a JWT-like @UseGuards. */
|
|
50
|
+
export declare function extractControllerAuth(cls: ClassDeclaration): boolean;
|
|
30
51
|
/**
|
|
31
52
|
* Extracts the path argument from @Controller('path').
|
|
32
53
|
* Returns null if the decorator is absent or has no string argument.
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
3
|
exports.extractMethods = extractMethods;
|
|
4
|
+
exports.extractControllerAuth = extractControllerAuth;
|
|
4
5
|
exports.extractControllerPath = extractControllerPath;
|
|
5
6
|
const ts_morph_1 = require("ts-morph");
|
|
6
7
|
const HTTP_DECORATORS = new Set([
|
|
@@ -10,6 +11,14 @@ const NEST_PARAM_DECORATORS = new Set([
|
|
|
10
11
|
'Param', 'Body', 'Query', 'Headers', 'Req', 'Res', 'Request',
|
|
11
12
|
'Response', 'Session', 'UploadedFile', 'UploadedFiles', 'Ip', 'HostParam',
|
|
12
13
|
]);
|
|
14
|
+
/** Primitives and built-ins that should never appear as ApiResponse/ApiBody type. */
|
|
15
|
+
const SKIP_TYPE_NAMES = new Set([
|
|
16
|
+
'void', 'undefined', 'null', 'never', 'unknown', 'any',
|
|
17
|
+
'string', 'number', 'boolean', 'object', 'symbol', 'bigint',
|
|
18
|
+
'String', 'Number', 'Boolean', 'Object', 'Array',
|
|
19
|
+
'Promise', 'Observable', 'Subject', 'BehaviorSubject',
|
|
20
|
+
]);
|
|
21
|
+
const IDENTIFIER_RE = /^[$_a-zA-Z][$_a-zA-Z0-9]*$/;
|
|
13
22
|
function getDecoratorName(dec) {
|
|
14
23
|
try {
|
|
15
24
|
return dec.getName() ?? null;
|
|
@@ -36,22 +45,99 @@ function getDecoratorFirstStringArg(method, decoratorName) {
|
|
|
36
45
|
return null;
|
|
37
46
|
}
|
|
38
47
|
}
|
|
48
|
+
/** Extracts the first string argument of a parameter-level decorator, e.g. 'id' from @Param('id'). */
|
|
49
|
+
function getParamDecoratorArg(p, decoratorName) {
|
|
50
|
+
try {
|
|
51
|
+
const dec = p.getDecorator(decoratorName);
|
|
52
|
+
if (!dec)
|
|
53
|
+
return null;
|
|
54
|
+
const args = dec.getArguments();
|
|
55
|
+
if (args.length === 0)
|
|
56
|
+
return null;
|
|
57
|
+
const first = args[0];
|
|
58
|
+
if (first.getKind() === ts_morph_1.SyntaxKind.StringLiteral) {
|
|
59
|
+
return first.getText().replace(/^['"`]|['"`]$/g, '');
|
|
60
|
+
}
|
|
61
|
+
return null;
|
|
62
|
+
}
|
|
63
|
+
catch {
|
|
64
|
+
return null;
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
/**
|
|
68
|
+
* Resolves a named DTO/class type from a ts-morph Type.
|
|
69
|
+
* Returns null for primitives, anonymous objects, union/intersection, node_modules, .d.ts.
|
|
70
|
+
*/
|
|
71
|
+
function resolveNamedType(type, isArray) {
|
|
72
|
+
try {
|
|
73
|
+
if (type.isString() || type.isNumber() || type.isBoolean())
|
|
74
|
+
return null;
|
|
75
|
+
if (type.isUndefined() || type.isNull() || type.isVoid())
|
|
76
|
+
return null;
|
|
77
|
+
if (type.isAnonymous())
|
|
78
|
+
return null;
|
|
79
|
+
if (type.isUnion() || type.isIntersection())
|
|
80
|
+
return null;
|
|
81
|
+
if (type.isTuple())
|
|
82
|
+
return null;
|
|
83
|
+
const symbol = type.getSymbol() ?? type.getAliasSymbol();
|
|
84
|
+
if (!symbol)
|
|
85
|
+
return null;
|
|
86
|
+
const name = symbol.getName();
|
|
87
|
+
if (!name || !IDENTIFIER_RE.test(name))
|
|
88
|
+
return null;
|
|
89
|
+
if (SKIP_TYPE_NAMES.has(name))
|
|
90
|
+
return null;
|
|
91
|
+
const declarations = symbol.getDeclarations();
|
|
92
|
+
if (!declarations || declarations.length === 0)
|
|
93
|
+
return null;
|
|
94
|
+
const sourceFile = declarations[0].getSourceFile();
|
|
95
|
+
const absolutePath = sourceFile.getFilePath();
|
|
96
|
+
if (absolutePath.includes('node_modules'))
|
|
97
|
+
return null;
|
|
98
|
+
if (absolutePath.endsWith('.d.ts'))
|
|
99
|
+
return null;
|
|
100
|
+
return { name, absolutePath, isArray };
|
|
101
|
+
}
|
|
102
|
+
catch {
|
|
103
|
+
return null;
|
|
104
|
+
}
|
|
105
|
+
}
|
|
39
106
|
function extractParams(method) {
|
|
40
107
|
try {
|
|
41
108
|
return method.getParameters().map((p) => {
|
|
42
109
|
let nestDecorator = null;
|
|
110
|
+
let nestDecoratorArg = null;
|
|
111
|
+
let decoratorShortName = null;
|
|
43
112
|
for (const dec of p.getDecorators()) {
|
|
44
113
|
const name = getDecoratorName(dec);
|
|
45
114
|
if (name && NEST_PARAM_DECORATORS.has(name)) {
|
|
46
115
|
nestDecorator = `@${name}`;
|
|
116
|
+
decoratorShortName = name;
|
|
117
|
+
nestDecoratorArg = getParamDecoratorArg(p, name);
|
|
47
118
|
break;
|
|
48
119
|
}
|
|
49
120
|
}
|
|
50
121
|
const typeNode = p.getTypeNode();
|
|
122
|
+
const typeText = typeNode ? typeNode.getText() : 'unknown';
|
|
123
|
+
// Resolve DTO type only for @Body() without a field selector
|
|
124
|
+
// @Body('field') means partial body — skip DTO resolution for those
|
|
125
|
+
let bodyType = null;
|
|
126
|
+
if (decoratorShortName === 'Body' && nestDecoratorArg === null) {
|
|
127
|
+
try {
|
|
128
|
+
const paramType = p.getType();
|
|
129
|
+
bodyType = resolveNamedType(paramType, false);
|
|
130
|
+
}
|
|
131
|
+
catch {
|
|
132
|
+
// type resolution is best-effort
|
|
133
|
+
}
|
|
134
|
+
}
|
|
51
135
|
return {
|
|
52
136
|
name: p.getName(),
|
|
53
|
-
type:
|
|
137
|
+
type: typeText,
|
|
54
138
|
nestDecorator,
|
|
139
|
+
nestDecoratorArg,
|
|
140
|
+
bodyType,
|
|
55
141
|
};
|
|
56
142
|
});
|
|
57
143
|
}
|
|
@@ -59,12 +145,79 @@ function extractParams(method) {
|
|
|
59
145
|
return [];
|
|
60
146
|
}
|
|
61
147
|
}
|
|
148
|
+
/**
|
|
149
|
+
* Unwraps Promise<T> → T, and Observable<T> → T.
|
|
150
|
+
* Returns the original type if it's not a wrapper.
|
|
151
|
+
*/
|
|
152
|
+
function unwrapAsync(type) {
|
|
153
|
+
try {
|
|
154
|
+
const name = type.getSymbol()?.getName();
|
|
155
|
+
if (name === 'Promise' || name === 'Observable') {
|
|
156
|
+
const args = type.getTypeArguments();
|
|
157
|
+
if (args.length > 0)
|
|
158
|
+
return args[0];
|
|
159
|
+
}
|
|
160
|
+
}
|
|
161
|
+
catch {
|
|
162
|
+
// ignore
|
|
163
|
+
}
|
|
164
|
+
return type;
|
|
165
|
+
}
|
|
166
|
+
/**
|
|
167
|
+
* Resolves the ResponseTypeInfo for a method's return type.
|
|
168
|
+
* Returns null for primitives, inline objects, void, and unresolvable types.
|
|
169
|
+
*/
|
|
170
|
+
function resolveResponseType(method) {
|
|
171
|
+
try {
|
|
172
|
+
const rawType = method.getReturnType();
|
|
173
|
+
const inner = unwrapAsync(rawType);
|
|
174
|
+
let isArray = false;
|
|
175
|
+
let elementType = inner;
|
|
176
|
+
if (inner.isArray()) {
|
|
177
|
+
isArray = true;
|
|
178
|
+
elementType = inner.getArrayElementTypeOrThrow();
|
|
179
|
+
}
|
|
180
|
+
return resolveNamedType(elementType, isArray);
|
|
181
|
+
}
|
|
182
|
+
catch {
|
|
183
|
+
return null;
|
|
184
|
+
}
|
|
185
|
+
}
|
|
186
|
+
/**
|
|
187
|
+
* Strips ts-morph's fully-qualified import paths from inferred type text.
|
|
188
|
+
* e.g. Promise<import("/abs/path/foo.dto").FooDto> → Promise<FooDto>
|
|
189
|
+
*/
|
|
190
|
+
function cleanTypeText(text) {
|
|
191
|
+
return text.replace(/import\([^)]+\)\./g, '');
|
|
192
|
+
}
|
|
193
|
+
/**
|
|
194
|
+
* Returns true if any @UseGuards argument looks like a JWT/auth guard.
|
|
195
|
+
* Matches names containing 'Jwt', 'Auth', or 'Bearer' (case-insensitive).
|
|
196
|
+
*/
|
|
197
|
+
function hasJwtGuard(decorators) {
|
|
198
|
+
for (const dec of decorators) {
|
|
199
|
+
try {
|
|
200
|
+
if (dec.getName() !== 'UseGuards')
|
|
201
|
+
continue;
|
|
202
|
+
for (const arg of dec.getArguments()) {
|
|
203
|
+
const text = arg.getText();
|
|
204
|
+
if (/jwt|auth|bearer/i.test(text))
|
|
205
|
+
return true;
|
|
206
|
+
}
|
|
207
|
+
}
|
|
208
|
+
catch {
|
|
209
|
+
// ignore
|
|
210
|
+
}
|
|
211
|
+
}
|
|
212
|
+
return false;
|
|
213
|
+
}
|
|
62
214
|
/**
|
|
63
215
|
* Extracts public, non-static methods from a controller class declaration.
|
|
64
216
|
* Marks inherited methods (from base classes) but still includes them.
|
|
65
217
|
* Private and protected methods are ignored.
|
|
218
|
+
* controllerAuth: whether the controller-level @UseGuards was detected as JWT.
|
|
66
219
|
*/
|
|
67
|
-
function extractMethods(cls) {
|
|
220
|
+
function extractMethods(cls, controllerAuth) {
|
|
68
221
|
const results = [];
|
|
69
222
|
const ownMethodNames = new Set(cls.getMethods().map((m) => m.getName()));
|
|
70
223
|
// Own methods
|
|
@@ -90,20 +243,24 @@ function extractMethods(cls) {
|
|
|
90
243
|
const returnTypeNode = method.getReturnTypeNode();
|
|
91
244
|
returnType = returnTypeNode
|
|
92
245
|
? returnTypeNode.getText()
|
|
93
|
-
: method.getReturnType().getText();
|
|
246
|
+
: cleanTypeText(method.getReturnType().getText());
|
|
94
247
|
}
|
|
95
248
|
catch {
|
|
96
249
|
// ts-morph can fail to infer complex types — keep 'unknown'
|
|
97
250
|
}
|
|
251
|
+
const responseType = resolveResponseType(method);
|
|
252
|
+
const methodAuth = hasJwtGuard(method.getDecorators());
|
|
98
253
|
results.push({
|
|
99
254
|
name: method.getName(),
|
|
100
255
|
httpDecorator,
|
|
101
256
|
httpPath,
|
|
102
257
|
params: extractParams(method),
|
|
103
258
|
returnType,
|
|
259
|
+
responseType,
|
|
104
260
|
isAsync: method.isAsync(),
|
|
105
261
|
isInherited: false,
|
|
106
262
|
inheritedFrom: null,
|
|
263
|
+
requiresAuth: controllerAuth || methodAuth,
|
|
107
264
|
});
|
|
108
265
|
}
|
|
109
266
|
// Inherited methods from base class(es)
|
|
@@ -119,7 +276,7 @@ function extractMethods(cls) {
|
|
|
119
276
|
if (method.isStatic())
|
|
120
277
|
continue;
|
|
121
278
|
if (ownMethodNames.has(method.getName()))
|
|
122
|
-
continue;
|
|
279
|
+
continue;
|
|
123
280
|
let httpDecorator = null;
|
|
124
281
|
for (const dec of method.getDecorators()) {
|
|
125
282
|
const name = getDecoratorName(dec);
|
|
@@ -134,9 +291,11 @@ function extractMethods(cls) {
|
|
|
134
291
|
httpPath: null,
|
|
135
292
|
params: extractParams(method),
|
|
136
293
|
returnType: 'unknown',
|
|
294
|
+
responseType: null,
|
|
137
295
|
isAsync: method.isAsync(),
|
|
138
296
|
isInherited: true,
|
|
139
297
|
inheritedFrom: baseClassName,
|
|
298
|
+
requiresAuth: controllerAuth || hasJwtGuard(method.getDecorators()),
|
|
140
299
|
});
|
|
141
300
|
}
|
|
142
301
|
}
|
|
@@ -146,6 +305,15 @@ function extractMethods(cls) {
|
|
|
146
305
|
}
|
|
147
306
|
return results;
|
|
148
307
|
}
|
|
308
|
+
/** Detects whether a controller class itself has a JWT-like @UseGuards. */
|
|
309
|
+
function extractControllerAuth(cls) {
|
|
310
|
+
try {
|
|
311
|
+
return hasJwtGuard(cls.getDecorators());
|
|
312
|
+
}
|
|
313
|
+
catch {
|
|
314
|
+
return false;
|
|
315
|
+
}
|
|
316
|
+
}
|
|
149
317
|
/**
|
|
150
318
|
* Extracts the path argument from @Controller('path').
|
|
151
319
|
* Returns null if the decorator is absent or has no string argument.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"extract-methods.js","sourceRoot":"","sources":["../../src/cli/extract-methods.ts"],"names":[],"mappings":";;
|
|
1
|
+
{"version":3,"file":"extract-methods.js","sourceRoot":"","sources":["../../src/cli/extract-methods.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,11 +1,8 @@
|
|
|
1
1
|
import type { ControllerInfo } from './extract-methods';
|
|
2
|
-
/**
|
|
3
|
-
* Computes the relative import path from the generated docs file to the
|
|
4
|
-
* controller file, stripping the .ts extension (CommonJS/ESM convention).
|
|
5
|
-
*/
|
|
6
2
|
export declare function relativeImport(docsFilePath: string, controllerFilePath: string): string;
|
|
7
3
|
/**
|
|
8
|
-
*
|
|
9
|
-
*
|
|
4
|
+
* Converts a camelCase method name into a human-readable Swagger summary.
|
|
5
|
+
* findAll → "Find all", createUser → "Create user", getProfileById → "Get profile by id"
|
|
10
6
|
*/
|
|
7
|
+
export declare function inferSummary(methodName: string): string;
|
|
11
8
|
export declare function renderDocsFile(ctrl: ControllerInfo, docsFilePath: string, format: 'ts' | 'js'): string;
|
|
@@ -4,27 +4,27 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
|
4
4
|
};
|
|
5
5
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
6
|
exports.relativeImport = relativeImport;
|
|
7
|
+
exports.inferSummary = inferSummary;
|
|
7
8
|
exports.renderDocsFile = renderDocsFile;
|
|
8
9
|
const path_1 = __importDefault(require("path"));
|
|
9
10
|
// ---------------------------------------------------------------------------
|
|
10
|
-
// Sanitisation helpers
|
|
11
|
-
// string interpolation so they can never inject executable code.
|
|
11
|
+
// Sanitisation helpers
|
|
12
12
|
// ---------------------------------------------------------------------------
|
|
13
|
-
/** Whitelist for JS identifiers: letters, digits, $ and _. */
|
|
14
13
|
const IDENTIFIER_RE = /^[$_a-zA-Z][$_a-zA-Z0-9]*$/;
|
|
15
14
|
function sanitizeIdentifier(value, fallback) {
|
|
16
15
|
return IDENTIFIER_RE.test(value) ? value : fallback;
|
|
17
16
|
}
|
|
18
|
-
/** Strips characters that could close a JS string or inject code into a comment. */
|
|
19
17
|
function sanitizeComment(value) {
|
|
20
18
|
return value.replace(/[`'"\\*]/g, '').slice(0, 200);
|
|
21
19
|
}
|
|
22
|
-
/** Escapes a URL path for safe use inside a line comment. */
|
|
23
20
|
function sanitizeHttpPath(value) {
|
|
24
21
|
if (!value)
|
|
25
22
|
return '';
|
|
26
23
|
return '/' + value.replace(/[^a-zA-Z0-9/_:.-]/g, '');
|
|
27
24
|
}
|
|
25
|
+
function sanitizeParamName(value) {
|
|
26
|
+
return value.replace(/[^a-zA-Z0-9_-]/g, '').slice(0, 100);
|
|
27
|
+
}
|
|
28
28
|
// ---------------------------------------------------------------------------
|
|
29
29
|
// HTTP verb → default success status code
|
|
30
30
|
// ---------------------------------------------------------------------------
|
|
@@ -32,21 +32,75 @@ function defaultStatusCode(httpDecorator) {
|
|
|
32
32
|
switch (httpDecorator) {
|
|
33
33
|
case 'Post': return 201;
|
|
34
34
|
case 'Delete': return 204;
|
|
35
|
-
default: return 200;
|
|
35
|
+
default: return 200;
|
|
36
36
|
}
|
|
37
37
|
}
|
|
38
38
|
// ---------------------------------------------------------------------------
|
|
39
39
|
// Import path resolution
|
|
40
40
|
// ---------------------------------------------------------------------------
|
|
41
|
-
/**
|
|
42
|
-
* Computes the relative import path from the generated docs file to the
|
|
43
|
-
* controller file, stripping the .ts extension (CommonJS/ESM convention).
|
|
44
|
-
*/
|
|
45
41
|
function relativeImport(docsFilePath, controllerFilePath) {
|
|
46
42
|
const rel = path_1.default.relative(path_1.default.dirname(docsFilePath), controllerFilePath);
|
|
47
43
|
const withoutExt = rel.replace(/\.ts$/, '');
|
|
48
44
|
return withoutExt.startsWith('.') ? withoutExt : `./${withoutExt}`;
|
|
49
45
|
}
|
|
46
|
+
function resolvedImportPath(docsFilePath, absolutePath) {
|
|
47
|
+
const rel = path_1.default.relative(path_1.default.dirname(docsFilePath), absolutePath);
|
|
48
|
+
const importPath = rel.replace(/\.ts$/, '').replace(/\\/g, '/');
|
|
49
|
+
return importPath.startsWith('.') ? importPath : `./${importPath}`;
|
|
50
|
+
}
|
|
51
|
+
// ---------------------------------------------------------------------------
|
|
52
|
+
// Primitive TypeScript type → JavaScript constructor name
|
|
53
|
+
// ---------------------------------------------------------------------------
|
|
54
|
+
const PRIMITIVE_MAP = {
|
|
55
|
+
string: 'String',
|
|
56
|
+
number: 'Number',
|
|
57
|
+
boolean: 'Boolean',
|
|
58
|
+
};
|
|
59
|
+
/**
|
|
60
|
+
* Maps a TS primitive type string to its JS constructor for Swagger.
|
|
61
|
+
* Returns null for non-primitives (DTOs, unknown, etc.).
|
|
62
|
+
*/
|
|
63
|
+
function primitiveToConstructor(tsType) {
|
|
64
|
+
const base = tsType.replace(/\[\]$/, '').trim();
|
|
65
|
+
return PRIMITIVE_MAP[base] ?? null;
|
|
66
|
+
}
|
|
67
|
+
function collectDtoImports(methods, docsFilePath) {
|
|
68
|
+
const seen = new Map(); // name → importPath
|
|
69
|
+
const register = (rt) => {
|
|
70
|
+
if (!rt)
|
|
71
|
+
return;
|
|
72
|
+
if (!IDENTIFIER_RE.test(rt.name))
|
|
73
|
+
return;
|
|
74
|
+
if (seen.has(rt.name))
|
|
75
|
+
return;
|
|
76
|
+
seen.set(rt.name, resolvedImportPath(docsFilePath, rt.absolutePath));
|
|
77
|
+
};
|
|
78
|
+
for (const m of methods) {
|
|
79
|
+
register(m.responseType);
|
|
80
|
+
for (const p of m.params) {
|
|
81
|
+
register(p.bodyType ?? null);
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
return Array.from(seen.entries()).map(([name, importPath]) => ({ name, importPath }));
|
|
85
|
+
}
|
|
86
|
+
function collectSwaggerDecorators(ctrl) {
|
|
87
|
+
const used = new Set(['ApiTags', 'ApiOperation', 'ApiResponse']);
|
|
88
|
+
for (const m of ctrl.methods) {
|
|
89
|
+
if (m.requiresAuth)
|
|
90
|
+
used.add('ApiBearerAuth');
|
|
91
|
+
for (const p of m.params) {
|
|
92
|
+
if (p.nestDecorator === '@Param' && p.nestDecoratorArg !== null)
|
|
93
|
+
used.add('ApiParam');
|
|
94
|
+
if (p.nestDecorator === '@Query' && p.nestDecoratorArg !== null)
|
|
95
|
+
used.add('ApiQuery');
|
|
96
|
+
if (p.nestDecorator === '@Body' && p.nestDecoratorArg === null)
|
|
97
|
+
used.add('ApiBody');
|
|
98
|
+
}
|
|
99
|
+
}
|
|
100
|
+
if (ctrl.controllerRequiresAuth)
|
|
101
|
+
used.add('ApiBearerAuth');
|
|
102
|
+
return used;
|
|
103
|
+
}
|
|
50
104
|
// ---------------------------------------------------------------------------
|
|
51
105
|
// Method signature comment
|
|
52
106
|
// ---------------------------------------------------------------------------
|
|
@@ -66,52 +120,143 @@ function methodSignatureComment(m) {
|
|
|
66
120
|
return `${route}${asyncPrefix}${methodName}(${paramList}): ${returnType}${inherited}`;
|
|
67
121
|
}
|
|
68
122
|
// ---------------------------------------------------------------------------
|
|
69
|
-
//
|
|
123
|
+
// Per-param decorator renderers
|
|
124
|
+
// ---------------------------------------------------------------------------
|
|
125
|
+
function renderApiParam(p, indent) {
|
|
126
|
+
if (p.nestDecorator !== '@Param' || p.nestDecoratorArg === null)
|
|
127
|
+
return null;
|
|
128
|
+
const name = sanitizeParamName(p.nestDecoratorArg);
|
|
129
|
+
if (!name)
|
|
130
|
+
return null;
|
|
131
|
+
const constructor = primitiveToConstructor(p.type) ?? 'String';
|
|
132
|
+
return `${indent}ApiParam({ name: '${name}', type: ${constructor} }),`;
|
|
133
|
+
}
|
|
134
|
+
function renderApiQuery(p, indent) {
|
|
135
|
+
if (p.nestDecorator !== '@Query' || p.nestDecoratorArg === null)
|
|
136
|
+
return null;
|
|
137
|
+
const name = sanitizeParamName(p.nestDecoratorArg);
|
|
138
|
+
if (!name)
|
|
139
|
+
return null;
|
|
140
|
+
const constructor = primitiveToConstructor(p.type) ?? 'String';
|
|
141
|
+
const required = !p.type.includes('?') && !p.type.includes('undefined');
|
|
142
|
+
return `${indent}ApiQuery({ name: '${name}', type: ${constructor}, required: ${required} }),`;
|
|
143
|
+
}
|
|
144
|
+
function renderApiBody(p, indent) {
|
|
145
|
+
if (p.nestDecorator !== '@Body' || p.nestDecoratorArg !== null)
|
|
146
|
+
return null;
|
|
147
|
+
if (p.bodyType && IDENTIFIER_RE.test(p.bodyType.name)) {
|
|
148
|
+
return `${indent}ApiBody({ type: ${p.bodyType.name} }),`;
|
|
149
|
+
}
|
|
150
|
+
const constructor = primitiveToConstructor(p.type);
|
|
151
|
+
if (constructor) {
|
|
152
|
+
return `${indent}ApiBody({ type: ${constructor} }),`;
|
|
153
|
+
}
|
|
154
|
+
return null;
|
|
155
|
+
}
|
|
156
|
+
// ---------------------------------------------------------------------------
|
|
157
|
+
// ApiResponse rendering
|
|
158
|
+
// ---------------------------------------------------------------------------
|
|
159
|
+
function renderApiResponse(status, responseType) {
|
|
160
|
+
if (!responseType || !IDENTIFIER_RE.test(responseType.name)) {
|
|
161
|
+
return `ApiResponse({ status: ${status} })`;
|
|
162
|
+
}
|
|
163
|
+
const typePart = responseType.isArray
|
|
164
|
+
? `[${responseType.name}]`
|
|
165
|
+
: responseType.name;
|
|
166
|
+
return `ApiResponse({ status: ${status}, type: ${typePart} })`;
|
|
167
|
+
}
|
|
168
|
+
// ---------------------------------------------------------------------------
|
|
169
|
+
// Summary inference
|
|
170
|
+
// ---------------------------------------------------------------------------
|
|
171
|
+
/**
|
|
172
|
+
* Converts a camelCase method name into a human-readable Swagger summary.
|
|
173
|
+
* findAll → "Find all", createUser → "Create user", getProfileById → "Get profile by id"
|
|
174
|
+
*/
|
|
175
|
+
function inferSummary(methodName) {
|
|
176
|
+
const words = methodName
|
|
177
|
+
.replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2') // HTTPMethod → HTTP Method
|
|
178
|
+
.replace(/([a-z\d])([A-Z])/g, '$1 $2') // camelCase → camel Case
|
|
179
|
+
.split(' ')
|
|
180
|
+
.filter(Boolean);
|
|
181
|
+
if (words.length === 0)
|
|
182
|
+
return '';
|
|
183
|
+
return words
|
|
184
|
+
.map((w, i) => (i === 0 ? w.charAt(0).toUpperCase() + w.slice(1).toLowerCase() : w.toLowerCase()))
|
|
185
|
+
.join(' ');
|
|
186
|
+
}
|
|
187
|
+
// ---------------------------------------------------------------------------
|
|
188
|
+
// Method block
|
|
70
189
|
// ---------------------------------------------------------------------------
|
|
71
190
|
function renderMethod(m, indent) {
|
|
72
191
|
const name = sanitizeIdentifier(m.name, '_method');
|
|
73
192
|
const sig = methodSignatureComment(m);
|
|
74
193
|
const status = defaultStatusCode(m.httpDecorator);
|
|
75
|
-
const
|
|
76
|
-
|
|
77
|
-
lines
|
|
78
|
-
|
|
79
|
-
|
|
194
|
+
const summary = inferSummary(name); // use sanitized name, not raw m.name
|
|
195
|
+
const inner = `${indent} `;
|
|
196
|
+
const lines = [
|
|
197
|
+
`${indent}// ${sig}`,
|
|
198
|
+
`${indent}${name}: [`,
|
|
199
|
+
`${inner}ApiOperation({ summary: '${summary}' }),`,
|
|
200
|
+
];
|
|
201
|
+
if (m.requiresAuth)
|
|
202
|
+
lines.push(`${inner}ApiBearerAuth(),`);
|
|
203
|
+
for (const p of m.params) {
|
|
204
|
+
const paramLine = renderApiParam(p, inner)
|
|
205
|
+
?? renderApiQuery(p, inner)
|
|
206
|
+
?? renderApiBody(p, inner);
|
|
207
|
+
if (paramLine)
|
|
208
|
+
lines.push(paramLine);
|
|
209
|
+
}
|
|
210
|
+
lines.push(`${inner}${renderApiResponse(status, m.responseType)},`);
|
|
80
211
|
lines.push(`${indent}],`);
|
|
81
212
|
return lines.join('\n');
|
|
82
213
|
}
|
|
214
|
+
// ---------------------------------------------------------------------------
|
|
215
|
+
// ApiTags value
|
|
216
|
+
// ---------------------------------------------------------------------------
|
|
83
217
|
function apiTagValue(ctrl) {
|
|
84
218
|
if (ctrl.controllerPath)
|
|
85
219
|
return sanitizeComment(ctrl.controllerPath);
|
|
86
220
|
return sanitizeComment(ctrl.className.replace(/Controller$/, '').toLowerCase());
|
|
87
221
|
}
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
*/
|
|
222
|
+
// ---------------------------------------------------------------------------
|
|
223
|
+
// Full file renderer
|
|
224
|
+
// ---------------------------------------------------------------------------
|
|
92
225
|
function renderDocsFile(ctrl, docsFilePath, format) {
|
|
93
226
|
const importPath = relativeImport(docsFilePath, ctrl.filePath);
|
|
94
227
|
const className = sanitizeIdentifier(ctrl.className, 'Controller');
|
|
95
|
-
const controllerRoute = ctrl.controllerPath !== null
|
|
96
|
-
? ` (route: "${sanitizeHttpPath(ctrl.controllerPath)}")`
|
|
97
|
-
: '';
|
|
98
|
-
const timestamp = new Date().toISOString();
|
|
99
228
|
const tag = apiTagValue(ctrl);
|
|
229
|
+
const dtoImports = collectDtoImports(ctrl.methods, docsFilePath);
|
|
230
|
+
const swaggerDecorators = collectSwaggerDecorators(ctrl);
|
|
231
|
+
const swaggerImportList = [
|
|
232
|
+
'ApiTags', 'ApiOperation', 'ApiResponse',
|
|
233
|
+
...(swaggerDecorators.has('ApiBearerAuth') ? ['ApiBearerAuth'] : []),
|
|
234
|
+
...(swaggerDecorators.has('ApiParam') ? ['ApiParam'] : []),
|
|
235
|
+
...(swaggerDecorators.has('ApiQuery') ? ['ApiQuery'] : []),
|
|
236
|
+
...(swaggerDecorators.has('ApiBody') ? ['ApiBody'] : []),
|
|
237
|
+
].join(', ');
|
|
238
|
+
const classDecoratorLines = [
|
|
239
|
+
` ApiTags('${tag}'),`,
|
|
240
|
+
...(ctrl.controllerRequiresAuth ? [` ApiBearerAuth(),`] : []),
|
|
241
|
+
].join('\n');
|
|
100
242
|
const methodsBlock = ctrl.methods.length === 0
|
|
101
243
|
? ' // No public HTTP methods found.'
|
|
102
244
|
: ctrl.methods.map((m) => renderMethod(m, ' ')).join('\n\n');
|
|
103
245
|
if (format === 'js') {
|
|
246
|
+
const requireLines = dtoImports
|
|
247
|
+
.map((i) => `const { ${i.name} } = require('${i.importPath}');`)
|
|
248
|
+
.join('\n');
|
|
104
249
|
return [
|
|
105
|
-
`// Auto-generated by nestjs-docfy`,
|
|
106
|
-
`// Generated: ${timestamp}`,
|
|
250
|
+
`// Auto-generated by nestjs-docfy — do not edit manually`,
|
|
107
251
|
``,
|
|
108
252
|
`const { docs } = require('nestjs-docfy');`,
|
|
109
|
-
`const {
|
|
253
|
+
`const { ${swaggerImportList} } = require('@nestjs/swagger');`,
|
|
110
254
|
`const { ${className} } = require('${importPath}');`,
|
|
255
|
+
...(requireLines ? [requireLines] : []),
|
|
111
256
|
``,
|
|
112
257
|
`docs(${className}, {`,
|
|
113
258
|
` classDecorators: [`,
|
|
114
|
-
|
|
259
|
+
classDecoratorLines,
|
|
115
260
|
` ],`,
|
|
116
261
|
` methods: {`,
|
|
117
262
|
methodsBlock.split('\n').map((l) => (l ? ` ${l}` : l)).join('\n'),
|
|
@@ -120,19 +265,19 @@ function renderDocsFile(ctrl, docsFilePath, format) {
|
|
|
120
265
|
``,
|
|
121
266
|
].join('\n');
|
|
122
267
|
}
|
|
268
|
+
const importLines = dtoImports
|
|
269
|
+
.map((i) => `import { ${i.name} } from '${i.importPath}';`)
|
|
270
|
+
.join('\n');
|
|
123
271
|
return [
|
|
124
|
-
|
|
125
|
-
` * Auto-generated by nestjs-docfy`,
|
|
126
|
-
` * Controller: ${className}${controllerRoute}`,
|
|
127
|
-
` * Generated: ${timestamp}`,
|
|
128
|
-
` */`,
|
|
272
|
+
`// Auto-generated by nestjs-docfy — do not edit manually`,
|
|
129
273
|
`import { docs } from 'nestjs-docfy';`,
|
|
130
|
-
`import {
|
|
274
|
+
`import { ${swaggerImportList} } from '@nestjs/swagger';`,
|
|
131
275
|
`import { ${className} } from '${importPath}';`,
|
|
276
|
+
...(importLines ? [importLines] : []),
|
|
132
277
|
``,
|
|
133
278
|
`docs(${className}, {`,
|
|
134
279
|
` classDecorators: [`,
|
|
135
|
-
|
|
280
|
+
classDecoratorLines,
|
|
136
281
|
` ],`,
|
|
137
282
|
` methods: {`,
|
|
138
283
|
methodsBlock,
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"generate-file.js","sourceRoot":"","sources":["../../src/cli/generate-file.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"generate-file.js","sourceRoot":"","sources":["../../src/cli/generate-file.ts"],"names":[],"mappings":"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"}
|
package/dist/cli/index.js
CHANGED
|
@@ -12,6 +12,7 @@ const errors_1 = require("./errors");
|
|
|
12
12
|
const detect_project_1 = require("./detect-project");
|
|
13
13
|
const scan_controllers_1 = require("./scan-controllers");
|
|
14
14
|
const writer_1 = require("./writer");
|
|
15
|
+
const watch_1 = require("./watch");
|
|
15
16
|
const program = new commander_1.Command();
|
|
16
17
|
program
|
|
17
18
|
.name('nestjs-docfy')
|
|
@@ -19,6 +20,68 @@ program
|
|
|
19
20
|
.version(
|
|
20
21
|
// eslint-disable-next-line @typescript-eslint/no-var-requires
|
|
21
22
|
require('../../package.json').version, '-v, --version');
|
|
23
|
+
// ---------------------------------------------------------------------------
|
|
24
|
+
// Shared pipeline: detect → scan → write
|
|
25
|
+
// Returns number of errors (0 = success).
|
|
26
|
+
// ---------------------------------------------------------------------------
|
|
27
|
+
function runPipeline(options, silent = false) {
|
|
28
|
+
const context = (0, detect_project_1.detectProject)(options.root, options.tsconfig);
|
|
29
|
+
if (!silent) {
|
|
30
|
+
const kindLabel = {
|
|
31
|
+
'simple': 'Simple project',
|
|
32
|
+
'nx': 'NX Monorepo',
|
|
33
|
+
'nest-cli-monorepo': 'Nest CLI Monorepo',
|
|
34
|
+
'generic-monorepo': 'Generic Monorepo',
|
|
35
|
+
};
|
|
36
|
+
(0, logger_1.log)('success', `Project type: ${kindLabel[context.kind]} (${context.apps.length} app${context.apps.length !== 1 ? 's' : ''})`);
|
|
37
|
+
}
|
|
38
|
+
const scanResult = (0, scan_controllers_1.scanAllApps)(context.apps, context.root, options.pattern !== '**/*.controller.ts' ? options.pattern : undefined, options.format);
|
|
39
|
+
for (const err of scanResult.errors) {
|
|
40
|
+
(0, logger_1.log)('error', `${err.file}: ${err.message}`);
|
|
41
|
+
}
|
|
42
|
+
if (scanResult.controllers.length === 0 && scanResult.errors.length === 0) {
|
|
43
|
+
if (!silent)
|
|
44
|
+
(0, logger_1.log)('warn', 'No controllers found matching the pattern.');
|
|
45
|
+
return 0;
|
|
46
|
+
}
|
|
47
|
+
const writeResults = (0, writer_1.writeAllDocs)(scanResult.controllers, {
|
|
48
|
+
projectRoot: context.root,
|
|
49
|
+
outDir: options.out,
|
|
50
|
+
force: options.force,
|
|
51
|
+
dryRun: options.dryRun,
|
|
52
|
+
format: options.format,
|
|
53
|
+
});
|
|
54
|
+
let created = 0, skipped = 0, errors = scanResult.errors.length;
|
|
55
|
+
for (const r of writeResults) {
|
|
56
|
+
switch (r.outcome) {
|
|
57
|
+
case 'created':
|
|
58
|
+
(0, logger_1.log)('success', `${r.controllerClass} → ${r.docsFilePath} ${picocolors_1.default.green('[created]')}`);
|
|
59
|
+
created++;
|
|
60
|
+
break;
|
|
61
|
+
case 'merged':
|
|
62
|
+
(0, logger_1.log)('success', `${r.controllerClass} → ${r.docsFilePath} ${picocolors_1.default.cyan('[merged]')}${r.addedMethods?.length ? ` (+${r.addedMethods.join(', ')})` : ''}`);
|
|
63
|
+
created++;
|
|
64
|
+
break;
|
|
65
|
+
case 'skipped':
|
|
66
|
+
(0, logger_1.log)('skip', `${r.controllerClass} → ${r.docsFilePath} ${picocolors_1.default.gray('[skipped — already exists]')}`);
|
|
67
|
+
skipped++;
|
|
68
|
+
break;
|
|
69
|
+
case 'dry':
|
|
70
|
+
break;
|
|
71
|
+
case 'error':
|
|
72
|
+
(0, logger_1.log)('error', `${r.controllerClass}: ${r.error}`);
|
|
73
|
+
errors++;
|
|
74
|
+
break;
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
if (!options.dryRun && !silent) {
|
|
78
|
+
(0, logger_1.summary)(created, skipped, errors);
|
|
79
|
+
}
|
|
80
|
+
return errors;
|
|
81
|
+
}
|
|
82
|
+
// ---------------------------------------------------------------------------
|
|
83
|
+
// generate command
|
|
84
|
+
// ---------------------------------------------------------------------------
|
|
22
85
|
program
|
|
23
86
|
.command('generate')
|
|
24
87
|
.description('Scan controllers and generate *.controller.docs.ts files')
|
|
@@ -30,6 +93,7 @@ program
|
|
|
30
93
|
.option('--dry-run', 'Print what would be generated without writing files', false)
|
|
31
94
|
.option('--quiet', 'Suppress all output except errors', false)
|
|
32
95
|
.option('--format <format>', 'Output format: ts or js', 'ts')
|
|
96
|
+
.option('--watch', 'Re-generate on controller file changes', false)
|
|
33
97
|
.action(async (rawOpts) => {
|
|
34
98
|
try {
|
|
35
99
|
const options = (0, parse_args_1.parseAndValidateOptions)(rawOpts);
|
|
@@ -49,66 +113,41 @@ program
|
|
|
49
113
|
(0, logger_1.log)('warn', 'Force mode — new methods merged, existing decorators preserved.');
|
|
50
114
|
if (options.dryRun)
|
|
51
115
|
(0, logger_1.log)('dry', 'Dry-run mode — no files will be written.');
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
};
|
|
60
|
-
(0, logger_1.log)('success', `Project type detected: ${kindLabel[context.kind]} (${context.apps.length} app${context.apps.length !== 1 ? 's' : ''})`);
|
|
61
|
-
for (const app of context.apps) {
|
|
62
|
-
(0, logger_1.log)('info', ` App "${app.name}" → ${app.tsconfig}`);
|
|
63
|
-
}
|
|
64
|
-
// ── Scan controllers ────────────────────────────────────────────────
|
|
65
|
-
(0, logger_1.header)('Scanning controllers...');
|
|
66
|
-
const scanResult = (0, scan_controllers_1.scanAllApps)(context.apps, context.root, options.pattern !== '**/*.controller.ts' ? options.pattern : undefined, options.format);
|
|
67
|
-
for (const err of scanResult.errors) {
|
|
68
|
-
(0, logger_1.log)('error', `${err.file}: ${err.message}`);
|
|
116
|
+
if (options.watch)
|
|
117
|
+
(0, logger_1.log)('info', 'Watch mode enabled.');
|
|
118
|
+
// Initial run
|
|
119
|
+
const initialErrors = runPipeline(options);
|
|
120
|
+
if (!options.watch) {
|
|
121
|
+
process.exit(initialErrors > 0 ? 1 /* CliExitCode.PartialError */ : 0 /* CliExitCode.Ok */);
|
|
122
|
+
return;
|
|
69
123
|
}
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
124
|
+
// Watch mode: re-run pipeline on changes, force=true so new methods are merged
|
|
125
|
+
const watchOptions = { ...options, force: true, quiet: true };
|
|
126
|
+
const stopWatching = (0, watch_1.watchProject)({
|
|
127
|
+
root: options.root,
|
|
128
|
+
pattern: options.pattern,
|
|
129
|
+
onRebuild: () => {
|
|
130
|
+
try {
|
|
131
|
+
runPipeline(watchOptions, false);
|
|
132
|
+
}
|
|
133
|
+
catch (err) {
|
|
134
|
+
if (err instanceof errors_1.CliError) {
|
|
135
|
+
(0, logger_1.log)('error', err.message);
|
|
136
|
+
}
|
|
137
|
+
else if (err instanceof Error) {
|
|
138
|
+
(0, logger_1.log)('error', err.message);
|
|
139
|
+
}
|
|
140
|
+
}
|
|
141
|
+
},
|
|
83
142
|
});
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
(0, logger_1.log)('success', `${r.controllerClass} → ${r.docsFilePath} ${picocolors_1.default.cyan('[merged]')}${r.addedMethods?.length ? ` (+${r.addedMethods.join(', ')})` : ''}`);
|
|
93
|
-
created++;
|
|
94
|
-
break;
|
|
95
|
-
case 'skipped':
|
|
96
|
-
(0, logger_1.log)('skip', `${r.controllerClass} → ${r.docsFilePath} ${picocolors_1.default.gray('[skipped — already exists]')}`);
|
|
97
|
-
skipped++;
|
|
98
|
-
break;
|
|
99
|
-
case 'dry':
|
|
100
|
-
// output already written inline by writer
|
|
101
|
-
break;
|
|
102
|
-
case 'error':
|
|
103
|
-
(0, logger_1.log)('error', `${r.controllerClass}: ${r.error}`);
|
|
104
|
-
errors++;
|
|
105
|
-
break;
|
|
106
|
-
}
|
|
107
|
-
}
|
|
108
|
-
if (!options.dryRun) {
|
|
109
|
-
(0, logger_1.summary)(created, skipped, errors);
|
|
110
|
-
}
|
|
111
|
-
process.exit(errors > 0 ? 1 /* CliExitCode.PartialError */ : 0 /* CliExitCode.Ok */);
|
|
143
|
+
// Graceful shutdown
|
|
144
|
+
const shutdown = () => {
|
|
145
|
+
stopWatching();
|
|
146
|
+
(0, logger_1.log)('info', 'Watch stopped.');
|
|
147
|
+
process.exit(0 /* CliExitCode.Ok */);
|
|
148
|
+
};
|
|
149
|
+
process.on('SIGINT', shutdown);
|
|
150
|
+
process.on('SIGTERM', shutdown);
|
|
112
151
|
}
|
|
113
152
|
catch (err) {
|
|
114
153
|
if (err instanceof errors_1.CliError) {
|
package/dist/cli/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";;;;;;AACA,yCAAoC;AACpC,4DAA4B;AAC5B,
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}
|
package/dist/cli/parse-args.d.ts
CHANGED
|
@@ -8,6 +8,7 @@ export interface CliOptions {
|
|
|
8
8
|
dryRun: boolean;
|
|
9
9
|
quiet: boolean;
|
|
10
10
|
format: OutputFormat;
|
|
11
|
+
watch: boolean;
|
|
11
12
|
}
|
|
12
13
|
/**
|
|
13
14
|
* Validates that a resolved path stays inside the project root.
|
|
@@ -39,4 +40,5 @@ export declare function parseAndValidateOptions(raw: {
|
|
|
39
40
|
dryRun?: boolean;
|
|
40
41
|
quiet?: boolean;
|
|
41
42
|
format?: string;
|
|
43
|
+
watch?: boolean;
|
|
42
44
|
}): CliOptions;
|
package/dist/cli/parse-args.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"parse-args.js","sourceRoot":"","sources":["../../src/cli/parse-args.ts"],"names":[],"mappings":";;;;;
|
|
1
|
+
{"version":3,"file":"parse-args.js","sourceRoot":"","sources":["../../src/cli/parse-args.ts"],"names":[],"mappings":"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"}
|
|
@@ -112,7 +112,8 @@ function scanApp(app, projectRoot, patternOverride, format) {
|
|
|
112
112
|
if (!className)
|
|
113
113
|
continue;
|
|
114
114
|
const controllerPath = (0, extract_methods_1.extractControllerPath)(cls);
|
|
115
|
-
const
|
|
115
|
+
const controllerRequiresAuth = (0, extract_methods_1.extractControllerAuth)(cls);
|
|
116
|
+
const methods = (0, extract_methods_1.extractMethods)(cls, controllerRequiresAuth);
|
|
116
117
|
const docsFilePath = deriveDocsFilePath(filePath, format);
|
|
117
118
|
const hasDocsFile = (() => {
|
|
118
119
|
try {
|
|
@@ -129,6 +130,7 @@ function scanApp(app, projectRoot, patternOverride, format) {
|
|
|
129
130
|
controllerPath,
|
|
130
131
|
methods,
|
|
131
132
|
hasDocsFile,
|
|
133
|
+
controllerRequiresAuth,
|
|
132
134
|
});
|
|
133
135
|
}
|
|
134
136
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"scan-controllers.js","sourceRoot":"","sources":["../../src/cli/scan-controllers.ts"],"names":[],"mappings":";;;;;AA8CA,gDAIC;AAMD,
|
|
1
|
+
{"version":3,"file":"scan-controllers.js","sourceRoot":"","sources":["../../src/cli/scan-controllers.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
export interface WatchOptions {
|
|
2
|
+
root: string;
|
|
3
|
+
pattern: string;
|
|
4
|
+
onRebuild: () => void;
|
|
5
|
+
}
|
|
6
|
+
/**
|
|
7
|
+
* Recursively watches a directory tree for controller file changes.
|
|
8
|
+
* Ignores node_modules, dist, and other build artifacts.
|
|
9
|
+
* Debounces rapid sequential changes with a 300ms window.
|
|
10
|
+
* Returns a cleanup function that stops all watchers.
|
|
11
|
+
*/
|
|
12
|
+
export declare function watchProject(opts: WatchOptions): () => void;
|
|
@@ -0,0 +1,112 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
3
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
|
+
};
|
|
5
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
+
exports.watchProject = watchProject;
|
|
7
|
+
const fs_1 = __importDefault(require("fs"));
|
|
8
|
+
const path_1 = __importDefault(require("path"));
|
|
9
|
+
const picocolors_1 = __importDefault(require("picocolors"));
|
|
10
|
+
const logger_1 = require("./logger");
|
|
11
|
+
const parse_args_1 = require("./parse-args");
|
|
12
|
+
const errors_1 = require("./errors");
|
|
13
|
+
const DEBOUNCE_MS = 300;
|
|
14
|
+
const CONTROLLER_RE = /\.controller\.[tj]s$/;
|
|
15
|
+
const IGNORED_DIRS = new Set(['node_modules', 'dist', '.git', '.cache', 'coverage']);
|
|
16
|
+
/**
|
|
17
|
+
* Recursively watches a directory tree for controller file changes.
|
|
18
|
+
* Ignores node_modules, dist, and other build artifacts.
|
|
19
|
+
* Debounces rapid sequential changes with a 300ms window.
|
|
20
|
+
* Returns a cleanup function that stops all watchers.
|
|
21
|
+
*/
|
|
22
|
+
function watchProject(opts) {
|
|
23
|
+
const watchers = [];
|
|
24
|
+
let debounceTimer = null;
|
|
25
|
+
const scheduleRebuild = (changedFile) => {
|
|
26
|
+
if (debounceTimer)
|
|
27
|
+
clearTimeout(debounceTimer);
|
|
28
|
+
debounceTimer = setTimeout(() => {
|
|
29
|
+
(0, logger_1.log)('info', `${picocolors_1.default.yellow('↺')} Change detected: ${path_1.default.relative(opts.root, changedFile)}`);
|
|
30
|
+
opts.onRebuild();
|
|
31
|
+
}, DEBOUNCE_MS);
|
|
32
|
+
};
|
|
33
|
+
const watchDir = (dir) => {
|
|
34
|
+
// Safety: every directory we watch must be within root
|
|
35
|
+
try {
|
|
36
|
+
(0, parse_args_1.assertWithinRoot)(dir, opts.root);
|
|
37
|
+
}
|
|
38
|
+
catch (e) {
|
|
39
|
+
if (e instanceof errors_1.PathTraversalError)
|
|
40
|
+
return;
|
|
41
|
+
throw e;
|
|
42
|
+
}
|
|
43
|
+
let watcher;
|
|
44
|
+
try {
|
|
45
|
+
watcher = fs_1.default.watch(dir, { recursive: false }, (event, filename) => {
|
|
46
|
+
if (!filename)
|
|
47
|
+
return;
|
|
48
|
+
const fullPath = path_1.default.join(dir, filename);
|
|
49
|
+
// Ignore non-controller files in debounce trigger but still re-watch new dirs
|
|
50
|
+
try {
|
|
51
|
+
const stat = fs_1.default.statSync(fullPath);
|
|
52
|
+
if (stat.isDirectory()) {
|
|
53
|
+
const base = path_1.default.basename(fullPath);
|
|
54
|
+
if (!IGNORED_DIRS.has(base)) {
|
|
55
|
+
watchDir(fullPath);
|
|
56
|
+
}
|
|
57
|
+
return;
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
catch {
|
|
61
|
+
// file may have been deleted — that's a valid change event
|
|
62
|
+
}
|
|
63
|
+
if (CONTROLLER_RE.test(filename) || filename.endsWith('.ts')) {
|
|
64
|
+
scheduleRebuild(fullPath);
|
|
65
|
+
}
|
|
66
|
+
});
|
|
67
|
+
}
|
|
68
|
+
catch {
|
|
69
|
+
// directory may not be watchable (permissions, etc.) — skip silently
|
|
70
|
+
return;
|
|
71
|
+
}
|
|
72
|
+
watchers.push(watcher);
|
|
73
|
+
};
|
|
74
|
+
// Recursively collect all non-ignored subdirectories and watch them
|
|
75
|
+
const collectDirs = (dir) => {
|
|
76
|
+
watchDir(dir);
|
|
77
|
+
try {
|
|
78
|
+
for (const entry of fs_1.default.readdirSync(dir, { withFileTypes: true })) {
|
|
79
|
+
if (!entry.isDirectory())
|
|
80
|
+
continue;
|
|
81
|
+
if (IGNORED_DIRS.has(entry.name))
|
|
82
|
+
continue;
|
|
83
|
+
const sub = path_1.default.join(dir, entry.name);
|
|
84
|
+
try {
|
|
85
|
+
(0, parse_args_1.assertWithinRoot)(sub, opts.root);
|
|
86
|
+
}
|
|
87
|
+
catch {
|
|
88
|
+
continue;
|
|
89
|
+
}
|
|
90
|
+
collectDirs(sub);
|
|
91
|
+
}
|
|
92
|
+
}
|
|
93
|
+
catch {
|
|
94
|
+
// unreadable directory — skip
|
|
95
|
+
}
|
|
96
|
+
};
|
|
97
|
+
collectDirs(opts.root);
|
|
98
|
+
(0, logger_1.log)('info', `${picocolors_1.default.cyan('👁')} Watching for changes in ${opts.root}…`);
|
|
99
|
+
(0, logger_1.log)('info', ` Press ${picocolors_1.default.gray('Ctrl+C')} to stop.`);
|
|
100
|
+
const cleanup = () => {
|
|
101
|
+
if (debounceTimer)
|
|
102
|
+
clearTimeout(debounceTimer);
|
|
103
|
+
for (const w of watchers) {
|
|
104
|
+
try {
|
|
105
|
+
w.close();
|
|
106
|
+
}
|
|
107
|
+
catch { /* ignore */ }
|
|
108
|
+
}
|
|
109
|
+
};
|
|
110
|
+
return cleanup;
|
|
111
|
+
}
|
|
112
|
+
//# sourceMappingURL=watch.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"watch.js","sourceRoot":"","sources":["../../src/cli/watch.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED