node-libcurl

import { requests, fetch, LibCurl, LibCurlWebSocket } from "@ossiana/node-libcurl";

import { requests } from "@ossiana/node-libcurl";

const resp = await requests.get("https://httpbin.org/get", {
    headers: {
        "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/150.0.0.0 Safari/537.36",
    },
    params: { page: 1, size: 20 }, // appended to query string
});
console.log(resp.status);   // 200
console.log(resp.text);     // response body as string
console.log(resp.json);     // response body parsed as JSON

const session = requests.session({
    httpVersion: "http2",
    redirect: true,
    timeout: 15, // seconds
    // ja3: "chrome131",
    // akamai: "auto",
    // proxy: "http://user:pass@127.0.0.1:8888",
});

const a = await session.get("https://example.com/login");
const b = await session.post("https://example.com/login", {
    json: { username: "user", password: "pass" }, // sets Content-Type: application/json
    // or use data for form-encoded bodies:
    // data: { username: "user", password: "pass" },
});

const session = requests.session({
    defaultRequestHeaders: { // merged into every request of this session
        "User-Agent": "Mozilla/5.0 ... Chrome/150.0.0.0 Safari/537.36",
    },
    cookies: { // pre-set cookies for the given uri
        value: { name: "a", value: "b" },
        uri: "https://example.com",
    },
    autoSortRequestHeaders: "auto", // reorder headers like Chrome fetch
    requestType: "fetch",           // "fetch" | "XMLHttpRequest"
});

session.setDefaultRequestHeaders(headers);
session.setCookie("key", "value", ".example.com", "/"); // set cookie manually
session.getCookie("key", ".example.com");               // get one cookie value
session.getCookies();                                   // "a=b; c=d;"
session.getCookiesMap();   // Map<string, { domain, subDomain, path, secure, timestamp, value }>
session.deleteCookie("key", ".example.com");
session.retry(3);          // returns a NEW session that retries up to 3 times
session.setProxy(proxy);
session.setTimeout(connectTime, sendTime); // seconds
session.setRedirect(true);
session.setHttpVersion("http2");
session.setInterface("eth0");
session.setJA3Fingerprint("chrome150");
session.setAkamaiFingerprint("auto");
session.setHttp3Fingerprint("auto");
session.getLastEffectiveUrl();

const retrySession = session.retry(3, (resp, error) => {
    // return true to stop retrying, false to retry again
    if (error) return false;
    return resp.status < 500;
});

const session = requests.session({
    httpVersion: "http3_only",           // or "http3"
    proxy: "socks5://user:pass@host:port", // a socks5 proxy with UDP relay
    http3Fingerprint: "auto",            // QUIC fingerprint still applies
});

const resp = await session.get("https://fp.impersonate.pro/api/http3");
console.log(resp.json.protocol);         // "http3"

session.setProxy({
    proxy: "socks5://host:port",
    username: "user",
    password: "pass",
});

await fetch("https://example.com", {
    httpVersion: "http3_only",
    proxy: "socks5://user:pass@host:port",
});

import { fetch } from "@ossiana/node-libcurl";

const resp = await fetch("https://httpbin.org/post", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: { hello: "world" }, // object is JSON.stringify'd
    redirect: true,
    ja3: "chrome150",
    akamai: "auto",
    httpVersion: "http3",
});

await resp.text();          // Promise<string>
await resp.json();          // Promise<object>
await resp.arraybuffer();   // Promise<ArrayBuffer>
await resp.headers();       // Promise<Headers>
await resp.cookies();       // Promise<string>
await resp.cookiesMap();    // Promise<Map<string, {...}>>
await resp.lastEffectiveUrl(); // Promise<string>
resp.status();              // number (sync)
resp.contentLength();
resp.encodedBodySize();

const curl = new LibCurl();
const r1 = await fetch("https://example.com/a", { instance: curl });
const r2 = await fetch("https://example.com/b", { instance: curl }); // reuses the connection

ja3: "auto"                       // pick by User-Agent Chrome version (default)
ja3: "chrome99" | "chrome101" | "chrome110" | "chrome124" | "chrome131" | "chrome133" | "chrome150"
ja3: "771,4865-4866-4867-...,0-23-65281-10-11-35-16-...,29-23-24,0"  // custom JA3 string

akamai: "auto"        // default
akamai: "chrome99" | "chrome107" | "chrome119"
akamai: "1:65536;3:1000;4:6291456;6:262144|15663105|0|m,a,s,p"  // custom string

http3Fingerprint: "auto"            // default
http3Fingerprint: "chrome126" | "chrome150"
http3Fingerprint: {                 // fully custom config
    scid: "scid=0",
    settings: "1:65536;6:262144;7:100;51:1;GREASE",
    transport_params: "12584:0x4f524947;9:103;1:30000;7:6291456;15:AUTO;4:15728640;GREASE;32:65536;3:1472;17:1@1,GREASE;8:100;6:6291456;12583:174718;5:6291456",
    tls: "ciphers=1,2,3;alps=h3;grease=off;rand=on",
    permutation: "0,15,19,23,9,1,14,21,17,4,7",
    verify_sigalgs: "0x0403,0x0804,0x0401,0x0503,0x0805,0x0501,0x0806,0x0601,0x0201",
},

tlsVerifySigalgs: [
    0x0403, "ecdsa_secp256r1_sha256", "rsa_pss_rsae_sha256", "rsa_pkcs1_sha256", ...
]

import { LibCurl } from "@ossiana/node-libcurl";

const curl = new LibCurl();
curl.open("POST", "https://example.com/api");
curl.setRequestHeaders({ "Content-Type": "application/json" });
curl.setJA3Fingerprint("chrome150");
curl.setAkamaiFingerprint("auto");
curl.setHttp3Fingerprint("auto");
curl.setProxy("127.0.0.1:8888");          // or { proxy, username, password }
curl.setTimeout(10, 20);                  // connect / total, seconds
curl.setRedirect(true);
curl.setHttpVersion("http2");
curl.setInterface("eth0");
curl.setVerbose(true);                    // print curl internal logs
await curl.send({ hello: "world" });      // object is JSON.stringify'd

curl.getResponseStatus();       // number
curl.getResponseHeaders();      // string
curl.getResponseHeadersMap();   // Headers
curl.getResponseString();       // string
curl.getResponseBody();         // Uint8Array
curl.getResponseContentLength();
curl.getResponseEncodedBodySize();
curl.getCookies();              // "a=b; c=d;"
curl.getLastEffectiveUrl();

const ws = new LibCurlWebSocket("wss://echo.websocket.org", {
    userAgent: "Mozilla/5.0 ... Chrome/150.0.0.0 Safari/537.36",
    origin: "https://example.com",
    cookie: "session=abc",
    protocol: "chat",
    timeout: 30,
    ja3: "chrome150",
    // instance: sharedCurl, // reuse an existing LibCurl
});

ws.onopen = () => {
    ws.send("hello");
    ws.send(new Uint8Array([1, 2, 3]));
};
ws.onmessage = (data: Uint8Array) => { /* receive */ };
ws.onclose = () => {};
ws.onerror = (message: string) => {};

ws.close();