@amityco/ts-sdk 0.0.1-cb052d5.0 → 0.0.1-cbf10e4.0

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

@@ -0,0 +1,232 @@
+import { disableCache, enableCache } from '~/cache/api';
+import { prepareMembershipPayload } from '~/group/utils';
+import {
+  client,
+  connectClient,
+  disconnectClient,
+  channelUser1,
+  channelUser7,
+  channelUserQueryResponse,
+  channelUserQueryResponsePage3,
+  channelUserQueryResponsePage2,
+  channel11,
+  pause,
+  user11,
+  user14,
+  channelUserModel3,
+  channelUserModel,
+} from '~/utils/tests';
+import { liveChannelMembers } from '../liveChannelMembers';
+import { prepareChannelPayload } from '../../utils';
+
+const getSnapshot = (params?: Record<string, any>) => {
+  return {
+    data: [] as Amity.MembershipRaw<'channel'>[],
+    loading: true,
+    error: undefined as any,
+    ...params,
+  };
+};
+
+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 = channelUserModel;
+    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 },
+      [channelUserModel3[0]],
+    ],
+    ['searched term', { channelId, search: 'use' }, [channelUserModel3[0]]],
+    ['member', { channelId, memberships: ['member'] }, [channelUserModel3[0]]],
+    ['muted members', { channelId, memberships: ['muted'] }, [channelUserModel3[1]]],
+    ['banned members', { channelId, memberships: ['banned'] }, [channelUserModel3[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 = prepareMembershipPayload(
+      prepareChannelPayload(channelUserQueryResponse.data),
+      'channelUsers',
+    );
+
+    const payload2 = prepareMembershipPayload(
+      prepareChannelPayload(channelUserQueryResponsePage2.data),
+      'channelUsers',
+    );
+
+    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.MembershipRaw<'channel'>, Amity.User][] = [
+    [
+      'it should add new member to collection onMemberAdded',
+      'channel.membersAdded',
+      channelUser7,
+      user14,
+    ],
+    [
+      'it should remove channel member from collection onMemberRemoved',
+      'channel.membersRemoved',
+      channelUser1,
+      user11,
+    ],
+    [
+      'it should update channel memeber membership on onChannelMemberBanned',
+      'channel.banned',
+      { ...channelUser1, membership: 'banned', isBanned: true },
+      user11,
+    ],
+    [
+      'it should update channel memeber membership on onChannelMemberUnbanned',
+      'channel.unbanned',
+      { ...channelUser1, membership: 'none', isBanned: false },
+      user11,
+    ],
+    [
+      'it should update channel memeber `readToSegment` on onMemberRead',
+      'v3.channel.didMarkSeen',
+      { ...channelUser1, readToSegment: channelUser1.readToSegment + 1 },
+      user11,
+    ],
+  ];
+
+  test.each(events)('%s', async (test, event, channelUser, user) => {
+    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: [user],
+      files: [],
+    });
+
+    const channelUserModel = { ...channelUser, user };
+
+    const payload = prepareMembershipPayload(
+      prepareChannelPayload(channelUserQueryResponse.data),
+      'channelUsers',
+    );
+
+    snapshot.loading = false;
+
+    // get data based on event
+    switch (event) {
+      case 'channel.membersAdded':
+        snapshot.data = [channelUserModel, ...payload.channelUsers];
+        break;
+
+      case 'channel.banned': {
+        const bannedUserIdx = payload.channelUsers.findIndex(
+          u => u.userId === channelUserModel.userId,
+        );
+        payload.channelUsers[bannedUserIdx] = channelUserModel;
+
+        snapshot.data = payload.channelUsers;
+        break;
+      }
+
+      case 'channel.unbanned': {
+        const unbannedUserIdx = payload.channelUsers.findIndex(
+          u => u.userId === channelUserModel.userId,
+        );
+        payload.channelUsers[unbannedUserIdx] = channelUserModel;
+
+        snapshot.data = payload.channelUsers;
+        break;
+      }
+
+      case 'v3.channel.didMarkSeen': {
+        const readUserIdx = payload.channelUsers.findIndex(
+          u => u.userId === channelUserModel.userId,
+        );
+        payload.channelUsers[readUserIdx] = channelUserModel;
+
+        snapshot.data = payload.channelUsers;
+        break;
+      }
+
+      default:
+        // delete payload
+        snapshot.data = payload.channelUsers.filter(u => u.userId !== channelUserModel.userId);
+    }
+
+    expect(callback).toHaveBeenNthCalledWith(3, expect.objectContaining(snapshot));
+  });
+});

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

@@ -0,0 +1,261 @@
+import { disableCache, enableCache, pushToCache } from '~/cache/api';
+import { getResolver } from '~/core/model';
+import {
+  client,
+  pause,
+  connectClient,
+  disconnectClient,
+  channel11,
+  channelUser1,
+  channelQueryResponse,
+  channelQueryResponsePage2,
+} from '~/utils/tests';
+import { liveChannels } from '../liveChannels';
+import { prepareChannelPayload } from '../../utils/prepareChannelPayload';
+
+const getSnapshot = (params?: Record<string, any>) => {
+  return {
+    data: [] as Amity.Channel[],
+    loading: true,
+    error: undefined as any,
+    ...params,
+  };
+};
+
+describe('liveChannels', () => {
+  beforeAll(async () => {
+    await connectClient();
+  });
+
+  afterAll(async () => {
+    await disconnectClient();
+  });
+
+  beforeEach(enableCache);
+
+  afterEach(disableCache);
+
+  test('it should return channel collection', async () => {
+    const callback = jest.fn();
+    client.http.get = jest.fn().mockResolvedValue(channelQueryResponse);
+
+    liveChannels({}, callback);
+    await pause();
+
+    expect(callback).toHaveBeenCalledTimes(2);
+    expect(callback).toHaveBeenNthCalledWith(1, expect.objectContaining(getSnapshot()));
+    expect(callback).toHaveBeenNthCalledWith(
+      2,
+      expect.objectContaining(
+        getSnapshot({
+          data: prepareChannelPayload(channelQueryResponse.data).channels,
+          loading: false,
+        }),
+      ),
+    );
+  });
+
+  test('it should return data from cache', async () => {
+    const callback = jest.fn();
+    client.http.get = jest.fn().mockResolvedValue(channelQueryResponse);
+
+    liveChannels({}, () => undefined);
+    await pause();
+    liveChannels({}, callback);
+    await pause();
+
+    expect(callback).toHaveBeenCalledTimes(2);
+    expect(callback).toHaveBeenNthCalledWith(
+      1,
+      expect.objectContaining(
+        getSnapshot({
+          data: prepareChannelPayload(channelQueryResponse.data).channels,
+        }),
+      ),
+    );
+    expect(callback).toHaveBeenNthCalledWith(
+      2,
+      expect.objectContaining(
+        getSnapshot({
+          data: prepareChannelPayload(channelQueryResponse.data).channels,
+          loading: false,
+        }),
+      ),
+    );
+  });
+
+  // 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);
+    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();
+
+    // 4 -> because 1 local & server call each per call (2)
+    expect(callback).toHaveBeenCalledTimes(4);
+    expect(callback).toHaveBeenNthCalledWith(
+      4,
+      expect.objectContaining(
+        getSnapshot({
+          loading: false,
+          data: [
+            ...prepareChannelPayload(channelQueryResponsePage2.data).channels,
+            ...prepareChannelPayload(channelQueryResponse.data).channels,
+          ],
+        }),
+      ),
+    );
+  });
+
+  describe('events', () => {
+    const newChannel = { ...channel11, channelId: 'new-channel-id' };
+    const payload = prepareChannelPayload(channelQueryResponse.data);
+
+    const cases: [string, keyof Amity.Events, Amity.Channel, Amity.Channel[]][] = [
+      [
+        'it should add new channel to collection onCreate',
+        'channel.created',
+        newChannel,
+        [newChannel, ...payload.channels],
+      ],
+      [
+        'it should update channel in collection onUpdate',
+        'channel.updated',
+        channel11,
+        payload.channels,
+      ],
+      [
+        'it should update channel in collection onMuted',
+        'channel.setMuted',
+        channel11,
+        payload.channels,
+      ],
+      [
+        'it should remove channel from collection onDelete',
+        'channel.deleted',
+        channel11,
+        payload.channels.filter(channel => channel.channelId !== channel11.channelId),
+      ],
+    ];
+
+    type testHandlerType = (...args: typeof cases[number]) => Promise<void>;
+    const testHandler: testHandlerType = async (test, event, channel, expected) => {
+      const callback = jest.fn();
+      client.http.get = jest.fn().mockResolvedValue(channelQueryResponse);
+
+      liveChannels({}, callback);
+      await pause();
+      client.emitter.emit(event, {
+        channels: [channel],
+        channelUsers: [channelUser1],
+        users: [],
+        files: [],
+      });
+      await pause();
+
+      expect(callback).toHaveBeenNthCalledWith(
+        3,
+        expect.objectContaining(
+          getSnapshot({
+            data: expected,
+            loading: false,
+          }),
+        ),
+      );
+    };
+
+    test.each(cases)('%s', testHandler);
+
+    test('should update channel `unreadCount` onChannelMemberRead', async () => {
+      const callback = jest.fn();
+      client.http.get = jest.fn().mockResolvedValue({
+        data: {
+          ...channelQueryResponse.data,
+          channelUsers: [{ ...channelUser1, readToSegment: 0 }],
+        },
+      });
+
+      liveChannels({}, callback);
+      await pause();
+      client.emitter.emit('v3.channel.didMarkSeen', {
+        ...channelQueryResponse.data,
+        channelUsers: [{ ...channelUser1, readToSegment: 1 }],
+      });
+      await pause();
+
+      expect(callback.mock.calls[1][0].data[0] as Amity.Channel).toMatchObject({ unreadCount: 1 });
+      expect(callback.mock.calls[2][0].data[0] as Amity.Channel).toMatchObject({ unreadCount: 0 });
+    });
+  });
+});

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);
+    });
+  });
+});