@voyantjs/flights-react 0.21.0

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

@@ -0,0 +1,110 @@
+import type { FlightSearchRequest } from "@voyantjs/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?: "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;
+    }[];
+    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,kCAAkC,CAAA;AAK3E,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 "@voyantjs/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,kCAAkC,CAAA;AAKnE,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/crm/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/crm/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/crm/people/${encodeURIComponent(personId ?? "")}/payment-methods`, savedPaymentMethodListResponseSchema, client),
+        enabled: enabled && !!personId,
+        staleTime,
+    });
+}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { defaultFetcher, type FetchWithValidationOptions, fetchWithValidation, VoyantApiError, type VoyantFetcher, } from "./client.js";
+export * from "./hooks/index.js";
+export { useVoyantFlightsContext, type VoyantFlightsContextValue, VoyantFlightsProvider, type VoyantFlightsProviderProps, } from "./provider.js";
+export { type AirportSearchFilters, type FlightOrderPaymentStatus, type FlightOrdersListFilters, flightsQueryKeys, } from "./query-keys.js";
+export { getAircraftQueryOptions, getAirlinesQueryOptions, getAirportsQueryOptions, getFlightAncillariesQueryOptions, getFlightSearchQueryOptions, getFlightSeatMapQueryOptions, } from "./query-options.js";
+export * from "./schemas.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,OAAO,EACL,cAAc,EACd,KAAK,0BAA0B,EAC/B,mBAAmB,EACnB,cAAc,EACd,KAAK,aAAa,GACnB,MAAM,aAAa,CAAA;AACpB,cAAc,kBAAkB,CAAA;AAChC,OAAO,EACL,uBAAuB,EACvB,KAAK,yBAAyB,EAC9B,qBAAqB,EACrB,KAAK,0BAA0B,GAChC,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,gBAAgB,GACjB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,uBAAuB,EACvB,gCAAgC,EAChC,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,oBAAoB,CAAA;AAC3B,cAAc,cAAc,CAAA"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { defaultFetcher, fetchWithValidation, VoyantApiError, } from "./client.js";
+export * from "./hooks/index.js";
+export { useVoyantFlightsContext, VoyantFlightsProvider, } from "./provider.js";
+export { flightsQueryKeys, } from "./query-keys.js";
+export { getAircraftQueryOptions, getAirlinesQueryOptions, getAirportsQueryOptions, getFlightAncillariesQueryOptions, getFlightSearchQueryOptions, getFlightSeatMapQueryOptions, } from "./query-options.js";
+export * from "./schemas.js";

package/dist/provider.d.ts

@@ -0,0 +1,2 @@
+export { useVoyantReactContext as useVoyantFlightsContext, type VoyantReactContextValue as VoyantFlightsContextValue, VoyantReactProvider as VoyantFlightsProvider, type VoyantReactProviderProps as VoyantFlightsProviderProps, } from "@voyantjs/react";
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,IAAI,uBAAuB,EAChD,KAAK,uBAAuB,IAAI,yBAAyB,EACzD,mBAAmB,IAAI,qBAAqB,EAC5C,KAAK,wBAAwB,IAAI,0BAA0B,GAC5D,MAAM,iBAAiB,CAAA"}

package/dist/provider.js

@@ -0,0 +1 @@
+export { useVoyantReactContext as useVoyantFlightsContext, VoyantReactProvider as VoyantFlightsProvider, } from "@voyantjs/react";

package/dist/query-keys.d.ts

@@ -0,0 +1,42 @@
+import type { FlightOrderStatus, FlightSearchRequest } from "@voyantjs/flights/contract/types";
+export interface AirportSearchFilters {
+    q?: string | undefined;
+    limit?: number | undefined;
+}
+/**
+ * `paymentStatus` mirrors the finance `payment_session` statuses, plus
+ * `"none"` for orders the operator hasn't created a session for yet.
+ * Sent operator-side; the underlying flight adapter stays unaware of
+ * payments.
+ */
+export type FlightOrderPaymentStatus = "none" | "pending" | "requires_redirect" | "processing" | "authorized" | "paid" | "failed" | "cancelled" | "expired";
+export interface FlightOrdersListFilters {
+    cursor?: string | undefined;
+    limit?: number | undefined;
+    search?: string | undefined;
+    status?: FlightOrderStatus[] | undefined;
+    paymentStatus?: FlightOrderPaymentStatus[] | undefined;
+}
+export declare const flightsQueryKeys: {
+    readonly all: readonly ["voyant", "flights"];
+    readonly search: () => readonly ["voyant", "flights", "search"];
+    readonly searchRequest: (request: FlightSearchRequest) => readonly ["voyant", "flights", "search", FlightSearchRequest];
+    readonly offer: () => readonly ["voyant", "flights", "offer"];
+    readonly offerDetail: (offerId: string) => readonly ["voyant", "flights", "offer", "detail", string];
+    readonly ancillaries: () => readonly ["voyant", "flights", "ancillaries"];
+    readonly ancillariesForOffer: (offerId: string) => readonly ["voyant", "flights", "ancillaries", string];
+    readonly seatMap: () => readonly ["voyant", "flights", "seatmap"];
+    readonly seatMapForSegment: (offerId: string, segmentId: string) => readonly ["voyant", "flights", "seatmap", string, string];
+    /** Saved payment methods are CRM-adjacent but currently expose via the operator template route. */
+    readonly savedPaymentMethods: (personId: string) => readonly ["voyant", "flights", "saved-payment-methods", string];
+    readonly order: () => readonly ["voyant", "flights", "order"];
+    readonly orderDetail: (orderId: string) => readonly ["voyant", "flights", "order", "detail", string];
+    readonly orderList: (filters: FlightOrdersListFilters) => readonly ["voyant", "flights", "order", "list", FlightOrdersListFilters];
+    readonly reference: () => readonly ["voyant", "flights", "reference"];
+    readonly airlines: () => readonly ["voyant", "flights", "reference", "airlines"];
+    readonly airports: (filters: AirportSearchFilters) => readonly ["voyant", "flights", "reference", "airports", AirportSearchFilters];
+    readonly airline: (iataCode: string) => readonly ["voyant", "flights", "reference", "airline", string];
+    readonly airport: (iataCode: string) => readonly ["voyant", "flights", "reference", "airport", string];
+    readonly aircraft: () => readonly ["voyant", "flights", "reference", "aircraft"];
+};
+//# sourceMappingURL=query-keys.d.ts.map

package/dist/query-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-keys.d.ts","sourceRoot":"","sources":["../src/query-keys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAA;AAE9F,MAAM,WAAW,oBAAoB;IACnC,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACtB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC3B;AAED;;;;;GAKG;AACH,MAAM,MAAM,wBAAwB,GAChC,MAAM,GACN,SAAS,GACT,mBAAmB,GACnB,YAAY,GACZ,YAAY,GACZ,MAAM,GACN,QAAQ,GACR,WAAW,GACX,SAAS,CAAA;AAEb,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,MAAM,CAAC,EAAE,iBAAiB,EAAE,GAAG,SAAS,CAAA;IACxC,aAAa,CAAC,EAAE,wBAAwB,EAAE,GAAG,SAAS,CAAA;CACvD;AAED,eAAO,MAAM,gBAAgB;;;sCAIF,mBAAmB;;oCAGrB,MAAM;;4CAGE,MAAM;;0CAGR,MAAM,aAAa,MAAM;IAGtD,mGAAmG;6CACnE,MAAM;;oCAIf,MAAM;kCACR,uBAAuB;;;iCAKxB,oBAAoB;iCAEpB,MAAM;iCACN,MAAM;;CAElB,CAAA"}

package/dist/query-keys.js

@@ -0,0 +1,22 @@
+export const flightsQueryKeys = {
+    all: ["voyant", "flights"],
+    search: () => [...flightsQueryKeys.all, "search"],
+    searchRequest: (request) => [...flightsQueryKeys.search(), request],
+    offer: () => [...flightsQueryKeys.all, "offer"],
+    offerDetail: (offerId) => [...flightsQueryKeys.offer(), "detail", offerId],
+    ancillaries: () => [...flightsQueryKeys.all, "ancillaries"],
+    ancillariesForOffer: (offerId) => [...flightsQueryKeys.ancillaries(), offerId],
+    seatMap: () => [...flightsQueryKeys.all, "seatmap"],
+    seatMapForSegment: (offerId, segmentId) => [...flightsQueryKeys.seatMap(), offerId, segmentId],
+    /** Saved payment methods are CRM-adjacent but currently expose via the operator template route. */
+    savedPaymentMethods: (personId) => [...flightsQueryKeys.all, "saved-payment-methods", personId],
+    order: () => [...flightsQueryKeys.all, "order"],
+    orderDetail: (orderId) => [...flightsQueryKeys.order(), "detail", orderId],
+    orderList: (filters) => [...flightsQueryKeys.order(), "list", filters],
+    reference: () => [...flightsQueryKeys.all, "reference"],
+    airlines: () => [...flightsQueryKeys.reference(), "airlines"],
+    airports: (filters) => [...flightsQueryKeys.reference(), "airports", filters],
+    airline: (iataCode) => [...flightsQueryKeys.reference(), "airline", iataCode],
+    airport: (iataCode) => [...flightsQueryKeys.reference(), "airport", iataCode],
+    aircraft: () => [...flightsQueryKeys.reference(), "aircraft"],
+};