@voyantjs/flights-contracts 0.96.0

package/README.md

@@ -0,0 +1,45 @@
+# @voyantjs/flights-contracts
+
+Pure flight `SourceAdapter` contracts, schemas, and reference-data shapes for
+adapter implementers and external consumers that need to integrate flight
+providers without the flights runtime.
+
+Use this package for the `FlightConnectorAdapter` contract, the flight contract
+types (offers, orders, segments, search, booking, post-book operations), the
+matching Zod schemas, and the `ReferenceDataProvider` reference-data shapes
+(plus the static-bundle provider). Use `@voyantjs/flights` when you also need
+the orchestration fan-out, snapshot capture, local-Postgres reference provider,
+or other runtime integration with the catalog plane.
+
+## Install
+
+```bash
+pnpm add @voyantjs/flights-contracts zod
+```
+
+## Exports
+
+- `./contract/types` — flight contract types (offers, orders, segments,
+  search, booking, ancillaries, seat maps, capability ids).
+- `./contract/adapter` — the `FlightConnectorAdapter` contract + adapter
+  context/capabilities and the `CAPABILITY_NOT_SUPPORTED` helpers.
+- `./contract/schemas` — Zod schemas mirroring the contract types.
+- `./contract/post-book-types` — post-book operation types (seat selection,
+  check-in, modify, refund, void, SSR).
+- `./reference/contract` — the `ReferenceDataProvider` contract + reference
+  data shapes (airline, airport, aircraft).
+- `./reference/static-bundle` — the in-memory static-bundle reference provider.
+
+## Usage
+
+```ts
+import {
+  flightSearchRequestSchema,
+  type FlightConnectorAdapter,
+} from "@voyantjs/flights-contracts"
+```
+
+`@voyantjs/flights` re-exports this contract surface, so existing
+`@voyantjs/flights/contract/*` and `@voyantjs/flights/reference/*` import paths
+remain unchanged for applications that already depend on the full runtime
+package.

package/dist/contract/adapter.d.ts

@@ -0,0 +1,210 @@
+/**
+ * `FlightConnectorAdapter` contract — the seam through which any flight
+ * provider integrates with Voyant.
+ *
+ * Five core methods every adapter must implement; capability-gated
+ * methods exist as optional members on the interface and stub with
+ * `CAPABILITY_NOT_SUPPORTED` if the adapter doesn't declare them.
+ *
+ * Implementations come from anywhere — Voyant Connect, a wholesaler's own
+ * engineering team, a cruise line direct API, an operator-built GDS
+ * connector, a third-party integrator. No implementer is privileged.
+ *
+ * See `docs/architecture/catalog-flights-architecture.md` §3.
+ */
+import type { AncillaryRequest, AncillaryResponse, CheckInRequest, CheckInResponse, FlightBookRequest, FlightCapability, FlightModifyRequest, FlightModifyResponse, FlightOffer, FlightOrder, FlightOrderStatus, FlightRefundRequest, FlightRefundResponse, FlightSearchPaginationMeta, FlightSearchRequest, FlightVoidResponse, SeatMapRequest, SeatMapResponse, SeatSelectionRequest, SeatSelectionResponse, SsrRequest, SsrResponse } from "./types.js";
+export interface AdapterLogger {
+    debug(message: string, meta?: Record<string, unknown>): void;
+    info(message: string, meta?: Record<string, unknown>): void;
+    warn(message: string, meta?: Record<string, unknown>): void;
+    error(message: string, meta?: Record<string, unknown>): void;
+}
+export type FlightAdapterEnvironment = "sandbox" | "production";
+/**
+ * Context passed to every adapter call. Identifies the connection and
+ * carries credentials, optional point-of-sale, tracing identifiers,
+ * cancellation, idempotency, logging, and environment selection signals.
+ *
+ * `deps` is an escape hatch for adapter-specific runtime dependencies that
+ * shouldn't bleed into the contract — e.g. a Postgres handle for a demo
+ * adapter that self-persists, or a feature-flag client. Real connectors
+ * (Sabre, Amadeus, Duffel) ignore it.
+ */
+export interface FlightAdapterContext {
+    connectionId: string;
+    credentials?: Record<string, string>;
+    /** Operator's IATA office id / pseudo-city / point-of-sale, when applicable. */
+    pointOfSale?: string;
+    /** Upstream trace id, usually propagated from the caller. */
+    correlationId?: string;
+    /** Per-call request id for adapter-local tracing. */
+    requestId?: string;
+    /** Idempotency key for replay-safe writes: book, modify, refund, void. */
+    idempotencyKey?: string;
+    /** Adapter-scoped logger with provider/connection/request metadata bound in. */
+    logger?: AdapterLogger;
+    /** Cancellation signal propagated from the orchestration layer. */
+    signal?: AbortSignal;
+    /** Selects the supplier environment when the adapter supports both. */
+    environment?: FlightAdapterEnvironment;
+    deps?: Record<string, unknown>;
+}
+export interface FlightSearchResponse {
+    offers: FlightOffer[];
+    /**
+     * Pagination metadata, present when the adapter honors
+     * `request.pagination`. Omitted by adapters that always return the
+     * full result set in one call.
+     */
+    pagination?: FlightSearchPaginationMeta;
+    /** Provider-specific data, opaque to the consumer. */
+    providerData?: Record<string, unknown>;
+}
+export interface FlightPriceRequest {
+    offerId: string;
+    /** Some providers require the offer payload echoed back to re-price. */
+    offer?: FlightOffer;
+}
+export interface FlightPriceResponse {
+    offer: FlightOffer;
+    /** Whether the offer's price/availability is still valid for booking. */
+    valid: boolean;
+    /** When `valid: false`, why the offer was invalidated. */
+    invalidReason?: string;
+}
+export interface FlightBookResponse {
+    order: FlightOrder;
+}
+export interface FlightGetOrderResponse {
+    order: FlightOrder;
+}
+export interface FlightCancelResponse {
+    order: FlightOrder;
+    refundedAmount?: {
+        amount: string;
+        currency: string;
+    };
+}
+export type FlightCancelReason = "customer_request" | "schedule_change" | "operational" | "fraud";
+export interface FlightOrdersListQuery {
+    /** Pagination cursor — opaque, returned by the previous response. */
+    cursor?: string;
+    limit?: number;
+    /** Restrict to orders in any of these statuses. */
+    status?: FlightOrderStatus[];
+    /** Free-text match against PNR, passenger name, or contact email. */
+    search?: string;
+}
+export interface FlightOrdersListResponse {
+    orders: FlightOrder[];
+    pagination: {
+        total: number;
+        hasMore: boolean;
+        cursor?: string;
+    };
+}
+/**
+ * Capability declaration returned by the adapter at registration time.
+ * The orchestration layer reads `capabilities` to route requests and to
+ * fail fast on unsupported operations.
+ */
+export interface FlightAdapterCapabilities {
+    /** Provider identifier — e.g. `"hisky"`, `"amadeus"`, `"duffel"`, `"sabre"`, `"travelport-ndc"`. */
+    provider: string;
+    /** Capabilities declared by this connection. */
+    declared: FlightCapability[];
+    /**
+     * Maximum slices per search request supported. Many providers cap at
+     * 1 (single-carrier point-to-point), 2 (round-trip), or 4-6 (multi-city).
+     */
+    maxSlicesPerSearch?: number;
+    /**
+     * Default per-source timeout hint for the orchestration layer.
+     */
+    defaultTimeoutMs?: number;
+}
+/**
+ * The flight connector contract. Five core methods + optional capability-
+ * gated methods. Adapters that don't support a capability either omit the
+ * method or have it throw `CAPABILITY_NOT_SUPPORTED`.
+ */
+export interface FlightConnectorAdapter {
+    readonly capabilities: FlightAdapterCapabilities;
+    /** Search flights matching the request's slices + passengers + cabin. */
+    searchFlights(ctx: FlightAdapterContext, request: FlightSearchRequest): Promise<FlightSearchResponse>;
+    /**
+     * Re-price an offer immediately before booking.
+     *
+     * This is also the canonical re-quote path for offers approaching
+     * `FlightOffer.expiresAt` or `lastTicketingDate`. Callers should invoke it
+     * before booking whenever the offer is older than the provider's freshness
+     * window or the UI is resuming a saved/held offer.
+     */
+    priceOffer(ctx: FlightAdapterContext, request: FlightPriceRequest): Promise<FlightPriceResponse>;
+    /**
+     * Book the flight. Behavior depends on `paymentIntent`:
+     *   - `hold` → returns order with status `confirmed`; caller must call
+     *     `ticketOrder` later (capability-gated).
+     *   - `card` / `ticket_on_credit` → returns order with status `ticketed`.
+     */
+    bookFlight(ctx: FlightAdapterContext, request: FlightBookRequest): Promise<FlightBookResponse>;
+    /** Get an order by id (for status checks, post-book operations). */
+    getOrder(ctx: FlightAdapterContext, orderId: string): Promise<FlightGetOrderResponse>;
+    /** Cancel an order. */
+    cancelOrder(ctx: FlightAdapterContext, orderId: string, reason?: FlightCancelReason): Promise<FlightCancelResponse>;
+    /**
+     * `flight/list-orders` — return a paginated list of orders the adapter
+     * has visibility on. Real GDS connectors typically only support listing
+     * by PNR/locator (not the full agency book of business), but persistent
+     * adapters and self-hosted demos can list everything they've stored.
+     */
+    listOrders?(ctx: FlightAdapterContext, query: FlightOrdersListQuery): Promise<FlightOrdersListResponse>;
+    /** `flight/holds` — promote a held order to ticketed. */
+    ticketOrder?(ctx: FlightAdapterContext, orderId: string): Promise<FlightGetOrderResponse>;
+    /**
+     * `flight/ancillaries` — list bag / assistance / extra options for an offer.
+     * Catalog is per-offer because availability depends on the booked itinerary;
+     * for round-trip flows where each leg is its own offer, callers fetch one
+     * catalog per leg and merge the picks at book time via
+     * `FlightBookRequest.ancillaries`.
+     */
+    getAncillaries?(ctx: FlightAdapterContext, request: AncillaryRequest): Promise<AncillaryResponse>;
+    /**
+     * `flight/seatmap` — fetch the seat map for one segment of an offer.
+     * Maps are per-segment because layouts differ by aircraft and cabin
+     * (a multi-stop itinerary may use different equipment per leg). Picks
+     * are submitted at book time via `FlightBookRequest.ancillaries.seats`.
+     */
+    getSeatMap?(ctx: FlightAdapterContext, request: SeatMapRequest): Promise<SeatMapResponse>;
+    /** `flight/seat-selection` — change/add seat selections on an existing order. */
+    selectSeats?(ctx: FlightAdapterContext, request: SeatSelectionRequest): Promise<SeatSelectionResponse>;
+    /** `flight/checkin` — initiate or complete online check-in for passengers. */
+    checkIn?(ctx: FlightAdapterContext, request: CheckInRequest): Promise<CheckInResponse>;
+    /** `flight/exchange` — change an existing order's itinerary, fare, pax, or extras. */
+    modifyOrder?(ctx: FlightAdapterContext, request: FlightModifyRequest): Promise<FlightModifyResponse>;
+    /** `flight/refund` — refund a ticketed order after the ticketing/void window. */
+    refundOrder?(ctx: FlightAdapterContext, request: FlightRefundRequest): Promise<FlightRefundResponse>;
+    /** `flight/void` — void a ticketed order inside the supplier void window. */
+    voidOrder?(ctx: FlightAdapterContext, orderId: string): Promise<FlightVoidResponse>;
+    /** `flight/ssr` — add a special service request such as wheelchair, meal, or UMNR. */
+    addSpecialServiceRequest?(ctx: FlightAdapterContext, request: SsrRequest): Promise<SsrResponse>;
+}
+/**
+ * Standard error code for capability-gated methods that aren't supported
+ * by the adapter. Mirrors voyant-cloud's convention so behavior is
+ * portable across runtimes.
+ */
+export declare const CAPABILITY_NOT_SUPPORTED: "CAPABILITY_NOT_SUPPORTED";
+export declare class FlightCapabilityNotSupportedError extends Error {
+    readonly provider: string;
+    readonly capability: FlightCapability;
+    readonly operation: string;
+    readonly code: "CAPABILITY_NOT_SUPPORTED";
+    constructor(provider: string, capability: FlightCapability, operation: string);
+}
+/**
+ * Helper for adapters that want to short-circuit at the start of a method
+ * when a required capability isn't declared.
+ */
+export declare function requireCapability(capabilities: FlightAdapterCapabilities, capability: FlightCapability, operation: string): void;
+//# sourceMappingURL=adapter.d.ts.map

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

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

package/dist/contract/adapter.js

@@ -0,0 +1,43 @@
+/**
+ * `FlightConnectorAdapter` contract — the seam through which any flight
+ * provider integrates with Voyant.
+ *
+ * Five core methods every adapter must implement; capability-gated
+ * methods exist as optional members on the interface and stub with
+ * `CAPABILITY_NOT_SUPPORTED` if the adapter doesn't declare them.
+ *
+ * Implementations come from anywhere — Voyant Connect, a wholesaler's own
+ * engineering team, a cruise line direct API, an operator-built GDS
+ * connector, a third-party integrator. No implementer is privileged.
+ *
+ * See `docs/architecture/catalog-flights-architecture.md` §3.
+ */
+/**
+ * Standard error code for capability-gated methods that aren't supported
+ * by the adapter. Mirrors voyant-cloud's convention so behavior is
+ * portable across runtimes.
+ */
+export const CAPABILITY_NOT_SUPPORTED = "CAPABILITY_NOT_SUPPORTED";
+export class FlightCapabilityNotSupportedError extends Error {
+    provider;
+    capability;
+    operation;
+    code = CAPABILITY_NOT_SUPPORTED;
+    constructor(provider, capability, operation) {
+        super(`Flight provider "${provider}" does not declare capability "${capability}" (operation: ${operation}). ` +
+            `Either configure the request to skip this operation or register a connector that supports it.`);
+        this.provider = provider;
+        this.capability = capability;
+        this.operation = operation;
+        this.name = "FlightCapabilityNotSupportedError";
+    }
+}
+/**
+ * Helper for adapters that want to short-circuit at the start of a method
+ * when a required capability isn't declared.
+ */
+export function requireCapability(capabilities, capability, operation) {
+    if (!capabilities.declared.includes(capability)) {
+        throw new FlightCapabilityNotSupportedError(capabilities.provider, capability, operation);
+    }
+}

package/dist/contract/post-book-types.d.ts

@@ -0,0 +1,90 @@
+import type { AncillarySelection, FlightOffer, FlightOrder, FlightPassenger, Money } from "./types.js";
+export interface SeatAssignment {
+    passengerId: string;
+    segmentId: string;
+    seatNumber: string;
+    /** Per-pax seat fee. Omitted = included in fare or already paid. */
+    price?: Money;
+    /** Provider-specific data — opaque round-trip. */
+    providerData?: Record<string, unknown>;
+}
+export interface SeatSelectionRequest {
+    orderId: string;
+    selections: SeatAssignment[];
+}
+export interface SeatSelectionResponse {
+    order: FlightOrder;
+    selections: SeatAssignment[];
+    /** Total additional charge collected for the seat change, if any. */
+    additionalAmount?: Money;
+}
+export type CheckInStatus = "initiated" | "checked_in" | "failed";
+export interface CheckInRequest {
+    orderId: string;
+    passengerIds?: string[];
+    segmentIds?: string[];
+}
+export interface FlightBoardingPass {
+    passengerId: string;
+    segmentId: string;
+    boardingPassId?: string;
+    seatNumber?: string;
+    sequenceNumber?: string;
+    zone?: string;
+    /** Provider-specific data — opaque round-trip. */
+    providerData?: Record<string, unknown>;
+}
+export interface CheckInResponse {
+    order: FlightOrder;
+    status: CheckInStatus;
+    boardingPasses?: FlightBoardingPass[];
+}
+export type FlightModifyReason = "customer_request" | "schedule_change" | "name_correction" | "disruption" | "operational";
+export interface FlightModifyRequest {
+    orderId: string;
+    /** Re-priced replacement offer when the modification changes itinerary/fare. */
+    offer?: FlightOffer;
+    /** Replacement passenger details for corrections allowed by the provider. */
+    passengers?: FlightPassenger[];
+    /** Add or replace ancillary picks as part of the modification. */
+    ancillaries?: AncillarySelection;
+    reason?: FlightModifyReason;
+}
+export interface FlightModifyResponse {
+    order: FlightOrder;
+    /** Positive means collect more from the traveler; negative means credit due. */
+    priceDifference?: Money;
+    penalties?: Money[];
+}
+export type FlightRefundReason = "customer_request" | "schedule_change" | "disruption" | "duplicate_booking" | "medical" | "other";
+export interface FlightRefundRequest {
+    orderId: string;
+    reason?: FlightRefundReason;
+    /** Omit for a full refund; provide for supplier-supported partial refunds. */
+    amount?: Money;
+}
+export interface FlightRefundResponse {
+    order: FlightOrder;
+    refundId?: string;
+    refundedAmount: Money;
+    penalties?: Money[];
+}
+export interface FlightVoidResponse {
+    order: FlightOrder;
+    voidId?: string;
+    voidedAt: string;
+}
+export type SsrCode = "WCHR" | "WCHS" | "WCHC" | "BLND" | "DEAF" | "MAAS" | "UMNR" | "INFT" | "PETC" | "VGML" | "KSML" | "MOML" | "OTHER";
+export interface SsrRequest {
+    orderId: string;
+    code: SsrCode;
+    passengerIds?: string[];
+    segmentIds?: string[];
+    text?: string;
+}
+export interface SsrResponse {
+    order: FlightOrder;
+    ssrId?: string;
+    status: "requested" | "confirmed" | "rejected";
+}
+//# sourceMappingURL=post-book-types.d.ts.map

package/dist/contract/post-book-types.d.ts.map

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

package/dist/contract/post-book-types.js

@@ -0,0 +1 @@
+export {};