@amityco/ts-sdk 7.4.1-b7aa4210.0 → 7.4.1-bf4803ea.0

package/src/communityRepository/observers/getJoinRequests.ts

@@ -0,0 +1,44 @@
+import { dropFromCache } from '~/cache/api/dropFromCache';
+import { getActiveClient } from '~/client/api/activeClient';
+import { ENABLE_CACHE_MESSAGE } from '~/utils/constants';
+import { JoinRequestsLiveCollectionController } from './getJoinRequests/JoinRequestsLiveCollectionController';
+
+/**
+ * Get Join Requests
+ *
+ * @param params the query parameters
+ * @param callback the callback to be called when the join request are updated
+ * @returns joinRequests
+ *
+ * @category joinRequest Live Collection
+ *
+ */
+export const getJoinRequests = (
+  params: Amity.JoinRequestLiveCollection,
+  callback: Amity.LiveCollectionCallback<Amity.JoinRequest>,
+  config?: Amity.LiveCollectionConfig,
+) => {
+  const { log, cache } = getActiveClient();
+
+  if (!cache) {
+    console.log(ENABLE_CACHE_MESSAGE);
+  }
+
+  const timestamp = Date.now();
+  log(`getJoinRequests: (tmpid: ${timestamp}) > listen`);
+
+  const joinRequestLiveCollection = new JoinRequestsLiveCollectionController(params, callback);
+
+  const disposers = joinRequestLiveCollection.startSubscription();
+
+  const cacheKey = joinRequestLiveCollection.getCacheKey();
+
+  disposers.push(() => {
+    dropFromCache(cacheKey);
+  });
+
+  return () => {
+    log(`getJoinRequests (tmpid: ${timestamp}) > dispose`);
+    disposers.forEach(fn => fn());
+  };
+};

package/src/communityRepository/observers/getRecommendedCommunities/RecommendedCommunitiesLiveCollectionController.ts

@@ -15,6 +15,7 @@ import {
   onCommunityUserChanged,
 } from '~/communityRepository/communityMembership';
 import { isNonNullable } from '~/utils';
+import { communityLinkedObject } from '~/utils/linkedObject/communityLinkedObject';
 
 export class RecommendedCommunityLiveCollectionController extends LiveCollectionController<
   'community',
@@ -94,7 +95,7 @@ export class RecommendedCommunityLiveCollectionController extends LiveCollection
       collection.data
         .map(id => pullFromCache<Amity.Community>(['community', 'get', id]))
         .filter(isNonNullable)
-        .map(({ data }) => data) ?? [];
+        .map(({ data }) => communityLinkedObject(data)) ?? [];
 
     if (!this.shouldNotify(data) && origin === 'event') return;
 

package/src/communityRepository/observers/getRecommendedCommunities/RecommendedCommunitiesQueryStreamController.ts

@@ -66,7 +66,7 @@ export class RecommendedCommunitiesQueryStreamController extends QueryStreamCont
   }
 
   reactor(action: EnumCommunityActions | EnumCommunityMemberActions) {
-    return (community: Amity.Community) => {
+    return (community: Amity.InternalCommunity) => {
       const collection = pullFromCache<Amity.RecommendedCommunityLiveCollectionCache>(
         this.cacheKey,
       )?.data;
@@ -79,7 +79,7 @@ export class RecommendedCommunitiesQueryStreamController extends QueryStreamCont
 
   subscribeRTE(
     createSubscriber: {
-      fn: (reactor: (channel: Amity.Community) => void) => Amity.Unsubscriber;
+      fn: (reactor: (channel: Amity.InternalCommunity) => void) => Amity.Unsubscriber;
       action: EnumCommunityActions | EnumCommunityMemberActions;
     }[],
   ) {

package/src/communityRepository/observers/getTrendingCommunities/TrendingCommunitiesLiveCollectionController.ts

@@ -15,6 +15,7 @@ import {
   onCommunityUserChanged,
 } from '~/communityRepository/communityMembership';
 import { isNonNullable } from '~/utils';
+import { communityLinkedObject } from '~/utils/linkedObject/communityLinkedObject';
 
 export class TrendingCommunityLiveCollectionController extends LiveCollectionController<
   'community',
@@ -94,7 +95,7 @@ export class TrendingCommunityLiveCollectionController extends LiveCollectionCon
       collection.data
         .map(id => pullFromCache<Amity.Community>(['community', 'get', id]))
         .filter(isNonNullable)
-        .map(({ data }) => data) ?? [];
+        .map(({ data }) => communityLinkedObject(data)) ?? [];
 
     if (!this.shouldNotify(data) && origin === 'event') return;
 

package/src/communityRepository/observers/getTrendingCommunities/TrendingCommunitiesQueryStreamController.ts

@@ -64,7 +64,7 @@ export class TrendingCommunitiesQueryStreamController extends QueryStreamControl
   }
 
   reactor(action: EnumCommunityActions | EnumCommunityMemberActions) {
-    return (community: Amity.Community) => {
+    return (community: Amity.InternalCommunity) => {
       const collection = pullFromCache<Amity.TrendingCommunityLiveCollectionCache>(
         this.cacheKey,
       )?.data;
@@ -77,7 +77,7 @@ export class TrendingCommunitiesQueryStreamController extends QueryStreamControl
 
   subscribeRTE(
     createSubscriber: {
-      fn: (reactor: (channel: Amity.Community) => void) => Amity.Unsubscriber;
+      fn: (reactor: (channel: Amity.InternalCommunity) => void) => Amity.Unsubscriber;
       action: EnumCommunityActions | EnumCommunityMemberActions;
     }[],
   ) {

package/src/communityRepository/observers/index.ts

@@ -5,3 +5,4 @@ export * from './getTrendingCommunities';
 export * from './getRecommendedCommunities';
 
 export * from './semanticSearchCommunities';
+export * from './getJoinRequestList';

package/src/communityRepository/observers/searchCommunities/SearchCommunitiesPaginationController.ts

@@ -22,6 +22,7 @@ export class CommunitiesPaginationController extends PaginationController<
           isDeleted: inferIsDeleted(params.includeDeleted),
           keyword: params.displayName,
           filter: params.membership,
+          includeDiscoverablePrivateCommunity: params.includeDiscoverablePrivateCommunity ?? true,
           options,
         },
       },

package/src/communityRepository/observers/searchCommunities/SearchCommunitiesQueryStreamController.ts

@@ -60,7 +60,7 @@ export class CommunitiesQueryStreamController extends QueryStreamController<
   }
 
   reactor(action: EnumCommunityActions | EnumCommunityMemberActions) {
-    return (community: Amity.Community) => {
+    return (community: Amity.InternalCommunity) => {
       const collection = pullFromCache<Amity.SearchCommunityLiveCollectionCache>(
         this.cacheKey,
       )?.data;
@@ -73,7 +73,7 @@ export class CommunitiesQueryStreamController extends QueryStreamController<
 
   subscribeRTE(
     createSubscriber: {
-      fn: (reactor: (channel: Amity.Community) => void) => Amity.Unsubscriber;
+      fn: (reactor: (channel: Amity.InternalCommunity) => void) => Amity.Unsubscriber;
       action: EnumCommunityActions | EnumCommunityMemberActions;
     }[],
   ) {

package/src/communityRepository/observers/semanticSearch/SemanticSearchCommunityQueryStreamController.ts

@@ -63,7 +63,7 @@ export class SemanticSearchCommunityQueryStreamController extends QueryStreamCon
   }
 
   reactor(action: EnumCommunityActions | EnumCommunityMemberActions) {
-    return (community: Amity.Community) => {
+    return (community: Amity.InternalCommunity) => {
       const collection = pullFromCache<Amity.CommunityLiveCollectionCache>(this.cacheKey)?.data;
       if (!collection) return;
 
@@ -77,7 +77,7 @@ export class SemanticSearchCommunityQueryStreamController extends QueryStreamCon
 
   subscribeRTE(
     createSubscriber: {
-      fn: (reactor: (community: Amity.Community) => void) => Amity.Unsubscriber;
+      fn: (reactor: (community: Amity.InternalCommunity) => void) => Amity.Unsubscriber;
       action: EnumCommunityActions | EnumCommunityMemberActions;
     }[],
   ) {

package/src/communityRepository/utils/communityWithMembership.ts

@@ -1,5 +1,5 @@
 import { pullFromCache } from '~/cache/api';
-import { getActiveUser } from '~/client';
+import { getActiveUser } from '~/client/api/activeUser';
 
 /*
  * verifies membership status
@@ -12,7 +12,7 @@ function isMember(membership: Amity.Membership<'community'>['communityMembership
  * checks if currently logged in user is part of the community
  */
 function isCurrentUserPartOfCommunity(
-  c: Amity.Community,
+  c: Amity.InternalCommunity,
   m: Amity.Membership<'community'>,
 ): boolean {
   const { userId } = getActiveUser();
@@ -28,11 +28,15 @@ function isCurrentUserPartOfCommunity(
  * Althought this can be calculated, it's not scalable.
  */
 export function updateMembershipStatus(
-  communities: Amity.Community[],
+  communities: Amity.RawCommunity[],
   communityUsers: Amity.Membership<'community'>[],
-): Amity.Community[] {
+): Amity.InternalCommunity[] {
   return communities.map(c => {
-    const cachedCommunity = pullFromCache<Amity.Community>(['community', 'get', c.communityId]);
+    const cachedCommunity = pullFromCache<Amity.InternalCommunity>([
+      'community',
+      'get',
+      c.communityId,
+    ]);
     if (cachedCommunity?.data && cachedCommunity?.data.hasOwnProperty('isJoined')) {
       return {
         ...cachedCommunity.data,

package/src/communityRepository/utils/payload.ts

@@ -1,5 +1,6 @@
 import { CommunityPostSettingMaps, DefaultCommunityPostSetting } from '~/@types';
 import { updateMembershipStatus } from './communityWithMembership';
+import { convertRawUserToInternalUser } from '~/userRepository/utils/convertRawUserToInternalUser';
 
 const getMatchPostSetting = (value: {
   needApprovalOnPostCreation: Amity.RawCommunity['needApprovalOnPostCreation'];
@@ -13,7 +14,7 @@ const getMatchPostSetting = (value: {
   ) ?? DefaultCommunityPostSetting;
 
 export function addPostSetting({ communities }: { communities: Amity.RawCommunity[] }) {
-  return communities.map<Amity.Community>(
+  return communities.map<Amity.InternalCommunity>(
     ({ needApprovalOnPostCreation, onlyAdminCanPost, ...restCommunityPayload }) => ({
       postSetting: getMatchPostSetting({
         needApprovalOnPostCreation,
@@ -29,10 +30,13 @@ export const prepareCommunityPayload = (
 ): Amity.ProcessedCommunityPayload => {
   const communitiesWithPostSetting = addPostSetting({ communities: rawPayload.communities });
 
+  // Convert users to internal format
+  const internalUsers = rawPayload.users.map(convertRawUserToInternalUser);
+
   // map users with community
   const mappedCommunityUsers: Array<Amity.Membership<'community'>> = rawPayload.communityUsers.map(
     communityUser => {
-      const user = rawPayload.users.find(user => user.userId === communityUser.userId)!;
+      const user = internalUsers.find(user => user.userId === communityUser.userId)!;
 
       return {
         ...communityUser,
@@ -48,11 +52,33 @@ export const prepareCommunityPayload = (
 
   return {
     ...rawPayload,
+    users: rawPayload.users.map(convertRawUserToInternalUser),
     communities: communityWithMembershipStatus,
     communityUsers: mappedCommunityUsers,
   };
 };
 
+export const prepareCommunityJoinRequestPayload = (
+  rawPayload: Amity.CommunityJoinRequestPayload,
+): Amity.ProcessedJoinRequestPayload => {
+  const mappedJoinRequests: Array<Amity.InternalJoinRequest> = rawPayload.joinRequests.map(
+    joinRequest => {
+      return {
+        ...joinRequest,
+        joinRequestId: joinRequest._id,
+      };
+    },
+  );
+
+  const users = rawPayload.users.map(convertRawUserToInternalUser);
+
+  return {
+    ...rawPayload,
+    joinRequests: mappedJoinRequests,
+    users,
+  };
+};
+
 export const prepareCommunityMembershipPayload = (
   rawPayload: Amity.CommunityMembershipPayload,
 ): Amity.ProcessedCommunityMembershipPayload => {

package/src/core/liveCollection/PaginationController.ts

@@ -1,5 +1,5 @@
 import { AxiosInstance } from 'axios';
-import { getActiveClient } from '~/client/api';
+import { getActiveClient } from '~/client/api/activeClient';
 
 export abstract class PaginationController<
   TPayloadDomain extends keyof Amity.Payloads,

package/src/core/liveCollection/PaginationNoPageController.ts

@@ -1,5 +1,5 @@
 import { AxiosInstance } from 'axios';
-import { getActiveClient } from '~/client/api';
+import { getActiveClient } from '~/client/api/activeClient';
 
 export abstract class PaginationNoPageController<
   TPayloadDomain extends keyof Amity.Payloads,

package/src/core/model/idResolvers.ts

@@ -64,6 +64,9 @@ const idResolvers: Resolvers = {
 
   notificationTrayItem: ({ _id }) => _id,
   notificationTraySeen: ({ userId }) => userId,
+
+  invitation: ({ _id }) => _id,
+  joinRequest: ({ joinRequestId }) => joinRequestId,
 };
 
 /**

package/src/core/model/index.ts

@@ -54,6 +54,9 @@ export const PAYLOAD2MODEL: Record<string, Amity.Domain> = {
   pins: 'pin',
 
   notificationTrayItems: 'notificationTrayItem',
+
+  invitations: 'invitation',
+  joinRequests: 'joinRequest',
 };
 
 /** hidden */

package/src/index.ts

@@ -51,3 +51,5 @@ export * as AdRepository from './adRepository';
 export * from './external/api';
 
 export * as notificationTray from './notificationTray';
+
+export * as InvitationRepository from './invitationRepository';

package/src/invitationRepository/events/index.ts

@@ -0,0 +1,3 @@
+export * from './onLocalInvitationCreated';
+export * from './onLocalInvitationUpdated';
+export * from './onLocalInvitationDeleted';

package/src/invitationRepository/events/onLocalInvitationCreated.ts

@@ -0,0 +1,33 @@
+import { getActiveClient } from '~/client/api/activeClient';
+import { createEventSubscriber } from '~/core/events';
+
+/**
+ * ```js
+ * import { onLocalInvitationCreated } from '@amityco/ts-sdk'
+ * const dispose = onLocalInvitationCreated(data => {
+ *   // ...
+ * })
+ * ```
+ *
+ * Fired when an {@link Amity.InvitationPayload} has been created
+ *
+ * @param callback The function to call when the event was fired
+ * @returns an {@link Amity.Unsubscriber} function to stop listening
+ *
+ * @category Invitation Events
+ */
+export const onLocalInvitationCreated = (
+  callback: Amity.Listener<Amity.InternalInvitation[]>,
+): Amity.Unsubscriber => {
+  const client = getActiveClient();
+
+  const disposers = [
+    createEventSubscriber(client, 'onLocalInvitationCreated', 'local.invitation.created', payload =>
+      callback(payload),
+    ),
+  ];
+
+  return () => {
+    disposers.forEach(fn => fn());
+  };
+};

package/src/invitationRepository/events/onLocalInvitationDeleted.ts

@@ -0,0 +1,33 @@
+import { createEventSubscriber } from '~/core/events';
+import { getActiveClient } from '~/client/api/activeClient';
+
+/**
+ * ```js
+ * import { onLocalInvitationDeleted } from '@amityco/ts-sdk'
+ * const dispose = onLocalInvitationDeleted(data => {
+ *   // ...
+ * })
+ * ```
+ *
+ * Fired when an {@link Amity.InvitationPayload} has been deleted
+ *
+ * @param callback The function to call when the event was fired
+ * @returns an {@link Amity.Unsubscriber} function to stop listening
+ *
+ * @category Invitation Events
+ */
+export const onLocalInvitationDeleted = (
+  callback: Amity.Listener<Amity.InternalInvitation[]>,
+): Amity.Unsubscriber => {
+  const client = getActiveClient();
+
+  const disposers = [
+    createEventSubscriber(client, 'onLocalInvitationDeleted', 'local.invitation.deleted', payload =>
+      callback(payload),
+    ),
+  ];
+
+  return () => {
+    disposers.forEach(fn => fn());
+  };
+};

package/src/invitationRepository/events/onLocalInvitationUpdated.ts

@@ -0,0 +1,33 @@
+import { getActiveClient } from '~/client/api/activeClient';
+import { createEventSubscriber } from '~/core/events';
+
+/**
+ * ```js
+ * import { onLocalInvitationUpdated } from '@amityco/ts-sdk'
+ * const dispose = onLocalInvitationUpdated(data => {
+ *   // ...
+ * })
+ * ```
+ *
+ * Fired when an {@link Amity.InvitationPayload} has been updated
+ *
+ * @param callback The function to call when the event was fired
+ * @returns an {@link Amity.Unsubscriber} function to stop listening
+ *
+ * @category Invitation Events
+ */
+export const onLocalInvitationUpdated = (
+  callback: Amity.Listener<Amity.InternalInvitation[]>,
+): Amity.Unsubscriber => {
+  const client = getActiveClient();
+
+  const disposers = [
+    createEventSubscriber(client, 'onLocalInvitationUpdated', 'local.invitation.updated', payload =>
+      callback(payload),
+    ),
+  ];
+
+  return () => {
+    disposers.forEach(fn => fn());
+  };
+};

package/src/invitationRepository/index.ts

@@ -0,0 +1,2 @@
+export * from './events';
+export * from './observers';

package/src/invitationRepository/internalApi/acceptInvitation.ts

@@ -0,0 +1,45 @@
+import { fireEvent } from '~/core/events';
+import { getActiveClient } from '~/client/api/activeClient';
+import { pullFromCache, upsertInCache } from '~/cache/api';
+import { InvitationStatusEnum } from '~/@types';
+
+/* begin_public_function
+  id: invitation.accept
+*/
+/**
+ * ```js
+ * import { acceptInvitation } from '@amityco/ts-sdk'
+ * const isAccepted = await acceptInvitation(invitationId)
+ * ```
+ *
+ * Accepts a {@link Amity.Invitation} object
+ *
+ * @param invitationId the {@link Amity.Invitation} to accept
+ * @returns A success boolean if the {@link Amity.Invitation} was accepted
+ *
+ * @category Invitation API
+ * @async
+ */
+export const acceptInvitation = async (invitationId: Amity.Invitation['_id']): Promise<boolean> => {
+  const client = getActiveClient();
+  client.log('invitation/acceptInvitation', invitationId);
+
+  const { data } = await client.http.post<{ success: boolean }>(
+    `/api/v1/invitations/${invitationId}/accept`,
+  );
+
+  const invitation = pullFromCache<Amity.InternalInvitation>([
+    'invitation',
+    'get',
+    invitationId,
+  ])?.data;
+
+  if (invitation) {
+    upsertInCache(['invitation', 'get', invitationId], { status: InvitationStatusEnum.Approved });
+
+    fireEvent('local.invitation.updated', [invitation]);
+  }
+
+  return data.success;
+};
+/* end_public_function */

package/src/invitationRepository/internalApi/cancelInvitation.ts

@@ -0,0 +1,44 @@
+import { fireEvent } from '~/core/events';
+import { dropFromCache, pullFromCache } from '~/cache/api';
+import { getActiveClient } from '~/client/api/activeClient';
+
+/* begin_public_function
+  id: invitation.cancel
+*/
+/**
+ * ```js
+ * import { cancelInvitation } from '@amityco/ts-sdk'
+ * const isCanceled = await cancelInvitation(invitationId)
+ * ```
+ *
+ * Cancels a {@link Amity.Invitation} object
+ *
+ * @param invitationId the {@link Amity.Invitation} to cancel
+ * @returns A success boolean if the {@link Amity.Invitation} was canceled
+ *
+ * @category Invitation API
+ * @async
+ */
+export const cancelInvitation = async (invitationId: Amity.Invitation['_id']): Promise<boolean> => {
+  const client = getActiveClient();
+  client.log('invitation/cancelInvitation', invitationId);
+
+  const { data } = await client.http.delete<{ success: boolean }>(
+    `/api/v1/invitations/${invitationId}`,
+  );
+
+  const invitation = pullFromCache<Amity.InternalInvitation>([
+    'invitation',
+    'get',
+    invitationId,
+  ])?.data;
+
+  if (invitation) {
+    dropFromCache(['invitation', 'get', invitationId]);
+
+    fireEvent('local.invitation.deleted', [invitation]);
+  }
+
+  return data.success;
+};
+/* end_public_function */

package/src/invitationRepository/internalApi/createInvitations.ts

@@ -0,0 +1,52 @@
+import { fireEvent } from '~/core/events';
+import { getActiveClient } from '~/client/api/activeClient';
+import { ingestInCache } from '~/cache/api/ingestInCache';
+import { prepareInvitationPayload } from '../utils';
+
+/* begin_public_function
+  id: invitation.createInvitations
+*/
+/**
+ * ```js
+ * import { createInvitations } from '@amityco/ts-sdk'
+ * const created = await createInvitations({
+ *  type: string,
+ *  targetType: string,
+ *  targetId: string,
+ *  userIds: string[]
+ * }))
+ * ```
+ *
+ * Creates an {@link Amity.Invitation}
+ *
+ * @param bundle The data necessary to create a new {@link Amity.Invitation}
+ * @returns The newly created {@link Amity.Invitation}
+ *
+ * @category Invitation API
+ * @async
+ */
+export const createInvitations = async (
+  bundle: Amity.CreateInvitations,
+): Promise<Amity.Cached<Amity.InternalInvitation[]>> => {
+  const client = getActiveClient();
+  client.log('invitation/createInvitations', bundle);
+
+  const { data: payload } = await client.http.post<Amity.InvitationPayload>(
+    '/api/v1/invitations',
+    bundle,
+  );
+
+  const data = prepareInvitationPayload(payload);
+
+  const cachedAt = client.cache && Date.now();
+
+  if (client.cache) ingestInCache(data, { cachedAt });
+
+  fireEvent('local.invitation.created', data.invitations);
+
+  return {
+    data: data.invitations,
+    cachedAt,
+  };
+};
+/* end_public_function */

package/src/invitationRepository/internalApi/getInvitation.ts

@@ -0,0 +1,47 @@
+import { getActiveClient } from '~/client/api/activeClient';
+import { ingestInCache } from '~/cache/api/ingestInCache';
+import { prepareMyInvitationsPayload } from '../utils/prepareMyInvitationsPayload';
+import { invitationLinkedObject } from '~/utils/linkedObject/invitationLinkedObject';
+
+/* begin_public_function
+  id: invitation.get
+*/
+/**
+ * ```js
+ * import { getInvitation } from '@amityco/ts-sdk'
+ * const { invitation } = await getInvitation(targetType, targetId)
+ * ```
+ *
+ * Get a {@link Amity.Invitation} object
+ *
+ * @param targetType The type of the target of the {@link Amity.Invitation}
+ * @param targetId The ID of the target of the {@link Amity.Invitation}
+ * @returns A {@link Amity.Invitation} object
+ *
+ * @category Invitation API
+ * @async
+ */
+export const getInvitation = async (
+  targetType: Amity.Invitation['targetType'],
+  targetId: Amity.Invitation['targetId'],
+): Promise<Amity.Cached<Amity.Invitation | undefined>> => {
+  const client = getActiveClient();
+  client.log('invitation/getInvitation', targetType, targetId);
+
+  const { data: payload } = await client.http.get<Amity.MyInvitationsPayload>(
+    `/api/v1/invitations/me`,
+    { params: { targetType, targetId } },
+  );
+
+  const data = prepareMyInvitationsPayload(payload);
+
+  const cachedAt = client.cache && Date.now();
+
+  if (client.cache) ingestInCache(data, { cachedAt });
+
+  return {
+    data: data.invitations[0] ? invitationLinkedObject(data.invitations[0]) : undefined,
+    cachedAt,
+  };
+};
+/* end_public_function */

package/src/invitationRepository/internalApi/index.ts

@@ -0,0 +1,4 @@
+export * from './createInvitations';
+export * from './acceptInvitation';
+export * from './rejectInvitation';
+export * from './cancelInvitation';

package/src/invitationRepository/internalApi/rejectInvitation.ts

@@ -0,0 +1,45 @@
+import { fireEvent } from '~/core/events';
+import { InvitationStatusEnum } from '~/@types';
+import { pullFromCache, upsertInCache } from '~/cache/api';
+import { getActiveClient } from '~/client/api/activeClient';
+
+/* begin_public_function
+  id: invitation.reject
+*/
+/**
+ * ```js
+ * import { rejectInvitation } from '@amityco/ts-sdk'
+ * const isRejected = await rejectInvitation(invitationId)
+ * ```
+ *
+ * Rejects a {@link Amity.Invitation} object
+ *
+ * @param invitationId the {@link Amity.Invitation} to reject
+ * @returns A success boolean if the {@link Amity.Invitation} was rejected
+ *
+ * @category Invitation API
+ * @async
+ */
+export const rejectInvitation = async (invitationId: Amity.Invitation['_id']): Promise<boolean> => {
+  const client = getActiveClient();
+  client.log('invitation/rejectInvitation', invitationId);
+
+  const { data } = await client.http.post<{ success: boolean }>(
+    `/api/v1/invitations/${invitationId}/reject`,
+  );
+
+  const invitation = pullFromCache<Amity.InternalInvitation>([
+    'invitation',
+    'get',
+    invitationId,
+  ])?.data;
+
+  if (invitation) {
+    upsertInCache(['invitation', 'get', invitationId], { status: InvitationStatusEnum.Rejected });
+
+    fireEvent('local.invitation.updated', [invitation]);
+  }
+
+  return data.success;
+};
+/* end_public_function */