vona-module-a-swagger 5.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2016-present Vona
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './lib/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from './lib/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/lib/common/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/common/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/common/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC"}

package/dist/lib/common/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/lib/common/index.js.map

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

package/dist/lib/common/type.interface.d.ts

@@ -0,0 +1,4 @@
+export interface Type<T = any> extends Function {
+    new (...args: any[]): T;
+}
+//# sourceMappingURL=type.interface.d.ts.map

package/dist/lib/common/type.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.interface.d.ts","sourceRoot":"","sources":["../../../src/lib/common/type.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,IAAI,CAAC,CAAC,GAAG,GAAG,CAAE,SAAQ,QAAQ;IAC7C,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;CACzB"}

package/dist/lib/common/type.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=type.interface.js.map

package/dist/lib/common/type.interface.js.map

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

package/dist/lib/constants.d.ts

@@ -0,0 +1,22 @@
+export declare const DECORATORS_PREFIX = "swagger";
+export declare const DECORATORS: {
+    API_OPERATION: string;
+    API_RESPONSE: string;
+    API_PRODUCES: string;
+    API_CONSUMES: string;
+    API_TAGS: string;
+    API_CALLBACKS: string;
+    API_PARAMETERS: string;
+    API_HEADERS: string;
+    API_MODEL_PROPERTIES: string;
+    API_MODEL_PROPERTIES_ARRAY: string;
+    API_SECURITY: string;
+    API_EXCLUDE_ENDPOINT: string;
+    API_EXCLUDE_CONTROLLER: string;
+    API_EXTRA_MODELS: string;
+    API_EXTENSION: string;
+    API_SCHEMA: string;
+    API_DEFAULT_GETTER: string;
+    API_LINK: string;
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/lib/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/lib/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAC3C,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;CAmBtB,CAAC"}

package/dist/lib/constants.js

@@ -0,0 +1,22 @@
+export const DECORATORS_PREFIX = 'swagger';
+export const DECORATORS = {
+    API_OPERATION: `${DECORATORS_PREFIX}/apiOperation`,
+    API_RESPONSE: `${DECORATORS_PREFIX}/apiResponse`,
+    API_PRODUCES: `${DECORATORS_PREFIX}/apiProduces`,
+    API_CONSUMES: `${DECORATORS_PREFIX}/apiConsumes`,
+    API_TAGS: `${DECORATORS_PREFIX}/apiUseTags`,
+    API_CALLBACKS: `${DECORATORS_PREFIX}/apiCallbacks`,
+    API_PARAMETERS: `${DECORATORS_PREFIX}/apiParameters`,
+    API_HEADERS: `${DECORATORS_PREFIX}/apiHeaders`,
+    API_MODEL_PROPERTIES: `${DECORATORS_PREFIX}/apiModelProperties`,
+    API_MODEL_PROPERTIES_ARRAY: `${DECORATORS_PREFIX}/apiModelPropertiesArray`,
+    API_SECURITY: `${DECORATORS_PREFIX}/apiSecurity`,
+    API_EXCLUDE_ENDPOINT: `${DECORATORS_PREFIX}/apiExcludeEndpoint`,
+    API_EXCLUDE_CONTROLLER: `${DECORATORS_PREFIX}/apiExcludeController`,
+    API_EXTRA_MODELS: `${DECORATORS_PREFIX}/apiExtraModels`,
+    API_EXTENSION: `${DECORATORS_PREFIX}/apiExtension`,
+    API_SCHEMA: `${DECORATORS_PREFIX}/apiSchema`,
+    API_DEFAULT_GETTER: `${DECORATORS_PREFIX}/apiDefaultGetter`,
+    API_LINK: `${DECORATORS_PREFIX}/apiLink`,
+};
+//# sourceMappingURL=constants.js.map

package/dist/lib/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/lib/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAS,CAAC;AAC3C,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,aAAa,EAAE,GAAG,iBAAiB,eAAe;IAClD,YAAY,EAAE,GAAG,iBAAiB,cAAc;IAChD,YAAY,EAAE,GAAG,iBAAiB,cAAc;IAChD,YAAY,EAAE,GAAG,iBAAiB,cAAc;IAChD,QAAQ,EAAE,GAAG,iBAAiB,aAAa;IAC3C,aAAa,EAAE,GAAG,iBAAiB,eAAe;IAClD,cAAc,EAAE,GAAG,iBAAiB,gBAAgB;IACpD,WAAW,EAAE,GAAG,iBAAiB,aAAa;IAC9C,oBAAoB,EAAE,GAAG,iBAAiB,qBAAqB;IAC/D,0BAA0B,EAAE,GAAG,iBAAiB,0BAA0B;IAC1E,YAAY,EAAE,GAAG,iBAAiB,cAAc;IAChD,oBAAoB,EAAE,GAAG,iBAAiB,qBAAqB;IAC/D,sBAAsB,EAAE,GAAG,iBAAiB,uBAAuB;IACnE,gBAAgB,EAAE,GAAG,iBAAiB,iBAAiB;IACvD,aAAa,EAAE,GAAG,iBAAiB,eAAe;IAClD,UAAU,EAAE,GAAG,iBAAiB,YAAY;IAC5C,kBAAkB,EAAE,GAAG,iBAAiB,mBAAmB;IAC3D,QAAQ,EAAE,GAAG,iBAAiB,UAAU;CACzC,CAAC"}

package/dist/lib/decorators/api-basic.decorator.d.ts

@@ -0,0 +1,2 @@
+export declare function ApiBasicAuth(name?: string): ClassDecorator & MethodDecorator;
+//# sourceMappingURL=api-basic.decorator.d.ts.map

package/dist/lib/decorators/api-basic.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-basic.decorator.d.ts","sourceRoot":"","sources":["../../../src/lib/decorators/api-basic.decorator.ts"],"names":[],"mappings":"AAEA,wBAAgB,YAAY,CAAC,IAAI,SAAU,oCAE1C"}

package/dist/lib/decorators/api-basic.decorator.js

@@ -0,0 +1,5 @@
+import { ApiSecurity } from './api-security.decorator.js';
+export function ApiBasicAuth(name = 'basic') {
+    return ApiSecurity(name);
+}
+//# sourceMappingURL=api-basic.decorator.js.map

package/dist/lib/decorators/api-basic.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-basic.decorator.js","sourceRoot":"","sources":["../../../src/lib/decorators/api-basic.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE1D,MAAM,UAAU,YAAY,CAAC,IAAI,GAAG,OAAO;IACzC,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC"}

package/dist/lib/decorators/api-bearer.decorator.d.ts

@@ -0,0 +1,2 @@
+export declare function ApiBearerAuth(name?: string): ClassDecorator & MethodDecorator;
+//# sourceMappingURL=api-bearer.decorator.d.ts.map

package/dist/lib/decorators/api-bearer.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-bearer.decorator.d.ts","sourceRoot":"","sources":["../../../src/lib/decorators/api-bearer.decorator.ts"],"names":[],"mappings":"AAEA,wBAAgB,aAAa,CAAC,IAAI,SAAW,oCAE5C"}

package/dist/lib/decorators/api-bearer.decorator.js

@@ -0,0 +1,5 @@
+import { ApiSecurity } from './api-security.decorator.js';
+export function ApiBearerAuth(name = 'bearer') {
+    return ApiSecurity(name);
+}
+//# sourceMappingURL=api-bearer.decorator.js.map

package/dist/lib/decorators/api-bearer.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-bearer.decorator.js","sourceRoot":"","sources":["../../../src/lib/decorators/api-bearer.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE1D,MAAM,UAAU,aAAa,CAAC,IAAI,GAAG,QAAQ;IAC3C,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC"}

package/dist/lib/decorators/api-body.decorator.d.ts

@@ -0,0 +1,17 @@
+import { Type } from 'vona';
+import { ExamplesObject, ReferenceObject, RequestBodyObject, SchemaObject } from '../interfaces/open-api-spec.interface.js';
+import { SwaggerEnumType } from '../types/swagger-enum.type.js';
+type RequestBodyOptions = Omit<RequestBodyObject, 'content'>;
+interface ApiBodyMetadata extends RequestBodyOptions {
+    type?: Type<unknown> | Function | [Function] | string;
+    isArray?: boolean;
+    enum?: SwaggerEnumType;
+}
+interface ApiBodySchemaHost extends RequestBodyOptions {
+    schema: SchemaObject | ReferenceObject;
+    examples?: ExamplesObject;
+}
+export type ApiBodyOptions = ApiBodyMetadata | ApiBodySchemaHost;
+export declare function ApiBody(options: ApiBodyOptions): MethodDecorator;
+export {};
+//# sourceMappingURL=api-body.decorator.d.ts.map

package/dist/lib/decorators/api-body.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-body.decorator.d.ts","sourceRoot":"","sources":["../../../src/lib/decorators/api-body.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,EACL,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,YAAY,EACb,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAIhE,KAAK,kBAAkB,GAAG,IAAI,CAAC,iBAAiB,EAAE,SAAS,CAAC,CAAC;AAE7D,UAAU,eAAgB,SAAQ,kBAAkB;IAClD,IAAI,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,QAAQ,GAAG,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC;IACtD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,eAAe,CAAC;CACxB;AAED,UAAU,iBAAkB,SAAQ,kBAAkB;IACpD,MAAM,EAAE,YAAY,GAAG,eAAe,CAAC;IACvC,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG,iBAAiB,CAAC;AAOjE,wBAAgB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,eAAe,CAehE"}

package/dist/lib/decorators/api-body.decorator.js

@@ -0,0 +1,24 @@
+import { omit } from 'lodash';
+import { addEnumArraySchema, addEnumSchema, isEnumArray, isEnumDefined } from '../utils/enum.utils.js';
+import { createParamDecorator, getTypeIsArrayTuple } from './helpers.js';
+const defaultBodyMetadata = {
+    type: String,
+    required: true,
+};
+export function ApiBody(options) {
+    const [type, isArray] = getTypeIsArrayTuple(options.type, options.isArray);
+    const param = {
+        in: 'body',
+        ...omit(options, 'enum'),
+        type,
+        isArray,
+    };
+    if (isEnumArray(options)) {
+        addEnumArraySchema(param, options);
+    }
+    else if (isEnumDefined(options)) {
+        addEnumSchema(param, options);
+    }
+    return createParamDecorator(param, defaultBodyMetadata);
+}
+//# sourceMappingURL=api-body.decorator.js.map

package/dist/lib/decorators/api-body.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-body.decorator.js","sourceRoot":"","sources":["../../../src/lib/decorators/api-body.decorator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAQ9B,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvG,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAiBzE,MAAM,mBAAmB,GAAoB;IAC3C,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,IAAI;CACf,CAAC;AAEF,MAAM,UAAU,OAAO,CAAC,OAAuB;IAC7C,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,mBAAmB,CAAE,OAA2B,CAAC,IAAI,EAAG,OAA2B,CAAC,OAAO,CAAC,CAAC;IACrH,MAAM,KAAK,GAA0C;QACnD,EAAE,EAAE,MAAM;QACV,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC;QACxB,IAAI;QACJ,OAAO;KACR,CAAC;IAEF,IAAI,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;SAAM,IAAI,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;QAClC,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,oBAAoB,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC;AAC1D,CAAC"}

package/dist/lib/decorators/api-callbacks.decorator.d.ts

@@ -0,0 +1,3 @@
+import { CallBackObject } from '../interfaces/callback-object.interface.js';
+export declare function ApiCallbacks(...callbackObject: Array<CallBackObject<any>>): MethodDecorator & ClassDecorator;
+//# sourceMappingURL=api-callbacks.decorator.d.ts.map

package/dist/lib/decorators/api-callbacks.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-callbacks.decorator.d.ts","sourceRoot":"","sources":["../../../src/lib/decorators/api-callbacks.decorator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAE5E,wBAAgB,YAAY,CAAC,GAAG,cAAc,EAAE,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,oCAEzE"}

package/dist/lib/decorators/api-callbacks.decorator.js

@@ -0,0 +1,6 @@
+import { DECORATORS } from '../constants.js';
+import { createMixedDecorator } from './helpers.js';
+export function ApiCallbacks(...callbackObject) {
+    return createMixedDecorator(DECORATORS.API_CALLBACKS, callbackObject);
+}
+//# sourceMappingURL=api-callbacks.decorator.js.map

package/dist/lib/decorators/api-callbacks.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-callbacks.decorator.js","sourceRoot":"","sources":["../../../src/lib/decorators/api-callbacks.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAGpD,MAAM,UAAU,YAAY,CAAC,GAAG,cAA0C;IACxE,OAAO,oBAAoB,CAAC,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;AACxE,CAAC"}

package/dist/lib/decorators/api-consumes.decorator.d.ts

@@ -0,0 +1,2 @@
+export declare function ApiConsumes(...mimeTypes: string[]): MethodDecorator & ClassDecorator;
+//# sourceMappingURL=api-consumes.decorator.d.ts.map

package/dist/lib/decorators/api-consumes.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-consumes.decorator.d.ts","sourceRoot":"","sources":["../../../src/lib/decorators/api-consumes.decorator.ts"],"names":[],"mappings":"AAGA,wBAAgB,WAAW,CAAC,GAAG,SAAS,EAAE,MAAM,EAAE,oCAEjD"}

package/dist/lib/decorators/api-consumes.decorator.js

@@ -0,0 +1,6 @@
+import { DECORATORS } from '../constants.js';
+import { createMixedDecorator } from './helpers.js';
+export function ApiConsumes(...mimeTypes) {
+    return createMixedDecorator(DECORATORS.API_CONSUMES, mimeTypes);
+}
+//# sourceMappingURL=api-consumes.decorator.js.map

package/dist/lib/decorators/api-consumes.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-consumes.decorator.js","sourceRoot":"","sources":["../../../src/lib/decorators/api-consumes.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,UAAU,WAAW,CAAC,GAAG,SAAmB;IAChD,OAAO,oBAAoB,CAAC,UAAU,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;AAClE,CAAC"}

package/dist/lib/decorators/api-cookie.decorator.d.ts

@@ -0,0 +1,2 @@
+export declare function ApiCookieAuth(name?: string): ClassDecorator & MethodDecorator;
+//# sourceMappingURL=api-cookie.decorator.d.ts.map

package/dist/lib/decorators/api-cookie.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-cookie.decorator.d.ts","sourceRoot":"","sources":["../../../src/lib/decorators/api-cookie.decorator.ts"],"names":[],"mappings":"AAEA,wBAAgB,aAAa,CAAC,IAAI,SAAW,oCAE5C"}

package/dist/lib/decorators/api-cookie.decorator.js

@@ -0,0 +1,5 @@
+import { ApiSecurity } from './api-security.decorator.js';
+export function ApiCookieAuth(name = 'cookie') {
+    return ApiSecurity(name);
+}
+//# sourceMappingURL=api-cookie.decorator.js.map

package/dist/lib/decorators/api-cookie.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-cookie.decorator.js","sourceRoot":"","sources":["../../../src/lib/decorators/api-cookie.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE1D,MAAM,UAAU,aAAa,CAAC,IAAI,GAAG,QAAQ;IAC3C,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC"}

package/dist/lib/decorators/api-default-getter.decorator.d.ts

@@ -0,0 +1,25 @@
+import { Type } from 'vona';
+/**
+ * Set the default getter for the given type to the decorated method
+ *
+ * This is to be used in conjunction with `ApiProperty({link: () => Type})` to generate link objects
+ * in the swagger schema
+ *
+ * ```typescript
+ * @Controller('users')
+ * class UserController {
+ *   @Get(':userId')
+ *   @ApiDefaultGetter(UserGet, 'userId')
+ *   getUser(@Param('userId') userId: string) {
+ *     // ...
+ *   }
+ * }
+ * ```
+ *
+ * @param type The type for which the decorated function is the default getter
+ * @param parameter Name of the parameter in the route of the getter which corresponds to the id of the type
+ *
+ * @see [Swagger link objects](https://swagger.io/docs/specification/links/)
+ */
+export declare function ApiDefaultGetter(type: Type<unknown> | Function, parameter: string): MethodDecorator;
+//# sourceMappingURL=api-default-getter.decorator.d.ts.map

package/dist/lib/decorators/api-default-getter.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-default-getter.decorator.d.ts","sourceRoot":"","sources":["../../../src/lib/decorators/api-default-getter.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAG5B;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,eAAe,CAYnG"}

package/dist/lib/decorators/api-default-getter.decorator.js

@@ -0,0 +1,32 @@
+import { DECORATORS } from '../constants.js';
+/**
+ * Set the default getter for the given type to the decorated method
+ *
+ * This is to be used in conjunction with `ApiProperty({link: () => Type})` to generate link objects
+ * in the swagger schema
+ *
+ * ```typescript
+ * @Controller('users')
+ * class UserController {
+ *   @Get(':userId')
+ *   @ApiDefaultGetter(UserGet, 'userId')
+ *   getUser(@Param('userId') userId: string) {
+ *     // ...
+ *   }
+ * }
+ * ```
+ *
+ * @param type The type for which the decorated function is the default getter
+ * @param parameter Name of the parameter in the route of the getter which corresponds to the id of the type
+ *
+ * @see [Swagger link objects](https://swagger.io/docs/specification/links/)
+ */
+export function ApiDefaultGetter(type, parameter) {
+    return (prototype, _key, descriptor) => {
+        if (type.prototype) {
+            Reflect.defineMetadata(DECORATORS.API_DEFAULT_GETTER, { getter: descriptor.value, parameter, prototype }, type.prototype);
+        }
+        return descriptor;
+    };
+}
+//# sourceMappingURL=api-default-getter.decorator.js.map

package/dist/lib/decorators/api-default-getter.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-default-getter.decorator.js","sourceRoot":"","sources":["../../../src/lib/decorators/api-default-getter.decorator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAA8B,EAAE,SAAiB;IAChF,OAAO,CAAC,SAAiB,EAAE,IAAqB,EAAE,UAA8B,EAAE,EAAE;QAClF,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,OAAO,CAAC,cAAc,CACpB,UAAU,CAAC,kBAAkB,EAC7B,EAAE,MAAM,EAAE,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,EAClD,IAAI,CAAC,SAAS,CACf,CAAC;QACJ,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC"}

package/dist/lib/decorators/api-exclude-controller.decorator.d.ts

@@ -0,0 +1,2 @@
+export declare function ApiExcludeController(disable?: boolean): ClassDecorator;
+//# sourceMappingURL=api-exclude-controller.decorator.d.ts.map

package/dist/lib/decorators/api-exclude-controller.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-exclude-controller.decorator.d.ts","sourceRoot":"","sources":["../../../src/lib/decorators/api-exclude-controller.decorator.ts"],"names":[],"mappings":"AAGA,wBAAgB,oBAAoB,CAAC,OAAO,UAAO,GAAG,cAAc,CAEnE"}

package/dist/lib/decorators/api-exclude-controller.decorator.js

@@ -0,0 +1,6 @@
+import { DECORATORS } from '../constants.js';
+import { createClassDecorator } from './helpers.js';
+export function ApiExcludeController(disable = true) {
+    return createClassDecorator(DECORATORS.API_EXCLUDE_CONTROLLER, [disable]);
+}
+//# sourceMappingURL=api-exclude-controller.decorator.js.map

package/dist/lib/decorators/api-exclude-controller.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-exclude-controller.decorator.js","sourceRoot":"","sources":["../../../src/lib/decorators/api-exclude-controller.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,UAAU,oBAAoB,CAAC,OAAO,GAAG,IAAI;IACjD,OAAO,oBAAoB,CAAC,UAAU,CAAC,sBAAsB,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;AAC5E,CAAC"}

package/dist/lib/decorators/api-exclude-endpoint.decorator.d.ts

@@ -0,0 +1,2 @@
+export declare function ApiExcludeEndpoint(disable?: boolean): MethodDecorator;
+//# sourceMappingURL=api-exclude-endpoint.decorator.d.ts.map

package/dist/lib/decorators/api-exclude-endpoint.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-exclude-endpoint.decorator.d.ts","sourceRoot":"","sources":["../../../src/lib/decorators/api-exclude-endpoint.decorator.ts"],"names":[],"mappings":"AAGA,wBAAgB,kBAAkB,CAAC,OAAO,UAAO,GAAG,eAAe,CAIlE"}

package/dist/lib/decorators/api-exclude-endpoint.decorator.js

@@ -0,0 +1,8 @@
+import { DECORATORS } from '../constants.js';
+import { createMethodDecorator } from './helpers.js';
+export function ApiExcludeEndpoint(disable = true) {
+    return createMethodDecorator(DECORATORS.API_EXCLUDE_ENDPOINT, {
+        disable,
+    });
+}
+//# sourceMappingURL=api-exclude-endpoint.decorator.js.map

package/dist/lib/decorators/api-exclude-endpoint.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-exclude-endpoint.decorator.js","sourceRoot":"","sources":["../../../src/lib/decorators/api-exclude-endpoint.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,UAAU,kBAAkB,CAAC,OAAO,GAAG,IAAI;IAC/C,OAAO,qBAAqB,CAAC,UAAU,CAAC,oBAAoB,EAAE;QAC5D,OAAO;KACR,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/decorators/api-extension.decorator.d.ts

@@ -0,0 +1,2 @@
+export declare function ApiExtension(extensionKey: string, extensionProperties: any): MethodDecorator & ClassDecorator;
+//# sourceMappingURL=api-extension.decorator.d.ts.map

package/dist/lib/decorators/api-extension.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-extension.decorator.d.ts","sourceRoot":"","sources":["../../../src/lib/decorators/api-extension.decorator.ts"],"names":[],"mappings":"AAIA,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,mBAAmB,EAAE,GAAG,oCAU1E"}

package/dist/lib/decorators/api-extension.decorator.js

@@ -0,0 +1,13 @@
+import { DECORATORS } from '../constants.js';
+import { createMixedDecorator } from './helpers.js';
+import { clone } from 'lodash';
+export function ApiExtension(extensionKey, extensionProperties) {
+    if (!extensionKey.startsWith('x-')) {
+        throw new Error('Extension key is not prefixed. Please ensure you prefix it with `x-`.');
+    }
+    const extensionObject = {
+        [extensionKey]: clone(extensionProperties),
+    };
+    return createMixedDecorator(DECORATORS.API_EXTENSION, extensionObject);
+}
+//# sourceMappingURL=api-extension.decorator.js.map

package/dist/lib/decorators/api-extension.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-extension.decorator.js","sourceRoot":"","sources":["../../../src/lib/decorators/api-extension.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAE/B,MAAM,UAAU,YAAY,CAAC,YAAoB,EAAE,mBAAwB;IACzE,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;IAC3F,CAAC;IAED,MAAM,eAAe,GAAG;QACtB,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC,mBAAmB,CAAC;KAC3C,CAAC;IAEF,OAAO,oBAAoB,CAAC,UAAU,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;AACzE,CAAC"}

package/dist/lib/decorators/api-extra-models.decorator.d.ts

@@ -0,0 +1,2 @@
+export declare function ApiExtraModels(...models: Function[]): (target: object, _key?: string | symbol, descriptor?: TypedPropertyDescriptor<any>) => any;
+//# sourceMappingURL=api-extra-models.decorator.d.ts.map

package/dist/lib/decorators/api-extra-models.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-extra-models.decorator.d.ts","sourceRoot":"","sources":["../../../src/lib/decorators/api-extra-models.decorator.ts"],"names":[],"mappings":"AAEA,wBAAgB,cAAc,CAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,YAClC,MAAM,SAAS,MAAM,GAAG,MAAM,eAAe,wBAAwB,GAAG,CAAC,KAAG,GAAG,CAWhG"}

package/dist/lib/decorators/api-extra-models.decorator.js

@@ -0,0 +1,14 @@
+import { DECORATORS } from '../constants.js';
+export function ApiExtraModels(...models) {
+    return (target, _key, descriptor) => {
+        if (descriptor) {
+            const extraModels = Reflect.getMetadata(DECORATORS.API_EXTRA_MODELS, descriptor.value) || [];
+            Reflect.defineMetadata(DECORATORS.API_EXTRA_MODELS, [...extraModels, ...models], descriptor.value);
+            return descriptor;
+        }
+        const extraModels = Reflect.getMetadata(DECORATORS.API_EXTRA_MODELS, target) || [];
+        Reflect.defineMetadata(DECORATORS.API_EXTRA_MODELS, [...extraModels, ...models], target);
+        return target;
+    };
+}
+//# sourceMappingURL=api-extra-models.decorator.js.map

package/dist/lib/decorators/api-extra-models.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-extra-models.decorator.js","sourceRoot":"","sources":["../../../src/lib/decorators/api-extra-models.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,UAAU,cAAc,CAAC,GAAG,MAAkB;IAClD,OAAO,CAAC,MAAc,EAAE,IAAsB,EAAE,UAAyC,EAAO,EAAE;QAChG,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,gBAAgB,EAAE,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YAC7F,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC,GAAG,WAAW,EAAE,GAAG,MAAM,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;YACnG,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,gBAAgB,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QACnF,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC,GAAG,WAAW,EAAE,GAAG,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;QACzF,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC"}

package/dist/lib/decorators/api-header.decorator.d.ts

@@ -0,0 +1,8 @@
+import { ParameterObject } from '../interfaces/open-api-spec.interface.js';
+import { SwaggerEnumType } from '../types/swagger-enum.type.js';
+export interface ApiHeaderOptions extends Omit<ParameterObject, 'in'> {
+    enum?: SwaggerEnumType;
+}
+export declare function ApiHeader(options: ApiHeaderOptions): MethodDecorator & ClassDecorator;
+export declare const ApiHeaders: (headers: ApiHeaderOptions[]) => MethodDecorator & ClassDecorator;
+//# sourceMappingURL=api-header.decorator.d.ts.map

package/dist/lib/decorators/api-header.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-header.decorator.d.ts","sourceRoot":"","sources":["../../../src/lib/decorators/api-header.decorator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAqB,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAC9F,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAIhE,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC;IACnE,IAAI,CAAC,EAAE,eAAe,CAAC;CACxB;AAMD,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe,GAAG,cAAc,CA+BrF;AAED,eAAO,MAAM,UAAU,YAAa,gBAAgB,EAAE,KAAG,eAAe,GAAG,cAI1E,CAAC"}

package/dist/lib/decorators/api-header.decorator.js

@@ -0,0 +1,40 @@
+import { isNil, isUndefined, negate, pickBy } from 'lodash';
+import { DECORATORS } from '../constants.js';
+import { getEnumType, getEnumValues } from '../utils/enum.utils.js';
+import { createClassDecorator, createParamDecorator } from './helpers.js';
+const defaultHeaderOptions = {
+    name: '',
+};
+export function ApiHeader(options) {
+    const param = pickBy({
+        name: isNil(options.name) ? defaultHeaderOptions.name : options.name,
+        in: 'header',
+        description: options.description,
+        required: options.required,
+        examples: options.examples,
+        schema: {
+            type: 'string',
+            ...(options.schema || {}),
+        },
+    }, negate(isUndefined));
+    if (options.enum) {
+        const enumValues = getEnumValues(options.enum);
+        param.schema = {
+            ...param.schema,
+            enum: enumValues,
+            type: getEnumType(enumValues),
+        };
+    }
+    return (target, key, descriptor) => {
+        if (descriptor) {
+            return createParamDecorator(param, defaultHeaderOptions)(target, key, descriptor);
+        }
+        return createClassDecorator(DECORATORS.API_HEADERS, [param])(target);
+    };
+}
+export const ApiHeaders = (headers) => {
+    return (target, key, descriptor) => {
+        headers.forEach(options => ApiHeader(options)(target, key, descriptor));
+    };
+};
+//# sourceMappingURL=api-header.decorator.js.map

package/dist/lib/decorators/api-header.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-header.decorator.js","sourceRoot":"","sources":["../../../src/lib/decorators/api-header.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAM1E,MAAM,oBAAoB,GAA8B;IACtD,IAAI,EAAE,EAAE;CACT,CAAC;AAEF,MAAM,UAAU,SAAS,CAAC,OAAyB;IACjD,MAAM,KAAK,GAAG,MAAM,CAClB;QACE,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI;QACpE,EAAE,EAAE,QAAQ;QACZ,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;SAC1B;KACF,EACD,MAAM,CAAC,WAAW,CAAC,CACpB,CAAC;IAEF,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/C,KAAK,CAAC,MAAM,GAAG;YACb,GAAG,KAAK,CAAC,MAAM;YACf,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,WAAW,CAAC,UAAU,CAAC;SAC9B,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,MAAyB,EAAE,GAAqB,EAAE,UAAyC,EAAO,EAAE;QAC1G,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,oBAAoB,CAAC,KAAK,EAAE,oBAAoB,CAAC,CAAC,MAAM,EAAE,GAAI,EAAE,UAAU,CAAC,CAAC;QACrF,CAAC;QACD,OAAO,oBAAoB,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,MAAkB,CAAC,CAAC;IACnF,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,OAA2B,EAAoC,EAAE;IAC1F,OAAO,CAAC,MAAyB,EAAE,GAAqB,EAAE,UAAyC,EAAO,EAAE;QAC1G,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,GAAI,EAAE,UAAW,CAAC,CAAC,CAAC;IAC5E,CAAC,CAAC;AACJ,CAAC,CAAC"}

package/dist/lib/decorators/api-hide-property.decorator.d.ts

@@ -0,0 +1,2 @@
+export declare function ApiHideProperty(): PropertyDecorator;
+//# sourceMappingURL=api-hide-property.decorator.d.ts.map

package/dist/lib/decorators/api-hide-property.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-hide-property.decorator.d.ts","sourceRoot":"","sources":["../../../src/lib/decorators/api-hide-property.decorator.ts"],"names":[],"mappings":"AACA,wBAAgB,eAAe,IAAI,iBAAiB,CAEnD"}

package/dist/lib/decorators/api-hide-property.decorator.js

@@ -0,0 +1,5 @@
+/* eslint-disable @typescript-eslint/no-empty-function */
+export function ApiHideProperty() {
+    return (_target, _propertyKey) => { };
+}
+//# sourceMappingURL=api-hide-property.decorator.js.map

package/dist/lib/decorators/api-hide-property.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-hide-property.decorator.js","sourceRoot":"","sources":["../../../src/lib/decorators/api-hide-property.decorator.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,MAAM,UAAU,eAAe;IAC7B,OAAO,CAAC,OAA4B,EAAE,YAA6B,EAAE,EAAE,GAAE,CAAC,CAAC;AAC7E,CAAC"}

package/dist/lib/decorators/api-link.decorator.d.ts

@@ -0,0 +1,48 @@
+import { Type } from 'vona';
+export interface ApiLinkOptions {
+    from: Type<unknown> | Function;
+    /**
+     * Field in the type `from` which is used as a parameter in the decorated route
+     *
+     * @default 'id'
+     */
+    fromField?: string;
+    /**
+     * Name of the parameter in the decorated route
+     */
+    routeParam: string;
+}
+/**
+ * Defines this route as a link between two types
+ *
+ * Typically used when the link between the types is not present in the `from` type,
+ * eg with the following
+ *
+ * ```typescript
+ * class User {
+ *   @ApiProperty()
+ *   id: string
+ *
+ *   // no field documentIds: string[]
+ * }
+ *
+ * class Document {
+ *   @ApiProperty()
+ *   id: string
+ * }
+ *
+ * @Controller()
+ * class UserController {
+ *   @Get(':userId/documents')
+ *   @ApiLink({from: User, fromField: 'id', routeParam: 'userId'})
+ *   getDocuments(@Param('userId') userId: string)): Promise<Documents[]>
+ * }
+ * ```
+ *
+ * @param type The type for which the decorated function is the default getter
+ * @param parameter Name of the parameter in the route of the getter which corresponds to the id of the type
+ *
+ * @see [Swagger link objects](https://swagger.io/docs/specification/links/)
+ */
+export declare function ApiLink({ from, fromField, routeParam }: ApiLinkOptions): MethodDecorator;
+//# sourceMappingURL=api-link.decorator.d.ts.map

package/dist/lib/decorators/api-link.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-link.decorator.d.ts","sourceRoot":"","sources":["../../../src/lib/decorators/api-link.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAG5B,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAC;IAC/B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,OAAO,CAAC,EAAE,IAAI,EAAE,SAAgB,EAAE,UAAU,EAAE,EAAE,cAAc,GAAG,eAAe,CAkB/F"}