/** * BTS SDK — typed API client for Bureau of Transportation Statistics data. * * Standalone — no MCP server required. Usage: * * import { getTransportStats, getBorderCrossings } from "us-gov-open-data-mcp/sdk/bts"; * * const stats = await getTransportStats({ limit: 12 }); * const border = await getBorderCrossings({ state: "Texas", measure: "Trucks" }); * * No API key required (uses Socrata SODA API at data.bts.gov). * Docs: https://data.bts.gov/ */ /** Transport Stats Record. */ export interface TransportStatsRecord { index?: string; date?: string; u_s_airline_traffic_total_non_seasonally_adjusted?: string; u_s_airline_traffic_domestic_non_seasonally_adjusted?: string; u_s_airline_traffic_international_non_seasonally_adjusted?: string; u_s_marketing_air_carriers_on_time_performance_percent?: string; u_s_air_carrier_cargo_millions_of_revenue_ton_miles_domestic?: string; u_s_air_carrier_cargo_millions_of_revenue_ton_miles_international?: string; system_use_transit_ridership?: string; system_use_highway_vehicle?: string; system_use_freight_rail?: string; passenger_rail_passengers?: string; passenger_rail_passenger_miles?: string; amtrak_on_time_performance?: string; safety_general_aviation?: string; air_safety_air_carrier_fatalities?: string; rail_fatalities?: string; transportation_services_index_freight?: string; transportation_services_index_passenger?: string; transportation_services_index_combined?: string; u_s_canada_incoming_person_crossings?: string; u_s_canada_incoming_truck_crossings?: string; u_s_mexico_incoming_person_crossings?: string; u_s_mexico_incoming_truck_crossings?: string; auto_sales?: string; auto_sales_saar_millions?: string; light_truck_sales?: string; heavy_truck_sales?: string; highway_fuel_prices_regular?: string; truck_tonnage_index?: string; u_s_waterway_tonnage?: string; general_economic_indicators?: string; transportation_economic?: string; [key: string]: unknown; } /** Border Crossing Record. */ export interface BorderCrossingRecord { port_name?: string; state?: string; port_code?: string; border?: string; date?: string; measure?: string; value?: string; latitude?: string; longitude?: string; [key: string]: unknown; } /** Key fields in the Monthly Transportation Statistics dataset. */ export declare const TRANSPORT_FIELDS: { readonly u_s_airline_traffic_total_non_seasonally_adjusted: "U.S. airline passenger traffic (total, not SA)"; readonly u_s_marketing_air_carriers_on_time_performance_percent: "Airline on-time performance (%)"; readonly system_use_transit_ridership: "Transit ridership"; readonly transportation_services_index_freight: "Transportation Services Index — Freight"; readonly transportation_services_index_passenger: "Transportation Services Index — Passenger"; readonly transportation_services_index_combined: "Transportation Services Index — Combined"; readonly truck_tonnage_index: "Truck Tonnage Index"; readonly amtrak_on_time_performance: "Amtrak on-time performance"; readonly highway_fuel_prices_regular: "Regular gasoline price ($/gallon)"; readonly auto_sales_saar_millions: "Auto sales (SAAR, millions)"; readonly rail_fatalities: "Rail fatalities"; readonly air_safety_air_carrier_fatalities: "Air carrier fatalities"; }; /** Border crossing measures. */ export declare const BORDER_MEASURES: { readonly Trucks: "Commercial trucks"; readonly "Personal Vehicles": "Personal vehicles (cars)"; readonly Pedestrians: "Foot traffic"; readonly "Train Passengers": "Rail passengers"; readonly "Rail Containers Loaded": "Rail freight containers (loaded)"; readonly "Rail Containers Empty": "Rail freight containers (empty)"; readonly Buses: "Bus crossings"; }; /** Socrata dataset IDs. */ export declare const DATASETS: { readonly monthly_stats: { readonly id: "crem-w557"; readonly description: "Monthly Transportation Statistics: 50+ indicators on airlines, transit, rail, safety, fuel, vehicle sales"; }; readonly border_crossings: { readonly id: "keg4-3bc2"; readonly description: "Border crossing data: vehicles, passengers, containers at U.S. ports of entry (monthly)"; }; }; /** * Get Monthly Transportation Statistics (50+ time series in one dataset). * Covers airline traffic, on-time %, transit ridership, rail freight, truck tonnage, * fuel prices, vehicle sales, safety fatalities, Transportation Services Index, * and border crossing summaries. * * Example: * const data = await getTransportStats({ limit: 24 }); // latest 2 years (monthly) * const data = await getTransportStats({ startDate: "2020-01-01", endDate: "2023-12-31" }); */ export declare function getTransportStats(opts?: { startDate?: string; endDate?: string; limit?: number; offset?: number; order?: string; where?: string; }): Promise; /** * Get border crossing data (vehicles, passengers, containers at U.S. ports of entry). * * Example: * const data = await getBorderCrossings({ state: "Texas", measure: "Trucks" }); * const data = await getBorderCrossings({ border: "US-Mexico Border" }); */ export declare function getBorderCrossings(opts?: { state?: string; border?: string; portName?: string; measure?: string; limit?: number; offset?: number; order?: string; where?: string; }): Promise; /** Clear cached responses. */ export declare function clearCache(): void; //# sourceMappingURL=sdk.d.ts.map