exisjs 0.7.5 → 0.7.7

package/dist/swagger/decorators.d.ts

@@ -0,0 +1,81 @@
+export declare const OPENAPI_CLASS_META: unique symbol;
+export declare const OPENAPI_PROPERTY_META: unique symbol;
+/**
+ * Assigns one or more OpenAPI tags to a class controller or method handler.
+ *
+ * @example
+ * ```ts
+ * @ApiTags('Users', 'Authentication')
+ * @Controller('/users')
+ * export class UserController {}
+ * ```
+ */
+export declare function ApiTags(...tags: string[]): any;
+export declare const Tags: typeof ApiTags;
+/**
+ * Attaches OpenAPI operation metadata (summary, description, operationId, deprecated status) to a route method.
+ *
+ * @example
+ * ```ts
+ * @Get('/:id')
+ * @ApiOperation({ summary: 'Get User By ID', description: 'Fetches user details' })
+ * getUser() {}
+ * ```
+ */
+export declare function ApiOperation(options: {
+    summary?: string;
+    description?: string;
+    operationId?: string;
+    deprecated?: boolean;
+    externalDocs?: {
+        url: string;
+        description?: string;
+    };
+}): any;
+export declare const Operation: typeof ApiOperation;
+/**
+ * Defines an OpenAPI response definition for a status code.
+ *
+ * @example
+ * ```ts
+ * @ApiResponse({ status: 200, description: 'User retrieved successfully', schema: UserResponseSchema })
+ * @ApiResponse({ status: 404, description: 'User not found' })
+ * getUser() {}
+ * ```
+ */
+export declare function ApiResponse(options: {
+    status: number | string;
+    description?: string;
+    schema?: any;
+}): any;
+/**
+ * Requires Bearer JWT authentication for this endpoint or controller in OpenAPI.
+ *
+ * @example
+ * ```ts
+ * @ApiBearerAuth()
+ * @Get('/profile')
+ * getProfile() {}
+ * ```
+ */
+export declare function ApiBearerAuth(name?: string): any;
+export declare const BearerAuth: typeof ApiBearerAuth;
+/**
+ * Requires custom security scheme authentication for this endpoint or controller.
+ */
+export declare function ApiSecurity(name: string, scopes?: string[]): any;
+/**
+ * Excludes a route or controller from OpenAPI / Swagger generation.
+ */
+export declare function ApiExclude(): any;
+/**
+ * Annotates a class property with metadata for OpenAPI schema generation.
+ */
+export declare function ApiProperty(options?: {
+    description?: string;
+    example?: any;
+    required?: boolean;
+    type?: any;
+    enum?: any[];
+}): any;
+//# sourceMappingURL=decorators.d.ts.map

package/dist/swagger/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/swagger/decorators.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,kBAAkB,eAA0C,CAAA;AACzE,eAAO,MAAM,qBAAqB,eAA6C,CAAA;AAE/E;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,GAAG,CAqB9C;AAED,eAAO,MAAM,IAAI,gBAAU,CAAA;AAE3B;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE;IACpC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,YAAY,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CACrD,GAAG,GAAG,CAkBN;AAED,eAAO,MAAM,SAAS,qBAAe,CAAA;AAErC;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE;IACnC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,GAAG,CAAA;CACb,GAAG,GAAG,CAcN;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,IAAI,SAAe,GAAG,GAAG,CAsBtD;AAED,eAAO,MAAM,UAAU,sBAAgB,CAAA;AAEvC;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,EAAO,GAAG,GAAG,CAsBpE;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,GAAG,CAehC;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,OAAO,GAAE;IACP,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,GAAG,CAAA;IACb,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,IAAI,CAAC,EAAE,GAAG,CAAA;IACV,IAAI,CAAC,EAAE,GAAG,EAAE,CAAA;CACR,GACL,GAAG,CAML"}

package/dist/swagger/decorators.js

@@ -0,0 +1,172 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BearerAuth = exports.Operation = exports.Tags = exports.OPENAPI_PROPERTY_META = exports.OPENAPI_CLASS_META = void 0;
+exports.ApiTags = ApiTags;
+exports.ApiOperation = ApiOperation;
+exports.ApiResponse = ApiResponse;
+exports.ApiBearerAuth = ApiBearerAuth;
+exports.ApiSecurity = ApiSecurity;
+exports.ApiExclude = ApiExclude;
+exports.ApiProperty = ApiProperty;
+const constants_1 = require("../decorators/constants");
+exports.OPENAPI_CLASS_META = Symbol.for('exisjs:openapi_class_meta');
+exports.OPENAPI_PROPERTY_META = Symbol.for('exisjs:openapi_property_meta');
+/**
+ * Assigns one or more OpenAPI tags to a class controller or method handler.
+ *
+ * @example
+ * ```ts
+ * @ApiTags('Users', 'Authentication')
+ * @Controller('/users')
+ * export class UserController {}
+ * ```
+ */
+function ApiTags(...tags) {
+    return function (target, propertyKey, descriptor) {
+        if (propertyKey && descriptor) {
+            const fn = descriptor.value;
+            fn[constants_1.ROUTE_METADATA_PROP] = fn[constants_1.ROUTE_METADATA_PROP] || {};
+            fn[constants_1.ROUTE_METADATA_PROP].tags = [
+                ...(fn[constants_1.ROUTE_METADATA_PROP].tags || []),
+                ...tags,
+            ];
+        }
+        else {
+            target[exports.OPENAPI_CLASS_META] = target[exports.OPENAPI_CLASS_META] || {};
+            target[exports.OPENAPI_CLASS_META].tags = [
+                ...(target[exports.OPENAPI_CLASS_META].tags || []),
+                ...tags,
+            ];
+        }
+    };
+}
+exports.Tags = ApiTags;
+/**
+ * Attaches OpenAPI operation metadata (summary, description, operationId, deprecated status) to a route method.
+ *
+ * @example
+ * ```ts
+ * @Get('/:id')
+ * @ApiOperation({ summary: 'Get User By ID', description: 'Fetches user details' })
+ * getUser() {}
+ * ```
+ */
+function ApiOperation(options) {
+    return function (_target, _propertyKey, descriptor) {
+        const fn = descriptor.value;
+        fn[constants_1.ROUTE_METADATA_PROP] = fn[constants_1.ROUTE_METADATA_PROP] || {};
+        if (options.summary)
+            fn[constants_1.ROUTE_METADATA_PROP].summary = options.summary;
+        if (options.description)
+            fn[constants_1.ROUTE_METADATA_PROP].description = options.description;
+        if (options.operationId)
+            fn[constants_1.ROUTE_METADATA_PROP].operationId = options.operationId;
+        if (options.deprecated !== undefined)
+            fn[constants_1.ROUTE_METADATA_PROP].deprecated = options.deprecated;
+        if (options.externalDocs)
+            fn[constants_1.ROUTE_METADATA_PROP].externalDocs = options.externalDocs;
+    };
+}
+exports.Operation = ApiOperation;
+/**
+ * Defines an OpenAPI response definition for a status code.
+ *
+ * @example
+ * ```ts
+ * @ApiResponse({ status: 200, description: 'User retrieved successfully', schema: UserResponseSchema })
+ * @ApiResponse({ status: 404, description: 'User not found' })
+ * getUser() {}
+ * ```
+ */
+function ApiResponse(options) {
+    return function (_target, _propertyKey, descriptor) {
+        const fn = descriptor.value;
+        fn[constants_1.ROUTE_METADATA_PROP] = fn[constants_1.ROUTE_METADATA_PROP] || {};
+        fn[constants_1.ROUTE_METADATA_PROP].responses = fn[constants_1.ROUTE_METADATA_PROP].responses || {};
+        fn[constants_1.ROUTE_METADATA_PROP].responses[options.status] = {
+            description: options.description || `HTTP ${options.status} Response`,
+            schema: options.schema,
+        };
+    };
+}
+/**
+ * Requires Bearer JWT authentication for this endpoint or controller in OpenAPI.
+ *
+ * @example
+ * ```ts
+ * @ApiBearerAuth()
+ * @Get('/profile')
+ * getProfile() {}
+ * ```
+ */
+function ApiBearerAuth(name = 'bearerAuth') {
+    return function (target, propertyKey, descriptor) {
+        const securityObj = { [name]: [] };
+        if (propertyKey && descriptor) {
+            const fn = descriptor.value;
+            fn[constants_1.ROUTE_METADATA_PROP] = fn[constants_1.ROUTE_METADATA_PROP] || {};
+            fn[constants_1.ROUTE_METADATA_PROP].security = [
+                ...(fn[constants_1.ROUTE_METADATA_PROP].security || []),
+                securityObj,
+            ];
+        }
+        else {
+            target[exports.OPENAPI_CLASS_META] = target[exports.OPENAPI_CLASS_META] || {};
+            target[exports.OPENAPI_CLASS_META].security = [
+                ...(target[exports.OPENAPI_CLASS_META].security || []),
+                securityObj,
+            ];
+        }
+    };
+}
+exports.BearerAuth = ApiBearerAuth;
+/**
+ * Requires custom security scheme authentication for this endpoint or controller.
+ */
+function ApiSecurity(name, scopes = []) {
+    return function (target, propertyKey, descriptor) {
+        const securityObj = { [name]: scopes };
+        if (propertyKey && descriptor) {
+            const fn = descriptor.value;
+            fn[constants_1.ROUTE_METADATA_PROP] = fn[constants_1.ROUTE_METADATA_PROP] || {};
+            fn[constants_1.ROUTE_METADATA_PROP].security = [
+                ...(fn[constants_1.ROUTE_METADATA_PROP].security || []),
+                securityObj,
+            ];
+        }
+        else {
+            target[exports.OPENAPI_CLASS_META] = target[exports.OPENAPI_CLASS_META] || {};
+            target[exports.OPENAPI_CLASS_META].security = [
+                ...(target[exports.OPENAPI_CLASS_META].security || []),
+                securityObj,
+            ];
+        }
+    };
+}
+/**
+ * Excludes a route or controller from OpenAPI / Swagger generation.
+ */
+function ApiExclude() {
+    return function (target, propertyKey, descriptor) {
+        if (propertyKey && descriptor) {
+            const fn = descriptor.value;
+            fn[constants_1.ROUTE_METADATA_PROP] = fn[constants_1.ROUTE_METADATA_PROP] || {};
+            fn[constants_1.ROUTE_METADATA_PROP].excludeFromDocs = true;
+        }
+        else {
+            target[exports.OPENAPI_CLASS_META] = target[exports.OPENAPI_CLASS_META] || {};
+            target[exports.OPENAPI_CLASS_META].excludeFromDocs = true;
+        }
+    };
+}
+/**
+ * Annotates a class property with metadata for OpenAPI schema generation.
+ */
+function ApiProperty(options = {}) {
+    return function (target, propertyKey) {
+        target.constructor[exports.OPENAPI_PROPERTY_META] =
+            target.constructor[exports.OPENAPI_PROPERTY_META] || {};
+        target.constructor[exports.OPENAPI_PROPERTY_META][propertyKey] = options;
+    };
+}
+//# sourceMappingURL=decorators.js.map

package/dist/swagger/decorators.js.map

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

package/dist/swagger/generator.d.ts

@@ -0,0 +1,19 @@
+import type { Route } from '../router/types';
+import type { OpenApiSpec, SwaggerConfig } from './types';
+/**
+ * Normalizes framework path syntax (`/users/:id`, `/posts/[id]`, `/files/*`) into OpenAPI standard `{id}` path parameters.
+ */
+export declare function normalizeOpenApiPath(path: string): string;
+/**
+ * Converts a validator or schema object (TexEngine, TexType, Zod, or raw object) to an OpenAPI/JSON Schema.
+ */
+export declare function schemaToOpenApi(validator: any): Record<string, any>;
+/**
+ * Generates an OpenAPI 3.1.0 specification object from the registered routes and configuration.
+ */
+export declare function generateOpenApiSpec(routesOrApp: Route[] | {
+    routes?: Route[];
+    getRoutes?: () => Route[];
+    getRouter?: () => any;
+}, config?: SwaggerConfig): OpenApiSpec;
+//# sourceMappingURL=generator.d.ts.map

package/dist/swagger/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/swagger/generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAe,MAAM,iBAAiB,CAAA;AACzD,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EAKd,MAAM,SAAS,CAAA;AAEhB;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAczD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAgFnE;AA6ED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EACP,KAAK,EAAE,GACP;IAAE,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,KAAK,EAAE,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,CAAA;CAAE,EAC1E,MAAM,GAAE,aAAkB,GACzB,WAAW,CAqLb"}

package/dist/swagger/generator.js

@@ -0,0 +1,344 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeOpenApiPath = normalizeOpenApiPath;
+exports.schemaToOpenApi = schemaToOpenApi;
+exports.generateOpenApiSpec = generateOpenApiSpec;
+/**
+ * Normalizes framework path syntax (`/users/:id`, `/posts/[id]`, `/files/*`) into OpenAPI standard `{id}` path parameters.
+ */
+function normalizeOpenApiPath(path) {
+    let normalized = path
+        // Convert :param to {param}
+        .replace(/:([a-zA-Z0-9_]+)/g, '{$1}')
+        // Convert [param] and [...param] to {param}
+        .replace(/\[\.\.\.([a-zA-Z0-9_]+)\]/g, '{$1}')
+        .replace(/\[([a-zA-Z0-9_]+)\]/g, '{$1}')
+        // Convert wildcard * to {wildcard}
+        .replace(/\/\*$/g, '/{wildcard}');
+    if (!normalized.startsWith('/')) {
+        normalized = `/${normalized}`;
+    }
+    return normalized;
+}
+/**
+ * Converts a validator or schema object (TexEngine, TexType, Zod, or raw object) to an OpenAPI/JSON Schema.
+ */
+function schemaToOpenApi(validator) {
+    if (!validator)
+        return { type: 'object' };
+    // 1. Tex Native Engine or Type with toOpenApi method
+    if (typeof validator.toOpenApi === 'function') {
+        return validator.toOpenApi();
+    }
+    // 2. Direct TexType
+    if (validator.constructor &&
+        validator.constructor.name === 'TexType' &&
+        validator._raw) {
+        const raw = validator._raw.split('|')[0].trim();
+        const isOptional = raw.endsWith('?');
+        const base = raw.replace('?', '');
+        let typeObj = { type: 'string' };
+        if (base.startsWith('number'))
+            typeObj = { type: 'number' };
+        else if (base.startsWith('boolean'))
+            typeObj = { type: 'boolean' };
+        else if (base.startsWith('date'))
+            typeObj = { type: 'string', format: 'date-time' };
+        else if (base.startsWith('email'))
+            typeObj = { type: 'string', format: 'email' };
+        else if (base.startsWith('uuid'))
+            typeObj = { type: 'string', format: 'uuid' };
+        else if (base.startsWith('array<'))
+            typeObj = { type: 'array', items: { type: 'string' } };
+        return isOptional ? { ...typeObj, nullable: true } : typeObj;
+    }
+    // 3. Zod-like Duck Typing
+    if (typeof validator._def === 'object') {
+        const def = validator._def;
+        const typeName = def.typeName || '';
+        if (typeName === 'ZodString')
+            return { type: 'string' };
+        if (typeName === 'ZodNumber')
+            return { type: 'number' };
+        if (typeName === 'ZodBoolean')
+            return { type: 'boolean' };
+        if (typeName === 'ZodArray') {
+            return {
+                type: 'array',
+                items: schemaToOpenApi(def.type),
+            };
+        }
+        if (typeName === 'ZodObject' && typeof def.shape === 'function') {
+            const shape = def.shape();
+            const properties = {};
+            const required = [];
+            for (const [key, val] of Object.entries(shape)) {
+                properties[key] = schemaToOpenApi(val);
+                if (val?._def?.typeName !== 'ZodOptional' &&
+                    val?._def?.typeName !== 'ZodNullable') {
+                    required.push(key);
+                }
+            }
+            return {
+                type: 'object',
+                properties,
+                ...(required.length > 0 ? { required } : {}),
+            };
+        }
+    }
+    // 4. If plain object representation
+    if (typeof validator === 'object') {
+        if (validator.type &&
+            (validator.properties ||
+                validator.items ||
+                typeof validator.type === 'string')) {
+            return validator;
+        }
+    }
+    return { type: 'object' };
+}
+/**
+ * Extracts query parameters from route schema into OpenAPI parameter objects.
+ */
+function extractQueryParameters(queryValidator) {
+    if (!queryValidator)
+        return [];
+    const schema = schemaToOpenApi(queryValidator);
+    if (schema.type !== 'object' || !schema.properties)
+        return [];
+    const requiredList = Array.isArray(schema.required)
+        ? schema.required
+        : [];
+    return Object.entries(schema.properties).map(([name, propSchema]) => {
+        const isRequired = requiredList.includes(name);
+        return {
+            name,
+            in: 'query',
+            required: isRequired,
+            schema: propSchema,
+        };
+    });
+}
+/**
+ * Extracts path parameters from the URL string and matched schema into OpenAPI parameters.
+ */
+function extractPathParameters(path, paramsValidator) {
+    const matches = path.match(/:([a-zA-Z0-9_]+)|\[\.\.\.([a-zA-Z0-9_]+)\]|\[([a-zA-Z0-9_]+)\]|\*/g) || [];
+    if (matches.length === 0)
+        return [];
+    const schema = paramsValidator ? schemaToOpenApi(paramsValidator) : null;
+    const properties = schema?.properties || {};
+    return matches.map((m) => {
+        let name = m.replace(/[:[\]]/g, '').replace(/^\.\.\./, '');
+        if (m === '*')
+            name = 'wildcard';
+        const propSchema = properties[name] || { type: 'string' };
+        return {
+            name,
+            in: 'path',
+            required: true,
+            schema: propSchema,
+        };
+    });
+}
+/**
+ * Extracts header parameters from route schema.
+ */
+function extractHeaderParameters(headersValidator) {
+    if (!headersValidator)
+        return [];
+    const schema = schemaToOpenApi(headersValidator);
+    if (schema.type !== 'object' || !schema.properties)
+        return [];
+    const requiredList = Array.isArray(schema.required)
+        ? schema.required
+        : [];
+    return Object.entries(schema.properties).map(([name, propSchema]) => {
+        return {
+            name,
+            in: 'header',
+            required: requiredList.includes(name),
+            schema: propSchema,
+        };
+    });
+}
+/**
+ * Generates an OpenAPI 3.1.0 specification object from the registered routes and configuration.
+ */
+function generateOpenApiSpec(routesOrApp, config = {}) {
+    let routes = [];
+    if (Array.isArray(routesOrApp)) {
+        routes = routesOrApp;
+    }
+    else if (routesOrApp && typeof routesOrApp.getRoutes === 'function') {
+        routes = routesOrApp.getRoutes();
+    }
+    else if (routesOrApp && typeof routesOrApp.getRouter === 'function') {
+        routes = routesOrApp.getRouter().getRoutes();
+    }
+    else if (routesOrApp && Array.isArray(routesOrApp.routes)) {
+        routes = routesOrApp.routes;
+    }
+    const title = config.title || 'ExisJS API Documentation';
+    const version = config.version || '1.0.0';
+    const description = config.description ||
+        'Auto-generated API documentation with native schema validation';
+    const paths = {};
+    const componentsSchemas = {};
+    for (const route of routes) {
+        // Check if route or schema is explicitly excluded
+        const schema = route.schema;
+        if (schema?.excludeFromDocs)
+            continue;
+        if (route.excludeFromDocs)
+            continue;
+        const methodLower = route.method.toLowerCase();
+        if (methodLower === 'options' || methodLower === 'head')
+            continue;
+        const methods = methodLower === 'all'
+            ? ['get', 'post', 'put', 'patch', 'delete']
+            : [methodLower];
+        const openApiPath = normalizeOpenApiPath(route.path);
+        if (!paths[openApiPath]) {
+            paths[openApiPath] = {};
+        }
+        // Parameters
+        const pathParams = extractPathParameters(route.path, schema?.params);
+        const queryParams = extractQueryParameters(schema?.query);
+        const headerParams = extractHeaderParameters(schema?.headers);
+        const allParameters = [
+            ...pathParams,
+            ...queryParams,
+            ...headerParams,
+        ];
+        // Request Body
+        let requestBody;
+        if (schema?.body &&
+            (methods.includes('post') ||
+                methods.includes('put') ||
+                methods.includes('patch'))) {
+            const bodySchema = schemaToOpenApi(schema.body);
+            requestBody = {
+                required: true,
+                content: {
+                    'application/json': {
+                        schema: bodySchema,
+                    },
+                },
+            };
+        }
+        else if (schema?.upload) {
+            requestBody = {
+                required: true,
+                content: {
+                    'multipart/form-data': {
+                        schema: {
+                            type: 'object',
+                            properties: {
+                                file: {
+                                    type: 'string',
+                                    format: 'binary',
+                                },
+                            },
+                        },
+                    },
+                },
+            };
+        }
+        // Responses
+        const responses = {};
+        if (schema?.responses) {
+            for (const [code, respDef] of Object.entries(schema.responses)) {
+                const respSchema = respDef.schema
+                    ? schemaToOpenApi(respDef.schema)
+                    : undefined;
+                responses[String(code)] = {
+                    description: respDef.description || `HTTP ${code} Response`,
+                    ...(respSchema
+                        ? {
+                            content: {
+                                'application/json': {
+                                    schema: respSchema,
+                                },
+                            },
+                        }
+                        : {}),
+                };
+            }
+        }
+        if (schema?.response && Object.keys(responses).length === 0) {
+            const resSchema = schemaToOpenApi(schema.response);
+            responses['200'] = {
+                description: 'Successful operation',
+                content: {
+                    'application/json': {
+                        schema: resSchema,
+                    },
+                },
+            };
+        }
+        if (Object.keys(responses).length === 0) {
+            responses['200'] = {
+                description: 'Successful operation',
+            };
+        }
+        // Inherited / route tags
+        const tags = schema?.tags && Array.isArray(schema.tags)
+            ? schema.tags
+            : deriveDefaultTag(route.path);
+        for (const m of methods) {
+            const operation = {
+                tags,
+                summary: schema?.summary || `${m.toUpperCase()} ${route.path}`,
+                description: schema?.description,
+                operationId: schema?.operationId ||
+                    `${m}_${route.path.replace(/[^a-zA-Z0-9]/g, '_')}`,
+                deprecated: schema?.deprecated,
+                parameters: allParameters.length > 0 ? allParameters : undefined,
+                requestBody,
+                responses,
+                security: schema?.security || config.security,
+                externalDocs: schema?.externalDocs,
+            };
+            paths[openApiPath][m] = operation;
+        }
+    }
+    const spec = {
+        openapi: '3.1.0',
+        info: {
+            title,
+            version,
+            description,
+            termsOfService: config.termsOfService,
+            contact: config.contact,
+            license: config.license,
+        },
+        servers: config.servers || [{ url: '/', description: 'Default Server' }],
+        tags: config.tags,
+        paths,
+        components: {
+            schemas: Object.keys(componentsSchemas).length > 0
+                ? componentsSchemas
+                : undefined,
+            securitySchemes: config.securitySchemes,
+        },
+        security: config.security,
+    };
+    if (typeof config.transformSpec === 'function') {
+        const transformed = config.transformSpec(spec);
+        if (transformed)
+            return transformed;
+    }
+    return spec;
+}
+function deriveDefaultTag(path) {
+    const parts = path.split('/').filter(Boolean);
+    if (parts.length > 0 &&
+        !parts[0].startsWith(':') &&
+        !parts[0].startsWith('[')) {
+        const formatted = parts[0].charAt(0).toUpperCase() + parts[0].slice(1);
+        return [formatted];
+    }
+    return ['General'];
+}
+//# sourceMappingURL=generator.js.map

package/dist/swagger/generator.js.map

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