experimental-ash 0.61.0 → 0.63.0

package/dist/src/channel/websocket-upgrade-server.d.ts

@@ -0,0 +1,26 @@
+import { type Server } from "node:http";
+import type { WebSocketRouteHandler } from "#channel/routes.js";
+/**
+ * Escape hatch for SDKs and frameworks that need a Node HTTP server-shaped
+ * upgrade target inside an Ash `WS()` route.
+ *
+ * Prefer normal `WS()` lifecycle hooks for Ash-owned websocket behavior. Use
+ * this bridge only when an integration expects to register
+ * `httpServer.on("upgrade", ...)` handlers itself. The server is intentionally
+ * not listening on a port; Ash forwards only the matched route's raw Node
+ * upgrade into it.
+ */
+export interface WebSocketUpgradeServerBridge {
+    readonly route: WebSocketRouteHandler;
+    readonly server: Server;
+}
+/**
+ * Creates an escape-hatch Node HTTP server facade plus a `WS()` route handler
+ * that forwards matched raw upgrade events into that server.
+ *
+ * Prefer authoring websocket behavior directly with `WS()` hooks. Reach for
+ * this only when an SDK or framework binds to `http.Server` upgrade events,
+ * such as `engine.attach(server, path, ...)`. It works only on hosts where
+ * Nitro exposes a Node upgrade tuple for the matched WebSocket route.
+ */
+export declare function createWebSocketUpgradeServer(): WebSocketUpgradeServerBridge;

package/dist/src/channel/websocket-upgrade-server.js

@@ -0,0 +1 @@
+import{createServer}from"node:http";function createWebSocketUpgradeServer(){let t=createServer();return{route:createWebSocketUpgradeRoute(t),server:t}}function createWebSocketUpgradeRoute(e){return()=>({upgrade(t){return dispatchNodeUpgrade(e,t)}})}async function dispatchNodeUpgrade(e,t){let n=resolveNodeUpgrade(t);if(n===null)return Response.json({error:`This WebSocket route cannot expose a Node upgrade event on the current host.`,ok:!1},{status:501});let r=e.listeners(`upgrade`);if(r.length===0)return Response.json({error:`No upgrade listeners are registered on this WebSocket server bridge.`,ok:!1},{status:500});for(let t of r)await Promise.resolve(t.call(e,n.request,n.socket,n.head));return{handled:!0}}function resolveNodeUpgrade(e){let t=e.runtime?.node,n=t?.req,r=t?.upgrade?.socket,i=t?.upgrade?.head;if(n===void 0||r===void 0||i===void 0)return null;if(typeof n.url!=`string`||n.url.length===0){let t=new URL(e.url);n.url=`${t.pathname}${t.search}`}return{head:i,request:n,socket:r}}export{createWebSocketUpgradeServer};