adorn-api 1.0.0 → 1.0.2

package/dist/core/responses/pickStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pickStatus.js","sourceRoot":"","sources":["../../../src/core/responses/pickStatus.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,UAAU,iBAAiB,CAAC,MAAc,EAAE,SAAyB,EAAE,QAAiB;IAC5F,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAElD,MAAM,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IAE/B,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,UAAU,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;QAEjD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC;aAClC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;aAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;aACrB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC;aAClC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAEzB,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjB,IAAI,CAAC,KAAK,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;gBAAE,OAAO,GAAG,CAAC;YACpD,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;gBAAE,OAAO,GAAG,CAAC;YACpC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,IAAI,CAAC,KAAK,MAAM;QAAE,OAAO,GAAG,CAAC;IAC7B,IAAI,CAAC,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IAC/B,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/core/route/defineRoute.d.ts

@@ -0,0 +1,74 @@
+import type { ResponsesSpec } from '../../contracts/responses.js';
+import type { RouteOptions } from '../../contracts/route-options.js';
+import { makeReply } from '../reply/typed.js';
+/**
+ * Route definition that carries:
+ * - path: use in decorator
+ * - options: use in decorator
+ * - reply: typed reply/noContent bound to responses
+ *
+ * @template Path - The route path as a string literal
+ * @template R - The responses specification for this route
+ */
+export type RouteDef<Path extends string, R extends ResponsesSpec> = {
+    /** The route path */
+    path: Path;
+    /** Route configuration and responses */
+    options: RouteOptions<Path> & {
+        responses: R;
+    };
+    /** Typed reply function bound to the route's responses */
+    reply: ReturnType<typeof makeReply<R>>;
+};
+/**
+ * Creates a route definition with typed responses and reply functions.
+ *
+ * @template Path - The route path as a string literal
+ * @template R - The responses specification for this route
+ * @param path - The route path (e.g., '/users', '/users/:id')
+ * @param options - Route configuration including responses specification
+ * @returns Route definition with typed reply function
+ *
+ * @example
+ * ```typescript
+ * const userRoute = defineRoute('/users', {
+ *   responses: {
+ *     200: { content: { 'application/json': { schema: userSchema } } },
+ *     404: { description: 'User not found' }
+ *   }
+ * });
+ *
+ * // Use the typed reply function
+ * const reply = userRoute.reply(200, userData);
+ * ```
+ *
+ * @see RouteOptions for available configuration options
+ * @see ResponsesSpec for response specification format
+ */
+export declare function defineRoute<Path extends string, const R extends ResponsesSpec>(path: Path, options: RouteOptions<Path> & {
+    responses: R;
+}): RouteDef<Path, R>;
+/**
+ * Nice builder style for route definitions:
+ *   const getUser = routeFor('/{id}')({ ... })
+ *
+ * @template Path - The route path as a string literal
+ * @param path - The route path
+ * @returns A function that takes route options and returns a RouteDef
+ *
+ * @example
+ * ```typescript
+ * const getUserRoute = routeFor('/users/:id')({
+ *   responses: {
+ *     200: { content: { 'application/json': { schema: userSchema } } },
+ *     404: { description: 'User not found' }
+ *   }
+ * });
+ * ```
+ *
+ * @see defineRoute for the underlying implementation
+ */
+export declare function routeFor<Path extends string>(path: Path): <const R extends ResponsesSpec>(options: RouteOptions<Path> & {
+    responses: R;
+}) => RouteDef<Path, R>;
+//# sourceMappingURL=defineRoute.d.ts.map

package/dist/core/route/defineRoute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineRoute.d.ts","sourceRoot":"","sources":["../../../src/core/route/defineRoute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C;;;;;;;;GAQG;AACH,MAAM,MAAM,QAAQ,CAAC,IAAI,SAAS,MAAM,EAAE,CAAC,SAAS,aAAa,IAAI;IACnE,qBAAqB;IACrB,IAAI,EAAE,IAAI,CAAC;IACX,wCAAwC;IACxC,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,GAAG;QAAE,SAAS,EAAE,CAAC,CAAA;KAAE,CAAC;IAC/C,0DAA0D;IAC1D,KAAK,EAAE,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;CACxC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,WAAW,CAAC,IAAI,SAAS,MAAM,EAAE,KAAK,CAAC,CAAC,SAAS,aAAa,EAC5E,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,GAAG;IAAE,SAAS,EAAE,CAAC,CAAA;CAAE,GAC7C,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAMnB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,QAAQ,CAAC,IAAI,SAAS,MAAM,EAAE,IAAI,EAAE,IAAI,IACrC,KAAK,CAAC,CAAC,SAAS,aAAa,EAC5C,SAAS,YAAY,CAAC,IAAI,CAAC,GAAG;IAAE,SAAS,EAAE,CAAC,CAAA;CAAE,KAC7C,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAGrB"}

package/dist/core/route/defineRoute.js

@@ -0,0 +1,59 @@
+import { makeReply } from '../reply/typed.js';
+/**
+ * Creates a route definition with typed responses and reply functions.
+ *
+ * @template Path - The route path as a string literal
+ * @template R - The responses specification for this route
+ * @param path - The route path (e.g., '/users', '/users/:id')
+ * @param options - Route configuration including responses specification
+ * @returns Route definition with typed reply function
+ *
+ * @example
+ * ```typescript
+ * const userRoute = defineRoute('/users', {
+ *   responses: {
+ *     200: { content: { 'application/json': { schema: userSchema } } },
+ *     404: { description: 'User not found' }
+ *   }
+ * });
+ *
+ * // Use the typed reply function
+ * const reply = userRoute.reply(200, userData);
+ * ```
+ *
+ * @see RouteOptions for available configuration options
+ * @see ResponsesSpec for response specification format
+ */
+export function defineRoute(path, options) {
+    return {
+        path,
+        options,
+        reply: makeReply(options.responses),
+    };
+}
+/**
+ * Nice builder style for route definitions:
+ *   const getUser = routeFor('/{id}')({ ... })
+ *
+ * @template Path - The route path as a string literal
+ * @param path - The route path
+ * @returns A function that takes route options and returns a RouteDef
+ *
+ * @example
+ * ```typescript
+ * const getUserRoute = routeFor('/users/:id')({
+ *   responses: {
+ *     200: { content: { 'application/json': { schema: userSchema } } },
+ *     404: { description: 'User not found' }
+ *   }
+ * });
+ * ```
+ *
+ * @see defineRoute for the underlying implementation
+ */
+export function routeFor(path) {
+    return function (options) {
+        return defineRoute(path, options);
+    };
+}
+//# sourceMappingURL=defineRoute.js.map

package/dist/core/route/defineRoute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineRoute.js","sourceRoot":"","sources":["../../../src/core/route/defineRoute.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAoB9C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,WAAW,CACzB,IAAU,EACV,OAA8C;IAE9C,OAAO;QACL,IAAI;QACJ,OAAO;QACP,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC;KACpC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,QAAQ,CAAsB,IAAU;IACtD,OAAO,UACL,OAA8C;QAE9C,OAAO,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC,CAAC;AACJ,CAAC"}

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

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

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

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

package/dist/core/route/index.js

@@ -0,0 +1,2 @@
+export * from './defineRoute.js';
+//# sourceMappingURL=index.js.map

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

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

package/dist/core/serialization/json.d.ts

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

package/dist/core/serialization/json.d.ts.map

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

package/dist/core/serialization/json.js

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

package/dist/core/serialization/json.js.map

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

package/dist/core/typing/path-params.d.ts

@@ -0,0 +1,2 @@
+export type ExtractPathParams<S extends string> = S extends `${string}{${infer P}}${infer Rest}` ? P | ExtractPathParams<Rest> : never;
+//# sourceMappingURL=path-params.d.ts.map

package/dist/core/typing/path-params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-params.d.ts","sourceRoot":"","sources":["../../../src/core/typing/path-params.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,MAAM,IAC5C,CAAC,SAAS,GAAG,MAAM,IAAI,MAAM,CAAC,IAAI,MAAM,IAAI,EAAE,GAC1C,CAAC,GAAG,iBAAiB,CAAC,IAAI,CAAC,GAC3B,KAAK,CAAC"}

package/dist/core/typing/path-params.js

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

package/dist/core/typing/path-params.js.map

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

package/dist/decorators/binding.d.ts

@@ -0,0 +1,9 @@
+export type BindingsOptions = {
+    /**
+     * Hint coercion for path params by name.
+     * Example: @Bindings({ path: { id: 'int' } })
+     */
+    path?: Record<string, 'string' | 'int' | 'number' | 'boolean' | 'uuid'>;
+};
+export declare function Bindings(opts: BindingsOptions): (_value: unknown, context: ClassMethodDecoratorContext) => void;
+//# sourceMappingURL=binding.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"binding.d.ts","sourceRoot":"","sources":["../../src/decorators/binding.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,eAAe,GAAG;IAC5B;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC,CAAC;CACzE,CAAC;AAEF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,eAAe,IAC3B,QAAQ,OAAO,EAAE,SAAS,2BAA2B,UAevE"}

package/dist/decorators/binding.js

@@ -0,0 +1,18 @@
+import { META } from '../metadata/keys.js';
+import { bagFromContext, bagEnsureObject } from '../metadata/bag.js';
+export function Bindings(opts) {
+    return function (_value, context) {
+        const bag = bagFromContext(context);
+        const meta = bagEnsureObject(bag, META.bindings, () => ({}));
+        const method = String(context.name);
+        meta.byMethod ??= {};
+        meta.byMethod[method] ??= {};
+        if (opts.path) {
+            meta.byMethod[method].path = {
+                ...(meta.byMethod[method].path ?? {}),
+                ...opts.path,
+            };
+        }
+    };
+}
+//# sourceMappingURL=binding.js.map

package/dist/decorators/binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding.js","sourceRoot":"","sources":["../../src/decorators/binding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAqB,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAUrE,MAAM,UAAU,QAAQ,CAAC,IAAqB;IAC5C,OAAO,UAAU,MAAe,EAAE,OAAoC;QACpE,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,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,QAAQ,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAE7B,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,GAAG;gBAC3B,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;gBACrC,GAAG,IAAI,CAAC,IAAI;aACb,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/decorators/controller.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Stage-3 class decorator.
+ * Usage: @Controller('/users')
+ */
+export declare function Controller(basePath: string): (_value: unknown, context: ClassDecoratorContext) => void;
+//# sourceMappingURL=controller.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../src/decorators/controller.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,IACxB,QAAQ,OAAO,EAAE,SAAS,qBAAqB,UASjE"}

package/dist/decorators/controller.js

@@ -0,0 +1,26 @@
+import { META } from '../metadata/keys.js';
+import { bagFromContext, bagSet } from '../metadata/bag.js';
+/**
+ * Stage-3 class decorator.
+ * Usage: @Controller('/users')
+ */
+export function Controller(basePath) {
+    return function (_value, context) {
+        const bag = bagFromContext(context);
+        const meta = {
+            basePath: normalizeBasePath(basePath),
+        };
+        bagSet(bag, META.controller, meta);
+    };
+}
+function normalizeBasePath(p) {
+    if (!p)
+        return '';
+    let out = p.trim();
+    if (!out.startsWith('/'))
+        out = `/${out}`;
+    if (out !== '/' && out.endsWith('/'))
+        out = out.slice(0, -1);
+    return out;
+}
+//# sourceMappingURL=controller.js.map

package/dist/decorators/controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.js","sourceRoot":"","sources":["../../src/decorators/controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAuB,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5D;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,OAAO,UAAU,MAAe,EAAE,OAA8B;QAC9D,MAAM,GAAG,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;QAEpC,MAAM,IAAI,GAAmB;YAC3B,QAAQ,EAAE,iBAAiB,CAAC,QAAQ,CAAC;SACtC,CAAC;QAEF,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,CAAS;IAClC,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"}

package/dist/decorators/db.d.ts

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

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

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

package/dist/decorators/db.js

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

package/dist/decorators/db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../../src/decorators/db.ts"],"names":[],"mappings":";AAAA,uCAAuC"}

package/dist/decorators/docs.d.ts

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

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

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

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

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

@@ -0,0 +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;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}

package/dist/decorators/index.js

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

@@ -0,0 +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;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}

package/dist/decorators/methods.d.ts

@@ -0,0 +1,146 @@
+import type { RouteOptions } from '../contracts/route-options.js';
+import type { ResponsesSpec } from '../contracts/responses.js';
+import type { Reply } from '../contracts/reply.js';
+import type { Schema } from '../validation/native/schema.js';
+import type { BodySchemaFor, SuccessStatusesWithBody, SuccessStatusesNoBody } from '../contracts/response-types.js';
+type MaybePromise<T> = T | Promise<T>;
+type ResponsesFromOptions<O> = O extends {
+    responses: infer R extends ResponsesSpec;
+} ? R : undefined;
+type BodySchemaFromResponses<R extends ResponsesSpec> = SuccessStatusesWithBody<R> extends never ? never : BodySchemaFor<R, SuccessStatusesWithBody<R>>;
+type BodyTypeFromResponses<R extends ResponsesSpec | undefined> = R extends ResponsesSpec ? BodySchemaFromResponses<R> extends Schema<infer T> ? T : unknown : unknown;
+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<unknown, number>;
+type HandlerReturn<O extends RouteOptions<string> | undefined> = MaybePromise<SuccessBodyType<O> | HandlerReply<ResponsesFromOptions<O>>>;
+/**
+ * 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

@@ -0,0 +1 @@
+{"version":3,"file":"methods.d.ts","sourceRoot":"","sources":["../../src/decorators/methods.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,KAAK,EACV,aAAa,EACb,uBAAuB,EACvB,qBAAqB,EACtB,MAAM,gCAAgC,CAAC;AAIxC,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAEtC,KAAK,oBAAoB,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,SAAS,EAAE,MAAM,CAAC,SAAS,aAAa,CAAA;CAAE,GAAG,CAAC,GAAG,SAAS,CAAC;AAEtG,KAAK,uBAAuB,CAAC,CAAC,SAAS,aAAa,IAClD,uBAAuB,CAAC,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,GAAG,aAAa,CAAC,CAAC,EAAE,uBAAuB,CAAC,CAAC,CAAC,CAAC,CAAC;AAElG,KAAK,qBAAqB,CAAC,CAAC,SAAS,aAAa,GAAG,SAAS,IAC5D,CAAC,SAAS,aAAa,GACnB,uBAAuB,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,GAChE,OAAO,CAAC;AAEd,KAAK,eAAe,CAAC,CAAC,IAAI,qBAAqB,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC;AAEzE,KAAK,kBAAkB,CAAC,CAAC,SAAS,aAAa,GAAG,SAAS,IACzD,CAAC,SAAS,aAAa,GACnB,uBAAuB,CAAC,CAAC,CAAC,SAAS,KAAK,GACtC,KAAK,GACL,KAAK,CACH,uBAAuB,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,EAChE,uBAAuB,CAAC,CAAC,CAAC,CAC3B,GACH,KAAK,CAAC;AAEZ,KAAK,gBAAgB,CAAC,CAAC,SAAS,aAAa,GAAG,SAAS,IACvD,CAAC,SAAS,aAAa,GACnB,qBAAqB,CAAC,CAAC,CAAC,SAAS,KAAK,GACpC,KAAK,GACL,KAAK,CAAC,SAAS,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC,GAC5C,KAAK,CAAC;AAEZ,KAAK,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,GAAG,KAAK,CAAC;AAErD,KAAK,YAAY,CAAC,CAAC,SAAS,aAAa,GAAG,SAAS,IACnD,CAAC,SAAS,aAAa,GACnB,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,KAAK,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC,GAC3E,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,KAAK,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC,GAC3E,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAE7B,KAAK,aAAa,CAAC,CAAC,SAAS,YAAY,CAAC,MAAM,CAAC,GAAG,SAAS,IAC3D,YAAY,CAAC,eAAe,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AA4C3E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,GAAG,CAAC,IAAI,SAAS,MAAM,EAAE,KAAK,CAAC,CAAC,SAAS,YAAY,CAAC,IAAI,CAAC,GAAG,SAAS,EACrF,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,CAAC,IArCM,IAAI,EAAE,IAAI,SAAS,OAAO,EAAE,EAAE,GAAG,4LAwCnD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,IAAI,CAAC,IAAI,SAAS,MAAM,EAAE,KAAK,CAAC,CAAC,SAAS,YAAY,CAAC,IAAI,CAAC,GAAG,SAAS,EACtF,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,CAAC,IAtEM,IAAI,EAAE,IAAI,SAAS,OAAO,EAAE,EAAE,GAAG,4LAyEnD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,GAAG,CAAC,IAAI,SAAS,MAAM,EAAE,KAAK,CAAC,CAAC,SAAS,YAAY,CAAC,IAAI,CAAC,GAAG,SAAS,EACrF,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,CAAC,IAlGM,IAAI,EAAE,IAAI,SAAS,OAAO,EAAE,EAAE,GAAG,4LAqGnD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,KAAK,CAAC,IAAI,SAAS,MAAM,EAAE,KAAK,CAAC,CAAC,SAAS,YAAY,CAAC,IAAI,CAAC,GAAG,SAAS,EACvF,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,CAAC,IA9HM,IAAI,EAAE,IAAI,SAAS,OAAO,EAAE,EAAE,GAAG,4LAiInD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,MAAM,CAAC,IAAI,SAAS,MAAM,EAAE,KAAK,CAAC,CAAC,SAAS,YAAY,CAAC,IAAI,CAAC,GAAG,SAAS,EACxF,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,CAAC,IAjKM,IAAI,EAAE,IAAI,SAAS,OAAO,EAAE,EAAE,GAAG,4LAoKnD"}