nestjs-openapi-next 1.0.2 → 1.0.4

package/.idea/codeStyles/Project.xml

@@ -0,0 +1,70 @@
+<component name="ProjectCodeStyleConfiguration">
+  <code_scheme name="Project" version="173">
+    <HTMLCodeStyleSettings>
+      <option name="HTML_SPACE_INSIDE_EMPTY_TAG" value="true" />
+    </HTMLCodeStyleSettings>
+    <JSCodeStyleSettings version="0">
+      <option name="FORCE_SEMICOLON_STYLE" value="true" />
+      <option name="SPACE_BEFORE_FUNCTION_LEFT_PARENTH" value="false" />
+      <option name="FORCE_QUOTE_STYlE" value="true" />
+      <option name="ENFORCE_TRAILING_COMMA" value="Remove" />
+      <option name="SPACES_WITHIN_OBJECT_LITERAL_BRACES" value="true" />
+      <option name="SPACES_WITHIN_IMPORTS" value="true" />
+    </JSCodeStyleSettings>
+    <JetCodeStyleSettings>
+      <option name="CODE_STYLE_DEFAULTS" value="KOTLIN_OFFICIAL" />
+    </JetCodeStyleSettings>
+    <TypeScriptCodeStyleSettings version="0">
+      <option name="FORCE_SEMICOLON_STYLE" value="true" />
+      <option name="SPACE_BEFORE_FUNCTION_LEFT_PARENTH" value="false" />
+      <option name="FORCE_QUOTE_STYlE" value="true" />
+      <option name="ENFORCE_TRAILING_COMMA" value="Remove" />
+      <option name="SPACES_WITHIN_OBJECT_LITERAL_BRACES" value="true" />
+      <option name="SPACES_WITHIN_IMPORTS" value="true" />
+    </TypeScriptCodeStyleSettings>
+    <VueCodeStyleSettings>
+      <option name="INTERPOLATION_NEW_LINE_AFTER_START_DELIMITER" value="false" />
+      <option name="INTERPOLATION_NEW_LINE_BEFORE_END_DELIMITER" value="false" />
+    </VueCodeStyleSettings>
+    <codeStyleSettings language="HTML">
+      <option name="SOFT_MARGINS" value="80" />
+      <indentOptions>
+        <option name="INDENT_SIZE" value="2" />
+        <option name="CONTINUATION_INDENT_SIZE" value="2" />
+        <option name="TAB_SIZE" value="2" />
+      </indentOptions>
+    </codeStyleSettings>
+    <codeStyleSettings language="JAVA">
+      <indentOptions>
+        <option name="USE_TAB_CHARACTER" value="true" />
+        <option name="SMART_TABS" value="true" />
+      </indentOptions>
+    </codeStyleSettings>
+    <codeStyleSettings language="JavaScript">
+      <option name="SOFT_MARGINS" value="80" />
+      <indentOptions>
+        <option name="INDENT_SIZE" value="2" />
+        <option name="CONTINUATION_INDENT_SIZE" value="2" />
+        <option name="TAB_SIZE" value="2" />
+      </indentOptions>
+    </codeStyleSettings>
+    <codeStyleSettings language="TypeScript">
+      <option name="ALIGN_MULTILINE_PARAMETERS" value="false" />
+      <option name="SOFT_MARGINS" value="80" />
+      <indentOptions>
+        <option name="INDENT_SIZE" value="2" />
+        <option name="CONTINUATION_INDENT_SIZE" value="2" />
+        <option name="TAB_SIZE" value="2" />
+      </indentOptions>
+    </codeStyleSettings>
+    <codeStyleSettings language="Vue">
+      <option name="SOFT_MARGINS" value="80" />
+      <indentOptions>
+        <option name="CONTINUATION_INDENT_SIZE" value="2" />
+      </indentOptions>
+    </codeStyleSettings>
+    <codeStyleSettings language="kotlin">
+      <option name="CODE_STYLE_DEFAULTS" value="KOTLIN_OFFICIAL" />
+    </codeStyleSettings>
+  </code_scheme>
+</component>

package/.idea/codeStyles/codeStyleConfig.xml

@@ -0,0 +1,5 @@
+<component name="ProjectCodeStyleConfiguration">
+  <state>
+    <option name="USE_PER_PROJECT_SETTINGS" value="true" />
+  </state>
+</component>

package/.idea/compiler.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="TypeScriptCompiler">
+    <option name="useServicePoweredTypesEnabledManually" value="true" />
+  </component>
+</project>

package/.idea/copilot.data.migration.agent.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="AgentMigrationStateService">
+    <option name="migrationStatus" value="COMPLETED" />
+  </component>
+</project>

package/.idea/copilot.data.migration.ask2agent.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="Ask2AgentMigrationStateService">
+    <option name="migrationStatus" value="COMPLETED" />
+  </component>
+</project>

package/.idea/copilot.data.migration.edit.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="EditMigrationStateService">
+    <option name="migrationStatus" value="COMPLETED" />
+  </component>
+</project>

package/.idea/easycode.ignore

@@ -0,0 +1,13 @@
+.idea
+.vscode
+node_modules/
+dist/
+vendor/
+cache/
+.*/
+*.min.*
+*.test.*
+*.spec.*
+*.bundle.*
+*.bundle-min.*
+*.log

package/.idea/inspectionProfiles/Project_Default.xml

@@ -0,0 +1,6 @@
+<component name="InspectionProjectProfileManager">
+  <profile version="1.0">
+    <option name="myName" value="Project Default" />
+    <inspection_tool class="Eslint" enabled="true" level="WARNING" enabled_by_default="true" />
+  </profile>
+</component>

package/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/nestjs-openapi-next.iml" filepath="$PROJECT_DIR$/.idea/nestjs-openapi-next.iml" />
+    </modules>
+  </component>
+</project>

package/.idea/nestjs-openapi-next.iml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="WEB_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$" />
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

package/.idea/prettier.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="PrettierConfiguration">
+    <option name="myConfigurationMode" value="AUTOMATIC" />
+  </component>
+</project>

package/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="" vcs="Git" />
+  </component>
+</project>

package/README.md

@@ -100,7 +100,7 @@ This fork treats tag `summary` and `x-displayName` as equivalent display fields:
 
 #### Auto-derived (recommended)
 
-If you use tag `parent` relationships (via `@ApiTag()`), the root-level `x-tagGroups` will be derived automatically:
+If you use tag `parent` relationships (via `@ApiTag()`), the root-level `x-tagGroups` will be derived automatically (both in the scanned output and in the final document), so downstream generators (e.g. `.tags`) can render grouped tags correctly:
 
 ```ts
 @ApiTag({ name: 'Customers' })

package/dist/swagger-module.d.ts

@@ -3,6 +3,7 @@ import { HttpServer } from '@nestjs/common/interfaces/http/http-server.interface
 import { OpenAPIObject, SwaggerCustomOptions, SwaggerDocumentOptions } from './interfaces';
 export declare class SwaggerModule {
     private static readonly metadataLoader;
+    private static collectOperationTagNames;
     private static mergeWebhooks;
     private static mergeTags;
     private static buildXTagGroups;

package/dist/swagger-module.js

@@ -21,6 +21,8 @@ const normalize_rel_path_1 = require("./utils/normalize-rel-path");
 const resolve_path_util_1 = require("./utils/resolve-path.util");
 const validate_global_prefix_util_1 = require("./utils/validate-global-prefix.util");
 const validate_path_util_1 = require("./utils/validate-path.util");
+const build_x_tag_groups_util_1 = require("./utils/build-x-tag-groups.util");
+const collect_operation_tag_names_util_1 = require("./utils/collect-operation-tag-names.util");
 const NULL_TYPE_SCHEMA = { type: 'null' };
 function isReferenceObject(value) {
     return !!(value === null || value === void 0 ? void 0 : value.$ref);
@@ -320,13 +322,16 @@ function normalizeNullableForOas31(document) {
     }
 }
 class SwaggerModule {
+    static collectOperationTagNames(paths, webhooks) {
+        return (0, collect_operation_tag_names_util_1.collectOperationTagNames)(paths, webhooks);
+    }
     static mergeWebhooks(configWebhooks, scannedWebhooks) {
         if (!configWebhooks && !scannedWebhooks) {
             return undefined;
         }
         return (0, assign_two_levels_deep_1.assignTwoLevelsDeep)({}, configWebhooks || {}, scannedWebhooks || {});
     }
-    static mergeTags(configTags, scannedTags) {
+    static mergeTags(configTags, scannedTags, operationTagNames) {
         var _a, _b, _c, _d, _e, _f, _g, _h, _j;
         const byName = new Map();
         for (const tag of configTags || []) {
@@ -353,71 +358,33 @@ class SwaggerModule {
             merged.kind = (_j = existing.kind) !== null && _j !== void 0 ? _j : tag.kind;
             byName.set(tag.name, merged);
         }
+        if (byName.size > 0) {
+            for (const name of operationTagNames || []) {
+                if (!name || byName.has(name)) {
+                    continue;
+                }
+                byName.set(name, { name });
+            }
+        }
         const merged = [...byName.values()];
         return merged.length > 0 ? merged : undefined;
     }
-    static buildXTagGroups(tags) {
-        if (!tags || tags.length === 0) {
-            return undefined;
-        }
-        const groupToTags = new Map();
-        const groupToSeen = new Map();
-        for (const tag of tags) {
-            const parent = tag.parent;
-            if (!parent) {
-                continue;
-            }
-            if (!groupToTags.has(parent)) {
-                groupToTags.set(parent, []);
-                groupToSeen.set(parent, new Set());
-            }
-            let list = groupToTags.get(parent);
-            if (!list) {
-                list = [];
-                groupToTags.set(parent, list);
-            }
-            let seen = groupToSeen.get(parent);
-            if (!seen) {
-                seen = new Set();
-                groupToSeen.set(parent, seen);
-            }
-            if (!seen.has(tag.name)) {
-                seen.add(tag.name);
-                list.push(tag.name);
-            }
-        }
-        if (groupToTags.size === 0) {
-            return undefined;
-        }
-        const allTagNames = new Set(tags.map((t) => t.name));
-        return [...groupToTags.entries()].map(([name, childTags]) => {
-            const finalTags = [];
-            const seen = new Set();
-            if (allTagNames.has(name)) {
-                seen.add(name);
-                finalTags.push(name);
-            }
-            for (const t of childTags) {
-                if (!seen.has(t)) {
-                    seen.add(t);
-                    finalTags.push(t);
-                }
-            }
-            return { name, tags: finalTags };
-        });
+    static buildXTagGroups(tags, operationTagNames) {
+        return (0, build_x_tag_groups_util_1.buildXTagGroups)(tags, operationTagNames);
     }
     static createDocument(app, config, options = {}) {
         const swaggerScanner = new swagger_scanner_1.SwaggerScanner();
         const document = swaggerScanner.scanApplication(app, options);
         document.components = (0, assign_two_levels_deep_1.assignTwoLevelsDeep)({}, config.components, document.components);
-        const mergedTags = SwaggerModule.mergeTags(config.tags, document.tags);
+        const operationTagNames = SwaggerModule.collectOperationTagNames(document.paths, document.webhooks);
+        const mergedTags = SwaggerModule.mergeTags(config.tags, document.tags, operationTagNames);
         const mergedWebhooks = SwaggerModule.mergeWebhooks(config.webhooks, document.webhooks);
         const mergedDocument = Object.assign(Object.assign(Object.assign(Object.assign({ openapi: '3.0.0', paths: {} }, config), document), (mergedTags ? { tags: mergedTags } : {})), (mergedWebhooks ? { webhooks: mergedWebhooks } : {}));
         if (isOas31OrAbove(mergedDocument.openapi)) {
             normalizeNullableForOas31(mergedDocument);
         }
         if (mergedDocument['x-tagGroups'] === undefined) {
-            const xTagGroups = SwaggerModule.buildXTagGroups(mergedDocument.tags);
+            const xTagGroups = SwaggerModule.buildXTagGroups(mergedDocument.tags, operationTagNames);
             if (xTagGroups) {
                 mergedDocument['x-tagGroups'] = xTagGroups;
             }

package/dist/swagger-scanner.js

@@ -11,6 +11,8 @@ const swagger_explorer_1 = require("./swagger-explorer");
 const swagger_transformer_1 = require("./swagger-transformer");
 const get_global_prefix_1 = require("./utils/get-global-prefix");
 const strip_last_slash_util_1 = require("./utils/strip-last-slash.util");
+const build_x_tag_groups_util_1 = require("./utils/build-x-tag-groups.util");
+const collect_operation_tag_names_util_1 = require("./utils/collect-operation-tag-names.util");
 class SwaggerScanner {
     constructor() {
         this.transformer = new swagger_transformer_1.SwaggerTransformer();
@@ -56,7 +58,10 @@ class SwaggerScanner {
         });
         const schemas = this.explorer.getSchemas();
         this.addExtraModels(schemas, extraModels);
-        return Object.assign(Object.assign(Object.assign({}, this.transformer.normalizePaths((0, lodash_1.flatten)(denormalizedPaths))), (tagGroups.length > 0 ? { tags: tagGroups } : {})), { components: {
+        const normalized = this.transformer.normalizePaths((0, lodash_1.flatten)(denormalizedPaths));
+        const operationTagNames = (0, collect_operation_tag_names_util_1.collectOperationTagNames)(normalized.paths, normalized.webhooks);
+        const xTagGroups = (0, build_x_tag_groups_util_1.buildXTagGroups)(tagGroups, operationTagNames);
+        return Object.assign(Object.assign(Object.assign(Object.assign({}, normalized), (tagGroups.length > 0 ? { tags: tagGroups } : {})), (xTagGroups ? { 'x-tagGroups': xTagGroups } : {})), { components: {
                 schemas: schemas
             } });
     }

package/dist/utils/build-x-tag-groups.util.d.ts

@@ -0,0 +1,5 @@
+import { TagObject } from '../interfaces/open-api-spec.interface';
+export declare function buildXTagGroups(tags?: TagObject[], operationTagNames?: string[]): {
+    name: string;
+    tags: string[];
+}[];

package/dist/utils/build-x-tag-groups.util.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildXTagGroups = buildXTagGroups;
+function buildXTagGroups(tags, operationTagNames) {
+    const opNames = new Set((operationTagNames || [])
+        .filter((t) => typeof t === 'string')
+        .map((t) => t.trim())
+        .filter(Boolean));
+    if ((!tags || tags.length === 0) && opNames.size === 0) {
+        return undefined;
+    }
+    const groupToChildTags = new Map();
+    const groupToSeen = new Map();
+    const childToParent = new Map();
+    for (const tag of tags || []) {
+        const parent = tag.parent;
+        if (!parent) {
+            continue;
+        }
+        childToParent.set(tag.name, parent);
+        if (!groupToChildTags.has(parent)) {
+            groupToChildTags.set(parent, []);
+            groupToSeen.set(parent, new Set());
+        }
+        let list = groupToChildTags.get(parent);
+        if (!list) {
+            list = [];
+            groupToChildTags.set(parent, list);
+        }
+        let seen = groupToSeen.get(parent);
+        if (!seen) {
+            seen = new Set();
+            groupToSeen.set(parent, seen);
+        }
+        if (!seen.has(tag.name)) {
+            seen.add(tag.name);
+            list.push(tag.name);
+        }
+    }
+    for (const name of opNames) {
+        if (childToParent.has(name)) {
+            continue;
+        }
+        if (!groupToChildTags.has(name)) {
+            groupToChildTags.set(name, []);
+            groupToSeen.set(name, new Set());
+        }
+    }
+    if (groupToChildTags.size === 0) {
+        return undefined;
+    }
+    const allTagNames = new Set((tags || []).map((t) => t.name));
+    return [...groupToChildTags.entries()].map(([name, childTags]) => {
+        const finalTags = [];
+        const seen = new Set();
+        if (allTagNames.has(name) || opNames.has(name)) {
+            seen.add(name);
+            finalTags.push(name);
+        }
+        for (const t of childTags) {
+            if (!seen.has(t)) {
+                seen.add(t);
+                finalTags.push(t);
+            }
+        }
+        return { name, tags: finalTags };
+    });
+}

package/dist/utils/collect-operation-tag-names.util.d.ts

@@ -0,0 +1,2 @@
+import { OpenAPIObject } from '../interfaces/open-api-spec.interface';
+export declare function collectOperationTagNames(paths?: OpenAPIObject['paths'], webhooks?: OpenAPIObject['webhooks']): string[];

package/dist/utils/collect-operation-tag-names.util.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectOperationTagNames = collectOperationTagNames;
+const HTTP_METHODS = new Set([
+    'get',
+    'put',
+    'post',
+    'delete',
+    'options',
+    'head',
+    'patch',
+    'trace',
+    'search',
+    'query'
+]);
+function collectOperationTagNames(paths, webhooks) {
+    const names = [];
+    const seen = new Set();
+    const collectFromItems = (items) => {
+        if (!items) {
+            return;
+        }
+        for (const pathItem of Object.values(items)) {
+            if (!pathItem || typeof pathItem !== 'object') {
+                continue;
+            }
+            for (const [key, operation] of Object.entries(pathItem)) {
+                if (!HTTP_METHODS.has(String(key).toLowerCase())) {
+                    continue;
+                }
+                const tags = operation === null || operation === void 0 ? void 0 : operation.tags;
+                if (!Array.isArray(tags)) {
+                    continue;
+                }
+                for (const t of tags) {
+                    if (typeof t !== 'string') {
+                        continue;
+                    }
+                    const trimmed = t.trim();
+                    if (!trimmed || seen.has(trimmed)) {
+                        continue;
+                    }
+                    seen.add(trimmed);
+                    names.push(trimmed);
+                }
+            }
+        }
+    };
+    collectFromItems(paths);
+    collectFromItems(webhooks);
+    return names;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nestjs-openapi-next",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "A fork of @nestjs/swagger support OAS 3.2",
   "author": "undownding",
   "license": "MIT",

package/.claude/settings.local.json

@@ -1,25 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "WebSearch",
-      "WebFetch(domain:spec.openapis.org)",
-      "WebFetch(domain:www.openapis.org)",
-      "WebFetch(domain:blog.stoplight.io)",
-      "WebFetch(domain:apisyouwonthate.com)",
-      "WebFetch(domain:github.com)",
-      "Bash(gh auth status:*)",
-      "Bash(gh issue create:*)",
-      "Bash(gh issue view:*)",
-      "Bash(gh issue edit:*)",
-      "Bash(npm test)",
-      "Bash(npm install)",
-      "Bash(npm test:*)",
-      "Bash(gh pr view:*)",
-      "Bash(git checkout:*)",
-      "Bash(git add:*)",
-      "Bash(git commit -m \"$\\(cat <<''EOF''\ndocs: update README with OAS 3.1/3.2 features\n\nAdd documentation for newly implemented OpenAPI 3.1/3.2 features:\n- JSON Schema Draft 2020-12 alignment\n- type as array support \\(replaces nullable\\)\n- LicenseObject.identifier\n- ServerObject.pathPrefix\n- InfoObject.tags\n- ReferenceObject summary/description override\n- exclusiveMinimum/exclusiveMaximum type change\n\nCloses #7\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>\nEOF\n\\)\")",
-      "Bash(git push:*)",
-      "Bash(gh pr create:*)"
-    ]
-  }
-}