nlcurl 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 devAlphaSystem
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,162 @@
+# NLcURL
+
+Pure TypeScript HTTP client with browser fingerprint impersonation.
+
+NLcURL provides session-based and one-shot HTTP APIs, browser profile impersonation, HTTP/2 support, cookie management, and a CLI. The project has zero runtime dependencies and uses only Node.js built-in modules.
+
+## Highlights
+
+- Zero runtime dependencies
+- Session API with connection pooling
+- HTTP/1.1 and HTTP/2 (ALPN negotiated)
+- Browser profile impersonation (Chrome, Firefox, Safari, Edge, Tor)
+- Optional custom JA3 and Akamai H2 fingerprint values in request model
+- Cookie jar with RFC 6265-like behavior
+- CLI (`nlcurl`) for scripted and interactive use
+- WebSocket client with optional impersonated TLS handshake
+
+## Requirements
+
+- Node.js `>= 18.17.0`
+- npm (or compatible package manager)
+
+## Installation
+
+```bash
+npm install nlcurl
+```
+
+For local development:
+
+```bash
+npm install
+npm run build
+```
+
+## Quick Start
+
+### One-shot request
+
+```ts
+import { request } from "nlcurl";
+
+const response = await request({
+  url: "https://httpbin.org/get",
+  impersonate: "chrome136",
+});
+
+console.log(response.status);
+console.log(response.json());
+```
+
+### Session-based usage
+
+```ts
+import { createSession } from "nlcurl";
+
+const session = createSession({
+  baseURL: "https://httpbin.org",
+  impersonate: "firefox138",
+  followRedirects: true,
+});
+
+const res = await session.get("/headers");
+console.log(res.json());
+
+session.close();
+```
+
+### CLI usage
+
+```bash
+nlcurl --impersonate chrome136 https://tls.browserleaks.com/json
+```
+
+## CLI Reference
+
+```text
+nlcurl [OPTIONS] <URL>
+```
+
+Key options:
+
+- `-X, --request <METHOD>` HTTP method
+- `-H, --header <Name: Value>` add request header
+- `-d, --data <DATA>` request body
+- `--data-raw <DATA>` raw request body
+- `-A, --user-agent <AGENT>` custom User-Agent
+- `-o, --output <FILE>` write response body to file
+- `-I, --head` send HEAD request
+- `-i, --include` include response headers
+- `-v, --verbose` verbose request/response output
+- `-s, --silent` suppress error output
+- `--compressed` request compressed response
+- `--impersonate <PROFILE>` browser profile
+- `--stealth` use stealth TLS engine
+- `--ja3 <FINGERPRINT>` custom JA3 fingerprint string
+- `--akamai <FINGERPRINT>` custom Akamai HTTP/2 fingerprint string
+- `--list-profiles` list available profiles
+- `-x, --proxy <URL>` proxy URL (request model supports it)
+- `-U, --proxy-user <USER:PASS>` proxy auth pair
+- `-k, --insecure` disable TLS verification
+- `-L, --location` follow redirects (default behavior)
+- `--no-location` disable redirect following
+- `--max-redirs <NUM>` max redirects (default `20`)
+- `-m, --max-time <SECONDS>` total timeout
+- `--http1.1` force HTTP/1.1
+- `--http2` force HTTP/2
+- `-b, --cookie <DATA>` send cookie header
+- `-c, --cookie-jar <FILE>` capture cookie jar target file
+- `-h, --help` show help
+- `-V, --version` show version
+
+For examples, see `docs/SETUP.md` and `docs/API.md`.
+
+## Supported Browser Families
+
+- Chrome (`chrome99` through `chrome136`, plus `chrome_latest` and `chrome` alias)
+- Firefox (`firefox133` through `firefox138`, plus `firefox_latest` and `firefox` alias)
+- Safari (`safari153` through `safari182`, plus `safari_latest` and `safari` alias)
+- Edge (`edge99`, `edge101`, `edge126`, `edge131`, `edge136`, `edge_latest`, `edge` alias)
+- Tor (`tor133`, `tor140`, `tor145`, `tor_latest`, `tor` alias)
+
+Run `nlcurl --list-profiles` to view the exact runtime list.
+
+## Development
+
+```bash
+npm install
+npm run lint
+npm run test
+npm run test:integration
+npm run build
+```
+
+Additional commands:
+
+- `npm run clean` remove `dist`
+- `npm run test:all` run all tests
+
+## Documentation Index
+
+- `docs/API.md`: exported API reference
+- `docs/MODULES.md`: module-by-module usage guide
+- `docs/ARCHITECTURE.md`: system architecture and request flow
+- `docs/SETUP.md`: setup, build, and test instructions
+- `docs/CONFIGURATION.md`: request/session/CLI configuration
+- `docs/ONBOARDING.md`: contributor onboarding guide
+
+## Current Scope and Known Gaps
+
+The project contains several lower-level modules that are present and tested in isolation but not fully integrated into the high-level request path yet.
+
+- Proxy modules exist (`src/proxy/http-proxy.ts`, `src/proxy/socks.ts`), but `request.proxy` and `request.proxyAuth` are not currently applied by the protocol negotiator.
+- Retry middleware helper exists (`src/middleware/retry.ts`), but session/client request execution does not currently invoke it.
+- CLI `--cookie-jar` flag is parsed but not currently persisted to a cookie-jar file.
+- `RequestTimings` fields are present in responses, but only partial timing data is currently populated by transport layers.
+
+These behaviors are documented intentionally to prevent ambiguity in production integration.
+
+## License
+
+MIT. See `LICENSE`.

package/dist/cli/args.d.ts

@@ -0,0 +1,42 @@
+/**
+ * CLI argument parser.
+ *
+ * A zero-dependency argv parser tailored for nlcurl flags.
+ * Supports long flags (--flag value, --flag=value), short flags (-X GET),
+ * and boolean toggles (-k, --insecure).
+ */
+export interface ParsedArgs {
+    url: string;
+    method: string;
+    headers: Array<[string, string]>;
+    data: string | null;
+    dataRaw: string | null;
+    output: string | null;
+    impersonate: string | null;
+    ja3: string | null;
+    akamai: string | null;
+    stealth: boolean;
+    proxy: string | null;
+    proxyAuth: string | null;
+    insecure: boolean;
+    followRedirects: boolean;
+    maxRedirects: number;
+    timeout: number;
+    httpVersion: string | null;
+    verbose: boolean;
+    silent: boolean;
+    compressed: boolean;
+    head: boolean;
+    include: boolean;
+    listProfiles: boolean;
+    help: boolean;
+    version: boolean;
+    cookies: string | null;
+    cookieJar: string | null;
+    userAgent: string | null;
+}
+/**
+ * Parse CLI arguments into structured options.
+ */
+export declare function parseArgs(argv: string[]): ParsedArgs;
+//# sourceMappingURL=args.d.ts.map

package/dist/cli/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACjC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAiCD;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAuLpD"}

package/dist/cli/args.js

@@ -0,0 +1,262 @@
+/**
+ * CLI argument parser.
+ *
+ * A zero-dependency argv parser tailored for nlcurl flags.
+ * Supports long flags (--flag value, --flag=value), short flags (-X GET),
+ * and boolean toggles (-k, --insecure).
+ */
+const DEFAULTS = {
+    url: '',
+    method: 'GET',
+    headers: [],
+    data: null,
+    dataRaw: null,
+    output: null,
+    impersonate: null,
+    ja3: null,
+    akamai: null,
+    stealth: false,
+    proxy: null,
+    proxyAuth: null,
+    insecure: false,
+    followRedirects: true,
+    maxRedirects: 20,
+    timeout: 30000,
+    httpVersion: null,
+    verbose: false,
+    silent: false,
+    compressed: false,
+    head: false,
+    include: false,
+    listProfiles: false,
+    help: false,
+    version: false,
+    cookies: null,
+    cookieJar: null,
+    userAgent: null,
+};
+/**
+ * Parse CLI arguments into structured options.
+ */
+export function parseArgs(argv) {
+    const result = { ...DEFAULTS, headers: [] };
+    const args = argv.slice(2); // Skip node and script path
+    let i = 0;
+    while (i < args.length) {
+        const arg = args[i];
+        // Handle --flag=value syntax
+        if (arg.startsWith('--') && arg.includes('=')) {
+            const eqIdx = arg.indexOf('=');
+            const flag = arg.substring(0, eqIdx);
+            const value = arg.substring(eqIdx + 1);
+            processLongFlag(flag, value, result);
+            i++;
+            continue;
+        }
+        switch (arg) {
+            // ---- Request configuration ----
+            case '-X':
+            case '--request':
+                result.method = requireNext(args, ++i, arg).toUpperCase();
+                break;
+            case '-H':
+            case '--header': {
+                const raw = requireNext(args, ++i, arg);
+                const colonIdx = raw.indexOf(':');
+                if (colonIdx > 0) {
+                    result.headers.push([
+                        raw.substring(0, colonIdx).trim(),
+                        raw.substring(colonIdx + 1).trim(),
+                    ]);
+                }
+                break;
+            }
+            case '-d':
+            case '--data':
+            case '--data-ascii':
+                result.data = requireNext(args, ++i, arg);
+                if (result.method === 'GET')
+                    result.method = 'POST';
+                break;
+            case '--data-raw':
+                result.dataRaw = requireNext(args, ++i, arg);
+                if (result.method === 'GET')
+                    result.method = 'POST';
+                break;
+            case '-A':
+            case '--user-agent':
+                result.userAgent = requireNext(args, ++i, arg);
+                break;
+            // ---- Output ----
+            case '-o':
+            case '--output':
+                result.output = requireNext(args, ++i, arg);
+                break;
+            case '-I':
+            case '--head':
+                result.head = true;
+                result.method = 'HEAD';
+                break;
+            case '-i':
+            case '--include':
+                result.include = true;
+                break;
+            case '-v':
+            case '--verbose':
+                result.verbose = true;
+                break;
+            case '-s':
+            case '--silent':
+                result.silent = true;
+                break;
+            case '--compressed':
+                result.compressed = true;
+                break;
+            // ---- Impersonation ----
+            case '--impersonate':
+                result.impersonate = requireNext(args, ++i, arg);
+                break;
+            case '--ja3':
+                result.ja3 = requireNext(args, ++i, arg);
+                break;
+            case '--akamai':
+                result.akamai = requireNext(args, ++i, arg);
+                break;
+            case '--stealth':
+                result.stealth = true;
+                break;
+            case '--list-profiles':
+                result.listProfiles = true;
+                break;
+            // ---- Connection ----
+            case '-x':
+            case '--proxy':
+                result.proxy = requireNext(args, ++i, arg);
+                break;
+            case '-U':
+            case '--proxy-user':
+                result.proxyAuth = requireNext(args, ++i, arg);
+                break;
+            case '-k':
+            case '--insecure':
+                result.insecure = true;
+                break;
+            case '-L':
+            case '--location':
+                result.followRedirects = true;
+                break;
+            case '--no-location':
+                result.followRedirects = false;
+                break;
+            case '--max-redirs':
+                result.maxRedirects = parseInt(requireNext(args, ++i, arg), 10);
+                break;
+            case '-m':
+            case '--max-time':
+                result.timeout = Math.round(parseFloat(requireNext(args, ++i, arg)) * 1000);
+                break;
+            case '--http1.1':
+                result.httpVersion = '1.1';
+                break;
+            case '--http2':
+                result.httpVersion = '2';
+                break;
+            // ---- Cookies ----
+            case '-b':
+            case '--cookie':
+                result.cookies = requireNext(args, ++i, arg);
+                break;
+            case '-c':
+            case '--cookie-jar':
+                result.cookieJar = requireNext(args, ++i, arg);
+                break;
+            // ---- Meta ----
+            case '-h':
+            case '--help':
+                result.help = true;
+                break;
+            case '-V':
+            case '--version':
+                result.version = true;
+                break;
+            default:
+                // Positional argument (URL)
+                if (!arg.startsWith('-') && !result.url) {
+                    result.url = arg;
+                }
+                break;
+        }
+        i++;
+    }
+    return result;
+}
+function requireNext(args, idx, flag) {
+    if (idx >= args.length) {
+        throw new Error(`Flag ${flag} requires a value`);
+    }
+    return args[idx];
+}
+function processLongFlag(flag, value, result) {
+    switch (flag) {
+        case '--impersonate':
+            result.impersonate = value;
+            break;
+        case '--ja3':
+            result.ja3 = value;
+            break;
+        case '--akamai':
+            result.akamai = value;
+            break;
+        case '--proxy':
+            result.proxy = value;
+            break;
+        case '--proxy-user':
+            result.proxyAuth = value;
+            break;
+        case '--max-redirs':
+            result.maxRedirects = parseInt(value, 10);
+            break;
+        case '--max-time':
+            result.timeout = Math.round(parseFloat(value) * 1000);
+            break;
+        case '--output':
+            result.output = value;
+            break;
+        case '--request':
+            result.method = value.toUpperCase();
+            break;
+        case '--user-agent':
+            result.userAgent = value;
+            break;
+        case '--cookie':
+            result.cookies = value;
+            break;
+        case '--cookie-jar':
+            result.cookieJar = value;
+            break;
+        case '--header': {
+            const colonIdx = value.indexOf(':');
+            if (colonIdx > 0) {
+                result.headers.push([
+                    value.substring(0, colonIdx).trim(),
+                    value.substring(colonIdx + 1).trim(),
+                ]);
+            }
+            break;
+        }
+        case '--data':
+        case '--data-ascii':
+            result.data = value;
+            if (result.method === 'GET')
+                result.method = 'POST';
+            break;
+        case '--data-raw':
+            result.dataRaw = value;
+            if (result.method === 'GET')
+                result.method = 'POST';
+            break;
+        default:
+            break;
+    }
+}
+//# sourceMappingURL=args.js.map

package/dist/cli/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiCH,MAAM,QAAQ,GAAe;IAC3B,GAAG,EAAE,EAAE;IACP,MAAM,EAAE,KAAK;IACb,OAAO,EAAE,EAAE;IACX,IAAI,EAAE,IAAI;IACV,OAAO,EAAE,IAAI;IACb,MAAM,EAAE,IAAI;IACZ,WAAW,EAAE,IAAI;IACjB,GAAG,EAAE,IAAI;IACT,MAAM,EAAE,IAAI;IACZ,OAAO,EAAE,KAAK;IACd,KAAK,EAAE,IAAI;IACX,SAAS,EAAE,IAAI;IACf,QAAQ,EAAE,KAAK;IACf,eAAe,EAAE,IAAI;IACrB,YAAY,EAAE,EAAE;IAChB,OAAO,EAAE,KAAK;IACd,WAAW,EAAE,IAAI;IACjB,OAAO,EAAE,KAAK;IACd,MAAM,EAAE,KAAK;IACb,UAAU,EAAE,KAAK;IACjB,IAAI,EAAE,KAAK;IACX,OAAO,EAAE,KAAK;IACd,YAAY,EAAE,KAAK;IACnB,IAAI,EAAE,KAAK;IACX,OAAO,EAAE,KAAK;IACd,OAAO,EAAE,IAAI;IACb,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,IAAI;CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,MAAM,MAAM,GAAe,EAAE,GAAG,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACxD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,4BAA4B;IACxD,IAAI,CAAC,GAAG,CAAC,CAAC;IAEV,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;QAErB,6BAA6B;QAC7B,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9C,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC/B,MAAM,IAAI,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YACrC,MAAM,KAAK,GAAG,GAAG,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YACvC,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;YACrC,CAAC,EAAE,CAAC;YACJ,SAAS;QACX,CAAC;QAED,QAAQ,GAAG,EAAE,CAAC;YACZ,kCAAkC;YAClC,KAAK,IAAI,CAAC;YACV,KAAK,WAAW;gBACd,MAAM,CAAC,MAAM,GAAG,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;gBAC1D,MAAM;YAER,KAAK,IAAI,CAAC;YACV,KAAK,UAAU,CAAC,CAAC,CAAC;gBAChB,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;gBACxC,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBAClC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;oBACjB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;wBAClB,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE;wBACjC,GAAG,CAAC,SAAS,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE;qBACnC,CAAC,CAAC;gBACL,CAAC;gBACD,MAAM;YACR,CAAC;YAED,KAAK,IAAI,CAAC;YACV,KAAK,QAAQ,CAAC;YACd,KAAK,cAAc;gBACjB,MAAM,CAAC,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;gBAC1C,IAAI,MAAM,CAAC,MAAM,KAAK,KAAK;oBAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;gBACpD,MAAM;YAER,KAAK,YAAY;gBACf,MAAM,CAAC,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;gBAC7C,IAAI,MAAM,CAAC,MAAM,KAAK,KAAK;oBAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;gBACpD,MAAM;YAER,KAAK,IAAI,CAAC;YACV,KAAK,cAAc;gBACjB,MAAM,CAAC,SAAS,GAAG,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;gBAC/C,MAAM;YAER,mBAAmB;YACnB,KAAK,IAAI,CAAC;YACV,KAAK,UAAU;gBACb,MAAM,CAAC,MAAM,GAAG,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;gBAC5C,MAAM;YAER,KAAK,IAAI,CAAC;YACV,KAAK,QAAQ;gBACX,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;gBACnB,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;gBACvB,MAAM;YAER,KAAK,IAAI,CAAC;YACV,KAAK,WAAW;gBACd,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;gBACtB,MAAM;YAER,KAAK,IAAI,CAAC;YACV,KAAK,WAAW;gBACd,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;gBACtB,MAAM;YAER,KAAK,IAAI,CAAC;YACV,KAAK,UAAU;gBACb,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC;gBACrB,MAAM;YAER,KAAK,cAAc;gBACjB,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC;gBACzB,MAAM;YAER,0BAA0B;YAC1B,KAAK,eAAe;gBAClB,MAAM,CAAC,WAAW,GAAG,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;gBACjD,MAAM;YAER,KAAK,OAAO;gBACV,MAAM,CAAC,GAAG,GAAG,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;gBACzC,MAAM;YAER,KAAK,UAAU;gBACb,MAAM,CAAC,MAAM,GAAG,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;gBAC5C,MAAM;YAER,KAAK,WAAW;gBACd,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;gBACtB,MAAM;YAER,KAAK,iBAAiB;gBACpB,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC;gBAC3B,MAAM;YAER,uBAAuB;YACvB,KAAK,IAAI,CAAC;YACV,KAAK,SAAS;gBACZ,MAAM,CAAC,KAAK,GAAG,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;gBAC3C,MAAM;YAER,KAAK,IAAI,CAAC;YACV,KAAK,cAAc;gBACjB,MAAM,CAAC,SAAS,GAAG,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;gBAC/C,MAAM;YAER,KAAK,IAAI,CAAC;YACV,KAAK,YAAY;gBACf,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC;gBACvB,MAAM;YAER,KAAK,IAAI,CAAC;YACV,KAAK,YAAY;gBACf,MAAM,CAAC,eAAe,GAAG,IAAI,CAAC;gBAC9B,MAAM;YAER,KAAK,eAAe;gBAClB,MAAM,CAAC,eAAe,GAAG,KAAK,CAAC;gBAC/B,MAAM;YAER,KAAK,cAAc;gBACjB,MAAM,CAAC,YAAY,GAAG,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;gBAChE,MAAM;YAER,KAAK,IAAI,CAAC;YACV,KAAK,YAAY;gBACf,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;gBAC5E,MAAM;YAER,KAAK,WAAW;gBACd,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC;gBAC3B,MAAM;YAER,KAAK,SAAS;gBACZ,MAAM,CAAC,WAAW,GAAG,GAAG,CAAC;gBACzB,MAAM;YAER,oBAAoB;YACpB,KAAK,IAAI,CAAC;YACV,KAAK,UAAU;gBACb,MAAM,CAAC,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;gBAC7C,MAAM;YAER,KAAK,IAAI,CAAC;YACV,KAAK,cAAc;gBACjB,MAAM,CAAC,SAAS,GAAG,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;gBAC/C,MAAM;YAER,iBAAiB;YACjB,KAAK,IAAI,CAAC;YACV,KAAK,QAAQ;gBACX,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;gBACnB,MAAM;YAER,KAAK,IAAI,CAAC;YACV,KAAK,WAAW;gBACd,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;gBACtB,MAAM;YAER;gBACE,4BAA4B;gBAC5B,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;oBACxC,MAAM,CAAC,GAAG,GAAG,GAAG,CAAC;gBACnB,CAAC;gBACD,MAAM;QACV,CAAC;QAED,CAAC,EAAE,CAAC;IACN,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,WAAW,CAAC,IAAc,EAAE,GAAW,EAAE,IAAY;IAC5D,IAAI,GAAG,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,mBAAmB,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAE,CAAC;AACpB,CAAC;AAED,SAAS,eAAe,CAAC,IAAY,EAAE,KAAa,EAAE,MAAkB;IACtE,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,eAAe;YAAE,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC;YAAC,MAAM;QACxD,KAAK,OAAO;YAAE,MAAM,CAAC,GAAG,GAAG,KAAK,CAAC;YAAC,MAAM;QACxC,KAAK,UAAU;YAAE,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC;YAAC,MAAM;QAC9C,KAAK,SAAS;YAAE,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;YAAC,MAAM;QAC5C,KAAK,cAAc;YAAE,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC;YAAC,MAAM;QACrD,KAAK,cAAc;YAAE,MAAM,CAAC,YAAY,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAAC,MAAM;QACtE,KAAK,YAAY;YAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;YAAC,MAAM;QAChF,KAAK,UAAU;YAAE,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC;YAAC,MAAM;QAC9C,KAAK,WAAW;YAAE,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;YAAC,MAAM;QAC7D,KAAK,cAAc;YAAE,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC;YAAC,MAAM;QACrD,KAAK,UAAU;YAAE,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC;YAAC,MAAM;QAC/C,KAAK,cAAc;YAAE,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC;YAAC,MAAM;QACrD,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACpC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;gBACjB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;oBAClB,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE;oBACnC,KAAK,CAAC,SAAS,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE;iBACrC,CAAC,CAAC;YACL,CAAC;YACD,MAAM;QACR,CAAC;QACD,KAAK,QAAQ,CAAC;QACd,KAAK,cAAc;YACjB,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC;YACpB,IAAI,MAAM,CAAC,MAAM,KAAK,KAAK;gBAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;YACpD,MAAM;QACR,KAAK,YAAY;YACf,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC;YACvB,IAAI,MAAM,CAAC,MAAM,KAAK,KAAK;gBAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;YACpD,MAAM;QACR;YACE,MAAM;IACV,CAAC;AACH,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * NLcURL CLI entry point.
+ *
+ * Usage: nlcurl [OPTIONS] <URL>
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA;;;;GAIG"}

package/dist/cli/index.js

@@ -0,0 +1,114 @@
+#!/usr/bin/env node
+/**
+ * NLcURL CLI entry point.
+ *
+ * Usage: nlcurl [OPTIONS] <URL>
+ */
+import * as fs from 'node:fs';
+import * as process from 'node:process';
+import { parseArgs } from './args.js';
+import { formatOutput, formatVerboseRequest, printHelp } from './output.js';
+import { request } from '../core/client.js';
+import { listProfiles } from '../fingerprints/database.js';
+async function main() {
+    const args = parseArgs(process.argv);
+    // ---- Meta commands ----
+    if (args.help) {
+        process.stdout.write(printHelp() + '\n');
+        return;
+    }
+    if (args.version) {
+        const pkg = JSON.parse(fs.readFileSync(new URL('../../package.json', import.meta.url), 'utf8'));
+        process.stdout.write(`nlcurl ${pkg.version}\n`);
+        return;
+    }
+    if (args.listProfiles) {
+        const profiles = listProfiles();
+        for (const name of profiles) {
+            process.stdout.write(name + '\n');
+        }
+        return;
+    }
+    // ---- Validate URL ----
+    if (!args.url) {
+        process.stderr.write('Error: No URL specified. Use --help for usage.\n');
+        process.exit(1);
+    }
+    // Prepend https:// if no scheme is given
+    let url = args.url;
+    if (!url.startsWith('http://') && !url.startsWith('https://')) {
+        url = 'https://' + url;
+    }
+    // ---- Build request ----
+    const headers = {};
+    for (const [key, value] of args.headers) {
+        headers[key] = value;
+    }
+    if (args.userAgent) {
+        headers['user-agent'] = args.userAgent;
+    }
+    if (args.compressed && !headers['accept-encoding']) {
+        headers['accept-encoding'] = 'gzip, deflate, br';
+    }
+    if (args.cookies) {
+        headers['cookie'] = args.cookies;
+    }
+    const body = args.data ?? args.dataRaw ?? undefined;
+    const req = {
+        url,
+        method: args.method,
+        headers: Object.keys(headers).length > 0 ? headers : undefined,
+        body,
+        impersonate: args.impersonate ?? undefined,
+        ja3: args.ja3 ?? undefined,
+        akamai: args.akamai ?? undefined,
+        stealth: args.stealth || undefined,
+        proxy: args.proxy ?? undefined,
+        insecure: args.insecure || undefined,
+        followRedirects: args.followRedirects,
+        maxRedirects: args.maxRedirects,
+        timeout: args.timeout,
+        httpVersion: args.httpVersion ?? undefined,
+    };
+    if (args.proxyAuth) {
+        const [user, pass] = args.proxyAuth.split(':');
+        if (user && pass) {
+            req.proxyAuth = [user, pass];
+        }
+    }
+    // ---- Verbose request output ----
+    if (args.verbose) {
+        const verboseReq = formatVerboseRequest(req.method ?? 'GET', url, headers);
+        process.stderr.write(verboseReq + '\n');
+    }
+    // ---- Execute request ----
+    try {
+        const response = await request(req);
+        const output = formatOutput(response, args);
+        if (args.output) {
+            fs.writeFileSync(args.output, response.rawBody);
+            if (!args.silent) {
+                process.stderr.write(`Written to ${args.output}\n`);
+            }
+        }
+        else {
+            process.stdout.write(output);
+            // Add trailing newline if body doesn't end with one
+            if (output.length > 0 && !output.endsWith('\n')) {
+                process.stdout.write('\n');
+            }
+        }
+        if (!response.ok && !args.silent) {
+            process.exit(22);
+        }
+    }
+    catch (err) {
+        if (!args.silent) {
+            const message = err instanceof Error ? err.message : String(err);
+            process.stderr.write(`nlcurl: ${message}\n`);
+        }
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/cli/output.d.ts

@@ -0,0 +1,22 @@
+/**
+ * CLI output formatting.
+ */
+import { NLcURLResponse } from '../core/response.js';
+import type { ParsedArgs } from './args.js';
+/**
+ * Format and write response output to stdout/stderr.
+ */
+export declare function formatOutput(response: NLcURLResponse, args: ParsedArgs): string;
+/**
+ * Format the response status line and headers.
+ */
+export declare function formatResponseHeaders(response: NLcURLResponse): string;
+/**
+ * Format verbose request info (written to stderr).
+ */
+export declare function formatVerboseRequest(method: string, url: string, headers: Record<string, string>): string;
+/**
+ * Print the help text.
+ */
+export declare function printHelp(): string;
+//# sourceMappingURL=output.d.ts.map

package/dist/cli/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/cli/output.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C;;GAEG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,UAAU,GACf,MAAM,CAmBR;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAYtE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,MAAM,CAaR;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAmDlC"}