@amityco/ts-sdk 0.0.1-beta.3 → 0.0.1-beta.31

package/src/channel/observers/tests/liveChannelMembers.test.ts

@@ -0,0 +1,207 @@
+import { disableCache, enableCache } from '~/cache/api';
+import {
+  client,
+  connectClient,
+  disconnectClient,
+  channelUser1,
+  channelUser4,
+  channelUserQueryResponse,
+  channelUserQueryResponsePage3,
+  channelUserQueryResponsePage2,
+  channel11,
+  pause,
+} from '~/utils/tests';
+import { liveChannelMembers } from '../liveChannelMembers';
+import { prepareChannelPayload } from '../../utils';
+
+const getSnapshot = () => {
+  return {
+    data: [] as Amity.Membership<'channel'>[],
+    loading: true,
+    error: undefined as any,
+  };
+};
+
+describe('liveChannelMembers', () => {
+  beforeAll(async () => {
+    await connectClient();
+  });
+
+  afterAll(async () => {
+    await disconnectClient();
+  });
+
+  beforeEach(enableCache);
+
+  afterEach(disableCache);
+
+  const { channelId } = channel11;
+
+  test('it should return channel members collection', async () => {
+    // mock response of queryChannels and validate
+    const callback = jest.fn();
+    client.http.get = jest.fn().mockResolvedValue(channelUserQueryResponse);
+
+    liveChannelMembers({ channelId }, callback);
+    await pause();
+
+    // check if cache data returned (should be empty)
+    expect(callback).toHaveBeenNthCalledWith(1, expect.objectContaining(getSnapshot()));
+
+    const snapshot = getSnapshot();
+    snapshot.data = channelUserQueryResponse.data.channelUsers;
+    snapshot.loading = false;
+
+    expect(callback).toHaveBeenNthCalledWith(2, expect.objectContaining(snapshot));
+  });
+
+  const filters: [string, Amity.ChannelMembersLiveCollection, Amity.Membership<'channel'>[]][] = [
+    [
+      'roles',
+      { channelId, roles: channelUserQueryResponsePage3.data.channelUsers[0].roles },
+      [channelUserQueryResponsePage3.data.channelUsers[0]],
+    ],
+    [
+      'searched term',
+      { channelId, search: 'use' },
+      [channelUserQueryResponsePage3.data.channelUsers[0]],
+    ],
+    [
+      'member',
+      { channelId, memberships: ['member'] },
+      [channelUserQueryResponsePage3.data.channelUsers[0]],
+    ],
+    [
+      'muted members',
+      { channelId, memberships: ['muted'] },
+      [channelUserQueryResponsePage3.data.channelUsers[1]],
+    ],
+    [
+      'banned members',
+      { channelId, memberships: ['banned'] },
+      [channelUserQueryResponsePage3.data.channelUsers[1]],
+    ],
+  ];
+
+  test.each(filters)('it should filter channelUsers by %s', async (filter, params, expected) => {
+    const callback = jest.fn();
+    client.http.get = jest.fn().mockResolvedValue(channelUserQueryResponsePage3);
+
+    liveChannelMembers(params, callback);
+    await pause();
+
+    const snapshot = getSnapshot();
+    // check if cache data returned (should be empty)
+    expect(callback).toHaveBeenNthCalledWith(1, expect.objectContaining(snapshot));
+
+    snapshot.loading = false;
+    snapshot.data = expected;
+
+    expect(callback).toHaveBeenNthCalledWith(2, expect.objectContaining(snapshot));
+  });
+
+  test('it should return method to fetch next page', async () => {
+    const callback = jest.fn();
+    client.http.get = jest
+      .fn()
+      .mockResolvedValue(channelUserQueryResponse)
+      .mockResolvedValueOnce(channelUserQueryResponsePage2);
+
+    liveChannelMembers({ channelId }, callback);
+    await pause();
+
+    expect(callback).toHaveBeenCalled();
+    expect(callback.mock.lastCall).toHaveLength(1);
+
+    const { onNextPage, hasNextPage } = callback.mock.lastCall[0];
+
+    expect(hasNextPage).toBe(true);
+    expect(onNextPage).toBeTruthy();
+
+    onNextPage();
+    await pause();
+
+    const payload = prepareChannelPayload(channelUserQueryResponse.data);
+    const payload2 = prepareChannelPayload(channelUserQueryResponsePage2.data);
+
+    const snapshot = getSnapshot();
+    snapshot.loading = false;
+    snapshot.data = [...payload2.channelUsers, ...payload.channelUsers];
+
+    expect(callback).toHaveBeenNthCalledWith(4, expect.objectContaining(snapshot));
+  });
+
+  const events: [string, keyof Amity.Events, Amity.Membership<'channel'>][] = [
+    [
+      'it should add new member to collection onMemberAdded',
+      'v3.channel.didAddUsers',
+      channelUser4,
+    ],
+    [
+      'it should remove channel memeber from collection onMemberRemoved',
+      'v3.channel.didRemoveUsers',
+      channelUser1,
+    ],
+    [
+      'it should update channel memeber membership on onChannelMemberBanned',
+      'v3.channel.didBan',
+      { ...channelUser1, membership: 'banned', isBanned: true },
+    ],
+    [
+      'it should update channel memeber membership on onChannelMemberUnbanned',
+      'v3.channel.didUnban',
+      { ...channelUser1, membership: 'none', isBanned: false },
+    ],
+  ];
+
+  test.each(events)('%s', async (test, event, channelUser) => {
+    const snapshot = getSnapshot();
+
+    const callback = jest.fn();
+    client.http.get = jest.fn().mockResolvedValue(channelUserQueryResponse);
+
+    liveChannelMembers({ channelId }, callback);
+    await pause();
+
+    client.emitter.emit(event, {
+      channels: [channel11],
+      channelUsers: [channelUser],
+      users: [],
+      files: [],
+    });
+
+    const payload = prepareChannelPayload(channelUserQueryResponse.data);
+
+    snapshot.loading = false;
+    // get data based on event
+    switch (event) {
+      case 'v3.channel.didAddUsers':
+        snapshot.data = [channelUser, ...payload.channelUsers];
+        break;
+
+      case 'v3.channel.didBan': {
+        const bannedUserIdx = payload.channelUsers.findIndex(u => u.userId === channelUser.userId);
+        payload.channelUsers[bannedUserIdx] = channelUser;
+
+        snapshot.data = payload.channelUsers;
+        break;
+      }
+
+      case 'v3.channel.didUnban': {
+        const unbannedUserIdx = payload.channelUsers.findIndex(
+          u => u.userId === channelUser.userId,
+        );
+        payload.channelUsers[unbannedUserIdx] = channelUser;
+
+        snapshot.data = payload.channelUsers;
+        break;
+      }
+
+      default:
+        // delete payload
+        snapshot.data = payload.channelUsers.filter(u => u.userId !== channelUser.userId);
+    }
+
+    expect(callback).toHaveBeenNthCalledWith(3, expect.objectContaining(snapshot));
+  });
+});

package/src/channel/observers/tests/liveChannels.test.ts

@@ -0,0 +1,211 @@
+import { disableCache, enableCache, pushToCache } from '~/cache/api';
+import { getResolver } from '~/core/model';
+
+import { liveChannels } from '../liveChannels';
+import { queryChannels } from '~/channel/api';
+import { prepareChannelPayload } from '../../utils/prepareChannelPayload';
+
+import {
+  client,
+  pause,
+  connectClient,
+  disconnectClient,
+  channel11,
+  channelUser1,
+  channelQueryResponse,
+  channelQueryResponsePage2,
+} from '~/utils/tests';
+
+const getSnapshot = () => {
+  return {
+    data: [] as Amity.Channel[],
+    loading: true,
+    error: undefined as any,
+  };
+};
+
+describe('liveChannels', () => {
+  beforeAll(async () => {
+    await connectClient();
+  });
+
+  afterAll(async () => {
+    await disconnectClient();
+  });
+
+  beforeEach(enableCache);
+
+  afterEach(disableCache);
+
+  test('it should return channel collection', async () => {
+    // mock response of queryChannels and validate
+    const callback = jest.fn();
+    client.http.get = jest.fn().mockResolvedValue(channelQueryResponse);
+
+    liveChannels({}, callback);
+
+    expect(callback).toHaveBeenCalledTimes(1);
+
+    const snapshot = getSnapshot();
+
+    // check if cache data returned (should be empty)
+    expect(callback).toHaveBeenCalledWith(expect.objectContaining(snapshot));
+
+    await pause();
+
+    expect(callback).toHaveBeenCalledTimes(2);
+
+    // cause we apply prepareChannelPayload on channel raw data from server
+    const payload = prepareChannelPayload(channelQueryResponse.data);
+
+    snapshot.data = payload.channels;
+    snapshot.loading = false;
+
+    expect(callback).toHaveBeenCalledWith(expect.objectContaining(snapshot));
+  });
+
+  // table for channel filters
+  const filters: [string, Amity.ChannelLiveCollection, number?][] = [
+    ['deleted', { isDeleted: false }],
+    ['tagged', { tags: ['tag2'] }],
+    ['out excluded tags', { excludeTags: ['tag1'] }],
+    ['member', { membership: 'member' }],
+    ['not member', { membership: 'notMember' }, 1],
+    ['all membership', { membership: 'all' }],
+  ];
+
+  test.each(filters)(
+    'it should filter by %s channels',
+    async (filter, params, expectedChannelIdx = 0) => {
+      const callback = jest.fn();
+      client.http.get = jest.fn().mockResolvedValue(channelQueryResponse);
+
+      const payload = prepareChannelPayload(channelQueryResponse.data);
+      let snapshotData = [payload.channels[expectedChannelIdx]];
+
+      // add channel users to cache for testing membership filter
+      if (params.membership) {
+        pushToCache(
+          [
+            'channelUsers',
+            'get',
+            getResolver('channelUsers')({
+              channelId: channelQueryResponse.data.channels[0].channelId,
+              userId: channelUser1.userId,
+            }),
+          ],
+          channelUser1,
+        );
+
+        if (params.membership === 'all') {
+          snapshotData = payload.channels;
+        }
+      }
+
+      liveChannels(params, callback);
+
+      expect(callback).toHaveBeenCalledTimes(1);
+
+      const snapshot = getSnapshot();
+      // check if cache data returned (should be empty)
+      expect(callback).toHaveBeenCalledWith(expect.objectContaining(snapshot));
+
+      await pause();
+
+      expect(callback).toHaveBeenCalledTimes(2);
+
+      snapshot.loading = false;
+      snapshot.data = snapshotData;
+
+      expect(callback).toHaveBeenCalledWith(expect.objectContaining(snapshot));
+    },
+  );
+
+  test('it should return method to fetch next page', async () => {
+    const callback = jest.fn();
+    client.http.get = jest
+      .fn()
+      .mockResolvedValue(channelQueryResponse)
+      .mockResolvedValueOnce(channelQueryResponsePage2);
+
+    liveChannels({}, callback);
+
+    expect(callback).toHaveBeenCalled();
+
+    await pause();
+
+    expect(callback.mock.lastCall).toHaveLength(1);
+
+    const { onNextPage, hasNextPage } = callback.mock.lastCall[0];
+
+    expect(hasNextPage).toBe(true);
+    expect(onNextPage).toBeTruthy();
+
+    onNextPage();
+
+    await pause();
+
+    // 4 -> becuase 1 local & server call each per call (2)
+    expect(callback).toHaveBeenCalledTimes(4);
+
+    const payload = prepareChannelPayload(channelQueryResponse.data);
+    const payload2 = prepareChannelPayload(channelQueryResponsePage2.data);
+
+    const snapshot = getSnapshot();
+    snapshot.loading = false;
+    snapshot.data = [...payload2.channels, ...payload.channels];
+
+    expect(callback).toHaveBeenNthCalledWith(4, expect.objectContaining(snapshot));
+  });
+
+  const events: [string, keyof Amity.Events, Amity.Channel][] = [
+    [
+      'it should add new channel to collection onCreate',
+      'v3.channel.didCreate',
+      { ...channel11, channelId: 'new-channel-id' },
+    ],
+    ['it should edit channel in collection onUpdate', 'v3.channel.didUpdate', channel11],
+    ['it should remove channel from collection onDelete', 'v3.channel.didDelete', channel11],
+  ];
+
+  test.each(events)('%s', async (test, event, channel) => {
+    const snapshot = getSnapshot();
+
+    const callback = jest.fn();
+    client.http.get = jest.fn().mockResolvedValue(channelQueryResponse);
+
+    liveChannels({}, callback);
+
+    await pause();
+    expect(callback).toHaveBeenCalledTimes(2);
+
+    client.emitter.emit(event, {
+      channels: [channel],
+      channelUsers: [channelUser1],
+      users: [],
+      files: [],
+    });
+
+    const payload = prepareChannelPayload(channelQueryResponse.data);
+    const deletePayload = payload.channels.filter(
+      channel => channel.channelId !== channel11.channelId,
+    );
+
+    snapshot.loading = false;
+    // get data based on event
+    switch (event) {
+      case 'v3.channel.didCreate':
+        snapshot.data = [channel, ...payload.channels];
+        break;
+
+      case 'v3.channel.didUpdate':
+        snapshot.data = payload.channels;
+        break;
+
+      default:
+        snapshot.data = deletePayload;
+    }
+
+    expect(callback).toHaveBeenNthCalledWith(3, expect.objectContaining(snapshot));
+  });
+});

package/src/channel/utils/index.ts

@@ -0,0 +1 @@
+export * from './prepareChannelPayload';

package/src/channel/utils/prepareChannelPayload.ts

@@ -0,0 +1,31 @@
+import { getActiveClient } from '~/client/api';
+
+/** @hidden */
+export const prepareChannelPayload = (
+  payload: Amity.ChannelPayload,
+): Amity.ChannelPayload<any, Amity.Channel> => {
+  const client = getActiveClient();
+
+  const channels: Amity.Channel[] = payload.channels.map(channel => {
+    const channelUser = payload.channelUsers.find(
+      channelUser =>
+        channelUser.userId === client.userId && channel.channelId === channelUser.channelId,
+    )!;
+
+    const hasMention = channelUser
+      ? channelUser.readToSegment < channelUser.lastMentionedSegment
+      : false;
+    const unreadCount =
+      channelUser && channelUser.membership === 'member' && channel.messageCount
+        ? Math.max(0, channel.messageCount - channelUser.readToSegment)
+        : 0;
+
+    return {
+      ...channel,
+      hasMention,
+      unreadCount,
+    };
+  });
+
+  return { ...payload, channels };
+};

package/src/channel/utils/tests/prepareChannelPayload.test.ts

@@ -0,0 +1,120 @@
+import {
+  connectClient,
+  disconnectClient,
+  channel11,
+  channel12,
+  channelRaw1,
+  channelRaw2,
+  channelUser1,
+  channelUser2,
+} from '~/utils/tests';
+
+import { prepareChannelPayload } from '../prepareChannelPayload';
+
+beforeAll(async () => {
+  await connectClient();
+});
+
+afterAll(async () => {
+  await disconnectClient();
+});
+
+const responseSchema = {
+  channels: [],
+  channelUsers: [],
+  files: [],
+  users: [],
+};
+
+const tests = [
+  {
+    id: 1,
+    desc: 'hasMention: false, unreadCount: 0, if channelUsers is empty',
+    before: {
+      ...responseSchema,
+      channels: [channelRaw1],
+    },
+    after: {
+      ...responseSchema,
+      channels: [channel11],
+    },
+  },
+  {
+    id: 2,
+    desc: 'hasMention: false, if channelUser.readToSegment >= channelUser.lastMentionedSegment',
+    before: {
+      ...responseSchema,
+      channels: [channelRaw1],
+      channelUsers: [channelUser1],
+    },
+    after: {
+      ...responseSchema,
+      channels: [channel11],
+      channelUsers: [channelUser1],
+    },
+  },
+  {
+    id: 3,
+    desc: 'unreadCount: 0, if channelUser.readToSegment = channel.messageCount',
+    before: {
+      ...responseSchema,
+      channels: [channelRaw1],
+      channelUsers: [channelUser1],
+    },
+    after: {
+      ...responseSchema,
+      channels: [channel11],
+      channelUsers: [channelUser1],
+    },
+  },
+  {
+    id: 4,
+    desc: 'hasMention: true, if channelUser.readToSegment < channelUser.lastMentionedSegment',
+    before: {
+      ...responseSchema,
+      channels: [channelRaw2],
+      channelUsers: [channelUser2],
+    },
+    after: {
+      ...responseSchema,
+      channels: [channel12],
+      channelUsers: [channelUser2],
+    },
+  },
+  {
+    id: 5,
+    desc: 'unreadCount: > 0, if channelUser.readToSegment < channel.messageCount',
+    before: {
+      ...responseSchema,
+      channels: [channelRaw2],
+      channelUsers: [channelUser2],
+    },
+    after: {
+      ...responseSchema,
+      channels: [channel12],
+      channelUsers: [channelUser2],
+    },
+  },
+  {
+    id: 4,
+    desc: 'hasMention: true, unreadCount: > 0, if 4 / 5 ',
+    before: {
+      ...responseSchema,
+      channels: [channelRaw2],
+      channelUsers: [channelUser2],
+    },
+    after: {
+      ...responseSchema,
+      channels: [channel12],
+      channelUsers: [channelUser2],
+    },
+  },
+];
+
+describe('channel/utils/prepareChannelPayload', () => {
+  tests.forEach(({ id, desc, before, after }) => {
+    test(`${id} - ${desc}`, () => {
+      expect(prepareChannelPayload(before)).toEqual(after);
+    });
+  });
+});

package/src/client/api/activeClient.ts

@@ -1,6 +1,6 @@
-import { ASCError } from '~/core/errors'
+import { ASCError } from '~/core/errors';
 
-let activeClient: Amity.Client | null = null
+let activeClient: Amity.Client | null = null;
 
 /**
  * Get the active client
@@ -15,11 +15,11 @@ export const getActiveClient = () => {
       'There is no active client',
       Amity.ClientError.UNKNOWN_ERROR,
       Amity.ErrorLevel.FATAL,
-    )
+    );
   }
 
-  return activeClient!
-}
+  return activeClient!;
+};
 
 /**
  * Sets the active client
@@ -29,5 +29,5 @@ export const getActiveClient = () => {
  * @hidden
  */
 export const setActiveClient = (client: Amity.Client) => {
-  activeClient = client
-}
+  activeClient = client;
+};

package/src/client/api/activeUser.ts

@@ -0,0 +1,26 @@
+import { ASCError } from '~/core/errors';
+
+let activeUser: Pick<Amity.User, '_id' | 'userId' | 'path'> | null = null;
+
+/**
+ * for internal use
+ */
+export const getActiveUser = () => {
+  if (!activeUser) {
+    throw new ASCError(
+      'Connect client first',
+      Amity.ClientError.UNKNOWN_ERROR,
+      Amity.ErrorLevel.FATAL,
+    );
+  }
+
+  return activeUser!;
+};
+
+export const setActiveUser = (user: Amity.User) => {
+  activeUser = {
+    _id: user._id,
+    userId: user.userId,
+    path: user.path,
+  };
+};