nestjs-openapi-next 1.0.5 → 1.0.7

package/.claude/settings.local.json

@@ -0,0 +1,13 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(git merge:*)",
+      "Bash(npm version:*)",
+      "Bash(git status:*)",
+      "Bash(git push:*)",
+      "Bash(git pull:*)",
+      "Bash(npm publish:*)",
+      "Bash(git tag:*)"
+    ]
+  }
+}

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

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

package/dist/decorators/api-query.decorator.d.ts

@@ -4,7 +4,7 @@ import { ParameterObject, ReferenceObject, SchemaObject } from '../interfaces/op
 import { SwaggerEnumType } from '../types/swagger-enum.type';
 type ParameterOptions = Omit<ParameterObject, 'in' | 'schema' | 'name'>;
 interface ApiQueryCommonMetadata extends ParameterOptions {
-    type?: Type<unknown> | Function | [Function] | string;
+    type?: Type<unknown> | Function | [Function] | 'string' | 'number' | 'integer' | 'boolean' | (string & {});
     isArray?: boolean;
     enum?: SwaggerEnumType;
 }

package/dist/document-builder.d.ts

@@ -13,8 +13,8 @@ export declare class DocumentBuilder {
     setLicense(name: string, url: string): this;
     setLicenseWithIdentifier(name: string, identifier: string): this;
     setOpenAPIVersion(version: string): this;
-    addServer(url: string, description?: string, pathPrefix?: string, variables?: Record<string, ServerVariableObject>): this;
-    addServerWithName(name: string, url: string, description?: string, pathPrefix?: string, variables?: Record<string, ServerVariableObject>): this;
+    addServer(url: string, description?: string, pathPrefix?: string, variables?: Record<string, ServerVariableObject>, serverExtraProperties?: Record<string, any>): this;
+    addServerWithName(name: string, url: string, description?: string, pathPrefix?: string, variables?: Record<string, ServerVariableObject>, serverExtraProperties?: Record<string, any>): this;
     setExternalDoc(description: string, url: string): this;
     setBasePath(path: string): this;
     addTag(name: string, description?: string, externalDocs?: ExternalDocumentationObject, summary?: string): this;

package/dist/document-builder.js

@@ -52,18 +52,47 @@ class DocumentBuilder {
         }
         return this;
     }
-    addServer(url, description, pathPrefix, variables) {
-        this.document.servers.push({ url, description, variables, pathPrefix });
+    addServer(url, description, pathPrefix, variables, serverExtraProperties) {
+        const serverObjDef = {
+            url,
+            description,
+            variables
+        };
+        if (!(0, lodash_1.isUndefined)(pathPrefix)) {
+            serverObjDef.pathPrefix = pathPrefix;
+        }
+        if (serverExtraProperties) {
+            const alreadyDefinedKeysForServerEntry = Object.keys(serverObjDef);
+            for (const key in serverExtraProperties) {
+                if (alreadyDefinedKeysForServerEntry.includes(key))
+                    continue;
+                const extraFieldValue = serverExtraProperties[key];
+                serverObjDef[key] = extraFieldValue;
+            }
+        }
+        this.document.servers.push(serverObjDef);
         return this;
     }
-    addServerWithName(name, url, description, pathPrefix, variables) {
-        this.document.servers.push({
+    addServerWithName(name, url, description, pathPrefix, variables, serverExtraProperties) {
+        const serverObjDef = {
             name,
             url,
             description,
-            variables,
-            pathPrefix
-        });
+            variables
+        };
+        if (!(0, lodash_1.isUndefined)(pathPrefix)) {
+            serverObjDef.pathPrefix = pathPrefix;
+        }
+        if (serverExtraProperties) {
+            const alreadyDefinedKeysForServerEntry = Object.keys(serverObjDef);
+            for (const key in serverExtraProperties) {
+                if (alreadyDefinedKeysForServerEntry.includes(key))
+                    continue;
+                const extraFieldValue = serverExtraProperties[key];
+                serverObjDef[key] = extraFieldValue;
+            }
+        }
+        this.document.servers.push(serverObjDef);
         return this;
     }
     setExternalDoc(description, url) {

package/dist/explorers/api-parameters.explorer.d.ts

@@ -46,7 +46,7 @@ export declare const exploreApiParametersMetadata: (schemas: Record<string, Sche
             additionalProperties?: SchemaObject | import("../interfaces/open-api-spec.interface").ReferenceObject | boolean;
             patternProperties?: Record<string, SchemaObject | import("../interfaces/open-api-spec.interface").ReferenceObject> | undefined;
             description?: string;
-            format?: string;
+            format?: import("../interfaces/open-api-spec.interface").OpenAPIFormat;
             default?: any;
             title?: string;
             multipleOf?: number;

package/dist/interfaces/open-api-spec.interface.d.ts

@@ -219,7 +219,7 @@ export interface SchemaObject {
     additionalProperties?: SchemaObject | ReferenceObject | boolean;
     patternProperties?: Record<string, SchemaObject | ReferenceObject> | undefined;
     description?: string;
-    format?: string;
+    format?: OpenAPIFormat;
     default?: any;
     title?: string;
     multipleOf?: number;
@@ -286,3 +286,4 @@ export interface OAuthDeviceAuthorizationFlowObject {
 export type ScopesObject = Record<string, any>;
 export type SecurityRequirementObject = Record<string, string[]>;
 export type ExtensionLocation = 'root' | 'info';
+export type OpenAPIFormat = 'int32' | 'int64' | 'float' | 'double' | 'byte' | 'binary' | 'date' | 'date-time' | 'time' | 'duration' | 'password' | 'email' | 'idn-email' | 'hostname' | 'idn-hostname' | 'ipv4' | 'ipv6' | 'uri' | 'uri-reference' | 'uri-template' | 'iri' | 'iri-reference' | 'uuid' | 'json-pointer' | 'relative-json-pointer' | 'regex' | (string & {});

package/dist/services/schema-object-factory.d.ts

@@ -57,7 +57,7 @@ export declare class SchemaObjectFactory {
                 additionalProperties?: SchemaObject | ReferenceObject | boolean;
                 patternProperties?: Record<string, SchemaObject | ReferenceObject> | undefined;
                 description?: string;
-                format?: string;
+                format?: import("../interfaces/open-api-spec.interface").OpenAPIFormat;
                 default?: any;
                 title?: string;
                 multipleOf?: number;
@@ -137,7 +137,7 @@ export declare class SchemaObjectFactory {
             additionalProperties?: SchemaObject | ReferenceObject | boolean;
             patternProperties?: Record<string, SchemaObject | ReferenceObject> | undefined;
             description?: string;
-            format?: string;
+            format?: import("../interfaces/open-api-spec.interface").OpenAPIFormat;
             default?: any;
             title?: string;
             multipleOf?: number;

package/dist/services/swagger-types-mapper.d.ts

@@ -48,7 +48,7 @@ export declare class SwaggerTypesMapper {
             additionalProperties?: SchemaObject | ReferenceObject | boolean;
             patternProperties?: Record<string, SchemaObject | ReferenceObject> | undefined;
             description?: string;
-            format?: string;
+            format?: import("../interfaces/open-api-spec.interface").OpenAPIFormat;
             default?: any;
             title?: string;
             multipleOf?: number;
@@ -138,7 +138,7 @@ export declare class SwaggerTypesMapper {
             additionalProperties?: SchemaObject | ReferenceObject | boolean;
             patternProperties?: Record<string, SchemaObject | ReferenceObject> | undefined;
             description?: string;
-            format?: string;
+            format?: import("../interfaces/open-api-spec.interface").OpenAPIFormat;
             default?: any;
             title?: string;
             multipleOf?: number;
@@ -203,7 +203,7 @@ export declare class SwaggerTypesMapper {
             additionalProperties?: SchemaObject | ReferenceObject | boolean;
             patternProperties?: Record<string, SchemaObject | ReferenceObject> | undefined;
             description?: string;
-            format?: string;
+            format?: import("../interfaces/open-api-spec.interface").OpenAPIFormat;
             default?: any;
             title?: string;
             multipleOf?: number;
@@ -277,7 +277,7 @@ export declare class SwaggerTypesMapper {
             additionalProperties?: SchemaObject | ReferenceObject | boolean;
             patternProperties?: Record<string, SchemaObject | ReferenceObject> | undefined;
             description?: string;
-            format?: string;
+            format?: import("../interfaces/open-api-spec.interface").OpenAPIFormat;
             default?: any;
             title?: string;
             multipleOf?: number;
@@ -347,7 +347,7 @@ export declare class SwaggerTypesMapper {
         additionalProperties?: SchemaObject | ReferenceObject | boolean;
         patternProperties?: Record<string, SchemaObject | ReferenceObject> | undefined;
         description?: string;
-        format?: string;
+        format?: import("../interfaces/open-api-spec.interface").OpenAPIFormat;
         default?: any;
         title?: string;
         multipleOf?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nestjs-openapi-next",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "A fork of @nestjs/swagger support OAS 3.2",
   "author": "undownding",
   "license": "MIT",
@@ -30,46 +30,46 @@
     "@microsoft/tsdoc": "0.16.0",
     "@nestjs/mapped-types": "2.1.0",
     "js-yaml": "4.1.1",
-    "lodash": "4.17.21",
+    "lodash": "4.17.23",
     "path-to-regexp": "8.3.0",
     "swagger-ui-dist": "5.31.0"
   },
   "devDependencies": {
-    "@commitlint/cli": "20.3.1",
-    "@commitlint/config-angular": "20.3.1",
-    "@eslint/eslintrc": "3.3.3",
-    "@eslint/js": "9.39.2",
+    "@commitlint/cli": "20.4.2",
+    "@commitlint/config-angular": "20.4.2",
+    "@eslint/eslintrc": "3.3.4",
+    "@eslint/js": "10.0.1",
     "@fastify/static": "9.0.0",
-    "@nestjs/common": "11.1.12",
-    "@nestjs/core": "11.1.12",
-    "@nestjs/platform-express": "11.1.12",
-    "@nestjs/platform-fastify": "11.1.12",
+    "@nestjs/common": "11.1.14",
+    "@nestjs/core": "11.1.14",
+    "@nestjs/platform-express": "11.1.14",
+    "@nestjs/platform-fastify": "11.1.14",
     "@types/jest": "30.0.0",
     "@types/js-yaml": "4.0.9",
-    "@types/lodash": "4.17.23",
-    "@types/node": "24.10.9",
+    "@types/lodash": "4.17.24",
+    "@types/node": "24.10.13",
     "class-transformer": "0.5.1",
-    "class-validator": "0.14.3",
-    "eslint": "9.39.2",
+    "class-validator": "0.14.4",
+    "eslint": "10.0.2",
     "eslint-config-prettier": "10.1.8",
     "eslint-plugin-prettier": "5.5.5",
     "express": "5.2.1",
-    "fastify": "5.7.1",
-    "globals": "17.0.0",
+    "fastify": "5.7.4",
+    "globals": "17.3.0",
     "husky": "9.1.7",
     "jest": "30.2.0",
     "lerna-changelog": "2.2.0",
     "lint-staged": "16.2.7",
     "openapi-types": "12.1.3",
-    "prettier": "3.8.0",
+    "prettier": "3.8.1",
     "prettier-v2": "npm:prettier@2.8.8",
     "reflect-metadata": "0.2.2",
-    "release-it": "19.2.3",
+    "release-it": "19.2.4",
     "supertest": "7.2.2",
     "swagger-parser": "10.0.3",
     "ts-jest": "29.4.6",
     "typescript": "5.9.3",
-    "typescript-eslint": "8.53.1"
+    "typescript-eslint": "8.56.1"
   },
   "peerDependencies": {
     "@fastify/static": "^8.0.0 || ^9.0.0",