@voyant-travel/bookings-react 0.119.3

package/dist/admin/booking-journey-host.js

@@ -0,0 +1,278 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Packaged admin host for the unified `<BookingJourney />` wizard —
+ * supplies CRM-backed contact pickers, the B2B billing default, real
+ * departure/units/voucher pickers over operator inventory, and post-commit
+ * navigation to the new booking's detail page.
+ *
+ * Per booking-journey-architecture §8.1 + §10 Phase B, packaged per the
+ * packaged-admin RFC Phase 3: cross-route navigation resolves through
+ * semantic destinations (`booking.detail` on commit, `catalog.browse` on
+ * cancel), and the data client comes from the host-mounted
+ * `VoyantReactProvider` — no app route tree, no app fetcher import.
+ */
+import { useQuery } from "@tanstack/react-query";
+import { useAdminNavigate, useOperatorAdminMessages } from "@voyant-travel/admin";
+import { useAddresses } from "@voyant-travel/identity-react";
+import { getProductMediaQueryOptions, getProductQueryOptions } from "@voyant-travel/inventory-react";
+import { useOrganization, usePerson } from "@voyant-travel/relationships-react";
+import { useEffect, useMemo, useRef, useState } from "react";
+import { emptyPersonPickerValue, PersonPickerSection, } from "../components/person-picker-section.js";
+import { BookingJourney, } from "../journey/index.js";
+import { useVoyantBookingsContext } from "../provider.js";
+import { JourneyBillingDuplicateWarning } from "./journey-billing-duplicate-warning.js";
+import { JourneyDeparturePicker } from "./journey-departure-picker.js";
+import { JourneyUnitsPicker } from "./journey-units-picker.js";
+import { JourneyVoucherPicker } from "./journey-voucher-picker.js";
+/** The catalog browse surface the journey returns to when cancelled. */
+function journeyReturnSurface(vertical) {
+    switch (vertical) {
+        case "cruises":
+            return "cruises";
+        case "accommodations":
+            return "accommodations";
+        default:
+            return "products";
+    }
+}
+export function BookingJourneyHost({ entityModule, entityId, sourceKind, sourceConnectionId, sourceRef, departureId, departureDate, optionId, roomTypeId, ratePlanId, board, entityName, entityImageUrl, draftId, className, }) {
+    const navigate = useAdminNavigate();
+    const entitySummary = useEntitySummary(entityModule, entityId, {
+        name: entityName,
+        heroImageUrl: entityImageUrl,
+    });
+    const slots = {
+        renderLeadContactPicker({ apply, buyerType }) {
+            return _jsx(CrmLeadPicker, { apply: apply, buyerType: buyerType });
+        },
+        renderBillingExtras(ctx) {
+            // Warn if the picked lead already booked this departure.
+            return _jsx(JourneyBillingDuplicateWarning, { ...ctx });
+        },
+        renderDeparturePicker(pickerProps) {
+            // Owned: real scheduled departures from availability. Sourced products
+            // have none; when one was booked from a specific offer the date came in
+            // pre-selected, so we lock it (a different date = a different offer).
+            return _jsx(JourneyDeparturePicker, { ...pickerProps, lockDeparture: Boolean(departureDate) });
+        },
+        renderUnitsPicker(pickerProps) {
+            // Rooms/units for the picked option + departure (operator inventory).
+            return _jsx(JourneyUnitsPicker, { ...pickerProps });
+        },
+        renderVoucherPicker(pickerProps) {
+            // Admin searches + selects a voucher (no need to know the code).
+            return _jsx(JourneyVoucherPicker, { ...pickerProps });
+        },
+        renderTravelerContactPicker({ apply, selectedPersonId }) {
+            // Travelers reuse the same picker (person-only). Adapt the picker's
+            // partial lead-apply to the traveler apply (always a person), and
+            // reflect the row's linked person so "Copy from billing" selects it.
+            return (_jsx(CrmLeadPicker, { variant: "traveler", linkedPersonId: selectedPersonId, apply: (contact) => apply({
+                    firstName: contact.firstName ?? "",
+                    lastName: contact.lastName ?? "",
+                    email: contact.email,
+                    phone: contact.phone,
+                    personId: contact.personId,
+                }) }));
+        },
+        onCommitted(result) {
+            // Land on the new booking's detail page.
+            navigate("booking.detail", { bookingId: result.bookingId });
+        },
+        onCancelled() {
+            navigate("catalog.browse", { surface: journeyReturnSurface(entityModule) });
+        },
+    };
+    return (_jsx(BookingJourney, { surface: "admin", entityModule: entityModule, entityId: entityId, sourceKind: sourceKind, sourceConnectionId: sourceConnectionId, sourceRef: sourceRef, draftId: draftId, initialConfigure: {
+            ...(departureId ? { departureSlotId: departureId } : {}),
+            ...(departureDate ? { departureDate } : {}),
+            ...(optionId ? { variantId: optionId } : {}),
+            ...(roomTypeId ? { roomTypeId } : {}),
+            ...(ratePlanId ? { ratePlanId } : {}),
+            ...(board ? { board } : {}),
+        }, defaultBuyerType: "B2B", 
+        // Operator payment options: hold (reserve, collect later), online payment
+        // link (the customer pays via the hosted PSP page — we never charge a card
+        // instantly here), bank transfer, and agency credit.
+        paymentCapabilities: {
+            acceptsCard: true,
+            acceptsHold: true,
+            acceptsBankTransfer: true,
+            acceptsTicketOnCredit: true,
+        }, entitySummary: entitySummary, className: className, ...slots }));
+}
+/**
+ * Builds the "what you're booking" preview shown atop the journey side
+ * panel — the product's name + first image, for an instant preview before
+ * the quote returns. Owned products in the `products` table resolve via the
+ * client fetch; a sourced/connect id isn't in that table, so it falls back to
+ * the `hints` (name + hero image) carried from the catalog detail page. We
+ * can't (and needn't) tell owned from sourced on the client — the URL no
+ * longer carries `sourceKind` — so we try the products fetch for the
+ * `products` vertical and let the hints cover everything else.
+ */
+function useEntitySummary(entityModule, entityId, hints) {
+    const tryProductSummary = entityModule === "products" && Boolean(entityId);
+    const client = useVoyantBookingsContext();
+    const productQuery = useQuery({
+        ...getProductQueryOptions(client, entityId),
+        enabled: tryProductSummary,
+        retry: false,
+    });
+    const mediaQuery = useQuery({
+        ...getProductMediaQueryOptions(client, entityId, { mediaType: "image" }),
+        enabled: tryProductSummary,
+        retry: false,
+    });
+    return useMemo(() => {
+        const product = productQuery.data;
+        if (product) {
+            // First product-level (not day-scoped) image, if any.
+            const heroImageUrl = (mediaQuery.data?.data ?? [])
+                .filter((media) => media.mediaType === "image" && media.dayId == null)
+                .map((media) => media.url)
+                .find(Boolean);
+            return {
+                name: product.name,
+                vertical: "products",
+                ...(heroImageUrl ? { heroImageUrl } : {}),
+            };
+        }
+        // Sourced/connect entity (not in the owned table) — use the preview hints.
+        if (hints.name) {
+            return {
+                name: hints.name,
+                vertical: entityModule,
+                ...(hints.heroImageUrl ? { heroImageUrl: hints.heroImageUrl } : {}),
+            };
+        }
+        return undefined;
+    }, [productQuery.data, mediaQuery.data, hints.name, hints.heroImageUrl, entityModule]);
+}
+/**
+ * CRM-backed picker for the journey's contact slots. Buyer type drives the
+ * mode (there's no bill-to toggle): for the LEAD slot it searches PEOPLE on
+ * B2C and ORGANIZATIONS on B2B — picking either hydrates the journey from the
+ * CRM record (person → name/email/phone; org → company name/tax id). The
+ * per-traveler slot is always a person picker.
+ */
+function CrmLeadPicker({ apply, buyerType, variant = "lead", linkedPersonId, }) {
+    const t = useOperatorAdminMessages().bookings.detail.bookingJourney;
+    // The lead picker bills an organization on B2B; everything else is a person.
+    const orgMode = variant === "lead" && buyerType === "B2B";
+    const [value, setValue] = useState(emptyPersonPickerValue);
+    // Reflect an externally-set person (copy-from-billing, or a re-opened
+    // draft) in the combobox. The hydrate effect below then fills the names;
+    // the `appliedPersonId` ref keeps that idempotent.
+    useEffect(() => {
+        if (!linkedPersonId)
+            return;
+        setValue((cur) => cur.personId === linkedPersonId
+            ? cur
+            : { ...cur, mode: "existing", personId: linkedPersonId });
+    }, [linkedPersonId]);
+    // Keep the picker's target aligned with the Buyer type radio.
+    useEffect(() => {
+        setValue((current) => {
+            const desired = orgMode ? "organization" : "person";
+            return (current.billTo ?? "person") === desired ? current : { ...current, billTo: desired };
+        });
+    }, [orgMode]);
+    // Hydrate from the picked CRM person (B2C). The picker yields just an id;
+    // we fetch the record and apply the real name/email/phone.
+    const selectedPersonId = !orgMode && value.mode === "existing" && value.personId ? value.personId : undefined;
+    const personQuery = usePerson(selectedPersonId, { enabled: Boolean(selectedPersonId) });
+    const appliedPersonId = useRef(null);
+    // biome-ignore lint/correctness/useExhaustiveDependencies: applies once per resolved record; the ref guards re-entry from apply()->setDraft re-renders -- owner: bookings-react; existing suppression is intentional pending typed cleanup.
+    useEffect(() => {
+        const person = personQuery.data;
+        if (!person || appliedPersonId.current === person.id)
+            return;
+        appliedPersonId.current = person.id;
+        apply({
+            firstName: person.firstName,
+            lastName: person.lastName,
+            email: person.email ?? undefined,
+            phone: person.phone ?? undefined,
+            personId: person.id,
+        });
+    }, [personQuery.data]);
+    // Hydrate the company fields from the picked CRM organization (B2B).
+    const selectedOrgId = orgMode && value.organizationId ? value.organizationId : undefined;
+    const orgQuery = useOrganization(selectedOrgId, { enabled: Boolean(selectedOrgId) });
+    const appliedOrgId = useRef(null);
+    // biome-ignore lint/correctness/useExhaustiveDependencies: applies once per resolved record; the ref guards re-entry -- owner: bookings-react; existing suppression is intentional pending typed cleanup.
+    useEffect(() => {
+        const org = orgQuery.data;
+        if (!org || appliedOrgId.current === org.id)
+            return;
+        appliedOrgId.current = org.id;
+        apply({
+            organizationId: org.id,
+            companyName: org.legalName ?? org.name,
+            taxId: org.taxId ?? undefined,
+        });
+    }, [orgQuery.data]);
+    // Hydrate the billing address from the picked person (B2C) or org (B2B)
+    // primary CRM address — so the operator never re-types it and the tax
+    // country is set. Missing → surfaced as a warning to fix in the picker.
+    const addressEntityType = orgMode ? "organization" : "person";
+    // Only the billing lead pulls an address; travelers don't carry one.
+    const addressEntityId = variant === "lead" ? (orgMode ? selectedOrgId : selectedPersonId) : undefined;
+    const addressQuery = useAddresses({
+        entityType: addressEntityType,
+        entityId: addressEntityId,
+        isPrimary: true,
+        limit: 1,
+        enabled: Boolean(addressEntityId),
+    });
+    const appliedAddressKey = useRef(null);
+    // biome-ignore lint/correctness/useExhaustiveDependencies: applies once per resolved address; the ref guards re-entry -- owner: bookings-react; existing suppression is intentional pending typed cleanup.
+    useEffect(() => {
+        const addr = addressQuery.data?.data?.[0];
+        if (!addressEntityId || !addr)
+            return;
+        const key = `${addressEntityType}:${addressEntityId}`;
+        if (appliedAddressKey.current === key)
+            return;
+        appliedAddressKey.current = key;
+        apply({
+            address: {
+                line1: addr.line1 ?? undefined,
+                line2: addr.line2 ?? undefined,
+                city: addr.city ?? undefined,
+                postal: addr.postalCode ?? undefined,
+                country: addr.country ?? undefined,
+            },
+        });
+    }, [addressQuery.data, addressEntityId]);
+    function commit(next) {
+        setValue(next);
+        if ((next.billTo ?? "person") === "organization") {
+            if (next.organizationId !== appliedOrgId.current)
+                appliedOrgId.current = null;
+            return;
+        }
+        if (next.mode === "existing" && next.personId) {
+            if (next.personId !== appliedPersonId.current)
+                appliedPersonId.current = null;
+            return;
+        }
+        appliedPersonId.current = null;
+        if (next.mode === "new") {
+            apply({
+                firstName: next.newPerson.firstName,
+                lastName: next.newPerson.lastName,
+                email: next.newPerson.email || undefined,
+                phone: next.newPerson.phone || undefined,
+            });
+        }
+    }
+    return (_jsx(PersonPickerSection, { value: value, onChange: commit, 
+        // Org is an allowed target for the lead (so its CRM org search runs),
+        // but the toggle is hidden — Buyer type is the single control.
+        showOrganization: variant === "lead", hideTargetToggle: true, labels: {
+            person: variant === "traveler" ? t.travelerPickerLabel : t.leadContactPickerLabel,
+        } }));
+}

package/dist/admin/bookings-host.d.ts

@@ -0,0 +1,26 @@
+import type { ReactNode } from "react";
+import type { BookingListFiltersState } from "../components/booking-list.js";
+export interface BookingsHostProps {
+    /** Filter / sort / paging state parsed from the URL by the route file. */
+    initialFilters?: Partial<BookingListFiltersState>;
+    /** Fires on any filter change; the route file projects it back into the URL. */
+    onFiltersChange?: (filters: BookingListFiltersState) => void;
+    /**
+     * Extra action(s) rendered alongside the primary "New booking" button.
+     * App-owned adjacent flows (e.g. the operator's "Compose trip" link)
+     * land here so the packaged page doesn't hardcode other domains.
+     */
+    headerActions?: ReactNode;
+}
+/**
+ * Packaged admin host for `BookingsPage` (packaged-admin RFC Phase 3).
+ *
+ * Proof-of-contract for semantic destinations (RFC §4.7): no host route
+ * tree is imported — opening a booking resolves `"booking.detail"` and the
+ * "New booking" button resolves `"booking.create"` through the resolvers
+ * the workspace shell registered. The route file stays the thin binding
+ * layer for search-state (via {@link bookingsIndexSearchSchema} and the
+ * `bookingsSearchToFilters`/`bookingsFiltersToSearch` helpers).
+ */
+export declare function BookingsHost({ initialFilters, onFiltersChange, headerActions, }: BookingsHostProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=bookings-host.d.ts.map

package/dist/admin/bookings-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bookings-host.d.ts","sourceRoot":"","sources":["../../src/admin/bookings-host.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAA;AAG5E,MAAM,WAAW,iBAAiB;IAChC,0EAA0E;IAC1E,cAAc,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,CAAA;IACjD,gFAAgF;IAChF,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,IAAI,CAAA;IAC5D;;;;OAIG;IACH,aAAa,CAAC,EAAE,SAAS,CAAA;CAC1B;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,EAC3B,cAAc,EACd,eAAe,EACf,aAAa,GACd,EAAE,iBAAiB,2CAYnB"}

package/dist/admin/bookings-host.js

@@ -0,0 +1,18 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useAdminNavigate } from "@voyant-travel/admin";
+import { BookingsPage } from "../components/bookings-page.js";
+/**
+ * Packaged admin host for `BookingsPage` (packaged-admin RFC Phase 3).
+ *
+ * Proof-of-contract for semantic destinations (RFC §4.7): no host route
+ * tree is imported — opening a booking resolves `"booking.detail"` and the
+ * "New booking" button resolves `"booking.create"` through the resolvers
+ * the workspace shell registered. The route file stays the thin binding
+ * layer for search-state (via {@link bookingsIndexSearchSchema} and the
+ * `bookingsSearchToFilters`/`bookingsFiltersToSearch` helpers).
+ */
+export function BookingsHost({ initialFilters, onFiltersChange, headerActions, }) {
+    const navigateTo = useAdminNavigate();
+    return (_jsx(BookingsPage, { onCreateBooking: () => navigateTo("booking.create", {}), onBookingOpen: (booking) => navigateTo("booking.detail", { bookingId: booking.id }), headerActions: headerActions, initialFilters: initialFilters, onFiltersChange: onFiltersChange }));
+}

package/dist/admin/bookings-list-skeleton.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Route-level placeholder for the bookings list. Mirrors `BookingsPage` +
+ * `BookingList`:
+ *   - Page title + description
+ *   - Search input (left) + "New booking" button (right)
+ *   - 5-column table: Booking # / Status / Sell Amount / Pax / Start Date
+ *   - Pagination bar
+ */
+export declare function BookingsListSkeleton(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=bookings-list-skeleton.d.ts.map

package/dist/admin/bookings-list-skeleton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bookings-list-skeleton.d.ts","sourceRoot":"","sources":["../../src/admin/bookings-list-skeleton.tsx"],"names":[],"mappings":"AAaA;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,4CA2CnC"}

package/dist/admin/bookings-list-skeleton.js

@@ -0,0 +1,25 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useOperatorAdminMessages } from "@voyant-travel/admin";
+import { Skeleton } from "@voyant-travel/ui/components/skeleton";
+import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow, } from "@voyant-travel/ui/components/table";
+/**
+ * Route-level placeholder for the bookings list. Mirrors `BookingsPage` +
+ * `BookingList`:
+ *   - Page title + description
+ *   - Search input (left) + "New booking" button (right)
+ *   - 5-column table: Booking # / Status / Sell Amount / Pax / Start Date
+ *   - Pagination bar
+ */
+export function BookingsListSkeleton() {
+    const bookingMessages = useOperatorAdminMessages().bookings.list;
+    return (_jsxs("div", { className: "flex flex-col gap-6 p-6", children: [_jsxs("div", { className: "space-y-2", children: [_jsx(Skeleton, { className: "h-7 w-28" }), _jsx(Skeleton, { className: "h-4 w-80" })] }), _jsxs("div", { className: "flex flex-wrap items-center justify-between gap-3", children: [_jsx(Skeleton, { className: "h-9 w-full max-w-sm" }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Skeleton, { className: "h-9 w-32" }), _jsx(Skeleton, { className: "h-9 w-36" })] })] }), _jsx("div", { className: "rounded-md border", children: _jsxs(Table, { children: [_jsx(TableHeader, { children: _jsxs(TableRow, { children: [_jsx(TableHead, { children: bookingMessages.tableBookingNumber }), _jsx(TableHead, { children: bookingMessages.tableStatus }), _jsx(TableHead, { children: bookingMessages.tableSellAmount }), _jsx(TableHead, { children: bookingMessages.tablePax }), _jsx(TableHead, { children: bookingMessages.tableStartDate })] }) }), _jsx(SkeletonRows, { rows: 8, widths: ["w-28", "w-20", "w-24", "w-6", "w-24"] })] }) }), _jsxs("div", { className: "flex items-center justify-between", children: [_jsx(Skeleton, { className: "h-4 w-40" }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Skeleton, { className: "h-8 w-20" }), _jsx(Skeleton, { className: "h-4 w-20" }), _jsx(Skeleton, { className: "h-8 w-16" })] })] })] }));
+}
+/** Placeholder `<TableBody>` with one skeleton line per cell. */
+function SkeletonRows({ rows, widths }) {
+    return (_jsx(TableBody, { children: Array.from({ length: rows }).map((_, r) => (_jsx(TableRow
+        // biome-ignore lint/suspicious/noArrayIndexKey: stable placeholders -- owner: bookings-react; existing suppression is intentional pending typed cleanup.
+        , { children: widths.map((width, c) => (_jsx(TableCell
+            // biome-ignore lint/suspicious/noArrayIndexKey: stable placeholders -- owner: bookings-react; existing suppression is intentional pending typed cleanup.
+            , { children: _jsx(Skeleton, { className: `h-4 ${width}` }) }, c))) }, r))) }));
+}

package/dist/admin/index.d.ts

@@ -0,0 +1,273 @@
+import { type AdminExtension } from "@voyant-travel/admin";
+import type { ComponentType, ReactNode } from "react";
+import { z } from "zod";
+import type { BookingDetailTabValue } from "../components/booking-detail-page.js";
+import type { BookingListFiltersState } from "../components/booking-list.js";
+/**
+ * Semantic destinations the bookings admin surfaces navigate to
+ * (packaged-admin RFC §4.7). The booking pages link into routes they do not
+ * own — the CRM person/organization pages, the product editor, the finance
+ * payment/invoice pages — so instead of importing a host route tree they
+ * resolve these keys through `useAdminHref`/`useAdminNavigate` from
+ * `@voyant-travel/admin`. Hosts register one resolver per key
+ * (`satisfies AdminDestinationResolvers`).
+ *
+ * `booking.detail`/`booking.list`/`booking.create` are declared here even
+ * though bookings pages are their first consumers: other domains' packaged
+ * pages navigate TO bookings through the same keys.
+ */
+declare module "@voyant-travel/admin" {
+    interface AdminDestinations {
+        /** The bookings list page. */
+        "booking.list": Record<string, never>;
+        /** A booking's detail page; `tab` deep-links a specific tab. */
+        "booking.detail": {
+            bookingId: string;
+            tab?: BookingDetailTabValue;
+        };
+        /** The "New booking" entry point (product picker → unified journey). */
+        "booking.create": Record<string, never>;
+        /** A CRM person's detail page. */
+        "person.detail": {
+            personId: string;
+        };
+        /** A CRM organization's detail page. */
+        "organization.detail": {
+            organizationId: string;
+        };
+        /**
+         * The owned-product editor/detail page. Also declared by
+         * `@voyant-travel/catalog-react/admin` — interface merging requires the member
+         * shape to stay identical across packages.
+         */
+        "product.detail": {
+            productId: string;
+        };
+        /** An availability slot's detail page. */
+        "availabilitySlot.detail": {
+            slotId: string;
+        };
+        /**
+         * The trips's "new trip" entry. Declared here because the
+         * packaged `/bookings/compose` alias route forwards to it — the composer
+         * pages themselves live in the trips area, whose admin entry
+         * may also declare this key (interface merging requires the member shape
+         * to stay identical across packages).
+         */
+        "trip.create": Record<string, never>;
+        /** A payment's detail page in the finance area. */
+        "payment.detail": {
+            paymentId: string;
+        };
+        /** An invoice's full detail page in the finance area. */
+        "invoice.detail": {
+            invoiceId: string;
+        };
+        /**
+         * A legal contract's detail page. Also declared by
+         * `@voyant-travel/legal-react/admin` — interface merging requires the member
+         * shape to stay identical across packages. Declared here because the
+         * booking Documents tab links contract rows to their detail page.
+         */
+        "contract.detail": {
+            contractId: string;
+        };
+    }
+}
+export type { BookingContractDialogProps } from "./booking-contract-dialog.js";
+export type { BookingDetailHostProps, BookingDetailHostSlot, BookingDetailHostSlotContext, BookingDetailHostSlots, } from "./booking-detail-host.js";
+export { BookingDetailSkeleton } from "./booking-detail-skeleton.js";
+export type { BookingDocumentsTableProps } from "./booking-documents-table.js";
+export type { BookingInvoiceSheetProps } from "./booking-invoice-sheet.js";
+export type { BookingJourneyHostProps } from "./booking-journey-host.js";
+export type { BookingsHostProps } from "./bookings-host.js";
+export { BookingsListSkeleton } from "./bookings-list-skeleton.js";
+export type { PersonBookingsWidgetProps } from "./person-bookings-widget.js";
+export { bookingDetailFinanceEndSlot, bookingDetailFinanceStartSlot, bookingDetailInvoicesTabSlot, } from "./slots.js";
+/**
+ * Search contract for the bookings list page: the URL projection of
+ * `BookingListFiltersState` (filters, sort, paging). Package-owned so the
+ * route file, the host, and the extension contribution validate the same
+ * shape. Defaults are absent from the URL — see
+ * {@link bookingsFiltersToSearch}.
+ */
+export declare const bookingsIndexSearchSchema: z.ZodObject<{
+    search: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodString>;
+    productId: z.ZodOptional<z.ZodString>;
+    optionId: z.ZodOptional<z.ZodString>;
+    supplierId: z.ZodOptional<z.ZodString>;
+    productCategoryId: z.ZodOptional<z.ZodString>;
+    personId: z.ZodOptional<z.ZodString>;
+    organizationId: z.ZodOptional<z.ZodString>;
+    availabilitySlotId: z.ZodOptional<z.ZodString>;
+    dateFrom: z.ZodOptional<z.ZodString>;
+    dateTo: z.ZodOptional<z.ZodString>;
+    paxMin: z.ZodOptional<z.ZodString>;
+    paxMax: z.ZodOptional<z.ZodString>;
+    sortBy: z.ZodOptional<z.ZodEnum<{
+        status: "status";
+        startDate: "startDate";
+        endDate: "endDate";
+        pax: "pax";
+        bookingNumber: "bookingNumber";
+        sellAmount: "sellAmount";
+        createdAt: "createdAt";
+    }>>;
+    sortDir: z.ZodOptional<z.ZodEnum<{
+        asc: "asc";
+        desc: "desc";
+    }>>;
+    offset: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+export type BookingsIndexSearchParams = z.infer<typeof bookingsIndexSearchSchema>;
+/** URL search params → `BookingList` initial state. Empty / `"all"` /
+ * default values are absent in the URL; we let `BookingList`'s defaults
+ * fill them in. */
+export declare function bookingsSearchToFilters(search: BookingsIndexSearchParams): Partial<BookingListFiltersState>;
+/** Project the filter snapshot back into URL search params, dropping
+ * any value that matches the component's default so the URL stays
+ * clean when the operator is viewing the unfiltered list. */
+export declare function bookingsFiltersToSearch(filters: BookingListFiltersState): BookingsIndexSearchParams;
+/** Tab values of the canonical `BookingDetailPage`, as a search-param schema. */
+export declare const bookingDetailTabSchema: z.ZodEnum<{
+    metadata: "metadata";
+    items: "items";
+    travelers: "travelers";
+    suppliers: "suppliers";
+    invoices: "invoices";
+    documents: "documents";
+    activity: "activity";
+    finance: "finance";
+}>;
+/**
+ * Search contract for the booking detail page. `productId`/`slotId` only
+ * matter for the `"new"` pseudo-id: a deep link with a product pre-chosen
+ * redirects into the unified booking journey (host route concern).
+ */
+export declare const bookingDetailSearchSchema: z.ZodObject<{
+    productId: z.ZodOptional<z.ZodString>;
+    slotId: z.ZodOptional<z.ZodString>;
+    tab: z.ZodOptional<z.ZodEnum<{
+        metadata: "metadata";
+        items: "items";
+        travelers: "travelers";
+        suppliers: "suppliers";
+        invoices: "invoices";
+        documents: "documents";
+        activity: "activity";
+        finance: "finance";
+    }>>;
+}, z.core.$strip>;
+export type BookingDetailSearchParams = z.infer<typeof bookingDetailSearchSchema>;
+/**
+ * Search contract for the packaged "New booking" entry page. A deep link
+ * with `productId` pre-chosen (e.g. launched from a product page) forwards
+ * straight into the unified booking journey; `slotId` pins the departure.
+ */
+export declare const bookingNewSearchSchema: z.ZodObject<{
+    productId: z.ZodOptional<z.ZodString>;
+    slotId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type BookingNewSearchParams = z.infer<typeof bookingNewSearchSchema>;
+/**
+ * Search contract for the unified booking journey page — the URL projection
+ * of the journey's entry state (provenance, pre-pinned departure/option/
+ * rate, side-panel preview hints). Key PRESENCE is meaningful: callers pass
+ * only the fields their selection actually carries.
+ */
+export declare const bookingJourneySearchSchema: z.ZodObject<{
+    sourceKind: z.ZodString;
+    sourceConnectionId: z.ZodOptional<z.ZodString>;
+    sourceRef: z.ZodOptional<z.ZodString>;
+    departureId: z.ZodOptional<z.ZodString>;
+    departureDate: z.ZodOptional<z.ZodString>;
+    optionId: z.ZodOptional<z.ZodString>;
+    roomTypeId: z.ZodOptional<z.ZodString>;
+    ratePlanId: z.ZodOptional<z.ZodString>;
+    board: z.ZodOptional<z.ZodString>;
+    entityName: z.ZodOptional<z.ZodString>;
+    entityImageUrl: z.ZodOptional<z.ZodString>;
+    draftId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type BookingJourneySearchParams = z.infer<typeof bookingJourneySearchSchema>;
+/**
+ * Props contract of the booking detail PAGE component the "bookings-detail"
+ * contribution mounts — the route-state subset of `BookingDetailHostProps`.
+ * The packaged default wraps {@link BookingDetailHost} with exactly these;
+ * hosts substitute their own implementation via
+ * {@link CreateBookingsAdminExtensionOptions.detailPageComponent} when they
+ * need to compose app-owned flows around the host (e.g. payment dialogs).
+ */
+export interface BookingDetailPageComponentProps {
+    id: string;
+    activeTab?: BookingDetailTabValue;
+    onTabChange?: (tab: BookingDetailTabValue) => void;
+}
+export interface CreateBookingsAdminExtensionOptions {
+    /** Mount path of the bookings pages inside the admin workspace. Default `/bookings`. */
+    basePath?: string;
+    /** Localized page titles. Defaults are the English operator nav labels. */
+    labels?: {
+        bookings?: string;
+    };
+    /**
+     * App-owned extra header action(s) rendered alongside the bookings list's
+     * primary "New booking" button (e.g. the operator's "Compose trip" link).
+     * Forwarded to {@link BookingsHost}'s `headerActions` by the index page so
+     * the packaged page doesn't hardcode other domains.
+     */
+    indexHeaderActions?: ReactNode;
+    /**
+     * Substitute implementation for the booking detail page, loaded lazily so
+     * it stays in its own chunk. Defaults to the packaged page wrapping
+     * {@link BookingDetailHost}. The operator overrides this to compose the
+     * app-owned payment/payment-link dialogs around the host — those dialogs
+     * live app-side because `@voyant-travel/finance-react/ui` and
+     * `@voyant-travel/finance-react/checkout-ui` depend on this package, so importing them
+     * here would be a cycle.
+     */
+    detailPageComponent?: () => Promise<{
+        default: ComponentType<BookingDetailPageComponentProps>;
+    }>;
+}
+/**
+ * The bookings admin contribution (packaged-admin RFC Phase 3,
+ * `@voyant-travel/<domain>-ui/admin` convention).
+ *
+ * NAVIGATION: deliberately none. The Bookings nav item is part of the BASE
+ * operator navigation — see `createOperatorAdminNavigation` in
+ * `@voyant-travel/admin` — so contributing nav entries here would duplicate it.
+ * If the base nav ever drops the bookings item, this extension is where the
+ * entry moves.
+ *
+ * ROUTES: full implementations (packaged-admin RFC §4.8) — the package-owned
+ * search contracts ({@link bookingsIndexSearchSchema} for the list,
+ * {@link bookingDetailSearchSchema} for the detail page), loaders that
+ * prefetch through the host-supplied runtime, and lazy `page` modules. The
+ * PAGES are package-owned too: {@link BookingsHost} and
+ * {@link BookingDetailHost} bind the canonical bookings pages to their data
+ * wiring (bookings/finance provider context) and resolve every cross-route
+ * link through the semantic destinations declared above — no app RPC client,
+ * no host route tree.
+ *
+ * `component:` stays unattached; each contribution carries a lazy `page`
+ * loader instead. The host binder wraps it in the router's lazy-component
+ * machinery (so the page lands in its own chunk) and hands the resolved
+ * component its route state as `AdminRoutePageProps` — which is how the
+ * param/search-taking bookings pages mount without a host route file. The
+ * `page` thunks below dynamically import the SPECIFIC page modules, never
+ * this barrel, so the factory itself never pins page code into the
+ * workspace-chrome chunk.
+ *
+ * WIDGETS: the crm-ui ↔ bookings-ui cycle resolution (RFC §4.7). The CRM
+ * person detail page mounts a Bookings tab, but this package depends on
+ * `@voyant-travel/relationships-react/ui`, so crm-ui's host cannot import the bookings-owned
+ * card. Instead this extension contributes {@link PersonBookingsWidget} on
+ * the `person.details.bookings-tab` slot crm-ui's `PersonDetailHost`
+ * exposes; the host mounts its Bookings tab whenever a contribution targets
+ * that slot and hands the widget its typed slot context
+ * (`PersonDetailBookingsTabContext`) as props.
+ */
+export declare function createBookingsAdminExtension(options?: CreateBookingsAdminExtensionOptions): AdminExtension;
+//# sourceMappingURL=index.d.ts.map

package/dist/admin/index.d.ts.map

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