stitchkit 0.52.0 → 0.53.1

package/dist/server/index.js

@@ -12,7 +12,7 @@ import {
   parseMultipart,
   socketIoLane,
   webSocketLane
-} from "../index-d6jj3cp5.js";
+} from "../index-pdv1mjjr.js";
 import {
   createAuthHook,
   createBearerResolver,
@@ -24,7 +24,7 @@ import {
   signJwt,
   verifyJwt,
   verifyPkce
-} from "../index-tw7mhqgy.js";
+} from "../index-yez419px.js";
 import {
   DEFAULT_CORS_ALLOW_HEADERS,
   DEFAULT_CORS_EXPOSE_HEADERS,
@@ -38,7 +38,7 @@ import {
   defineMultipartStream,
   implement,
   implementRegistry
-} from "../index-drsnz8gw.js";
+} from "../index-yydqk4fh.js";
 import {
   isWithinDir,
   jsonSchemaFields,
@@ -69,12 +69,45 @@ import {
   resolveTraceId,
   unauthorized,
   zodIssues
-} from "../index-8qghvg18.js";
+} from "../index-173tvqcp.js";
 import {
   isRecord,
   parseTrailingWildcard
 } from "../index-bmnhqtya.js";
 // src/server/bun.ts
+import { chmodSync, statSync, unlinkSync } from "node:fs";
+function reclaimStaleUnixSocket(path) {
+  const stats = statSync(path, { throwIfNoEntry: false });
+  if (stats === undefined)
+    return;
+  if (!stats.isSocket()) {
+    throw new Error(`[stitchkit] createServer: "${path}" exists and is not a socket — refusing to remove it`);
+  }
+  if (typeof process.getuid === "function" && stats.uid !== process.getuid()) {
+    throw new Error(`[stitchkit] createServer: unix socket "${path}" is owned by another user — refusing to reclaim it`);
+  }
+  const standalone = Bun.main.startsWith("/$bunfs/");
+  const interpreter = standalone ? Bun.which("bun") : process.execPath;
+  if (!interpreter) {
+    throw new Error(`[stitchkit] createServer: unix socket "${path}" already exists and no \`bun\` binary is on PATH to probe it from this compiled executable — remove the file manually if the previous process is dead`);
+  }
+  const probe = Bun.spawnSync({
+    cmd: [
+      interpreter,
+      "-e",
+      'try { const socket = await Bun.connect({ unix: Bun.env.STITCHKIT_UNIX_PROBE ?? "", socket: { data() { return undefined; } } }); socket.end(); process.exit(0); } catch (error) { process.exit(error && typeof error === "object" && "code" in error && error.code === "EACCES" ? 2 : 1); }'
+    ],
+    env: { ...process.env, STITCHKIT_UNIX_PROBE: path },
+    timeout: 2000
+  });
+  if (probe.exitedDueToTimeout) {
+    throw new Error(`[stitchkit] createServer: liveness probe for unix socket "${path}" timed out — refusing to reclaim; remove the file manually if the previous process is dead`);
+  }
+  if (probe.exitCode === 0 || probe.exitCode === 2) {
+    throw new Error(`[stitchkit] createServer: unix socket "${path}" is already in use${probe.exitCode === 2 ? " (connect permission denied)" : " by a live listener"}`);
+  }
+  unlinkSync(path);
+}
 function createServer(config) {
   const {
     websocket: configuredWebSocket,
@@ -84,6 +117,19 @@ function createServer(config) {
     port = 3000,
     hostname
   } = config;
+  const unixPath = typeof config.unix === "string" ? config.unix : config.unix?.path;
+  const unixMode = typeof config.unix === "string" ? undefined : config.unix?.mode;
+  if (unixPath !== undefined) {
+    if (unixPath.length === 0) {
+      throw new Error("[stitchkit] createServer: `unix` must be a non-empty socket path");
+    }
+    if (config.port !== undefined || config.hostname !== undefined) {
+      throw new Error("[stitchkit] createServer: `unix` is mutually exclusive with `port`/`hostname`");
+    }
+    if (socket) {
+      throw new Error("[stitchkit] createServer: the Socket.IO lifecycle cannot listen on a unix socket — socket.io clients dial TCP only");
+    }
+  }
   const socketRoutePrefix = socket?.route.path.replace(/\*socketPath$/, "");
   const websocket = configuredWebSocket ?? socket?.websocket;
   const openSockets = new Set;
@@ -176,24 +222,43 @@ function createServer(config) {
     }
     return admittedFetch(request, server2);
   };
-  runtime = trackedWebSocket ? Bun.serve({
-    ...bunExtra,
-    ...development && { development },
-    port,
-    hostname,
-    websocket: trackedWebSocket,
-    fetch
-  }) : Bun.serve({
-    ...bunExtra,
-    ...development && { development },
-    port,
-    hostname,
-    fetch
-  });
+  if (unixPath !== undefined) {
+    reclaimStaleUnixSocket(unixPath);
+    const { reusePort, ipv6Only, http3, http1, idleTimeout, ...unixExtra } = bunExtra ?? {};
+    runtime = trackedWebSocket ? Bun.serve({
+      ...unixExtra,
+      ...development && { development },
+      unix: unixPath,
+      websocket: trackedWebSocket,
+      fetch
+    }) : Bun.serve({
+      ...unixExtra,
+      ...development && { development },
+      unix: unixPath,
+      fetch
+    });
+    if (unixMode !== undefined)
+      chmodSync(unixPath, unixMode);
+  } else {
+    runtime = trackedWebSocket ? Bun.serve({
+      ...bunExtra,
+      ...development && { development },
+      port,
+      hostname,
+      websocket: trackedWebSocket,
+      fetch
+    }) : Bun.serve({
+      ...bunExtra,
+      ...development && { development },
+      port,
+      hostname,
+      fetch
+    });
+  }
   const server = runtime;
   return {
     url: server.url.toString().replace(/\/$/, ""),
-    port: server.port ?? port,
+    port: server.port ?? (unixPath !== undefined ? 0 : port),
     runtime: server,
     get status() {
       return lifecycle.status;

package/dist/server/realtime.d.ts

@@ -1,24 +1,28 @@
-import type { Socket, Server as SocketIOServer } from 'socket.io';
+import type { DefaultEventsMap, Socket, Server as SocketIOServer } from 'socket.io';
 import type { SocketEventMap } from '../browser/socket-io';
 import type { StitchLogger } from '../logger';
 import type { RealtimeContract, RealtimeEventRegistry, RealtimeRejectedEventHook } from '../realtime/contract';
 import { type ValidatedRealtimeSocket } from '../realtime/socket';
-export interface RealtimeServerConnection<TServerToClient extends RealtimeEventRegistry, TClientToServer extends RealtimeEventRegistry> {
-    /** Raw Socket.IO socket for handshake auth, rooms and application-owned delivery policy. */
-    raw: Socket;
+export interface RealtimeServerConnection<TServerToClient extends RealtimeEventRegistry, TClientToServer extends RealtimeEventRegistry, TData = any> {
+    /**
+     * Raw Socket.IO socket for rooms and application-owned delivery policy.
+     * `raw.data` carries the typed handshake identity when the server was
+     * created with a `handshake` gate.
+     */
+    raw: Socket<SocketEventMap, SocketEventMap, DefaultEventsMap, TData>;
     events: ValidatedRealtimeSocket<TClientToServer, TServerToClient>;
     to(room: string): Pick<ValidatedRealtimeSocket<RealtimeEventRegistry, TServerToClient>, 'emit'>;
 }
-export interface RealtimeServer<TServerToClient extends RealtimeEventRegistry, TClientToServer extends RealtimeEventRegistry> {
-    onConnection(handler: (connection: RealtimeServerConnection<TServerToClient, TClientToServer>) => void | Promise<void>): () => void;
+export interface RealtimeServer<TServerToClient extends RealtimeEventRegistry, TClientToServer extends RealtimeEventRegistry, TData = any> {
+    onConnection(handler: (connection: RealtimeServerConnection<TServerToClient, TClientToServer, TData>) => void | Promise<void>): () => void;
     emit: ValidatedRealtimeSocket<RealtimeEventRegistry, TServerToClient>['emit'];
     to(room: string): Pick<ValidatedRealtimeSocket<RealtimeEventRegistry, TServerToClient>, 'emit'>;
 }
-export interface RealtimeServerHandle {
-    io: SocketIOServer<SocketEventMap, SocketEventMap>;
+export interface RealtimeServerHandle<TData = any> {
+    io: SocketIOServer<SocketEventMap, SocketEventMap, DefaultEventsMap, TData>;
 }
-export declare function bindRealtimeServer<const TServerToClient extends RealtimeEventRegistry, const TClientToServer extends RealtimeEventRegistry>(contract: RealtimeContract<TServerToClient, TClientToServer>, handle: RealtimeServerHandle, options?: {
+export declare function bindRealtimeServer<const TServerToClient extends RealtimeEventRegistry, const TClientToServer extends RealtimeEventRegistry, TData = any>(contract: RealtimeContract<TServerToClient, TClientToServer>, handle: RealtimeServerHandle<TData>, options?: {
     onRejected?: RealtimeRejectedEventHook;
     logger?: StitchLogger;
-}): RealtimeServer<TServerToClient, TClientToServer>;
+}): RealtimeServer<TServerToClient, TClientToServer, TData>;
 //# sourceMappingURL=realtime.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"realtime.d.ts","sourceRoot":"","sources":["../../src/server/realtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,WAAW,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EACV,gBAAgB,EAChB,qBAAqB,EACrB,yBAAyB,EAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,wBAAwB,CACvC,eAAe,SAAS,qBAAqB,EAC7C,eAAe,SAAS,qBAAqB;IAE7C,4FAA4F;IAC5F,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,uBAAuB,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC;IAClE,EAAE,CACA,IAAI,EAAE,MAAM,GACX,IAAI,CAAC,uBAAuB,CAAC,qBAAqB,EAAE,eAAe,CAAC,EAAE,MAAM,CAAC,CAAC;CAClF;AAED,MAAM,WAAW,cAAc,CAC7B,eAAe,SAAS,qBAAqB,EAC7C,eAAe,SAAS,qBAAqB;IAE7C,YAAY,CACV,OAAO,EAAE,CACP,UAAU,EAAE,wBAAwB,CAAC,eAAe,EAAE,eAAe,CAAC,KACnE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACxB,MAAM,IAAI,CAAC;IACd,IAAI,EAAE,uBAAuB,CAAC,qBAAqB,EAAE,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;IAC9E,EAAE,CACA,IAAI,EAAE,MAAM,GACX,IAAI,CAAC,uBAAuB,CAAC,qBAAqB,EAAE,eAAe,CAAC,EAAE,MAAM,CAAC,CAAC;CAClF;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,cAAc,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;CACpD;AAED,wBAAgB,kBAAkB,CAChC,KAAK,CAAC,eAAe,SAAS,qBAAqB,EACnD,KAAK,CAAC,eAAe,SAAS,qBAAqB,EAEnD,QAAQ,EAAE,gBAAgB,CAAC,eAAe,EAAE,eAAe,CAAC,EAC5D,MAAM,EAAE,oBAAoB,EAC5B,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,yBAAyB,CAAC;IAAC,MAAM,CAAC,EAAE,YAAY,CAAA;CAAO,GAC9E,cAAc,CAAC,eAAe,EAAE,eAAe,CAAC,CAsClD"}
+{"version":3,"file":"realtime.d.ts","sourceRoot":"","sources":["../../src/server/realtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,WAAW,CAAC;AACpF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EACV,gBAAgB,EAChB,qBAAqB,EACrB,yBAAyB,EAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,wBAAwB,CACvC,eAAe,SAAS,qBAAqB,EAC7C,eAAe,SAAS,qBAAqB,EAC7C,KAAK,GAAG,GAAG;IAEX;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAC,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAC;IACrE,MAAM,EAAE,uBAAuB,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC;IAClE,EAAE,CACA,IAAI,EAAE,MAAM,GACX,IAAI,CAAC,uBAAuB,CAAC,qBAAqB,EAAE,eAAe,CAAC,EAAE,MAAM,CAAC,CAAC;CAClF;AAED,MAAM,WAAW,cAAc,CAC7B,eAAe,SAAS,qBAAqB,EAC7C,eAAe,SAAS,qBAAqB,EAC7C,KAAK,GAAG,GAAG;IAEX,YAAY,CACV,OAAO,EAAE,CACP,UAAU,EAAE,wBAAwB,CAAC,eAAe,EAAE,eAAe,EAAE,KAAK,CAAC,KAC1E,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACxB,MAAM,IAAI,CAAC;IACd,IAAI,EAAE,uBAAuB,CAAC,qBAAqB,EAAE,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;IAC9E,EAAE,CACA,IAAI,EAAE,MAAM,GACX,IAAI,CAAC,uBAAuB,CAAC,qBAAqB,EAAE,eAAe,CAAC,EAAE,MAAM,CAAC,CAAC;CAClF;AAED,MAAM,WAAW,oBAAoB,CAAC,KAAK,GAAG,GAAG;IAC/C,EAAE,EAAE,cAAc,CAAC,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAC;CAC7E;AAED,wBAAgB,kBAAkB,CAChC,KAAK,CAAC,eAAe,SAAS,qBAAqB,EACnD,KAAK,CAAC,eAAe,SAAS,qBAAqB,EACnD,KAAK,GAAG,GAAG,EAEX,QAAQ,EAAE,gBAAgB,CAAC,eAAe,EAAE,eAAe,CAAC,EAC5D,MAAM,EAAE,oBAAoB,CAAC,KAAK,CAAC,EACnC,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,yBAAyB,CAAC;IAAC,MAAM,CAAC,EAAE,YAAY,CAAA;CAAO,GAC9E,cAAc,CAAC,eAAe,EAAE,eAAe,EAAE,KAAK,CAAC,CAwCzD"}

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

@@ -1,8 +1,42 @@
 /** Runtime-neutral Socket.IO configuration shared by Bun and Node adapters. */
-import type { ServerOptions } from 'socket.io';
+import type { ServerOptions, Socket } from 'socket.io';
+import type { z } from 'zod';
 /** Runtime-neutral Engine.IO handshake policy, evaluated before shutdown admission. */
 export type SocketIORequestPolicy = (request: Request) => boolean | Promise<boolean>;
-export interface SocketIOServerConfig {
+/**
+ * Typed identity gate for the Socket.IO handshake. `schema` validates
+ * `socket.handshake.auth` (the structured channel — `query` values are strings
+ * on the wire); an optional `verify` turns the parsed payload into the
+ * connection identity. Returning `null` or throwing rejects the handshake
+ * **before** the connection handler and before any event validation; the
+ * accepted identity is written to `socket.data`, typed end-to-end through
+ * `createSocketIOServer` and `bindRealtimeServer`.
+ *
+ * A rejected handshake is terminal for socket.io-client — it does **not**
+ * retry (unlike a transport-level denial). The stitchkit client surfaces it
+ * via `onConnectError` with `terminal: true`; recovery is an explicit
+ * `connect()`, which re-reads a function-form `auth`.
+ */
+export interface SocketIOHandshakeConfig<TParsed, TData = TParsed> {
+    /** Zod schema for `socket.handshake.auth`. */
+    schema: z.ZodType<TParsed>;
+    /**
+     * Turn the schema-validated payload into the connection identity (may be
+     * async — the wrapper awaits it safely; socket.io itself would leak an
+     * unhandled rejection from a raw async middleware). Return `null` or throw
+     * to reject; a thrown error is logged server-side and the peer sees only
+     * the generic `handshake rejected` — raw error text never crosses to an
+     * unauthenticated client. When omitted, the parsed payload itself is the
+     * identity (when passing `TData` explicitly with `TData ≠ TParsed`,
+     * `verify` is therefore mandatory — without it the runtime stores the
+     * schema output). The `schema` must be synchronous (no async
+     * refine/transform).
+     */
+    verify?: (parsed: TParsed, context: {
+        handshake: Socket['handshake'];
+    }) => TData | null | Promise<TData | null>;
+}
+export interface SocketIOServerConfig<TParsed = any, TData = TParsed> {
     /** CORS — the browser origin(s) allowed to open a socket. */
     cors: {
         origin: string | string[];
@@ -18,6 +52,15 @@ export interface SocketIOServerConfig {
     pingInterval?: number;
     /** Runtime-neutral policy for accepting a new Engine.IO handshake. */
     allowRequest?: SocketIORequestPolicy;
+    /**
+     * Typed identity gate — Zod-validate the handshake and put the result into
+     * `socket.data`. Registered as the **first** `io.use()` middleware, so app
+     * middlewares added later see the typed identity already in place. Type
+     * inference works on calls without explicit event generics (the
+     * `bindRealtimeServer` lane); with explicit generics, pass the identity
+     * types explicitly: `createSocketIOServer<S, C, Parsed, Data>`.
+     */
+    handshake?: SocketIOHandshakeConfig<TParsed, TData>;
     /** Typed Socket.IO options not owned by this wrapper. */
     serverOptions?: Omit<Partial<ServerOptions>, 'allowRequest'>;
 }

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,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"}
+{"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,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,uFAAuF;AACvF,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAErF;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,uBAAuB,CAAC,OAAO,EAAE,KAAK,GAAG,OAAO;IAC/D,8CAA8C;IAC9C,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,EAAE,CACP,MAAM,EAAE,OAAO,EACf,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,CAAA;KAAE,KACxC,KAAK,GAAG,IAAI,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,oBAAoB,CAAC,OAAO,GAAG,GAAG,EAAE,KAAK,GAAG,OAAO;IAClE,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;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,uBAAuB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACpD,yDAAyD;IACzD,aAAa,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,cAAc,CAAC,CAAC;CAC9D"}

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

@@ -1,17 +1,17 @@
 /** Node-facing Socket.IO surface without Bun engine declarations. */
 import type { Server as HttpServer } from 'node:http';
-import type { Server as SocketIOServer } from 'socket.io';
+import type { DefaultEventsMap, Server as SocketIOServer } from 'socket.io';
 import type { SocketEventMap } from '../browser/socket-io';
 import type { SocketIOServerConfig } from './socket-io-config';
-export type { SocketIORequestPolicy, SocketIOServerConfig } from './socket-io-config';
+export type { SocketIOHandshakeConfig, 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>;
+export interface NodeSocketIOServerHandle<TServerEvents extends SocketEventMap, TClientEvents extends SocketEventMap, TData = any> {
+    io: SocketIOServer<TClientEvents, TServerEvents, DefaultEventsMap, TData>;
     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>>;
+export declare function createNodeSocketIOServer<TServerEvents extends SocketEventMap, TClientEvents extends SocketEventMap, TParsed = any, TData = TParsed>(config: SocketIOServerConfig<TParsed, TData>): Promise<NodeSocketIOServerHandle<TServerEvents, TClientEvents, TData>>;
 //# sourceMappingURL=socket-io-node.d.ts.map

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,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"}
+{"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,gBAAgB,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,WAAW,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,YAAY,EACV,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAE5B,0EAA0E;AAC1E,MAAM,WAAW,wBAAwB,CACvC,aAAa,SAAS,cAAc,EACpC,aAAa,SAAS,cAAc,EACpC,KAAK,GAAG,GAAG;IAEX,EAAE,EAAE,cAAc,CAAC,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAC;IAC1E,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,EAGpC,OAAO,GAAG,GAAG,EACb,KAAK,GAAG,OAAO,EAEf,MAAM,EAAE,oBAAoB,CAAC,OAAO,EAAE,KAAK,CAAC,GAC3C,OAAO,CAAC,wBAAwB,CAAC,aAAa,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC,CAExE"}

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

@@ -17,13 +17,13 @@
  */
 import type { Server as HttpServer } from 'node:http';
 import type { Server as BunEngine } from '@socket.io/bun-engine';
-import type { Server as SocketIOServer } from 'socket.io';
+import type { DefaultEventsMap, Server as SocketIOServer } from 'socket.io';
 import type { SocketEventMap } from '../browser/socket-io';
 import type { BunServer } from './bun';
 import type { SocketIOServerConfig } from './socket-io-config';
 import type { RawRoute } from './types';
 import { type ComposedLane } from './websocket';
-export type { SocketIORequestPolicy, SocketIOServerConfig } from './socket-io-config';
+export type { SocketIOHandshakeConfig, SocketIORequestPolicy, SocketIOServerConfig, } from './socket-io-config';
 export interface SocketIOServerLifecycle {
     /**
      * WebSocket handler for `Bun.serve({ websocket })`. Real on Bun; on Node it is
@@ -52,11 +52,11 @@ export interface SocketIOServerLifecycle {
     /** Current Engine.IO client count, when the engine has been bound. */
     connections(): number;
 }
-export interface SocketIOServerHandle<TServerEvents extends SocketEventMap, TClientEvents extends SocketEventMap> extends SocketIOServerLifecycle {
+export interface SocketIOServerHandle<TServerEvents extends SocketEventMap, TClientEvents extends SocketEventMap, TData = any> extends SocketIOServerLifecycle {
     /** The typed Socket.IO server — attach `io.on('connection', ...)` handlers. */
-    io: SocketIOServer<TClientEvents, TServerEvents>;
+    io: SocketIOServer<TClientEvents, TServerEvents, DefaultEventsMap, TData>;
 }
-export declare function createSocketIOServer<TServerEvents extends SocketEventMap, TClientEvents extends SocketEventMap>(config: SocketIOServerConfig): Promise<SocketIOServerHandle<TServerEvents, TClientEvents>>;
+export declare function createSocketIOServer<TServerEvents extends SocketEventMap, TClientEvents extends SocketEventMap, TParsed = any, TData = TParsed>(config: SocketIOServerConfig<TParsed, TData>): Promise<SocketIOServerHandle<TServerEvents, TClientEvents, TData>>;
 /**
  * Wrap a Socket.IO handle's `websocket` as a catch-all {@link ComposedLane} for
  * {@link composeWebSocketHandlers} — when a second, raw WebSocket lane shares

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,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"}
+{"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,gBAAgB,EAChB,MAAM,IAAI,cAAc,EAGzB,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAA2B,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AACxF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,KAAK,YAAY,EAAiB,MAAM,aAAa,CAAC;AAE/D,YAAY,EACV,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAE5B,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,EACpC,KAAK,GAAG,GAAG,CACX,SAAQ,uBAAuB;IAC/B,+EAA+E;IAC/E,EAAE,EAAE,cAAc,CAAC,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAC;CAC3E;AA8GD,wBAAsB,oBAAoB,CACxC,aAAa,SAAS,cAAc,EACpC,aAAa,SAAS,cAAc,EAKpC,OAAO,GAAG,GAAG,EACb,KAAK,GAAG,OAAO,EAEf,MAAM,EAAE,oBAAoB,CAAC,OAAO,EAAE,KAAK,CAAC,GAC3C,OAAO,CAAC,oBAAoB,CAAC,aAAa,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC,CA6IpE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,oBAAoB,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC,WAAW,CAAC,GAC3E,YAAY,CAMd"}

package/dist/testing.js

@@ -1,7 +1,7 @@
 import {
   createClient,
   createClients
-} from "./index-gff2mxzk.js";
+} from "./index-e1es808r.js";
 import"./index-48ffdxgk.js";
 import"./index-bmnhqtya.js";
 

package/dist/tools/remote.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../../src/tools/remote.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,WAAW,EAEjB,MAAM,aAAa,CAAC;AAGrB,OAAO,KAAK,EAAa,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAiB7D,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,aAAa,CAAC,EAAE,CACd,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACjE;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EACnE,QAAQ,EAAE,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC,EAChC,IAAI,EAAE,UAAU,EAChB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,UAAU,CAsFZ"}
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../../src/tools/remote.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,WAAW,EAEjB,MAAM,aAAa,CAAC;AAGrB,OAAO,KAAK,EAAa,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAiB7D,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,aAAa,CAAC,EAAE,CACd,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACjE;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EACnE,QAAQ,EAAE,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC,EAChC,IAAI,EAAE,UAAU,EAChB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,UAAU,CA0FZ"}

package/dist/tools.js

@@ -1,11 +1,11 @@
 import {
   signJwt,
   verifyPkce
-} from "./index-tw7mhqgy.js";
+} from "./index-yez419px.js";
 import {
   DEFAULT_CORS_ALLOW_HEADERS,
   contractOnlyService
-} from "./index-drsnz8gw.js";
+} from "./index-yydqk4fh.js";
 import {
   assertToolName,
   assertUniqueToolName,
@@ -26,7 +26,7 @@ import {
   toolErrorFromResult,
   toolResultFromError,
   writeDownload
-} from "./index-h55e1wyq.js";
+} from "./index-6j4j5wf9.js";
 import {
   isWithinDir,
   realPathWithinDir,
@@ -35,18 +35,18 @@ import {
 import {
   ApiError,
   createClient
-} from "./index-gff2mxzk.js";
+} from "./index-e1es808r.js";
 import"./index-48ffdxgk.js";
 import {
   redact
-} from "./index-psrxjvbw.js";
+} from "./index-gvha32jh.js";
 import {
   AppError,
   getRequestContext,
   getTraceId,
   mergeMeta,
   runWithRequestContext
-} from "./index-8qghvg18.js";
+} from "./index-173tvqcp.js";
 import {
   isRecord,
   resolvePropagationContext
@@ -2214,12 +2214,12 @@ function implementRemote(contract, http, options) {
           throw new Error(`implementRemote: endpoint "${key}" is not exposed over HTTP`);
         }
         const args = toArgs(ctx);
-        const finalArgs = options?.transformArgs ? await options.transformArgs(key, args) : args;
         try {
+          const finalArgs = options?.transformArgs ? await options.transformArgs(key, args) : args;
           return await call(finalArgs);
         } catch (err) {
           if (ApiError.is(err)) {
-            throw new AppError(err.code, err.message, err.status, isRecord(err.details) ? err.details : undefined, err.hint);
+            throw new AppError(err.code, err.message, err.status, isRecord(err.details) ? err.details : undefined, err.hint, err.traceId);
           }
           throw err;
         }