Skip to content

armgit / fli

Public Imported from GitHub
0

Google Flights MCP, CLI and Python Library

5.3 KB
Raw Blame
/**
 * 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";
import { parseTimeRange } from "./parsers.ts";

const ISO_DATE_RE = /^\d{4}-\d{1,2}-\d{1,2}$/;

/** Zero-pad a YYYY-MM-DD date string. */
export function normalizeDate(dateStr: string): string {
  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?: string | null,
  arrivalWindow?: string | null,
): TimeRestrictions | null {
  if (!departureWindow && !arrivalWindow) return null;

  let earliestDeparture: number | null = null;
  let latestDeparture: number | null = null;
  let earliestArrival: number | null = null;
  let latestArrival: number | null = 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: Airport | Airport[],
  destination: Airport | Airport[],
  departureDate: string,
  returnDate?: string | null,
  timeRestrictions?: TimeRestrictions | null,
): { segments: FlightSegment[]; tripType: TripType } {
  const depDate = normalizeDate(departureDate);
  const origins = Array.isArray(origin) ? origin : [origin];
  const destinations = Array.isArray(destination) ? destination : [destination];

  const segments: FlightSegment[] = [
    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 = 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: Array<[Airport, Airport, string]>,
  timeRestrictions?: TimeRestrictions | null,
): { segments: FlightSegment[]; tripType: TripType } {
  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: Airport | Airport[],
  destination: Airport | Airport[],
  startDate: string,
  options: {
    tripDuration?: number | null;
    isRoundTrip?: boolean;
    timeRestrictions?: TimeRestrictions | null;
  } = {},
): { segments: FlightSegment[]; tripType: TripType } {
  const startNormalized = normalizeDate(startDate);
  const origins = Array.isArray(origin) ? origin : [origin];
  const destinations = Array.isArray(destination) ? destination : [destination];

  const segments: FlightSegment[] = [
    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 = 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 };
}