feat: sharable payment link dialog

packages/webapp/src/hooks/query/payment-link.ts

@@ -0,0 +1,94 @@
+// @ts-nocheck
+import {
+  UseMutationOptions,
+  UseMutationResult,
+  UseQueryOptions,
+  UseQueryResult,
+  useMutation,
+  useQuery,
+} from 'react-query';
+import useApiRequest from '../useRequest';
+import { transformToCamelCase, transfromToSnakeCase } from '@/utils';
+
+interface CreatePaymentLinkValues {
+  publicity: string;
+  transactionType: string;
+  transactionId: number | string;
+  expiryDate: string;
+}
+
+interface CreatePaymentLinkResponse {
+  link: string;
+}
+
+/**
+ * Creates a new payment link.
+ * @param {UseMutationOptions<CreatePaymentLinkResponse, Error, CreatePaymentLinkValues>} options
+ * @returns {UseMutationResult<CreatePaymentLinkResponse, Error, CreatePaymentLinkValues>}
+ */
+export function useCreatePaymentLink(
+  options?: UseMutationOptions<
+    CreatePaymentLinkResponse,
+    Error,
+    CreatePaymentLinkValues
+  >,
+): UseMutationResult<
+  CreatePaymentLinkResponse,
+  Error,
+  CreatePaymentLinkValues
+> {
+  const apiRequest = useApiRequest();
+
+  return useMutation<CreatePaymentLinkResponse, Error, CreatePaymentLinkValues>(
+    (values) =>
+      apiRequest
+        .post('/payment-links/generate', transfromToSnakeCase(values))
+        .then((res) => res.data),
+    {
+      ...options,
+    },
+  );
+}
+
+export interface GetSharableLinkMetaResponse {
+  dueAmount: number;
+  dueAmountFormatted: string;
+  dueDate: string;
+  dueDateFormatted: string;
+  invoiceDateFormatted: string;
+  invoiceNo: string;
+  paymentAmount: number;
+  paymentAmountFormatted: string;
+  subtotal: number;
+  subtotalFormatted: string;
+  subtotalLocalFormatted: string;
+  total: number;
+  totalFormatted: string;
+  totalLocalFormatted: string;
+  customerName: string;
+  companyName: string;
+}
+
+/**
+ * Fetches the sharable link metadata for a given link ID.
+ * @param {string} linkId - The ID of the link to fetch metadata for.
+ * @param {UseQueryOptions<GetSharableLinkMetaResponse, Error>} options - Optional query options.
+ * @returns {UseQueryResult<GetSharableLinkMetaResponse, Error>} The query result.
+ */
+export function useGetSharableLinkMeta(
+  linkId: string,
+  options?: UseQueryOptions<GetSharableLinkMetaResponse, Error>,
+): UseQueryResult<GetSharableLinkMetaResponse, Error> {
+  const apiRequest = useApiRequest();
+
+  return useQuery<GetSharableLinkMetaResponse, Error>(
+    ['sharable-link-meta', linkId],
+    () =>
+      apiRequest
+        .get(`/sharable-links/meta/invoice/${linkId}`)
+        .then((res) => transformToCamelCase(res.data?.data)),
+    {
+      ...options,
+    },
+  );
+}