@zudojs/openapi 0.0.1

package/dist/openApiHttp/openApiHttpAdapter.core.d.ts

@@ -0,0 +1,38 @@
+import type { OpenAPIDocument } from "../openApiTypes/openApiTypes.core.js";
+import { OpenAPIRegistryImpl } from "../openApiRegistry/openApiRegistry.core.js";
+import { OpenAPIRouteScannerImpl } from "../openApiRouting/routeScanner.core.js";
+/**
+ * High-level OpenAPI manager that coordinates generation, validation, and serving.
+ */
+export declare class OpenAPIManager {
+    private readonly registry;
+    private readonly scanner;
+    private readonly validator;
+    private cachedDocument?;
+    constructor(version?: string);
+    get registryInstance(): OpenAPIRegistryImpl;
+    get scannerInstance(): OpenAPIRouteScannerImpl;
+    addRoute(route: {
+        readonly method: "get" | "put" | "post" | "delete" | "options" | "head" | "patch" | "trace";
+        readonly path: string;
+        readonly metadata?: {
+            readonly openapi?: {
+                readonly operationId?: string;
+                readonly summary?: string;
+                readonly description?: string;
+                readonly tags?: readonly string[];
+                readonly responses?: Record<string, unknown>;
+                readonly requestBody?: unknown;
+                readonly parameters?: readonly unknown[];
+                readonly security?: readonly Record<string, readonly string[]>[];
+            };
+        };
+    }): void;
+    addSchema(name: string, schema: unknown): void;
+    generate(validate?: boolean): OpenAPIDocument;
+    getDocument(validate?: boolean): Readonly<OpenAPIDocument>;
+    invalidate(): void;
+    toJSON(validate?: boolean): string;
+    toYAML(validate?: boolean): string;
+}
+//# sourceMappingURL=openApiHttpAdapter.core.d.ts.map

package/dist/openApiHttp/openApiHttpAdapter.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openApiHttpAdapter.core.d.ts","sourceRoot":"","sources":["../../src/openApiHttp/openApiHttpAdapter.core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAG5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AACjF,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AAOjF;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;IAE/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAElD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IAEjD,OAAO,CAAC,cAAc,CAAC,CAAkB;IAEzC,YAAY,OAAO,SAAU,EAI5B;IAED,IAAW,gBAAgB,IAAI,mBAAmB,CAEjD;IAED,IAAW,eAAe,IAAI,uBAAuB,CAEpD;IAEM,QAAQ,CAAC,KAAK,EAAE;QACrB,QAAQ,CAAC,MAAM,EACX,KAAK,GACL,KAAK,GACL,MAAM,GACN,QAAQ,GACR,SAAS,GACT,MAAM,GACN,OAAO,GACP,OAAO,CAAC;QACZ,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE;YAClB,QAAQ,CAAC,OAAO,CAAC,EAAE;gBACjB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;gBAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;gBAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;gBAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;gBAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAC7C,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;gBAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;gBACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC;aAClE,CAAC;SACH,CAAC;KACH,GAAG,IAAI,CAEP;IAEM,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAEpD;IAEM,QAAQ,CAAC,QAAQ,UAAQ,GAAG,eAAe,CAejD;IAEM,WAAW,CAAC,QAAQ,UAAQ,GAAG,QAAQ,CAAC,eAAe,CAAC,CAK9D;IAEM,UAAU,IAAI,IAAI,CAIxB;IAEM,MAAM,CAAC,QAAQ,UAAQ,GAAG,MAAM,CAEtC;IAEM,MAAM,CAAC,QAAQ,UAAQ,GAAG,MAAM,CAEtC;CACF"}

package/dist/openApiHttp/openApiHttpAdapter.core.js

@@ -0,0 +1,61 @@
+import { OpenAPIDocumentBuilder } from "../openApiDocument/openApiDocument.builder.js";
+import { OpenAPIRegistryImpl } from "../openApiRegistry/openApiRegistry.core.js";
+import { OpenAPIRouteScannerImpl } from "../openApiRouting/routeScanner.core.js";
+import { OpenAPIValidatorImpl } from "../openApiValidation/openApiValidator.core.js";
+import { toOpenAPIJSON, toOpenAPIYAML, } from "../openApiSerialization/openApiSerializer.core.js";
+/**
+ * High-level OpenAPI manager that coordinates generation, validation, and serving.
+ */
+export class OpenAPIManager {
+    registry;
+    scanner;
+    validator;
+    cachedDocument;
+    constructor(version = "3.1.0") {
+        this.registry = new OpenAPIRegistryImpl(version);
+        this.scanner = new OpenAPIRouteScannerImpl();
+        this.validator = new OpenAPIValidatorImpl();
+    }
+    get registryInstance() {
+        return this.registry;
+    }
+    get scannerInstance() {
+        return this.scanner;
+    }
+    addRoute(route) {
+        this.scanner.addRoute(route);
+    }
+    addSchema(name, schema) {
+        this.registry.registerSchema(name, schema);
+    }
+    generate(validate = false) {
+        const routes = this.scanner.scan();
+        for (const route of routes) {
+            this.registry.registerRoute(route);
+        }
+        const document = this.registry.generate();
+        if (validate) {
+            this.validator.assertValid(document);
+        }
+        this.cachedDocument = document;
+        return document;
+    }
+    getDocument(validate = false) {
+        if (this.cachedDocument) {
+            return this.cachedDocument;
+        }
+        return this.generate(validate);
+    }
+    invalidate() {
+        this.cachedDocument = undefined;
+        this.scanner.clear();
+        this.registry.clear();
+    }
+    toJSON(validate = false) {
+        return toOpenAPIJSON(this.getDocument(validate));
+    }
+    toYAML(validate = false) {
+        return toOpenAPIYAML(this.getDocument(validate));
+    }
+}
+//# sourceMappingURL=openApiHttpAdapter.core.js.map

package/dist/openApiHttp/openApiHttpAdapter.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openApiHttpAdapter.core.js","sourceRoot":"","sources":["../../src/openApiHttp/openApiHttpAdapter.core.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAC;AACvF,OAAO,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AACjF,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,+CAA+C,CAAC;AACrF,OAAO,EACL,aAAa,EACb,aAAa,GACd,MAAM,mDAAmD,CAAC;AAE3D;;GAEG;AACH,MAAM,OAAO,cAAc;IACR,QAAQ,CAAsB;IAE9B,OAAO,CAA0B;IAEjC,SAAS,CAAuB;IAEzC,cAAc,CAAmB;IAEzC,YAAY,OAAO,GAAG,OAAO;QAC3B,IAAI,CAAC,QAAQ,GAAG,IAAI,mBAAmB,CAAC,OAAO,CAAC,CAAC;QACjD,IAAI,CAAC,OAAO,GAAG,IAAI,uBAAuB,EAAE,CAAC;QAC7C,IAAI,CAAC,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC9C,CAAC;IAED,IAAW,gBAAgB;QACzB,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,IAAW,eAAe;QACxB,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAEM,QAAQ,CAAC,KAuBf;QACC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAc,CAAC,CAAC;IACxC,CAAC;IAEM,SAAS,CAAC,IAAY,EAAE,MAAe;QAC5C,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,EAAE,MAAe,CAAC,CAAC;IACtD,CAAC;IAEM,QAAQ,CAAC,QAAQ,GAAG,KAAK;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAEnC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAE1C,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QACvC,CAAC;QAED,IAAI,CAAC,cAAc,GAAG,QAAQ,CAAC;QAC/B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEM,WAAW,CAAC,QAAQ,GAAG,KAAK;QACjC,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,cAAc,CAAC;QAC7B,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACjC,CAAC;IAEM,UAAU;QACf,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;QAChC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAEM,MAAM,CAAC,QAAQ,GAAG,KAAK;QAC5B,OAAO,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnD,CAAC;IAEM,MAAM,CAAC,QAAQ,GAAG,KAAK;QAC5B,OAAO,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnD,CAAC;CACF"}

package/dist/openApiRegistry/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @zudojs/openapi/openApiRegistry
+ *
+ * OpenAPI registry for collecting routes, schemas, and components.
+ */
+export type { OpenAPIRegistry, OpenAPIRoute, OpenAPIComponentRegistration, } from "./openApiRegistry.type.js";
+export { OpenAPIRegistryImpl } from "./openApiRegistry.core.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/openApiRegistry/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,eAAe,EACf,YAAY,EACZ,4BAA4B,GAC7B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/openApiRegistry/index.js

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/openapi/openApiRegistry
+ *
+ * OpenAPI registry for collecting routes, schemas, and components.
+ */
+export { OpenAPIRegistryImpl } from "./openApiRegistry.core.js";
+//# sourceMappingURL=index.js.map

package/dist/openApiRegistry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/openApiRegistry/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/openApiRegistry/openApiRegistry.core.d.ts

@@ -0,0 +1,31 @@
+import type { OpenAPIDocument, OpenAPIParameter, OpenAPIRequestBody, OpenAPISchema, OpenAPISecurityScheme, OpenAPITag, OpenAPIReference } from "../openApiTypes/openApiTypes.core.js";
+import type { OpenAPIRoute, OpenAPIRegistry } from "./openApiRegistry.type.js";
+/** Default OpenAPI registry implementation. */
+export declare class OpenAPIRegistryImpl implements OpenAPIRegistry {
+    readonly version: string;
+    private readonly routes;
+    private readonly schemas;
+    private readonly responses;
+    private readonly parameters;
+    private readonly requestBodies;
+    private readonly headers;
+    private readonly examples;
+    private readonly securitySchemes;
+    private readonly tags;
+    private readonly links;
+    private readonly callbacks;
+    constructor(version?: string);
+    registerRoute(route: OpenAPIRoute): void;
+    registerSchema(name: string, schema: OpenAPISchema): void;
+    registerResponse(name: string, response: unknown): void;
+    registerParameter(name: string, parameter: OpenAPIParameter): void;
+    registerRequestBody(name: string, body: OpenAPIRequestBody): void;
+    registerHeader(name: string, header: unknown): void;
+    registerExample(name: string, example: unknown): void;
+    registerSecurityScheme(name: string, scheme: OpenAPISecurityScheme): void;
+    registerTag(tag: OpenAPITag): void;
+    ref(section: "schemas" | "responses" | "parameters" | "requestBodies" | "headers" | "examples" | "securitySchemes" | "links" | "callbacks", name: string): OpenAPIReference;
+    generate(): OpenAPIDocument;
+    clear(): void;
+}
+//# sourceMappingURL=openApiRegistry.core.d.ts.map

package/dist/openApiRegistry/openApiRegistry.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openApiRegistry.core.d.ts","sourceRoot":"","sources":["../../src/openApiRegistry/openApiRegistry.core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAGf,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,qBAAqB,EACrB,UAAU,EACV,gBAAgB,EAEjB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAY/E,+CAA+C;AAC/C,qBAAa,mBAAoB,YAAW,eAAe;IACzD,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;IAC1D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAC5D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8B;IACxD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuC;IAClE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyC;IACvE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;IACvD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA4C;IAC5E,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiC;IACtD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8B;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8B;IAExD,YAAY,OAAO,GAAE,MAAgC,EAEpD;IAEM,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAc9C;IAEM,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAI/D;IAEM,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,CAI7D;IAEM,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAIxE;IAEM,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAIvE;IAEM,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAIzD;IAEM,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAI3D;IAEM,sBAAsB,CAC3B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,qBAAqB,GAC5B,IAAI,CAIN;IAEM,WAAW,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,CAGxC;IAEM,GAAG,CACR,OAAO,EACH,SAAS,GACT,WAAW,GACX,YAAY,GACZ,eAAe,GACf,SAAS,GACT,UAAU,GACV,iBAAiB,GACjB,OAAO,GACP,WAAW,EACf,IAAI,EAAE,MAAM,GACX,gBAAgB,CAElB;IAEM,QAAQ,IAAI,eAAe,CAiEjC;IAEM,KAAK,IAAI,IAAI,CAenB;CACF"}

package/dist/openApiRegistry/openApiRegistry.core.js

@@ -0,0 +1,150 @@
+import { COMPONENT_REF_PREFIX, DEFAULT_OPENAPI_VERSION, } from "../openApiConstants/openApiConstants.core.js";
+import { OpenAPIComponentConflictError, OpenAPIDocumentError, OpenAPIOperationError, OpenAPIVersionError, } from "../openApiErrors/openApiError.core.js";
+/** Default OpenAPI registry implementation. */
+export class OpenAPIRegistryImpl {
+    version;
+    routes = new Map();
+    schemas = new Map();
+    responses = new Map();
+    parameters = new Map();
+    requestBodies = new Map();
+    headers = new Map();
+    examples = new Map();
+    securitySchemes = new Map();
+    tags = new Map();
+    links = new Map();
+    callbacks = new Map();
+    constructor(version = DEFAULT_OPENAPI_VERSION) {
+        this.version = version;
+    }
+    registerRoute(route) {
+        const key = `${route.method}:${route.path}`;
+        const existing = this.routes.get(key);
+        if (existing)
+            throw new OpenAPIOperationError(`Duplicate operation for ${route.method.toUpperCase()} ${route.path}: ${existing.operation.operationId ?? "unknown"}.`);
+        this.routes.set(key, {
+            ...route,
+            operation: Object.freeze({
+                ...route.operation,
+                responses: Object.freeze({ ...route.operation.responses }),
+            }),
+        });
+    }
+    registerSchema(name, schema) {
+        if (this.schemas.has(name))
+            throw new OpenAPIComponentConflictError(`schemas/${name}`);
+        this.schemas.set(name, Object.freeze({ ...schema }));
+    }
+    registerResponse(name, response) {
+        if (this.responses.has(name))
+            throw new OpenAPIComponentConflictError(`responses/${name}`);
+        this.responses.set(name, Object.freeze({ ...response }));
+    }
+    registerParameter(name, parameter) {
+        if (this.parameters.has(name))
+            throw new OpenAPIComponentConflictError(`parameters/${name}`);
+        this.parameters.set(name, Object.freeze({ ...parameter }));
+    }
+    registerRequestBody(name, body) {
+        if (this.requestBodies.has(name))
+            throw new OpenAPIComponentConflictError(`requestBodies/${name}`);
+        this.requestBodies.set(name, Object.freeze({ ...body }));
+    }
+    registerHeader(name, header) {
+        if (this.headers.has(name))
+            throw new OpenAPIComponentConflictError(`headers/${name}`);
+        this.headers.set(name, Object.freeze({ ...header }));
+    }
+    registerExample(name, example) {
+        if (this.examples.has(name))
+            throw new OpenAPIComponentConflictError(`examples/${name}`);
+        this.examples.set(name, Object.freeze({ ...example }));
+    }
+    registerSecurityScheme(name, scheme) {
+        if (this.securitySchemes.has(name))
+            throw new OpenAPIComponentConflictError(`securitySchemes/${name}`);
+        this.securitySchemes.set(name, Object.freeze({ ...scheme }));
+    }
+    registerTag(tag) {
+        if (!this.tags.has(tag.name))
+            this.tags.set(tag.name, Object.freeze({ ...tag }));
+    }
+    ref(section, name) {
+        return { $ref: `${COMPONENT_REF_PREFIX}/${section}/${name}` };
+    }
+    generate() {
+        if (!["3.0.0", "3.0.1", "3.0.2", "3.0.3", "3.1.0", "3.1.1"].includes(this.version))
+            throw new OpenAPIVersionError(this.version);
+        const paths = {};
+        for (const [, route] of this.routes) {
+            const operation = Object.freeze({
+                ...route.operation,
+                responses: Object.freeze({ ...route.operation.responses }),
+            });
+            const existing = paths[route.path] ?? {};
+            paths[route.path] = Object.freeze({
+                ...existing,
+                ...(route.method === "get" ? { get: operation } : {}),
+                ...(route.method === "put" ? { put: operation } : {}),
+                ...(route.method === "post" ? { post: operation } : {}),
+                ...(route.method === "delete" ? { delete: operation } : {}),
+                ...(route.method === "options" ? { options: operation } : {}),
+                ...(route.method === "head" ? { head: operation } : {}),
+                ...(route.method === "patch" ? { patch: operation } : {}),
+                ...(route.method === "trace" ? { trace: operation } : {}),
+                ...(route.operation.parameters?.length
+                    ? { parameters: Object.freeze([...route.operation.parameters]) }
+                    : {}),
+            });
+        }
+        const components = {};
+        const componentMaps = [
+            ["schemas", this.schemas],
+            ["responses", this.responses],
+            ["parameters", this.parameters],
+            ["requestBodies", this.requestBodies],
+            ["headers", this.headers],
+            ["examples", this.examples],
+            ["securitySchemes", this.securitySchemes],
+            ["links", this.links],
+            ["callbacks", this.callbacks],
+        ];
+        for (const [key, map] of componentMaps) {
+            if (map.size > 0)
+                components[key] = Object.freeze(Object.fromEntries(map));
+        }
+        try {
+            return Object.freeze({
+                openapi: this.version,
+                info: { title: "Zudojs API", version: "1.0.0" },
+                paths: Object.freeze(paths),
+                ...(Object.keys(components).length > 0
+                    ? { components: Object.freeze(components) }
+                    : {}),
+                ...(this.tags.size > 0
+                    ? { tags: Object.freeze(Array.from(this.tags.values())) }
+                    : {}),
+            });
+        }
+        catch (error) {
+            throw new OpenAPIDocumentError(`Failed to generate OpenAPI document: ${error.message}`);
+        }
+    }
+    clear() {
+        for (const map of [
+            this.routes,
+            this.schemas,
+            this.responses,
+            this.parameters,
+            this.requestBodies,
+            this.headers,
+            this.examples,
+            this.securitySchemes,
+            this.tags,
+            this.links,
+            this.callbacks,
+        ])
+            map.clear();
+    }
+}
+//# sourceMappingURL=openApiRegistry.core.js.map

package/dist/openApiRegistry/openApiRegistry.core.js.map

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

package/dist/openApiRegistry/openApiRegistry.type.d.ts

@@ -0,0 +1,42 @@
+import type { OpenAPIDocument } from "../openApiTypes/openApiTypes.core.js";
+import type { OpenAPIOperation } from "../openApiTypes/openApiTypes.core.js";
+import type { OpenAPIParameter } from "../openApiTypes/openApiTypes.core.js";
+import type { OpenAPIRequestBody } from "../openApiTypes/openApiTypes.core.js";
+import type { OpenAPISchema } from "../openApiTypes/openApiTypes.core.js";
+import type { OpenAPISecurityScheme } from "../openApiTypes/openApiTypes.core.js";
+import type { OpenAPITag } from "../openApiTypes/openApiTypes.core.js";
+import type { OpenAPIReference } from "../openApiTypes/openApiTypes.core.js";
+/**
+ * A registered route in the OpenAPI registry.
+ */
+export interface OpenAPIRoute {
+    readonly method: "get" | "put" | "post" | "delete" | "options" | "head" | "patch" | "trace";
+    readonly path: string;
+    readonly operation: OpenAPIOperation;
+}
+/**
+ * Component registration entry.
+ */
+export interface OpenAPIComponentRegistration<T> {
+    readonly name: string;
+    readonly value: T;
+}
+/**
+ * OpenAPI registry for collecting routes, schemas, and components.
+ */
+export interface OpenAPIRegistry {
+    readonly version: string;
+    registerRoute(route: OpenAPIRoute): void;
+    registerSchema(name: string, schema: OpenAPISchema): void;
+    registerResponse(name: string, response: unknown): void;
+    registerParameter(name: string, parameter: OpenAPIParameter): void;
+    registerRequestBody(name: string, body: OpenAPIRequestBody): void;
+    registerHeader(name: string, header: unknown): void;
+    registerExample(name: string, example: unknown): void;
+    registerSecurityScheme(name: string, scheme: OpenAPISecurityScheme): void;
+    registerTag(tag: OpenAPITag): void;
+    ref(section: "schemas" | "responses" | "parameters" | "requestBodies" | "headers" | "examples" | "securitySchemes" | "links" | "callbacks", name: string): OpenAPIReference;
+    generate(): OpenAPIDocument;
+    clear(): void;
+}
+//# sourceMappingURL=openApiRegistry.type.d.ts.map

package/dist/openApiRegistry/openApiRegistry.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openApiRegistry.type.d.ts","sourceRoot":"","sources":["../../src/openApiRegistry/openApiRegistry.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAE5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAC1E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAClF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAW7E;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EACb,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IAE7E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B,CAAC,CAAC;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAEzC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IAE1D,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IAExD,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAEnE,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAElE,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IAEpD,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAEtD,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAE1E,WAAW,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,CAAC;IAEnC,GAAG,CACD,OAAO,EACH,SAAS,GACT,WAAW,GACX,YAAY,GACZ,eAAe,GACf,SAAS,GACT,UAAU,GACV,iBAAiB,GACjB,OAAO,GACP,WAAW,EACf,IAAI,EAAE,MAAM,GACX,gBAAgB,CAAC;IAEpB,QAAQ,IAAI,eAAe,CAAC;IAE5B,KAAK,IAAI,IAAI,CAAC;CACf"}

package/dist/openApiRegistry/openApiRegistry.type.js

@@ -0,0 +1,3 @@
+import { COMPONENT_REF_PREFIX, DEFAULT_OPENAPI_VERSION, } from "../openApiConstants/openApiConstants.core.js";
+import { OpenAPIComponentConflictError, OpenAPIDocumentError, OpenAPIOperationError, } from "../openApiErrors/openApiError.core.js";
+//# sourceMappingURL=openApiRegistry.type.js.map

package/dist/openApiRegistry/openApiRegistry.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openApiRegistry.type.js","sourceRoot":"","sources":["../../src/openApiRegistry/openApiRegistry.type.ts"],"names":[],"mappings":"AASA,OAAO,EACL,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,8CAA8C,CAAC;AACtD,OAAO,EACL,6BAA6B,EAC7B,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,uCAAuC,CAAC"}

package/dist/openApiRouting/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @zudojs/openapi/openApiRouting
+ *
+ * Route metadata, conversion, and scanning for OpenAPI generation.
+ */
+export type { RouteMetadata, RouteOpenAPIMetadata, RouteParameterMetadata, RouteInfo, } from "./routeScanner.core.js";
+export { toOpenAPIPath, convertRouteToOpenAPI, ZUDOLIB_TO_OPENAPI_METHODS, } from "./routeConverter.core.js";
+export { OpenAPIRouteScannerImpl } from "./routeScanner.core.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/openApiRouting/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EACtB,SAAS,GACV,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/openApiRouting/index.js

@@ -0,0 +1,8 @@
+/**
+ * @zudojs/openapi/openApiRouting
+ *
+ * Route metadata, conversion, and scanning for OpenAPI generation.
+ */
+export { toOpenAPIPath, convertRouteToOpenAPI, ZUDOLIB_TO_OPENAPI_METHODS, } from "./routeConverter.core.js";
+export { OpenAPIRouteScannerImpl } from "./routeScanner.core.js";
+//# sourceMappingURL=index.js.map

package/dist/openApiRouting/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/openApiRouting/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/openApiRouting/routeConverter.core.d.ts

@@ -0,0 +1,23 @@
+import type { OpenAPIOperation } from "../openApiTypes/openApiTypes.core.js";
+import type { RouteMetadata } from "./routeMetadata.type.js";
+/**
+ * Converts a Zudojs-style route path to an OpenAPI path template.
+ *
+ * Example:
+ *   "/users/:id" -> "/users/{id}"
+ *   "/users/:id?": throws (optional path params not supported in OpenAPI)
+ */
+export declare function toOpenAPIPath(path: string): string;
+/**
+ * Maps Zudojs HTTP methods to OpenAPI methods.
+ */
+export declare const ZUDOLIB_TO_OPENAPI_METHODS: readonly ["get", "put", "post", "delete", "options", "head", "patch", "trace"];
+/**
+ * Converts a route with metadata into an OpenAPI operation.
+ */
+export declare function convertRouteToOpenAPI(method: string, path: string, metadata?: RouteMetadata): {
+    method: string;
+    path: string;
+    operation: OpenAPIOperation;
+};
+//# sourceMappingURL=routeConverter.core.d.ts.map

package/dist/openApiRouting/routeConverter.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routeConverter.core.d.ts","sourceRoot":"","sources":["../../src/openApiRouting/routeConverter.core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAoBlD;AAED;;GAEG;AACH,eAAO,MAAM,0BAA0B,YACrC,KAAK,EACL,KAAK,EACL,MAAM,EACN,QAAQ,EACR,SAAS,EACT,MAAM,EACN,OAAO,EACP,OAAO,CACC,CAAC;AAEX;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,aAAa,GACvB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,gBAAgB,CAAA;CAAE,CA6C/D"}

package/dist/openApiRouting/routeConverter.core.js

@@ -0,0 +1,85 @@
+/**
+ * Converts a Zudojs-style route path to an OpenAPI path template.
+ *
+ * Example:
+ *   "/users/:id" -> "/users/{id}"
+ *   "/users/:id?": throws (optional path params not supported in OpenAPI)
+ */
+export function toOpenAPIPath(path) {
+    if (path.includes(":")) {
+        const segments = path.split("/");
+        const openApiSegments = segments.map((segment) => {
+            if (segment.startsWith(":") && segment.endsWith("?")) {
+                throw new Error(`Optional path parameter "${segment}" is not supported in OpenAPI. ` +
+                    `Use separate routes or a query parameter instead.`);
+            }
+            if (segment.startsWith(":")) {
+                return `{${segment.slice(1)}}`;
+            }
+            return segment;
+        });
+        return openApiSegments.join("/");
+    }
+    return path;
+}
+/**
+ * Maps Zudojs HTTP methods to OpenAPI methods.
+ */
+export const ZUDOLIB_TO_OPENAPI_METHODS = [
+    "get",
+    "put",
+    "post",
+    "delete",
+    "options",
+    "head",
+    "patch",
+    "trace",
+];
+/**
+ * Converts a route with metadata into an OpenAPI operation.
+ */
+export function convertRouteToOpenAPI(method, path, metadata) {
+    const openApiPath = toOpenAPIPath(path);
+    const openApiMetadata = metadata?.openapi;
+    const operation = {
+        responses: openApiMetadata?.responses
+            ? {
+                "200": {
+                    description: "OK",
+                    ...(openApiMetadata.responses["200"] ?? {}),
+                },
+            }
+            : { "200": { description: "OK" } },
+        ...(openApiMetadata?.operationId
+            ? { operationId: openApiMetadata.operationId }
+            : {}),
+        ...(openApiMetadata?.summary ? { summary: openApiMetadata.summary } : {}),
+        ...(openApiMetadata?.description
+            ? { description: openApiMetadata.description }
+            : {}),
+        ...(openApiMetadata?.tags?.length
+            ? { tags: [...openApiMetadata.tags] }
+            : {}),
+        ...(openApiMetadata?.deprecated !== undefined
+            ? { deprecated: openApiMetadata.deprecated }
+            : {}),
+        ...(openApiMetadata?.parameters?.length
+            ? { parameters: [...openApiMetadata.parameters] }
+            : {}),
+        ...(openApiMetadata?.requestBody
+            ? { requestBody: openApiMetadata.requestBody }
+            : {}),
+        ...(openApiMetadata?.security?.length
+            ? { security: [...openApiMetadata.security] }
+            : {}),
+        ...(openApiMetadata?.servers?.length
+            ? { servers: [...openApiMetadata.servers] }
+            : {}),
+    };
+    return {
+        method,
+        path: openApiPath,
+        operation,
+    };
+}
+//# sourceMappingURL=routeConverter.core.js.map

package/dist/openApiRouting/routeConverter.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routeConverter.core.js","sourceRoot":"","sources":["../../src/openApiRouting/routeConverter.core.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,eAAe,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;YAC/C,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrD,MAAM,IAAI,KAAK,CACb,4BAA4B,OAAO,iCAAiC;oBAClE,mDAAmD,CACtD,CAAC;YACJ,CAAC;YACD,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC5B,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;YACjC,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC,CAAC,CAAC;QAEH,OAAO,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,KAAK;IACL,KAAK;IACL,MAAM;IACN,QAAQ;IACR,SAAS;IACT,MAAM;IACN,OAAO;IACP,OAAO;CACC,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAc,EACd,IAAY,EACZ,QAAwB;IAExB,MAAM,WAAW,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,eAAe,GAAG,QAAQ,EAAE,OAAO,CAAC;IAE1C,MAAM,SAAS,GAAqB;QAClC,SAAS,EAAE,eAAe,EAAE,SAAS;YACnC,CAAC,CAAC;gBACE,KAAK,EAAE;oBACL,WAAW,EAAE,IAAI;oBACjB,GAAG,CAAE,eAAe,CAAC,SAAS,CAAC,KAAK,CAAY,IAAI,EAAE,CAAC;iBACxD;aACF;YACH,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE;QACpC,GAAG,CAAC,eAAe,EAAE,WAAW;YAC9B,CAAC,CAAC,EAAE,WAAW,EAAE,eAAe,CAAC,WAAW,EAAE;YAC9C,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,eAAe,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,GAAG,CAAC,eAAe,EAAE,WAAW;YAC9B,CAAC,CAAC,EAAE,WAAW,EAAE,eAAe,CAAC,WAAW,EAAE;YAC9C,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,MAAM;YAC/B,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,eAAe,CAAC,IAAI,CAAC,EAAE;YACrC,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,eAAe,EAAE,UAAU,KAAK,SAAS;YAC3C,CAAC,CAAC,EAAE,UAAU,EAAE,eAAe,CAAC,UAAU,EAAE;YAC5C,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,eAAe,EAAE,UAAU,EAAE,MAAM;YACrC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,GAAG,eAAe,CAAC,UAAU,CAAC,EAAE;YACjD,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,eAAe,EAAE,WAAW;YAC9B,CAAC,CAAC,EAAE,WAAW,EAAE,eAAe,CAAC,WAAW,EAAE;YAC9C,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,eAAe,EAAE,QAAQ,EAAE,MAAM;YACnC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,eAAe,CAAC,QAAQ,CAAC,EAAE;YAC7C,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,eAAe,EAAE,OAAO,EAAE,MAAM;YAClC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,eAAe,CAAC,OAAO,CAAC,EAAE;YAC3C,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;IAEF,OAAO;QACL,MAAM;QACN,IAAI,EAAE,WAAW;QACjB,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/openApiRouting/routeMetadata.type.d.ts

@@ -0,0 +1,38 @@
+import type { OpenAPIRequestBody } from "../openApiTypes/openApiTypes.core.js";
+/**
+ * Metadata attached to a route for OpenAPI generation.
+ */
+export interface RouteOpenAPIMetadata {
+    readonly operationId?: string;
+    readonly summary?: string;
+    readonly description?: string;
+    readonly tags?: readonly string[];
+    readonly deprecated?: boolean;
+    readonly parameters?: readonly RouteParameterMetadata[];
+    readonly requestBody?: OpenAPIRequestBody;
+    readonly responses?: Record<string, unknown>;
+    readonly security?: readonly Record<string, readonly string[]>[];
+    readonly servers?: readonly {
+        readonly url: string;
+        readonly description?: string;
+    }[];
+}
+/**
+ * Parameter metadata for OpenAPI generation.
+ */
+export interface RouteParameterMetadata {
+    readonly name: string;
+    readonly in: "query" | "header" | "path" | "cookie";
+    readonly description?: string;
+    readonly required?: boolean;
+    readonly deprecated?: boolean;
+    readonly schema?: unknown;
+    readonly example?: unknown;
+}
+/**
+ * Route metadata container.
+ */
+export interface RouteMetadata {
+    readonly openapi?: RouteOpenAPIMetadata;
+}
+//# sourceMappingURL=routeMetadata.type.d.ts.map

package/dist/openApiRouting/routeMetadata.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routeMetadata.type.d.ts","sourceRoot":"","sources":["../../src/openApiRouting/routeMetadata.type.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAE/E;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAElC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAE9B,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAExD,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IAE1C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC;IAEjE,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS;QAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;KAC/B,EAAE,CAAC;CACL;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,EAAE,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;IAEpD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAE5B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAE9B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAE1B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,oBAAoB,CAAC;CACzC"}

package/dist/openApiRouting/routeMetadata.type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=routeMetadata.type.js.map

package/dist/openApiRouting/routeMetadata.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routeMetadata.type.js","sourceRoot":"","sources":["../../src/openApiRouting/routeMetadata.type.ts"],"names":[],"mappings":""}