adorn-api 1.0.1 → 1.0.3

package/dist/core/openapi/buildOpenApi.js

@@ -1,6 +1,60 @@
 import { normalizeResponses } from '../responses/normalize.js';
 import { OasSchemaRegistry } from './schema/registry.js';
 import { irToOasSchema } from './schema/toOpenApi.js';
+/**
+ * Builds a complete OpenAPI 3.0.3 specification document from the route registry.
+ *
+ * This function generates a comprehensive OpenAPI specification by analyzing
+ * the route registry and extracting all necessary information including paths,
+ * operations, parameters, request/response bodies, and security schemes.
+ *
+ * @param registry - Route registry containing all registered routes and metadata
+ * @param opts - OpenAPI build options including title, version, and servers
+ * @returns Complete OpenAPI 3.0.3 document ready for serving or serialization
+ *
+ * @example
+ * ```typescript
+ * import { buildRegistry } from './registry';
+ * import { buildOpenApi } from './openapi';
+ *
+ * // Build route registry from controllers
+ * const registry = buildRegistry([UserController, ProductController]);
+ *
+ * // Generate OpenAPI specification
+ * const openApiDoc = buildOpenApi(registry, {
+ *   title: 'My API',
+ *   version: '1.0.0',
+ *   servers: [
+ *     { url: 'https://api.example.com/v1', description: 'Production server' },
+ *     { url: 'https://staging.api.example.com/v1', description: 'Staging server' }
+ *   ],
+ *   defaultRequestContentType: 'application/json',
+ *   defaultResponseContentType: 'application/json'
+ * });
+ *
+ * // Serve the OpenAPI JSON
+ * app.get('/openapi.json', (req, res) => {
+ *   res.json(openApiDoc);
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With custom content types
+ * const openApiDoc = buildOpenApi(registry, {
+ *   title: 'Multi-format API',
+ *   version: '2.0.0',
+ *   defaultRequestContentType: 'application/json',
+ *   defaultResponseContentType: 'application/problem+json'
+ * });
+ *
+ * // The generated spec will use application/problem+json for error responses
+ * // and application/json for successful responses by default
+ * ```
+ *
+ * @see Registry for route registry structure
+ * @see OpenApiDocument for the returned document structure
+ */
 export function buildOpenApi(registry, opts) {
     const schemaReg = new OasSchemaRegistry();
     const doc = {
@@ -8,7 +62,6 @@ export function buildOpenApi(registry, opts) {
         info: { title: opts.title, version: opts.version },
         ...(opts.servers !== undefined ? { servers: opts.servers } : {}),
         paths: {},
-        components: {},
     };
     for (const r of registry.routes) {
         const pathKey = r.fullPath;
@@ -16,11 +69,12 @@ export function buildOpenApi(registry, opts) {
         const method = r.method.toLowerCase();
         const ro = (r.options ?? {});
         const op = {
-            operationId: `${r.controller.name}.${r.handlerName}`,
+            operationId: ro.operationId ?? `${r.controller.name}.${r.handlerName}`,
             ...(ro.summary !== undefined ? { summary: ro.summary } : {}),
             ...(ro.description !== undefined ? { description: ro.description } : {}),
             ...(ro.tags !== undefined ? { tags: ro.tags } : {}),
             ...(ro.deprecated !== undefined ? { deprecated: ro.deprecated } : {}),
+            ...(ro.security !== undefined ? { security: ro.security } : {}),
             parameters: [],
             responses: {},
         };
@@ -28,9 +82,17 @@ export function buildOpenApi(registry, opts) {
         addQueryParams(op, ro);
         addRequestBody(op, r, ro, schemaReg, opts.defaultRequestContentType ?? 'application/json');
         addResponses(op, r, ro, schemaReg, opts.defaultResponseContentType ?? 'application/json');
-        doc.paths[pathKey][method] = op;
+        const pathItem = doc.paths[pathKey] ?? {};
+        pathItem[method] = op;
+        doc.paths[pathKey] = pathItem;
+    }
+    const components = schemaReg.getComponents();
+    if (registry.securitySchemes && Object.keys(registry.securitySchemes).length) {
+        components.securitySchemes = registry.securitySchemes;
+    }
+    if (Object.keys(components).length) {
+        doc.components = components;
     }
-    doc.components = schemaReg.getComponents();
     return doc;
 }
 function addPathParams(op, r, ro) {

package/dist/core/openapi/buildOpenApi.js.map

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

package/dist/core/openapi/schema/registry.d.ts

@@ -3,7 +3,7 @@ import type { Schema } from '../../../validation/native/schema.js';
 export declare class OasSchemaRegistry {
     private components;
     private seen;
-    toSchemaRef(schema: Schema<any>): SchemaObject | ReferenceObject;
+    toSchemaRef(schema: Schema<unknown>): SchemaObject | ReferenceObject;
     getComponents(): ComponentsObject;
 }
 //# sourceMappingURL=registry.d.ts.map

package/dist/core/openapi/schema/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/core/openapi/schema/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACxG,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sCAAsC,CAAC;AAGnE,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,IAAI,CAAiC;IAE7C,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,YAAY,GAAG,eAAe;IAgBhE,aAAa,IAAI,gBAAgB;CAGlC"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/core/openapi/schema/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACxG,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sCAAsC,CAAC;AAGnE,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,IAAI,CAAiC;IAE7C,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,YAAY,GAAG,eAAe;IAgBpE,aAAa,IAAI,gBAAgB;CAGlC"}

package/dist/core/openapi/schema/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../src/core/openapi/schema/registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,OAAO,iBAAiB;IACpB,UAAU,GAAiC,EAAE,CAAC;IAC9C,IAAI,GAAG,IAAI,OAAO,EAAkB,CAAC;IAE7C,WAAW,CAAC,MAAmB;QAC7B,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAChB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAgB,CAAC,CAAC;YACjD,MAAM,IAAI,GAAG,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC;YAErC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAgB,EAAE,IAAI,CAAC,CAAC;gBACtC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACnD,CAAC;YAED,OAAO,EAAE,IAAI,EAAE,wBAAwB,IAAI,EAAE,EAAE,CAAC;QAClD,CAAC;QAED,OAAO,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,aAAa;QACX,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACjF,CAAC;CACF"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../src/core/openapi/schema/registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,OAAO,iBAAiB;IACpB,UAAU,GAAiC,EAAE,CAAC;IAC9C,IAAI,GAAG,IAAI,OAAO,EAAkB,CAAC;IAE7C,WAAW,CAAC,MAAuB;QACjC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAChB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAgB,CAAC,CAAC;YACjD,MAAM,IAAI,GAAG,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC;YAErC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAgB,EAAE,IAAI,CAAC,CAAC;gBACtC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACnD,CAAC;YAED,OAAO,EAAE,IAAI,EAAE,wBAAwB,IAAI,EAAE,EAAE,CAAC;QAClD,CAAC;QAED,OAAO,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,aAAa;QACX,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACjF,CAAC;CACF"}

package/dist/core/registry/buildRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildRegistry.d.ts","sourceRoot":"","sources":["../../../src/core/registry/buildRegistry.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAmB,QAAQ,EAAc,MAAM,YAAY,CAAC;AA+BxF,wBAAgB,aAAa,CAAC,WAAW,EAAE,cAAc,EAAE,GAAG,QAAQ,CAwCrE"}
+{"version":3,"file":"buildRegistry.d.ts","sourceRoot":"","sources":["../../../src/core/registry/buildRegistry.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,cAAc,EAAmB,QAAQ,EAAc,MAAM,YAAY,CAAC;AAkCxF,wBAAgB,aAAa,CAAC,WAAW,EAAE,cAAc,EAAE,GAAG,QAAQ,CAsDrE"}

package/dist/core/registry/buildRegistry.js

@@ -1,4 +1,4 @@
-import { META } from '../../metadata/keys.js';
+import { META, } from '../../metadata/keys.js';
 import { bagFromClass, bagGet } from '../../metadata/bag.js';
 import { mergeBags } from '../../metadata/merge.js';
 import { joinPaths } from './normalize.js';
@@ -6,11 +6,12 @@ import { assertNoRouteConflicts } from './conflicts.js';
 function mergedBagFromClass(ctor) {
     const chain = [];
     let cur = ctor;
-    while (typeof cur === 'function' && cur !== Function.prototype) {
+    while (cur && typeof cur === 'function') {
         chain.push(cur);
-        cur = Object.getPrototypeOf(cur);
-        if (!cur || cur === Function || cur === Function.prototype)
+        const parent = Object.getPrototypeOf(cur);
+        if (!parent || parent === Function || parent === Function.prototype)
             break;
+        cur = parent;
     }
     chain.reverse();
     let merged = {};
@@ -29,6 +30,7 @@ function requireControllerMeta(ctor, bag) {
 export function buildRegistry(controllers) {
     const controllerEntries = [];
     const routes = [];
+    const securitySchemes = {};
     for (const ctor of controllers) {
         const mergedBag = mergedBagFromClass(ctor);
         const controllerMeta = requireControllerMeta(ctor, mergedBag);
@@ -38,8 +40,16 @@ export function buildRegistry(controllers) {
             throw new Error(`Invalid route metadata on ${ctor.name}: expected an array at META.routes.`);
         }
         const bindingsMeta = mergedBag[META.bindings];
+        const docsMeta = bagGet(mergedBag, META.docs);
+        const securityMeta = bagGet(mergedBag, META.security);
+        if (securityMeta?.schemes) {
+            Object.assign(securitySchemes, securityMeta.schemes);
+        }
         for (const rm of routeMetas) {
             const fullPath = joinPaths(controllerMeta.basePath, rm.path);
+            const baseDocs = docsMeta ? baseDocsToRouteOptions(docsMeta) : undefined;
+            const methodDocs = docsMeta?.byMethod?.[rm.name];
+            const mergedOptions = mergeRouteOptions(rm.options, baseDocs, methodDocs);
             const methodBindings = bindingsMeta?.byMethod?.[rm.name];
             routes.push({
                 method: rm.method,
@@ -47,7 +57,7 @@ export function buildRegistry(controllers) {
                 routePath: rm.path,
                 handlerName: rm.name,
                 controller: ctor,
-                options: rm.options,
+                ...(mergedOptions ? { options: mergedOptions } : { options: rm.options }),
                 ...(methodBindings ? { bindings: { byMethod: { [rm.name]: methodBindings } } } : {}),
             });
         }
@@ -56,6 +66,40 @@ export function buildRegistry(controllers) {
     return {
         controllers: controllerEntries,
         routes,
+        ...(Object.keys(securitySchemes).length ? { securitySchemes } : {}),
     };
 }
+function baseDocsToRouteOptions(docs) {
+    const out = {};
+    if (docs.tags?.length)
+        out.tags = [...docs.tags];
+    if (docs.security !== undefined)
+        out.security = docs.security;
+    return Object.keys(out).length ? out : undefined;
+}
+function mergeRouteOptions(base, ...overlays) {
+    if (!base && overlays.every((o) => !o))
+        return base;
+    const out = { ...(base ?? {}) };
+    for (const overlay of overlays) {
+        if (!overlay)
+            continue;
+        if (overlay.tags?.length) {
+            out.tags = [...(out.tags ?? []), ...overlay.tags];
+        }
+        if (overlay.operationId !== undefined)
+            out.operationId = overlay.operationId;
+        if (overlay.deprecated !== undefined)
+            out.deprecated = overlay.deprecated;
+        if (overlay.security !== undefined)
+            out.security = overlay.security;
+        if (overlay.responses) {
+            out.responses = {
+                ...(out.responses ?? {}),
+                ...overlay.responses,
+            };
+        }
+    }
+    return out;
+}
 //# sourceMappingURL=buildRegistry.js.map

package/dist/core/registry/buildRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"buildRegistry.js","sourceRoot":"","sources":["../../../src/core/registry/buildRegistry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"buildRegistry.js","sourceRoot":"","sources":["../../../src/core/registry/buildRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,GAML,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAwB,MAAM,uBAAuB,CAAC;AACnF,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAKxD,SAAS,kBAAkB,CAAC,IAAqB;IAC/C,MAAM,KAAK,GAAsB,EAAE,CAAC;IACpC,IAAI,GAAG,GAA2B,IAAI,CAAC;IAEvC,OAAO,GAAG,IAAI,OAAO,GAAG,KAAK,UAAU,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChB,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,CAAC,GAAG,CAA2B,CAAC;QACpE,IAAI,CAAC,MAAM,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,QAAQ,CAAC,SAAS;YAAE,MAAM;QAC3E,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IAED,KAAK,CAAC,OAAO,EAAE,CAAC;IAEhB,IAAI,MAAM,GAAG,EAAkC,CAAC;IAChD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,qBAAqB,CAAC,IAAqB,EAAE,GAAiC;IACrF,MAAM,IAAI,GAAG,MAAM,CAAiB,GAAG,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAC1D,IAAI,CAAC,IAAI,EAAE,QAAQ,IAAI,IAAI,EAAE,QAAQ,KAAK,EAAE,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CACb,+BAA+B,IAAI,CAAC,IAAI,IAAI,mBAAmB,kCAAkC,CAClG,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,WAA6B;IACzD,MAAM,iBAAiB,GAAsB,EAAE,CAAC;IAChD,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,MAAM,eAAe,GAA6C,EAAE,CAAC;IAErE,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,SAAS,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAE3C,MAAM,cAAc,GAAG,qBAAqB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC9D,iBAAiB,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;QAEvD,MAAM,UAAU,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAgB,CAAC;QACjE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CACb,6BAA6B,IAAI,CAAC,IAAI,qCAAqC,CAC5E,CAAC;QACJ,CAAC;QACD,MAAM,YAAY,GAAG,SAAS,CAAC,IAAI,CAAC,QAAQ,CAA6B,CAAC;QAC1E,MAAM,QAAQ,GAAG,MAAM,CAAW,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACxD,MAAM,YAAY,GAAG,MAAM,CAAe,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpE,IAAI,YAAY,EAAE,OAAO,EAAE,CAAC;YAC1B,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;QACvD,CAAC;QAED,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,SAAS,CAAC,cAAc,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;YAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACzE,MAAM,UAAU,GAAG,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,IAAI,CAAqC,CAAC;YACrF,MAAM,aAAa,GAAG,iBAAiB,CACrC,EAAE,CAAC,OAA2C,EAC9C,QAAQ,EACR,UAAU,CACX,CAAC;YAEF,MAAM,cAAc,GAAG,YAAY,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;YACzD,MAAM,CAAC,IAAI,CAAC;gBACV,MAAM,EAAE,EAAE,CAAC,MAAM;gBACjB,QAAQ;gBACR,SAAS,EAAE,EAAE,CAAC,IAAI;gBAClB,WAAW,EAAE,EAAE,CAAC,IAAI;gBACpB,UAAU,EAAE,IAAI;gBAChB,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC;gBACzE,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACrF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAE/B,OAAO;QACL,WAAW,EAAE,iBAAiB;QAC9B,MAAM;QACN,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpE,CAAC;AACJ,CAAC;AAID,SAAS,sBAAsB,CAAC,IAAc;IAC5C,MAAM,GAAG,GAA6B,EAAE,CAAC;IAEzC,IAAI,IAAI,CAAC,IAAI,EAAE,MAAM;QAAE,GAAG,CAAC,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IACjD,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;QAAE,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAuC,CAAC;IAE7F,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AACnD,CAAC;AAED,SAAS,iBAAiB,CACxB,IAAiC,EACjC,GAAG,QAAqD;IAExD,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAEpD,MAAM,GAAG,GAAoB,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;IAEjD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC,OAAO;YAAE,SAAS;QAEvB,IAAI,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;YACzB,GAAG,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACpD,CAAC;QAED,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS;YAAE,GAAG,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QAC7E,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS;YAAE,GAAG,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QAC1E,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS;YAAE,GAAG,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QAEpE,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,GAAG,CAAC,SAAS,GAAG;gBACd,GAAG,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC;gBACxB,GAAG,OAAO,CAAC,SAAS;aACrB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/core/registry/types.d.ts

@@ -1,32 +1,225 @@
 import type { BindingsMeta, ControllerMeta, RouteMeta } from '../../metadata/keys.js';
-export type ControllerCtor<T = any> = new (...args: any[]) => T;
+import type { SecuritySchemeObject } from '../../contracts/openapi-v3.js';
+/**
+ * Constructor type for controller classes.
+ *
+ * Represents a class constructor that can be instantiated
+ * to create controller instances for handling requests.
+ *
+ * @template T - The controller instance type
+ *
+ * @example
+ * ```typescript
+ * // Controller class
+ * class UserController {
+ *   @Get('/users')
+ *   async listUsers() {
+ *     return await userService.findAll();
+ *   }
+ * }
+ *
+ * // Controller constructor type
+ * const UserControllerCtor: ControllerCtor<UserController> = UserController;
+ * ```
+ */
+export type ControllerCtor<T = unknown> = new (...args: never[]) => T;
+/**
+ * Registry entry for a controller.
+ *
+ * Contains the controller constructor and its associated metadata,
+ * which is used during route registration and runtime processing.
+ *
+ * @example
+ * ```typescript
+ * // Controller entry in registry
+ * const userControllerEntry: ControllerEntry = {
+ *   ctor: UserController,
+ *   meta: {
+ *     basePath: '/api/v1/users'
+ *   }
+ * };
+ * ```
+ */
 export type ControllerEntry = {
+    /** Controller constructor function */
     ctor: ControllerCtor;
+    /** Controller metadata including base path */
     meta: ControllerMeta;
 };
+/**
+ * Registry entry for an individual route.
+ *
+ * Contains comprehensive information about a route including its HTTP method,
+ * path templates, controller association, and configuration options.
+ * This information is used for request routing, OpenAPI generation,
+ * and runtime route processing.
+ *
+ * @example
+ * ```typescript
+ * // Route entry for a GET /users/:id endpoint
+ * const userRouteEntry: RouteEntry = {
+ *   method: 'GET',
+ *   fullPath: '/users/{id}',
+ *   routePath: '/{id}',
+ *   handlerName: 'getUser',
+ *   controller: UserController,
+ *   options: {
+ *     summary: 'Get user by ID',
+ *     responses: {
+ *       200: { description: 'User found' },
+ *       404: { description: 'User not found' }
+ *     }
+ *   },
+ *   bindings: {
+ *     byMethod: {
+ *       getUser: {
+ *         path: { id: 'uuid' }
+ *       }
+ *     }
+ *   }
+ * };
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Route entry for a POST /users endpoint
+ * const createUserRouteEntry: RouteEntry = {
+ *   method: 'POST',
+ *   fullPath: '/users',
+ *   routePath: '/',
+ *   handlerName: 'createUser',
+ *   controller: UserController,
+ *   options: {
+ *     summary: 'Create new user',
+ *     responses: {
+ *       201: { description: 'User created' },
+ *       400: { description: 'Invalid user data' }
+ *     }
+ *   }
+ * };
+ * ```
+ */
 export type RouteEntry = {
+    /** HTTP method for this route */
     method: RouteMeta['method'];
     /**
      * Full, normalized path template, e.g. "/users/{id}"
+     *
+     * This includes the controller base path combined with the route path
      */
     fullPath: string;
     /**
      * Raw route template as declared on the method, e.g. "/{id}"
+     *
+     * This is the path template as written in the decorator
      */
     routePath: string;
     /**
      * The handler name on the controller, e.g. "get"
+     *
+     * This is the method name where the route is defined
      */
     handlerName: string;
+    /** Controller constructor that defines this route */
     controller: ControllerCtor;
     /**
      * Whatever the decorator carried (docs/security/etc). Compiler can refine later.
+     *
+     * Contains route-specific configuration including documentation,
+     * security requirements, responses, and other metadata
      */
     options?: unknown;
+    /** Parameter binding configuration for this route */
     bindings?: BindingsMeta;
 };
+/**
+ * Complete route registry containing all registered controllers and routes.
+ *
+ * The registry is the central data structure that contains all the metadata
+ * needed for request routing, OpenAPI documentation generation,
+ * and runtime processing. It's built during application startup
+ * by scanning controller classes and their decorators.
+ *
+ * @example
+ * ```typescript
+ * // Example registry with user and product controllers
+ * const appRegistry: Registry = {
+ *   controllers: [
+ *     {
+ *       ctor: UserController,
+ *       meta: { basePath: '/api/v1/users' }
+ *     },
+ *     {
+ *       ctor: ProductController,
+ *       meta: { basePath: '/api/v1/products' }
+ *     }
+ *   ],
+ *   routes: [
+ *     // UserController routes
+ *     {
+ *       method: 'GET',
+ *       fullPath: '/api/v1/users',
+ *       routePath: '/',
+ *       handlerName: 'listUsers',
+ *       controller: UserController,
+ *       options: { summary: 'List all users' }
+ *     },
+ *     {
+ *       method: 'GET',
+ *       fullPath: '/api/v1/users/{id}',
+ *       routePath: '/{id}',
+ *       handlerName: 'getUser',
+ *       controller: UserController,
+ *       options: { summary: 'Get user by ID' }
+ *     },
+ *     // ProductController routes
+ *     {
+ *       method: 'GET',
+ *       fullPath: '/api/v1/products',
+ *       routePath: '/',
+ *       handlerName: 'listProducts',
+ *       controller: ProductController,
+ *       options: { summary: 'List all products' }
+ *     }
+ *   ],
+ *   securitySchemes: {
+ *     bearerAuth: {
+ *       type: 'http',
+ *       scheme: 'bearer',
+ *       bearerFormat: 'JWT'
+ *     }
+ *   }
+ * };
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Using the registry for OpenAPI generation
+ * import { buildOpenApi } from './openapi';
+ *
+ * const registry = buildRegistry([UserController, ProductController]);
+ * const openApiDoc = buildOpenApi(registry, {
+ *   title: 'My API',
+ *   version: '1.0.0'
+ * });
+ *
+ * // Using the registry for Express routing
+ * import { applyRegistryToExpressRouter } from './express';
+ *
+ * const router = express.Router();
+ * applyRegistryToExpressRouter(router, registry);
+ * ```
+ *
+ * @see buildRegistry for creating registries from controllers
+ * @see buildOpenApi for OpenAPI documentation generation
+ * @see applyRegistryToExpressRouter for Express integration
+ */
 export type Registry = {
+    /** Array of all registered controllers */
     controllers: ControllerEntry[];
+    /** Array of all registered routes */
     routes: RouteEntry[];
+    /** Security schemes available for the API */
+    securitySchemes?: Record<string, SecuritySchemeObject>;
 };
 //# sourceMappingURL=types.d.ts.map

package/dist/core/registry/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/registry/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEtF,MAAM,MAAM,cAAc,CAAC,CAAC,GAAG,GAAG,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAEhE,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,cAAc,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC5B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB,UAAU,EAAE,cAAc,CAAC;IAE3B;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,WAAW,EAAE,eAAe,EAAE,CAAC;IAC/B,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/registry/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAE1E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,GAAG,OAAO,IAAI,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AAEtE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,sCAAsC;IACtC,IAAI,EAAE,cAAc,CAAC;IACrB,8CAA8C;IAC9C,IAAI,EAAE,cAAc,CAAC;CACtB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,iCAAiC;IACjC,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB,qDAAqD;IACrD,UAAU,EAAE,cAAc,CAAC;IAE3B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiFG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,0CAA0C;IAC1C,WAAW,EAAE,eAAe,EAAE,CAAC;IAC/B,qCAAqC;IACrC,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,6CAA6C;IAC7C,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;CACxD,CAAC"}

package/dist/core/reply/reply.d.ts

@@ -1,8 +1,102 @@
 import type { Reply, ReplyHeaders } from '../../contracts/reply.js';
+/**
+ * Initialization options for creating Reply objects.
+ *
+ * These options allow customization of response headers and content type.
+ */
 export type ReplyInit = {
+    /** Custom response headers */
     headers?: ReplyHeaders;
+    /** Content type header (convenience property) */
     contentType?: string;
 };
+/**
+ * Creates a typed HTTP response with body content.
+ *
+ * This function creates a Reply object with status code, body, and optional headers.
+ * It's the primary way to create successful responses with content in Adorn API.
+ *
+ * @template TBody - Type of the response body
+ * @template TStatus - HTTP status code (must be a number literal)
+ * @param status - HTTP status code
+ * @param body - Response body content
+ * @param init - Optional initialization options (headers, contentType)
+ * @returns Typed Reply object
+ *
+ * @example
+ * ```typescript
+ * // Simple JSON response
+ * return reply(200, { message: 'Success', data: user });
+ *
+ * // Response with custom headers
+ * return reply(201, createdUser, {
+ *   headers: { 'Location': `/users/${createdUser.id}` },
+ *   contentType: 'application/json'
+ * });
+ *
+ * // Error response
+ * return reply(404, { error: 'User not found', code: 'USER_NOT_FOUND' });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // In a controller
+ * @Get('/users/:id')
+ * async getUser(id: string) {
+ *   const user = await userService.findById(id);
+ *   if (!user) {
+ *     return reply(404, { error: 'User not found' });
+ *   }
+ *   return reply(200, user);
+ * }
+ * ```
+ *
+ * @see Reply for the return type structure
+ * @see noContent for responses without body
+ */
 export declare function reply<TBody, const TStatus extends number>(status: TStatus, body: TBody, init?: ReplyInit): Reply<TBody, TStatus>;
+/**
+ * Creates a typed HTTP response without body content.
+ *
+ * This function creates a Reply object for responses that don't include a body,
+ * such as 204 No Content responses. It's commonly used for successful DELETE operations
+ * or other operations where no response body is needed.
+ *
+ * @template TStatus - HTTP status code (default: 204, must be a number literal)
+ * @param status - Optional HTTP status code (default: 204)
+ * @param init - Optional initialization options (headers, contentType)
+ * @returns Typed Reply object without body
+ *
+ * @example
+ * ```typescript
+ * // Standard 204 No Content response
+ * return noContent();
+ *
+ * // Custom no-content status with headers
+ * return noContent(202, {
+ *   headers: { 'X-Request-Processed': 'true' }
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // In a DELETE controller
+ * @Delete('/users/:id')
+ * async deleteUser(id: string) {
+ *   await userService.delete(id);
+ *   return noContent(); // 204 No Content
+ * }
+ *
+ * // Custom accepted response
+ * @Post('/users/bulk-delete')
+ * async bulkDeleteUser(ids: string[]) {
+ *   await userService.bulkDelete(ids);
+ *   return noContent(202); // 202 Accepted
+ * }
+ * ```
+ *
+ * @see Reply for the return type structure
+ * @see reply for responses with body content
+ */
 export declare function noContent<const TStatus extends number = 204>(status?: TStatus, init?: ReplyInit): Reply<undefined, TStatus>;
 //# sourceMappingURL=reply.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"reply.d.ts","sourceRoot":"","sources":["../../../src/core/reply/reply.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAEpE,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,wBAAgB,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,SAAS,MAAM,EACvD,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,KAAK,EACX,IAAI,GAAE,SAAc,GACnB,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAQvB;AAED,wBAAgB,SAAS,CAAC,KAAK,CAAC,OAAO,SAAS,MAAM,GAAG,GAAG,EAC1D,MAAM,CAAC,EAAE,OAAO,EAChB,IAAI,GAAE,SAAc,GACnB,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAO3B"}
+{"version":3,"file":"reply.d.ts","sourceRoot":"","sources":["../../../src/core/reply/reply.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAEpE;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,SAAS,MAAM,EACvD,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,KAAK,EACX,IAAI,GAAE,SAAc,GACnB,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAQvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,SAAS,CAAC,KAAK,CAAC,OAAO,SAAS,MAAM,GAAG,GAAG,EAC1D,MAAM,CAAC,EAAE,OAAO,EAChB,IAAI,GAAE,SAAc,GACnB,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAO3B"}