@osqd/bothandlerjs 0.3.0

package/dist/corpus/headers.d.ts

@@ -0,0 +1,403 @@
+import type { CaseRequest } from "./schema.js";
+/**
+ * Header profiles for real clients.
+ *
+ * Three things here are load-bearing and easy to get wrong when writing fixtures by
+ * hand.
+ *
+ * **Order.** Each engine emits headers in a fixed sequence that differs between
+ * Chromium, Gecko and WebKit and barely changes across releases. It is one of the few
+ * properties a scraper cannot fix by copying a User-Agent, so a corpus that gets the
+ * order wrong is testing a client that does not exist.
+ *
+ * **Completeness.** A real browser sends a whole cluster together — the negotiation
+ * headers, the `Sec-Fetch-*` set, the Client Hints on Chromium, a dozen cookies it
+ * never asked for. Omitting one because it seemed unimportant turns a human fixture
+ * into a bot fixture and quietly inverts what the case proves.
+ *
+ * **The optional apparatus.** Modern browsers carry a long tail of conditional
+ * headers: high-entropy Client Hints once a server has asked for them, `Sec-GPC` from
+ * privacy-preserving builds, `Save-Data` on metered connections, `Sec-Purpose` on
+ * speculative loads, `Early-Data` on a TLS 1.3 resumption, cache validators on a
+ * revisit. Each is modelled here because each is something a hand-rolled client
+ * forgets, and because a corpus of only the happy path tests only the happy path.
+ *
+ * Sources: 2026 User-Agent lists; W3C `TR/fetch-metadata` for the `Sec-Fetch-*`
+ * combinations; the UA Client Hints specification for the `Sec-CH-*` set; observed
+ * request captures.
+ */
+export type Header = readonly [name: string, value: string];
+/** What kind of request this is. Decides the `Sec-Fetch-*` set and the `Accept` value. */
+export type RequestKind = 
+/** Typing a URL or following a bookmark: no referrer, user-initiated. */
+"navigate"
+/** Following a link within the site. */
+ | "same-origin-navigate"
+/** Arriving from another site. */
+ | "cross-site-navigate"
+/** A form POST back to the same origin. */
+ | "form-post"
+/** `fetch()` for JSON from page script. */
+ | "xhr"
+/** A cross-origin `fetch()` that will be preflighted. */
+ | "cors"
+/** An image, font or stylesheet. */
+ | "subresource"
+/** A stylesheet specifically. */
+ | "stylesheet"
+/** A script tag. */
+ | "script"
+/** A media byte-range request from a `<video>`. */
+ | "media"
+/** An `EventSource` stream. */
+ | "eventsource"
+/** A `<iframe>` load. */
+ | "iframe";
+export interface ProfileOptions {
+    kind?: RequestKind;
+    host?: string;
+    /** Cookie header value. See `cookies.ts` for realistic jars. */
+    cookie?: string;
+    referer?: string;
+    origin?: string;
+    /** Overrides the profile's default language list — a real setting people change. */
+    acceptLanguage?: string;
+    /** High-entropy Client Hints, sent only after a server advertises `Accept-CH`. */
+    highEntropyHints?: boolean;
+    /** `DNT: 1`. Still sent by a meaningful minority despite being deprecated. */
+    dnt?: boolean;
+    /** `Sec-GPC: 1` — Global Privacy Control, sent by Brave, DuckDuckGo and others. */
+    gpc?: boolean;
+    /** `Save-Data: on` — a metered or data-saver connection. */
+    saveData?: boolean;
+    /** Network Information hints (`RTT`, `Downlink`, `ECT`), also gated behind `Accept-CH`. */
+    networkHints?: {
+        rtt: number;
+        downlink: number;
+        ect: "slow-2g" | "2g" | "3g" | "4g";
+    };
+    /** Layout hints (`Viewport-Width`, `DPR`, `Width`), gated behind `Accept-CH`. */
+    layoutHints?: {
+        viewportWidth: number;
+        dpr: number;
+    };
+    /** Conditional request headers from a revisit. */
+    revalidate?: {
+        etag?: string;
+        modifiedSince?: string;
+    };
+    /** `Cache-Control: max-age=0`, which a browser sends on an explicit reload. */
+    reload?: boolean;
+    /** `Sec-Purpose: prefetch` plus the legacy `Purpose` header. */
+    prefetch?: boolean;
+    /** `Sec-Fetch-Storage-Access`, sent by recent Chromium in third-party contexts. */
+    storageAccess?: "none" | "active" | "inactive";
+    /** User preference hints, sent when the server asks for them. */
+    prefers?: {
+        colorScheme?: "light" | "dark";
+        reducedMotion?: "no-preference" | "reduce";
+    };
+    /** `Early-Data: 1` — a TLS 1.3 0-RTT resumption replayed by an intermediary. */
+    earlyData?: boolean;
+    /** Byte range for a media request. */
+    range?: string;
+    /** Body content type for a POST. */
+    contentType?: string;
+    contentLength?: number;
+}
+interface EngineProfile {
+    userAgent: string;
+    acceptDocument: string;
+    acceptEncoding: string;
+    acceptLanguage: string;
+    build: (options: ResolvedOptions, self: EngineProfile) => Header[];
+}
+type ResolvedOptions = ProfileOptions & Required<Pick<ProfileOptions, "host" | "kind" | "acceptLanguage">>;
+/** Firefox leads with identity and content negotiation, and closes with Fetch Metadata. */
+declare function geckoBuild(options: ResolvedOptions, self: EngineProfile): Header[];
+/** Safari interleaves Fetch Metadata with content negotiation rather than grouping it. */
+declare function webkitBuild(options: ResolvedOptions, self: EngineProfile): Header[];
+/** Older WebKit and embedded builds: no Fetch Metadata at all. */
+declare function legacyWebkitBuild(options: ResolvedOptions, self: EngineProfile): Header[];
+export declare const PROFILES: {
+    readonly chromeWindows: {
+        readonly userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/152.0.0.0 Safari/537.36";
+        readonly acceptDocument: "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7";
+        readonly acceptEncoding: "gzip, deflate, br, zstd";
+        readonly acceptLanguage: "en-US,en;q=0.9";
+        readonly build: (options: ResolvedOptions, self: EngineProfile) => Header[];
+    };
+    readonly chromeMac: {
+        readonly userAgent: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/152.0.0.0 Safari/537.36";
+        readonly acceptDocument: "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7";
+        readonly acceptEncoding: "gzip, deflate, br, zstd";
+        readonly acceptLanguage: "en-GB,en-US;q=0.9,en;q=0.8";
+        readonly build: (options: ResolvedOptions, self: EngineProfile) => Header[];
+    };
+    readonly chromeLinux: {
+        readonly userAgent: "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/152.0.0.0 Safari/537.36";
+        readonly acceptDocument: "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7";
+        readonly acceptEncoding: "gzip, deflate, br, zstd";
+        readonly acceptLanguage: "en-US,en;q=0.9";
+        readonly build: (options: ResolvedOptions, self: EngineProfile) => Header[];
+    };
+    readonly chromeChromeOs: {
+        readonly userAgent: "Mozilla/5.0 (X11; CrOS x86_64 15886.69.0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/151.0.0.0 Safari/537.36";
+        readonly acceptDocument: "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7";
+        readonly acceptEncoding: "gzip, deflate, br, zstd";
+        readonly acceptLanguage: "en-US,en;q=0.9";
+        readonly build: (options: ResolvedOptions, self: EngineProfile) => Header[];
+    };
+    readonly edgeWindows: {
+        readonly userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/150.0.0.0 Safari/537.36 Edg/150.0.0.0";
+        readonly acceptDocument: "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7";
+        readonly acceptEncoding: "gzip, deflate, br, zstd";
+        readonly acceptLanguage: "en-US,en;q=0.9";
+        readonly build: (options: ResolvedOptions, self: EngineProfile) => Header[];
+    };
+    readonly edgeMac: {
+        readonly userAgent: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/150.0.0.0 Safari/537.36 Edg/150.0.0.0";
+        readonly acceptDocument: "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7";
+        readonly acceptEncoding: "gzip, deflate, br, zstd";
+        readonly acceptLanguage: "en-US,en;q=0.9";
+        readonly build: (options: ResolvedOptions, self: EngineProfile) => Header[];
+    };
+    readonly operaWindows: {
+        readonly userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/149.0.0.0 Safari/537.36 OPR/135.0.0.0";
+        readonly acceptDocument: "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7";
+        readonly acceptEncoding: "gzip, deflate, br, zstd";
+        readonly acceptLanguage: "en-US,en;q=0.9";
+        readonly build: (options: ResolvedOptions, self: EngineProfile) => Header[];
+    };
+    readonly vivaldiWindows: {
+        readonly userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/148.0.0.0 Safari/537.36 Vivaldi/7.6.3797.48";
+        readonly acceptDocument: "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7";
+        readonly acceptEncoding: "gzip, deflate, br, zstd";
+        readonly acceptLanguage: "en-US,en;q=0.9";
+        readonly build: (options: ResolvedOptions, self: EngineProfile) => Header[];
+    };
+    /** Brave presents an unmodified Chrome identity by design, and adds Sec-GPC. */
+    readonly braveWindows: {
+        readonly userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/152.0.0.0 Safari/537.36";
+        readonly acceptDocument: "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7";
+        readonly acceptEncoding: "gzip, deflate, br, zstd";
+        readonly acceptLanguage: "en-US,en;q=0.9";
+        readonly build: (options: ResolvedOptions, self: EngineProfile) => Header[];
+    };
+    readonly yandexWindows: {
+        readonly userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/146.0.0.0 YaBrowser/25.8.0.0 Safari/537.36";
+        readonly acceptDocument: "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7";
+        readonly acceptEncoding: "gzip, deflate, br, zstd";
+        readonly acceptLanguage: "ru,en;q=0.9";
+        readonly build: (options: ResolvedOptions, self: EngineProfile) => Header[];
+    };
+    readonly firefoxWindows: {
+        readonly userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:148.0) Gecko/20100101 Firefox/148.0";
+        readonly acceptDocument: "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/png,image/svg+xml,*/*;q=0.8";
+        readonly acceptEncoding: "gzip, deflate, br, zstd";
+        readonly acceptLanguage: "en-US,en;q=0.5";
+        readonly build: typeof geckoBuild;
+    };
+    readonly firefoxMac: {
+        readonly userAgent: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:148.0) Gecko/20100101 Firefox/148.0";
+        readonly acceptDocument: "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/png,image/svg+xml,*/*;q=0.8";
+        readonly acceptEncoding: "gzip, deflate, br, zstd";
+        readonly acceptLanguage: "en-GB,en;q=0.5";
+        readonly build: typeof geckoBuild;
+    };
+    readonly firefoxLinux: {
+        readonly userAgent: "Mozilla/5.0 (X11; Linux x86_64; rv:148.0) Gecko/20100101 Firefox/148.0";
+        readonly acceptDocument: "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/png,image/svg+xml,*/*;q=0.8";
+        readonly acceptEncoding: "gzip, deflate, br, zstd";
+        readonly acceptLanguage: "de-DE,de;q=0.8,en-US;q=0.5,en;q=0.3";
+        readonly build: typeof geckoBuild;
+    };
+    readonly firefoxEsr: {
+        readonly userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:140.0) Gecko/20100101 Firefox/140.0";
+        readonly acceptDocument: "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/png,image/svg+xml,*/*;q=0.8";
+        readonly acceptEncoding: "gzip, deflate, br, zstd";
+        readonly acceptLanguage: "en-US,en;q=0.5";
+        readonly build: typeof geckoBuild;
+    };
+    readonly firefoxAndroid: {
+        readonly userAgent: "Mozilla/5.0 (Android 15; Mobile; rv:148.0) Gecko/148.0 Firefox/148.0";
+        readonly acceptDocument: "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/png,image/svg+xml,*/*;q=0.8";
+        readonly acceptEncoding: "gzip, deflate, br, zstd";
+        readonly acceptLanguage: "en-GB,en;q=0.5";
+        readonly build: typeof geckoBuild;
+    };
+    readonly safariMac: {
+        readonly userAgent: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.7 Safari/605.1.15";
+        readonly acceptDocument: "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8";
+        readonly acceptEncoding: "gzip, deflate, br";
+        readonly acceptLanguage: "en-GB,en;q=0.9";
+        readonly build: typeof webkitBuild;
+    };
+    readonly safariIos: {
+        readonly userAgent: "Mozilla/5.0 (iPhone; CPU iPhone OS 18_7 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.7 Mobile/15E148 Safari/604.1";
+        readonly acceptDocument: "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8";
+        readonly acceptEncoding: "gzip, deflate, br";
+        readonly acceptLanguage: "en-US,en;q=0.9";
+        readonly build: typeof webkitBuild;
+    };
+    readonly safariIpad: {
+        readonly userAgent: "Mozilla/5.0 (iPad; CPU OS 18_7 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.7 Mobile/15E148 Safari/604.1";
+        readonly acceptDocument: "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8";
+        readonly acceptEncoding: "gzip, deflate, br";
+        readonly acceptLanguage: "en-GB,en;q=0.9";
+        readonly build: typeof webkitBuild;
+    };
+    /** Chrome on iOS is WebKit underneath — the engine, and so the header order, is Safari's. */
+    readonly chromeIos: {
+        readonly userAgent: "Mozilla/5.0 (iPhone; CPU iPhone OS 18_7 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) CriOS/152.0.7258.60 Mobile/15E148 Safari/604.1";
+        readonly acceptDocument: "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8";
+        readonly acceptEncoding: "gzip, deflate, br";
+        readonly acceptLanguage: "en-US,en;q=0.9";
+        readonly build: typeof webkitBuild;
+    };
+    readonly firefoxIos: {
+        readonly userAgent: "Mozilla/5.0 (iPhone; CPU iPhone OS 18_7 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) FxiOS/140.0 Mobile/15E148 Safari/605.1.15";
+        readonly acceptDocument: "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8";
+        readonly acceptEncoding: "gzip, deflate, br";
+        readonly acceptLanguage: "en-US,en;q=0.9";
+        readonly build: typeof webkitBuild;
+    };
+    readonly edgeIos: {
+        readonly userAgent: "Mozilla/5.0 (iPhone; CPU iPhone OS 18_7 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.0 EdgiOS/150.0.3296.60 Mobile/15E148 Safari/605.1.15";
+        readonly acceptDocument: "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8";
+        readonly acceptEncoding: "gzip, deflate, br";
+        readonly acceptLanguage: "en-US,en;q=0.9";
+        readonly build: typeof webkitBuild;
+    };
+    readonly duckduckgoIos: {
+        readonly userAgent: "Mozilla/5.0 (iPhone; CPU iPhone OS 18_7 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.7 Mobile/15E148 Safari/604.1 DuckDuckGo/7";
+        readonly acceptDocument: "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8";
+        readonly acceptEncoding: "gzip, deflate, br";
+        readonly acceptLanguage: "en-US,en;q=0.9";
+        readonly build: typeof webkitBuild;
+    };
+    readonly chromeAndroid: {
+        readonly userAgent: "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/150.0.0.0 Mobile Safari/537.36";
+        readonly acceptDocument: "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7";
+        readonly acceptEncoding: "gzip, deflate, br, zstd";
+        readonly acceptLanguage: "en-GB,en;q=0.9";
+        readonly build: (options: ResolvedOptions, self: EngineProfile) => Header[];
+    };
+    readonly chromeAndroidTablet: {
+        readonly userAgent: "Mozilla/5.0 (Linux; Android 15; SM-X910) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/150.0.0.0 Safari/537.36";
+        readonly acceptDocument: "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7";
+        readonly acceptEncoding: "gzip, deflate, br, zstd";
+        readonly acceptLanguage: "en-US,en;q=0.9";
+        readonly build: (options: ResolvedOptions, self: EngineProfile) => Header[];
+    };
+    readonly samsungInternet: {
+        readonly userAgent: "Mozilla/5.0 (Linux; Android 15; SM-S938B) AppleWebKit/537.36 (KHTML, like Gecko) SamsungBrowser/29.0 Chrome/147.0.0.0 Mobile Safari/537.36";
+        readonly acceptDocument: "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7";
+        readonly acceptEncoding: "gzip, deflate, br";
+        readonly acceptLanguage: "ko-KR,ko;q=0.9,en-US;q=0.8,en;q=0.7";
+        readonly build: (options: ResolvedOptions, self: EngineProfile) => Header[];
+    };
+    readonly operaAndroid: {
+        readonly userAgent: "Mozilla/5.0 (Linux; Android 14; CPH2451) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/146.0.0.0 Mobile Safari/537.36 OPR/91.0.0.0";
+        readonly acceptDocument: "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7";
+        readonly acceptEncoding: "gzip, deflate, br";
+        readonly acceptLanguage: "id-ID,id;q=0.9,en-US;q=0.8";
+        readonly build: (options: ResolvedOptions, self: EngineProfile) => Header[];
+    };
+    readonly edgeAndroid: {
+        readonly userAgent: "Mozilla/5.0 (Linux; Android 15; Pixel 9) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/150.0.0.0 Mobile Safari/537.36 EdgA/150.0.3296.60";
+        readonly acceptDocument: "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7";
+        readonly acceptEncoding: "gzip, deflate, br, zstd";
+        readonly acceptLanguage: "en-US,en;q=0.9";
+        readonly build: (options: ResolvedOptions, self: EngineProfile) => Header[];
+    };
+    /** UC Browser — very large user base across South and Southeast Asia. */
+    readonly ucBrowser: {
+        readonly userAgent: "Mozilla/5.0 (Linux; U; Android 13; en-IN; RMX3771 Build/TP1A.220905.001) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/100.0.4896.58 UCBrowser/13.7.5.1329 Mobile Safari/537.36";
+        readonly acceptDocument: "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8";
+        readonly acceptEncoding: "gzip, deflate";
+        readonly acceptLanguage: "en-IN,en-US;q=0.9,en;q=0.8,hi;q=0.7";
+        readonly build: typeof legacyWebkitBuild;
+    };
+    readonly miBrowser: {
+        readonly userAgent: "Mozilla/5.0 (Linux; U; Android 14; en-in; 23049PCD8I Build/UKQ1.230917.001) AppleWebKit/533.1 (KHTML, like Gecko) Version/4.0 Chrome/125.0.6422.165 Mobile Safari/533.1 XiaoMi/MiuiBrowser/19.4.220521";
+        readonly acceptDocument: "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8";
+        readonly acceptEncoding: "gzip, deflate";
+        readonly acceptLanguage: "en-IN,en;q=0.9";
+        readonly build: typeof legacyWebkitBuild;
+    };
+    readonly huaweiBrowser: {
+        readonly userAgent: "Mozilla/5.0 (Linux; Android 12; ELS-NX9; HMSCore 6.14.0.302) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.6478.186 HuaweiBrowser/15.0.5.310 Mobile Safari/537.36";
+        readonly acceptDocument: "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7";
+        readonly acceptEncoding: "gzip, deflate, br";
+        readonly acceptLanguage: "zh-CN,zh;q=0.9,en;q=0.8";
+        readonly build: typeof legacyWebkitBuild;
+    };
+    readonly qqBrowser: {
+        readonly userAgent: "Mozilla/5.0 (Linux; U; Android 14; zh-cn; 2211133C Build/UKQ1.230804.001) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/122.0.6261.119 MQQBrowser/15.7 Mobile Safari/537.36";
+        readonly acceptDocument: "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8";
+        readonly acceptEncoding: "gzip, deflate";
+        readonly acceptLanguage: "zh-CN,zh;q=0.9";
+        readonly build: typeof legacyWebkitBuild;
+    };
+    readonly silkKindle: {
+        readonly userAgent: "Mozilla/5.0 (Linux; Android 11; KFRAWI) AppleWebKit/537.36 (KHTML, like Gecko) Silk/128.1.2 like Chrome/128.0.6613.146 Safari/537.36";
+        readonly acceptDocument: "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7";
+        readonly acceptEncoding: "gzip, deflate, br";
+        readonly acceptLanguage: "en-GB,en;q=0.9";
+        readonly build: typeof legacyWebkitBuild;
+    };
+    readonly tizenTv: {
+        readonly userAgent: "Mozilla/5.0 (SMART-TV; LINUX; Tizen 8.0) AppleWebKit/537.36 (KHTML, like Gecko) 108.0.5359.1/8.0 TV Safari/537.36";
+        readonly acceptDocument: "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8";
+        readonly acceptEncoding: "gzip, deflate";
+        readonly acceptLanguage: "en-US";
+        readonly build: typeof legacyWebkitBuild;
+    };
+    readonly webOsTv: {
+        readonly userAgent: "Mozilla/5.0 (Web0S; Linux/SmartTV) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/108.0.5359.215 Safari/537.36 WebAppManager";
+        readonly acceptDocument: "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8";
+        readonly acceptEncoding: "gzip, deflate";
+        readonly acceptLanguage: "en-GB";
+        readonly build: typeof legacyWebkitBuild;
+    };
+    readonly playstation: {
+        readonly userAgent: "Mozilla/5.0 (PlayStation; PlayStation 5/9.60) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.0 Safari/605.1.15";
+        readonly acceptDocument: "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8";
+        readonly acceptEncoding: "gzip, deflate, br";
+        readonly acceptLanguage: "en-GB";
+        readonly build: typeof legacyWebkitBuild;
+    };
+    readonly nintendoSwitch: {
+        readonly userAgent: "Mozilla/5.0 (Nintendo Switch; WifiWebAuthApplet) AppleWebKit/609.4 (KHTML, like Gecko) NF/6.0.2.23.4 NintendoBrowser/5.1.0.23519";
+        readonly acceptDocument: "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8";
+        readonly acceptEncoding: "gzip, deflate";
+        readonly acceptLanguage: "en-GB";
+        readonly build: typeof legacyWebkitBuild;
+    };
+};
+export type ProfileName = keyof typeof PROFILES;
+export declare const PROFILE_NAMES: ProfileName[];
+/** Builds a request from a named profile. The normal way to write a human case. */
+export declare function browser(name: ProfileName, options?: ProfileOptions): CaseRequest;
+/** The raw User-Agent of a profile, for cases that alter it deliberately. */
+export declare function userAgentOf(name: ProfileName): string;
+/**
+ * A minimal bot-shaped request: a User-Agent and whatever else you name.
+ *
+ * Most automation really does send this little. Where a specific client is known to
+ * send more, the case says so explicitly rather than using this helper.
+ */
+export declare function plain(userAgent: string, extra?: readonly Header[], host?: string): CaseRequest;
+/**
+ * A well-behaved crawler's request: identity, a contact address, and the negotiation
+ * headers a fetcher that intends to parse HTML actually sends.
+ */
+export declare function crawler(userAgent: string, options?: {
+    from?: string;
+    accept?: string;
+    encoding?: string;
+    host?: string;
+    extra?: readonly Header[];
+}): CaseRequest;
+export {};

package/dist/corpus/humans-apps.d.ts

@@ -0,0 +1,2 @@
+import type { TrafficCase } from "./schema.js";
+export declare const HUMAN_APP_CASES: TrafficCase[];

package/dist/corpus/humans-browsers.d.ts

@@ -0,0 +1,2 @@
+import type { TrafficCase } from "./schema.js";
+export declare const HUMAN_BROWSER_CASES: TrafficCase[];

package/dist/corpus/humans.d.ts

@@ -0,0 +1,2 @@
+import type { TrafficCase } from "./schema.js";
+export declare const HUMAN_CASES: TrafficCase[];