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

package/src/community/api/joinCommunity.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
@@ -18,24 +18,24 @@ import { fireEvent } from '~/core/events'
  * @async
  */
 export const joinCommunity = async (
-  communityId: Amity.Community['communityId']
+  communityId: Amity.Community['communityId'],
 ): Promise<boolean> => {
-  const client = getActiveClient()
-  client.log('community/joinCommunity', communityId)
+  const client = getActiveClient();
+  client.log('community/joinCommunity', communityId);
 
   const { data } = await client.http.post<Amity.CommunityMembershipPayload>(
     `/api/v3/communities/${communityId}/join`,
-  )
+  );
 
-  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.joined', data)
+  fireEvent('community.joined', data);
 
-  const { communityUsers } = data
+  const { communityUsers } = data;
 
-  return !!communityUsers.find(communityUser => (
-    communityUser.communityId === communityId
-    && communityUser.communityMembership === 'member'
-  ))
-}
+  return !!communityUsers.find(
+    communityUser =>
+      communityUser.communityId === communityId && communityUser.communityMembership === 'member',
+  );
+};

package/src/community/api/leaveCommunity.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
@@ -18,24 +18,24 @@ import { fireEvent } from '~/core/events'
  * @async
  */
 export const leaveCommunity = async (
-  communityId: Amity.Community['communityId']
+  communityId: Amity.Community['communityId'],
 ): Promise<boolean> => {
-  const client = getActiveClient()
-  client.log('community/leaveCommunity', communityId)
+  const client = getActiveClient();
+  client.log('community/leaveCommunity', communityId);
 
   const { data } = await client.http.delete<Amity.CommunityMembershipPayload>(
     `/api/v3/communities/${communityId}/leave`,
-  )
+  );
 
-  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.left', data)
+  fireEvent('community.left', data);
 
-  const { communityUsers } = data
+  const { communityUsers } = data;
 
-  return !!communityUsers.find(communityUser => (
-    communityUser.communityId === communityId
-    && communityUser.communityMembership !== 'member'
-  ))
-}
+  return !!communityUsers.find(
+    communityUser =>
+      communityUser.communityId === communityId && communityUser.communityMembership !== 'member',
+  );
+};

package/src/community/api/queryCommunities.ts

@@ -1,9 +1,9 @@
-import { getActiveClient } from '~/client/api'
+import { getActiveClient } from '~/client/api';
 
-import { toPage, toToken } from '~/core/query'
-import { pushToCache } from '~/cache/api'
-import { ingestInCache } from '~/cache/api/ingestInCache'
-import { getResolver } from '~/core/model'
+import { toPage, toToken } from '~/core/query';
+import { pushToCache } from '~/cache/api';
+import { ingestInCache } from '~/cache/api/ingestInCache';
+import { getResolver } from '~/core/model';
 
 /**
  * ```js
@@ -20,60 +20,60 @@ import { getResolver } from '~/core/model'
  * @category Community API
  * @async
  */
-export const queryCommunities = async (
-  query?: {
-    displayName?: string
-    membership?: 'all' | 'member' | 'notMember'
-    categoryId?: Amity.Category['categoryId'],
-    isDeleted?: Amity.Community['isDeleted'],
-    hasFlag?: boolean,
-    tags?: Amity.Taggable['tags'],
-    sortBy?: ('displayName' | 'firstCreated' | 'lastCreated')
-    page?: Amity.Page
-  }
-): Promise<Amity.Cached<Amity.Paged<Amity.Community>>> => {
-  const client = getActiveClient()
-  client.log('channel/queryCommunities', query)
+export const queryCommunities = async (query?: {
+  displayName?: string;
+  membership?: 'all' | 'member' | 'notMember';
+  categoryId?: Amity.Category['categoryId'];
+  isDeleted?: Amity.Community['isDeleted'];
+  hasFlag?: boolean;
+  tags?: Amity.Taggable['tags'];
+  sortBy?: 'displayName' | 'firstCreated' | 'lastCreated';
+  page?: Amity.Page;
+}): Promise<Amity.Cached<Amity.Paged<Amity.Community>>> => {
+  const client = getActiveClient();
+  client.log('channel/queryCommunities', query);
 
   // safe decapsulation
-  const {
-    page,
-    displayName,
-    membership,
-    ...params
-  } = query ?? {}
+  const { page, displayName, membership, ...params } = query ?? {};
 
   // API-FIX: parameters should be querystring.
   // API-FIX: backend doesnt answer Amity.Response
   // const { data } = await client.http.get<Amity.Response<Amity.PagedResponse<CommunityPayload>>>(
   const { data } = await client.http.get<Amity.CommunityPayload & Amity.Pagination>(
-    `/api/v3/communities`, { params: {
-      ...params,
-      keyword: displayName,
-      filter: membership,
-      options: {
-        token: toToken(page, 'skiplimit')
-      }
-    } }
-  )
+    `/api/v3/communities`,
+    {
+      params: {
+        ...params,
+        keyword: displayName,
+        filter: membership,
+        options: {
+          token: toToken(page, 'skiplimit'),
+        },
+      },
+    },
+  );
 
-  const { paging, ...payload } = data
-  const { communities } = payload
+  const { paging, ...payload } = data;
+  const { communities } = payload;
 
-  const cachedAt = client.cache && Date.now()
+  const cachedAt = client.cache && Date.now();
 
   if (client.cache) {
-    ingestInCache(payload as Amity.CommunityPayload, { cachedAt })
+    ingestInCache(payload as Amity.CommunityPayload, { cachedAt });
 
-    const cacheKey = ['community', 'query', { ...params, options: { ...page } } as Amity.Serializable]
-    pushToCache(cacheKey, { communities: communities.map(getResolver('community')), paging })
+    const cacheKey = [
+      'community',
+      'query',
+      { ...params, options: { ...page } } as Amity.Serializable,
+    ];
+    pushToCache(cacheKey, { communities: communities.map(getResolver('community')), paging });
   }
 
-  const nextPage = toPage(paging.next)
-  const prevPage = toPage(paging.previous)
+  const nextPage = toPage(paging.next);
+  const prevPage = toPage(paging.previous);
 
-  return { data: communities, cachedAt, prevPage, nextPage }
-}
+  return { data: communities, cachedAt, prevPage, nextPage };
+};
 
 /**
  * ```js
@@ -88,11 +88,9 @@ export const queryCommunities = async (
  *
  * @category Community API
  */
-queryCommunities.locally = (
-  query: Parameters<typeof queryCommunities>[0],
-) => {
-  const client = getActiveClient()
-  client.log('community/queryCommunities.locally', query)
+queryCommunities.locally = (query: Parameters<typeof queryCommunities>[0]) => {
+  const client = getActiveClient();
+  client.log('community/queryCommunities.locally', query);
 
   // TODO
-}
+};

package/src/community/api/queryCommunityMembers.ts

@@ -1,7 +1,7 @@
-import { getActiveClient } from '~/client/api'
+import { getActiveClient } from '~/client/api';
 
-import { toPage, toToken } from '~/core/query'
-import { ingestInCache } from '~/cache/api/ingestInCache'
+import { toPage, toToken } from '~/core/query';
+import { ingestInCache } from '~/cache/api/ingestInCache';
 
 /**
  * ```js
@@ -16,43 +16,44 @@ import { ingestInCache } from '~/cache/api/ingestInCache'
  *
  * @category Community API
  * @async
- **/
+ * */
 export const queryCommunityMembers = async (query: {
-  communityId: string
-  membership?: ('banned' | 'member')[]
-  roles?: string[]
-  sortBy?: 'firstCreated' | 'lastCreated'
-  page?: Amity.Page
-}): Promise<Amity.Cached<Amity.Paged<Amity.Membership<"community">>>> => {
-  const client = getActiveClient()
-  client.log('community/queryCommunityMembers', query)
+  communityId: string;
+  membership?: ('banned' | 'member')[];
+  roles?: string[];
+  sortBy?: 'firstCreated' | 'lastCreated';
+  page?: Amity.Page;
+}): Promise<Amity.Cached<Amity.Paged<Amity.Membership<'community'>>>> => {
+  const client = getActiveClient();
+  client.log('community/queryCommunityMembers', query);
 
-  const { page, communityId, ...params } = query ?? {}
+  const { page, communityId, ...params } = query ?? {};
 
-  const { data } = await client.http.get<
-    Amity.CommunityMembershipPayload & Amity.Pagination
-  >(`/api/v3/communities/${communityId}/users`, {
-    params: {
-      ...params,
-      options: {
-        token: toToken(page, 'skiplimit'),
+  const { data } = await client.http.get<Amity.CommunityMembershipPayload & Amity.Pagination>(
+    `/api/v3/communities/${communityId}/users`,
+    {
+      params: {
+        ...params,
+        options: {
+          token: toToken(page, 'skiplimit'),
+        },
       },
     },
-  })
+  );
 
-  const { paging, ...payload } = data
-  const { communityUsers } = payload
+  const { paging, ...payload } = data;
+  const { communityUsers } = payload;
 
-  const cachedAt = client.cache && Date.now()
+  const cachedAt = client.cache && Date.now();
   if (client.cache) {
-    ingestInCache(payload as Amity.CommunityMembershipPayload, { cachedAt })
+    ingestInCache(payload as Amity.CommunityMembershipPayload, { cachedAt });
   }
 
-  const nextPage = toPage(paging.next)
-  const prevPage = toPage(paging.previous)
+  const nextPage = toPage(paging.next);
+  const prevPage = toPage(paging.previous);
 
-  return { data: communityUsers, cachedAt, nextPage, prevPage }
-}
+  return { data: communityUsers, cachedAt, nextPage, prevPage };
+};
 
 /**
  * ```js
@@ -67,11 +68,9 @@ export const queryCommunityMembers = async (query: {
  *
  * @category Post API
  */
-queryCommunityMembers.locally = (
-  query: Parameters<typeof queryCommunityMembers>[0]
-) => {
-  const client = getActiveClient()
-  client.log('community/queryCommunityMembers', query)
+queryCommunityMembers.locally = (query: Parameters<typeof queryCommunityMembers>[0]) => {
+  const client = getActiveClient();
+  client.log('community/queryCommunityMembers', query);
 
   // TODO
-}
+};

package/src/community/api/removeCommunityMembers.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,24 +20,23 @@ import { fireEvent } from '~/core/events'
  */
 export const removeCommunityMembers = async (
   communityId: Amity.Community['communityId'],
-  userIds: Amity.User['userId'][]
+  userIds: Amity.User['userId'][],
 ): Promise<boolean> => {
-  const client = getActiveClient()
-  client.log('community/removeCommunityMembers', communityId, userIds)
+  const client = getActiveClient();
+  client.log('community/removeCommunityMembers', communityId, userIds);
 
   const { data } = await client.http.delete<Amity.CommunityMembershipPayload>(
     `/api/v3/communities/${communityId}/users`,
-    { data: { communityId, userIds } }
-  )
+    { data: { communityId, userIds } },
+  );
 
-  if (client.cache) ingestInCache(data)
+  if (client.cache) ingestInCache(data);
 
-  fireEvent('community.userRemoved', data)
+  fireEvent('community.userRemoved', 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/removeCommunityMembersRoles.ts

@@ -0,0 +1,42 @@
+import { getActiveClient } from '~/client/api';
+
+import { ingestInCache } from '~/cache/api/ingestInCache';
+
+/**
+ * ```js
+ * import { removeCommunityMembersRoles } from '@amityco/ts-sdk'
+ * const updated = await removeCommunityMembersRoles(communityId,  ['foo'], ['bar'])
+ * ```
+ *
+ * Removes a list of {@link Amity.Role} from 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 removed from list of {@link Amity.User} in the {@link Amity.Community}
+ *
+ * @category Community API
+ * @async
+ */
+export const removeCommunityMembersRoles = async (
+  communityId: Amity.Community['communityId'],
+  roleIds: Amity.Role['roleId'][],
+  userIds: Amity.User['userId'][],
+): Promise<boolean> => {
+  const client = getActiveClient();
+  client.log('community/removeCommunityMembersRoles', communityId, roleIds, userIds);
+
+  const { data } = await client.http.delete<Amity.CommunityMembershipPayload>(
+    `/api/v4/communities/${communityId}/users/roles`,
+    { data: { 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/updateCommunity.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,24 +20,28 @@ import { fireEvent } from '~/core/events'
  */
 export const updateCommunity = async (
   communityId: Amity.Community['communityId'],
-  patch: Patch<Amity.Community, 'displayName' | 'description' | 'avatarFileId' | 'tags' | 'metadata'>,
+  patch: Patch<
+    Amity.Community,
+    'displayName' | 'description' | 'avatarFileId' | 'tags' | 'metadata'
+  >,
 ): Promise<Amity.Cached<Amity.Community>> => {
-  const client = getActiveClient()
-  client.log('community/updateCommunity', communityId, patch)
+  const client = getActiveClient();
+  client.log('community/updateCommunity', communityId, patch);
 
   const { data } = await client.http.put<Amity.CommunityPayload>(
-    `/api/v3/communities/${communityId}`, patch,
-  )
+    `/api/v3/communities/${communityId}`,
+    patch,
+  );
 
-  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.updated', data)
+  fireEvent('community.updated', data);
 
-  const { communities } = data
+  const { communities } = data;
 
   return {
     data: communities.find(community => community.communityId === communityId)!,
     cachedAt,
-  }
-}
+  };
+};

package/src/community/events/index.ts

@@ -1,11 +1,11 @@
-export * from './onCommunityCreated'
-export * from './onCommunityUpdated'
-export * from './onCommunityDeleted'
+export * from './onCommunityCreated';
+export * from './onCommunityUpdated';
+export * from './onCommunityDeleted';
 
-export * from './onCommunityJoined'
-export * from './onCommunityLeft'
+export * from './onCommunityJoined';
+export * from './onCommunityLeft';
 
-export * from './onCommunityUserAdded'
-export * from './onCommunityUserRemoved'
-export * from './onCommunityUserBanned'
-export * from './onCommunityUserUnbanned'
+export * from './onCommunityUserAdded';
+export * from './onCommunityUserRemoved';
+export * from './onCommunityUserBanned';
+export * from './onCommunityUserUnbanned';

package/src/community/events/onCommunityCreated.ts

@@ -1,4 +1,4 @@
-import { createCommunityEventSubscriber } from './utils'
+import { createCommunityEventSubscriber } from './utils';
 
 /**
  * ```js
@@ -16,4 +16,4 @@ import { createCommunityEventSubscriber } from './utils'
  * @category Community Events
  */
 export const onCommunityCreated = (callback: Amity.Listener<Amity.Community>) =>
-  createCommunityEventSubscriber('community.created', callback)
+  createCommunityEventSubscriber('community.created', callback);

package/src/community/events/onCommunityDeleted.ts

@@ -1,4 +1,4 @@
-import { createCommunityEventSubscriber } from './utils'
+import { createCommunityEventSubscriber } from './utils';
 
 /**
  * ```js
@@ -16,4 +16,4 @@ import { createCommunityEventSubscriber } from './utils'
  * @category Community Events
  */
 export const onCommunityDeleted = (callback: Amity.Listener<Amity.Community>) =>
-  createCommunityEventSubscriber('community.deleted', callback)
+  createCommunityEventSubscriber('community.deleted', callback);

package/src/community/events/onCommunityJoined.ts

@@ -1,4 +1,4 @@
-import { createCommunityMemberEventSubscriber } from './utils'
+import { createCommunityMemberEventSubscriber } from './utils';
 
 /**
  * ```js
@@ -15,5 +15,6 @@ import { createCommunityMemberEventSubscriber } from './utils'
  *
  * @category Community Events
  */
-export const onCommunityJoined = (callback: (community: Amity.Community, member: Amity.Membership<'community'>) => void) =>
-  createCommunityMemberEventSubscriber('community.joined', callback)
+export const onCommunityJoined = (
+  callback: (community: Amity.Community, member: Amity.Membership<'community'>) => void,
+) => createCommunityMemberEventSubscriber('community.joined', callback);

package/src/community/events/onCommunityLeft.ts

@@ -1,4 +1,4 @@
-import { createCommunityMemberEventSubscriber } from './utils'
+import { createCommunityMemberEventSubscriber } from './utils';
 
 /**
  * ```js
@@ -15,5 +15,6 @@ import { createCommunityMemberEventSubscriber } from './utils'
  *
  * @category Community Events
  */
-export const onCommunityLeft = (callback: (community: Amity.Community, member: Amity.Membership<'community'>) => void) =>
-  createCommunityMemberEventSubscriber('community.left', callback)
+export const onCommunityLeft = (
+  callback: (community: Amity.Community, member: Amity.Membership<'community'>) => void,
+) => createCommunityMemberEventSubscriber('community.left', callback);

package/src/community/events/onCommunityUpdated.ts

@@ -1,4 +1,4 @@
-import { createCommunityEventSubscriber } from './utils'
+import { createCommunityEventSubscriber } from './utils';
 
 /**
  * ```js
@@ -16,4 +16,4 @@ import { createCommunityEventSubscriber } from './utils'
  * @category Community Events
  */
 export const onCommunityUpdated = (callback: Amity.Listener<Amity.Community>) =>
-  createCommunityEventSubscriber('community.updated', callback)
+  createCommunityEventSubscriber('community.updated', callback);

package/src/community/events/onCommunityUserAdded.ts

@@ -1,4 +1,4 @@
-import { createCommunityMemberEventSubscriber } from './utils'
+import { createCommunityMemberEventSubscriber } from './utils';
 
 /**
  * ```js
@@ -15,5 +15,6 @@ import { createCommunityMemberEventSubscriber } from './utils'
  *
  * @category Community Events
  */
-export const onCommunityUserAdded = (callback: (community: Amity.Community, member: Amity.Membership<'community'>) => void) =>
-  createCommunityMemberEventSubscriber('community.userAdded', callback)
+export const onCommunityUserAdded = (
+  callback: (community: Amity.Community, member: Amity.Membership<'community'>) => void,
+) => createCommunityMemberEventSubscriber('community.userAdded', callback);

package/src/community/events/onCommunityUserBanned.ts

@@ -1,4 +1,4 @@
-import { createCommunityMemberEventSubscriber } from './utils'
+import { createCommunityMemberEventSubscriber } from './utils';
 
 /**
  * ```js
@@ -15,5 +15,6 @@ import { createCommunityMemberEventSubscriber } from './utils'
  *
  * @category Community Events
  */
-export const onCommunityUserBanned = (callback: (community: Amity.Community, member: Amity.Membership<'community'>) => void) =>
-  createCommunityMemberEventSubscriber('community.userBanned', callback)
+export const onCommunityUserBanned = (
+  callback: (community: Amity.Community, member: Amity.Membership<'community'>) => void,
+) => createCommunityMemberEventSubscriber('community.userBanned', callback);

package/src/community/events/onCommunityUserRemoved.ts

@@ -1,4 +1,4 @@
-import { createCommunityMemberEventSubscriber } from './utils'
+import { createCommunityMemberEventSubscriber } from './utils';
 
 /**
  * ```js
@@ -15,5 +15,6 @@ import { createCommunityMemberEventSubscriber } from './utils'
  *
  * @category Community Events
  */
-export const onCommunityUserRemoved = (callback: (community: Amity.Community, member: Amity.Membership<'community'>) => void) =>
-  createCommunityMemberEventSubscriber('community.userRemoved', callback)
+export const onCommunityUserRemoved = (
+  callback: (community: Amity.Community, member: Amity.Membership<'community'>) => void,
+) => createCommunityMemberEventSubscriber('community.userRemoved', callback);

package/src/community/events/onCommunityUserUnbanned.ts

@@ -1,4 +1,4 @@
-import { createCommunityMemberEventSubscriber } from './utils'
+import { createCommunityMemberEventSubscriber } from './utils';
 
 /**
  * ```js
@@ -15,5 +15,6 @@ import { createCommunityMemberEventSubscriber } from './utils'
  *
  * @category Community Events
  */
-export const onCommunityUserUnbanned = (callback: (community: Amity.Community, member: Amity.Membership<'community'>) => void) =>
-  createCommunityMemberEventSubscriber('community.userUnbanned', callback)
+export const onCommunityUserUnbanned = (
+  callback: (community: Amity.Community, member: Amity.Membership<'community'>) => void,
+) => createCommunityMemberEventSubscriber('community.userUnbanned', callback);