@voyantjs/finance-react 0.52.1 → 0.52.2

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyantjs/finance-react",
-  "version": "0.52.1",
+  "version": "0.52.2",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -41,7 +41,7 @@
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "zod": "^4.0.0",
-    "@voyantjs/finance": "0.52.1"
+    "@voyantjs/finance": "0.52.2"
   },
   "devDependencies": {
     "@tanstack/react-query": "^5.96.2",
@@ -52,12 +52,12 @@
     "typescript": "^6.0.2",
     "vitest": "^4.1.2",
     "zod": "^4.3.6",
-    "@voyantjs/finance": "0.52.1",
-    "@voyantjs/react": "0.52.1",
+    "@voyantjs/finance": "0.52.2",
+    "@voyantjs/react": "0.52.2",
     "@voyantjs/voyant-typescript-config": "0.1.0"
   },
   "dependencies": {
-    "@voyantjs/react": "0.52.1"
+    "@voyantjs/react": "0.52.2"
   },
   "files": [
     "dist"