@miiajs/swagger 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ruslan Matiushev
+
+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/README.md

@@ -0,0 +1,17 @@
+# @miiajs/swagger
+
+OpenAPI 3.1 spec generation and Swagger UI for MiiaJS.
+
+## Installation
+
+```bash
+npm install @miiajs/swagger swagger-ui-dist
+```
+
+## Documentation
+
+**[miiajs.com/docs/packages/swagger](https://miiajs.com/docs/packages/swagger)**
+
+## License
+
+MIT

package/dist/builder/index.d.ts

@@ -0,0 +1,5 @@
+export { SpecBuilder } from './spec-builder.js';
+export type { DiscoveredController } from './spec-builder.js';
+export { convertSchema } from './schema-converter.js';
+export { toOpenApiPath, extractPathParams } from './path-converter.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/builder/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/builder/index.js

@@ -0,0 +1,4 @@
+export { SpecBuilder } from './spec-builder.js';
+export { convertSchema } from './schema-converter.js';
+export { toOpenApiPath, extractPathParams } from './path-converter.js';
+//# sourceMappingURL=index.js.map

package/dist/builder/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/builder/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/builder/path-converter.d.ts

@@ -0,0 +1,3 @@
+export declare function toOpenApiPath(path: string): string;
+export declare function extractPathParams(path: string): string[];
+//# sourceMappingURL=path-converter.d.ts.map

package/dist/builder/path-converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-converter.d.ts","sourceRoot":"","sources":["../../src/builder/path-converter.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAExD"}

package/dist/builder/path-converter.js

@@ -0,0 +1,9 @@
+export function toOpenApiPath(path) {
+    const normalized = path.replace(/\/+/g, '/').replace(/^\/+|\/+$/g, '');
+    const converted = normalized.replace(/:(\w+)/g, '{$1}');
+    return '/' + converted;
+}
+export function extractPathParams(path) {
+    return [...path.matchAll(/:(\w+)/g)].map((m) => m[1]);
+}
+//# sourceMappingURL=path-converter.js.map

package/dist/builder/path-converter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-converter.js","sourceRoot":"","sources":["../../src/builder/path-converter.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAA;IACtE,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;IACvD,OAAO,GAAG,GAAG,SAAS,CAAA;AACxB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AACvD,CAAC"}

package/dist/builder/schema-converter.d.ts

@@ -0,0 +1,3 @@
+import type { JsonSchema } from '../types.js';
+export declare function convertSchema(schema: unknown): JsonSchema;
+//# sourceMappingURL=schema-converter.d.ts.map

package/dist/builder/schema-converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-converter.d.ts","sourceRoot":"","sources":["../../src/builder/schema-converter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,UAAU,CA2BzD"}

package/dist/builder/schema-converter.js

@@ -0,0 +1,234 @@
+export function convertSchema(schema) {
+    if (!schema || typeof schema !== 'object')
+        return { type: 'object' };
+    // 1. Zod 4+ native toJsonSchema() (future-proof)
+    if ('toJsonSchema' in schema && typeof schema.toJsonSchema === 'function') {
+        return schema.toJsonSchema();
+    }
+    // 2. Already a JSON Schema object (has 'type' but no '_def')
+    if ('type' in schema && !('_def' in schema)) {
+        return schema;
+    }
+    // 3. Zod schema (has '_def')
+    if ('_def' in schema) {
+        const def = schema._def;
+        // Zod 4: _def.type is a string ("object", "string", etc.)
+        if (def.type && typeof def.type === 'string') {
+            return convertZod4(schema);
+        }
+        // Zod 3: _def.typeName is "ZodObject", "ZodString", etc.
+        if (def.typeName) {
+            return convertZod3Def(def);
+        }
+    }
+    return { type: 'object' };
+}
+// ─── Zod 4 Converter ───────────────────────────────────────────
+function convertZod4(schema) {
+    const def = schema._def;
+    const result = {};
+    if (schema.description)
+        result.description = schema.description;
+    switch (def.type) {
+        case 'object':
+            return convertZod4Object(def, result);
+        case 'string':
+            return convertZod4String(schema, result);
+        case 'number':
+            return convertZod4Number(schema, result);
+        case 'boolean':
+            return { ...result, type: 'boolean' };
+        case 'array':
+            return { ...result, type: 'array', items: def.element ? convertZod4(def.element) : {} };
+        case 'enum':
+            return { ...result, type: 'string', enum: Object.values(def.entries) };
+        case 'literal':
+            return { ...result, const: def.value };
+        case 'optional':
+            return def.innerType ? convertZod4(def.innerType) : { ...result, type: 'object' };
+        case 'nullable': {
+            const inner = def.innerType ? convertZod4(def.innerType) : { type: 'object' };
+            return { ...inner, ...result, type: [inner.type ?? 'object', 'null'] };
+        }
+        case 'default': {
+            const inner = def.innerType ? convertZod4(def.innerType) : { type: 'object' };
+            return { ...inner, ...result, default: def.defaultValue };
+        }
+        case 'union':
+            return {
+                ...result,
+                anyOf: (def.options ?? []).map((opt) => convertZod4(opt)),
+            };
+        default:
+            return { ...result, type: 'object' };
+    }
+}
+function convertZod4Object(def, base) {
+    const shape = def.shape ?? {};
+    const properties = {};
+    const required = [];
+    for (const [key, value] of Object.entries(shape)) {
+        const v = value;
+        properties[key] = convertZod4(v);
+        if (v._def?.type !== 'optional' && v._def?.type !== 'default') {
+            required.push(key);
+        }
+    }
+    return {
+        ...base,
+        type: 'object',
+        properties,
+        ...(required.length > 0 && { required }),
+    };
+}
+function convertZod4String(schema, base) {
+    const result = { ...base, type: 'string' };
+    if (schema.format) {
+        const formatMap = {
+            email: 'email',
+            url: 'uri',
+            uri: 'uri',
+            uuid: 'uuid',
+            datetime: 'date-time',
+            date: 'date',
+            time: 'time',
+            ip: 'ip',
+        };
+        result.format = formatMap[schema.format] ?? schema.format;
+    }
+    if (schema.minLength != null)
+        result.minLength = schema.minLength;
+    if (schema.maxLength != null)
+        result.maxLength = schema.maxLength;
+    return result;
+}
+function convertZod4Number(schema, base) {
+    const result = { ...base };
+    result.type = schema.isInt ? 'integer' : 'number';
+    if (schema.minValue !== null &&
+        schema.minValue !== undefined &&
+        isFinite(schema.minValue) &&
+        schema.minValue !== -Number.MAX_SAFE_INTEGER &&
+        schema.minValue !== Number.MIN_SAFE_INTEGER) {
+        result.minimum = schema.minValue;
+    }
+    if (schema.maxValue !== null &&
+        schema.maxValue !== undefined &&
+        isFinite(schema.maxValue) &&
+        schema.maxValue !== Number.MAX_SAFE_INTEGER) {
+        result.maximum = schema.maxValue;
+    }
+    return result;
+}
+// ─── Zod 3 Converter ───────────────────────────────────────────
+function convertZod3Def(def) {
+    if (!def || !def.typeName)
+        return { type: 'object' };
+    const result = {};
+    if (def.description)
+        result.description = def.description;
+    switch (def.typeName) {
+        case 'ZodObject':
+            return convertZod3Object(def, result);
+        case 'ZodString':
+            return convertZod3String(def, result);
+        case 'ZodNumber':
+            return convertZod3Number(def, result);
+        case 'ZodBoolean':
+            return { ...result, type: 'boolean' };
+        case 'ZodArray': {
+            const itemsDef = def.type?._def ?? def.type;
+            return { ...result, type: 'array', items: itemsDef ? convertZod3Def(itemsDef) : {} };
+        }
+        case 'ZodEnum':
+            return { ...result, type: 'string', enum: def.values };
+        case 'ZodNativeEnum':
+            return { ...result, enum: Object.values(def.values) };
+        case 'ZodLiteral':
+            return { ...result, const: def.value };
+        case 'ZodOptional':
+            return convertZod3Def(def.innerType?._def ?? def.innerType);
+        case 'ZodNullable': {
+            const inner = convertZod3Def(def.innerType?._def ?? def.innerType);
+            return { ...inner, ...result, type: [inner.type ?? 'object', 'null'] };
+        }
+        case 'ZodDefault': {
+            const inner = convertZod3Def(def.innerType?._def ?? def.innerType);
+            return { ...inner, ...result, default: def.defaultValue() };
+        }
+        case 'ZodUnion':
+        case 'ZodDiscriminatedUnion':
+            return {
+                ...result,
+                anyOf: (def.options ?? []).map((opt) => convertZod3Def(opt._def ?? opt)),
+            };
+        case 'ZodEffects':
+            return convertZod3Def(def.schema?._def ?? def.schema);
+        default:
+            return { ...result, type: 'object' };
+    }
+}
+function convertZod3Object(def, base) {
+    const shape = typeof def.shape === 'function' ? def.shape() : (def.shape ?? {});
+    const properties = {};
+    const required = [];
+    for (const [key, value] of Object.entries(shape)) {
+        const fieldDef = value?._def;
+        properties[key] = convertZod3Def(fieldDef ?? value);
+        if (fieldDef?.typeName !== 'ZodOptional' && fieldDef?.typeName !== 'ZodDefault') {
+            required.push(key);
+        }
+    }
+    return {
+        ...base,
+        type: 'object',
+        properties,
+        ...(required.length > 0 && { required }),
+    };
+}
+function convertZod3String(def, base) {
+    const result = { ...base, type: 'string' };
+    for (const check of def.checks ?? []) {
+        switch (check.kind) {
+            case 'email':
+                result.format = 'email';
+                break;
+            case 'url':
+                result.format = 'uri';
+                break;
+            case 'uuid':
+                result.format = 'uuid';
+                break;
+            case 'datetime':
+                result.format = 'date-time';
+                break;
+            case 'min':
+                result.minLength = check.value;
+                break;
+            case 'max':
+                result.maxLength = check.value;
+                break;
+        }
+    }
+    return result;
+}
+function convertZod3Number(def, base) {
+    const result = { ...base };
+    let isInteger = false;
+    for (const check of def.checks ?? []) {
+        switch (check.kind) {
+            case 'int':
+                isInteger = true;
+                break;
+            case 'min':
+                result.minimum = check.value;
+                break;
+            case 'max':
+                result.maximum = check.value;
+                break;
+        }
+    }
+    result.type = isInteger ? 'integer' : 'number';
+    return result;
+}
+//# sourceMappingURL=schema-converter.js.map

package/dist/builder/schema-converter.js.map

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

package/dist/builder/spec-builder.d.ts

@@ -0,0 +1,18 @@
+import type { Constructor } from '@miiajs/core';
+export interface DiscoveredController {
+    controller: Constructor;
+    prefix: string;
+}
+import type { SwaggerSetupOptions } from '../types.js';
+export declare class SpecBuilder {
+    build(controllers: DiscoveredController[], options: SwaggerSetupOptions): Record<string, any>;
+    private processController;
+    private buildParameters;
+    private buildResponses;
+    private buildSecurity;
+    private isExcluded;
+    private getClassSecurity;
+    private getClassHeaders;
+    private getMethodSecurityMap;
+}
+//# sourceMappingURL=spec-builder.d.ts.map

package/dist/builder/spec-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-builder.d.ts","sourceRoot":"","sources":["../../src/builder/spec-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAmC,MAAM,cAAc,CAAA;AAYhF,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,WAAW,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;CACf;AAYD,OAAO,KAAK,EACV,mBAAmB,EASpB,MAAM,aAAa,CAAA;AAIpB,qBAAa,WAAW;IACtB,KAAK,CAAC,WAAW,EAAE,oBAAoB,EAAE,EAAE,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAmC7F,OAAO,CAAC,iBAAiB;IAqGzB,OAAO,CAAC,eAAe;IAoFvB,OAAO,CAAC,cAAc;IA2CtB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,oBAAoB;CAG7B"}

package/dist/builder/spec-builder.js

@@ -0,0 +1,245 @@
+import { getMeta, ROUTES, STATUSES, CLASS_GUARDS, METHOD_GUARDS, BODY_SCHEMAS, QUERY_SCHEMAS, PARAMS_SCHEMAS, } from '@miiajs/core';
+import { API_TAG, API_OPERATIONS, API_RESPONSES, API_PARAMS, API_QUERIES, API_SECURITY, API_HEADERS, API_EXCLUDE, API_BODY_OPTIONS, } from '../constants.js';
+import { convertSchema } from './schema-converter.js';
+import { toOpenApiPath, extractPathParams } from './path-converter.js';
+export class SpecBuilder {
+    build(controllers, options) {
+        const doc = {
+            openapi: '3.1.0',
+            info: {
+                title: options.title,
+                version: options.version,
+                ...(options.description && { description: options.description }),
+            },
+            paths: {},
+            tags: [],
+        };
+        if (options.servers?.length) {
+            doc.servers = options.servers;
+        }
+        if (options.securitySchemes && Object.keys(options.securitySchemes).length) {
+            doc.components = { securitySchemes: options.securitySchemes };
+        }
+        if (options.globalSecurity?.length) {
+            doc.security = options.globalSecurity;
+        }
+        const tagSet = new Set();
+        for (const { controller, prefix } of controllers) {
+            this.processController(doc, controller, prefix, tagSet);
+        }
+        doc.tags = [...tagSet].map((name) => ({ name }));
+        return doc;
+    }
+    processController(doc, controller, prefix, tagSet) {
+        // Check exclude
+        if (this.isExcluded(controller, '*'))
+            return;
+        // Tags
+        const tags = getMeta(controller, API_TAG) ?? [controller.name.replace(/Controller$/, '')];
+        for (const tag of tags)
+            tagSet.add(tag);
+        // Class-level metadata
+        const classGuards = getMeta(controller, CLASS_GUARDS) ?? [];
+        const classSecurity = this.getClassSecurity(controller);
+        const classHeaders = this.getClassHeaders(controller);
+        // Routes
+        const routes = getMeta(controller, ROUTES) ?? [];
+        const statusMap = getMeta(controller, STATUSES);
+        const bodySchemaMap = getMeta(controller, BODY_SCHEMAS);
+        const bodyOptionsMap = getMeta(controller, API_BODY_OPTIONS);
+        const querySchemaMap = getMeta(controller, QUERY_SCHEMAS);
+        const paramsSchemaMap = getMeta(controller, PARAMS_SCHEMAS);
+        const operationMap = getMeta(controller, API_OPERATIONS);
+        const responseMap = getMeta(controller, API_RESPONSES);
+        const paramMap = getMeta(controller, API_PARAMS);
+        const queryMap = getMeta(controller, API_QUERIES);
+        const methodGuardMap = getMeta(controller, METHOD_GUARDS);
+        const methodHeaderMap = getMeta(controller, API_HEADERS);
+        const methodSecurityMap = this.getMethodSecurityMap(controller);
+        for (const route of routes) {
+            if (this.isExcluded(controller, route.handlerName))
+                continue;
+            const fullPath = toOpenApiPath(prefix ? `${prefix}/${route.path}` : route.path);
+            const method = route.method.toLowerCase();
+            const operation = { tags };
+            // Operation metadata
+            const opMeta = operationMap?.get(route.handlerName);
+            if (opMeta?.summary)
+                operation.summary = opMeta.summary;
+            if (opMeta?.description)
+                operation.description = opMeta.description;
+            if (opMeta?.operationId)
+                operation.operationId = opMeta.operationId;
+            if (opMeta?.deprecated)
+                operation.deprecated = true;
+            // Parameters
+            const parameters = this.buildParameters(route, prefix, paramMap?.get(route.handlerName), queryMap?.get(route.handlerName), paramsSchemaMap?.get(route.handlerName), querySchemaMap?.get(route.handlerName), classHeaders, methodHeaderMap?.get(route.handlerName));
+            if (parameters.length)
+                operation.parameters = parameters;
+            // Request body
+            const bodySchema = bodySchemaMap?.get(route.handlerName);
+            if (bodySchema) {
+                const bodyOpts = bodyOptionsMap?.get(route.handlerName);
+                const contentType = bodyOpts?.contentType ?? 'application/json';
+                operation.requestBody = {
+                    required: bodyOpts?.required ?? true,
+                    ...(bodyOpts?.description && { description: bodyOpts.description }),
+                    content: {
+                        [contentType]: {
+                            schema: convertSchema(bodySchema),
+                        },
+                    },
+                };
+            }
+            // Responses
+            const customStatus = statusMap?.get(route.handlerName);
+            const explicitResponses = responseMap?.get(route.handlerName) ?? [];
+            const hasGuards = classGuards.length > 0 || (methodGuardMap?.get(route.handlerName)?.length ?? 0) > 0;
+            const hasValidation = !!bodySchema || !!querySchemaMap?.get(route.handlerName) || !!paramsSchemaMap?.get(route.handlerName);
+            operation.responses = this.buildResponses(customStatus ?? (method === 'post' ? 201 : 200), explicitResponses, hasGuards, hasValidation);
+            // Security
+            const security = this.buildSecurity(classSecurity, methodSecurityMap?.get(route.handlerName));
+            if (security.length)
+                operation.security = security;
+            // Add to paths
+            if (!doc.paths[fullPath])
+                doc.paths[fullPath] = {};
+            doc.paths[fullPath][method] = operation;
+        }
+    }
+    buildParameters(route, prefix, explicitParams, explicitQueries, paramsSchema, querySchema, classHeaders, methodHeaders) {
+        const parameters = [];
+        const fullPath = prefix ? `${prefix}/${route.path}` : route.path;
+        // Path params: explicit > auto-inferred from schema > auto-inferred from path
+        const pathParamNames = extractPathParams(fullPath);
+        const explicitParamNames = new Set((explicitParams ?? []).map((p) => p.name));
+        // Add explicit params first
+        for (const param of explicitParams ?? []) {
+            parameters.push({
+                name: param.name,
+                in: 'path',
+                required: true,
+                ...(param.description && { description: param.description }),
+                schema: param.schema ? convertSchema(param.schema) : { type: 'string' },
+            });
+        }
+        // Auto-infer from schema for non-explicit params
+        const paramsJsonSchema = paramsSchema ? convertSchema(paramsSchema) : null;
+        for (const name of pathParamNames) {
+            if (explicitParamNames.has(name))
+                continue;
+            const propSchema = paramsJsonSchema?.properties?.[name];
+            parameters.push({
+                name,
+                in: 'path',
+                required: true,
+                schema: propSchema ?? { type: 'string' },
+            });
+        }
+        // Query params: explicit > auto-inferred from schema
+        const explicitQueryNames = new Set((explicitQueries ?? []).map((q) => q.name));
+        for (const query of explicitQueries ?? []) {
+            parameters.push({
+                name: query.name,
+                in: 'query',
+                ...(query.required && { required: true }),
+                ...(query.description && { description: query.description }),
+                schema: query.schema ? convertSchema(query.schema) : { type: 'string' },
+            });
+        }
+        // Auto-infer query from schema
+        if (querySchema) {
+            const queryJsonSchema = convertSchema(querySchema);
+            const requiredFields = new Set(queryJsonSchema.required ?? []);
+            for (const [name, propSchema] of Object.entries(queryJsonSchema.properties ?? {})) {
+                if (explicitQueryNames.has(name))
+                    continue;
+                parameters.push({
+                    name,
+                    in: 'query',
+                    ...(requiredFields.has(name) && { required: true }),
+                    ...(propSchema.description && { description: propSchema.description }),
+                    schema: propSchema,
+                });
+            }
+        }
+        // Headers: class-level + method-level
+        for (const header of [...classHeaders, ...(methodHeaders ?? [])]) {
+            parameters.push({
+                name: header.name,
+                in: 'header',
+                ...(header.required && { required: true }),
+                ...(header.description && { description: header.description }),
+                schema: { type: 'string' },
+            });
+        }
+        return parameters;
+    }
+    buildResponses(defaultStatus, explicit, hasGuards, hasValidation) {
+        const responses = {};
+        const explicitStatuses = new Set(explicit.map((r) => r.status));
+        // Default success response
+        if (!explicitStatuses.has(defaultStatus)) {
+            responses[String(defaultStatus)] = {
+                description: defaultStatus === 201 ? 'Created' : 'OK',
+                content: { 'application/json': { schema: {} } },
+            };
+        }
+        // Explicit responses
+        for (const res of explicit) {
+            const entry = {
+                description: res.description ?? statusText(res.status),
+            };
+            if (res.schema) {
+                entry.content = {
+                    'application/json': { schema: convertSchema(res.schema) },
+                };
+            }
+            responses[String(res.status)] = entry;
+        }
+        // Auto-add 403 for guards
+        if (hasGuards && !explicitStatuses.has(403)) {
+            responses['403'] = { description: 'Forbidden' };
+        }
+        // Auto-add 422 for validation
+        if (hasValidation && !explicitStatuses.has(422)) {
+            responses['422'] = { description: 'Unprocessable Entity' };
+        }
+        return responses;
+    }
+    buildSecurity(classSecurity, methodSecurity) {
+        const merged = methodSecurity ?? classSecurity;
+        return merged.map((s) => ({ [s.name]: s.scopes }));
+    }
+    isExcluded(controller, handler) {
+        const set = getMeta(controller, API_EXCLUDE);
+        if (!set)
+            return false;
+        return set.has('*') || set.has(handler);
+    }
+    getClassSecurity(controller) {
+        return getMeta(controller, API_SECURITY)?.get('*') ?? [];
+    }
+    getClassHeaders(controller) {
+        return getMeta(controller, API_HEADERS)?.get('*') ?? [];
+    }
+    getMethodSecurityMap(controller) {
+        return getMeta(controller, API_SECURITY);
+    }
+}
+function statusText(code) {
+    const texts = {
+        200: 'OK',
+        201: 'Created',
+        204: 'No Content',
+        400: 'Bad Request',
+        401: 'Unauthorized',
+        403: 'Forbidden',
+        404: 'Not Found',
+        409: 'Conflict',
+        422: 'Unprocessable Entity',
+        500: 'Internal Server Error',
+    };
+    return texts[code] ?? 'Response';
+}
+//# sourceMappingURL=spec-builder.js.map

package/dist/builder/spec-builder.js.map

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

package/dist/constants.d.ts

@@ -0,0 +1,10 @@
+export declare const API_TAG: unique symbol;
+export declare const API_OPERATIONS: unique symbol;
+export declare const API_RESPONSES: unique symbol;
+export declare const API_PARAMS: unique symbol;
+export declare const API_QUERIES: unique symbol;
+export declare const API_SECURITY: unique symbol;
+export declare const API_HEADERS: unique symbol;
+export declare const API_EXCLUDE: unique symbol;
+export declare const API_BODY_OPTIONS: unique symbol;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,eAAmB,CAAA;AACvC,eAAO,MAAM,cAAc,eAA0B,CAAA;AACrD,eAAO,MAAM,aAAa,eAAyB,CAAA;AACnD,eAAO,MAAM,UAAU,eAAsB,CAAA;AAC7C,eAAO,MAAM,WAAW,eAAuB,CAAA;AAC/C,eAAO,MAAM,YAAY,eAAwB,CAAA;AACjD,eAAO,MAAM,WAAW,eAAuB,CAAA;AAC/C,eAAO,MAAM,WAAW,eAAuB,CAAA;AAC/C,eAAO,MAAM,gBAAgB,eAA2B,CAAA"}