@voyant-travel/finance-react 0.119.5

package/dist/checkout-hooks/use-collect-payment.d.ts

@@ -0,0 +1,227 @@
+import type { PaymentChoice } from "../checkout-types.js";
+export interface UseCollectPaymentOptions {
+    /**
+     * Provider id registered in checkout's `paymentStarters` map. Only used
+     * when the choice is `send_link`. Defaults to `"netopia"` since that's
+     * the only processor in tree today; pass explicitly when adding others.
+     */
+    cardProvider?: string;
+    /** Payer email — used as the recipient for the payment-link notification. */
+    payerEmail?: string | null;
+    /** Payer name — passed through to the payment session (display only). */
+    payerName?: string | null;
+    /**
+     * Customer-facing language for the processor's hosted payment page (e.g.
+     * the picked CRM person's `preferredLanguage`, the booking locale, or the
+     * operator's current locale). When omitted, falls back to the processor's
+     * deploy-wide default (e.g. `NETOPIA_LANGUAGE`).
+     *
+     * Forwarded to `startProvider.payload.language` — Netopia honors it for
+     * its hosted page; other processors map their own equivalent field.
+     */
+    payerLanguage?: string | null;
+    /**
+     * Where the customer's browser should land after a successful (or
+     * cancelled) payment on the processor's hosted page. Storefronts pass
+     * their own confirmation route; operator-initiated send-link flows
+     * typically leave this unset and let the deploy-wide
+     * `NETOPIA_REDIRECT_URL` point at the public `/pay/:sessionId` landing.
+     */
+    returnUrl?: string | null;
+    cancelUrl?: string | null;
+    /** Optional vertical-supplied notes attached to the collection. */
+    notes?: string | null;
+}
+export interface CollectPaymentInput {
+    choice: PaymentChoice;
+    amountCents: number;
+}
+/**
+ * Higher-level collection hook: takes a `PaymentChoice` from `<PaymentStep>`
+ * and translates it into the appropriate `initiateCheckoutCollection` call.
+ *
+ * Routes:
+ *   - `hold` → creates a payment session, starts the configured card
+ *     processor (so `redirectUrl` is populated), and returns the result.
+ *     The customer-facing card vs bank-transfer choice happens later on
+ *     the public `/pay/:sessionId` landing page; the admin's job is just
+ *     to produce that link and share it.
+ *   - any other → throws. `saved_method` / `new_card` / `extra` are
+ *     vertical-specific (immediate-charge or vertical action) and the
+ *     parent handles them by calling `useInitiateCheckoutCollection`
+ *     directly with its own request body.
+ */
+export declare function useCollectPayment(bookingId: string, options?: UseCollectPaymentOptions): import("@tanstack/react-query").UseMutationResult<{
+    plan: {
+        bookingId: string;
+        method: "bank_transfer" | "card";
+        stage: "manual" | "initial" | "reminder";
+        paymentSessionTarget: "schedule" | "invoice" | null;
+        documentType: "invoice" | "proforma" | null;
+        willCreateDefaultPaymentPlan: boolean;
+        selectedSchedule: {
+            id: string;
+            bookingId: string;
+            bookingItemId: string | null;
+            scheduleType: string;
+            status: string;
+            dueDate: string;
+            currency: string;
+            amountCents: number;
+            notes: string | null;
+        } | null;
+        selectedInvoice: {
+            id: string;
+            invoiceNumber: string;
+            invoiceType: string;
+            bookingId: string;
+            personId: string | null;
+            organizationId: string | null;
+            status: string;
+            currency: string;
+            totalCents: number;
+            paidCents: number;
+            balanceDueCents: number;
+            issueDate: string;
+            dueDate: string;
+            notes: string | null;
+            createdAt: string;
+            updatedAt: string;
+        } | null;
+        amountCents: number;
+        currency: string;
+        recommendedAction: "none" | "create_bank_transfer_document" | "create_payment_session" | "create_invoice_then_payment_session";
+    };
+    invoice: {
+        id: string;
+        invoiceNumber: string;
+        invoiceType: string;
+        bookingId: string;
+        personId: string | null;
+        organizationId: string | null;
+        status: string;
+        currency: string;
+        totalCents: number;
+        paidCents: number;
+        balanceDueCents: number;
+        issueDate: string;
+        dueDate: string;
+        notes: string | null;
+        createdAt: string;
+        updatedAt: string;
+    } | null;
+    paymentSession: {
+        legacyOrderId: string | null;
+        target: {
+            type: "booking";
+            bookingId: string;
+        } | {
+            type: "invoice";
+            invoiceId: string;
+        } | {
+            type: "booking_payment_schedule";
+            bookingPaymentScheduleId: string;
+        } | {
+            type: "booking_guarantee";
+            bookingGuaranteeId: string;
+        } | {
+            type: "flight_order";
+            flightOrderId: string;
+        } | {
+            type: "program";
+            programId: string;
+        } | {
+            type: "supplier_settlement";
+            supplierSettlementId: string;
+        } | {
+            type: "channel_settlement";
+            channelSettlementId: string;
+        } | {
+            type: "provider_reference";
+            provider: string;
+            reference: string;
+        } | {
+            type: "legacy_order";
+            legacyOrderId: string;
+        } | null;
+        provenance: {
+            source: "other" | "operator" | "storefront" | "customer_portal" | "payment_provider" | "supplier_channel" | "migration";
+            provider?: string | null | undefined;
+            reference?: string | null | undefined;
+            idempotencyKey?: string | null | undefined;
+        } | null;
+        id: string;
+        targetType: "other" | "booking" | "invoice" | "order" | "booking_payment_schedule" | "booking_guarantee" | "flight_order";
+        targetId: string | null;
+        bookingId: string | null;
+        invoiceId: string | null;
+        bookingPaymentScheduleId: string | null;
+        bookingGuaranteeId: string | null;
+        status: "pending" | "failed" | "cancelled" | "expired" | "paid" | "authorized" | "requires_redirect" | "processing";
+        provider: string | null;
+        providerSessionId: string | null;
+        providerPaymentId: string | null;
+        externalReference: string | null;
+        clientReference: string | null;
+        currency: string;
+        amountCents: number;
+        paymentMethod: "other" | "voucher" | "wallet" | "bank_transfer" | "credit_card" | "debit_card" | "cash" | "cheque" | "direct_bill" | null;
+        payerEmail: string | null;
+        payerName: string | null;
+        redirectUrl: string | null;
+        returnUrl: string | null;
+        cancelUrl: string | null;
+        expiresAt: string | null;
+        completedAt: string | null;
+        failureCode: string | null;
+        failureMessage: string | null;
+        notes: string | null;
+    } | null;
+    invoiceNotification: {
+        id: string;
+        templateSlug: string | null;
+        channel: "email" | "sms";
+        provider: string;
+        status: "pending" | "failed" | "cancelled" | "sent";
+        toAddress: string;
+        subject: string | null;
+        sentAt: string | null;
+        failedAt: string | null;
+        errorMessage: string | null;
+    } | null;
+    paymentSessionNotification: {
+        id: string;
+        templateSlug: string | null;
+        channel: "email" | "sms";
+        provider: string;
+        status: "pending" | "failed" | "cancelled" | "sent";
+        toAddress: string;
+        subject: string | null;
+        sentAt: string | null;
+        failedAt: string | null;
+        errorMessage: string | null;
+    } | null;
+    bankTransferInstructions: {
+        provider: string | null;
+        invoiceId: string;
+        invoiceNumber: string;
+        documentType: "invoice" | "proforma";
+        amountCents: number;
+        currency: string;
+        dueDate: string | null;
+        beneficiary: string;
+        iban: string;
+        bankName: string | null;
+        notes: string | null;
+    } | null;
+    providerStart: {
+        provider: string;
+        paymentSessionId: string;
+        redirectUrl: string | null;
+        externalReference: string | null;
+        providerSessionId: string | null;
+        providerPaymentId: string | null;
+        response: Record<string, unknown> | null;
+    } | null;
+}, Error, CollectPaymentInput, unknown>;
+//# sourceMappingURL=use-collect-payment.d.ts.map

package/dist/checkout-hooks/use-collect-payment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-collect-payment.d.ts","sourceRoot":"","sources":["../../src/checkout-hooks/use-collect-payment.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAGzD,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,aAAa,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,wBAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wCAiD1F"}

package/dist/checkout-hooks/use-collect-payment.js

@@ -0,0 +1,80 @@
+"use client";
+import { useMutation, useQueryClient } from "@tanstack/react-query";
+import { useVoyantFinanceContext } from "../provider.js";
+/**
+ * Higher-level collection hook: takes a `PaymentChoice` from `<PaymentStep>`
+ * and translates it into the appropriate `initiateCheckoutCollection` call.
+ *
+ * Routes:
+ *   - `hold` → creates a payment session, starts the configured card
+ *     processor (so `redirectUrl` is populated), and returns the result.
+ *     The customer-facing card vs bank-transfer choice happens later on
+ *     the public `/pay/:sessionId` landing page; the admin's job is just
+ *     to produce that link and share it.
+ *   - any other → throws. `saved_method` / `new_card` / `extra` are
+ *     vertical-specific (immediate-charge or vertical action) and the
+ *     parent handles them by calling `useInitiateCheckoutCollection`
+ *     directly with its own request body.
+ */
+export function useCollectPayment(bookingId, options = {}) {
+    const { baseUrl, fetcher } = useVoyantFinanceContext();
+    const qc = useQueryClient();
+    const { cardProvider = "netopia", payerEmail, payerName, payerLanguage, returnUrl, cancelUrl, notes, } = options;
+    return useMutation({
+        mutationFn: async ({ choice, amountCents, }) => {
+            const body = mapChoiceToRequest(choice, amountCents, {
+                cardProvider,
+                payerEmail,
+                payerName,
+                payerLanguage,
+                returnUrl,
+                cancelUrl,
+                notes,
+            });
+            const response = await fetcher(`${baseUrl}/v1/admin/finance/bookings/${bookingId}/initiate-collection`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify(body),
+            });
+            const json = (await response.json());
+            if (!response.ok) {
+                const message = "error" in json ? json.error : `Collection failed: ${response.status}`;
+                throw new Error(message);
+            }
+            return json.data;
+        },
+        onSuccess: () => {
+            qc.invalidateQueries({ queryKey: ["bookings", bookingId] });
+            qc.invalidateQueries({ queryKey: ["public-booking-payments", bookingId] });
+        },
+    });
+}
+function mapChoiceToRequest(choice, amountCents, ctx) {
+    if (choice.type === "hold") {
+        // Deliberately no `startProvider` here. Processors like Netopia
+        // require a real billing block at provider-start time, which the
+        // admin doesn't have at link-generation time. The customer-facing
+        // `/pay/:sessionId` landing lazy-starts the processor (via the
+        // template's `POST /v1/public/payment-link/:sessionId/start-card`
+        // endpoint) with synthesized placeholder billing — the processor's
+        // hosted form then collects the real billing from the customer.
+        return {
+            method: "card",
+            stage: "manual",
+            amountCents,
+            ensureDefaultPaymentPlan: true,
+            paymentSession: {
+                provider: ctx.cardProvider,
+                payerEmail: ctx.payerEmail ?? undefined,
+                payerName: ctx.payerName ?? undefined,
+                returnUrl: ctx.returnUrl ?? undefined,
+                cancelUrl: ctx.cancelUrl ?? undefined,
+            },
+            // No auto-email by design — the admin shares the link manually.
+            // Starters that want auto-email back can call
+            // `useInitiateCheckoutCollection` directly with `paymentSessionNotification`.
+            notes: ctx.notes ?? undefined,
+        };
+    }
+    throw new Error(`useCollectPayment doesn't handle choice type "${choice.type}" — call useInitiateCheckoutCollection directly with a vertical-specific request.`);
+}

package/dist/checkout-hooks/use-initiate-checkout-collection.d.ts

@@ -0,0 +1,308 @@
+/**
+ * Admin-side: kick off a checkout collection against a booking. Mounts at
+ * `/v1/admin/finance/bookings/:bookingId/initiate-collection` (the public
+ * mirror is gated behind `actor=customer` and only reachable from a public
+ * storefront / customer portal).
+ *
+ * Invalidates booking + public-booking-payments queries on success so the
+ * caller's payments summary re-fetches automatically.
+ */
+export declare function useInitiateCheckoutCollection(bookingId: string): import("@tanstack/react-query").UseMutationResult<{
+    plan: {
+        bookingId: string;
+        method: "bank_transfer" | "card";
+        stage: "manual" | "initial" | "reminder";
+        paymentSessionTarget: "schedule" | "invoice" | null;
+        documentType: "invoice" | "proforma" | null;
+        willCreateDefaultPaymentPlan: boolean;
+        selectedSchedule: {
+            id: string;
+            bookingId: string;
+            bookingItemId: string | null;
+            scheduleType: string;
+            status: string;
+            dueDate: string;
+            currency: string;
+            amountCents: number;
+            notes: string | null;
+        } | null;
+        selectedInvoice: {
+            id: string;
+            invoiceNumber: string;
+            invoiceType: string;
+            bookingId: string;
+            personId: string | null;
+            organizationId: string | null;
+            status: string;
+            currency: string;
+            totalCents: number;
+            paidCents: number;
+            balanceDueCents: number;
+            issueDate: string;
+            dueDate: string;
+            notes: string | null;
+            createdAt: string;
+            updatedAt: string;
+        } | null;
+        amountCents: number;
+        currency: string;
+        recommendedAction: "none" | "create_bank_transfer_document" | "create_payment_session" | "create_invoice_then_payment_session";
+    };
+    invoice: {
+        id: string;
+        invoiceNumber: string;
+        invoiceType: string;
+        bookingId: string;
+        personId: string | null;
+        organizationId: string | null;
+        status: string;
+        currency: string;
+        totalCents: number;
+        paidCents: number;
+        balanceDueCents: number;
+        issueDate: string;
+        dueDate: string;
+        notes: string | null;
+        createdAt: string;
+        updatedAt: string;
+    } | null;
+    paymentSession: {
+        legacyOrderId: string | null;
+        target: {
+            type: "booking";
+            bookingId: string;
+        } | {
+            type: "invoice";
+            invoiceId: string;
+        } | {
+            type: "booking_payment_schedule";
+            bookingPaymentScheduleId: string;
+        } | {
+            type: "booking_guarantee";
+            bookingGuaranteeId: string;
+        } | {
+            type: "flight_order";
+            flightOrderId: string;
+        } | {
+            type: "program";
+            programId: string;
+        } | {
+            type: "supplier_settlement";
+            supplierSettlementId: string;
+        } | {
+            type: "channel_settlement";
+            channelSettlementId: string;
+        } | {
+            type: "provider_reference";
+            provider: string;
+            reference: string;
+        } | {
+            type: "legacy_order";
+            legacyOrderId: string;
+        } | null;
+        provenance: {
+            source: "other" | "operator" | "storefront" | "customer_portal" | "payment_provider" | "supplier_channel" | "migration";
+            provider?: string | null | undefined;
+            reference?: string | null | undefined;
+            idempotencyKey?: string | null | undefined;
+        } | null;
+        id: string;
+        targetType: "other" | "booking" | "invoice" | "order" | "booking_payment_schedule" | "booking_guarantee" | "flight_order";
+        targetId: string | null;
+        bookingId: string | null;
+        invoiceId: string | null;
+        bookingPaymentScheduleId: string | null;
+        bookingGuaranteeId: string | null;
+        status: "pending" | "failed" | "cancelled" | "expired" | "paid" | "authorized" | "requires_redirect" | "processing";
+        provider: string | null;
+        providerSessionId: string | null;
+        providerPaymentId: string | null;
+        externalReference: string | null;
+        clientReference: string | null;
+        currency: string;
+        amountCents: number;
+        paymentMethod: "other" | "voucher" | "wallet" | "bank_transfer" | "credit_card" | "debit_card" | "cash" | "cheque" | "direct_bill" | null;
+        payerEmail: string | null;
+        payerName: string | null;
+        redirectUrl: string | null;
+        returnUrl: string | null;
+        cancelUrl: string | null;
+        expiresAt: string | null;
+        completedAt: string | null;
+        failureCode: string | null;
+        failureMessage: string | null;
+        notes: string | null;
+    } | null;
+    invoiceNotification: {
+        id: string;
+        templateSlug: string | null;
+        channel: "email" | "sms";
+        provider: string;
+        status: "pending" | "failed" | "cancelled" | "sent";
+        toAddress: string;
+        subject: string | null;
+        sentAt: string | null;
+        failedAt: string | null;
+        errorMessage: string | null;
+    } | null;
+    paymentSessionNotification: {
+        id: string;
+        templateSlug: string | null;
+        channel: "email" | "sms";
+        provider: string;
+        status: "pending" | "failed" | "cancelled" | "sent";
+        toAddress: string;
+        subject: string | null;
+        sentAt: string | null;
+        failedAt: string | null;
+        errorMessage: string | null;
+    } | null;
+    bankTransferInstructions: {
+        provider: string | null;
+        invoiceId: string;
+        invoiceNumber: string;
+        documentType: "invoice" | "proforma";
+        amountCents: number;
+        currency: string;
+        dueDate: string | null;
+        beneficiary: string;
+        iban: string;
+        bankName: string | null;
+        notes: string | null;
+    } | null;
+    providerStart: {
+        provider: string;
+        paymentSessionId: string;
+        redirectUrl: string | null;
+        externalReference: string | null;
+        providerSessionId: string | null;
+        providerPaymentId: string | null;
+        response: Record<string, unknown> | null;
+    } | null;
+}, Error, {
+    method: "bank_transfer" | "card";
+    stage: "manual" | "initial" | "reminder";
+    ensureDefaultPaymentPlan: boolean;
+    scheduleId?: string | undefined;
+    invoiceId?: string | undefined;
+    amountCents?: number | undefined;
+    paymentSessionTarget?: "schedule" | "invoice" | undefined;
+    paymentPlan?: {
+        depositMode?: "none" | "percentage" | "fixed_amount" | undefined;
+        depositValue?: number | undefined;
+        depositDueDate?: string | null | undefined;
+        balanceDueDaysBeforeStart?: number | undefined;
+        clearExistingPending?: boolean | undefined;
+        createGuarantee?: boolean | undefined;
+        guaranteeType?: "other" | "deposit" | "voucher" | "bank_transfer" | "credit_card" | "preauth" | "card_on_file" | "agency_letter" | undefined;
+        notes?: string | null | undefined;
+    } | undefined;
+    paymentSession?: {
+        target?: {
+            type: "booking";
+            bookingId: string;
+        } | {
+            type: "invoice";
+            invoiceId: string;
+        } | {
+            type: "booking_payment_schedule";
+            bookingPaymentScheduleId: string;
+        } | {
+            type: "booking_guarantee";
+            bookingGuaranteeId: string;
+        } | {
+            type: "flight_order";
+            flightOrderId: string;
+        } | {
+            type: "program";
+            programId: string;
+        } | {
+            type: "supplier_settlement";
+            supplierSettlementId: string;
+        } | {
+            type: "channel_settlement";
+            channelSettlementId: string;
+        } | {
+            type: "provider_reference";
+            provider: string;
+            reference: string;
+        } | {
+            type: "legacy_order";
+            legacyOrderId: string;
+        } | undefined;
+        provenance?: {
+            source: "other" | "operator" | "storefront" | "customer_portal" | "payment_provider" | "supplier_channel" | "migration";
+            provider?: string | null | undefined;
+            reference?: string | null | undefined;
+            idempotencyKey?: string | null | undefined;
+        } | undefined;
+        provider?: string | null | undefined;
+        paymentMethod?: "other" | "voucher" | "wallet" | "bank_transfer" | "credit_card" | "debit_card" | "cash" | "cheque" | "direct_bill" | null | undefined;
+        payerPersonId?: string | null | undefined;
+        payerOrganizationId?: string | null | undefined;
+        payerEmail?: string | null | undefined;
+        payerName?: string | null | undefined;
+        externalReference?: string | null | undefined;
+        idempotencyKey?: string | null | undefined;
+        clientReference?: string | null | undefined;
+        returnUrl?: string | null | undefined;
+        cancelUrl?: string | null | undefined;
+        callbackUrl?: string | null | undefined;
+        expiresAt?: string | null | undefined;
+        notes?: string | null | undefined;
+        providerPayload?: Record<string, unknown> | null | undefined;
+        metadata?: Record<string, unknown> | null | undefined;
+    } | undefined;
+    paymentSessionNotification?: {
+        channel: "email" | "sms";
+        templateId?: string | null | undefined;
+        templateSlug?: string | null | undefined;
+        provider?: string | null | undefined;
+        to?: string | null | undefined;
+        from?: string | null | undefined;
+        subject?: string | null | undefined;
+        html?: string | null | undefined;
+        text?: string | null | undefined;
+        attachments?: {
+            filename: string;
+            contentBase64?: string | null | undefined;
+            path?: string | null | undefined;
+            contentType?: string | null | undefined;
+            disposition?: "inline" | "attachment" | null | undefined;
+            contentId?: string | null | undefined;
+        }[] | null | undefined;
+        data?: Record<string, unknown> | null | undefined;
+        metadata?: Record<string, unknown> | null | undefined;
+        scheduledFor?: string | null | undefined;
+        paymentLinkBaseUrl?: string | null | undefined;
+    } | undefined;
+    invoiceNotification?: {
+        channel: "email" | "sms";
+        templateId?: string | null | undefined;
+        templateSlug?: string | null | undefined;
+        provider?: string | null | undefined;
+        to?: string | null | undefined;
+        from?: string | null | undefined;
+        subject?: string | null | undefined;
+        html?: string | null | undefined;
+        text?: string | null | undefined;
+        attachments?: {
+            filename: string;
+            contentBase64?: string | null | undefined;
+            path?: string | null | undefined;
+            contentType?: string | null | undefined;
+            disposition?: "inline" | "attachment" | null | undefined;
+            contentId?: string | null | undefined;
+        }[] | null | undefined;
+        data?: Record<string, unknown> | null | undefined;
+        metadata?: Record<string, unknown> | null | undefined;
+        scheduledFor?: string | null | undefined;
+        paymentLinkBaseUrl?: string | null | undefined;
+    } | undefined;
+    startProvider?: {
+        provider: string;
+        payload?: Record<string, unknown> | null | undefined;
+    } | undefined;
+    notes?: string | null | undefined;
+}, unknown>;
+//# sourceMappingURL=use-initiate-checkout-collection.d.ts.map

package/dist/checkout-hooks/use-initiate-checkout-collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-initiate-checkout-collection.d.ts","sourceRoot":"","sources":["../../src/checkout-hooks/use-initiate-checkout-collection.ts"],"names":[],"mappings":"AAcA;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YA8B9D"}

package/dist/checkout-hooks/use-initiate-checkout-collection.js

@@ -0,0 +1,35 @@
+"use client";
+import { useMutation, useQueryClient } from "@tanstack/react-query";
+import { useVoyantFinanceContext } from "../provider.js";
+/**
+ * Admin-side: kick off a checkout collection against a booking. Mounts at
+ * `/v1/admin/finance/bookings/:bookingId/initiate-collection` (the public
+ * mirror is gated behind `actor=customer` and only reachable from a public
+ * storefront / customer portal).
+ *
+ * Invalidates booking + public-booking-payments queries on success so the
+ * caller's payments summary re-fetches automatically.
+ */
+export function useInitiateCheckoutCollection(bookingId) {
+    const { baseUrl, fetcher } = useVoyantFinanceContext();
+    const qc = useQueryClient();
+    return useMutation({
+        mutationFn: async (input) => {
+            const response = await fetcher(`${baseUrl}/v1/admin/finance/bookings/${bookingId}/initiate-collection`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify(input),
+            });
+            const body = (await response.json());
+            if (!response.ok) {
+                const message = "error" in body ? body.error : `Checkout failed: ${response.status}`;
+                throw new Error(message);
+            }
+            return body.data;
+        },
+        onSuccess: () => {
+            qc.invalidateQueries({ queryKey: ["bookings", bookingId] });
+            qc.invalidateQueries({ queryKey: ["public-booking-payments", bookingId] });
+        },
+    });
+}