@voyantjs/checkout-react 0.19.0

package/dist/hooks/index.d.ts

@@ -0,0 +1,5 @@
+export { type CheckoutPaymentLinkConfig, useCheckoutPaymentLinkConfig, } from "./use-checkout-payment-link-config.js";
+export { type CollectPaymentInput, useCollectPayment, type UseCollectPaymentOptions, } from "./use-collect-payment.js";
+export { useInitiateCheckoutCollection } from "./use-initiate-checkout-collection.js";
+export { usePreviewCheckoutCollection } from "./use-preview-checkout-collection.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,yBAAyB,EAC9B,4BAA4B,GAC7B,MAAM,uCAAuC,CAAA;AAC9C,OAAO,EACL,KAAK,mBAAmB,EACxB,iBAAiB,EACjB,KAAK,wBAAwB,GAC9B,MAAM,0BAA0B,CAAA;AACjC,OAAO,EAAE,6BAA6B,EAAE,MAAM,uCAAuC,CAAA;AACrF,OAAO,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAA"}

package/dist/hooks/index.js

@@ -0,0 +1,4 @@
+export { useCheckoutPaymentLinkConfig, } from "./use-checkout-payment-link-config.js";
+export { useCollectPayment, } from "./use-collect-payment.js";
+export { useInitiateCheckoutCollection } from "./use-initiate-checkout-collection.js";
+export { usePreviewCheckoutCollection } from "./use-preview-checkout-collection.js";

package/dist/hooks/use-checkout-payment-link-config.d.ts

@@ -0,0 +1,19 @@
+export interface CheckoutPaymentLinkConfig {
+    bankTransfer: {
+        provider?: string | null;
+        beneficiary: string;
+        iban: string;
+        bankName?: string | null;
+        currency?: string | null;
+        notes?: string | null;
+    } | null;
+}
+/**
+ * Fetch the template-side bank-transfer block for the public payment-link
+ * landing page. Templates expose this at
+ * `/v1/public/payment-link-config` (added to `publicPaths`); when the
+ * endpoint is unavailable or unconfigured, callers fall back to hiding
+ * the bank-transfer tab.
+ */
+export declare function useCheckoutPaymentLinkConfig(): import("@tanstack/react-query").UseQueryResult<CheckoutPaymentLinkConfig, Error>;
+//# sourceMappingURL=use-checkout-payment-link-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-checkout-payment-link-config.d.ts","sourceRoot":"","sources":["../../src/hooks/use-checkout-payment-link-config.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,yBAAyB;IACxC,YAAY,EAAE;QACZ,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QACxB,WAAW,EAAE,MAAM,CAAA;QACnB,IAAI,EAAE,MAAM,CAAA;QACZ,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QACxB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QACxB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KACtB,GAAG,IAAI,CAAA;CACT;AAMD;;;;;;GAMG;AACH,wBAAgB,4BAA4B,qFAe3C"}

package/dist/hooks/use-checkout-payment-link-config.js

@@ -0,0 +1,26 @@
+"use client";
+import { useQuery } from "@tanstack/react-query";
+import { useVoyantCheckoutContext } from "../provider.js";
+/**
+ * Fetch the template-side bank-transfer block for the public payment-link
+ * landing page. Templates expose this at
+ * `/v1/public/payment-link-config` (added to `publicPaths`); when the
+ * endpoint is unavailable or unconfigured, callers fall back to hiding
+ * the bank-transfer tab.
+ */
+export function useCheckoutPaymentLinkConfig() {
+    const { baseUrl, fetcher } = useVoyantCheckoutContext();
+    return useQuery({
+        queryKey: ["checkout-payment-link-config"],
+        queryFn: async () => {
+            const response = await fetcher(`${baseUrl}/v1/public/payment-link-config`, {
+                headers: { Accept: "application/json" },
+            });
+            if (!response.ok)
+                throw new Error(`config fetch failed: ${response.status}`);
+            const body = (await response.json());
+            return body.data;
+        },
+        staleTime: 5 * 60 * 1000,
+    });
+}

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

@@ -0,0 +1,167 @@
+import type { PaymentChoice } from "../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;
+    /** 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:
+ *   - `send_link`     → `method: "card"` + `startProvider` + email notification
+ *   - `bank_transfer` → `method: "bank_transfer"` (returns IBAN block)
+ *   - any other       → throws (the picker should disable the submit button
+ *                       for choices the parent doesn't want to wire here)
+ *
+ * The `saved_method` / `new_card` / `hold` / `extra` choices are vertical-
+ * specific and not handled by this generic mapping. Verticals that need them
+ * call `useInitiateCheckoutCollection` directly with their 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: "invoice" | "schedule" | 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: {
+        id: string;
+        targetType: "other" | "booking" | "order" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "flight_order";
+        targetId: string | null;
+        bookingId: string | null;
+        invoiceId: string | null;
+        bookingPaymentScheduleId: string | null;
+        bookingGuaranteeId: string | null;
+        status: "pending" | "expired" | "cancelled" | "failed" | "paid" | "requires_redirect" | "processing" | "authorized";
+        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;
+    } | null;
+    invoiceNotification: {
+        id: string;
+        templateSlug: string | null;
+        channel: "email" | "sms";
+        provider: string;
+        status: "pending" | "cancelled" | "failed" | "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" | "cancelled" | "failed" | "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/hooks/use-collect-payment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-collect-payment.d.ts","sourceRoot":"","sources":["../../src/hooks/use-collect-payment.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEhD,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,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;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,wBAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wCAsC1F"}

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

@@ -0,0 +1,77 @@
+"use client";
+import { useMutation, useQueryClient } from "@tanstack/react-query";
+import { useVoyantCheckoutContext } from "../provider.js";
+/**
+ * Higher-level collection hook: takes a `PaymentChoice` from `<PaymentStep>`
+ * and translates it into the appropriate `initiateCheckoutCollection` call.
+ *
+ * Routes:
+ *   - `send_link`     → `method: "card"` + `startProvider` + email notification
+ *   - `bank_transfer` → `method: "bank_transfer"` (returns IBAN block)
+ *   - any other       → throws (the picker should disable the submit button
+ *                       for choices the parent doesn't want to wire here)
+ *
+ * The `saved_method` / `new_card` / `hold` / `extra` choices are vertical-
+ * specific and not handled by this generic mapping. Verticals that need them
+ * call `useInitiateCheckoutCollection` directly with their own request body.
+ */
+export function useCollectPayment(bookingId, options = {}) {
+    const { baseUrl, fetcher } = useVoyantCheckoutContext();
+    const qc = useQueryClient();
+    const { cardProvider = "netopia", payerEmail, payerName, notes } = options;
+    return useMutation({
+        mutationFn: async ({ choice, amountCents, }) => {
+            const body = mapChoiceToRequest(choice, amountCents, {
+                cardProvider,
+                payerEmail,
+                payerName,
+                notes,
+            });
+            const response = await fetcher(`${baseUrl}/v1/admin/checkout/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 === "send_link") {
+        return {
+            method: "card",
+            stage: "manual",
+            amountCents,
+            ensureDefaultPaymentPlan: true,
+            paymentSession: {
+                provider: ctx.cardProvider,
+                payerEmail: ctx.payerEmail ?? undefined,
+                payerName: ctx.payerName ?? undefined,
+            },
+            startProvider: { provider: ctx.cardProvider },
+            paymentSessionNotification: ctx.payerEmail
+                ? { channel: "email", to: ctx.payerEmail, templateSlug: "payment-link" }
+                : undefined,
+            notes: ctx.notes ?? undefined,
+        };
+    }
+    if (choice.type === "bank_transfer") {
+        return {
+            method: "bank_transfer",
+            stage: "manual",
+            amountCents,
+            ensureDefaultPaymentPlan: true,
+            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/hooks/use-initiate-checkout-collection.d.ts

@@ -0,0 +1,228 @@
+/**
+ * Admin-side: kick off a checkout collection against a booking. Mounts at
+ * `/v1/admin/checkout/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: "invoice" | "schedule" | 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: {
+        id: string;
+        targetType: "other" | "booking" | "order" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "flight_order";
+        targetId: string | null;
+        bookingId: string | null;
+        invoiceId: string | null;
+        bookingPaymentScheduleId: string | null;
+        bookingGuaranteeId: string | null;
+        status: "pending" | "expired" | "cancelled" | "failed" | "paid" | "requires_redirect" | "processing" | "authorized";
+        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;
+    } | null;
+    invoiceNotification: {
+        id: string;
+        templateSlug: string | null;
+        channel: "email" | "sms";
+        provider: string;
+        status: "pending" | "cancelled" | "failed" | "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" | "cancelled" | "failed" | "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?: "invoice" | "schedule" | undefined;
+    paymentPlan?: {
+        depositMode?: "percentage" | "none" | "fixed_amount" | undefined;
+        depositValue?: number | undefined;
+        depositDueDate?: string | null | undefined;
+        balanceDueDaysBeforeStart?: number | undefined;
+        clearExistingPending?: boolean | undefined;
+        createGuarantee?: boolean | undefined;
+        guaranteeType?: "other" | "voucher" | "bank_transfer" | "credit_card" | "deposit" | "preauth" | "card_on_file" | "agency_letter" | undefined;
+        notes?: string | null | undefined;
+    } | undefined;
+    paymentSession?: {
+        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?: "attachment" | "inline" | null | undefined;
+            contentId?: string | null | undefined;
+        }[] | null | undefined;
+        data?: Record<string, unknown> | null | undefined;
+        metadata?: Record<string, unknown> | null | undefined;
+        scheduledFor?: 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?: "attachment" | "inline" | null | undefined;
+            contentId?: string | null | undefined;
+        }[] | null | undefined;
+        data?: Record<string, unknown> | null | undefined;
+        metadata?: Record<string, unknown> | null | undefined;
+        scheduledFor?: 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/hooks/use-initiate-checkout-collection.d.ts.map

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

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

@@ -0,0 +1,35 @@
+"use client";
+import { useMutation, useQueryClient } from "@tanstack/react-query";
+import { useVoyantCheckoutContext } from "../provider.js";
+/**
+ * Admin-side: kick off a checkout collection against a booking. Mounts at
+ * `/v1/admin/checkout/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 } = useVoyantCheckoutContext();
+    const qc = useQueryClient();
+    return useMutation({
+        mutationFn: async (input) => {
+            const response = await fetcher(`${baseUrl}/v1/admin/checkout/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] });
+        },
+    });
+}

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

@@ -0,0 +1,65 @@
+/**
+ * Admin-side: preview the collection plan for a booking before initiating.
+ * Returns what the operator will collect (deposit / balance / custom amount),
+ * which schedule or invoice the session will target, and which method is
+ * about to be used. Useful for an "About to charge X" confirmation step.
+ */
+export declare function usePreviewCheckoutCollection(bookingId: string): import("@tanstack/react-query").UseMutationResult<{
+    bookingId: string;
+    method: "bank_transfer" | "card";
+    stage: "manual" | "initial" | "reminder";
+    paymentSessionTarget: "invoice" | "schedule" | 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";
+}, Error, {
+    method: "bank_transfer" | "card";
+    stage: "manual" | "initial" | "reminder";
+    ensureDefaultPaymentPlan: boolean;
+    scheduleId?: string | undefined;
+    invoiceId?: string | undefined;
+    amountCents?: number | undefined;
+    paymentSessionTarget?: "invoice" | "schedule" | undefined;
+    paymentPlan?: {
+        depositMode?: "percentage" | "none" | "fixed_amount" | undefined;
+        depositValue?: number | undefined;
+        depositDueDate?: string | null | undefined;
+        balanceDueDaysBeforeStart?: number | undefined;
+        clearExistingPending?: boolean | undefined;
+        createGuarantee?: boolean | undefined;
+        guaranteeType?: "other" | "voucher" | "bank_transfer" | "credit_card" | "deposit" | "preauth" | "card_on_file" | "agency_letter" | undefined;
+        notes?: string | null | undefined;
+    } | undefined;
+} | undefined, unknown>;
+//# sourceMappingURL=use-preview-checkout-collection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-preview-checkout-collection.d.ts","sourceRoot":"","sources":["../../src/hooks/use-preview-checkout-collection.ts"],"names":[],"mappings":"AAcA;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAyB7D"}

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

@@ -0,0 +1,27 @@
+"use client";
+import { useMutation } from "@tanstack/react-query";
+import { useVoyantCheckoutContext } from "../provider.js";
+/**
+ * Admin-side: preview the collection plan for a booking before initiating.
+ * Returns what the operator will collect (deposit / balance / custom amount),
+ * which schedule or invoice the session will target, and which method is
+ * about to be used. Useful for an "About to charge X" confirmation step.
+ */
+export function usePreviewCheckoutCollection(bookingId) {
+    const { baseUrl, fetcher } = useVoyantCheckoutContext();
+    return useMutation({
+        mutationFn: async (input) => {
+            const response = await fetcher(`${baseUrl}/v1/admin/checkout/bookings/${bookingId}/collection-plan`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: input ? JSON.stringify(input) : "{}",
+            });
+            const body = (await response.json());
+            if (!response.ok) {
+                const message = "error" in body ? body.error : `Preview failed: ${response.status}`;
+                throw new Error(message);
+            }
+            return body.data;
+        },
+    });
+}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `@voyantjs/checkout-react` — admin React hooks for the checkout
+ * orchestration layer (`@voyantjs/checkout`) plus the universal payment
+ * choice / capability types consumed by `<PaymentStep>` in
+ * `@voyantjs/checkout-ui`.
+ *
+ * Public-side hooks (`usePublicPaymentSession`,
+ * `usePublicBookingPaymentOptions`) are re-exported from
+ * `@voyantjs/finance-react` so consumers don't have to import from two
+ * places.
+ *
+ * See `docs/architecture/payments-architecture.md`.
+ */
+export { usePublicBookingPaymentOptions, usePublicBookingPayments, usePublicPaymentSession, } from "@voyantjs/finance-react";
+export * from "./hooks/index.js";
+export { useVoyantCheckoutContext, type VoyantCheckoutContextValue, VoyantCheckoutProvider, type VoyantCheckoutProviderProps, } from "./provider.js";
+export { type PaymentChoice, type PaymentStepCapabilities, type PaymentStepExtraOption, type SavedPaymentAccount, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,8BAA8B,EAC9B,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,yBAAyB,CAAA;AAChC,cAAc,kBAAkB,CAAA;AAChC,OAAO,EACL,wBAAwB,EACxB,KAAK,0BAA0B,EAC/B,sBAAsB,EACtB,KAAK,2BAA2B,GACjC,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,GACzB,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,16 @@
+/**
+ * `@voyantjs/checkout-react` — admin React hooks for the checkout
+ * orchestration layer (`@voyantjs/checkout`) plus the universal payment
+ * choice / capability types consumed by `<PaymentStep>` in
+ * `@voyantjs/checkout-ui`.
+ *
+ * Public-side hooks (`usePublicPaymentSession`,
+ * `usePublicBookingPaymentOptions`) are re-exported from
+ * `@voyantjs/finance-react` so consumers don't have to import from two
+ * places.
+ *
+ * See `docs/architecture/payments-architecture.md`.
+ */
+export { usePublicBookingPaymentOptions, usePublicBookingPayments, usePublicPaymentSession, } from "@voyantjs/finance-react";
+export * from "./hooks/index.js";
+export { useVoyantCheckoutContext, VoyantCheckoutProvider, } from "./provider.js";

package/dist/provider.d.ts

@@ -0,0 +1,2 @@
+export { useVoyantReactContext as useVoyantCheckoutContext, type VoyantReactContextValue as VoyantCheckoutContextValue, VoyantReactProvider as VoyantCheckoutProvider, type VoyantReactProviderProps as VoyantCheckoutProviderProps, } from "@voyantjs/react";
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,IAAI,wBAAwB,EACjD,KAAK,uBAAuB,IAAI,0BAA0B,EAC1D,mBAAmB,IAAI,sBAAsB,EAC7C,KAAK,wBAAwB,IAAI,2BAA2B,GAC7D,MAAM,iBAAiB,CAAA"}

package/dist/provider.js

@@ -0,0 +1 @@
+export { useVoyantReactContext as useVoyantCheckoutContext, VoyantReactProvider as VoyantCheckoutProvider, } from "@voyantjs/react";

package/dist/types.d.ts

@@ -0,0 +1,53 @@
+import type { PublicBookingPaymentOptions } from "@voyantjs/finance/public-validation";
+/**
+ * Saved payment instrument as the picker needs it — the canonical finance
+ * projection (`PublicBookingPaymentOptions["accounts"][number]`). Verticals
+ * that already query that endpoint can pass elements through unchanged.
+ */
+export type SavedPaymentAccount = PublicBookingPaymentOptions["accounts"][number];
+/**
+ * Universal payment-choice contract used by the `<PaymentStep>` UI in
+ * `@voyantjs/checkout-ui` and the `useCollectPayment` hook here. The hook
+ * translates a `PaymentChoice` into an `initiateCheckoutCollection` request,
+ * so this type is the seam between presentational picker and orchestration.
+ *
+ * See `docs/architecture/payments-architecture.md` §Core Rule 3.
+ */
+export type PaymentChoice = {
+    type: "saved_method";
+    method: SavedPaymentAccount;
+} | {
+    type: "new_card";
+    cardholderName?: string;
+    cardToken: string;
+    expiry?: string;
+} | {
+    type: "send_link";
+} | {
+    type: "bank_transfer";
+} | {
+    type: "hold";
+} | {
+    type: "extra";
+    optionId: string;
+};
+/**
+ * What the active processor + template offer for the payment step. Honest
+ * booleans — the parent decides each value from what's actually wired
+ * (`paymentStarters` registered in checkout, `bankTransferDetails`
+ * configured, saved methods present, etc.).
+ *
+ * See `docs/architecture/payments-architecture.md` §Core Rule 7.
+ */
+export interface PaymentStepCapabilities {
+    chargeSavedCard?: boolean;
+    newCard?: boolean;
+    sendLink?: boolean;
+    bankTransfer?: boolean;
+}
+export interface PaymentStepExtraOption {
+    id: string;
+    label: string;
+    description: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAA;AAEtF;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,2BAA2B,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAA;AAEjF;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACjF;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,GACzB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAA;AAEvC;;;;;;;GAOG;AACH,MAAM,WAAW,uBAAuB;IACtC,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;CACpB"}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@voyantjs/checkout-react",
+  "version": "0.19.0",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/voyantjs/voyant.git",
+    "directory": "packages/checkout-react"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": "./src/index.ts",
+    "./provider": "./src/provider.tsx",
+    "./hooks": "./src/hooks/index.ts"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist",
+    "prepack": "pnpm run build",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check src/",
+    "test": "vitest run --passWithNoTests"
+  },
+  "peerDependencies": {
+    "@voyantjs/checkout": "workspace:*",
+    "@voyantjs/finance": "workspace:*",
+    "@tanstack/react-query": "^5.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "@tanstack/react-query": "^5.96.2",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "@voyantjs/checkout": "workspace:*",
+    "@voyantjs/finance": "workspace:*",
+    "@voyantjs/finance-react": "workspace:*",
+    "@voyantjs/react": "workspace:*",
+    "@voyantjs/voyant-typescript-config": "workspace:*",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.2"
+  },
+  "dependencies": {
+    "@voyantjs/finance-react": "workspace:*",
+    "@voyantjs/react": "workspace:*"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "import": "./dist/index.js",
+        "default": "./dist/index.js"
+      },
+      "./provider": {
+        "types": "./dist/provider.d.ts",
+        "import": "./dist/provider.js",
+        "default": "./dist/provider.js"
+      },
+      "./hooks": {
+        "types": "./dist/hooks/index.d.ts",
+        "import": "./dist/hooks/index.js",
+        "default": "./dist/hooks/index.js"
+      }
+    },
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts"
+  }
+}