nestjs-docfy 0.2.2 → 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 +11 -4
- package/dist/cli/extract-methods.js +125 -38
- package/dist/cli/extract-methods.js.map +1 -1
- package/dist/cli/generate-file.d.ts +5 -0
- package/dist/cli/generate-file.js +144 -37
- 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,10 +3,12 @@ export interface ParamInfo {
|
|
|
3
3
|
name: string;
|
|
4
4
|
type: string;
|
|
5
5
|
nestDecorator: string | null;
|
|
6
|
+
nestDecoratorArg: string | null;
|
|
7
|
+
bodyType: ResponseTypeInfo | null;
|
|
6
8
|
}
|
|
7
9
|
/**
|
|
8
|
-
* A resolved DTO/entity type suitable for use in ApiResponse({ type: ... }).
|
|
9
|
-
* Only set when the
|
|
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
|
|
10
12
|
* a source file — primitives, inline objects, and unresolvable types are null.
|
|
11
13
|
*/
|
|
12
14
|
export interface ResponseTypeInfo {
|
|
@@ -14,7 +16,7 @@ export interface ResponseTypeInfo {
|
|
|
14
16
|
name: string;
|
|
15
17
|
/** Absolute path to the file that declares the type */
|
|
16
18
|
absolutePath: string;
|
|
17
|
-
/** True when the original
|
|
19
|
+
/** True when the original type was an array, e.g. Promise<User[]> */
|
|
18
20
|
isArray: boolean;
|
|
19
21
|
}
|
|
20
22
|
export interface MethodInfo {
|
|
@@ -27,6 +29,7 @@ export interface MethodInfo {
|
|
|
27
29
|
isAsync: boolean;
|
|
28
30
|
isInherited: boolean;
|
|
29
31
|
inheritedFrom: string | null;
|
|
32
|
+
requiresAuth: boolean;
|
|
30
33
|
}
|
|
31
34
|
export interface ControllerInfo {
|
|
32
35
|
className: string;
|
|
@@ -34,13 +37,17 @@ export interface ControllerInfo {
|
|
|
34
37
|
controllerPath: string | null;
|
|
35
38
|
methods: MethodInfo[];
|
|
36
39
|
hasDocsFile: boolean;
|
|
40
|
+
controllerRequiresAuth: boolean;
|
|
37
41
|
}
|
|
38
42
|
/**
|
|
39
43
|
* Extracts public, non-static methods from a controller class declaration.
|
|
40
44
|
* Marks inherited methods (from base classes) but still includes them.
|
|
41
45
|
* Private and protected methods are ignored.
|
|
46
|
+
* controllerAuth: whether the controller-level @UseGuards was detected as JWT.
|
|
42
47
|
*/
|
|
43
|
-
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;
|
|
44
51
|
/**
|
|
45
52
|
* Extracts the path argument from @Controller('path').
|
|
46
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,7 +11,7 @@ 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
|
]);
|
|
13
|
-
/** Primitives and built-ins that should never appear as ApiResponse type. */
|
|
14
|
+
/** Primitives and built-ins that should never appear as ApiResponse/ApiBody type. */
|
|
14
15
|
const SKIP_TYPE_NAMES = new Set([
|
|
15
16
|
'void', 'undefined', 'null', 'never', 'unknown', 'any',
|
|
16
17
|
'string', 'number', 'boolean', 'object', 'symbol', 'bigint',
|
|
@@ -44,22 +45,99 @@ function getDecoratorFirstStringArg(method, decoratorName) {
|
|
|
44
45
|
return null;
|
|
45
46
|
}
|
|
46
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
|
+
}
|
|
47
106
|
function extractParams(method) {
|
|
48
107
|
try {
|
|
49
108
|
return method.getParameters().map((p) => {
|
|
50
109
|
let nestDecorator = null;
|
|
110
|
+
let nestDecoratorArg = null;
|
|
111
|
+
let decoratorShortName = null;
|
|
51
112
|
for (const dec of p.getDecorators()) {
|
|
52
113
|
const name = getDecoratorName(dec);
|
|
53
114
|
if (name && NEST_PARAM_DECORATORS.has(name)) {
|
|
54
115
|
nestDecorator = `@${name}`;
|
|
116
|
+
decoratorShortName = name;
|
|
117
|
+
nestDecoratorArg = getParamDecoratorArg(p, name);
|
|
55
118
|
break;
|
|
56
119
|
}
|
|
57
120
|
}
|
|
58
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
|
+
}
|
|
59
135
|
return {
|
|
60
136
|
name: p.getName(),
|
|
61
|
-
type:
|
|
137
|
+
type: typeText,
|
|
62
138
|
nestDecorator,
|
|
139
|
+
nestDecoratorArg,
|
|
140
|
+
bodyType,
|
|
63
141
|
};
|
|
64
142
|
});
|
|
65
143
|
}
|
|
@@ -93,56 +171,53 @@ function resolveResponseType(method) {
|
|
|
93
171
|
try {
|
|
94
172
|
const rawType = method.getReturnType();
|
|
95
173
|
const inner = unwrapAsync(rawType);
|
|
96
|
-
// Check for array: T[] or Array<T>
|
|
97
174
|
let isArray = false;
|
|
98
175
|
let elementType = inner;
|
|
99
176
|
if (inner.isArray()) {
|
|
100
177
|
isArray = true;
|
|
101
178
|
elementType = inner.getArrayElementTypeOrThrow();
|
|
102
179
|
}
|
|
103
|
-
|
|
104
|
-
if (elementType.isString() || elementType.isNumber() || elementType.isBoolean())
|
|
105
|
-
return null;
|
|
106
|
-
if (elementType.isUndefined() || elementType.isNull() || elementType.isVoid())
|
|
107
|
-
return null;
|
|
108
|
-
if (elementType.isAnonymous())
|
|
109
|
-
return null; // inline { id: string } objects
|
|
110
|
-
if (elementType.isUnion() || elementType.isIntersection())
|
|
111
|
-
return null;
|
|
112
|
-
if (elementType.isTuple())
|
|
113
|
-
return null;
|
|
114
|
-
const symbol = elementType.getSymbol() ?? elementType.getAliasSymbol();
|
|
115
|
-
if (!symbol)
|
|
116
|
-
return null;
|
|
117
|
-
const name = symbol.getName();
|
|
118
|
-
// Validate identifier — skip anything that isn't a clean class/interface name
|
|
119
|
-
if (!name || !IDENTIFIER_RE.test(name))
|
|
120
|
-
return null;
|
|
121
|
-
if (SKIP_TYPE_NAMES.has(name))
|
|
122
|
-
return null;
|
|
123
|
-
// Resolve the source file where the type is declared
|
|
124
|
-
const declarations = symbol.getDeclarations();
|
|
125
|
-
if (!declarations || declarations.length === 0)
|
|
126
|
-
return null;
|
|
127
|
-
const sourceFile = declarations[0].getSourceFile();
|
|
128
|
-
const absolutePath = sourceFile.getFilePath();
|
|
129
|
-
// Skip node_modules and .d.ts declaration files (no user source)
|
|
130
|
-
if (absolutePath.includes('node_modules'))
|
|
131
|
-
return null;
|
|
132
|
-
if (absolutePath.endsWith('.d.ts'))
|
|
133
|
-
return null;
|
|
134
|
-
return { name, absolutePath, isArray };
|
|
180
|
+
return resolveNamedType(elementType, isArray);
|
|
135
181
|
}
|
|
136
182
|
catch {
|
|
137
183
|
return null;
|
|
138
184
|
}
|
|
139
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
|
+
}
|
|
140
214
|
/**
|
|
141
215
|
* Extracts public, non-static methods from a controller class declaration.
|
|
142
216
|
* Marks inherited methods (from base classes) but still includes them.
|
|
143
217
|
* Private and protected methods are ignored.
|
|
218
|
+
* controllerAuth: whether the controller-level @UseGuards was detected as JWT.
|
|
144
219
|
*/
|
|
145
|
-
function extractMethods(cls) {
|
|
220
|
+
function extractMethods(cls, controllerAuth) {
|
|
146
221
|
const results = [];
|
|
147
222
|
const ownMethodNames = new Set(cls.getMethods().map((m) => m.getName()));
|
|
148
223
|
// Own methods
|
|
@@ -168,12 +243,13 @@ function extractMethods(cls) {
|
|
|
168
243
|
const returnTypeNode = method.getReturnTypeNode();
|
|
169
244
|
returnType = returnTypeNode
|
|
170
245
|
? returnTypeNode.getText()
|
|
171
|
-
: method.getReturnType().getText();
|
|
246
|
+
: cleanTypeText(method.getReturnType().getText());
|
|
172
247
|
}
|
|
173
248
|
catch {
|
|
174
249
|
// ts-morph can fail to infer complex types — keep 'unknown'
|
|
175
250
|
}
|
|
176
251
|
const responseType = resolveResponseType(method);
|
|
252
|
+
const methodAuth = hasJwtGuard(method.getDecorators());
|
|
177
253
|
results.push({
|
|
178
254
|
name: method.getName(),
|
|
179
255
|
httpDecorator,
|
|
@@ -184,6 +260,7 @@ function extractMethods(cls) {
|
|
|
184
260
|
isAsync: method.isAsync(),
|
|
185
261
|
isInherited: false,
|
|
186
262
|
inheritedFrom: null,
|
|
263
|
+
requiresAuth: controllerAuth || methodAuth,
|
|
187
264
|
});
|
|
188
265
|
}
|
|
189
266
|
// Inherited methods from base class(es)
|
|
@@ -199,7 +276,7 @@ function extractMethods(cls) {
|
|
|
199
276
|
if (method.isStatic())
|
|
200
277
|
continue;
|
|
201
278
|
if (ownMethodNames.has(method.getName()))
|
|
202
|
-
continue;
|
|
279
|
+
continue;
|
|
203
280
|
let httpDecorator = null;
|
|
204
281
|
for (const dec of method.getDecorators()) {
|
|
205
282
|
const name = getDecoratorName(dec);
|
|
@@ -218,6 +295,7 @@ function extractMethods(cls) {
|
|
|
218
295
|
isAsync: method.isAsync(),
|
|
219
296
|
isInherited: true,
|
|
220
297
|
inheritedFrom: baseClassName,
|
|
298
|
+
requiresAuth: controllerAuth || hasJwtGuard(method.getDecorators()),
|
|
221
299
|
});
|
|
222
300
|
}
|
|
223
301
|
}
|
|
@@ -227,6 +305,15 @@ function extractMethods(cls) {
|
|
|
227
305
|
}
|
|
228
306
|
return results;
|
|
229
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
|
+
}
|
|
230
317
|
/**
|
|
231
318
|
* Extracts the path argument from @Controller('path').
|
|
232
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,3 +1,8 @@
|
|
|
1
1
|
import type { ControllerInfo } from './extract-methods';
|
|
2
2
|
export declare function relativeImport(docsFilePath: string, controllerFilePath: string): string;
|
|
3
|
+
/**
|
|
4
|
+
* Converts a camelCase method name into a human-readable Swagger summary.
|
|
5
|
+
* findAll → "Find all", createUser → "Create user", getProfileById → "Get profile by id"
|
|
6
|
+
*/
|
|
7
|
+
export declare function inferSummary(methodName: string): string;
|
|
3
8
|
export declare function renderDocsFile(ctrl: ControllerInfo, docsFilePath: string, format: 'ts' | 'js'): string;
|
|
@@ -4,6 +4,7 @@ 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
|
// ---------------------------------------------------------------------------
|
|
@@ -21,6 +22,9 @@ function sanitizeHttpPath(value) {
|
|
|
21
22
|
return '';
|
|
22
23
|
return '/' + value.replace(/[^a-zA-Z0-9/_:.-]/g, '');
|
|
23
24
|
}
|
|
25
|
+
function sanitizeParamName(value) {
|
|
26
|
+
return value.replace(/[^a-zA-Z0-9_-]/g, '').slice(0, 100);
|
|
27
|
+
}
|
|
24
28
|
// ---------------------------------------------------------------------------
|
|
25
29
|
// HTTP verb → default success status code
|
|
26
30
|
// ---------------------------------------------------------------------------
|
|
@@ -39,28 +43,64 @@ function relativeImport(docsFilePath, controllerFilePath) {
|
|
|
39
43
|
const withoutExt = rel.replace(/\.ts$/, '');
|
|
40
44
|
return withoutExt.startsWith('.') ? withoutExt : `./${withoutExt}`;
|
|
41
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
|
+
};
|
|
42
59
|
/**
|
|
43
|
-
*
|
|
44
|
-
*
|
|
45
|
-
* Validates each type name with IDENTIFIER_RE before including.
|
|
60
|
+
* Maps a TS primitive type string to its JS constructor for Swagger.
|
|
61
|
+
* Returns null for non-primitives (DTOs, unknown, etc.).
|
|
46
62
|
*/
|
|
47
|
-
function
|
|
63
|
+
function primitiveToConstructor(tsType) {
|
|
64
|
+
const base = tsType.replace(/\[\]$/, '').trim();
|
|
65
|
+
return PRIMITIVE_MAP[base] ?? null;
|
|
66
|
+
}
|
|
67
|
+
function collectDtoImports(methods, docsFilePath) {
|
|
48
68
|
const seen = new Map(); // name → importPath
|
|
49
|
-
|
|
50
|
-
const rt = m.responseType;
|
|
69
|
+
const register = (rt) => {
|
|
51
70
|
if (!rt)
|
|
52
|
-
|
|
71
|
+
return;
|
|
53
72
|
if (!IDENTIFIER_RE.test(rt.name))
|
|
54
|
-
|
|
73
|
+
return;
|
|
55
74
|
if (seen.has(rt.name))
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
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
|
+
}
|
|
61
83
|
}
|
|
62
84
|
return Array.from(seen.entries()).map(([name, importPath]) => ({ name, importPath }));
|
|
63
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
|
+
}
|
|
64
104
|
// ---------------------------------------------------------------------------
|
|
65
105
|
// Method signature comment
|
|
66
106
|
// ---------------------------------------------------------------------------
|
|
@@ -80,6 +120,40 @@ function methodSignatureComment(m) {
|
|
|
80
120
|
return `${route}${asyncPrefix}${methodName}(${paramList}): ${returnType}${inherited}`;
|
|
81
121
|
}
|
|
82
122
|
// ---------------------------------------------------------------------------
|
|
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
|
+
// ---------------------------------------------------------------------------
|
|
83
157
|
// ApiResponse rendering
|
|
84
158
|
// ---------------------------------------------------------------------------
|
|
85
159
|
function renderApiResponse(status, responseType) {
|
|
@@ -92,20 +166,50 @@ function renderApiResponse(status, responseType) {
|
|
|
92
166
|
return `ApiResponse({ status: ${status}, type: ${typePart} })`;
|
|
93
167
|
}
|
|
94
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
|
+
// ---------------------------------------------------------------------------
|
|
95
188
|
// Method block
|
|
96
189
|
// ---------------------------------------------------------------------------
|
|
97
190
|
function renderMethod(m, indent) {
|
|
98
191
|
const name = sanitizeIdentifier(m.name, '_method');
|
|
99
192
|
const sig = methodSignatureComment(m);
|
|
100
193
|
const status = defaultStatusCode(m.httpDecorator);
|
|
101
|
-
const
|
|
102
|
-
|
|
194
|
+
const summary = inferSummary(name); // use sanitized name, not raw m.name
|
|
195
|
+
const inner = `${indent} `;
|
|
196
|
+
const lines = [
|
|
103
197
|
`${indent}// ${sig}`,
|
|
104
198
|
`${indent}${name}: [`,
|
|
105
|
-
`${
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
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)},`);
|
|
211
|
+
lines.push(`${indent}],`);
|
|
212
|
+
return lines.join('\n');
|
|
109
213
|
}
|
|
110
214
|
// ---------------------------------------------------------------------------
|
|
111
215
|
// ApiTags value
|
|
@@ -121,31 +225,38 @@ function apiTagValue(ctrl) {
|
|
|
121
225
|
function renderDocsFile(ctrl, docsFilePath, format) {
|
|
122
226
|
const importPath = relativeImport(docsFilePath, ctrl.filePath);
|
|
123
227
|
const className = sanitizeIdentifier(ctrl.className, 'Controller');
|
|
124
|
-
const controllerRoute = ctrl.controllerPath !== null
|
|
125
|
-
? ` (route: "${sanitizeHttpPath(ctrl.controllerPath)}")`
|
|
126
|
-
: '';
|
|
127
|
-
const timestamp = new Date().toISOString();
|
|
128
228
|
const tag = apiTagValue(ctrl);
|
|
129
|
-
const
|
|
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');
|
|
130
242
|
const methodsBlock = ctrl.methods.length === 0
|
|
131
243
|
? ' // No public HTTP methods found.'
|
|
132
244
|
: ctrl.methods.map((m) => renderMethod(m, ' ')).join('\n\n');
|
|
133
245
|
if (format === 'js') {
|
|
134
|
-
const requireLines =
|
|
246
|
+
const requireLines = dtoImports
|
|
135
247
|
.map((i) => `const { ${i.name} } = require('${i.importPath}');`)
|
|
136
248
|
.join('\n');
|
|
137
249
|
return [
|
|
138
|
-
`// Auto-generated by nestjs-docfy`,
|
|
139
|
-
`// Generated: ${timestamp}`,
|
|
250
|
+
`// Auto-generated by nestjs-docfy — do not edit manually`,
|
|
140
251
|
``,
|
|
141
252
|
`const { docs } = require('nestjs-docfy');`,
|
|
142
|
-
`const {
|
|
253
|
+
`const { ${swaggerImportList} } = require('@nestjs/swagger');`,
|
|
143
254
|
`const { ${className} } = require('${importPath}');`,
|
|
144
255
|
...(requireLines ? [requireLines] : []),
|
|
145
256
|
``,
|
|
146
257
|
`docs(${className}, {`,
|
|
147
258
|
` classDecorators: [`,
|
|
148
|
-
|
|
259
|
+
classDecoratorLines,
|
|
149
260
|
` ],`,
|
|
150
261
|
` methods: {`,
|
|
151
262
|
methodsBlock.split('\n').map((l) => (l ? ` ${l}` : l)).join('\n'),
|
|
@@ -154,23 +265,19 @@ function renderDocsFile(ctrl, docsFilePath, format) {
|
|
|
154
265
|
``,
|
|
155
266
|
].join('\n');
|
|
156
267
|
}
|
|
157
|
-
const importLines =
|
|
268
|
+
const importLines = dtoImports
|
|
158
269
|
.map((i) => `import { ${i.name} } from '${i.importPath}';`)
|
|
159
270
|
.join('\n');
|
|
160
271
|
return [
|
|
161
|
-
|
|
162
|
-
` * Auto-generated by nestjs-docfy`,
|
|
163
|
-
` * Controller: ${className}${controllerRoute}`,
|
|
164
|
-
` * Generated: ${timestamp}`,
|
|
165
|
-
` */`,
|
|
272
|
+
`// Auto-generated by nestjs-docfy — do not edit manually`,
|
|
166
273
|
`import { docs } from 'nestjs-docfy';`,
|
|
167
|
-
`import {
|
|
274
|
+
`import { ${swaggerImportList} } from '@nestjs/swagger';`,
|
|
168
275
|
`import { ${className} } from '${importPath}';`,
|
|
169
276
|
...(importLines ? [importLines] : []),
|
|
170
277
|
``,
|
|
171
278
|
`docs(${className}, {`,
|
|
172
279
|
` classDecorators: [`,
|
|
173
|
-
|
|
280
|
+
classDecoratorLines,
|
|
174
281
|
` ],`,
|
|
175
282
|
` methods: {`,
|
|
176
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