adorn-api 1.0.1 → 1.0.3

package/dist/decorators/docs.d.ts

@@ -1,2 +1,8 @@
+type Stage3ClassContext = ClassDecoratorContext;
+type Stage3MethodContext = ClassMethodDecoratorContext<unknown, (this: unknown, ...args: unknown[]) => unknown>;
+type DecoratorContext = Stage3ClassContext | Stage3MethodContext;
+export declare function Tags(...tags: string[]): (_value: unknown, context: DecoratorContext) => void;
+export declare function OperationId(id: string): (_value: unknown, context: Stage3MethodContext) => void;
+export declare function Deprecated(value?: boolean): (_value: unknown, context: Stage3MethodContext) => void;
 export {};
 //# sourceMappingURL=docs.d.ts.map

package/dist/decorators/docs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/decorators/docs.ts"],"names":[],"mappings":""}
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/decorators/docs.ts"],"names":[],"mappings":"AAIA,KAAK,kBAAkB,GAAG,qBAAqB,CAAC;AAChD,KAAK,mBAAmB,GAAG,2BAA2B,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAAC;AAChH,KAAK,gBAAgB,GAAG,kBAAkB,GAAG,mBAAmB,CAAC;AAkBjE,wBAAgB,IAAI,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,IACnB,QAAQ,OAAO,EAAE,SAAS,gBAAgB,UAc5D;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,IACnB,QAAQ,OAAO,EAAE,SAAS,mBAAmB,UAM/D;AAED,wBAAgB,UAAU,CAAC,KAAK,UAAO,IACpB,QAAQ,OAAO,EAAE,SAAS,mBAAmB,UAM/D"}

package/dist/decorators/docs.js

@@ -1,3 +1,46 @@
-export {};
-// placeholder for src\decorators\docs.ts
+import { META } from '../metadata/keys.js';
+import { bagEnsureObject, bagFromContext } from '../metadata/bag.js';
+function ensureDocsMeta(context) {
+    const bag = bagFromContext(context);
+    return bagEnsureObject(bag, META.docs, () => ({}));
+}
+function ensureMethodDocs(meta, method) {
+    meta.byMethod ??= {};
+    meta.byMethod[method] ??= {};
+    return meta.byMethod[method];
+}
+function mergeTags(existing, next) {
+    return [...(existing ?? []), ...next];
+}
+export function Tags(...tags) {
+    return function (_value, context) {
+        const meta = ensureDocsMeta(context);
+        const cleaned = tags.map((t) => t.trim()).filter(Boolean);
+        if (!cleaned.length)
+            return;
+        if (context.kind === 'class') {
+            meta.tags = mergeTags(meta.tags, cleaned);
+            return;
+        }
+        const method = String(context.name);
+        const methodDocs = ensureMethodDocs(meta, method);
+        methodDocs.tags = mergeTags(methodDocs.tags, cleaned);
+    };
+}
+export function OperationId(id) {
+    return function (_value, context) {
+        const meta = ensureDocsMeta(context);
+        const method = String(context.name);
+        const methodDocs = ensureMethodDocs(meta, method);
+        methodDocs.operationId = id;
+    };
+}
+export function Deprecated(value = true) {
+    return function (_value, context) {
+        const meta = ensureDocsMeta(context);
+        const method = String(context.name);
+        const methodDocs = ensureMethodDocs(meta, method);
+        methodDocs.deprecated = value;
+    };
+}
 //# sourceMappingURL=docs.js.map

package/dist/decorators/docs.js.map

@@ -1 +1 @@
-{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../src/decorators/docs.ts"],"names":[],"mappings":";AAAA,yCAAyC"}
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../src/decorators/docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAiB,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAQrE,SAAS,cAAc,CAAC,OAAyB;IAC/C,MAAM,GAAG,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACpC,OAAO,eAAe,CAAW,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAc,EAAE,MAAc;IACtD,IAAI,CAAC,QAAQ,KAAK,EAAE,CAAC;IACrB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC7B,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAc,CAAC;AAC5C,CAAC;AAED,SAAS,SAAS,CAAC,QAA8B,EAAE,IAAc;IAC/D,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,GAAG,IAAc;IACpC,OAAO,UAAU,MAAe,EAAE,OAAyB;QACzD,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC1D,IAAI,CAAC,OAAO,CAAC,MAAM;YAAE,OAAO;QAE5B,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC7B,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC1C,OAAO;QACT,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,UAAU,GAAG,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAClD,UAAU,CAAC,IAAI,GAAG,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,EAAU;IACpC,OAAO,UAAU,MAAe,EAAE,OAA4B;QAC5D,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,UAAU,GAAG,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAClD,UAAU,CAAC,WAAW,GAAG,EAAE,CAAC;IAC9B,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAK,GAAG,IAAI;IACrC,OAAO,UAAU,MAAe,EAAE,OAA4B;QAC5D,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,UAAU,GAAG,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAClD,UAAU,CAAC,UAAU,GAAG,KAAK,CAAC;IAChC,CAAC,CAAC;AACJ,CAAC"}

package/dist/decorators/index.d.ts

@@ -1,4 +1,7 @@
 export * from './controller.js';
 export * from './methods.js';
 export * from './binding.js';
+export * from './docs.js';
+export * from './responses.js';
+export * from './security.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}

package/dist/decorators/index.js

@@ -1,4 +1,7 @@
 export * from './controller.js';
 export * from './methods.js';
 export * from './binding.js';
+export * from './docs.js';
+export * from './responses.js';
+export * from './security.js';
 //# sourceMappingURL=index.js.map

package/dist/decorators/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}

package/dist/decorators/methods.d.ts

@@ -13,12 +13,134 @@ type SuccessBodyType<O> = BodyTypeFromResponses<ResponsesFromOptions<O>>;
 type ReplyWithBodyTypes<R extends ResponsesSpec | undefined> = R extends ResponsesSpec ? SuccessStatusesWithBody<R> extends never ? never : Reply<BodySchemaFromResponses<R> extends Schema<infer T> ? T : unknown, SuccessStatusesWithBody<R>> : never;
 type ReplyNoBodyTypes<R extends ResponsesSpec | undefined> = R extends ResponsesSpec ? SuccessStatusesNoBody<R> extends never ? never : Reply<undefined, SuccessStatusesNoBody<R>> : never;
 type IsNever<T> = [T] extends [never] ? true : false;
-type HandlerReply<R extends ResponsesSpec | undefined> = R extends ResponsesSpec ? (IsNever<ReplyWithBodyTypes<R>> extends true ? never : ReplyWithBodyTypes<R>) | (IsNever<ReplyNoBodyTypes<R>> extends true ? never : ReplyNoBodyTypes<R>) : Reply<any, number>;
+type HandlerReply<R extends ResponsesSpec | undefined> = R extends ResponsesSpec ? (IsNever<ReplyWithBodyTypes<R>> extends true ? never : ReplyWithBodyTypes<R>) | (IsNever<ReplyNoBodyTypes<R>> extends true ? never : ReplyNoBodyTypes<R>) : Reply<unknown, number>;
 type HandlerReturn<O extends RouteOptions<string> | undefined> = MaybePromise<SuccessBodyType<O> | HandlerReply<ResponsesFromOptions<O>>>;
-export declare function Get<Path extends string, const O extends RouteOptions<Path> | undefined>(path: Path, options?: O): <This, Args extends any[], Ret extends HandlerReturn<O>>(value: (this: This, ...args: Args) => Ret, context: ClassMethodDecoratorContext<This, (this: This, ...args: Args) => Ret>) => (this: This, ...args: Args) => Ret;
-export declare function Post<Path extends string, const O extends RouteOptions<Path> | undefined>(path: Path, options?: O): <This, Args extends any[], Ret extends HandlerReturn<O>>(value: (this: This, ...args: Args) => Ret, context: ClassMethodDecoratorContext<This, (this: This, ...args: Args) => Ret>) => (this: This, ...args: Args) => Ret;
-export declare function Put<Path extends string, const O extends RouteOptions<Path> | undefined>(path: Path, options?: O): <This, Args extends any[], Ret extends HandlerReturn<O>>(value: (this: This, ...args: Args) => Ret, context: ClassMethodDecoratorContext<This, (this: This, ...args: Args) => Ret>) => (this: This, ...args: Args) => Ret;
-export declare function Patch<Path extends string, const O extends RouteOptions<Path> | undefined>(path: Path, options?: O): <This, Args extends any[], Ret extends HandlerReturn<O>>(value: (this: This, ...args: Args) => Ret, context: ClassMethodDecoratorContext<This, (this: This, ...args: Args) => Ret>) => (this: This, ...args: Args) => Ret;
-export declare function Delete<Path extends string, const O extends RouteOptions<Path> | undefined>(path: Path, options?: O): <This, Args extends any[], Ret extends HandlerReturn<O>>(value: (this: This, ...args: Args) => Ret, context: ClassMethodDecoratorContext<This, (this: This, ...args: Args) => Ret>) => (this: This, ...args: Args) => Ret;
+/**
+ * Decorator for HTTP GET method endpoints.
+ *
+ * @template Path - The route path as a string literal
+ * @template O - Route options extending RouteOptions for the path
+ * @param path - The route path (e.g., '/users', '/users/:id')
+ * @param options - Optional route configuration including responses, validation, etc.
+ * @returns Method decorator for class methods
+ *
+ * @example
+ * ```typescript
+ * class UserController {
+ *   @Get('/users')
+ *   async listUsers() {
+ *     return await userService.findAll();
+ *   }
+ *
+ *   @Get('/users/:id')
+ *   async getUser(id: string) {
+ *     return await userService.findById(id);
+ *   }
+ * }
+ * ```
+ *
+ * @see RouteOptions for available configuration options
+ */
+export declare function Get<Path extends string, const O extends RouteOptions<Path> | undefined>(path: Path, options?: O): <This, Args extends unknown[], Ret extends HandlerReturn<O>>(value: (this: This, ...args: Args) => Ret, context: ClassMethodDecoratorContext<This, (this: This, ...args: Args) => Ret>) => (this: This, ...args: Args) => Ret;
+/**
+ * Decorator for HTTP POST method endpoints.
+ *
+ * @template Path - The route path as a string literal
+ * @template O - Route options extending RouteOptions for the path
+ * @param path - The route path (e.g., '/users', '/users/:id/comments')
+ * @param options - Optional route configuration including responses, validation, etc.
+ * @returns Method decorator for class methods
+ *
+ * @example
+ * ```typescript
+ * class UserController {
+ *   @Post('/users')
+ *   async createUser(@Body() userData: CreateUserDto) {
+ *     return await userService.create(userData);
+ *   }
+ *
+ *   @Post('/users/:id/activate')
+ *   async activateUser(id: string) {
+ *     return await userService.activate(id);
+ *   }
+ * }
+ * ```
+ *
+ * @see RouteOptions for available configuration options
+ */
+export declare function Post<Path extends string, const O extends RouteOptions<Path> | undefined>(path: Path, options?: O): <This, Args extends unknown[], Ret extends HandlerReturn<O>>(value: (this: This, ...args: Args) => Ret, context: ClassMethodDecoratorContext<This, (this: This, ...args: Args) => Ret>) => (this: This, ...args: Args) => Ret;
+/**
+ * Decorator for HTTP PUT method endpoints.
+ *
+ * @template Path - The route path as a string literal
+ * @template O - Route options extending RouteOptions for the path
+ * @param path - The route path (e.g., '/users/:id')
+ * @param options - Optional route configuration including responses, validation, etc.
+ * @returns Method decorator for class methods
+ *
+ * @example
+ * ```typescript
+ * class UserController {
+ *   @Put('/users/:id')
+ *   async updateUser(id: string, @Body() userData: UpdateUserDto) {
+ *     return await userService.update(id, userData);
+ *   }
+ * }
+ * ```
+ *
+ * @see RouteOptions for available configuration options
+ */
+export declare function Put<Path extends string, const O extends RouteOptions<Path> | undefined>(path: Path, options?: O): <This, Args extends unknown[], Ret extends HandlerReturn<O>>(value: (this: This, ...args: Args) => Ret, context: ClassMethodDecoratorContext<This, (this: This, ...args: Args) => Ret>) => (this: This, ...args: Args) => Ret;
+/**
+ * Decorator for HTTP PATCH method endpoints.
+ *
+ * @template Path - The route path as a string literal
+ * @template O - Route options extending RouteOptions for the path
+ * @param path - The route path (e.g., '/users/:id')
+ * @param options - Optional route configuration including responses, validation, etc.
+ * @returns Method decorator for class methods
+ *
+ * @example
+ * ```typescript
+ * class UserController {
+ *   @Patch('/users/:id')
+ *   async partialUpdate(id: string, @Body() partialData: Partial<User>) {
+ *     return await userService.patch(id, partialData);
+ *   }
+ * }
+ * ```
+ *
+ * @see RouteOptions for available configuration options
+ */
+export declare function Patch<Path extends string, const O extends RouteOptions<Path> | undefined>(path: Path, options?: O): <This, Args extends unknown[], Ret extends HandlerReturn<O>>(value: (this: This, ...args: Args) => Ret, context: ClassMethodDecoratorContext<This, (this: This, ...args: Args) => Ret>) => (this: This, ...args: Args) => Ret;
+/**
+ * Decorator for HTTP DELETE method endpoints.
+ *
+ * @template Path - The route path as a string literal
+ * @template O - Route options extending RouteOptions for the path
+ * @param path - The route path (e.g., '/users/:id')
+ * @param options - Optional route configuration including responses, validation, etc.
+ * @returns Method decorator for class methods
+ *
+ * @example
+ * ```typescript
+ * class UserController {
+ *   @Delete('/users/:id')
+ *   async deleteUser(id: string) {
+ *     await userService.delete(id);
+ *     return { success: true };
+ *   }
+ *
+ *   @Delete('/users')
+ *   async deleteAllUsers() {
+ *     await userService.deleteAll();
+ *     return { deletedCount: await userService.count() };
+ *   }
+ * }
+ * ```
+ *
+ * @see RouteOptions for available configuration options
+ */
+export declare function Delete<Path extends string, const O extends RouteOptions<Path> | undefined>(path: Path, options?: O): <This, Args extends unknown[], Ret extends HandlerReturn<O>>(value: (this: This, ...args: Args) => Ret, context: ClassMethodDecoratorContext<This, (this: This, ...args: Args) => Ret>) => (this: This, ...args: Args) => Ret;
 export {};
 //# sourceMappingURL=methods.d.ts.map

package/dist/decorators/methods.d.ts.map

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

package/dist/decorators/methods.js

@@ -2,6 +2,8 @@ import { META } from '../metadata/keys.js';
 import { bagFromContext, bagPush } from '../metadata/bag.js';
 /**
  * Internal helper: store route metadata for a method.
+ * @param context - The decorator context
+ * @param route - Route metadata without the name property
  */
 function addRoute(context, route) {
     const bag = bagFromContext(context);
@@ -28,18 +30,140 @@ function createMethodDecorator(method, path, options) {
         return value;
     };
 }
+/**
+ * Decorator for HTTP GET method endpoints.
+ *
+ * @template Path - The route path as a string literal
+ * @template O - Route options extending RouteOptions for the path
+ * @param path - The route path (e.g., '/users', '/users/:id')
+ * @param options - Optional route configuration including responses, validation, etc.
+ * @returns Method decorator for class methods
+ *
+ * @example
+ * ```typescript
+ * class UserController {
+ *   @Get('/users')
+ *   async listUsers() {
+ *     return await userService.findAll();
+ *   }
+ *
+ *   @Get('/users/:id')
+ *   async getUser(id: string) {
+ *     return await userService.findById(id);
+ *   }
+ * }
+ * ```
+ *
+ * @see RouteOptions for available configuration options
+ */
 export function Get(path, options) {
     return createMethodDecorator('GET', path, options);
 }
+/**
+ * Decorator for HTTP POST method endpoints.
+ *
+ * @template Path - The route path as a string literal
+ * @template O - Route options extending RouteOptions for the path
+ * @param path - The route path (e.g., '/users', '/users/:id/comments')
+ * @param options - Optional route configuration including responses, validation, etc.
+ * @returns Method decorator for class methods
+ *
+ * @example
+ * ```typescript
+ * class UserController {
+ *   @Post('/users')
+ *   async createUser(@Body() userData: CreateUserDto) {
+ *     return await userService.create(userData);
+ *   }
+ *
+ *   @Post('/users/:id/activate')
+ *   async activateUser(id: string) {
+ *     return await userService.activate(id);
+ *   }
+ * }
+ * ```
+ *
+ * @see RouteOptions for available configuration options
+ */
 export function Post(path, options) {
     return createMethodDecorator('POST', path, options);
 }
+/**
+ * Decorator for HTTP PUT method endpoints.
+ *
+ * @template Path - The route path as a string literal
+ * @template O - Route options extending RouteOptions for the path
+ * @param path - The route path (e.g., '/users/:id')
+ * @param options - Optional route configuration including responses, validation, etc.
+ * @returns Method decorator for class methods
+ *
+ * @example
+ * ```typescript
+ * class UserController {
+ *   @Put('/users/:id')
+ *   async updateUser(id: string, @Body() userData: UpdateUserDto) {
+ *     return await userService.update(id, userData);
+ *   }
+ * }
+ * ```
+ *
+ * @see RouteOptions for available configuration options
+ */
 export function Put(path, options) {
     return createMethodDecorator('PUT', path, options);
 }
+/**
+ * Decorator for HTTP PATCH method endpoints.
+ *
+ * @template Path - The route path as a string literal
+ * @template O - Route options extending RouteOptions for the path
+ * @param path - The route path (e.g., '/users/:id')
+ * @param options - Optional route configuration including responses, validation, etc.
+ * @returns Method decorator for class methods
+ *
+ * @example
+ * ```typescript
+ * class UserController {
+ *   @Patch('/users/:id')
+ *   async partialUpdate(id: string, @Body() partialData: Partial<User>) {
+ *     return await userService.patch(id, partialData);
+ *   }
+ * }
+ * ```
+ *
+ * @see RouteOptions for available configuration options
+ */
 export function Patch(path, options) {
     return createMethodDecorator('PATCH', path, options);
 }
+/**
+ * Decorator for HTTP DELETE method endpoints.
+ *
+ * @template Path - The route path as a string literal
+ * @template O - Route options extending RouteOptions for the path
+ * @param path - The route path (e.g., '/users/:id')
+ * @param options - Optional route configuration including responses, validation, etc.
+ * @returns Method decorator for class methods
+ *
+ * @example
+ * ```typescript
+ * class UserController {
+ *   @Delete('/users/:id')
+ *   async deleteUser(id: string) {
+ *     await userService.delete(id);
+ *     return { success: true };
+ *   }
+ *
+ *   @Delete('/users')
+ *   async deleteAllUsers() {
+ *     await userService.deleteAll();
+ *     return { deletedCount: await userService.count() };
+ *   }
+ * }
+ * ```
+ *
+ * @see RouteOptions for available configuration options
+ */
 export function Delete(path, options) {
     return createMethodDecorator('DELETE', path, options);
 }

package/dist/decorators/methods.js.map

@@ -1 +1 @@
-{"version":3,"file":"methods.js","sourceRoot":"","sources":["../../src/decorators/methods.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAkB,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAsD7D;;GAEG;AACH,SAAS,QAAQ,CAAC,OAA4B,EAAE,KAA8B;IAC5E,MAAM,GAAG,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAElC,MAAM,IAAI,GAAc;QACtB,GAAG,KAAK;QACR,IAAI;KACL,CAAC;IAEF,OAAO,CAAY,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,kBAAkB,CAAC,CAAS;IACnC,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAClB,IAAI,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACnB,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;IAC1C,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7D,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,qBAAqB,CAC5B,MAA2B,EAC3B,IAAU,EACV,OAAW;IAEX,OAAO,UACL,KAAyC,EACzC,OAA8E;QAE9E,QAAQ,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QACvE,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,GAAG,CACjB,IAAU,EACV,OAAW;IAEX,OAAO,qBAAqB,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,IAAI,CAClB,IAAU,EACV,OAAW;IAEX,OAAO,qBAAqB,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,GAAG,CACjB,IAAU,EACV,OAAW;IAEX,OAAO,qBAAqB,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,KAAK,CACnB,IAAU,EACV,OAAW;IAEX,OAAO,qBAAqB,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,MAAM,CACpB,IAAU,EACV,OAAW;IAEX,OAAO,qBAAqB,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AACxD,CAAC"}
+{"version":3,"file":"methods.js","sourceRoot":"","sources":["../../src/decorators/methods.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAkB,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAuD7D;;;;GAIG;AACH,SAAS,QAAQ,CACf,OAA6C,EAC7C,KAA8B;IAE9B,MAAM,GAAG,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAElC,MAAM,IAAI,GAAc;QACtB,GAAG,KAAK;QACR,IAAI;KACL,CAAC;IAEF,OAAO,CAAY,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,kBAAkB,CAAC,CAAS;IACnC,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAClB,IAAI,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACnB,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;IAC1C,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7D,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,qBAAqB,CAC5B,MAA2B,EAC3B,IAAU,EACV,OAAW;IAEX,OAAO,UACL,KAAyC,EACzC,OAA8E;QAE9E,QAAQ,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QACvE,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,GAAG,CACjB,IAAU,EACV,OAAW;IAEX,OAAO,qBAAqB,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AACrD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,IAAI,CAClB,IAAU,EACV,OAAW;IAEX,OAAO,qBAAqB,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AACtD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,GAAG,CACjB,IAAU,EACV,OAAW;IAEX,OAAO,qBAAqB,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AACrD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,KAAK,CACnB,IAAU,EACV,OAAW;IAEX,OAAO,qBAAqB,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AACvD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,MAAM,CACpB,IAAU,EACV,OAAW;IAEX,OAAO,qBAAqB,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AACxD,CAAC"}

package/dist/decorators/responses.d.ts

@@ -1,2 +1,7 @@
+import type { ResponseSpec, ResponsesSpec } from '../contracts/responses.js';
+import type { Schema } from '../validation/native/schema.js';
+type Stage3MethodContext = ClassMethodDecoratorContext<unknown, (this: unknown, ...args: unknown[]) => unknown>;
+export declare function Responses(spec: ResponsesSpec): (_value: unknown, context: Stage3MethodContext) => void;
+export declare function Response(status: number | string, spec?: ResponseSpec | Schema<unknown> | string): (_value: unknown, context: Stage3MethodContext) => void;
 export {};
 //# sourceMappingURL=responses.d.ts.map

package/dist/decorators/responses.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"responses.d.ts","sourceRoot":"","sources":["../../src/decorators/responses.ts"],"names":[],"mappings":""}
+{"version":3,"file":"responses.d.ts","sourceRoot":"","sources":["../../src/decorators/responses.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC7E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AAE7D,KAAK,mBAAmB,GAAG,2BAA2B,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAAC;AAmBhH,wBAAgB,SAAS,CAAC,IAAI,EAAE,aAAa,IAC1B,QAAQ,OAAO,EAAE,SAAS,mBAAmB,UAO/D;AAED,wBAAgB,QAAQ,CACtB,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,IAAI,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,IAE7B,QAAQ,OAAO,EAAE,SAAS,mBAAmB,UAgB/D"}

package/dist/decorators/responses.js

@@ -1,3 +1,44 @@
-export {};
-// placeholder for src\decorators\responses.ts
+import { META } from '../metadata/keys.js';
+import { bagEnsureObject, bagFromContext } from '../metadata/bag.js';
+function ensureDocsMeta(context) {
+    const bag = bagFromContext(context);
+    return bagEnsureObject(bag, META.docs, () => ({}));
+}
+function ensureResponses(meta, method) {
+    meta.byMethod ??= {};
+    meta.byMethod[method] ??= {};
+    const existing = meta.byMethod[method];
+    if (!existing.responses)
+        existing.responses = {};
+    return existing.responses;
+}
+function isSchema(value) {
+    return !!value && typeof value === 'object' && typeof value.parse === 'function';
+}
+export function Responses(spec) {
+    return function (_value, context) {
+        const meta = ensureDocsMeta(context);
+        const method = String(context.name);
+        const responses = ensureResponses(meta, method);
+        Object.assign(responses, spec);
+    };
+}
+export function Response(status, spec) {
+    return function (_value, context) {
+        const meta = ensureDocsMeta(context);
+        const method = String(context.name);
+        const responses = ensureResponses(meta, method);
+        let value;
+        if (typeof spec === 'string') {
+            value = { description: spec };
+        }
+        else if (spec && isSchema(spec)) {
+            value = spec;
+        }
+        else {
+            value = spec ?? {};
+        }
+        responses[String(status)] = value;
+    };
+}
 //# sourceMappingURL=responses.js.map

package/dist/decorators/responses.js.map

@@ -1 +1 @@
-{"version":3,"file":"responses.js","sourceRoot":"","sources":["../../src/decorators/responses.ts"],"names":[],"mappings":";AAAA,8CAA8C"}
+{"version":3,"file":"responses.js","sourceRoot":"","sources":["../../src/decorators/responses.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAiB,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAMrE,SAAS,cAAc,CAAC,OAA4B;IAClD,MAAM,GAAG,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACpC,OAAO,eAAe,CAAW,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,eAAe,CAAC,IAAc,EAAE,MAAc;IACrD,IAAI,CAAC,QAAQ,KAAK,EAAE,CAAC;IACrB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAkC,CAAC;IACxE,IAAI,CAAC,QAAQ,CAAC,SAAS;QAAE,QAAQ,CAAC,SAAS,GAAG,EAAE,CAAC;IACjD,OAAO,QAAQ,CAAC,SAAS,CAAC;AAC5B,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAQ,KAA6B,CAAC,KAAK,KAAK,UAAU,CAAC;AAC5G,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAmB;IAC3C,OAAO,UAAU,MAAe,EAAE,OAA4B;QAC5D,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,SAAS,GAAG,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAEhD,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,QAAQ,CACtB,MAAuB,EACvB,IAA8C;IAE9C,OAAO,UAAU,MAAe,EAAE,OAA4B;QAC5D,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,SAAS,GAAG,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAEhD,IAAI,KAAqC,CAAC;QAC1C,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,KAAK,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;QAChC,CAAC;aAAM,IAAI,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;aAAM,CAAC;YACN,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC;QACrB,CAAC;QAED,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC;IACpC,CAAC,CAAC;AACJ,CAAC"}

package/dist/decorators/security.d.ts

@@ -1,2 +1,8 @@
+import type { SecurityRequirementObject, SecuritySchemeObject } from '../contracts/openapi-v3.js';
+type Stage3ClassContext = ClassDecoratorContext;
+type Stage3MethodContext = ClassMethodDecoratorContext<unknown, (this: unknown, ...args: unknown[]) => unknown>;
+type DecoratorContext = Stage3ClassContext | Stage3MethodContext;
+export declare function Security(nameOrReq: string | SecurityRequirementObject | SecurityRequirementObject[], scopes?: string[]): (_value: unknown, context: DecoratorContext) => void;
+export declare function SecurityScheme(name: string, scheme: SecuritySchemeObject): (_value: unknown, context: Stage3ClassContext) => void;
 export {};
 //# sourceMappingURL=security.d.ts.map

package/dist/decorators/security.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../src/decorators/security.ts"],"names":[],"mappings":""}
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../src/decorators/security.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAGlG,KAAK,kBAAkB,GAAG,qBAAqB,CAAC;AAChD,KAAK,mBAAmB,GAAG,2BAA2B,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAAC;AAChH,KAAK,gBAAgB,GAAG,kBAAkB,GAAG,mBAAmB,CAAC;AA4BjE,wBAAgB,QAAQ,CACtB,SAAS,EAAE,MAAM,GAAG,yBAAyB,GAAG,yBAAyB,EAAE,EAC3E,MAAM,CAAC,EAAE,MAAM,EAAE,IAEA,QAAQ,OAAO,EAAE,SAAS,gBAAgB,UAO5D;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,IACtD,QAAQ,OAAO,EAAE,SAAS,kBAAkB,UAO9D"}

package/dist/decorators/security.js

@@ -1,3 +1,39 @@
-export {};
-// placeholder for src\decorators\security.ts
+import { META } from '../metadata/keys.js';
+import { bagEnsureObject, bagFromContext } from '../metadata/bag.js';
+function ensureDocsMeta(context) {
+    const bag = bagFromContext(context);
+    return bagEnsureObject(bag, META.docs, () => ({}));
+}
+function ensureSecurityTarget(meta, context) {
+    if (context.kind === 'class')
+        return meta;
+    const method = String(context.name);
+    meta.byMethod ??= {};
+    meta.byMethod[method] ??= {};
+    return meta.byMethod[method];
+}
+function normalizeRequirements(nameOrReq, scopes) {
+    if (typeof nameOrReq === 'string') {
+        return [{ [nameOrReq]: scopes ?? [] }];
+    }
+    if (Array.isArray(nameOrReq))
+        return nameOrReq;
+    return [nameOrReq];
+}
+export function Security(nameOrReq, scopes) {
+    return function (_value, context) {
+        const meta = ensureDocsMeta(context);
+        const target = ensureSecurityTarget(meta, context);
+        const next = normalizeRequirements(nameOrReq, scopes);
+        target.security = [...(target.security ?? []), ...next];
+    };
+}
+export function SecurityScheme(name, scheme) {
+    return function (_value, context) {
+        const bag = bagFromContext(context);
+        const meta = bagEnsureObject(bag, META.security, () => ({}));
+        meta.schemes ??= {};
+        meta.schemes[name] = scheme;
+    };
+}
 //# sourceMappingURL=security.js.map

package/dist/decorators/security.js.map

@@ -1 +1 @@
-{"version":3,"file":"security.js","sourceRoot":"","sources":["../../src/decorators/security.ts"],"names":[],"mappings":";AAAA,6CAA6C"}
+{"version":3,"file":"security.js","sourceRoot":"","sources":["../../src/decorators/security.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAoC,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAQrE,SAAS,cAAc,CAAC,OAAyB;IAC/C,MAAM,GAAG,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACpC,OAAO,eAAe,CAAW,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAc,EAAE,OAAyB;IACrE,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1C,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,CAAC,QAAQ,KAAK,EAAE,CAAC;IACrB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC7B,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAkC,CAAC;AAChE,CAAC;AAED,SAAS,qBAAqB,CAC5B,SAA2E,EAC3E,MAAiB;IAEjB,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;QAClC,OAAO,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,IAAI,EAAE,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/C,OAAO,CAAC,SAAS,CAAC,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,QAAQ,CACtB,SAA2E,EAC3E,MAAiB;IAEjB,OAAO,UAAU,MAAe,EAAE,OAAyB;QACzD,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,oBAAoB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACnD,MAAM,IAAI,GAAG,qBAAqB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAEtD,MAAM,CAAC,QAAQ,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAC1D,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,MAA4B;IACvE,OAAO,UAAU,MAAe,EAAE,OAA2B;QAC3D,MAAM,GAAG,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;QACpC,MAAM,IAAI,GAAG,eAAe,CAAe,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAE3E,IAAI,CAAC,OAAO,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;IAC9B,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,6 @@
-export * from './core/errors/index.js';
-export * from './contracts/validator.js';
+export * from './decorators/index.js';
+export { HttpError, ValidationError } from './core/errors/index.js';
+export { toProblemDetails } from './core/errors/index.js';
 export * from './validation/native/index.js';
 export * from './core/openapi/index.js';
 export * from './contracts/openapi.js';
@@ -7,6 +8,8 @@ export * from './contracts/responses.js';
 export * from './contracts/reply.js';
 export * from './core/reply/index.js';
 export * from './core/route/index.js';
+export * from './core/registry/index.js';
 export * from './contracts/route-options.js';
 export * from './contracts/route-typing.js';
+export * from './contracts/validator.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,uBAAuB,CAAC;AAGtC,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D,cAAc,8BAA8B,CAAC;AAG7C,cAAc,yBAAyB,CAAC;AAGxC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,0BAA0B,CAAC;AAGzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAG5C,cAAc,0BAA0B,CAAC"}

package/dist/index.js

@@ -1,12 +1,27 @@
-export * from './core/errors/index.js';
-export * from './contracts/validator.js';
+// Public API exports for adorn-api
+// This file defines the stable public API surface that users can rely on
+// Core decorators - these are the main public API
+export * from './decorators/index.js';
+// Error types - public error classes
+export { HttpError, ValidationError } from './core/errors/index.js';
+export { toProblemDetails } from './core/errors/index.js';
+// Validation - public validation API
 export * from './validation/native/index.js';
+// OpenAPI generation - public API for generating OpenAPI docs
 export * from './core/openapi/index.js';
+// OpenAPI contracts - public types for OpenAPI
 export * from './contracts/openapi.js';
+// Response handling - public API for responses
 export * from './contracts/responses.js';
 export * from './contracts/reply.js';
 export * from './core/reply/index.js';
+// Route definitions - public API for route configuration
 export * from './core/route/index.js';
+// Registry types - public types for the registry system
+export * from './core/registry/index.js';
+// Route options and typing - public API for route configuration
 export * from './contracts/route-options.js';
 export * from './contracts/route-typing.js';
+// Validator contracts - public validation types
+export * from './contracts/validator.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,yEAAyE;AAEzE,kDAAkD;AAClD,cAAc,uBAAuB,CAAC;AAEtC,qCAAqC;AACrC,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,qCAAqC;AACrC,cAAc,8BAA8B,CAAC;AAE7C,8DAA8D;AAC9D,cAAc,yBAAyB,CAAC;AAExC,+CAA+C;AAC/C,cAAc,wBAAwB,CAAC;AAEvC,+CAA+C;AAC/C,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AAEtC,yDAAyD;AACzD,cAAc,uBAAuB,CAAC;AAEtC,wDAAwD;AACxD,cAAc,0BAA0B,CAAC;AAEzC,gEAAgE;AAChE,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAE5C,gDAAgD;AAChD,cAAc,0BAA0B,CAAC"}