@ethalium/nestjs-openapi 0.0.1

package/interfaces/route.interface.d.ts

@@ -0,0 +1,14 @@
+import { ExternalDocumentationObject } from "@nestjs/swagger/dist/interfaces/open-api-spec.interface";
+import { IOpenApiBodyOptions } from "./body.interface";
+import { RequestMappingMetadata } from "@nestjs/common/decorators/http/request-mapping.decorator";
+import { IOpenApiRequestOptions } from "./request.interface";
+import { IOpenApiResponseOptions, IOpenApiResponseType } from "./common.interface";
+export interface IOpenApiRouteOptions extends IOpenApiRequestOptions, Omit<RequestMappingMetadata, 'method'> {
+    exclude?: boolean;
+    summary?: string;
+    description?: string;
+    operationId?: string;
+    externalDocs?: ExternalDocumentationObject;
+    body?: IOpenApiBodyOptions;
+    response?: IOpenApiResponseType | IOpenApiResponseOptions;
+}

package/interfaces/route.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=route.interface.js.map

package/interfaces/route.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.interface.js","sourceRoot":"","sources":["../../../lib/interfaces/route.interface.ts"],"names":[],"mappings":""}

package/openapi.builder.d.ts

@@ -0,0 +1,30 @@
+import { INestApplication } from "@nestjs/common";
+import { IOpenApiDocumentOptions, OpenApiDocument } from "./interfaces/document.interface";
+export declare class OpenApiBuilder {
+    private readonly app;
+    private readonly config;
+    private readonly opts;
+    constructor(app: INestApplication, config: Omit<OpenApiDocument, 'paths'>, opts: IOpenApiDocumentOptions);
+    private get scanner();
+    private get options();
+    build(): Omit<OpenApiDocument, 'paths'>;
+    private buildTagGroups;
+    private buildTags;
+    private buildResponseOverrides;
+    private getControllers;
+    private getControllersWithTagGroup;
+    private getMethods;
+    private getMethodsWithTagGroup;
+    private getResponses;
+    private getNearestTagGroup;
+    private getTagGroupUngrouped;
+    private addTagGroup;
+    private addTagToTagGroup;
+    private addTag;
+    private transformTag;
+    private getNearestResponseOverride;
+    private getOverrideResponses;
+    private addExtraModel;
+    private generateExtraModel;
+    private normalizeStatus;
+}

package/openapi.builder.js

@@ -0,0 +1,346 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenApiBuilder = void 0;
+const openapi_scanner_1 = require("./openapi.scanner");
+const metadata_constants_1 = require("./constants/metadata.constants");
+const common_utils_1 = require("./utils/common.utils");
+const type_utils_1 = require("./utils/type.utils");
+const swagger_1 = require("@nestjs/swagger");
+const schema_utils_1 = require("./utils/schema.utils");
+class OpenApiBuilder {
+    app;
+    config;
+    opts;
+    constructor(app, config, opts) {
+        this.app = app;
+        this.config = config;
+        this.opts = opts;
+    }
+    get scanner() {
+        const self = this;
+        self._scanner = self._scanner || new openapi_scanner_1.OpenApiScanner(this.app);
+        return self._scanner;
+    }
+    get options() {
+        return {
+            uniqueTagGroupTags: this.opts.uniqueTagGroupTags ?? true,
+            uniqueTagGroupTagNameFactory: this.opts.uniqueTagGroupTagNameFactory || ((groupName, tagName) => [groupName, tagName].map(common_utils_1.pascalCase).join('/')),
+            tagGroupUngrouped: this.opts.tagGroupUngrouped || false,
+            responseOverrides: this.opts.responseOverrides || {},
+            responseOverrideModelNameFactory: this.opts.responseOverrideModelNameFactory === false
+                ? false
+                : this.opts.responseOverrideModelNameFactory === true
+                    ? defaultResponseOverrideModelNameFactory
+                    : this.opts.responseOverrideModelNameFactory || defaultResponseOverrideModelNameFactory,
+        };
+    }
+    build() {
+        this.buildTagGroups();
+        this.buildTags();
+        this.buildResponseOverrides();
+        return this.config;
+    }
+    buildTagGroups() {
+        const { controllers, methods } = {
+            controllers: this.getControllersWithTagGroup(),
+            methods: this.getMethodsWithTagGroup(),
+        };
+        const tagGroups = [];
+        controllers.map(item => this.addTagGroup(item.tagGroup, tagGroups).controllers.push(item));
+        methods.map(item => this.addTagGroup(item.tagGroup, tagGroups).methods.push(item));
+        tagGroups.map(tagGroup => tagGroup.controllers.map(item => {
+            const tags = item.tags.map(tag => this.addTagToTagGroup(tagGroup, tag));
+            metadata_constants_1.DECORATORS.OPENAPI.TAGS.set(tags, item.controller.type);
+            metadata_constants_1.DECORATORS.SWAGGER.TAGS.set(tags.map(tag => tag.name), item.controller.type);
+        }));
+        tagGroups.map(tagGroup => tagGroup.methods.map(item => {
+            const tags = item.tags.map(tag => this.addTagToTagGroup(tagGroup, tag));
+            metadata_constants_1.DECORATORS.OPENAPI.TAGS.set(tags, item.method.descriptor.value);
+            metadata_constants_1.DECORATORS.SWAGGER.TAGS.set(tags.map(tag => tag.name), item.method.descriptor.value);
+        }));
+        this.config['x-tagGroups'] = (0, common_utils_1.uniqueMergeBy)('name', [
+            (this.config['x-tagGroups'] || []),
+            tagGroups.map(group => ({
+                name: group.name,
+                description: group.description,
+                tags: group.tags.map(tag => tag.name)
+            }))
+        ].flat());
+    }
+    buildTags() {
+        const { controllers, methods } = {
+            controllers: this.getControllers(),
+            methods: this.getControllers(),
+        };
+        const tags = [];
+        controllers.map(controller => controller.tags.map(tag => this.addTag(tag, tags)));
+        methods.map(method => method.tags.map(tag => this.addTag(tag, tags)));
+        this.config.tags = (0, common_utils_1.uniqueMergeBy)('name', [
+            (this.config['tags'] || []),
+            tags.map(tag => ({
+                name: tag.name,
+                'x-displayName': tag.displayName,
+                description: tag.description,
+                'x-traitTag': tag.trait,
+            }))
+        ].flat());
+    }
+    buildResponseOverrides() {
+        const extraModels = [];
+        const responses = this.getResponses().map((response) => {
+            const status = response.status.toString();
+            const override = response.override;
+            const target = response.method?.descriptor.value || response.controller.type;
+            const options = response.options;
+            if (!override.subKey) {
+                return [target, status, {
+                        schema: {
+                            $ref: this.addExtraModel(override.type, extraModels, target)
+                        }
+                    }];
+            }
+            const overrideModel = this.generateExtraModel(options, override.subKey, override.type, extraModels, target);
+            if (options.type) {
+                const responseModel = this.addExtraModel(options.type, extraModels, target);
+                return [target, status, {
+                        schema: {
+                            allOf: [
+                                { $ref: overrideModel },
+                                {
+                                    type: 'object',
+                                    properties: options.isArray
+                                        ? { [override.subKey]: { type: 'array', items: { $ref: responseModel } } }
+                                        : { [override.subKey]: { $ref: responseModel } }
+                                },
+                            ],
+                        }
+                    }];
+            }
+            return [target, status, options];
+        });
+        responses.map(([target, status, options]) => metadata_constants_1.DECORATORS.SWAGGER.RESPONSES.set(status, options, target));
+    }
+    getControllers() {
+        return this.scanner.getControllers()
+            .map(controller => ({
+            controller: controller,
+            tagGroup: this.getNearestTagGroup(controller),
+            tags: (0, common_utils_1.uniqueMergeBy)('name', [
+                (metadata_constants_1.DECORATORS.OPENAPI.TAGS.get(controller.type) || []),
+                (metadata_constants_1.DECORATORS.SWAGGER.TAGS.get(controller.type) || []).map(_ => ({ name: _ })),
+            ].flat()),
+        }))
+            .map(controller => {
+            controller.tagGroup = controller.tagGroup ?? this.getTagGroupUngrouped();
+            return controller;
+        });
+    }
+    getControllersWithTagGroup() {
+        return this.getControllers().filter((item) => !!item.tagGroup);
+    }
+    getMethods() {
+        return this.scanner.getControllers()
+            .map(controller => controller.methods.map(method => ({
+            controller: controller,
+            method: method,
+            tagGroup: this.getNearestTagGroup(controller, method),
+            tags: (0, common_utils_1.uniqueMergeBy)('name', [
+                (metadata_constants_1.DECORATORS.OPENAPI.TAGS.get(method.descriptor.value) || []),
+                (metadata_constants_1.DECORATORS.SWAGGER.TAGS.get(method.descriptor.value) || []).map(_ => ({ name: _ }))
+            ].flat()),
+        }))).flat()
+            .map(method => {
+            method.tagGroup = method.tagGroup ?? this.getTagGroupUngrouped();
+            return method;
+        });
+    }
+    getMethodsWithTagGroup() {
+        return this.getMethods().filter((item) => !!item.tagGroup);
+    }
+    getResponses() {
+        const responses = [];
+        this.getControllers().map(item => {
+            const data = metadata_constants_1.DECORATORS.SWAGGER.RESPONSES.getAll(item.controller.type);
+            if ((0, type_utils_1.isPlainObject)(data)) {
+                Object.entries(data).map(([status, options]) => {
+                    const override = this.getNearestResponseOverride(status);
+                    if (override) {
+                        responses.push({
+                            status: this.normalizeStatus(status),
+                            controller: item.controller,
+                            options: options,
+                            override: override,
+                        });
+                    }
+                });
+            }
+        });
+        this.getMethods().map(item => {
+            const data = metadata_constants_1.DECORATORS.SWAGGER.RESPONSES.getAll(item.method.descriptor.value);
+            if ((0, type_utils_1.isPlainObject)(data)) {
+                Object.entries(data).map(([status, options]) => {
+                    const override = this.getNearestResponseOverride(status);
+                    if (override) {
+                        responses.push({
+                            status: this.normalizeStatus(status),
+                            controller: item.controller,
+                            method: item.method,
+                            options: options,
+                            override: override,
+                        });
+                    }
+                });
+            }
+        });
+        return responses;
+    }
+    getNearestTagGroup(controller, method) {
+        return ((method && metadata_constants_1.DECORATORS.OPENAPI.TAG_GROUPS.get(method.descriptor.value)) ||
+            metadata_constants_1.DECORATORS.OPENAPI.TAG_GROUPS.get(controller.type) ||
+            controller.parents.map(p => metadata_constants_1.DECORATORS.OPENAPI.TAG_GROUPS.get(p.type)).find(Boolean) ||
+            null);
+    }
+    getTagGroupUngrouped() {
+        if (this.options.tagGroupUngrouped) {
+            const tagGroup = this.options.tagGroupUngrouped;
+            return tagGroup === true ? { name: 'Ungrouped' } : typeof tagGroup === 'string' ? { name: tagGroup } : tagGroup;
+        }
+        return null;
+    }
+    addTagGroup(group, groups) {
+        const key = group.name.trim().toLowerCase();
+        const existing = groups.find(g => (0, common_utils_1.createSlug)(g.name) === (0, common_utils_1.createSlug)(key)) ?? (groups[groups.push({
+            name: group.name,
+            tags: [],
+            controllers: [],
+            methods: [],
+        }) - 1]);
+        existing.description ||= group.description;
+        return existing;
+    }
+    addTagToTagGroup(group, value) {
+        const tag = this.transformTag(group, value);
+        const existing = group.tags.find(t => (0, common_utils_1.createSlug)(t.name) === (0, common_utils_1.createSlug)(tag.name)) ?? (group.tags[group.tags.push({
+            name: tag.name,
+        }) - 1]);
+        existing.displayName ||= tag.displayName;
+        existing.description ||= tag.description;
+        existing.trait ??= tag.trait;
+        return existing;
+    }
+    addTag(tag, tags) {
+        const existing = tags.find(g => (0, common_utils_1.createSlug)(g.name) === (0, common_utils_1.createSlug)(tag.name)) ?? (tags[tags.push({
+            name: tag.name,
+        }) - 1]);
+        existing.displayName ||= tag.displayName;
+        existing.description ||= tag.description;
+        existing.trait ??= tag.trait;
+        return existing;
+    }
+    transformTag(group, value) {
+        const tag = typeof value === 'string' ? { name: value } : { ...value };
+        const newName = this.options.uniqueTagGroupTagNameFactory(group.name, tag.name);
+        if (this.options.uniqueTagGroupTags && tag.name !== newName) {
+            tag.displayName ??= tag.name;
+            tag.name = newName;
+        }
+        return tag;
+    }
+    getNearestResponseOverride(status) {
+        const overrides = this.getOverrideResponses();
+        const normalizedStatus = this.normalizeStatus(status);
+        const namedFromClass = (cls, combineError = false) => {
+            switch (cls) {
+                case 1: return 'info';
+                case 2: return 'success';
+                case 3: return 'redirect';
+                case 4: return combineError ? 'error' : 'clientError';
+                case 5: return combineError ? 'error' : 'serverError';
+                default: return undefined;
+            }
+        };
+        if (overrides.has(normalizedStatus)) {
+            return overrides.get(normalizedStatus);
+        }
+        if (typeof normalizedStatus === 'number' && Number.isFinite(normalizedStatus)) {
+            const cls = Math.floor(normalizedStatus / 100);
+            const group = `${cls}XX`;
+            if (overrides.has(group)) {
+                return overrides.get(group);
+            }
+            const named = namedFromClass(cls);
+            const namedCombined = namedFromClass(cls, true);
+            return (named && overrides.has(named)) ? overrides.get(named) : (namedCombined && overrides.has(namedCombined)) ? overrides.get(namedCombined) : overrides.get('default') || null;
+        }
+        if (typeof status === 'string' && /^[1-5]XX$/.test(status)) {
+            const cls = Number(status[0]);
+            const named = namedFromClass(cls);
+            const namedCombined = namedFromClass(cls, true);
+            return (named && overrides.has(named)) ? overrides.get(named) : (namedCombined && overrides.has(namedCombined)) ? overrides.get(namedCombined) : overrides.get('default') || null;
+        }
+        return overrides.get('default') || null;
+    }
+    getOverrideResponses() {
+        return new Map(Object.entries(this.options.responseOverrides)
+            .map(([status, data]) => {
+            if ((0, type_utils_1.isPlainObject)(data)) {
+                return {
+                    status: this.normalizeStatus(status),
+                    ...data,
+                };
+            }
+            else if (Array.isArray(data)) {
+                return {
+                    status: this.normalizeStatus(status),
+                    type: data[0],
+                    subKey: data[1],
+                };
+            }
+            else if ((0, type_utils_1.isClassRef)(data)) {
+                return {
+                    status: this.normalizeStatus(status),
+                    type: data,
+                };
+            }
+            return null;
+        })
+            .filter(i => !!i)
+            .map(i => ([i.status, i])));
+    }
+    addExtraModel(model, models, target) {
+        if (!models.includes(model)) {
+            metadata_constants_1.DECORATORS.SWAGGER.EXTRA_MODELS.add(model, target);
+            models.push(model);
+        }
+        return (0, swagger_1.getSchemaPath)(model);
+    }
+    generateExtraModel(options, key, model, models, target) {
+        const type = (0, schema_utils_1.generateSchemaType)(options);
+        const factory = this.options.responseOverrideModelNameFactory;
+        if (type && factory) {
+            const modelName = factory(model.name, type);
+            model = {
+                [modelName]: class extends (0, swagger_1.OmitType)(model, [key]) {
+                },
+            }[modelName];
+            metadata_constants_1.DECORATORS.SWAGGER.MODEL_PROPERTIES.set({ type }, model.prototype, key);
+            metadata_constants_1.DECORATORS.SWAGGER.MODEL_PROPERTIES_ARRAY.add(`:${key}`, model.prototype);
+        }
+        return this.addExtraModel(model, models, target);
+    }
+    normalizeStatus(status) {
+        const code = typeof status === 'number' ? status.toString() : status;
+        if (code.match(/^[1-5]XX$/)) {
+            return code;
+        }
+        if (code.match(/^[1-5][0-9][0-9]$/)) {
+            return parseInt(code);
+        }
+        return code;
+    }
+}
+exports.OpenApiBuilder = OpenApiBuilder;
+function defaultResponseOverrideModelNameFactory(overrideName, typeName) {
+    return [overrideName, 'of', typeName].map(common_utils_1.pascalCase).join('');
+}
+//# sourceMappingURL=openapi.builder.js.map

package/openapi.builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.builder.js","sourceRoot":"","sources":["../../lib/openapi.builder.ts"],"names":[],"mappings":"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"}

package/openapi.module.d.ts

@@ -0,0 +1,8 @@
+import { IOpenApiDocumentBuilder, OpenApiDocumentBuilder } from "./utils/document-builder.utils";
+import { INestApplication } from "@nestjs/common";
+import { OpenAPIObject } from "@nestjs/swagger";
+import { IOpenApiDocumentOptions, OpenApiDocument } from "./interfaces/document.interface";
+export declare class OpenApiModule {
+    static createDocumentBuilder(options?: IOpenApiDocumentBuilder): OpenApiDocumentBuilder;
+    static createDocument(app: INestApplication, config: Omit<OpenApiDocument, 'paths'>, options?: IOpenApiDocumentOptions): OpenAPIObject;
+}

package/openapi.module.js

@@ -0,0 +1,29 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenApiModule = void 0;
+const document_builder_utils_1 = require("./utils/document-builder.utils");
+const common_1 = require("@nestjs/common");
+const swagger_1 = require("@nestjs/swagger");
+const openapi_builder_1 = require("./openapi.builder");
+let OpenApiModule = class OpenApiModule {
+    static createDocumentBuilder(options) {
+        return new document_builder_utils_1.OpenApiDocumentBuilder(options);
+    }
+    static createDocument(app, config, options) {
+        const builder = new openapi_builder_1.OpenApiBuilder(app, config, options || {});
+        return swagger_1.SwaggerModule.createDocument(app, builder.build(), Object.assign(options || {}, {
+            autoTagControllers: options?.autoTagControllers ?? false,
+        }));
+    }
+};
+exports.OpenApiModule = OpenApiModule;
+exports.OpenApiModule = OpenApiModule = __decorate([
+    (0, common_1.Module)({})
+], OpenApiModule);
+//# sourceMappingURL=openapi.module.js.map

package/openapi.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.module.js","sourceRoot":"","sources":["../../lib/openapi.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2EAA+F;AAC/F,2CAAwD;AACxD,6CAA6D;AAE7D,uDAAiD;AAI1C,IAAM,aAAa,GAAnB,MAAM,aAAa;IAQxB,MAAM,CAAC,qBAAqB,CAAC,OAAiC;QAC5D,OAAO,IAAI,+CAAsB,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;IAUD,MAAM,CAAC,cAAc,CAAC,GAAqB,EAAE,MAAsC,EAAE,OAAiC;QACpH,MAAM,OAAO,GAAG,IAAI,gCAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;QAC/D,OAAO,uBAAa,CAAC,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,EAAE;YACrF,kBAAkB,EAAE,OAAO,EAAE,kBAAkB,IAAI,KAAK;SACzD,CAAC,CAAC,CAAC;IACN,CAAC;CAEF,CAAA;AA3BY,sCAAa;wBAAb,aAAa;IADzB,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,aAAa,CA2BzB"}

package/openapi.scanner.d.ts

@@ -0,0 +1,30 @@
+import { INestApplication, Type } from "@nestjs/common";
+import { Module } from "@nestjs/core/injector/module";
+import { Controller } from "@nestjs/common/interfaces";
+import { InstanceWrapper } from "@nestjs/core/injector/instance-wrapper";
+import { ClassEntryMethod, ClassEntryProperty } from "./utils/class.utils";
+export interface IOpenApiScannedModule {
+    id: string;
+    name: string;
+    parents: IOpenApiScannedModule[];
+    item: Module;
+    type: Type<Module>;
+}
+export interface IOpenApiScannedController {
+    id: string;
+    name: string;
+    parents: IOpenApiScannedModule[];
+    item: InstanceWrapper<Controller>;
+    type: Type<Controller>;
+    properties: ClassEntryProperty[];
+    methods: ClassEntryMethod[];
+}
+export declare class OpenApiScanner {
+    private readonly app;
+    constructor(app: INestApplication);
+    private get container();
+    getModules(recursive?: boolean): IOpenApiScannedModule[];
+    private resolveModules;
+    getControllers(recursive?: boolean): IOpenApiScannedController[];
+    private resolveControllers;
+}

package/openapi.scanner.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenApiScanner = void 0;
+const type_utils_1 = require("./utils/type.utils");
+const class_utils_1 = require("./utils/class.utils");
+class OpenApiScanner {
+    app;
+    constructor(app) {
+        this.app = app;
+    }
+    get container() {
+        return this.app.container;
+    }
+    getModules(recursive = true) {
+        return this.resolveModules(this.container.getModules(), recursive);
+    }
+    resolveModules(container, recursive = false, parent, scannedModules) {
+        const modules = scannedModules || new Map();
+        container.forEach((module) => {
+            if (!modules.has(module.id)) {
+                const item = {
+                    id: module.id,
+                    name: module.metatype.name,
+                    parents: (parent ? [parent.parents, parent] : []).flat(),
+                    item: module,
+                    type: module.metatype,
+                };
+                modules.set(item.id, item);
+                if (recursive) {
+                    this.resolveModules(module.imports, recursive, item, modules);
+                }
+            }
+        });
+        return Array.from(modules.values());
+    }
+    getControllers(recursive = true) {
+        const modules = this.getModules(recursive);
+        return this.resolveControllers(modules);
+    }
+    resolveControllers(modules, scannedControllers) {
+        const controllers = scannedControllers || new Map();
+        modules.map(module => {
+            Array.from(module.item.controllers.values()).map(controller => {
+                if (!controllers.has(controller.id) && (0, type_utils_1.isClassRef)(controller.metatype)) {
+                    controllers.set(controller.id, {
+                        id: controller.id,
+                        name: controller.metatype.name,
+                        parents: [module.parents, module].flat(),
+                        item: controller,
+                        type: controller.metatype,
+                        properties: (0, class_utils_1.getAllClassEntries)(controller.instance).filter(item => item.kind === 'property'),
+                        methods: (0, class_utils_1.getAllClassEntries)(controller.instance).filter(item => item.kind === 'method'),
+                    });
+                }
+            });
+        });
+        return Array.from(controllers.values());
+    }
+}
+exports.OpenApiScanner = OpenApiScanner;
+//# sourceMappingURL=openapi.scanner.js.map

package/openapi.scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.scanner.js","sourceRoot":"","sources":["../../lib/openapi.scanner.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@ethalium/nestjs-openapi",
+  "version": "0.0.1",
+  "description": "Wrapper around @nestjs/swagger to generate OpenAPI spec from decorators.",
+  "author": {
+    "name": "Ethalium",
+    "url": "https://github.com/ethalium"
+  },
+  "private": false,
+  "license": "MIT",
+  "scripts": {
+    "lib:index": "barrelsby --config barrelsby.config.json",
+    "lib:build": "npm run lib:index && nest build lib",
+    "lib:format": "prettier --write \"lib/**/*.ts\" \"test/**/*.ts\"",
+    "lib:lint": "eslint \"{src,apps,libs,test}/**/*.ts\" --fix",
+    "lib:test": "jest --watchAll",
+    "lib:publish": "npm run lib:build && cd dist/lib && npm publish --access public",
+    "lib:pack": "npm run lib:build && cd dist/lib && npm pack",
+    "example:start": "npm run lib:index && nest start example-app --watch"
+  },
+  "peerDependencies": {
+    "@nestjs/common": ">=11.0.0",
+    "@nestjs/core": ">=11.0.0",
+    "@nestjs/swagger": ">=11.0.0",
+    "lodash": ">=4.17.23",
+    "reflect-metadata": ">=0.2.2",
+    "rxjs": ">=7.8.1"
+  },
+  "devDependencies": {
+    "@eslint/eslintrc": "^3.2.0",
+    "@eslint/js": "^9.18.0",
+    "@nestjs/cli": ">=11.0.0",
+    "@nestjs/platform-express": ">=11.0.0",
+    "@nestjs/schematics": ">=11.0.0",
+    "@nestjs/testing": ">=11.0.0",
+    "@scalar/nestjs-api-reference": "^1.0.27",
+    "@types/express": "^5.0.0",
+    "@types/jest": "^30.0.0",
+    "@types/lodash": "^4.17.23",
+    "@types/node": "^22.10.7",
+    "@types/supertest": "^6.0.2",
+    "barrelsby": "^2.8.1",
+    "eslint": "^9.18.0",
+    "eslint-config-prettier": "^10.0.1",
+    "eslint-plugin-prettier": "^5.2.2",
+    "globals": "^16.0.0",
+    "jest": "^30.0.0",
+    "prettier": "^3.4.2",
+    "source-map-support": "^0.5.21",
+    "supertest": "^7.0.0",
+    "ts-jest": "^29.2.5",
+    "ts-loader": "^9.5.2",
+    "ts-node": "^10.9.2",
+    "tsconfig-paths": "^4.2.0",
+    "typescript": "^5.7.3",
+    "typescript-eslint": "^8.20.0"
+  },
+  "jest": {
+    "moduleFileExtensions": [
+      "js",
+      "json",
+      "ts"
+    ],
+    "rootDir": "test",
+    "testRegex": ".*\\.spec\\.ts$",
+    "transform": {
+      "^.+\\.(t|j)s$": "ts-jest"
+    },
+    "collectCoverageFrom": [
+      "**/*.(t|j)s"
+    ],
+    "coverageDirectory": "../coverage",
+    "testEnvironment": "node"
+  }
+}