Files
bigcapital/packages/webapp/src/hooks/query/paymentReceives.tsx
2025-10-29 12:54:12 +02:00

391 lines
9.8 KiB
TypeScript

// @ts-nocheck
import {
useMutation,
useQueryClient,
UseQueryOptions,
UseQueryResult,
useQuery,
UseMutationOptions,
UseMutationResult,
} from 'react-query';
import useApiRequest from '../useRequest';
import { useRequestQuery } from '../useQueryRequest';
import { transformPagination, saveInvoke, transformToCamelCase } from '@/utils';
import { useRequestPdf } from '../useRequestPdf';
import t from './types';
// Common invalidate queries.
const commonInvalidateQueries = (client) => {
// Invalidate payment receives.
client.invalidateQueries(t.PAYMENT_RECEIVES);
client.invalidateQueries(t.PAYMENT_RECEIVE_EDIT_PAGE);
// Invalidate invoices.
client.invalidateQueries(t.SALE_INVOICES);
client.invalidateQueries(t.SALE_INVOICE);
// Invalidate accounts.
client.invalidateQueries(t.ACCOUNTS);
client.invalidateQueries(t.ACCOUNT);
// Invalidate financial reports.
client.invalidateQueries(t.FINANCIAL_REPORT);
// Invalidate transactions by reference.
client.invalidateQueries(t.TRANSACTIONS_BY_REFERENCE);
// Invalidate customers.
client.invalidateQueries(t.CUSTOMERS);
client.invalidateQueries(t.CUSTOMER);
// Invalidate the cashflow transactions.
client.invalidateQueries(t.CASH_FLOW_TRANSACTIONS);
client.invalidateQueries(t.CASHFLOW_ACCOUNT_TRANSACTIONS_INFINITY);
client.invalidateQueries(t.CREDIT_NOTE);
client.invalidateQueries(t.CREDIT_NOTES);
// Invalidate reconcile.
client.invalidateQueries(t.RECONCILE_CREDIT_NOTE);
client.invalidateQueries(t.RECONCILE_CREDIT_NOTES);
// Invalidate invoices payment transactions.
client.invalidateQueries(t.SALE_INVOICE_PAYMENT_TRANSACTIONS);
};
// Transform payment receives.
const transformPaymentReceives = (res) => ({
paymentReceives: res.data.payment_receives,
pagination: transformPagination(res.data.pagination),
filterMeta: res.data.filter_meta,
});
/**
* Retrieve accounts list.
*/
export function usePaymentReceives(query, props) {
return useRequestQuery(
[t.PAYMENT_RECEIVES, query],
{ method: 'get', url: 'payments-received', params: query },
{
select: transformPaymentReceives,
defaultData: {
paymentReceives: [],
pagination: { page: 1, pageSize: 20, total: 0 },
filterMeta: {},
},
...props,
},
);
}
/**
* Creates payment receive.
*/
export function useCreatePaymentReceive(props) {
const client = useQueryClient();
const apiRequest = useApiRequest();
return useMutation(
(values) => apiRequest.post('payments-received', values),
{
onSuccess: (data, values) => {
// Invalidate specific payment receive.
commonInvalidateQueries(client);
// Invalidate payment receive settings.
client.invalidateQueries([t.SETTING, t.SETTING_PAYMENT_RECEIVES]);
saveInvoke(props?.onSuccess, data);
},
...props,
},
);
}
/**
* Edits payment receive.
*/
export function useEditPaymentReceive(props) {
const client = useQueryClient();
const apiRequest = useApiRequest();
return useMutation(
([id, values]) => apiRequest.put(`payments-received/${id}`, values),
{
onSuccess: (data, [id, values]) => {
// Invalidate specific payment receive.
client.invalidateQueries([t.PAYMENT_RECEIVE, id]);
// Common invalidate queries.
commonInvalidateQueries(client);
saveInvoke(props?.onSuccess, data);
},
...props,
},
);
}
/**
* Deletes payment receive.
*/
export function useDeletePaymentReceive(props) {
const client = useQueryClient();
const apiRequest = useApiRequest();
return useMutation(
(id) => apiRequest.delete(`payments-received/${id}`),
{
onSuccess: (data, id) => {
// Invalidate specific payment receive.
client.invalidateQueries([t.PAYMENT_RECEIVE, id]);
commonInvalidateQueries(client);
saveInvoke(props?.onSuccess, data);
},
...props,
},
);
}
/**
* Retrieve specific payment receive.
* @param {number} id - Payment receive.
*/
export function usePaymentReceive(id, props) {
return useRequestQuery(
[t.PAYMENT_RECEIVE, id],
{ method: 'get', url: `payments-received/${id}` },
{
select: (res) => res.data,
defaultData: {},
...props,
},
);
}
/**
* Retrieve information of payment receive in edit page.
* @param {number} id - Payment receive id.
*/
export function usePaymentReceiveEditPage(id, props) {
const apiRequest = useApiRequest();
return useQuery(
[t.PAYMENT_RECEIVE_EDIT_PAGE, id],
() => apiRequest.get(`payments-received/${id}/edit-page`).then(res => res.data),
);
}
export function useRefreshPaymentReceive() {
const queryClient = useQueryClient();
return {
refresh: () => {
queryClient.invalidateQueries(t.PAYMENT_RECEIVES);
},
};
}
export function useCreateNotifyPaymentReceiveBySMS(props) {
const queryClient = useQueryClient();
const apiRequest = useApiRequest();
return useMutation(
([id, values]) =>
apiRequest.post(`payments-received/${id}/notify-by-sms`, values),
{
onSuccess: (res, [id, values]) => {
// Invalidate
queryClient.invalidateQueries([t.NOTIFY_PAYMENT_RECEIVE_BY_SMS, id]);
// Common invalidate queries.
commonInvalidateQueries(queryClient);
},
...props,
},
);
}
export function usePaymentReceiveSMSDetail(
paymentReceiveId,
props,
requestProps,
) {
return useRequestQuery(
[t.PAYMENT_RECEIVE_SMS_DETAIL, paymentReceiveId],
{
method: 'get',
url: `payments-received/${paymentReceiveId}/sms-details`,
...requestProps,
},
{
select: (res) => res.data,
defaultData: {},
...props,
},
);
}
/**
* Retrieve the payment receive pdf document data.
* @param {number} paymentReceiveId - Payment receive id.
*/
export function usePdfPaymentReceive(paymentReceiveId) {
return useRequestPdf({ url: `payments-received/${paymentReceiveId}` });
}
interface SendPaymentReceiveMailValues {
to: string[] | string;
cc?: string[] | string,
bcc?: string[] | string,
subject: string;
message: string;
from?: string[] | string;
attachPdf?: boolean;
}
interface SendPaymentReceiveMailResponse {
success: boolean;
message?: string;
}
type SendPaymentReceiveMailMutation = UseMutationResult<
SendPaymentReceiveMailResponse,
Error,
[number, SendPaymentReceiveMailValues],
unknown
>;
export function useSendPaymentReceiveMail(
props?: Partial<
UseMutationOptions<
SendPaymentReceiveMailResponse,
Error,
[number, SendPaymentReceiveMailValues]
>
>,
): SendPaymentReceiveMailMutation {
const queryClient = useQueryClient();
const apiRequest = useApiRequest();
return useMutation<
SendPaymentReceiveMailResponse,
Error,
[number, SendPaymentReceiveMailValues]
>(
([id, values]) =>
apiRequest.post(`payments-received/${id}/mail`, values),
{
onSuccess: (res, [id, values]) => {
// Common invalidate queries.
commonInvalidateQueries(queryClient);
},
...props,
},
);
}
export interface GetPaymentReceivedMailStateResponse {
companyName: string;
companyLogoUri?: string;
primaryColor?: string;
customerName: string;
entries: Array<{ invoiceNumber: string; paidAmount: string }>;
from: Array<string>;
fromOptions: Array<{ mail: string; label: string; primary: boolean }>;
paymentDate: string;
paymentDateFormatted: string;
to: Array<string>;
toOptions: Array<{ mail: string; label: string; primary: boolean }>;
total: number;
totalFormatted: string;
subtotal: number;
subtotalFormatted: string;
paymentNumber: string;
formatArgs: Record<string, any>;
}
export function usePaymentReceivedMailState(
paymentReceiveId: number,
props?: UseQueryOptions<GetPaymentReceivedMailStateResponse, Error>,
): UseQueryResult<GetPaymentReceivedMailStateResponse, Error> {
const apiRequest = useApiRequest();
return useQuery<GetPaymentReceivedMailStateResponse, Error>(
[t.PAYMENT_RECEIVE_MAIL_OPTIONS, paymentReceiveId],
() =>
apiRequest
.get(`payments-received/${paymentReceiveId}/mail`)
.then((res) => transformToCamelCase(res.data)),
);
}
export interface PaymentReceivedStateResponse {
defaultTemplateId: number;
}
/**
* Retrieves the payment receive state.
* @param {Record<string, any>} query - Query parameters for the request.
* @param {UseQueryOptions<PaymentReceivedStateResponse, Error>} options - Optional query options.
* @returns {UseQueryResult<PaymentReceivedStateResponse, Error>} The query result.
*/
export function usePaymentReceivedState(
options?: UseQueryOptions<PaymentReceivedStateResponse, Error>,
): UseQueryResult<PaymentReceivedStateResponse, Error> {
const apiRequest = useApiRequest();
return useQuery<PaymentReceivedStateResponse, Error>(
['PAYMENT_RECEIVED_STATE'],
() =>
apiRequest
.get('/payments-received/state')
.then((res) => transformToCamelCase(res.data)),
{
...options,
},
);
}
interface PaymentReceivedHtmlResponse {
htmlContent: string;
}
/**
* Retrieves the html content of the given payment receive.
* @param {number} paymentReceivedId
* @param {UseQueryOptions<PaymentReceivedHtmlResponse, Error>} options
* @returns {UseQueryResult<PaymentReceivedHtmlResponse, Error>}
*/
export function useGetPaymentReceiveHtml(
paymentReceivedId: number,
options?: UseQueryOptions<PaymentReceivedHtmlResponse, Error>,
): UseQueryResult<PaymentReceivedHtmlResponse, Error> {
const apiRequest = useApiRequest();
return useQuery<PaymentReceivedHtmlResponse, Error>(
['PAYMENT_RECEIVED_HTML', paymentReceivedId],
() =>
apiRequest
.get(`/payments-received/${paymentReceivedId}`, {
headers: {
Accept: 'application/json+html',
},
})
.then((res) => transformToCamelCase(res.data)),
{
...options,
},
);
}