@voyantjs/flights-contracts 0.96.0

package/dist/contract/types.d.ts

@@ -0,0 +1,504 @@
+/**
+ * Flight contract types — shapes mirror voyant-cloud's `connect-flight-contract`
+ * so adapters are portable across Voyant Cloud and Voyant Catalog deployments.
+ *
+ * These are the load-bearing data structures: `FlightSegment`, `Itinerary`,
+ * `FlightOffer`, `FlightOrder`, `FlightSearchRequest`, `FlightBookRequest`,
+ * the `paymentIntent` discriminated union, and the capability id namespace.
+ *
+ * **Drift policy:** when voyant-cloud's `connect-flight-contract` evolves,
+ * mirror the additive changes here. Breaking changes flow through a
+ * coordinated release across both packages.
+ *
+ * See `docs/architecture/catalog-flights-architecture.md` §3.
+ */
+/** Cabin class. Standard IATA-aligned vocabulary. */
+export type CabinClass = "economy" | "premium_economy" | "business" | "first";
+/** Passenger type. Affects fare lookup and ticketing rules. */
+export type PassengerType = "adult" | "child" | "infant" | "senior" | "youth";
+/** Currency + amount. */
+export interface Money {
+    amount: string;
+    currency: string;
+}
+/**
+ * One segment of an itinerary — from departure airport to arrival airport
+ * on a specific carrier + flight number.
+ */
+export interface FlightSegment {
+    segmentId: string;
+    carrierCode: string;
+    flightNumber: string;
+    /** Operating carrier when different from the marketing carrier. */
+    operatingCarrierCode?: string;
+    operatingFlightNumber?: string;
+    departure: {
+        iataCode: string;
+        terminal?: string;
+        at: string;
+    };
+    arrival: {
+        iataCode: string;
+        terminal?: string;
+        at: string;
+    };
+    duration?: string;
+    aircraft?: string;
+    cabin: CabinClass;
+    fareClass?: string;
+    fareBasis?: string;
+    status?: string;
+    /** Provider-specific data — opaque round-trip. */
+    providerData?: Record<string, unknown>;
+}
+/**
+ * One itinerary (journey leg) — a sequence of segments. Round-trip and
+ * multi-city offers have multiple itineraries.
+ */
+export interface Itinerary {
+    segments: FlightSegment[];
+    duration?: string;
+}
+/** Per-passenger fare breakdown line. */
+export interface FareBreakdown {
+    passengerType: PassengerType;
+    passengerCount: number;
+    baseFare: Money;
+    taxes: Money;
+    fees?: Money;
+    total: Money;
+    fareFamily?: string;
+}
+/**
+ * A priced flight proposition. Returned by `searchFlights`; passed back to
+ * `priceOffer` and `bookFlight`. Always vertical-specific — never collapse
+ * into a generic `Offer` (per architecture §1.1 and `UBIQUITOUS_LANGUAGE.md`).
+ */
+export interface FlightOffer {
+    offerId: string;
+    /** Source identifier — typically the connection id or adapter slug. */
+    source: string;
+    itineraries: Itinerary[];
+    fareBreakdowns: FareBreakdown[];
+    totalPrice: Money;
+    validatingCarrier?: string;
+    /** ISO 8601 — when the offer expires (provider may refuse to book after). */
+    expiresAt?: string;
+    /** ISO 8601 — last ticketing date. */
+    lastTicketingDate?: string;
+    instantTicketing?: boolean;
+    /**
+     * Branded fare bundles available for this offer (Basic / Standard / Plus
+     * style). Optional — adapters that don't surface branded fares omit this
+     * field; the offer's `totalPrice` is then the only fare. Bundles are
+     * defined per-offer; for round-trip flows where each leg is its own
+     * offer, callers fetch bundles per leg and submit picks via
+     * `AncillarySelection.fareBundle`.
+     */
+    fareBundles?: FareBundle[];
+    /** Provider-specific data — opaque round-trip. */
+    providerData?: Record<string, unknown>;
+}
+/**
+ * A branded fare upsell tier. Tiers add inclusions (bag, seat, refund
+ * flexibility) on top of the offer's base fare for a per-pax delta.
+ */
+export interface FareBundle {
+    id: string;
+    /** Display label, e.g. "Wizz Standard", "Plus", "Lufthansa Light". */
+    label: string;
+    /** Tier hint — UI uses it to badge / order tiles. */
+    tier: "basic" | "standard" | "plus" | "premium";
+    /** Per-adult price delta on top of `FlightOffer.totalPrice`. */
+    priceDelta: Money;
+    /** Highlights the recommended tier in the UI (typically "standard"). */
+    recommended?: boolean;
+    /** Structured inclusions — UI renders as a checklist on the tile. */
+    inclusions: FareBundleInclusions;
+    /** Provider-specific data — opaque round-trip. */
+    providerData?: Record<string, unknown>;
+}
+export interface FareBundleInclusions {
+    /** Cabin / personal item allowance. */
+    cabinBag?: {
+        included: boolean;
+        weightKg?: number;
+    };
+    /** Checked baggage allowance. */
+    checkedBag?: {
+        included: boolean;
+        pieces?: number;
+        weightKg?: number;
+    };
+    /** Seat selection rights. `free` = pick any seat; `standard` = standard only. */
+    seatSelection?: "none" | "standard" | "free";
+    /** Priority boarding. */
+    priorityBoarding?: boolean;
+    /** Lounge access. */
+    loungeAccess?: boolean;
+    /** Refundable status — typically false for basic, partial for standard, true for plus. */
+    refundable?: boolean;
+    /** Date / time changes allowed without fee. */
+    changeable?: boolean;
+    /** Free-text additional perks the carrier wants to surface. */
+    notes?: string[];
+}
+/**
+ * One slice of a search request. Slice count determines trip type:
+ *   - 1 slice  → one-way
+ *   - 2 slices → round-trip
+ *   - 3+       → multi-city / open-jaw
+ */
+export interface FlightSlice {
+    origin: string;
+    destination: string;
+    departureDate: string;
+    departureTimeWindow?: {
+        earliest?: string;
+        latest?: string;
+    };
+}
+export interface PassengerCounts {
+    adults: number;
+    children?: number;
+    infants?: number;
+}
+/**
+ * Pagination cursor for results. Adapters that don't support pagination
+ * may ignore this entirely and return the full result set on every call.
+ *
+ * `cursor` is opaque to the caller — it's whatever the previous response
+ * returned in `pagination.cursor`. The demo adapter uses 1-indexed page
+ * numbers; real connectors typically return GDS-issued continuation tokens.
+ */
+export interface FlightSearchPagination {
+    /** Max offers per page. Adapters may cap or ignore. */
+    limit?: number;
+    /** Continuation token from the prior response, or omitted for first page. */
+    cursor?: string;
+}
+/**
+ * Pagination metadata returned by the adapter alongside the offer page.
+ * `total` is the count BEFORE pagination but AFTER any server-side filters
+ * declared on the request — so the UI can render "Showing 1-20 of 47".
+ */
+export interface FlightSearchPaginationMeta {
+    total: number;
+    /** Cursor to pass for the next page, omitted on the last page. */
+    cursor?: string;
+    /** Convenience flag — equivalent to `cursor != null`. */
+    hasMore: boolean;
+}
+export interface FlightSearchRequest {
+    slices: FlightSlice[];
+    passengers: PassengerCounts;
+    cabin?: CabinClass;
+    searchOptions?: {
+        directOnly?: boolean;
+        maxStops?: number;
+        minConnectionMinutes?: number;
+        includeCarriers?: string[];
+        excludeCarriers?: string[];
+        /**
+         * Cap the offer total price (in offer currency). Adapters that don't
+         * declare currency-aware filtering should treat this as a same-currency
+         * cap and skip offers priced above it.
+         */
+        maxPrice?: number;
+    };
+    /**
+     * Optional pagination cursor. Adapters that don't support pagination
+     * may ignore this and return the full result set.
+     */
+    pagination?: FlightSearchPagination;
+}
+/**
+ * Intent-driven booking — caller declares what they want, system honors
+ * or rejects per the adapter's declared capabilities. Default if omitted:
+ * `{ type: "hold" }`.
+ */
+export type PaymentIntent = {
+    type: "hold";
+} | {
+    type: "card";
+    token: string;
+    cardholderName?: string;
+    billingAddress?: BillingAddress;
+} | {
+    type: "ticket_on_credit";
+    iataCode?: string;
+};
+export interface BillingAddress {
+    line1: string;
+    line2?: string;
+    city: string;
+    region?: string;
+    postalCode?: string;
+    countryCode: string;
+}
+export interface FlightPassenger {
+    passengerId: string;
+    type: PassengerType;
+    firstName: string;
+    middleName?: string;
+    lastName: string;
+    dateOfBirth: string;
+    gender?: "M" | "F" | "X";
+    email?: string;
+    phone?: string;
+    documents?: TravelDocument[];
+}
+export interface TravelDocument {
+    type: "passport" | "national_id" | "visa";
+    number: string;
+    countryOfIssue: string;
+    countryOfNationality?: string;
+    expiryDate?: string;
+}
+export interface FlightBookRequest {
+    offerId: string;
+    /** Provider-specific re-priced offer payload, when the adapter requires it. */
+    offer?: FlightOffer;
+    passengers: FlightPassenger[];
+    contact?: {
+        email?: string;
+        phone?: string;
+    };
+    paymentIntent?: PaymentIntent;
+    /**
+     * Optional ancillary picks (bags / assistance / extras) collected at
+     * checkout. Adapters that don't declare `flight/ancillaries` must accept
+     * this field but ignore it; supporting adapters echo the picks back on
+     * the resulting `FlightOrder.providerData` and reflect prices in the
+     * order total.
+     */
+    ancillaries?: AncillarySelection;
+}
+export type FlightOrderStatus = "pending" | "confirmed" | "ticketed" | "cancelled" | "failed";
+export interface FlightTicket {
+    ticketNumber: string;
+    passengerId: string;
+    segmentIds: string[];
+    status?: string;
+}
+export interface FlightOrder {
+    orderId: string;
+    /** PNR / record locator. */
+    pnr?: string;
+    status: FlightOrderStatus;
+    offer: FlightOffer;
+    passengers: FlightPassenger[];
+    contact?: {
+        email?: string;
+        phone?: string;
+    };
+    tickets?: FlightTicket[];
+    totalPrice: Money;
+    /** ISO 8601 — deadline before the hold expires (held orders only). */
+    paymentDeadline?: string;
+    createdAt: string;
+    updatedAt?: string;
+    /** Provider-specific data — opaque round-trip. */
+    providerData?: Record<string, unknown>;
+}
+/**
+ * Bag option offered for a single itinerary. Per-pax pricing — the UI
+ * multiplies by quantity + selected pax count.
+ */
+export interface AncillaryBaggageOption {
+    id: string;
+    /** Display label, e.g. "20 kg checked bag". */
+    label: string;
+    /** Bag category. `personal_item` is the under-seat bag; `cabin` is overhead. */
+    category: "checked" | "cabin" | "personal_item" | "sports" | "oversized";
+    weightKg?: number;
+    dimensions?: {
+        lengthCm?: number;
+        widthCm?: number;
+        heightCm?: number;
+    };
+    /** Per-pax per-leg price. */
+    price: Money;
+    /** Hint that the UI should highlight this tier (typical: 20kg). */
+    recommended?: boolean;
+    /** Provider-specific data — opaque round-trip. */
+    providerData?: Record<string, unknown>;
+}
+/** Special-assistance option. Most are free; a few carriers charge. */
+export interface AncillaryAssistanceOption {
+    id: string;
+    label: string;
+    category: "wheelchair" | "visual" | "hearing" | "cognitive" | "medical" | "other";
+    /** Free when omitted. */
+    price?: Money;
+    /** Free-text guidance for the operator (e.g. "Bring own equipment"). */
+    notes?: string;
+}
+/** Catch-all extras: priority boarding, pet in cabin, lounge access, etc. */
+export interface AncillaryExtraOption {
+    id: string;
+    label: string;
+    /** Provider-defined tag — UI may group by this. */
+    category: string;
+    price: Money;
+    /** Per-pax (default) vs per-booking pricing. */
+    pricingScope?: "per_passenger" | "per_booking";
+}
+/**
+ * Catalog of ancillaries available for one offer. The catalog is offer-scoped
+ * because availability and pricing depend on the booked itinerary (carrier,
+ * cabin, route, fare class). For round-trip flows where the journey is
+ * composed of two single-leg offers, the UI fetches one catalog per leg.
+ */
+export interface AncillaryCatalog {
+    baggage: AncillaryBaggageOption[];
+    assistance: AncillaryAssistanceOption[];
+    extras: AncillaryExtraOption[];
+}
+export interface AncillaryRequest {
+    offerId: string;
+    /** Some providers require the offer payload echoed back. */
+    offer?: FlightOffer;
+}
+export interface AncillaryResponse {
+    catalog: AncillaryCatalog;
+    /** ISO 8601 — when this catalog quote stops being valid for booking. */
+    validUntil?: string;
+}
+/**
+ * Ancillary selection submitted with `bookFlight`. Picks are indexed by
+ * passenger id and (for per-leg picks) by slice index — slice 0 = outbound,
+ * slice 1 = return (matching the order in `FlightOffer.itineraries`).
+ *
+ * The shape stays additive: providers that introduce per-segment seat picks
+ * later get a sibling field on this interface, not a breaking change.
+ */
+export interface AncillarySelection {
+    /** Per-pax per-slice baggage picks. */
+    baggage?: Array<{
+        passengerId: string;
+        sliceIndex: number;
+        optionId: string;
+        /** Defaults to 1 — same option may be picked multiple times per pax. */
+        quantity?: number;
+    }>;
+    /** Per-pax assistance picks. Trip-wide (not per-slice) by convention. */
+    assistance?: Array<{
+        passengerId: string;
+        optionId: string;
+    }>;
+    /** Per-pax per-slice extras (priority boarding, sports equipment, etc.). */
+    extras?: Array<{
+        passengerId: string;
+        sliceIndex: number;
+        optionId: string;
+        quantity?: number;
+    }>;
+    /**
+     * Per-pax per-segment seat picks. Seats are assigned at the segment level
+     * (not the slice level) because a multi-stop itinerary requires distinct
+     * picks per leg of the journey. Omit any pax/segment combination to defer
+     * the assignment to airline auto-allocation.
+     */
+    seats?: Array<{
+        passengerId: string;
+        segmentId: string;
+        seatNumber: string;
+    }>;
+    /**
+     * Per-pax per-slice branded fare bundle picks (e.g. Adult 1 on Standard
+     * outbound + Plus return; Adult 2 on Basic both legs). Omit any
+     * pax/slice combination to keep that pax on the offer's base "Basic"
+     * fare for that leg. The shell defaults to applying one pick to all pax
+     * on a leg ("Same fare for all passengers" toggle), but the contract
+     * stays honest about the per-pax shape — many full-service carriers
+     * (LH, BA, AF) and B2B agency bookings actually exercise per-pax mixes.
+     */
+    fareBundle?: Array<{
+        passengerId: string;
+        sliceIndex: number;
+        bundleId: string;
+    }>;
+}
+/**
+ * One seat on a seat map. Seats are addressed by an airline-style
+ * row+column code (e.g. "12A") — the canonical identifier for booking. The
+ * `category` drives how the UI styles + prices the seat.
+ */
+export interface Seat {
+    /** Combined row+column, e.g. "12A". Stable across the seat map call. */
+    seatNumber: string;
+    /** Row number, 1-indexed (matches airline numbering). */
+    row: number;
+    /** Column letter, e.g. "A", "B", "F". */
+    column: string;
+    status: "available" | "blocked" | "unavailable" | "selected";
+    category: "standard" | "preferred" | "extra_legroom" | "exit_row" | "premium" | "bulkhead";
+    /** Per-pax seat fee. Omitted = included in fare. */
+    price?: Money;
+    /**
+     * Provider hint about restrictions: e.g. "exit_row_restrictions",
+     * "no_recline". Free-text, opaque to the UI; surface as a tooltip badge.
+     */
+    notes?: string;
+    /** True for window seats. */
+    window?: boolean;
+    /** True for aisle seats. */
+    aisle?: boolean;
+    /** Provider-specific data — opaque round-trip. */
+    providerData?: Record<string, unknown>;
+}
+export interface SeatRow {
+    /** 1-indexed row number. */
+    row: number;
+    /** Seats in cabin-order (left-to-right). Sparse: gaps render as aisles. */
+    seats: Seat[];
+}
+export interface SeatMap {
+    segmentId: string;
+    /** Aircraft IATA code if known — UI may display the model name. */
+    aircraft?: string;
+    /** Cabin class this map applies to. */
+    cabin: CabinClass;
+    /**
+     * Column layout — letters in cabin order, with `null` for aisle gaps.
+     * Example narrow-body 3-3: `["A","B","C",null,"D","E","F"]`.
+     * Example wide-body 3-3-3: `["A","B","C",null,"D","E","F",null,"G","H","J"]`.
+     */
+    columnLayout: Array<string | null>;
+    rows: SeatRow[];
+    /** Provider-specific data — opaque round-trip. */
+    providerData?: Record<string, unknown>;
+}
+export interface SeatMapRequest {
+    offerId: string;
+    segmentId: string;
+    /** Some providers require the offer payload echoed back. */
+    offer?: FlightOffer;
+}
+export interface SeatMapResponse {
+    seatMap: SeatMap;
+    /** ISO 8601 — when this seat map quote stops being valid for booking. */
+    validUntil?: string;
+}
+export type { CheckInRequest, CheckInResponse, CheckInStatus, FlightBoardingPass, FlightModifyReason, FlightModifyRequest, FlightModifyResponse, FlightRefundReason, FlightRefundRequest, FlightRefundResponse, FlightVoidResponse, SeatAssignment, SeatSelectionRequest, SeatSelectionResponse, SsrCode, SsrRequest, SsrResponse, } from "./post-book-types.js";
+/**
+ * Capability ids declared per connection. Adapters that don't declare a
+ * capability stub the corresponding method with `CAPABILITY_NOT_SUPPORTED`.
+ */
+export declare const FLIGHT_CAPABILITIES: {
+    readonly HOLDS: "flight/holds";
+    readonly SEATMAP: "flight/seatmap";
+    readonly SEAT_SELECTION: "flight/seat-selection";
+    readonly ANCILLARIES: "flight/ancillaries";
+    readonly CHECKIN: "flight/checkin";
+    readonly EXCHANGE: "flight/exchange";
+    readonly REFUND: "flight/refund";
+    readonly VOID: "flight/void";
+    readonly SSR: "flight/ssr";
+    readonly BRANDED_FARES: "flight/branded-fares";
+    /** `listOrders(ctx, query)` is queryable — the adapter persists orders. */
+    readonly LIST_ORDERS: "flight/list-orders";
+};
+export type FlightCapability = (typeof FLIGHT_CAPABILITIES)[keyof typeof FLIGHT_CAPABILITIES];
+//# sourceMappingURL=types.d.ts.map

package/dist/contract/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/contract/types.ts"],"names":[],"mappings":"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"}

package/dist/contract/types.js

@@ -0,0 +1,35 @@
+/**
+ * Flight contract types — shapes mirror voyant-cloud's `connect-flight-contract`
+ * so adapters are portable across Voyant Cloud and Voyant Catalog deployments.
+ *
+ * These are the load-bearing data structures: `FlightSegment`, `Itinerary`,
+ * `FlightOffer`, `FlightOrder`, `FlightSearchRequest`, `FlightBookRequest`,
+ * the `paymentIntent` discriminated union, and the capability id namespace.
+ *
+ * **Drift policy:** when voyant-cloud's `connect-flight-contract` evolves,
+ * mirror the additive changes here. Breaking changes flow through a
+ * coordinated release across both packages.
+ *
+ * See `docs/architecture/catalog-flights-architecture.md` §3.
+ */
+// ─────────────────────────────────────────────────────────────────────────────
+// Capability ids
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Capability ids declared per connection. Adapters that don't declare a
+ * capability stub the corresponding method with `CAPABILITY_NOT_SUPPORTED`.
+ */
+export const FLIGHT_CAPABILITIES = {
+    HOLDS: "flight/holds",
+    SEATMAP: "flight/seatmap",
+    SEAT_SELECTION: "flight/seat-selection",
+    ANCILLARIES: "flight/ancillaries",
+    CHECKIN: "flight/checkin",
+    EXCHANGE: "flight/exchange",
+    REFUND: "flight/refund",
+    VOID: "flight/void",
+    SSR: "flight/ssr",
+    BRANDED_FARES: "flight/branded-fares",
+    /** `listOrders(ctx, query)` is queryable — the adapter persists orders. */
+    LIST_ORDERS: "flight/list-orders",
+};

package/dist/contracts.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contracts.test.d.ts.map

package/dist/contracts.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.test.d.ts","sourceRoot":"","sources":["../src/contracts.test.ts"],"names":[],"mappings":""}

package/dist/contracts.test.js

@@ -0,0 +1,18 @@
+import { describe, expect, it } from "vitest";
+import { flightSearchRequestSchema, moneySchema } from "./index.js";
+describe("@voyantjs/flights-contracts barrel", () => {
+    it("parses a minimal valid flight search request", () => {
+        const value = {
+            slices: [{ origin: "LHR", destination: "JFK", departureDate: "2026-10-15" }],
+            passengers: { adults: 1 },
+            cabin: "economy",
+        };
+        expect(flightSearchRequestSchema.parse(value)).toEqual(value);
+    });
+    it("rejects an invalid flight search request", () => {
+        expect(flightSearchRequestSchema.safeParse({ slices: [], passengers: { adults: -1 } }).success).toBe(false);
+    });
+    it("rejects money with a non-decimal-string amount", () => {
+        expect(moneySchema.safeParse({ amount: 600, currency: "USD" }).success).toBe(false);
+    });
+});

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./contract/adapter.js";
+export * from "./contract/post-book-types.js";
+export * from "./contract/schemas.js";
+export * from "./contract/types.js";
+export * from "./reference/contract.js";
+export * from "./reference/static-bundle.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAA;AACrC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,uBAAuB,CAAA;AACrC,cAAc,qBAAqB,CAAA;AACnC,cAAc,yBAAyB,CAAA;AACvC,cAAc,8BAA8B,CAAA"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from "./contract/adapter.js";
+export * from "./contract/post-book-types.js";
+export * from "./contract/schemas.js";
+export * from "./contract/types.js";
+export * from "./reference/contract.js";
+export * from "./reference/static-bundle.js";