@voyantjs/finance-react 0.52.1 → 0.52.3

package/dist/hooks/index.d.ts

@@ -2,6 +2,7 @@ export * from "./use-admin-booking-payments.js";
 export * from "./use-all-payments.js";
 export * from "./use-booking-guarantees.js";
 export * from "./use-booking-payment-schedules.js";
+export * from "./use-finance-action-ledger.js";
 export * from "./use-invoice.js";
 export * from "./use-invoice-attachment-mutation.js";
 export * from "./use-invoice-attachments.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAA;AAC/C,cAAc,uBAAuB,CAAA;AACrC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,oCAAoC,CAAA;AAClD,cAAc,kBAAkB,CAAA;AAChC,cAAc,sCAAsC,CAAA;AACpD,cAAc,8BAA8B,CAAA;AAC5C,cAAc,uCAAuC,CAAA;AACrD,cAAc,uCAAuC,CAAA;AACrD,cAAc,+BAA+B,CAAA;AAC7C,cAAc,qCAAqC,CAAA;AACnD,cAAc,6BAA6B,CAAA;AAC3C,cAAc,2BAA2B,CAAA;AACzC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,wBAAwB,CAAA;AACtC,cAAc,mCAAmC,CAAA;AACjD,cAAc,2BAA2B,CAAA;AACzC,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA;AAChC,cAAc,mCAAmC,CAAA;AACjD,cAAc,yCAAyC,CAAA;AACvD,cAAc,kCAAkC,CAAA;AAChD,cAAc,+CAA+C,CAAA;AAC7D,cAAc,iCAAiC,CAAA;AAC/C,cAAc,0CAA0C,CAAA;AACxD,cAAc,6CAA6C,CAAA;AAC3D,cAAc,oCAAoC,CAAA;AAClD,cAAc,4BAA4B,CAAA;AAC1C,cAAc,kBAAkB,CAAA;AAChC,cAAc,2BAA2B,CAAA;AACzC,cAAc,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAA;AAC/C,cAAc,uBAAuB,CAAA;AACrC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,oCAAoC,CAAA;AAClD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,kBAAkB,CAAA;AAChC,cAAc,sCAAsC,CAAA;AACpD,cAAc,8BAA8B,CAAA;AAC5C,cAAc,uCAAuC,CAAA;AACrD,cAAc,uCAAuC,CAAA;AACrD,cAAc,+BAA+B,CAAA;AAC7C,cAAc,qCAAqC,CAAA;AACnD,cAAc,6BAA6B,CAAA;AAC3C,cAAc,2BAA2B,CAAA;AACzC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,wBAAwB,CAAA;AACtC,cAAc,mCAAmC,CAAA;AACjD,cAAc,2BAA2B,CAAA;AACzC,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA;AAChC,cAAc,mCAAmC,CAAA;AACjD,cAAc,yCAAyC,CAAA;AACvD,cAAc,kCAAkC,CAAA;AAChD,cAAc,+CAA+C,CAAA;AAC7D,cAAc,iCAAiC,CAAA;AAC/C,cAAc,0CAA0C,CAAA;AACxD,cAAc,6CAA6C,CAAA;AAC3D,cAAc,oCAAoC,CAAA;AAClD,cAAc,4BAA4B,CAAA;AAC1C,cAAc,kBAAkB,CAAA;AAChC,cAAc,2BAA2B,CAAA;AACzC,cAAc,mBAAmB,CAAA"}

package/dist/hooks/index.js

@@ -2,6 +2,7 @@ export * from "./use-admin-booking-payments.js";
 export * from "./use-all-payments.js";
 export * from "./use-booking-guarantees.js";
 export * from "./use-booking-payment-schedules.js";
+export * from "./use-finance-action-ledger.js";
 export * from "./use-invoice.js";
 export * from "./use-invoice-attachment-mutation.js";
 export * from "./use-invoice-attachments.js";

package/dist/hooks/use-admin-booking-payments.d.ts

@@ -16,7 +16,7 @@ export declare function useAdminBookingPayments(bookingId: string | null | undef
             invoiceNumber: string;
             invoiceType: "invoice" | "proforma" | "credit_note";
             status: "pending" | "completed" | "failed" | "refunded";
-            paymentMethod: "other" | "voucher" | "wallet" | "bank_transfer" | "credit_card" | "debit_card" | "cash" | "cheque" | "direct_bill";
+            paymentMethod: "bank_transfer" | "credit_card" | "debit_card" | "cash" | "cheque" | "wallet" | "direct_bill" | "voucher" | "other";
             amountCents: number;
             currency: string;
             paymentDate: string;

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

@@ -7,8 +7,8 @@ export declare function useBookingGuarantees(bookingId: string | null | undefine
         bookingId: string;
         bookingPaymentScheduleId: string | null;
         bookingItemId: string | null;
-        guaranteeType: "other" | "voucher" | "bank_transfer" | "credit_card" | "deposit" | "preauth" | "card_on_file" | "agency_letter";
-        status: "pending" | "failed" | "cancelled" | "active" | "expired" | "released";
+        guaranteeType: "bank_transfer" | "credit_card" | "voucher" | "other" | "deposit" | "preauth" | "card_on_file" | "agency_letter";
+        status: "pending" | "failed" | "cancelled" | "expired" | "active" | "released";
         currency: string | null;
         amountCents: number | null;
         provider: string | null;
@@ -41,8 +41,8 @@ export declare function useBookingGuaranteeMutation(bookingId: string): {
         bookingId: string;
         bookingPaymentScheduleId: string | null;
         bookingItemId: string | null;
-        guaranteeType: "other" | "voucher" | "bank_transfer" | "credit_card" | "deposit" | "preauth" | "card_on_file" | "agency_letter";
-        status: "pending" | "failed" | "cancelled" | "active" | "expired" | "released";
+        guaranteeType: "bank_transfer" | "credit_card" | "voucher" | "other" | "deposit" | "preauth" | "card_on_file" | "agency_letter";
+        status: "pending" | "failed" | "cancelled" | "expired" | "active" | "released";
         currency: string | null;
         amountCents: number | null;
         provider: string | null;
@@ -59,8 +59,8 @@ export declare function useBookingGuaranteeMutation(bookingId: string): {
         bookingId: string;
         bookingPaymentScheduleId: string | null;
         bookingItemId: string | null;
-        guaranteeType: "other" | "voucher" | "bank_transfer" | "credit_card" | "deposit" | "preauth" | "card_on_file" | "agency_letter";
-        status: "pending" | "failed" | "cancelled" | "active" | "expired" | "released";
+        guaranteeType: "bank_transfer" | "credit_card" | "voucher" | "other" | "deposit" | "preauth" | "card_on_file" | "agency_letter";
+        status: "pending" | "failed" | "cancelled" | "expired" | "active" | "released";
         currency: string | null;
         amountCents: number | null;
         provider: string | null;

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

@@ -7,7 +7,7 @@ export declare function useBookingPaymentSchedules(bookingId: string | null | un
         bookingId: string;
         bookingItemId: string | null;
         scheduleType: "other" | "deposit" | "installment" | "balance" | "hold";
-        status: "pending" | "cancelled" | "expired" | "paid" | "due" | "waived";
+        status: "pending" | "paid" | "cancelled" | "expired" | "due" | "waived";
         dueDate: string;
         currency: string;
         amountCents: number;
@@ -32,7 +32,7 @@ export declare function useBookingPaymentScheduleMutation(bookingId: string): {
         bookingId: string;
         bookingItemId: string | null;
         scheduleType: "other" | "deposit" | "installment" | "balance" | "hold";
-        status: "pending" | "cancelled" | "expired" | "paid" | "due" | "waived";
+        status: "pending" | "paid" | "cancelled" | "expired" | "due" | "waived";
         dueDate: string;
         currency: string;
         amountCents: number;
@@ -45,7 +45,7 @@ export declare function useBookingPaymentScheduleMutation(bookingId: string): {
         bookingId: string;
         bookingItemId: string | null;
         scheduleType: "other" | "deposit" | "installment" | "balance" | "hold";
-        status: "pending" | "cancelled" | "expired" | "paid" | "due" | "waived";
+        status: "pending" | "paid" | "cancelled" | "expired" | "due" | "waived";
         dueDate: string;
         currency: string;
         amountCents: number;

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

@@ -0,0 +1,94 @@
+import { type UseFinanceActionLedgerOptions } from "../query-options-action-ledger.js";
+export declare function useInvoiceActionLedger(invoiceId: string | null | undefined, options?: UseFinanceActionLedgerOptions): import("@tanstack/react-query").UseQueryResult<{
+    data: {
+        id: string;
+        occurredAt: string;
+        actionName: string;
+        actionVersion: string;
+        actionKind: "reverse" | "read" | "create" | "update" | "delete" | "execute" | "approve" | "reject" | "compensate" | "duplicate";
+        status: "failed" | "cancelled" | "expired" | "requested" | "awaiting_approval" | "approved" | "denied" | "succeeded" | "reversed" | "compensated" | "superseded";
+        evaluatedRisk: "high" | "low" | "medium" | "critical";
+        actorType: string | null;
+        principalType: "agent" | "user" | "api_key" | "workflow" | "system";
+        principalId: string;
+        principalSubtype: string | null;
+        sessionId: string | null;
+        apiTokenId: string | null;
+        internalRequest: boolean;
+        delegatedByPrincipalType: "agent" | "user" | "api_key" | "workflow" | "system" | null;
+        delegatedByPrincipalId: string | null;
+        delegationId: string | null;
+        callerType: string | null;
+        organizationId: string | null;
+        routeOrToolName: string | null;
+        workflowRunId: string | null;
+        workflowStepId: string | null;
+        correlationId: string | null;
+        causationActionId: string | null;
+        idempotencyScope: string | null;
+        idempotencyKey: string | null;
+        idempotencyFingerprint: string | null;
+        targetType: string;
+        targetId: string;
+        capabilityId: string | null;
+        capabilityVersion: string | null;
+        authorizationSource: string | null;
+        approvalId: string | null;
+        amendsActionId: string | null;
+        createdAt: string;
+        mutationSummary: string | null;
+    }[];
+    pageInfo: {
+        nextCursor: {
+            occurredAt: string;
+            id: string;
+        } | null;
+    };
+}, Error>;
+export declare function usePaymentSessionActionLedger(paymentSessionId: string | null | undefined, options?: UseFinanceActionLedgerOptions): import("@tanstack/react-query").UseQueryResult<{
+    data: {
+        id: string;
+        occurredAt: string;
+        actionName: string;
+        actionVersion: string;
+        actionKind: "reverse" | "read" | "create" | "update" | "delete" | "execute" | "approve" | "reject" | "compensate" | "duplicate";
+        status: "failed" | "cancelled" | "expired" | "requested" | "awaiting_approval" | "approved" | "denied" | "succeeded" | "reversed" | "compensated" | "superseded";
+        evaluatedRisk: "high" | "low" | "medium" | "critical";
+        actorType: string | null;
+        principalType: "agent" | "user" | "api_key" | "workflow" | "system";
+        principalId: string;
+        principalSubtype: string | null;
+        sessionId: string | null;
+        apiTokenId: string | null;
+        internalRequest: boolean;
+        delegatedByPrincipalType: "agent" | "user" | "api_key" | "workflow" | "system" | null;
+        delegatedByPrincipalId: string | null;
+        delegationId: string | null;
+        callerType: string | null;
+        organizationId: string | null;
+        routeOrToolName: string | null;
+        workflowRunId: string | null;
+        workflowStepId: string | null;
+        correlationId: string | null;
+        causationActionId: string | null;
+        idempotencyScope: string | null;
+        idempotencyKey: string | null;
+        idempotencyFingerprint: string | null;
+        targetType: string;
+        targetId: string;
+        capabilityId: string | null;
+        capabilityVersion: string | null;
+        authorizationSource: string | null;
+        approvalId: string | null;
+        amendsActionId: string | null;
+        createdAt: string;
+        mutationSummary: string | null;
+    }[];
+    pageInfo: {
+        nextCursor: {
+            occurredAt: string;
+            id: string;
+        } | null;
+    };
+}, Error>;
+//# sourceMappingURL=use-finance-action-ledger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-finance-action-ledger.d.ts","sourceRoot":"","sources":["../../src/hooks/use-finance-action-ledger.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,6BAA6B,EACnC,MAAM,mCAAmC,CAAA;AAE1C,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,OAAO,GAAE,6BAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAS5C;AAED,wBAAgB,6BAA6B,CAC3C,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC3C,OAAO,GAAE,6BAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAS5C"}

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

@@ -0,0 +1,20 @@
+"use client";
+import { useQuery } from "@tanstack/react-query";
+import { useVoyantFinanceContext } from "../provider.js";
+import { getInvoiceActionLedgerQueryOptions, getPaymentSessionActionLedgerQueryOptions, } from "../query-options-action-ledger.js";
+export function useInvoiceActionLedger(invoiceId, options = {}) {
+    const { baseUrl, fetcher } = useVoyantFinanceContext();
+    const { enabled = true } = options;
+    return useQuery({
+        ...getInvoiceActionLedgerQueryOptions({ baseUrl, fetcher }, invoiceId, options),
+        enabled: enabled && Boolean(invoiceId),
+    });
+}
+export function usePaymentSessionActionLedger(paymentSessionId, options = {}) {
+    const { baseUrl, fetcher } = useVoyantFinanceContext();
+    const { enabled = true } = options;
+    return useQuery({
+        ...getPaymentSessionActionLedgerQueryOptions({ baseUrl, fetcher }, paymentSessionId, options),
+        enabled: enabled && Boolean(paymentSessionId),
+    });
+}

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

@@ -38,6 +38,58 @@ export declare function useInvoiceMutation(): {
         updatedAt: string;
         invoiceType?: "invoice" | "proforma" | "credit_note" | undefined;
     }, Error, CreateInvoiceInput, unknown>;
+    createFromBooking: import("@tanstack/react-query").UseMutationResult<{
+        [x: string]: unknown;
+        id: string;
+        invoiceNumber: string;
+        bookingId: string;
+        personId: string | null;
+        organizationId: string | null;
+        status: "void" | "draft" | "sent" | "partially_paid" | "paid" | "overdue";
+        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;
+    }, Error, CreateInvoiceFromBookingInput, unknown>;
+    convertToInvoice: import("@tanstack/react-query").UseMutationResult<{
+        [x: string]: unknown;
+        id: string;
+        invoiceNumber: string;
+        bookingId: string;
+        personId: string | null;
+        organizationId: string | null;
+        status: "void" | "draft" | "sent" | "partially_paid" | "paid" | "overdue";
+        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;
+    }, Error, {
+        id: string;
+        input?: ConvertProformaInput;
+    }, unknown>;
+    render: import("@tanstack/react-query").UseMutationResult<{
+        [x: string]: unknown;
+        id: string;
+    }, Error, {
+        id: string;
+        input?: RenderInvoiceInput;
+    }, unknown>;
     update: import("@tanstack/react-query").UseMutationResult<{
         [x: string]: unknown;
         id: string;
@@ -66,4 +118,24 @@ export declare function useInvoiceMutation(): {
         success: boolean;
     }, Error, string, unknown>;
 };
+export interface ConvertProformaInput {
+    /** Optional override; server derives from the proforma number when omitted. */
+    invoiceNumber?: string;
+    issueDate?: string;
+    dueDate?: string;
+}
+export interface CreateInvoiceFromBookingInput {
+    bookingId: string;
+    invoiceNumber: string;
+    issueDate: string;
+    dueDate: string;
+    notes?: string | null;
+    /** Defaults to `invoice` on the server. Pass `proforma` for placeholders. */
+    invoiceType?: "invoice" | "proforma";
+}
+export interface RenderInvoiceInput {
+    format?: "pdf" | "html";
+    /** Optional invoice-template id; server falls back to the default. */
+    templateId?: string | null;
+}
 //# sourceMappingURL=use-invoice-mutation.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"use-invoice-mutation.d.ts","sourceRoot":"","sources":["../../src/hooks/use-invoice-mutation.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,aAAa,EAA0C,MAAM,eAAe,CAAA;AAE1F,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,MAAM,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAA;IAChC,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAED,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAA;AAE5D,wBAAgB,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAqBU,MAAM;eAAS,kBAAkB;;;;;EAoC5E"}
+{"version":3,"file":"use-invoice-mutation.d.ts","sourceRoot":"","sources":["../../src/hooks/use-invoice-mutation.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,aAAa,EAA0C,MAAM,eAAe,CAAA;AAE1F,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,MAAM,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAA;IAChC,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAED,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAA;AAE5D,wBAAgB,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAqFU,MAAM;gBAAU,oBAAoB;;;;;;YAsBpC,MAAM;gBAAU,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;YAtFlC,MAAM;eAAS,kBAAkB;;;;;EAwG5E;AAED,MAAM,WAAW,oBAAoB;IACnC,+EAA+E;IAC/E,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,6BAA6B;IAC5C,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,SAAS,GAAG,UAAU,CAAA;CACrC;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;IACvB,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B"}

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

@@ -1,5 +1,6 @@
 "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";
@@ -40,5 +41,62 @@ export function useInvoiceMutation() {
             queryClient.removeQueries({ queryKey: financeQueryKeys.notes(id) });
         },
     });
-    return { create, update, remove };
+    /**
+     * Create + issue an invoice (or proforma) from an existing booking. The
+     * server walks the booking's items, builds line items, and emits an
+     * `invoice.issued` event post-commit. Used by the Documents tab on the
+     * booking detail page to bootstrap an invoice when none exists yet.
+     */
+    const createFromBooking = useMutation({
+        mutationFn: async (input) => {
+            const { data } = await fetchWithValidation("/v1/finance/invoices/from-booking", invoiceSingleResponse, { baseUrl, fetcher }, { method: "POST", body: JSON.stringify(input) });
+            return data;
+        },
+        onSuccess: (data) => {
+            void queryClient.invalidateQueries({ queryKey: financeQueryKeys.invoices() });
+            queryClient.setQueryData(financeQueryKeys.invoice(data.id), { data });
+        },
+    });
+    /**
+     * Convert an issued proforma into a final invoice. Server-side this
+     * copies the proforma's line items + totals, marks the proforma as
+     * `void`, and emits `invoice.issued` with `convertedFromInvoiceId` so
+     * the SmartBill subscriber (and audit chain) sees the linkage.
+     */
+    const convertToInvoice = useMutation({
+        mutationFn: async ({ id, input }) => {
+            const { data } = await fetchWithValidation(`/v1/finance/invoices/${id}/convert-to-invoice`, invoiceSingleResponse, { baseUrl, fetcher }, { method: "POST", body: JSON.stringify(input ?? {}) });
+            return data;
+        },
+        onSuccess: (data) => {
+            void queryClient.invalidateQueries({ queryKey: financeQueryKeys.invoices() });
+            queryClient.setQueryData(financeQueryKeys.invoice(data.id), { data });
+        },
+    });
+    /**
+     * Render (or re-render) a PDF for an existing invoice. Server-side this
+     * inserts an `invoice_rendition` row + emits `invoice.rendered`, which a
+     * downstream subscriber turns into a stored PDF attachment. Use this for
+     * the operator's "Generate" / "Regenerate" buttons.
+     */
+    const render = useMutation({
+        mutationFn: async ({ id, input }) => {
+            const { data } = await fetchWithValidation(`/v1/finance/invoices/${id}/render`, invoiceRenditionResponse, { baseUrl, fetcher }, { method: "POST", body: JSON.stringify(input ?? { format: "pdf" }) });
+            return data;
+        },
+        onSuccess: (_data, variables) => {
+            void queryClient.invalidateQueries({
+                queryKey: financeQueryKeys.invoice(variables.id),
+            });
+            void queryClient.invalidateQueries({ queryKey: financeQueryKeys.invoices() });
+        },
+    });
+    return { create, createFromBooking, convertToInvoice, render, update, remove };
 }
+// Light envelope schema for the render endpoint — the server returns
+// `{ data: rendition }` where rendition is { id, invoiceId, format, ... }.
+// We only assert the wrapper so the hook stays portable across renditions
+// shape changes; consumers that care can narrow on the data field.
+const invoiceRenditionResponse = z.object({
+    data: z.object({ id: z.string() }).passthrough(),
+});

package/dist/hooks/use-public-booking-documents.d.ts

@@ -16,8 +16,8 @@ export declare function usePublicBookingDocuments(bookingId: string | null | und
             issueDate: string;
             dueDate: string;
             renditionId: string | null;
-            documentStatus: "pending" | "failed" | "ready" | "stale" | "missing";
-            format: "json" | "pdf" | "html" | "xml" | null;
+            documentStatus: "pending" | "failed" | "missing" | "ready" | "stale";
+            format: "html" | "pdf" | "xml" | "json" | null;
             language: string | null;
             generatedAt: string | null;
             fileSize: number | null;

package/dist/hooks/use-public-booking-payment-options.d.ts

@@ -9,8 +9,8 @@ export declare function usePublicBookingPaymentOptions(bookingId: string | null
             id: string;
             label: string;
             provider: string | null;
-            instrumentType: "other" | "voucher" | "wallet" | "credit_card" | "debit_card" | "cash" | "direct_bill" | "bank_account";
-            status: "active" | "expired" | "revoked" | "inactive" | "failed_verification";
+            instrumentType: "credit_card" | "debit_card" | "cash" | "wallet" | "direct_bill" | "voucher" | "other" | "bank_account";
+            status: "expired" | "active" | "inactive" | "revoked" | "failed_verification";
             brand: string | null;
             last4: string | null;
             expiryMonth: number | null;
@@ -20,7 +20,7 @@ export declare function usePublicBookingPaymentOptions(bookingId: string | null
         schedules: {
             id: string;
             scheduleType: "other" | "deposit" | "installment" | "balance" | "hold";
-            status: "pending" | "cancelled" | "expired" | "paid" | "due" | "waived";
+            status: "pending" | "paid" | "cancelled" | "expired" | "due" | "waived";
             dueDate: string;
             currency: string;
             amountCents: number;

package/dist/hooks/use-public-booking-payments.d.ts

@@ -10,7 +10,7 @@ export declare function usePublicBookingPayments(bookingId: string | null | unde
             invoiceNumber: string;
             invoiceType: "invoice" | "proforma" | "credit_note";
             status: "pending" | "completed" | "failed" | "refunded";
-            paymentMethod: "other" | "voucher" | "wallet" | "bank_transfer" | "credit_card" | "debit_card" | "cash" | "cheque" | "direct_bill";
+            paymentMethod: "bank_transfer" | "credit_card" | "debit_card" | "cash" | "cheque" | "wallet" | "direct_bill" | "voucher" | "other";
             amountCents: number;
             currency: string;
             paymentDate: string;

package/dist/hooks/use-public-finance-document-by-reference.d.ts

@@ -14,8 +14,8 @@ export declare function usePublicFinanceDocumentByReference(reference: string |
         issueDate: string;
         dueDate: string;
         renditionId: string | null;
-        documentStatus: "pending" | "failed" | "ready" | "stale" | "missing";
-        format: "json" | "pdf" | "html" | "xml" | null;
+        documentStatus: "pending" | "failed" | "missing" | "ready" | "stale";
+        format: "html" | "pdf" | "xml" | "json" | null;
         language: string | null;
         generatedAt: string | null;
         fileSize: number | null;

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

@@ -19,7 +19,7 @@ export declare function usePublicPaymentSessionMutation(): import("@tanstack/rea
         invoiceId: string | null;
         bookingPaymentScheduleId: string | null;
         bookingGuaranteeId: string | null;
-        status: "pending" | "failed" | "cancelled" | "expired" | "paid" | "requires_redirect" | "processing" | "authorized";
+        status: "pending" | "failed" | "paid" | "requires_redirect" | "processing" | "authorized" | "cancelled" | "expired";
         provider: string | null;
         providerSessionId: string | null;
         providerPaymentId: string | null;
@@ -27,7 +27,7 @@ export declare function usePublicPaymentSessionMutation(): import("@tanstack/rea
         clientReference: string | null;
         currency: string;
         amountCents: number;
-        paymentMethod: "other" | "voucher" | "wallet" | "bank_transfer" | "credit_card" | "debit_card" | "cash" | "cheque" | "direct_bill" | null;
+        paymentMethod: "bank_transfer" | "credit_card" | "debit_card" | "cash" | "cheque" | "wallet" | "direct_bill" | "voucher" | "other" | null;
         payerEmail: string | null;
         payerName: string | null;
         redirectUrl: string | null;

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

@@ -10,7 +10,7 @@ export declare function usePublicPaymentSession(sessionId: string | null | undef
         invoiceId: string | null;
         bookingPaymentScheduleId: string | null;
         bookingGuaranteeId: string | null;
-        status: "pending" | "failed" | "cancelled" | "expired" | "paid" | "requires_redirect" | "processing" | "authorized";
+        status: "pending" | "failed" | "paid" | "requires_redirect" | "processing" | "authorized" | "cancelled" | "expired";
         provider: string | null;
         providerSessionId: string | null;
         providerPaymentId: string | null;
@@ -18,7 +18,7 @@ export declare function usePublicPaymentSession(sessionId: string | null | undef
         clientReference: string | null;
         currency: string;
         amountCents: number;
-        paymentMethod: "other" | "voucher" | "wallet" | "bank_transfer" | "credit_card" | "debit_card" | "cash" | "cheque" | "direct_bill" | null;
+        paymentMethod: "bank_transfer" | "credit_card" | "debit_card" | "cash" | "cheque" | "wallet" | "direct_bill" | "voucher" | "other" | null;
         payerEmail: string | null;
         payerName: string | null;
         redirectUrl: string | null;

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

@@ -33,7 +33,7 @@ export declare function useVoucherMutation(): {
     issue: import("@tanstack/react-query").UseMutationResult<{
         id: string;
         code: string;
-        status: "void" | "active" | "expired" | "redeemed";
+        status: "void" | "expired" | "active" | "redeemed";
         currency: string;
         initialAmountCents: number;
         remainingAmountCents: number;
@@ -51,7 +51,7 @@ export declare function useVoucherMutation(): {
     update: import("@tanstack/react-query").UseMutationResult<{
         id: string;
         code: string;
-        status: "void" | "active" | "expired" | "redeemed";
+        status: "void" | "expired" | "active" | "redeemed";
         currency: string;
         initialAmountCents: number;
         remainingAmountCents: number;
@@ -73,7 +73,7 @@ export declare function useVoucherMutation(): {
         voucher: {
             id: string;
             code: string;
-            status: "void" | "active" | "expired" | "redeemed";
+            status: "void" | "expired" | "active" | "redeemed";
             currency: string;
             initialAmountCents: number;
             remainingAmountCents: number;

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

@@ -10,7 +10,7 @@ export declare function useVoucher(id: string | null | undefined, options?: UseV
     data: {
         id: string;
         code: string;
-        status: "void" | "active" | "expired" | "redeemed";
+        status: "void" | "expired" | "active" | "redeemed";
         currency: string;
         initialAmountCents: number;
         remainingAmountCents: number;

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

@@ -12,7 +12,7 @@ export declare function useVouchers(options?: UseVouchersOptions): import("@tans
     data: {
         id: string;
         code: string;
-        status: "void" | "active" | "expired" | "redeemed";
+        status: "void" | "expired" | "active" | "redeemed";
         currency: string;
         initialAmountCents: number;
         remainingAmountCents: number;

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 export { defaultFetcher, fetchWithValidation, VoyantApiError, type VoyantFetcher, withQueryParams, } from "./client.js";
 export * from "./hooks/index.js";
-export { getAdminBookingPayments, getPublicBookingDocuments, getPublicBookingPaymentOptions, getPublicBookingPayments, getPublicFinanceDocumentByReference, getPublicPaymentSession, startPublicBookingGuaranteePaymentSession, startPublicBookingSchedulePaymentSession, validatePublicVoucher, } from "./operations.js";
+export { type FinanceActionLedgerListInput, getAdminBookingPayments, getPublicBookingDocuments, getPublicBookingPaymentOptions, getPublicBookingPayments, getPublicFinanceDocumentByReference, getPublicPaymentSession, listInvoiceActionLedger, listPaymentSessionActionLedger, startPublicBookingGuaranteePaymentSession, startPublicBookingSchedulePaymentSession, validatePublicVoucher, } from "./operations.js";
 export { useVoyantFinanceContext, type VoyantFinanceContextValue, VoyantFinanceProvider, type VoyantFinanceProviderProps, } from "./provider.js";
-export { type FinanceAllPaymentsListFilters, type FinanceAllPaymentsListSortDir, type FinanceAllPaymentsListSortField, type FinanceInvoiceListFilters, type FinanceInvoiceListSortDir, type FinanceInvoiceListSortField, type FinancePaymentKind, type FinanceSupplierPaymentListFilters, type FinanceSupplierPaymentListSortDir, type FinanceSupplierPaymentListSortField, financeQueryKeys, } from "./query-keys.js";
-export { getAdminBookingPaymentsQueryOptions, getAllPaymentsQueryOptions, getBookingGuaranteesQueryOptions, getBookingPaymentSchedulesQueryOptions, getInvoiceAttachmentsQueryOptions, getInvoiceCreditNotesQueryOptions, getInvoiceLineItemsQueryOptions, getInvoiceNotesQueryOptions, getInvoicePaymentsQueryOptions, getInvoiceQueryOptions, getInvoicesQueryOptions, getPaymentQueryOptions, getPublicBookingDocumentsQueryOptions, getPublicBookingPaymentOptionsQueryOptions, getPublicBookingPaymentsQueryOptions, getPublicFinanceDocumentByReferenceQueryOptions, getPublicPaymentSessionQueryOptions, getSupplierPaymentsQueryOptions, getVoucherQueryOptions, getVouchersQueryOptions, } from "./query-options.js";
+export { type FinanceActionLedgerListCursor, type FinanceActionLedgerListFilters, type FinanceAllPaymentsListFilters, type FinanceAllPaymentsListSortDir, type FinanceAllPaymentsListSortField, type FinanceInvoiceListFilters, type FinanceInvoiceListSortDir, type FinanceInvoiceListSortField, type FinancePaymentKind, type FinanceSupplierPaymentListFilters, type FinanceSupplierPaymentListSortDir, type FinanceSupplierPaymentListSortField, financeQueryKeys, } from "./query-keys.js";
+export { getAdminBookingPaymentsQueryOptions, getAllPaymentsQueryOptions, getBookingGuaranteesQueryOptions, getBookingPaymentSchedulesQueryOptions, getInvoiceActionLedgerQueryOptions, getInvoiceAttachmentsQueryOptions, getInvoiceCreditNotesQueryOptions, getInvoiceLineItemsQueryOptions, getInvoiceNotesQueryOptions, getInvoicePaymentsQueryOptions, getInvoiceQueryOptions, getInvoicesQueryOptions, getPaymentQueryOptions, getPaymentSessionActionLedgerQueryOptions, getPublicBookingDocumentsQueryOptions, getPublicBookingPaymentOptionsQueryOptions, getPublicBookingPaymentsQueryOptions, getPublicFinanceDocumentByReferenceQueryOptions, getPublicPaymentSessionQueryOptions, getSupplierPaymentsQueryOptions, getVoucherQueryOptions, getVouchersQueryOptions, } from "./query-options.js";
 export * from "./schemas.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,KAAK,aAAa,EAClB,eAAe,GAChB,MAAM,aAAa,CAAA;AACpB,cAAc,kBAAkB,CAAA;AAChC,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,8BAA8B,EAC9B,wBAAwB,EACxB,mCAAmC,EACnC,uBAAuB,EACvB,yCAAyC,EACzC,wCAAwC,EACxC,qBAAqB,GACtB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,uBAAuB,EACvB,KAAK,yBAAyB,EAC9B,qBAAqB,EACrB,KAAK,0BAA0B,GAChC,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,KAAK,6BAA6B,EAClC,KAAK,6BAA6B,EAClC,KAAK,+BAA+B,EACpC,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,2BAA2B,EAChC,KAAK,kBAAkB,EACvB,KAAK,iCAAiC,EACtC,KAAK,iCAAiC,EACtC,KAAK,mCAAmC,EACxC,gBAAgB,GACjB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,mCAAmC,EACnC,0BAA0B,EAC1B,gCAAgC,EAChC,sCAAsC,EACtC,iCAAiC,EACjC,iCAAiC,EACjC,+BAA+B,EAC/B,2BAA2B,EAC3B,8BAA8B,EAC9B,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,qCAAqC,EACrC,0CAA0C,EAC1C,oCAAoC,EACpC,+CAA+C,EAC/C,mCAAmC,EACnC,+BAA+B,EAC/B,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,oBAAoB,CAAA;AAC3B,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,KAAK,aAAa,EAClB,eAAe,GAChB,MAAM,aAAa,CAAA;AACpB,cAAc,kBAAkB,CAAA;AAChC,OAAO,EACL,KAAK,4BAA4B,EACjC,uBAAuB,EACvB,yBAAyB,EACzB,8BAA8B,EAC9B,wBAAwB,EACxB,mCAAmC,EACnC,uBAAuB,EACvB,uBAAuB,EACvB,8BAA8B,EAC9B,yCAAyC,EACzC,wCAAwC,EACxC,qBAAqB,GACtB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,uBAAuB,EACvB,KAAK,yBAAyB,EAC9B,qBAAqB,EACrB,KAAK,0BAA0B,GAChC,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,KAAK,6BAA6B,EAClC,KAAK,8BAA8B,EACnC,KAAK,6BAA6B,EAClC,KAAK,6BAA6B,EAClC,KAAK,+BAA+B,EACpC,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,2BAA2B,EAChC,KAAK,kBAAkB,EACvB,KAAK,iCAAiC,EACtC,KAAK,iCAAiC,EACtC,KAAK,mCAAmC,EACxC,gBAAgB,GACjB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,mCAAmC,EACnC,0BAA0B,EAC1B,gCAAgC,EAChC,sCAAsC,EACtC,kCAAkC,EAClC,iCAAiC,EACjC,iCAAiC,EACjC,+BAA+B,EAC/B,2BAA2B,EAC3B,8BAA8B,EAC9B,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,yCAAyC,EACzC,qCAAqC,EACrC,0CAA0C,EAC1C,oCAAoC,EACpC,+CAA+C,EAC/C,mCAAmC,EACnC,+BAA+B,EAC/B,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,oBAAoB,CAAA;AAC3B,cAAc,cAAc,CAAA"}

package/dist/index.js

@@ -1,7 +1,7 @@
 export { defaultFetcher, fetchWithValidation, VoyantApiError, withQueryParams, } from "./client.js";
 export * from "./hooks/index.js";
-export { getAdminBookingPayments, getPublicBookingDocuments, getPublicBookingPaymentOptions, getPublicBookingPayments, getPublicFinanceDocumentByReference, getPublicPaymentSession, startPublicBookingGuaranteePaymentSession, startPublicBookingSchedulePaymentSession, validatePublicVoucher, } from "./operations.js";
+export { getAdminBookingPayments, getPublicBookingDocuments, getPublicBookingPaymentOptions, getPublicBookingPayments, getPublicFinanceDocumentByReference, getPublicPaymentSession, listInvoiceActionLedger, listPaymentSessionActionLedger, startPublicBookingGuaranteePaymentSession, startPublicBookingSchedulePaymentSession, validatePublicVoucher, } from "./operations.js";
 export { useVoyantFinanceContext, VoyantFinanceProvider, } from "./provider.js";
 export { financeQueryKeys, } from "./query-keys.js";
-export { getAdminBookingPaymentsQueryOptions, getAllPaymentsQueryOptions, getBookingGuaranteesQueryOptions, getBookingPaymentSchedulesQueryOptions, getInvoiceAttachmentsQueryOptions, getInvoiceCreditNotesQueryOptions, getInvoiceLineItemsQueryOptions, getInvoiceNotesQueryOptions, getInvoicePaymentsQueryOptions, getInvoiceQueryOptions, getInvoicesQueryOptions, getPaymentQueryOptions, getPublicBookingDocumentsQueryOptions, getPublicBookingPaymentOptionsQueryOptions, getPublicBookingPaymentsQueryOptions, getPublicFinanceDocumentByReferenceQueryOptions, getPublicPaymentSessionQueryOptions, getSupplierPaymentsQueryOptions, getVoucherQueryOptions, getVouchersQueryOptions, } from "./query-options.js";
+export { getAdminBookingPaymentsQueryOptions, getAllPaymentsQueryOptions, getBookingGuaranteesQueryOptions, getBookingPaymentSchedulesQueryOptions, getInvoiceActionLedgerQueryOptions, getInvoiceAttachmentsQueryOptions, getInvoiceCreditNotesQueryOptions, getInvoiceLineItemsQueryOptions, getInvoiceNotesQueryOptions, getInvoicePaymentsQueryOptions, getInvoiceQueryOptions, getInvoicesQueryOptions, getPaymentQueryOptions, getPaymentSessionActionLedgerQueryOptions, getPublicBookingDocumentsQueryOptions, getPublicBookingPaymentOptionsQueryOptions, getPublicBookingPaymentsQueryOptions, getPublicFinanceDocumentByReferenceQueryOptions, getPublicPaymentSessionQueryOptions, getSupplierPaymentsQueryOptions, getVoucherQueryOptions, getVouchersQueryOptions, } from "./query-options.js";
 export * from "./schemas.js";