crossws 0.4.6 → 0.4.8

package/dist/_chunks/node.mjs

@@ -1,6 +1,6 @@
-import { AdapterHookable, adapterUtils, getPeers } from "./adapter.mjs";
 import { import_websocket_server } from "./libs/ws.mjs";
-import { Message, Peer, toBufferLike } from "./peer.mjs";
+import { AdapterHookable, adapterUtils, getPeers, toBufferLike } from "./adapter.mjs";
+import { Message, Peer } from "./peer.mjs";
 import { WSError } from "./error.mjs";
 import { StubRequest } from "./_request.mjs";
 function fromNodeUpgradeHandler(handler) {
@@ -15,6 +15,7 @@ const nodeAdapter = (options = {}) => {
 	if ("Deno" in globalThis || "Bun" in globalThis) throw new Error("[crossws] Using Node.js adapter in an incompatible environment.");
 	const hooks = new AdapterHookable(options);
 	const globalPeers = /* @__PURE__ */ new Map();
+	const baseUtils = adapterUtils(globalPeers, options);
 	const wss = options.wss || new import_websocket_server.default({
 		noServer: true,
 		handleProtocols: () => false,
@@ -28,7 +29,8 @@ const nodeAdapter = (options = {}) => {
 			request,
 			peers,
 			nodeReq,
-			namespace: nodeReq._namespace
+			namespace: nodeReq._namespace,
+			sync: baseUtils.sync
 		});
 		peers.add(peer);
 		hooks.callHook("open", peer);
@@ -41,8 +43,12 @@ const nodeAdapter = (options = {}) => {
 			peers.delete(peer);
 			hooks.callHook("error", peer, new WSError(error));
 		});
+		const socket = ws._socket;
+		const onDrain = () => hooks.callHook("drain", peer);
+		socket?.on("drain", onDrain);
 		ws.on("close", (code, reason) => {
 			peers.delete(peer);
+			socket?.off("drain", onDrain);
 			hooks.callHook("close", peer, {
 				code,
 				reason: reason?.toString()
@@ -54,7 +60,7 @@ const nodeAdapter = (options = {}) => {
 		if (upgradeHeaders) for (const [key, value] of new Headers(upgradeHeaders)) outgoingHeaders.push(`${key}: ${value}`);
 	});
 	return {
-		...adapterUtils(globalPeers),
+		...baseUtils,
 		handleUpgrade: async (nodeReq, socket, head, webRequest) => {
 			const request = webRequest || new NodeReqProxy(nodeReq);
 			const { upgradeHeaders, endResponse, handled, context, namespace } = await hooks.upgrade(request);
@@ -89,11 +95,11 @@ var NodePeer = class extends Peer {
 			binary: isBinary,
 			...options
 		});
-		return 0;
+		return this._internal.ws.bufferedAmount;
 	}
-	publish(topic, data, options) {
+	_publish(topic, data, options) {
 		const dataBuff = toBufferLike(data);
-		const isBinary = typeof data !== "string";
+		const isBinary = typeof dataBuff !== "string";
 		const sendOptions = {
 			compress: options?.compress,
 			binary: isBinary,

package/dist/_chunks/peer.mjs

@@ -1,28 +1,4 @@
-const kNodeInspect = /*#__PURE__*/ Symbol.for("nodejs.util.inspect.custom");
-function toBufferLike(val) {
-	if (val === void 0 || val === null) return "";
-	const type = typeof val;
-	if (type === "string") return val;
-	if (type === "number" || type === "boolean" || type === "bigint") return val.toString();
-	if (type === "function" || type === "symbol") return "{}";
-	if (val instanceof Uint8Array || val instanceof ArrayBuffer) return val;
-	if (isPlainObject(val)) return JSON.stringify(val);
-	return val;
-}
-function toString(val) {
-	if (typeof val === "string") return val;
-	const data = toBufferLike(val);
-	if (typeof data === "string") return data;
-	return `data:application/octet-stream;base64,${btoa(String.fromCharCode(...new Uint8Array(data)))}`;
-}
-function isPlainObject(value) {
-	if (value === null || typeof value !== "object") return false;
-	const prototype = Object.getPrototypeOf(value);
-	if (prototype !== null && prototype !== Object.prototype && Object.getPrototypeOf(prototype) !== null) return false;
-	if (Symbol.iterator in value) return false;
-	if (Symbol.toStringTag in value) return Object.prototype.toString.call(value) === "[object Module]";
-	return true;
-}
+import { kNodeInspect, serializeMessage } from "./adapter.mjs";
 var Message = class {
 	event;
 	peer;
@@ -147,6 +123,34 @@ var Peer = class {
 	get topics() {
 		return this._topics;
 	}
+	get bufferedAmount() {
+		return this._internal.ws?.bufferedAmount ?? 0;
+	}
+	waitForDrain(opts = {}) {
+		const threshold = opts.threshold ?? 0;
+		if (this.bufferedAmount <= threshold) return Promise.resolve();
+		const signal = opts.signal;
+		if (signal?.aborted) return Promise.reject(signal.reason);
+		return new Promise((resolve, reject) => {
+			const check = () => {
+				if (this.bufferedAmount <= threshold || (this.websocket.readyState ?? 1) > 1) {
+					cleanup();
+					resolve();
+				}
+			};
+			const onAbort = () => {
+				cleanup();
+				reject(signal.reason);
+			};
+			const timer = setInterval(check, opts.pollInterval ?? 100);
+			timer.unref?.();
+			const cleanup = () => {
+				clearInterval(timer);
+				signal?.removeEventListener("abort", onAbort);
+			};
+			signal?.addEventListener("abort", onAbort, { once: true });
+		});
+	}
 	terminate() {
 		this.close();
 	}
@@ -156,6 +160,14 @@ var Peer = class {
 	unsubscribe(topic) {
 		this._topics.delete(topic);
 	}
+	publish(topic, data, options) {
+		this._publish(topic, data, options);
+		this._internal.sync?.publish({
+			namespace: this.namespace,
+			topic,
+			data: serializeMessage(data)
+		});
+	}
 	toString() {
 		return this.id;
 	}
@@ -183,4 +195,4 @@ function createWsProxy(ws, request) {
 		return value;
 	} });
 }
-export { Message, Peer, toBufferLike, toString };
+export { Message, Peer };

package/dist/adapters/bun.mjs

@@ -1,11 +1,12 @@
-import { AdapterHookable, adapterUtils, getPeers } from "../_chunks/adapter.mjs";
-import { Message, Peer, toBufferLike } from "../_chunks/peer.mjs";
+import { AdapterHookable, adapterUtils, getPeers, toBufferLike } from "../_chunks/adapter.mjs";
+import { Message, Peer } from "../_chunks/peer.mjs";
 const bunAdapter = (options = {}) => {
 	if (typeof Bun === "undefined") throw new Error("[crossws] Using Bun adapter in an incompatible environment.");
 	const hooks = new AdapterHookable(options);
 	const globalPeers = /* @__PURE__ */ new Map();
+	const baseUtils = adapterUtils(globalPeers, options, { nativePubSub: true });
 	return {
-		...adapterUtils(globalPeers),
+		...baseUtils,
 		async handleUpgrade(request, server) {
 			const { upgradeHeaders, endResponse, context, namespace } = await hooks.upgrade(request);
 			if (endResponse) return endResponse;
@@ -21,34 +22,39 @@ const bunAdapter = (options = {}) => {
 		},
 		websocket: {
 			message: (ws, message) => {
-				const peer = getPeer(ws, getPeers(globalPeers, ws.data.namespace));
+				const peer = getPeer(ws, getPeers(globalPeers, ws.data.namespace), baseUtils.sync);
 				hooks.callHook("message", peer, new Message(message, peer));
 			},
 			open: (ws) => {
 				const peers = getPeers(globalPeers, ws.data.namespace);
-				const peer = getPeer(ws, peers);
+				const peer = getPeer(ws, peers, baseUtils.sync);
 				peers.add(peer);
 				hooks.callHook("open", peer);
 			},
 			close: (ws, code, reason) => {
 				const peers = getPeers(globalPeers, ws.data.namespace);
-				const peer = getPeer(ws, peers);
+				const peer = getPeer(ws, peers, baseUtils.sync);
 				peers.delete(peer);
 				hooks.callHook("close", peer, {
 					code,
 					reason
 				});
+			},
+			drain: (ws) => {
+				const peer = getPeer(ws, getPeers(globalPeers, ws.data.namespace));
+				hooks.callHook("drain", peer);
 			}
 		}
 	};
 };
-function getPeer(ws, peers) {
+function getPeer(ws, peers, sync) {
 	if (ws.data.peer) return ws.data.peer;
 	const peer = new BunPeer({
 		ws,
 		request: ws.data.request,
 		peers,
-		namespace: ws.data.namespace
+		namespace: ws.data.namespace,
+		sync
 	});
 	ws.data.peer = peer;
 	return peer;
@@ -60,10 +66,13 @@ var BunPeer = class extends Peer {
 	get context() {
 		return this._internal.ws.data.context;
 	}
+	get bufferedAmount() {
+		return this._internal.ws.getBufferedAmount();
+	}
 	send(data, options) {
 		return this._internal.ws.send(toBufferLike(data), options?.compress);
 	}
-	publish(topic, data, options) {
+	_publish(topic, data, options) {
 		return this._internal.ws.publish(topic, toBufferLike(data), options?.compress);
 	}
 	subscribe(topic) {

package/dist/adapters/bunny.mjs

@@ -1,11 +1,12 @@
-import { AdapterHookable, adapterUtils, getPeers } from "../_chunks/adapter.mjs";
-import { Message, Peer, toBufferLike } from "../_chunks/peer.mjs";
+import { AdapterHookable, adapterUtils, getPeers, toBufferLike } from "../_chunks/adapter.mjs";
+import { Message, Peer } from "../_chunks/peer.mjs";
 import { WSError } from "../_chunks/error.mjs";
 const bunnyAdapter = (options = {}) => {
 	const hooks = new AdapterHookable(options);
 	const globalPeers = /* @__PURE__ */ new Map();
+	const baseUtils = adapterUtils(globalPeers, options);
 	return {
-		...adapterUtils(globalPeers),
+		...baseUtils,
 		handleUpgrade: async (request) => {
 			if (!request.upgradeWebSocket || typeof request.upgradeWebSocket !== "function") throw new Error("[crossws] Bunny adapter requires the request to have an upgradeWebSocket method.");
 			const { endResponse, context, namespace, upgradeHeaders } = await hooks.upgrade(request);
@@ -23,7 +24,8 @@ const bunnyAdapter = (options = {}) => {
 				namespace,
 				remoteAddress,
 				peers,
-				context
+				context,
+				sync: baseUtils.sync
 			});
 			peers.add(peer);
 			socket.addEventListener("open", () => {
@@ -54,7 +56,7 @@ var BunnyPeer = class extends Peer {
 	send(data) {
 		return this._internal.ws.send(toBufferLike(data));
 	}
-	publish(topic, data) {
+	_publish(topic, data) {
 		const dataBuff = toBufferLike(data);
 		for (const peer of this._internal.peers) if (peer !== this && peer._topics.has(topic)) peer._internal.ws.send(dataBuff);
 	}

package/dist/adapters/cloudflare.mjs

@@ -1,5 +1,5 @@
-import { AdapterHookable, adapterUtils, getPeers } from "../_chunks/adapter.mjs";
-import { Message, Peer, toBufferLike } from "../_chunks/peer.mjs";
+import { AdapterHookable, adapterUtils, getPeers, toBufferLike } from "../_chunks/adapter.mjs";
+import { Message, Peer } from "../_chunks/peer.mjs";
 import { WSError } from "../_chunks/error.mjs";
 import { StubRequest } from "../_chunks/_request.mjs";
 import { env } from "cloudflare:workers";
@@ -14,7 +14,8 @@ const cloudflareAdapter = (opts = {}) => {
 			return binding.get(instanceId);
 		}
 	});
-	const { publish: durablePublish, ...utils } = adapterUtils(globalPeers);
+	const baseUtils = adapterUtils(globalPeers, opts);
+	const { publish: durablePublish, ...utils } = baseUtils;
 	return {
 		...utils,
 		handleUpgrade: async (request, cfEnv, cfCtx) => {
@@ -65,7 +66,7 @@ const cloudflareAdapter = (opts = {}) => {
 			const pair = new WebSocketPair();
 			const client = pair[0];
 			const server = pair[1];
-			const peer = CloudflareDurablePeer._restore(obj, server, request, namespace);
+			const peer = CloudflareDurablePeer._restore(obj, server, request, namespace, baseUtils.sync);
 			peers.add(peer);
 			obj.ctx.acceptWebSocket(server);
 			await hooks.callHook("open", peer);
@@ -76,11 +77,11 @@ const cloudflareAdapter = (opts = {}) => {
 			});
 		},
 		handleDurableMessage: async (obj, ws, message) => {
-			const peer = CloudflareDurablePeer._restore(obj, ws);
+			const peer = CloudflareDurablePeer._restore(obj, ws, void 0, void 0, baseUtils.sync);
 			await hooks.callHook("message", peer, new Message(message, peer));
 		},
 		handleDurableClose: async (obj, ws, code, reason, wasClean) => {
-			const peer = CloudflareDurablePeer._restore(obj, ws);
+			const peer = CloudflareDurablePeer._restore(obj, ws, void 0, void 0, baseUtils.sync);
 			getPeers(globalPeers, peer.namespace).delete(peer);
 			const details = {
 				code,
@@ -106,7 +107,7 @@ const cloudflareAdapter = (opts = {}) => {
 };
 var CloudflareDurablePeer = class CloudflareDurablePeer extends Peer {
 	get peers() {
-		return new Set(this.#getwebsockets().map((ws) => CloudflareDurablePeer._restore(this._internal.durable, ws)));
+		return new Set(this.#getwebsockets().map((ws) => CloudflareDurablePeer._restore(this._internal.durable, ws, void 0, void 0, this._internal.sync)));
 	}
 	#getwebsockets() {
 		return this._internal.durable.ctx.getWebSockets();
@@ -121,7 +122,7 @@ var CloudflareDurablePeer = class CloudflareDurablePeer extends Peer {
 		state.t.add(topic);
 		setAttachedState(this._internal.ws, state);
 	}
-	publish(topic, data) {
+	_publish(topic, data) {
 		const websockets = this.#getwebsockets();
 		if (websockets.length < 2) return;
 		const dataBuff = toBufferLike(data);
@@ -133,7 +134,7 @@ var CloudflareDurablePeer = class CloudflareDurablePeer extends Peer {
 	close(code, reason) {
 		this._internal.ws.close(code, reason);
 	}
-	static _restore(durable, ws, request, namespace) {
+	static _restore(durable, ws, request, namespace, sync) {
 		let peer = ws._crosswsPeer;
 		if (peer) return peer;
 		const state = ws.deserializeAttachment() || {};
@@ -141,7 +142,8 @@ var CloudflareDurablePeer = class CloudflareDurablePeer extends Peer {
 			ws,
 			request: request || new StubRequest(state.u || ""),
 			namespace: namespace || state.n || "",
-			durable
+			durable,
+			sync
 		});
 		if (state.i) peer._id = state.i;
 		if (request?.url) state.u = request.url;
@@ -156,7 +158,7 @@ var CloudflareFallbackPeer = class extends Peer {
 		this._internal.wsServer.send(toBufferLike(data));
 		return 0;
 	}
-	publish(_topic, _message) {
+	_publish(_topic, _message) {
 		console.warn("[crossws] [cloudflare] pub/sub support requires Durable Objects.");
 	}
 	close(code, reason) {

package/dist/adapters/deno.mjs

@@ -1,13 +1,16 @@
-import { AdapterHookable, adapterUtils, getPeers } from "../_chunks/adapter.mjs";
-import { Message, Peer, toBufferLike } from "../_chunks/peer.mjs";
+import { AdapterHookable, adapterUtils, getPeers, toBufferLike } from "../_chunks/adapter.mjs";
+import { Message, Peer } from "../_chunks/peer.mjs";
 import { WSError } from "../_chunks/error.mjs";
 const denoAdapter = (options = {}) => {
 	if (typeof Deno === "undefined") throw new Error("[crossws] Using Deno adapter in an incompatible environment.");
 	const hooks = new AdapterHookable(options);
 	const globalPeers = /* @__PURE__ */ new Map();
+	const baseUtils = adapterUtils(globalPeers, options);
 	return {
-		...adapterUtils(globalPeers),
+		...baseUtils,
 		handleUpgrade: async (request, info) => {
+			const remoteAddress = info.remoteAddr?.hostname;
+			const requestSnapshot = snapshotRequest(request);
 			const { upgradeHeaders, endResponse, context, namespace } = await hooks.upgrade(request);
 			if (endResponse) return endResponse;
 			const headers = upgradeHeaders instanceof Headers ? upgradeHeaders : new Headers(upgradeHeaders);
@@ -18,11 +21,12 @@ const denoAdapter = (options = {}) => {
 			const peers = getPeers(globalPeers, namespace);
 			const peer = new DenoPeer({
 				ws: upgrade.socket,
-				request,
+				request: requestSnapshot,
 				peers,
-				denoInfo: info,
+				remoteAddress,
 				context,
-				namespace
+				namespace,
+				sync: baseUtils.sync
 			});
 			peers.add(peer);
 			upgrade.socket.addEventListener("open", () => {
@@ -43,14 +47,23 @@ const denoAdapter = (options = {}) => {
 		}
 	};
 };
+function snapshotRequest(request) {
+	const url = request.url;
+	const headers = new Headers(request.headers);
+	return new Proxy(request, { get(target, prop, receiver) {
+		if (prop === "url") return url;
+		if (prop === "headers") return headers;
+		return Reflect.get(target, prop, receiver);
+	} });
+}
 var DenoPeer = class extends Peer {
 	get remoteAddress() {
-		return this._internal.denoInfo.remoteAddr?.hostname;
+		return this._internal.remoteAddress;
 	}
 	send(data) {
 		return this._internal.ws.send(toBufferLike(data));
 	}
-	publish(topic, data) {
+	_publish(topic, data) {
 		const dataBuff = toBufferLike(data);
 		for (const peer of this._internal.peers) if (peer !== this && peer._topics.has(topic)) peer._internal.ws.send(dataBuff);
 	}

package/dist/adapters/sse.mjs

@@ -1,11 +1,12 @@
-import { AdapterHookable, adapterUtils, getPeers } from "../_chunks/adapter.mjs";
-import { Message, Peer, toString } from "../_chunks/peer.mjs";
+import { AdapterHookable, adapterUtils, getPeers, toString } from "../_chunks/adapter.mjs";
+import { Message, Peer } from "../_chunks/peer.mjs";
 const sseAdapter = (opts = {}) => {
 	const hooks = new AdapterHookable(opts);
 	const globalPeers = /* @__PURE__ */ new Map();
 	const peersMap = opts.bidir ? /* @__PURE__ */ new Map() : void 0;
+	const baseUtils = adapterUtils(globalPeers, opts);
 	return {
-		...adapterUtils(globalPeers),
+		...baseUtils,
 		fetch: async (request) => {
 			const { upgradeHeaders, endResponse, context, namespace } = await hooks.upgrade(request);
 			if (endResponse) return endResponse;
@@ -31,7 +32,8 @@ const sseAdapter = (opts = {}) => {
 					hooks,
 					ws,
 					context,
-					namespace
+					namespace,
+					sync: baseUtils.sync
 				});
 				peers.add(peer);
 				if (opts.bidir) {
@@ -83,7 +85,7 @@ var SSEPeer = class extends Peer {
 		this._sendEvent("message", toString(data));
 		return 0;
 	}
-	publish(topic, data) {
+	_publish(topic, data) {
 		const dataBuff = toString(data);
 		for (const peer of this._internal.peers) if (peer !== this && peer._topics.has(topic)) peer._sendEvent("message", dataBuff);
 	}

package/dist/adapters/uws.d.mts

@@ -1,4 +1,4 @@
-import { Adapter, AdapterInstance, AdapterOptions, Peer, PeerContext } from "../_chunks/adapter.mjs";
+import { Adapter, AdapterInstance, AdapterOptions, Peer, PeerContext, SyncDriver } from "../_chunks/adapter.mjs";
 import { WebSocket } from "../_chunks/web.mjs";
 import uws from "uWebSockets.js";
 declare const StubRequest: {
@@ -29,6 +29,7 @@ declare class UWSPeer extends Peer<{
   uws: uws.WebSocket<UserData>;
   ws: UwsWebSocketProxy;
   uwsData: UserData;
+  sync?: SyncDriver;
 }> {
   get remoteAddress(): string | undefined;
   get context(): PeerContext;
@@ -37,7 +38,7 @@ declare class UWSPeer extends Peer<{
   }): number;
   subscribe(topic: string): void;
   unsubscribe(topic: string): void;
-  publish(topic: string, message: string, options?: {
+  _publish(topic: string, message: string, options?: {
     compress?: boolean;
   }): number;
   close(code?: number, reason?: uws.RecognizedString): void;
@@ -47,8 +48,8 @@ declare class UWSReqProxy extends StubRequest {
   constructor(req: uws.HttpRequest);
 }
 declare class UwsWebSocketProxy implements Partial<WebSocket> {
-  private _uws;
   readyState?: number;
+  private _uws;
   constructor(_uws: uws.WebSocket<UserData>);
   get bufferedAmount(): number;
   get protocol(): string;

package/dist/adapters/uws.mjs

@@ -1,16 +1,17 @@
-import { AdapterHookable, adapterUtils, getPeers } from "../_chunks/adapter.mjs";
-import { Message, Peer, toBufferLike } from "../_chunks/peer.mjs";
+import { AdapterHookable, adapterUtils, getPeers, toBufferLike } from "../_chunks/adapter.mjs";
+import { Message, Peer } from "../_chunks/peer.mjs";
 import { StubRequest } from "../_chunks/_request.mjs";
 const uwsAdapter = (options = {}) => {
 	const hooks = new AdapterHookable(options);
 	const globalPeers = /* @__PURE__ */ new Map();
+	const baseUtils = adapterUtils(globalPeers, options, { nativePubSub: true });
 	return {
-		...adapterUtils(globalPeers),
+		...baseUtils,
 		websocket: {
 			...options.uws,
 			close(ws, code, message) {
 				const peers = getPeers(globalPeers, ws.getUserData().namespace);
-				const peer = getPeer(ws, peers);
+				const peer = getPeer(ws, peers, baseUtils.sync);
 				peer._internal.ws.readyState = 2;
 				peers.delete(peer);
 				hooks.callHook("close", peer, {
@@ -20,12 +21,16 @@ const uwsAdapter = (options = {}) => {
 				peer._internal.ws.readyState = 3;
 			},
 			message(ws, message, _isBinary) {
-				const peer = getPeer(ws, getPeers(globalPeers, ws.getUserData().namespace));
+				const peer = getPeer(ws, getPeers(globalPeers, ws.getUserData().namespace), baseUtils.sync);
 				hooks.callHook("message", peer, new Message(message, peer));
 			},
+			drain(ws) {
+				const peer = getPeer(ws, getPeers(globalPeers, ws.getUserData().namespace));
+				hooks.callHook("drain", peer);
+			},
 			open(ws) {
 				const peers = getPeers(globalPeers, ws.getUserData().namespace);
-				const peer = getPeer(ws, peers);
+				const peer = getPeer(ws, peers, baseUtils.sync);
 				peers.add(peer);
 				hooks.callHook("open", peer);
 			},
@@ -70,7 +75,7 @@ const uwsAdapter = (options = {}) => {
 		}
 	};
 };
-function getPeer(uws, peers) {
+function getPeer(uws, peers, sync) {
 	const uwsData = uws.getUserData();
 	if (uwsData.peer) return uwsData.peer;
 	const peer = new UWSPeer({
@@ -79,7 +84,8 @@ function getPeer(uws, peers) {
 		ws: new UwsWebSocketProxy(uws),
 		request: uwsData.webReq,
 		namespace: uwsData.namespace,
-		uwsData
+		uwsData,
+		sync
 	});
 	uwsData.peer = peer;
 	return peer;
@@ -106,7 +112,7 @@ var UWSPeer = class extends Peer {
 		this._topics.delete(topic);
 		this._internal.uws.unsubscribe(topic);
 	}
-	publish(topic, message, options) {
+	_publish(topic, message, options) {
 		const data = toBufferLike(message);
 		const isBinary = typeof data !== "string";
 		this._internal.uws.publish(topic, data, isBinary, options?.compress);
@@ -136,8 +142,8 @@ var UWSReqProxy = class extends StubRequest {
 	}
 };
 var UwsWebSocketProxy = class {
-	_uws;
 	readyState = 1;
+	_uws;
 	constructor(_uws) {
 		this._uws = _uws;
 	}

package/dist/index.d.mts

@@ -1,13 +1,26 @@
-import { Adapter, AdapterInstance, AdapterInternal, AdapterOptions, Hooks, Message, Peer, PeerContext, ResolveHooks, WSError, defineHooks, defineWebSocketAdapter } from "./_chunks/adapter.mjs";
+import { Adapter, AdapterInstance, AdapterInternal, AdapterOptions, Hooks, Message, Peer, PeerContext, ResolveHooks, SyncAdapter, SyncDriver, SyncErrorContext, SyncMessage, WSError, WaitForDrainOptions, defineHooks, defineWebSocketAdapter } from "./_chunks/adapter.mjs";
 import { ServerWithWSOptions, WSOptions } from "./_chunks/_types.mjs";
 interface WebSocketProxyOptions {
   /**
    * Target WebSocket URL to proxy to (`ws://` or `wss://`).
    *
+   * A `ws+unix://<socketPath>:<pathname>` target is also supported out of the
+   * box for proxying to a Unix-socket upstream on Node, Bun, and Deno (no custom
+   * {@link WebSocket} constructor required) — crossws dials it through the
+   * matching per-runtime `crossws/websocket` client. See the guide for details.
+   *
    * Can be a static string/URL or a function that resolves the target dynamically
-   * based on the incoming {@link Peer}.
+   * based on the incoming {@link Peer}. The resolver may be **async** (return a
+   * promise) — useful when the upstream address isn't known yet at connect time
+   * (e.g. a worker that's still booting or being hot-reloaded). Client frames
+   * sent in the meantime are buffered (bounded by {@link maxBufferSize}) and a
+   * non-zero {@link connectTimeout} also covers the resolution, so a resolver
+   * that never settles closes the peer with `1011` rather than hanging. With
+   * `connectTimeout: 0` (timeout disabled) a never-settling resolver leaves the
+   * peer open until {@link maxBufferSize} is hit (`1009`), so pair an unbounded
+   * timeout with your own resolver deadline.
    */
-  target: string | URL | ((peer: Peer) => string | URL);
+  target: string | URL | ((peer: Peer) => string | URL | Promise<string | URL>);
   /**
    * Subprotocol(s) to offer the upstream during the handshake.
    *
@@ -81,6 +94,39 @@ interface WebSocketProxyOptions {
    * ```
    */
   headers?: HeadersInit | ((peer: Peer) => HeadersInit | undefined | void);
+  /**
+   * Extra options merged into the upstream `WebSocket` constructor's third
+   * argument, as a static object or a per-peer resolver.
+   *
+   * This is the escape hatch for runtime- or client-specific dialing options
+   * that the WHATWG `WebSocket` signature doesn't cover — e.g. Deno's unstable
+   * `client` (to dial a Unix socket or use a custom `Deno.HttpClient`), or the
+   * `ws`/`undici` `createConnection`/`dispatcher`/`agent` options.
+   *
+   * Merged with {@link headers}: keys returned here are spread first, then the
+   * resolved `headers` option is applied on top (so a dedicated `headers`
+   * option wins over a `headers` key returned here).
+   *
+   * > [!NOTE]
+   * > Only honored by `WebSocket` constructors that accept a third options
+   * > argument. The WHATWG global browser constructor ignores it; Deno and Bun
+   * > extend the signature with their own options.
+   *
+   * @example Proxy to a Unix socket on Deno
+   * ```ts
+   * createWebSocketProxy({
+   *   // Deno's WebSocket rejects the `ws+unix:` scheme, so keep a plain
+   *   // `ws://` target and redirect the transport via the `client` option.
+   *   target: (peer) => `ws://localhost${new URL(peer.request.url).pathname}`,
+   *   webSocketOptions: () => ({
+   *     client: Deno.createHttpClient({
+   *       proxy: { transport: "unix", path: "/run/worker.sock" },
+   *     }),
+   *   }),
+   * });
+   * ```
+   */
+  webSocketOptions?: Record<string, unknown> | ((peer: Peer) => Record<string, unknown> | undefined | void);
 }
 /**
  * Create a set of crossws hooks that proxy incoming WebSocket connections
@@ -94,4 +140,4 @@ interface WebSocketProxyOptions {
  * ```
  */
 declare function createWebSocketProxy(target: WebSocketProxyOptions["target"] | WebSocketProxyOptions): Partial<Hooks>;
-export { type Adapter, type AdapterInstance, type AdapterInternal, type AdapterOptions, type Hooks, type Message, type Peer, type PeerContext, type ResolveHooks, type ServerWithWSOptions, type WSError, type WSOptions, type WebSocketProxyOptions, createWebSocketProxy, defineHooks, defineWebSocketAdapter };
+export { type Adapter, type AdapterInstance, type AdapterInternal, type AdapterOptions, type Hooks, type Message, type Peer, type PeerContext, type ResolveHooks, type ServerWithWSOptions, type SyncAdapter, type SyncDriver, type SyncErrorContext, type SyncMessage, type WSError, type WSOptions, type WaitForDrainOptions, type WebSocketProxyOptions, createWebSocketProxy, defineHooks, defineWebSocketAdapter };