@voyantjs/flights-react 0.21.0

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

@@ -0,0 +1,106 @@
+import type { FlightOffer } from "@voyantjs/flights/contract/types";
+export interface PriceOfferInput {
+    offerId: string;
+    /** Some adapters require the offer payload echoed back. */
+    offer?: FlightOffer;
+}
+/**
+ * POST `/v1/admin/flights/price` — re-prices an offer immediately before
+ * booking. Returns `{ offer, valid, invalidReason? }`. The mutation shape
+ * fits the typical "user clicks Continue → re-price → if invalid, show
+ * banner; if valid, proceed to booking" flow.
+ */
+export declare function useFlightOfferPrice(): import("@tanstack/react-query").UseMutationResult<{
+    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?: "standard" | "none" | "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;
+    };
+    valid: boolean;
+    invalidReason?: string | undefined;
+}, Error, PriceOfferInput, unknown>;
+//# sourceMappingURL=use-flight-offer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-flight-offer.d.ts","sourceRoot":"","sources":["../../src/hooks/use-flight-offer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAA;AAMnE,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,2DAA2D;IAC3D,KAAK,CAAC,EAAE,WAAW,CAAA;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oCASlC"}

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

@@ -0,0 +1,20 @@
+"use client";
+import { useMutation } from "@tanstack/react-query";
+import { fetchWithValidation } from "../client.js";
+import { useVoyantFlightsContext } from "../provider.js";
+import { flightPriceResponseSchema } from "../schemas.js";
+/**
+ * POST `/v1/admin/flights/price` — re-prices an offer immediately before
+ * booking. Returns `{ offer, valid, invalidReason? }`. The mutation shape
+ * fits the typical "user clicks Continue → re-price → if invalid, show
+ * banner; if valid, proceed to booking" flow.
+ */
+export function useFlightOfferPrice() {
+    const client = useVoyantFlightsContext();
+    return useMutation({
+        mutationFn: (input) => fetchWithValidation("/v1/admin/flights/price", flightPriceResponseSchema, client, {
+            method: "POST",
+            body: JSON.stringify(input),
+        }),
+    });
+}

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

@@ -0,0 +1,286 @@
+export interface UseFlightOrderOptions {
+    enabled?: boolean;
+}
+/**
+ * GET `/v1/admin/flights/orders/:orderId` — fetch a previously-booked order.
+ * 404 surfaces as a query error; the consumer renders an "order not found"
+ * fallback in that case.
+ */
+export declare function useFlightOrder(orderId: string | null, options?: UseFlightOrderOptions): import("@tanstack/react-query").UseQueryResult<{
+    order: {
+        orderId: string;
+        status: "pending" | "confirmed" | "ticketed" | "cancelled" | "failed";
+        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?: "standard" | "none" | "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;
+    };
+}, Error>;
+export interface CancelOrderInput {
+    orderId: string;
+    reason?: "customer_request" | "schedule_change" | "operational" | "fraud";
+}
+/**
+ * POST `/v1/admin/flights/orders/:orderId/cancel`. Updates the cached
+ * order on success so the confirmation page reflects the new "cancelled"
+ * status without a refetch.
+ */
+export declare function useFlightOrderCancel(): import("@tanstack/react-query").UseMutationResult<{
+    order: {
+        orderId: string;
+        status: "pending" | "confirmed" | "ticketed" | "cancelled" | "failed";
+        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?: "standard" | "none" | "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;
+    };
+    refundedAmount?: {
+        amount: string;
+        currency: string;
+    } | undefined;
+}, Error, CancelOrderInput, unknown>;
+//# sourceMappingURL=use-flight-order.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-flight-order.d.ts","sourceRoot":"","sources":["../../src/hooks/use-flight-order.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,GAAE,qBAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAazF;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,kBAAkB,GAAG,iBAAiB,GAAG,aAAa,GAAG,OAAO,CAAA;CAC1E;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qCAkBnC"}

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

@@ -0,0 +1,38 @@
+"use client";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { fetchWithValidation } from "../client.js";
+import { useVoyantFlightsContext } from "../provider.js";
+import { flightsQueryKeys } from "../query-keys.js";
+import { flightCancelResponseSchema, flightGetOrderResponseSchema, } from "../schemas.js";
+/**
+ * GET `/v1/admin/flights/orders/:orderId` — fetch a previously-booked order.
+ * 404 surfaces as a query error; the consumer renders an "order not found"
+ * fallback in that case.
+ */
+export function useFlightOrder(orderId, options = {}) {
+    const client = useVoyantFlightsContext();
+    const { enabled = true } = options;
+    return useQuery({
+        queryKey: flightsQueryKeys.orderDetail(orderId ?? ""),
+        queryFn: () => fetchWithValidation(`/v1/admin/flights/orders/${encodeURIComponent(orderId ?? "")}`, flightGetOrderResponseSchema, client),
+        enabled: enabled && !!orderId,
+    });
+}
+/**
+ * POST `/v1/admin/flights/orders/:orderId/cancel`. Updates the cached
+ * order on success so the confirmation page reflects the new "cancelled"
+ * status without a refetch.
+ */
+export function useFlightOrderCancel() {
+    const client = useVoyantFlightsContext();
+    const qc = useQueryClient();
+    return useMutation({
+        mutationFn: (input) => fetchWithValidation(`/v1/admin/flights/orders/${encodeURIComponent(input.orderId)}/cancel`, flightCancelResponseSchema, client, {
+            method: "POST",
+            body: JSON.stringify(input.reason ? { reason: input.reason } : {}),
+        }),
+        onSuccess: (data) => {
+            qc.setQueryData(flightsQueryKeys.orderDetail(data.order.orderId), { order: data.order });
+        },
+    });
+}

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" | "confirmed" | "ticketed" | "cancelled" | "failed";
+        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?: "standard" | "none" | "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,
+    });
+}