nlcurl 0.6.0 → 0.8.0

package/dist/ws/permessage-deflate.js

@@ -0,0 +1,140 @@
+import * as zlib from "node:zlib";
+const DEFLATE_TAIL = Buffer.from([0x00, 0x00, 0xff, 0xff]);
+const DEFAULT_PARAMS = {
+    serverNoContextTakeover: false,
+    clientNoContextTakeover: false,
+    serverMaxWindowBits: 15,
+    clientMaxWindowBits: 15,
+};
+/**
+ * Build a `Sec-WebSocket-Extensions` offer string for per-message deflate.
+ *
+ * @returns {string} Extension offer suitable for the upgrade request.
+ */
+export function buildDeflateOffer() {
+    return "permessage-deflate; client_max_window_bits";
+}
+/**
+ * Parse the server's `Sec-WebSocket-Extensions` response for deflate params.
+ *
+ * @param {string} header - Raw extension header value from the server.
+ * @returns {DeflateParams | null} Negotiated deflate parameters, or `null` if not accepted.
+ */
+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;
+}
+/** Stateful per-message deflate compressor and decompressor (RFC 7692). */
+export class PerMessageDeflate {
+    params;
+    inflateContext = null;
+    deflateContext = null;
+    /**
+     * Create a per-message deflate handler.
+     *
+     * @param {DeflateParams} params - Negotiated deflate parameters.
+     */
+    constructor(params) {
+        this.params = params;
+    }
+    /**
+     * Decompress a compressed WebSocket payload.
+     *
+     * @param {Buffer} data - Compressed frame payload.
+     * @returns {Promise<Buffer>} Decompressed 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));
+                });
+            });
+        });
+    }
+    /**
+     * Compress a WebSocket payload before framing.
+     *
+     * @param {Buffer} data - Uncompressed payload.
+     * @returns {Promise<Buffer>} Compressed data with the deflate 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);
+                });
+            });
+        });
+    }
+    /** Release inflate and deflate contexts and free associated memory. */
+    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,62 +1,62 @@
-{
-  "name": "nlcurl",
-  "version": "0.6.0",
-  "updated": "2026.03.07.0914",
-  "description": "Next-level HTTP client with native TLS fingerprint impersonation. Pure TypeScript, zero dependencies.",
-  "author": "devAlphaSystem",
-  "license": "MIT",
-  "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",
-    "format": "prettier --write .",
-    "format:check": "prettier --check .",
-    "lint": "tsc --noEmit",
-    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
-    "update-psl": "tsx scripts/update-psl.ts",
-    "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"
-  ],
-  "devDependencies": {
-    "@types/node": "^25.3.5",
-    "prettier": "^3.8.1",
-    "tsx": "^4.21.0",
-    "typescript": "^5.9.3"
-  }
-}
+{
+  "name": "nlcurl",
+  "version": "0.8.0",
+  "updated": "2026.03.08.1447",
+  "description": "Next-level HTTP client with native TLS fingerprint impersonation. Pure TypeScript, zero dependencies.",
+  "author": "devAlphaSystem",
+  "license": "MIT",
+  "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",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "lint": "tsc --noEmit",
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
+    "update-psl": "tsx scripts/update-psl.ts",
+    "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"
+  ],
+  "devDependencies": {
+    "@types/node": "^25.3.5",
+    "prettier": "^3.8.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  }
+}