stratal 0.0.11 → 0.0.13

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.11",
+  "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,12 +84,12 @@
     "lint:fix": "npx eslint --fix ."
   },
   "dependencies": {
+    "@hono/swagger-ui": "^0.5.0",
     "@hono/zod-openapi": "^1.2.2",
-    "@intlify/core-base": "^11.2.8",
-    "@intlify/message-compiler": "^11.2.8",
-    "@scalar/hono-api-reference": "^0.10.0",
+    "@intlify/core-base": "^11.3.0",
+    "@intlify/message-compiler": "^11.3.0",
     "@xmldom/xmldom": "^0.8.11",
-    "hono": "^4.12.5",
+    "hono": "^4.12.8",
     "reflect-metadata": "^0.2.2",
     "tsyringe": "^4.10.0",
     "zod": "^4.3.6"
@@ -131,24 +135,26 @@
     }
   },
   "devDependencies": {
-    "@aws-sdk/client-s3": "3.1004.0",
-    "@aws-sdk/lib-storage": "^3.1004.0",
-    "@aws-sdk/s3-request-presigner": "3.1004.0",
-    "@cloudflare/vitest-pool-workers": "^0.12.20",
-    "@cloudflare/workers-types": "4.20260307.1",
-    "@react-email/components": "^1.0.8",
+    "@aws-sdk/client-s3": "3.1009.0",
+    "@aws-sdk/lib-storage": "^3.1009.0",
+    "@aws-sdk/s3-request-presigner": "3.1009.0",
+    "@cloudflare/vitest-pool-workers": "patch:@cloudflare/vitest-pool-workers@npm%3A0.13.0#~/.yarn/patches/@cloudflare-vitest-pool-workers-npm-0.13.0-47105599c6.patch",
+    "@cloudflare/workers-types": "4.20260313.1",
+    "@react-email/components": "^1.0.9",
     "@stratal/testing": "workspace:*",
     "@tus/server": "^2.3.0",
-    "@types/node": "^25.3.5",
+    "@types/node": "^25.5.0",
     "@types/nodemailer": "^7.0.11",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
-    "@vitest/coverage-v8": "^4.0.18",
-    "nodemailer": "^8.0.1",
+    "@vitest/coverage-v8": "^4.1.0",
+    "@vitest/runner": "~4.1.0",
+    "@vitest/snapshot": "~4.1.0",
+    "nodemailer": "^8.0.2",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
     "resend": "^6.9.3",
     "typescript": "^5.9.3",
-    "vitest": "~3.2.0"
+    "vitest": "~4.1.0"
   }
 }