@voyantjs/finance-react 0.2.0

package/dist/query-options.d.ts

@@ -0,0 +1,485 @@
+import { type FetchWithValidationOptions } from "./client.js";
+import type { UseInvoiceOptions } from "./hooks/use-invoice.js";
+import type { UseInvoiceCreditNotesOptions } from "./hooks/use-invoice-credit-notes.js";
+import type { UseInvoiceLineItemsOptions } from "./hooks/use-invoice-line-items.js";
+import type { UseInvoiceNotesOptions } from "./hooks/use-invoice-notes.js";
+import type { UseInvoicePaymentsOptions } from "./hooks/use-invoice-payments.js";
+import type { UseInvoicesOptions } from "./hooks/use-invoices.js";
+import type { UseSupplierPaymentsOptions } from "./hooks/use-supplier-payments.js";
+export declare function getInvoicesQueryOptions(client: FetchWithValidationOptions, options?: UseInvoicesOptions): import("@tanstack/react-query").OmitKeyof<import("@tanstack/react-query").UseQueryOptions<{
+    data: {
+        id: string;
+        invoiceNumber: string;
+        bookingId: string;
+        personId: string | null;
+        organizationId: string | null;
+        status: "draft" | "void" | "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;
+    }[];
+    total: number;
+    limit: number;
+    offset: number;
+}, Error, {
+    data: {
+        id: string;
+        invoiceNumber: string;
+        bookingId: string;
+        personId: string | null;
+        organizationId: string | null;
+        status: "draft" | "void" | "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;
+    }[];
+    total: number;
+    limit: number;
+    offset: number;
+}, readonly ["voyant", "finance", "invoices", "list", import("./query-keys.js").FinanceInvoiceListFilters]>, "queryFn"> & {
+    queryFn?: import("@tanstack/react-query").QueryFunction<{
+        data: {
+            id: string;
+            invoiceNumber: string;
+            bookingId: string;
+            personId: string | null;
+            organizationId: string | null;
+            status: "draft" | "void" | "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;
+        }[];
+        total: number;
+        limit: number;
+        offset: number;
+    }, readonly ["voyant", "finance", "invoices", "list", import("./query-keys.js").FinanceInvoiceListFilters], never> | undefined;
+} & {
+    queryKey: readonly ["voyant", "finance", "invoices", "list", import("./query-keys.js").FinanceInvoiceListFilters] & {
+        [dataTagSymbol]: {
+            data: {
+                id: string;
+                invoiceNumber: string;
+                bookingId: string;
+                personId: string | null;
+                organizationId: string | null;
+                status: "draft" | "void" | "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;
+            }[];
+            total: number;
+            limit: number;
+            offset: number;
+        };
+        [dataTagErrorSymbol]: Error;
+    };
+};
+export declare function getSupplierPaymentsQueryOptions(client: FetchWithValidationOptions, options?: UseSupplierPaymentsOptions): import("@tanstack/react-query").OmitKeyof<import("@tanstack/react-query").UseQueryOptions<{
+    data: {
+        id: string;
+        bookingId: string;
+        supplierId: string | null;
+        amountCents: number;
+        currency: string;
+        paymentMethod: string;
+        status: "pending" | "completed" | "failed" | "refunded";
+        referenceNumber: string | null;
+        paymentDate: string;
+        createdAt: string;
+        notes?: string | null | undefined;
+    }[];
+    total: number;
+    limit: number;
+    offset: number;
+}, Error, {
+    data: {
+        id: string;
+        bookingId: string;
+        supplierId: string | null;
+        amountCents: number;
+        currency: string;
+        paymentMethod: string;
+        status: "pending" | "completed" | "failed" | "refunded";
+        referenceNumber: string | null;
+        paymentDate: string;
+        createdAt: string;
+        notes?: string | null | undefined;
+    }[];
+    total: number;
+    limit: number;
+    offset: number;
+}, readonly ["voyant", "finance", "supplier-payments", "list", import("./query-keys.js").FinanceSupplierPaymentListFilters]>, "queryFn"> & {
+    queryFn?: import("@tanstack/react-query").QueryFunction<{
+        data: {
+            id: string;
+            bookingId: string;
+            supplierId: string | null;
+            amountCents: number;
+            currency: string;
+            paymentMethod: string;
+            status: "pending" | "completed" | "failed" | "refunded";
+            referenceNumber: string | null;
+            paymentDate: string;
+            createdAt: string;
+            notes?: string | null | undefined;
+        }[];
+        total: number;
+        limit: number;
+        offset: number;
+    }, readonly ["voyant", "finance", "supplier-payments", "list", import("./query-keys.js").FinanceSupplierPaymentListFilters], never> | undefined;
+} & {
+    queryKey: readonly ["voyant", "finance", "supplier-payments", "list", import("./query-keys.js").FinanceSupplierPaymentListFilters] & {
+        [dataTagSymbol]: {
+            data: {
+                id: string;
+                bookingId: string;
+                supplierId: string | null;
+                amountCents: number;
+                currency: string;
+                paymentMethod: string;
+                status: "pending" | "completed" | "failed" | "refunded";
+                referenceNumber: string | null;
+                paymentDate: string;
+                createdAt: string;
+                notes?: string | null | undefined;
+            }[];
+            total: number;
+            limit: number;
+            offset: number;
+        };
+        [dataTagErrorSymbol]: Error;
+    };
+};
+export declare function getInvoiceQueryOptions(client: FetchWithValidationOptions, id: string | null | undefined, options?: UseInvoiceOptions): import("@tanstack/react-query").OmitKeyof<import("@tanstack/react-query").UseQueryOptions<{
+    data: {
+        id: string;
+        invoiceNumber: string;
+        bookingId: string;
+        personId: string | null;
+        organizationId: string | null;
+        status: "draft" | "void" | "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;
+    };
+}, Error, {
+    data: {
+        id: string;
+        invoiceNumber: string;
+        bookingId: string;
+        personId: string | null;
+        organizationId: string | null;
+        status: "draft" | "void" | "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;
+    };
+}, readonly ["voyant", "finance", "invoices", "detail", string]>, "queryFn"> & {
+    queryFn?: import("@tanstack/react-query").QueryFunction<{
+        data: {
+            id: string;
+            invoiceNumber: string;
+            bookingId: string;
+            personId: string | null;
+            organizationId: string | null;
+            status: "draft" | "void" | "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;
+        };
+    }, readonly ["voyant", "finance", "invoices", "detail", string], never> | undefined;
+} & {
+    queryKey: readonly ["voyant", "finance", "invoices", "detail", string] & {
+        [dataTagSymbol]: {
+            data: {
+                id: string;
+                invoiceNumber: string;
+                bookingId: string;
+                personId: string | null;
+                organizationId: string | null;
+                status: "draft" | "void" | "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;
+            };
+        };
+        [dataTagErrorSymbol]: Error;
+    };
+};
+export declare function getInvoiceLineItemsQueryOptions(client: FetchWithValidationOptions, invoiceId: string | null | undefined, options?: UseInvoiceLineItemsOptions): import("@tanstack/react-query").OmitKeyof<import("@tanstack/react-query").UseQueryOptions<{
+    data: {
+        id: string;
+        invoiceId: string;
+        description: string;
+        quantity: number;
+        unitPriceCents: number;
+        totalCents: number;
+        taxRate: number | null;
+        sortOrder: number;
+        createdAt: string;
+    }[];
+}, Error, {
+    data: {
+        id: string;
+        invoiceId: string;
+        description: string;
+        quantity: number;
+        unitPriceCents: number;
+        totalCents: number;
+        taxRate: number | null;
+        sortOrder: number;
+        createdAt: string;
+    }[];
+}, readonly ["voyant", "finance", "invoices", "detail", string, "line-items"]>, "queryFn"> & {
+    queryFn?: import("@tanstack/react-query").QueryFunction<{
+        data: {
+            id: string;
+            invoiceId: string;
+            description: string;
+            quantity: number;
+            unitPriceCents: number;
+            totalCents: number;
+            taxRate: number | null;
+            sortOrder: number;
+            createdAt: string;
+        }[];
+    }, readonly ["voyant", "finance", "invoices", "detail", string, "line-items"], never> | undefined;
+} & {
+    queryKey: readonly ["voyant", "finance", "invoices", "detail", string, "line-items"] & {
+        [dataTagSymbol]: {
+            data: {
+                id: string;
+                invoiceId: string;
+                description: string;
+                quantity: number;
+                unitPriceCents: number;
+                totalCents: number;
+                taxRate: number | null;
+                sortOrder: number;
+                createdAt: string;
+            }[];
+        };
+        [dataTagErrorSymbol]: Error;
+    };
+};
+export declare function getInvoicePaymentsQueryOptions(client: FetchWithValidationOptions, invoiceId: string | null | undefined, options?: UseInvoicePaymentsOptions): import("@tanstack/react-query").OmitKeyof<import("@tanstack/react-query").UseQueryOptions<{
+    data: {
+        id: string;
+        invoiceId: string;
+        amountCents: number;
+        currency: string;
+        paymentMethod: string;
+        status: "pending" | "completed" | "failed" | "refunded";
+        referenceNumber: string | null;
+        paymentDate: string;
+        notes: string | null;
+        createdAt: string;
+    }[];
+}, Error, {
+    data: {
+        id: string;
+        invoiceId: string;
+        amountCents: number;
+        currency: string;
+        paymentMethod: string;
+        status: "pending" | "completed" | "failed" | "refunded";
+        referenceNumber: string | null;
+        paymentDate: string;
+        notes: string | null;
+        createdAt: string;
+    }[];
+}, readonly ["voyant", "finance", "invoices", "detail", string, "payments"]>, "queryFn"> & {
+    queryFn?: import("@tanstack/react-query").QueryFunction<{
+        data: {
+            id: string;
+            invoiceId: string;
+            amountCents: number;
+            currency: string;
+            paymentMethod: string;
+            status: "pending" | "completed" | "failed" | "refunded";
+            referenceNumber: string | null;
+            paymentDate: string;
+            notes: string | null;
+            createdAt: string;
+        }[];
+    }, readonly ["voyant", "finance", "invoices", "detail", string, "payments"], never> | undefined;
+} & {
+    queryKey: readonly ["voyant", "finance", "invoices", "detail", string, "payments"] & {
+        [dataTagSymbol]: {
+            data: {
+                id: string;
+                invoiceId: string;
+                amountCents: number;
+                currency: string;
+                paymentMethod: string;
+                status: "pending" | "completed" | "failed" | "refunded";
+                referenceNumber: string | null;
+                paymentDate: string;
+                notes: string | null;
+                createdAt: string;
+            }[];
+        };
+        [dataTagErrorSymbol]: Error;
+    };
+};
+export declare function getInvoiceCreditNotesQueryOptions(client: FetchWithValidationOptions, invoiceId: string | null | undefined, options?: UseInvoiceCreditNotesOptions): import("@tanstack/react-query").OmitKeyof<import("@tanstack/react-query").UseQueryOptions<{
+    data: {
+        id: string;
+        creditNoteNumber: string;
+        invoiceId: string;
+        status: "draft" | "issued" | "applied";
+        amountCents: number;
+        currency: string;
+        reason: string;
+        notes: string | null;
+        createdAt: string;
+    }[];
+}, Error, {
+    data: {
+        id: string;
+        creditNoteNumber: string;
+        invoiceId: string;
+        status: "draft" | "issued" | "applied";
+        amountCents: number;
+        currency: string;
+        reason: string;
+        notes: string | null;
+        createdAt: string;
+    }[];
+}, readonly ["voyant", "finance", "invoices", "detail", string, "credit-notes"]>, "queryFn"> & {
+    queryFn?: import("@tanstack/react-query").QueryFunction<{
+        data: {
+            id: string;
+            creditNoteNumber: string;
+            invoiceId: string;
+            status: "draft" | "issued" | "applied";
+            amountCents: number;
+            currency: string;
+            reason: string;
+            notes: string | null;
+            createdAt: string;
+        }[];
+    }, readonly ["voyant", "finance", "invoices", "detail", string, "credit-notes"], never> | undefined;
+} & {
+    queryKey: readonly ["voyant", "finance", "invoices", "detail", string, "credit-notes"] & {
+        [dataTagSymbol]: {
+            data: {
+                id: string;
+                creditNoteNumber: string;
+                invoiceId: string;
+                status: "draft" | "issued" | "applied";
+                amountCents: number;
+                currency: string;
+                reason: string;
+                notes: string | null;
+                createdAt: string;
+            }[];
+        };
+        [dataTagErrorSymbol]: Error;
+    };
+};
+export declare function getInvoiceNotesQueryOptions(client: FetchWithValidationOptions, invoiceId: string | null | undefined, options?: UseInvoiceNotesOptions): import("@tanstack/react-query").OmitKeyof<import("@tanstack/react-query").UseQueryOptions<{
+    data: {
+        id: string;
+        invoiceId: string;
+        authorId: string;
+        content: string;
+        createdAt: string;
+    }[];
+}, Error, {
+    data: {
+        id: string;
+        invoiceId: string;
+        authorId: string;
+        content: string;
+        createdAt: string;
+    }[];
+}, readonly ["voyant", "finance", "invoices", "detail", string, "notes"]>, "queryFn"> & {
+    queryFn?: import("@tanstack/react-query").QueryFunction<{
+        data: {
+            id: string;
+            invoiceId: string;
+            authorId: string;
+            content: string;
+            createdAt: string;
+        }[];
+    }, readonly ["voyant", "finance", "invoices", "detail", string, "notes"], never> | undefined;
+} & {
+    queryKey: readonly ["voyant", "finance", "invoices", "detail", string, "notes"] & {
+        [dataTagSymbol]: {
+            data: {
+                id: string;
+                invoiceId: string;
+                authorId: string;
+                content: string;
+                createdAt: string;
+            }[];
+        };
+        [dataTagErrorSymbol]: Error;
+    };
+};
+//# sourceMappingURL=query-options.d.ts.map

package/dist/query-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-options.d.ts","sourceRoot":"","sources":["../src/query-options.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,0BAA0B,EAAuB,MAAM,aAAa,CAAA;AAClF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAA;AACvF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAA;AACnF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAA;AAC1E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAA;AAChF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAA;AAYlF,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,0BAA0B,EAClC,OAAO,GAAE,kBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoBjC;AAED,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,0BAA0B,EAClC,OAAO,GAAE,0BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmBzC;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,0BAA0B,EAClC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC7B,OAAO,GAAE,iBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWhC;AAED,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,0BAA0B,EAClC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,OAAO,GAAE,0BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAezC;AAED,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,0BAA0B,EAClC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,OAAO,GAAE,yBAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAexC;AAED,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,0BAA0B,EAClC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,OAAO,GAAE,4BAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAe3C;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,0BAA0B,EAClC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,OAAO,GAAE,sBAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAerC"}

package/dist/query-options.js

@@ -0,0 +1,92 @@
+"use client";
+import { queryOptions } from "@tanstack/react-query";
+import { fetchWithValidation } from "./client.js";
+import { financeQueryKeys } from "./query-keys.js";
+import { invoiceCreditNotesResponse, invoiceLineItemsResponse, invoiceListResponse, invoiceNotesResponse, invoicePaymentsResponse, invoiceSingleResponse, supplierPaymentListResponse, } from "./schemas.js";
+export function getInvoicesQueryOptions(client, options = {}) {
+    const { enabled: _enabled = true, ...filters } = options;
+    return queryOptions({
+        queryKey: financeQueryKeys.invoicesList(filters),
+        queryFn: () => {
+            const params = new URLSearchParams();
+            if (filters.search)
+                params.set("search", filters.search);
+            if (filters.limit !== undefined)
+                params.set("limit", String(filters.limit));
+            if (filters.offset !== undefined)
+                params.set("offset", String(filters.offset));
+            const qs = params.toString();
+            return fetchWithValidation(`/v1/finance/invoices${qs ? `?${qs}` : ""}`, invoiceListResponse, client);
+        },
+    });
+}
+export function getSupplierPaymentsQueryOptions(client, options = {}) {
+    const { enabled: _enabled = true, ...filters } = options;
+    return queryOptions({
+        queryKey: financeQueryKeys.supplierPaymentsList(filters),
+        queryFn: () => {
+            const params = new URLSearchParams();
+            if (filters.limit !== undefined)
+                params.set("limit", String(filters.limit));
+            if (filters.offset !== undefined)
+                params.set("offset", String(filters.offset));
+            const qs = params.toString();
+            return fetchWithValidation(`/v1/finance/supplier-payments${qs ? `?${qs}` : ""}`, supplierPaymentListResponse, client);
+        },
+    });
+}
+export function getInvoiceQueryOptions(client, id, options = {}) {
+    const { enabled: _enabled = true } = options;
+    return queryOptions({
+        queryKey: financeQueryKeys.invoice(id ?? ""),
+        queryFn: async () => {
+            if (!id)
+                throw new Error("getInvoiceQueryOptions requires an id");
+            return fetchWithValidation(`/v1/finance/invoices/${id}`, invoiceSingleResponse, client);
+        },
+    });
+}
+export function getInvoiceLineItemsQueryOptions(client, invoiceId, options = {}) {
+    const { enabled: _enabled = true } = options;
+    return queryOptions({
+        queryKey: financeQueryKeys.lineItems(invoiceId ?? ""),
+        queryFn: async () => {
+            if (!invoiceId)
+                throw new Error("getInvoiceLineItemsQueryOptions requires an invoiceId");
+            return fetchWithValidation(`/v1/finance/invoices/${invoiceId}/line-items`, invoiceLineItemsResponse, client);
+        },
+    });
+}
+export function getInvoicePaymentsQueryOptions(client, invoiceId, options = {}) {
+    const { enabled: _enabled = true } = options;
+    return queryOptions({
+        queryKey: financeQueryKeys.payments(invoiceId ?? ""),
+        queryFn: async () => {
+            if (!invoiceId)
+                throw new Error("getInvoicePaymentsQueryOptions requires an invoiceId");
+            return fetchWithValidation(`/v1/finance/invoices/${invoiceId}/payments`, invoicePaymentsResponse, client);
+        },
+    });
+}
+export function getInvoiceCreditNotesQueryOptions(client, invoiceId, options = {}) {
+    const { enabled: _enabled = true } = options;
+    return queryOptions({
+        queryKey: financeQueryKeys.creditNotes(invoiceId ?? ""),
+        queryFn: async () => {
+            if (!invoiceId)
+                throw new Error("getInvoiceCreditNotesQueryOptions requires an invoiceId");
+            return fetchWithValidation(`/v1/finance/invoices/${invoiceId}/credit-notes`, invoiceCreditNotesResponse, client);
+        },
+    });
+}
+export function getInvoiceNotesQueryOptions(client, invoiceId, options = {}) {
+    const { enabled: _enabled = true } = options;
+    return queryOptions({
+        queryKey: financeQueryKeys.notes(invoiceId ?? ""),
+        queryFn: async () => {
+            if (!invoiceId)
+                throw new Error("getInvoiceNotesQueryOptions requires an invoiceId");
+            return fetchWithValidation(`/v1/finance/invoices/${invoiceId}/notes`, invoiceNotesResponse, client);
+        },
+    });
+}