René's URL Explorer Experiment

Title: Add runtime-agnostic WebSocket routing to `@bquery/bquery/server` by Copilot · Pull Request #88 · bQuery/bQuery · GitHub

Open Graph Title: Add runtime-agnostic WebSocket routing to `@bquery/bquery/server` by Copilot · Pull Request #88 · bQuery/bQuery

X Title: Add runtime-agnostic WebSocket routing to `@bquery/bquery/server` by Copilot · Pull Request #88 · bQuery/bQuery

Description: The server backend stopped at HTTP middleware/routing and did not provide a first-class path for WebSocket upgrades. This change extends @bquery/bquery/server with explicit WebSocket route registration and a runtime-agnostic session layer so upgrade handling can plug into Bun/Deno/Node-style hosts without changing the existing HTTP flow. Server API Added app.ws(path, handler, middlewares?) for WebSocket routes alongside existing HTTP method helpers Added app.handleWebSocket(request) to resolve upgrade requests into either: null when the request is not a WebSocket handshake or no route matches a Response when middleware/error handling short-circuits a ServerWebSocketSession when the upgrade should be accepted Added isWebSocketRequest() and isServerWebSocketSession() helpers for adapter/runtime integration Session model Introduced runtime-agnostic server WebSocket types: ServerWebSocketSession ServerWebSocketPeer ServerWebSocketConnection ServerWebSocketHandlerSet ServerWebSocketRouteHandler Session callbacks cover onOpen, onMessage, onClose, and onError Added socket.sendJson() for structured outbound messages Normalized requested subprotocols and preserved route params, query, and middleware-populated state inside the session context Behavior WebSocket routes reuse the existing middleware pipeline instead of introducing a parallel stack Middleware can short-circuit upgrades with a normal Response Incoming text frames default to JSON parsing with raw-string fallback for non-JSON payloads Existing HTTP handle() behavior remains unchanged Docs and public surface Updated server guide and top-level project summaries to document the new backend WebSocket flow Synced server exports and full-bundle metadata with the new public API import { createServer, isServerWebSocketSession, isWebSocketRequest, } from '@bquery/bquery/server'; const app = createServer(); app.ws('/chat/:room', (ctx) => ({ protocols: ['chat'], onOpen(socket) { socket.sendJson({ type: 'ready', room: ctx.params.room }); }, onMessage(message, socket) { socket.sendJson({ type: 'echo', message }); }, })); export async function handler(request: Request) { if (!isWebSocketRequest(request)) { return app.handle(request); } const result = await app.handleWebSocket(request); if (result instanceof Response || result === null) { return result ?? new Response('Not Found', { status: 404 }); } if (isServerWebSocketSession(result)) { const { socket, response } = Deno.upgradeWebSocket(request, { protocol: result.protocols[0], }); socket.onopen = () => void result.open(socket); socket.onmessage = (event) => void result.message(socket, event); socket.onclose = (event) => void result.close(socket, event); socket.onerror = (event) => void result.error(socket, event); return response; } return new Response('Upgrade failed', { status: 500 }); }

Open Graph Description: The server backend stopped at HTTP middleware/routing and did not provide a first-class path for WebSocket upgrades. This change extends @bquery/bquery/server with explicit WebSocket route registra...

X Description: The server backend stopped at HTTP middleware/routing and did not provide a first-class path for WebSocket upgrades. This change extends @bquery/bquery/server with explicit WebSocket route registra...

Opengraph URL: https://github.com/bQuery/bQuery/pull/88

X: @github

direct link

Domain: github.com

Links:

Viewport: width=device-width