@ethalium/nestjs-openapi 0.0.1

package/utils/class.utils.d.ts

@@ -0,0 +1,13 @@
+export type ClassEntry = ClassEntryMethod | ClassEntryProperty;
+export interface ClassEntryMethod {
+    kind: 'method';
+    target: any;
+    descriptor: PropertyDescriptor;
+    propertyKey: string | symbol;
+}
+export interface ClassEntryProperty {
+    kind: 'property' | 'prototype-property';
+    target: any;
+    propertyKey: string | symbol;
+}
+export declare function getAllClassEntries(instance: any): ClassEntry[];

package/utils/class.utils.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAllClassEntries = getAllClassEntries;
+function getAllClassEntries(instance) {
+    if (!instance) {
+        return [];
+    }
+    const ctor = instance.constructor;
+    const rootProto = ctor?.prototype;
+    if (!ctor || !rootProto) {
+        return [];
+    }
+    const entries = [];
+    const mostDerivedProtoKeys = new Set([
+        ...Object.getOwnPropertyNames(rootProto),
+        ...Object.getOwnPropertySymbols(rootProto),
+    ]);
+    for (const propertyKey of [Object.getOwnPropertyNames(instance), Object.getOwnPropertySymbols(instance)].flat(9)) {
+        entries.push({
+            kind: 'property',
+            target: rootProto,
+            propertyKey: propertyKey,
+        });
+    }
+    let proto = rootProto;
+    while (proto && proto !== Object.prototype) {
+        for (const propertyKey of [Object.getOwnPropertyNames(proto), Object.getOwnPropertySymbols(proto)].flat()) {
+            if (propertyKey === 'constructor' || propertyKey === 'prototype') {
+                continue;
+            }
+            const descriptor = Object.getOwnPropertyDescriptor(proto, propertyKey);
+            if (!descriptor) {
+                continue;
+            }
+            if (typeof descriptor.value === 'function') {
+                entries.push({
+                    kind: 'method',
+                    target: proto,
+                    propertyKey: propertyKey,
+                    descriptor: descriptor,
+                });
+            }
+            else {
+                entries.push({
+                    kind: 'property',
+                    target: proto,
+                    propertyKey: propertyKey,
+                });
+            }
+        }
+        proto = Object.getPrototypeOf(proto);
+    }
+    return entries;
+}
+//# sourceMappingURL=class.utils.js.map

package/utils/class.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"class.utils.js","sourceRoot":"","sources":["../../../lib/utils/class.utils.ts"],"names":[],"mappings":";;AAuBA,gDAwEC;AAxED,SAAgB,kBAAkB,CAAC,QAAa;IAE9C,IAAG,CAAC,QAAQ,EAAC,CAAC;QACZ,OAAO,EAAE,CAAC;IACZ,CAAC;IAGD,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,CAAC;IAClC,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,CAAC;IAGlC,IAAG,CAAC,IAAI,IAAI,CAAC,SAAS,EAAC,CAAC;QACtB,OAAO,EAAE,CAAC;IACZ,CAAC;IAGD,MAAM,OAAO,GAAiB,EAAE,CAAC;IAGjC,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAkB;QACpD,GAAG,MAAM,CAAC,mBAAmB,CAAC,SAAS,CAAC;QACxC,GAAG,MAAM,CAAC,qBAAqB,CAAC,SAAS,CAAC;KAC3C,CAAC,CAAC;IAGH,KAAK,MAAM,WAAW,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACjH,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,SAAS;YACjB,WAAW,EAAE,WAAW;SACzB,CAAC,CAAC;IACL,CAAC;IAGD,IAAI,KAAK,GAAQ,SAAS,CAAC;IAC3B,OAAO,KAAK,IAAI,KAAK,KAAK,MAAM,CAAC,SAAS,EAAE,CAAC;QAC3C,KAAK,MAAM,WAAW,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YAE1G,IAAG,WAAW,KAAK,aAAa,IAAI,WAAW,KAAK,WAAW,EAAC,CAAC;gBAC/D,SAAS;YACX,CAAC;YAGD,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;YAGvE,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,SAAS;YACX,CAAC;YAGD,IAAG,OAAO,UAAU,CAAC,KAAK,KAAK,UAAU,EAAC,CAAC;gBACzC,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,QAAQ;oBACd,MAAM,EAAE,KAAK;oBACb,WAAW,EAAE,WAAW;oBACxB,UAAU,EAAE,UAAU;iBACvB,CAAC,CAAC;YACL,CAAC;iBAAI,CAAC;gBACJ,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,UAAU;oBAChB,MAAM,EAAE,KAAK;oBACb,WAAW,EAAE,WAAW;iBACzB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IAGD,OAAO,OAAO,CAAC;AAEjB,CAAC"}

package/utils/common.utils.d.ts

@@ -0,0 +1,3 @@
+export declare function pascalCase(input: string): string;
+export declare function createSlug(value: string): string;
+export declare function uniqueMergeBy<T extends Record<string, any>, K extends keyof T = keyof T>(key: K, items: T[]): T[];

package/utils/common.utils.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pascalCase = pascalCase;
+exports.createSlug = createSlug;
+exports.uniqueMergeBy = uniqueMergeBy;
+function pascalCase(input) {
+    if (!input)
+        return '';
+    return input
+        .replace(/[\s_-]+/g, ' ')
+        .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+        .split(' ')
+        .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+        .join('');
+}
+function createSlug(value) {
+    return value
+        .normalize('NFD')
+        .replace(/[\u0300-\u036f]/g, '')
+        .replace(/ä/g, 'ae')
+        .replace(/ö/g, 'oe')
+        .replace(/ü/g, 'ue')
+        .replace(/ß/g, 'ss')
+        .replace(/[^a-zA-Z0-9\s-]/g, '')
+        .trim()
+        .replace(/\s+/g, '-')
+        .replace(/-+/g, '-')
+        .toLowerCase();
+}
+function uniqueMergeBy(key, items) {
+    const dedupe = (a) => [...new Set(a)];
+    return Array.from(items.flat().reduce((map, item) => {
+        const id = item[key];
+        const data = map.get(id);
+        if (!data) {
+            const copy = { ...item };
+            Object.keys(copy).forEach(p => Array.isArray(copy[p]) && (copy[p] = dedupe(copy[p])));
+            return map.set(id, copy);
+        }
+        Object.keys(item).forEach(p => {
+            const incoming = item[p];
+            data[p] = Array.isArray(incoming) ? dedupe([...(Array.isArray(data[p]) ? data[p] : []), ...incoming]) : (data[p] ?? incoming);
+        });
+        return map;
+    }, new Map())
+        .values());
+}
+//# sourceMappingURL=common.utils.js.map

package/utils/common.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.utils.js","sourceRoot":"","sources":["../../../lib/utils/common.utils.ts"],"names":[],"mappings":";;AAAA,gCAUC;AAED,gCAaC;AAED,sCAiBC;AA5CD,SAAgB,UAAU,CAAC,KAAa;IACtC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,OAAO,KAAK;SACT,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC;SACxB,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACtC,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,IAAI,CAAC,EAAE,CACV,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAC3D;SACA,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAED,SAAgB,UAAU,CAAC,KAAa;IACtC,OAAO,KAAK;SACT,SAAS,CAAC,KAAK,CAAC;SAChB,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;SAC/B,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC;SACnB,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC;SACnB,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC;SACnB,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC;SACnB,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;SAC/B,IAAI,EAAE;SACN,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,WAAW,EAAE,CAAC;AACnB,CAAC;AAED,SAAgB,aAAa,CAA6D,GAAM,EAAE,KAAU;IAC1G,MAAM,MAAM,GAAG,CAAC,CAAQ,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;QAChD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QACrB,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACzB,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;YACzB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACtF,OAAO,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAC3B,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;YAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACxB,IAAY,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAA,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC;QACxI,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,CAAC;IACb,CAAC,EAAE,IAAI,GAAG,EAAW,CAAC;SACrB,MAAM,EAAE,CAAC,CAAA;AACd,CAAC"}

package/utils/decorator.utils.d.ts

@@ -0,0 +1,37 @@
+import 'reflect-metadata';
+export type AnyDecorator = ClassDecorator | MethodDecorator | PropertyDecorator | ParameterDecorator;
+export type DecoratorKind = 'class' | 'method' | 'property' | 'parameter';
+export type DecoratorFactory<TInput = void, TDecorator = AnyDecorator> = (input: TInput) => TDecorator;
+export interface DecoratorContext<TInput = void> {
+    kind: DecoratorKind;
+    target: any;
+    decorateArgs: [targetOrDescriptorValue?: any, propertyKey?: string | symbol];
+    propertyKey?: string | symbol;
+    propertyDescriptor?: PropertyDescriptor;
+    parameterIndex?: number;
+    data: TInput;
+}
+export interface DecoratorOptions<TInput = void, TTransformed = TInput> {
+    transform?: (ctx: DecoratorContext<TInput>) => TTransformed;
+    decorators?: (ctx: DecoratorContext<TTransformed>, store: AnyDecorator[]) => AnyDecorator[] | any;
+    metadata?: (ctx: DecoratorContext<TTransformed>) => Array<{
+        key: string;
+        value: any;
+    }> | undefined;
+    onApply?: (ctx: DecoratorContext<TTransformed>) => void;
+}
+export interface ListDecoratorOptions<TInput, TTransformed = TInput> {
+    metadataKey: string;
+    transform?: (ctx: DecoratorContext<TTransformed[]>) => TTransformed[];
+    unique?: boolean;
+    decorators?: (ctx: DecoratorContext<TTransformed[]>, store: AnyDecorator[]) => AnyDecorator[];
+    onApply?: (ctx: DecoratorContext<TTransformed[]>) => void;
+}
+export declare function detectDecoratorKind(target: any, propertyKey?: string | symbol, propertyDescriptor?: PropertyDescriptor | number): DecoratorKind;
+export declare function buildDecoratorContext<TValue = any>(args: any[], data: TValue): DecoratorContext<TValue>;
+export declare function createDecorator<TInput = void, TTransformed = TInput>(opts: DecoratorOptions<TInput, TTransformed>): DecoratorFactory<TInput>;
+export declare function createClassDecorator<TInput = void, TTransformed = TInput>(opts: DecoratorOptions<TInput, TTransformed>): DecoratorFactory<TInput, ClassDecorator>;
+export declare function createMethodDecorator<TInput = void, TTransformed = TInput>(opts: DecoratorOptions<TInput, TTransformed>): DecoratorFactory<TInput, MethodDecorator>;
+export declare function createPropertyDecorator<TInput = void, TTransformed = TInput>(opts: DecoratorOptions<TInput, TTransformed>): DecoratorFactory<TInput, PropertyDecorator>;
+export declare function createParamDecorator<TInput = void, TTransformed = TInput>(opts: DecoratorOptions<TInput, TTransformed>): DecoratorFactory<TInput, ParameterDecorator>;
+export declare function createListDecorator<TInput, TTransformed = TInput>(opts: ListDecoratorOptions<TInput, TTransformed>): (input: TInput[]) => AnyDecorator;

package/utils/decorator.utils.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectDecoratorKind = detectDecoratorKind;
+exports.buildDecoratorContext = buildDecoratorContext;
+exports.createDecorator = createDecorator;
+exports.createClassDecorator = createClassDecorator;
+exports.createMethodDecorator = createMethodDecorator;
+exports.createPropertyDecorator = createPropertyDecorator;
+exports.createParamDecorator = createParamDecorator;
+exports.createListDecorator = createListDecorator;
+require("reflect-metadata");
+const metadata_utils_1 = require("./metadata.utils");
+function detectDecoratorKind(target, propertyKey, propertyDescriptor) {
+    if (target && propertyKey && propertyDescriptor) {
+        return 'class';
+    }
+    if (typeof propertyDescriptor === 'number') {
+        return 'parameter';
+    }
+    if (propertyDescriptor && typeof propertyDescriptor === 'object') {
+        return 'method';
+    }
+    return 'property';
+}
+function buildDecoratorContext(args, data) {
+    const [target, propertyKey, descriptor] = args;
+    const kind = detectDecoratorKind(args);
+    return {
+        kind: kind,
+        target: target,
+        decorateArgs: (0, metadata_utils_1.getMetadataDecorateArgs)(target, propertyKey, descriptor),
+        propertyKey: propertyKey,
+        propertyDescriptor: kind === 'method' ? descriptor : undefined,
+        parameterIndex: kind === 'parameter' ? descriptor : undefined,
+        data: data,
+    };
+}
+function createDecorator(opts) {
+    return (input) => {
+        return (...args) => {
+            const ctx = buildDecoratorContext(args, input);
+            ctx.data = opts.transform ? opts.transform(ctx) : input;
+            const decoratorStore = [];
+            const decoratorFuncResult = opts.decorators?.(ctx, decoratorStore) ?? null;
+            const decorators = Array.isArray(decoratorFuncResult) ? decoratorFuncResult : decoratorStore;
+            opts.metadata?.(ctx)?.map(meta => (0, metadata_utils_1.setMetadata)(meta.key, meta.value, ctx.target, ctx.propertyKey));
+            opts.onApply?.(ctx);
+            decorators.map(d => d(...args));
+            return args[2];
+        };
+    };
+}
+function createClassDecorator(opts) {
+    return createDecorator(opts);
+}
+function createMethodDecorator(opts) {
+    return createDecorator(opts);
+}
+function createPropertyDecorator(opts) {
+    return createDecorator(opts);
+}
+function createParamDecorator(opts) {
+    return createDecorator(opts);
+}
+function createListDecorator(opts) {
+    return (input) => {
+        return (...args) => {
+            const ctx = buildDecoratorContext(args, input);
+            ctx.data = opts.transform ? opts.transform(ctx) : input;
+            const decoratorStore = [];
+            const decoratorFuncResult = opts.decorators?.(ctx, decoratorStore) ?? null;
+            const decorators = Array.isArray(decoratorFuncResult) ? decoratorFuncResult : decoratorStore;
+            if (opts.unique) {
+                (0, metadata_utils_1.addMetadataUniqueItems)(opts.metadataKey, ctx.data, ...ctx.decorateArgs);
+            }
+            else {
+                (0, metadata_utils_1.addMetadataItems)(opts.metadataKey, ctx.data, ...ctx.decorateArgs);
+            }
+            opts.onApply?.(ctx);
+            decorators.map(d => d(...args));
+            return args[2];
+        };
+    };
+}
+//# sourceMappingURL=decorator.utils.js.map

package/utils/decorator.utils.js.map

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

package/utils/document-builder.utils.d.ts

@@ -0,0 +1,70 @@
+import { DocumentBuilder } from "@nestjs/swagger";
+import { ExtensionLocation, ParameterObject, SecuritySchemeObject, ServerVariableObject } from "@nestjs/swagger/dist/interfaces/open-api-spec.interface";
+import { ApiResponseOptions } from "@nestjs/swagger/dist/decorators/api-response.decorator";
+import { OpenApiDocument } from "../interfaces/document.interface";
+export interface IOpenApiDocumentBuilder {
+    openApiVersion?: string;
+    title?: string;
+    description?: string;
+    version?: string;
+    termsOfService?: string;
+    basePath?: string;
+    contact?: IOpenApiDocumentBuilderContact;
+    license?: IOpenApiDocumentBuilderLicense;
+    servers?: IOpenApiDocumentBuilderServer[];
+    externalDoc?: IOpenApiDocumentBuilderExternalDoc;
+    extensions?: IOpenApiDocumentBuilderExtension[];
+    securities?: IOpenApiDocumentBuilderSecurity[];
+    globalResponses?: ApiResponseOptions[];
+    globalParameters?: Array<Omit<ParameterObject, 'example' | 'examples'>>;
+    auth?: IOpenApiDocumentBuilderAuth;
+}
+export interface IOpenApiDocumentBuilderContact {
+    name: string;
+    url: string;
+    email: string;
+}
+export interface IOpenApiDocumentBuilderLicense {
+    name: string;
+    url: string;
+}
+export interface IOpenApiDocumentBuilderServer {
+    url: string;
+    description?: string;
+    variables?: Record<string, ServerVariableObject>;
+    serverExtraProperties?: Record<string, any>;
+}
+export interface IOpenApiDocumentBuilderExternalDoc {
+    url: string;
+    description: string;
+}
+export interface IOpenApiDocumentBuilderExtension<T = any> {
+    key: string;
+    properties: T;
+    location?: ExtensionLocation;
+}
+export interface IOpenApiDocumentBuilderSecurity {
+    name: string;
+    options: SecuritySchemeObject;
+    requirements?: string[];
+}
+export interface IOpenApiDocumentBuilderAuth {
+    basic?: true | IOpenApiDocumentBuilderAuthSimple | IOpenApiDocumentBuilderAuthSimple[];
+    bearer?: true | IOpenApiDocumentBuilderAuthSimple | IOpenApiDocumentBuilderAuthSimple[];
+    oauth2?: true | IOpenApiDocumentBuilderAuthSimple | IOpenApiDocumentBuilderAuthSimple[];
+    apiKey?: true | IOpenApiDocumentBuilderAuthSimple | IOpenApiDocumentBuilderAuthSimple[];
+    cookie?: true | IOpenApiDocumentBuilderAuthCookie | IOpenApiDocumentBuilderAuthCookie[];
+}
+export interface IOpenApiDocumentBuilderAuthSimple {
+    name?: string;
+    options?: SecuritySchemeObject;
+}
+export interface IOpenApiDocumentBuilderAuthCookie {
+    cookieName?: string;
+    options?: SecuritySchemeObject;
+    securityName?: string;
+}
+export declare class OpenApiDocumentBuilder extends DocumentBuilder {
+    constructor(options?: IOpenApiDocumentBuilder);
+    protected get documentObject(): Omit<OpenApiDocument, 'paths'>;
+}

package/utils/document-builder.utils.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenApiDocumentBuilder = void 0;
+const swagger_1 = require("@nestjs/swagger");
+class OpenApiDocumentBuilder extends swagger_1.DocumentBuilder {
+    constructor(options) {
+        super();
+        options?.openApiVersion && this.setOpenAPIVersion(options.openApiVersion);
+        options?.title && this.setTitle(options.title);
+        options?.description && this.setDescription(options.description);
+        options?.version && this.setVersion(options.version);
+        options?.termsOfService && this.setTermsOfService(options.termsOfService);
+        options?.basePath && this.setBasePath(options.basePath);
+        options?.contact && this.setContact(options.contact.name, options.contact.url, options.contact.email);
+        options?.license && this.setLicense(options.license.name, options.license.url);
+        options?.servers && options.servers.map(server => this.addServer(server.url, server.description, server.variables, server.serverExtraProperties));
+        options?.externalDoc && this.setExternalDoc(options?.externalDoc.description, options.externalDoc.url);
+        options?.extensions && options.extensions.map(extension => this.addExtension(extension.key, extension.properties, extension.location));
+        options?.securities && options.securities.map(security => {
+            this.addSecurity(security.name, security.options);
+            security.requirements && this.addSecurityRequirements(security.name, security.requirements);
+        });
+        options?.globalResponses && this.addGlobalResponse(...options.globalResponses);
+        options?.globalParameters && this.addGlobalParameters(...options.globalParameters);
+        options?.auth?.basic && (Array.isArray(options.auth.basic) ? options.auth.basic : [options.auth.basic === true ? {} : options.auth.basic]).map(auth => this.addBasicAuth(auth.options, auth.name));
+        options?.auth?.bearer && (Array.isArray(options.auth.bearer) ? options.auth.bearer : [options.auth.bearer === true ? {} : options.auth.bearer]).map(auth => this.addBearerAuth(auth.options, auth.name));
+        options?.auth?.oauth2 && (Array.isArray(options.auth.oauth2) ? options.auth.oauth2 : [options.auth.oauth2 === true ? {} : options.auth.oauth2]).map(auth => this.addOAuth2(auth.options, auth.name));
+        options?.auth?.apiKey && (Array.isArray(options.auth.apiKey) ? options.auth.apiKey : [options.auth.apiKey === true ? {} : options.auth.apiKey]).map(auth => this.addApiKey(auth.options, auth.name));
+        options?.auth?.cookie && (Array.isArray(options.auth.cookie) ? options.auth.cookie : [options.auth.cookie === true ? {} : options.auth.cookie]).map(auth => this.addCookieAuth(auth.cookieName, auth.options, auth.securityName));
+    }
+    get documentObject() {
+        return this.document;
+    }
+}
+exports.OpenApiDocumentBuilder = OpenApiDocumentBuilder;
+//# sourceMappingURL=document-builder.utils.js.map

package/utils/document-builder.utils.js.map

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

package/utils/metadata.utils.d.ts

@@ -0,0 +1,28 @@
+export declare function getMetadataTarget(target: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor | number): any;
+export declare function getMetadataDecorateArgs(target: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor | number): [target: any, propertyKey?: string | symbol];
+export declare function setMetadata<T = any>(key: string | symbol, value: T, target: any, propertyKey?: string | symbol): T;
+export declare function getMetadata<T = any>(key: string | symbol, target: any, propertyKey?: string | symbol): T | null;
+export declare function setMetadataItems<T = any>(key: string | symbol, items: T[], target: any, propertyKey?: string | symbol): T[];
+export declare function addMetadataItems<T = any>(key: string | symbol, items: T[], target: any, propertyKey?: string | symbol): T[];
+export declare function addMetadataUniqueItems<T = any>(key: string | symbol, items: T[], target: any, propertyKey?: string | symbol, uniqueKey?: string): T[];
+export declare function getMetadataItems<T = any>(key: string | symbol, target: any, propertyKey?: string | symbol): T[];
+export declare function MetadataAccessor<T = any>(metadataKey?: string | symbol): {
+    readonly key: string | symbol;
+    get(target: any, propertyKey?: string | symbol): T | null;
+    set(value: T, target: any, propertyKey?: string | symbol): T;
+};
+export declare function MetadataMapAccessor<T = any, K extends keyof T = keyof T>(metadataKey?: string | symbol): {
+    readonly key: string | symbol;
+    getAll(target: any, propertyKey?: string | symbol): T | null;
+    setAll(value: any, target: any, propertyKey?: string | symbol): T;
+    get(name: K, target: any, propertyKey?: string | symbol): T[K] | null;
+    set(name: K, value: T[K], target: any, propertyKey?: string | symbol): T[K];
+};
+export declare function MetadataListAccessor<T = any>(metadataKey?: string | symbol, uniqueKey?: keyof T): {
+    readonly key: string | symbol;
+    get(target: any, propertyKey?: string | symbol): T[];
+    set(items: T, target: any, propertyKey?: string | symbol): T;
+    set(items: T[], target: any, propertyKey?: string | symbol): T[];
+    add(items: T, target: any, propertyKey?: string | symbol): T;
+    add(items: T[], target: any, propertyKey?: string | symbol): T[];
+};

package/utils/metadata.utils.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMetadataTarget = getMetadataTarget;
+exports.getMetadataDecorateArgs = getMetadataDecorateArgs;
+exports.setMetadata = setMetadata;
+exports.getMetadata = getMetadata;
+exports.setMetadataItems = setMetadataItems;
+exports.addMetadataItems = addMetadataItems;
+exports.addMetadataUniqueItems = addMetadataUniqueItems;
+exports.getMetadataItems = getMetadataItems;
+exports.MetadataAccessor = MetadataAccessor;
+exports.MetadataMapAccessor = MetadataMapAccessor;
+exports.MetadataListAccessor = MetadataListAccessor;
+const lodash_1 = require("lodash");
+function getMetadataTarget(target, propertyKey, descriptor) {
+    target = propertyKey ? target : typeof target === 'function' ? target : target.constructor;
+    return descriptor && typeof descriptor === 'object' && 'value' in descriptor ? descriptor.value : target;
+}
+function getMetadataDecorateArgs(target, propertyKey, descriptor) {
+    if (descriptor && typeof descriptor === 'object') {
+        return [getMetadataTarget(target, propertyKey, descriptor)];
+    }
+    return propertyKey ? [getMetadataTarget(target, propertyKey), propertyKey] : [getMetadataTarget(target, propertyKey)];
+}
+function setMetadata(key, value, target, propertyKey) {
+    Reflect.defineMetadata(key, value, target, propertyKey);
+    return value;
+}
+function getMetadata(key, target, propertyKey) {
+    return Reflect.getMetadata(key, target, propertyKey) || null;
+}
+function setMetadataItems(key, items, target, propertyKey) {
+    setMetadata(key, items, target, propertyKey);
+    return items;
+}
+function addMetadataItems(key, items, target, propertyKey) {
+    const current = getMetadataItems(key, target, propertyKey);
+    return setMetadataItems(key, [...current, ...items], target, propertyKey);
+}
+function addMetadataUniqueItems(key, items, target, propertyKey, uniqueKey) {
+    const current = getMetadataItems(key, target, propertyKey);
+    if (uniqueKey) {
+        items = [...current, ...items].reverse();
+        items = (0, lodash_1.uniqBy)(items, uniqueKey);
+    }
+    return setMetadataItems(key, Array.from(new Set([...current, ...items])), target, propertyKey);
+}
+function getMetadataItems(key, target, propertyKey) {
+    const value = getMetadata(key, target, propertyKey);
+    return Array.isArray(value) ? value : [];
+}
+function MetadataAccessor(metadataKey) {
+    return new class MetadataAccessor {
+        key = metadataKey || Symbol();
+        get(target, propertyKey) {
+            return getMetadata(this.key, target, propertyKey) || null;
+        }
+        set(value, target, propertyKey) {
+            return setMetadata(this.key, value, target, propertyKey);
+        }
+    };
+}
+function MetadataMapAccessor(metadataKey) {
+    return new class MetadataMapAccessor {
+        key = metadataKey || Symbol();
+        getAll(target, propertyKey) {
+            return getMetadata(this.key, target, propertyKey) || null;
+        }
+        setAll(value, target, propertyKey) {
+            return setMetadata(this.key, value, target, propertyKey);
+        }
+        get(name, target, propertyKey) {
+            const obj = this.getAll(target, propertyKey) || {};
+            return obj[name] || null;
+        }
+        set(name, value, target, propertyKey) {
+            const obj = this.getAll(target, propertyKey) || {};
+            obj[name] = value;
+            this.setAll(obj, target, propertyKey);
+            return value;
+        }
+    };
+}
+function MetadataListAccessor(metadataKey, uniqueKey) {
+    return new class MetadataListAccessor {
+        key = metadataKey || Symbol();
+        get(target, propertyKey) {
+            return getMetadataItems(this.key, target, propertyKey);
+        }
+        set(items, target, propertyKey) {
+            setMetadataItems(this.key, Array.isArray(items) ? items : [items], target, propertyKey);
+            return items;
+        }
+        add(items, target, propertyKey) {
+            addMetadataUniqueItems(this.key, Array.isArray(items) ? items : [items], target, propertyKey, uniqueKey);
+            return items;
+        }
+    };
+}
+//# sourceMappingURL=metadata.utils.js.map

package/utils/metadata.utils.js.map

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

package/utils/schema.utils.d.ts

@@ -0,0 +1,9 @@
+import { IOpenApiTypeRefSingle } from "../interfaces/common.interface";
+import { ReferenceObject, SchemaObject } from "@nestjs/swagger/dist/interfaces/open-api-spec.interface";
+import { Type } from "@nestjs/common";
+import { ApiResponseOptions } from "@nestjs/swagger/dist/decorators/api-response.decorator";
+export declare function createSchemaRefs(refs: Array<IOpenApiTypeRefSingle | SchemaObject | ReferenceObject>, options?: {
+    onClassRef?: (ref: Type<unknown>) => void;
+}): Array<SchemaObject | ReferenceObject>;
+export declare function createSchemaFromPrimitive(item: any): SchemaObject | null;
+export declare function generateSchemaType(options: ApiResponseOptions): string | null;

package/utils/schema.utils.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSchemaRefs = createSchemaRefs;
+exports.createSchemaFromPrimitive = createSchemaFromPrimitive;
+exports.generateSchemaType = generateSchemaType;
+const type_utils_1 = require("./type.utils");
+const swagger_1 = require("@nestjs/swagger");
+function createSchemaRefs(refs, options) {
+    return refs
+        .map(ref => {
+        if ((0, type_utils_1.isPlainObject)(ref)) {
+            return ref;
+        }
+        if ((0, type_utils_1.isPrimitive)(ref)) {
+            return createSchemaFromPrimitive(ref);
+        }
+        const classRef = (0, type_utils_1.resolveClassRef)(ref);
+        if (classRef) {
+            options?.onClassRef?.(classRef);
+            return { $ref: (0, swagger_1.getSchemaPath)(classRef) };
+        }
+        return null;
+    })
+        .filter(_ => !!_);
+}
+function createSchemaFromPrimitive(item) {
+    switch (true) {
+        case item === String: return { type: 'string' };
+        case item === Number: return { type: 'number' };
+        case item === Boolean: return { type: 'boolean' };
+        case item === Array: return { type: 'array' };
+        case item === Object: return { type: 'object' };
+        case item === Date: return { type: 'string', format: 'date-time' };
+        default: return null;
+    }
+}
+function generateSchemaType(options) {
+    if ((0, type_utils_1.isPlainObject)(options)) {
+        const { type, isArray, schema } = options;
+        if (type && isArray === true) {
+            return 'array';
+        }
+        if ((0, type_utils_1.isClassRef)(type)) {
+            return 'object';
+        }
+        if (typeof type === 'function') {
+            return type.name;
+        }
+        if (typeof type === 'string') {
+            return type;
+        }
+        if ((0, type_utils_1.isPlainObject)(schema) && 'type' in schema && typeof schema.type === 'string') {
+            return schema.type;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=schema.utils.js.map

package/utils/schema.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.utils.js","sourceRoot":"","sources":["../../../lib/utils/schema.utils.ts"],"names":[],"mappings":";;AAOA,4CA4BC;AAED,8DAUC;AAED,gDAiCC;AAhFD,6CAAqF;AAErF,6CAA8C;AAG9C,SAAgB,gBAAgB,CAAC,IAA+D,EAAE,OAEjG;IACC,OAAO,IAAI;SACR,GAAG,CAAC,GAAG,CAAC,EAAE;QAGT,IAAG,IAAA,0BAAa,EAAC,GAAG,CAAC,EAAC,CAAC;YACrB,OAAO,GAAG,CAAC;QACb,CAAC;QAGD,IAAG,IAAA,wBAAW,EAAC,GAAG,CAAC,EAAC,CAAC;YACnB,OAAO,yBAAyB,CAAC,GAAG,CAAC,CAAC;QACxC,CAAC;QAGD,MAAM,QAAQ,GAAG,IAAA,4BAAe,EAAC,GAAG,CAAC,CAAC;QACtC,IAAG,QAAQ,EAAC,CAAC;YACX,OAAO,EAAE,UAAU,EAAE,CAAC,QAAQ,CAAC,CAAC;YAChC,OAAO,EAAE,IAAI,EAAE,IAAA,uBAAa,EAAC,QAAQ,CAAC,EAAE,CAAC;QAC3C,CAAC;QAGD,OAAO,IAAI,CAAC;IAEd,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAQ,CAAC;AAC7B,CAAC;AAED,SAAgB,yBAAyB,CAAC,IAAS;IACjD,QAAO,IAAI,EAAE,CAAC;QACZ,KAAK,IAAI,KAAK,MAAO,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QACjD,KAAK,IAAI,KAAK,MAAO,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QACjD,KAAK,IAAI,KAAK,OAAQ,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QACnD,KAAK,IAAI,KAAK,KAAM,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAC/C,KAAK,IAAI,KAAK,MAAO,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QACjD,KAAK,IAAI,KAAK,IAAK,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;QACpE,OAAO,CAAC,CAAC,OAAO,IAAI,CAAC;IACvB,CAAC;AACH,CAAC;AAED,SAAgB,kBAAkB,CAAC,OAA2B;IAC5D,IAAG,IAAA,0BAAa,EAAC,OAAO,CAAC,EAAC,CAAC;QAGzB,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAc,CAAC;QAGjD,IAAG,IAAI,IAAI,OAAO,KAAK,IAAI,EAAC,CAAC;YAC3B,OAAO,OAAO,CAAC;QACjB,CAAC;QAGD,IAAG,IAAA,uBAAU,EAAC,IAAI,CAAC,EAAC,CAAC;YACnB,OAAO,QAAQ,CAAC;QAClB,CAAC;QAGD,IAAG,OAAO,IAAI,KAAK,UAAU,EAAC,CAAC;YAC7B,OAAO,IAAI,CAAC,IAAI,CAAC;QACnB,CAAC;QAGD,IAAG,OAAO,IAAI,KAAK,QAAQ,EAAC,CAAC;YAC3B,OAAO,IAAI,CAAC;QACd,CAAC;QAGD,IAAG,IAAA,0BAAa,EAAC,MAAM,CAAC,IAAI,MAAM,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAC,CAAC;YAC/E,OAAO,MAAM,CAAC,IAAI,CAAC;QACrB,CAAC;IAEH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/utils/type.utils.d.ts

@@ -0,0 +1,20 @@
+import { Type } from "@nestjs/common";
+import { IOpenApiRouteLike, IOpenApiType, IOpenApiTypeRef, IOpenApiTypeRefList, IOpenApiTypeRefSingle } from "../interfaces/common.interface";
+export declare function isNil(value: any): value is null | undefined;
+export declare function isPrimitive(value: any): value is String | Number | Boolean | Array<any> | Object | Date;
+export declare function isPlainObject(value: any): value is Object;
+export declare function isClassRef<T = unknown>(value: any): value is Type<T>;
+export declare function isType(value: any): value is IOpenApiType;
+export declare function isTypeRef<T = unknown>(value: any): value is IOpenApiTypeRef<T>;
+export declare function extractType(args: any[], startIndex?: number, endIndex?: number): IOpenApiType | null;
+export declare function extractTypeRef<T = unknown>(args: any[], startIndex?: number, endIndex?: number): IOpenApiTypeRef<T> | null;
+export declare function extractRoute(args: any[], startIndex?: number, endIndex?: number): IOpenApiRouteLike | null;
+export declare function extractString(args: any[], startIndex?: number, endIndex?: number): string | null;
+export declare function extractNumber(args: any[], startIndex?: number, endIndex?: number): number | null;
+export declare function extractObject<T = any>(args: any[], startIndex?: number, endIndex?: number): T | null;
+export declare function extractFalse(args: any[], startIndex?: number, endIndex?: number): boolean;
+export declare function reduceArgs(args: any[], startIndex?: number, endIndex?: number): any[];
+export declare function extractAndResolveClassRef<T = unknown>(args: any[], startIndex?: number, endIndex?: number): Type<T> | Type<T>[] | null;
+export declare function resolveClassRef<T = unknown>(value: IOpenApiTypeRefSingle<T>): Type<T> | null;
+export declare function resolveClassRef<T = unknown>(value: IOpenApiTypeRefList<T>): Type<T>[] | null;
+export declare function resolveClassRef<T = unknown>(value: IOpenApiTypeRef<T>): Type<T> | Type<T>[] | null;