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.
@@ -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: typeNode ? typeNode.getText() : 'unknown',
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; // overridden
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":"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"}
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
- * Renders a complete .controller.docs.ts file for the given controller.
9
- * All user-sourced values are sanitised before interpolation.
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 — values from AST go through these before any
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; // Get, Put, Patch, Head, Options, All
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
- // Template
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 lines = [];
76
- lines.push(`${indent}// ${sig}`);
77
- lines.push(`${indent}${name}: [`);
78
- lines.push(`${indent} ApiOperation({ summary: '' }),`);
79
- lines.push(`${indent} ApiResponse({ status: ${status} }),`);
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
- * Renders a complete .controller.docs.ts file for the given controller.
90
- * All user-sourced values are sanitised before interpolation.
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 { ApiTags, ApiOperation, ApiResponse } = require('@nestjs/swagger');`,
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
- ` ApiTags('${tag}'),`,
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 { ApiTags, ApiOperation, ApiResponse } from '@nestjs/swagger';`,
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
- ` ApiTags('${tag}'),`,
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
- // ── Detect project ──────────────────────────────────────────────────
53
- const context = (0, detect_project_1.detectProject)(options.root, options.tsconfig);
54
- const kindLabel = {
55
- 'simple': 'Simple project',
56
- 'nx': 'NX Monorepo',
57
- 'nest-cli-monorepo': 'Nest CLI Monorepo',
58
- 'generic-monorepo': 'Generic Monorepo',
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
- if (scanResult.controllers.length === 0 && scanResult.errors.length === 0) {
71
- (0, logger_1.log)('warn', 'No controllers found matching the pattern.');
72
- (0, logger_1.summary)(0, 0, 0);
73
- process.exit(0 /* CliExitCode.Ok */);
74
- }
75
- // ── Generate / dry-run ──────────────────────────────────────────────
76
- (0, logger_1.header)(options.dryRun ? 'Preview (dry-run):' : 'Generating docs files...');
77
- const writeResults = (0, writer_1.writeAllDocs)(scanResult.controllers, {
78
- projectRoot: context.root,
79
- outDir: options.out,
80
- force: options.force,
81
- dryRun: options.dryRun,
82
- format: options.format,
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
- let created = 0, skipped = 0, errors = scanResult.errors.length;
85
- for (const r of writeResults) {
86
- switch (r.outcome) {
87
- case 'created':
88
- (0, logger_1.log)('success', `${r.controllerClass} → ${r.docsFilePath} ${picocolors_1.default.green('[created]')}`);
89
- created++;
90
- break;
91
- case 'merged':
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) {
@@ -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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"}
@@ -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;
@@ -80,6 +80,7 @@ function parseAndValidateOptions(raw) {
80
80
  dryRun: raw.dryRun ?? false,
81
81
  quiet: raw.quiet ?? false,
82
82
  format: format,
83
+ watch: raw.watch ?? false,
83
84
  };
84
85
  }
85
86
  //# sourceMappingURL=parse-args.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"parse-args.js","sourceRoot":"","sources":["../../src/cli/parse-args.ts"],"names":[],"mappings":"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"}
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 methods = (0, extract_methods_1.extractMethods)(cls);
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":"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"}
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":";;;;;AAuBA,oCAsFC;AA7GD,4CAAoB;AACpB,gDAAwB;AACxB,4DAA4B;AAC5B,qCAA+B;AAC/B,6CAAgD;AAChD,qCAA8C;AAQ9C,MAAM,WAAW,GAAG,GAAG,CAAC;AACxB,MAAM,aAAa,GAAG,sBAAsB,CAAC;AAC7C,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;AAErF;;;;;GAKG;AACH,SAAgB,YAAY,CAAC,IAAkB;IAC7C,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,IAAI,aAAa,GAAyC,IAAI,CAAC;IAE/D,MAAM,eAAe,GAAG,CAAC,WAAmB,EAAE,EAAE;QAC9C,IAAI,aAAa;YAAE,YAAY,CAAC,aAAa,CAAC,CAAC;QAC/C,aAAa,GAAG,UAAU,CAAC,GAAG,EAAE;YAC9B,IAAA,YAAG,EAAC,MAAM,EAAE,GAAG,oBAAE,CAAC,MAAM,CAAC,GAAG,CAAC,qBAAqB,cAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC;YAC3F,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,CAAC,EAAE,WAAW,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAE,EAAE;QAC/B,uDAAuD;QACvD,IAAI,CAAC;YACH,IAAA,6BAAgB,EAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,2BAAkB;gBAAE,OAAO;YAC5C,MAAM,CAAC,CAAC;QACV,CAAC;QAED,IAAI,OAAqB,CAAC;QAC1B,IAAI,CAAC;YACH,OAAO,GAAG,YAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;gBAChE,IAAI,CAAC,QAAQ;oBAAE,OAAO;gBACtB,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;gBAE1C,8EAA8E;gBAC9E,IAAI,CAAC;oBACH,MAAM,IAAI,GAAG,YAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;oBACnC,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;wBACvB,MAAM,IAAI,GAAG,cAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;wBACrC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;4BAC5B,QAAQ,CAAC,QAAQ,CAAC,CAAC;wBACrB,CAAC;wBACD,OAAO;oBACT,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,2DAA2D;gBAC7D,CAAC;gBAED,IAAI,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC7D,eAAe,CAAC,QAAQ,CAAC,CAAC;gBAC5B,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,qEAAqE;YACrE,OAAO;QACT,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC,CAAC;IAEF,oEAAoE;IACpE,MAAM,WAAW,GAAG,CAAC,GAAW,EAAE,EAAE;QAClC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACd,IAAI,CAAC;YACH,KAAK,MAAM,KAAK,IAAI,YAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;gBACjE,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;oBAAE,SAAS;gBACnC,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;oBAAE,SAAS;gBAC3C,MAAM,GAAG,GAAG,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBACvC,IAAI,CAAC;oBACH,IAAA,6BAAgB,EAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;gBACnC,CAAC;gBAAC,MAAM,CAAC;oBACP,SAAS;gBACX,CAAC;gBACD,WAAW,CAAC,GAAG,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,8BAA8B;QAChC,CAAC;IACH,CAAC,CAAC;IAEF,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEvB,IAAA,YAAG,EAAC,MAAM,EAAE,GAAG,oBAAE,CAAC,IAAI,CAAC,IAAI,CAAC,6BAA6B,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;IACvE,IAAA,YAAG,EAAC,MAAM,EAAE,YAAY,oBAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAEtD,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,IAAI,aAAa;YAAE,YAAY,CAAC,aAAa,CAAC,CAAC;QAC/C,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,IAAI,CAAC;gBAAC,CAAC,CAAC,KAAK,EAAE,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "nestjs-docfy",
3
- "version": "0.2.1",
3
+ "version": "0.2.3",
4
4
  "description": "Keep your NestJS controllers clean — Swagger docs live in a separate companion file by naming convention",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",