@amityco/ts-sdk 7.9.3-8cb8198.0 → 7.9.3-9d4caef6.0

package/dist/utils/linkedObject/channelLinkedObject.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channelLinkedObject.d.ts","sourceRoot":"","sources":["../../../src/utils/linkedObject/channelLinkedObject.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,mBAAmB,YAAa,MAAM,eAAe,KAAG,MAAM,OAyB1E,CAAC"}
+{"version":3,"file":"channelLinkedObject.d.ts","sourceRoot":"","sources":["../../../src/utils/linkedObject/channelLinkedObject.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,mBAAmB,YAAa,MAAM,eAAe,KAAG,MAAM,OAmC1E,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amityco/ts-sdk",
-  "version": "7.9.3-8cb8198.0",
+  "version": "7.9.3-9d4caef6.0",
   "license": "CC-BY-ND-4.0",
   "author": "amity.co <developers@amity.co> (https://amity.co)",
   "description": "Amity Social Cloud Typescript SDK",

package/src/@types/core/errors.ts

@@ -23,6 +23,8 @@ declare global {
       BAN_WORD_FOUND = 400308,
       LINK_NOT_ALLOWED = 400309,
       BUSINESS_ERROR = 500000,
+      VISITOR_PERMISSION_DENIED = 403999,
+      BOT_PERMISSION_DENIED = 403998,
     }
 
     const enum ClientError {

package/src/@types/domains/channel.ts

@@ -103,6 +103,10 @@ declare global {
       myMembership: (
         callback: Amity.LiveObjectCallback<Amity.Membership<'channel'> | undefined>,
       ) => Amity.Unsubscriber;
+      getMembership: (
+        userId: Amity.User['userId'],
+        callback: Amity.LiveObjectCallback<Amity.Membership<'channel'> | undefined>,
+      ) => Amity.Unsubscriber;
     };
 
     type QueryChannels = {

package/src/@types/domains/client.ts

@@ -76,6 +76,8 @@ declare global {
       getMarkerSyncConsistentMode: () => boolean;
 
       prefixDeviceIdKey?: string;
+
+      getVisitorDeviceId: () => Promise<string>;
     };
 
     type Device = {
@@ -94,10 +96,20 @@ declare global {
       expiresAt: string;
     };
 
+    type SessionResponse = Tokens & {
+      users: Amity.RawUser[];
+      userType: Amity.UserType;
+    };
+
     type AccessTokenRenewal = {
       renew: () => void;
       renewWithAuthToken: (authToken: string) => void;
       unableToRetrieveAuthToken: () => void;
+      renewWithAuthSignature: ({
+        authSignature,
+        authSignatureExpiresAt,
+      }: Amity.ConnectClientAsVisitorParams) => void;
+      unableToRetrieveAuthSignature: () => void;
     };
 
     interface SessionHandler {
@@ -150,6 +162,11 @@ declare global {
       deviceId?: Amity.Device['deviceId'];
     };
 
+    type ConnectClientAsVisitorParams = {
+      authSignature?: string;
+      authSignatureExpiresAt?: string;
+    };
+
     type ConnectClientConfig = {
       disableRTE: boolean;
     };

package/src/@types/domains/user.ts

@@ -1,5 +1,11 @@
 import { AmityUserSearchMatchType } from '~/userRepository';
 
+export const enum UserTypeEnum {
+  SIGNED_IN = 'signed-in',
+  VISITOR = 'visitor',
+  BOT = 'bot',
+}
+
 export {};
 
 declare global {
@@ -29,6 +35,8 @@ declare global {
       | 'onUnflagged'
       | 'onFlagCleared';
 
+    type UserType = `${UserTypeEnum}`;
+
     type RawUser = {
       _id: string;
       userId: string;

package/src/@types/index.ts

@@ -46,3 +46,4 @@ export * from './domains/pinnedPost';
 export * from './domains/liveReaction';
 export * from './domains/feed';
 export * from './domains/hashtag';
+export * from './domains/user';

package/src/categoryRepository/api/getCategory.ts

@@ -37,7 +37,9 @@ export const getCategory = async (
   const { categories } = data;
 
   return {
-    data: LinkedObject.category(categories.find(category => category.categoryId === categoryId)!),
+    data: LinkedObject.category(
+      (categories ?? []).find(category => category.categoryId === categoryId)!,
+    ),
     cachedAt,
   };
 };

package/src/channelRepository/api/unmuteChannel.ts

@@ -3,7 +3,6 @@ import { getActiveClient } from '~/client/api';
 /* begin_public_function
   id: channel.unmute
 */
-const CHANNEL_UNMUTE_PERIOD = 0;
 /**
  * ```js
  * import { ChannelRepository } from '@amityco/ts-sdk'
@@ -18,15 +17,14 @@ const CHANNEL_UNMUTE_PERIOD = 0;
  * @category Channel API
  * @async
  */
+const CHANNEL_UNMUTE_PERIOD = 0; // Setting mute period as 0 is the same as unmuting the channel
+
 export const unmuteChannel = async (channelId: Amity.Channel['channelId']): Promise<boolean> => {
   const client = getActiveClient();
   client.log('channel/unmuteChannel', channelId);
 
   const { data } = await client.http.put<{ success: boolean }>(
     `/api/v2/channel/${encodeURIComponent(channelId)}/mute`,
-    /*
-     * Setting mute period as 0 is the same as unmuting the channel
-     */
     { mutePeriod: CHANNEL_UNMUTE_PERIOD },
   );
 

package/src/channelRepository/internalApi/getMembership.ts

@@ -0,0 +1,45 @@
+import { ASCApiError } from '~/core/errors';
+import { pullFromCache } from '~/cache/api/pullFromCache';
+import { getActiveClient } from '~/client/api/activeClient';
+
+/**
+ *
+ * get membership of user in a channel from cache
+ *
+ * @returns the {@link Amity.Membership<'channel'>} objects
+ *
+ * @category Channel API
+ * @async
+ */
+
+type GetMembershipParams = {
+  channelId: string;
+  userId: Amity.User['userId'];
+};
+
+export const getMembership = ({
+  channelId,
+  userId,
+}: GetMembershipParams): Amity.Cached<Amity.Membership<'channel'>> => {
+  const client = getActiveClient();
+  client.log('channel/getMembership.locally');
+
+  const cacheChannelUser = pullFromCache<Amity.Membership<'channel'>>([
+    'channelUsers',
+    'get',
+    `${channelId}#${userId}`,
+  ]);
+
+  if (!cacheChannelUser) {
+    throw new ASCApiError(
+      'Item not found!',
+      Amity.ServerError.ITEM_NOT_FOUND,
+      Amity.ErrorLevel.ERROR,
+    );
+  }
+
+  return {
+    data: cacheChannelUser.data,
+    cachedAt: cacheChannelUser.cachedAt,
+  };
+};

package/src/channelRepository/observers/getMembership.ts

@@ -0,0 +1,89 @@
+import { getMembership as _getMembership } from '../internalApi/getMembership';
+import { ASCApiError } from '~/core/errors';
+import { getActiveClient } from '~/client/api/activeClient';
+import { isEqual } from '~/utils/isEqual';
+import { createQuery, runQuery } from '~/core/query';
+import {
+  UNSYNCED_OBJECT_CACHED_AT_MESSAGE,
+  UNSYNCED_OBJECT_CACHED_AT_VALUE,
+} from '~/utils/constants';
+import { channelMemberLinkedObject } from '~/utils/linkedObject/channelMemberLinkedObject';
+import { onChannelMemberBanned, onChannelMemberUnbanned } from '../events';
+import { onChannelSetUserMuted } from '../events/onChannelSetUserMuted';
+
+type GetMembership = {
+  channelId: string;
+  userId: Amity.User['userId'];
+  callback: Amity.LiveObjectCallback<Amity.Membership<'channel'> | undefined>;
+};
+
+export const getMembership = ({
+  channelId,
+  userId,
+  callback,
+}: GetMembership): Amity.Unsubscriber => {
+  const { log, cache } = getActiveClient();
+
+  if (!cache) {
+    console.log('This observable object need the cache data!');
+  }
+
+  const timestamp = Date.now();
+  log(`liveMembership(tmpid: ${timestamp}) > listen`);
+
+  const disposers: Amity.Unsubscriber[] = [];
+
+  let isUnsyncedModel = false;
+
+  let model: Amity.Membership<'channel'> | undefined;
+
+  const dispatcher = (data: Amity.LiveObject<Amity.Membership<'channel'> | undefined>) => {
+    callback({ ...data, data: data.data ? channelMemberLinkedObject(data.data) : data.data });
+  };
+
+  const realtimeRouter = (_: Amity.StaticInternalChannel, __: Amity.RawMembership<'channel'>) => {
+    const { data } = _getMembership({ channelId, userId });
+
+    if (isEqual(model, data)) return;
+
+    dispatcher({ loading: false, data });
+  };
+
+  const onFetch = () => {
+    const query = createQuery(async () => _getMembership({ channelId, userId }));
+
+    runQuery(query, ({ error, data, loading, origin, cachedAt }) => {
+      if (cachedAt === UNSYNCED_OBJECT_CACHED_AT_VALUE) {
+        dispatcher({
+          data,
+          origin,
+          loading: false,
+          error: new ASCApiError(
+            UNSYNCED_OBJECT_CACHED_AT_MESSAGE,
+            Amity.ClientError.DISALOOW_UNSYNCED_OBJECT,
+            Amity.ErrorLevel.ERROR,
+          ),
+        });
+
+        isUnsyncedModel = true;
+        disposers.forEach(fn => fn());
+      } else if (!isUnsyncedModel) {
+        dispatcher({ loading, data, origin, error });
+      }
+
+      if (error) {
+        disposers.forEach(fn => fn());
+      }
+    });
+  };
+
+  disposers.push(onChannelMemberBanned(realtimeRouter));
+  disposers.push(onChannelMemberUnbanned(realtimeRouter));
+  disposers.push(onChannelSetUserMuted(realtimeRouter));
+
+  onFetch();
+
+  return () => {
+    disposers.forEach(fn => fn());
+  };
+};

package/src/client/api/activeUser.ts

@@ -7,6 +7,7 @@ let activeUser: Amity.ActiveUser | null = null;
 */
 /**
  * for internal use
+ * @deprecated please use getCurrentUser api instead.
  */
 export const getActiveUser = () => {
   if (!activeUser) {

package/src/client/api/createClient.ts

@@ -3,11 +3,7 @@ import { VERSION } from '~/version';
 import { createLogger } from '~/core/debug';
 
 import { API_REGIONS, computeUrl } from '~/client/utils/endpoints';
-import {
-  createHttpTransport,
-  createMqttTransport,
-  createWebsocketTransport,
-} from '~/core/transports';
+import { createHttpTransport, createMqttTransport } from '~/core/transports';
 
 import { createEventEmitter } from '~/core/events';
 
@@ -21,6 +17,7 @@ import { getFeedSettings } from './getFeedSettings';
 
 import { accessTokenExpiryWatcher } from './accessTokenExpiryWatcher';
 import { getMarkerSyncConsistentMode } from '../utils/markerSyncEngine';
+import { getDeviceId } from '~/core/device';
 
 const DEFAULT_DEBUG_SESSION = 'amity';
 
@@ -121,6 +118,7 @@ export const createClient = (
     validateTexts,
     getFeedSettings,
     getSocialSettings,
+    getVisitorDeviceId: getDeviceId,
     getMessagePreviewSetting,
 
     use: () => setActiveClient(client),

package/src/client/api/getBotToken.ts

@@ -0,0 +1,44 @@
+import { getActiveClient } from './activeClient';
+
+import { getDeviceInfo } from '~/core/device';
+
+/**
+ * Retrieves a pair of {@link Amity.Tokens} necessary for connection
+ *
+ * @param param get bot token param
+ * @param params.deviceId The user's device Id (can be manually set for native users)
+ * @param options get bot token options
+ * @param options.setAccessTokenCookie The authentication token - necessary when network option is set to secure
+ * @return The accessToken for the given userId
+ *
+ * @category Client API
+ * @hidden
+ */
+export const getBotToken = async ({
+  params,
+  options,
+}: {
+  params: { deviceId: string };
+  options?: { setAccessTokenCookie?: boolean };
+}) => {
+  const client = getActiveClient();
+  client.log('client/api/getBotToken');
+
+  const deviceInfo = getDeviceInfo();
+
+  const { data } = await client.http.post<Amity.SessionResponse>(
+    '/api/v5/sessions/bot',
+    {
+      ...params,
+      deviceInfo,
+    },
+    {
+      headers: {
+        'X-API-Key': client.apiKey,
+        'set-access-token-cookie': options?.setAccessTokenCookie || false,
+      },
+    },
+  );
+
+  return data;
+};

package/src/client/api/getCurrentUser.ts

@@ -0,0 +1,32 @@
+import { ASCError } from '~/core/errors';
+import { getActiveClient } from './activeClient';
+import { pullFromCache } from '~/cache/api';
+import { userLinkedObject } from '~/utils/linkedObject/userLinkedObject';
+
+/* begin_public_function
+  id: client.get_current_user
+*/
+export const getCurrentUser = (): Amity.User => {
+  const client = getActiveClient();
+
+  if (!client) {
+    throw new ASCError(
+      'Connect client first',
+      Amity.ClientError.UNKNOWN_ERROR,
+      Amity.ErrorLevel.FATAL,
+    );
+  }
+
+  const cache = pullFromCache<Amity.User>(['user', 'get', client.userId])?.data!;
+
+  if (!cache) {
+    throw new ASCError(
+      'Connect client first',
+      Amity.ClientError.UNKNOWN_ERROR,
+      Amity.ErrorLevel.FATAL,
+    );
+  }
+
+  return userLinkedObject(cache);
+};
+/* end_public_function */

package/src/client/api/getCurrentUserType.ts

@@ -0,0 +1,23 @@
+import { ASCError } from '~/core/errors';
+
+let currentUserType: Amity.UserType | null = null;
+
+/* begin_public_function
+  id: client.get_current_user_type
+*/
+export const getCurrentUserType = () => {
+  if (!currentUserType) {
+    throw new ASCError(
+      'Connect client first',
+      Amity.ClientError.UNKNOWN_ERROR,
+      Amity.ErrorLevel.FATAL,
+    );
+  }
+
+  return currentUserType!;
+};
+/* end_public_function */
+
+export const setCurrentUserType = (userType: Amity.UserType) => {
+  currentUserType = userType;
+};

package/src/client/api/getToken.ts

@@ -31,7 +31,7 @@ export const getToken = async ({
 
   const deviceInfo = getDeviceInfo();
 
-  const { data } = await client.http.post<Amity.Tokens & { users: Amity.InternalUser[] }>(
+  const { data } = await client.http.post<Amity.SessionResponse>(
     '/api/v5/sessions',
     {
       ...params,

package/src/client/api/getVisitorToken.ts

@@ -0,0 +1,47 @@
+import { getActiveClient } from './activeClient';
+
+import { getDeviceInfo } from '~/core/device';
+
+/**
+ * Retrieves a pair of {@link Amity.Tokens} necessary for connection
+ *
+ * @param params get visitor token param
+ * @param params.deviceId The user's device Id (can be manually set for native users)
+ * @param params.authSignature The authenitcation signature - necessary when network option is set to secure
+ * @param params.authSignatureExpiresAt Expire time of the authenitcation signature
+ * @param options get bot token options
+ * @param options.setAccessTokenCookie The authentication token - necessary when network option is set to secure
+ * @return The accessToken for the given userId
+ *
+ *
+ * @category Client API
+ * @hidden
+ */
+export const getVisitorToken = async ({
+  params,
+  options,
+}: {
+  params: Amity.ConnectClientAsVisitorParams & { deviceId: string };
+  options?: { setAccessTokenCookie?: boolean };
+}) => {
+  const client = getActiveClient();
+  client.log('client/api/getVisitorToken', params);
+
+  const deviceInfo = getDeviceInfo();
+
+  const { data } = await client.http.post<Amity.SessionResponse>(
+    '/api/v5/sessions/visitor',
+    {
+      ...params,
+      deviceInfo,
+    },
+    {
+      headers: {
+        'X-API-Key': client.apiKey,
+        'set-access-token-cookie': options?.setAccessTokenCookie || false,
+      },
+    },
+  );
+
+  return data;
+};

package/src/client/api/index.ts

@@ -25,3 +25,9 @@ export * from './fetchLinkPreview';
 export * from './getSocialSettings';
 
 export * from './getShareableLinkConfiguration';
+
+export * from './loginAsVisitor';
+export * from './loginAsBot';
+
+export * from './getCurrentUser';
+export * from './getCurrentUserType';

package/src/client/api/login.ts

@@ -2,7 +2,6 @@
 import { modifyMqttConnection } from '~/client/utils/modifyMqttConnection';
 /* eslint-disable require-atomic-updates */
 import { getDeviceId } from '~/core/device';
-import { proxyWebsocketEvents } from '~/core/events';
 import { onChannelDeleted } from '~/channelRepository/events/onChannelDeleted';
 import { onChannelMemberBanned } from '~/channelRepository/events/onChannelMemberBanned';
 
@@ -29,6 +28,8 @@ import { removeChannelMarkerCache } from '../utils/removeChannelMarkerCache';
 import { initializeMessagePreviewSetting } from '../utils/messagePreviewEngine';
 import { ASCError } from '~/core/errors';
 import SessionWatcher from '../utils/SessionWatcher';
+import { setCurrentUserType } from './getCurrentUserType';
+import { setCurrentUser } from '../utils/setCurrentUser';
 
 /*
  * declared earlier to accomodate case when logging in with a different user
@@ -91,7 +92,7 @@ export const login = async (
   const defaultDeviceId = await getDeviceId();
 
   try {
-    const { users } = await setClientToken({
+    const { users, userType } = await setClientToken({
       params: {
         ...params,
         displayName: params?.displayName,
@@ -117,7 +118,7 @@ export const login = async (
       return false;
     }
 
-    if (user.isGlobalBanned) {
+    if (user.isGlobalBan) {
       terminateClient(Amity.TokenTerminationReason.GLOBAL_BAN);
       return false;
     }
@@ -132,7 +133,7 @@ export const login = async (
      */
     unsubWatcher = client.accessTokenExpiryWatcher(sessionHandler);
 
-    setActiveUser(user);
+    setCurrentUser({ user, userType });
   } catch (error) {
     /*
      * if getting token failed session state reverts to initial state when app

package/src/client/api/loginAsBot.ts

@@ -0,0 +1,125 @@
+/* eslint-disable no-param-reassign */
+import { modifyMqttConnection } from '~/client/utils/modifyMqttConnection';
+/* eslint-disable require-atomic-updates */
+import { getDeviceId } from '~/core/device';
+import { logout } from './logout';
+
+import { getActiveClient } from './activeClient';
+import { terminateClient } from './terminateClient';
+import { setActiveUser } from './activeUser';
+
+import { onTokenExpired } from '../events/onTokenExpired';
+import { onTokenTerminated } from '../events/onTokenTerminated';
+import { initializeMessagePreviewSetting } from '../utils/messagePreviewEngine';
+
+import SessionWatcher from '../utils/SessionWatcher';
+import { setBotClientToken } from '../utils/setBotClientToken';
+import { setCurrentUser } from '../utils/setCurrentUser';
+
+/*
+ * declared earlier to accomodate case when logging in with a different user
+ * than the one already connected, in which case the existing subscriptions need
+ * to be cleared
+ */
+const subscriptions: Amity.Unsubscriber[] = [];
+
+/* begin_public_function
+  id: client.loginAsBot
+*/
+/**
+ * ```js
+ * import { loginAsBot } from '@amityco/ts-sdk/client/api'
+ * const success = await loginAsBot({
+    sessionHandler: {
+      sessionWillRenewAccessToken(renewal: Amity.AccessTokenRenewal) {
+       ...
+    }
+ * })
+ * ```
+ *
+ * Connects an {@link Amity.Client} instance to ASC servers
+ *
+ * @param params. the connect parameters
+ * @param params.sessionHandler
+ * @returns a success boolean if connected
+ *
+ * @category Client API
+ * @async
+ */
+
+export const loginAsBot = async (params: {
+  sessionHandler: Amity.SessionHandler;
+}): Promise<boolean> => {
+  const client = getActiveClient();
+  let unsubWatcher: Amity.Unsubscriber;
+
+  client.log('client/api/connectClient', {
+    apiKey: client.apiKey,
+    sessionState: client.sessionState,
+  });
+
+  // generate deviceId
+  const deviceId = await getDeviceId();
+  let user: Amity.RawUser;
+
+  try {
+    const { users, userType } = await setBotClientToken({
+      params: {
+        deviceId,
+      },
+      options: {
+        setAccessTokenCookie: true,
+      },
+    });
+
+    [user] = users;
+
+    client.userId = user.userId;
+
+    client.sessionHandler = params.sessionHandler;
+
+    /*
+     * Cannot push to subscriptions as watcher needs to continue working even if
+     * token expires
+     */
+    unsubWatcher = client.accessTokenExpiryWatcher(params.sessionHandler);
+
+    setCurrentUser({ user, userType });
+  } catch (error) {
+    /*
+     * if getting token failed session state reverts to initial state when app
+     * is first launched
+     */
+    SessionWatcher.getInstance().setSessionState(Amity.SessionStates.NOT_LOGGED_IN);
+
+    // pass error down tree so the calling function handle it
+    throw error;
+  }
+
+  await initializeMessagePreviewSetting();
+
+  if (subscriptions.length === 0) {
+    // handling internal SDK events
+    subscriptions.push(
+      onTokenTerminated(_ => {
+        terminateClient();
+
+        subscriptions.forEach(fn => fn());
+
+        unsubWatcher();
+      }),
+
+      onTokenExpired(state => {
+        SessionWatcher.getInstance().setSessionState(state);
+
+        logout();
+
+        subscriptions.forEach(fn => fn());
+      }),
+    );
+  }
+
+  return true;
+};
+
+/* end_public_function */