@impactor/nest 3.0.0

package/src/configs/multi-queue-rabbitmq-server.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "MultiQueueRabbitMQServer", {
+    enumerable: true,
+    get: function() {
+        return MultiQueueRabbitMQServer;
+    }
+});
+const _microservices = require("@nestjs/microservices");
+const _common = require("@nestjs/common");
+const _amqplib = require("amqplib");
+let MultiQueueRabbitMQServer = class MultiQueueRabbitMQServer extends _microservices.Server {
+    get configs() {
+        return this._configs;
+    }
+    async listen(callback) {
+        try {
+            let connection = typeof this.options.connection === 'string' ? await (0, _amqplib.connect)(this.options.connection) : this.options.connection;
+            this._configs = {
+                ...this.options,
+                connection,
+                channel: this.options.channel || await connection.createChannel()
+            };
+            this.logger.log('Successfully connected to RabbitMQ.');
+            for (let queue of this.options.queues){
+                await this.configs.channel.assertQueue(queue, {
+                    durable: true
+                });
+                this.logger.log(`Listening on queue: ${queue}`);
+                await this.configs.channel.consume(queue, (message)=>{
+                    let content = message?.content.toString();
+                    if (content) {
+                        let { pattern, data } = JSON.parse(content);
+                        let handler = this.messageHandlers.get(pattern);
+                        if (handler) {
+                            void handler(data).then((res)=>{
+                                if (message?.properties?.replyTo) {
+                                    // ✅ Check if replyTo exists
+                                    this.configs.channel.sendToQueue(message.properties.replyTo, Buffer.from(JSON.stringify(res)), {
+                                        correlationId: message.properties.correlationId
+                                    });
+                                } else {
+                                    this.logger.warn(`No replyTo queue specified for pattern: ${pattern}`);
+                                }
+                            });
+                        } else {
+                            this.logger.warn(`No handler found for pattern: ${pattern}`);
+                        }
+                        this.configs.channel.ack(message);
+                    }
+                });
+            }
+            callback();
+        } catch (error) {
+            this.logger.error('Failed to connect to RabbitMQ', error);
+        }
+    }
+    async close() {
+        await this.configs.channel.close();
+        await this.configs.connection.close();
+        this.logger.log('RabbitMQ connection closed.');
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+    on(_event, _callback) {
+        throw new _common.NotImplementedException();
+    }
+    unwrap() {
+        throw new _common.NotImplementedException();
+    }
+    constructor(configService){
+        super(), this.configService = configService, this.logger = new _common.Logger(MultiQueueRabbitMQServer.name);
+        this.options = {
+            queues: [
+                // holds messages about creating and updating assets such as users, vehicles
+                'assets',
+                // holds authentication messages
+                'auth',
+                // holds messages about maps calculations
+                'maps',
+                // holds messages about orders updates, such as `orders.received`
+                'orders'
+            ],
+            // `MICROSERVICE_URLS` is multiple space-separated urls separated
+            connection: this.configService.get('MICROSERVICE_URLS', 'amqp://localhost:5672').split(' ')[0]
+        };
+    }
+};
+
+//# sourceMappingURL=multi-queue-rabbitmq-server.js.map

package/src/configs/multi-queue-rabbitmq-server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/configs/multi-queue-rabbitmq-server.ts"],"sourcesContent":["import { type CustomTransportStrategy, Server } from '@nestjs/microservices';\nimport { Logger, NotImplementedException } from '@nestjs/common';\nimport { type Channel, type ChannelModel, connect } from 'amqplib';\nimport { ConfigService } from '@nestjs/config';\n\nexport interface MultiQueueOptions {\n  connection: ChannelModel | string;\n  queues: string[];\n  channel?: Channel;\n}\n\n/**\n * the final configs after resolving the provided options\n */\nexport interface MultiQueueConfigs extends Omit<\n  Required<MultiQueueOptions>,\n  'connection'\n> {\n  connection: ChannelModel;\n}\n\n/**\n * a custom RabbitMQ transport that creates multiple queues in a single channel\n * https://docs.nestjs.com/microservices/custom-transport\n */\n// todo: options: channel, queues[], method= sendToQueue|publish, logLevel=dev?info:log\n\nexport class MultiQueueRabbitMQServer\n  extends Server\n  implements CustomTransportStrategy\n{\n  protected readonly logger = new Logger(MultiQueueRabbitMQServer.name);\n  // todo: pass options in the constructor using DI token\n  private options: MultiQueueOptions;\n  private _configs: MultiQueueConfigs;\n\n  constructor(private readonly configService: ConfigService) {\n    super();\n\n    this.options = {\n      queues: [\n        // holds messages about creating and updating assets such as users, vehicles\n        'assets',\n        // holds authentication messages\n        'auth',\n        // holds messages about maps calculations\n        'maps',\n        // holds messages about orders updates, such as `orders.received`\n        'orders',\n      ],\n      // `MICROSERVICE_URLS` is multiple space-separated urls separated\n      connection: this.configService\n        .get<string>('MICROSERVICE_URLS', 'amqp://localhost:5672')\n        .split(' ')[0],\n    };\n  }\n\n  get configs() {\n    return this._configs;\n  }\n\n  async listen(callback: () => void) {\n    try {\n      let connection =\n        typeof this.options.connection === 'string'\n          ? await connect(this.options.connection)\n          : this.options.connection;\n\n      this._configs = {\n        ...this.options,\n        connection,\n        channel: this.options.channel || (await connection.createChannel()),\n      };\n\n      this.logger.log('Successfully connected to RabbitMQ.');\n\n      for (let queue of this.options.queues) {\n        await this.configs.channel.assertQueue(queue, { durable: true });\n        this.logger.log(`Listening on queue: ${queue}`);\n\n        await this.configs.channel.consume(queue, (message) => {\n          let content = message?.content.toString();\n\n          if (content) {\n            let { pattern, data } = JSON.parse(content);\n            let handler = this.messageHandlers.get(pattern);\n\n            if (handler) {\n              void handler(data).then((res) => {\n                if (message?.properties?.replyTo) {\n                  // ✅ Check if replyTo exists\n                  this.configs.channel.sendToQueue(\n                    message.properties.replyTo,\n                    Buffer.from(JSON.stringify(res)),\n                    {\n                      correlationId: message.properties.correlationId,\n                    },\n                  );\n                } else {\n                  this.logger.warn(\n                    `No replyTo queue specified for pattern: ${pattern}`,\n                  );\n                }\n              });\n            } else {\n              this.logger.warn(`No handler found for pattern: ${pattern}`);\n            }\n\n            this.configs.channel.ack(message!);\n          }\n        });\n      }\n\n      callback();\n    } catch (error) {\n      this.logger.error('Failed to connect to RabbitMQ', error);\n    }\n  }\n\n  async close() {\n    await this.configs.channel.close();\n    await this.configs.connection.close();\n    this.logger.log('RabbitMQ connection closed.');\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type\n  on(_event: string, _callback: Function) {\n    throw new NotImplementedException();\n  }\n\n  unwrap<T = never>(): T {\n    throw new NotImplementedException();\n  }\n}\n"],"names":["MultiQueueRabbitMQServer","Server","configs","_configs","listen","callback","connection","options","connect","channel","createChannel","logger","log","queue","queues","assertQueue","durable","consume","message","content","toString","pattern","data","JSON","parse","handler","messageHandlers","get","then","res","properties","replyTo","sendToQueue","Buffer","from","stringify","correlationId","warn","ack","error","close","on","_event","_callback","NotImplementedException","unwrap","configService","Logger","name","split"],"mappings":"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"}

package/src/configs/redis-config.d.ts

@@ -0,0 +1,5 @@
+export interface RedisConfig {
+    redisUrl: string;
+    port: number;
+}
+export declare const redisConnfig: RedisConfig;

package/src/configs/redis-config.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "redisConnfig", {
+    enumerable: true,
+    get: function() {
+        return redisConnfig;
+    }
+});
+const redisConnfig = {
+    port: Number.parseInt(process.env.REDIS_PORT || '6379', 10),
+    redisUrl: process.env.REDIS_URL || 'redis://redis'
+};
+
+//# sourceMappingURL=redis-config.js.map

package/src/configs/redis-config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/configs/redis-config.ts"],"sourcesContent":["export interface RedisConfig {\n  redisUrl: string;\n  port: number;\n}\n\nexport const redisConnfig: RedisConfig = {\n  port: Number.parseInt(process.env.REDIS_PORT || '6379', 10),\n  redisUrl: process.env.REDIS_URL || 'redis://redis',\n};\n"],"names":["redisConnfig","port","Number","parseInt","process","env","REDIS_PORT","redisUrl","REDIS_URL"],"mappings":";;;;+BAKaA;;;eAAAA;;;AAAN,MAAMA,eAA4B;IACvCC,MAAMC,OAAOC,QAAQ,CAACC,QAAQC,GAAG,CAACC,UAAU,IAAI,QAAQ;IACxDC,UAAUH,QAAQC,GAAG,CAACG,SAAS,IAAI;AACrC"}

package/src/create-app.d.ts

@@ -0,0 +1,3 @@
+import { type NestFastifyApplication } from '@nestjs/platform-fastify';
+import { type IAppConfig } from './configs/app';
+export declare function createApp(module: any, options?: IAppConfig): Promise<NestFastifyApplication<import("fastify").RawServerDefault>>;

package/src/create-app.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "createApp", {
+    enumerable: true,
+    get: function() {
+        return createApp;
+    }
+});
+const _core = require("@nestjs/core");
+const _swagger = require("@nestjs/swagger");
+const _platformfastify = require("@nestjs/platform-fastify");
+const _multipart = /*#__PURE__*/ _interop_require_default(require("@fastify/multipart"));
+const _app = require("./configs/app");
+const _common = require("@nestjs/common");
+const _javascript = require("@impactor/javascript");
+const _nodejs = require("@impactor/nodejs");
+const _generatemetadata = require("./generate-metadata");
+const _logger = require("./utils/logger");
+function _interop_require_default(obj) {
+    return obj && obj.__esModule ? obj : {
+        default: obj
+    };
+}
+function createApp(module, options) {
+    // todo: options.adapter = fastify | express
+    return _core.NestFactory.create(module, new _platformfastify.FastifyAdapter(), options).then(async (app)=>{
+        let pkg = typeof options?.package === 'string' ? (0, _nodejs.isDirSync)(options.package) ? (0, _nodejs.readSync)(`${options.package}/package.json`) : (0, _nodejs.readSync)(options.package) : options?.package || {};
+        let opts = (0, _javascript.merge)([
+            _app.appConfig,
+            {
+                swagger: {
+                    info: {
+                        title: pkg.name,
+                        description: pkg.description || `${pkg.name ? `${pkg.name} ` : ''}API`,
+                        version: `v${pkg.version || '1.0'}`
+                    }
+                }
+            },
+            options
+        ], {
+            deep: true
+        });
+        if (opts?.prefix) {
+            if (typeof opts.prefix === 'string') {
+                app.setGlobalPrefix(opts.prefix);
+            } else {
+                let { prefix, ...prefixOptions } = opts.prefix;
+                app.setGlobalPrefix(prefix, prefixOptions);
+            }
+        }
+        if (opts.versioning) {
+            app.enableVersioning(opts.versioning);
+        }
+        app.useGlobalPipes(new _common.ValidationPipe({
+            // apply class-transformer decorators, such as @Transform()
+            transform: true,
+            // Strip out any properties that are not defined in your DTO.
+            whitelist: true,
+            // Instead of silently removing unknown fields, it throws a 400 error.
+            forbidNonWhitelisted: true,
+            ...opts.validationPipe
+        }));
+        // swagger docs
+        // navigate to localhost:PORT to see API docs
+        // navigate to localhost:PORT/-json to download the API json file
+        if (opts.swagger) {
+            // emit swagger metadata
+            // this file will be generated in runtime
+            // todo: when emitting swagger metadata using generateSwaggerMetadata(),
+            // the TSDocs comments are no longer read by nest,
+            // and we must manually add @ApiProperty() to all properties
+            let metadataPath = (0, _generatemetadata.generateSwaggerMetadata)({
+                // @ts-ignore `import.meta` requires `module: nodeNext`
+                outputDir: __dirname,
+                // fixes: src/nest-swagger-metadata.ts:2:1 - error TS2742:
+                //  The inferred type of 'default' cannot be named without a reference to '../node_modules/@impactor/utils/src/dto/order.dto'.
+                //  This is likely not portable. A type annotation is necessary.
+                transform: (content)=>content.replaceAll('../node_modules/@impactor/', '@impactor/')
+            });
+            // todo: the file by default is related to CWD(),
+            // change cwd of the target "serve" in nx.json to "{projectRoot}/dist"
+            await (0, _generatemetadata.loadSwaggerMetadata)(metadataPath).then(()=>_logger.logger.debug('Swagger metadata loaded'))// ignore if the metadata file hasn't generated
+            .catch((error)=>{
+                _logger.logger.warn(`Failed to load Swagger metadata`, error);
+            });
+            if (opts.swagger) {
+                let document = _swagger.SwaggerModule.createDocument(app, opts.swagger);
+                _swagger.SwaggerModule.setup('', app, document);
+            }
+        }
+        // todo: import `FastifyMulterModule` from '@nest-lab/fastify-multer' in the module
+        // that wants to receive files, instead of registering 'multipart' globally
+        if (opts.multipart !== false) {
+            await app.register(_multipart.default);
+        }
+        return opts.port ? app// if the server runs inside a container, it should bound to '0.0.0.0' instead of 'localhost' (the default)
+        // so it can listen to the external requests i.e. from the browser
+        .listen(opts.port, '0.0.0.0').then((_server)=>opts.onServerRun?.(app)).catch((error)=>opts.onServerError?.(error, app)).then(()=>app) : app;
+    });
+}
+
+//# sourceMappingURL=create-app.js.map

package/src/create-app.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/create-app.ts"],"sourcesContent":["import { NestFactory } from '@nestjs/core';\nimport { OpenAPIObject, SwaggerModule } from '@nestjs/swagger';\nimport {\n  FastifyAdapter,\n  type NestFastifyApplication,\n} from '@nestjs/platform-fastify';\nimport multiPart from '@fastify/multipart';\nimport { type IAppConfig, appConfig } from './configs/app';\nimport { ValidationPipe } from '@nestjs/common';\nimport { merge } from '@impactor/javascript';\nimport { isDirSync, readSync } from '@impactor/nodejs';\nimport {\n  generateSwaggerMetadata,\n  loadSwaggerMetadata,\n} from './generate-metadata';\nimport { logger } from './utils/logger';\n\n// todo: add type to `module`\nexport function createApp(module: any, options?: IAppConfig) {\n  // todo: options.adapter = fastify | express\n  return NestFactory.create<NestFastifyApplication>(\n    module,\n    new FastifyAdapter(),\n    options,\n  ).then(async (app) => {\n    let pkg = (\n      typeof options?.package === 'string'\n        ? isDirSync(options.package)\n          ? // todo: use IPackage interface\n            readSync(`${options.package}/package.json`)\n          : readSync(options.package)\n        : options?.package || {}\n    ) as Record<string, string>;\n\n    let opts = merge(\n      [\n        appConfig,\n        {\n          swagger: {\n            info: {\n              title: pkg.name,\n              description:\n                pkg.description || `${pkg.name ? `${pkg.name} ` : ''}API`,\n              version: `v${pkg.version || '1.0'}`,\n            },\n          },\n        },\n        options,\n      ],\n      {\n        deep: true,\n      },\n    ) as IAppConfig;\n\n    if (opts?.prefix) {\n      if (typeof opts.prefix === 'string') {\n        app.setGlobalPrefix(opts.prefix);\n      } else {\n        let { prefix, ...prefixOptions } = opts.prefix;\n        app.setGlobalPrefix(prefix, prefixOptions);\n      }\n    }\n\n    if (opts.versioning) {\n      app.enableVersioning(opts.versioning);\n    }\n\n    app.useGlobalPipes(\n      new ValidationPipe({\n        // apply class-transformer decorators, such as @Transform()\n        transform: true,\n        // Strip out any properties that are not defined in your DTO.\n        whitelist: true,\n        // Instead of silently removing unknown fields, it throws a 400 error.\n        forbidNonWhitelisted: true,\n        ...opts.validationPipe,\n      }),\n    );\n\n    // swagger docs\n    // navigate to localhost:PORT to see API docs\n    // navigate to localhost:PORT/-json to download the API json file\n    if (opts.swagger) {\n      // emit swagger metadata\n      // this file will be generated in runtime\n      // todo: when emitting swagger metadata using generateSwaggerMetadata(),\n      // the TSDocs comments are no longer read by nest,\n      // and we must manually add @ApiProperty() to all properties\n      let metadataPath = generateSwaggerMetadata({\n        // @ts-ignore `import.meta` requires `module: nodeNext`\n        outputDir: import.meta.dirname,\n        // fixes: src/nest-swagger-metadata.ts:2:1 - error TS2742:\n        //  The inferred type of 'default' cannot be named without a reference to '../node_modules/@impactor/utils/src/dto/order.dto'.\n        //  This is likely not portable. A type annotation is necessary.\n        transform: (content) =>\n          content.replaceAll('../node_modules/@impactor/', '@impactor/'),\n      });\n\n      // todo: the file by default is related to CWD(),\n      // change cwd of the target \"serve\" in nx.json to \"{projectRoot}/dist\"\n      await loadSwaggerMetadata(metadataPath)\n        .then(() => logger.debug('Swagger metadata loaded'))\n        // ignore if the metadata file hasn't generated\n        .catch((error) => {\n          logger.warn(`Failed to load Swagger metadata`, error);\n        });\n\n      if (opts.swagger) {\n        let document = SwaggerModule.createDocument(\n          app,\n          opts.swagger as OpenAPIObject,\n        );\n        SwaggerModule.setup('', app, document);\n      }\n    }\n\n    // todo: import `FastifyMulterModule` from '@nest-lab/fastify-multer' in the module\n    // that wants to receive files, instead of registering 'multipart' globally\n    if (opts.multipart !== false) {\n      await app.register(multiPart);\n    }\n\n    return opts.port\n      ? app\n          // if the server runs inside a container, it should bound to '0.0.0.0' instead of 'localhost' (the default)\n          // so it can listen to the external requests i.e. from the browser\n          .listen(opts.port, '0.0.0.0')\n          .then((_server) => opts.onServerRun?.(app))\n          .catch((error) => opts.onServerError?.(error, app))\n          .then(() => app)\n      : app;\n  });\n}\n"],"names":["createApp","module","options","NestFactory","create","FastifyAdapter","then","app","pkg","package","isDirSync","readSync","opts","merge","appConfig","swagger","info","title","name","description","version","deep","prefix","setGlobalPrefix","prefixOptions","versioning","enableVersioning","useGlobalPipes","ValidationPipe","transform","whitelist","forbidNonWhitelisted","validationPipe","metadataPath","generateSwaggerMetadata","outputDir","content","replaceAll","loadSwaggerMetadata","logger","debug","catch","error","warn","document","SwaggerModule","createDocument","setup","multipart","register","multiPart","port","listen","_server","onServerRun","onServerError"],"mappings":";;;;+BAkBgBA;;;eAAAA;;;sBAlBY;yBACiB;iCAItC;kEACe;qBACqB;wBACZ;4BACT;wBACc;kCAI7B;wBACgB;;;;;;AAGhB,SAASA,UAAUC,MAAW,EAAEC,OAAoB;IACzD,4CAA4C;IAC5C,OAAOC,iBAAW,CAACC,MAAM,CACvBH,QACA,IAAII,+BAAc,IAClBH,SACAI,IAAI,CAAC,OAAOC;QACZ,IAAIC,MACF,OAAON,SAASO,YAAY,WACxBC,IAAAA,iBAAS,EAACR,QAAQO,OAAO,IAEvBE,IAAAA,gBAAQ,EAAC,GAAGT,QAAQO,OAAO,CAAC,aAAa,CAAC,IAC1CE,IAAAA,gBAAQ,EAACT,QAAQO,OAAO,IAC1BP,SAASO,WAAW,CAAC;QAG3B,IAAIG,OAAOC,IAAAA,iBAAK,EACd;YACEC,cAAS;YACT;gBACEC,SAAS;oBACPC,MAAM;wBACJC,OAAOT,IAAIU,IAAI;wBACfC,aACEX,IAAIW,WAAW,IAAI,GAAGX,IAAIU,IAAI,GAAG,GAAGV,IAAIU,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC;wBAC3DE,SAAS,CAAC,CAAC,EAAEZ,IAAIY,OAAO,IAAI,OAAO;oBACrC;gBACF;YACF;YACAlB;SACD,EACD;YACEmB,MAAM;QACR;QAGF,IAAIT,MAAMU,QAAQ;YAChB,IAAI,OAAOV,KAAKU,MAAM,KAAK,UAAU;gBACnCf,IAAIgB,eAAe,CAACX,KAAKU,MAAM;YACjC,OAAO;gBACL,IAAI,EAAEA,MAAM,EAAE,GAAGE,eAAe,GAAGZ,KAAKU,MAAM;gBAC9Cf,IAAIgB,eAAe,CAACD,QAAQE;YAC9B;QACF;QAEA,IAAIZ,KAAKa,UAAU,EAAE;YACnBlB,IAAImB,gBAAgB,CAACd,KAAKa,UAAU;QACtC;QAEAlB,IAAIoB,cAAc,CAChB,IAAIC,sBAAc,CAAC;YACjB,2DAA2D;YAC3DC,WAAW;YACX,6DAA6D;YAC7DC,WAAW;YACX,sEAAsE;YACtEC,sBAAsB;YACtB,GAAGnB,KAAKoB,cAAc;QACxB;QAGF,eAAe;QACf,6CAA6C;QAC7C,iEAAiE;QACjE,IAAIpB,KAAKG,OAAO,EAAE;YAChB,wBAAwB;YACxB,yCAAyC;YACzC,wEAAwE;YACxE,kDAAkD;YAClD,4DAA4D;YAC5D,IAAIkB,eAAeC,IAAAA,yCAAuB,EAAC;gBACzC,uDAAuD;gBACvDC,WAAW;gBACX,0DAA0D;gBAC1D,8HAA8H;gBAC9H,gEAAgE;gBAChEN,WAAW,CAACO,UACVA,QAAQC,UAAU,CAAC,8BAA8B;YACrD;YAEA,iDAAiD;YACjD,sEAAsE;YACtE,MAAMC,IAAAA,qCAAmB,EAACL,cACvB3B,IAAI,CAAC,IAAMiC,cAAM,CAACC,KAAK,CAAC,2BACzB,+CAA+C;aAC9CC,KAAK,CAAC,CAACC;gBACNH,cAAM,CAACI,IAAI,CAAC,CAAC,+BAA+B,CAAC,EAAED;YACjD;YAEF,IAAI9B,KAAKG,OAAO,EAAE;gBAChB,IAAI6B,WAAWC,sBAAa,CAACC,cAAc,CACzCvC,KACAK,KAAKG,OAAO;gBAEd8B,sBAAa,CAACE,KAAK,CAAC,IAAIxC,KAAKqC;YAC/B;QACF;QAEA,mFAAmF;QACnF,2EAA2E;QAC3E,IAAIhC,KAAKoC,SAAS,KAAK,OAAO;YAC5B,MAAMzC,IAAI0C,QAAQ,CAACC,kBAAS;QAC9B;QAEA,OAAOtC,KAAKuC,IAAI,GACZ5C,GACE,2GAA2G;QAC3G,kEAAkE;SACjE6C,MAAM,CAACxC,KAAKuC,IAAI,EAAE,WAClB7C,IAAI,CAAC,CAAC+C,UAAYzC,KAAK0C,WAAW,GAAG/C,MACrCkC,KAAK,CAAC,CAACC,QAAU9B,KAAK2C,aAAa,GAAGb,OAAOnC,MAC7CD,IAAI,CAAC,IAAMC,OACdA;IACN;AACF"}

package/src/create-microservice.d.ts

@@ -0,0 +1,2 @@
+import { IMicroserviceOptions } from './configs/microservice';
+export declare function createMicroservice(module: any, options?: IMicroserviceOptions): Promise<import("@nestjs/common").INestMicroservice>;

package/src/create-microservice.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "createMicroservice", {
+    enumerable: true,
+    get: function() {
+        return createMicroservice;
+    }
+});
+const _core = require("@nestjs/core");
+const _common = require("@nestjs/common");
+const _wsexceptionfilter = require("./filters/ws-exception.filter");
+const _typeormexceptionfilter = require("./filters/typeorm-exception.filter");
+const _errortorpcexceptionfilter = require("./filters/error-to-rpc-exception.filter");
+const _microservice = require("./configs/microservice");
+function createMicroservice(// todo: `module: IEntryNestModule`
+module, options) {
+    // @ts-expect-error  Type 'Transport.TCP' is not assignable to type 'Transport.KAFKA'
+    let opts = {
+        ..._microservice.microserviceOptions,
+        ...options
+    };
+    // todo: merge with ./create-testing-microservice
+    // opts.testing? .createNestMicroservice(): createMicroservice()
+    return _core.NestFactory.createMicroservice(module, opts).then((app)=>{
+        app.useGlobalFilters(new _typeormexceptionfilter.TypeORMExceptionFilter(), // WS filters cannot registered globally, you need to add `@UseFilters()` to each gateway
+        // from docs: "The useGlobalFilters() method does not set up filters for gateways or hybrid applications"
+        // https://docs.nestjs.com/exception-filters#binding-filters
+        new _wsexceptionfilter.WebSocketExceptionFilter(), new _errortorpcexceptionfilter.ErrorToRpcExceptionFilter());
+        app.useGlobalPipes(new _common.ValidationPipe({
+            whitelist: true,
+            transform: true,
+            // forbidNonWhitelisted: true,
+            transformOptions: {
+                enableImplicitConversion: true
+            }
+        }));
+        return app.listen().then((_server)=>opts?.onServerRun?.(app)).catch((error)=>opts?.onServerError?.(error, app)).then(()=>app);
+    });
+}
+
+//# sourceMappingURL=create-microservice.js.map

package/src/create-microservice.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/create-microservice.ts"],"sourcesContent":["import { NestFactory } from '@nestjs/core';\nimport { ValidationPipe } from '@nestjs/common';\nimport { type MicroserviceOptions } from '@nestjs/microservices';\nimport { WebSocketExceptionFilter } from './filters/ws-exception.filter';\nimport { TypeORMExceptionFilter } from './filters/typeorm-exception.filter';\nimport { ErrorToRpcExceptionFilter } from './filters/error-to-rpc-exception.filter';\nimport {\n  IMicroserviceOptions,\n  microserviceOptions,\n} from './configs/microservice';\n\n/**\n * Create a NestJs microservice\n * @param module the main module (AppModule)\n * @param microserviceOptions\n * @param appOptions\n * @returns\n */\nexport function createMicroservice(\n  // todo: `module: IEntryNestModule`\n  module: any,\n  options?: IMicroserviceOptions,\n) {\n  // @ts-expect-error  Type 'Transport.TCP' is not assignable to type 'Transport.KAFKA'\n  let opts: IMicroserviceOptions = {\n    ...microserviceOptions,\n    ...options,\n  };\n\n  // todo: merge with ./create-testing-microservice\n  // opts.testing? .createNestMicroservice(): createMicroservice()\n  return NestFactory.createMicroservice<MicroserviceOptions>(module, opts).then(\n    (app) => {\n      app.useGlobalFilters(\n        new TypeORMExceptionFilter(),\n        // WS filters cannot registered globally, you need to add `@UseFilters()` to each gateway\n        // from docs: \"The useGlobalFilters() method does not set up filters for gateways or hybrid applications\"\n        // https://docs.nestjs.com/exception-filters#binding-filters\n        new WebSocketExceptionFilter(),\n        new ErrorToRpcExceptionFilter(),\n      );\n\n      app.useGlobalPipes(\n        new ValidationPipe({\n          whitelist: true,\n          transform: true,\n          // forbidNonWhitelisted: true,\n          transformOptions: {\n            enableImplicitConversion: true,\n          },\n        }),\n      );\n\n      return app\n        .listen()\n        .then((_server) => opts?.onServerRun?.(app))\n        .catch((error) => opts?.onServerError?.(error, app))\n        .then(() => app);\n    },\n  );\n}\n"],"names":["createMicroservice","module","options","opts","microserviceOptions","NestFactory","then","app","useGlobalFilters","TypeORMExceptionFilter","WebSocketExceptionFilter","ErrorToRpcExceptionFilter","useGlobalPipes","ValidationPipe","whitelist","transform","transformOptions","enableImplicitConversion","listen","_server","onServerRun","catch","error","onServerError"],"mappings":";;;;+BAkBgBA;;;eAAAA;;;sBAlBY;wBACG;mCAEU;wCACF;2CACG;8BAInC;AASA,SAASA,mBACd,mCAAmC;AACnCC,MAAW,EACXC,OAA8B;IAE9B,qFAAqF;IACrF,IAAIC,OAA6B;QAC/B,GAAGC,iCAAmB;QACtB,GAAGF,OAAO;IACZ;IAEA,iDAAiD;IACjD,gEAAgE;IAChE,OAAOG,iBAAW,CAACL,kBAAkB,CAAsBC,QAAQE,MAAMG,IAAI,CAC3E,CAACC;QACCA,IAAIC,gBAAgB,CAClB,IAAIC,8CAAsB,IAC1B,yFAAyF;QACzF,yGAAyG;QACzG,4DAA4D;QAC5D,IAAIC,2CAAwB,IAC5B,IAAIC,oDAAyB;QAG/BJ,IAAIK,cAAc,CAChB,IAAIC,sBAAc,CAAC;YACjBC,WAAW;YACXC,WAAW;YACX,8BAA8B;YAC9BC,kBAAkB;gBAChBC,0BAA0B;YAC5B;QACF;QAGF,OAAOV,IACJW,MAAM,GACNZ,IAAI,CAAC,CAACa,UAAYhB,MAAMiB,cAAcb,MACtCc,KAAK,CAAC,CAACC,QAAUnB,MAAMoB,gBAAgBD,OAAOf,MAC9CD,IAAI,CAAC,IAAMC;IAChB;AAEJ"}

package/src/create-testing-microservice.d.ts

@@ -0,0 +1,3 @@
+import { TestingModule } from '@nestjs/testing';
+import { IMicroserviceOptions } from './configs/microservice';
+export declare function createTestingMicroservice(module: TestingModule, options?: IMicroserviceOptions): Promise<import("@nestjs/common").INestMicroservice>;

package/src/create-testing-microservice.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "createTestingMicroservice", {
+    enumerable: true,
+    get: function() {
+        return createTestingMicroservice;
+    }
+});
+const _common = require("@nestjs/common");
+const _microservices = require("@nestjs/microservices");
+const _typeormexceptionfilter = require("./filters/typeorm-exception.filter");
+const _wsexceptionfilter = require("./filters/ws-exception.filter");
+const _microservice = require("./configs/microservice");
+function createTestingMicroservice(module, options = {}) {
+    // @ts-expect-error  Type 'Transport.TCP' is not assignable to type 'Transport.KAFKA'
+    let opts = {
+        ..._microservice.microserviceOptions,
+        ...options
+    };
+    let app = module.createNestMicroservice(opts);
+    app.useGlobalFilters(new _typeormexceptionfilter.TypeORMExceptionFilter(), new _wsexceptionfilter.WebSocketExceptionFilter());
+    app.useGlobalPipes(new _common.ValidationPipe({
+        exceptionFactory: (errors)=>new _microservices.RpcException(errors)
+    }));
+    return app.listen().then((_server)=>opts?.onServerRun?.(app)).catch((error)=>opts?.onServerError?.(error, app)).then(()=>app);
+}
+
+//# sourceMappingURL=create-testing-microservice.js.map

package/src/create-testing-microservice.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/create-testing-microservice.ts"],"sourcesContent":["import { ValidationPipe } from '@nestjs/common';\nimport { type MicroserviceOptions, RpcException } from '@nestjs/microservices';\nimport { TestingModule } from '@nestjs/testing';\nimport { TypeORMExceptionFilter } from './filters/typeorm-exception.filter';\nimport { WebSocketExceptionFilter } from './filters/ws-exception.filter';\nimport {\n  IMicroserviceOptions,\n  microserviceOptions,\n} from './configs/microservice';\n\n/**\n * Create a testing Nestjs Microservice\n * see createMicroservice()\n * @param module\n * @param options\n * @returns\n */\nexport function createTestingMicroservice(\n  module: TestingModule,\n  options: IMicroserviceOptions = {},\n) {\n  // @ts-expect-error  Type 'Transport.TCP' is not assignable to type 'Transport.KAFKA'\n  let opts: IMicroserviceOptions = {\n    ...microserviceOptions,\n    ...options,\n  };\n\n  let app = module.createNestMicroservice<MicroserviceOptions>(opts);\n\n  app.useGlobalFilters(\n    new TypeORMExceptionFilter(),\n    new WebSocketExceptionFilter(),\n  );\n\n  app.useGlobalPipes(\n    new ValidationPipe({\n      exceptionFactory: (errors) => new RpcException(errors),\n    }),\n  );\n  return app\n    .listen()\n    .then((_server) => opts?.onServerRun?.(app))\n    .catch((error) => opts?.onServerError?.(error, app))\n    .then(() => app);\n}\n"],"names":["createTestingMicroservice","module","options","opts","microserviceOptions","app","createNestMicroservice","useGlobalFilters","TypeORMExceptionFilter","WebSocketExceptionFilter","useGlobalPipes","ValidationPipe","exceptionFactory","errors","RpcException","listen","then","_server","onServerRun","catch","error","onServerError"],"mappings":";;;;+BAiBgBA;;;eAAAA;;;wBAjBe;+BACwB;wCAEhB;mCACE;8BAIlC;AASA,SAASA,0BACdC,MAAqB,EACrBC,UAAgC,CAAC,CAAC;IAElC,qFAAqF;IACrF,IAAIC,OAA6B;QAC/B,GAAGC,iCAAmB;QACtB,GAAGF,OAAO;IACZ;IAEA,IAAIG,MAAMJ,OAAOK,sBAAsB,CAAsBH;IAE7DE,IAAIE,gBAAgB,CAClB,IAAIC,8CAAsB,IAC1B,IAAIC,2CAAwB;IAG9BJ,IAAIK,cAAc,CAChB,IAAIC,sBAAc,CAAC;QACjBC,kBAAkB,CAACC,SAAW,IAAIC,2BAAY,CAACD;IACjD;IAEF,OAAOR,IACJU,MAAM,GACNC,IAAI,CAAC,CAACC,UAAYd,MAAMe,cAAcb,MACtCc,KAAK,CAAC,CAACC,QAAUjB,MAAMkB,gBAAgBD,OAAOf,MAC9CW,IAAI,CAAC,IAAMX;AAChB"}

package/src/decorators/controller/add-decorators/add-controller-path.d.ts

@@ -0,0 +1,2 @@
+import { ControllerFactory } from '../controller.factory';
+export declare function addControllerPath(factory: ControllerFactory): void;

package/src/decorators/controller/add-decorators/add-controller-path.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "addControllerPath", {
+    enumerable: true,
+    get: function() {
+        return addControllerPath;
+    }
+});
+const _common = require("@nestjs/common");
+const _reflect = require("../utils/reflect");
+function addControllerPath(factory) {
+    if ((0, _reflect.has)('path', factory) || factory.options.path === null) return;
+    let path = factory.options.path;
+    if (path) {
+        // todo: `@Controller()` can also take an options object
+        factory.decorators.push((0, _common.Controller)(path));
+    }
+}
+
+//# sourceMappingURL=add-controller-path.js.map

package/src/decorators/controller/add-decorators/add-controller-path.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/decorators/controller/add-decorators/add-controller-path.ts"],"sourcesContent":["import { Controller } from '@nestjs/common';\nimport { ControllerFactory } from '../controller.factory';\nimport { has } from '../utils/reflect';\n\n/**\n * add Nest `@Controller()` decorator\n */\nexport function addControllerPath(factory: ControllerFactory) {\n  if (has('path', factory) || factory.options.path === null) return;\n\n  let path = factory.options.path;\n\n  if (path) {\n    // todo: `@Controller()` can also take an options object\n    factory.decorators.push(Controller(path));\n  }\n}\n"],"names":["addControllerPath","factory","has","options","path","decorators","push","Controller"],"mappings":";;;;+BAOgBA;;;eAAAA;;;wBAPW;yBAEP;AAKb,SAASA,kBAAkBC,OAA0B;IAC1D,IAAIC,IAAAA,YAAG,EAAC,QAAQD,YAAYA,QAAQE,OAAO,CAACC,IAAI,KAAK,MAAM;IAE3D,IAAIA,OAAOH,QAAQE,OAAO,CAACC,IAAI;IAE/B,IAAIA,MAAM;QACR,wDAAwD;QACxDH,QAAQI,UAAU,CAACC,IAAI,CAACC,IAAAA,kBAAU,EAACH;IACrC;AACF"}

package/src/decorators/controller/add-decorators/add-controller-tags.d.ts

@@ -0,0 +1,2 @@
+import { ControllerFactory } from '../controller.factory';
+export declare function addControllerTags(factory: ControllerFactory, tags?: string | string[]): void;

package/src/decorators/controller/add-decorators/add-controller-tags.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "addControllerTags", {
+    enumerable: true,
+    get: function() {
+        return addControllerTags;
+    }
+});
+const _reflect = require("../utils/reflect");
+const _swagger = require("@nestjs/swagger");
+function addControllerTags(factory, tags) {
+    // to get the metadata name, open the definition of `ApiResponse()`
+    // and check `Reflect.defineMetadata(/* metadata name */)`
+    // for `@nestjs/swagger`, decorators metadata are defined in `DECORATORS.*` constant
+    if ((0, _reflect.has)('swagger/apiUseTags', factory) || factory.options.tags === null) return;
+    tags = factory.options.tags || factory.options.path || (0, _reflect.get)('path', factory);
+    if (tags) {
+        if (Array.isArray(tags)) {
+            factory.decorators.push((0, _swagger.ApiTags)(...tags));
+        } else {
+            factory.decorators.push((0, _swagger.ApiTags)(tags));
+        }
+    }
+}
+
+//# sourceMappingURL=add-controller-tags.js.map

package/src/decorators/controller/add-decorators/add-controller-tags.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/decorators/controller/add-decorators/add-controller-tags.ts"],"sourcesContent":["import { ControllerFactory } from '../controller.factory';\nimport { get, has } from '../utils/reflect';\nimport { ApiTags } from '@nestjs/swagger';\n\n/**\n * add Swagger `@ApiTags()` decorator\n */\nexport function addControllerTags(\n  factory: ControllerFactory,\n  tags?: string | string[],\n) {\n  // to get the metadata name, open the definition of `ApiResponse()`\n  // and check `Reflect.defineMetadata(/* metadata name */)`\n  // for `@nestjs/swagger`, decorators metadata are defined in `DECORATORS.*` constant\n  if (has('swagger/apiUseTags', factory) || factory.options.tags === null)\n    return;\n\n  tags = factory.options.tags || factory.options.path || get('path', factory);\n\n  if (tags) {\n    if (Array.isArray(tags)) {\n      factory.decorators.push(ApiTags(...tags));\n    } else {\n      factory.decorators.push(ApiTags(tags));\n    }\n  }\n}\n"],"names":["addControllerTags","factory","tags","has","options","path","get","Array","isArray","decorators","push","ApiTags"],"mappings":";;;;+BAOgBA;;;eAAAA;;;yBANS;yBACD;AAKjB,SAASA,kBACdC,OAA0B,EAC1BC,IAAwB;IAExB,mEAAmE;IACnE,0DAA0D;IAC1D,oFAAoF;IACpF,IAAIC,IAAAA,YAAG,EAAC,sBAAsBF,YAAYA,QAAQG,OAAO,CAACF,IAAI,KAAK,MACjE;IAEFA,OAAOD,QAAQG,OAAO,CAACF,IAAI,IAAID,QAAQG,OAAO,CAACC,IAAI,IAAIC,IAAAA,YAAG,EAAC,QAAQL;IAEnE,IAAIC,MAAM;QACR,IAAIK,MAAMC,OAAO,CAACN,OAAO;YACvBD,QAAQQ,UAAU,CAACC,IAAI,CAACC,IAAAA,gBAAO,KAAIT;QACrC,OAAO;YACLD,QAAQQ,UAAU,CAACC,IAAI,CAACC,IAAAA,gBAAO,EAACT;QAClC;IACF;AACF"}

package/src/decorators/controller/add-decorators/add-http-method.d.ts

@@ -0,0 +1,3 @@
+import { ControllerFactory } from '../controller.factory';
+import type { IRoute } from '../types';
+export declare function addHttpMethod(route: IRoute, factory: ControllerFactory): void;

package/src/decorators/controller/add-decorators/add-http-method.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "addHttpMethod", {
+    enumerable: true,
+    get: function() {
+        return addHttpMethod;
+    }
+});
+const _reflect = require("../utils/reflect");
+const _common = require("@nestjs/common");
+function addHttpMethod(route, factory) {
+    if ((0, _reflect.has)('method', factory, route)) return;
+    let map = {
+        POST: _common.Post,
+        PATCH: _common.Patch,
+        PUT: _common.Put,
+        DELETE: _common.Delete,
+        GET: _common.Get
+    };
+    let fn = map[route.httpMethod.toUpperCase()] || _common.Get;
+    // use @Get() or add "method" and "path" using Reflect.defineMetadata()
+    route.decorators.push(fn(route.path));
+}
+
+//# sourceMappingURL=add-http-method.js.map

package/src/decorators/controller/add-decorators/add-http-method.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/decorators/controller/add-decorators/add-http-method.ts"],"sourcesContent":["import { has } from '../utils/reflect';\nimport { ControllerFactory } from '../controller.factory';\nimport type { IRoute } from '../types';\nimport { Delete, Get, Patch, Post, Put } from '@nestjs/common';\n\n/**\n * add NestJs http decorator to the route, such as \\@Get(\"/\")\n * @param route\n */\nexport function addHttpMethod(route: IRoute, factory: ControllerFactory) {\n  if (has('method', factory, route)) return;\n\n  let map = {\n    POST: Post,\n    PATCH: Patch,\n    PUT: Put,\n    DELETE: Delete,\n    GET: Get,\n  };\n\n  let fn = map[route.httpMethod.toUpperCase() as keyof typeof map] || Get;\n\n  // use @Get() or add \"method\" and \"path\" using Reflect.defineMetadata()\n  route.decorators.push(fn(route.path));\n}\n"],"names":["addHttpMethod","route","factory","has","map","POST","Post","PATCH","Patch","PUT","Put","DELETE","Delete","GET","Get","fn","httpMethod","toUpperCase","decorators","push","path"],"mappings":";;;;+BASgBA;;;eAAAA;;;yBATI;wBAG0B;AAMvC,SAASA,cAAcC,KAAa,EAAEC,OAA0B;IACrE,IAAIC,IAAAA,YAAG,EAAC,UAAUD,SAASD,QAAQ;IAEnC,IAAIG,MAAM;QACRC,MAAMC,YAAI;QACVC,OAAOC,aAAK;QACZC,KAAKC,WAAG;QACRC,QAAQC,cAAM;QACdC,KAAKC,WAAG;IACV;IAEA,IAAIC,KAAKX,GAAG,CAACH,MAAMe,UAAU,CAACC,WAAW,GAAuB,IAAIH,WAAG;IAEvE,uEAAuE;IACvEb,MAAMiB,UAAU,CAACC,IAAI,CAACJ,GAAGd,MAAMmB,IAAI;AACrC"}

package/src/decorators/controller/add-decorators/add-swagger-body.d.ts

@@ -0,0 +1,3 @@
+import { ControllerFactory } from '../controller.factory';
+import type { IRoute } from '../types';
+export declare function addSwaggerBody(route: IRoute, factory: ControllerFactory): void;

package/src/decorators/controller/add-decorators/add-swagger-body.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "addSwaggerBody", {
+    enumerable: true,
+    get: function() {
+        return addSwaggerBody;
+    }
+});
+const _reflect = require("../utils/reflect");
+const _emptydto = require("../dto/empty.dto");
+const _swagger = require("@nestjs/swagger");
+function addSwaggerBody(route, factory) {
+    if ((0, _reflect.has)('swagger/apiResponse', factory, route)) return;
+    if (// todo: create DTO variations for each http method
+    // for example make all fields optional for PATCH
+    // todo: add ValidationPipe groups for each http method
+    [
+        'POST',
+        'PATCH',
+        'PUT'
+    ].includes(route.httpMethod)) {
+        route.decorators.push((0, _swagger.ApiBody)({
+            type: route.model === null ? _emptydto.EmptyDto : route.model || factory.options?.model
+        }));
+    }
+}
+
+//# sourceMappingURL=add-swagger-body.js.map

package/src/decorators/controller/add-decorators/add-swagger-body.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/decorators/controller/add-decorators/add-swagger-body.ts"],"sourcesContent":["import { has } from '../utils/reflect';\nimport { ControllerFactory } from '../controller.factory';\nimport { EmptyDto } from '../dto/empty.dto';\nimport type { HttpMethod, IRoute } from '../types';\nimport { ApiBody } from '@nestjs/swagger';\n\nexport function addSwaggerBody(route: IRoute, factory: ControllerFactory) {\n  if (has('swagger/apiResponse', factory, route)) return;\n  if (\n    // todo: create DTO variations for each http method\n    // for example make all fields optional for PATCH\n    // todo: add ValidationPipe groups for each http method\n    (<HttpMethod[]>['POST', 'PATCH', 'PUT']).includes(route.httpMethod)\n  ) {\n    route.decorators.push(\n      ApiBody({\n        type:\n          route.model === null\n            ? EmptyDto\n            : route.model || factory.options?.model,\n      }),\n    );\n  }\n}\n"],"names":["addSwaggerBody","route","factory","has","includes","httpMethod","decorators","push","ApiBody","type","model","EmptyDto","options"],"mappings":";;;;+BAMgBA;;;eAAAA;;;yBANI;0BAEK;yBAED;AAEjB,SAASA,eAAeC,KAAa,EAAEC,OAA0B;IACtE,IAAIC,IAAAA,YAAG,EAAC,uBAAuBD,SAASD,QAAQ;IAChD,IAIE,AAHA,mDAAmD;IACnD,iDAAiD;IACjD,uDAAuD;IACxC;QAAC;QAAQ;QAAS;KAAM,CAAEG,QAAQ,CAACH,MAAMI,UAAU,GAClE;QACAJ,MAAMK,UAAU,CAACC,IAAI,CACnBC,IAAAA,gBAAO,EAAC;YACNC,MACER,MAAMS,KAAK,KAAK,OACZC,kBAAQ,GACRV,MAAMS,KAAK,IAAIR,QAAQU,OAAO,EAAEF;QACxC;IAEJ;AACF"}

package/src/decorators/controller/add-decorators/add-swagger-operation.d.ts

@@ -0,0 +1,3 @@
+import { ControllerFactory } from '../controller.factory';
+import type { IRoute } from '../types';
+export declare function addSwaggerOperation(route: IRoute, factory: ControllerFactory): void;

package/src/decorators/controller/add-decorators/add-swagger-operation.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "addSwaggerOperation", {
+    enumerable: true,
+    get: function() {
+        return addSwaggerOperation;
+    }
+});
+const _reflect = require("../utils/reflect");
+const _swagger = require("@nestjs/swagger");
+function addSwaggerOperation(route, factory) {
+    if ((0, _reflect.has)('swagger/apiOperation', factory, route)) return;
+    // remove "path" or add "prefix" metadata to it from the constructor
+    // to prevent displaying the path without the controller prefix in Swagger docs
+    let { path, ...operation } = route;
+    route.decorators.push((0, _swagger.ApiOperation)(operation));
+}
+
+//# sourceMappingURL=add-swagger-operation.js.map

package/src/decorators/controller/add-decorators/add-swagger-operation.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/decorators/controller/add-decorators/add-swagger-operation.ts"],"sourcesContent":["import { has } from '../utils/reflect';\nimport { ControllerFactory } from '../controller.factory';\nimport type { IRoute } from '../types';\nimport { ApiOperation } from '@nestjs/swagger';\n\n/**\n * add Swagger's \\@ApiOperation()\n * @param route\n */\nexport function addSwaggerOperation(route: IRoute, factory: ControllerFactory) {\n  if (has('swagger/apiOperation', factory, route)) return;\n\n  // remove \"path\" or add \"prefix\" metadata to it from the constructor\n  // to prevent displaying the path without the controller prefix in Swagger docs\n  let { path, ...operation } = route;\n  route.decorators.push(ApiOperation(operation));\n}\n"],"names":["addSwaggerOperation","route","factory","has","path","operation","decorators","push","ApiOperation"],"mappings":";;;;+BASgBA;;;eAAAA;;;yBATI;yBAGS;AAMtB,SAASA,oBAAoBC,KAAa,EAAEC,OAA0B;IAC3E,IAAIC,IAAAA,YAAG,EAAC,wBAAwBD,SAASD,QAAQ;IAEjD,oEAAoE;IACpE,+EAA+E;IAC/E,IAAI,EAAEG,IAAI,EAAE,GAAGC,WAAW,GAAGJ;IAC7BA,MAAMK,UAAU,CAACC,IAAI,CAACC,IAAAA,qBAAY,EAACH;AACrC"}

package/src/decorators/controller/add-decorators/add-swagger-params.d.ts

@@ -0,0 +1,3 @@
+import { ControllerFactory } from '../controller.factory';
+import type { IRoute } from '../types';
+export declare function addSwaggerParams(route: IRoute, factory: ControllerFactory): void;

package/src/decorators/controller/add-decorators/add-swagger-params.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "addSwaggerParams", {
+    enumerable: true,
+    get: function() {
+        return addSwaggerParams;
+    }
+});
+const _reflect = require("../utils/reflect");
+const _swagger = require("@nestjs/swagger");
+function addSwaggerParams(route, factory) {
+    if ((0, _reflect.has)('swagger/apiParameters', factory, route)) return;
+    let queryParams = route.queryParams || factory.options?.queryParams;
+    queryParams?.map((param)=>{
+        // exclude params that doesn't match the route
+        if (param.many === false && route.many) return;
+        if (param.many === true && !route.many) return;
+        if (param.httpMethods && !param.httpMethods.includes(route.httpMethod)) return;
+        if (!param.type && [
+            'number',
+            'string'
+        ].includes(typeof param.example)) param.type = typeof param.example;
+        else if (param.type === 'array' || Array.isArray(param?.example) && !param.type && !param.schema) {
+            param = {
+                schema: {
+                    type: 'array',
+                    items: {
+                        type: 'string'
+                    }
+                },
+                // add items as array to prevent sending items as v1%2Cv2 instead of v1,v2
+                // converts the array into ?key=v1,v2,...
+                style: 'form',
+                // don't generate separate params for each item
+                // i.e. ?key=v1&key=v2
+                explode: false,
+                ...param
+            };
+            delete param.type;
+        }
+        // if param.required not provided, set it to false
+        param.required = !!param.required;
+        route.decorators.push((0, _swagger.ApiQuery)(param));
+    });
+    route.pathParams?.map((param)=>route.decorators.push((0, _swagger.ApiParam)(param)));
+}
+
+//# sourceMappingURL=add-swagger-params.js.map

package/src/decorators/controller/add-decorators/add-swagger-params.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/decorators/controller/add-decorators/add-swagger-params.ts"],"sourcesContent":["import { has } from '../utils/reflect';\nimport { ControllerFactory } from '../controller.factory';\nimport type { IRoute } from '../types';\nimport { ApiParam, ApiQuery } from '@nestjs/swagger';\n\n/**\n * add Swagger's \\@ApiQuery() and \\ApiParam() for each param\n * @param route\n */\nexport function addSwaggerParams(route: IRoute, factory: ControllerFactory) {\n  if (has('swagger/apiParameters', factory, route)) return;\n\n  let queryParams = route.queryParams || factory.options?.queryParams;\n  queryParams?.map((param) => {\n    // exclude params that doesn't match the route\n    if (param.many === false && route.many) return;\n    if (param.many === true && !route.many) return;\n\n    if (param.httpMethods && !param.httpMethods.includes(route.httpMethod))\n      return;\n\n    if (!param.type && ['number', 'string'].includes(typeof param.example))\n      param.type = typeof param.example;\n    else if (\n      param.type === 'array' ||\n      (Array.isArray(param?.example) && !param.type && !param.schema)\n    ) {\n      param = {\n        schema: {\n          type: 'array',\n          items: {\n            type: 'string',\n          },\n        },\n        // add items as array to prevent sending items as v1%2Cv2 instead of v1,v2\n        // converts the array into ?key=v1,v2,...\n        style: 'form',\n        // don't generate separate params for each item\n        // i.e. ?key=v1&key=v2\n        explode: false,\n        ...param,\n      };\n\n      delete param.type;\n    }\n\n    // if param.required not provided, set it to false\n    param.required = !!param.required;\n\n    route.decorators.push(ApiQuery(param));\n  });\n\n  route.pathParams?.map((param) => route.decorators.push(ApiParam(param)));\n}\n"],"names":["addSwaggerParams","route","factory","has","queryParams","options","map","param","many","httpMethods","includes","httpMethod","type","example","Array","isArray","schema","items","style","explode","required","decorators","push","ApiQuery","pathParams","ApiParam"],"mappings":";;;;+BASgBA;;;eAAAA;;;yBATI;yBAGe;AAM5B,SAASA,iBAAiBC,KAAa,EAAEC,OAA0B;IACxE,IAAIC,IAAAA,YAAG,EAAC,yBAAyBD,SAASD,QAAQ;IAElD,IAAIG,cAAcH,MAAMG,WAAW,IAAIF,QAAQG,OAAO,EAAED;IACxDA,aAAaE,IAAI,CAACC;QAChB,8CAA8C;QAC9C,IAAIA,MAAMC,IAAI,KAAK,SAASP,MAAMO,IAAI,EAAE;QACxC,IAAID,MAAMC,IAAI,KAAK,QAAQ,CAACP,MAAMO,IAAI,EAAE;QAExC,IAAID,MAAME,WAAW,IAAI,CAACF,MAAME,WAAW,CAACC,QAAQ,CAACT,MAAMU,UAAU,GACnE;QAEF,IAAI,CAACJ,MAAMK,IAAI,IAAI;YAAC;YAAU;SAAS,CAACF,QAAQ,CAAC,OAAOH,MAAMM,OAAO,GACnEN,MAAMK,IAAI,GAAG,OAAOL,MAAMM,OAAO;aAC9B,IACHN,MAAMK,IAAI,KAAK,WACdE,MAAMC,OAAO,CAACR,OAAOM,YAAY,CAACN,MAAMK,IAAI,IAAI,CAACL,MAAMS,MAAM,EAC9D;YACAT,QAAQ;gBACNS,QAAQ;oBACNJ,MAAM;oBACNK,OAAO;wBACLL,MAAM;oBACR;gBACF;gBACA,0EAA0E;gBAC1E,yCAAyC;gBACzCM,OAAO;gBACP,+CAA+C;gBAC/C,sBAAsB;gBACtBC,SAAS;gBACT,GAAGZ,KAAK;YACV;YAEA,OAAOA,MAAMK,IAAI;QACnB;QAEA,kDAAkD;QAClDL,MAAMa,QAAQ,GAAG,CAAC,CAACb,MAAMa,QAAQ;QAEjCnB,MAAMoB,UAAU,CAACC,IAAI,CAACC,IAAAA,iBAAQ,EAAChB;IACjC;IAEAN,MAAMuB,UAAU,EAAElB,IAAI,CAACC,QAAUN,MAAMoB,UAAU,CAACC,IAAI,CAACG,IAAAA,iBAAQ,EAAClB;AAClE"}