nlcurl 0.6.0 → 0.7.0

package/dist/ws/permessage-deflate.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Negotiated permessage-deflate parameters.
+ *
+ * @typedef  {Object}  DeflateParams
+ * @property {boolean} serverNoContextTakeover - Server resets deflate context per-message.
+ * @property {boolean} clientNoContextTakeover - Client resets deflate context per-message.
+ * @property {number}  serverMaxWindowBits     - Server max window bits (8–15).
+ * @property {number}  clientMaxWindowBits     - Client max window bits (8–15).
+ */
+export interface DeflateParams {
+    serverNoContextTakeover: boolean;
+    clientNoContextTakeover: boolean;
+    serverMaxWindowBits: number;
+    clientMaxWindowBits: number;
+}
+/**
+ * Builds the `Sec-WebSocket-Extensions` header value for the client offer.
+ *
+ * @returns {string} Extension offer string.
+ */
+export declare function buildDeflateOffer(): string;
+/**
+ * Parses the server's `Sec-WebSocket-Extensions` response header to extract
+ * the negotiated `permessage-deflate` parameters. Returns `null` when the
+ * extension was not accepted by the server.
+ *
+ * @param {string} header - The `Sec-WebSocket-Extensions` response header value.
+ * @returns {DeflateParams | null} Negotiated parameters, or `null`.
+ */
+export declare function parseDeflateResponse(header: string): DeflateParams | null;
+/**
+ * Manages per-message DEFLATE compression and decompression for a single
+ * WebSocket connection. Maintains stateful zlib contexts unless
+ * `no_context_takeover` was negotiated.
+ */
+export declare class PerMessageDeflate {
+    private readonly params;
+    private inflateContext;
+    private deflateContext;
+    constructor(params: DeflateParams);
+    /**
+     * Decompresses a received message payload.
+     *
+     * @param {Buffer} data - Compressed payload (without the DEFLATE flush tail).
+     * @returns {Promise<Buffer>} Decompressed message data.
+     */
+    decompress(data: Buffer): Promise<Buffer>;
+    /**
+     * Compresses a message payload for sending.
+     *
+     * @param {Buffer} data - Uncompressed message payload.
+     * @returns {Promise<Buffer>} Compressed data (with DEFLATE flush tail stripped).
+     */
+    compress(data: Buffer): Promise<Buffer>;
+    /** Releases zlib resources. */
+    close(): void;
+}
+//# sourceMappingURL=permessage-deflate.d.ts.map

package/dist/ws/permessage-deflate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permessage-deflate.d.ts","sourceRoot":"","sources":["../../src/ws/permessage-deflate.ts"],"names":[],"mappings":"AAWA;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B,uBAAuB,EAAE,OAAO,CAAC;IACjC,uBAAuB,EAAE,OAAO,CAAC;IACjC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AASD;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CA8BzE;AAED;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,cAAc,CAA6B;gBAEvC,MAAM,EAAE,aAAa;IAIjC;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA8BzC;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAgCvC,+BAA+B;IAC/B,KAAK,IAAI,IAAI;CAMd"}

package/dist/ws/permessage-deflate.js

@@ -0,0 +1,148 @@
+/**
+ * WebSocket `permessage-deflate` extension (RFC 7692).
+ *
+ * Provides per-message DEFLATE compression for WebSocket frames. Negotiated
+ * during the HTTP Upgrade handshake via the `Sec-WebSocket-Extensions` header.
+ */
+import * as zlib from "node:zlib";
+/** The 4-byte DEFLATE flush trailer appended by RFC 7692 §7.2.1. */
+const DEFLATE_TAIL = Buffer.from([0x00, 0x00, 0xff, 0xff]);
+const DEFAULT_PARAMS = {
+    serverNoContextTakeover: false,
+    clientNoContextTakeover: false,
+    serverMaxWindowBits: 15,
+    clientMaxWindowBits: 15,
+};
+/**
+ * Builds the `Sec-WebSocket-Extensions` header value for the client offer.
+ *
+ * @returns {string} Extension offer string.
+ */
+export function buildDeflateOffer() {
+    return "permessage-deflate; client_max_window_bits";
+}
+/**
+ * Parses the server's `Sec-WebSocket-Extensions` response header to extract
+ * the negotiated `permessage-deflate` parameters. Returns `null` when the
+ * extension was not accepted by the server.
+ *
+ * @param {string} header - The `Sec-WebSocket-Extensions` response header value.
+ * @returns {DeflateParams | null} Negotiated parameters, or `null`.
+ */
+export function parseDeflateResponse(header) {
+    const extensions = header.split(",").map((s) => s.trim());
+    for (const ext of extensions) {
+        const parts = ext.split(";").map((s) => s.trim());
+        if (parts[0] !== "permessage-deflate")
+            continue;
+        const params = { ...DEFAULT_PARAMS };
+        for (let i = 1; i < parts.length; i++) {
+            const part = parts[i];
+            const [key, val] = part.split("=").map((s) => s.trim());
+            switch (key) {
+                case "server_no_context_takeover":
+                    params.serverNoContextTakeover = true;
+                    break;
+                case "client_no_context_takeover":
+                    params.clientNoContextTakeover = true;
+                    break;
+                case "server_max_window_bits":
+                    if (val)
+                        params.serverMaxWindowBits = parseInt(val, 10);
+                    break;
+                case "client_max_window_bits":
+                    if (val)
+                        params.clientMaxWindowBits = parseInt(val, 10);
+                    break;
+            }
+        }
+        return params;
+    }
+    return null;
+}
+/**
+ * Manages per-message DEFLATE compression and decompression for a single
+ * WebSocket connection. Maintains stateful zlib contexts unless
+ * `no_context_takeover` was negotiated.
+ */
+export class PerMessageDeflate {
+    params;
+    inflateContext = null;
+    deflateContext = null;
+    constructor(params) {
+        this.params = params;
+    }
+    /**
+     * Decompresses a received message payload.
+     *
+     * @param {Buffer} data - Compressed payload (without the DEFLATE flush tail).
+     * @returns {Promise<Buffer>} Decompressed message data.
+     */
+    decompress(data) {
+        return new Promise((resolve, reject) => {
+            const input = Buffer.concat([data, DEFLATE_TAIL]);
+            if (!this.inflateContext || this.params.serverNoContextTakeover) {
+                this.inflateContext?.close();
+                this.inflateContext = zlib.createInflateRaw({
+                    windowBits: this.params.serverMaxWindowBits,
+                });
+            }
+            const chunks = [];
+            const inflate = this.inflateContext;
+            inflate.on("data", (chunk) => chunks.push(chunk));
+            inflate.once("error", (err) => {
+                inflate.removeAllListeners();
+                reject(err);
+            });
+            inflate.write(input, () => {
+                inflate.flush(() => {
+                    inflate.removeAllListeners("data");
+                    inflate.removeAllListeners("error");
+                    resolve(Buffer.concat(chunks));
+                });
+            });
+        });
+    }
+    /**
+     * Compresses a message payload for sending.
+     *
+     * @param {Buffer} data - Uncompressed message payload.
+     * @returns {Promise<Buffer>} Compressed data (with DEFLATE flush tail stripped).
+     */
+    compress(data) {
+        return new Promise((resolve, reject) => {
+            if (!this.deflateContext || this.params.clientNoContextTakeover) {
+                this.deflateContext?.close();
+                this.deflateContext = zlib.createDeflateRaw({
+                    windowBits: this.params.clientMaxWindowBits,
+                });
+            }
+            const chunks = [];
+            const deflate = this.deflateContext;
+            deflate.on("data", (chunk) => chunks.push(chunk));
+            deflate.once("error", (err) => {
+                deflate.removeAllListeners();
+                reject(err);
+            });
+            deflate.write(data, () => {
+                deflate.flush(zlib.constants.Z_SYNC_FLUSH, () => {
+                    deflate.removeAllListeners("data");
+                    deflate.removeAllListeners("error");
+                    let result = Buffer.concat(chunks);
+                    if (result.length >= 4 && result.subarray(result.length - 4).equals(DEFLATE_TAIL)) {
+                        result = result.subarray(0, result.length - 4);
+                    }
+                    resolve(result);
+                });
+            });
+        });
+    }
+    /** Releases zlib resources. */
+    close() {
+        this.inflateContext?.close();
+        this.deflateContext?.close();
+        this.inflateContext = null;
+        this.deflateContext = null;
+    }
+}
+//# sourceMappingURL=permessage-deflate.js.map

package/dist/ws/permessage-deflate.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "nlcurl",
-  "version": "0.6.0",
-  "updated": "2026.03.07.0914",
+  "version": "0.7.0",
+  "updated": "2026.03.08.1440",
   "description": "Next-level HTTP client with native TLS fingerprint impersonation. Pure TypeScript, zero dependencies.",
   "author": "devAlphaSystem",
   "license": "MIT",