@riktajs/swagger 0.1.0

package/dist/openapi/generator.js

@@ -0,0 +1,493 @@
+import 'reflect-metadata';
+import { ParamType, 
+// Metadata helper functions
+getControllerMetadata, getRoutes, getParamMetadata as getCoreParamMetadata, getHttpCode, getClassMetadata, getMethodMetadata, } from '@riktajs/core';
+import { API_TAGS_METADATA, API_OPERATION_METADATA, API_RESPONSE_METADATA, API_BODY_METADATA, API_PARAM_METADATA, API_QUERY_METADATA, API_HEADER_METADATA, API_SECURITY_METADATA, API_EXCLUDE_METADATA, API_DEPRECATED_METADATA, } from '../constants.js';
+import { zodToOpenApi, toOpenApiSchema } from './zod-to-openapi.js';
+/**
+ * Default swagger config values
+ */
+const DEFAULT_SWAGGER_CONFIG = {
+    info: {
+        title: 'API Documentation',
+        version: '1.0.0',
+    },
+};
+/**
+ * OpenAPI Specification Generator
+ *
+ * Collects metadata from controllers and generates a complete
+ * OpenAPI 3.0.3 specification document.
+ *
+ * @example
+ * ```typescript
+ * const generator = new OpenApiGenerator({
+ *   info: {
+ *     title: 'My API',
+ *     version: '1.0.0',
+ *   },
+ * });
+ *
+ * // Add controllers to scan
+ * generator.addController(UserController);
+ * generator.addController(ProductController);
+ *
+ * // Generate the specification
+ * const spec = generator.generate();
+ * ```
+ */
+export class OpenApiGenerator {
+    config;
+    controllers = [];
+    globalSecuritySchemes = new Map();
+    constructor(config = {}) {
+        // Build info object from shorthand or full info
+        const info = config.info ?? {
+            title: config.title ?? DEFAULT_SWAGGER_CONFIG.info?.title ?? 'API Documentation',
+            version: config.version ?? DEFAULT_SWAGGER_CONFIG.info?.version ?? '1.0.0',
+            description: config.description,
+            contact: config.contact,
+            license: config.license,
+            termsOfService: config.termsOfService,
+        };
+        // Extract remaining config (excluding shorthand properties)
+        const { title, version, description, contact, license, termsOfService, ...restConfig } = config;
+        this.config = {
+            ...DEFAULT_SWAGGER_CONFIG,
+            ...restConfig,
+            info,
+        };
+    }
+    /**
+     * Add a controller to be documented
+     */
+    addController(controller) {
+        this.controllers.push(controller);
+        return this;
+    }
+    /**
+     * Add multiple controllers
+     */
+    addControllers(controllers) {
+        this.controllers.push(...controllers);
+        return this;
+    }
+    /**
+     * Add a global security scheme
+     */
+    addSecurityScheme(name, scheme) {
+        this.globalSecuritySchemes.set(name, scheme);
+        return this;
+    }
+    /**
+     * Generate the OpenAPI specification document
+     */
+    generate() {
+        const paths = {};
+        const tags = [];
+        const seenTags = new Set();
+        for (const controller of this.controllers) {
+            // Check if controller is excluded
+            if (this.isControllerExcluded(controller)) {
+                continue;
+            }
+            const controllerMeta = this.getControllerMeta(controller);
+            if (!controllerMeta)
+                continue;
+            const controllerTags = this.getControllerTags(controller);
+            const controllerDeprecated = this.isControllerDeprecated(controller);
+            // Add controller tags to the global tags list
+            for (const tag of controllerTags) {
+                if (!seenTags.has(tag)) {
+                    seenTags.add(tag);
+                    tags.push({ name: tag });
+                }
+            }
+            // Process each route
+            const routes = this.getControllerRoutes(controller);
+            for (const route of routes) {
+                // Check if endpoint is excluded
+                if (this.isEndpointExcluded(controller, route.handlerName)) {
+                    continue;
+                }
+                const fullPath = this.normalizePath(controllerMeta.prefix, route.path);
+                const method = route.method.toLowerCase();
+                if (!paths[fullPath]) {
+                    paths[fullPath] = {};
+                }
+                const operation = this.buildOperation(controller, route, controllerTags, controllerDeprecated);
+                // Assign operation to the path item using method as key
+                paths[fullPath][method] = operation;
+            }
+        }
+        // Build security schemes from global and controller-level definitions
+        const securitySchemes = this.buildSecuritySchemes();
+        const document = {
+            openapi: '3.0.3',
+            info: this.config.info,
+            paths,
+        };
+        if (tags.length > 0) {
+            document.tags = tags;
+        }
+        if (this.config.servers && this.config.servers.length > 0) {
+            document.servers = this.config.servers;
+        }
+        if (Object.keys(securitySchemes).length > 0) {
+            document.components = {
+                ...document.components,
+                securitySchemes,
+            };
+        }
+        if (this.config.externalDocs) {
+            document.externalDocs = this.config.externalDocs;
+        }
+        return document;
+    }
+    // ============================================================================
+    // Private: Metadata Getters (using core helpers)
+    // ============================================================================
+    getControllerMeta(controller) {
+        return getControllerMetadata(controller);
+    }
+    getControllerRoutes(controller) {
+        return getRoutes(controller);
+    }
+    getControllerTags(controller) {
+        return getClassMetadata(API_TAGS_METADATA, controller) || [];
+    }
+    isControllerExcluded(controller) {
+        return getClassMetadata(API_EXCLUDE_METADATA, controller) === true;
+    }
+    isControllerDeprecated(controller) {
+        return getClassMetadata(API_DEPRECATED_METADATA, controller) === true;
+    }
+    isEndpointExcluded(controller, handlerName) {
+        return getMethodMetadata(API_EXCLUDE_METADATA, controller, handlerName) === true;
+    }
+    isEndpointDeprecated(controller, handlerName) {
+        const controllerLevel = getClassMetadata(API_DEPRECATED_METADATA, controller);
+        const methodLevel = getMethodMetadata(API_DEPRECATED_METADATA, controller, handlerName);
+        return controllerLevel?.deprecated === true || methodLevel?.deprecated === true;
+    }
+    getOperationMetadata(controller, handlerName) {
+        return getMethodMetadata(API_OPERATION_METADATA, controller, handlerName);
+    }
+    getResponseMetadata(controller, handlerName) {
+        return getMethodMetadata(API_RESPONSE_METADATA, controller, handlerName) || [];
+    }
+    getBodyMetadata(controller, handlerName) {
+        return getMethodMetadata(API_BODY_METADATA, controller, handlerName);
+    }
+    getSwaggerParamMetadata(controller, handlerName) {
+        return getMethodMetadata(API_PARAM_METADATA, controller, handlerName) || [];
+    }
+    getQueryMetadata(controller, handlerName) {
+        return getMethodMetadata(API_QUERY_METADATA, controller, handlerName) || [];
+    }
+    getHeaderMetadata(controller, handlerName) {
+        return getMethodMetadata(API_HEADER_METADATA, controller, handlerName) || [];
+    }
+    getSecurityMetadata(controller, handlerName) {
+        const controllerLevel = getClassMetadata(API_SECURITY_METADATA, controller);
+        const methodLevel = getMethodMetadata(API_SECURITY_METADATA, controller, handlerName);
+        const result = [];
+        // Controller level can be a single object or null (to remove security)
+        if (controllerLevel && typeof controllerLevel === 'object' && 'name' in controllerLevel) {
+            result.push(controllerLevel);
+        }
+        else if (Array.isArray(controllerLevel)) {
+            result.push(...controllerLevel);
+        }
+        // Method level can override or add to controller level
+        if (methodLevel && typeof methodLevel === 'object' && 'name' in methodLevel) {
+            result.push(methodLevel);
+        }
+        else if (Array.isArray(methodLevel)) {
+            result.push(...methodLevel);
+        }
+        return result;
+    }
+    getMethodTags(controller, handlerName) {
+        const operation = this.getOperationMetadata(controller, handlerName);
+        return operation?.tags;
+    }
+    getHttpStatusCode(controller, handlerName) {
+        return getHttpCode(controller, handlerName);
+    }
+    getCoreParams(controller, handlerName) {
+        return getCoreParamMetadata(controller, handlerName);
+    }
+    // ============================================================================
+    // Private: Path Utilities
+    // ============================================================================
+    normalizePath(prefix, path) {
+        // Ensure prefix starts with / and path handling
+        let fullPath = '';
+        if (prefix) {
+            fullPath = prefix.startsWith('/') ? prefix : `/${prefix}`;
+        }
+        if (path) {
+            const cleanPath = path.startsWith('/') ? path : `/${path}`;
+            fullPath = fullPath + cleanPath;
+        }
+        // Handle root path
+        if (!fullPath) {
+            fullPath = '/';
+        }
+        // Convert :param to {param} (Fastify to OpenAPI format)
+        fullPath = fullPath.replace(/:([^/]+)/g, '{$1}');
+        // Remove trailing slash (except for root)
+        if (fullPath !== '/' && fullPath.endsWith('/')) {
+            fullPath = fullPath.slice(0, -1);
+        }
+        return fullPath;
+    }
+    // ============================================================================
+    // Private: Operation Builder
+    // ============================================================================
+    buildOperation(controller, route, controllerTags, controllerDeprecated) {
+        const handlerName = route.handlerName;
+        const operationMeta = this.getOperationMetadata(controller, handlerName);
+        const methodTags = this.getMethodTags(controller, handlerName);
+        const operation = {
+            responses: {},
+        };
+        // Tags (method level overrides controller level)
+        const tags = methodTags || controllerTags;
+        if (tags.length > 0) {
+            operation.tags = tags;
+        }
+        // Summary and description from @ApiOperation
+        if (operationMeta?.summary) {
+            operation.summary = operationMeta.summary;
+        }
+        if (operationMeta?.description) {
+            operation.description = operationMeta.description;
+        }
+        if (operationMeta?.operationId) {
+            operation.operationId = operationMeta.operationId;
+        }
+        // Deprecated flag
+        if (controllerDeprecated || operationMeta?.deprecated || this.isEndpointDeprecated(controller, handlerName)) {
+            operation.deprecated = true;
+        }
+        // Parameters (path, query, header)
+        const parameters = this.buildParameters(controller, handlerName, route.path);
+        if (parameters.length > 0) {
+            operation.parameters = parameters;
+        }
+        // Request body (for POST, PUT, PATCH)
+        if (['POST', 'PUT', 'PATCH'].includes(route.method)) {
+            const requestBody = this.buildRequestBody(controller, handlerName);
+            if (requestBody) {
+                operation.requestBody = requestBody;
+            }
+        }
+        // Responses
+        operation.responses = this.buildResponses(controller, handlerName, route.statusCode);
+        // Security
+        const security = this.getSecurityMetadata(controller, handlerName);
+        if (security.length > 0) {
+            operation.security = security.map(s => ({ [s.name]: s.scopes || [] }));
+        }
+        return operation;
+    }
+    buildParameters(controller, handlerName, routePath) {
+        const parameters = [];
+        // Extract path parameters from route pattern
+        const pathParams = this.extractPathParams(routePath);
+        const paramDecorators = this.getSwaggerParamMetadata(controller, handlerName);
+        const queryDecorators = this.getQueryMetadata(controller, handlerName);
+        const headerDecorators = this.getHeaderMetadata(controller, handlerName);
+        const coreParams = this.getCoreParams(controller, handlerName);
+        // Add path parameters from decorator metadata or extract from path
+        const usedPathParams = new Set();
+        for (const param of paramDecorators) {
+            usedPathParams.add(param.name);
+            const baseSchema = toOpenApiSchema(param.schema);
+            const fallbackSchema = {
+                type: param.type || 'string'
+            };
+            if (param.format) {
+                fallbackSchema.format = param.format;
+            }
+            parameters.push({
+                name: param.name,
+                in: 'path',
+                required: true, // Path params are always required
+                deprecated: param.deprecated,
+                description: param.description,
+                schema: baseSchema || fallbackSchema,
+                example: param.example,
+            });
+        }
+        // Add any path parameters not covered by decorators
+        for (const paramName of pathParams) {
+            if (!usedPathParams.has(paramName)) {
+                // Check if there's a Zod schema for this parameter
+                const coreParam = coreParams.find(p => p.type === ParamType.PARAM && p.key === paramName);
+                const schema = coreParam?.zodSchema ? zodToOpenApi(coreParam.zodSchema) : { type: 'string' };
+                parameters.push({
+                    name: paramName,
+                    in: 'path',
+                    required: true,
+                    schema,
+                });
+            }
+        }
+        // Add query parameters
+        for (const query of queryDecorators) {
+            const baseSchema = toOpenApiSchema(query.schema);
+            const fallbackSchema = {
+                type: query.type || 'string'
+            };
+            if (query.format) {
+                fallbackSchema.format = query.format;
+            }
+            parameters.push({
+                name: query.name,
+                in: 'query',
+                required: query.required,
+                deprecated: query.deprecated,
+                description: query.description,
+                schema: baseSchema || fallbackSchema,
+                example: query.example,
+            });
+        }
+        // Add header parameters
+        for (const header of headerDecorators) {
+            parameters.push({
+                name: header.name,
+                in: 'header',
+                required: header.required,
+                deprecated: header.deprecated,
+                description: header.description,
+                schema: toOpenApiSchema(header.schema) || {
+                    type: header.type || 'string'
+                },
+                example: header.example,
+            });
+        }
+        return parameters;
+    }
+    extractPathParams(path) {
+        const params = [];
+        // Match both :param (Fastify) and {param} (OpenAPI) formats
+        const regex = /:([^/]+)|{([^}]+)}/g;
+        let match;
+        while ((match = regex.exec(path)) !== null) {
+            const paramName = match[1] ?? match[2];
+            if (paramName) {
+                params.push(paramName);
+            }
+        }
+        return params;
+    }
+    buildRequestBody(controller, handlerName) {
+        const bodyMeta = this.getBodyMetadata(controller, handlerName);
+        const coreParams = this.getCoreParams(controller, handlerName);
+        // Check for @ApiBody decorator first
+        if (bodyMeta) {
+            const schema = toOpenApiSchema(bodyMeta.schema);
+            return {
+                description: bodyMeta.description,
+                required: bodyMeta.required ?? true,
+                content: {
+                    [bodyMeta.type || 'application/json']: {
+                        schema: bodyMeta.isArray && schema ? { type: 'array', items: schema } : schema,
+                        example: bodyMeta.example,
+                    },
+                },
+            };
+        }
+        // Fallback: check for @Body() decorator with Zod schema
+        const bodyParam = coreParams.find(p => p.type === ParamType.BODY);
+        if (bodyParam?.zodSchema) {
+            return {
+                required: true,
+                content: {
+                    'application/json': {
+                        schema: zodToOpenApi(bodyParam.zodSchema),
+                    },
+                },
+            };
+        }
+        return undefined;
+    }
+    buildResponses(controller, handlerName, defaultStatusCode) {
+        const responses = {};
+        const responseMeta = this.getResponseMetadata(controller, handlerName);
+        const httpCode = this.getHttpStatusCode(controller, handlerName);
+        if (responseMeta.length > 0) {
+            for (const response of responseMeta) {
+                const statusCode = response.status.toString();
+                const schema = toOpenApiSchema(response.schema);
+                responses[statusCode] = {
+                    description: response.description || this.getDefaultStatusDescription(response.status),
+                };
+                if (schema || response.example) {
+                    responses[statusCode].content = {
+                        [response.type || 'application/json']: {
+                            schema: response.isArray && schema ? { type: 'array', items: schema } : schema,
+                            example: response.example,
+                        },
+                    };
+                }
+            }
+        }
+        else {
+            // Add default response based on HTTP code
+            const status = (httpCode || defaultStatusCode || 200).toString();
+            responses[status] = {
+                description: this.getDefaultStatusDescription(Number(status)),
+            };
+        }
+        return responses;
+    }
+    getDefaultStatusDescription(status) {
+        const descriptions = {
+            200: 'Successful response',
+            201: 'Resource created successfully',
+            204: 'No content',
+            400: 'Bad request',
+            401: 'Unauthorized',
+            403: 'Forbidden',
+            404: 'Not found',
+            409: 'Conflict',
+            422: 'Unprocessable entity',
+            500: 'Internal server error',
+        };
+        return descriptions[status] || 'Response';
+    }
+    buildSecuritySchemes() {
+        const schemes = {};
+        for (const [name, options] of this.globalSecuritySchemes) {
+            schemes[name] = {
+                type: options.type,
+                description: options.description,
+            };
+            if (options.type === 'apiKey') {
+                schemes[name].name = options.name;
+                schemes[name].in = options.in;
+            }
+            else if (options.type === 'http') {
+                schemes[name].scheme = options.scheme;
+                if (options.bearerFormat) {
+                    schemes[name].bearerFormat = options.bearerFormat;
+                }
+            }
+            else if (options.type === 'oauth2' && options.flows) {
+                schemes[name].flows = options.flows;
+            }
+        }
+        return schemes;
+    }
+}
+/**
+ * Create a new OpenAPI generator instance
+ */
+export function createOpenApiGenerator(config) {
+    return new OpenApiGenerator(config);
+}
+//# sourceMappingURL=generator.js.map

package/dist/openapi/generator.js.map

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

package/dist/openapi/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * OpenAPI generation utilities barrel export
+ *
+ * @packageDocumentation
+ */
+export { zodToOpenApi, isZodSchema, toOpenApiSchema } from './zod-to-openapi.js';
+export { OpenApiGenerator, createOpenApiGenerator } from './generator.js';
+//# 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":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGjF,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/openapi/index.js

@@ -0,0 +1,11 @@
+/**
+ * OpenAPI generation utilities barrel export
+ *
+ * @packageDocumentation
+ */
+// Zod to OpenAPI converter
+export { zodToOpenApi, isZodSchema, toOpenApiSchema } from './zod-to-openapi.js';
+// OpenAPI specification generator
+export { OpenApiGenerator, createOpenApiGenerator } from './generator.js';
+// export * from './generator.js';
+//# 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":"AAAA;;;;GAIG;AAEH,2BAA2B;AAC3B,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEjF,kCAAkC;AAClC,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC1E,kCAAkC"}

package/dist/openapi/zod-to-openapi.d.ts

@@ -0,0 +1,52 @@
+import type { ZodType, ZodTypeDef } from 'zod';
+import type { OpenApiSchemaObject } from '../types.js';
+/**
+ * Type guard to check if a value is a Zod schema
+ * Uses duck typing to detect Zod schemas without requiring the full library
+ */
+export declare function isZodSchema(value: unknown): value is ZodType<unknown, ZodTypeDef, unknown>;
+/**
+ * Convert a Zod schema to an OpenAPI 3.0 schema object
+ *
+ * Uses `zod-to-json-schema` for the heavy lifting, then converts
+ * JSON Schema 7 to OpenAPI 3.0 compatible format.
+ *
+ * Supports all Zod types including:
+ * - Primitives: string, number, boolean, bigint
+ * - Complex: object, array, tuple, record
+ * - Modifiers: optional, nullable, default
+ * - Validators: min, max, email, uuid, url, etc.
+ * - Enums: enum, nativeEnum
+ * - Unions and intersections
+ * - Literals
+ * - Effects (transform, refine)
+ *
+ * @param schema - The Zod schema to convert
+ * @returns OpenAPI schema object
+ *
+ * @example
+ * ```typescript
+ * const UserSchema = z.object({
+ *   id: z.string().uuid(),
+ *   email: z.string().email(),
+ *   age: z.number().int().min(0).optional(),
+ * });
+ *
+ * const openApiSchema = zodToOpenApi(UserSchema);
+ * // {
+ * //   type: 'object',
+ * //   properties: {
+ * //     id: { type: 'string', format: 'uuid' },
+ * //     email: { type: 'string', format: 'email' },
+ * //     age: { type: 'integer', minimum: 0 }
+ * //   },
+ * //   required: ['id', 'email']
+ * // }
+ * ```
+ */
+export declare function zodToOpenApi(schema: ZodType): OpenApiSchemaObject;
+/**
+ * Convert a Zod schema to OpenAPI schema, or pass through if already an OpenAPI schema
+ */
+export declare function toOpenApiSchema(schemaOrOpenApi: ZodType | OpenApiSchemaObject | undefined): OpenApiSchemaObject | undefined;
+//# sourceMappingURL=zod-to-openapi.d.ts.map

package/dist/openapi/zod-to-openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-to-openapi.d.ts","sourceRoot":"","sources":["../../src/openapi/zod-to-openapi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAE/C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,CAQ1F;AAyGD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,mBAAmB,CAWjE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,eAAe,EAAE,OAAO,GAAG,mBAAmB,GAAG,SAAS,GACzD,mBAAmB,GAAG,SAAS,CAWjC"}