vortez 5.0.2 → 6.0.0-dev.1

package/build/server/websocket/frame/Header.d.ts

@@ -0,0 +1,31 @@
+export declare class Header implements Header.Header {
+    fin: boolean;
+    rsv: Header.Rsv;
+    opcode: number;
+    mask: boolean;
+    size: number | bigint;
+    maskKeys: Buffer | null;
+    headerSize: number;
+    constructor(data: Header.Header);
+    /**
+     * Reads the first complete frame header from a buffer and returns it.
+     * @throws `RangeError` If the buffer does not contain a complete frame header.
+     *
+     * Note: This method does not validate the frame header beyond checking for completeness.
+     * It assumes that the buffer starts with a valid frame header.
+     */
+    static fromBuffer(buffer: Buffer): Header;
+}
+export declare namespace Header {
+    type Rsv = [rsv1: boolean, rsv2: boolean, rsv3: boolean];
+    interface Header {
+        fin: boolean;
+        rsv: Rsv;
+        opcode: number;
+        mask: boolean;
+        size: number | bigint;
+        maskKeys: Buffer | null;
+        headerSize: number;
+    }
+}
+export default Header;

package/build/server/websocket/frame/Header.js

@@ -0,0 +1,31 @@
+import HeaderParser from "./HeaderParser.js";
+export class Header {
+    fin;
+    rsv;
+    opcode;
+    mask;
+    size;
+    maskKeys;
+    headerSize;
+    constructor(data) {
+        this.fin = data.fin;
+        this.rsv = data.rsv;
+        this.opcode = data.opcode;
+        this.mask = data.mask;
+        this.size = data.size;
+        this.maskKeys = data.maskKeys;
+        this.headerSize = data.headerSize;
+    }
+    /**
+     * Reads the first complete frame header from a buffer and returns it.
+     * @throws `RangeError` If the buffer does not contain a complete frame header.
+     *
+     * Note: This method does not validate the frame header beyond checking for completeness.
+     * It assumes that the buffer starts with a valid frame header.
+     */
+    static fromBuffer(buffer) {
+        return HeaderParser.header(buffer);
+    }
+}
+export default Header;
+//# sourceMappingURL=Header.js.map

package/build/server/websocket/frame/Header.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Header.js","sourceRoot":"","sources":["../../../../src/server/websocket/frame/Header.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,mBAAmB,CAAC;AAE7C,MAAM,OAAO,MAAM;IACR,GAAG,CAAU;IACb,GAAG,CAAa;IAChB,MAAM,CAAS;IACf,IAAI,CAAU;IACd,IAAI,CAAkB;IACtB,QAAQ,CAAgB;IACxB,UAAU,CAAS;IAC1B,YAAmB,IAAmB;QAClC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACpB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACpB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;IACtC,CAAC;IACD;;;;;;OAMG;IACI,MAAM,CAAC,UAAU,CAAC,MAAc;QACnC,OAAO,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;CACJ;AAaD,eAAe,MAAM,CAAC"}

package/build/server/websocket/frame/HeaderParser.d.ts

@@ -0,0 +1,58 @@
+import Header from "./Header.js";
+export declare class HeaderParser {
+    /**
+     * Reads the first complete frame header from a buffer and returns it.
+     * @throws `RangeError` If the buffer does not contain a complete frame header.
+     *
+     * Note: This method does not validate the frame header beyond checking for completeness.
+     * It assumes that the buffer starts with a valid frame header.
+     */
+    static header(buffer: Buffer): Header;
+    /**
+     * Extracts the FIN bit from the first byte of the frame header.
+     *
+     * @param buffer - The buffer containing the frame header (must be at least 1 byte long).
+     * @returns - `true` if the FIN bit is set, otherwise `false`.
+     */
+    static fin(buffer: Buffer): boolean;
+    static rsv(buffer: Buffer): Header.Rsv;
+    /**
+     * Extracts the OpCode from the first byte of the frame header.
+     *
+     * @param buffer - The buffer containing the frame header (must be at least 1 byte long).
+     * @returns - The OpCode as a number (0-15).
+     *
+     * @remarks The OpCode is located in the least significant 4 bits of the first byte of the frame header.
+     */
+    static opCode(buffer: Buffer): number;
+    /**
+     * Extracts the Mask bit from the second byte of the frame header.
+     *
+     * @param buffer - The buffer containing the frame header (must be at least 2 bytes long).
+     * @returns - `true` if the Mask bit is set, otherwise `false`.
+     *
+     * @remarks The Mask bit is located in the most significant bit (bit 7) of the second byte of the frame header.
+     */
+    static mask(buffer: Buffer): boolean;
+    /**
+     * Extracts the Payload Length from the second byte of the frame header.
+     *
+     * @param buffer - The buffer containing the frame header (must be at least 2 bytes long).
+     * @returns - The Payload Length as a number (0-125) or bigint (for extended payload lengths).
+     */
+    static payloadLen(buffer: Buffer): number | bigint;
+    /**
+     * Extracts the Masking Keys from the frame header if the Mask bit is set.
+     *
+     * @param buffer - The buffer containing the frame header (must be long enough to contain the masking keys if the Mask bit is set).
+     * @param mask - A boolean indicating whether the Mask bit is set.
+     * @param offset - The byte offset in the buffer where the masking keys start (typically 2 for non-extended payloads, 4 for 16-bit extended payloads, and 10 for 64-bit extended payloads).
+     * @returns - A Buffer containing the 4 bytes of masking keys if the Mask bit is set, otherwise `null`.
+      *
+      * @remarks The masking keys are located immediately after the payload length field in the frame header if the Mask bit is set. The offset parameter should be calculated based on the presence of extended payload length fields.
+      * For example, if the payload length is 126 (indicating a 16-bit extended payload length), the masking keys would start at byte offset 4. If the payload length is 127 (indicating a 64-bit extended payload length), the masking keys would start at byte offset 10.
+      */
+    static maskKeys(buffer: Buffer, mask: boolean, offset: number): Buffer | null;
+}
+export declare namespace HeaderParser { }
+export default HeaderParser;

package/build/server/websocket/frame/HeaderParser.js

@@ -0,0 +1,109 @@
+import Header from "./Header.js";
+export class HeaderParser {
+    /**
+     * Reads the first complete frame header from a buffer and returns it.
+     * @throws `RangeError` If the buffer does not contain a complete frame header.
+     *
+     * Note: This method does not validate the frame header beyond checking for completeness.
+     * It assumes that the buffer starts with a valid frame header.
+     */
+    static header(buffer) {
+        if (buffer.length < 2)
+            throw new RangeError('Frame header requires at least 2 bytes');
+        const fin = this.fin(buffer);
+        const rsv = this.rsv(buffer);
+        const opCode = this.opCode(buffer);
+        const mask = this.mask(buffer);
+        let size = this.payloadLen(buffer);
+        let maskKeys = null;
+        let headerSize = 2;
+        if (size === 0x7e) {
+            if (buffer.length < 4)
+                throw new RangeError('Frame requires 2 bytes for extended size');
+            size = buffer.readUint16BE(2);
+            headerSize = mask ? 8 : 4;
+            if (buffer.length < headerSize)
+                throw new RangeError('Frame header is incomplete');
+            maskKeys = mask ? this.maskKeys(buffer, mask, 4) : null;
+        }
+        else if (size === 0x7f) {
+            if (buffer.length < 10)
+                throw new RangeError('Frame requires 8 bytes for extended size');
+            size = buffer.readBigUint64BE(2);
+            headerSize = mask ? 14 : 10;
+            if (buffer.length < headerSize)
+                throw new RangeError('Frame header is incomplete');
+            maskKeys = mask ? this.maskKeys(buffer, mask, 10) : null;
+        }
+        else {
+            headerSize = mask ? 6 : 2;
+            if (buffer.length < headerSize)
+                throw new RangeError('Frame header is incomplete');
+            maskKeys = mask ? this.maskKeys(buffer, mask, 2) : null;
+        }
+        return new Header({ fin, rsv, opcode: opCode, mask, size, maskKeys, headerSize });
+    }
+    /**
+     * Extracts the FIN bit from the first byte of the frame header.
+     *
+     * @param buffer - The buffer containing the frame header (must be at least 1 byte long).
+     * @returns - `true` if the FIN bit is set, otherwise `false`.
+     */
+    static fin(buffer) {
+        return Boolean((buffer[0] >>> 0x7) & 0x01);
+    }
+    static rsv(buffer) {
+        return [
+            Boolean((buffer[0] >>> 0x6) & 0x01),
+            Boolean((buffer[0] >>> 0x5) & 0x01),
+            Boolean((buffer[0] >>> 0x4) & 0x01)
+        ];
+    }
+    /**
+     * Extracts the OpCode from the first byte of the frame header.
+     *
+     * @param buffer - The buffer containing the frame header (must be at least 1 byte long).
+     * @returns - The OpCode as a number (0-15).
+     *
+     * @remarks The OpCode is located in the least significant 4 bits of the first byte of the frame header.
+     */
+    static opCode(buffer) {
+        return buffer[0] & 0x0f;
+    }
+    /**
+     * Extracts the Mask bit from the second byte of the frame header.
+     *
+     * @param buffer - The buffer containing the frame header (must be at least 2 bytes long).
+     * @returns - `true` if the Mask bit is set, otherwise `false`.
+     *
+     * @remarks The Mask bit is located in the most significant bit (bit 7) of the second byte of the frame header.
+     */
+    static mask(buffer) {
+        return Boolean((buffer[1] >>> 0x7) & 0x01);
+    }
+    /**
+     * Extracts the Payload Length from the second byte of the frame header.
+     *
+     * @param buffer - The buffer containing the frame header (must be at least 2 bytes long).
+     * @returns - The Payload Length as a number (0-125) or bigint (for extended payload lengths).
+     */
+    static payloadLen(buffer) {
+        return buffer[1] & 0x7f;
+    }
+    /**
+     * Extracts the Masking Keys from the frame header if the Mask bit is set.
+     *
+     * @param buffer - The buffer containing the frame header (must be long enough to contain the masking keys if the Mask bit is set).
+     * @param mask - A boolean indicating whether the Mask bit is set.
+     * @param offset - The byte offset in the buffer where the masking keys start (typically 2 for non-extended payloads, 4 for 16-bit extended payloads, and 10 for 64-bit extended payloads).
+     * @returns - A Buffer containing the 4 bytes of masking keys if the Mask bit is set, otherwise `null`.
+      *
+      * @remarks The masking keys are located immediately after the payload length field in the frame header if the Mask bit is set. The offset parameter should be calculated based on the presence of extended payload length fields.
+      * For example, if the payload length is 126 (indicating a 16-bit extended payload length), the masking keys would start at byte offset 4. If the payload length is 127 (indicating a 64-bit extended payload length), the masking keys would start at byte offset 10.
+      */
+    static maskKeys(buffer, mask, offset) {
+        return mask ? buffer.subarray(offset, offset + 4) : null;
+    }
+}
+export default HeaderParser;
+//# sourceMappingURL=HeaderParser.js.map

package/build/server/websocket/frame/HeaderParser.js.map

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

package/build/server/websocket/handshake/CSHandshaker.d.ts

@@ -0,0 +1,46 @@
+import { Duplex } from 'stream';
+import { IncomingHttpHeaders } from 'http';
+import { Events } from '@netfeez/common';
+export declare class CSHandShaker extends Events<CSHandShaker.EventMap> {
+    private readonly socket;
+    private readonly host;
+    private readonly path;
+    private secWebSocketKey;
+    constructor(socket: Duplex, host: string, path?: string);
+    /**
+     * Initiates the WebSocket handshake process by sending a properly formatted HTTP request to the server and setting up a data handler to process the server's response.
+     * This method will emit a 'finish' event with the status of the handshake ('open' if successful, 'closed' if failed) once the server's response has been processed, or an 'error' event if any issues occur during the handshake process.
+     *
+     * @remarks The handshake process involves sending an HTTP GET request with the necessary headers to request an upgrade to a WebSocket connection. The method also sets up a data handler to listen for the server's response, which will determine whether the handshake was successful based on the status code and headers received. Proper error handling is implemented to ensure that any issues during the handshake are appropriately emitted as events for further handling by the caller.
+     */
+    start(): void;
+    /**
+     * Generates an DataHandler function for processing the server's response to the WebSocket handshake request. This handler will parse the HTTP response from the server, extract the status code and headers, and emit a 'response' event with this information for further processing by the caller.
+     * @param emitter - An event emitter to emit the 'response' event with the parsed status code and headers.
+     * @param parent - The instance of CSHandShaker that will emit any errors encountered during the parsing process.
+     * @returns A function that can be used as a data handler for the socket's 'data' event to process the server's handshake response.
+     */
+    private static getDataHandler;
+    /**
+     * Generates the HTTP request message for initiating the WebSocket handshake with the server.
+     * This method constructs a valid HTTP GET request with the necessary headers to request an upgrade to a WebSocket connection, including a randomly generated Sec-WebSocket-Key and the appropriate Upgrade and Connection headers.
+     * @param host - The host and port of the server to which the handshake request will be sent (e.g., "example.com:8080").
+     * @param path - The path on the server for the WebSocket endpoint (default is "/").
+     */
+    private static requestMessage;
+    /**
+     * Computes the expected Sec-WebSocket-Accept value for a given key.
+     */
+    private static computeAcceptKey;
+}
+export declare namespace CSHandShaker {
+    type Status = 'handshake' | 'open' | 'closed';
+    type EventMap = {
+        finish: [status: CSHandShaker.Status];
+        error: [error: Error];
+    };
+    type ServerSocketEventMap = {
+        response: [status: number, headers: IncomingHttpHeaders];
+    };
+}
+export default CSHandShaker;

package/build/server/websocket/handshake/CSHandshaker.js

@@ -0,0 +1,122 @@
+import { createHash, randomBytes } from 'crypto';
+import { Events } from '@netfeez/common';
+export class CSHandShaker extends Events {
+    socket;
+    host;
+    path;
+    secWebSocketKey;
+    constructor(socket, host, path = '/') {
+        super();
+        this.socket = socket;
+        this.host = host;
+        this.path = path;
+        this.secWebSocketKey = randomBytes(16).toString('base64');
+    }
+    /**
+     * Initiates the WebSocket handshake process by sending a properly formatted HTTP request to the server and setting up a data handler to process the server's response.
+     * This method will emit a 'finish' event with the status of the handshake ('open' if successful, 'closed' if failed) once the server's response has been processed, or an 'error' event if any issues occur during the handshake process.
+     *
+     * @remarks The handshake process involves sending an HTTP GET request with the necessary headers to request an upgrade to a WebSocket connection. The method also sets up a data handler to listen for the server's response, which will determine whether the handshake was successful based on the status code and headers received. Proper error handling is implemented to ensure that any issues during the handshake are appropriately emitted as events for further handling by the caller.
+     */
+    start() {
+        try {
+            const request = CSHandShaker.requestMessage(this.host, this.path, this.secWebSocketKey);
+            const emitter = new Events.Emitter();
+            const handler = CSHandShaker.getDataHandler(emitter, this);
+            this.socket.on('data', handler);
+            emitter.once('response', (status, headers) => {
+                this.socket.off('data', handler);
+                if (status === 101) {
+                    const accept = headers['sec-websocket-accept'];
+                    const expected = CSHandShaker.computeAcceptKey(this.secWebSocketKey);
+                    if (accept !== expected) {
+                        this.emit('error', new Error('Invalid Sec-WebSocket-Accept header in handshake'));
+                        setImmediate(() => this.emit('finish', 'closed'));
+                        return;
+                    }
+                    setImmediate(() => this.emit('finish', 'open'));
+                }
+                else {
+                    setImmediate(() => this.emit('finish', 'closed'));
+                }
+            });
+            this.socket.write(request);
+        }
+        catch (error) {
+            this.emit('error', error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /**
+     * Generates an DataHandler function for processing the server's response to the WebSocket handshake request. This handler will parse the HTTP response from the server, extract the status code and headers, and emit a 'response' event with this information for further processing by the caller.
+     * @param emitter - An event emitter to emit the 'response' event with the parsed status code and headers.
+     * @param parent - The instance of CSHandShaker that will emit any errors encountered during the parsing process.
+     * @returns A function that can be used as a data handler for the socket's 'data' event to process the server's handshake response.
+     */
+    static getDataHandler(emitter, parent) {
+        let buffer = Buffer.alloc(0);
+        return (data) => {
+            try {
+                buffer = Buffer.concat([buffer, data]);
+                const index = buffer.indexOf('\r\n\r\n');
+                if (index === -1)
+                    return;
+                const headerBuffer = buffer.subarray(0, index);
+                const leftovers = buffer.subarray(index + 4);
+                if (leftovers.length > 0) {
+                    parent.socket.unshift(leftovers);
+                }
+                const header = headerBuffer.toString('utf-8');
+                const headerLines = header.split('\r\n');
+                const statusLine = headerLines[0];
+                const statusMatch = statusLine.match(/^HTTP\/\d\.\d (\d{3})/);
+                if (!statusMatch) {
+                    emitter.emit('response', 0, {});
+                    parent.emit('error', new Error('Invalid handshake response from server'));
+                    return;
+                }
+                const statusCode = parseInt(statusMatch[1], 10);
+                const headers = {};
+                for (let i = 1; i < headerLines.length; i++) {
+                    const line = headerLines[i];
+                    const [key, value] = line.split(':').map(s => s.trim());
+                    headers[key.toLowerCase()] = value;
+                }
+                emitter.emit('response', statusCode, headers);
+            }
+            catch (error) {
+                parent.emit('error', error instanceof Error ? error : new Error(String(error)));
+            }
+        };
+    }
+    /**
+     * Generates the HTTP request message for initiating the WebSocket handshake with the server.
+     * This method constructs a valid HTTP GET request with the necessary headers to request an upgrade to a WebSocket connection, including a randomly generated Sec-WebSocket-Key and the appropriate Upgrade and Connection headers.
+     * @param host - The host and port of the server to which the handshake request will be sent (e.g., "example.com:8080").
+     * @param path - The path on the server for the WebSocket endpoint (default is "/").
+     */
+    static requestMessage(host, path = '/', secWebSocketKey) {
+        path = encodeURIComponent(path);
+        path = path.replace(/%2F/g, '/');
+        path = path.replace(/^\/?/, '/');
+        return [
+            `GET ${path} HTTP/1.1`,
+            `Host: ${host}`,
+            'Upgrade: websocket',
+            'Connection: Upgrade',
+            `Sec-WebSocket-Key: ${secWebSocketKey}`,
+            'Sec-WebSocket-Version: 13',
+            ''
+        ].join('\r\n');
+    }
+    /**
+     * Computes the expected Sec-WebSocket-Accept value for a given key.
+     */
+    static computeAcceptKey(secWebSocketKey) {
+        const GUID = '258EAFA5-E914-47DA-95CA-C5AB0DC85B11';
+        return createHash('sha1')
+            .update(secWebSocketKey + GUID)
+            .digest('base64');
+    }
+}
+export default CSHandShaker;
+//# sourceMappingURL=CSHandshaker.js.map

package/build/server/websocket/handshake/CSHandshaker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CSHandshaker.js","sourceRoot":"","sources":["../../../../src/server/websocket/handshake/CSHandshaker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAIjD,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,MAAM,OAAO,YAAa,SAAQ,MAA6B;IAGtC;IACA;IACA;IAJb,eAAe,CAAS;IAChC,YACqB,MAAc,EACd,IAAY,EACZ,OAAe,GAAG;QACnC,KAAK,EAAE,CAAC;QAHS,WAAM,GAAN,MAAM,CAAQ;QACd,SAAI,GAAJ,IAAI,CAAQ;QACZ,SAAI,GAAJ,IAAI,CAAc;QAEnC,IAAI,CAAC,eAAe,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC9D,CAAC;IACD;;;;;OAKG;IACI,KAAK;QACR,IAAI,CAAC;YAED,MAAM,OAAO,GAAG,YAAY,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;YAExF,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,OAAO,EAAqC,CAAC;YACxE,MAAM,OAAO,GAAG,YAAY,CAAC,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAC3D,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAChC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE;gBACzC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBACjC,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;oBACjB,MAAM,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;oBAC/C,MAAM,QAAQ,GAAG,YAAY,CAAC,gBAAgB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;oBACrE,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;wBACtB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC,CAAC;wBAClF,YAAY,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;wBAClD,OAAO;oBACX,CAAC;oBACD,YAAY,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;gBACpD,CAAC;qBAAM,CAAC;oBACJ,YAAY,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;gBACtD,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAClF,CAAC;IACL,CAAC;IACD;;;;;OAKG;IACK,MAAM,CAAC,cAAc,CACzB,OAA0D,EAC1D,MAAoB;QAEpB,IAAI,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC7B,OAAO,CAAC,IAAY,EAAQ,EAAE;YAC1B,IAAI,CAAC;gBACD,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;gBACvC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;gBACzC,IAAI,KAAK,KAAK,CAAC,CAAC;oBAAE,OAAO;gBAEzB,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;gBAC/C,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;gBAE7C,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;gBAAC,CAAC;gBAE/D,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBAC9C,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBACzC,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;gBAClC,MAAM,WAAW,GAAG,UAAU,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;gBAC9D,IAAI,CAAC,WAAW,EAAE,CAAC;oBACf,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;oBAChC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC,CAAC;oBAC1E,OAAO;gBACX,CAAC;gBACD,MAAM,UAAU,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAChD,MAAM,OAAO,GAAwB,EAAE,CAAC;gBACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBAC1C,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;oBAC5B,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;oBACxD,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,GAAG,KAAK,CAAC;gBACvC,CAAC;gBACD,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;YAClD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACpF,CAAC;QACL,CAAC,CAAC;IACN,CAAC;IACD;;;;;OAKG;IACK,MAAM,CAAC,cAAc,CAAC,IAAY,EAAE,OAAe,GAAG,EAAE,eAAuB;QACnF,IAAI,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACjC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACjC,OAAO;YACH,OAAO,IAAI,WAAW;YACtB,SAAS,IAAI,EAAE;YACf,oBAAoB;YACpB,qBAAqB;YACrB,sBAAsB,eAAe,EAAE;YACvC,2BAA2B;YAC3B,EAAE;SACL,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnB,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,gBAAgB,CAAC,eAAuB;QACnD,MAAM,IAAI,GAAG,sCAAsC,CAAC;QACpD,OAAO,UAAU,CAAC,MAAM,CAAC;aACpB,MAAM,CAAC,eAAe,GAAG,IAAI,CAAC;aAC9B,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC1B,CAAC;CACJ;AAWD,eAAe,YAAY,CAAC"}

package/build/server/websocket/handshake/SSHandshaker.d.ts

@@ -0,0 +1,57 @@
+import { Duplex } from 'stream';
+import { Events } from '@netfeez/common';
+import Request from '../../Request.js';
+export declare class SSHandshaker extends Events<SSHandshaker.EventMap> {
+    private readonly socket;
+    private readonly Request;
+    static readonly WEBSOCKET_GUID = "258EAFA5-E914-47DA-95CA-C5AB0DC85B11";
+    vStatus: SSHandshaker.Status;
+    constructor(socket: Duplex, Request: Request);
+    /**
+     * Accepts the WebSocket handshake by validating the client's request and sending the appropriate HTTP response to establish the WebSocket connection. This method should be called after verifying that the client's handshake request is valid and meets the necessary criteria for accepting the connection.
+      * - It generates the Sec-WebSocket-Accept key based on the client's Sec-WebSocket-Key and constructs the HTTP response with the required headers to complete the handshake.
+      * - After sending the response, it updates the internal status to 'open' and emits a 'finish' event with the new status.
+      *
+      * @throws Will throw an error if the client's handshake request does not contain a valid Sec-WebSocket-Key or if any other issue occurs during the acceptance process. The error will be emitted as an 'error' event for handling by the caller.
+      */
+    accept(): void;
+    /**
+     * Rejects the WebSocket handshake by sending an HTTP response with the specified status code and reason, and then closes the connection.
+     * @param code - The HTTP status code to indicate the reason for rejection (e.g., 400 for Bad Request).
+     * @param reason - A human-readable string explaining the reason for rejection.
+     *
+     * @remarks The generated response will have a JSON body containing the provided code and reason, and will include any specified cookies in the headers. This response can be sent back to the client to indicate that the handshake request was rejected, along with the reason for rejection.
+     */
+    reject(code?: number, reason?: string): void;
+    /**
+     * Generates the Sec-WebSocket-Accept key for the server handshake response based on the client's Sec-WebSocket-Key.
+     * @param key - The Sec-WebSocket-Key received from the client during the handshake request.
+     * @returns The computed Sec-WebSocket-Accept key to be sent in the handshake response.
+     */
+    static generateAcceptKey(key: string): string;
+    /**
+     * Generates an HTTP response message to accept a WebSocket handshake request with the appropriate headers.
+     * @param key - The Sec-WebSocket-Key received from the client during the handshake request.
+     * @param cookies - Optional cookies to be included in the response.
+     * @returns A complete HTTP response message as a string to be sent back to the client.
+     */
+    private static acceptMessage;
+    /**
+     * Generates an HTTP response message to reject a WebSocket handshake request with a specific status code and reason.
+     * @param code - The HTTP status code to indicate the reason for rejection (e.g., 400 for Bad Request).
+     * @param reason - A human-readable string explaining the reason for rejection.
+     * @param cookies - Optional cookies to be included in the response.
+     * @returns A complete HTTP response message as a string to be sent back to the client.
+     *
+     * @remarks The generated response will have a JSON body containing the provided code and reason, and will include any specified cookies in the headers. This response can be sent back to the client to indicate that the handshake request was rejected, along with the reason for rejection.
+     */
+    private static rejectMessage;
+}
+export declare namespace SSHandshaker {
+    type Status = 'handshake' | 'open' | 'closed';
+    type EventMap = {
+        finish: [status: SSHandshaker.Status];
+        error: [error: Error];
+    };
+}
+export default SSHandshaker;

package/build/server/websocket/handshake/SSHandshaker.js

@@ -0,0 +1,113 @@
+import CRYPTO from 'crypto';
+import { Events } from '@netfeez/common';
+export class SSHandshaker extends Events {
+    socket;
+    Request;
+    static WEBSOCKET_GUID = '258EAFA5-E914-47DA-95CA-C5AB0DC85B11';
+    vStatus = 'handshake';
+    constructor(socket, Request) {
+        super();
+        this.socket = socket;
+        this.Request = Request;
+    }
+    /**
+     * Accepts the WebSocket handshake by validating the client's request and sending the appropriate HTTP response to establish the WebSocket connection. This method should be called after verifying that the client's handshake request is valid and meets the necessary criteria for accepting the connection.
+      * - It generates the Sec-WebSocket-Accept key based on the client's Sec-WebSocket-Key and constructs the HTTP response with the required headers to complete the handshake.
+      * - After sending the response, it updates the internal status to 'open' and emits a 'finish' event with the new status.
+      *
+      * @throws Will throw an error if the client's handshake request does not contain a valid Sec-WebSocket-Key or if any other issue occurs during the acceptance process. The error will be emitted as an 'error' event for handling by the caller.
+      */
+    accept() {
+        try {
+            const key = this.Request.headers['sec-websocket-key'];
+            if (!key)
+                throw new Error('Server handshake requires a key');
+            const response = SSHandshaker.acceptMessage(key, this.Request.cookies);
+            this.socket.write(response);
+            this.vStatus = 'open';
+        }
+        catch (error) {
+            this.vStatus = 'closed';
+            this.emit('error', error instanceof Error ? error : new Error(String(error)));
+        }
+        finally {
+            setImmediate(() => this.emit('finish', this.vStatus));
+        }
+    }
+    /**
+     * Rejects the WebSocket handshake by sending an HTTP response with the specified status code and reason, and then closes the connection.
+     * @param code - The HTTP status code to indicate the reason for rejection (e.g., 400 for Bad Request).
+     * @param reason - A human-readable string explaining the reason for rejection.
+     *
+     * @remarks The generated response will have a JSON body containing the provided code and reason, and will include any specified cookies in the headers. This response can be sent back to the client to indicate that the handshake request was rejected, along with the reason for rejection.
+     */
+    reject(code = 400, reason = 'Bad Request') {
+        try {
+            const response = SSHandshaker.rejectMessage(code, reason, this.Request.cookies);
+            this.socket.write(response);
+            this.socket.end();
+            this.vStatus = 'closed';
+        }
+        catch (error) {
+            this.emit('error', error instanceof Error ? error : new Error(String(error)));
+        }
+        finally {
+            setImmediate(() => this.emit('finish', this.vStatus));
+        }
+    }
+    /**
+     * Generates the Sec-WebSocket-Accept key for the server handshake response based on the client's Sec-WebSocket-Key.
+     * @param key - The Sec-WebSocket-Key received from the client during the handshake request.
+     * @returns The computed Sec-WebSocket-Accept key to be sent in the handshake response.
+     */
+    static generateAcceptKey(key) {
+        return CRYPTO.createHash('sha1')
+            .update(key + SSHandshaker.WEBSOCKET_GUID)
+            .digest('base64');
+    }
+    /**
+     * Generates an HTTP response message to accept a WebSocket handshake request with the appropriate headers.
+     * @param key - The Sec-WebSocket-Key received from the client during the handshake request.
+     * @param cookies - Optional cookies to be included in the response.
+     * @returns A complete HTTP response message as a string to be sent back to the client.
+     */
+    static acceptMessage(key, cookies) {
+        const acceptKey = SSHandshaker.generateAcceptKey(key);
+        const setters = cookies
+            ? cookies.setters.map((setter) => `Set-Cookie: ${setter}`)
+            : [];
+        return [
+            'HTTP/1.1 101 Switching Protocols',
+            'Upgrade: websocket',
+            'Connection: Upgrade',
+            `Sec-WebSocket-Accept: ${acceptKey}`,
+            ...setters,
+            '\r\n'
+        ].join('\r\n');
+    }
+    /**
+     * Generates an HTTP response message to reject a WebSocket handshake request with a specific status code and reason.
+     * @param code - The HTTP status code to indicate the reason for rejection (e.g., 400 for Bad Request).
+     * @param reason - A human-readable string explaining the reason for rejection.
+     * @param cookies - Optional cookies to be included in the response.
+     * @returns A complete HTTP response message as a string to be sent back to the client.
+     *
+     * @remarks The generated response will have a JSON body containing the provided code and reason, and will include any specified cookies in the headers. This response can be sent back to the client to indicate that the handshake request was rejected, along with the reason for rejection.
+     */
+    static rejectMessage(code, reason, cookies) {
+        const body = JSON.stringify({ code, reason }, null, 4);
+        const setters = cookies
+            ? cookies.setters.map((setter) => `Set-Cookie: ${setter}`)
+            : [];
+        return [
+            'HTTP/1.1 400 Bad Request',
+            'Content-Type: application/json',
+            `Content-Length: ${Buffer.byteLength(body)}`,
+            ...setters,
+            '\r\n',
+            body
+        ].join('\r\n');
+    }
+}
+export default SSHandshaker;
+//# sourceMappingURL=SSHandshaker.js.map

package/build/server/websocket/handshake/SSHandshaker.js.map

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

package/build/server/websocket/messageAssembler/Message.d.ts

@@ -0,0 +1,21 @@
+import type Frame from '../frame/Frame.js';
+export declare class Message {
+    readonly frames: Frame[];
+    readonly opcode: number;
+    readonly payload: Buffer;
+    constructor(frames: Frame[]);
+    get isText(): boolean;
+    get isBinary(): boolean;
+    get isClose(): boolean;
+    get isPing(): boolean;
+    get isPong(): boolean;
+    get isControl(): boolean;
+}
+export declare namespace Message {
+    type Role = 'server' | 'client';
+    interface Message {
+        opcode: number;
+        payload: Buffer;
+    }
+}
+export default Message;

package/build/server/websocket/messageAssembler/Message.js

@@ -0,0 +1,20 @@
+export class Message {
+    frames;
+    opcode;
+    payload;
+    constructor(frames) {
+        if (frames.length === 0)
+            throw new Error('No frames to assemble message');
+        this.frames = frames;
+        this.opcode = frames[0].header.opcode;
+        this.payload = Buffer.concat(frames.map(frame => frame.payload));
+    }
+    get isText() { return this.opcode === 0x1; }
+    get isBinary() { return this.opcode === 0x2; }
+    get isClose() { return this.opcode === 0x8; }
+    get isPing() { return this.opcode === 0x9; }
+    get isPong() { return this.opcode === 0xA; }
+    get isControl() { return this.opcode >= 0x8; }
+}
+export default Message;
+//# sourceMappingURL=Message.js.map

package/build/server/websocket/messageAssembler/Message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Message.js","sourceRoot":"","sources":["../../../../src/server/websocket/messageAssembler/Message.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,OAAO;IACA,MAAM,CAAU;IAChB,MAAM,CAAS;IACf,OAAO,CAAS;IAEhC,YAAY,MAAe;QACvB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QAC1E,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;QACtC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,IAAW,MAAM,KAAc,OAAO,IAAI,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC;IAC5D,IAAW,QAAQ,KAAc,OAAO,IAAI,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC;IAC9D,IAAW,OAAO,KAAc,OAAO,IAAI,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC;IAC7D,IAAW,MAAM,KAAc,OAAO,IAAI,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC;IAC5D,IAAW,MAAM,KAAc,OAAO,IAAI,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC;IAC5D,IAAW,SAAS,KAAc,OAAO,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC;CACjE;AAQD,eAAe,OAAO,CAAC"}