stitchkit 0.48.1 → 0.49.1

package/dist/server/index.js

@@ -1,9 +1,14 @@
 import {
+  ShutdownOptionsSchema,
+  ShutdownResultSchema,
+  ShutdownStateSchema,
+  ShutdownStatusSchema,
   bindRealtimeServer,
   composeWebSocketHandlers,
   createHandler,
   createImplement,
   createImplementRegistry,
+  createServerLifecycle,
   createSocketIOServer,
   defineMultipartStream,
   implement,
@@ -11,7 +16,7 @@ import {
   parseMultipart,
   socketIoLane,
   webSocketLane
-} from "../index-ts21eyz4.js";
+} from "../index-z992nfbx.js";
 import {
   createAuthHook,
   createBearerResolver,
@@ -67,16 +72,112 @@ import {
 } from "../index-h05ygjqx.js";
 // src/server/bun.ts
 function createServer(config) {
-  const { routes, websocket, development, bun: bunExtra, port = 3000, hostname } = config;
+  const {
+    websocket: configuredWebSocket,
+    socket,
+    development,
+    bun: bunExtra,
+    port = 3000,
+    hostname
+  } = config;
+  const socketRoutePrefix = socket?.route.path.replace(/\*socketPath$/, "");
+  const websocket = configuredWebSocket ?? socket?.websocket;
+  const openSockets = new Set;
+  const socketDrainWaiters = new Set;
+  let hadWebSockets = false;
+  const resolveSocketDrain = () => {
+    if (openSockets.size !== 0)
+      return;
+    for (const resolve of socketDrainWaiters)
+      resolve();
+    socketDrainWaiters.clear();
+  };
+  const waitForSocketDrain = () => {
+    if (openSockets.size === 0)
+      return Promise.resolve();
+    return new Promise((resolve) => socketDrainWaiters.add(resolve));
+  };
+  const trackedWebSocket = websocket ? {
+    ...websocket,
+    open(ws) {
+      hadWebSockets = true;
+      openSockets.add(ws);
+      websocket.open?.(ws);
+    },
+    close(ws, code, reason) {
+      openSockets.delete(ws);
+      resolveSocketDrain();
+      websocket.close?.(ws, code, reason);
+    }
+  } : undefined;
+  let runtime;
+  const requireRuntime = () => {
+    if (!runtime)
+      throw new Error("[stitchkit] Bun server lifecycle started before Bun.serve");
+    return runtime;
+  };
+  const adapter = {
+    beginShutdown: () => socket?.beginShutdown(),
+    pendingRequests: () => runtime?.pendingRequests ?? 0,
+    pendingWebSockets: () => openSockets.size,
+    async closeRealtime() {
+      const logicalClose = socket?.close();
+      for (const ws of openSockets)
+        ws.close(1001, "Server shutting down");
+      await Promise.all([logicalClose, waitForSocketDrain()]);
+    },
+    async stopGracefully() {
+      await new Promise((resolve) => setTimeout(resolve, 0));
+      const server2 = requireRuntime();
+      if (server2.pendingRequests === 0 && openSockets.size === 0) {
+        const stopping = server2.stop(true);
+        if (!hadWebSockets)
+          await stopping;
+        else
+          stopping.catch(() => {
+            return;
+          });
+        return;
+      }
+      await server2.stop(false);
+    },
+    async forceStop() {
+      const logicalClose = socket?.close();
+      const physicalClose = waitForSocketDrain();
+      for (const ws of [...openSockets])
+        ws.terminate();
+      const stopping = requireRuntime().stop(true);
+      if (!hadWebSockets)
+        await stopping;
+      else
+        stopping.catch(() => {
+          return;
+        });
+      await Promise.all([logicalClose, physicalClose]);
+    }
+  };
+  const lifecycle = createServerLifecycle(() => adapter);
   const handler = createHandler(config);
-  const fetch = config.wrapFetch ? config.wrapFetch(handler) : handler;
-  return websocket ? Bun.serve({
+  const consumerFetch = config.wrapFetch ? config.wrapFetch(handler) : handler;
+  const admittedFetch = lifecycle.wrapFetch(consumerFetch);
+  const fetch = async (request, server2) => {
+    if (socket && socketRoutePrefix) {
+      const pathname = new URL(request.url).pathname;
+      if (pathname.startsWith(socketRoutePrefix)) {
+        return await socket.route.handler(request, {
+          params: { socketPath: pathname.slice(socketRoutePrefix.length) },
+          server: server2
+        });
+      }
+    }
+    return admittedFetch(request, server2);
+  };
+  runtime = trackedWebSocket ? Bun.serve({
     ...bunExtra,
-    ...routes && { routes },
     ...development && { development },
     port,
     hostname,
-    websocket,
+    websocket: trackedWebSocket,
     fetch
   }) : Bun.serve({
     ...bunExtra,
@@ -85,6 +186,16 @@ function createServer(config) {
     hostname,
     fetch
   });
+  const server = runtime;
+  return {
+    url: server.url.toString().replace(/\/$/, ""),
+    port: server.port ?? port,
+    runtime: server,
+    get status() {
+      return lifecycle.status;
+    },
+    shutdown: lifecycle.shutdown
+  };
 }
 // src/server/swept-map.ts
 function createSweptMap(options) {
@@ -849,6 +960,10 @@ export {
   bindRealtimeServer,
   badRequest,
   appError,
+  ShutdownStatusSchema,
+  ShutdownStateSchema,
+  ShutdownResultSchema,
+  ShutdownOptionsSchema,
   STITCH_ERROR_STATUS,
   DEFAULT_CORS_EXPOSE_HEADERS,
   DEFAULT_CORS_ALLOW_HEADERS,

package/dist/server/node.d.ts

@@ -1,21 +1,20 @@
 import type { Server as HttpServer } from 'node:http';
+import { serve } from 'srvx/node';
+import { type ManagedServerHandle } from './shutdown';
 import type { FetchComposition, HandlerConfig } from './types';
+export interface NodeSocketLifecycle {
+    attach(server: HttpServer): void;
+    beginShutdown(): void;
+    close(): Promise<void>;
+    connections(): number;
+}
 export interface NodeServerConfig extends HandlerConfig, FetchComposition {
     port?: number;
     hostname?: string;
-    /**
-     * A Socket.IO handle from `createSocketIOServer` — attached to the underlying
-     * `node:http.Server` (srvx `server.node.server`) once it is listening, so
-     * Socket.IO owns the HTTP `upgrade` event on the same port.
-     */
-    socket?: {
-        attach(server: HttpServer): void;
-    };
-}
-export interface NodeServerHandle {
-    url: string;
-    port: number;
-    close(closeActive?: boolean): Promise<void>;
+    /** A full Socket.IO lifecycle from `createSocketIOServer`. */
+    socket?: NodeSocketLifecycle;
 }
+export type NodeRuntimeServer = ReturnType<typeof serve>;
+export type NodeServerHandle = ManagedServerHandle<NodeRuntimeServer>;
 export declare function serveNode(config: NodeServerConfig): Promise<NodeServerHandle>;
 //# sourceMappingURL=node.d.ts.map

package/dist/server/node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/server/node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC;AAGtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE/D,MAAM,WAAW,gBAAiB,SAAQ,aAAa,EAAE,gBAAgB;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAA;KAAE,CAAC;CAC/C;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA8BnF"}
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/server/node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAkB,MAAM,WAAW,CAAC;AAEtE,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAElC,OAAO,EAEL,KAAK,mBAAmB,EAEzB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE/D,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IACjC,aAAa,IAAI,IAAI,CAAC;IACtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,WAAW,IAAI,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAiB,SAAQ,aAAa,EAAE,gBAAgB;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC9B;AAED,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC;AACzD,MAAM,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,iBAAiB,CAAC,CAAC;AAEtE,wBAAsB,SAAS,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAoHnF"}

package/dist/server/shutdown.d.ts

@@ -0,0 +1,77 @@
+import { z } from 'zod';
+import type { FetchHandler } from './types';
+export declare const ShutdownStateSchema: z.ZodEnum<{
+    clean: "clean";
+    "closing-realtime": "closing-realtime";
+    "draining-http": "draining-http";
+    forced: "forced";
+    running: "running";
+    "stopping-runtime": "stopping-runtime";
+}>;
+export type ShutdownState = z.infer<typeof ShutdownStateSchema>;
+export declare const ShutdownOptionsSchema: z.ZodObject<{
+    gracePeriodMs: z.ZodDefault<z.ZodNumber>;
+    forceTimeoutMs: z.ZodDefault<z.ZodNumber>;
+    retryAfterSeconds: z.ZodDefault<z.ZodNumber>;
+    signal: z.ZodOptional<z.ZodCustom<AbortSignal, AbortSignal>>;
+}, z.core.$strip>;
+export type ShutdownOptions = z.input<typeof ShutdownOptionsSchema>;
+export declare const ShutdownStatusSchema: z.ZodObject<{
+    state: z.ZodEnum<{
+        clean: "clean";
+        "closing-realtime": "closing-realtime";
+        "draining-http": "draining-http";
+        forced: "forced";
+        running: "running";
+        "stopping-runtime": "stopping-runtime";
+    }>;
+    acceptedRequests: z.ZodNumber;
+    completedRequests: z.ZodNumber;
+    pendingRequests: z.ZodNumber;
+    pendingWebSockets: z.ZodNumber;
+}, z.core.$strip>;
+export type ShutdownStatus = z.infer<typeof ShutdownStatusSchema>;
+export declare const ShutdownResultSchema: z.ZodObject<{
+    outcome: z.ZodEnum<{
+        clean: "clean";
+        forced: "forced";
+    }>;
+    reason: z.ZodOptional<z.ZodEnum<{
+        deadline: "deadline";
+        signal: "signal";
+    }>>;
+    acceptedRequests: z.ZodNumber;
+    completedRequests: z.ZodNumber;
+    pendingRequests: z.ZodNumber;
+    pendingWebSockets: z.ZodNumber;
+    pendingRequestsAtForce: z.ZodNumber;
+    pendingWebSocketsAtForce: z.ZodNumber;
+    abortedRequests: z.ZodNumber;
+    forcedWebSockets: z.ZodNumber;
+    durationMs: z.ZodNumber;
+}, z.core.$strip>;
+export type ShutdownResult = z.infer<typeof ShutdownResultSchema>;
+/** Shared lifecycle shape; only the explicit runtime escape hatch varies. */
+export interface ManagedServerHandle<TRuntime> {
+    readonly url: string;
+    readonly port: number;
+    readonly runtime: TRuntime;
+    readonly status: ShutdownStatus;
+    shutdown(options?: ShutdownOptions): Promise<ShutdownResult>;
+}
+export interface ShutdownAdapter {
+    beginShutdown(retryAfterSeconds: number): void;
+    pendingRequests(): number;
+    pendingWebSockets(): number;
+    closeRealtime(): Promise<void>;
+    stopGracefully(): Promise<void>;
+    forceStop(): Promise<void>;
+}
+interface ServerLifecycle {
+    wrapFetch<TServer>(handler: FetchHandler<TServer>): FetchHandler<TServer>;
+    readonly status: ShutdownStatus;
+    shutdown(options?: ShutdownOptions): Promise<ShutdownResult>;
+}
+export declare function createServerLifecycle(getAdapter: () => ShutdownAdapter): ServerLifecycle;
+export {};
+//# sourceMappingURL=shutdown.d.ts.map

package/dist/server/shutdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.d.ts","sourceRoot":"","sources":["../../src/server/shutdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,eAAO,MAAM,mBAAmB;;;;;;;EAO9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,qBAAqB;;;;;iBAchC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;iBAM/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;iBAY/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,6EAA6E;AAC7E,MAAM,WAAW,mBAAmB,CAAC,QAAQ;IAC3C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAC9D;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/C,eAAe,IAAI,MAAM,CAAC;IAC1B,iBAAiB,IAAI,MAAM,CAAC;IAC5B,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,UAAU,eAAe;IACvB,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IAC1E,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAC9D;AAqDD,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,eAAe,GAAG,eAAe,CAiJxF"}

package/dist/server/socket-io-config.d.ts

@@ -1,5 +1,7 @@
 /** Runtime-neutral Socket.IO configuration shared by Bun and Node adapters. */
 import type { ServerOptions } from 'socket.io';
+/** Runtime-neutral Engine.IO handshake policy, evaluated before shutdown admission. */
+export type SocketIORequestPolicy = (request: Request) => boolean | Promise<boolean>;
 export interface SocketIOServerConfig {
     /** CORS — the browser origin(s) allowed to open a socket. */
     cors: {
@@ -14,7 +16,9 @@ export interface SocketIOServerConfig {
     pingTimeout?: number;
     /** Heartbeat: ms between pings. */
     pingInterval?: number;
+    /** Runtime-neutral policy for accepting a new Engine.IO handshake. */
+    allowRequest?: SocketIORequestPolicy;
     /** Typed Socket.IO options not owned by this wrapper. */
-    serverOptions?: Partial<ServerOptions>;
+    serverOptions?: Omit<Partial<ServerOptions>, 'allowRequest'>;
 }
 //# sourceMappingURL=socket-io-config.d.ts.map

package/dist/server/socket-io-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"socket-io-config.d.ts","sourceRoot":"","sources":["../../src/server/socket-io-config.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,MAAM,WAAW,oBAAoB;IACnC,6DAA6D;IAC7D,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3D,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,UAAU,CAAC,EAAE,KAAK,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;IAC5C,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,aAAa,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CACxC"}
+{"version":3,"file":"socket-io-config.d.ts","sourceRoot":"","sources":["../../src/server/socket-io-config.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,uFAAuF;AACvF,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAErF,MAAM,WAAW,oBAAoB;IACnC,6DAA6D;IAC7D,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3D,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,UAAU,CAAC,EAAE,KAAK,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;IAC5C,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,YAAY,CAAC,EAAE,qBAAqB,CAAC;IACrC,yDAAyD;IACzD,aAAa,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,cAAc,CAAC,CAAC;CAC9D"}

package/dist/server/socket-io-node.d.ts

@@ -3,11 +3,14 @@ import type { Server as HttpServer } from 'node:http';
 import type { Server as SocketIOServer } from 'socket.io';
 import type { SocketEventMap } from '../browser/socket-io';
 import type { SocketIOServerConfig } from './socket-io-config';
-export type { SocketIOServerConfig } from './socket-io-config';
+export type { SocketIORequestPolicy, SocketIOServerConfig } from './socket-io-config';
 /** The runtime-neutral part of a Socket.IO handle used by `serveNode`. */
 export interface NodeSocketIOServerHandle<TServerEvents extends SocketEventMap, TClientEvents extends SocketEventMap> {
     io: SocketIOServer<TClientEvents, TServerEvents>;
     attach(server: HttpServer): void;
+    beginShutdown(): void;
+    close(): Promise<void>;
+    connections(): number;
 }
 /** Create a Socket.IO handle typed only for the Node capabilities it exposes. */
 export declare function createNodeSocketIOServer<TServerEvents extends SocketEventMap, TClientEvents extends SocketEventMap>(config: SocketIOServerConfig): Promise<NodeSocketIOServerHandle<TServerEvents, TClientEvents>>;

package/dist/server/socket-io-node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"socket-io-node.d.ts","sourceRoot":"","sources":["../../src/server/socket-io-node.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,0EAA0E;AAC1E,MAAM,WAAW,wBAAwB,CACvC,aAAa,SAAS,cAAc,EACpC,aAAa,SAAS,cAAc;IAEpC,EAAE,EAAE,cAAc,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;IACjD,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;CAClC;AAED,iFAAiF;AACjF,wBAAsB,wBAAwB,CAC5C,aAAa,SAAS,cAAc,EACpC,aAAa,SAAS,cAAc,EAEpC,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,wBAAwB,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC,CAEjE"}
+{"version":3,"file":"socket-io-node.d.ts","sourceRoot":"","sources":["../../src/server/socket-io-node.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAEtF,0EAA0E;AAC1E,MAAM,WAAW,wBAAwB,CACvC,aAAa,SAAS,cAAc,EACpC,aAAa,SAAS,cAAc;IAEpC,EAAE,EAAE,cAAc,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;IACjD,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IACjC,aAAa,IAAI,IAAI,CAAC;IACtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,WAAW,IAAI,MAAM,CAAC;CACvB;AAED,iFAAiF;AACjF,wBAAsB,wBAAwB,CAC5C,aAAa,SAAS,cAAc,EACpC,aAAa,SAAS,cAAc,EAEpC,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,wBAAwB,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC,CAEjE"}

package/dist/server/socket-io.d.ts

@@ -23,10 +23,8 @@ import type { BunServer } from './bun';
 import type { SocketIOServerConfig } from './socket-io-config';
 import type { RawRoute } from './types';
 import { type ComposedLane } from './websocket';
-export type { SocketIOServerConfig } from './socket-io-config';
-export interface SocketIOServerHandle<TServerEvents extends SocketEventMap, TClientEvents extends SocketEventMap> {
-    /** The typed Socket.IO server — attach `io.on('connection', ...)` handlers. */
-    io: SocketIOServer<TClientEvents, TServerEvents>;
+export type { SocketIORequestPolicy, SocketIOServerConfig } from './socket-io-config';
+export interface SocketIOServerLifecycle {
     /**
      * WebSocket handler for `Bun.serve({ websocket })`. Real on Bun; on Node it is
      * an inert no-op — sockets there are driven by the `node:http.Server`
@@ -47,6 +45,16 @@ export interface SocketIOServerHandle<TServerEvents extends SocketEventMap, TCli
      * `serveNode({ socket })` calls this for you.
      */
     attach(server: HttpServer): void;
+    /** Stop admitting new Engine.IO handshakes. Called by the managed server. */
+    beginShutdown(): void;
+    /** Idempotently close namespaces, adapters and the bound transport engine. */
+    close(): Promise<void>;
+    /** Current Engine.IO client count, when the engine has been bound. */
+    connections(): number;
+}
+export interface SocketIOServerHandle<TServerEvents extends SocketEventMap, TClientEvents extends SocketEventMap> extends SocketIOServerLifecycle {
+    /** The typed Socket.IO server — attach `io.on('connection', ...)` handlers. */
+    io: SocketIOServer<TClientEvents, TServerEvents>;
 }
 export declare function createSocketIOServer<TServerEvents extends SocketEventMap, TClientEvents extends SocketEventMap>(config: SocketIOServerConfig): Promise<SocketIOServerHandle<TServerEvents, TClientEvents>>;
 /**

package/dist/server/socket-io.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"socket-io.d.ts","sourceRoot":"","sources":["../../src/server/socket-io.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,KAAK,EACV,MAAM,IAAI,SAAS,EAEpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,KAAK,YAAY,EAAiB,MAAM,aAAa,CAAC;AAE/D,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,MAAM,WAAW,oBAAoB,CACnC,aAAa,SAAS,cAAc,EACpC,aAAa,SAAS,cAAc;IAEpC,+EAA+E;IAC/E,EAAE,EAAE,cAAc,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;IACjD;;;;;OAKG;IACH,SAAS,EAAE,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IACzD;;;;;OAKG;IACH,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC3B;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;CAClC;AAuCD,wBAAsB,oBAAoB,CACxC,aAAa,SAAS,cAAc,EACpC,aAAa,SAAS,cAAc,EACpC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC,CAuF3F;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,oBAAoB,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC,WAAW,CAAC,GAC3E,YAAY,CAMd"}
+{"version":3,"file":"socket-io.d.ts","sourceRoot":"","sources":["../../src/server/socket-io.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,KAAK,EACV,MAAM,IAAI,SAAS,EAEpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EACV,MAAM,IAAI,cAAc,EAEzB,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,KAAK,YAAY,EAAiB,MAAM,aAAa,CAAC;AAE/D,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAEtF,MAAM,WAAW,uBAAuB;IACtC;;;;;OAKG;IACH,SAAS,EAAE,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IACzD;;;;;OAKG;IACH,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC3B;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IACjC,6EAA6E;IAC7E,aAAa,IAAI,IAAI,CAAC;IACtB,8EAA8E;IAC9E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,sEAAsE;IACtE,WAAW,IAAI,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB,CACnC,aAAa,SAAS,cAAc,EACpC,aAAa,SAAS,cAAc,CACpC,SAAQ,uBAAuB;IAC/B,+EAA+E;IAC/E,EAAE,EAAE,cAAc,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;CAClD;AAuCD,wBAAsB,oBAAoB,CACxC,aAAa,SAAS,cAAc,EACpC,aAAa,SAAS,cAAc,EACpC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC,CAyI3F;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,oBAAoB,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC,WAAW,CAAC,GAC3E,YAAY,CAMd"}

package/dist/server/websocket.d.ts

@@ -66,7 +66,7 @@ export declare function webSocketLane<TData>(lane: WebSocketLane<TData>): Compos
  *   [webSocketLane({ match: isPcmSocket, handlers: pcmHandlers }), socketIoLane(socket.websocket)],
  *   { maxPayloadLength: 16 * 1024 * 1024 },
  * )
- * createServer({ websocket: ws, rawRoutes: [socket.route, pcmUpgradeRoute] })
+ * createServer({ socket, websocket: ws, rawRoutes: [pcmUpgradeRoute] })
  * ```
  */
 export declare function composeWebSocketHandlers(lanes: ComposedLane[], config?: WebSocketComposeConfig): WebSocketHandler<unknown>;