@rsdk/http.server 6.0.0-next.1 → 6.0.0-next.10

package/dist/http.config.js

@@ -20,14 +20,14 @@ let HttpConfig = class HttpConfig extends core_1.Config {
 };
 exports.HttpConfig = HttpConfig;
 __decorate([
-    (0, core_1.Property)('HTTP_HOST', new core_1.StringParser(), {
+    (0, core_1.Property)('HTTP_HOST', new common_1.StringParser(), {
         defaultValue: '0.0.0.0',
         description: 'HTTP host',
     }),
     __metadata("design:type", String)
 ], HttpConfig.prototype, "host", void 0);
 __decorate([
-    (0, core_1.Property)('HTTP_PORT', new core_1.IntParser(), {
+    (0, core_1.Property)('HTTP_PORT', new common_1.IntParser(), {
         // eslint-disable-next-line unicorn/numeric-separators-style
         defaultValue: 50050,
         description: 'HTTP port',
@@ -35,16 +35,16 @@ __decorate([
     __metadata("design:type", Number)
 ], HttpConfig.prototype, "port", void 0);
 __decorate([
-    (0, core_1.Property)('HTTP_BODY_LIMIT', new core_1.SizeParser(), {
+    (0, core_1.Property)('HTTP_BODY_LIMIT', new common_1.SizeParser(), {
         defaultValue: new common_1.Size(100, 'kb'),
         description: 'Max HTTP body size',
     }),
     __metadata("design:type", common_1.Size)
 ], HttpConfig.prototype, "bodyLimit", void 0);
 __decorate([
-    (0, core_1.Property)('HTTP_SWAGGER_UI_ENABLED', new core_1.BoolParser(), {
+    (0, core_1.Property)('HTTP_SWAGGER_UI_ENABLED', new common_1.BoolParser(), {
         defaultValue: true,
-        description: 'Enable swagger UI on /swagger endpoint',
+        description: 'Enable swagger UI on /swagger (can be configured) endpoint',
     }),
     __metadata("design:type", Boolean)
 ], HttpConfig.prototype, "swaggerUI", void 0);

package/dist/http.config.js.map

@@ -1 +1 @@
-{"version":3,"file":"http.config.js","sourceRoot":"","sources":["../src/http.config.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yCAAoC;AACpC,qCASoB;AAKb,IAAM,UAAU,GAAhB,MAAM,UAAW,SAAQ,aAAM;IAK3B,IAAI,CAAU;IAOd,IAAI,CAAU;IAMd,SAAS,CAAQ;IAMjB,SAAS,CAAW;CAC9B,CAAA;AAzBY,gCAAU;AAKZ;IAJR,IAAA,eAAQ,EAAC,WAAW,EAAE,IAAI,mBAAY,EAAE,EAAE;QACzC,YAAY,EAAE,SAAS;QACvB,WAAW,EAAE,WAAW;KACzB,CAAC;;wCACqB;AAOd;IALR,IAAA,eAAQ,EAAC,WAAW,EAAE,IAAI,gBAAS,EAAE,EAAE;QACtC,4DAA4D;QAC5D,YAAY,EAAE,KAAK;QACnB,WAAW,EAAE,WAAW;KACzB,CAAC;;wCACqB;AAMd;IAJR,IAAA,eAAQ,EAAC,iBAAiB,EAAE,IAAI,iBAAU,EAAE,EAAE;QAC7C,YAAY,EAAE,IAAI,aAAI,CAAC,GAAG,EAAE,IAAI,CAAC;QACjC,WAAW,EAAE,oBAAoB;KAClC,CAAC;8BACmB,aAAI;6CAAC;AAMjB;IAJR,IAAA,eAAQ,EAAC,yBAAyB,EAAE,IAAI,iBAAU,EAAE,EAAE;QACrD,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,wCAAwC;KACtD,CAAC;;6CAC2B;qBAxBlB,UAAU;IAHtB,IAAA,oBAAa,EAAC;QACb,IAAI,EAAE,CAAC,gBAAS,CAAC,cAAc,EAAE,gBAAS,CAAC,SAAS,EAAE,gBAAS,CAAC,IAAI,CAAC;KACtE,CAAC;GACW,UAAU,CAyBtB"}
+{"version":3,"file":"http.config.js","sourceRoot":"","sources":["../src/http.config.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yCAMsB;AACtB,qCAAwE;AAKjE,IAAM,UAAU,GAAhB,MAAM,UAAW,SAAQ,aAAM;IAK3B,IAAI,CAAU;IAOd,IAAI,CAAU;IAMd,SAAS,CAAQ;IAMjB,SAAS,CAAW;CAC9B,CAAA;AAzBY,gCAAU;AAKZ;IAJR,IAAA,eAAQ,EAAC,WAAW,EAAE,IAAI,qBAAY,EAAE,EAAE;QACzC,YAAY,EAAE,SAAS;QACvB,WAAW,EAAE,WAAW;KACzB,CAAC;;wCACqB;AAOd;IALR,IAAA,eAAQ,EAAC,WAAW,EAAE,IAAI,kBAAS,EAAE,EAAE;QACtC,4DAA4D;QAC5D,YAAY,EAAE,KAAK;QACnB,WAAW,EAAE,WAAW;KACzB,CAAC;;wCACqB;AAMd;IAJR,IAAA,eAAQ,EAAC,iBAAiB,EAAE,IAAI,mBAAU,EAAE,EAAE;QAC7C,YAAY,EAAE,IAAI,aAAI,CAAC,GAAG,EAAE,IAAI,CAAC;QACjC,WAAW,EAAE,oBAAoB;KAClC,CAAC;8BACmB,aAAI;6CAAC;AAMjB;IAJR,IAAA,eAAQ,EAAC,yBAAyB,EAAE,IAAI,mBAAU,EAAE,EAAE;QACrD,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,4DAA4D;KAC1E,CAAC;;6CAC2B;qBAxBlB,UAAU;IAHtB,IAAA,oBAAa,EAAC;QACb,IAAI,EAAE,CAAC,gBAAS,CAAC,cAAc,EAAE,gBAAS,CAAC,SAAS,EAAE,gBAAS,CAAC,IAAI,CAAC;KACtE,CAAC;GACW,UAAU,CAyBtB"}

package/dist/http.transport.d.ts

@@ -2,9 +2,10 @@ import { type ExecutionContext } from '@nestjs/common';
 import type { Controller, INestApplication } from '@nestjs/common/interfaces';
 import type { CorsOptions } from '@nestjs/common/interfaces/external/cors-options.interface';
 import type { AbstractHttpAdapter } from '@nestjs/core';
-import { DocumentBuilder as OriginalDocumentBuilder } from '@nestjs/swagger';
 import type { Constructor, DeepPartial } from '@rsdk/common';
-import type { ConfigContext, GenericHeaders, HttpOptions, IErrorsFormatter, IErrorsSender, IErrorsTransformer, IHttpTransport, LogFormatter } from '@rsdk/core';
+import type { ConfigContext, GenericHeaders, HttpOptions, IErrorsFormatter, IErrorsSender, IErrorsTransformer, IHttpTransport, LogFormatter, PlatformContext } from '@rsdk/core';
+import type { OpenApiOptions } from '@rsdk/http.openapi';
+import type { ILogger } from '@rsdk/logging';
 import { HttpConfig } from './http.config';
 export interface ParsersConfig {
     body: {
@@ -13,12 +14,12 @@ export interface ParsersConfig {
     };
     cookie: boolean;
 }
-export type DocumentBuilder = Omit<OriginalDocumentBuilder, 'build' | 'setTitle' | 'setDescription' | 'setVersion'>;
-export interface SwaggerOptions {
-    url: string;
-    file: string;
-    configure(builder: DocumentBuilder): void;
-}
+export type SwaggerOptions = Partial<OpenApiOptions> | {
+    fromFile: string;
+};
+export declare function isFromFile(swagger: SwaggerOptions): swagger is {
+    fromFile: string;
+};
 export interface HttpTransportOptions {
     /**
      * CORS middleware options
@@ -30,7 +31,6 @@ export interface HttpTransportOptions {
     globalPrefix?: string;
     /**
      * Configuration of body and cookie parsers
-    // NOTE: This fields is actually is handled in transport specific way
      */
     parsers?: DeepPartial<ParsersConfig>;
     /**
@@ -40,11 +40,11 @@ export interface HttpTransportOptions {
      * NOTE: SwaggerUI is enabled or disabled by HTTP_SWAGGER_UI_ENABLED
      * (true by default).
      */
-    swagger?: DeepPartial<SwaggerOptions>;
+    swagger?: Record<string, SwaggerOptions>;
 }
 export declare abstract class AbstractHttpTransport implements IHttpTransport {
-    protected readonly options?: HttpTransportOptions | undefined;
-    constructor(options?: HttpTransportOptions | undefined);
+    protected readonly options: HttpTransportOptions;
+    constructor(options?: HttpTransportOptions);
     extractHeaders(ctx: ExecutionContext): GenericHeaders;
     matchByContext(ctx: ExecutionContext): boolean;
     errorFormatter(): IErrorsFormatter;
@@ -55,7 +55,7 @@ export declare abstract class AbstractHttpTransport implements IHttpTransport {
     getMetricsController(): Constructor<Controller>;
     createHttpOptions(configContext: ConfigContext): HttpOptions;
     createAdapter(configContext: ConfigContext): AbstractHttpAdapter;
-    configureApp(app: INestApplication, configContext: ConfigContext): Promise<void> | void;
+    configureApp(app: INestApplication, context: PlatformContext, logger: ILogger): Promise<void>;
     abstract createHttpAdapter(config: HttpConfig): AbstractHttpAdapter;
     abstract logFormatter(): LogFormatter;
 }

package/dist/http.transport.js

@@ -1,16 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AbstractHttpTransport = void 0;
+exports.isFromFile = isFromFile;
 const swagger_1 = require("@nestjs/swagger");
+const common_node_1 = require("@rsdk/common.node");
 const core_1 = require("@rsdk/core");
-const node_fs_1 = require("node:fs");
+const http_openapi_1 = require("@rsdk/http.openapi");
 const controllers_1 = require("./controllers");
 const error_handling_1 = require("./error-handling");
 const http_config_1 = require("./http.config");
 const http_headers_1 = require("./http.headers");
+function isFromFile(swagger) {
+    return typeof swagger === 'object' && 'fromFile' in swagger;
+}
 class AbstractHttpTransport {
     options;
-    constructor(options) {
+    constructor(options = {}) {
         this.options = options;
     }
     extractHeaders(ctx) {
@@ -39,38 +44,42 @@ class AbstractHttpTransport {
     }
     createHttpOptions(configContext) {
         const { host, port } = configContext.resolve(http_config_1.HttpConfig);
-        return {
-            host,
-            port,
-        };
+        return { host, port };
     }
     createAdapter(configContext) {
         return this.createHttpAdapter(configContext.resolve(http_config_1.HttpConfig));
     }
-    configureApp(app, configContext) {
+    async configureApp(app, context, logger) {
+        const configContext = await context.getConfigContext();
         const { swaggerUI } = configContext.resolve(http_config_1.HttpConfig);
-        const { globalPrefix, swagger, cors } = this.options ?? {};
+        const { globalPrefix, swagger, cors } = this.options;
         if (globalPrefix) {
             app.setGlobalPrefix(globalPrefix);
         }
         if (cors) {
             app.enableCors(cors);
         }
-        if (swaggerUI || swagger?.file) {
-            const builder = new swagger_1.DocumentBuilder()
-                .setTitle(app.get(core_1.APP_NAME))
-                .setVersion(app.get(core_1.APP_VERSION))
-                .setDescription(app.get(core_1.APP_DESCRIPTION));
-            // Applies additional configuration from user
-            swagger?.configure?.(builder);
-            const openApiConfig = builder.build();
-            const spec = swagger_1.SwaggerModule.createDocument(app, openApiConfig);
-            if (swagger?.file) {
-                (0, node_fs_1.writeFileSync)(swagger.file, JSON.stringify(spec));
-            }
-            if (swaggerUI) {
-                swagger_1.SwaggerModule.setup(swagger?.url ?? '/swagger', app, spec);
+        if (!swaggerUI || !swagger) {
+            return;
+        }
+        for (const [url, config] of Object.entries(swagger)) {
+            if (isFromFile(config)) {
+                try {
+                    const document = await (0, common_node_1.readObj)(config.fromFile);
+                    swagger_1.SwaggerModule.setup(url, app, document);
+                }
+                catch {
+                    logger.warn(`Failed to load OpenAPI spec from ${config.fromFile}`);
+                }
+                continue;
             }
+            const document = await new http_openapi_1.OpenApiGenerator(context, {
+                title: app.get(core_1.APP_NAME),
+                version: app.get(core_1.APP_VERSION),
+                description: app.get(core_1.APP_DESCRIPTION),
+                ...config,
+            }).generate();
+            swagger_1.SwaggerModule.setup(url, app, document);
         }
     }
 }

package/dist/http.transport.js.map

@@ -1 +1 @@
-{"version":3,"file":"http.transport.js","sourceRoot":"","sources":["../src/http.transport.ts"],"names":[],"mappings":";;;AAIA,6CAGyB;AAYzB,qCAAoE;AACpE,qCAAwC;AAExC,+CAA4E;AAC5E,qDAI0B;AAC1B,+CAA2C;AAC3C,iDAA6C;AAiD7C,MAAsB,qBAAqB;IACV;IAA/B,YAA+B,OAA8B;QAA9B,YAAO,GAAP,OAAO,CAAuB;IAAG,CAAC;IAEjE,cAAc,CAAC,GAAqB;QAClC,OAAO,IAAI,0BAAW,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,cAAc,CAAC,GAAqB;QAClC,OAAO,GAAG,CAAC,OAAO,EAAE,KAAK,MAAM,CAAC;IAClC,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,oCAAmB,EAAE,CAAC;IACnC,CAAC;IAED,WAAW;QACT,OAAO,IAAI,iCAAgB,EAAE,CAAC;IAChC,CAAC;IAED,iBAAiB;QACf,OAAO,CAAC,IAAI,sCAAqB,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,WAAW;QACT,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,mBAAmB;QACjB,OAAO,kCAAoB,CAAC;IAC9B,CAAC;IAED,oBAAoB;QAClB,OAAO,mCAAqB,CAAC;IAC/B,CAAC;IAED,iBAAiB,CAAC,aAA4B;QAC5C,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,aAAa,CAAC,OAAO,CAAC,wBAAU,CAAC,CAAC;QAEzD,OAAO;YACL,IAAI;YACJ,IAAI;SACL,CAAC;IACJ,CAAC;IAED,aAAa,CAAC,aAA4B;QACxC,OAAO,IAAI,CAAC,iBAAiB,CAAC,aAAa,CAAC,OAAO,CAAC,wBAAU,CAAC,CAAC,CAAC;IACnE,CAAC;IAED,YAAY,CACV,GAAqB,EACrB,aAA4B;QAE5B,MAAM,EAAE,SAAS,EAAE,GAAG,aAAa,CAAC,OAAO,CAAC,wBAAU,CAAC,CAAC;QACxD,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;QAC3D,IAAI,YAAY,EAAE,CAAC;YACjB,GAAG,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;QACpC,CAAC;QACD,IAAI,IAAI,EAAE,CAAC;YACT,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;QAED,IAAI,SAAS,IAAI,OAAO,EAAE,IAAI,EAAE,CAAC;YAC/B,MAAM,OAAO,GAAG,IAAI,yBAAuB,EAAE;iBAC1C,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,eAAQ,CAAC,CAAC;iBAC3B,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,kBAAW,CAAC,CAAC;iBAChC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,sBAAe,CAAC,CAAC,CAAC;YAE5C,6CAA6C;YAC7C,OAAO,EAAE,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC;YAE9B,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,uBAAa,CAAC,cAAc,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;YAE9D,IAAI,OAAO,EAAE,IAAI,EAAE,CAAC;gBAClB,IAAA,uBAAa,EAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;YACpD,CAAC;YAED,IAAI,SAAS,EAAE,CAAC;gBACd,uBAAa,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,UAAU,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC;IACH,CAAC;CAKF;AAtFD,sDAsFC"}
+{"version":3,"file":"http.transport.js","sourceRoot":"","sources":["../src/http.transport.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rsdk/http.server",
-  "version": "6.0.0-next.1",
+  "version": "6.0.0-next.10",
   "description": "HTTP transport for rsdk apps (needs some of HTTP adapters)",
   "license": "Apache License 2.0",
   "publishConfig": {
@@ -15,13 +15,16 @@
     "@nestjs/core": "^10.0.0",
     "@nestjs/swagger": "^7.0.0 || ^8.0.0",
     "@rsdk/common": "*",
+    "@rsdk/common.node": "*",
     "@rsdk/core": "*",
+    "@rsdk/http.openapi": "*",
     "@rsdk/logging": "*",
     "@rsdk/zones": "*",
     "body-parser": "^1.20.1",
     "cookie-parser": "^1.4.6",
+    "lodash": "^4.17.21",
     "reflect-metadata": "^0.1.12 || ^0.2.0",
     "rxjs": "^7.8.1"
   },
-  "gitHead": "3114a76df17cf98d6f3cbb8a931599a883af6783"
+  "gitHead": "26c1a04480e6209098be6636afbde7fd357da61a"
 }

package/src/http.config.ts

@@ -1,14 +1,11 @@
-import { Size } from '@rsdk/common';
 import {
   BoolParser,
-  Config,
-  ConfigSection,
-  ConfigTag,
   IntParser,
-  Property,
+  Size,
   SizeParser,
   StringParser,
-} from '@rsdk/core';
+} from '@rsdk/common';
+import { Config, ConfigSection, ConfigTag, Property } from '@rsdk/core';
 
 @ConfigSection({
   tags: [ConfigTag.infrastructure, ConfigTag.transport, ConfigTag.http],
@@ -35,7 +32,7 @@ export class HttpConfig extends Config {
 
   @Property('HTTP_SWAGGER_UI_ENABLED', new BoolParser(), {
     defaultValue: true,
-    description: 'Enable swagger UI on /swagger endpoint',
+    description: 'Enable swagger UI on /swagger (can be configured) endpoint',
   })
   readonly swaggerUI!: boolean;
 }

package/src/http.transport.ts

@@ -2,11 +2,10 @@ import { type ExecutionContext } from '@nestjs/common';
 import type { Controller, INestApplication } from '@nestjs/common/interfaces';
 import type { CorsOptions } from '@nestjs/common/interfaces/external/cors-options.interface';
 import type { AbstractHttpAdapter } from '@nestjs/core';
-import {
-  DocumentBuilder as OriginalDocumentBuilder,
-  SwaggerModule,
-} from '@nestjs/swagger';
+import type { OpenAPIObject } from '@nestjs/swagger';
+import { SwaggerModule } from '@nestjs/swagger';
 import type { Constructor, DeepPartial } from '@rsdk/common';
+import { readObj } from '@rsdk/common.node';
 import type {
   ConfigContext,
   GenericHeaders,
@@ -16,9 +15,13 @@ import type {
   IErrorsTransformer,
   IHttpTransport,
   LogFormatter,
+  PlatformContext,
 } from '@rsdk/core';
 import { APP_DESCRIPTION, APP_NAME, APP_VERSION } from '@rsdk/core';
-import { writeFileSync } from 'node:fs';
+import type { OpenApiOptions } from '@rsdk/http.openapi';
+import { OpenApiGenerator } from '@rsdk/http.openapi';
+import type { ILogger } from '@rsdk/logging';
+import _ from 'lodash';
 
 import { HealthHttpController, MetricsHttpController } from './controllers';
 import {
@@ -37,16 +40,12 @@ export interface ParsersConfig {
   cookie: boolean;
 }
 
-export type DocumentBuilder = Omit<
-  OriginalDocumentBuilder,
-  'build' | 'setTitle' | 'setDescription' | 'setVersion'
->;
-
-export interface SwaggerOptions {
-  url: string;
-  file: string;
+export type SwaggerOptions = Partial<OpenApiOptions> | { fromFile: string };
 
-  configure(builder: DocumentBuilder): void;
+export function isFromFile(
+  swagger: SwaggerOptions,
+): swagger is { fromFile: string } {
+  return typeof swagger === 'object' && 'fromFile' in swagger;
 }
 
 export interface HttpTransportOptions {
@@ -62,7 +61,6 @@ export interface HttpTransportOptions {
 
   /**
    * Configuration of body and cookie parsers
-  // NOTE: This fields is actually is handled in transport specific way
    */
   parsers?: DeepPartial<ParsersConfig>;
 
@@ -73,11 +71,11 @@ export interface HttpTransportOptions {
    * NOTE: SwaggerUI is enabled or disabled by HTTP_SWAGGER_UI_ENABLED
    * (true by default).
    */
-  swagger?: DeepPartial<SwaggerOptions>;
+  swagger?: Record<string, SwaggerOptions>;
 }
 
 export abstract class AbstractHttpTransport implements IHttpTransport {
-  constructor(protected readonly options?: HttpTransportOptions) {}
+  constructor(protected readonly options: HttpTransportOptions = {}) {}
 
   extractHeaders(ctx: ExecutionContext): GenericHeaders {
     return new HttpHeaders(ctx);
@@ -114,48 +112,55 @@ export abstract class AbstractHttpTransport implements IHttpTransport {
   createHttpOptions(configContext: ConfigContext): HttpOptions {
     const { host, port } = configContext.resolve(HttpConfig);
 
-    return {
-      host,
-      port,
-    };
+    return { host, port };
   }
 
   createAdapter(configContext: ConfigContext): AbstractHttpAdapter {
     return this.createHttpAdapter(configContext.resolve(HttpConfig));
   }
 
-  configureApp(
+  async configureApp(
     app: INestApplication,
-    configContext: ConfigContext,
-  ): Promise<void> | void {
+    context: PlatformContext,
+    logger: ILogger,
+  ): Promise<void> {
+    const configContext = await context.getConfigContext();
     const { swaggerUI } = configContext.resolve(HttpConfig);
-    const { globalPrefix, swagger, cors } = this.options ?? {};
+    const { globalPrefix, swagger, cors } = this.options;
+
     if (globalPrefix) {
       app.setGlobalPrefix(globalPrefix);
     }
+
     if (cors) {
       app.enableCors(cors);
     }
 
-    if (swaggerUI || swagger?.file) {
-      const builder = new OriginalDocumentBuilder()
-        .setTitle(app.get(APP_NAME))
-        .setVersion(app.get(APP_VERSION))
-        .setDescription(app.get(APP_DESCRIPTION));
+    if (!swaggerUI || !swagger) {
+      return;
+    }
 
-      // Applies additional configuration from user
-      swagger?.configure?.(builder);
+    for (const [url, config] of Object.entries(swagger)) {
+      if (isFromFile(config)) {
+        try {
+          const document = await readObj<OpenAPIObject>(config.fromFile);
 
-      const openApiConfig = builder.build();
-      const spec = SwaggerModule.createDocument(app, openApiConfig);
+          SwaggerModule.setup(url, app, document);
+        } catch {
+          logger.warn(`Failed to load OpenAPI spec from ${config.fromFile}`);
+        }
 
-      if (swagger?.file) {
-        writeFileSync(swagger.file, JSON.stringify(spec));
+        continue;
       }
 
-      if (swaggerUI) {
-        SwaggerModule.setup(swagger?.url ?? '/swagger', app, spec);
-      }
+      const document = await new OpenApiGenerator(context, {
+        title: app.get(APP_NAME),
+        version: app.get(APP_VERSION),
+        description: app.get(APP_DESCRIPTION),
+        ...config,
+      }).generate();
+
+      SwaggerModule.setup(url, app, document);
     }
   }