[FEQ] Ameerul / FEQ-1002 / P2P Order Create Hook (binary-com#12246)

* feat: added p2p_order_create hook

* chore: changed comments

* fix: annotations

* chore: added tsdoc for response

packages/api/src/hooks/p2p/useOrderCreate.ts

@@ -0,0 +1,74 @@
+import { useCallback, useMemo } from 'react';
+import useMutation from '../../useMutation';
+import useInvalidateQuery from '../../useInvalidateQuery';
+
+type TOrderCreatePayload = Parameters<ReturnType<typeof useMutation<'p2p_order_create'>>['mutate']>[0]['payload'];
+
+/** A custom hook that creates a P2P order. 
+ * 
+ * To create an order, specify the following payload arguments in the `mutate` call (some arguments are optional):
+ * @example
+ *  mutate({
+        advert_id: '12345',
+        amount: '100',
+        contact_info: '012345678',
+        payment_info: 'Some payment info',
+    });
+ * 
+*/
+const useOrderCreate = () => {
+    const invalidate = useInvalidateQuery();
+    const {
+        data,
+        mutate: _mutate,
+        ...rest
+    } = useMutation('p2p_order_create', {
+        onSuccess: () => {
+            invalidate('p2p_order_list');
+        },
+    });
+
+    const mutate = useCallback((payload: TOrderCreatePayload) => _mutate({ payload }), [_mutate]);
+
+    const modified_data = useMemo(() => {
+        if (!data?.p2p_order_create) return undefined;
+
+        const { advert_details, advertiser_details, client_details, is_incoming, is_reviewable, is_seen } =
+            data.p2p_order_create;
+
+        return {
+            ...data.p2p_order_create,
+            advert_details: {
+                ...advert_details,
+                /** Indicates if this is block trade advert or not. */
+                is_block_trade: Boolean(advert_details.block_trade),
+            },
+            advertiser_details: {
+                ...advertiser_details,
+                /** Indicates if the advertiser is currently online. */
+                is_online: Boolean(advertiser_details.is_online),
+            },
+            client_details: {
+                ...client_details,
+                /** Indicates if the advertiser is currently online. */
+                is_online: Boolean(client_details.is_online),
+            },
+            /** Indicates if the order is created for the advert of the current client. */
+            is_incoming: Boolean(is_incoming),
+            /** Indicates if a review can be given. */
+            is_reviewable: Boolean(is_reviewable),
+            /** Indicates if the latest order changes have been seen by the current client. */
+            is_seen: Boolean(is_seen),
+        };
+    }, [data?.p2p_order_create]);
+
+    return {
+        /** The 'p2p_order_create' response. */
+        data: modified_data,
+        /** Sends a request to create a P2P order. */
+        mutate,
+        ...rest,
+    };
+};
+
+export default useOrderCreate;