nestjs-docfy 0.2.1 → 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,19 +7,15 @@ 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 '';
@@ -32,21 +28,39 @@ function defaultStatusCode(httpDecorator) {
32
28
  switch (httpDecorator) {
33
29
  case 'Post': return 201;
34
30
  case 'Delete': return 204;
35
- default: return 200; // Get, Put, Patch, Head, Options, All
31
+ default: return 200;
36
32
  }
37
33
  }
38
34
  // ---------------------------------------------------------------------------
39
35
  // Import path resolution
40
36
  // ---------------------------------------------------------------------------
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
37
  function relativeImport(docsFilePath, controllerFilePath) {
46
38
  const rel = path_1.default.relative(path_1.default.dirname(docsFilePath), controllerFilePath);
47
39
  const withoutExt = rel.replace(/\.ts$/, '');
48
40
  return withoutExt.startsWith('.') ? withoutExt : `./${withoutExt}`;
49
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
+ }
50
64
  // ---------------------------------------------------------------------------
51
65
  // Method signature comment
52
66
  // ---------------------------------------------------------------------------
@@ -66,29 +80,44 @@ function methodSignatureComment(m) {
66
80
  return `${route}${asyncPrefix}${methodName}(${paramList}): ${returnType}${inherited}`;
67
81
  }
68
82
  // ---------------------------------------------------------------------------
69
- // 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
70
96
  // ---------------------------------------------------------------------------
71
97
  function renderMethod(m, indent) {
72
98
  const name = sanitizeIdentifier(m.name, '_method');
73
99
  const sig = methodSignatureComment(m);
74
100
  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} }),`);
80
- lines.push(`${indent}],`);
81
- return lines.join('\n');
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');
82
109
  }
110
+ // ---------------------------------------------------------------------------
111
+ // ApiTags value
112
+ // ---------------------------------------------------------------------------
83
113
  function apiTagValue(ctrl) {
84
114
  if (ctrl.controllerPath)
85
115
  return sanitizeComment(ctrl.controllerPath);
86
116
  return sanitizeComment(ctrl.className.replace(/Controller$/, '').toLowerCase());
87
117
  }
88
- /**
89
- * Renders a complete .controller.docs.ts file for the given controller.
90
- * All user-sourced values are sanitised before interpolation.
91
- */
118
+ // ---------------------------------------------------------------------------
119
+ // Full file renderer
120
+ // ---------------------------------------------------------------------------
92
121
  function renderDocsFile(ctrl, docsFilePath, format) {
93
122
  const importPath = relativeImport(docsFilePath, ctrl.filePath);
94
123
  const className = sanitizeIdentifier(ctrl.className, 'Controller');
@@ -97,10 +126,14 @@ function renderDocsFile(ctrl, docsFilePath, format) {
97
126
  : '';
98
127
  const timestamp = new Date().toISOString();
99
128
  const tag = apiTagValue(ctrl);
129
+ const responseImports = collectResponseImports(ctrl.methods, docsFilePath);
100
130
  const methodsBlock = ctrl.methods.length === 0
101
131
  ? ' // No public HTTP methods found.'
102
132
  : ctrl.methods.map((m) => renderMethod(m, ' ')).join('\n\n');
103
133
  if (format === 'js') {
134
+ const requireLines = responseImports
135
+ .map((i) => `const { ${i.name} } = require('${i.importPath}');`)
136
+ .join('\n');
104
137
  return [
105
138
  `// Auto-generated by nestjs-docfy`,
106
139
  `// Generated: ${timestamp}`,
@@ -108,6 +141,7 @@ function renderDocsFile(ctrl, docsFilePath, format) {
108
141
  `const { docs } = require('nestjs-docfy');`,
109
142
  `const { ApiTags, ApiOperation, ApiResponse } = require('@nestjs/swagger');`,
110
143
  `const { ${className} } = require('${importPath}');`,
144
+ ...(requireLines ? [requireLines] : []),
111
145
  ``,
112
146
  `docs(${className}, {`,
113
147
  ` classDecorators: [`,
@@ -120,6 +154,9 @@ function renderDocsFile(ctrl, docsFilePath, format) {
120
154
  ``,
121
155
  ].join('\n');
122
156
  }
157
+ const importLines = responseImports
158
+ .map((i) => `import { ${i.name} } from '${i.importPath}';`)
159
+ .join('\n');
123
160
  return [
124
161
  `/**`,
125
162
  ` * Auto-generated by nestjs-docfy`,
@@ -129,6 +166,7 @@ function renderDocsFile(ctrl, docsFilePath, format) {
129
166
  `import { docs } from 'nestjs-docfy';`,
130
167
  `import { ApiTags, ApiOperation, ApiResponse } from '@nestjs/swagger';`,
131
168
  `import { ${className} } from '${importPath}';`,
169
+ ...(importLines ? [importLines] : []),
132
170
  ``,
133
171
  `docs(${className}, {`,
134
172
  ` classDecorators: [`,
@@ -1 +1 @@
1
- {"version":3,"file":"generate-file.js","sourceRoot":"","sources":["../../src/cli/generate-file.ts"],"names":[],"mappings":";;;;;AA8CA,wCAIC;AAkDD,wCA0DC;AA9JD,gDAAwB;AAGxB,8EAA8E;AAC9E,qEAAqE;AACrE,iEAAiE;AACjE,8EAA8E;AAE9E,8DAA8D;AAC9D,MAAM,aAAa,GAAG,4BAA4B,CAAC;AAEnD,SAAS,kBAAkB,CAAC,KAAa,EAAE,QAAgB;IACzD,OAAO,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;AACtD,CAAC;AAED,oFAAoF;AACpF,SAAS,eAAe,CAAC,KAAa;IACpC,OAAO,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACtD,CAAC;AAED,6DAA6D;AAC7D,SAAS,gBAAgB,CAAC,KAAoB;IAC5C,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,OAAO,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;AACvD,CAAC;AAED,8EAA8E;AAC9E,0CAA0C;AAC1C,8EAA8E;AAE9E,SAAS,iBAAiB,CAAC,aAA4B;IACrD,QAAQ,aAAa,EAAE,CAAC;QACtB,KAAK,MAAM,CAAC,CAAG,OAAO,GAAG,CAAC;QAC1B,KAAK,QAAQ,CAAC,CAAC,OAAO,GAAG,CAAC;QAC1B,OAAO,CAAC,CAAO,OAAO,GAAG,CAAC,CAAC,sCAAsC;IACnE,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E;;;GAGG;AACH,SAAgB,cAAc,CAAC,YAAoB,EAAE,kBAA0B;IAC7E,MAAM,GAAG,GAAG,cAAI,CAAC,QAAQ,CAAC,cAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,kBAAkB,CAAC,CAAC;IAC1E,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC5C,OAAO,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,UAAU,EAAE,CAAC;AACrE,CAAC;AAED,8EAA8E;AAC9E,2BAA2B;AAC3B,8EAA8E;AAE9E,SAAS,sBAAsB,CAAC,CAAa;IAC3C,MAAM,IAAI,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,aAAa,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,MAAM,QAAQ,GAAG,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACzE,MAAM,KAAK,GAAG,IAAI,IAAI,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9D,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM;SACvB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;SAC5E,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,MAAM,UAAU,GAAG,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IACjD,MAAM,WAAW,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9C,MAAM,UAAU,GAAG,kBAAkB,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,aAAa;QAChD,CAAC,CAAC,oBAAoB,eAAe,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG;QACzD,CAAC,CAAC,EAAE,CAAC;IACP,OAAO,GAAG,KAAK,GAAG,WAAW,GAAG,UAAU,IAAI,SAAS,MAAM,UAAU,GAAG,SAAS,EAAE,CAAC;AACxF,CAAC;AAED,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E,SAAS,YAAY,CAAC,CAAa,EAAE,MAAc;IACjD,MAAM,IAAI,GAAG,kBAAkB,CAAC,CAAC,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,sBAAsB,CAAC,CAAC,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;IAClD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,MAAM,GAAG,EAAE,CAAC,CAAC;IACjC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,KAAK,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,kCAAkC,CAAC,CAAC;IACxD,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,2BAA2B,MAAM,MAAM,CAAC,CAAC;IAC7D,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC,CAAC;IAC1B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,WAAW,CAAC,IAAoB;IACvC,IAAI,IAAI,CAAC,cAAc;QAAE,OAAO,eAAe,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACrE,OAAO,eAAe,CACpB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CACxD,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAgB,cAAc,CAC5B,IAAoB,EACpB,YAAoB,EACpB,MAAmB;IAEnB,MAAM,UAAU,GAAG,cAAc,CAAC,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,kBAAkB,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IACnE,MAAM,eAAe,GAAG,IAAI,CAAC,cAAc,KAAK,IAAI;QAClD,CAAC,CAAC,aAAa,gBAAgB,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI;QACxD,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAE9B,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAC5C,CAAC,CAAC,oCAAoC;QACtC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhE,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO;YACL,mCAAmC;YACnC,iBAAiB,SAAS,EAAE;YAC5B,EAAE;YACF,2CAA2C;YAC3C,4EAA4E;YAC5E,WAAW,SAAS,iBAAiB,UAAU,KAAK;YACpD,EAAE;YACF,QAAQ,SAAS,KAAK;YACtB,sBAAsB;YACtB,gBAAgB,GAAG,KAAK;YACxB,MAAM;YACN,cAAc;YACd,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAClE,MAAM;YACN,KAAK;YACL,EAAE;SACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAED,OAAO;QACL,KAAK;QACL,mCAAmC;QACnC,kBAAkB,SAAS,GAAG,eAAe,EAAE;QAC/C,iBAAiB,SAAS,EAAE;QAC5B,KAAK;QACL,sCAAsC;QACtC,uEAAuE;QACvE,YAAY,SAAS,YAAY,UAAU,IAAI;QAC/C,EAAE;QACF,QAAQ,SAAS,KAAK;QACtB,sBAAsB;QACtB,gBAAgB,GAAG,KAAK;QACxB,MAAM;QACN,cAAc;QACd,YAAY;QACZ,MAAM;QACN,KAAK;QACL,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}
1
+ {"version":3,"file":"generate-file.js","sourceRoot":"","sources":["../../src/cli/generate-file.ts"],"names":[],"mappings":";;;;;AAsCA,wCAIC;AAyGD,wCAsEC;AAzND,gDAAwB;AAGxB,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E,MAAM,aAAa,GAAG,4BAA4B,CAAC;AAEnD,SAAS,kBAAkB,CAAC,KAAa,EAAE,QAAgB;IACzD,OAAO,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;AACtD,CAAC;AAED,SAAS,eAAe,CAAC,KAAa;IACpC,OAAO,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAoB;IAC5C,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,OAAO,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;AACvD,CAAC;AAED,8EAA8E;AAC9E,0CAA0C;AAC1C,8EAA8E;AAE9E,SAAS,iBAAiB,CAAC,aAA4B;IACrD,QAAQ,aAAa,EAAE,CAAC;QACtB,KAAK,MAAM,CAAC,CAAG,OAAO,GAAG,CAAC;QAC1B,KAAK,QAAQ,CAAC,CAAC,OAAO,GAAG,CAAC;QAC1B,OAAO,CAAC,CAAO,OAAO,GAAG,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E,SAAgB,cAAc,CAAC,YAAoB,EAAE,kBAA0B;IAC7E,MAAM,GAAG,GAAG,cAAI,CAAC,QAAQ,CAAC,cAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,kBAAkB,CAAC,CAAC;IAC1E,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC5C,OAAO,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,UAAU,EAAE,CAAC;AACrE,CAAC;AAWD;;;;GAIG;AACH,SAAS,sBAAsB,CAC7B,OAAqB,EACrB,YAAoB;IAEpB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC,CAAC,oBAAoB;IAE5D,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,EAAE,GAAG,CAAC,CAAC,YAAY,CAAC;QAC1B,IAAI,CAAC,EAAE;YAAE,SAAS;QAClB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;YAAE,SAAS,CAAC,mCAAmC;QAC/E,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC;YAAE,SAAS;QAEhC,MAAM,GAAG,GAAG,cAAI,CAAC,QAAQ,CAAC,cAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC;QACvE,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAChE,MAAM,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,UAAU,EAAE,CAAC;QAE/E,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;AACxF,CAAC;AAED,8EAA8E;AAC9E,2BAA2B;AAC3B,8EAA8E;AAE9E,SAAS,sBAAsB,CAAC,CAAa;IAC3C,MAAM,IAAI,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,aAAa,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,MAAM,QAAQ,GAAG,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACzE,MAAM,KAAK,GAAG,IAAI,IAAI,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9D,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM;SACvB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;SAC5E,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,MAAM,UAAU,GAAG,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IACjD,MAAM,WAAW,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9C,MAAM,UAAU,GAAG,kBAAkB,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,aAAa;QAChD,CAAC,CAAC,oBAAoB,eAAe,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG;QACzD,CAAC,CAAC,EAAE,CAAC;IACP,OAAO,GAAG,KAAK,GAAG,WAAW,GAAG,UAAU,IAAI,SAAS,MAAM,UAAU,GAAG,SAAS,EAAE,CAAC;AACxF,CAAC;AAED,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,SAAS,iBAAiB,CAAC,MAAc,EAAE,YAAqC;IAC9E,IAAI,CAAC,YAAY,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5D,OAAO,yBAAyB,MAAM,KAAK,CAAC;IAC9C,CAAC;IACD,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO;QACnC,CAAC,CAAC,IAAI,YAAY,CAAC,IAAI,GAAG;QAC1B,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC;IACtB,OAAO,yBAAyB,MAAM,WAAW,QAAQ,KAAK,CAAC;AACjE,CAAC;AAED,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E,SAAS,YAAY,CAAC,CAAa,EAAE,MAAc;IACjD,MAAM,IAAI,GAAG,kBAAkB,CAAC,CAAC,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,sBAAsB,CAAC,CAAC,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG,iBAAiB,CAAC,MAAM,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC;IAC9D,OAAO;QACL,GAAG,MAAM,MAAM,GAAG,EAAE;QACpB,GAAG,MAAM,GAAG,IAAI,KAAK;QACrB,GAAG,MAAM,kCAAkC;QAC3C,GAAG,MAAM,KAAK,WAAW,GAAG;QAC5B,GAAG,MAAM,IAAI;KACd,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,SAAS,WAAW,CAAC,IAAoB;IACvC,IAAI,IAAI,CAAC,cAAc;QAAE,OAAO,eAAe,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACrE,OAAO,eAAe,CACpB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CACxD,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E,SAAgB,cAAc,CAC5B,IAAoB,EACpB,YAAoB,EACpB,MAAmB;IAEnB,MAAM,UAAU,GAAG,cAAc,CAAC,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,kBAAkB,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IACnE,MAAM,eAAe,GAAG,IAAI,CAAC,cAAc,KAAK,IAAI;QAClD,CAAC,CAAC,aAAa,gBAAgB,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI;QACxD,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAE9B,MAAM,eAAe,GAAG,sBAAsB,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAE3E,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAC5C,CAAC,CAAC,oCAAoC;QACtC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhE,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,MAAM,YAAY,GAAG,eAAe;aACjC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,IAAI,iBAAiB,CAAC,CAAC,UAAU,KAAK,CAAC;aAC/D,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,OAAO;YACL,mCAAmC;YACnC,iBAAiB,SAAS,EAAE;YAC5B,EAAE;YACF,2CAA2C;YAC3C,4EAA4E;YAC5E,WAAW,SAAS,iBAAiB,UAAU,KAAK;YACpD,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACvC,EAAE;YACF,QAAQ,SAAS,KAAK;YACtB,sBAAsB;YACtB,gBAAgB,GAAG,KAAK;YACxB,MAAM;YACN,cAAc;YACd,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAClE,MAAM;YACN,KAAK;YACL,EAAE;SACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAED,MAAM,WAAW,GAAG,eAAe;SAChC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,UAAU,IAAI,CAAC;SAC1D,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO;QACL,KAAK;QACL,mCAAmC;QACnC,kBAAkB,SAAS,GAAG,eAAe,EAAE;QAC/C,iBAAiB,SAAS,EAAE;QAC5B,KAAK;QACL,sCAAsC;QACtC,uEAAuE;QACvE,YAAY,SAAS,YAAY,UAAU,IAAI;QAC/C,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,EAAE;QACF,QAAQ,SAAS,KAAK;QACtB,sBAAsB;QACtB,gBAAgB,GAAG,KAAK;QACxB,MAAM;QACN,cAAc;QACd,YAAY;QACZ,MAAM;QACN,KAAK;QACL,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,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.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",