constantia 1.0.0

package/dist/openapi/helpers.js

@@ -0,0 +1,343 @@
+/*@ts-ignore*/
+import { __ΩComponentsObject } from './types.js';
+/*@ts-ignore*/
+import { __ΩSchemaObject } from './types.js';
+/*@ts-ignore*/
+import { __ΩReferenceObject } from './types.js';
+/*@ts-ignore*/
+import { __ΩParameterObject } from './types.js';
+/*@ts-ignore*/
+import { __ΩRequestBodyObject } from './types.js';
+/*@ts-ignore*/
+import { __ΩResponsesObject } from './types.js';
+function __assignType(fn, args) {
+    fn.__type = args;
+    return fn;
+}
+import { logger } from '../logger.js';
+export const schemaTypeToOpenAPISchema = __assignType((schemaType, components) => {
+    if (!schemaType) {
+        return undefined;
+    }
+    switch (schemaType.type) {
+        case 'string':
+            if (schemaType.format) {
+                return { type: 'string', format: schemaType.format };
+            }
+            return { type: 'string' };
+        case 'number':
+            return { type: 'number' };
+        case 'boolean':
+            return { type: 'boolean' };
+        case 'null':
+        case 'void':
+            return { nullable: true };
+        case 'file':
+            return { type: 'string', format: 'binary' };
+        case 'fileStream':
+            return { type: 'string', format: 'binary' };
+        case 'dataStream':
+            logger.warn(`OpenAPI: DataStream schema generation defaults to 'object'. Define item schema explicitly if possible.`);
+            return {
+                type: 'object',
+                description: 'Stream of data objects (e.g., ndjson)',
+            };
+        case 'array': {
+            const itemsSchema = schemaTypeToOpenAPISchema(schemaType.items, components);
+            return { type: 'array', items: itemsSchema || {} };
+        }
+        case 'object': {
+            const properties = {};
+            if (schemaType.properties) {
+                for (const [key, propSchema] of Object.entries(schemaType.properties)) {
+                    const openApiPropSchema = schemaTypeToOpenAPISchema(propSchema, components);
+                    if (openApiPropSchema) {
+                        properties[key] = openApiPropSchema;
+                    }
+                }
+            }
+            return {
+                type: 'object',
+                properties: properties,
+                required: schemaType.required,
+            };
+        }
+        case 'union': {
+            const nonNullTypes = schemaType.oneOf?.filter(__assignType((t) => t.type !== 'null' && t.type !== 'void', ['t', '', 'P"2!"/"']));
+            const hasNull = schemaType.oneOf?.some(__assignType((t) => t.type === 'null' || t.type === 'void', ['t', '', 'P"2!"/"']));
+            if (nonNullTypes?.length === 1) {
+                const baseSchema = schemaTypeToOpenAPISchema(nonNullTypes[0], components);
+                if (baseSchema && hasNull) {
+                    baseSchema.nullable = true;
+                }
+                return baseSchema;
+            }
+            else if (schemaType.oneOf) {
+                return {
+                    oneOf: schemaType.oneOf
+                        .map(__assignType((subSchema) => schemaTypeToOpenAPISchema(subSchema, components), ['subSchema', '', 'P"2!"/"']))
+                        .filter(__assignType((s) => s !== undefined, ['s', '', 'P"2!"/"'])),
+                };
+            }
+            return {};
+        }
+        case 'tuple': {
+            if (!schemaType.elements || schemaType.elements.length === 0) {
+                return {
+                    type: 'array',
+                    items: {},
+                    minItems: 0,
+                    maxItems: 0,
+                };
+            }
+            const elementSchemas = schemaType.elements.map(__assignType((el) => schemaTypeToOpenAPISchema(el, components), ['el', '', 'P"2!"/"']));
+            const allSameType = schemaType.elements.every(__assignType((el) => el.type === schemaType.elements[0].type, ['el', '', 'P"2!"/"']));
+            if (allSameType && schemaType.elements.length > 0) {
+                return {
+                    type: 'array',
+                    items: elementSchemas[0] || {},
+                    minItems: schemaType.elements.length,
+                    maxItems: schemaType.elements.length,
+                    description: `Fixed-length array (tuple) with ${schemaType.elements.length} elements`,
+                };
+            }
+            else {
+                return {
+                    type: 'array',
+                    items: {},
+                    minItems: schemaType.elements.length,
+                    maxItems: schemaType.elements.length,
+                    description: `Fixed-length tuple with ${schemaType.elements.length} elements of types: ${schemaType.elements.map(__assignType((el) => el.type, ['el', '', 'P"2!"/"'])).join(', ')}`,
+                };
+            }
+        }
+        default:
+            logger.warn(`OpenAPI: Unsupported schema type "${schemaType.type}" encountered.`);
+            return {};
+    }
+}, ['SchemaType', 'schemaType', () => __ΩComponentsObject, 'components', () => __ΩSchemaObject, () => __ΩReferenceObject, '', 'PP"w!-J2"n#2$Pn%n&-J/\'']);
+export const createOpenAPIParameters = __assignType((routeParams, components) => {
+    const openApiParams = [];
+    for (const param of routeParams) {
+        let location = null;
+        switch (param.type) {
+            case 'param':
+                location = 'path';
+                break;
+            case 'query':
+                location = 'query';
+                break;
+            case 'header':
+                location = 'header';
+                break;
+            case 'body':
+            case 'file':
+                continue;
+            case 'ctx':
+            case 'rawBody':
+                continue;
+            default:
+                logger.warn(`OpenAPI: Unsupported parameter type "${param.type}" for parameter "${param.name}".`);
+                continue;
+        }
+        if (!param.name) {
+            logger.warn(`OpenAPI: Parameter of type "${param.type}" is missing a name.`);
+            continue;
+        }
+        openApiParams.push({
+            name: param.name,
+            in: location,
+            required: param.required ?? location === 'path',
+            schema: schemaTypeToOpenAPISchema(param.schema, components) || {},
+        });
+    }
+    return openApiParams;
+}, ['ParameterMetadata', 'routeParams', () => __ΩComponentsObject, 'components', () => __ΩParameterObject, () => __ΩReferenceObject, '', 'P"w!F2"n#2$Pn%n&JF/\'']);
+export const createOpenAPIRequestBody = __assignType((routeParams, components) => {
+    const bodyParam = routeParams.find(__assignType((p) => p.type === 'body', ['p', '', 'P"2!"/"']));
+    const fileParams = routeParams.filter(__assignType((p) => p.type === 'file', ['p', '', 'P"2!"/"']));
+    if (!bodyParam && fileParams.length === 0) {
+        return undefined;
+    }
+    const requestBody = {
+        required: true,
+        content: {},
+    };
+    if (bodyParam) {
+        requestBody.content['application/json'] = {
+            schema: schemaTypeToOpenAPISchema(bodyParam.schema, components) || {},
+        };
+        requestBody.required = bodyParam.required;
+    }
+    if (fileParams.length > 0) {
+        const properties = {};
+        const requiredFields = [];
+        let hasUnnamedFileArray = false;
+        for (const fileParam of fileParams) {
+            if (fileParam.name) {
+                properties[fileParam.name] = {
+                    type: 'string',
+                    format: 'binary',
+                };
+                if (fileParam.required) {
+                    requiredFields.push(fileParam.name);
+                }
+            }
+            else {
+                hasUnnamedFileArray = true;
+                if (fileParam.required) {
+                    requiredFields.push('files');
+                }
+            }
+        }
+        if (hasUnnamedFileArray) {
+            properties['files'] = {
+                type: 'array',
+                items: { type: 'string', format: 'binary' },
+                description: 'One or more files uploaded.',
+            };
+        }
+        else if (Object.keys(properties).length === 0 &&
+            fileParams.length > 0) {
+            properties['file'] = {
+                type: 'string',
+                format: 'binary',
+                description: 'A file upload.',
+            };
+            if (fileParams.some(__assignType((fp) => fp.required, ['fp', '', 'P"2!"/"'])))
+                requiredFields.push('file');
+        }
+        requestBody.content['multipart/form-data'] = {
+            schema: {
+                type: 'object',
+                properties: properties,
+                required: requiredFields.length > 0 ? requiredFields : undefined,
+            },
+        };
+        requestBody.required = true;
+    }
+    return requestBody;
+}, ['ParameterMetadata', 'routeParams', () => __ΩComponentsObject, 'components', () => __ΩRequestBodyObject, '', 'P"w!F2"n#2$Pn%-J/&']);
+export const createOpenAPIResponses = __assignType((route, components) => {
+    const responses = {};
+    if (!components.schemas)
+        components.schemas = {};
+    if (!components.responses)
+        components.responses = {};
+    if (!components.schemas['ErrorResponse']) {
+        components.schemas['ErrorResponse'] = {
+            type: 'object',
+            properties: {
+                error: {
+                    type: 'string',
+                    description: 'Short error identifier (e.g., BadRequest, NotFound, Unauthorized)',
+                },
+                message: {
+                    type: 'string',
+                    description: 'Detailed error message',
+                },
+            },
+            required: ['error', 'message'],
+            description: 'Standard error structure for failed responses.',
+        };
+    }
+    const errorResponseRef = { $ref: '#/components/schemas/ErrorResponse' };
+    if (!components.responses['BadRequest']) {
+        components.responses['BadRequest'] = {
+            description: 'Bad Request (e.g., validation error, invalid input)',
+            content: { 'application/json': { schema: errorResponseRef } },
+        };
+    }
+    if (!components.responses['Unauthorized']) {
+        components.responses['Unauthorized'] = {
+            description: 'Unauthorized (e.g., missing or invalid authentication credentials)',
+            content: { 'application/json': { schema: errorResponseRef } },
+        };
+    }
+    if (!components.responses['NotFound']) {
+        components.responses['NotFound'] = {
+            description: 'Resource Not Found',
+            content: { 'application/json': { schema: errorResponseRef } },
+        };
+    }
+    if (!components.responses['InternalError']) {
+        components.responses['InternalError'] = {
+            description: 'Internal Server Error (an unexpected condition occurred)',
+            content: { 'application/json': { schema: errorResponseRef } },
+        };
+    }
+    if (!components.responses['DefaultError']) {
+        components.responses['DefaultError'] = {
+            description: 'An unexpected error occurred (includes errors specified by StatusCodeErrorError)',
+            content: { 'application/json': { schema: errorResponseRef } },
+        };
+    }
+    let successStatusCode = '200';
+    const successResponse = {
+        description: 'Successful operation',
+    };
+    const returnSchema = schemaTypeToOpenAPISchema(route.returnType, components);
+    const specifiedContentType = route.stream?.options?.contentType;
+    if (route.stream?.streamType === 'fileStream') {
+        const responseContentType = specifiedContentType || 'application/octet-stream';
+        successResponse.description = 'File stream';
+        successResponse.content = {
+            [responseContentType]: {
+                schema: { type: 'string', format: 'binary' },
+            },
+        };
+        successResponse.headers = {
+            'Accept-Ranges': {
+                schema: { type: 'string' },
+                description: 'Indicates support for range requests (bytes)',
+            },
+            'Content-Range': {
+                schema: { type: 'string' },
+                description: 'Indicates the part of the file returned for partial content',
+            },
+            'Content-Length': {
+                schema: { type: 'string' },
+                description: 'The size of the file part or whole file',
+            },
+            'Content-Disposition': {
+                schema: { type: 'string' },
+                description: 'Specifies presentation (inline/attachment) and filename',
+            },
+        };
+    }
+    else if (route.stream?.streamType === 'dataStream') {
+        const responseContentType = specifiedContentType || 'application/x-ndjson';
+        successResponse.description = 'Data stream';
+        successResponse.content = {
+            [responseContentType]: {
+                schema: {
+                    type: 'string',
+                    description: `Stream of data objects, often newline-delimited (like ${responseContentType}). Schema represents one object within the stream.`,
+                },
+            },
+        };
+    }
+    else if (route.returnType.type === 'void' ||
+        route.returnType.type === 'null') {
+        successStatusCode = '204';
+        successResponse.description = 'Success (No Content)';
+    }
+    else if (returnSchema) {
+        successResponse.content = {
+            'application/json': {
+                schema: returnSchema,
+            },
+        };
+    }
+    else {
+        successResponse.description = 'Success';
+    }
+    responses[successStatusCode] = successResponse;
+    responses['400'] = { $ref: '#/components/responses/BadRequest' };
+    responses['401'] = { $ref: '#/components/responses/Unauthorized' };
+    responses['404'] = { $ref: '#/components/responses/NotFound' };
+    responses['500'] = { $ref: '#/components/responses/InternalError' };
+    responses.default = { $ref: '#/components/responses/DefaultError' };
+    return responses;
+}, ['RouteMetadata', 'route', () => __ΩComponentsObject, 'components', () => __ΩResponsesObject, '', 'P"w!2"n#2$n%/&']);
+//# sourceMappingURL=helpers.js.map

package/dist/openapi/helpers.js.map

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

package/dist/openapi/index.d.ts

@@ -0,0 +1,15 @@
+import { OpenAPISpec } from './types.js';
+import { type IFrameworkAdapter } from '../adapters/index.js';
+export interface OpenAPIConfig {
+    title?: string;
+    version?: string;
+    description?: string;
+}
+export interface RegisterOpenAPIOptions {
+    config?: OpenAPIConfig;
+}
+export declare const registerOpenAPI: (adapter: IFrameworkAdapter, options?: RegisterOpenAPIOptions) => Promise<void>;
+export { type OpenAPISpec };
+export declare type __ΩOpenAPIConfig = any[];
+export declare type __ΩRegisterOpenAPIOptions = any[];
+//# sourceMappingURL=index.d.ts.map

package/dist/openapi/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/openapi/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACH,WAAW,EAId,MAAM,SAAS,CAAC;AAUjB,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGrD,MAAM,WAAW,aAAa;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AA0GD,MAAM,WAAW,sBAAsB;IACnC,MAAM,CAAC,EAAE,aAAa,CAAC;CAC1B;AAED,eAAO,MAAM,eAAe,YACf,iBAAiB,YACjB,sBAAsB,KAChC,OAAO,CAAC,IAAI,CA4Cd,CAAC;AAEF,OAAO,EAAE,KAAK,WAAW,EAAE,CAAC"}

package/dist/openapi/index.js

@@ -0,0 +1,134 @@
+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;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+/*@ts-ignore*/
+import { __ΩOpenAPISpec } from './types.js';
+function __assignType(fn, args) {
+    fn.__type = args;
+    return fn;
+}
+import fs from 'fs';
+import path from 'path';
+import { createOpenAPIResponses, createOpenAPIParameters, createOpenAPIRequestBody, } from './helpers.js';
+import { logger } from '../logger.js';
+import { Get, Controller } from '../decorators.js';
+import { MetadataStorage } from '../metadata.js';
+const __ΩOpenAPIConfig = ['title', 'version', 'description', 'OpenAPIConfig', 'P&4!8&4"8&4#8Mw$y'];
+export { __ΩOpenAPIConfig as __ΩOpenAPIConfig };
+let OpenAPIController = class OpenAPIController {
+    cachedSpec = null;
+    config;
+    constructor(config = {}) {
+        this.config = config;
+    }
+    generateOpenAPISpec(allMetadata) {
+        if (this.cachedSpec)
+            return this.cachedSpec;
+        const paths = {};
+        const allTags = [];
+        const components = { schemas: {}, responses: {} };
+        for (const controllerMeta of allMetadata) {
+            const controllerTag = controllerMeta.path.split('/').filter(Boolean).pop() ||
+                'Default';
+            allTags.push(controllerTag);
+            for (const routeMeta of controllerMeta.routes) {
+                const fullPath = (controllerMeta.path + routeMeta.path)
+                    .replace(/\/+/g, '/')
+                    .replace(/:([a-zA-Z0-9_]+)/g, '{$1}');
+                if (!paths[fullPath])
+                    paths[fullPath] = {};
+                const __ΩHttpMethodKey = ["get", "put", "post", "delete", "patch", 'HttpMethodKey', 'P.!.".#.$.%Jw&y'];
+                const httpMethod = routeMeta.method.toLowerCase();
+                if (!['get', 'put', 'post', 'delete', 'patch'].includes(httpMethod))
+                    throw new Error('Invalid HTTP method: ' + httpMethod);
+                if (paths[fullPath][httpMethod])
+                    logger.warn(`OpenAPI: Duplicate operation detected for ${httpMethod.toUpperCase()} ${fullPath}. Overwriting.`);
+                const operation = {
+                    tags: [controllerTag],
+                    operationId: `${routeMeta.methodName}`,
+                    parameters: createOpenAPIParameters(routeMeta.parameters, components),
+                    requestBody: createOpenAPIRequestBody(routeMeta.parameters, components),
+                    responses: createOpenAPIResponses(routeMeta, components),
+                    summary: `${controllerTag}_${routeMeta.methodName}`,
+                };
+                if (operation.parameters?.length === 0)
+                    delete operation.parameters;
+                paths[fullPath][httpMethod] = operation;
+            }
+        }
+        this.cachedSpec = {
+            openapi: '3.0.3',
+            info: {
+                title: this.config.title || 'API',
+                version: this.config.version || '1.0.0',
+                description: this.config.description ||
+                    'API documentation generated by Constantia',
+            },
+            tags: allTags.map(__assignType((tag) => ({
+                name: tag,
+                description: `Operations related to ${tag}`,
+            }), ['tag', '', 'P"2!"/"'])),
+            paths: paths,
+            components: components,
+        };
+        return this.cachedSpec;
+    }
+    async getOpenAPISpec() {
+        const allMetadata = Array.from(MetadataStorage.getInstance().controllers.values()).filter(__assignType((meta) => meta.path !== '/openapi.json', ['meta', '', 'P"2!"/"']));
+        return this.generateOpenAPISpec(allMetadata);
+    }
+    static __type = [() => __ΩOpenAPISpec, 'cachedSpec', function () { return null; }, () => __ΩOpenAPIConfig, 'config', () => __ΩOpenAPIConfig, () => ({}), 'constructor', 'ControllerMetadata', 'allMetadata', () => __ΩOpenAPISpec, 'generateOpenAPISpec', () => __ΩOpenAPISpec, 'getOpenAPISpec', 'OpenAPIController', 'Pn!,J3";>#n$3%;Pn&2%>\'"0(P"w)F2*n+0,;Pn-`0.5w/'];
+};
+__decorate([
+    Get(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], OpenAPIController.prototype, "getOpenAPISpec", null);
+OpenAPIController = __decorate([
+    Controller('/openapi.json', false),
+    __metadata("design:paramtypes", [Object])
+], OpenAPIController);
+const __ΩRegisterOpenAPIOptions = [() => __ΩOpenAPIConfig, 'config', 'RegisterOpenAPIOptions', 'Pn!4"8Mw#y'];
+export { __ΩRegisterOpenAPIOptions as __ΩRegisterOpenAPIOptions };
+export const registerOpenAPI = __assignType(async (adapter, options = {}) => {
+    const metadata = MetadataStorage.getInstance();
+    metadata.addController(OpenAPIController, '/openapi.json');
+    const args = process.argv.slice(2);
+    let onlyGenerate = false;
+    let specFileArgIndex = args.indexOf('--generate-spec');
+    if (specFileArgIndex === -1) {
+        specFileArgIndex = args.indexOf('--only-generate-spec');
+        onlyGenerate = specFileArgIndex !== -1;
+    }
+    if (specFileArgIndex !== -1) {
+        let specFilePath = args[specFileArgIndex + 1];
+        if (!specFilePath || specFilePath.startsWith('--'))
+            specFilePath = './openapi.json';
+        const fullPath = path.resolve(specFilePath);
+        const dirPath = path.dirname(fullPath);
+        const controller = new OpenAPIController(options.config);
+        const spec = await controller.getOpenAPISpec();
+        await fs.promises.mkdir(dirPath, { recursive: true });
+        await fs.promises.writeFile(fullPath, JSON.stringify(spec, null, 2));
+        const pathParts = fullPath.split('/').filter(Boolean);
+        const lastThreeDirs = pathParts.slice(-3).join('/');
+        logger.info(`OpenAPI spec written to ...${lastThreeDirs}`);
+        if (onlyGenerate)
+            process.exit(0);
+    }
+    const openAPIControllerMetadata = metadata.controllers.get(OpenAPIController);
+    if (!openAPIControllerMetadata)
+        throw new Error('Failed to register OpenAPI controller');
+    adapter.registerControllers([
+        [openAPIControllerMetadata],
+        [OpenAPIController],
+    ]);
+}, ['IFrameworkAdapter', 'adapter', () => __ΩRegisterOpenAPIOptions, 'options', () => ({}), '', 'P"w!2"n#2$>%$`/&']);
+//# sourceMappingURL=index.js.map

package/dist/openapi/index.js.map

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

package/dist/openapi/types.d.ts

@@ -0,0 +1,129 @@
+export interface OpenAPISpec {
+    openapi: string;
+    info: InfoObject;
+    paths: PathsObject;
+    components?: ComponentsObject;
+    tags?: {
+        name: string;
+        description?: string;
+    }[];
+    servers?: ServerObject[];
+}
+export interface InfoObject {
+    title: string;
+    version: string;
+    description?: string;
+}
+export interface PathsObject {
+    [path: string]: PathItemObject;
+}
+export interface PathItemObject {
+    get?: OperationObject;
+    put?: OperationObject;
+    post?: OperationObject;
+    delete?: OperationObject;
+    patch?: OperationObject;
+    parameters?: (ParameterObject | ReferenceObject)[];
+}
+export interface OperationObject {
+    tags?: string[];
+    summary?: string;
+    description?: string;
+    operationId?: string;
+    parameters?: (ParameterObject | ReferenceObject)[];
+    requestBody?: RequestBodyObject | ReferenceObject;
+    responses: ResponsesObject;
+    deprecated?: boolean;
+}
+export interface ParameterObject {
+    name: string;
+    in: 'query' | 'header' | 'path' | 'cookie';
+    description?: string;
+    required?: boolean;
+    deprecated?: boolean;
+    allowEmptyValue?: boolean;
+    schema?: SchemaObject | ReferenceObject;
+}
+export interface RequestBodyObject {
+    description?: string;
+    content: {
+        [mediaType: string]: MediaTypeObject;
+    };
+    required?: boolean;
+}
+export interface MediaTypeObject {
+    schema?: SchemaObject | ReferenceObject;
+}
+export interface ResponsesObject {
+    default?: ResponseObject | ReferenceObject;
+    [statusCode: string]: ResponseObject | ReferenceObject | undefined;
+}
+export interface ResponseObject {
+    description: string;
+    headers?: {
+        [headerName: string]: HeaderObject | ReferenceObject;
+    };
+    content?: {
+        [mediaType: string]: MediaTypeObject;
+    };
+}
+export interface SchemaObject {
+    type?: 'string' | 'number' | 'integer' | 'boolean' | 'array' | 'object';
+    format?: string;
+    items?: SchemaObject | ReferenceObject;
+    properties?: {
+        [propertyName: string]: SchemaObject | ReferenceObject;
+    };
+    required?: string[];
+    nullable?: boolean;
+    oneOf?: (SchemaObject | ReferenceObject)[];
+    allOf?: (SchemaObject | ReferenceObject)[];
+    anyOf?: (SchemaObject | ReferenceObject)[];
+    description?: string;
+    example?: unknown;
+    minItems?: number;
+    maxItems?: number;
+    additionalProperties?: boolean | SchemaObject | ReferenceObject;
+}
+export interface ComponentsObject {
+    schemas?: {
+        [schemaName: string]: SchemaObject | ReferenceObject;
+    };
+    responses?: {
+        [responseName: string]: ResponseObject | ReferenceObject;
+    };
+    parameters?: {
+        [parameterName: string]: ParameterObject | ReferenceObject;
+    };
+    requestBodies?: {
+        [requestBodyName: string]: RequestBodyObject | ReferenceObject;
+    };
+    headers?: {
+        [headerName: string]: HeaderObject | ReferenceObject;
+    };
+}
+export interface ServerObject {
+    url: string;
+    description?: string;
+}
+export interface HeaderObject extends Omit<ParameterObject, 'name' | 'in'> {
+}
+export interface ReferenceObject {
+    $ref: string;
+}
+export declare type __ΩOpenAPISpec = any[];
+export declare type __ΩInfoObject = any[];
+export declare type __ΩPathsObject = any[];
+export declare type __ΩPathItemObject = any[];
+export declare type __ΩOperationObject = any[];
+export declare type __ΩParameterObject = any[];
+export declare type __ΩRequestBodyObject = any[];
+export declare type __ΩMediaTypeObject = any[];
+export declare type __ΩResponsesObject = any[];
+export declare type __ΩResponseObject = any[];
+export declare type __ΩSchemaObject = any[];
+export declare type __ΩComponentsObject = any[];
+export declare type __ΩServerObject = any[];
+export declare type __ΩHeaderObject = any[];
+export declare type __ΩReferenceObject = any[];
+//# sourceMappingURL=types.d.ts.map

package/dist/openapi/types.d.ts.map

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