nlcurl 0.1.0

package/dist/core/errors.d.ts

@@ -0,0 +1,36 @@
+/**
+ * NLcURL error hierarchy.
+ *
+ * All errors thrown by the library extend NLcURLError so callers can
+ * discriminate library faults from generic exceptions with a single
+ * instanceof check.
+ */
+export declare class NLcURLError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+export declare class TLSError extends NLcURLError {
+    readonly alertCode?: number;
+    constructor(message: string, alertCode?: number);
+}
+export declare class HTTPError extends NLcURLError {
+    readonly statusCode: number;
+    constructor(message: string, statusCode: number);
+}
+export declare class TimeoutError extends NLcURLError {
+    readonly phase: 'connect' | 'tls' | 'response' | 'total';
+    constructor(message: string, phase: 'connect' | 'tls' | 'response' | 'total');
+}
+export declare class ProxyError extends NLcURLError {
+    constructor(message: string);
+}
+export declare class AbortError extends NLcURLError {
+    constructor(message?: string);
+}
+export declare class ConnectionError extends NLcURLError {
+    constructor(message: string);
+}
+export declare class ProtocolError extends NLcURLError {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,qBAAa,WAAY,SAAQ,KAAK;IACpC,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEjB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAM1C;AAED,qBAAa,QAAS,SAAQ,WAAW;IACvC,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEvB,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAKhD;AAED,qBAAa,SAAU,SAAQ,WAAW;IACxC,SAAgB,UAAU,EAAE,MAAM,CAAC;gBAEvB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAKhD;AAED,qBAAa,YAAa,SAAQ,WAAW;IAC3C,SAAgB,KAAK,EAAE,SAAS,GAAG,KAAK,GAAG,UAAU,GAAG,OAAO,CAAC;gBAEpD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,KAAK,GAAG,UAAU,GAAG,OAAO;CAK7E;AAED,qBAAa,UAAW,SAAQ,WAAW;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,UAAW,SAAQ,WAAW;gBAC7B,OAAO,GAAE,MAA0B;CAIhD;AAED,qBAAa,eAAgB,SAAQ,WAAW;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,aAAc,SAAQ,WAAW;gBAChC,OAAO,EAAE,MAAM;CAI5B"}

package/dist/core/errors.js

@@ -0,0 +1,65 @@
+/**
+ * NLcURL error hierarchy.
+ *
+ * All errors thrown by the library extend NLcURLError so callers can
+ * discriminate library faults from generic exceptions with a single
+ * instanceof check.
+ */
+export class NLcURLError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.name = 'NLcURLError';
+        this.code = code;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+export class TLSError extends NLcURLError {
+    alertCode;
+    constructor(message, alertCode) {
+        super(message, 'ERR_TLS');
+        this.name = 'TLSError';
+        this.alertCode = alertCode;
+    }
+}
+export class HTTPError extends NLcURLError {
+    statusCode;
+    constructor(message, statusCode) {
+        super(message, 'ERR_HTTP');
+        this.name = 'HTTPError';
+        this.statusCode = statusCode;
+    }
+}
+export class TimeoutError extends NLcURLError {
+    phase;
+    constructor(message, phase) {
+        super(message, 'ERR_TIMEOUT');
+        this.name = 'TimeoutError';
+        this.phase = phase;
+    }
+}
+export class ProxyError extends NLcURLError {
+    constructor(message) {
+        super(message, 'ERR_PROXY');
+        this.name = 'ProxyError';
+    }
+}
+export class AbortError extends NLcURLError {
+    constructor(message = 'Request aborted') {
+        super(message, 'ERR_ABORTED');
+        this.name = 'AbortError';
+    }
+}
+export class ConnectionError extends NLcURLError {
+    constructor(message) {
+        super(message, 'ERR_CONNECTION');
+        this.name = 'ConnectionError';
+    }
+}
+export class ProtocolError extends NLcURLError {
+    constructor(message) {
+        super(message, 'ERR_PROTOCOL');
+        this.name = 'ProtocolError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpB,IAAI,CAAS;IAE7B,YAAY,OAAe,EAAE,IAAY;QACvC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAED,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvB,SAAS,CAAU;IAEnC,YAAY,OAAe,EAAE,SAAkB;QAC7C,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,SAAU,SAAQ,WAAW;IACxB,UAAU,CAAS;IAEnC,YAAY,OAAe,EAAE,UAAkB;QAC7C,KAAK,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,WAAW;IAC3B,KAAK,CAA2C;IAEhE,YAAY,OAAe,EAAE,KAA+C;QAC1E,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED,MAAM,OAAO,UAAW,SAAQ,WAAW;IACzC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,OAAO,UAAW,SAAQ,WAAW;IACzC,YAAY,UAAkB,iBAAiB;QAC7C,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,WAAW;IAC9C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,WAAW;IAC5C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF"}

package/dist/core/request.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Request and configuration types for NLcURL.
+ */
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';
+export interface RequestTimings {
+    /** Milliseconds from start to DNS lookup completion. */
+    dns: number;
+    /** Milliseconds from start to TCP connection established. */
+    connect: number;
+    /** Milliseconds from start to TLS handshake completed. */
+    tls: number;
+    /** Milliseconds from start to first byte received. */
+    firstByte: number;
+    /** Milliseconds total. */
+    total: number;
+}
+export interface TimeoutConfig {
+    /** TCP connect timeout in milliseconds. */
+    connect?: number;
+    /** TLS handshake timeout in milliseconds. */
+    tls?: number;
+    /** Time to first byte timeout in milliseconds. */
+    response?: number;
+    /** Total request timeout in milliseconds. */
+    total?: number;
+}
+export type RequestBody = string | Buffer | URLSearchParams | Record<string, unknown> | ReadableStream<Uint8Array> | null;
+export interface NLcURLRequest {
+    url: string;
+    method?: HttpMethod;
+    headers?: Record<string, string>;
+    body?: RequestBody;
+    timeout?: number | TimeoutConfig;
+    signal?: AbortSignal;
+    /** Browser profile name to impersonate, e.g. "chrome136", "firefox135". */
+    impersonate?: string;
+    /** Custom JA3 fingerprint string. Overrides profile TLS settings. */
+    ja3?: string;
+    /** Custom Akamai HTTP/2 fingerprint string. Overrides profile h2 settings. */
+    akamai?: string;
+    /** Use stealth TLS engine for byte-level ClientHello control. */
+    stealth?: boolean;
+    /** Follow redirects. Default: true. */
+    followRedirects?: boolean;
+    /** Maximum number of redirects to follow. Default: 20. */
+    maxRedirects?: number;
+    /** Skip TLS certificate verification. Default: false. */
+    insecure?: boolean;
+    /** Proxy URL (http, https, socks4, socks5). */
+    proxy?: string;
+    /** Proxy authentication as [username, password]. */
+    proxyAuth?: [string, string];
+    /** Force HTTP version: "1.1" or "2". */
+    httpVersion?: '1.1' | '2';
+    /** Base URL prepended to relative URLs. */
+    baseURL?: string;
+    /** Query parameters merged into the URL. */
+    params?: Record<string, string | number | boolean>;
+    /** Cookie jar instance or boolean to enable automatic cookie management. */
+    cookieJar?: boolean | string;
+    /** Accept-Encoding. Default: "gzip, deflate, br". */
+    acceptEncoding?: string;
+    /** Extra header ordering hint, if the profile needs headers in exact order. */
+    headerOrder?: string[];
+}
+export interface RetryConfig {
+    /** Number of retry attempts. Default: 0. */
+    count: number;
+    /** Base delay in milliseconds between retries. Default: 1000. */
+    delay: number;
+    /** Backoff strategy. Default: "exponential". */
+    backoff: 'linear' | 'exponential';
+    /** Maximum random jitter in milliseconds added to each delay. Default: 200. */
+    jitter: number;
+    /** Predicate to decide whether to retry. */
+    retryOn?: (error: Error | null, statusCode?: number) => boolean;
+}
+export interface NLcURLSessionConfig {
+    baseURL?: string;
+    headers?: Record<string, string>;
+    timeout?: number | TimeoutConfig;
+    impersonate?: string;
+    ja3?: string;
+    akamai?: string;
+    stealth?: boolean;
+    proxy?: string;
+    proxyAuth?: [string, string];
+    followRedirects?: boolean;
+    maxRedirects?: number;
+    insecure?: boolean;
+    httpVersion?: '1.1' | '2';
+    cookieJar?: boolean | string;
+    retry?: Partial<RetryConfig>;
+    acceptEncoding?: string;
+}
+//# sourceMappingURL=request.d.ts.map

package/dist/core/request.d.ts.map

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

package/dist/core/request.js

@@ -0,0 +1,5 @@
+/**
+ * Request and configuration types for NLcURL.
+ */
+export {};
+//# sourceMappingURL=request.js.map

package/dist/core/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../src/core/request.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/core/response.d.ts

@@ -0,0 +1,48 @@
+/**
+ * NLcURL response model.
+ */
+import type { RequestTimings, HttpMethod } from './request.js';
+export interface ResponseMeta {
+    url: string;
+    method: HttpMethod;
+    headers: Record<string, string>;
+    command?: string;
+}
+export declare class NLcURLResponse<T = unknown> {
+    readonly status: number;
+    readonly statusText: string;
+    readonly headers: Record<string, string>;
+    /** Raw header pairs preserving duplicates (e.g. multiple Set-Cookie). */
+    readonly rawHeaders: Array<[string, string]>;
+    readonly rawBody: Buffer;
+    readonly httpVersion: string;
+    readonly url: string;
+    readonly redirectCount: number;
+    readonly timings: RequestTimings;
+    readonly request: ResponseMeta;
+    private _json;
+    private _text;
+    constructor(init: {
+        status: number;
+        statusText: string;
+        headers: Record<string, string>;
+        rawHeaders?: Array<[string, string]>;
+        rawBody: Buffer;
+        httpVersion: string;
+        url: string;
+        redirectCount: number;
+        timings: RequestTimings;
+        request: ResponseMeta;
+    });
+    /** Whether the status code is 2xx. */
+    get ok(): boolean;
+    /** Decode the body as UTF-8 text. Result is cached. */
+    text(): string;
+    /** Parse the body as JSON. Result is cached. Throws on invalid JSON. */
+    json<R = T>(): R;
+    /** Content-Length as reported by the server, or the actual body size. */
+    get contentLength(): number;
+    /** Shorthand for the content-type header value. */
+    get contentType(): string;
+}
+//# sourceMappingURL=response.d.ts.map

package/dist/core/response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../src/core/response.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/D,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,cAAc,CAAC,CAAC,GAAG,OAAO;IACrC,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,yEAAyE;IACzE,SAAgB,UAAU,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,SAAgB,WAAW,EAAE,MAAM,CAAC;IACpC,SAAgB,GAAG,EAAE,MAAM,CAAC;IAC5B,SAAgB,aAAa,EAAE,MAAM,CAAC;IACtC,SAAgB,OAAO,EAAE,cAAc,CAAC;IACxC,SAAgB,OAAO,EAAE,YAAY,CAAC;IAEtC,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,KAAK,CAAqB;gBAEtB,IAAI,EAAE;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QACrC,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,GAAG,EAAE,MAAM,CAAC;QACZ,aAAa,EAAE,MAAM,CAAC;QACtB,OAAO,EAAE,cAAc,CAAC;QACxB,OAAO,EAAE,YAAY,CAAC;KACvB;IAaD,sCAAsC;IACtC,IAAI,EAAE,IAAI,OAAO,CAEhB;IAED,uDAAuD;IACvD,IAAI,IAAI,MAAM;IASd,wEAAwE;IACxE,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC;IAOhB,yEAAyE;IACzE,IAAI,aAAa,IAAI,MAAM,CAO1B;IAED,mDAAmD;IACnD,IAAI,WAAW,IAAI,MAAM,CAExB;CACF"}

package/dist/core/response.js

@@ -0,0 +1,65 @@
+/**
+ * NLcURL response model.
+ */
+export class NLcURLResponse {
+    status;
+    statusText;
+    headers;
+    /** Raw header pairs preserving duplicates (e.g. multiple Set-Cookie). */
+    rawHeaders;
+    rawBody;
+    httpVersion;
+    url;
+    redirectCount;
+    timings;
+    request;
+    _json;
+    _text;
+    constructor(init) {
+        this.status = init.status;
+        this.statusText = init.statusText;
+        this.headers = init.headers;
+        this.rawHeaders = init.rawHeaders ?? Object.entries(init.headers);
+        this.rawBody = init.rawBody;
+        this.httpVersion = init.httpVersion;
+        this.url = init.url;
+        this.redirectCount = init.redirectCount;
+        this.timings = init.timings;
+        this.request = init.request;
+    }
+    /** Whether the status code is 2xx. */
+    get ok() {
+        return this.status >= 200 && this.status < 300;
+    }
+    /** Decode the body as UTF-8 text. Result is cached. */
+    text() {
+        let cached = this._text;
+        if (cached === undefined) {
+            cached = this.rawBody.toString('utf8');
+            this._text = cached;
+        }
+        return cached;
+    }
+    /** Parse the body as JSON. Result is cached. Throws on invalid JSON. */
+    json() {
+        if (this._json === undefined) {
+            this._json = JSON.parse(this.text());
+        }
+        return this._json;
+    }
+    /** Content-Length as reported by the server, or the actual body size. */
+    get contentLength() {
+        const cl = this.headers['content-length'];
+        if (cl !== undefined) {
+            const n = parseInt(cl, 10);
+            if (!Number.isNaN(n))
+                return n;
+        }
+        return this.rawBody.length;
+    }
+    /** Shorthand for the content-type header value. */
+    get contentType() {
+        return this.headers['content-type'] ?? '';
+    }
+}
+//# sourceMappingURL=response.js.map

package/dist/core/response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../../src/core/response.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,MAAM,OAAO,cAAc;IACT,MAAM,CAAS;IACf,UAAU,CAAS;IACnB,OAAO,CAAyB;IAChD,yEAAyE;IACzD,UAAU,CAA0B;IACpC,OAAO,CAAS;IAChB,WAAW,CAAS;IACpB,GAAG,CAAS;IACZ,aAAa,CAAS;IACtB,OAAO,CAAiB;IACxB,OAAO,CAAe;IAE9B,KAAK,CAAgB;IACrB,KAAK,CAAqB;IAElC,YAAY,IAWX;QACC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAClC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACpB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;QACxC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC9B,CAAC;IAED,sCAAsC;IACtC,IAAI,EAAE;QACJ,OAAO,IAAI,CAAC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC;IACjD,CAAC;IAED,uDAAuD;IACvD,IAAI;QACF,IAAI,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACvC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC;QACtB,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,wEAAwE;IACxE,IAAI;QACF,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC7B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,IAAI,CAAC,KAAU,CAAC;IACzB,CAAC;IAED,yEAAyE;IACzE,IAAI,aAAa;QACf,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAC1C,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;YACrB,MAAM,CAAC,GAAG,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YAC3B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBAAE,OAAO,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED,mDAAmD;IACnD,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;IAC5C,CAAC;CACF"}

package/dist/core/session.d.ts

@@ -0,0 +1,60 @@
+/**
+ * NLcURL Session.
+ *
+ * A persistent session that maintains cookies, connection pools,
+ * default configuration, and middleware across multiple requests.
+ */
+import type { NLcURLRequest, NLcURLSessionConfig, RequestBody } from './request.js';
+import { NLcURLResponse } from './response.js';
+import { CookieJar } from '../cookies/jar.js';
+import { type RequestInterceptor, type ResponseInterceptor } from '../middleware/interceptor.js';
+import { type RateLimitConfig } from '../middleware/rate-limiter.js';
+/**
+ * Convenience options for HTTP method shortcuts.
+ */
+export type RequestOptions = Omit<NLcURLRequest, 'url' | 'method' | 'body'>;
+export declare class NLcURLSession {
+    private readonly config;
+    private readonly negotiator;
+    private readonly cookieJar;
+    private readonly interceptors;
+    private rateLimiter;
+    private closed;
+    constructor(config?: NLcURLSessionConfig);
+    /**
+     * Register a request interceptor.
+     *
+     * Interceptors run before dispatch and may modify the outgoing request.
+     */
+    onRequest(fn: RequestInterceptor): this;
+    /**
+     * Register a response interceptor.
+     *
+     * Interceptors run after a response is received and may transform it.
+     */
+    onResponse(fn: ResponseInterceptor): this;
+    /**
+     * Enable per-session rate limiting.
+     */
+    setRateLimit(config: RateLimitConfig): this;
+    get(url: string, options?: RequestOptions): Promise<NLcURLResponse>;
+    post(url: string, body?: RequestBody, options?: RequestOptions): Promise<NLcURLResponse>;
+    put(url: string, body?: RequestBody, options?: RequestOptions): Promise<NLcURLResponse>;
+    patch(url: string, body?: RequestBody, options?: RequestOptions): Promise<NLcURLResponse>;
+    delete(url: string, options?: RequestOptions): Promise<NLcURLResponse>;
+    head(url: string, options?: RequestOptions): Promise<NLcURLResponse>;
+    options(url: string, options?: RequestOptions): Promise<NLcURLResponse>;
+    request(input: NLcURLRequest): Promise<NLcURLResponse>;
+    /**
+     * Return the session cookie jar, or `null` when cookie management is disabled.
+     */
+    getCookies(): CookieJar | null;
+    /**
+     * Close the session and release pooled connections.
+     */
+    close(): void;
+    private mergeDefaults;
+    private resolveProfile;
+    private executeWithRedirects;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/core/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/core/session.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EAGnB,WAAW,EAEZ,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAoB,KAAK,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnH,OAAO,EAAe,KAAK,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAMlF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC,CAAC;AAE5E,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;IAC7C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmB;IAChD,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,GAAE,mBAAwB;IAiB5C;;;;OAIG;IACH,SAAS,CAAC,EAAE,EAAE,kBAAkB,GAAG,IAAI;IAKvC;;;;OAIG;IACH,UAAU,CAAC,EAAE,EAAE,mBAAmB,GAAG,IAAI;IAKzC;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAO3C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAInE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAIxF,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAIvF,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAIzF,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAItE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAIpE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAMjE,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IA2C5D;;OAEG;IACH,UAAU,IAAI,SAAS,GAAG,IAAI;IAM9B;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb,OAAO,CAAC,aAAa;IA4DrB,OAAO,CAAC,cAAc;YAYR,oBAAoB;CA+HnC"}