@voyant-travel/finance-react 0.119.5

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

@@ -0,0 +1,225 @@
+import { type InvoiceRecord } from "../schemas.js";
+export interface CreateInvoiceInput {
+    invoiceNumber: string;
+    bookingId: string;
+    personId?: string | null;
+    organizationId?: string | null;
+    status?: InvoiceRecord["status"];
+    currency: string;
+    subtotalCents?: number;
+    taxCents?: number;
+    totalCents?: number;
+    paidCents?: number;
+    balanceDueCents?: number;
+    issueDate: string;
+    dueDate: string;
+    notes?: string | null;
+}
+export type UpdateInvoiceInput = Partial<CreateInvoiceInput>;
+export interface VoidInvoiceInput {
+    reason?: string | null;
+}
+export declare function useInvoiceMutation(): {
+    create: import("@tanstack/react-query").UseMutationResult<{
+        [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, CreateInvoiceInput, unknown>;
+    createFromBooking: import("@tanstack/react-query").UseMutationResult<{
+        [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, CreateInvoiceFromBookingInput, unknown>;
+    convertToInvoice: import("@tanstack/react-query").UseMutationResult<{
+        [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, {
+        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;
+        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, {
+        id: string;
+        input: UpdateInvoiceInput;
+    }, unknown>;
+    remove: import("@tanstack/react-query").UseMutationResult<{
+        success: boolean;
+    }, Error, string, unknown>;
+    voidInvoice: import("@tanstack/react-query").UseMutationResult<{
+        [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, {
+        id: string;
+        input?: VoidInvoiceInput;
+    }, 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;
+    bookingPaymentScheduleId?: string;
+    invoiceNumber?: string;
+    issueDate: string;
+    dueDate: string;
+    notes?: string | null;
+    currency?: string;
+    baseCurrency?: string;
+    fxRateSetId?: string;
+    subtotalCents?: number;
+    taxCents?: number;
+    totalCents?: number;
+    lineItems?: CreateInvoiceFromBookingLineItemInput[];
+    externalRefs?: CreateInvoiceFromBookingExternalRefInput[];
+    /** Defaults to `invoice` on the server. Pass `proforma` for placeholders. */
+    invoiceType?: "invoice" | "proforma";
+    /**
+     * When `true`, downstream e-invoicing plugins (e.g. SmartBill) skip
+     * the auto-sync triggered by `invoice.issued`. The event still fires
+     * so other subscribers (ledgers, audit, etc.) see it.
+     */
+    skipExternalSync?: boolean;
+}
+export interface CreateInvoiceFromBookingExternalRefInput {
+    provider: string;
+    externalId?: string | null;
+    externalNumber?: string | null;
+    externalUrl?: string | null;
+    status?: string | null;
+    metadata?: Record<string, unknown> | null;
+    syncedAt?: string | null;
+    syncError?: string | null;
+}
+export interface CreateInvoiceFromBookingLineItemInput {
+    description: string;
+    quantity: number;
+    unitAmountCents: number;
+    taxRateBps?: number | null;
+    taxAmountCents?: number | null;
+}
+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

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

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

@@ -0,0 +1,121 @@
+"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 { invoiceSingleResponse, successEnvelope } from "../schemas.js";
+export function useInvoiceMutation() {
+    const { baseUrl, fetcher } = useVoyantFinanceContext();
+    const queryClient = useQueryClient();
+    const create = useMutation({
+        mutationFn: async (input) => {
+            const { data } = await fetchWithValidation("/v1/admin/finance/invoices", 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 });
+        },
+    });
+    const update = useMutation({
+        mutationFn: async ({ id, input }) => {
+            const { data } = await fetchWithValidation(`/v1/admin/finance/invoices/${id}`, invoiceSingleResponse, { baseUrl, fetcher }, { method: "PATCH", body: JSON.stringify(input) });
+            return data;
+        },
+        onSuccess: (data) => {
+            void queryClient.invalidateQueries({ queryKey: financeQueryKeys.invoices() });
+            queryClient.setQueryData(financeQueryKeys.invoice(data.id), { data });
+        },
+    });
+    const remove = useMutation({
+        mutationFn: async (id) => fetchWithValidation(`/v1/admin/finance/invoices/${id}`, successEnvelope, { baseUrl, fetcher }, {
+            method: "DELETE",
+        }),
+        onSuccess: (_data, id) => {
+            void queryClient.invalidateQueries({ queryKey: financeQueryKeys.invoices() });
+            queryClient.removeQueries({ queryKey: financeQueryKeys.invoice(id) });
+            queryClient.removeQueries({ queryKey: financeQueryKeys.lineItems(id) });
+            queryClient.removeQueries({ queryKey: financeQueryKeys.payments(id) });
+            queryClient.removeQueries({ queryKey: financeQueryKeys.creditNotes(id) });
+            queryClient.removeQueries({ queryKey: financeQueryKeys.notes(id) });
+        },
+    });
+    const voidInvoice = useMutation({
+        mutationFn: async ({ id, input }) => {
+            const { data } = await fetchWithValidation(`/v1/admin/finance/invoices/${id}/void`, 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 });
+        },
+    });
+    /**
+     * Create + issue an invoice (or proforma) from an existing booking. The
+     * server builds line items from either the booking items or a targeted
+     * payment schedule row, then emits an `invoice.issued` event post-commit.
+     */
+    const createFromBooking = useMutation({
+        mutationFn: async (input) => {
+            const { data } = await fetchWithValidation("/v1/admin/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`, moves any payments onto the final invoice, and emits
+     * `invoice.proforma.converted` so downstream subscribers can preserve
+     * the original external linkage.
+     */
+    const convertToInvoice = useMutation({
+        mutationFn: async ({ id, input }) => {
+            const { data } = await fetchWithValidation(`/v1/admin/finance/invoices/${id}/convert-to-invoice`, invoiceSingleResponse, { baseUrl, fetcher }, { method: "POST", body: JSON.stringify(input ?? {}) });
+            return data;
+        },
+        onSuccess: (data, variables) => {
+            void queryClient.invalidateQueries({ queryKey: financeQueryKeys.invoices() });
+            void queryClient.invalidateQueries({
+                queryKey: financeQueryKeys.adminBookingPayments(data.bookingId),
+            });
+            void queryClient.invalidateQueries({
+                queryKey: financeQueryKeys.publicBookingPayments(data.bookingId),
+            });
+            void queryClient.invalidateQueries({ queryKey: financeQueryKeys.invoice(variables.id) });
+            void queryClient.invalidateQueries({ queryKey: financeQueryKeys.payments(variables.id) });
+            queryClient.setQueryData(financeQueryKeys.invoice(data.id), { data });
+            void queryClient.invalidateQueries({ queryKey: financeQueryKeys.payments(data.id) });
+        },
+    });
+    /**
+     * 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/admin/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, voidInvoice };
+}
+// 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-invoice-note-mutation.d.ts

@@ -0,0 +1,11 @@
+export interface CreateInvoiceNoteInput {
+    content: string;
+}
+export declare function useInvoiceNoteMutation(invoiceId: string): import("@tanstack/react-query").UseMutationResult<{
+    id: string;
+    invoiceId: string;
+    authorId: string;
+    content: string;
+    createdAt: string;
+}, Error, CreateInvoiceNoteInput, unknown>;
+//# sourceMappingURL=use-invoice-note-mutation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-invoice-note-mutation.d.ts","sourceRoot":"","sources":["../../src/hooks/use-invoice-note-mutation.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAA;CAChB;AAMD,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM;;;;;;2CAkBvD"}

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

@@ -0,0 +1,23 @@
+"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 { financeNoteRecordSchema } from "../schemas.js";
+const invoiceNoteSingleResponse = z.object({
+    data: financeNoteRecordSchema,
+});
+export function useInvoiceNoteMutation(invoiceId) {
+    const { baseUrl, fetcher } = useVoyantFinanceContext();
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: async (input) => {
+            const { data } = await fetchWithValidation(`/v1/admin/finance/invoices/${invoiceId}/notes`, invoiceNoteSingleResponse, { baseUrl, fetcher }, { method: "POST", body: JSON.stringify(input) });
+            return data;
+        },
+        onSuccess: () => {
+            void queryClient.invalidateQueries({ queryKey: financeQueryKeys.notes(invoiceId) });
+        },
+    });
+}

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

@@ -0,0 +1,13 @@
+export interface UseInvoiceNotesOptions {
+    enabled?: boolean;
+}
+export declare function useInvoiceNotes(invoiceId: string | null | undefined, options?: UseInvoiceNotesOptions): import("@tanstack/react-query").UseQueryResult<{
+    data: {
+        id: string;
+        invoiceId: string;
+        authorId: string;
+        content: string;
+        createdAt: string;
+    }[];
+}, Error>;
+//# sourceMappingURL=use-invoice-notes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-invoice-notes.d.ts","sourceRoot":"","sources":["../../src/hooks/use-invoice-notes.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,OAAO,GAAE,sBAA2B;;;;;;;;UASrC"}

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

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

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

@@ -0,0 +1,62 @@
+import { type InvoiceNumberResetStrategy, type InvoiceNumberSeriesScope } from "../schemas.js";
+export interface CreateInvoiceNumberSeriesInput {
+    code: string;
+    name: string;
+    prefix?: string;
+    separator?: string;
+    padLength?: number;
+    currentSequence?: number;
+    resetStrategy?: InvoiceNumberResetStrategy;
+    resetAt?: string | null;
+    scope?: InvoiceNumberSeriesScope;
+    isDefault?: boolean;
+    externalProvider?: string | null;
+    externalConfigKey?: string | null;
+    active?: boolean;
+}
+export type UpdateInvoiceNumberSeriesInput = Partial<CreateInvoiceNumberSeriesInput>;
+export declare function useInvoiceNumberSeriesMutation(): {
+    create: import("@tanstack/react-query").UseMutationResult<{
+        id: string;
+        code: string;
+        name: string;
+        prefix: string;
+        separator: string;
+        padLength: number;
+        currentSequence: number;
+        resetStrategy: "never" | "annual" | "monthly";
+        resetAt: string | null;
+        scope: "invoice" | "proforma" | "credit_note";
+        isDefault: boolean;
+        externalProvider: string | null;
+        externalConfigKey: string | null;
+        active: boolean;
+        createdAt: string;
+        updatedAt: string;
+    }, Error, CreateInvoiceNumberSeriesInput, unknown>;
+    update: import("@tanstack/react-query").UseMutationResult<{
+        id: string;
+        code: string;
+        name: string;
+        prefix: string;
+        separator: string;
+        padLength: number;
+        currentSequence: number;
+        resetStrategy: "never" | "annual" | "monthly";
+        resetAt: string | null;
+        scope: "invoice" | "proforma" | "credit_note";
+        isDefault: boolean;
+        externalProvider: string | null;
+        externalConfigKey: string | null;
+        active: boolean;
+        createdAt: string;
+        updatedAt: string;
+    }, Error, {
+        id: string;
+        input: UpdateInvoiceNumberSeriesInput;
+    }, unknown>;
+    remove: import("@tanstack/react-query").UseMutationResult<{
+        success: boolean;
+    }, Error, string, unknown>;
+};
+//# sourceMappingURL=use-invoice-number-series-mutation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-invoice-number-series-mutation.d.ts","sourceRoot":"","sources":["../../src/hooks/use-invoice-number-series-mutation.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,KAAK,0BAA0B,EAE/B,KAAK,wBAAwB,EAG9B,MAAM,eAAe,CAAA;AAEtB,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,aAAa,CAAC,EAAE,0BAA0B,CAAA;IAC1C,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,KAAK,CAAC,EAAE,wBAAwB,CAAA;IAChC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,MAAM,8BAA8B,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAAA;AAEpF,wBAAgB,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAwBF,MAAM;eAAS,8BAA8B;;;;;EA8BxF"}

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

@@ -0,0 +1,39 @@
+"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 { invoiceNumberSeriesSingleResponse, successEnvelope, } from "../schemas.js";
+export function useInvoiceNumberSeriesMutation() {
+    const { baseUrl, fetcher } = useVoyantFinanceContext();
+    const queryClient = useQueryClient();
+    const invalidateLists = () => queryClient.invalidateQueries({ queryKey: financeQueryKeys.invoiceNumberSeries() });
+    const create = useMutation({
+        mutationFn: async (input) => {
+            const { data } = await fetchWithValidation("/v1/admin/finance/invoice-number-series", invoiceNumberSeriesSingleResponse, { baseUrl, fetcher }, { method: "POST", body: JSON.stringify(input) });
+            return data;
+        },
+        onSuccess: (data) => {
+            invalidateLists();
+            queryClient.setQueryData(financeQueryKeys.invoiceNumberSeriesDetail(data.id), { data });
+        },
+    });
+    const update = useMutation({
+        mutationFn: async ({ id, input }) => {
+            const { data } = await fetchWithValidation(`/v1/admin/finance/invoice-number-series/${id}`, invoiceNumberSeriesSingleResponse, { baseUrl, fetcher }, { method: "PATCH", body: JSON.stringify(input) });
+            return data;
+        },
+        onSuccess: (data) => {
+            invalidateLists();
+            queryClient.setQueryData(financeQueryKeys.invoiceNumberSeriesDetail(data.id), { data });
+        },
+    });
+    const remove = useMutation({
+        mutationFn: async (id) => fetchWithValidation(`/v1/admin/finance/invoice-number-series/${id}`, successEnvelope, { baseUrl, fetcher }, { method: "DELETE" }),
+        onSuccess: (_data, id) => {
+            invalidateLists();
+            queryClient.removeQueries({ queryKey: financeQueryKeys.invoiceNumberSeriesDetail(id) });
+        },
+    });
+    return { create, update, remove };
+}

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

@@ -0,0 +1,28 @@
+import type { FinanceInvoiceNumberSeriesListFilters } from "../query-keys.js";
+export interface UseInvoiceNumberSeriesOptions extends FinanceInvoiceNumberSeriesListFilters {
+    enabled?: boolean;
+}
+export declare function useInvoiceNumberSeries(options?: UseInvoiceNumberSeriesOptions): import("@tanstack/react-query").UseQueryResult<{
+    data: {
+        id: string;
+        code: string;
+        name: string;
+        prefix: string;
+        separator: string;
+        padLength: number;
+        currentSequence: number;
+        resetStrategy: "never" | "annual" | "monthly";
+        resetAt: string | null;
+        scope: "invoice" | "proforma" | "credit_note";
+        isDefault: boolean;
+        externalProvider: string | null;
+        externalConfigKey: string | null;
+        active: boolean;
+        createdAt: string;
+        updatedAt: string;
+    }[];
+    total: number;
+    limit: number;
+    offset: number;
+}, Error>;
+//# sourceMappingURL=use-invoice-number-series.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-invoice-number-series.d.ts","sourceRoot":"","sources":["../../src/hooks/use-invoice-number-series.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,qCAAqC,EAAE,MAAM,kBAAkB,CAAA;AAG7E,MAAM,WAAW,6BAA8B,SAAQ,qCAAqC;IAC1F,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,6BAAkC;;;;;;;;;;;;;;;;;;;;;;UAQjF"}

package/dist/hooks/use-invoice-number-series.js

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

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

@@ -0,0 +1,29 @@
+import { type PaymentMethod, type PaymentStatus } from "../schemas.js";
+export interface CreateInvoicePaymentInput {
+    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;
+}
+export declare function useInvoicePaymentMutation(invoiceId: string): 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, CreateInvoicePaymentInput, unknown>;
+//# sourceMappingURL=use-invoice-payment-mutation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-invoice-payment-mutation.d.ts","sourceRoot":"","sources":["../../src/hooks/use-invoice-payment-mutation.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAuB,MAAM,eAAe,CAAA;AAE3F,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,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,EAAE,aAAa,CAAA;IAC5B,MAAM,EAAE,aAAa,CAAA;IACrB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAMD,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM;;;;;;;;;;;;;;8CA8B1D"}

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

@@ -0,0 +1,35 @@
+"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 invoicePaymentSingleResponse = z.object({
+    data: paymentRecordSchema,
+});
+export function useInvoicePaymentMutation(invoiceId) {
+    const { baseUrl, fetcher } = useVoyantFinanceContext();
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: async (input) => {
+            const { data } = await fetchWithValidation(`/v1/admin/finance/invoices/${invoiceId}/payments`, invoicePaymentSingleResponse, { baseUrl, fetcher }, { method: "POST", body: JSON.stringify(input) });
+            return data;
+        },
+        onSuccess: () => {
+            void queryClient.invalidateQueries({ queryKey: financeQueryKeys.payments(invoiceId) });
+            void queryClient.invalidateQueries({ queryKey: financeQueryKeys.invoice(invoiceId) });
+            void queryClient.invalidateQueries({ queryKey: financeQueryKeys.allPayments() });
+            // Booking-scoped payment lists (BookingPaymentsSummary in the
+            // operator/customer dashboards) are keyed by bookingId, which the
+            // POST response doesn't carry. Prefix-invalidate so every active
+            // per-booking query refetches — same approach as `usePaymentMutation`.
+            void queryClient.invalidateQueries({
+                queryKey: [...financeQueryKeys.all, "admin-booking-payments"],
+            });
+            void queryClient.invalidateQueries({
+                queryKey: [...financeQueryKeys.publicCheckout(), "booking-payments"],
+            });
+        },
+    });
+}