@amityco/ts-sdk 0.0.1-003998f.0

package/src/user/observers/observeUser.ts

@@ -0,0 +1,70 @@
+import { createQuery, runQuery } from '~/core/query/query';
+
+import { getActiveClient } from '~/client/api';
+
+import { getUser } from '../api';
+import {
+  onUserUpdated,
+  onUserDeleted,
+  onUserFlagged,
+  onUserUnflagged,
+  onUserFlagCleared,
+} from '../events';
+
+/**
+ * ```js
+ * import { observeUser } from '@amityco/ts-sdk'
+ *
+ * let user = {}
+ * const dispose = observeUser(userId, updated => user = updated)
+ * ```
+ *
+ * @param userId the ID of the user to observe
+ * @param callback the function to call when new data are available
+ * @returns An {@link Amity.Unsubscriber} function to run when willing to stop observing the user
+ *
+ * Observe all mutation on a given {@link Amity.User}
+ * @category User Observer
+ */
+export const observeUser = <
+  Events extends ['onFetch', 'onUpdate', 'onDelete', 'onFlagged', 'onUnflagged', 'onFlagCleared'],
+>(
+  userId: string,
+  callback: Amity.ObjectListener<Amity.Snapshot<Amity.User>, Events>,
+): Amity.Unsubscriber => {
+  const { log } = getActiveClient();
+
+  const timestamp = Date.now();
+  log(`observeUser(tmpid: ${timestamp}) > listen`);
+
+  console.log('observeUser will be deprecated on 25th November 2022, please use liveUser instead.');
+
+  // wrapper function to make sure
+  const router = (result: Amity.Snapshot<Amity.User>, action: Events[number]) => {
+    // filter function
+    if (result.data?.userId !== userId) return;
+
+    if (callback instanceof Function) return callback(result);
+
+    if (action !== 'onFetch') callback.onEvent?.(action, result);
+
+    callback[action]?.(result);
+  };
+
+  const disposers: Amity.Unsubscriber[] = [];
+
+  disposers.push(
+    onUserUpdated(data => router({ data, loading: false, origin: 'event' }, 'onUpdate')),
+    onUserDeleted(data => router({ data, loading: false, origin: 'event' }, 'onDelete')),
+    onUserFlagged(data => router({ data, loading: false, origin: 'event' }, 'onFlagged')),
+    onUserUnflagged(data => router({ data, loading: false, origin: 'event' }, 'onUnflagged')),
+    onUserFlagCleared(data => router({ data, loading: false, origin: 'event' }, 'onFlagCleared')),
+  );
+
+  runQuery(createQuery(getUser, userId), result => result.data && router(result, 'onFetch'));
+
+  return () => {
+    log(`observeUser(tmpid: ${timestamp}) > dispose`);
+    disposers.forEach(fn => fn());
+  };
+};

package/src/user/tests/api/getUser.test.ts

@@ -0,0 +1,112 @@
+import { ASCApiError } from '~/core/errors';
+import { disableCache, enableCache, pushToCache } from '~/cache/api';
+import { client, user11 } from '~/utils/tests';
+
+import { pushToTombstone } from '~/cache/api/pushToTombstone';
+import { isInTombstone } from '~/cache/api/isInTombstone';
+
+import { getUser } from '../../api/getUser';
+
+const user = user11;
+const getResolvedUserValue = () => ({
+  data: {
+    users: [user],
+    files: [],
+  },
+});
+
+describe('getUser', () => {
+  test('should return user data', async () => {
+    client.http.get = jest.fn().mockResolvedValue(getResolvedUserValue());
+
+    const { data } = await getUser(user.userId);
+
+    expect(data).toStrictEqual(user);
+  });
+
+  test('it should update cache after fetch from server', async () => {
+    enableCache();
+    client.http.get = jest.fn().mockResolvedValue(getResolvedUserValue());
+    await getUser(user.userId);
+
+    expect(getUser.locally(user.userId)).toBeDefined();
+
+    disableCache();
+  });
+
+  test('should return an error', async () => {
+    client.http.get = jest.fn().mockRejectedValueOnce(new Error('error'));
+
+    await expect(getUser(user.userId)).rejects.toThrow('error');
+  });
+
+  test('should return an error if user in cache but api throws not found', async () => {
+    enableCache();
+    pushToCache(['user', 'get', user.userId], user, { cachedAt: Date.now() });
+
+    client.http.get = jest
+
+      .fn()
+      .mockRejectedValueOnce(
+        new ASCApiError('not found!', Amity.ServerError.ITEM_NOT_FOUND, Amity.ErrorLevel.ERROR),
+      );
+
+    await expect(getUser(user.userId)).rejects.toThrow();
+
+    expect(getUser.locally(user.userId)).toBeUndefined();
+    disableCache();
+  });
+});
+
+describe('getUser locally', () => {
+  test('should return data from cache', () => {
+    enableCache();
+
+    const cachedAt = Date.now();
+
+    pushToCache(['user', 'get', user.userId], user, { cachedAt });
+
+    const data = getUser.locally(user.userId);
+
+    expect(data).toBeDefined();
+    expect(data?.data).toEqual(user);
+    expect(data?.cachedAt).toEqual(cachedAt);
+
+    disableCache();
+  });
+
+  test('should return undefined if user not in cache', () => {
+    expect(getUser.locally('non-existent-user')).toBeUndefined();
+  });
+
+  test('should return undefined if cache not enabled', () => {
+    expect(getUser.locally(user.userId)).toBeUndefined();
+  });
+});
+
+describe('getUser tombostone', () => {
+  test('it should add user to tombostone if 404', async () => {
+    enableCache();
+    client.http.get = jest
+      .fn()
+      .mockRejectedValueOnce(
+        new ASCApiError('not found!', Amity.ServerError.ITEM_NOT_FOUND, Amity.ErrorLevel.ERROR),
+      );
+
+    await expect(getUser(user.userId)).rejects.toThrow();
+    expect(() => {
+      isInTombstone('user', user.userId);
+    }).toThrow();
+
+    disableCache();
+  });
+
+  test('it should throw error if user not found in tombostone', async () => {
+    enableCache();
+
+    pushToTombstone('user', user.userId);
+    await expect(getUser(user.userId)).rejects.toThrow();
+
+    disableCache();
+  });
+});

package/src/user/tests/observers/liveUser.test.ts

@@ -0,0 +1,224 @@
+import { ASCApiError } from '~/core/errors';
+import { disableCache, enableCache } from '~/cache/api';
+import { LIVE_OBJECT_ENABLE_CACHE_MESSAGE } from '~/utils/constants';
+
+import { liveUser } from '../../observers/liveUser';
+
+import {
+  pause,
+  client,
+  connectClient,
+  disconnectClient,
+  userQueryResponse,
+  user11 as defaultUser,
+} from '~/utils/tests';
+
+const getSnapshot = () => {
+  return {
+    loading: true,
+    error: undefined as any,
+    data: undefined as undefined | Amity.User,
+  };
+};
+
+describe('liveUser', () => {
+  beforeAll(async () => {
+    await connectClient();
+  });
+
+  afterAll(async () => {
+    await disconnectClient();
+  });
+
+  beforeEach(async () => {
+    enableCache();
+  });
+
+  afterEach(disableCache);
+
+  test('it should show user if cache not enabled', () => {
+    /*
+     * NOTE: at the time of writing this test cache is diabled by default, but
+     * there is a proposal to enable cache by default. So I'm disabling cache
+     * here to ensure cache is disabled
+     */
+    disableCache();
+
+    const callback = jest.fn();
+    jest.spyOn(global.console, 'log');
+    client.http.get = jest.fn();
+
+    // call liveUser check if mocked console get's called with the correct
+    // user
+    client.use();
+    liveUser(defaultUser.userId, callback);
+
+    expect(console.log).toBeCalledWith(LIVE_OBJECT_ENABLE_CACHE_MESSAGE);
+  });
+
+  test('it should return user live object', async () => {
+    const snapshot = getSnapshot();
+
+    // mock response of queryUsers and validate
+    const callback = jest.fn();
+    client.http.get = jest.fn().mockResolvedValue(userQueryResponse);
+
+    liveUser(defaultUser.userId, callback);
+
+    expect(callback).toHaveBeenCalledTimes(1);
+
+    // 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 = defaultUser;
+
+    expect(callback).toHaveBeenCalledWith(expect.objectContaining(snapshot));
+  });
+
+  test('it should return error on api failure', async () => {
+    const snapshot = getSnapshot();
+    const error = new ASCApiError(
+      'server error!',
+      Amity.ServerError.ITEM_NOT_FOUND,
+      Amity.ErrorLevel.ERROR,
+    );
+
+    // mock response of queryUsers and validate
+    const callback = jest.fn();
+    client.http.get = jest.fn().mockRejectedValue(error);
+
+    liveUser(defaultUser.userId, callback);
+
+    expect(callback).toHaveBeenCalledTimes(1);
+
+    // check if cache data returned (should be empty)
+    expect(callback).toHaveBeenCalledWith(expect.objectContaining(snapshot));
+
+    await pause();
+
+    expect(callback).toHaveBeenCalledTimes(2);
+
+    snapshot.error = error;
+    snapshot.loading = false;
+    expect(callback).toHaveBeenLastCalledWith(expect.objectContaining(snapshot));
+  });
+
+  test('it should terminate updates on api failure', async () => {
+    const snapshot = getSnapshot();
+    const error = new ASCApiError(
+      'server error!',
+      Amity.ServerError.ITEM_NOT_FOUND,
+      Amity.ErrorLevel.ERROR,
+    );
+
+    // mock response of queryUsers and validate
+    const callback = jest.fn();
+    client.http.get = jest.fn().mockRejectedValue(error);
+
+    liveUser(defaultUser.userId, callback);
+
+    expect(callback).toHaveBeenCalledTimes(1);
+
+    // check if cache data returned (should be empty)
+    expect(callback).toHaveBeenCalledWith(expect.objectContaining(snapshot));
+
+    await pause();
+
+    expect(callback).toHaveBeenCalledTimes(2);
+
+    snapshot.error = error;
+    snapshot.loading = false;
+    expect(callback).toHaveBeenLastCalledWith(expect.objectContaining(snapshot));
+
+    const updatedAt = new Date(defaultUser?.updatedAt ?? new Date());
+    updatedAt.setDate(updatedAt.getDate() + 7);
+
+    const updatedUser = {
+      ...defaultUser,
+      updatedAt: updatedAt.toISOString(),
+    };
+    client.emitter.emit('user.updated', { users: [updatedUser], files: [] });
+
+    delete snapshot.error;
+    snapshot.loading = false;
+    snapshot.data = updatedUser;
+    expect(callback).not.toHaveBeenNthCalledWith(3, expect.objectContaining(snapshot));
+  });
+
+  test('it should not return updates on obtain once!', async () => {
+    const snapshot = getSnapshot();
+
+    // mock response of queryUsers and validate
+    const callback = jest.fn();
+    client.http.get = jest.fn().mockResolvedValue(userQueryResponse);
+
+    const unsub = liveUser(defaultUser.userId, callback);
+
+    expect(callback).toHaveBeenCalledTimes(1);
+
+    // check if cache data returned (should be empty)
+    expect(callback).toHaveBeenCalledWith(expect.objectContaining(snapshot));
+
+    await pause();
+
+    expect(callback).toHaveBeenCalledTimes(2);
+
+    unsub();
+
+    const updatedAt = new Date(defaultUser?.updatedAt ?? new Date());
+    updatedAt.setDate(updatedAt.getDate() + 7);
+
+    const updatedUser = {
+      ...defaultUser,
+      updatedAt: updatedAt.toISOString(),
+    };
+    client.emitter.emit('user.updated', { users: [updatedUser], files: [] });
+
+    delete snapshot.error;
+    snapshot.loading = false;
+    snapshot.data = updatedUser;
+    expect(callback).not.toHaveBeenNthCalledWith(3, expect.objectContaining(snapshot));
+  });
+
+  const events: [string, keyof Amity.Events][] = [
+    ['it should return updated user on onFetch', 'user.fetched'],
+    ['it should return updated user on onUpdate', 'user.updated'],
+    ['it should return updated user on onDelete', 'user.deleted'],
+    ['it should return updated user on onFlagged', 'user.flagged'],
+    ['it should return updated user on onUnflagged', 'user.unflagged'],
+    ['it should return updated user on onFlagCleared', 'user.flagCleared'],
+  ];
+
+  test.each(events)('%s', async (test, event) => {
+    const snapshot = getSnapshot();
+
+    // mock response of queryUsers and validate
+    const callback = jest.fn();
+    client.http.get = jest.fn().mockResolvedValue(userQueryResponse);
+
+    liveUser(defaultUser.userId, callback);
+
+    await pause();
+
+    expect(callback).toHaveBeenCalledTimes(2);
+
+    const updatedAt = new Date(defaultUser?.updatedAt ?? new Date());
+    updatedAt.setDate(updatedAt.getDate() + 7);
+
+    const updatedUser = {
+      ...defaultUser,
+      updatedAt: updatedAt.toISOString(),
+    };
+    client.emitter.emit(event, { users: [updatedUser], files: [] });
+
+    delete snapshot.error;
+    snapshot.loading = false;
+    snapshot.data = updatedUser;
+    expect(callback).toHaveBeenNthCalledWith(3, expect.objectContaining(snapshot));
+  });
+});

package/src/utils/constants.ts

@@ -0,0 +1,8 @@
+export const COLLECTION_DEFAULT_PAGINATION_LIMIT = 5;
+export const COLLECTION_DEFAULT_CACHING_POLICY: Amity.QueryPolicy = 'cache_then_server';
+export const ENABLE_CACHE_MESSAGE = 'For using Live Collection feature you need to enable Cache!';
+export const LIVE_OBJECT_ENABLE_CACHE_MESSAGE =
+  'For using Live Object feature you need to enable Cache!';
+export const UNSYNCED_OBJECT_CACHED_AT_MESSAGE =
+  'Observing unsynced object is not supported by Live Object.';
+export const UNSYNCED_OBJECT_CACHED_AT_VALUE = -5;

package/src/utils/env.ts

@@ -0,0 +1,12 @@
+/* eslint-disable no-undef */
+const theGlobal =
+  // eslint-disable-next-line no-nested-ternary
+  typeof globalThis === 'object' ? globalThis : typeof global === 'object' ? global : window;
+
+export const { process: safeProcess = {} }: { process: Partial<NodeJS.Process> } = theGlobal;
+
+export function getEnv(): NodeJS.ProcessEnv | undefined {
+  return safeProcess.env ?? {};
+}
+
+export const isProduction = safeProcess.env?.NODE_ENV === 'production';

package/src/utils/tests/client.ts

@@ -0,0 +1,33 @@
+import {
+  createClient,
+  connectClient as sdkConnectClient,
+  disconnectClient as sdkDisconnectClient,
+} from '~/client/api';
+
+import { user11 } from './dummy';
+
+export const client = createClient('key', 'sg');
+
+export const connectClient = async () => {
+  client.mqtt.connect = jest.fn();
+  client.mqtt.subscribe = jest.fn();
+  client.http.post = jest.fn().mockReturnValueOnce({
+    data: {
+      accessToken: 'accessToken',
+      refreshToken: 'refreshToken',
+      users: [user11],
+    },
+  });
+
+  setTimeout(() => {
+    client.ws.emit('connect');
+  }, 500);
+
+  await sdkConnectClient({ userId: 'test' });
+};
+
+export const disconnectClient = async () => {
+  sdkDisconnectClient().then(() => client.ws.emit('disconnect'));
+};
+
+export default {};

package/src/utils/tests/dummy/channel.ts

@@ -0,0 +1,182 @@
+import { date, rolesAndPermissions, user11, user12, user13 } from '.';
+
+const mockPage = {
+  paging: {
+    previous: 'eyJiZWZvcmUiOjU1LCJsYXN0IjoxMH0=',
+    next: 'eyJiZWZvcmUiOjU1LCJsYXN0IjoxMH0=',
+  },
+};
+
+export const channelRaw1: Amity.ChannelRaw = {
+  tags: ['tag2'],
+  messageCount: 1,
+  createdAt: date,
+  isDeleted: false,
+  type: 'community',
+  channelId: 'channelId11',
+  path: 'channelId11-path',
+};
+
+export const channelRaw2: Amity.ChannelRaw = {
+  tags: ['tag1'],
+  messageCount: 3,
+  createdAt: date,
+  isDeleted: true,
+  type: 'conversation',
+  channelId: 'channelId12',
+  path: 'channelId12-path',
+};
+
+export const channelRaw3: Amity.ChannelRaw = {
+  messageCount: 3,
+  createdAt: date,
+  type: 'community',
+  channelId: 'channelId21',
+  path: 'channelId21-path',
+};
+
+export const channel11: Amity.Channel = {
+  ...channelRaw1,
+  hasMention: false,
+  unreadCount: 0,
+  type: 'community',
+};
+
+export const channel12: Amity.Channel = {
+  ...channelRaw2,
+  hasMention: true,
+  unreadCount: 2,
+};
+
+export const channel21: Amity.Channel = {
+  ...channelRaw3,
+  hasMention: false,
+  unreadCount: 0,
+  type: 'conversation',
+  isDeleted: true,
+  tags: ['tag1'],
+};
+
+export const channelUser1: Amity.Membership<'channel'> = {
+  isMuted: false,
+  createdAt: date,
+  muteTimeout: '',
+  isBanned: false,
+  readToSegment: 1,
+  lastActivity: date,
+  membership: 'member',
+  userId: user11.userId,
+  ...rolesAndPermissions,
+  lastMentionedSegment: 0,
+  channelId: channel11.channelId,
+};
+
+export const channelUser2: Amity.Membership<'channel'> = {
+  ...channelUser1,
+  readToSegment: 1,
+  lastMentionedSegment: 2,
+  channelId: channel12.channelId,
+};
+
+export const channelUser3: Amity.Membership<'channel'> = {
+  isMuted: false,
+  createdAt: date,
+  muteTimeout: '',
+  isBanned: false,
+  readToSegment: 1,
+  lastActivity: date,
+  userId: user12.userId,
+  ...rolesAndPermissions,
+  membership: 'none',
+  roles: ['test-role'],
+  lastMentionedSegment: 0,
+  channelId: channel11.channelId,
+};
+
+export const channelUser4: Amity.Membership<'channel'> = {
+  ...channelUser3,
+  userId: user13.userId,
+};
+
+export const channelUser5: Amity.Membership<'channel'> = {
+  isMuted: false,
+  createdAt: date,
+  muteTimeout: '',
+  isBanned: true,
+  readToSegment: 1,
+  lastActivity: date,
+  userId: user13.userId,
+  ...rolesAndPermissions,
+  membership: 'banned',
+  lastMentionedSegment: 0,
+  channelId: channel11.channelId,
+};
+
+export const channelUser6: Amity.Membership<'channel'> = {
+  isMuted: true,
+  createdAt: date,
+  muteTimeout: '',
+  isBanned: true,
+  readToSegment: 1,
+  lastActivity: date,
+  userId: 'test',
+  ...rolesAndPermissions,
+  membership: 'banned',
+  lastMentionedSegment: 0,
+  channelId: channel11.channelId,
+};
+
+export const channelUser7: Amity.Membership<'channel'> = {
+  ...channelUser3,
+  membership: 'member',
+};
+
+export const channelQueryResponse = {
+  data: {
+    channels: [channel11, channel12],
+    channelUsers: [],
+    files: [],
+    users: [],
+    ...mockPage,
+  },
+};
+
+export const channelQueryResponsePage2 = {
+  data: {
+    channels: [channel21],
+    channelUsers: [],
+    files: [],
+    users: [],
+    ...mockPage,
+  },
+};
+
+export const channelUserQueryResponse = {
+  data: {
+    channels: [channel11],
+    channelUsers: [channelUser1, channelUser3],
+    users: [],
+    files: [],
+    ...mockPage,
+  },
+};
+
+export const channelUserQueryResponsePage2 = {
+  data: {
+    channels: [channel11],
+    channelUsers: [channelUser4],
+    users: [],
+    files: [],
+    ...mockPage,
+  },
+};
+
+export const channelUserQueryResponsePage3 = {
+  data: {
+    channels: [channel11],
+    channelUsers: [channelUser7, channelUser6],
+    users: [],
+    files: [],
+    ...mockPage,
+  },
+};

package/src/utils/tests/dummy/follow.ts

@@ -0,0 +1,60 @@
+import { date, user11, user12, user13, user14 } from '.';
+
+const timeStamps: Amity.Timestamps = {
+  createdAt: date,
+  updatedAt: date,
+};
+
+// user11 follows user12
+export const follow11: Amity.FollowStatus = {
+  ...timeStamps,
+  to: user12.userId,
+  status: 'accepted',
+  from: user11.userId,
+};
+
+// user11 pineding user13
+export const follow12: Amity.FollowStatus = {
+  ...timeStamps,
+  status: 'pending',
+  to: user13.userId,
+  from: user11.userId,
+};
+
+// user14 declined user11
+export const follow13: Amity.FollowStatus = {
+  ...timeStamps,
+  status: 'none',
+  to: user14.userId,
+  from: user11.userId,
+};
+
+// user12 follows user11
+export const follow21: Amity.FollowStatus = {
+  ...timeStamps,
+  status: 'accepted',
+  to: user11.userId,
+  from: user12.userId,
+};
+
+// user13 pineding user11
+export const follow22: Amity.FollowStatus = {
+  ...timeStamps,
+  status: 'pending',
+  to: user11.userId,
+  from: user13.userId,
+};
+
+// user11 declined user14
+export const follow23: Amity.FollowStatus = {
+  ...timeStamps,
+  status: 'none',
+  to: user11.userId,
+  from: user14.userId,
+};
+
+export const follows = {
+  userId: user11.userId,
+  page1: [follow11, follow12, follow13],
+  page2: [follow21, follow22, follow23],
+};