@asenajs/asena 0.6.3 → 0.7.1

package/dist/lib/server/src/services/PrepareFrontendControllerService.d.ts

@@ -0,0 +1,18 @@
+import type { ICoreService } from '../../../ioc';
+export interface PreparedHTMLRoute {
+    path: string;
+    htmlBundle: unknown;
+    controllerName: string;
+    controllerBasePath: string;
+}
+/**
+ * @description Core service for preparing FrontendController components.
+ * Resolves FrontendControllers from the container, reads @Page metadata,
+ * and collects HTML routes. Adapter registration is handled by AsenaServer.
+ */
+export declare class PrepareFrontendControllerService implements ICoreService {
+    serviceName: string;
+    private container;
+    prepare(): Promise<PreparedHTMLRoute[]>;
+    private extractHTMLRoutes;
+}

package/dist/lib/server/src/services/PrepareFrontendControllerService.js

@@ -0,0 +1,63 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { ComponentConstants, ComponentType, CoreService, ICoreServiceNames } from '../../../ioc';
+import { Inject } from '../../../ioc/component';
+import { getOwnTypedMetadata, getTypedMetadata } from '../../../utils';
+import * as path from 'node:path';
+/**
+ * @description Core service for preparing FrontendController components.
+ * Resolves FrontendControllers from the container, reads @Page metadata,
+ * and collects HTML routes. Adapter registration is handled by AsenaServer.
+ */
+let PrepareFrontendControllerService = class PrepareFrontendControllerService {
+    serviceName = 'PrepareFrontendControllerService';
+    container;
+    async prepare() {
+        const frontendControllers = await this.container.resolveAll(ComponentType.FRONTEND_CONTROLLER);
+        if (!frontendControllers || frontendControllers.length === 0) {
+            return [];
+        }
+        const htmlRoutes = [];
+        for (const controller of frontendControllers.flat()) {
+            const routes = await this.extractHTMLRoutes(controller);
+            htmlRoutes.push(...routes);
+        }
+        return htmlRoutes;
+    }
+    async extractHTMLRoutes(controller) {
+        const pageRoutes = getOwnTypedMetadata(ComponentConstants.PageRoutesKey, controller.constructor) || {};
+        const controllerName = getTypedMetadata(ComponentConstants.NameKey, controller.constructor) || controller.constructor.name;
+        if (Object.keys(pageRoutes).length === 0) {
+            return [];
+        }
+        const basePath = getOwnTypedMetadata(ComponentConstants.PathKey, controller.constructor) || '/';
+        const routes = [];
+        for (const [methodName, pageRoute] of Object.entries(pageRoutes)) {
+            const fullPath = path.join(basePath, pageRoute.path).replace(/\\/g, '/');
+            const result = await controller[methodName]();
+            // Dynamic import() returns { default: HTMLBundle }, direct return gives HTMLBundle
+            const htmlBundle = result?.default ?? result;
+            if (!htmlBundle) {
+                throw new Error(`@Page method ${controllerName}.${methodName}() returned null/undefined. Must return a Bun HTMLBundle.`);
+            }
+            routes.push({ path: fullPath, htmlBundle, controllerName, controllerBasePath: basePath });
+        }
+        return routes;
+    }
+};
+__decorate([
+    Inject(ICoreServiceNames.CONTAINER),
+    __metadata("design:type", Function)
+], PrepareFrontendControllerService.prototype, "container", void 0);
+PrepareFrontendControllerService = __decorate([
+    CoreService(ICoreServiceNames.PREPARE_FRONTEND_CONTROLLER_SERVICE)
+], PrepareFrontendControllerService);
+export { PrepareFrontendControllerService };
+//# sourceMappingURL=PrepareFrontendControllerService.js.map

package/dist/lib/server/src/services/PrepareFrontendControllerService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrepareFrontendControllerService.js","sourceRoot":"","sources":["../../../../../lib/server/src/services/PrepareFrontendControllerService.ts"],"names":[],"mappings":";;;;;;;;;AACA,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjG,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGvE,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AASlC;;;;GAIG;AAEI,IAAM,gCAAgC,GAAtC,MAAM,gCAAgC;IACpC,WAAW,GAAG,kCAAkC,CAAC;IAGhD,SAAS,CAAa;IAEvB,KAAK,CAAC,OAAO;QAClB,MAAM,mBAAmB,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,CAAQ,aAAa,CAAC,mBAAmB,CAAC,CAAC;QAEtG,IAAI,CAAC,mBAAmB,IAAI,mBAAmB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7D,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,UAAU,GAAwB,EAAE,CAAC;QAE3C,KAAK,MAAM,UAAU,IAAI,mBAAmB,CAAC,IAAI,EAAE,EAAE,CAAC;YACpD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;YAExD,UAAU,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;QAC7B,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAAC,UAAiB;QAC/C,MAAM,UAAU,GAAG,mBAAmB,CAAY,kBAAkB,CAAC,aAAa,EAAE,UAAU,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QAElH,MAAM,cAAc,GAClB,gBAAgB,CAAS,kBAAkB,CAAC,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC,IAAI,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC;QAE9G,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzC,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,QAAQ,GAAW,mBAAmB,CAAS,kBAAkB,CAAC,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC;QAEhH,MAAM,MAAM,GAAwB,EAAE,CAAC;QAEvC,KAAK,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YACzE,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAE9C,mFAAmF;YACnF,MAAM,UAAU,GAAG,MAAM,EAAE,OAAO,IAAI,MAAM,CAAC;YAE7C,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,MAAM,IAAI,KAAK,CACb,gBAAgB,cAAc,IAAI,UAAU,2DAA2D,CACxG,CAAC;YACJ,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,cAAc,EAAE,kBAAkB,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC5F,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAA;AApDS;IADP,MAAM,CAAC,iBAAiB,CAAC,SAAS,CAAC;;mEACN;AAJnB,gCAAgC;IAD5C,WAAW,CAAC,iBAAiB,CAAC,mCAAmC,CAAC;GACtD,gCAAgC,CAwD5C"}

package/dist/lib/server/src/services/PrepareScheduleService.d.ts

@@ -0,0 +1,21 @@
+import type { ICoreService } from '../../../ioc';
+/**
+ * @description PrepareScheduleService - Discovers and registers scheduled components
+ *
+ * Scan Process:
+ * 1. Resolve all ComponentType.SCHEDULE from container
+ * 2. Extract cron metadata from class
+ * 3. Validate execute() method exists (AsenaSchedule contract)
+ * 4. Register job with CronRunner
+ */
+export declare class PrepareScheduleService implements ICoreService {
+    readonly serviceName = "PrepareScheduleService";
+    private container;
+    private logger;
+    private cronRunner;
+    /**
+     * Discover and register all scheduled components with CronRunner
+     */
+    prepare(): Promise<void>;
+    private registerSchedule;
+}

package/dist/lib/server/src/services/PrepareScheduleService.js

@@ -0,0 +1,69 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { ComponentConstants, ComponentType, CoreService, ICoreServiceNames } from '../../../ioc';
+import { Inject } from '../../../ioc/component';
+import { getTypedMetadata } from '../../../utils';
+/**
+ * @description PrepareScheduleService - Discovers and registers scheduled components
+ *
+ * Scan Process:
+ * 1. Resolve all ComponentType.SCHEDULE from container
+ * 2. Extract cron metadata from class
+ * 3. Validate execute() method exists (AsenaSchedule contract)
+ * 4. Register job with CronRunner
+ */
+let PrepareScheduleService = class PrepareScheduleService {
+    serviceName = 'PrepareScheduleService';
+    container;
+    logger;
+    cronRunner;
+    /**
+     * Discover and register all scheduled components with CronRunner
+     */
+    async prepare() {
+        const schedules = await this.container.resolveAll(ComponentType.SCHEDULE);
+        if (!schedules || schedules.length === 0) {
+            return;
+        }
+        for (const schedule of schedules) {
+            this.registerSchedule(schedule);
+        }
+    }
+    registerSchedule(instance) {
+        const cronExpression = getTypedMetadata(ComponentConstants.CronKey, instance.constructor);
+        const name = getTypedMetadata(ComponentConstants.NameKey, instance.constructor) || instance.constructor.name;
+        if (!cronExpression) {
+            this.logger.warn(`[Schedule] No cron expression for "${name}", skipping`);
+            return;
+        }
+        // Validate AsenaSchedule contract
+        if (typeof instance.execute !== 'function') {
+            throw new Error(`@Schedule class "${name}" must implement AsenaSchedule interface (missing execute() method)`);
+        }
+        this.cronRunner.registerJob(name, cronExpression, instance.execute.bind(instance));
+    }
+};
+__decorate([
+    Inject(ICoreServiceNames.CONTAINER),
+    __metadata("design:type", Function)
+], PrepareScheduleService.prototype, "container", void 0);
+__decorate([
+    Inject(ICoreServiceNames.SERVER_LOGGER),
+    __metadata("design:type", Object)
+], PrepareScheduleService.prototype, "logger", void 0);
+__decorate([
+    Inject(ICoreServiceNames.CRON_RUNNER),
+    __metadata("design:type", Function)
+], PrepareScheduleService.prototype, "cronRunner", void 0);
+PrepareScheduleService = __decorate([
+    CoreService(ICoreServiceNames.PREPARE_SCHEDULE_SERVICE)
+], PrepareScheduleService);
+export { PrepareScheduleService };
+//# sourceMappingURL=PrepareScheduleService.js.map

package/dist/lib/server/src/services/PrepareScheduleService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrepareScheduleService.js","sourceRoot":"","sources":["../../../../../lib/server/src/services/PrepareScheduleService.ts"],"names":[],"mappings":";;;;;;;;;AACA,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjG,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAIlD;;;;;;;;GAQG;AAEI,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;IACjB,WAAW,GAAG,wBAAwB,CAAC;IAG/C,SAAS,CAAa;IAGtB,MAAM,CAAgB;IAGtB,UAAU,CAAc;IAEhC;;OAEG;IACI,KAAK,CAAC,OAAO;QAClB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,CAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;QAE/E,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzC,OAAO;QACT,CAAC;QAED,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAEO,gBAAgB,CAAC,QAAa;QACpC,MAAM,cAAc,GAAG,gBAAgB,CAAS,kBAAkB,CAAC,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;QAElG,MAAM,IAAI,GACR,gBAAgB,CAAS,kBAAkB,CAAC,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,IAAI,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC;QAE1G,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,sCAAsC,IAAI,aAAa,CAAC,CAAC;YAE1E,OAAO;QACT,CAAC;QAED,kCAAkC;QAClC,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,qEAAqE,CAAC,CAAC;QACjH,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACrF,CAAC;CACF,CAAA;AA1CS;IADP,MAAM,CAAC,iBAAiB,CAAC,SAAS,CAAC;;yDACN;AAGtB;IADP,MAAM,CAAC,iBAAiB,CAAC,aAAa,CAAC;;sDACV;AAGtB;IADP,MAAM,CAAC,iBAAiB,CAAC,WAAW,CAAC;;0DACN;AAVrB,sBAAsB;IADlC,WAAW,CAAC,iBAAiB,CAAC,wBAAwB,CAAC;GAC3C,sBAAsB,CA8ClC"}

package/dist/lib/server/web/decorators/Page.d.ts

@@ -0,0 +1,13 @@
+export interface PageRoute {
+    [key: string]: {
+        path: string;
+    };
+}
+/**
+ * Method decorator for defining a page route in a FrontendController.
+ * The decorated method should return a Bun HTMLBundle (imported from .html file).
+ *
+ * @param {string} path - The sub-path for this page (relative to FrontendController base path)
+ * @returns {MethodDecorator}
+ */
+export declare function Page(path: string): (target: object, propertyKey: string, _descriptor: PropertyDescriptor) => void;

package/dist/lib/server/web/decorators/Page.js

@@ -0,0 +1,17 @@
+import { ComponentConstants } from '../../../ioc';
+import { defineTypedMetadata, getOwnTypedMetadata } from '../../../utils/typedMetadata';
+/**
+ * Method decorator for defining a page route in a FrontendController.
+ * The decorated method should return a Bun HTMLBundle (imported from .html file).
+ *
+ * @param {string} path - The sub-path for this page (relative to FrontendController base path)
+ * @returns {MethodDecorator}
+ */
+export function Page(path) {
+    return function (target, propertyKey, _descriptor) {
+        const routes = getOwnTypedMetadata(ComponentConstants.PageRoutesKey, target.constructor) || {};
+        routes[propertyKey] = { path: path.replace(/^\/+/, '') };
+        defineTypedMetadata(ComponentConstants.PageRoutesKey, routes, target.constructor);
+    };
+}
+//# sourceMappingURL=Page.js.map

package/dist/lib/server/web/decorators/Page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Page.js","sourceRoot":"","sources":["../../../../../lib/server/web/decorators/Page.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAMxF;;;;;;GAMG;AACH,MAAM,UAAU,IAAI,CAAC,IAAY;IAC/B,OAAO,UAAU,MAAc,EAAE,WAAmB,EAAE,WAA+B;QACnF,MAAM,MAAM,GAAG,mBAAmB,CAAY,kBAAkB,CAAC,aAAa,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QAE1G,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;QAEzD,mBAAmB,CAAY,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IAC/F,CAAC,CAAC;AACJ,CAAC"}

package/dist/lib/server/web/decorators/http.base.d.ts

@@ -1,4 +1,4 @@
 import type { ApiParams, ControllerDecoratorParams, ControllerHandler } from '../../../adapter';
-export declare function genericHandler({ method, path, description, middlewares, staticServe, validator }: ApiParams): (route: object, propertyKey: string, _descriptor: TypedPropertyDescriptor<ControllerHandler>) => void;
+export declare function genericHandler({ method, path, summary, description, middlewares, staticServe, validator }: ApiParams): (route: object, propertyKey: string, _descriptor: TypedPropertyDescriptor<ControllerHandler>) => void;
 export declare const DEFAULT_PARAMS: ControllerDecoratorParams;
 export declare const generateHandlerParams: (params: ControllerDecoratorParams | string) => ControllerDecoratorParams;

package/dist/lib/server/web/decorators/http.base.js

@@ -1,11 +1,11 @@
 import { ComponentConstants } from '../../../ioc';
 import { defineMiddleware } from '../helper';
 import { defineTypedMetadata, getOwnTypedMetadata } from '../../../utils/typedMetadata';
-export function genericHandler({ method, path, description, middlewares, staticServe, validator }) {
+export function genericHandler({ method, path, summary, description, middlewares, staticServe, validator }) {
     return function (route, propertyKey, _descriptor) {
         const routes = getOwnTypedMetadata(ComponentConstants.RouteKey, route.constructor) || {};
         if (!routes[propertyKey]) {
-            routes[propertyKey] = { path, method, description, middlewares, staticServe, validator };
+            routes[propertyKey] = { path, method, summary, description, middlewares, staticServe, validator };
         }
         defineTypedMetadata(ComponentConstants.RouteKey, routes, route.constructor);
         defineMiddleware(route.constructor, middlewares);
@@ -14,6 +14,7 @@ export function genericHandler({ method, path, description, middlewares, staticS
 export const DEFAULT_PARAMS = {
     path: '',
     middlewares: [],
+    summary: '',
     description: '',
     staticServe: undefined,
     validator: undefined,

package/dist/lib/server/web/decorators/http.base.js.map

@@ -1 +1 @@
-{"version":3,"file":"http.base.js","sourceRoot":"","sources":["../../../../../lib/server/web/decorators/http.base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAGxF,MAAM,UAAU,cAAc,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAa;IAC1G,OAAO,UAAU,KAAa,EAAE,WAAmB,EAAE,WAAuD;QAC1G,MAAM,MAAM,GAAG,mBAAmB,CAAQ,kBAAkB,CAAC,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QAEhG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;YACzB,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;QAC3F,CAAC;QAED,mBAAmB,CAAQ,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;QAEnF,gBAAgB,CAAC,KAAK,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IACnD,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAA8B;IACvD,IAAI,EAAE,EAAE;IACR,WAAW,EAAE,EAAE;IACf,WAAW,EAAE,EAAE;IACf,WAAW,EAAE,SAAS;IACtB,SAAS,EAAE,SAAS;CACrB,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAA0C,EAA6B,EAAE;IAC7G,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO;YACL,GAAG,cAAc;YACjB,IAAI,EAAE,mBAAmB,CAAC,MAAM,CAAC;SAClC,CAAC;IACJ,CAAC;IAED,OAAO;QACL,GAAG,cAAc;QACjB,GAAG,MAAM;QACT,IAAI,EAAE,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC;KACvC,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,mBAAmB,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC"}
+{"version":3,"file":"http.base.js","sourceRoot":"","sources":["../../../../../lib/server/web/decorators/http.base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAGxF,MAAM,UAAU,cAAc,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAa;IACnH,OAAO,UAAU,KAAa,EAAE,WAAmB,EAAE,WAAuD;QAC1G,MAAM,MAAM,GAAG,mBAAmB,CAAQ,kBAAkB,CAAC,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QAEhG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;YACzB,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;QACpG,CAAC;QAED,mBAAmB,CAAQ,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;QAEnF,gBAAgB,CAAC,KAAK,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IACnD,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAA8B;IACvD,IAAI,EAAE,EAAE;IACR,WAAW,EAAE,EAAE;IACf,OAAO,EAAE,EAAE;IACX,WAAW,EAAE,EAAE;IACf,WAAW,EAAE,SAAS;IACtB,SAAS,EAAE,SAAS;CACrB,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAA0C,EAA6B,EAAE;IAC7G,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO;YACL,GAAG,cAAc;YACjB,IAAI,EAAE,mBAAmB,CAAC,MAAM,CAAC;SAClC,CAAC;IACJ,CAAC;IAED,OAAO;QACL,GAAG,cAAc;QACjB,GAAG,MAAM;QACT,IAAI,EAAE,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC;KACvC,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,mBAAmB,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC"}

package/dist/lib/server/web/decorators/index.d.ts

@@ -2,3 +2,4 @@ export { genericHandler } from './http.base';
 export { DEFAULT_PARAMS } from './http.base';
 export { generateHandlerParams } from './http.base';
 export * from './methods';
+export * from './Page';

package/dist/lib/server/web/decorators/index.js

@@ -2,4 +2,5 @@ export { genericHandler } from './http.base';
 export { DEFAULT_PARAMS } from './http.base';
 export { generateHandlerParams } from './http.base';
 export * from './methods';
+export * from './Page';
 //# sourceMappingURL=index.js.map

package/dist/lib/server/web/decorators/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../lib/server/web/decorators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../lib/server/web/decorators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC"}

package/dist/lib/server/web/decorators/methods/All.d.ts

@@ -0,0 +1,7 @@
+import type { ControllerDecoratorParams } from '../../../../adapter';
+/**
+ * Decorator for handling all HTTP methods on a route.
+ * @param {ControllerDecoratorParams | string} params - The parameters for the route.
+ * @returns {Function} The generic handler for all HTTP methods.
+ */
+export declare function All(params: ControllerDecoratorParams | string): Function;

package/dist/lib/server/web/decorators/methods/All.js

@@ -0,0 +1,12 @@
+import { generateHandlerParams, genericHandler } from '../http.base';
+import { HttpMethod } from '../../types';
+/**
+ * Decorator for handling all HTTP methods on a route.
+ * @param {ControllerDecoratorParams | string} params - The parameters for the route.
+ * @returns {Function} The generic handler for all HTTP methods.
+ */
+export function All(params) {
+    const { path, middlewares, summary, description, staticServe, validator } = generateHandlerParams(params);
+    return genericHandler({ method: HttpMethod.ALL, path, summary, middlewares, description, staticServe, validator });
+}
+//# sourceMappingURL=All.js.map

package/dist/lib/server/web/decorators/methods/All.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"All.js","sourceRoot":"","sources":["../../../../../../lib/server/web/decorators/methods/All.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;GAIG;AACH,MAAM,UAAU,GAAG,CAAC,MAA0C;IAC5D,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAE1G,OAAO,cAAc,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC;AACrH,CAAC"}

package/dist/lib/server/web/decorators/methods/Connect.js

@@ -6,7 +6,15 @@ import { HttpMethod } from '../../types';
  * @returns {Function} The generic handler for the CONNECT request.
  */
 export function Connect(params) {
-    const { path, middlewares, description, staticServe, validator } = generateHandlerParams(params);
-    return genericHandler({ method: HttpMethod.CONNECT, path, middlewares, description, staticServe, validator });
+    const { path, middlewares, summary, description, staticServe, validator } = generateHandlerParams(params);
+    return genericHandler({
+        method: HttpMethod.CONNECT,
+        path,
+        summary,
+        middlewares,
+        description,
+        staticServe,
+        validator,
+    });
 }
 //# sourceMappingURL=Connect.js.map

package/dist/lib/server/web/decorators/methods/Connect.js.map

@@ -1 +1 @@
-{"version":3,"file":"Connect.js","sourceRoot":"","sources":["../../../../../../lib/server/web/decorators/methods/Connect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,MAA0C;IAChE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAEjG,OAAO,cAAc,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC;AAChH,CAAC"}
+{"version":3,"file":"Connect.js","sourceRoot":"","sources":["../../../../../../lib/server/web/decorators/methods/Connect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,MAA0C;IAChE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAE1G,OAAO,cAAc,CAAC;QACpB,MAAM,EAAE,UAAU,CAAC,OAAO;QAC1B,IAAI;QACJ,OAAO;QACP,WAAW;QACX,WAAW;QACX,WAAW;QACX,SAAS;KACV,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/server/web/decorators/methods/Delete.js

@@ -6,7 +6,7 @@ import { HttpMethod } from '../../types';
  * @returns {Function} The generic handler for the DELETE request.
  */
 export function Delete(params) {
-    const { path, middlewares, description, staticServe, validator } = generateHandlerParams(params);
-    return genericHandler({ method: HttpMethod.DELETE, path, middlewares, description, staticServe, validator });
+    const { path, middlewares, summary, description, staticServe, validator } = generateHandlerParams(params);
+    return genericHandler({ method: HttpMethod.DELETE, path, summary, middlewares, description, staticServe, validator });
 }
 //# sourceMappingURL=Delete.js.map

package/dist/lib/server/web/decorators/methods/Delete.js.map

@@ -1 +1 @@
-{"version":3,"file":"Delete.js","sourceRoot":"","sources":["../../../../../../lib/server/web/decorators/methods/Delete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,MAA0C;IAC/D,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAEjG,OAAO,cAAc,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC;AAC/G,CAAC"}
+{"version":3,"file":"Delete.js","sourceRoot":"","sources":["../../../../../../lib/server/web/decorators/methods/Delete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,MAA0C;IAC/D,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAE1G,OAAO,cAAc,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC;AACxH,CAAC"}

package/dist/lib/server/web/decorators/methods/Get.js

@@ -6,7 +6,7 @@ import { HttpMethod } from '../../types';
  * @returns {Function} The generic handler for the GET request.
  */
 export function Get(params) {
-    const { path, middlewares, description, staticServe, validator } = generateHandlerParams(params);
-    return genericHandler({ method: HttpMethod.GET, path, middlewares, description, staticServe, validator });
+    const { path, middlewares, summary, description, staticServe, validator } = generateHandlerParams(params);
+    return genericHandler({ method: HttpMethod.GET, path, summary, middlewares, description, staticServe, validator });
 }
 //# sourceMappingURL=Get.js.map

package/dist/lib/server/web/decorators/methods/Get.js.map

@@ -1 +1 @@
-{"version":3,"file":"Get.js","sourceRoot":"","sources":["../../../../../../lib/server/web/decorators/methods/Get.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;GAIG;AACH,MAAM,UAAU,GAAG,CAAC,MAA0C;IAC5D,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAEjG,OAAO,cAAc,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC;AAC5G,CAAC"}
+{"version":3,"file":"Get.js","sourceRoot":"","sources":["../../../../../../lib/server/web/decorators/methods/Get.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;GAIG;AACH,MAAM,UAAU,GAAG,CAAC,MAA0C;IAC5D,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAE1G,OAAO,cAAc,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC;AACrH,CAAC"}

package/dist/lib/server/web/decorators/methods/Head.js

@@ -6,7 +6,7 @@ import { HttpMethod } from '../../types';
  * @returns {Function} The generic handler for the HEAD request.
  */
 export function Head(params) {
-    const { path, middlewares, description, staticServe, validator } = generateHandlerParams(params);
-    return genericHandler({ method: HttpMethod.HEAD, path, middlewares, description, staticServe, validator });
+    const { path, middlewares, summary, description, staticServe, validator } = generateHandlerParams(params);
+    return genericHandler({ method: HttpMethod.HEAD, path, summary, middlewares, description, staticServe, validator });
 }
 //# sourceMappingURL=Head.js.map

package/dist/lib/server/web/decorators/methods/Head.js.map

@@ -1 +1 @@
-{"version":3,"file":"Head.js","sourceRoot":"","sources":["../../../../../../lib/server/web/decorators/methods/Head.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;GAIG;AACH,MAAM,UAAU,IAAI,CAAC,MAA0C;IAC7D,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAEjG,OAAO,cAAc,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC;AAC7G,CAAC"}
+{"version":3,"file":"Head.js","sourceRoot":"","sources":["../../../../../../lib/server/web/decorators/methods/Head.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;GAIG;AACH,MAAM,UAAU,IAAI,CAAC,MAA0C;IAC7D,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAE1G,OAAO,cAAc,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC;AACtH,CAAC"}

package/dist/lib/server/web/decorators/methods/Options.js

@@ -6,7 +6,15 @@ import { HttpMethod } from '../../types';
  * @returns {Function} The generic handler for the OPTIONS request.
  */
 export function Options(params) {
-    const { path, middlewares, description, staticServe, validator } = generateHandlerParams(params);
-    return genericHandler({ method: HttpMethod.OPTIONS, path, middlewares, description, staticServe, validator });
+    const { path, middlewares, summary, description, staticServe, validator } = generateHandlerParams(params);
+    return genericHandler({
+        method: HttpMethod.OPTIONS,
+        path,
+        summary,
+        middlewares,
+        description,
+        staticServe,
+        validator,
+    });
 }
 //# sourceMappingURL=Options.js.map

package/dist/lib/server/web/decorators/methods/Options.js.map

@@ -1 +1 @@
-{"version":3,"file":"Options.js","sourceRoot":"","sources":["../../../../../../lib/server/web/decorators/methods/Options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,MAA0C;IAChE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAEjG,OAAO,cAAc,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC;AAChH,CAAC"}
+{"version":3,"file":"Options.js","sourceRoot":"","sources":["../../../../../../lib/server/web/decorators/methods/Options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,MAA0C;IAChE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAE1G,OAAO,cAAc,CAAC;QACpB,MAAM,EAAE,UAAU,CAAC,OAAO;QAC1B,IAAI;QACJ,OAAO;QACP,WAAW;QACX,WAAW;QACX,WAAW;QACX,SAAS;KACV,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/server/web/decorators/methods/Patch.js

@@ -6,7 +6,7 @@ import { HttpMethod } from '../../types';
  * @returns {Function} The generic handler for the PATCH request.
  */
 export function Patch(params) {
-    const { path, middlewares, description, staticServe, validator } = generateHandlerParams(params);
-    return genericHandler({ method: HttpMethod.PATCH, path, middlewares, description, staticServe, validator });
+    const { path, middlewares, summary, description, staticServe, validator } = generateHandlerParams(params);
+    return genericHandler({ method: HttpMethod.PATCH, path, summary, middlewares, description, staticServe, validator });
 }
 //# sourceMappingURL=Patch.js.map

package/dist/lib/server/web/decorators/methods/Patch.js.map

@@ -1 +1 @@
-{"version":3,"file":"Patch.js","sourceRoot":"","sources":["../../../../../../lib/server/web/decorators/methods/Patch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;GAIG;AACH,MAAM,UAAU,KAAK,CAAC,MAA0C;IAC9D,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAEjG,OAAO,cAAc,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC;AAC9G,CAAC"}
+{"version":3,"file":"Patch.js","sourceRoot":"","sources":["../../../../../../lib/server/web/decorators/methods/Patch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;GAIG;AACH,MAAM,UAAU,KAAK,CAAC,MAA0C;IAC9D,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAE1G,OAAO,cAAc,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC;AACvH,CAAC"}

package/dist/lib/server/web/decorators/methods/Post.js

@@ -6,7 +6,7 @@ import { HttpMethod } from '../../types';
  * @returns {Function} The generic handler for the POST request.
  */
 export function Post(params) {
-    const { path, middlewares, description, staticServe, validator } = generateHandlerParams(params);
-    return genericHandler({ method: HttpMethod.POST, path, middlewares, description, staticServe, validator });
+    const { path, middlewares, summary, description, staticServe, validator } = generateHandlerParams(params);
+    return genericHandler({ method: HttpMethod.POST, path, summary, middlewares, description, staticServe, validator });
 }
 //# sourceMappingURL=Post.js.map

package/dist/lib/server/web/decorators/methods/Post.js.map

@@ -1 +1 @@
-{"version":3,"file":"Post.js","sourceRoot":"","sources":["../../../../../../lib/server/web/decorators/methods/Post.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;GAIG;AACH,MAAM,UAAU,IAAI,CAAC,MAA0C;IAC7D,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAEjG,OAAO,cAAc,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC;AAC7G,CAAC"}
+{"version":3,"file":"Post.js","sourceRoot":"","sources":["../../../../../../lib/server/web/decorators/methods/Post.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;GAIG;AACH,MAAM,UAAU,IAAI,CAAC,MAA0C;IAC7D,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAE1G,OAAO,cAAc,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC;AACtH,CAAC"}

package/dist/lib/server/web/decorators/methods/Put.js

@@ -6,7 +6,7 @@ import { HttpMethod } from '../../types';
  * @returns {Function} The generic handler for the PUT request.
  */
 export function Put(params) {
-    const { path, middlewares, description, staticServe, validator } = generateHandlerParams(params);
-    return genericHandler({ method: HttpMethod.PUT, path, middlewares, description, staticServe, validator });
+    const { path, middlewares, summary, description, staticServe, validator } = generateHandlerParams(params);
+    return genericHandler({ method: HttpMethod.PUT, path, summary, middlewares, description, staticServe, validator });
 }
 //# sourceMappingURL=Put.js.map

package/dist/lib/server/web/decorators/methods/Put.js.map

@@ -1 +1 @@
-{"version":3,"file":"Put.js","sourceRoot":"","sources":["../../../../../../lib/server/web/decorators/methods/Put.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;GAIG;AACH,MAAM,UAAU,GAAG,CAAC,MAA0C;IAC5D,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAEjG,OAAO,cAAc,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC;AAC5G,CAAC"}
+{"version":3,"file":"Put.js","sourceRoot":"","sources":["../../../../../../lib/server/web/decorators/methods/Put.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;GAIG;AACH,MAAM,UAAU,GAAG,CAAC,MAA0C;IAC5D,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAE1G,OAAO,cAAc,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC;AACrH,CAAC"}

package/dist/lib/server/web/decorators/methods/Route.d.ts

@@ -0,0 +1,21 @@
+import type { ControllerDecoratorParams } from '../../../../adapter';
+/**
+ * Decorator for handling custom HTTP methods.
+ * Use this when standard decorators (@Get, @Post, etc.) don't cover your HTTP method.
+ *
+ * @param {string} method - The HTTP method (e.g., 'MYVERB', 'PURGE', 'LINK')
+ * @param {ControllerDecoratorParams | string} params - Route path or full params object
+ * @returns {Function} The generic handler for the custom method
+ *
+ * @example
+ * ```typescript
+ * @Controller('/api')
+ * export class ApiController {
+ *   @Route('PURGE', '/cache')
+ *   async purgeCache(context: Context) {
+ *     // Handle PURGE /api/cache
+ *   }
+ * }
+ * ```
+ */
+export declare function Route(method: string, params?: ControllerDecoratorParams | string): Function;

package/dist/lib/server/web/decorators/methods/Route.js

@@ -0,0 +1,33 @@
+import { generateHandlerParams, genericHandler } from '../http.base';
+/**
+ * Decorator for handling custom HTTP methods.
+ * Use this when standard decorators (@Get, @Post, etc.) don't cover your HTTP method.
+ *
+ * @param {string} method - The HTTP method (e.g., 'MYVERB', 'PURGE', 'LINK')
+ * @param {ControllerDecoratorParams | string} params - Route path or full params object
+ * @returns {Function} The generic handler for the custom method
+ *
+ * @example
+ * ```typescript
+ * @Controller('/api')
+ * export class ApiController {
+ *   @Route('PURGE', '/cache')
+ *   async purgeCache(context: Context) {
+ *     // Handle PURGE /api/cache
+ *   }
+ * }
+ * ```
+ */
+export function Route(method, params = '/') {
+    const { path, middlewares, summary, description, staticServe, validator } = generateHandlerParams(params);
+    return genericHandler({
+        method: method.toLowerCase(),
+        path,
+        summary,
+        middlewares,
+        description,
+        staticServe,
+        validator,
+    });
+}
+//# sourceMappingURL=Route.js.map

package/dist/lib/server/web/decorators/methods/Route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Route.js","sourceRoot":"","sources":["../../../../../../lib/server/web/decorators/methods/Route.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAIrE;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,KAAK,CAAC,MAAc,EAAE,SAA6C,GAAG;IACpF,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAE1G,OAAO,cAAc,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC,WAAW,EAAgB;QAC1C,IAAI;QACJ,OAAO;QACP,WAAW;QACX,WAAW;QACX,WAAW;QACX,SAAS;KACV,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/server/web/decorators/methods/Trace.js

@@ -6,7 +6,7 @@ import { HttpMethod } from '../../types';
  * @returns {Function} The generic handler for the TRACE request.
  */
 export function Trace(params) {
-    const { path, middlewares, description, staticServe, validator } = generateHandlerParams(params);
-    return genericHandler({ method: HttpMethod.TRACE, path, middlewares, description, staticServe, validator });
+    const { path, middlewares, summary, description, staticServe, validator } = generateHandlerParams(params);
+    return genericHandler({ method: HttpMethod.TRACE, path, summary, middlewares, description, staticServe, validator });
 }
 //# sourceMappingURL=Trace.js.map

package/dist/lib/server/web/decorators/methods/Trace.js.map

@@ -1 +1 @@
-{"version":3,"file":"Trace.js","sourceRoot":"","sources":["../../../../../../lib/server/web/decorators/methods/Trace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;GAIG;AACH,MAAM,UAAU,KAAK,CAAC,MAA0C;IAC9D,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAEjG,OAAO,cAAc,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC;AAC9G,CAAC"}
+{"version":3,"file":"Trace.js","sourceRoot":"","sources":["../../../../../../lib/server/web/decorators/methods/Trace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;GAIG;AACH,MAAM,UAAU,KAAK,CAAC,MAA0C;IAC9D,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAE1G,OAAO,cAAc,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC;AACvH,CAAC"}

package/dist/lib/server/web/decorators/methods/index.d.ts

@@ -7,3 +7,5 @@ export { Options } from './Options';
 export { Head } from './Head';
 export { Connect } from './Connect';
 export { Trace } from './Trace';
+export { All } from './All';
+export { Route } from './Route';

package/dist/lib/server/web/decorators/methods/index.js

@@ -7,4 +7,6 @@ export { Options } from './Options';
 export { Head } from './Head';
 export { Connect } from './Connect';
 export { Trace } from './Trace';
+export { All } from './All';
+export { Route } from './Route';
 //# sourceMappingURL=index.js.map

package/dist/lib/server/web/decorators/methods/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../lib/server/web/decorators/methods/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../lib/server/web/decorators/methods/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC"}

package/dist/lib/server/web/middleware/AsenaValidationService.d.ts

@@ -1,4 +1,24 @@
 import type { Class } from '../../types';
+/**
+ * Defines the shape of a single response entry with optional schema and description.
+ * Used in status-code-mapped response definitions.
+ *
+ * @template S - Schema type
+ */
+export interface ResponseSchemaDefinition<S> {
+    schema?: S;
+    description?: string;
+}
+/**
+ * Flexible response schema type for OpenAPI documentation.
+ * Supports three formats:
+ * - Single schema: treated as the 200 response
+ * - Status code map with raw schemas: `{ 201: schema, 400: schema }`
+ * - Status code map with definitions: `{ 201: { schema, description } }`
+ *
+ * @template S - Schema type
+ */
+export type ResponseSchema<S> = S | Record<number, S | ResponseSchemaDefinition<S>>;
 /**
  * Interface representing a validation service.
  * @template S - Schema type.
@@ -29,5 +49,17 @@ export interface AsenaValidationService<S> {
      * @returns {Promise<S> | S} The handler for header validation.
      */
     header?(): Promise<S> | S;
+    /**
+     * Defines the response schema for OpenAPI documentation.
+     * Not used at runtime validation — only consumed by documentation generators.
+     *
+     * Supports three formats:
+     * - Single schema: `response() { return z.object({...}); }` → 200 response
+     * - Status code map: `response() { return { 201: schema, 400: schema }; }`
+     * - Full definitions: `response() { return { 201: { schema, description: '...' } }; }`
+     *
+     * @returns {Promise<ResponseSchema<S>> | ResponseSchema<S>} The response schema definition.
+     */
+    response?(): Promise<ResponseSchema<S>> | ResponseSchema<S>;
 }
 export type ValidatorClass<S = unknown> = Class<AsenaValidationService<S>>;