kinetex 0.0.2 → 1.0.0-rc.2

package/dist/types/cookie-parser.d.ts

@@ -0,0 +1,203 @@
+/**
+ *
+ * Full RFC 6265 §5.1 + §5.2 implementation:
+ *  - Cookie-date parser (§5.1.1) — handles all real-world broken formats
+ *  - Domain canonicalization (§5.1.2)
+ *  - Domain matching (§5.1.3)
+ *  - Path computation + matching (§5.1.4)
+ *  - Set-Cookie header parser (§5.2)
+ *  - Public Suffix List (full algorithm + embedded rules)
+ *  - IDN / punycode basic support
+ *  - IPv4 + IPv6 detection
+ */
+/** SameSite cookie attribute value. `"Unset"` means no SameSite attribute was present. */
+export type SameSite = "Strict" | "Lax" | "None" | "Unset";
+/**
+ * A parsed Set-Cookie header with all attributes extracted.
+ */
+export interface ParsedCookie {
+    /** Cookie name */
+    name: string;
+    /** Cookie value */
+    value: string;
+    /** Domain attribute (canonicalized, leading dot stripped), or null */
+    domain: string | null;
+    /** Path attribute, or null */
+    path: string | null;
+    /** Expires timestamp (ms), or null */
+    expires: number | null;
+    /** Max-Age in seconds, or null */
+    maxAge: number | null;
+    /** Secure flag */
+    secure: boolean;
+    /** HttpOnly flag */
+    httpOnly: boolean;
+    /** SameSite attribute value */
+    sameSite: SameSite;
+    /** Chrome Privacy Sandbox SameParty flag */
+    sameParty: boolean;
+    /** Chrome Cookie Priority value, or null */
+    priority: "Low" | "Medium" | "High" | null;
+    /** CHIPS Partitioned flag */
+    partitioned: boolean;
+}
+/**
+ * Parse a cookie date string per RFC 6265 §5.1.1
+ *
+ * @param dateStr - The date string to parse
+ * @returns Unix timestamp (ms) if valid, null otherwise
+ *
+ * Supported formats (per RFC 6265 §5.1.1 and real-world broken variants):
+ *
+ * | Format                          | Example                                    |
+ * |--------------------------------|-------------------------------------------|
+ * | HTTP-date (RFC 5322)           | "Thu, 01 Jan 2099 00:00:00 GMT"           |
+ * | RFC 850                         | "Thursday, 01-Jan-99 00:00:00 GMT"        |
+ * | ANSI C asctime()               | "Thu Jan  1 00:00:00 2099"                |
+ * | Short numeric                  | "01/01/2099 00:00:00"                     |
+ * | Cookie spec (RFC 2109)         | "Thu, 01-Jan-2099 00:00:00 GMT"           |
+ * | Broken variants (lenient)     | Various real-world malformed dates       |
+ *
+ * Algorithm:
+ * 1. Tokenize input into time, month, day-of-month, year tokens
+ * 2. Extract time component (HH:MM:SS format)
+ * 3. Extract month (3-letter or full name)
+ * 4. Extract day-of-month (1-31)
+ * 5. Extract year (2-digit with RFC 6265 §5.1.1 step 3 mapping, or 4-digit)
+ * 6. Validate: year must be 1601-9999, day must be 1-31
+ * 7. Return UTC timestamp or null if invalid
+ *
+ * Notes:
+ * - Two-digit years are mapped: 00-69 → 2000-2069, 70-99 → 1970-1999
+ * - Lenient on whitespace and minor format variations
+ * - Returns null for dates with missing components or invalid ranges
+ */
+export declare function parseCookieDate(dateStr: string): number | null;
+/**
+ * Get the public suffix (TLD or effective TLD) for a hostname.
+ * Uses an embedded Public Suffix List covering ccTLDs, common second-level
+ * registrations, wildcards, and exceptions.
+ *
+ * @param hostname - Fully qualified hostname (e.g., "www.example.co.uk")
+ * @returns The public suffix (e.g., "co.uk"), or null for empty/invalid input
+ */
+export declare function getPublicSuffix(hostname: string): string | null;
+/**
+ * Get the registrable domain (aka effective TLD + 1 label) for a hostname.
+ * Returns null for bare TLDs or invalid input.
+ * For IP addresses, returns the IP itself.
+ */
+export declare function getRegistrableDomain(hostname: string): string | null;
+/**
+ * Check whether a hostname is a public suffix (TLD or effective TLD).
+ * Returns true for exact PSL matches and wildcard-covered domains.
+ */
+export declare function isPublicSuffix(hostname: string): boolean;
+/**
+ * Decode an IDN label using Intl.IDN or punycode fallback.
+ * Tries Node `domainToUnicode`, then Deno `Intl.IDN`, then native RFC 3492 decoder.
+ * Available in: Node.js 12+, Deno 1.14+, Bun, modern browsers, Cloudflare Workers.
+ *
+ * @param label - The label to decode (e.g., "xn--fiqs83s")
+ * @returns Decoded label (e.g., "中国") or original if not punycode
+ */
+export declare function decodeIDNLabel(label: string): string;
+/**
+ * Fully canonicalize a domain string per RFC 6265:
+ * strip leading/trailing dots, lowercase, decode IDN labels.
+ *
+ * @param domain - Domain string to canonicalize (e.g., "Example.Com" or ".EXAMPLE.com.")
+ * @returns Canonicalized domain (e.g., "example.com")
+ */
+export declare function canonicalizeDomainFull(domain: string): string;
+/**
+ * Check whether a host string is an IPv4 or IPv6 address.
+ *
+ * @param host - Host string to check (may include brackets for IPv6, e.g. "[::1]")
+ * @returns true if the host is an IP address
+ */
+export declare function isIPAddress(host: string): boolean;
+/**
+ * Domain matching per RFC 6265 §5.1.3
+ *
+ * @param requestHost - The request host (e.g., "example.com")
+ * @param cookieDomain - The cookie domain attribute (e.g., ".example.com")
+ * @returns true if the cookie should be sent for this request host
+ */
+export declare function domainMatch(requestHost: string, cookieDomain: string): boolean;
+/**
+ * Compute the default cookie path per RFC 6265 §5.1.4.
+ * Strips the trailing segment from the request path.
+ *
+ * @param requestPath - The request URI path (e.g., "/foo/bar")
+ * @returns Default cookie path (e.g., "/foo")
+ */
+export declare function defaultPath(requestPath: string): string;
+/**
+ * Normalize a URL path by resolving `.` and `..` segments.
+ * This prevents path traversal attacks via malformed cookie paths.
+ *
+ * @param path - The path to normalize (e.g., "/foo/bar/../baz")
+ * @returns Normalized path with resolved segments (e.g., "/foo/baz")
+ *
+ * @example
+ * normalizePath("/foo/bar/../baz") // "/foo/baz"
+ * normalizePath("/foo/./bar")      // "/foo/bar"
+ * normalizePath("foo")            // "/foo"
+ */
+export declare function normalizePath(path: string): string;
+/**
+ * Path matching per RFC 6265 §5.1.4 — checks whether a cookie path
+ * matches a request path. Both paths are normalized before comparison.
+ *
+ * @param requestPath - Request URI path (e.g., "/foo/bar/baz")
+ * @param cookiePath - Cookie Path attribute (e.g., "/foo")
+ * @returns true if the cookie path matches the request path
+ */
+export declare function pathMatch(requestPath: string, cookiePath: string): boolean;
+/**
+ * Parse a single Set-Cookie header value per RFC 6265 §5.2.
+ * Returns null for empty or syntactically invalid headers.
+ *
+ * @param header - The raw Set-Cookie header value (e.g., "session=abc123; Path=/; Secure")
+ * @returns Parsed cookie, or null on failure
+ */
+export declare function parseSetCookieHeader(header: string): ParsedCookie | null;
+/**
+ * Serialize a ParsedCookie back to a Set-Cookie header string.
+ *
+ * @param cookie - The parsed cookie to serialize
+ * @returns Set-Cookie header string (e.g., "name=value; Path=/; Secure")
+ *
+ * @example
+ * const cookie: ParsedCookie = { name: "session", value: "abc123", path: "/", secure: true, ... };
+ * formatSetCookieHeader(cookie); // "session=abc123; Path=/; Secure"
+ */
+export declare function formatSetCookieHeader(cookie: ParsedCookie): string;
+/**
+ * Split a raw Set-Cookie header value (or collapsed multi-value string)
+ * into individual cookie strings.
+ *
+ * This is non-trivial because:
+ *  - Expires values contain commas: "Expires=Thu, 01 Jan 2099 00:00:00 GMT"
+ *  - Multiple Set-Cookie headers may be collapsed with ", " by some HTTP stacks
+ *
+ * Strategy: Token-based state machine that properly handles:
+ *   - Quoted values with commas inside (e.g., `foo="bar,baz"`)
+ *   - Escaped quotes inside quoted values (e.g., `foo="bar\"baz"`)
+ *   - Attribute values that may contain commas
+ *   - Only commits a cookie when we've seen both name and value
+ *
+ * @param raw - Raw Set-Cookie header string (possibly containing multiple cookies)
+ * @returns Array of individual Set-Cookie strings
+ */
+export declare function splitSetCookieHeaders(raw: string): string[];
+/**
+ * Extract all Set-Cookie header values from a Headers object or plain record.
+ * Uses Headers.getSetCookie() when available (Deno, Node 18+).
+ *
+ * @param headers - Headers object or plain key-value record
+ * @returns Array of Set-Cookie header strings
+ */
+export declare function extractSetCookieHeaders(headers: Headers | Record<string, string | string[]>): string[];
+//# sourceMappingURL=cookie-parser.d.ts.map

package/dist/types/cookie-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookie-parser.d.ts","sourceRoot":"","sources":["../../src/cookie-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,0FAA0F;AAC1F,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,sCAAsC;IACtC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,kCAAkC;IAClC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,kBAAkB;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,oBAAoB;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,+BAA+B;IAC/B,QAAQ,EAAE,QAAQ,CAAC;IACnB,4CAA4C;IAC5C,SAAS,EAAE,OAAO,CAAC;IACnB,4CAA4C;IAC5C,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,IAAI,CAAC;IAC3C,6BAA6B;IAC7B,WAAW,EAAE,OAAO,CAAC;CACtB;AAqGD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwE9D;AAszCD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA8C/D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYpE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAWxD;AA4FD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAsCpD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAK7D;AASD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOjD;AAMD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAqB9E;AAMD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAuBlD;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAc1E;AAmCD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CA0HxE;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAoElE;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAsG3D;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,GACnD,MAAM,EAAE,CAkBV"}

package/dist/types/cookie-store.d.ts

@@ -0,0 +1,316 @@
+/**
+ * cookie-store.ts
+ *
+ * Full RFC 6265 §5.3 + §5.4 implementation:
+ *  - Storage model (creation time, last access, persistent vs session)
+ *  - Cookie retrieval algorithm (domain, path, secure, httpOnly, SameSite)
+ *  - __Secure- / __Host- prefix enforcement (RFC 6265bis §4.1.3)
+ *  - SameSite Strict / Lax / None enforcement (full state machine)
+ *  - LRU eviction: per-domain cap (50) + global cap (3000)
+ *  - Atomic update semantics (update preserves createdAt)
+ *  - Full JSON serialization / deserialization with expiry filtering
+ *  - clear / clearExpired / clearSession / clearForDomain / clearForUrl
+ */
+import { type SameSite } from "./cookie-parser.ts";
+/**
+ * A single HTTP cookie per RFC 6265 §5.3 storage model.
+ * Tracks name, value, domain, path, expiry, security flags, SameSite policy,
+ * creation and last-access times, and host-only status.
+ */
+export interface Cookie {
+    /** Cookie name (may be empty string) */
+    name: string;
+    /** Cookie value */
+    value: string;
+    /** Canonicalized domain (no leading dot, lowercased, IDN-decoded) */
+    domain: string;
+    /** Cookie path */
+    path: string;
+    /**
+     * Absolute expiry time in ms since epoch.
+     * Infinity means session cookie (no Expires/Max-Age).
+     */
+    expires: number;
+    /** Raw Max-Age value in seconds as parsed (null if not present) */
+    maxAge: number | null;
+    /** Secure flag */
+    secure: boolean;
+    /** HttpOnly flag */
+    httpOnly: boolean;
+    /** SameSite policy */
+    sameSite: SameSite;
+    /** Creation time in ms since epoch (RFC 6265 §5.3 step 2) */
+    createdAt: number;
+    /** Last-access time in ms since epoch (RFC 6265 §5.3 step 2) */
+    lastAccessed: number;
+    /**
+     * Host-only flag (RFC 6265 §5.3 step 6):
+     * true  = cookie was set without a Domain attribute → exact host match only
+     * false = cookie has a Domain attribute → subdomain matching applies
+     */
+    hostOnly: boolean;
+}
+/**
+ * Serializable form of a Cookie for JSON persistence.
+ * Infinity (session) expiry is stored as null.
+ */
+export interface CookieJSON {
+    /** Cookie name */
+    name: string;
+    /** Cookie value */
+    value: string;
+    /** Canonicalized domain */
+    domain: string;
+    /** Cookie path */
+    path: string;
+    /** Absolute expiry time in ms since epoch, or null for session cookies */
+    expires: number | null;
+    /** Raw Max-Age value in seconds, or null if not present */
+    maxAge: number | null;
+    /** Secure flag */
+    secure: boolean;
+    /** HttpOnly flag */
+    httpOnly: boolean;
+    /** SameSite policy */
+    sameSite: SameSite;
+    /** Creation time in ms since epoch */
+    createdAt: number;
+    /** Last-access time in ms since epoch */
+    lastAccessed: number;
+    /** Host-only flag */
+    hostOnly: boolean;
+}
+/**
+ * SameSite request context.
+ *
+ * "strict"     = same-site, any method
+ * "lax"        = cross-site, but safe method (GET/HEAD) top-level navigation
+ * "cross-site" = cross-site, non-safe or non-top-level
+ * "none"       = no enforcement (e.g. direct URL bar navigation)
+ */
+export type SameSiteContext = "strict" | "lax" | "cross-site" | "none";
+export interface SetCookieOptions {
+    /** Full URL the Set-Cookie header was received from */
+    url: string;
+    /**
+     * SameSite context of the request that produced this Set-Cookie response.
+     * Defaults to "none" (no restriction on setting).
+     */
+    sameSiteContext?: SameSiteContext;
+}
+export interface GetCookiesOptions {
+    /** Full URL cookies are being requested for */
+    url: string;
+    /**
+     * Is this an HTTP(S) request?
+     * false = script/document context → HttpOnly cookies are withheld.
+     * Defaults to true.
+     */
+    http?: boolean;
+    /**
+     * SameSite context for the outgoing request.
+     * Defaults to "none" (send all cookies).
+     */
+    sameSiteContext?: SameSiteContext;
+}
+/**
+ * Options for creating a CookieJar instance
+ */
+export interface CookieJarOptions {
+    /** Maximum total cookies across all domains (default: 3000) */
+    maxTotal?: number;
+    /** Maximum cookies per domain (default: 50) */
+    maxPerDomain?: number;
+    /** Custom domain match function (default: internal domainMatch) */
+    domainMatcher?: (requestHost: string, cookieDomain: string) => boolean;
+}
+/**
+ * RFC 6265 §5.3 + §5.4 cookie jar implementation.
+ *
+ * Stores cookies in a three-level map (domain → path → name) with:
+ *  - LRU eviction (per-domain cap of 50, global cap of 3000)
+ *  - __Secure- / __Host- prefix enforcement (RFC 6265bis §4.1.3)
+ *  - SameSite Strict / Lax / None enforcement
+ *  - JSON serialization / deserialization
+ *
+ * @example
+ * const jar = new CookieJar();
+ * jar.setCookie("session=abc; Path=/; Secure", { url: "https://example.com/" });
+ * const cookies = jar.getCookies({ url: "https://example.com/page" });
+ */
+export declare class CookieJar {
+    private readonly dm;
+    private total;
+    private cleanupTimer;
+    private readonly maxTotal;
+    private readonly maxPerDomain;
+    private readonly domainMatcherFn;
+    /**
+     * @param options - Cookie jar limits and optional custom domain matcher
+     */
+    constructor(options?: CookieJarOptions);
+    /**
+     * Destroy the jar — clears the periodic cleanup timer.
+     * Call this when the jar is no longer needed to prevent memory leaks.
+     */
+    destroy(): void;
+    /**
+     * Set a cookie per RFC 6265 §5.3.
+     *
+     * Rejects cookies that exceed size limits, fail domain/path validation,
+     * violate prefix rules, or would be immediately expired (treats those as deletes).
+     *
+     * @param header  - Raw Set-Cookie header value (e.g. "session=abc; Path=/; Secure")
+     * @param options - URL the cookie was received from + SameSite context
+     * @returns true if the cookie was stored, false if rejected
+     */
+    setCookie(header: string, options: SetCookieOptions): boolean;
+    /**
+     * Retrieve matching cookies per RFC 6265 §5.4.
+     *
+     * Filters by domain, path, secure/httpOnly flags, and SameSite context.
+     * Results are sorted by longest path first, then oldest creation time.
+     * Updates lastAccessed on returned cookies.
+     *
+     * @param options - URL, protocol context, and SameSite context
+     * @returns Array of matching Cookie objects (direct references into storage)
+     */
+    getCookies(options: GetCookiesOptions): Cookie[];
+    /**
+     * Get a Cookie header string for a request.
+     *
+     * @param options - URL and request context
+     * @returns "name=value; name=value" string suitable for a Cookie header
+     */
+    getCookieHeader(options: GetCookiesOptions): string;
+    /**
+     * Get all cookies for a specific domain.
+     *
+     * @param domain - The domain to get cookies for (will be canonicalized)
+     * @returns Array of cookies that would be sent to this domain
+     *
+     * @example
+     * jar.setCookie("session=abc", { url: "https://example.com/" });
+     * jar.getCookiesForDomain("example.com"); // Returns cookies for example.com
+     */
+    getCookiesForDomain(domain: string): Cookie[];
+    /**
+     * Process Set-Cookie headers from an HTTP response.
+     * Extracts all Set-Cookie values and calls setCookie() for each.
+     *
+     * @param headers - Response headers (Headers object or plain record)
+     * @param options - URL and SameSite context for all cookies
+     */
+    processResponseHeaders(headers: Headers | Record<string, string | string[]>, options: SetCookieOptions): void;
+    /**
+     * Remove a specific cookie by domain, path, and name.
+     *
+     * @param domain - Domain the cookie was stored under
+     * @param path   - Cookie path
+     * @param name   - Cookie name
+     * @returns true if a cookie was removed
+     */
+    removeCookie(domain: string, path: string, name: string): boolean;
+    /**
+     * Remove every cookie from the jar.
+     */
+    clear(): void;
+    /**
+     * Remove all expired cookies from the jar.
+     *
+     * @returns Number of cookies removed
+     */
+    clearExpired(): number;
+    /**
+     * Remove all session cookies (cookies with no expiry / Infinity).
+     *
+     * @returns Number of cookies removed
+     */
+    clearSession(): number;
+    /**
+     * Remove all cookies for a domain and its subdomains.
+     *
+     * @param domain - Domain to clear (e.g., "example.com" clears sub.example.com too)
+     * @returns Number of cookies removed
+     */
+    clearForDomain(domain: string): number;
+    /**
+     * Remove all cookies that would be sent to a given URL.
+     *
+     * @param url - Full URL whose hostname cookies should be cleared
+     * @returns Number of cookies removed
+     */
+    clearForUrl(url: string): number;
+    /**
+     * Serialize all non-expired cookies to a JSON-compatible array.
+     * Session cookies (Infinity) are stored with `expires: null`.
+     *
+     * @returns Array of serialized cookies
+     */
+    toJSON(): CookieJSON[];
+    /**
+     * Get a pretty-printed JSON string of all cookies.
+     *
+     * @returns Formatted JSON string
+     */
+    toString(): string;
+    /**
+     * Deserialize cookies from JSON and create a new CookieJar.
+     * Expired cookies in the input are silently skipped.
+     *
+     * @param data - Array of serialized cookies or a JSON string
+     * @returns A new CookieJar populated with the deserialized cookies
+     */
+    static fromJSON(data: CookieJSON[] | string): CookieJar;
+    /**
+     * Total number of cookies currently stored in the jar.
+     */
+    get count(): number;
+    /**
+     * Return a snapshot of all cookies (copies, not references to internal storage).
+     *
+     * @returns Array of cloned Cookie objects
+     */
+    getAll(): Cookie[];
+    /**
+     * Return all cookies for a given domain (exact match + subdomains).
+     *
+     * @param domain - Domain to query (e.g., "example.com")
+     * @returns Array of cloned Cookie objects for matching domains
+     */
+    getForDomain(domain: string): Cookie[];
+    /**
+     * Store or update a cookie in the internal map.
+     * Preserves original createdAt on update per RFC 6265 §5.3 step 11.
+     */
+    private putCookie;
+    /**
+     * Evict the least-recently-accessed cookie from a domain when
+     * the per-domain cap is exceeded. Evicts down to maxPerDomain - 1.
+     */
+    private evictForDomain;
+    /**
+     * Evict the least-recently-accessed cookie globally when
+     * the total cap is exceeded. Evicts down to below maxTotal.
+     */
+    private evictGlobal;
+    /**
+     * Check whether a request host matches a cookie domain.
+     * Uses custom matcher if provided, otherwise does suffix matching.
+     */
+    private matchDomain;
+}
+/**
+ * Create a new empty CookieJar.
+ *
+ * @returns A new CookieJar instance
+ */
+export declare function createCookieJar(): CookieJar;
+/**
+ * Load a CookieJar from previously serialized JSON data.
+ *
+ * @param data - CookieJSON array or JSON string
+ * @returns A new CookieJar populated with the deserialized cookies
+ */
+export declare function loadCookieJar(data: string | CookieJSON[]): CookieJar;
+//# sourceMappingURL=cookie-store.d.ts.map

package/dist/types/cookie-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookie-store.d.ts","sourceRoot":"","sources":["../../src/cookie-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,KAAK,QAAQ,EASd,MAAM,oBAAoB,CAAC;AAM5B;;;;GAIG;AACH,MAAM,WAAW,MAAM;IACrB,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,kBAAkB;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,oBAAoB;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,sBAAsB;IACtB,QAAQ,EAAE,QAAQ,CAAC;IACnB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,YAAY,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,2DAA2D;IAC3D,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,kBAAkB;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,oBAAoB;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,sBAAsB;IACtB,QAAQ,EAAE,QAAQ,CAAC;IACnB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB;IACrB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAMD;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,KAAK,GAAG,YAAY,GAAG,MAAM,CAAC;AAEvE,MAAM,WAAW,gBAAgB;IAC/B,uDAAuD;IACvD,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAwGD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,aAAa,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC;CACxE;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAwB;IAC3C,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,YAAY,CAA+C;IAGnE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkE;IAElG;;OAEG;gBACS,OAAO,GAAE,gBAAqB;IAuB1C;;;OAGG;IACH,OAAO,IAAI,IAAI;IAWf;;;;;;;;;OASG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO;IA6G7D;;;;;;;;;OASG;IACH,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,EAAE;IA0EhD;;;;;OAKG;IACH,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM;IAUnD;;;;;;;;;OASG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;IAwB7C;;;;;;OAMG;IACH,sBAAsB,CACpB,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,EACpD,OAAO,EAAE,gBAAgB,GACxB,IAAI;IAUP;;;;;;;OAOG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IAmBjE;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;;;OAIG;IACH,YAAY,IAAI,MAAM;IAmBtB;;;;OAIG;IACH,YAAY,IAAI,MAAM;IAkBtB;;;;;OAKG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAetC;;;;;OAKG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAUhC;;;;;OAKG;IACH,MAAM,IAAI,UAAU,EAAE;IA6BtB;;;;OAIG;IACH,QAAQ,IAAI,MAAM;IAIlB;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,MAAM,GAAG,SAAS;IAiCvD;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;;;OAIG;IACH,MAAM,IAAI,MAAM,EAAE;IAUlB;;;;;OAKG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;IAiBtC;;;OAGG;IACH,OAAO,CAAC,SAAS;IAuBjB;;;OAGG;IACH,OAAO,CAAC,cAAc;IA4BtB;;;OAGG;IACH,OAAO,CAAC,WAAW;IA0BnB;;;OAGG;IACH,OAAO,CAAC,WAAW;CAapB;AAwBD;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,SAAS,CAE3C;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,GAAG,SAAS,CAEpE"}