@voyant-travel/catalog-react 0.117.2

package/dist/admin/scheduled-catalog-host.d.ts

@@ -0,0 +1,15 @@
+import { type ScheduledScope } from "../components/scheduled-catalog-page.js";
+import type { CatalogSearchParams } from "../index.js";
+export interface ScheduledCatalogHostProps {
+    scope: ScheduledScope;
+    search: CatalogSearchParams;
+    onSearchChange: (updater: (prev: CatalogSearchParams) => CatalogSearchParams, replace?: boolean) => void;
+}
+/**
+ * Packaged admin host for `ScheduledCatalogPage` — supplies the localized
+ * title/tagline and renders `CatalogVerticalHost` (markets/suppliers/products
+ * wiring) as the embedded browse grid, opening each result's vertical detail
+ * page (the `catalog.detail` destination) in a new tab on click.
+ */
+export declare function ScheduledCatalogHost({ scope, search, onSearchChange }: ScheduledCatalogHostProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=scheduled-catalog-host.d.ts.map

package/dist/admin/scheduled-catalog-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduled-catalog-host.d.ts","sourceRoot":"","sources":["../../src/admin/scheduled-catalog-host.tsx"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,yCAAyC,CAAA;AAChD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAItD,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,cAAc,CAAA;IACrB,MAAM,EAAE,mBAAmB,CAAA;IAC3B,cAAc,EAAE,CACd,OAAO,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,mBAAmB,EAC3D,OAAO,CAAC,EAAE,OAAO,KACd,IAAI,CAAA;CACV;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,EAAE,yBAAyB,2CA0BhG"}

package/dist/admin/scheduled-catalog-host.js

@@ -0,0 +1,19 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useAdminHref, useOperatorAdminMessages } from "@voyant-travel/admin";
+import { ScheduledCatalogPage as ScheduledCatalogPageUi, } from "../components/scheduled-catalog-page.js";
+import { CatalogVerticalHost } from "./catalog-vertical-host.js";
+import { openHrefInNewTab } from "./open-in-new-tab.js";
+/**
+ * Packaged admin host for `ScheduledCatalogPage` — supplies the localized
+ * title/tagline and renders `CatalogVerticalHost` (markets/suppliers/products
+ * wiring) as the embedded browse grid, opening each result's vertical detail
+ * page (the `catalog.detail` destination) in a new tab on click.
+ */
+export function ScheduledCatalogHost({ scope, search, onSearchChange }) {
+    const resolveHref = useAdminHref();
+    const nav = useOperatorAdminMessages().nav;
+    const title = scope === "excursions" ? nav.catalogExcursions : nav.catalogTours;
+    const subtitle = scope === "excursions" ? nav.catalogExcursionsTagline : nav.catalogToursTagline;
+    return (_jsx(ScheduledCatalogPageUi, { scope: scope, title: title, subtitle: subtitle, renderBrowseGrid: ({ lockedFacets, lockedRanges }) => (_jsx(CatalogVerticalHost, { vertical: "products", search: search, onSearchChange: onSearchChange, embedded: true, lockedFacets: lockedFacets, lockedRanges: lockedRanges, onOpenDetail: (hit) => openHrefInNewTab(resolveHref("catalog.detail", { surface: scope, id: hit.id })) })) }));
+}

package/dist/admin/vertical-detail-host.d.ts

@@ -0,0 +1,13 @@
+import { type CatalogDetailSurface } from "../catalog-surfaces.js";
+export interface VerticalDetailHostProps {
+    surface: CatalogDetailSurface;
+    id: string;
+}
+/**
+ * Packaged admin host for `CatalogVerticalDetailPage` — binds the supplier
+ * directory, the localized surface label, semantic-destination navigation
+ * into the booking journey (packaged-admin RFC §4.7), and breadcrumbs, so
+ * host route files stay trivial.
+ */
+export declare function VerticalDetailHost({ surface, id }: VerticalDetailHostProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=vertical-detail-host.d.ts.map

package/dist/admin/vertical-detail-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vertical-detail-host.d.ts","sourceRoot":"","sources":["../../src/admin/vertical-detail-host.tsx"],"names":[],"mappings":"AAWA,OAAO,EAAE,KAAK,oBAAoB,EAA0B,MAAM,wBAAwB,CAAA;AAM1F,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,oBAAoB,CAAA;IAC7B,EAAE,EAAE,MAAM,CAAA;CACX;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,uBAAuB,2CA+C1E"}

package/dist/admin/vertical-detail-host.js

@@ -0,0 +1,62 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useAdminBreadcrumbs, useAdminHref, useAdminNavigate, useOperatorAdminMessages, } from "@voyant-travel/admin";
+import { useSuppliers } from "@voyant-travel/distribution-react/suppliers";
+import { useMemo, useState } from "react";
+import { catalogSurfaceVertical } from "../catalog-surfaces.js";
+import { CatalogVerticalDetailPage, } from "../components/catalog-vertical-detail-page.js";
+/**
+ * Packaged admin host for `CatalogVerticalDetailPage` — binds the supplier
+ * directory, the localized surface label, semantic-destination navigation
+ * into the booking journey (packaged-admin RFC §4.7), and breadcrumbs, so
+ * host route files stay trivial.
+ */
+export function VerticalDetailHost({ surface, id }) {
+    const resolveHref = useAdminHref();
+    const navigateTo = useAdminNavigate();
+    const nav = useOperatorAdminMessages().nav;
+    const vertical = catalogSurfaceVertical(surface);
+    const surfaceLabel = surfaceTitle(surface, nav);
+    const surfaceHref = resolveHref("catalog.browse", { surface });
+    const suppliersQuery = useSuppliers({ limit: 100 });
+    const formatSupplier = useMemo(() => {
+        const m = new Map();
+        for (const sup of suppliersQuery.data?.data ?? [])
+            m.set(sup.id, sup.name);
+        return (sid) => m.get(String(sid)) ?? String(sid);
+    }, [suppliersQuery.data]);
+    // The packaged page resolves the title from content; mirror its breadcrumbs
+    // into the admin breadcrumb bar.
+    const [crumbs, setCrumbs] = useState([
+        { label: surfaceLabel, href: surfaceHref },
+    ]);
+    useAdminBreadcrumbs(crumbs);
+    return (_jsx(CatalogVerticalDetailPage, { id: id, vertical: vertical, surfaceLabel: surfaceLabel, surfaceHref: surfaceHref, formatSupplier: formatSupplier, onBreadcrumbs: setCrumbs, 
+        // Connect-sourced vertical (accommodation/excursion/tour) → the unified
+        // journey. The picked departure's date locks the departure step; name/hero
+        // preview the panel.
+        onBook: (entityModule, entityId, opts) => navigateTo("bookingJourney.start", {
+            entityModule,
+            entityId,
+            sourceKind: "voyant-connect",
+            ...(opts.departureId ? { departureId: opts.departureId } : {}),
+            ...(opts.departureDate ? { departureDate: opts.departureDate.slice(0, 10) } : {}),
+            ...(opts.optionId ? { optionId: opts.optionId } : {}),
+            ...(opts.name ? { entityName: opts.name } : {}),
+            ...(opts.heroImageUrl ? { entityImageUrl: opts.heroImageUrl } : {}),
+        }) }));
+}
+function surfaceTitle(surface, nav) {
+    switch (surface) {
+        case "cruises":
+            return nav.catalogCruises;
+        case "accommodations":
+            return nav.catalogAccommodations;
+        case "excursions":
+            return nav.catalogExcursions;
+        case "tours":
+            return nav.catalogTours;
+        default:
+            return nav.catalogProducts;
+    }
+}

package/dist/booking-engine/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * `@voyant-travel/catalog-react/booking-engine` — React Query hooks
+ * driving the unified booking journey shell.
+ *
+ * Per `docs/architecture/booking-journey-architecture.md` §8.1.
+ *
+ * Hooks:
+ *   - `useBookingDraft`       — local draft state with server sync
+ *   - `useBookingQuote`       — debounced live quote on draft change
+ *   - `useBookingDraftShape`  — convenience accessor on the latest quote
+ *   - `useBookingCommit`      — final book mutation, triggers handoff
+ *
+ * The hooks share a `useBookingJourneyApi()` accessor that derives
+ * the API base from the surrounding `VoyantCatalogProvider` and
+ * lets callers override the surface (`/v1/admin` vs `/v1/public`).
+ *
+ * Identical surface for operator and storefront — Phase B's "build
+ * once, ship everywhere" rule (§ Rule 4).
+ */
+export { type UseBookingCommitOptions, useBookingCommit, } from "./use-booking-commit.js";
+export { type UseBookingDraftOptions, useBookingDraft, } from "./use-booking-draft.js";
+export { type UseBookingDraftShapeOptions, useBookingDraftShape, } from "./use-booking-draft-shape.js";
+export { type PlaceHoldInput, type ReleaseHoldInput, useBookingHold, } from "./use-booking-hold.js";
+export { type BookingJourneyApiOptions, type UseBookingJourneyApi, useBookingJourneyApi, } from "./use-booking-journey-api.js";
+export { type UseBookingQuoteOptions, useBookingQuote, } from "./use-booking-quote.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/booking-engine/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/booking-engine/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EACL,KAAK,uBAAuB,EAC5B,gBAAgB,GACjB,MAAM,yBAAyB,CAAA;AAChC,OAAO,EACL,KAAK,sBAAsB,EAC3B,eAAe,GAChB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACL,KAAK,2BAA2B,EAChC,oBAAoB,GACrB,MAAM,8BAA8B,CAAA;AACrC,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,cAAc,GACf,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,oBAAoB,GACrB,MAAM,8BAA8B,CAAA;AACrC,OAAO,EACL,KAAK,sBAAsB,EAC3B,eAAe,GAChB,MAAM,wBAAwB,CAAA"}

package/dist/booking-engine/index.js

@@ -0,0 +1,25 @@
+/**
+ * `@voyant-travel/catalog-react/booking-engine` — React Query hooks
+ * driving the unified booking journey shell.
+ *
+ * Per `docs/architecture/booking-journey-architecture.md` §8.1.
+ *
+ * Hooks:
+ *   - `useBookingDraft`       — local draft state with server sync
+ *   - `useBookingQuote`       — debounced live quote on draft change
+ *   - `useBookingDraftShape`  — convenience accessor on the latest quote
+ *   - `useBookingCommit`      — final book mutation, triggers handoff
+ *
+ * The hooks share a `useBookingJourneyApi()` accessor that derives
+ * the API base from the surrounding `VoyantCatalogProvider` and
+ * lets callers override the surface (`/v1/admin` vs `/v1/public`).
+ *
+ * Identical surface for operator and storefront — Phase B's "build
+ * once, ship everywhere" rule (§ Rule 4).
+ */
+export { useBookingCommit, } from "./use-booking-commit.js";
+export { useBookingDraft, } from "./use-booking-draft.js";
+export { useBookingDraftShape, } from "./use-booking-draft-shape.js";
+export { useBookingHold, } from "./use-booking-hold.js";
+export { useBookingJourneyApi, } from "./use-booking-journey-api.js";
+export { useBookingQuote, } from "./use-booking-quote.js";

package/dist/booking-engine/use-booking-commit.d.ts

@@ -0,0 +1,61 @@
+import { type BookingDraftV1, type BookingPaymentIntent, type BookResponseV1 } from "@voyant-travel/catalog-contracts/booking-engine/contracts";
+import { type BookingJourneyApiOptions } from "./use-booking-journey-api.js";
+export interface UseBookingCommitOptions extends BookingJourneyApiOptions {
+    /** Draft id — when set, the engine resolves the quote off the draft
+     *  and the draft is marked consumed on success. */
+    draftId?: string;
+    /** Optional callback fired on successful commit. Templates use this
+     *  for post-commit navigation (operator → /orders, storefront →
+     *  /confirmation). */
+    onCommitted?: (result: BookResponseV1) => void;
+}
+export interface CommitInput {
+    /** Either-or: pass the draft for context-aware commit, or just a
+     *  quoteId when the journey hasn't materialized a draft yet. */
+    draft?: BookingDraftV1;
+    quoteId?: string;
+    party?: Record<string, unknown>;
+    paymentIntent?: BookingPaymentIntent;
+    /** Initial booking status the owned handler should land on (draft /
+     *  awaiting_payment / confirmed). When omitted, the create defaults to draft. */
+    initialStatus?: string;
+    /** Idempotency key — same key in 24h returns the existing booking. */
+    idempotencyKey?: string;
+}
+/**
+ * Final book mutation — calls `POST /catalog/book` with the chosen
+ * quoteId or draftId. The wizard's Review step calls this when the
+ * user clicks Confirm. Per booking-journey-architecture §8 + §10
+ * Phase B.
+ */
+export declare function useBookingCommit(options?: UseBookingCommitOptions): import("@tanstack/react-query").UseMutationResult<{
+    bookingId: string;
+    orderRef: string;
+    status: "failed" | "confirmed" | "held" | "ticketed";
+    snapshotId: string;
+    pricing?: {
+        currency: string;
+        lines: {
+            kind: "base" | "accommodation" | "fee" | "discount" | "addon" | "supplement";
+            label: string;
+            unitAmount: number;
+            totalAmount: number;
+            quantity?: number | undefined;
+            taxIncluded?: boolean | undefined;
+        }[];
+        taxes: {
+            code: string;
+            label: string;
+            rate: number;
+            amount: number;
+            base: number;
+            includedInPrice?: boolean | undefined;
+            scope?: "included" | "excluded" | "withheld" | undefined;
+        }[];
+        subtotal: number;
+        taxTotal: number;
+        total: number;
+    } | undefined;
+    upstreamPayload?: Record<string, unknown> | undefined;
+}, Error, CommitInput, unknown>;
+//# sourceMappingURL=use-booking-commit.d.ts.map

package/dist/booking-engine/use-booking-commit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-booking-commit.d.ts","sourceRoot":"","sources":["../../src/booking-engine/use-booking-commit.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EAEpB,MAAM,2DAA2D,CAAA;AAElE,OAAO,EAAE,KAAK,wBAAwB,EAAwB,MAAM,8BAA8B,CAAA;AAElG,MAAM,WAAW,uBAAwB,SAAQ,wBAAwB;IACvE;uDACmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;0BAEsB;IACtB,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAA;CAC/C;AAED,MAAM,WAAW,WAAW;IAC1B;oEACgE;IAChE,KAAK,CAAC,EAAE,cAAc,CAAA;IACtB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,aAAa,CAAC,EAAE,oBAAoB,CAAA;IACpC;qFACiF;IACjF,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCA+BrE"}

package/dist/booking-engine/use-booking-commit.js

@@ -0,0 +1,47 @@
+"use client";
+import { useMutation } from "@tanstack/react-query";
+import { bookResponseV1, } from "@voyant-travel/catalog-contracts/booking-engine/contracts";
+import { useBookingJourneyApi } from "./use-booking-journey-api.js";
+/**
+ * Final book mutation — calls `POST /catalog/book` with the chosen
+ * quoteId or draftId. The wizard's Review step calls this when the
+ * user clicks Confirm. Per booking-journey-architecture §8 + §10
+ * Phase B.
+ */
+export function useBookingCommit(options = {}) {
+    const api = useBookingJourneyApi(options);
+    return useMutation({
+        mutationFn: async (input) => {
+            // Auto-generate an idempotency key when the caller didn't pass
+            // one — protects against double-clicks. The key is stable for
+            // the lifetime of the mutation function call (one user click =
+            // one key); a manual retry from the journey shell uses the same
+            // key by passing it explicitly.
+            const idempotencyKey = input.idempotencyKey ?? generateIdempotencyKey(input.draft?.entity?.id ?? input.quoteId);
+            const body = {
+                quoteId: input.quoteId ?? input.draft?.quoteId,
+                draftId: options.draftId,
+                party: input.party,
+                paymentIntent: input.paymentIntent,
+                idempotencyKey,
+            };
+            if (input.draft || input.initialStatus) {
+                body.parameters = {
+                    ...(input.draft ? { draft: input.draft } : {}),
+                    ...(input.initialStatus ? { initialStatus: input.initialStatus } : {}),
+                };
+            }
+            return api.request("POST", "/book", bookResponseV1, body);
+        },
+        onSuccess(result) {
+            options.onCommitted?.(result);
+        },
+    });
+}
+function generateIdempotencyKey(seed) {
+    const base = seed ?? "anon";
+    if (typeof globalThis.crypto !== "undefined" && globalThis.crypto.randomUUID) {
+        return `${base.slice(0, 32)}_${globalThis.crypto.randomUUID().replace(/-/g, "")}`;
+    }
+    return `${base.slice(0, 32)}_${Date.now().toString(36)}${Math.random().toString(36).slice(2, 12)}`;
+}

package/dist/booking-engine/use-booking-draft-shape.d.ts

@@ -0,0 +1,20 @@
+import type { BookingDraftShape } from "@voyant-travel/catalog-contracts/booking-engine/draft-shape";
+import type { BookingJourneyApiOptions } from "./use-booking-journey-api.js";
+export interface UseBookingDraftShapeOptions extends BookingJourneyApiOptions {
+    /** Quote response — typically passed in from the wrapping
+     *  `useBookingQuote()`. */
+    quote: {
+        shape?: BookingDraftShape;
+    } | null;
+    /** Fallback shape rendered when the quote hasn't loaded yet — the
+     *  journey shell uses this so the wizard renders an empty Configure
+     *  step on first paint. */
+    fallback: BookingDraftShape;
+}
+/**
+ * Convenience accessor that returns the descriptor a quote response
+ * carries — or a caller-supplied fallback while we wait for the
+ * first quote. Per booking-journey-architecture §3 + §8.1.
+ */
+export declare function useBookingDraftShape(options: UseBookingDraftShapeOptions): BookingDraftShape;
+//# sourceMappingURL=use-booking-draft-shape.d.ts.map

package/dist/booking-engine/use-booking-draft-shape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-booking-draft-shape.d.ts","sourceRoot":"","sources":["../../src/booking-engine/use-booking-draft-shape.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6DAA6D,CAAA;AAEpG,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAA;AAE5E,MAAM,WAAW,2BAA4B,SAAQ,wBAAwB;IAC3E;+BAC2B;IAC3B,KAAK,EAAE;QAAE,KAAK,CAAC,EAAE,iBAAiB,CAAA;KAAE,GAAG,IAAI,CAAA;IAC3C;;+BAE2B;IAC3B,QAAQ,EAAE,iBAAiB,CAAA;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,iBAAiB,CAE5F"}

package/dist/booking-engine/use-booking-draft-shape.js

@@ -0,0 +1,9 @@
+"use client";
+/**
+ * Convenience accessor that returns the descriptor a quote response
+ * carries — or a caller-supplied fallback while we wait for the
+ * first quote. Per booking-journey-architecture §3 + §8.1.
+ */
+export function useBookingDraftShape(options) {
+    return options.quote?.shape ?? options.fallback;
+}

package/dist/booking-engine/use-booking-draft.d.ts

@@ -0,0 +1,102 @@
+import { type BookingDraftV1 } from "@voyant-travel/catalog-contracts/booking-engine/contracts";
+import { z } from "zod";
+import { type BookingJourneyApiOptions } from "./use-booking-journey-api.js";
+declare const draftRowSchema: z.ZodObject<{
+    id: z.ZodString;
+    entity_module: z.ZodString;
+    entity_id: z.ZodString;
+    source_kind: z.ZodString;
+    source_connection_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    source_ref: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    draft_payload: z.ZodUnknown;
+    current_step: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    current_quote_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    hold_expires_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    consumed_booking_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    consumed_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    expires_at: z.ZodString;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+}, z.core.$strip>;
+export type DraftRow = z.infer<typeof draftRowSchema>;
+export interface UseBookingDraftOptions extends BookingJourneyApiOptions {
+    /** Stable draft id — caller generates and persists in URL or
+     *  sessionStorage. */
+    draftId: string;
+    /** Initial entity pointer, required on first PUT. */
+    initialDraft?: BookingDraftV1;
+    /** Disable the GET — useful when the draft was just minted client-side. */
+    enableLoad?: boolean;
+}
+/**
+ * Server-synced booking draft state. Calls GET on mount (when
+ * `enableLoad`) and exposes a `save(draft)` mutation that PUTs
+ * to `/catalog/drafts/:id`.
+ *
+ * The mutation is fire-and-forget from the wizard's perspective —
+ * the journey root holds the local draft as the source of truth and
+ * the server copy is a recovery surface. Per
+ * booking-journey-architecture §5.7.
+ */
+export declare function useBookingDraft(options: UseBookingDraftOptions): {
+    /** Server-side draft row, or null when missing / 404. */
+    serverDraft: {
+        id: string;
+        entity_module: string;
+        entity_id: string;
+        source_kind: string;
+        draft_payload: unknown;
+        expires_at: string;
+        created_at: string;
+        updated_at: string;
+        source_connection_id?: string | null | undefined;
+        source_ref?: string | null | undefined;
+        current_step?: string | null | undefined;
+        current_quote_id?: string | null | undefined;
+        hold_expires_at?: string | null | undefined;
+        consumed_booking_id?: string | null | undefined;
+        consumed_at?: string | null | undefined;
+    } | null;
+    isLoading: boolean;
+    save: import("@tanstack/react-query").UseMutationResult<{
+        id: string;
+        entity_module: string;
+        entity_id: string;
+        source_kind: string;
+        draft_payload: unknown;
+        expires_at: string;
+        created_at: string;
+        updated_at: string;
+        source_connection_id?: string | null | undefined;
+        source_ref?: string | null | undefined;
+        current_step?: string | null | undefined;
+        current_quote_id?: string | null | undefined;
+        hold_expires_at?: string | null | undefined;
+        consumed_booking_id?: string | null | undefined;
+        consumed_at?: string | null | undefined;
+    }, Error, {
+        draft: BookingDraftV1;
+        currentStep?: string;
+        currentQuoteId?: string;
+    }, unknown>;
+    remove: import("@tanstack/react-query").UseMutationResult<void, Error, void, unknown>;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<{
+        id: string;
+        entity_module: string;
+        entity_id: string;
+        source_kind: string;
+        draft_payload: unknown;
+        expires_at: string;
+        created_at: string;
+        updated_at: string;
+        source_connection_id?: string | null | undefined;
+        source_ref?: string | null | undefined;
+        current_step?: string | null | undefined;
+        current_quote_id?: string | null | undefined;
+        hold_expires_at?: string | null | undefined;
+        consumed_booking_id?: string | null | undefined;
+        consumed_at?: string | null | undefined;
+    } | null, Error>>;
+};
+export {};
+//# sourceMappingURL=use-booking-draft.d.ts.map

package/dist/booking-engine/use-booking-draft.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-booking-draft.d.ts","sourceRoot":"","sources":["../../src/booking-engine/use-booking-draft.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,cAAc,EAEpB,MAAM,2DAA2D,CAAA;AAClE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,KAAK,wBAAwB,EAAwB,MAAM,8BAA8B,CAAA;AAElG,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;iBAgBlB,CAAA;AAEF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAErD,MAAM,WAAW,sBAAuB,SAAQ,wBAAwB;IACtE;0BACsB;IACtB,OAAO,EAAE,MAAM,CAAA;IACf,qDAAqD;IACrD,YAAY,CAAC,EAAE,cAAc,CAAA;IAC7B,2EAA2E;IAC3E,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB;IA4D3D,yDAAyD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eAtChD,cAAc;sBACP,MAAM;yBACH,MAAM;;;;;;;;;;;;;;;;;;;;EA2C5B"}

package/dist/booking-engine/use-booking-draft.js

@@ -0,0 +1,93 @@
+"use client";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { bookingDraftV1, } from "@voyant-travel/catalog-contracts/booking-engine/contracts";
+import { z } from "zod";
+import { useBookingJourneyApi } from "./use-booking-journey-api.js";
+const draftRowSchema = z.object({
+    id: z.string(),
+    entity_module: z.string(),
+    entity_id: z.string(),
+    source_kind: z.string(),
+    source_connection_id: z.string().nullable().optional(),
+    source_ref: z.string().nullable().optional(),
+    draft_payload: z.unknown(),
+    current_step: z.string().nullable().optional(),
+    current_quote_id: z.string().nullable().optional(),
+    hold_expires_at: z.string().nullable().optional(),
+    consumed_booking_id: z.string().nullable().optional(),
+    consumed_at: z.string().nullable().optional(),
+    expires_at: z.string(),
+    created_at: z.string(),
+    updated_at: z.string(),
+});
+/**
+ * Server-synced booking draft state. Calls GET on mount (when
+ * `enableLoad`) and exposes a `save(draft)` mutation that PUTs
+ * to `/catalog/drafts/:id`.
+ *
+ * The mutation is fire-and-forget from the wizard's perspective —
+ * the journey root holds the local draft as the source of truth and
+ * the server copy is a recovery surface. Per
+ * booking-journey-architecture §5.7.
+ */
+export function useBookingDraft(options) {
+    const api = useBookingJourneyApi(options);
+    const queryClient = useQueryClient();
+    const queryKey = ["booking-draft", options.surface ?? "admin", options.draftId];
+    const query = useQuery({
+        queryKey,
+        queryFn: async () => {
+            try {
+                return await api.request("GET", `/drafts/${options.draftId}`, draftRowSchema);
+            }
+            catch (err) {
+                if (err instanceof Error && err.message.includes("404"))
+                    return null;
+                throw err;
+            }
+        },
+        enabled: options.enableLoad !== false,
+    });
+    const save = useMutation({
+        mutationFn: async ({ draft, currentStep, currentQuoteId }) => {
+            bookingDraftV1.parse(draft);
+            const body = {
+                entityModule: draft.entity.module,
+                entityId: draft.entity.id,
+                draftPayload: draft,
+                currentStep,
+                currentQuoteId,
+            };
+            // Only send the source pointer fields when present. They're optional but
+            // non-empty when set (`z.string().min(1).optional()`); an empty string —
+            // which is what a server-resolved-provenance draft carries — would fail
+            // validation. Mirrors the quote hook's guarding.
+            if (draft.entity.sourceKind)
+                body.sourceKind = draft.entity.sourceKind;
+            if (draft.entity.sourceConnectionId)
+                body.sourceConnectionId = draft.entity.sourceConnectionId;
+            if (draft.entity.sourceRef)
+                body.sourceRef = draft.entity.sourceRef;
+            return api.request("PUT", `/drafts/${options.draftId}`, draftRowSchema, body);
+        },
+        onSuccess(row) {
+            queryClient.setQueryData(queryKey, row);
+        },
+    });
+    const remove = useMutation({
+        mutationFn: async () => {
+            await api.request("DELETE", `/drafts/${options.draftId}`, z.undefined());
+        },
+        onSuccess() {
+            queryClient.setQueryData(queryKey, null);
+        },
+    });
+    return {
+        /** Server-side draft row, or null when missing / 404. */
+        serverDraft: query.data ?? null,
+        isLoading: query.isLoading,
+        save,
+        remove,
+        refetch: query.refetch,
+    };
+}

package/dist/booking-engine/use-booking-hold.d.ts

@@ -0,0 +1,30 @@
+import { type BookingJourneyApiOptions } from "./use-booking-journey-api.js";
+export interface PlaceHoldInput {
+    entityModule: string;
+    entityId: string;
+    draftId: string;
+    ttlMs?: number;
+    parameters?: Record<string, unknown>;
+}
+export interface ReleaseHoldInput {
+    entityModule: string;
+    holdToken: string;
+}
+/**
+ * Place an inventory soft-hold against the engine. Per
+ * booking-journey-architecture §5.7 — the journey calls this once
+ * the user has picked a slot + pax in the Configure step so
+ * concurrent shoppers can't oversell capacity.
+ *
+ * The bound mutation also exposes a `release` helper for the cancel
+ * path; the reaper covers expiry without explicit calls.
+ */
+export declare function useBookingHold(options?: BookingJourneyApiOptions): {
+    place: (input: PlaceHoldInput) => Promise<{
+        holdToken: string;
+        expiresAt: string;
+    }>;
+    release: (input: ReleaseHoldInput) => Promise<void>;
+    isPending: boolean;
+};
+//# sourceMappingURL=use-booking-hold.d.ts.map

package/dist/booking-engine/use-booking-hold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-booking-hold.d.ts","sourceRoot":"","sources":["../../src/booking-engine/use-booking-hold.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,wBAAwB,EAAwB,MAAM,8BAA8B,CAAA;AAOlG,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACrC;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,wBAA6B,GAAG;IACtE,KAAK,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACnF,OAAO,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACnD,SAAS,EAAE,OAAO,CAAA;CACnB,CA6BA"}

package/dist/booking-engine/use-booking-hold.js

@@ -0,0 +1,44 @@
+"use client";
+import { useMutation } from "@tanstack/react-query";
+import { z } from "zod";
+import { useBookingJourneyApi } from "./use-booking-journey-api.js";
+const placeHoldResponseSchema = z.object({
+    holdToken: z.string(),
+    expiresAt: z.string().datetime(),
+});
+/**
+ * Place an inventory soft-hold against the engine. Per
+ * booking-journey-architecture §5.7 — the journey calls this once
+ * the user has picked a slot + pax in the Configure step so
+ * concurrent shoppers can't oversell capacity.
+ *
+ * The bound mutation also exposes a `release` helper for the cancel
+ * path; the reaper covers expiry without explicit calls.
+ */
+export function useBookingHold(options = {}) {
+    const api = useBookingJourneyApi(options);
+    const place = useMutation({
+        mutationFn: async (input) => {
+            return api.request("POST", "/holds/place", placeHoldResponseSchema, {
+                entityModule: input.entityModule,
+                entityId: input.entityId,
+                draftId: input.draftId,
+                ttlMs: input.ttlMs,
+                parameters: input.parameters,
+            });
+        },
+    });
+    const release = useMutation({
+        mutationFn: async (input) => {
+            await api.request("POST", "/holds/release", z.undefined(), {
+                entityModule: input.entityModule,
+                holdToken: input.holdToken,
+            });
+        },
+    });
+    return {
+        place: (input) => place.mutateAsync(input),
+        release: (input) => release.mutateAsync(input),
+        isPending: place.isPending || release.isPending,
+    };
+}

package/dist/booking-engine/use-booking-journey-api.d.ts

@@ -0,0 +1,23 @@
+import type { z } from "zod";
+import { type VoyantFetcher } from "../client.js";
+export interface BookingJourneyApiOptions {
+    /**
+     * Surface to call against. Operator passes `"admin"`; storefront /
+     * partner / embedded surfaces pass `"public"`. Switches the base
+     * path between `/v1/admin/catalog` and `/v1/public/catalog`.
+     */
+    surface?: "admin" | "public";
+    /** Override the API base URL pulled from VoyantCatalogProvider. */
+    baseUrl?: string;
+    /** Override the fetcher pulled from VoyantCatalogProvider. */
+    fetcher?: VoyantFetcher;
+}
+export interface UseBookingJourneyApi {
+    /** Resolved base URL for catalog booking-engine endpoints. */
+    apiBase: string;
+    fetcher: VoyantFetcher;
+    /** GET / POST / PUT / DELETE wrappers with Zod-validated responses. */
+    request<TOut>(method: "GET" | "POST" | "PUT" | "DELETE", path: string, schema: z.ZodType<TOut>, body?: unknown): Promise<TOut>;
+}
+export declare function useBookingJourneyApi(options?: BookingJourneyApiOptions): UseBookingJourneyApi;
+//# sourceMappingURL=use-booking-journey-api.d.ts.map

package/dist/booking-engine/use-booking-journey-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-booking-journey-api.d.ts","sourceRoot":"","sources":["../../src/booking-engine/use-booking-journey-api.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAC5B,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,cAAc,CAAA;AAGrB,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAA;IAC5B,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,aAAa,CAAA;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,aAAa,CAAA;IACtB,uEAAuE;IACvE,OAAO,CAAC,IAAI,EACV,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,EACzC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EACvB,IAAI,CAAC,EAAE,OAAO,GACb,OAAO,CAAC,IAAI,CAAC,CAAA;CACjB;AAED,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,wBAA6B,GAAG,oBAAoB,CAuBjG"}