@voyant-travel/bookings-react 0.119.3

package/dist/hooks/use-booking-action-ledger.d.ts

@@ -0,0 +1,63 @@
+export interface UseBookingActionLedgerOptions {
+    /** Page size; the server defaults to 50. */
+    limit?: number;
+    enabled?: boolean;
+}
+/**
+ * Cursor-paged central action-ledger feed for a booking
+ * (`GET /v1/admin/bookings/:id/action-ledger`). Pages merge
+ * booking-targeted, traveler-targeted and item-targeted entries into one
+ * chronological stream; the first page also carries the booking's
+ * travelers so callers can label traveler-targeted entries.
+ */
+export declare function useBookingActionLedger(bookingId: string | null | undefined, options?: UseBookingActionLedgerOptions): import("@tanstack/react-query").UseInfiniteQueryResult<import("@tanstack/react-query").InfiniteData<{
+    data: {
+        id: string;
+        occurredAt: string;
+        actionName: string;
+        actionVersion: string;
+        actionKind: "reverse" | "execute" | "read" | "create" | "update" | "delete" | "approve" | "reject" | "compensate" | "duplicate";
+        status: "reversed" | "requested" | "awaiting_approval" | "approved" | "denied" | "succeeded" | "failed" | "compensated" | "expired" | "cancelled" | "superseded";
+        evaluatedRisk: "high" | "low" | "medium" | "critical";
+        actorType: string | null;
+        principalType: "user" | "system" | "api_key" | "agent" | "workflow";
+        principalId: string;
+        principalSubtype: string | null;
+        sessionId: string | null;
+        apiTokenId: string | null;
+        internalRequest: boolean;
+        delegatedByPrincipalType: "user" | "system" | "api_key" | "agent" | "workflow" | null;
+        delegatedByPrincipalId: string | null;
+        delegationId: string | null;
+        callerType: string | null;
+        organizationId: string | null;
+        routeOrToolName: string | null;
+        workflowRunId: string | null;
+        workflowStepId: string | null;
+        correlationId: string | null;
+        causationActionId: string | null;
+        idempotencyScope: string | null;
+        idempotencyKey: string | null;
+        idempotencyFingerprint: string | null;
+        targetType: string;
+        targetId: string;
+        capabilityId: string | null;
+        capabilityVersion: string | null;
+        authorizationSource: string | null;
+        approvalId: string | null;
+        amendsActionId: string | null;
+        createdAt: string;
+    }[];
+    travelers: {
+        id: string;
+        firstName: string | null;
+        lastName: string | null;
+    }[];
+    pageInfo: {
+        nextCursor: {
+            occurredAt: string;
+            id: string;
+        } | null;
+    };
+}, unknown>, Error>;
+//# sourceMappingURL=use-booking-action-ledger.d.ts.map

package/dist/hooks/use-booking-action-ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-booking-action-ledger.d.ts","sourceRoot":"","sources":["../../src/hooks/use-booking-action-ledger.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,6BAA6B;IAC5C,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,OAAO,GAAE,6BAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBA0B5C"}

package/dist/hooks/use-booking-action-ledger.js

@@ -0,0 +1,34 @@
+"use client";
+import { useInfiniteQuery } from "@tanstack/react-query";
+import { fetchWithValidation } from "../client.js";
+import { useVoyantBookingsContext } from "../provider.js";
+import { bookingsQueryKeys } from "../query-keys.js";
+import { bookingActionLedgerListResponse } from "../schemas.js";
+/**
+ * Cursor-paged central action-ledger feed for a booking
+ * (`GET /v1/admin/bookings/:id/action-ledger`). Pages merge
+ * booking-targeted, traveler-targeted and item-targeted entries into one
+ * chronological stream; the first page also carries the booking's
+ * travelers so callers can label traveler-targeted entries.
+ */
+export function useBookingActionLedger(bookingId, options = {}) {
+    const { baseUrl, fetcher } = useVoyantBookingsContext();
+    const { enabled = true, limit = 50 } = options;
+    return useInfiniteQuery({
+        queryKey: bookingsQueryKeys.actionLedger(bookingId ?? ""),
+        queryFn: ({ pageParam }) => {
+            if (!bookingId) {
+                throw new Error("useBookingActionLedger requires a bookingId");
+            }
+            const params = new URLSearchParams({ limit: String(limit) });
+            if (pageParam) {
+                params.set("cursorOccurredAt", pageParam.occurredAt);
+                params.set("cursorId", pageParam.id);
+            }
+            return fetchWithValidation(`/v1/admin/bookings/${bookingId}/action-ledger?${params}`, bookingActionLedgerListResponse, { baseUrl, fetcher });
+        },
+        initialPageParam: null,
+        getNextPageParam: (lastPage) => lastPage.pageInfo.nextCursor,
+        enabled: enabled && Boolean(bookingId),
+    });
+}

package/dist/hooks/use-booking-activity.d.ts

@@ -0,0 +1,17 @@
+export interface UseBookingActivityOptions {
+    enabled?: boolean;
+}
+export declare function useBookingActivity(bookingId: string | null | undefined, options?: UseBookingActivityOptions): import("@tanstack/react-query").UseQueryResult<{
+    data: {
+        id: string;
+        bookingId: string;
+        actorId: string | null;
+        activityType: string;
+        description: string;
+        metadata: Record<string, unknown> | null;
+        createdAt: string;
+        actorName?: string | null | undefined;
+        actorEmail?: string | null | undefined;
+    }[];
+}, Error>;
+//# sourceMappingURL=use-booking-activity.d.ts.map

package/dist/hooks/use-booking-activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-booking-activity.d.ts","sourceRoot":"","sources":["../../src/hooks/use-booking-activity.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,yBAAyB;IACxC,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,OAAO,GAAE,yBAA8B;;;;;;;;;;;;UASxC"}

package/dist/hooks/use-booking-activity.js

@@ -0,0 +1,12 @@
+"use client";
+import { useQuery } from "@tanstack/react-query";
+import { useVoyantBookingsContext } from "../provider.js";
+import { getBookingActivityQueryOptions } from "../query-options.js";
+export function useBookingActivity(bookingId, options = {}) {
+    const { baseUrl, fetcher } = useVoyantBookingsContext();
+    const { enabled = true } = options;
+    return useQuery({
+        ...getBookingActivityQueryOptions({ baseUrl, fetcher }, bookingId),
+        enabled: enabled && Boolean(bookingId),
+    });
+}

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

@@ -0,0 +1,69 @@
+export interface CancelBookingInput {
+    note?: string | null;
+}
+/**
+ * Cancels a booking via POST /v1/bookings/:id/cancel.
+ * The backend releases allocations, cancels items, and logs a status-change activity.
+ */
+export declare function useBookingCancelMutation(bookingId: string): import("@tanstack/react-query").UseMutationResult<{
+    id: string;
+    bookingNumber: string;
+    status: "draft" | "expired" | "cancelled" | "completed" | "confirmed" | "on_hold" | "awaiting_payment" | "in_progress";
+    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, CancelBookingInput, unknown>;
+//# sourceMappingURL=use-booking-cancel-mutation.d.ts.map

package/dist/hooks/use-booking-cancel-mutation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-booking-cancel-mutation.d.ts","sourceRoot":"","sources":["../../src/hooks/use-booking-cancel-mutation.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uCAmBzD"}

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

@@ -0,0 +1,24 @@
+"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";
+/**
+ * Cancels a booking via POST /v1/bookings/:id/cancel.
+ * The backend releases allocations, cancels items, and logs a status-change activity.
+ */
+export function useBookingCancelMutation(bookingId) {
+    const { baseUrl, fetcher } = useVoyantBookingsContext();
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: async (input) => {
+            const { data } = await fetchWithValidation(`/v1/bookings/${bookingId}/cancel`, bookingSingleResponse, { baseUrl, fetcher }, { method: "POST", body: JSON.stringify(input ?? {}) });
+            return data;
+        },
+        onSuccess: () => {
+            void queryClient.invalidateQueries({ queryKey: bookingsQueryKeys.booking(bookingId) });
+            void queryClient.invalidateQueries({ queryKey: bookingsQueryKeys.activity(bookingId) });
+        },
+    });
+}

package/dist/hooks/use-booking-contract-generation.d.ts

@@ -0,0 +1,31 @@
+export interface GenerateBookingContractInput {
+    /** Regenerate even when the contract already has a persisted PDF. */
+    force?: boolean;
+}
+/**
+ * Contract generation for a booking
+ * (`POST /v1/admin/bookings/:id/generate-contract`):
+ *
+ *   - `preview` runs the server-side preview branch (`{ preview: true }`),
+ *     which renders the same template + variable build the customer would
+ *     see at checkout and returns the HTML without persisting anything.
+ *   - `generate` creates the legal contract row + persists the PDF
+ *     attachment; pass `{ force: true }` to regenerate an existing PDF.
+ *
+ * The created contract lives in the legal module — callers that display
+ * contract lists should invalidate `legalQueryKeys.contracts()` (from
+ * `@voyant-travel/legal-react`) on `generate` success; this package cannot do
+ * that without taking a dependency on the legal client.
+ */
+export declare function useBookingContractGenerationMutation(bookingId: string): {
+    preview: import("@tanstack/react-query").UseMutationResult<{
+        html: string;
+        templateName?: string | undefined;
+        templateLanguage?: string | undefined;
+    }, Error, void, unknown>;
+    generate: import("@tanstack/react-query").UseMutationResult<{
+        contractId: string;
+        attachmentId: string;
+    }, Error, GenerateBookingContractInput, unknown>;
+};
+//# sourceMappingURL=use-booking-contract-generation.d.ts.map

package/dist/hooks/use-booking-contract-generation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-booking-contract-generation.d.ts","sourceRoot":"","sources":["../../src/hooks/use-booking-contract-generation.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,4BAA4B;IAC3C,qEAAqE;IACrE,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oCAAoC,CAAC,SAAS,EAAE,MAAM;;;;;;;;;;EA4BrE"}

package/dist/hooks/use-booking-contract-generation.js

@@ -0,0 +1,36 @@
+"use client";
+import { useMutation } from "@tanstack/react-query";
+import { fetchWithValidation } from "../client.js";
+import { useVoyantBookingsContext } from "../provider.js";
+import { bookingContractPreviewResponse, bookingGenerateContractResponse } from "../schemas.js";
+/**
+ * Contract generation for a booking
+ * (`POST /v1/admin/bookings/:id/generate-contract`):
+ *
+ *   - `preview` runs the server-side preview branch (`{ preview: true }`),
+ *     which renders the same template + variable build the customer would
+ *     see at checkout and returns the HTML without persisting anything.
+ *   - `generate` creates the legal contract row + persists the PDF
+ *     attachment; pass `{ force: true }` to regenerate an existing PDF.
+ *
+ * The created contract lives in the legal module — callers that display
+ * contract lists should invalidate `legalQueryKeys.contracts()` (from
+ * `@voyant-travel/legal-react`) on `generate` success; this package cannot do
+ * that without taking a dependency on the legal client.
+ */
+export function useBookingContractGenerationMutation(bookingId) {
+    const { baseUrl, fetcher } = useVoyantBookingsContext();
+    const preview = useMutation({
+        mutationFn: async () => {
+            const { data } = await fetchWithValidation(`/v1/admin/bookings/${bookingId}/generate-contract`, bookingContractPreviewResponse, { baseUrl, fetcher }, { method: "POST", body: JSON.stringify({ preview: true }) });
+            return data;
+        },
+    });
+    const generate = useMutation({
+        mutationFn: async (input = {}) => {
+            const { data } = await fetchWithValidation(`/v1/admin/bookings/${bookingId}/generate-contract`, bookingGenerateContractResponse, { baseUrl, fetcher }, { method: "POST", body: JSON.stringify(input.force ? { force: true } : {}) });
+            return data;
+        },
+    });
+    return { preview, generate };
+}

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

@@ -0,0 +1,81 @@
+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/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" | "completed" | "confirmed" | "on_hold" | "awaiting_payment" | "in_progress";
+    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>;
+//# sourceMappingURL=use-booking-convert-mutation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-booking-convert-mutation.d.ts","sourceRoot":"","sources":["../../src/hooks/use-booking-convert-mutation.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iDAkBxC"}

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

@@ -0,0 +1,24 @@
+"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/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/bookings/from-product", bookingSingleResponse, { baseUrl, fetcher }, { method: "POST", body: JSON.stringify(input) });
+            return data;
+        },
+        onSuccess: () => {
+            void queryClient.invalidateQueries({ queryKey: bookingsQueryKeys.bookings() });
+        },
+    });
+}