nestjs-docfy 0.2.0 → 0.2.2

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.
@@ -4,12 +4,26 @@ export interface ParamInfo {
4
4
  type: string;
5
5
  nestDecorator: string | null;
6
6
  }
7
+ /**
8
+ * A resolved DTO/entity type suitable for use in ApiResponse({ type: ... }).
9
+ * Only set when the return type resolves to a named class or interface from
10
+ * a source file — primitives, inline objects, and unresolvable types are null.
11
+ */
12
+ export interface ResponseTypeInfo {
13
+ /** Short identifier name, e.g. "RegisterResponseDto" */
14
+ name: string;
15
+ /** Absolute path to the file that declares the type */
16
+ absolutePath: string;
17
+ /** True when the original return type was an array, e.g. Promise<User[]> */
18
+ isArray: boolean;
19
+ }
7
20
  export interface MethodInfo {
8
21
  name: string;
9
22
  httpDecorator: string | null;
10
23
  httpPath: string | null;
11
24
  params: ParamInfo[];
12
25
  returnType: string;
26
+ responseType: ResponseTypeInfo | null;
13
27
  isAsync: boolean;
14
28
  isInherited: boolean;
15
29
  inheritedFrom: string | null;
@@ -10,6 +10,14 @@ const NEST_PARAM_DECORATORS = new Set([
10
10
  'Param', 'Body', 'Query', 'Headers', 'Req', 'Res', 'Request',
11
11
  'Response', 'Session', 'UploadedFile', 'UploadedFiles', 'Ip', 'HostParam',
12
12
  ]);
13
+ /** Primitives and built-ins that should never appear as ApiResponse type. */
14
+ const SKIP_TYPE_NAMES = new Set([
15
+ 'void', 'undefined', 'null', 'never', 'unknown', 'any',
16
+ 'string', 'number', 'boolean', 'object', 'symbol', 'bigint',
17
+ 'String', 'Number', 'Boolean', 'Object', 'Array',
18
+ 'Promise', 'Observable', 'Subject', 'BehaviorSubject',
19
+ ]);
20
+ const IDENTIFIER_RE = /^[$_a-zA-Z][$_a-zA-Z0-9]*$/;
13
21
  function getDecoratorName(dec) {
14
22
  try {
15
23
  return dec.getName() ?? null;
@@ -59,6 +67,76 @@ function extractParams(method) {
59
67
  return [];
60
68
  }
61
69
  }
70
+ /**
71
+ * Unwraps Promise<T> → T, and Observable<T> → T.
72
+ * Returns the original type if it's not a wrapper.
73
+ */
74
+ function unwrapAsync(type) {
75
+ try {
76
+ const name = type.getSymbol()?.getName();
77
+ if (name === 'Promise' || name === 'Observable') {
78
+ const args = type.getTypeArguments();
79
+ if (args.length > 0)
80
+ return args[0];
81
+ }
82
+ }
83
+ catch {
84
+ // ignore
85
+ }
86
+ return type;
87
+ }
88
+ /**
89
+ * Resolves the ResponseTypeInfo for a method's return type.
90
+ * Returns null for primitives, inline objects, void, and unresolvable types.
91
+ */
92
+ function resolveResponseType(method) {
93
+ try {
94
+ const rawType = method.getReturnType();
95
+ const inner = unwrapAsync(rawType);
96
+ // Check for array: T[] or Array<T>
97
+ let isArray = false;
98
+ let elementType = inner;
99
+ if (inner.isArray()) {
100
+ isArray = true;
101
+ elementType = inner.getArrayElementTypeOrThrow();
102
+ }
103
+ // Skip primitives, void, inline objects, union/intersection types
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 };
135
+ }
136
+ catch {
137
+ return null;
138
+ }
139
+ }
62
140
  /**
63
141
  * Extracts public, non-static methods from a controller class declaration.
64
142
  * Marks inherited methods (from base classes) but still includes them.
@@ -95,12 +173,14 @@ function extractMethods(cls) {
95
173
  catch {
96
174
  // ts-morph can fail to infer complex types — keep 'unknown'
97
175
  }
176
+ const responseType = resolveResponseType(method);
98
177
  results.push({
99
178
  name: method.getName(),
100
179
  httpDecorator,
101
180
  httpPath,
102
181
  params: extractParams(method),
103
182
  returnType,
183
+ responseType,
104
184
  isAsync: method.isAsync(),
105
185
  isInherited: false,
106
186
  inheritedFrom: null,
@@ -134,6 +214,7 @@ function extractMethods(cls) {
134
214
  httpPath: null,
135
215
  params: extractParams(method),
136
216
  returnType: 'unknown',
217
+ responseType: null,
137
218
  isAsync: method.isAsync(),
138
219
  isInherited: true,
139
220
  inheritedFrom: baseClassName,
@@ -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,3 @@
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
- /**
8
- * Renders a complete .controller.docs.ts file for the given controller.
9
- * All user-sourced values are sanitised before interpolation.
10
- */
11
3
  export declare function renderDocsFile(ctrl: ControllerInfo, docsFilePath: string, format: 'ts' | 'js'): string;
@@ -7,37 +7,60 @@ exports.relativeImport = relativeImport;
7
7
  exports.renderDocsFile = renderDocsFile;
8
8
  const path_1 = __importDefault(require("path"));
9
9
  // ---------------------------------------------------------------------------
10
- // Sanitisation helpers — values from AST go through these before any
11
- // string interpolation so they can never inject executable code.
10
+ // Sanitisation helpers
12
11
  // ---------------------------------------------------------------------------
13
- /** Whitelist for JS identifiers: letters, digits, $ and _. */
14
12
  const IDENTIFIER_RE = /^[$_a-zA-Z][$_a-zA-Z0-9]*$/;
15
13
  function sanitizeIdentifier(value, fallback) {
16
14
  return IDENTIFIER_RE.test(value) ? value : fallback;
17
15
  }
18
- /** Strips characters that could close a JS string or inject code into a comment. */
19
16
  function sanitizeComment(value) {
20
17
  return value.replace(/[`'"\\*]/g, '').slice(0, 200);
21
18
  }
22
- /** Escapes a URL path for safe use inside a line comment. */
23
19
  function sanitizeHttpPath(value) {
24
20
  if (!value)
25
21
  return '';
26
22
  return '/' + value.replace(/[^a-zA-Z0-9/_:.-]/g, '');
27
23
  }
28
24
  // ---------------------------------------------------------------------------
25
+ // HTTP verb → default success status code
26
+ // ---------------------------------------------------------------------------
27
+ function defaultStatusCode(httpDecorator) {
28
+ switch (httpDecorator) {
29
+ case 'Post': return 201;
30
+ case 'Delete': return 204;
31
+ default: return 200;
32
+ }
33
+ }
34
+ // ---------------------------------------------------------------------------
29
35
  // Import path resolution
30
36
  // ---------------------------------------------------------------------------
31
- /**
32
- * Computes the relative import path from the generated docs file to the
33
- * controller file, stripping the .ts extension (CommonJS/ESM convention).
34
- */
35
37
  function relativeImport(docsFilePath, controllerFilePath) {
36
38
  const rel = path_1.default.relative(path_1.default.dirname(docsFilePath), controllerFilePath);
37
39
  const withoutExt = rel.replace(/\.ts$/, '');
38
- // Ensure it starts with ./ for Node module resolution
39
40
  return withoutExt.startsWith('.') ? withoutExt : `./${withoutExt}`;
40
41
  }
42
+ /**
43
+ * Collects all unique response type imports needed for a controller's methods.
44
+ * Deduplicates by type name — if two methods return the same type, one import.
45
+ * Validates each type name with IDENTIFIER_RE before including.
46
+ */
47
+ function collectResponseImports(methods, docsFilePath) {
48
+ const seen = new Map(); // name → importPath
49
+ for (const m of methods) {
50
+ const rt = m.responseType;
51
+ if (!rt)
52
+ continue;
53
+ if (!IDENTIFIER_RE.test(rt.name))
54
+ continue; // safety: skip invalid identifiers
55
+ if (seen.has(rt.name))
56
+ continue;
57
+ const rel = path_1.default.relative(path_1.default.dirname(docsFilePath), rt.absolutePath);
58
+ const importPath = rel.replace(/\.ts$/, '').replace(/\\/g, '/');
59
+ const normalized = importPath.startsWith('.') ? importPath : `./${importPath}`;
60
+ seen.set(rt.name, normalized);
61
+ }
62
+ return Array.from(seen.entries()).map(([name, importPath]) => ({ name, importPath }));
63
+ }
41
64
  // ---------------------------------------------------------------------------
42
65
  // Method signature comment
43
66
  // ---------------------------------------------------------------------------
@@ -57,23 +80,44 @@ function methodSignatureComment(m) {
57
80
  return `${route}${asyncPrefix}${methodName}(${paramList}): ${returnType}${inherited}`;
58
81
  }
59
82
  // ---------------------------------------------------------------------------
60
- // Template
83
+ // ApiResponse rendering
84
+ // ---------------------------------------------------------------------------
85
+ function renderApiResponse(status, responseType) {
86
+ if (!responseType || !IDENTIFIER_RE.test(responseType.name)) {
87
+ return `ApiResponse({ status: ${status} })`;
88
+ }
89
+ const typePart = responseType.isArray
90
+ ? `[${responseType.name}]`
91
+ : responseType.name;
92
+ return `ApiResponse({ status: ${status}, type: ${typePart} })`;
93
+ }
94
+ // ---------------------------------------------------------------------------
95
+ // Method block
61
96
  // ---------------------------------------------------------------------------
62
97
  function renderMethod(m, indent) {
63
98
  const name = sanitizeIdentifier(m.name, '_method');
64
99
  const sig = methodSignatureComment(m);
65
- const lines = [];
66
- lines.push(`${indent}// ${sig}`);
67
- lines.push(`${indent}${name}: [`);
68
- lines.push(`${indent} // ApiOperation({ summary: '' }),`);
69
- lines.push(`${indent} // ApiResponse({ status: 200 }),`);
70
- lines.push(`${indent}],`);
71
- return lines.join('\n');
100
+ const status = defaultStatusCode(m.httpDecorator);
101
+ const apiResponse = renderApiResponse(status, m.responseType);
102
+ return [
103
+ `${indent}// ${sig}`,
104
+ `${indent}${name}: [`,
105
+ `${indent} ApiOperation({ summary: '' }),`,
106
+ `${indent} ${apiResponse},`,
107
+ `${indent}],`,
108
+ ].join('\n');
72
109
  }
73
- /**
74
- * Renders a complete .controller.docs.ts file for the given controller.
75
- * All user-sourced values are sanitised before interpolation.
76
- */
110
+ // ---------------------------------------------------------------------------
111
+ // ApiTags value
112
+ // ---------------------------------------------------------------------------
113
+ function apiTagValue(ctrl) {
114
+ if (ctrl.controllerPath)
115
+ return sanitizeComment(ctrl.controllerPath);
116
+ return sanitizeComment(ctrl.className.replace(/Controller$/, '').toLowerCase());
117
+ }
118
+ // ---------------------------------------------------------------------------
119
+ // Full file renderer
120
+ // ---------------------------------------------------------------------------
77
121
  function renderDocsFile(ctrl, docsFilePath, format) {
78
122
  const importPath = relativeImport(docsFilePath, ctrl.filePath);
79
123
  const className = sanitizeIdentifier(ctrl.className, 'Controller');
@@ -81,20 +125,27 @@ function renderDocsFile(ctrl, docsFilePath, format) {
81
125
  ? ` (route: "${sanitizeHttpPath(ctrl.controllerPath)}")`
82
126
  : '';
83
127
  const timestamp = new Date().toISOString();
128
+ const tag = apiTagValue(ctrl);
129
+ const responseImports = collectResponseImports(ctrl.methods, docsFilePath);
84
130
  const methodsBlock = ctrl.methods.length === 0
85
131
  ? ' // No public HTTP methods found.'
86
132
  : ctrl.methods.map((m) => renderMethod(m, ' ')).join('\n\n');
87
133
  if (format === 'js') {
134
+ const requireLines = responseImports
135
+ .map((i) => `const { ${i.name} } = require('${i.importPath}');`)
136
+ .join('\n');
88
137
  return [
89
- `// Auto-generated by nestjs-docfy — fill in the decorator arrays.`,
138
+ `// Auto-generated by nestjs-docfy`,
90
139
  `// Generated: ${timestamp}`,
91
140
  ``,
92
141
  `const { docs } = require('nestjs-docfy');`,
142
+ `const { ApiTags, ApiOperation, ApiResponse } = require('@nestjs/swagger');`,
93
143
  `const { ${className} } = require('${importPath}');`,
144
+ ...(requireLines ? [requireLines] : []),
94
145
  ``,
95
146
  `docs(${className}, {`,
96
147
  ` classDecorators: [`,
97
- ` // ApiTags('${sanitizeComment(ctrl.controllerPath ?? className.replace(/Controller$/, '').toLowerCase())}'),`,
148
+ ` ApiTags('${tag}'),`,
98
149
  ` ],`,
99
150
  ` methods: {`,
100
151
  methodsBlock.split('\n').map((l) => (l ? ` ${l}` : l)).join('\n'),
@@ -103,19 +154,23 @@ function renderDocsFile(ctrl, docsFilePath, format) {
103
154
  ``,
104
155
  ].join('\n');
105
156
  }
157
+ const importLines = responseImports
158
+ .map((i) => `import { ${i.name} } from '${i.importPath}';`)
159
+ .join('\n');
106
160
  return [
107
161
  `/**`,
108
- ` * Auto-generated by nestjs-docfy — fill in the decorator arrays.`,
162
+ ` * Auto-generated by nestjs-docfy`,
109
163
  ` * Controller: ${className}${controllerRoute}`,
110
164
  ` * Generated: ${timestamp}`,
111
165
  ` */`,
112
166
  `import { docs } from 'nestjs-docfy';`,
113
167
  `import { ApiTags, ApiOperation, ApiResponse } from '@nestjs/swagger';`,
114
168
  `import { ${className} } from '${importPath}';`,
169
+ ...(importLines ? [importLines] : []),
115
170
  ``,
116
171
  `docs(${className}, {`,
117
172
  ` classDecorators: [`,
118
- ` // ApiTags('${sanitizeComment(ctrl.controllerPath ?? className.replace(/Controller$/, '').toLowerCase())}'),`,
173
+ ` ApiTags('${tag}'),`,
119
174
  ` ],`,
120
175
  ` methods: {`,
121
176
  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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "nestjs-docfy",
3
- "version": "0.2.0",
3
+ "version": "0.2.2",
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",