@voyant-travel/flights-react 0.119.2

package/dist/hooks/use-flight-orders.d.ts

@@ -0,0 +1,147 @@
+import { type FlightOrdersListFilters } from "../query-keys.js";
+export interface UseFlightOrdersOptions {
+    enabled?: boolean;
+}
+/**
+ * GET `/v1/admin/flights/orders` — paginated list of flight orders the
+ * adapter has visibility on. Capability-gated: adapters that don't declare
+ * `flight/list-orders` will 501.
+ */
+export declare function useFlightOrders(filters?: FlightOrdersListFilters, options?: UseFlightOrdersOptions): import("@tanstack/react-query").UseQueryResult<{
+    orders: {
+        orderId: string;
+        status: "pending" | "failed" | "cancelled" | "confirmed" | "ticketed";
+        offer: {
+            offerId: string;
+            source: string;
+            itineraries: {
+                segments: {
+                    segmentId: string;
+                    carrierCode: string;
+                    flightNumber: string;
+                    departure: {
+                        iataCode: string;
+                        at: string;
+                        terminal?: string | undefined;
+                    };
+                    arrival: {
+                        iataCode: string;
+                        at: string;
+                        terminal?: string | undefined;
+                    };
+                    cabin: "economy" | "premium_economy" | "business" | "first";
+                    operatingCarrierCode?: string | undefined;
+                    operatingFlightNumber?: string | undefined;
+                    duration?: string | undefined;
+                    aircraft?: string | undefined;
+                    fareClass?: string | undefined;
+                    fareBasis?: string | undefined;
+                    status?: string | undefined;
+                    providerData?: Record<string, unknown> | undefined;
+                }[];
+                duration?: string | undefined;
+            }[];
+            fareBreakdowns: {
+                passengerType: "adult" | "child" | "infant" | "senior" | "youth";
+                passengerCount: number;
+                baseFare: {
+                    amount: string;
+                    currency: string;
+                };
+                taxes: {
+                    amount: string;
+                    currency: string;
+                };
+                total: {
+                    amount: string;
+                    currency: string;
+                };
+                fees?: {
+                    amount: string;
+                    currency: string;
+                } | undefined;
+                fareFamily?: string | undefined;
+            }[];
+            totalPrice: {
+                amount: string;
+                currency: string;
+            };
+            validatingCarrier?: string | undefined;
+            expiresAt?: string | undefined;
+            lastTicketingDate?: string | undefined;
+            instantTicketing?: boolean | undefined;
+            fareBundles?: {
+                id: string;
+                label: string;
+                tier: "basic" | "standard" | "plus" | "premium";
+                priceDelta: {
+                    amount: string;
+                    currency: string;
+                };
+                inclusions: {
+                    cabinBag?: {
+                        included: boolean;
+                        weightKg?: number | undefined;
+                    } | undefined;
+                    checkedBag?: {
+                        included: boolean;
+                        pieces?: number | undefined;
+                        weightKg?: number | undefined;
+                    } | undefined;
+                    seatSelection?: "none" | "standard" | "free" | undefined;
+                    priorityBoarding?: boolean | undefined;
+                    loungeAccess?: boolean | undefined;
+                    refundable?: boolean | undefined;
+                    changeable?: boolean | undefined;
+                    notes?: string[] | undefined;
+                };
+                recommended?: boolean | undefined;
+                providerData?: Record<string, unknown> | undefined;
+            }[] | undefined;
+            providerData?: Record<string, unknown> | undefined;
+        };
+        passengers: {
+            passengerId: string;
+            type: "adult" | "child" | "infant" | "senior" | "youth";
+            firstName: string;
+            lastName: string;
+            dateOfBirth: string;
+            middleName?: string | undefined;
+            gender?: "M" | "F" | "X" | undefined;
+            email?: string | undefined;
+            phone?: string | undefined;
+            documents?: {
+                type: "passport" | "national_id" | "visa";
+                number: string;
+                countryOfIssue: string;
+                countryOfNationality?: string | undefined;
+                expiryDate?: string | undefined;
+            }[] | undefined;
+        }[];
+        totalPrice: {
+            amount: string;
+            currency: string;
+        };
+        createdAt: string;
+        pnr?: string | undefined;
+        contact?: {
+            email?: string | undefined;
+            phone?: string | undefined;
+        } | undefined;
+        tickets?: {
+            ticketNumber: string;
+            passengerId: string;
+            segmentIds: string[];
+            status?: string | undefined;
+        }[] | undefined;
+        paymentDeadline?: string | undefined;
+        updatedAt?: string | undefined;
+        providerData?: Record<string, unknown> | undefined;
+    }[];
+    pagination: {
+        total: number;
+        hasMore: boolean;
+        cursor?: string | undefined;
+    };
+}, Error>;
+//# sourceMappingURL=use-flight-orders.d.ts.map

package/dist/hooks/use-flight-orders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-flight-orders.d.ts","sourceRoot":"","sources":["../../src/hooks/use-flight-orders.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,uBAAuB,EAAoB,MAAM,kBAAkB,CAAA;AAGjF,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,OAAO,GAAE,uBAA4B,EACrC,OAAO,GAAE,sBAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAqBrC"}

package/dist/hooks/use-flight-orders.js

@@ -0,0 +1,31 @@
+"use client";
+import { useQuery } from "@tanstack/react-query";
+import { fetchWithValidation, withQueryParams } from "../client.js";
+import { useVoyantFlightsContext } from "../provider.js";
+import { flightsQueryKeys } from "../query-keys.js";
+import { flightOrdersListResponseSchema } from "../schemas.js";
+/**
+ * GET `/v1/admin/flights/orders` — paginated list of flight orders the
+ * adapter has visibility on. Capability-gated: adapters that don't declare
+ * `flight/list-orders` will 501.
+ */
+export function useFlightOrders(filters = {}, options = {}) {
+    const client = useVoyantFlightsContext();
+    const { enabled = true } = options;
+    const params = {};
+    if (filters.cursor)
+        params.cursor = filters.cursor;
+    if (filters.limit !== undefined)
+        params.limit = filters.limit;
+    if (filters.search)
+        params.q = filters.search;
+    if (filters.status?.length)
+        params.status = filters.status;
+    if (filters.paymentStatus?.length)
+        params.paymentStatus = filters.paymentStatus;
+    return useQuery({
+        queryKey: flightsQueryKeys.orderList(filters),
+        queryFn: () => fetchWithValidation(withQueryParams("/v1/admin/flights/orders", params), flightOrdersListResponseSchema, client),
+        enabled,
+    });
+}

package/dist/hooks/use-flight-search.d.ts

@@ -0,0 +1,110 @@
+import type { FlightSearchRequest } from "@voyant-travel/flights/contract/types";
+export interface UseFlightSearchOptions {
+    /** Disable the query — useful while the form is incomplete. */
+    enabled?: boolean;
+    /** TanStack Query stale time, milliseconds. Default 30s. */
+    staleTime?: number;
+}
+/**
+ * POST `/v1/admin/flights/search`. Re-runs whenever the request changes.
+ * Disabled by default until the form is complete (no slices, etc.) — pass
+ * `enabled: true` once the request is ready to fire.
+ */
+export declare function useFlightSearch(request: FlightSearchRequest, options?: UseFlightSearchOptions): import("@tanstack/react-query").UseQueryResult<{
+    offers: {
+        offerId: string;
+        source: string;
+        itineraries: {
+            segments: {
+                segmentId: string;
+                carrierCode: string;
+                flightNumber: string;
+                departure: {
+                    iataCode: string;
+                    at: string;
+                    terminal?: string | undefined;
+                };
+                arrival: {
+                    iataCode: string;
+                    at: string;
+                    terminal?: string | undefined;
+                };
+                cabin: "economy" | "premium_economy" | "business" | "first";
+                operatingCarrierCode?: string | undefined;
+                operatingFlightNumber?: string | undefined;
+                duration?: string | undefined;
+                aircraft?: string | undefined;
+                fareClass?: string | undefined;
+                fareBasis?: string | undefined;
+                status?: string | undefined;
+                providerData?: Record<string, unknown> | undefined;
+            }[];
+            duration?: string | undefined;
+        }[];
+        fareBreakdowns: {
+            passengerType: "adult" | "child" | "infant" | "senior" | "youth";
+            passengerCount: number;
+            baseFare: {
+                amount: string;
+                currency: string;
+            };
+            taxes: {
+                amount: string;
+                currency: string;
+            };
+            total: {
+                amount: string;
+                currency: string;
+            };
+            fees?: {
+                amount: string;
+                currency: string;
+            } | undefined;
+            fareFamily?: string | undefined;
+        }[];
+        totalPrice: {
+            amount: string;
+            currency: string;
+        };
+        validatingCarrier?: string | undefined;
+        expiresAt?: string | undefined;
+        lastTicketingDate?: string | undefined;
+        instantTicketing?: boolean | undefined;
+        fareBundles?: {
+            id: string;
+            label: string;
+            tier: "basic" | "standard" | "plus" | "premium";
+            priceDelta: {
+                amount: string;
+                currency: string;
+            };
+            inclusions: {
+                cabinBag?: {
+                    included: boolean;
+                    weightKg?: number | undefined;
+                } | undefined;
+                checkedBag?: {
+                    included: boolean;
+                    pieces?: number | undefined;
+                    weightKg?: number | undefined;
+                } | undefined;
+                seatSelection?: "none" | "standard" | "free" | undefined;
+                priorityBoarding?: boolean | undefined;
+                loungeAccess?: boolean | undefined;
+                refundable?: boolean | undefined;
+                changeable?: boolean | undefined;
+                notes?: string[] | undefined;
+            };
+            recommended?: boolean | undefined;
+            providerData?: Record<string, unknown> | undefined;
+        }[] | undefined;
+        providerData?: Record<string, unknown> | undefined;
+    }[];
+    pagination?: {
+        total: number;
+        hasMore: boolean;
+        cursor?: string | undefined;
+    } | undefined;
+    providerData?: Record<string, unknown> | undefined;
+}, Error>;
+//# sourceMappingURL=use-flight-search.d.ts.map

package/dist/hooks/use-flight-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-flight-search.d.ts","sourceRoot":"","sources":["../../src/hooks/use-flight-search.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAA;AAKhF,MAAM,WAAW,sBAAsB;IACrC,+DAA+D;IAC/D,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,mBAAmB,EAC5B,OAAO,GAAE,sBAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UASrC"}

package/dist/hooks/use-flight-search.js

@@ -0,0 +1,18 @@
+"use client";
+import { useQuery } from "@tanstack/react-query";
+import { useVoyantFlightsContext } from "../provider.js";
+import { getFlightSearchQueryOptions } from "../query-options.js";
+/**
+ * POST `/v1/admin/flights/search`. Re-runs whenever the request changes.
+ * Disabled by default until the form is complete (no slices, etc.) — pass
+ * `enabled: true` once the request is ready to fire.
+ */
+export function useFlightSearch(request, options = {}) {
+    const client = useVoyantFlightsContext();
+    const { enabled = false, staleTime = 30_000 } = options;
+    return useQuery({
+        ...getFlightSearchQueryOptions(client, request),
+        enabled: enabled && request.slices.length > 0 && request.passengers.adults > 0,
+        staleTime,
+    });
+}

package/dist/hooks/use-flight-seat-map.d.ts

@@ -0,0 +1,49 @@
+import type { FlightOffer } from "@voyant-travel/flights/contract/types";
+export interface UseFlightSeatMapOptions {
+    /** Disable the query — useful before the offer is re-priced or the user enters the seats step. */
+    enabled?: boolean;
+    /** TanStack Query stale time, milliseconds. Default 5 minutes. */
+    staleTime?: number;
+}
+/**
+ * POST `/v1/admin/flights/seatmap` — fetches 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).
+ *
+ * Default `enabled = false` so callers gate fetching on the user actually
+ * entering the seat selection step. When the connector doesn't declare
+ * `flight/seatmap`, the API returns 501 — propagated as a query error.
+ */
+export declare function useFlightSeatMap(input: {
+    offerId: string;
+    segmentId: string;
+    offer?: FlightOffer;
+} | null, options?: UseFlightSeatMapOptions): import("@tanstack/react-query").UseQueryResult<{
+    seatMap: {
+        segmentId: string;
+        cabin: "economy" | "premium_economy" | "business" | "first";
+        columnLayout: (string | null)[];
+        rows: {
+            row: number;
+            seats: {
+                seatNumber: string;
+                row: number;
+                column: string;
+                status: "available" | "blocked" | "unavailable" | "selected";
+                category: "standard" | "premium" | "preferred" | "extra_legroom" | "exit_row" | "bulkhead";
+                price?: {
+                    amount: string;
+                    currency: string;
+                } | undefined;
+                notes?: string | undefined;
+                window?: boolean | undefined;
+                aisle?: boolean | undefined;
+                providerData?: Record<string, unknown> | undefined;
+            }[];
+        }[];
+        aircraft?: string | undefined;
+        providerData?: Record<string, unknown> | undefined;
+    };
+    validUntil?: string | undefined;
+}, Error>;
+//# sourceMappingURL=use-flight-seat-map.d.ts.map

package/dist/hooks/use-flight-seat-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-flight-seat-map.d.ts","sourceRoot":"","sources":["../../src/hooks/use-flight-seat-map.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAA;AAKxE,MAAM,WAAW,uBAAuB;IACtC,kGAAkG;IAClG,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,WAAW,CAAA;CAAE,GAAG,IAAI,EACzE,OAAO,GAAE,uBAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;UAUtC"}

package/dist/hooks/use-flight-seat-map.js

@@ -0,0 +1,23 @@
+"use client";
+import { useQuery } from "@tanstack/react-query";
+import { useVoyantFlightsContext } from "../provider.js";
+import { getFlightSeatMapQueryOptions } from "../query-options.js";
+/**
+ * POST `/v1/admin/flights/seatmap` — fetches 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).
+ *
+ * Default `enabled = false` so callers gate fetching on the user actually
+ * entering the seat selection step. When the connector doesn't declare
+ * `flight/seatmap`, the API returns 501 — propagated as a query error.
+ */
+export function useFlightSeatMap(input, options = {}) {
+    const client = useVoyantFlightsContext();
+    const { enabled = false, staleTime = 5 * 60_000 } = options;
+    const safeInput = input ?? { offerId: "", segmentId: "" };
+    return useQuery({
+        ...getFlightSeatMapQueryOptions(client, safeInput),
+        enabled: enabled && !!input?.offerId && !!input?.segmentId,
+        staleTime,
+    });
+}

package/dist/hooks/use-saved-payment-methods.d.ts

@@ -0,0 +1,23 @@
+export interface UseSavedPaymentMethodsOptions {
+    enabled?: boolean;
+    staleTime?: number;
+}
+/**
+ * GET `/v1/relationships/people/:personId/payment-methods` — list a person's saved
+ * payment methods. Backed by the CRM `person_payment_methods` table.
+ */
+export declare function useSavedPaymentMethods(personId: string | null | undefined, options?: UseSavedPaymentMethodsOptions): import("@tanstack/react-query").UseQueryResult<{
+    data: {
+        id: string;
+        brand: "visa" | "mastercard" | "amex" | "revolut" | "bank_transfer";
+        last4: string | null;
+        processorToken: string;
+        isDefault: boolean;
+        createdAt: string;
+        personId?: string | undefined;
+        holderName?: string | null | undefined;
+        expMonth?: number | null | undefined;
+        expYear?: number | null | undefined;
+    }[];
+}, Error>;
+//# sourceMappingURL=use-saved-payment-methods.d.ts.map

package/dist/hooks/use-saved-payment-methods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-saved-payment-methods.d.ts","sourceRoot":"","sources":["../../src/hooks/use-saved-payment-methods.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,6BAA6B;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACnC,OAAO,GAAE,6BAAkC;;;;;;;;;;;;;UAe5C"}

package/dist/hooks/use-saved-payment-methods.js

@@ -0,0 +1,20 @@
+"use client";
+import { useQuery } from "@tanstack/react-query";
+import { fetchWithValidation } from "../client.js";
+import { useVoyantFlightsContext } from "../provider.js";
+import { flightsQueryKeys } from "../query-keys.js";
+import { savedPaymentMethodListResponseSchema, } from "../schemas.js";
+/**
+ * GET `/v1/relationships/people/:personId/payment-methods` — list a person's saved
+ * payment methods. Backed by the CRM `person_payment_methods` table.
+ */
+export function useSavedPaymentMethods(personId, options = {}) {
+    const client = useVoyantFlightsContext();
+    const { enabled = true, staleTime = 30_000 } = options;
+    return useQuery({
+        queryKey: flightsQueryKeys.savedPaymentMethods(personId ?? ""),
+        queryFn: () => fetchWithValidation(`/v1/relationships/people/${encodeURIComponent(personId ?? "")}/payment-methods`, savedPaymentMethodListResponseSchema, client),
+        enabled: enabled && !!personId,
+        staleTime,
+    });
+}