@jsango/openapi 1.0.0

package/dist/public/generator.js

@@ -0,0 +1,217 @@
+import { OpenApiRegistry } from './registry.js';
+import { DuplicateOperationIdError } from './errors.js';
+import { SchemaBuilder } from './schema-builder.js';
+export class OpenApiGenerator {
+    info;
+    version;
+    servers;
+    registry;
+    includeAdmin;
+    defaultSecurity;
+    tags;
+    constructor(options) {
+        this.info = options.info;
+        this.version = options.openapi ?? '3.1.0';
+        this.servers = options.servers ?? [];
+        this.registry = options.registry ?? new OpenApiRegistry();
+        this.includeAdmin = options.includeAdmin ?? false;
+        this.defaultSecurity = options.defaultSecurity;
+        this.tags = options.tags ?? [];
+        // Ensure standard error response schemas are registered in components
+        if (!this.registry.getSchema('ErrorResponse')) {
+            this.registry.registerSchema('ErrorResponse', SchemaBuilder.errorResponse());
+        }
+        if (!this.registry.getSchema('ValidationErrorResponse')) {
+            this.registry.registerSchema('ValidationErrorResponse', SchemaBuilder.validationErrorResponse());
+        }
+    }
+    getRegistry() {
+        return this.registry;
+    }
+    /**
+     * Generates a deterministic OpenApiDocument from the router and registry.
+     */
+    generate(router) {
+        const paths = {};
+        const operationIds = new Map();
+        if (router) {
+            const routes = router.routes();
+            for (const route of routes) {
+                if (this.shouldSkipRoute(route)) {
+                    continue;
+                }
+                const { path, pathParams } = this.normalizePathAndParams(route);
+                const method = route.method.toLowerCase();
+                if (method !== 'get' &&
+                    method !== 'post' &&
+                    method !== 'put' &&
+                    method !== 'patch' &&
+                    method !== 'delete' &&
+                    method !== 'options' &&
+                    method !== 'head') {
+                    continue;
+                }
+                // Get metadata & overrides
+                const routeMeta = route.metadata['openapi'] ?? {};
+                const override = this.registry.getRouteOverride(route.method, route.path);
+                const mergedMeta = { ...routeMeta, ...(override ?? {}) };
+                // Determine operation ID
+                const operationId = mergedMeta.operationId ?? route.routeName ?? this.generateOperationId(route.method, path);
+                // Check for duplicates
+                const existingOp = operationIds.get(operationId);
+                if (existingOp && (existingOp.path !== path || existingOp.method !== route.method)) {
+                    throw new DuplicateOperationIdError(operationId, existingOp.path, existingOp.method, path, route.method);
+                }
+                operationIds.set(operationId, { path, method: route.method });
+                // Merge path parameters with metadata parameters
+                const combinedParams = [
+                    ...pathParams,
+                    ...(mergedMeta.parameters ?? []).filter((p) => p.in !== 'path'),
+                ];
+                // Build operation
+                const operation = {
+                    summary: mergedMeta.summary ?? `${route.method} ${path}`,
+                    description: mergedMeta.description,
+                    operationId,
+                    tags: mergedMeta.tags,
+                    deprecated: mergedMeta.deprecated,
+                    parameters: combinedParams.length > 0 ? combinedParams : undefined,
+                    requestBody: mergedMeta.requestBody,
+                    responses: mergedMeta.responses ?? this.defaultResponses(route.method),
+                    security: mergedMeta.security ?? this.defaultSecurity,
+                };
+                if (!paths[path]) {
+                    paths[path] = {};
+                }
+                paths[path][method] = operation;
+            }
+        }
+        // Sort paths alphabetically for deterministic generation
+        const sortedPaths = {};
+        for (const key of Object.keys(paths).sort()) {
+            sortedPaths[key] = paths[key];
+        }
+        // Build components
+        const components = this.buildComponents();
+        // Collect tags
+        const allTags = [...this.tags, ...this.registry.getAllTags()];
+        const uniqueTags = Array.from(new Map(allTags.map((t) => [t.name, t])).values()).sort((a, b) => a.name.localeCompare(b.name));
+        const doc = {
+            openapi: this.version,
+            info: this.info,
+            ...(this.servers.length > 0 || this.registry.getAllServers().length > 0
+                ? { servers: [...this.servers, ...this.registry.getAllServers()] }
+                : {}),
+            paths: sortedPaths,
+            ...(components ? { components } : {}),
+            ...(this.defaultSecurity ? { security: this.defaultSecurity } : {}),
+            ...(uniqueTags.length > 0 ? { tags: uniqueTags } : {}),
+        };
+        return doc;
+    }
+    shouldSkipRoute(route) {
+        const meta = route.metadata['openapi'];
+        if (meta?.hidden || meta?.excludeFromOpenApi) {
+            return true;
+        }
+        // Exclude admin routes unless explicitly enabled
+        if (!this.includeAdmin &&
+            (route.path.startsWith('/admin') || route.metadata['admin'])) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Normalizes router path syntax (`/users/:id<number>`) to OpenAPI syntax (`/users/{id}`)
+     * and derives path parameter definitions from constraints.
+     */
+    normalizePathAndParams(route) {
+        const pathParams = [];
+        const normalized = route.path.replace(/:([a-zA-Z0-9_]+)(?:<([^>]+)>)?\??/g, (_, name, constraint) => {
+            let schemaType = 'string';
+            let schemaFormat = undefined;
+            if (constraint) {
+                if (constraint === 'number' || constraint === 'int' || constraint === 'integer') {
+                    schemaType = 'integer';
+                }
+                else if (constraint === 'uuid') {
+                    schemaType = 'string';
+                    schemaFormat = 'uuid';
+                }
+                else if (constraint === 'slug') {
+                    schemaType = 'string';
+                }
+            }
+            pathParams.push({
+                name,
+                in: 'path',
+                required: true,
+                schema: {
+                    type: schemaType,
+                    ...(schemaFormat ? { format: schemaFormat } : {}),
+                },
+            });
+            return `{${name}}`;
+        });
+        return { path: normalized, pathParams };
+    }
+    generateOperationId(method, path) {
+        const cleaned = path.replace(/[{}]/g, '').split('/').filter(Boolean).join('_');
+        return `${method.toLowerCase()}_${cleaned || 'root'}`;
+    }
+    defaultResponses(method) {
+        const successStatus = method.toUpperCase() === 'POST' ? '201' : '200';
+        return {
+            [successStatus]: {
+                description: 'Successful response',
+            },
+            '400': {
+                description: 'Bad Request',
+            },
+            '500': {
+                description: 'Internal Server Error',
+            },
+        };
+    }
+    buildComponents() {
+        const schemas = {};
+        const securitySchemes = {};
+        const responses = {};
+        const parameters = {};
+        for (const [key, schema] of this.registry.getAllSchemas().entries()) {
+            schemas[key] = schema;
+        }
+        for (const [key, scheme] of this.registry.getAllSecuritySchemes().entries()) {
+            securitySchemes[key] = scheme;
+        }
+        for (const [key, response] of this.registry.getAllResponses().entries()) {
+            responses[key] = response;
+        }
+        for (const [key, param] of this.registry.getAllParameters().entries()) {
+            parameters[key] = param;
+        }
+        const hasAny = Object.keys(schemas).length > 0 ||
+            Object.keys(securitySchemes).length > 0 ||
+            Object.keys(responses).length > 0 ||
+            Object.keys(parameters).length > 0;
+        if (!hasAny)
+            return undefined;
+        return {
+            ...(Object.keys(schemas).length > 0
+                ? { schemas: schemas }
+                : {}),
+            ...(Object.keys(securitySchemes).length > 0
+                ? {
+                    securitySchemes: securitySchemes,
+                }
+                : {}),
+            ...(Object.keys(responses).length > 0
+                ? { responses: responses }
+                : {}),
+            ...(Object.keys(parameters).length > 0
+                ? { parameters: parameters }
+                : {}),
+        };
+    }
+}
+//# sourceMappingURL=generator.js.map

package/dist/public/generator.js.map

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

package/dist/public/index.d.ts

@@ -0,0 +1,12 @@
+export type { OpenApiVersion, OpenApiInfo, OpenApiContact, OpenApiLicense, OpenApiServer, OpenApiServerVariable, OpenApiParameterIn, OpenApiParameter, OpenApiMediaType, OpenApiRequestBody, OpenApiHeader, OpenApiResponse, OpenApiResponses, OpenApiSecuritySchemeType, OpenApiSecurityScheme, OpenApiSecurityRequirement, OpenApiTag, OpenApiSchema, OpenApiOperation, OpenApiPathItem, OpenApiPaths, OpenApiComponents, OpenApiDocument, OpenApiRouteMetadata, } from './types.js';
+export { OpenApiError, DuplicateOperationIdError, ConflictingSchemaError, InvalidOpenApiDocumentError, } from './errors.js';
+export { OpenApiRegistry } from './registry.js';
+export { SchemaBuilder } from './schema-builder.js';
+export { ValidationAdapter, type ValidationSchemaDescriptor } from './validation-adapter.js';
+export { OrmAdapter, type ModelFieldDescriptor, type ModelMetadataDescriptor, } from './orm-adapter.js';
+export { AdminAdapter, type AdminFieldDescriptor, type AdminResourceDescriptor, } from './admin-adapter.js';
+export { OpenApiGenerator, type OpenApiGeneratorOptions } from './generator.js';
+export { OpenApiValidator } from './validator.js';
+export { OpenApiFormatter } from './formatter.js';
+export { createOpenApiHandler, type OpenApiEndpointOptions } from './endpoint.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/public/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,cAAc,EACd,WAAW,EACX,cAAc,EACd,cAAc,EACd,aAAa,EACb,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,yBAAyB,EACzB,qBAAqB,EACrB,0BAA0B,EAC1B,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,YAAY,EACZ,yBAAyB,EACzB,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,KAAK,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAC7F,OAAO,EACL,UAAU,EACV,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,GAC7B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,YAAY,EACZ,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,GAC7B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,KAAK,sBAAsB,EAAE,MAAM,eAAe,CAAC"}

package/dist/public/index.js

@@ -0,0 +1,11 @@
+export { OpenApiError, DuplicateOperationIdError, ConflictingSchemaError, InvalidOpenApiDocumentError, } from './errors.js';
+export { OpenApiRegistry } from './registry.js';
+export { SchemaBuilder } from './schema-builder.js';
+export { ValidationAdapter } from './validation-adapter.js';
+export { OrmAdapter, } from './orm-adapter.js';
+export { AdminAdapter, } from './admin-adapter.js';
+export { OpenApiGenerator } from './generator.js';
+export { OpenApiValidator } from './validator.js';
+export { OpenApiFormatter } from './formatter.js';
+export { createOpenApiHandler } from './endpoint.js';
+//# sourceMappingURL=index.js.map

package/dist/public/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/public/index.ts"],"names":[],"mappings":"AA2BA,OAAO,EACL,YAAY,EACZ,yBAAyB,EACzB,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAmC,MAAM,yBAAyB,CAAC;AAC7F,OAAO,EACL,UAAU,GAGX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,YAAY,GAGb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAgC,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAA+B,MAAM,eAAe,CAAC"}

package/dist/public/orm-adapter.d.ts

@@ -0,0 +1,28 @@
+import type { OpenApiSchema } from './types.js';
+export interface ModelFieldDescriptor {
+    readonly name: string;
+    readonly type: string;
+    readonly nullable?: boolean | undefined;
+    readonly primaryKey?: boolean | undefined;
+    readonly autoIncrement?: boolean | undefined;
+    readonly defaultValue?: unknown;
+}
+export interface ModelMetadataDescriptor {
+    readonly name: string;
+    readonly tableName?: string | undefined;
+    readonly primaryKey?: string | undefined;
+    readonly fields: readonly ModelFieldDescriptor[];
+}
+export declare class OrmAdapter {
+    /**
+     * Generates a component schema for an ORM model representation.
+     */
+    static toModelSchema(model: ModelMetadataDescriptor): OpenApiSchema;
+    /**
+     * Generates a component schema for creating a new record of the model.
+     * Auto-incrementing or readonly primary keys are excluded or made optional.
+     */
+    static toCreateInputSchema(model: ModelMetadataDescriptor): OpenApiSchema;
+    private static fieldToSchema;
+}
+//# sourceMappingURL=orm-adapter.d.ts.map

package/dist/public/orm-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orm-adapter.d.ts","sourceRoot":"","sources":["../../src/public/orm-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,SAAS,oBAAoB,EAAE,CAAC;CAClD;AAED,qBAAa,UAAU;IACrB;;OAEG;WACW,aAAa,CAAC,KAAK,EAAE,uBAAuB,GAAG,aAAa;IAmB1E;;;OAGG;WACW,mBAAmB,CAAC,KAAK,EAAE,uBAAuB,GAAG,aAAa;IAsBhF,OAAO,CAAC,MAAM,CAAC,aAAa;CAuD7B"}

package/dist/public/orm-adapter.js

@@ -0,0 +1,97 @@
+export class OrmAdapter {
+    /**
+     * Generates a component schema for an ORM model representation.
+     */
+    static toModelSchema(model) {
+        const properties = {};
+        const required = [];
+        for (const field of model.fields) {
+            properties[field.name] = OrmAdapter.fieldToSchema(field);
+            if (!field.nullable) {
+                required.push(field.name);
+            }
+        }
+        return {
+            type: 'object',
+            title: model.name,
+            properties,
+            ...(required.length > 0 ? { required } : {}),
+        };
+    }
+    /**
+     * Generates a component schema for creating a new record of the model.
+     * Auto-incrementing or readonly primary keys are excluded or made optional.
+     */
+    static toCreateInputSchema(model) {
+        const properties = {};
+        const required = [];
+        for (const field of model.fields) {
+            if (field.autoIncrement || (field.primaryKey && field.type === 'number')) {
+                continue;
+            }
+            properties[field.name] = OrmAdapter.fieldToSchema(field);
+            if (!field.nullable && field.defaultValue === undefined) {
+                required.push(field.name);
+            }
+        }
+        return {
+            type: 'object',
+            title: `Create${model.name}Input`,
+            properties,
+            ...(required.length > 0 ? { required } : {}),
+        };
+    }
+    static fieldToSchema(field) {
+        const schema = {};
+        switch (field.type.toLowerCase()) {
+            case 'int':
+            case 'integer':
+            case 'bigint':
+            case 'smallint':
+                schema['type'] = 'integer';
+                break;
+            case 'number':
+            case 'float':
+            case 'double':
+            case 'decimal':
+                schema['type'] = 'number';
+                break;
+            case 'boolean':
+            case 'bool':
+                schema['type'] = 'boolean';
+                break;
+            case 'date':
+                schema['type'] = 'string';
+                schema['format'] = 'date';
+                break;
+            case 'datetime':
+            case 'timestamp':
+                schema['type'] = 'string';
+                schema['format'] = 'date-time';
+                break;
+            case 'uuid':
+                schema['type'] = 'string';
+                schema['format'] = 'uuid';
+                break;
+            case 'email':
+                schema['type'] = 'string';
+                schema['format'] = 'email';
+                break;
+            case 'json':
+                schema['type'] = 'object';
+                schema['additionalProperties'] = true;
+                break;
+            default:
+                schema['type'] = 'string';
+                break;
+        }
+        if (field.nullable) {
+            schema['nullable'] = true;
+        }
+        if (field.defaultValue !== undefined) {
+            schema['default'] = field.defaultValue;
+        }
+        return schema;
+    }
+}
+//# sourceMappingURL=orm-adapter.js.map

package/dist/public/orm-adapter.js.map

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

package/dist/public/registry.d.ts

@@ -0,0 +1,51 @@
+import type { OpenApiSchema, OpenApiSecurityScheme, OpenApiTag, OpenApiServer, OpenApiResponse, OpenApiParameter, OpenApiRouteMetadata } from './types.js';
+export declare class OpenApiRegistry {
+    private readonly schemas;
+    private readonly securitySchemes;
+    private readonly tags;
+    private readonly servers;
+    private readonly responses;
+    private readonly parameters;
+    private readonly headers;
+    private readonly requestBodies;
+    private readonly routeOverrides;
+    /**
+     * Registers a reusable component schema.
+     * If a schema with the same name already exists, verifies structural compatibility.
+     */
+    registerSchema(name: string, schema: OpenApiSchema): this;
+    getSchema(name: string): OpenApiSchema | undefined;
+    getAllSchemas(): ReadonlyMap<string, OpenApiSchema>;
+    /**
+     * Registers a security scheme (e.g. bearer, apiKey, etc.).
+     */
+    registerSecurityScheme(name: string, scheme: OpenApiSecurityScheme): this;
+    getAllSecuritySchemes(): ReadonlyMap<string, OpenApiSecurityScheme>;
+    /**
+     * Registers an OpenAPI tag with optional description.
+     */
+    registerTag(tag: OpenApiTag): this;
+    getAllTags(): readonly OpenApiTag[];
+    /**
+     * Registers a server target.
+     */
+    registerServer(server: OpenApiServer): this;
+    getAllServers(): readonly OpenApiServer[];
+    /**
+     * Registers a reusable response component.
+     */
+    registerResponse(name: string, response: OpenApiResponse): this;
+    getAllResponses(): ReadonlyMap<string, OpenApiResponse>;
+    /**
+     * Registers a reusable parameter component.
+     */
+    registerParameter(name: string, parameter: OpenApiParameter): this;
+    getAllParameters(): ReadonlyMap<string, OpenApiParameter>;
+    /**
+     * Registers an explicit route metadata override for a specific method and path.
+     */
+    registerRouteOverride(method: string, path: string, metadata: OpenApiRouteMetadata): this;
+    getRouteOverride(method: string, path: string): OpenApiRouteMetadata | undefined;
+    clear(): void;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/public/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/public/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,qBAAqB,EACrB,UAAU,EACV,aAAa,EACb,eAAe,EACf,gBAAgB,EAGhB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAGpB,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAC5D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA4C;IAC5E,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiC;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsC;IAChE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuC;IAClE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAC5D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyC;IACvE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA2C;IAE1E;;;OAGG;IACI,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI;IAezD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIlD,aAAa,IAAI,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC;IAI1D;;OAEG;IACI,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,GAAG,IAAI;IAKzE,qBAAqB,IAAI,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC;IAI1E;;OAEG;IACI,WAAW,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI;IAKlC,UAAU,IAAI,SAAS,UAAU,EAAE;IAI1C;;OAEG;IACI,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAK3C,aAAa,IAAI,SAAS,aAAa,EAAE;IAIhD;;OAEG;IACI,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI;IAK/D,eAAe,IAAI,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC;IAI9D;;OAEG;IACI,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,GAAG,IAAI;IAKlE,gBAAgB,IAAI,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAIhE;;OAEG;IACI,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IAMzF,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAIhF,KAAK,IAAI,IAAI;CAWrB"}

package/dist/public/registry.js

@@ -0,0 +1,106 @@
+import { ConflictingSchemaError } from './errors.js';
+export class OpenApiRegistry {
+    schemas = new Map();
+    securitySchemes = new Map();
+    tags = new Map();
+    servers = [];
+    responses = new Map();
+    parameters = new Map();
+    headers = new Map();
+    requestBodies = new Map();
+    routeOverrides = new Map();
+    /**
+     * Registers a reusable component schema.
+     * If a schema with the same name already exists, verifies structural compatibility.
+     */
+    registerSchema(name, schema) {
+        const existing = this.schemas.get(name);
+        if (existing) {
+            if (JSON.stringify(existing) !== JSON.stringify(schema)) {
+                throw new ConflictingSchemaError(name, 'A different schema is already registered with this name.');
+            }
+            return this;
+        }
+        this.schemas.set(name, Object.freeze({ ...schema }));
+        return this;
+    }
+    getSchema(name) {
+        return this.schemas.get(name);
+    }
+    getAllSchemas() {
+        return this.schemas;
+    }
+    /**
+     * Registers a security scheme (e.g. bearer, apiKey, etc.).
+     */
+    registerSecurityScheme(name, scheme) {
+        this.securitySchemes.set(name, Object.freeze({ ...scheme }));
+        return this;
+    }
+    getAllSecuritySchemes() {
+        return this.securitySchemes;
+    }
+    /**
+     * Registers an OpenAPI tag with optional description.
+     */
+    registerTag(tag) {
+        this.tags.set(tag.name, Object.freeze({ ...tag }));
+        return this;
+    }
+    getAllTags() {
+        return Array.from(this.tags.values());
+    }
+    /**
+     * Registers a server target.
+     */
+    registerServer(server) {
+        this.servers.push(Object.freeze({ ...server }));
+        return this;
+    }
+    getAllServers() {
+        return this.servers;
+    }
+    /**
+     * Registers a reusable response component.
+     */
+    registerResponse(name, response) {
+        this.responses.set(name, Object.freeze({ ...response }));
+        return this;
+    }
+    getAllResponses() {
+        return this.responses;
+    }
+    /**
+     * Registers a reusable parameter component.
+     */
+    registerParameter(name, parameter) {
+        this.parameters.set(name, Object.freeze({ ...parameter }));
+        return this;
+    }
+    getAllParameters() {
+        return this.parameters;
+    }
+    /**
+     * Registers an explicit route metadata override for a specific method and path.
+     */
+    registerRouteOverride(method, path, metadata) {
+        const key = `${method.toUpperCase()} ${path}`;
+        this.routeOverrides.set(key, Object.freeze({ ...metadata }));
+        return this;
+    }
+    getRouteOverride(method, path) {
+        return this.routeOverrides.get(`${method.toUpperCase()} ${path}`);
+    }
+    clear() {
+        this.schemas.clear();
+        this.securitySchemes.clear();
+        this.tags.clear();
+        this.servers.length = 0;
+        this.responses.clear();
+        this.parameters.clear();
+        this.headers.clear();
+        this.requestBodies.clear();
+        this.routeOverrides.clear();
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/public/registry.js.map

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

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

@@ -0,0 +1,29 @@
+import type { OpenApiSchema } from './types.js';
+export declare class SchemaBuilder {
+    static string(options?: Partial<OpenApiSchema>): OpenApiSchema;
+    static number(options?: Partial<OpenApiSchema>): OpenApiSchema;
+    static integer(options?: Partial<OpenApiSchema>): OpenApiSchema;
+    static boolean(options?: Partial<OpenApiSchema>): OpenApiSchema;
+    static uuid(options?: Partial<OpenApiSchema>): OpenApiSchema;
+    static dateTime(options?: Partial<OpenApiSchema>): OpenApiSchema;
+    static date(options?: Partial<OpenApiSchema>): OpenApiSchema;
+    static email(options?: Partial<OpenApiSchema>): OpenApiSchema;
+    static binary(options?: Partial<OpenApiSchema>): OpenApiSchema;
+    static array(items: OpenApiSchema, options?: Partial<OpenApiSchema>): OpenApiSchema;
+    static object(properties: Record<string, OpenApiSchema>, required?: readonly string[], options?: Partial<OpenApiSchema>): OpenApiSchema;
+    static enum(values: readonly unknown[], options?: Partial<OpenApiSchema>): OpenApiSchema;
+    static ref(schemaName: string): OpenApiSchema;
+    /**
+     * Reusable error response schema matching framework's JsangoError / HTTP error format.
+     */
+    static errorResponse(): OpenApiSchema;
+    /**
+     * Reusable validation error response schema matching @jsango/validation format.
+     */
+    static validationErrorResponse(): OpenApiSchema;
+    /**
+     * Standard paginated response schema.
+     */
+    static paginated(itemSchema: OpenApiSchema): OpenApiSchema;
+}
+//# sourceMappingURL=schema-builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema-builder.d.ts","sourceRoot":"","sources":["../../src/public/schema-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,qBAAa,aAAa;WACV,MAAM,CAAC,OAAO,GAAE,OAAO,CAAC,aAAa,CAAM,GAAG,aAAa;WAI3D,MAAM,CAAC,OAAO,GAAE,OAAO,CAAC,aAAa,CAAM,GAAG,aAAa;WAI3D,OAAO,CAAC,OAAO,GAAE,OAAO,CAAC,aAAa,CAAM,GAAG,aAAa;WAI5D,OAAO,CAAC,OAAO,GAAE,OAAO,CAAC,aAAa,CAAM,GAAG,aAAa;WAI5D,IAAI,CAAC,OAAO,GAAE,OAAO,CAAC,aAAa,CAAM,GAAG,aAAa;WAIzD,QAAQ,CAAC,OAAO,GAAE,OAAO,CAAC,aAAa,CAAM,GAAG,aAAa;WAI7D,IAAI,CAAC,OAAO,GAAE,OAAO,CAAC,aAAa,CAAM,GAAG,aAAa;WAIzD,KAAK,CAAC,OAAO,GAAE,OAAO,CAAC,aAAa,CAAM,GAAG,aAAa;WAI1D,MAAM,CAAC,OAAO,GAAE,OAAO,CAAC,aAAa,CAAM,GAAG,aAAa;WAI3D,KAAK,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,GAAE,OAAO,CAAC,aAAa,CAAM,GAAG,aAAa;WAIhF,MAAM,CAClB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EACzC,QAAQ,GAAE,SAAS,MAAM,EAAO,EAChC,OAAO,GAAE,OAAO,CAAC,aAAa,CAAM,GACnC,aAAa;WASF,IAAI,CAChB,MAAM,EAAE,SAAS,OAAO,EAAE,EAC1B,OAAO,GAAE,OAAO,CAAC,aAAa,CAAM,GACnC,aAAa;WAKF,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa;IAIpD;;OAEG;WACW,aAAa,IAAI,aAAa;IAmB5C;;OAEG;WACW,uBAAuB,IAAI,aAAa;IA8BtD;;OAEG;WACW,SAAS,CAAC,UAAU,EAAE,aAAa,GAAG,aAAa;CAalE"}