sleepy-serv 0.21.0 → 0.23.0

package/README.md

@@ -65,7 +65,7 @@ object with these properties:
   directly.
 - `ws`: WebSocket commands for interacting with connected clients:
   `query(fn)`, `send(fn, event, body)`, `broadcast(event, body)`, and
-  `drop(fn, code?, reason?)`.
+  `drop(signal, fn)`.
 - `close`: an `async` function that shuts the app down. See
   [Shutting Down](#shutting-down).
 
@@ -476,7 +476,13 @@ const app = createApp(3000, {
 
 App-level middleware is executed before any directory-level or route-level middleware.
 
-Note that the reserved `/ws` handshake routes are folded into these same chains, so app-level middleware runs against them too. A catch-all validator (for example a `validateSchemas` that requires a JSON body or a specific header on every request) will therefore also run against the body-less `/ws` handshake requests and reject them. Scope such validators below the reserved paths rather than applying them app-wide.
+When WebSocket support is enabled (`ws: true` or `ws: { ... }`), the
+reserved `/ws` handshake routes are folded into these same chains, so
+app-level middleware runs against them too. A catch-all validator (for
+example a `validateSchemas` that requires a JSON body or a specific
+header on every request) will therefore also run against the body-less
+`/ws` handshake requests and reject them. Scope such validators below
+the reserved paths rather than applying them app-wide.
 
 ### `hostname`
 
@@ -528,7 +534,14 @@ const app = createApp(3000, {
 
 ### `ws`
 
-WebSocket tuning and lifecycle hooks:
+WebSocket support is opt-in. Pass `ws: true` to enable with defaults,
+or pass an options object to customize behavior:
+
+```js
+createApp(3000, { ws: true })
+```
+
+With custom tuning and lifecycle hooks:
 
 ```js
 const app = createApp(3000, {
@@ -538,17 +551,21 @@ const app = createApp(3000, {
     reclaimTtl: 300_000,
     ticketTtl: 10_000,
     onOpen: clientId => console.log('connected:', clientId),
-    onClose: (clientId, reason) => console.log('closed:', clientId, reason),
+    onClose: (clientId, signal) => console.log('closed:', clientId, signal),
   },
 })
 ```
 
+When `ws` is omitted (or `false`), no `/ws` endpoints are registered
+and the server does not accept WebSocket upgrades. Calling `app.ws` or
+`req.ws` methods when WebSocket support is disabled throws an error.
+
 - `heartbeatInterval`: how often the client should send heartbeats, in milliseconds. Sent to the client in the welcome message. Defaults to `30_000`.
 - `dropThreshold`: how long the server waits without an inbound message before reaping the connection, in milliseconds. Defaults to `120_000`.
 - `reclaimTtl`: how long an inactive (reaped/dropped) session stays reclaimable, in milliseconds. Defaults to `300_000`.
 - `ticketTtl`: how long a minted upgrade ticket stays valid, in milliseconds. Defaults to `10_000`.
 - `onOpen(clientId)`: fires after a client's welcome message is sent. Wrapped in try/catch so a throwing hook does not break the connection.
-- `onClose(clientId, reason)`: fires when a connection closes. `reason` is a `CloseReason` value: `'ok'`, `'dropped'`, `'reaped'`, or `'superseded'`. Also wrapped in try/catch.
+- `onClose(clientId, signal)`: fires when a connection closes. `signal` is a `CloseSignal` value (`{ code, reason }`). Also wrapped in try/catch.
 
 ## WebSocket Commands
 
@@ -557,7 +574,7 @@ The `app.ws` object exposes four methods for interacting with connected clients:
 - `query(fn)`: return a filtered list of active sessions. The filter function receives `(clientId, data, index)` and returns a boolean. Each entry in the returned array is a `SessionEntry` with `clientId` and `app` (the application context). To list all sessions: `app.ws.query(() => true)`.
 - `send(event, body, fn)`: push a notification to clients matching a filter. The filter function receives `(clientId, data, index)` and returns a boolean. To target one client: `app.ws.send('ping', body, id => id === targetId)`.
 - `broadcast(event, body)`: push a notification to all connected clients.
-- `drop(fn, code?, reason?)`: close connections matching a filter. The filter function receives `(clientId, data, index)` and returns a boolean. The default code is `CloseCode.Ok` (1000), which tells the client not to reconnect. Passing a custom code (e.g. 4000) allows the client to reconnect. To drop one client: `app.ws.drop(id => id === targetId)`.
+- `drop(signal, fn)`: close connections matching a filter. `signal` is a `CloseSignal` (`{ code, reason }`) with `code` validated in the range [4000-4099]. The filter function receives `(clientId, data, index)` and returns a boolean. To drop one client: `app.ws.drop({ code: 4000, reason: 'kicked' }, id => id === targetId)`.
 
 The same commands are available inside endpoint handlers via `req.ws`:
 
@@ -577,8 +594,8 @@ This works from both HTTP and WebSocket transports.
 
 `sleepy-serv` exports several runtime constants and types:
 
-- `CloseCode`: WebSocket close codes: `Ok` (1000), `Abnormal` (1006), `Reaped` (4999)
-- `CloseReason`: close reason values: `Ok`, `Dropped`, `Reaped`, `Superseded`
+- `InternalCloseSignal`: internal close signals: `Ok` (`{ code: 1000, reason: 'ok' }`), `Reaped` (`{ code: 4998, reason: 'reaped' }`), `Superseded` (`{ code: 4999, reason: 'superseded' }`)
+- `CloseSignal`: the type for close signals: `{ code: number, reason: string }`
 - `StatusCode`: the full range of HTTP status codes (1xx through 5xx)
 - `HttpMethod`: HTTP verbs: `Head`, `Get`, `Post`, `Put`, `Patch`, `Delete`
 - `SessionEntry`: the shape returned by `query()`: `{ clientId: string, app: unknown }`

package/dist/core/index.d.ts

@@ -1,9 +1,9 @@
 import type { RouteConfig, SocketCommands, AppOptions, Server } from './utils';
 export * from './errors';
-export { StatusCode, CloseCode, CloseReason, HttpMethod } from './utils';
+export { StatusCode, HttpMethod, InternalCloseSignal, } from './utils';
 export { parseJsonBody, setValidationFormats, validateSchemas, } from './middleware';
 export type { FilterFn, SessionEntry, SocketCommands } from './utils';
-export type { AppOptions, AsyncHandlerResult, BaseRequest, EndpointRequest, FormattedError, Handler, MetaEntry, Middleware, MiddlewareChain, NextFn, HandlerResult, Request, RouteConfig, RouteDefinition, Server, SocketConnection, SocketOptions, WebSocketRequest, } from './utils';
+export type { AppOptions, AsyncHandlerResult, BaseRequest, CloseSignal, EndpointRequest, FormattedError, Handler, MetaEntry, Middleware, MiddlewareChain, NextFn, HandlerResult, Request, RouteConfig, RouteDefinition, Server, SocketConnection, SocketOptions, WebSocketRequest, } from './utils';
 export type { FormatterField, FormatterSchema, ValidationSchemas, } from './middleware';
 type OutputRoutes = Record<string, string[]>;
 type CloseFn = (force?: boolean) => Promise<void>;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAOV,WAAW,EAEX,cAAc,EACd,UAAU,EACV,MAAM,EACP,MAAM,SAAS,CAAA;AAOhB,cAAc,UAAU,CAAA;AACxB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAExE,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,eAAe,GAChB,MAAM,cAAc,CAAA;AAErB,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAErE,YAAY,EACV,UAAU,EACV,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,cAAc,EACd,OAAO,EACP,SAAS,EACT,UAAU,EACV,eAAe,EACf,MAAM,EACN,aAAa,EACb,OAAO,EACP,WAAW,EACX,eAAe,EACf,MAAM,EACN,gBAAgB,EAChB,aAAa,EACb,gBAAgB,GACjB,MAAM,SAAS,CAAA;AAEhB,YAAY,EACV,cAAc,EACd,eAAe,EACf,iBAAiB,GAClB,MAAM,cAAc,CAAA;AAErB,KAAK,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;AA0B5C,KAAK,OAAO,GAAG,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAEjD,MAAM,MAAM,GAAG,GAAG;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,YAAY,CAAA;IACpB,EAAE,EAAE,cAAc,CAAA;IAClB,KAAK,EAAE,OAAO,CAAA;CACf,CAAA;AAgRD,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,EACnB,IAAI,GAAE,UAAe,GACpB,GAAG,CAaL"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAOV,WAAW,EAEX,cAAc,EAEd,UAAU,EACV,MAAM,EACP,MAAM,SAAS,CAAA;AAOhB,cAAc,UAAU,CAAA;AAExB,OAAO,EACL,UAAU,EACV,UAAU,EACV,mBAAmB,GACpB,MAAM,SAAS,CAAA;AAEhB,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,eAAe,GAChB,MAAM,cAAc,CAAA;AAErB,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAErE,YAAY,EACV,UAAU,EACV,kBAAkB,EAClB,WAAW,EACX,WAAW,EACX,eAAe,EACf,cAAc,EACd,OAAO,EACP,SAAS,EACT,UAAU,EACV,eAAe,EACf,MAAM,EACN,aAAa,EACb,OAAO,EACP,WAAW,EACX,eAAe,EACf,MAAM,EACN,gBAAgB,EAChB,aAAa,EACb,gBAAgB,GACjB,MAAM,SAAS,CAAA;AAEhB,YAAY,EACV,cAAc,EACd,eAAe,EACf,iBAAiB,GAClB,MAAM,cAAc,CAAA;AAErB,KAAK,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;AA0B5C,KAAK,OAAO,GAAG,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAEjD,MAAM,MAAM,GAAG,GAAG;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,YAAY,CAAA;IACpB,EAAE,EAAE,cAAc,CAAA;IAClB,KAAK,EAAE,OAAO,CAAA;CACf,CAAA;AAsRD,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,EACnB,IAAI,GAAE,UAAe,GACpB,GAAG,CAqBL"}

package/dist/core/socket.d.ts

@@ -1,6 +1,5 @@
-import { CloseReason } from './utils';
 import type { WebSocketHandler } from 'bun';
-import type { AsyncHandlerResult, HttpMethod, Request, MiddlewareChain, SocketCommands, SocketData, ActiveSession, InactiveSession, AppOptions } from './utils';
+import type { AsyncHandlerResult, CloseSignal, HttpMethod, Request, MiddlewareChain, SocketCommands, SocketData, ActiveSession, InactiveSession, SocketOptions } from './utils';
 type SocketHandler = (req: Request, res: unknown) => AsyncHandlerResult;
 type SocketEndpoint = {
     method: HttpMethod;
@@ -22,7 +21,7 @@ export type SocketState = {
     activeSessions: Map<string, ActiveSession>;
     inactiveSessions: Map<string, InactiveSession>;
     onOpen: ((clientId: string) => void) | null;
-    onClose: ((clientId: string, reason: CloseReason) => void) | null;
+    onClose: ((clientId: string, signal: CloseSignal) => void) | null;
 };
 export type SocketRoute = {
     method: HttpMethod;
@@ -30,9 +29,10 @@ export type SocketRoute = {
     segments: string[];
     chain: MiddlewareChain;
 };
-export declare function buildSocketState(opts?: AppOptions): SocketState;
+export declare function buildSocketState(opts?: SocketOptions): SocketState;
 export declare function buildSocketServer(routes: SocketRoute[], state: SocketState, commands: SocketCommands): WebSocketHandler<SocketData>;
 export declare function buildSocketHandlers(state: SocketState): SocketEndpoint[];
+export declare function buildDisabledSocketCommands(): SocketCommands;
 export declare function buildSocketCommands(state: SocketState): SocketCommands;
 export {};
 //# sourceMappingURL=socket.d.ts.map

package/dist/core/socket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../src/core/socket.ts"],"names":[],"mappings":"AAUA,OAAO,EAGL,WAAW,EAIZ,MAAM,SAAS,CAAA;AAchB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,KAAK,CAAA;AAE3C,OAAO,KAAK,EACV,kBAAkB,EAClB,UAAU,EACV,OAAO,EACP,eAAe,EACf,cAAc,EAGd,UAAU,EAEV,aAAa,EACb,eAAe,EAEf,UAAU,EACX,MAAM,SAAS,CAAA;AAShB,KAAK,aAAa,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,KAAK,kBAAkB,CAAA;AAYvE,KAAK,cAAc,GAAG;IACpB,MAAM,EAAE,UAAU,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,aAAa,CAAA;CACvB,CAAA;AAqBD,MAAM,MAAM,MAAM,GAAG;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,OAAO,CAAA;CACd,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,aAAa,EAAE,MAAM,CAAA;IACrB,iBAAiB,EAAE,MAAM,CAAA;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;IAC1C,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;IAC9C,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,CAAA;IAC3C,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC,GAAG,IAAI,CAAA;CAClE,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,UAAU,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,KAAK,EAAE,eAAe,CAAA;CACvB,CAAA;AAiTD,wBAAgB,gBAAgB,CAAE,IAAI,GAAE,UAAe,GAAG,WAAW,CAapE;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,EAAE,EACrB,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,cAAc,GACvB,gBAAgB,CAAC,UAAU,CAAC,CAoJ9B;AAED,wBAAgB,mBAAmB,CAAE,KAAK,EAAE,WAAW,GAAG,cAAc,EAAE,CAyIzE;AAED,wBAAgB,mBAAmB,CAAE,KAAK,EAAE,WAAW,GAAG,cAAc,CAgEvE"}
+{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../src/core/socket.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,KAAK,CAAA;AAE3C,OAAO,KAAK,EACV,kBAAkB,EAClB,WAAW,EACX,UAAU,EACV,OAAO,EAEP,eAAe,EACf,cAAc,EAGd,UAAU,EAEV,aAAa,EACb,eAAe,EAEf,aAAa,EACd,MAAM,SAAS,CAAA;AAShB,KAAK,aAAa,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,KAAK,kBAAkB,CAAA;AAYvE,KAAK,cAAc,GAAG;IACpB,MAAM,EAAE,UAAU,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,aAAa,CAAA;CACvB,CAAA;AAqBD,MAAM,MAAM,MAAM,GAAG;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,OAAO,CAAA;CACd,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,aAAa,EAAE,MAAM,CAAA;IACrB,iBAAiB,EAAE,MAAM,CAAA;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;IAC1C,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;IAC9C,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,CAAA;IAC3C,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC,GAAG,IAAI,CAAA;CAClE,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,UAAU,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,KAAK,EAAE,eAAe,CAAA;CACvB,CAAA;AA+QD,wBAAgB,gBAAgB,CAAE,IAAI,GAAE,aAAkB,GAAG,WAAW,CAavE;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,EAAE,EACrB,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,cAAc,GACvB,gBAAgB,CAAC,UAAU,CAAC,CA8J9B;AAED,wBAAgB,mBAAmB,CAAE,KAAK,EAAE,WAAW,GAAG,cAAc,EAAE,CAwIzE;AAED,wBAAgB,2BAA2B,IAAK,cAAc,CAS7D;AAED,wBAAgB,mBAAmB,CAAE,KAAK,EAAE,WAAW,GAAG,cAAc,CAwEvE"}

package/dist/core/utils.d.ts

@@ -104,7 +104,7 @@ export type FilterFn = (clientId: string, data: unknown, index: number) => boole
 export type SocketCommands = {
     broadcast: (event: string, body: unknown) => void;
     send: (event: string, body: unknown, fn: FilterFn) => void;
-    drop: (fn: FilterFn, code?: number, reason?: string) => void;
+    drop: (signal: CloseSignal, fn: FilterFn) => void;
     query: (fn: FilterFn) => SessionEntry[];
 };
 export type BaseRequest = {
@@ -125,19 +125,24 @@ export type WebSocketRequest = BaseRequest & {
     clientId: string;
 };
 export type Request = EndpointRequest | WebSocketRequest;
-export declare const CloseCode: {
-    readonly Ok: 1000;
-    readonly Abnormal: 1006;
-    readonly Reaped: 4999;
-};
-export type CloseCode = typeof CloseCode[keyof typeof CloseCode];
-export declare const CloseReason: {
-    readonly Ok: "ok";
-    readonly Dropped: "dropped";
-    readonly Reaped: "reaped";
-    readonly Superseded: "superseded";
-};
-export type CloseReason = typeof CloseReason[keyof typeof CloseReason];
+export type CloseSignal = {
+    code: number;
+    reason: string;
+};
+export declare const InternalCloseSignal: {
+    readonly Ok: {
+        readonly code: 1000;
+        readonly reason: "ok";
+    };
+    readonly Reaped: {
+        readonly code: 4998;
+        readonly reason: "reaped";
+    };
+    readonly Superseded: {
+        readonly code: 4999;
+        readonly reason: "superseded";
+    };
+};
 export type SocketOptions = {
     dropThreshold?: number;
     heartbeatInterval?: number;
@@ -145,7 +150,7 @@ export type SocketOptions = {
     reclaimTtl?: number;
     ticketTtl?: number;
     onOpen?: (clientId: string) => void;
-    onClose?: (clientId: string, reason: CloseReason) => void;
+    onClose?: (clientId: string, signal: CloseSignal) => void;
 };
 export type SocketData = {
     clientId: string;
@@ -177,7 +182,7 @@ export type AppOptions = {
     hostname?: string;
     mountPath?: string;
     middleware?: Middleware[];
-    ws?: SocketOptions;
+    ws?: boolean | SocketOptions;
     onClose?: () => Promise<void> | void;
 };
 export declare function toSegments(pathString: string): string[];

package/dist/core/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/core/utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/core/utils.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -3,7 +3,7 @@
   "description": "A more opinionated web server for building REST-ful applications",
   "author": "Travis J True",
   "license": "MIT",
-  "version": "0.21.0",
+  "version": "0.23.0",
   "type": "module",
   "bin": {
     "sleepy": "./src/cli/index.ts"

package/src/core/index.ts

@@ -13,6 +13,7 @@ import {
   buildSocketServer,
   buildSocketHandlers,
   buildSocketCommands,
+  buildDisabledSocketCommands,
 } from './socket'
 
 import {
@@ -34,6 +35,7 @@ import type {
   RouteConfig,
   RouteDefinition,
   SocketCommands,
+  SocketOptions,
   AppOptions,
   Server,
 } from './utils'
@@ -44,7 +46,12 @@ import type {
 } from './socket'
 
 export * from './errors'
-export { StatusCode, CloseCode, CloseReason, HttpMethod } from './utils'
+
+export {
+  StatusCode,
+  HttpMethod,
+  InternalCloseSignal,
+} from './utils'
 
 export {
   parseJsonBody,
@@ -58,6 +65,7 @@ export type {
   AppOptions,
   AsyncHandlerResult,
   BaseRequest,
+  CloseSignal,
   EndpointRequest,
   FormattedError,
   Handler,
@@ -131,6 +139,20 @@ function defaultMethodMap (): Record<string, EndpointHandler> {
   }
 }
 
+function resolveSocketOptions (
+  ws: boolean | SocketOptions | undefined,
+): SocketOptions | null {
+  if (!ws) {
+    return null
+  }
+
+  if (ws === true) {
+    return {}
+  }
+
+  return ws
+}
+
 function buildEndpointRequest (
   bunReq: BunRequest,
   server: Server,
@@ -162,9 +184,7 @@ function buildEndpointRequest (
   }
 }
 
-function normalizeChain (
-  route: RouteDefinition,
-): ChainRoute {
+function normalizeChain (route: RouteDefinition): ChainRoute {
   const chain = Array.isArray(route.chain)
     ? route.chain
     : [route.chain]
@@ -268,7 +288,7 @@ function buildOutputRoutes (moduleRoutes: ModuleRoute[]): OutputRoutes {
 
 function buildRoutes (
   config: RouteConfig,
-  state: SocketState,
+  state: SocketState | null,
   ws: SocketCommands,
   opts: AppOptions,
 ): AppRoutes {
@@ -294,13 +314,9 @@ function buildRoutes (
     }
   })
 
-  const mergedRoutes = buildMergedRoutes(
-    normalRoutes,
-    middleware,
-    meta,
-    state,
-    mountPath,
-  )
+  const mergedRoutes = state
+    ? buildMergedRoutes(normalRoutes, middleware, meta, state, mountPath)
+    : normalRoutes
 
   const socketRoutes = buildSocketRoutes(mergedRoutes)
   const moduleRoutes = buildModuleRoutes(socketRoutes, ws)
@@ -317,23 +333,21 @@ function buildRoutes (
 function buildServer (
   port: number,
   routes: AppRoutes,
-  state: SocketState,
+  state: SocketState | null,
   ws: SocketCommands,
   opts: AppOptions,
 ): Server {
   const hostname = opts.hostname || '0.0.0.0'
 
-  const websocketServer = buildSocketServer(
-    routes.socket,
-    state,
-    ws,
-  )
+  const websocket = state
+    ? buildSocketServer(routes.socket, state, ws)
+    : undefined
 
   return Bun.serve({
     port,
     hostname,
     routes: routes.server,
-    websocket: websocketServer,
+    ...(websocket ? { websocket } : {}),
     async fetch (_req, _server) {
       throw new NotFoundError()
     },
@@ -346,7 +360,7 @@ function buildServer (
 
       return Response.json(httpError.output, { status })
     },
-  })
+  }) as Server
 }
 
 function processIO (server: Server, opts: AppOptions): CloseFn {
@@ -391,8 +405,16 @@ export function createApp (
   config: RouteConfig,
   opts: AppOptions = {},
 ): App {
-  const state = buildSocketState(opts)
-  const ws = buildSocketCommands(state)
+  const socketOpts = resolveSocketOptions(opts.ws)
+
+  const state = socketOpts
+    ? buildSocketState(socketOpts)
+    : null
+
+  const ws = state
+    ? buildSocketCommands(state)
+    : buildDisabledSocketCommands()
+
   const routes = buildRoutes(config, state, ws, opts)
   const server = buildServer(port, routes, state, ws, opts)
   const close = processIO(server, opts)

package/src/core/socket.ts

@@ -10,8 +10,7 @@ import {
 
 import {
   StatusCode,
-  CloseCode,
-  CloseReason,
+  InternalCloseSignal,
   toSegments,
   formatError,
   executeMiddlewareChain,
@@ -19,7 +18,6 @@ import {
 
 import {
   RequestError,
-  BadRequestError,
   NotFoundError,
   UnauthorizedError,
   MethodNotAllowedError,
@@ -33,8 +31,10 @@ import type { WebSocketHandler } from 'bun'
 
 import type {
   AsyncHandlerResult,
+  CloseSignal,
   HttpMethod,
   Request,
+  FilterFn,
   MiddlewareChain,
   SocketCommands,
   SessionEntry,
@@ -44,7 +44,7 @@ import type {
   ActiveSession,
   InactiveSession,
   Session,
-  AppOptions,
+  SocketOptions,
 } from './utils'
 
 import type {
@@ -107,7 +107,7 @@ export type SocketState = {
   activeSessions: Map<string, ActiveSession>
   inactiveSessions: Map<string, InactiveSession>
   onOpen: ((clientId: string) => void) | null
-  onClose: ((clientId: string, reason: CloseReason) => void) | null
+  onClose: ((clientId: string, signal: CloseSignal) => void) | null
 }
 
 export type SocketRoute = {
@@ -240,30 +240,6 @@ function parseMessage (raw: string | Buffer): RawMessage | undefined {
   }
 }
 
-async function parseJsonBody (req: Request): Promise<unknown> {
-  try {
-    const body = await req.json()
-
-    return body
-  } catch {
-    throw new BadRequestError('Invalid JSON')
-  }
-}
-
-async function parseJsonBodyAppData (req: Request): Promise<unknown> {
-  const contentType = req.headers.get('content-type')
-  const usingJsonBody = contentType?.startsWith('application/json')
-
-  if (!usingJsonBody) {
-    return null
-  }
-
-  const rawBody = await parseJsonBody(req)
-  const appData = (rawBody as Record<string, unknown> | null)?.data ?? null
-
-  return appData
-}
-
 function sweepInactiveSessions (state: SocketState): void {
   for (const [key, session] of state.inactiveSessions) {
     if (!isSessionActive(session)) {
@@ -410,28 +386,18 @@ function buildErrorMessage (
   })
 }
 
-function getCloseReason (ws: SocketConnection, code: number): CloseReason {
-  if (ws.data.reaped) {
-    return CloseReason.Reaped
-  } else if (code === CloseCode.Ok) {
-    return CloseReason.Ok
-  }
-
-  return CloseReason.Dropped
-}
-
-export function buildSocketState (opts: AppOptions = {}): SocketState {
+export function buildSocketState (opts: SocketOptions = {}): SocketState {
   return {
-    dropThreshold: opts.ws?.dropThreshold ?? 120_000,
-    heartbeatInterval: opts.ws?.heartbeatInterval ?? 30_000,
-    maxTickets: opts.ws?.maxTickets ?? 100_000,
-    reclaimTtl: opts.ws?.reclaimTtl ?? 300_000,
-    ticketTtl: opts.ws?.ticketTtl ?? 10_000,
+    dropThreshold: opts.dropThreshold ?? 120_000,
+    heartbeatInterval: opts.heartbeatInterval ?? 30_000,
+    maxTickets: opts.maxTickets ?? 100_000,
+    reclaimTtl: opts.reclaimTtl ?? 300_000,
+    ticketTtl: opts.ticketTtl ?? 10_000,
     tickets: new Map(),
     activeSessions: new Map(),
     inactiveSessions: new Map(),
-    onOpen: opts.ws?.onOpen ?? null,
-    onClose: opts.ws?.onClose ?? null,
+    onOpen: opts.onOpen ?? null,
+    onClose: opts.onClose ?? null,
   }
 }
 
@@ -458,7 +424,10 @@ export function buildSocketServer (
     ws.data.reaperHandle = setTimeout(() => {
       ws.data.reaped = true
 
-      ws.close(CloseCode.Reaped)
+      ws.close(
+        InternalCloseSignal.Reaped.code,
+        InternalCloseSignal.Reaped.reason,
+      )
     }, dropThreshold)
   }
 
@@ -472,10 +441,10 @@ export function buildSocketServer (
     }
   }
 
-  function invokeClose (ws: SocketConnection, reason: CloseReason) {
+  function invokeClose (ws: SocketConnection, signal: CloseSignal) {
     if (onClose) {
       try {
-        onClose(ws.data.clientId, reason)
+        onClose(ws.data.clientId, signal)
       } catch (err) {
         console.error(err)
       }
@@ -492,7 +461,10 @@ export function buildSocketServer (
       if (existingSession) {
         existingSession.ws.data.superseded = true
 
-        existingSession.ws.close()
+        existingSession.ws.close(
+          InternalCloseSignal.Superseded.code,
+          InternalCloseSignal.Superseded.reason,
+        )
       }
 
       inactiveSessions.delete(ws.data.clientId)
@@ -519,18 +491,22 @@ export function buildSocketServer (
       ws.send(JSON.stringify(welcomeMessage))
       invokeOpen(ws)
     },
-    close (ws: SocketConnection, code: number): void {
+    close (ws: SocketConnection, code: number, reason: string): void {
+      const signal: CloseSignal = {
+        code,
+        reason,
+      }
+
       if (ws.data.reaperHandle) {
         clearTimeout(ws.data.reaperHandle)
       }
 
       if (ws.data.superseded) {
-        invokeClose(ws, CloseReason.Superseded)
+        invokeClose(ws, signal)
 
         return
       }
 
-      const reason = getCloseReason(ws, code)
       const exists = activeSessions.get(ws.data.clientId)
 
       if (!exists || exists.ws !== ws) {
@@ -539,7 +515,7 @@ export function buildSocketServer (
 
       activeSessions.delete(ws.data.clientId)
 
-      if (code !== CloseCode.Ok || ws.data.reaped) {
+      if (code !== InternalCloseSignal.Ok.code || ws.data.reaped) {
         inactiveSessions.set(ws.data.clientId, {
           token: exists.token,
           expiresAt: Date.now() + reclaimTtl,
@@ -547,7 +523,7 @@ export function buildSocketServer (
         })
       }
 
-      invokeClose(ws, reason)
+      invokeClose(ws, signal)
     },
     async message (ws: SocketConnection, raw: string | Buffer): Promise<void> {
       const incomingMsg = parseMessage(raw)
@@ -677,8 +653,7 @@ export function buildSocketHandlers (state: SocketState): SocketEndpoint[] {
         validateSchema(req, createTicketValidator)
 
         const clientId = crypto.randomUUID()
-        const appData = await parseJsonBodyAppData(req)
-        const ticket = issueTicket(clientId, appData)
+        const ticket = issueTicket(clientId, res)
 
         return Response.json({
           clientId,
@@ -728,6 +703,17 @@ export function buildSocketHandlers (state: SocketState): SocketEndpoint[] {
   ]
 }
 
+export function buildDisabledSocketCommands (): SocketCommands {
+  const msg = 'WebSocket support is not enabled'
+
+  return {
+    broadcast () { throw new Error(msg) },
+    send () { throw new Error(msg) },
+    drop () { throw new Error(msg) },
+    query () { throw new Error(msg) },
+  }
+}
+
 export function buildSocketCommands (state: SocketState): SocketCommands {
   function sendToClient (clientId: string, event: string, body: unknown) {
     const session = state.activeSessions.get(clientId)
@@ -746,12 +732,12 @@ export function buildSocketCommands (state: SocketState): SocketCommands {
   }
 
   return {
-    broadcast (event, body) {
+    broadcast (event: string, body: unknown) {
       for (const clientId of state.activeSessions.keys()) {
         sendToClient(clientId, event, body)
       }
     },
-    send (event, body, fn) {
+    send (event: string, body: unknown, fn: FilterFn) {
       let index = 0
 
       /* TODO: look into concurrency at some point */
@@ -763,9 +749,17 @@ export function buildSocketCommands (state: SocketState): SocketCommands {
         index += 1
       }
     },
-    drop (fn, code, reason) {
+    drop (signal: CloseSignal, fn: FilterFn) {
+      const { code, reason } = signal
+
       let index = 0
 
+      if (!Number.isInteger(code) || code < 4000 || code > 4099) {
+        throw new RangeError(
+          `Signal code must be an integer in [4000, 4099], got ${code}`,
+        )
+      }
+
       for (const [clientId, session] of state.activeSessions) {
         if (fn(clientId, session.ws.data, index)) {
           session.ws.close(code, reason)
@@ -774,7 +768,7 @@ export function buildSocketCommands (state: SocketState): SocketCommands {
         index += 1
       }
     },
-    query (fn) {
+    query (fn: FilterFn) {
       const results: SessionEntry[] = []
       let index = 0
 

package/src/core/utils.ts

@@ -135,7 +135,7 @@ export type FilterFn = (
 export type SocketCommands = {
   broadcast: (event: string, body: unknown) => void
   send: (event: string, body: unknown, fn: FilterFn) => void
-  drop: (fn: FilterFn, code?: number, reason?: string) => void
+  drop: (signal: CloseSignal, fn: FilterFn) => void
   query: (fn: FilterFn) => SessionEntry[]
 }
 
@@ -161,23 +161,26 @@ export type WebSocketRequest = BaseRequest & {
 
 export type Request = EndpointRequest | WebSocketRequest
 
-export const CloseCode = {
-  Ok: 1000,
-  Abnormal: 1006,
-  Reaped: 4999,
-} as const
-
-export type CloseCode = typeof CloseCode[keyof typeof CloseCode]
+export type CloseSignal = {
+  code: number
+  reason: string
+}
 
-export const CloseReason = {
-  Ok: 'ok',
-  Dropped: 'dropped',
-  Reaped: 'reaped',
-  Superseded: 'superseded',
+export const InternalCloseSignal = {
+  Ok: {
+    code: 1000,
+    reason: 'ok',
+  },
+  Reaped: {
+    code: 4998,
+    reason: 'reaped',
+  },
+  Superseded: {
+    code: 4999,
+    reason: 'superseded',
+  },
 } as const
 
-export type CloseReason = typeof CloseReason[keyof typeof CloseReason]
-
 export type SocketOptions = {
   dropThreshold?: number
   heartbeatInterval?: number
@@ -185,7 +188,7 @@ export type SocketOptions = {
   reclaimTtl?: number
   ticketTtl?: number
   onOpen?: (clientId: string) => void
-  onClose?: (clientId: string, reason: CloseReason) => void
+  onClose?: (clientId: string, signal: CloseSignal) => void
 }
 
 export type SocketData = {
@@ -224,7 +227,7 @@ export type AppOptions = {
   hostname?: string
   mountPath?: string
   middleware?: Middleware[]
-  ws?: SocketOptions
+  ws?: boolean | SocketOptions
   onClose?: () => Promise<void> | void
 }