stratal 0.0.12 → 0.0.13

package/dist/websocket/decorators/gateway.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.decorator.js","sourceRoot":"","sources":["../../../src/websocket/decorators/gateway.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAI5D,MAAM,oBAAoB,GAAG,mBAAmB,CAAC,gBAAgB,CAAA;AACjE,MAAM,sBAAsB,GAAG,mBAAmB,CAAC,kBAAkB,CAAA;AACrE,MAAM,kBAAkB,GAAG,mBAAmB,CAAC,cAAc,CAAA;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,OAAO,CAAC,KAAa,EAAE,OAAwB;IAC7D,OAAO,UAAiC,MAAS;QAC/C,SAAS,EAAE,CAAC,MAAM,CAAC,CAAA;QACnB,OAAO,CAAC,cAAc,CAAC,oBAAoB,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;QAC3D,OAAO,CAAC,cAAc,CAAC,kBAAkB,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;QACxD,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,cAAc,CAAC,sBAAsB,EAAE,OAAO,EAAE,MAAM,CAAC,CAAA;QACjE,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,MAAc;IACtC,MAAM,cAAc,GAAG,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAE,MAAkC,CAAC,WAAW,CAAA;IAC9G,OAAO,OAAO,CAAC,WAAW,CAAC,kBAAkB,EAAE,cAAc,CAAC,KAAK,IAAI,CAAA;AACzE,CAAC"}

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

@@ -0,0 +1,3 @@
+export { Gateway, isGateway } from './gateway.decorator';
+export { getWsOnCloseMethod, getWsOnErrorMethod, getWsOnMessageMethod, OnClose, OnError, OnMessage } from './ws-event.decorator';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/websocket/decorators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/websocket/decorators/index.js

@@ -0,0 +1,3 @@
+export { Gateway, isGateway } from './gateway.decorator';
+export { getWsOnCloseMethod, getWsOnErrorMethod, getWsOnMessageMethod, OnClose, OnError, OnMessage } from './ws-event.decorator';
+//# sourceMappingURL=index.js.map

package/dist/websocket/decorators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/websocket/decorators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/websocket/decorators/ws-event.decorator.d.ts

@@ -0,0 +1,59 @@
+import type { Constructor } from '../../types';
+/**
+ * Marks a method as the WebSocket message handler
+ *
+ * @example
+ * ```typescript
+ * @Gateway('/ws/chat')
+ * class ChatGateway {
+ *   @OnMessage()
+ *   handleMessage(evt: MessageEvent, ctx: GatewayContext) {
+ *     ctx.send(evt.data)
+ *   }
+ * }
+ * ```
+ */
+export declare function OnMessage(): MethodDecorator;
+/**
+ * Marks a method as the WebSocket close handler
+ *
+ * @example
+ * ```typescript
+ * @Gateway('/ws/chat')
+ * class ChatGateway {
+ *   @OnClose()
+ *   handleClose(evt: CloseEvent, ctx: GatewayContext) {
+ *     console.log('closed')
+ *   }
+ * }
+ * ```
+ */
+export declare function OnClose(): MethodDecorator;
+/**
+ * Marks a method as the WebSocket error handler
+ *
+ * @example
+ * ```typescript
+ * @Gateway('/ws/chat')
+ * class ChatGateway {
+ *   @OnError()
+ *   handleError(evt: Event, ctx: GatewayContext) {
+ *     console.error('WebSocket error', evt)
+ *   }
+ * }
+ * ```
+ */
+export declare function OnError(): MethodDecorator;
+/**
+ * Get the method name decorated with @OnMessage
+ */
+export declare function getWsOnMessageMethod(target: Constructor): string | undefined;
+/**
+ * Get the method name decorated with @OnClose
+ */
+export declare function getWsOnCloseMethod(target: Constructor): string | undefined;
+/**
+ * Get the method name decorated with @OnError
+ */
+export declare function getWsOnErrorMethod(target: Constructor): string | undefined;
+//# sourceMappingURL=ws-event.decorator.d.ts.map

package/dist/websocket/decorators/ws-event.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-event.decorator.d.ts","sourceRoot":"","sources":["../../../src/websocket/decorators/ws-event.decorator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAmB9C;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,IAAI,eAAe,CAM3C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,IAAI,eAAe,CAIzC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,IAAI,eAAe,CAIzC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAE5E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAE1E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAE1E"}

package/dist/websocket/decorators/ws-event.decorator.js

@@ -0,0 +1,94 @@
+import { ROUTE_METADATA_KEYS } from '../../router/constants';
+import { WebSocketDuplicateEventHandlerError } from '../errors/websocket-duplicate-event-handler.error';
+const WS_ON_MESSAGE_KEY = ROUTE_METADATA_KEYS.WS_ON_MESSAGE;
+const WS_ON_CLOSE_KEY = ROUTE_METADATA_KEYS.WS_ON_CLOSE;
+const WS_ON_ERROR_KEY = ROUTE_METADATA_KEYS.WS_ON_ERROR;
+/**
+ * Define a single-handler metadata key on the prototype.
+ * Throws if a different method already owns this key (prevents silent override).
+ */
+function defineSingleHandlerMetadata(key, propertyKey, target, decoratorName) {
+    const existing = Reflect.getMetadata(key, target);
+    if (existing !== undefined && existing !== propertyKey) {
+        throw new WebSocketDuplicateEventHandlerError(decoratorName, String(existing));
+    }
+    Reflect.defineMetadata(key, propertyKey, target);
+}
+/**
+ * Marks a method as the WebSocket message handler
+ *
+ * @example
+ * ```typescript
+ * @Gateway('/ws/chat')
+ * class ChatGateway {
+ *   @OnMessage()
+ *   handleMessage(evt: MessageEvent, ctx: GatewayContext) {
+ *     ctx.send(evt.data)
+ *   }
+ * }
+ * ```
+ */
+export function OnMessage() {
+    // `_target` is the class prototype (method decorator convention).
+    // The getter functions below read from `target.prototype` symmetrically.
+    return (_target, propertyKey) => {
+        defineSingleHandlerMetadata(WS_ON_MESSAGE_KEY, propertyKey, _target, 'OnMessage');
+    };
+}
+/**
+ * Marks a method as the WebSocket close handler
+ *
+ * @example
+ * ```typescript
+ * @Gateway('/ws/chat')
+ * class ChatGateway {
+ *   @OnClose()
+ *   handleClose(evt: CloseEvent, ctx: GatewayContext) {
+ *     console.log('closed')
+ *   }
+ * }
+ * ```
+ */
+export function OnClose() {
+    return (_target, propertyKey) => {
+        defineSingleHandlerMetadata(WS_ON_CLOSE_KEY, propertyKey, _target, 'OnClose');
+    };
+}
+/**
+ * Marks a method as the WebSocket error handler
+ *
+ * @example
+ * ```typescript
+ * @Gateway('/ws/chat')
+ * class ChatGateway {
+ *   @OnError()
+ *   handleError(evt: Event, ctx: GatewayContext) {
+ *     console.error('WebSocket error', evt)
+ *   }
+ * }
+ * ```
+ */
+export function OnError() {
+    return (_target, propertyKey) => {
+        defineSingleHandlerMetadata(WS_ON_ERROR_KEY, propertyKey, _target, 'OnError');
+    };
+}
+/**
+ * Get the method name decorated with @OnMessage
+ */
+export function getWsOnMessageMethod(target) {
+    return Reflect.getMetadata(WS_ON_MESSAGE_KEY, target.prototype);
+}
+/**
+ * Get the method name decorated with @OnClose
+ */
+export function getWsOnCloseMethod(target) {
+    return Reflect.getMetadata(WS_ON_CLOSE_KEY, target.prototype);
+}
+/**
+ * Get the method name decorated with @OnError
+ */
+export function getWsOnErrorMethod(target) {
+    return Reflect.getMetadata(WS_ON_ERROR_KEY, target.prototype);
+}
+//# sourceMappingURL=ws-event.decorator.js.map

package/dist/websocket/decorators/ws-event.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-event.decorator.js","sourceRoot":"","sources":["../../../src/websocket/decorators/ws-event.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAE5D,OAAO,EAAE,mCAAmC,EAAE,MAAM,mDAAmD,CAAA;AAEvG,MAAM,iBAAiB,GAAG,mBAAmB,CAAC,aAAa,CAAA;AAC3D,MAAM,eAAe,GAAG,mBAAmB,CAAC,WAAW,CAAA;AACvD,MAAM,eAAe,GAAG,mBAAmB,CAAC,WAAW,CAAA;AAEvD;;;GAGG;AACH,SAAS,2BAA2B,CAAC,GAAoB,EAAE,WAA4B,EAAE,MAAc,EAAE,aAAqB;IAC5H,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,CAAgC,CAAA;IAChF,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;QACvD,MAAM,IAAI,mCAAmC,CAAC,aAAa,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAA;IAChF,CAAC;IACD,OAAO,CAAC,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,CAAC,CAAA;AAClD,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,SAAS;IACvB,kEAAkE;IAClE,yEAAyE;IACzE,OAAO,CAAC,OAAe,EAAE,WAA4B,EAAE,EAAE;QACvD,2BAA2B,CAAC,iBAAiB,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,CAAC,CAAA;IACnF,CAAC,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,OAAO;IACrB,OAAO,CAAC,OAAe,EAAE,WAA4B,EAAE,EAAE;QACvD,2BAA2B,CAAC,eAAe,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,CAAC,CAAA;IAC/E,CAAC,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,OAAO;IACrB,OAAO,CAAC,OAAe,EAAE,WAA4B,EAAE,EAAE;QACvD,2BAA2B,CAAC,eAAe,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,CAAC,CAAA;IAC/E,CAAC,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAmB;IACtD,OAAO,OAAO,CAAC,WAAW,CAAC,iBAAiB,EAAE,MAAM,CAAC,SAAmB,CAAuB,CAAA;AACjG,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAmB;IACpD,OAAO,OAAO,CAAC,WAAW,CAAC,eAAe,EAAE,MAAM,CAAC,SAAmB,CAAuB,CAAA;AAC/F,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAmB;IACpD,OAAO,OAAO,CAAC,WAAW,CAAC,eAAe,EAAE,MAAM,CAAC,SAAmB,CAAuB,CAAA;AAC/F,CAAC"}

package/dist/websocket/errors/websocket-body-not-available.error.d.ts

@@ -0,0 +1,5 @@
+import { ApplicationError } from '../../errors';
+export declare class WebSocketBodyNotAvailableError extends ApplicationError {
+    constructor();
+}
+//# sourceMappingURL=websocket-body-not-available.error.d.ts.map

package/dist/websocket/errors/websocket-body-not-available.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-body-not-available.error.d.ts","sourceRoot":"","sources":["../../../src/websocket/errors/websocket-body-not-available.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAe,MAAM,cAAc,CAAA;AAE5D,qBAAa,8BAA+B,SAAQ,gBAAgB;;CAOnE"}

package/dist/websocket/errors/websocket-body-not-available.error.js

@@ -0,0 +1,7 @@
+import { ApplicationError, ERROR_CODES } from '../../errors';
+export class WebSocketBodyNotAvailableError extends ApplicationError {
+    constructor() {
+        super('errors.websocketBodyNotAvailable', ERROR_CODES.SYSTEM.WEBSOCKET_BODY_NOT_AVAILABLE);
+    }
+}
+//# sourceMappingURL=websocket-body-not-available.error.js.map

package/dist/websocket/errors/websocket-body-not-available.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-body-not-available.error.js","sourceRoot":"","sources":["../../../src/websocket/errors/websocket-body-not-available.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE5D,MAAM,OAAO,8BAA+B,SAAQ,gBAAgB;IAClE;QACE,KAAK,CACH,kCAAkC,EAClC,WAAW,CAAC,MAAM,CAAC,4BAA4B,CAChD,CAAA;IACH,CAAC;CACF"}

package/dist/websocket/errors/websocket-duplicate-event-handler.error.d.ts

@@ -0,0 +1,5 @@
+import { ApplicationError } from '../../errors';
+export declare class WebSocketDuplicateEventHandlerError extends ApplicationError {
+    constructor(decorator: string, existingMethod: string);
+}
+//# sourceMappingURL=websocket-duplicate-event-handler.error.d.ts.map

package/dist/websocket/errors/websocket-duplicate-event-handler.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-duplicate-event-handler.error.d.ts","sourceRoot":"","sources":["../../../src/websocket/errors/websocket-duplicate-event-handler.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAe,MAAM,cAAc,CAAA;AAE5D,qBAAa,mCAAoC,SAAQ,gBAAgB;gBAC3D,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM;CAOtD"}

package/dist/websocket/errors/websocket-duplicate-event-handler.error.js

@@ -0,0 +1,7 @@
+import { ApplicationError, ERROR_CODES } from '../../errors';
+export class WebSocketDuplicateEventHandlerError extends ApplicationError {
+    constructor(decorator, existingMethod) {
+        super('errors.websocketDuplicateEventHandler', ERROR_CODES.SYSTEM.WEBSOCKET_DUPLICATE_EVENT_HANDLER, { decorator, existingMethod });
+    }
+}
+//# sourceMappingURL=websocket-duplicate-event-handler.error.js.map

package/dist/websocket/errors/websocket-duplicate-event-handler.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-duplicate-event-handler.error.js","sourceRoot":"","sources":["../../../src/websocket/errors/websocket-duplicate-event-handler.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE5D,MAAM,OAAO,mCAAoC,SAAQ,gBAAgB;IACvE,YAAY,SAAiB,EAAE,cAAsB;QACnD,KAAK,CACH,uCAAuC,EACvC,WAAW,CAAC,MAAM,CAAC,iCAAiC,EACpD,EAAE,SAAS,EAAE,cAAc,EAAE,CAC9B,CAAA;IACH,CAAC;CACF"}

package/dist/websocket/gateway-context.d.ts

@@ -0,0 +1,51 @@
+import type { Context } from 'hono';
+import type { WSContext, WSReadyState } from 'hono/ws';
+import type { ContextQueryResult } from '../router/router-context';
+import { RouterContext } from '../router/router-context';
+import type { RouterEnv } from '../router/types';
+/**
+ * WebSocket gateway context
+ *
+ * Extends RouterContext with WebSocket-specific methods.
+ * Inherits `getContainer()`, `param()`, `query()`, `header()`, `getLocale()`
+ * from RouterContext. HTTP response methods (`json()`, `redirect()`, etc.) are
+ * inherited but harmless post-upgrade.
+ *
+ * @example
+ * ```typescript
+ * @OnMessage()
+ * handleMessage(evt: MessageEvent, ctx: GatewayContext) {
+ *   ctx.send('ack')           // convenience method
+ *   ctx.header('Authorization') // upgrade request headers
+ * }
+ * ```
+ */
+export declare class GatewayContext extends RouterContext {
+    readonly ws: WSContext;
+    constructor(c: Context<RouterEnv>, ws: WSContext);
+    /** Send data through the WebSocket connection */
+    send(data: string | ArrayBuffer | Uint8Array<ArrayBuffer>): void;
+    /** Close the WebSocket connection */
+    close(code?: number, reason?: string): void;
+    /** Current WebSocket ready state */
+    get readyState(): WSReadyState;
+    /**
+     * Get route parameter value from the raw request (no OpenAPI validation)
+     *
+     * @param key - Parameter name (e.g., 'id' for /ws/chat/:id)
+     */
+    param(key: string): string;
+    /**
+     * Get query parameter value from the raw request (no OpenAPI validation)
+     *
+     * @param key - Query parameter name
+     */
+    query<R extends Record<string, unknown> | undefined = undefined, K extends string | undefined = undefined>(key?: K): ContextQueryResult<R, K>;
+    /**
+     * Request body is not available in WebSocket gateways
+     *
+     * @throws WebSocketBodyNotAvailableError always — WebSocket upgrade requests do not have a body
+     */
+    body<T>(): Promise<T>;
+}
+//# sourceMappingURL=gateway-context.d.ts.map

package/dist/websocket/gateway-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-context.d.ts","sourceRoot":"","sources":["../../src/websocket/gateway-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AACnC,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAGhD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,cAAe,SAAQ,aAAa;aACI,EAAE,EAAE,SAAS;gBAApD,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,EAAkB,EAAE,EAAE,SAAS;IAIhE,iDAAiD;IACjD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC,GAAG,IAAI;IAIhE,qCAAqC;IACrC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAI3C,oCAAoC;IACpC,IAAI,UAAU,IAAI,YAAY,CAE7B;IAED;;;;OAIG;IACM,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAInC;;;;OAIG;IACM,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,SAAS,EAAE,CAAC,SAAS,MAAM,GAAG,SAAS,GAAG,SAAS,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC;IAOtJ;;;;OAIG;IACM,IAAI,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC;CAG/B"}

package/dist/websocket/gateway-context.js

@@ -0,0 +1,66 @@
+import { RouterContext } from '../router/router-context';
+import { WebSocketBodyNotAvailableError } from './errors/websocket-body-not-available.error';
+/**
+ * WebSocket gateway context
+ *
+ * Extends RouterContext with WebSocket-specific methods.
+ * Inherits `getContainer()`, `param()`, `query()`, `header()`, `getLocale()`
+ * from RouterContext. HTTP response methods (`json()`, `redirect()`, etc.) are
+ * inherited but harmless post-upgrade.
+ *
+ * @example
+ * ```typescript
+ * @OnMessage()
+ * handleMessage(evt: MessageEvent, ctx: GatewayContext) {
+ *   ctx.send('ack')           // convenience method
+ *   ctx.header('Authorization') // upgrade request headers
+ * }
+ * ```
+ */
+export class GatewayContext extends RouterContext {
+    ws;
+    constructor(c, ws) {
+        super(c);
+        this.ws = ws;
+    }
+    /** Send data through the WebSocket connection */
+    send(data) {
+        this.ws.send(data);
+    }
+    /** Close the WebSocket connection */
+    close(code, reason) {
+        this.ws.close(code, reason);
+    }
+    /** Current WebSocket ready state */
+    get readyState() {
+        return this.ws.readyState;
+    }
+    /**
+     * Get route parameter value from the raw request (no OpenAPI validation)
+     *
+     * @param key - Parameter name (e.g., 'id' for /ws/chat/:id)
+     */
+    param(key) {
+        return this.c.req.param(key);
+    }
+    /**
+     * Get query parameter value from the raw request (no OpenAPI validation)
+     *
+     * @param key - Query parameter name
+     */
+    query(key) {
+        if (key) {
+            return this.c.req.query(key);
+        }
+        return this.c.req.query();
+    }
+    /**
+     * Request body is not available in WebSocket gateways
+     *
+     * @throws WebSocketBodyNotAvailableError always — WebSocket upgrade requests do not have a body
+     */
+    body() {
+        throw new WebSocketBodyNotAvailableError();
+    }
+}
+//# sourceMappingURL=gateway-context.js.map

package/dist/websocket/gateway-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-context.js","sourceRoot":"","sources":["../../src/websocket/gateway-context.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAExD,OAAO,EAAE,8BAA8B,EAAE,MAAM,6CAA6C,CAAA;AAE5F;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,cAAe,SAAQ,aAAa;IACI;IAAnD,YAAY,CAAqB,EAAkB,EAAa;QAC9D,KAAK,CAAC,CAAC,CAAC,CAAA;QADyC,OAAE,GAAF,EAAE,CAAW;IAEhE,CAAC;IAED,iDAAiD;IACjD,IAAI,CAAC,IAAoD;QACvD,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACpB,CAAC;IAED,qCAAqC;IACrC,KAAK,CAAC,IAAa,EAAE,MAAe;QAClC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IAC7B,CAAC;IAED,oCAAoC;IACpC,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,EAAE,CAAC,UAAU,CAAA;IAC3B,CAAC;IAED;;;;OAIG;IACM,KAAK,CAAC,GAAW;QACxB,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAE,CAAA;IAC/B,CAAC;IAED;;;;OAIG;IACM,KAAK,CAAsG,GAAO;QACzH,IAAI,GAAG,EAAE,CAAC;YACR,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAA6B,CAAA;QAC1D,CAAC;QACD,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,EAA8B,CAAA;IACvD,CAAC;IAED;;;;OAIG;IACM,IAAI;QACX,MAAM,IAAI,8BAA8B,EAAE,CAAA;IAC5C,CAAC;CACF"}

package/dist/websocket/index.d.ts

@@ -0,0 +1,7 @@
+export type { WSContext, WSEvents, WSMessageReceive, WSReadyState } from 'hono/ws';
+export { Gateway, isGateway, OnMessage, OnClose, OnError, getWsOnMessageMethod, getWsOnCloseMethod, getWsOnErrorMethod } from './decorators';
+export { WebSocketBodyNotAvailableError } from './errors/websocket-body-not-available.error';
+export { WebSocketDuplicateEventHandlerError } from './errors/websocket-duplicate-event-handler.error';
+export { GatewayContext } from './gateway-context';
+export type { GatewayOptions } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/websocket/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAClF,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAC5I,OAAO,EAAE,8BAA8B,EAAE,MAAM,6CAA6C,CAAA;AAC5F,OAAO,EAAE,mCAAmC,EAAE,MAAM,kDAAkD,CAAA;AACtG,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA"}

package/dist/websocket/index.js

@@ -0,0 +1,5 @@
+export { Gateway, isGateway, OnMessage, OnClose, OnError, getWsOnMessageMethod, getWsOnCloseMethod, getWsOnErrorMethod } from './decorators';
+export { WebSocketBodyNotAvailableError } from './errors/websocket-body-not-available.error';
+export { WebSocketDuplicateEventHandlerError } from './errors/websocket-duplicate-event-handler.error';
+export { GatewayContext } from './gateway-context';
+//# sourceMappingURL=index.js.map

package/dist/websocket/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/websocket/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAC5I,OAAO,EAAE,8BAA8B,EAAE,MAAM,6CAA6C,CAAA;AAC5F,OAAO,EAAE,mCAAmC,EAAE,MAAM,kDAAkD,CAAA;AACtG,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/websocket/types.d.ts

@@ -0,0 +1,7 @@
+import { type ControllerOptions } from "../router/types";
+/**
+ * Gateway options for @Gateway() decorator
+ * Subset of ControllerOptions relevant to WebSocket gateways (no OpenAPI-specific fields)
+ */
+export type GatewayOptions = Pick<ControllerOptions, 'version'>;
+//# sourceMappingURL=types.d.ts.map

package/dist/websocket/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/websocket/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,iBAAiB,EAAE,SAAS,CAAC,CAAA"}

package/dist/websocket/types.js

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

package/dist/websocket/types.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stratal",
-  "version": "0.0.12",
+  "version": "0.0.13",
   "description": "A modular Cloudflare Workers framework with dependency injection, queue-based events, and type-safe configuration",
   "type": "module",
   "license": "MIT",
@@ -58,6 +58,10 @@
       "types": "./dist/i18n/validation/index.d.ts",
       "import": "./dist/i18n/validation/index.js"
     },
+    "./websocket": {
+      "types": "./dist/websocket/index.d.ts",
+      "import": "./dist/websocket/index.js"
+    },
     "./*": {
       "types": "./dist/*/index.d.ts",
       "import": "./dist/*/index.js"
@@ -80,10 +84,10 @@
     "lint:fix": "npx eslint --fix ."
   },
   "dependencies": {
+    "@hono/swagger-ui": "^0.5.0",
     "@hono/zod-openapi": "^1.2.2",
     "@intlify/core-base": "^11.3.0",
     "@intlify/message-compiler": "^11.3.0",
-    "@scalar/hono-api-reference": "^0.10.3",
     "@xmldom/xmldom": "^0.8.11",
     "hono": "^4.12.8",
     "reflect-metadata": "^0.2.2",