Skip to content

armgit / fli

Public Imported from GitHub
0

Google Flights MCP, CLI and Python Library

8.9 KB
Raw Blame
/**
 * DateSearchFilters — payload for Google Flights' GetCalendarGraph endpoint.
 *
 * 1:1 port of fli/models/google_flights/dates.py.
 */

import { formatIsoDate, parseIsoDate } from "../../core/dates.ts";
import { AIRLINE_NAMES, type Airline } from "../airline.ts";
import {
  type Alliance,
  type BagsFilter,
  EmissionsFilter,
  type FlightSegment,
  type LayoverRestrictions,
  MaxStops,
  type PassengerInfo,
  type PriceLimit,
  SeatType,
  TripType,
} from "./base.ts";

const MAX_PAST_FROM_DATE_DAYS = 6;

function airlineSortKey(a: Airline): string {
  const code = a.startsWith("_") ? a.slice(1) : a;
  return AIRLINE_NAMES[code] ?? code;
}

function serializeCode(code: string): string {
  return code.startsWith("_") ? code.slice(1) : code;
}

function todayUtc(): Date {
  const now = new Date();
  return new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate()));
}

export interface DateSearchFiltersInput {
  trip_type?: TripType;
  passenger_info: PassengerInfo;
  flight_segments: FlightSegment[];
  stops?: MaxStops;
  seat_type?: SeatType;
  price_limit?: PriceLimit | null;
  airlines?: Airline[] | null;
  airlines_exclude?: Airline[] | null;
  alliances?: Alliance[] | null;
  alliances_exclude?: Alliance[] | null;
  max_duration?: number | null;
  layover_restrictions?: LayoverRestrictions | null;
  emissions?: EmissionsFilter;
  bags?: BagsFilter | null;
  from_date: string;
  to_date: string;
  duration?: number | null;
}

export class DateSearchFilters {
  trip_type: TripType;
  passenger_info: PassengerInfo;
  flight_segments: FlightSegment[];
  stops: MaxStops;
  seat_type: SeatType;
  price_limit: PriceLimit | null;
  airlines: Airline[] | null;
  airlines_exclude: Airline[] | null;
  alliances: Alliance[] | null;
  alliances_exclude: Alliance[] | null;
  max_duration: number | null;
  layover_restrictions: LayoverRestrictions | null;
  emissions: EmissionsFilter;
  bags: BagsFilter | null;
  from_date: string;
  to_date: string;
  duration: number | null;

  constructor(input: DateSearchFiltersInput) {
    this.trip_type = input.trip_type ?? TripType.ONE_WAY;
    this.passenger_info = input.passenger_info;
    this.flight_segments = input.flight_segments;
    this.stops = input.stops ?? MaxStops.ANY;
    this.seat_type = input.seat_type ?? SeatType.ECONOMY;
    this.price_limit = input.price_limit ?? null;
    this.airlines = input.airlines ?? null;
    this.airlines_exclude = input.airlines_exclude ?? null;
    this.alliances = input.alliances ?? null;
    this.alliances_exclude = input.alliances_exclude ?? null;
    this.max_duration = input.max_duration ?? null;
    this.layover_restrictions = input.layover_restrictions ?? null;
    this.emissions = input.emissions ?? EmissionsFilter.ALL;
    this.bags = input.bags ?? null;
    this.duration = input.duration ?? null;

    // Validate / coerce the date range.
    let { from_date, to_date } = input;

    // Trip-type-specific segment-count validation.
    if (this.trip_type === TripType.ONE_WAY && this.flight_segments.length !== 1) {
      throw new Error("One-way trip must have one flight segment");
    }
    if (this.trip_type === TripType.ROUND_TRIP && this.flight_segments.length !== 2) {
      throw new Error("Round trip must have two flight segments");
    }
    if (this.trip_type === TripType.ROUND_TRIP && this.duration == null) {
      throw new Error("Duration must be set for round trip flights");
    }
    if (this.duration != null && this.flight_segments.length === 2) {
      const a = this.flight_segments[0]?.parsed_travel_date.getTime() ?? 0;
      const b = this.flight_segments[1]?.parsed_travel_date.getTime() ?? 0;
      const diffDays = Math.round((b - a) / (1000 * 60 * 60 * 24));
      if (diffDays !== this.duration) {
        throw new Error("Flight segments travel dates difference must match duration");
      }
    }

    // Swap from/to if from > to (mirrors the Python validator).
    const fromDate = parseIsoDate(from_date);
    const toDate = parseIsoDate(to_date);
    if (fromDate > toDate) {
      const swappedFrom = formatIsoDate(toDate);
      const swappedTo = formatIsoDate(fromDate);
      from_date = swappedFrom;
      to_date = swappedTo;
    }

    // to_date must be strictly in the future.
    const today = todayUtc();
    if (parseIsoDate(to_date) <= today) {
      throw new Error("To date must be in the future");
    }

    // If from_date is more than MAX_PAST_FROM_DATE_DAYS in the past, snap to today.
    const fromParsed = parseIsoDate(from_date);
    if (fromParsed < today) {
      const deltaDays = Math.round(
        (today.getTime() - fromParsed.getTime()) / (1000 * 60 * 60 * 24),
      );
      if (deltaDays > MAX_PAST_FROM_DATE_DAYS) {
        from_date = formatIsoDate(today);
      }
    }

    this.from_date = from_date;
    this.to_date = to_date;
  }

  get parsed_from_date(): Date {
    return parseIsoDate(this.from_date);
  }

  get parsed_to_date(): Date {
    return parseIsoDate(this.to_date);
  }

  format(): unknown[] {
    const formattedSegments: unknown[] = [];
    for (const segment of this.flight_segments) {
      const departureBlock = [
        segment.departure_airport.map((airports) =>
          airports.map((airport) => [serializeCode(airport[0]), airport[1]]),
        ),
      ];
      const arrivalBlock = [
        segment.arrival_airport.map((airports) =>
          airports.map((airport) => [serializeCode(airport[0]), airport[1]]),
        ),
      ];

      const tr = segment.time_restrictions;
      const timeFilters: Array<number | null | undefined> | null = tr
        ? [
            tr.earliest_departure ?? null,
            tr.latest_departure ?? null,
            tr.earliest_arrival ?? null,
            tr.latest_arrival ?? null,
          ]
        : null;

      const includeTokens: string[] = [];
      if (this.airlines?.length) {
        const sorted = [...this.airlines].sort((a, b) => {
          const ka = airlineSortKey(a);
          const kb = airlineSortKey(b);
          return ka < kb ? -1 : ka > kb ? 1 : 0;
        });
        for (const a of sorted) includeTokens.push(serializeCode(a));
      }
      if (this.alliances?.length) {
        for (const a of [...this.alliances].sort()) includeTokens.push(a);
      }
      const airlinesFilters: string[] | null = includeTokens.length ? includeTokens : null;

      const excludeTokens: string[] = [];
      if (this.airlines_exclude?.length) {
        const sorted = [...this.airlines_exclude].sort((a, b) => {
          const ka = airlineSortKey(a);
          const kb = airlineSortKey(b);
          return ka < kb ? -1 : ka > kb ? 1 : 0;
        });
        for (const a of sorted) excludeTokens.push(serializeCode(a));
      }
      if (this.alliances_exclude?.length) {
        for (const a of [...this.alliances_exclude].sort()) excludeTokens.push(a);
      }
      const excludeFilters: string[] | null = excludeTokens.length ? excludeTokens : null;

      const layoverAirports = this.layover_restrictions?.airports?.length
        ? this.layover_restrictions.airports.map(serializeCode)
        : null;
      const layoverMin = this.layover_restrictions?.min_duration ?? null;
      const layoverMax = this.layover_restrictions?.max_duration ?? null;

      const emissionsFilter: number[] | null =
        this.emissions !== EmissionsFilter.ALL ? [this.emissions] : null;

      formattedSegments.push([
        departureBlock[0],
        arrivalBlock[0],
        timeFilters,
        this.stops,
        airlinesFilters,
        excludeFilters,
        segment.travel_date,
        this.max_duration != null ? [this.max_duration] : null,
        null, // 8: selected flight (unused in date search)
        layoverAirports,
        null,
        layoverMin,
        layoverMax,
        emissionsFilter,
        3, // 14: hardcoded
      ]);
    }

    const bagsFilter: [number, number] | null = this.bags
      ? [this.bags.checked_bags, this.bags.carry_on ? 1 : 0]
      : null;

    const base: unknown[] = [
      null,
      [
        null, // [0]
        null, // [1]
        this.trip_type, // [2]
        null, // [3]
        [], // [4]
        this.seat_type, // [5]
        [
          this.passenger_info.adults,
          this.passenger_info.children,
          this.passenger_info.infants_on_lap,
          this.passenger_info.infants_in_seat,
        ], // [6]
        this.price_limit ? [null, this.price_limit.max_price] : null, // [7]
        null, // [8]
        null, // [9]
        bagsFilter, // [10]
        null, // [11]
        null, // [12]
        formattedSegments,
        null, // [14]
        null, // [15]
        null, // [16]
        1, // [17]
      ],
      [this.from_date, this.to_date],
    ];

    if (this.trip_type === TripType.ROUND_TRIP) {
      base.push(null, [this.duration, this.duration]);
    }

    return base;
  }

  encode(): string {
    const formatted = this.format();
    const formattedJson = JSON.stringify(formatted);
    const wrapped: unknown[] = [null, formattedJson];
    return encodeURIComponent(JSON.stringify(wrapped));
  }
}