/** * OpenAPI specification metadata * * This file contains all the base metadata for the OpenAPI specification * that was previously stored in openapi-base.yaml. * * Note on 'as const' usage: * - We use 'as const' on literal values that should be treated as enums * (e.g., "apiKey", "header", "3.1.0") to get precise literal types * - We avoid 'as const' on top-level configuration objects to prevent * deep readonly types that can cause compatibility issues with libraries * expecting mutable types (like zod-to-openapi) * - If you encounter readonly type errors, check whether the consuming * library expects mutable types and remove 'as const' accordingly */ declare const apiInfo: { title: string; version: string; contact: { email: string; }; description: string; }; declare const servers: Array<{ url: string; description: string; }>; declare const tags: { name: string; description: string; }[]; /** * Security schemes for OpenAPI specification * * Note: 'as const' is used on enum-like literal values ("apiKey", "header") * to ensure TypeScript treats them as literal types rather than generic strings. * This provides better type safety when the OpenAPI generator validates these values. */ declare const securitySchemes: { readonly userJwt: { readonly type: "apiKey"; readonly in: "header"; readonly name: "Authorization"; readonly description: string; }; }; /** * Complete OpenAPI metadata for document generation */ declare const openApiMetadata: { openapi: "3.1.0"; info: { title: string; version: string; contact: { email: string; }; description: string; }; servers: { url: string; description: string; }[]; tags: { name: string; description: string; }[]; }; export { apiInfo, openApiMetadata, securitySchemes, servers, tags };