adorn-api 1.0.0 → 1.0.2

package/dist/core/openapi/schema/toOpenApi.js

@@ -0,0 +1,82 @@
+export function irToOasSchema(ir) {
+    switch (ir.kind) {
+        case 'string': {
+            const out = { type: 'string' };
+            if (ir.minLength !== undefined)
+                out.minLength = ir.minLength;
+            if (ir.maxLength !== undefined)
+                out.maxLength = ir.maxLength;
+            if (ir.pattern)
+                out.pattern = ir.pattern;
+            if (ir.format)
+                out.format = ir.format;
+            if (ir.enum)
+                out.enum = ir.enum;
+            return out;
+        }
+        case 'number': {
+            const out = { type: ir.int ? 'integer' : 'number' };
+            if (ir.int)
+                out.format = 'int32';
+            if (ir.min !== undefined)
+                out.minimum = ir.min;
+            if (ir.max !== undefined)
+                out.maximum = ir.max;
+            return out;
+        }
+        case 'boolean':
+            return { type: 'boolean' };
+        case 'literal': {
+            if (ir.value === null)
+                return { nullable: true };
+            if (typeof ir.value === 'string') {
+                return { type: 'string', enum: [ir.value] };
+            }
+            if (typeof ir.value === 'number') {
+                return { type: 'number', enum: [ir.value] };
+            }
+            if (typeof ir.value === 'boolean') {
+                return { type: 'boolean', enum: [ir.value] };
+            }
+            return { enum: [ir.value] };
+        }
+        case 'array': {
+            const out = {
+                type: 'array',
+                items: irToOasSchema(ir.items),
+            };
+            if (ir.minItems !== undefined)
+                out.minItems = ir.minItems;
+            if (ir.maxItems !== undefined)
+                out.maxItems = ir.maxItems;
+            return out;
+        }
+        case 'object': {
+            const props = {};
+            for (const [k, v] of Object.entries(ir.properties)) {
+                props[k] = irToOasSchema(v);
+            }
+            const out = {
+                type: 'object',
+                properties: props,
+            };
+            if (ir.required.length)
+                out.required = ir.required;
+            if (ir.strict)
+                out.additionalProperties = false;
+            return out;
+        }
+        case 'optional':
+            return irToOasSchema(ir.inner);
+        case 'nullable': {
+            const out = irToOasSchema(ir.inner);
+            out.nullable = true;
+            return out;
+        }
+        case 'union':
+            return { anyOf: ir.anyOf.map(irToOasSchema) };
+        default:
+            return {};
+    }
+}
+//# sourceMappingURL=toOpenApi.js.map

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

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

package/dist/core/pipeline/compose.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=compose.d.ts.map

package/dist/core/pipeline/compose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../../src/core/pipeline/compose.ts"],"names":[],"mappings":""}

package/dist/core/pipeline/compose.js

@@ -0,0 +1,3 @@
+export {};
+// placeholder for src\core\pipeline\compose.ts
+//# sourceMappingURL=compose.js.map

package/dist/core/pipeline/compose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.js","sourceRoot":"","sources":["../../../src/core/pipeline/compose.ts"],"names":[],"mappings":";AAAA,+CAA+C"}

package/dist/core/pipeline/errorMap.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=errorMap.d.ts.map

package/dist/core/pipeline/errorMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorMap.d.ts","sourceRoot":"","sources":["../../../src/core/pipeline/errorMap.ts"],"names":[],"mappings":""}

package/dist/core/pipeline/errorMap.js

@@ -0,0 +1,3 @@
+export {};
+// placeholder for src\core\pipeline\errorMap.ts
+//# sourceMappingURL=errorMap.js.map

package/dist/core/pipeline/errorMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorMap.js","sourceRoot":"","sources":["../../../src/core/pipeline/errorMap.ts"],"names":[],"mappings":";AAAA,gDAAgD"}

package/dist/core/pipeline/invoke.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=invoke.d.ts.map

package/dist/core/pipeline/invoke.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoke.d.ts","sourceRoot":"","sources":["../../../src/core/pipeline/invoke.ts"],"names":[],"mappings":""}

package/dist/core/pipeline/invoke.js

@@ -0,0 +1,3 @@
+export {};
+// placeholder for src\core\pipeline\invoke.ts
+//# sourceMappingURL=invoke.js.map

package/dist/core/pipeline/invoke.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoke.js","sourceRoot":"","sources":["../../../src/core/pipeline/invoke.ts"],"names":[],"mappings":";AAAA,8CAA8C"}

package/dist/core/pipeline/result.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=result.d.ts.map

package/dist/core/pipeline/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../../src/core/pipeline/result.ts"],"names":[],"mappings":""}

package/dist/core/pipeline/result.js

@@ -0,0 +1,3 @@
+export {};
+// placeholder for src\core\pipeline\result.ts
+//# sourceMappingURL=result.js.map

package/dist/core/pipeline/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../../src/core/pipeline/result.ts"],"names":[],"mappings":";AAAA,8CAA8C"}

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

@@ -0,0 +1,3 @@
+import type { ControllerCtor, Registry } from './types.js';
+export declare function buildRegistry(controllers: ControllerCtor[]): Registry;
+//# sourceMappingURL=buildRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,105 @@
+import { META, } from '../../metadata/keys.js';
+import { bagFromClass, bagGet } from '../../metadata/bag.js';
+import { mergeBags } from '../../metadata/merge.js';
+import { joinPaths } from './normalize.js';
+import { assertNoRouteConflicts } from './conflicts.js';
+function mergedBagFromClass(ctor) {
+    const chain = [];
+    let cur = ctor;
+    while (cur && typeof cur === 'function') {
+        chain.push(cur);
+        const parent = Object.getPrototypeOf(cur);
+        if (!parent || parent === Function || parent === Function.prototype)
+            break;
+        cur = parent;
+    }
+    chain.reverse();
+    let merged = {};
+    for (const c of chain) {
+        merged = mergeBags(merged, bagFromClass(c));
+    }
+    return merged;
+}
+function requireControllerMeta(ctor, bag) {
+    const meta = bagGet(bag, META.controller);
+    if (!meta?.basePath && meta?.basePath !== '') {
+        throw new Error(`Missing @Controller(...) on ${ctor.name || '(anonymous class)'} (no controller metadata found).`);
+    }
+    return meta;
+}
+export function buildRegistry(controllers) {
+    const controllerEntries = [];
+    const routes = [];
+    const securitySchemes = {};
+    for (const ctor of controllers) {
+        const mergedBag = mergedBagFromClass(ctor);
+        const controllerMeta = requireControllerMeta(ctor, mergedBag);
+        controllerEntries.push({ ctor, meta: controllerMeta });
+        const routeMetas = (mergedBag[META.routes] ?? []);
+        if (!Array.isArray(routeMetas)) {
+            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,
+                fullPath,
+                routePath: rm.path,
+                handlerName: rm.name,
+                controller: ctor,
+                ...(mergedOptions ? { options: mergedOptions } : { options: rm.options }),
+                ...(methodBindings ? { bindings: { byMethod: { [rm.name]: methodBindings } } } : {}),
+            });
+        }
+    }
+    assertNoRouteConflicts(routes);
+    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

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

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

@@ -0,0 +1,6 @@
+import type { RouteEntry } from './types.js';
+export declare class RouteConflictError extends Error {
+    constructor(message: string);
+}
+export declare function assertNoRouteConflicts(routes: RouteEntry[]): void;
+//# sourceMappingURL=conflicts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conflicts.d.ts","sourceRoot":"","sources":["../../../src/core/registry/conflicts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,CAiBjE"}

package/dist/core/registry/conflicts.js

@@ -0,0 +1,21 @@
+export class RouteConflictError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'RouteConflictError';
+    }
+}
+export function assertNoRouteConflicts(routes) {
+    const seen = new Map();
+    for (const r of routes) {
+        const key = `${r.method} ${r.fullPath}`;
+        const prev = seen.get(key);
+        if (!prev) {
+            seen.set(key, r);
+            continue;
+        }
+        throw new RouteConflictError(`Route conflict for "${key}": ` +
+            `${prev.controller.name}.${prev.handlerName} and ` +
+            `${r.controller.name}.${r.handlerName}`);
+    }
+}
+//# sourceMappingURL=conflicts.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conflicts.js","sourceRoot":"","sources":["../../../src/core/registry/conflicts.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAoB;IACzD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAsB,CAAC;IAE3C,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YACjB,SAAS;QACX,CAAC;QAED,MAAM,IAAI,kBAAkB,CAC1B,uBAAuB,GAAG,KAAK;YAC7B,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,OAAO;YAClD,GAAG,CAAC,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,CAAC,WAAW,EAAE,CAC1C,CAAC;IACJ,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,5 @@
+export * from './types.js';
+export * from './normalize.js';
+export * from './conflicts.js';
+export * from './buildRegistry.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/registry/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC"}

package/dist/core/registry/index.js

@@ -0,0 +1,5 @@
+export * from './types.js';
+export * from './normalize.js';
+export * from './conflicts.js';
+export * from './buildRegistry.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/registry/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC"}

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

@@ -0,0 +1,3 @@
+export declare function normalizePath(p: string): string;
+export declare function joinPaths(basePath: string, routePath: string): string;
+//# sourceMappingURL=normalize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../src/core/registry/normalize.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAS/C;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAUrE"}

package/dist/core/registry/normalize.js

@@ -0,0 +1,24 @@
+export function normalizePath(p) {
+    let out = (p ?? '').trim();
+    if (!out)
+        return '';
+    if (!out.startsWith('/'))
+        out = `/${out}`;
+    out = out.replace(/\/{2,}/g, '/');
+    if (out.length > 1 && out.endsWith('/'))
+        out = out.slice(0, -1);
+    return out;
+}
+export function joinPaths(basePath, routePath) {
+    const a = normalizePath(basePath);
+    const b = normalizePath(routePath);
+    if (!a && !b)
+        return '/';
+    if (!a)
+        return b || '/';
+    if (!b || b === '/')
+        return a || '/';
+    const joined = `${a}${b.startsWith('/') ? '' : '/'}${b}`;
+    return normalizePath(joined);
+}
+//# sourceMappingURL=normalize.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../../src/core/registry/normalize.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa,CAAC,CAAS;IACrC,IAAI,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;IAE1C,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAElC,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAChE,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,QAAgB,EAAE,SAAiB;IAC3D,MAAM,CAAC,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,CAAC,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IAEnC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,GAAG,CAAC;IACzB,IAAI,CAAC,CAAC;QAAE,OAAO,CAAC,IAAI,GAAG,CAAC;IACxB,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG;QAAE,OAAO,CAAC,IAAI,GAAG,CAAC;IAErC,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;IACzD,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC"}

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

@@ -0,0 +1,225 @@
+import type { BindingsMeta, ControllerMeta, RouteMeta } from '../../metadata/keys.js';
+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

@@ -0,0 +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;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/registry/types.js

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

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

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

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

@@ -0,0 +1,3 @@
+export * from './reply.js';
+export * from './typed.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/reply/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/core/reply/index.js

@@ -0,0 +1,3 @@
+export * from './reply.js';
+export * from './typed.js';
+//# sourceMappingURL=index.js.map

package/dist/core/reply/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/reply/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}