nlcurl 0.1.0

package/dist/utils/buffer-reader.js

@@ -0,0 +1,99 @@
+/**
+ * Binary reader for parsing TLS records, HTTP/2 frames, and other
+ * network protocol structures.  All multi-byte integers are read in
+ * network byte order (big-endian) unless stated otherwise.
+ */
+export class BufferReader {
+    _buf;
+    _pos;
+    constructor(buf, offset = 0) {
+        this._buf = buf;
+        this._pos = offset;
+    }
+    get position() {
+        return this._pos;
+    }
+    get remaining() {
+        return this._buf.length - this._pos;
+    }
+    get length() {
+        return this._buf.length;
+    }
+    get buffer() {
+        return this._buf;
+    }
+    peek(length) {
+        this.assertAvailable(length);
+        return this._buf.subarray(this._pos, this._pos + length);
+    }
+    readUInt8() {
+        this.assertAvailable(1);
+        const v = this._buf[this._pos];
+        this._pos += 1;
+        return v;
+    }
+    readUInt16() {
+        this.assertAvailable(2);
+        const v = this._buf.readUInt16BE(this._pos);
+        this._pos += 2;
+        return v;
+    }
+    readUInt24() {
+        this.assertAvailable(3);
+        const b0 = this._buf[this._pos];
+        const b1 = this._buf[this._pos + 1];
+        const b2 = this._buf[this._pos + 2];
+        this._pos += 3;
+        return (b0 << 16) | (b1 << 8) | b2;
+    }
+    readUInt32() {
+        this.assertAvailable(4);
+        const v = this._buf.readUInt32BE(this._pos);
+        this._pos += 4;
+        return v;
+    }
+    readBytes(length) {
+        this.assertAvailable(length);
+        const slice = Buffer.from(this._buf.subarray(this._pos, this._pos + length));
+        this._pos += length;
+        return slice;
+    }
+    /** Read a length-prefixed vector with 1-byte length field. */
+    readVector8() {
+        const len = this.readUInt8();
+        return this.readBytes(len);
+    }
+    /** Read a length-prefixed vector with 2-byte length field. */
+    readVector16() {
+        const len = this.readUInt16();
+        return this.readBytes(len);
+    }
+    /** Read a length-prefixed vector with 3-byte length field. */
+    readVector24() {
+        const len = this.readUInt24();
+        return this.readBytes(len);
+    }
+    skip(length) {
+        this.assertAvailable(length);
+        this._pos += length;
+    }
+    seek(position) {
+        if (position < 0 || position > this._buf.length) {
+            throw new RangeError(`Seek position ${position} out of bounds [0, ${this._buf.length}]`);
+        }
+        this._pos = position;
+    }
+    /** Create a sub-reader over the next `length` bytes without copying. */
+    subReader(length) {
+        this.assertAvailable(length);
+        const sub = new BufferReader(this._buf.subarray(this._pos, this._pos + length));
+        this._pos += length;
+        return sub;
+    }
+    assertAvailable(n) {
+        if (this._pos + n > this._buf.length) {
+            throw new RangeError(`Buffer underflow: need ${n} bytes at offset ${this._pos}, only ${this._buf.length - this._pos} available`);
+        }
+    }
+}
+//# sourceMappingURL=buffer-reader.js.map

package/dist/utils/buffer-reader.js.map

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

package/dist/utils/buffer-writer.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Binary writer for constructing TLS records, HTTP/2 frames, and other
+ * network protocol structures.  All multi-byte integers are written in
+ * network byte order (big-endian) unless stated otherwise.
+ */
+export declare class BufferWriter {
+    private _buf;
+    private _pos;
+    constructor(capacity?: number);
+    get position(): number;
+    get length(): number;
+    /** Return a copy of the written portion. */
+    toBuffer(): Buffer;
+    writeUInt8(value: number): this;
+    writeUInt16(value: number): this;
+    writeUInt24(value: number): this;
+    writeUInt32(value: number): this;
+    writeBytes(data: Buffer | Uint8Array): this;
+    /** Write a length-prefixed vector with 1-byte length field. */
+    writeVector8(data: Buffer | Uint8Array): this;
+    /** Write a length-prefixed vector with 2-byte length field. */
+    writeVector16(data: Buffer | Uint8Array): this;
+    /** Write a length-prefixed vector with 3-byte length field. */
+    writeVector24(data: Buffer | Uint8Array): this;
+    /**
+     * Reserve space and return the offset.  The caller must fill the
+     * reserved bytes before calling toBuffer().
+     */
+    reserve(size: number): number;
+    /** Overwrite bytes at a specific offset (for back-patching lengths). */
+    patchUInt16(offset: number, value: number): void;
+    patchUInt24(offset: number, value: number): void;
+    private ensureCapacity;
+}
+//# sourceMappingURL=buffer-writer.d.ts.map

package/dist/utils/buffer-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer-writer.d.ts","sourceRoot":"","sources":["../../src/utils/buffer-writer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,qBAAa,YAAY;IACvB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,IAAI,CAAS;gBAET,QAAQ,GAAE,MAAyB;IAK/C,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,4CAA4C;IAC5C,QAAQ,IAAI,MAAM;IAIlB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAO/B,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOhC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAShC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOhC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAW3C,+DAA+D;IAC/D,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAS7C,+DAA+D;IAC/D,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAS9C,+DAA+D;IAC/D,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAS9C;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAO7B,wEAAwE;IACxE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIhD,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAMhD,OAAO,CAAC,cAAc;CAWvB"}

package/dist/utils/buffer-writer.js

@@ -0,0 +1,121 @@
+/**
+ * Binary writer for constructing TLS records, HTTP/2 frames, and other
+ * network protocol structures.  All multi-byte integers are written in
+ * network byte order (big-endian) unless stated otherwise.
+ */
+const INITIAL_CAPACITY = 1024;
+const GROWTH_FACTOR = 2;
+export class BufferWriter {
+    _buf;
+    _pos;
+    constructor(capacity = INITIAL_CAPACITY) {
+        this._buf = Buffer.allocUnsafe(capacity);
+        this._pos = 0;
+    }
+    get position() {
+        return this._pos;
+    }
+    get length() {
+        return this._pos;
+    }
+    /** Return a copy of the written portion. */
+    toBuffer() {
+        return Buffer.from(this._buf.subarray(0, this._pos));
+    }
+    writeUInt8(value) {
+        this.ensureCapacity(1);
+        this._buf[this._pos] = value & 0xff;
+        this._pos += 1;
+        return this;
+    }
+    writeUInt16(value) {
+        this.ensureCapacity(2);
+        this._buf.writeUInt16BE(value, this._pos);
+        this._pos += 2;
+        return this;
+    }
+    writeUInt24(value) {
+        this.ensureCapacity(3);
+        this._buf[this._pos] = (value >>> 16) & 0xff;
+        this._buf[this._pos + 1] = (value >>> 8) & 0xff;
+        this._buf[this._pos + 2] = value & 0xff;
+        this._pos += 3;
+        return this;
+    }
+    writeUInt32(value) {
+        this.ensureCapacity(4);
+        this._buf.writeUInt32BE(value, this._pos);
+        this._pos += 4;
+        return this;
+    }
+    writeBytes(data) {
+        this.ensureCapacity(data.length);
+        if (data instanceof Buffer) {
+            data.copy(this._buf, this._pos);
+        }
+        else {
+            this._buf.set(data, this._pos);
+        }
+        this._pos += data.length;
+        return this;
+    }
+    /** Write a length-prefixed vector with 1-byte length field. */
+    writeVector8(data) {
+        if (data.length > 0xff) {
+            throw new RangeError(`Vector8 overflow: ${data.length} > 255`);
+        }
+        this.writeUInt8(data.length);
+        this.writeBytes(data);
+        return this;
+    }
+    /** Write a length-prefixed vector with 2-byte length field. */
+    writeVector16(data) {
+        if (data.length > 0xffff) {
+            throw new RangeError(`Vector16 overflow: ${data.length} > 65535`);
+        }
+        this.writeUInt16(data.length);
+        this.writeBytes(data);
+        return this;
+    }
+    /** Write a length-prefixed vector with 3-byte length field. */
+    writeVector24(data) {
+        if (data.length > 0xffffff) {
+            throw new RangeError(`Vector24 overflow: ${data.length} > 16777215`);
+        }
+        this.writeUInt24(data.length);
+        this.writeBytes(data);
+        return this;
+    }
+    /**
+     * Reserve space and return the offset.  The caller must fill the
+     * reserved bytes before calling toBuffer().
+     */
+    reserve(size) {
+        this.ensureCapacity(size);
+        const offset = this._pos;
+        this._pos += size;
+        return offset;
+    }
+    /** Overwrite bytes at a specific offset (for back-patching lengths). */
+    patchUInt16(offset, value) {
+        this._buf.writeUInt16BE(value, offset);
+    }
+    patchUInt24(offset, value) {
+        this._buf[offset] = (value >>> 16) & 0xff;
+        this._buf[offset + 1] = (value >>> 8) & 0xff;
+        this._buf[offset + 2] = value & 0xff;
+    }
+    ensureCapacity(needed) {
+        const required = this._pos + needed;
+        if (required <= this._buf.length)
+            return;
+        let newCap = this._buf.length;
+        while (newCap < required) {
+            newCap *= GROWTH_FACTOR;
+        }
+        const newBuf = Buffer.allocUnsafe(newCap);
+        this._buf.copy(newBuf, 0, 0, this._pos);
+        this._buf = newBuf;
+    }
+}
+//# sourceMappingURL=buffer-writer.js.map

package/dist/utils/buffer-writer.js.map

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

package/dist/utils/encoding.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Content-Encoding decompression using only node:zlib.
+ * Supports gzip, deflate, brotli, and zstd (Node 22+).
+ */
+/** Whether this Node.js runtime can decompress zstd content. */
+export declare const supportsZstd: boolean;
+/**
+ * Decompress a response body according to the Content-Encoding header.
+ * Returns the original buffer if the encoding is not recognised or empty.
+ */
+export declare function decompressBody(body: Buffer, contentEncoding: string | undefined): Promise<Buffer>;
+/** Return the canonical Accept-Encoding value for browser impersonation. */
+export declare function defaultAcceptEncoding(): string;
+/**
+ * Strip unsupported encodings (e.g. zstd on Node < 22) from an
+ * accept-encoding header value so servers never send what we can't decode.
+ */
+export declare function sanitizeAcceptEncoding(value: string): string;
+//# sourceMappingURL=encoding.d.ts.map

package/dist/utils/encoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.d.ts","sourceRoot":"","sources":["../../src/utils/encoding.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgBH,gEAAgE;AAChE,eAAO,MAAM,YAAY,EAAE,OAAsC,CAAC;AAElE;;;GAGG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,MAAM,GAAG,SAAS,GAClC,OAAO,CAAC,MAAM,CAAC,CA8BjB;AAED,4EAA4E;AAC5E,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO5D"}

package/dist/utils/encoding.js

@@ -0,0 +1,63 @@
+/**
+ * Content-Encoding decompression using only node:zlib.
+ * Supports gzip, deflate, brotli, and zstd (Node 22+).
+ */
+import * as zlib from 'node:zlib';
+import { promisify } from 'node:util';
+const gunzipAsync = promisify(zlib.gunzip);
+const inflateAsync = promisify(zlib.inflate);
+const brotliDecompressAsync = promisify(zlib.brotliDecompress);
+// zstd is natively supported in Node 22+ via node:zlib
+const _zstdFn = zlib['zstdDecompress'];
+const zstdDecompressAsync = typeof _zstdFn === 'function'
+    ? promisify(_zstdFn)
+    : null;
+/** Whether this Node.js runtime can decompress zstd content. */
+export const supportsZstd = zstdDecompressAsync !== null;
+/**
+ * Decompress a response body according to the Content-Encoding header.
+ * Returns the original buffer if the encoding is not recognised or empty.
+ */
+export async function decompressBody(body, contentEncoding) {
+    if (!contentEncoding || body.length === 0)
+        return body;
+    const encoding = contentEncoding.trim().toLowerCase();
+    switch (encoding) {
+        case 'gzip':
+        case 'x-gzip':
+            return gunzipAsync(body);
+        case 'deflate':
+            return inflateAsync(body);
+        case 'br':
+            return brotliDecompressAsync(body);
+        case 'zstd':
+            if (zstdDecompressAsync) {
+                return zstdDecompressAsync(body);
+            }
+            // Node < 22: zstd not available natively, return raw bytes.
+            return body;
+        case 'identity':
+            return body;
+        default:
+            // Unknown encoding -- return as-is rather than throwing.
+            return body;
+    }
+}
+/** Return the canonical Accept-Encoding value for browser impersonation. */
+export function defaultAcceptEncoding() {
+    return supportsZstd ? 'gzip, deflate, br, zstd' : 'gzip, deflate, br';
+}
+/**
+ * Strip unsupported encodings (e.g. zstd on Node < 22) from an
+ * accept-encoding header value so servers never send what we can't decode.
+ */
+export function sanitizeAcceptEncoding(value) {
+    if (supportsZstd)
+        return value;
+    return value
+        .split(',')
+        .map(s => s.trim())
+        .filter(s => !s.startsWith('zstd'))
+        .join(', ');
+}
+//# sourceMappingURL=encoding.js.map

package/dist/utils/encoding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.js","sourceRoot":"","sources":["../../src/utils/encoding.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,WAAW,GAAG,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC3C,MAAM,YAAY,GAAG,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC7C,MAAM,qBAAqB,GAAG,SAAS,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;AAE/D,uDAAuD;AACvD,MAAM,OAAO,GAAI,IAAgC,CAAC,gBAAgB,CAAC,CAAC;AACpE,MAAM,mBAAmB,GACvB,OAAO,OAAO,KAAK,UAAU;IAC3B,CAAC,CAAE,SAAS,CAAC,OAA0C,CAAiD;IACxG,CAAC,CAAC,IAAI,CAAC;AAEX,gEAAgE;AAChE,MAAM,CAAC,MAAM,YAAY,GAAY,mBAAmB,KAAK,IAAI,CAAC;AAElE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAY,EACZ,eAAmC;IAEnC,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEvD,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAEtD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,MAAM,CAAC;QACZ,KAAK,QAAQ;YACX,OAAO,WAAW,CAAC,IAAI,CAAoB,CAAC;QAE9C,KAAK,SAAS;YACZ,OAAO,YAAY,CAAC,IAAI,CAAoB,CAAC;QAE/C,KAAK,IAAI;YACP,OAAO,qBAAqB,CAAC,IAAI,CAAoB,CAAC;QAExD,KAAK,MAAM;YACT,IAAI,mBAAmB,EAAE,CAAC;gBACxB,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC;YACnC,CAAC;YACD,4DAA4D;YAC5D,OAAO,IAAI,CAAC;QAEd,KAAK,UAAU;YACb,OAAO,IAAI,CAAC;QAEd;YACE,yDAAyD;YACzD,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,qBAAqB;IACnC,OAAO,YAAY,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,mBAAmB,CAAC;AACxE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAa;IAClD,IAAI,YAAY;QAAE,OAAO,KAAK,CAAC;IAC/B,OAAO,KAAK;SACT,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SAClB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;SAClC,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Structured logger with configurable verbosity.
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';
+export interface Logger {
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+}
+export declare class ConsoleLogger implements Logger {
+    private level;
+    constructor(level?: LogLevel);
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+    private formatArgs;
+}
+/** Silent logger that discards all output. */
+export declare const SILENT_LOGGER: Logger;
+export declare function setDefaultLogger(logger: Logger): void;
+export declare function getDefaultLogger(): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAUtE,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAClD;AAED,qBAAa,aAAc,YAAW,MAAM;IAC1C,OAAO,CAAC,KAAK,CAAS;gBAEV,KAAK,GAAE,QAAiB;IAIpC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMhD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMhD,OAAO,CAAC,UAAU;CAInB;AAED,8CAA8C;AAC9C,eAAO,MAAM,aAAa,EAAE,MAK3B,CAAC;AAIF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAErD;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC"}

package/dist/utils/logger.js

@@ -0,0 +1,56 @@
+/**
+ * Structured logger with configurable verbosity.
+ */
+const LEVEL_ORDER = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+    silent: 4,
+};
+export class ConsoleLogger {
+    level;
+    constructor(level = 'warn') {
+        this.level = LEVEL_ORDER[level];
+    }
+    debug(message, ...args) {
+        if (this.level <= LEVEL_ORDER.debug) {
+            process.stderr.write(`[nlcurl:debug] ${message}${this.formatArgs(args)}\n`);
+        }
+    }
+    info(message, ...args) {
+        if (this.level <= LEVEL_ORDER.info) {
+            process.stderr.write(`[nlcurl:info] ${message}${this.formatArgs(args)}\n`);
+        }
+    }
+    warn(message, ...args) {
+        if (this.level <= LEVEL_ORDER.warn) {
+            process.stderr.write(`[nlcurl:warn] ${message}${this.formatArgs(args)}\n`);
+        }
+    }
+    error(message, ...args) {
+        if (this.level <= LEVEL_ORDER.error) {
+            process.stderr.write(`[nlcurl:error] ${message}${this.formatArgs(args)}\n`);
+        }
+    }
+    formatArgs(args) {
+        if (args.length === 0)
+            return '';
+        return ' ' + args.map((a) => (typeof a === 'string' ? a : JSON.stringify(a))).join(' ');
+    }
+}
+/** Silent logger that discards all output. */
+export const SILENT_LOGGER = {
+    debug() { },
+    info() { },
+    warn() { },
+    error() { },
+};
+let _default = new ConsoleLogger('warn');
+export function setDefaultLogger(logger) {
+    _default = logger;
+}
+export function getDefaultLogger() {
+    return _default;
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,WAAW,GAA6B;IAC5C,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,MAAM,EAAE,CAAC;CACV,CAAC;AASF,MAAM,OAAO,aAAa;IAChB,KAAK,CAAS;IAEtB,YAAY,QAAkB,MAAM;QAClC,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,IAAI,CAAC,KAAK,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;YACpC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,IAAI,IAAI,CAAC,KAAK,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC;YACnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,IAAI,IAAI,CAAC,KAAK,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC;YACnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,IAAI,CAAC,KAAK,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;YACpC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IAEO,UAAU,CAAC,IAAe;QAChC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACjC,OAAO,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1F,CAAC;CACF;AAED,8CAA8C;AAC9C,MAAM,CAAC,MAAM,aAAa,GAAW;IACnC,KAAK,KAAI,CAAC;IACV,IAAI,KAAI,CAAC;IACT,IAAI,KAAI,CAAC;IACT,KAAK,KAAI,CAAC;CACX,CAAC;AAEF,IAAI,QAAQ,GAAW,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;AAEjD,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,QAAQ,GAAG,MAAM,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/utils/url.d.ts

@@ -0,0 +1,22 @@
+/**
+ * URL utilities -- parsing, query string encoding, base URL joining.
+ * Zero dependencies; uses the built-in WHATWG URL API.
+ */
+export declare function resolveURL(base: string | undefined, relative: string): string;
+export declare function appendParams(url: string, params?: Record<string, string | number | boolean>): string;
+export declare function parseURL(raw: string): URL;
+/**
+ * Extract the origin key used for connection pooling:
+ * `protocol://host:port`
+ */
+export declare function originOf(url: string): string;
+/** Return the hostname suitable for the TLS SNI extension. */
+export declare function sniHost(url: string): string;
+/** Return the host:port string for TCP connection. */
+export declare function hostPort(url: string): {
+    host: string;
+    port: number;
+};
+/** Return the request path including query string. */
+export declare function requestPath(url: string): string;
+//# sourceMappingURL=url.d.ts.map

package/dist/utils/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAO7E;AAED,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GACjD,MAAM,CASR;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAEzC;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI5C;AAED,8DAA8D;AAC9D,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,sDAAsD;AACtD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAOpE;AAED,sDAAsD;AACtD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG/C"}

package/dist/utils/url.js

@@ -0,0 +1,56 @@
+/**
+ * URL utilities -- parsing, query string encoding, base URL joining.
+ * Zero dependencies; uses the built-in WHATWG URL API.
+ */
+export function resolveURL(base, relative) {
+    if (!base)
+        return relative;
+    try {
+        return new URL(relative, base).toString();
+    }
+    catch {
+        return relative;
+    }
+}
+export function appendParams(url, params) {
+    if (!params || Object.keys(params).length === 0)
+        return url;
+    const parsed = new URL(url);
+    for (const [key, value] of Object.entries(params)) {
+        if (value === undefined || value === null)
+            continue;
+        parsed.searchParams.append(key, String(value));
+    }
+    return parsed.toString();
+}
+export function parseURL(raw) {
+    return new URL(raw);
+}
+/**
+ * Extract the origin key used for connection pooling:
+ * `protocol://host:port`
+ */
+export function originOf(url) {
+    const u = new URL(url);
+    const port = u.port || (u.protocol === 'https:' ? '443' : '80');
+    return `${u.protocol}//${u.hostname}:${port}`;
+}
+/** Return the hostname suitable for the TLS SNI extension. */
+export function sniHost(url) {
+    return new URL(url).hostname;
+}
+/** Return the host:port string for TCP connection. */
+export function hostPort(url) {
+    const u = new URL(url);
+    const defaultPort = u.protocol === 'https:' ? 443 : 80;
+    return {
+        host: u.hostname,
+        port: u.port ? parseInt(u.port, 10) : defaultPort,
+    };
+}
+/** Return the request path including query string. */
+export function requestPath(url) {
+    const u = new URL(url);
+    return u.pathname + u.search;
+}
+//# sourceMappingURL=url.js.map

package/dist/utils/url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,UAAU,UAAU,CAAC,IAAwB,EAAE,QAAgB;IACnE,IAAI,CAAC,IAAI;QAAE,OAAO,QAAQ,CAAC;IAC3B,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,GAAW,EACX,MAAkD;IAElD,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAE5D,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;YAAE,SAAS;QACpD,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAChE,OAAO,GAAG,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ,IAAI,IAAI,EAAE,CAAC;AAChD,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;AAC/B,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,MAAM,WAAW,GAAG,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACvD,OAAO;QACL,IAAI,EAAE,CAAC,CAAC,QAAQ;QAChB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW;KAClD,CAAC;AACJ,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,OAAO,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;AAC/B,CAAC"}

package/dist/ws/client.d.ts

@@ -0,0 +1,63 @@
+/**
+ * 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';
+export interface WebSocketOptions {
+    /** Browser profile name to impersonate. */
+    impersonate?: string;
+    /** Use the stealth TLS engine. */
+    stealth?: boolean;
+    /** Extra headers for the upgrade request. */
+    headers?: Record<string, string>;
+    /** WebSocket sub-protocols. */
+    protocols?: string[];
+    /** Skip TLS certificate verification. */
+    insecure?: boolean;
+    /** Connection timeout in milliseconds. */
+    timeout?: number;
+}
+export type WebSocketState = 'connecting' | 'open' | 'closing' | 'closed';
+export interface WebSocketEvents {
+    open: [];
+    message: [data: string | Buffer, isBinary: boolean];
+    close: [code: number, reason: string];
+    error: [error: Error];
+    ping: [data: Buffer];
+    pong: [data: Buffer];
+}
+export declare class WebSocketClient extends EventEmitter {
+    state: WebSocketState;
+    protocol: string;
+    readonly url: string;
+    private socket;
+    private parser;
+    private fragments;
+    private fragmentOpcode;
+    constructor(url: string, options?: WebSocketOptions);
+    /**
+     * Send a text message.
+     */
+    sendText(data: string): void;
+    /**
+     * Send a binary message.
+     */
+    sendBinary(data: Buffer): void;
+    /**
+     * Send a ping frame.
+     */
+    ping(data?: Buffer): void;
+    /**
+     * Initiate a graceful close handshake.
+     */
+    close(code?: number, reason?: string): void;
+    private assertOpen;
+    private connect;
+    private performUpgrade;
+    private onData;
+    private handleFrame;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/ws/client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAiB3C,MAAM,WAAW,gBAAgB;IAC/B,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE1E,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,EAAE,CAAC;IACT,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IACpD,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACtB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACrB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;CACtB;AAED,qBAAa,eAAgB,SAAQ,YAAY;IACxC,KAAK,EAAE,cAAc,CAAgB;IACrC,QAAQ,SAAM;IACrB,SAAgB,GAAG,EAAE,MAAM,CAAC;IAE5B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,cAAc,CAAuB;gBAEjC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB;IAWvD;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM5B;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK9B;;OAEG;IACH,IAAI,CAAC,IAAI,GAAE,MAAwB,GAAG,IAAI;IAK1C;;OAEG;IACH,KAAK,CAAC,IAAI,SAAO,EAAE,MAAM,SAAK,GAAG,IAAI;IAcrC,OAAO,CAAC,UAAU;YAMJ,OAAO;IAsErB,OAAO,CAAC,cAAc;IA6GtB,OAAO,CAAC,MAAM;IASd,OAAO,CAAC,WAAW;CA4DpB"}