@voyant-travel/bookings-react 0.201.1 → 0.203.0

package/dist/hooks/use-booking-convert-mutation.d.ts

@@ -1,80 +0,0 @@
-export interface ConvertProductToBookingInput {
-    productId: string;
-    bookingNumber: string;
-    optionId?: string | null;
-    /**
-     * Availability slot the operator picked. When set, the booking's start/end
-     * dates are pinned to the slot instead of defaulting to the (typically null)
-     * product dates. Server-side validation rejects mismatched product/option.
-     */
-    slotId?: string | null;
-    personId?: string | null;
-    organizationId?: string | null;
-    internalNotes?: string | null;
-}
-/**
- * Creates a draft booking from a product via POST /v1/admin/bookings/from-product.
- * Purpose-built for the operator booking-create flow — the backend seeds items,
- * dates, and pricing from the product definition.
- */
-export declare function useBookingConvertMutation(): import("@tanstack/react-query").UseMutationResult<{
-    id: string;
-    bookingNumber: string;
-    status: "draft" | "expired" | "cancelled" | "on_hold" | "awaiting_payment" | "confirmed" | "in_progress" | "completed";
-    personId: string | null;
-    organizationId: string | null;
-    sellCurrency: string;
-    sellAmountCents: number | null;
-    costAmountCents: number | null;
-    marginPercent: number | null;
-    startDate: string | null;
-    endDate: string | null;
-    pax: number | null;
-    internalNotes: string | null;
-    createdAt: string;
-    updatedAt: string;
-    startsAt?: string | null | undefined;
-    endsAt?: string | null | undefined;
-    items?: {
-        id: string;
-        title: string;
-        itemType: string;
-        productId: string | null;
-        productName?: string | null | undefined;
-        startsAt?: string | null | undefined;
-        endsAt?: string | null | undefined;
-    }[] | undefined;
-    communicationLanguage?: string | null | undefined;
-    contactFirstName?: string | null | undefined;
-    contactLastName?: string | null | undefined;
-    contactPartyType?: "individual" | "company" | null | undefined;
-    contactTaxId?: string | null | undefined;
-    contactEmail?: string | null | undefined;
-    contactPhone?: string | null | undefined;
-    contactPreferredLanguage?: string | null | undefined;
-    contactCountry?: string | null | undefined;
-    contactRegion?: string | null | undefined;
-    contactCity?: string | null | undefined;
-    contactAddressLine1?: string | null | undefined;
-    contactAddressLine2?: string | null | undefined;
-    contactPostalCode?: string | null | undefined;
-    customerPaymentPolicy?: {
-        deposit: {
-            kind: "none" | "percent" | "fixed_cents";
-            percent?: number | undefined;
-            amountCents?: number | undefined;
-        };
-        minDaysBeforeDepartureForDeposit: number;
-        balanceDueDaysBeforeDeparture: number;
-        balanceDueMinDaysFromNow: number;
-    } | null | undefined;
-    priceOverride?: {
-        isManual: true;
-        originalAmountCents: number | null;
-        overriddenAmountCents: number;
-        currency: string;
-        reason: string;
-        overriddenBy: string;
-        overriddenAt: string;
-    } | null | undefined;
-}, Error, ConvertProductToBookingInput, unknown>;

package/dist/hooks/use-booking-convert-mutation.js

@@ -1,24 +0,0 @@
-"use client";
-import { useMutation, useQueryClient } from "@tanstack/react-query";
-import { fetchWithValidation } from "../client.js";
-import { useVoyantBookingsContext } from "../provider.js";
-import { bookingsQueryKeys } from "../query-keys.js";
-import { bookingSingleResponse } from "../schemas.js";
-/**
- * Creates a draft booking from a product via POST /v1/admin/bookings/from-product.
- * Purpose-built for the operator booking-create flow — the backend seeds items,
- * dates, and pricing from the product definition.
- */
-export function useBookingConvertMutation() {
-    const { baseUrl, fetcher } = useVoyantBookingsContext();
-    const queryClient = useQueryClient();
-    return useMutation({
-        mutationFn: async (input) => {
-            const { data } = await fetchWithValidation("/v1/admin/bookings/from-product", bookingSingleResponse, { baseUrl, fetcher }, { method: "POST", body: JSON.stringify(input) });
-            return data;
-        },
-        onSuccess: () => {
-            void queryClient.invalidateQueries({ queryKey: bookingsQueryKeys.bookings() });
-        },
-    });
-}

package/dist/hooks/use-booking-create-mutation.d.ts

@@ -1,336 +0,0 @@
-import { z } from "zod";
-import { type BookingStatus } from "../schemas.js";
-export interface BookingCreateTravelerInput {
-    /**
-     * Stable client-side traveler identity used by itemLines/extraLines
-     * `travelerKeys` to link created booking items to travelers without
-     * relying on request-array position.
-     */
-    clientTravelerKey?: string | null;
-    firstName: string;
-    lastName: string;
-    email?: string | null;
-    phone?: string | null;
-    personId?: string | null;
-    participantType?: "traveler" | "occupant" | "other";
-    travelerCategory?: "adult" | "child" | "infant" | "senior" | "other" | null;
-    preferredLanguage?: string | null;
-    specialRequests?: string | null;
-    /**
-     * Deprecated compatibility alias for the traveler's pricing-tier option
-     * unit. The server accepts this field but does not persist it; item-line
-     * `travelerKeys` carry the supported traveler-to-item linkage.
-     *
-     * @deprecated Use itemLines[].travelerKeys to express traveler-priced
-     * lines and inventory placement.
-     */
-    roomUnitId?: string | null;
-    isPrimary?: boolean | null;
-    notes?: string | null;
-}
-export interface BookingCreatePaymentScheduleInput {
-    scheduleType?: "deposit" | "installment" | "balance" | "hold" | "other";
-    status?: "pending" | "due" | "paid" | "waived" | "cancelled" | "expired";
-    dueDate: string;
-    currency: string;
-    amountCents: number;
-    notes?: string | null;
-}
-export interface BookingCreateDocumentGenerationInput {
-    contractDocument?: boolean;
-    invoiceDocument?: boolean;
-    /** `"proforma"` issues a placeholder doc; defaults to `"invoice"`. */
-    invoiceType?: "invoice" | "proforma";
-}
-export interface BookingCreateItemLineInput {
-    /**
-     * Stable client-side key (e.g. `unit:optu_adult`) the server uses
-     * to look up this item after insert and link it to the travelers
-     * referenced in `travelerKeys`. Server writes
-     * `metadata.bookingCreateLineKey` so the lookup survives the
-     * round-trip. See voyant-travel/voyant#1267.
-     */
-    clientLineKey?: string | null;
-    optionId?: string | null;
-    optionUnitId: string;
-    pricingCategoryId?: string | null;
-    quantity: number;
-    title?: string | null;
-    description?: string | null;
-    unitSellAmountCents?: number | null;
-    totalSellAmountCents?: number | null;
-    /**
-     * Stable `clientTravelerKey` values of travelers mapped to this item. The server inserts one
-     * `booking_item_travelers` row per traveler, linking the created
-     * `booking_item` to the corresponding `booking_traveler`. Null or
-     * empty = unlinked (no per-traveler ledger entry).
-     */
-    travelerKeys?: string[] | null;
-    /**
-     * Indexes (into the request's `travelers` array) of travelers
-     * mapped to this item.
-     *
-     * @deprecated Use travelerKeys. Removal target: next booking-create wire-format major.
-     */
-    travelerIndexes?: number[] | null;
-}
-export interface BookingCreateExtraLineInput {
-    /** See `BookingCreateItemLineInput.clientLineKey`. */
-    clientLineKey?: string | null;
-    productExtraId: string;
-    optionExtraConfigId?: string | null;
-    name: string;
-    description?: string | null;
-    pricingMode?: string | null;
-    pricedPerPerson?: boolean | null;
-    quantity: number;
-    sellCurrency: string;
-    unitSellAmountCents?: number | null;
-    totalSellAmountCents?: number | null;
-    /** See `BookingCreateItemLineInput.travelerKeys`. */
-    travelerKeys?: string[] | null;
-    /**
-     * See `BookingCreateItemLineInput.travelerIndexes`.
-     *
-     * @deprecated Use travelerKeys. Removal target: next booking-create wire-format major.
-     */
-    travelerIndexes?: number[] | null;
-}
-export interface BookingCreateTravelCreditRedemptionInput {
-    travelCreditId: string;
-    amountCents: number;
-}
-export type BookingCreateGroupMembershipInput = {
-    action: "join";
-    groupId: string;
-    role?: "primary" | "shared";
-} | {
-    action: "create";
-    kind?: "shared_room" | "other";
-    label?: string | null;
-    optionUnitId?: string | null;
-    makeBookingPrimary?: boolean;
-};
-export interface BookingCreateInput {
-    productId: string;
-    optionId?: string | null;
-    slotId?: string | null;
-    bookingNumber: string;
-    personId?: string | null;
-    organizationId?: string | null;
-    internalNotes?: string | null;
-    catalogSellAmountCents?: number | null;
-    confirmedSellAmountCents?: number | null;
-    priceOverrideReason?: string | null;
-    itemLines?: BookingCreateItemLineInput[];
-    extraLines?: BookingCreateExtraLineInput[];
-    travelers?: BookingCreateTravelerInput[];
-    paymentSchedules?: BookingCreatePaymentScheduleInput[];
-    travelCreditRedemption?: BookingCreateTravelCreditRedemptionInput;
-    groupMembership?: BookingCreateGroupMembershipInput;
-    documentGeneration?: BookingCreateDocumentGenerationInput;
-    /**
-     * Initial booking status — defaults to `draft` on the server. Set
-     * this to skip the legacy create-then-flip dance: the server commits
-     * the booking already in `confirmed` / `awaiting_payment` in the
-     * same transaction and fires `booking.confirmed` post-commit when
-     * applicable.
-     */
-    initialStatus?: BookingStatus;
-    /**
-     * Only honored when `initialStatus === "confirmed"`. When true, the
-     * post-commit `booking.confirmed` event carries
-     * `suppressNotifications: true` so downstream subscribers skip
-     * customer-facing emails / document bundles.
-     */
-    suppressNotifications?: boolean;
-    /**
-     * Allows a second active booking for the same billing party and departure.
-     * Leave unset for retry/double-submit protection.
-     */
-    allowDuplicate?: boolean;
-    /**
-     * Billing-contact snapshot. Caller (typically the create dialog)
-     * reads the linked CRM person/org and supplies what it knows so the
-     * booking detail page renders the right payer even if those CRM
-     * records change later.
-     */
-    contactFirstName?: string | null;
-    contactLastName?: string | null;
-    contactPartyType?: "individual" | "company" | null;
-    contactTaxId?: string | null;
-    contactEmail?: string | null;
-    contactPhone?: string | null;
-    contactPreferredLanguage?: string | null;
-    contactCountry?: string | null;
-    contactRegion?: string | null;
-    contactCity?: string | null;
-    contactAddressLine1?: string | null;
-    contactAddressLine2?: string | null;
-    contactPostalCode?: string | null;
-}
-declare const bookingCreateResultSchema: z.ZodObject<{
-    booking: z.ZodObject<{
-        id: z.ZodString;
-        bookingNumber: z.ZodString;
-        status: z.ZodEnum<{
-            draft: "draft";
-            expired: "expired";
-            cancelled: "cancelled";
-            on_hold: "on_hold";
-            awaiting_payment: "awaiting_payment";
-            confirmed: "confirmed";
-            in_progress: "in_progress";
-            completed: "completed";
-        }>;
-        personId: z.ZodNullable<z.ZodString>;
-        organizationId: z.ZodNullable<z.ZodString>;
-        sellCurrency: z.ZodString;
-        sellAmountCents: z.ZodNullable<z.ZodNumber>;
-        costAmountCents: z.ZodNullable<z.ZodNumber>;
-        marginPercent: z.ZodNullable<z.ZodNumber>;
-        startDate: z.ZodNullable<z.ZodString>;
-        endDate: z.ZodNullable<z.ZodString>;
-        startsAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        endsAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        pax: z.ZodNullable<z.ZodNumber>;
-        items: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            id: z.ZodString;
-            title: z.ZodString;
-            itemType: z.ZodString;
-            productId: z.ZodNullable<z.ZodString>;
-            productName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-            startsAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-            endsAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        }, z.core.$strip>>>;
-        internalNotes: z.ZodNullable<z.ZodString>;
-        communicationLanguage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        contactFirstName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        contactLastName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        contactPartyType: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-            individual: "individual";
-            company: "company";
-        }>>>;
-        contactTaxId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        contactEmail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        contactPhone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        contactPreferredLanguage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        contactCountry: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        contactRegion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        contactCity: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        contactAddressLine1: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        contactAddressLine2: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        contactPostalCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        customerPaymentPolicy: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-            deposit: z.ZodObject<{
-                kind: z.ZodEnum<{
-                    none: "none";
-                    percent: "percent";
-                    fixed_cents: "fixed_cents";
-                }>;
-                percent: z.ZodOptional<z.ZodNumber>;
-                amountCents: z.ZodOptional<z.ZodNumber>;
-            }, z.core.$strip>;
-            minDaysBeforeDepartureForDeposit: z.ZodNumber;
-            balanceDueDaysBeforeDeparture: z.ZodNumber;
-            balanceDueMinDaysFromNow: z.ZodNumber;
-        }, z.core.$strip>>>;
-        priceOverride: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-            isManual: z.ZodLiteral<true>;
-            originalAmountCents: z.ZodNullable<z.ZodNumber>;
-            overriddenAmountCents: z.ZodNumber;
-            currency: z.ZodString;
-            reason: z.ZodString;
-            overriddenBy: z.ZodString;
-            overriddenAt: z.ZodString;
-        }, z.core.$strip>>>;
-        createdAt: z.ZodString;
-        updatedAt: z.ZodString;
-    }, z.core.$strip>;
-    travelers: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
-    paymentSchedules: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
-    travelCreditRedemption: z.ZodOptional<z.ZodNullable<z.ZodUnknown>>;
-    groupMembership: z.ZodOptional<z.ZodNullable<z.ZodUnknown>>;
-    invoice: z.ZodOptional<z.ZodNullable<z.ZodUnknown>>;
-    invoiceDocument: z.ZodOptional<z.ZodUnknown>;
-    payments: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
-}, z.core.$strip>;
-export type BookingCreateResult = z.infer<typeof bookingCreateResultSchema>;
-/**
- * Atomic booking-create: calls `POST /v1/admin/bookings/create` which wraps
- * convert-from-product + travelers + payment schedules + Travel Credit redemption
- * + group membership in one transaction. Prefer this over chaining the
- * separate create mutations (convert, group, traveler) from a single submit
- * handler — a mid-chain failure there leaves orphan state.
- */
-export declare function useBookingCreateMutation(): import("@tanstack/react-query").UseMutationResult<{
-    booking: {
-        id: string;
-        bookingNumber: string;
-        status: "draft" | "expired" | "cancelled" | "on_hold" | "awaiting_payment" | "confirmed" | "in_progress" | "completed";
-        personId: string | null;
-        organizationId: string | null;
-        sellCurrency: string;
-        sellAmountCents: number | null;
-        costAmountCents: number | null;
-        marginPercent: number | null;
-        startDate: string | null;
-        endDate: string | null;
-        pax: number | null;
-        internalNotes: string | null;
-        createdAt: string;
-        updatedAt: string;
-        startsAt?: string | null | undefined;
-        endsAt?: string | null | undefined;
-        items?: {
-            id: string;
-            title: string;
-            itemType: string;
-            productId: string | null;
-            productName?: string | null | undefined;
-            startsAt?: string | null | undefined;
-            endsAt?: string | null | undefined;
-        }[] | undefined;
-        communicationLanguage?: string | null | undefined;
-        contactFirstName?: string | null | undefined;
-        contactLastName?: string | null | undefined;
-        contactPartyType?: "individual" | "company" | null | undefined;
-        contactTaxId?: string | null | undefined;
-        contactEmail?: string | null | undefined;
-        contactPhone?: string | null | undefined;
-        contactPreferredLanguage?: string | null | undefined;
-        contactCountry?: string | null | undefined;
-        contactRegion?: string | null | undefined;
-        contactCity?: string | null | undefined;
-        contactAddressLine1?: string | null | undefined;
-        contactAddressLine2?: string | null | undefined;
-        contactPostalCode?: string | null | undefined;
-        customerPaymentPolicy?: {
-            deposit: {
-                kind: "none" | "percent" | "fixed_cents";
-                percent?: number | undefined;
-                amountCents?: number | undefined;
-            };
-            minDaysBeforeDepartureForDeposit: number;
-            balanceDueDaysBeforeDeparture: number;
-            balanceDueMinDaysFromNow: number;
-        } | null | undefined;
-        priceOverride?: {
-            isManual: true;
-            originalAmountCents: number | null;
-            overriddenAmountCents: number;
-            currency: string;
-            reason: string;
-            overriddenBy: string;
-            overriddenAt: string;
-        } | null | undefined;
-    };
-    travelers?: unknown[] | undefined;
-    paymentSchedules?: unknown[] | undefined;
-    travelCreditRedemption?: unknown;
-    groupMembership?: unknown;
-    invoice?: unknown;
-    invoiceDocument?: unknown;
-    payments?: unknown[] | undefined;
-}, Error, BookingCreateInput, unknown>;
-export {};

package/dist/hooks/use-booking-create-mutation.js

@@ -1,43 +0,0 @@
-"use client";
-import { useMutation, useQueryClient } from "@tanstack/react-query";
-import { z } from "zod";
-import { fetchWithValidation } from "../client.js";
-import { useVoyantBookingsContext } from "../provider.js";
-import { bookingsQueryKeys } from "../query-keys.js";
-import { bookingRecordSchema } from "../schemas.js";
-// Response envelope: route returns `{ data: { booking, travelers, paymentSchedules, travelCreditRedemption, groupMembership } }`.
-// We validate only the booking shape (which drives cache invalidation) and
-// pass the rest through as-is so the surface can evolve without breaking
-// clients. Callers who want typed assertions on the extras can narrow on the
-// result.
-const bookingCreateResultSchema = z.object({
-    booking: bookingRecordSchema,
-    travelers: z.array(z.unknown()).optional(),
-    paymentSchedules: z.array(z.unknown()).optional(),
-    travelCreditRedemption: z.unknown().nullable().optional(),
-    groupMembership: z.unknown().nullable().optional(),
-    invoice: z.unknown().nullable().optional(),
-    invoiceDocument: z.unknown().optional(),
-    payments: z.array(z.unknown()).optional(),
-});
-const bookingCreateResponseSchema = z.object({ data: bookingCreateResultSchema });
-/**
- * Atomic booking-create: calls `POST /v1/admin/bookings/create` which wraps
- * convert-from-product + travelers + payment schedules + Travel Credit redemption
- * + group membership in one transaction. Prefer this over chaining the
- * separate create mutations (convert, group, traveler) from a single submit
- * handler — a mid-chain failure there leaves orphan state.
- */
-export function useBookingCreateMutation() {
-    const { baseUrl, fetcher } = useVoyantBookingsContext();
-    const queryClient = useQueryClient();
-    return useMutation({
-        mutationFn: async (input) => {
-            const { data } = await fetchWithValidation("/v1/admin/bookings/create", bookingCreateResponseSchema, { baseUrl, fetcher }, { method: "POST", body: JSON.stringify(input) });
-            return data;
-        },
-        onSuccess: () => {
-            void queryClient.invalidateQueries({ queryKey: bookingsQueryKeys.bookings() });
-        },
-    });
-}