nlcurl 0.1.0

package/dist/ws/client.js

@@ -0,0 +1,273 @@
+/**
+ * WebSocket client with TLS fingerprint impersonation.
+ *
+ * Implements the WebSocket protocol (RFC 6455) over impersonated
+ * TLS connections.  Supports text and binary messages, ping/pong,
+ * and graceful close.
+ */
+import { EventEmitter } from 'node:events';
+import { NodeTLSEngine } from '../tls/node-engine.js';
+import { StealthTLSEngine } from '../tls/stealth/engine.js';
+import { getProfile } from '../fingerprints/database.js';
+import { NLcURLError, ConnectionError } from '../core/errors.js';
+import { encodeFrame, FrameParser, Opcode, generateWebSocketKey, computeAcceptKey, } from './frame.js';
+export class WebSocketClient extends EventEmitter {
+    state = 'connecting';
+    protocol = '';
+    url;
+    socket = null;
+    parser = new FrameParser();
+    fragments = [];
+    fragmentOpcode = Opcode.TEXT;
+    constructor(url, options = {}) {
+        super();
+        this.url = url;
+        // Start connection asynchronously
+        this.connect(url, options).catch((err) => {
+            this.state = 'closed';
+            this.emit('error', err);
+        });
+    }
+    /**
+     * Send a text message.
+     */
+    sendText(data) {
+        this.assertOpen();
+        const payload = Buffer.from(data, 'utf8');
+        this.socket.write(encodeFrame(Opcode.TEXT, payload));
+    }
+    /**
+     * Send a binary message.
+     */
+    sendBinary(data) {
+        this.assertOpen();
+        this.socket.write(encodeFrame(Opcode.BINARY, data));
+    }
+    /**
+     * Send a ping frame.
+     */
+    ping(data = Buffer.alloc(0)) {
+        this.assertOpen();
+        this.socket.write(encodeFrame(Opcode.PING, data));
+    }
+    /**
+     * Initiate a graceful close handshake.
+     */
+    close(code = 1000, reason = '') {
+        if (this.state !== 'open')
+            return;
+        this.state = 'closing';
+        const reasonBuf = Buffer.from(reason, 'utf8');
+        const payload = Buffer.allocUnsafe(2 + reasonBuf.length);
+        payload.writeUInt16BE(code, 0);
+        reasonBuf.copy(payload, 2);
+        this.socket.write(encodeFrame(Opcode.CLOSE, payload));
+    }
+    // ---- Internal ----
+    assertOpen() {
+        if (this.state !== 'open') {
+            throw new NLcURLError('WebSocket is not open', 'ERR_WS_NOT_OPEN');
+        }
+    }
+    async connect(url, options) {
+        const parsed = new URL(url);
+        const isSecure = parsed.protocol === 'wss:';
+        const port = parsed.port
+            ? parseInt(parsed.port, 10)
+            : isSecure ? 443 : 80;
+        const host = parsed.hostname;
+        // Resolve profile
+        const profile = options.impersonate
+            ? getProfile(options.impersonate) ?? undefined
+            : undefined;
+        let transport;
+        if (isSecure) {
+            // TLS connection with impersonation
+            const engine = options.stealth
+                ? new StealthTLSEngine()
+                : new NodeTLSEngine();
+            const tlsOpts = {
+                host,
+                port,
+                servername: host,
+                insecure: options.insecure ?? false,
+                alpnProtocols: ['http/1.1'],
+                timeout: options.timeout,
+            };
+            const tlsSocket = await engine.connect(tlsOpts, profile);
+            transport = tlsSocket;
+        }
+        else {
+            // Plain TCP (ws://)
+            const net = await import('node:net');
+            transport = await new Promise((resolve, reject) => {
+                const sock = net.createConnection({ host, port }, () => resolve(sock));
+                sock.once('error', reject);
+                if (options.timeout) {
+                    sock.setTimeout(options.timeout, () => {
+                        sock.destroy();
+                        reject(new ConnectionError('WebSocket connection timed out'));
+                    });
+                }
+            });
+        }
+        this.socket = transport;
+        // Perform HTTP upgrade handshake
+        await this.performUpgrade(transport, parsed, options);
+        // Now in open state
+        this.state = 'open';
+        this.emit('open');
+        // Start reading frames
+        transport.on('data', (chunk) => this.onData(chunk));
+        transport.on('error', (err) => {
+            this.state = 'closed';
+            this.emit('error', err);
+        });
+        transport.on('close', () => {
+            if (this.state !== 'closed') {
+                this.state = 'closed';
+                this.emit('close', 1006, 'Connection lost');
+            }
+        });
+    }
+    performUpgrade(socket, url, options) {
+        return new Promise((resolve, reject) => {
+            const key = generateWebSocketKey();
+            const path = (url.pathname || '/') + (url.search || '');
+            let request = `GET ${path} HTTP/1.1\r\n`;
+            request += `Host: ${url.host}\r\n`;
+            request += `Upgrade: websocket\r\n`;
+            request += `Connection: Upgrade\r\n`;
+            request += `Sec-WebSocket-Key: ${key}\r\n`;
+            request += `Sec-WebSocket-Version: 13\r\n`;
+            if (options.protocols && options.protocols.length > 0) {
+                request += `Sec-WebSocket-Protocol: ${options.protocols.join(', ')}\r\n`;
+            }
+            if (options.headers) {
+                for (const [k, v] of Object.entries(options.headers)) {
+                    request += `${k}: ${v}\r\n`;
+                }
+            }
+            request += `\r\n`;
+            socket.write(request);
+            // Read the upgrade response
+            let responseData = Buffer.alloc(0);
+            const expectedAccept = computeAcceptKey(key);
+            const onData = (chunk) => {
+                responseData = Buffer.concat([responseData, chunk]);
+                const text = responseData.toString('utf8');
+                const headerEnd = text.indexOf('\r\n\r\n');
+                if (headerEnd === -1) {
+                    // Limit response header size
+                    if (responseData.length > 16384) {
+                        cleanup();
+                        reject(new NLcURLError('WebSocket upgrade response too large', 'ERR_WS_UPGRADE'));
+                    }
+                    return;
+                }
+                cleanup();
+                const headerStr = text.substring(0, headerEnd);
+                const [statusLine, ...headerLines] = headerStr.split('\r\n');
+                if (!statusLine) {
+                    return reject(new NLcURLError('Empty upgrade response', 'ERR_WS_UPGRADE'));
+                }
+                const statusMatch = statusLine.match(/^HTTP\/\d\.\d (\d{3})/);
+                if (!statusMatch || statusMatch[1] !== '101') {
+                    return reject(new NLcURLError(`WebSocket upgrade failed: ${statusLine}`, 'ERR_WS_UPGRADE'));
+                }
+                // Validate Sec-WebSocket-Accept
+                const headers = new Map();
+                for (const line of headerLines) {
+                    const colonIdx = line.indexOf(':');
+                    if (colonIdx > 0) {
+                        headers.set(line.substring(0, colonIdx).trim().toLowerCase(), line.substring(colonIdx + 1).trim());
+                    }
+                }
+                const accept = headers.get('sec-websocket-accept');
+                if (accept !== expectedAccept) {
+                    return reject(new NLcURLError('Invalid Sec-WebSocket-Accept header', 'ERR_WS_UPGRADE'));
+                }
+                this.protocol = headers.get('sec-websocket-protocol') ?? '';
+                // Push any remaining data after headers into frame parser
+                const remaining = responseData.subarray(headerEnd + 4);
+                if (remaining.length > 0) {
+                    this.parser.push(remaining);
+                }
+                resolve();
+            };
+            const onError = (err) => {
+                cleanup();
+                reject(err);
+            };
+            const cleanup = () => {
+                socket.removeListener('data', onData);
+                socket.removeListener('error', onError);
+            };
+            socket.on('data', onData);
+            socket.on('error', onError);
+        });
+    }
+    onData(chunk) {
+        this.parser.push(chunk);
+        let frame;
+        while ((frame = this.parser.pull()) !== null) {
+            this.handleFrame(frame);
+        }
+    }
+    handleFrame(frame) {
+        switch (frame.opcode) {
+            case Opcode.TEXT:
+            case Opcode.BINARY:
+                if (frame.fin) {
+                    // Complete message
+                    const isBinary = frame.opcode === Opcode.BINARY;
+                    const data = isBinary ? frame.payload : frame.payload.toString('utf8');
+                    this.emit('message', data, isBinary);
+                }
+                else {
+                    // Start of fragmented message
+                    this.fragmentOpcode = frame.opcode;
+                    this.fragments = [frame.payload];
+                }
+                break;
+            case Opcode.CONTINUATION:
+                this.fragments.push(frame.payload);
+                if (frame.fin) {
+                    const assembled = Buffer.concat(this.fragments);
+                    this.fragments = [];
+                    const isBinary = this.fragmentOpcode === Opcode.BINARY;
+                    const data = isBinary ? assembled : assembled.toString('utf8');
+                    this.emit('message', data, isBinary);
+                }
+                break;
+            case Opcode.CLOSE: {
+                let code = 1005;
+                let reason = '';
+                if (frame.payload.length >= 2) {
+                    code = frame.payload.readUInt16BE(0);
+                    reason = frame.payload.subarray(2).toString('utf8');
+                }
+                if (this.state === 'open') {
+                    // Server-initiated close, echo it back
+                    this.state = 'closing';
+                    this.socket.write(encodeFrame(Opcode.CLOSE, frame.payload));
+                }
+                this.state = 'closed';
+                this.socket?.destroy();
+                this.emit('close', code, reason);
+                break;
+            }
+            case Opcode.PING:
+                this.emit('ping', frame.payload);
+                // Auto-respond with pong
+                if (this.state === 'open') {
+                    this.socket.write(encodeFrame(Opcode.PONG, frame.payload));
+                }
+                break;
+            case Opcode.PONG:
+                this.emit('pong', frame.payload);
+                break;
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/ws/client.js.map

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

package/dist/ws/frame.d.ts

@@ -0,0 +1,44 @@
+/**
+ * WebSocket frame encoding/decoding (RFC 6455).
+ *
+ * Handles frame construction and parsing at the byte level.
+ */
+export declare const enum Opcode {
+    CONTINUATION = 0,
+    TEXT = 1,
+    BINARY = 2,
+    CLOSE = 8,
+    PING = 9,
+    PONG = 10
+}
+export interface WebSocketFrame {
+    fin: boolean;
+    opcode: Opcode;
+    masked: boolean;
+    payload: Buffer;
+}
+/**
+ * Encode a WebSocket frame.
+ *
+ * Client frames MUST be masked (RFC 6455, section 5.3).
+ */
+export declare function encodeFrame(opcode: Opcode, payload: Buffer, mask?: boolean): Buffer;
+/**
+ * Incremental WebSocket frame parser.
+ *
+ * Feed data chunks via `push()` and collect completed frames via `pull()`.
+ */
+export declare class FrameParser {
+    private buffer;
+    push(data: Buffer): void;
+    pull(): WebSocketFrame | null;
+}
+/**
+ * Generate a Sec-WebSocket-Key for the opening handshake.
+ */
+export declare function generateWebSocketKey(): string;
+/**
+ * Compute the expected Sec-WebSocket-Accept value.
+ */
+export declare function computeAcceptKey(key: string): string;
+//# sourceMappingURL=frame.d.ts.map

package/dist/ws/frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.d.ts","sourceRoot":"","sources":["../../src/ws/frame.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,0BAAkB,MAAM;IACtB,YAAY,IAAM;IAClB,IAAI,IAAM;IACV,MAAM,IAAM;IACZ,KAAK,IAAM;IACX,IAAI,IAAM;IACV,IAAI,KAAM;CACX;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,UAAO,GAAG,MAAM,CAmDhF;AAED;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAmB;IAEjC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIxB,IAAI,IAAI,cAAc,GAAG,IAAI;CAoD9B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKpD"}

package/dist/ws/frame.js

@@ -0,0 +1,146 @@
+/**
+ * WebSocket frame encoding/decoding (RFC 6455).
+ *
+ * Handles frame construction and parsing at the byte level.
+ */
+import * as crypto from 'node:crypto';
+// ---- Opcodes ----
+export var Opcode;
+(function (Opcode) {
+    Opcode[Opcode["CONTINUATION"] = 0] = "CONTINUATION";
+    Opcode[Opcode["TEXT"] = 1] = "TEXT";
+    Opcode[Opcode["BINARY"] = 2] = "BINARY";
+    Opcode[Opcode["CLOSE"] = 8] = "CLOSE";
+    Opcode[Opcode["PING"] = 9] = "PING";
+    Opcode[Opcode["PONG"] = 10] = "PONG";
+})(Opcode || (Opcode = {}));
+/**
+ * Encode a WebSocket frame.
+ *
+ * Client frames MUST be masked (RFC 6455, section 5.3).
+ */
+export function encodeFrame(opcode, payload, mask = true) {
+    const payloadLen = payload.length;
+    let headerLen = 2;
+    let extendedPayloadOffset = 2;
+    if (payloadLen > 65535) {
+        headerLen += 8;
+    }
+    else if (payloadLen > 125) {
+        headerLen += 2;
+    }
+    const maskKey = mask ? crypto.randomBytes(4) : null;
+    if (mask)
+        headerLen += 4;
+    const frame = Buffer.allocUnsafe(headerLen + payloadLen);
+    // Byte 0: FIN + opcode
+    frame[0] = 0x80 | opcode;
+    // Byte 1: MASK + payload length
+    let offset = 1;
+    if (payloadLen > 65535) {
+        frame[offset] = (mask ? 0x80 : 0) | 127;
+        offset++;
+        // 8-byte extended payload length (big-endian)
+        frame.writeBigUInt64BE(BigInt(payloadLen), offset);
+        offset += 8;
+    }
+    else if (payloadLen > 125) {
+        frame[offset] = (mask ? 0x80 : 0) | 126;
+        offset++;
+        frame.writeUInt16BE(payloadLen, offset);
+        offset += 2;
+    }
+    else {
+        frame[offset] = (mask ? 0x80 : 0) | payloadLen;
+        offset++;
+    }
+    // Mask key
+    if (maskKey) {
+        maskKey.copy(frame, offset);
+        offset += 4;
+        // Mask the payload
+        for (let i = 0; i < payloadLen; i++) {
+            frame[offset + i] = payload[i] ^ maskKey[i & 3];
+        }
+    }
+    else {
+        payload.copy(frame, offset);
+    }
+    return frame;
+}
+/**
+ * Incremental WebSocket frame parser.
+ *
+ * Feed data chunks via `push()` and collect completed frames via `pull()`.
+ */
+export class FrameParser {
+    buffer = Buffer.alloc(0);
+    push(data) {
+        this.buffer = Buffer.concat([this.buffer, data]);
+    }
+    pull() {
+        if (this.buffer.length < 2)
+            return null;
+        const byte0 = this.buffer[0];
+        const byte1 = this.buffer[1];
+        const fin = (byte0 & 0x80) !== 0;
+        const opcode = (byte0 & 0x0F);
+        const masked = (byte1 & 0x80) !== 0;
+        let payloadLen = byte1 & 0x7F;
+        let offset = 2;
+        if (payloadLen === 126) {
+            if (this.buffer.length < 4)
+                return null;
+            payloadLen = this.buffer.readUInt16BE(2);
+            offset = 4;
+        }
+        else if (payloadLen === 127) {
+            if (this.buffer.length < 10)
+                return null;
+            const len64 = this.buffer.readBigUInt64BE(2);
+            // Guard against unreasonably large frames (128 MB)
+            if (len64 > 128n * 1024n * 1024n) {
+                throw new Error('WebSocket frame too large');
+            }
+            payloadLen = Number(len64);
+            offset = 10;
+        }
+        let maskKey = null;
+        if (masked) {
+            if (this.buffer.length < offset + 4)
+                return null;
+            maskKey = this.buffer.subarray(offset, offset + 4);
+            offset += 4;
+        }
+        const totalLen = offset + payloadLen;
+        if (this.buffer.length < totalLen)
+            return null;
+        let payload = this.buffer.subarray(offset, totalLen);
+        // Unmask
+        if (maskKey) {
+            payload = Buffer.from(payload);
+            for (let i = 0; i < payload.length; i++) {
+                payload[i] = payload[i] ^ maskKey[i & 3];
+            }
+        }
+        // Advance buffer
+        this.buffer = this.buffer.subarray(totalLen);
+        return { fin, opcode, masked, payload };
+    }
+}
+/**
+ * Generate a Sec-WebSocket-Key for the opening handshake.
+ */
+export function generateWebSocketKey() {
+    return crypto.randomBytes(16).toString('base64');
+}
+/**
+ * Compute the expected Sec-WebSocket-Accept value.
+ */
+export function computeAcceptKey(key) {
+    return crypto
+        .createHash('sha1')
+        .update(key + '258EAFA5-E914-47DA-95CA-C5AB0DC85B11')
+        .digest('base64');
+}
+//# sourceMappingURL=frame.js.map

package/dist/ws/frame.js.map

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

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "nlcurl",
+  "version": "0.1.0",
+  "description": "Next-level HTTP client with native TLS fingerprint impersonation. Pure TypeScript, zero dependencies.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "nlcurl": "./dist/cli/index.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "node --import tsx --test test/unit/**/*.test.ts",
+    "test:integration": "node --import tsx --test test/integration/**/*.test.ts",
+    "test:all": "node --import tsx --test test/**/*.test.ts",
+    "lint": "tsc --noEmit",
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
+    "prepublishOnly": "npm run clean && npm run build && npm run test"
+  },
+  "engines": {
+    "node": ">=18.17.0"
+  },
+  "keywords": [
+    "http",
+    "https",
+    "tls",
+    "fingerprint",
+    "ja3",
+    "impersonate",
+    "curl",
+    "browser",
+    "http2",
+    "websocket",
+    "proxy",
+    "socks5",
+    "fetch",
+    "request"
+  ],
+  "author": "devAlphaSystem",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^22.13.10",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  }
+}