Google Flights MCP, CLI and Python Library
/**
* 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 };
}