google-fli 0.1.0

package/dist/core/currency.js

@@ -0,0 +1,172 @@
+/**
+ * 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.
+ */
+const _decodeCache = new Map();
+const MAX_CACHE = 256;
+function readVarint(data, offset) {
+    // `+= chunk * 2**shift` instead of `|= chunk << shift` — JavaScript's
+    // bitwise operators coerce to signed 32-bit and would corrupt the
+    // result for shifts ≥ 31 (i.e. varint values ≥ 2^31).
+    let value = 0;
+    let shift = 0;
+    let off = offset;
+    while (off < data.length) {
+        const byte = data[off];
+        if (byte === undefined)
+            break;
+        off += 1;
+        value += (byte & 0x7f) * 2 ** shift;
+        if ((byte & 0x80) === 0) {
+            if (!Number.isSafeInteger(value)) {
+                throw new Error("Varint exceeds Number.MAX_SAFE_INTEGER");
+            }
+            return [value, off];
+        }
+        shift += 7;
+        if (shift >= 64)
+            throw new Error("Varint is too large to decode");
+    }
+    throw new Error("Unexpected end of data while decoding varint");
+}
+function readLengthDelimited(data, offset) {
+    const [length, after] = readVarint(data, offset);
+    const end = after + length;
+    if (end > data.length)
+        throw new Error("Length-delimited field exceeds payload size");
+    return [data.subarray(after, end), end];
+}
+function skipField(data, offset, wireType) {
+    if (wireType === 0)
+        return readVarint(data, offset)[1];
+    if (wireType === 1) {
+        const end = offset + 8;
+        if (end > data.length)
+            throw new Error("Fixed64 field exceeds payload size");
+        return end;
+    }
+    if (wireType === 2)
+        return readLengthDelimited(data, offset)[1];
+    if (wireType === 5) {
+        const end = offset + 4;
+        if (end > data.length)
+            throw new Error("Fixed32 field exceeds payload size");
+        return end;
+    }
+    throw new Error(`Unsupported wire type: ${wireType}`);
+}
+function extractCurrencyFromMessage(data) {
+    let offset = 0;
+    while (offset < data.length) {
+        const [tag, afterTag] = readVarint(data, offset);
+        offset = afterTag;
+        const fieldNumber = tag >> 3;
+        const wireType = tag & 0x07;
+        if (fieldNumber === 3 && wireType === 2) {
+            const [nested, after] = readLengthDelimited(data, offset);
+            offset = after;
+            let nestedOffset = 0;
+            while (nestedOffset < nested.length) {
+                const [ntag, na] = readVarint(nested, nestedOffset);
+                nestedOffset = na;
+                const nfield = ntag >> 3;
+                const nwire = ntag & 0x07;
+                if (nfield === 3 && nwire === 2) {
+                    const [bytes, _end] = readLengthDelimited(nested, nestedOffset);
+                    return new TextDecoder("utf-8").decode(bytes).toUpperCase();
+                }
+                nestedOffset = skipField(nested, nestedOffset, nwire);
+            }
+            continue;
+        }
+        offset = skipField(data, offset, wireType);
+    }
+    return null;
+}
+function base64UrlsafeDecode(token) {
+    const padLen = (4 - (token.length % 4)) % 4;
+    const padded = token + "=".repeat(padLen);
+    const standard = padded.replace(/-/g, "+").replace(/_/g, "/");
+    if (typeof atob !== "undefined") {
+        const binary = atob(standard);
+        const out = new Uint8Array(binary.length);
+        for (let i = 0; i < binary.length; i++)
+            out[i] = binary.charCodeAt(i);
+        return out;
+    }
+    return new Uint8Array(Buffer.from(standard, "base64"));
+}
+/**
+ * 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 function extractCurrencyFromPriceToken(token) {
+    if (!token)
+        return null;
+    if (_decodeCache.has(token))
+        return _decodeCache.get(token) ?? null;
+    let result = null;
+    try {
+        const decoded = base64UrlsafeDecode(token);
+        result = extractCurrencyFromMessage(decoded);
+    }
+    catch {
+        result = null;
+    }
+    // LRU-ish bound: drop oldest if we hit the cap.
+    if (_decodeCache.size >= MAX_CACHE) {
+        const firstKey = _decodeCache.keys().next().value;
+        if (firstKey !== undefined)
+            _decodeCache.delete(firstKey);
+    }
+    _decodeCache.set(token, result);
+    return result;
+}
+/** Currency-code-aware formatter built on `Intl.NumberFormat`. */
+export function formatPrice(amount, currencyCode) {
+    if (amount == null) {
+        return currencyCode ? `${currencyCode.toUpperCase()} —` : "—";
+    }
+    if (!currencyCode) {
+        return amount.toLocaleString("en-US", {
+            minimumFractionDigits: 2,
+            maximumFractionDigits: 2,
+        });
+    }
+    const normalized = currencyCode.toUpperCase();
+    try {
+        return new Intl.NumberFormat("en-US", {
+            style: "currency",
+            currency: normalized,
+        }).format(amount);
+    }
+    catch {
+        return `${normalized} ${amount.toLocaleString("en-US", {
+            minimumFractionDigits: 2,
+            maximumFractionDigits: 2,
+        })}`;
+    }
+}
+/** Build a chart-axis label for one or more result currencies. */
+export function formatPriceAxisLabel(currencies) {
+    const set = new Set();
+    for (const c of currencies) {
+        if (c)
+            set.add(c.toUpperCase());
+    }
+    if (set.size === 1) {
+        const [only] = set;
+        return `Price (${only})`;
+    }
+    return "Price";
+}
+/** Clear the in-memory token-decode cache (test helper). */
+export function _clearCurrencyCache() {
+    _decodeCache.clear();
+}
+//# sourceMappingURL=currency.js.map

package/dist/core/currency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency.js","sourceRoot":"","sources":["../../src/core/currency.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,YAAY,GAAG,IAAI,GAAG,EAAyB,CAAC;AACtD,MAAM,SAAS,GAAG,GAAG,CAAC;AAEtB,SAAS,UAAU,CAAC,IAAgB,EAAE,MAAc;IAClD,sEAAsE;IACtE,kEAAkE;IAClE,sDAAsD;IACtD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,GAAG,GAAG,MAAM,CAAC;IACjB,OAAO,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QACvB,IAAI,IAAI,KAAK,SAAS;YAAE,MAAM;QAC9B,GAAG,IAAI,CAAC,CAAC;QACT,KAAK,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjC,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;YAC5D,CAAC;YACD,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACtB,CAAC;QACD,KAAK,IAAI,CAAC,CAAC;QACX,IAAI,KAAK,IAAI,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACpE,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAgB,EAAE,MAAc;IAC3D,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACjD,MAAM,GAAG,GAAG,KAAK,GAAG,MAAM,CAAC;IAC3B,IAAI,GAAG,GAAG,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACtF,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,SAAS,CAAC,IAAgB,EAAE,MAAc,EAAE,QAAgB;IACnE,IAAI,QAAQ,KAAK,CAAC;QAAE,OAAO,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACnB,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,CAAC;QACvB,IAAI,GAAG,GAAG,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QAC7E,OAAO,GAAG,CAAC;IACb,CAAC;IACD,IAAI,QAAQ,KAAK,CAAC;QAAE,OAAO,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAChE,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACnB,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,CAAC;QACvB,IAAI,GAAG,GAAG,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QAC7E,OAAO,GAAG,CAAC;IACb,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,EAAE,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,0BAA0B,CAAC,IAAgB;IAClD,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,OAAO,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5B,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,GAAG,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACjD,MAAM,GAAG,QAAQ,CAAC;QAClB,MAAM,WAAW,GAAG,GAAG,IAAI,CAAC,CAAC;QAC7B,MAAM,QAAQ,GAAG,GAAG,GAAG,IAAI,CAAC;QAE5B,IAAI,WAAW,KAAK,CAAC,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;YACxC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC1D,MAAM,GAAG,KAAK,CAAC;YACf,IAAI,YAAY,GAAG,CAAC,CAAC;YACrB,OAAO,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;gBACpC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;gBACpD,YAAY,GAAG,EAAE,CAAC;gBAClB,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,CAAC;gBACzB,MAAM,KAAK,GAAG,IAAI,GAAG,IAAI,CAAC;gBAC1B,IAAI,MAAM,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;oBAChC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,mBAAmB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;oBAChE,OAAO,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;gBAC9D,CAAC;gBACD,YAAY,GAAG,SAAS,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;YACxD,CAAC;YACD,SAAS;QACX,CAAC;QAED,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAa;IACxC,MAAM,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC9D,IAAI,OAAO,IAAI,KAAK,WAAW,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9B,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACtE,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;AACzD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAAC,KAAgC;IAC5E,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;IACpE,IAAI,MAAM,GAAkB,IAAI,CAAC;IACjC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,GAAG,IAAI,CAAC;IAChB,CAAC;IACD,gDAAgD;IAChD,IAAI,YAAY,CAAC,IAAI,IAAI,SAAS,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;QAClD,IAAI,QAAQ,KAAK,SAAS;YAAE,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC5D,CAAC;IACD,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,WAAW,CACzB,MAAiC,EACjC,YAAuC;IAEvC,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;QACnB,OAAO,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;IAChE,CAAC;IACD,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE;YACpC,qBAAqB,EAAE,CAAC;YACxB,qBAAqB,EAAE,CAAC;SACzB,CAAC,CAAC;IACL,CAAC;IACD,MAAM,UAAU,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;IAC9C,IAAI,CAAC;QACH,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE;YACpC,KAAK,EAAE,UAAU;YACjB,QAAQ,EAAE,UAAU;SACrB,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,UAAU,IAAI,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE;YACrD,qBAAqB,EAAE,CAAC;YACxB,qBAAqB,EAAE,CAAC;SACzB,CAAC,EAAE,CAAC;IACP,CAAC;AACH,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,oBAAoB,CAAC,UAA+C;IAClF,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAClC,CAAC;IACD,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACnB,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC;QACnB,OAAO,UAAU,IAAI,GAAG,CAAC;IAC3B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,mBAAmB;IACjC,YAAY,CAAC,KAAK,EAAE,CAAC;AACvB,CAAC"}

package/dist/core/dates.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Shared YYYY-MM-DD parsing and formatting helpers.
+ *
+ * Lives in `core/` so the same canonical implementation backs every part
+ * of the package — `models/google-flights/base.ts`, the date-search
+ * filters, and `search/dates.ts` — rather than each maintaining its own
+ * subtly-different copy.
+ */
+/** Strict YYYY-MM-DD shape (4 digit year, 2 digit month, 2 digit day). */
+export declare const ISO_DATE_RE: RegExp;
+/**
+ * Parse a YYYY-MM-DD string into a UTC `Date`.
+ *
+ * Rejects strings that don't match {@link ISO_DATE_RE} and rejects
+ * out-of-range calendar dates (e.g. `2026-02-30` would round-trip to
+ * March, so the round-trip check catches it). Throws {@link TypeError}
+ * on any malformed input — consistent with the rest of the package.
+ */
+export declare function parseIsoDate(s: string): Date;
+/** Format a `Date` as YYYY-MM-DD in UTC. */
+export declare function formatIsoDate(d: Date): string;
+//# sourceMappingURL=dates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dates.d.ts","sourceRoot":"","sources":["../../src/core/dates.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,0EAA0E;AAC1E,eAAO,MAAM,WAAW,QAAwB,CAAC;AAEjD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAc5C;AAED,4CAA4C;AAC5C,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAK7C"}

package/dist/core/dates.js

@@ -0,0 +1,41 @@
+/**
+ * Shared YYYY-MM-DD parsing and formatting helpers.
+ *
+ * Lives in `core/` so the same canonical implementation backs every part
+ * of the package — `models/google-flights/base.ts`, the date-search
+ * filters, and `search/dates.ts` — rather than each maintaining its own
+ * subtly-different copy.
+ */
+/** Strict YYYY-MM-DD shape (4 digit year, 2 digit month, 2 digit day). */
+export const ISO_DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+/**
+ * Parse a YYYY-MM-DD string into a UTC `Date`.
+ *
+ * Rejects strings that don't match {@link ISO_DATE_RE} and rejects
+ * out-of-range calendar dates (e.g. `2026-02-30` would round-trip to
+ * March, so the round-trip check catches it). Throws {@link TypeError}
+ * on any malformed input — consistent with the rest of the package.
+ */
+export function parseIsoDate(s) {
+    if (!ISO_DATE_RE.test(s)) {
+        throw new TypeError(`Expected YYYY-MM-DD date, got: ${s}`);
+    }
+    const parts = s.split("-").map((p) => Number.parseInt(p, 10));
+    const [year, month, day] = parts;
+    if (year == null || month == null || day == null) {
+        throw new TypeError(`Expected YYYY-MM-DD date, got: ${s}`);
+    }
+    const d = new Date(Date.UTC(year, month - 1, day));
+    if (d.getUTCFullYear() !== year || d.getUTCMonth() !== month - 1 || d.getUTCDate() !== day) {
+        throw new TypeError(`Invalid date: ${s}`);
+    }
+    return d;
+}
+/** Format a `Date` as YYYY-MM-DD in UTC. */
+export function formatIsoDate(d) {
+    const y = d.getUTCFullYear();
+    const m = String(d.getUTCMonth() + 1).padStart(2, "0");
+    const day = String(d.getUTCDate()).padStart(2, "0");
+    return `${y}-${m}-${day}`;
+}
+//# sourceMappingURL=dates.js.map

package/dist/core/dates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates.js","sourceRoot":"","sources":["../../src/core/dates.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,0EAA0E;AAC1E,MAAM,CAAC,MAAM,WAAW,GAAG,qBAAqB,CAAC;AAEjD;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,CAAS;IACpC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,SAAS,CAAC,kCAAkC,CAAC,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAC9D,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC;IACjC,IAAI,IAAI,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QACjD,MAAM,IAAI,SAAS,CAAC,kCAAkC,CAAC,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IACnD,IAAI,CAAC,CAAC,cAAc,EAAE,KAAK,IAAI,IAAI,CAAC,CAAC,WAAW,EAAE,KAAK,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,KAAK,GAAG,EAAE,CAAC;QAC3F,MAAM,IAAI,SAAS,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,aAAa,CAAC,CAAO;IACnC,MAAM,CAAC,GAAG,CAAC,CAAC,cAAc,EAAE,CAAC;IAC7B,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACvD,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACpD,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;AAC5B,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,7 @@
+export { type AirportMatch, CITY_AIRPORTS, type MatchType, searchAirports, } from "./airports.ts";
+export { buildDateSearchSegments, buildFlightSegments, buildMultiCitySegments, buildTimeRestrictions, normalizeDate, } from "./builders.ts";
+export { _clearCurrencyCache, extractCurrencyFromPriceToken, formatPrice, formatPriceAxisLabel, } from "./currency.ts";
+export { formatIsoDate, ISO_DATE_RE, parseIsoDate } from "./dates.ts";
+export { type GoogleFlightsUrlOptions, googleFlightsUrl, withLocaleParams, } from "./links.ts";
+export { ParseError, parseAirlines, parseAlliances, parseCabinClass, parseCurrency, parseEmissions, parseMaxStops, parseSortBy, parseTimeRange, resolveAirport, resolveEnum, } from "./parsers.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,YAAY,EACjB,aAAa,EACb,KAAK,SAAS,EACd,cAAc,GACf,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,mBAAmB,EACnB,6BAA6B,EAC7B,WAAW,EACX,oBAAoB,GACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EACL,KAAK,uBAAuB,EAC5B,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,UAAU,EACV,aAAa,EACb,cAAc,EACd,eAAe,EACf,aAAa,EACb,cAAc,EACd,aAAa,EACb,WAAW,EACX,cAAc,EACd,cAAc,EACd,WAAW,GACZ,MAAM,cAAc,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,7 @@
+export { CITY_AIRPORTS, searchAirports, } from "./airports.js";
+export { buildDateSearchSegments, buildFlightSegments, buildMultiCitySegments, buildTimeRestrictions, normalizeDate, } from "./builders.js";
+export { _clearCurrencyCache, extractCurrencyFromPriceToken, formatPrice, formatPriceAxisLabel, } from "./currency.js";
+export { formatIsoDate, ISO_DATE_RE, parseIsoDate } from "./dates.js";
+export { googleFlightsUrl, withLocaleParams, } from "./links.js";
+export { ParseError, parseAirlines, parseAlliances, parseCabinClass, parseCurrency, parseEmissions, parseMaxStops, parseSortBy, parseTimeRange, resolveAirport, resolveEnum, } from "./parsers.js";
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,aAAa,EAEb,cAAc,GACf,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,mBAAmB,EACnB,6BAA6B,EAC7B,WAAW,EACX,oBAAoB,GACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAEL,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,UAAU,EACV,aAAa,EACb,cAAc,EACd,eAAe,EACf,aAAa,EACb,cAAc,EACd,aAAa,EACb,WAAW,EACX,cAAc,EACd,cAAc,EACd,WAAW,GACZ,MAAM,cAAc,CAAC"}

package/dist/core/links.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Shared URL helpers for Google Flights deep links.
+ *
+ * Consumers can surface a clickable Google Flights link alongside search
+ * results so a user can open the route (and complete a booking) in a
+ * browser. The natural-language `q` form used here is the same one Google's
+ * own frontend accepts.
+ *
+ * `withLocaleParams` lives here (rather than in `search/`) so the core layer
+ * stays free of any dependency on the search package; `search/urls.ts`
+ * re-exports it for backwards compatibility.
+ *
+ * 1:1 port of fli/core/links.py.
+ */
+/**
+ * Append optional `curr`/`hl`/`gl` parameters to a URL.
+ *
+ * - `currency` is uppercased ("usd" → "USD") because Google rejects lowercase
+ *   codes silently.
+ * - `language` is passed through verbatim (BCP-47).
+ * - `country` is uppercased (ISO 3166-1 alpha-2).
+ *
+ * All values are percent-encoded; returns `url` unchanged when all three are null.
+ */
+export declare function withLocaleParams(url: string, currency: string | null | undefined, language: string | null | undefined, country: string | null | undefined): string;
+export interface GoogleFlightsUrlOptions {
+    currency?: string | null;
+    language?: string | null;
+    country?: string | null;
+}
+/**
+ * Build a shareable Google Flights deep link for a route and dates.
+ *
+ * `origin` and `destination` are bare IATA codes (e.g. `"JFK"`). The returned
+ * URL pre-fills the route and outbound date (plus the return date for round
+ * trips); locale knobs (`curr`/`hl`/`gl`) are appended when supplied.
+ */
+export declare function googleFlightsUrl(origin: string, destination: string, departureDate: string, returnDate?: string | null, options?: GoogleFlightsUrlOptions): string;
+//# sourceMappingURL=links.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"links.d.ts","sourceRoot":"","sources":["../../src/core/links.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACnC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACnC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACjC,MAAM,CAQR;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,EAC1B,OAAO,GAAE,uBAA4B,GACpC,MAAM,CAUR"}

package/dist/core/links.js

@@ -0,0 +1,53 @@
+/**
+ * Shared URL helpers for Google Flights deep links.
+ *
+ * Consumers can surface a clickable Google Flights link alongside search
+ * results so a user can open the route (and complete a booking) in a
+ * browser. The natural-language `q` form used here is the same one Google's
+ * own frontend accepts.
+ *
+ * `withLocaleParams` lives here (rather than in `search/`) so the core layer
+ * stays free of any dependency on the search package; `search/urls.ts`
+ * re-exports it for backwards compatibility.
+ *
+ * 1:1 port of fli/core/links.py.
+ */
+const GOOGLE_FLIGHTS_URL = "https://www.google.com/travel/flights";
+/**
+ * Append optional `curr`/`hl`/`gl` parameters to a URL.
+ *
+ * - `currency` is uppercased ("usd" → "USD") because Google rejects lowercase
+ *   codes silently.
+ * - `language` is passed through verbatim (BCP-47).
+ * - `country` is uppercased (ISO 3166-1 alpha-2).
+ *
+ * All values are percent-encoded; returns `url` unchanged when all three are null.
+ */
+export function withLocaleParams(url, currency, language, country) {
+    const params = [];
+    if (currency)
+        params.push(`curr=${encodeURIComponent(currency.toUpperCase())}`);
+    if (language)
+        params.push(`hl=${encodeURIComponent(language)}`);
+    if (country)
+        params.push(`gl=${encodeURIComponent(country.toUpperCase())}`);
+    if (params.length === 0)
+        return url;
+    const sep = url.includes("?") ? "&" : "?";
+    return `${url}${sep}${params.join("&")}`;
+}
+/**
+ * Build a shareable Google Flights deep link for a route and dates.
+ *
+ * `origin` and `destination` are bare IATA codes (e.g. `"JFK"`). The returned
+ * URL pre-fills the route and outbound date (plus the return date for round
+ * trips); locale knobs (`curr`/`hl`/`gl`) are appended when supplied.
+ */
+export function googleFlightsUrl(origin, destination, departureDate, returnDate, options = {}) {
+    let query = `Flights from ${origin} to ${destination} on ${departureDate}`;
+    if (returnDate)
+        query += ` through ${returnDate}`;
+    const url = `${GOOGLE_FLIGHTS_URL}?q=${encodeURIComponent(query)}`;
+    return withLocaleParams(url, options.currency ?? null, options.language ?? null, options.country ?? null);
+}
+//# sourceMappingURL=links.js.map

package/dist/core/links.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"links.js","sourceRoot":"","sources":["../../src/core/links.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,kBAAkB,GAAG,uCAAuC,CAAC;AAEnE;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAC9B,GAAW,EACX,QAAmC,EACnC,QAAmC,EACnC,OAAkC;IAElC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,QAAQ;QAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,kBAAkB,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC;IAChF,IAAI,QAAQ;QAAE,MAAM,CAAC,IAAI,CAAC,MAAM,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAChE,IAAI,OAAO;QAAE,MAAM,CAAC,IAAI,CAAC,MAAM,kBAAkB,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC;IAC5E,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IACpC,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAC1C,OAAO,GAAG,GAAG,GAAG,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AAC3C,CAAC;AAQD;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAc,EACd,WAAmB,EACnB,aAAqB,EACrB,UAA0B,EAC1B,UAAmC,EAAE;IAErC,IAAI,KAAK,GAAG,gBAAgB,MAAM,OAAO,WAAW,OAAO,aAAa,EAAE,CAAC;IAC3E,IAAI,UAAU;QAAE,KAAK,IAAI,YAAY,UAAU,EAAE,CAAC;IAClD,MAAM,GAAG,GAAG,GAAG,kBAAkB,MAAM,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;IACnE,OAAO,gBAAgB,CACrB,GAAG,EACH,OAAO,CAAC,QAAQ,IAAI,IAAI,EACxB,OAAO,CAAC,QAAQ,IAAI,IAAI,EACxB,OAAO,CAAC,OAAO,IAAI,IAAI,CACxB,CAAC;AACJ,CAAC"}

package/dist/core/parsers.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Shared parsing utilities — string inputs from CLI/API callers into
+ * domain enum values. 1:1 port of fli/core/parsers.py.
+ */
+import { Airline } from "../models/airline.ts";
+import { Airport } from "../models/airport.ts";
+import { Alliance, EmissionsFilter, MaxStops, SeatType, SortBy } from "../models/google-flights/base.ts";
+export declare class ParseError extends Error {
+    constructor(message: string);
+}
+/** Resolve an enum member by case-insensitive name. */
+export declare function resolveEnum<T extends Record<string, unknown>>(enumObj: T, name: string): T[keyof T];
+/** Resolve a string airport IATA code to the `Airport` constant. */
+export declare function resolveAirport(code: string): Airport;
+/**
+ * Parse a list of airline tokens into Airline constants.
+ * Each item may itself contain multiple codes separated by commas or whitespace.
+ */
+export declare function parseAirlines(codes: string[] | null | undefined): Airline[] | null;
+/** Parse a list of alliance identifiers into Alliance constants. */
+export declare function parseAlliances(codes: string[] | null | undefined): Alliance[] | null;
+/** Parse a "stops" parameter into the matching `MaxStops` value. */
+export declare function parseMaxStops(stops: string): MaxStops;
+/** Parse a cabin-class string into a `SeatType` value. */
+export declare function parseCabinClass(cabinClass: string): SeatType;
+/** Parse a sort-by string into a `SortBy` value. */
+export declare function parseSortBy(sortBy: string): SortBy;
+/** Normalise an ISO 4217 currency code; pass through unknown 3-letter codes. */
+export declare function parseCurrency(currency: string | null | undefined): string | null;
+/** Parse an emissions filter string into an `EmissionsFilter` value. */
+export declare function parseEmissions(emissions: string): EmissionsFilter;
+/** Parse a time range string ("HH-HH") into a `[start, end]` tuple of hours. */
+export declare function parseTimeRange(timeRange: string): [number, number];
+//# sourceMappingURL=parsers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parsers.d.ts","sourceRoot":"","sources":["../../src/core/parsers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EACL,QAAQ,EAER,eAAe,EACf,QAAQ,EACR,QAAQ,EACR,MAAM,EACP,MAAM,kCAAkC,CAAC;AAE1C,qBAAa,UAAW,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM;CAI5B;AAID,uDAAuD;AACvD,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3D,OAAO,EAAE,CAAC,EACV,IAAI,EAAE,MAAM,GACX,CAAC,CAAC,MAAM,CAAC,CAAC,CAOZ;AAED,oEAAoE;AACpE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMpD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,EAAE,GAAG,IAAI,CAuBlF;AAED,oEAAoE;AACpE,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,QAAQ,EAAE,GAAG,IAAI,CAsBpF;AAED,oEAAoE;AACpE,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAqBrD;AAED,0DAA0D;AAC1D,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,CAO5D;AAED,oDAAoD;AACpD,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAOlD;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAYhF;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,CAEjE;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAoBlE"}

package/dist/core/parsers.js

@@ -0,0 +1,161 @@
+/**
+ * Shared parsing utilities — string inputs from CLI/API callers into
+ * domain enum values. 1:1 port of fli/core/parsers.py.
+ */
+import { Airline } from "../models/airline.js";
+import { Airport } from "../models/airport.js";
+import { Alliance, Currency, EmissionsFilter, MaxStops, SeatType, SortBy, } from "../models/google-flights/base.js";
+export class ParseError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ParseError";
+    }
+}
+const AIRLINE_SEPARATORS = /[,\s]+/;
+/** Resolve an enum member by case-insensitive name. */
+export function resolveEnum(enumObj, name) {
+    const upper = name.toUpperCase();
+    if (Object.hasOwn(enumObj, upper)) {
+        return enumObj[upper];
+    }
+    const valid = Object.keys(enumObj).join(", ");
+    throw new ParseError(`Invalid value: '${name}'. Valid values: ${valid}`);
+}
+/** Resolve a string airport IATA code to the `Airport` constant. */
+export function resolveAirport(code) {
+    const upper = code.toUpperCase();
+    if (Object.hasOwn(Airport, upper)) {
+        return Airport[upper];
+    }
+    throw new ParseError(`Invalid airport code: '${code}'`);
+}
+/**
+ * Parse a list of airline tokens into Airline constants.
+ * Each item may itself contain multiple codes separated by commas or whitespace.
+ */
+export function parseAirlines(codes) {
+    if (!codes || codes.length === 0)
+        return null;
+    const expanded = [];
+    for (const item of codes) {
+        for (const token of item.split(AIRLINE_SEPARATORS)) {
+            const t = token.trim().toUpperCase();
+            if (t)
+                expanded.push(t);
+        }
+    }
+    if (expanded.length === 0) {
+        throw new ParseError(`No valid airline codes found in: ${JSON.stringify(codes)}`);
+    }
+    const result = [];
+    for (const code of expanded) {
+        const key = /^[0-9]/.test(code) ? `_${code}` : code;
+        if (!Object.hasOwn(Airline, key)) {
+            throw new ParseError(`Invalid airline code: '${code}'`);
+        }
+        result.push(Airline[key]);
+    }
+    return result;
+}
+/** Parse a list of alliance identifiers into Alliance constants. */
+export function parseAlliances(codes) {
+    if (!codes || codes.length === 0)
+        return null;
+    const expanded = [];
+    for (const item of codes) {
+        for (const token of item.split(AIRLINE_SEPARATORS)) {
+            const t = token.trim().toUpperCase().replace(/ /g, "_").replace(/-/g, "_");
+            if (t)
+                expanded.push(t);
+        }
+    }
+    if (expanded.length === 0) {
+        throw new ParseError(`No valid alliance names found in: ${JSON.stringify(codes)}`);
+    }
+    const result = [];
+    for (const name of expanded) {
+        if (!Object.hasOwn(Alliance, name)) {
+            const valid = Object.keys(Alliance).join(", ");
+            throw new ParseError(`Invalid alliance: '${name}'. Valid values: ${valid}`);
+        }
+        result.push(Alliance[name]);
+    }
+    return result;
+}
+/** Parse a "stops" parameter into the matching `MaxStops` value. */
+export function parseMaxStops(stops) {
+    const asInt = Number.parseInt(stops, 10);
+    if (Number.isFinite(asInt) && String(asInt) === stops.trim()) {
+        if (asInt <= 0)
+            return MaxStops.NON_STOP;
+        if (asInt === 1)
+            return MaxStops.ONE_STOP_OR_FEWER;
+        if (asInt >= 2)
+            return MaxStops.TWO_OR_FEWER_STOPS;
+    }
+    const upper = stops.toUpperCase();
+    const map = {
+        ANY: MaxStops.ANY,
+        NON_STOP: MaxStops.NON_STOP,
+        NONSTOP: MaxStops.NON_STOP,
+        ONE_STOP: MaxStops.ONE_STOP_OR_FEWER,
+        ONE_STOP_OR_FEWER: MaxStops.ONE_STOP_OR_FEWER,
+        TWO_PLUS_STOPS: MaxStops.TWO_OR_FEWER_STOPS,
+        TWO_OR_FEWER_STOPS: MaxStops.TWO_OR_FEWER_STOPS,
+    };
+    if (Object.hasOwn(map, upper))
+        return map[upper];
+    throw new ParseError(`Invalid max_stops value: '${stops}'. Valid values: ANY, NON_STOP, ONE_STOP, TWO_PLUS_STOPS, or 0/1/2`);
+}
+/** Parse a cabin-class string into a `SeatType` value. */
+export function parseCabinClass(cabinClass) {
+    const upper = cabinClass.toUpperCase();
+    if (Object.hasOwn(SeatType, upper)) {
+        return SeatType[upper];
+    }
+    const valid = Object.keys(SeatType).join(", ");
+    throw new ParseError(`Invalid cabin_class value: '${cabinClass}'. Valid values: ${valid}`);
+}
+/** Parse a sort-by string into a `SortBy` value. */
+export function parseSortBy(sortBy) {
+    const upper = sortBy.toUpperCase();
+    if (Object.hasOwn(SortBy, upper)) {
+        return SortBy[upper];
+    }
+    const valid = Object.keys(SortBy).join(", ");
+    throw new ParseError(`Invalid sort_by value: '${sortBy}'. Valid values: ${valid}`);
+}
+/** Normalise an ISO 4217 currency code; pass through unknown 3-letter codes. */
+export function parseCurrency(currency) {
+    if (currency == null || currency === "")
+        return null;
+    const normalized = currency.trim().toUpperCase();
+    if (normalized.length !== 3 || !/^[A-Z]{3}$/.test(normalized)) {
+        throw new ParseError(`Invalid currency code: '${currency}'. Expected a 3-letter ISO 4217 code.`);
+    }
+    if (Object.hasOwn(Currency, normalized)) {
+        return Currency[normalized];
+    }
+    return normalized;
+}
+/** Parse an emissions filter string into an `EmissionsFilter` value. */
+export function parseEmissions(emissions) {
+    return resolveEnum(EmissionsFilter, emissions);
+}
+/** Parse a time range string ("HH-HH") into a `[start, end]` tuple of hours. */
+export function parseTimeRange(timeRange) {
+    const parts = timeRange.split("-");
+    if (parts.length !== 2) {
+        throw new ParseError(`Invalid time range format: '${timeRange}'. Expected 'HH-HH' (e.g., '6-20')`);
+    }
+    const start = Number.parseInt((parts[0] ?? "").trim(), 10);
+    const end = Number.parseInt((parts[1] ?? "").trim(), 10);
+    if (!Number.isFinite(start) || !Number.isFinite(end)) {
+        throw new ParseError(`Invalid time range format: '${timeRange}'. Expected 'HH-HH' (e.g., '6-20')`);
+    }
+    if (start < 0 || start > 23 || end < 0 || end > 23) {
+        throw new ParseError(`Invalid time range format: '${timeRange}'. Expected 'HH-HH' (e.g., '6-20')`);
+    }
+    return [start, end];
+}
+//# sourceMappingURL=parsers.js.map

package/dist/core/parsers.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * fli — TypeScript port of the Python fli library.
+ *
+ * Programmatic access to Google Flights data through direct
+ * (reverse-engineered) API interaction. No HTML scraping.
+ *
+ * @example
+ * ```ts
+ * import { SearchFlights, FlightSearchFilters, PassengerInfo, FlightSegment, Airport, SeatType } from "fli";
+ *
+ * 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,
+ * });
+ *
+ * const search = new SearchFlights();
+ * const results = await search.search(filters, { currency: "USD" });
+ * ```
+ */
+export * from "./core/index.ts";
+export * from "./models/index.ts";
+export * from "./search/index.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC"}