google-fli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Punit Arani
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,158 @@
+# fli (TypeScript)
+
+A 1:1 TypeScript / JavaScript port of the [Python `fli` library](https://github.com/punitarani/fli).
+
+Programmatic access to Google Flights data via direct API interaction (no
+scraping). The API surface mirrors the Python package — same models, same
+filter encoding, same wire-format decoders.
+
+## Install
+
+```bash
+npm i fli-js   # or: pnpm add fli-js / yarn add fli-js / bun add fli-js
+```
+
+## Quick start
+
+```ts
+import {
+  Airport,
+  FlightSearchFilters,
+  FlightSegment,
+  MaxStops,
+  PassengerInfo,
+  SearchFlights,
+  SeatType,
+  SortBy,
+} from "fli-js";
+
+const filters = new FlightSearchFilters({
+  passenger_info: { adults: 1, children: 0, infants_in_seat: 0, infants_on_lap: 0 },
+  flight_segments: [
+    new FlightSegment({
+      departure_airport: [[[Airport.JFK, 0]]],
+      arrival_airport: [[[Airport.LAX, 0]]],
+      travel_date: "2026-12-25",
+    }),
+  ],
+  seat_type: SeatType.ECONOMY,
+  stops: MaxStops.NON_STOP,
+  sort_by: SortBy.CHEAPEST,
+});
+
+const results = await new SearchFlights().search(filters, { currency: "USD" });
+console.log(results);
+```
+
+### Date-range search
+
+```ts
+import { Airport, DateSearchFilters, FlightSegment, SearchDates } from "fli-js";
+
+const filters = new DateSearchFilters({
+  passenger_info: { adults: 1, children: 0, infants_in_seat: 0, infants_on_lap: 0 },
+  flight_segments: [
+    new FlightSegment({
+      departure_airport: [[[Airport.JFK, 0]]],
+      arrival_airport: [[[Airport.LAX, 0]]],
+      travel_date: "2026-12-01",
+    }),
+  ],
+  from_date: "2026-12-01",
+  to_date: "2026-12-31",
+});
+
+const dates = await new SearchDates().search(filters);
+```
+
+### Booking links
+
+Turn search results into clickable Google Flights links — no extra network
+call, fully deterministic.
+
+```ts
+import { googleFlightsUrl, SearchFlights } from "fli-js";
+
+const search = new SearchFlights();
+const results = await search.search(filters, { currency: "USD" });
+
+// Per-flight deep link: opens the specific itinerary's booking page
+// (vendor fares + "Continue" CTA) via a `tfs` protobuf token.
+const first = results?.[0];
+if (first) {
+  console.log(search.buildFlightBookingUrl(first, { currency: "USD" }));
+  // https://www.google.com/travel/flights/booking?tfs=…&curr=USD
+}
+
+// Search-level deep link: route + dates pre-filled (handy for a date result
+// or a quick "view on Google Flights" link).
+console.log(googleFlightsUrl("JFK", "LHR", "2026-12-25", null, { currency: "USD" }));
+// https://www.google.com/travel/flights?q=Flights%20from%20JFK%20to%20LHR%20on%202026-12-25&curr=USD
+```
+
+`buildFlightBookingUrl` accepts a single `FlightResult` (one-way) or an array
+of them (round-trip / multi-city). It never throws — on malformed input it
+falls back to the generic Google Flights URL.
+
+## HTTP / proxy configuration
+
+The TypeScript port uses native `fetch` (Bun's built-in) and replaces
+`curl_cffi`'s TLS impersonation with:
+
+- realistic Chrome `User-Agent` + `Sec-CH-*` headers,
+- automatic rate-limiting at 10 req/s,
+- 3-attempt exponential backoff on transient errors,
+- proxy support via the `HTTPS_PROXY` / `HTTP_PROXY` env vars (or via the
+  explicit `proxy` option on `new Client({...})`).
+
+```ts
+import { Client, SearchFlights } from "fli-js";
+
+const search = new SearchFlights(
+  new Client({ proxy: "http://user:pass@proxy.example.com:8080" }),
+);
+```
+
+Set the per-request timeout with `FLI_TIMEOUT=30` (seconds) or via the
+`timeoutMs` option on `new Client({...})`.
+
+## Modules
+
+- `fli-js/models` — `Airport`, `Airline`, `FlightSearchFilters`, `DateSearchFilters`,
+  `FlightSegment`, `FlightResult`, `BookingOption`, all enums.
+- `fli-js/core` — string-to-enum parsers, segment builders, airport search,
+  currency token decoders, deep-link builder (`googleFlightsUrl`).
+- `fli-js/search` — `SearchFlights` (incl. `buildFlightBookingUrl`),
+  `SearchDates`, `Client`, error classes, protobuf token helpers
+  (`buildBookingToken`, `buildTfsToken`, `extractBookingTokenFromTfu`).
+
+## Development
+
+```bash
+bun install
+bun run generate:enums   # regenerate airport.ts / airline.ts from data/*.csv
+bun run typecheck
+bun run lint             # biome + oxlint
+bun run format           # biome format
+bun test                 # unit + integration tests (no network)
+bun run test:e2e         # live tests (FLI_E2E=1; talks to Google Flights)
+bun run ci               # format-check + lint + typecheck + tests
+```
+
+## Parity with the Python library
+
+The TypeScript port preserves byte-perfect wire compatibility with the
+Python upstream:
+
+- `FlightSearchFilters.format()` produces structurally identical
+  nested-list payloads (see `tests/integration/filter_format_snapshots.test.ts`).
+- `buildBookingToken(...)` and `buildTfsToken(...)` reproduce captured live
+  booking-page tokens byte-for-byte (see `tests/search/proto.test.ts`); the
+  resulting `buildFlightBookingUrl(...)` output matches the Python library
+  character-for-character.
+- The wire-format parser handles both the legacy single-chunk JSONP
+  shape and the multi-chunk format used by `GetBookingResults`.
+
+## License
+
+MIT — same as the upstream Python project.

package/dist/core/airports.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Airport search by IATA code, city name, or airport name.
+ * 1:1 port of fli/core/airports.py — same 5-priority cascade.
+ */
+import { type Airport } from "../models/airport.ts";
+export type MatchType = "iata_exact" | "iata_prefix" | "city" | "name";
+export interface AirportMatch {
+    code: Airport;
+    name: string;
+    match_type: MatchType;
+    score: number;
+}
+/**
+ * Curated multi-airport city aliases (e.g., "new york" → JFK / LGA / EWR).
+ * Mirrors the Python CITY_AIRPORTS dict.
+ */
+export declare const CITY_AIRPORTS: Record<string, string[]>;
+/**
+ * Search airports by city name, airport name, or IATA code.
+ *
+ * Results are ranked 0-100 (higher = better) via the same 5-priority
+ * cascade used in the Python implementation:
+ *
+ *   1. iata_exact (100)   — exact IATA code
+ *   2. city (90)          — exact city/alias
+ *   3. city (80)          — prefix of a city/alias
+ *   4. name (≤70)         — substring of an airport's name (position-weighted)
+ *   5. iata_prefix (60)   — prefix of an IATA code (only for ≤3-char queries)
+ */
+export declare function searchAirports(query: string, limit?: number): AirportMatch[];
+//# sourceMappingURL=airports.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"airports.d.ts","sourceRoot":"","sources":["../../src/core/airports.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEnE,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,aAAa,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,SAAS,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAoDlD,CAAC;AAYF;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,YAAY,EAAE,CAsFxE"}

package/dist/core/airports.js

@@ -0,0 +1,168 @@
+/**
+ * Airport search by IATA code, city name, or airport name.
+ * 1:1 port of fli/core/airports.py — same 5-priority cascade.
+ */
+import { AIRPORT_NAMES } from "../models/airport.js";
+/**
+ * Curated multi-airport city aliases (e.g., "new york" → JFK / LGA / EWR).
+ * Mirrors the Python CITY_AIRPORTS dict.
+ */
+export const CITY_AIRPORTS = {
+    "new york": ["JFK", "LGA", "EWR"],
+    nyc: ["JFK", "LGA", "EWR"],
+    chicago: ["ORD", "MDW"],
+    washington: ["IAD", "DCA", "BWI"],
+    "washington dc": ["IAD", "DCA", "BWI"],
+    london: ["LHR", "LGW", "STN", "LTN", "LCY"],
+    paris: ["CDG", "ORY"],
+    tokyo: ["NRT", "HND"],
+    osaka: ["KIX", "ITM"],
+    seoul: ["ICN", "GMP"],
+    beijing: ["PEK", "PKX"],
+    shanghai: ["PVG", "SHA"],
+    bangkok: ["BKK", "DMK"],
+    istanbul: ["IST", "SAW"],
+    moscow: ["SVO", "DME", "VKO"],
+    milan: ["MXP", "LIN"],
+    rome: ["FCO", "CIA"],
+    berlin: ["BER"],
+    mumbai: ["BOM"],
+    delhi: ["DEL"],
+    "sao paulo": ["GRU", "CGH"],
+    rio: ["GIG", "SDU"],
+    "rio de janeiro": ["GIG", "SDU"],
+    toronto: ["YYZ", "YTZ"],
+    montreal: ["YUL"],
+    "mexico city": ["MEX"],
+    "buenos aires": ["EZE", "AEP"],
+    dubai: ["DXB", "DWC"],
+    singapore: ["SIN"],
+    "hong kong": ["HKG"],
+    taipei: ["TPE", "TSA"],
+    sydney: ["SYD"],
+    melbourne: ["MEL"],
+    "san francisco": ["SFO", "OAK", "SJC"],
+    sf: ["SFO", "OAK", "SJC"],
+    "bay area": ["SFO", "OAK", "SJC"],
+    "los angeles": ["LAX", "BUR", "SNA", "ONT", "LGB"],
+    la: ["LAX", "BUR", "SNA", "ONT", "LGB"],
+    dallas: ["DFW", "DAL"],
+    houston: ["IAH", "HOU"],
+    atlanta: ["ATL"],
+    denver: ["DEN"],
+    seattle: ["SEA"],
+    boston: ["BOS"],
+    miami: ["MIA", "FLL"],
+    detroit: ["DTW"],
+    minneapolis: ["MSP"],
+    phoenix: ["PHX"],
+    orlando: ["MCO"],
+    "las vegas": ["LAS"],
+    honolulu: ["HNL"],
+};
+// Validate at module load — surfaces typos in CITY_AIRPORTS immediately
+// instead of returning silently-empty results at search time.
+for (const [city, codes] of Object.entries(CITY_AIRPORTS)) {
+    for (const code of codes) {
+        if (!(code in AIRPORT_NAMES)) {
+            throw new Error(`CITY_AIRPORTS[${city}] references unknown IATA code '${code}'`);
+        }
+    }
+}
+/**
+ * Search airports by city name, airport name, or IATA code.
+ *
+ * Results are ranked 0-100 (higher = better) via the same 5-priority
+ * cascade used in the Python implementation:
+ *
+ *   1. iata_exact (100)   — exact IATA code
+ *   2. city (90)          — exact city/alias
+ *   3. city (80)          — prefix of a city/alias
+ *   4. name (≤70)         — substring of an airport's name (position-weighted)
+ *   5. iata_prefix (60)   — prefix of an IATA code (only for ≤3-char queries)
+ */
+export function searchAirports(query, limit = 10) {
+    const queryLower = query.trim().toLowerCase();
+    if (!queryLower || limit < 1)
+        return [];
+    const results = [];
+    const seen = new Set();
+    // 1. Exact IATA code match
+    const queryUpper = query.trim().toUpperCase();
+    if (queryUpper in AIRPORT_NAMES) {
+        results.push({
+            code: queryUpper,
+            name: queryUpper,
+            match_type: "iata_exact",
+            score: 100.0,
+        });
+        seen.add(queryUpper);
+    }
+    // 2. Exact city alias match
+    if (queryLower in CITY_AIRPORTS) {
+        for (const code of CITY_AIRPORTS[queryLower] ?? []) {
+            if (!seen.has(code)) {
+                results.push({
+                    code: code,
+                    name: code,
+                    match_type: "city",
+                    score: 90.0,
+                });
+                seen.add(code);
+            }
+        }
+    }
+    // 3. City alias prefix match
+    if (!(queryLower in CITY_AIRPORTS)) {
+        for (const [city, codes] of Object.entries(CITY_AIRPORTS)) {
+            if (city.startsWith(queryLower)) {
+                for (const code of codes) {
+                    if (!seen.has(code)) {
+                        results.push({
+                            code: code,
+                            name: code,
+                            match_type: "city",
+                            score: 80.0,
+                        });
+                        seen.add(code);
+                    }
+                }
+            }
+        }
+    }
+    // 4. Airport name substring match (position-weighted score)
+    for (const [code, name] of Object.entries(AIRPORT_NAMES)) {
+        if (seen.has(code))
+            continue;
+        const nameLower = name.toLowerCase();
+        const pos = nameLower.indexOf(queryLower);
+        if (pos !== -1) {
+            const score = 70.0 - pos * 0.1;
+            results.push({ code: code, name, match_type: "name", score });
+            seen.add(code);
+        }
+    }
+    // 5. IATA prefix match (≤3-char query)
+    if (queryUpper.length <= 3) {
+        for (const [code, name] of Object.entries(AIRPORT_NAMES)) {
+            if (seen.has(code))
+                continue;
+            if (code.startsWith(queryUpper)) {
+                results.push({
+                    code: code,
+                    name,
+                    match_type: "iata_prefix",
+                    score: 60.0,
+                });
+                seen.add(code);
+            }
+        }
+    }
+    results.sort((a, b) => {
+        if (a.score !== b.score)
+            return b.score - a.score;
+        return a.code < b.code ? -1 : a.code > b.code ? 1 : 0;
+    });
+    return results.slice(0, limit);
+}
+//# sourceMappingURL=airports.js.map

package/dist/core/airports.js.map

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

package/dist/core/builders.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Builder utilities for constructing search filters. 1:1 port of
+ * fli/core/builders.py.
+ */
+import type { Airport } from "../models/airport.ts";
+import { FlightSegment, type TimeRestrictions, TripType } from "../models/google-flights/base.ts";
+/** Zero-pad a YYYY-MM-DD date string. */
+export declare function normalizeDate(dateStr: string): string;
+/** Build a `TimeRestrictions` from "HH-HH"-style window strings, or `null`. */
+export declare function buildTimeRestrictions(departureWindow?: string | null, arrivalWindow?: string | null): TimeRestrictions | null;
+/** Build flight segments for a one-way or round-trip search. */
+export declare function buildFlightSegments(origin: Airport | Airport[], destination: Airport | Airport[], departureDate: string, returnDate?: string | null, timeRestrictions?: TimeRestrictions | null): {
+    segments: FlightSegment[];
+    tripType: TripType;
+};
+/** Build flight segments for a multi-city search from a list of legs. */
+export declare function buildMultiCitySegments(legs: Array<[Airport, Airport, string]>, timeRestrictions?: TimeRestrictions | null): {
+    segments: FlightSegment[];
+    tripType: TripType;
+};
+/** Build flight segments for a date-range search. */
+export declare function buildDateSearchSegments(origin: Airport | Airport[], destination: Airport | Airport[], startDate: string, options?: {
+    tripDuration?: number | null;
+    isRoundTrip?: boolean;
+    timeRestrictions?: TimeRestrictions | null;
+}): {
+    segments: FlightSegment[];
+    tripType: TripType;
+};
+//# sourceMappingURL=builders.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../src/core/builders.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,KAAK,gBAAgB,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAKlG,yCAAyC;AACzC,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAgBrD;AAED,+EAA+E;AAC/E,wBAAgB,qBAAqB,CACnC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,EAC/B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,GAC5B,gBAAgB,GAAG,IAAI,CAqBzB;AAED,gEAAgE;AAChE,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,OAAO,GAAG,OAAO,EAAE,EAC3B,WAAW,EAAE,OAAO,GAAG,OAAO,EAAE,EAChC,aAAa,EAAE,MAAM,EACrB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,EAC1B,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,IAAI,GACzC;IAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,CA6BnD;AAED,yEAAyE;AACzE,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,KAAK,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,EACvC,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,IAAI,GACzC;IAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,CAWnD;AAED,qDAAqD;AACrD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,OAAO,GAAG,OAAO,EAAE,EAC3B,WAAW,EAAE,OAAO,GAAG,OAAO,EAAE,EAChC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IACP,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACvC,GACL;IAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,CAoCnD"}

package/dist/core/builders.js

@@ -0,0 +1,113 @@
+/**
+ * Builder utilities for constructing search filters. 1:1 port of
+ * fli/core/builders.py.
+ */
+import { FlightSegment, TripType } from "../models/google-flights/base.js";
+import { parseTimeRange } from "./parsers.js";
+const ISO_DATE_RE = /^\d{4}-\d{1,2}-\d{1,2}$/;
+/** Zero-pad a YYYY-MM-DD date string. */
+export function normalizeDate(dateStr) {
+    if (!ISO_DATE_RE.test(dateStr)) {
+        throw new Error(`Invalid date string: ${dateStr}`);
+    }
+    const parts = dateStr.split("-").map((p) => Number.parseInt(p, 10));
+    const [y, m, d] = parts;
+    if (y == null || m == null || d == null) {
+        throw new Error(`Invalid date string: ${dateStr}`);
+    }
+    const date = new Date(Date.UTC(y, m - 1, d));
+    if (date.getUTCFullYear() !== y || date.getUTCMonth() !== m - 1 || date.getUTCDate() !== d) {
+        throw new Error(`Invalid date: ${dateStr}`);
+    }
+    const mm = String(m).padStart(2, "0");
+    const dd = String(d).padStart(2, "0");
+    return `${y}-${mm}-${dd}`;
+}
+/** Build a `TimeRestrictions` from "HH-HH"-style window strings, or `null`. */
+export function buildTimeRestrictions(departureWindow, arrivalWindow) {
+    if (!departureWindow && !arrivalWindow)
+        return null;
+    let earliestDeparture = null;
+    let latestDeparture = null;
+    let earliestArrival = null;
+    let latestArrival = null;
+    if (departureWindow) {
+        [earliestDeparture, latestDeparture] = parseTimeRange(departureWindow);
+    }
+    if (arrivalWindow) {
+        [earliestArrival, latestArrival] = parseTimeRange(arrivalWindow);
+    }
+    return {
+        earliest_departure: earliestDeparture ?? undefined,
+        latest_departure: latestDeparture ?? undefined,
+        earliest_arrival: earliestArrival ?? undefined,
+        latest_arrival: latestArrival ?? undefined,
+    };
+}
+/** Build flight segments for a one-way or round-trip search. */
+export function buildFlightSegments(origin, destination, departureDate, returnDate, timeRestrictions) {
+    const depDate = normalizeDate(departureDate);
+    const origins = Array.isArray(origin) ? origin : [origin];
+    const destinations = Array.isArray(destination) ? destination : [destination];
+    const segments = [
+        new FlightSegment({
+            departure_airport: [origins.map((apt) => [apt, 0])],
+            arrival_airport: [destinations.map((apt) => [apt, 0])],
+            travel_date: depDate,
+            time_restrictions: timeRestrictions ?? null,
+        }),
+    ];
+    let tripType = TripType.ONE_WAY;
+    if (returnDate) {
+        const retDate = normalizeDate(returnDate);
+        tripType = TripType.ROUND_TRIP;
+        segments.push(new FlightSegment({
+            departure_airport: [destinations.map((apt) => [apt, 0])],
+            arrival_airport: [origins.map((apt) => [apt, 0])],
+            travel_date: retDate,
+            time_restrictions: timeRestrictions ?? null,
+        }));
+    }
+    return { segments, tripType };
+}
+/** Build flight segments for a multi-city search from a list of legs. */
+export function buildMultiCitySegments(legs, timeRestrictions) {
+    const segments = legs.map(([origin, destination, date]) => new FlightSegment({
+        departure_airport: [[[origin, 0]]],
+        arrival_airport: [[[destination, 0]]],
+        travel_date: normalizeDate(date),
+        time_restrictions: timeRestrictions ?? null,
+    }));
+    return { segments, tripType: TripType.MULTI_CITY };
+}
+/** Build flight segments for a date-range search. */
+export function buildDateSearchSegments(origin, destination, startDate, options = {}) {
+    const startNormalized = normalizeDate(startDate);
+    const origins = Array.isArray(origin) ? origin : [origin];
+    const destinations = Array.isArray(destination) ? destination : [destination];
+    const segments = [
+        new FlightSegment({
+            departure_airport: [origins.map((apt) => [apt, 0])],
+            arrival_airport: [destinations.map((apt) => [apt, 0])],
+            travel_date: startNormalized,
+            time_restrictions: options.timeRestrictions ?? null,
+        }),
+    ];
+    let tripType = TripType.ONE_WAY;
+    if (options.isRoundTrip) {
+        tripType = TripType.ROUND_TRIP;
+        const startMs = Date.parse(`${startNormalized}T00:00:00Z`);
+        const days = options.tripDuration ?? 3;
+        const returnMs = startMs + days * 24 * 60 * 60 * 1000;
+        const returnDate = new Date(returnMs);
+        const ret = `${returnDate.getUTCFullYear()}-${String(returnDate.getUTCMonth() + 1).padStart(2, "0")}-${String(returnDate.getUTCDate()).padStart(2, "0")}`;
+        segments.push(new FlightSegment({
+            departure_airport: [destinations.map((apt) => [apt, 0])],
+            arrival_airport: [origins.map((apt) => [apt, 0])],
+            travel_date: ret,
+            time_restrictions: options.timeRestrictions ?? null,
+        }));
+    }
+    return { segments, tripType };
+}
+//# sourceMappingURL=builders.js.map

package/dist/core/builders.js.map

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

package/dist/core/currency.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Currency extraction from Google Flights price tokens.
+ *
+ * 1:1 port of fli/core/currency.py — varint walk over a base64-urlsafe
+ * protobuf payload to extract the nested ISO currency code, cached to
+ * avoid repeated decoding for the common one-currency-per-response case.
+ */
+/**
+ * Extract the ISO currency code from a Google Flights price token.
+ *
+ * Cached so the same token returned for every row in a response decodes
+ * the protobuf payload exactly once.
+ */
+export declare function extractCurrencyFromPriceToken(token: string | null | undefined): string | null;
+/** Currency-code-aware formatter built on `Intl.NumberFormat`. */
+export declare function formatPrice(amount: number | null | undefined, currencyCode: string | null | undefined): string;
+/** Build a chart-axis label for one or more result currencies. */
+export declare function formatPriceAxisLabel(currencies: Iterable<string | null | undefined>): string;
+/** Clear the in-memory token-decode cache (test helper). */
+export declare function _clearCurrencyCache(): void;
+//# sourceMappingURL=currency.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"currency.d.ts","sourceRoot":"","sources":["../../src/core/currency.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgGH;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAiB7F;AAED,kEAAkE;AAClE,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACjC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACtC,MAAM,CAsBR;AAED,kEAAkE;AAClE,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,MAAM,CAU5F;AAED,4DAA4D;AAC5D,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}