google-fli 0.1.0

package/dist/search/client.js

@@ -0,0 +1,205 @@
+/**
+ * HTTP client with rate limiting, retries, and proxy support.
+ *
+ * Replaces the Python `curl_cffi` impersonation with a `fetch`-based
+ * client that:
+ *
+ *   - sends realistic Chrome-like headers
+ *   - honours HTTPS_PROXY / HTTP_PROXY env vars (Bun's fetch supports this
+ *     via the `proxy` option)
+ *   - rate-limits at 10 req/sec via {@link TokenBucketRateLimiter}
+ *   - retries network errors with exponential backoff
+ *   - wraps low-level errors into the typed {@link SearchClientError} family
+ */
+import { TokenBucketRateLimiter } from "./concurrency.js";
+import { SearchClientError, SearchConnectionError, SearchHTTPError, SearchTimeoutError, } from "./exceptions.js";
+const DEFAULT_CALLS_PER_SECOND = 10;
+const DEFAULT_TIMEOUT_MS = 60_000;
+const DEFAULT_RETRIES = 3;
+const DEFAULT_BACKOFF_MS = 1_000;
+function parseEnvTimeoutMs() {
+    const raw = typeof process !== "undefined" ? process.env?.FLI_TIMEOUT : undefined;
+    if (raw == null)
+        return DEFAULT_TIMEOUT_MS;
+    const n = Number.parseFloat(raw);
+    if (!Number.isFinite(n)) {
+        throw new Error(`FLI_TIMEOUT must be a number of seconds, got: ${JSON.stringify(raw)}`);
+    }
+    if (n <= 0) {
+        throw new Error(`FLI_TIMEOUT must be a positive number, got: ${JSON.stringify(raw)}`);
+    }
+    return Math.round(n * 1000);
+}
+function resolveProxy() {
+    if (typeof process === "undefined" || !process.env)
+        return undefined;
+    const env = process.env;
+    return env.HTTPS_PROXY ?? env.https_proxy ?? env.HTTP_PROXY ?? env.http_proxy ?? undefined;
+}
+const DEFAULT_HEADERS = {
+    // A realistic recent-Chrome UA. Google's frontend is tolerant of mismatch
+    // between the UA and the actual TLS fingerprint (which we can't fake from
+    // a Node/Bun fetch) but a credible UA makes a difference vs the default
+    // "node-fetch" / "undici" strings.
+    "user-agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36",
+    accept: "*/*",
+    "accept-language": "en-US,en;q=0.9",
+    "sec-ch-ua": '"Chromium";v="131", "Not_A Brand";v="24", "Google Chrome";v="131"',
+    "sec-ch-ua-mobile": "?0",
+    "sec-ch-ua-platform": '"macOS"',
+    "sec-fetch-dest": "empty",
+    "sec-fetch-mode": "cors",
+    "sec-fetch-site": "same-origin",
+    "content-type": "application/x-www-form-urlencoded;charset=UTF-8",
+};
+function sleep(ms) {
+    return new Promise((res) => setTimeout(res, ms));
+}
+function hostFromUrl(url) {
+    try {
+        return new URL(url).host || url;
+    }
+    catch {
+        return url;
+    }
+}
+function isAbortError(err) {
+    if (err instanceof DOMException && err.name === "AbortError")
+        return true;
+    if (typeof err === "object" && err != null && "name" in err) {
+        return err.name === "AbortError";
+    }
+    return false;
+}
+function wrapRequestError(method, url, err) {
+    if (err instanceof SearchClientError)
+        return err;
+    const host = hostFromUrl(url);
+    if (isAbortError(err)) {
+        return new SearchTimeoutError(`Timed out talking to Google Flights (${host}). The service may be slow or unreachable from your network — check your connection and try again.`);
+    }
+    const message = err instanceof Error ? err.message : String(err);
+    // Network-y messages from undici/bun-internals get bucketed into Connection.
+    if (/(ECONNRESET|ENOTFOUND|ECONNREFUSED|EAI_AGAIN|fetch failed)/i.test(message)) {
+        return new SearchConnectionError(`Could not reach Google Flights (${host}). Check your internet connection or DNS and try again.`);
+    }
+    return new SearchClientError(`${method} request to Google Flights (${host}) failed: ${err instanceof Error ? err.name : "Error"}`);
+}
+export class Client {
+    rateLimiter;
+    timeoutMs;
+    retries;
+    backoffMs;
+    proxy;
+    fetchImpl;
+    constructor(options = {}) {
+        this.rateLimiter = new TokenBucketRateLimiter(options.callsPerSecond ?? DEFAULT_CALLS_PER_SECOND, 1.0);
+        this.timeoutMs = options.timeoutMs ?? parseEnvTimeoutMs();
+        this.retries = options.retries ?? DEFAULT_RETRIES;
+        this.backoffMs = options.backoffMs ?? DEFAULT_BACKOFF_MS;
+        this.proxy = options.proxy === null ? undefined : (options.proxy ?? resolveProxy());
+        this.fetchImpl = options.fetchImpl ?? fetch;
+    }
+    async get(url, options = {}) {
+        return this.request("GET", url, options);
+    }
+    async post(url, options = {}) {
+        return this.request("POST", url, options);
+    }
+    async request(method, url, options) {
+        let lastError = null;
+        for (let attempt = 0; attempt < this.retries; attempt++) {
+            await this.rateLimiter.acquire();
+            const controller = new AbortController();
+            const externalSignal = options.signal;
+            let abortListener;
+            if (externalSignal) {
+                if (externalSignal.aborted)
+                    controller.abort(externalSignal.reason);
+                else {
+                    abortListener = () => controller.abort(externalSignal.reason);
+                    externalSignal.addEventListener("abort", abortListener);
+                }
+            }
+            const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+            try {
+                const init = {
+                    method,
+                    headers: { ...DEFAULT_HEADERS, ...options.headers },
+                    signal: controller.signal,
+                };
+                if (method === "POST" && options.body != null) {
+                    init.body =
+                        options.body instanceof Uint8Array ? options.body : options.body;
+                }
+                if (this.proxy)
+                    init.proxy = this.proxy;
+                const response = await this.fetchImpl(url, init);
+                if (!response.ok) {
+                    // Match the Python `raise_for_status` semantics — surface non-2xx
+                    // as a typed error and let the retry loop decide whether to back off.
+                    throw new SearchHTTPError(`Google Flights returned an error response (HTTP ${response.status}). The request may be malformed, rate-limited, or blocked.`, response.status);
+                }
+                const text = await response.text();
+                return {
+                    status: response.status,
+                    statusText: response.statusText,
+                    text,
+                    headers: response.headers,
+                    ok: response.ok,
+                };
+            }
+            catch (err) {
+                // Distinguish external cancellation from internal timeout: if the
+                // caller's AbortSignal triggered the abort, propagate the original
+                // error without retry and without relabelling it as a timeout. A
+                // consumer catching SearchTimeoutError to decide whether to retry
+                // would otherwise retry on a deliberate cancellation, and the
+                // "Google was slow" message would be misleading.
+                if (isAbortError(err) && externalSignal?.aborted) {
+                    throw externalSignal.reason ?? err;
+                }
+                lastError = wrapRequestError(method, url, err);
+                // For HTTP errors we still respect the retry budget (matches the
+                // Python tenacity retry decorator behavior, which retries on any
+                // exception).
+                if (attempt < this.retries - 1) {
+                    const wait = this.backoffMs * 2 ** attempt;
+                    await sleep(wait);
+                    continue;
+                }
+                break;
+            }
+            finally {
+                clearTimeout(timer);
+                if (abortListener && externalSignal) {
+                    externalSignal.removeEventListener("abort", abortListener);
+                }
+            }
+        }
+        throw lastError ?? new SearchClientError("Unknown request failure");
+    }
+}
+let _sharedClient = null;
+/**
+ * Return the process-wide shared client.
+ *
+ * Lazy on the first call. If `options` is passed on a later call, the
+ * existing singleton is replaced with a new instance configured against
+ * those options (and that new instance becomes the cached singleton for
+ * subsequent no-arg callers). Callers that want a fully isolated client
+ * — e.g. to use a different proxy in one place without affecting
+ * others — should construct `new Client(options)` directly and pass it
+ * to `SearchFlights` / `SearchDates`.
+ */
+export function getClient(options) {
+    if (_sharedClient == null || options != null) {
+        _sharedClient = new Client(options);
+    }
+    return _sharedClient;
+}
+/** Replace the shared client (test helper). */
+export function _setSharedClient(client) {
+    _sharedClient = client;
+}
+//# sourceMappingURL=client.js.map

package/dist/search/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/search/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,wBAAwB,GAAG,EAAE,CAAC;AACpC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAClC,MAAM,eAAe,GAAG,CAAC,CAAC;AAC1B,MAAM,kBAAkB,GAAG,KAAK,CAAC;AAEjC,SAAS,iBAAiB;IACxB,MAAM,GAAG,GAAG,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;IAClF,IAAI,GAAG,IAAI,IAAI;QAAE,OAAO,kBAAkB,CAAC;IAC3C,MAAM,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,iDAAiD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC1F,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,+CAA+C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,YAAY;IACnB,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,CAAC,OAAO,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IACrE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IACxB,OAAO,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,UAAU,IAAI,SAAS,CAAC;AAC7F,CAAC;AAED,MAAM,eAAe,GAA2B;IAC9C,0EAA0E;IAC1E,0EAA0E;IAC1E,wEAAwE;IACxE,mCAAmC;IACnC,YAAY,EACV,uHAAuH;IACzH,MAAM,EAAE,KAAK;IACb,iBAAiB,EAAE,gBAAgB;IACnC,WAAW,EAAE,mEAAmE;IAChF,kBAAkB,EAAE,IAAI;IACxB,oBAAoB,EAAE,SAAS;IAC/B,gBAAgB,EAAE,OAAO;IACzB,gBAAgB,EAAE,MAAM;IACxB,gBAAgB,EAAE,aAAa;IAC/B,cAAc,EAAE,iDAAiD;CAClE,CAAC;AA+BF,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,WAAW,CAAC,GAAW;IAC9B,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,GAAY;IAChC,IAAI,GAAG,YAAY,YAAY,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY;QAAE,OAAO,IAAI,CAAC;IAC1E,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,IAAI,IAAI,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;QAC5D,OAAQ,GAA0B,CAAC,IAAI,KAAK,YAAY,CAAC;IAC3D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAc,EAAE,GAAW,EAAE,GAAY;IACjE,IAAI,GAAG,YAAY,iBAAiB;QAAE,OAAO,GAAG,CAAC;IACjD,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI,kBAAkB,CAC3B,wCAAwC,IAAI,oGAAoG,CACjJ,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,6EAA6E;IAC7E,IAAI,6DAA6D,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAChF,OAAO,IAAI,qBAAqB,CAC9B,mCAAmC,IAAI,yDAAyD,CACjG,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,iBAAiB,CAC1B,GAAG,MAAM,+BAA+B,IAAI,aAAa,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CACrG,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,MAAM;IACA,WAAW,CAAyB;IACpC,SAAS,CAAS;IAClB,OAAO,CAAS;IAChB,SAAS,CAAS;IAClB,KAAK,CAAqB;IAC1B,SAAS,CAAe;IAEzC,YAAY,UAAyB,EAAE;QACrC,IAAI,CAAC,WAAW,GAAG,IAAI,sBAAsB,CAC3C,OAAO,CAAC,cAAc,IAAI,wBAAwB,EAClD,GAAG,CACJ,CAAC;QACF,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,iBAAiB,EAAE,CAAC;QAC1D,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,eAAe,CAAC;QAClD,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,kBAAkB,CAAC;QACzD,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,IAAI,YAAY,EAAE,CAAC,CAAC;QACpF,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,UAA0B,EAAE;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAW,EAAE,UAA0B,EAAE;QAClD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAEO,KAAK,CAAC,OAAO,CACnB,MAAsB,EACtB,GAAW,EACX,OAAuB;QAEvB,IAAI,SAAS,GAAY,IAAI,CAAC;QAC9B,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC;YACxD,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YACjC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;YACzC,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;YACtC,IAAI,aAAuC,CAAC;YAC5C,IAAI,cAAc,EAAE,CAAC;gBACnB,IAAI,cAAc,CAAC,OAAO;oBAAE,UAAU,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;qBAC/D,CAAC;oBACJ,aAAa,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;oBAC9D,cAAc,CAAC,gBAAgB,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;gBAC1D,CAAC;YACH,CAAC;YACD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YACnE,IAAI,CAAC;gBACH,MAAM,IAAI,GAAqC;oBAC7C,MAAM;oBACN,OAAO,EAAE,EAAE,GAAG,eAAe,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE;oBACnD,MAAM,EAAE,UAAU,CAAC,MAAM;iBAC1B,CAAC;gBACF,IAAI,MAAM,KAAK,MAAM,IAAI,OAAO,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC;oBAC9C,IAAI,CAAC,IAAI;wBACP,OAAO,CAAC,IAAI,YAAY,UAAU,CAAC,CAAC,CAAE,OAAO,CAAC,IAAiB,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;gBACnF,CAAC;gBACD,IAAI,IAAI,CAAC,KAAK;oBAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;gBACxC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;gBACjD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,kEAAkE;oBAClE,sEAAsE;oBACtE,MAAM,IAAI,eAAe,CACvB,mDAAmD,QAAQ,CAAC,MAAM,4DAA4D,EAC9H,QAAQ,CAAC,MAAM,CAChB,CAAC;gBACJ,CAAC;gBACD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACnC,OAAO;oBACL,MAAM,EAAE,QAAQ,CAAC,MAAM;oBACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;oBAC/B,IAAI;oBACJ,OAAO,EAAE,QAAQ,CAAC,OAAO;oBACzB,EAAE,EAAE,QAAQ,CAAC,EAAE;iBAChB,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,kEAAkE;gBAClE,mEAAmE;gBACnE,iEAAiE;gBACjE,kEAAkE;gBAClE,8DAA8D;gBAC9D,iDAAiD;gBACjD,IAAI,YAAY,CAAC,GAAG,CAAC,IAAI,cAAc,EAAE,OAAO,EAAE,CAAC;oBACjD,MAAM,cAAc,CAAC,MAAM,IAAI,GAAG,CAAC;gBACrC,CAAC;gBACD,SAAS,GAAG,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;gBAC/C,iEAAiE;gBACjE,iEAAiE;gBACjE,cAAc;gBACd,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;oBAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,GAAG,CAAC,IAAI,OAAO,CAAC;oBAC3C,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;oBAClB,SAAS;gBACX,CAAC;gBACD,MAAM;YACR,CAAC;oBAAS,CAAC;gBACT,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,IAAI,aAAa,IAAI,cAAc,EAAE,CAAC;oBACpC,cAAc,CAAC,mBAAmB,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;gBAC7D,CAAC;YACH,CAAC;QACH,CAAC;QACD,MAAM,SAAS,IAAI,IAAI,iBAAiB,CAAC,yBAAyB,CAAC,CAAC;IACtE,CAAC;CACF;AAED,IAAI,aAAa,GAAkB,IAAI,CAAC;AAExC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,SAAS,CAAC,OAAuB;IAC/C,IAAI,aAAa,IAAI,IAAI,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;QAC7C,aAAa,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,gBAAgB,CAAC,MAAqB;IACpD,aAAa,GAAG,MAAM,CAAC;AACzB,CAAC"}

package/dist/search/concurrency.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Async concurrency primitives. 1:1 port of fli/search/_concurrency.py,
+ * adapted to JavaScript's single-threaded event loop (no need for a
+ * threading.Condition — `setTimeout`/`Promise` are the equivalent).
+ */
+/**
+ * Async token-bucket rate limiter.
+ *
+ * The bucket starts full (`capacity` tokens) and refills continuously at
+ * `capacity / period` tokens per second. `acquire()` resolves once a
+ * token has been taken; concurrent waiters are released in arrival order
+ * via a FIFO promise chain.
+ */
+export declare class TokenBucketRateLimiter {
+    private readonly capacityValue;
+    private readonly refillPerSecond;
+    private tokens;
+    private lastRefill;
+    /** Serialises waiters so they wake in arrival order. */
+    private queue;
+    constructor(calls: number, period: number);
+    get capacity(): number;
+    private refill;
+    /**
+     * Block until `tokens` are available; returns `false` on timeout.
+     *
+     * @param tokens count to acquire (must be ≤ capacity)
+     * @param timeoutMs optional timeout in milliseconds
+     */
+    acquire(tokens?: number, timeoutMs?: number | null): Promise<boolean>;
+}
+export declare function configureConcurrency(maxWorkers: number): void;
+export declare function getDefaultMaxWorkers(): number;
+/**
+ * Apply `fn` to each item with bounded concurrency; results returned in
+ * input order. Fast-path for ≤1 items / maxWorkers=1 (no scheduling
+ * overhead).
+ *
+ * The first rejection rethrows after all in-flight calls have settled,
+ * matching the Python implementation's "let siblings finish" contract.
+ */
+export declare function parallelMap<T, R>(fn: (item: T) => Promise<R>, items: Iterable<T>, options?: {
+    maxWorkers?: number;
+}): Promise<R[]>;
+//# sourceMappingURL=concurrency.d.ts.map

package/dist/search/concurrency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.d.ts","sourceRoot":"","sources":["../../src/search/concurrency.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;GAOG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,wDAAwD;IACxD,OAAO,CAAC,KAAK,CAAoC;gBAErC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IASzC,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,OAAO,CAAC,MAAM;IASd;;;;;OAKG;IACG,OAAO,CAAC,MAAM,SAAI,EAAE,SAAS,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,OAAO,CAAC;CAuC7E;AAQD,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAG7D;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAAE,CAAC,EACpC,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAC3B,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,EAClB,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GACpC,OAAO,CAAC,CAAC,EAAE,CAAC,CAqCd"}

package/dist/search/concurrency.js

@@ -0,0 +1,148 @@
+/**
+ * Async concurrency primitives. 1:1 port of fli/search/_concurrency.py,
+ * adapted to JavaScript's single-threaded event loop (no need for a
+ * threading.Condition — `setTimeout`/`Promise` are the equivalent).
+ */
+/**
+ * Async token-bucket rate limiter.
+ *
+ * The bucket starts full (`capacity` tokens) and refills continuously at
+ * `capacity / period` tokens per second. `acquire()` resolves once a
+ * token has been taken; concurrent waiters are released in arrival order
+ * via a FIFO promise chain.
+ */
+export class TokenBucketRateLimiter {
+    capacityValue;
+    refillPerSecond;
+    tokens;
+    lastRefill;
+    /** Serialises waiters so they wake in arrival order. */
+    queue = Promise.resolve();
+    constructor(calls, period) {
+        if (calls <= 0)
+            throw new Error("calls must be positive");
+        if (period <= 0)
+            throw new Error("period must be positive");
+        this.capacityValue = calls;
+        this.refillPerSecond = calls / period;
+        this.tokens = calls;
+        this.lastRefill = performance.now() / 1000;
+    }
+    get capacity() {
+        return Math.floor(this.capacityValue);
+    }
+    refill() {
+        const now = performance.now() / 1000;
+        const elapsed = now - this.lastRefill;
+        if (elapsed > 0) {
+            this.tokens = Math.min(this.capacityValue, this.tokens + elapsed * this.refillPerSecond);
+            this.lastRefill = now;
+        }
+    }
+    /**
+     * Block until `tokens` are available; returns `false` on timeout.
+     *
+     * @param tokens count to acquire (must be ≤ capacity)
+     * @param timeoutMs optional timeout in milliseconds
+     */
+    async acquire(tokens = 1, timeoutMs = null) {
+        if (tokens <= 0)
+            return true;
+        if (tokens > this.capacityValue) {
+            throw new Error(`tokens=${tokens} exceeds bucket capacity=${this.capacity}`);
+        }
+        const deadline = timeoutMs == null ? null : performance.now() + timeoutMs;
+        // Serialise waiters so they take tokens FIFO.
+        let release = () => { };
+        const slot = new Promise((res) => {
+            release = res;
+        });
+        const prev = this.queue;
+        this.queue = prev.then(() => slot);
+        await prev;
+        try {
+            // eslint-disable-next-line no-constant-condition
+            while (true) {
+                this.refill();
+                if (this.tokens >= tokens) {
+                    this.tokens -= tokens;
+                    return true;
+                }
+                const deficit = tokens - this.tokens;
+                const waitS = deficit / this.refillPerSecond;
+                let waitMs = waitS * 1000;
+                if (deadline != null) {
+                    const remaining = deadline - performance.now();
+                    if (remaining <= 0)
+                        return false;
+                    waitMs = Math.min(waitMs, remaining);
+                }
+                await new Promise((res) => setTimeout(res, waitMs));
+            }
+        }
+        finally {
+            // Wake the next waiter so they can re-check the bucket.
+            release();
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// parallelMap — bounded Promise.all
+// ---------------------------------------------------------------------------
+let DEFAULT_MAX_WORKERS = 10;
+export function configureConcurrency(maxWorkers) {
+    if (maxWorkers <= 0)
+        throw new Error("maxWorkers must be positive");
+    DEFAULT_MAX_WORKERS = maxWorkers;
+}
+export function getDefaultMaxWorkers() {
+    return DEFAULT_MAX_WORKERS;
+}
+/**
+ * Apply `fn` to each item with bounded concurrency; results returned in
+ * input order. Fast-path for ≤1 items / maxWorkers=1 (no scheduling
+ * overhead).
+ *
+ * The first rejection rethrows after all in-flight calls have settled,
+ * matching the Python implementation's "let siblings finish" contract.
+ */
+export async function parallelMap(fn, items, options = {}) {
+    const materialised = Array.isArray(items) ? items : [...items];
+    const n = materialised.length;
+    if (n === 0)
+        return [];
+    const workers = options.maxWorkers ?? DEFAULT_MAX_WORKERS;
+    if (n === 1 || workers === 1) {
+        const out = Array.from({ length: n });
+        for (let i = 0; i < n; i++) {
+            out[i] = await fn(materialised[i]);
+        }
+        return out;
+    }
+    const results = Array.from({ length: n });
+    let firstError = null;
+    let nextIndex = 0;
+    const runner = async () => {
+        while (true) {
+            const idx = nextIndex++;
+            if (idx >= n)
+                return;
+            try {
+                results[idx] = await fn(materialised[idx]);
+            }
+            catch (err) {
+                if (firstError == null)
+                    firstError = err;
+            }
+        }
+    };
+    const workerPromises = [];
+    const cap = Math.min(workers, n);
+    for (let i = 0; i < cap; i++)
+        workerPromises.push(runner());
+    await Promise.all(workerPromises);
+    if (firstError != null)
+        throw firstError;
+    return results;
+}
+//# sourceMappingURL=concurrency.js.map

package/dist/search/concurrency.js.map

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

package/dist/search/dates.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Date-based flight search. Finds the cheapest prices across a date range
+ * using Google Flights' GetCalendarGraph RPC.
+ *
+ * 1:1 port of fli/search/dates.py.
+ */
+import { TripType } from "../models/google-flights/base.ts";
+import { DateSearchFilters } from "../models/google-flights/dates.ts";
+import { type Client } from "./client.ts";
+export interface DatePrice {
+    /** Single date for one-way searches, or `[outbound, return]` for round trip. */
+    date: [Date] | [Date, Date];
+    price: number;
+    currency: string | null;
+}
+export interface DateSearchOptions {
+    currency?: string | null;
+    language?: string | null;
+    country?: string | null;
+}
+export declare class SearchDates {
+    static readonly BASE_URL = "https://www.google.com/_/FlightsFrontendUi/data/travel.frontend.flights.FlightsFrontendService/GetCalendarGraph";
+    static readonly MAX_DAYS_PER_SEARCH = 61;
+    private readonly client;
+    constructor(client?: Client);
+    search(filters: DateSearchFilters, options?: DateSearchOptions): Promise<DatePrice[] | null>;
+    private _buildChunkFilters;
+    private _searchChunk;
+    static _parseDate(item: unknown, tripType: TripType): [Date] | [Date, Date];
+    static _parsePrice(item: unknown): number | null;
+    static _parseCurrency(item: unknown): string | null;
+}
+//# sourceMappingURL=dates.d.ts.map

package/dist/search/dates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates.d.ts","sourceRoot":"","sources":["../../src/search/dates.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,KAAK,MAAM,EAAa,MAAM,aAAa,CAAC;AASrD,MAAM,WAAW,SAAS;IACxB,gFAAgF;IAChF,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAwCD,qBAAa,WAAW;IACtB,MAAM,CAAC,QAAQ,CAAC,QAAQ,qHAAY;IACpC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,MAAuB;IAE1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,CAAC,EAAE,MAAM;IAIrB,MAAM,CACV,OAAO,EAAE,iBAAiB,EAC1B,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC;IAoB9B,OAAO,CAAC,kBAAkB;YA6BZ,YAAY;IA+B1B,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC;IAQ3E,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;IAWhD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;CAUpD"}

package/dist/search/dates.js

@@ -0,0 +1,159 @@
+/**
+ * Date-based flight search. Finds the cheapest prices across a date range
+ * using Google Flights' GetCalendarGraph RPC.
+ *
+ * 1:1 port of fli/search/dates.py.
+ */
+import { extractCurrencyFromPriceToken } from "../core/currency.js";
+import { formatIsoDate, parseIsoDate } from "../core/dates.js";
+import { TripType } from "../models/google-flights/base.js";
+import { DateSearchFilters } from "../models/google-flights/dates.js";
+import { getClient } from "./client.js";
+import { parallelMap } from "./concurrency.js";
+import { withLocaleParams } from "./urls.js";
+import { parseFirstWrbPayload } from "./wire.js";
+const MAX_DAYS_PER_SEARCH = 61;
+const BASE_URL = "https://www.google.com/_/FlightsFrontendUi/data/travel.frontend.flights.FlightsFrontendService/GetCalendarGraph";
+function cloneSegments(filters) {
+    return filters.flight_segments.map((s) => {
+        const clone = Object.create(Object.getPrototypeOf(s));
+        Object.assign(clone, {
+            departure_airport: s.departure_airport,
+            arrival_airport: s.arrival_airport,
+            travel_date: s.travel_date,
+            time_restrictions: s.time_restrictions,
+            selected_flight: s.selected_flight,
+        });
+        return clone;
+    });
+}
+function cloneFilters(filters) {
+    const out = Object.create(DateSearchFilters.prototype);
+    Object.assign(out, {
+        trip_type: filters.trip_type,
+        passenger_info: { ...filters.passenger_info },
+        flight_segments: cloneSegments(filters),
+        stops: filters.stops,
+        seat_type: filters.seat_type,
+        price_limit: filters.price_limit ? { ...filters.price_limit } : null,
+        airlines: filters.airlines ? [...filters.airlines] : null,
+        airlines_exclude: filters.airlines_exclude ? [...filters.airlines_exclude] : null,
+        alliances: filters.alliances ? [...filters.alliances] : null,
+        alliances_exclude: filters.alliances_exclude ? [...filters.alliances_exclude] : null,
+        max_duration: filters.max_duration,
+        layover_restrictions: filters.layover_restrictions ? { ...filters.layover_restrictions } : null,
+        emissions: filters.emissions,
+        bags: filters.bags ? { ...filters.bags } : null,
+        from_date: filters.from_date,
+        to_date: filters.to_date,
+        duration: filters.duration,
+    });
+    return out;
+}
+export class SearchDates {
+    static BASE_URL = BASE_URL;
+    static MAX_DAYS_PER_SEARCH = MAX_DAYS_PER_SEARCH;
+    client;
+    constructor(client) {
+        this.client = client ?? getClient();
+    }
+    async search(filters, options = {}) {
+        const fromDate = parseIsoDate(filters.from_date);
+        const toDate = parseIsoDate(filters.to_date);
+        const dayMs = 24 * 60 * 60 * 1000;
+        const dateRange = Math.floor((toDate.getTime() - fromDate.getTime()) / dayMs) + 1;
+        if (dateRange <= MAX_DAYS_PER_SEARCH) {
+            return this._searchChunk(filters, options);
+        }
+        const chunkFilters = this._buildChunkFilters(filters, fromDate, toDate);
+        const chunkResults = await parallelMap((cf) => this._searchChunk(cf, options), chunkFilters);
+        const allResults = [];
+        for (const r of chunkResults) {
+            if (r)
+                allResults.push(...r);
+        }
+        return allResults.length > 0 ? allResults : null;
+    }
+    _buildChunkFilters(filters, fromDate, toDate) {
+        const chunks = [];
+        let currentFrom = fromDate;
+        let chunkIndex = 0;
+        const dayMs = 24 * 60 * 60 * 1000;
+        while (currentFrom <= toDate) {
+            const endMs = currentFrom.getTime() + (MAX_DAYS_PER_SEARCH - 1) * dayMs;
+            const currentTo = new Date(Math.min(endMs, toDate.getTime()));
+            const cloned = cloneFilters(filters);
+            const shiftDays = MAX_DAYS_PER_SEARCH * chunkIndex;
+            if (chunkIndex > 0) {
+                for (const segment of cloned.flight_segments) {
+                    const segDate = parseIsoDate(segment.travel_date);
+                    segment.travel_date = formatIsoDate(new Date(segDate.getTime() + shiftDays * dayMs));
+                }
+            }
+            cloned.from_date = formatIsoDate(currentFrom);
+            cloned.to_date = formatIsoDate(currentTo);
+            chunks.push(cloned);
+            currentFrom = new Date(currentTo.getTime() + dayMs);
+            chunkIndex++;
+        }
+        return chunks;
+    }
+    async _searchChunk(filters, options) {
+        const encoded = filters.encode();
+        const url = withLocaleParams(BASE_URL, options.currency ?? null, options.language ?? null, options.country ?? null);
+        const response = await this.client.post(url, { body: `f.req=${encoded}` });
+        const data = parseFirstWrbPayload(response.text);
+        if (data == null || !Array.isArray(data))
+            return null;
+        const items = data[data.length - 1];
+        if (!Array.isArray(items))
+            return null;
+        const out = [];
+        for (const item of items) {
+            const price = SearchDates._parsePrice(item);
+            if (price == null)
+                continue;
+            out.push({
+                date: SearchDates._parseDate(item, filters.trip_type),
+                price,
+                currency: SearchDates._parseCurrency(item),
+            });
+        }
+        return out;
+    }
+    static _parseDate(item, tripType) {
+        if (!Array.isArray(item))
+            throw new Error("date item is not an array");
+        if (tripType === TripType.ONE_WAY) {
+            return [parseIsoDate(item[0])];
+        }
+        return [parseIsoDate(item[0]), parseIsoDate(item[1])];
+    }
+    static _parsePrice(item) {
+        if (!Array.isArray(item) || item.length <= 2)
+            return null;
+        const middle = item[2];
+        if (!Array.isArray(middle) || middle.length === 0)
+            return null;
+        const inner = middle[0];
+        if (!Array.isArray(inner) || inner.length <= 1)
+            return null;
+        const raw = inner[1];
+        const n = typeof raw === "number" ? raw : Number.parseFloat(raw);
+        return Number.isFinite(n) ? n : null;
+    }
+    static _parseCurrency(item) {
+        if (!Array.isArray(item) || item.length <= 2)
+            return null;
+        const middle = item[2];
+        if (!Array.isArray(middle) || middle.length <= 1)
+            return null;
+        try {
+            return extractCurrencyFromPriceToken(middle[1]);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=dates.js.map

package/dist/search/dates.js.map

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

package/dist/search/decoders.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Pure response decoders for Google Flights' RPC payloads.
+ * 1:1 port of fli/search/_decoders.py.
+ */
+import { type Airline } from "../models/airline.ts";
+import type { BookingOption, FlightResult } from "../models/google-flights/base.ts";
+declare function parseDateTime(dateArr: unknown, timeArr: unknown): Date;
+declare function safeAirline(code: unknown): Airline | null;
+interface EmissionsBlock {
+    this_g: number | null;
+    typical_g: number | null;
+    delta_pct: number | null;
+    tag: string | null;
+}
+declare function parseEmissions(detail: unknown): EmissionsBlock;
+/** Decode a single flight row into a `FlightResult`. */
+export declare function parseFlightRow(row: unknown[]): FlightResult;
+/** Walk a decoded `wrb.fr` chunk and yield every booking-option row. */
+export declare function parseBookingChunk(chunk: unknown): BookingOption[];
+declare function tryParseBookingRow(row: unknown[]): BookingOption | null;
+export { parseDateTime as _parseDateTime, parseEmissions as _parseEmissions, safeAirline as _safeAirline, tryParseBookingRow as _tryParseBookingRow, };
+//# sourceMappingURL=decoders.d.ts.map