@voyant-travel/finance-react 0.119.5

package/dist/hooks/use-invoice-payments.d.ts

@@ -0,0 +1,21 @@
+export interface UseInvoicePaymentsOptions {
+    enabled?: boolean;
+}
+export declare function useInvoicePayments(invoiceId: string | null | undefined, options?: UseInvoicePaymentsOptions): import("@tanstack/react-query").UseQueryResult<{
+    data: {
+        id: string;
+        invoiceId: string;
+        amountCents: number;
+        currency: string;
+        baseCurrency: string | null;
+        baseAmountCents: number | null;
+        paymentMethod: string;
+        status: "pending" | "completed" | "failed" | "refunded";
+        referenceNumber: string | null;
+        paymentDate: string;
+        notes: string | null;
+        createdAt: string;
+        fxRateSetId?: string | null | undefined;
+    }[];
+}, Error>;
+//# sourceMappingURL=use-invoice-payments.d.ts.map

package/dist/hooks/use-invoice-payments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-invoice-payments.d.ts","sourceRoot":"","sources":["../../src/hooks/use-invoice-payments.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-invoice-payments.js

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

package/dist/hooks/use-invoice.d.ts

@@ -0,0 +1,32 @@
+export interface UseInvoiceOptions {
+    enabled?: boolean;
+}
+export declare function useInvoice(id: string | null | undefined, options?: UseInvoiceOptions): import("@tanstack/react-query").UseQueryResult<{
+    data: {
+        [x: string]: unknown;
+        id: string;
+        invoiceNumber: string;
+        bookingId: string;
+        personId: string | null;
+        organizationId: string | null;
+        status: "draft" | "pending_external_allocation" | "issued" | "partially_paid" | "paid" | "overdue" | "void";
+        currency: string;
+        subtotalCents: number;
+        taxCents: number;
+        totalCents: number;
+        paidCents: number;
+        balanceDueCents: number;
+        issueDate: string;
+        dueDate: string;
+        notes: string | null;
+        createdAt: string;
+        updatedAt: string;
+        invoiceType?: "invoice" | "proforma" | "credit_note" | undefined;
+        voidedAt?: string | null | undefined;
+        voidReason?: string | null | undefined;
+        bookingPaymentScheduleIds?: string[] | undefined;
+        convertedToInvoiceId?: string | null | undefined;
+        convertedToInvoiceNumber?: string | null | undefined;
+    };
+}, Error>;
+//# sourceMappingURL=use-invoice.d.ts.map

package/dist/hooks/use-invoice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-invoice.d.ts","sourceRoot":"","sources":["../../src/hooks/use-invoice.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,OAAO,GAAE,iBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;UAQxF"}

package/dist/hooks/use-invoice.js

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

package/dist/hooks/use-invoices.d.ts

@@ -0,0 +1,36 @@
+import type { FinanceInvoiceListFilters } from "../query-keys.js";
+export interface UseInvoicesOptions extends FinanceInvoiceListFilters {
+    enabled?: boolean;
+}
+export declare function useInvoices(options?: UseInvoicesOptions): import("@tanstack/react-query").UseQueryResult<{
+    data: {
+        [x: string]: unknown;
+        id: string;
+        invoiceNumber: string;
+        bookingId: string;
+        personId: string | null;
+        organizationId: string | null;
+        status: "draft" | "pending_external_allocation" | "issued" | "partially_paid" | "paid" | "overdue" | "void";
+        currency: string;
+        subtotalCents: number;
+        taxCents: number;
+        totalCents: number;
+        paidCents: number;
+        balanceDueCents: number;
+        issueDate: string;
+        dueDate: string;
+        notes: string | null;
+        createdAt: string;
+        updatedAt: string;
+        invoiceType?: "invoice" | "proforma" | "credit_note" | undefined;
+        voidedAt?: string | null | undefined;
+        voidReason?: string | null | undefined;
+        bookingPaymentScheduleIds?: string[] | undefined;
+        convertedToInvoiceId?: string | null | undefined;
+        convertedToInvoiceNumber?: string | null | undefined;
+    }[];
+    total: number;
+    limit: number;
+    offset: number;
+}, Error>;
+//# sourceMappingURL=use-invoices.d.ts.map

package/dist/hooks/use-invoices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-invoices.d.ts","sourceRoot":"","sources":["../../src/hooks/use-invoices.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAA;AAGjE,MAAM,WAAW,kBAAmB,SAAQ,yBAAyB;IACnE,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAQ3D"}

package/dist/hooks/use-invoices.js

@@ -0,0 +1,12 @@
+"use client";
+import { useQuery } from "@tanstack/react-query";
+import { useVoyantFinanceContext } from "../provider.js";
+import { getInvoicesQueryOptions } from "../query-options.js";
+export function useInvoices(options = {}) {
+    const { baseUrl, fetcher } = useVoyantFinanceContext();
+    const { enabled = true, ...filters } = options;
+    return useQuery({
+        ...getInvoicesQueryOptions({ baseUrl, fetcher }, filters),
+        enabled,
+    });
+}

package/dist/hooks/use-payment-mutation.d.ts

@@ -0,0 +1,57 @@
+import { type PaymentMethod, type PaymentStatus } from "../schemas.js";
+export interface UpdatePaymentInput {
+    amountCents?: number;
+    currency?: string;
+    baseCurrency?: string | null;
+    baseAmountCents?: number | null;
+    fxRateSetId?: string | null;
+    paymentMethod?: PaymentMethod;
+    status?: PaymentStatus;
+    referenceNumber?: string | null;
+    paymentDate?: string;
+    notes?: string | null;
+}
+/**
+ * Mutations for an already-recorded customer payment.
+ *
+ * `useInvoicePaymentMutation(invoiceId)` covers create; update + delete
+ * route through `/v1/admin/finance/payments/:id` and recompute invoice totals
+ * server-side, so callers don't need to refresh the invoice manually —
+ * onSuccess invalidates the invoice and payment list queries.
+ */
+export declare function usePaymentMutation(): {
+    update: import("@tanstack/react-query").UseMutationResult<{
+        id: string;
+        invoiceId: string;
+        amountCents: number;
+        currency: string;
+        baseCurrency: string | null;
+        baseAmountCents: number | null;
+        paymentMethod: string;
+        status: "pending" | "completed" | "failed" | "refunded";
+        referenceNumber: string | null;
+        paymentDate: string;
+        notes: string | null;
+        createdAt: string;
+        fxRateSetId?: string | null | undefined;
+    }, Error, {
+        id: string;
+        input: UpdatePaymentInput;
+    }, unknown>;
+    remove: import("@tanstack/react-query").UseMutationResult<{
+        id: string;
+        invoiceId: string;
+        amountCents: number;
+        currency: string;
+        baseCurrency: string | null;
+        baseAmountCents: number | null;
+        paymentMethod: string;
+        status: "pending" | "completed" | "failed" | "refunded";
+        referenceNumber: string | null;
+        paymentDate: string;
+        notes: string | null;
+        createdAt: string;
+        fxRateSetId?: string | null | undefined;
+    }, Error, string, unknown>;
+};
+//# sourceMappingURL=use-payment-mutation.d.ts.map

package/dist/hooks/use-payment-mutation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-payment-mutation.d.ts","sourceRoot":"","sources":["../../src/hooks/use-payment-mutation.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAuB,MAAM,eAAe,CAAA;AAE3F,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,MAAM,CAAC,EAAE,aAAa,CAAA;IACtB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AA6BD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB;;;;;;;;;;;;;;;;YAKU,MAAM;eAAS,kBAAkB;;;;;;;;;;;;;;;;;EA8B5E"}

package/dist/hooks/use-payment-mutation.js

@@ -0,0 +1,59 @@
+"use client";
+import { useMutation, useQueryClient } from "@tanstack/react-query";
+import { z } from "zod";
+import { fetchWithValidation } from "../client.js";
+import { useVoyantFinanceContext } from "../provider.js";
+import { financeQueryKeys } from "../query-keys.js";
+import { paymentRecordSchema } from "../schemas.js";
+const paymentSingleResponse = z.object({
+    data: paymentRecordSchema,
+});
+function invalidatePaymentScopes(queryClient, invoiceId, paymentId) {
+    void queryClient.invalidateQueries({ queryKey: financeQueryKeys.allPayments() });
+    void queryClient.invalidateQueries({ queryKey: financeQueryKeys.payment(paymentId) });
+    if (invoiceId) {
+        void queryClient.invalidateQueries({ queryKey: financeQueryKeys.payments(invoiceId) });
+        void queryClient.invalidateQueries({ queryKey: financeQueryKeys.invoice(invoiceId) });
+    }
+    // The BookingPaymentsSummary card on the booking detail page is keyed
+    // by bookingId, which the PATCH/DELETE response doesn't surface. Use
+    // prefix invalidation so every booking-payments query refetches —
+    // cheap because each query is per-booking and short.
+    void queryClient.invalidateQueries({
+        queryKey: [...financeQueryKeys.all, "admin-booking-payments"],
+    });
+    void queryClient.invalidateQueries({
+        queryKey: [...financeQueryKeys.publicCheckout(), "booking-payments"],
+    });
+}
+/**
+ * Mutations for an already-recorded customer payment.
+ *
+ * `useInvoicePaymentMutation(invoiceId)` covers create; update + delete
+ * route through `/v1/admin/finance/payments/:id` and recompute invoice totals
+ * server-side, so callers don't need to refresh the invoice manually —
+ * onSuccess invalidates the invoice and payment list queries.
+ */
+export function usePaymentMutation() {
+    const { baseUrl, fetcher } = useVoyantFinanceContext();
+    const queryClient = useQueryClient();
+    const update = useMutation({
+        mutationFn: async ({ id, input }) => {
+            const { data } = await fetchWithValidation(`/v1/admin/finance/payments/${id}`, paymentSingleResponse, { baseUrl, fetcher }, { method: "PATCH", body: JSON.stringify(input) });
+            return data;
+        },
+        onSuccess: (data) => {
+            invalidatePaymentScopes(queryClient, data.invoiceId, data.id);
+        },
+    });
+    const remove = useMutation({
+        mutationFn: async (id) => {
+            const { data } = await fetchWithValidation(`/v1/admin/finance/payments/${id}`, paymentSingleResponse, { baseUrl, fetcher }, { method: "DELETE" });
+            return data;
+        },
+        onSuccess: (data) => {
+            invalidatePaymentScopes(queryClient, data.invoiceId, data.id);
+        },
+    });
+    return { update, remove };
+}

package/dist/hooks/use-payment-session-mutation.d.ts

@@ -0,0 +1,205 @@
+import { type PaymentMethod } from "../schemas.js";
+export interface CompletePaymentSessionInput {
+    /** Defaults to `"paid"` server-side. */
+    status?: "authorized" | "paid";
+    /** Defaults to `"manual"` server-side. */
+    captureMode?: "automatic" | "manual";
+    paymentMethod?: PaymentMethod | null;
+    paymentInstrumentId?: string | null;
+    providerSessionId?: string | null;
+    providerPaymentId?: string | null;
+    externalReference?: string | null;
+    referenceNumber?: string | null;
+    paymentDate?: string | null;
+    authorizedAt?: string | null;
+    capturedAt?: string | null;
+    settledAt?: string | null;
+    notes?: string | null;
+    metadata?: Record<string, unknown> | null;
+}
+export interface CancelPaymentSessionInput {
+    notes?: string | null;
+    cancelledAt?: string | null;
+    metadata?: Record<string, unknown> | null;
+}
+/**
+ * Admin payment-session transitions
+ * (`POST /v1/admin/finance/payment-sessions/:id/complete` and `/cancel`).
+ * Completing a session settles its invoice/payment side effects
+ * server-side, so payment + invoice lists are invalidated alongside the
+ * session list; callers that render booking-scoped surfaces should also
+ * invalidate their booking keys on success.
+ */
+export declare function usePaymentSessionMutation(): {
+    complete: import("@tanstack/react-query").UseMutationResult<{
+        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: string;
+        targetId: string | null;
+        bookingId: string | null;
+        invoiceId: string | null;
+        bookingPaymentScheduleId: string | null;
+        bookingGuaranteeId: string | null;
+        paymentInstrumentId: string | null;
+        paymentAuthorizationId: string | null;
+        paymentCaptureId: string | null;
+        paymentId: string | null;
+        status: "paid" | "pending" | "failed" | "requires_redirect" | "processing" | "authorized" | "cancelled" | "expired";
+        provider: string | null;
+        providerSessionId: string | null;
+        providerPaymentId: string | null;
+        externalReference: string | null;
+        idempotencyKey: string | null;
+        clientReference: string | null;
+        currency: string;
+        amountCents: number;
+        paymentMethod: "bank_transfer" | "credit_card" | "debit_card" | "cash" | "cheque" | "wallet" | "direct_bill" | "voucher" | "other" | null;
+        payerPersonId: string | null;
+        payerOrganizationId: string | null;
+        payerEmail: string | null;
+        payerName: string | null;
+        redirectUrl: string | null;
+        returnUrl: string | null;
+        cancelUrl: string | null;
+        callbackUrl: string | null;
+        expiresAt: string | null;
+        completedAt: string | null;
+        failedAt: string | null;
+        cancelledAt: string | null;
+        expiredAt: string | null;
+        failureCode: string | null;
+        failureMessage: string | null;
+        notes: string | null;
+        providerPayload: Record<string, unknown> | null;
+        metadata: Record<string, unknown> | null;
+        createdAt: string;
+        updatedAt: string;
+    }, Error, {
+        id: string;
+        input?: CompletePaymentSessionInput;
+    }, unknown>;
+    cancel: import("@tanstack/react-query").UseMutationResult<{
+        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: string;
+        targetId: string | null;
+        bookingId: string | null;
+        invoiceId: string | null;
+        bookingPaymentScheduleId: string | null;
+        bookingGuaranteeId: string | null;
+        paymentInstrumentId: string | null;
+        paymentAuthorizationId: string | null;
+        paymentCaptureId: string | null;
+        paymentId: string | null;
+        status: "paid" | "pending" | "failed" | "requires_redirect" | "processing" | "authorized" | "cancelled" | "expired";
+        provider: string | null;
+        providerSessionId: string | null;
+        providerPaymentId: string | null;
+        externalReference: string | null;
+        idempotencyKey: string | null;
+        clientReference: string | null;
+        currency: string;
+        amountCents: number;
+        paymentMethod: "bank_transfer" | "credit_card" | "debit_card" | "cash" | "cheque" | "wallet" | "direct_bill" | "voucher" | "other" | null;
+        payerPersonId: string | null;
+        payerOrganizationId: string | null;
+        payerEmail: string | null;
+        payerName: string | null;
+        redirectUrl: string | null;
+        returnUrl: string | null;
+        cancelUrl: string | null;
+        callbackUrl: string | null;
+        expiresAt: string | null;
+        completedAt: string | null;
+        failedAt: string | null;
+        cancelledAt: string | null;
+        expiredAt: string | null;
+        failureCode: string | null;
+        failureMessage: string | null;
+        notes: string | null;
+        providerPayload: Record<string, unknown> | null;
+        metadata: Record<string, unknown> | null;
+        createdAt: string;
+        updatedAt: string;
+    }, Error, {
+        id: string;
+        input?: CancelPaymentSessionInput;
+    }, unknown>;
+};
+//# sourceMappingURL=use-payment-session-mutation.d.ts.map

package/dist/hooks/use-payment-session-mutation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-payment-session-mutation.d.ts","sourceRoot":"","sources":["../../src/hooks/use-payment-session-mutation.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,aAAa,EAAgC,MAAM,eAAe,CAAA;AAEhF,MAAM,WAAW,2BAA2B;IAC1C,wCAAwC;IACxC,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM,CAAA;IAC9B,0CAA0C;IAC1C,WAAW,CAAC,EAAE,WAAW,GAAG,QAAQ,CAAA;IACpC,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAA;IACpC,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACnC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CAC1C;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CAC1C;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAWQ,MAAM;gBAAU,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAa3C,MAAM;gBAAU,yBAAyB;;EAazF"}

package/dist/hooks/use-payment-session-mutation.js

@@ -0,0 +1,38 @@
+"use client";
+import { useMutation, useQueryClient } from "@tanstack/react-query";
+import { fetchWithValidation } from "../client.js";
+import { useVoyantFinanceContext } from "../provider.js";
+import { financeQueryKeys } from "../query-keys.js";
+import { paymentSessionSingleResponse } from "../schemas.js";
+/**
+ * Admin payment-session transitions
+ * (`POST /v1/admin/finance/payment-sessions/:id/complete` and `/cancel`).
+ * Completing a session settles its invoice/payment side effects
+ * server-side, so payment + invoice lists are invalidated alongside the
+ * session list; callers that render booking-scoped surfaces should also
+ * invalidate their booking keys on success.
+ */
+export function usePaymentSessionMutation() {
+    const { baseUrl, fetcher } = useVoyantFinanceContext();
+    const queryClient = useQueryClient();
+    const invalidate = () => {
+        void queryClient.invalidateQueries({ queryKey: financeQueryKeys.paymentSessions() });
+        void queryClient.invalidateQueries({ queryKey: financeQueryKeys.allPayments() });
+        void queryClient.invalidateQueries({ queryKey: financeQueryKeys.invoices() });
+    };
+    const complete = useMutation({
+        mutationFn: async ({ id, input = {} }) => {
+            const { data } = await fetchWithValidation(`/v1/admin/finance/payment-sessions/${id}/complete`, paymentSessionSingleResponse, { baseUrl, fetcher }, { method: "POST", body: JSON.stringify(input) });
+            return data;
+        },
+        onSuccess: invalidate,
+    });
+    const cancel = useMutation({
+        mutationFn: async ({ id, input = {} }) => {
+            const { data } = await fetchWithValidation(`/v1/admin/finance/payment-sessions/${id}/cancel`, paymentSessionSingleResponse, { baseUrl, fetcher }, { method: "POST", body: JSON.stringify(input) });
+            return data;
+        },
+        onSuccess: invalidate,
+    });
+    return { complete, cancel };
+}

package/dist/hooks/use-payment-sessions.d.ts

@@ -0,0 +1,97 @@
+import type { FinancePaymentSessionListFilters } from "../query-keys.js";
+export interface UsePaymentSessionsOptions extends FinancePaymentSessionListFilters {
+    enabled?: boolean;
+}
+/**
+ * Admin payment-session list (`GET /v1/admin/finance/payment-sessions`).
+ * Filter by `bookingId` + `status: "pending"` to drive the booking detail
+ * page's payment-links card.
+ */
+export declare function usePaymentSessions(options?: UsePaymentSessionsOptions): import("@tanstack/react-query").UseQueryResult<{
+    data: {
+        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: string;
+        targetId: string | null;
+        bookingId: string | null;
+        invoiceId: string | null;
+        bookingPaymentScheduleId: string | null;
+        bookingGuaranteeId: string | null;
+        paymentInstrumentId: string | null;
+        paymentAuthorizationId: string | null;
+        paymentCaptureId: string | null;
+        paymentId: string | null;
+        status: "paid" | "pending" | "failed" | "requires_redirect" | "processing" | "authorized" | "cancelled" | "expired";
+        provider: string | null;
+        providerSessionId: string | null;
+        providerPaymentId: string | null;
+        externalReference: string | null;
+        idempotencyKey: string | null;
+        clientReference: string | null;
+        currency: string;
+        amountCents: number;
+        paymentMethod: "bank_transfer" | "credit_card" | "debit_card" | "cash" | "cheque" | "wallet" | "direct_bill" | "voucher" | "other" | null;
+        payerPersonId: string | null;
+        payerOrganizationId: string | null;
+        payerEmail: string | null;
+        payerName: string | null;
+        redirectUrl: string | null;
+        returnUrl: string | null;
+        cancelUrl: string | null;
+        callbackUrl: string | null;
+        expiresAt: string | null;
+        completedAt: string | null;
+        failedAt: string | null;
+        cancelledAt: string | null;
+        expiredAt: string | null;
+        failureCode: string | null;
+        failureMessage: string | null;
+        notes: string | null;
+        providerPayload: Record<string, unknown> | null;
+        metadata: Record<string, unknown> | null;
+        createdAt: string;
+        updatedAt: string;
+    }[];
+    total: number;
+    limit: number;
+    offset: number;
+}, Error>;
+//# sourceMappingURL=use-payment-sessions.d.ts.map

package/dist/hooks/use-payment-sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-payment-sessions.d.ts","sourceRoot":"","sources":["../../src/hooks/use-payment-sessions.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,kBAAkB,CAAA;AAGxE,MAAM,WAAW,yBAA0B,SAAQ,gCAAgC;IACjF,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,yBAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAQzE"}

package/dist/hooks/use-payment-sessions.js

@@ -0,0 +1,17 @@
+"use client";
+import { useQuery } from "@tanstack/react-query";
+import { useVoyantFinanceContext } from "../provider.js";
+import { getPaymentSessionsQueryOptions } from "../query-options.js";
+/**
+ * Admin payment-session list (`GET /v1/admin/finance/payment-sessions`).
+ * Filter by `bookingId` + `status: "pending"` to drive the booking detail
+ * page's payment-links card.
+ */
+export function usePaymentSessions(options = {}) {
+    const { baseUrl, fetcher } = useVoyantFinanceContext();
+    const { enabled = true, ...filters } = options;
+    return useQuery({
+        ...getPaymentSessionsQueryOptions({ baseUrl, fetcher }, filters),
+        enabled,
+    });
+}

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

@@ -0,0 +1,31 @@
+export interface UsePaymentOptions {
+    enabled?: boolean;
+}
+export declare function usePayment(id: string | null | undefined, options?: UsePaymentOptions): import("@tanstack/react-query").UseQueryResult<{
+    data: {
+        kind: "supplier" | "customer";
+        id: string;
+        invoiceId: string | null;
+        invoiceNumber: string | null;
+        bookingId: string | null;
+        bookingNumber: string | null;
+        supplierId: string | null;
+        supplierName: string | null;
+        personId: string | null;
+        personName: string | null;
+        organizationId: string | null;
+        organizationName: string | null;
+        amountCents: number;
+        currency: string;
+        baseCurrency: string | null;
+        baseAmountCents: number | null;
+        paymentMethod: string;
+        status: "pending" | "completed" | "failed" | "refunded";
+        referenceNumber: string | null;
+        paymentDate: string;
+        notes: string | null;
+        createdAt: string;
+        updatedAt: string;
+    };
+}, Error>;
+//# sourceMappingURL=use-payment.d.ts.map