@dxos/edge-client 0.10.0 → 0.11.0

package/dist/lib/chunk-edge-ws-muxer.mjs

@@ -0,0 +1,322 @@
+import { Trigger } from "@dxos/async";
+import { log } from "@dxos/log";
+import { buf, bufWkt } from "@dxos/protocols/buf";
+import { MessageSchema, SwarmRequestSchema, SwarmResponseSchema, TextMessageSchema } from "@dxos/protocols/buf/dxos/edge/messenger_pb";
+import { invariant } from "@dxos/invariant";
+import { bufferToArray } from "@dxos/util";
+//#region src/protocol.ts
+var __dxlog_file$1 = "/__w/dxos/dxos/packages/core/mesh/edge-client/src/protocol.ts";
+var getTypename = (typeName) => `type.googleapis.com/${typeName}`;
+/**
+* NOTE: The type registry should be extended with all message types.
+*/
+var Protocol = class {
+	_typeRegistry;
+	constructor(types) {
+		this._typeRegistry = buf.createRegistry(...types);
+	}
+	get typeRegistry() {
+		return this._typeRegistry;
+	}
+	toJson(message) {
+		try {
+			return buf.toJson(MessageSchema, message, { registry: this.typeRegistry });
+		} catch (err) {
+			return { type: this.getPayloadType(message) };
+		}
+	}
+	/**
+	* Return the payload with the given type.
+	*/
+	getPayload(message, type) {
+		invariant(message.payload, void 0, {
+			"~LogMeta": "~LogMeta",
+			F: __dxlog_file$1,
+			L: 40,
+			S: this,
+			A: ["message.payload", ""]
+		});
+		const payloadTypename = this.getPayloadType(message);
+		if (type && type.typeName !== payloadTypename) throw new Error(`Unexpected payload type: ${payloadTypename}; expected ${type.typeName}`);
+		invariant(bufWkt.anyIs(message.payload, type), `Unexpected payload type: ${payloadTypename}}`, {
+			"~LogMeta": "~LogMeta",
+			F: __dxlog_file$1,
+			L: 46,
+			S: this,
+			A: ["bufWkt.anyIs(message.payload, type)", "`Unexpected payload type: ${payloadTypename}}`"]
+		});
+		const payload = bufWkt.anyUnpack(message.payload, this.typeRegistry);
+		invariant(payload, `Empty payload: ${payloadTypename}}`, {
+			"~LogMeta": "~LogMeta",
+			F: __dxlog_file$1,
+			L: 48,
+			S: this,
+			A: ["payload", "`Empty payload: ${payloadTypename}}`"]
+		});
+		return payload;
+	}
+	/**
+	* Get the payload type.
+	*/
+	getPayloadType(message) {
+		if (!message.payload) return;
+		const [, type] = message.payload.typeUrl.split("/");
+		return type;
+	}
+	/**
+	* Create a packed message.
+	*/
+	createMessage(type, { source, target, tags, payload, serviceId }) {
+		return buf.create(MessageSchema, {
+			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+			source,
+			target,
+			tags,
+			serviceId,
+			payload: payload ? bufWkt.anyPack(type, buf.create(type, payload)) : void 0
+		});
+	}
+};
+/**
+* Convert websocket data to Uint8Array.
+*/
+var toUint8Array = async (data) => {
+	if (data instanceof Buffer) return bufferToArray(data);
+	if (data instanceof ArrayBuffer) return new Uint8Array(data);
+	if (data instanceof Blob) return new Uint8Array(await data.arrayBuffer());
+	throw new Error(`Unexpected datatype: ${data}`);
+};
+//#endregion
+//#region src/defs.ts
+var protocol = new Protocol([
+	SwarmRequestSchema,
+	SwarmResponseSchema,
+	TextMessageSchema,
+	bufWkt.AnySchema
+]);
+//#endregion
+//#region src/edge-ws-muxer.ts
+var __dxlog_file = "/__w/dxos/dxos/packages/core/mesh/edge-client/src/edge-ws-muxer.ts";
+/**
+* 0000 0001 - message contains a part of segmented message chunk sequence.
+* The next byte defines a channel id and the rest of the message contains a part of Message proto binary.
+* Messages from different channels might interleave.
+* When the flag is NOT set the rest of the message should be interpreted as the valid Message proto binary.
+*/
+var FLAG_SEGMENT_SEQ = 1;
+/**
+* 0000 0010 - message terminates a segmented message chunk sequence.
+* All the chunks accumulated for the channel specified by the second byte can be concatenated
+* and interpreted as a valid Message proto binary.
+*/
+var FLAG_SEGMENT_SEQ_TERMINATED = 2;
+/**
+* https://developers.cloudflare.com/durable-objects/platform/limits/
+*/
+var CLOUDFLARE_MESSAGE_MAX_BYTES = 1e3 * 1e3;
+var CLOUDFLARE_RPC_MAX_BYTES = 32 * 1e3 * 1e3;
+var MAX_CHUNK_LENGTH = 16384;
+var MAX_BUFFERED_AMOUNT = CLOUDFLARE_MESSAGE_MAX_BYTES;
+var BUFFER_FULL_BACKOFF_TIMEOUT = 100;
+var WebSocketMuxer = class {
+	_ws;
+	_inMessageAccumulator = /* @__PURE__ */ new Map();
+	_outMessageChunks = /* @__PURE__ */ new Map();
+	_outMessageChannelByService = /* @__PURE__ */ new Map();
+	_sendTimeout;
+	_maxChunkLength;
+	constructor(_ws, config) {
+		this._ws = _ws;
+		this._maxChunkLength = config?.maxChunkLength ?? MAX_CHUNK_LENGTH;
+	}
+	/**
+	* Resolves when all the message chunks get enqueued for sending.
+	*/
+	async send(message) {
+		const binary = buf.toBinary(MessageSchema, message);
+		const channelId = this._resolveChannel(message);
+		if (channelId == null && binary.byteLength > 1e6 || binary.byteLength > 32e6) {
+			log.error("Large message dropped", {
+				byteLength: binary.byteLength,
+				serviceId: message.serviceId,
+				payload: protocol.getPayloadType(message),
+				channelId
+			}, {
+				"~LogMeta": "~LogMeta",
+				F: __dxlog_file,
+				L: 62,
+				S: this
+			});
+			return;
+		}
+		if (channelId == null || binary.length < this._maxChunkLength) {
+			const flags = Buffer.from([0]);
+			this._ws.send(Buffer.concat([flags, binary]));
+			return;
+		}
+		const chunkCount = Math.ceil(binary.length / this._maxChunkLength);
+		log("muxer sending segmented message", {
+			byteLength: binary.byteLength,
+			chunkCount,
+			channelId,
+			serviceId: message.serviceId,
+			payload: protocol.getPayloadType(message)
+		}, {
+			"~LogMeta": "~LogMeta",
+			F: __dxlog_file,
+			L: 78,
+			S: this
+		});
+		const terminatorSentTrigger = new Trigger();
+		const messageChunks = [];
+		for (let i = 0; i < binary.length; i += this._maxChunkLength) {
+			const chunk = binary.slice(i, i + this._maxChunkLength);
+			if (i + this._maxChunkLength >= binary.length) {
+				const flags = Buffer.from([3, channelId]);
+				messageChunks.push({
+					payload: Buffer.concat([flags, chunk]),
+					trigger: terminatorSentTrigger
+				});
+			} else {
+				const flags = Buffer.from([FLAG_SEGMENT_SEQ, channelId]);
+				messageChunks.push({ payload: Buffer.concat([flags, chunk]) });
+			}
+		}
+		const queuedMessages = this._outMessageChunks.get(channelId);
+		if (queuedMessages) queuedMessages.push(...messageChunks);
+		else this._outMessageChunks.set(channelId, messageChunks);
+		this._sendChunkedMessages();
+		await terminatorSentTrigger.wait();
+		log.debug("muxer segmented message send enqueued", {
+			byteLength: binary.byteLength,
+			chunkCount,
+			channelId,
+			serviceId: message.serviceId
+		}, {
+			"~LogMeta": "~LogMeta",
+			F: __dxlog_file,
+			L: 110,
+			S: this
+		});
+	}
+	receiveData(data) {
+		if ((data[0] & FLAG_SEGMENT_SEQ) === 0) return buf.fromBinary(MessageSchema, data.slice(1));
+		const [flags, channelId, ...payload] = data;
+		const chunkPayload = Buffer.from(payload);
+		let chunkAccumulator = this._inMessageAccumulator.get(channelId);
+		if (chunkAccumulator) chunkAccumulator.push(chunkPayload);
+		else {
+			chunkAccumulator = [chunkPayload];
+			this._inMessageAccumulator.set(channelId, chunkAccumulator);
+			log.debug("muxer started receiving segmented message", {
+				channelId,
+				firstChunkBytes: chunkPayload.byteLength
+			}, {
+				"~LogMeta": "~LogMeta",
+				F: __dxlog_file,
+				L: 131,
+				S: this
+			});
+		}
+		if ((flags & FLAG_SEGMENT_SEQ_TERMINATED) === 0) return;
+		const reassembled = Buffer.concat(chunkAccumulator);
+		const chunkCount = chunkAccumulator.length;
+		this._inMessageAccumulator.delete(channelId);
+		try {
+			const message = buf.fromBinary(MessageSchema, reassembled);
+			log("muxer reassembled segmented message", {
+				channelId,
+				chunkCount,
+				byteLength: reassembled.byteLength,
+				serviceId: message.serviceId,
+				payloadBytes: message.payload?.value?.byteLength
+			}, {
+				"~LogMeta": "~LogMeta",
+				F: __dxlog_file,
+				L: 146,
+				S: this
+			});
+			return message;
+		} catch (error) {
+			log.error("muxer failed to decode reassembled message", {
+				channelId,
+				chunkCount,
+				byteLength: reassembled.byteLength,
+				cause: error instanceof Error ? error.message : String(error)
+			}, {
+				"~LogMeta": "~LogMeta",
+				F: __dxlog_file,
+				L: 155,
+				S: this
+			});
+			throw error;
+		}
+	}
+	destroy() {
+		if (this._sendTimeout) {
+			clearTimeout(this._sendTimeout);
+			this._sendTimeout = void 0;
+		}
+		for (const channelChunks of this._outMessageChunks.values()) channelChunks.forEach((chunk) => chunk.trigger?.wake());
+		this._outMessageChunks.clear();
+		this._inMessageAccumulator.clear();
+		this._outMessageChannelByService.clear();
+	}
+	_sendChunkedMessages() {
+		if (this._sendTimeout) return;
+		const send = () => {
+			if (this._ws.readyState === 2 || this._ws.readyState === 3) {
+				log.warn("send called for closed websocket", void 0, {
+					"~LogMeta": "~LogMeta",
+					F: __dxlog_file,
+					L: 185,
+					S: this
+				});
+				this._sendTimeout = void 0;
+				return;
+			}
+			let timeout = 0;
+			const emptyChannels = [];
+			for (const [channelId, messages] of this._outMessageChunks.entries()) {
+				if (this._ws.bufferedAmount != null) {
+					if (this._ws.bufferedAmount + MAX_CHUNK_LENGTH > MAX_BUFFERED_AMOUNT) {
+						log.debug("muxer send paused (websocket buffer full)", {
+							channelId,
+							bufferedAmount: this._ws.bufferedAmount,
+							pendingChannels: this._outMessageChunks.size
+						}, {
+							"~LogMeta": "~LogMeta",
+							F: __dxlog_file,
+							L: 195,
+							S: this
+						});
+						timeout = BUFFER_FULL_BACKOFF_TIMEOUT;
+						break;
+					}
+				}
+				const nextMessage = messages.shift();
+				if (nextMessage) {
+					this._ws.send(nextMessage.payload);
+					nextMessage.trigger?.wake();
+				} else emptyChannels.push(channelId);
+			}
+			emptyChannels.forEach((channelId) => this._outMessageChunks.delete(channelId));
+			if (this._outMessageChunks.size > 0) this._sendTimeout = setTimeout(send, timeout);
+			else this._sendTimeout = void 0;
+		};
+		this._sendTimeout = setTimeout(send);
+	}
+	_resolveChannel(message) {
+		if (!message.serviceId) return;
+		let id = this._outMessageChannelByService.get(message.serviceId);
+		if (!id) {
+			id = this._outMessageChannelByService.size + 1;
+			this._outMessageChannelByService.set(message.serviceId, id);
+		}
+		return id;
+	}
+};
+//#endregion
+export { Protocol as a, protocol as i, CLOUDFLARE_RPC_MAX_BYTES as n, getTypename as o, WebSocketMuxer as r, toUint8Array as s, CLOUDFLARE_MESSAGE_MAX_BYTES as t };
+
+//# sourceMappingURL=chunk-edge-ws-muxer.mjs.map

package/dist/lib/chunk-edge-ws-muxer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-edge-ws-muxer.mjs","names":[],"sources":["../../src/protocol.ts","../../src/defs.ts","../../src/edge-ws-muxer.ts"],"sourcesContent":["//\n// Copyright 2024 DXOS.org\n//\n\nimport { invariant } from '@dxos/invariant';\nimport { buf, bufWkt } from '@dxos/protocols/buf';\nimport { type Message, MessageSchema, type PeerSchema } from '@dxos/protocols/buf/dxos/edge/messenger_pb';\nimport { bufferToArray } from '@dxos/util';\n\nexport type PeerData = buf.MessageInitShape<typeof PeerSchema>;\n\nexport const getTypename = (typeName: string) => `type.googleapis.com/${typeName}`;\n\n/**\n * NOTE: The type registry should be extended with all message types.\n */\nexport class Protocol {\n  private readonly _typeRegistry: buf.Registry;\n\n  constructor(types: buf.DescMessage[]) {\n    this._typeRegistry = buf.createRegistry(...types);\n  }\n\n  get typeRegistry(): buf.Registry {\n    return this._typeRegistry;\n  }\n\n  toJson(message: Message): any {\n    try {\n      return buf.toJson(MessageSchema, message, { registry: this.typeRegistry });\n    } catch (err) {\n      return { type: this.getPayloadType(message) };\n    }\n  }\n\n  /**\n   * Return the payload with the given type.\n   */\n  getPayload<Desc extends buf.DescMessage>(message: Message, type: Desc): buf.MessageShape<Desc> {\n    invariant(message.payload);\n    const payloadTypename = this.getPayloadType(message);\n    if (type && type.typeName !== payloadTypename) {\n      throw new Error(`Unexpected payload type: ${payloadTypename}; expected ${type.typeName}`);\n    }\n\n    invariant(bufWkt.anyIs(message.payload, type), `Unexpected payload type: ${payloadTypename}}`);\n    const payload = bufWkt.anyUnpack(message.payload, this.typeRegistry) as buf.MessageShape<Desc>;\n    invariant(payload, `Empty payload: ${payloadTypename}}`);\n    return payload;\n  }\n\n  /**\n   * Get the payload type.\n   */\n  getPayloadType(message: Message): string | undefined {\n    if (!message.payload) {\n      return undefined;\n    }\n\n    const [, type] = message.payload.typeUrl.split('/');\n    return type;\n  }\n\n  /**\n   * Create a packed message.\n   */\n  createMessage<Desc extends buf.DescMessage>(\n    type: Desc,\n    {\n      source,\n      target,\n      tags,\n      payload,\n      serviceId,\n    }: {\n      source?: PeerData;\n      target?: PeerData[];\n      // Broadcast tags (DX-1125). Set with no resolvable `target` to publish to the swarm.\n      tags?: string[];\n      payload?: buf.MessageInitShape<Desc>;\n      serviceId?: string;\n    },\n  ): Message {\n    return buf.create(MessageSchema, {\n      timestamp: new Date().toISOString(),\n      source,\n      target,\n      tags,\n      serviceId,\n      payload: payload ? bufWkt.anyPack(type, buf.create(type, payload)) : undefined,\n    });\n  }\n}\n\n/**\n * Convert websocket data to Uint8Array.\n */\nexport const toUint8Array = async (data: any): Promise<Uint8Array> => {\n  // Node.\n  if (data instanceof Buffer) {\n    return bufferToArray(data);\n  }\n\n  // Browser with `binaryType = 'arraybuffer'`.\n  if (data instanceof ArrayBuffer) {\n    return new Uint8Array(data);\n  }\n\n  // Browser fallback (`binaryType = 'blob'`, the WebSocket default).\n  if (data instanceof Blob) {\n    return new Uint8Array(await data.arrayBuffer());\n  }\n\n  throw new Error(`Unexpected datatype: ${data}`);\n};\n","//\n// Copyright 2024 DXOS.org\n//\n\nimport { bufWkt } from '@dxos/protocols/buf';\nimport { SwarmRequestSchema, SwarmResponseSchema, TextMessageSchema } from '@dxos/protocols/buf/dxos/edge/messenger_pb';\n\nimport { Protocol } from './protocol';\n\nexport const protocol = new Protocol([SwarmRequestSchema, SwarmResponseSchema, TextMessageSchema, bufWkt.AnySchema]);\n","//\n// Copyright 2025 DXOS.org\n//\n\nimport { Trigger } from '@dxos/async';\nimport { log } from '@dxos/log';\nimport { buf } from '@dxos/protocols/buf';\nimport { type Message, MessageSchema } from '@dxos/protocols/buf/dxos/edge/messenger_pb';\n\nimport { protocol } from './defs';\n\n/**\n * 0000 0001 - message contains a part of segmented message chunk sequence.\n * The next byte defines a channel id and the rest of the message contains a part of Message proto binary.\n * Messages from different channels might interleave.\n * When the flag is NOT set the rest of the message should be interpreted as the valid Message proto binary.\n */\nconst FLAG_SEGMENT_SEQ = 1;\n/**\n * 0000 0010 - message terminates a segmented message chunk sequence.\n * All the chunks accumulated for the channel specified by the second byte can be concatenated\n * and interpreted as a valid Message proto binary.\n */\nconst FLAG_SEGMENT_SEQ_TERMINATED = 1 << 1;\n\n/**\n * https://developers.cloudflare.com/durable-objects/platform/limits/\n */\nexport const CLOUDFLARE_MESSAGE_MAX_BYTES = 1000 * 1000; // 1MB\nexport const CLOUDFLARE_RPC_MAX_BYTES = 32 * 1000 * 1000; // 32MB\n\nconst MAX_CHUNK_LENGTH = 16384;\nconst MAX_BUFFERED_AMOUNT = CLOUDFLARE_MESSAGE_MAX_BYTES;\nconst BUFFER_FULL_BACKOFF_TIMEOUT = 100;\n\nexport class WebSocketMuxer {\n  private readonly _inMessageAccumulator = new Map<number, Buffer[]>();\n  private readonly _outMessageChunks = new Map<number, MessageChunk[]>();\n  private readonly _outMessageChannelByService = new Map<string, number>();\n\n  private _sendTimeout: any | undefined;\n\n  private readonly _maxChunkLength: number;\n\n  constructor(\n    private readonly _ws: WebSocketCompat,\n    config?: { maxChunkLength: number },\n  ) {\n    this._maxChunkLength = config?.maxChunkLength ?? MAX_CHUNK_LENGTH;\n  }\n\n  /**\n   * Resolves when all the message chunks get enqueued for sending.\n   */\n  public async send(message: Message): Promise<void> {\n    const binary = buf.toBinary(MessageSchema, message);\n    const channelId = this._resolveChannel(message);\n    if (\n      (channelId == null && binary.byteLength > CLOUDFLARE_MESSAGE_MAX_BYTES) ||\n      binary.byteLength > CLOUDFLARE_RPC_MAX_BYTES\n    ) {\n      log.error('Large message dropped', {\n        byteLength: binary.byteLength,\n        serviceId: message.serviceId,\n        payload: protocol.getPayloadType(message),\n        channelId,\n      });\n      return;\n    }\n\n    if (channelId == null || binary.length < this._maxChunkLength) {\n      const flags = Buffer.from([0]);\n      this._ws.send(Buffer.concat([flags, binary]));\n      return;\n    }\n\n    const chunkCount = Math.ceil(binary.length / this._maxChunkLength);\n    log('muxer sending segmented message', {\n      byteLength: binary.byteLength,\n      chunkCount,\n      channelId,\n      serviceId: message.serviceId,\n      payload: protocol.getPayloadType(message),\n    });\n\n    const terminatorSentTrigger = new Trigger();\n    const messageChunks: MessageChunk[] = [];\n    for (let i = 0; i < binary.length; i += this._maxChunkLength) {\n      const chunk = binary.slice(i, i + this._maxChunkLength);\n      const isLastChunk = i + this._maxChunkLength >= binary.length;\n      if (isLastChunk) {\n        const flags = Buffer.from([FLAG_SEGMENT_SEQ | FLAG_SEGMENT_SEQ_TERMINATED, channelId]);\n        messageChunks.push({ payload: Buffer.concat([flags, chunk]), trigger: terminatorSentTrigger });\n      } else {\n        const flags = Buffer.from([FLAG_SEGMENT_SEQ, channelId]);\n        messageChunks.push({ payload: Buffer.concat([flags, chunk]) });\n      }\n    }\n\n    const queuedMessages = this._outMessageChunks.get(channelId);\n    if (queuedMessages) {\n      queuedMessages.push(...messageChunks);\n    } else {\n      this._outMessageChunks.set(channelId, messageChunks);\n    }\n\n    this._sendChunkedMessages();\n\n    await terminatorSentTrigger.wait();\n    log.debug('muxer segmented message send enqueued', {\n      byteLength: binary.byteLength,\n      chunkCount,\n      channelId,\n      serviceId: message.serviceId,\n    });\n  }\n\n  public receiveData(data: Uint8Array): Message | undefined {\n    if ((data[0] & FLAG_SEGMENT_SEQ) === 0) {\n      return buf.fromBinary(MessageSchema, data.slice(1));\n    }\n\n    const [flags, channelId, ...payload] = data;\n    const chunkPayload = Buffer.from(payload);\n    let chunkAccumulator = this._inMessageAccumulator.get(channelId);\n    if (chunkAccumulator) {\n      chunkAccumulator.push(chunkPayload);\n    } else {\n      chunkAccumulator = [chunkPayload];\n      this._inMessageAccumulator.set(channelId, chunkAccumulator);\n      log.debug('muxer started receiving segmented message', {\n        channelId,\n        firstChunkBytes: chunkPayload.byteLength,\n      });\n    }\n\n    if ((flags & FLAG_SEGMENT_SEQ_TERMINATED) === 0) {\n      return undefined;\n    }\n\n    const reassembled = Buffer.concat(chunkAccumulator);\n    const chunkCount = chunkAccumulator.length;\n    this._inMessageAccumulator.delete(channelId);\n    try {\n      const message = buf.fromBinary(MessageSchema, reassembled);\n      log('muxer reassembled segmented message', {\n        channelId,\n        chunkCount,\n        byteLength: reassembled.byteLength,\n        serviceId: message.serviceId,\n        payloadBytes: message.payload?.value?.byteLength,\n      });\n      return message;\n    } catch (error) {\n      log.error('muxer failed to decode reassembled message', {\n        channelId,\n        chunkCount,\n        byteLength: reassembled.byteLength,\n        cause: error instanceof Error ? error.message : String(error),\n      });\n      throw error;\n    }\n  }\n\n  public destroy(): void {\n    if (this._sendTimeout) {\n      clearTimeout(this._sendTimeout);\n      this._sendTimeout = undefined;\n    }\n    for (const channelChunks of this._outMessageChunks.values()) {\n      channelChunks.forEach((chunk) => chunk.trigger?.wake());\n    }\n    this._outMessageChunks.clear();\n    this._inMessageAccumulator.clear();\n    this._outMessageChannelByService.clear();\n  }\n\n  private _sendChunkedMessages(): void {\n    if (this._sendTimeout) {\n      return;\n    }\n\n    const send = () => {\n      if (this._ws.readyState === WebSocket.CLOSING || this._ws.readyState === WebSocket.CLOSED) {\n        log.warn('send called for closed websocket');\n        this._sendTimeout = undefined;\n        return;\n      }\n\n      let timeout = 0;\n      const emptyChannels: number[] = [];\n      for (const [channelId, messages] of this._outMessageChunks.entries()) {\n        if (this._ws.bufferedAmount != null) {\n          if (this._ws.bufferedAmount + MAX_CHUNK_LENGTH > MAX_BUFFERED_AMOUNT) {\n            log.debug('muxer send paused (websocket buffer full)', {\n              channelId,\n              bufferedAmount: this._ws.bufferedAmount,\n              pendingChannels: this._outMessageChunks.size,\n            });\n            timeout = BUFFER_FULL_BACKOFF_TIMEOUT;\n            break;\n          }\n        }\n\n        const nextMessage = messages.shift();\n        if (nextMessage) {\n          this._ws.send(nextMessage.payload);\n          nextMessage.trigger?.wake();\n        } else {\n          emptyChannels.push(channelId);\n        }\n      }\n\n      emptyChannels.forEach((channelId) => this._outMessageChunks.delete(channelId));\n\n      if (this._outMessageChunks.size > 0) {\n        this._sendTimeout = setTimeout(send, timeout);\n      } else {\n        this._sendTimeout = undefined;\n      }\n    };\n    this._sendTimeout = setTimeout(send);\n  }\n\n  private _resolveChannel(message: Message): number | undefined {\n    if (!message.serviceId) {\n      return undefined;\n    }\n    let id = this._outMessageChannelByService.get(message.serviceId);\n    if (!id) {\n      id = this._outMessageChannelByService.size + 1;\n      this._outMessageChannelByService.set(message.serviceId, id);\n    }\n    return id;\n  }\n}\n\ntype WebSocketCompat = {\n  readonly readyState: number;\n  /**\n   * Not available in workerd.\n   */\n  bufferedAmount?: number;\n  send(message: (ArrayBuffer | ArrayBufferView) | string): void;\n};\n\ntype MessageChunk = {\n  payload: Buffer;\n  /**\n   * Wakes when the payload is enqueued by WebSocket.\n   */\n  trigger?: Trigger;\n};\n\n/**\n * To avoid using isomorphic-ws on edge.\n */\nenum WebSocket {\n  CLOSING = 2,\n  CLOSED = 3,\n}\n"],"mappings":"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"}

package/dist/lib/cors-proxy.mjs

@@ -0,0 +1,29 @@
+//#region src/cors-proxy.ts
+var LEGACY_CORS_PROXY_URL = "https://cors-proxy.dxos.workers.dev";
+var EDGE_CLIENT_TAG_HEADER = "X-DXOS-Client-Tag";
+var remapAuthorizationForProxy = (headers) => {
+	const callerAuth = headers.get("Authorization");
+	if (callerAuth !== null) {
+		headers.delete("Authorization");
+		headers.set("X-Cors-Proxy-Authorization", callerAuth);
+	}
+	return headers;
+};
+/**
+* Fetch through the legacy standalone open proxy at `cors-proxy.dxos.workers.dev`.
+* TEMPORARY — delete when the authenticated `/proxy/*` route on edge ships.
+*/
+var proxyFetchLegacy = (target, init = {}, clientTag) => {
+	const proxyUrl = new URL(`/${target.host}${target.pathname}${target.search}`, LEGACY_CORS_PROXY_URL);
+	if (target.protocol === "http:") proxyUrl.searchParams.set("scheme", "http");
+	const requestHeaders = remapAuthorizationForProxy(new Headers(init.headers ?? void 0));
+	if (clientTag) requestHeaders.set(EDGE_CLIENT_TAG_HEADER, clientTag);
+	return fetch(proxyUrl, {
+		...init,
+		headers: requestHeaders
+	});
+};
+//#endregion
+export { proxyFetchLegacy };
+
+//# sourceMappingURL=cors-proxy.mjs.map

package/dist/lib/cors-proxy.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cors-proxy.mjs","names":[],"sources":["../../src/cors-proxy.ts"],"sourcesContent":["//\n// Copyright 2024 DXOS.org\n//\n\n// Lightweight CORS-proxy helpers — intentionally free of heavy transitive\n// dependencies so they can be bundled into workerd / browser environments\n// without pulling in protobufjs or similar node-only packages.\n\nconst LEGACY_CORS_PROXY_URL = 'https://cors-proxy.dxos.workers.dev';\n\n// Matches EDGE_CLIENT_TAG_HEADER from @dxos/protocols.\n// Duplicated here to avoid importing the heavy protocols bundle in edge environments.\nconst EDGE_CLIENT_TAG_HEADER = 'X-DXOS-Client-Tag';\n\nconst remapAuthorizationForProxy = (headers: Headers): Headers => {\n  const callerAuth = headers.get('Authorization');\n  if (callerAuth !== null) {\n    headers.delete('Authorization');\n    headers.set('X-Cors-Proxy-Authorization', callerAuth);\n  }\n  return headers;\n};\n\n/**\n * Fetch through the legacy standalone open proxy at `cors-proxy.dxos.workers.dev`.\n * TEMPORARY — delete when the authenticated `/proxy/*` route on edge ships.\n */\nexport const proxyFetchLegacy = (target: URL, init: RequestInit = {}, clientTag?: string): Promise<Response> => {\n  const proxyUrl = new URL(`/${target.host}${target.pathname}${target.search}`, LEGACY_CORS_PROXY_URL);\n  if (target.protocol === 'http:') {\n    proxyUrl.searchParams.set('scheme', 'http');\n  }\n  const requestHeaders = remapAuthorizationForProxy(new Headers(init.headers ?? undefined));\n  if (clientTag) {\n    requestHeaders.set(EDGE_CLIENT_TAG_HEADER, clientTag);\n  }\n  return fetch(proxyUrl, { ...init, headers: requestHeaders });\n};\n"],"mappings":";AAQA,IAAM,wBAAwB;AAI9B,IAAM,yBAAyB;AAE/B,IAAM,8BAA8B,YAA8B;CAChE,MAAM,aAAa,QAAQ,IAAI,eAAe;CAC9C,IAAI,eAAe,MAAM;EACvB,QAAQ,OAAO,eAAe;EAC9B,QAAQ,IAAI,8BAA8B,UAAU;CACtD;CACA,OAAO;AACT;;;;;AAMA,IAAa,oBAAoB,QAAa,OAAoB,CAAC,GAAG,cAA0C;CAC9G,MAAM,WAAW,IAAI,IAAI,IAAI,OAAO,OAAO,OAAO,WAAW,OAAO,UAAU,qBAAqB;CACnG,IAAI,OAAO,aAAa,SACtB,SAAS,aAAa,IAAI,UAAU,MAAM;CAE5C,MAAM,iBAAiB,2BAA2B,IAAI,QAAQ,KAAK,WAAW,KAAA,CAAS,CAAC;CACxF,IAAI,WACF,eAAe,IAAI,wBAAwB,SAAS;CAEtD,OAAO,MAAM,UAAU;EAAE,GAAG;EAAM,SAAS;CAAe,CAAC;AAC7D"}

package/dist/lib/edge-ws-muxer.mjs

@@ -0,0 +1,2 @@
+import { n as CLOUDFLARE_RPC_MAX_BYTES, r as WebSocketMuxer, t as CLOUDFLARE_MESSAGE_MAX_BYTES } from "./chunk-edge-ws-muxer.mjs";
+export { CLOUDFLARE_MESSAGE_MAX_BYTES, CLOUDFLARE_RPC_MAX_BYTES, WebSocketMuxer };