nlcurl 0.6.0 → 0.7.0

package/dist/cache/store.d.ts

@@ -0,0 +1,89 @@
+import type { CacheConfig, CacheDirectives, CacheEntry, CacheLookupResult, CacheMode } from "./types.js";
+import type { NLcURLRequest } from "../core/request.js";
+import { NLcURLResponse } from "../core/response.js";
+/**
+ * In-memory HTTP response cache implementing RFC 9111.
+ *
+ * Features:
+ * - Cache-Control directive parsing and freshness calculation
+ * - ETag / Last-Modified conditional request header injection
+ * - 304 Not Modified response merging
+ * - Vary header support
+ * - LRU eviction by entry count and total body size
+ * - Range request passthrough (does not cache partial responses by default)
+ */
+export declare class CacheStore {
+    private readonly entries;
+    private readonly maxEntries;
+    private readonly maxSize;
+    private currentSize;
+    private readonly mode;
+    /** Monotonic counter for deterministic LRU ordering within the same ms. */
+    private accessCounter;
+    constructor(config?: CacheConfig);
+    /**
+     * Generates a cache key from a request. The key is `METHOD:URL`.
+     */
+    static cacheKey(method: string, url: string): string;
+    /**
+     * Looks up a cached response and evaluates its freshness.
+     *
+     * @param req - The outgoing request to match against cache.
+     * @returns A lookup result with the entry and freshness status.
+     */
+    lookup(req: NLcURLRequest): CacheLookupResult;
+    /**
+     * Determines what action to take for a request given the cache state
+     * and the configured cache mode.
+     *
+     * Returns conditional headers to add (If-None-Match / If-Modified-Since)
+     * when the entry is stale and needs revalidation.
+     */
+    evaluate(req: NLcURLRequest, modeOverride?: CacheMode): {
+        conditionalHeaders?: Record<string, string>;
+        shouldStore: boolean;
+        matchedEntry?: CacheEntry;
+        serveCached?: CacheEntry;
+    };
+    /**
+     * Stores a response in the cache if it is cacheable per RFC 9111 §3.
+     */
+    store(req: NLcURLRequest, response: NLcURLResponse): void;
+    /**
+     * Merges a 304 Not Modified response with a cached entry, producing
+     * a full response with updated headers.
+     */
+    mergeNotModified(entry: CacheEntry, response304: NLcURLResponse): NLcURLResponse;
+    /**
+     * Constructs a full NLcURLResponse from a cache entry for direct serving.
+     */
+    responseFromEntry(entry: CacheEntry, req: NLcURLRequest): NLcURLResponse;
+    /** Returns the number of cached entries. */
+    get size(): number;
+    /** Returns the total byte size of all cached response bodies. */
+    get totalSize(): number;
+    /** Clears all cached entries. */
+    clear(): void;
+    /**
+     * Removes a specific cache entry by method and URL.
+     */
+    delete(method: string, url: string): boolean;
+    /**
+     * Checks whether request headers match the stored Vary fields.
+     */
+    private varyMatches;
+    /**
+     * Finds the key of the least recently accessed entry.
+     */
+    private findLRUKey;
+    /**
+     * Evicts least-recently-used entries until there is room for a new entry
+     * of the given size.
+     */
+    private evictIfNeeded;
+}
+/**
+ * Parses a `Cache-Control` header value into structured directives.
+ */
+export declare function parseCacheControl(value: string): CacheDirectives;
+//# sourceMappingURL=store.d.ts.map

package/dist/cache/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/cache/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,UAAU,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACzG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAWrD;;;;;;;;;;GAUG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAY;IACjC,2EAA2E;IAC3E,OAAO,CAAC,aAAa,CAAK;gBAEd,MAAM,CAAC,EAAE,WAAW;IAMhC;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAIpD;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,aAAa,GAAG,iBAAiB;IA8B7C;;;;;;OAMG;IACH,QAAQ,CACN,GAAG,EAAE,aAAa,EAClB,YAAY,CAAC,EAAE,SAAS,GACvB;QACD,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC5C,WAAW,EAAE,OAAO,CAAC;QACrB,YAAY,CAAC,EAAE,UAAU,CAAC;QAC1B,WAAW,CAAC,EAAE,UAAU,CAAC;KAC1B;IA6CD;;OAEG;IACH,KAAK,CAAC,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI;IAyDzD;;;OAGG;IACH,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,GAAG,cAAc;IA0BhF;;OAEG;IACH,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,aAAa,GAAG,cAAc;IAcxE,4CAA4C;IAC5C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,iEAAiE;IACjE,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,iCAAiC;IACjC,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAW5C;;OAEG;IACH,OAAO,CAAC,WAAW;IASnB;;OAEG;IACH,OAAO,CAAC,UAAU;IAYlB;;;OAGG;IACH,OAAO,CAAC,aAAa;CAiBtB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CA0EhE"}

package/dist/cache/store.js

@@ -0,0 +1,402 @@
+import { NLcURLResponse } from "../core/response.js";
+const DEFAULT_MAX_ENTRIES = 1000;
+const DEFAULT_MAX_SIZE = 50 * 1024 * 1024;
+/** HTTP methods whose responses may be cached (RFC 9111 §3). */
+const CACHEABLE_METHODS = new Set(["GET", "HEAD"]);
+/** Status codes that are cacheable by default (RFC 9111 §3). */
+const CACHEABLE_STATUS = new Set([200, 203, 204, 206, 300, 301, 308, 404, 405, 410, 414, 501]);
+/**
+ * In-memory HTTP response cache implementing RFC 9111.
+ *
+ * Features:
+ * - Cache-Control directive parsing and freshness calculation
+ * - ETag / Last-Modified conditional request header injection
+ * - 304 Not Modified response merging
+ * - Vary header support
+ * - LRU eviction by entry count and total body size
+ * - Range request passthrough (does not cache partial responses by default)
+ */
+export class CacheStore {
+    entries = new Map();
+    maxEntries;
+    maxSize;
+    currentSize = 0;
+    mode;
+    /** Monotonic counter for deterministic LRU ordering within the same ms. */
+    accessCounter = 0;
+    constructor(config) {
+        this.maxEntries = config?.maxEntries ?? DEFAULT_MAX_ENTRIES;
+        this.maxSize = config?.maxSize ?? DEFAULT_MAX_SIZE;
+        this.mode = config?.mode ?? "default";
+    }
+    /**
+     * Generates a cache key from a request. The key is `METHOD:URL`.
+     */
+    static cacheKey(method, url) {
+        return `${method.toUpperCase()}:${url}`;
+    }
+    /**
+     * Looks up a cached response and evaluates its freshness.
+     *
+     * @param req - The outgoing request to match against cache.
+     * @returns A lookup result with the entry and freshness status.
+     */
+    lookup(req) {
+        const method = (req.method ?? "GET").toUpperCase();
+        if (!CACHEABLE_METHODS.has(method)) {
+            return { fresh: false, staleWhileRevalidate: false };
+        }
+        const key = CacheStore.cacheKey(method, req.url);
+        const entry = this.entries.get(key);
+        if (!entry) {
+            return { fresh: false, staleWhileRevalidate: false };
+        }
+        if (!this.varyMatches(entry, req)) {
+            return { fresh: false, staleWhileRevalidate: false };
+        }
+        entry.lastAccessedAt = ++this.accessCounter;
+        const age = (Date.now() - entry.storedAt) / 1000;
+        const freshness = computeFreshnessLifetime(entry);
+        const fresh = age < freshness;
+        let staleWhileRevalidate = false;
+        if (!fresh && entry.directives.staleWhileRevalidate !== undefined) {
+            staleWhileRevalidate = age < freshness + entry.directives.staleWhileRevalidate;
+        }
+        return { entry, fresh, staleWhileRevalidate };
+    }
+    /**
+     * Determines what action to take for a request given the cache state
+     * and the configured cache mode.
+     *
+     * Returns conditional headers to add (If-None-Match / If-Modified-Since)
+     * when the entry is stale and needs revalidation.
+     */
+    evaluate(req, modeOverride) {
+        const mode = modeOverride ?? this.mode;
+        if (mode === "no-store") {
+            return { shouldStore: false };
+        }
+        const result = this.lookup(req);
+        if (mode === "force-cache" && result.entry) {
+            return { serveCached: result.entry, shouldStore: false };
+        }
+        if (mode === "only-if-cached") {
+            if (result.entry) {
+                return { serveCached: result.entry, shouldStore: false };
+            }
+            return { shouldStore: false };
+        }
+        if (result.fresh && mode === "default") {
+            return { serveCached: result.entry, shouldStore: false };
+        }
+        const conditionalHeaders = {};
+        let matchedEntry;
+        if (result.entry) {
+            matchedEntry = result.entry;
+            if (result.entry.etag) {
+                conditionalHeaders["if-none-match"] = result.entry.etag;
+            }
+            if (result.entry.lastModified) {
+                conditionalHeaders["if-modified-since"] = result.entry.lastModified;
+            }
+        }
+        const hasConditional = Object.keys(conditionalHeaders).length > 0;
+        return {
+            conditionalHeaders: hasConditional ? conditionalHeaders : undefined,
+            shouldStore: true,
+            matchedEntry,
+        };
+    }
+    /**
+     * Stores a response in the cache if it is cacheable per RFC 9111 §3.
+     */
+    store(req, response) {
+        const method = (req.method ?? "GET").toUpperCase();
+        if (!CACHEABLE_METHODS.has(method))
+            return;
+        const directives = parseCacheControl(response.headers["cache-control"] ?? "");
+        if (directives.noStore)
+            return;
+        if (!CACHEABLE_STATUS.has(response.status) && directives.maxAge === undefined && directives.sMaxAge === undefined) {
+            return;
+        }
+        if (response.status === 206)
+            return;
+        const key = CacheStore.cacheKey(method, req.url);
+        const varyFields = parseVary(response.headers["vary"] ?? "");
+        if (varyFields.includes("*"))
+            return;
+        const varyHeaders = {};
+        for (const field of varyFields) {
+            varyHeaders[field] = req.headers?.[field] ?? "";
+        }
+        const bodySize = response.rawBody.length;
+        this.evictIfNeeded(bodySize);
+        const existing = this.entries.get(key);
+        if (existing) {
+            this.currentSize -= existing.bodySize;
+            this.entries.delete(key);
+        }
+        const now = Date.now();
+        const entry = {
+            key,
+            status: response.status,
+            statusText: response.statusText,
+            headers: { ...response.headers },
+            body: Buffer.from(response.rawBody),
+            httpVersion: response.httpVersion,
+            url: response.url,
+            storedAt: now,
+            etag: response.headers["etag"],
+            lastModified: response.headers["last-modified"],
+            directives,
+            varyFields,
+            varyHeaders,
+            bodySize,
+            lastAccessedAt: ++this.accessCounter,
+        };
+        this.entries.set(key, entry);
+        this.currentSize += bodySize;
+    }
+    /**
+     * Merges a 304 Not Modified response with a cached entry, producing
+     * a full response with updated headers.
+     */
+    mergeNotModified(entry, response304) {
+        const mergedHeaders = { ...entry.headers };
+        for (const [k, v] of Object.entries(response304.headers)) {
+            if (k === "content-length" || k === "content-encoding" || k === "transfer-encoding")
+                continue;
+            mergedHeaders[k] = v;
+        }
+        entry.headers = mergedHeaders;
+        entry.storedAt = Date.now();
+        if (response304.headers["etag"])
+            entry.etag = response304.headers["etag"];
+        if (response304.headers["last-modified"])
+            entry.lastModified = response304.headers["last-modified"];
+        entry.directives = parseCacheControl(mergedHeaders["cache-control"] ?? "");
+        return new NLcURLResponse({
+            status: entry.status,
+            statusText: entry.statusText,
+            headers: mergedHeaders,
+            rawBody: entry.body,
+            httpVersion: entry.httpVersion,
+            url: entry.url,
+            redirectCount: response304.redirectCount,
+            timings: response304.timings,
+            request: response304.request,
+        });
+    }
+    /**
+     * Constructs a full NLcURLResponse from a cache entry for direct serving.
+     */
+    responseFromEntry(entry, req) {
+        return new NLcURLResponse({
+            status: entry.status,
+            statusText: entry.statusText,
+            headers: { ...entry.headers },
+            rawBody: entry.body,
+            httpVersion: entry.httpVersion,
+            url: entry.url,
+            redirectCount: 0,
+            timings: { dns: 0, connect: 0, tls: 0, firstByte: 0, total: 0 },
+            request: { url: req.url, method: (req.method ?? "GET"), headers: req.headers ?? {} },
+        });
+    }
+    /** Returns the number of cached entries. */
+    get size() {
+        return this.entries.size;
+    }
+    /** Returns the total byte size of all cached response bodies. */
+    get totalSize() {
+        return this.currentSize;
+    }
+    /** Clears all cached entries. */
+    clear() {
+        this.entries.clear();
+        this.currentSize = 0;
+    }
+    /**
+     * Removes a specific cache entry by method and URL.
+     */
+    delete(method, url) {
+        const key = CacheStore.cacheKey(method, url);
+        const entry = this.entries.get(key);
+        if (entry) {
+            this.currentSize -= entry.bodySize;
+            this.entries.delete(key);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Checks whether request headers match the stored Vary fields.
+     */
+    varyMatches(entry, req) {
+        for (const field of entry.varyFields) {
+            const stored = entry.varyHeaders[field] ?? "";
+            const current = req.headers?.[field] ?? "";
+            if (stored !== current)
+                return false;
+        }
+        return true;
+    }
+    /**
+     * Finds the key of the least recently accessed entry.
+     */
+    findLRUKey() {
+        let lruKey;
+        let lruTime = Infinity;
+        for (const [key, entry] of this.entries) {
+            if (entry.lastAccessedAt < lruTime) {
+                lruTime = entry.lastAccessedAt;
+                lruKey = key;
+            }
+        }
+        return lruKey;
+    }
+    /**
+     * Evicts least-recently-used entries until there is room for a new entry
+     * of the given size.
+     */
+    evictIfNeeded(incomingSize) {
+        while (this.entries.size >= this.maxEntries) {
+            const lruKey = this.findLRUKey();
+            if (lruKey === undefined)
+                break;
+            const entry = this.entries.get(lruKey);
+            if (entry)
+                this.currentSize -= entry.bodySize;
+            this.entries.delete(lruKey);
+        }
+        while (this.currentSize + incomingSize > this.maxSize && this.entries.size > 0) {
+            const lruKey = this.findLRUKey();
+            if (lruKey === undefined)
+                break;
+            const entry = this.entries.get(lruKey);
+            if (entry)
+                this.currentSize -= entry.bodySize;
+            this.entries.delete(lruKey);
+        }
+    }
+}
+/**
+ * Parses a `Cache-Control` header value into structured directives.
+ */
+export function parseCacheControl(value) {
+    const directives = {
+        noCache: false,
+        noStore: false,
+        mustRevalidate: false,
+        proxyRevalidate: false,
+        public: false,
+        private: false,
+        immutable: false,
+    };
+    if (!value)
+        return directives;
+    const parts = value.toLowerCase().split(",");
+    for (const part of parts) {
+        const trimmed = part.trim();
+        if (!trimmed)
+            continue;
+        const eqIdx = trimmed.indexOf("=");
+        const name = eqIdx === -1 ? trimmed : trimmed.slice(0, eqIdx).trim();
+        const val = eqIdx === -1
+            ? undefined
+            : trimmed
+                .slice(eqIdx + 1)
+                .trim()
+                .replace(/^"|"$/g, "");
+        switch (name) {
+            case "max-age": {
+                const n = parseInt(val ?? "", 10);
+                if (Number.isFinite(n) && n >= 0)
+                    directives.maxAge = n;
+                break;
+            }
+            case "s-maxage": {
+                const n = parseInt(val ?? "", 10);
+                if (Number.isFinite(n) && n >= 0)
+                    directives.sMaxAge = n;
+                break;
+            }
+            case "no-cache":
+                directives.noCache = true;
+                break;
+            case "no-store":
+                directives.noStore = true;
+                break;
+            case "must-revalidate":
+                directives.mustRevalidate = true;
+                break;
+            case "proxy-revalidate":
+                directives.proxyRevalidate = true;
+                break;
+            case "public":
+                directives.public = true;
+                break;
+            case "private":
+                directives.private = true;
+                break;
+            case "immutable":
+                directives.immutable = true;
+                break;
+            case "stale-while-revalidate": {
+                const n = parseInt(val ?? "", 10);
+                if (Number.isFinite(n) && n >= 0)
+                    directives.staleWhileRevalidate = n;
+                break;
+            }
+            case "stale-if-error": {
+                const n = parseInt(val ?? "", 10);
+                if (Number.isFinite(n) && n >= 0)
+                    directives.staleIfError = n;
+                break;
+            }
+        }
+    }
+    return directives;
+}
+/**
+ * Computes the freshness lifetime in seconds for a cache entry (RFC 9111 §4.2).
+ *
+ * Priority: Cache-Control max-age > Expires header > heuristic.
+ */
+function computeFreshnessLifetime(entry) {
+    if (entry.directives.maxAge !== undefined) {
+        return entry.directives.maxAge;
+    }
+    const expires = entry.headers["expires"];
+    if (expires) {
+        const expTime = Date.parse(expires);
+        if (!Number.isNaN(expTime)) {
+            const dateHeader = entry.headers["date"];
+            const responseDate = dateHeader ? Date.parse(dateHeader) : entry.storedAt;
+            if (!Number.isNaN(responseDate)) {
+                return Math.max(0, (expTime - responseDate) / 1000);
+            }
+        }
+    }
+    if (entry.lastModified) {
+        const lmTime = Date.parse(entry.lastModified);
+        if (!Number.isNaN(lmTime)) {
+            const age = (entry.storedAt - lmTime) / 1000;
+            return Math.min(age * 0.1, 86400);
+        }
+    }
+    return 0;
+}
+/**
+ * Parses a Vary header into an array of lowercased field names.
+ */
+function parseVary(value) {
+    if (!value)
+        return [];
+    return value
+        .split(",")
+        .map((v) => v.trim().toLowerCase())
+        .filter(Boolean);
+}
+//# sourceMappingURL=store.js.map

package/dist/cache/store.js.map

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

package/dist/cache/types.d.ts

@@ -0,0 +1,101 @@
+import type { NLcURLResponse } from "../core/response.js";
+/**
+ * Configuration for the HTTP cache layer (RFC 9111).
+ */
+export interface CacheConfig {
+    /** Enable response caching. Defaults to `true` when a CacheStore is provided. */
+    enabled?: boolean;
+    /** Maximum number of entries to store. Defaults to `1000`. */
+    maxEntries?: number;
+    /** Maximum total byte size of cached response bodies. Defaults to `50 * 1024 * 1024` (50 MB). */
+    maxSize?: number;
+    /** Cache mode controlling request/response behavior. */
+    mode?: CacheMode;
+}
+/**
+ * Cache modes mirroring the Fetch API `cache` option but adapted for
+ * a full HTTP client.
+ *
+ * - `"default"` — Standard caching: serve fresh, revalidate stale.
+ * - `"no-store"` — Never read from or write to cache.
+ * - `"no-cache"` — Always revalidate with the origin, even if the response is fresh.
+ * - `"force-cache"` — Serve from cache regardless of freshness; only fetch on miss.
+ * - `"only-if-cached"` — Only return cached responses; fail with 504 on miss.
+ */
+export type CacheMode = "default" | "no-store" | "no-cache" | "force-cache" | "only-if-cached";
+/**
+ * Parsed Cache-Control directives from a response header.
+ */
+export interface CacheDirectives {
+    maxAge?: number;
+    sMaxAge?: number;
+    noCache: boolean;
+    noStore: boolean;
+    mustRevalidate: boolean;
+    proxyRevalidate: boolean;
+    public: boolean;
+    private: boolean;
+    immutable: boolean;
+    staleWhileRevalidate?: number;
+    staleIfError?: number;
+}
+/**
+ * Serializable metadata for a cached response.
+ */
+export interface CacheEntry {
+    /** Cache key (method + URL). */
+    key: string;
+    /** HTTP status code. */
+    status: number;
+    /** HTTP status text. */
+    statusText: string;
+    /** Response headers (normalized lowercase). */
+    headers: Record<string, string>;
+    /** Raw response body bytes. */
+    body: Buffer;
+    /** HTTP version string. */
+    httpVersion: string;
+    /** The final URL of the response. */
+    url: string;
+    /** Timestamp (ms since epoch) when the response was stored. */
+    storedAt: number;
+    /** ETag value from the response, if present. */
+    etag?: string;
+    /** Last-Modified value from the response, if present. */
+    lastModified?: string;
+    /** Parsed Cache-Control directives. */
+    directives: CacheDirectives;
+    /** The Vary header field names, lowercased. */
+    varyFields: string[];
+    /** The request headers that matched the Vary fields at storage time. */
+    varyHeaders: Record<string, string>;
+    /** Byte size of the body for LRU accounting. */
+    bodySize: number;
+    /** Timestamp (ms since epoch) when the entry was last accessed (for LRU). */
+    lastAccessedAt: number;
+}
+/**
+ * Describes a cache lookup result.
+ */
+export interface CacheLookupResult {
+    /** The matching cache entry, or undefined on a miss. */
+    entry?: CacheEntry;
+    /** Whether the entry is still fresh. */
+    fresh: boolean;
+    /** Whether the entry can be served stale while revalidating. */
+    staleWhileRevalidate: boolean;
+}
+/**
+ * Result of applying cache logic to decide request behavior.
+ */
+export interface CacheDecision {
+    /** If set, the cached response to serve directly. */
+    cachedResponse?: NLcURLResponse;
+    /** If set, conditional headers to add to the outgoing request. */
+    conditionalHeaders?: Record<string, string>;
+    /** Whether to store the response in cache after receiving it. */
+    shouldStore: boolean;
+    /** The cache entry that was matched (for 304 merging). */
+    matchedEntry?: CacheEntry;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cache/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cache/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,iFAAiF;IACjF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iGAAiG;IACjG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,aAAa,GAAG,gBAAgB,CAAC;AAE/F;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,UAAU,EAAE,eAAe,CAAC;IAC5B,+CAA+C;IAC/C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,wEAAwE;IACxE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,wDAAwD;IACxD,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,wCAAwC;IACxC,KAAK,EAAE,OAAO,CAAC;IACf,gEAAgE;IAChE,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,kEAAkE;IAClE,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,iEAAiE;IACjE,WAAW,EAAE,OAAO,CAAC;IACrB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,UAAU,CAAC;CAC3B"}

package/dist/cache/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/cache/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/cache/types.ts"],"names":[],"mappings":""}

package/dist/cookies/jar.d.ts

@@ -14,6 +14,8 @@ export declare class CookieJar {
     private cookies;
     private readonly maxCookies;
     private readonly maxCookiesPerDomain;
+    /** Monotonic counter for deterministic LRU ordering within the same ms. */
+    private accessCounter;
     constructor(options?: CookieJarOptions);
     /**
      * Parses all `Set-Cookie` values from `headers` (or from `rawHeaders` when
@@ -74,6 +76,15 @@ export declare class CookieJar {
      */
     loadNetscapeString(content: string): void;
     private store;
+    /**
+     * Evicts the least recently accessed cookie from a specific domain.
+     */
+    private evictLRUForDomain;
+    /**
+     * Evicts one cookie globally, preferring the domain with the most cookies
+     * and then the least recently accessed cookie within that domain.
+     */
+    private evictGlobalLRU;
     private matches;
     private domainMatches;
     private pathMatches;

package/dist/cookies/jar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jar.d.ts","sourceRoot":"","sources":["../../src/cookies/jar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAK5E,MAAM,WAAW,gBAAgB;IAC/B,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;GAIG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;gBAEjC,OAAO,CAAC,EAAE,gBAAgB;IAKtC;;;;;;;;OAQG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI;IAWxG;;;;;;;;OAQG;IACH,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM;IAajC;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIjC;;;;;OAKG;IACH,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC;IAI5B;;;;OAIG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;;OAKG;IACH,gBAAgB,IAAI,MAAM;IAmB1B;;;;;;OAMG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IA0BzC,OAAO,CAAC,KAAK;IAsBb,OAAO,CAAC,OAAO;IAgBf,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,sBAAsB;CAY/B"}
+{"version":3,"file":"jar.d.ts","sourceRoot":"","sources":["../../src/cookies/jar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAK5E,MAAM,WAAW,gBAAgB;IAC/B,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;GAIG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAC7C,2EAA2E;IAC3E,OAAO,CAAC,aAAa,CAAK;gBAEd,OAAO,CAAC,EAAE,gBAAgB;IAKtC;;;;;;;;OAQG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI;IAWxG;;;;;;;;OAQG;IACH,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM;IAiBjC;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIjC;;;;;OAKG;IACH,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC;IAI5B;;;;OAIG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;;OAKG;IACH,gBAAgB,IAAI,MAAM;IAmB1B;;;;;;OAMG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IA2BzC,OAAO,CAAC,KAAK;IAuBb;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAazB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAsBtB,OAAO,CAAC,OAAO;IAgBf,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,sBAAsB;CAY/B"}