duffel

type API struct {
	APIToken string
	// contains filtered or unexported fields
}

type ActionTakenType string

type AddOrderServiceInput struct {
	// AddServices The services you want to add to the order.
	AddServices []ServiceCreateInput `json:"add_services"`

	// Payment The payment details to pay for the services.
	Payment PaymentCreateInput `json:"payment"`
}

type Aircraft struct {
	IATACode string `json:"iata_code"`
	ID       string `json:"id"`
	Name     string `json:"name"`
}

type AircraftClient interface {
	ListAircraft(ctx context.Context) *Iter[Aircraft]
	GetAircraft(ctx context.Context, id string) (*Aircraft, error)
}

type Airline struct {
	Name                    string `json:"name"`
	IATACode                string `json:"iata_code"`
	ID                      string `json:"id"`
	LogoSymbolURL           string `json:"logo_symbol_url"`
	LogoLockupURL           string `json:"logo_lockup_url"`
	ConditionsOfCarriageURL string `json:"conditions_of_carriage_url"`
}

type AirlineCredit struct {
	RawCreditAmount   string `json:"credit_amount"`
	RawCreditCurrency string `json:"credit_currency"`
	CreditCode        string `json:"credit_code"`
	CreditName        string `json:"credit_name"`
	ID                string `json:"id"`
	IssuedOn          Date   `json:"issued_on"`
	PassengerID       string `json:"passenger_id"`
}

type AirlineInitiatedChanges struct {
	ID               string                `json:"id"`
	ActionTaken      ActionTakenType       `json:"actions_taken"`
	ActionTakenAt    time.Time             `json:"actions_taken_at"`
	Added            []Slice               `json:"added"`
	AvailableActions []AvailableActionType `json:"available_actions"`
	CreatedAt        time.Time             `json:"created_at"`
	OrderID          string                `json:"order_id"`
	Removed          []Slice               `json:"removed"`
	// TODO: TravelAgentTicket // preview
	UpdatedAt time.Time `json:"updated_at"`
}

type AirlinesClient interface {
	ListAirlines(ctx context.Context) *Iter[Airline]
	GetAirline(ctx context.Context, id string) (*Airline, error)
}

type Airport struct {
	ID              string  `json:"id" `
	Name            string  `json:"name" `
	City            City    `json:"city,omitempty" `
	CityName        string  `json:"city_name" `
	IATACode        string  `json:"iata_code" `
	IATACountryCode string  `json:"iata_country_code" `
	ICAOCode        string  `json:"icao_code" `
	Latitude        float32 `json:"latitude" `
	Longitude       float32 `json:"longitude" `
	TimeZone        string  `json:"time_zone" `
}

type AirportsClient interface {
	ListAirports(ctx context.Context, params ...ListAirportsParams) *Iter[Airport]
	GetAirport(ctx context.Context, id string) (*Airport, error)
}

type AvailableActionType string

type AvailableService struct {
	// Duffel's unique identifier for service
	ID               string                   `json:"id"`
	MaximumQuantity  int                      `json:"maximum_quantity"`
	Metadata         AvailableServiceMetadata `json:"metadata"`
	PassengerIDs     []string                 `json:"passenger_ids"`
	SegmentIDs       []string                 `json:"segment_ids"`
	RawTotalAmount   string                   `json:"total_amount"`
	RawTotalCurrency string                   `json:"total_currency"`

	// Possible values: "baggage", "seat", "meal", or "cancel_for_any_reason"
	Type string `json:"type"`
}

type AvailableServiceMetadata struct {
	// For a Baggage
	MaximumDepthCM  int `json:"maximum_depth_cm,omitempty"`  // e.g. 30
	MaximumHeightCM int `json:"maximum_height_cm,omitempty"` // e.g. 40
	MaximumLengthCM int `json:"maximum_length_cm,omitempty"` // e.g. 55
	MaximumWeightKg int `json:"maximum_weight_kg,omitempty"` // e.g. 23
	// Possible values: "checked", "carry_on"
	Type string `json:"type"`

	// For a Seat
	Designator  string   `json:"designator,omitempty"`  // e.g. "14B"
	Disclosures []string `json:"disclosures,omitempty"` // e.g. ["Do not seat children in exit row seats"]
	Name        string   `json:"name,omitempty"`        // e.g. "Exit row seat"

	// For a Meal
	Meal MealType `json:"meal,omitempty"` // e.g. "vegetarian_meal"

	// For Cancel for Any Reason
	MerchantCopy          string `json:"merchant_copy,omitempty"`            // e.g. "If you purchase this product we can refund up to 75% of your base fare if you cancel 24 hours before your first scheduled departure\n"
	RawRefundAmount       string `json:"refund_amount,omitempty"`            // e.g. "100.00"
	TermsAndConditionsURL string `json:"terms_and_conditions_url,omitempty"` // e.g. "https://example.com/terms-and-conditions"
}

type Baggage struct {
	Quantity int    `json:"quantity"`
	Type     string `json:"type"`
}

type BaseSlice struct {
	OriginType      LocationType `json:"origin_type"`
	Origin          Location     `json:"origin"`
	DestinationType LocationType `json:"destination_type"`
	Destination     Location     `json:"destination"`
	DepartureDate   Date         `json:"departure_date,omitempty"`
	CreatedAt       time.Time    `json:"created_at,omitempty"`
}

type Cabin struct {
	Aisles     int        `json:"aisles"`
	CabinClass CabinClass `json:"cabin_class"`
	Deck       int        `json:"deck"`
	// A list of rows in this cabin.
	Rows []Row `json:"rows"`

	// Where the wings of the aircraft are in relation to rows in the cabin.
	Wings Wing `json:"wings"`
}

type CabinClass string

type ChangeCondition struct {
	Allowed            bool    `json:"allowed"`
	RawPenaltyAmount   *string `json:"penalty_amount,omitempty"`
	RawPenaltyCurrency *string `json:"penalty_currency,omitempty"`
}

type City struct {
	ID              string  `json:"id,omitempty" csv:"city_id"`
	Name            string  `json:"name" csv:"city_name"`
	IATACountryCode *string `json:"iata_country_code,omitempty" csv:"city_iata_country_code"`
	IATACode        string  `json:"iata_code,omitempty" csv:"city_iata_code"`
}

type Conditions struct {
	RefundBeforeDeparture *ChangeCondition `json:"refund_before_departure,omitempty"`
	ChangeBeforeDeparture *ChangeCondition `json:"change_before_departure,omitempty"`
}

type CreateOrderInput struct {
	Type OrderType `json:"type"`

	// Metadata contains a set of key-value pairs that you can attach to an object.
	// It can be useful for storing additional information about the object, in a
	// structured format. Duffel does not use this information.
	//
	// You should not store sensitive information in this field.
	Metadata Metadata `json:"metadata,omitempty"`

	// Passengers The personal details of the passengers, expanding on
	// the information initially provided when creating the offer request.
	Passengers []OrderPassenger `json:"passengers"`

	Payments []PaymentCreateInput `json:"payments,omitempty"`

	// SelectedOffers The ids of the offers you want to book. You must specify an array containing exactly one selected offer.
	SelectedOffers []string `json:"selected_offers"`

	Services []ServiceCreateInput `json:"services,omitempty"`
}

type CreatePayment struct {
	Amount   string      `json:"amount"`
	Currency string      `json:"currency"`
	Type     PaymentType `json:"type"`
	CardID   string      `json:"card_id,omitempty"`
}

type CreatePaymentCardRecordRequest struct {
	AddressCity        string `json:"address_city"`
	AddressCountryCode string `json:"address_country_code"`
	AddressLine1       string `json:"address_line_1"`
	AddressLine2       string `json:"address_line_2"`
	AddressPostalCode  string `json:"address_postal_code"`
	AddressRegion      string `json:"address_region"`
	// Deprecated: Brand is no longer required
	Brand        PaymentCardBrand `json:"brand,omitempty"`
	ExpiryMonth  string           `json:"expiry_month"`
	ExpiryYear   string           `json:"expiry_year"`
	Name         string           `json:"name"`
	Number       string           `json:"number"`
	SecurityCode string           `json:"cvc"`
	// MultiUse controls whether the card should be saved for future use. If false, the card will be saved temporarily.
	MultiUse bool `json:"multi_use"`
}

type CreatePaymentRequest struct {
	OrderID string        `json:"order_id"`
	Payment CreatePayment `json:"payment"`
}

type CreateTemporaryPaymentCardRecordFromSavedPaymentCardRequest struct {
	CardID       string `json:"card_id"`
	SecurityCode string `json:"cvc"`
}

type Date time.Time

type DateTime time.Time

type Distance float64

type Duffel interface {
	OfferRequestClient
	OfferClient
	OrderClient
	OrderChangeClient
	OrderCancellationClient
	OrderPaymentClient
	SeatmapClient
	AirportsClient
	AirlinesClient
	AircraftClient
	PlacesClient
	PaymentCardClient
	LoyaltyProgrammeClient

	LastRequestID() (string, bool)
}

type DuffelError struct {
	Meta       ErrorMeta `json:"meta"`
	Errors     []Error   `json:"errors"`
	StatusCode int       `json:"-"`
	Retryable  bool      `json:"-"`
}

type Duration time.Duration

type ElementType string

type EmptyPayload struct{}

type Error struct {
	Type             ErrorType    `json:"type"`
	Title            string       `json:"title"`
	Message          string       `json:"message"`
	DocumentationURL string       `json:"documentation_url"`
	Code             ErrorCode    `json:"code"`
	Source           *ErrorSource `json:"source,omitempty"`
}

type ErrorCode string

type ErrorMeta struct {
	Status    int64  `json:"status"`
	RequestID string `json:"request_id"`
}

type ErrorSource struct {
	Field   string `json:"field"`
	Pointer string `json:"pointer"`
}

type ErrorType string

type FareType string

type Flight struct {
	ID                           string             `json:"id"`
	Passengers                   []SegmentPassenger `json:"passengers"`
	Origin                       Location           `json:"origin"`
	OriginTerminal               string             `json:"origin_terminal"`
	OperatingCarrierFlightNumber string             `json:"operating_carrier_flight_number"`
	OperatingCarrier             Airline            `json:"operating_carrier"`
	MarketingCarrierFlightNumber string             `json:"marketing_carrier_flight_number"`
	MarketingCarrier             Airline            `json:"marketing_carrier"`
	Duration                     Duration           `json:"duration"`
	// Distance is the distance in km
	Distance            Distance `json:"distance,omitempty"`
	DestinationTerminal string   `json:"destination_terminal"`
	Destination         Location `json:"destination"`
	RawDepartingAt      string   `json:"departing_at"`
	RawArrivingAt       string   `json:"arriving_at"`
	Aircraft            Aircraft `json:"aircraft"`
	Stops               []Stop   `json:"stops"`
}

type Gender string

type GetOfferParams struct {
	ReturnAvailableServices bool
}

type IdentityDocument struct {
	// The unique identifier of the identity document.
	// We currently only support passport so this would be the passport number.
	UniqueIdentifier string `json:"unique_identifier"`

	// The date on which the identity document expires
	ExpiresOn Date `json:"expires_on"`

	// The ISO 3166-1 alpha-2 code of the country that issued this identity document
	IssuingCountryCode string `json:"issuing_country_code"`

	Type string `json:"type"`
}

type IssuedDocument struct {
	PassengerIDs     []string           `json:"passenger_ids"`
	Type             IssuedDocumentType `json:"type"`
	UniqueIdentifier string             `json:"unique_identifier"`
}

type IssuedDocumentType string

type Iter[T any] struct {
	// contains filtered or unexported fields
}

type List[T any] struct {

	// *Iter[T]
	*ListMeta
	// contains filtered or unexported fields
}

type ListAirlineInitiatedChangesParams struct {
	OrderID string `url:"order_id,omitempty"`
}

type ListAirportsParams struct {
	IATACountryCode string `url:"iata_country_code,omitempty"`
}

type ListContainer[T any] interface {
	SetListMeta(*ListMeta)
	GetListMeta() *ListMeta
	GetItems() []*T
	SetItems(items []*T)
	LastRequestID() (string, bool)
}

type ListMeta struct {

	// After is a string that contains the token for the next page of results
	After string `json:"after,omitempty" url:"after,omitempty"`

	// Before is a string that contains the token for the previous page of results
	Before string `json:"before,omitempty" url:"-"`

	// Limit is a number that indicates the maximum number of items to return
	Limit int `json:"limit,omitempty" url:"limit,omitempty"`
}

type ListOffersParams struct {
	Sort           ListOffersSortParam `url:"sort,omitempty"`
	MaxConnections int                 `url:"max_connections,omitempty"`
}

type ListOffersSortParam string

type ListOrderCancellationParams struct {
	OrderID string `url:"order_id,omitempty"`
}

type ListOrderChangeOffersParams struct {
	OrderChangeRequestID string                         `url:"order_change_request_id,omitempty"`
	Sort                 ListOrderChangeOffersSortParam `url:"sort,omitempty"`
	MaxConnections       int                            `url:"max_connections,omitempty"`
}

type ListOrderChangeOffersSortParam string

type ListOrdersParams struct {
	// Filters orders by their booking reference.
	// The filter requires an exact match but is case insensitive.
	BookingReference string `url:"booking_reference,omitempty"`

	// Whether to filter orders that are awaiting payment or not.
	// If not specified, all orders regardless of their payment state will be returned.
	AwaitingPayment bool `url:"awaiting_payment,omitempty"`

	// By default, orders aren't returned in any specific order.
	// This parameter allows you to sort the list of orders by the payment_required_by date
	Sort ListOrdersSort `url:"sort,omitempty"`

	// Filters the returned orders by owner.id. Values must be valid airline.ids.
	// Check the Airline schema for details.
	OwnerIDs []string `url:"owner_id,omitempty"`

	// Filters the returned orders by origin. Values must be valid origin identifiers.
	// Check the Order schema for details.
	OriginIDs []string `url:"origin_id,omitempty"`

	// Filters the returned orders by destination. Values must be valid destination identifiers.
	// Check the Order schema for details.
	DestinationIDs []string `url:"destination_id,omitempty"`

	// Filters the returned orders by departure datetime.
	// Orders will be included if any of their segments matches the given criteria
	DepartingAt *TimeFilter `url:"departing_at,omitempty"`

	// Filters the returned orders by arrival datetime.
	// Orders will be included if any of their segments matches the given criteria.
	ArrivingAt *TimeFilter `url:"arriving_at,omitempty"`

	// Filters the returned orders by creation datetime.
	CreatedAt *TimeFilter `url:"created_at,omitempty"`

	// Orders will be included if any of their passengers matches any of the given names.
	// Matches are case-insensitive, and include partial matches.
	PassengerNames []string `url:"passenger_name,omitempty"`
}

type ListOrdersSort string

type Location struct {
	ID              string    `json:"id"`
	Type            string    `json:"type"`
	Name            string    `json:"name"`
	TimeZone        string    `json:"time_zone,omitempty"`
	Longitude       *float64  `json:"longitude,omitempty"`
	Latitude        *float64  `json:"latitude,omitempty"`
	ICAOCode        string    `json:"icao_code,omitempty"`
	IATACountryCode *string   `json:"iata_country_code,omitempty"`
	IATACode        string    `json:"iata_code,omitempty"`
	IATACityCode    *string   `json:"iata_city_code,omitempty"`
	CityName        *string   `json:"city_name,omitempty"`
	City            *City     `json:"city,omitempty"`
	Airports        []Airport `json:"airports,omitempty"`
}

type LocationType string

type LoyaltyProgramme struct {
	Alliance       string `json:"alliance"`
	ID             string `json:"id"`
	Name           string `json:"name"`
	LogoURL        string `json:"logo_url"`
	OwnerAirlineID string `json:"owner_airline_id"`
}

type LoyaltyProgrammeAccount struct {
	AirlineIATACode string `json:"airline_iata_code"`
	AccountNumber   string `json:"account_number"`
}

type LoyaltyProgrammeClient interface {
	ListLoyaltyProgramme(ctx context.Context) *Iter[LoyaltyProgramme]
	GetLoyaltyProgramme(ctx context.Context, id string) (*LoyaltyProgramme, error)
}

type MealType string

type Metadata map[string]any

type Offer struct {
	ID                                      string                  `json:"id"`
	LiveMode                                bool                    `json:"live_mode"`
	CreatedAt                               time.Time               `json:"created_at"`
	UpdatedAt                               time.Time               `json:"updated_at"`
	ExpiresAt                               time.Time               `json:"expires_at"`
	TotalEmissionsKg                        interface{}             `json:"total_emissions_kg"`
	RawTotalCurrency                        string                  `json:"total_currency"`
	RawTotalAmount                          string                  `json:"total_amount"`
	RawTaxAmount                            string                  `json:"tax_amount"`
	RawTaxCurrency                          string                  `json:"tax_currency"`
	RawBaseAmount                           string                  `json:"base_amount"`
	RawBaseCurrency                         string                  `json:"base_currency"`
	Owner                                   Airline                 `json:"owner"`
	Slices                                  []Slice                 `json:"slices"`
	Passengers                              []OfferRequestPassenger `json:"passengers"`
	Partial                                 bool                    `json:"partial"`
	PassengerIdentityDocumentsRequired      bool                    `json:"passenger_identity_documents_required"`
	SupportedPassengerIdentityDocumentTypes []string                `json:"supported_passenger_identity_document_types"` // e.g. ["passport"]
	PaymentRequirements                     OfferPaymentRequirement `json:"payment_requirements"`
	AvailableServices                       []AvailableService      `json:"available_services"`
	Conditions                              Conditions              `json:"conditions"`
	PrivateFares                            []OfferPrivateFare      `json:"private_fares"`
	SupportedLoyaltyProgrammes              []string                `json:"supported_loyalty_programmes"` // Airline IATA codes (e.g. ["BA", "U2"])
}

type OfferClient interface {
	UpdateOfferPassenger(
		ctx context.Context, offerRequestID, passengerID string, input PassengerUpdateInput,
	) (*OfferRequestPassenger, error)
	ListOffers(ctx context.Context, reqId string, options ...ListOffersParams) *Iter[Offer]
	GetOffer(ctx context.Context, id string, params ...GetOfferParams) (*Offer, error)
}

type OfferPaymentRequirement struct {
	RequiresInstantPayment  bool      `json:"requires_instant_payment"`
	PriceGuaranteeExpiresAt *DateTime `json:"price_guarantee_expires_at"`
	PaymentRequiredBy       *DateTime `json:"payment_required_by"`
}

type OfferPrivateFare struct {
	CorporateCode     string          `json:"corporate_code,omitempty"`
	TrackingReference string          `json:"tracking_reference,omitempty"`
	TourCode          string          `json:"tour_code,omitempty"`
	Type              PrivateFareType `json:"type,omitempty"`
}

type OfferRequest struct {
	ID         string                  `json:"id"`
	ClientKey  string                  `json:"client_key"` // For use with https://duffel.com/docs/guides/ancillaries-component
	LiveMode   bool                    `json:"live_mode"`
	CreatedAt  time.Time               `json:"created_at"`
	Slices     []BaseSlice             `json:"slices"`
	Passengers []OfferRequestPassenger `json:"passengers"`
	CabinClass CabinClass              `json:"cabin_class"`
	Offers     []Offer                 `json:"offers"`
}

type OfferRequestClient interface {
	CreateOfferRequest(ctx context.Context, requestInput OfferRequestInput) (*OfferRequest, error)
	GetOfferRequest(ctx context.Context, id string) (*OfferRequest, error)
	CreatePartialOfferRequest(ctx context.Context, requestInput OfferRequestInput) (*OfferRequest, error)
	GetFullPartialOfferRequest(ctx context.Context, requestInput PartialOfferRequestInput) (*OfferRequest, error)
	GetPartialOfferRequests(ctx context.Context, requestInput PartialOfferRequestInput) (*OfferRequest, error)
	ListOfferRequests(ctx context.Context) *Iter[OfferRequest]
}

type OfferRequestInput struct {
	// The passengers who want to travel. If you specify an age for a passenger, the type may differ for the same passenger in different offers due to airline's different rules. e.g. one airline may treat a 14 year old as an adult, and another as a young adult. You may only specify an age or a type – not both.
	Passengers []OfferRequestPassenger `json:"passengers" url:"-"`
	// The slices that make up this offer request. One-way journeys can be expressed using one slice, whereas return trips will need two.
	Slices []OfferRequestSlice `json:"slices" url:"-"`
	// The cabin that the passengers want to travel in
	CabinClass CabinClass `json:"cabin_class,omitempty" url:"-"`
	// The maximum number of connections within any slice of the offer. For example 0 means a direct flight which will have a single segment within each slice and 1 means a maximum of two segments within each slice of the offer.
	MaxConnections *int `json:"max_connections,omitempty" url:"-"`
	// When set to true, the offer request resource returned will include all the offers returned by the airlines
	// The private fares codes of airline.  The key is the airline's IATA code that provided the private fare code.
	PrivateFares map[string][]PrivateFare `json:"private_fares,omitempty" url:"-"`

	ReturnOffers bool `json:"-" url:"return_offers"`
	// The maximum amount of time in milliseconds to wait for each airline to respond
	SupplierTimeout int `json:"-" url:"supplier_timeout,omitempty"`
}

type OfferRequestPassenger struct {
	ID                       string                    `json:"id,omitempty"`
	FamilyName               string                    `json:"family_name,omitempty"`
	GivenName                string                    `json:"given_name,omitempty"`
	Age                      int                       `json:"age,omitempty"`
	LoyaltyProgrammeAccounts []LoyaltyProgrammeAccount `json:"loyalty_programme_accounts,omitempty"`
	FareType                 FareType                  `json:"fare_type,omitempty"`
	Type                     PassengerType             `json:"type,omitempty"`
}

type OfferRequestSlice struct {
	DepartureDate Date   `json:"departure_date"`
	Destination   string `json:"destination"`
	Origin        string `json:"origin"`
}

type Offers []Offer

type Option func(*Options)

type Options struct {
	Version   string
	Host      string
	UserAgent string
	HttpDoer  *http.Client
	Debug     bool
	Timeout   time.Duration
}

type Order struct {
	ID                      string                      `json:"id"`
	LiveMode                bool                        `json:"live_mode"`
	Message                 *string                     `json:"message,omitempty"`
	Metadata                Metadata                    `json:"metadata"`
	RawBaseAmount           *string                     `json:"base_amount,omitempty"`
	RawBaseCurrency         *string                     `json:"base_currency,omitempty"`
	BookingReference        string                      `json:"booking_reference"`
	CancelledAt             *time.Time                  `json:"cancelled_at,omitempty"`
	CreatedAt               time.Time                   `json:"created_at"`
	Conditions              Conditions                  `json:"conditions,omitempty"`
	Documents               []IssuedDocument            `json:"documents,omitempty"`
	Owner                   Airline                     `json:"owner"`
	Passengers              []OrderPassenger            `json:"passengers,omitempty"`
	PaymentStatus           PaymentStatus               `json:"payment_status"`
	Services                []Service                   `json:"services,omitempty"`
	Slices                  []Slice                     `json:"slices,omitempty"`
	SyncedAt                time.Time                   `json:"synced_at"`
	RawTaxAmount            *string                     `json:"tax_amount,omitempty"`
	RawTaxCurrency          *string                     `json:"tax_currency,omitempty"`
	RawTotalAmount          string                      `json:"total_amount"`
	RawTotalCurrency        string                      `json:"total_currency"`
	AirlineInitiatedChanges []AirlineInitiatedChanges   `json:"airline_initiated_changes"`
	Cancellation            *OrderCancellation          `json:"cancellation,omitempty"`
	Changes                 []PassengerInitiatedChanges `json:"changes"`
	Content                 OrderContent                `json:"content"`
	OfferID                 string                      `json:"offer_id"`
	Type                    OrderType                   `json:"type"`
	IsPendingConfirmation   bool                        `json:"-"`
	IsAwaitingCreation      bool                        `json:"-"`
}

type OrderCancellation struct {
	ID                string          `json:"id"`
	OrderID           string          `json:"order_id"`
	RefundTo          PaymentMethod   `json:"refund_to"`
	RawRefundCurrency string          `json:"refund_currency"`
	RawRefundAmount   string          `json:"refund_amount"`
	ExpiresAt         string          `json:"expires_at"`
	CreatedAt         string          `json:"created_at"`
	ConfirmedAt       string          `json:"confirmed_at"`
	LiveMode          bool            `json:"live_mode"`
	AirlineCredits    []AirlineCredit `json:"airline_credits"`
}

type OrderCancellationClient interface {
	CreateOrderCancellation(ctx context.Context, orderID string) (*OrderCancellation, error)
	ConfirmOrderCancellation(ctx context.Context, orderCancellationID string) (*OrderCancellation, error)
	GetOrderCancellation(ctx context.Context, orderCancellationID string) (*OrderCancellation, error)
	ListOrderCancellations(ctx context.Context, params ...ListOrderCancellationParams) *Iter[OrderCancellation]
}

type OrderCancellationRequest struct {
	OrderID string `json:"order_id"`
}

type OrderChange struct {
	ID                      string         `json:"id"`
	OrderID                 string         `json:"order_id"`
	Slices                  SliceChangeset `json:"slices"`
	RefundTo                PaymentMethod  `json:"refund_to"`
	RawPenaltyTotalCurrency string         `json:"penalty_total_currency"`
	RawPenaltyTotalAmount   string         `json:"penalty_total_amount"`
	RawNewTotalCurrency     string         `json:"new_total_currency"`
	RawNewTotalAmount       string         `json:"new_total_amount"`
	RawChangeTotalCurrency  string         `json:"change_total_currency"`
	RawChangeTotalAmount    string         `json:"change_total_amount"`
	ExpiresAt               string         `json:"expires_at"`
	CreatedAt               DateTime       `json:"created_at"`
	UpdatedAt               string         `json:"updated_at"`
	LiveMode                bool           `json:"live_mode"`
	ConfirmedAt             DateTime       `json:"confirmed_at"`
}

type OrderChangeClient interface {
	CreateOrderChangeRequest(ctx context.Context, params OrderChangeRequestParams) (*OrderChangeRequest, error)
	GetOrderChangeRequest(ctx context.Context, id string) (*OrderChangeRequest, error)
	CreatePendingOrderChange(ctx context.Context, orderChangeRequestID string) (*OrderChange, error)
	ConfirmOrderChange(ctx context.Context, id string, payment PaymentCreateInput) (*OrderChange, error)
	GetOrderChange(ctx context.Context, id string) (*OrderChange, error)
	GetOrderChangeOffer(ctx context.Context, id string) (*OrderChangeOffer, error)
	ListOrderChangeOffers(ctx context.Context, params ...ListOrderChangeOffersParams) *Iter[OrderChangeOffer]
}

type OrderChangeOffer struct {
	ID string `json:"id"`
	// OrderChangeID is the ID for an order change if one has already been created from this order change offer
	OrderChangeID           string         `json:"order_change_id"`
	Slices                  SliceChangeset `json:"slices"`
	RefundTo                PaymentMethod  `json:"refund_to"`
	RawPenaltyTotalCurrency string         `json:"penalty_total_currency"`
	RawPenaltyTotalAmount   string         `json:"penalty_total_amount"`
	RawNewTotalCurrency     string         `json:"new_total_currency"`
	RawNewTotalAmount       string         `json:"new_total_amount"`
	RawChangeTotalCurrency  string         `json:"change_total_currency"`
	RawChangeTotalAmount    string         `json:"change_total_amount"`
	ExpiresAt               DateTime       `json:"expires_at"`
	CreatedAt               DateTime       `json:"created_at"`
	UpdatedAt               DateTime       `json:"updated_at"`
	LiveMode                bool           `json:"live_mode"`
	Conditions              Conditions     `json:"conditions"`
	PrivateFares            []PrivateFare  `json:"private_fares"`
}

type OrderChangeRequest struct {
	ID                string             `json:"id"`
	OrderID           string             `json:"order_id"`
	Slices            SliceChange        `json:"slices"`
	OrderChangeOffers []OrderChangeOffer `json:"order_change_offers"`
	CreatedAt         string             `json:"created_at"`
	UpdatedAt         string             `json:"updated_at"`
	LiveMode          bool               `json:"live_mode"`
}

type OrderChangeRequestParams struct {
	OrderID      string                   `json:"order_id"`
	PrivateFares map[string][]PrivateFare `json:"private_fares,omitempty"`
	Slices       SliceChange              `json:"slices,omitempty"`
}

type OrderClient interface {
	// GetOrder Get a single order by ID.
	GetOrder(ctx context.Context, id string) (*Order, error)

	// UpdateOrder Update a single order by ID.
	UpdateOrder(ctx context.Context, id string, params OrderUpdateParams) (*Order, error)

	// ListOrders List orders.
	ListOrders(ctx context.Context, params ...ListOrdersParams) *Iter[Order]

	// CreateOrder Create an order.
	CreateOrder(ctx context.Context, input CreateOrderInput) (*Order, error)

	// ListOrderServices List available services for an order.
	ListOrderServices(ctx context.Context, id string) ([]*AvailableService, error)

	// AddOrderService Add a service to an order.
	AddOrderService(ctx context.Context, id string, input AddOrderServiceInput) (*Order, error)

	// UpdateAirlineInitiatedChange Update an airline-initiated change.
	UpdateAirlineInitiatedChange(ctx context.Context, id string, input UpdateAirlineInitiatedChangeInput) (
		*Order, error,
	)

	// AcceptAirlineInitiatedChange Accept an airline-initiated change.
	AcceptAirlineInitiatedChange(ctx context.Context, id string) (*Order, error)

	// ListAirlineInitiatedChanges List airline-initiated changes.
	ListAirlineInitiatedChanges(
		ctx context.Context, params ...ListAirlineInitiatedChangesParams,
	) ([]*AirlineInitiatedChanges, error)
}

type OrderContent string

type OrderPassenger struct {
	// ID is id of the passenger, returned when the offer request was created
	ID string `json:"id"`
	// Title is passengers' title. Possible values: "mr", "ms", "mrs", or "miss"
	Title PassengerTitle `json:"title"`
	// FamilyName is the family name of the passenger.
	FamilyName string `json:"family_name"`
	// GivenName is the passenger's given name.
	GivenName string `json:"given_name"`
	// BornOn is the passengers DoB according to their travel documents.
	BornOn Date `json:"born_on"`
	// Email is the passengers email address.
	Email string `json:"email"`
	// Gender is the passengers gender.
	Gender Gender `json:"gender"`
	// The passenger's identity documents. You may only provide one identity document per passenger.
	IdentityDocuments []IdentityDocument `json:"identity_documents,omitempty"`
	// The `id` of the infant associated with this passenger
	InfantPassengerID string `json:"infant_passenger_id,omitempty"`
	// The Loyalty Programme Accounts for this passenger
	LoyaltyProgrammeAccounts []LoyaltyProgrammeAccount `json:"loyalty_programme_accounts,omitempty"`
	// (Required) The passenger's phone number in E.164 (international) format
	PhoneNumber string `json:"phone_number"`
	// Type is the type of passenger.
	// Possible values: "adult", "child", or "infant_without_seat"
	Type PassengerType `json:"type"`
}

type OrderPaymentClient interface {
	CreatePayment(ctx context.Context, req CreatePaymentRequest) (*Payment, error)
}

type OrderType string

type OrderUpdateParams struct {
	Metadata map[string]any
}

type PageFn[T any] func(meta *ListMeta) (*List[T], error)

type ParamEncoder[T any] interface {
	Encode(v url.Values) error
}

type PartialOfferRequestInput struct {
	PartialOfferRequestID string
	SelectedPartialOffers []string
}

type PassengerInitiatedChanges struct {
	ID                     string              `json:"id"`
	RawChangeTotalAmount   string              `json:"change_total_amount"`
	RawChangeTotalCurrency string              `json:"change_total_currency"`
	ConfirmedAt            time.Time           `json:"confirmed_at"`
	CreatedAt              time.Time           `json:"created_at"`
	ExpiresAt              time.Time           `json:"expires_at"`
	LiveMode               bool                `json:"live_mode"`
	RawNewTotalAmount      string              `json:"new_total_amount"`
	RawNewTotalCurrency    string              `json:"new_total_currency"`
	OrderID                string              `json:"order_id"`
	RawPenaltyAmount       string              `json:"penalty_total_amount"`
	RawPenaltyCurrency     string              `json:"penalty_total_currency"`
	RefundTo               RefundPaymentMethod `json:"refund_to"`
	Slices                 struct {
		Add    []Slice `json:"add"`
		Remove []Slice `json:"remove"`
	} `json:"slices"`
}

type PassengerTitle string

type PassengerType string

type PassengerUpdateInput struct {
	FamilyName               string                    `json:"family_name"`
	GivenName                string                    `json:"given_name"`
	LoyaltyProgrammeAccounts []LoyaltyProgrammeAccount `json:"loyalty_programme_accounts,omitempty"`
}

type Payload[T any] struct {
	Data T `json:"data"`
}

type Payment struct {
	Amount    string      `json:"amount"`
	CreatedAt DateTime    `json:"created_at"`
	Currency  string      `json:"currency"`
	ID        string      `json:"id"`
	LiveMode  bool        `json:"live_mode"`
	Type      PaymentType `json:"type"`
}

type PaymentCard struct {
	ID            string           `json:"id"`
	LiveMode      bool             `json:"live_mode"`
	Last4Digits   string           `json:"last_4_digits"`
	MultiUse      bool             `json:"multi_use"`
	Brand         PaymentCardBrand `json:"brand"`
	UnavailableAt DateTime         `json:"unavailable_at,omitempty"`
}

type PaymentCardBrand string

type PaymentCardClient interface {
	CreatePaymentCardRecord(
		ctx context.Context, payload *CreatePaymentCardRecordRequest,
	) (*PaymentCard, error)
	CreateTemporaryPaymentCardRecordFromSavedPaymentCardRecord(
		ctx context.Context, payload *CreateTemporaryPaymentCardRecordFromSavedPaymentCardRequest,
	) (*PaymentCard, error)
	DeleteSavedPaymentCardRecord(ctx context.Context, id string) error
}

type PaymentCreateInput struct {
	// The amount of the payment. This should be the same as the total_amount of the offer specified in selected_offers, plus the total_amount of all the services specified in services.
	Amount string `json:"amount"`
	// The currency of the amount, as an ISO 4217 currency code. This should be the same as the total_currency of the offer specified in selected_offers.
	Currency string `json:"currency"`

	// Possible values: "arc_bsp_cash" or "balance"
	Type PaymentMethod `json:"type"`

	// Unique identifier of a lodged card by Duffel.
	CardID string `json:"card_id,omitempty"`
}

type PaymentMethod string

type PaymentStatus struct {
	AwaitingPayment         bool       `json:"awaiting_payment"`
	PaymentRequiredBy       *time.Time `json:"payment_required_by,omitempty"`
	PriceGuaranteeExpiresAt *time.Time `json:"price_guarantee_expires_at,omitempty"`
	PaidAt                  *time.Time `json:"paid_at,omitempty"`
}

type PaymentType string

type Place struct {
	ID              string     `json:"id"`
	Airports        []*Airport `json:"airports"`
	City            *City      `json:"city"`
	CityName        string     `json:"city_name"`
	CountryName     string     `json:"country_name"`
	IATACityCode    string     `json:"iata_city_code"`
	IATACode        string     `json:"iata_code"`
	IATACountryCode string     `json:"iata_country_code"`
	ICAOCode        string     `json:"icao_code"`
	Latitude        float64    `json:"latitude"`
	Longitude       float64    `json:"longitude"`
	Name            string     `json:"name"`
	TimeZone        string     `json:"time_zone"`
	Type            PlaceType  `json:"type"`
}

type PlaceType string

type PlacesClient interface {
	PlaceSuggestions(ctx context.Context, query string) ([]*Place, error)
	Cities(ctx context.Context) *Iter[City]
	City(ctx context.Context, id string) (*City, error)
}

type PrivateFare struct {
	CorporateCode     string          `json:"corporate_code,omitempty"`
	TrackingReference string          `json:"tracking_reference,omitempty"`
	TourCode          string          `json:"tour_code,omitempty"`
	Type              PrivateFareType `json:"type,omitempty"`
}

type PrivateFareType string

type RateLimit struct {
	Limit     int
	Remaining int
	ResetAt   time.Time
	Period    time.Duration
}

type RefundPaymentMethod string

type RequestBuilder[Req any, Resp any] struct {
	// contains filtered or unexported fields
}

type RequestMiddleware func(r *http.Request) error

type RequestOption func(req *http.Request) error

type ResponseMiddleware func(r *http.Response) error

type ResponsePayload[T any] struct {
	Meta *ListMeta `json:"meta"`
	Data T         `json:"data"`
}

type Row struct {
	// A list of sections. Each row is divided into sections by one or more aisles.
	Sections []SeatSection `json:"sections"`
}

type Seat struct {
	Name        string   `json:"name,omitempty"`
	Disclosures []string `json:"disclosures,omitempty"`
	Designator  string   `json:"designator,omitempty"`
}

type SeatSection struct {
	// The elements that make up this section.
	Elements []SectionElement `json:"elements"`
}

type Seatmap struct {
	Cabins    []Cabin `json:"cabins"`
	ID        string  `json:"id"`
	SegmentID string  `json:"segment_id"`
	SliceID   string  `json:"slice_id"`
}

type SeatmapClient interface {
	// GetSeatmap returns an iterator for the seatmaps of a given Offer.
	GetSeatmap(ctx context.Context, offerID string) ([]*Seatmap, error)
	SeatmapForOffer(ctx context.Context, offer Offer) ([]*Seatmap, error)
}

type SectionElement struct {
	// The element type, e.g. seat, exit_row, stairs, etc.
	Type ElementType `json:"type"`

	// Seats are considered a special kind of service.
	// There will be at most one service per seat per passenger.
	// A seat can only be booked for one passenger. If a seat has no available services (which will be represented as an empty list : []) then it's unavailable.
	AvailableServices []SectionService `json:"available_services"`

	// The designator used to uniquely identify the seat, usually made up of a row number and a column letter
	Designator string `json:"designator"`

	// Each disclosure is text, in English, provided by the airline that describes the terms and conditions of this seat. We recommend showing this in your user interface to make sure that customers understand any restrictions and limitations.
	Disclosures []string `json:"disclosures"`

	// A name which describes the type of seat, which you can display in your user interface to help customers to understand its features.
	// Example: "Exit row seat"
	Name string `json:"name"`
}

type SectionService struct {
	ID               string `json:"id"`
	PassengerID      string `json:"passenger_id"`
	RawTotalAmount   string `json:"total_amount"`
	RawTotalCurrency string `json:"total_currency"`
}

type SegmentPassenger struct {
	ID                      string     `json:"passenger_id"`
	FareBasisCode           string     `json:"fare_basis_code"`
	CabinClassMarketingName string     `json:"cabin_class_marketing_name"`
	CabinClass              CabinClass `json:"cabin_class"`
	Baggages                []Baggage  `json:"baggages"`
	Seat                    Seat       `json:"seat"`
}

type Service struct {
	// Duffel's unique identifier for the booked service
	ID string `json:"id"`

	// Metadata The metadata varies by the type of service.
	// It includes further data about the service. For example, for
	// baggages, it may have data about size and weight restrictions.
	Metadata Metadata `json:"metadata"`

	// List of passenger ids the service applies to.
	// The service applies to all the passengers in this list.
	PassengerIDs []string `json:"passenger_ids"`

	// Quantity The quantity of the service that was booked
	Quantity int `json:"quantity"`

	// List of segment ids the service applies to. The service applies to all the segments in this list.
	SegmentIDs []string `json:"segment_ids"`

	// RawTotalAmount The total price of the service for all passengers and segments it applies to,
	// accounting for quantity and including taxes
	RawTotalAmount   string `json:"total_amount,omitempty"`
	RawTotalCurrency string `json:"total_currency,omitempty"`

	// Type Possible values: "baggage" or "seat"
	Type string `json:"type"`
}

type ServiceCreateInput struct {
	// ID The id of the service from the offer's available_services that you want to book
	ID string `json:"id"`

	// Quantity The quantity of the service to book. This will always be 1 for seat services.
	Quantity int `json:"quantity"`
}

type ServiceType string

type Slice struct {
	*BaseSlice
	ID string `json:"id"`

	// Whether this slice can be changed. This can only be true for paid orders.
	Changeable bool `json:"changeable,omitempty"`

	// The conditions associated with this slice, describing the kinds of modifications you can make and any penalties that will apply to those modifications.
	Conditions    SliceConditions `json:"conditions,omitempty"`
	Duration      Duration        `json:"duration,omitempty"`
	Segments      []Flight        `json:"segments,omitempty"`
	FareBrandName string          `json:"fare_brand_name,omitempty"`
}

type SliceAdd struct {
	DepartureDate Date       `json:"departure_date"`
	Destination   string     `json:"destination"`
	Origin        string     `json:"origin"`
	CabinClass    CabinClass `json:"cabin_class"`
}

type SliceChange struct {
	Add    []SliceAdd    `json:"add,omitempty"`
	Remove []SliceRemove `json:"remove,omitempty"`
}

type SliceChangeset struct {
	Add    []Slice `json:"add"`
	Remove []Slice `json:"remove"`
}

type SliceConditions struct {
	ChangeBeforeDeparture *ChangeCondition `json:"change_before_departure,omitempty"`
}

type SliceRemove struct {
	SliceID string `json:"slice_id"`
}

type Stop struct {
	Airport     Location `json:"airport"`
	ArrivingAt  string   `json:"arriving_at"`
	DepartingAt string   `json:"departing_at"`
	Duration    Duration `json:"duration"`
	ID          string   `json:"id"`
}

type TimeFilter struct {
	Before *time.Time `url:"before,omitempty"`
	After  *time.Time `url:"after,omitempty"`
}

type UpdateAirlineInitiatedChangeInput struct {
	ActionTaken ActionTakenType `json:"action_taken"`
}

type Wing struct {
	// The index of the first row which is overwing, starting from the front of the aircraft.
	FirstRowIndex int `json:"first_row_index"`
	// The index of the last row which is overwing, starting from the front of the aircraft.
	LastRowIndex int `json:"last_row_index"`
}