@forgeax/engine-net-websocket 0.0.0-dev.8d955ade1c79

package/dist/node.mjs

@@ -0,0 +1,409 @@
+import { EndpointError, ENDPOINT_ERROR_HINTS, ENDPOINT_EXPECTED } from '@forgeax/engine-net';
+import { ok, err } from '@forgeax/engine-types';
+import WebSocket, { WebSocketServer } from 'ws';
+
+// src/node.ts
+
+// src/event-queue.ts
+var DEFAULT_MAX_QUEUED_EVENTS = 1024;
+var BoundedEventQueue = class {
+  constructor(maxQueuedEvents) {
+    this.maxQueuedEvents = maxQueuedEvents;
+    if (!Number.isInteger(maxQueuedEvents) || maxQueuedEvents < 1) {
+      throw new RangeError("maxQueuedEvents must be a positive integer");
+    }
+  }
+  maxQueuedEvents;
+  #events = [];
+  #closed = false;
+  #disconnectReason;
+  get closed() {
+    return this.#closed;
+  }
+  get disconnectReason() {
+    return this.#disconnectReason;
+  }
+  enqueue(event) {
+    if (this.#closed) return false;
+    if (this.#events.length === this.maxQueuedEvents) {
+      this.close(`event queue overflow (maxQueuedEvents=${this.maxQueuedEvents})`);
+      return false;
+    }
+    this.#events.push(event);
+    return true;
+  }
+  close(reason) {
+    if (this.#closed) return;
+    this.#closed = true;
+    this.#disconnectReason = reason;
+  }
+  drain() {
+    return this.#events.splice(0);
+  }
+};
+var CLIENT_PEER_ID = 1;
+function createWebSocketClientEndpoint(WebSocket2, options) {
+  return new Promise((resolve) => {
+    const clientPeerId = options.peerId ?? CLIENT_PEER_ID;
+    const signal = options.signal ?? new AbortController().signal;
+    if (signal.aborted) {
+      resolve(connectionFailed(options.url, "WebSocket connection aborted."));
+      return;
+    }
+    let queue;
+    try {
+      queue = new BoundedEventQueue(options.maxQueuedEvents ?? DEFAULT_MAX_QUEUED_EVENTS);
+    } catch (cause) {
+      resolve(connectionFailed(options.url, cause));
+      return;
+    }
+    let socket;
+    try {
+      socket = new WebSocket2(options.url);
+      socket.binaryType = "arraybuffer";
+    } catch (cause) {
+      resolve(connectionFailed(options.url, cause));
+      return;
+    }
+    const terminalEvents = [];
+    let opened = false;
+    let settled = false;
+    let closed = false;
+    let locallyClosed = false;
+    let messageTail = Promise.resolve();
+    const removeAbortListener = () => {
+      signal.removeEventListener("abort", abortPendingConnection);
+    };
+    const abortPendingConnection = () => {
+      if (opened || settled) return;
+      settled = true;
+      try {
+        socket.close();
+      } catch {
+      }
+      removeAbortListener();
+      resolve(connectionFailed(options.url, "WebSocket connection aborted."));
+    };
+    signal.addEventListener("abort", abortPendingConnection, { once: true });
+    if (signal.aborted) {
+      abortPendingConnection();
+      return;
+    }
+    const disconnect = (reason) => {
+      if (closed) return;
+      closed = true;
+      queue.close(reason);
+      terminalEvents.push({ kind: "peer-disconnected", peerId: clientPeerId });
+    };
+    const endpoint = {
+      poll: () => [...queue.drain(), ...terminalEvents.splice(0)],
+      send: (peerId, data) => {
+        if (closed) return locallyClosed ? alreadyClosed() : connectionClosed(peerId);
+        if (peerId !== clientPeerId)
+          return err(
+            new EndpointError({
+              code: "peer-not-found",
+              expected: ENDPOINT_EXPECTED["peer-not-found"],
+              hint: ENDPOINT_ERROR_HINTS["peer-not-found"],
+              detail: { peerId }
+            })
+          );
+        if (socket.readyState !== socket.OPEN)
+          return err(
+            new EndpointError({
+              code: "connection-closed",
+              expected: ENDPOINT_EXPECTED["connection-closed"],
+              hint: ENDPOINT_ERROR_HINTS["connection-closed"],
+              detail: { peerId }
+            })
+          );
+        try {
+          socket.send(data);
+          return ok(void 0);
+        } catch (cause) {
+          return err(
+            new EndpointError({
+              code: "send-failed",
+              expected: ENDPOINT_EXPECTED["send-failed"],
+              hint: ENDPOINT_ERROR_HINTS["send-failed"],
+              detail: { peerId, cause: normalizeCause(cause) }
+            })
+          );
+        }
+      },
+      close: () => {
+        if (closed)
+          return err(
+            new EndpointError({
+              code: "already-closed",
+              expected: ENDPOINT_EXPECTED["already-closed"],
+              hint: ENDPOINT_ERROR_HINTS["already-closed"],
+              detail: { cause: "The WebSocket endpoint is already closed." }
+            })
+          );
+        locallyClosed = true;
+        disconnect("Endpoint close requested.");
+        socket.close();
+        return ok(void 0);
+      }
+    };
+    socket.onopen = () => {
+      if (settled) return;
+      removeAbortListener();
+      opened = true;
+      settled = true;
+      queue.enqueue({ kind: "peer-connected", peerId: clientPeerId });
+      resolve(ok(endpoint));
+    };
+    socket.onmessage = ({ data }) => {
+      messageTail = messageTail.then(async () => {
+        const bytes = await options.toBytes(data);
+        if (!bytes || closed) return;
+        if (!queue.enqueue({ kind: "message", peerId: clientPeerId, data: bytes })) {
+          socket.close();
+        }
+      }).catch(() => void 0);
+    };
+    socket.onerror = (cause) => {
+      if (opened) disconnect(`WebSocket error: ${normalizeCause(cause)}`);
+      else if (!settled) {
+        settled = true;
+        removeAbortListener();
+        resolve(connectionFailed(options.url, cause));
+      }
+    };
+    socket.onclose = (cause) => {
+      if (!opened && !settled) {
+        settled = true;
+        removeAbortListener();
+        resolve(connectionFailed(options.url, cause));
+        return;
+      }
+      disconnect(`WebSocket closed: ${normalizeCause(cause)}`);
+    };
+  });
+}
+function connectionFailed(address, cause) {
+  return err(
+    new EndpointError({
+      code: "connection-failed",
+      expected: ENDPOINT_EXPECTED["connection-failed"],
+      hint: ENDPOINT_ERROR_HINTS["connection-failed"],
+      detail: { address, cause: normalizeCause(cause) }
+    })
+  );
+}
+function alreadyClosed() {
+  return err(
+    new EndpointError({
+      code: "already-closed",
+      expected: ENDPOINT_EXPECTED["already-closed"],
+      hint: ENDPOINT_ERROR_HINTS["already-closed"],
+      detail: { cause: "The WebSocket endpoint is closed." }
+    })
+  );
+}
+function connectionClosed(peerId) {
+  return err(
+    new EndpointError({
+      code: "connection-closed",
+      expected: ENDPOINT_EXPECTED["connection-closed"],
+      hint: ENDPOINT_ERROR_HINTS["connection-closed"],
+      detail: { peerId }
+    })
+  );
+}
+function normalizeCause(cause) {
+  if (cause instanceof Error) return cause.message;
+  if (typeof cause === "string") return cause;
+  return "WebSocket operation failed without a platform error message.";
+}
+
+// src/websocket-connector.ts
+function createWebSocketConnectorAdapter(runtime, url, options = {}) {
+  let nextPeerId = 1;
+  return {
+    connect: (signal) => {
+      const peerId = nextPeerId++;
+      return createWebSocketClientEndpoint(runtime.WebSocket, {
+        url,
+        maxQueuedEvents: options.maxQueuedEvents,
+        peerId,
+        signal,
+        toBytes: runtime.toBytes
+      });
+    }
+  };
+}
+
+// src/node.ts
+function createWebSocketConnector(url, options = {}) {
+  return createWebSocketConnectorAdapter(
+    {
+      WebSocket,
+      toBytes
+    },
+    url,
+    options
+  );
+}
+function connectWebSocketClientEndpoint(url, options = {}) {
+  return createWebSocketConnector(url, options).connect(new AbortController().signal);
+}
+function listenWebSocketEndpoint(options) {
+  return new Promise((resolve) => {
+    const host = options.host ?? "127.0.0.1";
+    const address = `ws://${host}:${options.port}`;
+    let queue;
+    try {
+      queue = new BoundedEventQueue(options.maxQueuedEvents ?? DEFAULT_MAX_QUEUED_EVENTS);
+    } catch (cause) {
+      resolve(connectionFailed2(address, cause));
+      return;
+    }
+    const terminalEvents = [];
+    const peers = /* @__PURE__ */ new Map();
+    const disconnectedPeers = /* @__PURE__ */ new Set();
+    const sockets = /* @__PURE__ */ new Map();
+    const maxPeers = options.maxPeers ?? Number.POSITIVE_INFINITY;
+    let nextPeerId = 1;
+    let settled = false;
+    let closed = false;
+    const server = new WebSocketServer({ host, port: options.port, perMessageDeflate: false });
+    const endpoint = {
+      poll: () => [...queue.drain(), ...terminalEvents.splice(0)],
+      send: (peerId, data) => {
+        if (closed) return alreadyClosed2("The WebSocket listener endpoint is closed.");
+        const socket = peers.get(peerId);
+        if (!socket && disconnectedPeers.has(peerId))
+          return err(
+            new EndpointError({
+              code: "connection-closed",
+              expected: ENDPOINT_EXPECTED["connection-closed"],
+              hint: ENDPOINT_ERROR_HINTS["connection-closed"],
+              detail: { peerId }
+            })
+          );
+        if (!socket)
+          return err(
+            new EndpointError({
+              code: "peer-not-found",
+              expected: ENDPOINT_EXPECTED["peer-not-found"],
+              hint: ENDPOINT_ERROR_HINTS["peer-not-found"],
+              detail: { peerId }
+            })
+          );
+        if (socket.readyState !== socket.OPEN)
+          return err(
+            new EndpointError({
+              code: "connection-closed",
+              expected: ENDPOINT_EXPECTED["connection-closed"],
+              hint: ENDPOINT_ERROR_HINTS["connection-closed"],
+              detail: { peerId }
+            })
+          );
+        try {
+          socket.send(data, { binary: true });
+          return ok(void 0);
+        } catch (cause) {
+          return err(
+            new EndpointError({
+              code: "send-failed",
+              expected: ENDPOINT_EXPECTED["send-failed"],
+              hint: ENDPOINT_ERROR_HINTS["send-failed"],
+              detail: { peerId, cause: normalizeCause2(cause) }
+            })
+          );
+        }
+      },
+      close: () => {
+        if (closed) return alreadyClosed2("The WebSocket listener endpoint is already closed.");
+        closed = true;
+        for (const socket of peers.values()) socket.close();
+        server.close();
+        return ok(void 0);
+      }
+    };
+    const enqueue = (event, socket) => {
+      if (queue.enqueue(event)) return;
+      if (event.kind !== "peer-disconnected") {
+        terminalEvents.push({ kind: "peer-disconnected", peerId: event.peerId });
+      }
+      socket?.close();
+    };
+    server.on("connection", (socket) => {
+      if (closed || peers.size >= maxPeers) {
+        socket.close();
+        return;
+      }
+      const peerId = nextPeerId++;
+      peers.set(peerId, socket);
+      sockets.set(socket, peerId);
+      enqueue({ kind: "peer-connected", peerId }, socket);
+      socket.on("message", (data, isBinary) => {
+        if (!isBinary) {
+          socket.close();
+          return;
+        }
+        const bytes = toBytes(data);
+        if (!bytes) {
+          socket.close();
+          return;
+        }
+        enqueue({ kind: "message", peerId, data: bytes }, socket);
+      });
+      socket.on("close", () => {
+        if (!peers.delete(peerId)) return;
+        disconnectedPeers.add(peerId);
+        sockets.delete(socket);
+        enqueue({ kind: "peer-disconnected", peerId });
+      });
+      socket.on("error", () => socket.close());
+    });
+    server.on("error", (cause) => {
+      if (settled) return;
+      settled = true;
+      resolve(connectionFailed2(address, cause));
+    });
+    server.on("listening", () => {
+      if (settled) return;
+      settled = true;
+      resolve(ok(endpoint));
+    });
+  });
+}
+function toBytes(data) {
+  if (data instanceof Uint8Array)
+    return new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
+  if (data instanceof ArrayBuffer) return new Uint8Array(data);
+  return void 0;
+}
+function connectionFailed2(address, cause) {
+  return err(
+    new EndpointError({
+      code: "connection-failed",
+      expected: ENDPOINT_EXPECTED["connection-failed"],
+      hint: ENDPOINT_ERROR_HINTS["connection-failed"],
+      detail: { address, cause: normalizeCause2(cause) }
+    })
+  );
+}
+function alreadyClosed2(cause) {
+  return err(
+    new EndpointError({
+      code: "already-closed",
+      expected: ENDPOINT_EXPECTED["already-closed"],
+      hint: ENDPOINT_ERROR_HINTS["already-closed"],
+      detail: { cause }
+    })
+  );
+}
+function normalizeCause2(cause) {
+  if (cause instanceof Error) return cause.message;
+  if (typeof cause === "string") return cause;
+  return "WebSocket operation failed without a platform error message.";
+}
+
+export { connectWebSocketClientEndpoint, createWebSocketConnector, listenWebSocketEndpoint };
+//# sourceMappingURL=node.mjs.map
+//# sourceMappingURL=node.mjs.map

package/dist/node.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/event-queue.ts","../src/websocket-client-core.ts","../src/websocket-connector.ts","../src/node.ts"],"names":["WebSocket","connectionFailed","alreadyClosed","err","EndpointError","ENDPOINT_EXPECTED","ENDPOINT_ERROR_HINTS","ok","normalizeCause"],"mappings":"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","file":"node.mjs","sourcesContent":["import type { EndpointEvent } from '@forgeax/engine-net';\n\nexport const DEFAULT_MAX_QUEUED_EVENTS = 1024;\n\nexport class BoundedEventQueue {\n  readonly #events: EndpointEvent[] = [];\n  #closed = false;\n  #disconnectReason: string | undefined;\n\n  constructor(readonly maxQueuedEvents: number) {\n    if (!Number.isInteger(maxQueuedEvents) || maxQueuedEvents < 1) {\n      throw new RangeError('maxQueuedEvents must be a positive integer');\n    }\n  }\n\n  get closed(): boolean {\n    return this.#closed;\n  }\n\n  get disconnectReason(): string | undefined {\n    return this.#disconnectReason;\n  }\n\n  enqueue(event: EndpointEvent): boolean {\n    if (this.#closed) return false;\n    if (this.#events.length === this.maxQueuedEvents) {\n      this.close(`event queue overflow (maxQueuedEvents=${this.maxQueuedEvents})`);\n      return false;\n    }\n    this.#events.push(event);\n    return true;\n  }\n\n  close(reason: string): void {\n    if (this.#closed) return;\n    this.#closed = true;\n    this.#disconnectReason = reason;\n  }\n\n  drain(): EndpointEvent[] {\n    return this.#events.splice(0);\n  }\n}\n","import {\n  ENDPOINT_ERROR_HINTS,\n  ENDPOINT_EXPECTED,\n  EndpointError,\n  type EndpointEvent,\n  type NetEndpoint,\n  type PeerId,\n} from '@forgeax/engine-net';\nimport { err, ok, type Result } from '@forgeax/engine-types';\nimport { BoundedEventQueue, DEFAULT_MAX_QUEUED_EVENTS } from './event-queue';\n\nexport interface WebSocketLike {\n  readonly CONNECTING: number;\n  readonly OPEN: number;\n  readonly CLOSING: number;\n  readonly CLOSED: number;\n  readonly readyState: number;\n  binaryType?: string;\n  onopen: ((event: unknown) => void) | null;\n  onmessage: ((event: { data: unknown }) => void) | null;\n  onerror: ((event: unknown) => void) | null;\n  onclose: ((event: unknown) => void) | null;\n  send(data: Uint8Array): void;\n  close(): void;\n}\n\nexport interface WebSocketConstructor {\n  new (url: string): WebSocketLike;\n}\n\nexport interface WebSocketClientCoreOptions {\n  readonly url: string;\n  readonly maxQueuedEvents?: number | undefined;\n  readonly peerId?: PeerId;\n  readonly signal?: AbortSignal;\n  readonly toBytes: (data: unknown) => Uint8Array | Promise<Uint8Array | undefined> | undefined;\n}\n\nconst CLIENT_PEER_ID = 1 as PeerId;\n\nexport function createWebSocketClientEndpoint(\n  WebSocket: WebSocketConstructor,\n  options: WebSocketClientCoreOptions,\n): Promise<Result<NetEndpoint, EndpointError>> {\n  return new Promise((resolve) => {\n    const clientPeerId = options.peerId ?? CLIENT_PEER_ID;\n    const signal = options.signal ?? new AbortController().signal;\n    if (signal.aborted) {\n      resolve(connectionFailed(options.url, 'WebSocket connection aborted.'));\n      return;\n    }\n\n    let queue: BoundedEventQueue;\n    try {\n      queue = new BoundedEventQueue(options.maxQueuedEvents ?? DEFAULT_MAX_QUEUED_EVENTS);\n    } catch (cause) {\n      resolve(connectionFailed(options.url, cause));\n      return;\n    }\n\n    let socket: WebSocketLike;\n    try {\n      socket = new WebSocket(options.url);\n      socket.binaryType = 'arraybuffer';\n    } catch (cause) {\n      resolve(connectionFailed(options.url, cause));\n      return;\n    }\n\n    const terminalEvents: EndpointEvent[] = [];\n    let opened = false;\n    let settled = false;\n    let closed = false;\n    let locallyClosed = false;\n    let messageTail = Promise.resolve();\n\n    const removeAbortListener = (): void => {\n      signal.removeEventListener('abort', abortPendingConnection);\n    };\n\n    const abortPendingConnection = (): void => {\n      if (opened || settled) return;\n      settled = true;\n      try {\n        socket.close();\n      } catch {\n        // Closing a partially opened platform socket is best effort.\n      }\n      removeAbortListener();\n      resolve(connectionFailed(options.url, 'WebSocket connection aborted.'));\n    };\n\n    signal.addEventListener('abort', abortPendingConnection, { once: true });\n    if (signal.aborted) {\n      abortPendingConnection();\n      return;\n    }\n\n    const disconnect = (reason: string): void => {\n      if (closed) return;\n      closed = true;\n      queue.close(reason);\n      terminalEvents.push({ kind: 'peer-disconnected', peerId: clientPeerId });\n    };\n\n    const endpoint: NetEndpoint = {\n      poll: () => [...queue.drain(), ...terminalEvents.splice(0)],\n      send: (peerId, data) => {\n        if (closed) return locallyClosed ? alreadyClosed() : connectionClosed(peerId);\n        if (peerId !== clientPeerId)\n          return err(\n            new EndpointError({\n              code: 'peer-not-found',\n              expected: ENDPOINT_EXPECTED['peer-not-found'],\n              hint: ENDPOINT_ERROR_HINTS['peer-not-found'],\n              detail: { peerId },\n            }),\n          );\n        if (socket.readyState !== socket.OPEN)\n          return err(\n            new EndpointError({\n              code: 'connection-closed',\n              expected: ENDPOINT_EXPECTED['connection-closed'],\n              hint: ENDPOINT_ERROR_HINTS['connection-closed'],\n              detail: { peerId },\n            }),\n          );\n        try {\n          socket.send(data);\n          return ok(undefined);\n        } catch (cause) {\n          return err(\n            new EndpointError({\n              code: 'send-failed',\n              expected: ENDPOINT_EXPECTED['send-failed'],\n              hint: ENDPOINT_ERROR_HINTS['send-failed'],\n              detail: { peerId, cause: normalizeCause(cause) },\n            }),\n          );\n        }\n      },\n      close: () => {\n        if (closed)\n          return err(\n            new EndpointError({\n              code: 'already-closed',\n              expected: ENDPOINT_EXPECTED['already-closed'],\n              hint: ENDPOINT_ERROR_HINTS['already-closed'],\n              detail: { cause: 'The WebSocket endpoint is already closed.' },\n            }),\n          );\n        locallyClosed = true;\n        disconnect('Endpoint close requested.');\n        socket.close();\n        return ok(undefined);\n      },\n    };\n\n    socket.onopen = () => {\n      if (settled) return;\n      removeAbortListener();\n      opened = true;\n      settled = true;\n      queue.enqueue({ kind: 'peer-connected', peerId: clientPeerId });\n      resolve(ok(endpoint));\n    };\n    socket.onmessage = ({ data }) => {\n      // Blob.arrayBuffer() is asynchronous. Serialize conversion so that\n      // ordered WebSocket messages retain their wire order after decoding.\n      messageTail = messageTail\n        .then(async () => {\n          const bytes = await options.toBytes(data);\n          if (!bytes || closed) return;\n          if (!queue.enqueue({ kind: 'message', peerId: clientPeerId, data: bytes })) {\n            socket.close();\n          }\n        })\n        .catch(() => undefined);\n    };\n    socket.onerror = (cause) => {\n      if (opened) disconnect(`WebSocket error: ${normalizeCause(cause)}`);\n      else if (!settled) {\n        settled = true;\n        removeAbortListener();\n        resolve(connectionFailed(options.url, cause));\n      }\n    };\n    socket.onclose = (cause) => {\n      if (!opened && !settled) {\n        settled = true;\n        removeAbortListener();\n        resolve(connectionFailed(options.url, cause));\n        return;\n      }\n      disconnect(`WebSocket closed: ${normalizeCause(cause)}`);\n    };\n  });\n}\n\nfunction connectionFailed(address: string, cause: unknown): Result<never, EndpointError> {\n  return err(\n    new EndpointError({\n      code: 'connection-failed',\n      expected: ENDPOINT_EXPECTED['connection-failed'],\n      hint: ENDPOINT_ERROR_HINTS['connection-failed'],\n      detail: { address, cause: normalizeCause(cause) },\n    }),\n  );\n}\n\nfunction alreadyClosed(): Result<never, EndpointError> {\n  return err(\n    new EndpointError({\n      code: 'already-closed',\n      expected: ENDPOINT_EXPECTED['already-closed'],\n      hint: ENDPOINT_ERROR_HINTS['already-closed'],\n      detail: { cause: 'The WebSocket endpoint is closed.' },\n    }),\n  );\n}\n\nfunction connectionClosed(peerId: PeerId): Result<never, EndpointError> {\n  return err(\n    new EndpointError({\n      code: 'connection-closed',\n      expected: ENDPOINT_EXPECTED['connection-closed'],\n      hint: ENDPOINT_ERROR_HINTS['connection-closed'],\n      detail: { peerId },\n    }),\n  );\n}\n\nfunction normalizeCause(cause: unknown): string {\n  if (cause instanceof Error) return cause.message;\n  if (typeof cause === 'string') return cause;\n  return 'WebSocket operation failed without a platform error message.';\n}\n","import type { NetEndpointConnector, PeerId } from '@forgeax/engine-net';\nimport {\n  createWebSocketClientEndpoint,\n  type WebSocketClientCoreOptions,\n  type WebSocketConstructor,\n} from './websocket-client-core';\n\nexport interface WebSocketConnectorOptions {\n  readonly maxQueuedEvents?: number | undefined;\n}\n\nexport interface WebSocketConnectorRuntime {\n  readonly WebSocket: WebSocketConstructor;\n  readonly toBytes: WebSocketClientCoreOptions['toBytes'];\n}\n\nexport function createWebSocketConnectorAdapter(\n  runtime: WebSocketConnectorRuntime,\n  url: string,\n  options: WebSocketConnectorOptions = {},\n): NetEndpointConnector {\n  let nextPeerId = 1;\n  return {\n    connect: (signal) => {\n      const peerId = nextPeerId++ as PeerId;\n      return createWebSocketClientEndpoint(runtime.WebSocket, {\n        url,\n        maxQueuedEvents: options.maxQueuedEvents,\n        peerId,\n        signal,\n        toBytes: runtime.toBytes,\n      });\n    },\n  };\n}\n","import {\n  ENDPOINT_ERROR_HINTS,\n  ENDPOINT_EXPECTED,\n  EndpointError,\n  type EndpointEvent,\n  type NetEndpoint,\n  type PeerId,\n} from '@forgeax/engine-net';\nimport { err, ok, type Result } from '@forgeax/engine-types';\nimport WebSocket, { WebSocketServer } from 'ws';\nimport { BoundedEventQueue, DEFAULT_MAX_QUEUED_EVENTS } from './event-queue';\nimport type { WebSocketConstructor } from './websocket-client-core';\nimport { createWebSocketConnectorAdapter } from './websocket-connector';\n\nexport interface ListenWebSocketEndpointOptions {\n  readonly port: number;\n  readonly host?: string;\n  readonly maxPeers?: number;\n  readonly maxQueuedEvents?: number | undefined;\n}\n\nexport interface ConnectWebSocketClientEndpointOptions {\n  readonly maxQueuedEvents?: number | undefined;\n}\n\n/**\n * Creates the Node WebSocket adapter for the public NetEndpointConnector.\n * Each connect call accepts an AbortSignal and creates one replacement-capable\n * NetEndpoint. Transport lifecycle and EndpointError results stay here;\n * authoritative resync and replication policy stay with NetSession.\n */\nexport function createWebSocketConnector(\n  url: string,\n  options: ConnectWebSocketClientEndpointOptions = {},\n): import('@forgeax/engine-net').NetEndpointConnector {\n  return createWebSocketConnectorAdapter(\n    {\n      WebSocket: WebSocket as unknown as WebSocketConstructor,\n      toBytes,\n    },\n    url,\n    options,\n  );\n}\n\n/**\n * Connects one Node WebSocket with the default one-shot AbortSignal.\n * Use createWebSocketConnector when the caller must cancel or replace an\n * endpoint through an explicit signal.\n */\nexport function connectWebSocketClientEndpoint(\n  url: string,\n  options: ConnectWebSocketClientEndpointOptions = {},\n): Promise<Result<NetEndpoint, EndpointError>> {\n  return createWebSocketConnector(url, options).connect(new AbortController().signal);\n}\n\n/**\n * Starts a Node WebSocket listener that exposes NetEndpoint peer events and\n * binary messages without owning NetSession or replication policy.\n */\nexport function listenWebSocketEndpoint(\n  options: ListenWebSocketEndpointOptions,\n): Promise<Result<NetEndpoint, EndpointError>> {\n  return new Promise((resolve) => {\n    const host = options.host ?? '127.0.0.1';\n    const address = `ws://${host}:${options.port}`;\n    let queue: BoundedEventQueue;\n    try {\n      queue = new BoundedEventQueue(options.maxQueuedEvents ?? DEFAULT_MAX_QUEUED_EVENTS);\n    } catch (cause) {\n      resolve(connectionFailed(address, cause));\n      return;\n    }\n\n    const terminalEvents: EndpointEvent[] = [];\n    const peers = new Map<PeerId, WebSocket>();\n    const disconnectedPeers = new Set<PeerId>();\n    const sockets = new Map<WebSocket, PeerId>();\n    const maxPeers = options.maxPeers ?? Number.POSITIVE_INFINITY;\n    let nextPeerId = 1;\n    let settled = false;\n    let closed = false;\n    const server = new WebSocketServer({ host, port: options.port, perMessageDeflate: false });\n\n    const endpoint: NetEndpoint = {\n      poll: () => [...queue.drain(), ...terminalEvents.splice(0)],\n      send: (peerId, data) => {\n        if (closed) return alreadyClosed('The WebSocket listener endpoint is closed.');\n        const socket = peers.get(peerId);\n        if (!socket && disconnectedPeers.has(peerId))\n          return err(\n            new EndpointError({\n              code: 'connection-closed',\n              expected: ENDPOINT_EXPECTED['connection-closed'],\n              hint: ENDPOINT_ERROR_HINTS['connection-closed'],\n              detail: { peerId },\n            }),\n          );\n        if (!socket)\n          return err(\n            new EndpointError({\n              code: 'peer-not-found',\n              expected: ENDPOINT_EXPECTED['peer-not-found'],\n              hint: ENDPOINT_ERROR_HINTS['peer-not-found'],\n              detail: { peerId },\n            }),\n          );\n        if (socket.readyState !== socket.OPEN)\n          return err(\n            new EndpointError({\n              code: 'connection-closed',\n              expected: ENDPOINT_EXPECTED['connection-closed'],\n              hint: ENDPOINT_ERROR_HINTS['connection-closed'],\n              detail: { peerId },\n            }),\n          );\n        try {\n          socket.send(data, { binary: true });\n          return ok(undefined);\n        } catch (cause) {\n          return err(\n            new EndpointError({\n              code: 'send-failed',\n              expected: ENDPOINT_EXPECTED['send-failed'],\n              hint: ENDPOINT_ERROR_HINTS['send-failed'],\n              detail: { peerId, cause: normalizeCause(cause) },\n            }),\n          );\n        }\n      },\n      close: () => {\n        if (closed) return alreadyClosed('The WebSocket listener endpoint is already closed.');\n        closed = true;\n        for (const socket of peers.values()) socket.close();\n        server.close();\n        return ok(undefined);\n      },\n    };\n\n    const enqueue = (event: EndpointEvent, socket?: WebSocket): void => {\n      if (queue.enqueue(event)) return;\n      if (event.kind !== 'peer-disconnected') {\n        terminalEvents.push({ kind: 'peer-disconnected', peerId: event.peerId });\n      }\n      socket?.close();\n    };\n\n    server.on('connection', (socket) => {\n      if (closed || peers.size >= maxPeers) {\n        socket.close();\n        return;\n      }\n      const peerId = nextPeerId++ as PeerId;\n      peers.set(peerId, socket);\n      sockets.set(socket, peerId);\n      enqueue({ kind: 'peer-connected', peerId }, socket);\n      socket.on('message', (data, isBinary) => {\n        if (!isBinary) {\n          socket.close();\n          return;\n        }\n        const bytes = toBytes(data);\n        if (!bytes) {\n          socket.close();\n          return;\n        }\n        enqueue({ kind: 'message', peerId, data: bytes }, socket);\n      });\n      socket.on('close', () => {\n        if (!peers.delete(peerId)) return;\n        disconnectedPeers.add(peerId);\n        sockets.delete(socket);\n        enqueue({ kind: 'peer-disconnected', peerId });\n      });\n      socket.on('error', () => socket.close());\n    });\n    server.on('error', (cause) => {\n      if (settled) return;\n      settled = true;\n      resolve(connectionFailed(address, cause));\n    });\n    server.on('listening', () => {\n      if (settled) return;\n      settled = true;\n      resolve(ok(endpoint));\n    });\n  });\n}\n\nfunction toBytes(data: unknown): Uint8Array | undefined {\n  if (data instanceof Uint8Array)\n    return new Uint8Array(data.buffer, data.byteOffset, data.byteLength);\n  if (data instanceof ArrayBuffer) return new Uint8Array(data);\n  return undefined;\n}\n\nfunction connectionFailed(address: string, cause: unknown): Result<never, EndpointError> {\n  return err(\n    new EndpointError({\n      code: 'connection-failed',\n      expected: ENDPOINT_EXPECTED['connection-failed'],\n      hint: ENDPOINT_ERROR_HINTS['connection-failed'],\n      detail: { address, cause: normalizeCause(cause) },\n    }),\n  );\n}\n\nfunction alreadyClosed(cause: string): Result<never, EndpointError> {\n  return err(\n    new EndpointError({\n      code: 'already-closed',\n      expected: ENDPOINT_EXPECTED['already-closed'],\n      hint: ENDPOINT_ERROR_HINTS['already-closed'],\n      detail: { cause },\n    }),\n  );\n}\n\nfunction normalizeCause(cause: unknown): string {\n  if (cause instanceof Error) return cause.message;\n  if (typeof cause === 'string') return cause;\n  return 'WebSocket operation failed without a platform error message.';\n}\n"]}

package/dist/websocket-client-core.d.ts

@@ -0,0 +1,30 @@
+import { EndpointError, type NetEndpoint, type PeerId } from '@forgeax/engine-net';
+import { type Result } from '@forgeax/engine-types';
+export interface WebSocketLike {
+    readonly CONNECTING: number;
+    readonly OPEN: number;
+    readonly CLOSING: number;
+    readonly CLOSED: number;
+    readonly readyState: number;
+    binaryType?: string;
+    onopen: ((event: unknown) => void) | null;
+    onmessage: ((event: {
+        data: unknown;
+    }) => void) | null;
+    onerror: ((event: unknown) => void) | null;
+    onclose: ((event: unknown) => void) | null;
+    send(data: Uint8Array): void;
+    close(): void;
+}
+export interface WebSocketConstructor {
+    new (url: string): WebSocketLike;
+}
+export interface WebSocketClientCoreOptions {
+    readonly url: string;
+    readonly maxQueuedEvents?: number | undefined;
+    readonly peerId?: PeerId;
+    readonly signal?: AbortSignal;
+    readonly toBytes: (data: unknown) => Uint8Array | Promise<Uint8Array | undefined> | undefined;
+}
+export declare function createWebSocketClientEndpoint(WebSocket: WebSocketConstructor, options: WebSocketClientCoreOptions): Promise<Result<NetEndpoint, EndpointError>>;
+//# sourceMappingURL=websocket-client-core.d.ts.map

package/dist/websocket-client-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-client-core.d.ts","sourceRoot":"","sources":["../src/websocket-client-core.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,aAAa,EAEb,KAAK,WAAW,EAChB,KAAK,MAAM,EACZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAG7D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1C,SAAS,EAAE,CAAC,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACvD,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3C,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3C,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IAC7B,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,GAAG,EAAE,MAAM,GAAG,aAAa,CAAC;CAClC;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,UAAU,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;CAC/F;AAID,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,oBAAoB,EAC/B,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC,CA0J7C"}

package/dist/websocket-connector.d.ts

@@ -0,0 +1,11 @@
+import type { NetEndpointConnector } from '@forgeax/engine-net';
+import { type WebSocketClientCoreOptions, type WebSocketConstructor } from './websocket-client-core';
+export interface WebSocketConnectorOptions {
+    readonly maxQueuedEvents?: number | undefined;
+}
+export interface WebSocketConnectorRuntime {
+    readonly WebSocket: WebSocketConstructor;
+    readonly toBytes: WebSocketClientCoreOptions['toBytes'];
+}
+export declare function createWebSocketConnectorAdapter(runtime: WebSocketConnectorRuntime, url: string, options?: WebSocketConnectorOptions): NetEndpointConnector;
+//# sourceMappingURL=websocket-connector.d.ts.map

package/dist/websocket-connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-connector.d.ts","sourceRoot":"","sources":["../src/websocket-connector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAU,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAEL,KAAK,0BAA0B,EAC/B,KAAK,oBAAoB,EAC1B,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/C;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,0BAA0B,CAAC,SAAS,CAAC,CAAC;CACzD;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,yBAAyB,EAClC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,yBAA8B,GACtC,oBAAoB,CActB"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@forgeax/engine-net-websocket",
+  "version": "0.0.0-dev.8d955ade1c79",
+  "private": false,
+  "type": "module",
+  "license": "Apache-2.0",
+  "sideEffects": false,
+  "description": "WebSocket transport adapters for the forgeax NetEndpoint contract.",
+  "exports": {
+    "./browser": {
+      "types": "./dist/browser.d.ts",
+      "import": "./dist/browser.mjs"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "node": "./dist/node.mjs",
+      "default": null
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "forgeax": {
+    "metrics": {
+      "bundle-size": {
+        "enabled": true,
+        "path": "dist/browser.mjs",
+        "compression": "gzip"
+      },
+      "fps": {
+        "enabled": false,
+        "reason": "library package, no canvas"
+      },
+      "bench": {
+        "enabled": false,
+        "reason": "no performance benchmarks"
+      },
+      "gate": {
+        "enabled": true,
+        "command": "pnpm -F @forgeax/engine-net-websocket test"
+      },
+      "spike-report": {
+        "enabled": false,
+        "reason": "not a spike package"
+      }
+    }
+  },
+  "dependencies": {
+    "@forgeax/engine-net": "0.0.0-dev.8d955ade1c79",
+    "@forgeax/engine-types": "0.0.0-dev.8d955ade1c79",
+    "ws": "^8.20.0"
+  },
+  "devDependencies": {
+    "@types/ws": "^8.5.10"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run"
+  }
+}

package/src/browser.ts

@@ -0,0 +1,48 @@
+import type { EndpointError, NetEndpoint, NetEndpointConnector } from '@forgeax/engine-net';
+import type { Result } from '@forgeax/engine-types';
+import type { WebSocketConstructor } from './websocket-client-core';
+import {
+  createWebSocketConnectorAdapter,
+  type WebSocketConnectorOptions,
+} from './websocket-connector';
+
+export interface ConnectWebSocketClientEndpointOptions {
+  readonly maxQueuedEvents?: number | undefined;
+}
+
+/**
+ * Creates the browser WebSocket adapter for the public NetEndpointConnector.
+ * Each connect call accepts an AbortSignal and creates one replacement-capable
+ * NetEndpoint. Transport lifecycle and EndpointError results stay here;
+ * authoritative resync and replication policy stay with NetSession.
+ */
+export function createWebSocketConnector(
+  url: string,
+  options: WebSocketConnectorOptions = {},
+): NetEndpointConnector {
+  return createWebSocketConnectorAdapter(
+    { WebSocket: WebSocket as unknown as WebSocketConstructor, toBytes },
+    url,
+    options,
+  );
+}
+
+/**
+ * Connects one browser WebSocket with the default one-shot AbortSignal.
+ * Use createWebSocketConnector when the caller must cancel or replace an
+ * endpoint through an explicit signal.
+ */
+export function connectWebSocketClientEndpoint(
+  url: string,
+  options: ConnectWebSocketClientEndpointOptions = {},
+): Promise<Result<NetEndpoint, EndpointError>> {
+  return createWebSocketConnector(url, options).connect(new AbortController().signal);
+}
+
+function toBytes(data: unknown): Uint8Array | Promise<Uint8Array | undefined> | undefined {
+  if (data instanceof ArrayBuffer) return new Uint8Array(data);
+  if (typeof Blob !== 'undefined' && data instanceof Blob) {
+    return data.arrayBuffer().then((buffer) => new Uint8Array(buffer));
+  }
+  return undefined;
+}