@amityco/ts-sdk 0.0.1-beta.16 → 0.0.1-beta.17

package/src/comment/events/onCommentReactionRemoved.ts

@@ -1,8 +1,8 @@
-import { getActiveClient } from '~/client/api'
-import { pullFromCache } from '~/cache/api'
-import { ingestInCache } from '~/cache/api/ingestInCache'
-import { createEventSubscriber } from '~/core/events'
-import { preparePayloadForCache } from '~/reaction/utils'
+import { getActiveClient } from '~/client/api';
+import { pullFromCache } from '~/cache/api';
+import { ingestInCache } from '~/cache/api/ingestInCache';
+import { createEventSubscriber } from '~/core/events';
+import { preparePayloadForCache } from '~/reaction/utils';
 
 /**
  * ```js
@@ -20,29 +20,29 @@ import { preparePayloadForCache } from '~/reaction/utils'
  * @category Comment Events
  */
 export const onCommentReactionRemoved = (
-  callback: Amity.Listener<Amity.Comment>
+  callback: Amity.Listener<Amity.Comment>,
 ): Amity.Unsubscriber => {
-  const client = getActiveClient()
+  const client = getActiveClient();
 
   const filter = (payload: Amity.CommentPayload & { reactor: Amity.Reaction }) => {
     if (!client.cache) {
-      callback(payload.comments[0])
+      callback(payload.comments[0]);
     } else {
-      preparePayloadForCache('comment.removeReaction', payload)
+      preparePayloadForCache('comment.removeReaction', payload);
+      // eslint-disable-next-line @typescript-eslint/no-unused-vars
       const { reactor, ...commentPayload } = payload;
 
-      ingestInCache(commentPayload as Amity.CommentPayload)
+      ingestInCache(commentPayload as Amity.CommentPayload);
 
-      const comment = pullFromCache<Amity.Comment>(['comment', 'get', payload.comments[0].commentId])!
+      const comment = pullFromCache<Amity.Comment>([
+        'comment',
+        'get',
+        payload.comments[0].commentId,
+      ])!;
 
-      callback(comment.data)
+      callback(comment.data);
     }
-  }
+  };
 
-  return createEventSubscriber(
-    client,
-    'comment.removeReaction',
-    'comment.removeReaction',
-    filter
-  )
-}
+  return createEventSubscriber(client, 'comment.removeReaction', 'comment.removeReaction', filter);
+};

package/src/comment/events/onCommentUnflagged.ts

@@ -1,4 +1,4 @@
-import { createCommentEventSubscriber } from './utils'
+import { createCommentEventSubscriber } from './utils';
 
 /**
  * ```js
@@ -15,7 +15,5 @@ import { createCommentEventSubscriber } from './utils'
  *
  * @category Comment Events
  */
-export const onCommentUnflagged = (
-  callback: Amity.Listener<Amity.Comment>
-): Amity.Unsubscriber =>
-  createCommentEventSubscriber('comment.unflagged', callback)
+export const onCommentUnflagged = (callback: Amity.Listener<Amity.Comment>): Amity.Unsubscriber =>
+  createCommentEventSubscriber('comment.unflagged', callback);

package/src/comment/events/onCommentUpdated.ts

@@ -1,4 +1,4 @@
-import { createCommentEventSubscriber } from './utils'
+import { createCommentEventSubscriber } from './utils';
 
 /**
  * ```js
@@ -15,7 +15,5 @@ import { createCommentEventSubscriber } from './utils'
  *
  * @category Comment Events
  */
-export const onCommentUpdated = (
-  callback: Amity.Listener<Amity.Comment>
-): Amity.Unsubscriber =>
-  createCommentEventSubscriber('comment.updated', callback)
+export const onCommentUpdated = (callback: Amity.Listener<Amity.Comment>): Amity.Unsubscriber =>
+  createCommentEventSubscriber('comment.updated', callback);

package/src/comment/events/utils.ts

@@ -1,39 +1,38 @@
-import { getActiveClient } from '~/client/api'
-import { createEventSubscriber } from '~/core/events'
-import { queryCache, upsertInCache, pullFromCache } from '~/cache/api'
-import { ingestInCache } from '~/cache/api/ingestInCache'
+import { getActiveClient } from '~/client/api';
+import { createEventSubscriber } from '~/core/events';
+import { queryCache, upsertInCache, pullFromCache } from '~/cache/api';
+import { ingestInCache } from '~/cache/api/ingestInCache';
 
 export const createCommentEventSubscriber = (
   event: keyof Amity.MqttCommentMessageEvents,
-  callback: Amity.Listener<Amity.Comment>
+  callback: Amity.Listener<Amity.Comment>,
 ) => {
-  const client = getActiveClient()
+  const client = getActiveClient();
 
   const filter = (payload: Amity.CommentPayload) => {
     if (!client.cache) {
       // TODO: here we are missing specific properties here!
-      callback(payload.comments[0])
+      callback(payload.comments[0]);
     } else {
-      ingestInCache(payload)
+      ingestInCache(payload);
 
-      const comment = pullFromCache<Amity.Comment>(['comment', 'get', payload.comments[0].commentId])!
+      const comment = pullFromCache<Amity.Comment>([
+        'comment',
+        'get',
+        payload.comments[0].commentId,
+      ])!;
 
       if (['comment.created'].includes(event)) {
         const queries = queryCache(['comment', 'query'])
           // @ts-ignore
-          ?.filter(({key}) => key[2]?.referenceId === comment.data.referenceId);
+          ?.filter(({ key }) => key[2]?.referenceId === comment.data.referenceId);
 
-        queries?.map(({key, data}) => upsertInCache(key, data as any, { cachedAt: -1 }));
+        queries?.map(({ key, data }) => upsertInCache(key, data as any, { cachedAt: -1 }));
       }
 
-      callback(comment.data)
+      callback(comment.data);
     }
-  }
+  };
 
-  return createEventSubscriber(
-    client,
-    event,
-    event,
-    filter
-  )
-}
+  return createEventSubscriber(client, event, event, filter);
+};

package/src/comment/observers/index.ts

@@ -1,2 +1,2 @@
-export * from './observeComments'
-export * from './observeComment'
+export * from './observeComments';
+export * from './observeComment';

package/src/comment/observers/observeComment.ts

@@ -1,8 +1,8 @@
-import { getActiveClient } from '~/client/api'
+import { getActiveClient } from '~/client/api';
 
-import { createQuery, runQuery, queryOptions } from '~/core/query'
+import { createQuery, runQuery, queryOptions } from '~/core/query';
 
-import { getComment } from '../api'
+import { getComment } from '../api';
 
 import {
   onCommentUpdated,
@@ -11,8 +11,7 @@ import {
   onCommentUnflagged,
   onCommentReactionAdded,
   onCommentReactionRemoved,
-} from '../events'
-
+} from '../events';
 
 /**
  * ```js
@@ -30,56 +29,68 @@ import {
  *
  * @category Comment Observer
  */
-export const observeComment = <Events extends ['onFetch', 'onUpdate', 'onDelete', 'onFlagged', 'onUnflagged', 'onReactionAdded', 'onReactionRemoved']>(
+export const observeComment = <
+  Events extends [
+    'onFetch',
+    'onUpdate',
+    'onDelete',
+    'onFlagged',
+    'onUnflagged',
+    'onReactionAdded',
+    'onReactionRemoved',
+  ],
+>(
   commentId: string,
   callback: Amity.ObjectListener<Amity.Snapshot<Amity.Comment | undefined>, Events>,
-  policy: Amity.QueryPolicy = 'cache_then_server'
+  policy: Amity.QueryPolicy = 'cache_then_server',
 ): Amity.Unsubscriber => {
-  const { log } = getActiveClient()
+  const { log } = getActiveClient();
 
-  const timestamp = Date.now()
-  log(`observeComment(tmpid: ${timestamp}) > listen`)
+  const timestamp = Date.now();
+  log(`observeComment(tmpid: ${timestamp}) > listen`);
 
   // wrapper function to make sure
-  const router = (
-    result: Amity.Snapshot<Amity.Comment | undefined>,
-    action: Events[number]
-  ) => {
-    if (callback instanceof Function) return callback(result)
+  const router = (result: Amity.Snapshot<Amity.Comment | undefined>, action: Events[number]) => {
+    if (callback instanceof Function) return callback(result);
 
-    if (action !== 'onFetch') callback.onEvent?.(action, result)
+    if (action !== 'onFetch') callback.onEvent?.(action, result);
 
-    callback[action]?.(result)
-  }
+    callback[action]?.(result);
+  };
 
-  const realtimeRouter = (
-    result: Amity.Snapshot<Amity.Comment>,
-    action: Events[number]
-  ) => {
-    if (result.data?.commentId !== commentId) return
+  const realtimeRouter = (result: Amity.Snapshot<Amity.Comment>, action: Events[number]) => {
+    if (result.data?.commentId !== commentId) return;
 
-    router(result, action)
-  }
+    router(result, action);
+  };
 
-  const disposers: Amity.Unsubscriber[] = []
+  const disposers: Amity.Unsubscriber[] = [];
 
   disposers.push(
     onCommentUpdated(data => realtimeRouter({ data, loading: false, origin: 'event' }, 'onUpdate')),
     onCommentDeleted(data => realtimeRouter({ data, loading: false, origin: 'event' }, 'onDelete')),
-    onCommentFlagged(data => realtimeRouter({ data, loading: false, origin: 'event' }, 'onFlagged')),
-    onCommentUnflagged(data => realtimeRouter({ data, loading: false, origin: 'event' }, 'onUnflagged')),
-    onCommentReactionAdded(data => realtimeRouter({ data, loading: false, origin: 'event' }, 'onReactionAdded')),
-    onCommentReactionRemoved(data => realtimeRouter({ data, loading: false, origin: 'event' }, 'onReactionRemoved')),
-  )
+    onCommentFlagged(data =>
+      realtimeRouter({ data, loading: false, origin: 'event' }, 'onFlagged'),
+    ),
+    onCommentUnflagged(data =>
+      realtimeRouter({ data, loading: false, origin: 'event' }, 'onUnflagged'),
+    ),
+    onCommentReactionAdded(data =>
+      realtimeRouter({ data, loading: false, origin: 'event' }, 'onReactionAdded'),
+    ),
+    onCommentReactionRemoved(data =>
+      realtimeRouter({ data, loading: false, origin: 'event' }, 'onReactionRemoved'),
+    ),
+  );
 
   runQuery(
     createQuery(getComment, commentId),
     result => (result.data || result.error) && router(result, 'onFetch'),
-    queryOptions(policy)
-  )
+    queryOptions(policy),
+  );
 
   return () => {
-    log(`observeComment(tmpid: ${timestamp}) > dispose`)
-    disposers.forEach(fn => fn())
-  }
-}
+    log(`observeComment(tmpid: ${timestamp}) > dispose`);
+    disposers.forEach(fn => fn());
+  };
+};

package/src/comment/observers/observeComments.ts

@@ -1,4 +1,4 @@
-import { getActiveClient } from '~/client/api'
+import { getActiveClient } from '~/client/api';
 
 import {
   onCommentCreated,
@@ -8,7 +8,7 @@ import {
   onCommentUnflagged,
   onCommentReactionAdded,
   onCommentReactionRemoved,
-} from '../events'
+} from '../events';
 
 /**
  * ```js
@@ -30,27 +30,42 @@ export const observeComments = (
   postId: Amity.Post['postId'],
   callback: Amity.ObjectListener<
     Amity.Comment,
-    ['onCreate', 'onUpdate', 'onDelete', 'onFlagged', 'onUnflagged', 'onReactionAdded', 'onReactionRemoved']
-  >
+    [
+      'onCreate',
+      'onUpdate',
+      'onDelete',
+      'onFlagged',
+      'onUnflagged',
+      'onReactionAdded',
+      'onReactionRemoved',
+    ]
+  >,
 ): Amity.Unsubscriber => {
-  const { log } = getActiveClient()
+  const { log } = getActiveClient();
 
-  const timestamp = Date.now()
-  log(`observeComments(tmpid: ${timestamp}) > listen`)
+  const timestamp = Date.now();
+  log(`observeComments(tmpid: ${timestamp}) > listen`);
 
-  const disposers: Amity.Unsubscriber[] = []
+  const disposers: Amity.Unsubscriber[] = [];
 
   const router = (
     comment: Amity.Comment,
-    action: 'onCreate' | 'onUpdate' | 'onDelete' | 'onFlagged' | 'onUnflagged' | 'onReactionAdded' | 'onReactionRemoved'
+    action:
+      | 'onCreate'
+      | 'onUpdate'
+      | 'onDelete'
+      | 'onFlagged'
+      | 'onUnflagged'
+      | 'onReactionAdded'
+      | 'onReactionRemoved',
   ) => {
-    if (comment.referenceId !== postId) return
+    if (comment.referenceId !== postId) return;
 
-    if (callback instanceof Function) return callback(comment)
+    if (callback instanceof Function) return callback(comment);
 
-    callback.onEvent?.(action, comment)
-    callback[action]?.(comment)
-  }
+    callback.onEvent?.(action, comment);
+    callback[action]?.(comment);
+  };
 
   disposers.push(
     onCommentCreated(comment => router(comment, 'onCreate')),
@@ -60,10 +75,10 @@ export const observeComments = (
     onCommentUnflagged(comment => router(comment, 'onUnflagged')),
     onCommentReactionAdded(comment => router(comment, 'onReactionAdded')),
     onCommentReactionRemoved(comment => router(comment, 'onReactionRemoved')),
-  )
+  );
 
   return () => {
-    log(`observeComments(tmpid: ${timestamp}) > dispose`)
-    disposers.forEach(fn => fn())
-  }
-}
+    log(`observeComments(tmpid: ${timestamp}) > dispose`);
+    disposers.forEach(fn => fn());
+  };
+};

package/src/community/api/addCommunityMembers.ts

@@ -1,7 +1,7 @@
-import { getActiveClient } from '~/client/api'
+import { getActiveClient } from '~/client/api';
 
-import { fireEvent } from '~/core/events'
-import { ingestInCache } from '~/cache/api/ingestInCache'
+import { fireEvent } from '~/core/events';
+import { ingestInCache } from '~/cache/api/ingestInCache';
 
 /**
  * ```js
@@ -20,24 +20,23 @@ import { ingestInCache } from '~/cache/api/ingestInCache'
  */
 export const addCommunityMembers = async (
   communityId: Amity.Community['communityId'],
-  userIds: Amity.User['userId'][]
+  userIds: Amity.User['userId'][],
 ): Promise<boolean> => {
-  const client = getActiveClient()
-  client.log('community/addCommunityMembers', communityId, userIds)
+  const client = getActiveClient();
+  client.log('community/addCommunityMembers', communityId, userIds);
 
   const { data } = await client.http.post<Amity.CommunityMembershipPayload>(
     `/api/v3/communities/${communityId}/users`,
-    { communityId, userIds }
-  )
+    { communityId, userIds },
+  );
 
-  if (client.cache) ingestInCache(data)
+  if (client.cache) ingestInCache(data);
 
-  fireEvent('community.userAdded', data)
+  fireEvent('community.userAdded', data);
 
-  const { communityUsers } = data
+  const { communityUsers } = data;
   return !!communityUsers.find(
     communityUser =>
-      communityUser.communityId === communityId &&
-      communityUser.communityMembership === 'member'
-  )
-}
+      communityUser.communityId === communityId && communityUser.communityMembership === 'member',
+  );
+};

package/src/community/api/addCommunityMembersRoles.ts

@@ -0,0 +1,42 @@
+import { getActiveClient } from '~/client/api';
+
+import { ingestInCache } from '~/cache/api/ingestInCache';
+
+/**
+ * ```js
+ * import { addCommunityMembersRoles } from '@amityco/ts-sdk'
+ * const updated = await addCommunityMembersRoles(communityId, ['foo'], ['bar'])
+ * ```
+ *
+ * Adds a list of {@link Amity.Role} to a list of {@link Amity.User} on a {@link Amity.Community}
+ *
+ * @param communityId The ID of the {@link Amity.Community} to perform
+ * @param roleIds Array of IDs of the {@link Amity.Role} to apply
+ * @param userId Array of IDs of the {@link Amity.User} to perform
+ * @returns A success boolean if the {@link Amity.Role} were added to list of {@link Amity.User} in the {@link Amity.Community}
+ *
+ * @category Community API
+ * @async
+ */
+export const addCommunityMembersRoles = async (
+  communityId: Amity.Community['communityId'],
+  roleIds: Amity.Role['roleId'][],
+  userIds: Amity.User['userId'][],
+): Promise<boolean> => {
+  const client = getActiveClient();
+  client.log('community/addCommunityMembersRoles', communityId, roleIds, userIds);
+
+  const { data } = await client.http.post<Amity.CommunityMembershipPayload>(
+    `/api/v4/communities/${communityId}/users/roles`,
+    { communityId, roles: roleIds, userIds },
+  );
+
+  if (client.cache) ingestInCache(data);
+
+  const { communityUsers } = data;
+  return !!communityUsers.find(
+    communityUser =>
+      communityUser.communityId === communityId &&
+      roleIds.some(role => communityUser.roles.includes(role)),
+  );
+};

package/src/community/api/createCommunity.ts

@@ -1,7 +1,7 @@
-import { getActiveClient } from '~/client/api'
+import { getActiveClient } from '~/client/api';
 
-import { ingestInCache } from '~/cache/api/ingestInCache'
-import { fireEvent } from '~/core/events'
+import { ingestInCache } from '~/cache/api/ingestInCache';
+import { fireEvent } from '~/core/events';
 
 /**
  * ```js
@@ -20,27 +20,34 @@ import { fireEvent } from '~/core/events'
 export const createCommunity = async (
   bundle: Pick<
     Amity.Community,
-    'displayName' | 'avatarFileId' | 'description' | 'isPublic' | 'isOfficial' | 'onlyAdminCanPost' | 'needApprovalOnPostCreation' | 'tags' | 'metadata'
+    | 'displayName'
+    | 'avatarFileId'
+    | 'description'
+    | 'isPublic'
+    | 'isOfficial'
+    | 'onlyAdminCanPost'
+    | 'needApprovalOnPostCreation'
+    | 'tags'
+    | 'metadata'
   > & {
-    userIds?: string[]
-    categoryIds?: string[]
-    isUniqueDisplayName?: boolean
-  }): Promise<Amity.Cached<Amity.Community>> => {
-  const client = getActiveClient()
-  client.log('user/createCommunity', bundle)
+    userIds?: string[];
+    categoryIds?: string[];
+    isUniqueDisplayName?: boolean;
+  },
+): Promise<Amity.Cached<Amity.Community>> => {
+  const client = getActiveClient();
+  client.log('user/createCommunity', bundle);
 
-  const { data } = await client.http.post<Amity.CommunityPayload>(
-    '/api/v3/communities/', bundle,
-  )
+  const { data } = await client.http.post<Amity.CommunityPayload>('/api/v3/communities/', bundle);
 
-  const cachedAt = client.cache && Date.now()
-  if (client.cache) ingestInCache(data, { cachedAt })
+  const cachedAt = client.cache && Date.now();
+  if (client.cache) ingestInCache(data, { cachedAt });
 
-  fireEvent('community.created', data)
+  fireEvent('community.created', data);
 
-  const { communities } = data
+  const { communities } = data;
   return {
     data: communities[0],
     cachedAt,
-  }
-}
+  };
+};

package/src/community/api/deleteCommunity.ts

@@ -1,7 +1,7 @@
-import { getActiveClient } from '~/client/api'
+import { getActiveClient } from '~/client/api';
 
-import { fireEvent } from '~/core/events'
-import { getCommunity } from './getCommunity'
+import { fireEvent } from '~/core/events';
+import { getCommunity } from './getCommunity';
 
 /**
  * ```js
@@ -20,16 +20,14 @@ import { getCommunity } from './getCommunity'
 export const deleteCommunity = async (
   communityId: Amity.Community['communityId'],
 ): Promise<Amity.Community> => {
-  const client = getActiveClient()
-  client.log('community/deleteCommunity', communityId)
+  const client = getActiveClient();
+  client.log('community/deleteCommunity', communityId);
 
   // API-FIX: This endpoint has not been implemented yet.
-  await client.http.delete<{ success: boolean }>(
-    `/api/v3/communities/${communityId}`,
-  )
+  await client.http.delete<{ success: boolean }>(`/api/v3/communities/${communityId}`);
 
-  const deleted = await getCommunity(communityId)
-  fireEvent('community.deleted', { communities: [deleted.data] })
+  const deleted = await getCommunity(communityId);
+  fireEvent('community.deleted', { communities: [deleted.data] });
 
-  return deleted.data
-}
+  return deleted.data;
+};

package/src/community/api/getCommunities.ts

@@ -1,7 +1,7 @@
-import { getActiveClient } from '~/client/api'
+import { getActiveClient } from '~/client/api';
 
-import { pullFromCache } from '~/cache/api'
-import { ingestInCache } from '~/cache/api/ingestInCache'
+import { pullFromCache } from '~/cache/api';
+import { ingestInCache } from '~/cache/api/ingestInCache';
 
 /**
  * ```js
@@ -18,25 +18,24 @@ import { ingestInCache } from '~/cache/api/ingestInCache'
  * @async
  */
 export const getCommunities = async (
-  communityIds: Amity.Community['communityId'][]
+  communityIds: Amity.Community['communityId'][],
 ): Promise<Amity.Cached<Amity.Community[]>> => {
-  const client = getActiveClient()
-  client.log('community/getCommunities', communityIds)
+  const client = getActiveClient();
+  client.log('community/getCommunities', communityIds);
 
   // API-FIX: endpoint should not be /list, parameters should be querystring.
-  const { data } = await client.http.get<Amity.CommunityPayload>(
-    `/api/v3/communities/list`,
-    { params: { communityIds } },
-  )
+  const { data } = await client.http.get<Amity.CommunityPayload>(`/api/v3/communities/list`, {
+    params: { communityIds },
+  });
 
-  const cachedAt = client.cache && Date.now()
-  if (client.cache) ingestInCache(data, { cachedAt })
+  const cachedAt = client.cache && Date.now();
+  if (client.cache) ingestInCache(data, { cachedAt });
 
   return {
     data: data.communities,
-    cachedAt
-  }
-}
+    cachedAt,
+  };
+};
 
 /**
  * ```js
@@ -52,25 +51,24 @@ export const getCommunities = async (
  * @category Community API
  */
 getCommunities.locally = (
-  communityIds: Amity.Community['communityId'][]
+  communityIds: Amity.Community['communityId'][],
 ): Amity.Cached<Amity.Community[]> | undefined => {
-  const client = getActiveClient()
-  client.log('community/getCommunities.locally', communityIds)
+  const client = getActiveClient();
+  client.log('community/getCommunities.locally', communityIds);
 
-  if (!client.cache) return
+  if (!client.cache) return;
 
   const cached = communityIds
     .map(communityId => pullFromCache<Amity.Community>(['community', 'get', communityId])!)
-    .filter(Boolean)
+    .filter(Boolean);
 
-  const communities = cached.map(({ data }) => data)
-  const oldest = cached.sort((a, b) => a.cachedAt! < b.cachedAt! ? -1 : 1)?.[0]
+  const communities = cached.map(({ data }) => data);
+  const oldest = cached.sort((a, b) => (a.cachedAt! < b.cachedAt! ? -1 : 1))?.[0];
 
-  if (cached?.length < communityIds.length)
-    return
+  if (cached?.length < communityIds.length) return;
 
   return {
     data: communities,
     cachedAt: oldest.cachedAt,
-  }
-}
+  };
+};