@nx.js/ws 0.0.1

package/README.md

@@ -0,0 +1,55 @@
+# `@nx.js/ws`
+
+WebSocket server for [nx.js](https://nxjs.n8.io).
+
+Provides a `WebSocketServer` class inspired by the [`ws`](https://github.com/websockets/ws) npm package, but using the Web `EventTarget` API instead of Node.js `EventEmitter`.
+
+## Usage
+
+```typescript
+import { WebSocketServer } from '@nx.js/ws';
+
+const wss = new WebSocketServer({ port: 8080 });
+
+wss.addEventListener('listening', () => {
+  console.log('WebSocket server is listening on port 8080');
+});
+
+wss.addEventListener('connection', (e) => {
+  const { socket, request } = e.detail;
+  console.log('Client connected');
+
+  socket.addEventListener('message', (ev) => {
+    console.log('Received:', ev.data);
+    socket.send(`Echo: ${ev.data}`);
+  });
+
+  socket.addEventListener('close', (ev) => {
+    console.log('Client disconnected', ev.code, ev.reason);
+  });
+});
+```
+
+## API
+
+### `WebSocketServer`
+
+- **Constructor:** `new WebSocketServer({ port, host? })`
+- **Events:** `connection`, `listening`, `close`, `error`
+- **Properties:** `clients` (Set of connected `ServerWebSocket` instances)
+- **Methods:** `close()`, `address()`
+
+### `ServerWebSocket`
+
+- **Events:** `open`, `message`, `close`, `error`
+- **Properties:** `readyState`, `bufferedAmount`, `binaryType`, `url`, `protocol`, `extensions`
+- **Methods:** `send(data)`, `close(code?, reason?)`
+
+## Protocol Compliance
+
+- Implements RFC 6455 WebSocket protocol
+- Server frames are NOT masked (per spec)
+- Client frames MUST be masked (validated; connection closed with 1002 if not)
+- Handles ping/pong automatically
+- Supports fragmented messages
+- Supports text and binary frames

package/dist/frame.d.ts

@@ -0,0 +1,131 @@
+/**
+ * WebSocket protocol constants and frame utilities per RFC 6455.
+ *
+ * Shared between the client ({@link WebSocket}) and
+ * server ({@link WebSocketServer}) implementations.
+ *
+ * @module
+ */
+/** Continuation frame. */
+export declare const OP_CONTINUATION = 0;
+/** Text data frame. */
+export declare const OP_TEXT = 1;
+/** Binary data frame. */
+export declare const OP_BINARY = 2;
+/** Connection close frame. */
+export declare const OP_CLOSE = 8;
+/** Ping frame. */
+export declare const OP_PING = 9;
+/** Pong frame. */
+export declare const OP_PONG = 10;
+/** The connection has not yet been established. */
+export declare const CONNECTING = 0;
+/** The connection is established and communication is possible. */
+export declare const OPEN = 1;
+/** The connection is going through the closing handshake. */
+export declare const CLOSING = 2;
+/** The connection has been closed or could not be opened. */
+export declare const CLOSED = 3;
+/**
+ * Parsed WebSocket frame header.
+ */
+export interface FrameHeader {
+    /** Whether this is the final fragment. */
+    fin: boolean;
+    /** The frame opcode. */
+    opcode: number;
+    /** Whether the payload is masked. */
+    masked: boolean;
+    /** The length of the payload in bytes. */
+    payloadLength: number;
+    /** The 4-byte mask key, or `null` if not masked. */
+    maskKey: Uint8Array | null;
+    /** The total size of the header in bytes (including mask key). */
+    headerSize: number;
+}
+/**
+ * Parse a WebSocket frame header from raw bytes.
+ *
+ * Returns `null` if the buffer does not contain enough data
+ * for a complete header.
+ */
+export declare function parseFrameHeader(data: Uint8Array): FrameHeader | null;
+/**
+ * XOR-mask (or unmask) a payload with a 4-byte mask key.
+ */
+export declare function maskData(data: Uint8Array, maskKey: Uint8Array): Uint8Array;
+/**
+ * Build a WebSocket frame.
+ *
+ * @param opcode - The frame opcode.
+ * @param payload - The payload data.
+ * @param mask - Whether to mask the payload (required for client-to-server frames).
+ */
+export declare function buildFrame(opcode: number, payload: Uint8Array, mask: boolean): Uint8Array;
+/**
+ * Encode a close frame payload from a code and optional reason.
+ */
+export declare function encodeClosePayload(code?: number, reason?: string): Uint8Array;
+/**
+ * Decode a close frame payload into a code and reason string.
+ */
+export declare function decodeClosePayload(payload: Uint8Array): {
+    code: number;
+    reason: string;
+};
+/**
+ * Concatenate two `Uint8Array`s.
+ */
+export declare function concat(a: Uint8Array, b: Uint8Array): Uint8Array;
+/**
+ * The WebSocket magic GUID used in the opening handshake (RFC 6455 Section 4.2.2).
+ */
+export declare const WS_MAGIC = "258EAFA5-E914-47DA-95CA-C5AB0DC85B11";
+/**
+ * Compute the `Sec-WebSocket-Accept` header value for a given key.
+ *
+ * Used by the server to generate the response, and by the client to validate it.
+ */
+export declare function computeAcceptKey(key: string): Promise<string>;
+/**
+ * Well-known symbol used to signal the internal constructor path.
+ * Using `Symbol.for` ensures it's the same symbol across all bundles
+ * (the runtime bundle and user app bundles share the global symbol registry).
+ */
+export declare const INTERNAL_SYMBOL: unique symbol;
+/**
+ * Initialization options for creating a server-side WebSocket.
+ */
+export interface WebSocketInit {
+    /** The writable stream writer for sending frames. */
+    writer: WritableStreamDefaultWriter<Uint8Array>;
+    /** The readable stream reader for receiving frames. */
+    reader: ReadableStreamDefaultReader<Uint8Array>;
+    /** The URL of the WebSocket connection. */
+    url: string;
+    /** The negotiated sub-protocol. */
+    protocol: string;
+    /** The negotiated extensions. */
+    extensions: string;
+    /** Any leftover bytes from the HTTP upgrade that belong to the WebSocket stream. */
+    initialBuffer: Uint8Array;
+    /** Whether to mask outgoing frames (true for client, false for server). */
+    mask: boolean;
+    /** Whether to require incoming frames to be masked (true for server). */
+    requireMask: boolean;
+    /** Called when the WebSocket is cleaned up (e.g. to close the underlying TCP socket). */
+    onCleanup?: () => void;
+}
+/**
+ * Create a pre-connected WebSocket instance for server-side use.
+ *
+ * The returned instance is a real `WebSocket` object (passes `instanceof`)
+ * with its read loop already started. Server frames are NOT masked.
+ *
+ * Uses `globalThis.WebSocket` with the well-known `INTERNAL_SYMBOL` to
+ * trigger the internal constructor path, avoiding any cross-bundle
+ * registration issues.
+ *
+ * @internal
+ */
+export declare function createWebSocket(init: WebSocketInit): WebSocket;

package/dist/frame.js

@@ -0,0 +1,195 @@
+/**
+ * WebSocket protocol constants and frame utilities per RFC 6455.
+ *
+ * Shared between the client ({@link WebSocket}) and
+ * server ({@link WebSocketServer}) implementations.
+ *
+ * @module
+ */
+const encoder = new TextEncoder();
+const decoder = new TextDecoder();
+// ---- Opcodes ----
+/** Continuation frame. */
+export const OP_CONTINUATION = 0x0;
+/** Text data frame. */
+export const OP_TEXT = 0x1;
+/** Binary data frame. */
+export const OP_BINARY = 0x2;
+/** Connection close frame. */
+export const OP_CLOSE = 0x8;
+/** Ping frame. */
+export const OP_PING = 0x9;
+/** Pong frame. */
+export const OP_PONG = 0xa;
+// ---- Ready states ----
+/** The connection has not yet been established. */
+export const CONNECTING = 0;
+/** The connection is established and communication is possible. */
+export const OPEN = 1;
+/** The connection is going through the closing handshake. */
+export const CLOSING = 2;
+/** The connection has been closed or could not be opened. */
+export const CLOSED = 3;
+/**
+ * Parse a WebSocket frame header from raw bytes.
+ *
+ * Returns `null` if the buffer does not contain enough data
+ * for a complete header.
+ */
+export function parseFrameHeader(data) {
+    if (data.length < 2)
+        return null;
+    const fin = !!(data[0] & 0x80);
+    const opcode = data[0] & 0x0f;
+    const masked = !!(data[1] & 0x80);
+    let payloadLength = data[1] & 0x7f;
+    let offset = 2;
+    if (payloadLength === 126) {
+        if (data.length < 4)
+            return null;
+        payloadLength = (data[2] << 8) | data[3];
+        offset = 4;
+    }
+    else if (payloadLength === 127) {
+        if (data.length < 10)
+            return null;
+        const view = new DataView(data.buffer, data.byteOffset);
+        payloadLength = Number(view.getBigUint64(2));
+        offset = 10;
+    }
+    let maskKey = null;
+    if (masked) {
+        if (data.length < offset + 4)
+            return null;
+        maskKey = data.slice(offset, offset + 4);
+        offset += 4;
+    }
+    return { fin, opcode, masked, payloadLength, maskKey, headerSize: offset };
+}
+// ---- Frame building ----
+/**
+ * XOR-mask (or unmask) a payload with a 4-byte mask key.
+ */
+export function maskData(data, maskKey) {
+    const result = new Uint8Array(data.length);
+    for (let i = 0; i < data.length; i++) {
+        result[i] = data[i] ^ maskKey[i & 3];
+    }
+    return result;
+}
+/**
+ * Build a WebSocket frame.
+ *
+ * @param opcode - The frame opcode.
+ * @param payload - The payload data.
+ * @param mask - Whether to mask the payload (required for client-to-server frames).
+ */
+export function buildFrame(opcode, payload, mask) {
+    let headerLen = 2;
+    if (payload.length > 65535)
+        headerLen += 8;
+    else if (payload.length > 125)
+        headerLen += 2;
+    const maskKeyLen = mask ? 4 : 0;
+    const frame = new Uint8Array(headerLen + maskKeyLen + payload.length);
+    frame[0] = 0x80 | opcode; // FIN + opcode
+    let offset = 1;
+    const maskBit = mask ? 0x80 : 0;
+    if (payload.length > 65535) {
+        frame[offset++] = maskBit | 127;
+        const view = new DataView(frame.buffer);
+        view.setBigUint64(offset, BigInt(payload.length));
+        offset += 8;
+    }
+    else if (payload.length > 125) {
+        frame[offset++] = maskBit | 126;
+        frame[offset++] = (payload.length >> 8) & 0xff;
+        frame[offset++] = payload.length & 0xff;
+    }
+    else {
+        frame[offset++] = maskBit | payload.length;
+    }
+    if (mask) {
+        const maskKey = new Uint8Array(4);
+        crypto.getRandomValues(maskKey);
+        frame.set(maskKey, offset);
+        offset += 4;
+        const masked = maskData(payload, maskKey);
+        frame.set(masked, offset);
+    }
+    else {
+        frame.set(payload, offset);
+    }
+    return frame;
+}
+// ---- Close frame helpers ----
+/**
+ * Encode a close frame payload from a code and optional reason.
+ */
+export function encodeClosePayload(code, reason) {
+    if (code === undefined)
+        return new Uint8Array(0);
+    const reasonBytes = reason ? encoder.encode(reason) : new Uint8Array(0);
+    const payload = new Uint8Array(2 + reasonBytes.length);
+    payload[0] = (code >> 8) & 0xff;
+    payload[1] = code & 0xff;
+    payload.set(reasonBytes, 2);
+    return payload;
+}
+/**
+ * Decode a close frame payload into a code and reason string.
+ */
+export function decodeClosePayload(payload) {
+    if (payload.length < 2)
+        return { code: 1005, reason: '' };
+    const code = (payload[0] << 8) | payload[1];
+    const reason = payload.length > 2 ? decoder.decode(payload.slice(2)) : '';
+    return { code, reason };
+}
+// ---- Utilities ----
+/**
+ * Concatenate two `Uint8Array`s.
+ */
+export function concat(a, b) {
+    const c = new Uint8Array(a.length + b.length);
+    c.set(a, 0);
+    c.set(b, a.length);
+    return c;
+}
+/**
+ * The WebSocket magic GUID used in the opening handshake (RFC 6455 Section 4.2.2).
+ */
+export const WS_MAGIC = '258EAFA5-E914-47DA-95CA-C5AB0DC85B11';
+/**
+ * Compute the `Sec-WebSocket-Accept` header value for a given key.
+ *
+ * Used by the server to generate the response, and by the client to validate it.
+ */
+export async function computeAcceptKey(key) {
+    const data = encoder.encode(key + WS_MAGIC);
+    const hash = await crypto.subtle.digest('SHA-1', data);
+    return new Uint8Array(hash).toBase64();
+}
+// ---- Server-side WebSocket creation ----
+/**
+ * Well-known symbol used to signal the internal constructor path.
+ * Using `Symbol.for` ensures it's the same symbol across all bundles
+ * (the runtime bundle and user app bundles share the global symbol registry).
+ */
+export const INTERNAL_SYMBOL = Symbol.for('nx.ws.internal');
+/**
+ * Create a pre-connected WebSocket instance for server-side use.
+ *
+ * The returned instance is a real `WebSocket` object (passes `instanceof`)
+ * with its read loop already started. Server frames are NOT masked.
+ *
+ * Uses `globalThis.WebSocket` with the well-known `INTERNAL_SYMBOL` to
+ * trigger the internal constructor path, avoiding any cross-bundle
+ * registration issues.
+ *
+ * @internal
+ */
+export function createWebSocket(init) {
+    return new globalThis.WebSocket(INTERNAL_SYMBOL, init);
+}
+//# sourceMappingURL=frame.js.map

package/dist/frame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.js","sourceRoot":"","sources":["../src/frame.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export type { ConnectionEventDetail, WebSocketServerOptions } from './server';
+export { WebSocketServer } from './server';

package/dist/index.js

@@ -0,0 +1,2 @@
+export { WebSocketServer } from './server';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,54 @@
+export interface WebSocketServerOptions {
+    /** Port to listen on. */
+    port: number;
+    /** IP address to bind to (defaults to `0.0.0.0`). */
+    host?: string;
+}
+export interface ConnectionEventDetail {
+    /** The connected WebSocket. */
+    socket: WebSocket;
+    /** The original HTTP upgrade request. */
+    request: Request;
+}
+/**
+ * A WebSocket server that listens for incoming connections on a TCP port.
+ *
+ * Uses the Web `EventTarget` API and dispatches `CustomEvent` instances.
+ *
+ * @example
+ * ```typescript
+ * import { WebSocketServer } from '@nx.js/ws';
+ *
+ * const wss = new WebSocketServer({ port: 8080 });
+ *
+ * wss.addEventListener('connection', (e) => {
+ *   const { socket, request } = e.detail;
+ *   console.log('Client connected from', request.url);
+ *
+ *   socket.addEventListener('message', (ev) => {
+ *     console.log('Received:', ev.data);
+ *     socket.send(`Echo: ${ev.data}`);
+ *   });
+ *
+ *   socket.addEventListener('close', () => {
+ *     console.log('Client disconnected');
+ *   });
+ * });
+ * ```
+ */
+export declare class WebSocketServer extends EventTarget {
+    #private;
+    readonly clients: Set<WebSocket>;
+    constructor(opts: WebSocketServerOptions);
+    /**
+     * Returns the address the server is listening on.
+     */
+    address(): {
+        port: number;
+        host: string;
+    } | null;
+    /**
+     * Close the server and all connected clients.
+     */
+    close(): void;
+}

package/dist/server.js

@@ -0,0 +1,157 @@
+import { computeAcceptKey, concat, createWebSocket } from './frame';
+const encoder = new TextEncoder();
+const decoder = new TextDecoder();
+/**
+ * A WebSocket server that listens for incoming connections on a TCP port.
+ *
+ * Uses the Web `EventTarget` API and dispatches `CustomEvent` instances.
+ *
+ * @example
+ * ```typescript
+ * import { WebSocketServer } from '@nx.js/ws';
+ *
+ * const wss = new WebSocketServer({ port: 8080 });
+ *
+ * wss.addEventListener('connection', (e) => {
+ *   const { socket, request } = e.detail;
+ *   console.log('Client connected from', request.url);
+ *
+ *   socket.addEventListener('message', (ev) => {
+ *     console.log('Received:', ev.data);
+ *     socket.send(`Echo: ${ev.data}`);
+ *   });
+ *
+ *   socket.addEventListener('close', () => {
+ *     console.log('Client disconnected');
+ *   });
+ * });
+ * ```
+ */
+export class WebSocketServer extends EventTarget {
+    clients = new Set();
+    #server;
+    constructor(opts) {
+        super();
+        const { port, host } = opts;
+        this.#server = Switch.listen({
+            port,
+            ip: host,
+            accept: (event) => {
+                this.#handleConnection(event.socket);
+            },
+        });
+        // Dispatch listening event on next microtask
+        queueMicrotask(() => {
+            this.dispatchEvent(new Event('listening'));
+        });
+    }
+    /**
+     * Returns the address the server is listening on.
+     */
+    address() {
+        return null;
+    }
+    /**
+     * Close the server and all connected clients.
+     */
+    close() {
+        for (const client of this.clients) {
+            client.close(1001, 'Server shutting down');
+        }
+        this.clients.clear();
+        this.#server.close();
+        this.dispatchEvent(new Event('close'));
+    }
+    async #handleConnection(socket) {
+        try {
+            const reader = socket.readable.getReader();
+            let buffer = new Uint8Array(0);
+            // Read headers until we find \r\n\r\n
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    return;
+                buffer = concat(buffer, value);
+                const headerEnd = findHeaderEnd(buffer);
+                if (headerEnd !== -1) {
+                    const headerBytes = buffer.slice(0, headerEnd);
+                    const remaining = buffer.slice(headerEnd + 4);
+                    reader.releaseLock();
+                    const headerStr = decoder.decode(headerBytes);
+                    const lines = headerStr.split('\r\n');
+                    const [method, path] = lines[0].split(' ');
+                    const headers = new Headers();
+                    for (let i = 1; i < lines.length; i++) {
+                        const col = lines[i].indexOf(':');
+                        if (col !== -1) {
+                            headers.set(lines[i].slice(0, col), lines[i].slice(col + 1).trim());
+                        }
+                    }
+                    const host = headers.get('host') || 'localhost';
+                    const request = new Request(`http://${host}${path}`, {
+                        method,
+                        headers,
+                    });
+                    // Validate WebSocket upgrade
+                    const upgrade = headers.get('upgrade');
+                    const key = headers.get('sec-websocket-key');
+                    if (!upgrade || upgrade.toLowerCase() !== 'websocket' || !key) {
+                        const writer = socket.writable.getWriter();
+                        await writer.write(encoder.encode('HTTP/1.1 400 Bad Request\r\nConnection: close\r\n\r\n'));
+                        await writer.close();
+                        return;
+                    }
+                    // Compute accept key
+                    const acceptKey = await computeAcceptKey(key);
+                    // Send 101 Switching Protocols
+                    const writer = socket.writable.getWriter();
+                    const responseHeaders = [
+                        'HTTP/1.1 101 Switching Protocols',
+                        'Upgrade: websocket',
+                        'Connection: Upgrade',
+                        `Sec-WebSocket-Accept: ${acceptKey}`,
+                        '',
+                        '',
+                    ].join('\r\n');
+                    await writer.write(encoder.encode(responseHeaders));
+                    writer.releaseLock();
+                    // Create a real WebSocket instance via the factory
+                    const ws = createWebSocket({
+                        writer: socket.writable.getWriter(),
+                        reader: socket.readable.getReader(),
+                        url: `ws://${host}${path}`,
+                        protocol: '',
+                        extensions: '',
+                        initialBuffer: remaining,
+                        mask: false,
+                        requireMask: true,
+                        onCleanup: () => socket.close(),
+                    });
+                    this.clients.add(ws);
+                    ws.addEventListener('close', () => {
+                        this.clients.delete(ws);
+                    });
+                    this.dispatchEvent(new CustomEvent('connection', {
+                        detail: { socket: ws, request },
+                    }));
+                    return;
+                }
+            }
+        }
+        catch (err) {
+            this.dispatchEvent(new CustomEvent('error', { detail: err }));
+        }
+    }
+}
+function findHeaderEnd(data) {
+    for (let i = 0; i < data.length - 3; i++) {
+        if (data[i] === 13 &&
+            data[i + 1] === 10 &&
+            data[i + 2] === 13 &&
+            data[i + 3] === 10) {
+            return i;
+        }
+    }
+    return -1;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/websocket.d.ts

@@ -0,0 +1,46 @@
+export interface WebSocketEventMap {
+    open: Event;
+    message: MessageEvent;
+    close: CloseEvent;
+    error: Event;
+}
+/**
+ * Server-side WebSocket connection.
+ *
+ * Uses the Web `EventTarget` API (not Node.js `EventEmitter`).
+ * Server frames are NOT masked per RFC 6455.
+ */
+export declare class ServerWebSocket extends EventTarget {
+    #private;
+    static readonly CONNECTING = 0;
+    static readonly OPEN = 1;
+    static readonly CLOSING = 2;
+    static readonly CLOSED = 3;
+    readonly CONNECTING = 0;
+    readonly OPEN = 1;
+    readonly CLOSING = 2;
+    readonly CLOSED = 3;
+    /** The URL of the connection (from the HTTP upgrade request). */
+    readonly url: string;
+    /** The protocol negotiated during the handshake. */
+    readonly protocol: string;
+    /** The extensions negotiated during the handshake. */
+    readonly extensions: string;
+    constructor(writer: WritableStreamDefaultWriter<Uint8Array>, url: string, protocol?: string, extensions?: string);
+    get readyState(): number;
+    get bufferedAmount(): number;
+    get binaryType(): BinaryType;
+    set binaryType(value: BinaryType);
+    /** @internal Mark the socket as open and dispatch the `open` event. */
+    _open(): void;
+    /**
+     * Send data over the WebSocket connection.
+     */
+    send(data: string | ArrayBufferLike | Blob | ArrayBufferView): void;
+    /**
+     * Initiate the closing handshake.
+     */
+    close(code?: number, reason?: string): void;
+    /** @internal Process an incoming frame. */
+    _handleFrame(opcode: number, fin: boolean, payload: Uint8Array): void;
+}

package/dist/websocket.js

@@ -0,0 +1,167 @@
+import { buildFrame, CLOSED, CLOSING, CONNECTING, decodeClosePayload, encodeClosePayload, OP_BINARY, OP_CLOSE, OP_CONTINUATION, OP_PING, OP_PONG, OP_TEXT, OPEN, } from './frame';
+const encoder = new TextEncoder();
+const decoder = new TextDecoder();
+/**
+ * Server-side WebSocket connection.
+ *
+ * Uses the Web `EventTarget` API (not Node.js `EventEmitter`).
+ * Server frames are NOT masked per RFC 6455.
+ */
+export class ServerWebSocket extends EventTarget {
+    static CONNECTING = CONNECTING;
+    static OPEN = OPEN;
+    static CLOSING = CLOSING;
+    static CLOSED = CLOSED;
+    CONNECTING = CONNECTING;
+    OPEN = OPEN;
+    CLOSING = CLOSING;
+    CLOSED = CLOSED;
+    #readyState = CONNECTING;
+    #writer;
+    #binaryType = 'blob';
+    #bufferedAmount = 0;
+    #fragments = [];
+    #fragmentOpcode = null;
+    /** The URL of the connection (from the HTTP upgrade request). */
+    url;
+    /** The protocol negotiated during the handshake. */
+    protocol;
+    /** The extensions negotiated during the handshake. */
+    extensions;
+    constructor(writer, url, protocol = '', extensions = '') {
+        super();
+        this.#writer = writer;
+        this.url = url;
+        this.protocol = protocol;
+        this.extensions = extensions;
+    }
+    get readyState() {
+        return this.#readyState;
+    }
+    get bufferedAmount() {
+        return this.#bufferedAmount;
+    }
+    get binaryType() {
+        return this.#binaryType;
+    }
+    set binaryType(value) {
+        if (value !== 'blob' && value !== 'arraybuffer') {
+            throw new SyntaxError(`Invalid binaryType: ${value}`);
+        }
+        this.#binaryType = value;
+    }
+    /** @internal Mark the socket as open and dispatch the `open` event. */
+    _open() {
+        this.#readyState = OPEN;
+        this.dispatchEvent(new Event('open'));
+    }
+    /**
+     * Send data over the WebSocket connection.
+     */
+    send(data) {
+        if (this.#readyState !== OPEN) {
+            throw new DOMException('WebSocket is not open', 'InvalidStateError');
+        }
+        let payload;
+        let opcode;
+        if (typeof data === 'string') {
+            payload = encoder.encode(data);
+            opcode = OP_TEXT;
+        }
+        else if (data instanceof ArrayBuffer ||
+            data instanceof SharedArrayBuffer) {
+            payload = new Uint8Array(data);
+            opcode = OP_BINARY;
+        }
+        else if (ArrayBuffer.isView(data)) {
+            payload = new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
+            opcode = OP_BINARY;
+        }
+        else {
+            throw new TypeError('Blob send is not supported; convert to ArrayBuffer first');
+        }
+        // Server frames are NOT masked
+        const frame = buildFrame(opcode, payload, false);
+        this.#bufferedAmount += frame.length;
+        this.#writer.write(frame).then(() => {
+            this.#bufferedAmount -= frame.length;
+        });
+    }
+    /**
+     * Initiate the closing handshake.
+     */
+    close(code, reason) {
+        if (this.#readyState === CLOSING || this.#readyState === CLOSED) {
+            return;
+        }
+        this.#readyState = CLOSING;
+        const payload = encodeClosePayload(code, reason);
+        const frame = buildFrame(OP_CLOSE, payload, false);
+        this.#writer.write(frame);
+    }
+    /** @internal Process an incoming frame. */
+    _handleFrame(opcode, fin, payload) {
+        switch (opcode) {
+            case OP_TEXT:
+            case OP_BINARY: {
+                if (!fin) {
+                    this.#fragmentOpcode = opcode;
+                    this.#fragments.push(payload);
+                    return;
+                }
+                this.#dispatchMessage(opcode, payload);
+                break;
+            }
+            case OP_CONTINUATION: {
+                this.#fragments.push(payload);
+                if (fin) {
+                    const totalLen = this.#fragments.reduce((s, f) => s + f.length, 0);
+                    const assembled = new Uint8Array(totalLen);
+                    let offset = 0;
+                    for (const frag of this.#fragments) {
+                        assembled.set(frag, offset);
+                        offset += frag.length;
+                    }
+                    const msgOpcode = this.#fragmentOpcode;
+                    this.#fragments = [];
+                    this.#fragmentOpcode = null;
+                    this.#dispatchMessage(msgOpcode, assembled);
+                }
+                break;
+            }
+            case OP_PING: {
+                const pong = buildFrame(OP_PONG, payload, false);
+                this.#writer.write(pong);
+                break;
+            }
+            case OP_PONG:
+                break;
+            case OP_CLOSE: {
+                const { code, reason } = decodeClosePayload(payload);
+                if (this.#readyState === OPEN) {
+                    const closeFrame = buildFrame(OP_CLOSE, payload, false);
+                    this.#writer.write(closeFrame);
+                }
+                this.#readyState = CLOSED;
+                this.#writer.close().catch(() => { });
+                this.dispatchEvent(new CloseEvent('close', {
+                    code,
+                    reason,
+                    wasClean: true,
+                }));
+                break;
+            }
+        }
+    }
+    #dispatchMessage(opcode, payload) {
+        let data;
+        if (opcode === OP_TEXT) {
+            data = decoder.decode(payload);
+        }
+        else {
+            data = payload.buffer.slice(payload.byteOffset, payload.byteOffset + payload.byteLength);
+        }
+        this.dispatchEvent(new MessageEvent('message', { data }));
+    }
+}
+//# sourceMappingURL=websocket.js.map

package/dist/websocket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.js","sourceRoot":"","sources":["../src/websocket.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@nx.js/ws",
+  "version": "0.0.1",
+  "description": "WebSocket server for nx.js",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/TooTallNate/nx.js.git",
+    "directory": "packages/ws"
+  },
+  "homepage": "https://nxjs.n8.io/ws",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./frame": {
+      "types": "./dist/frame.d.ts",
+      "default": "./dist/frame.js"
+    }
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "frame": [
+        "dist/frame.d.ts"
+      ]
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "docs": "typedoc && ../../type-aliases-meta.sh"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "nx.js",
+    "switch",
+    "websocket",
+    "server",
+    "ws"
+  ],
+  "author": "Nathan Rajlich <n@n8.io>",
+  "license": "MIT"
+}