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

package/dist/index.cjs.js

@@ -132,7 +132,7 @@ const toToken = (paging, style) => {
  */
 const toPage = (token) => {
     if (!token)
-        return null;
+        return undefined;
     // don't try catch, let it throw
     const json = JSON.parse(jsBase64.decode(token));
     if (isSkipLimit(json)) {
@@ -155,7 +155,7 @@ const toPage = (token) => {
             };
         }
     }
-    return null;
+    return undefined;
 };
 /**
  * Converts a b64 string token into a paging object
@@ -167,13 +167,13 @@ const toPage = (token) => {
  */
 const toPageRaw = (token) => {
     if (!token)
-        return null;
+        return undefined;
     // don't try catch, let it throw
     const json = JSON.parse(jsBase64.decode(token));
     if (isAfterBeforeRaw(json)) {
         return json;
     }
-    return null;
+    return undefined;
 };
 
 /**
@@ -14929,6 +14929,24 @@ const getDeviceInfo = () => {
     };
 };
 
+let activeUser = null;
+/**
+ * for internal use
+ */
+const getActiveUser = () => {
+    if (!activeUser) {
+        throw new ASCError('Connect client first', 800000 /* UNKNOWN_ERROR */, "fatal" /* FATAL */);
+    }
+    return activeUser;
+};
+const setActiveUser = (user) => {
+    activeUser = {
+        _id: user._id,
+        userId: user.userId,
+        path: user.path,
+    };
+};
+
 /**
  * Retrieves a pair of {@link Amity.Tokens} necessary for connection
  *
@@ -15076,8 +15094,8 @@ const connectClient = async (params) => {
         unsubscribe();
     });
     client.userId = params.userId;
-    client._internalUserId = users[0]._id;
     client.accessToken = accessToken;
+    setActiveUser(users[0]);
     return client.ws.connected;
 };
 
@@ -15135,13 +15153,24 @@ const getPostTopic = ({ path }, level = exports.SubscriptionLevels.POST) => {
 const getCommentTopic = ({ path }) => {
     return path;
 };
+const getMyFollowersTopic = () => {
+    const user = getActiveUser();
+    const [networkId] = user.path.split('/user/');
+    return `${networkId}/membership/${user._id}/+/+`;
+};
+const getMyFollowingsTopic = () => {
+    const user = getActiveUser();
+    const [networkId] = user.path.split('/user/');
+    return `${networkId}/membership/+/${user._id}/+`;
+};
 let mqttAccessToken;
 let mqttUserId;
 function subscribeTopic(topic, callback) {
-    const { mqtt, emitter, accessToken, _internalUserId } = getActiveClient();
-    if (mqttAccessToken !== accessToken || mqttUserId !== _internalUserId) {
+    const { mqtt, emitter, accessToken } = getActiveClient();
+    const user = getActiveUser();
+    if (mqttAccessToken !== accessToken || mqttUserId !== user._id) {
         mqttAccessToken = accessToken;
-        mqttUserId = _internalUserId;
+        mqttUserId = user._id;
         mqtt.connect({ accessToken: mqttAccessToken, userId: mqttUserId });
         proxyMqttEvents(mqtt, emitter);
     }
@@ -15547,6 +15576,8 @@ const idResolvers = {
     post: ({ postId }) => postId,
     comment: ({ commentId }) => commentId,
     stream: ({ streamId }) => streamId,
+    follow: ({ from, to }) => `${from}#${to}`,
+    followCount: ({ userId }) => userId,
 };
 /**
  * Retrieve the id resolver matching a domain name
@@ -15573,6 +15604,8 @@ const PAYLOAD2MODEL = {
     postChildren: 'post',
     comments: 'comment',
     videoStreamings: 'stream',
+    follows: 'follow',
+    followCounts: 'followCount'
 };
 
 /**
@@ -17354,6 +17387,132 @@ const removeCommunityMembersRole = async (communityId, roleId, userIds) => {
     return !!communityUsers.find(communityUser => communityUser.communityId === communityId && !communityUser.roles.includes(roleId));
 };
 
+/**
+ * ```js
+ * import { getTopTrendingCommunities } from '@amityco/ts-sdk'
+ * const trendingCommunities = await getTopTrendingCommunities()
+ * ```
+ *
+ * Gets a list of top trending {@link Amity.Community} objects
+ *
+ * @param query The query parameters
+ * @returns A list of {@link Amity.Community} objects
+ *
+ * @category Community API
+ * @async
+ */
+const getTopTrendingCommunities = async (query) => {
+    const client = getActiveClient();
+    client.log('channel/getTopTrendingCommunities', query);
+    const { limit = 5 } = query !== null && query !== void 0 ? query : {};
+    // API-FIX: backend doesnt answer Amity.Response
+    // const { data } = await client.http.get<Amity.Response<CommunityPayload>>(
+    const { data } = await client.http.get(`/api/v3/communities/top-trending`, { params: { options: { limit } } });
+    const { communities } = data;
+    const cachedAt = client.cache && Date.now();
+    if (client.cache) {
+        ingestInCache(data, { cachedAt });
+        const cacheKey = ['community', 'top-trending', { params: { options: { limit } } }];
+        pushToCache(cacheKey, { communities: communities.map(getResolver('community')) });
+    }
+    return { data: communities, cachedAt };
+};
+/**
+ * ```js
+ * import { getTopTrendingCommunities } from '@amityco/ts-sdk'
+ * const communities = getTopTrendingCommunities.locally()
+ * ```
+ *
+ * Gets a list of top trending {@link Amity.Community} objects from cache
+ *
+ * @param query The query parameters
+ * @returns communities
+ *
+ * @category Community API
+ */
+getTopTrendingCommunities.locally = (query) => {
+    var _a, _b;
+    const client = getActiveClient();
+    client.log('community/getTopTrendingCommunities.locally', query);
+    if (!client.cache)
+        return;
+    const { limit = 5 } = query !== null && query !== void 0 ? query : {};
+    const queryKey = ['community', 'top-trending', { params: { options: { limit } } }];
+    const { data, cachedAt } = (_a = pullFromCache(queryKey)) !== null && _a !== void 0 ? _a : {};
+    if (!(data === null || data === void 0 ? void 0 : data.communities.length))
+        return;
+    const communities = data.communities
+        .map(communityId => pullFromCache(['community', 'get', communityId]))
+        .filter(Boolean)
+        .map(({ data }) => data);
+    return communities.length === ((_b = data === null || data === void 0 ? void 0 : data.communities) === null || _b === void 0 ? void 0 : _b.length)
+        ? { data: communities, cachedAt }
+        : undefined;
+};
+
+/**
+ * ```js
+ * import { getRecommendedCommunities } from '@amityco/ts-sdk'
+ * const communities = await getRecommendedCommunities()
+ * ```
+ *
+ * Gets a list of recommended {@link Amity.Community} objects
+ *
+ * @param query The query parameters
+ * @returns A list of {@link Amity.Community} objects
+ *
+ * @category Community API
+ * @async
+ */
+const getRecommendedCommunities = async (query) => {
+    const client = getActiveClient();
+    client.log('channel/getRecommendedCommunities', query);
+    const { limit = 5 } = query !== null && query !== void 0 ? query : {};
+    // API-FIX: backend doesnt answer Amity.Response
+    // const { data } = await client.http.get<Amity.Response<CommunityPayload>>(
+    const { data } = await client.http.get(`/api/v3/communities/recommended`, { params: { options: { limit } } });
+    const { communities } = data;
+    const cachedAt = client.cache && Date.now();
+    if (client.cache) {
+        ingestInCache(data, { cachedAt });
+        const cacheKey = ['community', 'recommended', { params: { options: { limit } } }];
+        pushToCache(cacheKey, { communities: communities.map(getResolver('community')) });
+    }
+    return { data: communities, cachedAt };
+};
+/**
+ * ```js
+ * import { getRecommendedCommunities } from '@amityco/ts-sdk'
+ * const communities = getRecommendedCommunities.locally()
+ * ```
+ *
+ * Gets a list of recommended {@link Amity.Community} objects from cache
+ *
+ * @param query The query parameters
+ * @returns communities
+ *
+ * @category Community API
+ */
+getRecommendedCommunities.locally = (query) => {
+    var _a, _b;
+    const client = getActiveClient();
+    client.log('community/getRecommendedCommunities.locally', query);
+    if (!client.cache)
+        return;
+    const { limit = 5 } = query !== null && query !== void 0 ? query : {};
+    const queryKey = ['community', 'recommended', { params: { options: { limit } } }];
+    const { data, cachedAt } = (_a = pullFromCache(queryKey)) !== null && _a !== void 0 ? _a : {};
+    if (!(data === null || data === void 0 ? void 0 : data.communities.length))
+        return;
+    const communities = data.communities
+        .map(communityId => pullFromCache(['community', 'get', communityId]))
+        .filter(Boolean)
+        .map(({ data }) => data);
+    return communities.length === ((_b = data === null || data === void 0 ? void 0 : data.communities) === null || _b === void 0 ? void 0 : _b.length)
+        ? { data: communities, cachedAt }
+        : undefined;
+};
+
 /**
  * ```js
  * import { deletePost } from '@amityco/ts-sdk'
@@ -19548,6 +19707,569 @@ queryGlobalFeed.locally = (query) => {
         : undefined;
 };
 
+const queryFollows = async (key, query) => {
+    const client = getActiveClient();
+    client.log(`follow/queryF${key.substring(1)}`, query);
+    const { userId, page } = query, params = __rest(query, ["userId", "page"]);
+    const { data } = await client.http.get(client.userId === userId ? `/api/v4/me/${key}` : `/api/v4/users/${userId}/${key}`, {
+        params: Object.assign(Object.assign({}, params), { token: toToken(page, 'skiplimit') }),
+    });
+    const { paging } = data, payload = __rest(data, ["paging"]);
+    const { follows } = payload;
+    const cachedAt = client.cache && Date.now();
+    if (client.cache) {
+        ingestInCache(payload, { cachedAt });
+        const cacheKey = [key, 'query', Object.assign(Object.assign({}, params), { userId, options: Object.assign({}, page) })];
+        pushToCache(cacheKey, { follows: follows.map(getResolver('follow')), paging });
+    }
+    const nextPage = toPage(paging.next);
+    const prevPage = toPage(paging.previous);
+    return { data: follows, cachedAt, prevPage, nextPage };
+};
+queryFollows.locally = (key, query) => {
+    var _a, _b;
+    const client = getActiveClient();
+    client.log(`follow/queryF${key.substring(1)}.locally`, query);
+    if (!client.cache)
+        return;
+    const { page } = query, params = __rest(query, ["page"]);
+    const queryKey = [key, 'query', Object.assign(Object.assign({}, params), { options: Object.assign({}, page) })];
+    const { data, cachedAt } = (_a = pullFromCache(queryKey)) !== null && _a !== void 0 ? _a : {};
+    if (!(data === null || data === void 0 ? void 0 : data.follows.length)) {
+        return;
+    }
+    const follows = data.follows
+        .map(key => pullFromCache(['follow', 'get', key]))
+        .filter(Boolean)
+        .map(({ data }) => data);
+    const prevPage = toPage(data === null || data === void 0 ? void 0 : data.paging.previous);
+    const nextPage = toPage(data === null || data === void 0 ? void 0 : data.paging.next);
+    return follows.length === ((_b = data === null || data === void 0 ? void 0 : data.follows) === null || _b === void 0 ? void 0 : _b.length)
+        ? { data: follows, cachedAt, prevPage, nextPage }
+        : undefined;
+};
+
+/**
+ * ```js
+ * import { queryFollowers } from '@amityco/ts-sdk'
+ * const { data: followers, prevPage, nextPage } = await queryFollowers({ userId })
+ * ```
+ *
+ * Queries a paginable list of {@link Amity.FollowStatus}
+ *
+ * @param query The query parameters
+ * @returns followers
+ *
+ * @category Follow API
+ * @async
+ */
+const queryFollowers = async (query) => queryFollows('followers', query);
+/**
+ * ```js
+ * import { queryFollowers } from '@amityco/ts-sdk'
+ * const { data: followers, prevPage, nextPage } = queryFollowers.locally({ userId })
+ * ```
+ *
+ * Queries a paginable list of {@link Amity.FollowStatus} objects from cache
+ *
+ * @param query The query parameters
+ * @returns followers
+ *
+ * @category Post API
+ */
+queryFollowers.locally = (query) => queryFollows.locally('followers', query);
+
+/**
+ * ```js
+ * import { queryFollowings } from '@amityco/ts-sdk'
+ * const { data: followings, prevPage, nextPage } = await queryFollowings({ userId })
+ * ```
+ *
+ * Queries a paginable list of {@link Amity.FollowStatus}
+ *
+ * @param query The query parameters
+ * @returns followings
+ *
+ * @category Follow API
+ * @async
+ */
+const queryFollowings = async (query) => queryFollows('following', query);
+/**
+ * ```js
+ * import { queryFollowings } from '@amityco/ts-sdk'
+ * const { data: followings, prevPage, nextPage } = queryFollowings.locally({ userId })
+ * ```
+ *
+ * Queries a paginable list of {@link Amity.FollowStatus} objects from cache
+ *
+ * @param query The query parameters
+ * @returns followings
+ *
+ * @category Post API
+ */
+queryFollowings.locally = (query) => queryFollows.locally('following', query);
+
+const getCacheKey = (userId) => ['followInfo', 'get', `${getActiveClient().userId}#${userId}`];
+/**
+ * ```js
+ * import { getFollowInfo } from '@amityco/ts-sdk'
+ * const { data: followInfo } = await getFollowInfo('foobar')
+ * ```
+ *
+ * Fetches the number of followers, followings, pending requests and the follow status for current user
+ *
+ * @param userId the ID of the {@link Amity.User}
+ * @returns the associated {@link Amity.FollowInfo} object
+ *
+ * @category Follow API
+ * @async
+ */
+const getFollowInfo = async (userId) => {
+    var _a, _b;
+    const client = getActiveClient();
+    client.log('follow/getFollowInfo', userId);
+    const { data } = await client.http.get(client.userId === userId ? `/api/v4/me/followInfo` : `/api/v4/users/${userId}/followInfo`);
+    const cachedAt = client.cache && Date.now();
+    const followInfo = Object.assign(Object.assign({}, data.followCounts[0]), { status: (_b = (_a = data.follows) === null || _a === void 0 ? void 0 : _a[0]) === null || _b === void 0 ? void 0 : _b.status });
+    if (client.cache) {
+        pushToCache(getCacheKey(userId), followInfo, { cachedAt });
+    }
+    return {
+        data: followInfo,
+        cachedAt,
+    };
+};
+/**
+ * ```js
+ * import { getFollowInfo } from '@amityco/ts-sdk'
+ * const { data: followInfo } = getFollowInfo.locally('foobar')
+ * ```
+ *
+ * Fetches the number of followers, followings, pending requests and the follow status for current user from cache
+ *
+ * @param userId the ID of the {@link Amity.User}
+ * @returns the associated {@link Amity.FollowInfo} object
+ *
+ * @category Follow API
+ */
+getFollowInfo.locally = (userId) => {
+    const client = getActiveClient();
+    client.log('follow/getFollowInfo.locally', userId);
+    if (!client.cache) {
+        return;
+    }
+    const cached = pullFromCache(getCacheKey(userId));
+    if (!cached) {
+        return;
+    }
+    return {
+        data: cached.data,
+        cachedAt: cached.cachedAt,
+    };
+};
+
+/**
+ * ```js
+ * import { follow } from '@amityco/ts-sdk'
+ * const status = await follow('foobar')
+ * ```
+ *
+ * Follow the user
+ *
+ * @param userId the ID of the {@link Amity.User}
+ * @returns the status {@link Amity.FollowStatus}
+ *
+ * @category Follow API
+ * @async
+ */
+const follow = async (userId) => {
+    const client = getActiveClient();
+    client.log('follow/follow', userId);
+    const { data } = await client.http.post(`/api/v4/me/following/${userId}`);
+    const cachedAt = client.cache && Date.now();
+    if (client.cache) {
+        ingestInCache(data, { cachedAt });
+    }
+    fireEvent(data.follows[0].status === 'accepted' ? 'follow.created' : 'follow.requested', data.follows[0]);
+    return {
+        data: data.follows[0],
+        cachedAt,
+    };
+};
+
+/**
+ * ```js
+ * import { unfollow } from '@amityco/ts-sdk'
+ * await unfollow('foobar')
+ * ```
+ *
+ * Cancel the follow request or unfollow the user
+ *
+ * @param userId the ID of the {@link Amity.User}
+ * @returns A success boolean if the user {@link Amity.User} was unfollowed
+ *
+ * @category Follow API
+ * @async
+ */
+const unfollow = async (userId) => {
+    const client = getActiveClient();
+    client.log('follow/unfollow', userId);
+    const { data } = await client.http.delete(`/api/v4/me/following/${userId}`);
+    if (client.cache) {
+        ingestInCache(data);
+    }
+    fireEvent('follow.unfollowed', data.follows[0]);
+    return true;
+};
+
+/**
+ * ```js
+ * import { acceptFollower } from '@amityco/ts-sdk'
+ * await acceptFollower('foobar')
+ * ```
+ *
+ * Accept the follow request
+ *
+ * @param userId the ID of the {@link Amity.User} follower
+ * @returns A success boolean if the follow request was accepted
+ *
+ * @category Follow API
+ * @async
+ */
+const acceptFollower = async (userId) => {
+    const client = getActiveClient();
+    client.log('follow/acceptFollower', userId);
+    const { data } = await client.http.post(`/api/v4/me/followers/${userId}`);
+    if (client.cache) {
+        ingestInCache(data);
+    }
+    fireEvent('follow.accepted', data.follows[0]);
+    return true;
+};
+
+/**
+ * ```js
+ * import { declineFollower } from '@amityco/ts-sdk'
+ * await declineFollower('foobar')
+ * ```
+ *
+ * Decline the follow request or delete the follower
+ *
+ * @param userId the ID of the {@link Amity.User} follower
+ * @returns A success boolean if the follow request was decline
+ *
+ * @category Follow API
+ * @async
+ */
+const declineFollower = async (userId) => {
+    const client = getActiveClient();
+    client.log('follow/declineFollower', userId);
+    const { data } = await client.http.delete(`/api/v4/me/followers/${userId}`);
+    if (client.cache) {
+        ingestInCache(data);
+    }
+    fireEvent('follow.requestDeclined', data.follows[0]);
+    return true;
+};
+
+const createFollowEventSubscriber = (event, callback) => {
+    const client = getActiveClient();
+    const filter = (payload) => {
+        var _a, _b;
+        if (!client.cache) {
+            callback(payload);
+        }
+        else {
+            ingestInCache({ follows: [payload] });
+            const queries = [
+                ...(_a = queryCache(['followers', 'query'])) !== null && _a !== void 0 ? _a : [],
+                ...(_b = queryCache(['followings', 'query'])) !== null && _b !== void 0 ? _b : [],
+            ];
+            queries
+                // @ts-ignore
+                .filter(({ key }) => key[2].userId === payload.from || key[2].userId === payload.to)
+                .forEach(({ key, data }) => upsertInCache(key, data, { cachedAt: -1 }));
+            callback(payload);
+        }
+    };
+    return createEventSubscriber(client, event, event, filter);
+};
+
+/**
+ * ```js
+ * import { onUserFollowed } from '@amityco/ts-sdk'
+ * const dispose = onUserFollowed(status => {
+ *   // ...
+ * })
+ * ```
+ *
+ * Fired when a user follows another users and confirmation is not required
+ *
+ * @param callback The function to call when the event was fired
+ * @returns an {@link Amity.Unsubscriber} function to stop listening
+ *
+ * @category Follow Events
+ */
+const onUserFollowed = (callback) => createFollowEventSubscriber('follow.created', callback);
+
+/**
+ * ```js
+ * import { onUserUnfollowed } from '@amityco/ts-sdk'
+ * const dispose = onUserFollowed(status => {
+ *   // ...
+ * })
+ * ```
+ *
+ * Fired when a user unfollows
+ *
+ * @param callback The function to call when the event was fired
+ * @returns an {@link Amity.Unsubscriber} function to stop listening
+ *
+ * @category Follow Events
+ */
+const onUserUnfollowed = (callback) => createFollowEventSubscriber('follow.unfollowed', callback);
+
+/**
+ * ```js
+ * import { onFollowerDeleted } from '@amityco/ts-sdk'
+ * const dispose = onFollowerDeleted(status => {
+ *   // ...
+ * })
+ * ```
+ *
+ * Fired when a follower has been deleted
+ *
+ * @param callback The function to call when the event was fired
+ * @returns an {@link Amity.Unsubscriber} function to stop listening
+ *
+ * @category Follow Events
+ */
+const onFollowerDeleted = (callback) => createFollowEventSubscriber('follow.followerDeleted', callback);
+
+/**
+ * ```js
+ * import { onFollowerRequested } from '@amityco/ts-sdk'
+ * const dispose = onFollowerRequested(status => {
+ *   // ...
+ * })
+ * ```
+ *
+ * Fired when a user follows another users and confirmation is required
+ *
+ * @param callback The function to call when the event was fired
+ * @returns an {@link Amity.Unsubscriber} function to stop listening
+ *
+ * @category Follow Events
+ */
+const onFollowerRequested = (callback) => createFollowEventSubscriber('follow.requested', callback);
+
+/**
+ * ```js
+ * import { onFollowRequestCanceled } from '@amityco/ts-sdk'
+ * const dispose = onFollowRequestCanceled(status => {
+ *   // ...
+ * })
+ * ```
+ *
+ * Fired when a follow request has been canceled
+ *
+ * @param callback The function to call when the event was fired
+ * @returns an {@link Amity.Unsubscriber} function to stop listening
+ *
+ * @category Follow Events
+ */
+const onFollowRequestCanceled = (callback) => createFollowEventSubscriber('follow.requestCanceled', callback);
+
+/**
+ * ```js
+ * import { onFollowRequestAccepted } from '@amityco/ts-sdk'
+ * const dispose = onFollowRequestAccepted(status => {
+ *   // ...
+ * })
+ * ```
+ *
+ * Fired when a follow request has been accepted
+ *
+ * @param callback The function to call when the event was fired
+ * @returns an {@link Amity.Unsubscriber} function to stop listening
+ *
+ * @category Follow Events
+ */
+const onFollowRequestAccepted = (callback) => createFollowEventSubscriber('follow.accepted', callback);
+
+/**
+ * ```js
+ * import { onFollowRequestDeclined } from '@amityco/ts-sdk'
+ * const dispose = onFollowRequestDeclined(status => {
+ *   // ...
+ * })
+ * ```
+ *
+ * Fired when a follow request has been declined
+ *
+ * @param callback The function to call when the event was fired
+ * @returns an {@link Amity.Unsubscriber} function to stop listening
+ *
+ * @category Follow Events
+ */
+const onFollowRequestDeclined = (callback) => createFollowEventSubscriber('follow.requestDeclined', callback);
+
+/**
+ * ```js
+ * import { onFollowInfoUpdated } from '@amityco/ts-sdk'
+ * const dispose = onFollowInfoUpdated(followInfo => {
+ *   // ...
+ * })
+ * ```
+ *
+ * Fired when a {@link Amity.FollowInfo} has been updated
+ *
+ * @param callback The function to call when the event was fired
+ * @returns an {@link Amity.Unsubscriber} function to stop listening
+ *
+ * @category Follow Events
+ */
+const onFollowInfoUpdated = (callback) => {
+    const handler = async (payload) => {
+        const [{ data: followInfoFrom }, { data: followInfoTo },] = await Promise.all([getFollowInfo(payload.from), getFollowInfo(payload.to)]);
+        callback(followInfoFrom);
+        callback(followInfoTo);
+    };
+    const disposers = [
+        createFollowEventSubscriber('follow.created', handler),
+        createFollowEventSubscriber('follow.requested', handler),
+        createFollowEventSubscriber('follow.accepted', handler),
+        createFollowEventSubscriber('follow.unfollowed', handler),
+        createFollowEventSubscriber('follow.requestCanceled', handler),
+        createFollowEventSubscriber('follow.requestDeclined', handler),
+        createFollowEventSubscriber('follow.followerDeleted', handler),
+    ];
+    return () => {
+        disposers.forEach(fn => fn());
+    };
+};
+
+/**
+ * ```js
+ * import { observeFollowInfo } from '@amityco/ts-sdk'
+ *
+ * let followInfo = {}
+ * const dispose = observeFollowInfo(userId, updated => followInfo = updated)
+ * ```
+ *
+ * Observe all mutation on a given {@link Amity.FollowInfo}
+ *
+ * @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 post
+ *
+ * @category Follow Observer
+ */
+const observeFollowInfo = (userId, callback, policy = 'cache_then_server') => {
+    const { log } = getActiveClient();
+    const timestamp = Date.now();
+    log(`observeFollowInfo(tmpid: ${timestamp}) > listen`);
+    const router = (result, action) => {
+        var _a, _b;
+        if (callback instanceof Function)
+            return callback(result);
+        if (action !== 'onFetch')
+            (_a = callback.onEvent) === null || _a === void 0 ? void 0 : _a.call(callback, action, result);
+        (_b = callback[action]) === null || _b === void 0 ? void 0 : _b.call(callback, result);
+    };
+    const realtimeRouter = (result, action) => {
+        var _a;
+        if (((_a = result.data) === null || _a === void 0 ? void 0 : _a.userId) !== userId)
+            return;
+        router(result, action);
+    };
+    const disposers = [];
+    disposers.push(onFollowInfoUpdated(data => realtimeRouter({ data, loading: false, origin: 'event' }, 'onUpdate')));
+    runQuery(createQuery(getFollowInfo, userId), result => (result.data || result.error) && router(result, 'onFetch'), queryOptions(policy));
+    return () => {
+        log(`observeFollowInfo(tmpid: ${timestamp}) > dispose`);
+        disposers.forEach(fn => fn());
+    };
+};
+
+/**
+ * ```js
+ * import { observeFollowers } from '@amityco/ts-sdk'
+ *
+ * let followers = []
+ * const unsub = observeFollowers('userId', follower => merge(followers, follower))
+ * ```
+ *
+ * Observe all mutations on a list of followers {@link Amity.FollowStatus} for a given user
+ *
+ * @param userId the ID of the {@link Amity.User}
+ * @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 messages
+ *
+ * @category Follow Observer
+ */
+const observeFollowers = (userId, callback) => {
+    const { log } = getActiveClient();
+    const timestamp = Date.now();
+    log(`observeFollowers(tmpid: ${timestamp}) > listen`);
+    const disposers = [];
+    const router = (status, action) => {
+        var _a, _b;
+        if (status.from !== userId) {
+            return;
+        }
+        if (callback instanceof Function) {
+            return callback(status);
+        }
+        (_a = callback.onEvent) === null || _a === void 0 ? void 0 : _a.call(callback, action, status);
+        (_b = callback[action]) === null || _b === void 0 ? void 0 : _b.call(callback, status);
+    };
+    disposers.push(onFollowerRequested(x => router(x, 'onRequested')), onFollowRequestAccepted(x => router(x, 'onAccepted')), onFollowRequestDeclined(x => router(x, 'onDeclined')), onFollowRequestCanceled(x => router(x, 'onCanceled')), onUserFollowed(x => router(x, 'onFollowed')), onUserUnfollowed(x => router(x, 'onUnfollowed')), onFollowerDeleted(x => router(x, 'onDeleted')));
+    return () => {
+        log(`observeFollowers(tmpid: ${timestamp}) > dispose`);
+        disposers.forEach(fn => fn());
+    };
+};
+
+/**
+ * ```js
+ * import { observeFollowings } from '@amityco/ts-sdk'
+ *
+ * let followings = []
+ * const unsub = observeFollowers('userId', follower => merge(followings, following))
+ * ```
+ *
+ * Observe all mutations on a list of followings {@link Amity.FollowStatus} for a given user
+ *
+ * @param userId the ID of the {@link Amity.User}
+ * @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 messages
+ *
+ * @category Follow Observer
+ */
+const observeFollowings = (userId, callback) => {
+    const { log } = getActiveClient();
+    const timestamp = Date.now();
+    log(`observeFollowings(tmpid: ${timestamp}) > listen`);
+    const disposers = [];
+    const router = (status, action) => {
+        var _a, _b;
+        if (status.to !== userId) {
+            return;
+        }
+        if (callback instanceof Function) {
+            return callback(status);
+        }
+        (_a = callback.onEvent) === null || _a === void 0 ? void 0 : _a.call(callback, action, status);
+        (_b = callback[action]) === null || _b === void 0 ? void 0 : _b.call(callback, status);
+    };
+    disposers.push(onFollowerRequested(x => router(x, 'onRequested')), onFollowRequestAccepted(x => router(x, 'onAccepted')), onFollowRequestDeclined(x => router(x, 'onDeclined')), onFollowRequestCanceled(x => router(x, 'onCanceled')), onUserFollowed(x => router(x, 'onFollowed')), onUserUnfollowed(x => router(x, 'onUnfollowed')), onFollowerDeleted(x => router(x, 'onDeleted')));
+    return () => {
+        log(`observeFollowings(tmpid: ${timestamp}) > dispose`);
+        disposers.forEach(fn => fn());
+    };
+};
+
 /**
  * ```js
  * import { observePosts } from '@amityco/ts-sdk'
@@ -20008,6 +20730,7 @@ const onStreamRecorded = (callback) => {
 
 exports.API_REGIONS = API_REGIONS;
 exports.VERSION = VERSION$1;
+exports.acceptFollower = acceptFollower;
 exports.addChannelMembers = addChannelMembers;
 exports.addChannelMembersRole = addChannelMembersRole;
 exports.addCommunityMembers = addCommunityMembers;
@@ -20025,6 +20748,7 @@ exports.createPost = createPost;
 exports.createQuery = createQuery;
 exports.createReport = createReport;
 exports.createStream = createStream;
+exports.declineFollower = declineFollower;
 exports.deleteChannel = deleteChannel;
 exports.deleteComment = deleteComment;
 exports.deleteCommunity = deleteCommunity;
@@ -20040,6 +20764,7 @@ exports.dropFromCache = dropFromCache;
 exports.enableCache = enableCache;
 exports.fileUrlWithSize = fileUrlWithSize;
 exports.filterByPropEquality = filterByPropEquality;
+exports.follow = follow;
 exports.getActiveClient = getActiveClient;
 exports.getChannel = getChannel;
 exports.getChannels = getChannels;
@@ -20050,13 +20775,18 @@ exports.getCommunities = getCommunities;
 exports.getCommunity = getCommunity;
 exports.getCommunityTopic = getCommunityTopic;
 exports.getFile = getFile;
+exports.getFollowInfo = getFollowInfo;
 exports.getMessage = getMessage;
 exports.getMessages = getMessages;
+exports.getMyFollowersTopic = getMyFollowersTopic;
+exports.getMyFollowingsTopic = getMyFollowingsTopic;
 exports.getPost = getPost;
 exports.getPostTopic = getPostTopic;
 exports.getPosts = getPosts;
+exports.getRecommendedCommunities = getRecommendedCommunities;
 exports.getRole = getRole;
 exports.getStream = getStream;
+exports.getTopTrendingCommunities = getTopTrendingCommunities;
 exports.getUser = getUser;
 exports.getUserTopic = getUserTopic;
 exports.getUsers = getUsers;
@@ -20082,6 +20812,9 @@ exports.observeComment = observeComment;
 exports.observeComments = observeComments;
 exports.observeCommunity = observeCommunity;
 exports.observeFile = observeFile;
+exports.observeFollowInfo = observeFollowInfo;
+exports.observeFollowers = observeFollowers;
+exports.observeFollowings = observeFollowings;
 exports.observeMessage = observeMessage;
 exports.observeMessages = observeMessages;
 exports.observePost = observePost;
@@ -20110,6 +20843,12 @@ exports.onCommunityUserBanned = onCommunityUserBanned;
 exports.onCommunityUserRemoved = onCommunityUserRemoved;
 exports.onCommunityUserUnbanned = onCommunityUserUnbanned;
 exports.onConnectionError = onConnectionError;
+exports.onFollowInfoUpdated = onFollowInfoUpdated;
+exports.onFollowRequestAccepted = onFollowRequestAccepted;
+exports.onFollowRequestCanceled = onFollowRequestCanceled;
+exports.onFollowRequestDeclined = onFollowRequestDeclined;
+exports.onFollowerDeleted = onFollowerDeleted;
+exports.onFollowerRequested = onFollowerRequested;
 exports.onMemberAdded = onMemberAdded;
 exports.onMemberRemoved = onMemberRemoved;
 exports.onMessageCreated = onMessageCreated;
@@ -20130,7 +20869,9 @@ exports.onStreamStarted = onStreamStarted;
 exports.onStreamStopped = onStreamStopped;
 exports.onUserFlagCleared = onUserFlagCleared;
 exports.onUserFlagged = onUserFlagged;
+exports.onUserFollowed = onUserFollowed;
 exports.onUserUnflagged = onUserUnflagged;
+exports.onUserUnfollowed = onUserUnfollowed;
 exports.onUserUpdated = onUserUpdated;
 exports.pullFromCache = pullFromCache;
 exports.pushToCache = pushToCache;
@@ -20140,6 +20881,8 @@ exports.queryChannels = queryChannels;
 exports.queryComments = queryComments;
 exports.queryCommunities = queryCommunities;
 exports.queryCommunityMembers = queryCommunityMembers;
+exports.queryFollowers = queryFollowers;
+exports.queryFollowings = queryFollowings;
 exports.queryGlobalFeed = queryGlobalFeed;
 exports.queryMessages = queryMessages;
 exports.queryOptions = queryOptions;
@@ -20164,6 +20907,7 @@ exports.subscribeTopic = subscribeTopic;
 exports.toPage = toPage;
 exports.toPageRaw = toPageRaw;
 exports.toToken = toToken;
+exports.unfollow = unfollow;
 exports.updateChannel = updateChannel;
 exports.updateComment = updateComment;
 exports.updateCommunity = updateCommunity;