III-6365 - Add ownerships managements page

src/constants/Regex.ts

@@ -3,4 +3,7 @@ const URL_REGEX: RegExp =
   /^https?:\/\/(?:www\.)?[-a-zA-Z0-9@:%._\+~#=]{1,256}\.[a-zA-Z0-9()]{1,6}\b(?:[-a-zA-Z0-9()@:%_\+.~#?!&\/=]*)$/;
 const PHONE_REGEX: RegExp = /^[0-9\/\-_.+ ]{0,15}$/;
 
-export { EMAIL_REGEX, PHONE_REGEX, URL_REGEX };
+const UUID_V4_REGEX =
+  /^[A-F\d]{8}-[A-F\d]{4}-4[A-F\d]{3}-[89AB][A-F\d]{3}-[A-F\d]{12}$/i;
+
+export { EMAIL_REGEX, PHONE_REGEX, URL_REGEX, UUID_V4_REGEX };

src/hooks/api/authenticated-query.ts

@@ -56,10 +56,16 @@ const QueryStatus = {
 
 const prepareKey = ({ queryKey, queryArguments }) => {
   const key = Array.isArray(queryKey) ? queryKey : [queryKey];
-  return [
-    ...flatten(key),
-    Object.keys(queryArguments ?? {}).length > 0 ? queryArguments : undefined,
-  ].filter((key) => key !== undefined);
+  const args = Object.entries(queryArguments ?? {}).filter(
+    ([_, value]) => typeof value !== 'undefined',
+  );
+  const preparedKey = flatten(key);
+
+  if (args.length > 0) {
+    preparedKey.push(Object.fromEntries(args));
+  }
+
+  return preparedKey;
 };
 
 const prepareArguments = ({

src/hooks/api/organizers.ts

@@ -22,11 +22,7 @@ type HeadersAndQueryData = {
   headers: Headers;
 } & { [x: string]: string };
 
-type GetOrganizersArgumentsByQuery = {
-  headers: Headers;
-  embed: string;
-  q: string;
-};
+export type GetOrganizersByQueryResponse = { member: Organizer[] };
 
 const useGetOrganizersByQueryQuery = (
   {
@@ -37,7 +33,7 @@ const useGetOrganizersByQueryQuery = (
   }: AuthenticatedQueryOptions<{ name?: string } & PaginationOptions> = {},
   configuration: UseQueryOptions = {},
 ) =>
-  useAuthenticatedQuery<{ member: Organizer[] }>({
+  useAuthenticatedQuery<GetOrganizersByQueryResponse>({
     req,
     queryClient,
     queryKey: ['organizers'],
@@ -48,8 +44,8 @@ const useGetOrganizersByQueryQuery = (
       start: paginationOptions.start,
       limit: paginationOptions.limit,
     },
-    enabled: !!name,
     ...configuration,
+    enabled: !!name && configuration.enabled === true,
   });
 
 type GetOrganizersArguments = {
@@ -115,6 +111,8 @@ type GetOrganizerByIdArguments = {
   id: string;
 };
 
+export type GetOrganizerByIdResponse = Organizer | undefined;
+
 const getOrganizerById = async ({ headers, id }: GetOrganizerByIdArguments) => {
   const res = await fetchFromApi({
     path: `/organizers/${id.toString()}`,
@@ -130,11 +128,12 @@ const getOrganizerById = async ({ headers, id }: GetOrganizerByIdArguments) => {
 };
 
 const useGetOrganizerByIdQuery = (
-  { id, ...options },
+  { id, req, queryClient }: { id: string } & ServerSideQueryOptions,
   configuration: UseQueryOptions = {},
 ) =>
-  useAuthenticatedQuery({
-    ...options,
+  useAuthenticatedQuery<GetOrganizerByIdResponse>({
+    req,
+    queryClient,
     queryKey: ['organizers'],
     queryFn: getOrganizerById,
     queryArguments: { id },

src/hooks/api/ownerships.ts

@@ -1,9 +1,10 @@
-import { UseQueryOptions } from 'react-query';
+import { UseMutationResult, UseQueryOptions } from 'react-query';
 
 import { Values } from '@/types/Values';
 import { fetchFromApi, isErrorObject } from '@/utils/fetchFromApi';
 
 import {
+  PaginationOptions,
   ServerSideQueryOptions,
   useAuthenticatedMutation,
   useAuthenticatedQuery,
@@ -15,22 +16,35 @@ export type OwnershipRequest = {
   ownerId: string;
   ownerEmail: string;
   requesterId: string;
-  state: RequestState;
+  state: OwnershipState;
 };
 
 export type OwnershipCreator = {
   userId: string;
   email: string;
 };
 
-export const RequestState = {
-  APPROVED: 'approved',
+export const OwnershipState = {
   REQUESTED: 'requested',
+  APPROVED: 'approved',
+  REJECTED: 'rejected',
+  DELETED: 'deleted',
 } as const;
 
-type RequestState = Values<typeof RequestState>;
+export type OwnershipState = Values<typeof OwnershipState>;
+
+type RequestOwnershipArguments = {
+  itemId: string;
+  ownerEmail?: string;
+  ownerId?: string;
+};
 
-const requestOwnership = async ({ headers, itemId, ownerEmail, ownerId }) =>
+const requestOwnership = async ({
+  headers,
+  itemId,
+  ownerEmail,
+  ownerId,
+}: { headers: Headers } & RequestOwnershipArguments) =>
   fetchFromApi({
     path: `/ownerships`,
     options: {
@@ -50,15 +64,37 @@ const useRequestOwnershipMutation = (configuration: UseQueryOptions = {}) =>
     mutationFn: requestOwnership,
     mutationKey: 'ownerships-request-ownership',
     ...configuration,
-  });
-
-const getOwnershipRequests = async ({ headers, organizerId, ownerId }) => {
+  }) as UseMutationResult<void, Error, RequestOwnershipArguments>;
+
+const getOwnershipRequests = async ({
+  headers,
+  itemId,
+  ownerId,
+  state,
+  paginationOptions,
+}: {
+  headers: Headers;
+  itemId?: string;
+  ownerId?: string;
+  state?: OwnershipState;
+} & PaginationOptions) => {
+  const searchParams = new URLSearchParams();
+  if (paginationOptions) {
+    searchParams.set('limit', `${paginationOptions.limit}`);
+    searchParams.set('offset', `${paginationOptions.start}`);
+  }
+  if (itemId) {
+    searchParams.set('itemId', itemId);
+  }
+  if (ownerId) {
+    searchParams.set('ownerId', ownerId);
+  }
+  if (state) {
+    searchParams.set('state', state);
+  }
   const res = await fetchFromApi({
     path: '/ownerships/',
-    searchParams: {
-      itemId: organizerId,
-      ...(ownerId && { ownerId }),
-    },
+    searchParams,
     options: {
       headers,
     },
@@ -71,25 +107,47 @@ const getOwnershipRequests = async ({ headers, organizerId, ownerId }) => {
 };
 
 type UseGetOwnershipRequestsArguments = ServerSideQueryOptions & {
-  organizerId: string;
+  itemId?: string;
   ownerId?: string;
+  state?: OwnershipState;
+} & PaginationOptions;
+
+export type GetOwnershipRequestsResponse = {
+  '@context': string;
+  '@type': string;
+  itemsPerPage: number;
+  totalItems: number;
+  member: OwnershipRequest[];
 };
-
 const useGetOwnershipRequestsQuery = (
-  { req, queryClient, organizerId, ownerId }: UseGetOwnershipRequestsArguments,
+  {
+    req,
+    queryClient,
+    itemId,
+    ownerId,
+    state,
+    paginationOptions,
+  }: UseGetOwnershipRequestsArguments,
   configuration: UseQueryOptions = {},
 ) =>
-  useAuthenticatedQuery<OwnershipRequest[]>({
+  useAuthenticatedQuery<GetOwnershipRequestsResponse>({
     req,
     queryClient,
     queryKey: ['ownership-requests'],
     queryFn: getOwnershipRequests,
-    queryArguments: { organizerId, ...(ownerId && { ownerId }) },
+    queryArguments: { itemId, ownerId, state, paginationOptions },
     refetchOnWindowFocus: false,
     ...configuration,
   });
 
-const approveOwnershipRequest = async ({ headers, ownershipId }) =>
+type ApproveOwnershipArguments = { ownershipId: string };
+
+const approveOwnershipRequest = async ({
+  headers,
+  ownershipId,
+}: {
+  headers: Headers;
+} & ApproveOwnershipArguments) =>
   fetchFromApi({
     path: `/ownerships/${ownershipId}/approve`,
     options: {
@@ -103,9 +161,16 @@ const useApproveOwnershipRequestMutation = (configuration = {}) =>
     mutationFn: approveOwnershipRequest,
     mutationKey: 'approve-ownership-request',
     ...configuration,
-  });
+  }) as UseMutationResult<void, Error, ApproveOwnershipArguments>;
+
+type RejectOwnershipArguments = { ownershipId: string };
 
-const rejectOwnershipRequest = async ({ headers, ownershipId }) =>
+const rejectOwnershipRequest = async ({
+  headers,
+  ownershipId,
+}: {
+  headers: Headers;
+} & RejectOwnershipArguments) =>
   fetchFromApi({
     path: `/ownerships/${ownershipId}/reject`,
     options: {
@@ -119,9 +184,14 @@ const useRejectOwnershipRequestMutation = (configuration = {}) =>
     mutationFn: rejectOwnershipRequest,
     mutationKey: 'reject-ownership-request',
     ...configuration,
-  });
+  }) as UseMutationResult<void, Error, RejectOwnershipArguments>;
+
+type DeleteOwnershipArguments = { ownershipId: string };
 
-const deleteOwnershipRequest = async ({ headers, ownershipId }) =>
+const deleteOwnershipRequest = async ({
+  headers,
+  ownershipId,
+}: { headers: Headers } & DeleteOwnershipArguments) =>
   fetchFromApi({
     path: `/ownerships/${ownershipId}`,
     options: {
@@ -135,7 +205,7 @@ const useDeleteOwnershipRequestMutation = (configuration = {}) =>
     mutationFn: deleteOwnershipRequest,
     mutationKey: 'delete-ownership-request',
     ...configuration,
-  });
+  }) as UseMutationResult<void, Error, DeleteOwnershipArguments>;
 
 const getOwnershipCreator = async ({ headers, organizerId }) => {
   const res = await fetchFromApi({