@voyant-travel/bookings-react 0.119.3

package/dist/journey/types.d.ts

@@ -0,0 +1,403 @@
+/**
+ * Shell-side types for `<BookingJourney />`. These complement the
+ * engine contracts in `@voyant-travel/catalog-contracts/booking-engine/contracts`
+ * with React-specific slots and event shapes that don't belong on
+ * the wire.
+ *
+ * Per booking-journey-architecture §8.1.
+ */
+import type { BookingDraftV1, BookResponseV1, PricingBreakdownV1 } from "@voyant-travel/catalog-contracts/booking-engine/contracts";
+import type { BookingDraftShape } from "@voyant-travel/catalog-contracts/booking-engine/draft-shape";
+import type { ReactNode } from "react";
+export type JourneyStep = "departure" | "billing" | "travelers" | "options" | "accommodation" | "addons" | "payment" | "documents" | "review";
+export declare const JOURNEY_STEP_ORDER: ReadonlyArray<JourneyStep>;
+export interface JourneySurface {
+    /** Operator-side or storefront — drives default slot behavior. */
+    kind: "admin" | "public";
+}
+export interface LeadContactPickerProps {
+    /** Current buyer type — the picker should search PEOPLE for B2C and
+     *  ORGANIZATIONS for B2B. */
+    buyerType: "B2C" | "B2B";
+    /** Apply a picked lead to the draft's billing fields. A PARTIAL — only
+     *  the provided fields are merged, so separate CRM lookups (person/org
+     *  record, then its address) can each fill their slice without clobbering
+     *  the others. B2C fills the person; B2B fills companyName/taxId; both
+     *  fill the billing address from the CRM record. */
+    apply: (contact: {
+        firstName?: string;
+        lastName?: string;
+        email?: string;
+        phone?: string;
+        personId?: string;
+        organizationId?: string;
+        companyName?: string;
+        taxId?: string;
+        address?: {
+            line1?: string;
+            line2?: string;
+            city?: string;
+            postal?: string;
+            country?: string;
+        };
+    }) => void;
+}
+export interface TravelerContactPickerProps {
+    rowIndex: number;
+    /** The CRM person currently linked to this traveler row, if any. The
+     *  picker should reflect it in its combobox — so e.g. "Copy from billing"
+     *  (which links the billing person) shows that person as selected. */
+    selectedPersonId?: string;
+    /** Apply a picked contact to the traveler at `rowIndex`. */
+    apply: (contact: {
+        firstName: string;
+        lastName: string;
+        email?: string;
+        phone?: string;
+        personId?: string;
+    }) => void;
+}
+/**
+ * Context handed to `renderBillingExtras` — the picked lead + the departure —
+ * so a template can run lead-aware checks (e.g. "this customer already booked
+ * this departure") next to the billing block.
+ */
+export interface BillingExtrasContext {
+    buyerType: "B2C" | "B2B";
+    personId?: string;
+    organizationId?: string;
+    productId: string;
+    departureSlotId?: string;
+    departureDate?: string;
+}
+/**
+ * Props for the injectable voucher picker. The operator surface wires an async
+ * combobox (search the admin vouchers list) so staff pick a voucher without
+ * knowing the exact code; the storefront keeps the customer code-entry form.
+ */
+export interface VoucherPickerProps {
+    /** Currently-linked voucher redemption on the draft, if any. */
+    value: {
+        voucherId?: string;
+        amountCents?: number;
+    };
+    /** Apply a picked voucher's full remaining balance — or clear with `null`. */
+    onApply: (picked: {
+        voucherId: string;
+        amountCents: number;
+    } | null) => void;
+    /** Booking currency + payable total, to display/cap the redemption. */
+    currency?: string;
+    amountCents?: number;
+}
+/**
+ * Props for the injectable departure picker rendered in the Configure
+ * step for a `"departure"` sub-step. The template wires this with a
+ * scheduled-departures source (e.g. operator availability) so the
+ * operator picks a real departure rather than typing a free date.
+ *
+ * The picker owns its own data-loading and should fall back to a free
+ * date when the product has no scheduled departures — the journey just
+ * stores whatever it reports via `onChange`.
+ */
+export interface DeparturePickerProps {
+    /** The owned product whose departures to load. */
+    productId: string;
+    /** Selected product option, used to filter departures (null = any). */
+    optionId: string | null;
+    /** Currently-picked scheduled departure id, or null. */
+    slotId: string | null;
+    /** Currently-entered departure date (free-date fallback), or null. */
+    departureDate: string | null;
+    /** Currently-entered departure time (free-date fallback), or null. */
+    departureTime: string | null;
+    /** Report a change — any omitted field is left unchanged on the draft. */
+    onChange: (next: {
+        slotId?: string | null;
+        departureDate?: string | null;
+        departureTime?: string | null;
+    }) => void;
+}
+/** A picked inventory unit (room) selection on the draft's configure. */
+export interface JourneyOptionSelection {
+    optionId: string;
+    optionName?: string;
+    optionUnitId?: string;
+    optionUnitName?: string;
+    quantity: number;
+}
+/**
+ * Props for the injectable units (rooms) picker rendered in the Configure
+ * step for an `"option-units"` sub-step. The template wires it to an
+ * inventory source (operator availability) so the operator picks room
+ * quantities for the chosen option + departure; the journey stores the
+ * result on `configure.optionSelections`.
+ */
+export interface UnitsPickerProps {
+    /** The owned product whose units to load. */
+    productId: string;
+    /** Currently-selected product option (drives which units show), or null. */
+    optionId: string | null;
+    /** Currently-picked departure slot (drives per-slot availability), or null. */
+    slotId: string | null;
+    /** Current unit selections on the draft. */
+    selections: ReadonlyArray<JourneyOptionSelection>;
+    /** Report the new full set of unit selections. */
+    onChange: (selections: JourneyOptionSelection[]) => void;
+}
+/**
+ * Capabilities supplied by the template — checkout-ui's PaymentStep
+ * consumes these to render the right provider widget. Each flag is
+ * an independent on/off switch the operator configures per
+ * deployment / supplier:
+ *
+ * - `acceptsCard` — Stripe / Netopia / generic card flow. The
+ *   `renderPaymentProviderStep` slot supplies the actual widget.
+ * - `acceptsBankTransfer` — operator emails the buyer bank details;
+ *   booking is created with status "awaiting_payment". Inventory
+ *   hold is still placed so capacity is reserved.
+ * - `acceptsHold` — staff/agent-only soft-hold path; useful when an
+ *   operator is brokering for an end customer.
+ * - `acceptsTicketOnCredit` — agency credit account.
+ * - `acceptsInquiry` — lead-only flow: NO inventory hold, NO charge.
+ *   The "booking" is recorded as an inquiry for the operator to
+ *   manually follow up on. Right for tour operators where a quote
+ *   conversation precedes booking.
+ */
+export interface PaymentProviderCapabilities {
+    acceptsCard: boolean;
+    acceptsHold: boolean;
+    acceptsBankTransfer?: boolean;
+    acceptsTicketOnCredit: boolean;
+    acceptsInquiry?: boolean;
+    /** Free-form provider-specific config (e.g. Netopia merchant id,
+     *  Stripe publishable key, bank-transfer instructions). */
+    config?: Record<string, unknown>;
+}
+export interface PaymentProviderStepRenderProps {
+    intent: BookingDraftV1["payment"]["intent"];
+    schedule: BookingDraftV1["payment"]["schedule"];
+    capabilities: PaymentProviderCapabilities;
+}
+export type BookingJourneyTransitionGuardResult = undefined | boolean | {
+    allow: boolean;
+    message?: string;
+    draft?: BookingDraftV1;
+};
+export interface BookingJourneyTransitionGuardContext {
+    currentStep: JourneyStep;
+    nextStep: JourneyStep;
+    draft: BookingDraftV1;
+    pricing: PricingBreakdownV1 | null;
+    quoteId?: string;
+    surface: "admin" | "public";
+}
+export type BookingJourneyTransitionGuard = (context: BookingJourneyTransitionGuardContext) => BookingJourneyTransitionGuardResult | Promise<BookingJourneyTransitionGuardResult>;
+export interface BookingJourneyProps {
+    /** What to book. */
+    entityModule: string;
+    entityId: string;
+    /**
+     * Source pointer fields. Optional on the public surface — the
+     * engine resolves provenance server-side from
+     * `(entityModule, entityId)` via the catalog plane's
+     * sourced-entry lookup. Operator surfaces should still pass
+     * `sourceKind` explicitly when known.
+     */
+    sourceKind?: string;
+    sourceConnectionId?: string;
+    sourceRef?: string;
+    /** Surface — drives audience defaults and slot wiring. */
+    surface?: "admin" | "public";
+    /**
+     * Layout of the booking flow.
+     *  - `"wizard"` — one step at a time with Back/Next (the guided
+     *    storefront flow).
+     *  - `"stacked"` — every section rendered as a block on a single
+     *    scrollable page, nothing hidden (the operator flow — an admin
+     *    can see travelers while editing options, and jump around freely).
+     * Defaults to `"stacked"` on the admin surface and `"wizard"` on
+     * public, keeping the two processes deliberately separate. */
+    layout?: "wizard" | "stacked";
+    /** Stable draft id — caller persists in URL or session storage so
+     *  the journey survives page refresh. */
+    draftId: string;
+    /** Default buyer type — operator: B2B, storefront: B2C. */
+    defaultBuyerType?: "B2C" | "B2B";
+    /** Initial fallback shape — rendered before the first quote
+     *  resolves. The engine returns a more specific shape on the
+     *  first quote response. */
+    fallbackShape?: BookingDraftShape;
+    /**
+     * Pre-locked configure state. When set, the journey skips the
+     * Configure step entirely — Configure already happened on the
+     * product detail page. Mirrors the BookingDraft's `configure`
+     * shape (loosely typed so storefront callers can pass a
+     * vertical-specific subset without fighting the contract).
+     */
+    initialConfigure?: Record<string, unknown>;
+    /** Pre-locked accommodation slice (room/rate picks made on the
+     *  detail page). Loosely typed for the same reason. */
+    initialAccommodation?: Record<string, unknown>;
+    /**
+     * When true, the wizard hides Configure regardless of descriptor
+     * flags. Use for storefront flows where the product detail page
+     * already collected those choices.
+     */
+    hideConfigure?: boolean;
+    /** Per-payment-provider capabilities — passed through to the
+     *  Payment step's provider widget. */
+    paymentCapabilities?: PaymentProviderCapabilities;
+    /** Operator: pulls from CRM. Storefront: bare inline form. */
+    renderLeadContactPicker?: (props: LeadContactPickerProps) => ReactNode;
+    renderTravelerContactPicker?: (props: TravelerContactPickerProps) => ReactNode;
+    /** Operator-only voucher picker (async search). When omitted, the voucher
+     *  control falls back to the customer code-entry form. */
+    renderVoucherPicker?: (props: VoucherPickerProps) => ReactNode;
+    /**
+     * Renders the Configure step's `"departure"` sub-step. Operator
+     * surfaces wire this to a scheduled-departure picker (availability);
+     * when omitted, the journey renders a free date/time fallback.
+     */
+    renderDeparturePicker?: (props: DeparturePickerProps) => ReactNode;
+    /**
+     * Renders the Configure step's `"option-units"` sub-step (room/unit
+     * quantity selection). Operator surfaces wire this to an inventory
+     * units picker; when omitted, the sub-step renders nothing.
+     */
+    renderUnitsPicker?: (props: UnitsPickerProps) => ReactNode;
+    /** Hook for the actual payment-provider widget — checkout-ui's
+     *  PaymentStep is the canonical implementation. When omitted, the
+     *  shell renders a "Hold only — no card collected" stub. */
+    renderPaymentProviderStep?: (props: PaymentProviderStepRenderProps) => ReactNode;
+    /**
+     * Runs before a forward step transition. Return `false` or
+     * `{ allow: false, message }` to keep the current step active and
+     * surface an inline navigation error; return `{ allow: true,
+     * draft }` to continue with an updated draft snapshot.
+     */
+    onBeforeStepAdvance?: BookingJourneyTransitionGuard;
+    /** Optional pre/post-step extension slots — useful when a
+     *  template wants to inject a custom block (e.g. coupon code
+     *  banner, marketing opt-in). */
+    renderConfigureExtras?: () => ReactNode;
+    /** Billing extras — receives the picked lead + departure so a template can,
+     *  e.g., warn that this customer already has a booking on this departure. */
+    renderBillingExtras?: (ctx: BillingExtrasContext) => ReactNode;
+    renderReviewExtras?: () => ReactNode;
+    /** Fired on successful commit — typically a navigation. */
+    onCommitted?: (result: BookResponseV1) => void;
+    /** Fired when the user explicitly abandons the journey via the
+     *  shell's cancel button. */
+    onCancelled?: () => void;
+    /** Optional class names. */
+    className?: string;
+    sidePanelClassName?: string;
+    /**
+     * Optional summary of the entity being booked — surfaces in the
+     * side panel so the customer keeps context while filling out the
+     * journey. Shape is loose because each vertical carries different
+     * fields (cruises have ports, accommodations have check-in/out, etc.).
+     */
+    entitySummary?: BookingEntitySummary;
+    /**
+     * Contract preview integration. When `templateSlug` is set, the
+     * Review step's "Continue to checkout" button opens the contract
+     * preview dialog with the rendered template instead of committing
+     * directly. The journey then surfaces the acceptance back to the
+     * caller via `onContractAccepted` so the storefront can call its
+     * own `/checkout/start` endpoint.
+     *
+     * - `previewUrl` — absolute URL of the public render endpoint.
+     * - `resolveVariables` — maps the draft to the template's variable
+     *   schema. The storefront supplies a default mapper that covers
+     *   traveler / billing / room / dates.
+     * - `marketingLabel` — when set, an additional opt-in checkbox is
+     *   rendered in the dialog. Marketing consent is optional and is
+     *   passed through `onContractAccepted` so the caller can decide
+     *   what to do with it.
+     */
+    contract?: {
+        templateSlug: string;
+        previewUrl: string;
+        acceptLanguage?: string;
+        resolveVariables: (input: {
+            draft: BookingDraftV1;
+            pricing: PricingBreakdownV1 | null;
+        }) => Record<string, unknown>;
+        marketingLabel?: ReactNode;
+        termsLabel?: ReactNode;
+    };
+    /**
+     * Fired when the user accepts the contract in the preview dialog.
+     * The caller persists the acceptance + dispatches the checkout
+     * workflow. Receives the rendered HTML so it can be stored
+     * verbatim for the audit trail.
+     */
+    /**
+     * Called when the user clicks Confirm on the Review step. Receives
+     * the rendered contract acceptance when the contract dialog was
+     * shown; receives `null` when the journey skipped the dialog
+     * (no template configured — the storefront still wants to drive
+     * the post-confirm /checkout/start flow).
+     */
+    onContractAccepted?: (acceptance: ContractAcceptanceEvent | null, context: BookingJourneyCheckoutContext) => void | Promise<void>;
+}
+export interface BookingJourneyCheckoutContext {
+    draft: BookingDraftV1;
+    pricing: PricingBreakdownV1 | null;
+    quoteId?: string;
+}
+export interface ContractAcceptanceEvent {
+    templateId: string;
+    templateSlug: string;
+    templateName: string;
+    acceptedTerms: true;
+    acceptedMarketing: boolean;
+    acceptedAt: string;
+    renderedHtml: string;
+}
+/**
+ * Caller-provided context for the side-panel summary. Keep it
+ * vertical-agnostic — the panel renders whatever subset is present.
+ */
+export interface BookingEntitySummary {
+    /** Headline name — e.g. product / cruise / hotel name. */
+    name: string;
+    /** Optional second line — e.g. "Iceland · 1 day", "7 nights · Mediterranean". */
+    subtitle?: string;
+    /** Optional hero image — small thumbnail at the top of the panel. */
+    heroImageUrl?: string;
+    /** Vertical badge — drives the "What you're booking" header copy. */
+    vertical?: "products" | "cruises" | "accommodations" | string;
+    /** Optional ISO date or formatted date — e.g. "Tue, May 5, 2026". */
+    whenLabel?: string;
+    /** Optional location label — e.g. "Reykjavík", "Mediterranean", "Bucharest". */
+    locationLabel?: string;
+    /** ISO start date (YYYY-MM-DD or full ISO) — used by the contract
+     *  preview when the draft only carries a slot id. */
+    startDate?: string;
+    /** ISO end date — paired with `startDate` for ranges and contract
+     *  variables like `departure.end_date`. */
+    endDate?: string;
+    /** Free-form destination / route string — surfaced as
+     *  `product.destination` in contract variables. */
+    destination?: string;
+}
+export interface JourneyHeaderState {
+    current: JourneyStep;
+    visited: ReadonlyArray<JourneyStep>;
+    steps: ReadonlyArray<JourneyStep>;
+    shape: BookingDraftShape;
+}
+export interface SidePanelState {
+    pricing: PricingBreakdownV1 | null;
+    isQuoting: boolean;
+    invalidReason?: string;
+    entitySummary?: BookingEntitySummary;
+    currentStep?: JourneyStep;
+    steps?: ReadonlyArray<JourneyStep>;
+    shape?: BookingDraftShape;
+    draft?: BookingDraftV1;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/journey/types.js

@@ -0,0 +1,19 @@
+/**
+ * Shell-side types for `<BookingJourney />`. These complement the
+ * engine contracts in `@voyant-travel/catalog-contracts/booking-engine/contracts`
+ * with React-specific slots and event shapes that don't belong on
+ * the wire.
+ *
+ * Per booking-journey-architecture §8.1.
+ */
+export const JOURNEY_STEP_ORDER = [
+    "departure",
+    "billing",
+    "travelers",
+    "options",
+    "accommodation",
+    "addons",
+    "payment",
+    "documents",
+    "review",
+];

package/dist/provider.d.ts

@@ -0,0 +1,2 @@
+export { useVoyantReactContext as useVoyantBookingsContext, type VoyantReactContextValue as VoyantBookingsContextValue, VoyantReactProvider as VoyantBookingsProvider, type VoyantReactProviderProps as VoyantBookingsProviderProps, } from "@voyant-travel/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,wBAAwB,EACjD,KAAK,uBAAuB,IAAI,0BAA0B,EAC1D,mBAAmB,IAAI,sBAAsB,EAC7C,KAAK,wBAAwB,IAAI,2BAA2B,GAC7D,MAAM,sBAAsB,CAAA"}

package/dist/provider.js

@@ -0,0 +1 @@
+export { useVoyantReactContext as useVoyantBookingsContext, VoyantReactProvider as VoyantBookingsProvider, } from "@voyant-travel/react";

package/dist/query-keys.d.ts

@@ -0,0 +1,74 @@
+export type BookingsListSortField = "bookingNumber" | "status" | "sellAmount" | "pax" | "startDate" | "endDate" | "createdAt";
+export type BookingsListSortDir = "asc" | "desc";
+export interface BookingsListFilters {
+    status?: string | undefined;
+    /**
+     * Statuses to omit from the result. The bookings index uses this to
+     * hide noise (e.g. drafts + expired) from the default "All" view.
+     */
+    excludeStatuses?: string[] | undefined;
+    search?: string | undefined;
+    productId?: string | undefined;
+    optionId?: string | undefined;
+    /**
+     * Restrict to bookings whose items reference this availability slot
+     * (i.e. departure). Typically paired with `productId`.
+     */
+    availabilitySlotId?: string | undefined;
+    supplierId?: string | undefined;
+    productCategoryId?: string | undefined;
+    personId?: string | undefined;
+    organizationId?: string | undefined;
+    dateFrom?: string | undefined;
+    dateTo?: string | undefined;
+    paxMin?: number | undefined;
+    paxMax?: number | undefined;
+    sortBy?: BookingsListSortField | undefined;
+    sortDir?: BookingsListSortDir | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+}
+export interface BookingGroupsListFilters {
+    kind?: string | undefined;
+    productId?: string | undefined;
+    optionUnitId?: string | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+}
+export interface PricingPreviewFilters {
+    productId: string;
+    optionId?: string | null | undefined;
+    catalogId?: string | null | undefined;
+}
+export interface TaxPreviewFilters {
+    productId: string;
+    subtotalCents: number;
+    currency: string;
+}
+export declare const bookingsQueryKeys: {
+    readonly all: readonly ["voyant", "bookings"];
+    readonly bookings: () => readonly ["voyant", "bookings", "bookings"];
+    readonly publicSessions: () => readonly ["voyant", "bookings", "public-sessions"];
+    readonly bookingsList: (filters: BookingsListFilters) => readonly ["voyant", "bookings", "bookings", "list", BookingsListFilters];
+    readonly booking: (id: string) => readonly ["voyant", "bookings", "bookings", "detail", string];
+    readonly publicSession: (sessionId: string) => readonly ["voyant", "bookings", "public-sessions", "detail", string];
+    readonly publicSessionState: (sessionId: string) => readonly ["voyant", "bookings", "public-sessions", "detail", string, "state"];
+    readonly items: (bookingId: string) => readonly ["voyant", "bookings", "bookings", "detail", string, "items"];
+    readonly itemTravelers: (bookingId: string, itemId: string) => readonly ["voyant", "bookings", "bookings", "detail", string, "items", string, "travelers"];
+    readonly travelers: (bookingId: string) => readonly ["voyant", "bookings", "bookings", "detail", string, "travelers"];
+    readonly sharingGroupsForSlot: (slotId: string) => readonly ["voyant", "bookings", "sharing-groups", "slot", string];
+    readonly travelersBySharingGroup: (slotId: string, groupId: string) => readonly ["voyant", "bookings", "sharing-groups", "slot", string, string, "travelers"];
+    readonly documents: (bookingId: string) => readonly ["voyant", "bookings", "bookings", "detail", string, "documents"];
+    readonly supplierStatuses: (bookingId: string) => readonly ["voyant", "bookings", "bookings", "detail", string, "supplier-statuses"];
+    readonly activity: (bookingId: string) => readonly ["voyant", "bookings", "bookings", "detail", string, "activity"];
+    readonly actionLedger: (bookingId: string) => readonly ["voyant", "bookings", "bookings", "detail", string, "action-ledger"];
+    readonly notes: (bookingId: string) => readonly ["voyant", "bookings", "bookings", "detail", string, "notes"];
+    readonly groups: () => readonly ["voyant", "bookings", "groups"];
+    readonly groupsList: (filters: BookingGroupsListFilters) => readonly ["voyant", "bookings", "groups", "list", BookingGroupsListFilters];
+    readonly group: (id: string) => readonly ["voyant", "bookings", "groups", "detail", string];
+    readonly groupMembers: (id: string) => readonly ["voyant", "bookings", "groups", "detail", string, "members"];
+    readonly groupForBooking: (bookingId: string) => readonly ["voyant", "bookings", "bookings", "detail", string, "group"];
+    readonly pricingPreview: (filters: PricingPreviewFilters) => readonly ["voyant", "bookings", "pricing-preview", PricingPreviewFilters];
+    readonly taxPreview: (filters: TaxPreviewFilters) => readonly ["voyant", "bookings", "tax-preview", TaxPreviewFilters];
+};
+//# 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,MAAM,MAAM,qBAAqB,GAC7B,eAAe,GACf,QAAQ,GACR,YAAY,GACZ,KAAK,GACL,WAAW,GACX,SAAS,GACT,WAAW,CAAA;AAEf,MAAM,MAAM,mBAAmB,GAAG,KAAK,GAAG,MAAM,CAAA;AAEhD,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;IACtC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACvC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACtC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,MAAM,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAAA;IAC1C,OAAO,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAA;IACzC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC5B;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC5B;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;IACpC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;CACtC;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,eAAO,MAAM,iBAAiB;;;;qCAKJ,mBAAmB;2BAE7B,MAAM;wCACO,MAAM;6CAED,MAAM;gCAGnB,MAAM;wCACE,MAAM,UAAU,MAAM;oCAE1B,MAAM;4CACE,MAAM;+CAEH,MAAM,WAAW,MAAM;oCAElC,MAAM;2CACC,MAAM;mCAEd,MAAM;uCACF,MAAM;gCAEb,MAAM;;mCAGH,wBAAwB;yBAElC,MAAM;gCACC,MAAM;0CACI,MAAM;uCAGT,qBAAqB;mCAGzB,iBAAiB;CAE/B,CAAA"}

package/dist/query-keys.js

@@ -0,0 +1,26 @@
+export const bookingsQueryKeys = {
+    all: ["voyant", "bookings"],
+    bookings: () => [...bookingsQueryKeys.all, "bookings"],
+    publicSessions: () => [...bookingsQueryKeys.all, "public-sessions"],
+    bookingsList: (filters) => [...bookingsQueryKeys.bookings(), "list", filters],
+    booking: (id) => [...bookingsQueryKeys.bookings(), "detail", id],
+    publicSession: (sessionId) => [...bookingsQueryKeys.publicSessions(), "detail", sessionId],
+    publicSessionState: (sessionId) => [...bookingsQueryKeys.publicSession(sessionId), "state"],
+    items: (bookingId) => [...bookingsQueryKeys.booking(bookingId), "items"],
+    itemTravelers: (bookingId, itemId) => [...bookingsQueryKeys.items(bookingId), itemId, "travelers"],
+    travelers: (bookingId) => [...bookingsQueryKeys.booking(bookingId), "travelers"],
+    sharingGroupsForSlot: (slotId) => [...bookingsQueryKeys.all, "sharing-groups", "slot", slotId],
+    travelersBySharingGroup: (slotId, groupId) => [...bookingsQueryKeys.sharingGroupsForSlot(slotId), groupId, "travelers"],
+    documents: (bookingId) => [...bookingsQueryKeys.booking(bookingId), "documents"],
+    supplierStatuses: (bookingId) => [...bookingsQueryKeys.booking(bookingId), "supplier-statuses"],
+    activity: (bookingId) => [...bookingsQueryKeys.booking(bookingId), "activity"],
+    actionLedger: (bookingId) => [...bookingsQueryKeys.booking(bookingId), "action-ledger"],
+    notes: (bookingId) => [...bookingsQueryKeys.booking(bookingId), "notes"],
+    groups: () => [...bookingsQueryKeys.all, "groups"],
+    groupsList: (filters) => [...bookingsQueryKeys.groups(), "list", filters],
+    group: (id) => [...bookingsQueryKeys.groups(), "detail", id],
+    groupMembers: (id) => [...bookingsQueryKeys.group(id), "members"],
+    groupForBooking: (bookingId) => [...bookingsQueryKeys.booking(bookingId), "group"],
+    pricingPreview: (filters) => [...bookingsQueryKeys.all, "pricing-preview", filters],
+    taxPreview: (filters) => [...bookingsQueryKeys.all, "tax-preview", filters],
+};