import {z} from 'zod' export type GetApiShoppingFlightOffersArgs = {originLocationCode: string, destinationLocationCode: string, departureDate: string, returnDate?: string | undefined, adults: number, children?: number | undefined, infants?: number | undefined, travelClass?: ('ECONOMY' | 'PREMIUM_ECONOMY' | 'BUSINESS' | 'FIRST') | undefined, includedAirlineCodes?: string | undefined, excludedAirlineCodes?: string | undefined, nonStop?: boolean | undefined, currencyCode?: string | undefined, maxPrice?: number | undefined, max?: number | undefined}; export type GetApiShoppingFlightOffersOptions = {baseUrl?: string | undefined, fetch?: typeof fetch | undefined}; export const issue = z.object({status: z.number().int().optional(), code: z.number().int().optional(), title: z.string().optional(), detail: z.string().optional(), source: z.object({pointer: z.string().optional(), parameter: z.string().optional(), example: z.string().optional()}).optional()}); export const collectionMetaLink = z.object({count: z.number().int().optional(), links: z.object({self: z.string().optional(), next: z.string().optional(), previous: z.string().optional(), last: z.string().optional(), first: z.string().optional(), up: z.string().optional()}).optional()}); export const flightOfferSource = z.literal("GDS"); export const travelClass = z.enum(["ECONOMY", "PREMIUM_ECONOMY", "BUSINESS", "FIRST"]); export const co2Emission = z.object({weight: z.number().int().optional(), weightUnit: z.string().optional(), cabin: travelClass.optional()}); export const flightEndPoint = z.object({iataCode: z.string().optional(), terminal: z.string().optional(), at: z.string().optional()}); export const aircraftEquipment = z.object({code: z.string().optional()}); export const operatingFlight = z.object({carrierCode: z.string().min(1).max(2).optional()}); export const flightStop = z.object({iataCode: z.string().optional(), duration: z.string().optional(), arrivalAt: z.string().optional(), departureAt: z.string().optional()}); export const segment = z.object({id: z.string().optional(), numberOfStops: z.number().int().optional(), blacklistedInEU: z.boolean().optional(), co2Emissions: z.array(co2Emission).optional(), departure: flightEndPoint.optional(), arrival: flightEndPoint.optional(), carrierCode: z.string().min(1).max(2).optional(), number: z.string().min(1).max(4).optional(), aircraft: aircraftEquipment.optional(), operating: operatingFlight.optional(), duration: z.string().optional(), stops: z.array(flightStop).optional()}); export const additionalServiceType = z.enum(["CHECKED_BAGS", "MEALS", "SEATS", "OTHER_SERVICES"]); export const feeType = z.enum(["TICKETING", "FORM_OF_PAYMENT", "SUPPLIER"]); export const fee = z.object({amount: z.string().optional(), type: feeType.optional()}); export const tax = z.object({amount: z.string().optional(), code: z.string().optional()}); export const extendedPrice = z.object({margin: z.string().optional(), grandTotal: z.string().optional(), billingCurrency: z.string().optional(), additionalServices: z.array(z.object({amount: z.string().optional(), type: additionalServiceType.optional()})).optional(), currency: z.string().optional(), total: z.string().optional(), base: z.string().optional(), fees: z.array(fee).optional(), taxes: z.array(tax).optional(), refundableTaxes: z.string().optional()}); export const pricingOptionsFareType = z.array(z.enum(["PUBLISHED", "NEGOTIATED", "CORPORATE"])); export const travelerPricingFareOption = z.enum(["STANDARD", "INCLUSIVE_TOUR", "SPANISH_MELILLA_RESIDENT", "SPANISH_CEUTA_RESIDENT", "SPANISH_CANARY_RESIDENT", "SPANISH_BALEARIC_RESIDENT", "AIR_FRANCE_METROPOLITAN_DISCOUNT_PASS", "AIR_FRANCE_DOM_DISCOUNT_PASS", "AIR_FRANCE_COMBINED_DISCOUNT_PASS", "AIR_FRANCE_FAMILY", "ADULT_WITH_COMPANION", "COMPANION"]); export const travelerType = z.enum(["ADULT", "CHILD", "SENIOR", "YOUNG", "HELD_INFANT", "SEATED_INFANT", "STUDENT"]); export const price = z.object({currency: z.string().optional(), total: z.string().optional(), base: z.string().optional(), fees: z.array(fee).optional(), taxes: z.array(tax).optional(), refundableTaxes: z.string().optional()}); export const sliceDiceIndicator = z.enum(["LOCAL_AVAILABILITY", "SUB_OD_AVAILABILITY_1", "SUB_OD_AVAILABILITY_2"]); export const baggageAllowance = z.object({quantity: z.number().int().optional(), weight: z.number().int().optional(), weightUnit: z.string().optional()}); export const serviceName = z.enum(["PRIORITY_BOARDING", "AIRPORT_CHECKIN"]); export const flightOffer = z.object({type: z.string(), id: z.string(), source: flightOfferSource.optional(), instantTicketingRequired: z.boolean().optional(), disablePricing: z.boolean().optional(), nonHomogeneous: z.boolean().optional(), oneWay: z.boolean().optional(), paymentCardRequired: z.boolean().optional(), lastTicketingDate: z.string().optional(), numberOfBookableSeats: z.number().gte(1).lte(9).optional(), itineraries: z.array(z.object({duration: z.string().optional(), segments: z.array(segment)})).optional(), price: extendedPrice.optional(), pricingOptions: z.object({fareType: pricingOptionsFareType.optional(), includedCheckedBagsOnly: z.boolean().optional(), refundableFare: z.boolean().optional(), noRestrictionFare: z.boolean().optional(), noPenaltyFare: z.boolean().optional()}).optional(), validatingAirlineCodes: z.array(z.string()).optional(), travelerPricings: z.array(z.object({travelerId: z.string(), fareOption: travelerPricingFareOption, travelerType: travelerType, associatedAdultId: z.string().optional(), price: price.optional(), fareDetailsBySegment: z.array(z.object({segmentId: z.string(), cabin: travelClass.optional(), fareBasis: z.string().optional(), brandedFare: z.string().optional(), class: z.string().optional(), isAllotment: z.boolean().optional(), allotmentDetails: z.object({tourName: z.string().optional(), tourReference: z.string().optional()}).optional(), sliceDiceIndicator: sliceDiceIndicator.optional(), includedCheckedBags: baggageAllowance.optional(), additionalServices: z.object({chargeableCheckedBags: baggageAllowance.optional(), chargeableSeatNumber: z.string().optional(), otherServices: z.array(serviceName).optional()}).optional()}))})).optional()}); export const locationValue = z.object({cityCode: z.string().optional(), countryCode: z.string().optional()}); export const locationEntry = z.object({key: z.string()}).and(z.record(z.string(), locationValue)); export const aircraftEntry = z.object({key: z.string().optional()}).and(z.record(z.string(), z.string())); export const currencyEntry = z.object({key: z.string()}).and(z.record(z.string(), z.string())); export const carrierEntry = z.object({key: z.string().optional()}).and(z.record(z.string(), z.string())); export const dictionaries = z.object({locations: locationEntry.optional(), aircraft: aircraftEntry.optional(), currencies: currencyEntry.optional(), carriers: carrierEntry.optional()}); export const getApiShoppingFlightOffersResponse = z.object({warnings: z.array(issue).optional(), meta: collectionMetaLink.optional(), data: z.array(flightOffer), dictionaries: dictionaries.optional()}); export const validateResponse = async ( schema: { readonly '~standard': { readonly validate: (value: unknown) => ({ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }) | Promise<{ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }> } }, value: unknown ): Promise => { const result = await schema['~standard'].validate(value) if (result.issues !== undefined) { const detail = result.issues .map(({ message, path }) => path?.length ? `${path.map((segment) => String(typeof segment === 'object' ? segment.key : segment)).join('.')}: ${message}` : message ) .join('; ') throw new Error(`Response does not match the schema: ${detail}`, { cause: { issues: result.issues } }) } return result.value }; /** * Return list of Flight Offers based on searching criteria. * * GET /shopping/flight-offers */ export const getApiShoppingFlightOffers = async (args: GetApiShoppingFlightOffersArgs, options?: GetApiShoppingFlightOffersOptions) => { const {baseUrl = "https://test.api.amadeus.com/v2", fetch: fetchFn = fetch} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/vnd.amadeus+json") if (args.originLocationCode != null) query.append("originLocationCode", String(args.originLocationCode)) if (args.destinationLocationCode != null) query.append("destinationLocationCode", String(args.destinationLocationCode)) if (args.departureDate != null) query.append("departureDate", String(args.departureDate)) if (args.returnDate != null) query.append("returnDate", String(args.returnDate)) if (args.adults != null) query.append("adults", String(args.adults)) if (args.children != null) query.append("children", String(args.children)) if (args.infants != null) query.append("infants", String(args.infants)) if (args.travelClass != null) query.append("travelClass", String(args.travelClass)) if (args.includedAirlineCodes != null) query.append("includedAirlineCodes", String(args.includedAirlineCodes)) if (args.excludedAirlineCodes != null) query.append("excludedAirlineCodes", String(args.excludedAirlineCodes)) if (args.nonStop != null) query.append("nonStop", String(args.nonStop)) if (args.currencyCode != null) query.append("currencyCode", String(args.currencyCode)) if (args.maxPrice != null) query.append("maxPrice", String(args.maxPrice)) if (args.max != null) query.append("max", String(args.max)) const url = `${baseUrl.replace(/\/+$/, '')}/shopping/flight-offers${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "GET", headers}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(getApiShoppingFlightOffersResponse, await res.json()) };